Documentation — Spybara

admin-setup.md +2 −2

Details

137 接続された GitHub アカウント137 接続された GitHub アカウント

138</h3>138</h3>

139 139

140Team プランと Enterprise プランでは、[**Admin settings > GitHub**](https://claude.ai/admin-settings/github) に、[Claude GitHub App](https://github.com/apps/claude) を通じて Claude 組織にリンクされている GitHub 組織と個人アカウントが一覧表示されます。Claude Code、[Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github)、Claude Security はこのリストを共有します。このページを開くには、Claude 組織での管理者ロールが必要です。140Team プランと Enterprise プランでは、[**Organization settings > GitHub**](https://claude.ai/admin-settings/github) に、[Claude GitHub App](https://github.com/apps/claude) を通じて Claude 組織にリンクされている GitHub 組織と個人アカウントが一覧表示されます。Claude Code、[Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github)、Claude Security はこのリストを共有します。このページを開くには、Claude 組織での管理者ロールが必要です。

141 141

142アカウントは管理者またはメンバーがリンクできます。142アカウントは管理者またはメンバーがリンクできます。

143 143

162| Analytics dashboard | Teams / Enterprise でのリーダーボード付き採用度と貢献度メトリクス、Console でのユーザーごとの使用状況と支出メトリクス | Teams / Enterprise は [claude.ai/analytics](https://claude.ai/analytics/claude-code)、Console は [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | [Analytics](/docs/ja/analytics) |162| Analytics dashboard | Teams / Enterprise でのリーダーボード付き採用度と貢献度メトリクス、Console でのユーザーごとの使用状況と支出メトリクス | Teams / Enterprise は [claude.ai/analytics](https://claude.ai/analytics/claude-code)、Console は [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | [Analytics](/docs/ja/analytics) |

163| Programmatic reporting | API を通じたユーザーごとの使用状況とコストデータ | Enterprise 向け [Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics)、Console 向け [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) | [Costs](/docs/ja/costs#manage-costs-for-your-organization) |163| Programmatic reporting | API を通じたユーザーごとの使用状況とコストデータ | Enterprise 向け [Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics)、Console 向け [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) | [Costs](/docs/ja/costs#manage-costs-for-your-organization) |

164| Spend controls | 支出制限とレート制限 | Teams / Enterprise の管理者設定、Console のワークスペース制限、サードパーティクラウドではクラウド予算管理またはユーザーごとの [支出制限](/docs/ja/claude-apps-gateway-spend-limits) を備えた [Claude apps gateway](/docs/ja/claude-apps-gateway) | [Costs](/docs/ja/costs#manage-costs-for-your-organization) |164| Spend controls | 支出制限とレート制限 | Teams / Enterprise の組織設定、Console のワークスペース制限、サードパーティクラウドではクラウド予算管理またはユーザーごとの [支出制限](/docs/ja/claude-apps-gateway-spend-limits) を備えた [Claude apps gateway](/docs/ja/claude-apps-gateway) | [Costs](/docs/ja/costs#manage-costs-for-your-organization) |

165 165

166Teams および Enterprise では、ユーザーごとの使用状況と支出の数値は分析ダッシュボードではなく、組織の分析設定の [支出レポート](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) から取得されます。クラウドプロバイダーは AWS Cost Explorer、GCP Billing、または Azure Cost Management を通じて支出を公開します。Claude チャット、Claude Code、Cowork 全体にわたるエンタープライズ予算計画については、[Claude Enterprise 消費ガイド](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide) を参照してください。166Teams および Enterprise では、ユーザーごとの使用状況と支出の数値は分析ダッシュボードではなく、組織の分析設定の [支出レポート](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) から取得されます。クラウドプロバイダーは AWS Cost Explorer、GCP Billing、または Azure Cost Management を通じて支出を公開します。Claude チャット、Claude Code、Cowork 全体にわたるエンタープライズ予算計画については、[Claude Enterprise 消費ガイド](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide) を参照してください。

167 167

agent-sdk/mcp.md +14 −0

Details

919 ```919 ```

920</CodeGroup>920</CodeGroup>

921 921

922<h3 id="a-tool-is-missing-from-an-sdk-mcp-server">

923 SDK MCP サーバーからツールが欠落している

924</h3>

925

926TypeScript SDK では、ツールの入力スキーマを JSON Schema に変換できない場合、[`createSdkMcpServer()`](/docs/ja/agent-sdk/typescript#createsdkmcpserver) で作成したサーバーは、ツールを一覧表示する際にそのツールを除外します。SDK はその時点で警告を出力します。Node.js では、この警告はコード `CLAUDE_SDK_MCP_TOOL_SCHEMA_UNCONVERTIBLE` を持つプロセス警告であり、次のテキストで始まります。

927

928```text theme={null}

929Tool "<name>" on SDK MCP server "<server>" was left out of the server's tool list, because its input schema cannot be converted to JSON Schema

930```

931

932警告の残りの部分では、変換エラーのメッセージがある場合はそのメッセージが示され、続いて確認および変更すべき点が示されます。

933

934TypeScript Agent SDK v0.3.286 より前では、変換できないスキーマが 1 つあるだけで、この警告なしにサーバーのツール一覧全体が失敗していたため、そのサーバーのツールはいずれも Claude に届きませんでした。

935

922<h3 id="connection-timeouts">936<h3 id="connection-timeouts">

923 接続タイムアウト937 接続タイムアウト

924</h3>938</h3>

agent-sdk/troubleshooting.md +1 −1

Details

13| 症状 | 参照先 |13| 症状 | 参照先 |

14| :- | :- |14| :- | :- |

16| MCP サーバーが `failed` ステータスを表示、ツールが呼び出されない、接続タイムアウト、最大許容トークン数を超えるツール出力 | [MCP のトラブルシューティング](/docs/ja/agent-sdk/mcp#troubleshooting) |16| MCP サーバーが `failed` ステータスを表示、ツールが呼び出されない、SDK MCP サーバーにツールが見当たらない、接続タイムアウト、最大許容トークン数を超えるツール出力 | [MCP のトラブルシューティング](/docs/ja/agent-sdk/mcp#troubleshooting) |

17| プラグインが読み込まれない、プラグインスキルが表示されない | [プラグインのトラブルシューティング](/docs/ja/agent-sdk/plugins#troubleshooting) |17| プラグインが読み込まれない、プラグインスキルが表示されない | [プラグインのトラブルシューティング](/docs/ja/agent-sdk/plugins#troubleshooting) |

18| Claude がサブエージェントに委譲しない、ファイルシステムベースのエージェントが読み込まれない | [サブエージェントのトラブルシューティング](/docs/ja/agent-sdk/subagents#troubleshooting) |18| Claude がサブエージェントに委譲しない、ファイルシステムベースのエージェントが読み込まれない | [サブエージェントのトラブルシューティング](/docs/ja/agent-sdk/subagents#troubleshooting) |

19| チェックポイントオプションが認識されない、UUID なしのユーザーメッセージ、`No file checkpoint found`、`File rewinding is not enabled`、`ProcessTransport is not ready for writing` | [ファイルチェックポイントのトラブルシューティング](/docs/ja/agent-sdk/file-checkpointing#troubleshooting) |19| チェックポイントオプションが認識されない、UUID なしのユーザーメッセージ、`No file checkpoint found`、`File rewinding is not enabled`、`ProcessTransport is not ready for writing` | [ファイルチェックポイントのトラブルシューティング](/docs/ja/agent-sdk/file-checkpointing#troubleshooting) |

agent-sdk/typescript.md +429 −417

Details

465 `resolveSettings()`465 `resolveSettings()`

466</h3>466</h3>

467 467

468CLI を生成せずに、CLI と同じマージエンジンを使用して、指定されたディレクトリの有効な Claude Code 設定を解決します。`query()` 呼び出しを呼び出す前に、設定がどのような設定を見るかを検査するために使用します。468Claude CLI を生成せずに、CLI と同じマージエンジンを使用して、指定されたディレクトリの有効な Claude Code 設定を解決します。`query()` 呼び出しがどのような設定を参照するかを、実際に呼び出す前に検査するために使用します。

469 469

470<Note>470<Note>

471 この関数はアルファ版であり、安定化前に API が変更される可能性があります。471 この関数はアルファ版であり、安定化前に API が変更される可能性があります。

493| :- | :- | :- | :- |493| :- | :- | :- | :- |

495| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | すべてのソース | どのファイルシステムソースをロードするか。ユーザー、プロジェクト、およびローカル設定をスキップするには `[]` を渡してください。[エンドポイント管理ポリシー](/docs/ja/managed-settings#delivery-mechanisms) はすべての場合にロードされます。`resolveSettings()` は `options.serverManagedSettings` を渡す場合のみサーバー管理設定を含めます |495| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | すべてのソース | どのファイルシステムソースをロードするか。ユーザー、プロジェクト、およびローカル設定をスキップするには `[]` を渡してください。[エンドポイント管理ポリシー](/docs/ja/managed-settings#delivery-mechanisms) はすべての場合にロードされます。`resolveSettings()` は `options.serverManagedSettings` を渡す場合のみサーバー管理設定を含めます |

496| `options.managedSettings` | `Settings` | `undefined` | 埋め込みホストによって提供されるポリシーティア設定。[`Options`](#options) の [`managedSettings`](#options) と同じルールに従います。ただし、`resolveSettings()` は設定された [`policyHelper`](/docs/ja/settings-reference#policyhelper) を実行しないため、スナップショットはライブセッションがドロップする設定を含めることができます |496| `options.managedSettings` | `Settings` | `undefined` | 埋め込みホストによって提供されるポリシーティア設定。[`Options` の `managedSettings`](#options) と同じルールに従います。ただし、`resolveSettings()` は設定された [`policyHelper`](/docs/ja/settings-reference#policyhelper) を実行しないため、スナップショットはライブセッションがドロップする設定を含めることができます |

498 498

499<h4 id="return-type-resolvedsettings">499<h4 id="return-type-resolvedsettings">

504 504

505| プロパティ | 型 | 説明 |505| プロパティ | 型 | 説明 |

506| :- | :- | :- |506| :- | :- | :- |

509| `sources` | `Array<{ source, settings, path?, policyOrigin? }>` | ソースごとの生の設定。最も低い優先度から最も高い優先度の順に並べられています |509| `sources` | `Array<{ source, settings, path?, policyOrigin? }>` | ソースごとの生の設定。優先順位の低いものから高いものの順に並べられています |

510 510

511<h4 id="example-5">511<h4 id="example-5">

512 例512 例

539| プロパティ | 型 | デフォルト | 説明 |539| プロパティ | 型 | デフォルト | 説明 |

540| :- | :- | :- | :- |540| :- | :- | :- | :- |

542| `additionalDirectories` | `string[]` | `[]` | Claude がアクセスできる追加ディレクトリ。SDK は各エントリを Claude Code に `--add-dir` として渡すため、`project` 設定ソースを使用すると Claude Code は [ディレクトリのスキル、コマンド、サブエージェントも読み込みます](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) |542| `additionalDirectories` | `string[]` | `[]` | Claude がアクセスできる追加のディレクトリ。SDK は各エントリを `--add-dir` として Claude Code に渡すため、`project` 設定ソースを使用している場合、Claude Code は[そのディレクトリのスキル、コマンド、サブエージェントも読み込みます](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) |

546| `allowDangerouslySkipPermissions` | `boolean` | `false` | 権限をバイパスすることを有効にします。`permissionMode: 'bypassPermissions'` を使用する場合に必須です。スタートアップ時またはその後 `setPermissionMode()` を通じて設定できます。[プランモード](/docs/ja/agent-sdk/permissions#plan-mode-plan)を参照して、`permissionMode: 'plan'` との相互作用を確認してください |546| `allowDangerouslySkipPermissions` | `boolean` | `false` | 権限のバイパスを有効にします。起動時、または後から `setPermissionMode()` を通じて `permissionMode: 'bypassPermissions'` を使用する場合に必須です。`permissionMode: 'plan'` との相互作用については [plan モード](/docs/ja/agent-sdk/permissions#plan-mode-plan)を参照してください |

547| `allowedTools` | `string[]` | `[]` | プロンプトなしで自動承認するツール。これは Claude をこれらのツールのみに制限しません。[タスク追跡ツール](/docs/ja/agent-sdk/todo-tracking#model-availability)の 1 つをここに名前を付けると、Claude Code もセッションをオプトインします。リストされていない他のツールは `permissionMode` と `canUseTool` にフォールスルーします。`disallowedTools` を使用してツールをブロックします。[権限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を参照してください |547| `allowedTools` | `string[]` | `[]` | プロンプトを表示せずに自動承認するツール。これは Claude をこれらのツールのみに制限するものではありません。ここで[タスク追跡ツール](/docs/ja/agent-sdk/todo-tracking#model-availability)のいずれかを指定すると、Claude Code はセッションでもその機能を有効にします。リストにないその他のツールは `permissionMode` と `canUseTool` にフォールスルーします。ツールをブロックするには `disallowedTools` を使用します。[権限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を参照してください |

549| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | カスタム権限関数。[権限フロー](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)がプロンプトにフォールスルーする場合にのみ呼び出されます。`allowedTools`、許可ルール、または `permissionMode` で自動承認された呼び出しには呼び出されません。許可ルールは [どのモードも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認しません。詳細は [`CanUseTool`](#canusetool) を参照してください |549| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | カスタム権限関数。[権限フロー](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)がプロンプトにフォールスルーした場合にのみ呼び出されます。`allowedTools`、許可ルール、または `permissionMode` によって自動承認された呼び出しでは呼び出されません。許可ルールは[どのモードでも自動承認されないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認しません。詳細は [`CanUseTool`](#canusetool) を参照してください |

554| `disallowedTools` | `string[]` | `[]` | 拒否するツール。`"Bash"` のような単純な名前はツールを Claude のコンテキストから削除します。`"Bash(rm *)"` のようなスコープ付きルールはツールを利用可能なままにし、[書かれたコマンド](/docs/ja/permissions#bash-rule-limits)に対して `bypassPermissions` を含むすべての権限モードで一致する呼び出しを拒否します。[権限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を参照してください |554| `disallowedTools` | `string[]` | `[]` | 拒否するツール。`"Bash"` のような名前のみの指定は、ツールを Claude のコンテキストから削除します。`"Bash(rm *)"` のようなスコープ付きルールはツールを利用可能なままにし、`bypassPermissions` を含むすべての権限モードで、[記述されたとおりの](/docs/ja/permissions#bash-rule-limits)コマンドに一致する呼び出しを拒否します。[権限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を参照してください |

557| `env` | `Record<string, string \| undefined>` | `process.env` | 環境変数。設定すると、このサブプロセス環境を `process.env` とマージするのではなく置き換えるため、`PATH` のような継承変数を保持するには `{ ...process.env, YOUR_VAR: 'value' }` を渡してください。このパターンの例は [遅いまたは停止した API レスポンスを処理](#handle-slow-or-stalled-api-responses)を参照し、基盤となる CLI が読み取る変数については [環境変数](/docs/ja/env-vars)を参照してください。`CLAUDE_AGENT_SDK_CLIENT_APP` を設定して User-Agent ヘッダーでアプリを識別します |557| `env` | `Record<string, string \| undefined>` | `process.env` | 環境変数。設定すると、`process.env` とマージされるのではなくサブプロセスの環境を置き換えるため、`PATH` などの継承された変数を保持するには `{ ...process.env, YOUR_VAR: 'value' }` を渡してください。このパターンの例については[遅い API レスポンスや停止した API レスポンスに対処する](#handle-slow-or-stalled-api-responses)を、基盤となる CLI が読み取る変数については[環境変数](/docs/ja/env-vars)を参照してください。User-Agent ヘッダーでアプリを識別するには `CLAUDE_AGENT_SDK_CLIENT_APP` を設定します |

560| `extraArgs` | `Record<string, string \| null>` | `{}` | 追加引数 |560| `extraArgs` | `Record<string, string \| null>` | `{}` | 追加の引数 |

561| `fallbackModel` | `string` | `undefined` | プライマリモデルが失敗した場合に使用するモデル。カンマ区切りリストを受け入れます。順序と上限については [フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)を参照してください。ガイダンスについては [モデルを選択](/docs/ja/agent-sdk/configuration#choose-a-model)を参照してください |561| `fallbackModel` | `string` | `undefined` | プライマリモデルが失敗した場合に使用するモデル。カンマ区切りのリストを受け付けます。順序と上限については[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)を参照してください。ガイダンスについては[モデルを選択する](/docs/ja/agent-sdk/configuration#choose-a-model)を参照してください |

563| `forwardSubagentText` | `boolean` | `false` | サブエージェントのテキストと思考ブロックをアシスタントおよびユーザーメッセージとして `parent_tool_use_id` を設定して転送し、コンシューマーがネストされたトランスクリプトをレンダリングできるようにします。このオプションがない場合、Claude Code はサブエージェント `tool_use` および `tool_result` ブロックを出力しますが、テキストまたは思考は出力しません。すべてのネストの深さのサブエージェントからのメッセージは Claude Code v2.1.219 以降で転送されます。v2.1.219 より前では、深さ 1 のサブエージェントからのメッセージのみが表示されました。フォークされたスキルが生成するサブエージェントのメッセージ、およびネストされたフォークされたスキルのメッセージには v2.1.275 以降が必要です |563| `forwardSubagentText` | `boolean` | `false` | サブエージェントのテキストと思考ブロックを、`parent_tool_use_id` が設定されたアシスタントメッセージおよびユーザーメッセージとして転送し、コンシューマーがネストされたトランスクリプトをレンダリングできるようにします。このオプションがない場合、Claude Code はサブエージェントの `tool_use` ブロックと `tool_result` ブロックを出力しますが、テキストや思考は出力しません。Claude Code v2.1.219 以降では、すべてのネスト深度のサブエージェントからのメッセージが転送されます。v2.1.219 より前は、深度 1 のサブエージェントからのメッセージのみが表示されていました。フォークされたスキルが生成するサブエージェントのメッセージ、およびネストされたフォークされたスキルのメッセージには v2.1.275 以降が必要です |

564| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | イベントのフックコールバック |564| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | イベントのフックコールバック |

565| `includeHookEvents` | `boolean` | `false` | フックライフサイクルイベントをメッセージストリームに [`SDKHookStartedMessage`](#sdkhookstartedmessage)、[`SDKHookProgressMessage`](#sdkhookprogressmessage)、および [`SDKHookResponseMessage`](#sdkhookresponsemessage) として含めます。`SessionStart` および `Setup` フックのライフサイクルイベントは常に含まれ、このオプションは不要です。`Notification`、`SessionEnd`、`PreCompact`、`PostCompact` などの一部のフックイベントは、このオプションを使用しても `SDKHookStartedMessage` を生成しません。これらのイベントについては、Claude Code はコマンドフックが 1 秒以上実行される場合に出力を生成する `SDKHookProgressMessage` を出力し、[バックグラウンドで実行](/docs/ja/hooks#run-hooks-in-the-background)するフックが完了した場合にのみ `SDKHookResponseMessage` を出力します |565| `includeHookEvents` | `boolean` | `false` | フックのライフサイクルイベントを [`SDKHookStartedMessage`](#sdkhookstartedmessage)、[`SDKHookProgressMessage`](#sdkhookprogressmessage)、[`SDKHookResponseMessage`](#sdkhookresponsemessage) としてメッセージストリームに含めます。`SessionStart` フックと `Setup` フックのライフサイクルイベントは常に含まれるため、このオプションは不要です。`Notification`、`SessionEnd`、`PreCompact`、`PostCompact` など一部のフックイベントは、このオプションを指定しても `SDKHookStartedMessage` を生成しません。これらのイベントでも、1 秒以上実行されるコマンドフックが出力を生成している間は Claude Code は `SDKHookProgressMessage` を出力し、`SDKHookResponseMessage` は[バックグラウンドで実行される](/docs/ja/hooks#run-hooks-in-the-background)フックが終了した場合にのみ出力します |

568| `managedSettings` | `Settings` | `undefined` | ホストプロセスがスポーンされたセッションに提供するポリシー層設定。管理者がデプロイした管理設定を持つマシンでは、管理者の最優先管理ソースが `parentSettingsBehavior: 'merge'` を設定しない限り、Claude Code はこれらを無視し、[`policyHelper`](/docs/ja/settings-reference#policyhelper) が管理設定を提供している間はマージしません。マージされた値は制限のみのフィルターを通過します。[親設定を制限](/docs/ja/claude-apps-gateway#restrict-parent-settings)はフィルターが許可するものと `allowManaged*Only` ロックをカバーしています。[`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ja/env-vars) を設定するホストには、このペイロードから直接読み取られる 3 つのキーがあります。Claude Code v2.1.222 以降の [モデル設定](/docs/ja/model-config#restrict-model-selection)、管理ソースが設定していない場合の v2.1.246 以降の [`modelPricing`](/docs/ja/settings-reference#modelpricing)、および v2.1.247 以降の `ENABLE_TOOL_SEARCH` env エントリ |568| `managedSettings` | `Settings` | `undefined` | ホストプロセスが生成されたセッションに提供するポリシー層の設定。管理者がデプロイした管理設定があるマシンでは、管理者の優先順位が最も高い管理ソースが `parentSettingsBehavior: 'merge'` を設定していない限り Claude Code はこれらを無視し、[`policyHelper`](/docs/ja/settings-reference#policyhelper) が管理設定を提供している間は決してマージしません。マージされた値は制限のみを許可するフィルターを通過します。フィルターが許可する内容と `allowManaged*Only` ロックについては[親設定を制限する](/docs/ja/claude-apps-gateway#restrict-parent-settings)で説明しています。[`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ja/env-vars) を設定するホストでは、次の 3 つのキーが代わりにこのペイロードから直接読み取られます。Claude Code v2.1.222 以降ではその[モデル設定](/docs/ja/model-config#restrict-model-selection)、v2.1.246 以降ではどの管理ソースも設定していない場合の [`modelPricing`](/docs/ja/settings-reference#modelpricing)、v2.1.247 以降ではその `ENABLE_TOOL_SEARCH` env エントリです |

569| `maxBudgetUsd` | `number` | `undefined` | クライアント側のコスト推定がこの USD 値に達したときにクエリを停止します。呼び出し自体の支出のみをカウントします。再開されたセッションから復元された合計はカウントされません。精度の注意事項とリセット動作については [コストと使用状況を追跡](/docs/ja/agent-sdk/cost-tracking)を参照してください |569| `maxBudgetUsd` | `number` | `undefined` | クライアント側のコスト見積もりがこの USD 値に達したらクエリを停止します。この呼び出し自体の支出のみがカウントされ、再開されたセッションから復元された合計はカウントされません。精度に関する注意点とリセット動作については[コストと使用量を追跡する](/docs/ja/agent-sdk/cost-tracking)を参照してください |

572| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | MCP サーバー設定 |572| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | MCP サーバーの設定 |

574| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | MCP 誘導リクエストを処理するためのコールバック。MCP サーバーがユーザー入力をリクエストし、フックが最初に処理しない場合に呼び出されます。提供されない場合、処理されない誘導リクエストは自動的に拒否されます |574| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | MCP elicitation リクエストを処理するためのコールバック。MCP サーバーがユーザー入力を要求し、どのフックも先に処理しない場合に呼び出されます。指定しない場合、処理されない elicitation リクエストは自動的に拒否されます |

575| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | エージェント結果の出力形式を定義します。詳細は [構造化出力](/docs/ja/agent-sdk/structured-outputs)を参照してください |575| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | エージェントの結果の出力形式を定義します。詳細は[構造化出力](/docs/ja/agent-sdk/structured-outputs)を参照してください |

576| `outputStyle` | `string` | `undefined` | `Options` フィールドではありません。インライン [`settings`](/docs/ja/settings) オブジェクトまたは設定ファイルで `outputStyle` を設定してください。[出力スタイルを有効化](/docs/ja/agent-sdk/modifying-system-prompts#activate-an-output-style)を参照してください |576| `outputStyle` | `string` | `undefined` | `Options` のフィールドではありません。代わりに、インラインの [`settings`](/docs/ja/settings) オブジェクトまたは設定ファイルで `outputStyle` を設定してください。[出力スタイルを有効にする](/docs/ja/agent-sdk/modifying-system-prompts#activate-an-output-style)を参照してください |

578| `permissionMode` | [`PermissionMode`](#permissionmode) | `undefined` | セッションの権限モード。省略した場合、セッションはオートモードで開始できます。Claude Code がスタート権限モードを選択する方法については [権限モード](/docs/ja/agent-sdk/permissions#permission-modes)を参照してください |578| `permissionMode` | [`PermissionMode`](#permissionmode) | `undefined` | セッションの権限モード。省略した場合、セッションは auto モードで開始される可能性があります。Claude Code が開始時の権限モードをどのように選択するかについては[権限モード](/docs/ja/agent-sdk/permissions#permission-modes)を参照してください |

580| `permissionPrompts` | `'host' \| 'none'` | `'host'` | 権限プロンプトに応答する者: `'host'` はそれらを [`canUseTool`](#canusetool) コールバックまたは `permissionPromptToolName` ツールにルーティングし、`'none'` は [プロンプトが表示されるはずだった呼び出しを拒否](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)します。Claude Code v2.1.259 以降が必要です |580| `permissionPrompts` | `'host' \| 'none'` | `'host'` | 権限プロンプトに誰が応答するかを指定します。`'host'` はプロンプトを [`canUseTool`](#canusetool) コールバックまたは `permissionPromptToolName` ツールにルーティングし、`'none'` は[プロンプトを表示するはずだった呼び出しを拒否します](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)。Claude Code v2.1.259 以降が必要です |

584| `projectConfigRoot` | `string` | `undefined` | `cwd` がワークツリーである信頼できるチェックアウトの絶対パス。Claude Code はプロジェクト設定、`.mcp.json`、およびプロジェクトの `.claude/` コマンド、エージェント、スキル、ワークフロー、ルーチン、および出力スタイルをこのディレクトリから `cwd` の代わりに読み取り、`CLAUDE_PROJECT_DIR` をそれに設定します。フック、`apiKeyHelper` などのヘルパースクリプト、および stdio MCP サーバーはこのディレクトリをワーキングディレクトリとして開始します。`CLAUDE.md` ファイルと `.claude/rules/` は引き続き `cwd` から読み込まれます。Claude Code v2.1.275 以降が必要です |584| `projectConfigRoot` | `string` | `undefined` | `cwd` がその worktree となっている信頼済みチェックアウトの絶対パス。Claude Code は、プロジェクト設定、`.mcp.json`、およびプロジェクトの `.claude/` のコマンド、エージェント、スキル、ワークフロー、ルーティン、出力スタイルを `cwd` ではなくこのディレクトリから読み取り、`CLAUDE_PROJECT_DIR` をこのディレクトリに設定します。フック、`apiKeyHelper` などのヘルパースクリプト、stdio MCP サーバーは、このディレクトリを作業ディレクトリとして起動します。`CLAUDE.md` ファイルと `.claude/rules/` は引き続き `cwd` から読み込まれます。Claude Code v2.1.275 以降が必要です |

585| `promptSuggestions` | `boolean` | `false` | プロンプト提案を有効にします。ターン後、Claude Code は予測される次のユーザープロンプトを含む `prompt_suggestion` メッセージを出力します。アカウントが使用制限に近い、または達している場合など、一部のターンでは Claude Code は提案を生成しません。[Claude Code が提案をスキップする場合](/docs/ja/interactive-mode#when-claude-code-skips-suggestions)を参照してください |585| `promptSuggestions` | `boolean` | `false` | プロンプト候補を有効にします。ターンの後、Claude Code は予測された次のユーザープロンプトを含む `prompt_suggestion` メッセージを出力します。アカウントが使用制限に近づいているか達している間など、一部のターンでは Claude Code は候補を生成しません。[Claude Code が候補をスキップする場合](/docs/ja/interactive-mode#when-claude-code-skips-suggestions)を参照してください |

587| `resumeDropsTurn` | `string` | `undefined` | `resumeSessionAt` を使用: 切り詰め再開が破棄することを意図するターンのプロンプト UUID。破棄された範囲に、吸収されたキューに入ったメッセージやタスク通知など、そのターンに帰属しないものが含まれている場合、Claude Code は再開を拒否し、拒否メッセージで `--resume-drops-turn` フラグを名前付けします。Agent SDK とプリントモード再開のみがペアを読み取ります。Claude Code v2.1.223 以降が必要です |587| `resumeDropsTurn` | `string` | `undefined` | `resumeSessionAt` と併用します。切り詰めを伴う再開で破棄しようとするターンのプロンプト UUID です。破棄される範囲に、取り込まれたキュー内のメッセージやタスク通知など、そのターンに帰属しないものが含まれている場合、Claude Code は再開を拒否し、拒否メッセージで `--resume-drops-turn` フラグを示します。このペアを読み取るのは Agent SDK と print モードの再開のみです。Claude Code v2.1.223 以降が必要です |

591| `sessionStore` | [`SessionStore`](/docs/ja/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | セッショントランスクリプトを外部バックエンドにミラーリングして、別のホストがそれらを再開できるようにします。[セッションを外部ストレージに永続化](/docs/ja/agent-sdk/session-storage)を参照してください |591| `sessionStore` | [`SessionStore`](/docs/ja/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | 別のホストが再開できるように、セッションのトランスクリプトを外部バックエンドにミラーリングします。[外部ストレージにセッションを永続化する](/docs/ja/agent-sdk/session-storage)を参照してください |

594| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI デフォルト（すべてのソース） | どのファイルシステム設定を読み込むかを制御します。ユーザー、プロジェクト、ローカル設定を無効にするには `[]` を渡します。[エンドポイント管理ポリシー](/docs/ja/managed-settings#delivery-mechanisms)は関係なく読み込まれます。サーバー管理設定は、セッションが [適格な設定](/docs/ja/server-managed-settings#platform-availability)で組織認証情報を使用して認証する場合に取得されます。[Claude Code 機能を使用](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control)を参照してください |594| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI のデフォルト（すべてのソース） | 読み込むファイルシステム設定を制御します。ユーザー、プロジェクト、ローカルの設定を無効にするには `[]` を渡します。[エンドポイント管理ポリシー](/docs/ja/managed-settings#delivery-mechanisms)はこの指定に関係なく読み込まれます。サーバー管理設定は、セッションが[対象となる設定](/docs/ja/server-managed-settings#platform-availability)で組織の認証情報を使って認証される場合に取得されます。[Claude Code の機能を使用する](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control)を参照してください |

595| `skills` | `string[] \| 'all'` | `undefined` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `'all'` を渡すか、スキル名のリストを渡します。正確な名前のみを渡してください。Agent SDK v0.3.221 以降では、SDK は形式が正しくないワイルドカード形式の名前を Claude Code プロセスを開始する前にエラーで拒否します。設定すると、SDK は Skill ツールを `allowedTools` に自動的に追加します。`tools` も渡す場合は、そのリストに `'Skill'` を含めてください。[スキル](/docs/ja/agent-sdk/skills)を参照してください |595| `skills` | `string[] \| 'all'` | `undefined` | セッションで使用可能なスキル。検出されたすべてのスキルを有効にするには `'all'` を、またはスキル名のリストを渡します。正確な名前のみを渡してください。Agent SDK v0.3.221 以降では、SDK は Claude Code プロセスを開始する前に、不正な形式の名前とワイルドカード形式の名前をエラーで拒否します。設定すると、SDK は Skill ツールを自動的に `allowedTools` に追加します。`tools` も渡す場合は、そのリストに `'Skill'` を含めてください。[スキル](/docs/ja/agent-sdk/skills)を参照してください |

599| `systemPrompt` | `string \| string[] \| { type: 'custom'; prompt: string \| string[]; snapshot?: boolean } \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean; snapshot?: boolean }` | `undefined`（最小プロンプト） | システムプロンプト設定。カスタムプロンプトの場合は文字列を渡すか、Claude Code のシステムプロンプトを使用するには `{ type: 'preset', preset: 'claude_code' }` を渡します。エクスポートされた `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` 定数を静的部分とリクエストごとの部分の間に含む文字列の配列を渡して、[カスタムプロンプトの静的部分をキャッシュ](/docs/ja/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt)します。プリセットオブジェクト形式を使用する場合、追加の指示で拡張するには `append` を追加し、セッションごとのコンテキストを最初のユーザーメッセージに移動するには `excludeDynamicSections: true` を設定して、[マシン間でのプロンプトキャッシュの再利用を改善](/docs/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines)します。セッションが最初のリクエストで記録したプロンプトを再利用する代わりに、すべてのリクエストでプロンプトを再構築するには `snapshot: false` を設定します。カスタムプロンプトで `snapshot` を設定するには、`{ type: 'custom', prompt }` 形式を渡します。`{ type: 'custom' }` 形式と `snapshot` フィールドには TypeScript Agent SDK v0.3.257 以降が必要です |599| `systemPrompt` | `string \| string[] \| { type: 'custom'; prompt: string \| string[]; snapshot?: boolean } \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean; snapshot?: boolean }` | `undefined`（最小限のプロンプト） | システムプロンプトの設定。カスタムプロンプトには文字列を渡し、Claude Code のシステムプロンプトを使用するには `{ type: 'preset', preset: 'claude_code' }` を渡します。静的部分とリクエストごとの部分の間にエクスポートされた `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` 定数を挟んだ文字列の配列を渡すと、[カスタムプロンプトの静的部分をキャッシュ](/docs/ja/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt)できます。プリセットオブジェクト形式を使用する場合は、`append` を追加すると追加の指示で拡張でき、`excludeDynamicSections: true` を設定するとセッションごとのコンテキストを最初のユーザーメッセージに移動して[マシン間でのプロンプトキャッシュの再利用を改善](/docs/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines)できます。`snapshot: false` を設定すると、[セッションが最初のリクエストで記録したプロンプトを再利用する](/docs/ja/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session)代わりに、リクエストごとにプロンプトを再構築します。カスタムプロンプトで `snapshot` を設定するには、`{ type: 'custom', prompt }` 形式を渡します。`{ type: 'custom' }` 形式と `snapshot` フィールドには TypeScript Agent SDK v0.3.257 以降が必要です |

600| `taskBudget` | `{ total: number }` | `undefined` | *アルファ。* API 側のタスク予算（トークン）。設定すると、モデルは残りのトークン予算を知らされるため、ツール使用のペースを調整し、制限前にラップアップできます |600| `taskBudget` | `{ total: number }` | `undefined` | *アルファ版。* トークン単位の API 側のタスク予算。設定すると、モデルに残りのトークン予算が伝えられ、モデルはツールの使用ペースを調整して上限に達する前に作業をまとめられるようになります |

601| `thinking` | [`ThinkingConfig`](#thinkingconfig) | サポートされているモデルの場合 `{ type: 'adaptive' }` | Claude の思考/推論動作を制御します。オプションについては [`ThinkingConfig`](#thinkingconfig)を参照してください |601| `thinking` | [`ThinkingConfig`](#thinkingconfig) | サポートされているモデルでは `{ type: 'adaptive' }` | Claude の思考/推論の動作を制御します。オプションについては [`ThinkingConfig`](#thinkingconfig) を参照してください |

603| `toolAliases` | `Record<string, string>` | `undefined` | 組み込みツール名を MCP ツール名にマップして、Claude が組み込みの代わりに MCP 実装を呼び出すようにします。例えば、`{ Bash: 'mcp__workspace__bash' }` |603| `toolAliases` | `Record<string, string>` | `undefined` | 組み込みツール名を MCP ツール名にマッピングし、Claude が組み込みツールの代わりに MCP 実装を呼び出すようにします。例: `{ Bash: 'mcp__workspace__bash' }` |

605| `tools` | `string[] \| { type: 'preset'; preset: 'claude_code' }` | `undefined` | ツール設定。ツール名の配列を渡すか、プリセットを使用して Claude Code のデフォルトツールを取得します |605| `tools` | `string[] \| { type: 'preset'; preset: 'claude_code' }` | `undefined` | ツールの設定。ツール名の配列を渡すか、プリセットを使用して Claude Code のデフォルトツールを取得します |

606| `verbatimPrompts` | `boolean` | `false` | すべてのプロンプトを書かれたとおりに配信します。SDK は各ユーザーメッセージを `client_composed: true` で送信します。Claude Code がこれらのメッセージでスキップするものについては [`client_composed`](#sdkusermessage)を参照してください。プロンプトテキストにエンドユーザーが入力しなかったコンテンツが含まれている場合にこのオプションを使用します。ターンごとの制御については、これをオフのままにして、代わりにストリーミングされたメッセージで個別に `client_composed` を設定してください。TypeScript Agent SDK v0.3.280 以降と Claude Code v2.1.248 以降が必要です。これらの SDK バージョンにバンドルされている Claude Code バージョンは Claude Code 要件を満たしています |606| `verbatimPrompts` | `boolean` | `false` | すべてのプロンプトを記述されたとおりに配信します。SDK は各ユーザーメッセージを `client_composed: true` 付きで送信します。これらのメッセージで Claude Code がスキップする処理については [`client_composed`](#sdkusermessage) を参照してください。プロンプトテキストにエンドユーザーが入力していないコンテンツが含まれる場合にこのオプションを使用します。ターンごとに制御するには、このオプションをオフのままにして、代わりに個々のストリーミングされるメッセージで `client_composed` を設定します。TypeScript Agent SDK v0.3.280 以降と Claude Code v2.1.248 以降が必要です。これらの SDK バージョンにバンドルされている Claude Code のバージョンは Claude Code の要件を満たしています |

607 607

608<h4 id="handle-slow-or-stalled-api-responses">608<h4 id="handle-slow-or-stalled-api-responses">

609 遅いまたは停止した API レスポンスを処理609 遅い API レスポンスや停止した API レスポンスに対処する

610</h4>610</h4>

611 611

612CLI サブプロセスは、API タイムアウトと停止検出を制御するいくつかの環境変数を読み取ります。`env` オプションを通じてそれらを渡します:612CLI サブプロセスは、API のタイムアウトと停止検出を制御するいくつかの環境変数を読み取ります。これらは `env` オプションを通じて渡します。

613 613

614```typescript theme={null}614```typescript theme={null}

615import { query } from "@anthropic-ai/claude-agent-sdk";615import { query } from "@anthropic-ai/claude-agent-sdk";

627});627});

628```628```

629 629

630* `API_TIMEOUT_MS`: Anthropic クライアントのリクエストごとのタイムアウト（ミリ秒）。デフォルト `600000`。メインループとすべてのサブエージェントに適用されます。630* `API_TIMEOUT_MS`: Anthropic クライアントのリクエストごとのタイムアウト（ミリ秒）。デフォルトは `600000` です。メインループとすべてのサブエージェントに適用されます。

631* `CLAUDE_CODE_MAX_RETRIES`: 最大 API リトライ数。デフォルト `10`、上限 `15`。各リトライは独自の `API_TIMEOUT_MS` ウィンドウを取得するため、最悪の場合の壁時間は大約 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` プラスバックオフです。無人実行で長いアウタージを待つ必要がある場合は、[`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/ja/errors#tune-retry-behavior) を設定します。一時的な容量エラーを無限に再試行し、Claude Code v2.1.199 以降では、他の一時的なエラーのデフォルトを `300` に引き上げ、この変数の上限を削除します。631* `CLAUDE_CODE_MAX_RETRIES`: API の最大再試行回数。デフォルトは `10` で、上限は `15` です。各再試行にはそれぞれ `API_TIMEOUT_MS` の時間枠が与えられるため、最悪の場合の経過時間はおおよそ `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` にバックオフを加えた値になります。より長い障害を待ち続ける必要がある無人実行では、[`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/ja/errors#tune-retry-behavior) を設定してください。これにより一時的な容量エラーが無期限に再試行され、Claude Code v2.1.199 以降ではその他の一時的なエラーのデフォルトが `300` に引き上げられ、この変数の上限が撤廃されます。

632* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: サブエージェントの停止ウォッチドッグ。ストリームウォッチドッグがオンの場合、デフォルトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` プラス 5 分で、その変数を引き上げない限り `600000` になります。ストリームウォッチドッグがオフの場合、デフォルトは `600000` です。v2.1.257 より前では、デフォルトは常に `600000` でした。632* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: サブエージェントの停止ウォッチドッグ。ストリームウォッチドッグが有効な間、デフォルトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` に 5 分を加えた値で、その変数を引き上げない限り `600000` になります。ストリームウォッチドッグが無効の場合、デフォルトは `600000` です。v2.1.257 より前は、デフォルトは常に `600000` でした。

633 633

634 タイマーは各ストリームイベントでリセットされます。停止時、Claude Code はサブエージェントを中止し、停止を親に報告します。バックグラウンドサブエージェントの場合、タスクも失敗とマークし、部分的な結果を添付します。634 タイマーはストリームイベントのたびにリセットされます。停止が発生すると、Claude Code はサブエージェントを中止し、停止を親に報告します。バックグラウンドのサブエージェントの場合は、さらにタスクを失敗としてマークし、部分的な結果があれば添付します。

635* `CLAUDE_ENABLE_STREAM_WATCHDOG` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: ヘッダーが到着したがレスポンスボディがストリーミングを停止したときにリクエストを中止するストリームウォッチドッグ。ウォッチドッグはすべてのプロバイダーでデフォルトでオンです。無効にするには `CLAUDE_ENABLE_STREAM_WATCHDOG=0` を設定します。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` はデフォルト `300000` で、その最小値にクランプされます。中止後、[自動リトライ](/docs/ja/errors#automatic-retries)は Claude Code が何をするかをカバーしており、レスポンスがどこまで進んだかに基づいています。635* `CLAUDE_ENABLE_STREAM_WATCHDOG` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: ヘッダーは到着したもののレスポンスボディのストリーミングが停止した場合にリクエストを中止するストリームウォッチドッグ。ウォッチドッグはすべてのプロバイダーでデフォルトで有効です。無効にするには `CLAUDE_ENABLE_STREAM_WATCHDOG=0` を設定します。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` のデフォルトは `300000` で、この値が最小値として適用されます。中止後に Claude Code がレスポンスの進行状況に応じて何を行うかについては、[自動再試行](/docs/ja/errors#automatic-retries)で説明しています。

636 636

637 ウォッチドッグが `ANTHROPIC_BASE_URL` の背後にあるゲートウェイが保持するレスポンスを待っている間、キープアライブピングで、`includePartialMessages` を設定するホストは引き続き `ping` [ストリームイベント](#sdkpartialassistantmessage)を受け取るため、これらのフレームを沈黙でセッションをタイムアウトするのではなく活性度として読み取ってください。v2.1.257 より前では、フレームは最後の実際のストリームイベントから 5 分後に停止しました。637 `ANTHROPIC_BASE_URL` の背後にあるゲートウェイがキープアライブ ping でレスポンスを開いたままにしている間、ウォッチドッグはそのレスポンスを待ち続けます。その間も `includePartialMessages` を設定しているホストは `ping` [ストリームイベント](#sdkpartialassistantmessage)を受信し続けるため、無通信を理由にセッションをタイムアウトさせるのではなく、これらのフレームを生存確認として扱ってください。v2.1.257 より前は、最後の実際のストリームイベントから 5 分後にフレームが停止していました。

638 638

639<h3 id="query-object">639<h3 id="query-object">

640 `Query` オブジェクト640 `Query` オブジェクト

641</h3>641</h3>

642 642

643`query()` 関数によって返されるインターフェース。643`query()` 関数が返すインターフェースです。

644 644

645```typescript theme={null}645```typescript theme={null}

646interface Query extends AsyncGenerator<SDKMessage, void> {646interface Query extends AsyncGenerator<SDKMessage, void> {

696 696

697| メソッド | 説明 |697| メソッド | 説明 |

698| :- | :- |698| :- | :- |

699| `interrupt()` | クエリを中断します。ストリーミング入力モードでのみ利用可能です。CLI が [`SDKSystemMessage.capabilities`](#sdksystemmessage) で `interrupt_receipt_v1` 機能をアドバタイズする場合、中断が到着したときに保留中だったメッセージをリストする [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) で解決します。v2.1.205 より前の CLI では `undefined` で解決します |699| `interrupt()` | クエリを中断します。ストリーミング入力モードでのみ使用できます。CLI が [`SDKSystemMessage.capabilities`](#sdksystemmessage) で `interrupt_receipt_v1` ケイパビリティを通知している場合、中断が到着した時点で保留中だったメッセージを一覧にした [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) で解決されます。v2.1.205 より前の CLI では `undefined` で解決されます |

700| `rewindFiles(userMessageId, options?)` | ファイルを指定されたユーザーメッセージの状態に復元します。`{ dryRun: true }` を渡して変更をプレビューします。`enableFileCheckpointing: true` が必要です。[ファイルチェックポイント](/docs/ja/agent-sdk/file-checkpointing)を参照してください |700| `rewindFiles(userMessageId, options?)` | 指定したユーザーメッセージ時点の状態にファイルを復元します。変更をプレビューするには `{ dryRun: true }` を渡します。`enableFileCheckpointing: true` が必要です。[ファイルチェックポイント機能](/docs/ja/agent-sdk/file-checkpointing)を参照してください |

702| `setModel()` | モデルを変更します（ストリーミング入力モードでのみ利用可能）。`undefined` または文字列 `"default"` を渡すと、[Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットされます |702| `setModel()` | モデルを変更します（ストリーミング入力モードでのみ使用可能）。`undefined` または文字列 `"default"` を渡すと、[Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットされます |

703| `setMaxThinkingTokens()` | *非推奨:* 代わりに `thinking` オプションを使用してください。最大思考トークンを変更します。`null` を渡すと、思考をセッションデフォルトにリセットします。セッション中のオーバーライドはクリアされ、思考が無効になっているセッションでは思考はオフのままです |703| `setMaxThinkingTokens()` | *非推奨:* 代わりに `thinking` オプションを使用してください。最大思考トークン数を変更します。`null` を渡すと思考がセッションのデフォルトにリセットされます。セッション途中の上書きはクリアされ、思考が無効になっているセッションでは思考は無効のままです |

704| `applyFlagSettings(settings)` | ランタイムでセッションのフラグ設定層に設定をマージします（ストリーミング入力モードでのみ利用可能）。[`applyFlagSettings()`](#applyflagsettings)を参照してください |704| `applyFlagSettings(settings)` | 実行時にセッションのフラグ設定レイヤーに設定をマージします（ストリーミング入力モードでのみ使用可能）。[`applyFlagSettings()`](#applyflagsettings) を参照してください |

705| `updateSettings(source, settings)` | プロジェクトのローカル設定ファイルまたはユーザー設定ファイルに 1 つのホワイトリストキーを書き込み、値が後のセッションで永続化されるようにします。[`updateSettings()`](#updatesettings)を参照してください。TypeScript SDK v0.3.257 以降が必要で、Claude Code v2.1.257 をバンドルしています |705| `updateSettings(source, settings)` | 許可リストに含まれる 1 つのキーをプロジェクトのローカル設定ファイルまたはユーザー設定ファイルに書き込み、その値を以降のセッションにも保持します。[`updateSettings()`](#updatesettings) を参照してください。TypeScript SDK v0.3.257 以降が必要です（Claude Code v2.1.257 がバンドルされています） |

707| `reinitialize()` | 実行中の CLI に `initialize` 制御リクエストを再送信し、キャッシュされた最初の接続結果の代わりに新しい結果を返します。トランスポートギャップ後（セッションを切断後に再接続するなど）に使用して、保留中の権限リクエストが `canUseTool` コールバックに再度到達するようにします。リクエスト ID ごとにコールバックをべき等にしてください。応答が失われたリクエストは再度ディスパッチされるためです。Claude Code v2.1.195 以降が必要です |707| `reinitialize()` | 実行中の CLI に `initialize` コントロールリクエストを再送信し、キャッシュされた初回接続時の結果ではなく新しい結果を返します。切断後にセッションに再接続する場合など、トランスポートの途絶後に使用すると、保留中の権限リクエストが再び `canUseTool` コールバックに届きます。レスポンスが失われたリクエストは再度ディスパッチされるため、コールバックはリクエスト ID ごとに冪等にしてください。Claude Code v2.1.195 以降が必要です |

708| `supportedCommands()` | 利用可能なコマンドを返します。Agent SDK v0.3.216 からリストはセッション中のコマンド変更を反映します。[`SDKCommandsChangedMessage`](#sdkcommandschangedmessage)を参照してください |708| `supportedCommands()` | 使用可能なコマンドを返します。Agent SDK v0.3.216 以降、このリストにはセッション途中のコマンドの変更が反映されます。[`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) を参照してください |

712| `getContextUsage(opts?)` | セッションのコンテキストウィンドウ使用状況をカテゴリ、スキル、ツール別に分類する [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse)を返します。デフォルト `detail` では、対話型セッションで `/context` が表示するのと同じデータで、メッセージストリームに表示されないトークンカウント API リクエストで計算されます。[これらのリクエストがどのように処理されるか](#sdkcontrolgetcontextusageresponse)を参照してください。[`detail` オプション](#sdkcontrolgetcontextusageresponse)には Agent SDK v0.3.257 以降が必要です |712| `getContextUsage(opts?)` | セッションのコンテキストウィンドウの使用量をカテゴリ、スキル、ツールごとに分類した [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) を返します。デフォルトの `detail` では、インタラクティブセッションで `/context` が表示するものと同じデータで、メッセージストリームに現れないトークンカウント API リクエストを使って計算されます。[これらのリクエストの扱い](#sdkcontrolgetcontextusageresponse)を参照してください。[`detail` オプション](#sdkcontrolgetcontextusageresponse)には Agent SDK v0.3.257 以降が必要です |

713| `readFile(path, options?)` | セッションのファイルシステムからファイルを読み取ります。Claude Code はパスを `cwd` に対して解決します。[`readFile()` が読み取れるもの](#what-readfile-can-read)は提供するファイルをリストします。`{ maxBytes }` を渡して読み取りキャップを変更し（デフォルト 1 MB、上限 10 MB）、`{ encoding: 'base64' }` を画像などのバイナリファイルに渡します。[`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse)で解決するか、権限拒否、ファイルの欠落、またはトランスポートエラーで `null` で解決します。TypeScript SDK v0.2.121 以降が必要です |713| `readFile(path, options?)` | セッションのファイルシステムからファイルを読み取ります。Claude Code はパスを `cwd` に対して解決します。提供されるファイルについては [`readFile()` が読み取れるもの](#what-readfile-can-read)に記載しています。読み取り上限（デフォルト 1 MB、最大 10 MB）を変更するには `{ maxBytes }` を、画像などのバイナリファイルには `{ encoding: 'base64' }` を渡します。[`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse) で解決されるか、権限の拒否、ファイルが存在しない場合、またはトランスポートエラーの場合は `null` で解決されます。TypeScript SDK v0.2.121 以降が必要です |

714| `reloadPlugins(options?)` | ディスクからプラグインを再読み込みして、セッション中にインストールまたは編集したプラグインが実行中のセッションに到達するようにします。セッションのコマンド、サブエージェント、プラグイン、および MCP サーバーステータスをリストする [`SDKControlReloadPluginsResponse`](#sdkcontrolreloadpluginsresponse)で解決します。Agent SDK v0.2.85 以降が必要です。[`holdOnCacheImpact` オプション](#sdkcontrolreloadpluginsresponse)には Agent SDK v0.3.268 以降が必要です |714| `reloadPlugins(options?)` | ディスクからプラグインを再読み込みし、セッション途中にインストールまたは編集したプラグインを実行中のセッションに反映させます。セッションのコマンド、サブエージェント、プラグイン、MCP サーバーのステータスを一覧にした [`SDKControlReloadPluginsResponse`](#sdkcontrolreloadpluginsresponse) で解決されます。Agent SDK v0.2.85 以降が必要です。[`holdOnCacheImpact` オプション](#sdkcontrolreloadpluginsresponse)には Agent SDK v0.3.268 以降が必要です |

715| `reloadSkills()` | ディスクからスキルを再読み込みして、セッション中に追加または編集したスキルが実行中のセッションで利用可能になるようにします。再読み込み後に利用可能なスキルをリストする [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse)で解決します。Agent SDK v0.3.163 以降が必要です |715| `reloadSkills()` | ディスクからスキルを再読み込みし、セッション途中に追加または編集したスキルを実行中のセッションで使用できるようにします。再読み込み後に使用可能なスキルを一覧にした [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse) で解決されます。Agent SDK v0.3.163 以降が必要です |

716| `reloadOutputStyles()` | ディスクから [出力スタイル](/docs/ja/output-styles)を再読み込みして、セッション中に追加または編集したスタイルファイルが実行中のセッションで利用可能になるようにします。再読み込み後に利用可能なスタイル名をリストする [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse)で解決します。Agent SDK v0.3.261 以降が必要です |716| `reloadOutputStyles()` | ディスクから[出力スタイル](/docs/ja/output-styles)を再読み込みし、セッション途中に追加または編集したスタイルファイルを実行中のセッションで使用できるようにします。再読み込み後に使用可能なスタイル名を一覧にした [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) で解決されます。Agent SDK v0.3.261 以降が必要です |

718| `reconnectMcpServer(serverName)` | MCP サーバーを名前で再接続します。名前が `.mcp.json` または `~/.claude.json` などの設定ファイルのエントリとも一致する場合、Claude Code は設定ファイルエントリではなく、[`mcpServers`](#options)または `setMcpServers()` を通じて設定したサーバーを再接続します。その解決順序には Claude Code v2.1.257 以降が必要です |718| `reconnectMcpServer(serverName)` | 名前を指定して MCP サーバーに再接続します。その名前が `.mcp.json` や `~/.claude.json` などの設定ファイル内のエントリにも一致する場合、Claude Code は設定ファイルのエントリではなく、[`mcpServers`](#options) または `setMcpServers()` で設定したサーバーに再接続します。この解決順序には Claude Code v2.1.257 以降が必要です |

719| `toggleMcpServer(serverName, enabled)` | `reconnectMcpServer()` と同じ名前解決で、名前を指定して MCP サーバーを有効または無効にします。サーバーを無効にすると、接続が切断され、そのツールが削除されます。サーバーの種類ごとに必要な Claude Code のバージョンについては [`toggleMcpServer()`](#togglemcpserver) を参照してください |719| `toggleMcpServer(serverName, enabled)` | `reconnectMcpServer()` と同じ名前解決で、名前を指定して MCP サーバーを有効化または無効化します。サーバーを無効にすると、接続が切断され、そのツールが削除されます。サーバーの種類ごとに必要な Claude Code のバージョンについては [`toggleMcpServer()`](#togglemcpserver) を参照してください |

720| `setMcpServers(servers)` | このセッションの MCP サーバーセットを動的に置き換えます。追加および削除されたサーバーと任意のエラーを名前付けする [`McpSetServersResult`](#mcpsetserversresult)で解決します |720| `setMcpServers(servers)` | このセッションの MCP サーバーのセットを動的に置き換えます。追加および削除されたサーバーとエラーを示す [`McpSetServersResult`](#mcpsetserversresult) で解決されます |

721| `readMcpResource(serverName, uri)` | *アルファ。* 接続された MCP サーバーから 1 つの MCP Apps `ui://` リソースを読み取り、アプリケーションがツールのウィジェットをレンダリングできるようにします。[`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse)で解決します。TypeScript Agent SDK v0.3.280 以降が必要です |721| `readMcpResource(serverName, uri)` | *アルファ版。* アプリケーションがツールのウィジェットをレンダリングできるように、接続されている MCP サーバーから MCP Apps の `ui://` リソースを 1 つ読み取ります。[`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse) で解決されます。TypeScript Agent SDK v0.3.280 以降が必要です |

725 725

726<h4 id="applyflagsettings">726<h4 id="applyflagsettings">

727 `applyFlagSettings()`727 `applyFlagSettings()`

728</h4>728</h4>

729 729

730実行中のセッションで [設定](/docs/ja/settings)を変更し、クエリを再開しません。セッション中に変更が必要な専用セッターがない設定（信頼できない入力を読み取った後に `permissions` を厳しくするなど）を使用する場合に使用します。`setModel()` と `setPermissionMode()` はこれら 2 つのキーの専用セッターです。`applyFlagSettings()` は `model` をここに渡すと `setModel()` と同じように動作する一般的な形式です。730クエリを再起動せずに、実行中のセッションの[設定](/docs/ja/settings)を変更します。エージェントが信頼できない入力を読み取った後に `permissions` を厳しくする場合など、専用のセッターがない設定項目をセッション途中で変更する必要があるときに使用します。`setModel()` と `setPermissionMode()` はそれぞれのキー専用のセッターです。`applyFlagSettings()` は設定キーの任意のサブセットを受け付ける汎用的な形式で、ここで `model` を渡すと `setModel()` と同じように動作します。

731 731

732一部のキーのみがセッション中に有効になります:732セッション途中で有効になるのは一部のキーのみです。

733 733

734* **次のターンで適用**: `effortLevel`、`ultracode`、`permissions`、`hooks`、`skillOverrides`、`fastMode`、`agent`。`agent` を切り替えると、そのエージェントのモデルオーバーライドとフックも次のターンで適用されます。そのシステムプロンプトは次のターンで、または [記録されたシステムプロンプトを再利用](/docs/ja/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session)するセッションではセッションがコンパクト化されると適用されます。734* **次のターンで適用**: `effortLevel`、`ultracode`、`permissions`、`hooks`、`skillOverrides`、`fastMode`、`agent`。`agent` を切り替えると、そのエージェントのモデルの上書きとフックも次のターンで適用されます。そのシステムプロンプトは次のターンで適用されますが、[記録されたシステムプロンプトを再利用する](/docs/ja/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session)セッションでは、セッションが圧縮された時点で適用されます。

735* **現在のターン中に適用**: `model`。Claude がターンで作業している間に `model` を切り替えると、Claude が既に生成しているレスポンスは古いモデルで完了し、ターンの残り（Claude Code がモデルに対して行う次の呼び出しから開始）は新しいモデルを使用します。サブエージェントは独自のモデルを保持します。v2.1.212 より前では、セッション中の切り替えは次のターンを待ちました。735* **現在のターン中に適用**: `model`。Claude がターンの作業中に `model` を切り替えると、Claude がすでに生成中の応答は古いモデルで完了し、Claude Code が次にモデルを呼び出すところから始まるターンの残りの部分では新しいモデルが使用されます。サブエージェントは独自のモデルを維持します。v2.1.212 より前は、ターン途中の切り替えは次のターンまで待機していました。

736* **セッション中に効果なし**: システムプロンプトオプション。これらはスタートアップで 1 回解決されるため、実行中のセッションは呼び出しが成功しても元の値を保持します。それらを変更するには、新しいセッションを開始してください。736* **セッション途中では効果なし**: システムプロンプトのオプション。これらは起動時に 1 回だけ解決されるため、呼び出しが成功しても実行中のセッションは元の値を保持します。変更するには、新しいセッションを開始してください。

737 737

738`effortLevel` は [努力レベル](/docs/ja/model-config#adjust-effort-level)名を受け入れます。また、`"ultracode"` も受け入れます。これは [ultracode](/docs/ja/workflows#let-claude-decide-with-ultracode)をオンにして `xhigh` 努力をリクエストします。`applyFlagSettings()` はその値なしで `effortLevel` を宣言するため、TypeScript では同じ結果に対して `{ ultracode: true, effortLevel: "xhigh" }` を渡すか、[`ultracode`](/docs/ja/settings-reference#ultracode)キーのみを渡して ultracode をセッションの現在の努力レベルでオンにします。`ultracode` 値には Claude Code v2.1.203 以降が必要で、設定ファイルの `effortLevel` キーではなく `applyFlagSettings()` によってのみ受け入れられます。v2.1.284 より前では、`ultracode` キーのみもレベルを `xhigh` に設定しました。738`effortLevel` は [effort レベル](/docs/ja/model-config#adjust-effort-level)の名前を受け付けます。また、[ultracode](/docs/ja/workflows#let-claude-decide-with-ultracode) をオンにした状態で `xhigh` の effort を要求する `"ultracode"` も受け付けます。`applyFlagSettings()` は `effortLevel` をこの値なしで宣言しているため、TypeScript で同じ結果を得るには `{ ultracode: true, effortLevel: "xhigh" }` を渡すか、セッションの現在の effort レベルのまま ultracode をオンにするには [`ultracode`](/docs/ja/settings-reference#ultracode) キーのみを渡します。`ultracode` 値には Claude Code v2.1.203 以降が必要で、`applyFlagSettings()` でのみ受け付けられ、設定ファイルの `effortLevel` キーでは受け付けられません。v2.1.284 より前は、`ultracode` キーのみを指定した場合もレベルが `xhigh` に設定されていました。

739 739

740値はフラグ設定層に書き込まれ、`query()` の `settings` オプションがスタートアップで設定したものにマージされます。これは [ページ上の優先順位セクション](#settings-precedence)がプログラムオプションと呼ぶのと同じ層です。740値はフラグ設定レイヤーに書き込まれ、起動時に `query()` のインライン `settings` オプションで設定された内容の上にマージされます。これは[このページの優先順位セクション](#settings-precedence)でプログラムによるオプションと呼んでいるのと同じ層です。

741 741

742連続した呼び出しは最上位キーを浅くマージします。`{ permissions: {...} }` を含む 2 番目の呼び出しは、前の呼び出しから `permissions` オブジェクト全体を置き換えるのではなく、深くマージします。742連続した呼び出しでは、トップレベルのキーが浅くマージされます。`{ permissions: {...} }` を指定した 2 回目の呼び出しは、前回の呼び出しの `permissions` オブジェクトに深くマージされるのではなく、オブジェクト全体を置き換えます。

743 743

744`applyFlagSettings()` で設定したキーをクリアするには、そのキーに `null` を渡します。ほとんどのキーは、最初に `query()` の `settings` オプションで設定された値にフォールバックし、次に低優先度のソースにフォールバックします。クリアされた `model` は、設定ファイルが `model` を設定している場合でも、[Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットされます。`undefined` を渡すと JSON シリアル化がそれをドロップするため効果がありません。744`applyFlagSettings()` で設定したキーをクリアするには、そのキーに `null` を渡します。ほとんどのキーはその後、まず起動時に `query()` の `settings` オプションで設定された値に、次に優先順位の低いソースにフォールバックします。クリアされた `model` は、設定ファイルで `model` が設定されている場合でも、[Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットされます。`undefined` を渡しても、JSON シリアライズで削除されるため効果はありません。

745 745

746`model` 以外の 3 つのキーはフォールバックする代わりにセッション状態をリセットします:746`model` 以外に、フォールバックする代わりにセッションの状態をリセットするキーが 3 つあります。

747 747

748* `effortLevel: null` は、`query()` の `effort` オプションまたは設定ファイルの `effortLevel` ではなく、セッションをモデルのデフォルト努力レベルに戻します。748* `effortLevel: null` は、`query()` の `effort` オプションや設定ファイルの `effortLevel` ではなく、セッションをモデルのデフォルトの effort レベルに戻します。

749* `agent: null` は、`query()` の `agent` オプションまたは設定ファイルの `agent` を復元するのではなく、次のターンから専用エージェントなしでメインスレッドを実行します。クリアされたエージェントが独自のモデルを適用していた場合、セッションはスタートアップで解決したモデルに戻ります。749* `agent: null` は、`query()` の `agent` オプションや設定ファイルの `agent` を復元するのではなく、次のターンからエージェントなしでメインスレッドを実行します。クリアされたエージェントが独自のモデルを適用していた場合、セッションは起動時に解決されたモデルに戻ります。

750* `ultracode: null` は `false` と同様に ultracode をオフにし、設定ファイルから `ultracode` 値を復元するのではなく。セッションは現在の努力レベルを保持するため、同じ呼び出しで `effortLevel` を渡して変更します。750* `ultracode: null` は、設定ファイルの `ultracode` 値を復元するのではなく、`false` と同様に ultracode をオフにします。セッションは現在の effort レベルを維持するため、変更するには同じ呼び出しで `effortLevel` を渡してください。

751 751

752ストリーミング入力モードでのみ利用可能で、`setModel()` と `setPermissionMode()` と同じ制約があります。752`setModel()` や `setPermissionMode()` と同じ制約で、ストリーミング入力モードでのみ使用できます。

753 753

754以下の例は、セッション中にアクティブなモデルを切り替え、その後オーバーライドをクリアして、モデルを [Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットします。754以下の例では、セッション途中でアクティブなモデルを切り替え、その後上書きをクリアしてモデルを [Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットします。

755 755

756```typescript theme={null}756```typescript theme={null}

757import { query } from "@anthropic-ai/claude-agent-sdk";757import { query } from "@anthropic-ai/claude-agent-sdk";

758 758

759const q = query({ prompt: messageStream });759const q = query({ prompt: messageStream });

760 760

761// セッションの残りの期間、モデルをオーバーライドします761// Override the model for the rest of the session

762await q.applyFlagSettings({ model: "claude-opus-4-6" });762await q.applyFlagSettings({ model: "claude-opus-4-6" });

763 763

764// 後で: オーバーライドをクリアします。モデルは Claude Code のデフォルトにリセットされます764// Later: clear the override; the model resets to Claude Code's default

765await q.applyFlagSettings({ model: null });765await q.applyFlagSettings({ model: null });

766```766```

767 767

768<Note>768<Note>

769 `applyFlagSettings()` は TypeScript のみです。Python SDK は同等のメソッドを公開していません。769 `applyFlagSettings()` は TypeScript のみで使用できます。Python SDK には同等のメソッドはありません。

770</Note>770</Note>

771 771

772<h4 id="updatesettings">772<h4 id="updatesettings">

773 `updateSettings()`773 `updateSettings()`

774</h4>774</h4>

775 775

776設定ファイルをディスクに書き込み、値が後のセッションで永続化されるようにします。各ソースは 1 つのキーを受け入れ、文字列値を持ちます:776許可リストに含まれる 1 つのキーをディスク上の設定ファイルに書き込み、そのソースを読み込む以降のセッションにも値を保持します。各ソースは文字列値を持つ 1 つのキーを受け付けます。

777 777

778* **`"localSettings"`**: `outputStyle` を受け入れ、プロジェクトのローカル設定ファイル `.claude/settings.local.json` にマージします。新しいスタイルはセッションの次のリクエストで有効になります。778* **`"localSettings"`**: `outputStyle` を受け付け、プロジェクトのローカル設定ファイル `.claude/settings.local.json` にマージします。新しいスタイルはセッションの次のリクエストから有効になります。

779* **`"userSettings"`**: `effortLevel` を受け入れ、セッションの現在のモデルのデフォルト [努力レベル](/docs/ja/model-config#adjust-effort-level)としてユーザー設定ファイルの [`modelSettings`](/docs/ja/settings-reference#modelsettings) の下に保存します。`max` を渡すと、`max` はセッションのみであるため何も書き込みません。実行中のセッションはいずれにせよ現在の努力レベルを保持するため、それも変更する場合は [`applyFlagSettings()`](#applyflagsettings)を呼び出してください。このソースには TypeScript SDK v0.3.277 以降が必要で、Claude Code v2.1.277 をバンドルしています。779* **`"userSettings"`**: `effortLevel` を受け付け、セッションの現在のモデルのデフォルトの [effort レベル](/docs/ja/model-config#adjust-effort-level)として、ユーザー設定ファイルの [`modelSettings`](/docs/ja/settings-reference#modelsettings) の下に保存します。`max` はセッション限定であるため、`max` を渡しても何も書き込まれません。いずれの場合も実行中のセッションは現在の effort レベルを維持するため、それも変更したい場合は [`applyFlagSettings()`](#applyflagsettings) を呼び出してください。このソースには TypeScript SDK v0.3.277 以降が必要です（Claude Code v2.1.277 がバンドルされています）。

780 780

781呼び出しは、リクエストが他のキーを含む場合、セッションがリモートトランスポートで実行される場合、およびセッションの [`settingSources`](#options)が名前を付けたソースを除外する場合に拒否されます。キーの削除はサポートされていません。781リクエストにその他のキーが含まれている場合、セッションがリモートトランスポート上で実行されている場合、およびセッションの [`settingSources`](#options) が指定したソースを除外している場合、呼び出しは拒否されます。キーの削除はサポートされていません。

782 782

783<h4 id="togglemcpserver">783<h4 id="togglemcpserver">

784 `toggleMcpServer()`784 `toggleMcpServer()`

785</h4>785</h4>

786 786

787サーバーを無効にすると、接続が切断され、そのツールがセッションから削除されます。セッション中に追加したサーバーとインプロセスサーバーについては、これは Claude Code のバージョンに依存します：787サーバーを無効にすると、接続が切断され、そのツールがセッションから削除されます。セッション途中で追加したサーバーとインプロセスサーバーについては、Claude Code のバージョンによって次のように異なります。

788 788

789* セッション中に `setMcpServers()` で追加した stdio、SSE、または HTTP サーバー：そのツールの削除には Claude Code v2.1.285 以降が必要です。789* `setMcpServers()` でセッション途中に追加した stdio、SSE、または HTTP サーバー: ツールの削除には Claude Code v2.1.285 以降が必要です。

790* [`createSdkMcpServer()`](#createsdkmcpserver) で作成したインプロセスサーバー（`mcpServers` で渡したか `setMcpServers()` で渡したかを問いません）：切断とツールの削除には Claude Code v2.1.286 以降が必要です。無効にすると、まだ実行中のツール呼び出しも失敗するため、Claude はハンドラーが戻るのを待たずに、それぞれについて即座にエラー結果を受け取ります。790* [`createSdkMcpServer()`](#createsdkmcpserver) で作成したインプロセスサーバー（`mcpServers` で渡したか `setMcpServers()` で渡したかを問わない）: 接続の切断とツールの削除には Claude Code v2.1.286 以降が必要です。また、無効にすると実行中のツール呼び出しも失敗するため、Claude はハンドラーが戻るのを待たずに、それぞれについてエラー結果を即座に受け取ります。

791 791

792<h3 id="warmquery">792<h3 id="warmquery">

793 `WarmQuery`793 `WarmQuery`

794</h3>794</h3>

795 795

796[`startup()`](#startup)によって返されるハンドル。サブプロセスは既にスポーンおよび初期化されているため、このハンドルで `query()` を呼び出すと、スタートアップレイテンシーなしで準備完了プロセスにプロンプトを直接書き込みます。796[`startup()`](#startup) が返すハンドルです。サブプロセスはすでに生成および初期化されているため、このハンドルで `query()` を呼び出すと、起動の遅延なしに準備済みのプロセスへプロンプトが直接書き込まれます。

797 797

798```typescript theme={null}798```typescript theme={null}

799interface WarmQuery extends AsyncDisposable {799interface WarmQuery extends AsyncDisposable {

808 808

809| メソッド | 説明 |809| メソッド | 説明 |

810| :- | :- |810| :- | :- |

813 813

814`WarmQuery` は `AsyncDisposable` を実装するため、自動クリーンアップのために `await using` で使用できます。814`WarmQuery` は `AsyncDisposable` を実装しているため、`await using` と組み合わせて自動クリーンアップに使用できます。

815 815

816<h3 id="spareprocess">816<h3 id="spareprocess">

817 `SpareProcess`817 `SpareProcess`

818</h3>818</h3>

819 819

820*アルファ。* [`prewarm()`](#prewarm)によって返されるハンドル: セッションにまだバインドされていない開始された Claude Code プロセスで、1 回クレームできます。TypeScript Agent SDK v0.3.282 以降が必要です。820*アルファ版。* [`prewarm()`](#prewarm) が返すハンドルで、まだセッションにバインドされておらず、1 回だけ取得（claim）できる起動済みの Claude Code プロセスです。TypeScript Agent SDK v0.3.282 以降が必要です。

821 821

822```typescript theme={null}822```typescript theme={null}

823interface SpareProcess extends AsyncDisposable {823interface SpareProcess extends AsyncDisposable {

837 837

838| メンバー | 説明 |838| メンバー | 説明 |

839| :- | :- |839| :- | :- |

840| `claim({ prompt, options })` | スペアを `options.cwd` のセッションにバインドし、最初のメッセージを送信します。`query()` と同様に [`Query`](#query-object)を同期的に返します。1 回のみ呼び出すことができます |840| `claim({ prompt, options })` | スペアを `options.cwd` 内のセッションにバインドし、最初のメッセージを送信します。`query()` と同様に [`Query`](#query-object) を同期的に返します。1 回だけ呼び出せます |

841| `claimed` | Claude Code がクレームを受け入れると、セッションのワーキングディレクトリと ID で解決します。Claude Code がクレームを拒否する場合、プロセスが終了または最初に閉じられた場合、および `option_not_applied` で始まるメッセージを含む場合に拒否します。要求した `model` または `maxThinkingTokens` なしでセッションが実行されている場合 |841| `claimed` | Claude Code が claim を受け入れると、セッションの作業ディレクトリと ID で解決されます。Claude Code が claim を拒否した場合、プロセスが先に終了したか閉じられた場合、およびセッションが要求した `model` または `maxThinkingTokens` なしで実行されている場合（`option_not_applied` で始まるメッセージ）に拒否されます |

844 844

845`options.cwd` は必須です。クレームは `additionalDirectories`、`model`、`permissionMode`、`maxThinkingTokens`、`settings` のフラグ設定オーバーレイ、`appendSystemPrompt`、`title`、`agents`、および `env` のセッションごとのトークンも設定できます。845`options.cwd` は必須です。claim では、`additionalDirectories`、`model`、`permissionMode`、`maxThinkingTokens`、`settings` でのフラグ設定オーバーレイ、`appendSystemPrompt`、`title`、`agents`、`env` でのセッションごとのトークンも設定できます。

846 846

847Claude Code はクレームを拒否できます。例えば、存在しないフォルダまたはプロジェクト設定が `env`、`agent`、または `model` を設定するフォルダの場合。`claimed` が `option_not_applied` で始まるメッセージで拒否する場合、セッションは要求した `model` または `maxThinkingTokens` なしで実行されています。他の拒否の場合、プロンプトは実行されていないため、代わりに `query()` でセッションを開始してください。847Claude Code は、存在しないフォルダーや、プロジェクト設定で `env`、`agent`、または `model` が設定されているフォルダーなどの場合に claim を拒否することがあります。`claimed` が `option_not_applied` で始まるメッセージで拒否された場合、セッションは要求した `model` または `maxThinkingTokens` なしで実行されています。その他の拒否の場合はプロンプトが実行されていないため、代わりに `query()` でセッションを開始してください。

848 848

849<h3 id="sdkcontrolinitializeresponse">849<h3 id="sdkcontrolinitializeresponse">

850 `SDKControlInitializeResponse`850 `SDKControlInitializeResponse`

851</h3>851</h3>

852 852

853`initializationResult()` の戻り値の型。セッション初期化データを含みます。853`initializationResult()` の戻り値の型です。セッションの初期化データを含みます。

854 854

855```typescript theme={null}855```typescript theme={null}

856type SDKControlInitializeResponse = {856type SDKControlInitializeResponse = {

863 fast_mode_state?: "off" | "cooldown" | "on";863 fast_mode_state?: "off" | "cooldown" | "on";

864 fast_mode_disabled_reason?: FastModeDisabledReason;864 fast_mode_disabled_reason?: FastModeDisabledReason;

865 hooks_applied?: boolean;865 hooks_applied?: boolean;

866 sdk_mcp_manifests_parked?: Record<

867 string,

868 | "parked"

869 | "already_connected"

870 | "protocol_version_mismatch"

871 | "malformed"

872 | "not_honoured"

873 >;

866};874};

867```875```

868 876

869`hooks_applied` は Claude Code が `initialize` リクエストが実行した `hooks` を登録したかどうかを報告します。SDK はセッションが開始されるときにそのリクエストを 1 回送信し、各 [`reinitialize()`](#query-object)呼び出しで再度送信します。フィールドには Agent SDK v0.3.238 以降が必要です。877`hooks_applied` は、`initialize` リクエストに含まれていた `hooks` を Claude Code が登録したかどうかを示します。SDK はこのリクエストをセッション開始時に 1 回送信し、[`reinitialize()`](#query-object) を呼び出すたびに再度送信します。このフィールドには Agent SDK v0.3.238 以降が必要です。

878

879リクエストにフックが含まれていなかった場合、Claude Code はこのフィールドを省略します。リクエストにフックが含まれていた場合、値はそのリクエストがセッションの最初の initialize かどうか、また繰り返しの initialize の場合はどのようにセッションに到達したかによって決まります。

870 880

871Claude Code はリクエストがフックを実行しなかった場合、フィールドを省略します。リクエストがフックを実行した場合、値はリクエストがセッションの最初の初期化であるかどうか、および繰り返されるものの場合、セッションに到達した方法に依存します:881* `true`: Claude Code がフックを登録しました。セッションの最初の initialize はこの値を返します。CLI の stdin を介して送信された繰り返しの initialize も `true` を返します。その場合、新しいリクエストのフックが以前に登録されたフックを置き換えます。

882* `false`: Claude Code はフックを無視しました。リモートセッションに送信された繰り返しの initialize はこの値を返すため、セッションに参加した 2 番目のクライアントは、最初のクライアントが登録したフックを置き換えることができません。

872 883

873* `true`: Claude Code はフックを登録しました。セッションの最初の初期化はこの値を返します。CLI の stdin を通じて送信された繰り返し初期化もこの値を返します。その場合、新しいリクエストのフックは以前に登録されたフックを置き換えます。884Agent SDK v0.3.238 より前は、レスポンスにこのフィールドは含まれず、Claude Code は繰り返しのすべての initialize で `hooks` を無視していました。

874* `false`: Claude Code はフックを無視しました。リモートセッションに送信された繰り返し初期化はこの値を返すため、セッションに参加する 2 番目のクライアントは最初のクライアントが登録したフックを置き換えることはできません。

875 885

876Agent SDK v0.3.238 より前では、レスポンスはフィールドを実行しなかったため、Claude Code はすべての繰り返し初期化でフックを無視しました。886リクエストの `sdkMcpServerManifests` フィールドとレスポンスの `sdk_mcp_manifests_parked` フィールドは、[`createSdkMcpServer()`](#createsdkmcpserver) で作成したインプロセスの [SDK MCP サーバー](/docs/ja/agent-sdk/custom-tools)のためのものです。アプリケーションがどちらのフィールドを設定したり読み取ったりすることもありません。

877 887

878レスポンスは常に `fast_mode_state` を報告し、何かが [fast mode](/docs/ja/fast-mode)をブロックする場合、`fast_mode_disabled_reason` はブロックされた状態を説明できるように理由コードを含みます。両方の動作には Claude Code v2.1.219 以降が必要です。v2.1.219 より前では、fast mode が利用可能でない場合、レスポンスは `fast_mode_state` を省略し、理由を実行しませんでした。理由コードとその意味については、結果メッセージの [`fast_mode_disabled_reason`](#sdkresultmessage)を参照してください。888レスポンスは常に `fast_mode_state` を報告し、何かが [fast mode](/docs/ja/fast-mode) をブロックしている場合は `fast_mode_disabled_reason` がその理由コードを併せて伝えるため、可用性を再導出することなくブロックされた状態を説明できます。どちらの動作にも Claude Code v2.1.219 以降が必要です。v2.1.219 より前は、fast mode が利用できない場合にレスポンスは `fast_mode_state` を省略し、理由を含むことはありませんでした。理由コードとその意味については、結果メッセージの [`fast_mode_disabled_reason`](#sdkresultmessage) を参照してください。

879 889

880成功した `initialize` の制御レスポンスラッパーは `pending_permission_requests` 配列も実行します。フィールドは上記の `SDKControlInitializeResponse` ペイロード内ではなく、レスポンスラッパー自体にあります。各エントリは、セッションが実行中にストリーミングする権限リクエストと同じ `{ type: "control_request", request_id, request }` 形状を持つ完全な `control_request` メッセージです。890成功した `initialize` のコントロールレスポンスのラッパーには、`pending_permission_requests` 配列も含まれます。このフィールドはレスポンスラッパー自体にあり、上記の `SDKControlInitializeResponse` ペイロード内にはありません。各エントリは完全な `control_request` メッセージで、実行中にセッションが権限リクエストとしてストリーミングするのと同じ `{ type: "control_request", request_id, request }` の形をしています。

881 891

882配列は、この Claude Code プロセスが発行し、まだ解決していない権限リクエストをリストします。SDK はあなたのために配列を読み取り、各エントリを [`canUseTool`](#canusetool)コールバックにディスパッチします。これは [`reinitialize()`](#query-object)がトランスポートギャップ後にトリガーするのと同じ再配信です。繰り返されたリクエスト ID をべき等に処理してください。エントリは、接続が切断される前にコールバックが既に受け取ったリクエストを繰り返すことができるためです。892この配列には、この Claude Code プロセスが発行してまだ解決されていない権限リクエストが一覧表示されます。SDK はこの配列を読み取り、各エントリを [`canUseTool`](#canusetool) コールバックにディスパッチします。これは、トランスポートの途絶後に [`reinitialize()`](#query-object) がトリガーするのと同じ再配信です。エントリは、接続が切断される前にコールバックがすでに受け取ったリクエストを繰り返す場合があるため、繰り返されるリクエスト ID は冪等に処理してください。

883 893

884配列は成功した `initialize` レスポンスで常に存在し、このプロセスに未解決の権限リクエストがない場合は空です。Claude Code v2.1.268 以降が必要です。以前のバージョンはフィールドを省略できるため、ワイヤプロトコルを自分で解析する場合、欠落しているフィールドを古い CLI として扱い、何も保留中でないという証拠ではなく扱ってください。894この配列は成功した `initialize` レスポンスに常に存在し、このプロセスに未解決の権限リクエストがない場合は空になります。Claude Code v2.1.268 以降が必要です。以前のバージョンではこのフィールドが省略される場合があるため、ワイヤープロトコルを自分で解析する場合は、フィールドがないことを保留中のものがない証拠としてではなく、古い CLI であることの表れとして扱ってください。

885 895

886<h3 id="sdkcontrolinterruptresponse">896<h3 id="sdkcontrolinterruptresponse">

887 `SDKControlInterruptResponse`897 `SDKControlInterruptResponse`

888</h3>898</h3>

889 899

890中断レシート: [`interrupt()`](#query-object)が [`SDKSystemMessage.capabilities`](#sdksystemmessage)で `interrupt_receipt_v1` 機能をアドバタイズする CLI で解決する値。Claude Code v2.1.205 以降が必要です。以前の CLI は空の成功ペイロードで中断に応答するため、`interrupt()` は `undefined` で解決します。900中断の受領通知です。[`SDKSystemMessage.capabilities`](#sdksystemmessage) で `interrupt_receipt_v1` ケイパビリティを通知している CLI で、[`interrupt()`](#query-object) が解決される値です。Claude Code v2.1.205 以降が必要です。それ以前の CLI は空の成功ペイロードで中断に応答するため、`interrupt()` は `undefined` に解決されます。

891 901

892```typescript theme={null}902```typescript theme={null}

893type SDKControlInterruptResponse = {903type SDKControlInterruptResponse = {

896};906};

897```907```

898 908

899`still_queued` は、中断が到着したときに保留中だったユーザーメッセージの UUID をリストします。キューに入ったままのメッセージ、および Claude Code が既に次のターンのキューから取り出したメッセージ。セッションの最初のターンが開始されると、Claude Code は中断しない限り、リストされたメッセージを処理します。最初のターンが開始される前に中断する場合、Claude Code はそのターンが開始されるとすぐに中止し、そのターンのリストされたメッセージはレスポンスを取得しません。909`still_queued` は、中断が到着した時点で保留中だったユーザーメッセージの UUID を一覧表示します。これには、まだキューにあるメッセージと、Claude Code が次のターンのためにすでにキューから取り出していたメッセージが含まれます。セッションの最初のターンが開始された後は、先にキャンセルしない限り、Claude Code は一覧にあるメッセージを中断後に処理し、複数のメッセージを 1 つのターンにまとめることがあります。最初のターンが開始される前に中断した場合、Claude Code はそのターンが開始されるとすぐに中止し、そのターン内の一覧にあるメッセージには応答がありません。

900 910

901レシートを使用して、何を再送信するかを決定します。リストされたメッセージでキャンセルしないものは、レスポンスを取得するかどうかに関わらず会話に入るため、それを再送信すると Claude に 2 回配信されます。911受領通知を使用して、何かを再送信するかどうかを判断してください。キャンセルしなかった一覧のメッセージは、応答があるかどうかにかかわらず会話に入るため、再送信すると Claude に 2 回配信されることになります。

902 912

903これらの注意事項でリストを解釈します:913一覧を解釈する際は、次の注意点に留意してください。

904 914

905* UUID で登録されたメッセージのみが表示されます。空の配列は他に何も実行されないことを意味しません。915* UUID 付きでキューに入れられたメッセージのみが表示されます。空の配列は、他に何も実行されないことを意味するわけではありません。

906* メインスレッドメッセージのみがリストされます。サブエージェントに対処されたメッセージはスコープ外です。916* メインスレッドのメッセージのみが一覧表示されます。サブエージェント宛てのメッセージは対象外です。

907* リストには、[スケジュール済みタスク](/docs/ja/scheduled-tasks)トリガーなど、クライアントが送信しなかった UUID が含まれる場合があります。認識しない UUID を無視し、エラーとして扱わないでください。917* 一覧には、[スケジュールタスク](/docs/ja/scheduled-tasks)のトリガーなど、クライアントが送信していない UUID が含まれる場合があります。認識できない UUID はエラーとして扱わず、無視してください。

908 918

909CLI の制御プロトコルを `interrupt()` ではなく直接駆動するクライアントは、`interrupt` 制御リクエストで `cancel_queued: true` を設定できます。Claude Code v2.1.219 以降は [`SDKSystemMessage.capabilities`](#sdksystemmessage)で `interrupt_cancel_queued_v1` 機能でサポートをアドバタイズします。以前の CLI はフィールドを無視し、キューに入ったメッセージを通常どおり実行したままにします。そのような中断はリストされるはずだったすべてのメッセージをキャンセルします: レシートはそれらを `cancelled` の下にリストし、`still_queued` は空で、それらのどれも実行されません。919`interrupt()` を介さずに CLI のコントロールプロトコルを直接操作するクライアントは、`interrupt` コントロールリクエストに `cancel_queued: true` を設定できます。Claude Code v2.1.219 以降は、[`SDKSystemMessage.capabilities`](#sdksystemmessage) の `interrupt_cancel_queued_v1` ケイパビリティでサポートを通知します。古い CLI はこのフィールドを無視し、キュー内のメッセージは通常どおり実行されます。このような中断は、本来 `still_queued` に一覧表示されるはずのすべてのメッセージもキャンセルします。受領通知ではそれらが代わりに `cancelled` に一覧表示され、`still_queued` は空になり、いずれも実行されません。

910 920

911`cancelled` リストは `still_queued` と同じ注意事項を実行します。`interrupt()` メソッドは `cancel_queued` を送信しないため、それが解決するレシートは `cancelled` を実行しません。921`cancelled` の一覧にも `still_queued` と同じ注意点があります。`interrupt()` メソッドは `cancel_queued` を送信しないため、このメソッドが解決する受領通知には `cancelled` は含まれません。

912 922

913レシートは中断が処理される瞬間に撮られたスナップショットで、クリーンな中断では中断されたターンの [`SDKResultMessage`](#sdkresultmessage)の前に到着します。そのレシートの後のレシートを読み取るのではなく、キューを検査してください: ループは次のキューに入ったターンをすぐに開始するため、レシートの後に検査するキューは既に変更されています。923受領通知は中断が処理された時点で取得されたスナップショットであり、正常な中断の場合は中断されたターンの [`SDKResultMessage`](#sdkresultmessage) より前に到着します。その結果の後にキューを調べるのではなく、受領通知を読み取ってください。ループは次のキュー内のターンをすぐに開始するため、結果の後に調べるキューはすでに変化しています。

914 924

915<h3 id="sdkcontrolgetcontextusageresponse">925<h3 id="sdkcontrolgetcontextusageresponse">

916 `SDKControlGetContextUsageResponse`926 `SDKControlGetContextUsageResponse`

917</h3>927</h3>

918 928

919[`getContextUsage()`](#query-object)の戻り値の型。デフォルト `detail` では、これは Claude Code が対話型セッションで `/context` コマンドに対してレンダリングするのと同じペイロードで、トークンカウントと共に `color` および `gridRows` などの表示フィールドを実行します。Claude Code は `/context` 使用グリッドを描画するために使用します。929[`getContextUsage()`](#query-object) の戻り値の型です。デフォルトの `detail` では、インタラクティブセッションで Claude Code が `/context` コマンドに対してレンダリングするものと同じペイロードであるため、トークン数に加えて、Claude Code が `/context` の使用量グリッドを描画するために使用する `color` や `gridRows` などの表示用フィールドも含まれます。

920 930

921メソッドのオプション `detail` 引数は、Claude Code が各カテゴリをカウントする方法を選択します。`detail` 引数には Agent SDK v0.3.257 以降が必要です。931メソッドのオプションの `detail` 引数で、Claude Code が各カテゴリをどのようにカウントするかを選択します。`detail` 引数には Agent SDK v0.3.257 以降が必要です。

922 932

923* **`'full'`**: デフォルト。Claude Code は [トークンカウント](https://platform.claude.com/docs/en/build-with-claude/token-counting) API リクエストで各カテゴリをカウントします。これらのリクエストはメッセージストリームに表示されないため、ストリームを読み取るコスト追跡はそれらを表示しません。Anthropic API では、トークンカウントは請求されません。933* **`'full'`**: デフォルトです。Claude Code は[トークンカウント](https://platform.claude.com/docs/en/build-with-claude/token-counting) API リクエストを使って各カテゴリをカウントします。これらのリクエストはメッセージストリームに現れないため、ストリームを読み取るコスト追跡では把握できません。Anthropic API では、トークンカウントは課金されません。

924* **`'summary'`**: `{ detail: 'summary' }` を渡して、最後のレスポンスの使用状況とローカル推定から答えを取得します。トークンカウントリクエストは送信されず、カテゴリごとの数値は概算です。934* **`'summary'`**: `{ detail: 'summary' }` を渡すと、代わりに最後のレスポンスの使用量とローカルの見積もりから回答を得られます。トークンカウントのリクエストは送信されず、カテゴリごとの数値は概算になります。

925 935

926代わりにメソッドを呼び出す場合、`/context` をプロンプトとして送信すると、Claude Code は結果を配信するアシスタントメッセージの `context_usage` フィールドに [`SDKContextUsage`](#sdkcontextusage)ペイロードを添付します。そのフィールドには Agent SDK v0.3.232 以降が必要です。936メソッドを呼び出す代わりに `/context` をプロンプトとして送信すると、Claude Code は結果を伝えるアシスタントメッセージの `context_usage` フィールドに [`SDKContextUsage`](#sdkcontextusage) ペイロードを添付します。このフィールドには Agent SDK v0.3.232 以降が必要です。

927 937

928```typescript theme={null}938```typescript theme={null}

929type SDKControlGetContextUsageResponse = {939type SDKControlGetContextUsageResponse = {

1020};1030};

1021```1031```

1022 1032

1023トークン属性をコレクションフィールドから読み取ります:1033トークンの内訳はコレクションフィールドから読み取ります。

1024 1034

1025* `categories` はカテゴリごとの合計を保持します。各エントリの `kind` は [`SDKContextUsageCategory`](#sdkcontextusagecategory)と同じ値で行を分類します。表示 `name` ではなく、それで行を分類します。フィールドには Agent SDK v0.3.268 以降が必要です。1035* `categories` はカテゴリごとの合計を保持します。各エントリの `kind` は、[`SDKContextUsageCategory`](#sdkcontextusagecategory) と同じ値で行を分類します。表示用の `name` ではなく、このフィールドに基づいて行を分類してください。このフィールドには Agent SDK v0.3.268 以降が必要です。

1026* `mcpTools` および `agents` は個々の MCP ツールおよびサブエージェントにトークンを属性付けします。1036* `mcpTools` と `agents` は、トークンを個々の MCP ツールとサブエージェントに割り当てます。

1027* `memoryFiles` は読み込まれた各メモリファイルをそのコストと共にリストします。1037* `memoryFiles` は、読み込まれた各メモリファイルとそのコストを一覧表示します。

1028* `skills.skillFrontmatter` は各含まれるスキルにスキルリストのトークンを属性付けします。スキルごとの数値は、Claude Code が実際に送信するスキルのリストエントリを測定します。これはスキルの完全なフロントマターより短くなる可能性があります。`skills.totalSkills` を `skills.includedSkills` と比較して、すべての検出されたスキルがリストに含まれているかどうかを確認します。1038* `skills.skillFrontmatter` は、スキル一覧のトークンを含まれている各スキルに割り当てます。スキルごとのカウントは、Claude Code が実際に送信する各スキルの一覧エントリを測定したもので、スキルの完全なフロントマターより短い場合があります。`skills.totalSkills` と `skills.includedSkills` を比較すると、検出されたすべてのスキルが一覧に含まれたかどうかを確認できます。

1029 1039

1030`totalTokens` はセッションの現在のコンテキスト使用状況で、`maxTokens` はその使用状況が測定されるウィンドウです。そのウィンドウはモデルのコンテキストウィンドウ、または自動コンパクションウィンドウが適用される場合はより低いウィンドウです。`rawMaxTokens` は `maxTokens` と同じ値を実行し、`percentage` は `totalTokens` をそのウィンドウのパーセンテージとして丸めたものです。`apiUsage` は、セッションの実行合計ではなく、最新の API レスポンスからの使用状況を保持します。1040`totalTokens` はセッションの現在のコンテキスト使用量で、`maxTokens` はその使用量を測定する基準となるウィンドウです。このウィンドウはモデルのコンテキストウィンドウ、または自動圧縮のウィンドウが適用される場合はそれより小さいそのウィンドウです。`rawMaxTokens` は `maxTokens` と同じ値を持ち、`percentage` はそのウィンドウに対する `totalTokens` の割合を丸めた値です。`apiUsage` は最新の API レスポンスの使用量を保持し、セッションの累計ではありません。

1031 1041

1032Claude Code はオプション `deferredBuiltinTools`、`systemTools`、および `systemPromptSections` 診断を設定しないため、型が宣言していても存在しないことを期待してください。1042Claude Code はオプションの診断フィールドである `deferredBuiltinTools`、`systemTools`、`systemPromptSections` を設定しないため、型で宣言されていてもこれらは存在しないものと想定してください。

1033 1043

1034<h3 id="sdkcontrolreadfileresponse">1044<h3 id="sdkcontrolreadfileresponse">

1035 `SDKControlReadFileResponse`1045 `SDKControlReadFileResponse`

1036</h3>1046</h3>

1037 1047

1038[`readFile()`](#query-object)の戻り値の型。1048[`readFile()`](#query-object) の戻り値の型です。

1039 1049

1040```typescript theme={null}1050```typescript theme={null}

1041type SDKControlReadFileResponse = {1051type SDKControlReadFileResponse = {

1046};1056};

1047```1057```

1048 1058

1049`contents` はファイルテキスト、または `encoding: 'base64'` をリクエストした場合は base64 データを保持します。レスポンスの `encoding` フィールドはその場合 `'base64'` に設定されます。`absPath` は解決された絶対パスです。`truncated` は、ファイルが `maxBytes` キャップより長く、コンテンツがその制限で切り詰められた場合に設定されます。1059`contents` はファイルのテキスト、または `encoding: 'base64'` を要求した場合は base64 データを保持します。その場合、レスポンスの `encoding` フィールドは `'base64'` に設定されます。`absPath` は解決された絶対パスです。`truncated` は、ファイルが `maxBytes` の上限より長く、内容がその上限で切り詰められた場合に設定されます。

1050 1060

1051<h4 id="what-readfile-can-read">1061<h4 id="what-readfile-can-read">

1052 `readFile()` が読み取れるもの1062 `readFile()` が読み取れるもの

1053</h4>1063</h4>

1054 1064

1055`readFile()` は Read ツールより狭いファイルセットを提供します:1065`readFile()` が提供するファイルの範囲は Read ツールより狭くなっています。

1056 1066

1057* `cwd` および `additionalDirectories` などのセッションのワーキングディレクトリ内の通常ファイル1067* `cwd` や `additionalDirectories` など、セッションの作業ディレクトリのいずれかに含まれる通常のファイル

1058* ツール結果などのセッションの Claude Code 独自ファイルのいくつか1068* ツールの結果など、そのセッションに関する Claude Code 自身のファイルの一部

1059 1069

1060Read 拒否および質問ルールは引き続き一致するパスをブロックし、広い Read 許可ルールは `readFile()` に残りのファイルシステムを開きません。他のすべてについて、呼び出しは `null` で解決します。1070`Read` の拒否ルールと確認ルールは引き続き一致するパスをブロックし、広範な `Read` の許可ルールがあっても、ファイルシステムの残りの部分が `readFile()` に開放されることはありません。それ以外のものについては、呼び出しは `null` で解決されます。

1061 1071

1062<h3 id="sdkcontrolreloadpluginsresponse">1072<h3 id="sdkcontrolreloadpluginsresponse">

1063 `SDKControlReloadPluginsResponse`1073 `SDKControlReloadPluginsResponse`

1064</h3>1074</h3>

1065 1075

1066[`reloadPlugins()`](#query-object)の戻り値の型。1076[`reloadPlugins()`](#query-object) の戻り値の型です。

1067 1077

1068```typescript theme={null}1078```typescript theme={null}

1069type SDKControlReloadPluginsResponse = {1079type SDKControlReloadPluginsResponse = {

1086};1096};

1087```1097```

1088 1098

1089コレクションフィールドは呼び出し後のセッションを説明します:1099コレクションフィールドは、呼び出し後のセッションを表します。

1090 1100

1091* `commands`、`agents`、および `mcpServers`: セッションのコマンド、サブエージェント、および MCP サーバーステータス。`supportedCommands()`、`supportedAgents()`、および `mcpServerStatus()` が返すのと同じ形状。`supportedAgents()` は初期化でキャプチャされたリストを返し続けるため、再読み込み後のセットについてはここで `agents` を読み取ります1101* `commands`、`agents`、`mcpServers`: セッションのコマンド、サブエージェント、MCP サーバーのステータスで、`supportedCommands()`、`supportedAgents()`、`mcpServerStatus()` が返すのと同じ形式です。`supportedAgents()` は初期化時に取得されたリストを返し続けるため、再読み込み後のセットについてはここの `agents` を読み取ってください

1092* `plugins`: 各読み込まれたプラグインとそのインストール `path`。`version` はプラグインのマニフェストが宣言するものを繰り返し、プラグイン作成者が制御するため、信頼する前に検証してください。マニフェストが宣言しない場合は省略されます1102* `plugins`: 読み込まれた各プラグインとその `name` およびインストール先の `path`。`version` はプラグインのマニフェストが宣言している内容をそのまま示すもので、プラグインの作成者が制御するため、信頼する前に検証してください。マニフェストが何も宣言していない場合は省略されます

1093* `error_count`: プラグイン読み込みからのエラー数1103* `error_count`: プラグインの読み込みで発生したエラーの数

1094 1104

1095`reloadPlugins()` に `{ holdOnCacheImpact: true }` を渡して、会話のプロンプトキャッシュを無効にする再読み込みを保持し、適用する代わりに保持します。Claude Code は対話型 `/reload-plugins` コマンドが [キャッシュコストについて警告](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)する前に行うチェックを実行します。オプションには Agent SDK v0.3.268 以降が必要です。`pathToClaudeCodeExecutable` が指す v2.1.268 より前の Claude Code 実行可能ファイルはオプションを無視し、再読み込みを適用します。1105`reloadPlugins()` に `{ holdOnCacheImpact: true }` を渡すと、会話のプロンプトキャッシュを無効にするような再読み込みを適用せずに保留できます。Claude Code は、インタラクティブな `/reload-plugins` コマンドが[キャッシュのコストについて警告する](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)前に行うチェックを実行します。このオプションには Agent SDK v0.3.268 以降が必要です。`pathToClaudeCodeExecutable` で指定したものなど、v2.1.268 より古い Claude Code 実行ファイルはこのオプションを無視して再読み込みを適用します。

1096 1106

1097オプションを渡すと、`held` を読み取って何が起こったかを学びます:1107このオプションを渡した場合は、`held` を読み取って何が起きたかを確認します。

1098 1108

1099* `true`: 再読み込みは適用されず、コレクションフィールドはセッションをそのまま説明します。`cache_impact` は適用が変更するものを言います。とにかく適用するには、オプションなしで `reloadPlugins()` を再度呼び出します。1109* `true`: 再読み込みは適用されておらず、コレクションフィールドは現在のままのセッションを表します。`cache_impact` は、適用した場合に何が変わるかを示します。それでも適用するには、オプションなしで `reloadPlugins()` を再度呼び出します。

1100* `false`: チェックはキャッシュ影響を見つけず、再読み込みが適用されました。1110* `false`: チェックでキャッシュへの影響が見つからず、再読み込みが適用されました。

1101* 不在: オプションを渡さなかったか、Claude Code 実行可能ファイルが v2.1.268 より前で再読み込みを適用しました。1111* 存在しない: オプションを渡さなかったか、Claude Code 実行ファイルが v2.1.268 より古く、再読み込みを適用しました。

1102 1112

1103`cache_impact` は `held: true` と共にのみ存在します。`mcp_servers_added` および `mcp_servers_removed` は再読み込みが登録または削除するプラグイン MCP サーバーをスコープ付き `plugin:<plugin>:<server>` 名として名前付けます。名前はプラグイン作成者が作成するため、表示する前に検証してください。`lsp_tool_change` は適用が LSP ツールを追加または削除するかどうかを言うか、どちらでもない場合は `null`。`may-` 形式は、チェックが保留中のプラグインセットを完全に見ることができなかったことを意味します。1113`cache_impact` は `held: true` と併せてのみ存在します。`mcp_servers_added` と `mcp_servers_removed` は、再読み込みによって登録または削除されるプラグインの MCP サーバーを、スコープ付きの `plugin:<plugin>:<server>` 名で示します。これらの名前はプラグインの作成者が付けたものであるため、表示する前に検証してください。`lsp_tool_change` は、適用によって LSP ツールが追加されるか削除されるかを示し、どちらでもない場合は `null` です。`may-` 形式は、チェックで保留中のプラグインセットを完全には把握できなかったことを意味します。

1104 1114

1105<h3 id="sdkcontrolreloadskillsresponse">1115<h3 id="sdkcontrolreloadskillsresponse">

1106 `SDKControlReloadSkillsResponse`1116 `SDKControlReloadSkillsResponse`

1107</h3>1117</h3>

1108 1118

1109[`reloadSkills()`](#query-object)の戻り値の型。1119[`reloadSkills()`](#query-object) の戻り値の型です。

1110 1120

1111```typescript theme={null}1121```typescript theme={null}

1112type SDKControlReloadSkillsResponse = {1122type SDKControlReloadSkillsResponse = {

1114};1124};

1115```1125```

1116 1126

1117`skills` は再読み込み後に利用可能なスキルをリストし、`supportedCommands()` が返すのと同じ [`SlashCommand`](#slashcommand)形状です。1127`skills` は、再読み込み後に使用可能なスキルを、`supportedCommands()` が返すのと同じ [`SlashCommand`](#slashcommand) の形式で一覧表示します。

1118 1128

1119<h3 id="sdkcontrolreloadoutputstylesresponse">1129<h3 id="sdkcontrolreloadoutputstylesresponse">

1120 `SDKControlReloadOutputStylesResponse`1130 `SDKControlReloadOutputStylesResponse`

1121</h3>1131</h3>

1122 1132

1123[`reloadOutputStyles()`](#query-object)の戻り値の型。1133[`reloadOutputStyles()`](#query-object) の戻り値の型です。

1124 1134

1125```typescript theme={null}1135```typescript theme={null}

1126type SDKControlReloadOutputStylesResponse = {1136type SDKControlReloadOutputStylesResponse = {

1128};1138};

1129```1139```

1130 1140

1131`available_output_styles` は再読み込み後に利用可能な組み込みおよびカスタム出力スタイルの名前をリストします。1141`available_output_styles` は、再読み込み後に使用可能な組み込みおよびカスタムの出力スタイルの名前を一覧表示します。

1132 1142

1133<h3 id="sdkcontrolmcpreadresourceresponse">1143<h3 id="sdkcontrolmcpreadresourceresponse">

1134 `SDKControlMcpReadResourceResponse`1144 `SDKControlMcpReadResourceResponse`

1135</h3>1145</h3>

1136 1146

1137[`readMcpResource()`](#query-object)の戻り値の型。MCP サーバーの `resources/read` 結果を実行します。TypeScript Agent SDK v0.3.280 以降が必要です。1147[`readMcpResource()`](#query-object) の戻り値の型で、MCP サーバーの `resources/read` の結果を保持します。TypeScript Agent SDK v0.3.280 以降が必要です。

1138 1148

1139```typescript theme={null}1149```typescript theme={null}

1140type SDKControlMcpReadResourceResponse = {1150type SDKControlMcpReadResourceResponse = {

1148};1158};

1149```1159```

1150 1160

1151`readMcpResource()` にサーバー名を `mcpServerStatus()` が報告するのと同じように、および `ui://` URI（ツールが [`_meta`](#mcpserverstatus)で宣言する `ui.resourceUri` など）を渡します。呼び出しは他の URI スキーム、アプリケーションが自分でホストする [SDK MCP サーバー](#createsdkmcpserver)、および接続されていないサーバーに対して拒否します。初期化メッセージの [`capabilities`](#sdksystemmessage)に `mcp_read_resource_v1` が含まれている場合に利用可能です。1161`readMcpResource()` には、`mcpServerStatus()` が報告するサーバー名と、ツールが [`_meta`](#mcpserverstatus) で宣言する `ui.resourceUri` などの `ui://` URI を渡します。その他の URI スキームの場合、アプリケーション自身がホストする [SDK MCP サーバー](#createsdkmcpserver)の場合、および接続されていないサーバーの場合、呼び出しは拒否されます。init メッセージの [`capabilities`](#sdksystemmessage) に `mcp_read_resource_v1` が含まれている場合に使用できます。

1152 1162

1153各 `contents` エントリは、`com.anthropic/` プレフィックスの下の `_meta` キーを除いて、サーバーが送信した 1 つのコンテンツアイテムです。これは Claude Code 用に予約されています。`blob` はバイナリアイテムの base64 データを保持し、`_meta` はアイテム自体の `_meta` で、MCP Apps サーバーはリソースの `ui.csp` および `ui.permissions` を配置します。1163各 `contents` エントリは、サーバーが送信したとおりの 1 つのコンテンツ項目ですが、Claude Code 用に予約されている `com.anthropic/` プレフィックス以下の `_meta` キーは除かれます。`blob` はバイナリ項目の base64 データを保持し、`_meta` はその項目自身の `_meta` で、MCP Apps サーバーはリソースの `ui.csp` と `ui.permissions` をここに配置します。

1154 1164

1155コンテンツは信頼できない第三者の HTML であるため、サンドボックスでレンダリングしてください。1165コンテンツは信頼できないサードパーティの HTML であるため、サンドボックス内でレンダリングしてください。

1156 1166

1157<h3 id="agentdefinition">1167<h3 id="agentdefinition">

1158 `AgentDefinition`1168 `AgentDefinition`

1159</h3>1169</h3>

1160 1170

1161プログラムで定義されたサブエージェントの設定。1171プログラムで定義されたサブエージェントの設定です。

1162 1172

1163```typescript theme={null}1173```typescript theme={null}

1164type AgentDefinition = {1174type AgentDefinition = {

1182 1192

1183| フィールド | 必須 | 説明 |1193| フィールド | 必須 | 説明 |

1184| :- | :- | :- |1194| :- | :- | :- |

1185| `description` | はい | このエージェントをいつ使用するかの自然言語説明 |1195| `description` | はい | このエージェントをいつ使用するかを自然言語で説明したもの |

1186| `tools` | いいえ | 許可されたツール名の配列。省略した場合、[サブエージェントで利用可能なすべてのツール](/docs/ja/sub-agents#available-tools)を継承します。スキルをエージェントのコンテキストにプリロードするには、ここで `'Skill'` をリストするのではなく `skills` フィールドを使用します |1196| `tools` | いいえ | 許可されるツール名の配列。省略した場合、[サブエージェントが使用できるツール](/docs/ja/sub-agents#available-tools)をすべて継承します。スキルをエージェントのコンテキストに事前読み込みするには、ここに `'Skill'` を列挙するのではなく `skills` フィールドを使用してください |

1187| `disallowedTools` | いいえ | このエージェントに対して明示的に許可しないツール名の配列。MCP サーバーレベルのパターンも受け入れられます: `mcp__server` または `mcp__server__*` はそのサーバーからすべてのツールを削除し、`mcp__*` はすべての MCP ツールをすべてのサーバーから削除します |1197| `disallowedTools` | いいえ | このエージェントで明示的に禁止するツール名の配列。MCP サーバーレベルのパターンも使用できます。`mcp__server` または `mcp__server__*` はそのサーバーのすべてのツールを削除し、`mcp__*` はすべてのサーバーのすべての MCP ツールを削除します |

1188| `prompt` | はい | エージェントのシステムプロンプト |1198| `prompt` | はい | エージェントのシステムプロンプト |

1189| `model` | いいえ | このエージェントのモデルオーバーライド。`'fable'`、`'opus'`、`'sonnet'`、`'haiku'`、`'inherit'` などのエイリアス、または完全なモデル ID を受け入れます。`'inherit'` はメインモデルを使用します。省略した場合、Claude Code は [サブエージェントモデル順序](/docs/ja/sub-agents#choose-a-model)でモデルを選択します |1199| `model` | いいえ | このエージェントのモデルの上書き。`'fable'`、`'opus'`、`'sonnet'`、`'haiku'`、`'inherit'` などのエイリアス、または完全なモデル ID を受け付けます。`'inherit'` はメインのモデルを使用します。省略した場合、Claude Code は[サブエージェントのモデルの順序](/docs/ja/sub-agents#choose-a-model)に従ってモデルを選択します |

1190| `mcpServers` | いいえ | このエージェントの MCP サーバー仕様 |1200| `mcpServers` | いいえ | このエージェントの MCP サーバーの指定 |

1191| `skills` | いいえ | エージェントコンテキストにプリロードするスキル名の配列 |1201| `skills` | いいえ | エージェントのコンテキストに事前読み込みするスキル名の配列 |

1192| `initialPrompt` | いいえ | このエージェントがメインスレッドエージェントとして実行される場合、最初のユーザーターンとして自動送信されます |1202| `initialPrompt` | いいえ | このエージェントがメインスレッドのエージェントとして実行されるときに、最初のユーザーターンとして自動送信されます |

1193| `maxTurns` | いいえ | 停止する前のエージェンティックターン数（API ラウンドトリップ）の最大数 |1203| `maxTurns` | いいえ | 停止するまでのエージェントの最大ターン数（API の往復） |

1194| `background` | いいえ | 呼び出されたときにこのエージェントをノンブロッキングバックグラウンドタスクとして実行します |1204| `background` | いいえ | 呼び出されたときに、このエージェントをノンブロッキングのバックグラウンドタスクとして実行します |

1195| `omitClaudeMd` | いいえ | このエージェントがサブエージェントとして実行される場合、ユーザー、プロジェクト、ローカル CLAUDE.md ファイルなしでこのエージェントを実行します。管理ポリシーファイルは引き続き読み込まれます。Agent ツールプロンプトから必要なすべてを取得するエージェントに使用します。このエージェントがメインスレッドエージェントとして実行される場合は無視されます。TypeScript Agent SDK v0.3.271 以降が必要です |1205| `omitClaudeMd` | いいえ | サブエージェントとして実行されるときに、ユーザー、プロジェクト、ローカルの CLAUDE.md ファイルなしでこのエージェントを実行します。管理ポリシーファイルは引き続き読み込まれます。必要なものをすべて Agent ツールのプロンプトから受け取るエージェントに使用します。このエージェントがメインスレッドのエージェントとして実行される場合は無視されます。TypeScript Agent SDK v0.3.271 以降が必要です |

1196| `memory` | いいえ | このエージェントのメモリソース: `'user'`、`'project'`、または `'local'` |1206| `memory` | いいえ | このエージェントのメモリソース: `'user'`、`'project'`、または `'local'` |

1197| `effort` | いいえ | このエージェントの推論努力レベル。名前付きレベルまたは整数を受け入れます |1207| `effort` | いいえ | このエージェントの推論の effort レベル。名前付きのレベルまたは整数を受け付けます |

1198| `permissionMode` | いいえ | このエージェント内のツール実行の権限モード。[サブエージェント継承ルール](/docs/ja/agent-sdk/permissions#available-modes)はいつ適用されるかを決定します。[`PermissionMode`](#permissionmode)を参照してください |1208| `permissionMode` | いいえ | このエージェント内でのツール実行の権限モード。いつ適用されるかは[サブエージェントの継承ルール](/docs/ja/agent-sdk/permissions#available-modes)によって決まります。[`PermissionMode`](#permissionmode) を参照してください |

1199| `criticalSystemReminder_EXPERIMENTAL` | いいえ | 実験的: システムプロンプトに追加された重要なリマインダー |1209| `criticalSystemReminder_EXPERIMENTAL` | いいえ | 実験的: システムプロンプトに追加される重要なリマインダー |

1200 1210

1201<h3 id="agentmcpserverspec">1211<h3 id="agentmcpserverspec">

1202 `AgentMcpServerSpec`1212 `AgentMcpServerSpec`

1203</h3>1213</h3>

1204 1214

1205サブエージェントで利用可能な MCP サーバーを指定します。サーバー名（親の `mcpServers` 設定からサーバーを参照する文字列）またはインラインサーバー設定レコード（サーバー名を設定にマップ）です。1215サブエージェントが使用できる MCP サーバーを指定します。サーバー名（親の `mcpServers` 設定内のサーバーを参照する文字列）、またはサーバー名を設定にマッピングするインラインのサーバー設定レコードを指定できます。

1206 1216

1207```typescript theme={null}1217```typescript theme={null}

1208type AgentMcpServerSpec = string | Record<string, McpServerConfigForProcessTransport>;1218type AgentMcpServerSpec = string | Record<string, McpServerConfigForProcessTransport>;

1222 1232

1223| 値 | 説明 | 場所 |1233| 値 | 説明 | 場所 |

1224| :- | :- | :- |1234| :- | :- | :- |

1228 1238

1229<h4 id="default-behavior">1239<h4 id="default-behavior">

1230 デフォルト動作1240 デフォルトの動作

1231</h4>1241</h4>

1232 1242

1233`settingSources` が省略されるか `undefined` の場合、`query()` は Claude Code CLI と同じファイルシステム設定を読み込みます: ユーザー、プロジェクト、ローカル。[settingSources が制御しないもの](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control)を参照して、関係なく読み込まれる入力と、それらを無効にする方法を確認してください。1243`settingSources` が省略されているか `undefined` の場合、`query()` は Claude Code CLI と同じファイルシステム設定（user、project、local）を読み込みます。このオプションに関係なく読み込まれる入力とそれらを無効にする方法については、[settingSources が制御しないもの](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control)を参照してください。

1234 1244

1235<h4 id="why-use-settingsources">1245<h4 id="why-use-settingsources">

1236 settingSources を使用する理由1246 settingSources を使用する理由

1237</h4>1247</h4>

1238 1248

1239**ファイルシステム設定を無効にします:**1249**ファイルシステム設定を無効にする：**

1240 1250

1241```typescript theme={null}1251```typescript theme={null}

1242import { query } from "@anthropic-ai/claude-agent-sdk";1252import { query } from "@anthropic-ai/claude-agent-sdk";

1243 1253

1244// ディスクからユーザー、プロジェクト、ローカル設定を読み込まないでください1254// Do not load user, project, or local settings from disk

1245const result = query({1255const result = query({

1246 prompt: "Analyze this code",1256 prompt: "Analyze this code",

1247 options: { settingSources: [] }1257 options: { settingSources: [] }

1248});1258});

1249```1259```

1250 1260

1251**特定の設定ソースのみを読み込みます:**1261**特定の設定ソースのみを読み込む：**

1252 1262

1253```typescript theme={null}1263```typescript theme={null}

1254import { query } from "@anthropic-ai/claude-agent-sdk";1264import { query } from "@anthropic-ai/claude-agent-sdk";

1255 1265

1256// プロジェクト設定のみを読み込み、ユーザーとローカルを無視します1266// Load only project settings, ignore user and local

1257const result = query({1267const result = query({

1258 prompt: "Run CI checks",1268 prompt: "Run CI checks",

1259 options: {1269 options: {

1260 settingSources: ["project"] // .claude/settings.json のみ1270 settingSources: ["project"] // Only .claude/settings.json

1261 }1271 }

1262});1272});

1263```1273```

1264 1274

1265CLAUDE.md プロジェクト指示を読み込むには、`settingSources` に `"project"` を含めます。CLAUDE.md 読み込みがシステムプロンプトオプションとどのように相互作用するかについては、[システムプロンプトを変更](/docs/ja/agent-sdk/modifying-system-prompts#claude-md-files-for-project-level-instructions)を参照してください。1275CLAUDE.md のプロジェクト指示を読み込むには、`settingSources` に `"project"` を含めてください。CLAUDE.md の読み込みとシステムプロンプトのオプションとの関係については、[システムプロンプトの変更](/docs/ja/agent-sdk/modifying-system-prompts#claude-md-files-for-project-level-instructions)を参照してください。

1266 1276

1267<h4 id="settings-precedence">1277<h4 id="settings-precedence">

1268 設定優先順位1278 設定の優先順位

1269</h4>1279</h4>

1270 1280

1271複数のソースが読み込まれる場合、設定はこの優先順位（最高から最低）でマージされます:1281複数のソースが読み込まれた場合、設定は次の優先順位（高い順）でマージされます：

1272 1282

12731. ローカル設定（`.claude/settings.local.json`）12831. ローカル設定（`.claude/settings.local.json`）

12742. プロジェクト設定（`.claude/settings.json`）12842. プロジェクト設定（`.claude/settings.json`）

12753. ユーザー設定（`~/.claude/settings.json`）12853. ユーザー設定（`~/.claude/settings.json`）

1276 1286

1277`agents`、`allowedTools`、`settings` などのプログラムオプションは、ユーザー、プロジェクト、ローカルファイルシステム設定をオーバーライドします。管理ポリシー設定はプログラムオプションより優先されます。1287`agents`、`allowedTools`、`settings` などのプログラムによるオプションは、ユーザー、プロジェクト、ローカルのファイルシステム設定を上書きします。管理ポリシー設定はプログラムによるオプションよりも優先されます。

1278 1288

1279<h3 id="permissionmode">1289<h3 id="permissionmode">

1280 `PermissionMode`1290 `PermissionMode`

1282 1292

1283```typescript theme={null}1293```typescript theme={null}

1284type PermissionMode =1294type PermissionMode =

1285 | "default" // 標準権限動作1295 | "default" // Standard permission behavior

1286 | "acceptEdits" // ファイル編集を自動受け入れ1296 | "acceptEdits" // Auto-accept file edits

1287 | "bypassPermissions" // 権限チェックをバイパス。明示的な質問ルールはプロンプトを表示1297 | "bypassPermissions" // Bypass permission checks; explicit ask rules still prompt

1288 | "plan" // プランニングモード - 編集なしで探索1298 | "plan" // Planning mode - explore without editing

1289 | "dontAsk" // 権限をプロンプトしない、事前承認されていない場合は拒否1299 | "dontAsk" // Don't prompt for permissions, deny if not pre-approved

1290 | "auto"; // モデル分類器がシェルコマンドやネットワークリクエストなどのアクションをレビュー1300 | "auto"; // A model classifier reviews actions such as shell commands and network requests

1291```1301```

1292 1302

1293<h3 id="canusetool">1303<h3 id="canusetool">

1294 `CanUseTool`1304 `CanUseTool`

1295</h3>1305</h3>

1296 1306

1297ツール使用を制御するためのカスタム権限関数型。1307ツールの使用を制御するためのカスタム権限関数の型です。

1298 1308

1299関数は対話型権限プロンプトの SDK 置き換えです。[権限評価フロー](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)がプロンプトに解決する場合にのみ呼び出されます。`allowedTools` エントリ、設定許可ルール、または `acceptEdits` や `bypassPermissions` などの権限モードで既に承認されたツール呼び出しは、それを呼び出しません。すべてのツール呼び出しをゲートするには、代わりに [`PreToolUse` フック](/docs/ja/agent-sdk/hooks)を使用します。1309この関数は、対話型の権限プロンプトを SDK で置き換えるものです。[権限評価フロー](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)の結果がプロンプトになった場合にのみ呼び出されます。`allowedTools` のエントリ、設定の許可ルール、または `acceptEdits` や `bypassPermissions` などの権限モードによってすでに承認されているツール呼び出しでは、この関数は呼び出されません。すべてのツール呼び出しを制御するには、代わりに [`PreToolUse` フック](/docs/ja/agent-sdk/hooks)を使用してください。

1300 1310

1301許可ルールは [どのモードも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認しません。[権限がどのように評価されるか](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)を参照して、どれがコールバックに到達し、`dontAsk` および `auto` モードで何が起こるかを確認してください。1311許可ルールは、[どのモードでも自動承認されないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認しません。それらのうちどれがコールバックに到達するか、また `dontAsk` モードと `auto` モードで何が起こるかについては、[権限の評価方法](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)を参照してください。

1302 1312

1303```typescript theme={null}1313```typescript theme={null}

1304type CanUseTool = (1314type CanUseTool = (

1321 1331

1322| オプション | 型 | 説明 |1332| オプション | 型 | 説明 |

1323| :- | :- | :- |1333| :- | :- | :- |

1325| `suggestions` | [`PermissionUpdate`](#permissionupdate)`[]` | 提案された権限更新。ユーザーがこのツールに対して再度プロンプトされないようにします。Bash プロンプトには `localSettings` [宛先](#permissionupdatedestination)を含む提案が含まれるため、`updatedPermissions` で返すと、ルールを `.claude/settings.local.json` に書き込み、セッション全体で永続化します。 |1335| `suggestions` | [`PermissionUpdate`](#permissionupdate)`[]` | このツールについてユーザーに再度プロンプトが表示されないようにするための、提案された権限の更新。Bash のプロンプトには `localSettings` [保存先](#permissionupdatedestination)を持つ提案が含まれるため、それを `updatedPermissions` で返すとルールが `.claude/settings.local.json` に書き込まれ、セッションをまたいで保持されます。 |

1327| `mcpServer` | `{ name: string; source: string }` | `mcp__*` ツールの場合、それを提供する MCP サーバーとそのサーバーの定義がどこから来たか。[`McpServerProvenance`](#mcpserverprovenance)のフィールド。他のツールでは不在です。Agent SDK v0.3.274 以降が必要です |1337| `mcpServer` | `{ name: string; source: string }` | `mcp__*` ツールの場合、そのツールを提供する MCP サーバーと、そのサーバーの定義の取得元。フィールドは [`McpServerProvenance`](#mcpserverprovenance) と同じです。その他のツールでは存在しません。Agent SDK v0.3.274 以降が必要です |

1333| `requestId` | `string` | `control_request` エンベロープの `request_id`。アプリケーションが SDK の外で送信する `control_response`（署名付き HTTP POST など）は、Claude Code プロセスが返信をリクエストと一致させることができるようにこの値をエコーする必要があります |1343| `requestId` | `string` | `control_request` エンベロープの `request_id`。アプリケーションが SDK の外部から送信する `control_response`（署名付き HTTP POST など）は、Claude Code プロセスが応答をリクエストと照合できるよう、この値をそのまま返す必要があります |

1334 1344

1335コールバックは通常、[`PermissionResult`](#permissionresult)を返すことでリクエストを解決し、SDK はそれを `control_response` としてトランスポート上に書き込みます。このリクエストの `control_response` を既に独自のチャネルで送信した場合にのみ `null` を返し、`requestId` をエコーします。SDK はトランスポートへのレスポンス書き込みをスキップします。他の場合に `null` を返すと、`control_response` が送信されず、権限プロンプトはタイムアウトしないため、ツール呼び出しは無期限にブロックされたままになります。1345コールバックは通常、[`PermissionResult`](#permissionresult) を返すことでリクエストを解決し、SDK はそれを `control_response` としてトランスポート経由で書き戻します。`null` を返すのは、アプリケーションがすでに独自のチャネル経由で `requestId` を含めてこのリクエストの `control_response` を送信済みの場合に限ってください。その場合、SDK はトランスポートへのレスポンスの書き込みをスキップします。それ以外のケースで `null` を返すと、`control_response` が送信されず、権限プロンプトはタイムアウトしないため、ツール呼び出しが無期限にブロックされたままになります。

1336 1346

1337`requestId` オプションと `null` 戻り値には Claude Code v2.1.199 以降が必要です。1347`requestId` オプションと `null` の戻り値には、Claude Code v2.1.199 以降が必要です。

1338 1348

1339<h3 id="permissionresult">1349<h3 id="permissionresult">

1340 `PermissionResult`1350 `PermissionResult`

1341</h3>1351</h3>

1342 1352

1343権限チェックの結果。1353権限チェックの結果です。

1344 1354

1345```typescript theme={null}1355```typescript theme={null}

1346type PermissionResult =1356type PermissionResult =

1362 `ToolConfig`1372 `ToolConfig`

1363</h3>1373</h3>

1364 1374

1365組み込みツール動作の設定。1375組み込みツールの動作に関する設定です。

1366 1376

1367```typescript theme={null}1377```typescript theme={null}

1368type ToolConfig = {1378type ToolConfig = {

1374 1384

1375| フィールド | 型 | 説明 |1385| フィールド | 型 | 説明 |

1376| :- | :- | :- |1386| :- | :- | :- |

1378 1388

1379<h3 id="mcpserverconfig">1389<h3 id="mcpserverconfig">

1380 `McpServerConfig`1390 `McpServerConfig`

1381</h3>1391</h3>

1382 1392

1383MCP サーバーの設定。1393MCP サーバーの設定です。

1384 1394

1385```typescript theme={null}1395```typescript theme={null}

1386type McpServerConfig =1396type McpServerConfig =

1456 `SdkPluginConfig`1466 `SdkPluginConfig`

1457</h3>1467</h3>

1458 1468

1459SDK でプラグインを読み込むための設定。1469SDK でプラグインを読み込むための設定です。

1460 1470

1461```typescript theme={null}1471```typescript theme={null}

1462type SdkPluginConfig = {1472type SdkPluginConfig = {

1468 1478

1469| フィールド | 型 | 説明 |1479| フィールド | 型 | 説明 |

1470| :- | :- | :- |1480| :- | :- | :- |

1473| `skipMcpDiscovery` | `boolean` | `true` の場合、SDK はこのプラグインからスキル、フック、エージェント、コマンドを読み込みますが、その `.mcp.json` またはマニフェスト `mcpServers` は読み込みません。アプリケーションがプラグインの MCP 接続を所有している場合に設定します。 |1483| `skipMcpDiscovery` | `boolean` | `true` の場合、SDK はこのプラグインからスキル、フック、エージェント、コマンドを読み込みますが、`.mcp.json` やマニフェストの `mcpServers` は読み込みません。アプリケーションがプラグインの MCP 接続を管理する場合に設定してください。 |

1474 1484

1475**例:**1485**例：**

1476 1486

1477```typescript theme={null}1487```typescript theme={null}

1478plugins: [1488plugins: [

1481];1491];

1482```1492```

1483 1493

1484プラグインの作成と使用に関する完全な情報については、[プラグイン](/docs/ja/agent-sdk/plugins)を参照してください。1494プラグインの作成と使用に関する詳細については、[プラグイン](/docs/ja/agent-sdk/plugins)を参照してください。

1485 1495

1486<h2 id="message-types">1496<h2 id="message-types">

1487 メッセージ型1497 メッセージタイプ

1488</h2>1498</h2>

1489 1499

1490<h3 id="sdkmessage">1500<h3 id="sdkmessage">

1556};1566};

1557```1567```

1558 1568

1559`message` フィールドは Anthropic SDK の [`BetaMessage`](https://platform.claude.com/docs/en/api/messages/create) です。`id`、`content`、`model`、`stop_reason`、`usage` などのフィールドが含まれます。1569`message` フィールドは Anthropic SDK の [`BetaMessage`](https://platform.claude.com/docs/en/api/messages/create) です。`id`、`content`、`model`、`stop_reason`、`usage` などのフィールドを含みます。

1560 1570

1561`SDKAssistantMessageError` は `'authentication_failed'`、`'oauth_org_not_allowed'`、`'account_on_hold'`、`'billing_error'`、`'rate_limit'`、`'overloaded'`、`'invalid_request'`、`'model_not_found'`、`'server_error'`、`'max_output_tokens'`、`'cloud_credential_error'`、`'unknown'` のいずれかです。このうち 4 つの値は、名前が示す以上の意味を持ちます。1571`SDKAssistantMessageError` は `'authentication_failed'`、`'oauth_org_not_allowed'`、`'account_on_hold'`、`'billing_error'`、`'rate_limit'`、`'overloaded'`、`'invalid_request'`、`'model_not_found'`、`'server_error'`、`'max_output_tokens'`、`'cloud_credential_error'`、`'unknown'` のいずれかです。このうち 4 つの値は、名前から読み取れる以上の意味を持ちます。

1562 1572

1563* `'model_not_found'`: 選択したモデルが存在しないか、アカウントまたはデプロイで利用できません1573* `'model_not_found'`: 選択したモデルが存在しないか、アカウントまたはデプロイで利用できない

1564* `'overloaded'`: サーバーが容量の上限に達しているため API が 529 を返しました。これに対して `'rate_limit'` は、クォータに対する 429 です1574* `'overloaded'`: サーバーが容量の上限に達しているため API が 529 を返した。これに対して `'rate_limit'` は、クォータに対する 429 を意味する

1565* `'account_on_hold'`: [アカウントが保留中です](/docs/ja/errors#your-account-is-on-hold)1575* `'account_on_hold'`: [アカウントが保留中になっている](/docs/ja/errors#your-account-is-on-hold)

1566* `'cloud_credential_error'`: Claude Code を実行しているマシン上で使用可能な AWS または Google Cloud の認証情報を取得できなかったため、リクエストがクラウドプロバイダーに届きませんでした。通常の原因は、そのマシンでのクラウドへのサインインが期限切れになったか、完了していなかったことですが、認証情報サービスに一時的に到達できない場合も同じ値が報告されます。[Could not load AWS or Google Cloud credentials](/docs/ja/errors#could-not-load-aws-or-google-cloud-credentials) を参照してください。TypeScript Agent SDK v0.3.267 以降（Claude Code v2.1.267 を同梱）が必要です1576* `'cloud_credential_error'`: Claude Code が実行中のマシン上で使用可能な AWS または Google Cloud の認証情報を取得できなかったため、クラウドプロバイダーにリクエストが届かなかった。通常の原因は、そのマシン上でのクラウドへのサインインが期限切れになったか、完了していないことですが、認証情報サービスに一時的に到達できない場合も同じ値が報告されます。[Could not load AWS or Google Cloud credentials](/docs/ja/errors#could-not-load-aws-or-google-cloud-credentials) を参照してください。Claude Code v2.1.267 を同梱する TypeScript Agent SDK v0.3.267 以降が必要です

1567 1577

1568`aborted` は、割り込みまたは中止によってストリームの完了前にアシスタントメッセージが途中で切れた場合に `true` になります。このときメッセージには `stop_reason` がなく、内容が単語の途中で終わっている可能性があります。正常に完了したメッセージにはこのフィールドはありません。Agent SDK v0.3.214 以降が必要です。1578`aborted` は、ストリームが完了する前に中断または中止によってアシスタントメッセージが切り詰められた場合に `true` になります。このときメッセージには `stop_reason` がなく、内容が単語の途中で終わっている可能性があります。正常に完了したメッセージにはこのフィールドはありません。Agent SDK v0.3.214 以降が必要です。

1569 1579

1570Claude Code は、[`user_message_uuid`](#user_message_uuid) に記載の条件のもとで、ターンの最初のアシスタントメッセージに `user_message_uuid` と `user_message_uuids` を設定します。再起動によって中断されたターンを Claude Code が再実行する場合、これらのフィールドを持つ再実行時のアシスタントメッセージには [`resume_reason`](#resume_reason) も付与されます。1580Claude Code は、[`user_message_uuid`](#user_message_uuid) に記載された条件のもとで、ターンの最初のアシスタントメッセージに `user_message_uuid` と `user_message_uuids` を設定します。再起動によって中断されたターンを Claude Code が再実行する場合、再実行でこれらのフィールドを持つアシスタントメッセージには [`resume_reason`](#resume_reason) も含まれます。

1571 1581

1572`timestamp` は、メッセージを生成したプロセス上でメッセージの内容の生成が完了した時刻を示す ISO 8601 形式の値です。この値はそのマシンの時計に基づくため、表示目的にのみ使用し、メッセージの並べ替えには使用しないでください。1 回の API ターンで、同じ `message.id` を共有する複数のアシスタントメッセージが生成されることがあり、それぞれに独自の `timestamp` があります。このフィールドがない場合は、メッセージを受信した時刻にフォールバックしてください。1582`timestamp` は、メッセージを生成したプロセス上でそのメッセージの内容の生成が完了した時刻を ISO 8601 形式で表します。値はそのマシンの時計に基づくため、表示目的にのみ使用し、メッセージの並べ替えには使用しないでください。1 回の API ターンで、同じ `message.id` を共有する複数のアシスタントメッセージが生成されることがあり、それぞれが独自の `timestamp` を持ちます。このフィールドがない場合は、メッセージを受信した時刻で代用してください。

1573 1583

1574`context_usage` は `/context` レポートの構造化されたコピーで、型は [`SDKContextUsage`](#sdkcontextusage) です。Agent SDK v0.3.232 以降が必要です。`/context` をプロンプトとして送信すると、Claude Code は `message.content` に markdown の表を含むアシスタントメッセージとしてレポートを配信し、その同じメッセージに `context_usage` を付与します。Claude Code は他のアシスタントメッセージにはこのフィールドを設定せず、それ以前のバージョンではこのフィールドなしで `/context` の表が配信されます。そのため、このフィールドがある場合はそこから内訳を読み取り、ない場合は markdown テキストにフォールバックしてください。1584`context_usage` は `/context` レポートの構造化されたコピーで、型は [`SDKContextUsage`](#sdkcontextusage) です。Agent SDK v0.3.232 以降が必要です。`/context` をプロンプトとして送信すると、Claude Code は `message.content` に markdown の表を含むアシスタントメッセージとしてレポートを返し、同じメッセージに `context_usage` を付加します。Claude Code はこれ以外のアシスタントメッセージにはこのフィールドを設定せず、以前のバージョンではこのフィールドなしで `/context` の表が返されます。そのため、フィールドが存在する場合はそこから内訳を読み取り、存在しない場合は markdown テキストにフォールバックしてください。

1575 1585

1576<h3 id="sdkusermessage">1586<h3 id="sdkusermessage">

1577 `SDKUserMessage`1587 `SDKUserMessage`

1597};1607};

1598```1608```

1599 1609

1600ユーザーが入力したのではなくプロンプト UI に貼り付けた内容を送信するには、`pasted_content` を設定します。貼り付け 1 回につき 1 エントリで、各エントリは文字列またはコンテンツブロックの配列です。Claude Code は各エントリのテキストを、入力されたテキストの後に順番に追加し、各貼り付けを `<pasted_content>` タグで囲むことがあります。テキスト以外のブロックは無視されるため、画像やドキュメントは `message.content` で送信してください。Agent SDK v0.3.277 以降が必要です。1610ユーザーが入力したのではなくプロンプト UI に貼り付けたコンテンツを送信するには、`pasted_content` を設定します。貼り付け 1 回につき 1 エントリで、各エントリは文字列またはコンテンツブロックの配列です。Claude Code は各エントリのテキストを入力テキストの後に順番に追加し、各貼り付けを `<pasted_content>` タグで囲むことがあります。テキスト以外のブロックは無視されるため、画像やドキュメントは `message.content` で送信してください。Agent SDK v0.3.277 以降が必要です。

1601 1611

1602`message.content` のどの部分をユーザーが入力ではなく貼り付けたかを Claude Code に伝えるには、`inline_pastes` を設定します。貼り付け 1 回につき 1 つの文字列です。プロンプトのテキストはユーザーが置いた位置にそのまま残ります。Claude Code はリストに含まれる各貼り付けをその位置で `<pasted_content>` タグで囲むことがあり、これにより Claude は貼り付けられた素材とユーザー自身の言葉を区別できます。囲まれるのは、プロンプトの最後のテキストブロック内の貼り付けだけです。TypeScript Agent SDK v0.3.280 以降が必要です。1612`message.content` のどの部分をユーザーが入力したのではなく貼り付けたのかを Claude Code に伝えるには、`inline_pastes` を設定します。貼り付け 1 回につき 1 つの文字列を指定します。プロンプトのテキストはユーザーが置いた位置のままです。Claude Code は、Claude が貼り付けられた内容とユーザー自身の言葉を区別できるよう、リストに含まれる各貼り付けをその位置で `<pasted_content>` タグで囲むことがあります。囲まれるのは、プロンプトの最後のテキストブロック内の貼り付けのみです。TypeScript Agent SDK v0.3.280 以降が必要です。

1603 1613

1604送信するメッセージを Claude Code がどのように扱うかを変更するには、`shouldQuery`、`client_composed`、または `priority` を設定します。1614`shouldQuery`、`client_composed`、または `priority` を設定すると、送信したメッセージを Claude Code がどのように扱うかを変更できます。

1605 1615

1606* `shouldQuery`: `false` に設定すると、アシスタントのターンをトリガーせずにメッセージをトランスクリプトに追加します。メッセージは保持され、ターンをトリガーする次のユーザーメッセージにマージされます。帯域外で実行したコマンドの出力などのコンテキストを、モデル呼び出しを消費せずに挿入する場合に使用します。1616* `shouldQuery`: `false` に設定すると、アシスタントのターンを開始せずにメッセージをトランスクリプトに追加します。メッセージは保持され、ターンを開始する次のユーザーメッセージにマージされます。帯域外で実行したコマンドの出力などのコンテキストを、モデル呼び出しを消費せずに注入するために使用します。

1607* `client_composed`: `true` に設定すると、Claude Code はメッセージのテキストを記述されたとおりに配信します。その場合、Claude Code は `@path` や [`@server:resource`](/docs/ja/mcp#use-mcp-resources) のメンションを展開せず、`/` で始まるテキストをコマンドとして実行しません。[`verbatimPrompts`](#options) オプションがオンの間は、SDK がすべてのメッセージにこのフィールドを設定します。TypeScript Agent SDK v0.3.280 以降と Claude Code v2.1.248 以降が必要です。1617* `client_composed`: `true` に設定すると、Claude Code はメッセージのテキストを書かれたとおりに渡します。この場合、Claude Code は `@path` や [`@server:resource`](/docs/ja/mcp#use-mcp-resources) のメンションを展開せず、`/` で始まるテキストをコマンドとして実行しません。[`verbatimPrompts`](#options) オプションが有効な間は、SDK がすべてのメッセージにこのフィールドを設定します。TypeScript Agent SDK v0.3.280 以降および Claude Code v2.1.248 以降が必要です。

1608* `priority`: 実行中のターンの間に送信したメッセージが Claude に届くタイミングを制御します。1618* `priority`: 実行中のターンの間に送信したメッセージが Claude に届くタイミングを制御します。

1609 * `'next'`、または `priority` フィールドなし: Claude は、実行中のツール呼び出しが終わり次第、同じターン内でメッセージを読みます。先にターンが終了した場合は、そのメッセージが次のターンを開始します。1619 * `'next'`、または `priority` フィールドなし: Claude は実行中のツール呼び出しが完了するとすぐに、同じターン内でメッセージを読み取ります。先にターンが終了した場合は、そのメッセージが次のターンを開始します。

1610 * `'later'`: Claude Code はターンが終了するまでメッセージを保持し、新しいターンとして送信します。1620 * `'later'`: Claude Code はターンが終了するまでメッセージを保持し、新しいターンとして送信します。

1611 * [`origin: { kind: "human" }`](#sdkmessageorigin) 付きの `'now'`: Claude Code v2.1.286 以降では、バックグラウンドで続行できる作業はバックグラウンドに移され、Claude は同じターン内でメッセージを読みます。移動できる作業には、シェルコマンド、サブエージェント、MCP ツール呼び出しが含まれます。v2.1.287 以降では、WebFetch と WebSearch の呼び出しも含まれます。Claude が応答を書いているだけの場合や、実行中の作業を移動できない場合は、Claude Code は代わりにターンを中断し、Claude は次にメッセージを読みます。1621 * [`origin: { kind: "human" }`](#sdkmessageorigin) を伴う `'now'`: Claude Code v2.1.286 以降では、バックグラウンドで継続できる作業はバックグラウンドに移され、Claude は同じターン内でメッセージを読み取ります。移動できる作業には、シェルコマンド、サブエージェント、MCP ツール呼び出しが含まれます。v2.1.287 以降では、WebFetch と WebSearch の呼び出しも含まれます。Claude が応答を書いているだけの場合や、実行中の作業を移動できない場合は、代わりに Claude Code がターンを中断し、Claude は次にメッセージを読み取ります。

1612 * その origin なしの `'now'`: Claude Code はターンを中断し、Claude は次にメッセージを読みます。1622 * その origin を伴わない `'now'`: Claude Code がターンを中断し、Claude は次にメッセージを読み取ります。

1613 1623

1614次のメッセージは、ターンの実行中に送信され、まだ実行中のシェルコマンドを失わずに方針を変更するよう Claude に依頼するものです。1624次のメッセージは、ターンの実行中に送信され、まだ実行中のシェルコマンドを失うことなく方針の変更を Claude に求めます。

1615 1625

1616```typescript theme={null}1626```typescript theme={null}

1617const message: SDKUserMessage = {1627const message: SDKUserMessage = {

1623};1633};

1624```1634```

1625 1635

1626`tool_result` ブロックを含むメッセージでは、`tool_use_result` はモデルに送信されたテキストではなく、ツールの構造化された出力オブジェクトです。その形状は対応する `tool_use` ブロックで指定されたツールによって異なるため、このフィールドの型は `unknown` です。組み込みの形状は [Tool Output Types](#tool-output-types) に記載されています。次の結果は、記載された形状以上の扱いが必要です。1636`tool_result` ブロックを含むメッセージでは、`tool_use_result` はモデルに送信されるテキストではなく、ツールの構造化された出力オブジェクトです。その形状は対応する `tool_use` ブロックで指定されたツールによって異なるため、このフィールドの型は `unknown` です。組み込みの形状は [Tool Output Types](#tool-output-types) に記載されています。次の結果には、記載された形状以上の処理が必要です。

1627 1637

1628* `Agent` ツール: `tool_use_result` は [`AgentOutput`](#agent-2) です。`tool_result` のテキストを解析するのではなく、これをもとに描画してください。`completed` の結果の `content` にはサブエージェントのレポートが入ります。ただし、レポートを `SubagentHandback` ツール呼び出しで渡すサブエージェントの場合は、レポートの代わりにその引き渡しに関する短いメモが入ります。Claude Code v2.1.271 以降の [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)では、[フォーク](/docs/ja/sub-agents#fork-the-current-conversation)を除き、`completed` の結果を生成するすべてのサブエージェントがその方法でレポートし、Claude はサブエージェントからの別のメッセージとしてレポートを受け取ります。1638* `Agent` ツール: `tool_use_result` は [`AgentOutput`](#agent-2) です。`tool_result` のテキストを解析するのではなく、これを元に表示してください。`completed` の結果の `content` にはサブエージェントのレポートが含まれます。ただし、レポートを `SubagentHandback` ツール呼び出しで渡すサブエージェントの場合は、レポートの代わりにその引き渡しに関する短い注記が含まれます。Claude Code v2.1.271 以降の [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)では、`completed` の結果を生成するすべてのサブエージェントは、[フォーク](/docs/ja/sub-agents#fork-the-current-conversation)でない限りこの方法でレポートし、Claude はレポートをサブエージェントからの別のメッセージとして受け取ります。

1629* `'now'` メッセージを配信するために Claude Code がバックグラウンドに移した WebFetch または WebSearch の呼び出し: その呼び出しの `tool_result` を含むユーザーメッセージでは、`tool_use_result` が `{ detachedToolCall: true }` に設定されます。呼び出しはまだ実行中で、完了すると Claude はその結果を受け取ります。その `tool_use_id` に対する 2 つ目の `tool_result` は続かないため、アプリケーションでツール呼び出しごとに行を描画している場合は、このメッセージが届いた時点でその行をバックグラウンドに移動済みとしてマークしてください。Claude Code v2.1.287 以降が必要です。1639* `'now'` メッセージを届けるために Claude Code がバックグラウンドに移した WebFetch または WebSearch の呼び出し: その呼び出しの `tool_result` を含むユーザーメッセージでは、`tool_use_result` が `{ detachedToolCall: true }` に設定されます。呼び出しはまだ実行中で、完了すると Claude はその結果を受け取ります。その `tool_use_id` に対する 2 つ目の `tool_result` は続かないため、アプリケーションでツール呼び出しごとに行を描画している場合は、このメッセージを受信した時点でその行をバックグラウンドに移動済みとしてマークしてください。Claude Code v2.1.287 以降が必要です。

1630* 結果に `resource_link` ブロックを含む MCP ツール: `tool_use_result` は、[`SDKMcpResourceLink`](#sdkmcpresourcelink) エントリの `resourceLinks` 配列を持つオブジェクトです。Claude は各リンクを `tool_result` ブロック内のテキスト行として受け取るため、サーバーが返したファイルを描画するには、そのテキストを解析するのではなく `resourceLinks` を読み取ってください。Claude Code は、結果にリンクがない場合とサブエージェントからの結果では `resourceLinks` を省略し、1 つの結果につき最大 50 個のリンクを保持し、配列がシリアライズされた JSON で 64 KiB に達するとリンクの追加を停止します。`resourceLinks` には Agent SDK v0.3.257 以降が必要です。1640* 結果に `resource_link` ブロックを含む MCP ツール: `tool_use_result` は、[`SDKMcpResourceLink`](#sdkmcpresourcelink) エントリの `resourceLinks` 配列を持つオブジェクトです。Claude は各リンクを `tool_result` ブロック内の 1 行のテキストとして受け取るため、そのテキストを解析するのではなく `resourceLinks` を読み取ってサーバーが返したファイルを表示してください。Claude Code は、結果にリンクがない場合およびサブエージェントからの結果では `resourceLinks` を省略し、1 つの結果につき最大 50 個のリンクを保持し、配列がシリアル化された JSON で 64 KiB に達するとリンクの追加を停止します。`resourceLinks` には Agent SDK v0.3.257 以降が必要です。

1631* [`structuredContent`](#calltoolresult) を返す MCP ツール: `tool_use_result` は、`structuredContent` メンバーにサーバーが送信した内容を、`content` メンバーに [`McpOutput`](#mcpoutput) の値を保持するオブジェクトです。サブエージェントからの結果には `structuredContent` は含まれません。1641* [`structuredContent`](#calltoolresult) を返す MCP ツール: `tool_use_result` は、`structuredContent` メンバーにサーバーが送信したものを、`content` メンバーに [`McpOutput`](#mcpoutput) の値を保持するオブジェクトです。サブエージェントからの結果には `structuredContent` は含まれません。

1632* `structuredContent` をシリアライズすると JSON で 1,048,576 文字を超える MCP ツール: Claude Code は `tool_use_result` から `structuredContent` を除外し、代わりに `structuredContentOmitted: true` を設定します。これにより、アプリケーションはオブジェクトが削除されたのか、ツールが何も送信しなかったのかを区別できます。`content` や `resourceLinks` などの他のメンバーは残り、Claude が受け取る内容は変わりません。[インプロセス SDK サーバー](/docs/ja/agent-sdk/custom-tools)のツールと、`tools/list` エントリで [MCP Apps の `_meta.ui` リソース](#mcpserverstatus)を宣言しているツールは対象外で、オブジェクト全体を配信します。この上限は Claude Code v2.1.287 以降で適用されます。1642* `structuredContent` が JSON にシリアル化すると 1,048,576 文字を超える MCP ツール: Claude Code は `tool_use_result` から `structuredContent` を除外し、代わりに `structuredContentOmitted: true` を設定します。これにより、アプリケーションはオブジェクトが除外されたのか、ツールが何も送信しなかったのかを区別できます。`content` や `resourceLinks` などの他のメンバーは残り、Claude が受け取る内容は変わりません。[インプロセス SDK サーバー](/docs/ja/agent-sdk/custom-tools)のツールと、`tools/list` エントリで [MCP Apps の `_meta.ui` リソース](#mcpserverstatus)を宣言しているツールは対象外で、オブジェクト全体を渡します。この上限は Claude Code v2.1.287 以降で適用されます。

1633 1643

1634<h3 id="sdkusermessagereplay">1644<h3 id="sdkusermessagereplay">

1635 `SDKUserMessageReplay`1645 `SDKUserMessageReplay`

1636</h3>1646</h3>

1637 1647

1638UUID が必須の、再生されたユーザーメッセージです。1648必須の UUID を持つ再生されたユーザーメッセージです。

1639 1649

1640```typescript theme={null}1650```typescript theme={null}

1641type SDKUserMessageReplay = {1651type SDKUserMessageReplay = {

1652};1662};

1653```1663```

1654 1664

1655セッションの外部から挿入されたユーザーターン、つまり [`origin`](#sdkmessageorigin) の kind が `peer` または `channel` のターンは、アクティブなターンの間に配信された場合でも、セッションがアイドル状態のときに新しいターンを開始した場合でも、再生としてストリームに届きます。v2.1.207 より前は、セッションがアイドル状態のときに配信された挿入ターンはストリーム上にメッセージを生成せず、トランスクリプトを読み直したときにのみ表示されていました。1665セッションの外部から注入されたユーザーターン、つまり [`origin`](#sdkmessageorigin) の kind が `peer` または `channel` のものは、アクティブなターン中に配信された場合でも、セッションがアイドル状態のときに新しいターンを開始した場合でも、再生としてストリームに届きます。v2.1.207 より前は、セッションがアイドル状態のときに配信された注入ターンはストリームにメッセージを生成せず、トランスクリプトを読み直したときにのみ表示されていました。

1656 1666

1657<h3 id="sdkresultmessage">1667<h3 id="sdkresultmessage">

1658 `SDKResultMessage`1668 `SDKResultMessage`

1738 1748

1739結果のいくつかのフィールドは、`subtype` 以上の診断情報を提供します。1749結果のいくつかのフィールドは、`subtype` 以上の診断情報を提供します。

1740 1750

1741* `api_error_status`: 会話を終了させた API エラーの HTTP ステータスコードです。ターンが API エラーなしで終了した場合は存在しないか `null` です。1751* `api_error_status`: 会話を終了させた API エラーの HTTP ステータスコード。ターンが API エラーなしで終了した場合は、存在しないか `null` です。

1742* `ttft_ms`: 最初のトークンまでの時間（ミリ秒）で、最初の完全なアシスタントメッセージが届いた時点で測定されます。success 側にのみ存在します。1752* `ttft_ms`: 最初のトークンまでの時間（ミリ秒）で、最初の完全なアシスタントメッセージが到着した時点で測定されます。success アームにのみ存在します。

1743* `ttft_stream_ms`: 応答ストリームが開いたとき、最初の `message_start` ストリームイベントまでの時間（ミリ秒）です。`ttft_ms` より小さく、両者の差は最初のメッセージのストリーミングに費やされた時間です。success 側にのみ存在します。1753* `ttft_stream_ms`: 応答ストリームが開いたときの最初の `message_start` ストリームイベントまでの時間（ミリ秒）。`ttft_ms` より小さく、両者の差は最初のメッセージのストリーミングに費やされた時間です。success アームにのみ存在します。

1744* `user_message_uuid`: このターンが応答した、送信したメッセージの `uuid` です。どの結果にこれが含まれるかは [`user_message_uuid`](#user_message_uuid) を参照してください。1754* `user_message_uuid`: このターンが応答した、送信済みメッセージの `uuid`。どの結果がこれを持つかについては [`user_message_uuid`](#user_message_uuid) を参照してください。

1745* `user_message_uuids`: Claude Code がこのターンで応答した、送信したすべてのメッセージの `uuid` です。[`user_message_uuids`](#user_message_uuids) を参照してください。1755* `user_message_uuids`: このターンで Claude Code が応答した、送信済みのすべてのメッセージの `uuid`。[`user_message_uuids`](#user_message_uuids) を参照してください。

1746* `resume_reason`: 再起動による中断の後、Claude Code がこのターンを再実行した理由です。両方の側に存在しますが、そのような再実行の場合に限られます。[`resume_reason`](#resume_reason) を参照してください。1756* `resume_reason`: 再起動によって中断されたこのターンを Claude Code が再実行した理由。両方のアームに存在し、そのような再実行の場合にのみ含まれます。[`resume_reason`](#resume_reason) を参照してください。

1747* `local_command`: `/compact` など、エージェントループに入らずにコマンドで完了したターンの success 結果における、ターンがディスパッチしたコマンドの名前です。名前は小文字とアンダースコアに変換されるため、`/reload-plugins` は `reload_plugins` と報告されます。MCP サーバーが提供するコマンドと組み込みの `/mcp` は `mcp` と報告されます。自分で定義したコマンドは `custom` と報告されます。引数は含まれません。エージェントループに入ったすべてのターンと、コマンドを実行しなかった送信では存在しません。Agent SDK v0.3.268 以降が必要です。1757* `local_command`: `/compact` など、エージェントループに入らずにコマンドが完了したターンの success 結果における、そのターンがディスパッチしたコマンドの名前。名前は小文字とアンダースコアに変換されるため、`/reload-plugins` は `reload_plugins` と報告されます。MCP サーバーが提供するコマンドと組み込みの `/mcp` は `mcp` と報告されます。自分で定義したコマンドは `custom` と報告されます。引数は含まれません。エージェントループに入ったすべてのターンと、コマンドを実行しなかった送信には存在しません。Agent SDK v0.3.268 以降が必要です。

1748* `request_sent_wall_ms`: Claude Code が API リクエストをディスパッチしたエポックミリ秒で、サーバー側のタイムスタンプとの結合に使用します。API リクエストを送信したターンの、`is_error` が false の success 結果において、[`user_message_uuid`](#user_message_uuid) と一緒にのみ存在します。1758* `request_sent_wall_ms`: Claude Code が API リクエストをディスパッチした時刻のエポックミリ秒で、サーバー側のタイムスタンプとの結合に使用します。API リクエストを送信したターンの、`is_error` が false である success 結果において、[`user_message_uuid`](#user_message_uuid) と一緒にのみ存在します。

1749* `first_content_frame_ms`: 最初の `content_block_start` または `content_block_delta` ストリームイベントまでの時間（ミリ秒）で、思考ブロックもコンテンツとしてカウントします。success 側で `is_error` が false の場合にのみ存在します。Agent SDK v0.3.260 以降が必要です。1759* `first_content_frame_ms`: 最初の `content_block_start` または `content_block_delta` ストリームイベントまでの時間（ミリ秒）で、思考ブロックもコンテンツとして数えます。success アームで、`is_error` が false の場合にのみ存在します。Agent SDK v0.3.260 以降が必要です。

1750* `first_stream_post_ms`、`first_stream_post_ack_ms`、`first_stream_post_wall_ms`: ターンの最初のストリームイベントのアップロードに関するタイミングです。Claude Code は、[クラウドセッション](/docs/ja/claude-code-on-the-web)など claude.ai にストリーミングするセッションでのみこれらを記録し、`query()` が返す結果には含まれません。Agent SDK v0.3.260 以降が必要です。1760* `first_stream_post_ms`、`first_stream_post_ack_ms`、`first_stream_post_wall_ms`: ターンの最初のストリームイベントのアップロードに関するタイミング。Claude Code は、[クラウドセッション](/docs/ja/claude-code-on-the-web)など claude.ai にストリーミングするセッションでのみこれらを記録し、`query()` が返す結果にはこれらは含まれません。Agent SDK v0.3.260 以降が必要です。

1751* `usage`: メインのエージェントループのみが対象です。サブエージェントと補助的なモデル呼び出しは除外され、ストリーミング入力のセッションではターンごとの値になります。トークンやコストの集計には `modelUsage` を優先してください。1761* `usage`: メインのエージェントループのみが対象です。サブエージェントや補助的なモデル呼び出しは除外され、ストリーミング入力セッションではターンごとの値になります。トークンやコストの集計には `modelUsage` を優先してください。

1752* `modelUsage`: この `query()` 呼び出しの間にクエリパイプラインを通じて行われたすべてのモデル呼び出しの、モデルごとの合計です。メインループ、サブエージェント、およびコンテキスト圧縮や Workflow エージェントなどの内部呼び出しが含まれます。権限分類器やトークンカウントのリクエストなど、そのパイプライン外のヘルパー呼び出しは除外されます。セッションを再開する呼び出しでは、[セッションの以前の呼び出しから復元されたモデルごとの合計](/docs/ja/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)もカウントされます。ストリーミング入力のセッションでは合計がターンをまたいで累積されるため、結果を合算するのではなく最新の結果を読み取ってください。リセットについては [Track costs in streaming input mode](/docs/ja/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) を、ゼロになった結果については [Recover totals after a session crash](/docs/ja/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) を参照してください。1762* `modelUsage`: この `query()` 呼び出しの間にクエリパイプラインを通じて行われたすべてのモデル呼び出しのモデルごとの合計で、メインループ、サブエージェント、コンテキスト圧縮や Workflow エージェントなどの内部呼び出しを含みます。権限分類器やトークンカウントのリクエストなど、そのパイプライン外のヘルパー呼び出しは除外されます。セッションを再開する呼び出しでは、[セッションの以前の呼び出しから復元されたモデルごとの合計](/docs/ja/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)も数えられます。ストリーミング入力セッションでは合計がターンをまたいで累積されるため、結果を合算するのではなく最新の結果を読み取ってください。リセットについては [Track costs in streaming input mode](/docs/ja/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) を、ゼロになった結果については [Recover totals after a session crash](/docs/ja/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) を参照してください。

1753* `total_cost_usd`: USD での累積推定コストです。`modelUsage` と同じ呼び出しを対象とし、同じタイミングでリセットされます。セッションを再開する呼び出しでは、[セッションの以前の呼び出しから復元された合計](/docs/ja/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)もカウントされます。これは推定値であり、請求明細ではありません。精度に関する注意事項は [Track cost and usage](/docs/ja/agent-sdk/cost-tracking) を参照してください。1763* `total_cost_usd`: USD での累積推定コストで、`modelUsage` と同じ呼び出しを対象とし、同じタイミングでリセットされます。セッションを再開する呼び出しでは、[セッションの以前の呼び出しから復元された合計](/docs/ja/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)も数えられます。これは推定値であり、請求明細ではありません。精度に関する注意事項については [Track cost and usage](/docs/ja/agent-sdk/cost-tracking) を参照してください。

1754* `queued_turn_count`: Claude Code が結果を生成した時点でまだ待機中の、`origin: { kind: "human" }` 付きで送信したメッセージの数です。`0` とフィールドがない場合の意味については [`queued_turn_count`](#queued_turn_count) を参照してください。1764* `queued_turn_count`: Claude Code が結果を生成した時点でまだ待機中の、`origin: { kind: "human" }` を付けて送信したメッセージの数。`0` やフィールドがない場合の意味については [`queued_turn_count`](#queued_turn_count) を参照してください。

1755* `result_index`: 実行の配信順序におけるこの結果の位置で、プロセスが書き込むすべての結果を通して 0 から数えます。両方の側に存在します。書き込みに失敗した結果も番号を消費するため、シーケンスに欠番がある場合は結果が失われたことを意味します。Agent SDK v0.3.268 以降が必要です。1765* `result_index`: 実行の配信順序におけるこの結果の位置で、プロセスが書き込むすべての結果を通して 0 から数えます。両方のアームに存在します。書き込みに失敗した結果もその番号を消費するため、連番に欠番がある場合は結果が失われたことを意味します。Agent SDK v0.3.268 以降が必要です。

1756* `startup_failure_reason`: 既知の起動失敗で終了する前に Claude Code が書き込む `error_during_execution` 結果における、Claude Code が起動を拒否した理由です。値と、どの失敗がこれを含むかについては [`startup_failure_reason`](#startup_failure_reason) を参照してください。Agent SDK v0.3.274 以降が必要です。1766* `startup_failure_reason`: 既知の起動失敗で終了する前に Claude Code が書き込む `error_during_execution` 結果における、Claude Code が起動を拒否した理由。値とどの失敗がこれを持つかについては [`startup_failure_reason`](#startup_failure_reason) を参照してください。Agent SDK v0.3.274 以降が必要です。

1757* `terminal_reason`: ループが終了した理由です。`"completed"`、`"max_turns"`、`"tool_deferred"`、`"aborted_streaming"`、`"aborted_tools"`、`"hook_stopped"`、`"stop_hook_prevented"`、`"background_requested"`、`"blocking_limit"`、`"rapid_refill_breaker"`、`"prompt_too_long"`、`"image_error"`、`"model_error"`、`"api_error"`、`"malformed_tool_use_exhausted"`、`"budget_exhausted"`、`"structured_output_retry_exhausted"`、`"tool_deferred_unavailable"`、`"turn_setup_failed"` のいずれかです。1767* `terminal_reason`: ループが終了した理由。`"completed"`、`"max_turns"`、`"tool_deferred"`、`"aborted_streaming"`、`"aborted_tools"`、`"hook_stopped"`、`"stop_hook_prevented"`、`"background_requested"`、`"blocking_limit"`、`"rapid_refill_breaker"`、`"prompt_too_long"`、`"image_error"`、`"model_error"`、`"api_error"`、`"malformed_tool_use_exhausted"`、`"budget_exhausted"`、`"structured_output_retry_exhausted"`、`"tool_deferred_unavailable"`、`"turn_setup_failed"` のいずれかです。

1758* `fast_mode_state`: `"on"`、`"off"`、`"cooldown"` のいずれかです。1768* `fast_mode_state`: `"on"`、`"off"`、`"cooldown"` のいずれかです。

1759* `fast_mode_disabled_reason`: [fast mode](/docs/ja/fast-mode) が現在利用できない理由です。fast mode を妨げるものがない場合は存在しませんが、リクエストが標準速度で実行される場合もあります。fast mode のレート制限後のクールダウン中は、Claude Code は理由コードなしで `fast_mode_state: "cooldown"` を報告し、クールダウンが終了すると fast mode を再度有効にします。Claude Code v2.1.219 以降が必要です。1769* `fast_mode_disabled_reason`: [fast mode](/docs/ja/fast-mode) が現在利用できない理由。fast mode を妨げるものがない場合は存在しませんが、リクエストが標準速度で実行されることもあります。fast mode のレート制限後のクールダウン中、Claude Code は理由コードなしで `fast_mode_state: "cooldown"` を報告し、クールダウンが終了すると fast mode を再び有効にします。Claude Code v2.1.219 以降が必要です。

1760 1770

1761利用可能性を独自に導出し直すのではなく、理由コードを使用して、fast mode がオフになっている理由を独自の UI で説明してください。各コードは、fast mode を妨げたチェックを示します。1771利用可否を独自に導き直すのではなく、理由コードを使用して、fast mode がオフになっている理由を独自の UI で説明してください。各コードは、fast mode を妨げたチェックを示します。

1762 1772

1763| 理由コード | 意味 |1773| 理由コード | 意味 |

1764| - | - |1774| - | - |

1768| `network_error` | [利用可能性チェック](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)が `api.anthropic.com` に到達できませんでした |1778| `network_error` | [利用可否チェック](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)が `api.anthropic.com` に到達できなかった |

1772| `model_not_allowed` | fast mode の Opus モデルが、組織の [`availableModels`](/docs/ja/model-config#restrict-model-selection) 許可リストに含まれていません |1782| `model_not_allowed` | fast mode の Opus モデルが組織の [`availableModels`](/docs/ja/model-config#restrict-model-selection) 許可リストに含まれていない |

1773| `sdk_opt_in_required` | セッションが fast mode にオプトインしていません。[`settings`](#options) オプションで、または [`applyFlagSettings()`](#applyflagsettings) を通じて `fastMode: true` を渡してください |1783| `sdk_opt_in_required` | セッションが fast mode にオプトインしていない。[`settings`](#options) オプションで、または [`applyFlagSettings()`](#applyflagsettings) を通じて `fastMode: true` を渡してください |

1775 1785

1776同じフィールドのペアが [`SDKSystemMessage`](#sdksystemmessage) と [`SDKControlInitializeResponse`](#sdkcontrolinitializeresponse) にも含まれるため、最初のターンの前に fast mode の状態を読み取ることができます。1786同じ 2 つのフィールドが [`SDKSystemMessage`](#sdksystemmessage) と [`SDKControlInitializeResponse`](#sdkcontrolinitializeresponse) にも含まれるため、最初のターンの前に fast mode の状態を読み取ることができます。

1777 1787

1778`origin` フィールドは、この結果をトリガーしたユーザーメッセージの [`SDKMessageOrigin`](#sdkmessageorigin) を引き継ぎます。完了したバックグラウンドタスクなどのために SDK が合成のフォローアップターンを挿入した場合、生成される `SDKResultMessage` には `origin: { kind: "task-notification" }` が含まれます。トリガーが発火したルーティンや、他のセッションからのサーバー検証済みメッセージもこの kind で届き、それぞれに [Task-notification のサブ種別](#task-notification-subkinds)で説明する `subkind` が付きます。ルーティングや抑制を行う前に `kind` を確認して、プロンプトへの応答である結果と挿入されたフォローアップを区別してください。アプリケーションが[スケジュール実行を宣言](#declare-a-scheduled-run)している場合、その結果も `kind: "task-notification"` を持つため、`kind` だけで抑制しないでください。1788`origin` フィールドは、この結果をトリガーしたユーザーメッセージの [`SDKMessageOrigin`](#sdkmessageorigin) を転送します。完了したバックグラウンドタスクに対するものなど、SDK が合成のフォローアップターンを注入した場合、結果の `SDKResultMessage` には `origin: { kind: "task-notification" }` が含まれます。トリガーが発火したルーティンや、他のセッションからのサーバー検証済みメッセージもこの kind で届き、それぞれに [Task-notification subkinds](#task-notification-subkinds) で説明されている `subkind` が付きます。ルーティングや抑制を行う前に `kind` を確認して、プロンプトに応答する結果と注入されたフォローアップを区別してください。アプリケーションが[スケジュール実行を宣言する](#declare-a-scheduled-run)場合、その結果にも `kind: "task-notification"` が含まれるため、`kind` だけで抑制しないでください。

1779 1789

1780複数のバックグラウンドタスクの完了がまとめてキューに入った場合、Claude Code はそれぞれに 1 ターンずつではなく、1 つのターンでそれらに応答することがあります。その場合でも、各完了はこの origin を持つ独自の結果を生成します。Claude Code がまとめて応答する完了のうち最後のもの以外は、順番に `num_turns: 0` の空の結果を生成し、最後の完了の結果にすべてに応答するターンが含まれます。1790複数のバックグラウンドタスクの完了がまとめてキューに入っている場合、Claude Code はそれぞれに 1 ターンずつではなく、1 つのターンでそれらに応答することがあります。各完了はそれでもこの origin を持つ独自の結果を生成します。Claude Code がまとめて応答する完了のうち最後のもの以外は、順番に `num_turns: 0` の空の結果を生成し、最後のものの結果に、すべてに応答するターンが含まれます。

1781 1791

1782起動エラーなど、ユーザーターンの前に出力される結果では、このフィールドは存在しません。1792起動エラーなど、ユーザーターンの前に出力された結果にはこのフィールドはありません。

1783 1793

1784`PreToolUse` フックが `permissionDecision: "defer"` を返した場合、結果には `stop_reason: "tool_deferred"` が含まれ、`deferred_tool_use` に保留中のツールの `id`、`name`、`input` が含まれます。このフィールドを読み取って独自の UI でリクエストを表示し、同じ `session_id` で再開して続行してください。一連の流れについては [Defer a tool call for later](/docs/ja/hooks#defer-a-tool-call-for-later) を参照してください。1794`PreToolUse` フックが `permissionDecision: "defer"` を返した場合、結果には `stop_reason: "tool_deferred"` が含まれ、`deferred_tool_use` には保留中のツールの `id`、`name`、`input` が含まれます。このフィールドを読み取って独自の UI でリクエストを表示し、同じ `session_id` で再開して続行してください。一連の流れについては [Defer a tool call for later](/docs/ja/hooks#defer-a-tool-call-for-later) を参照してください。

1785 1795

1786<h4 id="user_message_uuid">1796<h4 id="user_message_uuid">

1787 `user_message_uuid`1797 `user_message_uuid`

1788</h4>1798</h4>

1789 1799

1790ターンが応答している [`SDKUserMessage`](#sdkusermessage) の `uuid` で、Claude Code の返信を送信したメッセージと照合できるようにエコーされます。Claude Code が `uuid` をエコーするのは、メッセージに `uuid` を設定した場合のみです。このフィールドは `SDKUserMessage` ではオプションであり、`query()` に渡される文字列プロンプトには含まれません。1800ターンが応答している [`SDKUserMessage`](#sdkusermessage) の `uuid` で、Claude Code の応答を送信したメッセージと対応付けられるようにエコーされます。Claude Code が `uuid` をエコーするのは、メッセージにそれを設定した場合のみです。このフィールドは `SDKUserMessage` ではオプションであり、`query()` に渡した文字列プロンプトには含まれません。

1791 1801

1792ターンがどのメッセージに応答するかは、ターンの開始方法によって異なります。1802ターンがどのメッセージに応答するかは、ターンの開始方法によって異なります。

1793 1803

1794* **送信した通常のメッセージ**（`isSynthetic: true` のないもの）: ターンは実行全体を通してそのメッセージに応答します。複数のメッセージを短い間隔で送信すると、Claude Code はそれらを 1 つのターンにマージすることがあり、その場合このフィールドには最後のメッセージの `uuid` のみが含まれます。マージされたいずれかのメッセージと返信を照合するには、[`user_message_uuids`](#user_message_uuids) を使用してください。1804* **送信した通常のメッセージ**（`isSynthetic: true` のないもの）: ターンは実行全体を通してそのメッセージに応答します。複数のメッセージを短い間隔で送信すると、Claude Code はそれらを 1 つのターンにマージすることがあり、その場合フィールドには最後のメッセージの `uuid` のみが含まれます。マージされたいずれかのメッセージに応答を対応付けるには、[`user_message_uuids`](#user_message_uuids) を使用してください。

1795* **`isSynthetic: true` 付きで送信したメッセージ**: ターンは最初はそのメッセージに応答します。Claude Code がツール呼び出しの合間に通常のメッセージを取り込んだ場合、それ以降ターンは取り込まれたメッセージに応答します。合成メッセージの `uuid` のエコーには Agent SDK v0.3.265 以降が必要です。それ以前のバージョンでは、合成ターンで何もエコーされません。1805* **`isSynthetic: true` を付けて送信したメッセージ**: ターンは最初はそのメッセージに応答します。Claude Code がツール呼び出しの合間に通常のメッセージを拾った場合、それ以降ターンは拾ったメッセージに応答します。合成メッセージの `uuid` をエコーするには Agent SDK v0.3.265 以降が必要です。以前のバージョンでは合成ターンで何もエコーされません。

1796* **[`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ja/env-vars) のもとで中断されたターンを再実行するために Claude Code が生成するプロンプト**: 中断されたターンの最後のプロンプトが送信した通常のメッセージである場合（それがターンを開始したものか、ターン中に Claude Code が取り込んだものかを問わず）、再実行は最初はそのメッセージに応答します。[`resume_reason`](#resume_reason) によって、再実行のフレームと中断された試行のフレームを区別できます。最後のプロンプトが通常のメッセージでない場合、再実行は最初はどのメッセージにも応答しません。Claude Code がツール呼び出しの合間に通常のメッセージを取り込んだ場合、それ以降ターンは取り込まれたメッセージに応答します。中断されたターンのプロンプトのエコーには Agent SDK v0.3.268 以降が必要です。1806* **[`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ja/env-vars) のもとで中断されたターンを再実行するために Claude Code が生成するプロンプト**: 中断されたターンの最後のプロンプトが送信した通常のメッセージである場合（それがターンを開始したものか、ターン中に Claude Code が拾ったものかを問わず）、再実行は最初はそのメッセージに応答します。[`resume_reason`](#resume_reason) によって、再実行のフレームと中断された試行のフレームを区別できます。最後のプロンプトが送信した通常のメッセージでない場合、再実行は最初は送信したどのメッセージにも応答しません。Claude Code がツール呼び出しの合間に通常のメッセージを拾った場合、それ以降ターンは拾ったメッセージに応答します。中断されたターンのプロンプトをエコーするには Agent SDK v0.3.268 以降が必要です。

1797* **Claude Code 自身が生成したその他のプロンプト**: ターンは最初はどのメッセージにも応答せず、そのフレームにはエコーが含まれません。Claude Code がツール呼び出しの合間に通常のメッセージを取り込んだ場合、それ以降ターンはそのメッセージに応答します。取り込み時のエコーには Agent SDK v0.3.265 以降が必要です。それ以前のバージョンでは、これらのターンで何もエコーされません。1807* **Claude Code 自身が生成したその他のプロンプト**: ターンは最初は送信したどのメッセージにも応答せず、そのフレームにはエコーが含まれません。Claude Code がツール呼び出しの合間に通常のメッセージを拾った場合、それ以降ターンはそのメッセージに応答します。拾った際のエコーには Agent SDK v0.3.265 以降が必要です。以前のバージョンではこれらのターンで何もエコーされません。

1798 1808

1799Claude Code は、応答したメッセージの `uuid` を 3 種類のフレームでエコーします。1809Claude Code は、応答したメッセージの `uuid` を 3 種類のフレームでエコーします。

1800 1810

1801* **結果**: 送信したメッセージに応答したターンのすべての結果です。Agent SDK v0.3.265 以降では、そのような結果のすべてにこれが含まれます。v0.3.265 より前は、通常のメッセージで開始されたターンの success 結果で、ターンが API リクエストを送信しなかった場合や遅延されたツール呼び出しで終了した場合に、これが含まれていませんでした。v0.3.246 より前はエラー結果にも含まれておらず、v0.3.216 より前はすべての結果に含まれていませんでした。1811* **結果**: 送信したメッセージに応答したターンのすべての結果。Agent SDK v0.3.265 以降では、そのようなすべての結果にこれが含まれます。v0.3.265 より前は、通常のメッセージで開始されたターンの success 結果で、ターンが API リクエストを送信しなかった場合や遅延されたツール呼び出しで終了した場合に、これが欠けていました。v0.3.246 より前はエラー結果にも欠けており、v0.3.216 より前はすべての結果に欠けていました。

1802* **ターンの最初の返信**: 最初の[アシスタントメッセージ](#sdkassistantmessage)と、`includePartialMessages` を使用している場合は `event.type` が `ping` でない最初の[ストリームイベント](#sdkpartialassistantmessage)です。これにより、結果が届く前に返信を関連付けることができます。最初の返信でのエコーには Agent SDK v0.3.246 以降が必要です。v0.3.269 より前は、`includePartialMessages` を使用している場合、Claude Code はその最初のストリームイベントにのみ、またはターンが何もストリーミングしなかった場合は最初のアシスタントメッセージに、これを設定していました。Agent SDK v0.3.265 以降では、ターンが応答しているメッセージがターンの途中で変わった場合、変更後の最初の返信にもこのフィールドが含まれます。それ以前のバージョンでは、ターンごとに 1 つの返信フレームに設定されていました。1812* **ターンの最初の応答**: 最初の[アシスタントメッセージ](#sdkassistantmessage)、および `includePartialMessages` を使用する場合は `event.type` が `ping` でない最初の[ストリームイベント](#sdkpartialassistantmessage)にも含まれるため、結果が届く前に応答を対応付けることができます。最初の応答でのエコーには Agent SDK v0.3.246 以降が必要です。v0.3.269 より前は、`includePartialMessages` を使用する場合、Claude Code はその最初のストリームイベントにのみ、またはターンが何もストリーミングしなかった場合は最初のアシスタントメッセージにこれを設定していました。Agent SDK v0.3.265 以降では、ターンが応答しているメッセージがターンの途中で変わった場合、変更後の最初の応答にもこのフィールドが含まれます。以前のバージョンでは、ターンごとに 1 つの応答フレームにのみ設定されていました。

1803* **ターンのすべての [`thinking_tokens`](#sdkthinkingtokensmessage) フレーム**: ターンの最初の返信を待たずに、思考の進行状況を送信したメッセージに関連付けることができます。Agent SDK v0.3.260 以降が必要です。1813* **ターンのすべての [`thinking_tokens`](#sdkthinkingtokensmessage) フレーム**: ターンの最初の応答を待たずに、思考の進行状況を送信したメッセージに関連付けることができます。Agent SDK v0.3.260 以降が必要です。

1804 1814

1805Claude Code は次の場合にこのフィールドを省略します。1815Claude Code は次の場合にこのフィールドを省略します。

1806 1816

1807* 上記の最初の返信以外の返信フレーム1817* 上記の最初の応答以外の応答フレーム

1808* サブエージェントのフレーム1818* サブエージェントのフレーム

1809* どのメッセージにも応答しないターン、または `uuid` なしで送信したメッセージに応答するターン1819* 送信したどのメッセージにも応答しないターン、または `uuid` なしで送信したメッセージに応答するターン

1810* クラッシュしたワーカープロセスの後のゼロになった結果など、送信したどのメッセージにも応答しない結果1820* クラッシュしたワーカープロセスの後のゼロになった結果など、送信したどのメッセージにも応答しない結果

1811 1821

1812<h4 id="user_message_uuids">1822<h4 id="user_message_uuids">

1813 `user_message_uuids`1823 `user_message_uuids`

1814</h4>1824</h4>

1815 1825

1816Claude Code がこのターンで応答した、送信したすべてのメッセージの `uuid` です。複数のメッセージを短い間隔で送信すると、Claude Code はそれらを 1 つのターンにマージすることがあり、その場合 `user_message_uuid` は最後のメッセージのみを示します。マージされたいずれかのメッセージと返信を照合するには、そのメッセージの `uuid` がこのリストのどこかにあるかを確認してください。Agent SDK v0.3.259 以降が必要です。1826このターンで Claude Code が応答した、送信済みのすべてのメッセージの `uuid`。複数のメッセージを短い間隔で送信すると、Claude Code はそれらを 1 つのターンにマージすることがあり、その場合 `user_message_uuid` はそのうち最後のものだけを示します。マージされたいずれかのメッセージに応答を対応付けるには、このリスト内でそのメッセージの `uuid` を探してください。Agent SDK v0.3.259 以降が必要です。

1817 1827

1818Claude Code は、`user_message_uuid` を含む各返信フレームと結果に、`user_message_uuid` と一緒にこのリストを設定します。応答したメッセージの `uuid` をエコーするターンフレームの全体と、それぞれに必要なバージョンについては、[`user_message_uuid`](#user_message_uuid) を参照してください。リストには常に `user_message_uuid` が含まれ、最大 64 エントリです。1828Claude Code は、`user_message_uuid` を持つ各応答フレームと結果に、このリストを `user_message_uuid` と一緒に設定します。応答したメッセージの `uuid` をエコーするターンフレームの全体と、それぞれに必要なバージョンについては、[`user_message_uuid`](#user_message_uuid) を参照してください。リストには常に `user_message_uuid` が含まれ、最大 64 エントリを保持します。

1819 1829

1820ターンの実行中に送信した通常のメッセージを Claude Code が取り込んだ場合、そのメッセージの `uuid` が結果のリストに追加されます。1830ターンの実行中に送信した通常のメッセージを Claude Code が拾った場合、そのメッセージの `uuid` が結果のリストに追加されます。

1821 1831

1822最初の返信または結果にリストなしで `user_message_uuid` が含まれている場合、それは以前の Claude Code バージョンからのものであるため、単一のフィールドにフォールバックしてください。1832最初の応答または結果に、リストなしで `user_message_uuid` が含まれている場合、それは以前の Claude Code バージョンからのものなので、単一のフィールドにフォールバックしてください。

1823 1833

1824<h4 id="resume_reason">1834<h4 id="resume_reason">

1825 `resume_reason`1835 `resume_reason`

1826</h4>1836</h4>

1827 1837

1828再起動後に Claude Code がこのターンを再実行した理由です。Claude Code は、[`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ja/env-vars) のもとで再実行したターンにこのフィールドを設定するため、再実行の返信と結果を中断された試行のものと区別できます。Agent SDK v0.3.268 以降が必要です。1838再起動後に Claude Code がこのターンを再実行した理由。Claude Code は、[`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ja/env-vars) のもとで再実行したターンにこのフィールドを設定するため、再実行の応答と結果を中断された試行のものと区別できます。Agent SDK v0.3.268 以降が必要です。

1829 1839

1830Claude Code はこのフィールドを 2 種類のフレームに設定します。1840Claude Code は 2 種類のフレームにこのフィールドを設定します。

1831 1841

1832* **再実行の結果**: success 側と error 側の両方で、結果に `user_message_uuid` が含まれるかどうかに関係なく設定されます。1842* **再実行の結果**: success アームとエラーアームの両方で、結果に `user_message_uuid` が含まれるかどうかにかかわらず設定されます。

1833* **再実行の返信フレーム**: [`user_message_uuid`](#user_message_uuid) を含むものです。1843* **再実行の応答フレーム**: [`user_message_uuid`](#user_message_uuid) を持つもの。

1834 1844

1835値は、`interrupted_turn` など、ターンが再実行された理由を示す短い小文字のトークンです。他のすべてのターンでは、このフィールドは存在しません。1845値は、ターンが再実行された理由を示す短い小文字のトークンで、`interrupted_turn` などです。その他のすべてのターンにはこのフィールドはありません。

1836 1846

1837<h4 id="queued_turn_count">1847<h4 id="queued_turn_count">

1838 `queued_turn_count`1848 `queued_turn_count`

1839</h4>1849</h4>

1840 1850

1841Claude Code が結果を生成した時点でコマンドキューにまだ待機中の、[`origin: { kind: "human" }`](#sdkmessageorigin) 付きで送信したメッセージの数です。Agent SDK v0.3.242 以降が必要です。1851Claude Code が結果を生成した時点でまだコマンドキューで待機中の、[`origin: { kind: "human" }`](#sdkmessageorigin) を付けて送信したメッセージの数。Agent SDK v0.3.242 以降が必要です。

1842 1852

1843`0` とフィールドがない場合の意味は次のとおりです。1853`0` とフィールドがない場合の意味は次のとおりです。

1844 1854

1845* **`0`**: Claude Code はその `origin` なしで送信したメッセージとタスク通知をカウントしないため、その後もターンが続く可能性があります。1855* **`0`**: Claude Code はその `origin` なしで送信したメッセージやタスク通知を数えないため、それでもターンが続く可能性があります。

1846* **存在しない**: クラッシュまたは致命的な起動エラーの後に Claude Code が出力する最終結果ではこのフィールドが省略され、[合計がゼロになっている可能性があります](/docs/ja/agent-sdk/cost-tracking#recover-totals-after-a-session-crash)。1856* **存在しない**: クラッシュまたは致命的な起動エラーの後に Claude Code が出力する最終結果ではこのフィールドが省略され、[合計がゼロになっている場合があります](/docs/ja/agent-sdk/cost-tracking#recover-totals-after-a-session-crash)。

1847 1857

1848<h4 id="startup_failure_reason">1858<h4 id="startup_failure_reason">

1849 `startup_failure_reason`1859 `startup_failure_reason`

1850</h4>1860</h4>

1851 1861

1852Claude Code が起動を拒否した理由で、アプリケーションが再試行ではなく修正方法を提示できるようにするためのものです。Claude Code は、既知の起動失敗で終了する前に書き込む `error_during_execution` 結果にこれを設定します。その結果の合計はゼロで、`errors` 配列には stderr と同じテキストが含まれます。他のすべての結果では、このフィールドは存在しません。Agent SDK v0.3.274 以降が必要です。1862Claude Code が起動を拒否した理由で、アプリケーションが再試行ではなく修正方法を提示できるようにするものです。Claude Code は、既知の起動失敗で終了する前に書き込む `error_during_execution` 結果にこれを設定します。その結果の合計はゼロで、`errors` 配列には stderr と同じテキストが含まれます。その他のすべての結果にはこのフィールドはありません。Agent SDK v0.3.274 以降が必要です。

1853 1863

1854すべての `SDKStartupFailureReason` 値についてこの結果を受け取るには、[`env`](#options) で `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` を `1` に設定します。この変数がない場合、Claude Code は次の失敗についてのみ結果を書き込み、それ以外は stderr 出力、ゼロ以外の終了コード、結果メッセージなしで終了します。1864すべての `SDKStartupFailureReason` 値についてこの結果を受け取るには、[`env`](#options) で `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` を `1` に設定してください。この変数がない場合、Claude Code は次の失敗についてのみ結果を書き込み、それ以外は stderr 出力と非ゼロの終了で終わり、結果メッセージは出力されません。

1855 1865

1856* [セッションを worktree に戻せない](/docs/ja/worktrees#the-session-resumes-outside-its-worktree)ために Claude Code が停止する再開で、`worktree_unverified` または `worktree_resume_refused` が設定されます。どのエラーにどの値が設定されるかは、そのセクションに記載されています。1866* [セッションを worktree に戻せない](/docs/ja/worktrees#the-session-resumes-outside-its-worktree)ために Claude Code が停止する再開（`worktree_unverified` または `worktree_resume_refused`）。どのエラーがどの値を持つかはそのセクションに記載されています。

1857* バックグラウンドセッションが保持している会話の [`continue`](#options) が拒否された場合で、`session_held_by_background` が設定されます。そのような会話の [`resume`](#options) が拒否された場合、Claude Code は変数が設定されているときにのみ結果を書き込みます。1867* バックグラウンドセッションが保持している会話の [`continue`](#options) が拒否された場合（`session_held_by_background`）。そのような会話の [`resume`](#options) が拒否された場合は、変数が設定されているときにのみ Claude Code は結果を書き込みます。

1858 1868

1859```typescript theme={null}1869```typescript theme={null}

1860type SDKStartupFailureReason =1870type SDKStartupFailureReason =

1879 1889

1880各値は 1 つの拒否理由を示します。1890各値は 1 つの拒否理由を示します。

1881 1891

1882| 値 | セッションを停止させた原因 |1892| 値 | セッションを停止させたもの |

1883| :- | :- |1893| :- | :- |

1884| `org_pin_api_key_conflict` | 管理設定で[ファーストパーティまたは Cloud ゲートウェイへのサインインが必須](/docs/ja/authentication#restrict-login-to-your-organization)とされているにもかかわらず、代わりに Anthropic API キー、認証トークン、または `apiKeyHelper` が設定されています |1894| `org_pin_api_key_conflict` | 管理設定が[ファーストパーティまたは Cloud ゲートウェイへのサインインを必須としている](/docs/ja/authentication#restrict-login-to-your-organization)のに、代わりに Anthropic API キー、認証トークン、または `apiKeyHelper` が設定されている |

1885| `provider_not_allowed` | 管理設定で[このマシンが使用できる API プロバイダーが列挙](/docs/ja/settings-reference#allowedproviders)されていますが、セッションがリストにないプロバイダー、または設定で固定されていないエンドポイント向けに構成されています。Claude Code v2.1.285 以降が必要です |1895| `provider_not_allowed` | 管理設定が[このマシンで使用できる API プロバイダーを列挙している](/docs/ja/settings-reference#allowedproviders)のに、セッションが列挙されていないプロバイダー、または設定で固定されていないエンドポイント向けに構成されている。Claude Code v2.1.285 以降が必要です |

1888| `managed_settings_invalid` | 管理ポリシー設定を読み取れなかったか、固定設定で組織が指定されていないか、[管理対象のモデル制限](/docs/ja/errors#managed-settings-block-the-default-model)により Default オプションで許可されるモデルがありません |1898| `managed_settings_invalid` | 管理ポリシー設定を読み取れなかった、固定設定で組織が指定されていない、または[管理モデル制限](/docs/ja/errors#managed-settings-block-the-default-model)により Default オプションに許可されたモデルが残っていない |

1891| `gateway_access_denied` | Cloud ゲートウェイへの管理設定リクエストが 403 を返しました。これについてはゲートウェイの[トラブルシューティング表](/docs/ja/claude-apps-gateway-deploy#troubleshooting)で説明しています |1901| `gateway_access_denied` | Cloud ゲートウェイへの管理設定リクエストが 403 を返した。ゲートウェイの[トラブルシューティング表](/docs/ja/claude-apps-gateway-deploy#troubleshooting)で扱われています |

1895| `shell_tool_missing` | Windows でシェルツールが利用できません。Git Bash がなく、PowerShell もないか `CLAUDE_CODE_USE_POWERSHELL_TOOL` でオフになっています |1905| `shell_tool_missing` | Windows で、利用可能なシェルツールがない。Git Bash がなく、PowerShell もないか `CLAUDE_CODE_USE_POWERSHELL_TOOL` でオフにされている |

1897| `worktree_resume_refused` | セッションの worktree が安全性チェックに失敗したか、再開が worktree の内部から起動されました。同じ再開をもう一度実行すると worktree なしで続行されるかどうかは `errors` に記載されます |1907| `worktree_resume_refused` | セッションの worktree が安全性チェックに失敗したか、再開がその内部から起動された。同じ再開をもう一度実行すると worktree なしで続行されるかどうかは `errors` に記載されます |

1901 1911

1902<h3 id="sdksystemmessage">1912<h3 id="sdksystemmessage">

1903 `SDKSystemMessage`1913 `SDKSystemMessage`

1942};1952};

1943```1953```

1944 1954

1945`fast_mode_state` は、セッションの [fast mode](/docs/ja/fast-mode) の状態を報告します。fast mode を妨げるものがある場合、`fast_mode_disabled_reason` がそれを妨げたチェックを示します。このフィールドには Claude Code v2.1.219 以降が必要です。理由コードとその意味については、結果メッセージの [`fast_mode_disabled_reason`](#sdkresultmessage) を参照してください。1955`fast_mode_state` はセッションの [fast mode](/docs/ja/fast-mode) の状態を報告します。fast mode を妨げるものがある場合、`fast_mode_disabled_reason` がそれを妨げたチェックを示します。このフィールドには Claude Code v2.1.219 以降が必要です。理由コードとその意味については、結果メッセージの [`fast_mode_disabled_reason`](#sdkresultmessage) を参照してください。

1946 1956

1947`terminal_slash_commands` は、`slash_commands` のエントリのうち、`exit` のようにインターフェースがローカルのターミナルに結び付いているものを示します。これらは `slash_commands` の他のエントリと同様に送信できます。このフィールドは、リモートクライアントやモバイルクライアントがコマンドメニューからこれらを非表示にできるようにするためのものです。このフィールドは空でない場合にのみ存在し、Agent SDK v0.3.229 以降が必要です。1957`terminal_slash_commands` は、`slash_commands` のエントリのうち、`exit` など、インターフェースがローカルターミナルに結び付いているものを示します。これらは `slash_commands` の他のエントリと同様に送信できます。このフィールドは、リモートクライアントやモバイルクライアントがコマンドメニューからそれらを非表示にできるようにするために存在します。このフィールドは空でない場合にのみ存在し、Agent SDK v0.3.229 以降が必要です。

1948 1958

1949* 各 `mcp_servers` エントリの `source`: サーバーの定義の取得元で、[`McpServerStatus`](#mcpserverstatus) の `source` と同じ値を取ります。Agent SDK v0.3.274 以降が必要です。1959* 各 `mcp_servers` エントリの `source`: サーバーの定義の取得元で、[`McpServerStatus`](#mcpserverstatus) の `source` と同じ値を取ります。Agent SDK v0.3.274 以降が必要です。

1950* `effort`: Claude Code がセッションの次のリクエストで送信する [effort レベル](/docs/ja/model-config#adjust-effort-level)で、何も送信しない場合は `null` です。Claude Code はこのフィールドを [Remote Control](/docs/ja/remote-control) クライアントに送信する init メッセージにのみ設定し、アプリケーションが読み取る init メッセージからは省略します。Agent SDK v0.3.234 以降が必要です。1960* `effort`: Claude Code がセッションの次のリクエストで送信する [effort レベル](/docs/ja/model-config#adjust-effort-level)、または送信しない場合は `null`。Claude Code はこのフィールドを [Remote Control](/docs/ja/remote-control) クライアントに送信する init メッセージにのみ設定し、アプリケーションが読み取る init メッセージからは省略します。Agent SDK v0.3.234 以降が必要です。

1951 1961

1952`capabilities` 配列は、この CLI が実装しているプロトコルの動作を示します。これにより、`claude_code_version` の文字列を比較する代わりに機能検出を行えます。これは開いた集合です。認識できない値は無視し、依存している動作に対応する特定の capability があるかを確認してください。このフィールドには Claude Code v2.1.205 以降が必要で、それ以前の CLI には存在しません。1962`capabilities` 配列は、この CLI が実装しているプロトコルの動作を示すため、`claude_code_version` の文字列を比較する代わりに機能検出を行えます。これはオープンな集合です。認識できない値は無視し、依存する動作に対応する特定の capability があるかを確認してください。このフィールドには Claude Code v2.1.205 以降が必要で、それより前の CLI には存在しません。

1953 1963

1954| Capability | 意味 |1964| Capability | 意味 |

1955| - | - |1965| - | - |

1956| `interrupt_receipt_v1` | [`interrupt()`](#query-object) が、割り込みの到着時に保留中だったメッセージを列挙する [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) レシートで解決されます |1966| `interrupt_receipt_v1` | [`interrupt()`](#query-object) が、中断が届いた時点で保留中だったメッセージを列挙する [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) の受領書で解決される |

1957| `interrupt_cancel_queued_v1` | `interrupt` 制御リクエストが `cancel_queued: true` を受け付け、レシートで本来 `still_queued` に列挙されるメッセージをキャンセルし、代わりに `cancelled` に列挙します。[`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) を参照してください。Claude Code v2.1.219 以降が必要です |1967| `interrupt_cancel_queued_v1` | `interrupt` コントロールリクエストが `cancel_queued: true` に従い、受領書で本来 `still_queued` に列挙されるメッセージをキャンセルして、代わりに `cancelled` に列挙する。[`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) を参照してください。Claude Code v2.1.219 以降が必要です |

1968| `sdk_mcp_manifests` | `initialize` コントロールリクエストが、インプロセスの [SDK MCP サーバー](/docs/ja/agent-sdk/custom-tools)から取得した MCP ハンドシェイク結果である `sdkMcpServerManifests` を受け付ける。Claude Code は v2.1.286 以降でこの capability を通知します |

1969| `sdk_mcp_tools_list_changed` | [SDK MCP サーバー](/docs/ja/agent-sdk/custom-tools)からの `tools/list_changed` 通知により、Claude Code がそのサーバーのツールを再度一覧取得するため、サーバーがセッション途中で追加したツールが Claude に届く。Claude Code は v2.1.286 以降でこの capability を通知します |

1958 1970

1959`plugin_errors` 配列は、プラグインの読み込み失敗を列挙します。各エントリは、読み込まれずに `plugins` に含まれないプラグイン、またはフックファイルなど一部の構成要素を欠いたまま読み込まれたプラグインのいずれかを表します。何も失敗しなかった場合、このキーは省略されます。`SDKSystemMessage` は Agent SDK v0.3.283 以降で `plugin_errors` を宣言します。1971`plugin_errors` 配列は、プラグインの読み込み失敗を列挙します。エントリは、読み込まれず `plugins` に含まれていないプラグイン、またはフックファイルなどの一部が欠けた状態で読み込まれたプラグインのいずれかを表します。何も失敗しなかった場合、このキーは省略されます。`SDKSystemMessage` は Agent SDK v0.3.283 以降で `plugin_errors` を宣言しています。

1960 1972

1961[`plugins` オプション](#options)で指定したディレクトリまたはアーカイブ自体の読み込みに失敗した場合、エントリの `plugin` フィールドにはプラグイン名の代わりに `inline[0]` のような位置タグが入ります。これは、たとえばパスが存在しない場合やマニフェストが無効な場合に発生します。そのようなエントリは、`path` フィールドでオプションと照合してください。1973[`plugins` オプション](#options)で指定したディレクトリまたはアーカイブ自体の読み込みに失敗した場合、エントリの `plugin` フィールドにはプラグイン名の代わりに `inline[0]` などの位置を示すタグが入ります。これは、たとえばパスが存在しない場合やマニフェストが無効な場合に発生します。そのようなエントリは、`path` フィールドを使ってオプションと対応付けてください。

1962 1974

1963次の表は、各 `plugin_errors` エントリのフィールドを示しています。1975次の表は、各 `plugin_errors` エントリのフィールドを示しています。

1964 1976

1965| フィールド | 型 | 説明 |1977| フィールド | 型 | 説明 |

1966| - | - | - |1978| - | - | - |

1971 1983

1973 `SDKPartialAssistantMessage`1985 `SDKPartialAssistantMessage`

1974</h3>1986</h3>

1975 1987

1976ストリーミングの部分メッセージです（`includePartialMessages` が true の場合のみ）。`parent_tool_use_id` フィールドは常に `null` です。ストリームイベントはメインセッションに対してのみ出力されます。サブエージェントへの帰属を判定するには、`parent_tool_use_id` を含む完全なメッセージを使用するか、[`forwardSubagentText`](#options) を有効にしてサブエージェントのテキストと思考を完全なメッセージとして受け取ってください。1988ストリーミングの部分メッセージです（`includePartialMessages` が true の場合のみ）。`parent_tool_use_id` フィールドは常に `null` です。ストリームイベントはメインセッションに対してのみ出力されます。サブエージェントへの帰属を判定するには、`parent_tool_use_id` を持つ完全なメッセージを使用するか、[`forwardSubagentText`](#options) を有効にしてサブエージェントのテキストと思考を完全なメッセージとして受け取ってください。

1977 1989

1978```typescript theme={null}1990```typescript theme={null}

1979type SDKPartialAssistantMessage = {1991type SDKPartialAssistantMessage = {

1989};2001};

1990```2002```

1991 2003

1992Claude Code は、[`user_message_uuid`](#user_message_uuid) に記載の条件のもとで、ターンの ping 以外の最初のストリームイベントと、ターンが応答しているメッセージが変わったときに、`user_message_uuid` と `user_message_uuids` を設定します。再起動によって中断されたターンを Claude Code が再実行する場合、これらのフィールドを持つ再実行時のストリームイベントには [`resume_reason`](#resume_reason) も付与されます。2004Claude Code は、[`user_message_uuid`](#user_message_uuid) に記載された条件のもとで、ターンの最初の ping 以外のストリームイベントに、およびターンが応答しているメッセージが変わったときに再度、`user_message_uuid` と `user_message_uuids` を設定します。再起動によって中断されたターンを Claude Code が再実行する場合、再実行でこれらのフィールドを持つストリームイベントには [`resume_reason`](#resume_reason) も含まれます。

1993 2005

1994<h3 id="sdkcompactboundarymessage">2006<h3 id="sdkcompactboundarymessage">

1995 `SDKCompactBoundaryMessage`2007 `SDKCompactBoundaryMessage`

2014 `SDKInformationalMessage`2026 `SDKInformationalMessage`

2015</h3>2027</h3>

2016 2028

2017ループが出力する汎用のテキストバナーです。Claude Code が発行する警告、通知、その他のエラー以外のステータス行と、`UserPromptSubmit` フックのブロック理由などのフックのフィードバックを伝えます。2029ループが出力する汎用のテキストバナーです。Claude Code が発する警告、通知、その他のエラー以外のステータス行、および `UserPromptSubmit` フックのブロック理由などのフックのフィードバックを伝えます。

2018 2030

2019Claude Code v2.1.227 以降では、フックの [`systemMessage`](/docs/ja/hooks#json-output) がこのメッセージとして届くことがあり、各行の先頭に `PostToolUse:Bash says:` のようにフックの名前が付きます。出力がどのように表示されるかは、フックのページの各[イベントのセクション](/docs/ja/hooks#hook-events)に記載されています。2031Claude Code v2.1.227 以降では、フックの [`systemMessage`](/docs/ja/hooks#json-output) がこのメッセージとして届くことがあり、各行には `PostToolUse:Bash says:` のようにフックの名前が前置されます。出力がどのように表示されるかは、フックのページの各[イベントのセクション](/docs/ja/hooks#hook-events)に記載されています。

2020 2032

2021`content` は、指定された `level` でプレーンテキストとして描画してください。2033`content` は、指定された `level` でプレーンテキストとして表示してください。

2022 2034

2023```typescript theme={null}2035```typescript theme={null}

2024type SDKInformationalMessage = {2036type SDKInformationalMessage = {

2037 `SDKWorkerShuttingDownMessage`2049 `SDKWorkerShuttingDownMessage`

2038</h3>2050</h3>

2039 2051

2040ワーカーの正常な終了処理時に出力され、リモートクライアントがハートビートのタイムアウトを待たずにワーカーが終了した理由を表示できるようにします。`reason` はホスト CLI が設定する短い snake\_case の文字列で、`"host_exit"` や `"remote_control_disabled"` などです。これに対応するのはライブでストリーミングしている場合のみにしてください。再開されたセッションでは過去のこのメッセージが再生されるため、その場合は無視してください。2052ワーカーの正常な終了処理時に出力され、リモートクライアントがハートビートのタイムアウトを待たずにワーカーが終了した理由を表示できるようにします。`reason` はホスト CLI が設定する短い snake\_case の文字列で、`"host_exit"` や `"remote_control_disabled"` などです。ライブでストリーミングしている場合にのみこれに対応してください。再開されたセッションではこのメッセージの過去のインスタンスが再生されるため、その場合は無視してください。

2041 2053

2042```typescript theme={null}2054```typescript theme={null}

2043type SDKWorkerShuttingDownMessage = {2055type SDKWorkerShuttingDownMessage = {

2053 `SDKPluginInstallMessage`2065 `SDKPluginInstallMessage`

2054</h3>2066</h3>

2055 2067

2056プラグインのインストールの進行状況イベントです。[`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/ja/env-vars) が設定されている場合に出力され、Agent SDK アプリケーションが最初のターンの前にマーケットプレイスのプラグインのインストールを追跡できるようにします。`started` と `completed` のステータスはインストール全体の開始と終了を示します。`installed` と `failed` のステータスは個々のマーケットプレイスについて報告し、`name` を含みます。2068プラグインのインストール進行状況イベントです。[`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/ja/env-vars) が設定されている場合に出力され、Agent SDK アプリケーションが最初のターンの前にマーケットプレイスのプラグインのインストールを追跡できるようにします。`started` と `completed` のステータスはインストール全体の開始と終了を示します。`installed` と `failed` のステータスは個々のマーケットプレイスについて報告し、`name` を含みます。

2057 2069

2058```typescript theme={null}2070```typescript theme={null}

2059type SDKPluginInstallMessage = {2071type SDKPluginInstallMessage = {

2071 `SDKPermissionDeniedMessage`2083 `SDKPermissionDeniedMessage`

2072</h3>2084</h3>

2073 2085

2074権限システムが対話的なプロンプトなしでツール呼び出しを拒否したときに出力されるストリームイベントです。その後に続く `is_error` のツール結果を観察するだけでなく、拒否が発生した時点で UI に表示するために使用します。どの拒否を報告するかは、実行が権限プロンプトをどのように処理するかによって異なります。2086権限システムが対話的なプロンプトなしでツール呼び出しを拒否したときに出力されるストリームイベントです。後に続く `is_error` のツール結果を観測するだけでなく、拒否が発生した時点で UI に表示するために使用します。どの拒否が報告されるかは、実行が権限プロンプトをどのように扱うかによって異なります。

2075 2087

2076* **[`canUseTool`](#canusetool) コールバックがあり**、デフォルトの [`permissionPrompts: 'host'`](#options) の場合: 権限プロンプトはコールバックに送られ、このイベントは Claude Code がコールバックを呼び出さずに自ら判断した拒否を報告します。2088* **[`canUseTool`](#canusetool) コールバックとデフォルトの [`permissionPrompts: 'host'`](#options) を使用する場合**: 権限プロンプトはコールバックに送られ、このイベントは Claude Code がコールバックを呼び出さずに独自に決定した拒否を報告します。

2077* **どちらもない場合**: 素の `-p` 実行、または `canUseTool` も `permissionPromptToolName` も設定しない `query()` では、[`PermissionRequest` フック](/docs/ja/hooks-guide#limitations)が許可しない限り、プロンプトが表示されるはずだったツール呼び出しはすべて拒否されます。このイベントは、それらの拒否に加えて Claude Code が自ら判断した拒否も報告します。v2.1.223 より前は、コールバックのない実行では Claude Code はこのイベントを出力しませんでした。2089* **どちらも使用しない場合**: 素の `-p` 実行、または `canUseTool` も `permissionPromptToolName` も設定しない `query()` では、[`PermissionRequest` フック](/docs/ja/hooks-guide#limitations)が許可しない限り、プロンプトを表示するはずだったツール呼び出しは拒否され、このイベントはそれらの拒否と、Claude Code が独自に決定した拒否を報告します。v2.1.223 より前は、コールバックのない実行では Claude Code はこのイベントを出力しませんでした。

2078* **`permissionPromptToolName` または [`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) フラグで設定した MCP プロンプトツールがあり**、デフォルトの `permissionPrompts: 'host'` の場合: Claude Code はこのイベントをまったく出力しません。自ら判断したルールによる拒否についても同様です。2090* **`permissionPromptToolName` または [`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) フラグで設定した MCP プロンプトツールと、デフォルトの `permissionPrompts: 'host'` を使用する場合**: Claude Code はこのイベントをまったく出力せず、独自に決定したルールによる拒否についても出力しません。

2079* **[`permissionPrompts: 'none'`](#options) の場合**: `canUseTool` または MCP プロンプトツールも設定されていても、Claude Code はプロンプトが表示されるはずだった呼び出しを拒否し、このイベントはそれらの拒否に加えて Claude Code が自ら判断した拒否も報告します。Claude Code v2.1.259 以降が必要です。2091* **[`permissionPrompts: 'none'`](#options) を使用する場合**: `canUseTool` や MCP プロンプトツールも設定されている場合でも、Claude Code はプロンプトを表示するはずだった呼び出しを拒否し、このイベントはそれらの拒否と、Claude Code が独自に決定した拒否を報告します。Claude Code v2.1.259 以降が必要です。

2080 2092

2081どの構成でも、このイベントは `PreToolUse` フックの経路で判断された拒否をスキップします。フック自体が呼び出しを拒否した場合も、拒否ルールがフックの allow または ask の判断を上書きした場合も同様です。また、このイベントはベストエフォートです。Claude Code がこのイベントを出力せずに拒否を記録することがまれにあるため、[結果メッセージ](#sdkresultmessage)の `permission_denials` が正式な記録です。2093どの構成でも、このイベントは `PreToolUse` フックのパスで決定された拒否をスキップします。これは、フック自身が呼び出しを拒否した場合も、拒否ルールがフックの allow または ask の決定を上書きした場合も同様です。また、このイベントはベストエフォートです。Claude Code がこのイベントを出力せずに拒否を記録することがまれにあるため、[結果メッセージ](#sdkresultmessage)の `permission_denials` が正式な記録となります。

2082 2094

2083```typescript theme={null}2095```typescript theme={null}

2084type SDKPermissionDeniedMessage = {2096type SDKPermissionDeniedMessage = {

2099| - | - | - |2111| - | - | - |

2106 2118

2107<h3 id="sdkpermissiondenial">2119<h3 id="sdkpermissiondenial">

2122 `SDKContextUsage`2134 `SDKContextUsage`

2123</h3>2135</h3>

2124 2136

2125`/context` レポートの構造化された形式で、`/context` の結果を配信する [`SDKAssistantMessage`](#sdkassistantmessage) に `context_usage` として含まれます。Agent SDK v0.3.232 以降でこの型がエクスポートされます。[`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) とは異なり、使用状況の内訳を描画するのに必要なデータのみを含み、`color` や `gridRows` などの表示用フィールドは含みません。Claude Code は、メッセージストリームに表示されないトークンカウントの API リクエストを使ってレポートを計算します。[これらのリクエストの扱い](#sdkcontrolgetcontextusageresponse)を参照してください。2137`/context` レポートの構造化された形式で、`/context` の結果を届ける [`SDKAssistantMessage`](#sdkassistantmessage) に `context_usage` として含まれます。Agent SDK v0.3.232 以降がこの型をエクスポートします。[`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) とは異なり、使用量の内訳を表示するために必要なデータのみを含み、`color` や `gridRows` などの表示用フィールドは含みません。Claude Code は、メッセージストリームに現れないトークンカウントの API リクエストを使ってレポートを算出します。[これらのリクエストの扱い](#sdkcontrolgetcontextusageresponse)を参照してください。

2126 2138

2127```typescript theme={null}2139```typescript theme={null}

2128type SDKContextUsage = {2140type SDKContextUsage = {

2159};2171};

2160```2172```

2161 2173

2162次の表は、Claude Code が各フィールドに設定する内容を示しています。`model` から `over_limit` までのフィールドはセッション全体を表し、コレクションのフィールドはトークンを個々の項目に割り当てます。2174次の表は、Claude Code が各フィールドに設定する内容を示しています。`model` から `over_limit` までのフィールドはセッション全体を表し、コレクションフィールドは個々の項目にトークンを割り当てます。

2163 2175

2164| フィールド | 型 | 説明 |2176| フィールド | 型 | 説明 |

2165| - | - | - |2177| - | - | - |

2168| `raw_max_tokens` | `number` | モデルのコンテキストウィンドウ、またはより小さい[自動圧縮ウィンドウ](/docs/ja/model-config#context-window-and-auto-compaction)が適用される場合はそのウィンドウ。後者には、ユーザーが設定したものや、1M トークンのウィンドウを持つ一部のモデルに Claude Code が適用する 200K の境界などがあります。Claude Code は `total_tokens` をこのウィンドウに対して測定します |2180| `raw_max_tokens` | `number` | モデルのコンテキストウィンドウ、または適用される場合はそれより小さい[自動圧縮ウィンドウ](/docs/ja/model-config#context-window-and-auto-compaction)。後者には、自分で設定したものや、1M トークンのウィンドウを持つ一部のモデルに Claude Code が適用する 200K の境界などがあります。Claude Code は `total_tokens` をこのウィンドウに対して測定します |

2176 2188

2177`over_limit.kind` は、API が次のリクエストを受け付けるかどうかではなく、Claude Code がウィンドウをどのように決定したかを記録します。2189`over_limit.kind` は、API が次のリクエストを受け付けるかどうかではなく、Claude Code がウィンドウをどのように決定したかを記録します。

2178 2190

2179* `hard_limit`: ウィンドウは、Claude Code がモデル自体の上限と認識しているもので、それを超えると API はリクエストを拒否します2191* `hard_limit`: ウィンドウは、Claude Code がモデル自体の上限だと考えているもので、それを超えると API がリクエストを拒否します

2180* `compaction_window`: ウィンドウはコンテキスト圧縮ポリシーのウィンドウで、モデルの上限と一致する場合も一致しない場合もあります2192* `compaction_window`: ウィンドウはコンテキスト圧縮ポリシーのウィンドウで、モデルの上限と一致する場合もしない場合もあります

2181 2193

2182Claude Code はこの型を追加的に進化させ、既存のフィールドの形を変えるのではなく、新しいデータをオプションのフィールドとして追加します。既知のフィールドを読み取り、認識できないフィールドは無視してください。2194Claude Code はこの型を追加的に拡張し、既存のフィールドの形を変えるのではなく、新しいデータをオプションのフィールドとして追加します。知っているフィールドを読み取り、認識できないフィールドは無視してください。

2183 2195

2184<h3 id="sdkcontextusagecategory">2196<h3 id="sdkcontextusagecategory">

2185 `SDKContextUsageCategory`2197 `SDKContextUsageCategory`

2186</h3>2198</h3>

2187 2199

2188`/context` のカテゴリ別使用状況の内訳の 1 行です。2200`/context` のカテゴリ別使用量の内訳の 1 行です。

2189 2201

2190```typescript theme={null}2202```typescript theme={null}

2191type SDKContextUsageCategory = {2203type SDKContextUsageCategory = {

2199 2211

2200| フィールド | 型 | 説明 |2212| フィールド | 型 | 説明 |

2201| - | - | - |2213| - | - | - |

2205 2217

2206各 `kind` 値は、行のトークンが何であるかを示します。2218各 `kind` の値は、その行のトークンが何であるかを示します。

2207 2219

2208* `used`: コンテキストウィンドウを占有するコンテンツ2220* `used`: コンテキストウィンドウを占有しているコンテンツ

2209* `free`: ウィンドウの残り2221* `free`: ウィンドウの残り

2210* `buffer`: コンテキスト圧縮のための予約領域2222* `buffer`: コンテキスト圧縮用の予約領域

2211* `deferred`: Claude Code がウィンドウの外に保持し、使用量の計算から除外しているツールスキーマ。参考として列挙されます2223* `deferred`: Claude Code がウィンドウの外に保持し、使用量の計算から除外しているツールスキーマ。参考のために列挙されます

2212 2224

2213<h3 id="sdkmessageorigin">2225<h3 id="sdkmessageorigin">

2214 `SDKMessageOrigin`2226 `SDKMessageOrigin`

2215</h3>2227</h3>

2216 2228

2217ユーザーロールのメッセージの由来です。これは [`SDKUserMessage`](#sdkusermessage) に `origin` として含まれ、対応する [`SDKResultMessage`](#sdkresultmessage) に引き継がれるため、特定のターンが何によってトリガーされたかを判別できます。2229ユーザーロールのメッセージの出所です。[`SDKUserMessage`](#sdkusermessage) に `origin` として含まれ、対応する [`SDKResultMessage`](#sdkresultmessage) に転送されるため、特定のターンが何によってトリガーされたかを判別できます。

2218 2230

2219```typescript theme={null}2231```typescript theme={null}

2220type SDKMessageOrigin =2232type SDKMessageOrigin =

2242 2254

2243| `kind` | 意味 |2255| `kind` | 意味 |

2244| - | - |2256| - | - |

2245| `human` | エンドユーザーからの直接入力。アプリケーションがユーザーの入力内容をユーザーメッセージとして転送する場合は、その `origin` を明示的に `{ kind: "human" }` に設定してください。Claude Code は `origin` のないユーザーメッセージを帰属不明として扱い、[`ultracode` ワークフローキーワード](/docs/ja/workflows#ask-for-a-workflow-in-your-prompt)など、人間が入力したプロンプトを必要とするチェックはそれを受け付けません。v2.1.210 より前は、Claude Code はユーザーメッセージに `origin` がない場合に人間の入力として扱っていました。 |2257| `human` | エンドユーザーからの直接入力。アプリケーションがユーザーの入力をユーザーメッセージとして転送する場合は、その `origin` を明示的に `{ kind: "human" }` に設定してください。Claude Code は `origin` のないユーザーメッセージを出所不明として扱い、[`ultracode` ワークフローキーワード](/docs/ja/workflows#ask-for-a-workflow-in-your-prompt)など、人間が入力したプロンプトを必要とするチェックはそれを受け付けません。v2.1.210 より前は、Claude Code はユーザーメッセージに `origin` がない場合を人間の入力として扱っていました。 |

2247| `peer` | 別のエージェントからのメッセージ。インプロセスの[チームメイト](/docs/ja/agent-teams)、または[クロスセッションのピア](/docs/ja/cross-session-messaging)（別の Claude Code セッション）です。フィールドごとのセマンティクスと信頼モデルについては [Peer origin のフィールド](#peer-origin-fields)を参照してください。 |2259| `peer` | 別のエージェントからのメッセージ。インプロセスの[チームメイト](/docs/ja/agent-teams)、または別の Claude Code セッションである[セッション間ピア](/docs/ja/cross-session-messaging)です。フィールドごとの意味と信頼モデルについては [Peer origin fields](#peer-origin-fields) を参照してください。 |

2248| `task-notification` | 完了したバックグラウンドタスクなど、新しいユーザープロンプトなしで届く配信のために挿入される合成ターン。その側については [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) を参照してください。アプリケーションが[スケジュール実行として宣言](#declare-a-scheduled-run)したプロンプトもこの kind を持ちます。オプションの `subkind` は、通知を発生させたものを示します。[Task-notification のサブ種別](#task-notification-subkinds)を参照してください。 |2260| `task-notification` | 完了したバックグラウンドタスクなど、新しいユーザープロンプトなしで届く配信のために注入された合成ターン。そのアームについては [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) を参照してください。アプリケーションが[スケジュール実行として宣言した](#declare-a-scheduled-run)プロンプトもこの kind を持ちます。オプションの `subkind` は、通知を発生させたものを示します。[Task-notification subkinds](#task-notification-subkinds) を参照してください。 |

2251| `unclassified` | 由来を特定できなかった挿入ターン。Claude Code v2.1.223 以降が必要です。Claude Code が `isSynthetic: true` 付きの [`SDKUserMessage`](#sdkusermessage) を受け取り、他のどの `kind` にも分類できない場合、メッセージの到着時にこの kind を設定し、人間の入力として扱うのではなく、ユーザー以外のソースとしてモデルにターンを提示します。アプリケーションはこの値を設定しないでください。 |2263| `unclassified` | 出所を判定できなかった注入ターン。Claude Code v2.1.223 以降が必要です。Claude Code が `isSynthetic: true` を持つ [`SDKUserMessage`](#sdkusermessage) を受け取り、それを他のどの `kind` にも分類できない場合、メッセージの到着時にこの kind を設定し、人間の入力として扱うのではなく、ユーザー以外のソースとしてターンをモデルに提示します。アプリケーションはこの値を設定しないでください。 |

2252 2264

2253<h3 id="task-notification-subkinds">2265<h3 id="task-notification-subkinds">

2254 Task-notification のサブ種別2266 タスク通知のサブ種別

2255</h3>2267</h3>

2256 2268

2257Claude Code がセッションにタスク通知を配信するとき、Anthropic のサーバーがその通知の送信元を検証済みであれば、通知の `origin` に `subkind` を設定します。また、アプリケーション自身がメッセージを[スケジュール実行として宣言](#declare-a-scheduled-run)した場合にも `subkind` を設定します。これには TypeScript Agent SDK v0.3.280 以降が必要です。`subkind` には Claude Code v2.1.213 以降が必要で、次の 2 つのいずれかの値を取ります。2269Claude Code がタスク通知をセッションに配信する際、Anthropic のサーバーがその通知の出所を検証した場合は、通知の `origin` に `subkind` を設定します。アプリケーション自身がメッセージを[スケジュール実行として宣言した](#declare-a-scheduled-run)場合にも `subkind` を設定し、これには TypeScript Agent SDK v0.3.280 以降が必要です。`subkind` には Claude Code v2.1.213 以降が必要で、次の 2 つの値のいずれかを取ります。

2258 2270

2259* `scheduled-trigger`: 通知は[ルーティン](/docs/ja/routines)の保存されたプロンプトで、ルーティンのトリガー（スケジュール、[API トリガー](/docs/ja/routines#add-an-api-trigger)、[GitHub トリガー](/docs/ja/routines#add-a-github-trigger)、または **Run now**）のいずれかが発火したために配信されたものです。アプリケーションが[スケジュール実行として宣言](#declare-a-scheduled-run)したプロンプトもこの値を持ちます。Claude Code はこれらをセッションに割り当てられたタスクとしてモデルに提示し、[他のタスク通知に付く通知文](#sdktasknotificationmessage)とは異なる通知文を付けます。2271* `scheduled-trigger`: 通知は[ルーティン](/docs/ja/routines)に保存されたプロンプトで、ルーティンのトリガー（スケジュール、[API トリガー](/docs/ja/routines#add-an-api-trigger)、[GitHub トリガー](/docs/ja/routines#add-a-github-trigger)、または **Run now**）のいずれかが発火したために配信されたものです。アプリケーションが[スケジュール実行として宣言した](#declare-a-scheduled-run)プロンプトもこの値を持ちます。Claude Code はこれらをセッションに割り当てられたタスクとしてモデルに提示し、[他のタスク通知に付く注記](#sdktasknotificationmessage)とは異なる注記を付けます。

2260* `peer-send-message`: 通知は、別のセッションが、[クラウドセッション](/docs/ja/claude-code-on-the-web)同士がメッセージをやり取りするために使用するサーバー側の `send_message` ツールで送信したメッセージです（[クロスセッションの `SendMessage` ツール](/docs/ja/cross-session-messaging)ではありません）。また、Anthropic のサーバーが両方のセッションが同じプライベートなセッショングループに属していることを検証済みです。Claude Code v2.1.224 以降が必要です。サーバーがそのように検証しなかった `send_message` の配信には、サブ種別は付きません。2272* `peer-send-message`: 通知は、[クラウドセッション](/docs/ja/claude-code-on-the-web)同士がメッセージをやり取りするために使用するサーバー側の `send_message` ツールで、別のセッションから送信されたメッセージです（[セッション間の `SendMessage` ツール](/docs/ja/cross-session-messaging)ではありません）。Anthropic のサーバーが、両方のセッションが同じプライベートなセッショングループに属していることを検証しています。Claude Code v2.1.224 以降が必要です。サーバーがこの方法で検証しなかった `send_message` の配信には subkind は付きません。

2261 2273

2262その他のタスク通知には `subkind` はありません。これには、セッションに配信される [PR アクティビティ](/docs/ja/claude-code-on-the-web#how-claude-responds-to-pr-activity)や、完了したタスクなどのバックグラウンドイベントが含まれます。[クロスセッションの `SendMessage` ツール](/docs/ja/cross-session-messaging)からのメッセージはタスク通知ではありません。同じマシン上のセッションから来たものでも、別のマシンから Anthropic のサーバーを経由して来たものでも、Claude Code はそれらに `kind: "peer"` と [peer origin のフィールド](#peer-origin-fields)を付与します。2274その他のすべてのタスク通知には `subkind` はありません。これには、セッションに配信される [PR アクティビティ](/docs/ja/claude-code-on-the-web#how-claude-responds-to-pr-activity)や、完了したタスクなどのバックグラウンドイベントが含まれます。[セッション間の `SendMessage` ツール](/docs/ja/cross-session-messaging)からのメッセージはそもそもタスク通知ではありません。同じマシン上のセッションからのものでも、別のマシンから Anthropic のサーバーを経由したものでも、Claude Code はそれらに `kind: "peer"` と[ピアの origin フィールド](#peer-origin-fields)を付与します。

2263 2275

2264`fireReason` は、`scheduled-trigger` の通知が発火した理由を、`scheduled`、`manual`、`retry`、`catch_up`、`api` などの短い小文字のトークンで示します。Anthropic のサーバーは[ルーティン](/docs/ja/routines)の配信にこれを設定し、アプリケーションはスケジュール実行を宣言するときにこれを設定します。どちらも送信しなかった場合は存在しません。TypeScript Agent SDK v0.3.280 以降が必要です。2276`fireReason` は、`scheduled-trigger` 通知が発火した理由を、`scheduled`、`manual`、`retry`、`catch_up`、`api` などの短い小文字のトークンで示します。Anthropic のサーバーは[ルーティン](/docs/ja/routines)の配信にこれを設定し、アプリケーションはスケジュール実行を宣言する際にこれを設定します。どちらも送信しなかった場合は存在しません。TypeScript Agent SDK v0.3.280 以降が必要です。

2265 2277

2266<h4 id="declare-a-scheduled-run">2278<h4 id="declare-a-scheduled-run">

2267 スケジュール実行を宣言する2279 スケジュール実行を宣言する

2268</h4>2280</h4>

2269 2281

2270アプリケーションが独自のスケジュールでプロンプトを実行する場合は、各実行を宣言してください。これにより、Claude Code はそのターンをユーザーからのライブ入力としてではなく、スケジュールタスクとしてモデルに提示します。[`env`](#options) で `CLAUDE_CODE_HOST_SCHEDULED_RUN` を `1` に設定してセッションを開始し、実行の [`SDKUserMessage`](#sdkusermessage) を `origin: { kind: "task-notification", subkind: "scheduled-trigger", fireReason: "scheduled" }` 付きで、`isSynthetic` なしで送信します。その変数なしで開始されたプロセスでは、Claude Code は宣言を無視します。また、環境に [`CLAUDECODE`](/docs/ja/env-vars) または `CLAUDE_CODE_CHILD_SESSION` が含まれるプロセスでも宣言を無視します。Claude Code は、値が 1 〜 32 文字の小文字またはアンダースコアである場合にのみ `fireReason` を保持します。TypeScript Agent SDK v0.3.280 以降が必要です。2282アプリケーションが独自のスケジュールでプロンプトを実行する場合は、各実行を宣言してください。そうすることで、Claude Code はターンをユーザーからのライブ入力ではなくスケジュールタスクとしてモデルに提示します。[`env`](#options) で `CLAUDE_CODE_HOST_SCHEDULED_RUN` を `1` に設定してセッションを開始し、実行の [`SDKUserMessage`](#sdkusermessage) を `origin: { kind: "task-notification", subkind: "scheduled-trigger", fireReason: "scheduled" }` 付きで、`isSynthetic` なしで送信します。Claude Code は、その変数なしで開始されたプロセスでは宣言を無視します。また、環境に [`CLAUDECODE`](/docs/ja/env-vars) または `CLAUDE_CODE_CHILD_SESSION` が含まれるプロセスでも無視します。Claude Code は、値が 1 ～ 32 文字の小文字またはアンダースコアである場合にのみ `fireReason` を保持します。TypeScript Agent SDK v0.3.280 以降が必要です。

2271 2283

2272<h3 id="peer-origin-fields">2284<h3 id="peer-origin-fields">

2273 Peer オリジンのフィールド2285 Peer origin のフィールド

2274</h3>2286</h3>

2275 2287

2276`peer` オリジンは、どのエージェントがメッセージを送信したかを示します。送信元は、`SendMessage` を使って `main` に送信するインプロセスの[チームメイト](/docs/ja/agent-teams)か、ユーザー自身の別の Claude Code セッションである[クロスセッションピア](/docs/ja/cross-session-messaging)のいずれかです。クロスセッションピアを使用するには、macOS および Linux で Claude Code v2.1.224 以降が必要です。ネイティブ Windows の要件については、[クロスセッションメッセージングの利用条件](/docs/ja/cross-session-messaging#availability)を参照してください。クロスセッションピアは同じマシン上で実行できるほか、メッセージが Remote Control 経由で届く場合は、[ユーザーの別のマシン](/docs/ja/cross-session-messaging#message-sessions-on-other-machines)や[クラウド](/docs/ja/claude-code-on-the-web)上でも実行できます。2 種類の送信元では、フィールドの設定のされ方が異なります。2288`peer` origin は、どのエージェントがメッセージを送信したかを識別します。送信元は、`SendMessage` を使って `main` に送信するインプロセスの[チームメイト](/docs/ja/agent-teams)か、ユーザー自身の別の Claude Code セッションである[クロスセッションピア](/docs/ja/cross-session-messaging)のいずれかです。クロスセッションピアには、macOS および Linux で Claude Code v2.1.224 以降が必要です。ネイティブ Windows での要件については、[クロスセッションメッセージングの利用条件](/docs/ja/cross-session-messaging#availability)を参照してください。クロスセッションピアは同じマシン上で実行できるほか、メッセージが Remote Control を介して届く場合は、ユーザーの[別のマシン](/docs/ja/cross-session-messaging#message-sessions-on-other-machines)上や[クラウド](/docs/ja/claude-code-on-the-web)で実行することもできます。2 種類の送信元では、フィールドの設定方法が異なります。

2277 2289

2278* `from`: チームメイトの名前、またはクロスセッションピアの場合は送信元アドレスです。[一方向のクロスマシンメッセージ](/docs/ja/cross-session-messaging#message-sessions-on-other-machines)の場合、送信元には返信先アドレスがなく、`from` は `"unknown"` になります。この値は送信元が記述したものであり、検証済みの ID は `verifiedPeerPid` です。2290* `from`：チームメイトの名前、またはクロスセッションピアの場合は送信元アドレスです。[一方向のクロスマシンメッセージ](/docs/ja/cross-session-messaging#message-sessions-on-other-machines)の場合、送信元には返信先アドレスがなく、`from` は `"unknown"` になります。この値は送信元が作成したものであり、検証済みの ID は `verifiedPeerPid` です。

2279* `fromMode`: 送信元セッションの権限クラス（`bypass` または `prompting`）です。[デスクトップアプリ](/docs/ja/desktop#work-across-sessions)など、ユーザーのセッション間で peer メッセージを中継するホストによって宣言されます。Claude Code は、受信側セッションで[受信メッセージの制御](/docs/ja/cross-session-messaging#control-inbound-messages)を適用する際にこの値を読み取ります。Agent SDK v0.3.234 以降が必要です。2291* `fromMode`：送信元セッションの権限クラス（`bypass` または `prompting`）で、[デスクトップアプリ](/docs/ja/desktop#work-across-sessions)など、ユーザーのセッション間でピアメッセージを中継するホストによって宣言されます。Claude Code は、受信側セッションで[受信メッセージの制御](/docs/ja/cross-session-messaging#control-inbound-messages)を適用する際にこの値を読み取ります。Agent SDK v0.3.234 以降が必要です。

2280* `senderTaskId`: チームメイトのタスク ID です。クロスセッションピアの場合は存在しません。2292* `senderTaskId`：チームメイトのタスク ID です。クロスセッションピアの場合は存在しません。

2281* `name`: Claude Code によって正規化された送信元の表示名です。Unicode の制御文字、書式文字、サロゲート、および行区切りまたは段落区切りのコードポイントを除去したうえで、前後の空白を取り除き、64 コードポイントを上限として省略記号付きで切り詰めます。Claude Code v2.1.205 以降が必要です。2293* `name`：Claude Code によって正規化された送信元の表示名です。Unicode の制御文字、書式文字、サロゲート、および行区切り文字や段落区切り文字のコードポイントを除去したうえで、前後の空白を削除し、64 コードポイントを上限として超過分を省略記号で切り詰めます。Claude Code v2.1.205 以降が必要です。

2282* `body`: peer エンベロープを取り除いてデコードしたメッセージ本文で、モデルが参照する内容とバイト単位で一致します。チームメイトのメッセージでは常に存在します。クロスセッションピアの場合は、ターンが Claude Code によって形成されたちょうど 1 つの peer エンベロープである場合にのみ存在します。メッセージテキストを再解析するのではなく、`name` と `body` を表示してください。Claude Code v2.1.205 以降が必要です。2294* `body`：ピアエンベロープを除去してデコードしたメッセージ本文で、モデルが見る内容とバイト単位で一致します。チームメイトからのメッセージでは常に存在します。クロスセッションピアの場合は、ターンが Claude Code によって形成されたちょうど 1 つのピアエンベロープである場合にのみ存在します。メッセージテキストを再解析するのではなく、`name` と `body` を表示してください。Claude Code v2.1.205 以降が必要です。

2283* `fromSession`: 送信元のホストが開くことのできるセッション ID です。送信元のホストによって設定され、UI から送信元セッションにリンクできるようにします。`from` と同様に送信元が主張する値であるため、ナビゲーション先としてのみ使用し、送信元の身元の証明として扱わないでください。Claude Code v2.1.216 以降が必要です。2295* `fromSession`：ホストで開くことができる送信元のセッション ID で、UI から送信元セッションへリンクできるように送信元のホストによって設定されます。`from` と同様に送信元が主張する値であるため、ナビゲーション先としてのみ使用し、送信元の身元の証明として扱わないでください。Claude Code v2.1.216 以降が必要です。

2284* `verifiedPeerPid`: このセッションのクロスセッションメッセージングソケットに接続したプロセスのプロセス ID です。カーネルによって検証され、ペイロードからではなく接続そのものから読み取られます。送信元の識別には `from` ではなくこの値を使用してください。`from` は同じユーザーのどのプロセスからでも偽装できます。Windows やソケット以外の経路での受信など、Claude Code が検証できない場合、このフィールドは存在しません。したがって、値が存在しない場合は送信元が未検証であることを意味します。中継されたトラフィックの場合はメッセージの作成者ではなく中継元を示し、またプロセス ID は再利用される可能性があるため、認証トークンとしてではなく出所を示す情報として扱ってください。Claude Code v2.1.216 以降が必要です。2296* `verifiedPeerPid`：このセッションのクロスセッションメッセージングソケットに接続したプロセスのプロセス ID です。カーネルによって検証され、ペイロードからではなく常に接続そのものから読み取られます。送信元の識別には `from` ではなくこの値を使用してください。`from` は同じユーザーの任意のプロセスによって偽装される可能性があります。Windows やソケット以外の経路での受信など、Claude Code が検証できない場合はこのフィールドは存在しないため、値が存在しないことは送信元が未検証であることを意味します。中継されたトラフィックの場合、この値はメッセージの作成者ではなく中継元を識別します。また、プロセス ID は再利用される可能性があるため、認証トークンではなく来歴情報として扱ってください。Claude Code v2.1.216 以降が必要です。

2285 2297

2286<h2 id="hook-types">2298<h2 id="hook-types">

2287 フック型2299 フック型

agent-view.md +5 −2

Details

347 347

348フィルターを組み合わせるには、`a:`、`s:`、`n:`、または `o:` で始め、スペースで区切って追加します。リストには、そのすべてに一致するセッションが表示されます。たとえば、`s:blocked a:reviewer` は、ユーザーを待っている `reviewer` セッションを表示します。348フィルターを組み合わせるには、`a:`、`s:`、`n:`、または `o:` で始め、スペースで区切って追加します。リストには、そのすべてに一致するセッションが表示されます。たとえば、`s:blocked a:reviewer` は、ユーザーを待っている `reviewer` セッションを表示します。

349 349

350フィルターが有効な間は、折りたたんだグループが展開されて一致するセッションが表示され、最初の一致が選択されるため、`Enter` を押すとそのセッションが開きます。入力をクリアするとフィルターが解除され、それらのグループは再び折りたたまれます。350フィルターが有効な間は、折りたたんだグループが展開されて一致するセッションが表示され、一致するセッションが選択されるため、`Enter` を押すとそのセッションが開きます。入力をクリアするとフィルターが解除され、それらのグループは再び折りたたまれます。

351 351

352<h3 id="keyboard-shortcuts">352<h3 id="keyboard-shortcuts">

353 キーボードショートカット353 キーボードショートカット

369| `Tab` | 空の入力で、すべての subagents を参照します。それ以外の場合はハイライトされた提案を適用 |369| `Tab` | 空の入力で、すべての subagents を参照します。それ以外の場合はハイライトされた提案を適用 |

372| `Ctrl+F` | [`n:` フィルター](#filter-sessions) を使って名前でセッションを検索 |

373| `Alt+↑` / `Alt+↓` | 前または次のグループヘッダーにジャンプ |

379| `?` | すべてのショートカットを表示 |381| `?` | すべてのショートカットを表示 |

380 382

381`Ctrl+S`、`Ctrl+T`、および `Ctrl+G` は [`keybindings.json`](/docs/ja/keybindings) に従います。`Ctrl+S` と `Ctrl+T` を [`Agents` コンテキスト](/docs/ja/keybindings#agents-actions) の `agents:switchView` と `agents:togglePin` アクションで再バインドまたはアンバインドし、`Ctrl+G` を `Chat` コンテキストの `chat:externalEditor` バインディングを通じて再バインドします。テーブル内の他のショートカットは再バインドできません。383[`Agents` コンテキスト](/docs/ja/keybindings#agents-actions) にアクションがあるショートカットは、[`keybindings.json`](/docs/ja/keybindings) に従います。`Ctrl+G` も、`Chat` コンテキストの `chat:externalEditor` バインディングを通じて同様に従います。

382 384

383<h2 id="dispatch-new-agents">385<h2 id="dispatch-new-agents">

384 新しいエージェントをディスパッチする386 新しいエージェントをディスパッチする

1087 1089

1088| バージョン | 変更 |1090| バージョン | 変更 |

1089| - | - |1091| - | - |

1092| v2.1.288 | `Ctrl+F` は名前でセッションを検索し、`Alt+↑` / `Alt+↓` はグループヘッダー間を移動します。これらのキーと `Ctrl+R` は[再割り当て](/docs/ja/keybindings#agents-actions)できます。 |

1090| v2.1.287 | [`n:<text>` フィルター](#filter-sessions)は、名前または最初のプロンプトでセッションを検索します。いずれかのフィルターが有効な間は、折りたたんだグループが展開されて一致するセッションが表示され、最初の一致が選択されるため、`Enter` でそれを開けます。 |1093| v2.1.287 | [`n:<text>` フィルター](#filter-sessions)は、名前または最初のプロンプトでセッションを検索します。いずれかのフィルターが有効な間は、折りたたんだグループが展開されて一致するセッションが表示され、最初の一致が選択されるため、`Enter` でそれを開けます。 |

1091| v2.1.287 | [ピーク返信](#peek-and-reply)として送信されたコマンドは、セッションの現在のターンが終了したときに実行されます。これには、セッション自身のプロンプトで入力するとすぐに実行されるコマンドも含まれます。`/stop` だけの返信は、セッションを直ちに停止します。 |1094| v2.1.287 | [ピーク返信](#peek-and-reply)として送信されたコマンドは、セッションの現在のターンが終了したときに実行されます。これには、セッション自身のプロンプトで入力するとすぐに実行されるコマンドも含まれます。`/stop` だけの返信は、セッションを直ちに停止します。 |

1092| v2.1.281 | [`--setting-sources`](/docs/ja/cli-reference#cli-flags) 制限は [バックグラウンド化するときに転送されます](#what-carries-over-when-you-background)。`←` または `/bg` でセッションをバックグラウンド化し、agent view からディスパッチするセッションに転送されます。このリリース前は、生成されたセッションはすべての設定ソースを読み込みました。 |1095| v2.1.281 | [`--setting-sources`](/docs/ja/cli-reference#cli-flags) 制限は [バックグラウンド化するときに転送されます](#what-carries-over-when-you-background)。`←` または `/bg` でセッションをバックグラウンド化し、agent view からディスパッチするセッションに転送されます。このリリース前は、生成されたセッションはすべての設定ソースを読み込みました。 |

amazon-bedrock.md +17 −0

Details

386 386

387これらのチェックがアカウントが呼び出せないモデルを見つけた場合、Claude Code はこのマシンで最大 1 日間その拒否を記憶し、その時間中は Amazon Bedrock に再度問い合わせることなく記憶されたモデルをスキップして起動します。Claude Code は、現在のデフォルトモデルの記憶された拒否を、最後のチェック以降 10 分が経過すると起動時に再度チェックするため、管理者が再度有効にしたデフォルトが戻ります。メモリをオフにするには、[`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/ja/env-vars)を設定してください。387これらのチェックがアカウントが呼び出せないモデルを見つけた場合、Claude Code はこのマシンで最大 1 日間その拒否を記憶し、その時間中は Amazon Bedrock に再度問い合わせることなく記憶されたモデルをスキップして起動します。Claude Code は、現在のデフォルトモデルの記憶された拒否を、最後のチェック以降 10 分が経過すると起動時に再度チェックするため、管理者が再度有効にしたデフォルトが戻ります。メモリをオフにするには、[`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/ja/env-vars)を設定してください。

388 388

389<h3 id="when-your-organization-enforces-a-model-allowlist">

390 組織がモデルの許可リストを強制する場合

391</h3>

392

393管理設定で [`enforceAvailableModels`](/docs/ja/model-config#enforce-the-allowlist-for-the-default-model) を設定すると、スタートアップモデルチェックは `availableModels` リストで許可されたモデルのみを使用します。これは Amazon Bedrock Invoke API に適用され、Claude Code v2.1.287 以降が必要です。`enforceAvailableModels` のないリストでは、これらのチェックは制限されません。

394

395チェックは各エントリを、送信する推論プロファイル ID（[リージョンプレフィックス](#cross-region-inference-profile-prefixes)を含む）と比較するため、リストはそれらの ID で記述してください。この例では、モデルが `us.` プロファイルに解決されるデプロイに対して Opus 4.8 と Sonnet 4.5 を許可します。

396

397```json theme={null}

398{

399 "availableModels": ["us.anthropic.claude-opus-4-8", "us.anthropic.claude-sonnet-4-5-20250929-v1:0"],

400 "enforceAvailableModels": true

401}

402```

403

404エイリアス、バージョンプレフィックス、`modelOverrides` エントリについては、[サードパーティデプロイ用にモデルをピン留めする](/docs/ja/model-config#pin-models-for-third-party-deployments)を参照してください。

405

389<h3 id="when-a-model-is-disabled-mid-session">406<h3 id="when-a-model-is-disabled-mid-session">

390 モデルがセッション中に無効化される場合407 モデルがセッション中に無効化される場合

391</h3>408</h3>

artifacts.md +3 −1

Details

156 Claude にコメントに自動で返信させる156 Claude にコメントに自動で返信させる

157</h3>157</h3>

158 158

159セッションがアーティファクトを公開した後、Claude Code はセッションが実行されている限り、そのアーティファクトのコメントを監視します。アーティファクトを編集できるユーザーが Claude にコメントを送信すると、すぐにセッションに到達し、Claude はスレッドを読んで、あなたに尋ねることなく返信できます。159セッションがアーティファクトを公開した後、Claude Code はそのアーティファクトのコメントを監視します。アーティファクトを編集できるユーザーが Claude にコメントを送信すると、すぐにセッションに到達し、Claude はスレッドを読んで、ユーザーが依頼しなくても返信できます。

160 160

161Claude Code v2.1.228 以降が必要です。[フィーチャーフラグ取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)をオフにした場合、Claude Code はコメントを監視しません。161Claude Code v2.1.228 以降が必要です。[フィーチャーフラグ取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)をオフにした場合、Claude Code はコメントを監視しません。

162 162

174* **`/tasks` でタスクを停止する**：Claude はそのアーティファクトへの返信を停止し、そこで返信を再開するよう求めるまで停止したままになります。アーティファクトを再度公開しても返信は再開されず、セッションを再開しても停止は適用されたままになります。174* **`/tasks` でタスクを停止する**：Claude はそのアーティファクトへの返信を停止し、そこで返信を再開するよう求めるまで停止したままになります。アーティファクトを再度公開しても返信は再開されず、セッションを再開しても停止は適用されたままになります。

175* **3 秒以内に `Ctrl+X Ctrl+K` を 2 回押す**：[すべての実行中のバックグラウンドサブエージェントを停止](/docs/ja/interactive-mode#general-controls)するコードは、セッションの残りの間、Claude がすべてのアーティファクトに返信するのも停止します。Claude に返信を再開するよう求めても、この停止は元に戻りません。175* **3 秒以内に `Ctrl+X Ctrl+K` を 2 回押す**：[すべての実行中のバックグラウンドサブエージェントを停止](/docs/ja/interactive-mode#general-controls)するコードは、セッションの残りの間、Claude がすべてのアーティファクトに返信するのも停止します。Claude に返信を再開するよう求めても、この停止は元に戻りません。

176 176

177Claude Code が自動で開始した監視は、アーティファクトで数時間アクティビティがない状態が続くと終了することがあります。監視を再開するには、アーティファクトを再度公開するか、Claude に監視するよう依頼してください。

178

177コメントを配信するサービスが利用できなくなるか、応答を停止した場合、Claude Code はしばらく再接続を試み、その後、セッションが監視していた各アーティファクトの監視を停止します。179コメントを配信するサービスが利用できなくなるか、応答を停止した場合、Claude Code はしばらく再接続を試み、その後、セッションが監視していた各アーティファクトの監視を停止します。

178 180

179<h2 id="pull-live-data-with-mcp-connectors">181<h2 id="pull-live-data-with-mcp-connectors">

best-practices.md +18 −17

Details

479 自動化とスケール479 自動化とスケール

480</h2>480</h2>

481 481

4821 つの Claude で効果的になったら、並列セッション、非対話型モード、ファンアウトパターンで出力を乗算します。4821 つの Claude で効果的になったら、並列セッション、非対話モード、ファンアウトパターンで出力を乗算します。

483 483

484<h3 id="run-non-interactive-mode">484<h3 id="run-non-interactive-mode">

485 非対話型モードを実行する485 非対話モードを実行する

486</h3>486</h3>

487 487

488<Tip>488<Tip>

489 CI、プリコミットフック、またはスクリプトで `claude -p "prompt"` を使用します。ストリーミング JSON 出力の場合は `--output-format stream-json --verbose` を追加します。489 CI、プリコミットフック、またはスクリプトで `claude -p "prompt"` を使用します。ストリーミング JSON 出力の場合は `--output-format stream-json --verbose` を追加します。

490</Tip>490</Tip>

491 491

492`claude -p "your prompt"` を使用すると、対話型プロンプトなしで Claude を非対話的に実行できます。実行は `--no-session-persistence` を渡さない限り、再開可能なセッションを作成します。[非対話型モード](/docs/ja/headless)は、Claude を CI パイプライン、プリコミットフック、または自動化されたワークフローに統合する方法です。出力形式を使用すると、結果をプログラムで解析できます。プレーンテキスト、JSON、またはストリーミング JSON です。492`claude -p "your prompt"` を使用すると、対話的なプロンプトなしで Claude を非対話的に実行できます。実行は `--no-session-persistence` を渡さない限り、再開可能なセッションを作成します。[非対話モード](/docs/ja/headless)は、Claude を CI パイプライン、プリコミットフック、または自動化されたワークフローに統合する方法です。出力形式を使用すると、結果をプログラムで解析できます。プレーンテキスト、JSON、またはストリーミング JSON です。

493 493

494```bash theme={null}494```bash theme={null}

495# One-off queries495# One-off queries

516 516

517* [Worktrees](/docs/ja/worktrees)：分離された git チェックアウトで個別の CLI セッションを実行して、編集が衝突しないようにします517* [Worktrees](/docs/ja/worktrees)：分離された git チェックアウトで個別の CLI セッションを実行して、編集が衝突しないようにします

518* [クロスセッションメッセージング](/docs/ja/cross-session-messaging)：自分で実行するセッションが相互に検出結果を渡すことができます518* [クロスセッションメッセージング](/docs/ja/cross-session-messaging)：自分で実行するセッションが相互に検出結果を渡すことができます

519* [デスクトップアプリ](/docs/ja/desktop#work-in-parallel-with-sessions)：複数のローカルセッションを視覚的に管理します。各セッションは独自の worktree にあります519* [デスクトップアプリ](/docs/ja/desktop#work-in-parallel-with-sessions)：複数のローカルセッションを視覚的に管理します。必要に応じて、各セッションを独自の worktree で実行できます

520* [Web 上の Claude Code](/docs/ja/claude-code-on-the-web)：デフォルトで Anthropic が管理するインフラストラクチャ上のクラウドでセッションを実行します520* [クラウドで Claude Code を使用する](/docs/ja/claude-code-on-the-web)：デフォルトで Anthropic が管理するインフラストラクチャ上でセッションを実行します

521* [エージェントビュー](/docs/ja/agent-view)：研究プレビュー。`claude agents` を実行して、バックグラウンドで実行し続けるセッションをディスパッチし、1 つの画面から監視します521* [エージェントビュー](/docs/ja/agent-view)：リサーチプレビュー。`claude agents` を実行して、バックグラウンドで実行し続けるセッションをディスパッチし、1 つの画面から監視します

522* [エージェントチーム](/docs/ja/agent-teams)：実験的で、デフォルトで無効です。共有タスク、メッセージング、チームリーダーを備えた複数のセッションの自動調整522* [エージェントチーム](/docs/ja/agent-teams)：実験的で、デフォルトで無効です。共有タスク、メッセージング、チームリーダーを備えた複数のセッションの自動調整

523 523

524作業を並列化することを超えて、複数のセッションは品質に焦点を当てたワークフローを有効にします。新しいコンテキストは、Claude がちょうど書いたコードに偏らないため、コードレビューを改善します。524作業を並列化することを超えて、複数のセッションは品質に焦点を当てたワークフローを有効にします。新しいコンテキストは、Claude がちょうど書いたコードに偏らないため、コードレビューを改善します。

531| | `Review the rate limiter implementation in @src/middleware/rateLimiter.ts. Look for edge cases, race conditions, and consistency with our existing middleware patterns.` |531| | `Review the rate limiter implementation in @src/middleware/rateLimiter.ts. Look for edge cases, race conditions, and consistency with our existing middleware patterns.` |

532| `Here's the review feedback: [Session B output]. Address these issues.` | |532| `Here's the review feedback: [Session B output]. Address these issues.` | |

533 533

534テストで同様のことを行うことができます。1 つの Claude にテストを書かせ、別の Claude にそれらを渡すコードを書かせます。534テストで同様のことを行うことができます。1 つの Claude にテストを書かせ、別の Claude にそれらをパスするコードを書かせます。

535 535

536<h3 id="fan-out-across-files">536<h3 id="fan-out-across-files">

537 ファイル全体にファンアウトする537 ファイル全体にファンアウトする

538</h3>538</h3>

539 539

540<Tip>540<Tip>

541 各タスクに対して `claude -p` を呼び出すループを実行します。バッチ操作のスコープ権限に `--allowedTools` を使用します。541 各タスクに対して `claude -p` を呼び出すループを実行します。バッチ操作用にツールを事前承認するには `--allowedTools` を使用します。

542</Tip>542</Tip>

543 543

544大規模な移行または分析の場合、多くの並列 Claude 呼び出し全体で作業を配布できます。[`/batch <instruction>`](/docs/ja/commands#all-commands) を実行して、Claude が変更を 5～30 個のサブエージェント全体に分割させます。各サブエージェントは独自の worktree で作業します。代わりに独自のスクリプトからファンアウトを駆動するには、`claude -p` をループします。544大規模な移行または分析の場合、多くの並列 Claude 呼び出し全体で作業を配布できます。[`/batch <instruction>`](/docs/ja/commands#all-commands) を実行して、Claude が変更を 5～30 個のサブエージェント全体に分割させます。各サブエージェントは独自の worktree で作業します。代わりに独自のスクリプトからファンアウトを駆動するには、`claude -p` をループします。

552 ```bash theme={null}552 ```bash theme={null}

553 for file in $(cat files.txt); do553 for file in $(cat files.txt); do

554 claude -p "Migrate $file from Python 2 to Python 3. Return OK or FAIL." \554 claude -p "Migrate $file from Python 2 to Python 3. Return OK or FAIL." \

555 --allowedTools "Edit,Bash(git commit *)"555 --allowedTools "Edit,Bash(git commit *)" \

556 --permission-mode dontAsk

556 done557 done

557 ```558 ```

558 </Step>559 </Step>

559 560

560 <Step title="いくつかのファイルでテストしてから、すべてのファイルで実行する">561 <Step title="いくつかのファイルでテストしてから、すべてのファイルで実行する">

561 最初の 2～3 ファイルで何が悪いかに基づいてプロンプトを改善し、完全なセットで実行します。`--allowedTools` フラグは Claude が何ができるかを制限します。これは無人で実行しているときに重要です。562 最初の 2～3 ファイルで何が悪いかに基づいてプロンプトを改善し、完全なセットで実行します。`--allowedTools` フラグは移行に必要なツールを事前承認し、[`--permission-mode dontAsk`](/docs/ja/permission-modes#allow-only-pre-approved-tools-with-dontask-mode) は承認が必要になるそれ以外のすべてを拒否します。これは無人で実行しているときに重要です。

562 </Step>563 </Step>

563</Steps>564</Steps>

564 565

569```570```

570 571

571<h3 id="run-autonomously-with-auto-mode">572<h3 id="run-autonomously-with-auto-mode">

572 auto mode で自律的に実行する573 auto モードで自律的に実行する

573</h3>574</h3>

574 575

575無中断の実行とバックグラウンドのセーフティチェックについては、[auto mode](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) を使用します。分類器モデルはコマンドを実行前にレビューし、スコープエスカレーション、未知のインフラストラクチャ、敵対的なコンテンツ駆動のアクションをブロックしながら、ルーチンワークをプロンプトなしで進めさせます。576無中断の実行とバックグラウンドのセーフティチェックについては、[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)を使用します。分類器モデルはコマンドを実行前にレビューし、スコープエスカレーション、未知のインフラストラクチャ、敵対的なコンテンツ駆動のアクションをブロックしながら、日常的な作業をプロンプトなしで進めさせます。

576 577

577```bash theme={null}578```bash theme={null}

578claude --permission-mode auto -p "fix all lint errors"579claude --permission-mode auto -p "fix all lint errors"

579```580```

580 581

581非対話型実行で `-p` フラグを使用する場合、分類器が繰り返しアクションをブロックするとき、Claude Code は実行を停止しません。[auto mode がフォールバックするとき](/docs/ja/permission-modes#when-auto-mode-falls-back)を参照して、代わりに何が起こるか、およびしきい値を確認してください。582`-p` フラグを使用した非対話実行で分類器が繰り返しアクションをブロックするとき、Claude Code は実行を停止しません。[auto モードがフォールバックするとき](/docs/ja/permission-modes#when-auto-mode-falls-back)を参照して、代わりに何が起こるか、およびしきい値を確認してください。

582 583

583<h3 id="add-an-adversarial-review-step">584<h3 id="add-an-adversarial-review-step">

584 敵対的なレビューステップを追加する585 敵対的なレビューステップを追加する

585</h3>586</h3>

586 587

587<Tip>588<Tip>

588 タスクが完了したと見なす前に、サブエージェントに新しいコンテキストで diff をレビューさせ、ギャップを報告させます。589 タスクが完了したと見なす前に、サブエージェントに新しいコンテキストで差分をレビューさせ、ギャップを報告させます。

589</Tip>590</Tip>

590 591

591Claude が無人で作業する期間が長いほど、作業が完了したと見なす前に独立したチェックが重要になります。新しい[サブエージェント](/docs/ja/sub-agents)コンテキストで実行されるレビュアーは、diff と提供されたクライテリアのみを見て、変更を生成した推論は見ないため、独自の条件で結果を評価します。592Claude が無人で作業する期間が長いほど、作業が完了したと見なす前に独立したチェックが重要になります。新しい[サブエージェント](/docs/ja/sub-agents)コンテキストで実行されるレビュアーは、差分と提供されたクライテリアのみを見て、変更を生成した推論は見ないため、独自の条件で結果を評価します。

592 593

593正確性チェックの場合、バンドルされた [`/code-review` スキル](/docs/ja/commands)を実行します。これは新しいサブエージェントで現在の diff をバグについてレビューし、検出結果をセッションに返します。代わりに diff をプランに対してチェックするには、レビュープロンプトを自分で作成します。チェックする作業、チェック対象のプラン、および検出結果として何がカウントされるかを名前付けします。594正確性チェックの場合、バンドルされた [`/code-review` スキル](/docs/ja/commands)を実行します。これは新しいサブエージェントで現在の差分をバグについてレビューし、検出結果をセッションに返します。代わりに差分をプランに対してチェックするには、レビュープロンプトを自分で作成します。チェックする作業、チェック対象のプラン、および検出結果として何がカウントされるかを明示します。

594 595

595```text wrap theme={null}596```text wrap theme={null}

596Use a subagent to review the rate limiter diff against PLAN.md. Check that597Use a subagent to review the rate limiter diff against PLAN.md. Check that

601レビュアーはサブエージェントとして実行されるため、実装セッションはギャップを直接受け取り、ウィンドウ間で検出結果をコピーすることなく、それらを修正して再レビューできます。602レビュアーはサブエージェントとして実行されるため、実装セッションはギャップを直接受け取り、ウィンドウ間で検出結果をコピーすることなく、それらを修正して再レビューできます。

602 603

603<Callout>604<Callout>

604 ギャップを見つけるようにプロンプトされたレビュアーは、作業が健全であっても、通常はいくつかを報告します。それはそれが求められたことだからです。すべての検出結果を追求することは、過度なエンジニアリングにつながります。追加の抽象化レイヤー、防御的なコード、および発生できないケースのテストです。レビュアーに、正確性または記載された要件に影響するギャップのみをフラグ付けするよう指示し、残りはオプションとして扱います。605 ギャップを見つけるようにプロンプトされたレビュアーは、作業が健全であっても、通常はいくつかを報告します。それはそれが求められたことだからです。すべての検出結果を追求することは、過度なエンジニアリングにつながります。追加の抽象化レイヤー、防御的なコード、および発生し得ないケースのテストです。レビュアーに、正確性または記載された要件に影響するギャップのみを指摘するよう指示し、残りはオプションとして扱います。

605</Callout>606</Callout>

606 607

607***608***

channels.md +1 −1

Details

326 組織のチャネルを有効にする326 組織のチャネルを有効にする

327</h3>327</h3>

328 328

329[**claude.ai → Admin settings → Claude Code → Channels**](https://claude.ai/admin-settings/claude-code) から組織のチャネルを有効にします。これには Owner ロールが必要です。または、管理設定で `channelsEnabled` を `true` に設定します。329[**Organization settings > Claude Code > Channels**](https://claude.ai/admin-settings/claude-code) から組織のチャネルを有効にします。これには Owner ロールが必要です。または、管理設定で `channelsEnabled` を `true` に設定します。

330 330

331有効にすると、組織内のユーザーは `--channels` を使用して個別のセッションにチャネルサーバーをオプトインできます。設定が無効または未設定の場合、MCP サーバーは接続され、そのツールは機能しますが、チャネルメッセージは到着しません。スタートアップ警告は、ユーザーに管理者が設定を有効にするよう指示します。331有効にすると、組織内のユーザーは `--channels` を使用して個別のセッションにチャネルサーバーをオプトインできます。設定が無効または未設定の場合、MCP サーバーは接続され、そのツールは機能しますが、チャネルメッセージは到着しません。スタートアップ警告は、ユーザーに管理者が設定を有効にするよう指示します。

332 332

claude-apps-gateway.md +23 −18

Details

308<Warning>308<Warning>

309 `gatewayInternalNetworks` は、公開アドレス空間から番号が付けられている内部ネットワーク用です。ゲートウェイをインターネットに公開することを安全にするわけではありません。信頼されたゲートウェイは開発者マシンでコマンドを実行する設定をプッシュできます。309 `gatewayInternalNetworks` は、公開アドレス空間から番号が付けられている内部ネットワーク用です。ゲートウェイをインターネットに公開することを安全にするわけではありません。信頼されたゲートウェイは開発者マシンでコマンドを実行する設定をプッシュできます。

310 310

311 ファイアウォールまたはロードバランサーのルールでゲートウェイをネットワークの外から到達不可能に保ちます。ゲートウェイの [`access_control.allow_cidrs`](/docs/ja/claude-apps-gateway-config#http-tuning) をここで宣言するのと同じブロックに設定して、ゲートウェイ自体が他の場所からのクライアントを拒否するようにします。ロードバランサーまたはイングレスの背後にある場合、`listen.trusted_proxies` もそのフロントエンドに設定します。ゲートウェイはそうでなければ `allow_cidrs` をフロントエンド独自のアドレスではなく開発者のアドレスと照合するためです。311 ファイアウォールまたはロードバランサーのルールでゲートウェイをネットワークの外から到達不可能に保ちます。ゲートウェイの [`access_control.allow_cidrs`](/docs/ja/claude-apps-gateway-config#http-tuning) をここで宣言するのと同じブロックに設定して、ゲートウェイ自体が他の場所からのクライアントを拒否するようにします。ロードバランサーまたはイングレスの背後にある場合、`listen.trusted_proxies` もそのフロントエンドに設定します。そうしないと、ゲートウェイは `allow_cidrs` を開発者のアドレスではなくフロントエンド自身のアドレスと照合するためです。

312</Warning>312</Warning>

313 313

314キーをログインキーと同じ管理設定ソースに追加します。管理設定ファイル、MDM プロファイル、またはレジストリポリシーです。Claude Code はユーザー、プロジェクト、およびサーバー管理設定でそれを無視します。314キーをログインキーと同じ管理設定ソースに追加します。管理設定ファイル、MDM プロファイル、またはレジストリポリシーです。Claude Code はユーザー、プロジェクト、およびサーバー管理設定でそれを無視します。

350 350

351Claude Desktop は Cowork タブと Code タブ、および有効にした場合は Chat タブを、埋め込み Claude Code セッションで実行し、それらのモデルリクエストをゲートウェイを通じて送信します。ゲートウェイが `/user/bootstrap` で提供する設定から構築されたポリシーを各セッションに渡します。モデル許可リスト、無効化されたツール、および一致したポリシーの `cli` ブロックから派生した出力許可リスト、および[`desktop` オーバーレイ](/docs/ja/claude-apps-gateway-config#claude-desktop-overlay)です。351Claude Desktop は Cowork タブと Code タブ、および有効にした場合は Chat タブを、埋め込み Claude Code セッションで実行し、それらのモデルリクエストをゲートウェイを通じて送信します。ゲートウェイが `/user/bootstrap` で提供する設定から構築されたポリシーを各セッションに渡します。モデル許可リスト、無効化されたツール、および一致したポリシーの `cli` ブロックから派生した出力許可リスト、および[`desktop` オーバーレイ](/docs/ja/claude-apps-gateway-config#claude-desktop-overlay)です。

352 352

353hooks、`env`、および `Bash(npm *)` のようなスコープ付き権限ルールなどの他の `cli` キーは、`/login` を通じてサインインするクライアントにのみ到達します。Claude Desktop はゲートウェイ URL を独自の管理設定から読み取り、[ゲートウェイ URL を設定する](#set-the-gateway-url)の `forceLoginMethod` と `forceLoginGatewayUrl` キーとは別の独自のフローでサインインします。353フック、`env`、および `Bash(npm *)` のようなスコープ付き権限ルールなどの他の `cli` キーは、`/login` を通じてサインインするクライアントにのみ到達します。Claude Desktop はゲートウェイ URL を独自の管理設定から読み取り、[ゲートウェイ URL を設定する](#set-the-gateway-url)の `forceLoginMethod` と `forceLoginGatewayUrl` キーとは別の独自のフローでサインインします。

354 354

355起動プロセスによって渡される設定は親設定です。Claude Code は、管理者がデプロイした管理ソースを持つマシンで親設定を無視します。ただし、[ポリシーを配信するソース](/docs/ja/managed-settings#which-managed-source-claude-code-uses)が `parentSettingsBehavior: "merge"` を設定する場合を除きます。355起動プロセスによって渡される設定は親設定です。Claude Code は、管理者がデプロイした管理ソースを持つマシンで親設定を無視します。ただし、[ポリシーを配信するソース](/docs/ja/managed-settings#which-managed-source-claude-code-uses)が `parentSettingsBehavior: "merge"` を設定する場合を除きます。

356 356

360 360

361Claude Desktop のみを実行するマシンはそれを必要とします。Claude Desktop は埋め込みセッションにモデルリストと無効化されたツールリストを適用しますが、出力許可リストは親設定としてのみそれらに到達します。`WebFetch` ドメインルールとサンドボックスネットワークルールの形式です。オプトインなしでは、これらのセッションは出力制限なしで実行され、何も警告しません。ゲートウェイはポリシーが許可しないモデルの推論リクエストを引き続き拒否します。361Claude Desktop のみを実行するマシンはそれを必要とします。Claude Desktop は埋め込みセッションにモデルリストと無効化されたツールリストを適用しますが、出力許可リストは親設定としてのみそれらに到達します。`WebFetch` ドメインルールとサンドボックスネットワークルールの形式です。オプトインなしでは、これらのセッションは出力制限なしで実行され、何も警告しません。ゲートウェイはポリシーが許可しないモデルの推論リクエストを引き続き拒否します。

362 362

363プラグインマーケットプレイス許可リストも埋め込みセッションにのみ親設定として到達します。Claude Desktop の管理設定でユーザーが追加したプラグインマーケットプレイスをオフにすると、Claude Desktop 2.16120.0 以降は組織がプロビジョニングしなかったマーケットプレイスを非表示にし、それらからのインストールを拒否します。埋め込みセッションがそれらのマーケットプレイスから既にインストールされているプラグインの読み込みを停止するために、親設定として `strictKnownMarketplaces` リストを送信します。オプトインなしでは、Claude Code はそのリストを無視し、それらのプラグインは読み込み続けます。363プラグインマーケットプレイス許可リストも、埋め込みセッションには親設定としてのみ到達します。Claude Desktop の管理設定でユーザーが追加したプラグインマーケットプレイスをオフにすると、Claude Desktop 2.16120.0 以降は組織がプロビジョニングしなかったマーケットプレイスを非表示にし、それらからのインストールを拒否します。埋め込みセッションがそれらのマーケットプレイスから既にインストールされているプラグインの読み込みを停止するために、親設定として `strictKnownMarketplaces` リストを送信します。オプトインなしでは、Claude Code はそのリストを無視し、それらのプラグインは読み込み続けます。

364 364

365`/login` を通じてサインインする開発者のマシンはそれを必要としません。各 Claude Code セッションはゲートウェイからポリシーをフェッチします。365`/login` を通じてサインインする開発者のマシンはそれを必要としません。各 Claude Code セッションはゲートウェイからポリシーをフェッチします。

366 366

378 </Step>378 </Step>

379 379

380 <Step title="ファイルを上回るソースにスニペットをミラーリングする">380 <Step title="ファイルを上回るソースにスニペットをミラーリングする">

381 Claude Code は `parentSettingsBehavior` を[選択されたソース](/docs/ja/managed-settings#which-managed-source-claude-code-uses)からのみ読み取ります。クライアント側ソースにポリシーキーを追加すると、そのソースが選択されたものになる可能性があるため、クライアント側ソースでは `parentSettingsBehavior` のみではなくスニペット全体をミラーリングします。[クライアント側管理設定](/docs/ja/claude-apps-gateway-config#client-side-managed-settings)は Group Policy または設定プロファイルを通じてポリシーを配信するフリートをカバーしています。macOS の管理設定プリストまたは Windows の HKLM ポリシーは `managed-settings.json` ファイルを上回り、ゲートウェイ独自のリモート管理設定は両方を上回るため、ゲートウェイにサインインするマシンでは、ゲートウェイポリシーの [`cli` ブロック](/docs/ja/claude-apps-gateway-config#managed)にも `parentSettingsBehavior` を設定します。381 Claude Code は `parentSettingsBehavior` を[選択されたソース](/docs/ja/managed-settings#which-managed-source-claude-code-uses)からのみ読み取ります。ソースにポリシーキーを追加すると、そのソースが選択されたものになる可能性があるため、クライアント側ソースでは `parentSettingsBehavior` のみではなくスニペット全体をミラーリングします。[クライアント側管理設定](/docs/ja/claude-apps-gateway-config#client-side-managed-settings)は Group Policy または設定プロファイルを通じてポリシーを配信するフリートをカバーしています。macOS の管理設定プリストまたは Windows の HKLM ポリシーは `managed-settings.json` ファイルを上回り、ゲートウェイ独自のリモート管理設定は両方を上回るため、ゲートウェイにサインインするマシンでは、ゲートウェイポリシーの [`cli` ブロック](/docs/ja/claude-apps-gateway-config#managed)にも `parentSettingsBehavior` を設定します。

382 </Step>382 </Step>

383 383

384 <Step title="どのソースが選択されているかを確認する">384 <Step title="どのソースが選択されているかを確認する">

436 ソース全体のロック動作436 ソース全体のロック動作

437</h4>437</h4>

438 438

4391 つのロックを設定しても、他のロックは制限されません。各キーは[設定リファレンス](/docs/ja/settings-reference#all-settings)で文書化されています。勝者より下の管理ソースから、2 つのサンドボックスロックは引き続き適用され、`allowManagedPermissionRulesOnly` は引き続き親が提供した許可ルールと `additionalDirectories` をブロックします。Claude Code v2.1.273 以降では、MCP サーバーロックも勝者より下のソースから適用され、それがオンの間、管理 `allowedMcpServers` リストは最優先の管理ソースから来ます。4391 つのロックを設定しても、他のロックは制限されません。各キーは[設定リファレンス](/docs/ja/settings-reference#all-settings)で文書化されています。

440 440

441hooks ロックと `allowManagedPermissionRulesOnly` の開発者独自のルールへの影響は、デフォルトで勝者ソースが必要です。[Claude Code が管理ソースを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)の `managedSourcesBehavior` マージオプトインの下で、Claude Code はすべてのロックについてすべてのソースが設定する最も厳密な値を適用します。[`policyHelper`](/docs/ja/settings-reference#policyhelper) フリートでは、ロックはヘルパーの出力からのみ読み取られます。441勝者より下の管理ソースから、2 つのサンドボックスロックは引き続き適用され、`allowManagedPermissionRulesOnly` は引き続き親が提供した許可ルールと `additionalDirectories` をブロックします。Claude Code v2.1.273 以降では、MCP サーバーロックも勝者より下のソースから適用され、それがオンの間、管理 `allowedMcpServers` リストは、それを設定している最優先の管理ソースから取得されます。

442

443フックロックと `allowManagedPermissionRulesOnly` の開発者独自のルールへの影響は、デフォルトで勝者ソースが必要です。[Claude Code が管理ソースを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)の `managedSourcesBehavior` マージオプトインの下で、Claude Code はすべてのロックについてすべてのソースが設定する最も厳密な値を適用します。[`policyHelper`](/docs/ja/settings-reference#policyhelper) フリートでは、Claude Code はロックをヘルパーの出力からのみ読み取ります。

442 444

443各ロックは Claude Code が開発者独自のエントリをその設定について無視するようにするため、組織の許可リストをロックの隣に含めます。445各ロックは Claude Code が開発者独自のエントリをその設定について無視するようにするため、組織の許可リストをロックの隣に含めます。

444 446

445* **ネットワークドメイン**：空の管理ドメインリストでロックするとサンドボックス化された全アウトバウンドトラフィックがブロックされます。447* **ネットワークドメイン**：空の管理ドメインリストでロックするとサンドボックス化された全アウトバウンドトラフィックがブロックされます。

446* **MCP サーバー**：管理またはホストが提供した `allowedMcpServers` なしでロックすると、`deniedMcpServers` がブロックしないすべてのサーバーが読み込まれます。448* **MCP サーバー**：どの管理ソースにも親が提供した設定にも `allowedMcpServers` がない状態でロックすると、`deniedMcpServers` がブロックしないすべてのサーバーが読み込まれます。

447* **読み取りパス**：`allowRead` エントリは `denyRead` 領域内のパスのみを再許可するため、管理 `denyRead` とペアにします。449* **読み取りパス**：`allowRead` エントリは `denyRead` 領域内のパスのみを再許可するため、管理 `denyRead` とペアにします。

448 450

449<h4 id="settings-the-locks-don’t-cover">451<h4 id="settings-the-locks-don’t-cover">

450 ロックがカバーしない設定452 ロックがカバーしない設定

451</h4>453</h4>

452 454

4535 つのロックすべてが設定されていても、6 つの親が提供した設定がフィルターを通過します。デフォルトの最初の勝ちの設定の下で、親をブロックする管理値は最優先の管理ソースにあるものです。ただし、[MCP サーバーロック](#lock-behavior-across-sources)がオンの間は `allowedMcpServers` を除きます。`managedSourcesBehavior` マージオプトインの下で、[Claude Code が管理ソースを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)は代わりにどのソースの値が適用されるかを示します。4555 つのロックすべてが設定されていても、以下の親が提供した設定はフィルターを通過します。

454 456

455* **`forceLoginOrgUUID`**：最優先の管理ソースが組織 UUID を設定しない場合、Claude Code は親が提供した値を尊重します。ゲートウェイサインインはこのキーをチェックしません。最優先の管理ソースの組織 UUID は親の値をブロックし、Claude Code が強制するものです。457* **`forceLoginOrgUUID`**：最優先の管理ソースが組織 UUID を設定しない場合、Claude Code は親が提供した値を尊重します。ゲートウェイサインインはこのキーをチェックしません。最優先の管理ソースの組織 UUID は親の値をブロックし、Claude Code が強制するものです。

456* **`allowedMcpServers`**：最優先の管理ソースが設定しない場合、Claude Code は親が提供した許可リストを尊重します。`allowManagedMcpServersOnly` はそれをブロックしません。ロックは勝者の許可リストを管理値として強制するため、最優先の管理ソースが設定しない場合は親が提供した許可リストを含みます。最優先の管理ソースのリストは親のリストをブロックし、Claude Code が強制するリストです。ロックの隣にそこに `allowedMcpServers` を設定します。v2.1.223 より前では、任意の管理ソースのいずれかのキーの値は親のリストをブロックしました。458* **`allowedMcpServers`**：有効な管理リストがない場合、Claude Code は親が提供した許可リストを尊重します。`allowManagedMcpServersOnly` はそれをブロックしません。ロックは勝者となったリストを管理値として強制し、どの管理ソースもリストを提供しない場合は親が提供したリストも含まれるためです。最優先の管理ソースのリストは親のリストをブロックし、Claude Code が強制するリストになるため、ロックの隣のそこに `allowedMcpServers` を設定します。v2.1.223 より前では、任意の管理ソースのいずれかのキーの値は親の値をブロックしました。

457* **`availableModels`**：勝者の管理ソースが設定しない場合、Claude Code は親が提供したモデルリストを尊重します。フリートがモデルを制限する場合、勝者ソースに `availableModels` を設定します。459* **`availableModels`**：勝者の管理ソースが設定しない場合、Claude Code は親が提供したモデルリストを尊重します。フリートがモデルを制限する場合、勝者ソースに `availableModels` を設定します。

460* **`allowedProviders`**：勝者の管理ソースが設定しない場合、Claude Code は親が提供した API プロバイダー許可リストを尊重します。フリートが開発者の使用できる API プロバイダーを制限する場合、勝者ソースに `allowedProviders` を設定します。Claude Code v2.1.285 以降が必要です。

458* **`strictKnownMarketplaces`**：勝者の管理ソースが設定しない場合、Claude Code は親が提供したプラグインマーケットプレイス許可リストを尊重します。Claude Desktop 2.16120.0 以降は、その管理設定でユーザーが追加したプラグインマーケットプレイスをオフにするときに 1 つを送信します。フリートがマーケットプレイスを制限する場合、勝者ソースに `strictKnownMarketplaces` を設定します。Claude Code v2.1.282 以降が必要です。461* **`strictKnownMarketplaces`**：勝者の管理ソースが設定しない場合、Claude Code は親が提供したプラグインマーケットプレイス許可リストを尊重します。Claude Desktop 2.16120.0 以降は、その管理設定でユーザーが追加したプラグインマーケットプレイスをオフにするときに 1 つを送信します。フリートがマーケットプレイスを制限する場合、勝者ソースに `strictKnownMarketplaces` を設定します。Claude Code v2.1.282 以降が必要です。

459* **`blockedMarketplaces`**：親が提供したマーケットプレイスブロックリストは通過し、管理ソースが設定するブロックリストに追加されます。ブロックリストはさらに制限することのみができるためです。Claude Code v2.1.282 以降が必要です。462* **`blockedMarketplaces`**：親が提供したマーケットプレイスブロックリストは通過し、管理ソースが設定するブロックリストに追加されます。ブロックリストはさらに制限することのみができるためです。Claude Code v2.1.282 以降が必要です。

460* **`strictPluginOnlyCustomization`**：このキーはロックに関係なくフィルターを通過し、Claude Code が開発者独自のカスタマイズ（保護フックを含む）を無視するようにします。ロックはそれをブロックしません。463* **`strictPluginOnlyCustomization`**：このキーはロックに関係なくフィルターを通過し、Claude Code が開発者独自のカスタマイズ（保護フックを含む）を無視するようにします。ロックはそれをブロックしません。

461 464

465デフォルトの最初の勝ちの設定の下では、管理値が親の値をブロックするのは、それが最優先の管理ソースにある場合のみです。ただし、[MCP サーバーロック](#lock-behavior-across-sources)がオンの間の `allowedMcpServers` は除きます。`managedSourcesBehavior` マージオプトインの下では、[Claude Code が管理ソースを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)が代わりにどのソースの値が適用されるかを示します。

466

462<h3 id="connect-claude-desktop">467<h3 id="connect-claude-desktop">

463 Claude Desktop を接続する468 Claude Desktop を接続する

464</h3>469</h3>

485 490

486これらの保証はすべての `/login` を通じてサインインしたセッションに適用されます。Claude Desktop が起動する埋め込みセッションは[Claude Desktop セッションにポリシーを配信する](#deliver-policy-to-claude-desktop-sessions)で説明されているようにポリシーを取得し、テレメトリの箇条書きはそれらのエクスポートがどこに行くかを示します。491これらの保証はすべての `/login` を通じてサインインしたセッションに適用されます。Claude Desktop が起動する埋め込みセッションは[Claude Desktop セッションにポリシーを配信する](#deliver-policy-to-claude-desktop-sessions)で説明されているようにポリシーを取得し、テレメトリの箇条書きはそれらのエクスポートがどこに行くかを示します。

487 492

488* **モデルアクセス**：ポリシーが許可しないモデルのリクエストは 400 を返し、`/model` ピッカーはポリシーの `availableModels` 許可リストにフィルタリングされます。ポリシーで [`enforceAvailableModels: true`](/docs/ja/model-config#default-model-behavior) を設定して、Default オプションが Claude Code の組み込みデフォルトではなく `availableModels` 内のモデルに解決されるようにします。なしでは、Default は選択可能なままであり、そのモデルが許可されていない場合、リクエスト時に拒否されます。493* **モデルアクセス**：ポリシーが許可しないモデルのリクエストは 400 を返し、`/model` ピッカーはポリシーの `availableModels` 許可リストにフィルタリングされます。これには、開発者がモデルを選択する前にセッションが開始時に使用するモデルも含まれます。[ポリシーが許可するモデルでセッションを開始する](/docs/ja/claude-apps-gateway-config#start-sessions-on-a-model-the-policy-allows)を参照してください。

489* **テレメトリ宛先**：`/login` を通じてサインインしたセッションでは、CLI はローカルに設定された `OTEL_EXPORTER_OTLP_ENDPOINT` に関係なく、OTLP/HTTP エクスポートをゲートウェイに送信します。ただし、ポリシーが[コレクターをエンドポイントとして指定](/docs/ja/claude-apps-gateway-config#export-directly-to-your-collector)する場合を除きます。ゲートウェイは [`telemetry.forward_to`](/docs/ja/claude-apps-gateway-config#telemetry) の宛先にそれらをリレーします。494* **テレメトリ宛先**：`/login` を通じてサインインしたセッションでは、CLI はローカルに設定された `OTEL_EXPORTER_OTLP_ENDPOINT` に関係なく、OTLP/HTTP エクスポートをゲートウェイに送信します。ただし、ポリシーが[コレクターをエンドポイントとして指定](/docs/ja/claude-apps-gateway-config#export-directly-to-your-collector)する場合を除きます。ゲートウェイは受け取ったエクスポートを [`telemetry.forward_to`](/docs/ja/claude-apps-gateway-config#telemetry) の宛先にリレーします。

490 * [Claude Desktop が起動する](#connect-claude-desktop)埋め込みセッションでは、CLI はエクスポートを設定された `OTEL_EXPORTER_OTLP_ENDPOINT` に送信します。CLI はそのエンドポイントがゲートウェイ自体を指す場合にのみ、ゲートウェイセッショントークンをそれらのエクスポートに添付します。495 * [Claude Desktop が起動する](#connect-claude-desktop)埋め込みセッションでは、CLI はエクスポートを設定された `OTEL_EXPORTER_OTLP_ENDPOINT` に送信します。CLI はそのエンドポイントがゲートウェイ自体を指す場合にのみ、ゲートウェイセッショントークンをそれらのエクスポートに添付します。

491 * 信号に設定された宛先がない場合、ゲートウェイはそれを受け入れて破棄します。496 * 信号に設定された宛先がない場合、ゲートウェイはそれを受け入れて破棄します。

492 * 既に Claude Code テレメトリを直接収集する場合は、コレクターを `forward_to` 宛先として追加するか、ポリシーで指定してリレーをスキップします。497 * 既に Claude Code テレメトリを直接収集する場合は、コレクターを `forward_to` 宛先として追加するか、ポリシーで指定してリレーをスキップします。

493* **認証情報**：ゲートウェイトークンはセッションの唯一の認証情報です。[Anthropic プロファイル](/docs/ja/authentication#anthropic-profiles-and-federation-credentials)および以前の claude.ai ログインはサインイン中は無視されるため、開発者は最初に claude.ai からログアウトする必要はありません。設定された `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` 認証情報については、[Administrator policy requires a Cloud gateway sign-in](/docs/ja/errors#administrator-policy-requires-a-cloud-gateway-sign-in)を参照してください。498* **認証情報**：ゲートウェイトークンはセッションの唯一の認証情報です。[Anthropic プロファイル](/docs/ja/authentication#anthropic-profiles-and-federation-credentials)および以前の claude.ai ログインはサインイン中は無視されるため、開発者は最初に claude.ai からログアウトする必要はありません。設定された `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` 認証情報、あるいは以前の Claude Console ログインで保存された API キーについては、[Administrator policy requires a Cloud gateway sign-in](/docs/ja/errors#administrator-policy-requires-a-cloud-gateway-sign-in)を参照してください。

494* **管理設定**：ロックされたキーはローカルでオーバーライドできません。CLI はポリシーを起動時に適用し、[次の起動時にのみ適用される変更](/docs/ja/server-managed-settings#fetch-and-caching-behavior)を除いて、毎時間のポーリングで変更を適用します。499* **管理設定**：ロックされたキーはローカルでオーバーライドできません。CLI はポリシーを起動時に適用し、[次の起動時にのみ適用される変更](/docs/ja/server-managed-settings#fetch-and-caching-behavior)を除いて、毎時間のポーリングで変更を適用します。

495* **ゲートウェイが到達不可能な状態での起動**：サインイン済みセッションは、設定なしで起動するのではなく、約 10 秒後に起動時にエラーで終了します。500* **ゲートウェイが到達不可能な状態での起動**：サインイン済みセッションは、設定なしで起動するのではなく、約 10 秒後に起動時にエラーで終了します。

496* **ゲートウェイがセッションを終了した後の起動**：[起動時の失敗クローズを強制する](/docs/ja/server-managed-settings#enforce-fail-closed-startup)を参照して、どの起動がゲートウェイからサインアウトした状態で開き、どの起動がゲートウェイが `401` で応答するときに終了するかを確認します。501* **ゲートウェイがセッションを終了した後の起動**：[起動時の失敗クローズを強制する](/docs/ja/server-managed-settings#enforce-fail-closed-startup)を参照して、どの起動がゲートウェイからサインアウトした状態で開き、どの起動がゲートウェイが `401` で応答するときに終了するかを確認します。

515 520

516| 機能 | ステータス | 注記 |521| 機能 | ステータス | 注記 |

517| - | - | - |522| - | - | - |

518| 推論転送（Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry、Anthropic） | 利用可能 | アップストリームごとのモデル変換とフェイルオーバー付き。Amazon Bedrock アップストリームは `bedrock-runtime` エンドポイントと AWS デフォルト認証情報チェーンを使用します。Amazon Bedrock [Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)はサポートされたアップストリームではありません。[Claude Platform on AWS アップストリーム](/docs/ja/claude-apps-gateway-config#claude-platform-on-aws)には、ゲートウェイサーバー上の Claude Code v2.1.198 以降が必要です。 |523| 推論転送（Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry、Anthropic） | 利用可能 | アップストリームごとのモデル変換とフェイルオーバー付き。Amazon Bedrock アップストリームは `bedrock-runtime` エンドポイントと AWS デフォルト認証情報チェーンを使用します。[Amazon Bedrock Mantle アップストリーム](/docs/ja/claude-apps-gateway-config#amazon-bedrock-mantle-endpoint)にはゲートウェイサーバー上の Claude Code v2.1.283 以降が必要で、[Claude Platform on AWS アップストリーム](/docs/ja/claude-apps-gateway-config#claude-platform-on-aws)には v2.1.198 以降が必要です。 |

520| Claude Desktop | 選択的に利用可能 | ゲートウェイは、ポリシーが [`desktop` キー](/docs/ja/claude-apps-gateway-config#claude-desktop-overlay)でオプトインした後、`/user/bootstrap` で Claude Desktop の設定を提供し、Claude Desktop は Cowork タブと Code タブからモデルリクエストを送信し、Chat タブから有効にした場合はゲートウェイを通じて送信します。Chat タブをオンにするには、[Claude Desktop を接続](#connect-claude-desktop)を参照してください。ゲートウェイサーバー上の Claude Code v2.1.203 以降が必要です。 |525| Claude Desktop | 選択的に利用可能 | ゲートウェイは、ポリシーが [`desktop` キー](/docs/ja/claude-apps-gateway-config#claude-desktop-overlay)でオプトインした後、`/user/bootstrap` で Claude Desktop の設定を提供し、Claude Desktop は Cowork タブと Code タブからモデルリクエストを送信し、Chat タブから有効にした場合はゲートウェイを通じて送信します。Chat タブをオンにするには、[Claude Desktop を接続](#connect-claude-desktop)を参照してください。ゲートウェイサーバー上の Claude Code v2.1.203 以降が必要です。 |

527| `/import` と `claude import` などの機能フラグ取得が必要な機能 | 利用不可 | CLI はゲートウェイセッションでフラグ取得をスキップします。[機能フラグ取得が必要な機能](/docs/ja/env-vars#features-that-need-feature-flag-fetching)は、それがオフにするものをリストします |532| `/import` と `claude import` などの機能フラグ取得が必要な機能 | 利用不可 | CLI はゲートウェイセッションでフラグ取得をスキップします。[機能フラグ取得が必要な機能](/docs/ja/env-vars#features-that-need-feature-flag-fetching)は、それがオフにするものをリストします |

528| 標準プロンプトキャッシング | 利用可能 | ゲートウェイは `cache_control` ブレークポイントをすべてのアップストリームに転送します。[キャッシュが存在する場所](/docs/ja/prompt-caching#where-the-cache-lives)は、CLI がマークするブロック（会話の途中で追加するシステムコンテキストを含む）をカバーしています |533| 標準プロンプトキャッシュ | 利用可能 | ゲートウェイは `cache_control` ブレークポイントをすべてのアップストリームに転送します。[キャッシュが存在する場所](/docs/ja/prompt-caching#where-the-cache-lives)は、CLI がマークするブロック（会話の途中で追加するシステムコンテキストを含む）をカバーしています |

530| オートモード | 利用可能 | [サードパーティプロバイダールール](/docs/ja/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry)に従います。サードパーティプロバイダーで適格なモデルのみがそれを使用できます。v2.1.207 より前では、ゲートウェイセッションのオートモードは `CLAUDE_CODE_ENABLE_AUTO_MODE=1` を設定する必要があり、管理ポリシー `env` ブロック経由で配信可能でした |535| auto モード | 利用可能 | [サードパーティプロバイダールール](/docs/ja/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry)に従います。サードパーティプロバイダーで適格なモデルのみがそれを使用できます。v2.1.207 より前では、ゲートウェイセッションの auto モードは `CLAUDE_CODE_ENABLE_AUTO_MODE=1` を設定する必要があり、管理ポリシー `env` ブロック経由で配信可能でした |

538 543

539<h2 id="next-steps">544<h2 id="next-steps">

claude-apps-gateway-config.md +165 −91

Details

82| `allowed_email_domains` | いいえ | `email` クレームがこれらのドメインのいずれかに含まれていない id\_token を拒否します。大文字と小文字を区別しません。マルチテナント IdP の設定ミスに対する多層防御です。この設定とは無関係に、`email_verified` クレームが明示的に `false` である id\_token は常に拒否されます。 |82| `allowed_email_domains` | いいえ | `email` クレームがこれらのドメインのいずれかに含まれていない id\_token を拒否します。大文字と小文字を区別しません。マルチテナント IdP の設定ミスに対する多層防御です。この設定とは無関係に、`email_verified` クレームが明示的に `false` である id\_token は常に拒否されます。 |

83| `allowed_groups` | いいえ | サインインをこれらの IdP グループのメンバーに制限します。`groups_claim` に対してマッチングされます。許可されたメールドメイン内にいるが、これらのグループのいずれにも属していないユーザーは拒否されます。IdP がグループクレームを発行する必要があります。マッチングは、そのクレーム内の値に対する正確で大文字と小文字を区別する文字列比較です。ゲートウェイはネストされたグループを展開しません。サブグループのメンバーを許可するには、ここにサブグループをリストするか、IdP を設定してフラット化されたメンバーシップを発行してください。 |83| `allowed_groups` | いいえ | サインインをこれらの IdP グループのメンバーに制限します。`groups_claim` に対してマッチングされます。許可されたメールドメイン内にいるが、これらのグループのいずれにも属していないユーザーは拒否されます。IdP がグループクレームを発行する必要があります。マッチングは、そのクレーム内の値に対する正確で大文字と小文字を区別する文字列比較です。ゲートウェイはネストされたグループを展開しません。サブグループのメンバーを許可するには、ここにサブグループをリストするか、IdP を設定してフラット化されたメンバーシップを発行してください。 |

84| `groups_claim` | いいえ | グループメンバーシップを含む id\_token クレーム。デフォルト `groups`。Microsoft Entra はアプリロールを `roles` の下に発行します。フラットキーまたは `/resource_access/gateway/roles` などのネストされたクレーム用の RFC 6901 JSON ポインタを受け入れます。 |84| `groups_claim` | いいえ | グループメンバーシップを含む id\_token クレーム。デフォルト `groups`。Microsoft Entra はアプリロールを `roles` の下に発行します。フラットキーまたは `/resource_access/gateway/roles` などのネストされたクレーム用の RFC 6901 JSON ポインタを受け入れます。 |

85| `google_groups` | いいえ | Google Workspace Admin SDK Directory API を通じてサインインしたユーザーのグループを検索します。Google の id\_token はグループクレームを含まないためです。`service_account_json_path` を `https://www.googleapis.com/auth/admin.directory.group.readonly` スコープでドメイン全体の委任を持つサービスアカウントキーファイルに設定し、`admin_email` を Workspace 管理者に設定します。サービスアカウントが偽装します。Directory API は実際の管理者サブジェクトが必要です。各ユーザーのグループメールアドレスがそのグループクレームになるため、`allowed_groups` と `managed.policies.match.groups` はグループメールでマッチングします。 |85| `google_groups` | いいえ | Google Workspace Admin SDK Directory API を通じてサインインしたユーザーのグループを検索します。Google の id\_token はグループクレームを含まないためです。`service_account_json_path` を `https://www.googleapis.com/auth/admin.directory.group.readonly` スコープでドメイン全体の委任を持つサービスアカウントキーファイルに設定し、`admin_email` をサービスアカウントが偽装する Workspace 管理者に設定します。Directory API は実際の管理者サブジェクトを必要とします。各ユーザーのグループメールアドレスがそのグループクレームになるため、`allowed_groups` と `managed.policies.match.groups` はグループメールでマッチングします。 |

86| `email_claim` | いいえ | ユーザーのメールを含む id\_token クレーム。デフォルト `email`。ADFS や Entra B2C などの一部の IdP は、代わりに `upn` または `preferred_username` を発行します。フラットキー、JSON ポインタ、または最初に存在するキーが使用されるフォールバックキーのリストを受け入れます。 |86| `email_claim` | いいえ | ユーザーのメールを含む id\_token クレーム。デフォルト `email`。ADFS や Entra B2C などの一部の IdP は、代わりに `upn` または `preferred_username` を発行します。フラットキー、JSON ポインタ、または最初に存在するキーが使用されるフォールバックキーのリストを受け入れます。 |

87| `scopes` | いいえ | ゲートウェイが要求する OIDC スコープの完全なオーバーライド。デフォルト `[openid, profile, email, offline_access]`。IdP が認識しないスコープを拒否する場合、またはグループまたはメールを発行するためにカスタムスコープが必要な場合に設定します。`openid` を含める必要があります。`offline_access` を削除するとリフレッシュトークンが無効になるため、開発者は `session.ttl_hours` ごとにブラウザログインを再実行します。IdP ごとのスコープレシピ（Google のリフレッシュトークンフローなど）については、[アイデンティティプロバイダーのセットアップ](/docs/ja/claude-apps-gateway-deploy#identity-provider-setup)を参照してください。 |87| `scopes` | いいえ | ゲートウェイが要求する OIDC スコープの完全な上書き。デフォルト `[openid, profile, email, offline_access]`。IdP が認識しないスコープを拒否する場合、またはグループまたはメールを発行するためにカスタムスコープが必要な場合に設定します。`openid` を含める必要があります。`offline_access` を削除するとリフレッシュトークンが無効になるため、開発者は `session.ttl_hours` ごとにブラウザログインを再実行します。IdP ごとのスコープレシピ（Google のリフレッシュトークンフローなど）については、[アイデンティティプロバイダーのセットアップ](/docs/ja/claude-apps-gateway-deploy#identity-provider-setup)を参照してください。 |

88| `scope_on_refresh` | いいえ | リフレッシュトークンを交換するときに、サインインリクエストと同じリストで `scope` も送信します。デフォルト `false`：リフレッシュリクエストは `scope` を省略します。ほとんどの IdP はすべてのリフレッシュで id\_token を返し、これを必要としません。IdP がリフレッシュ時に id\_token を返す場合にのみ `true` に設定します。`openid` を再度要求された場合。Okta はそのリフレッシュグラントについてこれを文書化しています。id\_token がない場合、すべてのリフレッシュは IdP の userinfo エンドポイントが更新されたアクセストークンを受け入れることに依存します。サインインをゲートしたり、グループのポリシーをマッチングしたりする場合、IdP のリフレッシュ時 id\_token がそれらを省略する場合は、`userinfo_fallback: true` も設定して、ゲートウェイが userinfo エンドポイントからそれらを入力するようにしてください。要求されたスコープより少ないスコープを付与した IdP は、これがオンの場合、既存のセッションの場合でも `invalid_scope` でリフレッシュを拒否できます。`token_endpoint` でリフレッシュが失敗し始めた場合は、キーを設定した後、キーを設定解除してください。ゲートウェイサーバーで Claude Code v2.1.260 以降が必要です。 |88| `scope_on_refresh` | いいえ | ゲートウェイがリフレッシュトークンを交換するときに、サインインリクエストと同じリストで `scope` も送信します。デフォルト `false`：リフレッシュリクエストは `scope` を省略します。ほとんどの IdP はリフレッシュのたびに id\_token を返すため、この設定は不要です。IdP が再度 `openid` を要求された場合にのみリフレッシュ時に id\_token を返す場合（Okta はリフレッシュグラントについてこれを文書化しています）は `true` に設定します。id\_token がない場合、すべてのリフレッシュは、IdP の userinfo エンドポイントがリフレッシュされたアクセストークンを受け入れることに依存します。グループに基づいてサインインを制限したりポリシーをマッチングしたりしていて、IdP のリフレッシュ時の id\_token にグループが含まれない場合は、`userinfo_fallback: true` も設定して、ゲートウェイが userinfo エンドポイントからグループを補完するようにしてください。要求より少ないスコープを付与した IdP は、`invalid_scope` でリフレッシュを拒否することがあります。これがオンの間に `scopes` にエントリを追加した場合は、既存のセッションも対象になります。設定後に `token_endpoint` でリフレッシュが失敗し始めた場合は、このキーを削除してください。ゲートウェイサーバーで Claude Code v2.1.260 以降が必要です。 |

89| `extra_auth_params` | いいえ | IdP 認可リクエストに逐語的に追加される追加クエリパラメータ。これは、Google リフレッシュトークンの `access_type: offline`、一部の Entra テナントの `domain_hint`、またはステップアップフローの `acr_values` など、IdP 固有の動作のオーバーライドメカニズムです。ゲートウェイが管理するプロトコルパラメータはオーバーライドできません：`state`、`nonce`、`redirect_uri`、PKCE、`scope`、`response_type`、`response_mode`、および `client_id`。 |89| `extra_auth_params` | いいえ | IdP 認可リクエストに逐語的に追加される追加クエリパラメータ。これは、Google リフレッシュトークンの `access_type: offline`、一部の Entra テナントの `domain_hint`、またはステップアップフローの `acr_values` など、IdP 固有の動作を上書きするための仕組みです。ゲートウェイが管理するプロトコルパラメータは上書きできません：`state`、`nonce`、`redirect_uri`、PKCE、`scope`、`response_type`、`response_mode`、および `client_id`。 |

90| `userinfo_fallback` | いいえ | id\_token がメールまたはグループを省略する場合、`/userinfo` からそれらを取得します。Keycloak 軽量アクセストークン、Okta org サーバー、および ADFS 最小トークンに必要です。id\_token は権限のままです。userinfo はギャップのみを埋めます。デフォルト `false`。 |90| `userinfo_fallback` | いいえ | id\_token がメールまたはグループを省略する場合、`/userinfo` からそれらを取得します。Keycloak 軽量アクセストークン、Okta org サーバー、および ADFS 最小トークンに必要です。id\_token が引き続き正とされ、userinfo は不足分のみを補完します。デフォルト `false`。 |

91| `use_pkce` | いいえ | 認可リクエストで PKCE（S256）チャレンジを送信します。デフォルト `true`。IdP がこの機密クライアントの PKCE を拒否する場合のみ `false` に設定します。 |91| `use_pkce` | いいえ | 認可リクエストで PKCE（S256）チャレンジを送信します。デフォルト `true`。IdP がこの機密クライアントの PKCE を拒否する場合のみ `false` に設定します。 |

92| `clock_skew_seconds` | いいえ | id\_token 時間クレームを検証するときにクロックドリフトを許容します。デフォルト `0`（厳密）。サインイン直後にホスト/IdP クロックスキューのため「トークン期限切れ/まだ有効でない」エラーが表示される場合は、これを上げてください。 |92| `clock_skew_seconds` | いいえ | id\_token 時間クレームを検証するときにクロックドリフトを許容します。デフォルト `0`（厳密）。サインイン直後にホスト/IdP クロックスキューのため「トークン期限切れ/まだ有効でない」エラーが表示される場合は、これを上げてください。 |

93| `token_endpoint_auth_method` | いいえ | ゲートウェイが IdP のトークンエンドポイントに対して認証する方法：`client_secret_basic`、`client_secret_post`、または[証明書によるクライアント認証](#certificate-client-authentication)用の `private_key_jwt`。デフォルトでは、ゲートウェイは IdP が公開している内容から 2 つの `client_secret` 方式のいずれかを選択します。 |93| `token_endpoint_auth_method` | いいえ | ゲートウェイが IdP のトークンエンドポイントに対して認証する方法：`client_secret_basic`、`client_secret_post`、または[証明書によるクライアント認証](#certificate-client-authentication)用の `private_key_jwt`。デフォルトでは、ゲートウェイは IdP が公開している内容から 2 つの `client_secret` 方式のいずれかを選択します。 |

163 フォワードプロキシを通じた IdP リクエスト163 フォワードプロキシを通じた IdP リクエスト

164</h4>164</h4>

165 165

166推論アップストリームはすべてのバージョンで `HTTPS_PROXY` と `HTTP_PROXY` を尊重します。ゲートウェイ独自の IdP、検出、JWKS、トークン、および userinfo へのリクエストは、`oidc.use_proxy: true` を設定しない限り直接です。v2.1.227 以降が必要です。プロキシ変数が設定され、`use_proxy` が設定解除され、発行者が `NO_PROXY` でカバーされていない場合、ゲートウェイはそれらのリクエストを直接に保ち、ブート時に選択するよう求める通知をログに記録します。`use_proxy: false` はそれらを直接に保ち、通知をサイレンスします。166推論アップストリームはすべてのバージョンで `HTTPS_PROXY` と `HTTP_PROXY` を尊重します。ゲートウェイ独自の IdP、検出、JWKS、トークン、および userinfo へのリクエストは、`oidc.use_proxy: true` を設定しない限り直接です。これには v2.1.227 以降が必要です。プロキシ変数が設定され、`use_proxy` が設定されておらず、発行者が `NO_PROXY` でカバーされていない場合、ゲートウェイはそれらのリクエストを直接に保ち、ブート時に選択するよう求める通知をログに記録します。`use_proxy: false` はそれらを直接に保ち、通知を抑止します。

167 167

168`use_proxy: true` の場合、ポッドは各 IdP エンドポイントのホスト名を自身で解決し、プロキシに解決された IP アドレスへの `CONNECT` を要求します。プロキシは、発行者だけでなく、検出ドキュメントが名前を付けるすべてのホストの IP アドレスへの `CONNECT` を受け入れる必要があります。`http://` プロキシ URL を使用します。`ca_cert_pem` と[SSRF ガード](/docs/ja/claude-apps-gateway-deploy#threat-model-summary)はプロキシされたパスにも適用されます。168`use_proxy: true` の場合、ポッドは各 IdP エンドポイントのホスト名を自身で解決し、プロキシに解決された IP アドレスへの `CONNECT` を要求します。プロキシは、発行者だけでなく、検出ドキュメントが名前を付けるすべてのホストの IP アドレスへの `CONNECT` を受け入れる必要があります。`http://` プロキシ URL を使用します。`ca_cert_pem` と [SSRF ガード](/docs/ja/claude-apps-gateway-deploy#threat-model-summary)はプロキシされたパスにも適用されます。

169 169

170[プロキシのみのエグレス](#proxy-only-egress)はこれらの両方を変更します。アクティブな場合、IdP リクエストは `use_proxy: false` を設定しない限りプロキシに従い、ゲートウェイは最初にそれを解決せずにプロキシに各 IdP ホスト名を渡します。170[プロキシのみのエグレス](#proxy-only-egress)はこれらの両方を変更します。アクティブな場合、IdP リクエストは `use_proxy: false` を設定しない限りプロキシに従い、ゲートウェイは最初にそれを解決せずにプロキシに各 IdP ホスト名を渡します。

171 171

173 プロキシのみのエグレス173 プロキシのみのエグレス

174</h4>174</h4>

175 175

176ゲートウェイの環境で `HTTPS_PROXY` の隣に `CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1` を設定します。ポッドがそのフォワードプロキシを通じてのみ他のホストに到達でき、パブリック DNS 名を自身で解決できない場合、またはプロキシが IP アドレスへの `CONNECT` を拒否する場合。v2.1.277 以降が必要です。これは `gateway.yaml` キーではなく環境変数です。設定ファイルの何もゲートウェイのアドレスチェックを緩和できないようにするためです。176ポッドがそのフォワードプロキシを通じてのみ他のホストに到達でき、パブリック DNS 名を自身で解決できない場合、またはプロキシが IP アドレスへの `CONNECT` を拒否する場合は、ゲートウェイの環境で `HTTPS_PROXY` の隣に `CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1` を設定します。v2.1.277 以降が必要です。これは `gateway.yaml` キーではなく環境変数です。設定ファイルの何もゲートウェイのアドレスチェックを緩和できないようにするためです。

177 177

178```bash theme={null}178```bash theme={null}

179export HTTPS_PROXY=http://proxy.corp.example.com:3128179export HTTPS_PROXY=http://proxy.corp.example.com:3128

184 184

185ゲートウェイはプロキシのみのエグレスがアクティブな場合、ブート時に 1 つの `network:` 行をログに記録します。185ゲートウェイはプロキシのみのエグレスがアクティブな場合、ブート時に 1 つの `network:` 行をログに記録します。

186 186

187以下の各行は、`HTTPS_PROXY` が設定されたゲートウェイ上の 1 つのクラスのアウトバウンドリクエストです。デフォルトおよびプロキシのみのエグレスがアクティブな場合。187以下の各行は、`HTTPS_PROXY` が設定されたゲートウェイ上の 1 つのクラスのアウトバウンドリクエストについて、デフォルトの場合とプロキシのみのエグレスがアクティブな場合の動作を示します。

188 188

190| - | - | - |190| - | - | - |

191| `provider: anthropic` アップストリーム、Workload Identity Federation トークン交換、`telemetry.forward_to` エクスポート | ローカルで解決およびチェックされ、その後、プロキシを通じてチェックされた IP アドレスへの `CONNECT`。`NO_PROXY` にリストされたテレメトリコレクターは代わりに直接到達します | プロキシに渡されたホスト名 |191| `provider: anthropic` アップストリーム、Workload Identity Federation トークン交換、`telemetry.forward_to` エクスポート | ローカルで解決およびチェックされ、その後、プロキシを通じてチェックされた IP アドレスへの `CONNECT`。`NO_PROXY` にリストされたテレメトリコレクターは代わりに直接到達します | ホスト名がプロキシに渡されます |

192| IdP 検出、JWKS、トークン、および userinfo | [`oidc.use_proxy: true`](#idp-requests-through-a-forward-proxy) でない限り直接。その後、チェックされた IP アドレスへの `CONNECT` | ホスト名がプロキシに渡されます。ただし、`oidc.use_proxy: false` は内部 IdP を直接に保ちます |192| IdP 検出、JWKS、トークン、および userinfo | [`oidc.use_proxy: true`](#idp-requests-through-a-forward-proxy) でない限り直接。その場合はチェックされた IP アドレスへの `CONNECT` | ホスト名がプロキシに渡されます。ただし、`oidc.use_proxy: false` は内部 IdP を直接に保ちます |

194 194

195プロキシのみのエグレスは、ゲートウェイの環境がこれら 3 つの条件をすべて満たさない限り、オフのままです：195プロキシのみのエグレスは、ゲートウェイの環境がこれら 3 つの条件をすべて満たさない限り、オフのままです：

200 200

201これらの条件のいずれかが満たされていない場合、ゲートウェイはブート時に警告をログに記録し、それを停止した変数に名前を付け、デフォルトの動作を保ちます。201これらの条件のいずれかが満たされていない場合、ゲートウェイはブート時に警告をログに記録し、それを停止した変数に名前を付け、デフォルトの動作を保ちます。

202 202

203プロキシのみのエグレスがアクティブになったら、内部コレクターと IP アドレスで設定されたホストを含む、プロキシ内のすべての宛先を許可します。[`oidc.use_proxy: false`](#idp-requests-through-a-forward-proxy) で内部 IdP を直接に保つことができます。203プロキシのみのエグレスがアクティブになったら、内部コレクターと IP アドレスで設定されたホストを含む、プロキシ内のすべての宛先を許可します。[`oidc.use_proxy: false`](#idp-requests-through-a-forward-proxy) で内部 IdP を直接に保つことは引き続き可能です。

204 204

205<Warning>205<Warning>

206 これをオンにするのは、プロキシのアローリストがゲートウェイ独自のチェック以上に厳密な場合のみです。プロキシは `169.254.169.254` や `metadata.google.internal` などのクラウドメタデータエンドポイント、リンクローカルアドレス、およびプロキシホスト独自のループバックを拒否する必要があります。また、名前だけでなく、名前が解決するアドレスによってそれらを拒否する必要があります。ゲートウェイはもはやそれらのいずれかに解決するホスト名をキャッチしないためです。どこでも接続するプロキシは、これらのリクエストのゲートウェイの[SSRF ガード](/docs/ja/claude-apps-gateway-deploy#threat-model-summary)を削除します。206 これをオンにするのは、プロキシの許可リストがゲートウェイ独自のチェック以上に厳密な場合のみです。プロキシは `169.254.169.254` や `metadata.google.internal` などのクラウドメタデータエンドポイント、リンクローカルアドレス、およびプロキシホスト独自のループバックを拒否する必要があります。また、名前だけでなく、名前が解決するアドレスによってそれらを拒否する必要があります。ゲートウェイはもはやそれらのいずれかに解決するホスト名をキャッチしないためです。要求された場所にどこでも接続するプロキシは、これらのリクエストに対するゲートウェイの [SSRF ガード](/docs/ja/claude-apps-gateway-deploy#threat-model-summary)を無効にします。

207</Warning>207</Warning>

208 208

209<h3 id="session">209<h3 id="session">

210 `session`210 `session`

211</h3>211</h3>

212 212

213`session` ブロックは、ゲートウェイがサインイン後に鋳造するベアラートークンを形成します。それらに署名するシークレットと、どのくらい長く生きるかです。213`session` ブロックは、ゲートウェイがサインイン後に発行するベアラートークンを定義します。トークンに署名するシークレットと、その有効期間です。

214 214

215| フィールド | 必須 | 説明 |215| フィールド | 必須 | 説明 |

216| - | - | - |216| - | - | - |

217| `jwt_secret` | はい | 少なくとも 32 バイトのエントロピー。例えば `openssl rand -base64 32` から。ゲートウェイの HS256 ベアラートークンに署名します。単一の文字列または回転用の配列を受け入れます。インデックス 0 が署名し、すべてのエントリが検証します。回転するには、新しいシークレットを先頭に追加し、`ttl_hours` を待ってから古いものを削除します。 |217| `jwt_secret` | はい | 少なくとも 32 バイトのエントロピー。例えば `openssl rand -base64 32` から。ゲートウェイの HS256 ベアラートークンに署名します。単一の文字列またはローテーション用の配列を受け入れます。インデックス 0 が署名し、すべてのエントリが検証します。ローテーションするには、新しいシークレットを先頭に追加し、`ttl_hours` を待ってから古いものを削除します。 |

218| `ttl_hours` | いいえ | ゲートウェイベアラートークンの有効期間。デフォルト `1`。IdP がリフレッシュトークンを発行する場合、CLI は有効期限前に自動的にリフレッシュします。有効期間が短いほど、より速くプロビジョニング解除されます。長いほど、IdP ラウンドトリップが少なくなります。IdP が `offline_access` が利用できないためリフレッシュトークンを発行できない場合、サイレントリフレッシュはないため、これを `8` または `12` に上げて、開発者を 1 時間ごとにブラウザログインに戻すのを避けてください。 |218| `ttl_hours` | いいえ | ゲートウェイベアラートークンの有効期間。デフォルト `1`。IdP がリフレッシュトークンを発行する場合、CLI は有効期限前に自動的にリフレッシュします。有効期間が短いほど、より速くプロビジョニング解除されます。長いほど、IdP ラウンドトリップが少なくなります。IdP が `offline_access` が利用できないためリフレッシュトークンを発行できない場合、サイレントリフレッシュはないため、これを `8` または `12` に上げて、開発者を 1 時間ごとにブラウザログインに戻すのを避けてください。 |

219 219

220<h3 id="store">220<h3 id="store">

221 `store`221 `store`

222</h3>222</h3>

223 223

224`store` ブロックはゲートウェイを PostgreSQL データベースに指します。デバイスグラントとレート制限カウンターを保持します。224`store` ブロックはゲートウェイを PostgreSQL データベースに向けます。このデータベースはデバイスグラントとレート制限カウンターを保持します。

225 225

226| フィールド | 必須 | 説明 |226| フィールド | 必須 | 説明 |

227| - | - | - |227| - | - | - |

228| `postgres_url` | はい | `postgres://` または `postgresql://` URL。必須：デバイスグラント集合。ブラウザコールバックが書き込み、ポーリング CLI が読み込む場所。レプリカ間の状態が必要です。ゲートウェイはブート時およびアップグレード時に独自のスキーママイグレーションを実行するため、ロールはターゲットスキーマでテーブルを作成および変更する権限が必要です。[アップグレード](/docs/ja/claude-apps-gateway-deploy#upgrades)および [Postgres](/docs/ja/claude-apps-gateway-deploy#postgres) を参照してください。 |228| `postgres_url` | はい | `postgres://` または `postgresql://` URL。必須：ブラウザコールバックが書き込み、ポーリング中の CLI が読み込むデバイスグラントのランデブーには、レプリカ間の状態が必要です。ゲートウェイはブート時およびアップグレード時に独自のスキーママイグレーションを実行するため、ロールはターゲットスキーマでテーブルを作成および変更する権限が必要です。[アップグレード](/docs/ja/claude-apps-gateway-deploy#upgrades)および [Postgres](/docs/ja/claude-apps-gateway-deploy#postgres) を参照してください。 |

229| `username` | いいえ | `postgres_url` のユーザーをオーバーライドします |229| `username` | いいえ | `postgres_url` のユーザーを上書きします |

230| `password` | いいえ | データベース認証情報。`postgres_url` ではなくここに設定して、認証情報を URL から外します。任意の文字を受け入れ、URL 認証情報よりも優先されます。 |230| `password` | いいえ | データベース認証情報。`postgres_url` ではなくここに設定して、認証情報を URL から外します。任意の文字を受け入れ、URL 認証情報よりも優先されます。 |

231| `max_connections` | いいえ | レプリカあたりの Postgres 接続プールサイズ。デフォルト `5`。保守的で共有データベースに優しいです。[支出制限](#admin)が有効な場合、ホットパスは推論リクエストごとに数回の操作を実行するため、専用データベースが負荷の下にある場合はこれを上げ、レプリカ × これをデータベースの `max_connections` 以下に保ちます。 |231| `max_connections` | いいえ | レプリカあたりの Postgres 接続プールサイズ。デフォルト `5`。保守的で共有データベースに優しいです。[支出制限](#admin)が有効な場合、ホットパスは推論リクエストごとに数回の操作を実行するため、専用データベースが負荷の下にある場合はこれを上げ、レプリカ数 × この値をデータベースの `max_connections` 以下に保ちます。 |

232| `connect_timeout_seconds` | いいえ | ゲートウェイが Postgres 接続を開くときに待機する秒数。`1` から `60` の整数。デフォルト `5`。新しいゲートウェイインスタンスが起動するときに接続試行がタイムアウトする場合は、これを上げてください。ゲートウェイサーバーで Claude Code v2.1.274 以降が必要です。以前のバージョンはキーが設定されている場合、起動を拒否します。 |232| `connect_timeout_seconds` | いいえ | ゲートウェイが Postgres 接続を開くときに待機する秒数。`1` から `60` の整数。デフォルト `5`。新しいゲートウェイインスタンスが起動するときに接続試行がタイムアウトする場合は、これを上げてください。ゲートウェイサーバーで Claude Code v2.1.274 以降が必要です。以前のバージョンはキーが設定されている場合、起動を拒否します。 |

233| `readiness_grace_seconds` | いいえ | Postgres が応答を停止した後、`/readyz` が準備完了を報告し続ける秒数。`0` から `3600` の整数。デフォルト `0`。値を選択する方法については、[停止動作](/docs/ja/claude-apps-gateway-deploy#outage-behavior)を参照してください。ゲートウェイサーバーで Claude Code v2.1.282 以降が必要です。以前のバージョンはキーが設定されている場合、起動を拒否します。 |233| `readiness_grace_seconds` | いいえ | Postgres が応答を停止した後、`/readyz` が準備完了を報告し続ける秒数。`0` から `3600` の整数。デフォルト `0`。値を選択する方法については、[停止動作](/docs/ja/claude-apps-gateway-deploy#outage-behavior)を参照してください。ゲートウェイサーバーで Claude Code v2.1.282 以降が必要です。以前のバージョンはキーが設定されている場合、起動を拒否します。 |

234 234

235ローカル開発の場合、`postgres_url` を使い捨て Postgres コンテナに指します。例えば `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`。235ローカル開発の場合、`postgres_url` を使い捨て Postgres コンテナに向けます。例えば `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`。

236 236

237<h3 id="upstreams">237<h3 id="upstreams">

238 `upstreams`238 `upstreams`

240 240

241`upstreams` は順序付きリストです。ゲートウェイは、要求されたモデルを解決する最初のアップストリームに推論を転送します。241`upstreams` は順序付きリストです。ゲートウェイは、要求されたモデルを解決する最初のアップストリームに推論を転送します。

242 242

243`5xx`、`429`、`401`、`403`、`404`、またはタイムアウト時に、ゲートウェイは次のアップストリームにフェイルオーバーします。他の `4xx` はそうしません。これらのエラーはリクエストではなくアップストリームに起因するためです。`401` または `403` は、ゲートウェイがそのアップストリームに対して使用した認証情報が失敗したことを意味します。`404` はそのアップストリームが要求されたモデルを提供しないことを意味するため、リスト内の後のアップストリームはまだできます。243`5xx`、`429`、`401`、`403`、`404`、またはタイムアウト時に、ゲートウェイは次のアップストリームにフェイルオーバーします。他の `4xx` ではフェイルオーバーしません。これらのエラーはアップストリームではなくリクエストに起因するためです。`401` または `403` は、ゲートウェイが使用した認証情報をアップストリームが拒否したか、例えば要求されたモデルへのアクセスを拒否したことを意味します。`404` はそのアップストリームが要求されたモデルを提供しないことを意味するため、リスト内の後のアップストリームがまだ提供できます。

244 244

245アップストリームで `forward_user_identity: true` を設定する場合、開発者のメールを含むリクエストに返す `429` はフェイルオーバーしません。[開発者がどのように per-user 制限拒否に到達するか](#per-user-identity-headers-for-a-proxy-you-run)を参照してください。245アップストリームで `forward_user_identity: true` を設定する場合、開発者のメールを含むリクエストに対してそのアップストリームが返す `429` はフェイルオーバーしません。[ユーザーごとの制限による拒否が開発者にどう届くか](#per-user-identity-headers-for-a-proxy-you-run)を参照してください。

246 246

247`404` でのフェイルオーバーにはゲートウェイ v2.1.198 以降が必要です。以前のリリースは、リスト内の後のアップストリームがモデルを提供している場合でも、最初の `404` をクライアントに返しました。247`404` でのフェイルオーバーにはゲートウェイ v2.1.198 以降が必要です。以前のリリースは、リスト内の後のアップストリームがモデルを提供している場合でも、最初の `404` をクライアントに返しました。

248 248

254 アップストリームエラーメッセージ254 アップストリームエラーメッセージ

255</h4>255</h4>

256 256

257ゲートウェイは、アップストリームがどのように応答したかに応じて、1 つのアップストリームのエラー応答またはそれ独自の `502` を返します：257ゲートウェイは、アップストリームがどのように応答したかに応じて、1 つのアップストリームのエラーレスポンスまたはそれ独自の `502` を返します：

258 258

259* **ゲートウェイが[フェイルオーバー](#multiple-upstreams)しないステータスをアップストリームが返した**：そのアップストリームの応答。ゲートウェイはさらなるアップストリームを試みません。259* **ゲートウェイが[フェイルオーバー](#multiple-upstreams)しないステータスをアップストリームが返した**：そのアップストリームのレスポンス。ゲートウェイはそれ以上のアップストリームを試みません。

260* **ゲートウェイが試みたすべてのアップストリームが[フェイルオーバー](#multiple-upstreams)する方法で失敗した**：最後の `429`。いずれも `429` を返さなかった場合、ゲートウェイは順に、最後の `401` または `403`、最後の `404`、最後の `501` を優先します。いずれも返さなかった場合、ゲートウェイ独自の `502`。`all upstreams failed (N attempted)`。N は [`upstreams`](#upstreams) のすべてのエントリをカウントします。要求されたモデルを提供しないためゲートウェイがスキップしたエントリを含みます。260* **ゲートウェイが試みたすべてのアップストリームが[フェイルオーバー](#multiple-upstreams)する方法で失敗した**：最後の `429`。いずれも `429` を返さなかった場合、ゲートウェイは順に、最後の `401` または `403`、最後の `404`、最後の `501` を優先します。いずれも返さなかった場合、ゲートウェイ独自の `502`。`all upstreams failed (N attempted)`。N は [`upstreams`](#upstreams) のすべてのエントリをカウントします。要求されたモデルを提供しないためゲートウェイがスキップしたエントリを含みます。

261 261

262ゲートウェイがアップストリームの応答を返す場合、アップストリームのステータスコードを保ちます。アップストリームのメッセージを保つかどうかはプロバイダーに依存します。Anthropic API アップストリームのエラー本体は開発者に変更されずに到達します。262ゲートウェイがアップストリームのレスポンスを返す場合、アップストリームのステータスコードを保ちます。アップストリームのメッセージを保つかどうかはプロバイダーに依存します。Anthropic API アップストリームのエラー本体は変更されずに開発者に届きます。

263 263

264Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、および Microsoft Foundry アップストリームは、エラーテキストでアカウント ID、ロール ARN、およびプロジェクト ID に名前を付けることができます。ゲートウェイはその完全なテキストを[運用ログ](/docs/ja/claude-apps-gateway-deploy#logs)に記録します。開発者がこれらのアップストリームから見るものは、拒否に依存します：264Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、および Microsoft Foundry アップストリームは、エラーテキストでアカウント ID、ロール ARN、およびプロジェクト ID に名前を付けることがあります。ゲートウェイはその完全なテキストを[運用ログ](/docs/ja/claude-apps-gateway-deploy#logs)に記録します。開発者がこれらのアップストリームから見るものは、拒否の種類に依存します：

265 265

266* Anthropic の標準エラーエンベロープの `400` または `413`：`prompt is too long` などのアップストリーム独自のメッセージ。Claude Platform on AWS、Agent Platform、および Microsoft Foundry はモデル API 拒否のためこのエンベロープを返します。266* Anthropic の標準エラーエンベロープの `400` または `413`：`prompt is too long` などのアップストリーム独自のメッセージ。Claude Platform on AWS、Agent Platform、および Microsoft Foundry はモデル API の拒否に対してこのエンベロープを返します。

267* プロバイダー独自の形状の `400` または `413`：`capability_rejected:` トークン。ゲートウェイが拒否を分類できない場合、`400` で `upstream rejected the request` または `413` で `request too large for this upstream`。267* プロバイダー独自の形式の `400` または `413`：`capability_rejected:` トークン。ゲートウェイが拒否を分類できない場合、`400` で `upstream rejected the request` または `413` で `request too large for this upstream`。

268* その他のステータス：`429` で `upstream rate limit exceeded` などのステータスごとの汎用コピー。268* その他のステータス：`429` で `upstream rate limit exceeded` などのステータスごとの汎用文言。

269 269

270例えば、ゲートウェイは Amazon Bedrock の `Input is too long for requested model.` を `capability_rejected: prompt_too_long` に置き換えます。Claude Code は `prompt is too long` と同様に、そのトークンで[自動的にコンパクト](/docs/ja/errors#prompt-is-too-long)にします。270例えば、ゲートウェイは Amazon Bedrock の `Input is too long for requested model.` を `capability_rejected: prompt_too_long` に置き換えます。Claude Code は `prompt is too long` と同様に、そのトークンで[自動的にコンパクト](/docs/ja/errors#prompt-is-too-long)にします。

271 271

311 実行するプロキシの per-user アイデンティティヘッダー311 実行するプロキシの per-user アイデンティティヘッダー

312</h5>312</h5>

313 313

314`provider: anthropic` アップストリームの `base_url` を Anthropic API ではなく実行するプロキシに指すことができます。そのプロキシに各リクエストを送信した開発者を伝えるには、そのアップストリームで `forward_user_identity: true` を設定します。プロキシはその後、開発者ごとに支出を属性付けることができます。Claude Code v2.1.233 以降を実行しているゲートウェイが必要です。314`provider: anthropic` アップストリームの `base_url` を Anthropic API ではなく実行するプロキシに向けることができます。そのプロキシに各リクエストを送信した開発者を伝えるには、そのアップストリームで `forward_user_identity: true` を設定します。プロキシはその後、開発者ごとに支出を帰属させることができます。Claude Code v2.1.233 以降を実行しているゲートウェイが必要です。

315 315

316例えば、`upstream-gateway.internal.example.com` のプロキシの場合：316例えば、`upstream-gateway.internal.example.com` のプロキシの場合：

317 317

334 334

335IdP トークンがメールを含まない場合、ゲートウェイは `x-claude-gateway-user-id` のみを送信し、2 つのメールヘッダーを省略します。IdP がメールを別のクレームに入れる場合、[`oidc.email_claim`](#oidc) をそのクレームに設定します。335IdP トークンがメールを含まない場合、ゲートウェイは `x-claude-gateway-user-id` のみを送信し、2 つのメールヘッダーを省略します。IdP がメールを別のクレームに入れる場合、[`oidc.email_claim`](#oidc) をそのクレームに設定します。

336 336

337プロキシが開発者のメールを含むリクエストに `429` で応答する場合、ゲートウェイはその応答を開発者にそのまま返し、次のアップストリームにフェイルオーバーしません。プロキシの per-user 予算またはレート制限が保持されます。プロキシの他の応答は通常の[フェイルオーバールール](#upstreams)に従います。開発者の IdP トークンがメールを含まない場合、ゲートウェイはメールヘッダーなしでリクエストを転送するため、そのようなリクエストへの `429` はアップストリーム容量としてカウントされ、フェイルオーバーします。ゲートウェイサーバーの v2.1.267 より前では、すべての `429` がフェイルオーバーしました。337プロキシが開発者のメールを含むリクエストに `429` で応答する場合、ゲートウェイはそのレスポンスを開発者にそのまま返し、次のアップストリームにフェイルオーバーしません。これにより、プロキシのユーザーごとの予算またはレート制限が維持されます。プロキシの他のレスポンスは通常の[フェイルオーバールール](#upstreams)に従います。開発者の IdP トークンがメールを含まない場合、ゲートウェイはメールヘッダーなしでリクエストを転送するため、そのようなリクエストへの `429` はアップストリーム容量としてカウントされ、フェイルオーバーします。ゲートウェイサーバーの v2.1.267 より前では、すべての `429` がフェイルオーバーしました。

338 338

339`forward_user_identity` は、`base_url` が実行するプロキシであるアップストリームにのみ設定します。ゲートウェイは開発者メールを、その `base_url` が名前を付けるサーバーに送信します。`base_url` が Anthropic API（デフォルト）の場合、ゲートウェイは起動を拒否します。339`forward_user_identity` は、`base_url` が運用するプロキシであるアップストリームにのみ設定します。ゲートウェイは開発者メールを、その `base_url` が名前を付けるサーバーに送信します。`base_url` が Anthropic API（デフォルト）の場合、ゲートウェイは起動を拒否します。

340 340

341<h4 id="amazon-bedrock">341<h4 id="amazon-bedrock">

342 Amazon Bedrock342 Amazon Bedrock

343</h4>343</h4>

344 344

345クライアント側の Amazon Bedrock デプロイメント（ゲートウェイが置き換えるか前に置く）については、[Claude Code on Amazon Bedrock](/docs/ja/amazon-bedrock) を参照してください。ゲートウェイ側のアップストリーム：345ゲートウェイが置き換える、または前段に置くクライアント側の Amazon Bedrock デプロイについては、[Claude Code on Amazon Bedrock](/docs/ja/amazon-bedrock) を参照してください。ゲートウェイ側のアップストリーム：

346 346

347```yaml theme={null}347```yaml theme={null}

348upstreams:348upstreams:

363 363

364空の `auth` ブロックは AWS SDK のデフォルト認証情報チェーンを使用します：環境変数、`~/.aws/credentials`、ECS タスクロール、EC2 インスタンスメタデータ、または EKS 上の IRSA。本番環境では、コンテナイメージに静的キーを埋め込む代わりに、ゲートウェイポッドに IAM ロールを与えます。364空の `auth` ブロックは AWS SDK のデフォルト認証情報チェーンを使用します：環境変数、`~/.aws/credentials`、ECS タスクロール、EC2 インスタンスメタデータ、または EKS 上の IRSA。本番環境では、コンテナイメージに静的キーを埋め込む代わりに、ゲートウェイポッドに IAM ロールを与えます。

365 365

366明示的な認証情報は完全である必要があります。`aws_access_key_id` と `aws_secret_access_key` が一緒に設定されていない場合、または `aws_session_token` が設定されていない場合、ゲートウェイはブート時に失敗します。v2.1.207 より前では、部分的な `auth:` ブロックが検証に合格しました。366明示的な認証情報は完全である必要があります。`aws_access_key_id` と `aws_secret_access_key` が一緒に設定されていない場合、または `aws_session_token` がそれらなしで設定されている場合、ゲートウェイはブート時に失敗します。v2.1.207 より前では、部分的な `auth:` ブロックが検証に合格しました。

367 367

368| セットアップ | 方法 |368| セットアップ | 方法 |

369| - | - |369| - | - |

370| IAM 権限 | ゲートウェイのプリンシパルに `bedrock:InvokeModel` と `bedrock:InvokeModelWithResponseStream` を推論プロファイル ARN と基礎モデル ARN の両方に付与します。US リージョンの組み込みカタログの場合：`arn:aws:bedrock:<region>:<account>:inference-profile/us.anthropic.*` と `arn:aws:bedrock:*::foundation-model/anthropic.*`。また、基礎モデル ARN に `bedrock:CountTokens` を付与します。ゲートウェイはそれを使用して、クライアントが放棄したリクエストの入力トークンをカウントします。無料です。[支出制限](#admin)が正確に保たれるようにするためです。これなしでは、ゲートウェイはそのカウントのための 1 トークン Bedrock リクエストにフォールバックします。 |370| IAM 権限 | ゲートウェイのプリンシパルに `bedrock:InvokeModel` と `bedrock:InvokeModelWithResponseStream` を推論プロファイル ARN と基礎モデル ARN の両方に付与します。US リージョンの組み込みカタログの場合：`arn:aws:bedrock:<region>:<account>:inference-profile/us.anthropic.*` と `arn:aws:bedrock:*::foundation-model/anthropic.*`。また、基礎モデル ARN に `bedrock:CountTokens` を付与します。ゲートウェイはこれを無料で使用して、クライアントが放棄したリクエストの入力トークンをカウントし、[支出制限](#admin)を正確に保ちます。これがない場合、ゲートウェイはそのカウントのために 1 トークンの Bedrock リクエストにフォールバックします。 |

371| モデルアクセス | Amazon Bedrock はデフォルトで商用リージョンでモデルアクセスを有効にします。残りのアカウントレベルゲートは Anthropic のワンタイムユースケースフォームです。AWS アカウント内の誰もそれを送信していない場合、Amazon Bedrock コンソールを開き、モデルカタログから Anthropic モデルを選択し、フォームを完成させます。AWS Organizations フォームと送信者が必要な権限については、[ユースケース詳細を送信](/docs/ja/amazon-bedrock#1-submit-use-case-details)を参照してください。 |371| モデルアクセス | Amazon Bedrock はデフォルトで商用リージョンでモデルアクセスを有効にします。残りのアカウントレベルのゲートは Anthropic のワンタイムユースケースフォームです。AWS アカウント内の誰もそれを送信していない場合、Amazon Bedrock コンソールを開き、モデルカタログから Anthropic モデルを選択し、フォームを完成させます。AWS Organizations フォームと送信者が必要な権限については、[ユースケース詳細を送信](/docs/ja/amazon-bedrock#1-submit-use-case-details)を参照してください。 |

372| EKS（IRSA） | クラスターの OIDC プロバイダーにスコープされたゲートウェイのサービスアカウントの信頼ポリシーを持つ IAM ロールを作成します。サービスアカウントに `eks.amazonaws.com/role-arn: arn:aws:iam::<acct>:role/claude-gateway` で注釈を付けます。`auth: {}` がそれを取得します。 |372| EKS（IRSA） | 上記のポリシーと、ゲートウェイのサービスアカウントにスコープされたクラスターの OIDC プロバイダー用の信頼ポリシーを持つ IAM ロールを作成します。サービスアカウントに `eks.amazonaws.com/role-arn: arn:aws:iam::<acct>:role/claude-gateway` で注釈を付けます。`auth: {}` がそれを取得します。 |

373| ECS / EC2 | IAM ロールをタスク定義またはインスタンスプロファイルにアタッチします。`auth: {}` がそれを取得します。 |373| ECS / EC2 | IAM ロールをタスク定義またはインスタンスプロファイルにアタッチします。`auth: {}` がそれを取得します。 |

374| その他の場所 | `AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、および `AWS_SESSION_TOKEN` 環境変数を通じて認証情報を渡すか、`${VAR}` 展開で `auth:` に明示的に設定します |374| その他の場所 | `AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、および `AWS_SESSION_TOKEN` 環境変数を通じて認証情報を渡すか、`${VAR}` 展開で `auth:` に明示的に設定します |

375| リージョン | `region:` は API エンドポイントリージョンです。クロスリージョン推論プロファイルは、どれを選択するかに関わらず、地理（US、EU、APAC）全体でルーティングします。US 以外のリージョンまたはプロビジョニングされたスループット ARN の場合、正しい per-upstream ID を持つ [`models:`](#models) ブロックを追加します。 |375| リージョン | `region:` は API エンドポイントリージョンです。クロスリージョン推論プロファイルは、どれを選択するかに関わらず、地理（US、EU、APAC）全体でルーティングします。US 以外のリージョンまたはプロビジョニングされたスループット ARN の場合、正しい per-upstream ID を持つ [`models:`](#models) ブロックを追加します。 |

392```392```

393 393

394<Warning>394<Warning>

395 ゲートウェイはガードレール入力タグをサポートしていません。プロンプトにガードコンテンツタグを追加しないため、Amazon Bedrock がタグ付き入力にのみ適用するガードレールフィルターはゲートウェイを通じたトラフィックで実行されません。入力タグに依存するフィルターについては、Amazon Bedrock ドキュメントの[入力タグ](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-tagging.html)を参照してください。395 ゲートウェイはガードレール入力タグをサポートしていません。プロンプトにガードコンテンツタグを追加しないため、Amazon Bedrock がタグ付き入力にのみ適用するガードレールフィルターはゲートウェイを通じたトラフィックで実行されません。入力タグに依存するフィルターについては、Amazon Bedrock ドキュメントの[入力タグ](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-tagging.html)を参照してください。

396</Warning>396</Warning>

397 397

398また、このアップストリームのリクエストに署名するプリンシパル（ゲートウェイの AWS プリンシパル、または [`assume_role`](#bedrock-in-another-aws-account) で `role_arn` に名前を付けたロール）にガードレールで `bedrock:ApplyGuardrail` を付与します。398また、このアップストリームのリクエストに署名するプリンシパル（ゲートウェイの AWS プリンシパル、または [`assume_role`](#bedrock-in-another-aws-account) を使用する場合は `role_arn` で指定したロール）に、そのガードレールに対する `bedrock:ApplyGuardrail` を付与します。

399 399

400すべての `bedrock` アップストリームで `guardrail` を設定するか、どれにも設定しないでください。ゲートウェイは混合で起動を拒否します。[フェイルオーバー](#multiple-upstreams)がリクエストをガードレールのない Bedrock アップストリームに送信する可能性があるためです。400すべての `bedrock` アップストリームで `guardrail` を設定するか、どれにも設定しないでください。ゲートウェイは混在した設定では起動を拒否します。そうしないと、[フェイルオーバー](#multiple-upstreams)によってリクエストがガードレールのない Bedrock アップストリームに送信される可能性があるためです。

401 401

402ガードレールは Bedrock アップストリームのみをカバーします。`upstreams` に別のプロバイダーをリストする場合、ゲートウェイはガードレールなしでそのプロバイダーにリクエストを送信します。402ガードレールは Bedrock アップストリームのみをカバーします。`upstreams` に別のプロバイダーをリストする場合、ゲートウェイはガードレールなしでそのプロバイダーにリクエストを送信します。ただし、そのプロバイダーが [`mantle`](#amazon-bedrock-mantle-endpoint) の場合は起動を拒否します。

403 403

404`/v1/messages` リクエストの本体が `amazon-bedrock-guardrailConfig` などの `amazon-bedrock-*` フィールドを含む場合、ガードレールセットを持つ Bedrock アップストリームに到達すると、ゲートウェイは 400 で応答し、転送しません。404本体に `amazon-bedrock-guardrailConfig` などの `amazon-bedrock-*` フィールドを含む `/v1/messages` リクエストが、`guardrail` が設定された Bedrock アップストリームに到達すると、ゲートウェイはそれを転送せずに 400 で応答します。

405 405

406<a id="bedrock-in-another-aws-account" />406<a id="bedrock-in-another-aws-account" />

407 407

409 別の AWS アカウントの Bedrock409 別の AWS アカウントの Bedrock

410</h5>410</h5>

411 411

412Bedrock アップストリームで `assume_role` を設定し、ゲートウェイは独自の AWS アイデンティティを使用して、名前を付けたロールで `sts:AssumeRole` を呼び出すだけです。別の AWS アカウントにある可能性があります。そのアップストリームからのすべての Bedrock リクエストは、STS が返す 1 時間の認証情報で署名されるため、長期アクセスキーはアカウント間を通過しません。412Bedrock アップストリームで `assume_role` を設定すると、ゲートウェイは独自の AWS アイデンティティを、指定したロールに対して `sts:AssumeRole` を呼び出すためだけに使用します。このロールはゲートウェイとは別の AWS アカウントにあってもかまいません。そのアップストリームからのすべての Bedrock リクエストは、STS が返す 1 時間有効の認証情報で署名されるため、長期アクセスキーがアカウント間を行き来することはありません。

413 413

414Claude Code v2.1.281 以降を実行しているゲートウェイが必要です。以前のゲートウェイはキーを見つけたときに起動を拒否します。414Claude Code v2.1.281 以降を実行しているゲートウェイが必要です。以前のゲートウェイはキーを見つけたときに起動を拒否します。

415 415

428 428

429| キー | 意味 |429| キー | 意味 |

430| - | - |430| - | - |

431| `role_arn` | ゲートウェイが想定する IAM ロール。`arn:aws:iam::` または `arn:aws-us-gov:iam::` ARN として。このアップストリームが必要とする [Bedrock 権限](#amazon-bedrock)、`bedrock:CountTokens` を含む、およびアップストリームが `guardrail` を設定する場合は `bedrock:ApplyGuardrail` を与えます。 |431| `role_arn` | ゲートウェイが引き受ける IAM ロール。`arn:aws:iam::` または `arn:aws-us-gov:iam::` ARN として指定します。このアップストリームが必要とする [Bedrock 権限](#amazon-bedrock)（`bedrock:CountTokens` を含む）と、アップストリームが `guardrail` を設定する場合は `bedrock:ApplyGuardrail` を与えます。 |

433| `session_name` | オプション。`email` または `sub` は各開発者に独自のセッションを与えます。[Per-developer AWS コスト属性](#per-developer-aws-cost-attribution)を参照してください。設定解除されている場合、すべてのリクエストは `claude-apps-gateway` という名前の 1 つのセッションを使用します。 |433| `session_name` | オプション。`email` または `sub` は各開発者に独自のセッションを与えます。[Per-developer AWS コスト属性](#per-developer-aws-cost-attribution)を参照してください。設定されていない場合、すべてのリクエストは `claude-apps-gateway` という名前の 1 つのセッションを使用します。 |

434 434

435ロールの信頼ポリシーはゲートウェイ独自のプリンシパル（IRSA または ECS タスクロールなど）に名前を付けます。そのプリンシパルはロールで `sts:AssumeRole` が必要で、Bedrock 権限はありません。`external_id` を設定しない場合は `Condition` を削除します。435ロールの信頼ポリシーはゲートウェイ独自のプリンシパル（IRSA または ECS タスクロールなど）に名前を付けます。そのプリンシパルはロールに対する `sts:AssumeRole` が必要で、自身の Bedrock 権限は不要です。`external_id` を設定しない場合は `Condition` を削除します。

436 436

437```json theme={null}437```json theme={null}

438{438{

446}446}

447```447```

448 448

449* STS が拒否または到達不可の場合、ゲートウェイはアップストリーム独自の認証情報でリクエストを送信しません。STS エラーをログに記録し、何をチェックするかを記録してから、リストした次のアップストリームを試みます。[アップストリームエラーメッセージ](#upstream-error-messages)は、アップストリームが成功しない場合にクライアントが受け取るものをカバーしています。`assume_role` のない後のアップストリームはそれ独自の認証情報でリクエストを提供するため、それが望むものの場合のみリストします。449* STS が拒否または到達不可の場合、ゲートウェイはアップストリーム独自の認証情報でリクエストを送信しません。STS エラーを確認すべき点とともにログに記録してから、リストした次のアップストリームを試みます。[アップストリームエラーメッセージ](#upstream-error-messages)は、どのアップストリームも成功しない場合にクライアントが受け取るものをカバーしています。`assume_role` のない後のアップストリームはそれ独自の認証情報でリクエストを処理するため、それが望む動作である場合のみリストしてください。

450* ゲートウェイは地域 STS エンドポイント `sts.<region>.amazonaws.com` を呼び出します。ネットワークはそれに到達する必要があります。FIPS エンドポイントの場合、AWS 設定ファイルの `use_fips_endpoint` ではなく、ゲートウェイの環境で `AWS_USE_FIPS_ENDPOINT=true` を設定します。450* ゲートウェイはリージョンの STS エンドポイント `sts.<region>.amazonaws.com` を呼び出すため、ネットワークはそれに到達できる必要があります。FIPS エンドポイントの場合、AWS 設定ファイルの `use_fips_endpoint` ではなく、ゲートウェイの環境で `AWS_USE_FIPS_ENDPOINT=true` を設定します。

451* `assume_role` は `provider: bedrock` にのみ適用され、SigV4 ソース認証情報が必要です。ゲートウェイは `aws_bearer_token` の隣に設定されている場合、起動を拒否します。451* `assume_role` は `provider: bedrock` にのみ適用され、SigV4 ソース認証情報が必要です。ゲートウェイは `aws_bearer_token` と一緒に設定されている場合、起動を拒否します。

452* ゲートウェイが許可するすべての開発者はこのアップストリームを使用できます。[`managed`](#managed) はどの開発者がどのモデルを使用できるかを制御します。ロールを通じて提供されるモデルが別のアカウントからも提供されるのを防ぐには、`upstream_model` マップがこのアップストリームの名前のみを持つカスタム id を与えます。そのような id の場合、ゲートウェイはすべての他のアップストリームをスキップするため、リクエストもそれに到達する放棄されたリクエストのトークンカウントも別のアカウントにフェイルオーバーできません。組み込みモデル名はまだすべてのアップストリームで順に試みられます。これを含みます。そのアカウントもそれらを提供する場合を除き、このアップストリームを最後にリストします。452* ゲートウェイが許可するすべての開発者はこのアップストリームを使用できます。[`managed`](#managed) はどの開発者がどのモデルを使用できるかを制御します。ロールを通じて提供されるモデルが別のアカウントからも提供されるのを防ぐには、`upstream_model` マップにこのアップストリームの名前のみを持つカスタム id をそのモデルに与えます。そのような id の場合、ゲートウェイは他のすべてのアップストリームをスキップするため、リクエストも、中断されたリクエストのトークンカウントも、別のアカウントにフェイルオーバーすることはありません。組み込みモデル名へのリクエストは引き続き[このアップストリームに到達する](#multiple-upstreams)可能性があり、ゲートウェイはそれを同じロールで署名します。このアカウントでもそれらのモデルを提供する場合を除き、このアップストリームを最後にリストしてください。

453 453

454この例は、分離されたアップストリームのみが提供するカスタム id を持つ 1 つのモデルを与えます：454この例は、分離されたアップストリームのみが提供するカスタム id を 1 つのモデルに与えます：

455 455

456```yaml theme={null}456```yaml theme={null}

457models:457models:

466 Per-developer AWS コスト属性466 Per-developer AWS コスト属性

467</h5>467</h5>

468 468

469デフォルトでは、ゲートウェイはすべての Bedrock リクエストに 1 つの認証情報で署名するため、AWS はすべての開発者のリクエストを単一の IAM プリンシパルの下で見ます。[`assume_role`](#bedrock-in-another-aws-account) に `session_name: email` を追加し、ゲートウェイは開発者ごとに 1 時間ごとに `sts:AssumeRole` を呼び出し、セッション名をその開発者のメールに設定し、返された認証情報でリクエストに署名するため、各開発者のリクエストは独自の想定ロールセッションの下で AWS に到達します。ロールはゲートウェイ独自のアカウントにある可能性があります。469デフォルトでは、ゲートウェイはすべての Bedrock リクエストに 1 つの認証情報で署名するため、AWS はすべての開発者のリクエストを単一の IAM プリンシパルの下で見ます。[`assume_role`](#bedrock-in-another-aws-account) に `session_name: email` を追加すると、ゲートウェイは開発者ごとに 1 時間に 1 回 `sts:AssumeRole` を呼び出し、セッション名をその開発者のメールに設定し、返された認証情報でリクエストに署名するため、各開発者のリクエストは独自の引き受けたロールセッションの下で AWS に到達します。ロールはゲートウェイ独自のアカウントにあってもかまいません。

470 470

471Claude Code v2.1.281 以降を実行しているゲートウェイが必要です。[AWS でのコスト属性](/docs/ja/claude-apps-gateway-on-aws#cost-attribution)は IAM ロールと AWS 請求がセッションを表示する場所をカバーしています。471Claude Code v2.1.281 以降を実行しているゲートウェイが必要です。[AWS でのコスト属性](/docs/ja/claude-apps-gateway-on-aws#cost-attribution)は IAM ロールと AWS 請求がセッションを表示する場所をカバーしています。

472 472

480 session_name: email # or sub480 session_name: email # or sub

481```481```

482 482

483`session_name` は、検証されたクレームが AWS `RoleSessionName` になるかを選択します：`email` または `sub`。ゲートウェイは ASCII 文字、数字、および `_+,.@-` 以外の任意の文字を UTF-8 バイトごとに `=XX` 16 進数として書き込み、64 文字より長い結果をプレフィックスとハッシュに短縮するため、各開発者のセッション名は有効で一意のままです。トークンがクレームを欠いている開発者からのリクエストはこのアップストリームを通じて送信されず、オペレーターログは `sub` に切り替えるか [`oidc.email_claim`](#oidc) を設定するよう指示します。483`session_name` は、どの検証済みクレームが AWS `RoleSessionName` になるかを選択します：`email` または `sub`。ゲートウェイは ASCII 文字、数字、および `_+,.@-` 以外の任意の文字を UTF-8 バイトごとに `=XX` 16 進数として書き込み、64 文字より長い結果をプレフィックスとハッシュに短縮するため、各開発者のセッション名は有効で一意のままです。トークンがクレームを欠いている開発者からのリクエストはこのアップストリームを通じて送信されず、オペレーターログは `sub` に切り替えるか [`oidc.email_claim`](#oidc) を設定するよう指示します。

484 484

485アクティブな開発者は、ゲートウェイレプリカあたり 1 時間あたり 1 つの STS 呼び出しをコストします。同時最初リクエストは 1 つの呼び出しを共有します。485アクティブな開発者 1 人あたり、ゲートウェイレプリカごとに 1 時間に 1 回の STS 呼び出しが発生します。同時に発生した最初のリクエストは 1 回の呼び出しを共有します。

486 486

487ゲートウェイはこのロールで 1 つの呼び出しも行います。クライアントが放棄したリクエストのトークンカウント。[支出制限](/docs/ja/claude-apps-gateway-spend-limits)が正確に保たれるようにするためです。そのカウントと[1 トークンフォールバックリクエスト](#amazon-bedrock)は共有 `claude-apps-gateway` セッションで署名されるため、AWS はフォールバックを `claude-apps-gateway` ではなく開発者に属性付けします。487ゲートウェイはこのロールで独自の呼び出しも 1 つ行います。[支出制限](/docs/ja/claude-apps-gateway-spend-limits)を正確に保つための、クライアントが放棄したリクエストのトークンカウントです。そのカウントとその[1 トークンフォールバックリクエスト](#amazon-bedrock)は共有の `claude-apps-gateway` セッションで署名されるため、AWS はフォールバックを開発者ではなく `claude-apps-gateway` に帰属させます。

488 488

489厳密な per-developer 属性の場合、すべての Bedrock アップストリームで `assume_role` を `session_name` で設定します。それなしのアップストリームは独自の認証情報でリクエストに署名します。489厳密な per-developer 属性の場合、リストするすべての Bedrock アップストリームで `assume_role` を `session_name` とともに設定します。それがないアップストリームは、処理するリクエストに独自の認証情報で署名します。

490

491<h4 id="amazon-bedrock-mantle-endpoint">

492 Amazon Bedrock Mantle エンドポイント

493</h4>

494

495`mantle` プロバイダーは、推論を Amazon Bedrock の [Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)に送信します。ゲートウェイサーバーで Claude Code v2.1.283 以降が必要です。それより前のゲートウェイリリースはブート時にこれを拒否するため、追加する前にすべてのレプリカをアップグレードしてください。

496

497以下の例では Mantle を最初に置き、その後ろに Amazon Bedrock アップストリームを置いて、`models` フィールドに含まれないすべてのモデルを提供させます：

498

499```yaml theme={null}

500upstreams:

501 - provider: mantle

502 region: us-east-1

503 models: [claude-opus-4-7, claude-haiku-4-5] # required

504 auth: {} # AWS default credential chain

505 - provider: bedrock

506 region: us-east-1

507 auth: {}

508```

509

510以下の表は、`mantle` アップストリーム固有のフィールドを示しています。

511

512| フィールド | 必須 | 説明 |

513| - | - | - |

514| `region` | はい | AWS リージョン。ゲートウェイはここからエンドポイントを `https://bedrock-mantle.<region>.api.aws/anthropic` として導出します。 |

515| `models` | はい | Mantle で AWS アカウントに付与されているモデル。`claude-haiku-4-5` のように、クライアントが送信する名前で指定します。これらのモデルのみがこのアップストリームに送られ、それ以外のモデルは次のアップストリームにスキップされます。 |

516| `auth` | いいえ | [Amazon Bedrock](#amazon-bedrock) アップストリームの `auth` ブロックと同じキーを、同じルールで受け付けます。 |

517| `base_url` | いいえ | 導出されたエンドポイントを上書きします。末尾の `/anthropic` パスは残してください。 |

518

519アップストリームの AWS アイデンティティに、推論とトークンカウント用の Mantle 独自の IAM アクションを付与します。これらは [Mantle エンドポイントを使用する](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)に記載されています。

520

521ゲートウェイが認識しない Mantle モデル ID の場合は、最上位の [`models:`](#models) ブロックに、`upstream_model` がこのアップストリームの名前をその ID にマップするエントリを追加します。次に、そのエントリの `id` をこのアップストリームの `models` フィールドにも追加します。

522

523`bedrock` アップストリームの `guardrail` と `assume_role` の設定は、Mantle が処理するリクエストには適用されません：

524

525* **`guardrail`**：ゲートウェイは Mantle に送信するリクエストに [Bedrock ガードレール](#apply-an-amazon-bedrock-guardrail)を適用しないため、いずれかの `bedrock` アップストリームが `guardrail` を設定している状態で `mantle` アップストリームがリストされていると、起動を拒否します。

526* **`assume_role`**：`mantle` アップストリームは [`assume_role`](#bedrock-in-another-aws-account) を受け付けません。Mantle が処理するリクエストは `mantle` アップストリーム自身の `auth` 認証情報で送信され、[開発者ごとに帰属](#per-developer-aws-cost-attribution)されません。

527

528Mantle 独自のエラーレスポンスの意味については、[Mantle エンドポイントのエラー](/docs/ja/amazon-bedrock#mantle-endpoint-errors)を参照してください。

490 529

491<h4 id="claude-platform-on-aws">530<h4 id="claude-platform-on-aws">

492 Claude Platform on AWS531 Claude Platform on AWS

493</h4>532</h4>

494 533

495Claude Platform on AWS は、`aws-external-anthropic.<region>.api.aws` で AWS インフラストラクチャ上の第一者 Anthropic API を提供します。第一者モデル ID を使用し、`anthropic-beta` ヘッダーを送信されたとおりに尊重し、`count_tokens` を提供するため、Bedrock 固有の翻訳は適用されません。`anthropicAws` プロバイダーには Claude Code v2.1.198 以降が必要です。以前のゲートウェイリリースはブート時にそれを拒否します。534Claude Platform on AWS は、`aws-external-anthropic.<region>.api.aws` で AWS インフラストラクチャ上のファーストパーティ Anthropic API を提供します。ファーストパーティのモデル ID を使用し、`anthropic-beta` ヘッダーを送信されたとおりに尊重し、`count_tokens` を提供するため、Bedrock 固有の変換は適用されません。`anthropicAws` プロバイダーには Claude Code v2.1.198 以降が必要です。以前のゲートウェイリリースはブート時にそれを拒否します。

496 535

497同じプラットフォームのクライアント側デプロイメントについては、[Claude Code on Claude Platform on AWS](/docs/ja/claude-platform-on-aws) を参照してください。ゲートウェイ側のアップストリーム：536同じプラットフォームのクライアント側デプロイについては、[Claude Code on Claude Platform on AWS](/docs/ja/claude-platform-on-aws) を参照してください。ゲートウェイ側のアップストリーム：

498 537

499```yaml theme={null}538```yaml theme={null}

500upstreams:539upstreams:

513 # base_url: https://aws-external-anthropic.us-east-1.api.aws552 # base_url: https://aws-external-anthropic.us-east-1.api.aws

514```553```

515 554

516プラットフォームはゲートウェイの環境で Amazon Bedrock とは別の AWS アカウントで実行され、独自のサービス名 `aws-external-anthropic` の SigV4 リクエストに署名するため、Bedrock スコープの IAM ロールはそれを認可しません。`auth.api_key` の API キーは SigV4 認証情報も設定されている場合に優先されます。空の `auth` ブロックは AWS SDK のデフォルト認証情報チェーンを使用します。[Amazon Bedrock](#amazon-bedrock) アップストリームが使用するのと同じチェーン。555このプラットフォームは Amazon Bedrock とは別の AWS アカウントで実行され、独自のサービス名 `aws-external-anthropic` で SigV4 リクエストに署名するため、Bedrock スコープの IAM ロールではそれを認可できません。`auth.api_key` の API キーは、SigV4 認証情報も設定されている場合に優先されます。空の `auth` ブロックは AWS SDK のデフォルト認証情報チェーンを使用します。これは [Amazon Bedrock](#amazon-bedrock) アップストリームが使用するのと同じチェーンです。

517 556

518| フィールド | 必須 | 説明 |557| フィールド | 必須 | 説明 |

519| - | - | - |558| - | - | - |

521| `workspace_id` | はい | すべてのリクエストでヘッダーとして送信されます。プラットフォームはそれを必要とします |560| `workspace_id` | はい | すべてのリクエストでヘッダーとして送信されます。プラットフォームはそれを必要とします |

522| `auth.api_key` | いいえ | プラットフォームの API キー。`x-api-key` として送信されます。ベアラートークンではありません。2 つの認証モードは API キーまたは SigV4 です。 |561| `auth.api_key` | いいえ | プラットフォームの API キー。`x-api-key` として送信されます。ベアラートークンではありません。2 つの認証モードは API キーまたは SigV4 です。 |

523| `auth.aws_access_key_id` / `auth.aws_secret_access_key` | いいえ | 明示的な SigV4 認証情報。一方を他方なしで設定するとブート時に失敗します。`auth.aws_session_token` はそれらと一緒に受け入れられます。 |562| `auth.aws_access_key_id` / `auth.aws_secret_access_key` | いいえ | 明示的な SigV4 認証情報。一方を他方なしで設定するとブート時に失敗します。`auth.aws_session_token` はそれらと一緒に受け入れられます。 |

524| `base_url` | いいえ | 導出されたエンドポイントをオーバーライド |563| `base_url` | いいえ | 導出されたエンドポイントを上書き |

525 564

526プラットフォームは第一者モデル ID を解決するため、組み込みカタログは [`models:`](#models) ブロックなしでそれにルーティングします。`models:` リストをキュレートする場合、エントリを `anthropicAws:` で第一者 ID でキーします。565プラットフォームはファーストパーティのモデル ID を解決するため、組み込みカタログは [`models:`](#models) ブロックなしでそれにルーティングします。`models:` リストをキュレートする場合、エントリのキーを `anthropicAws:` とし、ファーストパーティの ID を指定します。

527 566

528<h4 id="google-cloud-agent-platform">567<h4 id="google-cloud-agent-platform">

529 Google Cloud Agent Platform568 Google Cloud Agent Platform

545 584

546空の `auth` ブロックは Application Default Credentials を使用します：`GOOGLE_APPLICATION_CREDENTIALS`、GCE メタデータ、または GKE Workload Identity。サービスアカウント JSON キーファイルはサポートされていますが、推奨されません。Workload Identity を使用するか、GCE または Cloud Run インスタンスにサービスアカウントをアタッチします。585空の `auth` ブロックは Application Default Credentials を使用します：`GOOGLE_APPLICATION_CREDENTIALS`、GCE メタデータ、または GKE Workload Identity。サービスアカウント JSON キーファイルはサポートされていますが、推奨されません。Workload Identity を使用するか、GCE または Cloud Run インスタンスにサービスアカウントをアタッチします。

547 586

548Google Cloud の Agent Platform の[グローバルエンドポイント](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations)を使用するには `region: global` を設定します。Google はその後、各リクエストを利用可能なリージョンにルーティングするため、per-region モデル可用性を追跡しません。特定のリージョンを設定するとすべてのリクエストをそれにピンします。587リージョンエンドポイントの代わりに [Google Cloud の Agent Platform のグローバルエンドポイント](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations)を使用するには、`region: global` を設定します。Google が各リクエストを利用可能なリージョンにルーティングするため、リージョンごとのモデル可用性を追跡する必要がありません。特定のリージョンを設定すると、すべてのリクエストがそのリージョンに固定されます。

549 588

550| セットアップ | 方法 |589| セットアップ | 方法 |

551| - | - |590| - | - |

552| IAM 権限 | ゲートウェイのサービスアカウントにプロジェクトで `roles/aiplatform.user` を付与するか、`aiplatform.endpoints.predict` を持つカスタムロール。Google Cloud の Agent Platform API（`aiplatform.googleapis.com`）を有効にします。 |591| IAM 権限 | ゲートウェイのサービスアカウントにプロジェクトで `roles/aiplatform.user`、または `aiplatform.endpoints.predict` を持つカスタムロールを付与します。Google Cloud の Agent Platform API（`aiplatform.googleapis.com`）を有効にします。 |

553| モデルアクセス | Model Garden で、プロジェクトの Claude モデルを有効にします。特定のリージョンに公開されます。サポートされているリージョンについてはモデルカードを確認してください。 |592| モデルアクセス | Model Garden で、プロジェクトの Claude モデルを有効にします。モデルは特定のリージョンに公開されます。サポートされているリージョンについてはモデルカードを確認してください。 |

554| GKE（Workload Identity） | GCP サービスアカウントをゲートウェイの Kubernetes サービスアカウントにバインドし、KSA に `iam.gke.io/gcp-service-account: claude-gateway@<proj>.iam.gserviceaccount.com` で注釈を付けます。`auth: {}` がそれを取得します。 |593| GKE（Workload Identity） | GCP サービスアカウントをゲートウェイの Kubernetes サービスアカウントにバインドし、KSA に `iam.gke.io/gcp-service-account: claude-gateway@<proj>.iam.gserviceaccount.com` で注釈を付けます。`auth: {}` がそれを取得します。 |

555| Cloud Run / GCE | サービスのサービスアカウントを `roles/aiplatform.user` を持つものに設定します。`auth: {}` がそれを取得します。 |594| Cloud Run / GCE | サービスのサービスアカウントを `roles/aiplatform.user` を持つものに設定します。`auth: {}` がそれを取得します。 |

556| その他の場所 | `auth: { service_account_json: /secrets/sa.json }`。マウントされたシークレットとしての JSON キーファイルへのパス。フィールドはキーコンテンツではなくファイルパスを取るため、`${file:…}` 展開は関係ありません。 |595| その他の場所 | `auth: { service_account_json: /secrets/sa.json }`。シークレットとしてマウントされた JSON キーファイルへのパスです。このフィールドはキーの内容ではなくファイルパスを取るため、`${file:…}` 展開は関係ありません。 |

557 596

558<h4 id="microsoft-foundry">597<h4 id="microsoft-foundry">

559 Microsoft Foundry598 Microsoft Foundry

560</h4>599</h4>

561 600

562クライアント側の Microsoft Foundry デプロイメントについては、[Claude Code on Microsoft Foundry](/docs/ja/microsoft-foundry) を参照してください。ゲートウェイ側のアップストリーム：601クライアント側の Microsoft Foundry デプロイについては、[Claude Code on Microsoft Foundry](/docs/ja/microsoft-foundry) を参照してください。ゲートウェイ側のアップストリーム：

563 602

564```yaml theme={null}603```yaml theme={null}

565upstreams:604upstreams:

571 # api_key: ${FOUNDRY_API_KEY}610 # api_key: ${FOUNDRY_API_KEY}

572```611```

573 612

574`use_azure_ad: true` は `DefaultAzureCredential` を通じて解決します：AKS、ACI、または App Service 上の Managed Identity。Azure CLI。または環境認証情報。API キーは機能しますが、プロジェクト全体であり、自動的にローテーションしません。Microsoft Foundry のエンドポイントは `resource:` から導出されます。Azure Government などのソブリンクラウドの場合、オプションの `base_url` を設定してオーバーライドします。613`use_azure_ad: true` は `DefaultAzureCredential` を通じて解決します：AKS、ACI、または App Service 上の Managed Identity、Azure CLI、または環境認証情報。API キーは機能しますが、プロジェクト全体に適用され、自動的にローテーションしません。Microsoft Foundry のエンドポイントは `resource:` から導出されます。Azure Government などのソブリンクラウドの場合、オプションの `base_url` を設定して上書きします。

575 614

576| セットアップ | 方法 |615| セットアップ | 方法 |

577| - | - |616| - | - |

580| AKS（ワークロードアイデンティティ） | User-Assigned Managed Identity をクラスターの OIDC 発行者とフェデレーションし、ゲートウェイのサービスアカウントにバインドします。`use_azure_ad: true` は `WorkloadIdentityCredential` を通じてそれを取得します。 |619| AKS（ワークロードアイデンティティ） | User-Assigned Managed Identity をクラスターの OIDC 発行者とフェデレーションし、ゲートウェイのサービスアカウントにバインドします。`use_azure_ad: true` は `WorkloadIdentityCredential` を通じてそれを取得します。 |

582| その他の場所 | `auth: { api_key: "${FOUNDRY_API_KEY}" }`。`{ }` 内の `${…}` を引用符で囲みます。 |621| その他の場所 | `auth: { api_key: "${FOUNDRY_API_KEY}" }`。`{ }` 内の `${…}` を引用符で囲みます。 |

585 アップストリームリクエストの静的ヘッダー624 アップストリームリクエストの静的ヘッダー

586</h4>625</h4>

587 626

588ゲートウェイが 1 つのアップストリームに送信するリクエストに固定ヘッダーを追加するには、そのアップストリームで `headers:` を設定します。実行するプロキシがヘッダーでトラフィックをルーティングまたは属性付けする場合に使用します。627ゲートウェイが 1 つのアップストリームに送信するリクエストに固定ヘッダーを追加するには、そのアップストリームで `headers:` を設定します。プロバイダーの前段で実行するプロキシがヘッダーでトラフィックをルーティングまたは帰属させる場合に使用します。

589 628

590`headers:` にはゲートウェイサーバーで Claude Code v2.1.277 以降が必要です。以前のゲートウェイはキーを見つけたときに起動を拒否します。すべてのレプリカをアップグレードしてからキーを追加し、以前のバージョンにロールバックする前にキーを削除します。629`headers:` にはゲートウェイサーバーで Claude Code v2.1.277 以降が必要です。以前のゲートウェイはキーを見つけたときに起動を拒否します。すべてのレプリカをアップグレードしてからキーを追加し、以前のバージョンにロールバックする前にキーを削除します。

591 630

592ヘッダーは `base_url` が名前を付けるサーバー、または `base_url` が設定されていない場合はプロバイダー独自のエンドポイントに移動します。プロキシがそれらを削除しない限り、プロバイダーもそれらを受け取ります。631ヘッダーは `base_url` が名前を付けるサーバー、または `base_url` が設定されていない場合はプロバイダー独自のエンドポイントに送られます。プロキシがそれらを削除しない限り、プロバイダーもそれらを受け取ります。

593 632

594この例は、`upstream-proxy.internal.example.com` のプロキシを通じて `provider: vertex` アップストリームに到達します。プロキシが読み取る `x-source` ヘッダーを設定し、`PROXY_TOKEN` 環境変数からのトークンを `x-proxy-token` として送信します：633この例は、`upstream-proxy.internal.example.com` のプロキシを通じて `provider: vertex` アップストリームに到達します。プロキシが読み取る `x-source` ヘッダーを設定し、`PROXY_TOKEN` 環境変数からのトークンを `x-proxy-token` として送信します：

595 634

609 648

610シークレットを設定ファイルから外すには、[シークレット展開](#secret-expansion)を使用して、`${VAR}` で環境変数から、または `${file:/path}` でファイルから値を読み込みます。空の値に解決する `${VAR}` はゲートウェイの起動を停止します。649シークレットを設定ファイルから外すには、[シークレット展開](#secret-expansion)を使用して、`${VAR}` で環境変数から、または `${file:/path}` でファイルから値を読み込みます。空の値に解決する `${VAR}` はゲートウェイの起動を停止します。

611 650

612`headers:` はすべてのプロバイダーで機能し、各アップストリームは独自のみを送信します。651`headers:` はすべてのプロバイダーで機能し、各アップストリームは自身のヘッダーのみを送信します。

613 652

614ゲートウェイがアップストリームに送信するすべてのリクエストがそれらを含むわけではありません：653ゲートウェイがアップストリームに送信するすべてのリクエストがそれらを含むわけではありません：

615 654

617| - | - |656| - | - |

618| `/v1/messages`。ストリーミングまたはそうでなく、および `/v1/messages/count_tokens` | はい |657| `/v1/messages`（ストリーミングかどうかを問わない）、および `/v1/messages/count_tokens` | はい |

620| クライアントが放棄したリクエストの Amazon Bedrock の `CountTokens` 呼び出し | いいえ |659| クライアントが放棄したリクエストの Amazon Bedrock の `CountTokens` 呼び出し | いいえ |

621| Workload Identity Federation トークン交換 | いいえ |660| Workload Identity Federation トークン交換 | いいえ |

622 661

623AWS SigV4 でリクエストに署名する Amazon Bedrock または Claude Platform on AWS アップストリームでは、これらのヘッダーは署名の一部であるため、プロキシはそれらを変更されずに通す必要があります。662AWS SigV4 でリクエストに署名する Amazon Bedrock または Claude Platform on AWS アップストリームでは、これらのヘッダーは署名の一部であるため、プロキシはそれらを変更せずに通す必要があります。

624 663

625ゲートウェイが予約するヘッダー名を使用する場合、起動エラーはそのヘッダーに名前を付けて起動を拒否します。予約名には以下が含まれます：664ゲートウェイが予約する名前を使用すると、ゲートウェイは起動を拒否し、起動エラーにそのヘッダーの名前が表示されます。予約名には以下が含まれます：

626 665

627* `authorization` と `x-api-key`666* `authorization` と `x-api-key`

628* `host`、`content-type`、および `user-agent`667* `host`、`content-type`、および `user-agent`

632 複数のアップストリーム671 複数のアップストリーム

633</h4>672</h4>

634 673

635同じプロバイダーは異なる `name:` で複数回表示できます。これは異なるリージョン、異なるアカウント（異なる認証情報チェーン経由）、プロビジョニングされたスループット対オンデマンド、およびクロスプロバイダーフェイルバックをカバーします。674同じプロバイダーは異なる `name:` で複数回表示できます。これは異なるリージョン、異なるアカウント（異なる認証情報チェーン経由）、プロビジョニングされたスループット対オンデマンド、およびクロスプロバイダーフォールバックをカバーします。

636 675

637ゲートウェイはアップストリームを順に試みます。`5xx`、`429`、`401`、`403`、`404`、タイムアウト、および欠落エンドポイント（`501`）がフェイルオーバーします。他の `4xx` はそうしません。676ゲートウェイはアップストリームを順に試みます。`5xx`、`429`、`401`、`403`、`404`、タイムアウト、および欠落エンドポイント（`501`）がフェイルオーバーします。他の `4xx` はフェイルオーバーしません。

638 677

639`429` は per-upstream 容量であるため、プロビジョニングされたスループット（PT）枯渇はオンデマンドにフェイルオーバーします。アップストリームで [`forward_user_identity: true`](#per-user-identity-headers-for-a-proxy-you-run) を設定する場合、開発者のメールを含むリクエストへの `429` は per-user 拒否であり、フェイルオーバーしません。678`429` はアップストリームごとの容量であるため、プロビジョニングされたスループット（PT）の枯渇はオンデマンドにフェイルオーバーします。アップストリームで [`forward_user_identity: true`](#per-user-identity-headers-for-a-proxy-you-run) を設定する場合、開発者のメールを含むリクエストへの `429` は代わりにユーザーごとの拒否となり、フェイルオーバーしません。

640 679

641すべてのリクエストは最初のアップストリームで開始されます。リクエストは、それより前のすべてのアップストリームが失敗したか、要求されたモデルを提供しない場合のみ、後のアップストリームに到達します。680すべてのリクエストは最初のアップストリームで開始されます。リクエストは、それより前のすべてのアップストリームが失敗したか、要求されたモデルを提供しない場合のみ、後のアップストリームに到達します。

642 681

643ゲートウェイは失敗したアップストリームの記録を保ちません。アップストリームがダウンしている間、それに到達するすべてのリクエストはそれを試み、失敗するのを待ってから先に進みます。682ゲートウェイは失敗したアップストリームの記録を保たないため、アップストリームがダウンしている間、それに到達するすべてのリクエストはそれを試み、失敗するのを待ってから先に進みます。

644 683

645Anthropic API アップストリームの場合、[`timeouts.upstream_ttfb_ms`](#http-tuning)はダウンアップストリームでの待機を制限します。その設定は他のプロバイダーには適用されません。ゲートウェイはアップストリームが応答を開始するまで最大 1 時間待機します。684Anthropic API アップストリームの場合、[`timeouts.upstream_ttfb_ms`](#http-tuning) がダウンしたアップストリームでの待機を制限します。その設定は他のプロバイダーには適用されず、ゲートウェイはアップストリームが応答を開始するまで最大 1 時間待機します。

646 685

647`404` は per-upstream モデル可用性であるため、モデルを有効にしていないアップストリームは、それを提供する後のアップストリームをブロックしません。要求されたモデルを解決できないアップストリームはネットワークラウンドトリップなしでスキップされます。686`404` はアップストリームごとのモデル可用性であるため、モデルを有効にしていないアップストリームは、それを提供する後のアップストリームをブロックしません。要求されたモデルを解決できないアップストリームはネットワークラウンドトリップなしでスキップされます。

648 687

649この例は、プロビジョニングされたスループット Amazon Bedrock 割り当てを最初にルーティングし、オンデマンドと 2 番目のアカウントにオーバーフロー、最後に Anthropic API にフォールバックします：688この例は、プロビジョニングされたスループットの Amazon Bedrock 割り当てを最初にルーティングし、オンデマンドと 2 番目のアカウントにオーバーフローし、最後に Anthropic API にフォールバックします：

650 689

651```yaml theme={null}690```yaml theme={null}

652upstreams:691upstreams:

686 725

687| レバー | 方法 |726| レバー | 方法 |

688| - | - |727| - | - |

689| 異なるリージョン | リージョンごとに 1 つの Amazon Bedrock アップストリーム。独自の `region:` を持つ。[`auto_include_builtin_models: true`](#models) でクロスリージョン推論プロファイルは自動的にルーティングします。リージョンピン配置デプロイメントの場合、`models:` ブロックを使用します。 |728| 異なるリージョン | リージョンごとに 1 つの Amazon Bedrock アップストリームを置き、それぞれ独自の `region:` を持たせます。[`auto_include_builtin_models: true`](#models) ではクロスリージョン推論プロファイルが自動的にルーティングします。リージョン固定のデプロイの場合、`models:` ブロックを使用します。 |

690| 異なるアカウント | アカウントごとに 1 つの Amazon Bedrock アップストリーム。デフォルトチェーン（`auth: {}`）はポッドのアイデンティティを使用します。2 番目のアカウントの場合、短期認証情報でそれに到達するために [`assume_role`](#bedrock-in-another-aws-account) を追加するか、`auth:` で明示的な認証情報またはベアラートークンを設定します。 |729| 異なるアカウント | アカウントごとに 1 つの Amazon Bedrock アップストリーム。デフォルトチェーン（`auth: {}`）はポッドのアイデンティティを使用します。2 番目のアカウントの場合、短期認証情報でそれに到達するために [`assume_role`](#bedrock-in-another-aws-account) を追加するか、`auth:` で明示的な認証情報またはベアラートークンを設定します。 |

691| プロビジョニングされたスループット | モデルをそのアップストリームの名前の `models:` のプロビジョニングされたスループット ARN にマップします。他のアップストリームはオンデマンド ID を保つため、PT 容量はフェイルオーバーする前に枯渇します。 |730| プロビジョニングされたスループット | そのアップストリームの名前について、`models:` でモデルをプロビジョニングされたスループット ARN にマップします。他のアップストリームはオンデマンド ID を保つため、PT 容量はフェイルオーバーする前に使い切られます。 |

693| モデルスコープルーティング | カスタムモデル `id` のみ。組み込み Claude モデルではなく、`upstream_model:` マップに存在しないアップストリームをスキップします。ゲートウェイは組み込みモデルをすべてのアップストリームで順に試み、マップにエントリがない場合はプロバイダーのデフォルト ID を使用するため、組み込みモデルの場合、マップはアップストリームが試みられるかどうかではなく、アップストリームが受け取る ID を変更します。ID を拒否するアップストリームは、他のアップストリームエラーと同じ[フェイルオーバールール](#upstreams)に従います。 |732| モデルスコープルーティング | 組み込み Claude モデルではないカスタムモデル `id` のみが、その `upstream_model:` マップにないアップストリームをスキップします。`mantle` アップストリームは、その [`models` フィールド](#amazon-bedrock-mantle-endpoint)にリストされたモデルに対してのみ試行されます。他のすべてのアップストリームでは、ゲートウェイは組み込みモデルを順に試み、マップにエントリがない場合はプロバイダーのデフォルト ID を使用するため、組み込みモデルの場合、マップはアップストリームが試みられるかどうかではなく、アップストリームが受け取る ID を変更します。ID を拒否するアップストリームは、他のアップストリームエラーと同じ[フェイルオーバールール](#upstreams)に従います。 |

694 733

695クラウドプロバイダー間、または直接 Anthropic API へのフェイルオーバーは、リクエストを制御する契約、地理、およびその他の条件を変更します。734クラウドプロバイダー間、または直接 Anthropic API へのフェイルオーバーは、リクエストに適用される契約、地理、およびその他の条件を変更します。

696 735

697CLI は、どのアップストリームが特定のリクエストを提供するかに関わらず、ゲートウェイに同じ機能ゲーティングを適用するため、フェイルオーバーはアップストリームが拒否する本体フィールドを送信しません。736CLI は、どのアップストリームが特定のリクエストを処理するかに関わらず、ゲートウェイに同じ機能ゲーティングを適用するため、フェイルオーバーによってアップストリームが拒否する本体フィールドが送信されることはありません。

698 737

699<h2 id="optional-sections">738<h2 id="optional-sections">

700 オプションセクション739 オプションセクション

846 - match: {}885 - match: {}

847 cli:886 cli:

848 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]887 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

888 # Make the Default option in /model resolve inside each policy's

889 # list. The eng-contractors policy inherits enforceAvailableModels.

890 enforceAvailableModels: true

849```891```

850 892

851`match: {}` キャッチオール（慣例的に最後にリストされる）は基盤層として扱われます。他のすべてのポリシーは、設定しないキーをキャッチオールから継承するため、ロールごとのエントリは組織のデフォルトと異なる内容のみをリストすれば済みます。マージルールはキータイプに依存します：893`match: {}` キャッチオール（慣例的に最後にリストされる）は基盤層として扱われます。他のすべてのポリシーは、設定しないキーをキャッチオールから継承するため、ロールごとのエントリは組織のデフォルトと異なる内容のみをリストすれば済みます。マージルールはキータイプに依存します：

854* **拒否リストとフック配列**：`permissions.deny`、`permissions.ask`、`disabledMcpjsonServers`、`deniedMcpServers`、`blockedMarketplaces`、およびすべての `hooks` イベントタイプ配列。これらは基盤とポリシーの和集合を取るため、組織全体の拒否または監査フックがロールごとの上書きで誤って削除されることはありません。896* **拒否リストとフック配列**：`permissions.deny`、`permissions.ask`、`disabledMcpjsonServers`、`deniedMcpServers`、`blockedMarketplaces`、およびすべての `hooks` イベントタイプ配列。これらは基盤とポリシーの和集合を取るため、組織全体の拒否または監査フックがロールごとの上書きで誤って削除されることはありません。

855* **レコード型キー**：`env`、`modelOverrides`、`skillOverrides`。これらは浅くマージされるため、ロールごとの `env` ブロックは設定するキーを上書きし、残りを基盤から継承します。897* **レコード型キー**：`env`、`modelOverrides`、`skillOverrides`。これらは浅くマージされるため、ロールごとの `env` ブロックは設定するキーを上書きし、残りを基盤から継承します。

856 898

857`availableModels` は `/v1/messages` でサーバー側でも強制されるため、拒否されたモデルはクライアントが送信する内容に関わらず `400` を返します。899`availableModels` は `/v1/messages` でサーバー側でも強制されるため、拒否されたモデルはクライアントが送信する内容に関わらず `400` を返します。空のリストはすべてのモデルを拒否します。このチェックは、デベロッパーがモデルを選択する前にセッションが開始するモデルにも適用されるため、[ポリシーが許可するモデルでセッションを開始](#start-sessions-on-a-model-the-policy-allows) してください。

858 900

859ゲートウェイはリクエストを中継する前に `model` 値自体を検証するため、不正な形式の値は上流に到達しません。2 つの場合に `400` でリクエストを拒否します：901ゲートウェイはリクエストを中継する前に `model` 値自体を検証するため、不正な形式の値は上流に到達しません。2 つの場合に `400` でリクエストを拒否します：

860 902

881 * **グループメンバーシップ**：ユーザーのグループメンバーシップを変更すると、どのポリシーがそのユーザーにマッチするかが変わります。これは次のセッション再発行時、つまり次のサイレントリフレッシュ時に有効になり、`session.ttl_hours` が上限となります。923 * **グループメンバーシップ**：ユーザーのグループメンバーシップを変更すると、どのポリシーがそのユーザーにマッチするかが変わります。これは次のセッション再発行時、つまり次のサイレントリフレッシュ時に有効になり、`session.ttl_hours` が上限となります。

882</Note>924</Note>

883 925

926<h4 id="start-sessions-on-a-model-the-policy-allows">

927 ポリシーが許可するモデルでセッションを開始する

928</h4>

929

930`availableModels` に Claude Code のデフォルトモデルが含まれていない場合、デベロッパーが `/model` などでリストにあるモデルを選択するまで、セッションは `400` レスポンスを受け取ります。ゲートウェイセッションでは、デフォルトは `opus` エイリアスが解決される Opus モデルであり、`availableModels` だけではこれは変わりません。

931

932これを解決するには、同じ `cli` ブロックで [`enforceAvailableModels: true`](/docs/ja/model-config#enforce-the-allowlist-for-the-default-model) を設定し、リストに含まれるエントリの種類を確認します：

933

934* **`sonnet` などのエイリアス、または `claude-sonnet-4-6` などの組み込み ID**：セッションはそれらのモデルのいずれかで開始し、`/model` の Default オプションはそのモデルに解決されます

935* **リストにエイリアスも組み込み ID もない場合**：セッションは引き続き組み込みのデフォルトで開始する可能性があるため、そのポリシーの `cli` ブロックで [`model`](/docs/ja/model-config#control-the-model-users-run-on) もリスト内の ID のいずれかに設定してください

936

937このポリシーは [`models`](#models) で定義された 1 つのカスタム ID をリストし、その ID でセッションを開始します：

938

939```yaml theme={null}

940managed:

941 policies:

942 - match: { groups: [restricted-projects] }

943 cli:

944 availableModels: [claude-opus-restricted]

945 enforceAvailableModels: true

946 model: claude-opus-restricted

947```

948

884<h4 id="matcher-values-that-stop-the-gateway-at-boot">949<h4 id="matcher-values-that-stop-the-gateway-at-boot">

885 ゲートウェイをブート時に停止させる matcher 値950 ゲートウェイをブート時に停止させる matcher 値

886</h4>951</h4>

918 cli:983 cli:

919 # Model access (also enforced server-side at /v1/messages)984 # Model access (also enforced server-side at /v1/messages)

920 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]985 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

986 enforceAvailableModels: true # Default resolves inside the list

921 987

922 # Permission policy988 # Permission policy

923 permissions:989 permissions:

1039 - match: { groups: [eng-contractors] }1105 - match: { groups: [eng-contractors] }

1040 cli:1106 cli:

1041 availableModels: [claude-sonnet-4-6]1107 availableModels: [claude-sonnet-4-6]

1108 enforceAvailableModels: true

1042 desktop:1109 desktop:

1043 isLocalDevMcpEnabled: false1110 isLocalDevMcpEnabled: false

1044 disableAutoUpdates: true1111 disableAutoUpdates: true

1432 # region: us-east-11499 # region: us-east-1

1433 # auth: {}1500 # auth: {}

1434 1501

1502 # - provider: mantle

1503 # region: us-east-1

1504 # models: [claude-opus-4-8, claude-opus-4-7, claude-haiku-4-5]

1505 # auth: {}

1506

1435 # - provider: anthropicAws1507 # - provider: anthropicAws

1436 # region: us-east-11508 # region: us-east-1

1437 # workspace_id: wrkspc_...1509 # workspace_id: wrkspc_...

1454 upstream_model:1526 upstream_model:

1455 anthropic: claude-opus-4-81527 anthropic: claude-opus-4-8

1456 # bedrock: us.anthropic.claude-opus-4-81528 # bedrock: us.anthropic.claude-opus-4-8

1529 # mantle: anthropic.claude-opus-4-8

1457 # anthropicAws: claude-opus-4-81530 # anthropicAws: claude-opus-4-8

1458 # vertex: claude-opus-4-81531 # vertex: claude-opus-4-8

1459 # foundry: <your-opus-deployment-name>1532 # foundry: <your-opus-deployment-name>

1471 - match: { groups: [contractors] }1544 - match: { groups: [contractors] }

1472 cli:1545 cli:

1473 availableModels: [claude-haiku-4-5]1546 availableModels: [claude-haiku-4-5]

1474 # Constrain the Default picker option to availableModels instead of

1475 # the tier default, so contractors don't get a 400 on the default.

1476 enforceAvailableModels: true

1477 # allow auto-approves these tools; it does not block the rest.1547 # allow auto-approves these tools; it does not block the rest.

1478 # Add deny rules to restrict tools.1548 # Add deny rules to restrict tools.

1479 permissions: { allow: [Read, Grep] }1549 permissions: { allow: [Read, Grep] }

1480 - match: {}1550 - match: {}

1481 cli:1551 cli:

1482 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]1552 availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

1553 # Constrain the Default picker option to each policy's availableModels

1554 # instead of the built-in default, so no role gets a 400 on Default.

1555 # The contractors policy inherits this key.

1556 enforceAvailableModels: true

1483 permissions:1557 permissions:

1484 allow: [Read, Grep, Bash, Edit]1558 allow: [Read, Grep, Bash, Edit]

1485 deny: ["WebFetch"]1559 deny: ["WebFetch"]

claude-apps-gateway-deploy.md +8 −1

Details

429 429

430gateway は、リクエストのヘッダーの合計が 256 KiB（[`limits.max_request_header_bytes`](/docs/ja/claude-apps-gateway-config#http-tuning) を設定している場合はその値）を超えると `431` で応答します。これらのリクエストについては、ログ行も監査イベントも書き込みません。v2.1.284 より前の gateway バージョンは、16 KiB を超えると `431` で応答します。430gateway は、リクエストのヘッダーの合計が 256 KiB（[`limits.max_request_header_bytes`](/docs/ja/claude-apps-gateway-config#http-tuning) を設定している場合はその値）を超えると `431` で応答します。これらのリクエストについては、ログ行も監査イベントも書き込みません。v2.1.284 より前の gateway バージョンは、16 KiB を超えると `431` で応答します。

431 431

432何を変更すべきかは、gateway のバージョンと設定によって異なります。432以下のうち、gateway に該当する最初の項目から対応してください。

433 433

434* **v2.1.284 より古い gateway**: gateway をアップグレードしてください434* **v2.1.284 より古い gateway**: gateway をアップグレードしてください

435* **`limits.max_request_header_bytes` が設定されている**: 値を上げるか、キーを削除してください435* **`limits.max_request_header_bytes` が設定されている**: 値を上げるか、キーを削除してください

436* **いずれにも該当しない、またはその後も `431` が続く**: IdP が発行するグループを減らしてください。Okta、Microsoft Entra ID、Google Workspace がグループを提供する方法については、[Identity provider setup](#identity-provider-setup) を参照してください436* **いずれにも該当しない、またはその後も `431` が続く**: IdP が発行するグループを減らしてください。Okta、Microsoft Entra ID、Google Workspace がグループを提供する方法については、[Identity provider setup](#identity-provider-setup) を参照してください

437 437

438groups クレームを削減する際は、以下の設定で指定したグループを残してください。これらの設定は、開発者のアクセス、ポリシー、支出上限を決定します。

439

440* **[`oidc.allowed_groups`](/docs/ja/claude-apps-gateway-config#oidc)**: サインインできるユーザーを決定します

441* **[`admin.admin_groups`](/docs/ja/claude-apps-gateway-config#admin)**: gateway セッションで管理 API を呼び出せるユーザーを決定します

442* **[`managed.policies`](/docs/ja/claude-apps-gateway-config#managed) 内の `match.groups`**: 開発者に適用されるポリシーを決定します

443* **`rbac_group` [支出上限](/docs/ja/claude-apps-gateway-spend-limits)**: 開発者に適用されるグループ上限を決定します

444

438<h2 id="related">445<h2 id="related">

439 関連446 関連

440</h2>447</h2>

claude-code-on-the-web.md +103 −63

Details

12 12

13クラウドセッションは、マシン上ではなくクラウドインフラストラクチャで実行される Claude Code セッションです。デフォルトでは Anthropic が管理するインフラストラクチャで実行されるか、ルーティングされた場合は組織の[セルフホスト環境](/docs/ja/self-hosted-environments)で実行されます。セッションはラップトップを閉じた後も実行を続け、任意のデバイスから確認または操作できます。13クラウドセッションは、マシン上ではなくクラウドインフラストラクチャで実行される Claude Code セッションです。デフォルトでは Anthropic が管理するインフラストラクチャで実行されるか、ルーティングされた場合は組織の[セルフホスト環境](/docs/ja/self-hosted-environments)で実行されます。セッションはラップトップを閉じた後も実行を続け、任意のデバイスから確認または操作できます。

14 14

15クラウドセッションが GitHub からコードをクローンしてブランチをプッシュできるようにするには、いずれかの [GitHub 接続方法](#github-authentication-options)で GitHub を接続します。リポジトリが GitLab、Bitbucket、またはその他のホスト上にある場合は、[プラットフォームの制限](#limitations)で利用可能な機能を確認してください。

15以下のいずれかのサーフェスからクラウドセッションを開始できます：17以下のいずれかのサーフェスからクラウドセッションを開始できます：

16 18

17* **ブラウザ**：[claude.ai/code](https://claude.ai/code)（ウェブ上の Claude Code とも呼ばれます）19* **ブラウザ**：[claude.ai/code](https://claude.ai/code)（ウェブ上の Claude Code とも呼ばれます）

20* **ターミナル**：[`claude --cloud`](#from-terminal-to-cloud)22* **ターミナル**：[`claude --cloud`](#from-terminal-to-cloud)

21* **ルーティン**：[スケジュール実行とトリガー実行](/docs/ja/routines)は各々クラウドセッションとして実行されます23* **ルーティン**：[スケジュール実行とトリガー実行](/docs/ja/routines)は各々クラウドセッションとして実行されます

22 24

231 つの作業本体に対して Claude が多くのクラウドセッションを開始して追跡するには、[プロジェクト](/docs/ja/claude-projects)を使用します。ターミナル、IDE、または**Local** が選択されたデスクトップアプリのセッションは、代わりにマシン上で実行されます。これらのローカルセッションの 1 つを携帯電話またはブラウザから操作するには、[リモートコントロール](/docs/ja/remote-control)を使用します。25セットアップが完了したら、このページを参考に、ターミナルとクラウド間での作業の移動、セッションの管理と共有、プルリクエストの自動修正の有効化、およびトラブルシューティングを行ってください。

~~25<Tip>~~

~~26 クラウドセッションは初めてですか？[はじめに](/docs/ja/web-quickstart)から始めて、GitHub アカウントを接続し、最初のタスクを送信してください。~~

~~27</Tip>~~

28 26

~~29このページでは以下をカバーしています：~~27<Note>

28 以下のケースは他のページで説明しています：

30 29

~~31* [クラウド環境](#cloud-environments)：セッションが実行される場所、およびそれを設定する場所~~30 * **最初のクラウドセッションの開始**：[クラウドセッションを始める](/docs/ja/web-quickstart)では、GitHub を接続し、ブラウザでタスクを実行する手順を説明しています

~~32* [GitHub 認証オプション](#github-authentication-options)：GitHub を接続する 2 つの方法~~31 * **1 つの作業本体に対する多数のクラウドセッション**：[プロジェクト](/docs/ja/claude-projects)を使用すると、Claude がセッションを開始して追跡します

~~33* [ターミナルとクラウド間でタスクを移動](#move-tasks-between-terminal-and-cloud)（`--cloud` と `--teleport` を使用）~~32 * **別のデバイスからのローカルセッションの操作**：ターミナル、IDE、または**Local** が選択されたデスクトップアプリのセッションはマシン上で実行され、[Remote Control](/docs/ja/remote-control) を使用すると携帯電話やブラウザからそれらにアクセスできます

~~34* [セッションの操作](#work-with-sessions)：権限モード、確認、共有、アーカイブ、削除~~33</Note>

~~35* [プルリクエストの自動修正](#auto-fix-pull-requests)：CI 失敗とレビューコメントに自動的に応答~~

~~36* [セキュリティと分離](#security-and-isolation)：セッションの分離方法~~

~~37* [制限事項](#limitations)：レート制限とプラットフォーム制限~~

38 34

39<h2 id="cloud-environments">35<h2 id="cloud-environments">

40 クラウド環境36 クラウド環境

41</h2>37</h2>

42 38

43すべてのクラウドセッションは[クラウド環境](/docs/ja/cloud-environments)で実行されます。これはネットワークアクセス、環境変数、セットアップスクリプトを制御する保存された設定です。環境がまだない場合、オンボーディングは[**Trusted** ネットワークアクセス](/docs/ja/cloud-environments#access-levels)を持つ**Default** 環境をセットアップします。これは、あなたのために作成するか、作成するよう依頼するかのいずれかです。[Default 環境](/docs/ja/cloud-environments#the-default-environment)を参照して、どちらがあなたのプランで発生するか、および複数の環境がある場合にセッションが環境を選択する方法を確認してください。39すべてのクラウドセッションは[クラウド環境](/docs/ja/cloud-environments)で実行されます。これはネットワークアクセス、環境変数、セットアップスクリプトを制御する保存された設定です。

44 40

45同じ環境はクラウドセッションを開始する場所に関係なく適用されます：ウェブ、ターミナル、[Claude Tag](https://claude.com/docs/claude-tag/overview)、[ルーチン](/docs/ja/routines)、およびモバイルおよび Desktop アプリ。Claude Tag チャネルセッションは組織レベルの環境のみを使用します。[共有環境](/docs/ja/cloud-environments#organization-shared-environments)または[セルフホスト環境](/docs/ja/self-hosted-environments)のいずれかです。41* **最初の環境**: 環境がまだない場合、オンボーディングは[**Trusted** ネットワークアクセス](/docs/ja/cloud-environments#access-levels)を持つ **Default** 環境をセットアップします。自動的に作成されるか、作成するよう求められるかのいずれかです。プランごとにどちらになるかについては、[Default 環境](/docs/ja/cloud-environments#the-default-environment)を参照してください

46 42* **セッションが使用する環境**: 複数の環境がある場合にセッションが環境を選択する方法については、[Default 環境](/docs/ja/cloud-environments#the-default-environment)を参照してください

47[クラウド環境を設定](/docs/ja/cloud-environments)して、環境が許可するものを変更し、変数を設定するか、セットアップスクリプトを追加してください。[インストール済みツール](/docs/ja/cloud-environments#installed-tools)を参照して、設定なしでセッションに含まれるものを確認してください。43* **セッションがアクセスできる対象や起動時に実行する内容を変更する**: [クラウド環境を設定する](/docs/ja/cloud-environments)を参照してください

44* **設定なしでインストールされているもの**: [インストール済みツール](/docs/ja/cloud-environments#installed-tools)を参照してください

48 45

49<h2 id="github-authentication-options">46<h2 id="github-authentication-options">

50 GitHub 認証オプション47 GitHub 認証オプション

59 56

~~60Claude GitHub App をリポジトリにインストールすると、そのリポジトリのプルリクエストに対して [Auto-fix](#auto-fix-pull-requests) も有効になります。~~57以下の機能は、リポジトリに Claude GitHub App がインストールされていることが前提となります：

61 58

62[プロジェクト](/docs/ja/claude-projects)内のスレッドは、接続方法に関わらず、クローンする各リポジトリに Claude GitHub App がインストールされている必要があります。[GitHub アクセスの設定](/docs/ja/claude-projects#set-up-github-access)を参照してください。59* **Auto-fix**：Claude GitHub App をリポジトリにインストールすると、そのリポジトリのプルリクエストに対して [Auto-fix](#auto-fix-pull-requests) も有効になります

60* **Projects**：[プロジェクト](/docs/ja/claude-projects)内のスレッドは、接続方法に関わらず、クローンする各リポジトリに Claude GitHub App がインストールされている必要があります。[GitHub アクセスの設定](/docs/ja/claude-projects#set-up-github-access)を参照してください

63 61

64Anthropic ホスト環境では、GitHub 認証情報は Anthropic のサーバー上で暗号化されたままであり、セッションの VM に入ることはありません。VM からの GitHub 操作は [GitHub プロキシ](/docs/ja/cloud-environments#github-proxy)を通じて行われ、サーバー側で認証情報を添付します。62Anthropic ホスト環境では、GitHub 認証情報は Anthropic のサーバー上で暗号化されたままであり、セッションの VM に入ることはありません。VM からの GitHub 操作は [GitHub プロキシ](/docs/ja/cloud-environments#github-proxy)を通じて行われ、サーバー側で認証情報を添付します。

65 63

66`/schedule` がルーチンを作成する前にリポジトリアクセスをチェックする方法については、[リポジトリとブランチの権限](/docs/ja/routines#repositories-and-branch-permissions)を参照してください。`/web-setup` のウォークスルー（`/web-setup` が保存する内容と削除方法を含む）については、[ターミナルから接続](/docs/ja/web-quickstart#connect-from-your-terminal)を参照してください。64`/web-setup` のウォークスルー（`/web-setup` が保存する内容と削除方法を含む）については、[ターミナルから接続](/docs/ja/web-quickstart#connect-from-your-terminal)を参照してください。

68Quick web setup は、メンバーが `/web-setup` で GitHub を接続できるようにする組織設定で、ブラウザオンボーディング中に Claude GitHub App インストールプロンプトをスキップし、環境フォームを表示する代わりに、ブラウザオンボーディングが [**Default** 環境](/docs/ja/cloud-environments#the-default-environment)を作成するようにします。Team および Enterprise プランではデフォルトでオフになっており、`/web-setup` を非表示にします。[Owner](/docs/ja/server-managed-settings#access-control) は [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code) の **Quick web setup** トグルでオンにします。

69 65

70<Note>66<Note>

71 [Zero Data Retention](/docs/ja/zero-data-retention) が有効な組織は `/web-setup` またはその他のクラウドセッション機能を使用できません。67 [Zero Data Retention](/docs/ja/zero-data-retention) が有効な組織は `/web-setup` またはその他のクラウドセッション機能を使用できません。

72</Note>68</Note>

73 69

70<h3 id="quick-setup-for-team-and-enterprise">

71 Team および Enterprise 向けの Quick setup

72</h3>

74Quick setup は、メンバーの GitHub と環境のセットアップの手順を省く組織設定です。Team および Enterprise プランではデフォルトでオフになっています。

76オンにすると、メンバーにとって次の点が変わります：

78* **`/web-setup`**：メンバーは `/web-setup` で GitHub を接続できます。この設定がオフの間、このコマンドは非表示になります

79* **GitHub App のプロンプト**：ブラウザオンボーディングで Claude GitHub App のインストールプロンプトがスキップされます

80* **最初の環境**：ブラウザオンボーディングでは、環境フォームを表示する代わりに、メンバー向けに [**Default** 環境](/docs/ja/cloud-environments#the-default-environment)が作成されます

82[Owner](/docs/ja/server-managed-settings#access-control) は [**Organization settings > Claude Code**](https://claude.ai/admin-settings/claude-code) の **Quick setup** トグルでオンにします。

74<h2 id="move-tasks-between-terminal-and-cloud">84<h2 id="move-tasks-between-terminal-and-cloud">

75 ターミナルとクラウド間でタスクを移動85 ターミナルとクラウド間でタスクを移動

76</h2>86</h2>

78これらのワークフローには [Claude Code CLI](/docs/ja/quickstart) が同じ claude.ai アカウントにサインインしている必要があります。ターミナルから新しいクラウドセッションを開始するか、クラウドセッションをターミナルにプルしてローカルで続行できます。クラウドセッションはラップトップを閉じても保持され、Claude モバイルアプリを含む任意の場所から監視できます。88これらのワークフローには [Claude Code CLI](/docs/ja/quickstart) が同じ claude.ai アカウントにサインインしている必要があります。ターミナルから新しいクラウドセッションを開始するか、クラウドセッションをターミナルにプルしてローカルで続行できます。クラウドセッションはラップトップを閉じても保持され、Claude モバイルアプリを含む任意の場所から監視できます。

79 89

80<Note>90<Note>

81 CLI からのセッションハンドオフは一方向です：`--teleport` でクラウドセッションをターミナルにプルできますが、既存のターミナルセッションをクラウドにプッシュすることはできません。`--cloud` フラグはタスク説明を使用して現在のリポジトリの新しいクラウドセッションを作成します；`-p` とセッション ID または claude.ai/code URL を使用すると、代わりに[その既存セッションにメッセージをキューイング](/docs/ja/claude-code-on-the-web#send-follow-ups-from-the-cli)します。[Desktop アプリ](/docs/ja/desktop#continue-in-another-surface)は別のサーフェスにローカルセッションを送信できる Continue in メニューを提供します。91 CLI からのセッションハンドオフは一方向です：`--teleport` でクラウドセッションをターミナルにプルできますが、既存のターミナルセッションをクラウドにプッシュすることはできません。`--cloud` フラグはタスク説明を使用して現在のリポジトリの新しいクラウドセッションを作成します；`-p` とセッション ID または claude.ai/code URL を使用すると、代わりに[その既存セッションにメッセージをキューイング](/docs/ja/claude-code-on-the-web#send-follow-ups-from-the-cli)します。[Desktop アプリ](/docs/ja/desktop#continue-in-another-surface)では、Code タブのローカルセッションを **Open in** メニューからクラウドに送信できます。

82</Note>92</Note>

83 93

84<h3 id="from-terminal-to-cloud">94<h3 id="from-terminal-to-cloud">

173 CLI からフォローアップを送信183 CLI からフォローアップを送信

174</h3>184</h3>

175 185

176クラウドセッションが実行されている場合、どこで実行されていても、`claude auth login` でサインインしている任意のマシンの `claude` CLI からそれにフォローアップメッセージを送信します。CLI は Anthropic アカウント認証情報で認証し、ローカルセッション状態を送信しないため、コマンドはセッションを開始したマシンから実行する必要がなく、PowerShell を含むすべてのシェルで同じです。186クラウドセッションが実行されている場合、どこで実行されていても、`claude auth login` でサインインしている任意のマシンの `claude` CLI からそれにフォローアップメッセージを送信します。CLI は Anthropic アカウントの認証情報で認証し、ローカルセッション状態を送信しないため、コマンドはセッションを開始したマシンから実行する必要はありません。

177 187

178コマンドは 1 つのメッセージを投稿して終了します：188コマンドは 1 つのメッセージを投稿して終了します：

179 189

189 `--cloud` には Anthropic アカウントが必要です。Claude Code が Amazon Bedrock、Google Cloud の Agent Platform、または別のサードパーティプロバイダー用に設定されている場合は利用できません。`ANTHROPIC_BASE_URL` を通じてのみ設定された[LLM ゲートウェイ](/docs/ja/llm-gateway)はこのチェックではサードパーティプロバイダーとしてカウントされませんが、`claude auth login` でサインインする必要があります。組織の `allow_remote_sessions` ポリシーも有効にする必要があります。Owner は claude.ai/admin-settings/claude-code の Claude Code 管理設定でオンにできます。199 `--cloud` には Anthropic アカウントが必要です。Claude Code が Amazon Bedrock、Google Cloud の Agent Platform、または別のサードパーティプロバイダー用に設定されている場合は利用できません。`ANTHROPIC_BASE_URL` を通じてのみ設定された[LLM ゲートウェイ](/docs/ja/llm-gateway)はこのチェックではサードパーティプロバイダーとしてカウントされませんが、`claude auth login` でサインインする必要があります。組織の `allow_remote_sessions` ポリシーも有効にする必要があります。Owner は claude.ai/admin-settings/claude-code の Claude Code 管理設定でオンにできます。

190</Note>200</Note>

191 201

192<h4 id="output-and-errors">202<h4 id="output">

193 出力とエラー203 出力

194</h4>204</h4>

195 205

196成功時に、コマンドはセッション ID とセッションを表示するリンクを出力します：206成功時に、コマンドはセッション ID とセッションを表示するリンクを出力します：

203 213

204マシン可読結果の場合は `--output-format json` を渡します：成功時は `{ok, session_id, url}`、送信が失敗した場合は `{ok: false, session_id, error}`（例えば、セッションが見つからないか、アーカイブされている場合）。設定エラー（サポートされていないプロバイダーや無効な組織ポリシーなど）は JSON なしで stderr に出力されます。`--output-format stream-json` は `--cloud <session-id>` ではサポートされていません。214マシン可読結果の場合は `--output-format json` を渡します：成功時は `{ok, session_id, url}`、送信が失敗した場合は `{ok: false, session_id, error}`（例えば、セッションが見つからないか、アーカイブされている場合）。設定エラー（サポートされていないプロバイダーや無効な組織ポリシーなど）は JSON なしで stderr に出力されます。`--output-format stream-json` は `--cloud <session-id>` ではサポートされていません。

205 215

206CLI はエラーの前に `Error: ` を付けます。失敗した配信は `failed to send message to cloud session <id>: <reason>` としてラップされます。216送信が失敗した場合は、[クラウドセッションへの送信時のエラー](#errors-when-sending-to-a-cloud-session)を参照してください。

~~207~~

208| メッセージ | 意味 |

209| - | - |

210| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code はサードパーティプロバイダー用に設定されています。メッセージは設定が使用するラベル（`Amazon Bedrock` や `Google Vertex AI` など）でプロバイダーに名前を付けます。そのプロバイダーの設定を削除します（例えば、`CLAUDE_CODE_USE_BEDROCK` を設定解除）、Anthropic アカウント（`claude auth login`）でサインインします。 |

211| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | `allow_remote_sessions` 組織ポリシーがオフです。 |

212| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code は組織のポリシーをフェッチできなかったため、クラウドセッションが許可されていると仮定するのではなく、送信を拒否します。ネットワーク接続を確認して再試行してください。 |

213| `Attaching to an existing cloud session is not enabled for your account.` | `-p` なしで `--cloud <session-id>` を実行しました。`claude -p "your message" --cloud <session-id>` でメッセージを送信します。 |

214| `Session not found: <id>` | ID または URL はアクセスできるセッションと一致しません。セッションの claude.ai/code URL に対して確認してください。 |

215| `cloud session <id> is archived and cannot accept new messages` | セッションはアーカイブされています。代わりに新しいセッションを開始します。 |

216 217

217<h3 id="from-cloud-to-terminal">218<h3 id="from-cloud-to-terminal">

218 クラウドからターミナルへ219 クラウドからターミナルへ

239| 要件 | 詳細 |240| 要件 | 詳細 |

240| - | - |241| - | - |

241| クリーンな git 状態 | 作業ディレクトリにコミットされていない変更がないことが必要です。テレポートは必要に応じて変更をスタッシュするよう求めます。 |242| クリーンな git 状態 | 作業ディレクトリにコミットされていない変更がないことが必要です。テレポートは必要に応じて変更をスタッシュするよう求めます。 |

242| 正しいリポジトリ | フォークではなく、同じリポジトリのチェックアウトから `--teleport` を実行する必要があります。別のリポジトリのチェックアウトから実行する場合、Claude Code はセッションのリポジトリとチェックアウトのリポジトリの両方を示すエラーを表示します。v2.1.219 より前では、エラーはチェックアウトのリポジトリを示していませんでした。Claude Code がリモートをホスト名に解析できない場合（`git@work:owner/repo.git` のような SSH ホストエイリアスなど）、確認を求め、リモートの所有者とリポジトリ名がセッションのリポジトリと一致する場合、チェックアウトを受け入れます。 |243| 正しいリポジトリ | フォークではなく、同じリポジトリのチェックアウトから `--teleport` を実行する必要があります。別のリポジトリのチェックアウトから実行する場合、Claude Code はセッションのリポジトリとチェックアウトのリポジトリの両方を示すエラーを表示します。Claude Code がリモートをホスト名に解析できない場合（`git@work:owner/repo.git` のような SSH ホストエイリアスなど）、確認を求め、リモートの所有者とリポジトリ名がセッションのリポジトリと一致する場合、チェックアウトを受け入れます。 |

243| ブランチが利用可能 | クラウドセッションからのブランチがリモートにプッシュされている必要があります。テレポートは自動的にフェッチしてチェックアウトします。 |244| ブランチが利用可能 | クラウドセッションからのブランチがリモートにプッシュされている必要があります。テレポートは自動的にフェッチしてチェックアウトします。 |

244| 同じアカウント | クラウドセッションで使用された同じ claude.ai アカウントに認証される必要があります。 |245| 同じアカウント | クラウドセッションで使用された同じ claude.ai アカウントに認証される必要があります。 |

245 246

249 `--teleport` が利用できない250 `--teleport` が利用できない

250</h4>251</h4>

251 252

252テレポートには claude.ai サブスクリプション認証が必要です。API キーで認証されている場合は、代わりに claude.ai アカウントでサインインするために `/login` を実行してください。エラーがプロバイダーに名前を付ける場合、クラウドセッションはサードパーティプロバイダーを通じて利用できません；[エラーテーブル](#output-and-errors)を参照してください。claude.ai 経由で既にサインインしており、`--teleport` がまだ利用できない場合は、組織がクラウドセッションを無効にしている可能性があります。253Teleport には claude.ai サブスクリプション認証が必要です。該当するケースを確認してください：

254

255* **API キーで認証されている場合**：代わりに claude.ai アカウントでサインインするために `/login` を実行してください

256* **エラーにプロバイダー名が表示される場合**：クラウドセッションはサードパーティプロバイダーを通じて利用できません。[エラーテーブル](#errors-when-sending-to-a-cloud-session)を参照してください

257* **すでに claude.ai 経由でサインインしている場合**：組織がクラウドセッションを無効にしている可能性があります

253 258

254<h2 id="work-with-sessions">259<h2 id="work-with-sessions">

255 セッションの操作260 セッションの操作

257 262

258セッションは claude.ai/code のサイドバーに表示されます。そこから変更を確認し、チームメイトと共有し、完了した作業をアーカイブするか、セッションを永続的に削除できます。263セッションは claude.ai/code のサイドバーに表示されます。そこから変更を確認し、チームメイトと共有し、完了した作業をアーカイブするか、セッションを永続的に削除できます。

259 264

260<h3 id="take-back-a-queued-message">265<h3 id="permission-modes-in-cloud-sessions">

261 キューに入ったメッセージを取り戻す266 クラウドセッションの権限モード

262</h3>267</h3>

263 268

264Claude が作業中にメッセージを送信すると、Claude がそれを読むまでメッセージはキューに入ります。キューに入ったメッセージを取り戻すには、その上の ✕ をクリックします。テキストはメッセージボックスに戻るため、編集するか別のものを送信できます。269クラウドセッションの[権限モード](/docs/ja/permission-modes)は[モードドロップダウン](/docs/ja/permission-modes#switch-permission-modes)から選択します。タスクを作成するときとセッションが実行されている間の両方で選択できます。

265 270

266Claude がすでにメッセージを読んでいる場合、それは会話に留まります。271次のいずれかを行うと、Claude Code はセッションが直前にあった権限モードでセッションを再開します：

272

273* Anthropic ホスト型の[環境が有効期限切れ](#environment-expired)になったセッションを再度開く

274* セルフホスト型ランナーが[アイドル中にリリース](/docs/ja/self-hosted-environments-reference#runner-cli-flags)したセッションにメッセージを送信する

275

276<h3 id="review-changes">

277 変更を確認

278</h3>

279

280各セッションは追加および削除された行数を示す差分インジケーター（例：`+42 -18`）を表示します。それを選択して差分ビューを開き、特定の行にインラインコメントを残し、次のメッセージで Claude に送信します。

281

282差分ビューは、デフォルトでセッションの変更をそのベースブランチと比較します。リポジトリ内の他の任意のブランチと比較するには、**Compare against** を選択してブランチを 1 つ選びます。

283

284Claude Code はこれらの差分を raw git blob コンテンツから計算するため、リポジトリで設定された diff ドライバーと `textconv` フィルターは適用されません。

285

286以下の手順は別の場所で説明しています：

287

288* **PR 作成を含む完全なウォークスルー**：[Review and iterate](/docs/ja/web-quickstart#review-and-iterate) を参照してください

289* **Claude に PR の CI 失敗とレビューコメントを自動的に監視させる**：[プルリクエストの自動修正](#auto-fix-pull-requests)を参照してください

267 290

268<h3 id="manage-context">291<h3 id="manage-context">

269 コンテキストを管理292 コンテキストを管理

291 314

292[Agent teams](/docs/ja/agent-teams)はデフォルトでオフですが、[環境変数](/docs/ja/cloud-environments#set-environment-variables)に `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を追加することで有効にできます。315[Agent teams](/docs/ja/agent-teams)はデフォルトでオフですが、[環境変数](/docs/ja/cloud-environments#set-environment-variables)に `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を追加することで有効にできます。

293 316

294<h3 id="permission-modes-in-cloud-sessions">317<h3 id="take-back-a-queued-message">

295 クラウドセッションの権限モード318 キューに入ったメッセージを取り戻す

296</h3>

~~297~~

298クラウドセッションの[権限モード](/docs/ja/permission-modes)は[モードドロップダウン](/docs/ja/permission-modes#switch-permission-modes)から選択します。タスクを作成するときとセッションが実行されている間の両方です。Anthropic ホスト型[環境が有効期限切れ](#environment-expired)になったセッションを再度開くか、セルフホスト型ランナーが[アイドル中にリリース](/docs/ja/self-hosted-environments-reference#runner-cli-flags)したセッションにメッセージを送信する場合、Claude Code はセッションが存在していた権限モードで再開されます。

~~299~~

300<h3 id="review-changes">

301 変更を確認

302</h3>319</h3>

303 320

304各セッションは追加および削除された行数を示す diff インジケーター（例：`+42 -18`）を表示します。それを選択して diff ビューを開き、特定の行にインラインコメントを残し、次のメッセージで Claude に送信します。321Claude が作業中にメッセージを送信すると、Claude がそれを読むまでメッセージはキューに入ります。キューに入ったメッセージを取り戻すには、その上の ✕ をクリックします。テキストはメッセージボックスに戻るため、編集するか別のものを送信できます。

~~305~~

306diff ビューは、デフォルトでセッションの変更をそのベースブランチと比較します。リポジトリ内の他の任意のブランチと比較するには、**Compare against** を選択してブランチを 1 つ選びます。

~~307~~

308Claude Code はこれらの diff を計算します。これには Claude が編集するときに表示される per-file diff が含まれます。これは raw git blob コンテンツから計算されるため、リポジトリで設定された diff ドライバーと `textconv` フィルターは適用されません。セッション自体のチェックアウトではないリポジトリ内のファイル（セッション中にワークスペース内にクローンされたファイルなど）の場合、per-file diff は git 比較ではなく Claude の編集そのものを表示します。

309 322

310完全なウォークスルー（PR 作成を含む）については [Review and iterate](/docs/ja/web-quickstart#review-and-iterate) を参照してください。Claude が PR の CI 失敗とレビューコメントを自動的に監視するようにするには、[プルリクエストの自動修正](#auto-fix-pull-requests)を参照してください。323Claude がすでにメッセージを読んでいる場合、それは会話に留まります。

311 324

312<h3 id="share-sessions">325<h3 id="share-sessions">

313 セッションを共有326 セッションを共有

319 Enterprise または Team アカウントから共有332 Enterprise または Team アカウントから共有

320</h4>333</h4>

321 334

322Enterprise および Team アカウントの場合、2 つの可視性オプションは **Private** と **Team** です。Team 可視性により、セッションは claude.ai 組織の他のメンバーに表示されます。[Claude in Slack](/docs/ja/slack)セッションは自動的に Team 可視性で共有されます。335Enterprise および Team アカウントでは、共有は次のように機能します：

323 336

324リポジトリアクセス検証はデフォルトで有効になっており、受信者のアカウントに接続された GitHub アカウントに基づいています。アカウントの表示名はアクセス権を持つすべての受信者に表示されます。337* **可視性オプション**：**Private** と **Team**。Team 可視性により、セッションは claude.ai 組織の他のメンバーに表示されます

338* **リポジトリアクセス**：検証はデフォルトで有効になっており、受信者のアカウントに接続された GitHub アカウントに基づいて行われます

339* **ユーザーの名前**：アカウントの表示名はアクセス権を持つすべての受信者に表示されます

340* **Slack セッション**：[Claude in Slack](/docs/ja/slack) セッションは自動的に Team 可視性で共有されます

325 341

326<h4 id="share-from-a-max-or-pro-account">342<h4 id="share-from-a-max-or-pro-account">

327 Max または Pro アカウントから共有343 Max または Pro アカウントから共有

328</h4>344</h4>

329 345

330Max および Pro アカウントの場合、2 つの可視性オプションは **Private** と **Public** です。Public 可視性により、セッションは claude.ai にログインしているすべてのユーザーに表示されます。346Max および Pro アカウントでは、共有は次のように機能します：

331 347

332共有する前にセッションで機密コンテンツを確認してください。セッションにはプライベート GitHub リポジトリのコードと認証情報が含まれる可能性があります。リポジトリアクセス検証はデフォルトで有効になっていません。348* **可視性オプション**：**Private** と **Public**。Public 可視性により、セッションは claude.ai にログインしているすべてのユーザーに表示されます

349* **リポジトリアクセス**：検証はデフォルトで有効になっていません

350* **機密コンテンツ**：共有する前にセッションを確認してください。セッションにはプライベート GitHub リポジトリのコードと認証情報が含まれる可能性があります

333 351

334受信者がリポジトリアクセスを持つことを要求するか、共有セッションから名前を非表示にするには、[**Settings > Claude Code > Sharing settings**](https://claude.ai/settings/claude-code) に移動します。352受信者がリポジトリアクセスを持つことを要求するか、共有セッションから名前を非表示にするには、[**Settings > Claude Code > Sharing settings**](https://claude.ai/settings/claude-code) に移動します。

335 353

421 組織 UUID を取得できない439 組織 UUID を取得できない

422</h3>440</h3>

423 441

424`claude --cloud` と `claude --teleport` には claude.ai アカウントでのサインインが必要です。API キーで認証されている場合、または保存されたアカウント詳細が古い場合、これらのコマンドは `Unable to get organization UUID` で失敗するか、API キー認証が十分でないというメッセージが表示されます。API キー認証または古いアカウント詳細を使用して、セッション ID なしで `claude --teleport` を実行すると、どちらかのメッセージの代わりにセッションピッカーで `Error loading Claude Code sessions` が表示され、同じ修正が適用されます。442`claude --cloud` と `claude --teleport` には claude.ai アカウントでのサインインが必要です。API キーで認証している場合、または保存されたアカウント詳細が古い場合、次のいずれかが表示されます。

443

444* `Unable to get organization UUID`

445* API キー認証では不十分であるというメッセージ

446* セッション ID なしで `claude --teleport` を実行した場合、セッションピッカーでの `Error loading Claude Code sessions`

425 447

426`/login` を実行して claude.ai アカウントでサインインし、コマンドを再試行してください。エラーがプロバイダーに名前を付ける場合は、[エラーテーブル](#output-and-errors)を参照してください：クラウドセッションはサードパーティプロバイダーを通じて利用できません。448`/login` を実行して claude.ai アカウントでサインインし、コマンドを再試行してください。エラーにプロバイダー名が示されている場合は、[エラーテーブル](#errors-when-sending-to-a-cloud-session)を参照してください。クラウドセッションはサードパーティプロバイダーを通じては利用できません。

427 449

428<h3 id="remote-control-session-expired-or-access-denied">450<h3 id="remote-control-session-expired-or-access-denied">

429 Remote Control セッションの有効期限切れまたはアクセス拒否451 Remote Control セッションの有効期限切れまたはアクセス拒否

435* セッションを所有する同じアカウントにサインインしていることを確認してください457* セッションを所有する同じアカウントにサインインしていることを確認してください

436* `Remote Control may not be available for this organization` が表示される場合、Owner がクラウドセッションを組織に対して有効にしていません458* `Remote Control may not be available for this organization` が表示される場合、Owner がクラウドセッションを組織に対して有効にしていません

437 459

460<h3 id="errors-when-sending-to-a-cloud-session">

461 クラウドセッションへの送信時のエラー

462</h3>

463

464これらのエラーは、`-p` の有無にかかわらず、[`--cloud <session-id>`](#send-follow-ups-from-the-cli) を指定して `claude` を実行したときに発生します。CLI はエラーの先頭に `Error: ` を付けます。配信に失敗した場合は `failed to send message to cloud session <id>: <reason>` としてラップされます。

465

466| メッセージ | 意味 |

467| - | - |

468| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code がサードパーティプロバイダー向けに設定されています。メッセージには、`Amazon Bedrock` や `Google Vertex AI` など、設定で使用されているラベルでプロバイダー名が示されます。たとえば `CLAUDE_CODE_USE_BEDROCK` の設定を解除するなどしてそのプロバイダーの設定を削除し、Anthropic アカウントでサインインしてください（`claude auth login`）。 |

469| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | `allow_remote_sessions` 組織ポリシーがオフになっています。 |

470| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code が組織のポリシーを取得できなかったため、クラウドセッションが許可されていると仮定せずに送信を拒否しています。ネットワーク接続を確認して再試行してください。 |

471| `Attaching to an existing cloud session is not enabled for your account.` | `-p` なしで `--cloud <session-id>` を実行しました。`claude -p "your message" --cloud <session-id>` でメッセージを送信してください。 |

472| `Session not found: <id>` | ID または URL が、アクセス可能なセッションと一致しません。セッションの claude.ai/code URL と照合してください。 |

473| `cloud session <id> is archived and cannot accept new messages` | セッションはアーカイブされています。代わりに新しいセッションを開始してください。 |

474

438<h3 id="environment-expired">475<h3 id="environment-expired">

439 環境の有効期限切れ476 環境の有効期限切れ

440</h3>477</h3>

441 478

442クラウドセッションは非アクティブ期間後に停止し、セッションの VM は回収されます。セッションは [MCP コネクタ](/docs/ja/cloud-environments#network-access)ツール呼び出しを承認するか、MCP サーバーにサインインするのを待っている間、非アクティブとしてカウントされ、その待機中に有効期限が切れる可能性があります。479クラウドセッションは非アクティブ期間後に停止し、セッションの VM は回収されます。セッションは [MCP コネクタ](/docs/ja/cloud-environments#network-access)ツール呼び出しを承認するか、MCP サーバーにサインインするのを待っている間、非アクティブとしてカウントされ、その待機中に有効期限が切れる可能性があります。

443 480

444[claude.ai/code](https://claude.ai/code) からセッションを再度開いて、会話履歴が復元された新しい VM をプロビジョニングしてください。VM が回収されたときにまだ実行されていたバックグラウンド作業（subagents やシェルコマンドなど）は復元されません。481[claude.ai/code](https://claude.ai/code) からセッションを再度開いて、新しい VM をプロビジョニングしてください。

482

483* **復元されるもの**: 会話履歴

484* **復元されないもの**: VM が回収されたときにまだ実行されていたバックグラウンド作業（サブエージェントやシェルコマンドなど）

445 485

446<h2 id="limitations">486<h2 id="limitations">

447 制限事項487 制限事項

claude-directory.md +4 −4

Details

429 badge: 'local',429 badge: 'local',

430 oneLiner: 'App state and UI preferences',430 oneLiner: 'App state and UI preferences',

431 when: <>Read at session start for your preferences and MCP servers. Claude Code writes back to it when you change settings in <C>/config</C> or approve trust prompts</>,431 when: <>Read at session start for your preferences and MCP servers. Claude Code writes back to it when you change settings in <C>/config</C> or approve trust prompts</>,

432 description: <>Holds state that does not belong in settings.json: theme, OAuth session, per-project trust decisions, your personal MCP servers, and UI toggles. Mostly managed through <C>/config</C> rather than editing directly.</>,432 description: <>Holds state that does not belong in settings.json: OAuth session, per-project trust decisions, your personal MCP servers, and UI toggles. Mostly managed through <C>/config</C> rather than editing directly.</>,

433 tips: [<>IDE toggles like <C>autoConnectIde</C> and <C>externalEditorContext</C> live here, not in settings.json</>, <>The <C>projects</C> key tracks per-project state like trust-dialog acceptance and last-session metrics. Permission rules you approve in-session go to <C>.claude/settings.local.json</C> instead</>, <>MCP servers here are yours only: user scope applies across all projects, local scope is per-project but not committed. Team-shared servers go in <C>.mcp.json</C> at the project root instead</>],433 tips: [<>IDE toggles like <C>autoConnectIde</C> and <C>externalEditorContext</C> live here, not in settings.json</>, <>The <C>projects</C> key tracks per-project state like trust-dialog acceptance and last-session metrics. Permission rules you approve in-session go to <C>.claude/settings.local.json</C> instead</>, <>MCP servers here are yours only: user scope applies across all projects, local scope is per-project but not committed. Team-shared servers go in <C>.mcp.json</C> at the project root instead</>],

434 example: `{434 example: `{

435 "autoConnectIde": true,435 "autoConnectIde": true,

497 oneLiner: 'Custom keyboard shortcuts',497 oneLiner: 'Custom keyboard shortcuts',

498 when: 'Read at session start and hot-reloaded when you edit the file',498 when: 'Read at session start and hot-reloaded when you edit the file',

499 description: <>Rebind keyboard shortcuts in the interactive CLI. Run <C>/keybindings</C> to create or open this file with a schema reference. Ctrl+C, Ctrl+D, Ctrl+M, and Caps Lock are reserved and cannot be rebound.</>,499 description: <>Rebind keyboard shortcuts in the interactive CLI. Run <C>/keybindings</C> to create or open this file with a schema reference. Ctrl+C, Ctrl+D, Ctrl+M, and Caps Lock are reserved and cannot be rebound.</>,

500 exampleIntro: <>This example binds <C>Ctrl+E</C> to open your external editor and unbinds <C>Ctrl+U</C> by setting it to <C>null</C>. The <C>context</C> field scopes bindings to a specific part of the CLI, here the main chat input.</>,500 exampleIntro: <>This example binds <C>Ctrl+E</C> to open your external editor and unbinds <C>Ctrl+S</C> by setting it to <C>null</C>. The <C>context</C> field scopes bindings to a specific part of the CLI, here the main chat input.</>,

501 example: `{501 example: `{

502 "$schema": "https://www.schemastore.org/claude-code-keybindings.json",502 "$schema": "https://www.schemastore.org/claude-code-keybindings.json",

503 "$docs": "https://code.claude.com/docs/en/keybindings",503 "$docs": "https://code.claude.com/docs/en/keybindings",

506 "context": "Chat",506 "context": "Chat",

507 "bindings": {507 "bindings": {

508 "ctrl+e": "chat:externalEditor",508 "ctrl+e": "chat:externalEditor",

509 "ctrl+u": null509 "ctrl+s": null

510 }510 }

511 }511 }

512 ]512 ]

1455| `managed-settings.json` | システムレベル、OS によって異なる | エンタープライズが強制する設定で、[限定的な例外](/docs/ja/settings#security-keys-where-the-stricter-value-applies)を除いてオーバーライドできません。[ファイルの保存場所](/docs/ja/managed-settings#deploy-a-managed-settings-file)と [Claude Code が使用する管理ソース](/docs/ja/managed-settings#precedence-within-the-managed-tier)を参照してください。 |1455| `managed-settings.json` | システムレベル、OS によって異なる | エンタープライズが強制する設定で、[限定的な例外](/docs/ja/settings#security-keys-where-the-stricter-value-applies)を除いてオーバーライドできません。[ファイルの保存場所](/docs/ja/managed-settings#deploy-a-managed-settings-file)と [Claude Code が使用する管理ソース](/docs/ja/managed-settings#precedence-within-the-managed-tier)を参照してください。 |

1457| `AGENTS.md` | プロジェクトルート、`.claude/`、または任意のディレクトリ | AI コーディングエージェント向けに作成するプロジェクト指示。Claude Code は[それを読み込む](/docs/ja/memory#agents-md)ことができます。これは独立して、または `CLAUDE.md` と一緒に読み込まれます。 |1457| `AGENTS.md` | プロジェクトルート、`.claude/`、または任意のディレクトリ | AI コーディングエージェント向けに作成するプロジェクト指示。Claude Code は[それを読み込む](/docs/ja/memory#agents-md)ことができます。これは独立して、または `CLAUDE.md` と一緒に読み込まれます。 |

1458| インストール済みプラグイン | `~/.claude/plugins` | クローンされたマーケットプレイス、インストール済みプラグインバージョン、`installed_plugins.json` インストール記録、およびプラグインごとのデータで、`claude plugin` コマンドで管理されます。プラグイン[あなたの claude.ai アカウントから同期](/docs/ja/plugins/loading#synced-plugins)は `~/.claude/plugins/synced/` にダウンロードされます。リンクモードでマーケットプレイス [`command` ソース](/docs/ja/plugins/marketplace-reference#command-plugin-source)からインストールされたプラグインの場合、Claude Code はコピーの代わりにここにリンクを保存し、プラグインのファイルはコマンドが出力するディレクトリに留まります。`command` ソースには Claude Code v2.1.229 以降が必要です。ローカルディレクトリマーケットプレイスで相対パスでリストされているプラグインも、キャッシュコピーではなく、ソースディレクトリから[その場で読み込まれます](/docs/ja/plugins/loading#find-plugins-on-disk)。[プラグインキャッシング](/docs/ja/plugins/loading#find-plugins-on-disk)を参照して、孤立したバージョンがどのようにクリーンアップされるかを確認してください。 |1458| インストール済みプラグイン | `~/.claude/plugins` | クローンされたマーケットプレイス、インストール済みプラグインバージョン、`installed_plugins.json` インストール記録、およびプラグインごとのデータで、`claude plugin` コマンドで管理されます。[claude.ai アカウントから同期された](/docs/ja/plugins/loading#synced-plugins)プラグインは `~/.claude/plugins/synced/` にダウンロードされます。リンクモードでマーケットプレイス [`command` ソース](/docs/ja/plugins/marketplace-reference#command-plugin-source)からインストールされたプラグインの場合、Claude Code はコピーの代わりにここにリンクを保存し、プラグインのファイルはコマンドが出力するディレクトリに留まります。`command` ソースには Claude Code v2.1.229 以降が必要です。ローカルパスから追加したマーケットプレイスで相対パスによってリストされているプラグインも、キャッシュコピーではなく、ソースディレクトリから[その場で読み込まれます](/docs/ja/plugins/loading#find-plugins-on-disk)。[プラグインキャッシング](/docs/ja/plugins/loading#find-plugins-on-disk)を参照して、孤立したバージョンがどのようにクリーンアップされるかを確認してください。 |

1459 1459

1460`~/.claude` はまた、Claude Code があなたが作業する際に書き込むデータも保持しています。トランスクリプト、プロンプト履歴、ファイルスナップショット、キャッシュ、およびログです。下記の[アプリケーションデータ](#application-data)を参照してください。1460`~/.claude` はまた、Claude Code があなたが作業する際に書き込むデータも保持しています。トランスクリプト、プロンプト履歴、ファイルスナップショット、キャッシュ、およびログです。下記の[アプリケーションデータ](#application-data)を参照してください。

1461 1461

cloud-environments.md +1 −1

Details

26 26

27* **`/web-setup` などの CLI フロー**：**Default** を作成します27* **`/web-setup` などの CLI フロー**：**Default** を作成します

28* **Pro および Max での Web オンボーディング**：**Default** を作成します28* **Pro および Max での Web オンボーディング**：**Default** を作成します

29* **Team および Enterprise での Web オンボーディング**：オーナーが [Quick web setup](/docs/ja/claude-code-on-the-web#github-authentication-options) をオンにしていない限り、**最初のクラウド環境を作成** フォームを表示します。フォームのデフォルトを保持して **作成して完了** をクリックして、同じ **Default** 環境を取得します29* **Team および Enterprise での Web オンボーディング**：オーナーが [Quick setup](/docs/ja/claude-code-on-the-web#quick-setup-for-team-and-enterprise) をオンにしていない限り、**最初のクラウド環境を作成** フォームを表示します。フォームのデフォルトを保持して **作成して完了** をクリックして、同じ **Default** 環境を取得します

30 30

31**Default** は独自の設定を持ちません。31**Default** は独自の設定を持ちません。

32 32

costs.md +1 −1

Details

114| ロール | `/usage-credits` の動作 |114| ロール | `/usage-credits` の動作 |

115| :- | :- |115| :- | :- |

116| Pro または Max サブスクライバー | ブラウザで [**Settings > Usage**](https://claude.ai/settings/usage) を claude.ai で開きます。**Usage credits** セクションで、使用量クレジットをオンまたはオフにし、クレジット残高、今月の支出、および月間支出制限を確認できます |116| Pro または Max サブスクライバー | ブラウザで [**Settings > Usage**](https://claude.ai/settings/usage) を claude.ai で開きます。**Usage credits** セクションで、使用量クレジットをオンまたはオフにし、クレジット残高、今月の支出、および月間支出制限を確認できます |

117| 請求アクセス権を持つ Team または Enterprise メンバー | 組織の使用量設定 [**Admin settings > Usage**](https://claude.ai/admin-settings/usage) をブラウザで開きます |117| 請求アクセス権を持つ Team または Enterprise メンバー | 組織の使用量設定である [**Organization settings > Usage**](https://claude.ai/admin-settings/usage) をブラウザで開きます |

118| 請求アクセス権を持たない Team または Enterprise メンバー | 確認を求めてから、組織の管理者にリクエストを送信します。v2.1.211 より前では、Claude Code は確認ステップなしでリクエストを送信していました |118| 請求アクセス権を持たない Team または Enterprise メンバー | 確認を求めてから、組織の管理者にリクエストを送信します。v2.1.211 より前では、Claude Code は確認ステップなしでリクエストを送信していました |

119 119

120請求アクセス権を持たない Team および Enterprise メンバーの場合、確認はインタラクティブセッションでのみ表示されます。`-p` フラグを使用した非インタラクティブモードおよび [Remote Control](/docs/ja/remote-control) からは、コマンドはリクエストを送信せず、インタラクティブセッションで実行するよう指示します。120請求アクセス権を持たない Team および Enterprise メンバーの場合、確認はインタラクティブセッションでのみ表示されます。`-p` フラグを使用した非インタラクティブモードおよび [Remote Control](/docs/ja/remote-control) からは、コマンドはリクエストを送信せず、インタラクティブセッションで実行するよう指示します。

cross-session-messaging.md +1 −0

Details

192以下のいずれかで完全なテキストが表示されます。192以下のいずれかで完全なテキストが表示されます。

193 193

194* `Ctrl+O` を押して[トランスクリプトビューア](/docs/ja/interactive-mode#transcript-viewer)を開き、送信者のセッション名の下で完全なテキストを読みます。194* `Ctrl+O` を押して[トランスクリプトビューア](/docs/ja/interactive-mode#transcript-viewer)を開き、送信者のセッション名の下で完全なテキストを読みます。

195* [フルスクリーンレンダリング](/docs/ja/fullscreen#use-the-mouse)では、メッセージの一部が省略されているプレビュー行をクリックすると、その場で展開されます。

195* [`--verbose`](/docs/ja/cli-reference#cli-flags) で開始されたセッションでは、Claude Code はプレビューではなく完全なテキストを表示します。196* [`--verbose`](/docs/ja/cli-reference#cli-flags) で開始されたセッションでは、Claude Code はプレビューではなく完全なテキストを表示します。

196 197

197プレビューは表示内容のみを短縮します。展開するかどうかに関わらず、Claude はメッセージ全体を読みます。198プレビューは表示内容のみを短縮します。展開するかどうかに関わらず、Claude はメッセージ全体を読みます。

desktop.md +16 −16

Details

244 ビューモードを切り替える244 ビューモードを切り替える

245</h3>245</h3>

246 246

247ビューモードは、チャットトランスクリプトに表示される詳細の量を制御します。送信ボタンの横の**Transcript view**ドロップダウンからモードを切り替えるか、macOS または Windows で**Ctrl+O**を押してモードをサイクルします。Thinking モードは、Claude がセッションで思考を生成した後にのみドロップダウンに表示されます。247ビューモードは、チャットトランスクリプトに表示される詳細の量を制御します。ビューモードを切り替えるには、セッションタイトルの横のキャレットからセッションメニューを開いて**Transcript view**を選択するか、macOS または Windows で**Ctrl+O**を押してモードをサイクルします。Thinking モードは、表示しているセッションで Claude が思考を生成した後にのみメニューに表示されます。

248 248

249| モード | 表示内容 |249| モード | 表示内容 |

250| - | - |250| - | - |

418 セッション間で作業する418 セッション間で作業する

419</h3>419</h3>

420 420

421Claude はあなたの他の Code タブセッションをリストアップし、各セッションが何をしてきたかを読み取り、セッション間でメッセージを送信できます。平易な言語で尋ねてください：「どのセッションが認証リファクタリングに触れましたか？」、「API セッションは何を結論づけましたか？」、または「支払いセッションにスキーマが変更されたことを伝えてください」。また、Claude にセッションの名前変更またはアーカイブを依頼することもできます。Claude はサイドバーのアーカイブアイコンと同じ方法でセッションをアーカイブするため、PR がマージされたセッションをクリーンアップするよう依頼してください。421Claude は他の Code タブセッションをリストアップし、各セッションが何をしてきたかを読み取り、セッション間でメッセージを送信できます。平易な言語で尋ねてください：「どのセッションが認証リファクタリングに触れましたか？」、「API セッションは何を結論づけましたか？」、または「支払いセッションにスキーマが変更されたことを伝えてください」。また、Claude にセッションの名前変更またはアーカイブを依頼することもできます。Claude はサイドバーのアーカイブアイコンと同じ方法でセッションをアーカイブするため、PR がマージされたセッションをクリーンアップするよう依頼してください。

422 422

423このサーフェスを通じて、Claude はデスクトップアプリが自身で実行するセッションのみを見ます：ローカル、[SSH](#ssh-sessions)、および Code タブの[WSL](/docs/ja/desktop-wsl)セッション。Claude はクラウドセッション、またはターミナル CLI または VS Code 拡張機能から開始したセッションを見ません。同じプロジェクトの worktrees にあっても見ません。そのため、9 つのターミナル worktrees が開いていて 2 つのデスクトップセッションがある場合、それらの 1 つで回答する Claude は他の 1 つのデスクトップセッションを報告します。Claude は質問しているセッションをリストアップしません。デフォルトでは、最近アクティブな 20 個のセッションを見て、アーカイブされたセッションをスキップします。ただし、それらを要求する場合を除きます。[クロスセッションメッセージング](/docs/ja/cross-session-messaging)は、Claude が[あなたの他の Claude Code セッション](/docs/ja/cross-session-messaging#see-which-sessions-claude-can-reach)（ターミナルセッションを含む）にメッセージを送信することを別途許可します。423このサーフェスを通じて、Claude はデスクトップアプリが自身で実行するセッションのみを見ます：ローカル、[SSH](#ssh-sessions)、および Code タブの[WSL](/docs/ja/desktop-wsl)セッション。Claude はクラウドセッション、またはターミナル CLI または VS Code 拡張機能から開始したセッションを見ません。同じプロジェクトの worktrees にあっても見ません。そのため、9 つのターミナル worktrees が開いていて 2 つのデスクトップセッションがある場合、それらの 1 つで回答する Claude は他の 1 つのデスクトップセッションを報告します。Claude は質問しているセッションをリストアップしません。デフォルトでは、最近アクティブな 20 個のセッションを見て、アーカイブされたセッションをスキップします。ただし、それらを要求する場合を除きます。[クロスセッションメッセージング](/docs/ja/cross-session-messaging)は、Claude が[他の Claude Code セッション](/docs/ja/cross-session-messaging#see-which-sessions-claude-can-reach)（ターミナルセッションを含む）にメッセージを送信することを別途許可します。

424 424

425Claude がこのサーフェスを通じて別のセッションにメッセージを送信する場合、Claude Code はそこにカードとして表示され、送信セッションのタイトルでラベル付けされ、戻るリンクが付いているため、メッセージがどこから来たかを常に知ることができます。受信セッションがタスクの途中にある場合、Claude Code はメッセージを保持し、Claude は現在の作業が完了したら読み取ります。受信する Claude は返信でき、Claude Code はこのサーフェスを通じて返信を配信します。Claude はアーカイブされたセッションに配信できず、メッセージが通らない場合はあなたに通知します。425Claude がこのサーフェスを通じて別のセッションにメッセージを送信する場合、Claude Code はそこにカードとして表示され、送信セッションのタイトルでラベル付けされ、戻るリンクが付いているため、メッセージがどこから来たかを常に知ることができます。受信セッションがタスクの途中にある場合、Claude Code はメッセージを保持し、Claude は現在の作業が完了したら読み取ります。受信する Claude は返信でき、Claude Code はこのサーフェスを通じて返信を配信します。Claude はアーカイブされたセッションに配信できず、メッセージが届かない場合は通知します。

426 426

427Claude Code はセッション間で 4 つの安全動作を適用します：427Claude Code はセッション間で 4 つの安全動作を適用します：

428 428

429* セッションをアーカイブする前に、Claude はまずあなたに尋ねます。Auto および Bypass 権限を含むすべての権限モードで承認カードが表示されます。429* セッションをアーカイブする前に、Claude はまずユーザーに確認します。Auto および Bypass 権限を含むすべての権限モードで承認カードが表示されます。

430* このサーフェスを通じて、Claude はスケジュール済みタスク実行など、誰も見ていないセッションからクロスセッションメッセージを送信できず、1 つに配信することもできません。430* このサーフェスを通じて、Claude はスケジュールタスクの実行など、誰も見ていないセッションからクロスセッションメッセージを送信できず、そのようなセッションにメッセージを配信することもできません。

431* Claude Code は、受信セッションが[クロスセッションメッセージング](/docs/ja/cross-session-messaging#availability)自体を持たない場合でも、このサーフェスからの各メッセージを受信セッションの[インバウンドコントロール](/docs/ja/cross-session-messaging#control-inbound-messages)に対してチェックします。受信セッションで[`crossSessionInbound`](/docs/ja/settings-reference#crosssessioninbound)を`refuse`に設定した場合、Claude Code はこのサーフェスからのメッセージをドロップします。Claude Code は拒否を Claude デスクトップアプリに報告します。v2.1.234 より前では、Claude Code はこのサーフェスからクロスセッションメッセージングを持たない受信セッションへのすべてのメッセージをドロップしました。431* Claude Code は、受信セッションが[クロスセッションメッセージング](/docs/ja/cross-session-messaging#availability)自体を持たない場合でも、このサーフェスからの各メッセージを受信セッションの[インバウンドコントロール](/docs/ja/cross-session-messaging#control-inbound-messages)に対してチェックします。受信セッションで[`crossSessionInbound`](/docs/ja/settings-reference#crosssessioninbound)を`refuse`に設定した場合、Claude Code はこのサーフェスからのメッセージをドロップします。Claude Code は拒否を Claude デスクトップアプリに報告します。v2.1.234 より前では、Claude Code はこのサーフェスからクロスセッションメッセージングを持たない受信セッションへのすべてのメッセージをドロップしました。

432* Claude Code は各受信メッセージを引用し、それを送信したセッションに属性を付け、Claude は受信セッション自体の権限設定に従って 1 つに対して行動します。432* Claude Code は各受信メッセージを引用して送信元のセッションを明示し、Claude はメッセージに基づいて行動する際も受信セッション自体の権限設定に従います。

433 433

434Claude は新しいセッションを提案することもできます。現在のタスクの範囲外で修正する価値があるものに気付くと、作業をチャットのタスクチップとして提供します。チップをクリックして、独自の worktree を持つ新しいセッションでその作業を開始します。Claude は現在のセッションを中断なく続行します。434Claude は新しいセッションを提案することもできます。現在のタスクの範囲外で修正する価値があるものに気付くと、作業をチャットのタスクチップとして提供します。チップをクリックして、独自の worktree を持つ新しいセッションでその作業を開始します。Claude は現在のセッションを中断なく続行します。

435 435

437 長時間実行されるタスクをクラウドで実行する437 長時間実行されるタスクをクラウドで実行する

438</h3>438</h3>

439 439

440大規模なリファクタリング、テストスイート、マイグレーション、またはその他の長時間実行されるタスクの場合、セッションを開始するときに**Local**の代わりに**Cloud**を選択します。Cloud セッションはデフォルトで Anthropic が管理するインフラストラクチャで実行され、アプリを閉じたりコンピュータをシャットダウンしたりしても続行します。いつでも戻ってきて進捗を確認するか、Claude を別の方向に導くことができます。[claude.ai/code](https://claude.ai/code)または[Claude モバイルアプリ](/docs/ja/mobile)から Cloud セッションを監視することもできます。440大規模なリファクタリング、テストスイート、マイグレーション、またはその他の長時間実行されるタスクの場合、セッションを開始するときに**Local**の代わりに**Cloud**を選択します。クラウドセッションはデフォルトで Anthropic が管理するインフラストラクチャで実行され、アプリを閉じたりコンピュータをシャットダウンしたりしても続行します。いつでも戻ってきて進捗を確認するか、Claude を別の方向に導くことができます。[claude.ai/code](https://claude.ai/code)または[Claude モバイルアプリ](/docs/ja/mobile)からクラウドセッションを監視することもできます。

441 441

442Cloud セッションは複数のリポジトリもサポートしています。クラウド環境を選択した後、選択されたリポジトリの横の\*\*+\*\*ボタンをクリックして、セッションに追加のリポジトリを追加します。各リポジトリは独自のブランチセレクタを取得します。これは共有ライブラリとそのコンシューマーの更新など、複数のコードベースにまたがるタスクに便利です。442クラウドセッションは複数のリポジトリもサポートしています。クラウド環境を選択した後、選択されたリポジトリの横の\*\*+\*\*ボタンをクリックして、セッションに追加のリポジトリを追加します。各リポジトリは独自のブランチセレクタを取得します。これは共有ライブラリとそのコンシューマーの更新など、複数のコードベースにまたがるタスクに便利です。

443 443

444Cloud セッションがどのように機能するかについての詳細については、[Web 上の Claude Code](/docs/ja/claude-code-on-the-web)を参照してください。1 つの作業本体が多くの Cloud セッションを必要とする場合、サイドバーで**Projects**を選択して[プロジェクト](/docs/ja/claude-projects)を作成します。Claude はそこから 1 つの会話でセッションを開始して追跡します。444クラウドセッションがどのように機能するかについての詳細については、[クラウドで Claude Code を使用する](/docs/ja/claude-code-on-the-web)を参照してください。1 つの作業本体が多くのクラウドセッションを必要とする場合、サイドバーで**Projects**を選択して[プロジェクト](/docs/ja/claude-projects)を作成します。Claude はそこから 1 つの会話でセッションを開始して追跡します。

445 445

446<h3 id="continue-in-another-surface">446<h3 id="continue-in-another-surface">

447 別のサーフェスで続行する447 別のサーフェスで続行する

448</h3>448</h3>

449 449

450セッションツールバーの右下の VS Code アイコンからアクセスできる**Continue in**メニューを使用すると、セッションを別のサーフェスに移動できます：450セッションを別の場所で続行するには、セッションタイトルの横のキャレット、またはサイドバーのセッションの行からセッションメニューを開き、**Open in**を選択します：

451 451

452* **Claude Code on the Web**：ローカルセッションをクラウドで実行し続けるために送信します。Desktop はブランチをプッシュし、会話の要約を生成し、完全なコンテキストを持つ新しい Cloud セッションを作成します。その後、ローカルセッションをアーカイブするか保持するかを選択できます。これはクリーンなワーキングツリーが必要であり、SSH セッションでは利用できません。452* **Cloud**を選択すると、会話を要約として引き継いだうえで、セッションを[クラウドセッション](/docs/ja/claude-code-on-the-web)として続行します。確定する前に、ファイルも移動するかどうか、およびクラウドセッションの準備ができた時点でこのセッションがアーカイブされるかどうかがダイアログに表示されます。[SSH](#ssh-sessions) 経由または [WSL](/docs/ja/desktop-wsl) で実行されるセッションは、この方法で移動できません。

453* **Your IDE**：現在の作業ディレクトリでサポートされている IDE でプロジェクトを開きます。453* インストール済みのエディタまたはファイルマネージャーを選択すると、セッションのディスク上のフォルダをそこで開きます。

454 454

455<h3 id="sessions-from-dispatch">455<h3 id="sessions-from-dispatch">

456 Dispatch からのセッション456 Dispatch からのセッション

458 458

459[Dispatch](https://support.claude.com/en/articles/13947068)は、[Cowork](https://claude.com/product/cowork)タブに存在する Claude との永続的な会話です。Dispatch にタスクをメッセージで送信すると、それをどのように処理するかを決定します。459[Dispatch](https://support.claude.com/en/articles/13947068)は、[Cowork](https://claude.com/product/cowork)タブに存在する Claude との永続的な会話です。Dispatch にタスクをメッセージで送信すると、それをどのように処理するかを決定します。

460 460

461タスクは 2 つの方法で Code セッションになります：「Claude Code セッションを開いてログインバグを修正する」など直接要求するか、Dispatch がタスクが開発作業であると判断して自動的に生成するかです。通常 Code にルーティングされるタスクには、バグの修正、依存関係の更新、テストの実行、またはプルリクエストの開くが含まれます。研究、ドキュメント編集、スプレッドシート作業は Cowork に留まります。461タスクは 2 つの方法で Code セッションになります：「Claude Code セッションを開いてログインバグを修正する」など直接要求するか、Dispatch がタスクが開発作業であると判断して自動的に生成するかです。通常 Code にルーティングされるタスクには、バグの修正、依存関係の更新、テストの実行、またはプルリクエストの作成が含まれます。リサーチ、ドキュメント編集、スプレッドシート作業は Cowork に留まります。

462 462

463どちらの方法でも、Code セッションは Code タブのサイドバーに**Dispatch**バッジ付きで表示されます。完了したときまたは承認が必要なときに、電話でプッシュ通知を受け取ります。463どちらの方法でも、Code セッションは Code タブのサイドバーに**Dispatch**バッジ付きで表示されます。完了したときまたは承認が必要なときに、電話でプッシュ通知を受け取ります。

464 464

739 739

740[拡張思考](/docs/ja/model-config#extended-thinking)はデフォルトで有効になっており、複雑な推論タスクのパフォーマンスを向上させますが、追加のトークンを使用します。Anthropic API では、ローカル環境エディタで `MAX_THINKING_TOKENS` を `0` に設定して思考をオフにします。これは Opus 5.5、Sonnet 5.5、または Fable モデルには効果がなく、常に拡張思考を使用します。Anthropic API で思考をオフにした場合、Claude Code は、Opus 5 などの[その組み合わせを受け入れない](/docs/ja/errors#effort-isnt-available-with-thinking-turned-off)ことが分かっているモデルに、より高いレベルではなく effort `high` を送信します。740[拡張思考](/docs/ja/model-config#extended-thinking)はデフォルトで有効になっており、複雑な推論タスクのパフォーマンスを向上させますが、追加のトークンを使用します。Anthropic API では、ローカル環境エディタで `MAX_THINKING_TOKENS` を `0` に設定して思考をオフにします。これは Opus 5.5、Sonnet 5.5、または Fable モデルには効果がなく、常に拡張思考を使用します。Anthropic API で思考をオフにした場合、Claude Code は、Opus 5 などの[その組み合わせを受け入れない](/docs/ja/errors#effort-isnt-available-with-thinking-turned-off)ことが分かっているモデルに、より高いレベルではなく effort `high` を送信します。

741 741

742[適応的推論](/docs/ja/model-config#adjust-effort-level)を持つモデルでは、適応的推論が思考の深さを制御するため、`0` 以外の `MAX_THINKING_TOKENS` 値は無視されます。Opus 4.6 と Sonnet 4.6 では、固定思考予算を使用するために `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` を `1` に設定します。Fable モデル、Sonnet 5 以降、および Opus 4.7 以降は常に適応的推論を使用し、固定予算モードはありません。742[適応的推論](/docs/ja/model-config#adjust-effort-level)を持つモデルでは、適応的推論が代わりに思考の深さを制御するため、`MAX_THINKING_TOKENS` に正の値を設定しても、Claude Code はその数値自体を無視します。Opus 4.6 と Sonnet 4.6 では、固定思考予算を使用するために `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` を `1` に設定します。Fable モデル、Sonnet 5 以降、および Opus 4.7 以降は常に適応的推論を使用し、固定予算モードはありません。

743 743

744<h4 id="local-sessions-on-managed-devices">744<h4 id="local-sessions-on-managed-devices">

745 管理デバイス上のローカルセッション745 管理デバイス上のローカルセッション

1005| `--dangerously-skip-permissions` | 権限モードをバイパスします。Pro および Max プランでは、設定 → Claude Code → 「権限モードのバイパスを許可」で有効にします。Team および Enterprise プランでは、組織ポリシーで制御されます |1005| `--dangerously-skip-permissions` | 権限モードをバイパスします。Pro および Max プランでは、設定 → Claude Code → 「権限モードのバイパスを許可」で有効にします。Team および Enterprise プランでは、組織ポリシーで制御されます |

desktop-ios-simulator.md +1 −1

Details

92* **Cmd+S** でスクリーンショットを保存するか、**Cmd+R** でスクリーン録画を保存します。ペインのキャプチャボタンまたはショートカットを使用します。ファイルはデスクトップに保存されます92* **Cmd+S** でスクリーンショットを保存するか、**Cmd+R** でスクリーン録画を保存します。ペインのキャプチャボタンまたはショートカットを使用します。ファイルはデスクトップに保存されます

93* **Detach simulator** をクリックしてデバイスをシャットダウンせずにストリーミングを停止します。ペインは **Attach simulator** 状態に戻ります93* **Detach simulator** をクリックしてデバイスをシャットダウンせずにストリーミングを停止します。ペインは **Attach simulator** 状態に戻ります

94 94

95デバイス名の下の行は、シミュレータからのビデオストリームを調整します。Mac に負荷がかかっている場合は **Frame rate** または **Resolution** を下げるか、**Encoding** を H.264 と JPEG の間で切り替えるか、**FPS** をチェックしてペインが受け取っているフレームレートを表示します。これらの設定は、ペインがデバイスを表示する方法を変更し、アプリの実行方法は変更しません。95シミュレータからのビデオストリームを調整するには、ペインの **Display** メニューを開きます。Mac に負荷がかかっている場合は **Frame rate** または **Resolution** を下げます。どちらの設定も、ペインがデバイスを表示する方法を変更し、アプリの実行方法は変更しません。

96 96

97あなたと Claude は同じデバイスを操作するため、あなたのタップは Claude が見るアプリの状態を変更します。Claude に特定の画面をチェックさせるには、タップして移動してから依頼します。Claude がデバイスを操作している間、ペインは画面の上に **Claude is using this device** バッジを表示します。バッジが消えるまでタップを控えて、結果があなたの入力ではなくアプリを反映するようにします。97あなたと Claude は同じデバイスを操作するため、あなたのタップは Claude が見るアプリの状態を変更します。Claude に特定の画面をチェックさせるには、タップして移動してから依頼します。Claude がデバイスを操作している間、ペインは画面の上に **Claude is using this device** バッジを表示します。バッジが消えるまでタップを控えて、結果があなたの入力ではなくアプリを反映するようにします。

98 98

desktop-quickstart.md +1 −1

Details

135 135

136**Claude をスケジュールに設定する。** [スケジュール済みタスク](/docs/ja/desktop-scheduled-tasks)を設定して、Claude を定期的に自動実行します。毎朝のコードレビュー、週次の依存関係監査、または接続されたツールから情報を取得するブリーフィングです。136**Claude をスケジュールに設定する。** [スケジュール済みタスク](/docs/ja/desktop-scheduled-tasks)を設定して、Claude を定期的に自動実行します。毎朝のコードレビュー、週次の依存関係監査、または接続されたツールから情報を取得するブリーフィングです。

137 137

138**準備ができたらスケールアップする。** サイドバーから [並列セッション](/docs/ja/desktop#work-in-parallel-with-sessions)を開いて複数のタスクを同時に実行します。各セッションは必要に応じて独自の Git worktree で実行でき、[タスクペイン](/docs/ja/desktop#watch-background-tasks)を開いてセッションが実行しているサブエージェントとバックグラウンドコマンドを監視します。[サイドチャット](/docs/ja/desktop#ask-a-side-question-without-derailing-the-session)を開いてメインスレッドを脱線させずに質問を尋ねます。[長時間実行される作業をクラウドに送信](/docs/ja/desktop#run-long-running-tasks-in-the-cloud)して、アプリを閉じても続行するか、タスクが予想より長くかかる場合は [Web または IDE でセッションを続行](/docs/ja/desktop#continue-in-another-surface)します。[GitHub、Slack、Linear などの外部ツールを接続](/docs/ja/desktop#extend-claude-code)して、ワークフローをまとめます。138**準備ができたらスケールアップする。** サイドバーから [並列セッション](/docs/ja/desktop#work-in-parallel-with-sessions)を開いて複数のタスクを同時に実行します。各セッションは必要に応じて独自の Git worktree で実行でき、[タスクペイン](/docs/ja/desktop#watch-background-tasks)を開いてセッションが実行しているサブエージェントとバックグラウンドコマンドを監視します。[サイドチャット](/docs/ja/desktop#ask-a-side-question-without-derailing-the-session)を開いてメインスレッドを脱線させずに質問を尋ねます。[長時間実行される作業をクラウドに送信](/docs/ja/desktop#run-long-running-tasks-in-the-cloud)して、アプリを閉じても続行するか、タスクが予想より長くかかる場合は[すでに開始したセッションをクラウドに移動](/docs/ja/desktop#continue-in-another-surface)します。[GitHub、Slack、Linear などの外部ツールを接続](/docs/ja/desktop#extend-claude-code)して、ワークフローをまとめます。

139 139

140<h2 id="what’s-next">140<h2 id="what’s-next">

141 次のステップ141 次のステップ

env-vars.md +391 −352

Details

124 変数124 変数

125</h2>125</h2>

126 126

127タイムアウト、トークン予算、再試行回数などの数値変数は、通常の数字に加えて、指数表記や桁区切り文字を使った表記も受け付けます。ただし、変数の行に数字のみを受け付けると記載されている場合は除きます。たとえば、Claude Code は `2e3` を 2000、`64_000` を 64000 として読み取ります。v2.1.211 より前は、これらの表記によって、`1e6` がタイムアウトを 1 に設定するなど、はるかに小さい値が警告なしに設定されることがありました。127タイムアウト、トークン予算、再試行回数などの数値変数は、通常の数字に加えて、指数表記や桁区切り文字を使った表記も受け付けます。ただし、変数の行に通常の数字のみを受け付けると記載されている場合を除きます。たとえば、Claude Code は `2e3` を 2000、`64_000` を 64000 として読み取ります。v2.1.211 より前では、これらの表記によって、`1e6` でタイムアウトが 1 に設定されるなど、意図よりはるかに小さい値が警告なく設定される場合がありました。

128 128

129<Note>129<Note>

130 動作をオンまたはオフにする変数では、大文字・小文字を問わず、`1`、`true`、`yes`、`on` のいずれかを設定するとオンになり、`0`、`false`、`no`、`off` のいずれかを設定するとオフになります。130 動作をオンまたはオフにする変数では、`1`、`true`、`yes`、`on` を設定するとオンになり、`0`、`false`、`no`、`off` を設定するとオフになります。大文字と小文字は区別されません。

131 131

132 一部の変数は設定されているかどうかのみを読み取るため、`0` を含む空でない値はすべて動作をオンにします。動作をオフにするには、変数の設定を解除するか、空の値を設定します。次の変数がこのように動作します：132 一部の変数は、設定されているかどうかだけを読み取るため、`0` を含む空でない値であれば動作がオンになります。動作をオフにするには、変数の設定を解除するか、空の値を設定します。次の変数がこのように動作します。

133 133

134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

135 * `DISABLE_TELEMETRY`135 * `DISABLE_TELEMETRY`

138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`

139 * `IS_DEMO`139 * `IS_DEMO`

140 140

141 もう 1 つの変数には独自のルールがあります。`FORCE_HYPERLINK` は数値を読み取るため、`0` のみがオフにします。各変数の行にも、それぞれのルールが記載されています。141 もう 1 つの変数には独自のルールがあります。`FORCE_HYPERLINK` は数値を読み取るため、`0` のみがオフになります。各変数の行にも、それぞれのルールが記載されています。

142</Note>142</Note>

143 143

144| 変数 | 目的 |144| 変数 | 目的 |

145| :- | :- |145| :- | :- |

146| `ANTHROPIC_API_KEY` | `X-Api-Key` ヘッダーとして送信される API キー。設定すると、ログインしている場合でも、Claude Pro、Max、Team、Enterprise のサブスクリプションの代わりにこのキーが使用されます。非対話モード（`-p`）では、キーが存在する場合は常に使用されます。対話モードでは、キーがサブスクリプションを上書きする前に、キーを承認するよう一度求められます。代わりにサブスクリプションを使用するには、`unset ANTHROPIC_API_KEY` を実行します |146| `ANTHROPIC_API_KEY` | `X-Api-Key` ヘッダーとして送信される API キー。設定すると、ログインしている場合でも、Claude Pro、Max、Team、Enterprise のサブスクリプションの代わりにこのキーが使用されます。非対話モード（`-p`）では、キーが存在する場合は常に使用されます。対話モードでは、キーがサブスクリプションを上書きする前に、一度だけキーの承認を求められます。代わりにサブスクリプションを使用するには、`unset ANTHROPIC_API_KEY` を実行します |

148| `ANTHROPIC_AWS_API_KEY` | AWS Console で生成される [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) 用のワークスペース API キー。`x-api-key` として送信され、AWS SigV4 より優先されます |148| `ANTHROPIC_AWS_API_KEY` | AWS Console で生成された [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のワークスペース API キー。`x-api-key` として送信され、AWS SigV4 より優先されます |

149| `ANTHROPIC_AWS_BASE_URL` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のエンドポイント URL を上書きします。カスタムリージョンを使用する場合や [LLM ゲートウェイ](/docs/ja/llm-gateway) 経由でルーティングする場合に使用します。デフォルトは `https://aws-external-anthropic.{region}.api.aws` です。Claude Code は [Amazon Bedrock と同じ優先順位](/docs/ja/amazon-bedrock#3-configure-claude-code) でリージョンを解決します |149| `ANTHROPIC_AWS_BASE_URL` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のエンドポイント URL を上書きします。カスタムリージョンを使用する場合や、[LLM ゲートウェイ](/docs/ja/llm-gateway)経由でルーティングする場合に使用します。デフォルトは `https://aws-external-anthropic.{region}.api.aws` です。Claude Code は [Amazon Bedrock と同じ優先順位](/docs/ja/amazon-bedrock#3-configure-claude-code)でリージョンを解決します |

150| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) に必須です。すべてのリクエストで `anthropic-workspace-id` ヘッダーとして送信されます |150| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) で必須です。すべてのリクエストで `anthropic-workspace-id` ヘッダーとして送信されます |

151| `ANTHROPIC_BASE_URL` | API エンドポイントを上書きして、リクエストをプロキシまたはゲートウェイ経由でルーティングします。ファーストパーティ以外のホストに設定すると、[MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) はデフォルトで無効になります。プロキシが `tool_reference` ブロックを転送する場合は `ENABLE_TOOL_SEARCH=true` を設定してください。v2.1.196 以降、これが `api.anthropic.com` 以外のホストを指している場合、[Remote Control](/docs/ja/remote-control#requirements) は無効になり、Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry での動作と一致します |151| `ANTHROPIC_BASE_URL` | API エンドポイントを上書きして、プロキシまたはゲートウェイ経由でリクエストをルーティングします。ファーストパーティ以外のホストに設定すると、[MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search)はデフォルトで無効になります。プロキシが `tool_reference` ブロックを転送する場合は、`ENABLE_TOOL_SEARCH=true` を設定します。v2.1.196 以降、この変数が `api.anthropic.com` 以外のホストを指している場合、[Remote Control](/docs/ja/remote-control#requirements) は無効になります。これは Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry での動作と同じです |

152| `ANTHROPIC_BEDROCK_BASE_URL` | Amazon Bedrock のエンドポイント URL を上書きします。カスタムの Amazon Bedrock エンドポイントを使用する場合や [LLM ゲートウェイ](/docs/ja/llm-gateway) 経由でルーティングする場合に使用します。[Amazon Bedrock](/docs/ja/amazon-bedrock) を参照してください |152| `ANTHROPIC_BEDROCK_BASE_URL` | Amazon Bedrock のエンドポイント URL を上書きします。カスタムの Amazon Bedrock エンドポイントを使用する場合や、[LLM ゲートウェイ](/docs/ja/llm-gateway)経由でルーティングする場合に使用します。[Amazon Bedrock](/docs/ja/amazon-bedrock) を参照してください |

153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Amazon Bedrock Mantle のエンドポイント URL を上書きします。[Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint) を参照してください |153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Amazon Bedrock Mantle のエンドポイント URL を上書きします。[Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)を参照してください |

154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | AWS リージョンから導出されるプレフィックスの代わりに Claude Code が最初に試す、クロスリージョン推論プロファイルのプレフィックス（`us`、`eu`、`apac`、`jp`、`au`、`global` のいずれか）。AWS GovCloud リージョンでは無視されます。Claude Code v2.1.224 以降が必要です。[Amazon Bedrock](/docs/ja/amazon-bedrock#cross-region-inference-profile-prefixes) を参照してください |154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | AWS リージョンから導出されるプレフィックスの代わりに、Claude Code が最初に試行するクロスリージョン推論プロファイルのプレフィックス（`us`、`eu`、`apac`、`jp`、`au`、`global` のいずれか）。AWS GovCloud リージョンでは無視されます。Claude Code v2.1.224 以降が必要です。[Amazon Bedrock](/docs/ja/amazon-bedrock#cross-region-inference-profile-prefixes) を参照してください |

155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock の [サービスティア](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)（`default`、`flex`、`priority` のいずれか）。`X-Amzn-Bedrock-Service-Tier` ヘッダーとして送信されます。[Amazon Bedrock](/docs/ja/amazon-bedrock#service-tiers) を参照してください |155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock の[サービスティア](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)（`default`、`flex`、`priority` のいずれか）。`X-Amzn-Bedrock-Service-Tier` ヘッダーとして送信されます。[Amazon Bedrock](/docs/ja/amazon-bedrock#service-tiers) を参照してください |

156| `ANTHROPIC_BETAS` | API リクエストに含める追加の `anthropic-beta` ヘッダー値のカンマ区切りリスト。Claude Code は必要なベータヘッダーをすでに送信しています。Claude Code がネイティブサポートを追加する前に [Anthropic API ベータ](https://platform.claude.com/docs/en/api/beta-headers) にオプトインするために使用します。API キー認証が必要な [`--betas` フラグ](/docs/ja/cli-reference#cli-flags) とは異なり、この変数は Claude.ai サブスクリプションを含むすべての認証方法で機能します |156| `ANTHROPIC_BETAS` | API リクエストに含める追加の `anthropic-beta` ヘッダー値のカンマ区切りリスト。Claude Code は必要なベータヘッダーをすでに送信しています。この変数は、Claude Code がネイティブサポートを追加する前に [Anthropic API のベータ機能](https://platform.claude.com/docs/en/api/beta-headers)を利用するために使用します。API キー認証が必要な [`--betas` フラグ](/docs/ja/cli-reference#cli-flags)とは異なり、この変数は Claude.ai サブスクリプションを含むすべての認証方法で機能します |

157| `ANTHROPIC_CUSTOM_HEADERS` | リクエストに追加するカスタムヘッダー（`Name: Value` 形式、複数のヘッダーは改行区切り）。名前または値に、カーリークォートやゼロ幅スペースなど HTTP ヘッダーで扱えない文字が含まれている場合、リクエストは失敗し、そのペアを位置で特定するエラーが表示されます。Claude Code v2.1.227 以降が必要です。[Invalid request header value](/docs/ja/errors#invalid-request-header-value) に、正確な文字セットとチェックが実行される場所が記載されています。`Authorization` や `Host` など、認証情報、組織またはテナント、ルーティング、API の動作に関するヘッダーを設定する値は、サーバー管理設定によって配信された場合、[承認が必要な設定](/docs/ja/server-managed-settings#environment-variables-and-the-approval-dialog) として扱われます。プロジェクト設定またはローカル設定から渡された場合、そのような値は [`env` の値が適用される条件のルール](/docs/ja/settings-reference#when-claude-code-applies-env-values) に従います |157| `ANTHROPIC_CUSTOM_HEADERS` | リクエストに追加するカスタムヘッダー（`Name: Value` 形式で、複数のヘッダーは改行で区切ります）。名前または値に、カーリークォートやゼロ幅スペースなど HTTP ヘッダーで扱えない文字が含まれている場合、リクエストは失敗し、そのペアを位置で特定するエラーが表示されます。Claude Code v2.1.227 以降が必要です。正確な文字セットとチェックが実行される場所については、[Invalid request header value](/docs/ja/errors#invalid-request-header-value) を参照してください。`Authorization` や `Host` など、認証情報、組織またはテナント、ルーティング、API の動作に関するヘッダーを設定する値は、サーバー管理設定で配信される場合、[承認が必要な設定](/docs/ja/server-managed-settings#environment-variables-and-the-approval-dialog)として扱われます。プロジェクト設定またはローカル設定から配信される場合、そのような値は [`env` の値が適用されるタイミングのルール](/docs/ja/settings-reference#when-claude-code-applies-env-values)に従います |

158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | `/model` ピッカーにカスタムエントリとして追加するモデル ID。組み込みエイリアスを置き換えることなく、非標準またはゲートウェイ固有のモデルを選択可能にするために使用します。[モデル設定](/docs/ja/model-config#add-a-custom-model-option) を参照してください |158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | `/model` ピッカーにカスタムエントリとして追加するモデル ID。組み込みのエイリアスを置き換えずに、標準外のモデルやゲートウェイ固有のモデルを選択可能にするために使用します。[モデル設定](/docs/ja/model-config#add-a-custom-model-option)を参照してください |

159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` ピッカー内のカスタムモデルエントリの表示用説明。設定されていない場合のデフォルトは `Custom model (<model-id>)` です |159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` ピッカーのカスタムモデルエントリに表示する説明。設定されていない場合のデフォルトは `Custom model (<model-id>)` です |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` ピッカー内のカスタムモデルエントリの表示名。設定されていない場合、Claude Code が [ID を認識する](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) ときはモデル名が、それ以外の場合はモデル ID が表示されます |160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` ピッカーのカスタムモデルエントリに表示する名前。設定されていない場合、Claude Code が [ID を認識する](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)ときはモデル名が、それ以外のときはモデル ID がエントリに表示されます |

161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | カスタムモデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト（例: `effort,thinking`）。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | カスタムモデルがサポートする[機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)のカンマ区切りリスト（例: `effort,thinking`）。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` エイリアスが解決されるモデル ID。また、サードパーティプロバイダーでの [自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback) において、Claude Code が Fable モデルとして認識する ID でもあります。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` エイリアスが解決されるモデル ID。また、サードパーティプロバイダーでの[自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback)において Claude Code が Fable モデルとして認識する ID でもあります。[モデル設定](/docs/ja/model-config#environment-variables)を参照してください |

163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | `/model` ピッカー内の固定された Fable モデルの表示用説明。設定されていない場合、その行には `Custom Fable model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | `/model` ピッカーで固定された Fable モデルに表示する説明。設定されていない場合、行には `Custom Fable model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | `/model` ピッカー内の固定された Fable モデルの表示名。設定されていない場合、Claude Code が固定された ID を認識するときはモデル名が、それ以外の場合は固定された ID が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | `/model` ピッカーで固定された Fable モデルに表示する名前。設定されていない場合、Claude Code が固定された ID を認識するときはモデル名が、それ以外のときは固定された ID が行に表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | 固定された Fable モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト（例: `effort,thinking`）。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | 固定された Fable モデルがサポートする[機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)のカンマ区切りリスト（例: `effort,thinking`）。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` エイリアスが解決されるモデル ID。[バックグラウンド機能](/docs/ja/costs#background-token-usage) にも使用されます。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` エイリアスが解決されるモデル ID。[バックグラウンド機能](/docs/ja/costs#background-token-usage)にも使用されます。[モデル設定](/docs/ja/model-config#environment-variables)を参照してください |

167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | `/model` ピッカー内の固定された Haiku モデルの表示用説明。設定されていない場合、その行には `Custom Haiku model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | `/model` ピッカーで固定された Haiku モデルに表示する説明。設定されていない場合、行には `Custom Haiku model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | `/model` ピッカー内の固定された Haiku モデルの表示名。設定されていない場合、Claude Code が固定された ID を認識するときはモデル名が、それ以外の場合は固定された ID が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | `/model` ピッカーで固定された Haiku モデルに表示する名前。設定されていない場合、Claude Code が固定された ID を認識するときはモデル名が、それ以外のときは固定された ID が行に表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | 固定された Haiku モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト（例: `effort,thinking`）。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | 固定された Haiku モデルがサポートする[機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)のカンマ区切りリスト（例: `effort,thinking`）。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

170| `ANTHROPIC_DEFAULT_MODEL` | 新しいセッションがデフォルトで開始されるモデル。Claude Code v2.1.236 以降が必要です。[新しいセッションのデフォルトモデルを設定する](/docs/ja/model-config#set-a-default-model-for-new-sessions) を参照してください |170| `ANTHROPIC_DEFAULT_MODEL` | 新しいセッションがデフォルトで開始するモデル。Claude Code v2.1.236 以降が必要です。[新しいセッションのデフォルトモデルを設定する](/docs/ja/model-config#set-a-default-model-for-new-sessions)を参照してください |

171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` エイリアスが解決されるモデル ID。また、plan モードがアクティブな間に `opusplan` が使用するモデル ID でもあります。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` エイリアスが解決されるモデル ID。また、plan モードがアクティブな間に `opusplan` が使用するモデル ID でもあります。[モデル設定](/docs/ja/model-config#environment-variables)を参照してください |

172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` ピッカー内の固定された Opus モデルの表示用説明。設定されていない場合、その行には `Custom Opus model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` ピッカーで固定された Opus モデルに表示する説明。設定されていない場合、行には `Custom Opus model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | `/model` ピッカー内の固定された Opus モデルの表示名。設定されていない場合、Claude Code が固定された ID を認識するときはモデル名が、それ以外の場合は固定された ID が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | `/model` ピッカーで固定された Opus モデルに表示する名前。設定されていない場合、Claude Code が固定された ID を認識するときはモデル名が、それ以外のときは固定された ID が行に表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | 固定された Opus モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト（例: `effort,thinking`）。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | 固定された Opus モデルがサポートする[機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)のカンマ区切りリスト（例: `effort,thinking`）。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` エイリアスが解決されるモデル ID。また、plan モードがアクティブでないときに `opusplan` が使用するモデル ID でもあります。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` エイリアスが解決されるモデル ID。また、plan モードがアクティブでないときに `opusplan` が使用するモデル ID でもあります。[モデル設定](/docs/ja/model-config#environment-variables)を参照してください |

176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | `/model` ピッカー内の固定された Sonnet モデルの表示用説明。設定されていない場合、その行には `Custom Sonnet model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | `/model` ピッカーで固定された Sonnet モデルに表示する説明。設定されていない場合、行には `Custom Sonnet model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | `/model` ピッカー内の固定された Sonnet モデルの表示名。設定されていない場合、Claude Code が固定された ID を認識するときはモデル名が、それ以外の場合は固定された ID が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | `/model` ピッカーで固定された Sonnet モデルに表示する名前。設定されていない場合、Claude Code が固定された ID を認識するときはモデル名が、それ以外のときは固定された ID が行に表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | 固定された Sonnet モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト（例: `effort,thinking`）。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | 固定された Sonnet モデルがサポートする[機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)のカンマ区切りリスト（例: `effort,thinking`）。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

179| `ANTHROPIC_FEDERATION_RULE_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) のフェデレーションルール ID。`ANTHROPIC_ORGANIZATION_ID` と一緒に設定すると、Claude Code はフェデレーション認証情報を選択します。この認証情報は `/login` の認証情報より優先されます。[認証の優先順位](/docs/ja/authentication#authentication-precedence) を参照してください |179| `ANTHROPIC_FEDERATION_RULE_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) のフェデレーションルール ID。`ANTHROPIC_ORGANIZATION_ID` と一緒に設定すると、Claude Code はフェデレーション認証情報を選択します。これは `/login` の認証情報より優先されます。[認証の優先順位](/docs/ja/authentication#authentication-precedence)を参照してください |

181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Microsoft Entra アクセストークンなど、Microsoft Foundry 認証用のベアラートークン。Claude Code はこれを `Authorization: Bearer` ヘッダーとして送信します。`ANTHROPIC_FOUNDRY_API_KEY` および Azure のデフォルト認証情報チェーンより優先されます。[Microsoft Foundry](/docs/ja/microsoft-foundry) を参照してください。Claude Code v2.1.203 以降が必要です |181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Microsoft Entra アクセストークンなど、Microsoft Foundry 認証用のベアラートークン。Claude Code はこれを `Authorization: Bearer` ヘッダーとして送信します。`ANTHROPIC_FOUNDRY_API_KEY` および Azure のデフォルト認証情報チェーンより優先されます。[Microsoft Foundry](/docs/ja/microsoft-foundry) を参照してください。Claude Code v2.1.203 以降が必要です |

182| `ANTHROPIC_FOUNDRY_BASE_URL` | Microsoft Foundry リソースの完全なベース URL（例: `https://my-resource.services.ai.azure.com/anthropic`）。`ANTHROPIC_FOUNDRY_RESOURCE` の代替です（[Microsoft Foundry](/docs/ja/microsoft-foundry) を参照） |182| `ANTHROPIC_FOUNDRY_BASE_URL` | Microsoft Foundry リソースの完全なベース URL（例: `https://my-resource.services.ai.azure.com/anthropic`）。`ANTHROPIC_FOUNDRY_RESOURCE` の代替です（[Microsoft Foundry](/docs/ja/microsoft-foundry) を参照） |

183| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry のリソース名（例: `my-resource`）。Claude Code は [URL やホスト名を拒否します](/docs/ja/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name)。`ANTHROPIC_FOUNDRY_BASE_URL` が設定されていない場合は必須です（[Microsoft Foundry](/docs/ja/microsoft-foundry) を参照） |183| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry のリソース名（例: `my-resource`）。Claude Code は [URL やホスト名を受け付けません](/docs/ja/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name)。`ANTHROPIC_FOUNDRY_BASE_URL` が設定されていない場合は必須です（[Microsoft Foundry](/docs/ja/microsoft-foundry) を参照） |

185| `ANTHROPIC_ORGANIZATION_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) の組織 ID。`ANTHROPIC_FEDERATION_RULE_ID` と一緒に設定します。[認証の優先順位](/docs/ja/authentication#authentication-precedence) を参照してください |185| `ANTHROPIC_ORGANIZATION_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) の組織 ID。`ANTHROPIC_FEDERATION_RULE_ID` と一緒に設定します。[認証の優先順位](/docs/ja/authentication#authentication-precedence)を参照してください |

186| `ANTHROPIC_PROFILE` | 認証に使用する Anthropic プロファイルの名前。[`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) で作成されたものや、[API キーなしで Console アカウントにサインインする](/docs/ja/authentication#sign-in-without-an-api-key) ことで作成されたものなどです。[認証の優先順位](/docs/ja/authentication#authentication-precedence) を参照してください |186| `ANTHROPIC_PROFILE` | 認証に使用する Anthropic プロファイルの名前。[`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) で作成したプロファイルや、[API キーなしで Console アカウントにサインインする](/docs/ja/authentication#sign-in-without-an-api-key)ことで作成したプロファイルなどです。[認証の優先順位](/docs/ja/authentication#authentication-precedence)を参照してください |

188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Amazon Bedrock または Amazon Bedrock Mantle を使用する場合に、Haiku クラスのモデルの AWS リージョンを上書きします。Amazon Bedrock では、`ANTHROPIC_DEFAULT_HAIKU_MODEL` または非推奨の `ANTHROPIC_SMALL_FAST_MODEL` も設定されている場合にのみ有効になります。それ以外の場合、Amazon Bedrock はセッションのリージョンで [デフォルトの Sonnet モデルまたはプライマリモデル](/docs/ja/amazon-bedrock#4-pin-model-versions) を使ってバックグラウンドタスクを実行するためです |188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Amazon Bedrock または Amazon Bedrock Mantle を使用する場合に、Haiku クラスのモデルの AWS リージョンを上書きします。Amazon Bedrock では、`ANTHROPIC_DEFAULT_HAIKU_MODEL` または非推奨の `ANTHROPIC_SMALL_FAST_MODEL` も設定されている場合にのみ有効になります。それ以外の場合、Amazon Bedrock はセッションのリージョンで[デフォルトの Sonnet モデルまたはプライマリモデル](/docs/ja/amazon-bedrock#4-pin-model-versions)を使ってバックグラウンドタスクを実行するためです |

189| `ANTHROPIC_VERTEX_BASE_URL` | Google Cloud's Agent Platform のエンドポイント URL を上書きします。カスタムの Google Cloud's Agent Platform エンドポイントを使用する場合や [LLM ゲートウェイ](/docs/ja/llm-gateway) 経由でルーティングする場合に使用します。[Google Cloud's Agent Platform](/docs/ja/google-vertex-ai) を参照してください |189| `ANTHROPIC_VERTEX_BASE_URL` | Google Cloud's Agent Platform のエンドポイント URL を上書きします。カスタムの Google Cloud's Agent Platform エンドポイントを使用する場合や、[LLM ゲートウェイ](/docs/ja/llm-gateway)経由でルーティングする場合に使用します。[Google Cloud's Agent Platform](/docs/ja/google-vertex-ai) を参照してください |

190| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud's Agent Platform のリクエストの宛先となる GCP プロジェクト ID。[GCP 認証情報を設定する](/docs/ja/google-vertex-ai#3-configure-gcp-credentials) を参照してください |190| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud's Agent Platform のリクエストの宛先となる GCP プロジェクト ID。[GCP 認証情報を設定する](/docs/ja/google-vertex-ai#3-configure-gcp-credentials)を参照してください |

191| `ANTHROPIC_WORKSPACE_ID` | [ワークロード ID フェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) のワークスペース ID。フェデレーションルールのスコープが複数のワークスペースにわたる場合に設定すると、トークン交換でどのワークスペースを対象にするかが判別できます |191| `ANTHROPIC_WORKSPACE_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) のワークスペース ID。フェデレーションルールのスコープが複数のワークスペースにまたがる場合に設定し、トークン交換の対象となるワークスペースを指定します |

192| `API_FORCE_IDLE_TIMEOUT` | バイトが届かないときにストリーミング中のモデルのレスポンスを中止する、5 分間のボディアイドルタイムアウトを上書きします。`0` に設定するとタイムアウトがオフになります。これは、低速な [ゲートウェイ](/docs/ja/llm-gateway) やローカルモデルがチャンク間で 5 分より長く停止する場合などに使用します。`1` に設定すると、すべてのプロバイダーでオンのままになります。設定されていない場合、タイムアウトは直接の Anthropic API、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` が設定された Amazon Bedrock 以外のプロバイダーで有効です。[ストリームウォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs) はこれとは独立して実行され、ここで `0` を設定した場合でも、長時間の無通信状態を中止します |192| `API_FORCE_IDLE_TIMEOUT` | バイトが届かない場合にストリーミングのモデル応答を中止する、5 分間のボディアイドルタイムアウトを上書きします。`0` に設定するとタイムアウトがオフになります。たとえば、低速な[ゲートウェイ](/docs/ja/llm-gateway)やローカルモデルがチャンク間で 5 分以上停止する場合に使用します。`1` に設定すると、すべてのプロバイダーでタイムアウトがオンのままになります。設定されていない場合、タイムアウトは Anthropic API への直接接続、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` が設定された Amazon Bedrock 以外のプロバイダーで有効になります。[ストリームウォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)はこれとは独立して動作し、ここで `0` を設定した場合でも、長時間の無応答状態を中止します |

193| `API_TIMEOUT_MS` | API リクエストのタイムアウト（ミリ秒）（デフォルト: 600000、つまり 10 分、最大: 2147483647）。低速なネットワークでリクエストがタイムアウトする場合や、プロキシ経由でルーティングする場合に値を増やします。最大値を超える値は基盤となるタイマーをオーバーフローさせ、リクエストが即座に失敗する原因になります |193| `API_TIMEOUT_MS` | API リクエストのタイムアウト（ミリ秒）（デフォルト: 600000、つまり 10 分。最大: 2147483647）。低速なネットワークでリクエストがタイムアウトする場合や、プロキシ経由でルーティングする場合に値を増やします。最大値を超える値は内部のタイマーでオーバーフローし、リクエストが即座に失敗します |

194| `AWS_BEARER_TOKEN_BEDROCK` | 認証用の Amazon Bedrock API キー（[Amazon Bedrock API キー](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/) を参照） |194| `AWS_BEARER_TOKEN_BEDROCK` | 認証用の Amazon Bedrock API キー（[Amazon Bedrock API キー](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)を参照） |

195| `BASH_DEFAULT_TIMEOUT_MS` | フォアグラウンドの Bash または PowerShell ツールコマンドのデフォルトタイムアウト（ミリ秒）（デフォルト: 120000、つまり 2 分）。30 分より長いデフォルトは、無人セッションでの [バックグラウンドコマンドの時間制限](/docs/ja/tools-reference#time-limit-for-background-commands) のデフォルトにもなります。バックグラウンドの時間制限には Claude Code v2.1.285 以降が必要です |195| `BASH_DEFAULT_TIMEOUT_MS` | フォアグラウンドの Bash または PowerShell ツールコマンドのデフォルトタイムアウト（ミリ秒）（デフォルト: 120000、つまり 2 分）。30 分を超えるデフォルト値は、無人セッションにおける[バックグラウンドコマンドの制限時間](/docs/ja/tools-reference#time-limit-for-background-commands)のデフォルトにもなります。バックグラウンドの制限時間には Claude Code v2.1.285 以降が必要です |

196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果に読み込む bash 出力の最大文字数（デフォルト: 30000、最大: 150000）。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 設定を設定している場合、Claude Code はこの変数を無視します。[出力の制限](/docs/ja/tools-reference#output-limits) を参照してください |196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果として読み込む bash 出力の最大文字数（デフォルト: 30000。最大: 150000）。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 設定を指定した場合、Claude Code はこの変数を無視します。[出力の制限](/docs/ja/tools-reference#output-limits)を参照してください |

197| `BASH_MAX_TIMEOUT_MS` | モデルがフォアグラウンドの Bash または PowerShell ツールコマンドに設定できる最大タイムアウト（ミリ秒）（デフォルト: 600000、つまり 10 分）。実効上限は、この値と `BASH_DEFAULT_TIMEOUT_MS` の大きい方です。2 時間より長い実効上限は、無人セッションでの [バックグラウンドコマンドの時間制限](/docs/ja/tools-reference#time-limit-for-background-commands) の最大値にもなります。バックグラウンドの時間制限には Claude Code v2.1.285 以降が必要です |197| `BASH_MAX_TIMEOUT_MS` | フォアグラウンドの Bash または PowerShell ツールコマンドに対してモデルが設定できる最大タイムアウト（ミリ秒）（デフォルト: 600000、つまり 10 分）。実際の上限は、この値と `BASH_DEFAULT_TIMEOUT_MS` のうち大きいほうです。実際の上限が 2 時間を超える場合、無人セッションにおける[バックグラウンドコマンドの制限時間](/docs/ja/tools-reference#time-limit-for-background-commands)の最大値にもなります。バックグラウンドの制限時間には Claude Code v2.1.285 以降が必要です |

198| `BETA_TRACING_ENDPOINT` | [詳細なベータトレーシング](/docs/ja/monitoring-usage#traces-beta) 用の OTLP エンドポイント。`ENABLE_BETA_TRACING_DETAILED=1` を設定すると、ログとトレースは設定済みのエクスポーターではなくここに送信されます。シェル、ユーザー設定、または管理設定で設定してください。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |198| `BETA_TRACING_ENDPOINT` | [詳細なベータトレース](/docs/ja/monitoring-usage#traces-beta)用の OTLP エンドポイント。`ENABLE_BETA_TRACING_DETAILED=1` と組み合わせると、ログとトレースは設定済みのエクスポーターではなくこのエンドポイントに送信されます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクト設定およびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |

199| `CCR_FORCE_BUNDLE` | `1` に設定すると、[`claude --cloud`](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github) がリモートからクローンする代わりに、ローカルリポジトリを強制的にバンドルしてアップロードします |199| `CCR_FORCE_BUNDLE` | `1` に設定すると、[`claude --cloud`](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github) がリモートからクローンする代わりに、ローカルリポジトリをバンドルしてアップロードするよう強制します |

200| `CLAUDECODE` | Claude Code が起動するサブプロセス（Bash ツールと PowerShell ツール、tmux セッション、[フック](/docs/ja/hooks) コマンド、[ステータスライン](/docs/ja/statusline) コマンド、stdio [MCP サーバー](/docs/ja/mcp) サブプロセス）で `1` に設定されます。IDE 拡張機能も統合ターミナルでこれを設定します。スクリプトが Claude Code によって起動されたサブプロセス内で実行されているかどうかを検出するために使用します。現在のプロセスが、Claude Code が起動した stdio MCP サーバー内ではなく、ツール呼び出しやフックによって直接起動されたかどうかを確認するには、代わりに `CLAUDE_CODE_CHILD_SESSION` を使用してください |200| `CLAUDECODE` | Claude Code が起動するサブプロセス（Bash および PowerShell ツール、tmux セッション、[フック](/docs/ja/hooks)コマンド、[ステータスライン](/docs/ja/statusline)コマンド、stdio の [MCP サーバー](/docs/ja/mcp)サブプロセス）で `1` に設定されます。IDE 拡張機能も、統合ターミナルでこの変数を設定します。スクリプトが Claude Code によって起動されたサブプロセス内で実行されているかどうかを検出するために使用します。Claude Code が起動した stdio MCP サーバー内ではなく、ツール呼び出しやフックによって現在のプロセスが直接起動されたかどうかを確認するには、代わりに `CLAUDE_CODE_CHILD_SESSION` を使用します |

201| `CLAUDE_AFK_COUNTDOWN_MS` | 未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログで、自動続行の何ミリ秒前に画面上のカウントダウンを表示するか。デフォルトは `20000`（20 秒）で、自動続行のタイムアウトが上限です。自動続行がオンでない限り効果はありません。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定と `CLAUDE_AFK_TIMEOUT_MS` を参照してください。Claude Code v2.1.198 以降が必要です |201| `CLAUDE_AFK_COUNTDOWN_MS` | 未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログで、自動続行の何ミリ秒前に画面上のカウントダウンを表示するか。デフォルトは `20000`（20 秒）で、自動続行のタイムアウトが上限です。自動続行がオンでない限り効果はありません。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定と `CLAUDE_AFK_TIMEOUT_MS` を参照してください。Claude Code v2.1.198 以降が必要です |

202| `CLAUDE_AFK_TIMEOUT_MS` | 未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログが、ユーザーの回答を待たずに自動続行するまでのアイドル時間（ミリ秒）。自動続行はデフォルトでオフです。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定でオプトインしてください。この変数はデモや自動テスト用の上書きです。設定すると、その設定より優先され、設定が未設定または `never` の場合でも自動続行をオンにします。`0` を設定してもタイムアウトはオフにならず、ダイアログが即座に閉じます。v2.1.198 と v2.1.199 では、自動続行はデフォルトでオンで、タイムアウトは `60000`（60 秒）でした。Claude Code v2.1.198 以降が必要です |202| `CLAUDE_AFK_TIMEOUT_MS` | 未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログが、ユーザーの応答なしに自動続行されるまでのアイドル時間（ミリ秒）。自動続行はデフォルトでオフです。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定でオプトインします。この変数はデモや自動テスト用の上書きです。設定すると、その設定より優先され、設定が未指定または `never` の場合でも自動続行がオンになります。`0` を設定してもタイムアウトはオフにならず、ダイアログが即座に閉じます。v2.1.198 および v2.1.199 では、自動続行はデフォルトでオンで、タイムアウトは `60000`（60 秒）でした。Claude Code v2.1.198 以降が必要です |

203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | `1` に設定すると、Explore や Plan などの組み込み [サブエージェント](/docs/ja/sub-agents) タイプをすべて無効にします。非対話モード（`-p` フラグ）でのみ適用されます。まっさらな状態から始めたい SDK ユーザーに便利です。これにより、Agent ツール呼び出しで `subagent_type` が省略された場合に Claude Code が実行するサブエージェントである `general-purpose` も削除されます。その場合、そのような呼び出しは [`subagent_type is required`](/docs/ja/errors#subagent-type-is-required) で失敗します |203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | `1` に設定すると、Explore や Plan などの組み込み[サブエージェント](/docs/ja/sub-agents)タイプをすべて無効にします。非対話モード（`-p` フラグ）でのみ適用されます。白紙の状態から始めたい SDK ユーザーに便利です。これにより、Agent ツール呼び出しで `subagent_type` が省略された場合に Claude Code が実行するサブエージェントである `general-purpose` も削除されます。そのような呼び出しは [`subagent_type is required`](/docs/ja/errors#subagent-type-is-required) で失敗するようになります |

204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | `1` に設定すると、SDK で作成された MCP サーバーのツール名で `mcp__<server>__` プレフィックスを省略します。ツールは元の名前を使用します。SDK での使用のみ |204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | `1` に設定すると、SDK で作成された MCP サーバーのツール名に `mcp__<server>__` プレフィックスを付けません。ツールは元の名前を使用します。SDK での使用のみ |

205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | サブエージェントのストールタイムアウト（ミリ秒）。デフォルトは `600000`（10 分）です。ストリームウォッチドッグがオンの状態で `CLAUDE_STREAM_IDLE_TIMEOUT_MS` を引き上げると、[低速または停止した API レスポンスを処理する](/docs/ja/agent-sdk/typescript#handle-slow-or-stalled-api-responses) で説明されているように、デフォルトもそれに合わせて上がります。タイマーはストリーミングの進行イベントごとにリセットされます。期間内に進行がない場合、Claude Code はサブエージェントを中止し、ストールを親に報告します |205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | サブエージェントの停止タイムアウト（ミリ秒）。デフォルトは `600000`（10 分）です。ストリームウォッチドッグがオンの状態で `CLAUDE_STREAM_IDLE_TIMEOUT_MS` を引き上げると、[低速または停止した API レスポンスを処理する](/docs/ja/agent-sdk/typescript#handle-slow-or-stalled-api-responses)で説明しているとおり、デフォルトもそれに合わせて引き上げられます。タイマーはストリーミングの進行イベントごとにリセットされます。期間内に進行がない場合、Claude Code はサブエージェントを中止し、停止を親に報告します |

206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 自動圧縮がトリガーされる、自動圧縮ウィンドウに対するパーセンテージ（1-100）を設定します。早めに圧縮するには `50` などの低い値を使用します。この変数でしきい値を引き上げることはできないため、デフォルトのパーセンテージを超える値は無視されます。[モデルのコンテキスト上限より前に圧縮する](/docs/ja/model-config#context-window-and-auto-compaction) セッションでのみ適用されます。メインの会話とサブエージェントの両方に適用されます |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 自動圧縮がトリガーされる、自動圧縮ウィンドウの割合（1〜100）を設定します。早めに圧縮するには `50` などの低い値を使用します。この変数でしきい値を引き上げることはできないため、デフォルトの割合を超える値は無視されます。[モデルのコンテキスト上限より前に圧縮する](/docs/ja/model-config#context-window-and-auto-compaction)セッションでのみ適用されます。メインの会話とサブエージェントの両方に適用されます |

207| `CLAUDE_AUTO_BACKGROUND_TASKS` | `1` に設定すると、長時間実行されるエージェントタスクの自動バックグラウンド化を強制的に有効にします。有効にすると、サブエージェントは約 2 分間実行された後にバックグラウンドに移動されます。Claude Code v2.1.212 以降では、非対話モードでの [長時間の MCP ツール呼び出しの自動バックグラウンド化](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) も有効にします |207| `CLAUDE_AUTO_BACKGROUND_TASKS` | `1` に設定すると、長時間実行されるエージェントタスクの自動バックグラウンド化を強制的に有効にします。有効にすると、サブエージェントは約 2 分間実行された後にバックグラウンドに移動されます。Claude Code v2.1.212 以降では、非対話モードで[長時間の MCP ツール呼び出しの自動バックグラウンド化](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls)も有効になります |

208| `CLAUDE_AX_PREPARK_MS` | [スクリーンリーダーモード](/docs/ja/accessibility) で、Claude Code が新しい行または変更された行を書き込む前に待機するミリ秒数。デフォルトは `0` で、Claude Code は待機しません。v2.1.287 より前のデフォルトは `50` でした。Claude Code は待機時間の上限を `5000` にします。Claude Code v2.1.233 以降が必要です |208| `CLAUDE_AX_PREPARK_MS` | [スクリーンリーダーモード](/docs/ja/accessibility)で、Claude Code が新しい行または変更された行を書き込む前に待機する時間（ミリ秒）。デフォルトは `0` で、Claude Code は待機しません。v2.1.287 より前のデフォルトは `50` でした。Claude Code は待機時間の上限を `5000` とします。Claude Code v2.1.233 以降が必要です |

209| `CLAUDE_AX_SCREEN_READER` | `1` に設定すると、スクリーンリーダーに適した出力、つまり装飾的な枠線やアニメーションのないフラットなテキストをレンダリングします。`0` に設定すると、[`axScreenReader`](/docs/ja/settings-reference#axscreenreader) が `true` の場合でもスクリーンリーダーモードを強制的にオフにします。[`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) フラグが優先されます。Claude Code v2.1.181 以降が必要です |209| `CLAUDE_AX_SCREEN_READER` | `1` に設定すると、スクリーンリーダーに適した出力（装飾的な枠線やアニメーションのないフラットなテキスト）をレンダリングします。`0` に設定すると、[`axScreenReader`](/docs/ja/settings-reference#axscreenreader) が `true` の場合でもスクリーンリーダーモードを強制的にオフにします。[`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) フラグが優先されます。Claude Code v2.1.181 以降が必要です |

210| `CLAUDE_AX_STARTUP_QUIET_MS` | [スクリーンリーダーモード](/docs/ja/accessibility) で、起動確認行の後に Claude Code が最初のインターフェースのレンダリングを保留するミリ秒数。これにより、新しい出力に中断される前に、スクリーンリーダーがその行を最後まで読み上げられます。デフォルトは `3000` です。`0` を設定すると即座にレンダリングします。Claude Code は保留時間の上限を `600000`（10 分）にします。最初のキー入力で保留は早めに終了します。Claude Code v2.1.217 以降が必要です |210| `CLAUDE_AX_STARTUP_QUIET_MS` | [スクリーンリーダーモード](/docs/ja/accessibility)で、起動確認の行の後に Claude Code が最初のインターフェースのレンダリングを保留する時間（ミリ秒）。これにより、新しい出力に中断される前に、スクリーンリーダーがその行を最後まで読み上げられます。デフォルトは `3000` です。`0` に設定すると即座にレンダリングします。Claude Code は保留時間の上限を `600000`（10 分）とします。最初のキー入力で保留は早期に終了します。Claude Code v2.1.217 以降が必要です |

212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | バイトレベルのストリーミングアイドルウォッチドッグのタイムアウト（ミリ秒）。設定すると、そのウォッチドッグについては `CLAUDE_STREAM_IDLE_TIMEOUT_MS` より優先され、イベントレベルのウォッチドッグは変更されません。Claude Code はこの変数を 10 秒から 30 分の範囲に制限します。Claude Code v2.1.210 以降が必要です |212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | バイトレベルのストリーミングアイドルウォッチドッグのタイムアウト（ミリ秒）。設定すると、そのウォッチドッグについては `CLAUDE_STREAM_IDLE_TIMEOUT_MS` より優先され、イベントレベルのウォッチドッグは変更されません。Claude Code はこの変数の値を 10 秒から 30 分の範囲に制限します。Claude Code v2.1.210 以降が必要です |

213| `CLAUDE_CLIENT_PRESENCE_FILE` | 画面ロックリスナーなどの外部ツールが、画面のロック解除時に作成し、ロック時に削除するファイルへのパス。ファイルが存在する間、Claude Code は [Remote Control のモバイルプッシュ通知](/docs/ja/remote-control#mobile-push-notifications) をスキップするため、コンピューターを実際に使用している間はプッシュが届かなくなります。ファイルが存在しないか読み取れない場合、通知は通常どおり送信されます。Claude Code はファイルをポーリングするのではなく、プッシュをトリガーするイベントごとに 1 回確認します。Claude Code v2.1.181 以降が必要です |213| `CLAUDE_CLIENT_PRESENCE_FILE` | 画面ロックのリスナーなどの外部ツールが、画面のロック解除時に作成し、ロック時に削除するファイルへのパス。このファイルが存在する間、Claude Code は [Remote Control のモバイルプッシュ通知](/docs/ja/remote-control#mobile-push-notifications)をスキップするため、コンピューターを使用している間はプッシュ通知が届かなくなります。ファイルが存在しないか読み取れない場合、通知は通常どおり送信されます。Claude Code はファイルをポーリングするのではなく、プッシュをトリガーするイベントごとに一度確認します。Claude Code v2.1.181 以降が必要です |

214| `CLAUDE_CODE_ACCESSIBILITY` | `1` に設定すると、ネイティブのターミナルカーソルを表示したままにし、反転テキストのカーソルインジケーターを無効にします。macOS ズームなどの画面拡大ツールがカーソル位置を追跡できるようになります |214| `CLAUDE_CODE_ACCESSIBILITY` | `1` に設定すると、ネイティブのターミナルカーソルを表示したままにし、反転テキストのカーソルインジケーターを無効にします。macOS のズーム機能などの画面拡大ツールがカーソル位置を追跡できるようになります |

215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | `1` に設定すると、`--add-dir` で指定されたディレクトリからメモリファイルを読み込みます。`CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、`CLAUDE.local.md` を読み込みます。デフォルトでは、追加ディレクトリからメモリファイルは読み込まれません |215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | `1` に設定すると、`--add-dir` で指定したディレクトリからメモリファイルを読み込みます。`CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、`CLAUDE.local.md` を読み込みます。デフォルトでは、追加ディレクトリからメモリファイルは読み込まれません |

216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen) で増分更新を送信する代わりに、フレームごとに画面全体を再描画します。フルスクリーンモードで古いテキストの断片や位置のずれたテキストの断片が表示される場合に使用します。Claude Code は、Windows のバックグラウンドセッションと [エージェントビュー](/docs/ja/agent-view) でこれを自動的に有効にします |216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen)で差分更新を送信する代わりに、フレームごとに画面全体を再描画します。フルスクリーンモードで古いテキストの断片や位置のずれたテキストの断片が表示される場合に使用します。Windows のバックグラウンドセッションと[エージェントビュー](/docs/ja/agent-view)では、Claude Code がこれを自動的に有効にします |

217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | `1` に設定すると、Claude Code がモデル ID を effort 対応として認識しない場合でも、すべてのリクエストで [effort](/docs/ja/model-config#adjust-effort-level) パラメーターを送信します。カスタム識別子でモデルを提供する [LLM ゲートウェイ](/docs/ja/llm-gateway) やサードパーティプロバイダー経由でルーティングする場合に使用します。Claude 3 モデル、Sonnet 4.0 と 4.5、Opus 4.0 と 4.1、Haiku 4.5 など、API で effort パラメーターを拒否するモデルは、リクエストが失敗しないように引き続き除外されます |217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | `1` に設定すると、Claude Code がモデル ID を effort 対応として認識しない場合でも、すべてのリクエストで [effort](/docs/ja/model-config#adjust-effort-level) パラメーターを送信します。カスタム識別子でモデルを提供する [LLM ゲートウェイ](/docs/ja/llm-gateway)やサードパーティプロバイダー経由でルーティングする場合に使用します。Claude 3 モデル、Sonnet 4.0 および 4.5、Opus 4.0 および 4.1、Haiku 4.5 など、API で effort パラメーターを拒否するモデルは、リクエストが失敗しないよう引き続き除外されます |

218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 認証情報を更新する間隔（ミリ秒）（[`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper) を使用する場合） |218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 認証情報を更新する間隔（ミリ秒）（[`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper) を使用する場合） |

219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | `0` に設定すると、新しい [アーティファクト](/docs/ja/artifacts#create-an-artifact) が公開されたときに、Claude Code がブラウザを自動的に開かないようにします |219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | `0` に設定すると、新しい[アーティファクト](/docs/ja/artifacts#create-an-artifact)が公開されたときに Claude Code がブラウザーを自動的に開かないようにします |

220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | `0` に設定すると、Claude が [アーティファクトへのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact) を読んで返信しないようにします。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` によって [アーティファクトがオフになっている](/docs/ja/artifacts#availability) 場合は効果がありません。Claude Code v2.1.221 以降が必要です |220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | `0` に設定すると、Claude が[アーティファクトへのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact)を読んで返信しないようにします。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` によって[アーティファクトがオフになっている](/docs/ja/artifacts#availability)場合は効果がありません。Claude Code v2.1.221 以降が必要です |

221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | `0` に設定すると、Claude が [自身に送られたコメントに自ら返信する](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own) のを停止します。Claude Code v2.1.228 以降が必要です |221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | `0` に設定すると、Claude が[自身に送信されたコメントに自ら返信する](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own)ことを停止します。Claude Code v2.1.228 以降が必要です |

222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | `0` に設定すると、クライアントのバージョンとプロンプトのフィンガープリントを含む [アトリビューションブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block) を、システムプロンプトの先頭から省略します。いずれの場合も、Anthropic API への直接接続でのキャッシュには影響しません。一部の直接接続の構成では、`0` を設定しても、Claude Code は [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) の分類器リクエストでこのブロックを保持します。これが対象とする接続と認証情報については、[システムプロンプトのアトリビューションブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block) で確認してください。v2.1.181 より前は、カスタムベース URL と Microsoft Foundry の接続でブロックにリクエストごとのトークンが含まれていたため、これらのバージョンでは、LLM ゲートウェイがリクエストボディに基づいてキャッシュする場合やリクエストをサードパーティプロバイダーに転送する場合、または Microsoft Foundry に直接接続する場合に `0` に設定してください |222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | `0` に設定すると、クライアントのバージョンとプロンプトのフィンガープリントを含む[帰属ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block)をシステムプロンプトの先頭から省略します。いずれの場合も、Anthropic API への直接接続でのキャッシュには影響しません。一部の直接接続の構成では、`0` を設定した場合でも、Claude Code は [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)の分類器リクエストにこのブロックを残します。これが対象とする接続と認証情報については、[システムプロンプトの帰属ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block)を確認してください。v2.1.181 より前では、カスタムベース URL および Microsoft Foundry 接続において、このブロックにリクエストごとのトークンが含まれていました。そのため、それらのバージョンでは、LLM ゲートウェイがリクエストボディに基づいてキャッシュする場合、サードパーティプロバイダーにリクエストを転送する場合、または Microsoft Foundry に直接接続する場合は、`0` に設定してください |

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | `CLAUDE_AUTO_BACKGROUND_TASKS` が有効な場合に、まだ実行中の [バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) を確認するよう Claude にリマインドする間隔（秒）。`1` から `86400` までのプレーンな整数のみを受け付け、それ以外の値や表記は未設定として扱われます。未設定の場合、確認のリマインダーは送られません。Claude Code v2.1.248 以降が必要です |223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | v2.1.283 で削除されました。代わりに `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` を使用します |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | [自動圧縮ウィンドウ](/docs/ja/model-config#set-the-auto-compact-window) をトークン数で `100000` から `1000000` の範囲で設定します。`500000` のようなプレーンな整数のみを受け付けます。`500k` のような値は `500` として読み取られ、最小値の 100K に切り上げられます。実効ウィンドウは、モデルのコンテキストウィンドウでも上限が設定されます。`/autocompact` コマンド、`--autocompact` フラグ、`autoCompactWindow` 設定より優先されます。ステータスラインの `used_percentage` は常にモデルのコンテキストウィンドウ全体に対して測定されるため、この変数を設定すると、そのパーセンテージはコンテキスト圧縮がいつ実行されるかを示さなくなります |224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | [自動圧縮ウィンドウ](/docs/ja/model-config#set-the-auto-compact-window)をトークン数で設定します（`100000` から `1000000`）。`500000` のような通常の整数のみを受け付けます。`500k` のような値は `500` として読み取られ、最小値の 100K に制限されます。実際のウィンドウは、モデルのコンテキストウィンドウが上限にもなります。`/autocompact` コマンド、`--autocompact` フラグ、`autoCompactWindow` 設定より優先されます。ステータスラインの `used_percentage` は常にモデルの完全なコンテキストウィンドウを基準に測定されるため、この変数を設定すると、その割合は圧縮が実行されるタイミングを示さなくなります |

225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 自動 [IDE 接続](/docs/ja/vs-code) を上書きします。デフォルトでは、サポートされている IDE の統合ターミナル内で起動すると、Claude Code は自動的に接続します。これを防ぐには `false` に設定します。tmux が親ターミナルを隠す場合など、自動検出が失敗したときに接続を強制的に試みるには `true` に設定します。[`autoConnectIde`](/docs/ja/settings-reference#autoconnectide) グローバル設定より優先されます |225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 自動の [IDE 接続](/docs/ja/vs-code)を上書きします。デフォルトでは、サポートされている IDE の統合ターミナル内で起動すると、Claude Code は自動的に接続します。これを防ぐには `false` に設定します。tmux によって親ターミナルが隠される場合など、自動検出が失敗したときに接続を強制的に試行するには `true` に設定します。[`autoConnectIde`](/docs/ja/settings-reference#autoconnectide) グローバル設定より優先されます |

226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Claude Code がサーバーに [auto モードのアクションのレビュー](/docs/ja/permission-modes#server-side-classifier-review) を依頼するかどうかを制御します。`0` に設定すると、代わりに Claude Code 自身の分類器リクエストを使用します。Anthropic API への直接接続では v2.1.281 以降が必要です。変数が未設定の場合にどのセッションがサーバーに依頼するか、またどのバージョンからかについては、リンク先のセクションに記載されています。Claude Code v2.1.271 以降が必要です |226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Claude Code がサーバーに [auto モードのアクションのレビュー](/docs/ja/permission-modes#server-side-classifier-review)を要求するかどうかを制御します。`0` に設定すると、代わりに Claude Code 自身の分類器リクエストを使用します。Anthropic API への直接接続では v2.1.281 以降が必要です。変数が設定されていない場合にどのセッションがサーバーに要求するか、およびどのバージョンからかについては、リンク先のセクションに記載されています。Claude Code v2.1.271 以降が必要です |

227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | AWS のデフォルト認証情報プロバイダーチェーンが認証情報を生成するのを Claude Code が待機する時間（ミリ秒）。この時間を過ぎると、リクエストは [`AWS default-chain credential resolve timed out`](/docs/ja/errors#aws-default-chain-credential-resolve-timed-out) で失敗します（デフォルト: `60000`）。`aws-vault` のようなラッパーを介した MFA 付きのブラウザベースの SSO サインインなど、チェーン内のステップに正当な理由でより長い時間が必要な場合に値を引き上げます。Claude Code がデフォルトチェーンで署名するすべての場所に適用されます：[Amazon Bedrock](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、[Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)。Claude Code v2.1.207 以降が必要です |227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | AWS のデフォルト認証情報プロバイダーチェーンが認証情報を生成するまで Claude Code が待機する時間（ミリ秒）。この時間を過ぎるとリクエストは [`AWS default-chain credential resolve timed out`](/docs/ja/errors#aws-default-chain-credential-resolve-timed-out) で失敗します（デフォルト: `60000`）。`aws-vault` などのラッパーを介した MFA 付きのブラウザーベースの SSO サインインなど、チェーン内のステップが正当に長い時間を必要とする場合に引き上げます。Claude Code がデフォルトチェーンで署名するすべての場所に適用されます: [Amazon Bedrock](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、[Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)。Claude Code v2.1.207 以降が必要です |

228| `CLAUDE_CODE_BASH_EDIT_DIFF` | `0` に設定すると [Bash コマンドの実行中に変更されたファイルの差分](/docs/ja/hooks#bash) をオフにし、`1` に設定するとすべての権限モードで差分を記録します。[`bashEditDiffEnabled`](/docs/ja/settings-reference#basheditdiffenabled) 設定より優先されます。Claude Code v2.1.269 以降が必要です |228| `CLAUDE_CODE_BASH_EDIT_DIFF` | `0` に設定すると [Bash コマンドの実行中に変更されたファイルの差分](/docs/ja/hooks#bash)をオフにし、`1` に設定するとすべての権限モードで記録します。[`bashEditDiffEnabled`](/docs/ja/settings-reference#basheditdiffenabled) 設定より優先されます。Claude Code v2.1.269 以降が必要です |

229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | `0` に設定すると、バックグラウンド作業がまだ実行中であっても、非対話セッションがターン終了ごとにホストにアイドル状態を報告するようになります。デフォルトでは、バックグラウンドエージェントや [ワークフロー](/docs/ja/workflows) の実行などのバックグラウンド作業がまだ動作している間、セッションはターン終了後も実行中の状態を報告し続けます。これにより、リモートセッションリストなど状態を監視するホストが、作業の途中で Claude がユーザーの入力を待っていると通知することを防ぎます。開発サーバーなどのバックグラウンドシェルコマンドは、実行中の状態を保持しません。実行中の状態のデフォルトと `0` によるオプトアウトには Claude Code v2.1.269 以降が必要です。それより前のバージョンでは、`1` を設定すると実行中の状態を保持します |229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | `0` に設定すると、バックグラウンドの作業がまだ実行中であっても、非対話セッションがターン終了ごとにホストへアイドル状態を報告するようにします。デフォルトでは、バックグラウンドエージェントや[ワークフロー](/docs/ja/workflows)の実行などのバックグラウンド作業がまだ実行中の間、セッションはターン終了後も実行中の状態を報告し続けます。これにより、リモートセッションリストなど状態を監視するホストが、作業の途中で Claude がユーザーの入力を待っていると通知することを防ぎます。開発サーバーなどのバックグラウンドシェルコマンドは、実行中の状態を保持しません。実行中状態のデフォルトと `0` によるオプトアウトには Claude Code v2.1.269 以降が必要です。それより前のバージョンでは、実行中の状態を保持するには `1` を設定します |

230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | セッションにアクティブな [Remote Control](/docs/ja/remote-control) 接続がある間、Bash ツールと [フックコマンド](/docs/ja/hooks) のサブプロセスで自動的に設定され、接続が終了すると削除されます。値は `session_` 形式のセッション ID で、セッションの `claude.ai/code` URL に表示されるのと同じ識別子であるため、スクリプトは自身を実行したセッションへのリンクを作成できます。Claude Code v2.1.199 以降が必要です。[クラウドセッション](/docs/ja/claude-code-on-the-web) では、代わりに `CLAUDE_CODE_REMOTE_SESSION_ID` を読み取ってください |230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | セッションにアクティブな [Remote Control](/docs/ja/remote-control) 接続がある間、Bash ツールおよび[フックコマンド](/docs/ja/hooks)のサブプロセスで自動的に設定され、接続が終了すると削除されます。値は `session_` 形式のセッション ID で、セッションの `claude.ai/code` URL に表示されるものと同じ識別子です。これにより、スクリプトは自身を実行したセッションにリンクできます。Claude Code v2.1.199 以降が必要です。[クラウドセッション](/docs/ja/claude-code-on-the-web)では、代わりに `CLAUDE_CODE_REMOTE_SESSION_ID` を読み取ります |

231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | `0` に設定すると、Claude Code は `0x08` バイト（`^H` とも表記）を通常の Backspace として読み取り、`1` に設定すると Ctrl+Backspace として読み取ります。どちらの値もプラットフォームのデフォルトを置き換えます。デフォルトでは、Claude Code はこれを Windows では Ctrl+Backspace として読み取り（ただし `TERM_PROGRAM` が `mintty` の場合や `TERM` が `cygwin` の場合を除く）、macOS と Linux では通常の Backspace として読み取ります。[Backspace で単語全体が削除される](/docs/ja/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) Windows のターミナルでは `0` を設定してください |231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | `0` に設定すると、Claude Code は `0x08` バイト（`^H` とも表記）を通常の Backspace として読み取り、`1` に設定すると Ctrl+Backspace として読み取ります。いずれの値もプラットフォームのデフォルトを置き換えます。デフォルトでは、Claude Code は Windows では Ctrl+Backspace として読み取ります（ただし `TERM_PROGRAM` が `mintty` の場合や `TERM` が `cygwin` の場合を除く）。macOS と Linux では通常の Backspace として読み取ります。[Backspace で単語全体が削除される](/docs/ja/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) Windows のターミナルでは `0` を設定します |

232| `CLAUDE_CODE_CERT_STORE` | TLS 接続用の CA 証明書ソースのカンマ区切りリスト。`bundled` は Claude Code に同梱されている Mozilla CA セットです。`system` はオペレーティングシステムのトラストストアで、`tls.getCACertificates` を備えたランタイム（ネイティブバイナリ、または npm インストールの場合は Node 22.15 以降）でのみ読み取られます。[CA 証明書ストア](/docs/ja/network-config#ca-certificate-store) を参照してください。デフォルトは `bundled,system` です |232| `CLAUDE_CODE_CERT_STORE` | TLS 接続用の CA 証明書ソースのカンマ区切りリスト。`bundled` は Claude Code に同梱されている Mozilla の CA セットです。`system` はオペレーティングシステムのトラストストアで、`tls.getCACertificates` を備えたランタイム（ネイティブバイナリ、または npm インストールの場合は Node 22.15 以降）でのみ読み取られます。[CA 証明書ストア](/docs/ja/network-config#ca-certificate-store)を参照してください。デフォルトは `bundled,system` です |

233| `CLAUDE_CODE_CHILD_SESSION` | Claude Code が Bash、PowerShell、Monitor ツール、[フック](/docs/ja/hooks) コマンド、[ステータスライン](/docs/ja/statusline) コマンドを介して起動するサブプロセスで `1` に設定されます。stdio [MCP サーバー](/docs/ja/mcp) サブプロセスには設定されません。これらは長時間存続し、起動元のセッションより長く動作するためです。`CLAUDECODE` とは異なり、これは Claude Code 自体がサブプロセスを起動するときにのみ設定され、IDE 拡張機能では設定されないため、ネストされたセッションと、IDE 統合ターミナルで起動されたトップレベルの `claude` を確実に区別できます。このように起動されたネストされた対話型の `claude` TUI は、`--resume`、`--continue`、上矢印キーの履歴、`claude agents` リストから自動的に除外されます。非対話の `claude -p` セッションは引き続き保存されます。この除外を上書きするには `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` を設定します。Claude Code v2.1.172 以降が必要です |233| `CLAUDE_CODE_CHILD_SESSION` | Claude Code が Bash、PowerShell、Monitor ツール、[フック](/docs/ja/hooks)コマンド、[ステータスライン](/docs/ja/statusline)コマンドを介して起動するサブプロセスで `1` に設定されます。stdio の [MCP サーバー](/docs/ja/mcp)サブプロセスは長期間存続し、起動したセッションより長く存続するため、これらには設定されません。`CLAUDECODE` とは異なり、この変数は Claude Code 自身がサブプロセスを起動したときにのみ設定され、IDE 拡張機能では設定されません。そのため、ネストされたセッションと、IDE の統合ターミナルで起動されたトップレベルの `claude` を確実に区別できます。この方法で起動されたネストされた対話型の `claude` TUI は、`--resume`、`--continue`、上矢印キーの履歴、`claude agents` リストから自動的に除外されます。非対話の `claude -p` セッションは引き続き保存されます。この除外を上書きするには、`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` を設定します。Claude Code v2.1.172 以降が必要です |

237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | v2.1.186 で削除され、現在は何も行いません。以前は、ストリーミング API リクエストの接続、TLS、レスポンスヘッダーのフェーズに個別のタイムアウトを設定していました。リクエストごとのタイムアウトには `API_TIMEOUT_MS` を使用してください。ストリーミングリクエストのレスポンスヘッダーのフェーズについては、`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` を参照してください |237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | v2.1.186 で削除され、現在は何もしません。以前は、ストリーミング API リクエストの接続、TLS、レスポンスヘッダーのフェーズに個別のタイムアウトを設定していました。リクエストごとのタイムアウトには `API_TIMEOUT_MS` を使用します。ストリーミングリクエストのレスポンスヘッダーのフェーズについては、`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` を参照してください |

238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | デバッグログファイルのパスを上書きします。名前に反して、これはディレクトリではなくファイルパスです。`--debug`、`/debug`、または `DEBUG` 環境変数を使用して、別途デバッグモードを有効にする必要があります。この変数を設定するだけではログは有効になりません。[`--debug-file`](/docs/ja/cli-reference#cli-flags) フラグは両方を一度に行います。デフォルトは `~/.claude/debug/<session-id>.txt` です |238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | デバッグログファイルのパスを上書きします。名前に反して、これはディレクトリではなくファイルパスです。デバッグモードは `--debug`、`/debug`、または `DEBUG` 環境変数で別途有効にする必要があります。この変数を設定するだけではログは有効になりません。[`--debug-file`](/docs/ja/cli-reference#cli-flags) フラグは両方を一度に行います。デフォルトは `~/.claude/debug/<session-id>.txt` です |

239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | デバッグログファイルに書き込まれる最小ログレベル。値: `verbose`、`debug`（デフォルト）、`info`、`warn`、`error`。ステータスラインコマンドの完全な出力など、大量の診断情報を含めるには `verbose` に設定し、ノイズを減らすには `error` に引き上げます |239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | デバッグログファイルに書き込まれる最小ログレベル。値: `verbose`、`debug`（デフォルト）、`info`、`warn`、`error`。ステータスラインコマンドの完全な出力など大量の診断情報を含めるには `verbose` に設定し、ノイズを減らすには `error` に引き上げます |

240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | `1` に設定すると、[1M コンテキストウィンドウ](/docs/ja/model-config#extended-context) のサポートを無効にします。設定すると、1M のモデルバリアントはモデルピッカーで使用できなくなり、Claude Code は [Sonnet 5.5](/docs/ja/model-config#sonnet-5-5-and-sonnet-5-context-window) や Fable モデルなど、ネイティブで 1M ウィンドウを持つモデルのセッションを 200K ウィンドウに制限します。この制限がどのように適用されるかについては、[拡張コンテキスト](/docs/ja/model-config#extended-context) を参照してください。コンプライアンス要件のあるエンタープライズ環境で便利です。認識されない `[1m]` モデル ID のウィンドウを補正する際の役割については、[ゲートウェイまたはカスタムモデル ID のウィンドウを補正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください |240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | `1` に設定すると、[1M コンテキストウィンドウ](/docs/ja/model-config#extended-context)のサポートを無効にします。設定すると、1M のモデルバリアントはモデルピッカーで利用できなくなり、[Sonnet 5.5](/docs/ja/model-config#sonnet-5-5-and-sonnet-5-context-window) や Fable モデルなど、ネイティブで 1M ウィンドウを持つモデルのセッションは、Claude Code によって 200K ウィンドウに制限されます。この制限の適用方法については、[拡張コンテキスト](/docs/ja/model-config#extended-context)を参照してください。コンプライアンス要件のあるエンタープライズ環境で便利です。認識されない `[1m]` モデル ID のウィンドウを修正する際の役割については、[ゲートウェイまたはカスタムモデル ID のウィンドウを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id)を参照してください |

241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | `1` に設定すると、Opus 4.6 と Sonnet 4.6 で [適応型推論](/docs/ja/model-config#adjust-effort-level) を無効にし、`MAX_THINKING_TOKENS` で制御される固定の思考予算にフォールバックします。常に適応型推論を使用する [Fable モデル](/docs/ja/model-config#extended-thinking)、Sonnet 5 以降、Opus 4.7 以降には効果がありません |241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | `1` に設定すると、Opus 4.6 および Sonnet 4.6 で[適応型推論](/docs/ja/model-config#adjust-effort-level)を無効にし、`MAX_THINKING_TOKENS` で制御される固定の思考予算にフォールバックします。常に適応型推論を使用する [Fable モデル](/docs/ja/model-config#extended-thinking)、Sonnet 5 以降、Opus 4.7 以降には効果がありません |

242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | `1` に設定すると、Claude Code が管理者のソース間で [管理設定](/docs/ja/managed-settings#precedence-within-the-managed-tier) の `env` ブロックをキーごとにマージしないようにし、v2.1.223 より前と同様に、優先順位が最も高いソースの `env` ブロック全体のみが適用されます。Claude Code は設定の `env` ブロックを通じて渡されたコピーを無視するため、Claude Code を起動する環境で設定してください。Claude Code v2.1.223 以降が必要です |242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | `1` に設定すると、Claude Code が複数の管理ソースにわたる[管理設定](/docs/ja/managed-settings#precedence-within-the-managed-tier)の `env` ブロックをキーごとにマージしないようにし、v2.1.223 より前と同様に、最も優先度の高いソースの `env` ブロック全体のみが適用されるようにします。Claude Code は設定の `env` ブロックで配信された値を無視するため、Claude Code を起動する環境で設定します。Claude Code v2.1.223 以降が必要です |

243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | `1` に設定すると、[アドバイザーツール](/docs/ja/advisor) を無効にします。`/advisor` コマンドは使用できなくなり、設定された `advisorModel` は無視され、`--advisor` フラグは受け付けられますが効果がないため、このフラグを渡す既存のスクリプトはエラーなく動作し続けます |243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | `1` に設定すると、[アドバイザーツール](/docs/ja/advisor)を無効にします。`/advisor` コマンドは利用できなくなり、設定された `advisorModel` は無視され、`--advisor` フラグは受け付けられますが効果はありません。そのため、このフラグを渡す既存のスクリプトはエラーなく動作し続けます |

244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | `1` に設定すると、[バックグラウンドエージェントとエージェントビュー](/docs/ja/agent-view) をオフにします：`claude agents`、`--bg`、`/background`、およびオンデマンドのスーパーバイザー。[`disableAgentView`](/docs/ja/settings-reference#disableagentview) 設定と同等です |244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | `1` に設定すると、[バックグラウンドエージェントとエージェントビュー](/docs/ja/agent-view)（`claude agents`、`--bg`、`/background`、オンデマンドのスーパーバイザー）をオフにします。[`disableAgentView`](/docs/ja/settings-reference#disableagentview) 設定と同等です |

245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen) を無効にし、従来のメイン画面レンダラーを使用します。会話はターミナルのネイティブのスクロールバックに残るため、`Cmd+f` と tmux のコピーモードが通常どおり機能します。`CLAUDE_CODE_NO_FLICKER` と [`tui`](/docs/ja/settings-reference#tui) 設定より優先されます。`/tui default` で切り替えることもできます。[エージェントビュー](/docs/ja/agent-view) から開いたバックグラウンドセッションには適用されません。これらは常にフルスクリーンレンダリングを使用します |245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen)を無効にし、従来のメイン画面レンダラーを使用します。会話はターミナルのネイティブスクロールバックに残るため、`Cmd+f` や tmux のコピーモードが通常どおり機能します。`CLAUDE_CODE_NO_FLICKER` および [`tui`](/docs/ja/settings-reference#tui) 設定より優先されます。`/tui default` で切り替えることもできます。常にフルスクリーンレンダリングを使用する、[エージェントビュー](/docs/ja/agent-view)から開いたバックグラウンドセッションには適用されません |

246| `CLAUDE_CODE_DISABLE_ARTIFACT` | `1` に設定すると、セッションの出力を claude.ai 上の非公開 Web ページとして公開する [Artifact](/docs/ja/artifacts) ツールをオフにします。一度設定すると、どの設定ファイルでもツールを再びオンにすることはできません。代わりに設定ファイルからツールをオフにするには、[`enableArtifact`](/docs/ja/settings-reference#enableartifact) を `false` に設定します。非推奨の [`disableArtifact`](/docs/ja/settings-reference#disableartifact) キーでもオフにできます |246| `CLAUDE_CODE_DISABLE_ARTIFACT` | `1` に設定すると、セッションの出力を claude.ai 上の非公開 Web ページとして公開する [Artifact](/docs/ja/artifacts) ツールをオフにします。設定すると、どの設定ファイルでもツールを再びオンにすることはできません。代わりに設定ファイルからツールをオフにするには、[`enableArtifact`](/docs/ja/settings-reference#enableartifact) を `false` に設定します。非推奨の [`disableArtifact`](/docs/ja/settings-reference#disableartifact) キーでもオフにできます |

248| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | `1` に設定すると、別のプロセスが実行している間待機するのではなく、Claude Code のプロセスが自身で [`gcpAuthRefresh`](/docs/ja/settings-reference#gcpauthrefresh) または [`awsAuthRefresh`](/docs/ja/settings-reference#awsauthrefresh) コマンドを実行するようにします。Claude Code v2.1.286 以降が必要です |248| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | `1` に設定すると、Claude Code のプロセスは、別のプロセスが [`gcpAuthRefresh`](/docs/ja/settings-reference#gcpauthrefresh) または [`awsAuthRefresh`](/docs/ja/settings-reference#awsauthrefresh) コマンドを実行するのを待たずに、自身でそのコマンドを実行します。Claude Code v2.1.286 以降が必要です |

249| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | `1` に設定すると、[自動メモリ](/docs/ja/memory#auto-memory) を無効にします。`0` に設定すると、`--bare` モードや [`autoMemoryEnabled: false`](/docs/ja/settings-reference#automemoryenabled) によって無効になる場合でも、自動メモリを強制的にオンにします。無効にすると、Claude は自動メモリファイルを作成も読み込みもしません |249| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | `1` に設定すると、[自動メモリ](/docs/ja/memory#auto-memory)を無効にします。`0` に設定すると、`--bare` モードや [`autoMemoryEnabled: false`](/docs/ja/settings-reference#automemoryenabled) によって無効になる場合でも、自動メモリを強制的にオンにします。無効にすると、Claude は自動メモリファイルを作成または読み込みしません |

250| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | `1` に設定すると、Bash ツールとサブエージェントツールの `run_in_background` パラメーター、自動バックグラウンド化、Ctrl+B ショートカットを含む、すべてのバックグラウンドタスク機能を無効にします |250| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | `1` に設定すると、Bash およびサブエージェントツールの `run_in_background` パラメーター、自動バックグラウンド化、Ctrl+B ショートカットを含む、すべてのバックグラウンドタスク機能を無効にします |

251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | `1` に設定すると、`Content-Type` ヘッダーが欠落しているか空の [Amazon Bedrock](/docs/ja/amazon-bedrock) ストリーミングレスポンスを、Claude Code が Amazon Bedrock のバイナリイベントストリームとして扱わないようにします。デフォルトでは、Claude Code は、それ以外は変更されていないレスポンスからゲートウェイがヘッダーを削除したものとみなすため、ボディをデコードし、ストリーミングは引き続き機能します。ストリームを server-sent events として再出力するゲートウェイの場合にのみ設定してください。その場合、Claude Code はヘッダーのないボディを代わりに server-sent events として読み取ります。Claude Code v2.1.239 以降が必要です |251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | `1` に設定すると、`Content-Type` ヘッダーが欠落しているか空の [Amazon Bedrock](/docs/ja/amazon-bedrock) ストリーミングレスポンスを、Claude Code が Amazon Bedrock のバイナリイベントストリームとして扱わないようにします。デフォルトでは、Claude Code はゲートウェイがそれ以外は変更されていないレスポンスからヘッダーを削除したとみなすため、ボディをデコードし、ストリーミングは引き続き機能します。ストリームを Server-Sent Events として再送出するゲートウェイの場合にのみ設定します。その場合、Claude Code はヘッダーのないボディを Server-Sent Events として読み取ります。Claude Code v2.1.239 以降が必要です |

252| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | `1` に設定すると、[Amazon Bedrock](/docs/ja/amazon-bedrock) のストリーミングレスポンスが `application/vnd.amazon.eventstream` の content-type を持つかどうかのチェックをスキップします。この変数がない場合、レスポンスが異なる content-type を持つと、Claude Code はその型を示すエラーでリクエストを失敗させます。これは [ゲートウェイまたはプロキシがレスポンスを変換している](/docs/ja/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy) ことを意味します。この変数を設定するのではなく、`Content-Type` ヘッダーとボディを変更せずに転送するようにゲートウェイを設定してください。Claude Code v2.1.208 以降が必要です |252| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | `1` に設定すると、[Amazon Bedrock](/docs/ja/amazon-bedrock) のストリーミングレスポンスが `application/vnd.amazon.eventstream` の content-type を持つかどうかのチェックをスキップします。この変数がない場合、レスポンスが異なる content-type を持つと、Claude Code はその型を示すエラーでリクエストを失敗させます。これは[ゲートウェイまたはプロキシがレスポンスを変換している](/docs/ja/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy)ことを意味します。この変数を設定するのではなく、`Content-Type` ヘッダーとボディを変更せずに転送するようゲートウェイを設定してください。Claude Code v2.1.208 以降が必要です |

253| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | `1` に設定すると、[スーパーバイザー](/docs/ja/agent-view#the-supervisor-process) がセッションのプロセスを停止、再起動、または更新するときに、[バックグラウンドセッション](/docs/ja/agent-view) で実行中のバックグラウンドシェルコマンド、動的ワークフロー、および v2.1.198 以降ではバックグラウンドサブエージェントを、セッションの次のプロセスに引き渡すのではなく停止します。影響するのはこの引き渡しのみです：`←` または [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラウンド化した場合は、引き続き実行中の作業が引き継がれます。`CLAUDE_DISABLE_ADOPT` は両方をオフにします。Claude Code v2.1.196 以降が必要です |253| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | `1` に設定すると、[スーパーバイザー](/docs/ja/agent-view#the-supervisor-process)が[バックグラウンドセッション](/docs/ja/agent-view)のプロセスを停止、再起動、または更新したときに、そのセッションで実行中のバックグラウンドシェルコマンド、動的ワークフロー、および v2.1.198 以降ではバックグラウンドサブエージェントを、セッションの次のプロセスに引き継ぐのではなく停止します。影響するのはこの引き継ぎのみです。`←` または [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラウンド化した場合は、実行中の作業が引き続き引き継がれます。`CLAUDE_DISABLE_ADOPT` は両方をオフにします。Claude Code v2.1.196 以降が必要です |

254| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | `1` に設定すると、メモリ逼迫時に Claude Code が [バックグラウンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands) を終了しないようにします。デフォルトでは、macOS と Linux で、オペレーティングシステムが深刻なメモリ逼迫を報告し、かつセッションがターンやサブエージェントを実行せずに 30 分間アイドル状態になっている場合、Claude Code はバックグラウンドシェルを終了します。Windows にはメモリ逼迫のシグナルがないため、この変数は効果がありません。Claude Code v2.1.193 以降が必要です |254| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | `1` に設定すると、メモリ逼迫時に Claude Code が[バックグラウンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands)を終了しないようにします。デフォルトでは、macOS と Linux において、オペレーティングシステムが深刻なメモリ逼迫を報告し、かつセッションがターンやサブエージェントの実行なしに 30 分間アイドル状態である場合、Claude Code はバックグラウンドシェルを終了します。Windows にはメモリ逼迫のシグナルがないため、この変数は効果がありません。Claude Code v2.1.193 以降が必要です |

255| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | `1` に設定すると、Claude Code に含まれる [スキル](/docs/ja/skills) とワークフローを無効にします：バンドルスキルとワークフローは完全に削除され、`/init` などの組み込みコマンドは入力可能なままですがモデルからは隠されます。`/doctor` は組み込みコマンドと同様に入力可能なままです。これを非表示にするには、代わりに `DISABLE_DOCTOR_COMMAND` を使用してください。プラグイン、`.claude/skills/`、`.claude/commands/` のスキルは影響を受けません。[`disableBundledSkills`](/docs/ja/settings-reference#disablebundledskills) 設定と同等です |255| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | `1` に設定すると、Claude Code に含まれる[スキル](/docs/ja/skills)とワークフローを無効にします。バンドルスキルとワークフローは完全に削除され、`/init` などの組み込みコマンドは入力可能なままですがモデルからは非表示になります。`/doctor` は組み込みコマンドと同様に入力可能なままです。非表示にするには、代わりに `DISABLE_DOCTOR_COMMAND` を使用します。プラグイン、`.claude/skills/`、`.claude/commands/` のスキルは影響を受けません。[`disableBundledSkills`](/docs/ja/settings-reference#disablebundledskills) 設定と同等です |

256| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | `1` に設定すると、[Claude in Chrome](/docs/ja/chrome) のブラウザツールを使用可能なまま、システムプロンプトの Chrome セクションと `/claude-in-chrome` [バンドルスキル](/docs/ja/skills#bundled-skills) を省略します。Claude Code を組み込み、独自のブラウザガイダンスを提供するホスト向けです。Claude Code v2.1.257 以降が必要です |256| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | `1` に設定すると、[Claude in Chrome](/docs/ja/chrome) のブラウザーツールを利用可能なままにしつつ、システムプロンプトの Chrome セクションと `/claude-in-chrome` [バンドルスキル](/docs/ja/skills#bundled-skills)を省略します。Claude Code を組み込み、独自のブラウザーガイダンスを提供するホスト向けです。Claude Code v2.1.257 以降が必要です |

258| `CLAUDE_CODE_DISABLE_CRON` | `1` に設定すると、[スケジュールタスク](/docs/ja/scheduled-tasks) を無効にします。`/loop` スキルと cron ツールは使用できなくなり、セッションの途中ですでに実行中のタスクを含め、すでにスケジュールされているタスクは実行されなくなります |258| `CLAUDE_CODE_DISABLE_CRON` | `1` に設定すると、[スケジュールタスク](/docs/ja/scheduled-tasks)を無効にします。`/loop` スキルと cron ツールは利用できなくなり、セッション中にすでに実行中のタスクを含め、スケジュール済みのタスクは実行されなくなります |

259| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | `1` に設定すると、[重要パスの削除](/docs/ja/permission-modes#critical-paths) プロンプトの時間制限をオフにします。その場合、`auto` モードでは Claude Code はこれらの削除を代わりに分類器に送信し、`bypassPermissions` モードではプロンプトがユーザーの回答を待ちます。Claude Code は設定の `env` ブロックを通じて渡されたコピーを無視するため、Claude Code を起動する環境で設定してください。Claude Code v2.1.281 以降が必要です |259| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | `1` に設定すると、[クリティカルパスの削除](/docs/ja/permission-modes#critical-paths)プロンプトの制限時間をオフにします。その場合、`auto` モードでは Claude Code がこれらの削除を代わりに分類器に送信し、`bypassPermissions` モードではプロンプトがユーザーの回答を待ちます。Claude Code は設定の `env` ブロックで配信された値を無視するため、Claude Code を起動する環境で設定します。Claude Code v2.1.281 以降が必要です |

260| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | `1` に設定すると、プレリリースの `anthropic-beta` リクエストヘッダー、それと対になるボディフィールド、および `defer_loading` や `eager_input_streaming` などのベータのツールスキーマフィールドを API リクエストから除去します。プロキシゲートウェイが、`anthropic-beta` ヘッダーに対する `Unexpected value(s)` エラーや `Extra inputs are not permitted` エラーでリクエストを拒否する場合に使用します。[プレリリース機能を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities) に、[MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) を含めこの変数が削除するものと、Claude Code が引き続き送信するものが記載されています |260| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | `1` に設定すると、プレリリースの `anthropic-beta` リクエストヘッダー、それと対になるボディフィールド、および `defer_loading` や `eager_input_streaming` などのベータ版ツールスキーマフィールドを API リクエストから除去します。プロキシゲートウェイが `anthropic-beta` ヘッダーに対する `Unexpected value(s)` エラーや `Extra inputs are not permitted` エラーでリクエストを拒否する場合に使用します。この変数が削除するもの（[MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search)を含む）と、Claude Code が引き続き送信するものについては、[プレリリース機能を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities)に記載されています |

261| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | `1` に設定すると、組み込みの [Explore サブエージェントと Plan サブエージェント](/docs/ja/sub-agents#built-in-subagents) を無効にします。Claude は代わりに検索ツールまたは汎用サブエージェントで探索し、[plan モード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode) は Explore エージェントと Plan エージェントを起動するのではなく、ファイルを直接読み取ります。`Explore` または `Plan` という名前のカスタムサブエージェントは影響を受けません。Agent SDK または非対話モードですべての組み込みサブエージェントタイプを削除するには、代わりに `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` を使用してください。Claude Code v2.1.198 以降が必要です |261| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | `1` に設定すると、組み込みの [Explore および Plan サブエージェント](/docs/ja/sub-agents#built-in-subagents)を無効にします。Claude は代わりに検索ツールまたは general-purpose サブエージェントで探索し、[plan モード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)は Explore および Plan エージェントを起動せずにファイルを直接読み取ります。`Explore` または `Plan` という名前のカスタムサブエージェントは影響を受けません。Agent SDK または非対話モードですべての組み込みサブエージェントタイプを削除するには、代わりに `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` を使用します。Claude Code v2.1.198 以降が必要です |

263| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | `1` に設定すると、「How is Claude doing?」のセッション品質アンケートを無効にします。`DISABLE_TELEMETRY`、`DO_NOT_TRACK`、または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が設定されている場合も、`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` で再度オプトインしない限り、アンケートは無効になります。完全に無効にする代わりにサンプリング率を設定するには、[`feedbackSurveyRate`](/docs/ja/settings-reference#feedbacksurveyrate) 設定を使用します。[セッション品質アンケート](/docs/ja/data-usage#session-quality-surveys) を参照してください |263| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | `1` に設定すると、「How is Claude doing?」というセッション品質アンケートを無効にします。`DISABLE_TELEMETRY`、`DO_NOT_TRACK`、または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が設定されている場合も、`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` で再度オプトインしない限り、アンケートは無効になります。完全に無効にする代わりにサンプルレートを設定するには、[`feedbackSurveyRate`](/docs/ja/settings-reference#feedbacksurveyrate) 設定を使用します。[セッション品質アンケート](/docs/ja/data-usage#session-quality-surveys)を参照してください |

264| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | `1` に設定すると、ファイルの [チェックポイント機能](/docs/ja/checkpointing) を無効にします。`/rewind` コマンドでコードの変更を復元できなくなります。[`fileCheckpointingEnabled`](/docs/ja/settings-reference#filecheckpointingenabled) 設定を上書きします |264| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | `1` に設定すると、ファイルの[チェックポイント機能](/docs/ja/checkpointing)を無効にします。`/rewind` コマンドでコードの変更を復元できなくなります。[`fileCheckpointingEnabled`](/docs/ja/settings-reference#filecheckpointingenabled) 設定を上書きします |

265| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | `1` に設定すると、組み込みのコミットと PR のワークフロー指示、および git ステータスのスナップショットを Claude のコンテキストから削除します。独自の git ワークフロースキルを使用する場合に便利です。設定すると、[`includeGitInstructions`](/docs/ja/settings-reference#includegitinstructions) 設定より優先されます |265| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | `1` に設定すると、組み込みのコミットおよび PR ワークフローの指示と git status のスナップショットを Claude のコンテキストから削除します。独自の git ワークフロースキルを使用する場合に便利です。設定すると、[`includeGitInstructions`](/docs/ja/settings-reference#includegitinstructions) 設定より優先されます |

266| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | `1` に設定すると、Anthropic API で Opus 4.0 と 4.1 が現在の Opus バージョンに自動的に再マッピングされるのを防ぎます。意図的に古いモデルに固定したい場合に使用します。この再マッピングは Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry では実行されません |266| `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` | `1` に設定すると、`bash -c 'rm -rf ~'` のように `-c` でシェルに渡されたスクリプトを、Claude Code が[クリティカルパス](/docs/ja/permission-modes#removals-inside-nested-commands-and-inline-scripts)の削除について読み取らないようにします。Claude Code は、それらのスクリプト内のシェル変数および位置パラメーターの対象については引き続きチェックし、その他のクリティカルパスのチェックも引き続き実行されます。Claude Code は設定の `env` ブロックで配信された値を無視するため、Claude Code を起動する環境で設定します。Claude Code v2.1.288 以降が必要です |

267| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | `1` に設定すると、セッションの途中でアカウントがセッションのモデルへのアクセスを失ったときに、[Amazon Bedrock](/docs/ja/amazon-bedrock#when-a-model-is-disabled-mid-session) と [Google Cloud's Agent Platform](/docs/ja/google-vertex-ai#when-a-model-is-disabled-mid-session) 上の Claude Code が古いモデルに切り替えないようにします。代わりに、拒否されたリクエストは即座に失敗します。設定した [フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains) はその拒否時に引き続き切り替わり、[起動時のモデルチェック](/docs/ja/amazon-bedrock#startup-model-checks) も起動時に引き続きフォールバックします。Claude Code v2.1.285 以降が必要です |267| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | `1` に設定すると、Anthropic API において Opus 4.0 および 4.1 が現在の Opus バージョンに自動的に再マッピングされるのを防ぎます。意図的に古いモデルに固定したい場合に使用します。再マッピングは Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry では実行されません |

268| `CLAUDE_CODE_DISABLE_MOUSE` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen) でマウストラッキングを無効にします。`PgUp` と `PgDn` によるキーボードスクロールは引き続き機能します。ターミナルのネイティブの選択時コピー動作を維持するために使用します |268| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | `1` に設定すると、[Amazon Bedrock](/docs/ja/amazon-bedrock#when-a-model-is-disabled-mid-session) および [Google Cloud's Agent Platform](/docs/ja/google-vertex-ai#when-a-model-is-disabled-mid-session) で、セッションの途中でアカウントがセッションのモデルへのアクセスを失った場合に、Claude Code が古いモデルに切り替えないようにします。代わりに、拒否されたリクエストはその場で失敗します。ユーザーが設定した[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)はその拒否時にも切り替わり、[起動時のモデルチェック](/docs/ja/amazon-bedrock#startup-model-checks)も起動時に引き続きフォールバックします。Claude Code v2.1.285 以降が必要です |

269| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | `1` に設定すると、マウスホイールのスクロールを維持したまま、[フルスクリーンレンダリング](/docs/ja/fullscreen) でのクリック、ドラッグ、ホバーの処理を無効にします。Claude Code 内でホイールスクロールは機能させたいものの、クリックでカーソルを移動したり、ツール出力を展開したり、リンクを開いたりしたくない場合に使用します。両方が設定されている場合は `CLAUDE_CODE_DISABLE_MOUSE` が優先されます。Claude Code v2.1.195 以降が必要です |269| `CLAUDE_CODE_DISABLE_MOUSE` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen)でマウストラッキングを無効にします。`PgUp` と `PgDn` によるキーボードでのスクロールは引き続き機能します。ターミナルのネイティブな選択時コピー動作を維持するために使用します |

270| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | `1` に設定すると、API リクエストが接続リセットや TLS ハンドシェイクエラーなどの接続レベルのエラーで失敗したときに、Claude Code が [mTLS クライアント証明書と鍵](/docs/ja/network-config#mtls-authentication) を再読み込みしないようにします。再読み込みを無効にすると、Claude Code はローテーションされたファイルを、次に設定を適用するときか次回の起動時にのみ読み込みます。Claude Code v2.1.232 以降が必要です |270| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | `1` に設定すると、マウスホイールによるスクロールを維持したまま、[フルスクリーンレンダリング](/docs/ja/fullscreen)でのクリック、ドラッグ、ホバーの処理を無効にします。Claude Code 内でホイールスクロールは機能させたいが、クリックでカーソルの位置決め、ツール出力の展開、リンクを開く操作をさせたくない場合に使用します。両方が設定されている場合は `CLAUDE_CODE_DISABLE_MOUSE` が優先されます。Claude Code v2.1.195 以降が必要です |

271| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | `1` などの空でない任意の値に設定すると、必須ではないネットワークトラフィックを無効にします：自動更新、テレメトリ、エラー報告、`/feedback` コマンド、[Claude が下書きしたフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)、リリースノート、[PR と MR のステータスバッジ](/docs/ja/interactive-mode#pr-review-status) のチェック、[fast モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) のチェックなどの可用性チェック。また、[プラグインの `command` ソースのバックグラウンド実行](/docs/ja/plugins/loading#when-a-command-source-re-runs) も停止します。これらはネットワークトラフィックではなくローカルコマンドですが、依存関係のインストールをトリガーする可能性があるためです。**`0` または `false` に設定してもこのトラフィックは無効になります**。これはほとんどのオン/オフ変数とは異なります。再び許可するには、変数の設定を解除してください。また、機能フラグの取得も無効になるため、[Remote Control](/docs/ja/remote-control#requirements) や、その他の [機能フラグの取得を必要とする機能](#features-that-need-feature-flag-fetching) が使用できなくなります。公式プラグインマーケットプレイスの自動インストールは対象外です。`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` で無効にしてください。独自のオプトインを持つ [ゲートウェイモデルの検出](/docs/ja/llm-gateway-connect#add-gateway-models-to-the-model-picker) には影響しません |271| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | `1` に設定すると、接続のリセットや TLS ハンドシェイクエラーなど、接続レベルのエラーで API リクエストが失敗したときに、Claude Code が [mTLS クライアント証明書と鍵](/docs/ja/network-config#mtls-authentication)を再読み込みしないようにします。再読み込みを無効にすると、Claude Code はローテーションされたファイルを、次に設定を適用するときか次回の起動時にのみ読み込みます。Claude Code v2.1.232 以降が必要です |

272| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | `1` に設定すると、ストリーミングリクエストがストリームの途中で失敗したときの非ストリーミングフォールバックを無効にします。代わりに、ストリーミングエラーは再試行レイヤーに伝播されます。プロキシまたはゲートウェイが原因で、フォールバックによりツールが重複して実行される場合に便利です |272| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | `1` などの空でない任意の値に設定すると、必須ではないネットワークトラフィックを無効にします。対象は、自動更新、テレメトリ、エラー報告、`/feedback` コマンド、[Claude が作成するフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)、リリースノート、[PR および MR のステータスバッジ](/docs/ja/interactive-mode#pr-review-status)のチェック、[fast mode](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) のチェックなどの可用性チェックです。また、[プラグインの `command` ソースのバックグラウンド実行](/docs/ja/plugins/loading#when-a-command-source-re-runs)も停止します。これはネットワークトラフィックではなくローカルコマンドですが、依存関係のインストールをトリガーする可能性があるためです。**ほとんどのオン/オフ変数とは異なり、`0` や `false` に設定してもこのトラフィックは無効になります**。再び許可するには変数の設定を解除します。また、機能フラグの取得も無効になるため、[Remote Control](/docs/ja/remote-control#requirements) やその他の[機能フラグの取得を必要とする機能](#features-that-need-feature-flag-fetching)が利用できなくなります。公式プラグインマーケットプレイスの自動インストールは対象外です。`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` で無効にします。独自のオプトインを持つ[ゲートウェイのモデル検出](/docs/ja/llm-gateway-connect#add-gateway-models-to-the-model-picker)には影響しません |

273| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | `1` に設定すると、ターミナルで入力中、またはターミナルにフォーカスしている間でも、`PushNotification` ツールのデスクトップ通知を送信します。デフォルトでは、最近のキーボード操作やターミナルのフォーカスを検出すると、ツールはデスクトップ通知と [モバイルプッシュ](/docs/ja/remote-control#mobile-push-notifications) の両方をスキップします。この変数はそのローカルチェックのみを無効にするため、ユーザーがアクティブであることをサーバーが検出した場合は、引き続きサーバーがモバイルプッシュを抑制できます。Claude Code v2.1.193 以降が必要です |273| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | `1` に設定すると、ストリーミングリクエストが途中で失敗した場合の非ストリーミングフォールバックを無効にします。ストリーミングエラーは代わりに再試行レイヤーに伝播されます。プロキシやゲートウェイによってフォールバックがツールの重複実行を引き起こす場合に便利です |

274| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | `1` に設定すると、公式プラグインマーケットプレイスの自動登録を無効にします。Claude Code は、マーケットプレイスを登録しようとするとき（通常はマシンでの最初の対話型起動時）にこの変数を読み取ります。その時点で変数が設定されていると、Claude Code は登録を永続的にスキップします。後で変数の設定を解除しても、スキップは取り消されません。`claude plugin marketplace add anthropics/claude-plugins-official` を実行すると、いつでもマーケットプレイスを登録できます |274| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | `1` に設定すると、ユーザーがターミナルで入力中やターミナルにフォーカスしている間でも、`PushNotification` ツールのデスクトップ通知を送信します。デフォルトでは、最近のキーボード操作やターミナルのフォーカスを検出すると、ツールはデスクトップ通知と[モバイルプッシュ](/docs/ja/remote-control#mobile-push-notifications)の両方をスキップします。この変数はそのローカルチェックのみを無効にするため、サーバーはユーザーがアクティブであることを検出した場合、引き続きモバイルプッシュを抑制できます。Claude Code v2.1.193 以降が必要です |

275| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | `1` に設定すると、Claude Code が権限リクエストを Agent SDK の `canUseTool` コールバックに送信するセッション（Claude Desktop と VS Code 拡張機能はこの方法で Claude Code をホストします）で、Claude Code が [未回答の権限リクエストに対する `Notification` フック](/docs/ja/hooks#notification) を実行しないようにします。ターミナルセッションでは効果がありません。Claude Code v2.1.233 以降が必要です |275| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | `1` に設定すると、公式プラグインマーケットプレイスの自動登録を無効にします。Claude Code は、マーケットプレイスを登録しようとするとき（通常はマシンでの最初の対話的な起動時）にこの変数を読み取ります。その時点で変数が設定されている場合、Claude Code は登録を恒久的にスキップします。後で変数の設定を解除しても、スキップは取り消されません。`claude plugin marketplace add anthropics/claude-plugins-official` を実行すると、いつでもマーケットプレイスを登録できます |

276| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | `1` に設定すると、システム全体の管理スキルディレクトリからのスキルの読み込みをスキップします。オペレーターがプロビジョニングしたスキルを読み込むべきでないコンテナや CI セッションに便利です |276| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | `1` に設定すると、Claude Code が権限リクエストを Agent SDK の `canUseTool` コールバックに送信するセッション（Claude Desktop や VS Code 拡張機能が Claude Code をホストする方法）において、Claude Code が[未回答の権限リクエストに対する `Notification` フック](/docs/ja/hooks#notification)を実行しないようにします。ターミナルセッションでは効果がありません。Claude Code v2.1.233 以降が必要です |

277| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | `1` に設定すると、ドライブのルートやホームディレクトリなどの [システムパス](/docs/ja/permission-modes#remove-item-in-powershell) に対する `cmd` 組み込みコマンドの `rd`、`rmdir`、`del`、`erase` を拒否する [PowerShell ツール](/docs/ja/tools-reference#powershell-tool) のチェックをオフにします。Claude Code は設定ファイルの `env` ブロック内のこの変数を無視します。Claude Code v2.1.283 以降が必要です |277| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | `1` に設定すると、システム全体の管理スキルディレクトリからのスキルの読み込みをスキップします。オペレーターがプロビジョニングしたスキルを読み込むべきでないコンテナや CI のセッションに便利です |

278| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | `1` に設定すると、上流がそれらを拒否する [LLM ゲートウェイ](/docs/ja/llm-gateway-protocol#feature-pass-through) のために、Claude Code が構造化出力の `output_config.format` フィールドと、それと対になる `anthropic-beta` の値を送信しないようにします。[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities) がオフにするその他のプレリリース機能はオンのままになります。Claude Code v2.1.288 以降が必要です |278| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | `1` に設定すると、ドライブのルートやホームディレクトリなどの[システムパス](/docs/ja/permission-modes#remove-item-in-powershell)に対する `cmd` 組み込みコマンド `rd`、`rmdir`、`del`、`erase` を拒否する [PowerShell ツール](/docs/ja/tools-reference#powershell-tool)のチェックをオフにします。Claude Code は設定ファイルの `env` ブロック内のこの変数を無視します。Claude Code v2.1.283 以降が必要です |

279| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | `1` に設定すると、`rm -rf "$(pwd)"` のように、対象全体がコマンド置換の出力である再帰的な `rm` に対する [重要パス](/docs/ja/permission-modes#critical-paths) のチェックをオフにします。その他の重要パスのチェックは引き続き実行されます。Claude Code は設定の `env` ブロックを通じて渡されたコピーを無視するため、Claude Code を起動する環境で設定してください。Claude Code v2.1.281 以降が必要です |279| `CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK` | `1` に設定すると、[安全性分類器がリクエストを警告したときの自動モデル切り替え](/docs/ja/model-config#automatic-model-fallback)をオフにします。これは [`switchModelsOnFlag`](/docs/ja/settings-reference#switchmodelsonflag) 設定が制御する動作です |

280| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | `1` に設定すると、会話のコンテキストに基づくターミナルタイトルの自動更新を無効にします。これにより、[セッションタイトルを生成する](/docs/ja/sessions#name-your-sessions) バックグラウンドの small/fast モデルへのリクエストもスキップされます |280| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | `1` に設定すると、アップストリームがそれらを拒否する [LLM ゲートウェイ](/docs/ja/llm-gateway-protocol#feature-pass-through)向けに、Claude Code が構造化出力の `output_config.format` フィールドと、それと対になる `anthropic-beta` 値を送信しないようにします。[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities) がオフにするその他のプレリリース機能はオンのままです。Claude Code v2.1.288 以降が必要です |

281| `CLAUDE_CODE_DISABLE_THINKING` | `1` に設定すると、API リクエストから `thinking` パラメーターを完全に省略します。これは、このパラメーターを拒否するプロキシやゲートウェイのための互換性オプションです。デフォルトで思考するモデルでは、パラメーターを省略してもモデルが思考する場合があります。Anthropic API で [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) を明示的に無効にするには、代わりに `MAX_THINKING_TOKENS=0` を使用してください。思考をオフにできない Opus 5.5、Sonnet 5.5、Fable モデルでは、どちらの変数でも思考はオフになりません。[サードパーティプロバイダー](/docs/ja/third-party-integrations) では、`MAX_THINKING_TOKENS=0` も同様にパラメーターを省略するため、そこでは 2 つの変数は同じように動作します |281| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | `1` に設定すると、`rm -rf "$(pwd)"` のように、対象がすべてコマンド置換の出力である再帰的な `rm` に対する[クリティカルパス](/docs/ja/permission-modes#critical-paths)のチェックをオフにします。その他のクリティカルパスのチェックは引き続き実行されます。Claude Code は設定の `env` ブロックで配信された値を無視するため、Claude Code を起動する環境で設定します。Claude Code v2.1.281 以降が必要です |

282| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | `1` に設定すると、[LLM ゲートウェイ](/docs/ja/llm-gateway) のエイリアスなど、Claude Code がモデル ID を認識しない場合に、事前の [自動圧縮](/docs/ja/costs#reduce-token-usage) をスキップします。この変数がない場合、Claude Code はその ID に対して想定するコンテキストウィンドウで圧縮します。代わりに `CLAUDE_CODE_MAX_CONTEXT_TOKENS` で想定ウィンドウを補正することもできます。各変数がどのような場合に適用されるかについては、[ゲートウェイまたはカスタムモデル ID のウィンドウを補正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください。Claude Code v2.1.223 以降が必要です |282| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | `1` に設定すると、会話のコンテキストに基づくターミナルタイトルの自動更新を無効にします。これにより、[セッションタイトルを生成する](/docs/ja/sessions#name-your-sessions)バックグラウンドの小型・高速モデルへのリクエストもスキップされます |

283| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen) で仮想スクロールを無効にし、トランスクリプト内のすべてのメッセージをレンダリングします。フルスクリーンモードでのスクロール時に、メッセージが表示されるべき場所に空白の領域が表示される場合に使用します |283| `CLAUDE_CODE_DISABLE_THINKING` | `1` に設定すると、API リクエストから `thinking` パラメーターを完全に省略します。これは、このパラメーターを拒否するプロキシやゲートウェイ向けの互換性オプションです。デフォルトで思考するモデルでは、パラメーターを省略してもモデルが思考する場合があります。Anthropic API で[拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)を明示的に無効にするには、代わりに `MAX_THINKING_TOKENS=0` を使用します。思考をオフにできない Opus 5.5、Sonnet 5.5、Fable モデルでは、どちらの変数でも思考はオフになりません。[サードパーティプロバイダー](/docs/ja/third-party-integrations)では、`MAX_THINKING_TOKENS=0` も同様にパラメーターを省略するため、2 つの変数は同じ動作になります |

284| `CLAUDE_CODE_DISABLE_WEB_FETCH` | `1` に設定すると、[WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) ツールをオフにします。[WebSearch](/docs/ja/tools-reference#websearch-tool-behavior) ツールは引き続き使用できます。Claude Code v2.1.285 以降が必要です |284| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | `1` に設定すると、[LLM ゲートウェイ](/docs/ja/llm-gateway)のエイリアスなど、Claude Code がモデル ID を認識しない場合に、事前の[自動圧縮](/docs/ja/costs#reduce-token-usage)をスキップします。この変数がない場合、Claude Code はその ID について想定するコンテキストウィンドウで圧縮します。代わりに `CLAUDE_CODE_MAX_CONTEXT_TOKENS` で想定ウィンドウを修正することもできます。それぞれの変数が適用される場面については、[ゲートウェイまたはカスタムモデル ID のウィンドウを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id)を参照してください。Claude Code v2.1.223 以降が必要です |

285| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | `1` に設定すると、Windows で [PowerShell ツール](/docs/ja/tools-reference#powershell-tool) のコマンドを `cmd.exe` ランチャーを介さずに直接起動します。デフォルトでは、ランチャーにより、[バックグラウンドで実行中](/docs/ja/tools-reference#background-commands) の PowerShell コマンドが、[セッションをバックグラウンド化](/docs/ja/agent-view#from-inside-a-session) したときなどに [セッションの次のプロセスに引き継がれます](/docs/ja/agent-view#the-supervisor-process)。この変数を設定すると、バックグラウンド化された PowerShell コマンドは、セッションのプロセスが終了すると停止します。Bash コマンドは影響を受けません。Claude Code v2.1.269 以降が必要です |285| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen)で仮想スクロールを無効にし、トランスクリプト内のすべてのメッセージをレンダリングします。フルスクリーンモードでスクロールすると、メッセージが表示されるべき場所に空白の領域が表示される場合に使用します |

286| `CLAUDE_CODE_DISABLE_WORKFLOWS` | `1` に設定すると、[ワークフロー](/docs/ja/workflows#turn-workflows-off) を無効にします。[`disableWorkflows`](/docs/ja/settings-reference#disableworkflows) 設定と同等です |286| `CLAUDE_CODE_DISABLE_WEB_FETCH` | `1` に設定すると、[WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) ツールをオフにします。[WebSearch](/docs/ja/tools-reference#websearch-tool-behavior) ツールは引き続き利用できます。Claude Code v2.1.285 以降が必要です |

287| `CLAUDE_CODE_EFFORT_LEVEL` | サポートされているモデルの effort レベルを設定します。値: `low`、`medium`、`high`、`xhigh`、`max`、またはモデルのデフォルトを使用する `auto`。使用可能なレベルはモデルによって異なります。`--effort`、`/effort`、および `modelSettings` と `effortLevel` 設定より優先されます。[`maxEffortLevel`](/docs/ja/settings-reference#maxeffortlevel) による上限は引き続き適用されます。[effort レベルを調整する](/docs/ja/model-config#adjust-effort-level) を参照してください |287| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | `1` に設定すると、Windows で [PowerShell ツール](/docs/ja/tools-reference#powershell-tool)のコマンドを `cmd.exe` ランチャー経由ではなく直接起動します。デフォルトでは、ランチャーにより、[バックグラウンドで実行中](/docs/ja/tools-reference#background-commands)の PowerShell コマンドは、[セッションをバックグラウンド化した](/docs/ja/agent-view#from-inside-a-session)場合などに、[セッションの次のプロセスに引き継がれます](/docs/ja/agent-view#the-supervisor-process)。この変数を設定すると、バックグラウンド化された PowerShell コマンドは、セッションのプロセスが終了したときに停止します。Bash コマンドは影響を受けません。Claude Code v2.1.269 以降が必要です |

288| `CLAUDE_CODE_ENABLE_AUTO_MODE` | 古いリリースとの互換性のために受け付けられますが、効果はありません。auto モードは、Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry、サインイン済みの [Claude apps gateway](/docs/ja/claude-apps-gateway) セッションを含む、すべてのプロバイダーでデフォルトで使用できます。v2.1.158 から v2.1.206 までは、これらのプロバイダーで [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) を使用可能にするために、これを `1` に設定する必要がありました |288| `CLAUDE_CODE_DISABLE_WORKFLOWS` | `1` に設定すると、[ワークフロー](/docs/ja/workflows#turn-workflows-off)を無効にします。[`disableWorkflows`](/docs/ja/settings-reference#disableworkflows) 設定と同等です |

289| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | [セッションの要約](/docs/ja/interactive-mode#session-recap) の可用性を上書きします。`0` に設定すると、`/config` のトグルに関係なく要約を強制的にオフにします。`1` に設定すると、[`awaySummaryEnabled`](/docs/ja/settings-reference#awaysummaryenabled) が `false` の場合でも要約を強制的にオンにします。設定と `/config` のトグルより優先されます |289| `CLAUDE_CODE_EFFORT_LEVEL` | サポートされているモデルの effort レベルを設定します。値: `low`、`medium`、`high`、`xhigh`、`max`、またはモデルのデフォルトを使用する `auto`。利用可能なレベルはモデルによって異なります。`--effort`、`/effort`、および `modelSettings` と `effortLevel` 設定より優先されます。[`maxEffortLevel`](/docs/ja/settings-reference#maxeffortlevel) による上限は引き続き適用されます。[effort レベルを調整する](/docs/ja/model-config#adjust-effort-level)を参照してください |

290| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | `1` に設定すると、[非対話モード](/docs/ja/headless)でバックグラウンドインストールが完了した後、ターンの境界でプラグインの状態を更新します。この更新によってセッションの途中でシステムプロンプトが変わり、そのターンの[プロンプトキャッシュ](/docs/ja/prompt-caching)が無効になるため、デフォルトではオフです |290| `CLAUDE_CODE_ENABLE_AUTO_MODE` | 古いリリースとの互換性のために受け付けられますが、効果はありません。auto モードは、Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry、サインイン済みの [Claude apps gateway](/docs/ja/claude-apps-gateway) セッションを含むすべてのプロバイダーでデフォルトで利用できます。v2.1.158 から v2.1.206 では、これらのプロバイダーで [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) を利用可能にするには、これを `1` に設定する必要がありました |

291| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | `1` に設定すると、Anthropic 宛ての必須ではないトラフィックがブロックされている場合に、「How is Claude doing?」セッション品質アンケートを独自の [OpenTelemetry コレクター](/docs/ja/monitoring-usage)にルーティングします。アンケートの評価は、設定したコレクターへの OTEL イベントとしてのみ送出されます。このモードでは、アンケートデータは Anthropic に送信されません。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`DISABLE_TELEMETRY`、または `DO_NOT_TRACK` が設定されている場合に適用され、それ以外の場合は効果がありません。`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` と組織の製品フィードバックポリシーが優先されます |291| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | [セッションの要約](/docs/ja/interactive-mode#session-recap) の利用可否を上書きします。`0` に設定すると、`/config` のトグルに関係なく要約を強制的にオフにします。`1` に設定すると、[`awaySummaryEnabled`](/docs/ja/settings-reference#awaysummaryenabled) が `false` の場合でも要約を強制的にオンにします。設定と `/config` のトグルより優先されます |

292| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Claude がツール呼び出しの入力を生成するのに合わせて、API からストリーミングするかどうかを制御します。オフの場合、長いファイル書き込みなどの大きなツール入力は Claude が生成を終えた後にしか届かないため、ハングしているように見えることがあります。Anthropic API ではデフォルトで有効です。Amazon Bedrock と Google Cloud's Agent Platform では、デプロイされたコンテナがサポートしているモデルごとに有効になります。オプトアウトするには `0` に設定します。`ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL`、または `ANTHROPIC_BEDROCK_BASE_URL` を介してプロキシ経由でルーティングする場合に強制的にオンにするには、`1` に設定します。Microsoft Foundry と[ゲートウェイ](/docs/ja/llm-gateway)接続ではデフォルトでオフです |292| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | `1` に設定すると、[非対話モード](/docs/ja/headless) でバックグラウンドインストールが完了した後、ターンの区切りでプラグインの状態を更新します。この更新はセッションの途中でシステムプロンプトを変更し、そのターンの [プロンプトキャッシュ](/docs/ja/prompt-caching) を無効にするため、デフォルトではオフです |

293| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `ANTHROPIC_BASE_URL` が LiteLLM、Kong、社内プロキシなどの Anthropic 互換ゲートウェイを指している場合に、`1` に設定すると、ゲートウェイの `/v1/models` エンドポイントから `/model` ピッカーを生成します。共有 API キーを使用するゲートウェイでは、そのキーがアクセスできるすべてのモデルがすべてのユーザーに表示されてしまうため、デフォルトではオフです。検出されたモデルは、セッションが受け取る [`availableModels`](/docs/ja/settings-reference#availablemodels) 許可リストによって引き続きフィルタリングされます。[サーバー管理設定による配信はゲートウェイ構成では利用できない](/docs/ja/server-managed-settings#platform-availability)ため、リストは [MDM または管理設定ファイル](/docs/ja/managed-settings#delivery-mechanisms)で配信してください |293| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | `1` に設定すると、Anthropic 宛ての必須でないトラフィックがブロックされている場合に、「How is Claude doing?」セッション品質アンケートを独自の [OpenTelemetry コレクター](/docs/ja/monitoring-usage) に送ります。アンケートの評価は、設定されたコレクターへの OTEL イベントとしてのみ出力されます。このモードでは、アンケートデータは Anthropic に送信されません。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`DISABLE_TELEMETRY`、または `DO_NOT_TRACK` が設定されている場合に適用され、それ以外の場合は効果がありません。`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` と組織の製品フィードバックポリシーが優先されます |

294| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | v2.1.142 で削除されました。このバージョンで [fast mode](/docs/ja/fast-mode) のデフォルトが Opus 4.6 から Opus 4.7 に移行しました |294| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Claude が生成するのに合わせて、ツール呼び出しの入力を API からストリーミングするかどうかを制御します。これがオフの場合、長いファイル書き込みのような大きなツール入力は Claude が生成を終えた後にしか届かないため、ハングしているように見えることがあります。Anthropic API ではデフォルトで有効です。Amazon Bedrock と Google Cloud's Agent Platform では、デプロイされたコンテナがサポートしているモデルごとに有効になります。オプトアウトするには `0` に設定します。`ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL`、または `ANTHROPIC_BEDROCK_BASE_URL` を介してプロキシ経由でルーティングする場合に強制的にオンにするには `1` に設定します。Microsoft Foundry と [ゲートウェイ](/docs/ja/llm-gateway) 接続ではデフォルトでオフです |

295| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | `false` に設定すると、プロンプト入力に表示されるグレーの予測であるプロンプト候補をオフにします。[`promptSuggestionEnabled`](/docs/ja/settings-reference#promptsuggestionenabled) 設定（`/config` の **Prompt suggestions** トグルが書き込む設定）より優先されます。Claude Code は、[アカウントが使用制限に近づいているか達している間も候補を一時停止します](/docs/ja/interactive-mode#when-claude-code-skips-suggestions)。制限に達するまで候補をオンのままにするには、`true` に設定します。Claude Code v2.1.238 以降が必要です。[プロンプト候補](/docs/ja/interactive-mode#prompt-suggestions)を参照してください |295| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `1` に設定すると、`ANTHROPIC_BASE_URL` が LiteLLM、Kong、社内プロキシなどの Anthropic 互換ゲートウェイを指している場合に、ゲートウェイの `/v1/models` エンドポイントから `/model` ピッカーを埋めます。そうしないと、共有 API キーを使用するゲートウェイでは、そのキーでアクセスできるすべてのモデルがすべてのユーザーに表示されてしまうため、デフォルトではオフです。検出されたモデルは、セッションが受け取る [`availableModels`](/docs/ja/settings-reference#availablemodels) 許可リストによって引き続きフィルタリングされます。[ゲートウェイ構成ではサーバー管理による配信を利用できない](/docs/ja/server-managed-settings#platform-availability) ため、このリストは [MDM または管理設定ファイル](/docs/ja/managed-settings#delivery-mechanisms) を通じて配信してください |

296| `CLAUDE_CODE_ENABLE_TASKS` | [タスク追跡ツールを備えたセッション](/docs/ja/tools-reference#task-tool-availability)で Claude Code が提供するタスク追跡ツールを選択します。デフォルトでは、Claude Code は Task ツールである `TaskCreate`、`TaskUpdate`、`TaskGet`、`TaskList` を提供します。代わりに従来の `TodoWrite` ツールを使用するには、`0` に設定します。[タスクリスト](/docs/ja/interactive-mode#task-list)を参照してください |296| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | [fast mode](/docs/ja/fast-mode) のデフォルトが Opus 4.6 から Opus 4.7 に移行した v2.1.142 で削除されました |

297| `CLAUDE_CODE_ENABLE_TELEMETRY` | `1` に設定すると、メトリクスとログ記録のための OpenTelemetry データ収集を有効にします。OTel エクスポーターを設定する前に必要です。シェル、ユーザー設定、または管理設定で設定してください。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。[モニタリング](/docs/ja/monitoring-usage)を参照してください |297| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | `false` に設定すると、プロンプト入力に表示されるグレー表示の予測であるプロンプト候補をオフにします。`/config` の **Prompt suggestions** トグルが書き込む [`promptSuggestionEnabled`](/docs/ja/settings-reference#promptsuggestionenabled) 設定より優先されます。Claude Code は、[アカウントが使用制限に近いか達している間は候補を一時停止](/docs/ja/interactive-mode#when-claude-code-skips-suggestions) します。`true` に設定すると、制限に達するまで候補をオンのままにします。Claude Code v2.1.238 以降が必要です。[プロンプト候補](/docs/ja/interactive-mode#prompt-suggestions) を参照してください |

298| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | `1` に設定すると、すべてのモデルでタスク追跡ツールを利用できるようにします。設定しない場合、Claude Code はデフォルトで [Task ツールの利用可能性](/docs/ja/tools-reference#task-tool-availability)に記載されたモデルでのみこれらのツールを提供します。Task ツールと `TodoWrite` のどちらを使うかは、引き続き `CLAUDE_CODE_ENABLE_TASKS` で選択します。Claude Code v2.1.233 以降が必要です |298| `CLAUDE_CODE_ENABLE_TASKS` | [タスク追跡ツールを持つセッション](/docs/ja/tools-reference#task-tool-availability) で、Claude Code がどのタスク追跡ツールを提供するかを選択します。デフォルトでは、Claude Code は Task ツールの `TaskCreate`、`TaskUpdate`、`TaskGet`、`TaskList` を提供します。`0` に設定すると、代わりに従来の `TodoWrite` ツールが使われます。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照してください |

299| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | クエリループがアイドル状態になってから自動的に終了するまでの待機時間（ミリ秒）。SDK モードを使用する自動化ワークフローやスクリプトで便利です |299| `CLAUDE_CODE_ENABLE_TELEMETRY` | `1` に設定すると、メトリクスとログの OpenTelemetry データ収集を有効にします。OTel エクスポーターを設定する前に必要です。シェル、ユーザー設定、または管理設定で設定してください。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[モニタリング](/docs/ja/monitoring-usage) を参照してください |

300| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | `1` に設定すると、[エージェントチーム](/docs/ja/agent-teams)を有効にします。エージェントチームは実験的な機能で、デフォルトでは無効です |300| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | `1` に設定すると、すべてのモデルでタスク追跡ツールが使えるようになります。これがない場合、Claude Code は [Task ツールの利用可否](/docs/ja/tools-reference#task-tool-availability) に記載されたモデルでのみデフォルトでこれらを提供します。`CLAUDE_CODE_ENABLE_TASKS` は引き続き Task ツールか `TodoWrite` かを選択します。Claude Code v2.1.233 以降が必要です |

301| `CLAUDE_CODE_EXTRA_BODY` | すべての API リクエストボディのトップレベルにマージする JSON オブジェクト。Claude Code が直接公開していないプロバイダー固有のパラメーターを渡すのに便利です。シェルでエクスポートした値は、`claude agents` または `--bg` でディスパッチする[バックグラウンドセッション](/docs/ja/agent-view)にも適用されます。v2.1.206 より前は、バックグラウンドセッションはシェルでエクスポートされた値を無視し、バックグラウンドのスーパーバイザープロセスが継承したコピーを使用していました |301| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | クエリループがアイドル状態になってから自動的に終了するまでの待機時間（ミリ秒）。SDK モードを使用する自動化ワークフローやスクリプトに便利です |

303| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | `1` に設定すると、この `claude` が別の Claude Code セッション内から起動された場合でも、トランスクリプトの永続化、プロンプト履歴、`claude agents` への登録を強制します。たとえば `screen` セッションや、Claude Code の Bash ツールから最初に起動されたバックグラウンドランチャーから継承された `CLAUDE_CODE_CHILD_SESSION` の値により、本来のトップレベルセッションがネストされたセッションと誤分類される場合に使用します。v2.1.178 以降、Claude Code は tmux のケースを自動的に検出して継承されたマーカーを無視するため、tmux ではこの変数は不要になりました。v2.1.169 以前でも有効です。この変数が上書きするネストセッション検出が削除されていた v2.1.170 と v2.1.171 では効果がありません |303| `CLAUDE_CODE_EXTRA_BODY` | すべての API リクエストボディの最上位にマージする JSON オブジェクト。Claude Code が直接公開していないプロバイダー固有のパラメーターを渡すのに便利です。シェルでエクスポートした値は、`claude agents` または `--bg` でディスパッチする [バックグラウンドセッション](/docs/ja/agent-view) にも適用されます。v2.1.206 より前は、バックグラウンドセッションはシェルでエクスポートされた値を無視し、バックグラウンドのスーパーバイザープロセスが継承していた値を使用していました |

304| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | `1` に設定すると、ターミナルが取り消し線をサポートしているのに自動検出されない場合（`TERM_PROGRAM` が転送されていない SSH 経由など）に、Claude の応答内の `~~text~~` を強制的に取り消し線としてレンダリングします。これを設定しないと、検出されないターミナルではテキストが取り消し線としてレンダリングされず、`~~` マーカーがそのまま表示されます。Claude Code v2.1.186 以降が必要です |304| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | ファイル読み取りのデフォルトのトークン制限を上書きします。大きなファイルを全体的に読み取る必要がある場合に便利です |

305| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | `1` に設定すると、ターミナルがサポートしているのに自動検出されない場合に、DEC プライベートモード 2026 の[同期出力](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)を強制的に有効にします。BSU/ESU を実装しているものの機能プローブに応答しない Emacs `eat` などのエミュレーターで便利です。tmux 下では効果がありません。[フルスクリーンレンダリング](/docs/ja/fullscreen)に切り替える `CLAUDE_CODE_NO_FLICKER` とは異なり、レンダラーは変更しません |305| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | `1` に設定すると、この `claude` が別の Claude Code セッション内から起動された場合でも、トランスクリプトの永続化、プロンプト履歴、`claude agents` への登録を強制します。たとえば `screen` セッションや Claude Code の Bash ツールが最初に起動したバックグラウンドランチャーから継承された `CLAUDE_CODE_CHILD_SESSION` の値によって、本来の最上位セッションがネストされたセッションと誤分類される場合に使用します。v2.1.178 以降、Claude Code は tmux のケースを自動的に検出して継承されたマーカーを無視するため、tmux ではこの変数は不要になりました。v2.1.169 以前でも有効です。この変数が上書きするネストされたセッションの検出が削除されていた v2.1.170 と v2.1.171 では効果がありません |

306| `CLAUDE_CODE_FORK_SUBAGENT` | [フォークモード](/docs/ja/sub-agents#turn-fork-mode-on-or-off)を制御します。フォークモードでは Claude が自ら[フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation)を生成でき、デフォルトでは対話セッションでのみオンです。`claude -p` と Agent SDK でもオンにするには `1` に、すべての種類のセッションでオフにするには `0` に設定します。`/subtask` はフォークモードのオン・オフにかかわらず実行できます。対話セッションでのデフォルトには Claude Code v2.1.232 以降が必要です。それより前のバージョンでフォークモードをオンにするには、変数を `1` に設定してください |306| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | `1` に設定すると、ターミナルが取り消し線をサポートしているのに自動検出されない場合（`TERM_PROGRAM` が転送されない SSH 経由など）に、Claude の応答内の `~~text~~` を強制的に取り消し線で表示します。これがない場合、検出されないターミナルではテキストが取り消し線で表示されず、`~~` マーカーがそのまま表示されます。Claude Code v2.1.186 以降が必要です |

307| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | `1` に設定すると、`claude -p --output-format stream-json` の出力で[サブエージェント](/docs/ja/sub-agents)のテキストブロックと思考ブロックを出力します。[`--forward-subagent-text`](/docs/ja/cli-reference#cli-flags) フラグと同じ動作です。ハーネスが `claude` を呼び出し、フラグを自分で渡せない場合にこの変数を使用します。stream-json 出力の非対話モード以外ではエラーで終了するフラグとは異なり、変数はそうした場面では無視されるため、プロセス全体で設定しても入れ子の呼び出しは引き続き動作します。Claude Code v2.1.211 以降が必要です |307| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | `1` に設定すると、ターミナルがサポートしているのに自動検出されない場合に、DEC プライベートモード 2026 の [同期出力](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) を強制的に有効にします。BSU/ESU を実装しているが機能プローブに応答しない Emacs `eat` などのエミュレーターに便利です。tmux 下では効果がありません。[フルスクリーンレンダリング](/docs/ja/fullscreen) に切り替える `CLAUDE_CODE_NO_FLICKER` とは異なり、レンダラーは変更しません |

308| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | `1` に設定すると、カスタムプロキシや、Amazon Bedrock、Claude Platform on AWS などのサードパーティプロバイダーで、`x-claude-code-request-class` や `x-claude-code-compaction` などの[ゲートウェイヒントヘッダー](/docs/ja/llm-gateway-protocol#gateway-hint-headers)を送信します。`0` に設定すると、Claude Code がデフォルトでこれらを送信する Anthropic API への直接接続を含め、すべての接続で送信を停止します。Claude Code v2.1.273 以降が必要です |308| `CLAUDE_CODE_FORK_SUBAGENT` | [フォークモード](/docs/ja/sub-agents#turn-fork-mode-on-or-off) を制御します。フォークモードは Claude 自身が [フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation) を生成できるようにするもので、対話セッションでのみデフォルトでオンです。`1` に設定すると `claude -p` と Agent SDK でもオンになり、`0` に設定するとあらゆる種類のセッションでオフになります。`/subtask` はフォークモードがオンかどうかに関係なく実行できます。対話セッションでのデフォルトには Claude Code v2.1.232 以降が必要です。それより前のバージョンでは、フォークモードをオンにするには変数を `1` に設定してください |

309| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` で有効になる[ゲートウェイモデル検出](/docs/ja/llm-gateway-protocol#model-discovery)リクエストのタイムアウト（ミリ秒、デフォルト: `3000`）。ゲートウェイが起動時に `/v1/models` に応答するのに 3 秒より長くかかる場合は、値を引き上げてください。数字のみを受け付けます。`0`、負の値、その他の表記ではデフォルトが維持されます。Claude Code v2.1.269 以降が必要です |309| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | `1` に設定すると、`claude -p --output-format stream-json` の出力に [サブエージェント](/docs/ja/sub-agents) のテキストブロックと思考ブロックを出力します。[`--forward-subagent-text`](/docs/ja/cli-reference#cli-flags) フラグと同じ動作です。ハーネスが `claude` を呼び出し、フラグ自体を渡せない場合にこの変数を使用します。stream-json 出力の非対話モード以外ではエラーで終了するフラグとは異なり、変数はその場合無視されるため、プロセス全体に設定してもネストされた呼び出しは動作し続けます。Claude Code v2.1.211 以降が必要です |

310| `CLAUDE_CODE_GIT_BASH_PATH` | Windows のみ: Git Bash 実行ファイル（`bash.exe`）へのパス。Git Bash がインストールされているものの PATH に含まれていない場合に使用します。パスが存在しない場合、またはファイル名が `bash.exe`、`sh.exe`、`bash`、`sh` のいずれでもない場合、Claude Code はこの変数を無視し、未設定の場合と同様に Git Bash を自動検出して、`--debug` で確認できる警告をログに記録します。v2.1.219 より前は、パスが存在しない場合に Claude Code は起動時に終了し、既存のファイルであれば bash や sh かどうかを確認せずにシェルとして使用していました。[Windows でのセットアップ](/docs/ja/setup#set-up-on-windows)を参照してください |310| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | `1` に設定すると、カスタムプロキシや Amazon Bedrock、Claude Platform on AWS などのサードパーティプロバイダーで、`x-claude-code-request-class` や `x-claude-code-compaction` などの [ゲートウェイヒントヘッダー](/docs/ja/llm-gateway-protocol#gateway-hint-headers) を送信します。`0` に設定すると、Claude Code がデフォルトで送信する Anthropic API への直接接続を含め、すべての接続でこれらの送信を停止します。Claude Code v2.1.273 以降が必要です |

311| `CLAUDE_CODE_GLOB_HIDDEN` | `false` に設定すると、Claude が [Glob ツール](/docs/ja/tools-reference#glob-tool-behavior)を呼び出したときの結果からドットファイルを除外します。デフォルトでは含まれます。`@` ファイルオートコンプリート、`ls`、Grep、Read には影響しません |311| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` がオンにする [ゲートウェイのモデル検出](/docs/ja/llm-gateway-protocol#model-discovery) リクエストのタイムアウト（ミリ秒、デフォルト: `3000`）。ゲートウェイが起動時に `/v1/models` に応答するのに 3 秒より長くかかる場合は、この値を引き上げてください。数字のみを受け付けます。`0`、負の値、その他の表記ではデフォルトが維持されます。Claude Code v2.1.269 以降が必要です |

312| `CLAUDE_CODE_GLOB_NO_IGNORE` | `false` に設定すると、[Glob ツール](/docs/ja/tools-reference#glob-tool-behavior)が `.gitignore` パターンに従うようになります。デフォルトでは、Glob は gitignore されたファイルを含め、一致するすべてのファイルを返します。独自の [`respectGitignore` 設定](/docs/ja/settings-reference#respectgitignore)を持つ `@` ファイルオートコンプリートには影響しません |312| `CLAUDE_CODE_GIT_BASH_PATH` | Windows のみ: Git Bash 実行ファイル（`bash.exe`）へのパス。Git Bash はインストールされているが PATH に含まれていない場合に使用します。パスが存在しない場合や、ファイル名が `bash.exe`、`sh.exe`、`bash`、`sh` のいずれでもない場合、Claude Code はこの変数を無視し、未設定の場合と同様に Git Bash を自動検出して、`--debug` で確認できる警告をログに記録します。v2.1.219 より前は、パスが存在しない場合に Claude Code は起動時に終了し、存在するファイルであれば bash や sh であるかを確認せずにシェルとして使用していました。[Windows でのセットアップ](/docs/ja/setup#set-up-on-windows) を参照してください |

313| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Glob ツールによるファイル検出のタイムアウト（秒）。ほとんどのプラットフォームではデフォルトが 20 秒、WSL では 60 秒です |313| `CLAUDE_CODE_GLOB_HIDDEN` | `false` に設定すると、Claude が [Glob ツール](/docs/ja/tools-reference#glob-tool-behavior) を呼び出したときの結果からドットファイルを除外します。デフォルトでは含まれます。`@` ファイルのオートコンプリート、`ls`、Grep、Read には影響しません |

314| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | バックグラウンド作業がアクティブなゴールを何分間待たせたら、Claude Code が [Claude に確認を求める](/docs/ja/goal#background-work-defers-evaluation)かを指定します。デフォルトは `30` です。チェックインをオフにするには `0` に設定します。分単位の整数を数字のみで、最大 `10080`（1 週間）まで指定します。Claude Code はそれ以外の値を未設定として扱い、デフォルトを使用します。Claude Code v2.1.234 以降が必要です |314| `CLAUDE_CODE_GLOB_NO_IGNORE` | `false` に設定すると、[Glob ツール](/docs/ja/tools-reference#glob-tool-behavior) が `.gitignore` のパターンを尊重するようになります。デフォルトでは、Glob は gitignore されたファイルを含むすべての一致するファイルを返します。独自の [`respectGitignore` 設定](/docs/ja/settings-reference#respectgitignore) を持つ `@` ファイルのオートコンプリートには影響しません |

316| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | バックグラウンド作業がアクティブなゴールを待たせてから、Claude Code が [Claude にその確認を求める](/docs/ja/goal#background-work-defers-evaluation) までの分数。デフォルトは `30` です。`0` に設定するとチェックインをオフにします。整数の分数を数字のみで、最大 `10080`（1 週間）まで指定してください。Claude Code はそれ以外の値を未設定として扱い、デフォルトを使用します。Claude Code v2.1.234 以降が必要です |

317| `CLAUDE_CODE_HIDE_CWD` | `1` に設定すると、起動時のロゴで作業ディレクトリを非表示にします。パスに OS のユーザー名が含まれてしまう画面共有や録画の際に便利です |

316| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | IDE 拡張機能への接続に使用するホストアドレスを上書きします。デフォルトでは、Claude Code は WSL から Windows へのルーティングを含め、正しいアドレスを自動検出します |318| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | IDE 拡張機能への接続に使用するホストアドレスを上書きします。デフォルトでは、Claude Code は WSL から Windows へのルーティングを含め、正しいアドレスを自動検出します |

317| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | `1` に設定すると、IDE 拡張機能の自動インストールをスキップします。[`autoInstallIdeExtension`](/docs/ja/settings-reference#autoinstallideextension) を `false` に設定するのと同等です |319| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | `1` に設定すると、IDE 拡張機能の自動インストールをスキップします。[`autoInstallIdeExtension`](/docs/ja/settings-reference#autoinstallideextension) を `false` に設定するのと同等です |

319| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | 1 つのセッションで同時に実行できる[サブエージェント](/docs/ja/sub-agents#concurrent-subagent-limit)の数。これを超えると、Agent ツールは新たな生成を拒否します（デフォルト: 20）。数字のみの正の整数を受け付け、それ以外は無視されるため、この変数で上限を調整することはできますが、無効にすることはできません。Claude Code v2.1.217 以降が必要です |321| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Agent ツールが新たな生成を拒否するまでに、1 つのセッションで同時に実行できる [サブエージェント](/docs/ja/sub-agents#concurrent-subagent-limit) の数（デフォルト: 20）。正の整数を数字のみで指定します。それ以外は無視されるため、この変数で上限を調整することはできますが、無効にすることはできません。Claude Code v2.1.217 以降が必要です |

320| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code がアクティブなモデルに対して想定するコンテキストウィンドウのサイズを上書きします。v2.1.193 以降、適用方法は Claude Code がモデル ID をどのように解決するかによって異なります。[ゲートウェイまたはカスタムモデル ID のウィンドウを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id)を参照してください。`ANTHROPIC_BASE_URL` を通じてルーティングするモデルのコンテキストウィンドウが、その名前に対する組み込みのサイズと一致しない場合に使用します |322| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code がアクティブなモデルについて想定するコンテキストウィンドウのサイズを上書きします。v2.1.193 以降、どのように適用されるかは Claude Code がモデル ID をどう解決するかによって異なります。[ゲートウェイまたはカスタムモデル ID のウィンドウを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください。`ANTHROPIC_BASE_URL` を通じてルーティングするモデルのコンテキストウィンドウが、その名前に対する組み込みのサイズと一致しない場合に使用します |

321| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Claude Code がモデルに送信する、各 MCP ツールの説明と各 MCP サーバーの指示の最大長（文字数、デフォルト: 2048）。Claude Code は[これより長いテキストを切り詰めます](/docs/ja/mcp#for-mcp-server-authors)。数字のみの正の整数を受け付けます。それ以外は無視され、デフォルトが適用されます。Claude Code v2.1.280 以降が必要です |323| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Claude Code がモデルに送信する各 MCP ツールの説明と各 MCP サーバーの指示の最大長（文字数、デフォルト: 2048）。Claude Code は [それより長いテキストを切り詰めます](/docs/ja/mcp#for-mcp-server-authors)。正の整数を数字のみで指定します。それ以外は無視され、デフォルトが適用されます。Claude Code v2.1.280 以降が必要です |

322| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ほとんどのリクエストの最大出力トークン数を設定します。デフォルトと上限はモデルによって異なります。[最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)を参照してください。モデルの上限を超える値は、Claude Code によって上限まで引き下げられます。Claude Code が既知のモデルに解決できないモデル ID の場合、デフォルトは 32000、上限は 128000 です。この値を増やすと、[自動圧縮](/docs/ja/costs#reduce-token-usage)がトリガーされるまでに利用できる実効コンテキストウィンドウが小さくなります |324| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ほとんどのリクエストの最大出力トークン数を設定します。デフォルトと上限はモデルによって異なります。[最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) を参照してください。モデルの上限を超える値は、Claude Code によって上限まで引き下げられます。Claude Code が既知のモデルに解決できないモデル ID の場合、デフォルトは 32000、上限は 128000 です。この値を増やすと、[自動圧縮](/docs/ja/costs#reduce-token-usage) がトリガーされる前に利用できる実質的なコンテキストウィンドウが小さくなります |

323| `CLAUDE_CODE_MAX_RETRIES` | 失敗した API リクエストを再試行する回数を上書きします（デフォルト: 10）。v2.1.186 以降は上限が 15 です。v2.1.199 以降は、`CLAUDE_CODE_RETRY_WATCHDOG` によってデフォルトが引き上げられ、上限が撤廃されます。より長い障害の間も待機する必要がある無人セッションでは、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を設定してください |325| `CLAUDE_CODE_MAX_RETRIES` | 失敗した API リクエストの再試行回数を上書きします（デフォルト: 10）。v2.1.186 以降は 15 が上限です。v2.1.199 以降は、`CLAUDE_CODE_RETRY_WATCHDOG` によってデフォルトが引き上げられ、上限が撤廃されます。より長い障害を待ち続ける必要がある無人セッションでは、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を設定してください |

324| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | v2.1.224 で削除され、現在は何の効果もありません。以前は、1 つのセッションで Claude が Agent ツールを使って生成できる[サブエージェント](/docs/ja/sub-agents)の総数を制限していました（デフォルト: 200）。上限を超えて生成しようとすると `Subagent spawn limit reached` で失敗していました。[同時サブエージェント数の制限](/docs/ja/sub-agents#concurrent-subagent-limit)と[深さの制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents)は引き続き適用されます |326| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | v2.1.224 で削除され、現在は何の効果もありません。以前は、1 つのセッションで Claude が Agent ツールで生成できる [サブエージェント](/docs/ja/sub-agents) の総数を制限していました（デフォルト: 200）。上限を超えて生成しようとすると `Subagent spawn limit reached` で失敗していました。[同時実行サブエージェントの制限](/docs/ja/sub-agents#concurrent-subagent-limit) と [深さの制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) は引き続き適用されます |

325| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | メイン会話の下に許可される[サブエージェントの階層数](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents)（デフォルト: 3）。デフォルトでは、サブエージェントは独自のサブエージェントを生成でき、3 階層目のサブエージェントはそれ以上生成できません。ネストをオフにするには `1` に設定します。v2.1.217 から v2.1.218 ではデフォルトが 1 だったため、制限を引き上げない限り、サブエージェントは独自のサブエージェントを生成できませんでした。v2.1.219 でデフォルトが 3 に引き上げられました。数字のみの正の整数を受け付け、それ以外は無視されるため、制限は調整できますが撤廃はできません。Claude Code v2.1.217 以降が必要です |327| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | メインの会話の下に許可される [サブエージェントの階層](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) の数（デフォルト: 3）。デフォルトでは、サブエージェントは独自のサブエージェントを生成でき、3 番目の階層のサブエージェントはそれ以上生成できません。ネストをオフにするには `1` に設定します。v2.1.217 から v2.1.218 ではデフォルトが 1 だったため、制限を引き上げない限りサブエージェントは独自のサブエージェントを生成できませんでした。v2.1.219 でデフォルトが 3 に引き上げられました。正の整数を数字のみで指定します。それ以外は無視されるため、制限を調整することはできますが、撤廃することはできません。Claude Code v2.1.217 以降が必要です |

327| `CLAUDE_CODE_MAX_TURNS` | 明示的な制限が渡されていない場合の、エージェントのターン数の上限。[`--max-turns`](/docs/ja/cli-reference#cli-flags) を渡すのと同等で、両方が設定されている場合は `--max-turns` が優先されます。正の整数でない値は、上限なしとして扱われるのではなく、起動時にエラーで拒否されます |329| `CLAUDE_CODE_MAX_TURNS` | 明示的な制限が渡されない場合に、エージェントのターン数に上限を設けます。[`--max-turns`](/docs/ja/cli-reference#cli-flags) を渡すのと同等で、両方が設定されている場合はフラグが優先されます。正の整数でない値は、上限なしとして扱われるのではなく、起動時にエラーで拒否されます |

328| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | 1 つのセッションで実行できる [WebSearch](/docs/ja/tools-reference#websearch-tool-behavior) 呼び出しの総数の上限（デフォルト: 200）。Claude が上限に達すると、それ以降の WebSearch 呼び出しは、すでに収集した情報で続行するよう指示する通知を返します。上限値のない任意の正の整数を受け付けます。それ以外は無視されてデフォルトが適用されるため、上限は引き上げられますが、オフにすることはできません。Claude Code v2.1.212 以降が必要です |330| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | 1 つのセッションで実行できる [WebSearch](/docs/ja/tools-reference#websearch-tool-behavior) 呼び出しの総数の上限（デフォルト: 200）。Claude が上限に達すると、それ以降の WebSearch 呼び出しは、すでに収集した情報で作業を続けるよう伝える通知を返します。上限のない正の整数を受け付けます。それ以外は無視されてデフォルトが適用されるため、上限を引き上げることはできますが、オフにすることはできません。Claude Code v2.1.212 以降が必要です |

330| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | 実行中の MCP ツール呼び出しが[バックグラウンドタスクに移行する](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls)までの経過時間（ミリ秒、デフォルト: 120000、つまり 2 分）。自動バックグラウンド化をオフにするには `0` に設定します。Claude Code v2.1.212 以降が必要です |332| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | 実行中の MCP ツール呼び出しが [バックグラウンドタスクに移行する](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) までの経過時間（ミリ秒、デフォルト: 120000、つまり 2 分）。`0` に設定すると、自動バックグラウンド化をオフにします。Claude Code v2.1.212 以降が必要です |

331| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | [非対話](/docs/ja/headless)セッションの最初のターンが、まだ接続中の MCP サーバーを待機する時間（ミリ秒）。デフォルトの[最初のターンの待機](/docs/ja/agent-sdk/mcp#connection-timing)の代わりに使用されます。設定すると、保留中のすべてのサーバーが待機の対象になります。待機をスキップするには `0` に設定します。[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) サーバーは、値にかかわらず独自の `MCP_TIMEOUT` による待機を維持します。Claude Code v2.1.274 以降が必要です |333| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | [非対話](/docs/ja/headless) セッションの最初のターンが、まだ接続中の MCP サーバーを待つ時間（ミリ秒）。デフォルトの [最初のターンの待機](/docs/ja/agent-sdk/mcp#connection-timing) の代わりに使われます。設定すると、待機はすべての保留中のサーバーを対象にします。待機をスキップするには `0` に設定します。[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) サーバーは、値に関係なく独自の `MCP_TIMEOUT` の待機を維持します。Claude Code v2.1.274 以降が必要です |

332| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | MCP ツール呼び出しのアイドルタイムアウト（ミリ秒）。stdio、HTTP、SSE、WebSocket、または [claude.ai コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)の MCP サーバーがこの時間、応答も進捗通知も送信しない場合、ツール呼び出しは全体の `MCP_TOOL_TIMEOUT` を待たずにエラーで中止されます。ネットワークサーバーの 300000（5 分）、stdio サーバーの 1800000（30 分）というトランスポートごとのデフォルトを上書きします。アイドルチェックを無効にするには `0` に設定します。1000 未満の値は 1 秒に引き上げられ、値の上限は実効の `MCP_TOOL_TIMEOUT` です。`.mcp.json` のサーバーごとの `timeout` が 1000 以上の場合、そのサーバーのアイドル時間枠は少なくとも `timeout` の値まで引き上げられます。IDE サーバーや SDK のインプロセスサーバーには適用されません。Claude Code v2.1.187 以降が必要です。v2.1.203 より前は、stdio サーバーはアイドルタイムアウトの対象外でした |334| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | MCP ツール呼び出しのアイドルタイムアウト（ミリ秒）。stdio、HTTP、SSE、WebSocket、または [claude.ai コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai) の MCP サーバーがこの時間、応答も進捗通知も送信しない場合、ツール呼び出しは全体の `MCP_TOOL_TIMEOUT` を待たずにエラーで中止されます。ネットワークサーバーでは 300000（5 分）、stdio サーバーでは 1800000（30 分）というトランスポートごとのデフォルトを上書きします。アイドルチェックを無効にするには `0` に設定します。1000 未満の値は 1 秒に引き上げられ、値は実効的な `MCP_TOOL_TIMEOUT` を上限とします。`.mcp.json` でサーバーごとに 1000 以上の `timeout` を指定すると、そのサーバーのアイドル時間は少なくとも `timeout` の値まで引き上げられます。IDE サーバーや SDK のインプロセスサーバーには適用されません。Claude Code v2.1.187 以降が必要です。v2.1.203 より前は、stdio サーバーはアイドルタイムアウトの対象外でした |

333| `CLAUDE_CODE_MESSAGING_SOCKET` | ユーザーではなく Claude Code によって設定されます: [受信ボックスソケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket)をバインドするセッションでは、Claude Code はソケットをバインドするときに、そのソケットのパスをフックと Bash コマンドにエクスポートします。メッセージングがオンの状態で開始するセッションでは、Claude Code はフックが実行される前にソケットをバインドします。マシン上の他のセッションは、このパスにメッセージを配信します。各セッションは親から継承したものではなく独自のソケットをエクスポートし、そこに届くメッセージはセッションの[受信制御](/docs/ja/cross-session-messaging#control-inbound-messages)を通過します。設定の `env` ブロックでは設定できません。Claude Code v2.1.224 以降が必要です |335| `CLAUDE_CODE_MESSAGING_SOCKET` | ユーザーではなく Claude Code が設定します: [受信ソケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) をバインドするセッションでは、Claude Code はソケットをバインドする際に、そのソケットのパスをフックと Bash コマンドにエクスポートします。メッセージングがオンの状態で開始したセッションでは、Claude Code はフックが実行される前にソケットをバインドします。マシン上の他のセッションは、このパスにメッセージを配信します。各セッションは親から継承したものではなく独自のソケットをエクスポートし、そこに届いたメッセージはセッションの [受信制御](/docs/ja/cross-session-messaging#control-inbound-messages) を経由します。設定の `env` ブロックではこれを設定できません。Claude Code v2.1.224 以降が必要です |

334| `CLAUDE_CODE_MESSAGING_TOKEN` | ユーザーではなく Claude Code によって設定されます: [受信ボックスソケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket)をバインドするセッションでは、Claude Code はこのセッションごとのトークンを `CLAUDE_CODE_MESSAGING_SOCKET` とともにフックと Bash コマンドにエクスポートします。ソケットに投稿するスクリプトは、最初の行として `{"type":"auth","token":"<token>"}` を送信することで、そのセッションに属していることを証明できます。ネイティブ Windows では、Claude Code はこの行を必須とし、有効な行で始まらない接続を閉じます。Claude Code がトークンを参照するタイミングについては、[自身の子プロセスに関するルール](/docs/ja/cross-session-messaging#the-sessions-inbox-socket)で説明しています。各セッションは独自のトークンをエクスポートし、親セッションから継承したトークンをエクスポートすることはありません。設定の `env` ブロックでは設定できません。Claude Code v2.1.228 以降が必要です |336| `CLAUDE_CODE_MESSAGING_TOKEN` | ユーザーではなく Claude Code が設定します: [受信ソケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) をバインドするセッションでは、Claude Code は `CLAUDE_CODE_MESSAGING_SOCKET` と一緒に、このセッションごとのトークンをフックと Bash コマンドにエクスポートします。ソケットに送信するスクリプトは、最初の行として `{"type":"auth","token":"<token>"}` を送信することで、そのセッションに属していることを証明できます。ネイティブ Windows では、Claude Code はこの行を必須とし、有効な行で始まらない接続を閉じます。Claude Code がいつトークンを参照するかは [自身の子プロセスに関するルール](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) で説明しています。各セッションは独自のトークンをエクスポートし、親セッションから継承したトークンをエクスポートすることはありません。設定の `env` ブロックではこれを設定できません。Claude Code v2.1.228 以降が必要です |

336| `CLAUDE_CODE_NEW_INIT` | `1` に設定すると、`/init` で対話的なセットアップフローを実行します。このフローでは、コードベースを調査してファイルを書き込む前に、CLAUDE.md、スキル、フックなど、どのファイルを生成するかを尋ねます。この変数がない場合、`/init` は確認なしで CLAUDE.md を自動生成します |338| `CLAUDE_CODE_NEW_INIT` | `1` に設定すると、`/init` で対話的なセットアップフローを実行します。このフローでは、コードベースを調査してファイルを書き込む前に、CLAUDE.md、スキル、フックなど、どのファイルを生成するかを尋ねます。この変数がない場合、`/init` は確認なしで CLAUDE.md を自動生成します |

337| `CLAUDE_CODE_NONBLOCKING_STDOUT` | `1` に設定すると、ターミナル出力を 2 つ目のノンブロッキングファイルディスクリプター経由で書き込みます。これにより、一時停止した tmux コントロールモードのペインや停止した SSH 接続など、読み取りを停止したターミナルによって Claude Code がセッション途中でフリーズすることを防ぎます。stdout がターミナルの場合に、macOS、Linux、WSL で適用されます。Claude Code v2.1.261 以降が必要です |339| `CLAUDE_CODE_NONBLOCKING_STDOUT` | `1` に設定すると、2 つ目のノンブロッキングファイルディスクリプターを通じてターミナル出力を書き込むため、一時停止した tmux コントロールモードのペインや停止した SSH 接続など、読み取りを止めたターミナルによって Claude Code がセッションの途中でフリーズすることがなくなります。stdout がターミナルである場合に、macOS、Linux、WSL で適用されます。Claude Code v2.1.261 以降が必要です |

338| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | タイムアウトした[非ストリーミングリクエスト](/docs/ja/errors#streaming-response-ended-before-any-complete-data-was-received)を Claude Code が再送信する回数を制限します。`0` にすると、最初のタイムアウトでリクエストは失敗します。デフォルトでは未設定のため、これらの再送信は `CLAUDE_CODE_MAX_RETRIES` によって制限されます。タイムアウトについては、[再試行の動作を調整する](/docs/ja/errors#tune-retry-behavior)を参照してください。Claude Code v2.1.285 以降が必要です |340| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | タイムアウトした [非ストリーミングリクエスト](/docs/ja/errors#streaming-response-ended-before-any-complete-data-was-received) を Claude Code が再送信する回数を制限します。`0` の場合、リクエストは最初のタイムアウトで失敗します。デフォルトでは未設定のため、これらの再送信は `CLAUDE_CODE_MAX_RETRIES` によって制限されます。タイムアウトについては [再試行動作を調整する](/docs/ja/errors#tune-retry-behavior) を参照してください。Claude Code v2.1.285 以降が必要です |

339| `CLAUDE_CODE_NO_FLICKER` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen)を有効にします。これは、ちらつきを減らし、長い会話でもメモリ使用量を一定に保つリサーチプレビューです。[`tui`](/docs/ja/settings-reference#tui) 設定を上書きします。`/tui fullscreen` で切り替えることもできます |341| `CLAUDE_CODE_NO_FLICKER` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen) を有効にします。これはちらつきを減らし、長い会話でもメモリ使用量を一定に保つリサーチプレビューです。[`tui`](/docs/ja/settings-reference#tui) 設定を上書きします。`/tui fullscreen` で切り替えることもできます |

340| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 認証用の OAuth リフレッシュトークン。設定すると、`claude auth login` はブラウザを開く代わりに、このトークンを直接交換します。`CLAUDE_CODE_OAUTH_SCOPES` が必要です。自動化環境で認証をプロビジョニングするのに便利です |342| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 認証用の OAuth リフレッシュトークン。設定すると、`claude auth login` はブラウザーを開く代わりにこのトークンを直接交換します。`CLAUDE_CODE_OAUTH_SCOPES` が必要です。自動化された環境で認証をプロビジョニングするのに便利です |

341| `CLAUDE_CODE_OAUTH_SCOPES` | リフレッシュトークンの発行時に指定された、スペース区切りの OAuth スコープ（`"user:profile user:inference user:sessions:claude_code"` など）。`CLAUDE_CODE_OAUTH_REFRESH_TOKEN` を設定する場合は必須です |343| `CLAUDE_CODE_OAUTH_SCOPES` | リフレッシュトークンの発行時に付与された OAuth スコープをスペース区切りで指定します（例: `"user:profile user:inference user:sessions:claude_code"`）。`CLAUDE_CODE_OAUTH_REFRESH_TOKEN` が設定されている場合は必須です |

342| `CLAUDE_CODE_OAUTH_TOKEN` | claude.ai 認証用の OAuth アクセストークン。SDK や自動化環境で `/login` の代わりに使用します。キーチェーンに保存された認証情報より優先されます。[`claude setup-token`](/docs/ja/authentication#generate-a-long-lived-token) で生成します。[`/login`](/docs/ja/authentication#authentication-precedence) を実行しない限り、Claude Code はセッション全体で設定したトークンを使用します。期限切れのトークンを置き換えるには、新しいトークンを生成して再起動してください |344| `CLAUDE_CODE_OAUTH_TOKEN` | claude.ai 認証用の OAuth アクセストークン。SDK や自動化された環境で `/login` の代わりに使用します。キーチェーンに保存された認証情報より優先されます。[`claude setup-token`](/docs/ja/authentication#generate-a-long-lived-token) で生成します。[`/login`](/docs/ja/authentication#authentication-precedence) を実行しない限り、Claude Code はセッション全体を通じて設定したトークンを使用します。期限切れのトークンを置き換えるには、新しいトークンを生成して再起動してください |

343| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | v2.1.160 で削除され、現在は何の効果もありません。以前は、[fast mode](/docs/ja/fast-mode) を現在のデフォルトではなく Claude Opus 4.6 に固定していました。Opus 4.6 は fast mode をサポートしなくなりました |345| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | v2.1.160 で削除され、現在は何の効果もありません。以前は、現在のデフォルトの代わりに [fast mode](/docs/ja/fast-mode) を Claude Opus 4.6 に固定していました。Opus 4.6 は fast mode をサポートしなくなりました |

344| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツを含む OpenTelemetry 属性（モデルの応答、ツールのコンテンツ、システムプロンプト、生の API ボディ）の最大長。切り詰めマーカーを含み、UTF-16 コード単位で指定します（デフォルト: 61440、つまり 60 KB）。テレメトリバックエンドが 64 KB を超える属性値を受け付ける場合にのみ引き上げ、テレメトリの量を減らしたい場合は引き下げてください。Claude Code v2.1.214 以降が必要です。[モニタリング](/docs/ja/monitoring-usage)を参照してください |346| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツを含む OpenTelemetry 属性（モデルの応答、ツールのコンテンツ、システムプロンプト、API の生のボディ）の最大長。切り詰めマーカーを含み、UTF-16 コード単位で指定します（デフォルト: 61440、つまり 60 KB）。テレメトリバックエンドが 64 KB を超える属性値を受け付ける場合にのみ引き上げ、テレメトリ量を減らしたい場合は引き下げてください。Claude Code v2.1.214 以降が必要です。[モニタリング](/docs/ja/monitoring-usage) を参照してください |

345| `CLAUDE_CODE_OTEL_DIAG_STDERR` | `1` に設定すると、OpenTelemetry エクスポーターの診断エラーを stderr に書き込みます。デフォルトでは、これらのエラーは `--debug` を付けた場合にのみ表示されるため、Prometheus のポート競合など設定に誤りがあるエクスポーターは、何も表示されずに失敗します。Claude Code v2.1.179 以降が必要です。[モニタリング](/docs/ja/monitoring-usage)を参照してください |347| `CLAUDE_CODE_OTEL_DIAG_STDERR` | `1` に設定すると、OpenTelemetry エクスポーターの診断エラーを stderr に書き込みます。デフォルトではこれらのエラーは `--debug` でのみ表示されるため、Prometheus のポート衝突など設定ミスのあるエクスポーターは、そうしないと何も表示されずに失敗します。Claude Code v2.1.179 以降が必要です。[モニタリング](/docs/ja/monitoring-usage) を参照してください |

346| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 保留中の OpenTelemetry スパンをフラッシュする際のタイムアウト（ミリ秒、デフォルト: 5000）。[モニタリング](/docs/ja/monitoring-usage)を参照してください |348| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 保留中の OpenTelemetry スパンをフラッシュする際のタイムアウト（ミリ秒、デフォルト: 5000）。[モニタリング](/docs/ja/monitoring-usage) を参照してください |

347| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的な OpenTelemetry ヘッダーを更新する間隔（ミリ秒、デフォルト: 1740000 / 29 分）。[動的ヘッダー](/docs/ja/monitoring-usage#dynamic-headers)を参照してください |349| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的な OpenTelemetry ヘッダーを更新する間隔（ミリ秒、デフォルト: 1740000 / 29 分）。[動的ヘッダー](/docs/ja/monitoring-usage#dynamic-headers) を参照してください |

348| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | シャットダウン時に OpenTelemetry エクスポーターが完了するまでのタイムアウト（ミリ秒、デフォルト: 2000）。終了時にメトリクスが失われる場合は値を増やしてください。[モニタリング](/docs/ja/monitoring-usage)を参照してください |350| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | シャットダウン時に OpenTelemetry エクスポーターが終了するまでのタイムアウト（ミリ秒、デフォルト: 2000）。終了時にメトリクスが失われる場合は増やしてください。[モニタリング](/docs/ja/monitoring-usage) を参照してください |

349| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | `1` に設定すると、新しいバージョンが利用可能になったときに、Claude Code がパッケージマネージャーのアップグレードコマンドをバックグラウンドで実行できるようにします。Homebrew と WinGet でのインストールに適用されます。その他のパッケージマネージャーでは、引き続きアップグレードコマンドが表示されるだけで、実行はされません。[自動更新](/docs/ja/setup#auto-updates)を参照してください |351| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | `1` に設定すると、新しいバージョンが利用可能な場合に、Claude Code がパッケージマネージャーのアップグレードコマンドをバックグラウンドで実行できるようになります。Homebrew と WinGet のインストールに適用されます。他のパッケージマネージャーでは、引き続きアップグレードコマンドが実行されずに表示されます。[自動更新](/docs/ja/setup#auto-updates) を参照してください |

350| `CLAUDE_CODE_PERFORCE_MODE` | `1` に設定すると、Perforce 対応の書き込み保護を有効にします。設定すると、対象ファイルに所有者の書き込みビットがない場合、Edit、Write、NotebookEdit は `p4 edit <file>` のヒントとともに失敗します。Perforce は、同期されたファイルの書き込みビットを `p4 edit` で開くまでクリアしています。これにより、Claude Code が Perforce の変更追跡をバイパスすることを防ぎます |352| `CLAUDE_CODE_PERFORCE_MODE` | `1` に設定すると、Perforce を考慮した書き込み保護を有効にします。設定すると、対象ファイルに所有者の書き込みビットがない場合、Edit、Write、NotebookEdit は `p4 edit <file>` のヒントとともに失敗します。Perforce は、同期されたファイルが `p4 edit` で開かれるまでこのビットをクリアします。これにより、Claude Code が Perforce の変更追跡を迂回することを防ぎます |

351| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | プラグインのルートディレクトリを上書きします。名前に反して、これはキャッシュ自体ではなく親ディレクトリを設定します。マーケットプレイスとプラグインキャッシュは、このパスの下のサブディレクトリに置かれます。デフォルトは `~/.claude/plugins` です |353| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | プラグインのルートディレクトリを上書きします。名前に反して、これはキャッシュそのものではなく親ディレクトリを設定します。マーケットプレイスとプラグインキャッシュは、このパスの下のサブディレクトリに配置されます。デフォルトは `~/.claude/plugins` です |

352| `CLAUDE_CODE_PLUGIN_DIRS` | セッションで読み込むプラグインディレクトリ。それぞれ [`--plugin-dir`](/docs/ja/plugins/cli-reference#flags-that-load-a-plugin-for-one-session) フラグと同じ方法で読み込まれます。複数のパスは、Unix では `:`、Windows では `;` で区切ります。Claude Code は相対パスをスキップするため、各パスは絶対パスで指定するか `~` で始めてください。Claude Code v2.1.280 以降が必要です。[1 つのセッションでプラグインを読み込む](/docs/ja/plugins/create#load-a-directory-or-archive-for-one-session)を参照してください |354| `CLAUDE_CODE_PLUGIN_DIRS` | セッションで読み込むプラグインディレクトリ。それぞれ [`--plugin-dir`](/docs/ja/plugins/cli-reference#flags-that-load-a-plugin-for-one-session) フラグと同じ方法で読み込まれます。複数のパスは、Unix では `:`、Windows では `;` で区切ります。Claude Code は相対パスをスキップするため、各パスは絶対パスで指定するか、`~` で始めてください。Claude Code v2.1.280 以降が必要です。[1 つのセッションでプラグインを読み込む](/docs/ja/plugins/create#load-a-directory-or-archive-for-one-session) を参照してください |

353| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | プラグインマーケットプレイスのクローンまたは更新のタイムアウト（ミリ秒、デフォルト: 120000）。大きなリポジトリや低速なネットワーク接続の場合は値を増やしてください。[Git clone timed out](/docs/ja/plugins/troubleshooting#git-clone-timed-out-after-120s) を参照してください |355| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | プラグインマーケットプレイスのクローンまたは更新のタイムアウト（ミリ秒、デフォルト: 120000）。大規模なリポジトリや低速なネットワーク接続の場合は、この値を増やしてください。[Git clone timed out](/docs/ja/plugins/troubleshooting#git-clone-timed-out-after-120s) を参照してください |

354| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | `1` に設定すると、マーケットプレイスの更新でリモートに到達できないか認証できない場合に、再クローンの試行をスキップして既存のマーケットプレイスのチェックアウトを使い続けます。再クローンしても同じように失敗するオフライン環境やエアギャップ環境で便利です。[オフライン環境でマーケットプレイスの更新が失敗する](/docs/ja/plugins/troubleshooting#marketplace-updates-keep-failing-offline)を参照してください |356| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | `1` に設定すると、マーケットプレイスの更新でリモートに到達できない、または認証できない場合に、再クローンの試行をスキップし、既存のマーケットプレイスのチェックアウトを使い続けます。再クローンしても同様に失敗するオフライン環境やエアギャップ環境で便利です。[オフライン環境でマーケットプレイスの更新が失敗する](/docs/ja/plugins/troubleshooting#marketplace-updates-keep-failing-offline) を参照してください |

355| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | `1` に設定すると、GitHub の `owner/repo` 省略形のソースを SSH ではなく HTTPS でクローンします。プラグインのインストールと更新、および `/plugin marketplace add` と `update` に適用されます。CI ランナー、コンテナ、または `github.com` 用の SSH キーが設定されていない環境で便利です |357| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | `1` に設定すると、GitHub の `owner/repo` 短縮形のソースを SSH ではなく HTTPS でクローンします。プラグインのインストールと更新、および `/plugin marketplace add` と `update` に適用されます。CI ランナー、コンテナ、または `github.com` 用の SSH キーが設定されていない環境で便利です |

356| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 1 つ以上の読み取り専用プラグインシードディレクトリへのパス。Unix では `:`、Windows では `;` で区切ります。事前に内容を用意したプラグインディレクトリをコンテナイメージにバンドルする場合に使用します。Claude Code は起動時にこれらのディレクトリからマーケットプレイスを登録し、事前にキャッシュされたプラグインを再クローンせずに使用します。[コンテナ向けにプラグインを事前に用意する](/docs/ja/plugins/org#seed-containers-and-ci)を参照してください |358| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 1 つ以上の読み取り専用プラグインシードディレクトリへのパス。Unix では `:`、Windows では `;` で区切ります。事前に用意したプラグインディレクトリをコンテナイメージにバンドルするために使用します。Claude Code は起動時にこれらのディレクトリからマーケットプレイスを登録し、事前にキャッシュされたプラグインを再クローンせずに使用します。[コンテナ向けにプラグインを事前に用意する](/docs/ja/plugins/org#seed-containers-and-ci) を参照してください |

357| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | `1` に設定すると、ツール呼び出し、フック、ステータスラインコマンドのために PowerShell を起動する際に、Claude Code が `-ExecutionPolicy Bypass` を渡さないようにし、代わりにマシンの実効実行ポリシーに従います。デフォルトでは、Claude Code はプロセススコープで実行ポリシーをバイパスするため、デフォルトで Restricted となっている Windows 環境でも `.ps1` スクリプトとモジュールのインポートが機能します。プロセススコープのバイパスは、この設定にかかわらず、グループポリシーの `MachinePolicy` や `UserPolicy` を上書きすることはありません |359| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | `1` に設定すると、ツール呼び出し、フック、ステータスラインのコマンドのために PowerShell を起動する際に Claude Code が `-ExecutionPolicy Bypass` を渡すのをやめ、代わりにマシンの実効的な実行ポリシーを尊重します。デフォルトでは、Claude Code はプロセススコープで実行ポリシーを迂回するため、デフォルトで Restricted の Windows 環境でも `.ps1` スクリプトやモジュールのインポートが動作します。プロセススコープの迂回は、この設定に関係なく、グループポリシーの `MachinePolicy` や `UserPolicy` を上書きすることはありません |

358| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | `-p` フラグを使用した[非対話モード](/docs/ja/headless#background-tasks-at-exit)で、最後のターンの後にバックグラウンドのサブエージェントとワークフローをアイドル状態で待機する時間の上限（ミリ秒）。Claude がバックグラウンドの結果を処理するためにターンを実行するたびに、アイドル待機はリセットされます。デフォルト: `600000`、つまり 10 分。アイドル待機が上限に達すると、Claude Code は残りのバックグラウンドタスクの待機を停止して終了します。無期限に待機するには `0` に設定します。この上限は、通常のバックグラウンドシェルに適用される 5 秒の猶予期間とは別のものです。Claude Code v2.1.182 以降が必要です |360| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | `-p` フラグを使用した [非対話モード](/docs/ja/headless#background-tasks-at-exit) で、最後のターンの後にバックグラウンドのサブエージェントとワークフローをアイドル状態で待機する時間の上限（ミリ秒）。Claude がバックグラウンドの結果を処理するためにターンを実行するたびに、アイドル待機はやり直しになります。デフォルト: `600000`、つまり 10 分。アイドル待機が上限に達すると、Claude Code は残りのバックグラウンドタスクの待機をやめて終了します。無期限に待機するには `0` に設定します。この上限は、通常のバックグラウンドシェルに適用される 5 秒の猶予期間とは別のものです。Claude Code v2.1.182 以降が必要です |

359| `CLAUDE_CODE_PROCESS_WRAPPER` | Claude Code が自身のバイナリから起動するプロセス（[エージェントビュー](/docs/ja/agent-view)セッションをホストするバックグラウンドサービスなど）を、`/opt/corp/launcher` のような argv プレフィックスとして指定した企業ランチャー経由で起動します。デタッチされたバックグラウンドサービスが継承できるよう、シェルのエクスポートではなく、ユーザー設定または[管理設定](/docs/ja/managed-settings)の `env` ブロックで設定してください。プロジェクト設定とローカル設定では設定できません。[`processWrapper` 設定](/docs/ja/settings-reference#processwrapper)と同等で、この設定には Claude Code v2.1.210 以降が必要です。両方が設定されている場合は、この変数が優先されます。VS Code 拡張機能は、独自の `claudeProcessWrapper` 設定を通じてランチャーを別途設定します。Windows では無視されます。値の形式、ランチャーの対象範囲、ランチャーが満たす必要のある要件については、[企業ランチャー経由で Claude Code を実行する](/docs/ja/corporate-launcher)を参照してください。Claude Code v2.1.208 以降が必要です |361| `CLAUDE_CODE_PROCESS_WRAPPER` | [エージェントビュー](/docs/ja/agent-view) セッションをホストするバックグラウンドサービスなど、Claude Code が自身のバイナリから起動するプロセスを、`/opt/corp/launcher` のような argv プレフィックスとして指定した企業のランチャーを通じて起動します。切り離されたバックグラウンドサービスが継承できるように、シェルでのエクスポートではなく、ユーザー設定または [管理設定](/docs/ja/managed-settings) の `env` ブロックで設定してください。プロジェクト設定とローカル設定ではこれを設定できません。[`processWrapper` 設定](/docs/ja/settings-reference#processwrapper) と同等で、この設定には Claude Code v2.1.210 以降が必要です。両方が設定されている場合はこの変数が優先されます。VS Code 拡張機能は、独自の `claudeProcessWrapper` 設定を通じて別途ランチャーを構成します。Windows では無視されます。値の形式、ランチャーが対象とする範囲、ランチャーが満たす必要のある要件については、[企業のランチャーの背後で Claude Code を実行する](/docs/ja/corporate-launcher) を参照してください。Claude Code v2.1.208 以降が必要です |

360| `CLAUDE_CODE_PROJECT_DIR_NAME` | `CLAUDE_CONFIG_DIR` と併せて設定すると、作業ディレクトリのパスから導出される名前の代わりに、Claude Code がそのセッションのトランスクリプトと自動メモリを保存する `projects/` ディレクトリの名前を指定できます。たとえば、`CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` で Claude Code を起動すると、それらは `/srv/tenant-a/projects/work/` の下に保存されます。`CLAUDE_CONFIG_DIR` が未設定の場合、Claude Code はこの変数を無視します。また、この変数は `claude` を起動する環境からのみ読み取られ、[設定ファイルの `env` ブロック](#in-settings-files)からは読み取られません。[プロジェクトディレクトリに自分で名前を付ける](/docs/ja/sessions#name-the-project-directory-yourself)を参照してください。Claude Code v2.1.234 以降が必要です |362| `CLAUDE_CODE_PROJECT_DIR_NAME` | `CLAUDE_CONFIG_DIR` と一緒に設定し、Claude Code がそのセッションのトランスクリプトと自動メモリを保存する `projects/` ディレクトリの名前を、作業ディレクトリのパスから導出される名前の代わりに選択します。たとえば、`CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` で Claude Code を起動すると、それらは `/srv/tenant-a/projects/work/` の下に保存されます。`CLAUDE_CONFIG_DIR` が未設定の場合、Claude Code はこの変数を無視します。また、この変数は `claude` を起動した環境からのみ読み取られ、[設定ファイルの `env` ブロック](#in-settings-files) からは読み取られません。[プロジェクトディレクトリに自分で名前を付ける](/docs/ja/sessions#name-the-project-directory-yourself) を参照してください。Claude Code v2.1.234 以降が必要です |

361| `CLAUDE_CODE_PROMPT_CACHE_TTL` | `5m` または `1h`（Claude Code が受け付ける値はこの 2 つのみ）を設定して、メイン会話の[プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択します。対象は、対話、`-p`、SDK のターンと、それらとインラインで実行されるヘルパーです。`promptCacheTtl` 設定と `ENABLE_PROMPT_CACHING_1H` より優先され、`FORCE_PROMPT_CACHING_5M` はこれを上書きします。API では、1 時間のキャッシュ書き込みにはより高い料金が課金されます。Claude Code v2.1.242 以降が必要です |363| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Claude Code が受け付ける唯一の値である `5m` または `1h` を設定して、メインの会話（対話、`-p`、SDK のターンと、それらとインラインで実行されるヘルパー）の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択します。`promptCacheTtl` 設定と `ENABLE_PROMPT_CACHING_1H` より優先され、`FORCE_PROMPT_CACHING_5M` によって上書きされます。API は 1 時間のキャッシュ書き込みをより高い料金で請求します。Claude Code v2.1.242 以降が必要です |

362| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | `1` に設定すると、`ANTHROPIC_BASE_URL` がカスタムプロキシを指している場合に W3C トレースコンテキストを伝播します。伝播の対象は、モデルリクエストと HTTP MCP リクエストの `traceparent` ヘッダー、および Bash、PowerShell、フックのサブプロセスの `TRACEPARENT` 環境変数です。デフォルトでは、Anthropic API に直接接続している場合にのみ伝播が有効になります。v2.1.152 で追加されました。[トレース（ベータ）](/docs/ja/monitoring-usage#traces-beta)を参照してください |364| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | `1` に設定すると、`ANTHROPIC_BASE_URL` がカスタムプロキシを指している場合に W3C トレースコンテキストを伝播します。伝播の対象は、モデルおよび HTTP MCP リクエストの `traceparent` ヘッダーと、Bash、PowerShell、フックのサブプロセス向けの `TRACEPARENT` 環境変数です。デフォルトでは、Anthropic API に直接接続している場合にのみ伝播が有効です。v2.1.152 で追加されました。[トレース（ベータ）](/docs/ja/monitoring-usage#traces-beta) を参照してください |

363| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Claude Code を組み込み、Claude Code に代わってモデルプロバイダーのルーティングを管理するホストプラットフォームによって設定されます。設定されている場合、Claude Code は設定ファイル内の `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_API_KEY` などのプロバイダー選択、エンドポイント、認証の変数を無視するため、ユーザー設定でホストのルーティングを上書きすることはできません。また、Claude Code は[管理設定](/docs/ja/managed-settings)内の `model`、`fallbackModel`、`modelOverrides` などのモデル選択キーを、どの管理ソースから配信されたかにかかわらず無視するため、古い管理設定によるモデルの固定よりもホストのモデル設定が優先されます。さらに、Claude Code は管理設定の `env` ブロック内の `ANTHROPIC_MODEL` や `ANTHROPIC_DEFAULT_*_MODEL` ファミリーなどのモデル選択変数も無視します。ただし、ホストが独自の許可リストを提供しない限り、管理設定内の [`availableModels`](/docs/ja/model-config#restrict-model-selection) 許可リストは引き続き適用されます。また、Claude Code は Amazon Bedrock、Claude Platform on AWS、Google Cloud's Agent Platform、Microsoft Foundry などのサードパーティプロバイダーで通常適用する自動的なテレメトリのオプトアウトをスキップするため、テレメトリは標準の `DISABLE_TELEMETRY` によるオプトアウトに従います。[API プロバイダー別のデフォルト動作](/docs/ja/data-usage#default-behaviors-by-api-provider)を参照してください |365| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Claude Code を組み込み、代わりにモデルプロバイダーのルーティングを管理するホストプラットフォームによって設定されます。設定されている場合、Claude Code は設定ファイル内の `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_API_KEY` などのプロバイダー選択、エンドポイント、認証の変数を無視するため、ユーザー設定でホストのルーティングを上書きすることはできません。また Claude Code は、どの管理ソースから配信されたかに関係なく、[管理設定](/docs/ja/managed-settings) 内の `model`、`fallbackModel`、`modelOverrides` などのモデル選択キーも無視するため、ホストのモデル設定が古い管理モデルの固定より優先されます。さらに Claude Code は、管理された `env` ブロック内の `ANTHROPIC_MODEL` や `ANTHROPIC_DEFAULT_*_MODEL` 系のモデル選択変数も無視します。管理設定内の [`availableModels`](/docs/ja/model-config#restrict-model-selection) 許可リストは、ホストが独自のものを提供しない限り引き続き適用されます。加えて Claude Code は、Amazon Bedrock、Claude Platform on AWS、Google Cloud's Agent Platform、Microsoft Foundry などのサードパーティプロバイダーで通常適用するテレメトリの自動オプトアウトもスキップするため、テレメトリは標準の `DISABLE_TELEMETRY` によるオプトアウトに従います。[API プロバイダー別のデフォルト動作](/docs/ja/data-usage#default-behaviors-by-api-provider) を参照してください |

365| `CLAUDE_CODE_REMOTE` | Claude Code が[クラウドセッション](/docs/ja/claude-code-on-the-web)として実行されている場合に、自動的に `true` に設定されます。フックやセットアップスクリプトからこれを読み取ると、クラウドセッション内にいるかどうかを検出できます |367| `CLAUDE_CODE_REMOTE` | Claude Code が [クラウドセッション](/docs/ja/claude-code-on-the-web) として実行されている場合に、自動的に `true` に設定されます。フックやセットアップスクリプトからこれを読み取り、クラウドセッション内にいるかどうかを判定します |

366| `CLAUDE_CODE_REMOTE_SESSION_ID` | [クラウドセッション](/docs/ja/claude-code-on-the-web)で、現在のセッションの ID に自動的に設定されます。これを読み取って、セッションのトランスクリプトへのリンクを作成できます。[出力からセッションへリンクする](/docs/ja/cloud-environments#link-output-back-to-the-session)を参照してください |368| `CLAUDE_CODE_REMOTE_SESSION_ID` | [クラウドセッション](/docs/ja/claude-code-on-the-web) で、現在のセッションの ID に自動的に設定されます。これを読み取って、セッションのトランスクリプトへのリンクを作成します。[出力をセッションにリンクする](/docs/ja/cloud-environments#link-output-back-to-the-session) を参照してください |

367| `CLAUDE_CODE_RESTRICTED` | `1` に設定すると、[`--restricted`](/docs/ja/cli-reference#cli-flags) を渡した場合と同じく、制限モードでセッションを開始します。Claude Code は、設定ファイルの `env` ブロック内のこの変数を無視します。Claude Code v2.1.248 以降が必要です |369| `CLAUDE_CODE_RESTRICTED` | `1` に設定すると、[`--restricted`](/docs/ja/cli-reference#cli-flags) を渡した場合と同様に、制限モードでセッションを開始します。設定ファイルの `env` ブロック内では、Claude Code はこの変数を無視します。Claude Code v2.1.248 以降が必要です |

368| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | `1` に設定すると、前のセッションがターンの途中で終了した場合に自動的に再開します。SDK モードで使用され、SDK がプロンプトを再送信しなくてもモデルが続行できるようにします。オフにするには、変数の設定を解除するか `0` に設定します。VS Code のチャットパネルについては、[再読み込み後に会話を続ける](/docs/ja/vs-code#continue-conversations-after-a-reload)を参照してください |370| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | `1` に設定すると、前のセッションがターンの途中で終了した場合に自動的に再開します。SDK モードで使用され、SDK がプロンプトを再送信しなくてもモデルが続行できるようにします。オフにするには、変数の設定を解除するか `0` に設定してください。VS Code のチャットパネルについては、[再読み込み後に会話を続ける](/docs/ja/vs-code#continue-conversations-after-a-reload) を参照してください |

369| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | ターンの途中で終了したセッションが再開時に自動的に続行されるための、最後のトランスクリプトメッセージの最大経過時間（ミリ秒）。最後のメッセージがこの上限より古い場合、Claude Code は `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` による自動再開と、その `CLAUDE_CODE_RESUME_PROMPT` による継続メッセージをスキップし、セッションはアイドル状態で開始されるため、明示的に続行することになります。未設定または `0` の場合は上限はありませんが、最後のリクエストが API エラーで失敗したターンは、そのエラーの発生から 6 時間未満の場合にのみ再開されます。正の値を指定すると、そうしたターンを含むすべてのターンに上限が設けられます。負の値または数値以外の値を指定すると、1 時間の上限が適用されます。長時間実行されるエージェントの起動スクリプトでこれを設定すると、古いトランスクリプトに対して再起動したときに、古いプロンプトが再実行されるのを防げます。対話セッションから会話を引き継いだ[エージェントビュー](/docs/ja/agent-view)セッションがクラッシュして再起動する際には、Claude Code 自身が 1 時間の上限を設定します。Claude Code v2.1.211 以降が必要です |371| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | ターンの途中で終了したセッションを再開時に自動的に続行するための、トランスクリプトの最後のメッセージの最大経過時間（ミリ秒）。最後のメッセージがこの上限より古い場合、Claude Code は `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` による自動再開とその `CLAUDE_CODE_RESUME_PROMPT` の継続メッセージをスキップし、セッションはアイドル状態で開始されるため、明示的に続行することになります。未設定または `0` は上限なしを意味しますが、最後のリクエストが API エラーで失敗したターンは、そのエラーから 6 時間未満の場合にのみ再開されます。正の値は、そうしたターンを含むすべてのターンに上限を設けます。負の値や数値でない値では、1 時間の上限が適用されます。長時間実行エージェントの起動スクリプトでこれを設定すると、古いトランスクリプトに対して再起動した際に古いプロンプトが再実行されるのを防げます。対話セッションから会話を引き継いだ [エージェントビュー](/docs/ja/agent-view) セッションがクラッシュして再起動する際には、Claude Code 自身が 1 時間の上限を設定します。Claude Code v2.1.211 以降が必要です |

370| `CLAUDE_CODE_RESUME_PROMPT` | `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` が中断されたターンをプロンプトの再送信ではなく続行するとき、または `-p` で[延期されたツール呼び出し](/docs/ja/hooks#defer-a-tool-call-for-later)を再開するときに、Claude Code が Claude に送信する継続メッセージを上書きします。デフォルトは `Continue from where you left off.` です。空文字列の場合はデフォルトが使用されます |372| `CLAUDE_CODE_RESUME_PROMPT` | `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` が中断されたターンをプロンプトの再送信ではなく継続する場合、または `-p` で [延期されたツール呼び出し](/docs/ja/hooks#defer-a-tool-call-for-later) を再開する場合に、Claude Code が Claude に送信する継続メッセージを上書きします。デフォルトは `Continue from where you left off.` です。空文字列の場合はデフォルトが使用されます |

371| `CLAUDE_CODE_RETRY_WATCHDOG` | 評価ハーネス、CI ジョブ、リモートワーカーなどの無人セッションでは `1` に設定します。`429` および `529` の容量エラーを、`CLAUDE_CODE_MAX_RETRIES` 回の試行後に失敗させるのではなく、無期限に再試行します。標準速度のリクエストが、支出上限または使用クレジットの枯渇を示す `429` を受け取った場合は、スケジュールに従ってリセットされる[ゲートウェイの支出上限](/docs/ja/errors#spend-limit-reached)によるものであっても、Claude Code は即座に失敗します。v2.1.239 より前は、ウォッチドッグはこれらを無期限に再試行していました。fast mode リクエストについては、[レート制限への対処](/docs/ja/fast-mode#handle-rate-limits)を参照してください。ウォッチドッグは試行間で最大 5 分間、またはレスポンスにレート制限のリセット時刻が含まれている場合は制限がリセットされるまでバックオフするため、使用制限に達したセッションは残りの期間が経過するまで待機します。v2.1.199 以降では、サーバーエラー、タイムアウト、切断された接続などのその他の一時的なエラーに対するデフォルトの再試行回数も 300（約 3 時間のバックオフ）に引き上げ、`CLAUDE_CODE_MAX_RETRIES` を明示的に設定している場合は、その上限である 15 を撤廃します。Claude Code v2.1.186 以降が必要です |373| `CLAUDE_CODE_RETRY_WATCHDOG` | 評価ハーネス、CI ジョブ、リモートワーカーなどの無人セッションでは `1` に設定します。`429` と `529` の容量エラーを、`CLAUDE_CODE_MAX_RETRIES` 回の試行後に失敗するのではなく、無期限に再試行します。標準速度のリクエストが、支出制限や使用クレジットの枯渇を報告する `429` を受け取った場合、それがスケジュールに従ってリセットされる [ゲートウェイの支出上限](/docs/ja/errors#spend-limit-reached) によるものであっても、Claude Code は即座に失敗します。v2.1.239 より前は、ウォッチドッグはこれらを無期限に再試行していました。fast mode のリクエストについては、[レート制限への対処](/docs/ja/fast-mode#handle-rate-limits) を参照してください。ウォッチドッグは試行間で最大 5 分、またはレスポンスにレート制限のリセット時刻が含まれる場合は制限がリセットされるまでバックオフするため、使用制限に達したセッションは残りの時間枠を待ち続けます。v2.1.199 以降では、サーバーエラー、タイムアウト、接続の切断など、その他の一時的なエラーのデフォルトの再試行回数を 300（約 3 時間のバックオフ）に引き上げ、`CLAUDE_CODE_MAX_RETRIES` を明示的に設定した場合の上限 15 も撤廃します。Claude Code v2.1.186 以降が必要です |

372| `CLAUDE_CODE_SAFE_MODE` | `1` に設定すると、セーフモードで起動します。壊れた設定のトラブルシューティングのため、CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーボードショートカット、ステータスラインとファイル候補のコマンド、LSP サーバー、自動メモリが読み込まれません。ポリシーで設定されたフック、ステータスライン、ファイル候補コマンドを含め、管理設定のポリシーは引き続き適用されます。管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシーで設定された MCP サーバーは適用されません。[`--safe-mode`](/docs/ja/cli-reference#cli-flags) を渡すのと同等です。直接起動された子プロセスは、この変数を継承します |374| `CLAUDE_CODE_SAFE_MODE` | `1` に設定すると、セーフモードで起動します。壊れた設定のトラブルシューティングのために、CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーボードショートカット、ステータスラインとファイル候補のコマンド、LSP サーバー、自動メモリが読み込まれません。ポリシーで設定されたフック、ステータスライン、ファイル候補のコマンドを含め、管理設定のポリシーは引き続き適用されます。管理されたプラグイン、管理されたスキル、管理された CLAUDE.md、ポリシーで設定された MCP サーバーは適用されません。[`--safe-mode`](/docs/ja/cli-reference#cli-flags) を渡すのと同等です。直接起動された子プロセスはこの変数を継承します |

373| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が設定されている場合に、特定のスクリプトをセッションごとに呼び出せる回数を制限する JSON オブジェクト。キーはコマンドテキストと照合される部分文字列で、値は整数の呼び出し上限です。たとえば、`{"deploy.sh": 2}` は `deploy.sh` の呼び出しを最大 2 回までに制限します。照合は部分文字列ベースのため、`./scripts/deploy.sh $(evil)` のようなシェル展開のトリックも上限にカウントされます。`xargs` や `find -exec` による実行時のファンアウトは検出されません。これは多層防御のための制御です |375| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が設定されている場合に、特定のスクリプトを 1 セッションあたり何回呼び出せるかを制限する JSON オブジェクト。キーはコマンドテキストと照合される部分文字列で、値は整数の呼び出し回数制限です。たとえば、`{"deploy.sh": 2}` は `deploy.sh` の呼び出しを最大 2 回までに制限します。照合は部分文字列ベースのため、`./scripts/deploy.sh $(evil)` のようなシェル展開のトリックも上限にカウントされます。`xargs` や `find -exec` による実行時のファンアウトは検出されません。これは多層防御のための制御です |

374| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリーンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling)でのマウスホイールのスクロール倍率を設定します。20 までの任意の正の値を受け付けます。ホイールイベントをすでに増幅するターミナルで、加速されたトラックパッドやホイールのスクロールを遅くするために、`0.5` など 1 未満の小数値も指定できます。ターミナルが増幅なしでノッチごとに 1 つのホイールイベントを送信する場合、`vim` と合わせるには `3` に設定します。Claude Code が独自のスクロール処理を使用する JetBrains IDE のターミナルでは無視されます |376| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリーンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling) でのマウスホイールのスクロール倍率を設定します。20 までの任意の正の値を受け付け、すでにホイールイベントを増幅するターミナルで加速されたトラックパッドやホイールのスクロールを遅くするための `0.5` など、1 未満の小数値も指定できます。ターミナルが増幅なしでノッチごとに 1 つのホイールイベントを送信する場合は、`3` に設定すると `vim` と同じになります。Claude Code が独自のスクロール処理を使用する JetBrains IDE のターミナルでは無視されます |

375| `CLAUDE_CODE_SEND_FEEDBACK` | `0` に設定すると、セッションで [Claude が作成するフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)をオフにします。アカウントがすでにアクセス権を持っている場合は、`1` に設定するとオンにできます。この変数自体でアクセス権を付与することはできず、`DISABLE_FEEDBACK_COMMAND` や [`feedbackDrafts`](/docs/ja/settings-reference#feedbackdrafts) 設定の `off` 値など、フィードバックをオフにする他のスイッチは引き続き適用されます |377| `CLAUDE_CODE_SEND_FEEDBACK` | `0` に設定すると、セッションで [Claude が下書きするフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) をオフにします。`1` に設定すると、アカウントがすでにアクセス権を持っている場合にオンにします。この変数自体がアクセス権を付与することはできず、`DISABLE_FEEDBACK_COMMAND` や [`feedbackDrafts`](/docs/ja/settings-reference#feedbackdrafts) 設定の `off` 値など、フィードバックをオフにする他のスイッチも引き続き適用されます |

376| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/docs/ja/hooks#sessionend) フックの時間予算（ミリ秒）を上書きします。この値は、独自の `timeout` を設定していない各フックのタイムアウトにもなります。セッションの終了、`/clear`、対話的な `/resume` によるセッションの切り替えに適用されます。デフォルトの予算は 1.5 秒で、設定ファイルで構成されたフックごとの `timeout` の最大値まで、最大 60 秒の範囲で自動的に引き上げられます。プラグインが提供するフックのタイムアウトでは予算は引き上げられません |378| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/docs/ja/hooks#sessionend) フックの時間予算（ミリ秒）を上書きします。この値は、独自の `timeout` を設定していない各フックのタイムアウトにもなります。セッションの終了、`/clear`、対話的な `/resume` によるセッションの切り替えに適用されます。デフォルトの予算は 1.5 秒で、設定ファイルで構成されたフックごとの `timeout` の最大値まで、最大 60 秒に自動的に引き上げられます。プラグインが提供するフックのタイムアウトは予算を引き上げません |

377| `CLAUDE_CODE_SESSION_ID` | Bash と PowerShell のツールサブプロセス、[フックコマンド](/docs/ja/hooks)のサブプロセス、stdio [MCP サーバー](/docs/ja/mcp)のサブプロセスで、現在のセッション ID に自動的に設定されます。Bash、PowerShell、フックでは、フックの JSON 入力の `session_id` フィールドと一致し、`/clear` で更新されます。MCP サーバーのサブプロセスは、起動時の ID を保持します。`--resume <session-id>` では再開された ID を受け取り、フックや Bash と一致します。明示的な ID を指定しない `--continue` または `--resume` では、代わりに最初の起動時の ID を受け取る場合があります。スクリプトや外部ツールを、それらを起動した Claude Code セッションと関連付けるために使用します |379| `CLAUDE_CODE_SESSION_ID` | Bash および PowerShell ツールのサブプロセス、[フックコマンド](/docs/ja/hooks) のサブプロセス、stdio [MCP サーバー](/docs/ja/mcp) のサブプロセスで、現在のセッション ID に自動的に設定されます。Bash、PowerShell、フックでは、これはフックの JSON 入力の `session_id` フィールドと一致し、`/clear` で更新されます。MCP サーバーのサブプロセスは、起動時の ID を保持します。`--resume <session-id>` では再開された ID を受け取り、フックや Bash と一致します。明示的な ID なしの `--continue` または `--resume` では、代わりに最初の起動時の ID を受け取る場合があります。スクリプトや外部ツールを、それらを起動した Claude Code セッションと関連付けるために使用します |

378| `CLAUDE_CODE_SHELL` | Claude Code が Bash ツールのコマンドを実行するために使用するシェルを設定します。`bash` または `zsh` バイナリへのパス（例: `/opt/homebrew/bin/bash`）を受け付けます。`fish` などの他のシェルはサポートされていません。値が動作する `bash` または `zsh` のパスでない場合、Claude Code はそれを無視して自動検出にフォールバックします。自動検出では、`$SHELL` が `bash` または `zsh` を指している場合はそれを使用し、そうでない場合は `PATH` と標準のインストール場所で見つかった、動作する最初の `zsh`、次に `bash` を選択します |380| `CLAUDE_CODE_SHELL` | Claude Code が Bash ツールのコマンドを実行するために使用するシェルを設定します。`bash` または `zsh` のバイナリへのパスを受け付けます（例: `/opt/homebrew/bin/bash`）。`fish` などの他のシェルはサポートされていません。値が動作する `bash` または `zsh` のパスでない場合、Claude Code はそれを無視して自動検出にフォールバックします。自動検出では、`$SHELL` が `bash` または `zsh` を指している場合はそれを使用し、そうでない場合は `PATH` と標準のインストール場所で見つかった最初の動作する `zsh`、次に `bash` を選択します |

379| `CLAUDE_CODE_SHELL_PREFIX` | Claude Code が起動するシェルコマンド（Bash ツール呼び出し、[フック](/docs/ja/hooks)コマンド、[ステータスライン](/docs/ja/statusline)コマンド、stdio [MCP サーバー](/docs/ja/mcp)の起動コマンド）をラップするコマンドプレフィックス。PowerShell フックと exec 形式のフックはプレフィックスなしで実行されます。ログ記録や監査に便利です。`/path/to/logger.sh` のような実行ファイルのパスだけを設定すると、各コマンドは `/path/to/logger.sh '<command>'` として実行されます。ラッパーはコマンドラインを `$1` 内の単一のシェルクォートされた引数として受け取るため、ラッパーは `exec bash -c "$1"` のように、シェルで `$1` を再評価する必要があります。`$1` を実行ファイルのパスそのものとして扱うと、`npx -y <package>` のような引数を渡す stdio MCP サーバーが動作しなくなります。Bash ツール呼び出しの場合、`$1` には Claude が実行したコマンドだけでなく、環境のセットアップを含め、Claude Code が組み立てたシェル呼び出し全体が含まれます |381| `CLAUDE_CODE_SHELL_PREFIX` | Claude Code が起動するシェルコマンドをラップするコマンドプレフィックス。対象は Bash ツール呼び出し、[フック](/docs/ja/hooks) コマンド、[ステータスライン](/docs/ja/statusline) コマンド、stdio [MCP サーバー](/docs/ja/mcp) の起動コマンドです。PowerShell フックと exec 形式のフックはプレフィックスなしで実行されます。ログ記録や監査に便利です。`/path/to/logger.sh` のような実行ファイルのパスだけを設定すると、各コマンドは `/path/to/logger.sh '<command>'` として実行されます。ラッパーはコマンドラインを `$1` に単一のシェルクォートされた引数として受け取るため、ラッパーは `exec bash -c "$1"` のように、シェルで `$1` を再評価する必要があります。`$1` を単なる実行ファイルのパスとして扱うと、`npx -y <package>` のように引数を渡す stdio MCP サーバーが動作しなくなります。Bash ツール呼び出しの場合、`$1` には Claude が実行したコマンドだけでなく、環境のセットアップを含む、Claude Code が組み立てたシェル呼び出し全体が含まれます |

380| `CLAUDE_CODE_SIMPLE` | `1` に設定すると、最小限のシステムプロンプトと、Bash、ファイル読み取り、ファイル編集のツールのみで実行します。`--mcp-config` からの MCP ツールは引き続き利用できます。フック、スキル、カスタムコマンド、サブエージェント、インストール済みのプラグイン、MCP サーバー、自動メモリ、CLAUDE.md の自動検出を無効にします。`--add-dir` で渡したディレクトリ内のスキルは引き続き読み込まれます。OAuth トークンとキーチェーンの認証情報は読み取られないため、Anthropic の認証は `ANTHROPIC_API_KEY` または `--settings` 内の `apiKeyHelper` で行う必要があります。[`--bare`](/docs/ja/headless#start-faster-with-bare-mode) を渡すのと同等です |382| `CLAUDE_CODE_SIMPLE` | `1` に設定すると、最小限のシステムプロンプトと、Bash、ファイル読み取り、ファイル編集のツールのみで実行します。`--mcp-config` からの MCP ツールは引き続き利用できます。フック、スキル、カスタムコマンド、サブエージェント、インストール済みプラグイン、MCP サーバー、自動メモリ、CLAUDE.md の自動検出を無効にします。`--add-dir` で渡したディレクトリ内のスキルは引き続き読み込まれます。OAuth トークンとキーチェーンの認証情報は読み取られないため、Anthropic の認証は `ANTHROPIC_API_KEY` または `--settings` 内の `apiKeyHelper` から提供する必要があります。[`--bare`](/docs/ja/headless#start-faster-with-bare-mode) を渡すのと同等です |

381| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | `1` に設定すると、任意のモデルで、より短いシステムプロンプトと簡略化されたツールの説明を使用します。実験やサーバー設定によって有効になるモデルでもオプトアウトするには、`0`、`false`、`no`、または `off` に設定します。完全なツールセット、フック、MCP サーバー、CLAUDE.md の検出は引き続き有効です |383| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | `1` に設定すると、どのモデルでも短いシステムプロンプトと簡略化されたツールの説明を使用します。`0`、`false`、`no`、`off` に設定すると、実験やサーバー設定によって本来有効になるモデルでもオプトアウトします。完全なツールセット、フック、MCP サーバー、CLAUDE.md の検出は有効なままです |

382| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | リクエストに自ら署名するゲートウェイ向けに、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のクライアント側認証をスキップします |384| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | リクエストに自ら署名するゲートウェイ向けに、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のクライアント側認証をスキップします |

383| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | `1` に設定すると、AWS のデフォルト認証情報プロバイダーチェーンから解決された認証情報のプロセス内キャッシュをオフにし、Claude Code が API リクエストのたびにチェーンを解決するようにします。キャッシュがオフの場合、SSO ベースのプロファイルはリクエストのたびに IAM Identity Center に認証情報を要求します。[認証情報のキャッシュと解決のタイムアウト](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout)を参照してください。Claude Code v2.1.207 以降が必要です |385| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | `1` に設定すると、AWS のデフォルト認証情報プロバイダーチェーンから解決された認証情報のプロセス内キャッシュをオフにし、Claude Code は API リクエストのたびにチェーンを解決します。キャッシュがオフの場合、SSO ベースのプロファイルはリクエストのたびに IAM Identity Center に認証情報を要求します。[認証情報のキャッシュと解決のタイムアウト](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout) を参照してください。Claude Code v2.1.207 以降が必要です |

385| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | `1` に設定すると、チェックによる `api.anthropic.com` への直接リクエストをブロックするネットワーク向けに、[fast mode](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) の利用可能性チェックの失敗を利用可能として扱います。Claude Code は「disabled by your organization」のレスポンスには引き続き従います |387| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | `1` に設定すると、チェックによる `api.anthropic.com` への直接リクエストをブロックするネットワーク向けに、失敗した [fast mode](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) の利用可否チェックを利用可能として扱います。Claude Code は「disabled by your organization」というレスポンスには引き続き従います |

386| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | `1` に設定すると、チェックのリクエストを拒否するのではなく傍受するプロキシ向けに、クライアント側の [fast mode](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) の利用可能性チェックをスキップします。組織で fast mode が無効になっている場合、API は引き続き fast mode リクエストを拒否します |388| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | `1` に設定すると、チェックのリクエストを拒否するのではなく傍受するプロキシ向けに、クライアント側の [fast mode](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) の利用可否チェックをスキップします。組織で fast mode が無効になっている場合、API は引き続き fast mode のリクエストを拒否します |

387| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | 独自の `Authorization` ヘッダーを挿入するプロキシやゲートウェイ向けに、Microsoft Foundry の Azure 認証をスキップします。Claude Code は Azure の認証情報なしでリクエストを送信し、`ANTHROPIC_CUSTOM_HEADERS` などで指定した `Authorization` ヘッダーを保持します。`ANTHROPIC_FOUNDRY_API_KEY` または `ANTHROPIC_FOUNDRY_AUTH_TOKEN` が設定されている場合は無視されます。v2.1.203 より前は、API キーも設定されていない限り、この変数によって Microsoft Foundry クライアントがリクエストを送信できなくなっていました |389| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | 独自の `Authorization` ヘッダーを挿入するプロキシやゲートウェイ向けに、Microsoft Foundry の Azure 認証をスキップします。Claude Code は Azure の認証情報なしでリクエストを送信し、`ANTHROPIC_CUSTOM_HEADERS` などを通じて指定した `Authorization` ヘッダーを保持します。`ANTHROPIC_FOUNDRY_API_KEY` または `ANTHROPIC_FOUNDRY_AUTH_TOKEN` が設定されている場合は無視されます。v2.1.203 より前は、API キーも設定されていない限り、この変数によって Microsoft Foundry クライアントがリクエストを送信できなくなっていました |

389| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | [Amazon Bedrock](/docs/ja/amazon-bedrock) と [Google Cloud's Agent Platform](/docs/ja/google-vertex-ai) での[起動時のモデルチェック](/docs/ja/amazon-bedrock#startup-model-checks)は、アカウントで呼び出せないことが判明したモデルを、このマシン上で最大 1 日間記憶します。`1` に設定すると、この記憶をオフにします。Claude Code v2.1.285 以降が必要です |391| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | [Amazon Bedrock](/docs/ja/amazon-bedrock) と [Google Cloud's Agent Platform](/docs/ja/google-vertex-ai) での [起動時のモデルチェック](/docs/ja/amazon-bedrock#startup-model-checks) は、アカウントで呼び出せないと判明したモデルを、このマシン上に最大 1 日間記憶します。`1` に設定すると、この記憶をオフにします。Claude Code v2.1.285 以降が必要です |

390| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | `1` に設定すると、プロンプト履歴とセッションのトランスクリプトをディスクに書き込みません。この変数を設定して開始したセッションは、`--resume`、`--continue`、上矢印キーの履歴に表示されません。一時的なスクリプトセッションで便利です |392| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | `1` に設定すると、プロンプト履歴とセッションのトランスクリプトをディスクに書き込まないようにします。この変数を設定して開始したセッションは、`--resume`、`--continue`、上矢印キーの履歴に表示されません。一時的なスクリプト実行のセッションに便利です |

392| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | `1` に設定すると、`--output-format stream-json` で開始したセッションで、通常は stderr への出力だけで終了する起動失敗の際に、[Claude Code が起動を拒否した理由を示す結果メッセージ](/docs/ja/agent-sdk/typescript#startup_failure_reason)を書き込みます。Claude Code v2.1.274 以降が必要です |394| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | `1` に設定すると、`--output-format stream-json` で開始したセッションが、通常は stderr のみで終わる起動失敗の場合に、[Claude Code が起動を拒否した理由を示す結果メッセージ](/docs/ja/agent-sdk/typescript#startup_failure_reason) を書き込みます。Claude Code v2.1.274 以降が必要です |

393| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/docs/ja/hooks#stop) または [SubagentStop](/docs/ja/hooks#subagentstop) フックがターンの終了を連続してブロックできる最大回数。これを超えると、Claude Code はフックの判断を上書きしてターンを終了します（デフォルト: 8）。上限を無効にするには `0` に設定します。フックが解決するのに本当により多くの反復を必要とする場合は、値を引き上げてください |395| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/docs/ja/hooks#stop) または [SubagentStop](/docs/ja/hooks#subagentstop) フックがターンの終了を連続してブロックできる最大回数。これを超えると、Claude Code はフックを上書きしてターンを終了します（デフォルト: 8）。上限を無効にするには `0` に設定します。フックが解決するために正当により多くの反復を必要とする場合は、この値を引き上げてください |

394| `CLAUDE_CODE_SUBAGENT_MODEL` | 他の方法でモデルが割り当てられていない[サブエージェント](/docs/ja/sub-agents#choose-a-model)、[エージェントチーム](/docs/ja/agent-teams#specify-teammates-and-models)のチームメイト、[ワークフロー](/docs/ja/workflows)エージェントのデフォルトモデル。`haiku` などのエイリアスまたは完全なモデル名を受け付けます。次の 2 つのソースがこれより優先されます: Claude がエージェントを生成するときに渡すモデルと、`inherit` を含むエージェント定義の `model` フィールドです。これを変更するには、[`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ja/sub-agents#run-every-subagent-on-one-model) を設定します。完全な優先順位については、[モデルを選択する](/docs/ja/sub-agents#choose-a-model)を参照してください。`inherit` に設定するのは、未設定のままにするのと同じです。v2.1.251 より前は、この変数は呼び出しごとのモデルと定義の `model` フィールドの両方を上書きしていました |396| `CLAUDE_CODE_SUBAGENT_MODEL` | 他の方法でモデルが割り当てられていない [サブエージェント](/docs/ja/sub-agents#choose-a-model)、[エージェントチーム](/docs/ja/agent-teams#specify-teammates-and-models) のチームメイト、[ワークフロー](/docs/ja/workflows) のエージェントのデフォルトモデル。`haiku` などのエイリアスまたは完全なモデル名を受け付けます。これより優先されるソースが 2 つあります。Claude がエージェントを生成する際に渡すモデルと、`inherit` を含むエージェント定義内の `model` フィールドです。これを変更するには、[`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ja/sub-agents#run-every-subagent-on-one-model) を設定してください。完全な順序については [モデルを選択する](/docs/ja/sub-agents#choose-a-model) を参照してください。`inherit` に設定するのは、未設定のままにするのと同じです。v2.1.251 より前は、この変数は呼び出しごとのモデルと定義の `model` フィールドの両方を上書きしていました |

395| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | `1` に設定すると、サブエージェント、チームメイト、ワークフローエージェントに 1 つのモデルを強制します。どのモデルになるかは、[すべてのサブエージェントを 1 つのモデルで実行する](/docs/ja/sub-agents#run-every-subagent-on-one-model)で説明しています。Claude Code v2.1.257 以降が必要です |397| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | `1` に設定すると、サブエージェント、チームメイト、ワークフローのエージェントに 1 つのモデルを強制します。どのモデルになるかは [すべてのサブエージェントを 1 つのモデルで実行する](/docs/ja/sub-agents#run-every-subagent-on-one-model) で説明しています。Claude Code v2.1.257 以降が必要です |

396| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | `5m` または `1h`（Claude Code が受け付ける値はこの 2 つのみ）を設定して、[サブエージェント](/docs/ja/sub-agents)、ワークフロー、バックグラウンド作業など、メイン会話以外のリクエストの[プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択します。`subagentPromptCacheTtl` 設定と `ENABLE_PROMPT_CACHING_1H` より優先され、`FORCE_PROMPT_CACHING_5M` はこれを上書きします。API では、1 時間のキャッシュ書き込みにはより高い料金が課金されます。Claude Code v2.1.242 以降が必要です |398| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Claude Code が受け付ける唯一の値である `5m` または `1h` を設定して、[サブエージェント](/docs/ja/sub-agents)、ワークフロー、バックグラウンド作業など、メインの会話以外のリクエストの [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択します。`subagentPromptCacheTtl` 設定と `ENABLE_PROMPT_CACHING_1H` より優先され、`FORCE_PROMPT_CACHING_5M` によって上書きされます。API は 1 時間のキャッシュ書き込みをより高い料金で請求します。Claude Code v2.1.242 以降が必要です |

397| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | `1` に設定すると、サブプロセス環境（Bash ツール、フック、MCP stdio サーバー）から認証情報を取り除きます。対象は、Anthropic とクラウドプロバイダーの認証情報、Claude Code が認証情報として認識するその他の変数、パッケージレジストリの URL に埋め込まれた認証情報です。親の Claude プロセスは API 呼び出しのためにこれらの認証情報を保持しますが、子プロセスはそれらを読み取れないため、シェル展開を介してシークレットを持ち出そうとするプロンプトインジェクション攻撃にさらされるリスクが軽減されます。v2.1.251 以降では、Claude Code 自身の設定ストアを指す変数（`CLAUDE_CONFIG_DIR` など）も削除されるため、子プロセスは移動された設定ディレクトリを見つけることができません。サブプロセスでこれらの変数が必要な場合は、このスクラブを設定しないでください。Linux では、Bash サブプロセスを分離された PID 名前空間でも実行するため、サブプロセスは `/proc` を介してホストプロセスの環境を読み取ることができません。副作用として、`ps`、`pgrep`、`kill` はホストプロセスを参照したりシグナルを送ったりできません。`claude-code-action` は、`allowed_non_write_users` が設定されている場合にこれを自動的に設定します |399| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | `1` に設定すると、Bash コマンド、フック、stdio MCP サーバーなど、Claude Code が起動するサブプロセスの環境から認証情報を取り除きます。スクラブは変数名または値によって認証情報を識別し、GitHub トークンとプロキシ設定はそのまま残します。[サブプロセス環境のスクラブで削除されるもの](#what-the-subprocess-environment-scrub-removes) を参照してください。`claude-code-action` は、`allowed_non_write_users` が設定されている場合にこれを自動的に設定します |

398| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 非対話モード（`-p` フラグ）で `1` に設定すると、最初のクエリの前にプラグインのインストールが完了するまで待機します。これを設定しない場合、プラグインはバックグラウンドでインストールされ、最初のターンでは利用できないことがあります。待機時間を制限するには、`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` と組み合わせてください |400| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 非対話モード（`-p` フラグ）で `1` に設定すると、最初のクエリの前にプラグインのインストールが完了するのを待ちます。これがない場合、プラグインはバックグラウンドでインストールされ、最初のターンでは利用できない場合があります。待機時間を制限するには `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` と組み合わせてください |

399| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 同期的なプラグインインストールのタイムアウト（ミリ秒）。超過すると、Claude Code はプラグインなしで続行し、エラーをログに記録します。デフォルト値はありません。この変数がない場合、同期的なインストールは完了するまで待機します |401| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 同期的なプラグインインストールのタイムアウト（ミリ秒）。超過すると、Claude Code はプラグインなしで続行し、エラーをログに記録します。デフォルトはありません。この変数がない場合、同期インストールは完了するまで待機します |

400| `CLAUDE_CODE_SYNC_SKILLS` | `-p` フラグを使用した非対話モードで `1` に設定すると、Claude Code はその実行で claude.ai アカウントで有効になっているスキルをダウンロードし、最初のクエリを実行する前に、`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` を上限としてスキルのリストを待機します。ダウンロード自体はバックグラウンドで完了し、Claude はスキルを呼び出す際に、そのスキルのダウンロードを待機します。claude.ai 認証が必要です。claude.ai アカウントでサインインしたターミナルセッションでは、この変数がなくても `~/.claude/skills/synced/` に[これらのスキルをダウンロード](/docs/ja/skills#where-synced-skills-load)し、約 10 分ごとに再同期するため、`-p` の実行で最初のクエリから最新のスキルが必要な場合にのみ設定してください。v2.1.273 より前は、ターミナルセッションはこの変数を設定した `-p` の実行でのみスキルをダウンロードしていました。`synced` フォルダー名は[このダウンロード用に予約されています](/docs/ja/skills#where-skills-live)。v2.1.227 より前は、スキルは `~/.claude/skills/` に直接ダウンロードされていました。Claude Code は、ダウンロードしたスキルに対して、マシン上でその `!` コマンドを実行しないなどの[追加のルールを適用します](/docs/ja/skills#how-synced-skills-behave) |402| `CLAUDE_CODE_SYNC_SKILLS` | `-p` フラグを使用した非対話モードで `1` に設定すると、Claude Code はその実行で claude.ai アカウントに対して有効になっているスキルをダウンロードし、最初のクエリを実行する前に、`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` を上限としてそれらのリストを待ちます。ダウンロード自体はバックグラウンドで完了し、Claude はスキルを呼び出す際にそのスキルのダウンロードを待ちます。claude.ai 認証が必要です。claude.ai アカウントでサインインしたターミナルセッションでは、この変数がなくても、これらのスキルが `~/.claude/skills/synced/` に [ダウンロード](/docs/ja/skills#where-synced-skills-load) され、約 10 分ごとに再同期されます。そのため、`-p` の実行で最初のクエリから最新のスキルが必要な場合にのみ設定してください。v2.1.273 より前は、ターミナルセッションは、この変数を設定した `-p` の実行でのみスキルをダウンロードしていました。`synced` フォルダー名は [このダウンロード用に予約されています](/docs/ja/skills#where-skills-live)。v2.1.227 より前は、スキルは `~/.claude/skills/` に直接ダウンロードされていました。Claude Code は、`!` コマンドをマシン上で実行しないなど、[ダウンロードされたスキルに追加のルール](/docs/ja/skills#how-synced-skills-behave) を適用します |

401| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | [Agent SDK](/docs/ja/agent-sdk/typescript#query-object) で構築されたアプリがスキルを再読み込みするときに、セッションの途中で実行されるスキル再同期のタイムアウト（ミリ秒、デフォルト: 30000）。超過すると、再読み込みはすでに届いたスキルで続行され、残りのダウンロードはバックグラウンドで完了します |403| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | [Agent SDK](/docs/ja/agent-sdk/typescript#query-object) 上に構築されたアプリがスキルを再読み込みする際に、セッションの途中で実行されるスキルの再同期のタイムアウト（ミリ秒、デフォルト: 30000）。超過すると、再読み込みはその時点で届いているスキルで続行され、残りのダウンロードはバックグラウンドで完了します |

402| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS` が設定されている場合に、最初のクエリが初期のスキルリストを待機するタイムアウト（ミリ秒、デフォルト: 5000）。超過すると、最初のクエリはすでに届いたスキルで実行されます。いずれの場合もダウンロードはバックグラウンドで完了し、Claude はスキルを呼び出す際に、そのスキルのダウンロードを待機します |404| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS` が設定されている場合に、最初のクエリが初期のスキルリストを待つタイムアウト（ミリ秒、デフォルト: 5000）。超過すると、最初のクエリはその時点で届いているスキルで実行されます。いずれの場合もダウンロードはバックグラウンドで完了し、Claude はスキルを呼び出す際にそのスキルのダウンロードを待ちます |

403| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | `false` に設定すると、差分出力のシンタックスハイライトを無効にします。色がターミナルの設定と干渉する場合に便利です。コードブロックとファイルプレビューでもハイライトを無効にするには、[`syntaxHighlightingDisabled`](/docs/ja/settings-reference#syntaxhighlightingdisabled) 設定を使用してください |405| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | `false` に設定すると、差分出力のシンタックスハイライトを無効にします。色がターミナルの設定と干渉する場合に便利です。コードブロックやファイルプレビューのハイライトも無効にするには、[`syntaxHighlightingDisabled`](/docs/ja/settings-reference#syntaxhighlightingdisabled) 設定を使用してください |

404| `CLAUDE_CODE_TASK_LIST_ID` | セッション間でタスクリストを共有します。[Task ツールを備えたセッション](/docs/ja/tools-reference#task-tool-availability)で、複数の Claude Code インスタンスに同じ ID を設定すると、共有タスクリストで連携できます。[タスクリスト](/docs/ja/interactive-mode#task-list)を参照してください |406| `CLAUDE_CODE_TASK_LIST_ID` | セッション間でタスクリストを共有します。[Task ツールを持つセッション](/docs/ja/tools-reference#task-tool-availability) で、複数の Claude Code インスタンスに同じ ID を設定すると、共有タスクリストで連携できます。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照してください |

405| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | 非対話セッションが終了時に[エージェントチーム](/docs/ja/agent-teams)の破棄の完了を待機する時間を、ミリ秒単位で上書きします。1000 から 60000 までを受け付けます。範囲外の値は無視され、デフォルトの 10000 が適用されます。Claude Code v2.1.206 以降が必要です |407| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | 非対話セッションが終了時に [エージェントチーム](/docs/ja/agent-teams) の解体完了を待つ時間をミリ秒単位で上書きします。1000 から 60000 を受け付けます。範囲外の値は無視され、デフォルトの 10000 が適用されます。Claude Code v2.1.206 以降が必要です |

406| `CLAUDE_CODE_TMPDIR` | 内部の一時ファイルに使用する一時ディレクトリを上書きします。Claude Code は、Unix ではこのパスに `/claude-{uid}/` を、Windows では `/claude/` を追加します。デフォルト: macOS では `/tmp`、Linux と Windows では `os.tmpdir()`。macOS と Linux では、上書き値が長いパスの場合、一時パスが長すぎると失敗するツールがあるため、[サンドボックス化された](/docs/ja/sandboxing) Bash サブプロセスは、システムデフォルトの下にある短いフォールバックの `$TMPDIR` を受け取ります。サンドボックス化されていない Bash コマンドは、シェルの `$TMPDIR` が設定されている場合はそれを継承します。ネイティブ Windows では、シェルが `$TMPDIR` を設定していない場合、`$TMPDIR` を参照する Bash コマンドは上書き値を受け取り、上書き値を設定していない場合は `%TEMP%` を受け取ります。Claude Code 自身の一時ファイルは常に上書き値を使用します。シェル、ユーザー設定、または管理設定で設定してください。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |408| `CLAUDE_CODE_TMPDIR` | 内部の一時ファイルに使用する一時ディレクトリを上書きします。Claude Code は、Unix ではこのパスに `/claude-{uid}/` を、Windows では `/claude/` を付加します。デフォルト: macOS では `/tmp`、Linux と Windows では `os.tmpdir()`。macOS と Linux では、上書きした値が長いパスの場合、一時パスが長すぎると失敗するツールがあるため、[サンドボックス化](/docs/ja/sandboxing) された Bash サブプロセスはシステムのデフォルトの下にある短いフォールバックの `$TMPDIR` を受け取ります。サンドボックス化されていない Bash コマンドは、シェルの `$TMPDIR` が設定されている場合はそれを継承します。ネイティブ Windows では、シェルが `$TMPDIR` を設定していない場合、`$TMPDIR` を参照する Bash コマンドは上書きした値を受け取り、上書きしていない場合は `%TEMP%` を受け取ります。Claude Code 自身の一時ファイルは常に上書きした値を使用します。シェル、ユーザー設定、または管理設定で設定してください。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |

407| `CLAUDE_CODE_TMUX_TRUECOLOR` | `1` など空でない任意の値に設定すると、tmux 内で 24 ビットのトゥルーカラー出力を許可します。ほとんどのオン/オフ変数とは異なり、**`0` や `false` に設定してもトゥルーカラーは許可されます**。256 色への制限に戻すには、変数の設定を解除してください。tmux は設定しない限りトゥルーカラーのエスケープシーケンスをパススルーしないため、デフォルトでは、`$TMUX` が設定されている場合に Claude Code は 256 色に制限します。`~/.tmux.conf` に `set -ga terminal-overrides ',*:Tc'` を追加した後で、これを設定してください。その他の tmux の設定については、[ターミナルの設定](/docs/ja/terminal-config)を参照してください |409| `CLAUDE_CODE_TMUX_TRUECOLOR` | `1` など空でない任意の値に設定すると、tmux 内で 24 ビットのトゥルーカラー出力を許可します。ほとんどのオン/オフ変数とは異なり、**`0` や `false` に設定してもトゥルーカラーは許可されます**。256 色への制限に戻すには、変数の設定を解除してください。tmux は設定しない限りトゥルーカラーのエスケープシーケンスを通過させないため、デフォルトでは `$TMUX` が設定されている場合、Claude Code は 256 色に制限します。`~/.tmux.conf` に `set -ga terminal-overrides ',*:Tc'` を追加した後にこれを設定してください。その他の tmux 設定については [ターミナルの設定](/docs/ja/terminal-config) を参照してください |

408| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Linux と WSL で、Claude Code が[ツールのメモリ上限から除外する](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl)プロセスの種類（`mcp` や `lsp` など）を、カンマ区切りのリストで設定します。すべての種類に上限を適用するには `none` を、Bash、PowerShell、Monitor ツールのコマンドのみに上限を適用するには `all-new` を設定します。何を列挙しても、Claude Code は Bash、PowerShell、Monitor ツールのコマンドを上限の対象に含めます。Claude Code v2.1.246 以降が必要です |410| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Linux と WSL で、Claude Code が [ツールのメモリ上限から除外する](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl) プロセスの種類を、`mcp` や `lsp` などのカンマ区切りのリストで設定します。`none` に設定するとすべての種類に上限を適用し、`all-new` に設定すると Bash、PowerShell、Monitor ツールのコマンドのみに上限を適用します。リストに何を指定しても、Claude Code は Bash、PowerShell、Monitor ツールのコマンドを上限の対象にします。Claude Code v2.1.246 以降が必要です |

409| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Linux と WSL で、`4G` などのサイズを設定すると、[Bash と PowerShell のツールコマンドが使用できるメモリに上限を設けます](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl)（v2.1.246 以降では Monitor ツールのコマンドも対象です）。サイズは数字のみで記述し、バイト数の場合は数字だけ、それ以外は `K`、`M`、`G`、`T` のサフィックスを付けます。上限をオフにするには `0` または `off` を設定します。Claude Code が起動した最初のプロセスが上限をオンまたはオフにした後は、値を変更すると次に `claude` を起動したときに有効になります。Claude Code v2.1.233 以降が必要です |411| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Linux と WSL で、`4G` などのサイズに設定すると、[Bash と PowerShell ツールのコマンドが使用できるメモリに上限を設けます](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl)。v2.1.246 以降では Monitor ツールのコマンドも対象です。サイズは数字で記述し、数字のみの場合はバイト数、または `K`、`M`、`G`、`T` のサフィックスを付けます。上限をオフにするには `0` または `off` に設定します。Claude Code が起動した最初のプロセスが上限をオンまたはオフにした後は、変更した値は次に `claude` を起動したときに有効になります。Claude Code v2.1.233 以降が必要です |

410| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | [Remote Control](/docs/ja/remote-control) や SDK ホストなどのリモートクライアントに転送するダイアログ、または[保留中のクロスセッションメッセージ](/docs/ja/cross-session-messaging#control-inbound-messages)の承認ダイアログを、Claude Code がキャンセルするまでの期限（ミリ秒）。権限プロンプトと `AskUserQuestion` の質問は独自のフローを使用し、この値の影響を受けません。Claude Code v2.1.236 以降では、無人で実行されている可能性のあるセッションで、セッション途中に表示される [Fable の使用クレジット同意プロンプト](/docs/ja/model-config#fable-and-usage-credits)の期限も設定します。期限が適用されないケースを含む、保留メッセージの有効期限に関する完全なルールについては、[受信メッセージを制御する](/docs/ja/cross-session-messaging#control-inbound-messages)と[非対話セッション](/docs/ja/cross-session-messaging#non-interactive-sessions)を参照してください。[`dialogExpiry`](/docs/ja/settings-reference#dialogexpiry) 設定を上書きします。`0` または負の値を指定すると、期限が無効になります |412| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | `1` に設定すると、長時間の `-p` または Agent SDK セッションの [トランスクリプトファイル](/docs/ja/sessions#where-transcripts-are-stored) が大きくなりすぎないように制限します。コンテキスト圧縮のたびに、ファイルが 5 MB を超えている場合、Claude Code はその圧縮より前の履歴を削除します。ファイルが切り詰められたかどうかに関係なく、セッションを再開すると同じ会話が復元されます。設定の `env` ブロックではこれをオンにできないため、Claude Code を起動する環境で設定してください。Claude Code v2.1.287 以降が必要です |

413| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Claude Code が [Remote Control](/docs/ja/remote-control) や SDK ホストなどのリモートクライアントに転送するダイアログ、または [保留中のセッション間メッセージ](/docs/ja/cross-session-messaging#control-inbound-messages) の承認ダイアログを Claude Code がキャンセルするまでの期限（ミリ秒）。権限プロンプトと `AskUserQuestion` の質問は独自のフローを使用するため、これの対象外です。Claude Code v2.1.236 以降では、無人で実行されている可能性のあるセッションで、セッション途中の [Fable 使用クレジットの同意プロンプト](/docs/ja/model-config#fable-and-usage-credits) にも期限を設けます。期限が適用されないケースを含む、保留中のメッセージの有効期限に関する完全なルールについては、[受信メッセージを制御する](/docs/ja/cross-session-messaging#control-inbound-messages) と [非対話セッション](/docs/ja/cross-session-messaging#non-interactive-sessions) を参照してください。[`dialogExpiry`](/docs/ja/settings-reference#dialogexpiry) 設定を上書きします。`0` または負の値で期限を無効にします |

415| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | `1` に設定すると、ripgrep の代わりに Node.js のファイル API を使用して、カスタムコマンド、サブエージェント、出力スタイルを検出します。バンドルされた ripgrep バイナリが環境で利用できない場合やブロックされている場合に設定してください。Grep ツールやファイル検索ツールには影響しません |418| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | `1` に設定すると、ripgrep の代わりに Node.js のファイル API を使用して、カスタムコマンド、サブエージェント、出力スタイルを検出します。バンドルされた ripgrep バイナリが利用できない、または環境でブロックされている場合に設定してください。Grep やファイル検索ツールには影響しません |

416| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | PowerShell ツールを制御します。Git Bash のない Windows では、ツールは自動的に有効になります。無効にするには `0` に設定します。Git Bash がインストールされた Windows では、claude.ai アカウントと Console アカウントではデフォルトでオンです。Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry のセッションで有効にするには `1` に、オフにするには `0` に設定します。Linux、macOS、WSL では、有効にするには `1` に設定します。これには `PATH` 上に `pwsh` が必要です。Windows で有効にすると、Claude は Git Bash を経由せずに PowerShell コマンドをネイティブに実行できます。[PowerShell ツール](/docs/ja/tools-reference#powershell-tool)を参照してください |419| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | PowerShell ツールを制御します。Git Bash のない Windows では、ツールは自動的に有効になります。無効にするには `0` に設定します。Git Bash がインストールされている Windows では、claude.ai と Console のアカウントではツールがデフォルトでオンです。Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry のセッションで有効にするには `1` に、オフにするには `0` に設定します。Linux、macOS、WSL では、有効にするには `1` に設定します。これには `PATH` 上に `pwsh` が必要です。Windows で有効にすると、Claude は Git Bash を経由せずに PowerShell コマンドをネイティブに実行できます。[PowerShell ツール](/docs/ja/tools-reference#powershell-tool) を参照してください |

418| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) が取得した各 URL のレスポンスをキャッシュしておく時間を、ミリ秒数で設定します。デフォルトは `900000`（15 分）です。数字のみを受け付けます。`0`、小数、その他の表記ではデフォルトが維持されます。Claude Code は起動ごとに値を 1 回だけ読み取るため、設定の `env` ブロックでの変更は、次に `claude` を起動したときに適用されます。Claude Code v2.1.233 以降が必要です |421| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) が取得した各 URL のレスポンスをキャッシュしておく時間をミリ秒単位で設定します。デフォルトは `900000`（15 分）です。数字のみを受け付け、`0`、小数、その他の表記ではデフォルトのままになります。Claude Code は起動ごとに値を 1 回読み込むため、設定の `env` ブロックでの変更は次回 `claude` を起動したときに適用されます。Claude Code v2.1.233 以降が必要です |

419| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) がページのダウンロード（追跡するリダイレクトを含む）を待機する時間の上限（ミリ秒）。それまでに完了しないダウンロードは、期限エラーで失敗します。デフォルトは `300000`（5 分）です。制限をなくすには `0` に設定します。数字のみを受け付けます。小数やその他の表記ではデフォルトが維持されます。Claude Code v2.1.268 以降が必要です |422| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) がページのダウンロード（たどるリダイレクトを含む）を待つ時間の上限（ミリ秒）。それまでに完了しないダウンロードは期限エラーで失敗します。デフォルトは `300000`（5 分）です。`0` に設定すると制限がなくなります。数字のみを受け付け、小数やその他の表記ではデフォルトのままになります。Claude Code v2.1.268 以降が必要です |

420| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | 1 回の[ワークフロー](/docs/ja/workflows)実行で同時に実行するエージェント数（`1` から `256`）。デフォルトでは、1 回の実行で最大 16 個のエージェントを同時に実行し、Claude Code が利用できる CPU が少ない場合はそれより少なくなります。キューに入った `agent()` 呼び出しは空きスロットを待ちます。実行中の各エージェントのトランスクリプトは Claude Code のメモリに保持されるため、値を大きくするとメモリ使用量が増えます。数字のみを受け付けます。範囲外の値やその他の表記ではデフォルトが維持されます。Claude Code v2.1.269 以降が必要です |423| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | `CLAUDE_AUTO_BACKGROUND_TASKS` が `1` に設定されている場合に、まだ実行中の[バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)の状況を確認するよう Claude にリマインドするまで Claude Code が待つ時間。`1` から `86400` までの整数秒で、`600` や `600,1800,3600` のようにカンマ区切りで 1 つ以上の待機時間を指定します。各値は次のリマインダーまでの待機時間で、最後の値が繰り返されます。数字のみを受け付け、その他の値や表記は未設定として扱われます。未設定の場合、リマインダーは送られません。Claude Code v2.1.283 以降が必要です |

421| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | [ワークフロー](/docs/ja/workflows)エージェントが自身の最初のリクエストを送信する前に、同じプレフィックスを持つ兄弟エージェントの最初のレスポンスが始まるのを待つ時間の上限（ミリ秒）。ファンアウトで[プロンプトキャッシュのプレフィックス](/docs/ja/workflows#prompt-caching-in-a-fan-out)を共有する複数のエージェントを起動すると、Claude Code は最初のエージェント以外を最大この時間だけ待機させ、残りのエージェントがそれぞれキャッシュなしでプレフィックスを処理するのではなく、キャッシュされたプレフィックスを読み取れるようにします。デフォルトは `5000` です。`0` に設定すると待機を無効にします。`DISABLE_PROMPT_CACHING` が設定されている場合、エージェントは待機しません。Claude Code v2.1.229 以降が必要です |424| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | 1 回の[ワークフロー](/docs/ja/workflows)実行で同時に実行するエージェントの数（`1` から `256`）。デフォルトでは、1 回の実行で最大 16 個のエージェントを同時に実行し、Claude Code が利用できる CPU が少ない場合はそれより少なくなります。キューに入った `agent()` 呼び出しは空きスロットを待ちます。実行中の各エージェントのトランスクリプトは Claude Code のメモリに保持されるため、値を大きくするとメモリ使用量が増えます。数字のみを受け付け、範囲外の値やその他の表記ではデフォルトのままになります。Claude Code v2.1.269 以降が必要です |

422| `CLAUDE_CONFIG_DIR` | 設定ディレクトリを上書きします（デフォルト: `~/.claude`）。すべての設定、セッション履歴、プラグインはこのパスの下に保存されます。認証情報については、[Claude Code が認証情報を保存する場所](/docs/ja/authentication#credential-management)を参照してください。複数のアカウントを並行して実行する場合に便利です。例: `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`。シェル、ユーザー設定、または管理設定で設定してください。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |425| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | [ワークフロー](/docs/ja/workflows)のエージェントが、自身の最初のリクエストを送信する前に、同じプレフィックスを持つ兄弟エージェントの最初の応答が始まるのを待つ時間の上限（ミリ秒）。ファンアウトで[プロンプトキャッシュのプレフィックス](/docs/ja/workflows#prompt-caching-in-a-fan-out)を共有する複数のエージェントを開始する場合、Claude Code は最初のエージェント以外を最大この時間だけ保留し、残りのエージェントがそれぞれキャッシュなしでプレフィックスを処理する代わりに、キャッシュされたプレフィックスを読み取れるようにします。デフォルトは `5000` です。`0` に設定すると待機を無効にします。`DISABLE_PROMPT_CACHING` が設定されている場合、エージェントは待機しません。Claude Code v2.1.229 以降が必要です |

423| `CLAUDE_DISABLE_ADOPT` | `1` に設定すると、`←` を押すか [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラウンドに移したときに、実行中のバックグラウンド作業を引き継がずに停止します。Claude Code はバックグラウンドに移す前に確認を求め、その後、本来引き継がれるはずのタスクを停止します。Claude Code v2.1.195 以降が必要です |426| `CLAUDE_CONFIG_DIR` | 設定ディレクトリを上書きします（デフォルト: `~/.claude`）。すべての設定、セッション履歴、プラグインはこのパスの下に保存されます。認証情報については、[Claude Code が認証情報を保存する場所](/docs/ja/authentication#credential-management)を参照してください。複数のアカウントを並行して使用する場合に便利です。例: `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`。シェル、ユーザー設定、または管理設定で設定します。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |

424| `CLAUDE_EFFORT` | Bash ツールのサブプロセスとフックコマンドで、サブプロセス開始時に有効な [effort レベル](/docs/ja/model-config#adjust-effort-level)（`low`、`medium`、`high`、`xhigh`、`max`）に自動的に設定されます。[フック](/docs/ja/hooks)に渡される `effort.level` フィールドと一致します。現在のモデルが effort パラメータをサポートしている場合にのみ設定されます |427| `CLAUDE_DISABLE_ADOPT` | `1` に設定すると、`←` を押すか [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラウンドに移したときに、実行中のバックグラウンド作業を引き継ぐ代わりに停止します。Claude Code はバックグラウンドに移す前に確認を求め、その後、本来引き継がれるはずだったタスクを停止します。Claude Code v2.1.195 以降が必要です |

425| `CLAUDE_ENABLE_BYTE_WATCHDOG` | `1` に設定するとバイトレベルのストリーミングアイドルウォッチドッグを強制的に有効にし、`0` に設定すると強制的に無効にします。`0` は、[最初のバイトの期限](/docs/ja/network-config#streaming-idle-watchdogs)が適用される接続でその期限もオフにします。未設定の場合、ウォッチドッグは Anthropic API への直接接続と [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) 接続、および `ANTHROPIC_BASE_URL` または `ANTHROPIC_AWS_BASE_URL` 経由で到達する[ゲートウェイ](/docs/ja/gateways)接続のストリーミングレスポンスで、デフォルトで有効になります。v2.1.222 より前はこれらのゲートウェイ接続では実行されなかったため、キープアライブ ping が届いている間でもイベントレベルのウォッチドッグがストールを報告することがありました。タイムアウトとタイマー間の相互作用については、[ストリーミングアイドルウォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)を参照してください |428| `CLAUDE_EFFORT` | Bash ツールのサブプロセスとフックコマンドで、サブプロセスの開始時に有効な [effort レベル](/docs/ja/model-config#adjust-effort-level)（`low`、`medium`、`high`、`xhigh`、または `max`）に自動的に設定されます。[フック](/docs/ja/hooks)に渡される `effort.level` フィールドと一致します。現在のモデルが effort パラメータをサポートしている場合にのみ設定されます |

429| `CLAUDE_ENABLE_BYTE_WATCHDOG` | `1` に設定するとバイトレベルのストリーミングアイドルウォッチドッグを強制的に有効にし、`0` に設定すると強制的に無効にします。`0` は、[最初のバイトの期限](/docs/ja/network-config#streaming-idle-watchdogs)が適用される接続で、その期限もオフにします。未設定の場合、ウォッチドッグは Anthropic API への直接接続と [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) 接続、および `ANTHROPIC_BASE_URL` または `ANTHROPIC_AWS_BASE_URL` を介して到達する[ゲートウェイ](/docs/ja/gateways)接続のストリーミングレスポンスで、デフォルトで有効になります。v2.1.222 より前はそれらのゲートウェイ接続では実行されなかったため、キープアライブ ping が届いている間でも、イベントレベルのウォッチドッグがそこで停止を報告することがありました。タイムアウトとタイマー同士の相互作用については、[ストリーミングアイドルウォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)を参照してください |

426| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | `1` に設定すると、Amazon Bedrock の `vnd.amazon.eventstream` レスポンスでバイトレベルのストリーミングアイドルウォッチドッグを有効にします。これにより、Bedrock のストリーミングリクエストで[最初のバイトの期限](/docs/ja/network-config#streaming-idle-watchdogs)も有効になります。デフォルトではオフです。タイムアウトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定します |430| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | `1` に設定すると、Amazon Bedrock の `vnd.amazon.eventstream` レスポンスでバイトレベルのストリーミングアイドルウォッチドッグを有効にします。これにより、Bedrock のストリーミングリクエストで[最初のバイトの期限](/docs/ja/network-config#streaming-idle-watchdogs)も有効になります。デフォルトではオフです。タイムアウトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定します |

427| `CLAUDE_ENABLE_STREAM_WATCHDOG` | `0` に設定するとイベントレベルのストリーミングアイドルウォッチドッグを強制的に無効にし、`1` に設定すると強制的に有効にします。未設定の場合、ウォッチドッグはすべてのプロバイダーでデフォルトでオンです。v2.1.196 より前は、未設定時のデフォルトは Anthropic API への直接接続ではサーバー側で制御され、その他のプロバイダーではオフでした。タイムアウトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定します。これと並行して動作する他のストール検出タイマーについては、[ストリーミングアイドルウォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)を参照してください |431| `CLAUDE_ENABLE_STREAM_WATCHDOG` | `0` に設定するとイベントレベルのストリーミングアイドルウォッチドッグを強制的に無効にし、`1` に設定すると強制的に有効にします。未設定の場合、ウォッチドッグはすべてのプロバイダーでデフォルトでオンです。v2.1.196 より前は、未設定時のデフォルトは Anthropic API への直接接続ではサーバー側で制御され、その他のプロバイダーではオフでした。タイムアウトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定します。これと並行して動作するその他の停止タイマーについては、[ストリーミングアイドルウォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)を参照してください |

428| `CLAUDE_ENV_FILE` | Claude Code が各 Bash コマンドの前に同じシェルプロセス内で実行するシェルスクリプトのパス。ファイル内の export はコマンドから参照できます。virtualenv や conda のアクティベーションをコマンド間で維持するために使用します。[SessionStart](/docs/ja/hooks#persist-environment-variables)、[Setup](/docs/ja/hooks#setup)、[CwdChanged](/docs/ja/hooks#cwdchanged)、[FileChanged](/docs/ja/hooks#filechanged) フックによっても動的に設定されます |432| `CLAUDE_ENV_FILE` | Claude Code が各 Bash コマンドの前に同じシェルプロセスで内容を実行するシェルスクリプトへのパス。ファイル内のエクスポートはコマンドから参照できます。virtualenv や conda のアクティベーションをコマンド間で維持するために使用します。[SessionStart](/docs/ja/hooks#persist-environment-variables)、[Setup](/docs/ja/hooks#setup)、[CwdChanged](/docs/ja/hooks#cwdchanged)、[FileChanged](/docs/ja/hooks#filechanged) フックによっても動的に設定されます |

429| `CLAUDE_JOB_DIR` | 各[バックグラウンドセッション](/docs/ja/agent-view)で、Claude Code がそのセッションの `~/.claude/jobs/<id>` ディレクトリに設定します。セッションが実行するシェルコマンドはこれを継承します。一時ファイルは [`$CLAUDE_JOB_DIR/tmp`](/docs/ja/agent-view#where-state-is-stored) に書き込んでください。そこへの Claude の `Write` および `Edit` 呼び出しでは権限を求められず、ディレクトリはセッションが削除されると削除されます |433| `CLAUDE_JOB_DIR` | 各[バックグラウンドセッション](/docs/ja/agent-view)で、Claude Code がそのセッションの `~/.claude/jobs/<id>` ディレクトリに設定します。セッションが実行するシェルコマンドはこれを継承します。一時ファイルは [`$CLAUDE_JOB_DIR/tmp`](/docs/ja/agent-view#where-state-is-stored) に書き込みます。そこへの Claude の `Write` および `Edit` 呼び出しでは権限の確認が求められず、ディレクトリはセッションの削除時に削除されます |

430| `CLAUDE_PID` | Claude Code は、自身が生成するサブプロセス（Bash および PowerShell ツールのコマンドとフックコマンド）で、これを自身のプロセス ID に設定します。Linux では、Bash ツールのシェル統合がこれを使用して、Claude Code プロセス自体に一致する `pkill` パターンを拒否します。[エラーリファレンス](/docs/ja/errors#pkill-pattern-matches-the-claude-code-process)を参照してください。独自のスクリプトからこれを読み取ることで、親の Claude Code プロセスを意図的に特定したり、シグナルを送ったりできます。Claude Code v2.1.214 以降が必要です |434| `CLAUDE_PID` | Claude Code は、自身が起動するサブプロセス（Bash および PowerShell ツールのコマンドとフックコマンド）で、これを自身のプロセス ID に設定します。Linux では、Bash ツールのシェル統合がこれを使用して、Claude Code プロセス自体に一致してしまう `pkill` パターンを拒否します。[エラーリファレンス](/docs/ja/errors#pkill-pattern-matches-the-claude-code-process)を参照してください。独自のスクリプトからこれを読み取ると、親の Claude Code プロセスを意図的に特定したり、シグナルを送ったりできます。Claude Code v2.1.214 以降が必要です |

431| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 明示的な名前が指定されていない場合に自動生成される [Remote Control](/docs/ja/remote-control) セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` のような名前になります。`--remote-control-session-name-prefix` CLI フラグは、1 回の呼び出しに対して同じ値を設定します |435| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 明示的な名前が指定されていない場合に自動生成される [Remote Control](/docs/ja/remote-control) セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` のような名前になります。`--remote-control-session-name-prefix` CLI フラグは、1 回の呼び出しに対して同じ値を設定します |

432| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | [最初のバイトの期限](/docs/ja/network-config#streaming-idle-watchdogs)が適用される接続における、ストリーミングリクエストの最初のレスポンスバイトの期限（ミリ秒）。Claude Code がこの値をどのように制限するか、大きなリクエストボディに対して追加する時間、この変数を未設定にした場合の期限の決定方法については、[No response from API](/docs/ja/errors#no-response-from-api) を参照してください。Claude Code v2.1.242 以降が必要です |436| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | [最初のバイトの期限](/docs/ja/network-config#streaming-idle-watchdogs)が適用される接続で、ストリーミングリクエストの最初のレスポンスバイトを待つ期限（ミリ秒）。Claude Code がこの値をどのように制限するか、大きなリクエストボディに対して追加する時間、未設定の場合に期限をどのように選択するかについては、[No response from API](/docs/ja/errors#no-response-from-api) を参照してください。Claude Code v2.1.242 以降が必要です |

433| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | イベントレベルおよびバイトレベルのストリーミングアイドルウォッチドッグが停止した接続を閉じるまでのタイムアウト（ミリ秒）。この変数を明示的に設定する場合、最小値は `300000`（5 分）です。拡張思考の一時停止やプロキシのバッファリングを吸収するため、これより小さい値は通知なしに切り上げられ、バイトレベルのウォッチドッグでは値の上限が 30 分になります。バイトレベルのウォッチドッグについては、`CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` がこの変数より優先されます。ウォッチドッグごとの未設定時のデフォルトについては、[ストリーミングアイドルウォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)を参照してください |437| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | イベントレベルおよびバイトレベルのストリーミングアイドルウォッチドッグが停止した接続を閉じるまでのタイムアウト（ミリ秒）。この変数を明示的に設定する場合、最小値は `300000`（5 分）です。拡張思考による一時停止やプロキシのバッファリングを吸収するため、それより小さい値は通知なしに切り上げられます。また、バイトレベルのウォッチドッグは値を 30 分に制限します。バイトレベルのウォッチドッグでは、`CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` がこの変数より優先されます。ウォッチドッグごとの未設定時のデフォルトについては、[ストリーミングアイドルウォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)を参照してください |

434| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | v2.1.260 で削除され、現在は何の効果もありません。以前は、[サブエージェント](/docs/ja/sub-agents)が開始した[バックグラウンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands)を実行できる時間の上限をミリ秒単位で設定していました（デフォルトは 60 分）。[バックグラウンドコマンドの存続期間のルール](/docs/ja/tools-reference#background-commands)を参照してください |438| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | v2.1.260 で削除され、現在は何もしません。以前は、[サブエージェント](/docs/ja/sub-agents)が開始した[バックグラウンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands)を実行できる時間の上限をミリ秒単位で設定していました（デフォルトは 60 分）。[バックグラウンドコマンドの存続期間のルール](/docs/ja/tools-reference#background-commands)を参照してください |

435| `DEBUG` | `1` に設定するとデバッグモードを有効にします。[`--debug`](/docs/ja/cli-reference#cli-flags) を付けて起動するのと同等です。デバッグログは `~/.claude/debug/<session-id>.txt`、または `CLAUDE_CODE_DEBUG_LOGS_DIR` で設定したパスに書き込まれます。デバッグモードを有効にするのは真値 `1`、`true`、`yes`、`on` のみであるため、他のツール向けに設定された `DEBUG=express:*` のような名前空間パターンではトリガーされません |439| `DEBUG` | `1` に設定するとデバッグモードを有効にします。[`--debug`](/docs/ja/cli-reference#cli-flags) を指定して起動するのと同じです。デバッグログは `~/.claude/debug/<session-id>.txt`、または `CLAUDE_CODE_DEBUG_LOGS_DIR` で設定したパスに書き込まれます。デバッグモードを有効にするのは真を表す値 `1`、`true`、`yes`、`on` のみのため、他のツール向けに設定された `DEBUG=express:*` のような名前空間パターンではデバッグモードは有効になりません |

436| `DISABLE_AUTOUPDATER` | `1` に設定すると、バックグラウンドでの自動更新を無効にします。手動の `claude update` は引き続き動作します。両方をブロックするには `DISABLE_UPDATES` を使用します |440| `DISABLE_AUTOUPDATER` | `1` に設定すると、バックグラウンドでの自動更新を無効にします。手動の `claude update` は引き続き機能します。両方をブロックするには `DISABLE_UPDATES` を使用します |

437| `DISABLE_AUTO_COMPACT` | `1` に設定すると、コンテキスト上限に近づいたときの自動コンテキスト圧縮を無効にします。手動の `/compact` コマンドは引き続き使用できます。圧縮を実行するタイミングを明示的に制御したい場合に使用します。[`autoCompactEnabled`](/docs/ja/settings-reference#autocompactenabled) 設定を上書きします |441| `DISABLE_AUTO_COMPACT` | `1` に設定すると、コンテキストの上限に近づいたときの自動的なコンテキスト圧縮を無効にします。手動の `/compact` コマンドは引き続き使用できます。圧縮が行われるタイミングを明示的に制御したい場合に使用します。[`autoCompactEnabled`](/docs/ja/settings-reference#autocompactenabled) 設定を上書きします |

440| `DISABLE_DOCTOR_COMMAND` | `1` に設定すると、[`/doctor`](/docs/ja/commands#all-commands) セットアップチェックアップスキルとそのエイリアス `/checkup` を非表示にします。ユーザーがセッションからセットアップ診断を実行すべきでない管理されたデプロイで便利です。`claude doctor` ターミナルコマンドには影響しません。v2.1.205 より前は、この変数は `/doctor` 診断画面コマンドを非表示にしていました |444| `DISABLE_DOCTOR_COMMAND` | `1` に設定すると、[`/doctor`](/docs/ja/commands#all-commands) セットアップチェックアップスキルとその `/checkup` エイリアスを非表示にします。ユーザーがセッションからセットアップ診断を実行すべきでない管理された導入環境で便利です。`claude doctor` ターミナルコマンドには影響しません。v2.1.205 より前は、この変数は `/doctor` 診断画面コマンドを非表示にしていました |

441| `DISABLE_ERROR_REPORTING` | `1` などの空でない任意の値に設定すると、エラーレポートをオプトアウトします。ほとんどのオン/オフ変数とは異なり、**`0` または `false` に設定してもオプトアウトされます**。エラーレポートを再びオンにするには、変数の設定を解除してください |445| `DISABLE_ERROR_REPORTING` | `1` などの空でない任意の値に設定すると、エラーレポートをオプトアウトします。ほとんどのオン/オフ変数とは異なり、**`0` または `false` に設定してもオプトアウトされます**。エラーレポートを再びオンにするには、変数の設定を解除してください |

443| `DISABLE_FEEDBACK_COMMAND` | `1` に設定すると、`/feedback` コマンドと [Claude が下書きするフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を無効にします。同じ経路で報告する `/bug` と `/share` も無効になります。v2.1.212 より前はこれらが `/feedback` のエイリアスだったため、どの名前でもコマンドが無効になっていました。古い名前の `DISABLE_BUG_COMMAND` も受け付けられます |447| `DISABLE_FEEDBACK_COMMAND` | `1` に設定すると、`/feedback` コマンドと [Claude が下書きするフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を無効にします。同じ経路で報告する `/bug` と `/share` も無効になります。v2.1.212 より前はこれらが `/feedback` のエイリアスだったため、どの名前でもコマンドが無効になっていました。旧名の `DISABLE_BUG_COMMAND` も受け付けられます |

444| `DISABLE_GROWTHBOOK` | `1` または `true` に設定すると、GrowthBook の機能フラグの取得を無効にし、すべてのフラグでコードのデフォルトを使用します。これにより、[Remote Control](/docs/ja/remote-control#requirements) やその他の[機能フラグの取得を必要とする機能](#features-that-need-feature-flag-fetching)が利用できなくなります。`0` または `false` に設定すると、取得はオンのままです。`DISABLE_TELEMETRY` も設定しない限り、テレメトリイベントのログ記録はオンのままです |448| `DISABLE_GROWTHBOOK` | `1` または `true` に設定すると、GrowthBook の機能フラグの取得を無効にし、すべてのフラグでコード上のデフォルトを使用します。これにより、[Remote Control](/docs/ja/remote-control#requirements) やその他の[機能フラグの取得を必要とする機能](#features-that-need-feature-flag-fetching)が利用できなくなります。`0` または `false` に設定すると、取得はオンのままです。`DISABLE_TELEMETRY` も設定しない限り、テレメトリのイベントのログ記録はオンのままです |

445| `DISABLE_INSTALLATION_CHECKS` | `1` に設定すると、インストールに関する警告を無効にします。標準的なインストールの問題を隠してしまう可能性があるため、インストール場所を手動で管理している場合にのみ使用してください |449| `DISABLE_INSTALLATION_CHECKS` | `1` に設定すると、インストールに関する警告を無効にします。標準的なインストールの問題が隠れてしまう可能性があるため、インストール場所を手動で管理する場合にのみ使用してください |

446| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | `1` に設定すると、`/install-github-app` コマンドを非表示にします。サードパーティプロバイダー（Amazon Bedrock、Google Cloud's Agent Platform、または Microsoft Foundry）を使用している場合は、すでに非表示になっています |450| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | `1` に設定すると、`/install-github-app` コマンドを非表示にします。サードパーティプロバイダー（Amazon Bedrock、Google Cloud's Agent Platform、または Microsoft Foundry）を使用している場合は、すでに非表示になっています |

447| `DISABLE_INTERLEAVED_THINKING` | `1` に設定すると、interleaved-thinking ベータヘッダーの送信を防ぎます。LLM ゲートウェイまたはプロバイダーが[インターリーブ思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking)をサポートしていない場合に便利です |451| `DISABLE_INTERLEAVED_THINKING` | `1` に設定すると、interleaved-thinking ベータヘッダーを送信しないようにします。LLM ゲートウェイやプロバイダーが[インターリーブ思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking)をサポートしていない場合に便利です |

450| `DISABLE_PROMPT_CACHING` | `1` に設定すると、すべてのモデルで[プロンプトキャッシュ](/docs/ja/prompt-caching#disable-prompt-caching)を無効にします（モデルごとの設定より優先されます） |454| `DISABLE_PROMPT_CACHING` | `1` に設定すると、すべてのモデルで[プロンプトキャッシュ](/docs/ja/prompt-caching#disable-prompt-caching)を無効にします（モデルごとの設定より優先されます） |

452| `DISABLE_PROMPT_CACHING_HAIKU` | `1` に設定すると、実行場所を問わず[デフォルトの Haiku モデル](/docs/ja/prompt-caching#disable-prompt-caching)のプロンプトキャッシュを無効にします |456| `DISABLE_PROMPT_CACHING_HAIKU` | `1` に設定すると、実行場所にかかわらず、[デフォルトの Haiku モデル](/docs/ja/prompt-caching#disable-prompt-caching)のプロンプトキャッシュを無効にします |

453| `DISABLE_PROMPT_CACHING_OPUS` | `1` に設定すると、[デフォルトの Opus モデル](/docs/ja/prompt-caching#disable-prompt-caching)のプロンプトキャッシュを無効にします |457| `DISABLE_PROMPT_CACHING_OPUS` | `1` に設定すると、[デフォルトの Opus モデル](/docs/ja/prompt-caching#disable-prompt-caching)のプロンプトキャッシュを無効にします |

454| `DISABLE_PROMPT_CACHING_SONNET` | `1` に設定すると、[デフォルトの Sonnet モデル](/docs/ja/prompt-caching#disable-prompt-caching)のプロンプトキャッシュを無効にします |458| `DISABLE_PROMPT_CACHING_SONNET` | `1` に設定すると、[デフォルトの Sonnet モデル](/docs/ja/prompt-caching#disable-prompt-caching)のプロンプトキャッシュを無効にします |

455| `DISABLE_TELEMETRY` | `1` などの空でない任意の値に設定すると、テレメトリをオプトアウトします。ほとんどのオン/オフ変数とは異なり、**`0` または `false` に設定してもオプトアウトされます**。テレメトリを再びオンにするには、変数の設定を解除してください。テレメトリイベントには、コード、ファイルパス、Bash コマンドなどのユーザーデータは含まれません。[機能フラグの取得](#features-that-need-feature-flag-fetching)も無効になります。[組織のテレメトリをオフにする](/docs/ja/managed-settings#turn-telemetry-off-for-your-organization)を参照してください |459| `DISABLE_TELEMETRY` | `1` などの空でない任意の値に設定すると、テレメトリをオプトアウトします。ほとんどのオン/オフ変数とは異なり、**`0` または `false` に設定してもオプトアウトされます**。テレメトリを再びオンにするには、変数の設定を解除してください。テレメトリイベントには、コード、ファイルパス、Bash コマンドなどのユーザーデータは含まれません。[機能フラグの取得](#features-that-need-feature-flag-fetching)も無効になります。[組織のテレメトリをオフにする](/docs/ja/managed-settings#turn-telemetry-off-for-your-organization)を参照してください |

456| `DISABLE_UPDATES` | `1` に設定すると、手動の `claude update` と `claude install` を含むすべての更新をブロックします。`DISABLE_AUTOUPDATER` より厳格です。独自の配布経路で Claude Code を配布しており、ユーザーに自己更新させるべきでない場合に使用します |460| `DISABLE_UPDATES` | `1` に設定すると、手動の `claude update` と `claude install` を含むすべての更新をブロックします。`DISABLE_AUTOUPDATER` より厳格です。Claude Code を独自の経路で配布しており、ユーザーが自分で更新すべきでない場合に使用します |

458| `DO_NOT_TRACK` | `1` に設定すると、テレメトリをオプトアウトします。[機能フラグの取得](#features-that-need-feature-flag-fetching)への影響も含め、`DISABLE_TELEMETRY` と同じ効果があります。Claude Code はこの変数を標準的なブール値として読み取るため、`0` ではテレメトリはオンのままです。また、多くの開発者向け CLI が認識するツール横断の慣例として、この変数を尊重します |462| `DO_NOT_TRACK` | `1` に設定すると、テレメトリをオプトアウトします。[機能フラグの取得](#features-that-need-feature-flag-fetching)への影響も含め、効果は `DISABLE_TELEMETRY` と同じです。Claude Code はこの変数を標準的なブール値として読み取るため、`0` ではテレメトリはオンのままです。また、多くの開発者向け CLI が認識するツール横断の慣例として、この変数を尊重します |

459| `ENABLE_BETA_TRACING_DETAILED` | `BETA_TRACING_ENDPOINT` とあわせて `1` に設定すると、[詳細なベータトレース](/docs/ja/monitoring-usage#traces-beta)をオンにします。これにより、コンテンツを含むスパン属性と `claude_code.hook` スパンが追加されます。対話型 CLI セッションでは、組織がベータの許可リストに登録されている必要もあります。どちらの変数も[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |463| `ENABLE_BETA_TRACING_DETAILED` | `BETA_TRACING_ENDPOINT` とともに `1` に設定すると、[詳細なベータトレース](/docs/ja/monitoring-usage#traces-beta)をオンにします。これにより、コンテンツを含むスパン属性と `claude_code.hook` スパンが追加されます。対話型の CLI セッションでは、組織がベータの許可リストに登録されている必要もあります。どちらの変数も[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |

460| `ENABLE_CLAUDEAI_MCP_SERVERS` | `false` に設定すると、Claude Code が [claude.ai MCP サーバー](/docs/ja/mcp#use-mcp-servers-from-claude-ai)を取得しないようにします。ログインしているユーザーではデフォルトで有効です。プロジェクトごとまたは組織ごとに無効にするには、代わりに設定で [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) を設定してください |464| `ENABLE_CLAUDEAI_MCP_SERVERS` | `false` に設定すると、Claude Code が [claude.ai の MCP サーバー](/docs/ja/mcp#use-mcp-servers-from-claude-ai)を取得しないようにします。ログインしているユーザーではデフォルトで有効です。プロジェクト単位または組織単位で無効にするには、代わりに設定で [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) を設定してください |

461| `ENABLE_PROMPT_CACHING_1H` | `1` に設定すると、デフォルトの 5 分ではなく 1 時間の[プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) をリクエストします。API キー、[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud's Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のユーザー向けです。含まれる使用量の範囲内のサブスクリプションユーザーは、[メインの会話](/docs/ja/prompt-caching#which-ttl-each-request-gets)で 1 時間の TTL を自動的に受け取ります。[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を消費しているサブスクリプションユーザーは、これを設定することで 1 時間の TTL を維持できます。1 時間のキャッシュ書き込みはより高い料金で課金されます。代わりにリクエストの区分ごとに TTL を選択するには、`CLAUDE_CODE_PROMPT_CACHE_TTL` と `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` を使用してください。これらはこの変数より優先されます |465| `ENABLE_PROMPT_CACHING_1H` | `1` に設定すると、デフォルトの 5 分ではなく 1 時間の[プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) をリクエストします。API キー、[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud's Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のユーザー向けです。含まれる使用量の範囲内のサブスクリプションユーザーは、[メインの会話](/docs/ja/prompt-caching#which-ttl-each-request-gets)で自動的に 1 時間の TTL を受け取ります。[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を利用しているサブスクリプションユーザーは、これを設定すると 1 時間の TTL を維持できます。1 時間のキャッシュ書き込みは、より高い料金で課金されます。代わりにリクエストの区分ごとに TTL を選択するには、この変数より優先される `CLAUDE_CODE_PROMPT_CACHE_TTL` と `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` を使用してください |

463| `ENABLE_TOOL_SEARCH` | [MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search)を制御します。未設定の場合、Claude Code はデフォルトですべての MCP ツールを遅延読み込みします。ただし、Claude 4.5 世代より前の Google Cloud's Agent Platform のモデル、Azure でホストされる Microsoft Foundry デプロイ、および `ANTHROPIC_BASE_URL` がファーストパーティ以外のホストを指している場合は、引き続き事前に読み込みます。`true` は常に遅延読み込みしてベータヘッダーを送信しますが、同じ Agent Platform のモデルと Microsoft Foundry デプロイは例外です。`tool_reference` をサポートしないプロキシではリクエストが失敗します。`auto` は、ツール定義がコンテキストの 10% 以内に収まる場合に事前に読み込みます。`auto:N` はカスタムのしきい値を設定します（例: 5% の場合は `auto:5`）。`false` はすべてのツールを事前に読み込みます。`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` が設定されている場合、自分で設定した値は無視されます。v2.1.221 より前は、この変数を `true` に設定しない限り、Claude Code は Google Cloud's Agent Platform 上のすべてのモデルでツール検索を無効にしていました |467| `ENABLE_TOOL_SEARCH` | [MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search)を制御します。未設定の場合、Claude Code はデフォルトですべての MCP ツールを遅延読み込みします。ただし、Claude 4.5 世代より前の Google Cloud's Agent Platform のモデル、Azure 上でホストされる Microsoft Foundry のデプロイ、および `ANTHROPIC_BASE_URL` がファーストパーティ以外のホストを指している場合は、引き続き事前に読み込みます。`true` は常に遅延読み込みしてベータヘッダーを送信しますが、前述の Agent Platform のモデルと Microsoft Foundry のデプロイは例外です。`tool_reference` をサポートしないプロキシではリクエストが失敗します。`auto` は、ツール定義がコンテキストの 10% 以内に収まる場合に事前に読み込みます。`auto:N` はカスタムのしきい値を設定します（5% の場合は `auto:5` など）。`false` はすべてのツールを事前に読み込みます。`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` が設定されている場合、自分で設定した値は無視されます。v2.1.221 より前は、この変数を `true` に設定しない限り、Claude Code は Google Cloud's Agent Platform のすべてのモデルでツール検索を無効にしていました |

464| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | `1` などの空でない任意の値に設定すると、フォールバックモデルが設定されていない場合に、すべてのモデルで過負荷エラーが繰り返されたときに Claude Code が再試行を停止するようにします。ほとんどのオン/オフ変数とは異なり、**`0` または `false` に設定しても有効になります**。デフォルトの再試行動作に戻すには、変数の設定を解除してください。この変数がない場合、Claude Code がこのように再試行を停止するのは、Claude サブスクリプションではなく API キーまたは[サードパーティプロバイダー](/docs/ja/third-party-integrations)で認証しているときに、Opus、Fable、Mythos モデルとして認識するモデルに対してのみです。Claude Code v2.1.160 以降では、Claude Code はどのプライマリモデルでも過負荷エラーが繰り返されると設定済みの[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)に切り替えるため、この変数はフォールバックモデルへの切り替えには影響しません |468| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | `1` などの空でない任意の値に設定すると、フォールバックモデルが設定されていない場合に、すべてのモデルについて、過負荷エラーが繰り返されたときに Claude Code が再試行を停止するようにします。ほとんどのオン/オフ変数とは異なり、**`0` または `false` に設定しても有効になります**。デフォルトの再試行動作に戻すには、変数の設定を解除してください。この変数がない場合、Claude Code がこのように再試行を停止するのは、Claude サブスクリプションではなく API キーまたは[サードパーティプロバイダー](/docs/ja/third-party-integrations)で認証しているときに、Opus、Fable、または Mythos モデルとして認識するモデルに限られます。Claude Code v2.1.160 以降では、どのプライマリモデルでも過負荷エラーが繰り返されると Claude Code は設定された[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)に切り替えるため、この変数はフォールバックモデルへの切り替えには影響しません |

466| `FORCE_HYPERLINK` | ターミナルがクリック可能な OSC 8 ハイパーリンクをサポートしているのに自動検出されない場合に `1` に設定すると有効になり、`0` に設定すると無効になります。未設定の場合、Claude Code はターミナルのサポートを検出した場合にのみハイパーリンクを有効にします。Claude Code はこの値をブール値ではなく数値として解析するため、`false`、`no`、`off` などの値はハイパーリンクを無効にするのではなく有効にします。フッターの [PR またはマージリクエストのバッジ](/docs/ja/interactive-mode#pr-review-status)は、SSH 経由など Claude Code がターミナルのサポートを検出できない場合でもハイパーリンクとして表示されます。バッジをプレーンテキストとして表示するには `0` を設定してください |470| `FORCE_HYPERLINK` | ターミナルがクリック可能な OSC 8 ハイパーリンクをサポートしているのに自動検出されない場合に `1` に設定すると、ハイパーリンクを有効にします。`0` に設定すると無効にします。未設定の場合、Claude Code はターミナルのサポートを検出したときにのみハイパーリンクを有効にします。Claude Code はこの値をブール値ではなく数値として解析するため、`false`、`no`、`off` などの値ではハイパーリンクは無効にならず、有効になります。フッターの [PR またはマージリクエストのバッジ](/docs/ja/interactive-mode#pr-review-status)は、SSH 経由など Claude Code がターミナルのサポートを検出できない場合でもハイパーリンクとして表示されます。バッジをプレーンテキストとして表示するには `0` に設定します |

467| `FORCE_PROMPT_CACHING_5M` | `1` に設定すると、本来 1 時間の TTL が適用される場合でも 5 分のプロンプトキャッシュ TTL を強制します。`CLAUDE_CODE_PROMPT_CACHE_TTL`、`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`、`ENABLE_PROMPT_CACHING_1H`、および `promptCacheTtl` と `subagentPromptCacheTtl` 設定を上書きします |471| `FORCE_PROMPT_CACHING_5M` | `1` に設定すると、本来 1 時間の TTL が適用される場合でも、5 分のプロンプトキャッシュ TTL を強制します。`CLAUDE_CODE_PROMPT_CACHE_TTL`、`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`、`ENABLE_PROMPT_CACHING_1H`、および `promptCacheTtl` と `subagentPromptCacheTtl` 設定を上書きします |

470| `IS_DEMO` | `1` などの空でない任意の値に設定すると、デモモードを有効にします。ヘッダーと `/status` の出力からメールアドレスと組織名を非表示にし、オンボーディングをスキップします。ほとんどのオン/オフ変数とは異なり、**`0` または `false` に設定してもデモモードが有効になります**。オフにするには、変数の設定を解除してください。セッションをストリーミング配信または録画する場合に便利です |474| `IS_DEMO` | `1` などの空でない任意の値に設定すると、デモモードを有効にします。ヘッダーと `/status` の出力からメールアドレスと組織名を非表示にし、オンボーディングをスキップします。ほとんどのオン/オフ変数とは異なり、**`0` または `false` に設定してもデモモードが有効になります**。オフにするには、変数の設定を解除してください。セッションを配信または録画する場合に便利です |

471| `MAX_MCP_OUTPUT_TOKENS` | MCP ツールのレスポンスで許可される最大トークン数。出力が 10,000 トークンを超えると、Claude Code は警告を表示します。[`anthropic/maxResultSizeChars`](/docs/ja/mcp#raise-the-limit-for-a-specific-tool) を宣言するツールでは、テキストコンテンツに対して代わりにその文字数制限が使用されますが、それらのツールの画像コンテンツには引き続きこの変数が適用されます（デフォルト: 25000） |475| `MAX_MCP_OUTPUT_TOKENS` | MCP ツールのレスポンスで許可される最大トークン数。出力が 10,000 トークンを超えると、Claude Code は警告を表示します。[`anthropic/maxResultSizeChars`](/docs/ja/mcp#raise-the-limit-for-a-specific-tool) を宣言しているツールは、テキストコンテンツについては代わりにその文字数制限を使用しますが、それらのツールからの画像コンテンツには引き続きこの変数が適用されます（デフォルト: 25000） |

472| `MAX_STRUCTURED_OUTPUT_RETRIES` | `-p` フラグを使用した非対話モードで、モデルの応答が [`--json-schema`](/docs/ja/cli-reference#cli-flags) に対する検証に失敗した場合に Claude Code が許可する試行回数。有効な出力がないままこの回数の試行が失敗すると、実行は失敗します。[ワークフロー](/docs/ja/workflows)のサブエージェントの構造化出力が検証に失敗した場合にも、同じ上限が適用されます。デフォルトは 5（最初の試行と 4 回の再試行）です |476| `MAX_STRUCTURED_OUTPUT_RETRIES` | `-p` フラグを使用した非対話モードで、モデルの応答が [`--json-schema`](/docs/ja/cli-reference#cli-flags) に対する検証に失敗した場合に Claude Code が許可する試行回数。その回数だけ試行に失敗して有効な出力が得られなかった場合、実行は失敗します。[ワークフロー](/docs/ja/workflows)のサブエージェントの構造化出力が検証に失敗した場合にも、同じ上限が適用されます。デフォルトは 5 で、最初の試行と 4 回の再試行です |

473| `MAX_THINKING_TOKENS` | [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)の固定トークン予算。Claude Code はこの値の上限を、リクエストの最大出力トークン数より 1 トークン少ない値とし、1,024 を下回らないようにします。その上限の設定方法については `CLAUDE_CODE_MAX_OUTPUT_TOKENS` を参照してください。未設定で思考が有効な場合、[適応型推論](/docs/ja/model-config#adjust-effort-level)を備えたモデルは自身で思考の深さを選択し、その他のモデルは上限を使用します。`0` に設定すると Anthropic API で思考を無効にします。ただし、Opus 5.5、Sonnet 5.5、および Fable モデルは思考をオフにできません。[サードパーティプロバイダー](/docs/ja/third-party-integrations)では、`0` は代わりに `thinking` パラメータを省略します。Anthropic API で思考をオフにした場合、Opus 5 など、[その組み合わせを受け付けない](/docs/ja/errors#effort-isnt-available-with-thinking-turned-off)と Claude Code が認識しているモデルには、より高いレベルではなく effort `high` を送信します。Claude Code は適応型推論モデルでは 0 以外の値を無視します。ただし、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` で適応型推論がオフになるモデルは例外です |477| `MAX_THINKING_TOKENS` | [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)の固定トークン予算。Claude Code は、リクエストの最大出力トークン数より 1 トークン少ない値を上限とし、1,024 を下回ることはありません。その上限の設定方法については `CLAUDE_CODE_MAX_OUTPUT_TOKENS` を参照してください。未設定で思考が有効な場合、[適応型推論](/docs/ja/model-config#adjust-effort-level)に対応したモデルは思考の深さを自身で選択し、その他のモデルは上限を使用します。`0` に設定すると Anthropic API で思考を無効にします。ただし、Opus 5.5、Sonnet 5.5、および Fable モデルは思考をオフにできません。[サードパーティプロバイダー](/docs/ja/third-party-integrations)では、`0` は代わりに `thinking` パラメータを省略します。Anthropic API で思考をオフにしている場合、Claude Code は、Opus 5 など[その組み合わせを受け付けない](/docs/ja/errors#effort-isnt-available-with-thinking-turned-off)ことがわかっているモデルには、より高いレベルではなく effort `high` を送信します。正の値の場合、適応型推論モデルでは Claude Code は数値自体を無視します。ただし、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` で適応型推論をオフにしている場合は除きます |

474| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials)を必要とする MCP サーバー用の OAuth クライアントシークレット。`--client-secret` を指定してサーバーを追加する際の対話型プロンプトを回避します |478| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials)を必要とする MCP サーバー用の OAuth クライアントシークレット。`--client-secret` を指定してサーバーを追加する際の対話型プロンプトを回避します |

475| `MCP_CONNECTION_NONBLOCKING` | 最初のクエリの前に、起動処理が MCP サーバーの接続を待つかどうかを制御します。MCP の起動はデフォルトでノンブロッキングです。サーバーはバックグラウンドで接続し、接続が完了するとそのツールが利用可能になります。`0` に設定すると、Claude Code は最初のクエリの前にサーバーの接続を待ちます。[`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) で設定されたサーバーは、最初のプロンプトの構築時にツールが存在している必要があるため、この設定に関係なく起動を待機させます。ただし、[ディスカバリーキャッシュ](/docs/ja/mcp#server-status-detail)から提供される場合は除きます。`--input-format stream-json` を指定しない非対話モード（`-p`）では、この変数に関係なく、Claude Code は最初のターンの前にまだ保留中のサーバーも待ちます。[`--mcp-config`](/docs/ja/cli-reference#cli-flags) を明示的に渡した場合、待機の期限は長くなります。キャッシュされたサーバーの例外については、そのフラグの項目を参照してください |479| `MCP_CONNECTION_NONBLOCKING` | 起動時に、最初のクエリの前に MCP サーバーの接続を待つかどうかを制御します。MCP の起動はデフォルトでノンブロッキングです。サーバーはバックグラウンドで接続し、接続が完了したものからツールが利用可能になります。`0` に設定すると、Claude Code は最初のクエリの前にサーバーの接続を待ちます。[`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) で設定されたサーバーは、最初のプロンプトの構築時にツールが存在している必要があるため、[検出キャッシュ](/docs/ja/mcp#server-status-detail)から提供される場合を除き、この設定にかかわらず起動時に待機させます。`--input-format stream-json` を指定しない非対話モード（`-p`）では、Claude Code はこの変数にかかわらず、最初のターンの前にまだ保留中のサーバーも待ちます。[`--mcp-config`](/docs/ja/cli-reference#cli-flags) を明示的に渡した場合、待機の期限は長くなります。キャッシュされたサーバーの例外については、そのフラグの項目を参照してください |

476| `MCP_CONNECT_TIMEOUT_MS` | ブロッキング方式の MCP 起動で、ツール一覧のスナップショットを取る前に接続バッチを待つ時間（ミリ秒、デフォルト: 5000）。`MCP_CONNECTION_NONBLOCKING=0` の場合、または [`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) が指定されたサーバーに適用されます。期限の時点でまだ保留中のサーバーは、バックグラウンドで接続を続けます。個々のサーバーの接続試行を制限する `MCP_TIMEOUT` とは別のものです |480| `MCP_CONNECT_TIMEOUT_MS` | ブロッキング MCP 起動時に、ツールリストのスナップショットを取得する前に接続バッチを待つ時間（ミリ秒、デフォルト: 5000）。`MCP_CONNECTION_NONBLOCKING=0` の場合、または [`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) が指定されたサーバーに適用されます。期限の時点でまだ保留中のサーバーは、バックグラウンドで接続を続けます。個々のサーバーの接続試行を制限する `MCP_TIMEOUT` とは別のものです |

477| `MCP_DISCOVERY_CACHE` | [MCP ディスカバリーキャッシュ](/docs/ja/mcp#server-status-detail)のオン/オフを切り替えます。キャッシュがオンの場合、以前に使用したリモート HTTP または SSE サーバーは [`cached` ステータス](/docs/ja/mcp#server-status-detail)を表示でき、Claude Code は起動時ではなく最初のツール呼び出し時にそのサーバーに接続します。段階的なロールアウトによってアカウントで有効になっていない限り、キャッシュはデフォルトでオフです。オンにするには `1` を、ロールアウトで有効になっている場合でもオフのままにするには `0` を設定してください。v2.1.238 より前は、キャッシュはデフォルトでオンでした。`cached` ステータスには Claude Code v2.1.221 以降が必要です |481| `MCP_DISCOVERY_CACHE` | [MCP 検出キャッシュ](/docs/ja/mcp#server-status-detail)をオンまたはオフにします。キャッシュがオンの場合、以前に使用したリモート HTTP または SSE サーバーが [`cached` ステータス](/docs/ja/mcp#server-status-detail)を表示することがあり、Claude Code は起動時ではなく最初のツール呼び出し時にそのサーバーに接続します。段階的なロールアウトによってアカウントで有効になっていない限り、キャッシュはデフォルトでオフです。`1` に設定するとオンになり、`0` に設定するとロールアウトで有効になっている場合でもオフのままになります。v2.1.238 より前は、キャッシュはデフォルトでオンでした。`cached` ステータスには Claude Code v2.1.221 以降が必要です |

478| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | [ディスカバリーキャッシュ](/docs/ja/mcp#server-status-detail)エントリの最大経過時間（秒）（デフォルト: 14400、つまり 4 時間）。エントリがそれより古い状態で起動すると、Claude Code はそのエントリを破棄し、キャッシュがオフの場合と同様に起動時にサーバーに接続します。Claude Code は値の上限を 7 日とします。v2.1.238 より前は、デフォルトは 86400（24 時間）で、Claude Code は値に上限を設けていませんでした |482| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | [検出キャッシュ](/docs/ja/mcp#server-status-detail)エントリの最大経過時間（秒）（デフォルト: 14400、つまり 4 時間）。エントリがそれより古い状態で起動すると、Claude Code はエントリを破棄し、キャッシュがオフの場合と同様に起動時にサーバーに接続します。Claude Code は値の上限を 7 日とします。v2.1.238 より前は、デフォルトは 86400（24 時間）で、Claude Code は値に上限を設けていませんでした |

479| `MCP_DISCOVERY_CACHE_STRIKES` | [ディスカバリーキャッシュ](/docs/ja/mcp#server-status-detail)エントリが `MCP_DISCOVERY_CACHE_TTL_S` より古い状態で起動すると、Claude Code はバックグラウンドでエントリを更新します。この変数は、Claude Code がエントリを破棄して次回の起動時にサーバーに接続するようになるまでに、連続して何回の更新失敗を許容するかを設定します（デフォルト: 1）。ネットワーク接続がときどき切断される場合は、1 回の更新失敗でエントリが破棄されないように値を上げてください。Claude Code v2.1.238 以降が必要です |483| `MCP_DISCOVERY_CACHE_STRIKES` | [検出キャッシュ](/docs/ja/mcp#server-status-detail)エントリが `MCP_DISCOVERY_CACHE_TTL_S` より古い状態で起動すると、Claude Code はバックグラウンドでそのエントリを更新します。この変数は、Claude Code がエントリを破棄し、代わりに次回の起動時にサーバーに接続するまでに、更新が連続して何回失敗できるかを設定します（デフォルト: 1）。ネットワーク接続がときどき切断される場合は、1 回の更新失敗でエントリが破棄されないよう、この値を大きくしてください。Claude Code v2.1.238 以降が必要です |

480| `MCP_DISCOVERY_CACHE_TTL_S` | Claude Code が[ディスカバリーキャッシュ](/docs/ja/mcp#server-status-detail)エントリを更新せずに使用する秒数（デフォルト: 900）。エントリがそれより古い状態で起動すると、Claude Code はそのエントリを引き続き使用しますが、バックグラウンドで更新します。エントリが `MCP_DISCOVERY_CACHE_MAX_STALE_S` より古くなると、Claude Code は代わりにそのエントリを破棄します。Claude Code は値の上限を `MCP_DISCOVERY_CACHE_MAX_STALE_S`（デフォルトは 4 時間）とします。v2.1.238 より前は、Claude Code は値に上限を設けていませんでした |484| `MCP_DISCOVERY_CACHE_TTL_S` | Claude Code が[検出キャッシュ](/docs/ja/mcp#server-status-detail)エントリを更新せずに使用する秒数（デフォルト: 900）。エントリがそれより古い状態で起動すると、Claude Code は引き続きそのエントリを使用しますが、バックグラウンドで更新します。エントリが `MCP_DISCOVERY_CACHE_MAX_STALE_S` より古くなると、Claude Code は代わりにそのエントリを破棄します。Claude Code は値の上限を `MCP_DISCOVERY_CACHE_MAX_STALE_S`（デフォルトは 4 時間）とします。v2.1.238 より前は、Claude Code は値に上限を設けていませんでした |

481| `MCP_OAUTH_CALLBACK_PORT` | OAuth リダイレクトコールバック用の固定ポート。[事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials)で MCP サーバーを追加する際の `--callback-port` の代替です |485| `MCP_OAUTH_CALLBACK_PORT` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials)を使用して MCP サーバーを追加する際に、`--callback-port` の代わりに使用できる OAuth リダイレクトコールバック用の固定ポート |

482| `MCP_PROTOCOL_NEGOTIATION` | [v2 MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes)でのみ有効で、Claude Code が MCP プロトコルリビジョン 2026-07-28 についてサーバーをプローブするかどうかを指定します。HTTP、claude.ai コネクタ、stdio サーバーをプローブするには `auto`、どれもプローブしないようにするには `legacy` に設定します。変数が未設定の場合、Claude Code は [MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes)で説明されているサーバーをプローブします。その他の値は、デバッグログに警告を出力したうえで無視されます。Claude Code v2.1.221 以降が必要です |486| `MCP_PROTOCOL_NEGOTIATION` | [v2 MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes)でのみ、Claude Code が MCP プロトコルリビジョン 2026-07-28 についてサーバーをプローブするかどうか。`auto` に設定すると HTTP、claude.ai コネクタ、stdio の各サーバーをプローブし、`legacy` に設定するとどのサーバーもプローブしません。変数が未設定の場合、Claude Code は [MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes)で説明されているサーバーをプローブします。その他の値は、デバッグログに警告を出したうえで無視されます。Claude Code v2.1.221 以降が必要です |

484| `MCP_SDK_GENERATION` | このプロセスが MCP サーバーへの接続に使用する [MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes)を固定します。MCP TypeScript SDK 1.x 上に構築された `v1`、または [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/) 上に構築された `v2` を指定します。この変数がない場合、Claude Code はそのセクションに記載されているバージョン以降で v2 を使用します。Claude Code v2.1.221 以降では、v2 ランタイムは MCP OAuth サーバーが認可レスポンスで返す発行者を確認し、一致しない場合は `Issuer mismatch in authorization response` で始まるエラーでサインインを失敗させます。v1 ランタイムはこの確認を行いません。認識されない値を設定した場合、Claude Code はそれを無視し、デバッグログに警告を書き込みます。Claude Code はプロセスごとに 1 回だけ値を読み取ります。Claude Code v2.1.218 以降が必要です |488| `MCP_SDK_GENERATION` | このプロセスが MCP サーバーへの接続に使用する [MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes)を固定します。MCP TypeScript SDK 1.x をベースとする `v1`、または [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/) をベースとする `v2` を指定します。変数がない場合、Claude Code はそのセクションに記載されたバージョン以降で v2 を使用します。Claude Code v2.1.221 以降では、v2 ランタイムは MCP OAuth サーバーが認可レスポンスで返す発行者を確認し、一致しない場合は `Issuer mismatch in authorization response` で始まるエラーでサインインを失敗させます。v1 ランタイムではこの確認は行われません。認識されない値を設定した場合、Claude Code はそれを無視し、デバッグログに警告を書き込みます。Claude Code はプロセスごとに値を 1 回読み込みます。Claude Code v2.1.218 以降が必要です |

487| `MCP_TOOL_TIMEOUT` | MCP ツール実行のタイムアウト（ミリ秒、デフォルト: 100000000、約 28 時間）。HTTP、SSE、または claude.ai コネクタサーバーの場合、各リクエストもデフォルトで 60 秒後にタイムアウトします。このリクエストごとの制限を引き上げるには、この変数またはサーバーごとの `timeout` を 60000 より大きい値に設定してください。より小さい値を設定すると、ツール実行全体のタイムアウトは短くなりますが、リクエストごとの制限は 60 秒のままです。stdio および WebSocket サーバーにはリクエストごとのタイマーはありません。`.mcp.json` のサーバーごとの `timeout` フィールドは、そのサーバーについてこの値を上書きします。1000 以上のサーバーごとの `timeout` は、そのサーバーのツール呼び出しの最小アイドル時間枠も設定するため、`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` によってそれより早く中止されることはありません。この下限には Claude Code v2.1.203 以降が必要です。環境変数の場合、1000 未満の値は 1 秒に切り上げられます。サーバーごとのフィールドの場合、1000 未満の値は無視されます |491| `MCP_TOOL_TIMEOUT` | MCP ツール実行のタイムアウト（ミリ秒、デフォルト: 100000000、約 28 時間）。HTTP、SSE、または claude.ai コネクタのサーバーでは、各リクエストもデフォルトで 60 秒後にタイムアウトします。このリクエストごとの制限を引き上げるには、この変数またはサーバーごとの `timeout` を 60000 より大きい値に設定してください。それより小さい値を設定した場合、ツール実行全体のタイムアウトは短くなりますが、リクエストごとの制限は 60 秒のままです。stdio サーバーと WebSocket サーバーには、リクエストごとのタイマーはありません。`.mcp.json` のサーバーごとの `timeout` フィールドは、そのサーバーについてこの値を上書きします。1000 以上のサーバーごとの `timeout` は、そのサーバーのツール呼び出しの最小アイドル時間も設定するため、`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` がそれより早く中断することはありません。この下限には Claude Code v2.1.203 以降が必要です。環境変数では、1000 未満の値は 1 秒に切り上げられます。サーバーごとのフィールドでは、1000 未満の値は無視されます |

489| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | 属性値の長さに関する OpenTelemetry SDK の標準の制限。Claude Code は、コンテンツを含むテレメトリ属性をこの値と `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` の小さい方に制限するため、切り詰めマーカーは SDK の制限内に収まります。Claude Code は `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` および `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` のバリアントも同じように読み取り、設定された値のうち最小のものがすべてのシグナルに適用されます。Claude Code v2.1.214 以降が必要です。[モニタリング](/docs/ja/monitoring-usage#common-configuration-variables)を参照してください |493| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | 属性値の長さに関する標準の OpenTelemetry SDK の制限。Claude Code は、コンテンツを含むテレメトリ属性をこの値と `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` の小さい方に制限するため、切り詰めマーカーは SDK の制限内に収まります。Claude Code は `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` と `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` のバリアントも同様に読み取り、設定された値のうち最小のものがすべてのシグナルに適用されます。Claude Code v2.1.214 以降が必要です。[モニタリング](/docs/ja/monitoring-usage#common-configuration-variables)を参照してください |

490| `OTEL_LOG_ASSISTANT_RESPONSES` | `1` に設定すると、`assistant_response` OpenTelemetry ログイベントにモデルの応答テキストを含めます。未設定の場合、Claude Code は代わりに `OTEL_LOG_USER_PROMPTS` の値を使用します。`OTEL_LOG_USER_PROMPTS` が設定されている場合でも応答を秘匿化したままにするには、`0` に設定します。シェル、ユーザー設定、または管理設定で設定してください。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。Claude Code v2.1.193 以降が必要です。[モニタリング](/docs/ja/monitoring-usage#assistant-response-event)を参照してください |494| `OTEL_LOG_ASSISTANT_RESPONSES` | `1` に設定すると、`assistant_response` OpenTelemetry ログイベントにモデルの応答テキストを含めます。未設定の場合、Claude Code は代わりに `OTEL_LOG_USER_PROMPTS` の値を使用します。`0` に設定すると、`OTEL_LOG_USER_PROMPTS` が設定されている場合でも応答は秘匿化されたままになります。シェル、ユーザー設定、または管理設定で設定します。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。Claude Code v2.1.193 以降が必要です。[モニタリング](/docs/ja/monitoring-usage#assistant-response-event)を参照してください |

491| `OTEL_LOG_MANAGED_SETTINGS` | `1` に設定すると、秘匿化された管理設定と、秘匿化前の設定の SHA-256 ダイジェストを `managed_settings_resolved` OpenTelemetry ログイベントに追加します。デフォルトでは無効です。シェル、ユーザー設定、または管理設定で設定してください。プロジェクト設定またはローカル設定の値ではオンになりません。Claude Code v2.1.274 以降が必要です。[モニタリング](/docs/ja/monitoring-usage#managed-settings-resolved-event)を参照してください |495| `OTEL_LOG_MANAGED_SETTINGS` | `1` に設定すると、秘匿化された管理設定と、秘匿化前の設定の SHA-256 ダイジェストを `managed_settings_resolved` OpenTelemetry ログイベントに追加します。デフォルトでは無効です。シェル、ユーザー設定、または管理設定で設定します。プロジェクト設定やローカル設定の値ではオンになりません。Claude Code v2.1.274 以降が必要です。[モニタリング](/docs/ja/monitoring-usage#managed-settings-resolved-event)を参照してください |

492| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API のリクエストとレスポンスの JSON を `api_request_body` / `api_response_body` ログイベントとして出力します。コンテンツ制限で切り詰められたボディをインラインで出力するには `1` に、切り詰められていないボディをディスクに書き込んで代わりに `body_ref` パスを出力するには `file:<dir>` に設定します。`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` でコンテンツ制限を設定します（デフォルトは 60 KB）。デフォルトでは無効です。ボディには会話履歴全体が含まれます。シェル、ユーザー設定、または管理設定で設定してください。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。[モニタリング](/docs/ja/monitoring-usage#api-request-body-event)を参照してください |496| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API のリクエストとレスポンスの JSON を `api_request_body` / `api_response_body` ログイベントとして出力します。`1` に設定するとコンテンツの上限で切り詰められたボディをインラインで出力し、`file:<dir>` に設定すると切り詰められていないボディをディスクに書き込み、代わりに `body_ref` パスを出力します。コンテンツの上限は `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` で設定し、デフォルトは 60 KB です。デフォルトでは無効です。ボディには会話履歴全体が含まれます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。[モニタリング](/docs/ja/monitoring-usage#api-request-body-event)を参照してください |

493| `OTEL_LOG_TOOL_CONTENT` | `1` に設定すると、`tool.output` OpenTelemetry スパンイベントにツールのコンテンツを含めます。スパン属性は、[独自のゲート](/docs/ja/monitoring-usage#new-context-gates)のもとでツールのコンテンツを保持します。[トレース](/docs/ja/monitoring-usage#traces-beta)が必要です。機密データを保護するため、デフォルトでは無効です。シェル、ユーザー設定、または管理設定で設定してください。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では、そのセクションで説明しているオフの値を除いて無視されます。[モニタリング](/docs/ja/monitoring-usage#tool-output-span-event)を参照してください |497| `OTEL_LOG_TOOL_CONTENT` | `1` に設定すると、`tool.output` OpenTelemetry スパンイベントにツールのコンテンツを含めます。スパン属性は、[独自のゲート](/docs/ja/monitoring-usage#new-context-gates)のもとでツールのコンテンツを保持します。[トレース](/docs/ja/monitoring-usage#traces-beta)が必要です。機密データを保護するため、デフォルトでは無効です。シェル、ユーザー設定、または管理設定で設定します。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では、そのセクションで説明しているオフの値を除き無視されます。[モニタリング](/docs/ja/monitoring-usage#tool-output-span-event)を参照してください |

494| `OTEL_LOG_TOOL_DETAILS` | `1` に設定すると、ツールの入力引数、MCP サーバー名、ユーザーが作成したワークフロー名、ツール失敗時の生のエラー文字列、`api_refusal` イベントの拒否 `category`、[コストおよびトークンメトリクス](/docs/ja/monitoring-usage#cost-counter)における実際のエージェント、スキル、プラグイン、MCP サーバーの名前、その他のツールの詳細を OpenTelemetry のメトリクス、トレース、ログに含めます。PII を保護するため、デフォルトでは無効です。シェル、ユーザー設定、または管理設定で設定してください。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では、そのセクションで説明しているオフの値を除いて無視されます。[モニタリング](/docs/ja/monitoring-usage)を参照してください |498| `OTEL_LOG_TOOL_DETAILS` | `1` に設定すると、ツールの入力引数、MCP サーバー名、ユーザーが作成したワークフロー名、ツール失敗時の生のエラー文字列、`api_refusal` イベントの拒否の `category`、[コストとトークンのメトリクス](/docs/ja/monitoring-usage#cost-counter)における実際のエージェント、スキル、プラグイン、MCP サーバーの名前、およびその他のツールの詳細を、OpenTelemetry のメトリクス、トレース、ログに含めます。PII を保護するため、デフォルトでは無効です。シェル、ユーザー設定、または管理設定で設定します。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では、そのセクションで説明しているオフの値を除き無視されます。[モニタリング](/docs/ja/monitoring-usage)を参照してください |

495| `OTEL_LOG_USER_PROMPTS` | `1` に設定すると、OpenTelemetry のトレースとログにユーザーのプロンプトテキストを含めます。デフォルトでは無効です（プロンプトは秘匿化されます）。シェル、ユーザー設定、または管理設定で設定してください。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では、そのセクションで説明しているオフの値を除いて無視されます。[モニタリング](/docs/ja/monitoring-usage)を参照してください |499| `OTEL_LOG_USER_PROMPTS` | `1` に設定すると、OpenTelemetry のトレースとログにユーザープロンプトのテキストを含めます。デフォルトでは無効です（プロンプトは秘匿化されます）。シェル、ユーザー設定、または管理設定で設定します。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では、そのセクションで説明しているオフの値を除き無視されます。[モニタリング](/docs/ja/monitoring-usage)を参照してください |

496| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | `false` に設定すると、メトリクス属性からアカウント UUID を除外します（デフォルト: 含まれる）。[モニタリング](/docs/ja/monitoring-usage)を参照してください |500| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | `false` に設定すると、メトリクス属性からアカウント UUID を除外します（デフォルト: 含める）。[モニタリング](/docs/ja/monitoring-usage)を参照してください |

497| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | `true` に設定すると、メトリクス属性にセッションのエントリポイントを含めます（デフォルト: 除外）。v2.1.152 で追加されました。[モニタリング](/docs/ja/monitoring-usage)を参照してください |501| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | `true` に設定すると、メトリクス属性にセッションのエントリポイントを含めます（デフォルト: 除外）。v2.1.152 で追加されました。[モニタリング](/docs/ja/monitoring-usage)を参照してください |

498| `OTEL_METRICS_INCLUDE_REPOSITORY` | `true` に設定すると、セッションのリポジトリを識別する `vcs.*` 属性を OpenTelemetry のメトリクスとイベントに付与します（デフォルト: 除外）。Claude Code v2.1.269 以降が必要です。[リポジトリ属性](/docs/ja/monitoring-usage#repository-attributes)を参照してください |502| `OTEL_METRICS_INCLUDE_REPOSITORY` | `true` に設定すると、セッションのリポジトリを識別する `vcs.*` 属性を OpenTelemetry のメトリクスとイベントに付与します（デフォルト: 除外）。Claude Code v2.1.269 以降が必要です。[リポジトリ属性](/docs/ja/monitoring-usage#repository-attributes)を参照してください |

499| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | v2.1.161 以降、Claude Code は `OTEL_RESOURCE_ATTRIBUTES` のキーをメトリクスのデータポイントのラベルに付加します。除外するには `false` に設定します（デフォルト: 含まれる）。[モニタリング](/docs/ja/monitoring-usage#multi-team-organization-support)を参照してください |503| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | v2.1.161 以降、Claude Code は `OTEL_RESOURCE_ATTRIBUTES` のキーをメトリクスのデータポイントのラベルに付与します。`false` に設定すると除外します（デフォルト: 含める）。[モニタリング](/docs/ja/monitoring-usage#multi-team-organization-support)を参照してください |

500| `OTEL_METRICS_INCLUDE_SESSION_ID` | `false` に設定すると、メトリクス属性からセッション ID を除外します（デフォルト: 含まれる）。[モニタリング](/docs/ja/monitoring-usage)を参照してください |504| `OTEL_METRICS_INCLUDE_SESSION_ID` | `false` に設定すると、メトリクス属性からセッション ID を除外します（デフォルト: 含める）。[モニタリング](/docs/ja/monitoring-usage)を参照してください |

501| `OTEL_METRICS_INCLUDE_VERSION` | `true` に設定すると、メトリクス属性に Claude Code のバージョンを含めます（デフォルト: 除外）。[モニタリング](/docs/ja/monitoring-usage)を参照してください |505| `OTEL_METRICS_INCLUDE_VERSION` | `true` に設定すると、メトリクス属性に Claude Code のバージョンを含めます（デフォルト: 除外）。[モニタリング](/docs/ja/monitoring-usage)を参照してください |

502| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | [Skill ツール](/docs/ja/skills#control-who-invokes-a-skill)に表示されるスキルメタデータの文字数予算を上書きします。予算はコンテキストウィンドウの 1% で動的にスケールし、フォールバックは 8,000 文字です。後方互換性のために従来の名前が維持されています |506| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | [Skill ツール](/docs/ja/skills#control-who-invokes-a-skill)に表示されるスキルのメタデータの文字数予算を上書きします。予算はコンテキストウィンドウの 1% として動的に調整され、フォールバック値は 8,000 文字です。後方互換性のために従来の名前を維持しています |

503| `TASK_MAX_OUTPUT_LENGTH` | v2.1.277 で、この変数がサイズを決めていた `TaskOutput` ツールとともに削除され、現在は何の効果もありません。以前は、`TaskOutput` ツールが保持する[バックグラウンドタスク](/docs/ja/tools-reference#background-commands)の出力の最大文字数を設定していました。現在、Claude は代わりに `Read` でバックグラウンドタスクの出力ファイルを読み取ります |507| `TASK_MAX_OUTPUT_LENGTH` | v2.1.277 で、この変数がサイズを決めていた `TaskOutput` ツールとともに削除され、現在は何もしません。以前は、`TaskOutput` ツールが保持する[バックグラウンドタスク](/docs/ja/tools-reference#background-commands)の出力の最大文字数を設定していました。現在、Claude はバックグラウンドタスクの出力ファイルを代わりに `Read` で読み取ります |

522| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Google Cloud's Agent Platform を使用する場合の Claude Fable 5.1 のリージョンを上書きします。v2.1.257 で追加されました |526| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Google Cloud's Agent Platform を使用する場合の Claude Fable 5.1 のリージョンを上書きします。v2.1.257 で追加されました |

524 528

525標準的な OpenTelemetry エクスポーター変数（`OTEL_METRICS_EXPORTER`、`OTEL_LOGS_EXPORTER`、`OTEL_EXPORTER_OTLP_ENDPOINT`、`OTEL_EXPORTER_OTLP_PROTOCOL`、`OTEL_EXPORTER_OTLP_HEADERS`、`OTEL_METRIC_EXPORT_INTERVAL`、`OTEL_RESOURCE_ATTRIBUTES`、およびシグナル固有のバリアント）もサポートされています。設定の詳細については、[モニタリング](/docs/ja/monitoring-usage)を参照してください。529標準の OpenTelemetry エクスポーター変数（`OTEL_METRICS_EXPORTER`、`OTEL_LOGS_EXPORTER`、`OTEL_EXPORTER_OTLP_ENDPOINT`、`OTEL_EXPORTER_OTLP_PROTOCOL`、`OTEL_EXPORTER_OTLP_HEADERS`、`OTEL_METRIC_EXPORT_INTERVAL`、`OTEL_RESOURCE_ATTRIBUTES`、およびシグナル固有のバリアント）もサポートされています。設定の詳細については、[モニタリング](/docs/ja/monitoring-usage)を参照してください。

526 530

527`CLAUDE_CODE_ENABLE_TELEMETRY` と、エクスポートをオンにする、エクスポート先を選択する、またはコンテンツを取得する OpenTelemetry 変数は、シェル、ユーザー設定、または管理設定で設定してください。Claude Code は、そのセクションで説明しているオフの値を除いて、[プロジェクト設定とローカル設定ではこれらを無視します](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)。`OTEL_RESOURCE_ATTRIBUTES` と、`OTEL_METRIC_EXPORT_INTERVAL` などのエクスポート間隔、タイムアウト、圧縮の変数は、プロジェクト設定とローカル設定からも引き続き適用されます。531`CLAUDE_CODE_ENABLE_TELEMETRY` と、エクスポートをオンにする、エクスポート先を選択する、またはコンテンツを取得する OpenTelemetry 変数は、シェル、ユーザー設定、または管理設定で設定してください。Claude Code は、そのセクションで説明しているオフの値を除き、[プロジェクト設定とローカル設定ではこれらを無視します](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)。`OTEL_RESOURCE_ATTRIBUTES` と、`OTEL_METRIC_EXPORT_INTERVAL` などのエクスポートの間隔、タイムアウト、圧縮に関する変数は、プロジェクト設定とローカル設定からも引き続き適用されます。

532

533<h2 id="what-the-subprocess-environment-scrub-removes">

534 サブプロセス環境のスクラブで削除されるもの

535</h2>

536

537[`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](#variables) を `1` に設定すると、Claude Code は Bash コマンド、フック、stdio MCP サーバーなど、自身が起動するサブプロセスの環境から認証情報を削除します。これにより、プロンプトインジェクション攻撃がシェル展開を通じて読み取れる情報が減ります。Claude Code のプロセス自体は、独自の API 呼び出しのために認証情報を保持します。

538

539スクラブは変数名または値の形式によって認証情報を識別するため、唯一の制御手段としてではなく、範囲を絞った[権限ルール](/docs/ja/permissions)と併用する一つの層として使用してください。

540

541次の表は、スクラブが例示の変数に対して行う処理を示しています。

542

543| 変数の例 | スクラブの処理 |

544| :- | :- |

545| `ANTHROPIC_API_KEY`、`AWS_SECRET_ACCESS_KEY` | 削除します |

546| `NPM_TOKEN`、`DB_PASSWORD` | 名前が認証情報のように見えるため、削除します |

547| パスワードを含む `DATABASE_URL` | 値が認証情報のように見えるため、削除します |

548| パスワードを含む `PIP_INDEX_URL` または `NPM_CONFIG_REGISTRY` | URL は保持し、そこからユーザー名とパスワードを取り除きます |

549| `CLAUDE_CONFIG_DIR` | 削除します。Claude Code v2.1.251 以降が必要です |

550| `GITHUB_TOKEN`、`GH_TOKEN`、`GH_ENTERPRISE_TOKEN`、`GITHUB_ENTERPRISE_TOKEN` | `gh` や GitHub API を呼び出すスクリプトが引き続き動作するよう、そのまま残します |

551| `HTTP_PROXY`、`HTTPS_PROXY` | [URL 内のユーザー名とパスワード](/docs/ja/network-config#basic-authentication)も含めて、そのまま残します。[サンドボックス](/docs/ja/sandboxing#network-isolation)は、サンドボックス化されたコマンドに対してこれらの変数を自ら設定できます |

552| `GIT_CONFIG_COUNT`、`GIT_CONFIG_KEY_<n>`、`GIT_CONFIG_VALUE_<n>` | 内容にかかわらず、そのまま残します |

553| 変数名も値も認証情報のように見えないシークレット | そのまま残します |

554

555スクラブは `GITHUB_TOKEN` をそのまま残すため、GitHub Actions のジョブには必要最小限の `permissions` を付与してください。サンドボックス化された Bash コマンドから GitHub トークンを削除するには、[`sandbox.credentials`](/docs/ja/sandboxing#protect-credentials) の下に `deny` エントリを追加します。

556

557サブプロセスが削除対象の変数のいずれかを必要とする場合は、スクラブを設定しないでください。

558

559Linux では、スクラブは Bash サブプロセスを分離された PID 名前空間でも実行するため、サブプロセスは `/proc` を通じてホストのプロセス環境を読み取れません。その副作用として、`ps`、`pgrep`、`kill` はホストのプロセスを参照したり、シグナルを送信したりできません。

528 560

529<h2 id="features-that-need-feature-flag-fetching">561<h2 id="features-that-need-feature-flag-fetching">

530 フィーチャーフラグの取得が必要なフィーチャー562 機能フラグの取得が必要な機能

531</h2>563</h2>

532 564

533Claude Code は Anthropic から取得するフィーチャーフラグを通じて、いくつかのフィーチャーをオンにします。Claude Code は以下のセッションではその取得をスキップします。565Claude Code の一部の機能は、Anthropic から取得する機能フラグによってオンになります。次のセッションでは、Claude Code はこの取得をスキップします。

~~534~~ 566

535* `DISABLE_GROWTHBOOK`、`DISABLE_TELEMETRY`、`DO_NOT_TRACK`、または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` を設定したセッション。各変数の [変数テーブル](#variables) の行に、どの値が取得をオフにするかが記載されています567* `DISABLE_GROWTHBOOK`、`DISABLE_TELEMETRY`、`DO_NOT_TRACK`、または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` を設定したセッション。どの値で取得がオフになるかは、[変数の表](#variables)の各変数の行に記載されています

536* Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry などの [サードパーティプロバイダー](/docs/ja/third-party-integrations) 上のセッション。ただし、Claude Code を埋め込むホストプラットフォームが `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` を設定している場合を除きます568* Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry などの[サードパーティプロバイダー](/docs/ja/third-party-integrations)上のセッション。ただし、Claude Code を組み込んだホストプラットフォームが `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` を設定している場合を除きます

537* [Claude apps gateway](/docs/ja/claude-apps-gateway) セッション569* [Claude apps ゲートウェイ](/docs/ja/claude-apps-gateway)のセッション

~~538~~ 570

539取得がオフの場合、以下のことはできません。571取得がオフの場合、次のことはできません。

~~540~~ 572

541* [`/auto-mode-setup`](/docs/ja/auto-mode-config#generate-environment-entries) を実行して `autoMode.environment` エントリを作成すること573* [`/auto-mode-setup`](/docs/ja/auto-mode-config#generate-environment-entries) を実行して `autoMode.environment` のエントリを下書きする

542* `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` または `DISABLE_GROWTHBOOK` が設定されている場合に [Remote Control](/docs/ja/remote-control) を使用すること。`DISABLE_TELEMETRY` および `DO_NOT_TRACK` については、[Remote Control の要件](/docs/ja/remote-control#requirements) を参照してください574* `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` または `DISABLE_GROWTHBOOK` を設定した状態で [Remote Control](/docs/ja/remote-control) を使用する。`DISABLE_TELEMETRY` と `DO_NOT_TRACK` については、[Remote Control の要件](/docs/ja/remote-control#requirements)を参照してください

543* [Remote Control](/docs/ja/remote-control#requirements) が利用できない場合に [このマシン以外のセッションにメッセージを送信する](/docs/ja/cross-session-messaging#message-sessions-on-other-machines) こと。このマシン上のセッション間のメッセージングは取得がオフでも機能します575* [Remote Control](/docs/ja/remote-control#requirements) が利用できない場合に、[このマシン以外のセッションにメッセージを送る](/docs/ja/cross-session-messaging#message-sessions-on-other-machines)。このマシン上のセッション間のメッセージングは、取得がオフでも機能します

544* [`claude import` または `/import` コマンド](/docs/ja/cli-reference#cli-commands) を実行すること576* [`claude import` または `/import` コマンド](/docs/ja/cli-reference#cli-commands)を実行する

545* [`/skill-doctor`](/docs/ja/skills#find-unused-skills) を実行するか、`/plugin` **Stats** タブでそのレポートを開くこと577* [`/skill-doctor`](/docs/ja/skills#find-unused-skills) を実行する、またはそのレポートを `/plugin` の **Stats** タブで開く

546* claude.ai アカウント用に有効になっている [スキル](/docs/ja/skills#where-synced-skills-load) と [プラグイン](/docs/ja/plugins/loading#synced-plugins) をターミナルセッションに同期すること578* claude.ai アカウントで有効にした[スキル](/docs/ja/skills#where-synced-skills-load)と[プラグイン](/docs/ja/plugins/loading#synced-plugins)をターミナルセッションに同期する

547* [アドバイザーツール](/docs/ja/advisor#requirements) を使用すること579* [アドバイザーツール](/docs/ja/advisor#requirements)を使用する

548* [アーティファクトのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact) を読むか返信すること580* [アーティファクトへのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact)を読む、または返信する

549* Claude に [別の組織の公開アーティファクト](/docs/ja/artifacts#read-an-artifact-shared-with-you) を読ませること581* Claude に[別の組織の公開アーティファクト](/docs/ja/artifacts#read-an-artifact-shared-with-you)を読ませる

550* `MCP_PROTOCOL_NEGOTIATION=auto` を設定していない限り、Claude Code に claude.ai コネクタサーバーまたは stdio サーバーに対して [MCP プロトコルリビジョン 2026-07-28](/docs/ja/mcp#mcp-client-runtimes) をプローブさせること582* `MCP_PROTOCOL_NEGOTIATION=auto` を設定しない限り、Claude Code に claude.ai コネクタサーバーや stdio サーバーに対して [MCP プロトコルリビジョン 2026-07-28](/docs/ja/mcp#mcp-client-runtimes) をプローブさせる

551* Git Bash がインストールされている Windows 上の claude.ai および Console アカウント用に、デフォルトで [PowerShell ツール](/docs/ja/tools-reference#powershell-tool) を取得すること。Claude Code は `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` を設定していない限り、シェルコマンドを Git Bash 経由でルーティングします。Git Bash がない Windows では、ツールはオンのままです583* Git Bash がインストールされた Windows 上の claude.ai アカウントおよび Console アカウントで、[PowerShell ツール](/docs/ja/tools-reference#powershell-tool)をデフォルトで利用する。`CLAUDE_CODE_USE_POWERSHELL_TOOL=1` を設定しない限り、Claude Code はシェルコマンドを Git Bash 経由で実行します。Git Bash のない Windows では、このツールはオンのままです

552* [Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) を取得すること。Claude Code はこれを取得されたフラグを通じてオンにします584* [Claude が下書きするフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を利用する。この機能は、Claude Code が取得したフラグによってオンにします

553* Claude が [大きなペーストを入力されたテキストではなくペーストされたテキストとして扱う](/docs/ja/terminal-config#how-claude-treats-pasted-text) こと。`[Pasted text #N]` プレースホルダの背後にあるコンテンツは、マークなしで Claude に到達します585* Claude に[大きな貼り付けを、入力したテキストではなく貼り付けたテキストとして扱わせる](/docs/ja/terminal-config#how-claude-treats-pasted-text)。`[Pasted text #N]` プレースホルダーの背後にあるコンテンツは、マークなしで Claude に届きます

554* Claude Code が [API が入力スキーマを拒否する MCP ツールを除外する](/docs/ja/mcp#tools-with-invalid-input-schemas) こと。スキーマを送信し、それを含むリクエストは [ツールの位置で名前を付けた 400 エラー](/docs/ja/errors#tool-input-schema-is-invalid) で失敗します586* Claude Code に [API が拒否する入力スキーマを持つ MCP ツールを除外させる](/docs/ja/mcp#tools-with-invalid-input-schemas)。Claude Code はそのスキーマをそのまま送信し、それを含むリクエストは[ツールを位置で示す 400 エラー](/docs/ja/errors#tool-input-schema-is-invalid)で失敗します

555 587

556<h3 id="first-session-after-an-install-or-upgrade">588<h3 id="first-session-after-an-install-or-upgrade">

557 インストールまたはアップグレード後の最初のセッション589 インストールまたはアップグレード後の最初のセッション

558</h3>590</h3>

559 591

560Claude Code をインストールした後、またはフィーチャーを追加するバージョンにアップグレードした後の最初のセッションでは、[フラグゲートされたフィーチャー](#features-that-need-feature-flag-fetching) が欠落する可能性があります。そのセッションは、後のセッションとは異なる [権限モード](/docs/ja/permission-modes#which-mode-a-session-starts-in) で開始することもできます。Claude Code はそのセッション中にフラグを取得するため、次のセッションではフィーチャーと通常の開始権限モードが存在します。592Claude Code をインストールした後、または機能が追加されたバージョンにアップグレードした後の最初のセッションでは、[フラグで制御される機能](#features-that-need-feature-flag-fetching)が利用できないことがあります。また、そのセッションは、以降のセッションとは異なる[権限モード](/docs/ja/permission-modes#which-mode-a-session-starts-in)で開始されることもあります。そのセッション中に Claude Code がフラグを取得すると、フラグはマシンに保存されるため、そのマシンでの次のセッションでは機能が利用でき、通常の開始権限モードになります。

593

594新規インストール後、`claude -p`、Agent SDK、VS Code 拡張機能などの非対話型セッションでは、Claude Code は[開始権限モードを選択する](/docs/ja/permission-modes#which-mode-a-session-starts-in)前にフラグを取得できることがありますが、必ずしもフラグを待つわけではありません。

595

596次のような構成では、最初以降のセッションも、新たに取得したフラグなしで開始されます。

597

598* **実行のたびにクリーンな環境になる場合**: 各実行が CI コンテナや、以前のセッションが保存したフラグのないその他の環境で開始される場合、すべての実行が最初のセッションになります

599* **API キーのないゲートウェイトークンの場合**: API キーなしで `ANTHROPIC_AUTH_TOKEN` を使用して認証し、`ANTHROPIC_BASE_URL` が [LLM ゲートウェイ](/docs/ja/llm-gateway)など Anthropic 以外のホストを指している場合、Claude Code にはフラグを取得するための認証情報がありません

561 600

562新規インストール後、`claude -p`、Agent SDK、または VS Code 拡張機能などの非対話型セッションでは、Claude Code は [開始権限モードを選択する](/docs/ja/permission-modes#which-mode-a-session-starts-in) 前にフラグを取得できます。601これらの構成でセッションを開始する権限モードを選択するには、[別の権限モードで開始する](/docs/ja/permission-modes#start-in-a-different-mode)を参照してください。

563 602

564<h2 id="see-also">603<h2 id="see-also">

565 関連項目604 関連項目

errors.md +19 −1

Details

369| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [設定の警告](#denying-bash-also-turns-off-the-powershell-tool) |

846**対応方法：**847**対応方法：**

847 848

848* Pro と Max では、claude.ai の [**Settings > Usage**](https://claude.ai/settings/usage) で月間支出制限を増やすか、`/usage-credits` を実行します849* Pro と Max では、claude.ai の [**Settings > Usage**](https://claude.ai/settings/usage) で月間支出制限を増やすか、`/usage-credits` を実行します

849* Team と Enterprise では、請求を管理する場合は [**Admin settings > Usage**](https://claude.ai/admin-settings/usage) で制限を増やすか、管理者に依頼します。`/usage-credits` は管理者にそのリクエストを送信します850* Team と Enterprise では、請求を管理する場合は [**Organization settings > Usage**](https://claude.ai/admin-settings/usage) で制限を増やすか、管理者に依頼します。`/usage-credits` は管理者にそのリクエストを送信します

850* チャネルの制限については、組織の所有者またはチャネルのマネージャーに claude.ai で上げるよう依頼してください。Claude Tag ドキュメントの [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) を参照してください851* チャネルの制限については、組織の所有者またはチャネルのマネージャーに claude.ai で上げるよう依頼してください。Claude Tag ドキュメントの [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) を参照してください

851* メッセージがプランのウィンドウのリセット時刻を指定する場合、代わりにそれを待つことができます852* メッセージがプランのウィンドウのリセット時刻を指定する場合、代わりにそれを待つことができます

852* `/usage` を実行して、プランのウィンドウと各リセット時刻を確認します853* `/usage` を実行して、プランのウィンドウと各リセット時刻を確認します

5636 5637

5637[バックグラウンドセッション](/docs/ja/agent-view) または `--output-format json` または `stream-json` では、Claude Code は警告をデバッグログに stderr の代わりに書き込むため、マシン読み取り出力はクリーンなままです。`--debug` で `~/.claude/debug/<session-id>.txt` でキャプチャしてください。v2.1.246 より前では、Claude Code はこれらのルールを警告なしで受け入れていました。5638[バックグラウンドセッション](/docs/ja/agent-view) または `--output-format json` または `stream-json` では、Claude Code は警告をデバッグログに stderr の代わりに書き込むため、マシン読み取り出力はクリーンなままです。`--debug` で `~/.claude/debug/<session-id>.txt` でキャプチャしてください。v2.1.246 より前では、Claude Code はこれらのルールを警告なしで受け入れていました。

5638 5639

5640<h3 id="denying-bash-also-turns-off-the-powershell-tool">

5641 Denying Bash also turns off the PowerShell tool

5642</h3>

5643

5644Bash ツール全体を削除しました。例えば `--disallowedTools Bash` を使用したか、設定ファイルのいずれかで単独の `Bash` または `Bash(*)` [拒否ルール](/docs/ja/permissions#match-all-uses-of-a-tool) を設定した場合です。Git Bash がインストールされた Windows では、[Bash を拒否すると PowerShell ツールもオフになる](/docs/ja/tools-reference#bash-deny-rules-also-turn-off-the-powershell-tool) ため、セッションはシェルツールなしで起動します。Claude Code はスタートアップ時にこの警告を出力します。

5645

5646```text theme={null}

5647Denying Bash also turns off the PowerShell tool, so Claude has neither. To use PowerShell, set CLAUDE_CODE_USE_POWERSHELL_TOOL=1.

5648```

5649

5650**対応方法：**

5651

5652* Claude に PowerShell を使用させるには、[PowerShell ツールを有効にする](/docs/ja/tools-reference#enable-the-powershell-tool) で示されているように、環境または設定ファイルの `env` ブロックで [`CLAUDE_CODE_USE_POWERSHELL_TOOL`](/docs/ja/env-vars) を `1` に設定してください。これにより、Bash 拒否ルールと並行して PowerShell ツールがオンのままになります。

5653* ツール全体ではなく特定のコマンドをブロックするには、同じ設定ファイルまたはフラグ内の単独の `Bash` エントリを、`Bash(git push *)` などのスコープ付きルールに置き換えてください。Claude は Bash ツールを保持し、PowerShell ツールは、変数も設定するかスコープ付きの [`PowerShell` 権限ルール](/docs/ja/permissions#powershell) を追加するまでオフのままです。

5654

5655[バックグラウンドセッション](/docs/ja/agent-view) または `--output-format json` または `stream-json` では、Claude Code は警告を stderr の代わりにデバッグログに書き込みます。`--debug` で実行すると `~/.claude/debug/<session-id>.txt` にキャプチャできます。v2.1.287 より前では、Claude Code は警告を出力せずに同じ方法で PowerShell ツールをオフにしていました。

5656

5639<h3 id="crosssessioninbound-must-be-one-of-accept-hold-refuse">5657<h3 id="crosssessioninbound-must-be-one-of-accept-hold-refuse">

5640 crossSessionInbound は accept、hold、refuse のいずれかである必要があります5658 crossSessionInbound は accept、hold、refuse のいずれかである必要があります

5641</h3>5659</h3>

fast-mode.md +4 −4

Details

136高速モードには以下のすべてが必要です：136高速モードには以下のすべてが必要です：

137 137

138* **Anthropic API またはサブスクリプションのみ**：高速モードは Anthropic Console API および使用量クレジットを使用する Claude サブスクリプションプランで利用可能です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または AWS 上の Claude Platform では利用できません。Console 組織は、[高速モードアクセスをプロビジョニング](#enable-fast-mode-for-your-organization)する必要もあります。138* **Anthropic API またはサブスクリプションのみ**：高速モードは Anthropic Console API および使用量クレジットを使用する Claude サブスクリプションプランで利用可能です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または AWS 上の Claude Platform では利用できません。Console 組織は、[高速モードアクセスをプロビジョニング](#enable-fast-mode-for-your-organization)する必要もあります。

139* **サブスクリプションプランで使用量クレジットが有効**：Pro、Max、Team、または Enterprise プランでは、アカウントに[使用量クレジット](/docs/ja/costs#add-usage-credits-to-your-subscription)が有効になっている必要があります。これにより、プランに含まれる使用量を超えて請求できます。有効になるまで、`/fast` は「Fast mode requires usage credits」と表示されます。有効にする方法はプランによって異なります：139* **サブスクリプションプランで使用クレジットが有効**：Pro、Max、Team、または Enterprise プランでは、アカウントで[使用クレジット](/docs/ja/costs#add-usage-credits-to-your-subscription)が有効になっている必要があります。これにより、プランに含まれる使用量を超えて課金できるようになります。有効になるまで、`/fast` は「Fast mode requires usage credits」と表示します。有効にする方法はプランによって異なります：

140 * Pro および Max では、[**Settings > Usage**](https://claude.ai/settings/usage) の **Usage credits** セクションで claude.ai で有効にするか、`/usage-credits` を実行してそのページを開きます。140 * Pro および Max では、claude.ai の [**Settings > Usage**](https://claude.ai/settings/usage) の **Usage credits** セクションで有効にするか、`/usage-credits` を実行してそのページを開きます。

141 * Team および Enterprise では、請求アクセス権を持つメンバーが [**Admin settings > Usage**](https://claude.ai/admin-settings/usage) で組織の使用量クレジットを有効にし、アクセス権を持たないメンバーが `/usage-credits` を実行して組織の管理者にリクエストを送信します。141 * Team および Enterprise では、請求アクセス権を持つメンバーが [**Organization settings > Usage**](https://claude.ai/admin-settings/usage) で組織の使用クレジットを有効にし、アクセス権を持たないメンバーは `/usage-credits` を実行して組織の管理者にリクエストを送信します。

142 142

143<Note>143<Note>

144 高速モード使用量は、プランに残りの使用量がある場合でも、使用量クレジットに直接請求されます。144 高速モード使用量は、プランに残りの使用量がある場合でも、使用量クレジットに直接請求されます。

165* **Console**（API カスタマー）：管理者が [Claude Code preferences](https://platform.claude.com/claude-code/preferences) で有効にします。高速モードは[リサーチプレビュー](#research-preview)にあるため、組織は高速モードリクエストが成功する前に高速モードアクセスをプロビジョニングする必要があります。アクセスを取得するには、アカウントマネージャーに連絡するか、[Claude API の高速モード](https://platform.claude.com/docs/en/build-with-claude/fast-mode)で説明されているようにウェイトリストに参加します。165* **Console**（API カスタマー）：管理者が [Claude Code preferences](https://platform.claude.com/claude-code/preferences) で有効にします。高速モードは[リサーチプレビュー](#research-preview)にあるため、組織は高速モードリクエストが成功する前に高速モードアクセスをプロビジョニングする必要があります。アクセスを取得するには、アカウントマネージャーに連絡するか、[Claude API の高速モード](https://platform.claude.com/docs/en/build-with-claude/fast-mode)で説明されているようにウェイトリストに参加します。

166 166

167 プロビジョニングされたアクセスがない場合、API は各高速モードリクエストを 429 で拒否し、Claude Code は各拒否を[高速モードレート制限](#handle-rate-limits)として扱います。レート制限のクールダウンとは異なり、アクセスがプロビジョニングされるまで拒否は続きます。167 プロビジョニングされたアクセスがない場合、API は各高速モードリクエストを 429 で拒否し、Claude Code は各拒否を[高速モードレート制限](#handle-rate-limits)として扱います。レート制限のクールダウンとは異なり、アクセスがプロビジョニングされるまで拒否は続きます。

168* **Claude AI**（Team および Enterprise）：所有者が [Admin Settings > Claude Code](https://claude.ai/admin-settings/claude-code) で有効にします168* **Claude AI**（Team および Enterprise）：Owner が [**Organization settings > Claude Code**](https://claude.ai/admin-settings/claude-code) で有効にします

169 169

170高速モードを完全に無効にするもう 1 つのオプションは、`CLAUDE_CODE_DISABLE_FAST_MODE=1` を設定することです。[環境変数](/docs/ja/env-vars)を参照してください。170高速モードを完全に無効にするもう 1 つのオプションは、`CLAUDE_CODE_DISABLE_FAST_MODE=1` を設定することです。[環境変数](/docs/ja/env-vars)を参照してください。

171 171

features-overview.md +3 −3

Details

250 250

251\*デフォルトでは、スキル説明はセッション開始時にロードされるため、Claude はそれらを使用する時期を決定できます。スキルの frontmatter で `disable-model-invocation: true` を設定して、手動で呼び出すまで Claude から完全に非表示にします。書いていないスキルの場合は、ファイルを編集せずに同じことを行うために settings で [`skillOverrides`](/docs/ja/skills#override-skill-visibility-from-settings) を設定します。251\*スキルのフロントマターで [`disable-model-invocation: true`](/docs/ja/skills#control-who-invokes-a-skill) を設定すると、その説明を Claude のコンテキストから除外できます。書いていないスキルの場合は、ファイルを編集せずに同じことを行うために設定で [`skillOverrides`](/docs/ja/skills#override-skill-visibility-from-settings) を設定します。

252 252

253<h3 id="understand-how-features-load">253<h3 id="understand-how-features-load">

254 機能がどのようにロードされるかを理解する254 機能がどのようにロードされるかを理解する

278 278

279 **ロード内容：** モデル呼び出し可能なスキルの場合、Claude はすべてのリクエストで名前と説明を見ます。`/<name>` でスキルを呼び出すか、Claude が自動的にロードする場合、完全なコンテンツが会話にロードされます。279 **ロード内容：** モデル呼び出し可能なスキルの場合、Claude はすべてのリクエストで名前と説明を見ます。`/<name>` でスキルを呼び出すか、Claude が自動的にロードする場合、完全なコンテンツが会話にロードされます。

280 280

281 **Claude がスキルを選択する方法：** Claude はタスクをスキル説明と照合して、関連するものを決定します。説明が曖昧または重複している場合、Claude は間違ったスキルをロードするか、役立つスキルを見落とす可能性があります。Claude に特定のスキルを使用するよう指示するには、`/<name>` で呼び出します。`disable-model-invocation: true` を持つスキルは、呼び出すまで Claude に見えません。281 **Claude がスキルを選択する方法：** Claude はタスクをスキル説明と照合して、関連するものを決定します。説明が曖昧または重複している場合、Claude は間違ったスキルをロードするか、役立つスキルを見落とす可能性があります。Claude に特定のスキルを使用するよう指示するには、`/<name>` で呼び出します。

282 282

283 **コンテキストコスト：** 使用されるまで低い。ユーザーのみのスキルは呼び出されるまでゼロコストです。283 **コンテキストコスト：** 使用されるまで低い。ユーザーのみのスキルは呼び出されるまでゼロコストです。

284 284

285 **Subagents 内：** スキルは subagents で異なる動作をします。オンデマンドロードの代わりに、subagent の `skills` フィールドにリストされているスキルは起動時にそのコンテキストに完全にプリロードされます。Subagents はスキルツールを通じて、リストされていないプロジェクト、ユーザー、プラグインスキルを発見して呼び出すことができます。285 **Subagents 内：** スキルは subagents で異なる動作をします。オンデマンドロードの代わりに、subagent の `skills` フィールドにリストされているスキルは起動時にそのコンテキストに完全にプリロードされます。Subagents はスキルツールを通じて、リストされていないプロジェクト、ユーザー、プラグインスキルを発見して呼び出すことができます。

286 286

287 <Tip>副作用を持つスキルには `disable-model-invocation: true` を使用します。これはコンテキストを節約し、あなたのみがそれらをトリガーすることを保証します。</Tip>287 <Tip>副作用を持つスキルには `disable-model-invocation: true` を使用します。これによりコンテキストを節約でき、名前を指定したときにのみ実行されるようになります。</Tip>

288 </Tab>288 </Tab>

289 289

290 <Tab title="MCP servers">290 <Tab title="MCP servers">

fullscreen.md +1 −1

Details

109* **リストの端にある `↑ N more` または `↓ N more` 行をクリック**すると、オプションを選択せずにリストのその端にジャンプします。Claude Code v2.1.286 以降が必要です。109* **リストの端にある `↑ N more` または `↓ N more` 行をクリック**すると、オプションを選択せずにリストのその端にジャンプします。Claude Code v2.1.286 以降が必要です。

110* **折りたたまれたツール結果をクリック**して展開し、完全な出力を表示します。もう一度クリックして折りたたみます。ツール呼び出しとその結果は一緒に展開されます。表示するものが多いメッセージのみがクリック可能です。110* **折りたたまれたツール結果をクリック**して展開し、完全な出力を表示します。もう一度クリックして折りたたみます。ツール呼び出しとその結果は一緒に展開されます。表示するものが多いメッセージのみがクリック可能です。

111 * クリックすると、`!` シェルコマンドの出力も展開されます。古い切り詰められた結果でも、コマンド実行中のライブ進行状況行でも同様です。Claude Code v2.1.257 以降が必要です。111 * クリックすると、`!` シェルコマンドの出力も展開されます。古い切り詰められた結果でも、コマンド実行中のライブ進行状況行でも同様です。Claude Code v2.1.257 以降が必要です。

112 * クリックすると、送信者が [チームメイト](/docs/ja/agent-teams)またはセッションで実行されている別のエージェントである場合、薄い `Message from @<sender>` 行も展開されます。[別のセッションの 1 つからのメッセージ](/docs/ja/cross-session-messaging#what-a-message-looks-like)の行は、メッセージの最初の行も表示され、クリック可能ではなく、`Ctrl+o` を押してそれを読みます。112 * クリックすると、送信者が [チームメイト](/docs/ja/agent-teams) またはセッションで実行されている別のエージェントである場合、薄い `Message from @<sender>` 行も展開されます。

113* **macOS では `Cmd` を、Linux と Windows では `Ctrl` を押しながら URL またはファイルパスをクリック**して開きます。プレーン `http://` および `https://` URL はブラウザで開き、Edit または Write の後に出力されたものなどのツール出力内のファイルパスはデフォルトアプリケーションで開きます。修飾子なしのプレーンクリックはリンクを開きません。ネイティブターミナルの動作と一致します。113* **macOS では `Cmd` を、Linux と Windows では `Ctrl` を押しながら URL またはファイルパスをクリック**して開きます。プレーン `http://` および `https://` URL はブラウザで開き、Edit または Write の後に出力されたものなどのツール出力内のファイルパスはデフォルトアプリケーションで開きます。修飾子なしのプレーンクリックはリンクを開きません。ネイティブターミナルの動作と一致します。

114 * Claude Code は、`\\server\share\file.ts` などのネットワーク（UNC）パスをプレーンテキストとしてレンダリングし、リンクはありません。ネットワークパスを開くと、Windows 認証情報がそれが指定するホストに送信される可能性があるためです。114 * Claude Code は、`\\server\share\file.ts` などのネットワーク（UNC）パスをプレーンテキストとしてレンダリングし、リンクはありません。ネットワークパスを開くと、Windows 認証情報がそれが指定するホストに送信される可能性があるためです。

115 * 一部の macOS ターミナルは `Cmd`+クリックをターミナル自体ではなく実行中のアプリに転送し、ターミナルマウスプロトコルには `Cmd` キーをエンコードする方法がないため、Claude Code はプレーンクリックを受け取ります。Ghostty および macOS の Warp では、Claude Code はこれを検出し、リンク上のプレーンクリックでそれを開くことができ、`Cmd` を押したままでも機能します。115 * 一部の macOS ターミナルは `Cmd`+クリックをターミナル自体ではなく実行中のアプリに転送し、ターミナルマウスプロトコルには `Cmd` キーをエンコードする方法がないため、Claude Code はプレーンクリックを受け取ります。Ghostty および macOS の Warp では、Claude Code はこれを検出し、リンク上のプレーンクリックでそれを開くことができ、`Cmd` を押したままでも機能します。

google-vertex-ai.md +17 −0

Details

295 295

296これらのチェックがプロジェクトが呼び出せないモデルを見つけた場合、Claude Code はこのマシン上でその拒否を最大 1 日間記憶し、その間の起動時に記憶されたモデルをスキップして Agent Platform に再度問い合わせません。Claude Code は、現在のデフォルトモデルの記憶された拒否を、最後のチェック以降 10 分が経過した後に起動時に再度チェックするため、管理者が再度有効にしたデフォルトが戻ります。メモリをオフにするには、[`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/ja/env-vars)を設定してください。296これらのチェックがプロジェクトが呼び出せないモデルを見つけた場合、Claude Code はこのマシン上でその拒否を最大 1 日間記憶し、その間の起動時に記憶されたモデルをスキップして Agent Platform に再度問い合わせません。Claude Code は、現在のデフォルトモデルの記憶された拒否を、最後のチェック以降 10 分が経過した後に起動時に再度チェックするため、管理者が再度有効にしたデフォルトが戻ります。メモリをオフにするには、[`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/ja/env-vars)を設定してください。

297 297

298<h3 id="when-your-organization-enforces-a-model-allowlist">

299 組織がモデル許可リストを強制している場合

300</h3>

301

302管理設定で [`enforceAvailableModels`](/docs/ja/model-config#enforce-the-allowlist-for-the-default-model) を設定すると、起動時のモデルチェックは `availableModels` リストで許可されたモデルのみを使用します。これには Claude Code v2.1.287 以降が必要です。`enforceAvailableModels` のないリストは、これらのチェックを制限しません。

303

304チェックでは各エントリを Agent Platform に送信するモデル ID と比較するため、リストはそれらの ID で記述してください。次の例では Opus 4.8 と Sonnet 4.5 を許可します。

305

306```json theme={null}

307{

308 "availableModels": ["claude-opus-4-8", "claude-sonnet-4-5@20250929"],

309 "enforceAvailableModels": true

310}

311```

312

313エイリアス、バージョンプレフィックス、`modelOverrides` エントリについては、[サードパーティデプロイ向けにモデルをピン留めする](/docs/ja/model-config#pin-models-for-third-party-deployments)を参照してください。

314

298<h3 id="when-a-model-is-disabled-mid-session">315<h3 id="when-a-model-is-disabled-mid-session">

299 セッション中にモデルが無効化された場合316 セッション中にモデルが無効化された場合

300</h3>317</h3>

headless.md +1 −1

Details

59| システムプロンプト追加 | `--append-system-prompt`、`--append-system-prompt-file` |59| システムプロンプト追加 | `--append-system-prompt`、`--append-system-prompt-file` |

60| 設定 | `--settings <file-or-json>` |60| 設定 | `--settings <file-or-json>` |

61| MCP サーバー | `--mcp-config <file-or-json>` |61| MCP サーバー | `--mcp-config <file-or-json>` |

63| プラグイン | `--plugin-dir <path>`、`--plugin-url <url>` |63| プラグイン | `--plugin-dir <path>`、`--plugin-url <url>` |

64 64

65bare モードでは、セッションの実行中に行われる処理も制限されます。65bare モードでは、セッションの実行中に行われる処理も制限されます。

hooks.md +46 −10

Details

438| フィールド | 必須 | 説明 |438| フィールド | 必須 | 説明 |

439| :- | :- | :- |439| :- | :- | :- |

440| `type` | はい | `"command"`、`"http"`、`"mcp_tool"`、`"prompt"`、または `"agent"` |440| `type` | はい | `"command"`、`"http"`、`"mcp_tool"`、`"prompt"`、または `"agent"` |

441| `if` | いいえ | `"Bash(git *)"` または `"Edit(*.ts)"` などの権限ルール構文を使用してこのフックが実行されるタイミングをフィルタリングします。ツール呼び出しがパターンにマッチする場合のみ、フックコマンドが実行されます。Bash パターンがサブコマンド、`$()`、バッククォートに対してどのように評価されるかについては、後述の [Bash マッチングテーブル](#bash-if-matching)を参照してください。ツールイベントでのみ評価されます。`PreToolUse`、`PostToolUse`、`PostToolUseFailure`、`PermissionRequest`、`PermissionDenied`。他のイベントでは、`if` が設定されたフックは実行されません。[権限ルール](/docs/ja/permissions)と同じ構文を使用します |441| `if` | いいえ | このフックが実行されるタイミングをフィルタリングする[権限ルール構文](/docs/ja/permissions#permission-rule-syntax)（`"Bash(git *)"` や `"Edit(*.ts)"` など）。ツール呼び出しがパターンにマッチする場合のみ、フックコマンドが実行されます。Bash パターンがサブコマンド、`$()`、バッククォートに対してどのように評価されるかについては、[Bash マッチングテーブル](#bash-if-matching)を参照してください。ツールイベントでのみ評価されます: `PreToolUse`、`PostToolUse`、`PostToolUseFailure`、`PermissionRequest`、`PermissionDenied`。他のイベントでは、`if` が設定されたフックは実行されません |

442| `timeout` | いいえ | キャンセルまでの秒数。[`async: true`](#run-hooks-in-the-background) で実行するコマンドフックには、Claude Code はこれを適用しません。デフォルト: `command`、`http`、`mcp_tool` は 600、`prompt` は 30、`agent` は 60。Claude Code は、[`UserPromptSubmit`](#userpromptsubmit)、[`PreModelSwitch`](#premodelswitch)、[`PostModelSwitch`](#postmodelswitch) では `command`、`http`、`mcp_tool` のデフォルトを 30 に、[`MessageDisplay`](#messagedisplay) では 10 に下げます。[`SessionEnd`](#sessionend) フックは 1.5 秒の予算を共有します。設定でフックごとにより長い `timeout` を指定している場合、Claude Code は最大 60 秒までそれに合わせて予算を引き上げます |442| `timeout` | いいえ | キャンセルまでの秒数。[`async: true`](#run-hooks-in-the-background) で実行するコマンドフックには、Claude Code はこれを適用しません。デフォルト: `command`、`http`、`mcp_tool` は 600、`prompt` は 30、`agent` は 60。Claude Code は、[`UserPromptSubmit`](#userpromptsubmit)、[`PreModelSwitch`](#premodelswitch)、[`PostModelSwitch`](#postmodelswitch) では `command`、`http`、`mcp_tool` のデフォルトを 30 に、[`MessageDisplay`](#messagedisplay) では 10 に下げます。[`SessionEnd`](#sessionend) フックは 1.5 秒の予算を共有します。設定でフックごとにより長い `timeout` を指定している場合、Claude Code は最大 60 秒までそれに合わせて予算を引き上げます |

443| `statusMessage` | いいえ | フックの実行中に表示されるカスタムスピナーメッセージ |443| `statusMessage` | いいえ | フックの実行中に表示されるカスタムスピナーメッセージ |

444| `once` | いいえ | `true` の場合、Claude Code は最初の実行が成功した後にフックを削除します。失敗した実行、終了コード 2 でブロックした実行、またはタイムアウトした実行ではフックがそのまま残るため、次にマッチするイベントで再び実行されます。[スキルのフロントマター](#hooks-in-skills-and-agents)で宣言されたフックでのみ有効です。設定ファイルとエージェントのフロントマターでは無視されます |444| `once` | いいえ | `true` の場合、Claude Code は最初の実行が成功した後にフックを削除します。失敗した実行、終了コード 2 でブロックした実行、またはタイムアウトした実行ではフックがそのまま残るため、次にマッチするイベントで再び実行されます。[スキルのフロントマター](#hooks-in-skills-and-agents)で宣言されたフックでのみ有効です。設定ファイルとエージェントのフロントマターでは無視されます |

447 447

448ファイルツールの `if` 条件では、`"Edit(src/**)"` のような単一セグメントのディレクトリパターンは、作業ディレクトリ内の `src` ディレクトリとその配下のファイルにのみマッチします。任意の深さにある `src` という名前のディレクトリにマッチさせるには、`"Edit(**/src/**)"` と記述します。v2.1.214 より前は、`"Edit(src/**)"` は作業ディレクトリ配下の任意の深さにある `src` という名前のディレクトリにマッチしていました。448ファイルツールの `if` 条件では、`"Edit(src/**)"` のような単一セグメントのディレクトリパターンは、作業ディレクトリ内の `src` ディレクトリとその配下のファイルにのみマッチします。任意の深さにある `src` という名前のディレクトリにマッチさせるには、`"Edit(**/src/**)"` と記述します。v2.1.214 より前は、`"Edit(src/**)"` は作業ディレクトリ配下の任意の深さにある `src` という名前のディレクトリにマッチしていました。

449 449

450<span id="bash-if-matching" />Bash パターンの場合、フックコマンドが実行されるかどうかは、パターンの形状と Claude が呼び出している Bash コマンドに依存します。先頭の `VAR=value` 割り当ては、マッチング前に削除されます。450<h4 id="bash-if-matching">

451 `if` パターンが Bash コマンドにマッチする仕組み

452</h4>

453

454[`if` フィールド](#common-fields)の Bash パターンの場合、フックコマンドが実行されるかどうかは、パターンの形状と Claude が呼び出している Bash コマンドに依存します。先頭の `VAR=value` 割り当ては、マッチング前に削除されます。

451 455

453| :- | :- | :- | :- |457| :- | :- | :- | :- |

1913 1917

1914| フィールド | 型 | 例 | 説明 |1918| フィールド | 型 | 例 | 説明 |

1915| :- | :- | :- | :- |1919| :- | :- | :- | :- |

1916| `questions` | array | `[{"question": "Which framework?", "header": "Framework", "options": [{"label": "React"}], "multiSelect": false}]` | 提示する質問。それぞれ `question` 文字列、短い `header`、`options` 配列、省略可能な `multiSelect` フラグを持ちます |1920| `questions` | array | `[{"question": "Which framework?", "header": "Framework", "options": [{"label": "React", "description": "Component library"}, {"label": "Vue", "description": "Progressive framework"}], "multiSelect": false}]` | 提示する質問。それぞれ `question` 文字列、短い `header`、`options` 配列、オプションの `multiSelect` フラグを持ちます |

1917| `answers` | object | `{"Which framework?": "React"}` | 省略可。質問のテキストを選択されたオプションのラベルに対応付けます。複数選択の回答は、ラベルをカンマで連結します。Claude はこのフィールドを設定しません。プログラムで回答するには `updatedInput` 経由で指定してください |1921| `answers` | object | `{"Which framework?": "React"}` | 省略可。質問のテキストを選択されたオプションのラベルに対応付けます。複数選択の回答は、ラベルをカンマで連結します。Claude はこのフィールドを設定しません。プログラムで回答するには `updatedInput` 経由で指定してください |

1918 1922

1919<h5 id="exitplanmode">1923<h5 id="exitplanmode">

1965}1969}

1966```1970```

1967 1971

1968<span id="allow-with-updatedinput" />1972<Note>

1973 PreToolUse では以前はトップレベルの `decision` と `reason` フィールドを使用していましたが、これらはこのイベントでは非推奨です。代わりに `hookSpecificOutput.permissionDecision` と `hookSpecificOutput.permissionDecisionReason` を使用してください。非推奨の値 `"approve"` と `"block"` は、それぞれ `"allow"` と `"deny"` に対応します。PostToolUse や Stop などの他のイベントでは、引き続きトップレベルの `decision` と `reason` が現在の形式として使用されます。

1974</Note>

1969 1975

1970`-p` フラグを使った[非対話モード](/docs/ja/headless)では、Claude Code は、Agent SDK の `canUseTool` コールバックなど、プロンプトを受け取る[権限ホスト](/docs/ja/headless#turn-off-permission-prompts-in-unattended-runs)が実行にある場合にのみ、`AskUserQuestion` と `ExitPlanMode` を提供します。これらのツールにはユーザーの操作が必要です。`permissionDecision: "allow"` を `updatedInput` とともに返すと、その要件を満たせます。フックは stdin からツールの入力を読み取り、独自の UI で回答を収集し、それを `updatedInput` で返すことで、ツールはプロンプトなしで実行されます。これらのツールでは、`"allow"` だけを返しても十分ではありません。`AskUserQuestion` の場合は、元の `questions` 配列をそのまま返し、各質問のテキストを選択された回答に対応付ける [`answers`](#askuserquestion) オブジェクトを追加してください。1976<h4 id="allow-with-updatedinput">

1977 ユーザーの操作を必要とするツール

1978</h4>

1971 1979

1972サーバーが [`_meta["anthropic/requiresUserInteraction"]`](/docs/ja/mcp#require-approval-for-a-specific-tool) でマークした MCP ツールはさらに厳格です。フックは `updatedInput` の有無にかかわらず、`"allow"` でその承認プロンプトをスキップすることはできません。ツールが必要とする操作をフックが収集したことを Claude Code が確認できないためです。1980`AskUserQuestion` と `ExitPlanMode` はユーザーの操作を必要とします。`-p` フラグを使用した[非対話モード](/docs/ja/headless)では、Agent SDK の `canUseTool` コールバックなど、プロンプトを受け取る[権限ホスト](/docs/ja/headless#turn-off-permission-prompts-in-unattended-runs)が実行にある場合にのみ、Claude Code はこれらのツールを提供します。

1973 1981

1974<Note>1982`PreToolUse` フックは、次のことを行う場合にその要件を満たします。

1975 PreToolUse は以前はトップレベルの `decision` と `reason` フィールドを使用していましたが、このイベントではこれらは非推奨です。代わりに `hookSpecificOutput.permissionDecision` と `hookSpecificOutput.permissionDecisionReason` を使用してください。非推奨の値 `"approve"` と `"block"` は、それぞれ `"allow"` と `"deny"` に対応します。PostToolUse や Stop などの他のイベントでは、現在の形式としてトップレベルの `decision` と `reason` を引き続き使用します。1983

1976</Note>19841. stdin からツールの入力を読み取る

19852. 独自の UI を通じて回答を収集する

19863. 回答を保持する `updatedInput` とともに `permissionDecision: "allow"` を返し、プロンプトを表示せずにツールが実行されるようにする

1987

1988これらのツールでは、`"allow"` を返すだけでは不十分です。

1989

1990`AskUserQuestion` の場合は、元の `questions` 配列をそのまま返し、各質問のテキストを選択された回答に対応付ける [`answers`](#askuserquestion) オブジェクトを追加します。次の出力は、1 つの質問に `React` と回答します。

1991

1992```json theme={null}

1993{

1994 "hookSpecificOutput": {

1995 "hookEventName": "PreToolUse",

1996 "permissionDecision": "allow",

1997 "updatedInput": {

1998 "questions": [

1999 {

2000 "question": "Which framework?",

2001 "header": "Framework",

2002 "options": [{"label": "React", "description": "Component library"}, {"label": "Vue", "description": "Progressive framework"}],

2003 "multiSelect": false

2004 }

2005 ],

2006 "answers": {"Which framework?": "React"}

2007 }

2008 }

2009}

2010```

2011

2012サーバーが [`_meta["anthropic/requiresUserInteraction"]`](/docs/ja/mcp#require-approval-for-a-specific-tool) でマークした MCP ツールはさらに厳格です。フックは `updatedInput` の有無にかかわらず、`"allow"` でその承認プロンプトをスキップすることはできません。ツールが必要とする操作をフックが収集したことを Claude Code が確認できないためです。

1977 2013

1978<h4 id="defer-a-tool-call-for-later">2014<h4 id="defer-a-tool-call-for-later">

1979 ツール呼び出しを後で実行するために延期する2015 ツール呼び出しを後で実行するために延期する

2000 "deferred_tool_use": {2036 "deferred_tool_use": {

2001 "id": "toolu_01abc",2037 "id": "toolu_01abc",

2002 "name": "AskUserQuestion",2038 "name": "AskUserQuestion",

2003 "input": { "questions": [{ "question": "Which framework?", "header": "Framework", "options": [{"label": "React"}, {"label": "Vue"}], "multiSelect": false }] }2039 "input": { "questions": [{ "question": "Which framework?", "header": "Framework", "options": [{"label": "React", "description": "Component library"}, {"label": "Vue", "description": "Progressive framework"}], "multiSelect": false }] }

2004 }2040 }

2005}2041}

2006```2042```

interactive-mode.md +2 −0

Details

470* アカウントが使用制限に近い、またはその制限に達している場合。制限に達するまで提案をオンのままにするには、[`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/ja/env-vars) を `true` に設定します。v2.1.238 より前では、変数が `true` に設定されていても、Claude Code は制限に近い場合にそれらをスキップしていました470* アカウントが使用制限に近い、またはその制限に達している場合。制限に達するまで提案をオンのままにするには、[`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/ja/env-vars) を `true` に設定します。v2.1.238 より前では、変数が `true` に設定されていても、Claude Code は制限に近い場合にそれらをスキップしていました

471* [agent team](/docs/ja/agent-teams) では、デフォルトでチームメイトのセッションで。リーダーのセッションは提案を表示します471* [agent team](/docs/ja/agent-teams) では、デフォルトでチームメイトのセッションで。リーダーのセッションは提案を表示します

472 472

473`Showing fewer prompt suggestions · use one to bring them back` という通知は、提案を使用しないまま連続して多数見送ったため、Claude Code が提案を表示する頻度を下げていることを意味します。通常の頻度に戻すには、提案を使用するか、[`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`](/docs/ja/env-vars) を `true` に設定します。

474

473Print Mode では、Claude Code はデフォルトでは提案を生成しません。Claude Code が生成した各ターンの後に `prompt_suggestion` メッセージを出力するには、`-p "<prompt>" --output-format stream-json --verbose` で [`--prompt-suggestions`](/docs/ja/cli-reference#cli-flags) を渡します。ジェネレータはここでも非常に短い会話とコールドプロンプトキャッシュをスキップするため、単一の短い `-p` クエリは何も出力しない可能性があります。475Print Mode では、Claude Code はデフォルトでは提案を生成しません。Claude Code が生成した各ターンの後に `prompt_suggestion` メッセージを出力するには、`-p "<prompt>" --output-format stream-json --verbose` で [`--prompt-suggestions`](/docs/ja/cli-reference#cli-flags) を渡します。ジェネレータはここでも非常に短い会話とコールドプロンプトキャッシュをスキップするため、単一の短い `-p` クエリは何も出力しない可能性があります。

474 476

475<h3 id="turn-prompt-suggestions-off">477<h3 id="turn-prompt-suggestions-off">

keybindings.md +4 −0

Details

464| :- | :- | :- |464| :- | :- | :- |

467| `agents:find` | Ctrl+F | [`n:` フィルター](/docs/ja/agent-view#filter-sessions) を使って名前でセッションを検索します。v2.1.288 以降が必要 |

468| `agents:rename` | Ctrl+R | 選択したセッションの [名前を変更](/docs/ja/agent-view#organize-the-list) します。v2.1.288 以降が必要 |

469| `agents:previousGroup` | Ctrl+Up、Meta+Up | 前の [グループヘッダー](/docs/ja/agent-view#organize-the-list) にジャンプします。v2.1.288 以降が必要 |

470| `agents:nextGroup` | Ctrl+Down、Meta+Down | 次のグループヘッダーにジャンプします。v2.1.288 以降が必要 |

467 471

468エージェントビューが開いている間、Claude Code は `Agents` コンテキストがバインドするキーに対して `Agents` バインディングを使用し、同じキーの `Chat` または `Global` バインディングを無視します。例えば、エージェントビューで Ctrl+S を押すと、デフォルトの `chat:stash` をトリガーするのではなく、セッショングループ化を切り替えます。472エージェントビューが開いている間、Claude Code は `Agents` コンテキストがバインドするキーに対して `Agents` バインディングを使用し、同じキーの `Chat` または `Global` バインディングを無視します。例えば、エージェントビューで Ctrl+S を押すと、デフォルトの `chat:stash` をトリガーするのではなく、セッショングループ化を切り替えます。

469 473

managed-mcp.md +61 −29

Details

282 282

283allowlist と denylist は、設定されたサーバーのうちどれをロードできるかをフィルタリングします。これらはレジストリではなく、allowlist または denylist が適用される前に、ユーザー、プラグイン、または組織によってサーバーを追加する必要があります。283allowlist と denylist は、設定されたサーバーのうちどれをロードできるかをフィルタリングします。これらはレジストリではなく、allowlist または denylist が適用される前に、ユーザー、プラグイン、または組織によってサーバーを追加する必要があります。

284 284

285組織が `managedMcpServers` を通じて配信するサーバーは allowlist エントリなしでロードされ、[サーバーの評価方法](#how-a-server-is-evaluated)は `managed-mcp.json` サーバーについて説明しています。denylist はインプロセス `type: "sdk"` エントリを除き、どこから来たサーバーにも適用されます。285組織が `managedMcpServers` を通じて配信するサーバーは許可リストのエントリなしでロードされます。`managed-mcp.json` サーバーについては、[許可リストのチェックをスキップするサーバー](#servers-that-skip-the-allowlist-check)で説明しています。拒否リストはインプロセスの `type: "sdk"` エントリを除き、どこから来たサーバーにも適用されます。

286 286

287サーバーをユーザーに配信するには、[`managed-mcp.json`](#exclusive-control-with-managed-mcp-json) または [`managedMcpServers`](#provide-servers-through-managed-settings) を使用します。両方のリストは、インプロセス `type: "sdk"` エントリを除き、[`--mcp-config` CLI フラグ](/docs/ja/cli-reference#cli-flags)で渡されたサーバーもフィルタリングします。`--strict-mcp-config` はどの設定ファイルをロードするかを制限し、どちらのリストもバイパスしません。287サーバーをユーザーに配信するには、[`managed-mcp.json`](#exclusive-control-with-managed-mcp-json) または [`managedMcpServers`](#provide-servers-through-managed-settings) を使用します。両方のリストは、インプロセス `type: "sdk"` エントリを除き、[`--mcp-config` CLI フラグ](/docs/ja/cli-reference#cli-flags)で渡されたサーバーもフィルタリングします。`--strict-mcp-config` はどの設定ファイルをロードするかを制限し、どちらのリストもバイパスしません。

288 288

308| :- | :- | :- |308| :- | :- | :- |

312 312

313`allowedMcpServers` を設定しないことは、空の配列に設定することとは異なります。313`allowedMcpServers` を設定しないことは、空の配列に設定することとは異なります。

314 314

316| :- | :- | :- | :- |316| :- | :- | :- | :- |

319 319

320エントリがスキーマ検証に失敗した場合の詳細は、[管理設定の無効なエントリ](/docs/ja/managed-settings#invalid-entries-in-managed-settings)を参照してください。320エントリがスキーマ検証に失敗した場合の詳細は、[管理設定の無効なエントリ](/docs/ja/managed-settings#invalid-entries-in-managed-settings)を参照してください。

321 321

322<h4 id="how-servername-entries-match">

323 `serverName` エントリのマッチ方法

324</h4>

325

326`serverName` エントリは、ユーザーが割り当てたラベルに完全一致でマッチし、ワイルドカードは使用できません。

327

322<Warning>328<Warning>

323 どちらのリストでも `serverName` エントリはセキュリティ制御ではありません。名前は `claude mcp add` を実行するか設定ファイルを編集するときにユーザーが割り当てるラベルであり、基盤となるサーバーではないため、ユーザーは任意のサーバーを `github` と呼ぶことができます。claude.ai コネクタの場合、名前は claude.ai が返す表示名であり、変更される可能性があります。実際に実行されるサーバーを強制するには、`serverCommand` または `serverUrl` エントリを追加します。329 どちらのリストでも `serverName` エントリはセキュリティ制御ではありません。名前は `claude mcp add` を実行するか設定ファイルを編集するときにユーザーが割り当てるラベルであり、基盤となるサーバーではないため、ユーザーは任意のサーバーを `github` と呼ぶことができます。claude.ai コネクタの場合、名前は claude.ai が返す表示名であり、変更される可能性があります。実際に実行されるサーバーを強制するには、`serverCommand` または `serverUrl` エントリを追加します。

324</Warning>330</Warning>

330 336

331Claude Code がフェッチするすべての claude.ai コネクタをオフにするには、[`disableClaudeAiConnectors`](/docs/ja/mcp#disable-claude-ai-connectors)を参照してください。337Claude Code がフェッチするすべての claude.ai コネクタをオフにするには、[`disableClaudeAiConnectors`](/docs/ja/mcp#disable-claude-ai-connectors)を参照してください。

332 338

333<h3 id="how-a-server-is-evaluated">339<h4 id="how-servercommand-entries-match">

334 サーバーの評価方法340 `serverCommand` エントリのマッチ方法

335</h3>341</h4>

~~336~~

337サーバーをロードする前に、`managed-mcp.json` からのサーバーを含めて、Claude Code は以下の 3 つのチェックを順番に実行します。ユーザーがサーバーを再接続するか、`/mcp` で無効なサーバーをオンに戻すときに再度実行されます。インプロセス `type: "sdk"` サーバー（[セッションを開始したアプリが登録](/docs/ja/mcp#how-connectors-reach-claude-code)）は、3 つすべてをスキップします。

~~338~~

3391. **リストをマージします。** すべての設定スコープからの allowlist と denylist エントリが 1 つの allowlist と 1 つの denylist に結合されます。`allowManagedMcpServersOnly` が `true` の場合、管理 allowlist のみが保持されます。denylist は常にすべてのスコープからマージされます。複数の管理ソースが存在する場合、[すべての管理ソースから読み取られるキー](/docs/ja/managed-settings#keys-read-from-every-admin-source)は、管理スコープのリストを提供するソースを示しています。

3402. **denylist をチェックします。** URL、コマンド、または名前で denylist エントリにマッチするサーバーはブロックされます。denylist マッチをオーバーライドするものはありません。

3413. **allowlist をチェックします。** `allowedMcpServers` がどこにも設定されていない場合、denylist を通過したすべてのサーバーがロードされます。設定されている場合、サーバーがマッチする必要があるものはそのタイプに依存し、以下の表に示されています。

~~342~~

343 3 つのサーバーグループはこのチェックをスキップします。

344 342

345 * 組織自身のサーバー：すべての `managedMcpServers` エントリ、および `${VAR}` 展開を使用しない値を持つ `managed-mcp.json` エントリ。343`serverCommand` エントリは、`{ "serverCommand": ["npx", "-y", "server"] }` のように、コマンドとその引数を 1 つの配列として保持します。Claude Code はその配列を、サーバーの設定内のコマンドおよび引数と比較します。

346 * Chrome の Claude、Claude Code が実行中の VS Code または JetBrains IDE に接続する `ide` サーバー、CLI 自身が設定するサーバーなどの組み込みサーバー。

347 * [Claude Tag](/docs/ja/claude-tag) セッションの Slack ツール：スレッドを読み取り、返信を投稿するために使用するサーバーは allowlist エントリなしでロードされます。

348 344

349 コマンド、引数、`env`、URL、またはヘッダーで `${VAR}` 展開を使用する `managed-mcp.json` サーバーはまだチェックされます。ユーザー、プラグイン、claude.ai が追加するすべてのサーバー、および `--mcp-config` でユーザーが渡すすべてのサーバーも同様です。345* **コマンドは完全にマッチします。** すべての引数、順番に。`["npx", "-y", "server"]` は `["npx", "server"]` または `["npx", "-y", "server", "--flag"]` にマッチしません。

346* **`env` ブロックは比較されません。** `["node", "server.js"]` は、任意の `env` 値でそのコマンドを実行するサーバーにマッチします。一部の環境変数は、起動時に `node` が読み込む内容を変更します。`env` の値を自分で設定するには、[`managed-mcp.json`](#exclusive-control-with-managed-mcp-json) でサーバーを定義します。

350 347

351| サーバータイプ | マッチ時に許可される |348<h4 id="how-serverurl-entries-match">

352| :- | :- |349 `serverUrl` エントリのマッチ方法

353| リモート（HTTP または SSE） | `serverUrl` エントリ。`serverName` マッチは allowlist に `serverUrl` エントリが含まれていない場合にのみカウントされます |350</h4>

354| stdio | `serverCommand` エントリ。`serverName` マッチは allowlist に `serverCommand` エントリが含まれていない場合にのみカウントされます |

355 351

356これらのチェック内で 3 つのマッチングルールが適用されます。352URL はパターン内の任意の場所（スキームを含む）で `*` ワイルドカードをサポートします。ホスト名のマッチングは大文字と小文字を区別せず、末尾の FQDN ドットを無視するため、`https://Mcp.Example.com/*` は `https://mcp.example.com/api` にマッチします。パスは大文字と小文字を区別したままです。

357 353

358* **コマンドは完全にマッチします。** すべての引数、順番に。`["npx", "-y", "server"]` は `["npx", "server"]` または `["npx", "-y", "server", "--flag"]` にマッチしません。354以下の表は、一般的なパターンが許可する内容を示しています。

359* **`serverCommand` と `serverUrl` の値はマッチング前に展開されます。** ポリシーエントリとサーバーの設定値の両方が [`${VAR}` と `${VAR:-default}` 展開](/docs/ja/mcp#environment-variable-expansion-in-mcp-json)を通過するため、`["${HOME}/bin/server"]` として書かれたエントリは、同じ参照または展開されたパスのいずれかを使用するサーバー設定にマッチします。Windows では、`${HOME}` の代わりに `${USERPROFILE}` など、そこで設定されている環境変数を参照します。`serverName` の値は文字通りマッチし、展開されません。両側は異なる環境を読みます。[ポリシーエントリの展開方法](#how-policy-entries-expand)は、どちらであるか、および allowlist と denylist エントリがどのように異なるかについて説明しています。

360* **URL は `*` ワイルドカード**をパターン内の任意の場所（スキームを含む）でサポートします。ホスト名マッチングは大文字と小文字を区別せず、末尾の FQDN ドットを無視するため、`https://Mcp.Example.com/*` は `https://mcp.example.com/api` にマッチします。パスは大文字と小文字を区別したままです。

361 355

362| パターン | 許可 |356| パターン | 許可 |

363| :- | :- |357| :- | :- |

368| `*://mcp.example.com/*` | 特定のドメインへの任意のスキーム |362| `*://mcp.example.com/*` | 特定のドメインへの任意のスキーム |

369 363

370<h4 id="how-policy-entries-expand">364<h4 id="how-policy-entries-expand">

371 ポリシーエントリの展開方法365 `serverCommand` および `serverUrl` エントリ内の環境変数

372</h4>366</h4>

373 367

374サーバーの設定値は、`.mcp.json` の残りの部分と同様に、ライブプロセス環境から展開されます。ポリシーエントリは代わりにピン留めされた環境から展開されるため、プロジェクトまたはユーザー設定ファイルによって設定された変数が allowlist エントリの意味を変更することはできません。ポリシーエントリはまだ参照する任意の変数の起動シェルの値に依存するため、強制に依存するエントリには文字通りの URL とコマンドを使用します。368`serverCommand` と `serverUrl` の値はマッチング前に展開されます。ポリシーエントリとサーバーの設定値の両方が [`${VAR}` と `${VAR:-default}` 展開](/docs/ja/mcp#environment-variable-expansion-in-mcp-json)を通過するため、`["${HOME}/bin/server"]` として書かれたエントリは、同じ参照または展開後のパスのいずれかを使用するサーバー設定にマッチします。`serverName` の値は文字どおりにマッチし、展開されることはありません。

369

370両側は異なる環境を読み取ります。

371

372* **サーバーの設定値**：`.mcp.json` の他の部分と同様に、実行中のプロセス環境から展開されます

373* **ポリシーエントリ**：固定された環境から展開されるため、プロジェクトまたはユーザー設定ファイルによって設定された変数が許可リストエントリの意味を変更することはできません

374

375ポリシーエントリは、参照する変数について依然として起動元シェルの値に依存するため、強制に依存するエントリにはリテラルの URL とコマンドを使用してください。

376

377Windows では、`${HOME}` の代わりに `${USERPROFILE}` など、Windows 上で設定されている環境変数を参照してください。

378

3792 つのリストでは展開のされ方が異なります。

375 380

376| エントリリスト | 展開元 | URL エントリのスキーム、ホスト、またはパススコープを変更する展開 |381| エントリリスト | 展開元 | URL エントリのスキーム、ホスト、またはパススコープを変更する展開 |

377| - | - | - |382| - | - | - |

380 385

381Claude Code v2.1.219 以降が必要です。386固定された環境とこの表のルールには、Claude Code v2.1.219 以降が必要です。

387

388<h3 id="how-a-server-is-evaluated">

389 サーバーの評価方法

390</h3>

391

392サーバーをロードする前に、`managed-mcp.json` からのサーバーを含めて、Claude Code は以下の 3 つのチェックを順番に実行します。ユーザーがサーバーを再接続したとき、または `/mcp` で無効なサーバーをオンに戻したときにも再度実行されます。インプロセスの `type: "sdk"` サーバー（[セッションを開始したアプリが登録](/docs/ja/mcp#how-connectors-reach-claude-code)するもの）は、3 つすべてをスキップします。

393

3941. **リストをマージします。** すべての設定スコープからの許可リストと拒否リストのエントリが 1 つの許可リストと 1 つの拒否リストに結合されます。`allowManagedMcpServersOnly` が `true` の場合、管理許可リストのみが保持されます。拒否リストは常にすべてのスコープからマージされます。複数の管理ソースが存在する場合、どのソースが管理スコープのリストを提供するかは[すべての管理ソースから読み取られるキー](/docs/ja/managed-settings#keys-read-from-every-admin-source)で説明しています。

3952. **拒否リストをチェックします。** URL、コマンド、または名前で拒否リストのエントリにマッチするサーバーはブロックされます。拒否リストのマッチを上書きするものはありません。

3963. **許可リストをチェックします。** [一部のサーバーはこのチェックをスキップします](#servers-that-skip-the-allowlist-check)。`allowedMcpServers` がどこにも設定されていない場合、拒否リストを通過したすべてのサーバーがロードされます。設定されている場合、サーバーがマッチする必要がある対象はそのタイプによって異なり、以下の表に示すとおりです。

397

398| サーバータイプ | マッチ時に許可される |

399| :- | :- |

400| リモート（HTTP または SSE） | `serverUrl` エントリ。`serverName` のマッチは、許可リストに `serverUrl` エントリが含まれていない場合にのみカウントされます |

401| stdio | `serverCommand` エントリ。`serverName` のマッチは、許可リストに `serverCommand` エントリが含まれていない場合にのみカウントされます |

402

403<h4 id="servers-that-skip-the-allowlist-check">

404 許可リストのチェックをスキップするサーバー

405</h4>

406

407[3 つすべてのチェック](#how-a-server-is-evaluated)をスキップするインプロセスの `type: "sdk"` サーバーに加えて、3 つのサーバーグループが許可リストのチェックをスキップします。

408

409* 組織自身のサーバー：すべての `managedMcpServers` エントリ、および値に `${VAR}` 展開を使用しない `managed-mcp.json` エントリ。

410* Claude in Chrome、実行中の VS Code または JetBrains IDE に Claude Code が接続する `ide` サーバー、CLI 自身が設定するサーバーなどの組み込みサーバー。

411* [Claude Tag](/docs/ja/claude-tag) セッションの Slack ツール：スレッドを読み取り、返信を投稿するために使用するサーバーは許可リストのエントリなしでロードされます。

412

413コマンド、引数、`env`、URL、またはヘッダーで `${VAR}` 展開を使用する `managed-mcp.json` サーバーは、引き続きチェックされます。Claude Code は、ユーザー、プラグイン、または claude.ai が追加するすべてのサーバー、および `--mcp-config` でユーザーが渡すすべてのサーバーもチェックします。

382 414

383<h3 id="example-configuration">415<h3 id="example-configuration">

384 設定例416 設定例

managed-settings.md +3 −1

Details

271 Claude Code v2.1.273 以降では、`allowManagedMcpServersOnly` がオンの間、1 つを設定する最も高いランクの管理者ソースからの `allowedMcpServers` リストが適用され、親のものをブロックします。これは[クロスソースキー](#keys-read-from-every-admin-source)です。親のリストは、管理者ソースがリストを設定しない場合にのみ適用されます。[`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior) エントリは `"merge"` の下で各キーを提供するソースを示します。v2.1.223 より前では、任意の管理者ソースの値が親のものをブロックしました。271 Claude Code v2.1.273 以降では、`allowManagedMcpServersOnly` がオンの間、1 つを設定する最も高いランクの管理者ソースからの `allowedMcpServers` リストが適用され、親のものをブロックします。これは[クロスソースキー](#keys-read-from-every-admin-source)です。親のリストは、管理者ソースがリストを設定しない場合にのみ適用されます。[`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior) エントリは `"merge"` の下で各キーを提供するソースを示します。v2.1.223 より前では、任意の管理者ソースの値が親のものをブロックしました。

272* `availableModels` の場合、Claude Code は適用する管理設定の値を強制し、親が提供するリストをブロックします。272* `availableModels` の場合、Claude Code は適用する管理設定の値を強制し、親が提供するリストをブロックします。

273* `strictKnownMarketplaces` の場合、Claude Code は同様に適用する管理設定のリストを強制し、親が提供するものをブロックします。親のリストは、適用された管理ソースがリストを設定しない場合にのみ適用されます。Claude Code v2.1.282 以降が必要です。273* `strictKnownMarketplaces` の場合、Claude Code は同様に適用する管理設定のリストを強制し、親が提供するものをブロックします。親のリストは、適用された管理ソースがリストを設定しない場合にのみ適用されます。Claude Code v2.1.282 以降が必要です。

274* `allowedProviders` の場合、[選択された管理ソース](#which-managed-source-claude-code-uses)のリストが親が提供するリストをブロックし、[`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior) の `"merge"` オプトインの下では、任意の管理者ソースのリストがブロックします。Claude Code v2.1.285 以降が必要です

274* 親が提供する `blockedMarketplaces` は、管理ソースが設定するブロックリストに加えて適用されます。Claude Code v2.1.282 以降が必要です。275* 親が提供する `blockedMarketplaces` は、管理ソースが設定するブロックリストに加えて適用されます。Claude Code v2.1.282 以降が必要です。

275 276

276<h4 id="keep-cowork-folder-access-when-only-managed-rules-apply">277<h4 id="keep-cowork-folder-access-when-only-managed-rules-apply">

301開発者の独自の設定ファイル、`--settings` 値、およびプロジェクトファイルは管理値をオーバーライドしません。[例外](/docs/ja/settings#exceptions-to-managed-settings-precedence)は、より厳しい下位レベルの値がカウントされることのみを許可します。これらのケースはそのルールの外にあります。302開発者の独自の設定ファイル、`--settings` 値、およびプロジェクトファイルは管理値をオーバーライドしません。[例外](/docs/ja/settings#exceptions-to-managed-settings-precedence)は、より厳しい下位レベルの値がカウントされることのみを許可します。これらのケースはそのルールの外にあります。

302 303

303* **セッションのモデル**: 管理された `model` はロックではなくデフォルトです。`--model` と `ANTHROPIC_MODEL` はそのセッションのモデルを選択できるため、[`availableModels`](/docs/ja/settings-reference#availablemodels) をデプロイして選択を制限します。304* **セッションのモデル**: 管理された `model` はロックではなくデフォルトです。`--model` と `ANTHROPIC_MODEL` はそのセッションのモデルを選択できるため、[`availableModels`](/docs/ja/settings-reference#availablemodels) をデプロイして選択を制限します。

305* **セッションの自動圧縮ウィンドウ**: 管理された [`autoCompactWindow`](/docs/ja/settings-reference#autocompactwindow) もデフォルトです。`--autocompact` フラグと `CLAUDE_CODE_AUTO_COMPACT_WINDOW` 変数は、引き続きそのセッションの[自動圧縮ウィンドウ](/docs/ja/model-config#set-the-auto-compact-window)を設定できます。

304* **ローカル管理者権限**: マシンの管理者である開発者は、管理ソース自体を編集できます。これが MDM ツールがスケジュールでプロファイルまたはファイルを再デプロイできる理由であり、HKLM レジストリと macOS 管理設定ドメインが存在する理由です。306* **ローカル管理者権限**: マシンの管理者である開発者は、管理ソース自体を編集できます。これが MDM ツールがスケジュールでプロファイルまたはファイルを再デプロイできる理由であり、HKLM レジストリと macOS 管理設定ドメインが存在する理由です。

305* **サーバー管理キャッシュ**: サーバー管理設定は Anthropic のサーバーから取得され、ローカルキャッシュへの編集は[次の成功したフェッチまでのみ続きます](/docs/ja/server-managed-settings#security-considerations)。307* **サーバー管理キャッシュ**: サーバー管理設定は Anthropic のサーバーから取得され、ローカルキャッシュへの編集は[次の成功したフェッチまでのみ続きます](/docs/ja/server-managed-settings#security-considerations)。

306* **その他のツール**: 管理設定は Claude Code のみをバインドします。別のツールから API を呼び出す開発者はそれらの下にはありません。308* **その他のツール**: 管理設定は Claude Code のみをバインドします。別のツールから API を呼び出す開発者はそれらの下にはありません。

398 400

399| フィールド | 存在するが無効な場合の動作 |401| フィールド | 存在するが無効な場合の動作 |

400| :- | :- |402| :- | :- |

401| `allowedMcpServers` | ユーザーが追加する MCP サーバーが許可されないように、値が修正されるまで空のアローリストとして適用されます。組織が [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) を通じて配信するサーバーは引き続きロードされ、`managed-mcp.json` サーバーは[サーバーの評価方法](/docs/ja/managed-mcp#how-a-server-is-evaluated)に従ってロードされます。個別の無効なエントリは削除され、有効なサブセットが適用されます。 |403| `allowedMcpServers` | ユーザーが追加する MCP サーバーが許可されないように、値が修正されるまで空の許可リストとして適用されます。組織が [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) を通じて配信するサーバーは引き続きロードされ、`managed-mcp.json` サーバーは[許可リストのチェックをスキップするサーバー](/docs/ja/managed-mcp#servers-that-skip-the-allowlist-check)に従ってロードされます。個別の無効なエントリは削除され、有効なサブセットが適用されます。 |

402| [`allowedProviders`](/docs/ja/settings-reference#allowedproviders) | 値が修正されるまで空の許可リストとして適用されるため、すべての API プロバイダーが拒否され、そのマシンで Claude Code は起動しません。個別のエントリが既知のプロバイダー名ではないだけの場合、Claude Code はそのエントリをドロップして報告し、残りを適用します。 |404| [`allowedProviders`](/docs/ja/settings-reference#allowedproviders) | 値が修正されるまで空の許可リストとして適用されるため、すべての API プロバイダーが拒否され、そのマシンで Claude Code は起動しません。個別のエントリが既知のプロバイダー名ではないだけの場合、Claude Code はそのエントリをドロップして報告し、残りを適用します。 |

403| `allowedHttpHookUrls` | Claude Code は値を修正するまで空の管理[アローリスト](/docs/ja/settings-reference#allowedhttphookurls)を適用するため、HTTP フックは別の設定ファイルがその URL をリストしている場合にのみ実行されます。無効なエントリが 1 つだけの場合、Claude Code はそのエントリを削除し、残りを適用します。 |405| `allowedHttpHookUrls` | Claude Code は値を修正するまで空の管理[アローリスト](/docs/ja/settings-reference#allowedhttphookurls)を適用するため、HTTP フックは別の設定ファイルがその URL をリストしている場合にのみ実行されます。無効なエントリが 1 つだけの場合、Claude Code はそのエントリを削除し、残りを適用します。 |

404| `httpHookAllowedEnvVars` | Claude Code は値を修正するまで空の管理[アローリスト](/docs/ja/settings-reference#httphookallowedenvvars)を適用するため、ヘッダー変数は別の設定ファイルがそれを名前で示している場合にのみ補間されます。無効なエントリが 1 つだけの場合、Claude Code はそのエントリを削除し、残りを適用します。 |406| `httpHookAllowedEnvVars` | Claude Code は値を修正するまで空の管理[アローリスト](/docs/ja/settings-reference#httphookallowedenvvars)を適用するため、ヘッダー変数は別の設定ファイルがそれを名前で示している場合にのみ補間されます。無効なエントリが 1 つだけの場合、Claude Code はそのエントリを削除し、残りを適用します。 |

model-config.md +2 −1

Details

285* **[自動モデルフォールバック](#automatic-model-fallback)**: フォールバック先が除外されている場合、フォールバックは実行されないため、警告されたリクエストは代わりに拒否で終了します285* **[自動モデルフォールバック](#automatic-model-fallback)**: フォールバック先が除外されている場合、フォールバックは実行されないため、警告されたリクエストは代わりに拒否で終了します

286* **[auto モードの分類器](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)**: 分類器のデフォルトである Claude Sonnet 5 は、許可リストが Sonnet 5 を許可している場合にのみ適用されます。除外されている場合、分類器はセッションのモデル（すでに許可リストの制御下にあります）で実行されるか、セッションが [Fable モデル](#work-with-fable)で実行されている場合は Opus モデルで実行されます。Anthropic API 以外のプロバイダーでは、その Opus フォールバックは許可リストを参照せずに、`ANTHROPIC_DEFAULT_OPUS_MODEL` で設定したモデル、または設定していない場合は Opus 5 で実行されます。Claude Code v2.1.210 以降が必要です286* **[auto モードの分類器](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)**: 分類器のデフォルトである Claude Sonnet 5 は、許可リストが Sonnet 5 を許可している場合にのみ適用されます。除外されている場合、分類器はセッションのモデル（すでに許可リストの制御下にあります）で実行されるか、セッションが [Fable モデル](#work-with-fable)で実行されている場合は Opus モデルで実行されます。Anthropic API 以外のプロバイダーでは、その Opus フォールバックは許可リストを参照せずに、`ANTHROPIC_DEFAULT_OPUS_MODEL` で設定したモデル、または設定していない場合は Opus 5 で実行されます。Claude Code v2.1.210 以降が必要です

287* **[fast mode](/docs/ja/fast-mode)**: 有効化後にセッションが実行されるモデルが許可リスト外である場合、fast mode の有効化は拒否されます287* **[fast mode](/docs/ja/fast-mode)**: 有効化後にセッションが実行されるモデルが許可リスト外である場合、fast mode の有効化は拒否されます

288* **Amazon Bedrock と Google Cloud の Agent Platform での可用性フォールバック**: セッションの途中でアカウントがモデルへのアクセスを失った場合、別のモデルへの切り替えでは除外されたモデルがスキップされます。[Amazon Bedrock](/docs/ja/amazon-bedrock#when-your-organization-enforces-a-model-allowlist) および [Google Cloud の Agent Platform](/docs/ja/google-vertex-ai#when-your-organization-enforces-a-model-allowlist) での起動時のモデルチェックが除外されたモデルをスキップするのは、管理設定で [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) も設定されている場合のみです

288 289

289```json theme={null}290```json theme={null}

290{291{

766| :- | :- |767| :- | :- |

769| 環境変数で無効にする | [`MAX_THINKING_TOKENS=0`](/docs/ja/env-vars) を設定します。これにより、Opus 5.5、Sonnet 5.5、Fable モデルを除き、Anthropic API で思考がオフになります。[サードパーティプロバイダー](/docs/ja/third-party-integrations)では、Claude Code は代わりに `thinking` パラメータを省略するため、アダプティブ推論モデルは引き続き思考する場合があります。その他の値は[固定の思考予算](#adaptive-reasoning-and-fixed-thinking-budgets)の場合にのみ適用されます |770| 環境変数で無効にする | [`MAX_THINKING_TOKENS=0`](/docs/ja/env-vars) を設定します。これにより、Opus 5.5、Sonnet 5.5、Fable モデルを除き、Anthropic API で思考がオフになります。[サードパーティプロバイダー](/docs/ja/third-party-integrations)では、Claude Code は代わりに `thinking` パラメータを省略するため、アダプティブ推論モデルは引き続き思考する場合があります |

770 771

771Opus 5.5、Sonnet 5.5、Fable モデルでは思考をオフにできません。これらのモデルでは、セッションのトグルと `/config` の行に切り替えの代わりに `Thinking can't be turned off` が表示され、保存済みの `alwaysThinkingEnabled: false` や `MAX_THINKING_TOKENS=0` は効果がありません。これらのモデルでは、effort レベルに基づいて、モデルがステップごとにどの程度思考するかを判断します。保存済みの設定は、それを受け付けるモデルに切り替えると再び適用されます。772Opus 5.5、Sonnet 5.5、Fable モデルでは思考をオフにできません。これらのモデルでは、セッションのトグルと `/config` の行に切り替えの代わりに `Thinking can't be turned off` が表示され、保存済みの `alwaysThinkingEnabled: false` や `MAX_THINKING_TOKENS=0` は効果がありません。これらのモデルでは、effort レベルに基づいて、モデルがステップごとにどの程度思考するかを判断します。保存済みの設定は、それを受け付けるモデルに切り替えると再び適用されます。

772 773

monitoring-usage.md +38 −7

Details

358 358

359<span id="new-context-gates" />359<span id="new-context-gates" />

360 360

361**詳細ベータトレースでのコンテンツ属性**

362

361<Note>363<Note>

362 `new_context`、`system_prompt_preview`、`user_system_prompt`、`tool_input`、`response.model_output` など、コンテンツを保持する追加の属性は、詳細ベータトレースが有効な場合にのみ出力されます。これらは安定したスパンスキーマには含まれません。364 `new_context`、`system_reminders`、`system_prompt_preview`、`user_system_prompt`、`tool_input`、`response.model_output` など、コンテンツを保持する追加の属性は、詳細ベータトレースが有効な場合にのみ出力されます。これらは安定したスパンスキーマには含まれません。

365</Note>

363 366

364 `new_context` のゲートは、それを保持するスパンによって異なり、各コピーはコンテンツ上限（デフォルトで 60 KB）で切り詰められます。`claude_code.tool` スパンでは、ツールにかかわらずそのツール呼び出しの結果を保持し、`OTEL_LOG_TOOL_CONTENT=1` が必要です。`claude_code.interaction` スパンではユーザープロンプトを、`claude_code.llm_request` スパンではそのリクエストの新しいユーザーメッセージとツール結果を保持します。これらはどちらも `OTEL_LOG_USER_PROMPTS=1` が必要です。367これらの属性は以下のスパンに付与され、`ゲート`は詳細ベータトレースに加えて属性に必要な変数を示します。コンテンツ上限（デフォルトで 60 KB）を超える値は切り詰められます。

365 368

366 `user_system_prompt` にはさらに `OTEL_LOG_USER_PROMPTS=1` が必要です。これは、`systemPrompt` SDK オプションまたは `--system-prompt` フラグと `--append-system-prompt` フラグで指定したシステムプロンプトのテキストのみを保持し、コンテンツ上限（デフォルトで 60 KB）で切り詰められ、リクエストごとではなくセッションごとに 1 回出力されます。369| 属性 | スパン | 説明 | ゲート |

367</Note>370| - | - | - | - |

375| `user_system_prompt` | `claude_code.llm_request` | `systemPrompt` SDK オプションまたは `--system-prompt` フラグと `--append-system-prompt` フラグで指定したシステムプロンプトのテキストのみ。リクエストごとではなくセッションごとに 1 回出力されます | `OTEL_LOG_USER_PROMPTS` |

379

380詳細ベータトレースで `OTEL_LOG_USER_PROMPTS=1` を設定している場合、Claude Code は完全なシステムプロンプトを保持する `claude_code.system_prompt` イベントも出力します。このシステムプロンプトはコンテンツ上限で切り詰められます。このイベントは、セッションが個々の異なるシステムプロンプトを初めて送信したときに届き、コンテキスト圧縮の後にも再度届きます。

368 381

369<h3 id="dynamic-headers">382<h3 id="dynamic-headers">

370 動的ヘッダー383 動的ヘッダー

797* `event.sequence`: イベントを順序付けるためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes)で説明しています810* `event.sequence`: イベントを順序付けるためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes)で説明しています

798* `prompt_length`: プロンプトの長さ811* `prompt_length`: プロンプトの長さ

799* `prompt`: プロンプトの内容。デフォルトでは秘匿化されます。含めるには `OTEL_LOG_USER_PROMPTS=1` を設定してください812* `prompt`: プロンプトの内容。デフォルトでは秘匿化されます。含めるには `OTEL_LOG_USER_PROMPTS=1` を設定してください

813* `prompt_text`: `prompt` と同じ値で、同じ条件で伏せ字化されます。ドット区切りの属性名をネストされたオブジェクトとして保存するバックエンドでは、`prompt.id` を `prompt` という名前のオブジェクト内の `id` として読み取るため、プロンプト文字列が失われる可能性があります。その場合は代わりに `prompt_text` を読み取ってください。Claude Code v2.1.287 以降が必要です

800* `message.uuid`: 結果として生成されたユーザーメッセージの UUID。保存されたトランスクリプトのエントリと一致します。0 個または複数のメッセージを生成する可能性があるコマンドのディスパッチには含まれません。Claude Code v2.1.214 以降が必要です814* `message.uuid`: 結果として生成されたユーザーメッセージの UUID。保存されたトランスクリプトのエントリと一致します。0 個または複数のメッセージを生成する可能性があるコマンドのディスパッチには含まれません。Claude Code v2.1.214 以降が必要です

801* `command_name`: プロンプトがコマンドを呼び出す場合のコマンド名。`compact` や `debug` などの組み込みおよびバンドルのコマンド名はそのまま出力されます。`reset` などのエイリアスは正規の名前ではなく入力されたとおりに出力されます。カスタム、プラグイン、MCP のコマンド名は、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `custom` または `mcp` にまとめられます815* `command_name`: プロンプトがコマンドを呼び出す場合のコマンド名。`compact` や `debug` などの組み込みおよびバンドルのコマンド名はそのまま出力されます。`reset` などのエイリアスは正規の名前ではなく入力されたとおりに出力されます。カスタム、プラグイン、MCP のコマンド名は、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `custom` または `mcp` にまとめられます

802* `command_source`: コマンドが存在する場合のコマンドの出どころ。`builtin`、`custom`、`mcp` のいずれかです。プラグインが提供するコマンドは `custom` として報告されます816* `command_source`: コマンドが存在する場合のコマンドの出どころ。`builtin`、`custom`、`mcp` のいずれかです。プラグインが提供するコマンドは `custom` として報告されます

1694* OpenTelemetry エクスポートをバックエンドに送信することはオプトインであり、明示的な設定が必要です。Anthropic の個別の運用テレメトリと無効化方法については、[データ使用](/docs/ja/data-usage#telemetry-services)を参照してください1708* OpenTelemetry エクスポートをバックエンドに送信することはオプトインであり、明示的な設定が必要です。Anthropic の個別の運用テレメトリと無効化方法については、[データ使用](/docs/ja/data-usage#telemetry-services)を参照してください

1695* 生のファイルコンテンツとコードスニペットはメトリクスやイベントに含まれません。トレーススパンは別のデータパスです。以下の `OTEL_LOG_TOOL_CONTENT` の項目を参照してください1709* 生のファイルコンテンツとコードスニペットはメトリクスやイベントに含まれません。トレーススパンは別のデータパスです。以下の `OTEL_LOG_TOOL_CONTENT` の項目を参照してください

1696* OAuth 経由で認証されている場合、`user.email` はテレメトリ属性に含まれ、設定した OTel エンドポイントにのみ送信され、Anthropic には送信されません。これが組織にとって懸念事項である場合は、テレメトリバックエンドと協力してこのフィールドをフィルタリングまたは編集してください1710* OAuth 経由で認証されている場合、`user.email` はテレメトリ属性に含まれ、設定した OTel エンドポイントにのみ送信され、Anthropic には送信されません。これが組織にとって懸念事項である場合は、テレメトリバックエンドと協力してこのフィールドをフィルタリングまたは編集してください

1697* ユーザープロンプトコンテンツはデフォルトでは収集されません。プロンプト長のみが記録されます。プロンプトコンテンツを含めるには、`OTEL_LOG_USER_PROMPTS=1` を設定してください。詳細なベータトレースでは、この変数はプロンプトテキストよりも広い範囲に達します。これは [`new_context` スパン属性](#new-context-gates)もゲートします。これは `claude_code.llm_request` スパンのツール結果を含みます1711* ユーザープロンプトコンテンツはデフォルトでは収集されません。プロンプト長のみが記録されます。プロンプトコンテンツを含めるには、`OTEL_LOG_USER_PROMPTS=1` を設定してください。有効にすると：

1698* アシスタント応答テキストはデフォルトでは収集されません。応答長のみが記録されます。応答テキストを含めるには、`OTEL_LOG_ASSISTANT_RESPONSES=1` を設定してください。Claude Code からのすべての OpenTelemetry データと同様に、応答テキストは設定した OTel エンドポイントにのみ送信され、Anthropic には送信されません。この変数が設定されていない場合、`OTEL_LOG_USER_PROMPTS` がフォールバックとして使用されるため、プロンプトコンテンツなしで応答コンテンツが必要な場合は `OTEL_LOG_ASSISTANT_RESPONSES=0` を設定してください1712 * `user_prompt` イベントは、プロンプトテキストを `prompt` と [`prompt_text`](#user-prompt-event) の 2 つの属性に含みます。コレクターでイベントのプロンプトテキストを属性名によって削除またはマスクする場合は、ルールで両方の属性を指定してください

1713

1714 この OpenTelemetry Collector の `attributes` プロセッサーは、これを指定しているパイプラインで両方の属性を削除します：

1715

1716 ```yaml theme={null}

1717 processors:

1718 attributes/drop-prompt-text:

1719 actions:

1720 - key: prompt

1721 action: delete

1722 - key: prompt_text

1723 action: delete

1724 ```

1725

1726 * [トレース](#traces-beta)がオンの場合、`claude_code.interaction` スパンは `user_prompt` 属性にプロンプトテキストを含みます

1727

1728 * 詳細なベータトレースでは、スパンには各リクエストとともに送信される新しいユーザーメッセージ、ツール結果、システムリマインダーに加えて、システムプロンプトテキストとモデル出力も含まれます。各属性は[詳細なベータトレースにおけるコンテンツ属性](#new-context-gates)に記載されています。`claude_code.system_prompt` イベントは完全なシステムプロンプトを含みます

1729* アシスタント応答テキストはデフォルトでは収集されません。応答長のみが記録されます。応答テキストを含めるには、`OTEL_LOG_ASSISTANT_RESPONSES=1` を設定してください。Claude Code からのすべての OpenTelemetry データと同様に、応答テキストは設定した OTel エンドポイントにのみ送信され、Anthropic には送信されません。この変数が設定されていない場合、`OTEL_LOG_USER_PROMPTS` がフォールバックとして使用されるため、イベントで応答コンテンツなしでプロンプトコンテンツが必要な場合は `OTEL_LOG_ASSISTANT_RESPONSES=0` を設定してください。詳細なベータトレースでは、`claude_code.llm_request` スパンは引き続き [`response.model_output`](#new-context-gates) にモデル出力を含みます。これはこの変数ではなく `OTEL_LOG_USER_PROMPTS` に従います

1699* ツール入力引数とパラメータはデフォルトではログに記録されません。これらを含めるには、`OTEL_LOG_TOOL_DETAILS=1` を設定してください。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、`tool_decision` と `tool_result` は `mcp_server_name`/`mcp_tool_name` ペアを含みます。これはホストが作成した名前であり、フラグがオフの場合でも引数コンテンツではありません。この例外には Claude Code v2.1.214 以降が必要です。このデータは設定した OTEL エンドポイントにのみ送信され、Anthropic には送信されません。引数には機密値が含まれる可能性があるため、テレメトリバックエンドを設定してこれらの属性をフィルタリングまたは編集してください。有効にすると：1730* ツール入力引数とパラメータはデフォルトではログに記録されません。これらを含めるには、`OTEL_LOG_TOOL_DETAILS=1` を設定してください。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、`tool_decision` と `tool_result` は `mcp_server_name`/`mcp_tool_name` ペアを含みます。これはホストが作成した名前であり、フラグがオフの場合でも引数コンテンツではありません。この例外には Claude Code v2.1.214 以降が必要です。このデータは設定した OTEL エンドポイントにのみ送信され、Anthropic には送信されません。引数には機密値が含まれる可能性があるため、テレメトリバックエンドを設定してこれらの属性をフィルタリングまたは編集してください。有効にすると：

1700 * `tool_result` と `tool_decision` イベントには、Bash コマンド、MCP サーバーとツール名、およびスキル名を含む `tool_parameters` 属性が含まれます。`full_command` などのフィールドは切り詰められずに出力されます1731 * `tool_result` と `tool_decision` イベントには、Bash コマンド、MCP サーバーとツール名、およびスキル名を含む `tool_parameters` 属性が含まれます。`full_command` などのフィールドは切り詰められずに出力されます

1701 * `tool_result` イベントには、ファイルパス、URL、検索パターン、およびその他の引数を含む `tool_input` 属性も含まれます。512 文字を超える個別の値は切り詰められ、合計は約 4 K 文字に制限されます1732 * `tool_result` イベントには、ファイルパス、URL、検索パターン、およびその他の引数を含む `tool_input` 属性も含まれます。512 文字を超える個別の値は切り詰められ、合計は約 4 K 文字に制限されます

1702 * `user_prompt` イベントには、カスタム、プラグイン、および MCP コマンドの逐語的な `command_name` が含まれます1733 * `user_prompt` イベントには、カスタム、プラグイン、および MCP コマンドの逐語的な `command_name` が含まれます

1703 * [コストとトークンカウンター](#cost-counter)および `api_request`、`api_error`、および `api_refusal` イベントは、その属性の帰属に実際のエージェント、スキル、プラグイン、および MCP サーバーとツール名を含みます1734 * [コストとトークンカウンター](#cost-counter)および `api_request`、`api_error`、および `api_refusal` イベントは、その属性の帰属に実際のエージェント、スキル、プラグイン、および MCP サーバーとツール名を含みます

1704 * トレーススパンには、同じ `tool_input` 属性と `file_path` などの入力派生属性が含まれ、`tool_input` と同じ切り詰めが行われます1735 * `claude_code.tool` スパンには、`file_path` などの入力派生属性が含まれます。詳細なベータトレースでは、[`tool_input`](#new-context-gates) 属性も含まれます

1705* ツールコンテンツはデフォルトではトレーススパンにログに記録されません。これを含めるには、`OTEL_LOG_TOOL_CONTENT=1` を設定してください。その後、`claude_code.tool` スパンは、生のファイルコンテンツ、Bash コマンド出力、および MCP ツール、WebFetch、WebSearch が返すものを含む [`tool.output` スパンイベント](#tool-output-span-event)を含みます。コンテンツは属性ごとにコンテンツ制限（デフォルトでは 60 KB）で切り詰められます。MCP ツール、WebFetch、WebSearch からの結果には Claude Code v2.1.283 以降が必要です。ツールコンテンツは [`new_context`](#new-context-gates) を通じてスパンに到達します。このゲートはスパンごとに異なります。テレメトリバックエンドを設定してこれらの属性をフィルタリングまたは編集してください1736* ツールコンテンツはデフォルトではトレーススパンにログに記録されません。これを含めるには、`OTEL_LOG_TOOL_CONTENT=1` を設定してください。その後、`claude_code.tool` スパンは、生のファイルコンテンツ、Bash コマンド出力、および MCP ツール、WebFetch、WebSearch が返すものを含む [`tool.output` スパンイベント](#tool-output-span-event)を含みます。コンテンツは属性ごとにコンテンツ制限（デフォルトでは 60 KB）で切り詰められます。MCP ツール、WebFetch、WebSearch からの結果には Claude Code v2.1.283 以降が必要です。ツールコンテンツは [`new_context`](#new-context-gates) を通じてスパンに到達します。このゲートはスパンごとに異なります。テレメトリバックエンドを設定してこれらの属性をフィルタリングまたは編集してください

1706* 生の Anthropic Messages API リクエストおよびレスポンスボディはデフォルトではログに記録されません。これらを含めるには、シェル、ユーザー設定、または管理設定で `OTEL_LOG_RAW_API_BODIES` を設定してください。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。ボディには、システムプロンプト、すべての以前のユーザーとアシスタントのターン、およびツール結果を含む完全な会話履歴が含まれるため、これを有効にすることは、他の `OTEL_LOG_*` コンテンツフラグが明かすすべてのことへの同意を意味します。Claude Code は、他の設定に関係なく、これらのボディから Claude の拡張思考コンテンツを常に編集します。設定する値は、Claude Code がボディを配信する方法を決定します：1737* 生の Anthropic Messages API リクエストおよびレスポンスボディはデフォルトではログに記録されません。これらを含めるには、シェル、ユーザー設定、または管理設定で `OTEL_LOG_RAW_API_BODIES` を設定してください。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。ボディには、システムプロンプト、すべての以前のユーザーとアシスタントのターン、およびツール結果を含む完全な会話履歴が含まれるため、これを有効にすることは、他の `OTEL_LOG_*` コンテンツフラグが明かすすべてのことへの同意を意味します。Claude Code は、他の設定に関係なく、これらのボディから Claude の拡張思考コンテンツを常に編集します。設定する値は、Claude Code がボディを配信する方法を決定します：

1707 * `=1` の場合、Claude Code は各 API 呼び出しに対して `api_request_body` と `api_response_body` ログイベントを出力します。イベントの `body` 属性は JSON シリアル化されたペイロードを含み、コンテンツ制限（デフォルトでは 60 KB）で切り詰められます1738 * `=1` の場合、Claude Code は各 API 呼び出しに対して `api_request_body` と `api_response_body` ログイベントを出力します。イベントの `body` 属性は JSON シリアル化されたペイロードを含み、コンテンツ制限（デフォルトでは 60 KB）で切り詰められます

permission-modes.md +7 −5

Details

86| Claude Code の実行方法 | 組み込み開始権限モード |86| Claude Code の実行方法 | 組み込み開始権限モード |

87| :- | :- |87| :- | :- |

88| 設定ファイルが `disableAutoMode` を `"disable"` に設定 | `default` |88| 設定ファイルが `disableAutoMode` を `"disable"` に設定 | `default` |

89| `claude -p` または [Agent SDK](/docs/ja/agent-sdk/permissions#permission-modes) | [フィーチャーフラグを取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)するセッションでは `default`。テレメトリがオフの場合やサードパーティプロバイダーなど、フィーチャーフラグを取得しないセッションでは、Claude Code v2.1.285 以降では `auto`、以前のバージョンでは `default`。auto デフォルトを保留するポリシーを持つ組織内のセッションは、代わりに `default` で開始します |89| `claude -p` または [Agent SDK](/docs/ja/agent-sdk/permissions#permission-modes) | [フィーチャーフラグを取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)するセッションでは `default`。テレメトリがオフの場合やサードパーティプロバイダーなど、フィーチャーフラグを取得しないセッションでは、Claude Code v2.1.285 以降では `auto`、以前のバージョンでは `default`。`auto` デフォルトを保留するポリシーを持つ組織内のセッションは、代わりに `default` で開始します |

90| ターミナルまたは [VS Code 拡張機能](/docs/ja/vs-code)を通じて | Claude Code v2.1.283 以降では `auto`。以前のバージョンでは、Pro、Max、または Team プランで [フィーチャーフラグを取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)するセッションでは `auto`、それ以外は `default` |90| ターミナルまたは [VS Code 拡張機能](/docs/ja/vs-code)を通じて | Claude Code v2.1.283 以降では `auto`。以前のバージョンでは、Pro、Max、または Team プランで [フィーチャーフラグを取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)するセッションでは `auto`、それ以外は `default` |

91 91

92[インストールまたはアップグレード後の最初のセッション](/docs/ja/env-vars#first-session-after-an-install-or-upgrade)では、Claude Code はフィーチャーフラグが到達する前に開始権限モードを選択できます。そのセッションは表が示すものとは異なる権限モードで開始する可能性があり、次のセッションは表に一致します。92[インストールまたはアップグレード後の最初のセッション](/docs/ja/env-vars#first-session-after-an-install-or-upgrade)では、Claude Code はフィーチャーフラグが到達する前に開始権限モードを選択できます。そのセッションは表が示すものとは異なる権限モードで開始する可能性があります。

93 93

94フラグ、設定ファイル、または組み込みデフォルトが `auto` を選択しても、auto モードがセッションで利用できない場合、Claude Code はセッションを Manual で開始します。Auto モードは、セッションが [利用可能性要件](#eliminate-prompts-with-auto-mode)を満たさない場合（設定ファイルがそれをオフにするか、サポートしていないモデルなど）、または Anthropic がサーバー側で一時的にそれをオフにした場合に利用できません。94フラグ、設定ファイル、または組み込みデフォルトが `auto` を選択しても、auto モードがセッションで利用できない場合、Claude Code はセッションを Manual で開始します。Auto モードは、セッションが [利用可能性要件](#eliminate-prompts-with-auto-mode)を満たさない場合（設定ファイルがそれをオフにするか、サポートしていないモデルなど）、または Anthropic がサーバー側で一時的にそれをオフにした場合に利用できません。

95 95

676* `.devcontainer`676* `.devcontainer`

677* `.yarn`677* `.yarn`

678* `.mvn`678* `.mvn`

679* `.claude`。ただし `.claude/worktrees` は除く。Claude はここに独自の git worktrees を保存します679* `.claude`。ただし、Claude が独自の git worktree を保存する `.claude/worktrees` と、`--restricted` なしで開始されたセッションにおける Claude 自身の[自動メモリ](/docs/ja/memory#storage-location)ディレクトリ内の markdown ファイルは除く

680* [`--plugin-dir`](/docs/ja/plugins/mods/create#change-a-mod-with-claude) で読み込んだディレクトリ。ファイルが変更されると、Claude Code がそこから mod のコードを再読み込みして実行するためです680* [`--plugin-dir`](/docs/ja/plugins/mods/create#change-a-mod-with-claude) で読み込んだディレクトリ。ファイルが変更されると、Claude Code がそこから mod のコードを再読み込みして実行するためです

681 681

682保護されたファイル：682保護されたファイル：

739Claude Code はこれらの構造内も確認します。739Claude Code はこれらの構造内も確認します。

740 740

741* **ネストされたコマンド**: `(...)` を使用したサブシェル、`{ ...; }` を使用したブレースグループ、`$(...)` またはバッククォートを使用したコマンド置換、または `<(...)` を使用したプロセス置換。Claude Code は、`(rm -rf ~)` や `echo "$(rm -rf ~)"` のように置換内にある重要なパスの削除、または同じコマンド内の他の場所にある削除を見つけます。741* **ネストされたコマンド**: `(...)` を使用したサブシェル、`{ ...; }` を使用したブレースグループ、`$(...)` またはバッククォートを使用したコマンド置換、または `<(...)` を使用したプロセス置換。Claude Code は、`(rm -rf ~)` や `echo "$(rm -rf ~)"` のように置換内にある重要なパスの削除、または同じコマンド内の他の場所にある削除を見つけます。

742* **インラインスクリプト**: Claude Code は `sh -c` または `bash -c` などのシェルに渡されるスクリプトをチェックして、シェル変数と位置パラメータの[ターゲット](#other-targets-that-count-as-critical-paths)を確認します。742* **インラインスクリプト**: `bash -c 'rm -rf ~'` のように、`-c` を付けて `sh`、`bash`、`zsh`、または同様の POSIX シェルに渡されるスクリプト。

743 * スクリプトがダブルクォートで囲まれている場合、呼び出し元のシェルはスクリプトの変数を展開してから、内部シェルがスクリプトを受け取ります。`find . -name '*.tmp' -exec sh -c "rm -rf \"$1\"/*" _ {} \;` では、コマンドはマッチごとに 1 回ファイルシステムルートからの削除に展開され、Claude Code はこれを重要なパスの削除として扱います。743 * スクリプトがダブルクォートで囲まれている場合、呼び出し元のシェルはスクリプトの変数を展開してから、内部シェルがスクリプトを受け取ります。`find . -name '*.tmp' -exec sh -c "rm -rf \"$1\"/*" _ {} \;` では、コマンドはマッチごとに 1 回ファイルシステムルートからの削除に展開され、Claude Code はこれを重要なパスの削除として扱います。

744 * `sh -c 'rm -rf "$1"/*' _ {}` のように `$1` を実際の値にバインドするシングルクォートスクリプトはフラグが付きません。744 * `sh -c 'rm -rf "$1"/*' _ {}` のように `$1` を実際の値にバインドするシングルクォートスクリプトは警告されません。

745

746`~` など、`-c` スクリプト内に直接書かれた重要なパスに対するチェックをオフにするには、Claude Code を起動する環境で [`CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT=1`](/docs/ja/env-vars#variables) を設定します。

745 747

746<h3 id="rewrite-a-flagged-command">748<h3 id="rewrite-a-flagged-command">

747 フラグが付いたコマンドを書き直す749 フラグが付いたコマンドを書き直す

plugins/cli-reference.md +6 −2

Details

336| `version` | 文字列 | マーケットプレイスインストールの場合、[Claude Code が計算した](/docs/ja/plugins/loading#versions-and-updates)インストール時のバージョン。セッションのみ、スキルディレクトリ、または同期プラグインの場合、マニフェストの `version`、または宣言されていない場合は `unknown` |336| `version` | 文字列 | マーケットプレイスインストールの場合、[Claude Code が計算した](/docs/ja/plugins/loading#versions-and-updates)インストール時のバージョン。セッションのみ、スキルディレクトリ、または同期プラグインの場合、マニフェストの `version`、または宣言されていない場合は `unknown` |

337| `scope` | 文字列 | インストールの場合は `user`、`project`、`local`、または `managed`。スキルディレクトリプラグインの場合は `user` または `project`。セッションのみのプラグインの場合は `session`。claude.ai から同期されたプラグインの場合は `synced` |337| `scope` | 文字列 | インストールの場合は `user`、`project`、`local`、または `managed`。スキルディレクトリプラグインの場合は `user` または `project`。セッションのみのプラグインの場合は `session`。claude.ai から同期されたプラグインの場合は `synced` |

339| `installPath` | 文字列 | プラグインがロードされるディレクトリ |339| `installPath` | 文字列 | プラグインがロードされるディレクトリ。ただし、セッションがマーケットプレイスのフォルダから[その場でロードする](/docs/ja/plugins/loading#in-place-and-copied-plugins)プラグインを除きます |

340| `readFromFolder` | 文字列 | セッションがマーケットプレイスのフォルダから[その場でロードする](/docs/ja/plugins/loading#in-place-and-copied-plugins)プラグインの場合、そのフォルダ内のプラグインのソースディレクトリ。Claude Code v2.1.289 以降が必要です |

341| `folderVersion` | 文字列 | `readFromFolder` がある場合、Claude Code がそのフォルダからロードした時点のプラグインの `version`。上記の `version` フィールドとは異なる場合があります。プラグインがロードされなかった場合、またはバージョンを宣言していない場合は存在しません。Claude Code v2.1.289 以降が必要です |

340| `installedAt` | 文字列 | インストールの ISO タイムスタンプ。マーケットプレイスインストールのみ |342| `installedAt` | 文字列 | インストールの ISO タイムスタンプ。マーケットプレイスインストールのみ |

341| `lastUpdated` | 文字列 | 最後の更新の ISO タイムスタンプ。マーケットプレイスインストールのみ |343| `lastUpdated` | 文字列 | 最後の更新の ISO タイムスタンプ。マーケットプレイスインストールのみ |

342| `projectPath` | 文字列 | インストールが属するプロジェクト。`project` および `local` スコープのみ |344| `projectPath` | 文字列 | インストールが属するプロジェクト。`project` および `local` スコープのみ |

637 * `.claude` という名前のディレクトリ：その中の `skills`、`agents`、および `commands` ディレクトリ639 * `.claude` という名前のディレクトリ：その中の `skills`、`agents`、および `commands` ディレクトリ

638 * その他のディレクトリ：その `.claude` の下のこれら 3 つのディレクトリ640 * その他のディレクトリ：その `.claude` の下のこれら 3 つのディレクトリ

639 641

642ディレクトリに `.claude-plugin/marketplace.json` と `.claude-plugin/plugin.json` の両方がある場合、Claude Code はマーケットプレイスに加えて、プラグインのマニフェストとコンポーネントファイルも検証します。これには Claude Code v2.1.289 以降が必要です。

643

640Claude Code は指定したディレクトリ内のシンボリックリンクをたどりません。動作はリンクがどこにあるかによって異なります：644Claude Code は指定したディレクトリ内のシンボリックリンクをたどりません。動作はリンクがどこにあるかによって異なります：

641 645

642* **プラグインまたは `.claude` ルートの下にリンクされた `skills`、`agents`、または `commands` ディレクトリ**: Claude Code はその中の何も読み込まれなかったことを警告します。646* **プラグインまたは `.claude` ルートの下にリンクされた `skills`、`agents`、または `commands` ディレクトリ**: Claude Code はその中の何も読み込まれなかったことを警告します。

647 651

648* **プラグインルートの `SKILL.md`**: プラグインディレクトリに対して `claude plugin validate` を実行する場合、Claude Code はプラグインルートの `SKILL.md` をチェックしません652* **プラグインルートの `SKILL.md`**: プラグインディレクトリに対して `claude plugin validate` を実行する場合、Claude Code はプラグインルートの `SKILL.md` をチェックしません

649* **プラグインルートの `CLAUDE.md`**: プラグイン実行では、Claude Code はプラグインルートの `CLAUDE.md` についても警告します653* **プラグインルートの `CLAUDE.md`**: プラグイン実行では、Claude Code はプラグインルートの `CLAUDE.md` についても警告します

650* **マーケットプレイス実行のプラグインファイル**: マーケットプレイスディレクトリから、Claude Code はプラグインのスキル、エージェント、コマンド、またはフックファイルや、それらがバンドルする MCP サーバーファイルを開きません。これらのファイルのエラーを見つけるには、各プラグインディレクトリを検証してください654* **マーケットプレイス実行のプラグインファイル**: マーケットプレイスディレクトリから、Claude Code はマーケットプレイスが他のディレクトリにリストしているプラグインのスキル、エージェント、コマンド、またはフックファイルや、それらがバンドルする MCP サーバーファイルを開きません。これらのファイルのエラーを見つけるには、各プラグインディレクトリを検証してください

651 655

652<h4 id="output-and-exit-codes">656<h4 id="output-and-exit-codes">

653 出力と終了コード657 出力と終了コード

plugins/create.md +1 −1

Details

100 Greet the user warmly and ask how you can help them today.100 Greet the user warmly and ask how you can help them today.

101 ```101 ```

102 102

103 `disable-model-invocation: true` の行は、Claude がスキルを独自に実行しないことを意味するため、トリガーするのはあなただけです。Claude が独自に実行したいスキルからその行を削除してください。スキルのコマンドはプラグイン名とスキルの名前を組み合わせるため、これを `/my-first-plugin:hello` として実行します。他のフロントマターフィールドについては、[スキルフロントマターリファレンス](/docs/ja/skills#frontmatter-reference)を参照してください。103 `disable-model-invocation: true` の行は、Claude がスキルを独自に実行しないことを意味します。Claude が独自に実行したいスキルからはその行を削除してください。スキルのコマンドはプラグイン名とスキルの名前を組み合わせるため、これを `/my-first-plugin:hello` として実行します。他のフロントマターフィールドについては、[スキルフロントマターリファレンス](/docs/ja/skills#frontmatter-reference)を参照してください。

104 </Step>104 </Step>

105 105

106 <Step title="プラグインを検証する">106 <Step title="プラグインを検証する">

plugins/host-marketplace.md +1 −1

Details

215 215

216ユーザーに新しいバージョンをリリースするには、プラグインの `version` を変更してください。ユーザーは、プラグインの計算されたバージョンが持っているものと異なる場合にのみ新しいコピーを取得します。そのバージョンは `plugin.json` から最初に来て、次にマーケットプレイスエントリから来ます。[バージョンと更新](/docs/ja/plugins/loading#versions-and-updates)を参照してください。216ユーザーに新しいバージョンをリリースするには、プラグインの `version` を変更してください。ユーザーは、プラグインの計算されたバージョンが持っているものと異なる場合にのみ新しいコピーを取得します。そのバージョンは `plugin.json` から最初に来て、次にマーケットプレイスエントリから来ます。[バージョンと更新](/docs/ja/plugins/loading#versions-and-updates)を参照してください。

217 217

218ユーザーが追加したマーケットプレイスからローカルディレクトリとして[その場で読み込む](/docs/ja/plugins/loading#find-plugins-on-disk)プラグインは `version` で制御されません。セッション開始時に現在のファイルを読み込みます。バージョン文字列が何を言おうとも。218ユーザーがローカルパスから追加したマーケットプレイスから[その場で読み込む](/docs/ja/plugins/loading#find-plugins-on-disk)プラグインは `version` で制御されません。セッション開始時に現在のファイルを読み込みます。バージョン文字列が何を言おうとも。

219 219

220その場での読み込みまたは `command` ソースからのインストール以外のすべてのインストールについて、各リリースで `version` を増やすか、省略してください：220その場での読み込みまたは `command` ソースからのインストール以外のすべてのインストールについて、各リリースで `version` を増やすか、省略してください：

221 221

plugins/loading.md +3 −3

Details

208Claude Code は、オリジンに従って、いくつかのプラグインをそれらを保持する場所からインプレイスで読み込み、残りをキャッシュにコピーします：208Claude Code は、オリジンに従って、いくつかのプラグインをそれらを保持する場所からインプレイスで読み込み、残りをキャッシュにコピーします：

209 209

210* **`--plugin-dir` とスキルディレクトリプラグイン**: ディレクトリはインプレイスで読み込まれ、決してコピーされません。`--plugin-url` アーカイブまたは `--plugin-dir` `.zip` は最初にセッション一時ディレクトリに抽出されます210* **`--plugin-dir` とスキルディレクトリプラグイン**: ディレクトリはインプレイスで読み込まれ、決してコピーされません。`--plugin-url` アーカイブまたは `--plugin-dir` `.zip` は最初にセッション一時ディレクトリに抽出されます

211* **ローカルディレクトリから追加したマーケットプレイスの相対パスプラグイン**: プラグインはマーケットプレイスフォルダ内のパスからインプレイスで読み込まれます。ソースディレクトリへの編集は次のセッション開始または `/reload-plugins` で有効になり、バージョンを増やす必要はありません。プラグインの hook プロセスと MCP および LSP サーバーは、ソースディレクトリを指す `CLAUDE_PLUGIN_ROOT` を受け取ります。Node.js パッケージ依存関係については、[依存関係インストールが実行される場合](#when-the-dependency-install-runs)を参照してください211* **ローカルパスから追加したマーケットプレイスの相対パスプラグイン**: プラグインはマーケットプレイスフォルダ内のパスからインプレイスで読み込まれます。ソースディレクトリへの編集は次のセッション開始または `/reload-plugins` で有効になり、バージョンを増やす必要はありません。プラグインのフックプロセスと MCP および LSP サーバーは、ソースディレクトリを指す `CLAUDE_PLUGIN_ROOT` を受け取ります。Node.js パッケージ依存関係については、[依存関係インストールが実行される場合](#when-the-dependency-install-runs)を参照してください

212* **[リンクモード](/docs/ja/plugins/marketplace-reference#command-plugin-source)の `command` ソースプラグイン**: コマンドが出力したディレクトリはキャッシュエントリ内のリンクを通じてインプレイスで読み込まれます212* **[リンクモード](/docs/ja/plugins/marketplace-reference#command-plugin-source)の `command` ソースプラグイン**: コマンドが出力したディレクトリはキャッシュエントリ内のリンクを通じてインプレイスで読み込まれます

213* **他のすべてのマーケットプレイスプラグイン**: Claude Code はプラグインを `cache/<marketplace>/<plugin>/<version>/` にコピーし、そのコピーから読み込みます。プラグインディレクトリ外のファイルはコピーされないため、コピーされたプラグイン内のスクリプトが `../shared` などのプラグインルート上のパスを読む場合、それらは見つかりません213* **他のすべてのマーケットプレイスプラグイン**: Claude Code はプラグインを `cache/<marketplace>/<plugin>/<version>/` にコピーし、そのコピーから読み込みます。プラグインディレクトリ外のファイルはコピーされないため、コピーされたプラグイン内のスクリプトが `../shared` などのプラグインルート上のパスを読む場合、それらは見つかりません

214 214

250* Claude Code がプラグインを新しいバージョンに更新するとき250* Claude Code がプラグインを新しいバージョンに更新するとき

251* セッション開始時に有効なプラグインがキャッシュされていない場合。例えば、新しいマシン上251* セッション開始時に有効なプラグインがキャッシュされていない場合。例えば、新しいマシン上

252 252

253ローカルディレクトリマーケットプレイスから[インプレイスで読み込まれた](#in-place-and-copied-plugins)相対パスプラグインの場合、Claude Code はソースディレクトリに依存関係をインストールしません。そこに自分でインストールするか、hook から [`${CLAUDE_PLUGIN_DATA}`](/docs/ja/plugins/components#path-variables-and-persistent-data) にインストールしてください。253ローカルパスから追加したマーケットプレイスから[インプレイスで読み込まれた](#in-place-and-copied-plugins)相対パスプラグインの場合、Claude Code はソースディレクトリに依存関係をインストールしません。そこに自分でインストールするか、フックから [`${CLAUDE_PLUGIN_DATA}`](/docs/ja/plugins/components#path-variables-and-persistent-data) にインストールしてください。

254 254

255インストールは、プラグインのルートディレクトリに `package.json` とサポートされているロックファイルの両方が含まれている場合にのみ実行されます。255インストールは、プラグインのルートディレクトリに `package.json` とサポートされているロックファイルの両方が含まれている場合にのみ実行されます。

256 256

315 315

316`"version"` をピンするマニフェストは、計算されたバージョンがコミット全体で同じままである 1 つの方法です。[Claude Code がバージョンを計算する方法](#how-claude-code-computes-the-version)を参照してください。316`"version"` をピンするマニフェストは、計算されたバージョンがコミット全体で同じままである 1 つの方法です。[Claude Code がバージョンを計算する方法](#how-claude-code-computes-the-version)を参照してください。

317 317

318ローカルディレクトリマーケットプレイスから[インプレイスで読み込まれた](#in-place-and-copied-plugins)プラグインは、バージョン文字列が何を言おうとも、すべてのセッション開始で現在のソースファイルを読み込みます。[claude.ai でホストされているマーケットプレイス](/docs/ja/plugins/install#add-from-claude-ai)のプラグインの場合、claude.ai がプラグインのために記録するバージョンはそのバージョンであり、マニフェストの `version` は読み込まれません。318ローカルパスから追加したマーケットプレイスから[インプレイスで読み込まれた](#in-place-and-copied-plugins)プラグインは、バージョン文字列が何を言おうとも、すべてのセッション開始で現在のソースファイルを読み込みます。[claude.ai でホストされているマーケットプレイス](/docs/ja/plugins/install#add-from-claude-ai)のプラグインの場合、claude.ai がプラグインのために記録するバージョンはそのバージョンであり、マニフェストの `version` は読み込まれません。

319 319

320<h3 id="how-claude-code-computes-the-version">320<h3 id="how-claude-code-computes-the-version">

321 Claude Code がバージョンを計算する方法321 Claude Code がバージョンを計算する方法

plugins/manifest-reference.md +1 −1

Details

199 `version`199 `version`

200</h3>200</h3>

201 201

202semver に対してチェックされないバージョン文字列。設定すると、変更するまでプラグインはそのバージョンに固定されます。[バージョンと更新](/docs/ja/plugins/loading#versions-and-updates)を参照してください。[`command` ソース](/docs/ja/plugins/marketplace-reference)を持つプラグイン、[claude.ai でホストされているマーケットプレイス](/docs/ja/plugins/install#add-from-claude-ai)からのプラグイン、およびローカルディレクトリとして追加されたマーケットプレイスから[その場で読み込まれた](/docs/ja/plugins/loading#find-plugins-on-disk)プラグインはこのフィールドで固定されません。202semver に対してチェックされないバージョン文字列。設定すると、変更するまでプラグインはそのバージョンに固定されます。[バージョンと更新](/docs/ja/plugins/loading#versions-and-updates)を参照してください。[`command` ソース](/docs/ja/plugins/marketplace-reference)を持つプラグイン、[claude.ai でホストされているマーケットプレイス](/docs/ja/plugins/install#add-from-claude-ai)からのプラグイン、およびローカルパスから追加されたマーケットプレイスから[その場で読み込まれた](/docs/ja/plugins/loading#find-plugins-on-disk)プラグインはこのフィールドで固定されません。

203 203

204<h3 id="metadata">204<h3 id="metadata">

205 `metadata`205 `metadata`

plugins/mods/interface.md +2 −2

Details

434| `Link`、`Code`、`Markdown` | `href` と任意の `label` を持つリンク、コードブロック、Claude の返答と同じ形式で整形されたテキスト。`Markdown` はコンテンツを `children` ではなく `text` props で受け取り、`onLinkPress` を渡す場合は `key` が必要です。 | すべて |434| `Link`、`Code`、`Markdown` | `href` と任意の `label` を持つリンク、コードブロック、Claude の返答と同じ形式で整形されたテキスト。`Markdown` はコンテンツを `children` ではなく `text` props で受け取り、`onLinkPress` を渡す場合は `key` が必要です。 | すべて |

436| `Svg` | SVG ドキュメント | Desktop |436| `Svg` | SVG ドキュメント | Desktop |

437| `Client` | アニメーションやポインター入力のために、ユーザーが用意した 2 つ目のファイルが描画する領域。そのファイルは mod API を利用できません。フックに届く手段はデータを送信することだけで、そのデータは `ui.message` イベントとして届きます。 | ターミナル、Desktop |437| `Client` | アニメーションやポインター入力のために、ユーザーが用意した 2 つ目のファイルが描画する領域。そのファイルは mod API を利用できません。フックに届く手段はデータを送信することだけで、そのデータは `ui.message` イベントとして届きます。読み込み、描画、実行のいずれかに失敗すると、フックは [`ui.fault`](/docs/ja/plugins/mods/reference#interface) イベントを受け取ります。 | ターミナル、Desktop |

439 439

440モジュールが `.tsx` または `.jsx` ファイルの場合は、ツリーを JSX で記述できます。その場合は、先に `$.ui.resolve(e)` から要素を分割代入してください。440モジュールが `.tsx` または `.jsx` ファイルの場合は、ツリーを JSX で記述できます。その場合は、先に `$.ui.resolve(e)` から要素を分割代入してください。

664 Claude Code が要求なしで再描画するとき664 Claude Code が要求なしで再描画するとき

665</h3>665</h3>

666 666

667Claude Code はサイトの props が変更されるか、ターミナルの幅が変更されるときに `ui.render` フックを再度実行します。タイマーでフックを実行しません。モジュール内の変数が変更されたときは判断できません。667Claude Code はサイトの props が変更されるか、ターミナルの幅が変更されるときに `ui.render` フックを再度実行します。サイト内の `Client` が失敗し、mod が [`ui.fault`](/docs/ja/plugins/mods/reference#interface) を処理する場合、Claude Code は `ui.fault` フックが返った後にフックをもう一度実行するため、`ui.render` フックはその `Client` を除外できます。タイマーでフックを実行しません。モジュール内の変数が変更されたときは判断できません。

668 668

669<h3 id="redraw-when-your-data-changes">669<h3 id="redraw-when-your-data-changes">

670 データが変更されたときに再描画する670 データが変更されたときに再描画する

plugins/mods/reference.md +7 −6

Details

6 6

7> Claude Code の mod の完全なリファレンス：フックモジュールの構成、イベント、mods API メソッド、描画箇所、サーフェス別の要素、制限、設定。7> Claude Code の mod の完全なリファレンス：フックモジュールの構成、イベント、mods API メソッド、描画箇所、サーフェス別の要素、制限、設定。

8 8

9v2.1.287 時点の Claude Code CLI と Desktop アプリについて、[mod](/docs/ja/plugins/mods/overview) が処理できるイベント、呼び出せる mods API メソッド、描画できる描画箇所を調べられます。各項目には名前と 1 行の説明があり、解説しているガイドのセクションがある場合はそこへのリンクも記載しています。9v2.1.289 時点の Claude Code CLI と Desktop アプリについて、[mod](/docs/ja/plugins/mods/overview) が処理できるイベント、呼び出せる mods API メソッド、描画できる描画箇所を調べられます。各項目には名前と 1 行の説明があり、解説しているガイドのセクションがある場合はそこへのリンクも記載しています。

10 10

11<Note>11<Note>

12 完全なリファレンスは Claude Code の [mod 用 TypeScript 宣言](https://github.com/anthropics/claude-code/blob/main/mods/types/claude-code.d.ts)で、すべてのイベント、メソッド、要素が例とともに記述されています。GitHub 上のコピーは、インストールしている Claude Code のバージョンより古い場合があります。両者が食い違う場合は、[Claude Code がお使いのバージョン用に書き出すコピー](/docs/ja/plugins/mods/create#get-the-types-for-your-build)を信頼してください。12 完全なリファレンスは Claude Code の [mod 用 TypeScript 宣言](https://github.com/anthropics/claude-code/blob/main/mods/types/claude-code.d.ts)で、すべてのイベント、メソッド、要素が例とともに記述されています。GitHub 上のコピーは、インストールしている Claude Code のバージョンより古い場合があります。両者が食い違う場合は、[Claude Code がお使いのバージョン用に書き出すコピー](/docs/ja/plugins/mods/create#get-the-types-for-your-build)を信頼してください。

128 サブエージェント128 サブエージェント

129</h3>129</h3>

130 130

131サブエージェントイベントは、サブエージェントの種類が Claude に提示されるときと、サブエージェントが起動する直前に発火します。131サブエージェントイベントは、サブエージェントの種類が Claude に提示されるときと、サブエージェントまたはエージェントチームのチームメイトが起動する直前に発火します。

132 132

134| :- | :- | :- |134| :- | :- | :- |

135| `agent.offer` | サブエージェントの種類が Claude に提示されるとき | 提示しないようにするには `{ isOffered: false }` |135| `agent.offer` | サブエージェントの種類が Claude に提示されるとき | 提示しないようにするには `{ isOffered: false }` |

136| `agent.spawn` | サブエージェントが起動する直前 | `{ model }` または `{ deny: reason }` |136| `agent.spawn` | サブエージェントまたは[エージェントチーム](/docs/ja/agent-teams)のチームメイトが起動する直前。チームメイトの場合、`e.isTeammate` は `true` です。 | モデルを選択するには `next({ ...e, model })`、または `{ deny: reason }` |

137 137

138<h3 id="interface">138<h3 id="interface">

139 インターフェース139 インターフェース

152| [`ui.fault`](/docs/ja/plugins/mods/interface#redraw-when-something-changes) | mod が描画した `Client` 要素の読み込み、描画、または実行が失敗したとき。`e.phase` は `load`、`render`、`run` のいずれかで、`e.reason` はエラーメッセージです。Claude Code v2.1.289 以降が必要です。 |

152 153

153<h3 id="other-mods">154<h3 id="other-mods">

154 他の mod155 他の mod

192| 名前空間 | メソッド |193| 名前空間 | メソッド |

193| :- | :- |194| :- | :- |

195| [`$.ui`](/docs/ja/plugins/mods/interface#pick-where-to-draw) | `resolve`、`invalidate`、`open`、`close`、`panes`、`focus`、`scroll`、`toast`、`status`、`log`、`notice`、`ask`、`copy`、`blit` |196| [`$.ui`](/docs/ja/plugins/mods/interface#pick-where-to-draw) | `resolve`、`invalidate`、`open`、`close`、`panes`、`focus`、`scroll`、`toast`、`status`、`log`、`notice`、`ask`、`copy`、`selection`、`blit` |

276 277

277| 制限 | 値 |278| 制限 | 値 |

278| :- | :- |279| :- | :- |

279| 1 つのイベントに対するフック自体の実行時間（`next` 内や、`$.clock.sleep` 以外の mods API 呼び出し内の時間は含まない） | 10 秒 |280| 1 つのイベントに対するフック自体の実行時間（`next` 内や、`$.clock.sleep` 以外の mods API 呼び出し内の時間は含まない） | 10 秒。`prompt.edit` フックの場合は 50 ミリ秒 |

280| `.catch` ハンドラーの実行時間 | 1 秒 |281| `.catch` ハンドラーの実行時間 | 1 秒 |

281| すべての `session.end` フックの合計 | 1.5 秒 |282| すべての `session.end` フックの合計 | [SessionEnd フックの予算](/docs/ja/hooks#sessionend-input)と同じ長さ。変更しない限り 1.5 秒で、設定の `SessionEnd` フックが終了した時点から計測 |

plugins/troubleshooting.md +1 −1

Details

1016 1016

1017これらの原因を順番にチェックしてください。1017これらの原因を順番にチェックしてください。

1018 1018

1019* **スキルが `disable-model-invocation: true` を設定している**: そのフィールドが設定されている場合、スキルを呼び出すことができるのはユーザー自身だけです。[最初のプラグインを作成](/docs/ja/plugins/create#create-your-first-plugin) のテンプレートスキルがそれを設定しています。Claude が独自にスキルを呼び出すようにしたい場合は、スキルからその行を削除してください。[スキルを呼び出すユーザーを制御](/docs/ja/skills#control-who-invokes-a-skill) がそのフィールドをカバーしています1019* **スキルが `disable-model-invocation: true` を設定している**: [最初のプラグインを作成](/docs/ja/plugins/create#create-your-first-plugin) のテンプレートスキルがそれを設定しています。Claude が独自にスキルを呼び出すようにしたい場合は、スキルからその行を削除してください。[スキルを呼び出すユーザーを制御](/docs/ja/skills#control-who-invokes-a-skill) がそのフィールドをカバーしています

1020* **説明が人々の質問方法と一致していない**: [スキルがトリガーされていない](/docs/ja/skills#skill-not-triggering) のチェックを実行してください1020* **説明が人々の質問方法と一致していない**: [スキルがトリガーされていない](/docs/ja/skills#skill-not-triggering) のチェックを実行してください

1021* **説明が切り詰められている**: 多くのスキルがインストールされている場合、Claude Code は説明を短縮してリストの文字予算に合わせます。これにより、Claude がリクエストを一致させるために必要なキーワードが削除される可能性があります。[スキルの説明が短く切り詰められている](/docs/ja/skills#skill-descriptions-are-cut-short) を参照してください1021* **説明が切り詰められている**: 多くのスキルがインストールされている場合、Claude Code は説明を短縮してリストの文字予算に合わせます。これにより、Claude がリクエストを一致させるために必要なキーワードが削除される可能性があります。[スキルの説明が短く切り詰められている](/docs/ja/skills#skill-descriptions-are-cut-short) を参照してください

1022 1022

sandboxing.md +1 −1

Details

463 463

464マスキングには以下が必要です。464マスキングには以下が必要です。

465 465

466* **TLS 終端**: プロキシはリクエストの内容の中で実際の値を置換するため、その内容を参照できる必要があります。プロキシ自体が TLS を終端するように、[`network.tlsTerminate`](/docs/ja/settings-reference#sandbox-network-tlsterminate) を設定してください。これを設定しない場合、マスキングは何も漏らさずに失敗します。コマンドにはセンチネルしか見えませんが、センチネルはそのままサーバーに届き、認証が失敗します。Claude Code は起動時にこの設定ミスを報告します。466* **TLS 終端**: プロキシはリクエストの内容の中で実際の値を置換するため、その内容を参照できる必要があります。プロキシ自体が TLS を終端するように、[`network.tlsTerminate`](/docs/ja/settings-reference#sandbox-network-tlsterminate) を設定してください。これを設定しない場合、マスキングは何も漏らさずに失敗します。コマンドにはセンチネルしか見えませんが、センチネルはそのままサーバーに届き、認証が失敗します。この設定ミスを確認するには、ターミナルで `claude doctor` を実行し、`TLS termination is unavailable` という警告がないか確認してください。

467* **許可された送信先**: 各 `mask` エントリには `injectHosts`（実際の値の送信先として許可されるホスト）を記載できます。プロキシは[ドメイン許可リスト](#network-isolation)が許可する接続でのみ注入を行うため、各 `injectHosts` のホストは `network.allowedDomains` を通じても到達可能である必要があります。`injectHosts` のない `mask` エントリの場合、プロキシは `network.allowedDomains` 内のすべてのホストへのリクエストで実際の値に置換します。467* **許可された送信先**: 各 `mask` エントリには `injectHosts`（実際の値の送信先として許可されるホスト）を記載できます。プロキシは[ドメイン許可リスト](#network-isolation)が許可する接続でのみ注入を行うため、各 `injectHosts` のホストは `network.allowedDomains` を通じても到達可能である必要があります。`injectHosts` のない `mask` エントリの場合、プロキシは `network.allowedDomains` 内のすべてのホストへのリクエストで実際の値に置換します。

468* **信頼できる設定スコープ**: マスキングはプロキシが実際の認証情報をどこかに送信することを認可するため、Claude Code は `mask` エントリ、`network.tlsTerminate`、[`credentials.allowPlaintextInject`](/docs/ja/settings-reference#sandbox-credentials-allowplaintextinject)、`awsPairs`、`sigv4` を、ユーザー設定、管理設定、および `--settings` フラグからのみ尊重します。リポジトリの `.claude/settings.json` や `.claude/settings.local.json` 内のこれらは無視されます。管理者がサーバー管理設定を通じて `mask` エントリ、`network.tlsTerminate`、または `credentials.allowPlaintextInject` を配布する場合、それらは[承認が必要な設定](/docs/ja/server-managed-settings#security-approval-dialogs)として扱われます。468* **信頼できる設定スコープ**: マスキングはプロキシが実際の認証情報をどこかに送信することを認可するため、Claude Code は `mask` エントリ、`network.tlsTerminate`、[`credentials.allowPlaintextInject`](/docs/ja/settings-reference#sandbox-credentials-allowplaintextinject)、`awsPairs`、`sigv4` を、ユーザー設定、管理設定、および `--settings` フラグからのみ尊重します。リポジトリの `.claude/settings.json` や `.claude/settings.local.json` 内のこれらは無視されます。管理者がサーバー管理設定を通じて `mask` エントリ、`network.tlsTerminate`、または `credentials.allowPlaintextInject` を配布する場合、それらは[承認が必要な設定](/docs/ja/server-managed-settings#security-approval-dialogs)として扱われます。

469 469

self-hosted-environments-deploy.md +19 −0

Details

195 195

196ランナーは登録時に Anthropic にオプトインを報告し、起動時に `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` を出力します。オプトインの報告には Claude Code v2.1.267 以降が必要です。それより前のバージョンはフラグを受け入れますが、報告しないか、その行を出力しません。その後、オプトインランナー上の各セッションは、Anthropic 管理の git またはセッションごとのプロキシ URL のいずれかを使用します。セッションがセッションごとのプロキシ URL を使用する場合、ランナーは 1 つの `[runner:warn]` 行をログに記録します。196ランナーは登録時に Anthropic にオプトインを報告し、起動時に `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` を出力します。オプトインの報告には Claude Code v2.1.267 以降が必要です。それより前のバージョンはフラグを受け入れますが、報告しないか、その行を出力しません。その後、オプトインランナー上の各セッションは、Anthropic 管理の git またはセッションごとのプロキシ URL のいずれかを使用します。セッションがセッションごとのプロキシ URL を使用する場合、ランナーは 1 つの `[runner:warn]` 行をログに記録します。

197 197

198<h4 id="github-api-access-without-the-github-cli">

199 GitHub CLI なしで GitHub API にアクセスする

200</h4>

201

202ランナーイメージに GitHub CLI が含まれていない場合、Claude Code は組み込みの `gh` を提供できるため、Claude は引き続きプルリクエストの作成、コメント、CI 結果の読み取りを行えます。組み込みの `gh` は、Anthropic 管理の git を使用するランナー向けです。サポートするコマンドは GitHub の REST API を呼び出す `gh api` の 1 つのみです。ランナーイメージに Claude Code v2.1.287 以降が必要です。

203

204次のコマンドは、`gh pr create` の代わりにプルリクエストを作成します。組み込みの `gh` は、現在のリポジトリの `{owner}` と `{repo}` を自動で埋めます：

205

206```bash theme={null}

207gh api repos/{owner}/{repo}/pulls -f title='Fix' -f head='my-branch' -f base='main'

208```

209

210* **認証情報**：組み込みの `gh` は REST リクエストを Anthropic 管理の git 経由で送信し、GitHub の認証情報は Anthropic 側で提供されるため、イメージにそのための GitHub トークンは不要です

211* **利用できるセッション**：Anthropic 管理の git がセッションの `gh` を提供するかどうかは、Anthropic がセッションごとに決定します。提供する場合、ランナーがそのセッションについてログに記録する `[runner:session] governed git ACTIVE` 行に `gh_path_shim=true` が表示されます。提供しない場合、そのセッションには `gh` がありません

212* **`jq`**：`--jq` を使用したい場合は、イメージに `jq` をインストールしてください

213* **[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars)**：セッション環境でこれが設定されている場合、Claude Code は組み込みの `gh` を提供せず、セッションには `gh` がありません

214

215イメージに GitHub CLI が含まれている場合、セッションはそれを使用します。

216

198<h4 id="trust-a-private-certificate-authority-with-anthropic-managed-git">217<h4 id="trust-a-private-certificate-authority-with-anthropic-managed-git">

199 Anthropic 管理の git でプライベート認証局を信頼する218 Anthropic 管理の git でプライベート認証局を信頼する

200</h4>219</h4>

self-hosted-environments-quickstart.md +1 −1

Details

117claude -p "your message" --cloud <session-id>117claude -p "your message" --cloud <session-id>

118```118```

119 119

120`<session-id>` については、ベアの `session_...` または `cse_...` ID またはセッションの claude.ai/code URL を渡します。成功した送信は `Sent to cloud session.` をセッション ID とビューリンク付きで出力します。受け入れられた ID フォーム、JSON 出力、アカウントとポリシー要件、およびエラーリファレンスは[CLI からフォローアップを送信](/docs/ja/claude-code-on-the-web#send-follow-ups-from-the-cli)にあります。コマンドは Anthropic ホストされたセッションに対して同じように機能するためです。120`<session-id>` については、ベアの `session_...` または `cse_...` ID またはセッションの claude.ai/code URL を渡します。成功した送信は `Sent to cloud session.` をセッション ID とビューリンク付きで出力します。受け入れられた ID フォーム、JSON 出力、およびアカウントとポリシー要件は[CLI からフォローアップを送信](/docs/ja/claude-code-on-the-web#send-follow-ups-from-the-cli)にあります。コマンドは Anthropic ホストされたセッションに対して同じように機能するためです。

121 121

122<h2 id="what’s-next">122<h2 id="what’s-next">

123 次のステップ123 次のステップ

server-managed-settings.md +4 −4

Details

6 6

7> デバイス管理インフラストラクチャを必要とせずに、サーバー配信設定を通じて組織全体で Claude Code を一元的に構成します。7> デバイス管理インフラストラクチャを必要とせずに、サーバー配信設定を通じて組織全体で Claude Code を一元的に構成します。

8 8

9サーバー管理設定により、組織の所有者は claude.ai コンソールの [**Admin Settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code) から Claude Code を一元的に構成できます。Claude Code クライアントは、ユーザーが対象となる認証情報を使用して、サーバー管理配信がサポートされているプラットフォームで認証すると、これらの設定を自動的に取得します。対象となる認証情報とプラットフォームについては、[プラットフォームの可用性](#platform-availability)を参照してください。9サーバー管理設定により、組織の所有者は claude.ai コンソールの [**Organization settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code) から Claude Code を一元的に構成できます。Claude Code クライアントは、ユーザーが対象となる認証情報を使用して、サーバー管理配信がサポートされているプラットフォームで認証すると、これらの設定を自動的に取得します。対象となる認証情報とプラットフォームについては、[プラットフォームの可用性](#platform-availability)を参照してください。

10 10

11<Note>11<Note>

12 サーバー管理設定は [Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_teams#team-&-enterprise) および [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_enterprise) カスタマー向けに利用可能です。12 サーバー管理設定は [Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_teams#team-&-enterprise) および [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=server_settings_enterprise) カスタマー向けに利用可能です。

41 41

42<Steps>42<Steps>

43 <Step title="管理コンソールを開く">43 <Step title="管理コンソールを開く">

~~44 claude.ai コンソールで、[**Admin Settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code) に移動します。~~44 claude.ai コンソールで、[**Organization settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code) に移動します。

45 45

46 リンクが Claude Code ページではなく別の Admin Settings ページにリダイレクトされる場合、アカウントに必要なロールがありません。Admin およびその他の Owner 以外のロールは管理設定を表示または編集できないため、組織内の Owner または Primary Owner に変更を依頼してください。[アクセス制御](#access-control)を参照してください。46 リンクが Claude Code ページではなく別の Organization settings ページにリダイレクトされる場合、アカウントに必要なロールがありません。Admin およびその他の Owner 以外のロールは管理設定を表示または編集できないため、組織内の Owner または Primary Owner に変更を依頼してください。[アクセス制御](#access-control)を参照してください。

47 </Step>47 </Step>

48 48

49 <Step title="設定を定義する">49 <Step title="設定を定義する">

50 構成を JSON として追加します。`settings.json` で利用可能な[すべての設定](/docs/ja/settings-reference#all-settings)がサポートされており、OS レベルのポリシー配信に制限されているものを除きます。[現在の制限事項](#current-limitations)でその短いリストを参照してください。これには[hooks](/docs/ja/hooks)、[環境変数](/docs/ja/env-vars)、および `allowManagedPermissionRulesOnly` などの[管理専用設定](/docs/ja/managed-settings#managed-only-settings)が含まれます。50 構成を JSON として追加します。`settings.json` で利用可能な[すべての設定](/docs/ja/settings-reference#all-settings)がサポートされており、OS レベルのポリシー配信に制限されているものを除きます。[現在の制限事項](#current-limitations)でその短いリストを参照してください。これには[フック](/docs/ja/hooks)、[環境変数](/docs/ja/env-vars)、および `allowManagedPermissionRulesOnly` などの[管理専用設定](/docs/ja/managed-settings#managed-only-settings)が含まれます。

51 51

52 この例は、権限拒否リストを適用し、ユーザーが権限をバイパスするのを防ぎ、権限ルールを管理設定で定義されたものに制限します。`Bash(curl *)` ルールは、`/usr/bin/curl` や `sh -c 'curl …'` ではなく、[Claude が記述する方法](/docs/ja/permissions#bash-rule-limits)として `curl` にマッチします。コマンドテキストに依存しないネットワーク強制の場合は、[`sandbox` ブロックに `allowManagedDomainsOnly`](/docs/ja/sandboxing#configure-the-sandbox-for-your-organization) を追加してください。52 この例は、権限拒否リストを適用し、ユーザーが権限をバイパスするのを防ぎ、権限ルールを管理設定で定義されたものに制限します。`Bash(curl *)` ルールは、`/usr/bin/curl` や `sh -c 'curl …'` ではなく、[Claude が記述する方法](/docs/ja/permissions#bash-rule-limits)として `curl` にマッチします。コマンドテキストに依存しないネットワーク強制の場合は、[`sandbox` ブロックに `allowManagedDomainsOnly`](/docs/ja/sandboxing#configure-the-sandbox-for-your-organization) を追加してください。

53 53

sessions.md +1 −0

Details

294| [Claude Desktop と Cowork トランスクリプト](/docs/ja/claude-directory#cleaned-up-automatically) の年齢制限を設定する | [`desktopSessionCleanupPeriodDays`](/docs/ja/settings-reference#desktopsessioncleanupperioddays) | ユーザー設定、管理設定、または `--settings` |294| [Claude Desktop と Cowork トランスクリプト](/docs/ja/claude-directory#cleaned-up-automatically) の年齢制限を設定する | [`desktopSessionCleanupPeriodDays`](/docs/ja/settings-reference#desktopsessioncleanupperioddays) | ユーザー設定、管理設定、または `--settings` |

295| `-p` または Agent SDK セッションのトランスクリプトファイルが大きくなるサイズを制限する | [`CLAUDE_CODE_TRANSCRIPT_LOCAL_GC`](/docs/ja/env-vars) | 環境変数 |

297 298

settings-reference.md +3 −1

Details

990 990

991組織が管理設定をデプロイすると、Claude Code はこのキーを管理ソースからのみ読み取り、他のファイルでは無視します。991組織が管理設定をデプロイすると、Claude Code はこのキーを管理ソースからのみ読み取り、他のファイルでは無視します。

992 992

993起動時のモデルチェックにこのキーがどのように適用されるかについては、[Amazon Bedrock](/docs/ja/amazon-bedrock#when-your-organization-enforces-a-model-allowlist) および [Google Cloud の Agent Platform](/docs/ja/google-vertex-ai#when-your-organization-enforces-a-model-allowlist) を参照してください。

994

993* **スコープ**: [`任意のファイル`](#scopes)995* **スコープ**: [`任意のファイル`](#scopes)

994* **タイプ**: ブール値996* **タイプ**: ブール値

995 * `true`: **Default**が `availableModels` 外のモデルに解決される場合、Claude Code はそれをリスト内の最初の利用可能なモデルに解決します997 * `true`: **Default**が `availableModels` 外のモデルに解決される場合、Claude Code はそれをリスト内の最初の利用可能なモデルに解決します

3135* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ja/sessions#name-the-project-directory-yourself)。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。v2.1.234 以降が必要です。3137* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ja/sessions#name-the-project-directory-yourself)。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。v2.1.234 以降が必要です。

3136* [`CLAUDE_CODE_RESTRICTED`](/docs/ja/env-vars#variables)。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。3138* [`CLAUDE_CODE_RESTRICTED`](/docs/ja/env-vars#variables)。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。

3137* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](/docs/ja/env-vars#variables)。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。この変数には Claude Code v2.1.283 以降が必要です。3139* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](/docs/ja/env-vars#variables)。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。この変数には Claude Code v2.1.283 以降が必要です。

3138* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` と `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`](/docs/ja/env-vars#variables)。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。3140* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT`、`CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`、`CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT`](/docs/ja/env-vars#variables)。Claude Code は起動環境からのみ読み取ります。すべてのファイルから無視されます。

3139 3141

3140<h3 id="filecheckpointingenabled">3142<h3 id="filecheckpointingenabled">

3141 `fileCheckpointingEnabled`3143 `fileCheckpointingEnabled`

skills.md +16 −3

Details

561 561

562デフォルトでは、あなたと Claude の両方がスキルを呼び出すことができます。`/skill-name` を入力して直接呼び出すことができ、Claude は会話に関連する場合に自動的に読み込むことができます。2 つのフロントマターフィールドでこれを制限できます。562デフォルトでは、あなたと Claude の両方がスキルを呼び出すことができます。`/skill-name` を入力して直接呼び出すことができ、Claude は会話に関連する場合に自動的に読み込むことができます。2 つのフロントマターフィールドでこれを制限できます。

563 563

564* **`disable-model-invocation: true`**：あなたのみがスキルを呼び出すことができます。`/commit`、`/deploy`、`/send-slack-message` など、副作用があるワークフロー、またはタイミングを制御したいワークフローに使用します。コードが準備完了に見えるため、Claude がデプロイすることを望みません。564* **`disable-model-invocation: true`**：Claude は単独ではスキルを呼び出せません。`/commit`、`/deploy`、`/send-slack-message` など、副作用があるワークフロー、またはタイミングを制御したいワークフローに使用します。コードが準備完了に見えるからといって、Claude にデプロイを判断させたくはないはずです。

565 565

566* **`user-invocable: false`**：Claude のみがスキルを呼び出すことができます。アクションとして実行できないバックグラウンド知識に使用します。`legacy-system-context` スキルは古いシステムがどのように機能するかを説明します。Claude はこれが関連する場合に知るべきですが、`/legacy-system-context` はユーザーが実行する意味のあるアクションではありません。566* **`user-invocable: false`**：Claude のみがスキルを呼び出すことができます。アクションとして実行できないバックグラウンド知識に使用します。`legacy-system-context` スキルは古いシステムがどのように機能するかを説明します。Claude はこれが関連する場合に知るべきですが、`/legacy-system-context` はユーザーが実行する意味のあるアクションではありません。

567 567

568この例は、あなたのみがトリガーできるデプロイスキルを作成します。`disable-model-invocation: true` を設定した場合、Claude はスキルを自動的に実行できません。568この例はデプロイスキルを作成します。`disable-model-invocation: true` を設定した場合、Claude はスキルを自動的に実行できません。

569 569

570```yaml theme={null}570```yaml theme={null}

571---571---

590| :- | :- | :- | :- |590| :- | :- | :- | :- |

591| （デフォルト） | はい | はい | 説明は常にコンテキストにあり、呼び出されたときに完全なスキルが読み込まれます |591| （デフォルト） | はい | はい | 説明は常にコンテキストにあり、呼び出されたときに完全なスキルが読み込まれます |

592| `disable-model-invocation: true` | はい | いいえ | 説明はコンテキストにはなく、あなたが呼び出したときに完全なスキルが読み込まれます |592| `disable-model-invocation: true` | はい | 単独では不可 | 説明はコンテキストにはなく、呼び出されたときに完全なスキルが読み込まれます |

593| `user-invocable: false` | いいえ | はい | 説明は常にコンテキストにあり、呼び出されたときに完全なスキルが読み込まれます |593| `user-invocable: false` | いいえ | はい | 説明は常にコンテキストにあり、呼び出されたときに完全なスキルが読み込まれます |

594 594

595<Note>595<Note>

596 通常のセッションでは、スキルの説明がコンテキストに読み込まれるため、Claude は何が利用可能かを知っていますが、完全なスキルコンテンツは呼び出されたときにのみ読み込まれます。[事前読み込みされたスキルを持つサブエージェント](/docs/ja/sub-agents#preload-skills-into-subagents) は異なります。完全なスキルコンテンツはスタートアップで注入されます。596 通常のセッションでは、スキルの説明がコンテキストに読み込まれるため、Claude は何が利用可能かを知っていますが、完全なスキルコンテンツは呼び出されたときにのみ読み込まれます。[事前読み込みされたスキルを持つサブエージェント](/docs/ja/sub-agents#preload-skills-into-subagents) は異なります。完全なスキルコンテンツはスタートアップで注入されます。

597</Note>597</Note>

598 598

599<h4 id="where-you-write-the-skill’s-name">

600 スキル名を書く位置

601</h4>

602

603スキルを直接実行するには、メッセージの先頭にその名前を置きます。通常のテキストの後に書いた場合、名前は Claude にスキルを実行する権限を与えますが、スキル自体は実行されません。

604

605| 位置 | 例 | 動作 |

606| :- | :- | :- |

607| メッセージの先頭 | `/deploy staging` | Claude Code がスキルを直接実行します |

608| 通常のテキストの後、句読点を付けない独立した単語として | `go ahead and /deploy to staging` | 直接は何も実行されません。名前はそのメッセージに対する権限としてカウントされます。Claude は応答中にスキルを実行でき、スキルの実行を求められたかどうかを文言から判断します |

609

610実行を許可せずにスキルについて書くには、スラッシュを省略します。

611

599<h3 id="skill-content-lifecycle">612<h3 id="skill-content-lifecycle">

600 スキルコンテンツのライフサイクル613 スキルコンテンツのライフサイクル

601</h3>614</h3>

sub-agents.md +1 −1

Details

632 632

633リストされた各スキルの完全なコンテンツは起動時にサブエージェントのコンテキストに注入されます。このフィールドはプリロードされるスキルを制御し、サブエージェントがアクセスできるスキルではありません。なしで、サブエージェントは実行中に Skill ツールを通じてプロジェクト、ユーザー、およびプラグインスキルを発見して呼び出すことができます。スキルを完全に呼び出すことを防ぐには、[`tools`](#available-tools)リストから `Skill` を省略するか、`disallowedTools` に追加します。633リストされた各スキルの完全なコンテンツは起動時にサブエージェントのコンテキストに注入されます。このフィールドはプリロードされるスキルを制御し、サブエージェントがアクセスできるスキルではありません。なしで、サブエージェントは実行中に Skill ツールを通じてプロジェクト、ユーザー、およびプラグインスキルを発見して呼び出すことができます。スキルを完全に呼び出すことを防ぐには、[`tools`](#available-tools)リストから `Skill` を省略するか、`disallowedTools` に追加します。

634 634

635[`disable-model-invocation: true`](/docs/ja/skills#control-who-invokes-a-skill)を設定するスキルはプリロードできません。プリロードは Claude が呼び出すことができるスキルの同じセットから描画するため。これには、バンドルされた `/verify` スキルが含まれます。実行できるのはあなただけなので、プリロードすることもできません。635[`disable-model-invocation: true`](/docs/ja/skills#control-who-invokes-a-skill)を設定するスキルはプリロードできません。プリロードは Claude が呼び出すことができるスキルと同じセットから取得されるためです。これには、Claude が単独で実行できないバンドルされた `/verify` スキルが含まれます。

636 636

637リストされたスキルが見つからないか無効な場合（例えば、組織のポリシーによって）、Claude Code はスキップし、デバッグログに警告をログします。637リストされたスキルが見つからないか無効な場合（例えば、組織のポリシーによって）、Claude Code はスキップし、デバッグログに警告をログします。

638 638

tools-reference.md +13 −0

Details

487 487

488Claude Code は PowerShell をプロセススコープのみで `-ExecutionPolicy Bypass` で起動するため、`.ps1` スクリプトとモジュールインポートは、マシンのポリシーを変更することなく、デフォルトの Windows インストールで機能します。プロセススコープのバイパスは、グループポリシーの `MachinePolicy` または `UserPolicy` をオーバーライドしないため、エンタープライズポリシーは引き続き適用されます。マシンの有効な実行ポリシーを尊重するには、`CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1` を設定します。488Claude Code は PowerShell をプロセススコープのみで `-ExecutionPolicy Bypass` で起動するため、`.ps1` スクリプトとモジュールインポートは、マシンのポリシーを変更することなく、デフォルトの Windows インストールで機能します。プロセススコープのバイパスは、グループポリシーの `MachinePolicy` または `UserPolicy` をオーバーライドしないため、エンタープライズポリシーは引き続き適用されます。マシンの有効な実行ポリシーを尊重するには、`CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1` を設定します。

489 489

490<h3 id="bash-deny-rules-also-turn-off-the-powershell-tool">

491 Bash の拒否ルールは PowerShell ツールもオフにする

492</h3>

493

494Git Bash がインストールされている Windows では、Bash を拒否すると、そのセッションでは PowerShell ツールもオフになります。これは単独の `Bash` だけでなく `Bash(git push *)` のようなスコープ付きルールにも適用され、いずれかの設定ファイルのルールにも `--disallowedTools` のルールにも適用されます。Claude Code がこのように動作するのは、`Bash` ルールでは PowerShell ツールが制限されないためです。PowerShell ツールには[独自の権限ルール](/docs/ja/permissions#powershell)があります。PowerShell がオンのままだと、Claude はルールで Bash において拒否されている操作を PowerShell で実行できてしまいます。

495

496Bash の拒否ルールと併せて PowerShell ツールをオンのままにするには、次のいずれかを行います。

497

498* [PowerShell ツールを有効にする](#enable-the-powershell-tool)に示すように、環境または設定ファイルの `env` ブロックで `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` を設定します。

499* `PowerShell(git push *)` 拒否ルールなど、スコープ付きの [`PowerShell` 権限ルール](/docs/ja/permissions#powershell)を設定ファイルに追加します。

500

501これらのいずれも行わない場合、スコープ付きの Bash 拒否ルールでは Bash ツールは利用可能なままですが、Claude Code は警告なしに PowerShell をオフにします。Bash ツール全体を除外するルールの場合、そのセッションで Claude が使えるシェルツールはなくなります。

502

490<h3 id="shell-selection-in-settings-hooks-and-skills">503<h3 id="shell-selection-in-settings-hooks-and-skills">

491 設定、フック、スキルでのシェル選択504 設定、フック、スキルでのシェル選択

492</h3>505</h3>

web-quickstart.md +4 −4

Details

62GitHub への接続は 1 回限りのステップです。既に GitHub CLI を使用している場合は、ブラウザの代わりに [ターミナルからこれを実行](#connect-from-your-terminal) できます。62GitHub への接続は 1 回限りのステップです。既に GitHub CLI を使用している場合は、ブラウザの代わりに [ターミナルからこれを実行](#connect-from-your-terminal) できます。

63 63

64<Note>64<Note>

65 Team および Enterprise プランでは、**Sign in with GitHub** ステップは、Claude 組織の [Owner](/docs/ja/server-managed-settings#access-control) が [**Admin settings > Connectors**](https://claude.ai/admin-settings/connectors) で GitHub コネクタをオンにした後にのみ機能します。それまでは、そのステップはサインインボタンの代わりに「GitHub access is required for Claude Code on the web」と表示されます。コネクタがオンになった後、[claude.ai/code](https://claude.ai/code) をリロードして、最初のステップから再度開始します。[**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code) の [Quick web setup](/docs/ja/claude-code-on-the-web#github-authentication-options) という 2 番目のトグルはオプションです。オンにすると、`/web-setup` が機能し、オンボーディングはメンバーの環境を作成します。65 Team および Enterprise プランでは、**Sign in with GitHub** ステップは、Claude 組織の [Owner](/docs/ja/server-managed-settings#access-control) が [**Organization settings > Connectors**](https://claude.ai/admin-settings/connectors) で GitHub コネクタをオンにした後にのみ機能します。それまでは、そのステップはサインインボタンの代わりに「GitHub access is required for Claude Code cloud sessions」と表示されます。コネクタがオンになった後、[claude.ai/code](https://claude.ai/code) をリロードして、最初のステップから再度開始します。[**Organization settings > Claude Code**](https://claude.ai/admin-settings/claude-code) の [Quick setup](/docs/ja/claude-code-on-the-web#quick-setup-for-team-and-enterprise) という 2 番目のトグルはオプションです。オンにすると、`/web-setup` が機能し、オンボーディングはメンバーの環境を作成します。

66</Note>66</Note>

67 67

68<Steps>68<Steps>

84 [cloud environment](/docs/ja/cloud-environments) は、セッション中に Claude が持つネットワークアクセスと、セッション開始時に実行される内容を制御する保存された設定です。GitHub を接続した後の動作はプランによって異なります。84 [cloud environment](/docs/ja/cloud-environments) は、セッション中に Claude が持つネットワークアクセスと、セッション開始時に実行される内容を制御する保存された設定です。GitHub を接続した後の動作はプランによって異なります。

85 85

86 * **Pro および Max**：オンボーディングは **Default** という名前の環境を作成します。86 * **Pro および Max**：オンボーディングは **Default** という名前の環境を作成します。

87 * **Team および Enterprise**：オンボーディングは **Create your first cloud environment** フォームを表示します。事前入力された名前とネットワークアクセスを変更せず、**Create & finish** をクリックして **Default** 環境を作成します。Owner が [Quick web setup](/docs/ja/claude-code-on-the-web#github-authentication-options) をオンにしている場合、オンボーディングは代わりに **Default** を作成します。87 * **Team および Enterprise**：オンボーディングは **Create your first cloud environment** フォームを表示します。事前入力された名前とネットワークアクセスを変更せず、**Create & finish** をクリックして **Default** 環境を作成します。Owner が [Quick setup](/docs/ja/claude-code-on-the-web#quick-setup-for-team-and-enterprise) をオンにしている場合、オンボーディングは代わりに **Default** を作成します。

88 88

89 **Default** は [`Trusted` ネットワークアクセス](/docs/ja/cloud-environments#access-levels) を使用します。セッションは [common package registries](/docs/ja/cloud-environments#default-allowed-domains) およびその他のホワイトリストに登録されたドメインに到達し、セッションのネットワークを通じて他には何も到達しません。設定なしで利用可能な内容については、[Installed tools](/docs/ja/cloud-environments#installed-tools) を参照してください。89 **Default** は [`Trusted` ネットワークアクセス](/docs/ja/cloud-environments#access-levels) を使用します。セッションは [common package registries](/docs/ja/cloud-environments#default-allowed-domains) およびその他のホワイトリストに登録されたドメインに到達し、セッションのネットワークを通じて他には何も到達しません。設定なしで利用可能な内容については、[Installed tools](/docs/ja/cloud-environments#installed-tools) を参照してください。

90 90

96 ターミナルから接続96 ターミナルから接続

97</h3>97</h3>

98 98

99既に GitHub CLI（`gh`）を使用している場合は、ターミナルから cloud セッション用に GitHub を接続できます。これには [Claude Code CLI](/docs/ja/quickstart) が必要です。Team および Enterprise プランでは、`/web-setup` は Owner が [Quick web setup](/docs/ja/claude-code-on-the-web#github-authentication-options) をオンにした後にのみ利用可能です。99既に GitHub CLI（`gh`）を使用している場合は、ターミナルからクラウドセッション用に GitHub を接続できます。これには [Claude Code CLI](/docs/ja/quickstart) が必要です。Team および Enterprise プランでは、`/web-setup` は Owner が [Quick setup](/docs/ja/claude-code-on-the-web#quick-setup-for-team-and-enterprise) をオンにした後にのみ利用可能です。

100 100

101`/web-setup` を実行すると、Claude Code は `gh auth token` が出力するトークンを読み取り、確認を求め、トークンを Anthropic に送信します。Anthropic はそれを claude.ai アカウントで暗号化して保存し、cloud セッションはそれを GitHub アクセスに使用します。これは [削除](#remove-the-web-setup-token) するまで続きます。自分で開始した cloud セッションは、そのトークンがアクセスできる任意のリポジトリにアクセスでき、Claude GitHub App をインストールする必要はありません。[project](/docs/ja/claude-projects#set-up-github-access) 内のスレッドは引き続き Claude GitHub App が必要です。101`/web-setup` を実行すると、Claude Code は `gh auth token` が出力するトークンを読み取り、確認を求め、トークンを Anthropic に送信します。Anthropic はそれを claude.ai アカウントで暗号化して保存し、cloud セッションはそれを GitHub アクセスに使用します。これは [削除](#remove-the-web-setup-token) するまで続きます。自分で開始した cloud セッションは、そのトークンがアクセスできる任意のリポジトリにアクセスでき、Claude GitHub App をインストールする必要はありません。[project](/docs/ja/claude-projects#set-up-github-access) 内のスレッドは引き続き Claude GitHub App が必要です。

102 102

259 259

260Claude Code 内に入力した場合、コマンドメニューが「No commands match "/web-setup"」を表示するか、送信すると「Unknown command: /web-setup」が返される場合、要件が満たされていないため、コマンドは非表示になっています。通常の原因は、claude.ai サブスクリプションではなく API キーまたはサードパーティプロバイダーで認証されていることです。`/login` を実行して claude.ai アカウントでサインインしてください。260Claude Code 内に入力した場合、コマンドメニューが「No commands match "/web-setup"」を表示するか、送信すると「Unknown command: /web-setup」が返される場合、要件が満たされていないため、コマンドは非表示になっています。通常の原因は、claude.ai サブスクリプションではなく API キーまたはサードパーティプロバイダーで認証されていることです。`/login` を実行して claude.ai アカウントでサインインしてください。

261 261

262Team および Enterprise プランでは、コマンドはデフォルトで非表示になっています。[Quick web setup トグル](/docs/ja/claude-code-on-the-web#github-authentication-options)は、所有者がオンにするまでオフになっています。オフの間は、代わりに[ブラウザから GitHub を接続](#connect-github)してください。262Team および Enterprise プランでは、コマンドはデフォルトで非表示になっています。[Quick setup トグル](/docs/ja/claude-code-on-the-web#quick-setup-for-team-and-enterprise)は、所有者がオンにするまでオフになっています。オフの間は、代わりに[ブラウザから GitHub を接続](#connect-github)してください。

263 263

264コマンドは他の 2 つのケースでも非表示になります。264コマンドは他の 2 つのケースでも非表示になります。

265 265

whats-new/2026-w37.md +69 −0 created

Details

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.

5# Week 37 · 2026年9月7日～11日

7> claude plugin eval でプラグインをテストし、Claude Code Desktop のペインを独立したウィンドウにポップアウトします。

9<div className="digest-meta">

10 <span>リリース <a href="/docs/en/changelog#2-1-263">v2.1.263 → v2.1.269</a></span>

11 <span>2 つの機能 · 9月7日～11日</span>

12</div>

14<div className="digest-feature">

15 <div className="digest-feature-header">

16 <span className="digest-feature-title">claude plugin eval でプラグインをテストする</span>

17 <span className="digest-feature-pill">v2.1.269</span>

18 </div>

20 <p className="digest-feature-lede"><code>claude plugin eval</code> はプラグインをテストケースのスイートに対して実行し、結果をスコア付けします。デフォルトでは、プラグインなしで各ケースを再度実行して、プラグインの貢献度を確認できます。<code>claude plugin eval init</code> は良い結果がどのようなものかを尋ね、テストケースと結果をスコア付けするチェックを提案し、スイートを一度試して、ファイルを書き込みます。すべての実行と、2 番目のモデルジャッジを持つすべてのチェックは、アカウント上の実際のモデル呼び出しです。</p>

22 <Frame>

23 <img className="w-full" src="https://mintcdn.com/claude-code/f9HTZGyMtxIFOUgt/images/whats-new/plugin-eval.jpg?fit=max&auto=format&n=f9HTZGyMtxIFOUgt&q=85&s=913066f6d4a2a15426e98a627802f47f" alt="claude plugin eval のターミナル出力：7 つのケースのテーブル。各ケースのプラグインありのスコア、プラグインなしのスコア、その差分、実行回数、コストが表示され、その後に平均差分、総実行時間、総コストを示す概要行が続きます" width="1600" height="900" data-path="images/whats-new/plugin-eval.jpg" />

24 </Frame>

26 <p className="digest-feature-try">プラグインのルートディレクトリから、Claude にスイートをドラフトさせます：</p>

28 ```bash terminal theme={null}

29 claude plugin eval init

30 ```

32 <p className="digest-feature-try">Claude がスイートの準備ができたことを告げたら、<code>claude plugin eval init</code> が開いたセッションを終了して、<code>claude plugin eval .</code> を実行してすべてのケースをスコア付けします。概要テーブルはターミナルに出力され、<code>evals/results/</code> の下の <code>report.html</code> に実行ごとの詳細が含まれます。</p>

34 <a className="digest-feature-link" href="/docs/ja/plugin-evals">evals でプラグインをテストする</a>

35</div>

37<div className="digest-feature">

38 <div className="digest-feature-header">

39 <span className="digest-feature-title">Desktop ペインを独立したウィンドウにポップアウトする</span>

40 <span className="digest-feature-pill">Desktop</span>

41 </div>

43 <p className="digest-feature-lede">Claude Code Desktop アプリでは、任意のペインを独立したウィンドウにポップアウトできます。diff またはターミナルを 2 番目のスクリーンにドラッグして Claude がメインウィンドウで作業を続けている間、完了したらペインをドックに戻します。</p>

45 <Frame>

46 <video autoPlay muted loop playsInline className="w-full" src="https://mintcdn.com/claude-code/f9HTZGyMtxIFOUgt/images/whats-new/desktop-pop-out-panes.mp4?fit=max&auto=format&n=f9HTZGyMtxIFOUgt&q=85&s=ff3770dd09bb15ed9cf17a460f3d1e23" data-path="images/whats-new/desktop-pop-out-panes.mp4" />

47 </Frame>

49 <a className="digest-feature-link" href="/docs/ja/desktop#arrange-your-workspace">ワークスペースを整理する</a>

50</div>

52<div className="digest-wins">

53 <p className="digest-wins-title">その他の改善</p>

55 <div className="digest-wins-grid">

56 <div><a href="/docs/ja/settings-reference#maxeffortlevel"><code>maxEffortLevel</code></a> をトップレベルで、または <code>modelSettings</code> の下でモデルごとに設定して、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry を含むすべてのプロバイダーの努力レベルをキャップします。より高いレベルはキャップで実行されます</div>

57 <div><code>--plugin-dir</code> をプラグインのフォルダに指定して、<a href="/docs/ja/plugins/create#load-a-directory-or-archive-for-one-session">マニフェストを持つ各直下のサブフォルダを読み込みます</a></div>

58 <div>WebFetch が 5 分以内にページのダウンロードを完了しない場合、<a href="/docs/ja/tools-reference#webfetch-tool-behavior">フェッチはハングする代わりにデッドラインエラーで失敗します</a>。<code>CLAUDE\_CODE\_WEBFETCH\_DEADLINE\_MS</code> を設定してデッドラインを変更するか、<code>0</code> に設定して制限を削除します</div>

59 <div><code>claude plugin install</code>、<code>uninstall</code>、<code>update</code>、<code>enable</code>、または <code>disable</code> に <code>--json</code> を渡して、結果を <a href="/docs/ja/plugins/cli-reference#plugin-json-result">stdout の最後の行に 1 つの JSON オブジェクトとして出力します</a></div>

60 <div>オートモード分類器がアクションをブロックする場合、Claude が受け取る理由は <a href="/docs/ja/auto-mode-config#fix-a-denial-with-an-allow-rule-an-environment-entry-or-a-retry">通常、マッチしたルールの名前を示します</a>。例えば <code>\[Data Exfiltration]</code></div>

61 <div>プロンプトの途中で <code>/</code> を入力すると、単一の提案ではなく、<a href="/docs/ja/interactive-mode#complete-a-command-mid-prompt">マッチするコマンドのリストから選択できるようになりました</a>。リストはフルスクリーンレンダリングで入力時に開きます。プラグインスキルはプラグインプレフィックスなしで名前にもマッチします</div>

62 <div>VS Code 拡張機能では、プロンプトボックスの下部のエージェント数をクリックして、<a href="/docs/ja/vs-code#use-the-prompt-box">エージェントマップを開きます</a>。ここでサブエージェントの読み取り専用トランスクリプトを開くか、停止できます</div>

63 <div>VS Code 拡張機能では、コマンドメニューの Customize セクションで <strong>Hooks</strong> または <strong>Permissions</strong> を選択して、<a href="/docs/ja/vs-code#use-the-prompt-box">ユーザー、プロジェクト、ローカル設定でフックと権限ルールを追加または削除します</a></div>

64 <div>Claude は <a href="/docs/ja/artifacts#create-an-artifact">ブラウザタブアイコンを選択できます</a>。公開する各アーティファクトに一致させます</div>

65 <div>Claude Code ウェブで、クラウドセッションでキューに入れられたメッセージを Claude が読む前に取り戻します：キューから削除するか、<code>Esc</code> または <code>Up</code> を押すと、テキストがメッセージボックスに戻ります</div>

66 </div>

67</div>

69[v2.1.263–v2.1.269 の完全なチェンジログ →](/docs/en/changelog#2-1-263)

Documentation 2026-10-03 23:57 UTC to 2026-10-04 21:01 UTC