在 Codex 里使用 Claude：把 config.toml 的 model 换成 Claude 模型 ID
Codex 自带的模型列表只有 GPT。把 Codex 配置里的模型名换成 Claude 的模型 ID，Codex 就会通过 GrooRoute Pro 调用 Claude。下面两种办法任选一种，改的都是同一行配置：~/.codex/config.toml 里的 model；只想临时用一次，也可以在启动时用 -m 指定，不改配置文件。
前提是 Codex 已经按Codex CLI 配置一篇接好了 GrooRoute Pro：base_url 带 /v1，wire_api 写 responses，API Key 放在环境变量里。换成 Claude 之后 Codex 仍然走 Responses 协议，请求照常发到 POST /v1/responses。
当前可用的 Claude 模型
下面是平台已发布、并且当前有供给的 Claude 模型 ID，填进 model 时原样照抄。右边一列是这个模型的供给声明支持的接口，Codex 用的是 POST /v1/responses：
| 模型 ID | 支持的接口 |
|---|---|
claude-opus-5-5 | POST /v1/chat/completions、POST /v1/messages、POST /v1/responses |
claude-sonnet-5-5 | POST /v1/chat/completions、POST /v1/messages、POST /v1/responses |
这份清单随平台发布的目录更新。接口一列合并了公开可用档位的声明，以接入文档页为准。每个模型在各档位的价格见模型页。
下面的示例用的 claude-opus-5-5 是清单里第一个声明了 Responses 协议的 Claude 模型，可以换成清单里其他声明了 POST /v1/responses 的模型。
方式一：用 GrooRoute Pro 客户端（推荐）
GrooRoute Pro 客户端从 4.2.2 起，可以在「一键配置」页给 Codex 选模型：
- 打开客户端的「一键配置」页，在「选择密钥」里选你账户里的一把密钥，工具里勾选 Codex CLI 或 Codex 桌面版。
- 在「Codex 模型」下拉里选一个 Claude 模型。下拉列出的是这把密钥能用的 GPT 和 Claude 模型；手动输入的密钥读不到模型清单，下拉里只有「默认」。之前选过的模型会一直留在下拉里；它不在这把密钥的候选里时，切换会提示并改写成默认模型。
- 点「一键切换路由」，等 Codex 那一行显示「请求通过」。
- 重启 Codex：命令行版重新运行
codex，桌面版完全退出再打开。
客户端会把选中的模型写进 config.toml 的 model，并记住这次的选择。
方式二：手动改配置文件
配置文件的位置：
- macOS / Linux：
~/.codex/config.toml - Windows：
C:\Users\<你的用户名>\.codex\config.toml
用文本编辑器打开，把 model 那一行改成：
model = "claude-opus-5-5"其余几行（model_provider 和 [model_providers.grooroute] 一段）不用动。保存后重启 Codex。
只想临时用一次
不改配置文件，启动时用 -m 带上模型 ID，只对这一次启动的会话生效：
codex -m 'claude-opus-5-5'换回 GPT
在客户端的「Codex 模型」下拉里选回「默认」，再点一次「一键切换路由」；或者把 config.toml 的 model 改回 GPT 模型，例如：
model = "gpt-5.6-luna"gpt-5.6-luna 是清单里第一个声明了 Responses 协议的 GPT 模型。
常见问题
Codex 里 /model 列表为什么没有 Claude？
那个列表是 Codex 内置的，只有 GPT 模型。在那里选会把配置改回 GPT；要换回 Claude，按正文任一办法再改一次。
怎么确认在用 Claude？
看控制台「用量明细」里这次请求的「模型 / 密钥」一列，显示的是 Claude 模型的 ID。
能用联网搜索吗？
可以。Codex 的联网搜索工具会转成 Claude 的联网搜索，由 Claude 执行；Claude 的搜索总是读取实时网页。
启动时提示「Model metadata for … not found. Defaulting to fallback metadata」怎么办？
可以忽略。Codex 不认识这个模型名，改用默认的模型信息，请求照常发出。
最后更新：