Claude Code 环境变量配置

本页讲的是通过环境变量把 Claude Code 接到 ZR API。普通用户更推荐使用 cc-switch 配置，它更直观，也更适合频繁切换模型或接入点。

TIP

未来这里会补充 Codex 的环境变量配置。当前页面只讲 Claude Code。

准备信息

项目	值
API Key	在 ZR API 控制台 创建，格式一般是 sk-...
Base URL	https://zrapi.org
模型 ID	建议从 模型与价格 复制，例如 claude-opus-4-7
余额 / 兑换码	余额不足时先 获取兑换码，再到控制台兑换

方式一：写入 Claude Code 配置文件

这种方式适合固定在一台电脑上使用 Claude Code。配置写好后，每次打开 Claude Code 都会自动读取。

1. 打开 Claude Code 配置目录：

macOS / Linux

mkdir -p ~/.claude
${EDITOR:-nano} ~/.claude/settings.json

Windows PowerShell

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude"
explorer "$env:USERPROFILE\.claude"

2. 在目录里创建或编辑 settings.json。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://zrapi.org",
    "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_TOKEN",
    "ANTHROPIC_MODEL": "claude-opus-4-7",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

3. 保存文件后，完全退出 Claude Code，再重新打开。

字段	作用
ANTHROPIC_BASE_URL	指向 ZR API 的 Claude 兼容入口，不要写成 https://zrapi.org/v1
ANTHROPIC_AUTH_TOKEN	填 ZR API 控制台生成的 sk-...
ANTHROPIC_MODEL	默认模型名，建议从模型与价格复制
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC	减少 Claude Code 访问非必要官方服务

WARNING

settings.json 必须是合法 JSON：双引号不能写成中文引号，最后一个字段后面不要多加逗号。

方式二：临时环境变量

这种方式只对当前终端窗口生效，适合临时测试。关闭终端后配置会失效。

macOS / Linux

export ANTHROPIC_BASE_URL="https://zrapi.org"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_TOKEN"
export ANTHROPIC_MODEL="claude-opus-4-7"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://zrapi.org"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_TOKEN"
$env:ANTHROPIC_MODEL = "claude-opus-4-7"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

claude

方式三：永久环境变量

如果你不想每次都打开 settings.json，也可以写入系统环境变量。写完后需要重新打开终端。

下面示例按 macOS 默认的 zsh 写入 ~/.zshrc；如果你使用 bash，把 ~/.zshrc 改成 ~/.bashrc。

macOS / Linux

echo 'export ANTHROPIC_BASE_URL="https://zrapi.org"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-YOUR_TOKEN"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-opus-4-7"' >> ~/.zshrc
echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://zrapi.org", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-YOUR_TOKEN", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-opus-4-7", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "User")

验证配置

重新打开终端后运行：

claude "请回复 OK"

如果能返回正常文本，说明 Claude Code 已经走 ZR API。第一次运行如果仍然进入官方登录流程，先退出 Claude Code，再重新打开终端测试。

常见问题

现象	处理方式
401 / 403	检查 sk-... 是否完整，是否复制了空格，是否仍在使用官方 Anthropic Key
404	ANTHROPIC_BASE_URL 必须是 https://zrapi.org，不要加 /v1；模型名从模型与价格复制
仍然要求登录 Claude 官方账号	退出官方账号后重启 Claude Code，或确认 settings.json 放在了 ~/.claude/settings.json
改了配置没生效	完全关闭 Claude Code 和终端，再重新打开
某些版本鉴权异常	尝试把 ANTHROPIC_AUTH_TOKEN 改成 ANTHROPIC_API_KEY；不要同时设置这两个变量

使用 cc-switch 配置查看模型 ID错误码排查