跳到主要内容

CC Switch

CC Switch 是一款跨平台的 AI 编程工具配置管理器，可以在图形界面中管理 Claude Code、Codex、OpenCode、Hermes 等工具的服务商，并快速切换当前配置。

CC Switch 负责写入和切换配置，不会代替目标工具本身。开始前，请先安装需要使用的 Claude Code、Codex 或其他命令行工具。

准备工作​

请先准备：

  • 已安装的 CC Switch。
  • 一个处于启用状态、仍有可用额度的 Bita API 密钥。
  • 密钥所属分组可以使用的模型 ID。

如果尚未准备好，请阅读创建 API 密钥和选择模型。

选择配置方式​

CC Switch 可以为每个应用单独添加服务商，也支持把一个通用服务商同步到多个应用。由于 Claude Code 和 Codex 对 Base URL 及接口格式的要求不同，建议先使用 应用专属服务商：

目标工具Bita API 地址接口格式
Claude Codehttps://www.bita-api.comAnthropic Messages
Codexhttps://www.bita-api.com/v1OpenAI Responses

这样更容易判断每个工具最终请求的接口，也能分别选择适合 Claude Code 与 Codex 的模型。

配置 Claude Code​

  1. 在 CC Switch 顶部选择 Claude Code。

  2. 点击右上角的 +，打开添加服务商面板。

  3. 选择 应用专属服务商，然后选择 自定义（Custom）。

  4. 填写以下内容：

    配置项填写内容
    名称Bita API
    API 密钥完整的 Bita API 密钥
    Endpoint / Base URLhttps://www.bita-api.com
    API 格式Anthropic Messages
    模型从模型广场复制的 Claude 模型 ID

  5. 保存配置，然后在 Bita API 服务商卡片上点击 启用。

如果当前版本显示的是 JSON 编辑器，核心配置如下：

{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_BITA_API_KEY",
    "ANTHROPIC_BASE_URL": "https://www.bita-api.com",
    "ANTHROPIC_MODEL": "YOUR_CLAUDE_MODEL_ID"
  }
}

将 YOUR_BITA_API_KEY 和 YOUR_CLAUDE_MODEL_ID 替换为实际值。Base URL 不要附加 /v1/messages，Claude Code 会自行拼接接口路径。

模型映射

如果界面提供 Sonnet、Opus、Haiku 的模型映射，可以把每个角色映射到 Bita API 中实际可用的模型 ID。没有对应需求时，只设置主模型即可。

配置 Codex​

Bita API 提供 OpenAI Responses 兼容接口。使用支持 Responses 的 GPT 系列模型时，可以让 Codex 直接连接，无需开启 CC Switch 的本地协议转换。

  1. 在 CC Switch 顶部选择 Codex。

  2. 点击右上角的 +，选择 应用专属服务商和 自定义（Custom）。

  3. 填写以下内容：

    配置项填写内容
    名称Bita API
    API 密钥完整的 Bita API 密钥
    Endpoint / Base URLhttps://www.bita-api.com/v1
    Wire API / API 格式responses
    模型从模型广场复制的、支持 Responses 的 GPT 模型 ID
    需要本地路由关闭

  4. 保存配置并点击 启用。

  5. 完全退出当前 Codex 进程，再重新启动 Codex，使新配置和模型列表生效。

CC Switch 生成的 Codex 核心配置应与下面的结构一致：

model_provider = "bita-api"
model = "YOUR_CODEX_MODEL_ID"

[model_providers.bita-api]
name = "Bita API"
base_url = "https://www.bita-api.com/v1"
wire_api = "responses"
requires_openai_auth = true

API 密钥由 CC Switch 写入 Codex 的认证配置，不需要再在 TOML 中重复填写。

什么时候开启本地路由​

如果选用的模型只支持 OpenAI Chat Completions，或者 Codex 无法识别该模型 ID，可以在服务商的高级选项中：

  1. 打开 需要本地路由（Needs Local Routing）。
  2. 在模型映射中填写真实的 Bita API 模型 ID。
  3. 启动 CC Switch 本地代理，并为 Codex 开启接管。
  4. 保持 CC Switch 本地代理运行，再重新启动 Codex。

本地路由会把 Codex 的 Responses 请求转换成上游 Chat Completions 请求。对于已经支持 Responses 的 GPT 模型，不需要开启这一功能。

获取模型列表​

在添加或编辑服务商时，可以点击模型输入框旁的 获取模型（Fetch Models）。CC Switch 会通过 /v1/models 读取当前密钥可见的模型。

如果自动获取失败，可以手动填写模型 ID。请注意：

  • 模型 ID 必须与模型广场中的名称完全一致。
  • 返回的模型列表由 API 密钥分组决定。
  • Claude Code 应优先选择支持 Anthropic Messages 的 Claude 模型。
  • Codex 直接连接时应优先选择支持 OpenAI Responses 的 GPT 模型。

切换服务商​

在目标工具页面找到 Bita API 服务商卡片，点击 启用即可切换。也可以通过系统托盘菜单快速切换。

  • Claude Code 通常可以感知配置变化；如果仍使用旧配置，请退出后重新启动。
  • Codex 需要重新启动，才能重新读取服务商和模型配置。
  • 终端中已经运行的进程不会因为切换卡片而自动重启。

常见问题​

现象建议检查
返回 401API 密钥是否完整、是否已禁用或过期
返回 404Claude Code 应填写根地址；Codex Responses 应填写包含 /v1 的地址
获取模型失败密钥分组是否可用；也可以从模型广场复制模型 ID 后手动填写
Claude Code 请求 /v1/v1/messagesBase URL 多写了 /v1，改为 https://www.bita-api.com
Codex 启动后仍是旧服务商完全退出 Codex 和原终端会话，再重新启动
Codex 提示模型或协议不支持换用支持 Responses 的 GPT 模型，或开启本地路由并配置模型映射
配置正确但请求失败在 Bita API 使用日志中查看实际模型、接口和错误信息

CC Switch 的界面和预设会随版本更新，具体按钮名称以当前客户端为准。更多功能参见 CC Switch 官方项目和服务商管理说明。

下一步：Claude Code。