SpyBara
Go Premium

llm-gateway.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 18 additions and 18 deletions.

2026
Thu 1 23:59 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

その他の LLM gateway

組織が既に実行している LLM gateway を通じて Claude Code をルーティングします。Claude Code をゲートウェイに接続する方法、組織向けのロールアウト、Claude Code がゲートウェイに送信する内容について説明します。

このセクションでは、Claude apps gateway ではなく、組織が既に実行しているゲートウェイ製品を使用する方法について説明します。ゲートウェイとは何か、Claude Code とプロバイダー間にどのように位置するか、Claude apps gateway と別の製品のどちらを選択するかについては、ゲートウェイの概要を参照してください。

[!NOTE]

サポートされている API 形式を公開するゲートウェイはすべて機能します。Anthropic は、サードパーティゲートウェイ製品を推奨、保守、または監査していません。また、任意のゲートウェイを通じて Claude Code を非 Claude モデルにルーティングすることはサポートしていません。ゲートウェイを独自のドキュメントに従ってデプロイしてから、以下のロールアウト手順で Claude Code 側を完了してください。

ゲートウェイが提供するもの

ゲートウェイは、組織が以下を管理する 1 つの場所を提供します：

  • 認証情報：プロバイダーキーはサーバー側に留まり、開発者はゲートウェイ認証情報を保持します
  • 使用状況追跡：リクエストを処理するプロバイダーに関係なく、開発者またはチームごとに使用状況を属性付けします
  • コスト管理：予算とレート制限を 1 つの場所で実施します
  • 監査ログ：コンプライアンスのためにすべてのモデルリクエストをログに記録します
  • プロバイダー切り替え：開発者マシンに触れることなく、ゲートウェイ設定でプロバイダーを変更します

プロバイダー切り替え以外のすべてが、アップストリームが Anthropic の API であるかクラウドプロバイダーであるかに関わらず適用されます。プロバイダー切り替えが開発者マシンの再設定なしで機能するには、アップストリームに関わらず、ゲートウェイが単一の Anthropic 形式エンドポイントを公開する必要があります。プロバイダー独自の形式を公開するゲートウェイは、クライアント設定をそのプロバイダーに結び付け、Claude Code が送信する内容と適用するデフォルトが変わります。

トレードオフとして、ゲートウェイは組織が運用するインフラストラクチャになります。Claude Code は各リリースで機能を追加し、ゲートウェイがそれらを転送しない場合、対応する機能が破損するため、Claude Code の進化に合わせてゲートウェイ製品を最新に保つ必要があります。ゲートウェイプロトコルリファレンスでは、何を転送するかについて説明しています。

ゲートウェイをロールアウトする

組織に LLM gateway をロールアウトする準備ができたら、選択するゲートウェイ製品に関わらず、シーケンスは同じです：

  1. ゲートウェイをデプロイし、転送するリクエストを認証できるようにプロバイダー認証情報を提供します。
  2. 各開発者にゲートウェイ認証情報を発行し、使用状況が開発者に属性付けられ、オフボーディングが 1 つの認証情報を取り消すようにします。
  3. 管理設定ファイルとシークレットツーリングを通じて設定を配布し、すべてのマシンがベース URL と認証情報を受け取るようにします。両方が配布されると、開発者は何も設定しません。設定配布が整っていない場合、開発者は接続ページに従って変数を自分で設定します。
  4. 各開発者にClaude Code で設定を確認させ、配布の問題がゲートウェイに依存する前に表面化するようにします。

組織向けの LLM gateway をロールアウトでは、各ステップを説明し、各ステップで配布する設定ファイルを示しています。ゲートウェイは組織セットアップの 1 つの部分です。ポリシー実施、使用状況の可視性、データ処理の決定については、組織向けに Claude Code をセットアップを参照してください。

ANTHROPIC_BASE_URL を通じて到達するゲートウェイを、管理対象マシンが使用できる唯一の宛先にするには、同じ管理設定ファイルで allowedProviders を ["customEndpoint"] に設定し、ゲートウェイの ANTHROPIC_BASE_URL をそのファイルの env ブロックに配置します。Claude Code はその後、Anthropic に直接接続する場合や開発者独自のプロキシを含む他の場所を指すセッションを拒否し、ANTHROPIC_BASE_URL をそこに設定した値でのみ受け入れます。ANTHROPIC_BEDROCK_BASE_URL などのプロバイダー固有のエンドポイント変数を通じて到達するゲートウェイの場合、allowedProviders エントリはどの変数をピン留めするかを指定します。Claude Code v2.1.285 以降が必要です。

サブスクリプションとゲートウェイ

ゲートウェイ認証情報変数または apiKeyHelper がアクティブな場合、リクエストは開発者の claude.ai サブスクリプションログインの代わりにその認証情報を使用し、サブスクリプションの使用制限は適用されません。Claude Code はマシンに保存された claude.ai ログインを保持していますが、それらのリクエストでは送信しません。そのトラフィックは、ゲートウェイが転送する認証情報の所有者（組織の Anthropic Console アカウント、またはゲートウェイがそこにルーティングする場合の Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry アカウント）にトークンごとに請求されます。

ANTHROPIC_BASE_URLは Claude Code をゲートウェイに指し示す変数です。ゲートウェイ認証情報なしでその変数のみを設定しても、サブスクリプションは置き換わりません。リクエストはゲートウェイ経由でルーティングされますが、保存された claude.ai ログインはアクティブな認証情報のままなので、その使用制限と請求が適用されます。このトラフィックを Anthropic に渡すゲートウェイは、anthropic-beta の OAuth 機能を転送する必要があります。リクエストヘッダーリファレンスを参照してください。

関連ページ

  • ゲートウェイの概要：ゲートウェイの仕組みと Claude apps gateway と別の製品のどちらを選択するかについて
  • Claude apps gateway：SSO サインインと OTLP テレメトリを備えた Anthropic の自己ホスト型ゲートウェイ
  • Claude Code を LLM gateway に接続：自分のマシンでベース URL と認証情報を設定し、サーフェスごとの設定とトラブルシューティングテーブルを含みます
  • 組織向けの LLM gateway をロールアウト：ゲートウェイをデプロイし、開発者認証情報を発行し、管理設定を配布するための管理者チェックリスト
  • ゲートウェイプロトコルリファレンス：Claude Code がゲートウェイに送信するもの、ゲートウェイを設定する運用者向け、エンドポイント、転送するヘッダー、機能パススルーをカバーしています