跳至主要內容

切换 Codex CLI

大约 3 分钟

用 CC-Switch 切换 Codex CLI

你的 Codex CLI 既挂着 OpenAI 官方 API，又用着平台令牌？或者要在测试令牌和生产令牌之间来回切？这一篇就是讲 Codex 怎么切。

看这篇前

先把 通用概念与配置 走一遍：装 CC-Switch、了解面板、知道"添加配置"的核心动作。本页只补 Codex CLI 专属内容。

一、什么情况要切

场景要不要切
同时挂 OpenAI 官方 + 平台令牌，临时切平台要
不同项目走不同分组令牌要
测试令牌和生产令牌严格分开要
只用一套平台令牌、长期不动不用切，配一次就行

二、开始前的准备

  1. 已经走完 通用概念与配置
  2. 已经创建好 Codex 家族令牌分组 的令牌：参考 建令牌
  3. 本机能跑：
codex --version

如果命令报 command not found，先去 Codex CLI 手动配置 装好。

你需要这两个值

  • API 地址：https://www.yuzhixiaolongxia.com/v1（必须带 /v1）
  • API Key：平台 Codex 家族令牌

Codex 的地址必须带 /v1

和 Claude 完全相反：Codex CLI 用的是 OpenAI 兼容协议，地址末尾必须是 /v1。漏了 /v1 启动后会找不到接口。

三、在 CC-Switch 里加 Codex 配置

  1. 启动 CC-Switch
  2. 顶部应用切换到 Codex
  3. 点 Add Provider（添加供应商）
  4. 按下表填字段：
字段填什么
名称预制小龙虾-Codex 或 预制小龙虾-Codex-prod
Provider / 应用Codex
API URLhttps://www.yuzhixiaolongxia.com/v1
API Key平台 Codex 家族令牌
Model（可选）不填用默认，要锁定时填
  1. 点保存
  2. 在配置列表里找到刚加的项，点 Enable / 启用
  3. 状态显示 使用中 / In Use 才算切到位

想锁定模型再填 Model

不填 Model 时 Codex CLI 会用自带默认。要强制某个模型，就去 模型广场 复制对应 Codex 家族的 ID 粘进来。

四、验证切到平台了

关掉之前所有 codex 终端窗口，重开新终端：

codex

进入会话后发一句：

输出：OK

能正常返回就说明这一刻 Codex CLI 走的是平台后端。

想验证更彻底

平台控制台 /console/log 里找一下刚才那次请求的时间点，如果能对上，就 100% 确认是平台计费的。

五、切回原来的后端

切回 OpenAI 官方或别的后端：

  1. 在 CC-Switch 的 Codex 配置列表里，点击之前那个"官方"配置，点 Enable
  2. 关掉当前所有 codex 终端
  3. 重开终端，再跑 codex

建议命名规范

保留多套配置时强烈建议给名字加后缀：Codex-官方、Codex-平台-prod、Codex-平台-staging。点错的概率会大大降低。

六、常见坑

现象原因怎么处理
找不到接口 / 404API URL 漏了 /v1改成 https://www.yuzhixiaolongxia.com/v1
401 invalid_api_key令牌错、过期、复制不全重建 Codex 家族令牌再替换
model_not_found模型 ID 不在 Codex 家族分组里去 模型广场 复制可用 ID，或换分组
429 rate limit并发太高、额度不足降低并发、检查令牌余额
切了没反应旧终端进程没重开关掉所有 codex 终端再重开
启用后看着还是另一条UI 缓存或多个都被启用重启 CC-Switch，再确认只启用一个

七、日常使用建议

  • 开发 / 测试 / 生产分别建配置，名字带环境后缀
  • 切换线路后，跑一个固定验证指令（比如让 AI 说"OK"），防止误切
  • 怀疑令牌泄露，先去平台删令牌，再回 CC-Switch 编辑这条配置换 Key
  • 长期不用的旧配置，及时删掉，避免某天手抖切错

上一步：切换 Claude Code 下一步：切换 Gemini CLI

预制小龙虾 | 文档系统
Copyright © 2026 预制小龙虾