如果你需要使用AI进行编程,自己接入API。那么,非常推荐你安装cc-switch进行配置管理。
1、什么是CC Switch?
- 官网链接:https://ccswitch.io/
- GitHub 仓库:https://github.com/farion1231/cc-switch
CC Switch 是一款开源的跨平台桌面工具(基于 Tauri 2 构建),专为 AI 编程 CLI 工具设计,用来统一管理和一键切换多个 API 供应商配置。
它主要解决以下痛点:
使用 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 等工具时,切换不同 API 供应商(官方或第三方中转)需要手动修改配置文件(JSON、TOML、环境变量等),容易出错且麻烦。
多个工具的配置分散,格式不统一,管理困难。
想同时保留多个 API Key / 供应商作为备份,或快速切换模型时操作繁琐。
核心能力:
一键切换供应商:在图形界面中添加多个 Provider(内置 50+ 预设,也支持自定义),点击即可切换,自动写入对应工具的配置。
统一管理:支持 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 等主流 AI 编程工具。
本地代理与协议转换:可开启本地路由,支持不同 API 协议之间的转换,并具备故障转移、熔断等功能。
用量查询与监控:部分供应商支持实时查看剩余额度。
MCP / Skills 管理:统一管理各工具的 MCP 服务器和 Skills。
系统托盘快速切换:方便日常使用。
简单来说,CC Switch 就是 AI 编程工具的「配置中心 + 切换管家」,让你告别手动改配置文件的痛苦。
2、正常配置
2.1、指定厂商
以GLM为例,去官网登录注册------ https://www.bigmodel.cn。然后去控制台获取key,这个页面点击右上角新建key即可:

然后打开cc-switch,点击右上角➕,选择统一供应商,这样一次配置,多个工具均可使用:


参数如下:
- 请求地址:https://open.bigmodel.cn/api/paas/v4/chat/completions
- 官网:https://open.bigmodel.cn
- apikey:填在官网获取的
2.2、接入平台
3、OpenAPI格式与Athropic格式转换
如果公司提供的AI Key或者资源,只支持OpenAPI或者Athropic中的一种格式,那么CC Switch也可以做到互相转换使用。
3.1、OpenAPI配置成Athropic
适用场景:手里只有 OpenAI Chat Completions 或 Responses API 的 Key,想用在 Claude Code 上。
操作步骤
- 打开 CC Switch,切换到 Claude 分组
- 点击右上角 + → 选择「自定义」或「统一供应商」
- 填写基础信息:
- 供应商名称 :自定义(如
公司OpenAI网关) - API Key:你的 OpenAI 兼容 Key
- 请求地址 :填网关根地址(不要以
/结尾,例如https://api.example.com)
- 供应商名称 :自定义(如
- 展开 高级选项 :
- API 格式 选择:
- 若上游是
/v1/chat/completions→ 选 OpenAI Chat Completions(需开启路由) - 若上游是
/v1/responses→ 选 OpenAI Responses API(需开启路由)
- 若上游是
- API 格式 选择:
- (可选)填写模型映射,把 Claude Code 里的 Sonnet/Opus/Haiku 角色映射到真实上游模型名
- 保存并点击 启用
- 确保本地路由已开启,并且 Claude 应用路由 已打开
完成后,Claude Code 发出的 Anthropic 请求会被自动转换成 OpenAI 格式发给上游,响应再转回 Anthropic 格式。工具调用、流式输出、图片等都能正常工作。
3.2、Athropic配置成OpenAPI
适用场景:手里只有 Anthropic Messages 协议的 Key(很多 Claude 中转网关都是这种),想用在 Codex 上。
操作步骤
- 打开 CC Switch,切换到 Codex 分组
- 点击右上角 + → 选择「自定义」
- 填写基础信息:
- 供应商名称 :自定义(如
公司Claude网关) - API Key:你的 Anthropic 兼容 Key
- 请求地址 :填网关根地址(例如
https://claude-gateway.example.com,路由会自动处理/v1/messages) - 默认模型:填网关实际支持的模型 ID(以网关文档为准)
- 供应商名称 :自定义(如
- 展开 高级选项 :
- 把 上游格式 从默认的
Responses(原生)改成 Anthropic Messages(需开启路由)
- 把 上游格式 从默认的
- 保存并点击 启用
- 确保本地路由已开启,并且 Codex 应用路由 已打开
完成后,Codex 发出的 Responses 请求会被转换成 Anthropic Messages 发给上游,响应再转回 Responses 格式返回给 Codex。