当五个AI编程助手同时需要换供应商:我是如何从配置地狱爬出来的

/当五个 AI 编程助手同时"需要"换供应商：我是如何从配置地狱爬出来的/

发布日期： 2026 年 05 月 09 日 分类： ai_diary 作者： 魔都水滴

说出来你们可能不信，就在上周，我同时在用五款 AI 编程助手：Claude Code、Codex、OpenCode、OpenClaw，还有一个 Gemini CLI。

为什么这么多？因为工作需要不同的工具。有的做代码审查厉害，有的生成测试用例快，有的跟我的工作流集成得好。

但问题来了：某天，我常用的那个 API 代理商突然发了封邮件，说 endpoint 要更换，请更新配置。我一看邮件，心凉了半截。

五款工具。五种配置格式。五个不同的配置文件路径。

这就是我今天的故事：从配置地狱爬出来，然后遇见了 CC Switch CLI。

一、背景：五个工具，五种方言

1.1

1.1 配置文件各不相同

先看看我之前的配置文件有多乱：

Claude Code 用的是 ~/.claude/settings.json，字段名是 anthropicApiKey 和 apiUrl。
Codex 用的是 ~/.codex/config.toml，字段名是 api_key 和 base_url。
Gemini CLI 最特殊，用的是 ~/.gemini/.env 环境变量格式。
OpenCode 用的是 ~/.config/opencode/opencode.json，但格式跟 Claude 的还不完全一样。
OpenClaw 又有自己的 ~/.openclaw/openclaw.json 配置体系。

1.2

1.2 手工修改不是技术活，是风险点

每次换 API 供应商，我都得：

打开一个配置文件
查文档确认字段名
修改
保存
重复上面步骤四次

这不是在写代码，这是在填表。

而且最烦的是，有些字段名还很像但不完全一样，比如 base_url、apiUrl、endpoint，每次都要确认自己没改错。

图 1：没有 CC Switch 之前，我的配置管理状态。文件分散、格式各异，字段名还容易混。

二、痛点：换一次供应商到底要多久？

给你们算个时间账。假设我要把所有工具从“代理商 A”切换到“代理商 B”：

Claude Code：打开 ~/.claude/settings.json，找到 apiUrl 字段，修改，保存，约 3 分钟。
Codex：打开 ~/.codex/config.toml，找到 base_url，修改，保存，约 3 分钟。
Gemini CLI：修改 ~/.gemini/.env 里的环境变量，约 2 分钟。
OpenCode：打开 ~/.config/opencode/opencode.json，找到对应字段，约 3 分钟。
OpenClaw：打开 ~/.openclaw/openclaw.json，找到对应字段，约 3 分钟。

加起来：14 分钟。 而且这还是顺利的情况。如果手滑改错了字段，排查又要额外花时间。

更可怕的是，如果你有多个环境，比如公司、家里、不同项目，每个环境都要改一遍。

这不是在写代码，这是在跑腿。

三、转折点：发现 CC Switch CLI

忍无可忍之后，我开始搜索 AI 编程助手配置管理工具。然后我发现了两个项目：

farion1231/cc-switch：原始的桌面 GUI 版本，用 Rust + Tauri 写的。
SaladDay/cc-switch-cli：CLI 版本，功能一样，但更适合我这种 SSH 党。

最终我选择了 cc-switch-cli。原因很简单：

我大部分时间在远程服务器上工作。
命令行操作可以写脚本自动化。
TUI 界面跟我的工作流更契合。

安装只需要一行命令：

1curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash
2

安装完成后，输入 cc-switch 就进入交互式 TUI 界面。

四、CC Switch CLI 到底是什么？

CC Switch CLI 是一个用 Rust 写的跨平台命令行工具，专门用来统一管理多个 AI 编程助手的 Provider 配置。

4.1

4.1 支持哪些应用？

它支持这些常见入口：

Claude Code（默认）
Codex
Gemini CLI
OpenCode
OpenClaw

4.2

4.2 核心功能有哪些？

核心功能可以概括成六个模块：

功能模块	能干啥
Provider 管理	一键切换 API 供应商，支持速度测试
MCP 服务器管理	统一管理多个工具的 MCP 配置
Prompts 管理	备份和切换 System Prompts
Skills 管理	安装和管理社区 Skills 扩展
代理管理	本地多应用代理路由控制
配置管理	备份、恢复、WebDAV 同步

图 2：CC Switch CLI 的六大核心功能模块。微信版重新画成大字卡片，方便手机阅读。

五、核心功能详解

5.1

5.1 Provider 管理：一键切换供应商

这是 CC Switch 的核心功能。假设我有多个 API 供应商配置：

1# 列出所有已配置的供应商
2cc-switch provider list
3
4# 查看当前正在使用的供应商
5cc-switch provider current
6
7# 切换到指定供应商
8cc-switch provider switch apiyi-proxy
9
10# 测试供应商的 API 延迟
11cc-switch provider speedtest apiyi-proxy
12

CC Switch 会把所有供应商信息存在 SQLite 数据库里，也就是 ~/.cc-switch/cc-switch.db，然后根据不同应用生成对应的配置文件。

