一个开源工具，同时管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 和 Claude Desktop 七款 AI 编程助手。本地代理转发、格式自动转换、用量实时追踪——CC-Switch 正在成为 AI 编程时代的"总控制台"。

一、什么是 CC-Switch

CC-Switch 是一个开源的全方位 AI 编程工具管理器，基于 Tauri 2 构建，支持 Windows / macOS / Linux 三平台。截至 v3.16.4（2026-06-27），它已覆盖七款主流 AI 编程工具的统一配置管理：

工具 类型 CC-Switch 管理能力
Claude Code Anthropic 编程 CLI 模型切换、Provider 管理、用量追踪
Codex OpenAI 编程 CLI 模型切换、Responses↔Chat 格式互转、用量追踪
Gemini CLI Google 编程 CLI 模型切换、Provider 管理
OpenCode 开源编程 Agent Provider 配置、Go 订阅预设
OpenClaw AI Agent 框架 Provider 管理、模型配置
Hermes Agent AI Agent 框架 Provider 管理
Claude Desktop Anthropic 桌面应用 Provider 配置、MCP 管理

它的核心能力可以归纳为四层：

┌─────────────────────────────────────────┐
│          🎛️ 统一管理界面（GUI）           │
│   一站式配置所有工具的 Provider 和模型     │
├─────────────────────────────────────────┤
│          🔄 本地代理路由（Proxy）          │
│   拦截 API 请求 → 格式转换 → 转发到目标    │
├─────────────────────────────────────────┤
│          📊 用量监控与分析                 │
│   Token 消耗 / 费用统计 / 会话历史 / 图表   │
├─────────────────────────────────────────┤
│          🧩 供应商生态（20+ Providers）    │
│  官方 API + 中转服务商 + 自定义 Provider   │
└─────────────────────────────────────────┘

二、安装与启动

2.1 下载

访问 CC-Switch Releases，下载对应平台版本：

平台 推荐格式
Windows x64 .msi 安装包
Windows ARM64 .msi 安装包
macOS .dmg 或 .zip
Linux x86_64 .AppImage 或 .deb
Linux ARM64 .AppImage 或 .deb

2.2 安装

  • Windows：双击 .msi，一路下一步，安装完成后桌面和开始菜单都会有快捷方式
  • macOS：双击 .dmg，拖入 Applications 文件夹
  • Linux：chmod +x CC-Switch*.AppImage && ./CC-Switch*.AppImage

2.3 初始设置

首次启动后，建议先完成：

  1. 确认界面语言（支持中/英/日/德四种语言）
  2. 进入「设置」→「路由」，确认本地代理端口（默认 15721）
  3. 浏览「供应商（Provider）」列表，了解内置了哪些预设提供商

⚠️ CC-Switch 需要保持后台运行才能维持本地代理服务。关闭窗口后，它会最小化到系统托盘。

三、核心功能详解：本地代理路由

这是 CC-Switch 最核心、最强大的功能。

3.1 为什么需要本地代理？

AI 编程工具原生的 API 请求格式和地址各不相同：

工具 原生 API 格式 原生端点
Codex OpenAI Responses API api.openai.com/v1/responses
Claude Code Anthropic Messages API api.anthropic.com/v1/messages
Gemini CLI Gemini API generativelanguage.googleapis.com
OpenClaw OpenAI Completions API 可自定义

当你想把 Codex 的模型从 OpenAI 换成国内的 DeepSeek、通义千问或智谱 GLM 时，问题来了：

  • DeepSeek 只有标准 Chat Completions API（/v1/chat/completions），没有 /v1/responses 端点
  • 千问、Moonshot 等也逐渐支持了原生 Responses API，但格式仍有差异
  • 每个中转服务商的端点和模型命名规则都不同

CC-Switch 的本地代理就是来解决这些差异的——接收 Codex 发出的 Responses 格式请求，自动转换成 Chat Completions 格式，再转发到 DeepSeek。

3.2 数据流转过程

