#Codex 不够用？这套组合接第三方 API

X 首图

这套组合只解决一件事：

CC Switch 管 provider、API Key、本地路由；Codex++ 管 Codex App 的增强体验。

不要让两个工具同时改 ~/.codex/config.toml 和 ~/.codex/auth.json。

推荐分工：

  • 第三方 API、模型切换、协议转换、用量记录：交给 CC Switch；
  • Codex App 启动、插件入口、会话删除、Markdown 导出、Timeline、用户脚本：交给 Codex++；
  • 除非你明确改用 Codex++ Relay，否则不要让 Codex++ 再接管 provider。

开始前先备份：

cp ~/.codex/config.toml ~/.codex/config.toml.bak.$(date +%Y%m%d-%H%M%S)
cp ~/.codex/auth.json ~/.codex/auth.json.bak.$(date +%Y%m%d-%H%M%S)

#1. 装基础环境和 CC Switch

macOS 直接走 Homebrew：

brew install node
brew install codex
brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows / Linux 就从 CC Switch Releases 下载对应安装包。

安装 CC Switch / Node / Codex

#2. 装 Codex++

去 Codex++ Releases 下载最新版：

  • Apple Silicon：CodexPlusPlus-*-macos-arm64.dmg
  • Intel Mac：CodexPlusPlus-*-macos-x64.dmg
  • Windows：CodexPlusPlus-*-windows-x64-setup.exe

装完后会有两个入口：

  • Codex++：直接启动增强版 Codex；
  • Codex++ Manager：管理增强、诊断、Relay、脚本。

下载 Codex++ 安装包

#3. 在 CC Switch 添加 Codex Provider

打开 CC Switch，顶部切到 Codex。

点击右上角 +，新增 provider。

如果你用 DeepSeek、Kimi、GLM、OpenRouter 或中转站：

  • 优先选内置 preset；
  • 填 API Key；
  • 检查 Base URL；
  • 对 Chat Completions 类 provider，打开“需要本地路由映射”。

重点：不要把 /chat/completions 硬塞进 Codex。Codex 侧走 Responses，本地路由负责转换。

添加 Codex Provider

#4. 开 Local Routing，让 Codex 走 CC Switch

进 Settings -> Routing。

打开：

  • 本地路由总开关；
  • 路由总开关；
  • Codex 路由开关。

默认服务地址一般是：

http://127.0.0.1:15721

这一步做完，Codex 的请求会先打到本地路由，再由 CC Switch 转发给你启用的 provider。

开启 Local Routing

#5. 启用 Provider，然后重启 Codex

回到 CC Switch 的 Codex provider 列表。

点击目标 provider 的 Enable。

如果卡片上有“需要路由”标记，说明这个 provider 必须在 Local Routing 开着时使用。

启用后重启 Codex，再输入：

/model

确认当前模型已经切到你配置的第三方模型。

启用 Provider

#6. 接 Codex++，只开增强

这一步是联合使用的关键。

打开 Codex++ Manager。

如果前面已经让 CC Switch 管 provider 和路由，就按这个规则：

  • 保留 Codex++ 的增强注入；
  • 使用会话删除、Markdown 导出、Timeline、用户脚本；
  • 不要再应用 Codex++ Relay Injection；
  • 不要让 Codex++ 同时写 provider。

只有一种情况例外：你决定不用 CC Switch 管 Codex provider，只用 Codex++ Relay。那就先关闭 CC Switch 对 Codex 的路由和 provider 接管。

一句话：

CC Switch 和 Codex++ 只能有一个负责 provider。

Codex++ Relay / 增强边界

#7. 做最小验证

不要一上来跑大项目。

先在 Codex 里发一个只读任务：

读取当前项目结构，告诉我技术栈。不要修改文件。

同时看三处：

  • Codex 能正常回复；
  • CC Switch 里请求数或日志有变化；
  • 第三方 API 后台有 token 消耗。

还可以在 CC Switch 里跑 Model Test，先测 Key、模型、endpoint 是否通。

Model Test 验证

#常见翻车点

1. Codex 还是旧模型

重启 Codex。Codex 进程可能已经读过旧配置。

2. 404 / 400 / 流式解析报错

大概率是把 Chat Completions endpoint 直接给了 Codex。检查 Local Routing 和“需要本地路由映射”。

3. 插件入口不见了

从 Codex++ 入口启动，不要从原始 Codex 入口启动。

4. 配置来回变

停掉其中一个接管方。推荐保留：

CC Switch：provider + routing
Codex++：App enhancement

#最短路线

照这个顺序做：

备份配置
-> 装 CC Switch
-> 装 Codex++
-> CC Switch 添加 Codex provider
-> 开 Local Routing
-> 启用 provider 并重启 Codex
-> Codex++ 只开增强
-> 小任务验证

这就是最稳的联合用法。