GetCheapAI

在 Claude Code 中使用 API 中转站

通过环境变量或 settings.json 将 Claude Code 指向自定义 API 地址。

3 分钟阅读

Claude Code 支持把请求发送到自定义的 API 地址，只需配置对应的环境变量或写入配置文件。本文介绍如何把 Claude Code 指向一个兼容 Anthropic 接口的 API 中转站。

准备信息

在开始前，从你使用的 API 平台获取以下信息：

  • API 地址（Base URL）：平台提供的接口根地址
  • API 密钥（Key）：用于鉴权的令牌
  • 模型名称：平台支持、且你打算使用的模型标识

方法一：环境变量

在终端中设置以下环境变量（可写入 ~/.zshrc 或 ~/.bashrc 以便长期生效）：

export ANTHROPIC_BASE_URL="https://example.com"   # 替换为平台提供的 API 地址
export ANTHROPIC_AUTH_TOKEN="your-key"            # 替换为你的 API 密钥
export ANTHROPIC_MODEL="your-model-name"          # 替换为平台支持的模型名

设置后重新打开终端，再运行 claude 即可生效。

方法二：settings.json

也可以写入 Claude Code 的配置文件 ~/.claude/settings.json（全局），或项目内的 .claude/settings.json：

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

当配置中包含密钥时，建议使用不纳入版本控制的 .claude/settings.local.json。

常见问题

  • 出现 404：部分服务对结尾斜杠敏感，可尝试为 API 地址加上或去掉末尾的 /。
  • 模型名不匹配：Claude Code 不会自动转换模型名，请将模型名设置为平台能识别的名称。
  • 图形界面不生效：从程序坞或快捷方式启动的图形界面应用，不会读取在终端里设置的环境变量。
  • 与订阅冲突：若同时登录了 Claude 订阅账号，自定义地址会覆盖订阅；如需切回官方，移除上述配置即可。

了解更多