CCX + CC Switch：让Codex接入DeepSeek、Kimi Coding的黄金组合

发表于 更新于 分类于 ， 阅读次数： 本文字数： 3.7k 阅读时长 ≈ 3 分钟

CCX + CC Switch 让 Codex 接入第三方模型

OpenAI 的 Codex 是个好东西——既有轻量开源的 CLI 版本可以直接在终端跑 AI 编程代理，也有图形界面版本（Codex GUI）适合不习惯终端的用户。但有一个问题让很多人头疼：它默认走 Responses API，而市面上 90% 的第三方模型只支持 Chat Completions 协议。 想用 DeepSeek、Kimi Coding 这些便宜好用的模型？协议不兼容，直接报错。CCX + CC Switch 就是解决这个问题的黄金组合：CCX 负责底层协议转换，CC Switch 负责图形化管理切换。本文带你十分钟配置好，直接上手用。

核心矛盾：Responses API vs Chat Completions

Codex（无论 CLI 还是 GUI）默认走 OpenAI 的 Responses API（/v1/responses），这是 2025 年出的新协议，给 Agent 场景设计的，支持多轮对话追踪、工具调用编排、结构化输出。Codex 靠这些能力完成文件读写、命令执行、代码搜索。

但市面上绝大多数第三方模型只认 Chat Completions API（/v1/chat/completions）。这是 OpenAI 最早也最常见的协议，DeepSeek、Kimi Coding、GLM、Ollama 本地模型，全都走这个。

两套协议的数据格式、请求结构、响应结构全不一样。你把 Codex 的 Responses 请求直接发给 DeepSeek 的 Chat Completions 端点，就像拿充电头去插 USB-C 口，物理上插不进去。

要么等第三方模型全都支持 Responses API（不知道要等多久），要么自己加一层协议转换。CCX 就是干这个的。

两个工具，各司其职

两个工具分工不同，容易搞混：

CCX（协议转换网关） 是底层苦力。它跑在你本地，监听一个端口（如 3333），接收 Codex 发来的 Responses API 请求，转换成 Chat Completions 格式发给上游模型（DeepSeek、Kimi Coding 等），再把响应转回 Responses 格式返回给 Codex。整个过程对 Codex 透明，它以为自己在跟 OpenAI 的 API 通信。

简单类比：CCX 就像一个实时翻译器。Codex 说”英文”（Responses API），第三方模型只听”中文”（Chat Completions），CCX 在中间做同声传译。两端都不需要改变自己的语言习惯。

CCX 的核心能力：

  • 支持 5 种 API 协议：Claude Messages、OpenAI Chat Completions、Codex Responses、OpenAI Images、Gemini——不只是 Codex，几乎覆盖了所有主流 AI 编程工具
  • 智能调度：优先级路由、健康检查、自动故障转移、熔断恢复
  • 单端口部署：所有协议走同一个端口（如 3333），不用开一堆服务
  • Web 管理面板：可视化添加渠道、测试连通性、查看日志
  • Go 语言编写，性能开销在毫秒级

CC Switch（图形化管理工具） 是上层指挥。跨平台桌面应用（Tauri + Rust + React），用图形界面管理 Provider 配置、一键切换模型、追踪用量和花费。没有它，每次切模型都得手动改配置、重启终端。

CC Switch 的核心能力：

  • 50+ Provider 预设：DeepSeek、Kimi Coding、Anthropic、Google、AWS Bedrock……开箱即用
  • 支持 5 个 AI 编程工具：Claude Code、Codex（CLI + GUI）、Gemini CLI、OpenCode、OpenClaw——一个工具管全部
  • 一键切换模型：不用改配置文件，不用重启终端（Claude Code 支持热切换）
  • 用量追踪：花费、请求数、token 数、趋势图，知道每天花了多少钱
  • MCP / Prompts / Skills 统一管理：一个面板管理多个工具的 MCP 服务器和提示词
  • macOS/Windows/Linux 全平台，支持 Homebrew 安装

两个工具组合起来的工作流：CC Switch 管”用哪个模型” → CCX 管”怎么把请求翻译成模型能懂的格式” → Codex（CLI 或 GUI）正常运行，完全感觉不到底层换了模型。

10 分钟完整配置流程

步骤 1：安装 CC Switch

CC Switch 支持 Windows、macOS、Linux 全平台。

macOS（推荐 Homebrew）：

1
2
brew tap farion1231/ccswitch
brew install --cask cc-switch