比如切到 Claude Code 时，它会更新 ~/.claude/settings.json；切到 Codex 时，它会更新 ~/.codex/config.toml。

你不需要知道每个工具的配置文件长什么样，CC Switch 帮你搞定一切。

图 3：Provider 切换的核心流程。先统一抽象，再按应用写回。

5.2

5.2 跨应用统一管理

这是 CC Switch 最让我惊喜的功能：一个 --app 参数搞定所有工具。

1# 列出 Claude 的供应商
2cc-switch --app claude provider list
3
4# 列出 Codex 的供应商
5cc-switch --app codex provider list
6
7# 查看 OpenClaw 的供应商
8cc-switch --app openclaw provider list
9
10# 同步 MCP 服务器到 Codex
11cc-switch --app codex mcp sync
12
13# 查看 Gemini 的提示词
14cc-switch --app gemini prompts list
15

这意味着：不管你用多少个 AI 编程工具，都可以用同一套命令操作它们。

5.3

5.3 Prompts 管理：不再丢失的提示词

你们有没有过这种经历：花了半天写了一个完美的 System Prompt，结果换了个环境就找不到了？

CC Switch 的 Prompts 管理功能可以：

备份所有应用的 System Prompt，比如 CLAUDE.md、AGENTS.md、GEMINI.md 等。
创建多个提示词预设，随时切换。
通过 WebDAV 同步到云端，换机器也不怕。

1# 列出所有提示词预设
2cc-switch prompts list
3
4# 创建新预设
5cc-switch prompts create "代码审查模式"
6
7# 激活预设
8cc-switch prompts activate 代码审查模式
9
10# 导出到文件
11cc-switch config export ~/cc-switch-backup.json
12

5.4

5.4 Skills 管理：社区技能一键安装

CC Switch 还支持 Skills 扩展管理。从 GitHub 上发现好的 Skills，可以一键安装并启用：

1# 搜索可用的 Skills
2cc-switch skills discover "testing"
3
4# 安装
5cc-switch skills install superpower-tdd
6
7# 启用 Skills
8cc-switch skills enable superpower-tdd --app claude
9
10# 同步到应用目录
11cc-switch skills sync
12

这比之前手动 clone 仓库、复制到正确目录方便多了。

5.5

5.5 配置备份与 WebDAV 同步

CC Switch 会在 ~/.cc-switch/backups/ 目录自动备份配置，保留最近 10 个版本。

1# 创建备份
2cc-switch config backup --name "换供应商前"
3
4# 恢复备份
5cc-switch config restore
6
7# 配置 WebDAV 同步（支持坚果云等）
8cc-switch config webdav set \
9  --base-url https://dav.example.com \
10  --username user \
11  --password pass \
12  --enable
13

有了 WebDAV 同步，我在公司配置的供应商信息，回家打开电脑就自动同步过来了。

5.6

5.6 环境检查

1# 检查本地安装了哪些 AI CLI 工具
2cc-switch env tools
3
4# 检查环境变量冲突
5cc-switch env check
6

这个功能帮我发现过好几次 ANTHROPIC_API_KEY 环境变量冲突的问题。有些工具在环境变量里设置了 API Key，导致配置文件里的设置被忽略。

六、实际使用体验

6.1

6.1 优点

用了一个星期，说说我的感受：

大幅减少重复操作：以前换供应商要 14 分钟，现在一个命令搞定。
配置集中管理：所有供应商信息存在一个 SQLite 数据库里，一目了然。
自动化程度高：备份、恢复、同步都可以脚本化。
交互 TUI 很友好：不记得命令？直接输入 cc-switch，菜单导航。
支持多语言：可以切换中英文界面。

6.2

6.2 缺点

它也不是没有缺点：

学习曲线：刚接触时要理解 --app 参数的作用。
文档部分内容过时：GitHub 上的 README 更新了，但部分第三方文档没跟上。
没有 GUI：习惯桌面应用的同学可能觉得不方便，但我喜欢 CLI。

图 4：一个中心入口统一管理五个 AI 编程助手。

七、现在的日常

用了 CC Switch 之后，我的工作流变成了这样。

7.1

7.1 早上到公司

1# 检查今天要用哪个供应商
2cc-switch provider list
3

7.2

7.2 切换供应商

1# 一键切换
2cc-switch provider switch rightcode
3
4# 验证是否成功
5cc-switch --app claude provider current
6cc-switch --app codex provider current
7

7.3

7.3 备份配置

1# 自动备份
2cc-switch config backup
3

整个过程不超过 1 分钟，而且不会改错文件。

图 5：微信版重画的 TUI 示意图。重点是菜单和状态，不堆小字。

八、总结：配置管理是门学问

用 AI 编程助手越多，越觉得配置管理是门学问。

工具多了，每个工具的配置文件格式都不一样。这是历史包袱，也是现实。但现实归现实，我们不能被它牵着鼻子走。

CC Switch CLI 解决的问题很明确：让你不用再记每个工具的配置文件长什么样，一套命令走天下。

它不完美，但它是目前我找到的最接近“统一管理”这个目标的工具。如果你也在同时用多个 AI 编程助手，不妨试试。

毕竟，我们花钱买的是 AI 的能力，不是花时间填表的快乐。

作者：魔都水滴