配置教程 · 截至 2026-11-20

Codex CLI 0.171.0 把 GPT-6.2 Sol 设为目录默认:config.toml 接第三方 base_url 照抄这一段

截至 2026-11-20,rust-v0.171.0 把 GPT-6.2 Sol 与 Astra 加进模型目录,Sol 成为默认的目录选择;要让自定义 provider 用上它,在用户级 ~/.codex/config.toml 顶层写 model = "gpt-6.2-sol" 和 model_provider = "qcode",再在 [model_providers.qcode] 里写 name、base_url、wire_api = "responses" 与 env_key = "QCODE_API_KEY"。

更新于 2026-11-20

把这个工具接到 QCode 端点:一把 key 调 Claude、GPT 与国产模型。

#默认模型 0.171.0#config.toml#model_providers#wire_api responses

四个先要记住的值

0.171.0

发布当日就把 Sol 设为目录默认

rust-v0.171.0 于 2026-11-20 发布,模型目录新增 GPT-6.2 Sol 与 Astra,Sol 为目录默认;顶层不写 model 时选中的就是目录默认这一项,所以升到 0.171.0 之后默认落在 Sol 上;用自定义 provider 时以交互会话里 /model 显示的当前型号为准。

$2 / $10

OpenAI 官方 Standard 标价(每百万 token)

官方价目页 2026-11-20 核对:gpt-6.2-sol 的 Standard 档输入 $2.00、输出 $10.00、缓存读 $0.10、30 分钟缓存写 $2.50、12 小时缓存写 $5.00;gpt-6.1-sol 在同一张表里的这五格与它相同。

responses

wire_api 只有这一个可选值

官方 config reference 写明 wire_api 只支持 responses 一个值,省略时它也就是默认值;有社区页称写 chat 会报错。

~/.codex

provider 键只能写在用户级配置

项目级 .codex/config.toml 里的 model_provider 与 model_providers 会被 Codex 忽略,provider 这类键必须写进用户级 ~/.codex/config.toml。

这段配置在做什么:model 选型号,model_provider 选端点

截至 2026-11-20,用自定义 provider 跑 Codex 的写法就两层:顶层 model 决定用哪个型号,官方 reference 给的示例值是 gpt-6.1-sol;顶层 model_provider 指向 model_providers 下的一张表,表里 name 是显示名、base_url 是 API 基址、env_key 是存放 API key 的环境变量、wire_api 是协议。

升级到 0.171.0 后你会回来改它,是因为模型目录这一层变了,Sol 成为默认的目录选择。三件事要分开看:目录默认管的是「没写 model 时用谁」,model 管的是「这一次用谁」,model_provider 管的是「请求发到哪个端点」。

2026-11-20:Sol 进默认目录,TUI workspace 默认开启

截至 2026-11-20 的这一版,和这条配置直接相关的改动有两条,都是官方 release 原文。

  1. 1模型目录:Added GPT-6.2 Sol and Astra to model catalogs, with Sol as the default catalog selection.——把 GPT-6.2 Sol 与 Astra 加入模型目录,Sol 是默认的目录选择。
  2. 2界面:Enabled the TUI workspace by default, with searchable document previews, image previews, and subagent transcripts alongside the main conversation.——TUI workspace 默认开启,可搜索的文档预览、图片预览与 subagent 记录和主对话并排显示。社区侧,2026-11-17 之后有开发者在论坛写道,试用几小时后退回了 6.1,也有人说 6.2 Sol 反复声称自己处于 plan mode。

三个时间点:社区先跑起来、0.170.0 打底、0.171.0 落地

2026-11-17

2026-11-17 起,社区开始集中讨论 GPT-6.2 Sol / Astra 在 Codex 里的表现,评论持续到 2026-11-19(社区说法)。想自己跟着试,官方模型页给的写法是 codex --model gpt-6.2-sol,非交互跑法用 codex exec 加 -m gpt-6.2-sol,交互会话里用 /model 切换型号。

2026-11-18

rust-v0.170.0 于 2026-11-18 发布,这一版的一条改动是 OpenTelemetry 的 HTTP exporter 会自己刷新认证头,不用再手工重设。把 GPT-6.2 Sol 设为目录默认的是 0.171.0,所以升到 0.170.0 不会改变 config.toml 里选型所依据的默认项。

2026-11-20

