AIHelms Docs

Claude Code 接入

把 Claude Code 连接到 AIHelms。

准备信息

从 AIHelms 用户端取得：

信息	获取位置
AI 身份 Key	我的 AI 身份
Endpoint	模型广场 > 查看接入信息
Anthropic 模型 ID	模型广场 > 查看接入信息，通常带 `(Anthropic)` 后缀

如果页面没有 Anthropic 模型 ID，请联系管理员确认该模型是否支持 Claude Code 接入。

配置 Claude Code

编辑用户配置文件：

macOS、Linux：~/.claude/settings.json
Windows：%USERPROFILE%\.claude\settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://<AIHelms Endpoint>",
    "ANTHROPIC_AUTH_TOKEN": "<AI 身份 Key>",
    "ANTHROPIC_MODEL": "<模型 ID>(Anthropic)"
  }
}

保存前检查：

ANTHROPIC_BASE_URL 使用模型广场提供的 Endpoint，不要追加 /v1/messages。
ANTHROPIC_AUTH_TOKEN 填 AI 身份 Key，不是供应商 Key 或管理 API Key。
ANTHROPIC_MODEL 完整保留 (Anthropic) 后缀。
JSON 最后一项后面不要有逗号。

启动

进入工作目录后运行：

claude

第一次进入目录时，按提示确认是否信任该目录。

验证

在 Claude Code 中依次运行：

/status
/model

确认 Base URL 指向 AIHelms，模型与配置文件一致。然后发送一个简单问题，再让 Claude Code 读取一个测试文件，确认普通问答和工具调用都正常。

常见问题

现象	处理方法
启动后仍要求官方登录	关闭 Claude Code，检查配置文件路径和 JSON 格式后重启
`/status` 不是 AIHelms 地址	系统环境变量可能覆盖配置，检查旧的 `ANTHROPIC_BASE_URL`
401	重新复制 AI 身份 Key，确认身份已激活
`model not found`	使用模型广场提供的完整 Anthropic 模型 ID
`model not allowed`	联系管理员为你的 AI 身份分配该模型
普通问答成功但工具失败	换用标记“工具调用”的模型，并联系管理员检查模型能力

使用 CC-Switch 管理多套配置时，参见 CC-Switch。