Codex 客户端
   │
   │ POST /v1/responses  (OpenAI 格式)
   ▼
http://127.0.0.1:15721/v1  ← CC-Switch 本地代理
   │
   │ 格式转换: Responses → Chat Completions
   │ 模型映射: codex → deepseek-chat
   │
   ▼
https://api.deepseek.com/v1  ← DeepSeek 官方 API
   │
   │ Chat Completions 格式响应
   ▼
CC-Switch 本地代理
   │
   │ 格式转换: Chat Completions → Responses
   │
   ▼
Codex 客户端 ← 无感知，正常工作

CC-Switch 在中间做了双向格式转换，两端都无感知——Codex 以为自己还在跟 OpenAI 对话，DeepSeek 收到的也是标准 Chat 请求。

3.3 路由配置总览

在「设置」→「路由」标签页中：

配置项 说明
路由总开关 全局开启/关闭本地代理
监听端口 默认 15721，可自定义
路由应用 独立开关控制 Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw / Hermes
日志记录 开启后记录所有请求详情，方便排查问题
用量数据 可自定义时间范围查看 Token 消耗趋势

最佳实践：仅开启你当前使用的工具路由，避免多个代理同时运行造成不必要的复杂度。

四、实战案例：Codex 对接 DeepSeek 完整配置

这是最常见的私有部署场景——用 CC-Switch 将 Codex 从 OpenAI 切换到 DeepSeek，降低使用成本。
在这里插入图片描述

4.1 DeepSeek 平台准备

  1. 登录 DeepSeek 开放平台，完成实名认证
  2. 进入「API Keys」，创建新密钥，保存 sk-xxxx（仅创建时可见）
  3. 确认账户余额充足

4.2 CC-Switch 供应商配置

步骤一：点击右上角 + 新建供应商，命名为 DeepSeek

步骤二：填写基础信息

字段 内容 注意
官网链接 https://platform.deepseek.com 仅展示
API 请求地址 https://api.deepseek.com/v1 必须开启「完整URL」开关
API Key sk-你的密钥 清除前后空格

步骤三：展开「高级选项」，关键配置

配置项 设置值 原理
上游格式 Chat Completions（转换） 🔑核心开关，告诉代理需要做格式互转
需要本地路由映射 ✅ 开启 允许 Codex 的模型名映射到 DeepSeek 的模型名
支持思考模式 ✅ 开启 同步推理深度参数
支持思考等级 ✅ 开启 同步推理深度参数

步骤四：添加模型映射规则

Codex 调用名 DeepSeek 真实模型 ID 用途
codex / code-davinci-002 deepseek-chat 通用编程
codex-fast deepseek-chat 快速响应

⚠️ 模型映射是关键！如果缺少映射规则，Codex 发出 codex 模型请求时，CC-Switch 不知道应该转发到哪个 DeepSeek 模型，会导致调用失败。

步骤五：保存，回到主界面，将该供应商设置为「使用中」。

4.3 Codex 客户端配置

三种方式任选其一（效果相同）：

方案 A：Codex 图形界面

Codex 左下角「设置」→「Chat Settings」→ 填入：

  • Custom API Base URL：http://127.0.0.1:15721/v1
  • API Key：与 CC-Switch 相同的 sk-xxxx

方案 B：命令行

codex config set api.base http://127.0.0.1:15721/v1
codex config set api.key sk-你的密钥
codex config list  # 验证配置

方案 C：手动编辑配置文件

编辑 %USERPROFILE%\.codex\config.toml：

[api]
base = "http://127.0.0.1:15721/v1"
key = "sk-你的DeepSeek密钥"
wire_api = "responses"

4.4 验证连通

  1. 重启 Codex，发送任意编程问题
  2. 在 CC-Switch 路由页面查看：总请求数 > 0、成功率 = 100%
  3. Codex 正常返回代码，无 404 / 鉴权错误

4.5 常见故障速查

