使用 CC Switch 管理 AI 编程工具

概述#

CC Switch 是用于管理 Claude Code、Codex CLI 和 Gemini CLI 提供商配置的桌面工具。它适合同时使用多个 AI 编程工具、需要快速切换模型或不想手工维护配置文件的用户。

APIMAX 控制台已经提供 CC Switch 导入入口，推荐优先使用一键导入。

安装#

从 CC Switch GitHub Releases 下载与操作系统匹配的安装包。安装后至少启动一次，确保系统已经注册 ccswitch:// 协议。

方法一：从 APIMAX 控制台一键导入#

1. 登录 APIMAX 控制台。
2. 进入 API Keys。
3. 找到准备使用的 Key，打开该行操作菜单。
4. 选择 CC Switch。
5. 选择应用：Claude、Codex 或 Gemini。
6. 输入配置名称，并选择主模型；Claude 还可以分别指定 Haiku、Sonnet 和 Opus 模型。
7. 点击 打开 CC Switch，在系统弹窗中允许打开应用。
8. 在 CC Switch 中确认并添加配置，然后启用该提供商。

一键导入会自动带入当前站点地址、API Key 和所选模型。Codex 配置会自动使用带 /v1 的端点，Claude 和 Gemini 使用站点根地址。

导入链接中包含 API Key。只在自己的设备上操作，不要复制或转发导入链接。

方法二：手工添加#

无法唤起桌面应用时，可以在 CC Switch 中手工新建提供商。

Claude Code#

Codex CLI#

Gemini CLI#

模型名称应从 APIMAX 控制台的可用模型中选择，不要照搬其他平台文档中的模型 ID。

切换与验证#

1. 在 CC Switch 首页启用刚添加的提供商。
2. 完全退出已运行的 Claude Code、Codex 或 Gemini CLI。
3. 重新打开终端并进入测试项目目录。
4. 启动对应工具，发送一个简单问题。
5. 返回 APIMAX 控制台的用量日志，确认出现对应请求。

常见问题#

点击“打开 CC Switch”没有反应#

• 确认 CC Switch 已安装并至少启动过一次。
• 浏览器可能阻止外部协议，允许打开 ccswitch:// 链接。
• 仍失败时使用本文的手工添加方式。

导入后工具仍使用旧配置#

• 在 CC Switch 中确认新提供商处于启用状态。
• 退出并重新启动目标 CLI，旧进程不会自动重载环境变量。
• 检查是否有 shell 环境变量覆盖了 CC Switch 配置。

Codex 返回接口不支持#

• Codex Endpoint 必须包含 /v1。
• 选择支持 Responses API 的模型。
• 不要把 Claude 模型配置直接复制到 Codex 提供商。

401 / 403#

• 重新从控制台导入，避免复制 Key 时遗漏字符。
• 检查 Key 状态、模型权限和账户余额。

安全建议#

• 不要在公共电脑导入包含 Key 的配置。
• 不要把 CC Switch 的配置同步到不受信任的云盘或公开仓库。
• 按工具拆分 Key，可以独立查看用量并快速撤销。