Claude Code 預設會直接呼叫 Anthropic 官方 API,認證方式是 API Key 或 Claude 訂閱登入。如果技術團隊已經透過第三方 API 閘道取得模型存取權限,想讓 Claude Code 改行這條路徑,最常見的第一個問題就是認證失敗。
Claude Code 如何決定請求送往何處
Claude Code 透過兩組環境變數決定請求發送位置與認證方式:一組是 base URL,一組是認證金鑰(常見命名為 ANTHROPIC_BASE_URL 與 ANTHROPIC_AUTH_TOKEN,實際變數名稱請以 Anthropic 官方文件當前版本為準)。把這兩組變數指向相容閘道的位址與金鑰,即可讓所有請求改道,毋須改動專案內任何檔案。
「相容」在這裡具體指的是什麼?
Claude Code 預期收到原生 Anthropic Messages API 格式的請求與回應,包括系統提示詞處理、串流事件、工具呼叫區塊。閘道如果直接以原生格式轉發至 Claude,而非先轉換成其他格式再轉發一次,這部分便不會出現落差。
設定步驟
- 從閘道後台取得 API Key。
- 設定 base URL 環境變數,指向閘道文件標示的位址。
- 設定認證金鑰環境變數為閘道 API Key。
- 重新開啟終端機,讓 Claude Code 讀取新的環境變數。
- 發送簡單測試訊息,確認回應正常後再用於正式工作。
是否需要另外修改 Claude Code 的專案設定?
不需要。這組設定在環境變數層級生效,並非專案層級,因此同一個終端機工作階段內,不論開啟哪個專案,Claude Code 都會沿用同一組設定。
常見設定問題排查
| 現象 | 常見原因 | 排查方式 |
|---|---|---|
| 401 Unauthorized | 認證金鑰環境變數未設定,或設定在尚未重啟的舊終端機 | 確認變數已經 export,並重新開啟終端機視窗 |
| 請求仍然發送至 Anthropic 官方預設位址 | base URL 變數名稱錯誤,或設定在錯誤的 shell 設定檔 | 先確認變數值是否正確生效,再啟動 Claude Code |
| 找不到模型或不支援的模型錯誤 | 請求的模型字串並非閘道所對應的模型 | 先查閱閘道支援的模型清單,而非假設帳戶設定有誤 |
為何重新開啟終端機經常能解決問題?
環境變數是程序啟動當下讀取一次的值。如果在一個「Claude Code 已經啟動過」的舊終端機視窗內才設定新變數,該既有程序不會讀取到新值——重新開啟終端機是根本解決方法,而非權宜之計。
香港技術團隊采用這種設定的原因
最常見的原因並非節省成本,而是統一管理。如果團隊已經透過同一個閘道取得 Claude、GPT、DeepSeek 的存取權限,自然希望 Claude Code 也沿用同一組金鑰與帳單,而非另外維護一個獨立的 Anthropic 帳戶。
PioModel 的 API Key 可直接作為 Claude Code 的相容認證金鑰使用,與 GPT、DeepSeek、GLM、Kimi、通義千問、Llama、Grok 共用同一組 OpenAI 相容端點——同一組金鑰,接下來要用哪個模型都毋須重新申請帳戶。
Comments
Sign in to join the discussion