CC Switch 配置

如果你只想最快用上 4Router，推荐使用 一键配置。 CC Switch 适合需要在多个供应商之间切换、或者希望集中管理 Claude Code 与 Codex 配置的用户。

CC Switch 是一个开源的 Claude Code / Codex / Gemini CLI 等工具的统一配置管理器。它把不同工具的 API Key、Base URL、模型等配置抽出来集中维护，可以在不同供应商之间一键切换，不再需要手动改 ~/.claude/settings.json 或 ~/.codex/config.toml。

CC Switch 自带 50+ 供应商预设，目前未内置 4Router，所以本文统一走"自定义配置"路径。

1. 安装 CC Switch

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

• Windows：到 GitHub Releases 下载安装版或便携版。

• macOS（推荐 Homebrew）：

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

• Linux：可在 Releases 中下载 AppImage / deb / rpm；或者装好 Linuxbrew 后执行：

  1brew tap farion1231/ccswitch
  2brew install cc-switch
  

安装完毕后启动 CC Switch。

2. 先从 4Router 拿 Key 和分组

1. 登录 https://4router.net，在控制台创建一个 API Key。
2. 确认你这个 Key 所在的模型分组，常用的有：
   • AppClaude：Claude Code 默认推荐（号池路由）
   • AppCodex：Codex 默认推荐（号池路由）
   • ClaudeMax / ClaudeApi / ClaudeAnti：Claude 的不同号池
   • GptPro：GPT 满血号池
   • Gemini：Gemini Ultra 号池
3. 记下你打算用的模型名，例如 claude-sonnet-4-6、claude-opus-4-7、gpt-5.5、gpt-5.3-codex 等。

3. 在 CC Switch 中添加 Claude Code 配置

1. 打开 CC Switch，左侧切换到 Claude Code 选项卡。

2. 点击右上角 + 按钮，弹出"添加供应商"面板。

3. 预设 选择 自定义（Custom）。

4. 按下表填写：

   字段	值
   名称	4Router（任意可识别名称）
   端点地址（ANTHROPIC_BASE_URL）	https://4router.net
   API Key（ANTHROPIC_AUTH_TOKEN）	你在 4Router 控制台创建的 Key
   模型	留空让客户端默认走，或填 claude-sonnet-4-6 / claude-opus-4-7 等

5. 点击 添加，回到主界面把这条配置切换为当前生效。

6. 重新打开终端或重启 Claude Code，让新环境变量生效。

配置写入后会反映为 ~/.claude/settings.json 中的 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN，与手动配置效果一致。

4. 在 CC Switch 中添加 Codex 配置

1. 在 CC Switch 中切换到 Codex 选项卡。

2. 点击右上角 +，预设 选 自定义。

3. 关键字段：

   字段	值
   名称	4Router
   Base URL	https://4router.net/v1
   API Key（OPENAI_API_KEY）	4Router 的 Key
   model	gpt-5.5 或 gpt-5.3-codex 等
   model_provider	4router（任意名称，写进 config.toml）
   wire_api	responses
   model_reasoning_effort	可选，low / medium / high

4. 点击 添加 → 在列表中将其设为当前生效。

5. 重启终端或 Codex CLI。

CC Switch 会同时写入 ~/.codex/auth.json（Key）和 ~/.codex/config.toml（其余字段），与手动配置 等价。

5. 分组与模型选择速查

完整分组说明见模型分组。

⚠️ 分组与模型要匹配：例如令牌只在 AppCodex 分组里，那 model 必须是 GPT 系列；若填 claude-* 会直接报 model_not_found。

6. 常见问题

• CC Switch 里没有"4Router"预设：当前确实没有，按上面的"自定义"流程填即可。
• 切换配置后客户端没生效：CC Switch 写入的是环境变量/配置文件，需重启终端或客户端。
• 401 / invalid_api_key：检查 Key 有没有多复制空格，或者 Key 已被禁用。
• model_not_found：模型名字段错了，或当前 Key 所在分组不支持该模型，回 模型分组 对一下。
• Claude 通但 GPT 报错（或反之）：通常是分组问题，4Router 的同一个 Key 不一定同时具备 AppClaude 和 AppCodex。

更底层的配置文件位置和参数说明，可以参考各客户端的手动配置页。