CC Switch 配置¶

CC Switch 是一款跨平台桌面应用，用可视化界面统一管理 Claude Code、Codex、Gemini CLI、Opencode、OpenClaw、Hermes 等工具的 API 供应商配置，免去手动编辑配置文件。 官方仓库：https://github.com/farion1231/cc-switch（中文用户手册：https://github.com/farion1231/cc-switch/tree/main/docs/user-manual/zh）

核心能力：多供应商一键切换；并可选装本地路由（请求日志 / 用量统计 / 故障转移）。本文先介绍默认模式下添加并切换 Rutaceae 供应商，再说明按需启用路由模式。

第一步：安装 CC Switch¶

从 Releases 页面 下载对应系统的安装包：

• Windows：CC-Switch-v{版本}-Windows.msi，或便携版 .zip
• macOS：brew install --cask cc-switch，或下载 .dmg
• Linux：.deb / .rpm / .AppImage
• Arch Linux：paru -S cc-switch-bin

第二步：获取 API 令牌¶

1. 访问 https://api.rutaceae.com/keys

2. 点击「添加令牌」

3. 选择包含目标模型的分组（可前往模型广场查看：https://api.rutaceae.com/pricing）

4. 令牌名称：随意填写（如 "CC Switch"）

5. 额度建议：设置为无限额度

6. 点击确认，复制生成的令牌

第三步：添加并切换 Rutaceae 供应商（默认模式）¶

1. 顶部切换到目标应用标签页。供应商分为应用专属供应商（Claude Code / Codex / Gemini 各自独立）与统一供应商（多应用共享）。

2. 点击右上角 + 添加。

3. 在「预设」下拉框中选择供应商（若无对应预设，选择自定义），填写以下字段：

   字段	填写内容
   名称	随意，如 Rutaceae
   端点	Claude Code 用 https://api.rutaceae.com；Codex 用 https://api.rutaceae.com/v1
   API Key	第一步复制的令牌 sk-xxxxxxxxxxxxxxxx
   备注	可选
   模型	从下拉选择，或点「获取模型」自动拉取

4. 点击「添加」。

5. 在供应商卡片上点击「启用」即可切换到该供应商。

这就是默认模式（不启用路由）：点击「启用」时，CC Switch 会把该供应商的端点与密钥直接写入对应工具的配置文件（如 Claude Code 的 ~/.claude/settings.json、Codex 的 ~/.codex/）。切换供应商后需要重启该 CLI 工具才会生效。只连 Rutaceae、或很少切换的用户，配到这里就完成了，可跳过后面的路由模式。

提示： 不同应用的端点格式不同——Claude Code 走 Anthropic 原生端点（根地址），Codex 走 OpenAI 格式端点（带 /v1）。与本站其它工具的配置一致。

是否需要路由模式？¶

路由模式是可选项。 它让请求先经过 CC Switch 的本地代理（默认 http://127.0.0.1:15721）再转发到供应商，从而支持免重启切换、请求日志、用量统计与故障转移。两种模式对比：

建议启用路由模式的场景：

• 需要频繁切换供应商，不想每次都重启 Claude Code / Codex
• 想要请求日志、用量与费用统计
• 想要多供应商故障转移 / 高可用（某供应商不可用时自动切到备用）
• 需要模型健康检测、延迟测速等高级能力

保持默认模式即可的场景：

• 只连 Rutaceae 一个供应商，或很少切换
• 追求零额外延迟、不想常驻本地服务
• 配好即用、省心为主

（可选）启用路由模式¶

若上面的对比表明你需要路由模式，按以下步骤启用；否则可跳过本节——默认模式已足够。

1. 启动路由服务¶

进入「设置 → 高级 → 代理服务」，打开开关启动服务（也可直接点击主界面顶部的代理开关）。

• 默认监听地址：127.0.0.1:15721，仅本机可访问
• 请求日志：默认开启
• 如需局域网访问，可将监听地址改为 0.0.0.0（修改地址/端口前需先停止服务，保存后再重启）

2. 为应用开启路由¶

进入「设置 → 高级 → 路由服务 → 应用路由」区域（不同版本文案可能略有差异）。确保路由服务已启动后，为需要的应用打开开关：

• Claude 路由：路由 Claude Code 的请求
• Codex 路由：路由 Codex 的请求
• Gemini 路由：路由 Gemini CLI 的请求

可同时开启多个。开启后 CC Switch 会自动修改对应工具的配置文件，把其 API 端点指向本地 http://127.0.0.1:15721。

3. 验证与即时切换¶

1. 正常启动 Claude Code / Codex / Gemini CLI 并发起对话，请求即经本地路由转发。

2. 在 CC Switch 中点击其它供应商的「启用」——立即生效，无需重启工具。

3. 在「用量」页面可查看请求日志与用量统计。

路由机制： 路由收到请求后依次执行——识别请求来源 → 查找该应用已启用的供应商 → 转发至供应商实际端点 → 记录日志 → 返回响应。

更完整的路由与故障转移说明见官方手册：https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/4-proxy/4.2-routing.md

常见问题¶