主题
CC-Switch 多 Provider 切换工具
CC-Switch 是一个 桌面 GUI 工具，专门解决"多个 AI 编程 CLI（Claude Code / Codex / Gemini CLI / OpenCode 等）+ 多家 provider 来回切换" 的痛点。它本身不是 CLI，而是托盘 App，背后改写各 CLI 的本地配置文件实现切换。
你需要 CC-Switch 当且仅当
- 你已经装了至少一个 AI 编程 CLI（Claude Code / Codex / Gemini CLI / OpenCode）
- 你需要在 why01 + 官方账号 或 多个中转商 之间频繁切换
- 你不想每次切换都手动改
~/.zshrc/config.toml/opencode.json
如果你只用一个 provider，完全不需要装 CC-Switch，直接走 一键配置脚本 即可。
安装
CC-Switch 提供 Windows / macOS / Linux 三平台的安装包。
text
GitHub Releases 下载 .msi 安装包：
https://github.com/farion1231/cc-switch/releases/latest
双击 .msi 安装即可。bash
brew install --cask cc-switchtext
GitHub Releases 下载 .dmg：
https://github.com/farion1231/cc-switch/releases/latest
拖入 Applications 即可。bash
# 从 Releases 下载 .deb
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch.deb
sudo dpkg -i cc-switch.debCC-Switch 主界面
装完启动后看到的主界面长这样：
首次启动可能会弹「初始化设置」，按下图选项跳过 / 默认即可：
如果弹「跳过初次安装确认」对话框，确认即可：
添加 why01 为一个 Provider
启动 CC-Switch 后：
- 选你要管的 CLI tab（Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw 任一）
- 点 Add Provider 按钮 → 选 Custom 或填表
- 字段填：
| 字段 | 值 |
|---|---|
| Name | why01（自取，便于识别） |
| Base URL | https://s1.why01.top（Claude Code）或 https://s1.why01.top/v1（OpenAI/Codex/OpenCode） |
| API Key | 你的 sk-xxxxxxxx（控制台「令牌管理」复制） |
不同 CLI 的 Base URL 末尾是否带 /v1
- Claude Code：
https://s1.why01.top（不带 /v1） - Codex / OpenCode：
https://s1.why01.top/v1 - Gemini CLI：
https://s1.why01.top（不带 /v1）
填错会报 404 / 401，按实际 CLI 调试时纠正。
- 保存
各 CLI 添加截图参考
下面按 CLI 走一遍添加流程截图，按你实际要管的工具对应着看。
Claude Code
切到 Claude Code 标签页 → Add Provider：
填表界面（Name / Base URL / Key）：
填好提交后，配置详情显示：
Codex
切到 Codex 标签页：
点 Add Provider（Codex 的填表 UI 与 Claude 略有不同）：
填表：
提交后配置详情：
Gemini CLI
切到 Gemini 标签页：
填表：
提交后配置详情：
切换 Provider
主界面看到刚加的 why01 条目 → 点 Enable → CC-Switch 会自动改写对应 CLI 的本地配置文件（如 ~/.claude/settings.json、~/.codex/config.toml），下次启动 CLI 即走 why01。
切回官方账号同理：在主界面把 official 的那个 provider 设成 Enable。
验证切换生效
切到 why01 后启动 CLI（claude / codex / opencode），跑一个任务后到 why01 控制台 → 日志 看有没有对应模型调用——有 = 切换成功。
常见问题
切换后 CLI 仍走原 provider
CC-Switch 改的是配置文件，已经在跑的 CLI 进程读的还是切换前的。退出 CLI 重启即生效。
CC-Switch 找不到我装的 CLI
CC-Switch 按默认路径找各 CLI 的配置：
- Claude Code：
~/.claude/ - Codex：
~/.codex/ - Gemini CLI：
~/.config/gemini/ - OpenCode：
~/.config/opencode/
如果你装在非默认路径，CC-Switch 检测不到。要么把 CLI 重装到默认位置，要么通过 CC-Switch 的高级配置指定路径（看仓库 README 最新版）。
我能不装 CC-Switch 自己手切吗
完全可以。每个 CLI 都有自己的环境变量 / 配置文件，参见各页：
CC-Switch 的价值是把这些操作 GUI 化，不是带来不可替代的能力。
这个项目是官方的吗
不是。CC-Switch 是社区开源项目（farion1231/cc-switch），与 Anthropic / OpenAI / Google 官方无关，也与 why01 无关。装与不装、用与不用都是你自己决定。
下一步
- 单一 provider 不需要切换，看 一键配置脚本 即可
- 想看横向 CLI 选型 → Claude Code · Codex · Gemini CLI · OpenCode
- CC-Switch 仓库 → https://github.com/farion1231/cc-switch