Claude Code 閘道設定

確認原生協定與設定範圍

網站維護中。以下是規劃中的設定教學；api.ubtl.net 為預定網域，未執行真實 API 測試，也未確認服務連線。使用前須取得明確的 Anthropic Messages 協定、驗證方式、路徑與模型識別碼說明。

Claude Code 的這種閘道設定要求原生 Anthropic Messages 介面，不能把 OpenAI 聊天端點直接代入。先關閉現有工作階段，記錄目前的環境變數並備份要修改的設定。以下選擇單一終端機的環境變數，方便隔離測試；若改用 ~/.claude/settings.json 的 env，必須留意它會影響 CLI 的背景工作階段，避免意外擴大作用範圍。

設定根網址與單一憑證

ANTHROPIC_BASE_URL 使用規劃中的根網址 https://api.ubtl.net，不是 /v1/chat/completions。範例選用 ANTHROPIC_AUTH_TOKEN，並清除該終端機中的 ANTHROPIC_API_KEY，避免同時送出相互衝突的憑證。若未來服務明確要求 x-api-key，才改用 ANTHROPIC_API_KEY 並清除 token；不要把兩者都設好當作相容性補救。

先保存原有憑證的安全來源，再使用下列其中一種 shell 範例；它們會改動目前工作階段的環境變數，但不會安裝工具或證明連線成功。YOUR_UBTL_API_KEY 必須保留為佔位符直到取得授權金鑰，不要將真實值貼到共享對話、專案設定或問題回報。

Bash 規劃設定 · bash

unset ANTHROPIC_API_KEY
export ANTHROPIC_BASE_URL='https://api.ubtl.net'
export ANTHROPIC_AUTH_TOKEN='YOUR_UBTL_API_KEY'
claude

PowerShell 規劃設定 · powershell

Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue
$env:ANTHROPIC_BASE_URL = 'https://api.ubtl.net'
$env:ANTHROPIC_AUTH_TOKEN = 'YOUR_UBTL_API_KEY'
claude

檢查狀態與最小請求

在同一終端機重新啟動 Claude Code，使用 /status 檢查閘道網址與憑證類型；這不會證明訂閱或 UBTL 服務可用。服務確認可用後，使用 /model 選擇實際獲准的模型，僅在可接受已確認識別碼的流程中代入 YOUR_MODEL_ID。先以不含私人檔案的小型測試開始。認證錯誤查憑證衝突，路徑錯誤查根網址與 Messages 支援，模型錯誤查權限。切回原供應商時還原備份並移除新增變數。