將 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；如果您自己建立它，請先手動將其添加到 gitignore，以免您不小心提交您的認證

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

​

驗證連接

curl -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。管理員分發的配置優先，並使此表單為唯讀

​

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 報告快速模式不可用。
• 它關閉閘道模型發現，儘管發現查詢閘道本身。之前發現的模型仍可從本地緩存獲得，但列表不會刷新。
• WebFetch 工具的域安全檢查不受影響，仍會呼叫 api.anthropic.com。如果您的網路阻止該主機，請在設定中使用 skipWebFetchPreflight: true 單獨關閉它。
• 對於每個遙測流和控制它的變數，請參閱遙測服務。

​

通過閘道路由到雲端提供者

​

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 的 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"

​

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"

​

AWS 上的 Claude Platform

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"

​

故障排除閘道錯誤

​

相關資源

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