llm-gateway.md +0 −96 deleted
File Deleted View Diff
1> ## Documentation Index
2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.
4
5# LLM gateway
6
7> Claude Code を LLM gateway 経由でルーティングして、集中型認証、使用状況追跡、コスト管理を実現します。Claude Code をゲートウェイに接続する方法、組織向けのロールアウト、Claude Code がゲートウェイに送信する内容、ゲートウェイと claude.ai サブスクリプションの相互作用について説明します。
8
9LLM gateway は、Claude Code とモデルプロバイダー間に組織が実行するプロキシです。Claude Code は API トラフィックをゲートウェイに送信し、ゲートウェイは組織が管理する認証情報を使用してプロバイダーにそれを転送します。
10
11<Note>
12 * 既存のゲートウェイに接続する開発者の場合：[Claude Code をゲートウェイに接続](/ja/llm-gateway-connect)
13 * 組織向けのゲートウェイをロールアウトする管理者の場合：[ゲートウェイをデプロイして配布](/ja/llm-gateway-rollout)
14 * ゲートウェイ製品を設定している場合：[ゲートウェイプロトコルリファレンス](/ja/llm-gateway-protocol)
15</Note>
16
17<h2 id="what-a-gateway-provides">
18 ゲートウェイが提供するもの
19</h2>
20
21ゲートウェイは、組織が以下を管理する 1 つの場所を提供します：
22
23* **認証情報**：プロバイダーキーはサーバー側に留まり、開発者はゲートウェイ認証情報を保持します
24* **使用状況追跡**：リクエストを処理するプロバイダーに関係なく、開発者またはチームごとに使用状況を属性付けします
25* **コスト管理**：予算とレート制限を 1 つの場所で実施します
26* **監査ログ**：コンプライアンスのためにすべてのモデルリクエストをログに記録します
27* **プロバイダー切り替え**：開発者マシンに触れることなく、ゲートウェイ設定でプロバイダーを変更します
28
29プロバイダー切り替え以外のすべてが、アップストリームが Anthropic の API であるか[クラウドプロバイダー](/ja/third-party-integrations)であるかに関わらず適用されます。
30
31トレードオフとして、ゲートウェイは組織が運用するインフラストラクチャになります。Claude Code は各リリースで機能を追加し、ゲートウェイがそれらを転送しない場合、対応する機能が破損するため、Claude Code の進化に合わせてゲートウェイ製品を最新に保つ必要があります。[ゲートウェイプロトコルリファレンス](/ja/llm-gateway-protocol)では、何を転送するかについて説明しています。
32
33<h2 id="how-a-gateway-works">
34 ゲートウェイの仕組み
35</h2>
36
37デフォルトでは、Claude Code は `api.anthropic.com` の Anthropic API に直接リクエストを送信します。ゲートウェイ経由でルーティングするには、`ANTHROPIC_BASE_URL` をゲートウェイのアドレスに設定します。Claude Code は代わりにそこに同じリクエストを送信します。ゲートウェイは開発者を認証し、組織のプロバイダー認証情報を添付し、各リクエストを設定されているプロバイダーに転送します。
38
39`ANTHROPIC_BASE_URL` はほとんどのゲートウェイのアドレス変数です。Bedrock、Vertex、Foundry、または AWS 上の Claude Platform など、特定のクラウドプロバイダーの前に立つゲートウェイは、代わりにそのプロバイダーのベース URL 変数を使用します。[API 形式](/ja/llm-gateway-protocol#api-formats)では、各設定でどの変数が使用されるかを示しています。
40
41<Frame>
42 <img src="https://mintcdn.com/claude-code/-uq-4JE0W_JO5Er5/images/llm-gateway-flow.svg?fit=max&auto=format&n=-uq-4JE0W_JO5Er5&q=85&s=1c1a8dcc0cfcc3a58652cc8e28cd3e20" alt="Claude Code が LLM gateway 経由でルーティングされることを示す図。開発者マシンゾーンでは、Claude Code CLI、VS Code 拡張機能、CI またはエージェント SDK クライアントがゲートウェイにリクエストを送信し、ゲートウェイの API 形式のベース URL 変数がそれを指し、各開発者が開発者ごとの認証情報を保持し、デスクトップアプリは組織が配布した設定を通じて同じゲートウェイに到達します。あなたのインフラストラクチャというラベルが付いたゾーンでは、LLM gateway が認証、使用状況追跡、予算、ルーティングを処理し、組織の認証情報を使用してリクエストを転送します。モデルプロバイダーゾーンでは、実線矢印が設定したプロバイダー（Anthropic API として表示）に向かい、破線矢印が他のプロバイダーオプション（Amazon Bedrock、Google Vertex AI、Microsoft Foundry の例として示されている）に向かいます。" width="780" height="322" data-path="images/llm-gateway-flow.svg" />
43</Frame>
44
452 種類の認証情報が関係しています：
46
47* **開発者認証情報**：各開発者が保持する独自のもので、ゲートウェイによって発行されます。ゲートウェイに対して認証し、使用状況追跡で開発者を識別します
48* **プロバイダー認証情報**：ゲートウェイが保持する、プロバイダーアカウント用の 1 つの認証情報で、転送されるすべてのトラフィックで共有されます。開発者ごとにプロバイダーキーをプロビジョニングしません
49
50ゲートウェイは、Anthropic API、[Amazon Bedrock](/ja/amazon-bedrock)、[Google Vertex AI](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry)、または[AWS 上の Claude Platform](/ja/claude-platform-on-aws) など、設定したプロバイダーにリクエストを転送します。Claude Code はゲートウェイとのみ通信するため、プロバイダーの選択はクライアントではなくゲートウェイの設定です。
51
52<h2 id="roll-out-a-gateway">
53 ゲートウェイをロールアウトする
54</h2>
55
56組織に LLM gateway をロールアウトする準備ができたら、選択するゲートウェイ製品に関わらず、シーケンスは同じです：
57
581. ゲートウェイをデプロイし、転送するリクエストを認証できるようにプロバイダー認証情報を提供します。
592. 各開発者にゲートウェイ認証情報を発行し、使用状況が開発者に属性付けられ、オフボーディングが 1 つの認証情報を取り消すようにします。
603. [管理設定ファイル](/ja/settings#settings-files)とシークレットツーリングを通じて設定を配布し、すべてのマシンがベース URL と認証情報を受け取るようにします。両方が配布されると、開発者は何も設定しません。設定配布が整っていない場合、開発者は[接続ページ](/ja/llm-gateway-connect)に従って変数を自分で設定します。
614. 各開発者に[Claude Code で設定を確認](/ja/llm-gateway-connect#check-for-an-existing-configuration)させ、配布の問題がゲートウェイに依存する前に表面化するようにします。
62
63[組織向けの LLM gateway をロールアウト](/ja/llm-gateway-rollout)では、各ステップを説明し、各ステップで配布する設定ファイルを示しています。ゲートウェイは組織セットアップの 1 つの部分です。ポリシー実施、使用状況の可視性、データ処理の決定については、[組織向けに Claude Code をセットアップ](/ja/admin-setup)を参照してください。
64
65<h2 id="third-party-gateways">
66 サードパーティゲートウェイ
67</h2>
68
69[サポートされている API 形式](/ja/llm-gateway-protocol#api-formats)を公開するゲートウェイはすべて機能します。Anthropic は、サードパーティゲートウェイ製品を推奨、保守、または監査していません。独自のドキュメントに従ってデプロイし、[ロールアウト手順](/ja/llm-gateway-rollout)で Claude Code 側のロールアウトを完了します。
70
71<h2 id="subscriptions-and-gateways">
72 サブスクリプションとゲートウェイ
73</h2>
74
75[ゲートウェイ認証情報変数](/ja/llm-gateway-connect#set-the-credential-variable)または `apiKeyHelper` がアクティブな場合、開発者の claude.ai サブスクリプションは使用されません：認証情報がそのセッションのサブスクリプションログインを置き換え、サブスクリプションの使用制限は適用されません。そのトラフィックは、ゲートウェイが転送する認証情報の所有者（組織の Anthropic Console アカウント、またはゲートウェイがそこにルーティングする場合の Bedrock、Vertex、Foundry アカウント）にトークンごとに請求されます。
76
77ゲートウェイ認証情報なしで `ANTHROPIC_BASE_URL` のみを設定しても、サブスクリプションは置き換わりません。リクエストはゲートウェイ経由でルーティングされますが、保存された claude.ai ログインはアクティブな認証情報のままなので、その使用制限と請求が適用されます。このトラフィックを Anthropic に渡すゲートウェイは、`anthropic-beta` の OAuth 機能を転送する必要があります。[リクエストヘッダーリファレンス](/ja/llm-gateway-protocol#request-headers)を参照してください。
78
79<h2 id="configure-separately-from-the-gateway">
80 ゲートウェイとは別に設定されるもの
81</h2>
82
83ゲートウェイは、モデル API リクエストが送信される場所を決定します。モデル選択、Claude Code の残りのネットワークトラフィック、企業プロキシは別に設定されます：
84
85* **モデル選択**：ベース URL は、リクエストが送信される場所を決定し、どのモデルが応答するかではありません。`/model` コマンドまたはモデル環境変数でモデルを選択します。[モデルを設定する方法](/ja/model-config#setting-your-model)を参照してください
86* **クライアント側トラフィック**：バージョンチェックとオプションのクライアントテレメトリ（両方とも [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/ja/env-vars) で無効化）、および claude.ai または Console ログインが使用中の場合のログイントラフィックは、ゲートウェイではなく Anthropic の更新および認証エンドポイントに送信されます。ドメインについては[ネットワークアクセス要件](/ja/network-config#network-access-requirements)を参照してください
87* **企業プロキシ**：`HTTPS_PROXY` で設定されたプロキシは、Claude Code とゲートウェイを含むすべてのサーバー間に位置します。ネットワークがプロキシを必要とする場合は、両方を設定します。[プロキシ設定](/ja/network-config#proxy-configuration)を参照してください
88
89<h2 id="related-pages">
90 関連ページ
91</h2>
92
93* [Claude Code を LLM gateway に接続](/ja/llm-gateway-connect)：自分のマシンでベース URL と認証情報を設定し、サーフェスごとの設定とトラブルシューティングテーブルを含みます
94* [組織向けの LLM gateway をロールアウト](/ja/llm-gateway-rollout)：ゲートウェイをデプロイし、開発者認証情報を発行し、管理設定を配布するための管理者チェックリスト
95* [ゲートウェイプロトコルリファレンス](/ja/llm-gateway-protocol)：Claude Code がゲートウェイに送信するもの、ゲートウェイを設定する運用者向け、エンドポイント、転送するヘッダー、機能パススルーをカバーしています
96* [組織向けに Claude Code をセットアップ](/ja/admin-setup)：ゲートウェイが 1 つの部分である、ポリシー実施と使用状況の可視性を含む、より広いロールアウト決定