CC-Switch 配置工具

CC-Switch 是一个图形化配置工具，适合同时管理 Claude Code、CodeX、Gemini CLI 等多个 CLI 提供商。它最大的价值不是“更炫”，而是能把原本散落在各个配置文件里的内容统一起来管理。

适合谁用

• 经常切换多个模型或多个 Key 的开发者
• 不想手动改 settings.json、config.toml、.env 的用户
• 需要给团队成员交付可视化配置方案的场景

它能做什么

• 统一管理多套提供商配置
• 切换 Claude / Codex / Gemini 对应的 Base URL 和 Key
• 备份与恢复历史配置
• 测试 API 端点速度
• 管理 MCP 服务器与系统提示词
• 用系统托盘快速切换当前启用的渠道

安装方式

Windows

推荐直接从发布页下载安装包：

• Releases：https://github.com/farion1231/cc-switch/releases

macOS

如果项目提供 Homebrew 安装，可直接用：

brew tap farion1231/ccswitch
brew install --cask cc-switch

Linux

常见发布形式有：

• .deb
• AppImage
• AUR 包

用 Token中转站配置的基本流程

1. 启动 CC-Switch
2. 选择对应工具标签页（Claude / Codex / Gemini）
3. 添加新的 Provider
4. 填写：
   • Provider 名称
   • Base URL
   • API Key
   • 模型名
5. 保存并设为当前使用配置
6. 重启对应 CLI

常用填写方式

Claude Code

• Base URL：https://rtai.jnrongtu.com
• Key：Claude 专用令牌

CodeX

• Base URL：https://rtai.jnrongtu.com/v1
• Key：CodeX 专用令牌

Gemini CLI

• Base URL：https://rtai.jnrongtu.com
• Key：Gemini 专用令牌

注意

如果控制台对不同工具展示了不同网关地址，请优先使用控制台给出的地址。本文档用的是统一演示写法。

推荐管理习惯

• 每个工具单独一套配置
• 每套配置名称带上用途，例如 claude-dev、codex-ci
• 切换后重启工具，不要指望运行中的旧进程自动刷新
• 重要配置改动前先做一次备份

常见问题

切换后不生效

通常是因为目标 CLI 还在用旧进程或旧缓存。直接关闭工具再重新打开最稳。

填了 Base URL 还是连不到

先检查：

• Key 是否正确
• 令牌组是否匹配
• 本地网络是否正常
• 控制台是否有公告或变更说明

适合团队统一交付吗

适合。尤其是同一批人要分别使用 Claude、Codex、Gemini 时，CC-Switch 能明显减少手工维护成本。

下一步

• Claude Code 部署
• CodeX 部署
• Gemini CLI 部署