將 Claude Code 連接到 LLM 閘道

​

檢查現有配置

​

自行配置 Claude Code

• 閘道的基礎 URL
• 認證：金鑰或令牌字符串，或獲取認證的命令
  • 如果您的閘道團隊未說明認證的類型，下面的認證變數部分涵蓋了要嘗試的內容

• 設定認證變數和設定基礎 URL：每個閘道連接需要的兩個變數
• 驗證連接：在保存任何內容之前確認它有效
• 配置每個介面：如果您使用除 Claude Code CLI 之外的介面（例如 VS Code），請查看如何使用閘道認證配置它
• 其他配置：某些閘道除了基礎 URL 和認證之外還需要的變數，例如自訂標頭、認證幫助程式、模型發現、提供者格式的基礎 URL 或關閉閘道路徑外的流量。僅在您的管理員命名它們或您的網路限制出站流量時設定這些

​

設定認證變數

​

設定基礎 URL 和認證

​

設定為 shell 環境變數

export ANTHROPIC_BASE_URL=https://llm-gateway.example.com
export ANTHROPIC_AUTH_TOKEN=sk-gateway-key

$env:ANTHROPIC_BASE_URL = "https://llm-gateway.example.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-gateway-key"

​

在設定檔案中設定

• ~/.claude/settings.json 適用於您的所有專案。在 Windows 上，路徑是 %USERPROFILE%\.claude\settings.json
• .claude/settings.local.json 適用於一個專案。Claude Code 在建立檔案時將其添加到您的全域 gitignore；如果您自己建立它或讓 Claude 寫入它，請先手動將其添加到 gitignore，以免您不小心提交您的認證

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://llm-gateway.example.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-gateway-key"
  }
}

​

驗證連接

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

​

在 Claude Code 中確認

​

認證變數如何映射到標頭

​

與現有登入的衝突

​

配置每個介面

​

VS Code 擴充功能

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://llm-gateway.example.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-gateway-key" }
  ]
}

​

桌面應用程式

• 由管理員分發：如果您的組織已部署配置，桌面應用程式通過閘道路由，無需您進行任何設定
• 本地配置：對於沒有管理員分發配置的裝置，打開說明 → 疑難排解 → 啟用開發人員模式，這會使用開發人員功能表重新啟動應用程式。然後打開開發人員 → 配置第三方推論並輸入您的閘道基礎 URL。管理員分發的配置優先，並使此表單為唯讀

• 允許的主機：SSH 工作階段預設為關閉。若要開啟，您或您的管理員需在第三方推論設定的 sshHostAllowlist 鍵中列出允許的主機
• 閘道位址：遠端機器會自行連線到閘道，因此位於您電腦上 localhost 的閘道無法用於 SSH 工作階段

​

GitHub Actions

env:
  ANTHROPIC_BASE_URL: https://llm-gateway.example.com

steps:
  - uses: anthropics/claude-code-action@v1
    with:
      anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}

env:
  ANTHROPIC_BASE_URL: https://llm-gateway.example.com
  ANTHROPIC_AUTH_TOKEN: ${{ secrets.GATEWAY_API_KEY }}

steps:
  - uses: anthropics/claude-code-action@v1
    with:
      anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}

​

Agent SDK

• TypeScript：生成的程序預設繼承父環境，但設定 options.env 會完全替換環境。將 process.env 擴展到其中以保留您的閘道變數。
• Python：ClaudeAgentOptions(env=...) 合併到繼承的環境之上，因此在父程序中設定的閘道變數無需擴展即可通過。

const result = query({
  prompt: "...",
  options: {
    env: {
      ...process.env,
      ANTHROPIC_BASE_URL: "https://llm-gateway.example.com",
      ANTHROPIC_AUTH_TOKEN: process.env.GATEWAY_KEY,
    },
  },
})

options = ClaudeAgentOptions(
    env={
        "ANTHROPIC_BASE_URL": "https://llm-gateway.example.com",
        "ANTHROPIC_AUTH_TOKEN": os.environ["GATEWAY_KEY"],
    }
)

​

Slack、雲端會話和遠端控制

• 語音聽寫：取消設定閘道認證
• 遠端控制：取消設定閘道認證和 ANTHROPIC_BASE_URL

​

其他設定

​

傳送額外的標頭

export ANTHROPIC_CUSTOM_HEADERS="X-Org-Route: prod"

$env:ANTHROPIC_CUSTOM_HEADERS = "X-Org-Route: prod"

{
  "env": {
    "ANTHROPIC_CUSTOM_HEADERS": "X-Org-Route: prod\nX-Tenant: example"
  }
}

​

將閘道模型新增至模型選擇器

​

使用 apiKeyHelper 輪替憑證

#!/bin/bash
vault kv get -field=api_key secret/llm-gateway/claude-code

{
  "apiKeyHelper": "~/bin/get-gateway-key.sh"
}

vault kv get -field=api_key secret/llm-gateway/claude-code

{
  "apiKeyHelper": "powershell -NoProfile -File C:\\scripts\\get-gateway-key.ps1"
}

​

關閉閘道路徑以外的流量

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

