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

Claude Code を組織の LLM ゲートウェイに指定します。管理者がすでに設定しているかどうかを確認するか、基本 URL と認証情報を自分で設定してから、接続を確認し、ゲートウェイエラーを修正します。

LLM ゲートウェイは、Claude Code とモデルプロバイダーの間に組織が実行するプロキシです。組織がゲートウェイを使用する場合、Claude Code は個人の claude.ai ログインではなく、組織が発行する認証情報を使用してゲートウェイに認証します。

このページは、組織が運用するゲートウェイを通じて Claude Code を実行している開発者向けです。2 つのパスをカバーしています。管理者がすでに設定しているかどうかを確認する場合と、設定していない場合に自分で設定する場合です。

既存の設定を確認する

管理者は、ゲートウェイアドレスと認証情報を管理設定、デバイス管理、または apiKeyHelper を通じて配布できるため、Claude Code は起動時にこれらを自動的に取得します。組織がすでにこれを実施したかどうかを確認するには、以下の手順に従ってください。

Claude Code を起動する

claude を実行してください。セッションではなくログイン画面が開く場合、ゲートウェイ認証情報は配布されていません。以下の自分で設定を参照してください。

Status タブを確認する

Claude Code がログイン画面を表示せずにセッションを開始した場合、/status を実行して Status タブを開き、次の 2 行を確認してください。

Anthropic base URL: このラインはゲートウェイアドレスが設定されている場合にのみ表示されます。表示されていない場合、Claude Code はゲートウェイを指していません。以下の自分で設定を参照してください。
Auth token または API key: ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY、または apiKeyHelper という名前のラインがあれば、ゲートウェイ認証情報がアクティブであることが確認されます。代わりに claude.ai アカウントという名前の Login method ラインが表示される場合は、認証情報が配布されていません。自分で設定してください。

テストメッセージを送信する

/status メニューを閉じて、Claude Code で任意のプロンプトを送信してください。Claude からの通常の応答でエラーがない場合、ゲートウェイ接続が機能していることが確認されます。

/status メニューの両方のラインが正しく見えるが、Claude へのメッセージが失敗する場合は、トラブルシューティングテーブルを参照してください。

Claude Code を自分で設定する

Claude Code をゲートウェイ用に自分で設定するには、ゲートウェイチームから以下が必要です：

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

以下のセクションは設定を順番にカバーしています：

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

認証情報変数を設定する

Claude Code をゲートウェイに認証するには、環境変数に認証情報を設定します。どの変数を使用するかは、ゲートウェイチームが何を言ったかによって異なります：

認証情報を設定する場所	使用する場合
`ANTHROPIC_AUTH_TOKEN`	ゲートウェイチームが「bearer token」または「Authorization header」と言った場合
`ANTHROPIC_API_KEY`	ゲートウェイチームが「API key」または「x-api-key」と言った場合
`apiKeyHelper`	認証情報がローテーションするか、ボルトから来る場合

どの種類かを指定されなかった場合は、ANTHROPIC_AUTH_TOKEN を使用します。以下の検証リクエストは、切り替える必要があるかどうかを判断する方法を示しています。

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

ゲートウェイの基本 URL と、上記で選択した認証情報変数を環境変数として設定します。例は ANTHROPIC_AUTH_TOKEN を使用しています。選択した変数が ANTHROPIC_API_KEY の場合は、それに置き換えてください。シェルで設定できます（1 つのターミナルセッション用）、または Claude Code 設定ファイルで設定できます（Claude Code が実行されるすべての場所で永続化）。

最初の接続の場合、シェルエクスポートから始めて、値を設定ファイルに移動する前に検証リクエストを実行してください。

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

ゲートウェイチームが提供した値に置き換えます：

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"

シェルエクスポートはそのターミナルセッションと、そこから開始されたプログラムにのみ適用されます。ドックまたはスタートメニューから起動されたエディターはそれらを見ません。新しいターミナル全体で値を永続化するには、同じ行をシェルプロファイル（~/.zshrc、~/.bashrc、PowerShell $PROFILE など）に追加してください。

ゲートウェイをシェルのみでエクスポートする場合、supervisorによってホストされるバックグラウンドエージェントに確実に到達しません。各バックグラウンドセッションがゲートウェイをどのようにソースするかを参照してください。バックグラウンドエージェントが常にルーティングする必要があるゲートウェイには、設定ファイルを使用してください。

設定ファイルで設定する

Claude Code が実行されるすべての場所で設定を適用し、バックグラウンドエージェントを含めるには、シェルに依存するのではなく、設定ファイルの env ブロックで変数を設定します。設定ファイルはスコープが異なります：

