Skip to main content
このセクションでは、Claude apps gateway ではなく、組織が既に実行しているゲートウェイ製品を使用する方法について説明します。ゲートウェイとは何か、Claude Code とプロバイダー間にどのように位置するか、Claude apps gateway と別の製品のどちらを選択するかについては、ゲートウェイの概要を参照してください。
サポートされている API 形式を公開するゲートウェイはすべて機能します。Anthropic は、サードパーティゲートウェイ製品を推奨、保守、または監査していません。また、任意のゲートウェイを通じて Claude Code を非 Claude モデルにルーティングすることはサポートしていません。ゲートウェイを独自のドキュメントに従ってデプロイしてから、以下のロールアウト手順で Claude Code 側を完了してください。

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

ゲートウェイは、組織が以下を管理する 1 つの場所を提供します:
  • 認証情報:プロバイダーキーはサーバー側に留まり、開発者はゲートウェイ認証情報を保持します
  • 使用状況追跡:リクエストを処理するプロバイダーに関係なく、開発者またはチームごとに使用状況を属性付けします
  • コスト管理:予算とレート制限を 1 つの場所で実施します
  • 監査ログ:コンプライアンスのためにすべてのモデルリクエストをログに記録します
  • プロバイダー切り替え:開発者マシンに触れることなく、ゲートウェイ設定でプロバイダーを変更します
プロバイダー切り替え以外のすべてが、アップストリームが Anthropic の API であるかクラウドプロバイダーであるかに関わらず適用されます。プロバイダー切り替えが開発者マシンの再設定なしで機能するには、アップストリームに関わらず、ゲートウェイが単一の Anthropic 形式エンドポイントを公開する必要があります。プロバイダー独自の形式を公開するゲートウェイは、クライアント設定をそのプロバイダーに結び付けます。 トレードオフとして、ゲートウェイは組織が運用するインフラストラクチャになります。Claude Code は各リリースで機能を追加し、ゲートウェイがそれらを転送しない場合、対応する機能が破損するため、Claude Code の進化に合わせてゲートウェイ製品を最新に保つ必要があります。ゲートウェイプロトコルリファレンスでは、何を転送するかについて説明しています。

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

組織に LLM gateway をロールアウトする準備ができたら、選択するゲートウェイ製品に関わらず、シーケンスは同じです:
  1. ゲートウェイをデプロイし、転送するリクエストを認証できるようにプロバイダー認証情報を提供します。
  2. 各開発者にゲートウェイ認証情報を発行し、使用状況が開発者に属性付けられ、オフボーディングが 1 つの認証情報を取り消すようにします。
  3. 管理設定ファイルとシークレットツーリングを通じて設定を配布し、すべてのマシンがベース URL と認証情報を受け取るようにします。両方が配布されると、開発者は何も設定しません。設定配布が整っていない場合、開発者は接続ページに従って変数を自分で設定します。
  4. 各開発者にClaude Code で設定を確認させ、配布の問題がゲートウェイに依存する前に表面化するようにします。
組織向けの LLM gateway をロールアウトでは、各ステップを説明し、各ステップで配布する設定ファイルを示しています。ゲートウェイは組織セットアップの 1 つの部分です。ポリシー実施、使用状況の可視性、データ処理の決定については、組織向けに Claude Code をセットアップを参照してください。

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

ゲートウェイ認証情報変数または apiKeyHelper がアクティブな場合、開発者の claude.ai サブスクリプションは使用されません:認証情報がそのセッションのサブスクリプションログインを置き換え、サブスクリプションの使用制限は適用されません。そのトラフィックは、ゲートウェイが転送する認証情報の所有者(組織の Anthropic Console アカウント、またはゲートウェイがそこにルーティングする場合の Bedrock、Agent Platform、または 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 がゲートウェイに送信するもの、ゲートウェイを設定する運用者向け、エンドポイント、転送するヘッダー、機能パススルーをカバーしています