CC-Switch 配置管理

特别说明： AI 工具迭代速度极快。遇到报错时，建议先将 CC-Switch、Claude Code、Codex CLI 等工具更新到最新版本，新版通常已修复已知问题，也能避免旧版本特有的奇怪报错。

CC-Switch 是一个开源桌面应用，支持图形化管理 Claude Code、Codex 等工具的 API 配置，支持多渠道一键切换。

项目地址： https://github.com/farion1231/cc-switch

下载与安装

| 平台 | 安装方式 | |------|---------| | Windows | 下载 .exe 安装包，双击运行 | | macOS | brew install --cask cc-switch 或下载 .dmg | | Linux | 下载 .AppImage（通用免安装）、.deb（Ubuntu/Debian）、.rpm（CentOS/RHEL/Fedora） |

配置 RovoAPI 渠道

Claude Code 为例

1. 打开 CC-Switch，顶部切换至 Claude 图标
2. 点击 "添加供应商"（+） → 自定义渠道
3. 填写以下三项：
   • 供应商名称： RovoAPI
   • API Key： sk-rovo-你的Key
   • 请求地址： https://api.rovoapi.com
4. 点击 添加/保存

Claude Code 的 Base URL 不需要 /v1 后缀。

Codex 为例

同上，Base URL 不需要 /v1 后缀：

• 请求地址： https://api.rovoapi.com

附加设置（建议开启）

• 应用到 Claude Code 插件 — 让 VSCode/JetBrains 等 IDE 内的 Claude Code 插件自动读取当前渠道
• 跳过 Claude Code 初次安装确认 — 第一次启动 claude 时不再弹出登录/授权确认
• 切换第三方时保留官方登录 — 使用中转 API 时仍可使用 Codex 应用的官方插件、手机远程操作等功能
• 统一 Codex 会话历史 — 中转与官方会话出现在同一历史列表中

切换/管理渠道

在主界面点击任意渠道即可切换为当前生效渠道，无需重启 Claude Code（下次启动 claude 命令时即生效）。支持编辑/删除/排序。

Base URL 速查

| 工具 | Base URL 格式 | |------|--------------| | Claude Code | https://api.rovoapi.com（不带 /v1） | | Codex | https://api.rovoapi.com（不带 /v1） |