~/.claude/settings.json はすべてのプロジェクトに適用されます。Windows ではパスは %USERPROFILE%\.claude\settings.json です
.claude/settings.local.json は 1 つのプロジェクトに適用されます。Claude Code はそこに設定を保存するときに gitignore に追加します。自分で作成する場合または Claude に書かせる場合は、認証情報を誤ってコミットしないように、最初に gitignore に手動で追加してください

env ブロックはどちらのファイルでも同じように見えます：

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

シェルエクスポートと設定ファイルの env ブロックの両方が同じ変数を設定する場合、設定ファイルの値が適用されます。/status を実行して、Claude Code が使用している基本 URL と認証情報ソースを確認してください。

接続を確認する

シェルで変数をエクスポートした状態で、ゲートウェイに 1 トークンのリクエストを直接送信します。これは Claude Code を開く前に URL と認証情報が機能することを確認するため、失敗はゲートウェイを指し、設定ではなく。以下のコマンドはシェル変数を読み取るため、設定ファイルに値を入れた場合でもシェルエクスポートが必要です。

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": "."}]}'

ゲートウェイが x-api-key ヘッダーのキーを期待する場合、Bash コマンドの Authorization ヘッダーを x-api-key: $ANTHROPIC_API_KEY に置き換えるか、PowerShell コマンドの "Authorization" ハッシュテーブルエントリを "x-api-key" = "$env:ANTHROPIC_API_KEY" に置き換えてください。

{"id":"msg_ で始まり、"content":[...] フィールドを含む JSON レスポンスは、ゲートウェイに到達可能で、認証情報が機能していることを意味します。不明なモデルという名前のエラーでも、ゲートウェイがリクエストを認証してからモデル名を拒否したため、URL と認証情報が機能していることを証明します。このテストのためにゲートウェイが提供するモデルを見つける必要はありません。401 は認証情報が拒否されたことを意味します。変数を推測した場合は、もう一方に切り替えて再度エクスポートしてください。

Claude Code で確認する

同じシェルから claude を起動して、エクスポートを継承し、メッセージを送信して、/status を実行します。

Status タブで、Anthropic base URL 行はゲートウェイアドレスを表示する必要があり、リクエストがそこにルーティングされていることを確認します。行がない場合、変数がセッションに到達しませんでした。Auth token または API key 行が設定した変数という名前は、保存された claude.ai ログインではなく、ゲートウェイ認証情報がアクティブであることを確認します。

メッセージが失敗するか、/status がゲートウェイ URL を表示しない場合は、以下のトラブルシューティングテーブルを参照してください。

認証情報変数がヘッダーにマップされる方法

各変数は認証情報を異なる HTTP ヘッダーで送信します：ANTHROPIC_AUTH_TOKEN は Authorization: Bearer で、ANTHROPIC_API_KEY は x-api-key で、apiKeyHelper は両方で。間違った変数の認証情報はゲートウェイが読まないヘッダーに到達し、リクエストは 401 で失敗します。検証リクエストが 401 を返した場合、もう一方の変数に切り替えて再度試してください。

ゲートウェイ認証情報変数は、保存された claude.ai ログインまたは Console キーより優先されます。claude.ai ログインは保存されたままで、変数が設定されている間は使用されません。変数を設定解除すると、Claude Code はそれに戻ります。ANTHROPIC_AUTH_TOKEN では、変数は直ちに優先されます。ANTHROPIC_API_KEY では、キーが引き継ぐ前に、インタラクティブモードで 1 回承認するよう求められます。

/status を実行して、どの認証情報ソースがアクティブかを確認します。起動が 2 つのソースという名前の認証競合警告を表示する場合は、トラブルシューティングテーブルの最初の行を参照して、どちらを削除するかを確認してください。保存されたログインをクリアしてゲートウェイ認証情報のみを残すには、/logout を実行してください。

各サーフェスを設定する

CLI は上記の環境変数と設定ファイルを読み取ります。他のサーフェスは VS Code 拡張機能、デスクトップアプリ、GitHub Actions、Agent SDK、Slack やウェブなどのクラウドサーフェスです。以下のセクションは、これらの設定が各サーフェスに到達するかどうかをカバーしています。

VS Code 拡張機能

VS Code 拡張機能のゲートウェイ変数を VS Code 独自のユーザー設定で claudeCode.environmentVariables に設定します。Preferences: Open User Settings (JSON) コマンドで開きます。拡張機能は起動前にこの設定から認証情報をチェックするため、ゲートウェイ認証情報の信頼できる場所です。~/.claude/settings.json の値は生成されたプロセスに到達しますが、拡張機能独自のログインチェックには到達しません。

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

デスクトップアプリ

デスクトップアプリは、ANTHROPIC_BASE_URL または settings.json ではなく、サードパーティ推論設定からゲートウェイルーティングを読み取ります。その設定は組織から、またはアプリ自体のフォームから来ることができます：

管理者によって配布される：組織が設定を配布している場合、デスクトップアプリはゲートウェイを通じてルーティングされ、設定は不要です
ローカルで設定される：管理者配布設定がないデバイスの場合、Help → Troubleshooting → 開発者モードを有効化を開きます。これはアプリを再起動して開発者メニューを表示します。その後、Developer → Configure Third-Party Inference を開き、ゲートウェイベース URL を入力します。管理者配布設定が優先され、このフォームを読み取り専用にします

ゲートウェイ設定がアクティブな場合、デスクトップアプリはローカルマシンのみでセッションを実行します。環境ピッカーは SSH セッションまたは Anthropic ホスト型クラウド環境を提供せず、Remote Controlは利用できません。ゲートウェイを通じてリモートホストで Claude Code を使用するには、そのホストで CLI を実行し、ANTHROPIC_BASE_URL とゲートウェイ認証情報を設定します。

デスクトップアプリが Gateway was unreachable を表示する場合、アプリは起動時に設定されたベース URL に到達できませんでした。URL とネットワークパスを上記の curl テストで確認してください。

GitHub Actions

Claude Code GitHub Actions はワークフローの env ブロックから ANTHROPIC_BASE_URL と ANTHROPIC_CUSTOM_HEADERS を読み取ります。認証情報をアクションの anthropic_api_key 入力として渡します。アクションはそれを ANTHROPIC_API_KEY として設定するため、x-api-key ヘッダーでゲートウェイに到達します。

x-api-key ゲートウェイの場合、env でベース URL を設定し、ゲートウェイキーを入力として渡します：

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

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

bearer token ゲートウェイの場合、同じシークレットをアクションの anthropic_api_key 入力とワークフロー env ブロックの ANTHROPIC_AUTH_TOKEN の両方として渡します。アクションは Claude Code を起動する前に anthropic_api_key、CLAUDE_CODE_OAUTH_TOKEN、またはワークロード ID フェデレーションが必要で、ANTHROPIC_AUTH_TOKEN を読み取らないため、入力はその起動チェックを満たすためだけのものです。env 変数はゲートウェイが読む Authorization ヘッダーにキーを入れます。x-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 }}

