CC-Switch 配置
桌面版用户请直接阅读 桌面版配置，那里已经包含 CC-Switch 安装和截图步骤。本页面向已安装客户端与 CC-Switch 的用户，集中说明 CLI 和通用配置。
控制台目前仅支持导出 Claude、Codex、Gemini 配置，可按从控制台导入操作。Grok Build 等其他应用按下面步骤手动添加。
开始前
- 在 API 密钥管理 (opens in a new tab) 创建目标分组的 API 令牌
- 从 模型广场 复制完整模型 ID
- 安装目标客户端和 CC-Switch (opens in a new tab)
- 完全退出目标客户端，再打开 CC-Switch
一、选择应用
在 CC-Switch 顶部选择要配置的应用，再点击 添加供应商。
| 使用工具 | CC-Switch 入口 | Base URL |
|---|---|---|
| Claude Code CLI | Claude Code | https://api.9e.lv |
| Codex CLI | Codex / GPT | https://api.9e.lv/v1 |
| Gemini CLI | Gemini | https://api.9e.lv |
| Grok Build | Grok Build | https://api.9e.lv/v1 |
Claude Desktop（Code）请按 桌面版配置 操作。Codex 和 Grok Build 的地址需要 /v1；Claude Code 和 Gemini 不加 /v1。
二、添加供应商
在预设列表中选择 自定义配置，然后填写：
| 字段 | 填写内容 |
|---|---|
| 供应商名称 | 例如 玖亿 API Codex、玖亿 API Claude |
| 官网链接 | https://api.9e.lv |
| API Key | API 密钥管理 (opens in a new tab) 中对应分组的完整令牌 |
| API 请求地址 | 按上表填写；不要追加 /chat/completions 或 /responses |
| 模型 | 从模型广场复制当前令牌可用的完整模型 ID |
如果界面有“获取模型列表”按钮，点击后从列表选择模型。获取失败时，先检查 API Key、分组和请求地址。
⚠️
普通直连场景保持 CC-Switch 的本地代理 / 路由关闭。只有明确需要协议转换、用量统计或故障转移时才开启，并使用软件自动生成的本地路由。
三、启用并重启
- 点击 添加 保存供应商
- 回到供应商列表，找到刚添加的玖亿 API 配置并点击 启用
- 完全退出目标客户端，包括托盘、菜单栏或后台进程
- 重新打开客户端
“已启用”只代表配置已写入；客户端重启后才会读取新配置。
四、验证
在实际客户端中发起一次普通请求，再查看玖亿 API 使用日志 (opens in a new tab)。客户端收到回复且日志出现对应记录，才表示配置成功。
出现问题
- 401 / 403：检查 API Key 是否完整、有效、未过期，并确认令牌分组与模型匹配。
- 模型不存在：从模型广场重新复制完整模型 ID，不要使用简称。
- 连接失败：核对 Base URL 是否需要
/v1，并确认没有旧环境变量或系统代理覆盖配置。 - 配置没有生效：重新点击启用，彻底退出客户端后再打开。
- Grok Build 没有入口：更新 CC-Switch 后仍没有入口时，使用 Grok Build 手动配置。