CC Switch 图形化配置教程

通过 Homebrew 安装（推荐）：

brew install --cask cc-switch

或者到 GitHub Releases 页面下载 .dmg 安装包（同一个通用版本同时支持 Apple Silicon 与 Intel 的 Mac），把 CC Switch 拖进「应用程序」文件夹即可。应用已通过 Apple 签名和公证，可直接打开。

到 GitHub Releases 页面下载 CC-Switch-v{版本号}-Windows.msi 安装包（双击安装），或下载绿色版 CC-Switch-v{版本号}-Windows-Portable.zip（解压后运行 CC-Switch.exe）。ARM 版 Windows 请下载对应的 -arm64 版本。

Debian / Ubuntu — 到 GitHub Releases 页面下载 .deb 安装包，然后执行：

sudo dpkg -i CC-Switch-v*-Linux-*.deb
sudo apt-get install -f

Fedora 等 RPM 发行版 — 从同一页面下载 .rpm 安装包：

sudo dnf install ./CC-Switch-v*-Linux-*.rpm

其他发行版 — 使用通用 AppImage：

chmod +x CC-Switch-v*-Linux-*.AppImage
./CC-Switch-v*-Linux-*.AppImage

Arch Linux — 从 AUR 安装：

paru -S cc-switch-bin

选择「自定义配置」预设，把 JSON 改成 Claude Code 接网关时用的这两个变量：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.router.one",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-router-one-key"
  }
}

Key 填在 ANTHROPIC_AUTH_TOKEN 里。接 Router One 不需要设置 ANTHROPIC_API_KEY，设了反而会让 Claude Code 多弹一次授权确认，编辑器里如果带了它请删掉。base URL 结尾没有 /v1。

选择「自定义配置」预设，把 Router One 的 Key 填进编辑器的 auth.json 部分，再把 config.toml 部分指向 Router One 的原生 Responses 端点。预设写入的其他行保持不动：

model_provider = "custom"
model = "openai/gpt-5.6-sol"

[model_providers.custom]
name = "custom"
base_url = "https://api.router.one/v1"
wire_api = "responses"

切换时 CC Switch 实际写入的内容：Key 写进 ~/.codex/config.toml 里对应 [model_providers.<id>] 块的 experimental_bearer_token，预设还会写入 requires_openai_auth = true。它不会把 Key 写进 ~/.codex/auth.json；本地路由关闭时，切换到第三方供应商会删除整个 ~/.codex/auth.json（官方登录随之清除），除非在「设置 → 应用配置 → Codex 应用增强」里打开了「非接管切换时保留官方登录」。

模型请选详情页列出 POST /v1/responses 的：GPT 系列、DeepSeek V4 与 Grok 对话模型。Router One 自己的一键配置写的是 env_key（见 Codex Responses API 指南），两种方式选一种，不要叠加。 Codex Responses API 指南

这三款是共存模式工具：点击「添加」（Pi 是「启用」）会把 Router One 写进工具自己的配置，与你的其他供应商并存，再在工具里选择模型即可。base URL 和模型 ID 按各工具的 Router One 接入指南填写：

• OpenCode 接入指南
• OpenClaw 接入指南
• Pi 接入指南