Claude Code 第三方 API 配置

任务

帮用户配置 Claude Code CLI 连接自定义 Anthropic 兼容 API。

一次性成功配置（按顺序做）

Step 1 — 收集信息

问用户三个问题：

1. API 地址是什么？（例如 https://api.example.com，不要 /v1 后缀）
2. 模型名是什么？（例如 gpt-4o、deepseek-v3）
3. API Key 是什么？（以 sk- 开头的字符串）

Step 2 — 写配置文件

将以下内容写入 ~/.claude/settings.json：

{
    "baseUrl": "<用户提供的API地址>",
    "model": "<用户提供的模型名>"
}

不要在 settings.json 里写 apiKey。API Key 只通过环境变量传递。

Step 3 — 设环境变量

追加到 ~/.zshrc（macOS/Linux）或对应 shell 配置文件：

export ANTHROPIC_API_KEY="<用户提供的API Key>"

然后执行 source ~/.zshrc 使其生效。

Step 4 — 验证

运行：claude，发送 你好 测试。

为什么这样做

这个配置方式能一次成功的原因：

Claude Code 在以下情况会校验模型名是否为 Anthropic 官方模型：

• 通过 --model 命令行参数指定
• 通过 ANTHROPIC_MODEL 环境变量指定

但 settings.json 里的 "model" 字段 不触发校验。把模型名直接写在 settings.json 里可以绕过校验，让 Claude Code 接受任何模型名。

常见错误