文档 / 开发工具
开发工具CC SwitchClaude CodeCodexGeminiDeveloper Tools
使用 CC Switch 管理 AI 编程工具
通过控制台一键导入或手工配置 CC Switch，集中管理 Claude、Codex 和 Gemini 编程工具。
概述#
CC Switch 是用于管理 Claude Code、Codex CLI 和 Gemini CLI 提供商配置的桌面工具。它适合同时使用多个 AI 编程工具、需要快速切换模型或不想手工维护配置文件的用户。
APIMAX 控制台已经提供 CC Switch 导入入口，推荐优先使用一键导入。
安装#
从 CC Switch GitHub Releases 下载与操作系统匹配的安装包。安装后至少启动一次，确保系统已经注册 ccswitch:// 协议。
方法一：从 APIMAX 控制台一键导入#
- 登录 APIMAX 控制台。
- 进入 API Keys。
- 找到准备使用的 Key，打开该行操作菜单。
- 选择 CC Switch。
- 选择应用：
Claude、Codex或Gemini。 - 输入配置名称，并选择主模型；Claude 还可以分别指定 Haiku、Sonnet 和 Opus 模型。
- 点击 打开 CC Switch，在系统弹窗中允许打开应用。
- 在 CC Switch 中确认并添加配置，然后启用该提供商。
一键导入会自动带入当前站点地址、API Key 和所选模型。Codex 配置会自动使用带 /v1 的端点，Claude 和 Gemini 使用站点根地址。
导入链接中包含 API Key。只在自己的设备上操作，不要复制或转发导入链接。
方法二：手工添加#
无法唤起桌面应用时，可以在 CC Switch 中手工新建提供商。
Claude Code#
| 配置项 | 值 |
|---|---|
| 应用 | Claude |
| Endpoint | https://api.apimax.ai |
| API Key | 控制台生成的 Key |
| Model | 账号可用的 Claude 模型名称 |
Codex CLI#
| 配置项 | 值 |
|---|---|
| 应用 | Codex |
| Endpoint | https://api.apimax.ai/v1 |
| API Key | 控制台生成的 Key |
| Model | 账号可用且支持 Responses API 的模型 |
Gemini CLI#
| 配置项 | 值 |
|---|---|
| 应用 | Gemini |
| Endpoint | https://api.apimax.ai |
| API Key | 控制台生成的 Key |
| Model | 账号可用的 Gemini 模型名称 |
模型名称应从 APIMAX 控制台的可用模型中选择，不要照搬其他平台文档中的模型 ID。
切换与验证#
- 在 CC Switch 首页启用刚添加的提供商。
- 完全退出已运行的 Claude Code、Codex 或 Gemini CLI。
- 重新打开终端并进入测试项目目录。
- 启动对应工具，发送一个简单问题。
- 返回 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，可以独立查看用量并快速撤销。