アクションの他の認証オプション（CLAUDE_CODE_OAUTH_TOKEN やワークロード ID フェデレーションを含む）については、Claude Code GitHub Actions とアクションの README を参照してください。

Agent SDK

Agent SDK にはゲートウェイ固有のオプションはありません。生成する Claude Code プロセスに環境変数を渡します。各 SDK は生成されたプロセスの環境を設定する env オプションを受け入れ、TypeScript と Python 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

Slack の Claude Code とクラウドセッションは常に Anthropic の API を使用します。ゲートウェイデプロイメントの一部ではありません。クラウドセッションの環境設定で設定されたゲートウェイ変数は適用されません。トラフィックがゲートウェイに留まる必要がある場合、これらのユーザーに対してこれらのサーフェスを有効にしないでください。

Remote Control と音声ディクテーションは両方とも claude.ai ID に依存します。Remote Control はライブセッションをアカウントとペアリングし、音声ディクテーションは claude.ai トランスクリプションエンドポイントに到達します。ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、または apiKeyHelper がアクティブな間は利用できません。Remote Control は ANTHROPIC_BASE_URL が Anthropic 以外のホストを指している場合も無効になるため、claude.ai でサインインするだけでは十分ではありません。v2.1.196 より前では、Anthropic 以外のベース URL は Remote Control をブロックしませんでした。

どちらかの機能を復元するには、claude.ai でログインし、その機能がチェックするゲートウェイ変数を設定解除してください。claude doctor の Remote Control セクションは、現在 Remote Control をブロックしているものを示します。

音声ディクテーション：ゲートウェイ認証情報を設定解除する
Remote Control：ゲートウェイ認証情報と ANTHROPIC_BASE_URL を設定解除する

追加設定

これらの設定は、ベース URL と認証情報を超えたケースに対応します。管理者の指示、ネットワークの出力ルール、またはトラブルシューティング表で必要とされる場合にのみ設定してください。

追加ヘッダーを送信する

一部のゲートウェイは、認証情報に加えて、テナント識別子やルーティングキーなどのカスタムヘッダーを使用してリクエストをルーティングまたはタグ付けします。これを送信するには、ANTHROPIC_CUSTOM_HEADERSを 1 行に 1 つのName: Valueペアで設定します。以下の例は、X-Org-Routeという名前のルーティングヘッダーを追加します。

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

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

