CC Switch 使用指南：用自定义模型跑 Codex

CC Switch 是什么

CC Switch 是一款 macOS 桌面应用（Tauri / Rust 构建，当前版本 3.16.3），它的核心是一个本地代理服务器，运行在 http://127.0.0.1:15721。你可以在 GitHub 上找到它：farion1231/cc-switch。

它解决了一个很实际的问题：像 Codex、Claude Code 这类 AI 编程工具通常绑定到特定厂商的模型，但 CC Switch 可以在中间拦截 API 请求，把它们转发到你自选的模型提供商（比如 DeepSeek、OpenRouter 或任何兼容 OpenAI 协议的服务）。

简单说，你的流量流向变成了这样：

Codex / Claude / Gemini …… → CC Switch 本地代理 → 你的模型提供商（如 DeepSeek）

支持的工具

CC Switch 可以接管以下 AI 编码工具的 API 流量：

• Codex — OpenAI 的 AI 编程代理（CLI & 桌面版）
• Claude — Claude.ai Web 版
• Claude Desktop — Claude 桌面客户端
• Gemini — Google Gemini
• OpenCode — 开源编码代理
• OpenClaw
• Hermes — Hermes Agent CLI

工作原理

CC Switch 的工作流程分为三步：

1. 启动本地代理
应用启动后，在 127.0.0.1:15721 开启一个 HTTP 代理服务器。

2. 接管工具配置
在 CC Switch 的界面中，选择你想要接管的目标工具（如 Codex）。它会自动备份该工具原本的 API 配置，然后把 API base URL 替换成自己的代理地址。

3. 转发请求
当 Codex 发起 API 请求时，流量先到达 CC Switch 的本地代理，代理再根据你选择的模型提供商（如 DeepSeek），将请求转发到对应的真实 API 端点。响应沿原路返回。

从日志可以看到这样的转发记录：

[Codex] >>> 请求 URL: https://api.deepseek.com/v1/chat/completions (model=deepseek-v4-flash)

配置步骤：以 Codex + DeepSeek 为例

1. 安装并启动 CC Switch

从 GitHub Releases 下载 CC Switch.app，拖入 /Applications。首次启动时，应用会自动注册 deep-link URL handler（ccswitch://）。

启动后，留意菜单栏图标 — 应用默认最小化到托盘，代理服务会在后台持续运行。

2. 添加模型提供商

在 CC Switch 的设置面板中，添加你的模型提供商：

• Provider Name：自定义名称，例如 deepseek
• API Base URL：模型提供商的 API 地址，例如 DeepSeek 为 https://api.deepseek.com/v1
• API Key：你的 API 密钥
• Wire API：选择协议兼容模式，Codex 通常使用 responses 或 chat_completions

3. 接管 Codex

在 CC Switch 主界面上，找到 Codex 卡片，点击「接管」。应用会自动执行以下操作：

• 备份 Codex 当前 live 配置到数据库
• 将 Codex 的模型提供商指向本地代理：http://127.0.0.1:15721/v1
• 同步 OAuth token 到 CC Switch 数据库

4. 配置 Codex

在 Codex 的配置文件 ~/.codex/config.toml 中，加入以下内容：

model_provider = "custom"
model = "deepseek-v4-flash"
model_catalog_json = "cc-switch-model-catalog.json"

[model_providers.custom]
name = "deepseek"
base_url = "http://127.0.0.1:15721/v1"
wire_api = "responses"
requires_openai_auth = true

cc-switch-model-catalog.json 文件由 CC Switch 自动生成，放在 ~/.codex/ 目录下，定义了可用的模型列表（模型名称、上下文窗口、支持的推理等级等）。

5. 开始使用

配置完成后，直接在终端运行 codex 命令或启动 Codex 桌面应用即可。所有 API 请求都会经过 CC Switch 代理，转发到你的自定义模型。

验证是否生效

打开 CC Switch 的日志文件 ~/.cc-switch/logs/cc-switch.log，如果能找到类似下面的日志行，说明代理正常工作：

[Codex] >>> 请求 URL: https://api.deepseek.com/v1/chat/completions (model=deepseek-v4-flash)

高级技巧

同时接管多个工具

你可以在 CC Switch 中同时接管 Codex 和 Claude，让它们使用同一个自定义模型。每个工具的配置独立存储，互不干扰。

异常恢复

如果 CC Switch 异常退出，下次启动时会自动检测残留的代理接管状态，并从数据库备份中恢复各工具的原始配置。即使崩溃，你的工具配置也不会损坏。

切换模型提供商

在 CC Switch 界面中随时可以切换当前使用的模型提供商，无需修改 Codex 的配置文件。切换时应用会自动更新代理的路由目标。

关键文件一览

注意事项

• 确保 CC Switch 在后台保持运行，否则 Codex 的 API 请求会失败
• 如果在 CC Switch 中取消接管某个工具，它会自动恢复该工具的原始 API 配置
• 代理服务仅监听 127.0.0.1，不会暴露到外部网络，安全性有保障
• DeepSeek 是目前最流行的搭配，但任何兼容 OpenAI API 的提供商都可以使用
• Codex 桌面版和 CLI 版都支持通过 CC Switch 转发

总结

CC Switch 是一个优雅的解决方案：它在你的机器上运行一个轻量级代理，充当 AI 编程工具和模型提供商之间的桥梁。不需要修改工具代码，不需要复杂的网络配置，打开应用、点击接管、开始编码 — 就这么简单。

如果你已经厌倦了被绑死在某个厂商的模型上，CC Switch 值得一试。