终端 Agent
Codex 教程:接入 Claude 无限卡并配置模型列表
Codex 多两个关键动作:上游格式必须选 Anthropic Messages,改完必须彻底重启才生效。
Codex 要在 CC Switch 里新增一个 Codex 供应商,上游格式必须选 Anthropic Messages 并开启路由,配置好模型列表后启用并检测链路,最后彻底重启 Codex 才会生效。
1. 安装 CC Switch
装好 CC Switch 就算准备好了一半:它是个专门管 API 配置的小工具,全程默认安装,不用填任何东西。
打开下载页,下载对应系统的安装包
它是管配置的小工具,装好只是先把软件准备好,这一步不用填任何东西。
- 打开下面的官网 → 挑自己系统的安装包(Windows / macOS 都有)→ 下载 → 安装,全程保持默认。

图 01CC Switch 官网首页 - 软件很小,不需要注册账号,装完先不用配置,下一步直接换 Key。
- 杀毒软件提示未知来源时选「仍要运行」,这是开源小工具。
2. 换取 API Key
卡密在发货信息里,换成一把 sk- 开头的 API Key 后面全程只用它——CC Switch、各个客户端、终端都是这一把。
激活码、API Key、用量记录都存在管理后台里:同一把激活码随时回来查看,刷新、换浏览器、换设备都不影响。
主域名打不开时,用后台里的备用域名(bxcv.store),API Key 不用换。
兑换得到的 Key 以 sk- 开头;后面 CC Switch、VS Code、终端都用它,不用再换。
在管理后台把卡密换成 API Key
这把 sk- 开头的密钥就是后面全程要用的 API Key;激活码、Key 都会留在后台里,刷新页面随时能再看。
- 打开下面的管理后台 → 在「我的面板」或「提取 Key」页面粘贴激活码 → 提交激活 → 在「提取 Key」页面拿到你的 Key。

图 02管理后台首页,粘贴卡密的输入框在这里 - 先复制保存一份到密码管理器;忘了也不要紧,回管理后台用同一把激活码随时能再看,刷新页面不会丢。
3. 新增 Codex 供应商
Codex 要在 CC Switch 里单独建一个供应商,不能用一键导入,也不能用桌面版那条配置。
新增供应商时选 Codex 供应商
先选对供应商类型,后面能填的字段才和 Codex 对得上。
- CC Switch → 「添加新供应商」→ 选「Codex 供应商」这一类 → 进到编辑页。

图 03「添加新供应商」里选择 Codex 供应商 - 列表里带「需要路由」标记的那条是本卡的既有配置,可以直接用它的地址与 Key 改。
4. 填入地址、Key 与默认模型
Codex 的请求地址要带 /v1,和 Claude Code 那边不一样;默认模型填一个网关确实返回的模型名。
填请求地址、API Key 与默认模型
这三个值决定 Codex 往哪儿发请求、发什么模型,填错的表现是连不上或报模型不存在。
- API 请求地址填 https://rsxermu666.cn/v1(Codex 这里要带 /v1)
- API Key 填上一步换来的 sk- 开头那把
- 默认模型填 claude-opus-5-5

图 04编辑供应商:请求地址带 /v1、API Key 与默认模型 - 地址不带 /v1 会 404,这是 Codex 与 Claude Code 最容易踩的差别。
- 默认模型留空且配了模型映射时,会用映射的第一行。
5. 把上游格式设为 Anthropic Messages
这是 Codex 专有的一步,也是最关键的一步:本卡是 Anthropic 兼容端点,选错格式请求就发不出去。
高级选项里选「Anthropic Messages(需开启路由)」
让 Codex 按 Anthropic 协议向网关发请求,而不是按 OpenAI 协议。
- 编辑供应商 → 展开「高级选项」→「上游格式」→ 选「Anthropic Messages」→ 按提示先开启路由。

图 05高级选项里的上游格式:Anthropic Messages(需开启路由) - Chat Completions 与 Responses 是 OpenAI 协议,本卡用不了。
- 这里选 Anthropic Messages,就必须开路由,两步是配套的。
6. 配置模型列表
把网关有的模型加进列表,Codex 的 /model 命令才会列出这些模型名。
获取模型列表并添加模型
Codex 只认自己列表里的模型名,没加进去的模型在 /model 里看不到。
- 编辑供应商 → 「获取模型列表」→ 选「添加模型」→ 填菜单显示名与实际请求模型。

图 06获取模型列表后添加模型:菜单显示名与实际请求模型 - 「实际请求模型」要填网关真实返回的 ID(如 claude-opus-5-5),填错了 Codex 会报模型不存在。
在模型映射里配好,生成 model_catalog.json
模型映射决定 /model 里显示的名字和实际请求的模型;生成 model_catalog.json 之后 Codex 才会列出它们。
- 同一页的「模型映射」里填菜单显示名与实际请求模型 → 勾上「生成 Codex model_catalog.json」→ 保存。

图 07模型映射表:左边菜单显示名,右边实际请求模型 
图 08高级选项里的「生成 Codex model_catalog.json」开关 - 改完 model_catalog.json 必须彻底重启 Codex,模型列表才会刷新。
7. 开启路由
Codex 走本地路由转发,和桌面版一样:总开关与 Codex 应用开关都要开。
设置里的路由页,打开总开关与 Codex
Codex 的请求必须被路由接管,否则不会发往网关。
- CC Switch → 设置 → 「路由」→ 打开「路由总开关」→ 再打开「Codex」那个应用开关。

图 09路由页:打开总开关与 Codex 应用开关 确认供应商标着「需要路由」
这是路由生效的标志,条目上会显示出来。
- 回到主界面,供应商列表里这条配置旁边应显示「需要路由」。

图 10供应商列表里标着「需要路由」的 Codex 配置
8. 启用并检测链路
配置齐了启用一下,检测显示连通正常再往下走。
点「启用」,再点「检测链路」
启用才会把配置写进 Codex,检测通过说明整条链路都通了。
- 回到 CC Switch 主界面 → 点「启用」→ 再点「检测链路」,显示连通正常即可。

图 11供应商列表里无限卡那条已启用,地址带 /v1 
图 12检测链路显示无限卡连通正常 - 检测失败先看常见问题 · 使用与配置。
9. 彻底重启 Codex
Codex 只在启动时读一次配置,这一步不做,前面所有配置都不会生效。
在任务管理器里结束 Codex 进程,再重新打开
彻底重启后新配置才会被加载,模型列表也会刷新。
- 完全退出 Codex → 打开任务管理器确认没有残留的 Codex 进程 → 结束它 → 重新启动 Codex。
- 关窗口不算完全退出,Codex 可能还在后台驻留。
- 改了模型映射后同样要重启,/model 里的列表才会更新。

常见问题
Codex 怎么配置 Claude 无限卡?
在 CC Switch 新增 Codex 供应商,填接口地址(带 /v1)与 API Key,默认模型填 claude-opus-5-5,上游格式选 Anthropic Messages,开启路由里的 Codex 开关,启用检测后彻底重启 Codex。
Codex 改了配置不生效?
Codex 只在启动时读一次配置,改完必须彻底退出(任务管理器里结束进程)再打开,单纯关窗口不算。
上游格式为什么必须选 Anthropic Messages?
本卡是 Anthropic 兼容端点,Codex 选 Chat Completions 或 Responses 会按 OpenAI 协议发请求而连不上。选 Anthropic Messages 时必须同时开启路由。
检测链路显示正常但 Codex 里报错?
先确认路由总开关和 Codex 那个应用开关都打开了;只有总开关开着、应用开关没开,请求不会被转发。