故障 根因 解决
404 Not Found /responses 没有经过 CC-Switch 代理，Codex 直连了 DeepSeek 确认 Codex Base URL 是 http://127.0.0.1:15721/v1，不是 api.deepseek.com
持续「重新连接」 CC-Switch 未运行或端口不一致 保持 CC-Switch 后台运行，核对端口
Invalid API Key 密钥错误或余额不足 检查 Key 有无空格、账户是否实名、余额是否足够
代码生成效果差 模型映射用了通用模型 确认映射规则指向代码专用模型
路由请求数始终为 0 Codex 没有走代理 重新保存 Codex 配置并重启客户端

五、CC-Switch 的完整功能矩阵

Codex+DeepSeek 只是 CC-Switch 能力的冰山一角。以下是它的完整功能体系：

5.1 七大工具统一管理

CC-Switch 对每款工具都提供了独立的配置面板：

工具 支持的功能
Claude Code Provider 切换、Auto-Compact Window 设置、模板变量、自定义请求头/体覆写
Codex Provider 切换、Chat/Responses 格式互转、推理深度控制、模型映射
Gemini CLI Provider 切换、Gemini 兼容端点配置
OpenCode Provider 切换、Go 订阅预设、OpenAI 兼容端点
OpenClaw Provider 管理、多模型配置
Hermes Agent Provider 管理
Claude Desktop Provider 配置、MCP Server 管理

你可以在 CC-Switch 里为 Claude Code 切换到 Kimi，同时为 Codex 切换到 DeepSeek，再为 Gemini CLI 挂上中转——全在一个界面里搞定。

5.2 内置 Provider 生态

CC-Switch 预设了大量 Provider，覆盖官方 API 和国内主流中转服务商：

官方 Provider：

  • OpenAI（Claude Code / Codex）
  • Anthropic
  • Google Gemini
  • DeepSeek
  • Moonshot Kimi
  • MiniMax
  • 智谱 GLM
  • 火山引擎豆包
  • 阿里云百炼（通义千问）
  • 硅基流动（SiliconFlow）
  • 小米 MiMo
  • 美团 LongCat

新增 Provider（v3.16.4）：

  • SubRouter：聚合多提供商的 AI 中继
  • 火山 Ark Coding Plan / Agent Plan：订阅制编程套餐
  • OpenCode Go：开源编程 Agent 订阅

你也可以自定义任意 Provider——填入自己的 API Base URL 和 Key 即可接入任何兼容 OpenAI/Anthropic 协议的 API。

5.3 用量监控与费用分析

CC-Switch 内置了全面的用量追踪系统：

  • 实时 Token 消耗统计：按工具、按 Provider、按模型纬度统计
  • 费用预估：支持从 models.dev 导入官方定价，自动计算费用
  • 自定义时间范围：按天/周/月查看，支持"实时追踪当前消耗"模式
  • 会话历史：查看每次对话的详细信息，点击可直接定位到会话日志文件
  • 火山 Ark Coding Plan 配额查询：支持编程套餐和 Agent 套餐的 5 小时/周/月额度查询

5.4 高级代理功能（v3.16.4 新增）

功能 说明
自定义请求头 为每个 Provider 添加专属 HTTP Header
自定义请求体覆写 转发前修改请求体内容
zstd 解压 支持 zstd 压缩的请求/错误体解压，方便调试
原生 Responses API 国内多厂商（Qwen/百炼、MiMo、豆包、LongCat、MiniMax）已支持原生 OpenAI Responses 格式，无需格式转换
上游格式解耦 可以独立选择上游格式（Chat/Responses/Gemini），不再绑定模型映射开关

5.5 其他实用功能

  • 多语言支持：中/英/日/德四语界面
  • 数据备份与恢复：数据库版本检测，新版不兼容时自动提示升级
  • Windows ARM64 原生构建：ARM Windows 设备无需模拟运行
  • 托盘最小化：关闭窗口后静默运行在系统托盘
  • 暗色主题：深色 UI 保护视力

六、CC-Switch vs 其他方案

