主题
CC Switch
CC Switch 是用于管理 Claude Code、Codex CLI 等工具配置的桌面客户端。通过它可以在本机图形化切换 API 地址、API Key 与模型，不必反复手动修改配置文件。
使用前确认
Claude Code 与 Codex CLI 的接口协议不同。请分别添加对应的 Provider，不要把 Claude Code 的配置直接复制到 Codex CLI。
使用前准备
- 登录 AruHub 控制台，创建并保存 API Key。
- 在 AruHub 模型列表确认需要调用的模型名称。
- 从 CC Switch 官方 GitHub Releases 下载并安装客户端。
从“我的密钥”一键导入（推荐）
- 安装并打开 CC Switch，再进入 AruHub 我的密钥。
- 找到一把启用中的密钥，点击右侧操作区的 快捷接入 按钮。
- 在面板中选择 CC Switch，再选择 Claude Code 或 Codex，并选好当前密钥可用的模型。
- 点击 导入到 CC Switch；浏览器提示打开客户端时，选择打开 CC Switch。
- 在 CC Switch 中核对并确认导入的 Provider，点击 启用，再重新打开对应工具、开始新会话。
导入会带入地址、API Key 和所选模型，无需手动逐项填写。Claude Code 与 Codex 需要分别选择、分别导入。
没有唤起客户端时，请先确认已安装 CC Switch。Windows 用户可使用官方 MSI 安装版完成导入协议注册，再回主站重试；也可以使用下面的手动配置方式。导入链接包含当前密钥，请勿分享给他人。
手动配置 Claude Code（可选）
- 打开 CC Switch，选择左侧的 Claude Code。
- 点击 添加 Provider 或右上角 +。
- 填写以下内容：
| 字段 | 填写内容 |
|---|---|
| Provider 名称 | AruHub |
| API Base URL | https://api.aruhub.com |
| API Key | 你的 AruHub API Key |
| 模型 | 填写 AruHub 模型列表中显示的完整模型名称 |
- 在接口格式或协议选项中，选择与 AruHub 控制台标明的模型协议一致的类型。
- 保存后，在 Provider 卡片上点击 启用，再使用模型测试确认连接正常。
TIP
Claude Code 的 Base URL 直接填写 https://api.aruhub.com，不要手动添加版本或消息路径。
手动配置 Codex CLI（可选）
- 打开 CC Switch，选择左侧的 Codex。
- 点击 添加 Provider。
- Base URL 填写
https://api.aruhub.com/v1，再填写自己的 API Key 与支持 Responses 的模型 ID。 - 仅当 AruHub 控制台或模型说明明确支持 Responses / Codex 协议 时，才在 Codex 中启用该 Provider。
- 保存并执行模型测试。若测试失败，优先核对接口协议、模型名称与 Base URL。
WARNING
并非所有 OpenAI 兼容接口都支持 Codex CLI 所需的 Responses 协议。若 CC Switch 中没有可匹配的协议选项，建议改用 Claude Code、Cursor 或 Cherry Studio。
常见问题
401 Unauthorized
通常是 API Key 错误、Key 已被禁用，或复制时带入空格。请重新创建或复制 Key 后再次测试。
404 Not Found
按当前工具核对地址：
- Claude Code：
https://api.aruhub.com - Codex CLI：
https://api.aruhub.com/v1
不要在 Base URL 后继续拼接消息接口路径。
模型测试失败
确认模型名称完全一致，并确认该模型支持当前工具所需的协议。无法确定时，先到 错误排查 查看常见原因。