rust-v0.171.0 于 2026-11-20 发布:模型目录加入 GPT-6.2 Sol 与 Astra,Sol 为目录默认,TUI workspace 同时默认开启。要在自定义 provider 上用 Sol,就是这时候把顶层 model 写成 gpt-6.2-sol。

已核实的事实 vs 社区说法与官方未公布

已核实(Codex 官方 release、config reference、模型页与价目页原文)

截至 2026-11-20 可逐条核对

  1. 1版本:rust-v0.171.0 于 2026-11-20 发布,模型目录新增 GPT-6.2 Sol 与 Astra,Sol 为目录默认,TUI workspace 默认开启。
  2. 2型号键:model 是要用的型号,官方 reference 举例 gpt-6.1-sol;model_provider 是 model_providers 里的 provider id,默认 openai,内置的 openai、ollama、lmstudio 三个 id 保留、不能覆盖。
  3. 3provider 表:base_url 是 provider 的 API 基址,env_key 是提供 API key 的环境变量,name 是显示名,wire_api 只支持 responses 且在省略时就是默认值。
  4. 4用户级:项目级 .codex/config.toml 里的 model_provider、model_providers 会被忽略,官方处置是 put provider, notification, and telemetry keys in user-level config instead。
  5. 5临时指定:codex --model gpt-6.2-sol;非交互用 codex exec 加 -m gpt-6.2-sol;交互会话里用 /model 切换型号。
  6. 6官方标价:gpt-6.2-sol 的 Standard 输入 $2.00、输出 $10.00、缓存读 $0.10、30 分钟缓存写 $2.50、12 小时缓存写 $5.00,Batch 输入 $1.00、输出 $5.00;gpt-6.1-sol 的 Standard 五格与它相同。

社区说法与官方尚未公布的事项

以下都不是官方结论,别按它排期。

  1. 1「6.2 Sol 一定比 6.1 贵」——官方价目页上两者 Standard 五格相同,Batch 两格也相同,贵不贵取决于你的用法和型号本身的表现。
  2. 2「wire_api 写 chat 也能跑」——旧教程残留,社区页把它写成硬错误,官方 reference 只有 responses 一个值。
  3. 3社区有开发者反映,试用几小时后退回了 6.1,也有人反映 6.2 Sol 反复声称自己处于 plan mode;这是使用手感,不是官方结论。
  4. 4Fast 与 Ultrafast 档的费率表,以及之后的费率倍数变化,以官方价目页当期表格为准。

不写 model 跟随目录默认 vs 在 config.toml 显式写 model

A:不写 model,把选型交给目录默认

顶层不写 model 时,Codex 选中的是目录默认那一项;0.171.0 起这一项是 GPT-6.2 Sol,所以同一份 config.toml 在升级后可能换到另一款模型,价格和手感一起变。想留在 6.1,就别把选型交给默认。

B:显式写 model = "gpt-6.2-sol"

顶层写死 model = "gpt-6.2-sol",版本怎么升都按这一行选型;要回 6.1 就把它改成 gpt-6.1-sol,只想试一次 Astra 用 codex -m gpt-6.2-astra,配置文件不用动。

照做的五步:把 gpt-6.2-sol 接到第三方 base_url 上

  1. 1先确认版本:终端跑 codex --version,输出应为 0.171.0;这一版是 rust-v0.171.0,2026-11-20 发布,模型目录里 Sol 是默认选择。
  2. 2打开用户级配置 ~/.codex/config.toml,不要动项目里的 .codex/config.toml——那里的 model_provider 与 model_providers 会被忽略。
  3. 3顶层写两行:model = "gpt-6.2-sol" 与 model_provider = "qcode"。
  4. 4紧接着写 provider 表:[model_providers.qcode],下面四行是 name = "qcode"、base_url = "https://api.qcode.cc/openai"、wire_api = "responses"、env_key = "QCODE_API_KEY";base_url 后面不加 /v1。
  5. 5在同一个终端导出 key:export QCODE_API_KEY=你的 cr_ 开头的 key,然后跑 codex --model gpt-6.2-sol 试一条任务;想固定 6.1 就把 model 那行改成 gpt-6.1-sol,想临时试 Astra 用 codex -m gpt-6.2-astra。

QCode 的写法:一把 cr_ key,Codex 走 openai 端点

