首頁 → 指南 → 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 SDKhttps://apiclan.us
Codex, OpenAI SDKhttps://apiclan.us/v1
Cursor, Cline, Roo Codehttps://apiclan.us/v1
Cherry Studio, Chatbox, LobeChat, LM Studiohttps://apiclan.us/v1

在 Claude Code 加了 /v1,請求會送到 /v1/v1/messages,回傳 404。在 Cursor 漏了 /v1,請求會送到 /chat/completions,同樣 404。兩者都到不了 API。

是位址錯,還是金鑰錯?

選擇模型

模型名稱必須完全一致,使用連字號而非句點——是 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 · فارسی · Русский

本頁價格由即時計費資料自動填入;第三方條款引自對方公開文件。