cc-switch — 切换 Claude Code 订阅与 API 配置的开源工具 ​

什么是 cc-switch？ ​

cc-switch 是一款免费、开源的桌面应用，用于统一管理 AI 编码工具配置。开发者无需手动编辑环境变量或 JSON 文件，就能在 Claude Code 的 Anthropic 订阅与开桥等 API 供应商之间切换。该应用支持 macOS、Windows 和 Linux。

为什么使用 cc-switch？ ​

• 订阅额度用完后继续工作：切换到按 API 用量计费的开桥配置，无需等待订阅额度重置。
• 管理多套供应商配置：将工作、个人和实验配置隔离保存，需要时再启用。
• 按任务选择不同模型：把 Claude Code 的模型档位映射到开桥上兼容的模型。
• 统一管理多个编码工具：用相同的可视化流程管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes Agent。

cc-switch 如何工作？ ​

在标准供应商切换模式下，cc-switch 会把配置保存在本地 SQLite 数据库，并将当前启用的配置写入编码工具的实时配置文件。Claude Code 目前支持无需重启即可切换供应商数据；多数其他 CLI 工具需要新开终端或重新启动应用，才能读取更新后的配置。

cc-switch 还提供可选的 Proxy & Failover 模式。启用后，本地代理可以提供热切换、协议转换、健康检查和故障转移；未启用代理模式时，请求会由编码工具直接发送到所配置的供应商端点。

快速开始：安装并配置 cc-switch ​

macOS ​

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

1. 前往 CC-Switch Release 页面下载最新的 macOS DMG（推荐）或 ZIP 包：
   https://github.com/farion1231/cc-switch/releases

2. 打开安装包并将 CC-Switch.app 移入 Applications 文件夹

Windows ​

1. 前往 CC-Switch Release 页面下载最新的 .msi 安装包：
   https://github.com/farion1231/cc-switch/releases

2. 双击 .msi 文件，按提示完成安装

1. 前往 CC-Switch Release 页面下载最新的 .zip 便携版：
   https://github.com/farion1231/cc-switch/releases

2. 解压到任意目录，双击 CC-Switch.exe 运行

Linux ​

# 从 Release 页面下载 .deb 包后执行
sudo dpkg -i cc-switch_*.deb

1. 从 Release 页面下载 .AppImage 文件
2. 添加可执行权限：chmod +x CC-Switch_*.AppImage
3. 双击运行或在终端执行：./CC-Switch_*.AppImage

获取开桥 API Key ​

在配置 CC-Switch 之前，你需要先获取开桥 API Key。开桥提供两种计费方案，请根据使用场景选择：

✅ 适用场景：个人开发、学习探索、Vibe Coding
✅ 特点：固定月费、可预测成本、5-10倍价格杠杆
✅ API Key 格式：sk-ss-v1-xxx

获取方式：
1. 访问订阅管理页面：https://openqiao.com/platform/subscription
2. 选择适合的套餐（Starter $20/月、Max $100/月、Ultra $200/月）
3. 完成订阅后，在页面中创建订阅制 API Key

详细说明请参考：订阅制套餐指南
📚 https://docs.openqiao.com/zh/guide/subscription

✅ 适用场景：生产环境、商业化产品、企业级应用
✅ 特点：无 Rate Limit、生产级稳定、按实际消耗计费
✅ API Key 格式：sk-ai-v1-xxx

获取方式：
1. 访问按量付费页面：https://openqiao.com/platform/pay-as-you-go
2. 充值账户
3. 在 "Pay As You Go API Keys" 区域创建 API Key

详细说明请参考：按量付费指南
📚 https://docs.openqiao.com/zh/guide/pay-as-you-go

支持的工具与供应商 ​

cc-switch 支持 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes Agent，内置 50 多个供应商预设，同时支持自定义端点。只要工具接受 Anthropic、OpenAI 兼容或 Vertex AI 协议，就可以配置对应的开桥端点。

供应商配置决定每个工具使用的端点、API 凭证和模型映射。Universal Provider 可以在 Claude Code、Codex 和 Gemini CLI 之间共享兼容设置，各工具的专属字段仍独立保存。

通过开桥切换 Claude Code 订阅与 API ​

这是最常见的 cc-switch 使用方式：平时保留 Anthropic 官方订阅配置，需要按 API 用量计费或使用其他兼容模型时，再启用开桥 API 配置。

1. 按上面的方式创建开桥 API Key。
2. 在 cc-switch 中选择 Claude Code，点击添加供应商，新建名为 开桥 的配置。
3. 将 Base URL 设置为 https://openqiao.com/api/anthropic，并填写开桥 API Key。
4. 从 开桥模型目录中选择当前支持 Anthropic API 的模型，映射到 Haiku、Sonnet 和 Opus 档位。
5. 保存并点击启用。需要切回订阅时，启用 Anthropic 官方配置，并按提示完成登录。

