2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> 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.3> Use this file to discover all available pages before exploring further.
4 4
5# LLM gateway設定5# LLM gateway
6 6
7> Claude CodeをLLM gatewayソリューションと連携するための設定方法を学びます。gateway要件、認証設定、モデル選択、プロバイダー固有のエンドポイント設定をカバーしています。7> Claude Code を LLM gateway 経由でルーティングして、集中型認証、使用状況追跡、コスト管理を実現します。Claude Code をゲートウェイに接続する方法、組織向けのロールアウト、Claude Code がゲートウェイに送信する内容、ゲートウェイと claude.ai サブスクリプションの相互作用について説明します。
8 8
9LLM gatewayは、Claude Codeとモデルプロバイダー間の集中型プロキシレイヤーを提供し、以下のような機能をしばしば提供します：9LLM gateway は、Claude Code とモデルプロバイダー間に組織が実行するプロキシです。Claude Code は API トラフィックをゲートウェイに送信し、ゲートウェイは組織が管理する認証情報を使用してプロバイダーにそれを転送します。
10 10
11* **集中型認証** - API キー管理の単一ポイント11このページでは、以下について説明します：
12* **使用状況追跡** - チームとプロジェクト全体での使用状況の監視
13* **コスト管理** - 予算とレート制限の実装
14* **監査ログ** - コンプライアンスのためのすべてのモデル相互作用の追跡
15* **モデルルーティング** - コード変更なしでプロバイダー間の切り替え
16 12
17このページでは、Claude Code CLI のgateway要件と設定について説明します。Enterprise Desktop デプロイメントは、[管理設定](https://support.claude.com/ja/articles/12622667-enterprise-configuration)を通じてgatewayプロバイダーを設定できます。Claude Desktop アプリは、[Cowork on 3P research preview](https://claude.com/docs/cowork/3p/gateway)を通じて自己ホスト型gatewayに対して実行することもでき、これは独自の設定キーを使用します。13* [ゲートウェイが提供するもの](#what-a-gateway-provides)
18 14* [ルーティングと認証情報の仕組み](#how-a-gateway-works)
19<h2 id="gateway-requirements">15* [ロールアウトの手順](#roll-out-a-gateway)
20 Gateway要件16* [ゲートウェイと claude.ai サブスクリプションの相互作用](#subscriptions-and-gateways)
21</h2>17* [ゲートウェイとは別に設定されるもの](#configure-separately-from-the-gateway)
22
23LLM gatewayがClaude Codeと連携するには、以下の要件を満たす必要があります：
24
25**API形式**
26
27gatewayは、クライアントに対して以下のAPI形式の少なくとも1つを公開する必要があります：
28
291. **Anthropic Messages**: `/v1/messages`、`/v1/messages/count_tokens`
30 * リクエストヘッダーを転送する必要があります：`anthropic-beta`、`anthropic-version`
31
322. **Bedrock InvokeModel**: `/invoke`、`/invoke-with-response-stream`
33 * リクエストボディフィールドを保持する必要があります：`anthropic_beta`、`anthropic_version`
34
353. **Vertex rawPredict**: `:rawPredict`、`:streamRawPredict`、`/count-tokens:rawPredict`
36 * リクエストヘッダーを転送する必要があります：`anthropic-beta`、`anthropic-version`
37
38ヘッダーの転送またはボディフィールドの保持に失敗すると、機能が低下したり、Claude Code機能を使用できなくなる可能性があります。
39 18
40<Note>19<Note>
41 Claude Codeは、API形式に基づいて有効にする機能を決定します。Anthropic Messages形式をBedrocまたはVertexで使用する場合、環境変数 `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` を設定する必要があります。20 - 既存のゲートウェイに接続する開発者の場合：[Claude Code をゲートウェイに接続](/ja/llm-gateway-connect)
21 - 組織向けのゲートウェイをロールアウトする管理者の場合：[ゲートウェイをデプロイして配布](/ja/llm-gateway-rollout)
22 - ゲートウェイ製品を設定している場合：[ゲートウェイプロトコルリファレンス](/ja/llm-gateway-protocol)
42</Note>23</Note>
43 24
44**リクエストヘッダー**25<h2 id="what-a-gateway-provides">
45 26 ゲートウェイが提供するもの
46Claude Codeは、すべてのAPI リクエストに以下のヘッダーを含めます：
47
48| ヘッダー | 説明 |
49| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------- |
50| `X-Claude-Code-Session-Id` | 現在のClaude Codeセッションの一意の識別子。プロキシはこれを使用して、リクエストボディを解析することなく、単一セッションからのすべてのAPI リクエストを集約できます。 |
51| `X-Claude-Code-Agent-Id` | リクエストを発行したサブエージェントまたはチームメイトの識別子。プロキシはこれを使用して、リクエストボディを解析することなく、セッション内の個別の並列サブエージェントにAPI コストを属性付けできます。インプロセスサブエージェントまたはチームメイトによって発行されたリクエストの場合のみ存在します。 |
52| `X-Claude-Code-Parent-Agent-Id` | リクエストを行うエージェントを生成したエージェントの識別子。これを `X-Claude-Code-Agent-Id` と共に使用して、プロキシ内のネストされたエージェント全体にAPI コストを属性付けします。リクエストするエージェント自体が別のエージェントによって生成された場合のみ存在します。 |
53
54両方のエージェントIDヘッダーは、永続的なユーザーまたはデバイスIDではなく、スポーン単位の一時的な識別子です。
55
56Claude Codeはまた、クライアントバージョンと会話から派生したフィンガープリントを含む短い帰属ブロックをシステムプロンプトの前に付加します。Anthropic APIはこのブロックを処理前に削除するため、ファーストパーティプロンプトキャッシングには影響しません。gatewayが完全なリクエストボディをキーとしたプロンプトキャッシュを実装している場合は、[`CLAUDE_CODE_ATTRIBUTION_HEADER=0`](/ja/env-vars)を設定して、それを省略してください。
57
58<h2 id="configuration">
59 設定
60</h2>27</h2>
61 28
62<h3 id="model-selection">29ゲートウェイは、組織が以下を管理する 1 つの場所を提供します：
63 モデル選択
64</h3>
65
66デフォルトでは、Claude Code は選択した API 形式の標準モデル名を使用します。
67 30
68`ANTHROPIC_BASE_URL` が Anthropic Messages 形式を公開するゲートウェイを指している場合、Claude Code はスタートアップ時にゲートウェイの `/v1/models` エンドポイントをクエリし、返されたモデルを `/model` ピッカーに追加できます。`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` を設定して、この機能を有効にしてください。検出はデフォルトでオフになっており、共有 API キーでバックアップされたゲートウェイが、キーがアクセスできるすべてのモデルをすべてのユーザーに表示しないようにします。検出された各エントリは「From gateway」というラベルが付けられ、レスポンスから提供されている場合は `display_name` フィールドを使用します。これには Claude Code v2.1.129 以降が必要です。31* **認証情報**：プロバイダーキーはサーバー側に留まり、開発者はゲートウェイ認証情報を保持します
32* **使用状況追跡**：リクエストを処理するプロバイダーに関係なく、開発者またはチームごとに使用状況を属性付けします
33* **コスト管理**：予算とレート制限を 1 つの場所で実施します
34* **監査ログ**：コンプライアンスのためにすべてのモデルリクエストをログに記録します
35* **プロバイダー切り替え**：開発者マシンに触れることなく、ゲートウェイ設定でプロバイダーを変更します
69 36
70検出は Anthropic Messages 形式にのみ適用されます。Bedrock または Vertex パススルーエンドポイントでは実行されず、`ANTHROPIC_BASE_URL` が設定されていない場合または `api.anthropic.com` を指している場合にも実行されません。37プロバイダー切り替え以外のすべてが、アップストリームが Anthropic の API であるか[クラウドプロバイダー](/ja/third-party-integrations)であるかに関わらず適用されます。
71 38
72検出リクエストは推論リクエストと同じ方法で認証されます。認証トークンが設定されていない場合は、`ANTHROPIC_AUTH_TOKEN` をベアラートークンとして、または `ANTHROPIC_API_KEY` を `x-api-key` ヘッダーとして送信し、`ANTHROPIC_CUSTOM_HEADERS` からのヘッダーと共に送信されます。ID が `claude` または `anthropic` で始まるモデルのみがピッカーに追加されます。結果は `~/.claude/cache/gateway-models.json` にキャッシュされ、スタートアップのたびに更新されます。リクエストが失敗するか、ゲートウェイが `/v1/models` を実装していない場合、ピッカーは前回のスタートアップからのキャッシュリストまたは組み込みモデルリストにフォールバックします。39トレードオフとして、ゲートウェイは組織が運用するインフラストラクチャになります。Claude Code は各リリースで機能を追加し、ゲートウェイがそれらを転送しない場合、対応する機能が破損するため、Claude Code の進化に合わせてゲートウェイ製品を最新に保つ必要があります。[ゲートウェイプロトコルリファレンス](/ja/llm-gateway-protocol)では、何を転送するかについて説明しています。
73 40
74ゲートウェイが検出フィルターと一致しないモデル名を使用している場合は、[モデル設定](/ja/model-config)に記載されている環境変数を使用して、手動で追加してください。41<h2 id="how-a-gateway-works">
75 42 ゲートウェイの仕組み
76<h2 id="litellm-configuration">
77 LiteLLM 設定
78</h2>43</h2>
79 44
80<Warning>45デフォルトでは、Claude Code は `api.anthropic.com` の Anthropic API に直接リクエストを送信します。ゲートウェイ経由でルーティングするには、`ANTHROPIC_BASE_URL` をゲートウェイのアドレスに設定します。Claude Code は代わりにそこに同じリクエストを送信します。ゲートウェイは開発者を認証し、組織のプロバイダー認証情報を添付し、各リクエストを設定されているプロバイダーに転送します。
81 LiteLLM PyPI バージョン 1.82.7 および 1.82.8 は、認証情報を盗むマルウェアで侵害されました。これらのバージョンをインストールしないでください。既にインストールしている場合：
82
83 * パッケージを削除してください
84 * 影響を受けたシステムのすべての認証情報をローテーションしてください
85 * [BerriAI/litellm#24518](https://github.com/BerriAI/litellm/issues/24518)の修復手順に従ってください
86
87 LiteLLM はサードパーティのプロキシサービスです。Anthropic は、LiteLLM のセキュリティまたは機能を推奨、保守、または監査していません。このガイドは情報提供目的で提供されており、古くなる可能性があります。自己判断で使用してください。
88</Warning>
89
90<h3 id="prerequisites">
91 前提条件
92</h3>
93
94* Claude Code が最新バージョンに更新されている
95* LiteLLM Proxy Server がデプロイされてアクセス可能
96* 選択したプロバイダーを通じて Claude モデルへのアクセス
97
98<h3 id="basic-litellm-setup">
99 基本的な LiteLLM セットアップ
100</h3>
101
102**Claude Code を設定する**：
103
104<h4 id="authentication-methods">
105 認証方法
106</h4>
107 46
108<h5 id="static-api-key">47`ANTHROPIC_BASE_URL` はほとんどのゲートウェイのアドレス変数です。Bedrock、Vertex、Foundry、または AWS 上の Claude Platform など、特定のクラウドプロバイダーの前に立つゲートウェイは、代わりにそのプロバイダーのベース URL 変数を使用します。[API 形式](/ja/llm-gateway-protocol#api-formats)では、各設定でどの変数が使用されるかを示しています。
109 静的 API キー
110</h5>
111 48
112固定 API キーを使用した最も簡単な方法：49<Frame>
50 <img src="https://mintcdn.com/claude-code/zIcIE_SQv4Z0Zbhc/images/llm-gateway-flow.svg?fit=max&auto=format&n=zIcIE_SQv4Z0Zbhc&q=85&s=490607d033d235694efb49a73a5b9e4b" 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" />
51</Frame>
113 52
114```bash theme={null}532 種類の認証情報が関係しています：
115# 環境で設定
116export ANTHROPIC_AUTH_TOKEN=sk-litellm-static-key
117 54
118# または Claude Code 設定で55* **開発者認証情報**：各開発者が保持する独自のもので、ゲートウェイによって発行されます。ゲートウェイに対して認証し、使用状況追跡で開発者を識別します
119{56* **プロバイダー認証情報**：ゲートウェイが保持する、プロバイダーアカウント用の 1 つの認証情報で、転送されるすべてのトラフィックで共有されます。開発者ごとにプロバイダーキーをプロビジョニングしません
120 "env": {
121 "ANTHROPIC_AUTH_TOKEN": "sk-litellm-static-key"
122 }
123}
124```
125 57
126この値は `Authorization` ヘッダーとして送信されます。58ゲートウェイは、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 はゲートウェイとのみ通信するため、プロバイダーの選択はクライアントではなくゲートウェイの設定です。
127 59
128<h5 id="dynamic-api-key-with-helper">60<h2 id="roll-out-a-gateway">
129 ヘルパーを使用した動的 API キー61 ゲートウェイをロールアウトする
130</h5>62</h2>
131
132キーのローテーションまたはユーザーごとの認証の場合：
133
1341. API キーヘルパースクリプトを作成します：
135
136```bash theme={null}
137#!/bin/bash
138# ~/bin/get-litellm-key.sh
139
140# 例：vault からキーを取得
141vault kv get -field=api_key secret/litellm/claude-code
142
143# 例：JWT トークンを生成
144jwt encode \
145 --secret="${JWT_SECRET}" \
146 --exp="+1h" \
147 '{"user":"'${USER}'","team":"engineering"}'
148```
149
1502. ヘルパーを使用するように Claude Code 設定を構成します：
151
152```json theme={null}
153{
154 "apiKeyHelper": "~/bin/get-litellm-key.sh"
155}
156```
157
1583. トークンリフレッシュ間隔を設定します：
159
160```bash theme={null}
161# 1 時間ごとにリフレッシュ（3600000 ms）
162export CLAUDE_CODE_API_KEY_HELPER_TTL_MS=3600000
163```
164
165この値は `Authorization` および `X-Api-Key` ヘッダーとして送信されます。`apiKeyHelper` は `ANTHROPIC_AUTH_TOKEN` または `ANTHROPIC_API_KEY` より優先度が低くなります。
166
167<h4 id="unified-endpoint-recommended">
168 統合エンドポイント（推奨）
169</h4>
170
171LiteLLM の[Anthropic 形式エンドポイント](https://docs.litellm.ai/docs/anthropic_unified)を使用：
172
173```bash theme={null}
174export ANTHROPIC_BASE_URL=https://litellm-server:4000
175```
176
177**統合エンドポイントのパススルーエンドポイント上での利点：**
178
179* ロードバランシング
180* フェイルオーバー
181* コスト追跡とエンドユーザー追跡の一貫したサポート
182
183<h4 id="provider-specific-pass-through-endpoints-alternative">
184 プロバイダー固有のパススルーエンドポイント（代替）
185</h4>
186
187<h5 id="claude-api-through-litellm">
188 LiteLLM を通じた Claude API
189</h5>
190
191[パススルーエンドポイント](https://docs.litellm.ai/docs/pass_through/anthropic_completion)を使用：
192 63
193```bash theme={null}64組織に LLM gateway をロールアウトする準備ができたら、選択するゲートウェイ製品に関わらず、シーケンスは同じです：
194export ANTHROPIC_BASE_URL=https://litellm-server:4000/anthropic
195```
196 65
197<h5 id="amazon-bedrock-through-litellm">661. ゲートウェイをデプロイし、転送するリクエストを認証できるようにプロバイダー認証情報を提供します。
198 LiteLLM を通じた Amazon Bedrock672. 各開発者にゲートウェイ認証情報を発行し、使用状況が開発者に属性付けられ、オフボーディングが 1 つの認証情報を取り消すようにします。
199</h5>683. [管理設定ファイル](/ja/settings#settings-files)とシークレットツーリングを通じて設定を配布し、すべてのマシンがベース URL と認証情報を受け取るようにします。両方が配布されると、開発者は何も設定しません。設定配布が整っていない場合、開発者は[接続ページ](/ja/llm-gateway-connect)に従って変数を自分で設定します。
694. 各開発者に[Claude Code で設定を確認](/ja/llm-gateway-connect#check-for-an-existing-configuration)させ、配布の問題がゲートウェイに依存する前に表面化するようにします。
200 70
201[パススルーエンドポイント](https://docs.litellm.ai/docs/pass_through/bedrock)を使用：71[組織向けの LLM gateway をロールアウト](/ja/llm-gateway-rollout)では、各ステップを説明し、各ステップで配布する設定ファイルを示しています。ゲートウェイは組織セットアップの 1 つの部分です。ポリシー実施、使用状況の可視性、データ処理の決定については、[組織向けに Claude Code をセットアップ](/ja/admin-setup)を参照してください。
202 72
203```bash theme={null}73<h2 id="third-party-gateways">
204export ANTHROPIC_BEDROCK_BASE_URL=https://litellm-server:4000/bedrock74 サードパーティゲートウェイ
205export CLAUDE_CODE_SKIP_BEDROCK_AUTH=175</h2>
206export CLAUDE_CODE_USE_BEDROCK=1
207```
208 76
209<h5 id="google-vertex-ai-through-litellm">77[サポートされている API 形式](/ja/llm-gateway-protocol#api-formats)を公開するゲートウェイはすべて機能します。Anthropic は、サードパーティゲートウェイ製品を推奨、保守、または監査していません。独自のドキュメントに従ってデプロイし、[ロールアウト手順](/ja/llm-gateway-rollout)で Claude Code 側のロールアウトを完了します。
210 LiteLLM を通じた Google Vertex AI
211</h5>
212 78
213[パススルーエンドポイント](https://docs.litellm.ai/docs/pass_through/vertex_ai)を使用：79<h2 id="subscriptions-and-gateways">
80 サブスクリプションとゲートウェイ
81</h2>
214 82
215```bash theme={null}83[ゲートウェイ認証情報変数](/ja/llm-gateway-connect#set-the-credential-variable)または `apiKeyHelper` がアクティブな場合、開発者の claude.ai サブスクリプションは使用されません：認証情報がそのセッションのサブスクリプションログインを置き換え、サブスクリプションの使用制限は適用されません。そのトラフィックは、ゲートウェイが転送する認証情報の所有者（組織の Anthropic Console アカウント、またはゲートウェイがそこにルーティングする場合の Bedrock、Vertex、Foundry アカウント）にトークンごとに請求されます。
216export ANTHROPIC_VERTEX_BASE_URL=https://litellm-server:4000/vertex_ai/v1
217export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id
218export CLAUDE_CODE_SKIP_VERTEX_AUTH=1
219export CLAUDE_CODE_USE_VERTEX=1
220export CLOUD_ML_REGION=us-east5
221```
222 84
223<h5 id="claude-platform-on-aws-through-a-gateway">85ゲートウェイ認証情報なしで `ANTHROPIC_BASE_URL` のみを設定しても、サブスクリプションは置き換わりません。リクエストはゲートウェイ経由でルーティングされますが、保存された claude.ai ログインはアクティブな認証情報のままなので、その使用制限と請求が適用されます。このトラフィックを Anthropic に渡すゲートウェイは、`anthropic-beta` の OAuth 機能を転送する必要があります。[リクエストヘッダーリファレンス](/ja/llm-gateway-protocol#request-headers)を参照してください。
224 AWS を通じた Claude Platform
225</h5>
226 86
227[Claude Platform on AWS](/ja/claude-platform-on-aws) エンドポイントに転送するゲートウェイにルーティング：87<h2 id="configure-separately-from-the-gateway">
88 ゲートウェイとは別に設定されるもの
89</h2>
228 90
229```bash theme={null}91ゲートウェイは、モデル API リクエストが送信される場所を決定します。モデル選択、Claude Code の残りのネットワークトラフィック、企業プロキシは別に設定されます：
230export ANTHROPIC_AWS_BASE_URL=https://litellm-server:4000/anthropic-aws
231export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
232export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1
233export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
234```
235 92
236詳細については、[LiteLLM ドキュメント](https://docs.litellm.ai/)を参照してください。93* **モデル選択**：ベース URL は、リクエストが送信される場所を決定し、どのモデルが応答するかではありません。`/model` コマンドまたはモデル環境変数でモデルを選択します。[モデルを設定する方法](/ja/model-config#setting-your-model)を参照してください
94* **クライアント側トラフィック**：バージョンチェックとオプションのクライアントテレメトリ（両方とも [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/ja/env-vars) で無効化）、および claude.ai または Console ログインが使用中の場合のログイントラフィックは、ゲートウェイではなく Anthropic の更新および認証エンドポイントに送信されます。ドメインについては[ネットワークアクセス要件](/ja/network-config#network-access-requirements)を参照してください
95* **企業プロキシ**：`HTTPS_PROXY` で設定されたプロキシは、Claude Code とゲートウェイを含むすべてのサーバー間に位置します。ネットワークがプロキシを必要とする場合は、両方を設定します。[プロキシ設定](/ja/network-config#proxy-configuration)を参照してください
237 96
238<h2 id="additional-resources">97<h2 id="related-pages">
239 追加リソース98 関連ページ
240</h2>99</h2>
241 100
242* [LiteLLMドキュメント](https://docs.litellm.ai/)101* [Claude Code を LLM gateway に接続](/ja/llm-gateway-connect)：自分のマシンでベース URL と認証情報を設定し、サーフェスごとの設定とトラブルシューティングテーブルを含みます
243* [Claude Code設定](/ja/settings)102* [組織向けの LLM gateway をロールアウト](/ja/llm-gateway-rollout)：ゲートウェイをデプロイし、開発者認証情報を発行し、管理設定を配布するための管理者チェックリスト
244* [エンタープライズネットワーク設定](/ja/network-config)103* [ゲートウェイプロトコルリファレンス](/ja/llm-gateway-protocol)：Claude Code がゲートウェイに送信するもの、ゲートウェイを設定する運用者向け、エンドポイント、転送するヘッダー、機能パススルーをカバーしています
245* [サードパーティ統合の概要](/ja/third-party-integrations)104* [組織向けに Claude Code をセットアップ](/ja/admin-setup)：ゲートウェイが 1 つの部分である、ポリシー実施と使用状況の可視性を含む、より広いロールアウト決定
