乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > 当五个AI编程助手同时需要换供应商:我是如何从配置地狱爬出来的

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

当前时间： 2026-08-16 18:10:35 分类：办公文件 评论(0)
当五个AI编程助手同时需要换供应商:我是如何从配置地狱爬出来的

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

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

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

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

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

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

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

1

   

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

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 供应商，我都得：

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

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

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

配置地狱对比图

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

2

   

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

给你们算个时间账。假设我要把所有工具从“代理商 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 分钟。 而且这还是顺利的情况。如果手滑改错了字段，排查又要额外花时间。

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

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

3

   

三、转折点：发现 CC Switch CLI

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

  1. farion1231/cc-switch：原始的桌面 GUI 版本，用 Rust + Tauri 写的。
  2. 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 界面。

4

   

四、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

   

五、核心功能详解

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 帮你搞定一切。

Provider 切换流程图

图 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

   

六、实际使用体验

6.1

   

6.1 优点

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

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

6.2

   

6.2 缺点

它也不是没有缺点：

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

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

7

   

七、现在的日常

用了 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 分钟，而且不会改错文件。

TUI 界面示意图

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

8

   

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

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

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

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

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

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

作者：魔都水滴