claude-code 怎么配置第三方 API

Claude Code 读取 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN。任何兼容 Anthropic 接口的网关都可以按下面三步接入。

第一步：写入配置

推荐写进用户级 ~/.claude/settings.json，不要提交到仓库：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://relay.example.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

也可以只在当前终端临时生效：

export ANTHROPIC_BASE_URL="https://relay.example.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"

第二步：确认模型名

不同网关的模型 ID 可能不同。先查网关的模型列表，再用 --model 指定，例如：

claude --model claude-sonnet-5-5 -p "reply with OK"

第三步：验证

看到 OK 即打通。再跑一次带工具调用的请求，确认流式输出与函数调用正常。

常见报错

• 401 invalid api key：key 多了空格、引号，或用了别的网关的 key。
• 404 model not found：模型 ID 与网关不一致，换用网关文档里的名字。
• 429 / 529：触发限流或上游过载，退避重试，不要并发猛冲。
• context length exceeded：长会话超窗口，开新会话或压缩上下文。

注意

• 不要把 key 写进项目仓库或截图。
• 公司环境优先用系统级环境变量注入，避免留在 shell 历史里。