AIHelms

AIHelms Docs

CC-Switch 接入

使用 CC-Switch 管理 AIHelms 的 Claude Code 和 Codex 配置。

CC-Switch 适合在多套 Claude Code 或 Codex 配置之间切换。开始前,从 AIHelms 用户端准备 AI 身份 Key、Endpoint 和模型 ID。

Claude Code

  1. 在 CC-Switch 中选择 Claude Code。
  2. 点击添加供应商,选择自定义。
  3. 名称填写 AIHelms Claude
  4. Base URL 填 AIHelms Endpoint。
  5. API Key 填 AI 身份 Key。
  6. 模型填带 (Anthropic) 后缀的模型 ID。
  7. 保存并启用。

启用后完全退出 Claude Code 并重新运行 claude。使用 /status/model 检查地址及模型。

Codex

  1. 在 CC-Switch 中选择 Codex。
  2. 添加自定义供应商,名称填写 AIHelms Codex
  3. Base URL 填 <Endpoint>/v1
  4. API Key 填 AI 身份 Key。
  5. 模型填普通模型 ID。
  6. API 协议选择 Responses。
  7. 保存并启用。

启用后完全退出 Codex 并重新运行 codex

使用提醒

  • Claude Code 和 Codex 的 Base URL、模型 ID 不同,建议分别创建供应商配置。
  • 切换配置前先关闭正在运行的客户端。
  • 不要同时手工编辑配置文件和用 CC-Switch 保存同一配置。
  • 导出 CC-Switch 数据时按密钥文件管理,备份可能包含完整 Key。

常见问题

现象处理方法
切换后仍使用旧地址完全退出客户端后重启
Claude Code 找不到模型使用带 (Anthropic) 后缀的模型 ID
Codex 请求地址错误Base URL 以 /v1 结尾,协议选择 Responses
获取模型失败手工填写模型广场中的模型 ID