在 Claude Code 中配置自定义 API 地址

Claude Code 支持把请求发送到自定义 API 地址。本文只说明配置方式，不代表任何第三方接口已经通过 ModelCheck 的检测。

准备信息

从你使用的服务商获取 API 地址、API 密钥和模型名称。先确认该服务商明确支持 Anthropic 兼容协议，并使用低额度、可吊销的测试 Key。

方法一：环境变量

在终端中设置环境变量，可以写入 ~/.zshrc 或 ~/.bashrc，但不要把密钥提交到代码仓库：

export ANTHROPIC_BASE_URL="https://example.com"
export ANTHROPIC_AUTH_TOKEN="your-key"
export ANTHROPIC_MODEL="your-model-name"

重新打开终端后运行 claude。如果服务商要求不同的变量名，以其官方说明为准。

方法二：settings.json

可以写入全局 ~/.claude/settings.json 或项目内的 .claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://example.com",
    "ANTHROPIC_AUTH_TOKEN": "your-key",
    "ANTHROPIC_MODEL": "your-model-name"
  }
}

含有密钥的文件应加入本地忽略规则，避免进入版本控制。团队项目建议使用环境变量或密钥管理工具。

常见问题

• 404：检查 Base URL 是否包含服务商要求的路径和斜杠。
• 模型名不匹配：Claude Code 不会替你猜测模型 ID，使用服务商实际支持的名称。
• 图形界面不生效：从桌面快捷方式启动的程序可能不会读取终端环境变量。
• 与官方订阅冲突：自定义地址会改变请求路径；切回官方时移除自定义配置并重新确认当前账号状态。

相关背景可阅读什么是 AI API 中转服务和什么是逆向分组。