Claude Code 接 API 中轉站 Base URL 配置教程

最小配置

Claude Code 接中轉站時,通常先看服務商是不是 Anthropic 兼容接口。最常見的配置是:

export ANTHROPIC_BASE_URL="https://你的中轉站地址"
export ANTHROPIC_AUTH_TOKEN="你的中轉站 API Key"
claude

ANTHROPIC_BASE_URL 用來把請求路由到代理或網關,ANTHROPIC_AUTH_TOKEN 會作為 Bearer token 發送。

如果你還在對比 Claude Code 可用的服務商，可以先看 Claude API 中轉服務商 專題頁。想同時查看 Anthropic 兼容、OpenAI 兼容和多模型聚合服務商，可以用 AI API 服務商目錄 做初篩。

API Key 路徑

如果服務商給的是 Anthropic 風格 API Key,可能會讓你配置:

export ANTHROPIC_API_KEY="sk-..."
claude

注意: 設置 ANTHROPIC_API_KEY 後,Claude Code 會使用這個 API Key,而不是 Claude Pro / Max / Team 訂閱登錄的額度。測試中轉站時建議開一個新終端窗口,只在這個窗口裡設置變量。

常見錯誤

• 401: Key 不對、Header 類型不對,或服務商要求用 ANTHROPIC_AUTH_TOKEN 而不是 ANTHROPIC_API_KEY。
• 404: Base URL 路徑不對。尤其注意服務商要求是否帶 /v1。
• model not found: 模型名不在服務商支持列表裡,或需要設置自定義模型選項。
• MCP 搜索異常: 非官方 Base URL 下,Claude Code 可能會改變 MCP tool search 行為,需要確認服務商是否完整轉發相關能力。

建議

先用一個乾淨終端做一次臨時配置,確認能跑通後,再考慮寫進 shell profile、項目腳本或切換工具裡。不要一開始就改全局配置,否則排障時很難分清是賬號、環境變量還是服務商接口的問題。