CCSwitch:用一个界面管完所有AI工具的API配置

同时用着 Codex、Claude Code、Gemini 好几款 AI 工具，结果每个都要单独配 API Key、填 Base URL。用这个的时候要切换一下，用那个的时候又要改一套配置。

烦不烦？

是真的烦。

有时候为了测试不同模型的效果，要来回折腾半天。配置一多起来，根本记不清哪个 Key 对应哪个服务商的哪个接口。

我就是这么被折磨了好几个月，直到发现了一个小工具——CC-Switch。

说实话，用上它的第一天，我就后悔了。

后悔没早点发现。

01 这个工具到底是干嘛的

简单说，CC-Switch 就是一个配置管理器。

它的核心功能就一个：把所有 AI 工具的 API 配置集中到一起，一个界面搞定 Key 管理、地址切换，还能一键来回换。

想象一下：

之前你可能要这样：

• 打开 Codex 设置 → 填 Key → 填地址 → 保存
• 打开 Claude Code 设置 → 填 Key → 填地址 → 保存
• 打开 Gemini 设置 → 填 Key → 填地址 → 保存

每次换工具都要折腾一遍，还容易搞混。时间久了，根本不知道哪个配置对应哪个工具。

现在呢？

CC-Switch 打开 → 选工具 → 选配置 → 搞定。

就这么简单。

02 适合谁用

说实话，如果你只用一款 AI 工具，而且配置好了基本不动，那这个工具对你的意义不大。

但如果你是下面这几种人，那真的建议你试试。

同时用多个 AI 工具的

比如我，既用 Codex 写代码，又用 Claude Code 做分析，偶尔还要调一下 Gemini。每个工具的 API 配置都不一样，之前切换一次要搞半天，现在点两下就切换了。

而且有时候同一个任务，我需要对比不同 AI 工具的效果。比如让 Codex 和 Claude Code 同时处理一段代码，看哪个写得更好。以前切换配置要老半天，现在直接点一下就换过去了，效率提升明显。

在不同服务商之间跳转的

有些人用官方 API，有些人用中转代理，还有些人两个混着用。

为什么会混着？因为省钱。官方 API 贵，中转代理便宜，但稳定性参差不齐。遇到重要任务用官方，普通任务用中转，这时候切换频率就很高。

不同服务商的 Base URL 完全不一样，每次换都要重新查文档、重新填。

CC-Switch 支持预设供应商，也支持自定义配置，填一次后面直接切换就行。

经常调试 AI 应用的

比如你在做 AI 应用开发，需要频繁切换不同的模型、不同的服务商。一个好的配置管理工具能省下大把时间。

我之前帮朋友调试一个 AI 应用，光是切换测试环境就花了好几天。现在有了 CC-Switch，半小时搞定，还能把常用配置保存下来，下次直接用。

03 怎么用（Windows 版教程）

好了，说了这么多，来点实际的。

下面手把手教你在 Windows 上配置 CC-Switch。

下载安装

先打开 CC-Switch 的 GitHub 页面，找到 Releases 下载页，下载 Windows x64 版本安装包，然后安装就行。

• CC-Switch GitHub：https://github.com/farion1231/cc-switch
• CC-Switch 中文说明：https://github.com/farion1231/cc-switch/blob/main/README_ZH.md
• Releases 下载页：https://github.com/farion1231/cc-switch/releases

安装完打开，界面干净清爽，没有乱七八糟的东西，这点我挺喜欢的。

准备两样东西

正式开始配置之前，你需要准备：

API Key——就是你从服务商那里拿到的密钥，通常是一串看起来随机的字符。每个服务商的 Key 格式可能不一样，填的时候看清楚。

Base URL / Endpoint——这是接口的请求地址，不同服务商完全不一样。填错了直接连不上，会报 401/404 或者连接失败。

怎么查？去你用的服务商的文档里找”API Endpoint”或”Base URL”那部分，照着填就行。

另外提醒一下：API Key 是敏感信息，不要截图发出去，也不要上传到公开的地方。安全第一！

新增 Codex 配置

打开 CC-Switch，找到 Codex 入口，点击进去，然后点「+」新增配置。

这时候会让你选择供应商：

• 列表里有你用的服务商？直接选
• 列表里没有？选「自定义」，按服务商给的文档填写

填入 API Key 和 Base URL，保存。

搞定！

切换使用

配置保存之后，后面每次想切换到不同的配置，直接在 CC-Switch 里点一下就行。

不用再去每个工具的设置里翻找了。

04 踩过的坑

说完正常流程，说说我踩过的几个坑，你们绕着走。

Base URL 填错

这个坑我踩得最多。

Base URL 格式很严格，多一个斜杠少一个路径都不行。

有些服务商要求结尾带 /v1，有些要求不带。你要是照着别人的配置抄，大概率会失败。

我之前就栽过一次，查了半天文档，最后发现就是 URL 结尾多了个斜杠。

血的教训： 直接去你服务商的官方文档里复制，不要自己手打！地址这东西，一个字符都不能差。

Key 过期了

有些 API Key 是有有效期的，过期了就会报 401 错误。

我之前碰到过一次，一直以为是地址填错了，查了半天，最后才发现是 Key 过期了。浪费了好多时间。

建议： 定期检查 Key 的状态，或者在服务商后台设置过期提醒。

网络问题

有时候公司网络或者代理会拦截请求，导致连不上。

解决办法： 先确认本地网络能访问服务商地址，ping 一下看看通不通。

05 总结

用了一段时间 CC-Switch 下来，我的感受就一个字：

值！

省下的时间和精力，远超安装配置它花的那几分钟。

如果你也在同时用多款 AI 工具，如果你也在为配置管理头疼，真的建议试试。

最后给你三个核心要点：

1. CC-Switch 是干嘛的：集中管理 AI 工具的 API 配置，一键切换
2. 适合谁用：同时用多个 AI 工具、在不同服务商之间切换、经常调试 AI 应用的人
3. 关键注意点：API Key 是敏感信息别乱发，Base URL 严格按服务商文档填写

你现在用几款 AI 工具？配置管理上有没有什么痛点？

评论区聊聊，看看有没有什么更好的解决方案。

觉得有用的，点个「在看」，分享给有需要的朋友。

我们下期见！