在 Windows 上設定 Claude Code API 閘道：除錯模型前，先驗證基礎 URL 與身份驗證

許多 Claude Code 閘道故障往往診斷得太晚。人們經常在請求仍指向錯誤的主機或使用錯誤的身份驗證標頭時，就先更改模型名稱。本指南提供一個針對 Windows 的精簡工作流程：先驗證閘道協定，選擇匹配的憑證變數，在一個 PowerShell 工作階段中測試連線，然後才讓設定永久生效。本指南不假設 OpenAI 相容的端點也能支援 Claude Code。

一個正常運作的設定需要三個獨立且一致的值：基礎 URL，這是服務為 Claude Code 或 Anthropic 相容閘道提供的 URL，請勿從儀表板登入 URL 推導。憑證類型，Bearer token 通常對應 ANTHROPIC_AUTH_TOKEN，而 x-api-key 流程則對應 ANTHROPIC_API_KEY，應依服務文件決定。

協定與路徑，Claude Code 需要閘道支援 Anthropic Messages 格式，通常透過 /v1/messages 路徑公開。

如果服務只說明 OpenAI Responses 或 Chat Completions，那將是不同的整合方式。如果這些值中的任何一個是猜測的，那麼之後出現的模型錯誤將不是有用的證據。

從暫時變數開始測試，這樣失敗的實驗很容易移除：$env:ANTHROPIC_BASE_URL = "https://gateway.example.com" 和 $env:ANTHROPIC_AUTH_TOKEN = Read-Host "Enter the gateway token" -MaskInput claude。請將範例主機和 token 流程替換為當前服務文件中的值。

如果服務指定的是 API key 標頭，則使用 ANTHROPIC_API_KEY，且不要同時設定這兩個變數。從同一個 PowerShell 視窗啟動 Claude 很重要，在一個 shell 中設定變數，卻從另一個 shell 啟動 CLI，可能會導致正確的值看似遺失。

在 Claude Code 工作階段中，發送一個小型、非敏感的測試訊息，然後執行 /status。檢查顯示的基礎 URL 和憑證來源是否與您打算使用的值相符。

只有在此之後，才去調查模型的可用性或請求限制。可見的環境變數並不能證明閘道已接受請求，測試訊息和狀態輸出提供了兩個獨立的檢查：程序繼承和實際的請求路徑。

401 Unauthorized（未經授權）：首先檢查憑證類型。即使字串本身有效，透過 x-api-key 變數發送 Bearer token，或透過 Authorization 流程發送 API key，都可能失敗。同時也要檢查 token 是否屬於當前的閘道。

Claude Code 仍要求登入：CLI 可能沒有繼承變數，或者優先級更高的設定檔可能正在生效。在更改憑證之前，請確認啟動目錄並檢查活動的設定來源。

位址可達但回應格式無效：網路可達性僅證明有東西回應了。請重新檢查端點是否實作了 Anthropic Messages 格式，以及路徑是否為 Claude Code 文件中記載的路徑。請勿將 Codex 或 OpenAI 的配置複製到此工作流程中。

當暫時工作階段運作正常時，使用者層級的設定檔可以儲存環境區塊。請將真實憑證保存在專案檔、螢幕截圖、公開問題和儲存庫之外。共享的 .claude/settings.json 特別容易不小心提交。

如需更詳細的 Windows 設定步驟，包括確切的變數選擇、/status 檢查和清理步驟，請參閱 Claude Code API 設定指南。該指南也解釋了何時應拒絕某項服務，因為它只記載了不相容的協定。

官方參考資料包括：將 Claude Code 連接到 LLM 閘道、Claude Code 環境變數、Claude Code 設定。上述工作流程刻意保守：成功的配置意味著所選的客戶端、協定、位址和憑證來源一致。這並不表示每個閘道都支援 Claude Code，也不表示單次成功的請求就能證明生產環境的可靠性。