設定ファイルのenvブロックでANTHROPIC_CUSTOM_HEADERSを設定することもできます。JSON 文字列は複数行にまたがることができないため、ペア間で\nを使用します。

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

これらのようなルーティングおよびテナントヘッダー名は、承認が必要なヘッダーとしてカウントされます。ヘッダーがプロジェクト設定ファイルから取得される場合、Claude Code はenv値を適用する場合のルールに従ってそれらを適用します。

ゲートウェイモデルをモデルピッカーに追加する

モデルディスカバリーが有効な場合、Claude Code はスタートアップ時にゲートウェイにモデルリストをクエリし、それらの名前を組み込みエントリと共に/modelピッカーに追加します。あなたまたは管理者がmodelPickerラインアップでreplaceBuiltInOptionsを設定した場合、Claude Code は検出された名前も非表示にします。セッションが既に使用しているモデルの行は保持されます。

ゲートウェイが Claude Code の組み込みリストにないモデル名を提供し、ピッカーから選択したい場合は、これを有効にします。組み込みモデルが使用するものである場合、ディスカバリーは不要です。管理者がマネージド設定を通じて既に有効にしている可能性もあります。

有効にするには、シェルまたは~/.claude/settings.jsonのenvブロックでCLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1を設定します。

検出されたモデルは追加の/modelエントリとして表示されます。各エントリは、ゲートウェイが提供するモデルの説明、またはゲートウェイが提供しない場合はFrom gatewayを表示します。

ディスカバリーが実行されたことを確認するには、claude --debugを開始し、~/.claude/debug/<session-id>.txtのデバッグログで[gatewayDiscovery]行を探します。ディスカバリーが初めて成功すると、Claude Code はキャッシュしたモデル数をログに記録し、ゲートウェイのリストが変更された場合にのみ再度ログに記録します。404、タイムアウト、またはリダイレクトもそこに表示されます。ディスカバリーが実行される場合、フィルタリング内容、およびゲートウェイが提供する応答形式については、モデルディスカバリーリファレンスを参照してください。

apiKeyHelper で認証情報をローテーションする

apiKeyHelperは、静的環境変数から読み取る代わりに、ゲートウェイ認証情報を取得するために Claude Code が実行するコマンドです。

認証情報がスケジュールに従って期限切れになる場合、コンテナまたは SSO コマンドから取得される場合、または管理者が設定を指示した場合は、ヘルパーを使用します。認証情報が一度設定する固定文字列である場合、認証情報変数で十分であり、このセクションをスキップできます。

ヘルパーは、現在の認証情報を stdout に出力する任意のシェルコマンドです。Claude Code はシステムシェルを通じて実行するため、Windows ではそれは実行可能ファイルまたは PowerShell 呼び出しです。コマンドが認証情報以外に何も出力しないようにします。Claude Code v2.1.227 以降では、キーと一緒に出力されるバナーまたはログ行により、ヘルパーが失敗します。スクリプトを作成し、実行可能にして、設定ファイルのapiKeyHelperから参照します。

例えば、コンテナから読み取るスクリプト：

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

~/.claude/settings.jsonでそのパスを参照します：

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

例えば、コンテナから読み取るスクリプト：

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

%USERPROFILE%\.claude\settings.jsonで PowerShell 呼び出しを参照し、JSON 文字列内のバックスラッシュをエスケープします：

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

Claude Code はデフォルトでヘルパーの出力を 5 分間キャッシュし、キャッシュの有効期限が経過した後にヘルパーを再実行します。有効期限を変更するには、ミリ秒単位でCLAUDE_CODE_API_KEY_HELPER_TTL_MSを設定します。例えば、15 分の場合はCLAUDE_CODE_API_KEY_HELPER_TTL_MS=900000です。

Claude Code がヘルパーを再実行する他のケースについては、apiKeyHelperを参照してください。

ヘルパーの値はAuthorizationとx-api-keyの両方のヘッダーで送信されるため、ゲートウェイがどちらのヘッダーを読み取るかに関わらず機能します。

ゲートウェイパス外のトラフィックをオフにする

ゲートウェイはモデルリクエストを処理しますが、Claude Code はゲートウェイパス外の非必須バックグラウンドトラフィックも Anthropic および GitHub などのサードパーティサービスに送信します。バージョンチェック、テレメトリ、リリースノート、および同様のリクエストです。ゲートウェイへの出力のみを許可するネットワークでは、これらのリクエストが失敗し、出力監視に接続がブロックされたものとして表示される可能性があります。

