AIHelms Docs
CC-Switch 接入
使用 CC-Switch 管理 AIHelms 的 Claude Code 和 Codex 配置。
CC-Switch 适合在多套 Claude Code 或 Codex 配置之间切换。开始前,从 AIHelms 用户端准备 AI 身份 Key、Endpoint 和模型 ID。
Claude Code
- 在 CC-Switch 中选择 Claude Code。
- 点击添加供应商,选择自定义。
- 名称填写
AIHelms Claude。 - Base URL 填 AIHelms Endpoint。
- API Key 填 AI 身份 Key。
- 模型填带
(Anthropic)后缀的模型 ID。 - 保存并启用。
启用后完全退出 Claude Code 并重新运行 claude。使用 /status 和 /model 检查地址及模型。
Codex
- 在 CC-Switch 中选择 Codex。
- 添加自定义供应商,名称填写
AIHelms Codex。 - Base URL 填
<Endpoint>/v1。 - API Key 填 AI 身份 Key。
- 模型填普通模型 ID。
- API 协议选择 Responses。
- 保存并启用。
启用后完全退出 Codex 并重新运行 codex。
使用提醒
- Claude Code 和 Codex 的 Base URL、模型 ID 不同,建议分别创建供应商配置。
- 切换配置前先关闭正在运行的客户端。
- 不要同时手工编辑配置文件和用 CC-Switch 保存同一配置。
- 导出 CC-Switch 数据时按密钥文件管理,备份可能包含完整 Key。
常见问题
| 现象 | 处理方法 |
|---|---|
| 切换后仍使用旧地址 | 完全退出客户端后重启 |
| Claude Code 找不到模型 | 使用带 (Anthropic) 后缀的模型 ID |
| Codex 请求地址错误 | Base URL 以 /v1 结尾,协议选择 Responses |
| 获取模型失败 | 手工填写模型广场中的模型 ID |