Claude Code

Claude Code 是 Anthropic 推出的终端编程助手，能理解代码库、跨文件编辑、运行命令。它使用 Anthropic Messages 格式（POST /v1/messages），通过环境变量指向 AI 星图即可。

官方主页：https://www.anthropic.com/claude-code

前置条件复制锚点链接

• 一个 AI 星图的 API 密钥，创建方法见 API 密钥。如果给密钥设置了模型限制，要把要用的模型放进允许列表，否则会返回 model_not_found。可以用 GET /v1/models 确认密钥能用哪些模型，见 快速开始。
• Base URL 不带 /v1：Claude Code 会自己拼上 /v1/messages，原因见 Anthropic 格式。
• 选择支持 /v1/messages 的模型：在 模型广场 选择一个支持 /v1/messages 的模型，使用它的模型 ID。不支持该接口的模型无法在 Claude Code 中使用；走 Responses 接口的终端工具见 Codex CLI。

安装 Claude Code复制锚点链接

curl -fsSL https://claude.ai/install.sh | bash

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

安装完成后运行 claude --version，显示版本号即成功。

配置环境变量复制锚点链接

export ANTHROPIC_BASE_URL="https://ai.myaiexp.com"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxx"
claude

ANTHROPIC_AUTH_TOKEN 会以 Authorization: Bearer sk-... 发送，AI 星图的 /v1/messages 接受这种鉴权方式。

或者写入 settings.json复制锚点链接

编辑 ~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json），把变量写进 env，以后不用每次导出环境变量：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.myaiexp.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx"
  }
}

如果文件里已有其他配置，只合并 env 这一段，不要整体覆盖。

指定模型复制锚点链接

Claude Code 默认按 Opus / Sonnet / Haiku 档位选择模型。默认模型名不在你的可用列表里时，在 模型广场 选择一个支持 /v1/messages 的模型，用下面的环境变量指定它的模型 ID：

示例中的 your-model-id、your-fast-model-id 请替换为模型广场中支持 /v1/messages 的模型 ID（也可以调用 GET /v1/models 查看）。

export ANTHROPIC_MODEL="your-model-id"  # 替换为模型广场中支持 /v1/messages 的模型 ID
export ANTHROPIC_DEFAULT_OPUS_MODEL="your-model-id"
export ANTHROPIC_DEFAULT_SONNET_MODEL="your-model-id"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="your-fast-model-id"
export ANTHROPIC_SMALL_FAST_MODEL="your-fast-model-id"

写在 settings.json 里也一样：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.myaiexp.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx",
    "ANTHROPIC_MODEL": "your-model-id",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "your-model-id",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "your-model-id",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "your-fast-model-id"
  }
}

也可以在 Claude Code 里输入 /model 选择模型。完整模型列表见 模型广场 或 GET /v1/models。

验证复制锚点链接

启动 claude 后输入任意问题，然后到控制台 使用日志 确认出现了对应记录。

• 报 model_not_found：检查模型名是否与 GET /v1/models 一致、该模型是否支持 /v1/messages、密钥是否有模型限制。
• 报 401：检查 Key 是否正确、是否已过期或被禁用。
• 请求发到了 /v1/v1/messages：Base URL 多写了 /v1，去掉即可。

更多排查方法见 错误排查。