首页 → 指南 → Claude Code 的 Anthropic base URL：正确设置 ANTHROPIC_BASE_URL

Claude Code 的 Anthropic base URL：正确设置 ANTHROPIC_BASE_URL

ANTHROPIC_BASE_URL 指向哪里，Claude Code 就连哪里。最容易踩的坑只有一条：它要的是不带 /v1 的主机地址——和几乎所有 OpenAI 系工具正好相反。

一句话答案

启动 Claude Code 之前设置两个环境变量：

ANTHROPIC_BASE_URL=https://apiclan.us
ANTHROPIC_AUTH_TOKEN=sk-your-key

官方 Anthropic 地址是 https://api.anthropic.com，换成中转只需要替换它。Claude Code 会自己在后面拼上 /v1/messages，所以 base URL 只能写到主机为止。过去 30 天经过本网关的 Claude 调用里，88% 来自按这个方式配置的 Claude Code。

在哪里设置

macOS / Linux ——在启动它的终端里：

export ANTHROPIC_BASE_URL=https://apiclan.us
export ANTHROPIC_AUTH_TOKEN=sk-your-key
claude

Windows PowerShell ——只对当前窗口生效：

$env:ANTHROPIC_BASE_URL = "https://apiclan.us"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"
claude

~/.claude/settings.json ——写进配置文件，每次会话自动生效，不用管终端：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://apiclan.us",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

这个值是 Claude Code 启动时读取的。改了之后要退出、重新开一个会话；已经打开的会话还会用旧地址。ANTHROPIC_AUTH_TOKEN 以 Authorization: Bearer 发送，ANTHROPIC_API_KEY 以 x-api-key 发送。本网关两种都支持，选一个就行，不要两个都设。

一条命令测试

怀疑 Claude Code 之前，先直接验证地址和密钥：

curl https://apiclan.us/v1/messages \
  -H "Authorization: Bearer sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":20,"messages":[{"role":"user","content":"hi"}]}'

返回 JSON 说明两样都对。返回 text/html 或 404，是地址错了；返回 JSON 格式的 401，说明地址对、密钥不对。

什么时候加 /v1，什么时候不加

两类 SDK 切分网址的位置不同。Anthropic 系客户端自己加 /v1/messages；OpenAI 系客户端要求 base URL 里已经带 /v1，只在后面加 /chat/completions：

客户端	Base URL
Claude Code, Anthropic SDK	https://apiclan.us
Codex, OpenAI SDK	https://apiclan.us/v1
Cursor, Cline, Roo Code	https://apiclan.us/v1
Cherry Studio, Chatbox, LobeChat, LM Studio	https://apiclan.us/v1

在 Claude Code 里加了 /v1，请求会发到 /v1/v1/messages，返回 404。在 Cursor 里漏了 /v1，请求会发到 /chat/completions，同样 404。两种都到不了 API。

是地址错了，还是密钥错了？

• 报错，用量记录里却什么都没有 → 路径错了。404 在网络边缘就被返回，根本到不了计费系统。先检查 /v1。
• 401，并且用量记录里有这一条 → 密钥错了、被撤销了，或者余额不足。
• 同一把密钥，别的模型能用、只有一个模型 404 → 这个模型属于另一个分组。每把密钥只绑定一个分组，给那个分组再建一把密钥。
• 改了设置却好像没生效 → 变量设在了另一个终端里，或者会话是在你设置之前启动的。

选择模型

模型名要一字不差，用连字符、不用点——是 claude-fable-5-1，不是 claude-fable-5.1。启动时指定，或者在会话里用 /model 切换：

claude --model claude-opus-5-5

当前的模型名和价格见价格表。其他客户端的设置见快速开始，Claude 桌面端见桌面客户端指南。

开始使用

无订阅、无最低消费、不用跟销售通话。用 USDT 充值，用多少花多少 —— 1 USDT = 2 额度。

看 30 秒快速开始

语言: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

本页价格由实时计费数据自动填入；第三方条款引自对方公开文档。