其他平台：前往 CC Switch GitHub Releases 下载对应安装包。Windows 有 .msi 安装版和 .zip 便携版；Linux 有 .deb、.rpm 和 .AppImage。

安装后启动，顶部切换到 Codex 模式(OpenAI 图标)。

步骤 2：安装并启动 CCX

前往 CCX GitHub Releases 下载最新二进制文件。

在二进制文件同目录创建 .env 文件：

1
2
3
4
PROXY_ACCESS_KEY=your-super-strong-secret-key   # 自己设一个强密钥
PORT=3333
ENABLE_WEB_UI=true
APP_UI_LANGUAGE=zh-CN

PORT 默认填 3333，只要不和你本地其他服务冲突就行。

启动 CCX：

1
2
3
4
5
# macOS / Linux（具体以你下载的可执行文件名为准）
chmod +x ccx
./ccx

# Windows 双击 ccx.exe 即可

启动成功后，浏览器访问 http://localhost:3333 进入 Web 管理面板。

步骤 3：在 CCX 中添加上游渠道

进入 CCX Web 面板，选中Codex，添加新渠道（Channel）：

以 Kimi Coding 为例：

  • 类型选择：OpenAI Chat Completions

  • Base URL：https://api.kimi.com/coding/v1

  • 填入 Kimi Coding 的 API Key

  • Header部分填写 User-Agent: KimiCLI/1.5 ， 不然会报错（kimi coding的模型会校验User-Agent）

以 opencode GO 为例：

  • 类型选择：OpenAI Chat Completions
  • Base URL：https://opencode.ai/zen/go
  • 填入 opencode GO 的 API Key

以 DeepSeek 为例：

  • 类型选择：OpenAI Chat Completions
  • Base URL：https://api.deepseek.com/v1
  • 填入 DeepSeek 的 API Key

保存后点击测试，确认通道可用。

步骤 4：在 CC Switch 中配置 Codex 使用 CCX

打开 CC Switch，确保在 Codex 模式下，添加新 Provider：

  • Base URL：http://localhost:3333/v1（指向本地 CCX）
  • API Key：你在 .env 中设置的 PROXY_ACCESS_KEY
  • 模型名称：获取模型列表，然后选中要使用的模块就行

步骤 5：验证

1
codex

启动 CLI 的或者打开桌面版的 Codex，发送个你好，如果 Codex 正常响应，说明协议转换成功了。

进阶技巧

创建多个 Profile 一键切换：我在 CC Switch 里配了三个 Profile——openai（复杂任务）、deepseek-pro（日常编码）、kimi-k2.6（国产模型）。根据任务复杂度一键切换，不用改任何配置。

用中转平台提升稳定性：如果你在国内直连 DeepSeek 或 Kimi 的 API 偶尔超时，可以把中转平台的地址配在 CCX 里作为上游，CCX 再统一提供给 Codex。这样 Codex 只需要连本地 CCX，稳定性大幅提升。

优先选用支持 Tool Calling 的模型：Codex 的很多高级功能（文件读写、命令执行）依赖 Tool Calling。DeepSeek 和 Kimi Coding 都支持，但一些小模型可能不支持，配之前先确认。CLI 和 GUI 版本的 Codex 都依赖此能力。

什么时候不需要这套？

说了这么多好处，什么时候不需要这套？

只用 OpenAI 官方模型，不需要 CCX 做协议转换，CC Switch 的价值也大打折扣，直接用 Codex 默认配置就行。

不关心成本，公司账号或 ChatGPT Pro 订阅用户，API 费用不是考量因素，折腾的动力不大。

网络环境不稳定，CCX 和 CC Switch 跑在本地，本机经常关机或换网络的话，每次重启服务反而增加维护成本。

只用 Claude Code 不用 Codex，CC Switch 同样支持 Claude Code（而且热切换体验更好），但 CCX 的协议转换对 Claude Code 不是必需的，Claude API 协议本身就是统一的。

总结

CCX 解决协议兼容性问题，让 Responses API 和 Chat Completions 之间不再有鸿沟。CC Switch 解决管理效率问题，让模型切换从手动改配置变成一键操作。两者结合，Codex 接入第三方模型的门槛从”需要理解两种 API 协议差异并手动配置”降到了”装两个工具、填几个表单、十分钟搞定”。

如果你在用 Codex 又想降 API 成本，这俩是目前社区最稳的组合。就像我在之前聊 Spec 编程时说的，工具的意义不是替代思考，而是把重复的机械操作自动化。