Claude Code を LLM ゲートウェイに接続する

​

既存の設定を確認する

​

Claude Code を自分で設定する

• ゲートウェイの基本 URL
• 認証情報：キーまたはトークン文字列、またはそれを取得するコマンド
  • ゲートウェイチームが認証情報の種類を指定しなかった場合、以下の認証情報変数セクションで試すべきことをカバーしています

• 認証情報変数を設定すると基本 URL と認証情報を設定する：すべてのゲートウェイ接続に必要な 2 つの変数
• 接続を確認する：何かを永続化する前に機能することを確認します
• 各サーフェスを設定する：Claude Code CLI 以外のサーフェス（VS Code など）を使用している場合、ゲートウェイ認証情報で設定する方法を参照してください
• 追加設定：基本 URL と認証情報を超えて一部のゲートウェイが必要とする変数（カスタムヘッダー、認証情報ヘルパー、モデル検出、プロバイダー形式の基本 URL、またはゲートウェイパス外のトラフィックをオフにするなど）。管理者が名前を付けた場合のみこれらを設定するか、ネットワークが出力を制限します

​

認証情報変数を設定する

​

基本 URL と認証情報を設定する

​

シェル環境変数として設定する

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 は 1 つのプロジェクトに適用されます。Claude Code はそこに設定を保存するときに gitignore に追加します。自分で作成する場合または Claude に書かせる場合は、認証情報を誤ってコミットしないように、最初に 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" }
  ]
}

​

デスクトップアプリ

• 管理者によって配布される：組織が設定を配布している場合、デスクトップアプリはゲートウェイを通じてルーティングされ、設定は不要です
• ローカルで設定される：管理者配布設定がないデバイスの場合、Help → Troubleshooting → 開発者モードを有効化を開きます。これはアプリを再起動して開発者メニューを表示します。その後、Developer → Configure Third-Party Inference を開き、ゲートウェイベース 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、クラウドセッション、Remote Control

• 音声ディクテーション：ゲートウェイ認証情報を設定解除する
• Remote Control：ゲートウェイ認証情報と 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 の Agent Platform、または AWS 上の Claude Platform：ブロックの後に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 の 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を設定すると、セッションタイトルなどのバックグラウンドタスクもそのモデルに移動し、そのセクションではそれ以外の場合にどのモデルが実行されるかを説明します。
• モデル機能：Claude Code バージョンが認識しないモデル ID をピン留めする場合、努力レベルや拡張思考などの機能は無効のままになる可能性があります。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"

​

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"

​

プロバイダーのルートを確認する

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 ログインがどのように相互作用するか