Claude Code 支持供应商数据热切换。如果已有会话仍使用旧凭证，请先新开一个 Claude Code 会话，再排查供应商配置。

配置开桥供应商 ​

步骤 1：打开供应商管理 ​

启动 CC-Switch 后，在头部导航栏中选择你要配置的编码工具（如 Claude Code），进入供应商管理页面。

步骤 2：添加开桥供应商 ​

点击添加供应商按钮，填写以下配置信息：

Claude Code 配置（Anthropic 协议） ​

配置模型映射（Model Mapping），将 Claude Code 的三个速度档位映射到开桥上的模型：

配置JSON示例（可直接复制） ​

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<OPENQIAO_API_KEY>",
    "ANTHROPIC_BASE_URL": "https://openqiao.com/api/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-4.8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4.6",
    "ANTHROPIC_MODEL": "anthropic/claude-opus-4.8",
    "API_TIMEOUT_MS": "30000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

将上述代码复制粘贴到 Claude Code 的配置文件中，保存后即可完成配置。

Codex ​

配置config.toml示例（可直接复制） ​

model_provider = "openqiao"
model = "openai/gpt-5.2-codex"

[model_providers.openqiao]
name = "开桥"
base_url = "https://openqiao.com/api/v1"
wire_api = "responses"

将上述代码复制粘贴到 Codex 的配置文件中，保存后即可完成配置。

Gemini CLI 配置（Vertex AI 协议） ​

配置环境变量示例（可直接复制） ​

GOOGLE_GEMINI_BASE_URL=https://openqiao.com/api/vertex-ai
GEMINI_API_KEY=<OPENQIAO_API_KEY>
GEMINI_MODEL=google/gemini-3-flash-preview

将上述代码复制粘贴到 Gemini CLI 的配置文件中，保存后即可完成配置。

OpenCode 配置（OpenAI 协议） ​

配置JSON示例（可直接复制） ​

{
  "models": {
    "openai/gpt-5.2": {
      "name": "gpt-5.2 (via 开桥)"
    }
  },
  "npm": "@ai-sdk/openai-compatible",
  "options": {
    "apiKey": "<OPENQIAO_API_KEY>",
    "baseURL": "https://openqiao.com/api/v1"
  }
}

将上述代码复制粘贴到 OpenCode 的配置文件中，保存后即可完成配置。

步骤 3：切换到开桥供应商 ​

添加完成后，在供应商列表中点击 开桥 条目旁的切换按钮，即可将当前编码工具的请求切换到开桥。

步骤 4：跨应用共享配置（可选） ​

如果你同时使用多个编码工具，CC-Switch 支持将同一个供应商配置同步到所有管理的应用。这对于像开桥这样支持多协议的 API 网关尤为方便：

1. 在供应商配置中启用 跨应用共享（Universal Provider）
2. 为每个应用分别设置默认模型映射
3. 保存后，该供应商会自动同步到 Claude Code、Codex、Gemini CLI 和 OpenCode

支持的模型 ​

常见故障排除 ​

常见问题 ​

cc-switch 是什么，可以做什么？ ​

cc-switch 是一款免费、开源的桌面应用，用于管理 Claude Code 等 AI 编码工具的配置。它可以在 Anthropic 订阅配置和开桥等 API 供应商之间切换，无需手动编辑配置文件。

cc-switch 可以免费使用吗？ ​

可以。cc-switch 采用 MIT 许可证，可免费安装和使用。Anthropic、开桥或其他供应商的订阅费和 API 用量费用需要另外支付。

cc-switch 只支持 macOS，还是也支持 Windows 和 Linux？ ​

cc-switch 支持 macOS、Windows 和 Linux。安装包可从官方 GitHub Releases 页面下载，macOS 还支持通过 Homebrew 安装。

Claude Code 订阅和 API 配置可以同时使用吗？ ​

可以在 cc-switch 中同时保存两种配置并随时切换，但一套 Claude Code 配置在同一时间只会启用一个供应商。需要切回订阅时，请启用 Anthropic 官方配置，并在需要时完成登录。

Claude Code 订阅额度用完后，cc-switch 有什么帮助？ ​

启用开桥 API 配置后，可以改用按 API 用量计费的方式继续工作，无需等待订阅额度重置。请从开桥当前模型目录中选择支持 Anthropic Messages 协议的模型；可用性和价格取决于所选模型及计费方式。

cc-switch 会代理或记录我的 API 请求吗？ ​

标准供应商切换只会把所选配置写入编码工具，工具将直接连接该供应商端点。只有主动启用 cc-switch 的本地 Proxy & Failover 模式时，代理才会进入请求链路，并可提供请求和用量统计。启用前请检查 cc-switch 的代理设置。

相关资源 ​

• 如何获取 Anthropic API Key
• Claude Code 接入开桥最佳实践
• 通过开桥使用 Claude Agent SDK
• 开桥上的 Claude Opus 4.8 API
• 浏览开桥上的 Anthropic 模型
• 从 OpenRouter 切换到开桥