QCode 是独立的 API 接入服务,与 OpenAI 无隶属关系,接入按协议分开。

  1. 1Codex CLI 走 Responses 协议:base_url 填 https://api.qcode.cc/openai(没有 /v1 尾缀),wire_api = "responses",env_key = "QCODE_API_KEY";中国大陆可用 https://asia.qcode.cc/openai,北美与欧洲可用 https://us.qcode.cc/openai。
  2. 2在售的 GPT 型号包括 gpt-6.2-sol、gpt-6.2-astra、gpt-6.1-sol 与 gpt-6.1-terra,把 model 换成对应 ID 就能切。
  3. 3同一把 cr_ key 在 Claude Code 里也能调 Claude 型号(claude-fable-5-2、claude-sonnet-5-5 等),那条走 ANTHROPIC_BASE_URL=https://api.qcode.cc/api;OpenAI 兼容客户端则用 https://api.qcode.cc/openai/v1 调 qwen3.8-max、glm-5.3 这类模型。按 token 计费,各模型实时单价见 /models。不想包月?按量包 ¥26 起买一笔额度,7 天内用完为止;已有个人套餐的用户额度不够时买加油包。

常见问题

0.171.0 之后默认模型是什么?

默认落在 GPT-6.2 Sol 上。官方 release 写的是两个型号一起进目录、Sol 为目录默认选择;这个默认只在你顶层没写 model 时生效——写了 model = "gpt-6.2-sol" 或 gpt-6.1-sol,用的就是你写的那一个。想确认这一次用的是谁,交互会话里敲 /model 就能看到当前型号。

6.2 Sol 和 6.1 Sol 官方价一样吗?

OpenAI 官方 Standard 档一样:gpt-6.2-sol 与 gpt-6.1-sol 在价目页同一张表里都是输入 $2.00、输出 $10.00、缓存读 $0.10、30 分钟缓存写 $2.50、12 小时缓存写 $5.00。Batch 档两者也都是输入 $1.00、输出 $5.00。差别在型号本身的表现,不在这几格价格。

wire_api 能写 chat 吗?

不能。官方 config reference 对 wire_api 的原文是 responses is the only supported value, and it is the default when omitted.——官方只支持 responses 一个值,省略时也按它走;有社区页称写 chat 会报错。旧配置里的 wire_api = "chat" 要改成 responses。

为什么写在项目里的 .codex/config.toml 不生效?

因为 provider 类键在项目级会被忽略:model_provider 与 model_providers 出现在项目本地 .codex/config.toml 里时 Codex 直接跳过,官方要求把 provider、通知与遥测这类键放进用户级配置,也就是 ~/.codex/config.toml。项目级文件留着写沙箱与审批这类项目设置。

base_url 要不要加 /v1?

Codex 这条不加:wire_api = "responses" 时 base_url 填到 https://api.qcode.cc/openai 就停。官方 reference 只要求它是 provider 的 API 基址,没有 /v1 这一层。需要 /v1 的是 OpenAI 兼容的 chat/completions 客户端,OpenAI SDK、Cline 那类走 https://api.qcode.cc/openai/v1,两套端点别混用。

怎么临时用 Astra?

不动配置文件起一次就行:codex --model gpt-6.2-astra,非交互用 codex exec 加 -m gpt-6.2-astra;交互会话里用 /model 切换。官方模型页写明 Astra 与 Sol 各支持最多 100 万 token 的上下文窗口,两者价格不同:Astra 的 Standard 是输入 $8.00、输出 $40.00,Sol 是 $2.00 与 $10.00。

参考来源

OpenAI Codex release rust-v0.171.0 与 rust-v0.170.0(github.com/openai/codex/releases,2026-11-20 / 2026-11-18);Codex config reference(developers.openai.com/codex/config-reference,核对于 2026-11-20);Codex models(developers.openai.com/codex/models,核对于 2026-11-20);OpenAI API pricing(developers.openai.com/api/docs/pricing,核对于 2026-11-20);社区讨论(news.ycombinator.com,2026-11-17 起,评论持续到 2026-11-19),社区说法只作参考、不作官方口径。以上均核对于 2026-11-20。

默认模型变了,配置不用猜:一行 model,一条 base_url

注册 QCode 账号生成 cr_ 开头的 key,在 ~/.codex/config.toml 里填 base_url=https://api.qcode.cc/openai 与 env_key=QCODE_API_KEY,按 token 计费调用多模型;不想包月就先买一笔按量包额度,各模型单价见 /models。

不确定从哪开始?

先试一周

小包 ¥26($30 额度,7 天)

每天都用

体验版 ¥63/月,每天 $5 额度;每 $1 额度只要 ¥0.42,中包约 ¥0.79