对比维度 CC-Switch 手动配置环境变量 中转 API 服务
上手难度 ⭐⭐ GUI 操作 ⭐⭐⭐ 需手写配置 ⭐⭐ 注册购买
灵活性 ⭐⭐⭐ 任意 Provider ⭐ 仅改一个端点 ⭐⭐ 依赖中转方
格式兼容 ⭐⭐⭐ 自动转换 ❌ 不支持 ⭐⭐ 部分支持
多工具管理 ⭐⭐⭐ 七合一 ❌ 逐个配置 ❌ 逐个配置
用量监控 ⭐⭐⭐ 内置 ❌ 无 ⭐⭐ 服务商提供
长期成本 免费开源 免费 按量/按月付费
隐私安全 本地运行，Key 不上传 Key 在本地 Key 上传到中转方

七、最佳实践与踩坑总结

7.1 部署 Checklist

  • CC-Switch 安装为开机自启动（托盘常驻）
  • 仅开启当前使用的工具路由（关闭不用的，减少干扰）
  • 所有 Provider API Key 统一管理在 CC-Switch 中
  • 定期检查各 Provider 账户余额
  • 开启路由日志，方便问题排查
  • 模型映射规则与实际使用的 Provider 模型保持一致

7.2 配置原则

  1. 一个 Provider，一个用途：Codex 用 DeepSeek、Claude Code 用 Kimi、Gemini 用火山——各管各的，互不干扰
  2. 格式转换仅在最必要时开启：如果 Provider 原生支持对应格式（如百炼最新版支持 Responses），优先使用原生，减少转换开销
  3. 端口不要冲突：如果本地同时运行多个代理工具，确保端口不重叠
  4. 密钥安全：CC-Switch 的配置数据存储在本地 SQLite 数据库中，不会上传云端

7.3 性能建议

  • CC-Switch 本身是轻量级本地代理，转发延迟通常 < 10ms，对实际 API 调用速度影响微乎其微
  • 如果同时使用多个工具，建议将 CC-Switch 进程优先级设置为「高」
  • Windows 用户建议关闭"自动休眠"，避免系统休眠后代理失效

结语

CC-Switch 本质上解决了一个看似简单却极其繁琐的问题：在 AI 编程工具百花齐放的时代，怎样用一个统一的入口管理好所有工具的模型配置？

它最巧妙的设计在于本地代理路由——不侵入任何工具本身的代码或配置结构，而是在中间层做"翻译工作"，让 Codex 以为在跟 OpenAI 聊天，让 DeepSeek 收到的始终是标准请求。

对于需要在国内网络环境下使用海外 AI 编程工具的开发者，CC-Switch 几乎是无可替代的标配工具。它开源、免费、跨平台，配套的 Provider 生态涵盖了从官方 API 到国内主流中转服务的完整链路。

更重要的是，它的代码完全透明——你的 API Key、你的请求数据，始终在你的本地机器上流转，不经过任何第三方服务器。

本文基于 CC-Switch v3.16.4（2026-06-27 发布）撰写。
项目地址：https://github.com/farion1231/cc-switch
官方网站：https://ccswitch.io

# python
Logo
DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

AI编程工具怎么选？5款主流工具半年深度体验的实战建议

从那以后我的习惯是：AI生成的代码必须人工审核、涉及业务逻辑的代码多验证几个边界场景、如果AI给出的建议你不太确定，先去查文档而不是直接采纳。但半年实际使用下来，我的结论是：不存在"最好的"，只存在"最适合你的"。比起自己做review，AI会看得更细：变量命名不规范、潜在的空指针、遗漏的边界判断、可能的性能问题。真正需要Claude Code的，是那些需要长周期开发、大量上下文记忆的复杂项目。这

avatar DeepSeek技术社区
cover

目前2026年7月性价比最高的Coding Plan方案，适合经常使用DeepSeek和GLM大模型的开发者

avatar DeepSeek技术社区
cover

现在用 DeepSeek v4 Pro 模型最便宜的渠道是啥？论坛网友实测：一个月几十元就够用

avatar DeepSeek技术社区