终端 Agent

Codex 教程:接入 Claude 无限卡并配置模型列表

Codex 多两个关键动作:上游格式必须选 Anthropic Messages,改完必须彻底重启才生效。

Codex 要在 CC Switch 里新增一个 Codex 供应商,上游格式必须选 Anthropic Messages 并开启路由,配置好模型列表后启用并检测链路,最后彻底重启 Codex 才会生效。

1. 安装 CC Switch

装好 CC Switch 就算准备好了一半:它是个专门管 API 配置的小工具,全程默认安装,不用填任何东西。

  1. 打开下载页,下载对应系统的安装包

    它是管配置的小工具,装好只是先把软件准备好,这一步不用填任何东西。

    • 打开下面的官网 → 挑自己系统的安装包(Windows / macOS 都有)→ 下载 → 安装,全程保持默认。
    CC Switch 官网ccswitch.io
    CC Switch 官网首页
    图 01CC Switch 官网首页
    • 软件很小,不需要注册账号,装完先不用配置,下一步直接换 Key。
    • 杀毒软件提示未知来源时选「仍要运行」,这是开源小工具。

2. 换取 API Key

卡密在发货信息里,换成一把 sk- 开头的 API Key 后面全程只用它——CC Switch、各个客户端、终端都是这一把。

激活码、API Key、用量记录都存在管理后台里:同一把激活码随时回来查看,刷新、换浏览器、换设备都不影响。

主域名打不开时,用后台里的备用域名(bxcv.store),API Key 不用换。

兑换得到的 Key 以 sk- 开头;后面 CC Switch、VS Code、终端都用它,不用再换。

  1. 在管理后台把卡密换成 API Key

    这把 sk- 开头的密钥就是后面全程要用的 API Key;激活码、Key 都会留在后台里,刷新页面随时能再看。

    • 打开下面的管理后台 → 在「我的面板」或「提取 Key」页面粘贴激活码 → 提交激活 → 在「提取 Key」页面拿到你的 Key。
    管理后台rsxermu666.cn
    管理后台首页,粘贴卡密的输入框在这里
    图 02管理后台首页,粘贴卡密的输入框在这里
    • 先复制保存一份到密码管理器;忘了也不要紧,回管理后台用同一把激活码随时能再看,刷新页面不会丢。

3. 新增 Codex 供应商

Codex 要在 CC Switch 里单独建一个供应商,不能用一键导入,也不能用桌面版那条配置。

  1. 新增供应商时选 Codex 供应商

    先选对供应商类型,后面能填的字段才和 Codex 对得上。

    • CC Switch → 「添加新供应商」→ 选「Codex 供应商」这一类 → 进到编辑页。
    「添加新供应商」里选择 Codex 供应商
    图 03「添加新供应商」里选择 Codex 供应商
    • 列表里带「需要路由」标记的那条是本卡的既有配置,可以直接用它的地址与 Key 改。

4. 填入地址、Key 与默认模型

Codex 的请求地址要带 /v1,和 Claude Code 那边不一样;默认模型填一个网关确实返回的模型名。

  1. 填请求地址、API Key 与默认模型

    这三个值决定 Codex 往哪儿发请求、发什么模型,填错的表现是连不上或报模型不存在。

    • API 请求地址填 https://rsxermu666.cn/v1(Codex 这里要带 /v1)
    • API Key 填上一步换来的 sk- 开头那把
    • 默认模型填 claude-opus-5-5
    编辑供应商:请求地址带 /v1、API Key 与默认模型
    图 04编辑供应商:请求地址带 /v1、API Key 与默认模型
    • 地址不带 /v1 会 404,这是 Codex 与 Claude Code 最容易踩的差别。
    • 默认模型留空且配了模型映射时,会用映射的第一行。

5. 把上游格式设为 Anthropic Messages

这是 Codex 专有的一步,也是最关键的一步:本卡是 Anthropic 兼容端点,选错格式请求就发不出去。

  1. 高级选项里选「Anthropic Messages(需开启路由)」

    让 Codex 按 Anthropic 协议向网关发请求,而不是按 OpenAI 协议。

    • 编辑供应商 → 展开「高级选项」→「上游格式」→ 选「Anthropic Messages」→ 按提示先开启路由。
    高级选项里的上游格式:Anthropic Messages(需开启路由)
    图 05高级选项里的上游格式:Anthropic Messages(需开启路由)
    • Chat Completions 与 Responses 是 OpenAI 协议,本卡用不了。
    • 这里选 Anthropic Messages,就必须开路由,两步是配套的。