Claude Code は、リクエストが認証情報が属するホストに送信される場合にのみ、テレメトリまたは使用メトリクスリクエストに認証情報を添付します。ANTHROPIC_BASE_URLがゲートウェイを指している間、Claude Code はテレメトリイベントをゲートウェイ認証情報なしで Anthropic に送信します。認証情報変数またはapiKeyHelperも有効な場合、Claude Code はコンソール分析ダッシュボードに使用メトリクスを報告しません。v2.1.246 より前では、Claude Code はゲートウェイ認証情報をテレメトリおよび使用メトリクスリクエストに添付して Anthropic ホストに送信する可能性がありました。モデルリクエストは常にゲートウェイが期待する認証情報を使用してゲートウェイに送信されました。

そのトラフィックをオフにするには、ゲートウェイ変数と同じシェルエクスポートまたは設定ファイルのenvブロックでCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1を設定します。

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

変数を設定すると、以下の効果と制限があります。

自動更新が無効になるため、パッケージマネージャーやマネージド配布などの別の更新パスを計画してください。
高速モードの可用性チェックが抑制されます。前のチェックがマシンで高速モードを既に有効にしていない限り、/fastは高速モードが利用できないと報告します。
ゲートウェイモデルディスカバリーには影響しません。これはゲートウェイのみをクエリします。v2.1.257 より前では、変数はディスカバリーのリフレッシュも停止したため、ピッカーは以前キャッシュされたリストを保持していました。
WebFetch ツールのドメイン安全チェックは影響を受けず、引き続きapi.anthropic.comを呼び出します。ネットワークがそのホストをブロックする場合は、設定でskipWebFetchPreflight: trueを使用して個別にオフにします。
各テレメトリストリームとそれを制御する変数については、テレメトリサービスを参照してください。

ゲートウェイを通じてクラウドプロバイダーにルーティングする

これらの設定は、ANTHROPIC_BASE_URLの代わりにプロバイダー固有のベース URL 変数を通じてゲートウェイを指すように Claude Code を設定します。Amazon Bedrock および Google Cloud の Agent Platform ゲートウェイはそれらのプロバイダーのネイティブリクエスト形式を受け入れます。Microsoft Foundry および AWS 上の Claude Platform ゲートウェイは Anthropic Messages 形式を受け入れます。Amazon Bedrock および Google Cloud の Agent Platform ルートでは、Claude Code はベータヘッダーとリクエストフィールドをそのプロバイダーが受け入れるセットに制限します。各ルートでゲートウェイが受け取るものについては、ゲートウェイ互換性ガイドを参照してください。

ゲートウェイチームが Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または AWS 上の Claude Platform を具体的に指定した場合にのみ、1 つを使用します。上記の検証リクエストが JSON を返した場合、このセクションをスキップできます。

ゲートウェイチームが指定したプロバイダーのブロックを設定します。Amazon Bedrock、Google Cloud の Agent Platform、および AWS 上の Claude Platform ブロック内のスキップ認証変数は、ゲートウェイがそれらを保持しているため、Claude Code にクラウドプロバイダーの認証情報でリクエストに署名しないよう指示します。ゲートウェイが独自のトークンも必要とする場合、それを配置する場所はプロバイダーによって異なります。

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

ゲートウェイが独自の認証情報を発行する場合、AWS_BEARER_TOKEN_BEDROCKを設定しないままにします。設定した場合、Claude Code はCLAUDE_CODE_SKIP_BEDROCK_AUTHが設定されていても、ゲートウェイトークンの代わりにそのAmazon Bedrock API キーをAuthorizationヘッダーとして送信します。

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

プロジェクト ID とリージョンを独自の値に置き換えます。Claude Code はゲートウェイに送信する各リクエストのパスに両方を含めます。

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"

ブロックはルーティングと認証をカバーします。Agent Platform セットアップからのリージョンオーバーライドとモデルピンはゲートウェイを通じても適用されます。

モデルごとのリージョン：ゲートウェイが一部のモデルを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

ゲートウェイの認証情報をANTHROPIC_FOUNDRY_API_KEYに入れます。これはx-api-keyヘッダーとしてゲートウェイに送信されます。ベアラートークンを期待するゲートウェイは、代わりにANTHROPIC_FOUNDRY_AUTH_TOKENを使用できます。Claude Code はその値をAuthorization: Bearerヘッダーとして送信し、両方が設定されている場合はANTHROPIC_FOUNDRY_API_KEYよりも優先されます。Claude Code v2.1.203 以降が必要です。

