Claude Code 預設會直接呼叫 Anthropic 官方 API,認證方式是 API Key 或 Claude 訂閱登入。如果團隊已經透過第三方 API 閘道取得模型存取權限,想讓 Claude Code 改走這條路徑,最常卡住的第一步幾乎都是同一個錯誤:401 認證失敗。
Claude Code 怎麼決定要打去哪裡
Claude Code 透過兩組環境變數決定請求要送到哪裡、怎麼認證:一組是 base URL,一組是認證金鑰(常見命名是 ANTHROPIC_BASE_URL 與 ANTHROPIC_AUTH_TOKEN,實際變數名稱請以 Anthropic 官方文件當下版本為準,因為 CLI 工具的設定方式比 API 本身變動更頻繁)。把這兩組變數指向相容閘道的位址與金鑰,就能讓所有請求改道,完全不需要改動專案裡的任何檔案。
「相容」在這裡具體是指什麼?
Claude Code 預期收到的是原生 Anthropic Messages API 格式的請求與回應,包含系統提示詞處理、串流事件、工具呼叫區塊。閘道如果是直接以原生格式轉發到 Claude,而不是先轉成 OpenAI 格式再轉一次,這部分就不會出現落差。
設定步驟
- 從閘道後台取得 API Key。
- 設定 base URL 環境變數,指向閘道文件標示的位址。
- 設定認證金鑰環境變數為你的閘道 API Key。
- 重新開啟終端機(或重新載入 shell 設定檔),讓 Claude Code 讀到新的環境變數。
- 先送一則簡單測試訊息,確認有正常回應,再放心用於正式工作。
需要另外改 Claude Code 的專案設定嗎?
不用。這組設定是在環境變數層級生效,不是專案層級,所以同一個終端機工作階段裡,不管開啟哪個專案,Claude Code 都會沿用同一組設定。
401 錯誤實際排查
這一步幾乎所有問題都出在「複製貼上沒對齊」,而不是帳號本身有問題。
| 現象 | 常見原因 | 排查方式 |
|---|---|---|
| 401 Unauthorized | 認證金鑰環境變數沒設定,或設定在還沒重啟的舊終端機 | 確認變數已經 export,並重新開一個終端機視窗 |
| 請求還是打到 Anthropic 官方預設位址 | base URL 變數名稱打錯,或設定在錯誤的 shell 設定檔 | 先 echo 這個變數,確認值真的有生效,再啟動 Claude Code |
| 找不到模型 / 不支援的模型錯誤 | 請求的模型字串不是閘道有對應的模型 | 先查閘道支援的模型清單,不要直接假設是帳號設定錯誤 |
為什麼重開終端機這麼常見地能解決問題?
環境變數是程序啟動當下讀取一次的值。如果你在一個「Claude Code 已經啟動過」的舊終端機視窗裡才 export 新變數,那個既有的 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