19 既存の設定を確認する19 既存の設定を確認する
20</h2>20</h2>
21 21
22管理者は、[管理設定](/docs/ja/settings#settings-files)、デバイス管理、または [`apiKeyHelper`](#rotate-credentials-with-apikeyhelper) を通じてゲートウェイアドレスと認証情報を配布できるため、Claude Code は起動時にそれらを取得し、設定する必要がありません。組織がすでにこれを行ったかどうかを確認するには：22管理者は、ゲートウェイアドレスと認証情報を [管理設定](/docs/ja/managed-settings)、デバイス管理、または [`apiKeyHelper`](#rotate-credentials-with-apikeyhelper) を通じて配布できるため、Claude Code は起動時にこれらを自動的に取得します。組織がすでにこれを実施したかどうかを確認するには、以下の手順に従ってください。
23 23
24<Steps>24<Steps>
25 <Step title="Claude Code を起動する">25 <Step title="Claude Code を起動する">
26 `claude` を実行します。ログイン画面ではなくセッションが開く場合、ゲートウェイ認証情報は配布されていません。以下の[自分で設定](#configure-claude-code-yourself)を参照してください。26 `claude` を実行してください。セッションではなくログイン画面が開く場合、ゲートウェイ認証情報は配布されていません。以下の [自分で設定](#configure-claude-code-yourself) を参照してください。
27 </Step>27 </Step>
28 28
29 <Step title="Status タブを確認する">29 <Step title="Status タブを確認する">
30 Claude Code がログイン画面を表示せずにセッションを開始した場合、`/status` を実行し、**Status** タブを開いて、2 つの行を確認します：30 Claude Code がログイン画面を表示せずにセッションを開始した場合、`/status` を実行して **Status** タブを開き、次の 2 行を確認してください。
31 31
32 * `Anthropic base URL`：この行はゲートウェイアドレスが設定されている場合にのみ表示されます。ない場合、Claude Code はゲートウェイを指していません。以下の[自分で設定](#configure-claude-code-yourself)を参照してください。32 * `Anthropic base URL`: このラインはゲートウェイアドレスが設定されている場合にのみ表示されます。表示されていない場合、Claude Code はゲートウェイを指していません。以下の [自分で設定](#configure-claude-code-yourself) を参照してください。
33 * `Auth token` または `API key`：`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_API_KEY`、または `apiKeyHelper` という名前の行は、ゲートウェイ認証情報がアクティブであることを確認します。代わりに claude.ai アカウントという名前の `Login method` 行は、認証情報が配布されていないことを意味します。[自分で設定](#set-the-credential-variable)してください。33 * `Auth token` または `API key`: `ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_API_KEY`、または `apiKeyHelper` という名前のラインがあれば、ゲートウェイ認証情報がアクティブであることが確認されます。代わりに claude.ai アカウントという名前の `Login method` ラインが表示される場合は、認証情報が配布されていません。[自分で設定](#set-the-credential-variable) してください。
34 </Step>34 </Step>
35 35
36 <Step title="テストメッセージを送信する">36 <Step title="テストメッセージを送信する">
37 `/status` メニューを閉じて、Claude Code で任意のプロンプトを送信します。Claude からの通常の応答でエラーがない場合、ゲートウェイ接続が機能していることを確認します。37 `/status` メニューを閉じて、Claude Code で任意のプロンプトを送信してください。Claude からの通常の応答でエラーがない場合、ゲートウェイ接続が機能していることが確認されます。
38 </Step>38 </Step>
39</Steps>39</Steps>
40 40
41`/status` メニューの両方の行が正しく見えるが、Claude へのメッセージが失敗する場合は、[トラブルシューティングテーブル](#troubleshoot-gateway-errors)を参照してください。41`/status` メニューの両方のラインが正しく見えるが、Claude へのメッセージが失敗する場合は、[トラブルシューティングテーブル](#troubleshoot-gateway-errors) を参照してください。
42 42
43<h2 id="configure-claude-code-yourself">43<h2 id="configure-claude-code-yourself">
44 Claude Code を自分で設定する44 Claude Code を自分で設定する
52 52
53以下のセクションは設定を順番にカバーしています：53以下のセクションは設定を順番にカバーしています：
54 54
55* [認証情報変数を設定する](#set-the-credential-variable)と[基本 URL を設定する](#set-the-base-url-and-credential)：すべてのゲートウェイ接続に必要な 2 つの変数55* [認証情報変数を設定する](#set-the-credential-variable)と[基本 URL と認証情報を設定する](#set-the-base-url-and-credential)：すべてのゲートウェイ接続に必要な 2 つの変数
56* [接続を確認する](#verify-the-connection)：何かを永続化する前に機能することを確認します56* [接続を確認する](#verify-the-connection)：何かを永続化する前に機能することを確認します
57* [各サーフェスを設定する](#configure-each-surface)：Claude Code CLI 以外のサーフェス（VS Code など）を使用している場合、ゲートウェイ認証情報で設定する方法を参照してください57* [各サーフェスを設定する](#configure-each-surface)：Claude Code CLI 以外のサーフェス（VS Code など）を使用している場合、ゲートウェイ認証情報で設定する方法を参照してください
58* [追加設定](#additional-configuration)：基本 URL と認証情報を超えて一部のゲートウェイが必要とする変数（カスタムヘッダー、認証情報ヘルパー、モデル検出、プロバイダー形式の基本 URL、またはゲートウェイパス外のトラフィックをオフにするなど）。管理者が名前を付けた場合のみこれらを設定するか、ネットワークが出力を制限します58* [追加設定](#additional-configuration)：基本 URL と認証情報を超えて一部のゲートウェイが必要とする変数（カスタムヘッダー、認証情報ヘルパー、モデル検出、プロバイダー形式の基本 URL、またはゲートウェイパス外のトラフィックをオフにするなど）。管理者が名前を付けた場合のみこれらを設定するか、ネットワークが出力を制限します
65 65
66| 認証情報を設定する場所 | 使用する場合 |66| 認証情報を設定する場所 | 使用する場合 |
67| :------------------------------------------------------ | :------------------------------------------------------ |67| :------------------------------------------------------ | :------------------------------------------------------ |
68| `ANTHROPIC_AUTH_TOKEN` | ゲートウェイチームが'bearer token'または'Authorization header'と言った場合 |68| `ANTHROPIC_AUTH_TOKEN` | ゲートウェイチームが「bearer token」または「Authorization header」と言った場合 |
69| `ANTHROPIC_API_KEY` | ゲートウェイチームが'API key'または'x-api-key'と言った場合 |69| `ANTHROPIC_API_KEY` | ゲートウェイチームが「API key」または「x-api-key」と言った場合 |
70| [`apiKeyHelper`](#rotate-credentials-with-apikeyhelper) | 認証情報がローテーションするか、ボルトから来る場合 |70| [`apiKeyHelper`](#rotate-credentials-with-apikeyhelper) | 認証情報がローテーションするか、ボルトから来る場合 |
71 71
72どの種類かを指定されなかった場合は、`ANTHROPIC_AUTH_TOKEN` を使用します。以下の[検証リクエスト](#verify-the-connection)は、切り替える必要があるかどうかを判断する方法を示しています。72どの種類かを指定されなかった場合は、`ANTHROPIC_AUTH_TOKEN` を使用します。以下の[検証リクエスト](#verify-the-connection)は、切り替える必要があるかどうかを判断する方法を示しています。
101 </Tab>101 </Tab>
102</Tabs>102</Tabs>
103 103
104シェルエクスポートはそのターミナルセッションと、そこから開始されたプログラムにのみ適用されます。ドックまたはスタートメニューから起動されたエディターはそれらを見ません。新しいターミナル全体で永続化するには、同じ行をシェルプロファイル（`~/.zshrc`、`~/.bashrc`、PowerShell `$PROFILE` など）に追加するか、代わりに設定ファイルを使用してください。104シェルエクスポートはそのターミナルセッションと、そこから開始されたプログラムにのみ適用されます。ドックまたはスタートメニューから起動されたエディターはそれらを見ません。新しいターミナル全体で値を永続化するには、同じ行をシェルプロファイル（`~/.zshrc`、`~/.bashrc`、PowerShell `$PROFILE` など）に追加してください。
105
106ゲートウェイをシェルのみでエクスポートする場合、[supervisor](/docs/ja/agent-view#how-background-sessions-are-hosted)によってホストされるバックグラウンドエージェントに確実に到達しません。[各バックグラウンドセッションがゲートウェイをどのようにソースするか](/docs/ja/agent-view#llm-gateway)を参照してください。バックグラウンドエージェントが常にルーティングする必要があるゲートウェイには、設定ファイルを使用してください。
105 107
106<h4 id="set-in-a-settings-file">108<h4 id="set-in-a-settings-file">
107 設定ファイルで設定する109 設定ファイルで設定する
108</h4>110</h4>
109 111
110Claude Code が実行されるすべての場所で設定を適用し、シェルに依存しないようにするには、[設定ファイル](/docs/ja/settings)の `env` ブロックで変数を設定します。設定ファイルはスコープが異なります：112Claude Code が実行されるすべての場所で設定を適用し、[バックグラウンドエージェント](/docs/ja/agent-view#how-background-sessions-are-hosted)を含めるには、シェルに依存するのではなく、[設定ファイル](/docs/ja/settings)の `env` ブロックで変数を設定します。設定ファイルはスコープが異なります：
111 113
112* `~/.claude/settings.json` はすべてのプロジェクトに適用されます。Windows ではパスは `%USERPROFILE%\.claude\settings.json` です114* `~/.claude/settings.json` はすべてのプロジェクトに適用されます。Windows ではパスは `%USERPROFILE%\.claude\settings.json` です
113* `.claude/settings.local.json` は 1 つのプロジェクトに適用されます。Claude Code はファイルを作成するときに gitignore に追加します。自分で作成する場合は、認証情報を誤ってコミットしないように、最初に gitignore に手動で追加してください115* `.claude/settings.local.json` は 1 つのプロジェクトに適用されます。Claude Code はそこに設定を保存するときに gitignore に追加します。自分で作成する場合または Claude に書かせる場合は、認証情報を誤ってコミットしないように、最初に gitignore に手動で追加してください
114 116
115<Warning>117<Warning>
116 プロジェクトの `.claude/settings.json` に認証情報を入れないでください。このファイルはコミットされ、リポジトリをクローンするすべての人と共有されます。118 プロジェクトの `.claude/settings.json` に認証情報を入れないでください。このファイルはコミットされ、リポジトリをクローンするすべての人と共有されます。
284 ```286 ```
285</CodeGroup>287</CodeGroup>
286 288
287<h3 id="slack-web-and-remote-control">289<h3 id="slack-cloud-sessions-and-remote-control">
288 Slack、ウェブ、Remote Control290 Slack、クラウドセッション、Remote Control
289</h3>291</h3>
290 292
291[Slack の Claude Code](/docs/ja/slack) と [ウェブの Claude Code](/docs/ja/claude-code-on-the-web) は、Anthropic がホストする製品で、常に Anthropic の API を使用します。ゲートウェイデプロイメントの一部ではありません。クラウドセッションの環境設定で設定されたゲートウェイ変数は適用されません。トラフィックがゲートウェイに留まる必要がある場合、これらのユーザーに対してこれらのサーフェスを有効にしないでください。293[Slack の Claude Code](/docs/ja/slack) と [クラウドセッション](/docs/ja/claude-code-on-the-web)は常に Anthropic の API を使用します。ゲートウェイデプロイメントの一部ではありません。クラウドセッションの環境設定で設定されたゲートウェイ変数は適用されません。トラフィックがゲートウェイに留まる必要がある場合、これらのユーザーに対してこれらのサーフェスを有効にしないでください。
292 294
293[Remote Control](/docs/ja/remote-control) と[音声ディクテーション](/docs/ja/voice-dictation)は両方とも claude.ai ID に依存します。Remote Control はライブセッションをアカウントとペアリングし、音声ディクテーションは claude.ai トランスクリプションエンドポイントに到達します。`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` がアクティブな間は利用できません。v2.1.196 以降では、`ANTHROPIC_BASE_URL` が Anthropic 以外のホストを指している場合、Remote Control も無効になるため、claude.ai でサインインするだけでは十分ではありません。295[Remote Control](/docs/ja/remote-control) と[音声ディクテーション](/docs/ja/voice-dictation)は両方とも claude.ai ID に依存します。Remote Control はライブセッションをアカウントとペアリングし、音声ディクテーションは claude.ai トランスクリプションエンドポイントに到達します。`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` がアクティブな間は利用できません。Remote Control は `ANTHROPIC_BASE_URL` が Anthropic 以外のホストを指している場合も無効になるため、claude.ai でサインインするだけでは十分ではありません。v2.1.196 より前では、Anthropic 以外のベース URL は Remote Control をブロックしませんでした。
294 296
295どちらかの機能を復元するには、claude.ai でログインし、チェックするゲートウェイ変数を設定解除してください。`claude doctor` の Remote Control セクションは設定解除する認証情報変数の名前を表示します。297どちらかの機能を復元するには、claude.ai でログインし、その機能がチェックするゲートウェイ変数を設定解除してください。`claude doctor` の Remote Control セクションは、現在 Remote Control をブロックしているものを示します。
296 298
297* 音声ディクテーション：ゲートウェイ認証情報を設定解除する299* 音声ディクテーション：ゲートウェイ認証情報を設定解除する
298* Remote Control：ゲートウェイ認証情報と `ANTHROPIC_BASE_URL` を設定解除する300* Remote Control：ゲートウェイ認証情報と `ANTHROPIC_BASE_URL` を設定解除する
301 追加設定303 追加設定
302</h2>304</h2>
303 305
304これらの設定は基本 URL と認証情報を超えるケースをカバーしています。管理者の指示、ネットワークの出力ルール、または[トラブルシューティングテーブル](#troubleshoot-gateway-errors)が 1 つを呼び出す場合のみこれらを設定します。306これらの設定は、ベース URL と認証情報を超えたケースに対応します。管理者の指示、ネットワークの出力ルール、または[トラブルシューティング表](#troubleshoot-gateway-errors)で必要とされる場合にのみ設定してください。
305 307
306<h3 id="send-additional-headers">308<h3 id="send-additional-headers">
307 追加ヘッダーを送信する309 追加ヘッダーを送信する
308</h3>310</h3>
309 311
310一部のゲートウェイは、テナント識別子またはルーティングキーなど、認証情報に加えてカスタムヘッダーを使用してリクエストをルーティングまたはタグ付けします。1 つを送信するには、[`ANTHROPIC_CUSTOM_HEADERS`](/docs/ja/env-vars) を 1 行あたり 1 つの `Name: Value` ペアで設定します。以下の例は `X-Org-Route` という名前のルーティングヘッダーを追加します：312一部のゲートウェイは、認証情報に加えて、テナント識別子やルーティングキーなどのカスタムヘッダーを使用してリクエストをルーティングまたはタグ付けします。これを送信するには、[`ANTHROPIC_CUSTOM_HEADERS`](/docs/ja/env-vars)を 1 行に 1 つの`Name: Value`ペアで設定します。以下の例は、`X-Org-Route`という名前のルーティングヘッダーを追加します。
311 313
312<Tabs>314<Tabs>
313 <Tab title="Bash または Zsh">315 <Tab title="Bash or Zsh">
314 ```bash theme={null}316 ```bash theme={null}
315 export ANTHROPIC_CUSTOM_HEADERS="X-Org-Route: prod"317 export ANTHROPIC_CUSTOM_HEADERS="X-Org-Route: prod"
316 ```318 ```
323 </Tab>325 </Tab>
324</Tabs>326</Tabs>
325 327
326設定ファイルの `env` ブロックで `ANTHROPIC_CUSTOM_HEADERS` を設定することもできます。JSON 文字列は複数行にまたがることができないため、ペア間で `\n` を使用します：328設定ファイルの`env`ブロックで`ANTHROPIC_CUSTOM_HEADERS`を設定することもできます。JSON 文字列は複数行にまたがることができないため、ペア間で`\n`を使用します。
327 329
328```json theme={null}330```json theme={null}
329{331{
333}335}
334```336```
335 337
338これらのようなルーティングおよびテナントヘッダー名は、[承認が必要なヘッダー](/docs/ja/server-managed-settings#environment-variables-and-the-approval-dialog)としてカウントされます。ヘッダーがプロジェクト設定ファイルから取得される場合、Claude Code は[`env`値を適用する場合のルール](/docs/ja/settings-reference#when-claude-code-applies-env-values)に従ってそれらを適用します。
339
336<h3 id="add-gateway-models-to-the-model-picker">340<h3 id="add-gateway-models-to-the-model-picker">
337 ゲートウェイモデルをモデルピッカーに追加する341 ゲートウェイモデルをモデルピッカーに追加する
338</h3>342</h3>
339 343
340モデル検出は起動時にゲートウェイにモデルリストをクエリし、それらの名前を組み込みエントリと一緒に `/model` ピッカーに追加します。344モデルディスカバリーが有効な場合、Claude Code はスタートアップ時にゲートウェイにモデルリストをクエリし、それらの名前を組み込みエントリと共に`/model`ピッカーに追加します。あなたまたは管理者が[`modelPicker`](/docs/ja/settings-reference#modelpicker)ラインアップで`replaceBuiltInOptions`を設定した場合、Claude Code は検出された名前も非表示にします。セッションが既に使用しているモデルの行は保持されます。
341 345
342ゲートウェイが Claude Code の組み込みリストにないモデル名を提供し、ピッカーから選択したい場合は、それを有効にします。組み込みモデルが使用するものである場合、検出は不要です。管理者は管理設定を通じてすでに有効にしている可能性があります。346ゲートウェイが Claude Code の組み込みリストにないモデル名を提供し、ピッカーから選択したい場合は、これを有効にします。組み込みモデルが使用するものである場合、ディスカバリーは不要です。管理者がマネージド設定を通じて既に有効にしている可能性もあります。
343 347
344有効にするには、シェルまたは `~/.claude/settings.json` の `env` ブロックで `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` を設定します。検出には Claude Code v2.1.129 以降が必要です。348有効にするには、シェルまたは`~/.claude/settings.json`の`env`ブロックで`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`を設定します。
345 349
346検出されたモデルは `From gateway` というラベルの追加 `/model` エントリとして表示されます。検出が実行されたことを確認するには、`claude --debug` を起動して `[gatewayDiscovery]` 行を探します。成功はキャッシュされたモデル数をログに記録し、`404`、タイムアウト、またはリダイレクトもそこに記録されます。検出が実行される場合、フィルタリング内容、ゲートウェイが提供するレスポンス形式については、[モデル検出リファレンス](/docs/ja/llm-gateway-protocol#model-discovery)を参照してください。350検出されたモデルは追加の`/model`エントリとして表示されます。各エントリは、ゲートウェイが提供するモデルの説明、またはゲートウェイが提供しない場合は`From gateway`を表示します。
351
352ディスカバリーが実行されたことを確認するには、`claude --debug`を開始し、`~/.claude/debug/<session-id>.txt`のデバッグログで`[gatewayDiscovery]`行を探します。ディスカバリーが初めて成功すると、Claude Code はキャッシュしたモデル数をログに記録し、ゲートウェイのリストが変更された場合にのみ再度ログに記録します。`404`、タイムアウト、またはリダイレクトもそこに表示されます。ディスカバリーが実行される場合、フィルタリング内容、およびゲートウェイが提供する応答形式については、[モデルディスカバリーリファレンス](/docs/ja/llm-gateway-protocol#model-discovery)を参照してください。
347 353
348<h3 id="rotate-credentials-with-apikeyhelper">354<h3 id="rotate-credentials-with-apikeyhelper">
349 apiKeyHelper で認証情報をローテーションする355 apiKeyHelper で認証情報をローテーションする
350</h3>356</h3>
351 357
352`apiKeyHelper` は、静的環境変数から読み取る代わりに、ゲートウェイ認証情報を取得するために Claude Code が実行するコマンドです。358`apiKeyHelper`は、静的環境変数から読み取る代わりに、ゲートウェイ認証情報を取得するために Claude Code が実行するコマンドです。
353 359
354認証情報がスケジュールで期限切れになる場合、ボルトまたは SSO コマンドから来る場合、または管理者が 1 つを設定するよう指示した場合、ヘルパーを使用します。認証情報が 1 回設定する固定文字列である場合、[認証情報変数](#set-the-credential-variable)がすべて必要で、このセクションをスキップできます。360認証情報がスケジュールに従って期限切れになる場合、コンテナまたは SSO コマンドから取得される場合、または管理者が設定を指示した場合は、ヘルパーを使用します。認証情報が一度設定する固定文字列である場合、[認証情報変数](#set-the-credential-variable)で十分であり、このセクションをスキップできます。
355 361
356ヘルパーは現在の認証情報を stdout に出力するシェルコマンドです。Claude Code はシステムシェルを通じて実行するため、Windows ではそれは実行可能ファイルまたは PowerShell 呼び出しです。スクリプトを書き、実行可能にして、[設定ファイル](/docs/ja/settings)の `apiKeyHelper` から参照します：362ヘルパーは、現在の認証情報を stdout に出力する任意のシェルコマンドです。Claude Code はシステムシェルを通じて実行するため、Windows ではそれは実行可能ファイルまたは PowerShell 呼び出しです。コマンドが認証情報以外に何も出力しないようにします。Claude Code v2.1.227 以降では、キーと一緒に出力されるバナーまたはログ行により、[ヘルパーが失敗します](/docs/ja/errors#your-apikeyhelper-script-is-failing)。スクリプトを作成し、実行可能にして、[設定ファイル](/docs/ja/settings)の`apiKeyHelper`から参照します。
357 363
358<Tabs>364<Tabs>
359 <Tab title="Bash または Zsh">365 <Tab title="Bash or Zsh">
360 たとえば、ボルトから読み取るスクリプト：366 例えば、コンテナから読み取るスクリプト：
361 367
362 ```bash theme={null}368 ```bash theme={null}
363 #!/bin/bash369 #!/bin/bash
364 vault kv get -field=api_key secret/llm-gateway/claude-code370 vault kv get -field=api_key secret/llm-gateway/claude-code
365 ```371 ```
366 372
367 `~/.claude/settings.json` でそのパスを参照します：373 `~/.claude/settings.json`でそのパスを参照します：
368 374
369 ```json theme={null}375 ```json theme={null}
370 {376 {
374 </Tab>380 </Tab>
375 381
376 <Tab title="PowerShell">382 <Tab title="PowerShell">
377 たとえば、ボルトから読み取るスクリプト：383 例えば、コンテナから読み取るスクリプト：
378 384
379 ```powershell theme={null}385 ```powershell theme={null}
380 vault kv get -field=api_key secret/llm-gateway/claude-code386 vault kv get -field=api_key secret/llm-gateway/claude-code
381 ```387 ```
382 388
383 `%USERPROFILE%\.claude\settings.json` で PowerShell 呼び出しを参照し、JSON 文字列のバックスラッシュをエスケープします：389 `%USERPROFILE%\.claude\settings.json`で PowerShell 呼び出しを参照し、JSON 文字列内のバックスラッシュをエスケープします：
384 390
385 ```json theme={null}391 ```json theme={null}
386 {392 {
390 </Tab>396 </Tab>
391</Tabs>397</Tabs>
392 398
393Claude Code はデフォルトでヘルパーの出力を 5 分間キャッシュし、リクエストが HTTP 401 を返すときに再度実行します。キャッシュ有効期間を変更するには、`CLAUDE_CODE_API_KEY_HELPER_TTL_MS` をミリ秒で設定します。たとえば、15 分の場合は `CLAUDE_CODE_API_KEY_HELPER_TTL_MS=900000` です。399Claude Code はデフォルトでヘルパーの出力を 5 分間キャッシュし、キャッシュの有効期限が経過した後にヘルパーを再実行します。有効期限を変更するには、ミリ秒単位で`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`を設定します。例えば、15 分の場合は`CLAUDE_CODE_API_KEY_HELPER_TTL_MS=900000`です。
400
401Claude Code がヘルパーを再実行する他のケースについては、[`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper)を参照してください。
394 402
395ヘルパーの値は `Authorization` と `x-api-key` ヘッダーの両方で送信されるため、ゲートウェイがどちらのヘッダーを読むかに関わらず機能します。403ヘルパーの値は`Authorization`と`x-api-key`の両方のヘッダーで送信されるため、ゲートウェイがどちらのヘッダーを読み取るかに関わらず機能します。
396 404
397<h3 id="turn-off-traffic-outside-the-gateway-path">405<h3 id="turn-off-traffic-outside-the-gateway-path">
398 ゲートウェイパス外のトラフィックをオフにする406 ゲートウェイパス外のトラフィックをオフにする
399</h3>407</h3>
400 408
401ゲートウェイはモデルリクエストを処理しますが、Claude Code はゲートウェイパス外の非必須バックグラウンドトラフィックも Anthropic および GitHub などのサードパーティサービスに送信します。バージョンチェック、テレメトリ、エラーレポート、リリースノート、および同様のリクエストです。ゲートウェイへの出力のみを許可するネットワークでは、これらのリクエストは失敗し、出力監視でブロックされた接続として表示される可能性があります。409ゲートウェイはモデルリクエストを処理しますが、Claude Code はゲートウェイパス外の非必須バックグラウンドトラフィックも Anthropic および GitHub などのサードパーティサービスに送信します。バージョンチェック、テレメトリ、リリースノート、および同様のリクエストです。ゲートウェイへの出力のみを許可するネットワークでは、これらのリクエストが失敗し、出力監視に接続がブロックされたものとして表示される可能性があります。
402 410
403そのトラフィックをオフにするには、ゲートウェイ変数と同じシェルエクスポートまたは設定ファイルの `env` ブロックで `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` を設定します：411Claude Code は、リクエストが認証情報が属するホストに送信される場合にのみ、テレメトリまたは使用メトリクスリクエストに認証情報を添付します。`ANTHROPIC_BASE_URL`がゲートウェイを指している間、Claude Code はテレメトリイベントをゲートウェイ認証情報なしで Anthropic に送信します。[認証情報変数](#set-the-credential-variable)または`apiKeyHelper`も有効な場合、Claude Code はコンソール[分析ダッシュボード](/docs/ja/analytics#access-analytics-for-api-customers)に使用メトリクスを報告しません。v2.1.246 より前では、Claude Code はゲートウェイ認証情報をテレメトリおよび使用メトリクスリクエストに添付して Anthropic ホストに送信する可能性がありました。モデルリクエストは常にゲートウェイが期待する認証情報を使用してゲートウェイに送信されました。
412
413そのトラフィックをオフにするには、ゲートウェイ変数と同じシェルエクスポートまたは設定ファイルの`env`ブロックで`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`を設定します。
404 414
405<Tabs>415<Tabs>
406 <Tab title="Bash または Zsh">416 <Tab title="Bash or Zsh">
407 ```bash theme={null}417 ```bash theme={null}
408 export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1418 export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
409 ```419 ```
416 </Tab>426 </Tab>
417</Tabs>427</Tabs>
418 428
419変数を設定すると、これらの効果と制限があります：429変数を設定すると、以下の効果と制限があります。
420 430
421* 自動更新を無効にするため、パッケージマネージャーまたは管理配布などの別の更新パスを計画します。431* 自動更新が無効になるため、パッケージマネージャーやマネージド配布などの別の更新パスを計画してください。
422* [高速モード](/docs/ja/fast-mode)の可用性チェックを抑制します。前のチェックがすでにマシンで高速モードを有効にしていない限り、`/fast` は高速モードが利用できないことを報告します。432* [高速モード](/docs/ja/fast-mode)の可用性チェックが抑制されます。前のチェックがマシンで高速モードを既に有効にしていない限り、`/fast`は高速モードが利用できないと報告します。
423* [ゲートウェイモデル検出](#add-gateway-models-to-the-model-picker)をオフにします。ただし、検出はゲートウェイ自体をクエリします。以前に検出されたモデルはローカルキャッシュから利用可能なままですが、リストは更新されません。433* [ゲートウェイモデルディスカバリー](#add-gateway-models-to-the-model-picker)には影響しません。これはゲートウェイのみをクエリします。v2.1.257 より前では、変数はディスカバリーのリフレッシュも停止したため、ピッカーは以前キャッシュされたリストを保持していました。
424* WebFetch ツールの[ドメイン安全チェック](/docs/ja/data-usage#webfetch-domain-safety-check)は影響を受けず、引き続き `api.anthropic.com` を呼び出します。ネットワークがそのホストをブロックする場合、[設定](/docs/ja/settings)で `skipWebFetchPreflight: true` を使用して個別にオフにします。434* WebFetch ツールの[ドメイン安全チェック](/docs/ja/data-usage#webfetch-domain-safety-check)は影響を受けず、引き続き`api.anthropic.com`を呼び出します。ネットワークがそのホストをブロックする場合は、[設定](/docs/ja/settings)で`skipWebFetchPreflight: true`を使用して個別にオフにします。
425* 各テレメトリストリームおよびそれを制御する変数については、[テレメトリサービス](/docs/ja/data-usage#telemetry-services)を参照してください。435* 各テレメトリストリームとそれを制御する変数については、[テレメトリサービス](/docs/ja/data-usage#telemetry-services)を参照してください。
426 436
427<h3 id="route-to-a-cloud-provider-through-a-gateway">437<h3 id="route-to-a-cloud-provider-through-a-gateway">
428 クラウドプロバイダーをゲートウェイ経由でルーティングする438 ゲートウェイを通じてクラウドプロバイダーにルーティングする
429</h3>439</h3>
430 440
431これらの設定は Claude Code を `ANTHROPIC_BASE_URL` の代わりにプロバイダー固有の基本 URL 変数を通じてゲートウェイに指定します。Amazon Bedrock と Google Cloud の Agent Platform ゲートウェイはそれらのプロバイダーのネイティブリクエスト形式を受け入れます。Microsoft Foundry と AWS 上の Claude Platform ゲートウェイは Anthropic Messages 形式を受け入れ、どの基本 URL 変数がそれらに到達するかでのみ異なります。441これらの設定は、`ANTHROPIC_BASE_URL`の代わりにプロバイダー固有のベース URL 変数を通じてゲートウェイを指すように Claude Code を設定します。Amazon Bedrock および Google Cloud の Agent Platform ゲートウェイはそれらのプロバイダーのネイティブリクエスト形式を受け入れます。Microsoft Foundry および AWS 上の Claude Platform ゲートウェイは Anthropic Messages 形式を受け入れます。Amazon Bedrock および Google Cloud の Agent Platform ルートでは、Claude Code はベータヘッダーとリクエストフィールドをそのプロバイダーが受け入れるセットに制限します。各ルートでゲートウェイが受け取るものについては、[ゲートウェイ互換性ガイド](/docs/ja/llm-gateway-protocol)を参照してください。
442
443ゲートウェイチームが Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または AWS 上の Claude Platform を具体的に指定した場合にのみ、1 つを使用します。上記の[検証リクエスト](#verify-the-connection)が JSON を返した場合、このセクションをスキップできます。
432 444
433ゲートウェイチームが Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または AWS 上の Claude Platform という名前を付けた場合のみ 1 つを使用します。上記の[検証リクエスト](#verify-the-connection)が JSON を返した場合、このセクションをスキップできます。445ゲートウェイチームが指定したプロバイダーのブロックを設定します。Amazon Bedrock、Google Cloud の Agent Platform、および AWS 上の Claude Platform ブロック内のスキップ認証変数は、ゲートウェイがそれらを保持しているため、Claude Code にクラウドプロバイダーの認証情報でリクエストに署名しないよう指示します。ゲートウェイが独自のトークンも必要とする場合、それを配置する場所はプロバイダーによって異なります。
434 446
435ゲートウェイチームが名前を付けたプロバイダーのブロックを設定します。skip-auth 変数は Claude Code にプロバイダー認証情報でリクエストに署名しないよう指示します。ゲートウェイがそれらを保持しているため。ゲートウェイが独自のトークンが必要な場合、Foundry を除いて、ブロックの後に `ANTHROPIC_AUTH_TOKEN` を追加します。Microsoft Foundry は示されているように `ANTHROPIC_FOUNDRY_API_KEY` を使用します。Bearer トークンを期待する Microsoft Foundry ゲートウェイは、代わりに [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/docs/ja/env-vars) を使用できます。これは両方が設定されている場合、`ANTHROPIC_FOUNDRY_API_KEY` より優先されます。`ANTHROPIC_FOUNDRY_AUTH_TOKEN` には Claude Code v2.1.203 以降が必要です。447* **Amazon Bedrock、Google Cloud の Agent Platform、または AWS 上の Claude Platform**：ブロックの後に`ANTHROPIC_AUTH_TOKEN`を追加します。Claude Code はそれを`Authorization: Bearer`ヘッダーとしてゲートウェイに送信します。異なるスキームまたはヘッダーの認証情報については、代わりに[`ANTHROPIC_CUSTOM_HEADERS`](#send-additional-headers)を使用します。スキップ認証変数を設定したままにしてください。これがないと、Claude Code は`ANTHROPIC_AUTH_TOKEN`、[`apiKeyHelper`](#rotate-credentials-with-apikeyhelper)、または`ANTHROPIC_CUSTOM_HEADERS`が追加する`Authorization`ヘッダーを削除します。
448* **Microsoft Foundry**：[そのブロック](#microsoft-foundry)に示すように`ANTHROPIC_FOUNDRY_API_KEY`を使用します。
436 449
437<h4 id="amazon-bedrock">450<h4 id="amazon-bedrock">
438 Amazon Bedrock451 Amazon Bedrock
439</h4>452</h4>
440 453
454ゲートウェイが独自の認証情報を発行する場合、`AWS_BEARER_TOKEN_BEDROCK`を設定しないままにします。設定した場合、Claude Code は`CLAUDE_CODE_SKIP_BEDROCK_AUTH`が設定されていても、ゲートウェイトークンの代わりにその[Amazon Bedrock API キー](/docs/ja/amazon-bedrock#2-configure-aws-credentials)を`Authorization`ヘッダーとして送信します。
455
441<Tabs>456<Tabs>
442 <Tab title="Bash または Zsh">457 <Tab title="Bash or Zsh">
443 ```bash theme={null}458 ```bash theme={null}
444 export ANTHROPIC_BEDROCK_BASE_URL=https://llm-gateway.example.com/bedrock459 export ANTHROPIC_BEDROCK_BASE_URL=https://llm-gateway.example.com/bedrock
445 export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1460 export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1
460 Google Cloud の Agent Platform475 Google Cloud の Agent Platform
461</h4>476</h4>
462 477
478プロジェクト ID とリージョンを独自の値に置き換えます。Claude Code はゲートウェイに送信する各リクエストのパスに両方を含めます。
479
463<Tabs>480<Tabs>
464 <Tab title="Bash または Zsh">481 <Tab title="Bash or Zsh">
465 ```bash theme={null}482 ```bash theme={null}
466 export ANTHROPIC_VERTEX_BASE_URL=https://llm-gateway.example.com/vertex483 export ANTHROPIC_VERTEX_BASE_URL=https://llm-gateway.example.com/vertex
467 export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id484 export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id
482 </Tab>499 </Tab>
483</Tabs>500</Tabs>
484 501
502ブロックはルーティングと認証をカバーします。[Agent Platform セットアップ](/docs/ja/google-vertex-ai#4-configure-claude-code)からのリージョンオーバーライドとモデルピンはゲートウェイを通じても適用されます。
503
504* **モデルごとのリージョン**：ゲートウェイが一部のモデルを`CLOUD_ML_REGION`以外のリージョンから提供する場合、各モデルに対して一致する`VERTEX_REGION_CLAUDE_*`変数を設定します。例えば`VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1`です。[環境変数リファレンス](/docs/ja/env-vars)に正確な名前が記載されています。
505* **モデルバージョン**：[モデルバージョンをピン留めする](/docs/ja/google-vertex-ai#5-pin-model-versions)のように`ANTHROPIC_DEFAULT_OPUS_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`、および`ANTHROPIC_DEFAULT_HAIKU_MODEL`をピン留めします。`ANTHROPIC_DEFAULT_HAIKU_MODEL`を設定すると、セッションタイトルなどのバックグラウンドタスクもそのモデルに移動し、そのセクションではそれ以外の場合にどのモデルが実行されるかを説明します。
506* **モデル機能**：Claude Code バージョンが認識しないモデル ID をピン留めする場合、努力レベルや拡張思考などの機能は無効のままになる可能性があります。[`ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES`](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)とその Sonnet および Haiku カウンターパートを使用して、モデルがサポートするものを宣言します。
507
485<h4 id="microsoft-foundry">508<h4 id="microsoft-foundry">
486 Microsoft Foundry509 Microsoft Foundry
487</h4>510</h4>
488 511
489ゲートウェイの認証情報を `ANTHROPIC_FOUNDRY_API_KEY` に入れます。`x-api-key` ヘッダーとしてゲートウェイに送信されます。Bearer トークンを期待するゲートウェイは、代わりに [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/docs/ja/env-vars) を使用できます。Claude Code はその値を `Authorization: Bearer` ヘッダーとして送信し、両方が設定されている場合、`ANTHROPIC_FOUNDRY_API_KEY` より優先されます。Claude Code v2.1.203 以降が必要です。512ゲートウェイの認証情報を`ANTHROPIC_FOUNDRY_API_KEY`に入れます。これは`x-api-key`ヘッダーとしてゲートウェイに送信されます。ベアラートークンを期待するゲートウェイは、代わりに[`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/docs/ja/env-vars)を使用できます。Claude Code はその値を`Authorization: Bearer`ヘッダーとして送信し、両方が設定されている場合は`ANTHROPIC_FOUNDRY_API_KEY`よりも優先されます。Claude Code v2.1.203 以降が必要です。
490 513
491独自の `Authorization` ヘッダーを挿入するゲートウェイの場合、`CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1` を設定し、両方の認証情報変数を設定しないままにします。Claude Code はその後、Azure 認証情報なしでリクエストを送信し、たとえば `ANTHROPIC_CUSTOM_HEADERS` を通じて提供する `Authorization` ヘッダーを保持します。v2.1.203 より前では、API キーなしの `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` は Microsoft Foundry クライアントがリクエストを送信できないままにしました。514独自の`Authorization`ヘッダーを挿入するゲートウェイの場合、`CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1`を設定し、両方の認証情報変数を設定しないままにします。Claude Code はその後、Azure 認証情報なしでリクエストを送信し、例えば`ANTHROPIC_CUSTOM_HEADERS`を通じて提供する`Authorization`ヘッダーを保持します。v2.1.203 より前では、API キーなしで`CLAUDE_CODE_SKIP_FOUNDRY_AUTH`を使用すると、Microsoft Foundry クライアントはリクエストを送信できなくなりました。
492 515
493<Tabs>516<Tabs>
494 <Tab title="Bash または Zsh">517 <Tab title="Bash or Zsh">
495 ```bash theme={null}518 ```bash theme={null}
496 export ANTHROPIC_FOUNDRY_BASE_URL=https://llm-gateway.example.com/foundry519 export ANTHROPIC_FOUNDRY_BASE_URL=https://llm-gateway.example.com/foundry
497 export ANTHROPIC_FOUNDRY_API_KEY=sk-gateway-key520 export ANTHROPIC_FOUNDRY_API_KEY=sk-gateway-key
512 AWS 上の Claude Platform535 AWS 上の Claude Platform
513</h4>536</h4>
514 537
515ワークスペース ID については、[AWS 上の Claude Platform](/docs/ja/claude-platform-on-aws) を参照してください。538ワークスペース ID については、[AWS 上の Claude Platform](/docs/ja/claude-platform-on-aws)を参照してください。
516 539
517<Tabs>540<Tabs>
518 <Tab title="Bash または Zsh">541 <Tab title="Bash or Zsh">
519 ```bash theme={null}542 ```bash theme={null}
520 export ANTHROPIC_AWS_BASE_URL=https://llm-gateway.example.com/anthropic-aws543 export ANTHROPIC_AWS_BASE_URL=https://llm-gateway.example.com/anthropic-aws
521 export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN544 export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
534 </Tab>557 </Tab>
535</Tabs>558</Tabs>
536 559
560<h4 id="confirm-the-provider-route">
561 プロバイダーのルートを確認する
562</h4>
563
564設定したブロックがあるシェルから`claude`を開始し、`/status`を実行します。Amazon Bedrock ブロックでは、**Status**タブに以下のような行が表示されます。
565
566```text theme={null}
567API provider: Amazon Bedrock
568Bedrock base URL: https://llm-gateway.example.com/bedrock
569AWS auth skipped
570```
571
572他のブロックは、例えば Google Cloud の Agent Platform の場合は`Vertex base URL`と`GCP auth skipped`など、プロバイダーの名前の下に同じ行を生成します。Microsoft Foundry ブロックは、`CLAUDE_CODE_SKIP_FOUNDRY_AUTH`を設定した場合にのみ認証スキップ行を表示します。企業プロキシを通じてルーティングする場合、`Proxy`行はプロキシ URL を表示します。ベース URL 行が見つからない場合、変数がセッションに到達しませんでした。
573
537<h2 id="troubleshoot-gateway-errors">574<h2 id="troubleshoot-gateway-errors">
538 ゲートウェイエラーのトラブルシューティング575 ゲートウェイエラーのトラブルシューティング
539</h2>576</h2>
540 577
541これらはゲートウェイを通じて Claude Code を実行する場合の最も一般的なエラーで、ゲートウェイ側の原因と修正方法です：578ゲートウェイを通じて Claude Code を実行する場合の最も一般的なエラーで、ゲートウェイ側の原因と修正方法です：
542 579
543| エラー | 原因 | 修正 |580| エラー | 原因 | 修正 |
544| :------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |581| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
545| 2 つの認証情報ソースという名前の起動警告で、`auth may not work as expected` で終わります。古いバージョンは代わりに `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` を表示します。 | ゲートウェイ認証情報と保存されたログインの両方がアクティブです。変数はリクエストに使用されますが、古いログインは予期しない認証動作を引き起こす可能性があります | 変数を設定解除して保存されたログインを使用するか、`/logout` を実行してゲートウェイ認証情報を使用します |582| 2 つの認証情報ソースという名前の起動警告で、`auth may not work as expected` で終わります。古いバージョンは代わりに `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` を表示します。 | ゲートウェイ認証情報と保存されたログインの両方がアクティブです。変数はリクエストに使用されますが、古いログインは予期しない認証動作を引き起こす可能性があります | 変数を設定解除して保存されたログインを使用するか、`/logout` を実行してゲートウェイ認証情報を使用します |
546| 無効または認識されないトークンという名前の `401` エラー | 認証情報はゲートウェイが発行したものではないか、ゲートウェイが読むヘッダーにあります | [認証情報テーブル](#set-the-credential-variable)で変数が認証情報の種類と一致することを確認し、ゲートウェイで失効した場合はキーを再生成します |583| 無効または認識されないトークンという名前の `401` エラー | 認証情報はゲートウェイが発行したものではないか、ゲートウェイが読むヘッダーにあります | [認証情報テーブル](#set-the-credential-variable)で変数が認証情報の種類と一致することを確認し、ゲートウェイで失効した場合はキーを再生成します |
547| `Your apiKeyHelper script is failing` | [`apiKeyHelper`](/docs/ja/settings#available-settings) 設定のコマンドがエラーで終了したか、タイムアウトしたか、何も出力しなかったため、リクエストはプレースホルダーキーを含みます | コマンドを直接実行して失敗の理由を確認し、期限切れセッションを報告する場合は認証情報プロバイダーで再認証します。[エラーリファレンス](/docs/ja/errors#your-apikeyhelper-script-is-failing)を参照してください |584| `Your apiKeyHelper script is failing`、または非対話型モードで stderr に `apiKeyHelper failed:` | [`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper) 設定のコマンドが使用可能なキーを生成しなかったため、リクエストはプレースホルダーキーを含みます | コマンドを直接実行して失敗の理由を確認し、期限切れセッションを報告する場合は認証情報プロバイダーで再認証します。[エラーリファレンス](/docs/ja/errors#your-apikeyhelper-script-is-failing)を参照してください |
548| `Unable to connect to API (ConnectionRefused)`、または npm インストールからの `(ECONNREFUSED)`。多くの場合、Claude Code が[バックオフで再試行](/docs/ja/errors#automatic-retries)している間の静かな一時停止の後 | 基本 URL で何も応答しません。アドレスが間違っているか、VPN またはファイアウォールがゲートウェイへのパスをブロックしています | 上記の [curl テスト](#verify-the-connection)を実行します。これは同じ原因で直ちに失敗し、URL とネットワークパスをゲートウェイチームで確認します |585| アドレスで何も応答しない場合は `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)`、またはホスト名が解決しない場合は `Can't reach the API server — check your internet or DNS (ENOTFOUND)`。多くの場合、Claude Code が[バックオフで再試行](/docs/ja/errors#automatic-retries)している間の静かな一時停止の後です。括弧内のコードは異なります。[Unable to connect to API](/docs/ja/errors#unable-to-connect-to-api) はコードのスペルと以前の表現をカバーしています | 基本 URL で何も応答しません。アドレスが間違っているか、VPN またはファイアウォールがゲートウェイへのパスをブロックしています | 上記の [curl テスト](#verify-the-connection)を実行します。これは同じ原因で直ちに失敗し、URL とネットワークパスをゲートウェイチームで確認します |
549| `API returned an empty or malformed response (HTTP 200)` | ゲートウェイまたは中間プロキシが非 API レスポンス（多くの場合 HTML エラーまたはログインページ）を返しました | 上記の [curl リクエスト](#verify-the-connection)でテストします。非 JSON を返すゲートウェイルートを修正します |586| `API returned an empty or malformed response (HTTP 200)` | ゲートウェイまたは中間プロキシが非 API レスポンス（多くの場合 HTML エラーまたはログインページ）を返しました | 上記の [curl リクエスト](#verify-the-connection)でテストします。Claude API レスポンス以外で応答するゲートウェイルートを修正します。[エラーリファレンス](/docs/ja/errors#api-returned-an-empty-or-malformed-response)はメッセージが報告する詳細を説明しています |
550| `context_management`、`Extra inputs are not permitted`、または他の認識されないフィールドという名前の `400` エラー | ゲートウェイは Anthropic 形式エンドポイントに Claude Code が送信するフィールドを拒否する上流にリクエストを転送します | `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` を設定します。これはほとんどのプレリリースフィールドを抑制します。[機能パススルー](/docs/ja/llm-gateway-protocol#feature-pass-through)を参照してください。一部のベータはこのフラグでゲートされていません。それらについては、一致する `CLAUDE_CODE_USE_*` プロバイダー変数を設定して、Claude Code がそのプロバイダーが受け入れるもののみを送信するようにします |587| `context_management`、`Extra inputs are not permitted`、または他の認識されないフィールドという名前の `400` エラー | ゲートウェイは Anthropic 形式エンドポイントに Claude Code が送信するフィールドを拒否する上流にリクエストを転送します | `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` を設定します。これはほとんどのプレリリースフィールドを抑制します。[機能パススルー](/docs/ja/llm-gateway-protocol#feature-pass-through)を参照してください。一部のベータはこのフラグでゲートされていません。それらについては、一致する `CLAUDE_CODE_USE_*` プロバイダー変数を設定して、Claude Code がそのプロバイダーが受け入れるもののみを送信するようにします |
551| `thinking` または `adaptive` という名前の `400` エラー（`Input tag 'adaptive' found` など） | 上流モデルビルドは Claude Code が Claude 4.6 以降のモデルに要求する適応推論を受け入れません | ゲートウェイの上流をアップグレードします。Opus 4.6 と Sonnet 4.6 では、代わりに `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` が機能します。[モデル設定](/docs/ja/model-config)機能変数は、`CLAUDE_CODE_USE_BEDROCK` や `CLAUDE_CODE_USE_VERTEX` などのプロバイダー設定にのみ適用され、`ANTHROPIC_BASE_URL` ゲートウェイの背後には適用されません |588| `thinking` または `adaptive` という名前の `400` エラー（`Input tag 'adaptive' found` など） | 上流モデルビルドは Claude Code が Claude 4.6 以降のモデルに要求する適応推論を受け入れません | ゲートウェイの上流をアップグレードします。Opus 4.6 と Sonnet 4.6 では、代わりに `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` が機能します。[モデル設定](/docs/ja/model-config)機能変数は、`CLAUDE_CODE_USE_BEDROCK` や `CLAUDE_CODE_USE_VERTEX` などのプロバイダー設定にのみ適用され、`ANTHROPIC_BASE_URL` ゲートウェイの背後には適用されません |
552| ゲートウェイ独自の言葉でコンテキストまたはトークン制限を述べる `400` エラー（`ContextWindowExceededError` または `prompt token count of N exceeds the limit of M` など） | ゲートウェイはモデルのネイティブウィンドウより小さいコンテキストを強制し、上流エラーを書き直すため、Anthropic の `prompt is too long` 表現と一致する自動コンパクト再試行は発火しません | `/compact` を実行してセッションを復旧します。防ぐには、`CLAUDE_CODE_AUTO_COMPACT_WINDOW` をゲートウェイの制限に設定します。値は少なくとも 100,000 トークン、最大でもモデルのコンテキストウィンドウにクランプされるため、100,000 未満のゲートウェイ制限は一致できず、`/compact` はそこでの復旧のままです。また、`CLAUDE_CODE_MAX_OUTPUT_TOKENS` をゲートウェイモデルの出力制限より下に設定します |589| ゲートウェイ独自の言葉でコンテキストまたはトークン制限を述べる `400` エラー（`ContextWindowExceededError` または `prompt token count of N exceeds the limit of M` など） | ゲートウェイはモデルのネイティブウィンドウより小さいコンテキストを強制し、上流エラーを書き直すため、Claude Code は[長すぎるエラー](/docs/ja/errors#prompt-is-too-long)として認識せず、自動的にコンパクト化して再試行しません | `/compact` を実行してセッションを復旧します。防ぐには、`CLAUDE_CODE_AUTO_COMPACT_WINDOW` をゲートウェイの制限に設定します。Claude Code は値を少なくとも 100,000 トークン、最大でもモデルのコンテキストウィンドウにクランプするため、100,000 未満のゲートウェイ制限は一致できず、`/compact` はそこでの復旧のままです。また、`CLAUDE_CODE_MAX_OUTPUT_TOKENS` をゲートウェイモデルの出力制限より下に設定します |
553| `/model` ピッカーから欠落しているモデル | ゲートウェイモデル名は Claude Code の組み込みリストにありません | [ゲートウェイモデル検出](#add-gateway-models-to-the-model-picker)を有効にするか、[モデル設定](/docs/ja/model-config)変数で名前を追加します |590| Claude Code v2.1.265 から v2.1.267 で、ツールの入力スキーマまたはその `pattern` を拒否するゲートウェイ独自の言葉での `400` エラー | これらのバージョンでの段階的なロールアウトで、[Artifact ツール](/docs/ja/artifacts#availability)スキーマは `\p{...}` Unicode 文字クラスを持つ正規表現を含みます。Anthropic API はそれを受け入れますが、各ツールスキーマの `pattern` を独自の正規表現エンジンでチェックするゲートウェイまたは上流は、リクエスト全体を拒否します | v2.1.268 以降に更新します。これは正規表現を送信しません。影響を受けるバージョンでは、[アーティファクトをオフにします](/docs/ja/artifacts#disable-artifacts)。これはツールとそのスキーマをリクエストから削除します |
554| Claude Code は [curl テスト](#verify-the-connection)が成功しても、ログインするよう求めます | CLI には独自の認証情報がありません。到達可能な基本 URL は 1 つではなく、プロジェクトの `.claude/settings.json` または `.claude/settings.local.json` の `env` ブロックは最初の実行ウィザードと信頼プロンプトの後にのみ適用されます | `ANTHROPIC_AUTH_TOKEN` をどこかに設定します。Claude Code は最初の実行セットアップの前に読み取ります。シェルエクスポート、`~/.claude/settings.json` の `env` ブロック、または管理設定 |591| `/model` ピッカーから欠落しているモデル | ゲートウェイモデル名は Claude Code の組み込みリストにありません。または Claude Code は組み込みオプションを置き換える [`modelPicker`](/docs/ja/settings-reference#modelpicker) ラインアップを表示しています | [ゲートウェイモデル検出](#add-gateway-models-to-the-model-picker)を有効にするか、[モデル設定](/docs/ja/model-config)変数で名前を追加します。Claude Code が置き換える `modelPicker` ラインアップを表示している場合は、ゲートウェイモデルをそれに追加するか、管理設定がそれを提供する場合は管理者に追加を依頼します |
592| 推論リクエストが機能している間に `/fast` が `Fast mode unavailable due to network connectivity issues` を報告します | [高速モード](/docs/ja/fast-mode)の可用性チェックは `api.anthropic.com` に直接移動し、`ANTHROPIC_BASE_URL` に従いません。そのため、ブロックされた直接エグレスはチェックに失敗します。チェックが `ANTHROPIC_API_KEY` からゲートウェイ発行キーまたは `apiKeyHelper` を提示し、Anthropic がそれを拒否する場合、同じメッセージが開いたネットワークに表示されます | エグレスがブロックされている場合は `api.anthropic.com` をホワイトリストに登録するか、スキップ変数を設定します。拒否されたゲートウェイキーの場合のみ、スキップ変数が役立ちます。[プロキシと LLM ゲートウェイの背後で高速モードを使用する](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |
593| `ANTHROPIC_AUTH_TOKEN` で認証されたセッションで `/fast` が `Fast mode has been disabled by your organization` を報告します。組織が高速モードを有効にしている場合でも | 可用性チェックには claude.ai ログインまたは Anthropic API キーが必要です。ベアラートークンのみの場合、Claude Code は高速モードをチェックを送信せずに無効として扱います | `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` を設定します。[プロキシと LLM ゲートウェイの背後で高速モードを使用する](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |
594| [curl テスト](#verify-the-connection)が成功しても、Claude Code はログインするよう求めます | CLI には独自の認証情報がありません。到達可能な基本 URL は 1 つではなく、対話型セッションではプロジェクトの `.claude/settings.json` または `.claude/settings.local.json` の `env` ブロックは最初の実行ウィザードと[信頼プロンプト](/docs/ja/permissions#what-runs-before-you-trust-a-folder)の後にのみ適用されます | `ANTHROPIC_AUTH_TOKEN` を Claude Code が最初の実行セットアップの前に読み取る場所に設定します。シェルエクスポート、`~/.claude/settings.json` の `env` ブロック、または管理設定 |
555| `ANTHROPIC_API_KEY` が設定されていますが、プロンプトなしで無視されます | キーはインタラクティブセッションで 1 回の承認が必要で、以前に拒否されたキーは再度尋ねられずに無視されます | `/config` で `Use custom API key` オプションで有効にします |595| `ANTHROPIC_API_KEY` が設定されていますが、プロンプトなしで無視されます | キーはインタラクティブセッションで 1 回の承認が必要で、以前に拒否されたキーは再度尋ねられずに無視されます | `/config` で `Use custom API key` オプションで有効にします |
556| `This machine's managed settings require a first-party login` | 管理設定に `forceLoginMethod` または `forceLoginOrgUUID` が含まれています。Claude Code v2.1.146 以降では、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` と共存できません | 管理者は管理設定から `forceLoginMethod` と `forceLoginOrgUUID` を削除してゲートウェイ認証情報を使用するか、ゲートウェイ認証情報を削除してファーストパーティログインを使用する必要があります。2 つは組み合わせることはできません |596| `This machine's managed settings require a first-party login` | 管理設定に `forceLoginMethod` または `forceLoginOrgUUID` が含まれています。これは `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` と共存できません | 管理者は管理設定から `forceLoginMethod` と `forceLoginOrgUUID` を削除してゲートウェイ認証情報を使用するか、ゲートウェイ認証情報を削除してファーストパーティログインを使用する必要があります。2 つは組み合わせることはできません |
557| `403` と HTML 本体（`403 Forbidden` など）。ゲートウェイ独自のログに受信したリクエストがない場合 | ゲートウェイの前の Web アプリケーションファイアウォールまたはリバースプロキシがゲートウェイに到達する前にリクエスト本体をブロックしました。Claude Code プロンプトには XML スタイルタグとソースコードが含まれており、クロスサイトスクリプティング本体ルールと一致するため、短い curl テストは成功しますが、実際のセッションは成功しません | ゲートウェイの `/v1/messages` パスをリクエスト本体検査から除外します。AWS WAF ではこれは `CrossSiteScripting_Body` マネージドルールです。nginx と ModSecurity では、同等の OWASP CRS 本体ルールです |597| `403` と HTML 本体（`403 Forbidden` など）。ゲートウェイ独自のログに受信したリクエストがない場合 | ゲートウェイの前の Web アプリケーションファイアウォールまたはリバースプロキシがゲートウェイに到達する前にリクエスト本体をブロックしました。Claude Code プロンプトには XML スタイルタグとソースコードが含まれており、クロスサイトスクリプティング本体ルールと一致するため、短い curl テストは成功しますが、実際のセッションは成功しません | ゲートウェイの `/v1/messages` パスをリクエスト本体検査から除外します。AWS WAF ではこれは `CrossSiteScripting_Body` マネージドルールです。nginx と ModSecurity では、同等の OWASP CRS 本体ルールです |
558| 証明書または TLS エラー（`SSL certificate verification failed` または `Self-signed certificate detected` など）。[curl テスト](#verify-the-connection)が成功する場合 | Claude Code のランタイムは `curl` が使用するのと同じ認証局を信頼していません。一般的に企業 TLS 検査プロキシの背後 | `NODE_EXTRA_CA_CERTS` を CA バンドルパスに設定します。[CA 証明書ストア](/docs/ja/network-config#ca-certificate-store)を参照してください |598| 証明書または TLS エラー（`SSL certificate verification failed` または `Self-signed certificate detected` など）。[curl テスト](#verify-the-connection)が成功する場合 | Claude Code のランタイムは `curl` が使用するのと同じ認証局を信頼していません。一般的に企業 TLS 検査プロキシの背後 | `NODE_EXTRA_CA_CERTS` を CA バンドルパスに設定します。[CA 証明書ストア](/docs/ja/network-config#ca-certificate-store)を参照してください |
559 599
565 605
566* [LLM ゲートウェイの概要](/docs/ja/llm-gateway)：ゲートウェイとは何か、および claude.ai サブスクリプションとどのように相互作用するか606* [LLM ゲートウェイの概要](/docs/ja/llm-gateway)：ゲートウェイとは何か、および claude.ai サブスクリプションとどのように相互作用するか
567* [組織用の LLM ゲートウェイをロールアウトする](/docs/ja/llm-gateway-rollout)：ゲートウェイをデプロイして配布するための管理者向けチェックリスト607* [組織用の LLM ゲートウェイをロールアウトする](/docs/ja/llm-gateway-rollout)：ゲートウェイをデプロイして配布するための管理者向けチェックリスト
568* [ゲートウェイプロトコルリファレンス](/docs/ja/llm-gateway-protocol)：Claude Code がゲートウェイに送信するもの。ゲートウェイが転送する必要があるヘッダーとフィールドを含む608* [ゲートウェイ互換性ガイド](/docs/ja/llm-gateway-protocol)：Claude Code がゲートウェイに送信するもの。ゲートウェイが転送する必要があるヘッダーとフィールドを含む
569* [設定](/docs/ja/settings)：設定ファイルが存在する場所と `env` ブロックがどのように読み取られるか609* [設定](/docs/ja/settings)：設定ファイルが存在する場所と `env` ブロックがどのように読み取られるか
570* [認証](/docs/ja/authentication)：認証情報変数、`apiKeyHelper`、OAuth ログインがどのように相互作用するか610* [認証](/docs/ja/authentication)：認証情報変数、`apiKeyHelper`、OAuth ログインがどのように相互作用するか