独自のAuthorizationヘッダーを挿入するゲートウェイの場合、CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1を設定し、両方の認証情報変数を設定しないままにします。Claude Code はその後、Azure 認証情報なしでリクエストを送信し、例えばANTHROPIC_CUSTOM_HEADERSを通じて提供するAuthorizationヘッダーを保持します。v2.1.203 より前では、API キーなしでCLAUDE_CODE_SKIP_FOUNDRY_AUTHを使用すると、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

ワークスペース ID については、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"

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

設定したブロックがあるシェルからclaudeを開始し、/statusを実行します。Amazon Bedrock ブロックでは、Statusタブに以下のような行が表示されます。

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

他のブロックは、例えば Google Cloud の Agent Platform の場合はVertex base URLとGCP auth skippedなど、プロバイダーの名前の下に同じ行を生成します。Microsoft Foundry ブロックは、CLAUDE_CODE_SKIP_FOUNDRY_AUTHを設定した場合にのみ認証スキップ行を表示します。企業プロキシを通じてルーティングする場合、Proxy行はプロキシ URL を表示します。ベース URL 行が見つからない場合、変数がセッションに到達しませんでした。

ゲートウェイエラーのトラブルシューティング

ゲートウェイを通じて Claude Code を実行する場合の最も一般的なエラーで、ゲートウェイ側の原因と修正方法です：

