Claude Code base_url

Claude Code base_url（ANTHROPIC_BASE_URL）配置指南

Claude Code 没有名为 base_url 的配置项，对应的是环境变量 ANTHROPIC_BASE_URL。本文说明它该填什么、配合哪个鉴权变量、写在哪里优先级最高，以及最常见的配置错误。

立即体验 · 查看定价

ANTHROPIC_BASE_URL

填网关根地址 https://gw-link.com（或美国节点 https://gw-link.ai），不要带 /v1，Claude Code 会自动拼接 /v1/messages。

ANTHROPIC_AUTH_TOKEN

填 gw-link 的 sk- 密钥，以 Authorization: Bearer 方式发送。用 ANTHROPIC_API_KEY（x-api-key 头）也能被网关识别，但首次启动 Claude Code 会询问是否使用该 Key。

settings.json 的 env

写在 ~/.claude/settings.json 的 env 字段对所有终端和 IDE 生效，比在 shell 里 export 更稳定，也不会被新终端遗漏。

配置示例

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gw-link.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的gw-link密钥",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

临时在当前终端生效

export ANTHROPIC_BASE_URL="https://gw-link.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的gw-link密钥"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

用 curl 验证 Key 与网络

返回模型列表说明 Key 有效、网络可达；返回 401 说明 Key 有误。

curl https://gw-link.com/v1/models \
  -H "Authorization: Bearer sk-你的gw-link密钥"

常见问题

Claude Code 的 base_url 应该填什么？

设置环境变量 ANTHROPIC_BASE_URL=https://gw-link.com。海外网络可改用 https://gw-link.ai。两者都不要带 /v1 后缀。

ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 用哪个？

推荐 ANTHROPIC_AUTH_TOKEN（Bearer 鉴权，不会触发确认提示）。gw-link 同时接受 x-api-key，所以 ANTHROPIC_API_KEY 也可以用。两个不要同时设置不同的值。

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 有什么用？

它关闭 Claude Code 的遥测、错误上报等非必要请求，让所有流量只走你配置的网关，减少因无法访问官方服务导致的卡顿。

改了配置还是不生效？

检查是否同时存在 shell 环境变量和 settings.json（shell 中旧的 export 可能覆盖新值），修改后需要重新打开终端或重启 IDE。

English

最后更新: 2026-10-02