6. 配置模型列表

把网关有的模型加进列表,Codex 的 /model 命令才会列出这些模型名。

  1. 获取模型列表并添加模型

    Codex 只认自己列表里的模型名,没加进去的模型在 /model 里看不到。

    • 编辑供应商 → 「获取模型列表」→ 选「添加模型」→ 填菜单显示名与实际请求模型。
    获取模型列表后添加模型:菜单显示名与实际请求模型
    图 06获取模型列表后添加模型:菜单显示名与实际请求模型
    • 「实际请求模型」要填网关真实返回的 ID(如 claude-opus-5-5),填错了 Codex 会报模型不存在。
  2. 在模型映射里配好,生成 model_catalog.json

    模型映射决定 /model 里显示的名字和实际请求的模型;生成 model_catalog.json 之后 Codex 才会列出它们。

    • 同一页的「模型映射」里填菜单显示名与实际请求模型 → 勾上「生成 Codex model_catalog.json」→ 保存。
    模型映射表:左边菜单显示名,右边实际请求模型
    图 07模型映射表:左边菜单显示名,右边实际请求模型
    高级选项里的「生成 Codex model_catalog.json」开关
    图 08高级选项里的「生成 Codex model_catalog.json」开关
    • 改完 model_catalog.json 必须彻底重启 Codex,模型列表才会刷新。

7. 开启路由

Codex 走本地路由转发,和桌面版一样:总开关与 Codex 应用开关都要开。

  1. 设置里的路由页,打开总开关与 Codex

    Codex 的请求必须被路由接管,否则不会发往网关。

    • CC Switch → 设置 → 「路由」→ 打开「路由总开关」→ 再打开「Codex」那个应用开关。
    路由页:打开总开关与 Codex 应用开关
    图 09路由页:打开总开关与 Codex 应用开关
  2. 确认供应商标着「需要路由」

    这是路由生效的标志,条目上会显示出来。

    • 回到主界面,供应商列表里这条配置旁边应显示「需要路由」。
    供应商列表里标着「需要路由」的 Codex 配置
    图 10供应商列表里标着「需要路由」的 Codex 配置

8. 启用并检测链路

配置齐了启用一下,检测显示连通正常再往下走。

  1. 点「启用」,再点「检测链路」

    启用才会把配置写进 Codex,检测通过说明整条链路都通了。

    • 回到 CC Switch 主界面 → 点「启用」→ 再点「检测链路」,显示连通正常即可。
    供应商列表里无限卡那条已启用,地址带 /v1
    图 11供应商列表里无限卡那条已启用,地址带 /v1
    检测链路显示无限卡连通正常
    图 12检测链路显示无限卡连通正常

9. 彻底重启 Codex

Codex 只在启动时读一次配置,这一步不做,前面所有配置都不会生效。

  1. 在任务管理器里结束 Codex 进程,再重新打开

    彻底重启后新配置才会被加载,模型列表也会刷新。

    • 完全退出 Codex → 打开任务管理器确认没有残留的 Codex 进程 → 结束它 → 重新启动 Codex。
    • 关窗口不算完全退出,Codex 可能还在后台驻留。
    • 改了模型映射后同样要重启,/model 里的列表才会更新。
重启后在 Codex 里正常使用,模型为 claude-opus-5-5
图 13重启后在 Codex 里正常使用,模型为 claude-opus-5-5

常见问题

在 CC Switch 新增 Codex 供应商,填接口地址(带 /v1)与 API Key,默认模型填 claude-opus-5-5,上游格式选 Anthropic Messages,开启路由里的 Codex 开关,启用检测后彻底重启 Codex。

Codex 只在启动时读一次配置,改完必须彻底退出(任务管理器里结束进程)再打开,单纯关窗口不算。

本卡是 Anthropic 兼容端点,Codex 选 Chat Completions 或 Responses 会按 OpenAI 协议发请求而连不上。选 Anthropic Messages 时必须同时开启路由。

先确认路由总开关和 Codex 那个应用开关都打开了;只有总开关开着、应用开关没开,请求不会被转发。