CC Switch 配置

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

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

BotCF 的令牌管理页已内置 CC Switch 一键导入。安装 CC Switch 后，在令牌列表点击 导入，选择应用和模型即可；下面的自定义配置用于手动补充或排查。

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. 先从 BotCF 拿 Key 和分组

1. 登录 https://botcf.com，在控制台创建一个 API Key。
2. 确认你这个 Key 所在的模型分组，常用的有：
   • 😡Claude-Max：Claude Code 默认推荐（号池路由）
   • ⚓codex-plus：Codex 默认推荐（号池路由）
   • 😡Claude-Max-外接：第三方客户端直连 Claude
   • ⚡️codex-fast / 😡codex-PRO：Codex 速度或性能优先
   • 🤡gemini-pro：Gemini 多模态模型
3. 记下你打算用的模型名，例如 claude-fable-5、claude-sonnet-5、gpt-5.6、gpt-5.3-codex-spark 等。

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

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

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

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

4. 按下表填写：

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

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

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

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

4. 在 CC Switch 中添加 Codex 配置

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

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

3. 关键字段：

   字段	值
   名称	BotCF
   Base URL	https://botcf.com/v1
   API Key（OPENAI_API_KEY）	BotCF 的 Key
   model	gpt-5.6 或 gpt-5.3-codex-spark 等
   model_provider	botcf（任意名称，写进 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. 分组与模型选择速查

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

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

6. 常见问题

• 如何一键导入：进入 BotCF 令牌管理，在对应令牌的 一键导入 CC Switch 列点击 导入。
• 切换配置后客户端没生效：CC Switch 写入的是环境变量/配置文件，需重启终端或客户端。
• 401 / invalid_api_key：检查 Key 有没有多复制空格，或者 Key 已被禁用。
• model_not_found：模型名字段错了，或当前 Key 所在分组不支持该模型，回 模型分组 对一下。
• Claude 通但 GPT 报错（或反之）：通常是分组问题，BotCF 的同一个 Key 不一定同时具备 😡Claude-Max 和 ⚓codex-plus。

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