エラー	原因	修正
2 つの認証情報ソースという名前の起動警告で、`auth may not work as expected` で終わります。古いバージョンは代わりに `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` を表示します。	ゲートウェイ認証情報と保存されたログインの両方がアクティブです。変数はリクエストに使用されますが、古いログインは予期しない認証動作を引き起こす可能性があります	変数を設定解除して保存されたログインを使用するか、`/logout` を実行してゲートウェイ認証情報を使用します
無効または認識されないトークンという名前の `401` エラー	認証情報はゲートウェイが発行したものではないか、ゲートウェイが読むヘッダーにあります	認証情報テーブルで変数が認証情報の種類と一致することを確認し、ゲートウェイで失効した場合はキーを再生成します
`Your apiKeyHelper script is failing`、または非対話型モードで stderr に `apiKeyHelper failed:`	`apiKeyHelper` 設定のコマンドが使用可能なキーを生成しなかったため、リクエストはプレースホルダーキーを含みます	コマンドを直接実行して失敗の理由を確認し、期限切れセッションを報告する場合は認証情報プロバイダーで再認証します。エラーリファレンスを参照してください
アドレスで何も応答しない場合は `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)`、またはホスト名が解決しない場合は `Can't reach the API server — check your internet or DNS (ENOTFOUND)`。多くの場合、Claude Code がバックオフで再試行している間の静かな一時停止の後です。括弧内のコードは異なります。Unable to connect to API はコードのスペルと以前の表現をカバーしています	基本 URL で何も応答しません。アドレスが間違っているか、VPN またはファイアウォールがゲートウェイへのパスをブロックしています	上記の curl テストを実行します。これは同じ原因で直ちに失敗し、URL とネットワークパスをゲートウェイチームで確認します
`API returned an empty or malformed response (HTTP 200)`	ゲートウェイまたは中間プロキシが非 API レスポンス（多くの場合 HTML エラーまたはログインページ）を返しました	上記の curl リクエストでテストします。Claude API レスポンス以外で応答するゲートウェイルートを修正します。エラーリファレンスはメッセージが報告する詳細を説明しています
`context_management`、`Extra inputs are not permitted`、または他の認識されないフィールドという名前の `400` エラー	ゲートウェイは Anthropic 形式エンドポイントに Claude Code が送信するフィールドを拒否する上流にリクエストを転送します	`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` を設定します。これはほとんどのプレリリースフィールドを抑制します。機能パススルーを参照してください。一部のベータはこのフラグでゲートされていません。それらについては、一致する `CLAUDE_CODE_USE_*` プロバイダー変数を設定して、Claude Code がそのプロバイダーが受け入れるもののみを送信するようにします
`thinking` または `adaptive` という名前の `400` エラー（`Input tag 'adaptive' found` など）	上流モデルビルドは Claude Code が Claude 4.6 以降のモデルに要求する適応推論を受け入れません	ゲートウェイの上流をアップグレードします。Opus 4.6 と Sonnet 4.6 では、代わりに `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` が機能します。モデル設定機能変数は、`CLAUDE_CODE_USE_BEDROCK` や `CLAUDE_CODE_USE_VERTEX` などのプロバイダー設定にのみ適用され、`ANTHROPIC_BASE_URL` ゲートウェイの背後には適用されません
ゲートウェイ独自の言葉でコンテキストまたはトークン制限を述べる `400` エラー（`ContextWindowExceededError` または `prompt token count of N exceeds the limit of M` など）	ゲートウェイはモデルのネイティブウィンドウより小さいコンテキストを強制し、上流エラーを書き直すため、Claude Code は長すぎるエラーとして認識せず、自動的にコンパクト化して再試行しません	`/compact` を実行してセッションを復旧します。防ぐには、`CLAUDE_CODE_AUTO_COMPACT_WINDOW` をゲートウェイの制限に設定します。Claude Code は値を少なくとも 100,000 トークン、最大でもモデルのコンテキストウィンドウにクランプするため、100,000 未満のゲートウェイ制限は一致できず、`/compact` はそこでの復旧のままです。また、`CLAUDE_CODE_MAX_OUTPUT_TOKENS` をゲートウェイモデルの出力制限より下に設定します
Claude Code v2.1.265 から v2.1.267 で、ツールの入力スキーマまたはその `pattern` を拒否するゲートウェイ独自の言葉での `400` エラー	これらのバージョンでの段階的なロールアウトで、Artifact ツールスキーマは `\p{...}` Unicode 文字クラスを持つ正規表現を含みます。Anthropic API はそれを受け入れますが、各ツールスキーマの `pattern` を独自の正規表現エンジンでチェックするゲートウェイまたは上流は、リクエスト全体を拒否します	v2.1.268 以降に更新します。これは正規表現を送信しません。影響を受けるバージョンでは、アーティファクトをオフにします。これはツールとそのスキーマをリクエストから削除します
`400` エラーがすべてのリクエストで、ゲートウェイ独自の言葉で認識されないツールタイプを拒否します。例えば `Input tag 'advisor_20260301'`。Claude Code v2.1.275	そのバージョンでの段階的なロールアウトで、リクエストはアドバイザーがオフの場合でもアドバイザーツールエントリを含みます。Anthropic API はそれを受け入れますが、ツールタイプを検証するゲートウェイまたは上流はリクエスト全体を拒否します。リクエスト本体フィールドを変更せずに転送するものはそれを影響を受けずに通します。エントリは会話コンテンツを含まない宣言です	v2.1.276 以降に更新します。これは `ANTHROPIC_BASE_URL` ゲートウェイの背後でエントリを送信しません。アドバイザーをオンにしない限り。v2.1.275 では、`CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`を設定します。これはリクエストからエントリを削除します
`/model` ピッカーから欠落しているモデル	ゲートウェイモデル名は Claude Code の組み込みリストにありません。または Claude Code は組み込みオプションを置き換える `modelPicker` ラインアップを表示しています	ゲートウェイモデル検出を有効にするか、モデル設定変数で名前を追加します。Claude Code が置き換える `modelPicker` ラインアップを表示している場合は、ゲートウェイモデルをそれに追加するか、管理設定がそれを提供する場合は管理者に追加を依頼します
推論リクエストが機能している間に `/fast` が `Fast mode unavailable due to network connectivity issues` を報告します	高速モードの可用性チェックは `api.anthropic.com` に直接移動し、`ANTHROPIC_BASE_URL` に従いません。そのため、ブロックされた直接エグレスはチェックに失敗します。チェックが `ANTHROPIC_API_KEY` からゲートウェイ発行キーまたは `apiKeyHelper` を提示し、Anthropic がそれを拒否する場合、同じメッセージが開いたネットワークに表示されます	エグレスがブロックされている場合は `api.anthropic.com` をホワイトリストに登録するか、スキップ変数を設定します。拒否されたゲートウェイキーの場合のみ、スキップ変数が役立ちます。プロキシと LLM ゲートウェイの背後で高速モードを使用するを参照してください
`ANTHROPIC_AUTH_TOKEN` で認証されたセッションで `/fast` が `Fast mode has been disabled by your organization` を報告します。組織が高速モードを有効にしている場合でも	可用性チェックには claude.ai ログインまたは Anthropic API キーが必要です。ベアラートークンのみの場合、Claude Code は高速モードをチェックを送信せずに無効として扱います	`CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` を設定します。プロキシと LLM ゲートウェイの背後で高速モードを使用するを参照してください
curl テストが成功しても、Claude Code はログインするよう求めます	CLI には独自の認証情報がありません。到達可能な基本 URL は 1 つではなく、対話型セッションではプロジェクトの `.claude/settings.json` または `.claude/settings.local.json` の `env` ブロックは最初の実行ウィザードと信頼プロンプトの後にのみ適用されます	`ANTHROPIC_AUTH_TOKEN` を Claude Code が最初の実行セットアップの前に読み取る場所に設定します。シェルエクスポート、`~/.claude/settings.json` の `env` ブロック、または管理設定
`ANTHROPIC_API_KEY` が設定されていますが、プロンプトなしで無視されます	キーはインタラクティブセッションで 1 回の承認が必要で、以前に拒否されたキーは再度尋ねられずに無視されます	`/config` で `Use custom API key` オプションで有効にします
`This machine's managed settings require a first-party login`	管理設定に `forceLoginMethod` または `forceLoginOrgUUID` が含まれています。これは `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` と共存できません	管理者は管理設定から `forceLoginMethod` と `forceLoginOrgUUID` を削除してゲートウェイ認証情報を使用するか、ゲートウェイ認証情報を削除してファーストパーティログインを使用する必要があります。2 つは組み合わせることはできません
`403` と HTML 本体（`403 Forbidden` など）。ゲートウェイ独自のログに受信したリクエストがない場合	ゲートウェイの前の Web アプリケーションファイアウォールまたはリバースプロキシがゲートウェイに到達する前にリクエスト本体をブロックしました。Claude Code プロンプトには XML スタイルタグとソースコードが含まれており、クロスサイトスクリプティング本体ルールと一致するため、短い curl テストは成功しますが、実際のセッションは成功しません	ゲートウェイの `/v1/messages` パスをリクエスト本体検査から除外します。AWS WAF ではこれは `CrossSiteScripting_Body` マネージドルールです。nginx と ModSecurity では、同等の OWASP CRS 本体ルールです
証明書または TLS エラー（`SSL certificate verification failed` または `Self-signed certificate detected` など）。curl テストが成功する場合	Claude Code のランタイムは `curl` が使用するのと同じ認証局を信頼していません。一般的に企業 TLS 検査プロキシの背後	`NODE_EXTRA_CA_CERTS` を CA バンドルパスに設定します。CA 証明書ストアを参照してください

