組織向けの LLM ゲートウェイをロールアウトする

​

前提条件

• インフラストラクチャにデプロイされたゲートウェイ。HTTPS で開発者に配布する正確なアドレスで提供され、リダイレクト先のアドレスではなく、Claude モデル名をプロバイダーにルーティングするように設定されている
• ゲートウェイが転送するプロバイダー認証情報。以下のいずれか。
  • Anthropic API の場合：Claude Consoleから取得した API キー
  • クラウドプロバイダーの場合：モデルアクセス権を持つクラウド認証情報。Amazon Bedrock、Google Vertex AI、または Microsoft Foundryページの前提条件を参照してください
• 開発者マシンに設定ファイルを配信する方法。MDM または設定管理など
  • まだない場合は、設定がデバイスに到達する方法でオプションを比較してください

​

ゲートウェイ要件

• サポートされている API 形式を受け入れる：API 形式テーブルの形式のいずれか。以下のロールアウト手順は、ほとんどのゲートウェイが提供する POST /v1/messages の Anthropic Messages API を想定しています
• レスポンスをストリーミングする：サーバー送信イベントをバッファリングせずに到着時に通す
• Claude モデル名をルーティングする：開発者が使用する各名前をアップストリームモデルにマップする。Claude Code は各リクエストで claude-sonnet-4-6 などのモデル名を送信します。ほとんどのゲートウェイ製品では、マッピングはゲートウェイ自体の設定内のモデルリストまたはルーティングテーブルです
• ヘッダーと本文を変更せずに転送する：anthropic-beta、anthropic-version、およびリクエスト本文を両方向で通す。機能パススルーテーブルは各機能をそれなしで破損するものにマップします
• アップストリームエラーを変更せずに返す：Claude Code の自動復旧はエラーの文言に一致するため、ゲートウェイ独自のエンベロープでエラーをラップすると破損します
• リクエスト本文 WAF 検査からパスを除外する：Claude Code プロンプトはソースコードと XML スタイルのタグを含み、クロスサイトスクリプティング本文ルールに一致します。ゲートウェイの前の WAF は実際のセッションで 403 を返しますが、短いテストリクエストは通ります

​

ロールアウト手順

1. ゲートウェイがモデルをルーティングすることを確認する
2. 各開発者に認証情報を発行する
3. ゲートウェイに対して Claude Code をテストする
4. ベース URL と認証情報を配布する
5. 開発者マシンから検証する

​

ゲートウェイがモデルをルーティングすることを確認する

• <gateway-key> は、現在ゲートウェイを呼び出すことができる認証情報です。管理キー、テストキー、またはすでに発行した独自の開発者キー。すべてのゲートウェイ製品に個別の管理認証情報があるわけではありません。ない場合は、まず 開発者認証情報を発行するで自分用の開発者キーを発行してください
• model はゲートウェイがルーティングするように設定されている Claude モデル名です。例では claude-sonnet-4-6 を使用しています。設定した名前に置き換えてください

curl -X POST "https://llm-gateway.example.com/v1/messages" \
  -H "Authorization: Bearer <gateway-key>" \
  -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 "https://llm-gateway.example.com/v1/messages" `
  -Headers @{ "Authorization" = "Bearer <gateway-key>"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

​

開発者認証情報を発行する

curl -X POST "https://llm-gateway.example.com/v1/messages" \
  -H "Authorization: Bearer <developer-key>" \
  -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 "https://llm-gateway.example.com/v1/messages" `
  -Headers @{ "Authorization" = "Bearer <developer-key>"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

​

ゲートウェイに対して Claude Code をテストする

export ANTHROPIC_BASE_URL=https://llm-gateway.example.com
export ANTHROPIC_AUTH_TOKEN="<developer-key>"

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

claude -p "Reply with one word: connected"

• Not logged in：ゲートウェイログをチェックして 2 つの原因を区別します。空の場合、認証情報がセッションに到達せず、リクエストがマシンを離れません。テストしているシェルでエクスポートを再実行してください。401 本文に x-api-key を示す拒否されたリクエストが表示される場合、ゲートウェイはそのヘッダーでキーを期待しています。ANTHROPIC_API_KEY に切り替えてください
• Failed to authenticate. API Error: 401 は認証情報が送信され、拒否されたことを意味し、ゲートウェイログはどこかを示します。api.anthropic.com またはプロバイダーのエンドポイントに名前を付ける 401 は、ゲートウェイがアップストリームに到達したが、保持するプロバイダー認証情報が拒否されたことを意味するため、開発者キーは機能し、ゲートウェイが保持するプロバイダー認証情報が間違っているか、プレースホルダーです

​

設定を配布する

​

配布する内容

​

マネージド設定を通じて配布する

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://llm-gateway.example.com"
  },
  "apiKeyHelper": "/usr/local/bin/get-gateway-key"
}