• 它會停用自動更新，因此請規劃其他更新途徑，例如套件管理員或受管發佈。
• 它會抑制快速模式的可用性檢查。除非先前的檢查已在該機器上啟用快速模式，否則 /fast 會回報快速模式無法使用。
• 它不會影響閘道模型探索，因為探索僅查詢您的閘道。在 v2.1.257 之前，此變數也會阻止探索重新整理，因此選擇器會保留先前快取的清單。
• WebFetch 工具的網域安全檢查不受影響，仍會呼叫 api.anthropic.com。若您的網路封鎖該主機，請在設定中另外以 skipWebFetchPreflight: true 將其關閉。
• 關於各個遙測串流及控制它的變數，請參閱遙測服務。

​

透過閘道路由至雲端供應商

• Amazon Bedrock、Google Cloud’s Agent Platform 或 Claude Platform on AWS：在區塊之後加入 ANTHROPIC_AUTH_TOKEN。Claude Code 會將其以 Authorization: Bearer 標頭傳送至閘道。若憑證使用不同的驗證方式或標頭，請改用 ANTHROPIC_CUSTOM_HEADERS。無論哪種情況，都請保留略過驗證變數的設定，因為若未設定，Claude Code 會移除 ANTHROPIC_AUTH_TOKEN、apiKeyHelper 或 ANTHROPIC_CUSTOM_HEADERS 原本會加入的任何 Authorization 標頭。
• Microsoft Foundry：依照其區塊所示使用 ANTHROPIC_FOUNDRY_API_KEY

​

Amazon Bedrock

export ANTHROPIC_BEDROCK_BASE_URL=https://llm-gateway.example.com/bedrock
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1
export CLAUDE_CODE_USE_BEDROCK=1

$env:ANTHROPIC_BEDROCK_BASE_URL = "https://llm-gateway.example.com/bedrock"
$env:CLAUDE_CODE_SKIP_BEDROCK_AUTH = "1"
$env:CLAUDE_CODE_USE_BEDROCK = "1"

​

Google Cloud’s Agent Platform

export ANTHROPIC_VERTEX_BASE_URL=https://llm-gateway.example.com/vertex
export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id
export CLAUDE_CODE_SKIP_VERTEX_AUTH=1
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5

$env:ANTHROPIC_VERTEX_BASE_URL = "https://llm-gateway.example.com/vertex"
$env:ANTHROPIC_VERTEX_PROJECT_ID = "your-gcp-project-id"
$env:CLAUDE_CODE_SKIP_VERTEX_AUTH = "1"
$env:CLAUDE_CODE_USE_VERTEX = "1"
$env:CLOUD_ML_REGION = "us-east5"

• 個別模型區域：若閘道從 CLOUD_ML_REGION 以外的區域提供某些模型，請為每個模型設定對應的 VERTEX_REGION_CLAUDE_* 變數，例如 VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1。環境變數參考列出了確切名稱。
• 模型版本：依照固定模型版本中的說明固定 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL 與 ANTHROPIC_DEFAULT_HAIKU_MODEL。設定 ANTHROPIC_DEFAULT_HAIKU_MODEL 也會將工作階段標題等背景任務移至該模型，該節也說明了在其他情況下由哪個模型執行這些任務。
• 模型功能：若您固定的模型 ID 是您的 Claude Code 版本無法辨識的，effort 等級或延伸思考等功能可能會在該模型上維持停用。請使用 ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES 及其 Sonnet 與 Haiku 對應變數宣告模型支援的功能。

​

Microsoft Foundry

export ANTHROPIC_FOUNDRY_BASE_URL=https://llm-gateway.example.com/foundry
export ANTHROPIC_FOUNDRY_API_KEY=sk-gateway-key
export CLAUDE_CODE_USE_FOUNDRY=1

$env:ANTHROPIC_FOUNDRY_BASE_URL = "https://llm-gateway.example.com/foundry"
$env:ANTHROPIC_FOUNDRY_API_KEY = "sk-gateway-key"
$env:CLAUDE_CODE_USE_FOUNDRY = "1"

​

Claude Platform on AWS

export ANTHROPIC_AWS_BASE_URL=https://llm-gateway.example.com/anthropic-aws
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

$env:ANTHROPIC_AWS_BASE_URL = "https://llm-gateway.example.com/anthropic-aws"
$env:ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN"
$env:CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH = "1"
$env:CLAUDE_CODE_USE_ANTHROPIC_AWS = "1"

​

確認供應商路由

API provider: Amazon Bedrock
Bedrock base URL: https://llm-gateway.example.com/bedrock
AWS auth skipped

​

故障排除閘道錯誤

​

相關資源

• LLM 閘道概述：什麼是閘道以及它如何與 claude.ai 訂閱互動
• 為您的組織推出 LLM 閘道：部署和分發閘道配置的面向管理員的檢查清單
• 閘道協議參考：Claude Code 發送到閘道的內容，包括閘道必須轉發的標頭和欄位
• 設定：設定檔案的位置以及如何讀取 env 區塊
• 身份驗證：認證變數、apiKeyHelper 和 OAuth 登入如何互動