ゲートウェイ設定を削除した後、Claude Code が繰り返しログインするよう求める場合、原因は通常、ゲートウェイではなく認証情報ストレージです。認証エラーを参照してください。

LLM ゲートウェイの概要：ゲートウェイとは何か、および claude.ai サブスクリプションとどのように相互作用するか
組織用の LLM ゲートウェイをロールアウトする：ゲートウェイをデプロイして配布するための管理者向けチェックリスト
ゲートウェイ互換性ガイド：Claude Code がゲートウェイに送信するもの。ゲートウェイが転送する必要があるヘッダーとフィールドを含む
設定：設定ファイルが存在する場所と env ブロックがどのように読み取られるか
認証：認証情報変数、apiKeyHelper、OAuth ログインがどのように相互作用するか

llm-gateway-connect.md 2026-09-21 22:59 UTC to 2026-09-22 23:59 UTC

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

既存の設定を確認する

Claude Code を起動する

Status タブを確認する

テストメッセージを送信する

Claude Code を自分で設定する

認証情報変数を設定する

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

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

設定ファイルで設定する

接続を確認する

Claude Code で確認する

認証情報変数がヘッダーにマップされる方法

各サーフェスを設定する

VS Code 拡張機能

デスクトップアプリ

GitHub Actions

Agent SDK

Slack、クラウドセッション、Remote Control

追加設定

追加ヘッダーを送信する

ゲートウェイモデルをモデルピッカーに追加する

apiKeyHelper で認証情報をローテーションする

ゲートウェイパス外のトラフィックをオフにする

ゲートウェイを通じてクラウドプロバイダーにルーティングする

Amazon Bedrock

Google Cloud の Agent Platform

Microsoft Foundry

AWS 上の Claude Platform

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

ゲートウェイエラーのトラブルシューティング

llm-gateway-connect.md +2 −1

llm-gateway-connect.md 2026-09-21 22:59 UTC to 2026-09-22 23:59 UTC

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

既存の設定を確認する

Claude Code を起動する

Status タブを確認する

テストメッセージを送信する

Claude Code を自分で設定する

認証情報変数を設定する

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

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

設定ファイルで設定する

接続を確認する

Claude Code で確認する

認証情報変数がヘッダーにマップされる方法

既存のログインとの競合

各サーフェスを設定する

VS Code 拡張機能

デスクトップアプリ

GitHub Actions

Agent SDK

Slack、クラウドセッション、Remote Control

追加設定

追加ヘッダーを送信する

ゲートウェイモデルをモデルピッカーに追加する

apiKeyHelper で認証情報をローテーションする

ゲートウェイパス外のトラフィックをオフにする

ゲートウェイを通じてクラウドプロバイダーにルーティングする

Amazon Bedrock

Google Cloud の Agent Platform

Microsoft Foundry

AWS 上の Claude Platform

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

ゲートウェイエラーのトラブルシューティング

関連リソース