• デスクトップアプリはゲートウェイルーティングをマネージド設定ファイルの MDM 配信サードパーティ推論設定からのみ読み取ります。デスクトップセッションもゲートウェイを通じてルーティングするように、マネージド設定と一緒にそのファイルをデプロイします。デスクトップサードパーティ設定ドキュメントと デスクトップゲートウェイドキュメントを参照してください
• CI ランナーは ランナーの環境で ANTHROPIC_BASE_URL と認証情報を設定する必要があります
• マネージド Windows マシン上の WSL は、wslInheritsWindowsSettings が true の場合にのみ Windows マネージド設定を読み取ります

​

開発者に値を自分で設定させる

• ゲートウェイ URL
• 個人認証情報
• 認証情報を入れる変数：ベアラートークンゲートウェイの場合は ANTHROPIC_AUTH_TOKEN、x-api-key ゲートウェイの場合は ANTHROPIC_API_KEY。開発者にどちらかを伝えることで、接続ページで説明されている試行錯誤を節約できます
• 配布する内容テーブルからの条件付き変数。その値を含む

​

ロールアウトを検証する

curl -N -X POST "https://llm-gateway.example.com/v1/messages" \
  -H "Authorization: Bearer <developer-key>" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-4-6", "max_tokens": 16, "stream": true, "messages": [{"role": "user", "content": "count to 3"}]}'

$body = '{"model": "claude-sonnet-4-6", "max_tokens": 16, "stream": true, "messages": [{"role": "user", "content": "count to 3"}]}'
$body | curl.exe -N -X POST "https://llm-gateway.example.com/v1/messages" `
  -H "Authorization: Bearer <developer-key>" `
  -H "anthropic-version: 2023-06-01" `
  -H "content-type: application/json" `
  --data-binary '@-'

• ログインプロンプトは認証情報ギャップを意味します。/status を実行し、Status タブを開きます。Setting sources 行にマネージド設定が含まれていない場合、配布がマシンに到達しませんでした。含まれている場合、開発者認証情報が配布されなかったため、ANTHROPIC_AUTH_TOKEN または apiKeyHelper を設定します
• Failed to authenticate エラーはゲートウェイがリクエストを拒否していることを意味します。そのログは、どの認証情報が失敗したかを示します。ゲートウェイ自体がログする拒否は開発者キーに名前を付けますが、api.anthropic.com またはプロバイダーのエンドポイントからの 401 は、ゲートウェイが保持するプロバイダー認証情報が拒否されたことを意味します
• ゲートウェイが x-api-key ヘッダーでキーを期待する場合、ANTHROPIC_API_KEY として設定されたときの 1 回限りの承認プロンプトは予想されます。ANTHROPIC_AUTH_TOKEN では、プロンプトは表示されず、変数は静かに引き継ぎます。以前に保存された claude.ai ログインはそのセッションでは非アクティブです

​

ゲートウェイを維持する

​

関連リソース

• Claude Code を LLM ゲートウェイに接続する：開発者向けのセットアップ手順。サーフェスごとの設定とトラブルシューティングテーブル。開発者に配布できます
• ゲートウェイプロトコルリファレンス：ゲートウェイオペレーター向けのワイヤコントラクト。エンドポイント、転送するヘッダー、および機能パススルーテーブルをカバーしています
• 設定ファイルと優先度：マネージド、プロジェクト、およびユーザー設定がどのように組み合わさるか、および各プラットフォームでマネージドファイルがどこに行くか
• 組織向けに Claude Code をセットアップする：このゲートウェイが一部である広いロールアウト。ポリシー強制、使用状況の可視性、およびデータ処理を含みます