跳至主要內容

使用 CC-Switch 配置

GoodCode2026/7/8大约 3 分钟

什么是 CC-Switch？

使用 CC-Switch，您可以：

  • ✅ 一键切换 API 配置 - 在多个 API 提供商之间快速切换
  • ✅ 可视化配置管理 - 通过图形界面轻松管理所有配置
  • ✅ MCP 服务器管理 - 管理 Model Context Protocol 服务器
  • ✅ 系统托盘快捷操作 - 通过托盘菜单快速切换
  • ✅ 本地代理 - 支持热切换 CC、CX、Gemini 的供应商
  • ✅ 故障转移 - 全自动渠道故障转移

GoodCode 支持一键导入

GoodCode 后台的密钥列表提供 导入到 CCS 按钮：安装好 CC-Switch 后，直接在后台点击该按钮，选择要导入的客户端类型（Claude Code / Codex / Gemini CLI），密钥和网关地址会自动写入 CC-Switch，无需手动填写！

软件下载

访问 CC-Switch Releases 下载最新版本并安装。

安装完成后建议先启动一次 CC-Switch，确保系统已经注册 ccswitch:// 这类唤起协议。后续在 GoodCode 后台点击 导入到 CCS 时，浏览器才能正常唤起本地应用。

方式一：后台一键导入（推荐）

后台路径：

GoodCode 后台 -> API 密钥 -> 选择密钥 -> 导入到 CCS -> 选择客户端类型 -> 确认导入

操作步骤：

  1. 在本地安装并运行过一次 CC-Switch
  2. 打开 GoodCode 后台 API 密钥 页面，找到你要使用的密钥
  3. 点击该密钥的 导入到 CCS 按钮
  4. 选择要导入的客户端类型，例如 Claude Code、Codex 或 Gemini CLI
  5. 浏览器弹出外部应用唤起提示时，选择允许打开 CC-Switch
  6. 在 CC-Switch 中确认导入，导入后切换到对应客户端查看当前供应商

相关信息

如果点击后没有反应，说明 CC-Switch 未安装或协议处理程序未注册，请先安装 CC-Switch 或改用下面的手动配置。

方式二：手动添加供应商

这一步以 Codex 的配置为例，Claude Code 与 Gemini CLI 配置同理。

操作路径：

打开 CC-Switch -> 选择客户端 -> 添加供应商 -> 填写请求地址和 API Key -> 保存 -> 切换到该供应商
  1. 打开 CC-Switch，在主界面选择要配置的 CLI
  2. 点击 添加供应商
  3. 请求地址 按下表填写
  4. API Key 填写你在 GoodCode 后台生成的密钥
  5. 确认 Key 分组和客户端类型匹配后保存
  6. 返回主界面，切换到刚添加的供应商
客户端请求地址
Claude Codehttps://goodcode.store
Codexhttps://goodcode.store/v1
Gemini CLIhttps://goodcode.store
Claude Code（Antigravity 分组）https://goodcode.store/antigravity

注意

请求地址不要混用：Codex 需要带 /v1，Claude Code 和 Gemini CLI 使用根地址，Antigravity Claude 使用 /antigravity。

通用设置

建议在 CC-Switch 的通用设置中开启：

设置 -> 跳过 Claude Code 初次安装确认 -> 开启

这项可以减少首次启动 Claude Code 时的确认提示。

验证配置

根据你配置的客户端，在终端运行对应命令：

claude
codex
gemini

发送一句简单消息测试。如果能正常返回内容，说明 CC-Switch 当前供应商已经接入 GoodCode。若仍走旧供应商，回到 CC-Switch 主界面确认当前启用的渠道是否为刚配置的 GoodCode。

最近更新: