SpyBara
Go Premium

Documentation 2026-10-08 22:58 UTC to 2026-10-09 22:01 UTC

63 files changed +1,584 −757. View all changes and history on the product overview
2026
Fri 9 23:02 Thu 8 22:58 Wed 7 23:59 Tue 6 23:59 Mon 5 23:58 Sun 4 23:58 Sat 3 23:57 Fri 2 22:59 Thu 1 23:59
Details

216| オプション | 制御内容 | デフォルト |216| オプション | 制御内容 | デフォルト |

217| :- | :- | :- |217| :- | :- | :- |

218| 最大ターン(`max_turns` / `maxTurns`) | 最大ツール使用往復数 | 制限なし |218| 最大ターン(`max_turns` / `maxTurns`) | 最大ツール使用往復数 | 制限なし |

219| 最大予算(`max_budget_usd` / `maxBudgetUsd`) | 停止前の最大コスト | 制限なし |219| 最大予算(`max_budget_usd` / `maxBudgetUsd`) | ループが停止する推定支出額 | 制限なし |

220 220 

221どちらかの制限に達すると、SDK は対応するエラーサブタイプ(`error_max_turns` または `error_max_budget_usd`)を含む `ResultMessage` を返します。これらのサブタイプをチェックする方法については[結果を処理する](#handle-the-result)を、構文については[`ClaudeAgentOptions`](/docs/ja/agent-sdk/python#claudeagentoptions) / [`Options`](/docs/ja/agent-sdk/typescript#options)を参照してください。221どちらかの制限に達すると、SDK は対応するエラーサブタイプ(`error_max_turns` または `error_max_budget_usd`)を含む `ResultMessage` を返します。これらのサブタイプをチェックする方法については[結果を処理する](#handle-the-result)を、構文については[`ClaudeAgentOptions`](/docs/ja/agent-sdk/python#claudeagentoptions) / [`Options`](/docs/ja/agent-sdk/typescript#options)を参照してください。

222 222 


224 224 

225[ストリーミング入力](/docs/ja/agent-sdk/streaming-vs-single-mode)を使用する場合、ターンが最大ターン制限で終了するときにまだキューに入っているメッセージは、キューに入ったままになります。Claude Code はそれをそのターンの最後のモデル呼び出しに追加しません。メッセージの新しいターンを開始し、そのターンの最大ターン数がリセットされます。予算合計はメッセージ全体で累積し続け、支出が `maxBudgetUsd` に達すると、同じ会話内の後続メッセージは `error_max_budget_usd` 結果で終了します。[`/clear`](/docs/ja/agent-sdk/cost-tracking)は予算をリセットします。225[ストリーミング入力](/docs/ja/agent-sdk/streaming-vs-single-mode)を使用する場合、ターンが最大ターン制限で終了するときにまだキューに入っているメッセージは、キューに入ったままになります。Claude Code はそれをそのターンの最後のモデル呼び出しに追加しません。メッセージの新しいターンを開始し、そのターンの最大ターン数がリセットされます。予算合計はメッセージ全体で累積し続け、支出が `maxBudgetUsd` に達すると、同じ会話内の後続メッセージは `error_max_budget_usd` 結果で終了します。[`/clear`](/docs/ja/agent-sdk/cost-tracking)は予算をリセットします。

226 226 

227<h4 id="budget-headroom">

228 予算の余裕

229</h4>

230 

231Claude Code は、モデルの応答が届いた後に支出を `max_budget_usd` / `maxBudgetUsd` の上限と比較します。各応答のコストは、API がその応答とともに返すトークン使用量から算出されるためです。上限に達した応答もそのまま完了し、[`total_cost_usd`](/docs/ja/agent-sdk/cost-tracking#get-the-total-cost-of-a-query) に計上されます。そのため、支出は最大でその 1 つの応答のコスト分に加え、その時点でまだ実行中のサブエージェントが停止するまでに費やした分だけ上限を超える可能性があります。上限を設定する際は、この分の余裕を見込んでください。

232 

227<h3 id="effort-level">233<h3 id="effort-level">

228 努力レベル234 努力レベル

229</h3>235</h3>

Details

78 78 

79`query()` を呼び出す際にコード内で MCP サーバーを設定するか、[`settingSources`](#from-a-config-file) 経由で読み込まれる `.mcp.json` ファイルで設定できます。79`query()` を呼び出す際にコード内で MCP サーバーを設定するか、[`settingSources`](#from-a-config-file) 経由で読み込まれる `.mcp.json` ファイルで設定できます。

80 80 

81<h3 id="in-code">81<span id="in-code" />

82 コード内での設定82 

83<h3 id="add-a-server-in-code">

84 コード内でサーバーを追加する

83</h3>85</h3>

84 86 

85`mcpServers` オプションで MCP サーバーを直接渡します。この例では `/Users/me/projects` 用のローカルファイルシステム MCP サーバーを起動します。そのパスをマシン上のディレクトリに置き換えてください。87`mcpServers` オプションで MCP サーバーを直接渡します。この例では `/Users/me/projects` 用のローカルファイルシステム MCP サーバーを起動します。そのパスをマシン上のディレクトリに置き換えてください。


135 ```137 ```

136</CodeGroup>138</CodeGroup>

137 139 

138<h3 id="from-a-config-file">140<span id="from-a-config-file" />

139 設定ファイルから読み込む141 

142<h3 id="add-a-server-from-a-config-file">

143 設定ファイルからサーバーを追加する

140</h3>144</h3>

141 145 

142プロジェクトルートに `.mcp.json` ファイルを作成します。このファイルは `project` 設定ソースが有効な場合に読み込まれます。デフォルトの `query()` オプションでは有効になっています。`settingSources` を明示的に設定する場合は、このファイルを読み込むために `"project"` を含めてください。`/Users/me/projects` をマシン上のディレクトリに置き換えてください。146プロジェクトルートに `.mcp.json` ファイルを作成します。このファイルは `project` 設定ソースが有効な場合に読み込まれます。デフォルトの `query()` オプションでは有効になっています。`settingSources` を明示的に設定する場合は、このファイルを読み込むために `"project"` を含めてください。`/Users/me/projects` をマシン上のディレクトリに置き換えてください。


301 stdio サーバー305 stdio サーバー

302</h3>306</h3>

303 307 

304stdin/stdout を介して通信するローカルプロセスです。同じマシン上で実行する MCP サーバーに使用します。`.mcp.json` 形式の場合は、[設定ファイルから](#from-a-config-file)に示されているのと同じフィールドを使用します。コード内では、コマンドとその引数を渡します。`/Users/me/projects` をマシン上のディレクトリに置き換えます。308stdin/stdout を介して通信するローカルプロセスです。同じマシン上で実行する MCP サーバーに使用します。`.mcp.json` 形式の場合は、[設定ファイルからサーバーを追加する](#from-a-config-file)に示されているのと同じフィールドを使用します。コード内では、コマンドとその引数を渡します。`/Users/me/projects` をマシン上のディレクトリに置き換えます。

305 309 

306<CodeGroup>310<CodeGroup>

307 ```typescript TypeScript hidelines={1,-1} theme={null}311 ```typescript TypeScript hidelines={1,-1} theme={null}

Details

28 マイグレーションステップ28 マイグレーションステップ

29</h2>29</h2>

30 30 

31<h3 id="for-typescript/javascript-projects">31<span id="for-typescript/javascript-projects" />

32 TypeScript/JavaScript プロジェクト向け32 

33<h3 id="migrate-a-typescript-or-javascript-project">

34 TypeScript または JavaScript プロジェクトを移行する

33</h3>35</h3>

34 36 

35**1. 古いパッケージをアンインストールします:**37**1. 古いパッケージをアンインストールします:**


64 66 

65マイグレーションを完了するために必要なコード変更を行います。67マイグレーションを完了するために必要なコード変更を行います。

66 68 

67<h3 id="for-python-projects">69<span id="for-python-projects" />

68 Python プロジェクト向け70 

71<h3 id="migrate-a-python-project">

72 Python プロジェクトを移行する

69</h3>73</h3>

70 74 

71**1. 古いパッケージをアンインストールします:**75**1. 古いパッケージをアンインストールします:**

Details

146| `auto` | モデル分類承認 | モデル分類器がシェルコマンドやネットワークリクエストなどのアクションをレビューし、レビューする各アクションを許可またはブロックします。利用可能性と決定順序については [自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) を参照してください |146| `auto` | モデル分類承認 | モデル分類器がシェルコマンドやネットワークリクエストなどのアクションをレビューし、レビューする各アクションを許可またはブロックします。利用可能性と決定順序については [自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) を参照してください |

147 147 

148<Warning>148<Warning>

149 **サブエージェント継承:** サブエージェントは、その [`AgentDefinition`](/docs/ja/agent-sdk/typescript#agentdefinition) で `permissionMode` を設定し、親セッションが `default`、`dontAsk`、または `plan` モードにある場合を除き、親セッションの権限モードで実行されます。その場合でも、Claude Code は `"bypassPermissions"` 値を適用しません。サブエージェントは、親セッション自体が `bypassPermissions` モードにある場合にのみ、`bypassPermissions` モードで実行されます。`bypassPermissions` 例外には Claude Code v2.1.267 以降が必要です。149 **サブエージェント継承:** サブエージェントは、その [`AgentDefinition`](/docs/ja/agent-sdk/typescript#agentdefinition) で `permissionMode` を設定し、親セッションが `default`、`dontAsk`、または `plan` モードにある場合を除き、親セッションの権限モードで実行されます。その場合でも、Claude Code は `"bypassPermissions"` 値を適用せず、`"auto"` 値はそのサブエージェントで [auto モードが利用可能](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) な場合にのみ適用します。サブエージェントは、親セッション自体が `bypassPermissions` モードにある場合にのみ、`bypassPermissions` モードで実行されます。`bypassPermissions` 例外には Claude Code v2.1.267 以降が必要です。

150 150 

151 サブエージェントは、メインエージェントとは異なるシステムプロンプトを持つ可能性があり、動作がより制約されていないため、`bypassPermissions` を継承すると、完全で自律的なシステムアクセスが付与されます。[モードが自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves) は引き続き適用されます。151 サブエージェントは、メインエージェントとは異なるシステムプロンプトを持つ可能性があり、動作がより制約されていないため、`bypassPermissions` を継承すると、完全で自律的なシステムアクセスが付与されます。[モードが自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves) は引き続き適用されます。

152</Warning>152</Warning>

Details

928| `resume` | `str \| None` | `None` | 再開するセッションID |928| `resume` | `str \| None` | `None` | 再開するセッションID |

929| `session_id` | `str \| None` | `None` | 自動生成されたIDの代わりに特定のセッションIDを使用します。有効なUUIDである必要があります。`fork_session`も設定されていない限り、`continue_conversation`または`resume`と組み合わせることはできません |929| `session_id` | `str \| None` | `None` | 自動生成されたIDの代わりに特定のセッションIDを使用します。有効なUUIDである必要があります。`fork_session`も設定されていない限り、`continue_conversation`または`resume`と組み合わせることはできません |

930| `max_turns` | `int \| None` | `None` | 最大agentic ターン(ツール使用ラウンドトリップ) |930| `max_turns` | `int \| None` | `None` | 最大agentic ターン(ツール使用ラウンドトリップ) |

931| `max_budget_usd` | `float \| None` | `None` | クライアント側のコスト推定がこのUSD値に達したときにクエリを停止します。呼び出し自体の支出のみをカウントします。再開されたセッションから復元された合計はカウントされません。精度の注意事項とリセット動作については、[コストと使用状況を追跡](/docs/ja/agent-sdk/cost-tracking)を参照してください |931| `max_budget_usd` | `float \| None` | `None` | クライアント側のコスト推定がこのUSD値に達したときにクエリを停止します。推定値はこの値を超える場合があるため、[余裕を持たせてください](/docs/ja/agent-sdk/agent-loop#budget-headroom)。呼び出し自体の支出のみをカウントします。再開されたセッションから復元された合計はカウントされません。精度の注意事項とリセット動作については、[コストと使用状況を追跡](/docs/ja/agent-sdk/cost-tracking)を参照してください |

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

933| `enable_file_checkpointing` | `bool` | `False` | 巻き戻しのためのファイル変更追跡を有効にします。[ファイルチェックポイント](/docs/ja/agent-sdk/file-checkpointing)を参照してください |933| `enable_file_checkpointing` | `bool` | `False` | 巻き戻しのためのファイル変更追跡を有効にします。[ファイルチェックポイント](/docs/ja/agent-sdk/file-checkpointing)を参照してください |

934| `model` | `str \| None` | `None` | Claudeモデルエイリアスまたは完全なモデル名。[受け入れられた値とプロバイダー固有のID](/docs/ja/model-config#available-models)を参照してください |934| `model` | `str \| None` | `None` | Claudeモデルエイリアスまたは完全なモデル名。[受け入れられた値とプロバイダー固有のID](/docs/ja/model-config#available-models)を参照してください |


987```987```

988 988 

989* `API_TIMEOUT_MS`:Anthropicクライアントのリクエスト単位のタイムアウト(ミリ秒)。デフォルト`600000`。メインループとすべてのサブエージェントに適用されます。989* `API_TIMEOUT_MS`:Anthropicクライアントのリクエスト単位のタイムアウト(ミリ秒)。デフォルト`600000`。メインループとすべてのサブエージェントに適用されます。

990* `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`に引き上げ、この変数の上限を削除します。990* `CLAUDE_CODE_MAX_RETRIES`:最大APIリトライ。デフォルト`10`、上限`15`。各リトライは独自の`API_TIMEOUT_MS`ウィンドウを取得します。

991 

992 無人実行で長い停止を待つ必要がある場合は、[`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/ja/errors#tune-retry-behavior)を設定します:一時的な容量エラーを無限に再試行し、Claude Code v2.1.199以降では、他の一時的なエラーのデフォルトを`300`に引き上げ、この変数の上限を削除します。

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

992 994 

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


2877 2879 

2878サブエージェントからの結果を返します。出力は `status` フィールドで判別されます。完了したタスクの場合は `"completed"`、バックグラウンドタスクの場合は `"async_launched"`、Claude Code がクラウドセッションにディスパッチしたタスクの場合は `"remote_launched"`。`sessionUrl` はそのセッションにリンクし、`taskId` がそれを識別します。Claude Code が [サブエージェントの分離 worktree を保持した](/docs/ja/worktrees#isolate-subagents-with-worktrees) 場合、`completed` バリアントの `worktreePath` はそれを見つける場所であり、`worktreeBranch` は Claude Code が git で worktree を作成した場合のそのブランチです。2880サブエージェントからの結果を返します。出力は `status` フィールドで判別されます。完了したタスクの場合は `"completed"`、バックグラウンドタスクの場合は `"async_launched"`、Claude Code がクラウドセッションにディスパッチしたタスクの場合は `"remote_launched"`。`sessionUrl` はそのセッションにリンクし、`taskId` がそれを識別します。Claude Code が [サブエージェントの分離 worktree を保持した](/docs/ja/worktrees#isolate-subagents-with-worktrees) 場合、`completed` バリアントの `worktreePath` はそれを見つける場所であり、`worktreeBranch` は Claude Code が git で worktree を作成した場合のそのブランチです。

2879 2881 

2880`completed` バリアントでは、`resolvedModel` はサブエージェントが開始したモデルを名付けます。これは [`availableModels`](/docs/ja/model-config#restrict-model-selection) または別のオーバーライドが適用される場合、リクエストされた `model` 入力と異なる場合があります。このフィールドには Claude Code v2.1.174 以降が必要です。`async_launched` バリアントでは、`resolvedModel` はエージェントがバックグラウンドに移動したときに使用中のモデルを名付けるため、バックグラウンド化前に発生したスワップがそこに反映されます。両方のバリアントの `modelsUsed` フィールドは、使用されたモデルを順序で列挙し、連続する繰り返しは折りたたまれます。モデルが実行中にスワップされた場合にのみ設定されます。`modelsUsed` とバックグラウンド化時の `resolvedModel` 動作には Claude Code v2.1.212 以降が必要です。2882`completed` バリアントでは、`resolvedModel` はサブエージェントが開始したモデルを名付けます。これは [`availableModels`](/docs/ja/model-config#restrict-model-selection) または別の上書きが適用される場合、リクエストされた `model` 入力と異なる場合があります。このフィールドには Claude Code v2.1.174 以降が必要です。`async_launched` バリアントでは、`resolvedModel` はエージェントがバックグラウンドに移動したときに使用中のモデルを名付けるため、バックグラウンド化前に発生したスワップがそこに反映されます。両方のバリアントの `modelsUsed` フィールドは、使用されたモデルを順序で列挙し、連続する繰り返しは折りたたまれます。モデルが実行中にスワップされた場合にのみ設定されます。`modelsUsed` とバックグラウンド化時の `resolvedModel` 動作には Claude Code v2.1.212 以降が必要です。

2881 2883 

2882Claude Code は `usage` と `totalTokens` をサブエージェントの最終 API リクエストから入力します。実行全体からではありません。存在する場合、`usage` 内の `output_tokens_details` の下の `thinking_tokens` はそのリクエストの出力トークンのうち思考トークンであった数です。`output_tokens_details` キーには Python SDK v0.2.136 以降が必要です。これは Claude Code v2.1.228 をバンドルしています。`fallback_credit` キーには Python SDK v0.2.162 以降が必要です。これは Claude Code v2.1.285 をバンドルしています。2884Claude Code は `usage` と `totalTokens` をサブエージェントの最終 API リクエストから入力します。実行全体からではありません。存在する場合、`usage` 内の `output_tokens_details` の下の `thinking_tokens` はそのリクエストの出力トークンのうち思考トークンであった数です。`output_tokens_details` キーには Python SDK v0.2.136 以降が必要です。これは Claude Code v2.1.228 をバンドルしています。`fallback_credit` キーには Python SDK v0.2.162 以降が必要です。これは Claude Code v2.1.285 をバンドルしています。

2883 2885 


2908 }2910 }

2909 ],2911 ],

2910 "answers": dict[str, str] | None,2912 "answers": dict[str, str] | None,

2911 # パーミッションシステムによって入力されたユーザーの回答。マルチセレクト2913 # 権限システムによって入力されたユーザーの回答。マルチセレクト

2912 # 回答は選択されたラベルのカンマ区切り文字列です。入力時はラベルのリストが受け入れられ、その形式に強制されます2914 # 回答は選択されたラベルのカンマ区切り文字列です。入力時はラベルのリストが受け入れられ、その形式に強制されます

2913 "annotations": dict[str, dict] | None,2915 "annotations": dict[str, dict] | None,

2914 # 質問テキストでキーされたユーザーからの質問ごとのアノテーション。2916 # 質問テキストでキーされたユーザーからの質問ごとのアノテーション。


2979 2981 

2980バックグラウンドソースを実行し、各イベントを Claude に配信して、ポーリングなしで反応できるようにします。`command` はスクリプトを実行し、stdout 行ごとに 1 つのイベントを発行し、`ws` は WebSocket を開き、テキストフレームごとに 1 つのイベントを発行します。`command` または `ws` のいずれか 1 つを正確に指定してください。2982バックグラウンドソースを実行し、各イベントを Claude に配信して、ポーリングなしで反応できるようにします。`command` はスクリプトを実行し、stdout 行ごとに 1 つのイベントを発行し、`ws` は WebSocket を開き、テキストフレームごとに 1 つのイベントを発行します。`command` または `ws` のいずれか 1 つを正確に指定してください。

2981 2983 

2982Monitor がコマンドを実行する場合、Bash と同じパーミッション規則に従います。WebSocket ウォッチは別途承認を求めます。`ws` ソースには Claude Code v2.1.195 以降が必要です。動作とプロバイダーの可用性については、[Monitor ツールリファレンス](/docs/ja/tools-reference#monitor-tool) を参照してください。2984Monitor がコマンドを実行する場合、Bash と同じ権限ルールに従います。WebSocket ウォッチは別途承認を求めます。`ws` ソースには Claude Code v2.1.195 以降が必要です。動作とプロバイダーの可用性については、[Monitor ツールリファレンス](/docs/ja/tools-reference#monitor-tool) を参照してください。

2983 2985 

2984**入力:**2986**入力:**

2985 2987 


3326{3328{

3327 "url": str, # コンテンツを取得する URL3329 "url": str, # コンテンツを取得する URL

3328 "prompt": str, # 取得したコンテンツで実行するプロンプト3330 "prompt": str, # 取得したコンテンツで実行するプロンプト

3331 "offset": int | None, # ページの先頭からスキップする文字数。Python Agent SDK 0.2.164 以降が必要

3329}3332}

3330```3333```

3331 3334 


3547 3550 

3548Claude Code v2.1.277 で削除されました。以前は実行中または完了したバックグラウンドタスクから出力を取得し、`BashOutput` はエイリアスとして受け入れられていました。Claude はバックグラウンドタスクの出力ファイルを `Read` で読み込みます。3551Claude Code v2.1.277 で削除されました。以前は実行中または完了したバックグラウンドタスクから出力を取得し、`BashOutput` はエイリアスとして受け入れられていました。Claude はバックグラウンドタスクの出力ファイルを `Read` で読み込みます。

3549 3552 

3550`disallowed_tools` エントリまたはいずれかの名前をまだ名付けている拒否ルールは、警告なしに無視されます。3553`disallowed_tools` エントリまたはいずれかの名前をまだ指定している拒否ルールは、警告なしに無視されます。

3551 3554 

3552<h3 id="taskstop">3555<h3 id="taskstop">

3553 TaskStop3556 TaskStop

Details

323 サブエージェント呼び出しの検出323 サブエージェント呼び出しの検出

324</h2>324</h2>

325 325 

326Claude はエージェントツールを通じてサブエージェントを呼び出します。サブエージェントが呼び出されたときを検出するには、`name` が `"Agent"` である `tool_use` ブロックをチェックしてください。サブエージェントのコンテキスト内からのメッセージには、`parent_tool_use_id` フィールドが含まれます。326Claude はエージェントツールを通じてサブエージェントを呼び出します。サブエージェントが呼び出されたときを検出するには、`name` が `"Agent"` である `tool_use` ブロックをチェックしてください。

327 

328サブエージェントのコンテキスト内からのメッセージには、`parent_tool_use_id` フィールドが含まれます。TypeScript では、サブエージェントが生成する各アシスタントメッセージおよびユーザーメッセージに [`agent_id`](/docs/ja/agent-sdk/typescript#sdkassistantmessage) も含まれます。これは、そのサブエージェントの[タスクイベント](/docs/ja/agent-sdk/typescript#sdktaskstartedmessage)の `task_id` です。`agent_id` には TypeScript Agent SDK v0.3.292 以降が必要です。

327 329 

328<Note>330<Note>

329 このツールは `tool_use` ブロックでは `"Agent"` として表示されますが、`system:init` ツールリストでは `"Task"` として表示されます。Claude Code v2.1.63 より前では、`tool_use` ブロックもこれを `"Task"` と名付けていました。SDK バージョン間で検出が機能し続けるようにするには、`block.name` で両方の値に一致させてください。331 このツールは `tool_use` ブロックでは `"Agent"` として表示されますが、`system:init` ツールリストでは `"Task"` として表示されます。Claude Code v2.1.63 より前では、`tool_use` ブロックもこれを `"Task"` と名付けていました。SDK バージョン間で検出が機能し続けるようにするには、`block.name` で両方の値に一致させてください。


331 333 

332メッセージ構造は SDK 間で異なります。Python では、`message.content` を通じてコンテンツブロックに直接アクセスします。TypeScript では、`SDKAssistantMessage` が Claude API メッセージをラップするため、`message.message.content` を通じてコンテンツにアクセスします。334メッセージ構造は SDK 間で異なります。Python では、`message.content` を通じてコンテンツブロックに直接アクセスします。TypeScript では、`SDKAssistantMessage` が Claude API メッセージをラップするため、`message.message.content` を通じてコンテンツにアクセスします。

333 335 

334この例は、ストリーミングされたメッセージを反復処理し、サブエージェントが呼び出されたときと、その後のメッセージがそのサブエージェントの実行コンテキスト内から発信されたときをログに記録します。336この例は、ストリーミングされたメッセージを反復処理し、サブエージェントが呼び出されたときと、その後のメッセージがそのサブエージェントの実行コンテキスト内から発信されたときをログに記録します。TypeScript 版では、`agent_id` を持つ各サブエージェントメッセージについて、その `agent_id` もログに記録します。

335 337 

336<CodeGroup>338<CodeGroup>

337 ```python Python theme={null}339 ```python Python theme={null}


403 // Check if this message is from within a subagent's context405 // Check if this message is from within a subagent's context

404 if (msg.parent_tool_use_id) {406 if (msg.parent_tool_use_id) {

405 console.log(" (running inside subagent)");407 console.log(" (running inside subagent)");

408 // On assistant and user messages, agent_id matches the task_id

409 // on that subagent's task_started and other task events

410 if (msg.agent_id) {

411 console.log(` agent_id: ${msg.agent_id}`);

412 }

406 }413 }

407 414 

408 if ("result" in message) {415 if ("result" in message) {

Details

569| `includePartialMessages` | `boolean` | `false` | 部分メッセージイベントを含めます |569| `includePartialMessages` | `boolean` | `false` | 部分メッセージイベントを含めます |

570| `loadTimeoutMs` | `number` | `60000` | *アルファ版。* 再開時のマテリアライズ中に行われる各 `sessionStore.load()` および `sessionStore.listSubkeys()` 呼び出しのタイムアウト(ミリ秒)。アダプターがこの時間内に完了しない場合、クエリはハングせずに失敗します。`sessionStore` が設定されていない場合は無視されます |570| `loadTimeoutMs` | `number` | `60000` | *アルファ版。* 再開時のマテリアライズ中に行われる各 `sessionStore.load()` および `sessionStore.listSubkeys()` 呼び出しのタイムアウト(ミリ秒)。アダプターがこの時間内に完了しない場合、クエリはハングせずに失敗します。`sessionStore` が設定されていない場合は無視されます |

571| `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 エントリです |571| `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 エントリです |

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

573| `maxThinkingTokens` | `number` | `undefined` | *非推奨:* 代わりに `thinking` を使用してください。思考プロセスの最大トークン数 |573| `maxThinkingTokens` | `number` | `undefined` | *非推奨:* 代わりに `thinking` を使用してください。思考プロセスの最大トークン数 |

574| `maxTurns` | `number` | `undefined` | エージェントの最大ターン数(ツール使用のラウンドトリップ) |574| `maxTurns` | `number` | `undefined` | エージェントの最大ターン数(ツール使用のラウンドトリップ) |

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


631```631```

632 632 

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

634* `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` に引き上げられ、この変数の上限が撤廃されます。634* `CLAUDE_CODE_MAX_RETRIES`: API の最大再試行回数。デフォルトは `10` で、上限は `15` です。再試行ごとに独自の `API_TIMEOUT_MS` の時間枠が与えられます。

635 

636 より長い障害の間も待機し続ける必要がある無人実行では、[`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/ja/errors#tune-retry-behavior) を設定します。これにより一時的な容量エラーは無期限に再試行され、Claude Code v2.1.199 以降では、その他の一時的なエラーのデフォルトが `300` に引き上げられ、この変数の上限も撤廃されます。

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

636 638 

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


1561 parent_tool_use_id: string | null;1563 parent_tool_use_id: string | null;

1562 error?: SDKAssistantMessageError;1564 error?: SDKAssistantMessageError;

1563 aborted?: true;1565 aborted?: true;

1566 agent_id?: string;

1564 timestamp?: string;1567 timestamp?: string;

1565 context_usage?: SDKContextUsage;1568 context_usage?: SDKContextUsage;

1569 usage_report?: SDKUsageReport;

1566 user_message_uuid?: string;1570 user_message_uuid?: string;

1567 user_message_uuids?: string[];1571 user_message_uuids?: string[];

1568 resume_reason?: string;1572 resume_reason?: string;


1580 1584 

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

1582 1586 

1587`agent_id` はメッセージを生成したサブエージェントを識別し、メインスレッドのメッセージには存在しません。値は、そのサブエージェントの [`task_started`](#sdktaskstartedmessage) およびその他のタスクイベントの `task_id` と同じで、サブエージェントが[再開](/docs/ja/agent-sdk/subagents#resume-subagents)されても変わりません。このフィールドには Agent SDK v0.3.292 以降が必要です。

1588 

1589サブエージェントのメッセージをタスクイベントと対応付けるには、メッセージの `parent_tool_use_id` とタスクイベントの `tool_use_id` を組み合わせるのではなく、`agent_id` で照合してください。ツール呼び出しがサブエージェントを再開すると、タスクイベントにはその呼び出しの `tool_use_id` が含まれますが、メッセージはサブエージェントを最初に開始したツール呼び出しの `parent_tool_use_id` を保持するため、両者は一致しなくなります。

1590 

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

1584 1592 

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

1586 1594 

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

1588 1596 

1597`usage_report` は `/usage` レポートの構造化されたコピーで、型は [`SDKUsageReport`](#sdkusagereport) です。Agent SDK v0.3.273 以降が必要です。`/usage` をプロンプトとして送信すると、Claude Code は `message.content` にテキストを含むアシスタントメッセージとしてレポートを配信します。セッションが次の条件をすべて満たす場合にのみ、同じメッセージに `usage_report` を付加します。

1598 

1599* セッションが claude.ai の認証情報で認証している

1600* 認証情報が既知のプランタイプを示しているか、`user:profile` スコープを持っている

1601* アカウントが従量課金制ではない

1602 

1603`CLAUDE_CODE_OAUTH_TOKEN` として渡された `claude setup-token` トークンは `user:inference` スコープしか持たないため、デフォルトでは条件を満たしません。API キーセッションなどその他のセッションでは、フィールドなしでテキストが配信され、以前のバージョンでも同様です。フィールドが存在する場合はそこからレポートを読み取り、存在しない場合はテキストにフォールバックしてください。

1604 

1589<h3 id="sdkusermessage">1605<h3 id="sdkusermessage">

1590 `SDKUserMessage`1606 `SDKUserMessage`

1591</h3>1607</h3>


1597 type: "user";1613 type: "user";

1598 uuid?: UUID;1614 uuid?: UUID;

1599 session_id?: string;1615 session_id?: string;

1616 agent_id?: string;

1600 message: MessageParam; // From Anthropic SDK1617 message: MessageParam; // From Anthropic SDK

1601 pasted_content?: MessageParam["content"][];1618 pasted_content?: MessageParam["content"][];

1602 parent_tool_use_id: string | null;1619 parent_tool_use_id: string | null;


1636};1653};

1637```1654```

1638 1655 

1656サブエージェントが生成するユーザーメッセージ(自身のツール呼び出しの `tool_result` など)には `agent_id` が含まれます。このフィールドとそのバージョン要件を定義している [`SDKAssistantMessage`](#sdkassistantmessage) を参照してください。

1657 

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

1640 1659 

1641* `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 はレポートをサブエージェントからの別のメッセージとして受け取ります。1660* `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 はレポートをサブエージェントからの別のメッセージとして受け取ります。


1992 `SDKPartialAssistantMessage`2011 `SDKPartialAssistantMessage`

1993</h3>2012</h3>

1994 2013 

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

2015 

2016`parent_tool_use_id` フィールドは常に `null` です。ストリームイベントはメインセッションに対してのみ出力されます。サブエージェントへの帰属を判断するには、[`agent_id`](#sdkassistantmessage) と `parent_tool_use_id` を含む完全なメッセージを使用するか、[`forwardSubagentText`](#options) を有効にしてサブエージェントのテキストと思考を完全なメッセージとして受け取ってください。

1996 2017 

1997```typescript theme={null}2018```typescript theme={null}

1998type SDKPartialAssistantMessage = {2019type SDKPartialAssistantMessage = {


2229* `buffer`: コンテキスト圧縮用の予約領域2250* `buffer`: コンテキスト圧縮用の予約領域

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

2231 2252 

2253<h3 id="sdkusagereport">

2254 `SDKUsageReport`

2255</h3>

2256 

2257`/usage` レポートの構造化された形式で、`/usage` の結果を配信する [`SDKAssistantMessage`](#sdkassistantmessage) に `usage_report` として含まれます。Agent SDK v0.3.273 以降でこの型がエクスポートされます。この型は実験的なもので、形状が変更される可能性があります。

2258 

2259```typescript theme={null}

2260type SDKUsageReport = {

2261 session: {

2262 total_cost_usd: number;

2263 total_api_duration_ms: number;

2264 total_duration_ms: number;

2265 total_lines_added: number;

2266 total_lines_removed: number;

2267 model_usage: { [modelName: string]: ModelUsage };

2268 };

2269 rate_limits: {

2270 limits:

2271 | {

2272 kind: string;

2273 group: string;

2274 percent: number;

2275 resets_at: string | null;

2276 scope?: {

2277 model?: { display_name: string } | null;

2278 surface?: { display_name: string } | null;

2279 } | null;

2280 severity: string;

2281 is_active: boolean;

2282 }[]

2283 | null;

2284 extra_usage?: {

2285 is_enabled: boolean;

2286 monthly_limit: number | null;

2287 used_credits: number | null;

2288 utilization: number | null;

2289 currency?: string | null;

2290 } | null;

2291 } | null;

2292};

2293```

2294 

2295トップレベルのフィールドは `session` と `rate_limits` です。

2296 

2297* `session`:Claude Code の累積コストと使用量の合計で、[`SDKResultMessage`](#sdkresultmessage) の `total_cost_usd` および `modelUsage` と同じ台帳から読み取られます。各 `model_usage` エントリは [`ModelUsage`](#modelusage) です。

2298* `rate_limits`:`limits` にプランの使用量の行、`extra_usage` に使用クレジットの支出を含みます。セッションの OAuth トークンに `user:profile` スコープがない場合など、Claude Code がプランの使用量を取得できなかった場合は `null` です。

2299 

2300Claude Code は `session.total_cost_usd` をトークン数からローカルで計算するため、これは推定値であり、プランで請求される金額ではありません。サーバーが報告する使用クレジットの支出は、別の `extra_usage` ブロックです。精度に関する注意事項については[コストと使用量を追跡する](/docs/ja/agent-sdk/cost-tracking)を参照してください。

2301 

2302`limits` には、サーバーが送信したとおりの使用量の行が含まれます。どのメーターが適用されるか、そのスコープ、ラベル、重要度、順序はサーバーが決めるものなので、行はそのままレンダリングしてください。

2303 

2304* 空の配列は、サーバーがメーターを報告しなかったことを意味します。

2305* `null` は、Claude Code に報告する行がないことを意味します。

2306 

2307`limits` の各行は 1 つの使用量メーターを表します。

2308 

2309| フィールド | 型 | 説明 |

2310| - | - | - |

2311| `kind` | `string` | サーバーのメーターの種類で、`session`、`weekly_all`、`weekly_scoped` などです。行はラベルではなく、必ずこれで分類してください |

2312| `group` | `string` | サーバーの行グループで、`session` や `weekly` などです。行はこのグループごとに、サーバーの順序でレンダリングされます |

2313| `percent` | `number` | ウィンドウの使用割合(0-100) |

2314| `resets_at` | `string \| null` | ウィンドウがリセットされる ISO 8601 タイムスタンプ |

2315| `scope` | `object \| null` | 任意。スコープ付きの行が何を対象とするか(モデルまたはサーフェス)を、サーバーの表示ラベルとともに示します |

2316| `severity` | `string` | メーターの色分けのためのサーバーによる行の判定で、`normal`、`warning`、`critical` などです |

2317| `is_active` | `boolean` | 単一値のインジケーターに表示するためにサーバーが選んだ行では `true` |

2318 

2319Agent SDK v0.3.277 より前は、型で `severity` と `is_active` が任意かつ null 許容として宣言されており、行にそれらが含まれない場合がありました。

2320 

2321`extra_usage` は、サーバーが報告する請求期間の[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)の支出と上限で、プランに使用クレジットがある場合に存在します。金額は `currency` の補助単位で、USD の場合はセントです。

2322 

2323* `monthly_limit` は、このアカウント自体に支出上限がない場合は `null` です。Team プランと Enterprise プランでは、`null` を無制限としてレンダリングしないでください。

2324* `is_enabled` は、使用クレジットでリクエストの支払いができない間は `false` です。

2325 

2232<h3 id="sdkmessageorigin">2326<h3 id="sdkmessageorigin">

2233 `SDKMessageOrigin`2327 `SDKMessageOrigin`

2234</h3>2328</h3>


3416type WebFetchInput = {3510type WebFetchInput = {

3417 url: string;3511 url: string;

3418 prompt: string;3512 prompt: string;

3513 offset?: number;

3419};3514};

3420```3515```

3421 3516 

3422URL からコンテンツを取得し、AI モデルで処理します。3517URL からコンテンツを取得し、AI モデルで処理します。

3423 3518 

3519`offset` はページの先頭からスキップする文字数です。Claude は長いページを読み進めるためにこれを設定します。このフィールドには Agent SDK v0.3.290 以降が必要です。

3520 

3424<h3 id="websearch">3521<h3 id="websearch">

3425 WebSearch3522 WebSearch

3426</h3>3523</h3>


5603 task_id: string;5700 task_id: string;

5604 tool_use_id?: string;5701 tool_use_id?: string;

5605 status: "completed" | "failed" | "stopped";5702 status: "completed" | "failed" | "stopped";

5703 reason?: "worker_restart";

5606 output_file: string;5704 output_file: string;

5607 summary: string;5705 summary: string;

5608 ambient?: boolean;5706 ambient?: boolean;


5617};5715};

5618```5716```

5619 5717 

5718`reason` は、タスクがそれ自体の完了、失敗、または停止以外の原因で終了したときに設定され、Agent SDK v0.3.273 以降が必要です。Claude Code は claude.ai を介して接続するセッション、つまりセルフホストランナー上のものを含むクラウドセッションと Remote Control セッションでのみこれを設定します。ローカルの `query()` 呼び出しでは設定されません。唯一の値である `worker_restart` は、タスクを実行していた Claude Code プロセスが再起動したことを意味します。通知のステータスは `"stopped"` になるため、タスクは完了でも失敗でもないものとして扱ってください。

5719 

5620Claude Code が [長い MCP ツール呼び出しをバックグラウンドに移動](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) する場合、その呼び出しの `tool_result` ブロックはプレースホルダーのみを保持し、呼び出しの実際の結果はこの通知で到着します。`tool_use_id` で通知を呼び出しと照合してください。`completed` 通知では、`resource_links` はツールが参照によって返したファイルを [`SDKMcpResourceLink`](#sdkmcpresourcelink) エントリとしてリストし、[`tool_use_result.resourceLinks`](#sdkusermessage) と同じ 50 リンクおよび 64 KiB の制限があります。Claude Code は、結果にリンクがない場合と、MCP ツール呼び出しではないタスクの通知では `resource_links` を省略します。`resource_links` には Agent SDK v0.3.257 以降が必要です。5720Claude Code が [長い MCP ツール呼び出しをバックグラウンドに移動](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) する場合、その呼び出しの `tool_result` ブロックはプレースホルダーのみを保持し、呼び出しの実際の結果はこの通知で到着します。`tool_use_id` で通知を呼び出しと照合してください。`completed` 通知では、`resource_links` はツールが参照によって返したファイルを [`SDKMcpResourceLink`](#sdkmcpresourcelink) エントリとしてリストし、[`tool_use_result.resourceLinks`](#sdkusermessage) と同じ 50 リンクおよび 64 KiB の制限があります。Claude Code は、結果にリンクがない場合と、MCP ツール呼び出しではないタスクの通知では `resource_links` を省略します。`resource_links` には Agent SDK v0.3.257 以降が必要です。

5621 5721 

5622Claude Code は、モデルに送信するすべてのタスク通知に告知を前置します。ただし、[`scheduled-trigger` サブカインド](#task-notification-subkinds) でスタンプされた配信は除きます。これらは代わりに割り当てられたタスクとしてのフレーミングを持ちます。告知は人間の入力が発生していないことを述べるため、モデルは通知をユーザーの指示や承認として扱いません。5722Claude Code は、モデルに送信するすべてのタスク通知に告知を前置します。ただし、[`scheduled-trigger` サブカインド](#task-notification-subkinds) でスタンプされた配信は除きます。これらは代わりに割り当てられたタスクとしてのフレーミングを持ちます。告知は人間の入力が発生していないことを述べるため、モデルは通知をユーザーの指示や承認として扱いません。


5775 task_type?: string;5875 task_type?: string;

5776 is_backgrounded?: boolean;5876 is_backgrounded?: boolean;

5777 spawn_depth?: number;5877 spawn_depth?: number;

5878 parent_task_id?: string;

5778 ambient?: boolean;5879 ambient?: boolean;

5779 uuid: UUID;5880 uuid: UUID;

5780 session_id: string;5881 session_id: string;


5792 5893 

5793[再開されたサブエージェント](/docs/ja/agent-sdk/subagents#resume-subagents) は常に `is_backgrounded: true` を報告します。Claude Code はすべての再開されたサブエージェントをバックグラウンドで実行するためです。フォアグラウンドタスクが後でバックグラウンドに移動する場合、Claude Code は 2 番目の `task_started` を送信するのではなく、新しい `is_backgrounded` 値を [`task_updated`](#sdktaskupdatedmessage) メッセージで報告します。5894[再開されたサブエージェント](/docs/ja/agent-sdk/subagents#resume-subagents) は常に `is_backgrounded: true` を報告します。Claude Code はすべての再開されたサブエージェントをバックグラウンドで実行するためです。フォアグラウンドタスクが後でバックグラウンドに移動する場合、Claude Code は 2 番目の `task_started` を送信するのではなく、新しい `is_backgrounded` 値を [`task_updated`](#sdktaskupdatedmessage) メッセージで報告します。

5794 5895 

5896`parent_task_id` は、このタスクを起動したサブエージェントの `task_id` を保持します。これを使用して、各タスクをそれを開始したサブエージェントの下にグループ化してください。Claude Code はサブエージェント、Bash、[Monitor](#monitor) タスクでこれを設定します。フィールドには Agent SDK v0.3.292 以降が必要です。以下の場合は存在しません。

5897 

5898* メインスレッドがタスクを起動した場合

5899* Claude Code が親タスクを追跡しなくなった場合

5900* [チームメイト](/docs/ja/agent-teams) またはワークフロー内のエージェントがタスクを起動した場合

5901 

5902親はフォアグラウンドタスクの場合や、すでに終了したタスクの場合もあるため、認識しない ID は親なしとして扱ってください。

5903 

5795<h3 id="sdktaskprogressmessage">5904<h3 id="sdktaskprogressmessage">

5796 `SDKTaskProgressMessage`5905 `SDKTaskProgressMessage`

5797</h3>5906</h3>


5848 `SDKBackgroundTasksChangedMessage`5957 `SDKBackgroundTasksChangedMessage`

5849</h3>5958</h3>

5850 5959 

5851ライブバックグラウンドタスクのセットが変わるたびに発行されます。タスクの開始、完了、キル、フォアグラウンドエージェントのバックグラウンド化、またはタスクの `description` または `ambient` フィールドの変更などです。5960ライブバックグラウンドタスクのセットが変わるたびに発行されます。タスクの開始、完了、キル、フォアグラウンドエージェントのバックグラウンド化、またはタスクの `description`、`ambient`、`parent_task_id` フィールドの変更などです。各エントリの `parent_task_id` フィールドについては、それとそのバージョン要件を定義している [`SDKTaskStartedMessage`](#sdktaskstartedmessage) を参照してください。

5852 5961 

5853`tasks` 配列はライブセット全体です。`task_started` および `task_notification` イベントをペアリングするのではなく、各ペイロードでキャッシュされたセットを置き換えてください。そうすれば、次のメンバーシップ変更で逃したイベントが修正されます。5962`tasks` 配列はライブセット全体です。`task_started` および `task_notification` イベントをペアリングするのではなく、各ペイロードでキャッシュされたセットを置き換えてください。そうすれば、次のメンバーシップ変更で逃したイベントが修正されます。

5854 5963 

5855これらのタスクごとのイベントに対する順序付けは指定されていないため、2 つのストリームを相関させないでください。5964タスクが終了すると、その [`task_updated`](#sdktaskupdatedmessage) と [`task_notification`](#sdktasknotificationmessage) は、それをリストから削除する `background_tasks_changed` より前に到着します。それ以外の場合、タスクごとのイベントに対する順序付けは指定されていません。

5856 5965 

5857起動時には何も発行されません。セッションの CLI プロセスが開始または再開されるたびに空のセットにリセットし、次のメンバーシップ変更でそれを再入力させてください。5966起動時には何も発行されません。セッションの CLI プロセスが開始または再開されるたびに空のセットにリセットし、次のメンバーシップ変更でそれを再入力させてください。

5858 5967 


5869 task_type: string;5978 task_type: string;

5870 subagent_type?: string;5979 subagent_type?: string;

5871 description: string;5980 description: string;

5981 parent_task_id?: string;

5872 ambient?: boolean;5982 ambient?: boolean;

5873 }[];5983 }[];

5874 uuid: UUID;5984 uuid: UUID;

Details

36 ```36 ```

37 37 

38 ```typescript TypeScript theme={null}38 ```typescript TypeScript theme={null}

39 async function handleToolRequest(toolName, input, options) {39 import type { CanUseTool } from "@anthropic-ai/claude-agent-sdk";

40 

41 const handleToolRequest: CanUseTool = async (toolName, input, options) => {

40 // options には { signal: AbortSignal, suggestions?: PermissionUpdate[] } が含まれます42 // options には { signal: AbortSignal, suggestions?: PermissionUpdate[] } が含まれます

41 // ユーザーにプロンプトを表示して、許可または拒否を返す43 // ここでユーザーにプロンプトを表示してから、許可または拒否を返す

42 }44 return { behavior: "deny", message: "User declined" };

45 };

43 46 

44 const options = { canUseTool: handleToolRequest };47 const options = { canUseTool: handleToolRequest };

45 ```48 ```


440 // ツールリストに AskUserQuestion を含める443 // ツールリストに AskUserQuestion を含める

441 tools: ["Read", "Glob", "Grep", "AskUserQuestion"],444 tools: ["Read", "Glob", "Grep", "AskUserQuestion"],

442 canUseTool: async (toolName, input) => {445 canUseTool: async (toolName, input) => {

443 // ここで確認質問を処理する446 // すべての呼び出しを許可するプレースホルダー。「AskUserQuestion を検出する」ステップでこれを置き換えます。

447 return { behavior: "allow", updatedInput: input };

444 }448 }

445 }449 }

446 })) {450 })) {


763 767 

764 ```typescript TypeScript theme={null}768 ```typescript TypeScript theme={null}

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

770 import type { PermissionResult } from "@anthropic-ai/claude-agent-sdk";

766 import * as readline from "readline/promises";771 import * as readline from "readline/promises";

767 772 

768 // ターミナルでユーザー入力を求めるヘルパー773 // ターミナルでユーザー入力を求めるヘルパー


783 }788 }

784 789 

785 // Claude の質問を表示してユーザーの回答を収集する790 // Claude の質問を表示してユーザーの回答を収集する

786 async function handleAskUserQuestion(input: any) {791 async function handleAskUserQuestion(input: any): Promise<PermissionResult> {

787 const answers: Record<string, string> = {};792 const answers: Record<string, string> = {};

788 793 

789 for (const q of input.questions) {794 for (const q of input.questions) {


803 answers[q.question] = parseResponse(response, options);808 answers[q.question] = parseResponse(response, options);

804 }809 }

805 810 

806 // Claude に回答を返す(ツール処理に元の質問を含める必須)811 // Claude に回答を返す(元の質問を含める必要があります)

807 return {812 return {

808 behavior: "allow",813 behavior: "allow",

809 updatedInput: { questions: input.questions, answers }814 updatedInput: { questions: input.questions, answers }

agent-view.md +21 −12

Details

391 391 

392エージェントビューから新しいバックグラウンドセッションをディスパッチしたり、既存のインタラクティブセッションをバックグラウンドに送信またはコピーしたり、シェルから直接開始したりできます。392エージェントビューから新しいバックグラウンドセッションをディスパッチしたり、既存のインタラクティブセッションをバックグラウンドに送信またはコピーしたり、シェルから直接開始したりできます。

393 393 

394<h3 id="from-agent-view">394<span id="from-agent-view" />

395 エージェントビューから395 

396<h3 id="dispatch-an-agent-from-agent-view">

397 エージェントビューからエージェントをディスパッチする

396</h3>398</h3>

397 399 

398エージェントビューの下部の入力にプロンプトを入力して `Enter` キーを押すと、新しいバックグラウンドセッションが開始されます。セッションはプロンプトから自動的に名前が付けられます。後で `Ctrl+R` で名前を変更できます。400エージェントビューの下部の入力にプロンプトを入力して `Enter` キーを押すと、新しいバックグラウンドセッションが開始されます。セッションはプロンプトから自動的に名前が付けられます。後で `Ctrl+R` で名前を変更できます。


446 448 

447エージェントビューがディレクトリでグループ化されている場合、ディスパッチは選択した行のディレクトリにプロンプトを送信するため、パスを再入力することなくグループを選択してそこにディスパッチできます。449エージェントビューがディレクトリでグループ化されている場合、ディスパッチは選択した行のディレクトリにプロンプトを送信するため、パスを再入力することなくグループを選択してそこにディスパッチできます。

448 450 

449<h3 id="from-inside-a-session">451<span id="from-inside-a-session" />

450 セッション内から452 

453<h3 id="send-or-copy-a-session-to-the-background">

454 セッションをバックグラウンドに送信またはコピーする

451</h3>455</h3>

452 456 

4532 つのコマンドで、作業中のセッションからバックグラウンドに作業を移動できます。`/background` は現在の会話をバックグラウンドに送信してターミナルを解放し、`/fork` はコピーを送信して、元の場所で作業を続けられるようにします。4572 つのコマンドで、作業中のセッションからバックグラウンドに作業を移動できます。`/background` は現在の会話をバックグラウンドに送信してターミナルを解放し、`/fork` はコピーを送信して、元の場所で作業を続けられるようにします。


511 515 

512セッション中に [`/add-dir`](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) で追加したディレクトリも引き継がれます。`--allow-dangerously-skip-permissions` を引き継ぐと、バックグラウンド化されたセッションでも `bypassPermissions` に切り替えられる状態が維持されますが、新たに何かを付与するわけではありません。このモードには引き続き、[権限モード、モデル、effort](#permission-mode-model-and-effort) で説明されている 1 回限りのインタラクティブな同意が必要です。516セッション中に [`/add-dir`](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) で追加したディレクトリも引き継がれます。`--allow-dangerously-skip-permissions` を引き継ぐと、バックグラウンド化されたセッションでも `bypassPermissions` に切り替えられる状態が維持されますが、新たに何かを付与するわけではありません。このモードには引き続き、[権限モード、モデル、effort](#permission-mode-model-and-effort) で説明されている 1 回限りのインタラクティブな同意が必要です。

513 517 

514<h3 id="from-your-shell">518<span id="from-your-shell" />

515 シェルから519 

520<h3 id="dispatch-an-agent-from-your-shell">

521 シェルからエージェントをディスパッチする

516</h3>522</h3>

517 523 

518`--bg` またはその長い形式 `--background` を渡すと、直接バックグラウンドで動作するセッションを開始します。524`--bg` またはその長い形式 `--background` を渡すと、直接バックグラウンドで動作するセッションを開始します。


603 609 

604git リポジトリの外では、セッションは作業ディレクトリに直接書き込み、互いに分離されないため、同じファイルを編集する並列セッションのディスパッチは避けてください。別のバージョン管理システムを使用している場合は、[`WorktreeCreate` フック](/docs/ja/worktrees#non-git-version-control) を設定すると、Claude は git の場合と同じ方法で編集を分離します。610git リポジトリの外では、セッションは作業ディレクトリに直接書き込み、互いに分離されないため、同じファイルを編集する並列セッションのディスパッチは避けてください。別のバージョン管理システムを使用している場合は、[`WorktreeCreate` フック](/docs/ja/worktrees#non-git-version-control) を設定すると、Claude は git の場合と同じ方法で編集を分離します。

605 611 

606git リポジトリではないディレクトリでフックが失敗した場合、Claude はそのディレクトリの分離をスキップし、作業ディレクトリをその場で編集します。git リポジトリ内では、編集前に Claude が worktree に移動させるセッションは、その移動が行われるまで共有チェックアウト内のファイルを編集できません。612git リポジトリではないディレクトリでフックが失敗した場合、Claude はそのディレクトリの分離をスキップし、作業ディレクトリをその場で編集します。git リポジトリ内では、編集前に Claude が worktree に移動させるセッションは、その移動が行われるまで共有チェックアウトに対して `Edit`、`Write`、`NotebookEdit` ツールを使用できません。

607 613 

608セッションの worktree のパスを確認するには、アタッチしてその作業ディレクトリを確認します。614セッションの worktree のパスを確認するには、アタッチしてその作業ディレクトリを確認します。

609 615 


825| `claude daemon logs` | supervisor のログファイル [`~/.claude/daemon.log`](#where-state-is-stored) を追跡し、`Ctrl+C` を押すまで新しい行を到着次第出力する |831| `claude daemon logs` | supervisor のログファイル [`~/.claude/daemon.log`](#where-state-is-stored) を追跡し、`Ctrl+C` を押すまで新しい行を到着次第出力する |

826| `claude daemon stop --any` | supervisor プロセスとそれがホストするバックグラウンドセッションを停止します。`--keep-workers` を渡して、バックグラウンドセッションを実行したままにして、次の supervisor が再接続できるようにします。次の `claude agents` または `claude --bg` は新しい supervisor を開始します |832| `claude daemon stop --any` | supervisor プロセスとそれがホストするバックグラウンドセッションを停止します。`--keep-workers` を渡して、バックグラウンドセッションを実行したままにして、次の supervisor が再接続できるようにします。次の `claude agents` または `claude --bg` は新しい supervisor を開始します |

827 833 

828`claude attach` と `claude logs` は、`claude logs "auth refactor"` のように、ID の代わりに実行中のセッション名の一部を受け取ることができます。名前を渡すには Claude Code v2.1.290 以降が必要です。834`claude attach` と `claude logs` は、`claude logs "auth refactor"` のように、ID の代わりにセッション名の一部を受け取ることができます。名前を渡すには Claude Code v2.1.290 以降が必要です。

829 835 

830<h3 id="list-sessions-as-json">836<h3 id="list-sessions-as-json">

831 セッションを JSON として一覧表示837 セッションを JSON として一覧表示


979 セッションを開くと、保存されたトランスクリプトがないと表示される985 セッションを開くと、保存されたトランスクリプトがないと表示される

980</h3>986</h3>

981 987 

982[別の会話からバックグラウンド化された](#from-inside-a-session)停止したセッションが最初の応答が完了する前に停止した場合、再開するものはありません。最初の応答が完了するまで、会話はバックグラウンド化された会話にのみ存在します。`claude attach` は `This session has no saved transcript` で開くことを拒否します。988[別の会話からバックグラウンド化した](#from-inside-a-session)セッションのうち、独自のターンを実行する前に停止したセッションを開くと、Claude Code はその会話を再開します。Claude Code がその会話を見つけられない場合、セッションを開くことを拒否します:

989 

990* `claude attach` は `This session has no saved transcript` を出力します。

991* エージェントビューでは、リストの下に `Press enter again to restart this session fresh` が表示されます。

983 992 

984エージェントビューでは、その行を開くとリストの下に `Press enter again to restart this session fresh` が表示されます。同じ行で再度 `Enter` を押して、空の会話でセッションを再開するか、シェルから `claude respawn <id>` を実行します。993同じ行で再度 `Enter` を押して空の会話でセッションを再開するか、シェルから `claude respawn <id>` を実行します。

985 994 

986元の会話は無傷です。`claude --resume` で再開するか、それで作業を続けます。詳細については、[エラーリファレンス](/docs/ja/errors#this-session-has-no-saved-transcript)を参照してください。995詳細については、[エラーリファレンス](/docs/ja/errors#this-session-has-no-saved-transcript)を参照してください。

987 996 

988<h3 id="the-terminal-host-died-or-the-session-stopped-responding">997<h3 id="the-terminal-host-died-or-the-session-stopped-responding">

989 ターミナルホストが停止したか、セッションが応答しなくなった998 ターミナルホストが停止したか、セッションが応答しなくなった


1095 1104 

1096| バージョン | 変更 |1105| バージョン | 変更 |

1097| - | - |1106| - | - |

1098| v2.1.290 | [`claude attach` と `claude logs`](#manage-sessions-from-the-shell) は、ID の代わりに実行中のセッションの名前の一部を受け付けます。 |1107| v2.1.290 | [`claude attach` と `claude logs`](#manage-sessions-from-the-shell) は、ID の代わりにセッションの名前の一部を受け付けます。 |

1099| v2.1.290 | `/model`、`/effort`、`/rename`、`/usage` を作業中のセッションへの[ピーク返信](#peek-and-reply)として送信すると、すぐに実行されます。 |1108| v2.1.290 | `/model`、`/effort`、`/rename`、`/usage` を作業中のセッションへの[ピーク返信](#peek-and-reply)として送信すると、すぐに実行されます。 |

1100| v2.1.290 | 配信できない[ピーク返信](#peek-and-reply)は、`/` で始まる場合、またはセッションのプロセスの実行中に事前定義された選択肢のある質問に回答する場合、次回の再起動に向けて保存されなくなりました。 |1109| v2.1.290 | 配信できない[ピーク返信](#peek-and-reply)は、`/` で始まる場合、またはセッションのプロセスの実行中に事前定義された選択肢のある質問に回答する場合、次回の再起動に向けて保存されなくなりました。 |

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

chrome.md +39 −2

Details

202and attach logs/session.log to it202and attach logs/session.log to it

203```203```

204 204 

205アップロードには次の 3 つの制限が適用されます。205Claude がファイルの添付を拒否した場合やアップロードが失敗した場合は、次の原因を確認してください。

206 206 

207* **権限**: Claude がファイルをアップロードできるのは、セッションがそのファイルの読み取りを許可されている場合のみです。そのため、ファイルへの `Read` アクセスを拒否する[権限ルール](/docs/ja/settings-reference#permission-settings)は、そのファイルのアップロードもブロックします。207* **権限**: Claude がファイルをアップロードできるのは、セッションがそのファイルの読み取りを許可されている場合のみです。そのため、ファイルへの `Read` アクセスを拒否する[権限ルール](/docs/ja/settings-reference#permission-settings)は、そのファイルのアップロードもブロックします。

208* **サイズ**: 1 回のアップロードに含められるファイルは合計 10 MB までです。208* **サイズ**: 1 回のアップロードに含められるファイルは合計 10 MB までです。

209* **ハードリンク**: Claude は複数のハードリンクを持つファイルを拒否します。これは `node_modules` などのパッケージマネージャーのストア内でよく見られます。ファイルをコピーし、そのコピーをアップロードしてください。209* **ハードリンク**: Claude は複数のハードリンクを持つファイルを拒否します。これは `node_modules` などのパッケージマネージャーのストア内でよく見られます。ファイルをコピーし、そのコピーをアップロードしてください。

210* **認証情報に関する名前**: Claude は、`.env`、`.pem` ファイルや `.key` ファイル、`.ssh` 配下のものなど、認証情報が保管される名前やフォルダーを持つファイルを拒否します。Claude Code v2.1.293 以降が必要です。

210 211 

211<h3 id="draft-content-in-google-docs">212<h3 id="draft-content-in-google-docs">

212 Google Docs でコンテンツをドラフトする213 Google Docs でコンテンツをドラフトする


309 310 

310その他の Chromium ベースのブラウザは、ブラウザ名にちなんだ独自の設定ディレクトリから同じファイルを読み取ります。例えば、macOS 上の Brave は `~/Library/Application Support/BraveSoftware/Brave-Browser/NativeMessagingHosts/` を使用し、Windows では各ブラウザが `HKCU\Software\BraveSoftware\Brave-Browser\NativeMessagingHosts\` のような独自のレジストリキーを持ちます。311その他の Chromium ベースのブラウザは、ブラウザ名にちなんだ独自の設定ディレクトリから同じファイルを読み取ります。例えば、macOS 上の Brave は `~/Library/Application Support/BraveSoftware/Brave-Browser/NativeMessagingHosts/` を使用し、Windows では各ブラウザが `HKCU\Software\BraveSoftware\Brave-Browser\NativeMessagingHosts\` のような独自のレジストリキーを持ちます。

311 312 

313<h3 id="project-settings-can’t-turn-on-chrome">

314 プロジェクト設定では Chrome をオンにできない

315</h3>

316 

317ターミナルに表示されるこの警告は、作業中のプロジェクトが Chrome 統合をオンにしようとし、Claude Code がそれを許可しなかったことを意味します。

318 

319```text wrap theme={null}

320Claude Code ignored CLAUDE_CODE_ENABLE_CFC in this project's settings: a project can't turn on Claude in Chrome. To turn it on yourself, run /chrome or start with --chrome.

321```

322 

323プロジェクトの `.claude/settings.json` または `.claude/settings.local.json` が、Chrome 統合をオンにするために `env` ブロックで [`CLAUDE_CODE_ENABLE_CFC`](/docs/ja/env-vars#variables) を `1` に設定しています。Claude Code はその設定を適用しなかったため、このセッションでは Chrome 統合がオフになっており、Claude はブラウザツールを使用できません。

324 

325Claude Code がこの設定をスキップするのは、これらのファイルがプロジェクトディレクトリに保存されており、チェックアウトしたリポジトリが Claude をブラウザに接続できてはならないためです。

326 

327そのまま作業を続けることができます。ブラウザツールを使用したい場合や警告を消したい場合は、次のいずれかを行います。

328 

329* **今すぐブラウザツールを使用するには**:終了し、シェルで `claude --chrome` を使用して再度起動します。

330* **以降のセッションでブラウザツールを使用するには**:Claude Code のプロンプトで `/chrome` を実行し、[**Enabled by default**](#enable-chrome-by-default) を選択します。これはその後に開始するセッションに適用され、実行中のセッションには適用されません。

331* **ブラウザツールなしで警告を止めるには**:プロジェクトの設定ファイルから `CLAUDE_CODE_ENABLE_CFC` の行を削除します。

332 

312<h3 id="browser-not-responding">333<h3 id="browser-not-responding">

313 ブラウザが応答しない334 ブラウザが応答しない

314</h3>335</h3>


325 346 

326Chrome 拡張機能のサービスワーカーは長時間のセッション中にアイドル状態になる可能性があり、接続が切れます。非アクティブ期間後にブラウザツールが機能しなくなった場合、`/chrome` を実行して「Reconnect extension」を選択します。347Chrome 拡張機能のサービスワーカーは長時間のセッション中にアイドル状態になる可能性があり、接続が切れます。非アクティブ期間後にブラウザツールが機能しなくなった場合、`/chrome` を実行して「Reconnect extension」を選択します。

327 348 

349`/chrome` を実行したら、その `Status` 行を確認します。「Not connected」と表示されている場合、実行中のセッション自体の Chrome への接続が失敗しています。「Reconnect extension」を選択してその接続を再開します。接続が成功すると、Chrome で拡張機能の再接続ページが開きます。v2.1.290 より前では、「Reconnect extension」はそのページを開くだけで、失敗した接続を再開しなかったため、以前のバージョンでブラウザツールが復帰しない場合は Claude Code を更新してください。

350 

351<h3 id="extension-signed-in-to-a-different-organization">

352 拡張機能が別の組織にサインインしている

353</h3>

354 

355複数の claude.ai 組織に所属している場合、拡張機能は Claude Code と同じ組織にサインインしている必要があります。両者が異なる場合、両方が同じ claude.ai アカウントを使用していても、Claude のブラウザツールは「Browser extension is not connected」を返します。

356 

357Claude Code がどの組織にサインインしているかを確認するには、Claude Code のプロンプトで [`/status`](/docs/ja/commands) を実行し、`Organization` 行を確認します。

358 

359<Warning>

360 拡張機能からログアウトすると、拡張機能に保存されているショートカットとスケジュールタスクが失われます。まず[一般的なエラーメッセージ](#common-error-messages)にある他の解決策を試してください。

361</Warning>

362 

363拡張機能の組織を変更するには、拡張機能の設定でログアウトしてから再度ログインし、`/status` に表示される組織を選択します。

364 

328<h3 id="windows-specific-issues">365<h3 id="windows-specific-issues">

329 Windows 固有の問題366 Windows 固有の問題

330</h3>367</h3>


343 380 

344| エラー | 原因 | 修正 |381| エラー | 原因 | 修正 |

345| - | - | - |382| - | - | - |

346| "Browser extension is not connected" | ネイティブメッセージングホストが拡張機能に到達できない、または組織の IP 許可リストが `bridge.claudeusercontent.com` への接続を拒否している | 拡張機能が Claude Code と同じ claude.ai アカウントにサインインしていることを確認し、Chrome と Claude Code を再起動してから、`/chrome` を実行して再接続します。組織が IP 許可リストを使用しており、エラーが解決しない場合は、[組織の IP 許可リストとプロキシのエグレス](/docs/ja/network-config#organization-ip-allowlists-and-proxy-egress)を参照してください |383| "Browser extension is not connected" | 拡張機能が Chrome にインストールされていないか実行されていない、拡張機能が Claude Code とは異なる claude.ai アカウントまたは組織にサインインしている、または組織の IP 許可リストが `bridge.claudeusercontent.com` への接続を拒否している | 拡張機能が Claude Code と同じ claude.ai アカウントおよび[組織](#extension-signed-in-to-a-different-organization)にサインインしていることを確認し、Chrome と Claude Code を再起動してから、`/chrome` を実行して再接続します。組織が IP 許可リストを使用しており、エラーが解決しない場合は、[組織の IP 許可リストとプロキシのエグレス](/docs/ja/network-config#organization-ip-allowlists-and-proxy-egress)を参照してください |

347| `/chrome` で拡張機能に「Not detected」と表示される | Chrome 拡張機能がインストールされていないか、無効になっている | `chrome://extensions` で拡張機能をインストールまたは有効にします |384| `/chrome` で拡張機能に「Not detected」と表示される | Chrome 拡張機能がインストールされていないか、無効になっている | `chrome://extensions` で拡張機能をインストールまたは有効にします |

348| "No tab available" | Claude がタブの準備ができる前に動作しようとした | Claude に新しいタブを作成して再度試すよう依頼します |385| "No tab available" | Claude がタブの準備ができる前に動作しようとした | Claude に新しいタブを作成して再度試すよう依頼します |

349| "Receiving end does not exist" | 拡張機能サービスワーカーがアイドル状態になった | `/chrome` を実行して「Reconnect extension」を選択します |386| "Receiving end does not exist" | 拡張機能サービスワーカーがアイドル状態になった | `/chrome` を実行して「Reconnect extension」を選択します |

Details

1235 1235 

1236CLI はメトリクス、ログ、および有効な場合はトレースをゲートウェイに送信し、ゲートウェイはそれらをそのまま各設定済みの宛先にリレーします。エクスポートは HTTP 上の OpenTelemetry Protocol(OTLP)を使用します。リレーをスキップしてセッションからコレクターに直接エクスポートするには、[ポリシーでコレクターを指定](#export-directly-to-your-collector) します。CLI が出力するメトリクスとイベントについては [使用状況の監視](/docs/ja/monitoring-usage) を参照してください。1236CLI はメトリクス、ログ、および有効な場合はトレースをゲートウェイに送信し、ゲートウェイはそれらをそのまま各設定済みの宛先にリレーします。エクスポートは HTTP 上の OpenTelemetry Protocol(OTLP)を使用します。リレーをスキップしてセッションからコレクターに直接エクスポートするには、[ポリシーでコレクターを指定](#export-directly-to-your-collector) します。CLI が出力するメトリクスとイベントについては [使用状況の監視](/docs/ja/monitoring-usage) を参照してください。

1237 1237 

1238`/login` でサインインしたセッションでは、CLI はゲートウェイが発行した JWT から読み取った認証済みユーザーのアイデンティティ(`user.id`、`user.email`、`user.groups` 属性)を各エクスポートに付与します。そのため、デベロッパー側の設定なしで、デベロッパーごとのコストと使用状況の帰属が機能します。1238`/login` でサインインしたセッションでは、CLI は各エクスポートに、ゲートウェイが発行した JWT から読み取った認証済みユーザーの ID、つまり `user.id`、`user.email`、`user.groups` 属性を付与します。そのため、開発者側の設定なしで、開発者ごとのコストと使用量の帰属が機能します。開発者がサインインする前に Claude Code がログに記録したイベントには、[この ID は含まれません](/docs/ja/monitoring-usage#standard-attributes)。開発者のグループが変更されたときにどの属性がそれに追従するかについては、[セッション中のグループの変更](#group-changes-during-an-open-session) を参照してください。

1239 1239 

1240ゲートウェイでサインインした [Claude Desktop](#claude-desktop-overlay) と Cowork のセッションは、テレメトリに `enduser.id` とともに `user.email` と `user.groups` を付与するため、`user.email` または `user.groups` に対する 1 つのクエリでターミナル、Desktop、Cowork の使用状況をカバーできます。`user.groups` はコンマ区切りの IdP グループリストです。1240ゲートウェイでサインインした [Claude Desktop](#claude-desktop-overlay) と Cowork のセッションは、テレメトリに `enduser.id` とともに `user.email` と `user.groups` を付与するため、`user.email` または `user.groups` に対する 1 つのクエリでターミナル、Desktop、Cowork の使用状況をカバーできます。`user.groups` はコンマ区切りの IdP グループリストです。

1241 1241 


1345 1345 

1346Claude Code は各ラベルをすべてのメトリクスデータポイントにもコピーするため、リソース属性をインデックス化しないバックエンドでもラベルでメトリクスをフィルタリングできます。このコピーをオフにするには、[メトリクスのカーディナリティ制御](/docs/ja/monitoring-usage#metrics-cardinality-control) を参照してください。1346Claude Code は各ラベルをすべてのメトリクスデータポイントにもコピーするため、リソース属性をインデックス化しないバックエンドでもラベルでメトリクスをフィルタリングできます。このコピーをオフにするには、[メトリクスのカーディナリティ制御](/docs/ja/monitoring-usage#metrics-cardinality-control) を参照してください。

1347 1347 

1348<h4 id="group-changes-during-an-open-session">

1349 セッション中のグループの変更

1350</h4>

1351 

1352ターミナルセッションは、`user.groups` を OTLP リソースに付与し、さらに各メトリクスのデータポイントとイベントにも付与します。セッション中に開発者のグループが変更された場合、次の[サイレントリフレッシュ](#session)以降の使用に関するデータポイントとイベントには新しいグループが含まれます。リソースは開発者が Claude Code を再起動するまで古いグループを保持するため、データポイントまたはイベント上の属性でグループ化してください。

1353 

1354OpenTelemetry Collector の Prometheus リモート書き込みエクスポーターで `resource_to_telemetry_conversion` をオンにすると、エクスポーターは各データポイントの `user.groups` をリソースのもので置き換えるため、すべてのデータポイントに古いグループが表示されます。データポイントの値を維持するには、そのエクスポーターの前にリソースから `user.groups` を削除してください。

1355 

1356次の OpenTelemetry Collector の `resource` プロセッサーは、それを列挙したパイプラインで属性を削除します。

1357 

1358```yaml theme={null}

1359processors:

1360 resource/drop-user-groups:

1361 attributes:

1362 - key: user.groups

1363 action: delete

1364```

1365 

1366メトリクスパイプラインの `processors` に `resource/drop-user-groups` を追加すると、各系列は自身のデータポイントから `user_groups` ラベルを持つようになります。

1367 

1348<h4 id="export-directly-to-your-collector">1368<h4 id="export-directly-to-your-collector">

1349 コレクターに直接エクスポートする1369 コレクターに直接エクスポートする

1350</h4>1370</h4>

Details

516 テレメトリ516 テレメトリ

517</h2>517</h2>

518 518 

519ゲートウェイは、マシンごとの OTEL 設定なしで、開発者ごとの使用状況メトリクスを提供します。Claude Code は OpenTelemetry(OTLP)メトリクス、ログ、およびオプトイン トレースを出力します。[使用状況の監視](/docs/ja/monitoring-usage)は、CLI が報告するすべてをカバーしています。`/login` を通じてサインインしたセッションでは、CLI は各エクスポートに認証された IdP ID 属性 `user.id`、`user.email`、および `user.groups` をスタンプし、使用状況は開発者ごとにロールアップされます。519ゲートウェイは、マシンごとの OTEL 設定なしで、開発者ごとの使用状況メトリクスを提供します。Claude Code は OpenTelemetry(OTLP)メトリクス、ログ、およびオプトイン トレースを出力します。[使用状況の監視](/docs/ja/monitoring-usage)は、CLI が報告するすべてをカバーしています。`/login` を通じてサインインしたセッションでは、CLI は認証された IdP ID 属性 `user.id`、`user.email`、および `user.groups` を[各エクスポートにスタンプ](/docs/ja/monitoring-usage#standard-attributes)するため、使用状況は開発者ごとにロールアップされます。

520 520 

521ゲートウェイ自体は認証された OTLP リレーです。[`telemetry.forward_to`](/docs/ja/claude-apps-gateway-config#telemetry) を `listen.public_url` と一緒に設定すると、OTEL エクスポーター設定をすべての接続クライアントにプッシュし、OTLP トラフィックを指定した各宛先に逐語的に転送します。各宛先はメトリクス、ログ、およびトレースに独立してオプトインでき、デフォルトはメトリクスのみです。[`telemetry` リファレンス](/docs/ja/claude-apps-gateway-config#telemetry)で、シグナルごとのフィールドとそれらの感度トレードオフを参照してください。ゲートウェイはテレメトリをバッファリング、集約、または保存しないため、データが到達する場所はコレクターのエクスポーター設定に完全に依存します。521ゲートウェイ自体は認証された OTLP リレーです。[`telemetry.forward_to`](/docs/ja/claude-apps-gateway-config#telemetry) を `listen.public_url` と一緒に設定すると、OTEL エクスポーター設定をすべての接続クライアントにプッシュし、OTLP トラフィックを指定した各宛先に逐語的に転送します。各宛先はメトリクス、ログ、およびトレースに独立してオプトインでき、デフォルトはメトリクスのみです。[`telemetry` リファレンス](/docs/ja/claude-apps-gateway-config#telemetry)で、シグナルごとのフィールドとそれらの感度トレードオフを参照してください。ゲートウェイはテレメトリをバッファリング、集約、または保存しないため、データが到達する場所はコレクターのエクスポーター設定に完全に依存します。

522 522 

Details

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** メニューからクラウドに送信できます。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** メニューからクラウドに送信できます。

92</Note>92</Note>

93 93 

94<h3 id="from-terminal-to-cloud">94<span id="from-terminal-to-cloud" />

95 ターミナルからクラウドへ95 

96<h3 id="start-a-cloud-session-from-your-terminal">

97 ターミナルからクラウドセッションを開始

96</h3>98</h3>

97 99 

98`--cloud` フラグを使用してコマンドラインからクラウドセッションを開始します:100`--cloud` フラグを使用してコマンドラインからクラウドセッションを開始します:


215 217 

216送信が失敗した場合は、[クラウドセッションへの送信時のエラー](#errors-when-sending-to-a-cloud-session)を参照してください。218送信が失敗した場合は、[クラウドセッションへの送信時のエラー](#errors-when-sending-to-a-cloud-session)を参照してください。

217 219 

218<h3 id="from-cloud-to-terminal">220<span id="from-cloud-to-terminal" />

219 クラウドからターミナルへ221 

222<h3 id="continue-a-cloud-session-in-your-terminal">

223 クラウドセッションをターミナルで続行

220</h3>224</h3>

221 225 

222以下のいずれかを使用してクラウドセッションをターミナルにプルします:226以下のいずれかを使用してクラウドセッションをターミナルにプルします:


483[claude.ai/code](https://claude.ai/code) からセッションを再度開いて、新しい VM をプロビジョニングしてください。487[claude.ai/code](https://claude.ai/code) からセッションを再度開いて、新しい VM をプロビジョニングしてください。

484 488 

485* **復元されるもの**: 会話履歴489* **復元されるもの**: 会話履歴

486* **復元されないもの**: VM が回収されたときにまだ実行されていたバックグラウンド作業(サブエージェントやシェルコマンドなど)490* **復元されないもの**: VM が回収されたときにまだ実行されていたバックグラウンド作業(サブエージェントやシェルコマンドなど)、および[自己ペースの `/loop`](/docs/ja/scheduled-tasks#let-claude-choose-the-interval) の保留中のウェイクアップ。ループを再開するには、`/loop` を再度実行してください。

487 491 

488<h2 id="limitations">492<h2 id="limitations">

489 制限事項493 制限事項

Details

489* **Routines**: プロジェクトでスケジュール済みの作業を要求すると、Claude はそのプロジェクト内のスレッドとして実行され、その **Routines** タブに表示される [routine](/docs/ja/routines) を作成します。プロジェクト外で作成した Routines は独立して動作し続けます。489* **Routines**: プロジェクトでスケジュール済みの作業を要求すると、Claude はそのプロジェクト内のスレッドとして実行され、その **Routines** タブに表示される [routine](/docs/ja/routines) を作成します。プロジェクト外で作成した Routines は独立して動作し続けます。

490* **Remote Control**: [Remote Control](/docs/ja/remote-control) は claude.ai をマシン上で実行している Claude Code セッションに接続します。プロジェクトで Claude にコンピュータ上でスレッドを実行するよう要求すると、プロジェクトは [Remote Control を使用してそれを実行します](#run-a-thread-on-your-own-computer)。490* **Remote Control**: [Remote Control](/docs/ja/remote-control) は claude.ai をマシン上で実行している Claude Code セッションに接続します。プロジェクトで Claude にコンピュータ上でスレッドを実行するよう要求すると、プロジェクトは [Remote Control を使用してそれを実行します](#run-a-thread-on-your-own-computer)。

491* **Local sessions と agent view**: ターミナル、IDE、またはデスクトップアプリのローカル環境で自分で開始したセッションはプロジェクトに追加できません。[Agent view](/docs/ja/agent-view) は複数のローカルセッションを並べて追跡するための画面であり、各セッションを自分で開始してタスクを割り当てます。491* **Local sessions と agent view**: ターミナル、IDE、またはデスクトップアプリのローカル環境で自分で開始したセッションはプロジェクトに追加できません。[Agent view](/docs/ja/agent-view) は複数のローカルセッションを並べて追跡するための画面であり、各セッションを自分で開始してタスクを割り当てます。

492* **Worktrees**: [worktree](/docs/ja/worktrees) は各ローカルセッションにリポジトリの独自の作業コピーを提供するため、マシン上の並列セッションが互いに上書きしません。Cloud スレッドはそれらを必要としません。各スレッドはリポジトリを独自のクラウドサンドボックスにクローンし、独自のブランチで作業します。492* **worktree**: [worktree](/docs/ja/worktrees) は各ローカルセッションにリポジトリの独自の作業コピーを提供します。クラウドスレッドはそれらを必要としません。各スレッドはリポジトリを独自のクラウドサンドボックスにクローンし、独自のブランチで作業します。

493* **Agent teams**: [agent team](/docs/ja/agent-teams) は、マシン上またはクラウドセッション内で単一のタスク用にチームメイトセッションを開始し、そのタスクで終了する 1 つのセッションです。493* **Agent teams**: [agent team](/docs/ja/agent-teams) は、マシン上またはクラウドセッション内で単一のタスク用にチームメイトセッションを開始し、そのタスクで終了する 1 つのセッションです。

494* **Subagents**: [subagent](/docs/ja/sub-agents) は 1 つのセッション内で実行され、独自のコンテキストウィンドウで副次的なタスクを実行し、そのセッションに概要を返します。プロジェクトのスレッドは Claude が開始し、プロジェクト会話に報告する完全なセッションであり、スレッドは独自の副次的なタスク用に subagents を使用することができます。494* **Subagents**: [subagent](/docs/ja/sub-agents) は 1 つのセッション内で実行され、独自のコンテキストウィンドウで副次的なタスクを実行し、そのセッションに概要を返します。プロジェクトのスレッドは Claude が開始し、プロジェクト会話に報告する完全なセッションであり、スレッドは独自の副次的なタスク用に subagents を使用することができます。

495* **Projects in claude.ai chat and Cowork**: [以前の Projects エクスペリエンス](https://support.claude.com/en/articles/9517075-what-are-projects)。これはスレッドやコーディネーターなしで会話と参照ファイルをグループ化します。これらのプロジェクトは、再設計されたエクスペリエンスがそれらに到達するまで、今日のように動作し続けます。495* **Projects in claude.ai chat and Cowork**: [以前の Projects エクスペリエンス](https://support.claude.com/en/articles/9517075-what-are-projects)。これはスレッドやコーディネーターなしで会話と参照ファイルをグループ化します。これらのプロジェクトは、再設計されたエクスペリエンスがそれらに到達するまで、今日のように動作し続けます。

Details

28| `claude auth logout` | Anthropic アカウントからログアウト | `claude auth logout` |28| `claude auth logout` | Anthropic アカウントからログアウト | `claude auth logout` |

29| `claude auth status` | 認証ステータスを JSON として表示します。`--text` を使用して人間が読める形式で表示できます。ログイン済みの場合はコード 0 で終了し、ログインしていない場合は 1 で終了します。JSON には、CLI が使用する [設定ディレクトリ](/docs/ja/claude-directory) の名前を付ける `configDirectory` フィールドが含まれます。このフィールドには Claude Code v2.1.268 以降が必要です。JSON の `authMethod` フィールドは、`none`、`claude.ai`、`oauth_token`、`api_key`、`api_key_helper`、または `third_party` のいずれかです | `claude auth status` |29| `claude auth status` | 認証ステータスを JSON として表示します。`--text` を使用して人間が読める形式で表示できます。ログイン済みの場合はコード 0 で終了し、ログインしていない場合は 1 で終了します。JSON には、CLI が使用する [設定ディレクトリ](/docs/ja/claude-directory) の名前を付ける `configDirectory` フィールドが含まれます。このフィールドには Claude Code v2.1.268 以降が必要です。JSON の `authMethod` フィールドは、`none`、`claude.ai`、`oauth_token`、`api_key`、`api_key_helper`、または `third_party` のいずれかです | `claude auth status` |

30| `claude agents` | [エージェントビュー](/docs/ja/agent-view) を開いて、並列バックグラウンドセッションを監視およびディスパッチします。`--cwd <path>` を使用して、そのディレクトリの下で開始されたセッションのみを表示するか、`--json` を使用してアクティブなセッションを JSON 配列として出力してスクリプト作成用にします(`--json --all` は完了したバックグラウンドセッションも含みます)。`--permission-mode`、`--model`、`--effort`、または `--agent` を渡して、[ディスパッチされたセッションのデフォルト](/docs/ja/agent-view#permission-mode-model-and-effort) を設定します。トップレベルの `claude` コマンドと同様に `--settings`、`--add-dir`、`--plugin-dir`、および `--mcp-config` を受け入れます。エージェントビューを開くにはインタラクティブターミナルが必要です | `claude agents --json` |30| `claude agents` | [エージェントビュー](/docs/ja/agent-view) を開いて、並列バックグラウンドセッションを監視およびディスパッチします。`--cwd <path>` を使用して、そのディレクトリの下で開始されたセッションのみを表示するか、`--json` を使用してアクティブなセッションを JSON 配列として出力してスクリプト作成用にします(`--json --all` は完了したバックグラウンドセッションも含みます)。`--permission-mode`、`--model`、`--effort`、または `--agent` を渡して、[ディスパッチされたセッションのデフォルト](/docs/ja/agent-view#permission-mode-model-and-effort) を設定します。トップレベルの `claude` コマンドと同様に `--settings`、`--add-dir`、`--plugin-dir`、および `--mcp-config` を受け入れます。エージェントビューを開くにはインタラクティブターミナルが必要です | `claude agents --json` |

31| `claude attach <id\|name>` | このターミナルで [バックグラウンドセッション](/docs/ja/agent-view#manage-sessions-from-the-shell) に接続します。ID の代わりに実行中のセッション名の一部を渡すには、Claude Code v2.1.290 以降が必要です | `claude attach 7c5dcf5d` |31| `claude attach <id\|name>` | このターミナルで [バックグラウンドセッション](/docs/ja/agent-view#manage-sessions-from-the-shell) に接続します。ID の代わりにセッション名の一部を渡すには、Claude Code v2.1.290 以降が必要です | `claude attach 7c5dcf5d` |

32| `claude auto-mode defaults` | 組み込み [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) 分類器ルールを JSON として出力します。`claude auto-mode config` を使用して、設定が適用された有効な設定を確認してください。`--label <prefix>` は、ラベルがそのプレフィックスで始まるルールのみを出力します。大文字と小文字を区別しません。Claude Code v2.1.208 以降が必要です | `claude auto-mode defaults --label 'Git Destructive'` |32| `claude auto-mode defaults` | 組み込み [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) 分類器ルールを JSON として出力します。`claude auto-mode config` を使用して、設定が適用された有効な設定を確認してください。`--label <prefix>` は、ラベルがそのプレフィックスで始まるルールのみを出力します。大文字と小文字を区別しません。Claude Code v2.1.208 以降が必要です | `claude auto-mode defaults --label 'Git Destructive'` |

33| `claude auto-mode reset` | ユーザー設定ファイルから `autoMode` セクションを削除して、デフォルト [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) 設定を復元します。書き込み前に確認を求めます。`-y`/`--yes` を渡してプロンプトをスキップします。[管理設定](/docs/ja/server-managed-settings) または `--settings` フラグからのルールは引き続き適用されます。Claude Code v2.1.212 以降が必要です。[デフォルトと有効な設定を検査](/docs/ja/auto-mode-config#inspect-the-defaults-and-your-effective-config) を参照してください | `claude auto-mode reset --yes` |33| `claude auto-mode reset` | ユーザー設定ファイルから `autoMode` セクションを削除して、デフォルト [auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) 設定を復元します。書き込み前に確認を求めます。`-y`/`--yes` を渡してプロンプトをスキップします。[管理設定](/docs/ja/server-managed-settings) または `--settings` フラグからのルールは引き続き適用されます。Claude Code v2.1.212 以降が必要です。[デフォルトと有効な設定を検査](/docs/ja/auto-mode-config#inspect-the-defaults-and-your-effective-config) を参照してください | `claude auto-mode reset --yes` |

34| `claude daemon logs` | バックグラウンドセッション [スーパーバイザー](/docs/ja/agent-view#the-supervisor-process) のログファイル `~/.claude/daemon.log` を追跡し、`Ctrl+C` を押すまで新しい行が届くたびに出力します | `claude daemon logs` |34| `claude daemon logs` | バックグラウンドセッション [スーパーバイザー](/docs/ja/agent-view#the-supervisor-process) のログファイル `~/.claude/daemon.log` を追跡し、`Ctrl+C` を押すまで新しい行が届くたびに出力します | `claude daemon logs` |


37| `claude daemon stop --any` | バックグラウンドセッション [スーパーバイザー](/docs/ja/agent-view#the-supervisor-process) とそれがホストするセッションを停止します。`--keep-workers` を渡して、バックグラウンドセッションを実行したままにして、次のスーパーバイザーが再接続できるようにします。`--any` はオンデマンドスーパーバイザーの停止を確認します。これはデフォルトです。これを使用して、[応答しないスーパーバイザー](/docs/ja/agent-view#agent-view-says-the-background-service-did-not-respond) から回復します | `claude daemon stop --any --keep-workers` |37| `claude daemon stop --any` | バックグラウンドセッション [スーパーバイザー](/docs/ja/agent-view#the-supervisor-process) とそれがホストするセッションを停止します。`--keep-workers` を渡して、バックグラウンドセッションを実行したままにして、次のスーパーバイザーが再接続できるようにします。`--any` はオンデマンドスーパーバイザーの停止を確認します。これはデフォルトです。これを使用して、[応答しないスーパーバイザー](/docs/ja/agent-view#agent-view-says-the-background-service-did-not-respond) から回復します | `claude daemon stop --any --keep-workers` |

38| `claude doctor` | セッションを開始せずにターミナルから読み取り専用のインストールおよび設定診断を出力します。インストール正常性、設定ファイル検証エラー、および Remote Control 適格性を含みます。セッション内のセットアップチェックアップで修正を適用することもできます。[`/doctor`](/docs/ja/commands#all-commands) を実行してください | `claude doctor` |38| `claude doctor` | セッションを開始せずにターミナルから読み取り専用のインストールおよび設定診断を出力します。インストール正常性、設定ファイル検証エラー、および Remote Control 適格性を含みます。セッション内のセットアップチェックアップで修正を適用することもできます。[`/doctor`](/docs/ja/commands#all-commands) を実行してください | `claude doctor` |

39| `claude import [source]` | 他のコーディングエージェントからの設定を Claude Code に取り込むために [`/import`](/docs/ja/commands#all-commands) を実行するインタラクティブセッションを開始します。コマンドと同じ `--dry-run` および `--yes` オプションを受け入れます。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または AWS 上の Claude Platform では利用できません。[機能フラグ取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching) をオフにした場合も利用できません。Claude Code v2.1.213 以降が必要です | `claude import codex --dry-run` |39| `claude import [source]` | 他のコーディングエージェントからの設定を Claude Code に取り込むために [`/import`](/docs/ja/commands#all-commands) を実行するインタラクティブセッションを開始します。コマンドと同じ `--dry-run` および `--yes` オプションを受け入れます。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または AWS 上の Claude Platform では利用できません。[機能フラグ取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching) をオフにした場合も利用できません。Claude Code v2.1.213 以降が必要です | `claude import codex --dry-run` |

40| `claude logs <id\|name>` | [バックグラウンドセッション](/docs/ja/agent-view#manage-sessions-from-the-shell) からの最近の出力を出力します。ID の代わりに実行中のセッション名の一部を渡すには、Claude Code v2.1.290 以降が必要です | `claude logs 7c5dcf5d` |40| `claude logs <id\|name>` | [バックグラウンドセッション](/docs/ja/agent-view#manage-sessions-from-the-shell) からの最近の出力を出力します。ID の代わりにセッション名の一部を渡すには、Claude Code v2.1.290 以降が必要です | `claude logs 7c5dcf5d` |

41| `claude mcp` | Model Context Protocol(MCP)サーバーを設定 | [Claude Code MCP ドキュメント](/docs/ja/mcp) を参照してください。 |41| `claude mcp` | Model Context Protocol(MCP)サーバーを設定 | [Claude Code MCP ドキュメント](/docs/ja/mcp) を参照してください。 |

42| `claude mcp login <name>` | 設定済み MCP サーバーの OAuth フローを実行します。インタラクティブな `/mcp` パネルを開きません。HTTP、SSE、および claude.ai コネクタサーバーで機能します。SSH 経由で `--no-browser` を追加して、ブラウザを開く代わりに認可 URL を出力し、リダイレクト URL をプロンプトに貼り付けます。[コマンドラインから認証](/docs/ja/mcp#authenticate-from-the-command-line) を参照してください | `claude mcp login sentry` |42| `claude mcp login <name>` | 設定済み MCP サーバーの OAuth フローを実行します。インタラクティブな `/mcp` パネルを開きません。HTTP、SSE、および claude.ai コネクタサーバーで機能します。SSH 経由では `--no-browser` を追加すると、ブラウザを開く代わりに認可 URL を出力します。HTTP または SSE サーバーの場合は、リダイレクト URL をプロンプトに貼り付けます。claude.ai コネクタの場合は、[シェルからコネクタを再度認可する](/docs/ja/remote-control#authorize-a-connector-again-from-your-shell) を参照してください。[コマンドラインから認証](/docs/ja/mcp#authenticate-from-the-command-line) を参照してください | `claude mcp login sentry` |

43| `claude mcp logout <name>` | MCP サーバーの保存された OAuth 認証情報をクリアします | `claude mcp logout sentry` |43| `claude mcp logout <name>` | MCP サーバーの保存された OAuth 認証情報をクリアします | `claude mcp logout sentry` |

44| `claude plugin` | Claude Code [plugins](/docs/ja/plugins/overview) を管理します。エイリアス:`claude plugins`。サブコマンドについては [plugin reference](/docs/ja/plugins/cli-reference#claude-plugin-commands) を参照してください | `claude plugin install code-review@claude-plugins-official` |44| `claude plugin` | Claude Code [plugins](/docs/ja/plugins/overview) を管理します。エイリアス:`claude plugins`。サブコマンドについては [plugin reference](/docs/ja/plugins/cli-reference#claude-plugin-commands) を参照してください | `claude plugin install code-review@claude-plugins-official` |

45| `claude purge [path]` | プロジェクトのすべてのローカル Claude Code 状態を削除します:トランスクリプト、タスクリスト、デバッグログ、ファイル編集履歴、プロンプト履歴行、および `~/.claude.json` 内のプロジェクトエントリ。`[path]` を省略して、インタラクティブリストから選択します。フラグ:`--dry-run` でプレビュー、`-y`/`--yes` で確認をスキップ、`-i`/`--interactive` で各項目を確認、`--all` ですべてのプロジェクト。[ローカルデータをクリア](/docs/ja/claude-directory#clear-local-data) を参照してください | `claude purge ~/work/repo --dry-run` |45| `claude purge [path]` | プロジェクトのすべてのローカル Claude Code 状態を削除します:トランスクリプト、タスクリスト、デバッグログ、ファイル編集履歴、プロンプト履歴行、および `~/.claude.json` 内のプロジェクトエントリ。`[path]` を省略して、インタラクティブリストから選択します。フラグ:`--dry-run` でプレビュー、`-y`/`--yes` で確認をスキップ、`-i`/`--interactive` で各項目を確認、`--all` ですべてのプロジェクト。[ローカルデータをクリア](/docs/ja/claude-directory#clear-local-data) を参照してください | `claude purge ~/work/repo --dry-run` |


106| `--input-format` | プリントモードの入力形式を指定します(オプション:`text`、`stream-json`) | `claude -p --output-format json --input-format stream-json` |106| `--input-format` | プリントモードの入力形式を指定します(オプション:`text`、`stream-json`) | `claude -p --output-format json --input-format stream-json` |

107| `--json-schema` | エージェントがワークフローを完了した後、JSON スキーマに一致する検証済み JSON 出力を取得します(プリントモードのみ)。[構造化出力](/docs/ja/agent-sdk/structured-outputs)を参照してください。Claude Code は無効なスキーマでエラーで終了し、`format` キーワードをクライアント側検証なしの注釈として受け入れます | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |107| `--json-schema` | エージェントがワークフローを完了した後、JSON スキーマに一致する検証済み JSON 出力を取得します(プリントモードのみ)。[構造化出力](/docs/ja/agent-sdk/structured-outputs)を参照してください。Claude Code は無効なスキーマでエラーで終了し、`format` キーワードをクライアント側検証なしの注釈として受け入れます | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

108| `--maintenance` | セッションの前に `maintenance` マッチャーで[セットアップフック](/docs/ja/hooks#setup)を実行します(プリントモードのみ) | `claude -p --maintenance "query"` |108| `--maintenance` | セッションの前に `maintenance` マッチャーで[セットアップフック](/docs/ja/hooks#setup)を実行します(プリントモードのみ) | `claude -p --maintenance "query"` |

109| `--max-budget-usd` | 停止する前に API 呼び出しに費やす最大金額(ドル)(プリントモードのみ)。Claude Code は上限を[クライアント側のコスト見積もり](/docs/ja/agent-sdk/cost-tracking#estimates-not-billing)と照合するため、実際の請求額と異なる場合があります。[サブエージェント](/docs/ja/sub-agents)による支出も上限にカウントされます。`--continue` または `--resume` で会話に戻るとき、[以前の実行から復元された](/docs/ja/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)合計は上限にカウントされません。支出が上限に達すると、別のサブエージェントの生成は `Budget limit reached` で失敗し、Claude Code はまだ実行中のバックグラウンドサブエージェントを停止します。上限の適用動作には Claude Code v2.1.217 以降が必要です | `claude -p --max-budget-usd 5.00 "query"` |109| `--max-budget-usd` | API 呼び出しの推定支出がこの金額に達した時点で実行を停止します(プリントモードのみ)。Claude Code は上限を[クライアント側のコスト見積もり](/docs/ja/agent-sdk/cost-tracking#estimates-not-billing)と照合するため、実際の請求額と異なる場合があります。[サブエージェント](/docs/ja/sub-agents)による支出も上限にカウントされます。支出は上限を超えることがあるため、[余裕を持たせてください](/docs/ja/agent-sdk/agent-loop#budget-headroom)。`--continue` または `--resume` で会話に戻るとき、[以前の実行から復元された](/docs/ja/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)合計は上限にカウントされません。支出が上限に達すると、別のサブエージェントの生成は `Budget limit reached` で失敗し、Claude Code はまだ実行中のバックグラウンドサブエージェントを停止します。上限の適用動作には Claude Code v2.1.217 以降が必要です | `claude -p --max-budget-usd 5.00 "query"` |

110| `--max-turns` | エージェンティックターンの数を制限します(プリントモードのみ)。制限に達するとエラーで終了します。デフォルトでは制限がありません。`--input-format stream-json` を使用する場合、制限がターンを終了するときにキューに入れられたメッセージは引き続きキューに入れられ、独自の制限で新しいターンを開始します | `claude -p --max-turns 3 "query"` |110| `--max-turns` | エージェンティックターンの数を制限します(プリントモードのみ)。制限に達するとエラーで終了します。デフォルトでは制限がありません。`--input-format stream-json` を使用する場合、制限がターンを終了するときにキューに入れられたメッセージは引き続きキューに入れられ、独自の制限で新しいターンを開始します | `claude -p --max-turns 3 "query"` |

111| `--mcp-config` | JSON ファイルまたは文字列から MCP サーバーを読み込みます(スペース区切り)。このフラグを `-p` で渡すと、Claude Code は最初のターンを実行する前に、まだ保留中のサーバーが接続されるまで待機します。デフォルトでは [`MCP_TIMEOUT`](/docs/ja/env-vars) スタートアップタイムアウト 30 秒まで待機します。[キャッシュされたツールリスト](/docs/ja/mcp#managing-your-servers)を持つサーバーは待機をスキップし、最初の使用時に接続します。待機には Claude Code v2.1.221 以降が必要です | `claude --mcp-config ./mcp.json` |111| `--mcp-config` | JSON ファイルまたは文字列から MCP サーバーを読み込みます(スペース区切り)。このフラグを `-p` で渡すと、Claude Code は最初のターンを実行する前に、まだ保留中のサーバーが接続されるまで待機します。デフォルトでは [`MCP_TIMEOUT`](/docs/ja/env-vars) スタートアップタイムアウト 30 秒まで待機します。[キャッシュされたツールリスト](/docs/ja/mcp#managing-your-servers)を持つサーバーは待機をスキップし、最初の使用時に接続します。待機には Claude Code v2.1.221 以降が必要です | `claude --mcp-config ./mcp.json` |

112| `--model` | `sonnet`、`opus`、`haiku`、`fable` などの[モデルエイリアス](/docs/ja/model-config#model-aliases)またはモデルの完全な名前を使用して、現在のセッションのモデルを設定します。[`model`](/docs/ja/settings-reference#model) 設定と [`ANTHROPIC_MODEL`](/docs/ja/model-config#environment-variables) をオーバーライドします | `claude --model claude-sonnet-5` |112| `--model` | `sonnet`、`opus`、`haiku`、`fable` などの[モデルエイリアス](/docs/ja/model-config#model-aliases)またはモデルの完全な名前を使用して、現在のセッションのモデルを設定します。[`model`](/docs/ja/settings-reference#model) 設定と [`ANTHROPIC_MODEL`](/docs/ja/model-config#environment-variables) をオーバーライドします | `claude --model claude-sonnet-5` |

Details

307| | クラウドセッションで利用可能 | 理由 |307| | クラウドセッションで利用可能 | 理由 |

308| :- | :- | :- |308| :- | :- | :- |

309| リポジトリの `CLAUDE.md` | はい | クローンの一部 |309| リポジトリの `CLAUDE.md` | はい | クローンの一部 |

310| リポジトリの `.claude/settings.json` hooks と権限ルール | はい、1 つのリポジトリを持つセッションの場合 | クローンの一部。複数のリポジトリを持つセッション([プロジェクト](/docs/ja/claude-projects#what-threads-pick-up-from-your-repositories)スレッドを含む)はクローンの上で開始され、それらを読み取りません |310| リポジトリの `.claude/settings.json` フックと権限ルール | はい、1 つのリポジトリを持つセッションの場合 | クローンの一部。複数のリポジトリを持つセッションについては、[読み取られる設定](/docs/ja/settings#settings-in-cloud-sessions)を参照してください |

311| リポジトリの `.mcp.json` MCP サーバー | はい、1 つのリポジトリを持つセッションの場合 | クローンの一部、セッションの作業ディレクトリから検出されます |311| リポジトリの `.mcp.json` MCP サーバー | はい、1 つのリポジトリを持つセッションの場合 | クローンの一部、セッションの作業ディレクトリから検出されます。セルフホスト環境については、[どのリポジトリの設定が適用されるか](/docs/ja/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories)を参照してください |

312| リポジトリの `.claude/rules/` | はい | クローンの一部 |312| リポジトリの `.claude/rules/` | はい | クローンの一部 |

313| リポジトリの `.claude/skills/`、`.claude/agents/`、`.claude/commands/` | はい | クローンの一部 |313| リポジトリの `.claude/skills/`、`.claude/agents/`、`.claude/commands/` | はい | クローンの一部 |

314| リポジトリの `.claude/settings.json` で宣言されたプラグインとマーケットプレイス | いいえ | クラウドセッションは、リポジトリが [`enabledPlugins`](/docs/ja/settings-reference#enabledplugins) で有効にするプラグインをインストールしません。これには [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) の下にリストされているマーケットプレイスのプラグインも含まれます |314| リポジトリの `.claude/settings.json` で宣言されたプラグインとマーケットプレイス | いいえ | クラウドセッションは、リポジトリが [`enabledPlugins`](/docs/ja/settings-reference#enabledplugins) で有効にするプラグインをインストールしません。これには [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) の下にリストされているマーケットプレイスのプラグインも含まれます |


575 575 

576SessionStart フックはクラウドでローカルと同じように動作しますが、これらの注意事項があります。576SessionStart フックはクラウドでローカルと同じように動作しますが、これらの注意事項があります。

577 577 

578* **セッションごとに 1 つのリポジトリ**:複数のリポジトリを持つセッションは、リポジトリの `.claude/settings.json` からフックをロードしないため、そこで定義した SessionStart フックは実行されません。これらのセッションの依存関係は [セットアップスクリプト](#setup-scripts) でインストールしてください。578* **セッションごとに 1 つのリポジトリ**:Anthropic ホスト環境では、複数のリポジトリを持つセッションはどのリポジトリの `.claude/settings.json` からもフックをロードしないため、そこで定義した SessionStart フックは実行されません。これらのセッションの依存関係は、代わりに [セットアップスクリプト](#setup-scripts) でインストールしてください。セルフホスト環境については、[どのリポジトリの設定が適用されるか](/docs/ja/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories) を参照してください。

579* **クラウドのみのスコープなし**:フックはローカルとクラウドセッションの両方で実行されます。ローカル実行をスキップするには、[依存関係インストールスクリプト](#install-dependencies-with-a-sessionstart-hook) のように `CLAUDE_CODE_REMOTE` 環境変数が `true` でない限り早期に終了します。579* **クラウドのみのスコープなし**:フックはローカルとクラウドセッションの両方で実行されます。ローカル実行をスキップするには、[依存関係インストールスクリプト](#install-dependencies-with-a-sessionstart-hook) のように `CLAUDE_CODE_REMOTE` 環境変数が `true` でない限り早期に終了します。

580* **ネットワークアクセスが必要**:インストールコマンドはパッケージレジストリに到達する必要があります。環境が **None** ネットワークアクセスを使用する場合、これらのフックは失敗します。**Trusted** の下の [デフォルト許可リスト](#default-allowed-domains) は npm、PyPI、RubyGems、crates.io をカバーします。580* **ネットワークアクセスが必要**:インストールコマンドはパッケージレジストリに到達する必要があります。環境が **None** ネットワークアクセスを使用する場合、これらのフックは失敗します。**Trusted** の下の [デフォルト許可リスト](#default-allowed-domains) は npm、PyPI、RubyGems、crates.io をカバーします。

581* **プロキシ互換性**:Anthropic ホスト環境では、すべての送信トラフィックは [セキュリティプロキシ](#security-proxy) を通じて渡されます。一部のパッケージマネージャーはこのプロキシで正しく機能しません。Bun は既知の例です。[セルフホスト環境](/docs/ja/self-hosted-environments-deploy#default-deny-egress) では、送信トラフィックは代わりに独自のネットワーク境界を通じて行きます。581* **プロキシ互換性**:Anthropic ホスト環境では、すべての送信トラフィックは [セキュリティプロキシ](#security-proxy) を通じて渡されます。一部のパッケージマネージャーはこのプロキシで正しく機能しません。Bun は既知の例です。[セルフホスト環境](/docs/ja/self-hosted-environments-deploy#default-deny-egress) では、送信トラフィックは代わりに独自のネットワーク境界を通じて行きます。

commands.md +1 −1

Details

111| `/login` | Anthropic アカウントにサインインします |111| `/login` | Anthropic アカウントにサインインします |

112| `/logout` | Anthropic アカウントからサインアウトします |112| `/logout` | Anthropic アカウントからサインアウトします |

113| `/loop [interval] [prompt]` | **[Skill](/docs/ja/skills#bundled-skills).** セッションが開いている間、プロンプトを繰り返し実行します。間隔を省略すると、Claude は[反復間で自分のペースを設定](/docs/ja/scheduled-tasks#let-claude-choose-the-interval)します。プロンプトを省略すると、Claude は[組み込みメンテナンスプロンプト](/docs/ja/scheduled-tasks#run-the-built-in-maintenance-prompt)または [`loop.md`](/docs/ja/scheduled-tasks#customize-the-default-prompt-with-loop-md) を実行します。例:`/loop 5m check if the deploy finished`。[スケジュールでプロンプトを実行する](/docs/ja/scheduled-tasks)を参照してください。エイリアス:`/proactive` |113| `/loop [interval] [prompt]` | **[Skill](/docs/ja/skills#bundled-skills).** セッションが開いている間、プロンプトを繰り返し実行します。間隔を省略すると、Claude は[反復間で自分のペースを設定](/docs/ja/scheduled-tasks#let-claude-choose-the-interval)します。プロンプトを省略すると、Claude は[組み込みメンテナンスプロンプト](/docs/ja/scheduled-tasks#run-the-built-in-maintenance-prompt)または [`loop.md`](/docs/ja/scheduled-tasks#customize-the-default-prompt-with-loop-md) を実行します。例:`/loop 5m check if the deploy finished`。[スケジュールでプロンプトを実行する](/docs/ja/scheduled-tasks)を参照してください。エイリアス:`/proactive` |

114| `/mcp [reconnect (<server>\|all)\|enable\|disable [<server>\|all]]` | MCP サーバー接続と OAuth 認証を管理します。引数なしで実行してインタラクティブなリストを開くか、`reconnect`、`enable`、または `disable` をサーバー名または `all` とともに渡して、リストを開かずに接続状態を変更します。`reconnect all` は[失敗したサーバーまたは認証が必要なサーバーをすべて再試行](/docs/ja/mcp#retry-failed-servers-yourself)します。非対話モード(`-p`)でも利用可能で、引数なしで実行するとリストを開く代わりにサーバー状態のテキスト要約を出力します。Claude Code v2.1.205 以降が必要です |114| `/mcp [reconnect (<server>\|all)\|enable\|disable [<server>\|all]]` | MCP サーバー接続と OAuth 認証を管理します。引数なしで実行してインタラクティブなリストを開くか、`reconnect`、`enable`、または `disable` をサーバー名または `all` とともに渡して、リストを開かずに接続状態を変更します。`reconnect all` は[失敗したサーバーまたは認証が必要なサーバーをすべて再試行](/docs/ja/mcp#retry-failed-servers-yourself)します。非対話モード(`-p`)では、引数なしで実行するとリストを開く代わりにサーバー状態のテキスト要約を出力します。Claude Code v2.1.205 以降が必要です |

115| `/memory` | `CLAUDE.md` ファイルを編集し、[自動メモリ](/docs/ja/memory#auto-memory)を有効または無効にし、自動メモリのエントリを表示します |115| `/memory` | `CLAUDE.md` ファイルを編集し、[自動メモリ](/docs/ja/memory#auto-memory)を有効または無効にし、自動メモリのエントリを表示します |

116| `/mobile` | Claude モバイルアプリをダウンロードするための QR コードを表示します。エイリアス:`/ios`、`/android` |116| `/mobile` | Claude モバイルアプリをダウンロードするための QR コードを表示します。エイリアス:`/ios`、`/android` |

117| `/model [model]` | AI モデルを切り替えて、新しいセッションのデフォルトとして保存します。サポートするモデルの場合、左右の矢印を使用して [effort レベルを調整](/docs/ja/model-config#adjust-effort-level)します。引数がない場合、ピッカーが開きます。行で `s` を押すと現在のセッションのみ切り替えます。[Claude Code が切り替えを確認するよう求めるとき](/docs/ja/prompt-caching#switching-models)を参照してください。Claude Code が確認を求めた場合は切り替えを確認すると、Claude Code は現在の応答の終了を待たずに変更を適用します。v2.1.242 より前は、Claude Code は Anthropic から取得したフィーチャーフラグからコマンドをミッドターンで実行するか、ターンが終了するまでキューに入れるかを決定し、[フィーチャーフラグをフェッチしない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッション([サードパーティプロバイダー](/docs/ja/third-party-integrations)など)では常にキューに入れていました。非対話モード(`-p`)でも、ピッカーの代わりにモデル引数を使用して利用可能です。その場合は現在のセッションのみに適用され、デフォルトとして保存されません。Claude Code v2.1.205 以降が必要です |117| `/model [model]` | AI モデルを切り替えて、新しいセッションのデフォルトとして保存します。サポートするモデルの場合、左右の矢印を使用して [effort レベルを調整](/docs/ja/model-config#adjust-effort-level)します。引数がない場合、ピッカーが開きます。行で `s` を押すと現在のセッションのみ切り替えます。[Claude Code が切り替えを確認するよう求めるとき](/docs/ja/prompt-caching#switching-models)を参照してください。Claude Code が確認を求めた場合は切り替えを確認すると、Claude Code は現在の応答の終了を待たずに変更を適用します。v2.1.242 より前は、Claude Code は Anthropic から取得したフィーチャーフラグからコマンドをミッドターンで実行するか、ターンが終了するまでキューに入れるかを決定し、[フィーチャーフラグをフェッチしない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッション([サードパーティプロバイダー](/docs/ja/third-party-integrations)など)では常にキューに入れていました。非対話モード(`-p`)でも、ピッカーの代わりにモデル引数を使用して利用可能です。その場合は現在のセッションのみに適用され、デフォルトとして保存されません。Claude Code v2.1.205 以降が必要です |

desktop.md +1 −1

Details

396 セッションで並列に作業する396 セッションで並列に作業する

397</h3>397</h3>

398 398 

399サイドバーの\*\*+ New session**をクリックするか、macOS で**Cmd+N**を、Windows で**Ctrl+N**を押して、複数のタスクを並列で作業します。**Ctrl+Tab**と**Ctrl+Shift+Tab**を押してサイドバーのセッションをサイクルします。Git リポジトリの場合、ブランチ名の横の**worktree\*\*オプションを選択して、[Git worktrees](/docs/ja/worktrees)を使用してセッションにプロジェクトの独立した分離コピーを与えるため、1 つのセッションの変更は、コミットするまで他のセッションに影響しません。399サイドバーの\*\*+ New session**をクリックするか、macOS で**Cmd+N**を、Windows で**Ctrl+N**を押して、複数のタスクを並列で作業します。**Ctrl+Tab**と**Ctrl+Shift+Tab**を押してサイドバーのセッションをサイクルします。Git リポジトリの場合、ブランチ名の横の**worktree\*\*オプションを選択すると、[Git worktrees](/docs/ja/worktrees)を使用して、セッションにプロジェクトの独立した分離コピーを与えることができます。

400 400 

4012 つのセッションを同時に表示するには、macOS で**Cmd**を、Windows で**Ctrl**を押しながらサイドバーのセッションをクリックします。セッションは既に開いているセッションの横の 2 番目のペインで開きます。分割がアクティブな間、別のサイドバーセッションをクリックすると、フォーカスがあるペインが置き換わります。macOS で\*\*Cmd+\\**を、Windows で**Ctrl+\\\*\*を押して、フォーカスされたペインを閉じて、単一のセッションに戻ります。4012 つのセッションを同時に表示するには、macOS で**Cmd**を、Windows で**Ctrl**を押しながらサイドバーのセッションをクリックします。セッションは既に開いているセッションの横の 2 番目のペインで開きます。分割がアクティブな間、別のサイドバーセッションをクリックすると、フォーカスがあるペインが置き換わります。macOS で\*\*Cmd+\\**を、Windows で**Ctrl+\\\*\*を押して、フォーカスされたペインを閉じて、単一のセッションに戻ります。

402 402 

env-vars.md +308 −303

Details

21 21 

22シェルで設定した変数はそのターミナルセッション中のみ有効ですが、設定ファイル内の変数は `claude` を実行するたびに適用されます。22シェルで設定した変数はそのターミナルセッション中のみ有効ですが、設定ファイル内の変数は `claude` を実行するたびに適用されます。

23 23 

24<h3 id="in-your-shell">24<span id="in-your-shell" />

25 シェルで設定する25 

26<h3 id="set-variables-in-your-shell">

27 シェルで変数を設定する

26</h3>28</h3>

27 29 

28`claude` を起動する前に変数を設定します。30`claude` を起動する前に変数を設定します。


78 </Tab>80 </Tab>

79</Tabs>81</Tabs>

80 82 

81<h3 id="in-settings-files">83<span id="in-settings-files" />

82 設定ファイルで設定する84 

85<h3 id="set-variables-in-settings-files">

86 設定ファイルで変数を設定する

83</h3>87</h3>

84 88 

85`settings.json` ファイルの `env` キーの下に変数を追加します。ファイルが存在しない場合は作成します。Claude Code はファイルから直接読み込むため、`claude` がどのように起動されたかに関わらず有効になります。実行中のセッションは、ファイルを保存するときに新しい値と変更された値を環境に適用しますが、[OpenTelemetry monitoring](/docs/ja/monitoring-usage) のように起動時に変数を一度だけ読み込む機能は、再起動するまで起動時の値を保持します。ファイルから変数を削除しても、実行中のセッションではその変数は設定解除されません。削除は `claude` を次に起動するときに有効になります。89`settings.json` ファイルの `env` キーの下に変数を追加します。ファイルが存在しない場合は作成します。Claude Code はファイルから直接読み込むため、`claude` がどのように起動されたかに関わらず有効になります。実行中のセッションは、ファイルを保存するときに新しい値と変更された値を環境に適用しますが、[OpenTelemetry monitoring](/docs/ja/monitoring-usage) のように起動時に変数を一度だけ読み込む機能は、再起動するまで起動時の値を保持します。ファイルから変数を削除しても、実行中のセッションではその変数は設定解除されません。削除は `claude` を次に起動するときに有効になります。


120 124 

121環境変数が CLI フラグおよびセッション内コマンドとどのように相互作用するかは、機能ごとに異なります。`--model` と `/model` は `ANTHROPIC_MODEL` をオーバーライドしますが、`CLAUDE_CODE_EFFORT_LEVEL` は `--effort` と `/effort` をオーバーライドします。変数が別の設定ソースと相互作用する場合、[変数](#variables) リストの行は優先順位を示すか、それを文書化するページにリンクします。125環境変数が CLI フラグおよびセッション内コマンドとどのように相互作用するかは、機能ごとに異なります。`--model` と `/model` は `ANTHROPIC_MODEL` をオーバーライドしますが、`CLAUDE_CODE_EFFORT_LEVEL` は `--effort` と `/effort` をオーバーライドします。変数が別の設定ソースと相互作用する場合、[変数](#variables) リストの行は優先順位を示すか、それを文書化するページにリンクします。

122 126 

123Claude Code はスタートアップ時にシェル環境変数を読み込むため、それらへの変更は次回 `claude` を起動するときに有効になります。設定ファイルの `env` キーの下に設定された変数は、[設定ファイル内](#in-settings-files) で説明されているスタートアップのみの例外を除き、ファイルが変更されたときに実行中のセッションに再適用されます。127Claude Code はスタートアップ時にシェル環境変数を読み込むため、それらへの変更は次回 `claude` を起動するときに有効になります。設定ファイルの `env` キーの下に設定された変数は、[設定ファイルで変数を設定する](#in-settings-files) で説明されているスタートアップのみの例外を除き、ファイルが変更されたときに実行中のセッションに再適用されます。

124 128 

125<h2 id="variables">129<h2 id="variables">

126 変数130 変数

127</h2>131</h2>

128 132 

129タイムアウト、トークン予算、再試行回数などの数値変数は、通常の数字に加えて、指数表記と桁区切りの表記も受け付けます。ただし、変数の行に数字のみを受け付けると記載されている場合を除きます。たとえば、Claude Code は `2e3` を 2000、`64_000` を 64000 として読み取ります。v2.1.211 より前は、これらの表記によって意図せずはるかに小さい値が設定されることがありました。たとえば `1e6` ではタイムアウトが 1 に設定されていました。133タイムアウト、トークン予算、再試行回数などの数値変数は、通常の数字に加えて指数表記と桁区切りの表記も受け付けます。ただし、変数の行に数字のみを受け付けると記載されている場合を除きます。たとえば、Claude Code は `2e3` を 2000、`64_000` を 64000 として読み取ります。v2.1.211 より前は、これらの表記によって、`1e6` がタイムアウトを 1 に設定するなど、はるかに小さい値が警告なく設定されることがありました。

130 134 

131<Note>135<Note>

132 動作をオンまたはオフにする変数では、大文字小文字を問わず、`1`、`true`、`yes`、`on` のいずれかを設定するとオンになり、`0`、`false`、`no`、`off` のいずれかを設定するとオフになります。136 動作をオンまたはオフにする変数では、オンにするには `1`、`true`、`yes`、`on` のいずれかを、オフにするには `0`、`false`、`no`、`off` のいずれかを設定します。大文字と小文字は区別されません。

133 137 

134 一部の変数は設定されているかどうかだけを読み取るため、`0` を含む空でない値はすべて動作をオンにします。動作をオフにするには、変数の設定を解除するか、空の値を設定します。次の変数がこのように動作します。138 一部の変数は、設定されているかどうかのみを読み取ります。そのため、`0` を含む空でない値はすべて動作をオンにし、動作をオフにするには変数の設定を解除するか空の値を設定します。次の変数がこのように動作します。

135 139 

136 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`140 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

137 * `DISABLE_TELEMETRY`141 * `DISABLE_TELEMETRY`


140 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`144 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`

141 * `IS_DEMO`145 * `IS_DEMO`

142 146 

143 もう 1 つの変数には独自のルールがあります。`FORCE_HYPERLINK` は数値を読み取るため、`0` を設定した場合にのみオフになります。各変数の行にも、それぞれのルールが記載されています。147 もう 1 つの変数には独自のルールがあります。`FORCE_HYPERLINK` は数値を読み取るため、`0` のみがオフにします。各変数の行にも、それぞれのルールが記載されています。

144</Note>148</Note>

145 149 

146| 変数 | 用途 |150| 変数 | 目的 |

147| :- | :- |151| :- | :- |

148| `ANTHROPIC_API_KEY` | `X-Api-Key` ヘッダーとして送信される API キー。設定すると、ログインしている場合でも、Claude Pro、Max、Team、Enterprise のサブスクリプションの代わりにこのキーが使用されます。非対話モード(`-p`)では、キーが存在する場合は常に使用されます。対話モードでは、キーがサブスクリプションを上書きする前に、一度だけキーの承認を求められます。代わりにサブスクリプションを使用するには、`unset ANTHROPIC_API_KEY` を実行します |152| `ANTHROPIC_API_KEY` | `X-Api-Key` ヘッダーとして送信される API キー。設定すると、ログインしている場合でも、Claude Pro、Max、Team、Enterprise のサブスクリプションの代わりにこのキーが使用されます。非対話モード(`-p`)では、キーが存在する場合は常に使用されます。対話モードでは、キーがサブスクリプションより優先される前に、キーを承認するよう一度求められます。代わりにサブスクリプションを使用するには、`unset ANTHROPIC_API_KEY` を実行します |

149| `ANTHROPIC_AUTH_TOKEN` | `Authorization` ヘッダーのカスタム値(ここで設定した値には `Bearer ` が先頭に付加されます) |153| `ANTHROPIC_AUTH_TOKEN` | `Authorization` ヘッダーのカスタム値(ここで設定した値の先頭には `Bearer ` が付加されます) |

150| `ANTHROPIC_AWS_API_KEY` | AWS Console で生成された [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) 用のワークスペース API キー。`x-api-key` として送信され、AWS SigV4 より優先されます |154| `ANTHROPIC_AWS_API_KEY` | AWS Console で生成された [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) 用のワークスペース API キー。`x-api-key` として送信され、AWS SigV4 より優先されます |

151| `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)でリージョンを解決します |155| `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)でリージョンを解決します |

152| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) で必須です。すべてのリクエストで `anthropic-workspace-id` ヘッダーとして送信されます |156| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) で必須です。すべてのリクエストで `anthropic-workspace-id` ヘッダーとして送信されます |

153| `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 での動作と同じです |157| `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 での動作と同じです |

154| `ANTHROPIC_BEDROCK_BASE_URL` | Amazon Bedrock のエンドポイント URL を上書きします。カスタムの Amazon Bedrock エンドポイントを使用する場合や、[LLM ゲートウェイ](/docs/ja/llm-gateway)を経由してルーティングする場合に使用します。[Amazon Bedrock](/docs/ja/amazon-bedrock) を参照してください |158| `ANTHROPIC_BEDROCK_BASE_URL` | Amazon Bedrock のエンドポイント URL を上書きします。カスタムの Amazon Bedrock エンドポイントを使用する場合や、[LLM ゲートウェイ](/docs/ja/llm-gateway)経由でルーティングする場合に使用します。[Amazon Bedrock](/docs/ja/amazon-bedrock) を参照してください |

155| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Amazon Bedrock Mantle のエンドポイント URL を上書きします。[Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)を参照してください |159| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Amazon Bedrock Mantle のエンドポイント URL を上書きします。[Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)を参照してください |

156| `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) を参照してください |160| `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) を参照してください |

157| `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) を参照してください |161| `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) を参照してください |

158| `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 サブスクリプションを含むすべての認証方法で機能します |162| `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 サブスクリプションを含むすべての認証方法で機能します |

159| `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)に従います |163| `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)に従います |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION` | `/model` ピッカーにカスタムエントリとして追加するモデル ID。組み込みのエイリアスを置き換えずに、非標準またはゲートウェイ固有のモデルを選択可能にするために使用します。[モデル設定](/docs/ja/model-config#add-a-custom-model-option)を参照してください |164| `ANTHROPIC_CUSTOM_MODEL_OPTION` | `/model` ピッカーにカスタムエントリとして追加するモデル ID。組み込みのエイリアスを置き換えずに、非標準またはゲートウェイ固有のモデルを選択できるようにするために使用します。[モデル設定](/docs/ja/model-config#add-a-custom-model-option)を参照してください |

161| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` ピッカーのカスタムモデルエントリの表示用説明。設定されていない場合、デフォルトは `Custom model (<model-id>)` です |165| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` ピッカーのカスタムモデルエントリに表示する説明。設定されていない場合のデフォルトは `Custom model (<model-id>)` です |

162| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` ピッカーのカスタムモデルエントリの表示名。設定されていない場合、Claude Code が [ID を認識する](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)ときはモデルの名前が表示され、それ以外の場合はモデル ID が表示されます |166| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` ピッカーのカスタムモデルエントリに表示する名前。設定されていない場合、Claude Code が [ID を認識する](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)ときはモデルの名前が、それ以外の場合はモデル ID がエントリに表示されます |

163| `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)を参照してください |167| `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)を参照してください |

164| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` エイリアスが解決されるモデル ID。また、サードパーティプロバイダーでの[自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback)において Claude Code が Fable モデルとして認識する ID でもあります。[モデル設定](/docs/ja/model-config#environment-variables)を参照してください |168| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` エイリアスが解決されるモデル ID。また、サードパーティプロバイダーでの[自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback)において、Claude Code が Fable モデルとして認識する ID でもあります。[モデル設定](/docs/ja/model-config#environment-variables)を参照してください |

165| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | `/model` ピッカーで固定された Fable モデルの表示用説明。設定されていない場合、行には `Custom Fable model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |169| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | `/model` ピッカーで固定された Fable モデルに表示する説明。設定されていない場合、行には `Custom Fable model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

166| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | `/model` ピッカーで固定された Fable モデルの表示名。設定されていない場合、Claude Code が固定された ID を認識するときはモデルの名前が、それ以外の場合は固定された ID が行に表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |170| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | `/model` ピッカーで固定された Fable モデルに表示する名前。設定されていない場合、Claude Code が固定された ID を認識するときはモデルの名前が、それ以外の場合は固定された ID が行に表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

167| `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)を参照してください |171| `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)を参照してください |

168| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` エイリアスが解決されるモデル ID。[バックグラウンド機能](/docs/ja/costs#background-token-usage)にも使用されます。[モデル設定](/docs/ja/model-config#environment-variables)を参照してください |172| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` エイリアスが解決されるモデル ID。[バックグラウンド機能](/docs/ja/costs#background-token-usage)にも使用されます。[モデル設定](/docs/ja/model-config#environment-variables)を参照してください |

169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | `/model` ピッカーで固定された Haiku モデルの表示用説明。設定されていない場合、行には `Custom Haiku model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |173| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | `/model` ピッカーで固定された Haiku モデルに表示する説明。設定されていない場合、行には `Custom Haiku model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

170| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | `/model` ピッカーで固定された Haiku モデルの表示名。設定されていない場合、Claude Code が固定された ID を認識するときはモデルの名前が、それ以外の場合は固定された ID が行に表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |174| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | `/model` ピッカーで固定された Haiku モデルに表示する名前。設定されていない場合、Claude Code が固定された ID を認識するときはモデルの名前が、それ以外の場合は固定された ID が行に表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

171| `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)を参照してください |175| `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)を参照してください |

172| `ANTHROPIC_DEFAULT_MODEL` | 新しいセッションがデフォルトで開始するモデル。Claude Code v2.1.236 以降が必要です。[新しいセッションのデフォルトモデルを設定する](/docs/ja/model-config#set-a-default-model-for-new-sessions)を参照してください |176| `ANTHROPIC_DEFAULT_MODEL` | 新しいセッションがデフォルトで開始するモデル。Claude Code v2.1.236 以降が必要です。[新しいセッションのデフォルトモデルを設定する](/docs/ja/model-config#set-a-default-model-for-new-sessions)を参照してください |

173| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` エイリアスが解決されるモデル ID。plan モードがアクティブな間に `opusplan` が使用するモデル ID でもあります。[モデル設定](/docs/ja/model-config#environment-variables)を参照してください |177| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` エイリアスが解決されるモデル ID。plan モードがアクティブな間に `opusplan` が使用するモデルでもあります。[モデル設定](/docs/ja/model-config#environment-variables)を参照してください |

174| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` ピッカーで固定された Opus モデルの表示用説明。設定されていない場合、行には `Custom Opus model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |178| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` ピッカーで固定された Opus モデルに表示する説明。設定されていない場合、行には `Custom Opus model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

175| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | `/model` ピッカーで固定された Opus モデルの表示名。設定されていない場合、Claude Code が固定された ID を認識するときはモデルの名前が、それ以外の場合は固定された ID が行に表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |179| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | `/model` ピッカーで固定された Opus モデルに表示する名前。設定されていない場合、Claude Code が固定された ID を認識するときはモデルの名前が、それ以外の場合は固定された ID が行に表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

176| `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)を参照してください |180| `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)を参照してください |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` エイリアスが解決されるモデル ID。plan モードがアクティブでないときに `opusplan` が使用するモデル ID でもあります。[モデル設定](/docs/ja/model-config#environment-variables)を参照してください |181| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` エイリアスが解決されるモデル ID。plan モードがアクティブでないときに `opusplan` が使用するモデルでもあります。[モデル設定](/docs/ja/model-config#environment-variables)を参照してください |

178| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | `/model` ピッカーで固定された Sonnet モデルの表示用説明。設定されていない場合、行には `Custom Sonnet model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |182| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | `/model` ピッカーで固定された Sonnet モデルに表示する説明。設定されていない場合、行には `Custom Sonnet model` で始まるデフォルトの説明が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

179| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | `/model` ピッカーで固定された Sonnet モデルの表示名。設定されていない場合、Claude Code が固定された ID を認識するときはモデルの名前が、それ以外の場合は固定された ID が行に表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |183| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | `/model` ピッカーで固定された Sonnet モデルに表示する名前。設定されていない場合、Claude Code が固定された ID を認識するときはモデルの名前が、それ以外の場合は固定された ID が行に表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities)を参照してください |

180| `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)を参照してください |184| `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)を参照してください |

181| `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)を参照してください |185| `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)を参照してください |

182| `ANTHROPIC_FOUNDRY_API_KEY` | Microsoft Foundry 認証用の API キー([Microsoft Foundry](/docs/ja/microsoft-foundry) を参照) |186| `ANTHROPIC_FOUNDRY_API_KEY` | Microsoft Foundry 認証用の API キー([Microsoft Foundry](/docs/ja/microsoft-foundry) を参照) |

183| `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 以降が必要です |187| `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 以降が必要です |

184| `ANTHROPIC_FOUNDRY_BASE_URL` | Microsoft Foundry リソースの完全なベース URL(例:`https://my-resource.services.ai.azure.com/anthropic`)。`ANTHROPIC_FOUNDRY_RESOURCE` の代替です([Microsoft Foundry](/docs/ja/microsoft-foundry) を参照) |188| `ANTHROPIC_FOUNDRY_BASE_URL` | Microsoft Foundry リソースの完全なベース URL(例:`https://my-resource.services.ai.azure.com/anthropic`)。`ANTHROPIC_FOUNDRY_RESOURCE` の代替です([Microsoft Foundry](/docs/ja/microsoft-foundry) を参照) |

185| `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) を参照) |189| `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) を参照) |

186| `ANTHROPIC_MODEL` | 使用するモデル設定の名前([モデル設定](/docs/ja/model-config#environment-variables)を参照) |190| `ANTHROPIC_MODEL` | 使用するモデル設定の名前([モデル設定](/docs/ja/model-config#environment-variables)を参照) |

187| `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)を参照してください |191| `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)を参照してください |

188| `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)を参照してください |192| `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)を参照してください |

189| `ANTHROPIC_SMALL_FAST_MODEL` | \[非推奨] [バックグラウンドタスク用の Haiku クラスのモデル](/docs/ja/costs)の名前 |193| `ANTHROPIC_SMALL_FAST_MODEL` | \[非推奨] [バックグラウンドタスク用の Haiku クラスのモデル](/docs/ja/costs)の名前 |

190| `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)を使用してバックグラウンドタスクを実行するためです |194| `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)を使用してバックグラウンドタスクを実行するためです |

191| `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) を参照してください |195| `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) を参照してください |

192| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud's Agent Platform へのリクエストの宛先となる GCP プロジェクト ID。[GCP 認証情報を設定する](/docs/ja/google-vertex-ai#3-configure-gcp-credentials)を参照してください |196| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud's Agent Platform へのリクエストの宛先となる GCP プロジェクト ID。[GCP 認証情報を設定する](/docs/ja/google-vertex-ai#3-configure-gcp-credentials)を参照してください |

193| `ANTHROPIC_WORKSPACE_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) のワークスペース ID。フェデレーションルールのスコープが複数のワークスペースにわたる場合に設定し、トークン交換でどのワークスペースを対象にするかを指定します |197| `ANTHROPIC_WORKSPACE_ID` | [ワークロードアイデンティティフェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)のワークスペース ID。フェデレーションルールのスコープが複数のワークスペースにまたがる場合に設定し、トークン交換でどのワークスペースを対象にするかを指定します |

194| `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` を設定した場合でも、長時間の無応答の停止を中止します |198| `API_FORCE_IDLE_TIMEOUT` | バイトが届かない場合にストリーミングのモデルレスポンスを中止する、5 分間のボディアイドルタイムアウトを上書きします。低速な[ゲートウェイ](/docs/ja/llm-gateway)やローカルモデルがチャンク間で 5 分以上停止する場合などにタイムアウトをオフにするには `0` を、すべてのプロバイダーでオンのままにするには `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` を設定した場合でも、長時間の無応答の停止を中止します |

195| `API_TIMEOUT_MS` | API リクエストのタイムアウト(ミリ秒)(デフォルト:600000、つまり 10 分。最大:2147483647)。低速なネットワークでリクエストがタイムアウトする場合や、プロキシ経由でルーティングする場合に値を増やします。最大値を超える値は基盤となるタイマーをオーバーフローさせ、リクエストが即座に失敗する原因になります |199| `API_TIMEOUT_MS` | API リクエストのタイムアウト(ミリ秒)(デフォルト:600000、つまり 10 分。最大:2147483647)。低速なネットワークでリクエストがタイムアウトする場合や、プロキシ経由でルーティングする場合に値を増やします。最大値を超える値は基盤となるタイマーをオーバーフローさせ、リクエストが即座に失敗する原因になります |

196| `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/)を参照) |200| `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/)を参照) |

197| `BASH_DEFAULT_TIMEOUT_MS` | フォアグラウンドの Bash または PowerShell ツールコマンドのデフォルトタイムアウト(ミリ秒)(デフォルト:120000、つまり 2 分)。[バックグラウンドコマンドのデフォルトの制限時間](/docs/ja/tools-reference#time-limit-for-background-commands)を超える値は、無人セッションでそのデフォルトを置き換えます。バックグラウンドの制限時間には Claude Code v2.1.285 以降が必要です |201| `BASH_DEFAULT_TIMEOUT_MS` | フォアグラウンドの Bash または PowerShell ツールコマンドのデフォルトタイムアウト(ミリ秒)(デフォルト:120000、つまり 2 分)。[バックグラウンドコマンドのデフォルトの時間制限](/docs/ja/tools-reference#time-limit-for-background-commands)を超える値を設定すると、無人セッションではそのデフォルトが置き換えられます。バックグラウンドの時間制限には Claude Code v2.1.285 以降が必要です |

198| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果に読み戻す bash 出力の最大文字数(デフォルト:30000。最大:150000)。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 設定を設定している場合、Claude Code はこの変数を無視します。[出力の制限](/docs/ja/tools-reference#output-limits)を参照してください |202| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果に読み込む bash 出力の最大文字数(デフォルト:30000、最大:150000)。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 設定を行っている場合、Claude Code はこの変数を無視します。[出力の制限](/docs/ja/tools-reference#output-limits)を参照してください |

199| `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 以降が必要です |203| `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 以降が必要です |

200| `BETA_TRACING_ENDPOINT` | [詳細なベータトレーシング](/docs/ja/monitoring-usage#traces-beta)用の OTLP/HTTP エンドポイント。`ENABLE_BETA_TRACING_DETAILED=1` を設定すると、ログとトレースは設定済みのエクスポーターではなくこのエンドポイントに送信されます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |204| `BETA_TRACING_ENDPOINT` | [詳細なベータトレーシング](/docs/ja/monitoring-usage#traces-beta)用の OTLP/HTTP エンドポイント。`ENABLE_BETA_TRACING_DETAILED=1` を設定すると、ログとトレースは設定済みのエクスポーターではなくこのエンドポイントに送信されます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |

201| `CCR_FORCE_BUNDLE` | `1` に設定すると、[`claude --cloud`](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github) がリモートからクローンする代わりに、ローカルリポジトリを強制的にバンドルしてアップロードします |205| `CCR_FORCE_BUNDLE` | `1` に設定すると、[`claude --cloud`](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github) がリモートからクローンする代わりに、ローカルリポジトリをバンドルしてアップロードするよう強制します |

202| `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` を使用します |206| `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` を使用します |

203| `CLAUDE_AFK_COUNTDOWN_MS` | 未応答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログで、自動続行の何ミリ秒前に画面上のカウントダウンを表示するか。デフォルトは `20000`(20 秒)で、自動続行のタイムアウトが上限です。自動続行がオンでない限り効果はありません。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定と `CLAUDE_AFK_TIMEOUT_MS` を参照してください。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。Claude Code v2.1.198 以降が必要です |207| `CLAUDE_AFK_COUNTDOWN_MS` | 未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログで、自動続行の何ミリ秒前に画面上のカウントダウンを表示するか。デフォルトは `20000`(20 秒)で、自動続行のタイムアウトが上限です。自動続行がオンでない限り効果はありません。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定と `CLAUDE_AFK_TIMEOUT_MS` を参照してください。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。Claude Code v2.1.198 以降が必要です |

204| `CLAUDE_AFK_TIMEOUT_MS` | 未応答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログが、ユーザーの応答なしで自動続行するまでのアイドル時間(ミリ秒)。自動続行はデフォルトでオフです。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定でオプトインします。この変数はデモや自動テスト用の上書きです。設定すると、その設定より優先され、設定が未設定または `never` の場合でも自動続行をオンにします。`0` を設定してもタイムアウトはオフになりません。ダイアログが即座に閉じます。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。v2.1.200 より前は、自動続行はデフォルトでオンで、タイムアウトは `60000`(60 秒)でした。Claude Code v2.1.198 以降が必要です |208| `CLAUDE_AFK_TIMEOUT_MS` | 未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログが、ユーザーの応答なしで自動続行するまでのアイドル時間(ミリ秒)。自動続行はデフォルトでオフです。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定でオプトインします。この変数はデモや自動テスト向けの上書き用です。設定すると、その設定より優先され、設定が未設定または `never` の場合でも自動続行をオンにします。`0` を設定してもタイムアウトはオフにならず、ダイアログが即座に閉じます。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。v2.1.200 より前は、自動続行はデフォルトでオンで、タイムアウトは `60000`(60 秒)でした。Claude Code v2.1.198 以降が必要です |

205| `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) で失敗します |209| `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) で失敗します |

206| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | `1` に設定すると、SDK で作成された MCP サーバーのツール名に付く `mcp__<server>__` プレフィックスを省略します。ツールは元の名前を使用します。SDK での使用のみ |210| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | `1` に設定すると、SDK で作成された MCP サーバーのツール名で `mcp__<server>__` プレフィックスを省略します。ツールは元の名前を使用します。SDK での使用のみ |

207| `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 はサブエージェントを中止し、停滞を親に報告します |211| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | サブエージェントのストールタイムアウト(ミリ秒)。Claude Code v2.1.286 以降では[ワークフローエージェント](/docs/ja/workflows#when-an-agent-stalls-and-restarts)も対象になります。デフォルトは `600000`(10 分)です。ストリームウォッチドッグがオンのときに `CLAUDE_STREAM_IDLE_TIMEOUT_MS` を引き上げると、[低速または停止した API レスポンスを処理する](/docs/ja/agent-sdk/typescript#handle-slow-or-stalled-api-responses)で説明されているように、デフォルトもそれに合わせて引き上げられます |

208| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 自動圧縮がトリガーされる、自動圧縮ウィンドウに対する割合(1-100)を設定します。早めに圧縮するには `50` などの低い値を使用します。この変数でしきい値を引き上げることはできないため、デフォルトの割合を超える値は無視されます。[モデルのコンテキスト上限より前に圧縮する](/docs/ja/model-config#context-window-and-auto-compaction)セッションでのみ適用されます。メインの会話とサブエージェントの両方に適用されます |212| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 自動圧縮がトリガーされる、自動圧縮ウィンドウのパーセンテージ(1-100)を設定します。より早く圧縮するには `50` のような低い値を使用します。この変数でしきい値を引き上げることはできないため、デフォルトのパーセンテージを超える値は無視されます。[モデルのコンテキスト上限より前に圧縮する](/docs/ja/model-config#context-window-and-auto-compaction)セッションでのみ適用されます。メインの会話とサブエージェントの両方に適用されます |

209| `CLAUDE_AUTO_BACKGROUND_TASKS` | `1` に設定すると、長時間実行されるエージェントタスクの自動バックグラウンド化を強制的に有効にします。有効にすると、サブエージェントは約 2 分間実行された後にバックグラウンドに移動されます。Claude Code v2.1.212 以降では、非対話モードで[長時間の MCP ツール呼び出しの自動バックグラウンド化](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls)も有効にします |213| `CLAUDE_AUTO_BACKGROUND_TASKS` | `1` に設定すると、長時間実行されるエージェントタスクの自動バックグラウンド化を強制的に有効にします。有効にすると、サブエージェントは約 2 分間実行された後にバックグラウンドに移動されます。Claude Code v2.1.212 以降では、非対話モードでの[長時間の MCP ツール呼び出しの自動バックグラウンド化](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls)も有効にします |

210| `CLAUDE_AX_PREPARK_MS` | [スクリーンリーダーモード](/docs/ja/accessibility)で、Claude Code が新しい行または変更された行を書き込む前に待機するミリ秒数。デフォルトは `0` で、Claude Code は待機しません。v2.1.287 より前は、デフォルトは `50` でした。Claude Code は待機時間の上限を `5000` とします。Claude Code v2.1.233 以降が必要です |214| `CLAUDE_AX_PREPARK_MS` | [スクリーンリーダーモード](/docs/ja/accessibility)で、新しい行または変更された行を書き込む前に Claude Code が待機するミリ秒数。デフォルトは `0` で、Claude Code は待機しません。v2.1.287 より前のデフォルトは `50` でした。Claude Code は待機時間の上限を `5000` にします。Claude Code v2.1.233 以降が必要です |

211| `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 以降が必要です |215| `CLAUDE_AX_SCREEN_READER` | `1` に設定すると、スクリーンリーダーに適した出力(装飾的な枠線やアニメーションのないフラットなテキスト)をレンダリングします。[`axScreenReader`](/docs/ja/settings-reference#axscreenreader) が `true` の場合でもスクリーンリーダーモードを強制的にオフにするには、`0` に設定します。[`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) フラグが優先されます。Claude Code v2.1.181 以降が必要です |

212| `CLAUDE_AX_STARTUP_QUIET_MS` | [スクリーンリーダーモード](/docs/ja/accessibility)で、起動確認行の後に Claude Code が最初のインターフェースのレンダリングを保留するミリ秒数。これにより、新しい出力に割り込まれる前に、スクリーンリーダーがその行を最後まで読み上げられます。デフォルトは `3000` です。`0` に設定すると即座にレンダリングします。Claude Code は保留時間の上限を `600000`(10 分)とします。最初のキー入力で保留は早期に終了します。Claude Code v2.1.217 以降が必要です |216| `CLAUDE_AX_STARTUP_QUIET_MS` | [スクリーンリーダーモード](/docs/ja/accessibility)で、起動確認行の後に Claude Code が最初のインターフェースのレンダリングを保留するミリ秒数。これにより、新しい出力に中断される前に、スクリーンリーダーがその行を最後まで読み上げることができます。デフォルトは `3000` です。すぐにレンダリングするには `0` を設定します。Claude Code は保留時間の上限を `600000`(10 分)にします。最初のキー入力で保留は早期に終了します。Claude Code v2.1.217 以降が必要です |

213| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | メインセッションで、各 Bash または PowerShell コマンドの後に元の作業ディレクトリに戻ります |217| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | メインセッションで、各 Bash または PowerShell コマンドの後に元の作業ディレクトリに戻ります |

214| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | バイトレベルのストリーミングアイドルウォッチドッグのタイムアウト(ミリ秒)。設定すると、そのウォッチドッグについては `CLAUDE_STREAM_IDLE_TIMEOUT_MS` より優先され、イベントレベルのウォッチドッグは変更されません。Claude Code はこの変数を 10 秒から 30 分の範囲に制限します。Claude Code v2.1.210 以降が必要です |218| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | バイトレベルのストリーミングアイドルウォッチドッグのタイムアウト(ミリ秒)。設定すると、そのウォッチドッグについては `CLAUDE_STREAM_IDLE_TIMEOUT_MS` より優先され、イベントレベルのウォッチドッグは変更されません。Claude Code はこの変数を 10 秒から 30 分の範囲に制限します。Claude Code v2.1.210 以降が必要です |

215| `CLAUDE_CLIENT_PRESENCE_FILE` | 画面ロックリスナーなどの外部ツールが、画面のロック解除時に作成し、ロック時に削除するファイルへのパス。ファイルが存在する間、Claude Code は [Remote Control のモバイルプッシュ通知](/docs/ja/remote-control#mobile-push-notifications)をスキップするため、コンピューターをアクティブに使用している間はプッシュ通知が届かなくなります。ファイルが存在しないか読み取れない場合、通知は通常どおり送信されます。Claude Code はファイルをポーリングするのではなく、プッシュをトリガーするイベントごとに 1 回ファイルを確認します。Claude Code v2.1.181 以降が必要です |219| `CLAUDE_CLIENT_PRESENCE_FILE` | 画面ロックリスナーなどの外部ツールが、画面のロック解除時に作成し、ロック時に削除するファイルへのパス。このファイルが存在する間、Claude Code は [Remote Control のモバイルプッシュ通知](/docs/ja/remote-control#mobile-push-notifications)をスキップするため、コンピューターを実際に使用している間はプッシュ通知を受け取らなくなります。ファイルが存在しないか読み取れない場合、通知は通常どおり送信されます。Claude Code はファイルをポーリングするのではなく、プッシュをトリガーするイベントごとに 1 回確認します。Claude Code v2.1.181 以降が必要です |

216| `CLAUDE_CODE_ACCESSIBILITY` | `1` に設定すると、ネイティブのターミナルカーソルを表示したままにし、反転テキストのカーソルインジケーターを無効にします。macOS Zoom などの画面拡大ツールがカーソル位置を追跡できるようになります |220| `CLAUDE_CODE_ACCESSIBILITY` | `1` に設定すると、ネイティブのターミナルカーソルを表示したままにし、反転テキストのカーソルインジケーターを無効にします。macOS のズーム機能などの画面拡大鏡がカーソル位置を追跡できるようになります |

217| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | `1` に設定すると、`--add-dir` で指定したディレクトリからメモリファイルを読み込みます。`CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、`CLAUDE.local.md` を読み込みます。デフォルトでは、追加ディレクトリからメモリファイルは読み込まれません |221| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | `1` に設定すると、`--add-dir` で指定したディレクトリからメモリファイルを読み込みます。`CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、`CLAUDE.local.md` を読み込みます。デフォルトでは、追加ディレクトリからメモリファイルは読み込まれません |

218| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen)で増分更新を送信する代わりに、フレームごとに画面全体を再描画します。フルスクリーンモードで古いテキストの断片や位置がずれたテキストの断片が表示される場合に使用します。Claude Code は、Windows のバックグラウンドセッションと[エージェントビュー](/docs/ja/agent-view)でこれを自動的に有効にします |222| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen)で増分更新を送信する代わりに、フレームごとに画面全体を再描画します。フルスクリーンモードで古いテキストの断片や位置のずれたテキストの断片が表示される場合に使用します。Claude Code は、Windows のバックグラウンドセッションと[エージェントビュー](/docs/ja/agent-view)でこれを自動的に有効にします |

219| `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 パラメーターを拒否するモデルは、リクエストが失敗しないように引き続き除外されます |223| `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 パラメーターを拒否するモデルは引き続き除外されるため、リクエストは失敗しません |

220| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 認証情報を更新する間隔(ミリ秒)([`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper) を使用する場合) |224| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 認証情報を更新する間隔(ミリ秒)([`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper) を使用する場合) |

221| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | `0` に設定すると、新しい[アーティファクト](/docs/ja/artifacts#create-an-artifact)が公開されたときに Claude Code がブラウザーを自動的に開かないようにします |225| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | `0` に設定すると、新しい[アーティファクト](/docs/ja/artifacts#create-an-artifact)が公開されたときに Claude Code がブラウザを自動的に開かないようにします |

222| `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 以降が必要です |226| `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 以降が必要です |

223| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | `0` に設定すると、Claude が[自身に送られたコメントに自分で返信する](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own)ことを停止します。Claude Code v2.1.228 以降が必要です |227| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | `0` に設定すると、Claude が[自身に送信されたコメントに自動で返信する](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own)のを停止します。Claude Code v2.1.228 以降が必要です |

224| `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` に設定してください |228| `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` に設定してください |

225| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | v2.1.283 で削除されました。代わりに `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` を使用してください |229| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | v2.1.283 で削除されました。代わりに `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` を使用してください |

226| `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` は常にモデルの完全なコンテキストウィンドウに対して測定されるため、この変数を設定すると、その割合は圧縮がいつ実行されるかを示さなくなります |230| `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` は常にモデルのコンテキストウィンドウ全体を基準に測定されるため、この変数を設定すると、そのパーセンテージはコンテキスト圧縮が実行されるタイミングを示さなくなります |

227| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 自動 [IDE 接続](/docs/ja/vs-code)を上書きします。デフォルトでは、サポートされている IDE の統合ターミナル内で起動すると、Claude Code は自動的に接続します。これを防ぐには `false` に設定します。tmux によって親ターミナルが隠されている場合など、自動検出が失敗したときに接続を強制的に試行するには `true` に設定します。[`autoConnectIde`](/docs/ja/settings-reference#autoconnectide) グローバル設定より優先されます |231| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 自動的な [IDE 接続](/docs/ja/vs-code)を上書きします。デフォルトでは、サポートされている IDE の統合ターミナル内で起動すると、Claude Code は自動的に接続します。これを防ぐには `false` に設定します。tmux が親ターミナルを隠している場合など、自動検出が失敗したときに接続を強制的に試行するには `true` に設定します。[`autoConnectIde`](/docs/ja/settings-reference#autoconnectide) グローバル設定より優先されます |

228| `CLAUDE_CODE_AUTO_MODE_SERVER` | Claude Code がサーバーに [auto モードのアクションのレビュー](/docs/ja/permission-modes#server-side-classifier-review)を依頼するかどうかを制御します。代わりに Claude Code 独自の分類器リクエストを使用するには `0` に設定します。Anthropic API への直接接続では、v2.1.281 以降が必要です。リンク先のセクションには、変数が設定されていない場合にどのセッションがサーバーに依頼するか、またそれがどのバージョンからかが記載されています。Claude Code v2.1.271 以降が必要です |232| `CLAUDE_CODE_AUTO_MODE_SERVER` | Claude Code がサーバーに [auto モードのアクションのレビュー](/docs/ja/permission-modes#server-side-classifier-review)を依頼するかどうかを制御します。代わりに Claude Code 独自の分類器リクエストを使用するには、`0` に設定します。Anthropic API への直接接続では v2.1.281 以降が必要です。リンク先のセクションには、変数が設定されていない場合にどのセッションがサーバーに依頼するか、またどのバージョンからかが記載されています。Claude Code v2.1.271 以降が必要です |

229| `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 サインインなど、チェーン内のステップが正当により長い時間を必要とする場合は値を引き上げます。Amazon Bedrock、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、[Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)に適用されます。[認証情報のキャッシュと解決のタイムアウト](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout)を参照してください。Claude Code v2.1.207 以降が必要です |233| `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 サインインなど、チェーン内のステップが正当な理由でより長い時間を必要とする場合に値を引き上げます。Amazon Bedrock、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、[Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)に適用されます。[認証情報のキャッシュと解決タイムアウト](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout)を参照してください。Claude Code v2.1.207 以降が必要です |

230| `CLAUDE_CODE_BASH_EDIT_DIFF` | `0` に設定すると、[Bash コマンドの実行中に変更されたファイルの差分](/docs/ja/hooks#bash)をオフにします。`1` に設定すると、すべての権限モードで差分を記録します。[`bashEditDiffEnabled`](/docs/ja/settings-reference#basheditdiffenabled) 設定より優先されます。Claude Code v2.1.269 以降が必要です |234| `CLAUDE_CODE_BASH_EDIT_DIFF` | `0` に設定すると [Bash コマンドの実行中に変更されたファイルの差分](/docs/ja/hooks#bash)をオフにし、`1` に設定するとすべての権限モードで差分を記録します。[`bashEditDiffEnabled`](/docs/ja/settings-reference#basheditdiffenabled) 設定より優先されます。Claude Code v2.1.269 以降が必要です |

231| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | `0` に設定すると、バックグラウンド作業がまだ実行中であっても、非対話セッションがターン終了ごとにホストにアイドル状態を報告するようにします。デフォルトでは、バックグラウンドエージェントや[ワークフロー](/docs/ja/workflows)の実行などのバックグラウンド作業がまだ動作している間、セッションはターン終了後も実行中の状態を報告し続けます。これにより、リモートセッション一覧などステータスを監視するホストが、作業の途中で Claude がユーザーの入力を待っていると通知することを防ぎます。開発サーバーなどのバックグラウンドのシェルコマンドは、実行中の状態を保持しません。実行中の状態のデフォルトと `0` によるオプトアウトには Claude Code v2.1.269 以降が必要です。それより前のバージョンでは、実行中の状態を保持するには `1` を設定します |235| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | `0` に設定すると、バックグラウンドの作業がまだ実行中であっても、非対話セッションがターン終了のたびにホストにアイドルステータスを報告するようにします。デフォルトでは、バックグラウンドエージェントや[ワークフロー](/docs/ja/workflows)の実行などのバックグラウンドの作業がまだ動作している間、セッションはターン終了後も実行中ステータスを報告し続けます。これにより、リモートセッションリストなどステータスを監視するホストが、作業の途中で Claude がユーザーの入力を待っていると通知するのを防ぎます。開発サーバーなどのバックグラウンドシェルコマンドは、実行中ステータスを保持しません。実行中ステータスのデフォルトと `0` によるオプトアウトには Claude Code v2.1.269 以降が必要です。それより前のバージョンでは、実行中ステータスを保持するには `1` を設定します |

232| `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` を読み取ります |236| `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` を読み取ってください |

233| `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` を設定してください |237| `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` を設定します |

234| `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` です |238| `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` です |

235| `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 以降が必要です |239| `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 以降が必要です |

236| `CLAUDE_CODE_CLIENT_CERT` | mTLS 認証用のクライアント証明書ファイルへのパス |240| `CLAUDE_CODE_CLIENT_CERT` | mTLS 認証用のクライアント証明書ファイルへのパス |

237| `CLAUDE_CODE_CLIENT_KEY` | mTLS 認証用のクライアント秘密鍵ファイルへのパス |241| `CLAUDE_CODE_CLIENT_KEY` | mTLS 認証用のクライアント秘密鍵ファイルへのパス |

238| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 暗号化された CLAUDE\_CODE\_CLIENT\_KEY のパスフレーズ(オプション) |242| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 暗号化された CLAUDE\_CODE\_CLIENT\_KEY のパスフレーズ(省略可能) |

239| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | v2.1.186 で削除され、現在は何の効果もありません。以前は、ストリーミング API リクエストの接続、TLS、レスポンスヘッダーのフェーズに個別のタイムアウトを設定していました。リクエストごとのタイムアウトには `API_TIMEOUT_MS` を使用してください。ストリーミングリクエストのレスポンスヘッダーのフェーズについては、`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` を参照してください |243| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | v2.1.186 で削除され、現在は何も行いません。以前は、ストリーミング API リクエストの接続、TLS、レスポンスヘッダーのフェーズに個別のタイムアウトを設定していました。リクエストごとのタイムアウトには `API_TIMEOUT_MS` を使用します。ストリーミングリクエストのレスポンスヘッダーのフェーズについては、`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` を参照してください |

240| `CLAUDE_CODE_DEBUG_LOGS_DIR` | デバッグログファイルのパスを上書きします。名前に反して、これはディレクトリではなくファイルパスです。`--debug`、`/debug`、または `DEBUG` 環境変数を使用して、デバッグモードを別途有効にする必要があります。この変数を設定しただけではログ記録は有効になりません。[`--debug-file`](/docs/ja/cli-reference#cli-flags) フラグは両方を一度に行います。デフォルトは `~/.claude/debug/<session-id>.txt` です |244| `CLAUDE_CODE_DEBUG_LOGS_DIR` | デバッグログファイルのパスを上書きします。名前に反して、これはディレクトリではなくファイルパスです。`--debug`、`/debug`、または `DEBUG` 環境変数を使用して、別途デバッグモードを有効にする必要があります。この変数を設定するだけではログは有効になりません。[`--debug-file`](/docs/ja/cli-reference#cli-flags) フラグは両方を一度に行います。デフォルトは `~/.claude/debug/<session-id>.txt` です |

241| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | デバッグログファイルに書き込まれる最小ログレベル。値:`verbose`、`debug`(デフォルト)、`info`、`warn`、`error`。ステータスラインコマンドの完全な出力など大量の診断情報を含めるには `verbose` に設定し、ノイズを減らすには `error` に引き上げます |245| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | デバッグログファイルに書き込まれる最小ログレベル。値:`verbose`、`debug`(デフォルト)、`info`、`warn`、`error`。ステータスラインコマンドの完全な出力など、大量の診断情報を含めるには `verbose` に設定し、ノイズを減らすには `error` に引き上げます |

242| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | `1` に設定すると、[1M コンテキストウィンドウ](/docs/ja/model-config#extended-context)のサポートをオフにします。Claude Code はモデルピッカーから `[1m]` モデルバリアントを削除し、デフォルトで 1M ウィンドウで実行されるモデルを 200K ウィンドウに制限します。[1M コンテキストをオフにする](/docs/ja/model-config#turn-off-1m-context)を参照してください。コンプライアンス要件のあるエンタープライズ環境で便利です。認識されない `[1m]` モデル ID のウィンドウを修正する際の役割については、[ゲートウェイまたはカスタムモデル ID のウィンドウを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id)を参照してください |246| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | `1` に設定すると、[1M コンテキストウィンドウ](/docs/ja/model-config#extended-context)のサポートをオフにします。Claude Code はモデルピッカーから `[1m]` モデルバリアントを削除し、デフォルトで 1M ウィンドウで実行されるモデルを 200K ウィンドウに制限します。[1M コンテキストをオフにする](/docs/ja/model-config#turn-off-1m-context)を参照してください。コンプライアンス要件のあるエンタープライズ環境で便利です。認識されない `[1m]` モデル ID のウィンドウを補正する際の役割については、[ゲートウェイまたはカスタムモデル ID のウィンドウを補正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id)を参照してください |

243| `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 以降、Haiku 5.5、Opus 4.7 以降には効果がありません |247| `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 以降、Haiku 5.5、Opus 4.7 以降には効果がありません |

244| `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 以降が必要です |248| `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 以降が必要です |

245| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | `1` に設定すると、[advisor ツール](/docs/ja/advisor)を無効にします。`/advisor` コマンドは使用できなくなり、設定済みの `advisorModel` は無視されます。`--advisor` フラグは受け付けられますが効果はないため、このフラグを渡す既存のスクリプトはエラーなく引き続き動作します |249| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | `1` に設定すると、[アドバイザーツール](/docs/ja/advisor)を無効にします。`/advisor` コマンドは使用できなくなり、設定された `advisorModel` は無視され、`--advisor` フラグは受け付けられますが効果はありません。そのため、このフラグを渡す既存のスクリプトはエラーなしで引き続き動作します |

246| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | `1` に設定すると、[バックグラウンドエージェントとエージェントビュー](/docs/ja/agent-view)(`claude agents`、`--bg`、`/background`、オンデマンドのスーパーバイザー)をオフにします。[`disableAgentView`](/docs/ja/settings-reference#disableagentview) 設定と同等です |250| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | `1` に設定すると、[バックグラウンドエージェントとエージェントビュー](/docs/ja/agent-view)(`claude agents`、`--bg`、`/background`、オンデマンドのスーパーバイザー)をオフにします。[`disableAgentView`](/docs/ja/settings-reference#disableagentview) 設定と同等です |

247| `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)から開いたバックグラウンドセッションには適用されません |251| `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)から開いたバックグラウンドセッションには適用されません |

248| `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) キーでもオフにできます |252| `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) キーでもオフにできます |

249| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | `1` に設定すると、添付ファイルの処理を無効にします。`@` 構文によるファイルメンションは、ファイルの内容に展開されずにプレーンテキストとして送信されます。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |253| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | `1` に設定すると、添付ファイルの処理を無効にします。`@` 構文によるファイルメンションは、ファイルの内容に展開されるのではなく、プレーンテキストとして送信されます。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |

250| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | `1` に設定すると、別のプロセスが [`gcpAuthRefresh`](/docs/ja/settings-reference#gcpauthrefresh) または [`awsAuthRefresh`](/docs/ja/settings-reference#awsauthrefresh) コマンドを実行している間待機する代わりに、Claude Code のプロセスがそのコマンドを自ら実行するようにします。Claude Code v2.1.286 以降が必要です |254| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | `1` に設定すると、別のプロセスが [`gcpAuthRefresh`](/docs/ja/settings-reference#gcpauthrefresh) または [`awsAuthRefresh`](/docs/ja/settings-reference#awsauthrefresh) コマンドを実行している間待機するのではなく、Claude Code のプロセス自体がそのコマンドを実行するようにします。Claude Code v2.1.286 以降が必要です |

251| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | `1` に設定すると、[自動メモリ](/docs/ja/memory#auto-memory)を無効にします。`0` に設定すると、`--bare` モードや [`autoMemoryEnabled: false`](/docs/ja/settings-reference#automemoryenabled) によって無効になる場合でも、自動メモリを強制的にオンにします。無効にすると、Claude は自動メモリファイルを作成も読み込みもしません |255| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | `1` に設定すると、[自動メモリ](/docs/ja/memory#auto-memory)を無効にします。`--bare` モードや [`autoMemoryEnabled: false`](/docs/ja/settings-reference#automemoryenabled) によって無効になる場合でも自動メモリを強制的にオンにするには、`0` に設定します。無効にすると、Claude は自動メモリファイルを作成も読み込みもしません |

252| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | `1` に設定すると、Bash ツールとサブエージェントツールの `run_in_background` パラメーター、自動バックグラウンド化、Ctrl+B ショートカットを含む、すべてのバックグラウンドタスク機能を無効にします |256| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | `1` に設定すると、Bash ツールとサブエージェントツールの `run_in_background` パラメーター、自動バックグラウンド化、Ctrl+B ショートカットを含む、すべてのバックグラウンドタスク機能を無効にします |

253| `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 以降が必要です |257| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | `1` に設定すると、`Content-Type` ヘッダーが欠落しているか空の [Amazon Bedrock](/docs/ja/amazon-bedrock) ストリーミングレスポンスを、Claude Code が Amazon Bedrock のバイナリイベントストリームとして扱わないようにします。デフォルトでは、Claude Code は、ゲートウェイがそれ以外は変更されていないレスポンスからヘッダーを削除したと想定してボディをデコードするため、ストリーミングは引き続き機能します。ストリームをサーバー送信イベントとして再送出するゲートウェイの場合にのみ設定してください。その場合、Claude Code はヘッダーのないボディをサーバー送信イベントとして読み取ります。Claude Code v2.1.239 以降が必要です |

254| `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 以降が必要です |258| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | `1` に設定すると、[Amazon Bedrock](/docs/ja/amazon-bedrock) のストリーミングレスポンスが `application/vnd.amazon.eventstream` の content-type を持つかどうかのチェックをスキップします。この変数がない場合、レスポンスが異なる content-type を持つと、Claude Code はその type を示すエラーでリクエストを失敗させます。これは[ゲートウェイまたはプロキシがレスポンスを変換している](/docs/ja/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy)ことを意味します。この変数を設定するのではなく、`Content-Type` ヘッダーとボディを変更せずに転送するようゲートウェイを設定してください。Claude Code v2.1.208 以降が必要です |

255| `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 以降が必要です |259| `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 以降が必要です |

256| `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 以降が必要です |260| `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 以降が必要です |

257| `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) 設定と同等です |261| `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) 設定と同等です |

258| `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 以降が必要です |262| `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 以降が必要です |

259| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | `1` に設定すると、ユーザー、プロジェクト、自動メモリのファイルを含む、すべての CLAUDE.md メモリファイルがコンテキストに読み込まれないようにします |263| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | `1` に設定すると、ユーザー、プロジェクト、自動メモリのファイルを含む、すべての CLAUDE.md メモリファイルをコンテキストに読み込まないようにします |

260| `CLAUDE_CODE_DISABLE_CRON` | `1` に設定すると、[スケジュールタスク](/docs/ja/scheduled-tasks)を無効にします。`/loop` スキルと cron ツールは使用できなくなり、セッションの途中ですでに実行中のタスクを含め、スケジュール済みのタスクはすべて実行されなくなります |264| `CLAUDE_CODE_DISABLE_CRON` | `1` に設定すると、[スケジュールタスク](/docs/ja/scheduled-tasks)を無効にします。`/loop` スキルと cron ツールは使用できなくなり、セッションの途中ですでに実行中のタスクを含め、スケジュール済みのタスクはすべて実行されなくなります |

261| `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 以降が必要です |265| `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 以降が必要です |

262| `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 が引き続き送信するものが記載されています |266| `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 が引き続き送信するものが記載されています |

263| `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 以降が必要です |267| `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 以降が必要です |

264| `CLAUDE_CODE_DISABLE_FAST_MODE` | `1` に設定すると、[fast mode](/docs/ja/fast-mode) を無効にします |268| `CLAUDE_CODE_DISABLE_FAST_MODE` | `1` に設定すると、[fast モード](/docs/ja/fast-mode)を無効にします |

265| `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)を参照してください |269| `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)を参照してください |

266| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | `1` に設定すると、ファイルの[チェックポイント機能](/docs/ja/checkpointing)を無効にします。`/rewind` コマンドでコードの変更を復元できなくなります。[`fileCheckpointingEnabled`](/docs/ja/settings-reference#filecheckpointingenabled) 設定を上書きします |270| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | `1` に設定すると、ファイルの[チェックポイント機能](/docs/ja/checkpointing)を無効にします。`/rewind` コマンドでコードの変更を復元できなくなります。[`fileCheckpointingEnabled`](/docs/ja/settings-reference#filecheckpointingenabled) 設定を上書きします |

267| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | `1` に設定すると、組み込みのコミットと PR のワークフロー指示、および git ステータスのスナップショットを Claude のコンテキストから削除します。独自の git ワークフロースキルを使用する場合に便利です。設定すると、[`includeGitInstructions`](/docs/ja/settings-reference#includegitinstructions) 設定より優先されます |271| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | `1` に設定すると、組み込みのコミットおよび PR ワークフローの指示と git ステータスのスナップショットを Claude のコンテキストから削除します。独自の git ワークフロースキルを使用する場合に便利です。設定すると、[`includeGitInstructions`](/docs/ja/settings-reference#includegitinstructions) 設定より優先されます |

268| `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 以降が必要です |272| `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 以降が必要です |

269| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | `1` に設定すると、Anthropic API で Opus 4.0 と 4.1 が現在の Opus バージョンに自動的に再マッピングされないようにします。意図的に古いモデルに固定したい場合に使用します。再マッピングは Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry では実行されません |273| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | `1` に設定すると、Anthropic API で Opus 4.0 と 4.1 が現在の Opus バージョンに自動的に再マッピングされないようにします。意図的に古いモデルに固定したい場合に使用します。再マッピングは Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry では実行されません |

270| `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 以降が必要です |274| `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 以降が必要です |

271| `CLAUDE_CODE_DISABLE_MOUSE` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen)でマウストラッキングを無効にします。`PgUp` と `PgDn` によるキーボードスクロールは引き続き機能します。ターミナルのネイティブの選択時コピー動作を維持するために使用します |275| `CLAUDE_CODE_DISABLE_MOUSE` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen)でマウストラッキングを無効にします。`PgUp` と `PgDn` によるキーボードスクロールは引き続き機能します。ターミナルのネイティブな選択時コピーの動作を維持するために使用します |

272| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | `1` に設定すると、マウスホイールによるスクロールを維持しつつ、[フルスクリーンレンダリング](/docs/ja/fullscreen)でのクリック、ドラッグ、ホバーの処理を無効にします。Claude Code 内でホイールスクロールを機能させたいが、クリックでカーソルを配置したり、ツール出力を展開したり、リンクを開いたりしたくない場合に使用します。両方が設定されている場合は `CLAUDE_CODE_DISABLE_MOUSE` が優先されます。Claude Code v2.1.195 以降が必要です |276| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | `1` に設定すると、マウスホイールのスクロールを維持したまま、[フルスクリーンレンダリング](/docs/ja/fullscreen)でのクリック、ドラッグ、ホバーの処理を無効にします。Claude Code 内でホイールスクロールを機能させたいが、クリックでカーソルを配置したり、ツールの出力を展開したり、リンクを開いたりしたくない場合に使用します。両方が設定されている場合は `CLAUDE_CODE_DISABLE_MOUSE` が優先されます。Claude Code v2.1.195 以降が必要です |

273| `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 以降が必要です |277| `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 以降が必要です |

274| `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)には影響しません |278| `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)には影響しません |

275| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | `1` に設定すると、ストリーミングリクエストがストリームの途中で失敗したときの非ストリーミングフォールバックを無効にします。代わりに、ストリーミングエラーは再試行レイヤーに伝播されます。プロキシやゲートウェイが原因で、フォールバックによってツールの重複実行が発生する場合に便利です |279| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | `1` に設定すると、ストリーミングリクエストが途中で失敗したときの非ストリーミングフォールバックを無効にします。ストリーミングエラーは代わりに再試行レイヤーに伝播されます。プロキシやゲートウェイが原因で、フォールバックによってツールが重複して実行される場合に便利です |

276| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | `1` に設定すると、ターミナルで入力中またはターミナルにフォーカスしている間でも、`PushNotification` ツールのデスクトップ通知を送信します。デフォルトでは、最近のキーボード操作またはターミナルのフォーカスを検出すると、ツールはデスクトップ通知と[モバイルプッシュ](/docs/ja/remote-control#mobile-push-notifications)の両方をスキップします。この変数はそのローカルチェックのみを無効にするため、ユーザーがアクティブであることをサーバーが検出した場合は、サーバーが引き続きモバイルプッシュを抑制することがあります。Claude Code v2.1.193 以降が必要です |280| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | `1` に設定すると、ターミナルで入力中またはターミナルにフォーカスしている間でも、`PushNotification` ツールのデスクトップ通知を送信します。デフォルトでは、最近のキーボード操作やターミナルのフォーカスを検出すると、ツールはデスクトップ通知と[モバイルプッシュ](/docs/ja/remote-control#mobile-push-notifications)の両方をスキップします。この変数はそのローカルチェックのみを無効にするため、サーバーはユーザーがアクティブであることを検出した場合、引き続きモバイルプッシュを抑制できます。Claude Code v2.1.193 以降が必要です |

277| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | `1` に設定すると、公式プラグインマーケットプレイスの自動登録を無効にします。Claude Code は、マーケットプレイスを登録しようとするとき(通常はマシンでの最初の対話型起動時)にこの変数を読み取ります。その時点で変数が設定されていると、Claude Code は登録を永続的にスキップします。後で変数の設定を解除しても、スキップは取り消されません。`claude plugin marketplace add anthropics/claude-plugins-official` を実行すると、いつでもマーケットプレイスを登録できます |281| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | `1` に設定すると、公式プラグインマーケットプレイスの自動登録を無効にします。Claude Code は、マーケットプレイスを登録しようとするとき(通常はマシンでの最初の対話型起動時)にこの変数を読み取ります。その時点で変数が設定されている場合、Claude Code は登録を恒久的にスキップします。後で変数の設定を解除しても、スキップは元に戻りません。`claude plugin marketplace add anthropics/claude-plugins-official` を実行すると、いつでもマーケットプレイスを登録できます |

278| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | `1` に設定すると、Claude Code が権限リクエストを Agent SDK の `canUseTool` コールバックに送信するセッションで、Claude Code が[未応答の権限リクエストに対する `Notification` フック](/docs/ja/hooks#notification)を実行しないようにします。Claude Desktop と VS Code 拡張機能は、この方法で Claude Code をホストしています。ターミナルセッションでは効果がありません。Claude Code v2.1.233 以降が必要です |282| `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 以降が必要です |

279| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | `1` に設定すると、システム全体の管理スキルディレクトリからのスキルの読み込みをスキップします。オペレーターがプロビジョニングしたスキルを読み込むべきでないコンテナや CI のセッションに便利です |283| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | `1` に設定すると、システム全体の管理スキルディレクトリからのスキルの読み込みをスキップします。オペレーターがプロビジョニングしたスキルを読み込むべきでないコンテナや CI セッションに便利です |

280| `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 以降が必要です |284| `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 以降が必要です |

281| `CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK` | `1` に設定すると、[安全性分類器がリクエストを警告したときの自動モデル切り替え](/docs/ja/model-config#automatic-model-fallback)をオフにします。これは [`switchModelsOnFlag`](/docs/ja/settings-reference#switchmodelsonflag) 設定が制御する動作です |285| `CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK` | `1` に設定すると、[安全性分類器がリクエストを警告したときの自動モデル切り替え](/docs/ja/model-config#automatic-model-fallback)をオフにします。これは [`switchModelsOnFlag`](/docs/ja/settings-reference#switchmodelsonflag) 設定が制御する動作です |

282| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | `1` に設定すると、アップストリームが構造化出力の `output_config.format` フィールドとそれと対になる `anthropic-beta` 値を拒否する [LLM ゲートウェイ](/docs/ja/llm-gateway-protocol#feature-pass-through)向けに、Claude Code がそれらを送信しないようにします。[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities) がオフにするその他のプレリリース機能はオンのままになります。Claude Code v2.1.288 以降が必要です |286| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | `1` に設定すると、アップストリームが構造化出力の `output_config.format` フィールドとそれと対になる `anthropic-beta` 値を拒否する [LLM ゲートウェイ](/docs/ja/llm-gateway-protocol#feature-pass-through)向けに、Claude Code がそれらを送信しないようにします。[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities) がオフにするその他のプレリリース機能はオンのままになります。Claude Code v2.1.288 以降が必要です |

283| `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 以降が必要です |287| `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 以降が必要です |

284| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | `1` に設定すると、会話のコンテキストに基づくターミナルタイトルの自動更新を無効にします。これにより、[セッションタイトルを生成する](/docs/ja/sessions#name-your-sessions)バックグラウンドの small/fast モデルリクエストもスキップされます |288| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | `1` に設定すると、会話のコンテキストに基づくターミナルタイトルの自動更新を無効にします。これにより、[セッションタイトルを生成する](/docs/ja/sessions#name-your-sessions)バックグラウンドの small/fast モデルへのリクエストもスキップされます |

285| `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、Haiku 5.5、Fable モデルは思考をオフにできないため、どちらの変数でもこれらのモデルの思考はオフになりません。[サードパーティプロバイダー](/docs/ja/third-party-integrations)では、`MAX_THINKING_TOKENS=0` も同様にパラメーターを省略するため、そこでは 2 つの変数は同じように動作します |289| `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、Haiku 5.5、Fable モデルでは思考をオフにできないため、どちらの変数でも思考はオフになりません。[サードパーティプロバイダー](/docs/ja/third-party-integrations)では、`MAX_THINKING_TOKENS=0` も同様にパラメーターを省略するため、2 つの変数の動作は同じになります |

286| `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 以降が必要です |290| `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 以降が必要です |

287| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen)で仮想スクロールを無効にし、トランスクリプト内のすべてのメッセージをレンダリングします。フルスクリーンモードでスクロールすると、メッセージが表示されるべき場所に空白の領域が表示される場合に使用します |291| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen)で仮想スクロールを無効にし、トランスクリプト内のすべてのメッセージをレンダリングします。フルスクリーンモードでスクロールしたときに、メッセージが表示されるべき場所に空白の領域が表示される場合に使用します |

288| `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 以降が必要です |292| `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 以降が必要です |

289| `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 以降が必要です |293| `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 以降が必要です |

290| `CLAUDE_CODE_DISABLE_WORKFLOWS` | `1` に設定すると、[ワークフロー](/docs/ja/workflows#turn-workflows-off)を無効にします。[`disableWorkflows`](/docs/ja/settings-reference#disableworkflows) 設定と同等です |294| `CLAUDE_CODE_DISABLE_WORKFLOWS` | `1` に設定すると、[ワークフロー](/docs/ja/workflows#turn-workflows-off)を無効にします。[`disableWorkflows`](/docs/ja/settings-reference#disableworkflows) 設定と同等です |

291| `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)を参照してください |295| `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)を参照してください |

292| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | `1` に設定すると、セッションの状態を伝える [`session_state_changed`](/docs/ja/agent-sdk/typescript#sdksessionstatechangedmessage) メッセージがメッセージストリームに追加されます。[Agent SDK](/docs/ja/agent-sdk/overview)、または `--print`、`--output-format stream-json`、`--verbose` のすべてが必要です |296| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | `1` に設定すると、セッションの状態を伝える [`session_state_changed`](/docs/ja/agent-sdk/typescript#sdksessionstatechangedmessage) メッセージがメッセージストリームに追加されます。[Agent SDK](/docs/ja/agent-sdk/overview)、または `--print`、`--output-format stream-json`、`--verbose` のすべてが必要です |

293| `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` に設定する必要がありました |297| `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` に設定する必要がありました |

294| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | [セッションの要約](/docs/ja/interactive-mode#session-recap) の利用可否を上書きします。`0` に設定すると、`/config` のトグルに関係なく要約を強制的にオフにします。`1` に設定すると、[`awaySummaryEnabled`](/docs/ja/settings-reference#awaysummaryenabled) が `false` の場合でも要約を強制的にオンにします。設定および `/config` のトグルより優先されます |298| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | [セッションの要約](/docs/ja/interactive-mode#session-recap) の利用可否を上書きします。`0` に設定すると、`/config` のトグルに関係なく要約を強制的にオフにします。`1` に設定すると、[`awaySummaryEnabled`](/docs/ja/settings-reference#awaysummaryenabled) が `false` の場合でも要約を強制的にオンにします。設定および `/config` のトグルよりも優先されます |

295| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | `1` に設定すると、[非対話モード](/docs/ja/headless) でバックグラウンドインストールが完了した後、ターンの境界でプラグインの状態を更新します。更新によってセッションの途中でシステムプロンプトが変わり、そのターンの [プロンプトキャッシュ](/docs/ja/prompt-caching) が無効になるため、デフォルトではオフです |299| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | `1` に設定すると、[非対話モード](/docs/ja/headless) でバックグラウンドインストールが完了した後、ターンの境界でプラグインの状態を更新します。更新によってセッションの途中でシステムプロンプトが変わり、そのターンの [プロンプトキャッシュ](/docs/ja/prompt-caching) が無効になるため、デフォルトではオフです |

296| `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` と組織のプロダクトフィードバックポリシーが優先されます |300| `CLAUDE_CODE_ENABLE_CFC` | `1` に設定すると [Chrome 統合](/docs/ja/chrome) をオンにして CLI セッションを開始し、`0` に設定するとオフにして開始します。[`claudeInChromeDefaultEnabled`](/docs/ja/settings-reference#claudeinchromedefaultenabled) 設定よりも優先されます。`--chrome` および `--no-chrome` フラグは、その両方よりも優先されます。Claude Code は [プロジェクト設定およびローカル設定での `1` を無視します](/docs/ja/chrome#project-settings-can’t-turn-on-chrome) |

297| `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) 接続ではデフォルトでオフです |301| `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` および組織のプロダクトフィードバックポリシーが優先されます |

298| `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) を通じて配信してください |302| `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) 接続ではデフォルトでオフです |

299| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | v2.1.142 で削除されました。このとき、[fast mode](/docs/ja/fast-mode) のデフォルトが Opus 4.6 から Opus 4.7 に移行しました |303| `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) を通じて配信してください |

300| `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) を参照してください |304| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | v2.1.142 で削除されました。このとき [fast mode](/docs/ja/fast-mode) のデフォルトが Opus 4.6 から Opus 4.7 に変わりました |

305| `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) を参照してください |

301| `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) を参照してください |306| `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) を参照してください |

302| `CLAUDE_CODE_ENABLE_TELEMETRY` | `1` に設定すると、メトリクスとログの OpenTelemetry データ収集を有効にします。OTel エクスポーターを設定する前に必要です。シェル、ユーザー設定、または管理設定で設定してください。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[モニタリング](/docs/ja/monitoring-usage) を参照してください |307| `CLAUDE_CODE_ENABLE_TELEMETRY` | `1` に設定すると、メトリクスとログのための OpenTelemetry データ収集を有効にします。OTel エクスポーターを設定する前に必要です。シェル、ユーザー設定、または管理設定で設定してください。[プロジェクト設定およびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[モニタリング](/docs/ja/monitoring-usage) を参照してください |

303| `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 以降が必要です |308| `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 以降が必要です |

304| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | クエリループがアイドル状態になってから自動的に終了するまでの待機時間(ミリ秒)。SDK モードを使用する自動化ワークフローやスクリプトに便利です |309| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | クエリループがアイドル状態になってから自動的に終了するまで待機する時間(ミリ秒)。SDK モードを使用する自動化ワークフローやスクリプトに便利です |

305| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | `1` に設定すると [エージェントチーム](/docs/ja/agent-teams) を有効にします。エージェントチームは実験的機能で、デフォルトでは無効です |310| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | `1` に設定すると [エージェントチーム](/docs/ja/agent-teams) を有効にします。エージェントチームは実験的な機能で、デフォルトでは無効です |

306| `CLAUDE_CODE_EXTRA_BODY` | すべての API リクエストボディのトップレベルにマージする JSON オブジェクト。Claude Code が直接公開していないプロバイダー固有のパラメータを渡すのに便利です。シェルでエクスポートした値は、`claude agents` または `--bg` でディスパッチする [バックグラウンドセッション](/docs/ja/agent-view) にも適用されます。v2.1.206 より前は、バックグラウンドセッションはシェルでエクスポートされた値を無視し、バックグラウンドスーパーバイザープロセスが継承したコピーを使用していました |311| `CLAUDE_CODE_EXTRA_BODY` | すべての API リクエストボディのトップレベルにマージする JSON オブジェクト。Claude Code が直接公開していないプロバイダー固有のパラメーターを渡すのに便利です。シェルでエクスポートした値は、`claude agents` または `--bg` でディスパッチする [バックグラウンドセッション](/docs/ja/agent-view) にも適用されます。v2.1.206 より前は、バックグラウンドセッションはシェルでエクスポートされた値を無視し、バックグラウンドスーパーバイザープロセスが継承したコピーを使用していました |

307| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | ファイル読み取りのデフォルトのトークン制限を上書きします。大きなファイルを全体的に読み取る必要がある場合に便利です |312| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | ファイル読み取りのデフォルトのトークン制限を上書きします。大きなファイル全体を読み取る必要がある場合に便利です |

308| `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 では効果がありません |313| `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 では効果がありません |

309| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | `1` に設定すると、ターミナルが取り消し線をサポートしているのに自動検出されない場合(`TERM_PROGRAM` が転送されない SSH 経由など)に、Claude の応答内の `~~text~~` を強制的に取り消し線で表示します。これがない場合、検出されないターミナルではテキストが取り消し線で表示されず、`~~` マーカーがそのまま表示されます。Claude Code v2.1.186 以降が必要です |314| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | ターミナルが取り消し線をサポートしているものの、`TERM_PROGRAM` が転送されていない SSH 経由など自動検出されない場合に、`1` に設定すると Claude の応答内の `~~text~~` を強制的に取り消し線で表示します。これがない場合、検出されないターミナルではテキストが取り消し線で表示されず、`~~` マーカーがそのまま表示されます。Claude Code v2.1.186 以降が必要です |

310| `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` とは異なり、これはレンダラーを変更しません |315| `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` とは異なり、これはレンダラーを変更しません |

311| `CLAUDE_CODE_FORCE_TERMINAL_IMAGES` | `1` に設定すると、ターミナルが Unicode プレースホルダー付きの kitty グラフィックスプロトコル画像を描画できるのに自動検出されない場合に、[mod の `Image` 要素](/docs/ja/plugins/mods/reference#elements) を画像として描画します。[Claude Code が検出するターミナル](/docs/ja/plugins/mods/gallery#image-and-client) と、tmux や screen 内では役に立たない理由を参照してください |316| `CLAUDE_CODE_FORCE_TERMINAL_IMAGES` | ターミナルが Unicode プレースホルダー付きの kitty グラフィックスプロトコル画像を描画するものの自動検出されない場合に、`1` に設定すると [mod の `Image` 要素](/docs/ja/plugins/mods/reference#elements) を画像として描画します。[Claude Code が検出するターミナル](/docs/ja/plugins/mods/gallery#image-and-client) と、tmux や screen 内では役に立たない理由を参照してください |

312| `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` に設定してください |317| `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` に設定してフォークモードをオンにしてください |

313| `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 以降が必要です |318| `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 以降が必要です |

314| `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 以降が必要です |319| `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 以降が必要です |

315| `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 以降が必要です |320| `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 以降が必要です |

316| `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) を参照してください |321| `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) を参照してください |

317| `CLAUDE_CODE_GLOB_HIDDEN` | `false` に設定すると、Claude が [Glob ツール](/docs/ja/tools-reference#glob-tool-behavior) を呼び出したときの結果からドットファイルを除外します。デフォルトでは含まれます。`@` ファイルのオートコンプリート、`ls`、Grep、Read には影響しません |322| `CLAUDE_CODE_GLOB_HIDDEN` | `false` に設定すると、Claude が [Glob ツール](/docs/ja/tools-reference#glob-tool-behavior) を呼び出したときの結果からドットファイルを除外します。デフォルトでは含まれます。`@` ファイルのオートコンプリート、`ls`、Grep、Read には影響しません |

318| `CLAUDE_CODE_GLOB_NO_IGNORE` | `false` に設定すると、[Glob ツール](/docs/ja/tools-reference#glob-tool-behavior) が `.gitignore` のパターンに従うようになります。デフォルトでは、Glob は gitignore の対象ファイルを含む、一致するすべてのファイルを返します。独自の [`respectGitignore` 設定](/docs/ja/settings-reference#respectgitignore) を持つ `@` ファイルのオートコンプリートには影響しません |323| `CLAUDE_CODE_GLOB_NO_IGNORE` | `false` に設定すると、[Glob ツール](/docs/ja/tools-reference#glob-tool-behavior) が `.gitignore` パターンに従うようになります。デフォルトでは、Glob は gitignore されたファイルを含め、一致するすべてのファイルを返します。独自の [`respectGitignore` 設定](/docs/ja/settings-reference#respectgitignore) を持つ `@` ファイルのオートコンプリートには影響しません |

319| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Glob ツールのファイル検出のタイムアウト(秒)。ほとんどのプラットフォームではデフォルトで 20 秒、WSL では 60 秒です |324| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Glob ツールのファイル検出のタイムアウト(秒)。デフォルトはほとんどのプラットフォームで 20 秒、WSL で 60 秒です |

320| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | バックグラウンド作業がアクティブなゴールを待機させておける時間(分)。この時間を過ぎると、Claude Code は [Claude に確認を求めます](/docs/ja/goal#background-work-defers-evaluation)。デフォルトは `30` です。`0` に設定するとチェックインをオフにします。整数の分を数字のみで指定し、最大は 1 週間にあたる `10080` です。Claude Code はその他の値を未設定として扱い、デフォルトを使用します。Claude Code v2.1.234 以降が必要です |325| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Claude Code が [Claude に確認を求める](/docs/ja/goal#background-work-defers-evaluation) までに、バックグラウンド作業がアクティブなゴールを待たせることのできる時間(分)。デフォルトは `30` です。`0` に設定するとチェックインをオフにします。整数の分を数字のみで指定し、最大値は 1 週間にあたる `10080` です。Claude Code はそれ以外の値を未設定として扱い、デフォルトを使用します。Claude Code v2.1.234 以降が必要です |

321| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | `0` に設定すると、`api.anthropic.com` に送信される Claude API、テレメトリ、[アーティファクト](/docs/ja/artifacts) 公開のリクエストボディの gzip 圧縮をオフにします。デフォルトでは、Claude Code は直接接続では大きなリクエストボディを圧縮し、プロキシ経由でリクエストを送信する場合、クライアント証明書を設定した場合、または `NODE_EXTRA_CA_CERTS` を設定した場合は圧縮をスキップします。Claude Code が検出できない [TLS 検査プロキシ](/docs/ja/network-config#ca-certificate-store) が圧縮されたリクエストを正しく処理できない場合は `0` を使用してください |326| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | `0` に設定すると、`api.anthropic.com` に送信される Claude API、テレメトリ、[アーティファクト](/docs/ja/artifacts) 公開のリクエストボディの gzip 圧縮をオフにします。デフォルトでは、Claude Code は直接接続では大きなリクエストボディを圧縮し、プロキシ経由でリクエストを送信する場合、クライアント証明書を設定した場合、または `NODE_EXTRA_CA_CERTS` を設定した場合は圧縮をスキップします。Claude Code が検出できない [TLS 検査プロキシ](/docs/ja/network-config#ca-certificate-store) が圧縮されたリクエストを正しく処理できない場合は `0` を使用してください |

322| `CLAUDE_CODE_HIDE_CWD` | `1` に設定すると、起動時のロゴに作業ディレクトリを表示しません。パスから OS のユーザー名がわかってしまう画面共有や録画の際に便利です |327| `CLAUDE_CODE_HIDE_CWD` | `1` に設定すると、起動時のロゴに作業ディレクトリを表示しません。パスから OS のユーザー名がわかってしまう画面共有や録画に便利です |

323| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | IDE 拡張機能への接続に使用するホストアドレスを上書きします。デフォルトでは、Claude Code は WSL から Windows へのルーティングを含め、正しいアドレスを自動検出します |328| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | IDE 拡張機能への接続に使用するホストアドレスを上書きします。デフォルトでは、Claude Code は WSL から Windows へのルーティングを含め、正しいアドレスを自動検出します |

324| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | `1` に設定すると、IDE 拡張機能の自動インストールをスキップします。[`autoInstallIdeExtension`](/docs/ja/settings-reference#autoinstallideextension) を `false` に設定するのと同じです |329| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | `1` に設定すると、IDE 拡張機能の自動インストールをスキップします。[`autoInstallIdeExtension`](/docs/ja/settings-reference#autoinstallideextension) を `false` に設定するのと同等です |

325| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | `1` に設定すると、接続時の IDE ロックファイルエントリの検証をスキップします。IDE が実行中なのに自動接続で見つからない場合に使用します |330| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | `1` に設定すると、接続時の IDE ロックファイルエントリの検証をスキップします。IDE が実行中にもかかわらず、自動接続で IDE が見つからない場合に使用します |

326| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Agent ツールが新たな生成を拒否するまでに、1 つのセッションで同時に実行できる [サブエージェント](/docs/ja/sub-agents#concurrent-subagent-limit) の数(デフォルト: 20)。数字のみで表した正の整数を受け付けます。それ以外の値は無視されるため、この変数で上限を調整することはできますが、無効にすることはできません。Claude Code v2.1.217 以降が必要です |331| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Agent ツールが新たな生成を拒否するまでに、1 つのセッションで同時に実行できる [サブエージェント](/docs/ja/sub-agents#concurrent-subagent-limit) の数(デフォルト: 20)。正の整数を数字のみで受け付けます。それ以外の値は無視されるため、この変数で上限を調整することはできますが、無効にすることはできません。Claude Code v2.1.217 以降が必要です |

327| `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` を介して、コンテキストウィンドウがその名前に対応する組み込みサイズと一致しないモデルにルーティングする場合に使用します |332| `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` を介してルーティングするモデルのコンテキストウィンドウが、その名前に対応する組み込みのサイズと一致しない場合に使用します |

328| `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 以降が必要です |333| `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 以降が必要です |

329| `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) がトリガーされるまでに利用できる実質的なコンテキストウィンドウが小さくなります |334| `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) が発生するまでに利用できる実質的なコンテキストウィンドウが小さくなります |

330| `CLAUDE_CODE_MAX_RETRIES` | 失敗した API リクエストを再試行する回数を上書きします(デフォルト: 10)。v2.1.186 以降は 15 が上限です。v2.1.199 以降は、`CLAUDE_CODE_RETRY_WATCHDOG` によってデフォルトが引き上げられ、上限が撤廃されます。より長い障害の間も待機し続ける必要がある無人セッションでは、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を設定してください |335| `CLAUDE_CODE_MAX_RETRIES` | 失敗した API リクエストを再試行する回数を上書きします(デフォルト: 10)。v2.1.186 以降は上限が 15 です。v2.1.199 以降は、`CLAUDE_CODE_RETRY_WATCHDOG` によってデフォルトが引き上げられ、上限が撤廃されます。より長い障害を待ち続ける必要がある無人セッションでは、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を設定してください |

331| `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) は引き続き適用されます |336| `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) は引き続き適用されます |

332| `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 以降が必要です |337| `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 以降が必要です |

333| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 並列実行できる読み取り専用ツールとサブエージェントの最大数(デフォルト: 10)。値を大きくすると並列性が高まりますが、より多くのリソースを消費します |338| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 並列に実行できる読み取り専用ツールおよびサブエージェントの最大数(デフォルト: 10)。値を大きくすると並列性が高まりますが、より多くのリソースを消費します |

334| `CLAUDE_CODE_MAX_TURNS` | 明示的な制限が渡されていない場合のエージェントターン数の上限。[`--max-turns`](/docs/ja/cli-reference#cli-flags) を渡すのと同じで、両方が設定されている場合はフラグが優先されます。正の整数でない値は、上限なしとして扱われるのではなく、起動時にエラーで拒否されます |339| `CLAUDE_CODE_MAX_TURNS` | 明示的な制限が渡されていない場合のエージェントターン数の上限。[`--max-turns`](/docs/ja/cli-reference#cli-flags) を渡すのと同等で、両方が設定されている場合はフラグが優先されます。正の整数でない値は、上限なしとして扱われるのではなく、起動時にエラーで拒否されます |

335| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | [WebSearch](/docs/ja/tools-reference#session-search-limit) 呼び出しの上限(デフォルト: 200)。Claude が上限に達すると、以降の WebSearch 呼び出しは、すでに収集した情報で続行するよう伝える通知を返します。正の整数を受け付け、指定できる値に上限はありません。それ以外の値は無視されてデフォルトが適用されるため、上限を引き上げることはできますが、オフにすることはできません。Claude Code v2.1.212 以降が必要です |340| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | [WebSearch](/docs/ja/tools-reference#session-search-limit) 呼び出しの上限(デフォルト: 200)。Claude が上限に達すると、以降の WebSearch 呼び出しは、すでに収集した情報で作業を続けるよう伝える通知を返します。正の整数を受け付け、値に上限はありません。それ以外の値は無視されてデフォルトが適用されるため、上限を引き上げることはできますが、オフにすることはできません。Claude Code v2.1.212 以降が必要です |

336| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | `1` に設定すると、シェル環境を継承する代わりに、安全なベースライン環境とサーバーに設定された `env` のみで stdio MCP サーバーを起動します |341| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | `1` に設定すると、シェル環境を継承する代わりに、安全な最小限のベースライン環境とサーバーに設定された `env` のみで stdio MCP サーバーを起動します |

337| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | 実行中の MCP ツール呼び出しが [バックグラウンドタスクに移行する](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) までの経過時間(ミリ秒、デフォルト: 120000、つまり 2 分)。`0` に設定すると自動バックグラウンド化をオフにします。Claude Code v2.1.212 以降が必要です |342| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | 実行中の MCP ツール呼び出しが [バックグラウンドタスクに移行する](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) までの経過時間(ミリ秒)(デフォルト: 120000、つまり 2 分)。`0` に設定すると自動バックグラウンド化をオフにします。Claude Code v2.1.212 以降が必要です |

338| `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 以降が必要です |343| `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 以降が必要です |

339| `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 サーバーはアイドルタイムアウトの対象外でした |344| `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 サーバーはアイドルタイムアウトの対象外でした |

340| `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 以降が必要です |345| `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 以降が必要です |

341| `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 以降が必要です |346| `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 がトークンを参照するタイミングは、[own-child ルール](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) で定められています。各セッションは独自のトークンをエクスポートし、親セッションから継承したトークンをエクスポートすることはありません。設定の `env` ブロックではこれを設定できません。Claude Code v2.1.228 以降が必要です |

342| `CLAUDE_CODE_NATIVE_CURSOR` | `1` に設定すると、描画されたブロックの代わりに、ターミナル自身のカーソルを入力キャレットの位置に表示します。カーソルはターミナルの点滅、形状、フォーカスの設定に従います。`0` に設定しても変数を未設定のままにした場合と同じ扱いになるため、ターミナル自身のカーソルがすでにオンになっているセッションで描画されたブロックが戻ることはありません |347| `CLAUDE_CODE_NATIVE_CURSOR` | `1` に設定すると、描画されたブロックの代わりに、入力キャレットの位置にターミナル自身のカーソルを表示します。カーソルはターミナルの点滅、形状、フォーカスの設定に従います。`0` に設定しても変数を未設定のままにした場合と同じ扱いになるため、ターミナル自身のカーソルがすでにオンになっているセッションで描画されたブロックが戻ることはありません |

343| `CLAUDE_CODE_NEW_INIT` | `1` に設定すると、`/init` で対話的なセットアップフローを実行します。このフローでは、コードベースを調べてファイルを書き込む前に、CLAUDE.md、スキル、フックなど、どのファイルを生成するかを尋ねます。この変数がない場合、`/init` は確認なしで CLAUDE.md を自動的に生成します |348| `CLAUDE_CODE_NEW_INIT` | `1` に設定すると、`/init` で対話的なセットアップフローを実行します。このフローでは、コードベースを探索してファイルを書き込む前に、CLAUDE.md、スキル、フックなど、どのファイルを生成するかを尋ねます。この変数がない場合、`/init` は確認なしで CLAUDE.md を自動生成します |

344| `CLAUDE_CODE_NONBLOCKING_STDOUT` | `1` に設定すると、2 つ目のノンブロッキングファイルディスクリプタを通じてターミナル出力を書き込みます。これにより、一時停止した tmux コントロールモードのペインや停止した SSH 接続など、読み取りを停止したターミナルが原因でセッションの途中に Claude Code がフリーズすることを防げます。stdout がターミナルの場合に、macOS、Linux、WSL で適用されます。Claude Code v2.1.261 以降が必要です |349| `CLAUDE_CODE_NONBLOCKING_STDOUT` | `1` に設定すると、ターミナル出力を 2 つ目のノンブロッキングファイルディスクリプタ経由で書き込みます。これにより、一時停止した tmux コントロールモードのペインや停止した SSH 接続など、読み取りを停止したターミナルによって Claude Code がセッションの途中でフリーズすることがなくなります。stdout がターミナルである場合に、macOS、Linux、WSL で適用されます。Claude Code v2.1.261 以降が必要です |

345| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | タイムアウトした [非ストリーミングリクエスト](/docs/ja/errors#streaming-response-ended-before-any-complete-data-was-received) を Claude Code が再送信する回数を制限します。`0` の場合、リクエストは最初のタイムアウトで失敗します。タイムアウトについては [再試行の動作を調整する](/docs/ja/errors#tune-retry-behavior) を参照してください。Claude Code v2.1.285 以降が必要です |350| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | タイムアウトした [非ストリーミングリクエスト](/docs/ja/errors#streaming-response-ended-before-any-complete-data-was-received) を Claude Code が再送信する回数を制限します。`0` の場合、最初のタイムアウトでリクエストは失敗します。タイムアウトについては [再試行の動作を調整する](/docs/ja/errors#tune-retry-behavior) を参照してください。Claude Code v2.1.285 以降が必要です |

346| `CLAUDE_CODE_NO_FLICKER` | `1` に設定すると、[フルスクリーンレンダリング](/docs/ja/fullscreen) を有効にします。これはちらつきを減らし、長い会話でもメモリ使用量を一定に保つリサーチプレビューです。[`tui`](/docs/ja/settings-reference#tui) 設定を上書きします。`/tui fullscreen` で切り替えることもできます |351| `CLAUDE_CODE_NO_FLICKER` | `1` に設定すると、ちらつきを減らし、長い会話でもメモリ使用量を一定に保つリサーチプレビューである [フルスクリーンレンダリング](/docs/ja/fullscreen) を有効にします。[`tui`](/docs/ja/settings-reference#tui) 設定を上書きします。`/tui fullscreen` で切り替えることもできます |

347| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 認証用の OAuth リフレッシュトークン。設定すると、`claude auth login` はブラウザを開く代わりにこのトークンを直接交換します。`CLAUDE_CODE_OAUTH_SCOPES` が必要です。自動化環境で認証をプロビジョニングする場合に便利です |352| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 認証用の OAuth リフレッシュトークン。設定すると、`claude auth login` はブラウザを開く代わりにこのトークンを直接交換します。`CLAUDE_CODE_OAUTH_SCOPES` が必要です。自動化された環境で認証をプロビジョニングするのに便利です |

348| `CLAUDE_CODE_OAUTH_SCOPES` | リフレッシュトークンの発行時に付与された、スペース区切りの OAuth スコープ(`"user:profile user:inference user:sessions:claude_code"` など)。`CLAUDE_CODE_OAUTH_REFRESH_TOKEN` が設定されている場合に必要です |353| `CLAUDE_CODE_OAUTH_SCOPES` | リフレッシュトークンの発行時に指定された、スペース区切りの OAuth スコープ(`"user:profile user:inference user:sessions:claude_code"` など)。`CLAUDE_CODE_OAUTH_REFRESH_TOKEN` を設定する場合に必要です |

349| `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 はセッション全体を通じて設定したトークンを使用します。期限切れのトークンを置き換えるには、新しいトークンを生成して再起動してください |354| `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 はセッション全体を通じて設定したトークンを使用します。期限切れのトークンを置き換えるには、新しいトークンを生成して再起動してください |

350| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | v2.1.160 で削除され、現在は何もしません。以前は、現在のデフォルトではなく Claude Opus 4.6 に [fast mode](/docs/ja/fast-mode) を固定していました。Opus 4.6 は fast mode をサポートしなくなりました |355| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | v2.1.160 で削除され、現在は何も行いません。以前は、現在のデフォルトではなく Claude Opus 4.6 に [fast mode](/docs/ja/fast-mode) を固定していました。Opus 4.6 は fast mode をサポートしなくなりました |

351| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツを含む OpenTelemetry 属性(モデルの応答、ツールのコンテンツ、システムプロンプト、生の API ボディ)の最大長。切り詰めマーカーを含み、UTF-16 コードユニット単位です(デフォルト: 61440、つまり 60 KB)。テレメトリバックエンドが 64 KB より大きい属性値を受け付ける場合にのみ値を上げてください。テレメトリ量を減らすには値を下げてください。Claude Code v2.1.214 以降が必要です。[モニタリング](/docs/ja/monitoring-usage) を参照してください |356| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツを含む OpenTelemetry 属性(モデルの応答、ツールのコンテンツ、システムプロンプト、生の API ボディ)の最大長。切り詰めマーカーを含み、UTF-16 コードユニット単位です(デフォルト: 61440、つまり 60 KB)。テレメトリバックエンドが 64 KB を超える属性値を受け付ける場合にのみ値を増やし、テレメトリの量を減らす場合は値を小さくしてください。Claude Code v2.1.214 以降が必要です。[モニタリング](/docs/ja/monitoring-usage) を参照してください |

352| `CLAUDE_CODE_OTEL_DIAG_STDERR` | `1` に設定すると、OpenTelemetry エクスポーターの診断エラーを stderr に書き込みます。デフォルトではこれらのエラーは `--debug` でのみ表示されるため、Prometheus のポート衝突など設定に誤りのあるエクスポーターは、そのままでは何も表示されずに失敗します。Claude Code v2.1.179 以降が必要です。[モニタリング](/docs/ja/monitoring-usage) を参照してください |357| `CLAUDE_CODE_OTEL_DIAG_STDERR` | `1` に設定すると、OpenTelemetry エクスポーターの診断エラーを stderr に書き込みます。デフォルトではこれらのエラーは `--debug` の使用時にのみ表示されるため、Prometheus のポート衝突など設定に誤りのあるエクスポーターは、これを設定しないと何も表示されずに失敗します。Claude Code v2.1.179 以降が必要です。[モニタリング](/docs/ja/monitoring-usage) を参照してください |

353| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 保留中の OpenTelemetry スパンをフラッシュする際のタイムアウト(ミリ秒、デフォルト: 5000)。[モニタリング](/docs/ja/monitoring-usage) を参照してください |358| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 保留中の OpenTelemetry スパンをフラッシュする際のタイムアウト(ミリ秒)(デフォルト: 5000)。[モニタリング](/docs/ja/monitoring-usage) を参照してください |

354| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的な OpenTelemetry ヘッダーを更新する間隔(ミリ秒、デフォルト: 1740000 / 29 分)。[動的ヘッダー](/docs/ja/monitoring-usage#dynamic-headers) を参照してください |359| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的な OpenTelemetry ヘッダーを更新する間隔(ミリ秒)(デフォルト: 1740000 / 29 分)。[動的ヘッダー](/docs/ja/monitoring-usage#dynamic-headers) を参照してください |

355| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | シャットダウン時に OpenTelemetry エクスポーターが処理を完了するまでのタイムアウト(ミリ秒、デフォルト: 2000)。終了時にメトリクスが欠落する場合は値を増やしてください。[モニタリング](/docs/ja/monitoring-usage) を参照してください |360| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | シャットダウン時に OpenTelemetry エクスポーターが完了するまでのタイムアウト(ミリ秒)(デフォルト: 2000)。終了時にメトリクスが失われる場合は値を増やしてください。[モニタリング](/docs/ja/monitoring-usage) を参照してください |

356| `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS` | API が `529` 過負荷エラーで拒否したリクエストの [自動再試行](/docs/ja/errors#tune-retry-behavior) の間の指数バックオフにおける初期遅延(ミリ秒)。デフォルトの 500 の代わりに使用されます。API が容量の上限に達しているときに、再試行をより長い時間枠に分散させるには値を上げてください。500 から 32000 までの整数のミリ秒を数字のみで指定します。Claude Code はその他の値を未設定として扱います。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.292 以降が必要です |361| `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS` | API が `529` 過負荷エラーで拒否したリクエストの [自動再試行](/docs/ja/errors#tune-retry-behavior) の間の指数バックオフの開始遅延(ミリ秒)。デフォルトの 500 の代わりに使用されます。API の容量が逼迫しているときに、より長い時間枠に再試行を分散させるには値を増やしてください。500 から 32000 までの整数のミリ秒を数字のみで指定します。Claude Code はそれ以外の値を未設定として扱います。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.292 以降が必要です |

357| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | `1` に設定すると、新しいバージョンが利用可能な場合に、Claude Code がパッケージマネージャーのアップグレードコマンドをバックグラウンドで実行できるようにします。Homebrew と WinGet のインストールに適用されます。その他のパッケージマネージャーでは、引き続きアップグレードコマンドを実行せずに表示します。[自動更新](/docs/ja/setup#auto-updates) を参照してください |362| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | `1` に設定すると、新しいバージョンが利用可能になったときに、Claude Code がパッケージマネージャーのアップグレードコマンドをバックグラウンドで実行できるようにします。Homebrew および WinGet でのインストールに適用されます。その他のパッケージマネージャーでは、引き続きアップグレードコマンドが実行されずに表示されます。[自動更新](/docs/ja/setup#auto-updates) を参照してください |

358| `CLAUDE_CODE_PERFORCE_MODE` | `1` に設定すると、Perforce 対応の書き込み保護を有効にします。設定すると、対象ファイルに所有者の書き込みビットがない場合、Edit、Write、NotebookEdit は `p4 edit <file>` のヒントとともに失敗します。Perforce は同期されたファイルについて、`p4 edit` で開くまでこのビットをクリアします。これにより、Claude Code が Perforce の変更追跡を迂回することを防ぎます |363| `CLAUDE_CODE_PERFORCE_MODE` | `1` に設定すると、Perforce 対応の書き込み保護を有効にします。設定すると、対象ファイルに所有者の書き込みビットがない場合、Edit、Write、NotebookEdit は `p4 edit <file>` のヒントを表示して失敗します。Perforce は、同期されたファイルを `p4 edit` で開くまでこのビットをクリアします。これにより、Claude Code が Perforce の変更追跡をバイパスすることを防ぎます |

359| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | プラグインのルートディレクトリを上書きします。名前に反して、これはキャッシュ自体ではなく親ディレクトリを設定します。マーケットプレイスとプラグインキャッシュは、このパスの下のサブディレクトリに置かれます。デフォルトは `~/.claude/plugins` です |364| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | プラグインのルートディレクトリを上書きします。名前に反して、これはキャッシュ自体ではなく親ディレクトリを設定します。マーケットプレイスとプラグインキャッシュは、このパスの下のサブディレクトリに配置されます。デフォルトは `~/.claude/plugins` です |

360| `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) を参照してください |365| `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) を参照してください |

361| `CLAUDE_CODE_PLUGIN_DIR_WATCH` | mod のファイルが変更されたときに、Claude Code が [mod](/docs/ja/plugins/mods/overview) を再読み込みするかどうかを制御します。再読み込みは `--plugin-dir` でディレクトリから読み込んだ mod に適用され、対話セッションではデフォルトでオンです。`1` に設定すると非対話セッションでもオンにし、`0` に設定するとすべてのセッションでオフにします。Claude Code v2.1.287 以降が必要です。[mod の設定と環境変数](/docs/ja/plugins/mods/reference#settings-and-environment-variables) を参照してください |366| `CLAUDE_CODE_PLUGIN_DIR_WATCH` | [mod](/docs/ja/plugins/mods/overview) のファイルが変更されたときに、Claude Code が mod を再読み込みするかどうかを制御します。再読み込みは `--plugin-dir` でディレクトリから読み込んだ mod に適用され、対話セッションではデフォルトでオンです。`1` に設定すると非対話セッションでもオンになり、`0` に設定するとすべてのセッションでオフになります。Claude Code v2.1.287 以降が必要です。[mod の設定と環境変数](/docs/ja/plugins/mods/reference#settings-and-environment-variables) を参照してください |

362| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | プラグインマーケットプレイスのクローンまたは更新のタイムアウト(ミリ秒、デフォルト: 120000)。大きなリポジトリや低速なネットワーク接続の場合は値を増やしてください。[Git clone timed out](/docs/ja/plugins/troubleshooting#git-clone-timed-out-after-120s) を参照してください |367| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | プラグインマーケットプレイスのクローンまたは更新のタイムアウト(ミリ秒)(デフォルト: 120000)。大きなリポジトリや低速なネットワーク接続の場合は、この値を増やしてください。[Git clone timed out](/docs/ja/plugins/troubleshooting#git-clone-timed-out-after-120s) を参照してください |

363| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | `1` に設定すると、マーケットプレイスの更新でリモートに到達できないか認証できない場合に、再クローンの試行をスキップして既存のマーケットプレイスのチェックアウトを引き続き使用します。再クローンしても同じように失敗するオフライン環境やエアギャップ環境で便利です。[オフライン環境でマーケットプレイスの更新が失敗する](/docs/ja/plugins/troubleshooting#marketplace-updates-keep-failing-offline) を参照してください |368| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | `1` に設定すると、マーケットプレイスの更新でリモートに到達できないか認証できない場合に、再クローンの試行をスキップして既存のマーケットプレイスのチェックアウトを使い続けます。再クローンしても同じように失敗するオフライン環境やエアギャップ環境で便利です。[オフライン環境でマーケットプレイスの更新が失敗する](/docs/ja/plugins/troubleshooting#marketplace-updates-keep-failing-offline) を参照してください |

364| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | `1` に設定すると、GitHub の `owner/repo` 省略形のソースを SSH ではなく HTTPS でクローンします。プラグインのインストールと更新、および `/plugin marketplace add` と `update` に適用されます。CI ランナー、コンテナ、または `github.com` 用の SSH キーが設定されていない環境で便利です |369| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | `1` に設定すると、GitHub の `owner/repo` 短縮形のソースを SSH ではなく HTTPS でクローンします。プラグインのインストールと更新、および `/plugin marketplace add` と `update` に適用されます。CI ランナー、コンテナ、または `github.com` 用の SSH キーが設定されていない環境で便利です |

365| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 1 つ以上の読み取り専用プラグインシードディレクトリへのパス。Unix では `:`、Windows では `;` で区切ります。事前に内容を用意したプラグインディレクトリをコンテナイメージにバンドルする場合に使用します。Claude Code は起動時にこれらのディレクトリからマーケットプレイスを登録し、事前キャッシュされたプラグインを再クローンせずに使用します。[コンテナ用にプラグインを事前に用意する](/docs/ja/plugins/org#seed-containers-and-ci) を参照してください |370| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 1 つ以上の読み取り専用プラグインシードディレクトリへのパス。Unix では `:`、Windows では `;` で区切ります。事前に作成したプラグインディレクトリをコンテナイメージにバンドルする場合に使用します。Claude Code は起動時にこれらのディレクトリからマーケットプレイスを登録し、事前にキャッシュされたプラグインを再クローンせずに使用します。[コンテナ用にプラグインを事前に用意する](/docs/ja/plugins/org#seed-containers-and-ci) を参照してください |

366| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | `1` に設定すると、ツール呼び出し、フック、ステータスラインのコマンドのために PowerShell を起動する際に Claude Code が `-ExecutionPolicy Bypass` を渡さないようにし、代わりにマシンの実効実行ポリシーに従います。デフォルトでは、Claude Code はプロセススコープで実行ポリシーをバイパスするため、デフォルトで Restricted の Windows 環境でも `.ps1` スクリプトとモジュールのインポートが動作します。この設定に関係なく、プロセススコープのバイパスがグループポリシーの `MachinePolicy` や `UserPolicy` を上書きすることはありません |371| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | `1` に設定すると、ツール呼び出し、フック、ステータスラインコマンドのために PowerShell を起動する際に Claude Code が `-ExecutionPolicy Bypass` を渡すのをやめ、代わりにマシンの実効的な実行ポリシーに従います。デフォルトでは、既定で Restricted になっている Windows 環境でも `.ps1` スクリプトやモジュールのインポートが動作するように、Claude Code はプロセススコープで実行ポリシーをバイパスします。この設定に関係なく、プロセススコープのバイパスがグループポリシーの `MachinePolicy` や `UserPolicy` を上書きすることはありません |

367| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | `-p` フラグを使用した [非対話モード](/docs/ja/headless#background-tasks-at-exit) で、最後のターンの後にサブエージェントやワークフローなどのバックグラウンド作業をアイドル待機する時間の上限(ミリ秒)。Claude がバックグラウンドの結果を処理するためにターンを実行するたびに、アイドル待機はリセットされます。デフォルト: `600000`、つまり 10 分。アイドル待機が上限に達すると、Claude Code は残りのバックグラウンドタスクの待機を停止します。メイン会話が開始した実行中のバックグラウンドコマンドがある場合、実行は上限を過ぎても継続されます。`0` に設定すると無期限に待機します。Claude Code v2.1.182 以降が必要です |372| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | `-p` フラグを使用した [非対話モード](/docs/ja/headless#background-tasks-at-exit) で、最後のターンの後に、サブエージェントやワークフローなどのバックグラウンド作業をアイドル状態で待機する時間の上限(ミリ秒)。Claude がバックグラウンドの結果を処理するためにターンを実行するたびに、アイドル待機は最初からやり直しになります。デフォルト: `600000`、つまり 10 分。アイドル待機が上限に達すると、Claude Code は残りのバックグラウンドタスクの待機を停止します。メインの会話が開始したバックグラウンドコマンドが実行中の場合は、上限を過ぎても実行は終了しません。`0` に設定すると無期限に待機します。Claude Code v2.1.182 以降が必要です |

368| `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 以降が必要です |373| `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 以降が必要です |

369| `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 以降が必要です |374| `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 以降が必要です |

370| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Claude Code が受け付ける唯一の値である `5m` または `1h` を設定して、メイン会話の [プロンプトキャッシュの 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 以降が必要です |375| `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 以降が必要です |

371| `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) を参照してください |376| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | `ANTHROPIC_BASE_URL` がカスタムプロキシを指している場合に、`1` に設定すると W3C トレースコンテキストを伝播します。伝播の対象は、モデルおよび HTTP MCP リクエストの `traceparent` ヘッダーと、Bash、PowerShell、フックのサブプロセス向けの `TRACEPARENT` 環境変数です。デフォルトでは、伝播は Anthropic API に直接接続している場合にのみ有効です。v2.1.152 で追加されました。[トレース(ベータ)](/docs/ja/monitoring-usage#traces-beta) を参照してください |

372| `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` などのモデル選択キーを、どの管理ソースから配信されたかに関係なく無視するため、ホストのモデル設定が古い管理設定のモデル固定より優先されます。また、管理設定の `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) を参照してください |377| `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) を参照してください |

373| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | `1` に設定すると、呼び出し元ではなくプロキシが DNS 解決を実行できるようにします。プロキシがホスト名の解決を処理すべき環境向けのオプトイン設定です |378| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | `1` に設定すると、呼び出し元ではなくプロキシが DNS 解決を実行できるようにします。プロキシがホスト名の解決を処理すべき環境向けのオプトイン設定です |

374| `CLAUDE_CODE_REMOTE` | Claude Code が [クラウドセッション](/docs/ja/claude-code-on-the-web) として実行されている場合に、自動的に `true` に設定されます。フックまたはセットアップスクリプトからこれを読み取ると、クラウドセッション内にいるかどうかを検出できます |379| `CLAUDE_CODE_REMOTE` | Claude Code が [クラウドセッション](/docs/ja/claude-code-on-the-web) として実行されている場合に、自動的に `true` に設定されます。フックやセットアップスクリプトからこれを読み取ることで、クラウドセッション内にいるかどうかを検出できます |

375| `CLAUDE_CODE_REMOTE_SESSION_ID` | [クラウドセッション](/docs/ja/claude-code-on-the-web) で、現在のセッションの ID に自動的に設定されます。これを読み取って、セッションのトランスクリプトへのリンクを作成できます。[出力をセッションにリンクする](/docs/ja/cloud-environments#link-output-back-to-the-session) を参照してください |380| `CLAUDE_CODE_REMOTE_SESSION_ID` | [クラウドセッション](/docs/ja/claude-code-on-the-web) で、現在のセッションの ID に自動的に設定されます。これを読み取って、セッションのトランスクリプトへのリンクを作成できます。[出力をセッションにリンクする](/docs/ja/cloud-environments#link-output-back-to-the-session) を参照してください |

376| `CLAUDE_CODE_RESTRICTED` | `1` に設定すると、[`--restricted`](/docs/ja/cli-reference#cli-flags) を渡した場合と同様に、制限モードでセッションを開始します。Claude Code は設定ファイルの `env` ブロック内のこの変数を無視します。Claude Code v2.1.248 以降が必要です |381| `CLAUDE_CODE_RESTRICTED` | `1` に設定すると、[`--restricted`](/docs/ja/cli-reference#cli-flags) を渡した場合と同様に、制限モードでセッションを開始します。Claude Code は設定ファイルの `env` ブロック内のこの変数を無視します。Claude Code v2.1.248 以降が必要です |

377| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | `1` に設定すると、前のセッションがターンの途中で終了した場合に自動的に再開します。SDK モードで使用され、SDK がプロンプトを再送信しなくてもモデルが続行できるようにします。オフにするには、変数の設定を解除するか `0` に設定します。VS Code のチャットパネルについては、[再読み込み後に会話を続ける](/docs/ja/vs-code#continue-conversations-after-a-reload) を参照してください |382| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | `1` に設定すると、前のセッションがターンの途中で終了した場合に自動的に再開します。SDK モードで使用され、SDK がプロンプトを再送信しなくてもモデルが続行できるようにします。これをオフにするには、変数を未設定にするか `0` に設定してください。VS Code のチャットパネルについては、[再読み込み後に会話を続ける](/docs/ja/vs-code#continue-conversations-after-a-reload) を参照してください |

378| `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 以降が必要です |383| `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 以降が必要です |

379| `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.` です。空文字列の場合はデフォルトが使用されます |384| `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.` です。空の文字列を指定するとデフォルトが使用されます |

380| `CLAUDE_CODE_RETRY_WATCHDOG` | eval ハーネス、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 以降が必要です |385| `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 以降が必要です |

381| `CLAUDE_CODE_SAFE_MODE` | `1` に設定すると、セーフモードで起動します。壊れた設定のトラブルシューティングのために、CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーボードショートカット、ステータスラインとファイル候補のコマンド、LSP サーバー、自動メモリを読み込みません。ポリシーで設定されたフック、ステータスライン、ファイル候補のコマンドを含め、管理設定のポリシーは引き続き適用されます。管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシーで設定された MCP サーバーは適用されません。[`--safe-mode`](/docs/ja/cli-reference#cli-flags) を渡すのと同じです。直接起動された子プロセスはこの変数を継承します |386| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS` | `CLAUDE_CODE_RETRY_WATCHDOG` が設定されている場合に、各 API リクエストが `429` および `529` エラーをやり過ごすために待機する最大時間(ミリ秒)。その時間を使い切ると、次に同様のエラーが発生した時点でリクエストは終了します。30 分を表す `1800000` のように、正の整数を数字のみで指定します。未設定の場合、待機時間に制限はありません。Claude Code v2.1.295 以降が必要です |

382| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が設定されている場合に、特定のスクリプトをセッションごとに呼び出せる回数を制限する JSON オブジェクト。キーはコマンドテキストと照合される部分文字列で、値は整数の呼び出し制限です。たとえば、`{"deploy.sh": 2}` では `deploy.sh` を最大 2 回まで呼び出せます。照合は部分文字列ベースのため、`./scripts/deploy.sh $(evil)` のようなシェル展開のトリックも上限にカウントされます。`xargs` や `find -exec` による実行時のファンアウトは検出されません。これは多層防御のための制御です |387| `CLAUDE_CODE_SAFE_MODE` | `1` に設定するとセーフモードで起動します。壊れた設定のトラブルシューティングのために、CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーボードショートカット、ステータスラインおよびファイル候補のコマンド、LSP サーバー、自動メモリが読み込まれません。ポリシーで設定されたフック、ステータスライン、ファイル候補のコマンドを含め、管理設定のポリシーは引き続き適用されます。管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシーで設定された MCP サーバーは適用されません。[`--safe-mode`](/docs/ja/cli-reference#cli-flags) を渡すのと同等です。直接起動された子プロセスはこの変数を継承します |

383| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリーンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling) でのマウスホイールのスクロール倍率を設定します。20 までの任意の正の値を受け付けます。ホイールイベントをすでに増幅するターミナルで、加速されたトラックパッドやホイールのスクロールを遅くするための `0.5` など、1 未満の小数値も指定できます。ターミナルが増幅せずにノッチごとに 1 つのホイールイベントを送信する場合、`vim` に合わせるには `3` に設定します。Claude Code が独自のスクロール処理を使用する JetBrains IDE のターミナルでは無視されます |388| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が設定されている場合に、特定のスクリプトをセッションごとに呼び出せる回数を制限する JSON オブジェクト。キーはコマンドテキストと照合される部分文字列で、値は整数の呼び出し回数の上限です。たとえば、`{"deploy.sh": 2}` は `deploy.sh` の呼び出しを最大 2 回まで許可します。照合は部分文字列ベースのため、`./scripts/deploy.sh $(evil)` のようなシェル展開のトリックも上限にカウントされます。`xargs` や `find -exec` による実行時のファンアウトは検出されません。これは多層防御のための制御です |

384| `CLAUDE_CODE_SEND_FEEDBACK` | `0` に設定すると、セッションの [Claude が下書きするフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) をオフにします。アカウントがすでにアクセス権を持っている場合は、`1` に設定するとオンにします。この変数自体がアクセス権を付与することはできず、`DISABLE_FEEDBACK_COMMAND` や [`feedbackDrafts`](/docs/ja/settings-reference#feedbackdrafts) 設定の `off` 値など、フィードバックをオフにする他のスイッチは引き続き適用されます |389| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリーンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling) でのマウスホイールのスクロール倍率を設定します。20 以下の任意の正の値を受け付けます。これには、すでにホイールイベントを増幅するターミナルで加速されたトラックパッドやホイールのスクロールを遅くするための、`0.5` のような 1 未満の小数値も含まれます。ターミナルが増幅なしでノッチごとに 1 つのホイールイベントを送信する場合、`vim` に合わせるには `3` に設定します。Claude Code が独自のスクロール処理を使用する JetBrains IDE のターミナルでは無視されます |

385| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/docs/ja/hooks#sessionend) フックの時間予算(ミリ秒)を上書きします。この値は、独自の `timeout` を設定していない各フックのタイムアウトにもなります。セッションの終了、`/clear`、対話的な `/resume` によるセッションの切り替えに適用されます。デフォルトの予算は 1.5 秒で、設定ファイルで設定されたフックごとの `timeout` の最大値まで、最大 60 秒まで自動的に引き上げられます。プラグインが提供するフックのタイムアウトは予算を引き上げません |390| `CLAUDE_CODE_SEND_FEEDBACK` | `0` に設定すると、セッションの [Claude が下書きするフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) をオフにします。アカウントがすでにアクセス権を持っている場合は、`1` に設定するとオンになります。この変数自体でアクセス権を付与することはできず、`DISABLE_FEEDBACK_COMMAND` や [`feedbackDrafts`](/docs/ja/settings-reference#feedbackdrafts) 設定の `off` 値など、フィードバックをオフにする他のスイッチは引き続き適用されます |

386| `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 セッションと関連付けるために使用します |391| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/docs/ja/hooks#sessionend) フックの時間予算(ミリ秒)を上書きします。この値は、独自の `timeout` を設定していない各フックのタイムアウトでもあります。セッションの終了、`/clear`、対話的な `/resume` によるセッションの切り替えに適用されます。デフォルトの予算は 1.5 秒で、設定ファイルで設定されたフックごとの `timeout` の最大値まで、最大 60 秒まで自動的に引き上げられます。プラグインが提供するフックのタイムアウトは予算を引き上げません |

387| `CLAUDE_CODE_SHELL` | Claude Code が Bash ツールのコマンドを実行するために使用するシェルを設定します。`/opt/homebrew/bin/bash` など、`bash` または `zsh` のバイナリへのパスを受け付けます。`fish` などの他のシェルはサポートされていません。値が動作する `bash` または `zsh` のパスでない場合、Claude Code はそれを無視して自動検出にフォールバックします。自動検出では、`$SHELL` が `bash` または `zsh` を指している場合はそれを使用し、それ以外の場合は `PATH` と標準のインストール場所で最初に見つかった動作する `zsh`、次に `bash` を選択します |392| `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 セッションと関連付けるために使用します |

388| `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 が組み立てた完全なシェル呼び出しが含まれます |393| `CLAUDE_CODE_SHELL` | Claude Code が Bash ツールのコマンドを実行するために使用するシェルを設定します。`/opt/homebrew/bin/bash` のような、`bash` または `zsh` バイナリへのパスを受け付けます。`fish` などの他のシェルはサポートされていません。値が動作する `bash` または `zsh` のパスでない場合、Claude Code はそれを無視して自動検出にフォールバックします。自動検出では、`$SHELL` が `bash` または `zsh` を指している場合はそれを使用し、そうでない場合は `PATH` と標準のインストール場所で最初に見つかった動作する `zsh`、次に `bash` を選択します |

389| `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) を渡すのと同じです |394| `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 が組み立てた完全なシェル呼び出しが含まれます |

390| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Claude Code の完全なシステムプロンプトと、ツールの説明を簡略化した短いシステムプロンプトのどちらを使うかを選択します。未設定の場合、Haiku 4.5、Sonnet 5、Opus 4.7 およびそれらのファミリーの以前のモデルはデフォルトで完全なプロンプトを使用し、より新しいモデルは短いプロンプトを使用します。`1` に設定すると、すべてのモデルで短いプロンプトを使用します。`0`、`false`、`no`、または `off` に設定すると、実験やサーバー設定によって短いプロンプトが選択される場合でも、すべてのモデルで完全なプロンプトを使用します。どちらのプロンプトでも、完全なツールセット、フック、MCP サーバー、CLAUDE.md の検出は維持されます |395| `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) を渡すのと同等です |

391| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | 自身でリクエストに署名するゲートウェイ向けに、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のクライアント側の認証をスキップします |396| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Claude Code の完全なシステムプロンプトと、ツールの説明を省略した短いシステムプロンプトのどちらを使うかを選択します。未設定の場合、Haiku 4.5、Sonnet 5、Opus 4.7、およびそれらのファミリーの以前のモデルはデフォルトで完全なプロンプトを使用し、より新しいモデルは短いプロンプトを使用します。`1` に設定すると、どのモデルでも短いプロンプトを使用します。`0`、`false`、`no`、または `off` に設定すると、実験やサーバー設定によって短いプロンプトが選択される場合でも、どのモデルでも完全なプロンプトを使用します。どちらのプロンプトでも、完全なツールセット、フック、MCP サーバー、CLAUDE.md の検出は維持されます |

397| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | 自身でリクエストに署名するゲートウェイ向けに、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のクライアント側認証をスキップします |

392| `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 以降が必要です |398| `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 以降が必要です |

393| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Amazon Bedrock の AWS 認証をスキップします(LLM ゲートウェイを使用する場合など) |399| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Amazon Bedrock の AWS 認証をスキップします(LLM ゲートウェイを使用する場合など) |

394| `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」というレスポンスには引き続き従います |400| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | `api.anthropic.com` へのチェックの直接リクエストをブロックするネットワーク向けに、`1` に設定すると、[fast mode](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) の利用可否チェックが失敗した場合に利用可能として扱います。Claude Code は引き続き「disabled by your organization」というレスポンスに従います |

395| `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 のリクエストを拒否します |401| `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 のリクエストを拒否します |

396| `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 クライアントがリクエストを送信できなくなっていました |402| `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 クライアントがリクエストを送信できなくなっていました |

397| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Amazon Bedrock Mantle の AWS 認証をスキップします(LLM ゲートウェイを使用する場合など) |403| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Amazon Bedrock Mantle の AWS 認証をスキップします(LLM ゲートウェイを使用する場合など) |

398| `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 以降が必要です |404| `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 以降が必要です |

399| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | `1` に設定すると、プロンプト履歴とセッションのトランスクリプトのディスクへの書き込みをスキップします。この変数を設定して開始したセッションは、`--resume`、`--continue`、上矢印キーの履歴に表示されません。一時的なスクリプトセッションに便利です |405| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | `1` に設定すると、プロンプト履歴とセッションのトランスクリプトのディスクへの書き込みをスキップします。この変数を設定して開始したセッションは、`--resume`、`--continue`、上矢印キーの履歴に表示されません。一時的なスクリプトセッションに便利です |

400| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Google Cloud's Agent Platform の Google 認証をスキップします(LLM ゲートウェイを使用する場合など) |406| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Google Cloud's Agent Platform の Google 認証をスキップします(LLM ゲートウェイを使用する場合など) |

401| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | `1` に設定すると、`--output-format stream-json` で開始したセッションで、通常は stderr への出力だけで終わる起動失敗について、[Claude Code が起動を拒否した理由を示す result メッセージ](/docs/ja/agent-sdk/typescript#startup_failure_reason) を書き込みます。Claude Code v2.1.274 以降が必要です |407| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | `1` に設定すると、`--output-format stream-json` で開始したセッションで、通常は stderr への出力だけで終了する起動失敗について、[Claude Code が起動を拒否した理由を示す result メッセージ](/docs/ja/agent-sdk/typescript#startup_failure_reason) を書き込むようにします。Claude Code v2.1.274 以降が必要です |

402| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/docs/ja/hooks#stop) または [SubagentStop](/docs/ja/hooks#subagentstop) フックがターンの終了を連続してブロックできる最大回数。これを超えると、Claude Code はフックを上書きしてターンを終了します(デフォルト: 8)。`0` に設定すると上限を無効にします。フックが解決するのに正当にそれ以上の反復を必要とする場合は値を上げてください |408| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Claude Code がそれを上書きしてターンを終了させるまでに、[Stop](/docs/ja/hooks#stop) または [SubagentStop](/docs/ja/hooks#subagentstop) フックがターンの終了を連続してブロックできる最大回数(デフォルト: 8)。`0` に設定すると上限を無効にします。フックが解決するために正当により多くの反復を必要とする場合は、この値を増やしてください |

403| `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` フィールドの両方を上書きしていました |409| `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` フィールドの両方を上書きしていました |

404| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | `1` に設定すると、サブエージェント、チームメイト、ワークフローエージェントに 1 つのモデルを強制します。どのモデルになるかについては、[すべてのサブエージェントを 1 つのモデルで実行する](/docs/ja/sub-agents#run-every-subagent-on-one-model) を参照してください。Claude Code v2.1.257 以降が必要です |410| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | `1` に設定すると、サブエージェント、チームメイト、ワークフローエージェントに 1 つのモデルを強制します。それがどのモデルかについては、[すべてのサブエージェントを 1 つのモデルで実行する](/docs/ja/sub-agents#run-every-subagent-on-one-model) を参照してください。Claude Code v2.1.257 以降が必要です |

405| `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 以降が必要です |411| `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 以降が必要です |

406| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | `1` に設定すると、Bash コマンド、フック、stdio MCP サーバーなど、Claude Code が起動するサブプロセスの環境から認証情報を除去します。スクラブは変数名または値によって認証情報を識別し、GitHub トークンとプロキシ設定はそのまま残します。[サブプロセス環境のスクラブで除去されるもの](#what-the-subprocess-environment-scrub-removes) を参照してください。`allowed_non_write_users` が設定されている場合、`claude-code-action` はこれを自動的に設定します |412| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | `1` に設定すると、Bash コマンド、フック、stdio MCP サーバーなど、Claude Code が起動するサブプロセスの環境から認証情報を取り除きます。スクラブは変数名または値によって認証情報を識別し、GitHub トークンとプロキシ設定はそのまま残します。[サブプロセス環境のスクラブで削除されるもの](#what-the-subprocess-environment-scrub-removes) を参照してください。`allowed_non_write_users` が設定されている場合、`claude-code-action` はこれを自動的に設定します |

407| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 非対話モード(`-p` フラグ)で `1` に設定すると、最初のクエリの前にプラグインのインストールが完了するまで待機します。これがない場合、プラグインはバックグラウンドでインストールされ、最初のターンでは利用できない可能性があります。待機時間を制限するには `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` と組み合わせてください |413| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 非対話モード(`-p` フラグ)で `1` に設定すると、最初のクエリの前にプラグインのインストールが完了するまで待機します。これがない場合、プラグインはバックグラウンドでインストールされ、最初のターンでは利用できない場合があります。待機時間を制限するには、`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` と組み合わせてください |

408| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 同期プラグインインストールのタイムアウト(ミリ秒)。超過した場合、Claude Code はプラグインなしで続行し、エラーをログに記録します。デフォルトはありません。この変数がない場合、同期インストールは完了するまで待機します |414| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 同期的なプラグインインストールのタイムアウト(ミリ秒)。超過すると、Claude Code はプラグインなしで続行し、エラーをログに記録します。デフォルトはありません。この変数がない場合、同期インストールは完了するまで待機します |

409| `CLAUDE_CODE_SYNC_SKILLS` | `-p` フラグを使用した非対話モードで `1` に設定すると、Claude Code はその実行で claude.ai アカウントで有効になっているスキルをダウンロードし、最初のクエリを実行する前に、`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` を上限としてスキルの一覧を待機します。claude.ai 認証が必要です。claude.ai アカウントでサインインするターミナルセッションでは、この変数がなくても [これらのスキルが同期される](/docs/ja/skills#where-synced-skills-load) ため、`-p` の実行で最初のクエリに現在のスキルが必要な場合にのみ設定してください |415| `CLAUDE_CODE_SYNC_SKILLS` | `-p` フラグを使用した非対話モードで `1` に設定すると、Claude Code はその実行で claude.ai アカウントで有効になっているスキルをダウンロードし、最初のクエリを実行する前に、`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` を上限としてスキルの一覧を待機します。claude.ai 認証が必要です。claude.ai アカウントでサインインするターミナルセッションでは、この変数がなくても [これらのスキルが同期される](/docs/ja/skills#where-synced-skills-load) ため、`-p` の実行で最初のクエリに最新のスキルが必要な場合にのみ設定してください |

410| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | [Agent SDK](/docs/ja/agent-sdk/typescript#query-object) 上に構築されたアプリがスキルを再読み込みする際に、セッションの途中で実行されるスキル再同期のタイムアウト(ミリ秒、デフォルト: 30000)。超過した場合、再読み込みはすでに届いたスキルで続行され、残りのダウンロードはバックグラウンドで完了します |416| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | [Agent SDK](/docs/ja/agent-sdk/typescript#query-object) で構築されたアプリがスキルを再読み込みする際に、セッションの途中で実行されるスキルの再同期のタイムアウト(ミリ秒)(デフォルト: 30000)。超過すると、再読み込みはすでに届いたスキルで続行され、残りのダウンロードはバックグラウンドで完了します |

411| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS` が設定されている場合に、最初のクエリが初期スキル一覧を待機するタイムアウト(ミリ秒、デフォルト: 5000)。超過した場合、最初のクエリはすでに届いたスキルで実行されます。いずれの場合もダウンロードはバックグラウンドで完了し、Claude はスキルを呼び出す際にそのスキルのダウンロードを待機します |417| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS` が設定されている場合に、最初のクエリが初期のスキル一覧を待機するタイムアウト(ミリ秒)(デフォルト: 5000)。超過すると、最初のクエリはすでに届いたスキルで実行されます。いずれの場合もダウンロードはバックグラウンドで完了し、Claude はスキルを呼び出す際にそのスキルのダウンロードを待機します |

412| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | `false` に設定すると、差分出力のシンタックスハイライトを無効にします。色がターミナルの設定と干渉する場合に便利です。コードブロックとファイルプレビューのハイライトも無効にするには、[`syntaxHighlightingDisabled`](/docs/ja/settings-reference#syntaxhighlightingdisabled) 設定を使用します |418| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | `false` に設定すると、差分出力のシンタックスハイライトを無効にします。色がターミナルの設定に干渉する場合に便利です。コードブロックとファイルプレビューのハイライトも無効にするには、[`syntaxHighlightingDisabled`](/docs/ja/settings-reference#syntaxhighlightingdisabled) 設定を使用してください |

413| `CLAUDE_CODE_TASK_LIST_ID` | セッション間でタスクリストを共有します。[Task ツールを持つセッション](/docs/ja/tools-reference#task-tool-availability) で、複数の Claude Code インスタンスに同じ ID を設定すると、共有タスクリストで連携できます。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照してください |419| `CLAUDE_CODE_TASK_LIST_ID` | セッション間でタスクリストを共有します。[Task ツールを持つセッション](/docs/ja/tools-reference#task-tool-availability) で、複数の Claude Code インスタンスに同じ ID を設定すると、共有タスクリストで連携できます。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照してください |

414| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | 非対話セッションが終了時に [エージェントチーム](/docs/ja/agent-teams) の終了処理の完了を待機する時間を、ミリ秒単位で上書きします。1000 から 60000 を受け付けます。範囲外の値は無視され、デフォルトの 10000 が適用されます。Claude Code v2.1.206 以降が必要です |420| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | 非対話セッションが終了時に [エージェントチーム](/docs/ja/agent-teams) の解体が完了するまで待機する時間を、ミリ秒単位で上書きします。1000 から 60000 を受け付けます。範囲外の値は無視され、デフォルトの 10000 が適用されます。Claude Code v2.1.206 以降が必要です |

415| `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) では無視されます |421| `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) では無視されます |

416| `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) を参照してください |422| `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) を参照してください |

417| `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 以降が必要です |423| `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 以降が必要です |

418| `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 以降が必要です |424| `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 以降が必要です |

419| `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 以降が必要です |425| `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 以降が必要です |

420| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | [Remote Control](/docs/ja/remote-control) や SDK ホストなどのリモートクライアントに Claude Code が転送するダイアログ、または [保留中のセッション間メッセージ](/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` または負の値を指定すると期限を無効にします。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |426| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Claude Code が [Remote Control](/docs/ja/remote-control) や SDK ホストなどのリモートクライアントに転送するダイアログ、または[保留中のクロスセッションメッセージ](/docs/ja/cross-session-messaging#control-inbound-messages)の承認ダイアログをキャンセルするまでの期限(ミリ秒)。権限プロンプトと `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` または負の値を指定すると期限が無効になります。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |

421| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) を使用します |427| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) を使用します |

422| `CLAUDE_CODE_USE_BEDROCK` | [Amazon Bedrock](/docs/ja/amazon-bedrock) を使用します |428| `CLAUDE_CODE_USE_BEDROCK` | [Amazon Bedrock](/docs/ja/amazon-bedrock) を使用します |

423| `CLAUDE_CODE_USE_FOUNDRY` | [Microsoft Foundry](/docs/ja/microsoft-foundry) を使用します |429| `CLAUDE_CODE_USE_FOUNDRY` | [Microsoft Foundry](/docs/ja/microsoft-foundry) を使用します |

424| `CLAUDE_CODE_USE_MANTLE` | Amazon Bedrock の [Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)を使用します |430| `CLAUDE_CODE_USE_MANTLE` | Amazon Bedrock の [Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)を使用します |

425| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | `1` に設定すると、ripgrep の代わりに Node.js のファイル API を使用して、カスタムコマンド、サブエージェント、出力スタイルを検出します。バンドルされている ripgrep バイナリが利用できない場合や、環境でブロックされている場合に設定します。Grep ツールやファイル検索ツールには影響しません |431| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | `1` に設定すると、ripgrep の代わりに Node.js のファイル API を使用してカスタムコマンド、サブエージェント、出力スタイルを検出します。バンドルされた ripgrep バイナリが環境で利用できない場合やブロックされている場合に設定します。Grep ツールやファイル検索ツールには影響しません |

426| `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)を参照してください |432| `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)を参照してください |

427| `CLAUDE_CODE_USE_VERTEX` | [Google Cloud's Agent Platform](/docs/ja/google-vertex-ai) を使用します |433| `CLAUDE_CODE_USE_VERTEX` | [Google Cloud's Agent Platform](/docs/ja/google-vertex-ai) を使用します |

428| `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 以降が必要です |434| `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 以降が必要です |

429| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) がページのダウンロードを待機する時間の上限(ミリ秒)で、追跡するリダイレクトも含みます。それまでに完了しないダウンロードは期限エラーで失敗します。デフォルトは `300000`(5 分)です。`0` に設定すると制限がなくなります。数字のみを受け付けます。小数やその他の表記の場合はデフォルトが維持されます。Claude Code v2.1.268 以降が必要です |435| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) がページのダウンロード(たどるリダイレクトを含む)を待機する時間の上限(ミリ秒)。その時点までに完了しないダウンロードは期限エラーで失敗します。デフォルトは `300000`(5 分)です。`0` に設定すると制限がなくなります。数字のみを受け付けます。小数やその他の表記ではデフォルトが維持されます。Claude Code v2.1.268 以降が必要です |

430| `CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR` | セッションの [WebSearch の上限](/docs/ja/tools-reference#session-search-limit)が回復する速度(1 時間あたりの呼び出し数)です。対話型のターミナルセッションでのデフォルトは `100` です。[非対話](/docs/ja/headless)セッションでのデフォルトは `0` で、回復はオフになります。数字のみを受け付けます。その他の表記は未設定として扱われます。Claude Code v2.1.290 以降が必要です |436| `CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR` | セッションの [WebSearch の制限](/docs/ja/tools-reference#session-search-limit)が補充されるレート(1 時間あたりの呼び出し数)。対話型のターミナルセッションではデフォルトは `100` です。[非対話](/docs/ja/headless)セッションではデフォルトは `0` で、補充はオフになります。数字のみを受け付けます。その他の表記は未設定として扱われます。Claude Code v2.1.290 以降が必要です |

431| `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 以降が必要です |437| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | `CLAUDE_AUTO_BACKGROUND_TASKS` が `1` に設定されている場合に、まだ実行中の[バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)を確認するよう Claude にリマインドするまでに Claude Code が待機する時間。`600` や `600,1800,3600` のように、`1` から `86400` までの整数秒による待機時間を 1 つ以上カンマ区切りで指定します。各値は次のリマインダーまでの待機時間で、最後の値が繰り返されます。数字のみを受け付けます。その他の値や表記は未設定として扱われます。未設定の場合、リマインダーはありません。Claude Code v2.1.283 以降が必要です |

432| `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 以降が必要です |438| `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 以降が必要です |

433| `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 以降が必要です |439| `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 以降が必要です |

434| `CLAUDE_CONFIG_DIR` | 設定ディレクトリを上書きします(デフォルト: `~/.claude`)。すべての設定、セッション履歴、プラグインはこのパスの下に保存されます。認証情報については、[Claude Code が認証情報を保存する場所](/docs/ja/authentication#credential-management)を参照してください。複数のアカウントを並行して実行する場合に便利です。例: `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`。シェル、ユーザー設定、または管理設定で設定します。設定ファイルでは[絶対パス](#in-settings-files)を記述します。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |440| `CLAUDE_CONFIG_DIR` | 設定ディレクトリを上書きします(デフォルト: `~/.claude`)。すべての設定、セッション履歴、プラグインはこのパスの下に保存されます。認証情報については、[Claude Code が認証情報を保存する場所](/docs/ja/authentication#credential-management)を参照してください。複数のアカウントを並行して使用する場合に便利です。例: `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`。シェル、ユーザー設定、または管理設定で設定します。設定ファイルでは[絶対パス](#in-settings-files)を記述します。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |

435| `CLAUDE_DISABLE_ADOPT` | `1` に設定すると、`←` を押すか [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラウンドに移したときに、実行中のバックグラウンド作業を引き継がずに停止します。Claude Code はバックグラウンドに移す前に確認を求め、本来引き継がれるはずだったタスクを停止します。Claude Code v2.1.195 以降が必要です |441| `CLAUDE_DISABLE_ADOPT` | `1` に設定すると、`←` を押すか [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラウンドに移したときに、進行中のバックグラウンド作業を引き継ぐ代わりに停止します。Claude Code はバックグラウンドに移す前に確認を求め、本来なら引き継がれるタスクを停止します。Claude Code v2.1.195 以降が必要です |

436| `CLAUDE_EFFORT` | Bash ツールのサブプロセスとフックコマンドで、サブプロセスの開始時に有効な [effort レベル](/docs/ja/model-config#adjust-effort-level)(`low`、`medium`、`high`、`xhigh`、`max`)に自動的に設定されます。[フック](/docs/ja/hooks)に渡される `effort.level` フィールドと一致します。現在のモデルが effort パラメータをサポートしている場合にのみ設定されます |442| `CLAUDE_EFFORT` | Bash ツールのサブプロセスとフックコマンドで、サブプロセスの開始時に有効な [effort レベル](/docs/ja/model-config#adjust-effort-level)(`low`、`medium`、`high`、`xhigh`、または `max`)に自動的に設定されます。[フック](/docs/ja/hooks)に渡される `effort.level` フィールドと一致します。現在のモデルが effort パラメーターをサポートしている場合にのみ設定されます |

437| `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)を参照してください |443| `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)を参照してください |

438| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | `1` に設定すると、Amazon Bedrock の `vnd.amazon.eventstream` レスポンスでバイトレベルのストリーミングアイドルウォッチドッグを有効にします。これにより、Bedrock のストリーミングリクエストで[最初のバイトの期限](/docs/ja/network-config#streaming-idle-watchdogs)も有効になります。デフォルトではオフです。タイムアウトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定します |444| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | `1` に設定すると、Amazon Bedrock の `vnd.amazon.eventstream` レスポンスでバイトレベルのストリーミングアイドルウォッチドッグを有効にし、Bedrock のストリーミングリクエストで[最初のバイトの期限](/docs/ja/network-config#streaming-idle-watchdogs)も有効にします。デフォルトではオフです。タイムアウトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定します |

439| `CLAUDE_ENABLE_STREAM_WATCHDOG` | `0` に設定するとイベントレベルのストリーミングアイドルウォッチドッグを強制的に無効にし、`1` に設定すると強制的に有効にします。未設定の場合、ウォッチドッグはすべてのプロバイダーでデフォルトでオンです。v2.1.196 より前は、未設定時のデフォルトは、Anthropic API への直接接続ではサーバー側で制御され、その他のプロバイダーではオフでした。タイムアウトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定します。これと並行して実行されるその他の停止タイマーについては、[ストリーミングアイドルウォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)を参照してください |445| `CLAUDE_ENABLE_STREAM_WATCHDOG` | `0` に設定するとイベントレベルのストリーミングアイドルウォッチドッグを強制的に無効にし、`1` に設定すると強制的に有効にします。未設定の場合、ウォッチドッグはすべてのプロバイダーでデフォルトでオンになります。v2.1.196 より前は、未設定時のデフォルトは Anthropic API への直接接続ではサーバー側で制御され、その他のプロバイダーではオフでした。タイムアウトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定します。これと並行して動作するその他の停止タイマーについては、[ストリーミングアイドルウォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)を参照してください |

440| `CLAUDE_ENV_FILE` | 各 Bash コマンドの前に、Claude Code が同じシェルプロセス内でその内容を実行するシェルスクリプトのパスです。ファイル内の 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) フックによって動的に設定されることもあります |446| `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) フックによっても動的に設定されます |

441| `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` の呼び出しでは権限の確認が求められず、ディレクトリはセッションが削除されると削除されます |447| `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` 呼び出しでは権限の確認は求められず、このディレクトリはセッションが削除されると削除されます |

442| `CLAUDE_PID` | Claude Code が生成するサブプロセス(Bash および PowerShell ツールのコマンドとフックコマンド)で、Claude Code が自身のプロセス ID に設定します。Linux では、Bash ツールのシェル統合がこれを使用して、Claude Code プロセス自体に一致する `pkill` パターンを拒否します。[エラーリファレンス](/docs/ja/errors#pkill-pattern-matches-the-claude-code-process)を参照してください。独自のスクリプトからこれを読み取ることで、親の Claude Code プロセスを意図的に識別したり、シグナルを送ったりできます。Claude Code v2.1.214 以降が必要です |448| `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 以降が必要です |

443| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 明示的な名前が指定されていない場合に自動生成される [Remote Control](/docs/ja/remote-control) セッション名のプレフィックスです。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` のような名前が生成されます。`--remote-control-session-name-prefix` CLI フラグは、1 回の呼び出しに対して同じ値を設定します |449| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 明示的な名前が指定されていない場合に自動生成される [Remote Control](/docs/ja/remote-control) セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` のような名前になります。`--remote-control-session-name-prefix` CLI フラグは、1 回の呼び出しに対して同じ値を設定します |

444| `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 以降が必要です |450| `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 以降が必要です |

445| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | イベントレベルおよびバイトレベルのストリーミングアイドルウォッチドッグが、停止した接続を閉じるまでのタイムアウト(ミリ秒)です。この変数を明示的に設定する場合、最小値は `300000`(5 分)です。拡張思考の一時停止やプロキシのバッファリングを吸収するため、それより小さい値は通知なしに切り上げられます。また、バイトレベルのウォッチドッグでは値の上限は 30 分です。バイトレベルのウォッチドッグについては、`CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` がこの変数より優先されます。ウォッチドッグごとの未設定時のデフォルトについては、[ストリーミングアイドルウォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)を参照してください |451| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | イベントレベルおよびバイトレベルのストリーミングアイドルウォッチドッグが停止した接続を閉じるまでのタイムアウト(ミリ秒)。この変数を明示的に設定する場合、最小値は `300000`(5 分)です。拡張思考による一時停止やプロキシのバッファリングを吸収するため、それより小さい値は通知なしに引き上げられます。また、バイトレベルのウォッチドッグは値の上限を 30 分とします。バイトレベルのウォッチドッグについては、`CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` がこの変数より優先されます。ウォッチドッグごとの未設定時のデフォルトについては、[ストリーミングアイドルウォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)を参照してください |

446| `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)を参照してください |452| `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)を参照してください |

447| `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:*` のような名前空間パターンではデバッグモードは有効になりません |453| `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:*` のような名前空間パターンではトリガーされません |

448| `DISABLE_AUTOUPDATER` | `1` に設定すると、バックグラウンドでの自動更新を無効にします。手動の `claude update` は引き続き機能します。両方をブロックするには `DISABLE_UPDATES` を使用します |454| `DISABLE_AUTOUPDATER` | `1` に設定すると、バックグラウンドでの自動更新を無効にします。手動の `claude update` は引き続き機能します。両方をブロックするには `DISABLE_UPDATES` を使用します |

449| `DISABLE_AUTO_COMPACT` | `1` に設定すると、コンテキストの上限に近づいたときの自動コンテキスト圧縮を無効にします。手動の `/compact` コマンドは引き続き使用できます。圧縮が行われるタイミングを明示的に制御したい場合に使用します。[`autoCompactEnabled`](/docs/ja/settings-reference#autocompactenabled) 設定を上書きします |455| `DISABLE_AUTO_COMPACT` | `1` に設定すると、コンテキストの上限に近づいたときの自動圧縮を無効にします。手動の `/compact` コマンドは引き続き使用できます。コンテキスト圧縮を行うタイミングを明示的に制御したい場合に使用します。[`autoCompactEnabled`](/docs/ja/settings-reference#autocompactenabled) 設定を上書きします |

450| `DISABLE_COMPACT` | `1` に設定すると、自動圧縮と手動の `/compact` コマンドの両方を含む、すべてのコンテキスト圧縮を無効にします |456| `DISABLE_COMPACT` | `1` に設定すると、自動圧縮と手動の `/compact` コマンドの両方を含む、すべてのコンテキスト圧縮を無効にします |

451| `DISABLE_COST_WARNINGS` | `1` に設定すると、コスト警告メッセージを無効にします |457| `DISABLE_COST_WARNINGS` | `1` に設定すると、コストに関する警告メッセージを無効にします |

452| `DISABLE_DOCTOR_COMMAND` | `1` に設定すると、[`/doctor`](/docs/ja/commands#all-commands) セットアップチェックアップスキルと、そのエイリアスである `/checkup` を非表示にします。ユーザーがセッションからセットアップ診断を実行すべきでない管理された導入環境で便利です。`claude doctor` ターミナルコマンドには影響しません。v2.1.205 より前は、この変数は `/doctor` 診断画面コマンドを非表示にしていました |458| `DISABLE_DOCTOR_COMMAND` | `1` に設定すると、[`/doctor`](/docs/ja/commands#all-commands) セットアップチェックアップスキルとそのエイリアス `/checkup` を非表示にします。ユーザーがセッションからセットアップ診断を実行すべきでない管理されたデプロイで役立ちます。`claude doctor` ターミナルコマンドには影響しません。v2.1.205 より前は、この変数は `/doctor` 診断画面コマンドを非表示にしていました |

453| `DISABLE_ERROR_REPORTING` | `1` などの空でない任意の値に設定すると、エラーレポートをオプトアウトします。**ほとんどのオン/オフ変数とは異なり、`0` または `false` に設定してもオプトアウトになります**。エラーレポートを再度オンにするには、変数の設定を解除します |459| `DISABLE_ERROR_REPORTING` | `1` などの空でない任意の値に設定すると、エラーレポートをオプトアウトします。ほとんどのオン/オフ変数とは異なり、**`0` や `false` に設定してもオプトアウトされます**。エラーレポートを再びオンにするには、変数の設定を解除してください |

454| `DISABLE_EXTRA_USAGE_COMMAND` | `1` に設定すると、レート制限を超える追加の使用量をユーザーが購入できる `/usage-credits` コマンドを非表示にします |460| `DISABLE_EXTRA_USAGE_COMMAND` | `1` に設定すると、ユーザーがレート制限を超えて追加の使用量を購入できる `/usage-credits` コマンドを非表示にします |

455| `DISABLE_FEEDBACK_COMMAND` | `1` に設定すると、`/feedback` コマンドと [Claude が作成するフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を無効にします。同じ経路で報告を行う `/bug` と `/share` も無効になります。v2.1.212 より前はこれらが `/feedback` のエイリアスだったため、どの名前でもコマンドが無効になっていました。古い名前の `DISABLE_BUG_COMMAND` も使用できます |461| `DISABLE_FEEDBACK_COMMAND` | `1` に設定すると、`/feedback` コマンドと [Claude が作成するフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を無効にします。同じ経路で報告する `/bug` と `/share` も無効にします。v2.1.212 より前はこれらは `/feedback` のエイリアスであったため、コマンドはどの名前でも無効になっていました。旧名の `DISABLE_BUG_COMMAND` も受け付けられます |

456| `DISABLE_GROWTHBOOK` | `1` または `true` に設定すると、GrowthBook のフィーチャーフラグの取得を無効にし、すべてのフラグにコードのデフォルト値を使用します。これにより、[Remote Control](/docs/ja/remote-control#requirements) およびその他の[フィーチャーフラグの取得を必要とする機能](#features-that-need-feature-flag-fetching)が利用できなくなります。`0` または `false` に設定すると、取得はオンのままです。テレメトリイベントのログ記録は、`DISABLE_TELEMETRY` も設定しない限りオンのままです |462| `DISABLE_GROWTHBOOK` | `1` または `true` に設定すると、GrowthBook の機能フラグの取得を無効にし、すべてのフラグでコードのデフォルト値を使用します。これにより、[Remote Control](/docs/ja/remote-control#requirements) やその他の[機能フラグの取得を必要とする機能](#features-that-need-feature-flag-fetching)が利用できなくなります。`0` または `false` に設定すると取得はオンのままになります。`DISABLE_TELEMETRY` も設定しない限り、テレメトリイベントのログ記録はオンのままです |

457| `DISABLE_INSTALLATION_CHECKS` | `1` に設定すると、インストールに関する警告を無効にします。標準インストールでの問題を隠してしまう可能性があるため、インストール場所を手動で管理している場合にのみ使用してください |463| `DISABLE_INSTALLATION_CHECKS` | `1` に設定すると、インストールに関する警告を無効にします。標準的なインストールの問題を覆い隠す可能性があるため、インストール場所を手動で管理している場合にのみ使用してください |

458| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | `1` に設定すると、`/install-github-app` コマンドを非表示にします。サードパーティプロバイダー(Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry)を使用している場合は、すでに非表示になっています |464| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | `1` に設定すると、`/install-github-app` コマンドを非表示にします。サードパーティプロバイダー(Amazon Bedrock、Google Cloud's Agent Platform、または Microsoft Foundry)を使用している場合はすでに非表示になっています |

459| `DISABLE_INTERLEAVED_THINKING` | `1` に設定すると、interleaved-thinking ベータヘッダーを送信しないようにします。LLM ゲートウェイやプロバイダーが[インターリーブ思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking)をサポートしていない場合に便利です |465| `DISABLE_INTERLEAVED_THINKING` | `1` に設定すると、interleaved-thinking ベータヘッダーの送信を防ぎます。LLM ゲートウェイやプロバイダーが[インターリーブ思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking)をサポートしていない場合に役立ちます |

460| `DISABLE_LOGIN_COMMAND` | `1` に設定すると、`/login` コマンドを非表示にします。認証が API キーや `apiKeyHelper` を介して外部で処理される場合に便利です |466| `DISABLE_LOGIN_COMMAND` | `1` に設定すると、`/login` コマンドを非表示にします。API キーや `apiKeyHelper` を介して認証が外部で処理されている場合に役立ちます |

461| `DISABLE_LOGOUT_COMMAND` | `1` に設定すると、`/logout` コマンドを非表示にします |467| `DISABLE_LOGOUT_COMMAND` | `1` に設定すると、`/logout` コマンドを非表示にします |

462| `DISABLE_PROMPT_CACHING` | `1` に設定すると、すべてのモデルで[プロンプトキャッシュ](/docs/ja/prompt-caching#disable-prompt-caching)を無効にします(モデルごとの設定より優先されます) |468| `DISABLE_PROMPT_CACHING` | `1` に設定すると、すべてのモデルで[プロンプトキャッシュ](/docs/ja/prompt-caching#disable-prompt-caching)を無効にします(モデルごとの設定より優先されます) |

463| `DISABLE_PROMPT_CACHING_FABLE` | `1` に設定すると、Fable モデルのプロンプトキャッシュを無効にします |469| `DISABLE_PROMPT_CACHING_FABLE` | `1` に設定すると、Fable モデルのプロンプトキャッシュを無効にします |

464| `DISABLE_PROMPT_CACHING_HAIKU` | `1` に設定すると、実行場所に関係なく、[デフォルトの Haiku モデル](/docs/ja/prompt-caching#disable-prompt-caching)のプロンプトキャッシュを無効にします |470| `DISABLE_PROMPT_CACHING_HAIKU` | `1` に設定すると、実行場所にかかわらず、[デフォルトの Haiku モデル](/docs/ja/prompt-caching#disable-prompt-caching)のプロンプトキャッシュを無効にします |

465| `DISABLE_PROMPT_CACHING_OPUS` | `1` に設定すると、[デフォルトの Opus モデル](/docs/ja/prompt-caching#disable-prompt-caching)のプロンプトキャッシュを無効にします |471| `DISABLE_PROMPT_CACHING_OPUS` | `1` に設定すると、[デフォルトの Opus モデル](/docs/ja/prompt-caching#disable-prompt-caching)のプロンプトキャッシュを無効にします |

466| `DISABLE_PROMPT_CACHING_SONNET` | `1` に設定すると、[デフォルトの Sonnet モデル](/docs/ja/prompt-caching#disable-prompt-caching)のプロンプトキャッシュを無効にします |472| `DISABLE_PROMPT_CACHING_SONNET` | `1` に設定すると、[デフォルトの Sonnet モデル](/docs/ja/prompt-caching#disable-prompt-caching)のプロンプトキャッシュを無効にします |

467| `DISABLE_TELEMETRY` | `1` などの空でない任意の値に設定すると、テレメトリをオプトアウトします。**ほとんどのオン/オフ変数とは異なり、`0` または `false` に設定してもオプトアウトになります**。テレメトリを再度オンにするには、変数の設定を解除します。テレメトリイベントには、コード、ファイルパス、Bash コマンドなどのユーザーデータは含まれません。[フィーチャーフラグの取得](#features-that-need-feature-flag-fetching)も無効になります。[組織のテレメトリをオフにする](/docs/ja/managed-settings#turn-telemetry-off-for-your-organization)を参照してください |473| `DISABLE_TELEMETRY` | `1` などの空でない任意の値に設定すると、テレメトリをオプトアウトします。ほとんどのオン/オフ変数とは異なり、**`0` や `false` に設定してもオプトアウトされます**。テレメトリを再びオンにするには、変数の設定を解除してください。テレメトリイベントには、コード、ファイルパス、Bash コマンドなどのユーザーデータは含まれません。[機能フラグの取得](#features-that-need-feature-flag-fetching)も無効にします。[組織のテレメトリをオフにする](/docs/ja/managed-settings#turn-telemetry-off-for-your-organization)を参照してください |

468| `DISABLE_UPDATES` | `1` に設定すると、手動の `claude update` と `claude install` を含むすべての更新をブロックします。`DISABLE_AUTOUPDATER` より厳格です。独自の経路で Claude Code を配布しており、ユーザーに自己更新させたくない場合に使用します |474| `DISABLE_UPDATES` | `1` に設定すると、手動の `claude update` と `claude install` を含むすべての更新をブロックします。`DISABLE_AUTOUPDATER` より厳格です。独自のチャネルを通じて Claude Code を配布しており、ユーザーに自己更新させたくない場合に使用します |

469| `DISABLE_UPGRADE_COMMAND` | `1` に設定すると、`/upgrade` コマンドを非表示にします |475| `DISABLE_UPGRADE_COMMAND` | `1` に設定すると、`/upgrade` コマンドを非表示にします |

470| `DO_NOT_TRACK` | `1` に設定すると、テレメトリをオプトアウトします。効果は `DISABLE_TELEMETRY` と同じで、[フィーチャーフラグの取得](#features-that-need-feature-flag-fetching)への影響も含まれます。Claude Code はこの変数を標準的なブール値として読み取るため、`0` ではテレメトリはオンのままです。また、多くの開発者向け CLI が認識するツール横断の慣例として、この変数を尊重します |476| `DO_NOT_TRACK` | `1` に設定すると、テレメトリをオプトアウトします。[機能フラグの取得](#features-that-need-feature-flag-fetching)への影響を含め、`DISABLE_TELEMETRY` と同じ効果があります。Claude Code はこの変数を標準的なブール値として読み取るため、`0` ではテレメトリはオンのままになります。また、多くの開発者向け CLI で認識されているツール横断の慣例としてこの変数を尊重します |

471| `ENABLE_BETA_TRACING_DETAILED` | `1` に設定し、`BETA_TRACING_ENDPOINT` を OTLP/HTTP コレクターのエンドポイントに設定すると、[詳細なベータトレース](/docs/ja/monitoring-usage#traces-beta)がオンになります。これにより、コンテンツを含むスパン属性と `claude_code.hook` スパンが追加されます。対話型 CLI セッションでは、組織がベータの許可リストに登録されている必要もあります。どちらの変数も[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |477| `ENABLE_BETA_TRACING_DETAILED` | `1` に設定し、`BETA_TRACING_ENDPOINT` を OTLP/HTTP コレクターのエンドポイントに設定すると、[詳細なベータトレーシング](/docs/ja/monitoring-usage#traces-beta)がオンになり、コンテンツを含むスパン属性と `claude_code.hook` スパンが追加されます。対話型の CLI セッションでは、組織がベータの許可リストに登録されている必要もあります。どちらの変数も[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |

472| `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) を設定します |478| `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) を設定します |

473| `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` を使用します |479| `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` を使用します。これらはこの変数より優先されます |

474| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 非推奨です。代わりに `ENABLE_PROMPT_CACHING_1H` を使用してください |480| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 非推奨です。代わりに `ENABLE_PROMPT_CACHING_1H` を使用してください |

475| `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 のすべてのモデルでツール検索を無効にしていました |481| `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 のすべてのモデルでツール検索を無効にしていました |

476| `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)に切り替えるため、この変数はフォールバックモデルへの切り替えには影響しません |482| `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)に切り替えるため、この変数はフォールバックモデルへの切り替えには影響しません |

477| `FORCE_AUTOUPDATE_PLUGINS` | `1` に設定すると、メインの自動アップデーターが `DISABLE_AUTOUPDATER` によって無効になっている場合でも、プラグインの自動更新を強制します |483| `FORCE_AUTOUPDATE_PLUGINS` | `1` に設定すると、メインの自動更新が `DISABLE_AUTOUPDATER` で無効になっている場合でも、プラグインの自動更新を強制します |

478| `FORCE_HYPERLINK` | `1` に設定すると、ターミナルが OSC 8 ハイパーリンクをサポートしているのに自動検出されない場合に、クリック可能なハイパーリンクを有効にします。`0` に設定すると無効にします。未設定の場合、Claude Code はターミナルのサポートを検出した場合にのみハイパーリンクを有効にします。Claude Code はこの値をブール値ではなく数値として解析するため、`false`、`no`、`off` などの値はハイパーリンクを無効にするのではなく有効にします。フッターの [PR またはマージリクエストのバッジ](/docs/ja/interactive-mode#pr-review-status)は、SSH 経由など、Claude Code がターミナルのサポートを検出できない場合でもハイパーリンクとして表示されます。バッジをプレーンテキストとして表示するには `0` を設定します |484| `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` に設定します |

479| `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` の設定を上書きします |485| `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` 設定を上書きします |

480| `HTTP_PROXY` | ネットワーク接続用の HTTP プロキシサーバーを指定します |486| `HTTP_PROXY` | ネットワーク接続用の HTTP プロキシサーバーを指定します |

481| `HTTPS_PROXY` | ネットワーク接続用の HTTPS プロキシサーバーを指定します |487| `HTTPS_PROXY` | ネットワーク接続用の HTTPS プロキシサーバーを指定します |

482| `IS_DEMO` | `1` などの空でない任意の値に設定すると、デモモードを有効にします。ヘッダーと `/status` の出力からメールアドレスと組織名を非表示にし、オンボーディングをスキップします。**ほとんどのオン/オフ変数とは異なり、`0` または `false` に設定してもデモモードが有効になります**。オフにするには、変数の設定を解除します。セッションを配信または録画する場合に便利です |488| `IS_DEMO` | `1` などの空でない任意の値に設定すると、デモモードを有効にします。ヘッダーと `/status` の出力からメールアドレスと組織名を非表示にし、オンボーディングをスキップします。ほとんどのオン/オフ変数とは異なり、**`0` や `false` に設定してもデモモードは有効になります**。オフにするには変数の設定を解除してください。セッションをストリーミングまたは録画する場合に役立ちます |

483| `MAX_MCP_OUTPUT_TOKENS` | MCP ツールのレスポンスで許可される最大トークン数です(デフォルト: 25000)。出力が 10,000 トークンを超えると、Claude Code は警告を表示します。[`anthropic/maxResultSizeChars`](/docs/ja/mcp#raise-the-limit-for-a-specific-tool) を宣言しているツールは、テキストコンテンツについては代わりにその文字数制限を使用しますが、それらのツールからの画像コンテンツには引き続きこの変数が適用されます。このアノテーションのないツールからの 50,000 文字を超える成功したテキスト結果は、この変数に関係なく[ファイルに保存されます](/docs/ja/mcp#mcp-output-limits-and-warnings) |489| `MAX_MCP_OUTPUT_TOKENS` | MCP ツールのレスポンスで許可される最大トークン数(デフォルト: 25000)。出力が 10,000 トークンを超えると、Claude Code は警告を表示します。[`anthropic/maxResultSizeChars`](/docs/ja/mcp#raise-the-limit-for-a-specific-tool) を宣言しているツールは、テキストコンテンツについては代わりにその文字数制限を使用しますが、それらのツールからの画像コンテンツには引き続きこの変数が適用されます。そのアノテーションのないツールからの 50,000 文字を超える成功したテキスト結果は、この変数にかかわらず[ファイルに保存されます](/docs/ja/mcp#mcp-output-limits-and-warnings) |

484| `MAX_STRUCTURED_OUTPUT_RETRIES` | `-p` フラグを使用した非対話モードで、モデルの応答が [`--json-schema`](/docs/ja/cli-reference#cli-flags) に対する検証に失敗した場合に、Claude Code が許可する試行回数です。有効な出力が得られないままこの回数の試行が失敗すると、実行は失敗します。[ワークフロー](/docs/ja/workflows)のサブエージェントの構造化出力が検証に失敗した場合にも、同じ上限が適用されます。デフォルトは 5 で、最初の試行と 4 回の再試行です |490| `MAX_STRUCTURED_OUTPUT_RETRIES` | `-p` フラグを使用した非対話モードで、モデルの応答が [`--json-schema`](/docs/ja/cli-reference#cli-flags) に対する検証に失敗した場合に Claude Code が許可する試行回数。その回数だけ試行に失敗して有効な出力がない場合、実行は失敗します。[ワークフロー](/docs/ja/workflows)のサブエージェントの構造化出力が検証に失敗した場合にも、同じ上限が適用されます。デフォルトは 5(最初の試行と 4 回の再試行)です |

485| `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)を備えたモデルは独自に思考の深さを選択し、その他のモデルは上限を使用します。Anthropic API で思考を無効にするには `0` に設定します。ただし、Opus 5.5、Sonnet 5.5、Haiku 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_DISABLE_ADAPTIVE_THINKING` が適応型推論をオフにしている場合を除き、Claude Code は適応型推論モデルでは数値自体を無視します |491| `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)を備えたモデルは独自に思考の深さを選択し、その他のモデルは上限を使用します。Anthropic API で思考を無効にするには `0` に設定します。ただし、Opus 5.5、Sonnet 5.5、Haiku 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_DISABLE_ADAPTIVE_THINKING` で適応型推論がオフになっているときを除き、Claude Code は適応型推論モデルでは数値自体を無視します |

486| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials)を必要とする MCP サーバー用の OAuth クライアントシークレットです。`--client-secret` を指定してサーバーを追加する際の対話型プロンプトを回避します |492| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials)を必要とする MCP サーバー用の OAuth クライアントシークレット。`--client-secret` を使用してサーバーを追加する際の対話型プロンプトを回避します |

487| `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) を明示的に渡す場合、待機の期限は長くなります。キャッシュされたサーバーの例外については、そのフラグの項目を参照してください |493| `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) を明示的に渡した場合、待機の期限は長くなります。キャッシュされたサーバーの例外については、そのフラグの項目を参照してください |

488| `MCP_CONNECT_TIMEOUT_MS` | ブロッキングの MCP 起動時に、ツールリストのスナップショットを取る前に接続バッチを待機する時間(ミリ秒)です(デフォルト: 5000)。`MCP_CONNECTION_NONBLOCKING=0` の場合、または [`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) が指定されたサーバーに適用されます。期限の時点でまだ保留中のサーバーは、バックグラウンドで接続を続けます。個々のサーバーの接続試行を制限する `MCP_TIMEOUT` とは別のものです |494| `MCP_CONNECT_TIMEOUT_MS` | ブロッキングの MCP 起動が、ツールリストのスナップショットを取得する前に接続バッチを待機する時間(ミリ秒、デフォルト: 5000)。`MCP_CONNECTION_NONBLOCKING=0` の場合、または [`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) が指定されたサーバーに適用されます。期限の時点でまだ保留中のサーバーは、バックグラウンドで接続を続けます。個々のサーバーの接続試行を制限する `MCP_TIMEOUT` とは異なります |

489| `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 以降が必要です |495| `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 以降が必要です |

490| `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 は値に上限を設けていませんでした |496| `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 は値に上限を設けていませんでした |

491| `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 以降が必要です |497| `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 以降が必要です |

492| `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 は値に上限を設けていませんでした |498| `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 は値に上限を設けていませんでした |

493| `MCP_OAUTH_CALLBACK_PORT` | OAuth リダイレクトコールバック用の固定ポートです。[事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials)で MCP サーバーを追加する際の `--callback-port` の代替として使用します |499| `MCP_OAUTH_CALLBACK_PORT` | OAuth リダイレクトコールバック用の固定ポート。[事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials)を使用して MCP サーバーを追加する際の `--callback-port` の代替となります |

494| `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 以降が必要です |500| `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 以降が必要です |

495| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | 起動時に並列で接続するリモート MCP サーバー(HTTP/SSE)の最大数です(デフォルト: 20) |501| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | 起動時に並列で接続するリモート MCP サーバー(HTTP/SSE)の最大数(デフォルト: 20) |

496| `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 以降が必要です |502| `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 以降が必要です |

497| `MCP_SERVER_CONNECTION_BATCH_SIZE` | 起動時に並列で接続するローカル MCP サーバー(stdio)の最大数です(デフォルト: 3) |503| `MCP_SERVER_CONNECTION_BATCH_SIZE` | 起動時に並列で接続するローカル MCP サーバー(stdio)の最大数(デフォルト: 3) |

498| `MCP_TIMEOUT` | MCP サーバーの起動のタイムアウト(ミリ秒)です(デフォルト: 30000、つまり 30 秒) |504| `MCP_TIMEOUT` | MCP サーバーの起動のタイムアウト(ミリ秒、デフォルト: 30000、つまり 30 秒) |

499| `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 未満の値は無視されます |505| `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 未満の値は無視されます |

500| `NO_PROXY` | プロキシをバイパスしてリクエストを直接送信するドメインと IP のリストです |506| `NO_PROXY` | プロキシをバイパスして直接リクエストを送信するドメインと IP のリスト |

501| `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)を参照してください |507| `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)を参照してください |

502| `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)を参照してください |508| `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)を参照してください |

503| `OTEL_LOG_MANAGED_SETTINGS` | `1` に設定すると、秘匿化された管理設定と、秘匿化前の設定の SHA-256 ダイジェストを `managed_settings_resolved` OpenTelemetry ログイベントに追加します。デフォルトでは無効です。シェル、ユーザー設定、または管理設定で設定します。プロジェクト設定やローカル設定の値ではオンになりません。Claude Code v2.1.274 以降が必要です。[モニタリング](/docs/ja/monitoring-usage#managed-settings-resolved-event)を参照してください |509| `OTEL_LOG_MANAGED_SETTINGS` | `1` に設定すると、秘匿処理された管理設定と、秘匿処理前の設定の SHA-256 ダイジェストを `managed_settings_resolved` OpenTelemetry ログイベントに追加します。デフォルトでは無効です。シェル、ユーザー設定、または管理設定で設定します。プロジェクト設定やローカル設定の値ではオンになりません。Claude Code v2.1.274 以降が必要です。[モニタリング](/docs/ja/monitoring-usage#managed-settings-resolved-event)を参照してください |

504| `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)を参照してください |510| `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)を参照してください |

505| `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)を参照してください |511| `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)を参照してください |

506| `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)を参照してください |512| `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)を参照してください |

507| `OTEL_LOG_USER_PROMPTS` | `1` に設定すると、OpenTelemetry のトレースとログにユーザーのプロンプトテキストを含めます。デフォルトでは無効です(プロンプトは秘匿化されます)。シェル、ユーザー設定、または管理設定で設定します。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では、そのセクションで説明されているオフの値を除き、無視されます。[モニタリング](/docs/ja/monitoring-usage)を参照してください |513| `OTEL_LOG_USER_PROMPTS` | `1` に設定すると、OpenTelemetry のトレースとログにユーザーのプロンプトテキストを含めます。デフォルトでは無効です(プロンプトは秘匿されます)。シェル、ユーザー設定、または管理設定で設定します。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では、そのセクションで説明されているオフの値を除き、無視されます。[モニタリング](/docs/ja/monitoring-usage)を参照してください |

508| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | `false` に設定すると、メトリクス属性からアカウント UUID を除外します(デフォルト: 含める)。[モニタリング](/docs/ja/monitoring-usage)を参照してください |514| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | `false` に設定すると、メトリクス属性からアカウント UUID を除外します(デフォルト: 含める)。[モニタリング](/docs/ja/monitoring-usage)を参照してください |

509| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | `true` に設定すると、メトリクス属性にセッションのエントリポイントを含めます(デフォルト: 除外)。v2.1.152 で追加されました。[モニタリング](/docs/ja/monitoring-usage)を参照してください |515| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | `true` に設定すると、メトリクス属性にセッションのエントリポイントを含めます(デフォルト: 除外)。v2.1.152 で追加されました。[モニタリング](/docs/ja/monitoring-usage)を参照してください |

510| `OTEL_METRICS_INCLUDE_REPOSITORY` | `true` に設定すると、セッションのリポジトリを識別する `vcs.*` 属性で OpenTelemetry のメトリクスとイベントにタグを付けます(デフォルト: 除外)。Claude Code v2.1.269 以降が必要です。[リポジトリ属性](/docs/ja/monitoring-usage#repository-attributes)を参照してください |516| `OTEL_METRICS_INCLUDE_REPOSITORY` | `true` に設定すると、OpenTelemetry のメトリクスとイベントに、セッションのリポジトリを識別する `vcs.*` 属性をタグ付けします(デフォルト: 除外)。Claude Code v2.1.269 以降が必要です。[リポジトリ属性](/docs/ja/monitoring-usage#repository-attributes)を参照してください |

511| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | v2.1.161 以降、Claude Code は `OTEL_RESOURCE_ATTRIBUTES` のキーをメトリクスのデータポイントラベルに付加します。除外するには `false` に設定します(デフォルト: 含める)。[モニタリング](/docs/ja/monitoring-usage#multi-team-organization-support)を参照してください |517| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | v2.1.161 以降、Claude Code は `OTEL_RESOURCE_ATTRIBUTES` のキーをメトリクスのデータポイントのラベルに付加します。除外するには `false` に設定します(デフォルト: 含める)。[モニタリング](/docs/ja/monitoring-usage#multi-team-organization-support)を参照してください |

512| `OTEL_METRICS_INCLUDE_SESSION_ID` | `false` に設定すると、メトリクス属性からセッション ID を除外します(デフォルト: 含める)。[モニタリング](/docs/ja/monitoring-usage)を参照してください |518| `OTEL_METRICS_INCLUDE_SESSION_ID` | `false` に設定すると、メトリクス属性からセッション ID を除外します(デフォルト: 含める)。[モニタリング](/docs/ja/monitoring-usage)を参照してください |

513| `OTEL_METRICS_INCLUDE_VERSION` | `true` に設定すると、メトリクス属性に Claude Code のバージョンを含めます(デフォルト: 除外)。[モニタリング](/docs/ja/monitoring-usage)を参照してください |519| `OTEL_METRICS_INCLUDE_VERSION` | `true` に設定すると、メトリクス属性に Claude Code のバージョンを含めます(デフォルト: 除外)。[モニタリング](/docs/ja/monitoring-usage)を参照してください |

514| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | [Skill ツール](/docs/ja/skills#control-who-invokes-a-skill)に表示されるスキルメタデータの文字数予算を上書きします。予算はコンテキストウィンドウの 1% として動的にスケーリングされ、フォールバック値は 8,000 文字です。後方互換性のために従来の名前が維持されています |520| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | [Skill ツール](/docs/ja/skills#control-who-invokes-a-skill)に表示されるスキルのメタデータの文字数予算を上書きします。予算はコンテキストウィンドウの 1% で動的にスケールし、フォールバック値は 8,000 文字です。後方互換性のために従来の名前が維持されています |

515| `TASK_MAX_OUTPUT_LENGTH` | v2.1.277 で、この変数がサイズを決めていた `TaskOutput` ツールとともに削除され、現在は何の効果もありません。以前は、`TaskOutput` ツールが保持する[バックグラウンドタスク](/docs/ja/tools-reference#background-commands)の出力の最大文字数を設定していました。現在、Claude は代わりに `Read` でバックグラウンドタスクの出力ファイルを読み取ります |521| `TASK_MAX_OUTPUT_LENGTH` | v2.1.277 で、この変数がサイズを決めていた `TaskOutput` ツールとともに削除され、現在は何の効果もありません。以前は、`TaskOutput` ツールが保持する[バックグラウンドタスク](/docs/ja/tools-reference#background-commands)の出力の最大文字数を設定していました。現在、Claude は代わりに `Read` でバックグラウンドタスクの出力ファイルを読み取ります |

516| `USE_BUILTIN_RIPGREP` | `0` に設定すると、Claude Code に含まれる `rg` の代わりに、システムにインストールされている `rg` を使用します |522| `USE_BUILTIN_RIPGREP` | `0` に設定すると、Claude Code に含まれる `rg` の代わりにシステムにインストールされた `rg` を使用します |

517| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Google Cloud's Agent Platform を使用する場合の Claude 3.5 Haiku のリージョンを上書きします |523| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Google Cloud's Agent Platform を使用する場合の Claude 3.5 Haiku のリージョンを上書きします |

518| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Google Cloud's Agent Platform を使用する場合の Claude 3.5 Sonnet のリージョンを上書きします |524| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Google Cloud's Agent Platform を使用する場合の Claude 3.5 Sonnet のリージョンを上書きします |

519| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Google Cloud's Agent Platform を使用する場合の Claude 3.7 Sonnet のリージョンを上書きします |525| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Google Cloud's Agent Platform を使用する場合の Claude 3.7 Sonnet のリージョンを上書きします |


537 543 

538標準の 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)を参照してください。544標準の 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)を参照してください。

539 545 

540`CLAUDE_CODE_ENABLE_TELEMETRY` と、エクスポートをオンにする、エクスポート先を選択する、またはコンテンツをキャプチャする OpenTelemetry 変数は、シェル、ユーザー設定、または管理設定で設定します。Claude Code は、そのセクションで説明されているオフの値を除き、[プロジェクト設定とローカル設定ではこれらを無視します](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)。`OTEL_RESOURCE_ATTRIBUTES` と、`OTEL_METRIC_EXPORT_INTERVAL` などのエクスポート間隔、タイムアウト、圧縮の変数は、プロジェクト設定とローカル設定からも引き続き適用されます。546`CLAUDE_CODE_ENABLE_TELEMETRY` と、エクスポートをオンにする、エクスポート先を選択する、またはコンテンツを取得する OpenTelemetry 変数は、シェル、ユーザー設定、または管理設定で設定します。Claude Code は、そのセクションで説明されているオフの値を除き、[プロジェクト設定とローカル設定ではこれらを無視します](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)。`OTEL_RESOURCE_ATTRIBUTES` と、`OTEL_METRIC_EXPORT_INTERVAL` などのエクスポート間隔、タイムアウト、圧縮に関する変数は、プロジェクト設定とローカル設定からも引き続き適用されます。

541 547 

542<h2 id="what-the-subprocess-environment-scrub-removes">548<h2 id="what-the-subprocess-environment-scrub-removes">

543 サブプロセス環境のスクラブで削除されるもの549 サブプロセス環境のスクラブで削除されるもの


590* [アドバイザーツール](/docs/ja/advisor#requirements)を使用する596* [アドバイザーツール](/docs/ja/advisor#requirements)を使用する

591* [アーティファクトへのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact)を読む、または返信する597* [アーティファクトへのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact)を読む、または返信する

592* Claude に[別の組織の公開アーティファクト](/docs/ja/artifacts#read-an-artifact-shared-with-you)を読ませる598* Claude に[別の組織の公開アーティファクト](/docs/ja/artifacts#read-an-artifact-shared-with-you)を読ませる

593* `MCP_PROTOCOL_NEGOTIATION=auto` を設定しない限り、Claude Code に claude.ai コネクタサーバーに対して [MCP プロトコルリビジョン 2026-07-28](/docs/ja/mcp#mcp-client-runtimes) をプローブさせる

594* 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 では、このツールはオンのままです599* 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 では、このツールはオンのままです

595* [Claude が下書きするフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を利用する。この機能は、Claude Code が取得したフラグによってオンにします600* [Claude が下書きするフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を利用する。この機能は、Claude Code が取得したフラグによってオンにします

596* Claude に[大きな貼り付けを、入力したテキストではなく貼り付けたテキストとして扱わせる](/docs/ja/terminal-config#how-claude-treats-pasted-text)。`[Pasted text #N]` プレースホルダーの背後にあるコンテンツは、マークなしで Claude に届きます601* Claude に[大きな貼り付けを、入力したテキストではなく貼り付けたテキストとして扱わせる](/docs/ja/terminal-config#how-claude-treats-pasted-text)。`[Pasted text #N]` プレースホルダーの背後にあるコンテンツは、マークなしで Claude に届きます

errors.md +9 −54

Details

189| `<model> has safety measures that flagged this message for a cybersecurity topic` | [リクエストエラー](#safety-measures-flagged-a-cybersecurity-topic) |189| `<model> has safety measures that flagged this message for a cybersecurity topic` | [リクエストエラー](#safety-measures-flagged-a-cybersecurity-topic) |

190| `` Details: `[reasoning_extraction]` `` | [リクエストエラー](#safeguards-flagged-a-request-for-claudes-reasoning) |190| `` Details: `[reasoning_extraction]` `` | [リクエストエラー](#safeguards-flagged-a-request-for-claudes-reasoning) |

191| `API Error: Output blocked by content filtering policy` | [リクエストエラー](#output-blocked-by-content-filtering-policy) |191| `API Error: Output blocked by content filtering policy` | [リクエストエラー](#output-blocked-by-content-filtering-policy) |

192| `Installation was killed before it could finish (exit code 137)` | [インストールエラー](#installation-was-killed-before-it-could-finish) |192| `Installation was killed before it could finish (exit code 137)` | [インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install#installation-was-killed-before-it-could-finish) |

193| `The connection dropped while downloading the update` | [インストールエラー](#the-connection-dropped-while-downloading-the-update) |193| `The connection dropped while downloading the update` | [インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |

194| `Download timed out: exceeded the total deadline` | [インストールエラー](#the-connection-dropped-while-downloading-the-update) |194| `Download timed out: exceeded the total deadline` | [インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |

195| `--bg and --print conflict` | [コマンドラインエラー](#conflict-between-bg-and-print) |195| `--bg and --print conflict` | [コマンドラインエラー](#conflict-between-bg-and-print) |

196| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [コマンドラインエラー](#conflict-between-a-system-prompt-flag-and-its-file-form) |196| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [コマンドラインエラー](#conflict-between-a-system-prompt-flag-and-its-file-form) |

197| `Cloud sessions cannot be created from a --restricted session` | [コマンドラインエラー](#cloud-sessions-cannot-be-created-from-a-restricted-session) |197| `Cloud sessions cannot be created from a --restricted session` | [コマンドラインエラー](#cloud-sessions-cannot-be-created-from-a-restricted-session) |


261| `Marketplace name impersonates an official Anthropic/Claude marketplace` | [プラグインエラー](#claude-code-refuses-the-marketplace-name) |261| `Marketplace name impersonates an official Anthropic/Claude marketplace` | [プラグインエラー](#claude-code-refuses-the-marketplace-name) |

262| `Marketplace "<name>" is already added from a different source` | [プラグインエラー](#marketplace-is-already-added-from-a-different-source) |262| `Marketplace "<name>" is already added from a different source` | [プラグインエラー](#marketplace-is-already-added-from-a-different-source) |

263| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [プラグインエラー](#marketplace-name-is-another-spelling-of-a-reserved-name) |263| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [プラグインエラー](#marketplace-name-is-another-spelling-of-a-reserved-name) |

264| `Cannot add marketplace "<name>": Claude Code cannot install plugins from a marketplace with this name` | [プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting#cannot-install-plugins-from-a-marketplace-with-this-name) |

264| `Marketplace "<name>" is added but ignored` | [プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting#marketplace-is-added-but-ignored) |265| `Marketplace "<name>" is added but ignored` | [プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting#marketplace-is-added-but-ignored) |

265| `Marketplace "<name>" is registered but was refused (see the debug log)` | [プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting#marketplace-is-added-but-ignored) |266| `Marketplace "<name>" is registered but was refused (see the debug log)` | [プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting#marketplace-is-added-but-ignored) |

266| `references ${user_config.*} in a shell-form command` | [プラグインエラー](#plugin-command-references-user-config) |267| `references ${user_config.*} in a shell-form command` | [プラグインエラー](#plugin-command-references-user-config) |


269| `Plugin archive integrity check failed` | [プラグインエラー](#plugin-archive-integrity-check-failed) |270| `Plugin archive integrity check failed` | [プラグインエラー](#plugin-archive-integrity-check-failed) |

270| `An npm plugin source must name a registry package` | [プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting#an-npm-plugin-source-must-name-a-registry-package) |271| `An npm plugin source must name a registry package` | [プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting#an-npm-plugin-source-must-name-a-registry-package) |

271| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting#the-packages-it-lists-are-not-installed) |272| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting#the-packages-it-lists-are-not-installed) |

273| `does not load (...), so Claude Code ignores the whole file` | [プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting#does-not-load-so-claude-code-ignores-the-whole-file) |

272| `path escapes plugin directory` | [プラグインエラー](#path-escapes-plugin-directory) |274| `path escapes plugin directory` | [プラグインエラー](#path-escapes-plugin-directory) |

273| `path could not be checked` | [プラグインエラー](#path-could-not-be-checked) |275| `path could not be checked` | [プラグインエラー](#path-could-not-be-checked) |

274| `its marketplace entry path does not stay inside the marketplace directory` | [プラグインエラー](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |276| `its marketplace entry path does not stay inside the marketplace directory` | [プラグインエラー](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |


279| `"<plugin>" was not uninstalled: it is still switched on in <file>` | [プラグインエラー](#plugin-was-not-uninstalled) |281| `"<plugin>" was not uninstalled: it is still switched on in <file>` | [プラグインエラー](#plugin-was-not-uninstalled) |

280| `"<plugin>" was not uninstalled: <file> is there and could not be read` | [プラグインエラー](#plugin-was-not-uninstalled) |282| `"<plugin>" was not uninstalled: <file> is there and could not be read` | [プラグインエラー](#plugin-was-not-uninstalled) |

281| `Plugin "<plugin>" was not uninstalled: installed_plugins.json` | [プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting#installed-plugins-json-holds-a-record-this-version-cannot-read) |283| `Plugin "<plugin>" was not uninstalled: installed_plugins.json` | [プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting#installed-plugins-json-holds-a-record-this-version-cannot-read) |

284| `Plugin directory does not exist: <path>` | [プラグインのトラブルシューティング](/docs/ja/plugins/troubleshooting#plugin-directory-does-not-exist) |

282| `Error: No such tool available: <tool name>` | [ツールエラー](#no-such-tool-available) |285| `Error: No such tool available: <tool name>` | [ツールエラー](#no-such-tool-available) |

283| `would be spawned with zero tools — refusing` | [ツールエラー](#agent-would-be-spawned-with-zero-tools) |286| `would be spawned with zero tools — refusing` | [ツールエラー](#agent-would-be-spawned-with-zero-tools) |

284| `File is covered by a Read deny rule in your permission settings` | [ツールエラー](#file-is-covered-by-a-read-deny-rule) |287| `File is covered by a Read deny rule in your permission settings` | [ツールエラー](#file-is-covered-by-a-read-deny-rule) |


386* Claude が思考を終えた後、テキストやツール呼び出しを開始する前に発生したサーバーエラーまたは過負荷レスポンス。その時点でのサーバーエラーについて、Claude Code は最大 2 回まで再試行します。v2.1.284 より前は、Claude Code はその時点でエラーとともにターンを終了していました。389* Claude が思考を終えた後、テキストやツール呼び出しを開始する前に発生したサーバーエラーまたは過負荷レスポンス。その時点でのサーバーエラーについて、Claude Code は最大 2 回まで再試行します。v2.1.284 より前は、Claude Code はその時点でエラーとともにターンを終了していました。

387* 切断された接続。Claude が思考を含む応答のいずれの部分も完了する前にリクエストの途中で接続が切断された場合、Claude Code は同じバックオフでリクエストを再発行し、一部のテキストがすでにストリーミングを開始していてもターンは継続します。Claude が思考を終えた後、テキストやツール呼び出しを開始する前に切断された場合は、代わりに Claude Code は短い間隔で最大 2 回までリクエストを再発行し、その時点で接続の切断が続く場合は `Connection lost before a response was produced` でターンを終了します。390* 切断された接続。Claude が思考を含む応答のいずれの部分も完了する前にリクエストの途中で接続が切断された場合、Claude Code は同じバックオフでリクエストを再発行し、一部のテキストがすでにストリーミングを開始していてもターンは継続します。Claude が思考を終えた後、テキストやツール呼び出しを開始する前に切断された場合は、代わりに Claude Code は短い間隔で最大 2 回までリクエストを再発行し、その時点で接続の切断が続く場合は `Connection lost before a response was produced` でターンを終了します。

388* リクエストの途中でコンピューターがスリープ状態になったことで切断されたと Claude Code が検出した接続。Claude Code はこれを上記のルールに従い切断された接続として扱います。再試行ラベルが具体的な理由を示すようになると `Connection lost while your computer was asleep` と表示され、Claude が思考を終えた後、テキストやツール呼び出しの前にターンが終了した場合、メッセージは `Your computer went to sleep before a response was produced` となります。391* リクエストの途中でコンピューターがスリープ状態になったことで切断されたと Claude Code が検出した接続。Claude Code はこれを上記のルールに従い切断された接続として扱います。再試行ラベルが具体的な理由を示すようになると `Connection lost while your computer was asleep` と表示され、Claude が思考を終えた後、テキストやツール呼び出しの前にターンが終了した場合、メッセージは `Your computer went to sleep before a response was produced` となります。

389* 停止した応答ストリーム。レスポンスヘッダーは届いたものの Claude の応答がまったく届いていない場合、または Claude が思考を終えたもののテキストやツール呼び出しを開始していない場合です。Claude Code は停止した接続を中断し、上記の 10 回の試行回数とは別に、最大 1 回だけリクエストを再発行します。Claude が思考を終えた後、テキストやツール呼び出しの前に応答が 2 回目に停止した場合、Claude Code は `The response stalled before a response was produced` でターンを終了します。392* 停止した応答ストリーム。レスポンスヘッダーは届いたものの Claude の応答がまったく届いていない場合、または Claude が思考を終えたもののテキストやツール呼び出しを開始していない場合です。Claude Code は停止した接続を中断し、最大 1 回だけリクエストを再度ストリーミングします。Claude が思考を終えた後、テキストやツール呼び出しの前に応答が 2 回目に停止した場合、Claude Code は `The response stalled before a response was produced` でターンを終了します。

390* [ファーストバイトの期限が適用される](/docs/ja/network-config#streaming-idle-watchdogs)接続で、API がレスポンスヘッダーを返さないストリーミングリクエスト。Claude Code は期限の時点でそれを中断し、再試行回数の範囲内で、モデルリクエストごとに最大 1 回だけ再送信します。その試行にも応答がない場合は、[No response from API](#no-response-from-api) でターンを終了します。その他の接続では、リクエストは `API_TIMEOUT_MS` まで待機します。`CLAUDE_CODE_RETRY_WATCHDOG` を設定している場合、1 回の再試行という上限は適用されません。393* [ファーストバイトの期限が適用される](/docs/ja/network-config#streaming-idle-watchdogs)接続で、API がレスポンスヘッダーを返さないストリーミングリクエスト。Claude Code は期限の時点でそれを中断し、再試行回数の範囲内で、モデルリクエストごとに最大 1 回だけ再送信します。その試行にも応答がない場合は、[No response from API](#no-response-from-api) でターンを終了します。その他の接続では、リクエストは `API_TIMEOUT_MS` まで待機します。`CLAUDE_CODE_RETRY_WATCHDOG` を設定している場合、1 回の再試行という上限は適用されません。

391* Claude が思考を終えるか、テキストやツール呼び出しを開始する前に、API の出力コンテンツフィルターによって停止されたストリーミングレスポンス。Claude Code は再試行回数の範囲内でリクエストを 1 回再送信し、フィルターが 2 回目の応答も停止した場合は [Output blocked by content filtering policy](#output-blocked-by-content-filtering-policy) を表示します。394* Claude が思考を終えるか、テキストやツール呼び出しを開始する前に、API の出力コンテンツフィルターによって停止されたストリーミングレスポンス。Claude Code は再試行回数の範囲内でリクエストを 1 回再送信し、フィルターが 2 回目の応答も停止した場合は [Output blocked by content filtering policy](#output-blocked-by-content-filtering-policy) を表示します。

392* 一時的な 429 スロットリング。ただし、ゲートウェイの支出上限による `429` はスロットリングではないため含まれません。[Spend limit reached](#spend-limit-reached) を参照してください。395* 一時的な 429 スロットリング。ただし、ゲートウェイの支出上限による `429` はスロットリングではないため含まれません。[Spend limit reached](#spend-limit-reached) を参照してください。


2910* 最後のメッセージを言い換えるか、別のアプローチを試してください2913* 最後のメッセージを言い換えるか、別のアプローチを試してください

2911* ブロックをトリガーしたターンの前のチェックポイントに戻るには、Esc キーを 2 回押すか、`/rewind` を実行してください。[チェックポイント機能](/docs/ja/checkpointing)を参照してください2914* ブロックをトリガーしたターンの前のチェックポイントに戻るには、Esc キーを 2 回押すか、`/rewind` を実行してください。[チェックポイント機能](/docs/ja/checkpointing)を参照してください

2912 2915 

2913<h2 id="installation-errors">

2914 インストールエラー

2915</h2>

2916 

2917これらのエラーは、[インストールスクリプト](/docs/ja/setup#install-claude-code)、`claude install`、または `claude update` から Claude Code をインストールまたは更新する際に表示されます。セットアップ中の `command not found`、PATH、権限、および TLS の問題については、[インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install)を参照してください。

2918 

2919<h3 id="installation-was-killed-before-it-could-finish">

2920 インストールが完了する前に終了されました

2921</h3>

2922 

2923インストールスクリプトは、`claude install` ステップがシグナルによって終了されたときに報告します。Linux では、終了コード 137 はプロセスが SIGKILL を受け取ったことを意味し、メモリが少ないホストでは通常、カーネルのメモリ不足(OOM)キラーです。スクリプトはこの説明を出力し、コード 137 で終了します。

2924 

2925```text theme={null}

2926Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

2927Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

2928```

2929 

2930その他の致命的なシグナルの場合、および macOS でのコード 137 の場合、スクリプトは `Installation was killed before it could finish (exit code <N>)` を出力し、実際の終了コードを表示し、メモリ不足の説明は省略します。メッセージは macOS と Linux が使用するインストールスクリプトから来ており、WSL 内のインストールもカバーしています。ネイティブ Windows インストールスクリプトはこれを出力しません。v2.1.200 より前では、スクリプトはシェルの単なる `Killed` 行でのみ終了していました。

2931 

2932**対処方法:**

2933 

2934* 他のプロセスを停止してメモリを解放し、インストーラーを再実行します

2935* スワップスペースを追加するか、より大きなインスタンスに移動します。[低メモリ Linux サーバーでのインストール終了](/docs/ja/troubleshoot-install#install-killed-on-low-memory-linux-servers)を参照して、スワップファイルコマンドを確認してください。

2936 

2937<h3 id="the-connection-dropped-while-downloading-the-update">

2938 更新のダウンロード中に接続が切断されました

2939</h3>

2940 

2941ダウンロードサーバーへの接続が `claude install` または `claude update` が Claude Code バイナリをフェッチしている間に閉じられ、リトライが回復しませんでした。Claude Code は、接続がドロップされた場合、転送が停止した場合、またはダウンロードされたファイルがチェックサムに失敗した場合、最大 3 回の試行でダウンロードを再試行します。404 などの完了した HTTP エラーは、サーバーが既に応答しているため再試行されません。v2.1.202 より前では、単一の接続ドロップはダウンロードを即座に失敗させ、リトライの代わりに単なるエラー `aborted` を表示していました。

2942 

2943```text theme={null}

2944The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

2945```

2946 

2947括弧内のテキストは、失敗した試行と基になるネットワークエラーを示します。`claude update` は stderr でメッセージの前に `Error: Failed to install native update` を付けます。

2948 

2949接続は保持されているがダウンロードが 10 分以内に完了しない場合、代わりに `Download timed out: exceeded the total deadline` で失敗します。Claude Code はタイムアウトしたダウンロードを再試行しません。期限内に完了するのに十分な速度がない接続は、即座に再試行しても完了しないためです。以下の手順は両方のメッセージに適用されます。

2950 

2951プロキシまたはゲートウェイは、完了する前に長い転送を閉じることができ、Claude Code バイナリは大きなダウンロードです。

2952 

2953**対処方法:**

2954 

2955* `claude update` を再度実行します。それ以外の場合は健全なネットワークで、ダウンロードは通常、次の実行で成功します。タイムアウトメッセージの場合は、より高速またはスロットルされていないネットワークから再度実行します。

2956* ネットワークがプロキシを必要とする場合は、インストーラーまたは `claude update` を実行する前に `HTTPS_PROXY` を設定します。[ネットワーク接続の確認](/docs/ja/troubleshoot-install#check-network-connectivity)を参照してください。

2957* 企業プロキシが転送を閉じ続ける場合は、ネットワークチームに `downloads.claude.ai` からの完全なダウンロードを許可するよう依頼します。[ネットワークアクセス要件](/docs/ja/network-config#network-access-requirements)を参照してください。

2958* シェルから `claude doctor` を実行して、インストール診断を実行します

2959 

2960<h2 id="command-line-errors">2916<h2 id="command-line-errors">

2961 コマンドラインのエラー2917 コマンドラインのエラー

2962</h2>2918</h2>


4064 マーケットプレイスは既に別のソースから追加されています4020 マーケットプレイスは既に別のソースから追加されています

4065</h3>4021</h3>

4066 4022 

4067[`/plugin install <plugin> --marketplace <source>`](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command)を通じてマーケットプレイスの追加を確認し、そのソースから Claude Code が取得したカタログは、既に別のソースから追加したマーケットプレイスと同じ名前で自分自身に名前を付けます。Claude Code は既存のマーケットプレイスを保持し、それを置き換えず、プラグインはインストールされません。4023セッション内またはシェルから、[インストールコマンドの `--marketplace <source>`](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command) で新しいマーケットプレイスソースを指定しました。Claude Code がそのソースから取得したカタログは、既に別のソースから追加したマーケットプレイスと同じ名前を持っています。Claude Code は既存のマーケットプレイスを置き換えずに保持し、プラグインはインストールされません。

4068 4024 

4069```text theme={null}4025```text theme={null}

4070Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.4026Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.


4817 This session has no saved transcript4773 This session has no saved transcript

4818</h3>4774</h3>

4819 4775 

4820停止した[バックグラウンドセッション](/docs/ja/agent-view)に接続しました。このセッションは `←` または `/background` で別の会話からバックグラウンドに移動され、最初の応答が完了する前に停止しました。その最初の応答が完了するまで、会話はバックグラウンドに移動した元のセッションにのみ存在するため、`claude attach` は停止したセッションの開始を拒否し、同じセッション ID で空白の会話を開始しません。メッセージは、このセッションの `claude respawn` コマンドで終わります:4776`←` または `/background` で[バックグラウンドに移動](/docs/ja/agent-view#from-inside-a-session)し、自身のターンを実行する前に停止したセッションに接続しました。Claude Code は移動元の会話を見つけられなかったため、このセッションには再開するものがありません。メッセージは、このセッションの `claude respawn` コマンドで終わります:

4821 4777 

4822```text theme={null}4778```text theme={null}

4823This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.4779This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.


4827 4783 

4828**対処方法:**4784**対処方法:**

4829 4785 

4830* バックグラウンドに移動した会話は無傷です:[`claude --resume`](/docs/ja/sessions) で再開するか、そこで作業を続けます

4831* 停止したセッションを新しく開始するには、メッセージの ID で `claude respawn <id>` を実行するか、エージェントビューの行で `Enter` を 2 回押します4786* 停止したセッションを新しく開始するには、メッセージの ID で `claude respawn <id>` を実行するか、エージェントビューの行で `Enter` を 2 回押します

4832* セッションが応答を完了し、v2.1.214 より前のバージョンでこの拒否が表示される場合、`~/.claude/projects` の読み取り不可フォルダがトランスクリプトスキャンが保存された会話を見つけるのを妨げる可能性があります。v2.1.214 以降にアップグレードしてください。これはスキャン中に読み取り不可フォルダを許容します4787* セッションが応答を完了し、v2.1.214 より前のバージョンでこの拒否が表示される場合、`~/.claude/projects` の読み取り不可フォルダがトランスクリプトスキャンが保存された会話を見つけるのを妨げる可能性があります。v2.1.214 以降にアップグレードしてください。これはスキャン中に読み取り不可フォルダを許容します

4833 4788 

glossary.md +2 −2

Details

465 465 

466コマンド `/teleport`。クラウド Claude Code セッションをローカルターミナルにプルします。Claude はブランチをフェッチし、会話履歴をロードし、クラウドセッションの最後の状態から再開します。逆方向は `--cloud` です。ローカルタスクをクラウドで実行するために送信します。466コマンド `/teleport`。クラウド Claude Code セッションをローカルターミナルにプルします。Claude はブランチをフェッチし、会話履歴をロードし、クラウドセッションの最後の状態から再開します。逆方向は `--cloud` です。ローカルタスクをクラウドで実行するために送信します。

467 467 

468詳細情報: [クラウドからターミナルへ](/docs/ja/claude-code-on-the-web#from-cloud-to-terminal)468詳細情報: [ターミナルでクラウドセッションを続行する](/docs/ja/claude-code-on-the-web#from-cloud-to-terminal)

469 469 

470<h3 id="tool">470<h3 id="tool">

471 Tool471 Tool


511 Worktree isolation511 Worktree isolation

512</h3>512</h3>

513 513 

514Claude を `.claude/worktrees/` の別の git worktree で実行する分離モード。`-w` フラグまたは subagent 設定の `isolation: worktree` で有効にされます。変更は別のブランチの別のディレクトリに留まるため、並列エージェントはお互いのファイルを上書きしません。514Claude を `.claude/worktrees/` の別の git worktree で実行する分離モード。`-w` フラグまたはサブエージェント設定の `isolation: worktree` で有効にされます。変更は別のディレクトリの別のブランチに留まるため、並列エージェントはそれぞれ自分用のファイルのコピーを編集します。

515 515 

516詳細情報: [git worktrees を使用した並列セッションの実行](/docs/ja/worktrees)516詳細情報: [git worktrees を使用した並列セッションの実行](/docs/ja/worktrees)

517 517 

goal.md +1 −1

Details

127claude -p "/goal CHANGELOG.md has an entry for every PR merged this week"127claude -p "/goal CHANGELOG.md has an entry for every PR merged this week"

128```128```

129 129 

130デフォルトのテキスト出力では、実行が終了するまで何も出力されないため、多くのターンを実行するゴールは停止しているように見える場合があります。`--output-format stream-json --verbose` を追加して、ループの実行時に各メッセージを出力します。130デフォルトのテキスト出力では、ループが終了したときに Claude の最終応答が出力されるため、多くのターンを実行するゴールは停止しているように見える場合があります。`--output-format stream-json --verbose` を追加して、ループの実行時に各メッセージを出力します。

131 131 

132Ctrl+C でプロセスを中断して、解決前に非対話的なゴールを停止します。132Ctrl+C でプロセスを中断して、解決前に非対話的なゴールを停止します。

133 133 

headless.md +12 −10

Details

35Claude Code は成功時にコード 0 で終了し、実行が失敗した場合は 0 以外のコードで終了するため、スクリプトは終了ステータスで分岐できます。無効なフラグを渡すと、Claude Code は実行開始前にエラーを stderr に報告します。実行内で認証の欠落など障害が発生した場合、Claude Code は障害を stdout の結果として出力します。35Claude Code は成功時にコード 0 で終了し、実行が失敗した場合は 0 以外のコードで終了するため、スクリプトは終了ステータスで分岐できます。無効なフラグを渡すと、Claude Code は実行開始前にエラーを stderr に報告します。実行内で認証の欠落など障害が発生した場合、Claude Code は障害を stdout の結果として出力します。

36 36 

37<h3 id="start-faster-with-bare-mode">37<h3 id="start-faster-with-bare-mode">

38 ベアモードで高速に開始する38 bare モードで高速に開始する

39</h3>39</h3>

40 40 

41`--bare` を追加して、hooks、skills、カスタムコマンド、[subagents](/docs/ja/sub-agents)、インストール済みプラグイン、MCP サーバー、自動メモリ、CLAUDE.md の自動検出をスキップすることで、起動時間を短縮します。これがない場合、`claude -p` は対話的セッションと同じ [コンテキスト](/docs/ja/how-claude-code-works#the-context-window) を読み込みます。これには、作業ディレクトリまたは `~/.claude` で設定されたすべてが含まれます。41`--bare` を追加して、フック、スキル、カスタムコマンド、[サブエージェント](/docs/ja/sub-agents)、インストール済みプラグイン、MCP サーバー、自動メモリ、CLAUDE.md の自動検出をスキップすることで、起動時間を短縮します。これがない場合、`claude -p` は対話的セッションと同じ [コンテキスト](/docs/ja/how-claude-code-works#the-context-window) を読み込みます。これには、作業ディレクトリまたは `~/.claude` で設定されたすべてが含まれます。

42 42 

43ベアモードは、すべてのマシンで同じ結果が必要な CI とスクリプトに役立ちます。チームメイトの `~/.claude` のフック、またはプロジェクトの `.mcp.json` の MCP サーバーは実行されません。ベアモードはそれらを読み込まないためです。`--add-dir` で指定するディレクトリは部分的な例外です。ベアモードはその `.claude/skills/` フォルダから skills を読み込みますが、その `.claude/commands/` と `.claude/agents/` フォルダはスキップします。[追加ディレクトリからの Skills](/docs/ja/skills#skills-from-additional-directories) は、何が読み込まれ、何が読み込まれないかについて説明しています。43bare モードは、すべてのマシンで同じ結果が必要な CI とスクリプトに役立ちます。チームメイトの `~/.claude` のフック、またはプロジェクトの `.mcp.json` の MCP サーバーは実行されません。bare モードはそれらを読み込まないためです。`--add-dir` で指定するディレクトリは部分的な例外です。bare モードはその `.claude/skills/` フォルダからスキルを読み込みますが、その `.claude/commands/` と `.claude/agents/` フォルダはスキップします。[追加ディレクトリからのスキル](/docs/ja/skills#skills-from-additional-directories) は、何が読み込まれ、何が読み込まれないかについて説明しています。

44 44 

45`--bare` がない場合、`-p` セッションはプロジェクトの `.claude/settings.json` のフックを実行し、その `.mcp.json` のサーバーに接続します。これは、信頼したことのないフォルダでも同様です。`-p` セッションはワークスペース信頼ダイアログもサーバーごとの承認プロンプトも表示しません。[フォルダを信頼する前に実行されるもの](/docs/ja/permissions#what-runs-before-you-trust-a-folder) は、`-p` の下での各種リポジトリコンテンツと、それを除外する方法について説明しています。45`--bare` がない場合、`-p` セッションはプロジェクトの `.claude/settings.json` のフックを実行し、その `.mcp.json` のサーバーに接続します。これは、信頼したことのないフォルダでも同様です。`-p` セッションはワークスペース信頼ダイアログもサーバーごとの承認プロンプトも表示しません。[フォルダを信頼する前に実行されるもの](/docs/ja/permissions#what-runs-before-you-trust-a-folder) は、`-p` の下での各種リポジトリコンテンツと、それを除外する方法について説明しています。

46 46 

47この例は、ベアモードで 1 回限りの要約タスクを実行し、Read ツールを事前承認して、権限プロンプトなしで呼び出しが完了するようにします。ベアモードはサブスクリプションログインを使用しないため、実行前に `ANTHROPIC_API_KEY` を設定してください。47この例は、bare モードで 1 回限りの要約タスクを実行し、Read ツールを事前承認して、権限プロンプトなしで呼び出しが完了するようにします。bare モードはサブスクリプションログインを使用しないため、実行前に `ANTHROPIC_API_KEY` を設定してください。

48 48 

49```bash theme={null}49```bash theme={null}

50claude --bare -p "Summarize README.md" --allowedTools "Read"50claude --bare -p "Summarize README.md" --allowedTools "Read"

51```51```

52 52 

53ベアモードでは、Claude Code は OAuth 認証情報またはシステムキーチェーンを読み込みません。Anthropic API の場合、環境で `ANTHROPIC_API_KEY` を設定します。[Claude Console](https://platform.claude.com) で作成されたキーを使用するか、`--settings` JSON で `apiKeyHelper` を指定します。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry は、通常どおり独自のプロバイダー認証情報を読み込み続けます。53bare モードでは、Claude Code は OAuth 認証情報またはシステムキーチェーンを読み込みません。Anthropic API の場合、環境で `ANTHROPIC_API_KEY` を設定します。[Claude Console](https://platform.claude.com) で作成されたキーを使用するか、`--settings` JSON で `apiKeyHelper` を指定します。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry は、通常どおり独自のプロバイダー認証情報を読み込み続けます。

54 54 

55ベアモードでは、Claude は Bash、ファイル読み取り、ファイル編集ツールにアクセスできます。フラグで必要なコンテキストを渡します。55bare モードでは、Claude は Bash、ファイル読み取り、ファイル編集ツールにアクセスできます。フラグで必要なコンテキストを渡します。

56 56 

57| 読み込むもの | 使用 |57| 読み込むもの | 使用 |

58| - | - |58| - | - |


84 84 

85実行は、バックグラウンドコマンド、サブエージェントとワークフロー、Monitor ウォッチ、保留中の `/loop` ウェイクアップなどのバックグラウンド作業を待機します。85実行は、バックグラウンドコマンド、サブエージェントとワークフロー、Monitor ウォッチ、保留中の `/loop` ウェイクアップなどのバックグラウンド作業を待機します。

86 86 

87* **[バックグラウンドコマンド](/docs/ja/tools-reference#background-commands)**: メイン会話が開始したコマンド(例えば開発サーバーやウォッチビルド)の場合、実行はコマンドが終了するか [時間制限](/docs/ja/tools-reference#time-limit-for-background-commands) に達するまで待機します。その後、Claude はその結果を受けてもう 1 ターン実行し、そのターンの結果が実行の最後の結果となります。これが `text` および `json` 出力で出力される結果です。コマンドの実行中は、10 分の上限によって待機が終了することはありません。87* **[バックグラウンドコマンド](/docs/ja/tools-reference#background-commands)**: メイン会話が開始したコマンド(例えば開発サーバーやウォッチビルド)の場合、実行はコマンドが終了するか [時間制限](/docs/ja/tools-reference#time-limit-for-background-commands) に達するまで待機します。その後、Claude はその結果を受けてもう 1 ターン実行します。コマンドの実行中は、10 分の上限によって待機が終了することはありません。

88* **バックグラウンドの [サブエージェント](/docs/ja/sub-agents) とワークフロー**: その結果は最終出力の一部であるため、実行はその作業が完了するまで開いたままになります。88* **バックグラウンドの [サブエージェント](/docs/ja/sub-agents) とワークフロー**: その結果は最終出力の一部であるため、実行はその作業が完了するまで開いたままになります。

89* **[Monitor](/docs/ja/tools-reference#monitor-tool) ウォッチ**: 実行は、ウォッチがタイムアウトするか 10 分の上限が待機を終了するか、どちらか先に来た方まで待機します。待機中、Claude はウォッチが報告することに応答し続けます。デフォルトでは、ウォッチは Claude が開始してから 5 分後にタイムアウトします。89* **[Monitor](/docs/ja/tools-reference#monitor-tool) ウォッチ**: 実行は、ウォッチがタイムアウトするか 10 分の上限が待機を終了するか、どちらか先に来た方まで待機します。待機中、Claude はウォッチが報告することに応答し続けます。デフォルトでは、ウォッチは Claude が開始してから 5 分後にタイムアウトします。

90* **保留中のウェイクアップ**: プロンプトを `--input-format stream-json` ではなくテキストとして渡した実行で、Claude が [自己ペースの `/loop` ウェイクアップ](/docs/ja/scheduled-tasks#let-claude-choose-the-interval) をスケジュールした場合、実行は各ウェイクアップが発生するのを待ち、[ループが終了する](/docs/ja/scheduled-tasks#stop-a-loop) までその反復を実行します。これは 10 分の上限を超えても続きます。90* **保留中のウェイクアップ**: プロンプトを `--input-format stream-json` ではなくテキストとして渡した実行で、Claude が [自己ペースの `/loop` ウェイクアップ](/docs/ja/scheduled-tasks#let-claude-choose-the-interval) をスケジュールした場合、実行は各ウェイクアップが発生するのを待ち、[ループが終了する](/docs/ja/scheduled-tasks#stop-a-loop) までその反復を実行します。これは 10 分の上限を超えても続きます。

91 91 

92実行が [`--max-budget-usd`](/docs/ja/cli-reference#cli-flags) の上限に達した場合、Claude Code は待機せずに残りのバックグラウンド作業を停止します。92実行が [`--max-budget-usd`](/docs/ja/cli-reference#cli-flags) の上限に達した場合、Claude Code は待機せずに残りのバックグラウンド作業を停止します。

93 93 

94バックグラウンド作業によって別のターンが開始された場合、デフォルトの `text` 出力では各ターンの結果が出力され、`json` 出力では最後のターンの結果が出力されます。v2.1.295 より前は、`text` 出力でも最後のターンの結果のみが出力されていました。

95 

94<h3 id="stop-a-run-with-sigterm">96<h3 id="stop-a-run-with-sigterm">

95 SIGTERM で実行を停止する97 SIGTERM で実行を停止する

96</h3>98</h3>

97 99 

98`claude -p` 実行を SIGTERM で停止した場合(例えば、`kill` またはプロセススーパーバイザーから)、Claude Code はコード 143 で終了します。Claude Code は進行中のターンを未完了のままにし、そのための結果を記録しません。ターンを終了するには、SIGINT を送信するか、Agent SDK の `interrupt()` を呼び出してから、プロセスを停止します。100`claude -p` 実行を SIGTERM で停止した場合(例えば、`kill` またはプロセススーパーバイザーから)、Claude Code はコード 143 で終了します。Claude Code は進行中のターンを未完了のままにし、そのための結果を記録しません。ターンを終了するには、SIGINT を送信するか、Agent SDK の `interrupt()` を呼び出してから、プロセスを停止します。

99 101 

100SIGTERM では、Claude Code はまだ実行中の Bash コマンドのプロセスツリーを終了します。Claude Code は [`SessionEnd` hooks](/docs/ja/hooks#sessionend) を実行して終了します。終了中、Claude Code は新しいツール呼び出しを開始せず、新しいモデルリクエストを送信せず、`SessionEnd` 以外のフックを実行しません。実行が権限プロンプトへの回答を待機しているコマンドの途中にあった場合、Claude Code はそのステップを次のように処理します。102SIGTERM では、Claude Code はまだ実行中の Bash コマンドのプロセスツリーを終了します。Claude Code は [`SessionEnd` フック](/docs/ja/hooks#sessionend) を実行して終了します。終了中、Claude Code は新しいツール呼び出しを開始せず、新しいモデルリクエストを送信せず、`SessionEnd` 以外のフックを実行しません。シグナルを受け取ったときに実行がコマンドの途中にあった場合、または権限プロンプトへの回答を待機していた場合、Claude Code はそのステップを次のように処理します。

101 103 

102* **コマンドを実行中**: Claude Code はコマンドをセッションで強制終了として記録します。104* **コマンドを実行中**: Claude Code はコマンドをセッションで強制終了として記録します。

103* **権限プロンプトへの回答を待機中**: SIGTERM をプロセスに送信した場合、Claude Code はプロンプトを未回答のままにします。プログラムが Agent SDK を通じてセッションを閉じた場合、SDK はシグナルを送信する前に Claude Code の入力を終了し、Claude Code は入力が終了するとすぐにプロンプトをキャンセルします。105* **権限プロンプトへの回答を待機中**: SIGTERM をプロセスに送信した場合、Claude Code はプロンプトを未回答のままにします。プログラムが Agent SDK を通じてセッションを閉じた場合、SDK はシグナルを送信する前に Claude Code の入力を終了し、Claude Code は入力が終了するとすぐにプロンプトをキャンセルします。


262| `type` | `"system"` | メッセージタイプ |264| `type` | `"system"` | メッセージタイプ |

263| `subtype` | `"api_retry"` | これを再試行イベントとして識別 |265| `subtype` | `"api_retry"` | これを再試行イベントとして識別 |

264| `attempt` | integer | 現在の試行番号(1 から開始) |266| `attempt` | integer | 現在の試行番号(1 から開始) |

265| `max_retries` | integer | このエラーの原因に許可される再試行の合計(セッション全体の予算より少ない場合がある) |267| `max_retries` | integer | この失敗の原因に対して許可される再試行の合計 |

266| `retry_delay_ms` | integer | 次の試行までのミリ秒 |268| `retry_delay_ms` | integer | 次の試行までのミリ秒 |

267| `error_status` | integer または null | 失敗した試行の HTTP ステータスコード、または試行が API から HTTP レスポンスを受け取らなかった場合は `null` |269| `error_status` | integer または null | 失敗した試行の HTTP ステータスコード、または試行が API から HTTP レスポンスを受け取らなかった場合は `null` |

268| `no_response` | object、optional | 失敗した試行が [no response headers in time](/docs/ja/errors#no-response-from-api) を受け取った場合にのみ存在します。`waited_ms` はその試行が待機した時間で、`retry_wait_ms` は再試行が待機する時間です。これらのイベントでは、`max_retries` はセッション全体の予算ではなく、この原因が通常受け取る 1 回の再試行を反映しています。Claude Code v2.1.261 以降が必要です |270| `no_response` | object、optional | 失敗した試行が[時間内にレスポンスヘッダーを受け取らなかった](/docs/ja/errors#no-response-from-api)場合にのみ存在します。`waited_ms` はその試行が待機した時間で、`retry_wait_ms` は再試行が待機する時間です。Claude Code v2.1.261 以降が必要です |

269| `error` | string | エラーカテゴリ:`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` |271| `error` | string | エラーカテゴリ:`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` |

270| `uuid` | string | 一意のイベント識別子 |272| `uuid` | string | 一意のイベント識別子 |

271| `session_id` | string | イベントが属するセッション |273| `session_id` | string | イベントが属するセッション |

hipaa-setup.md +3 −0

Details

139}139}

140```140```

141 141 

142サンドボックス化、ネットワーク許可リスト、認証情報の保護、ローカルデータの保持を含むより完全な `managed-settings.json` については、[設定例リポジトリ](https://github.com/anthropics/claude-code/tree/main/examples/settings)の `settings-hipaa.json` と `README-hipaa.md` を参照してください。

143 

142<h4 id="what-each-key-does">144<h4 id="what-each-key-does">

143 各キーの役割145 各キーの役割

144</h4>146</h4>


306 308 

307* [HIPAA 対応組織向けに Cowork(ローカルモード)をセットアップする](https://claude.com/docs/cowork/hipaa-setup)309* [HIPAA 対応組織向けに Cowork(ローカルモード)をセットアップする](https://claude.com/docs/cowork/hipaa-setup)

308* [管理設定をデプロイする](/docs/ja/managed-settings)310* [管理設定をデプロイする](/docs/ja/managed-settings)

311* [HIPAA 設定の例](https://github.com/anthropics/claude-code/tree/main/examples/settings)

309* [エンタープライズネットワーク設定](/docs/ja/network-config)312* [エンタープライズネットワーク設定](/docs/ja/network-config)

310* [ゼロデータ保持](/docs/ja/zero-data-retention)313* [ゼロデータ保持](/docs/ja/zero-data-retention)

311* [法務とコンプライアンス](/docs/ja/legal-and-compliance)314* [法務とコンプライアンス](/docs/ja/legal-and-compliance)

hooks.md +124 −35

Details

476| `async` | いいえ | `true` の場合、ブロックせずにバックグラウンドで実行されます。[バックグラウンドでフックを実行](#run-hooks-in-the-background)を参照してください |476| `async` | いいえ | `true` の場合、ブロックせずにバックグラウンドで実行されます。[バックグラウンドでフックを実行](#run-hooks-in-the-background)を参照してください |

477| `asyncRewake` | いいえ | `true` の場合、バックグラウンドで実行され、終了コード 2 で Claude を起動します。フックの stderr、または stderr が空の場合は stdout が [システムリマインダー](/docs/ja/glossary#system-reminder)として Claude に表示されるため、Claude は長時間実行されるバックグラウンドの失敗に対応できます |477| `asyncRewake` | いいえ | `true` の場合、バックグラウンドで実行され、終了コード 2 で Claude を起動します。フックの stderr、または stderr が空の場合は stdout が [システムリマインダー](/docs/ja/glossary#system-reminder)として Claude に表示されるため、Claude は長時間実行されるバックグラウンドの失敗に対応できます |

478| `shell` | いいえ | このフックに使用するシェル。`"bash"` または `"powershell"` を受け入れます。デフォルトは `"bash"`、または Git Bash がインストールされていない場合は Windows で `"powershell"`。`"powershell"` を設定すると、Windows 上で PowerShell 経由でコマンドが実行されます。フックは PowerShell を直接生成するため、`CLAUDE_CODE_USE_POWERSHELL_TOOL` は不要です。`args` が設定されている場合は無視されます |478| `shell` | いいえ | このフックに使用するシェル。`"bash"` または `"powershell"` を受け入れます。デフォルトは `"bash"`、または Git Bash がインストールされていない場合は Windows で `"powershell"`。`"powershell"` を設定すると、Windows 上で PowerShell 経由でコマンドが実行されます。フックは PowerShell を直接生成するため、`CLAUDE_CODE_USE_POWERSHELL_TOOL` は不要です。`args` が設定されている場合は無視されます |

479| `onFailure` | いいえ | フックが失敗したときにアクションがどうなるか。`"continue"`(デフォルト)または `"block"`。[フックが失敗したときにアクションをブロックする](#block-the-action-when-a-hook-fails)を参照してください。Claude Code v2.1.295 以降が必要です |

479 480 

480<a id="exec-form-and-shell-form" />481<a id="exec-form-and-shell-form" />

481 482 


533| `url` | はい | POST リクエストを送信する URL |534| `url` | はい | POST リクエストを送信する URL |

534| `headers` | いいえ | キー値ペアとしての追加 HTTP ヘッダー。値は `$VAR_NAME` または `${VAR_NAME}` 構文を使用した環境変数補間をサポートします。`allowedEnvVars` にリストされている変数のみが解決されます |535| `headers` | いいえ | キー値ペアとしての追加 HTTP ヘッダー。値は `$VAR_NAME` または `${VAR_NAME}` 構文を使用した環境変数補間をサポートします。`allowedEnvVars` にリストされている変数のみが解決されます |

535| `allowedEnvVars` | いいえ | ヘッダー値に補間される可能性のある環境変数名のリスト。リストされていない変数への参照は空の文字列に置き換えられます。環境変数補間が機能するために必須 |536| `allowedEnvVars` | いいえ | ヘッダー値に補間される可能性のある環境変数名のリスト。リストされていない変数への参照は空の文字列に置き換えられます。環境変数補間が機能するために必須 |

537| `onFailure` | いいえ | フックが失敗したときにアクションがどうなるか。`"continue"`(デフォルト)または `"block"`。[フックが失敗したときにアクションをブロックする](#block-the-action-when-a-hook-fails)を参照してください。Claude Code v2.1.295 以降が必要です |

536 538 

537Claude Code はフックの [JSON 入力](#hook-input-and-output)を `Content-Type: application/json` の POST リクエスト本体として送信します。レスポンス本体はコマンド フックと同じ [JSON 出力形式](#json-output)を使用します。539Claude Code はフックの [JSON 入力](#hook-input-and-output)を `Content-Type: application/json` の POST リクエスト本体として送信します。レスポンス本体はコマンド フックと同じ [JSON 出力形式](#json-output)を使用します。

538 540 


821 終了コード出力823 終了コード出力

822</h3>824</h3>

823 825 

824フック コマンドからの終了コードは、Claude Code にアクションが進行すべきか、ブロックされるべきか、無視されるべきかを伝えます。終了コードは単独で作用するわけではありません。Claude Code は 0 だけでなくすべての終了コードで stdout から [JSON 出力フィールド](#json-output)を読み取ります。標準の決定モデルを使用するイベントでは、解析されたオブジェクトがスキーマ検証に合格すると、終了コードとともに効果を持ちます。終了 2 によるブロックは、JSON で上書きできない唯一の結果です。826フックの終了コードは、ツール呼び出しやプロンプトなど、フックをトリガーしたアクションを続行するかどうかを Claude Code に伝えます。完了した実行の結果は次の 3 つのいずれかです。

825 827 

826イベントごとの例外は 2 つの表にまとめられています。[イベントごとの終了コード 2 動作](#exit-code-2-behavior-per-event)は各イベントで終了コードが何をするかを示し、[決定制御](#decision-control)は各イベントがどの決定フィールドを尊重するかを示します。`systemMessage` などのユニバーサル フィールドはほとんどのイベントで機能し、[JSON 出力](#json-output)の表にリストされています。828* **成功**: フックが 0 で終了します。Claude Code はフックが出力した [JSON 出力](#json-output)フィールドを適用し、それらのフィールドがアクションをブロックまたは拒否しない限り、アクションは進行します。

829* **ブロッキング エラー**: フックが 2 で終了します。[ブロック可能なイベント](#exit-code-2-behavior-per-event)では、Claude Code はアクションを停止します。

830* **非ブロッキング エラー**: フックがその他のコードで終了するか、起動しない、無効な JSON を出力するなど、その他の方法で失敗します。アクションは進行し、`PreToolUse` などのイベントではトランスクリプトに `<hook name> hook error` 通知が表示されます。失敗したフックでアクションをブロックしたい場合は、[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を設定してください。

831 

832フックが stdout に出力する内容によって結果が変わることがあります。例えば、`PreToolUse` フックが 1 で終了しても、検証に合格する JSON を出力した場合、実行は成功となり、JSON フィールドが何が起こるかを決定します。`PreToolUse` などのイベントでフックの結果を確認するには、stdout に出力した内容を最初の列で、終了コードを上部の行で照合してください。

833 

834| stdout | 終了 0 | 終了 2 | その他の終了コード |

835| :- | :- | :- | :- |

836| [スキーマ検証](#json-output)に合格する JSON オブジェクト | 成功。フィールドが適用されます | ブロッキング エラー。Claude Code はフィールドを引き続き読み取りますが、それらでブロックを上書きすることはできません | 成功。Claude Code は終了コードを無視し、フィールドのみが結果を決定します。[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を設定している場合、これは失敗としてカウントされます |

837| [解析できない](#exit-code-0)、またはスキーマ検証に失敗する JSON | 非ブロッキング エラー。通知には解析または検証のメッセージが含まれます | ブロッキング エラー。stderr が理由になります | 非ブロッキング エラー。通知には解析または検証のメッセージが含まれます |

838| [プレーン テキスト](#exit-code-0)、または何もなし | 成功 | ブロッキング エラー。stderr が理由になります | 非ブロッキング エラー。通知には stderr の最初の行が含まれます |

839 

840一部のイベントには独自のルールがあります。

841 

842* **`WorktreeCreate`**: JSON の内容にかかわらず、0 以外の終了コードで worktree の作成が失敗します。

843* **`WorktreeRemove`**: 0 以外の終了コードは、その後もディレクトリが存在する場合に worktree の削除を失敗させます。

844* **`Stop`、`SubagentStop`、`TaskCompleted`、およびプラグインの `UserPromptSubmit` フック**: フックが stdout に何も出力せずに 2 で終了し、stderr に `No such file or directory` のようにファイルが見つからないことが示されている場合、Claude Code はその実行を非ブロッキング エラーとして扱います。

845* **`Elicitation` と `ElicitationResult`**: Claude Code はフックが 0 で終了した場合に `hookSpecificOutput` を適用し、その他の終了コードでは無視します。

846* **`StopFailure` などフック出力を破棄するイベント**: Claude Code はすべての終了コードで JSON を無視します。ただし、`terminalSequence` のような副作用フィールドは引き続き発火します。

847 

848イベントで終了コード 2 が何をするかは[イベントごとの終了コード 2 動作](#exit-code-2-behavior-per-event)を、どの決定フィールドが尊重されるかは[決定制御](#decision-control)を参照してください。

827 849 

828<h4 id="exit-code-0">850<h4 id="exit-code-0">

829 終了コード 0851 終了コード 0


835 857 

836Claude Code が stdout を [JSON 出力](#json-output)として読み取るかプレーン テキストとして読み取るかは、前後の空白を無視したうえで、その開始と終了の文字によって決まります。858Claude Code が stdout を [JSON 出力](#json-output)として読み取るかプレーン テキストとして読み取るかは、前後の空白を無視したうえで、その開始と終了の文字によって決まります。

837 859 

838* **`{` で始まり `}` で終わる**: Claude Code は JSON として解析します。出力が 2 行以上で、各行が単独で JSON として解析でき、どの行もフィールドを設定する [JSON 出力](#json-output)オブジェクトでない場合、Claude Code は出力全体をプレーン テキストとして扱います。それらの行のいずれかがフィールドを設定している場合、出力全体は解析失敗となります(後述)。860* **`{` で始まり `}` で終わる**: Claude Code は JSON として解析します。出力が 2 行以上で、各行が単独で JSON として解析でき、どの行もフィールドを設定する [JSON 出力](#json-output)オブジェクトでない場合、Claude Code は出力全体をプレーン テキストとして扱います。それらの行のいずれかがフィールドを設定している場合、出力全体は解析失敗となります。

839* **`{` で始まるが `}` で終わらない**: Claude Code はプレーン テキストとして扱います。861* **`{` で始まるが `}` で終わらない**: Claude Code はプレーン テキストとして扱います。

840* **その他の文字で始まる**: JSON 配列や引用符で囲まれた JSON 文字列を含め、Claude Code はプレーン テキストとして扱います。862* **その他の文字で始まる**: JSON 配列や引用符で囲まれた JSON 文字列を含め、Claude Code はプレーン テキストとして扱います。

841 863 

842標準の決定モデルを使用するイベントでは、終了 0 で解析されたオブジェクトがスキーマ検証に失敗した場合は非ブロッキング エラーとなります。アクションは進行し、トランスクリプトには検証メッセージとともに `<hook name> hook error` 通知が表示されます。2 以外のすべての終了コードでも同じことが起こりますが、[終了 2 は引き続きブロックします](#exit-code-2)。864Claude Code が stdout を JSON として解析しようとして失敗した場合、または解析されたオブジェクトが[スキーマ検証](#json-output)に失敗した場合、実行は[非ブロッキング エラー](#exit-code-output)になります。`<hook name> hook error` 通知には解析または検証のメッセージが含まれます。プレーン テキストの stdout をコンテキストとして追加するイベントでは、Claude Code は解析に失敗した stdout を追加しません。

843 

844標準の決定モデルを使用するイベントでは、Claude Code が stdout を JSON として解析しようとして失敗した場合、2 以外のすべての終了コードで非ブロッキング エラーを報告します。トランスクリプトには解析メッセージとともに `<hook name> hook error` 通知が表示されます。プレーン テキストの stdout をコンテキストとして追加するイベントでは、Claude Code はそのテキストを追加しません。v2.1.248 より前は、Claude Code はその stdout をプレーン テキストとして扱っていました。

845 865 

846終了 0 のフックからの stderr はデバッグ ログにのみ送られ、トランスクリプトには表示されず、Claude がそれを見ることはありません。自分で読むには、[デバッグ ログ](#debug-hooks)を有効にしてください。`PostToolUse` または `PostToolUseFailure` フックから Claude に警告を表示するには、代わりに終了 2 を使用してください。そうすれば、ツールがすでに実行されていても [Claude は stderr を確認できます](#exit-code-2-behavior-per-event)。866終了 0 のフックからの stderr を Claude が見ることはありません。`PreToolUse` などのイベントで自分で読むには、[デバッグ ログ](#debug-hooks)を有効にしてください。`PostToolUse` または `PostToolUseFailure` フックから Claude に警告を表示するには、代わりに終了 2 を使用してください。そうすれば、ツールがすでに実行されていても [Claude は stderr を確認できます](#exit-code-2-behavior-per-event)。

847 867 

848<h4 id="exit-code-2">868<h4 id="exit-code-2">

849 終了コード 2869 終了コード 2

850</h4>870</h4>

851 871 

852終了 2 はブロッキング エラーを意味します。[ブロック可能なイベント](#exit-code-2-behavior-per-event)では、JSON を出力するかどうかにかかわらず終了 2 はブロックします。JSON の `permissionDecision` が `"allow"` であっても上書きできません。Claude Code は stdout 上の有効な [JSON 出力](#json-output)を引き続き読み取ります。`Elicitation` と `ElicitationResult` では、終了 2 のフックの `hookSpecificOutput` は無視されます。872アクションをブロックするには、コード 2 で終了します。[ブロック可能なイベント](#exit-code-2-behavior-per-event)では、Claude Code はアクションを停止します。例えば、`PreToolUse` フックはツール呼び出しをブロックし、`UserPromptSubmit` フックはプロンプトを拒否します。

853 873 

854ブロッキング メッセージは、JSON がブロッキング決定を行う場合はその理由、それ以外の場合は stderr テキストです。ブロックの効果はイベントによって異なります。`PreToolUse` はツール呼び出しをブロックし、`UserPromptSubmit` はプロンプトを拒否する、などです。[イベントごとの終了コード 2 動作](#exit-code-2-behavior-per-event)にはすべてのイベントの効果がリストされており、各イベントのセクションにはメッセージの送信先が記載されています。874ブロックに伴うメッセージはフックの stderr です。フックがブロッキング決定を行う JSON も出力した場合、Claude Code は代わりにその決定の理由を使用します。

855 875 

856[JSON 出力](#json-output)のスキーマ検証に失敗する JSON を出力しながら終了 2 するフックは、引き続きブロックします。Claude Code は stderr をブロッキング理由として使用し、検証の失敗をデバッグ ログに記録します。v2.1.214 より前は、Claude Code はその組み合わせを非ブロッキング エラーとして扱い、アクションは進行していました。876終了 2 は、フックが JSON を出力した場合でもブロックします。

877 

878* **スキーマ検証に合格する JSON**: Claude Code は [JSON 出力](#json-output)フィールドを引き続き読み取りますが、それらでブロックを上書きすることはできません。`permissionDecision` が `"allow"` であっても、アクションは通過しません。`Elicitation` と `ElicitationResult` では、終了 2 のフックの `hookSpecificOutput` は無視されます。

879* **スキーマ検証に失敗する JSON**: フックは引き続きブロックします。Claude Code は stderr をブロッキング理由として使用し、検証の失敗をデバッグ ログに記録します。

857 880 

858このスクリプトは終了 2 によって `rm` コマンドをブロックし、それ以外のすべてのコマンドは通常の権限フローに任せます。881このスクリプトは終了 2 によって `rm` コマンドをブロックし、それ以外のすべてのコマンドは通常の権限フローに任せます。

859 882 


871exit 0 # No decision: the normal permission flow applies894exit 0 # No decision: the normal permission flow applies

872```895```

873 896 

897このスクリプトを `Bash` の `PreToolUse` フックとして登録すると、`rm` で始まるコマンドはブロックされ、Claude はイベント名、ツール名、フックのコマンドがプレフィックスとして付いたフックの stderr を、ツールのエラーとして受け取ります。

898 

899```text theme={null}

900PreToolUse:Bash hook error: [${CLAUDE_PROJECT_DIR}/.claude/hooks/no-rm.sh]: Blocked: rm commands are not allowed

901```

902 

874<h4 id="other-exit-codes">903<h4 id="other-exit-codes">

875 その他の終了コード904 その他の終了コード

876</h4>905</h4>

877 906 

878その他の終了コードは、ほとんどのフック イベントでそれ自体ではブロックしません。何が起こるかは stdout によって異なります。907フックが 0 または 2 以外のコードで終了し、stdout にプレーン テキストを出力するか何も出力しない場合、実行は[非ブロッキング エラー](#exit-code-output)になります。トランスクリプトには、`Failed with non-blocking status code:` とフックの stderr の最初の行を含む `<hook name> hook error` 通知が表示されます。例えば、`Bash` の `PreToolUse` フックが stderr に `something broke` を出力して 1 で終了した場合、`PreToolUse:Bash hook error` 通知には次の行が含まれます。

879 908 

880* 標準の決定モデルを使用するイベントで、解析されたオブジェクトがスキーマ検証に合格した場合、Claude Code は終了コードを無視し、JSON のみが結果を決定します。909```text theme={null}

881 * イベントがサポートする各フィールド(`permissionDecision`、`additionalContext`、`updatedInput`、`systemMessage` を含む)が尊重され、フックはエラーとして報告されません。910Failed with non-blocking status code: something broke

882 * [決定制御](#decision-control)にはイベントごとの決定フィールドがリストされています。`systemMessage` などのユニバーサル フィールドは [JSON 出力](#json-output)の表に従います。911```

883* 標準の決定モデルを使用するイベントで、解析されたオブジェクトがスキーマ検証に失敗した場合、[終了 0 の場合](#exit-code-0)と同じ非ブロッキング エラーになります。アクションは進行し、`<hook name> hook error` 通知に検証メッセージが含まれます。

884* Claude Code が [JSON として解析しようとして](#exit-code-0)失敗した stdout の場合、標準の決定モデルを使用するイベントでは、Claude Code は終了 0 の場合と同じ非ブロッキング エラーを報告します。アクションは進行し、通知に解析メッセージが含まれます。

885* Claude Code が[プレーン テキストとして扱う](#exit-code-0) stdout、または空の stdout の場合、ほとんどのフック イベントで非ブロッキング エラーとなります。アクションは進行し、トランスクリプトには `<hook name> hook error` 通知と、その後に `Failed with non-blocking status code:` というプレフィックスが付いた stderr の最初の行が表示されます。完全な stderr を取得するには、[デバッグ ログ](#debug-hooks)を有効にしてください。

886 912 

887標準の決定モデルに含まれないイベントは、[イベントごとの表](#exit-code-2-behavior-per-event)の独自の行に従います。`WorktreeCreate` は JSON の内容にかかわらず 0 以外の終了で作成に失敗し、`StopFailure` のようにフック出力を完全に破棄するイベントは、すべての終了コードで JSON を無視します。ただし、`terminalSequence` のような副作用フィールドは引き続き発火します。913最初の行だけでなく完全な stderr を取得するには、[デバッグ ログ](#debug-hooks)を有効にしてください。

888 914 

889起動できないフックも同じ非ブロッキングの扱いになります。スクリプト パスが存在しないか実行可能でない場合、シェルは 127 などのコードで終了し、インタープリターのメッセージとともに同じ通知が表示されます(例: `Failed with non-blocking status code: /bin/sh: /path/to/hook.sh: No such file or directory`)。ほとんどのフック イベントでは、アクションは進行します。ポリシー フックを設定するときは、最初の実行時にこの通知に注意してください。`settings.json` でパスを入力ミスすると、ゲートが気付かないうちに無効になります。915起動できないフックも非ブロッキング エラーになります。シェル形式では、スクリプト パスが存在しないか実行可能でない場合、シェルは 127 などのコードで終了し、通知にはインタープリターのメッセージが含まれます(例: `Failed with non-blocking status code: /bin/sh: /path/to/hook.sh: No such file or directory`)。ポリシー フックを設定するときは、最初の実行時にこの通知に注意してください。`settings.json` でパスを入力ミスすると、フックは一度も実行されません。代わりにアクションをブロックするには、[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を設定してください。

890 916 

891<Warning>917<Warning>

892 ほとんどのフック イベントでは、終了コード 2 がコードのみでブロックする唯一の終了コードです。stdout に有効な JSON がない場合、1 が従来の Unix 失敗コードであっても、Claude Code は終了コード 1 を非ブロッキング エラーとして扱い、アクションを進行させます。フックがポリシーを実施することを目的としている場合は、`exit 2` を使用してください。worktree イベントは異なります。`WorktreeCreate` からの 0 以外の終了コードは worktree の作成を中止し、`WorktreeRemove` からの 0 以外の終了コードは、その後もディレクトリが存在する場合に worktree の削除を失敗させます。918 stdout に有効な JSON がない場合、1 が従来の Unix 失敗コードであっても、Claude Code は終了コード 1 を非ブロッキング エラーとして扱います。フックがポリシーを実施することを目的としている場合は、`exit 2` を使用してください。

893</Warning>919</Warning>

894 920 

895<h4 id="timeouts">921<h4 id="timeouts">


900 926 

901[`PreModelSwitch`](#premodelswitch) では、タイムアウトでキャンセルされたフックはモデルの切り替えをブロックします。`PreToolUse` では、2 つのフック ファミリーで動作が異なります。927[`PreModelSwitch`](#premodelswitch) では、タイムアウトでキャンセルされたフックはモデルの切り替えをブロックします。`PreToolUse` では、2 つのフック ファミリーで動作が異なります。

902 928 

903* タイムアウトした `command`、`http`、または `mcp_tool` フックはツール呼び出しをブロックしません。呼び出しは通常の[権限フロー](/docs/ja/permissions)を通じて続行されるため、停止したフックがゲートとして機能することを当てにしないでください。929* タイムアウトした `command`、`http`、または `mcp_tool` フックはツール呼び出しをブロックしません。呼び出しは通常の[権限フロー](/docs/ja/permissions)を通じて続行されるため、停止したフックがゲートとして機能することを当てにしないでください。`command` または `http` フックがタイムアウトしたときに呼び出しをブロックするには、[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を設定してください。

904* タイムアウトを超えた [Agent SDK コールバック フック](/docs/ja/agent-sdk/hooks)は[ツール呼び出しをブロックします](#pretooluse)。930* タイムアウトを超えた [Agent SDK コールバック フック](/docs/ja/agent-sdk/hooks)は[ツール呼び出しをブロックします](#pretooluse)。

905 931 

932<h4 id="block-the-action-when-a-hook-fails">

933 フックが失敗したときにアクションをブロックする

934</h4>

935 

936ほとんどのイベントでは、フックが失敗またはタイムアウトしても Claude Code はアクションを実行するため、パスが間違っていたりスクリプトがクラッシュしたりするポリシー フックはすべてを通過させてしまいます。代わりにアクションをブロックするには、`command` または `http` フックに `"onFailure": "block"` を設定します。デフォルト値は `"continue"` です。Claude Code v2.1.295 以降が必要です。

937 

938`.claude/settings.json` 内のこの `PreToolUse` フックは、各 Bash コマンドの前にプロジェクト スクリプトを実行し、スクリプトが失敗した場合はコマンドをブロックします。

939 

940```json theme={null}

941{

942 "hooks": {

943 "PreToolUse": [

944 {

945 "matcher": "Bash",

946 "hooks": [

947 {

948 "type": "command",

949 "command": "node",

950 "args": ["${CLAUDE_PROJECT_DIR}/.claude/hooks/check-command.js"],

951 "onFailure": "block"

952 }

953 ]

954 }

955 ]

956 }

957}

958```

959 

960試すには、`check-command.js` を存在しない状態のままにして、Claude に `ls` などの Bash コマンドの実行を依頼します。Claude Code は呼び出しをブロックし、エラーには `failed; blocking because onFailure is "block"` と、それに続く node 自身のエラー出力が含まれます(ここでは 1 行に切り詰めています)。

961 

962```text theme={null}

963PreToolUse:Bash hook error: [node ${CLAUDE_PROJECT_DIR}/.claude/hooks/check-command.js]: failed; blocking because onFailure is "block"

964Error: Cannot find module '/path/to/project/.claude/hooks/check-command.js'

965```

966 

967タイムアウト後は、メッセージに `failed` ではなく `timed out` と表示されます。`onFailure` が設定されていない場合、同じスクリプトの欠落は非ブロッキング エラーとなり、`ls` は実行されます。

968 

969次のそれぞれが失敗としてカウントされます。

970 

971* **起動できない**: コマンド フックが起動に失敗する(例えば、スクリプトや実行可能ファイルが存在しないため)

972* **0 または 2 以外の終了コード**: `permissionDecision: "allow"` のようにアクションを許可する JSON を出力した場合でも、コマンド フックでは失敗としてカウントされます。JSON の決定を返すには、0 で終了してください

973* **HTTP エラー**: HTTP フックの接続が失敗するか、レスポンスのステータスが 2xx ではない

974* **タイムアウト**: フックが [`timeout`](#common-fields) に達する

975* **無効な出力**: JSON 出力が[解析できない](#exit-code-0)か、[スキーマ検証](#json-output)に失敗する。HTTP フックの場合、空でも JSON オブジェクトでもない 2xx 本体も該当します。コマンド フックからのプレーン テキストの stdout は失敗ではありません

976 

977`"block"` を設定すると、失敗は[そのイベントでの終了コード 2](#exit-code-2-behavior-per-event) と同じ動作をします。ただし `PermissionRequest` は例外で、リクエストを拒否します。例えば、`PreToolUse` の失敗はツール呼び出しをブロックし、`UserPromptSubmit` の失敗はプロンプトをブロックします。

978 

979このフィールドは次のフックには効果がありません。

980 

981* **`Stop`、`SubagentStop`、`TaskCompleted`、`TeammateIdle` フック**: これらのイベントでの終了コード 2 は Claude を作業に戻しますが、Claude は実行されないフックを修復できません

982* **バックグラウンド コマンド フック**: [`async` または `asyncRewake`](#run-hooks-in-the-background) を設定したコマンド フック

983 

906<h4 id="exit-code-2-behavior-per-event">984<h4 id="exit-code-2-behavior-per-event">

907 イベントごとの終了コード 2 動作985 イベントごとの終了コード 2 動作

908</h4>986</h4>


960* **接続失敗**: 非ブロッキング エラー、実行は続行1038* **接続失敗**: 非ブロッキング エラー、実行は続行

961* **タイムアウト**: [タイムアウト](#timeouts)で説明されているとおり、フックはキャンセルされます1039* **タイムアウト**: [タイムアウト](#timeouts)で説明されているとおり、フックはキャンセルされます

962 1040 

963コマンド フックとは異なり、HTTP フックはステータス コードのみでブロッキング エラーを通知できません。ツール呼び出しをブロックまたは権限を拒否するには、適切な決定フィールドを含む JSON 本体を持つ 2xx レスポンスを返します。1041HTTP フックはステータス コードのみでブロッキング エラーを通知できません。2xx 以外のステータスや接続の失敗は[非ブロッキング エラー](#exit-code-output)です。ツール呼び出しをブロックまたは権限を拒否するには、適切な決定フィールドを含む JSON 本体を持つ 2xx レスポンスを返します。リクエストが失敗した場合や 2xx 以外のステータスを返した場合にアクションをブロックするには、[`onFailure: "block"`](#block-the-action-when-a-hook-fails) を設定してください。

964 1042 

965<h3 id="json-output">1043<h3 id="json-output">

966 JSON 出力1044 JSON 出力


1237 SessionStart の判定制御1315 SessionStart の判定制御

1238</h4>1316</h4>

1239 1317 

1240Claude Code は、[プレーンテキストとして扱う](#exit-code-0)標準出力を Claude のコンテキストに追加します。すべてのフックで利用できる [JSON 出力フィールド](#json-output)に加えて、以下のイベント固有のフィールドを返すことができます。1318SessionStart フックは、Claude へのコンテキストの追加、最初のユーザーメッセージの指定、セッションタイトルの設定、ファイルの監視、スキルの再読み込みを行えます。すべてのフックで利用できる [JSON 出力フィールド](#json-output)に加えて、それぞれに対応するフィールドを返してください。

1241 1319 

1242| フィールド | 説明 |1320| フィールド | 説明 |

1243| :- | :- |1321| :- | :- |

1244| `additionalContext` | 会話の開始時、最初のプロンプトの前に Claude のコンテキストに追加される文字列。テキストがどのように渡されるか、何を含めるべきかについては [Claude にコンテキストを追加する](#add-context-for-claude)を参照してください |1322| `additionalContext` | 会話の開始時、最初のプロンプトの前に Claude のコンテキストに追加される文字列。テキストがどのように渡されるか、何を含めるべきかについては [Claude にコンテキストを追加する](#add-context-for-claude)を参照してください |

1245| `initialUserMessage` | セッションの最初のユーザーメッセージとして使用される文字列。`-p` フラグを使用した[非対話モード](/docs/ja/headless)で適用され、プロンプトが指定されていなくても最初のターンになります。プロンプトが指定されている場合は、その次のターンとして続きます。既存のターンに付加される `additionalContext` とは異なり、これはターンを作成します |1323| `initialUserMessage` | `-p` フラグを使用した[非対話モード](/docs/ja/headless)で、セッションの最初のユーザーメッセージとして使用される文字列。プロンプトを渡さなくても最初のターンになります。プロンプトを渡した場合は、次のターンとして続きます |

1246| `sessionTitle` | セッションタイトルを設定します。`/rename` と同じ効果があります。起動フォルダ、git ブランチ、worktree 名からセッションに自動で名前を付ける場合に使用します。`source` が `"startup"`、`"resume"`、`"fork"` の場合に適用され、`"clear"` と `"compact"` では無視されます |1324| `sessionTitle` | セッションタイトルを設定します。`/rename` と同じ効果があります。`source` が `"startup"`、`"resume"`、または `"fork"` の場合に適用されます |

1247| `watchPaths` | このセッション中に [FileChanged](#filechanged) イベントを監視する絶対パスの配列 |1325| `watchPaths` | このセッション中に [FileChanged](#filechanged) イベントを監視する絶対パスの配列 |

1248| `reloadSkills` | ブール値。`true` の場合、Claude Code は SessionStart フックの完了後に[スキル](/docs/ja/skills)とコマンドのディレクトリを再スキャンするため、フックがインストールしたスキルは同じセッションの最初のプロンプトから利用できます |1326| `reloadSkills` | ブール値。`true` の場合、Claude Code は SessionStart フックの完了後に[スキル](/docs/ja/skills)とコマンドのディレクトリを再スキャンします。[フックがインストールしたスキルを再読み込みする](#reload-skills-that-a-hook-installs)を参照してください |

1327 

1328次の出力はコンテキストを追加し、セッションに名前を付けます。

1249 1329 

1250```json theme={null}1330```json theme={null}

1251{1331{


1257}1337}

1258```1338```

1259 1339 

1260このイベントでは通常の標準出力がすでに Claude に届くため、コンテキストを読み込むだけのフックは JSON を組み立てずに直接標準出力に出力できます。コンテキストを `sessionTitle` などの他のフィールドと組み合わせる必要がある場合は JSON 形式を使用してください。1340Claude Code は SessionStart フックの[プレーンテキストの stdout](#exit-code-0) を Claude のコンテキストに追加するため、コンテキストを追加するだけのフックは JSON を組み立てずにそのまま出力できます。

1341 

1342プラグインの SessionStart フックが `initialUserMessage` または `sessionTitle` を指定する場合は、セッションの開始前にプラグインをインストールしてください。SessionStart フックの実行後にインストールが完了したプラグインからのこれら 2 つのフィールドは、Claude Code によって無視されます。

1343 

1344<h4 id="reload-skills-that-a-hook-installs">

1345 フックがインストールしたスキルを再読み込みする

1346</h4>

1347 

1348SessionStart フックがインストールしたスキルを同じセッションで利用できるようにするには、`reloadSkills` を返します。スキルの検出は通常 SessionStart フックの完了前に実行されるため、これがないと、フックが `~/.claude/skills/` や `.claude/skills/` に書き込んだファイルが最初のプロンプトの実行時に見つからない場合があります。

1261 1349 

1262SessionStart フックがスキルをインストールまたは更新する場合は `reloadSkills` を使用してください。スキルの検出は通常 SessionStart フックの完了前に実行されるため、フックが `~/.claude/skills/` や `.claude/skills/` に書き込んだファイルは、そうしないと次のセッションでしか表示されません。次の例では、共有スキルリポジトリを同期し、再スキャンを要求します。1350次の例は、共有スキルのリポジトリを同期し、再スキャンを要求します。

1263 1351 

1264```bash theme={null}1352```bash theme={null}

1265#!/bin/bash1353#!/bin/bash


1270echo '{"hookSpecificOutput": {"hookEventName": "SessionStart", "reloadSkills": true}}'1358echo '{"hookSpecificOutput": {"hookEventName": "SessionStart", "reloadSkills": true}}'

1271```1359```

1272 1360 

1273リポジトリの URL はプレースホルダーです。独自のスキルリポジトリに置き換えてください。プレースホルダーのままではクローンが失敗し、標準エラー出力に `fatal:` メッセージが出力されます。終了コード 0 で終了した SessionStart フックの標準エラー出力は情報提供のみを目的としているため、`reloadSkills` の要求は引き続き適用されます。1361リポジトリの URL はプレースホルダーです。独自のスキルリポジトリに置き換えてください。

1274 1362 

1275<h4 id="persist-environment-variables">1363<h4 id="persist-environment-variables">

1276 環境変数を永続化する1364 環境変数を永続化する


1419 1507 

1420`UserPromptSubmit` フックのデフォルトのタイムアウトは、`command`、`http`、`mcp_tool` の各タイプで 30 秒です。これは、他のほとんどのイベントでのこれらのタイプのデフォルトである 600 秒より短くなっています。このフックはすべてのプロンプトの前に実行され、完了するまでモデルの処理をブロックするため、フックが停止するとセッションも停止します。フックにさらに時間が必要な場合は、フックエントリの `timeout` フィールドを設定してください。1508`UserPromptSubmit` フックのデフォルトのタイムアウトは、`command`、`http`、`mcp_tool` の各タイプで 30 秒です。これは、他のほとんどのイベントでのこれらのタイプのデフォルトである 600 秒より短くなっています。このフックはすべてのプロンプトの前に実行され、完了するまでモデルの処理をブロックするため、フックが停止するとセッションも停止します。フックにさらに時間が必要な場合は、フックエントリの `timeout` フィールドを設定してください。

1421 1509 

1422[`async: true`](#run-hooks-in-the-background) で実行するコマンドフックを除き、タイムアウトに達した `UserPromptSubmit` のコマンド、HTTP、または MCP ツールフックはキャンセルされ、その出力(`additionalContext` を含む)は破棄されます。プロンプトはそのコンテキストなしで Claude に届きます。トランスクリプトには、フック名、発生したタイムアウト、出力が破棄されたことを示す通知が表示されます。1510[`async: true`](#run-hooks-in-the-background) で実行するコマンドフックを除き、タイムアウトに達した `UserPromptSubmit` のコマンド、HTTP、または MCP ツールフックはキャンセルされ、その出力は `additionalContext` を含めて破棄されます。プロンプトはそのコンテキストなしで Claude に届きます。代わりにプロンプトをブロックするには、コマンドフックまたは HTTP フックに [`onFailure: "block"`](#block-the-action-when-a-hook-fails) を設定してください。トランスクリプトには、フックの名前、発生したタイムアウト、出力が破棄されたことを示す通知が表示されます。

1423 1511 

1424`UserPromptSubmit` の [Agent SDK コールバックフック](/docs/ja/agent-sdk/hooks)がタイムアウトに達すると、フック名とタイムアウトを示すメッセージとともにプロンプトがブロックされます。これは、そこでのコールバックが、フェイルオープンしてはならないポリシーゲートとして機能している可能性があるためです。セッションは続行されます。v2.1.208 より前は、このイベントでのコールバックのタイムアウトは実行エラーでターンを終了していました。1512`UserPromptSubmit` の [Agent SDK コールバックフック](/docs/ja/agent-sdk/hooks)がタイムアウトに達すると、フック名とタイムアウトを示すメッセージとともにプロンプトがブロックされます。これは、そこでのコールバックが、フェイルオープンしてはならないポリシーゲートとして機能している可能性があるためです。セッションは続行されます。v2.1.208 より前は、このイベントでのコールバックのタイムアウトは実行エラーでターンを終了していました。

1425 1513 


1860| :- | :- | :- | :- |1948| :- | :- | :- | :- |

1861| `url` | string | `"https://example.com/api"` | コンテンツを取得する URL |1949| `url` | string | `"https://example.com/api"` | コンテンツを取得する URL |

1862| `prompt` | string | `"Extract the API endpoints"` | 取得したコンテンツに対して実行するプロンプト |1950| `prompt` | string | `"Extract the API endpoints"` | 取得したコンテンツに対して実行するプロンプト |

1951| `offset` | number | `100000` | ページの先頭からスキップする文字数(オプション)。Claude は長いページの続きを読むためにこれを設定します。Claude Code v2.1.290 以降が必要です |

1863 1952 

1864<h5 id="websearch">1953<h5 id="websearch">

1865 WebSearch1954 WebSearch


2112| `message` | `"deny"` の場合のみ:権限が拒否された理由を Claude に伝えます |2201| `message` | `"deny"` の場合のみ:権限が拒否された理由を Claude に伝えます |

2113| `interrupt` | `"deny"` の場合のみ:`true` の場合、Claude を停止します |2202| `interrupt` | `"deny"` の場合のみ:`true` の場合、Claude を停止します |

2114 2203 

2115`decision` オブジェクトなしで終了コード 2 で終了するフックは権限フローを変更せず、その標準エラー出力は破棄されます。リクエストを許可または拒否できるのは `decision` オブジェクトだけです。2204`decision` オブジェクトなしで終了コード 2 で終了するフックは、権限フローを変更せず、その stderr は破棄されます。リクエストを許可または拒否するには、`decision` オブジェクトを返してください。

2116 2205 

2117```json theme={null}2206```json theme={null}

2118{2207{


2678 TaskCreated の決定制御2767 TaskCreated の決定制御

2679</h4>2768</h4>

2680 2769 

2681TaskCreated フックは 2 つの方法で作成をブロックできます。いずれの場合も、Claude Code はタスクを削除し、メッセージをツールのエラーとして Claude に返します。Claude Code はこのイベントからの `continue: false` を無視し、Claude は作業を続けます。2770TaskCreated フックは、終了コード 2 または JSON の判定によって作成をブロックできます。いずれの場合も、Claude Code はタスクを削除し、メッセージをツールのエラーとして Claude に返します。Claude Code はこのイベントからの `continue: false` を無視し、Claude は作業を続けます。

2682 2771 

2683* **終了コード 2**: Claude Code は stderr のテキストをメッセージとして返します。2772* **終了コード 2**: Claude Code は stderr のテキストをメッセージとして返します。

2684* **JSON `{"decision": "block", "reason": "..."}`**: Claude Code は `reason` をメッセージとして返します。2773* **JSON `{"decision": "block", "reason": "..."}`**: Claude Code は `reason` をメッセージとして返します。


3561 3650 

3562Claude Code は、決定に関係なく、フックが返した `systemMessage` をユーザーに表示します。そのため、コストを報告するフックは `{"systemMessage": "..."}` を返して 0 で終了できます。3651Claude Code は、決定に関係なく、フックが返した `systemMessage` をユーザーに表示します。そのため、コストを報告するフックは `{"systemMessage": "..."}` を返して 0 で終了できます。

3563 3652 

3564タイムアウトまでに応答しない PreModelSwitch フックは、切り替えをブロックします。これに対して [PreToolUse](#timeouts) では、タイムアウトしたコマンドフックはツール呼び出しを続行させます。このイベントのデフォルトのタイムアウトは 30 秒です。`PreModelSwitch` は `command`、`http`、`mcp_tool` フックのみを実行するため、`prompt` と `agent` のデフォルトは適用されません。3653タイムアウトまでに応答しない PreModelSwitch フックは、切り替えをブロックします。他のイベントでのタイムアウトの動作については、[タイムアウト](#timeouts)を参照してください。このイベントのデフォルトのタイムアウトは 30 秒です。`PreModelSwitch` は `command`、`http`、`mcp_tool` フックのみを実行するため、`prompt` と `agent` のデフォルトは適用されません。

3565 3654 

35660 または 2 以外のコードで終了し、JSON の決定を出力しないフックはブロックしません。[その他の終了コード](#other-exit-codes)で説明しているとおり、Claude Code はその stderr を表示して切り替えを適用します。36550 または 2 以外のコードで終了し、JSON の決定を出力しないフックは、[その他の終了コード](#other-exit-codes)で説明されているように、非ブロッキングエラーになります。

3567 3656 

3568<h3 id="postmodelswitch">3657<h3 id="postmodelswitch">

3569 PostModelSwitch3658 PostModelSwitch


4278非同期フックは同期フックと比べていくつかの制約があります。4367非同期フックは同期フックと比べていくつかの制約があります。

4279 4368 

4280* フック出力は次の会話ターンで配信されます。セッションがアイドル状態の場合、レスポンスは次のユーザー操作まで待機します。例外: `asyncRewake` フックが終了コード 2 で終了すると、セッションがアイドル状態でも Claude を直ちに起動します。4369* フック出力は次の会話ターンで配信されます。セッションがアイドル状態の場合、レスポンスは次のユーザー操作まで待機します。例外: `asyncRewake` フックが終了コード 2 で終了すると、セッションがアイドル状態でも Claude を直ちに起動します。

4281* 各実行は個別のバックグラウンド プロセスを作成します。同じ非同期フックの複数の発火全体で重複排除はありません。4370* 各実行は個別のバックグラウンド プロセスを作成します。

4282 4371 

4283<h2 id="security-considerations">4372<h2 id="security-considerations">

4284 セキュリティに関する考慮事項4373 セキュリティに関する考慮事項

hooks-guide.md +14 −11

Details

242 242 

243hook をテストするには、Claude に JavaScript ファイルにシングルクォート文字列を含む行を追加するよう求めてください。その後ファイルを開きます:Prettier のデフォルト設定では、hook はそれらをダブルクォートに書き直します。243hook をテストするには、Claude に JavaScript ファイルにシングルクォート文字列を含む行を追加するよう求めてください。その後ファイルを開きます:Prettier のデフォルト設定では、hook はそれらをダブルクォートに書き直します。

244 244 

245hook が成功すると、Claude Code は会話に何も表示しません。hook が実行されたことを確認するには、編集されたファイルが再フォーマットされていることを確認するか、[デバッグテクニック](#debug-techniques) を参照してください。245フックが成功すると、Claude Code は会話に何も表示しません。フックが実行されたことを確認するには、編集されたファイルが再フォーマットされていることを確認するか、[フックが何をしたかを確認する](#check-what-a-hook-did)を参照してください。

246 246 

247ファイルが `Bash` コマンドで書き直されるときを含め、特定のファイルがどのように変更されても再フォーマットするには、代わりに [FileChanged](/docs/ja/hooks#filechanged) hook を使用してください。247ファイルが `Bash` コマンドで書き直されるときを含め、特定のファイルがどのように変更されても再フォーマットするには、代わりに [FileChanged](/docs/ja/hooks#filechanged) hook を使用してください。

248 248 


979}979}

980```980```

981 981 

982エンドポイントは、コマンド hooks と同じ [出力形式](/docs/ja/hooks#json-output) を使用して JSON レスポンスボディを返す必要があります。ツール呼び出しをブロックするには、適切な `hookSpecificOutput` フィールドで 2xx レスポンスを返します。HTTP ステータスコードだけではアクションをブロックできません。982エンドポイントは、コマンドフックと同じ [出力形式](/docs/ja/hooks#json-output) の JSON ボディで応答し、Claude Code はレスポンスのステータスも確認します:

983 

984* **2xx ステータス**:ツール呼び出しをブロックするには、ボディで適切な `hookSpecificOutput` フィールドを返します。

985* **その他のステータス、またはリクエストが失敗した場合**:Claude Code は [ノンブロッキングエラー](/docs/ja/hooks#exit-code-output) を報告し、アクションを続行させます。失敗したエンドポイントでアクションをブロックするには、フックに [`onFailure: "block"`](/docs/ja/hooks#block-the-action-when-a-hook-fails) を設定します。

983 986 

984ヘッダー値は `$VAR_NAME` または `${VAR_NAME}` 構文を使用した環境変数補間をサポートします。`allowedEnvVars` 配列にリストされている変数のみが解決されます。他のすべての `$VAR` 参照は空のままです。987ヘッダー値は `$VAR_NAME` または `${VAR_NAME}` 構文を使用した環境変数補間をサポートします。`allowedEnvVars` 配列にリストされている変数のみが解決されます。他のすべての `$VAR` 参照は空のままです。

985 988 


1103 1106 

1104フックが `permissionDecision` や `additionalContext` を `hookSpecificOutput` の内側ではなくトップレベルで返した場合でも、JSON は解析されますが、Claude Code は誤って配置されたフィールドをエラーを報告せずに無視します。どのフィールドが無視されたかを確認するには、`claude --debug` で Claude Code を起動し、[デバッグログ](/docs/ja/hooks#debug-hooks)で `Hook JSON output had unrecognized keys` を検索します。1107フックが `permissionDecision` や `additionalContext` を `hookSpecificOutput` の内側ではなくトップレベルで返した場合でも、JSON は解析されますが、Claude Code は誤って配置されたフィールドをエラーを報告せずに無視します。どのフィールドが無視されたかを確認するには、`claude --debug` で Claude Code を起動し、[デバッグログ](/docs/ja/hooks#debug-hooks)で `Hook JSON output had unrecognized keys` を検索します。

1105 1108 

1106<h3 id="debug-techniques">1109<h3 id="check-what-a-hook-did">

1107 デバッグ手法1110 フックの動作を確認する

1108</h3>1111</h3>

1109 1112 

1110`Ctrl+O` を押してトランスクリプトビューを開き、フック実行の結果を確認します。1113`Ctrl+O` を押してトランスクリプトビューを開き、フックの結果を確認します。

1111 1114 

1112* **実行成功**:フックの JSON が `systemMessage` や Stop フックのフィードバックなどを表示しない限り、何も表示されません。1115* **成功**:フックの JSON が `systemMessage` や Stop フックのフィードバックなどを表示しない限り、何も表示されません。

1113 * フックが実行されたことを確認するには、ファイルが再フォーマットされたなどの効果を確認するか、以下で説明するようにデバッグログをオンにしてから再度フックをトリガーします1116 * フックが実行されたことを確認するには、ファイルが再フォーマットされたなどの効果を確認します

1114* **ブロッキングエラー**:ほとんどのイベントでは、フックのフィードバックが表示されます。フックの JSON がブロックの判断を行った場合、フィードバックはその判断の理由です。それ以外の場合はフックの stderr です。`ConfigChange` や `Elicitation` などの一部のイベントでは、ブロックしてもメッセージは表示されません。1117* **ブロッキングエラー**:ほとんどのイベントでは、ブロックに伴うメッセージが表示されます(例:`Blocked: rm commands are not allowed`)。`ConfigChange` や `Elicitation` などの一部のイベントでは、メッセージは表示されません。メッセージの出どころについては[終了コード 2](/docs/ja/hooks#exit-code-2) で説明しています。

1115* **非ブロッキングエラー**:アクションは続行され、`<hook name> hook error` という通知と短い説明が表示されます。説明は、`Failed with non-blocking status code:` を先頭に付けた stderr の最初の行や、JSON の検証メッセージまたは解析メッセージなどです。1118* **非ブロッキングエラー**:`<hook name> hook error` という通知と短い説明が表示されます。説明は、`Failed with non-blocking status code:` の後に続く stderr の最初の行や、JSON の検証メッセージまたは解析メッセージなどです。アクションは続行されています。

1116 1119 

1117どの終了コードと JSON の組み合わせがそれぞれの結果を生むか(イベントごとの例外を含む)は、リファレンスの[終了コードの出力](/docs/ja/hooks#exit-code-output)セクションで定義されています。1120特定の終了コードと stdout に対する結果(イベントごとの例外を含む)を調べるには、リファレンスの[終了コードの出力](/docs/ja/hooks#exit-code-output)を参照してください。

1118 1121 

1119どのフックが一致したか、その終了コード、stdout、stderr を含む実行の詳細をすべて確認するには、デバッグログを読みます。`claude --debug-file /tmp/claude.log` で Claude Code を起動して既知のパスに書き込み、別のターミナルで `tail -f /tmp/claude.log` を実行します。このフラグを付けずに起動した場合は、セッションの途中で `/debug` を実行してログを有効にし、ログのパスを確認します。1122フックの終了コード、stdout、stderr を含む実行の詳細をすべて確認するには、デバッグログを読みます。`claude --debug-file /tmp/claude.log` で Claude Code を起動して既知のパスに書き込み、別のターミナルで `tail -f /tmp/claude.log` を実行します。このフラグを付けずに起動した場合は、セッションの途中で `/debug` を実行してログを有効にし、ログのパスを確認します。

1120 1123 

1121<h2 id="learn-more">1124<h2 id="learn-more">

1122 詳細を学ぶ1125 詳細を学ぶ

Details

216| `^` | 最初の空白以外の文字 |216| `^` | 最初の空白以外の文字 |

217| `gg` | 入力の開始 |217| `gg` | 入力の開始 |

218| `G` | 最後の行の先頭 |218| `G` | 最後の行の先頭 |

219| `f{char}` | 次の文字の出現位置にジャンプ |219| `f{char}` | 現在の行で次の文字の出現位置にジャンプ |

220| `F{char}` | 前の文字の出現位置にジャンプ |220| `F{char}` | 現在の行で前の文字の出現位置にジャンプ |

221| `t{char}` | 次の文字の出現位置の直前にジャンプ |221| `t{char}` | 現在の行で次の文字の出現位置の直前にジャンプ |

222| `T{char}` | 前の文字の出現位置の直後にジャンプ |222| `T{char}` | 現在の行で前の文字の出現位置の直後にジャンプ |

223| `;` | 最後の f/F/t/T モーションを繰り返す |223| `;` | 最後の f/F/t/T モーションを繰り返す |

224| `,` | 最後の f/F/t/T モーションを逆方向で繰り返す |224| `,` | 最後の f/F/t/T モーションを逆方向で繰り返す |

225| `/` | 逆履歴検索を開く、`Ctrl+R` と同じです。空の検索プロンプトはヒントを表示します:`Esc` を押してから `i` を押してから `/` を押してコマンドメニューを開く代わりに |225| `/` | 逆履歴検索を開く、`Ctrl+R` と同じです。空の検索プロンプトはヒントを表示します:`Esc` を押してから `i` を押してから `/` を押してコマンドメニューを開く代わりに |


239| `dd` | 行を削除 |239| `dd` | 行を削除 |

240| `D` | 行の終わりまで削除 |240| `D` | 行の終わりまで削除 |

241| `dw`/`de`/`db` | 単語を削除/終わりまで/戻す |241| `dw`/`de`/`db` | 単語を削除/終わりまで/戻す |

242| `df{char}`/`dt{char}` | 次の文字の出現位置まで削除(含む)、または直前まで |242| `df{char}`/`dt{char}` | 現在の行で次の文字の出現位置まで削除(含む)、または直前まで |

243| `dj`/`dk` | 現在の行と下または上の行を削除 |243| `dj`/`dk` | 現在の行と下または上の行を削除 |

244| `dgg`/`dG` | 現在の行から最初または最後の行まで削除 |244| `dgg`/`dG` | 現在の行から最初または最後の行まで削除 |

245| `d0`/`c0`/`y0` | カーソルから行の開始まで削除、変更、またはヤンク。Claude Code v2.1.281 以降が必要です |245| `d0`/`c0`/`y0` | カーソルから行の開始まで削除、変更、またはヤンク。Claude Code v2.1.281 以降が必要です |


859* 単独の `#123`859* 単独の `#123`

860* `group/subgroup/project#123` などのネストされた GitLab パス860* `group/subgroup/project#123` などのネストされた GitLab パス

861* コードスパンまたはコードブロック内の任意の参照861* コードスパンまたはコードブロック内の任意の参照

862* 約 1,000 行または 100,000 文字を超える応答内の任意の参照

862 863 

863Claude Code は、参照が指すリポジトリではなく、git remote から識別したリポジトリのホストに対してリンクを構築します:864Claude Code は、参照が指すリポジトリではなく、git remote から識別したリポジトリのホストに対してリンクを構築します:

864 865 

jetbrains.md +8 −4

Details

55 使用方法55 使用方法

56</h2>56</h2>

57 57 

58<h3 id="from-your-ide">58<span id="from-your-ide" />

59 IDE から59 

60<h3 id="run-claude-code-from-your-ide">

61 IDE から Claude Code を実行する

60</h3>62</h3>

61 63 

62IDE の統合ターミナルから `claude` を実行すると、すべての統合機能がアクティブになります。64IDE の統合ターミナルから `claude` を実行すると、すべての統合機能がアクティブになります。

63 65 

64<h3 id="from-external-terminals">66<span id="from-external-terminals" />

65 外部ターミナルから67 

68<h3 id="connect-from-an-external-terminal">

69 外部ターミナルから接続する

66</h3>70</h3>

67 71 

68任意の外部ターミナルで `/ide` コマンドを使用して Claude Code を JetBrains IDE に接続し、すべての機能をアクティブにします。72任意の外部ターミナルで `/ide` コマンドを使用して Claude Code を JetBrains IDE に接続し、すべての機能をアクティブにします。

Details

57 配信メカニズムを選択する57 配信メカニズムを選択する

58</h2>58</h2>

59 59 

60上記のステップのファイルは、マネージド設定をマシンに取得する 4 つの方法の 1 つです。すべてのメカニズムは `settings.json` ファイルと同じポリシーキーを持つため、[設定リファレンス](/docs/ja/settings-reference) はすべてに適用されます。いくつかのキーは特定のソースに関連付けられており、各エントリの Scope 行はどれかを示しています。60上記の手順で作成したファイルは、管理設定をマシンに配置する 4 つの方法のうちの 1 つです。どのメカニズムも `settings.json` ファイルと同じポリシーキーを扱うため、[設定リファレンス](/docs/ja/settings-reference)はそのすべてに当てはまります。一部のキーは特定のソースに結び付いており、各エントリの Scope 行にそれが記載されています:

61 61 

62* **配信コントロール**: [`policyHelper`](/docs/ja/settings-reference#policyhelper)、[`wslInheritsWindowsSettings`](/docs/ja/settings-reference#wslinheritswindowssettings)、および [`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior)62* **配信制御**: [`policyHelper`](/docs/ja/settings-reference#policyhelper)、[`wslInheritsWindowsSettings`](/docs/ja/settings-reference#wslinheritswindowssettings)、[`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior)

63* **ゲートウェイログインキー**: [`forceLoginGatewayUrl`](/docs/ja/settings-reference#forcelogingatewayurl)、[`gatewayInternalNetworks`](/docs/ja/settings-reference#gatewayinternalnetworks)、および [`forceLoginMethod`](/docs/ja/settings-reference#forceloginmethod) の `"gateway"` 値63* **ゲートウェイログインキー**: [`forceLoginGatewayUrl`](/docs/ja/settings-reference#forcelogingatewayurl)、[`gatewayInternalNetworks`](/docs/ja/settings-reference#gatewayinternalnetworks)、[`forceLoginMethod`](/docs/ja/settings-reference#forceloginmethod) の `"gateway"` 値

64 64 

65マネージド設定ファイル、MDM プロファイル、または claude.ai コンソールは、それが到達するすべてのユーザーに 1 つのポリシーを適用します。開発者の 1 つのグループに異なるポリシーを提供するには、異なるファイルまたはプロファイルをそのグループにデプロイします。claude.ai コンソール [はまだグループをターゲットにできません](/docs/ja/server-managed-settings#current-limitations)。一方、自己ホスト型の [Claude apps gateway](/docs/ja/claude-apps-gateway) は IdP グループごとにマネージド設定を配信します。65管理設定ファイル、MDM プロファイル、claude.ai コンソールは、それが届くすべてのユーザーに 1 つのポリシーを適用します。特定の開発者グループに異なるポリシーを適用するには、そのグループに別のファイルまたはプロファイルをデプロイします。claude.ai コンソールは[まだグループを対象にできません](/docs/ja/server-managed-settings#current-limitations)が、セルフホストの [Claude apps gateway](/docs/ja/claude-apps-gateway) は IdP グループごとに管理設定を配信します。

66 66 

67複数のメカニズムが同じマシンにポリシーを配信する場合、Claude Code はデフォルトで 1 つを使用し、他を無視します。[Claude Code がマネージドソースを組み合わせる方法](#how-claude-code-combines-managed-sources) は順序と適用される opt-in を示しています。67複数のメカニズムが同じマシンにポリシーを配信する場合、Claude Code はデフォルトで 1 つを使用し、他は無視します。[Claude Code が管理ソースを組み合わせる方法](#how-claude-code-combines-managed-sources)では、その順序と、すべてのソースを適用するオプトインについて説明しています。

68 68 

69MDM とファイル行は一緒に endpoint-managed settings と呼ばれます。ポリシーが開発者のデバイスに保存されているためです。これは server-managed 行とは対照的です。Claude Code はそれをフェッチします。69MDM とファイルの行は、まとめてエンドポイント管理設定と呼ばれます。これは、Claude Code がポリシーを取得するサーバー管理の行とは異なり、ポリシーが開発者のデバイスに保存されるためです。

70 70 

71下記のテーブルを使用して、デバイスを既に管理している方法に基づいてメカニズムを選択してください。71以下の表を参考に、すでに行っているデバイス管理の方法に応じてメカニズムを選択してください。

72 72 

73| メカニズム | 配信方法 | Claude Code がそれを読む時期 | 使用する場合 |73| メカニズム | 配信方法 | Claude Code が読み取るタイミング | 使用する場面 |

74| :- | :- | :- | :- |74| :- | :- | :- | :- |

75| [サーバーマネージド設定](/docs/ja/server-managed-settings) | claude.ai 管理コンソール内、または自己ホスト型 [Claude apps gateway](/docs/ja/claude-apps-gateway) 上 | スタートアップ時にフェッチされ、1 時間ごとにポーリングされます。[ポリシーが適用される場所と時期](#where-and-when-a-policy-applies) を参照してください | 各マシンに触れずに claude.ai 組織のポリシーを変更する 1 つの場所が必要な場合 |75| [サーバー管理設定](/docs/ja/server-managed-settings) | claude.ai 管理コンソール、またはセルフホストの [Claude apps gateway](/docs/ja/claude-apps-gateway) 上で | 起動時に取得され、1 時間ごとにポーリングされます。[承認が必要な変更](#where-and-when-a-policy-applies)を参照してください | 各マシンに触れることなく、claude.ai 組織のポリシーを 1 か所で変更したい場合 |

76| MDM または OS レベルのポリシー | macOS 構成プロファイルまたは Windows `HKLM` レジストリ値として、Jamf、Intune、グループポリシー、または同様のツール経由。[各メカニズムがポリシーを保存する場所](#where-each-mechanism-stores-the-policy) を参照してください | スタートアップ時に読み取られ、30 分ごとに変更がチェックされます | MDM またはグループポリシーでデバイスを既に管理している場合 |76| MDM または OS レベルのポリシー | Jamf、Intune、グループポリシー、または同様のツールを通じて、macOS 構成プロファイルまたは Windows `HKLM` レジストリ値として。[各メカニズムがポリシーを保存する場所](#where-each-mechanism-stores-the-policy)を参照してください | 起動時に読み取られ、30 分ごとに変更がチェックされます | すでに MDM またはグループポリシーでデバイスを管理している場合 |

77| ファイルベース | 各マシンのシステムディレクトリ内の `managed-settings.json` として。[各メカニズムがポリシーを保存する場所](#where-each-mechanism-stores-the-policy) を参照してください | スタートアップ時に読み取られ、ファイルが変更されるとリロードされます | MDM なしのマシン、Linux ホスト、または自分で構築するイメージ |77| ファイルベース | 各マシンのシステムディレクトリ内の `managed-settings.json` として。[各メカニズムがポリシーを保存する場所](#where-each-mechanism-stores-the-policy)を参照してください | 起動時に読み取られ、ファイルが変更されると再読み込みされます | MDM のないマシン、Linux ホスト、または自分でビルドするイメージ |

78| HKCU レジストリ、Windows と WSL | Windows `HKCU` レジストリ値として。[各メカニズムがポリシーを保存する場所](#where-each-mechanism-stores-the-policy) を参照してください | スタートアップ時に読み取られ、30 分ごとに変更がチェックされます。Claude Code はそれを使用するのは、[他の管理ドキュメントが存在しない場合](#present-admin-documents) のみで、[ホスト提供の親設定](#let-an-embedding-host-add-policy) が制限的なキーを提供しない場合です | マシンレベルの `HKLM` キーを書き込むことができない場合 |78| HKCU レジストリ、Windows および WSL | Windows `HKCU` レジストリ値として。[各メカニズムがポリシーを保存する場所](#where-each-mechanism-stores-the-policy)を参照してください | 起動時に読み取られ、30 分ごとに変更がチェックされます。Claude Code がこれを使用するのは、[これより上位の管理ドキュメントが存在せず](#present-admin-documents)、かつ[ホストが提供する親設定](#let-an-embedding-host-add-policy)が制限的なキーを提供していない場合に限られます | マシンレベルの `HKLM` キーに書き込めない場合 |

79 79 

80Jamf、Iru、Intune、グループポリシーのスターターテンプレートは、[MDM 例リポジトリ](https://github.com/anthropics/claude-code/tree/main/examples/mdm) にあります。80Jamf、Iru、Intune、グループポリシー用のスターターテンプレートは、[MDM サンプルリポジトリ](https://github.com/anthropics/claude-code/tree/main/examples/mdm)にあります。

81 81 

82`managed-mcp.json` を通じてデプロイするか、[`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) キーを通じて提供するマネージド MCP サーバーについては、[マネージド MCP 構成](/docs/ja/managed-mcp) を参照してください。82組織に [HIPAA 設定](/docs/ja/hipaa-setup#deploy-managed-settings)が適用されている場合は、サンドボックス化、ネットワーク許可リスト、認証情報の保護、ローカルデータ保持を含むより充実した `managed-settings.json` について、[設定サンプルリポジトリ](https://github.com/anthropics/claude-code/tree/main/examples/settings)の `settings-hipaa.json` と `README-hipaa.md` を参照してください。

83 

84これらのいずれかと併せて `managed-mcp.json` を通じてデプロイする、または [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) キーを通じて提供する管理 MCP サーバーについては、[管理 MCP 設定](/docs/ja/managed-mcp)を参照してください。

83 85 

84<h3 id="where-and-when-a-policy-applies">86<h3 id="where-and-when-a-policy-applies">

85 ポリシーが適用される場所と時期87 ポリシーが適用される場所とタイミング

86</h3>88</h3>

87 89 

88デプロイされたポリシーは、開発者のセッションに次のように到達します。90デプロイされたポリシーは、次のように開発者のセッションに反映されます:

89 91 

90* **サーフェス**: 開発者のマシン上で、ターミナル、VS Code および JetBrains 拡張機能、デスクトップアプリの Code タブ、および [Agent SDK](/docs/ja/agent-sdk/typescript) セッションはこれらのソースをすべて読み取ります。Agent SDK セッションは、`settingSources` がユーザー、プロジェクト、ローカルファイルを除外する場合でも、マネージド設定をロードします。92* **サーフェス**: 開発者のマシン上では、ターミナル、VS Code および JetBrains 拡張機能、デスクトップアプリの Code タブ、[Agent SDK](/docs/ja/agent-sdk/typescript) のセッションが、これらすべてのソースを読み取ります。Agent SDK のセッションは、`settingSources` がユーザー、プロジェクト、ローカルのファイルを除外している場合でも管理設定を読み込みます。

91* **クラウドセッション**: Anthropic ホスト環境のセッションはデバイスの MDM プロファイルまたはファイルを読み取らないため、ポリシーはサーバーマネージド設定から来る必要があります。[自己ホスト環境](/docs/ja/self-hosted-environments) のセッションは、デフォルトではサーバーマネージド設定がポリシーキーを配信しない場合のみ、ランナーイメージ内のマネージド設定ファイルを読み取ります。ただし、[すべての管理ソースから Claude Code が読み取るキー](#keys-read-from-every-admin-source) は除きます。[Claude Code がマネージドソースを組み合わせる方法](#how-claude-code-combines-managed-sources) は両方を適用する opt-in について説明しています。93* **クラウドセッション**: Anthropic がホストする環境のセッションはデバイスの MDM プロファイルやファイルを読み取らないため、そのポリシーはサーバー管理設定から提供する必要があります。[セルフホスト環境](/docs/ja/self-hosted-environments)のセッションは、ランナーイメージ内の管理設定ファイルも読み取りますが、デフォルトでは、[Claude Code がすべての管理ソースから読み取るキー](#keys-read-from-every-admin-source)を除き、サーバー管理設定がポリシーキーを 1 つも配信しない場合に限られます。両方を適用するオプトインについては、[Claude Code が管理ソースを組み合わせる方法](#how-claude-code-combines-managed-sources)で説明しています。

92* **Claude Tag セッション**: [Claude Tag](https://claude.com/docs/claude-tag/overview) セッションはクラウド環境で実行されますが、サーバーマネージド設定を受け取りません。[自己ホスト環境](/docs/ja/self-hosted-environments) では、ランナーイメージ内のマネージド設定ファイルを読み取ります。Claude Tag 自体は [Claude Tag 管理設定](https://claude.com/docs/claude-tag/admins/customize) で構成します。94* **Claude Tag セッション**: [Claude Tag](https://claude.com/docs/claude-tag/overview) のセッションはクラウド環境で実行されますが、サーバー管理設定は受け取りません。[セルフホスト環境](/docs/ja/self-hosted-environments)では、ランナーイメージ内の管理設定ファイルは引き続き読み取ります。Claude Tag 自体は [Claude Tag 管理設定](https://claude.com/docs/claude-tag/admins/customize)で設定します。

93* **Cowork セッション**: Claude Desktop アプリの [Cowork](https://claude.com/docs/cowork/overview) は Claude Code 上でセッションを実行します。Cowork セッションでは、Claude Code は Team または Enterprise アカウントでユーザーがサインインしている場合でも、claude.ai 管理コンソールからサーバーマネージド設定をフェッチしません。したがって、どのポリシーが適用されるかはセッションが実行される場所によって異なります。95* **Cowork セッション**: Claude Desktop アプリの [Cowork](https://claude.com/docs/cowork/overview) は、そのセッションを Claude Code 上で実行します。Cowork セッションでは、ユーザーが Team または Enterprise アカウントでサインインしている場合でも、Claude Code が claude.ai 管理コンソールからサーバー管理設定を取得することはありません。そのため、どのポリシーが適用されるかはセッションの実行場所によって異なります:

94 96 

95 * **ユーザーのマシン上**: デフォルトでは、Cowork セッションの Claude Code はそのデバイス上の MDM または OS レベルのポリシーおよびマネージド設定ファイルを読み取るため、ポリシーをそこにデプロイします。97 * **ユーザーのマシン上**: デフォルトでは、Cowork セッション内の Claude Code はそのデバイス上の MDM または OS レベルのポリシーと管理設定ファイルを読み取るため、ポリシーはそこにデプロイします。

96 * **完全な VM サンドボックス内**: Claude Desktop マネージド構成が [`requireCoworkFullVmSandbox`](https://claude.com/docs/third-party/claude-desktop/configuration#requirecoworkfullvmsandbox) を設定する場合、Claude Code は仮想マシン内で実行され、デバイスの MDM ポリシーおよびマネージド設定ファイルは存在しません。98 * **フル VM サンドボックス内**: Claude Desktop の管理設定で [`requireCoworkFullVmSandbox`](https://claude.com/docs/third-party/claude-desktop/configuration#requirecoworkfullvmsandbox) が設定されている場合、Claude Code は仮想マシン内で実行され、そこにはデバイスの MDM ポリシーや管理設定ファイルが存在しません。

97 * **リモート Cowork セッション**: これらは Anthropic 管理 VM 上で実行され、Claude Code はデバイスポリシーを読み取ることができません。99 * **リモート Cowork セッション**: これらは Anthropic が管理する VM 上で実行され、Claude Code が読み取るデバイスポリシーはありません。

98 100 

99 セッションが実行される場所に関係なく、claude.ai は管理コンソールの [`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) および [`blockedMarketplaces`](/docs/ja/settings-reference#blockedmarketplaces) リストを、誰かが claude.ai 上の git リポジトリからマーケットプレイスを追加するか、Cowork タブの **Customize** から追加する場合に自動的に適用します。[制限がどのように機能するか](/docs/ja/plugins/org#restrict-what-users-can-install) はそのチェックについて説明しています。[サーフェスカバレッジ](/docs/ja/model-config#surface-coverage) テーブルは Cowork と他のサーフェスを比較しています。101 セッションがどこで実行されても、claude.ai 上の git リポジトリから、または Cowork タブの **Customize** から誰かがマーケットプレイスを追加すると、claude.ai は管理コンソールの [`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) と [`blockedMarketplaces`](/docs/ja/settings-reference#blockedmarketplaces) のリストを自ら適用します。そのチェックについては[制限の仕組み](/docs/ja/plugins/org#restrict-what-users-can-install)で説明しています。[サーフェスの対応範囲](/docs/ja/model-config#surface-coverage)の表では、Cowork と他のサーフェスを比較しています。

100* **実行中のセッション**: ほとんどの変更は、[配信メカニズムテーブル](#choose-a-delivery-mechanism) のスケジュールに従って、再起動なしで実行中のセッションに到達します。102* **実行中のセッション**: ほとんどの変更は、[配信メカニズムの表](#choose-a-delivery-mechanism)のスケジュールに従い、再起動なしで実行中のセッションに反映されます。

101 * [`forceRemoteSettingsRefresh`](/docs/ja/settings-reference#forceremotesettingsrefresh)、[`requiredMinimumVersion`](/docs/ja/settings-reference#requiredminimumversion)、および [いくつかのユーザー編集可能キー](/docs/ja/settings#when-edits-take-effect) への変更は、次のセッション開始時に有効になります。103 * [`forceRemoteSettingsRefresh`](/docs/ja/settings-reference#forceremotesettingsrefresh)、[`requiredMinimumVersion`](/docs/ja/settings-reference#requiredminimumversion)、および[一部のユーザーが編集可能なキー](/docs/ja/settings#when-edits-take-effect)への変更は、次回のセッション開始時に有効になります。

102 * 新規または変更された [`policyHelper`](/docs/ja/settings-reference#policyhelper) エントリは次の起動時に有効になります。ただし、起動時にサーバーマネージド設定によってシャドウされたヘルパーは、フェッチがそれらの設定が削除されたことを報告するとすぐに実行されます。104 * 新規または変更された [`policyHelper`](/docs/ja/settings-reference#policyhelper) エントリは、次回の起動時に有効になります。その起動時にサーバー管理設定がヘルパーを覆い隠している場合、取得によってそれらの設定の削除が報告されるとすぐにヘルパーが実行されます。

103* **承認が必要な変更**: [次の起動を待つ更新](/docs/ja/server-managed-settings#fetch-and-caching-behavior) とは別に、[承認が必要な](/docs/ja/server-managed-settings#security-approval-dialogs) 設定(フックまたは `env` 変数など)へのサーバーマネージド変更は、開発者がインタラクティブセッションでダイアログを受け入れるのを待ち、IDE 拡張機能または Agent SDK がホストするセッションの現在の実行に適用されます。その他のサーバーマネージド変更は次のポーリングで適用されます。105* **承認が必要な変更**: [次回の起動まで待機する更新](/docs/ja/server-managed-settings#fetch-and-caching-behavior)を除き、フックや `env` 変数など[承認が必要な](/docs/ja/server-managed-settings#security-approval-dialogs)設定に対するサーバー管理の変更は、対話型セッションでは開発者がダイアログを承認するまで待機し、IDE 拡張機能または Agent SDK がホストするセッションでは現在の実行に適用されます。その他のサーバー管理の変更は、次回のポーリングで適用されます。

104* **長時間実行セッション**: 数週間開いたままのセッションはロールアウトに遅れることができます。[`requiredMinimumVersion`](/docs/ja/settings-reference#requiredminimumversion) は古いバイナリが開始されるのをブロックし、既に実行中のセッションを終了しません。106* **長期間のセッション**: 数週間開いたままのセッションは、ロールアウトに遅れることがあります。[`requiredMinimumVersion`](/docs/ja/settings-reference#requiredminimumversion) は古いバイナリの起動をブロックしますが、すでに実行中のセッションを終了させることはありません。

105 107 

106<span id="format-the-policy-for-each-platform" />108<span id="format-the-policy-for-each-platform" />

107 109 


109 各メカニズムがポリシーを保存する場所111 各メカニズムがポリシーを保存する場所

110</h3>112</h3>

111 113 

112キーはどこでも同じですが、各メカニズムはそれらを異なる場所と形状に保存します。114キーはどこでも同じですが、各メカニズムはそれらを異なる場所と形式で保存します:

113 115 

114* **サーバーマネージド**: Anthropic のサーバーまたはゲートウェイがポリシーを保持します。Claude Code はローカルキャッシュを保持し、スタートアップ時に適用し、[各成功したフェッチで置き換えます](/docs/ja/server-managed-settings#security-considerations)。116* **サーバー管理**: Anthropic のサーバー、またはユーザーのゲートウェイがポリシーを保持します。Claude Code はローカルキャッシュを保持し、起動時にそれを適用し、[取得が成功するたびに置き換えます](/docs/ja/server-managed-settings#security-considerations)。

115* **macOS 構成プロファイル**: `com.anthropic.claudecode` マネージド設定ドメイン。`managed-settings.json` と同じトップレベルキーを使用し、ネストされた設定は辞書として、リストは plist 配列として使用します。117* **macOS 構成プロファイル**: `com.anthropic.claudecode` 管理環境設定ドメイン。`managed-settings.json` と同じトップレベルキーを使用し、ネストされた設定は辞書として、リストは plist 配列として記述します。

116* **Windows HKLM レジストリ**: `HKLM\SOFTWARE\Policies\ClaudeCode` の下の `Settings` という名前の `REG_SZ` または `REG_EXPAND_SZ` 値として JSON。118* **Windows HKLM レジストリ**: `HKLM\SOFTWARE\Policies\ClaudeCode` の下にある `Settings` という名前の `REG_SZ` または `REG_EXPAND_SZ` 値としての JSON。

117* **ファイルベース**: `managed-settings.json`、オプションの `managed-settings.d/` ディレクトリ、および `managed-mcp.json` をシステムディレクトリに配置します。macOS では `/Library/Application Support/ClaudeCode/`、Linux と WSL では `/etc/claude-code/`、Windows では `C:\Program Files\ClaudeCode\`。Claude Code はレガシー Windows パス `C:\ProgramData\ClaudeCode\managed-settings.json` を読み取りません。119* **ファイルベース**: システムディレクトリ内の `managed-settings.json`、オプションの `managed-settings.d/` ディレクトリ、および `managed-mcp.json`。システムディレクトリは、macOS では `/Library/Application Support/ClaudeCode/`、Linux と WSL では `/etc/claude-code/`、Windows では `C:\Program Files\ClaudeCode\` です。Claude Code は、従来の Windows パス `C:\ProgramData\ClaudeCode\managed-settings.json` を読み取りません。

118* **Windows HKCU レジストリ**: `HKCU\SOFTWARE\Policies\ClaudeCode` の下の同じ `Settings` 値。120* **Windows HKCU レジストリ**: `HKCU\SOFTWARE\Policies\ClaudeCode` の下にある同じ `Settings` 値。

119 121 

120<h3 id="split-a-file-based-policy-across-teams">122<h3 id="split-a-file-based-policy-across-teams">

121 ファイルベースのポリシーをチーム間で分割する123 ファイルベースのポリシーをチーム間で分割する

122</h3>124</h3>

123 125 

124複数のチームが 1 つのポリシーの一部を所有している場合、各部分を `managed-settings.d/` 内の独自のファイルに配置します。同じシステムディレクトリ内の `managed-settings.json` の隣に配置し、1 つの共有ファイルを編集する代わりに使用します。126複数のチームが 1 つのポリシーの一部をそれぞれ所有している場合は、1 つの共有ファイルを編集する代わりに、各部分を同じシステムディレクトリ内の `managed-settings.json` の隣にある `managed-settings.d/` 内の個別のファイルに配置します。

125 127 

126Claude Code は `managed-settings.json` を最初にマージし、次にディレクトリ内のすべての `*.json` ファイルをアルファベット順にマージします。ファイルに数値プレフィックスを付けて順序を制御します。例えば `10-telemetry.json` と `20-security.json`。Claude Code は隠しファイルと `.json` で終わらないファイルを無視します。128Claude Code は最初に `managed-settings.json` をマージし、次にディレクトリ内のすべての `*.json` ファイルをアルファベット順にマージします。順序を制御するには、`10-telemetry.json` や `20-security.json` のように、ファイル名に数字のプレフィックスを付けます。Claude Code は、隠しファイルと `.json` で終わらないファイルを無視します。

127 129 

1282 つのファイルが同じキーを設定する場合、Claude Code はこれらのルールで組み合わせます。1302 つのファイルが同じキーを設定している場合、Claude Code は次のルールに従ってそれらを組み合わせます:

129 131 

130* **単一値**(`"model": "opus"` または `"cleanupPeriodDays": 7` など): 後のファイルの値が前のファイルを置き換えます132* **単一の値**(`"model": "opus"` や `"cleanupPeriodDays": 7` など): 後のファイルの値が前の値を置き換えます

131* **リスト**(`permissions.deny` または `sandbox.network.allowedDomains` など): 2 つのリストが組み合わされ、重複が削除されます133* **リスト**(`permissions.deny` や `sandbox.network.allowedDomains` など): 2 つのリストが結合され、重複は削除されます

132* **ネストされたブロック**(`env` または `sandbox` など): 2 つのブロックはキーごとにマージされ、内部の各キーはこれらの同じルールに従います134* **ネストされたブロック**(`env` や `sandbox` など): 2 つのブロックはキーごとにマージされ、内部の各キーも同じルールに従います

133* **`fallbackModel`**: 後のチェーンが前のチェーン全体を置き換えます135* **`fallbackModel`**: 後のチェーンが前のチェーン全体を置き換えます

134* **[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) および [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers)**: 同じ名前の後のエントリが前のエントリ全体を置き換えます136* **[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) と [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers)**: 同じ名前を持つ後のエントリが前のエントリ全体を置き換えます

135* **[`modelPicker`](/docs/ja/settings-reference#modelpicker)**: 後のラインアップが前のラインアップ全体を置き換えます137* **[`modelPicker`](/docs/ja/settings-reference#modelpicker)**: 後のラインナップが前のラインナップ全体を置き換えます

136 138 

137<span id="precedence-within-the-managed-tier" />139<span id="precedence-within-the-managed-tier" />

138 140 

mcp.md +18 −10

Details

181 181 

182各々は [MCP サーバーのインストール](#installing-mcp-servers) の 4 つのオプションが取る入力の 1 つです。以下で持っている形状を見つけて、Claude Code が受け入れるコマンドに変換してください。各コマンドは `--scope project` または `--scope user` を追加しない限り、[ローカルスコープ](#local-scope) に書き込みます。182各々は [MCP サーバーのインストール](#installing-mcp-servers) の 4 つのオプションが取る入力の 1 つです。以下で持っている形状を見つけて、Claude Code が受け入れるコマンドに変換してください。各コマンドは `--scope project` または `--scope user` を追加しない限り、[ローカルスコープ](#local-scope) に書き込みます。

183 183 

184<h4 id="from-a-url">184<span id="from-a-url" />

185 URL から185 

186<h4 id="add-a-server-from-a-url">

187 URL からサーバーを追加する

186</h4>188</h4>

187 189 

188URL はサーバーがリモートであることを意味します。`https://` エンドポイントの場合、`--transport http` で追加するか、指示が SSE を使用するエンドポイントを示している場合は [オプション 2](#option-2-add-a-remote-sse-server) に従ってください。`wss://` エンドポイントの場合、`--transport` は `ws` を受け入れないため、代わりに [オプション 4](#option-4-add-a-remote-websocket-server) を使用してください。190URL はサーバーがリモートであることを意味します。`https://` エンドポイントの場合、`--transport http` で追加するか、指示が SSE を使用するエンドポイントを示している場合は [オプション 2](#option-2-add-a-remote-sse-server) に従ってください。`wss://` エンドポイントの場合、`--transport` は `ws` を受け入れないため、代わりに [オプション 4](#option-4-add-a-remote-websocket-server) を使用してください。


193 195 

194指示が API キーまたはトークンヘッダーも提供する場合、[オプション 1](#option-1-add-a-remote-http-server) に示されているように `--header` で渡してください。196指示が API キーまたはトークンヘッダーも提供する場合、[オプション 1](#option-1-add-a-remote-http-server) に示されているように `--header` で渡してください。

195 197 

196<h4 id="from-an-npx-uvx-or-binary-command">198<span id="from-an-npx-uvx-or-binary-command" />

197 `npx`、`uvx`、またはバイナリコマンドから199 

200<h4 id="add-a-server-from-an-npx-uvx-or-binary-command">

201 `npx`、`uvx`、またはバイナリコマンドからサーバーを追加する

198</h4>202</h4>

199 203 

200起動コマンドはサーバーがローカル stdio プロセスとして実行されることを意味します。コマンド全体を `--` の後に配置して、Claude Code が `-y` などのフラグをサーバーを起動するコマンドに渡し、独自のオプションとして読み込まないようにします。指示が要求する環境変数を `--env` で渡します。サーバー名の後、`--` の前に渡します。204起動コマンドはサーバーがローカル stdio プロセスとして実行されることを意味します。コマンド全体を `--` の後に配置して、Claude Code が `-y` などのフラグをサーバーを起動するコマンドに渡し、独自のオプションとして読み込まないようにします。指示が要求する環境変数を `--env` で渡します。サーバー名の後、`--` の前に渡します。


205 209 

206[オプション 3](#option-3-add-a-local-stdio-server) は `--` セパレータを完全にカバーしています。210[オプション 3](#option-3-add-a-local-stdio-server) は `--` セパレータを完全にカバーしています。

207 211 

208<h4 id="from-an-mcpservers-json-block">212<span id="from-an-mcpservers-json-block" />

209 `mcpServers` JSON ブロックから213 

214<h4 id="add-a-server-from-an-mcpservers-json-block">

215 `mcpServers` JSON ブロックからサーバーを追加する

210</h4>216</h4>

211 217 

212Claude Desktop などの別の MCP クライアント向けに書かれた `mcpServers` ブロックは、Claude Code が読み込むラッパーキーとエントリ形状を使用します。`claude mcp add-json` には、ラッパーではなく `mcpServers` 内のオブジェクトを渡します。2 つのエントリは最初に修復が必要です。218Claude Desktop などの別の MCP クライアント向けに書かれた `mcpServers` ブロックは、Claude Code が読み込むラッパーキーとエントリ形状を使用します。`claude mcp add-json` には、ラッパーではなく `mcpServers` 内のオブジェクトを渡します。2 つのエントリは最初に修復が必要です。


367 373 

368v2 では、Claude Code も:374v2 では、Claude Code も:

369 375 

370* HTTP サーバーと stdio サーバーに新しいリビジョンをサポートするかどうかを尋ね、それをサポートするサーバーで使用します。フィーチャーフラグを取得するセッションでは、claude.ai コネクタサーバーにも尋ねます。他のすべてのサーバーには v1 と同様に接続します。376* HTTP、stdio、claude.ai コネクタの各サーバーに新しいリビジョンをサポートするかどうかを尋ね、それをサポートするサーバーで使用します。他のすべてのサーバーには v1 と同様に接続します。

371* 新しいリビジョンのサーバーから [保持するストリーム](#notification-streams-on-the-v2-runtime) 上で `list_changed` 通知を受け取ります。377* 新しいリビジョンのサーバーから [保持するストリーム](#notification-streams-on-the-v2-runtime) 上で `list_changed` 通知を受け取ります。

372* 新しいリビジョンで接続する [チャネル](#push-messages-with-channels) サーバーを登録しません。そのリビジョンはチャネルメッセージを運ぶことができないためです。378* 新しいリビジョンで接続する [チャネル](#push-messages-with-channels) サーバーを登録しません。そのリビジョンはチャネルメッセージを運ぶことができないためです。

373* 予期しない発行者を示す認可応答の [MCP OAuth サインイン](#authenticate-with-remote-mcp-servers) を失敗させます。379* 予期しない発行者を示す認可応答の [MCP OAuth サインイン](#authenticate-with-remote-mcp-servers) を失敗させます。


891 コマンドラインから認証する897 コマンドラインから認証する

892</h3>898</h3>

893 899 

894`claude mcp login <name>` コマンドは設定されたサーバーの OAuth フローをシェルから直接実行するため、セッション内の `/mcp` パネルを開く必要がありません。900`claude mcp login <name>` コマンドは設定されたサーバーの OAuth フローをシェルから直接実行するため、セッション内の `/mcp` パネルを開く必要がありません。claude.ai コネクタの場合は、[シェルからコネクタを再度認可する](/docs/ja/remote-control#authorize-a-connector-again-from-your-shell)の手順に従ってください。

895 901 

896```bash theme={null}902```bash theme={null}

897claude mcp login sentry903claude mcp login sentry


1581 ツール検索は Microsoft Foundry の[Azure でホストされているデプロイメント](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)ではサポートされていません。これらのデプロイメントはサーバー側でツール検索を拒否します。Claude Code はこの拒否を検出し、そのデプロイメント用に MCP ツールを事前に読み込みます。[`ENABLE_TOOL_SEARCH`](#configure-tool-search) はデプロイメント自体からの拒否であるため、これをオーバーライドすることはできません。1587 ツール検索は Microsoft Foundry の[Azure でホストされているデプロイメント](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)ではサポートされていません。これらのデプロイメントはサーバー側でツール検索を拒否します。Claude Code はこの拒否を検出し、そのデプロイメント用に MCP ツールを事前に読み込みます。[`ENABLE_TOOL_SEARCH`](#configure-tool-search) はデプロイメント自体からの拒否であるため、これをオーバーライドすることはできません。

1582</Note>1588</Note>

1583 1589 

1584<h3 id="for-mcp-server-authors">1590<span id="for-mcp-server-authors" />

1585 MCP サーバー作成者向け1591 

1592<h3 id="tool-search-for-mcp-server-authors">

1593 MCP サーバー作成者向けのツール検索

1586</h3>1594</h3>

1587 1595 

1588MCP サーバーを構築している場合、ツール検索が有効になるとサーバー指示フィールドがより有用になります。サーバー指示は、[スキル](/docs/ja/skills)の動作方法と同様に、Claude がいつツールを検索すべきかを理解するのに役立ちます。1596MCP サーバーを構築している場合、ツール検索が有効になるとサーバー指示フィールドがより有用になります。サーバー指示は、[スキル](/docs/ja/skills)の動作方法と同様に、Claude がいつツールを検索すべきかを理解するのに役立ちます。

Details

599 599 

600`/login` を通じて [Claude apps gateway](/docs/ja/claude-apps-gateway) にサインインしたセッションでは、CLI は認証済みの ID をエクスポートに付与します。`user.id` は IdP のサブジェクト、`user.email` はサインインしたメールアドレスで、`user.groups` は IdP のグループメンバーシップをカンマ区切りの文字列として保持します。各エクスポートには `identity.source: gateway-oidc` も付与されます。ゲートウェイの ID は最後に適用されるため、これらのセッションでは `OTEL_RESOURCE_ATTRIBUTES` で設定した `user.*` および `identity.*` キーは無視されます。600`/login` を通じて [Claude apps gateway](/docs/ja/claude-apps-gateway) にサインインしたセッションでは、CLI は認証済みの ID をエクスポートに付与します。`user.id` は IdP のサブジェクト、`user.email` はサインインしたメールアドレスで、`user.groups` は IdP のグループメンバーシップをカンマ区切りの文字列として保持します。各エクスポートには `identity.source: gateway-oidc` も付与されます。ゲートウェイの ID は最後に適用されるため、これらのセッションでは `OTEL_RESOURCE_ATTRIBUTES` で設定した `user.*` および `identity.*` キーは無視されます。

601 601 

602<Note>

603 開発者がサインインする前に Claude Code がログに記録するイベントには、ゲートウェイの ID は含まれません。Claude Code がゲートウェイからサインアウトした状態でセッションを開始する場合(たとえば[ゲートウェイがサインインを終了](/docs/ja/errors#cloud-gateway-session-expired)した後など)、サインイン前にログに記録された起動イベントには匿名の `user.id` が含まれ、`identity.source` は含まれません。これには [`managed_settings_resolved`](#managed-settings-resolved-event)、[`plugin_loaded`](#plugin-loaded-event)、[`mcp_server_connection`](#mcp-server-connection-event) が含まれます。

604</Note>

605 

602ゲートウェイ経由で接続する Claude Desktop および Cowork セッションの ID 属性については、[ゲートウェイの `telemetry` リファレンス](/docs/ja/claude-apps-gateway-config#telemetry)を参照してください。606ゲートウェイ経由で接続する Claude Desktop および Cowork セッションの ID 属性については、[ゲートウェイの `telemetry` リファレンス](/docs/ja/claude-apps-gateway-config#telemetry)を参照してください。

603 607 

604イベントには、さらに以下の属性が含まれます。これらはカーディナリティが無制限に増大する原因となるため、メトリクスには付与されません。608イベントには、さらに以下の属性が含まれます。これらはカーディナリティが無制限に増大する原因となるため、メトリクスには付与されません。


917* `error`: エラーメッセージ921* `error`: エラーメッセージ

918* `status_code`: 数値としての HTTP ステータスコード。接続の失敗など、HTTP 以外のエラーの場合は含まれません。922* `status_code`: 数値としての HTTP ステータスコード。接続の失敗など、HTTP 以外のエラーの場合は含まれません。

919* `duration_ms`: リクエストの所要時間(ミリ秒)923* `duration_ms`: リクエストの所要時間(ミリ秒)

920* `attempt`: 最初のリクエストを含む試行の合計回数(`1` は再試行が発生しなかったことを意味します)924* `attempt`: 最初のリクエストを含む試行回数。カウントが再開されるタイミングについては[再試行の上限到達を検出する](#detect-retry-exhaustion)を参照してください

921* `request_id`: API リクエスト ID(例: `"req_011..."`)。[イベント相関属性](#event-correlation-attributes)で説明しています。925* `request_id`: API リクエスト ID(例: `"req_011..."`)。[イベント相関属性](#event-correlation-attributes)で説明しています。

922* `client_request_id`: `x-client-request-id` リクエストヘッダーとして送信される、クライアントが生成した UUID。タイムアウトや接続エラーなどの失敗によってサーバーの `request_id` が生成されなかった場合でも利用できます。含まれる条件については[イベント相関属性](#event-correlation-attributes)の表を参照してください。Claude Code v2.1.214 以降が必要です926* `client_request_id`: `x-client-request-id` リクエストヘッダーとして送信される、クライアントが生成した UUID。タイムアウトや接続エラーなどの失敗によってサーバーの `request_id` が生成されなかった場合でも利用できます。含まれる条件については[イベント相関属性](#event-correlation-attributes)の表を参照してください。Claude Code v2.1.214 以降が必要です

923* `speed`: `"fast"` または `"normal"`。fast mode が有効だったかどうかを示します927* `speed`: `"fast"` または `"normal"`。fast mode が有効だったかどうかを示します


1190 1194 

1191Claude Code がプロンプト内の `@` メンションを解決したときにログに記録されます。すべてのメンションでイベントが出力されるわけではありません。権限の拒否、サイズが大きすぎるファイル、PDF の参照添付、ディレクトリ一覧の取得失敗などの早期終了パスでは、ログに記録せずに戻ります。1195Claude Code がプロンプト内の `@` メンションを解決したときにログに記録されます。すべてのメンションでイベントが出力されるわけではありません。権限の拒否、サイズが大きすぎるファイル、PDF の参照添付、ディレクトリ一覧の取得失敗などの早期終了パスでは、ログに記録せずに戻ります。

1192 1196 

1197Claude Code はプロンプトを読み取るたびに、`mention_type` が `"agent"` のイベントと `"mcp_resource"` のイベントをそれぞれ最大 100 件までログに記録します。いずれかの上限を超えたメンションも解決はされますが、イベントは出力されません。

1198 

1193**イベント名**: `claude_code.at_mention`1199**イベント名**: `claude_code.at_mention`

1194 1200 

1195**属性**:1201**属性**:


1528 1534 

1529Claude Code は失敗した API リクエストを内部的に再試行し、あきらめた後にのみ単一の `claude_code.api_error` イベントを出力するため、イベント自体がそのリクエストの終端信号です。中間再試行試行は個別のイベントとしてログされません。1535Claude Code は失敗した API リクエストを内部的に再試行し、あきらめた後にのみ単一の `claude_code.api_error` イベントを出力するため、イベント自体がそのリクエストの終端信号です。中間再試行試行は個別のイベントとしてログされません。

1530 1536 

1531イベントの `attempt` 属性は、試行の総数を記録します。`CLAUDE_CODE_MAX_RETRIES` はデフォルトで 10 で、15 で上限です。v2.1.199 以降では、`CLAUDE_CODE_RETRY_WATCHDOG` を設定してデフォルトを引き上げ、上限を削除できます。1537イベントの `attempt` 属性は、試行回数を記録します。`CLAUDE_CODE_MAX_RETRIES` はデフォルトで 10 で、15 で上限です。v2.1.199 以降では、`CLAUDE_CODE_RETRY_WATCHDOG` を設定してデフォルトを引き上げ、上限を削除できます。

1532 1538 

1533リクエストが一時的なエラーのすべての再試行を枯渇させた場合、`attempt` はその有効な制限より 1 つ多くなります: デフォルトでは 11、ウォッチドッグが設定されていない限り 16 を超えることはありません。より低い値は、`400` レスポンスなどの再試行不可能なエラー、または独自のより小さい再試行予算を持つ原因を示します。たとえば、Claude Code は AWS または Google Cloud 認証情報の読み込み失敗を最大 2 回再試行します。1539リクエストが一時的なエラーのすべての再試行を枯渇させた場合、`attempt` は最大でもその有効な制限より 1 つ多い値になります: デフォルトでは 11 です。

1540 

1541より低い値でも再試行が尽きたことを意味する場合があります: Claude Code がストリーミングの失敗後にリクエストを再発行するたびに、`attempt` は `1` から再び開始されるためです。

1534 1542 

1535セッションが回復したものと停止したものを区別するには、イベントを `session.id` でグループ化し、エラーの後に後続の `api_request` イベントが存在するかどうかを確認します。1543セッションが回復したものと停止したものを区別するには、イベントを `session.id` でグループ化し、エラーの後に後続の `api_request` イベントが存在するかどうかを確認します。

1536 1544 


1699 1707 

1700メトリクス、ログ、トレースバックエンドの選択により、実行できる分析のタイプが決まります:1708メトリクス、ログ、トレースバックエンドの選択により、実行できる分析のタイプが決まります:

1701 1709 

1702<h3 id="for-metrics">1710<span id="for-metrics" />

1703 メトリクスの場合1711 

1712<h3 id="backends-for-metrics">

1713 メトリクス用のバックエンド

1704</h3>1714</h3>

1705 1715 

1706* **時系列データベース**: レート計算、集約メトリクス1716* **時系列データベース**: レート計算、集約メトリクス

1707* **カラムナーストア**: 複雑なクエリ、一意のユーザー分析1717* **カラムナーストア**: 複雑なクエリ、一意のユーザー分析

1708* **フル機能の可観測性プラットフォーム**: 高度なクエリ、可視化、アラート1718* **フル機能の可観測性プラットフォーム**: 高度なクエリ、可視化、アラート

1709 1719 

1710<h3 id="for-events/logs">1720<span id="for-events/logs" />

1711 イベント/ログの場合1721 

1722<h3 id="backends-for-events-and-logs">

1723 イベントとログ用のバックエンド

1712</h3>1724</h3>

1713 1725 

1714* **ログ集約システム**: 全文検索、ログ分析1726* **ログ集約システム**: 全文検索、ログ分析

1715* **カラムナーストア**: 構造化イベント分析1727* **カラムナーストア**: 構造化イベント分析

1716* **フル機能の可観測性プラットフォーム**: メトリクスとイベント間の相関1728* **フル機能の可観測性プラットフォーム**: メトリクスとイベント間の相関

1717 1729 

1718<h3 id="for-traces">1730<span id="for-traces" />

1719 トレースの場合1731 

1732<h3 id="backends-for-traces">

1733 トレース用のバックエンド

1720</h3>1734</h3>

1721 1735 

1722分散トレースストレージとスパン相関をサポートするバックエンドを選択します:1736分散トレースストレージとスパン相関をサポートするバックエンドを選択します:

Details

91| `-y, --yes` | `Run this command now?` プロンプトなしで表示されたインストールコマンドを受け入れます。Bash ツールまたはフックからなど、Claude Code セッション内で実行されるコマンドでは無視されます。Claude Code v2.1.229 以降が必要です |91| `-y, --yes` | `Run this command now?` プロンプトなしで表示されたインストールコマンドを受け入れます。Bash ツールまたはフックからなど、Claude Code セッション内で実行されるコマンドでは無視されます。Claude Code v2.1.229 以降が必要です |

92| `--accept-command <sha256>` | 前の [`--json` 実行](#plugin-json-result)が `shownCommand` で報告した `sha256` を持つ表示されたインストールコマンドを受け入れます。`-y` の代わりに使用します。`-y` と組み合わせることはできません。[表示されたインストールコマンドを受け入れる](#accept-a-displayed-install-command)を参照してください。Claude Code v2.1.271 以降が必要です |92| `--accept-command <sha256>` | 前の [`--json` 実行](#plugin-json-result)が `shownCommand` で報告した `sha256` を持つ表示されたインストールコマンドを受け入れます。`-y` の代わりに使用します。`-y` と組み合わせることはできません。[表示されたインストールコマンドを受け入れる](#accept-a-displayed-install-command)を参照してください。Claude Code v2.1.271 以降が必要です |

93| `--json` | スクリプトで使用するために、人間が読める形式のメッセージの代わりに、stdout の最後の行に 1 つの JSON オブジェクトとして結果を出力します。[JSON 結果形式](#plugin-json-result)を参照してください。Claude Code v2.1.268 以降が必要です |93| `--json` | スクリプトで使用するために、人間が読める形式のメッセージの代わりに、stdout の最後の行に 1 つの JSON オブジェクトとして結果を出力します。[JSON 結果形式](#plugin-json-result)を参照してください。Claude Code v2.1.268 以降が必要です |

94| `--marketplace <source>` | ベア名で指定した `<plugin>` を `<source>` のマーケットプレイスからインストールします。そのマーケットプレイスをまだ追加していない場合は、先に追加します。[1 つのコマンドでマーケットプレイスを追加してインストールする](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command)を参照してください。Claude Code v2.1.292 以降が必要です |

94 95 

95使用しているバージョンがサポートするすべてのオプションを確認するには、シェルで `claude plugin install --help` を実行してください。96使用しているバージョンがサポートするすべてのオプションを確認するには、シェルで `claude plugin install --help` を実行してください。

96 97 

Details

185 185 

1863 つの方法で 1 つのセッションのためにプラグインを読み込むことができます。`--plugin-dir` でディスク上のディレクトリまたは `.zip` アーカイブから、`--plugin-url` で URL から、またはフラグを追加できない場合は環境変数から。各プラグインはそのセッションのみのために読み込まれ、設定には何も書き込まれません。セッション中にプラグインのファイルを編集する場合、`/reload-plugins` を実行して変更を読み込んでください。1863 つの方法で 1 つのセッションのためにプラグインを読み込むことができます。`--plugin-dir` でディスク上のディレクトリまたは `.zip` アーカイブから、`--plugin-url` で URL から、またはフラグを追加できない場合は環境変数から。各プラグインはそのセッションのみのために読み込まれ、設定には何も書き込まれません。セッション中にプラグインのファイルを編集する場合、`/reload-plugins` を実行して変更を読み込んでください。

187 187 

188<h4 id="from-a-directory-or-zip">188<span id="from-a-directory-or-zip" />

189 ディレクトリまたは `.zip` から189 

190<h4 id="load-a-plugin-from-a-directory-or-zip">

191 ディレクトリまたは `.zip` からプラグインを読み込む

190</h4>192</h4>

191 193 

192シェルから `claude` を開始するときに、`--plugin-dir` をプラグインのルートディレクトリまたはその `.zip` アーカイブで渡してください。複数のプラグインを読み込むためにフラグを繰り返してください。194シェルから `claude` を開始するときに、`--plugin-dir` をプラグインのルートディレクトリまたはその `.zip` アーカイブで渡してください。複数のプラグインを読み込むためにフラグを繰り返してください。


196```198```

197 199 

198<h4 id="load-a-folder-of-plugins">200<h4 id="load-a-folder-of-plugins">

199 プラグインのフォルダから201 プラグインのフォルダを読み込む

200</h4>202</h4>

201 203 

202複数のプラグインを 1 つの場所から読み込むには、`--plugin-dir ./plugins` のようにそれらを保持するフォルダを渡してください。プラグインのフォルダを読み込むには Claude Code v2.1.265 以降が必要です。204複数のプラグインを 1 つの場所から読み込むには、`--plugin-dir ./plugins` のようにそれらを保持するフォルダを渡してください。プラグインのフォルダを読み込むには Claude Code v2.1.265 以降が必要です。


212 214 

213これらの変更のそれぞれについて、セッションにメッセージが表示されます。プラグインの読み込みまたはアンロードが会話の途中で[プロンプトキャッシュを無効にする](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)場合、変更は代わりに保持され、メッセージは `/reload-plugins` を実行して適用するよう指示します。215これらの変更のそれぞれについて、セッションにメッセージが表示されます。プラグインの読み込みまたはアンロードが会話の途中で[プロンプトキャッシュを無効にする](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)場合、変更は代わりに保持され、メッセージは `/reload-plugins` を実行して適用するよう指示します。

214 216 

215<h4 id="fetch-an-archive-from-a-url-for-one-session">217<span id="fetch-an-archive-from-a-url-for-one-session" />

216 URL から218 

219<h4 id="load-a-plugin-from-a-url">

220 URL からプラグインを読み込む

217</h4>221</h4>

218 222 

219シェルから `claude` を開始するときに、`--plugin-url` を `.zip` アーカイブのアドレス(例えば CI が公開するビルドアーティファクト)で渡してください。223シェルから `claude` を開始するときに、`--plugin-url` を `.zip` アーカイブのアドレス(例えば CI が公開するビルドアーティファクト)で渡してください。


228 232 

229Claude Code がアーカイブをフェッチできない場合、またはアーカイブが無効な場合、プラグインなしで開始し、プラグイン読み込みエラーを記録します。これは `/plugin` マネージャーの **Errors** タブで確認できます。233Claude Code がアーカイブをフェッチできない場合、またはアーカイブが無効な場合、プラグインなしで開始し、プラグイン読み込みエラーを記録します。これは `/plugin` マネージャーの **Errors** タブで確認できます。

230 234 

231<h4 id="from-an-environment-variable">235<span id="from-an-environment-variable" />

232 環境変数から236 

237<h4 id="load-plugins-from-an-environment-variable">

238 環境変数からプラグインを読み込む

233</h4>239</h4>

234 240 

235`--plugin-dir` フラグを追加できないセッションでプラグインを読み込むには、[`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ja/env-vars#variables)環境変数にそれらの絶対パスをリストしてください。Claude Code は各パスを `--plugin-dir` パスとして読み込みます。これらのプラグインは、`--plugin-dir` で渡したものに加えて読み込まれます。[プロジェクトとローカル設定はこの変数を設定できません](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)。`CLAUDE_CODE_PLUGIN_DIRS` には Claude Code v2.1.280 以降が必要です。241`--plugin-dir` フラグを追加できないセッションでプラグインを読み込むには、[`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ja/env-vars#variables)環境変数にそれらの絶対パスをリストしてください。Claude Code は各パスを `--plugin-dir` パスとして読み込みます。これらのプラグインは、`--plugin-dir` で渡したものに加えて読み込まれます。[プロジェクトとローカル設定はこの変数を設定できません](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)。`CLAUDE_CODE_PLUGIN_DIRS` には Claude Code v2.1.280 以降が必要です。

Details

339 アーカイブダウンロードを認証する339 アーカイブダウンロードを認証する

340</h2>340</h2>

341 341 

342[`archive`](/docs/ja/plugins/marketplace-reference#archive-plugin-source) ダウンロード(プライベートレジストリからのダウンロードなど)を認証するには、Claude Code がそれで送信する HTTP ヘッダーを設定してください。これらの場所のいずれかで `headers` を設定できます:342プライベートレジストリからのダウンロードなど、[`archive`](/docs/ja/plugins/marketplace-reference#archive-plugin-source) のダウンロードを認証するには、Claude Code がダウンロード時に送信する HTTP ヘッダーを設定します。`headers` は次のいずれかの場所で設定できます。

343 343 

344* **マーケットプレイスの `url` ソース**:[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) エントリなど、マーケットプレイスを登録した `url` ソース。344* **マーケットプレイスの `url` ソース**:マーケットプレイスの登録元である `url` ソースです。[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) のエントリなどが該当します。

345* **プラグインのエントリ**:Claude Code v2.1.238 以降では、代わりに `source` の横にプラグインの `marketplace.json` エントリで設定できます。345* **プラグインのエントリ**:Claude Code v2.1.238 以降では、代わりにプラグインの `marketplace.json` エントリ内で、`source` と並べて設定できます。

346 346 

347どちらの場所でも、値が短命の場合(レジストリが要求時に生成するトークンなど)は、`headers` の代わりに `headersHelper` コマンドを設定してください。Claude Code はコマンドを実行し、その場所のヘッダーとして出力する JSON オブジェクトを送信します。Claude Code v2.1.238 以降が必要です。347どちらの場所でも、レジストリがリクエストに応じて生成するトークンのように値の有効期間が短い場合は、`headers` の代わりに `headersHelper` コマンドを設定します。Claude Code はこのコマンドを実行し、コマンドが出力した JSON オブジェクトをその場所のヘッダーとして送信します。Claude Code v2.1.238 以降が必要です。

348 348 

349[マーケットプレイスリファレンス](/docs/ja/plugins/marketplace-reference#plugin-entries)は `headers` と `headersHelper` エントリフィールドをリストしています。349[マーケットプレイスリファレンス](/docs/ja/plugins/marketplace-reference#plugin-entries)に、エントリのフィールドである `headers` と `headersHelper` の説明があります。

350 350 

351選択する場所は、どのダウンロードがヘッダーを取得し、Claude Code がコマンドをいつ実行するかを決定します:351どちらの場所を選ぶかによって、どのダウンロードにヘッダーが付与されるか、また Claude Code がいつコマンドを実行するかが決まります。

352 352 

353| 場所 | ヘッダーを取得するダウンロード | Claude Code が `headersHelper` をそこで実行するとき |353| 場所 | ヘッダーが付与されるダウンロード | そこに設定された `headersHelper` を Claude Code が実行するタイミング |

354| :- | :- | :- |354| :- | :- | :- |

355| マーケットプレイス `url` ソース | マーケットプレイス URL のオリジン上のアーカイブダウンロード。同じスキーム、ホスト、ポート | マーケットプレイスの `marketplace.json` の各フェッチの前と、そのオリジン上の各アーカイブダウンロードの前。Claude Code は 1 回の実行の出力を最大 60 秒間再利用します |355| マーケットプレイスの `url` ソース | マーケットプレイス URL と同じオリジン(スキーム、ホスト、ポートがすべて同じ)でのアーカイブダウンロード | マーケットプレイスの `marketplace.json` を取得する前と、そのオリジンでアーカイブをダウンロードする前に毎回実行します。Claude Code は 1 回の実行の出力を最大 60 秒間再利用します |

356| プラグインエントリ | そのエントリのダウンロードのみ | ユーザーがそのプラグインを単独でインストールまたは更新し、[コマンドを受け入れる](#how-users-accept-a-headershelper-command)場合のみ |356| プラグインのエントリ | そのエントリのダウンロードのみ | ユーザーがそのプラグイン 1 つだけを単独でインストールまたは更新し、[コマンドを受け入れた](#how-users-accept-a-headershelper-command)場合のみ |

357 357 

358両方の場所が同じ名前のヘッダーを設定する場合、Claude Code はエントリの値を送信します。1 つの場所内で、コマンドが出力するヘッダーは同じ名前のリストされたヘッダーをオーバーライドします。358両方の場所で同じ名前のヘッダーが設定されている場合、Claude Code はエントリ側の値を送信します。同じ場所の中では、コマンドが出力したヘッダーが、`headers` に記載された同じ名前のヘッダーを上書きします。

359 359 

360<h3 id="add-a-headershelper-to-a-plugin-entry">360<h3 id="add-a-headershelper-to-a-plugin-entry">

361 プラグインエントリに headersHelper を追加する361 プラグインのエントリに headersHelper を追加する

362</h3>362</h3>

363 363 

364このエントリは `source` の横に `headersHelper` を設定します。また、[`"strict": false`](/docs/ja/plugins/marketplace-reference#strict-mode)を設定します。これは Claude Code が `headersHelper` を設定する `marketplace.json` エントリに必要とします:364次のエントリでは、`source` と並べて `headersHelper` を設定しています。また [`"strict": false`](/docs/ja/plugins/marketplace-reference#strict-mode) も設定しています。Claude Code では、`headersHelper` を設定する `marketplace.json` エントリにこの設定が必須です。

365 365 

366```json theme={null}366```json theme={null}

367{367{


376}376}

377```377```

378 378 

379エントリを確認するには、シェルで `claude plugin install my-plugin@your-marketplace` を実行してください。Claude Code はコマンドとアーカイブ URL を表示し、受け入れた後に zip をダウンロードします。379エントリを確認するには、シェルで `claude plugin install my-plugin@your-marketplace` を実行します。Claude Code がコマンドとアーカイブ URL を表示し、受け入れると zip をダウンロードします。

380 380 

381<h3 id="write-the-headershelper-command">381<h3 id="write-the-headershelper-command">

382 headersHelper コマンドを書く382 headersHelper コマンドを作成する

383</h3>383</h3>

384 384 

385マーケットプレイスの `url` ソースまたはプラグインエントリで `headersHelper` を設定するかどうかにかかわらず、コマンドを書いてこれらの要件を満たしてください:385`headersHelper` をマーケットプレイスの `url` ソースに設定する場合もプラグインのエントリに設定する場合も、コマンドは次の要件を満たすように作成します。

386 386 

387* **コマンドテキスト**:最大 500 文字の印字可能 ASCII。4 つ以上のスペースの実行なし。387* **コマンドのテキスト**:印字可能な ASCII で 500 文字以内とし、4 つ以上連続するスペースを含めないでください。

388* **出力**:stdout に 1 つの JSON オブジェクトのヘッダー名と文字列値を出力してから、10 秒以内に終了 0 で終了します。388* **出力**:ヘッダー名と文字列値からなる JSON オブジェクトを 1 つ stdout に出力し、10 秒以内に終了コード 0 で終了してください。

389* **シェルと作業ディレクトリ**:Claude Code はコマンドを `sh` を通じて実行するか、Windows では `cmd.exe` を通じて実行します。作業ディレクトリは設定ディレクトリです。`~/.claude` または [`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars#variables)。相対パスはそのディレクトリに対して解決されるため、ユーザーのプロジェクトではなく、絶対パスまたは `PATH` 上のコマンドを指定してください。389* **シェルと作業ディレクトリ**:Claude Code はコマンドを `sh` で実行します(Windows では `cmd.exe`)。作業ディレクトリは設定ディレクトリで、`~/.claude` または [`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars#variables) です。相対パスはユーザーのプロジェクトではなくこのディレクトリを基準に解決されるため、絶対パスか `PATH` 上のコマンドを指定してください。

390* **Claude Code が削除する変数**:コマンドが `marketplace.json` エントリ、またはプロジェクトの `.claude/settings.json` または `.claude/settings.local.json` で設定されている場合、Claude Code は環境から認証情報のように見える名前を持つすべての変数を削除します。[MCP `headersHelper` に適用するのと同じルール](/docs/ja/mcp#which-variables-a-helper-can-read)。`ANTHROPIC_API_KEY` と `MY_REGISTRY_TOKEN` は両方とも削除されるため、コマンドはファイルまたは認証情報ストアから認証情報を読み取ります。この削除はユーザー設定、`--settings` ファイル、または管理設定で設定されたコマンドには適用されません。390* **Claude Code が削除する変数**:コマンドが `marketplace.json` エントリ、またはプロジェクトの `.claude/settings.json` や `.claude/settings.local.json` で設定されている場合、Claude Code は、[MCP の `headersHelper` に適用するのと同じルール](/docs/ja/mcp#which-variables-a-helper-can-read)に従い、名前が認証情報らしく見えるすべての変数を環境から削除します。`ANTHROPIC_API_KEY` と `MY_REGISTRY_TOKEN` はどちらも削除されるため、コマンドは認証情報をファイルや認証情報ストアから読み取るようにしてください。この削除は、ユーザー設定、`--settings` ファイル、または管理設定で設定されたコマンドには適用されません。

391* **Claude Code が設定する変数**:`url` ソースのコマンドの場合は `CLAUDE_CODE_MARKETPLACE_URL` と `CLAUDE_CODE_MARKETPLACE_NAME`。エントリのコマンドの場合は `CLAUDE_CODE_PLUGIN_NAME` と `CLAUDE_CODE_PLUGIN_ARCHIVE_URL`。`CLAUDE_CODE_MARKETPLACE_NAME` は、ユーザーが URL でマーケットプレイスを追加した後の最初のフェッチでは設定されていません。そのフェッチが名前を提供するため。391* **Claude Code が設定する変数**:`url` ソースのコマンドには `CLAUDE_CODE_MARKETPLACE_URL` と `CLAUDE_CODE_MARKETPLACE_NAME`、エントリのコマンドには `CLAUDE_CODE_PLUGIN_NAME` と `CLAUDE_CODE_PLUGIN_ARCHIVE_URL` が設定されます。ユーザーが URL でマーケットプレイスを追加した後の最初の取得では、その取得によって名前が得られるため、`CLAUDE_CODE_MARKETPLACE_NAME` は設定されません。

392 392 

393ベアラートークンをミントするコマンドは、このようなオブジェクトを出力します:393ベアラートークンを発行するコマンドは、次のようなオブジェクトを出力します。

394 394 

395```json theme={null}395```json theme={null}

396{"Authorization": "Bearer eyJhbGciOiJSUzI1NiJ9"}396{"Authorization": "Bearer eyJhbGciOiJSUzI1NiJ9"}

397```397```

398 398 

399<h3 id="when-claude-code-skips-a-headershelper-command-or-drops-its-output">399<h3 id="when-claude-code-skips-a-headershelper-command-or-drops-its-output">

400 Claude Code が headersHelper コマンドをスキップするか出力をドロップするとき400 Claude Code が headersHelper コマンドをスキップする場合や出力を破棄する場合

401</h3>401</h3>

402 402 

403`headersHelper` コマンドは実行されないか、`headers` からのヘッダーまたはコマンドの出力は、以下のいずれかが適用される場合にドロップされます:403次のいずれかに該当する場合、`headersHelper` コマンドは実行されないか、`headers` またはコマンドの出力から得たヘッダーが破棄されます。

404 404 

405* **コマンドが失敗する**:コマンドが非ゼロで終了するか、10 秒を超えて実行するか、JSON オブジェクト以外の文字列値を出力する場合、コマンドが実行されたフェッチまたはダウンロードは発生しません。405* **コマンドが失敗した**:コマンドが 0 以外の終了コードで終了した場合、10 秒を超えて実行された場合、または文字列値からなる JSON オブジェクト以外のものを出力した場合、そのコマンドを実行する目的だった取得やダウンロードは行われません。

406* **マーケットプレイス URL が `https://` で始まらない**:その `url` ソースのコマンドは実行されず、リクエストは `headers` フィールドにリストされたヘッダーのみを実行します。406* **マーケットプレイスの URL が `https://` で始まらない**:その `url` ソースのコマンドは実行されず、リクエストには `headers` フィールドに記載されたヘッダーのみが付与されます。

407* **リダイレクトがオリジンを離れる**:ダウンロードがアーカイブ URL のオリジンからリダイレクトされる場合、リダイレクトされたリクエストはマーケットプレイス `url` ソースまたはプラグインエントリからの `headers` 値またはコマンド出力を実行しません。407* **リダイレクトでオリジンを離れた**:ダウンロードがアーカイブ URL のオリジン外にリダイレクトされた場合、リダイレクト後のリクエストには、マーケットプレイスの `url` ソースとプラグインのエントリのどちらの `headers` の値もコマンドの出力も付与されません。

408* **エントリがルーティングまたはアイデンティティヘッダーを設定する**:Claude Code はエントリの `headers` とコマンド出力から `Host`、`Cookie`、`X-Forwarded-*` などのリクエストルーティングおよびクライアントアイデンティティ名をドロップし、`Authorization` などの認証名を保持します。すべての `marketplace.json` エントリはこのようにフィルタリングされます。設定内のインラインプラグインエントリの場合は、[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces)を参照してください。408* **エントリがルーティング用または識別用のヘッダーを設定している**:Claude Code は、`Host`、`Cookie`、`X-Forwarded-*` などのリクエストルーティング用やクライアント識別用の名前をエントリの `headers` とコマンドの出力から破棄し、`Authorization` などの認証用の名前は保持します。すべての `marketplace.json` エントリがこの方法でフィルタリングされます。設定内のインラインプラグインエントリについては、[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) を参照してください。

409* **`--add-dir` ディレクトリの設定で設定されたコマンド**:コマンドは無視され、`url` ソースと[インラインプラグインエントリ](/docs/ja/settings-reference#extraknownmarketplaces)の両方で、そのファイルの `headers` のみが送信されます。409* **コマンドが `--add-dir` ディレクトリの設定で設定されている**:`url` ソースでも[インラインプラグインエントリ](/docs/ja/settings-reference#extraknownmarketplaces)でも、コマンドは無視され、そのファイルの `headers` のみが送信されます。

410* **管理設定がコマンドをブロックする**:[`disableCommandPluginSources`](/docs/ja/settings-reference#disablecommandpluginsources)を `true` に設定するとブロック `headersHelper` コマンド、および [`allowManagedHooksOnly`](/docs/ja/settings-reference#allowmanagedhooksonly) も `disableCommandPluginSources` が明示的に `false` でない限りブロックします。どちらのブロックでも、Claude Code は管理設定自体が宣言するマーケットプレイスのコマンドを実行します。410* **管理設定がコマンドをブロックしている**:[`disableCommandPluginSources`](/docs/ja/settings-reference#disablecommandpluginsources) を `true` に設定すると `headersHelper` コマンドがブロックされます。また、[`allowManagedHooksOnly`](/docs/ja/settings-reference#allowmanagedhooksonly) も、`disableCommandPluginSources` が明示的に `false` でない限りこれらをブロックします。どちらのブロック下でも、管理設定自体が宣言しているマーケットプレイスについては、Claude Code は引き続きコマンドを実行します。

411 411 

412<h3 id="how-users-accept-a-headershelper-command">412<h3 id="how-users-accept-a-headershelper-command">

413 ユーザーが headersHelper コマンドを受け入れる方法413 ユーザーが headersHelper コマンドを受け入れる方法

414</h3>414</h3>

415 415 

416ユーザーは、そのプラグインを単独でインストールまたは更新するたびに、プラグインエントリのコマンドを受け入れます。彼らは `/plugin` のプラグイン自体のビューから、または `claude plugin install` または `claude plugin update` でそれを行います。Claude Code はコマンドとアーカイブ URL を表示し、ユーザーが受け入れた後にのみコマンドを実行します。416ユーザーは、プラグイン 1 つだけを単独でインストールまたは更新するたびに、そのプラグインのエントリのコマンドを受け入れます。Claude Code はコマンドとアーカイブ URL を表示し、ユーザーが受け入れた後にのみコマンドを実行します。

417 417 

418非対話的なシェルでは、[`--yes`](/docs/ja/plugins/cli-reference#plugin-install)を渡してコマンドを受け入れます。前の `--json` 実行が表示した、そのコマンドのみを受け入れるには、[`--accept-command`](/docs/ja/plugins/cli-reference#plugin-install)を実行が報告した `sha256` で渡します。418ユーザーは、ターミナルの Claude Code セッション内、セッションを実行していないシェル、または VS Code 拡張機能でプラグインをインストールまたは更新できます。

419 419 

420Claude Code は表示したコマンドのみを実行し、表示したアーカイブ URL に対してのみ実行します。エントリのコマンドまたはアーカイブ URL が間に変更された場合、Claude Code はインストールまたは更新を拒否します。クエリ文字列のみの変更はカウントされません。420* **ターミナルのセッション**:`/plugin` 内のそのプラグイン自身のビューから行います。

421* **シェル**:`claude plugin install` または `claude plugin update` で行います。

422* **VS Code 拡張機能**:拡張機能のバージョン 2.1.290 以降で、[**Manage plugins** ダイアログ](/docs/ja/vs-code#manage-plugins)から行います。

423 

424非対話型のシェルでは、[`--yes`](/docs/ja/plugins/cli-reference#plugin-install) を渡してコマンドを受け入れます。以前の `--json` 実行で表示されたコマンドだけを受け入れるには、その実行で報告された `sha256` を指定して [`--accept-command`](/docs/ja/plugins/cli-reference#plugin-install) を渡します。

425 

426Claude Code は、表示したコマンドを、表示したアーカイブ URL に対してのみ実行します。その間にエントリのコマンドまたはアーカイブ URL が変更された場合、Claude Code はインストールまたは更新を拒否します。クエリ文字列のみの変更は、VS Code 拡張機能の場合または `--accept-command` を使用した場合を除き、変更とはみなされません。

421 427 

422<h3 id="installs-and-updates-that-refuse-the-command-instead-of-asking">428<h3 id="installs-and-updates-that-refuse-the-command-instead-of-asking">

423 コマンドを要求する代わりに拒否するインストールと更新429 確認せずにコマンドを拒否するインストールと更新

424</h3>430</h3>

425 431 

426単一プラグインのインストールまたは更新以外の操作では、Claude Code はエントリのコマンドを実行せず、アーカイブをダウンロードしません。プラグインはインストール済みバージョンに留まるか、インストールされたままで、ユーザーは以下のいずれかを見ます:432単一プラグインのインストールまたは更新以外の操作では、Claude Code はエントリのコマンドを実行せず、そのアーカイブもダウンロードしません。プラグインはインストール済みのバージョンのまま、または未インストールのままとなり、ユーザーには次のいずれかの結果が表示されます。

427 433 

428* **複数のプラグインを一度にインストールする、プラグイン提案から、または別のプラグインの依存関係として**:Claude Code はコマンドを持つプラグインを拒否し、ユーザーを `/plugin` のそのプラグイン自体のビューに指示します。バルクインストール内の他のプラグインはまだインストールします。プラグインが拒否されたプラグインに依存する場合、ユーザーがそのプラグインを単独でインストールするまで失敗します。434* **複数のプラグインを一度にインストールする場合、プラグインの提案からインストールする場合、または別のプラグインの依存関係としてインストールする場合**:Claude Code はコマンドを持つプラグインを拒否し、ユーザーを `/plugin` 内のそのプラグイン自身のビューに誘導します。一括インストールの他のプラグインは引き続きインストールされます。拒否されたプラグインに依存するプラグインは、ユーザーが拒否されたプラグインを単独でインストールするまでインストールに失敗します。

429* **バックグラウンド自動更新、またはアーカイブがダウンロードされたことのないプラグインのセッション開始**:Claude Code はプラグインを `/plugin` エラータブにリストして、ユーザーが単独でインストールまたは更新することを知っています。435* **バックグラウンドでの自動更新、またはアーカイブが一度もダウンロードされていないプラグインのセッション開始時**:Claude Code はそのプラグインを `/plugin` の Errors タブに表示し、ユーザーが自分でインストールまたは更新する必要があることを知らせます。

430 436 

431<h3 id="when-a-marketplace-url-sources-command-runs">437<h3 id="when-a-marketplace-url-sources-command-runs">

432 マーケットプレイス `url` ソースのコマンドが実行されるとき438 マーケットプレイスの `url` ソースのコマンドが実行されるタイミング

433</h3>439</h3>

434 440 

435マーケットプレイス `url` ソースの `headersHelper` を、マーケットプレイスが公開するカタログではなく、[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) エントリなどの設定ファイルで宣言します。Claude Code はそれぞれのインストールまたは更新でユーザーに受け入れるよう求めません。代わりに、それを宣言する設定ファイルが Claude Code がそれを実行するときを決定します:441マーケットプレイスの `url` ソースの `headersHelper` は、マーケットプレイスが公開するカタログではなく、[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) エントリなどの設定ファイルで宣言します。そのため、Claude Code はインストールや更新のたびにユーザーに受け入れを求めることはありません。代わりに、それを宣言している設定ファイルによって、Claude Code がいつ実行するかが決まります。

436 442 

437| 設定ファイル | Claude Code がコマンドを実行するとき |443| 設定ファイル | Claude Code がコマンドを実行するタイミング |

438| :- | :- |444| :- | :- |

439| ユーザー設定、`--settings` ファイル、またはマシン上の管理設定ファイル | 尋ねずに、バックグラウンドマーケットプレイス更新を含む |445| ユーザー設定、`--settings` ファイル、またはマシン上の管理設定ファイル | 確認なしで実行します。バックグラウンドでのマーケットプレイスの更新中も含みます |

440| プロジェクトの `.claude/settings.json` または `.claude/settings.local.json` | ユーザーがそのフォルダ自体の[ワークスペーストラストダイアログ](/docs/ja/permissions#what-runs-before-you-trust-a-folder)を受け入れた後のみ。`-p` または SDK セッションはそれを受け入れるとしてカウントされず、親フォルダに付与された信頼もカウントされません |446| プロジェクトの `.claude/settings.json` または `.claude/settings.local.json` | ユーザーがそのフォルダ自体について[ワークスペースの信頼ダイアログ](/docs/ja/permissions#what-runs-before-you-trust-a-folder)を受け入れた後にのみ実行します。`-p` や SDK のセッションは受け入れとはみなされず、親フォルダに付与された信頼も同様です |

441| サーバー管理設定 | 対話的なセッションでは、ユーザーが[セキュリティ承認ダイアログ](/docs/ja/server-managed-settings#security-approval-dialogs)で配信された設定を承認した後のみ |447| サーバー管理設定 | 対話型セッションで、ユーザーが[セキュリティ承認ダイアログ](/docs/ja/server-managed-settings#security-approval-dialogs)で配信された設定を承認した後にのみ実行します |

442 448 

443これらのファイルの 1 つの[インラインプラグインエントリ](/docs/ja/settings-reference#extraknownmarketplaces)の場合、Claude Code はそのファイルのマーケットプレイスレベルのコマンドと同じフォルダ信頼または設定承認を要求し、ユーザーはまたそれぞれのインストールまたは更新でエントリのコマンドを受け入れます。449これらのファイル内の[インラインプラグインエントリ](/docs/ja/settings-reference#extraknownmarketplaces)については、Claude Code はそのファイル内のマーケットプレイスレベルのコマンドと同じフォルダの信頼または設定の承認を必要とし、さらにユーザーはインストールまたは更新のたびにエントリのコマンドを受け入れます。

444 450 

445<h2 id="depend-on-and-recommend-other-plugins">451<h2 id="depend-on-and-recommend-other-plugins">

446 他のプラグインに依存し、推奨する452 他のプラグインに依存し、推奨する

Details

189 189 

190* **Scope**: デフォルトではユーザースコープ。`--scope project` または `--scope local` を渡して変更します。190* **Scope**: デフォルトではユーザースコープ。`--scope project` または `--scope local` を渡して変更します。

191* **プラグインが読み込まれるとき**: インストールするプラグインは、Claude Code を次に開始するときか、既に開いているセッションで `/reload-plugins` を実行するときに読み込まれます。191* **プラグインが読み込まれるとき**: インストールするプラグインは、Claude Code を次に開始するときか、既に開いているセッションで `/reload-plugins` を実行するときに読み込まれます。

192* **マーケットプレイスは最初に追加する必要があります**: 誰も対話的な Claude Code セッションを開いていないマシンでは、公式マーケットプレイスが登録されていないため、そこからインストールするスクリプトは、インストール前に `claude plugin marketplace add anthropics/claude-plugins-official` を実行します。192* **新しいマシンでのマーケットプレイス**: まだ誰も対話的な Claude Code セッションを開いていないマシンでは、公式マーケットプレイスが登録されていないため、そこからインストールするスクリプトは、インストール前に `claude plugin marketplace add anthropics/claude-plugins-official` を実行します。[シェルから追加してインストールする](#add-and-install-from-your-shell)を参照してください。

193 193 

194```bash theme={null}194```bash theme={null}

195claude plugin install formatter@your-org --scope project195claude plugin install formatter@your-org --scope project


232 マーケットプレイスを追加してインストール(1 つのコマンド)232 マーケットプレイスを追加してインストール(1 つのコマンド)

233</h3>233</h3>

234 234 

235まだ追加していないマーケットプレイスからプラグインをインストールするには、Claude Code セッション内で `/plugin install` を実行し、`--marketplace` でマーケットプレイスソースを指定します。Claude Code v2.1.275 以降が必要です。235まだ追加していないマーケットプレイスからプラグインをインストールするには、セッション内またはシェルから、インストールコマンドで `--marketplace` を使ってマーケットプレイスのソースを指定します。ソースは [`/plugin marketplace add` と同じ形式](#add-a-marketplace)を取ります。例えば、GitHub `owner/repo`、git URL、またはローカルパスです。プラグイン名は `@marketplace` サフィックスなしで単独で指定します。

236 

237<h4 id="add-and-install-in-a-session">

238 セッション内で追加してインストールする

239</h4>

240 

241Claude Code セッション内で、プラグインとソースを指定して `/plugin install` を実行します。Claude Code v2.1.275 以降が必要です。セッション内では、ソースにスペースを含めることはできません。

236 242 

237```text theme={null}243```text theme={null}

238/plugin install deploy-helper --marketplace your-org/plugins244/plugin install deploy-helper --marketplace your-org/plugins

239```245```

240 246 

241ソースは [/plugin marketplace add](#add-a-marketplace) と同じ形式を取ります。例えば、GitHub `owner/repo`、git URL、またはローカルパス。ただし、スペースを含むことはできません。プラグイン名を `@marketplace` サフィックスなしで指定します。

242 

243そのマーケットプレイスをまだ追加していない場合、Claude Code は解決したソースを表示し、追加する前に確認するよう求めます。マーケットプレイスが追加されると、プラグインの詳細が開き、[インストール範囲](#install-a-plugin)を選択します。ソースが既に追加したマーケットプレイスと一致する場合、Claude Code は確認をスキップし、そのマーケットプレイスでプラグインの詳細を開きます。247そのマーケットプレイスをまだ追加していない場合、Claude Code は解決したソースを表示し、追加する前に確認するよう求めます。マーケットプレイスが追加されると、プラグインの詳細が開き、[インストール範囲](#install-a-plugin)を選択します。ソースが既に追加したマーケットプレイスと一致する場合、Claude Code は確認をスキップし、そのマーケットプレイスでプラグインの詳細を開きます。

244 248 

249<h4 id="add-and-install-from-your-shell">

250 シェルから追加してインストールする

251</h4>

252 

253シェルで、セッションを開始せずに、プラグインとソースを指定して `claude plugin install` を実行します。Claude Code v2.1.292 以降が必要です。

254 

255```bash theme={null}

256claude plugin install deploy-helper --marketplace your-org/plugins

257```

258 

259シェルコマンドは確認ステップなしでマーケットプレイスを追加します。そのソースから既に追加したマーケットプレイスは再利用されます。新しいマーケットプレイスは `claude plugin marketplace add` と同じ[組織ポリシーチェック](/docs/ja/plugins/org#restrict-what-users-can-install)のもとで追加され、`--scope project` を渡した場合でもユーザー設定で宣言されます。

260 

261そのマーケットプレイスをまだ追加していない場合、コマンドは `Successfully added marketplace: <name> (declared in user settings)` を出力してから、[プラグインをインストールします](#install-from-your-shell)。

262 

245<h3 id="add-a-private-marketplace">263<h3 id="add-a-private-marketplace">

246 プライベートマーケットプレイスを追加する264 プライベートマーケットプレイスを追加する

247</h3>265</h3>

Details

185| `official-claude-tools` など、`official` を `claude` または `anthropic` の隣に配置する | エラー |185| `official-claude-tools` など、`official` を `claude` または `anthropic` の隣に配置する | エラー |

186| `mcp-for-claude` など、`claude`、`anthropic`、または `anthropics` を全単語として他の場所に持つ | 警告 |186| `mcp-for-claude` など、`claude`、`anthropic`、または `anthropics` を全単語として他の場所に持つ | 警告 |

187 187 

188エラーは `Plugin name "<name>" is reserved: it passes as one of Anthropic's own` と読み、警告は `Plugin name "<name>" reads as one of Anthropic's own` と読みます。`claude plugin init` と `claude plugin tag` はエラーを引き出す名前を拒否します。これらのコマンドのみが名前をチェックします。Claude Code は、拒否する名前を持つプラグインをインストールして読み込みます。188エラーは `Plugin name "<name>" is reserved: it passes as one of Anthropic's own` と読み、警告は `Plugin name "<name>" reads as one of Anthropic's own` と読みます。`claude plugin init` と `claude plugin tag` はエラーとなる名前を拒否します。これらのコマンドが拒否する名前のプラグインであっても、Claude Code はインストールして読み込みます。

189 189 

190<h3 id="displayname">190<h3 id="displayname">

191 `displayName`191 `displayName`

Details

64 64 

65| フィールド | 型 | 説明 |65| フィールド | 型 | 説明 |

66| :- | :- | :- |66| :- | :- | :- |

67| `name` | string | マーケットプレイス識別子。文字、数字、`.`、`_`、`-` で構成され、文字または数字で始まり、`..` がありません。それ以外の名前を使用するマーケットプレイスからは Claude Code がプラグインをインストールできないため、`claude plugin validate` はそれ以外の名前では失敗します。ユーザーはプラグインをインストールする際、`my-plugin@my-marketplace` のような [プラグイン ID](/docs/ja/plugins/loading#find-where-a-plugin-came-from) の `@` の後にこの名前を入力します。[予約名](#reserved-names) を参照してください |67| `name` | string | マーケットプレイス識別子。文字、数字、`.`、`_`、`-` で構成され、文字または数字で始まり、`..` がありません。Claude Code は[それ以外の名前を使用するマーケットプレイスからプラグインをインストールできない](/docs/ja/plugins/troubleshooting#cannot-install-plugins-from-a-marketplace-with-this-name)ため、`claude plugin validate` はそれ以外の名前では失敗します。ユーザーはプラグインをインストールする際、`my-plugin@my-marketplace` のような [プラグイン ID](/docs/ja/plugins/loading#find-where-a-plugin-came-from) の `@` の後にこの名前を入力します。[予約名](#reserved-names) を参照してください |

68| `owner` | object | 管理者情報。`name` は必須。`email` および `url` はオプション |68| `owner` | object | 管理者情報。`name` は必須。`email` および `url` はオプション |

69| `plugins` | array | [プラグインエントリ](#plugin-entries)。各エントリは独立して検証されるため、1 つの無効なエントリがマーケットプレイスを失敗させません |69| `plugins` | array | [プラグインエントリ](#plugin-entries)。各エントリは独立して検証されるため、1 つの無効なエントリがマーケットプレイスを失敗させません |

70| `$schema` | string | エディタオートコンプリート用の JSON Schema URL。読み込み時に無視されます |70| `$schema` | string | エディタオートコンプリート用の JSON Schema URL。読み込み時に無視されます |

Details

138| `$.mcp.call` | 接続された MCP サーバーのツールを呼び出し、セッションの権限ルールの下で実行します |138| `$.mcp.call` | 接続された MCP サーバーのツールを呼び出し、セッションの権限ルールの下で実行します |

139| `$.model.complete` | ユーザーのプランまたは API キーをモデル呼び出しに使用します |139| `$.model.complete` | ユーザーのプランまたは API キーをモデル呼び出しに使用します |

140| `$.prompt.submit` | プロンプトを送信し、ユーザー独自の言葉として送信できます |140| `$.prompt.submit` | プロンプトを送信し、ユーザー独自の言葉として送信できます |

141| `$.session.send` | 別のセッションまたはサブエージェントの Claude が読む メッセージを送信します |141| `$.session.send` | 別のセッション、サブエージェント、または [チームメイト](/docs/ja/agent-teams) の Claude が読むメッセージを送信します |

142 142 

143`hooks:` 行では、[`tool.call`](/docs/ja/plugins/mods/reference#tools) と [`prompt.submit`](/docs/ja/plugins/mods/reference#prompts-and-what-claude-reads) は mod がすべてのツール呼び出しとすべてのプロンプトを見ることができ、それらを変更できることを意味しています。[`session.append`](/docs/ja/plugins/mods/reference#session) は mod が保存される前に会話の各行を書き直すことができることを意味しています。[`ui.render{component=AskUserQuestion}`](/docs/ja/plugins/mods/interface#change-what-claude-code-already-draws) は mod が Claude がユーザーに質問するために使用するダイアログを再描画できることを意味しています。`tool.check` は mod が権限プロンプトが表示される前にツール呼び出しを承認または拒否できることを意味しています。[デフォルトで何が起こるかを理解する](#know-what-happens-by-default) は、その答えに優先する規則とフックを一覧表示しています。143`hooks:` 行では、[`tool.call`](/docs/ja/plugins/mods/reference#tools) と [`prompt.submit`](/docs/ja/plugins/mods/reference#prompts-and-what-claude-reads) は mod がすべてのツール呼び出しとすべてのプロンプトを見ることができ、それらを変更できることを意味しています。[`session.append`](/docs/ja/plugins/mods/reference#session) は mod が保存される前に会話の各行を書き直すことができることを意味しています。[`ui.render{component=AskUserQuestion}`](/docs/ja/plugins/mods/interface#change-what-claude-code-already-draws) は mod が Claude がユーザーに質問するために使用するダイアログを再描画できることを意味しています。`tool.check` は mod が権限プロンプトが表示される前にツール呼び出しを承認または拒否できることを意味しています。[デフォルトで何が起こるかを理解する](#know-what-happens-by-default) は、その答えに優先する規則とフックを一覧表示しています。

144 144 

Details

79 モデルを呼び出す79 モデルを呼び出す

80</h2>80</h2>

81 81 

82mod は、テキストの並べ替えや要約などの小さなジョブのために、会話の外で独自にモデルに質問を尋ねることができます。`$.model.complete` はセッションの認証情報を使用して 1 つのプロンプトをモデルに送信し、返信に解決します。会話履歴はありません。82mod は、テキストの分類や要約などの小さなジョブのために、独自のリクエストをモデルに送信できます。`$.model.complete` はプロンプトを単独で送信し、`$.model.fork({ prompt })` は現在の会話の末尾にプロンプトを付けて送信します。

83 

84次の表は、それぞれのリクエストに含まれる内容を比較したものです。

85 

86| リクエストの内容 | `$.model.complete` | `$.model.fork` |

87| :- | :- | :- |

88| モデル | 渡した `model` | セッションのモデル |

89| システムプロンプト | 短い[帰属ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block)、続いて `system` を渡した場合はその内容 | セッションのシステムプロンプト |

90| メッセージ | 1 つのユーザーメッセージ(渡した `prompt`) | これまでの会話、続いてユーザーメッセージとしての `prompt` |

91| CLAUDE.md およびその他のプロジェクトコンテキスト | 含まれない | 会話の最後のリクエストと同様に含まれる |

92| ツール | なし | Claude のツール(モデルは呼び出せない) |

93 

94フォークは会話の最後のリクエストを繰り返すため、会話がまだキャッシュされている間は、Claude API はその大部分を[プロンプトキャッシュ](/docs/ja/prompt-caching)から提供します。

95 

96どちらの呼び出しもセッションの認証情報を使用するため、ユーザーのプラン、API キー、またはクラウドプロバイダーに課金されます。[ビルド用の型](/docs/ja/plugins/mods/create#get-the-types-for-your-build)には、すべての `$.model` メソッドが記載されています。

97 

98<h3 id="send-one-prompt">

99 1 つのプロンプトを送信する

100</h3>

101 

102`$.model.complete` に `model` と `prompt` を渡します。`prompt` はユーザーメッセージになります。役割や出力形式などの指示をモデルに与えるには、`system` も渡します。これはシステムプロンプトになります。

83 103 

84このフックは、[コマンドとして登録された](#add-a-command) `/triage` コマンドに答え、小さなモデルに、その後に入力されたテキストにラベルを付けるよう尋ねます。104このフックは、[コマンドとして登録された](#add-a-command) `/triage` コマンドに答え、小さなモデルに、その後に入力されたテキストにラベルを付けるよう尋ねます。

85 105 


100})120})

101```121```

102 122 

103`/triage the export button does nothing` を実行すると、mod はそのテキストをモデルに送信し、その答え(`Label: bug` など)を出力します。Claude の会話は要求の一部ではありません。モデルが応答しない場合、ラベルは `unknown` です。123`/triage the export button does nothing` を実行すると、mod はそのテキストをモデルに送信し、その答え(`Label: bug` など)を出力します。モデルが応答しない場合、ラベルは `unknown` です。

124 

125Claude API の失敗は呼び出しを拒否しないため、`r.isAnswered` をチェックし、それが `false` の場合は `r.reason` を読んでください。呼び出しは、Claude Code が送信しないリクエスト(組織がブロックするモデルなど)に対して拒否されます。

126 

127[ビルド用の型](/docs/ja/plugins/mods/create#get-the-types-for-your-build)には `effort` などの他のオプションが記載されており、[制限](/docs/ja/plugins/mods/reference#limits)には `maxTokens` のデフォルトが示されています。

128 

129<h3 id="use-prompt-caching">

130 プロンプトキャッシュを使用する

131</h3>

132 

133`$.model.complete` は Claude API の[プロンプトキャッシュ](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)をサポートしています。API は、リクエストの先頭部分(プレフィックスと呼ばれます)を、設定した[キャッシュブレークポイント](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#explicit-cache-breakpoints)までキャッシュします。すべての呼び出しが、指示や参考資料などの同じ長い静的コンテンツで始まる場合は、そのコンテンツの末尾にブレークポイントを設定します。以降の呼び出しでは、その部分に対して入力の全額を支払う代わりに、キャッシュから読み取ります。

134 

135ブレークポイントを設定するには、`prompt` を文字列ではなく `{ text }` ブロックの配列として渡し、静的コンテンツの最後のブロックに `cache: true` を追加します。Claude Code はそのブロックを API の `cache_control` フィールド付きで送信します。`system` も同じ配列形式を受け付けます。どちらを使うかの判断については、[`prompt` と `system` のどちらを使うか選ぶ](#choose-between-prompt-and-system)を参照してください。

136 

137<Note>

138 ブロックの配列には Claude Code v2.1.292 以降が必要です。それより前のバージョンでは、`prompt` 内の配列は `takes { model, prompt } (host check)` で終わるエラーで拒否され、`system` 内の配列はリクエストから除外されます。

139</Note>

140 

141このバージョンの [`/triage` フック](#send-one-prompt)は、ラベル付けするテキストの前に長いラベル付けルールを送信し、ルールの後にブレークポイントを置きます。`RULES` は独自に用意する文字列です。

142 

143```javascript theme={null}

144on('command.run', { command: 'triage' }, async ($, e) => {

145 const r = await $.model.complete({

146 model: 'haiku',

147 prompt: [

148 // すべての呼び出しで同一なので、キャッシュされるプレフィックスになる

149 { text: RULES, cache: true },

150 // 呼び出しごとに変わるので、ブレークポイントの後に置く

151 { text: e.args },

152 ],

153 })

154 return { text: 'Label: ' + (r.isAnswered ? r.text.trim() : 'unknown') }

155})

156```

157 

158TTL とブレークポイントの数には次の制限があります。

159 

160* **TTL**: キャッシュエントリは最後に使用されてから 5 分間保持されます。TTL は呼び出しではなく、ユーザーの Claude Code 設定によって決まります。1 時間にするには、[`subagentPromptCacheTtl`](/docs/ja/prompt-caching#choose-the-ttl-yourself) を `1h` に設定します。

161* **リクエストあたりのブレークポイント数**: API は[最大 4 つ](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#when-to-use-multiple-breakpoints)まで受け付け、それを超えると `r.reason` に `api-error` が返されます

162 

163<h4 id="choose-between-prompt-and-system">

164 `prompt` と `system` のどちらを使うか選ぶ

165</h4>

166 

167リクエストが Claude API に直接送られることがわかっている場合を除き、呼び出し間で共有する静的コンテンツは `prompt` の先頭に置いてください。

168 

169* **API キーまたは Claude のサブスクリプションで Claude API に直接送る場合**: どちらのフィールドでも機能します

170* **[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、または [LLM ゲートウェイ](/docs/ja/llm-gateway)を経由する場合**: `prompt` を使用します。Claude Code はシステムプロンプトの先頭に[帰属ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block)を置き、そのフィンガープリントはユーザーメッセージの先頭から生成されます。`api.anthropic.com` エンドポイントはキャッシュの前にそのブロックを取り除きます。その他のエンドポイントはそれをプロンプトの一部として受け取るため、`prompt` の先頭が異なると `system` 内のブレークポイントがヒットしないことがあります。

171* **他の人が実行する mod の場合**: `prompt` を使用します。相手のプロバイダーは選べないためです

172 

173プレフィックスでは `system` が `prompt` より前に来るため、`prompt` 内のブレークポイントは `system` もカバーし、`system` が異なる呼び出しはキャッシュにヒットしません。

104 174 

105Claude API の失敗は呼び出しを拒否しないため、`r.isAnswered` をチェックし、それが `false` の場合は `r.reason` を読んでください。呼び出しは、Claude Code が送信しないリクエスト(組織がブロックするモデルなど)に対して拒否されます。[ビルド用の型](/docs/ja/plugins/mods/create#get-the-types-for-your-build) は、`effort` などの他のオプションをリストし、[制限](/docs/ja/plugins/mods/reference#limits) は `maxTokens` のデフォルトを示します。175<h4 id="check-for-cache-hits">

176 キャッシュヒットを確認する

177</h4>

106 178 

107`$.model.fork({ prompt })` は、代わりに現在の会話に 1 つの質問を尋ね、同じモデルとシステムプロンプトを使用するため、Claude API はプロンプトキャッシュからほとんどを提供します。179`$.model.complete` の結果には、API の[キャッシュフィールド](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#tracking-cache-performance)を含む `usage` オブジェクトがあります。`usage.cache_creation_input_tokens` は呼び出しがキャッシュに書き込んだトークン数を、`usage.cache_read_input_tokens` はキャッシュから読み取ったトークン数を数えます。最初の呼び出しでは書き込みが発生し、TTL 内の以降の呼び出しでは読み取りが発生するはずです。

108 180 

109これらの呼び出しはユーザーのプランまたは API キーを使用します。181すべての呼び出しで書き込みが発生し読み取りがない場合は、呼び出し間でプレフィックスが異なっているか、呼び出しの間隔が TTL より長くなっています。プレフィックスが異なる場合については、[`prompt` と `system` のどちらを使うか選ぶ](#choose-between-prompt-and-system)を参照してください。

182 

183モデルが応答した呼び出しで両方のフィールドがゼロのままの場合は、何もキャッシュされていません。次の各原因を確認してください。

184 

185* **プレフィックスが短すぎる**: API はモデルの[最小長](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#cache-limitations)未満のプレフィックスをキャッシュせず、エラーも返しません

186* **プロンプトキャッシュが無効になっている**: [`DISABLE_PROMPT_CACHING` 変数](/docs/ja/prompt-caching#disable-prompt-caching)がそのモデルに適用されている場合、Claude Code はブレークポイントを削除し、テキストをキャッシュなしで送信します

187* **ゲートウェイが `cache_control` を取り除いている**: ゲートウェイは[フィールドを削除しても成功を返す](/docs/ja/prompt-caching#where-the-cache-lives)ことがあります

188* **別の mod がテキストの先頭を書き換えている**: その場合、Claude Code は[ブレークポイントなしで送信します](#what-a-model-complete-hook-receives)

189 

190<h3 id="what-a-model-complete-hook-receives">

191 `model.complete` フックが受け取るもの

192</h3>

193 

194[`model.complete`](/docs/ja/plugins/mods/reference#mods-api-calls) イベントをフックして他の mod のリクエストを検査または変更する場合は、次のフィールドからテキストを読み取ります。

195 

196* **`e.prompt`**: 常に文字列です。呼び出し元が配列を渡した場合は、ブロックのテキストを順に連結したものです。

197* **`e.system`**: 同じ方法で構築された文字列です。呼び出し元が `system` を渡さなかった場合は存在しません

198* **`e.promptBlocks` と `e.systemBlocks`**: 呼び出し元の配列です。それぞれ、呼び出し元がそのフィールドに配列を渡した場合に存在します

199 

200Claude Code は、フックが `next` に渡した文字列を送信し、それと一緒に渡された配列を使用して[キャッシュブレークポイント](#use-prompt-caching)を配置します。文字列の先頭とまだ一致している先頭のブロックはブレークポイントとともに保持し、文字列の残りはブレークポイントなしで送信します。たとえば、`next({ ...e, prompt: e.prompt + NOTE })` は呼び出し元のブレークポイントを保持し、`prompt` の先頭を変更するフックはそれらを削除します。

110 201 

111<h2 id="run-work-in-the-background">202<h2 id="run-work-in-the-background">

112 バックグラウンドで作業を実行する203 バックグラウンドで作業を実行する


140| 呼び出し | ユーザーが見るもの |231| 呼び出し | ユーザーが見るもの |

141| :- | :- |232| :- | :- |

142| `$.ui.status(text)` | プロンプトの下の 1 行で、変更するまで残ります。`⚠` と mod の名前で始まります。`⚠ my-mod: checks: 3 passing` など。 |233| `$.ui.status(text)` | プロンプトの下の 1 行で、変更するまで残ります。`⚠` と mod の名前で始まります。`⚠ my-mod: checks: 3 passing` など。 |

143| `$.ui.toast(text)` | 右上に表示されるトースト通知で、mod の名前がテキストの上にあり、数秒後に消えます |234| `$.ui.toast(text)` | mod の名前を含むトースト通知で、数秒後に消えます。[フルスクリーンレンダリング](/docs/ja/fullscreen)では右上のボックスとして、クラシックレンダラーではプロンプトの下の右側に 1 行で表示されます。 |

144| `$.ui.log(text)` | Claude が読まない、トランスクリプト内の薄い行。`●` と mod の名前で始まります。`● my-mod: build finished` など。 |235| `$.ui.log(text)` | Claude が読まない、トランスクリプト内の薄い行。`●` と mod の名前で始まります。`● my-mod: build finished` など。 |

145 236 

146<h3 id="start-a-turn-from-a-background-job">237<h3 id="start-a-turn-from-a-background-job">


159 セッション間でメッセージを送受信する250 セッション間でメッセージを送受信する

160</h2>251</h2>

161 252 

162mod は、別のセッションまたはこのセッションのサブエージェントの 1 つにプレーンテキストメッセージを送信し、到着して離れるメッセージを観察できます。`$.session.send({ to, text })` は 1 つを送信し、SendMessage ツールが行う配信と同じです。`to` は、セッションの場合は `{ sessionId }`、`$.agent.list()` からのサブエージェントの場合は `{ agentId }`、または受信したメッセージが来たアドレスです。呼び出しはメッセージがキューに入ったら解決し、`{ isDelivered: true }` で解決します。何も配信されなかった場合、`{ isDelivered: false, reason }` で解決し、`reason` は理由を述べます。253mod は、自分の別のセッション、このセッションのサブエージェントの 1 つ、またはその[エージェントチーム](/docs/ja/agent-teams)のチームメイトにプレーンテキストメッセージを送信できます。また、到着して離れるメッセージを観察することもできます。

254 

255メッセージを送信するには、`$.session.send({ to, text })` を呼び出します。これは SendMessage ツールが行う配信と同じです。`to` は受信者に応じて設定します。

256 

257* **自分の別のセッション**: `{ sessionId }`

258* **サブエージェントまたはチームメイト**: `{ agentId }`(`$.agent.list()` から取得した ID を使用)

259* **受信したメッセージの送信者**: そのメッセージの送信元の文字列アドレス

260 

261呼び出しはメッセージがキューに入ったら解決し、`{ isDelivered: true }` で解決します。何も配信されなかった場合、`{ isDelivered: false, reason }` で解決し、`reason` は理由を述べます。

163 262 

164このフックは、[コマンドとして登録された](#add-a-command) `/ping` コマンドに答え、その後に入力したセッション ID のセッションにステータスを尋ねます。263このフックは、[コマンドとして登録された](#add-a-command) `/ping` コマンドに答え、その後に入力したセッション ID のセッションにステータスを尋ねます。

165 264 

Details

281 バージョンの型定義を取得する281 バージョンの型定義を取得する

282</h3>282</h3>

283 283 

284Claude Code が `--plugin-dir` に渡すディレクトリから mod をロードまたは再ロードするたびに、または [Claude が書いた](#ask-claude-for-a-mod) mod の場合、TypeScript 宣言ファイル(`.d.ts` で終わる)を mod のディレクトリ内の `.claude-plugin/types/` に書き込みます。実行している Claude Code バージョンの正確なイベント、mods API メソッド、および要素について説明しているため、エディターは hook を自動補完および型チェックできます。宣言をオンラインで参照するには、Claude Code リポジトリの [`mods/types/claude-code.d.ts`](https://github.com/anthropics/claude-code/blob/main/mods/types/claude-code.d.ts) を読んでください。その最初の行は、それを書いたバージョンに名前を付けます。ディレクトリには次のファイルが含まれます。284Claude Code が対話型セッションで `--plugin-dir` から mod をロードするとき、または [Claude が書いた](#ask-claude-for-a-mod) mod をロードするとき、TypeScript 宣言ファイルを mod の `.claude-plugin/types/` ディレクトリに書き込みます。これらのファイルは実行している Claude Code バージョンの正確なイベント、mods API メソッド、および要素について説明しているため、エディターはフックを自動補完および型チェックできます。ディレクトリには次のファイルが含まれます。

285 285 

286| パス | 宣言内容 |286| パス | 宣言内容 |

287| :- | :- |287| :- | :- |

Details

145 145 

146Claude が `.mdx` ファイルを編集または書き込んだ後、トランスクリプトの薄い色の行にそのファイル名が表示されます。別の種類のファイルの場合や、拒否または失敗した呼び出しの場合は何も記録されません。フックは受け取った結果をそのまま返すため、Claude から見た呼び出しの内容は変わりません。146Claude が `.mdx` ファイルを編集または書き込んだ後、トランスクリプトの薄い色の行にそのファイル名が表示されます。別の種類のファイルの場合や、拒否または失敗した呼び出しの場合は何も記録されません。フックは受け取った結果をそのまま返すため、Claude から見た呼び出しの内容は変わりません。

147 147 

148呼び出しを変更するには、変更した引数を `next` に渡します。呼び出しを再試行するには、`next(e)` をもう一度呼び出します。最初の結果で `isError` を確認したフックは、ツールをもう一度実行してその結果を返すことができます。呼び出しに自分で応答するには、`next` を呼び出さずに `result` フィールドを持つオブジェクト(例えば `{ result: 'Skipped by my-mod' }`)を返します。この場合、権限プロンプトは表示されずツールも実行されないため、返した結果が、何が起きたかについて Claude が知るすべてになります。148フックは、呼び出しを変更したり、再試行したり、自分で応答したり、その結果を保留したりすることもできます:

149 

150* **呼び出しを変更する**:変更した引数を `next` に渡します。

151* **呼び出しを再試行する**:`next(e)` をもう一度呼び出します。最初の結果で `isError` を確認したフックは、ツールをもう一度実行してその結果を返すことができます。

152* **呼び出しに自分で応答する**:`next` を呼び出さずに `result` フィールドを持つオブジェクトを返します。組み込みツールの場合は、[使用しているビルドの型](/docs/ja/plugins/mods/create#get-the-types-for-your-build)でそのツール自身の結果が持つ形を `result` に与えてください。権限プロンプトは表示されずツールも実行されないため、返した結果が、何が起きたかについて Claude が知るすべてになります。

153* **結果を Claude に渡さない**:`await next(e)` の後に `{ deny: reason }` を返します。Claude は `next` が返したものの代わりに、指定した理由を読みます。ツールが実行された場合、deny はその結果を Claude に渡さないようにするだけで、ツールが行った処理は何も元に戻しません。ツールが実行されて成功した場合、理由は `Bash ran, and a plugin withheld its result:` のような注記の後に続きます。

149 154 

150組織の[管理設定](/docs/ja/server-managed-settings)にあるフックは、どの mod の `tool.call` フックよりも先に実行され、それらによるブロックは最終的なものです。155組織の[管理設定](/docs/ja/server-managed-settings)にあるフックは、どの mod の `tool.call` フックよりも先に実行され、それらによるブロックは最終的なものです。

151 156 


225 230 

226| 目的 | 返す値 |231| 目的 | 返す値 |

227| :- | :- |232| :- | :- |

228| プロンプトを書き換える。トランスクリプトのメッセージには新しいテキストが表示されます。 | `next({ ...e, text: newText })` |233| プロンプトを書き換える。トランスクリプトと[プロンプト履歴](/docs/ja/interactive-mode#command-history)には新しいテキストが表示されます。 | `next({ ...e, text: newText })` |

229| Claude だけが読むテキストをプロンプトの後に追加する | `next({ ...e, context: [...(e.context ?? []), extraText] })` |234| Claude だけが読むテキストをプロンプトの後に追加する | `next({ ...e, context: [...(e.context ?? []), extraText] })` |

230| プロンプトの送信を止める | `{ drop: 'the reason' }` |235| プロンプトの送信を止める | `{ drop: 'the reason' }` |

231 236 


245 250 

246`open a PR for this change` などのプロンプトを送信すると、トランスクリプト上のメッセージは変わらず、Claude はその後に `Current branch: feature/auth` のような行も読みます。プルリクエストに言及しないプロンプトは変更されずに送信され、`git` は実行されません。251`open a PR for this change` などのプロンプトを送信すると、トランスクリプト上のメッセージは変わらず、Claude はその後に `Current branch: feature/auth` のような行も読みます。プルリクエストに言及しないプロンプトは変更されずに送信され、`git` は実行されません。

247 252 

248プロンプトを止めるには、`next` を呼び出さずに `{ drop: 'the reason' }` を返します。フックの `next(e)` 呼び出しでプロンプトを通過させた後に `drop` を返した場合、ターンはそのまま実行され、フックは `a drop after its next() was answered` を含むメッセージとともに[失敗](#handle-a-hook-that-fails)します。253プロンプトを止めるには、`next` を呼び出さずに `{ drop: 'the reason' }` を返します。テキストはユーザーのプロンプト入力欄に戻り、ユーザーには `Prompt dropped by a hook:` に続けて理由が表示されるため、理由はユーザーに向けて書いてください。フックの `next(e)` 呼び出しでプロンプトを通過させた後に `drop` を返した場合、ターンはそのまま実行され、フックは `a drop after its next() was answered` を含むメッセージとともに[失敗](#handle-a-hook-that-fails)します。

249 254 

250Claude が読むその他の内容は[他のイベント](/docs/ja/plugins/mods/reference#prompts-and-what-claude-reads)で扱います。システムプロンプトの各セクションには `prompt.section`、最初のメッセージとともに送信されるコンテキストには `prompt.context`、スキルのテキストには `skill.prompt` を使用します。これらのフックからのテキストがリクエストごとに変わると、[プロンプトキャッシュが無効化されます](/docs/ja/prompt-caching)。255Claude が読むその他の内容は[他のイベント](/docs/ja/plugins/mods/reference#prompts-and-what-claude-reads)で扱います。システムプロンプトの各セクションには `prompt.section`、最初のメッセージとともに送信されるコンテキストには `prompt.context`、スキルのテキストには `skill.prompt` を使用します。これらのフックからのテキストがリクエストごとに変わると、[プロンプトキャッシュが無効化されます](/docs/ja/prompt-caching)。

251 256 


281 286 

282`result.usage` は、Claude API がリクエストについて報告するトークン数(`input_tokens`、`output_tokens`、`cache_read_input_tokens`、`cache_creation_input_tokens`)と、応答した `model` を保持します。フックはサブエージェントのリクエストでも実行されるため、メインの会話だけを対象にしたい場合は `e.agentId` を確認してください。287`result.usage` は、Claude API がリクエストについて報告するトークン数(`input_tokens`、`output_tokens`、`cache_read_input_tokens`、`cache_creation_input_tokens`)と、応答した `model` を保持します。フックはサブエージェントのリクエストでも実行されるため、メインの会話だけを対象にしたい場合は `e.agentId` を確認してください。

283 288 

289リクエスト中に API 自身が実行したツール呼び出し([advisor ツール](/docs/ja/advisor)への呼び出しなど)を確認するには、`result.serverToolUses` を読み取ります。Claude Code はこれらの呼び出しを実行しないため、これらに対して `tool.call` フックや `tool.check` フックは発火しません。レスポンスにそのような呼び出しが含まれない場合、このフィールドは存在しません。また、このフィールドには Claude Code v2.1.290 以降が必要です。

290 

284<h3 id="hook-the-settings-hook-events">291<h3 id="hook-the-settings-hook-events">

285 設定フックのイベントを処理する292 設定フックのイベントを処理する

286</h3>293</h3>


369* **`tool.check`**:`{ decision: 'deny', reason: 'the reason' }` を返します376* **`tool.check`**:`{ decision: 'deny', reason: 'the reason' }` を返します

370* **`plugin.register`**:[チェックが失敗したときに mod を拒否する](/docs/ja/plugins/mods/admin#refuse-mods-when-your-check-fails)で示しているように、`{ refuse: 'the reason' }` を返します377* **`plugin.register`**:[チェックが失敗したときに mod を拒否する](/docs/ja/plugins/mods/admin#refuse-mods-when-your-check-fails)で示しているように、`{ refuse: 'the reason' }` を返します

371 378 

379`tool.call` では、`next` が解決した後に返された `deny` は[結果を Claude に渡さずに保留します](#guard-or-change-a-tool-call)。

380 

372<h2 id="next-steps">381<h2 id="next-steps">

373 次のステップ382 次のステップ

374</h2>383</h2>

Details

10 10 

11次の図は、ターミナルセッション内で mod が描画できる場所を示しています。11次の図は、ターミナルセッション内で mod が描画できる場所を示しています。

12 12 

13<img src="https://mintcdn.com/claude-code/dgiVO_Od1X1faduV/images/mods-screen-map.svg?fit=max&auto=format&n=dgiVO_Od1X1faduV&q=85&s=5fda26b6609c62b68c6f9e528c1590ea" className="dark:hidden" alt="Claude Code のターミナルセッションの図。mod は、右側のサイドバーとしてのペイン、トランスクリプト右上のトースト、トランスクリプト内のログ行、プロンプト上部の帯、プロンプト下のステータスラインを追加できます。mod はメッセージ、ツール呼び出しの行、スピナーを再描画できます。プロンプトは Claude Code 自身のものです。" width="600" height="336" data-path="images/mods-screen-map.svg" />13<img src="https://mintcdn.com/claude-code/dgiVO_Od1X1faduV/images/mods-screen-map.svg?fit=max&auto=format&n=dgiVO_Od1X1faduV&q=85&s=5fda26b6609c62b68c6f9e528c1590ea" className="dark:hidden" alt="フルスクリーン描画での Claude Code のターミナルセッションの図。mod は、右側のサイドバーとしてのペイン、トランスクリプト右上のトースト、トランスクリプト内のログ行、プロンプト上部の帯、プロンプト下のステータスラインを追加できます。mod はメッセージ、ツール呼び出しの行、スピナーを再描画できます。プロンプトは Claude Code 自身のものです。" width="600" height="336" data-path="images/mods-screen-map.svg" />

14 14 

15<img src="https://mintcdn.com/claude-code/dgiVO_Od1X1faduV/images/mods-screen-map-dark.svg?fit=max&auto=format&n=dgiVO_Od1X1faduV&q=85&s=5b4161581a1bd2c0450b0c8b57bc1225" className="hidden dark:block" alt="Claude Code のターミナルセッションの図。mod は、右側のサイドバーとしてのペイン、トランスクリプト右上のトースト、トランスクリプト内のログ行、プロンプト上部の帯、プロンプト下のステータスラインを追加できます。mod はメッセージ、ツール呼び出しの行、スピナーを再描画できます。プロンプトは Claude Code 自身のものです。" width="600" height="336" data-path="images/mods-screen-map-dark.svg" />15<img src="https://mintcdn.com/claude-code/dgiVO_Od1X1faduV/images/mods-screen-map-dark.svg?fit=max&auto=format&n=dgiVO_Od1X1faduV&q=85&s=5b4161581a1bd2c0450b0c8b57bc1225" className="hidden dark:block" alt="フルスクリーン描画での Claude Code のターミナルセッションの図。mod は、右側のサイドバーとしてのペイン、トランスクリプト右上のトースト、トランスクリプト内のログ行、プロンプト上部の帯、プロンプト下のステータスラインを追加できます。mod はメッセージ、ツール呼び出しの行、スピナーを再描画できます。プロンプトは Claude Code 自身のものです。" width="600" height="336" data-path="images/mods-screen-map-dark.svg" />

16 16 

17幅の狭いターミナルでは、ペインはトランスクリプトの横ではなくプロンプトの上に配置されます。17幅の狭いターミナルでは、ペインはトランスクリプトの横ではなくプロンプトの上に配置されます。

18 18 


324| `title` | 複数のペインが開いているときのペインのタブラベル |324| `title` | 複数のペインが開いているときのペインのタブラベル |

325| `focus` | [キーボードフォーカス](#know-which-keys-your-mod-can-receive)を要求する |325| `focus` | [キーボードフォーカス](#know-which-keys-your-mod-can-receive)を要求する |

326| `closeOnEscape` | Esc キーでペインを閉じられるようにする |326| `closeOnEscape` | Esc キーでペインを閉じられるようにする |

327| `holdToasts` | [`$.ui.toast`](/docs/ja/plugins/mods/api#show-something-without-starting-a-turn) による小さな通知であるトーストを、ペインが閉じるまで保留する |327| `holdToasts` | ターミナルでは、このペインが表示されている間トーストを保留する。[ダイアログの背後でトーストを保留する](#hold-toasts-behind-a-dialog)を参照してください。 |

328| `rows` | ペインがプロンプトの上に配置されるときに求める高さ。デフォルトは領域の 3 分の 1 です。 |328| `rows` | ペインがプロンプトの上に配置されるときに求める高さ。デフォルトは領域の 3 分の 1 です。 |

329| `columns` | ペインがトランスクリプトの横に配置されるときに求める幅 |329| `columns` | ペインがトランスクリプトの横に配置されるときに求める幅 |

330 330 


337 337 

338Claude の作業中にコマンドでペインを開けるようにするには、[コマンドを登録する](/docs/ja/plugins/mods/api#add-a-command)際に `immediate: true` を追加します。これがない場合、ターン中に入力されたコマンドはターンが終わるまで待機します。338Claude の作業中にコマンドでペインを開けるようにするには、[コマンドを登録する](/docs/ja/plugins/mods/api#add-a-command)際に `immediate: true` を追加します。これがない場合、ターン中に入力されたコマンドはターンが終わるまで待機します。

339 339 

340<h4 id="hold-toasts-behind-a-dialog">

341 ダイアログの背後でトーストを保留する

342</h4>

343 

344ペインがユーザーが回答して閉じるダイアログである場合は、`$.ui.open` に `holdToasts: true` を渡すと、ユーザーが判断している間にトーストが表示されなくなります。ターミナルでは、そのペインが表示されている間は保留が続き、その間に発生したトーストは保留が終わるまで待機します。

345 

346Claude Code は、自分の mod が [`$.ui.toast`](/docs/ja/plugins/mods/api#show-something-without-starting-a-turn) で発生させるトーストだけでなく、他の mod のトーストや Claude Code 自身の短時間の通知も保留します。開いたままにするペインではこのフィールドを省略し、ユーザーがそれらを引き続き確認できるようにしてください。

347 

340<h4 id="when-a-pane-waits-for-a-wider-terminal">348<h4 id="when-a-pane-waits-for-a-wider-terminal">

341 ペインが幅の広いターミナルを待つ場合349 ペインが幅の広いターミナルを待つ場合

342</h4>350</h4>

Details

64| :- | :- | :- |64| :- | :- | :- |

65| [`tool.call`](/docs/ja/plugins/mods/events#guard-or-change-a-tool-call) | ツールが実行される直前 | `next(e)`、`{ deny: reason }`、または `{ result }` |65| [`tool.call`](/docs/ja/plugins/mods/events#guard-or-change-a-tool-call) | ツールが実行される直前 | `next(e)`、`{ deny: reason }`、または `{ result }` |

66| [`tool.check`](/docs/ja/plugins/mods/events#where-settings-hooks-run-in-the-order) | `tool.call` フックと `PreToolUse` フックの後、Claude Code がツール呼び出しを実行してよいかを判定するとき。`next(e)` は、ルール、権限モード、それらのフックが下した判定に解決されます。 | `{ decision }`(`allow`、`ask`、`deny` のいずれか) |66| [`tool.check`](/docs/ja/plugins/mods/events#where-settings-hooks-run-in-the-order) | `tool.call` フックと `PreToolUse` フックの後、Claude Code がツール呼び出しを実行してよいかを判定するとき。`next(e)` は、ルール、権限モード、それらのフックが下した判定に解決されます。 | `{ decision }`(`allow`、`ask`、`deny` のいずれか) |

67| `tool.describe` | 各ツールにつき 1 回、その説明が初めて Claude に送信されるとき | `{ description }`(任意で `isDeferred` を指定でき、`true` にするとツールを[ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search)の背後に置き、`false` にすると最初から読み込みます) |67| `tool.describe` | 各ツールにつき 1 回、その説明が初めて Claude に送信されるとき。MCP ツールの場合は、Claude が[ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search)を通じてそのツールを読み込むときに 2 回目が発火し、`e.description` には読み込まれたツールについて Claude が読むテキストが設定されます。 | `{ description }`(任意で `isDeferred` を指定でき、`true` にするとツールをツール検索の背後に置き、`false` にすると最初から読み込みます) |

68 68 

69<h4 id="agent-and-organization-fields-on-tool-check">69<h4 id="agent-and-organization-fields-on-tool-check">

70 `tool.check` のエージェントと組織のフィールド70 `tool.check` のエージェントと組織のフィールド


133| `session.end` | セッションが終了するとき、または `/clear`、`/resume`、`/branch` が実行されるとき。`e.reason` は `clear`、`resume`、`logout`、`prompt_input_exit`、`other` のいずれかです。`/branch` は `resume` を報告します。 | `next(e)` |133| `session.end` | セッションが終了するとき、または `/clear`、`/resume`、`/branch` が実行されるとき。`e.reason` は `clear`、`resume`、`logout`、`prompt_input_exit`、`other` のいずれかです。`/branch` は `resume` を報告します。 | `next(e)` |

134| `session.compact` | 会話がコンパクト化される直前 | `{ skip: reason }` |134| `session.compact` | 会話がコンパクト化される直前 | `{ skip: reason }` |

135| [`session.receive`](/docs/ja/plugins/mods/api#send-and-receive-messages-between-sessions)、[`session.send`](/docs/ja/plugins/mods/api#send-and-receive-messages-between-sessions) | 他のエージェントやセッションからメッセージが届いたとき、またはそこへ送信される直前。[セッション間でメッセージを送受信する](/docs/ja/plugins/mods/api#send-and-receive-messages-between-sessions)を参照してください。 | `receive` では `{ consumed: reason }`、`send` では `{ isDelivered: false, reason }` |135| [`session.receive`](/docs/ja/plugins/mods/api#send-and-receive-messages-between-sessions)、[`session.send`](/docs/ja/plugins/mods/api#send-and-receive-messages-between-sessions) | 他のエージェントやセッションからメッセージが届いたとき、またはそこへ送信される直前。[セッション間でメッセージを送受信する](/docs/ja/plugins/mods/api#send-and-receive-messages-between-sessions)を参照してください。 | `receive` では `{ consumed: reason }`、`send` では `{ isDelivered: false, reason }` |

136| `session.append` | プロンプト、応答ブロック、ツールの結果、通知など、会話が保持する各行につき 1 回、保存される前 | 行の `content` を書き換えるには `next({ ...e, message })` |136| `session.append` | プロンプト、応答ブロック、ツールの結果、通知など、会話が保持する各行につき 1 回、保存される前 | 行のテキストブロック、または行内の `tool_result` ブロックの `content` を書き換えるには、`message.content` を変更した `next({ ...e, message })` |

137| `session.attach`、`session.detach` | 別のアプリがセッションに接続または切断するとき | `next(e)` |137| `session.attach`、`session.detach` | 別のアプリがセッションに接続または切断するとき | `next(e)` |

138| `session.measure` | 各ターンの後、およびプランの制限の使用率が変化したとき | `next(e)` |138| `session.measure` | 各ターンの後、およびプランの制限の使用率が変化したとき | `next(e)` |

139 139 


209| [`$.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` |209| [`$.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` |

210| [`$.command`](/docs/ja/plugins/mods/api#add-a-command) | `register`、`run`、`list` |210| [`$.command`](/docs/ja/plugins/mods/api#add-a-command) | `register`、`run`、`list` |

211| [`$.tool`](/docs/ja/plugins/mods/api#add-a-tool) | `register`、`call`、`check`、`list` |211| [`$.tool`](/docs/ja/plugins/mods/api#add-a-tool) | `register`、`call`、`check`、`list` |

212| `$.agent` | `register`、`spawn`、`list` |212| `$.agent` | `register`、`spawn`、`list`。`list()` はこのセッションのサブエージェントとチームメイトを返します。それぞれに `pending`、`running`、`waiting`、`idle`、`completed`、`failed`、`killed` のいずれかの `status` があり、`idle` と `waiting` には Claude Code v2.1.289 以降が必要です。 |

213| [`$.model`](/docs/ja/plugins/mods/api#call-a-model) | `complete`、`fork`、`classify` |213| [`$.model`](/docs/ja/plugins/mods/api#call-a-model) | `complete`、`fork`、`classify` |

214| [`$.prompt`](/docs/ja/plugins/mods/api#start-a-turn-from-a-background-job) | `submit`、`read`、`fill`、`suggest`、`compose`。Claude は、`submit({ text })` のテキストを、その mod を送信者として示す文の後に読みます。`submit({ text, asUser: true })` は、その文なしで、テキストをユーザー自身の言葉として送信します。 |214| [`$.prompt`](/docs/ja/plugins/mods/api#start-a-turn-from-a-background-job) | `submit`、`read`、`fill`、`suggest`、`compose`。Claude は、`submit({ text })` のテキストを、その mod を送信者として示す文の後に読みます。`submit({ text, asUser: true })` は、その文なしで、テキストをユーザー自身の言葉として送信します。 |

215| `$.turn` | `abort` |215| `$.turn` | `abort` |


317| `$.process.run` のタイムアウト | デフォルトは 30 秒、最大 10 分 |317| `$.process.run` のタイムアウト | デフォルトは 30 秒、最大 10 分 |

318| `$.model.complete` の `maxTokens` | デフォルトは 1024、最大 64,000 またはモデルの出力上限 |318| `$.model.complete` の `maxTokens` | デフォルトは 1024、最大 64,000 またはモデルの出力上限 |

319| `$.fs.read` と `$.fs.write` | 1 ファイルあたり 4 MiB |319| `$.fs.read` と `$.fs.write` | 1 ファイルあたり 4 MiB |

320| フックの `drop` の理由、または `config.set` の `deny` の理由 | 4,096 文字。これより長い理由は末尾が切り詰められ、drop または deny はそのまま適用されます。切り詰めには Claude Code v2.1.292 以降が必要で、それより前のバージョンではフックが代わりに[失敗](/docs/ja/plugins/mods/events#handle-a-hook-that-fails)します。 |

320| 1 つのツリー内のテキスト | 最初の 100,000 文字が描画されます |321| 1 つのツリー内のテキスト | 最初の 100,000 文字が描画されます |

321| `Code` の `language` または `path`、`Select` オプションの `value`、または `Client` の `module` | 10,000 文字。これより長い場合、Claude Code は[その箇所を独自の表示で描画します](/docs/ja/plugins/mods/interface#build-a-tree-from-elements)。 |322| `Code` の `language` または `path`、`Select` オプションの `value`、または `Client` の `module` | 10,000 文字。これより長い場合、Claude Code は[その箇所を独自の表示で描画します](/docs/ja/plugins/mods/interface#build-a-tree-from-elements)。 |

322| `Link` の `href` | 2,048 文字。これより長い `href` があると、ツリー全体が描画されません。 |323| `Link` の `href` | 2,048 文字。これより長い `href` があると、ツリー全体が描画されません。 |


325| `$.ui.invalidate('ui.render')` による再描画 | 1 秒あたり 10 回に制限。ターミナルでは、表示中のペイン、展開されたバンド、プロンプト下のヒント行については 30 回。それより早い呼び出しはまとめられます。 |326| `$.ui.invalidate('ui.render')` による再描画 | 1 秒あたり 10 回に制限。ターミナルでは、表示中のペイン、展開されたバンド、プロンプト下のヒント行については 30 回。それより早い呼び出しはまとめられます。 |

326| `$.ui.toast` | `{ timeoutMs }` を渡さない限り 4 秒間表示 |327| `$.ui.toast` | `{ timeoutMs }` を渡さない限り 4 秒間表示 |

327| ユーザーが求めずに開かれたペイン | ターミナルの幅が 144 列以上で配置。ユーザーが一度開いた後は 110 列以上 |328| ユーザーが求めずに開かれたペイン | ターミナルの幅が 144 列以上で配置。ユーザーが一度開いた後は 110 列以上 |

329| フックモジュールの 1 つのファイル内で互いに入れ子になったスコープ(関数、ブロック、ループなど) | 2,000 |

328| コマンド、ツール、サブエージェントの種類、ペインの名前 | 英字、数字、`_`、`-`、最大 64 文字 |330| コマンド、ツール、サブエージェントの種類、ペインの名前 | 英字、数字、`_`、`-`、最大 64 文字 |

329| 1 つの `claude plugin test` テスト | テストが `timeoutMs` を設定しない限り 5 秒 |331| 1 つの `claude plugin test` テスト | テストが `timeoutMs` を設定しない限り 5 秒 |

330 332 

Details

110* `returned neither { value } nor { deny }`: mods API 呼び出し用のスタブが値をそのまま返した。この場合、テストは失敗する110* `returned neither { value } nor { deny }`: mods API 呼び出し用のスタブが値をそのまま返した。この場合、テストは失敗する

111* `no implementation for` の後に名前が続く: mod がその呼び出しを行ったが、応答するスタブがない111* `no implementation for` の後に名前が続く: mod がその呼び出しを行ったが、応答するスタブがない

112 112 

113キットは、名前空間全体に応答するインメモリのモックもエクスポートしています。`mock.clock(on)` は [`$.clock`](/docs/ja/plugins/mods/api#run-work-in-the-background) に応答し、`mock.store(on, { count: 7 })` は指定したエントリで始まるストアから `$.store` に応答し、`mock.env(on, { CI: 'true' })` は指定した変数から `$.env.get` に応答します。`mock.clock` はテストが進めるモッククロックを返すため、タイマーのテストで待つ必要がありません。`mock.store` は何も返さないため、mod が何を保存したかを確認するには、[描画のテスト](#test-a-drawing)のように 2 つの `store` スタブを自分で書きます。113キットは、クロック、ストア、環境変数、会話に追加された行のための既製のモックもエクスポートしています。

114 

115* **`mock.clock(on)`**: [`$.clock`](/docs/ja/plugins/mods/api#run-work-in-the-background) に応答し、テストが進めるモッククロックを返すため、タイマーのテストで待つ必要がありません。

116* **`mock.store(on, { count: 7 })`**: 指定したエントリで始まるストアから `$.store` に応答します。何も返さないため、mod が何を保存したかを確認するには、[描画のテスト](#test-a-drawing)のように 2 つの `store` スタブを自分で書きます。

117* **`mock.env(on, { CI: 'true' })`**: 指定した変数から `$.env.get` に応答します。

118* **`mock.session(on)`**: モックセッションを返します。その `appended()` メソッドは、mod が [`$.session.append`](/docs/ja/plugins/mods/reference#session) で追加した行を古い順に一覧表示します。Claude Code v2.1.293 以降が必要です。

114 119 

115<h3 id="follow-the-test-kit’s-rules">120<h3 id="follow-the-test-kit’s-rules">

116 テストキットのルールに従う121 テストキットのルールに従う


168 スタブが返す値を調べる173 スタブが返す値を調べる

169</h3>174</h3>

170 175 

171テスト内で mod が行うすべての mods API 呼び出しには、Claude Code の代わりに応答するスタブが必要です。ただし、キット自身が応答する少数の呼び出し、つまり [`$.ui.invalidate`](/docs/ja/plugins/mods/interface#redraw-when-something-changes) と [`$.state`](/docs/ja/plugins/mods/interface#keep-state) の呼び出しは例外です。`$.clock` の呼び出しには `mock.clock(on)` を使用してください。そうしないと、mod の `$.clock.now()` が `no implementation for clock.now` で失敗します。176テスト内で mod が行うすべての mods API 呼び出しには、Claude Code の代わりに応答するスタブが必要です。ただし、キット自身が応答する少数の呼び出し、つまり [`$.ui.invalidate`](/docs/ja/plugins/mods/interface#redraw-when-something-changes)、[`$.state`](/docs/ja/plugins/mods/interface#keep-state)、`$.session.append` の呼び出しは例外です。`$.clock` の呼び出しには `mock.clock(on)` を使用してください。そうしないと、mod の `$.clock.now()` が `no implementation for clock.now` で失敗します。

172 177 

173この表は、mod で最もよく使われるものを示しています。1 列目は、mod が行う呼び出し、または `next(e)` で渡すイベントです。2 列目は、その名前で `on` に渡す関数です。たとえば `$.store.get` の行は `on('store.get', ($, e) => ({ value: saved.get(e.key) }))` になります。スタブ内の `'...'` は、自分で埋めるテキストを示します。178この表は、mod で最もよく使われるものを示しています。1 列目は、mod が行う呼び出し、または `next(e)` で渡すイベントです。2 列目は、その名前で `on` に渡す関数です。たとえば `$.store.get` の行は `on('store.get', ($, e) => ({ value: saved.get(e.key) }))` になります。スタブ内の `'...'` は、自分で埋めるテキストを示します。

174 179 

Details

116 116 

117値を設定または変更します。行の末尾は `settings.json` の `pluginConfigs` エントリの名前を示します。117値を設定または変更します。行の末尾は `settings.json` の `pluginConfigs` エントリの名前を示します。

118 118 

119<h3 id="code-nested-too-deep-to-scan-more-than-2000-scopes">

120 `code nested too deep to scan: more than 2000 scopes`

121</h3>

122 

123行は mod の名前で始まり、`hooks module did not load:`、ファイル、`code nested too deep to scan: more than 2000 scopes` が続きます。フックモジュール内のファイルは、関数、ブロック、ループなどのスコープを [2,000 階層](/docs/ja/plugins/mods/reference#limits)を超えてネストできません。[`claude plugin validate`](/docs/ja/plugins/mods/create#check-what-claude-code-reads-from-your-mod) も同じ理由を報告します。

124 

125スコープのネストが浅くなるようにコードを書き直します。

126 

119<h3 id="no-mod-loads-in-a-directory-you-opened-for-the-first-time">127<h3 id="no-mod-loads-in-a-directory-you-opened-for-the-first-time">

120 初めて開いたディレクトリで mod が読み込まれない128 初めて開いたディレクトリで mod が読み込まれない

121</h3>129</h3>


132 140 

133フラグなしで開始します。141フラグなしで開始します。

134 142 

143<h3 id="claude-code-stops-asking-to-enable-hot-reloading">

144 Claude Code がホットリロードを有効にするか尋ねなくなる

145</h3>

146 

147対話型セッションで Claude が mod を書いても何も読み込まれず、Claude Code が[ホットリロードを有効にするかどうか](/docs/ja/plugins/mods/create#ask-claude-for-a-mod)を再度尋ねません。回答が選択されないまま質問が 3 回終了すると、ホットリロードはオフのままになります。例えば、[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) を設定していて、回答する前に時間が経過すると、質問はそのように終了します。Claude Code は [`AskUserQuestion` が使用するのと同じ質問ダイアログ](/docs/ja/tools-reference#question-auto-continue-timeout)で尋ねるため、この設定がここで適用されます。自分で閉じた質問は 3 回には数えられません。

148 

149mod を実行するには、[mods フォルダからそのディレクトリをコピー](/docs/ja/plugins/mods/create#use-the-mod-in-other-sessions)し、シェルで `--plugin-dir` を使用して新しいセッションを開始します(例: `claude --plugin-dir ~/mods/git-branch`)。

150 

135<h2 id="a-hook-is-skipped-or-a-mod-is-unloaded">151<h2 id="a-hook-is-skipped-or-a-mod-is-unloaded">

136 hooks がスキップされるか mod がアンロードされる152 hooks がスキップされるか mod がアンロードされる

137</h2>153</h2>


209 描画が表示されないか応答しない225 描画が表示されないか応答しない

210</h2>226</h2>

211 227 

212mod が読み込まれ、そのペイン、バンド、またはコントロールが期待どおりに動作しません。228mod が読み込まれ、そのペイン、バンド、トースト、またはコントロールが期待どおりに動作しません。

213 229 

214<h3 id="a-pane-or-band-is-empty-or-shows-claude-code’s-usual-content">230<h3 id="a-pane-or-band-is-empty-or-shows-claude-code’s-usual-content">

215 ペインまたはバンドが空であるか、Claude Code の通常のコンテンツを表示する231 ペインまたはバンドが空であるか、Claude Code の通常のコンテンツを表示する


247 263 

248コマンドまたはボタンからペインを開くか、呼び出しの `isPlaced` 結果を確認します。[適切なタイミングでペインを開く](/docs/ja/plugins/mods/interface#open-a-pane-at-the-right-time) を参照してください。264コマンドまたはボタンからペインを開くか、呼び出しの `isPlaced` 結果を確認します。[適切なタイミングでペインを開く](/docs/ja/plugins/mods/interface#open-a-pane-at-the-right-time) を参照してください。

249 265 

266<h3 id="a-toast-doesn’t-appear">

267 トーストが表示されない

268</h3>

269 

270mod がインタラクティブなターミナルセッションで [`$.ui.toast`](/docs/ja/plugins/mods/api#show-something-without-starting-a-turn) を呼び出しても、トーストが表示されません。呼び出しが実行されたことを確認するには、[デバッグログ](#read-the-debug-log) で mod の名前とトーストのテキストを含む行を探します。例えば `$.ui.toast (first-mod): build finished` のような行です。次に、以下のような原因を確認してください。

271 

272* **呼び出しの行がない**: Claude Code が呼び出しを拒否した理由を示す行を探します。例えば `first-mod: $.ui.toast dropped: timeoutMs is a whole number of ms, 1 to 60000` のような行です。

273* **ペインがトーストを保留している**: 表示中のペインを開く際に、自分の mod または別の mod が [`holdToasts`](/docs/ja/plugins/mods/interface#hold-toasts-behind-a-dialog) を渡しています。ペインを閉じると保留が終了します。そのペインが自分のもので、開いたままにしておく必要がある場合は、その `$.ui.open` 呼び出しから `holdToasts` を削除し、ペインを開き直してください。

274* **トーストがプロンプトの下にある**: [クラシックレンダラー](/docs/ja/fullscreen#enable-fullscreen-rendering) では、プロンプトの下の右側を確認します。そこに表示されるトーストは、右上のボックスではなく、mod の名前で始まる 1 行です。

275* **mod がより新しいトーストを出した**: クラシックレンダラーでは、mod からのより新しいトーストが、表示中または表示待ちのトーストに取って代わることがあります。デバッグログには古いトーストについての別の行があり、表示中だった場合は `gave way, cut short`、表示されなかった場合は `gave way, unseen` で終わります。両方のメッセージを表示するには、1 つのトーストにまとめてください。

276* **トーストが描画されないまま時間切れになった**: フルスクリーンレンダリングでは、Claude Code は一度に最大 3 つのトーストしか描画しないため、トーストが描画される前に時間切れになることがあります。デバッグログにはそのトーストについての別の行があり、`left the stack, never drawn` で終わります。mod が一度に複数のトーストを出す場合は、メッセージを 1 つのトーストにまとめてください。

277 

278v2.1.290 より前では、Claude Code は、mod に対して最後に表示したトーストから 2 秒以内に出されたトーストを破棄しており、破棄されたトーストのデバッグログの行には `within 2000ms of the last; dropped` と表示されていました。

279 

250<h3 id="hotkeys-do-nothing">280<h3 id="hotkeys-do-nothing">

251 ホットキーが何もしない281 ホットキーが何もしない

252</h3>282</h3>

Details

110}110}

111```111```

112 112 

113シェルで、リポジトリで `claude plugin validate .` を実行して、プッシュする前にファイルを確認してください。113プッシュする前に、シェルでリポジトリ内の `claude plugin validate .` を実行してください。この実行でチェックされる内容については、[ディレクトリを検証する](/docs/ja/plugins/cli-reference#validate-a-directory)を参照してください。

114 114 

115[マーケットプレイスを作成する](/docs/ja/plugins/create-marketplace)は、1 つのリポジトリに複数のプラグインがある場合のレイアウトをカバーしています。115[マーケットプレイスを作成する](/docs/ja/plugins/create-marketplace)は、1 つのリポジトリに複数のプラグインがある場合のレイアウトをカバーしています。

116 116 


129* マーケットプレイスを 1 回追加する: `claude plugin marketplace add your-org/your-marketplace`。引数は GitHub の `owner/repo` 短縮形、URL、またはパスです129* マーケットプレイスを 1 回追加する: `claude plugin marketplace add your-org/your-marketplace`。引数は GitHub の `owner/repo` 短縮形、URL、またはパスです

130* プラグインをインストールする: `claude plugin install deploy-helper@your-marketplace`130* プラグインをインストールする: `claude plugin install deploy-helper@your-marketplace`

131* またはセッション内から両方を実行する: `/plugin install deploy-helper --marketplace your-org/your-marketplace`。Claude Code v2.1.275 以降が必要です。[マーケットプレイスを追加して 1 つのコマンドでインストールする](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command)を参照してください131* またはセッション内から両方を実行する: `/plugin install deploy-helper --marketplace your-org/your-marketplace`。Claude Code v2.1.275 以降が必要です。[マーケットプレイスを追加して 1 つのコマンドでインストールする](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command)を参照してください

132* またはシェルから 1 つのコマンドで両方を実行する: `claude plugin install deploy-helper --marketplace your-org/your-marketplace`。Claude Code v2.1.292 以降が必要です

132 133 

133<h3 id="ship-updates-to-users">134<h3 id="ship-updates-to-users">

134 ユーザーに更新を配布する135 ユーザーに更新を配布する

Details

163 `Invalid marketplace source format`163 `Invalid marketplace source format`

164</h3>164</h3>

165 165 

166`/plugin marketplace add <source>` または `claude plugin marketplace add <source>` を実行し、Claude Code は `Invalid marketplace source format. Try: owner/repo, https://..., or ./path` で返信しました。166`/plugin marketplace add <source>`、`claude plugin marketplace add <source>`、または `claude plugin install <plugin> --marketplace <source>` を実行し、Claude Code は `Invalid marketplace source format. Try: owner/repo, https://..., or ./path` で返信しました。

167 167 

168Claude Code は、次のいずれかの形式でソースを受け入れます:168Claude Code は、次のいずれかの形式でソースを受け入れます:

169 169 


237* **マーケットプレイスを所有している場合**:ファイルをその場所に配置し、マーケットプレイスを再度追加してください237* **マーケットプレイスを所有している場合**:ファイルをその場所に配置し、マーケットプレイスを再度追加してください

238* **他の誰かがホストしている場合**:所有者に正確なソースを尋ねてください238* **他の誰かがホストしている場合**:所有者に正確なソースを尋ねてください

239 239 

240<h3 id="cannot-install-plugins-from-a-marketplace-with-this-name">

241 `Cannot add marketplace "<name>": Claude Code cannot install plugins from a marketplace with this name`

242</h3>

243 

244マーケットプレイスを追加しましたが、その `marketplace.json` 内の [`name`](/docs/ja/plugins/marketplace-reference#top-level-fields) が、`my-plugin@my-marketplace` のような[プラグイン ID](/docs/ja/plugins/loading#find-where-a-plugin-came-from) の `@` 以降の部分として有効ではありません。Claude Code は追加を拒否し、何も登録しません。

245 

246メッセージの残りの部分には、名前のルールが記載されています。この例では、`_internal` は `_` で始まっているためルールに違反しています:

247 

248```text theme={null}

249Cannot add marketplace "_internal": Claude Code cannot install plugins from a marketplace with this name. Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. The name is set by "name" in the marketplace's marketplace.json; ask its maintainer to change it.

250```

251 

252そのルールに合う名前をマーケットプレイスに付けてから、再度追加してください:

253 

254* **マーケットプレイスを所有している場合**:`marketplace.json` の `name` を、たとえば `internal-tools` に変更してください

255* **他の誰かがホストしている場合**:所有者に名前の変更を依頼してください

256 

257v2.1.295 より前は、Claude Code はこの例の追加を成功として報告していました。

258 

240<h3 id="ssh-authentication-failed-or-https-authentication-failed">259<h3 id="ssh-authentication-failed-or-https-authentication-failed">

241 `SSH authentication failed` または `HTTPS authentication failed`260 `SSH authentication failed` または `HTTPS authentication failed`

242</h3>261</h3>


568 `Marketplace "<name>" is already added from a different source`587 `Marketplace "<name>" is already added from a different source`

569</h3>588</h3>

570 589 

571[`/plugin install <plugin> --marketplace <source>`](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command)を通じてマーケットプレイスの追加を確認し、Claude Code がそのソースからフェッチしたカタログは、別のソースから既に追加したマーケットプレイスと同じ名前を持っています。Claude Code は既存のマーケットプレイスを保持し、プラグインをインストールしません。590セッションまたはシェルから、[インストールコマンドの `--marketplace <source>`](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command) で新しいマーケットプレイスソースを指定しました。Claude Code がそのソースからフェッチしたカタログは、別のソースから既に追加したマーケットプレイスと同じ名前を持っています。Claude Code は既存のマーケットプレイスを置き換えずに保持し、プラグインはインストールされません。

572 591 

573完全なメッセージは次のようになります:592完全なメッセージは次のようになります:

574 593 


786 805 

787Claude Code は使用不可能なレコードを `.set-aside` ファイルにコピーし、リストからドロップします。Claude Code はコピーを再度読み込むことはなく、コピーは [`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) スケジュールで期限切れになります。806Claude Code は使用不可能なレコードを `.set-aside` ファイルにコピーし、リストからドロップします。Claude Code はコピーを再度読み込むことはなく、コピーは [`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) スケジュールで期限切れになります。

788 807 

808<h3 id="does-not-load-so-claude-code-ignores-the-whole-file">

809 `does not load (...), so Claude Code ignores the whole file`

810</h3>

811 

812コマンドは正常に動作しました。警告で示されている設定ファイルにエラーがあるため、修正するまで Claude Code はそのファイル全体を無視します。コマンドがそこに書き込んだ内容も無視されます。

813 

814警告で示されているエラーを修正してください。Claude Code が受け付けない値については、[壊れた設定ファイルを修正する](/docs/ja/settings#fix-a-broken-settings-file) で方法を説明しています。その後、コマンドの変更がファイルに残っていない場合は、コマンドを再度実行してください。

815 

816警告は、シェルでの `claude plugin install`、`enable`、`disable`、または `claude plugin marketplace add` の成功行の後に表示されます。

817 

818```text theme={null}

819⚠ /home/user/.claude/settings.json does not load (its "permissions" is not valid), so Claude Code ignores the whole file, including anything this command wrote there. Fix the file, then run this command again if its change is missing. If a newer Claude Code wrote the file, update Claude Code instead.

820```

821 

822括弧内のテキストがエラーを示します。

823 

824* **`its "<key>" is not valid`**: 引用符で囲まれた設定項目に、Claude Code が受け付けない値が入っています。その設定項目が取る値については、[設定リファレンス](/docs/ja/settings-reference) で確認してください。複数の値が失敗した場合、テキストは最初の設定項目を示し、残りの数を示します(例: `its "permissions" and 1 other value are not valid`)。

825* **`it is not a JSON object`**: ファイルのトップレベルが JSON オブジェクトではありません。たとえば、トップレベルが配列のファイルです。

826 

789<h3 id="a-plugin-you-disabled-still-loads">827<h3 id="a-plugin-you-disabled-still-loads">

790 `Disabled in ~/.claude/settings.json but still loads`828 `Disabled in ~/.claude/settings.json but still loads`

791</h3>829</h3>


812 850 

813組織がプラグインを事前にインストールしている場合、管理設定を通じてそうします。[プラグインの事前インストールと要求](/docs/ja/plugins/org#pre-install-and-require-plugins) を参照してください。851組織がプラグインを事前にインストールしている場合、管理設定を通じてそうします。[プラグインの事前インストールと要求](/docs/ja/plugins/org#pre-install-and-require-plugins) を参照してください。

814 852 

853<h3 id="a-plugin-stays-installed-after-plugin-uninstall-on-windows">

854 Windows で `plugin uninstall` 後もプラグインがインストールされたままになる

855</h3>

856 

857Windows でプロジェクトスコープまたはローカルスコープで `claude plugin uninstall` を実行すると成功と報告されますが、`claude plugin list` または `/plugin` にはまだプラグインがリストされています。

858 

859`installed_plugins.json` にはプロジェクトフォルダーに対するプラグインのインストール記録が 2 つあり、それぞれフォルダーのパスの表記が異なっていて、1 回のアンインストールではそのうち 1 つしか削除されません。確認するには、シェルで `claude plugin list --json` を実行してください。プラグインの残っている行の `projectPath` は、アンインストールを実行した場所とは異なる表記でフォルダーを示しています(例: `C:\work\app` に対する `c:\work\app`)。

860 

861同じアンインストールコマンドを、同じ `--scope` を指定して、同じフォルダーからもう一度実行してください。2 回目の実行では自身のパス表記の下に記録が見つからないため、もう一方の表記の記録を削除します。プロジェクトスコープのインストールの場合:

862 

863```shell theme={null}

864claude plugin uninstall <name>@<marketplace> --scope project

865```

866 

867その後、もう一度 `claude plugin list --json` を実行して、行が消えたことを確認してください。

868 

869v2.1.295 より前では、2 回目の実行は `Plugin "<name>" is not installed in project scope` で失敗します。`claude update` を実行してから、アンインストールを再度実行してください。

870 

815<h3 id="failed-to-load-hooks-from-and-hooks-that-dont-fire">871<h3 id="failed-to-load-hooks-from-and-hooks-that-dont-fire">

816 `Failed to load hooks from <path>` とフックが発火しない872 `Failed to load hooks from <path>` とフックが発火しない

817</h3>873</h3>


835 891 

836stderr がプラグインのパスをスペースで切り取って表示している場合、フックのシェル形式コマンドは引用符の外で `${CLAUDE_PLUGIN_ROOT}` を使用し、インストール パスにスペースが含まれています。変数を二重引用符で囲むか、[exec 形式](/docs/ja/hooks#exec-form-and-shell-form) を使用してください。引用符なしの変数を見つけるには、プラグイン ディレクトリで `claude plugin validate` を実行し、その [引用警告](/docs/ja/plugins/manifest-reference#quoting-and-path-separators) を探してください。892stderr がプラグインのパスをスペースで切り取って表示している場合、フックのシェル形式コマンドは引用符の外で `${CLAUDE_PLUGIN_ROOT}` を使用し、インストール パスにスペースが含まれています。変数を二重引用符で囲むか、[exec 形式](/docs/ja/hooks#exec-form-and-shell-form) を使用してください。引用符なしの変数を見つけるには、プラグイン ディレクトリで `claude plugin validate` を実行し、その [引用警告](/docs/ja/plugins/manifest-reference#quoting-and-path-separators) を探してください。

837 893 

894通知が `Failed to run: Plugin directory does not exist: <path>` の場合は、[`Plugin directory does not exist`](#plugin-directory-does-not-exist) を参照してください。

895 

838その他のエラーについては、プラグイン ディレクトリからフックのコマンドを自分で実行して完全な出力を確認するか、[デバッグ ログ](/docs/ja/hooks#debug-hooks) で完全な stderr をキャプチャしてください。896その他のエラーについては、プラグイン ディレクトリからフックのコマンドを自分で実行して完全な出力を確認するか、[デバッグ ログ](/docs/ja/hooks#debug-hooks) で完全な stderr をキャプチャしてください。

839 897 

840<h4 id="a-plugin-hook-blocks-a-tool-call-or-prompt">898<h4 id="a-plugin-hook-blocks-a-tool-call-or-prompt">


869 </Step>927 </Step>

870</Steps>928</Steps>

871 929 

930<h3 id="plugin-directory-does-not-exist">

931 `Plugin directory does not exist: <path>`

932</h3>

933 

934メッセージには再インストールするよう書かれていますが、まず Claude Code のプロンプトで `/reload-plugins` を実行してください。セッションがプラグインのフックをロードしたディレクトリがディスクから消えている場合、プラグインのフックは `Failed to run: Plugin directory does not exist: <path> (<plugin> — run /plugin to reinstall)` で失敗し、フックは実行されません。[`Plugin directory not found at path: <path>`](#plugin-directory-not-found-at-path) は、マーケットプレイスのエントリに関する別のメッセージです。

935 

936リロードにより、プラグインのフックが現在のディレクトリからロードされます。失敗はフックイベントとコマンドごとにセッションにつき 1 回だけ表示されるため、フックが何も表示しなくなっても修正されたことの確認にはなりません。代わりにリロードの出力を読んでください。

937 

938* **エラー行のない `Reloaded:`**: プラグインのフックは、存在しないディレクトリを参照しなくなりました

939* **`N errors during load. Run /plugin for details.`**: `/plugin` で **Errors** タブを開き、表示されたメッセージに対応するこのページのエントリに従ってください

940* **`Run /reload-plugins --force to apply.` で終わる行**: 何もリロードされておらず、フックは失敗し続けます。Claude Code のプロンプトで `/reload-plugins --force` を実行してください

941 

872<h3 id="invalid-mcp-server-config-for-and-mcp-servers-that-dont-start">942<h3 id="invalid-mcp-server-config-for-and-mcp-servers-that-dont-start">

873 `Invalid MCP server config for "<server>"` と MCP サーバーが起動しない943 `Invalid MCP server config for "<server>"` と MCP サーバーが起動しない

874</h3>944</h3>


1063 1133 

1064`claude plugin validate <path>` を実行するか、セッション内で `/plugin validate <path>` を実行し、`Found N errors` と `Validation failed` を出力してから、終了コード 1 で終了しました。1134`claude plugin validate <path>` を実行するか、セッション内で `/plugin validate <path>` を実行し、`Found N errors` と `Validation failed` を出力してから、終了コード 1 で終了しました。

1065 1135 

1066バリデーターは、指定したパスのマニフェストを読み込みます。プラグインディレクトリの場合は `.claude-plugin/plugin.json`、マーケットプレイスディレクトリの場合は `.claude-plugin/marketplace.json`。マーケットプレイスの場合、エントリ自体のマニフェスト内の問題にはエントリインデックスをプレフィックスとして付け、`plugins[1] plugin.json → json: ...` として表示します。1136バリデーターは、指定したパスのマニフェストを読み込みます。プラグインディレクトリの場合は `.claude-plugin/plugin.json`、マーケットプレイスディレクトリの場合は `.claude-plugin/marketplace.json`、両方を含むディレクトリの場合はその両方です。マーケットプレイスの場合、エントリ自体のマニフェスト内の問題にはエントリインデックスをプレフィックスとして付け、`plugins[1] plugin.json → json: ...` として表示します。v2.1.289 より前では、Claude Code は両方を含むディレクトリをマーケットプレイスとしてのみ検証していました。

1067 1137 

1068テーブルは検証を停止するメッセージと 2 つの警告(`No frontmatter block found` と `Unknown field '<key>'`)をカバーしており、これらの警告は `--strict` を渡す場合にのみ検証を停止します。説明の欠落など、その他の警告は一覧表示されません。1138テーブルは検証を停止するメッセージと 2 つの警告(`No frontmatter block found` と `Unknown field '<key>'`)をカバーしており、これらの警告は `--strict` を渡す場合にのみ検証を停止します。説明の欠落など、その他の警告は一覧表示されません。

1069 1139 

remote-control.md +54 −21

Details

370 制限事項370 制限事項

371</h2>371</h2>

372 372 

373* **インタラクティブプロセスごとに 1 つのリモートセッション**: サーバーモード外では、各 Claude Code インスタンスは一度に 1 つのリモートセッションをサポートします。単一プロセスから複数の同時セッションを実行するには、[サーバーモード](#start-a-remote-control-session)を使用してください。373* **対話型プロセスごとに 1 つのリモートセッション**: サーバーモード以外では、各 Claude Code インスタンスは一度に 1 つのリモートセッションをサポートします。単一のプロセスから複数のセッションを同時に実行するには、[サーバーモード](#start-a-remote-control-session)を使用してください。

374* **ローカルプロセスを実行し続ける必要がある**: Remote Control はローカルプロセスとして実行されます。ターミナルを閉じたり、Desktop アプリや VS Code を終了したり、その他の方法で `claude` プロセスを停止したりすると、[再開する](#resume-sessions-after-stopping-the-server)までセッションはオフラインになります。リモートマシン上のターミナルから `claude` を実行する場合は、SSH の接続を切断した後もセッションが実行され続けるように、`tmux` または `screen` の中で起動してください。374* **ローカルプロセスを実行し続ける必要がある**: Remote Control はローカルプロセスとして実行されます。ターミナルを閉じる、Desktop アプリや VS Code を終了する、またはその他の方法で `claude` プロセスを停止すると、[再開する](#resume-sessions-after-stopping-the-server)までセッションはオフラインになります。リモートマシン上のターミナルから `claude` を実行する場合は、SSH から切断した後もセッションが実行され続けるように、`tmux` または `screen` の中で起動してください。

375* **サーバーモードでのクラッシュしたセッション**: `claude remote-control` で提供されるセッションがクラッシュした場合、接続されたデバイスからメッセージを送信してください。Claude Code はそれを再度提供します。サーバーを再起動する必要はありません。Claude Code v2.1.238 以降が必要です。375* **サーバーモードでクラッシュしたセッション**: `claude remote-control` で提供されているセッションがクラッシュした場合は、接続済みのデバイスからそのセッションにメッセージを送信してください。Claude Code がそのセッションを再び提供します。サーバーを再起動する必要はありません。Claude Code v2.1.238 以降が必要です。

376* **接続されたセッションでの HTTP 403 拒否**: インタラクティブセッションが接続されると、VPN またはネットワークの変更後に発生する可能性があるように、マシンと Anthropic のサーバー間の何かが HTTP 403 で応答する場合、Claude Code は最大 3 分間再試行を続けます。拒否が長く続く場合、Claude Code は切断され、理由は何が拒否したかを示します。ネットワークエッジ、またはユーザー自身のネットワーク上のプロキシ、VPN、またはファイアウォールです。376* **接続済みセッションでの HTTP 403 拒否**: 対話型セッションが接続されると、VPN やネットワークの変更後などに、マシンと Anthropic のサーバーの間にある何かが HTTP 403 で応答した場合、Claude Code は最大 3 分間再試行を続けます。拒否がそれより長く続くと Claude Code は切断し、その理由として拒否したもの(ネットワークエッジ、または自分のネットワーク上のプロキシ、VPN、ファイアウォール)が示されます。

377* **拡張ネットワーク障害**: マシンが起動しているがネットワークに到達できない場合、次に何をするかはモードによって異なります。377* **長時間のネットワーク障害**: マシンがスリープしていないのにネットワークに到達できない場合、次に行うことはモードによって異なります。

378 * **サーバーモード**: Claude Code は約 10 分後にあきらめ、`claude remote-control` プロセスが終了します。新しいセッションを開始するには、`claude remote-control` を再度実行してください。378 * **サーバーモード**: Claude Code は約 10 分後に諦め、`claude remote-control` プロセスが終了します。新しいセッションを開始するには、`claude remote-control` を再度実行してください。

379 * **インタラクティブセッション**: ローカルで作業を続けてください。Claude Code は障害が続く限り再試行を続け、ネットワークが戻ると自動的に再接続します。379 * **対話型セッション**: ローカルで作業を続けてください。Claude Code は障害が続く間再試行を続け、ネットワークが復旧すると自動的に再接続します。

380* **ダウンロードされない添付ファイル**: スマートフォンまたはブラウザから添付したファイルをマシンにダウンロードできない場合でも、Claude はメッセージとダウンロードされたファイルを受け取ります。欠落しているファイルの代わりに、Claude Code は `[1 of 3 attachments did not arrive]` などの注記をメッセージに追加します。380* **ダウンロードされない添付ファイル**: スマートフォンやブラウザから添付したファイルをマシンにダウンロードできない場合でも、Claude はメッセージとダウンロードできたファイルを受け取ります。欠けているファイルの代わりに、Claude Code は `[1 of 3 attachments did not arrive]` のような注記をメッセージに追加します。

381* **プレゼンスハートビートの失敗**: インタラクティブセッションが `could not reach the Remote Control server for about 30 minutes` で切断された場合、`/remote-control` を実行して再接続してください。381* **プレゼンスハートビートの失敗**: 対話型セッションが `could not reach the Remote Control server for about 30 minutes` で切断された場合は、`/remote-control` を実行して再接続してください。

382* **転送されたダイアログの有効期限**: Claude Code は権限プロンプトと `AskUserQuestion` の質問を、回答するまで開いたままにします。Claude Code が別の種類のダイアログをリモートセッションに転送する場合(安全性拒否後に表示されるモデル選択プロンプトなど)、デフォルトでは 5 分待機してからダイアログを閉じ、ダイアログのアクション不要なデフォルトで続行します。[`dialogExpiry`](/docs/ja/settings-reference#dialogexpiry) を設定して期限を調整または無効にしてください。Claude Code v2.1.224 以降が必要です。382* **転送されたダイアログの有効期限**: Claude Code は、権限プロンプトと `AskUserQuestion` の質問を、回答するまで開いたままにします。安全性による拒否の後に表示されるモデル選択プロンプトなど、別の種類のダイアログを Claude Code がリモートセッションに転送した場合は、デフォルトで 5 分間待機した後、ダイアログを閉じて、そのダイアログの何もしないデフォルトで続行します。期限を調整または無効にするには、[`dialogExpiry`](/docs/ja/settings-reference#dialogexpiry) を設定してください。Claude Code v2.1.224 以降が必要です。

383* **Fable 使用クレジット同意プロンプトは転送されません**: Claude Code は、セッションが実行される場所でのみ、デバイスではなく、セッション中の [Fable 使用クレジット同意プロンプト](/docs/ja/model-config#fable-and-usage-credits)を表示します。セッションがターミナルで実行され、そこにいる誰もが Claude Code がプロンプトを閉じる前に回答しない場合、ターンはリクエストを送信せずに終了します。[プロンプトの確認が未回答のままでした](/docs/ja/errors#the-prompt-to-confirm-went-unanswered)を参照してください。383* **Fable の使用クレジット同意プロンプトは転送されない**: Claude Code は、セッション中の [Fable の使用クレジット同意プロンプト](/docs/ja/model-config#fable-and-usage-credits)を、デバイス上ではなくセッションが実行されている場所でのみ表示します。セッションがターミナルで実行されていて、Claude Code がプロンプトを閉じる前にそこで誰も回答しなかった場合、ターンはリクエストを送信せずに終了します。[The prompt to confirm went unanswered](/docs/ja/errors#the-prompt-to-confirm-went-unanswered) を参照してください。

384* **一部のコマンドはローカルのみ**: `/plugin` や `/resume` などのターミナルインターフェイスでのみ実行されるコマンドは、引数を渡すかどうかに関わらず、ローカル CLI からのみ機能します。`/claude-api` も、モバイルまたは Web から入力した場合は使用できません。ただし、そこでも Claude は[そのスキルを自ら読み込む](/docs/ja/skills#work-on-claude-api-projects)ことができます。以下はモバイルと Web から機能します。384* **一部のコマンドはローカル専用**: `/plugin` や `/resume` など、ターミナルインターフェースでのみ実行されるコマンドは、引数を渡すかどうかにかかわらず、ローカルの CLI からのみ動作します。`/claude-api` も、モバイルや Web から入力した場合は使用できません。ただし、そこでも Claude は[そのスキルを自ら読み込む](/docs/ja/skills#work-on-claude-api-projects)ことができます。以下はモバイルと Web から動作します。

385 * テキスト出力コマンド: `/compact`、`/clear`、`/context`、`/usage`、`/exit`、`/usage-credits`、`/recap`、および `/reload-plugins`。`/usage-credits` はブラウザを開く代わりに請求 URL を出力します。`/reload-plugins` はセッションがインタラクティブターミナルで実行されている場合にのみ機能します。セッションがない場合は拒否されます。385 * テキスト出力コマンド: `/compact`、`/clear`、`/context`、`/usage`、`/exit`、`/usage-credits`、`/recap`、`/reload-plugins`。`/usage-credits` はブラウザを開く代わりに請求 URL を出力します。`/reload-plugins` は、セッションが対話型ターミナルで実行されている場合にのみ動作します。対話型ターミナルのないセッションではこのコマンドは拒否されます。

386 * `/model`、`/effort`、`/fast`、`/color`、および `/rename`: 値を引数として渡してください。例えば `/model sonnet` または `/effort high`。モバイルと Web から、`/model` と `/effort` は、ターミナルピッカーまたはスライダーの代わりに引数を取ります。386 * `/model`、`/effort`、`/fast`、`/color`、`/rename`: 値を引数として渡します(例: `/model sonnet` や `/effort high`)。モバイルと Web からは、`/model` と `/effort` はターミナルのピッカーやスライダーの代わりに引数を受け取ります。

387 * `/mcp`: モバイルアプリから、ピッカーを開く代わりにサーバーステータスのテキスト概要を返します。Web では、`/mcp` 単独で概要を返す代わりに [claude.ai コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)のディレクトリを開きます。`reconnect`、`enable`、および `disable` [サブコマンド](/docs/ja/commands#all-commands)は両方から機能します。サーバー名なしの `/mcp reconnect` は、失敗したサーバーまたは認証が必要なすべてのサーバーを再試行します。387 * `/mcp`: モバイルアプリからは、ピッカーを開く代わりにサーバーのステータスのテキスト要約を返します。Web では、`/mcp` を単独で実行すると、要約を返す代わりに [claude.ai コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)のディレクトリが開きます。`reconnect`、`enable`、`disable` の[サブコマンド](/docs/ja/commands#all-commands)は、セッションが対話型ターミナルで実行されている場合、どちらからでも動作します。サーバー名を指定しない `/mcp reconnect` は、失敗した、または認証が必要なすべてのサーバーを再試行します。ピッカーを使わずに claude.ai コネクタを認可するには、[シェルからコネクタを再度認可する](#authorize-a-connector-again-from-your-shell)を参照してください。

388 * `/config`: モバイルアプリから、`key=value` を渡して設定を設定するか、引数なしで実行して設定できるキーをリストします。Web では、`/config` は代わりに設定の Claude Code セクションを開き、コマンド後のテキストを無視します。388 * `/config`: モバイルアプリからは、`key=value` を渡して設定を変更するか、引数なしで実行して設定可能なキーを一覧表示します。Web では、`/config` は代わりに設定の Claude Code セクションを開き、コマンドの後のテキストは無視されます。

389 * Team および Enterprise では、モバイルまたは Web から `/usage-credits` は [使用クレジットリクエストを管理者に送信](/docs/ja/costs#add-usage-credits-to-your-subscription)しません。送信にはインタラクティブ CLI にのみ表示される確認が必要なため、コマンドはそこで実行するよう指示します。389 * Team と Enterprise では、モバイルや Web からの `/usage-credits` は[管理者への使用クレジットのリクエスト](/docs/ja/costs#add-usage-credits-to-your-subscription)を送信しません。送信には対話型 CLI でのみ表示される確認が必要なため、このコマンドは代わりにそちらで実行するよう案内します。

390 * `/autocompact`、v2.1.221 から: ウィンドウサイズを引数として渡してください。例えば `/autocompact 500k`。引数がない場合、ターミナルセッションでコマンドが表示するダイアログを開く代わりに、現在のウィンドウサイズをテキストとして出力します。390 * `/autocompact`(v2.1.221 以降): ウィンドウサイズを引数として渡します(例: `/autocompact 500k`)。引数なしの場合、ターミナルセッションでこのコマンドが表示するダイアログを開く代わりに、現在のウィンドウサイズをテキストとして出力します。

391 * `/advisor`、v2.1.260 から: モデルを引数として渡してください。例えば `/advisor opus`、または `off` を渡してアドバイザーをオフにしてください。両方の形式は現在のセッションにのみ適用され、保存されたデフォルトは変わりません。引数がない場合、ピッカーを開く代わりに現在のアドバイザーをテキストとして出力します。391 * `/advisor`(v2.1.260 以降): モデルを引数として渡すか(例: `/advisor opus`)、`off` を渡してアドバイザーをオフにします。どちらの形式も現在のセッションにのみ適用され、保存済みのデフォルトは変更されません。引数なしの場合、ピッカーを開く代わりに現在のアドバイザーをテキストとして出力します。

392 * `/output-style`、v2.1.269 から: スタイル名を引数として渡してください。例えば `/output-style concise`、または引数なしで実行してスタイルをリストします。モバイルと Web から、[組み込みスタイル](/docs/ja/output-styles#built-in-output-styles)のみをリストして選択できます。[カスタムスタイル](/docs/ja/output-styles#create-a-custom-output-style)を使用するには、セッション自体で選択してください。392 * `/output-style`(v2.1.269 以降): スタイル名を引数として渡すか(例: `/output-style concise`)、引数なしで実行してスタイルを一覧表示します。モバイルと Web からは、[組み込みスタイル](/docs/ja/output-styles#built-in-output-styles)のみを一覧表示・選択できます。[カスタムスタイル](/docs/ja/output-styles#create-a-custom-output-style)を使用するには、セッション自体で選択してください。

393 * `/focus`、v2.1.281 から: 引数として `on` または `off` を渡してください。例えば `/focus on`、または引数なしで実行して [フォーカスビュー](/docs/ja/commands#all-commands)を切り替えます。両方の形式は現在のセッションにのみ適用され、保存された選択は変わりません。393 * `/focus`(v2.1.281 以降): `on` または `off` を引数として渡すか(例: `/focus on`)、引数なしで実行して[フォーカスビュー](/docs/ja/commands#all-commands)を切り替えます。どちらの形式も現在のセッションにのみ適用され、保存済みの選択は変更されません。

394 

395<h2 id="authorize-a-connector-again-from-your-shell">

396 シェルからコネクタを再度認可する

397</h2>

398 

399Remote Control で操作しているセッションで claude.ai コネクタの認証が必要になった場合、モバイルアプリや Web からは `/mcp` パネルを利用できません。セッションが実行されているマシン上のターミナルから認可リンクを取得し、使用しているデバイスでそのリンクを開いてください。このコマンドはモバイルアプリや Web からは実行できません。そこから送信した `!` で始まる行は Claude へのメッセージとして送られ、[シェルモード](/docs/ja/interactive-mode#shell-mode-with-prefix)では実行されません。

400 

401<Steps>

402 <Step title="認可リンクを取得する">

403 セッションが実行されているマシン上のターミナル(SSH 経由など)で、コネクタ名を引用符で囲んで `claude mcp login` を実行します。コネクタ名は `claude.ai` で始まります。たとえば Slack コネクタの場合は `claude.ai Slack` です。次のコマンドは Slack コネクタのリンクを取得します。

404 

405 ```bash theme={null}

406 claude mcp login "claude.ai Slack" --no-browser

407 ```

408 

409 このコマンドは claude.ai のリンクを出力して終了します。ブラウザでリンクを開き、claude.ai で認可を完了してください。`--no-browser` を指定すると、コマンドがそのマシン上でブラウザを開かなくなります。そのマシンは、使用しているデバイスとは限らないためです。

410 </Step>

411 

412 <Step title="セッションでコネクタを使用する">

413 新しいセッションを開始するか、すでに実行中のセッションでコネクタを再接続します。

414 

415 * **新しいセッション**:認可後に開始したセッションは、追加の手順なしでコネクタに接続します。

416 * **実行中のセッション**:Claude Code のプロンプトで、またはモバイルアプリや Web から、同じ名前を引用符なしで指定して `/mcp reconnect` を実行します。セッションがモバイルアプリや Web からこのコマンドを受け付けるかどうかを確認するには、[モバイルと Web から使用できるコマンド](#limitations)の `/mcp` の項目を参照してください。

417 

418 次のコマンドは Slack コネクタを再接続します。

419 

420 ```text theme={null}

421 /mcp reconnect claude.ai Slack

422 ```

423 

424 ターミナルでは、Claude Code が `Successfully reconnected to claude.ai Slack` と出力します。モバイルアプリや Web からの場合、応答は `Reconnected "claude.ai Slack".` です。

425 </Step>

426</Steps>

394 427 

395<h2 id="troubleshooting">428<h2 id="troubleshooting">

396 トラブルシューティング429 トラブルシューティング

Details

191 ジッター191 ジッター

192</h3>192</h3>

193 193 

194すべてのセッションが同じ壁時計の瞬間に API にヒットするのを避けるために、スケジューラは実行時刻に決定論的オフセットを追加します。194スケジュールタスクは、スケジュールで指定された時刻とは異なる時刻に実行されることがあります。すべてのセッションのタスクが正確にスケジュールどおりに実行されると、多くのタスクが同じ瞬間に API を呼び出すことになるため、Claude Code は各タスクの実行時刻をずらします。定期的なタスクは遅れて実行され、毎時 0 分または 30 分にスケジュールされた 1 回限りのタスクは少し早く実行されます。

195 195 

196* 定期的なタスクは、スケジュール済み時刻の最大 30 分後に実行されます(または 1 時間より頻繁に実行されるタスクの場合は間隔の最大半分)。時間ごとのジョブがスケジュール済みの `:00` は `:30` までのどこかで実行される可能性があります。196<h4 id="how-late-a-recurring-task-runs">

197* 時間の上部または下部にスケジュール済みの 1 回限りのタスクは、最大 90 秒早く実行されます。197 定期的なタスクがどれだけ遅れて実行されるか

198</h4>

198 199 

199オフセットはタスク ID から派生しているため、同じタスクは常に同じオフセットを取得します。正確なタイミングが重要な場合は、`0 9 * * *` ではなく `3 9 * * *` など、`:00` または `:30` ではない分を選択すると、1 回限りのジッターは適用されません。200定期的なタスクを作成すると、Claude Code はそのタスクに固定の遅延を割り当て、すべての実行にその遅延を加えます。遅延はタスクの ID から算出されるため、同じタスクは毎回同じ分数だけ遅れて実行されます。これは、セッションがアイドル状態で他に何も実行されていない場合も同様です。

201 

202より頻繁に実行されるタスクほど遅延は短くなり、タスクに割り当てられる遅延は最長で 30 分です。一般的なスケジュールにおける遅延の範囲は次のとおりです。

203 

204| タスクの実行頻度 | 遅延の範囲 |

205| :- | :- |

206| 10 分ごと | 0〜5 分 |

207| 30 分ごと | 0〜15 分 |

208| 1 時間ごと、または毎日などそれより低い頻度 | 0〜30 分 |

209 

210たとえば、`7,37 * * * *` はタスクを `:07` と `:37` にスケジュールします。この 2 つは 30 分間隔なので、遅延は 0〜15 分のいずれかになります。このタスクの遅延が 14 分の場合、毎時 `:21` と `:51` に実行されます。スケジュールを別の分に変更すると実行時刻は移動しますが、その場合も遅延は上乗せされます。

211 

212<h4 id="when-a-one-shot-task-runs-early">

213 1 回限りのタスクが早く実行される場合

214</h4>

215 

216`:00` または `:30` にスケジュールされた 1 回限りのタスクは、最大 90 秒早く実行されます。Claude Code はそれ以外の分にスケジュールされた 1 回限りのタスクの実行時刻はずらさないため、タイミングが重要な場合は、`0 9 * * *` ではなく `3 9 * * *` のように、毎時 0 分と 30 分を避けてスケジュールしてください。

200 217 

201<h3 id="seven-day-expiry">218<h3 id="seven-day-expiry">

202 7 日間の有効期限219 7 日間の有効期限

Details

74 74 

75各レイヤーは [独自のルールを追加](#add-your-own-rules) することで拡張できます。組み込みチェックは個別に削除することはできませんが、各レイヤーは [独立して無効化](#disable-or-uninstall) できます。75各レイヤーは [独自のルールを追加](#add-your-own-rules) することで拡張できます。組み込みチェックは個別に削除することはできませんが、各レイヤーは [独立して無効化](#disable-or-uninstall) できます。

76 76 

77<h3 id="on-each-file-edit">77<span id="on-each-file-edit" />

78 各ファイル編集時78 

79<h3 id="checks-on-each-file-edit">

80 各ファイル編集時のチェック

79</h3>81</h3>

80 82 

81Claude がファイルに書き込むと、プラグインは新しいコンテンツをスキャンして既知のリスキーなパターンを探します。これはモデル呼び出しのないパターンマッチなので、使用コストは追加されません。83Claude がファイルに書き込むと、プラグインは新しいコンテンツをスキャンして既知のリスキーなパターンを探します。これはモデル呼び出しのないパターンマッチなので、使用コストは追加されません。


91 93 

92`security-patterns.yaml` ファイルを使用して、このレイヤーに [独自のパターンを追加](#add-custom-per-edit-patterns) できます。94`security-patterns.yaml` ファイルを使用して、このレイヤーに [独自のパターンを追加](#add-custom-per-edit-patterns) できます。

93 95 

94<h3 id="at-the-end-of-each-turn">96<span id="at-the-end-of-each-turn" />

95 各ターンの終了時97 

98<h3 id="checks-at-the-end-of-each-turn">

99 各ターンの終了時のチェック

96</h3>100</h3>

97 101 

98ターンは Claude が応答する 1 ラウンドです:メッセージを送信し、Claude が作業して返信し、ターンが終了します。各ターンの後、プラグインはターン中に作業ツリーで変更されたすべてのもの(Claude の編集ツール、Bash コマンド、サブエージェントからの変更を含む)の git diff を計算し、セキュリティに焦点を当てた別の Claude レビューに送信します。レビューはバックグラウンドで実行されるため、Claude の返信は遅延しません。レビューが問題を見つけた場合、Claude は結果を使用して再度プロンプトされ、フォローアップとして対処します。102ターンは Claude が応答する 1 ラウンドです:メッセージを送信し、Claude が作業して返信し、ターンが終了します。各ターンの後、プラグインはターン中に作業ツリーで変更されたすべてのもの(Claude の編集ツール、Bash コマンド、サブエージェントからの変更を含む)の git diff を計算し、セキュリティに焦点を当てた別の Claude レビューに送信します。レビューはバックグラウンドで実行されるため、Claude の返信は遅延しません。レビューが問題を見つけた場合、Claude は結果を使用して再度プロンプトされ、フォローアップとして対処します。


107 111 

108セッションで直接、結果と Claude の解決策の両方が表示されます。レビューはターンごとに最大 30 個の変更されたファイルをカバーし、最大 3 回連続で発火してからあなたに戻ります。112セッションで直接、結果と Claude の解決策の両方が表示されます。レビューはターンごとに最大 30 個の変更されたファイルをカバーし、最大 3 回連続で発火してからあなたに戻ります。

109 113 

110<h3 id="on-each-commit-or-push-claude-makes">114<span id="on-each-commit-or-push-claude-makes" />

111 Claude が行う各コミットまたはプッシュ時115 

116<h3 id="checks-on-each-commit-or-push-claude-makes">

117 Claude が行う各コミットまたはプッシュ時のチェック

112</h3>118</h3>

113 119 

114Claude が Bash ツールを通じて `git commit` または `git push` を実行すると、プラグインはバックグラウンドで変更の深い agentic レビューを実行します。このレビューは、呼び出し元、サニタイザー、関連ファイルを含む周囲のコードを読んで、結果が実際のものであるかどうかを判断してから報告します。追加のコンテキストは、分離されたときは危険に見えるが、コードベースでは安全なパターンの偽陽性を低く保ちます。120Claude が Bash ツールを通じて `git commit` または `git push` を実行すると、プラグインはバックグラウンドで変更の深い agentic レビューを実行します。このレビューは、呼び出し元、サニタイザー、関連ファイルを含む周囲のコードを読んで、結果が実際のものであるかどうかを判断してから報告します。追加のコンテキストは、分離されたときは危険に見えるが、コードベースでは安全なパターンの偽陽性を低く保ちます。

Details

403 403 

404* 標準のシステムパスにあるエンタープライズスコープの[管理 MCP ファイル](/docs/ja/managed-mcp):Linux のランナーホストでは `/etc/claude-code/managed-mcp.json`、macOS のホストでは `/Library/Application Support/ClaudeCode/managed-mcp.json` です。管理者が列挙したサーバーのみを読み込めるようにする、ロックダウンされたフリートで使用します。優先順位のルールについては、[managed-mcp.json による排他的な制御](/docs/ja/managed-mcp#exclusive-control-with-managed-mcp-json)を参照してください。このファイルがランナーホスト上にある場合、Claude Code は claude.ai のコネクタを含め、Anthropic のコントロールプレーンがセッションに配信する MCP サーバーをスキップし、セッションの子プロセスの stderr に出力される警告でそれらの名前を示します。ランナーはこの警告を `debug` ログレベルで記録します。v2.1.229 より前は、これらのセッションは起動時に `You cannot dynamically configure MCP servers when an enterprise MCP config is present` というメッセージを出して終了していました。404* 標準のシステムパスにあるエンタープライズスコープの[管理 MCP ファイル](/docs/ja/managed-mcp):Linux のランナーホストでは `/etc/claude-code/managed-mcp.json`、macOS のホストでは `/Library/Application Support/ClaudeCode/managed-mcp.json` です。管理者が列挙したサーバーのみを読み込めるようにする、ロックダウンされたフリートで使用します。優先順位のルールについては、[managed-mcp.json による排他的な制御](/docs/ja/managed-mcp#exclusive-control-with-managed-mcp-json)を参照してください。このファイルがランナーホスト上にある場合、Claude Code は claude.ai のコネクタを含め、Anthropic のコントロールプレーンがセッションに配信する MCP サーバーをスキップし、セッションの子プロセスの stderr に出力される警告でそれらの名前を示します。ランナーはこの警告を `debug` ログレベルで記録します。v2.1.229 より前は、これらのセッションは起動時に `You cannot dynamically configure MCP servers when an enterprise MCP config is present` というメッセージを出して終了していました。

405* ランナーホスト上の[管理設定](/docs/ja/managed-settings)にある [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) キー:排他的な制御を行わずに HTTP および SSE サーバーを提供するため、ほかのソースからのサーバーも引き続き読み込まれます。Claude Code v2.1.259 以降が必要です。405* ランナーホスト上の[管理設定](/docs/ja/managed-settings)にある [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) キー:排他的な制御を行わずに HTTP および SSE サーバーを提供するため、ほかのソースからのサーバーも引き続き読み込まれます。Claude Code v2.1.259 以降が必要です。

406* `<repo>/.mcp.json`:プロジェクトスコープです。このファイルをリポジトリにコミットしてください。そのサーバーはクラウドセッションで自動承認されます。406* `<repo>/.mcp.json`:プロジェクトスコープです。このファイルをリポジトリにコミットしてください。そのサーバーはクラウドセッションで自動承認されます。複数のリポジトリを含むセッションでは、[読み込まれるのは最大 1 つのリポジトリのファイルのみです](#repository-settings-in-sessions-with-several-repositories)。

407 407 

408組織でコネクタ配信が有効になっている場合、Anthropic のコントロールプレーンは、claude.ai で設定したコネクタを、サーバーが提供する MCP 設定を通じて対話的に作成されたセッションに配信します。この配信は `api.anthropic.com` を経由します。[CLI からのディスパッチ](/docs/ja/self-hosted-environments-testing#run-the-test-loop)のようにプログラムで作成されたセッションには、コネクタは配信されません。そうしたセッションには、このセクションで挙げたほかのいずれかのソースを通じて MCP サーバーを提供してください。子プロセスの OAuth トークンにはコネクタを直接取得するためのスコープが含まれていないため、子プロセスが自らその取得を試みることはありません。配信はサーバー主導で行われます。408組織でコネクタ配信が有効になっている場合、Anthropic のコントロールプレーンは、claude.ai で設定したコネクタを、サーバーが提供する MCP 設定を通じて対話的に作成されたセッションに配信します。この配信は `api.anthropic.com` を経由します。[CLI からのディスパッチ](/docs/ja/self-hosted-environments-testing#run-the-test-loop)のようにプログラムで作成されたセッションには、コネクタは配信されません。そうしたセッションには、このセクションで挙げたほかのいずれかのソースを通じて MCP サーバーを提供してください。子プロセスの OAuth トークンにはコネクタを直接取得するためのスコープが含まれていないため、子プロセスが自らその取得を試みることはありません。配信はサーバー主導で行われます。

409 409 


546exit 0546exit 0

547```547```

548 548 

549フックはセッション終了前に Claude にコミットしてプッシュするよう促し、ディレクトリが git リポジトリではないか、リモートがない場合は静かに留まります。549フックはセッション終了前に Claude にコミットしてプッシュするよう促し、ディレクトリが git リポジトリではないか、リモートがない場合は静かに留まります。複数のリポジトリを含むセッションについては、[`$CLAUDE_PROJECT_DIR` が指すもの](#repository-settings-in-sessions-with-several-repositories)を参照してください。

550 550 

551<h2 id="permissions-and-tool-approval">551<h2 id="permissions-and-tool-approval">

552 権限とツール承認552 権限とツール承認


575 575 

576`SELF_HOSTED_RUNNER_HOST_CONFIG_DIR` を設定して別のパスからシードするか、空のディレクトリに指定してシーディングを無効にします。576`SELF_HOSTED_RUNNER_HOST_CONFIG_DIR` を設定して別のパスからシードするか、空のディレクトリに指定してシーディングを無効にします。

577 577 

578リポジトリコミット `.claude/settings.json` はプロジェクト設定として上に層状化されます。セッションはランナーイメージの標準システムパスから [`managed-settings.json`](/docs/ja/settings#where-settings-live) も読み取ります。そのキーが [サーバー管理設定](/docs/ja/server-managed-settings) と一緒に適用されるかどうかは、[Claude Code が管理ソースを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) に従います。デフォルトでは、組織が任意のサーバー管理キーを配信する場合、セッションは [Claude Code がすべての管理ソースから読み取るキー](/docs/ja/managed-settings#keys-read-from-every-admin-source)(`env` ブロック、サンドボックスロック、サンドボックスバイナリパス、`forceRemoteSettingsRefresh` など)を除いて、ランナーイメージのファイルを無視します。[設定優先順位](/docs/ja/settings#settings-precedence) を参照してください。578リポジトリコミット `.claude/settings.json` はプロジェクト設定として上に層状化されます。複数のリポジトリを含むセッションでは、[有効になるのは最大 1 つのリポジトリのファイルのみです](#repository-settings-in-sessions-with-several-repositories)。セッションはランナーイメージの標準システムパスから [`managed-settings.json`](/docs/ja/settings#where-settings-live) も読み取ります。そのキーが [サーバー管理設定](/docs/ja/server-managed-settings) と一緒に適用されるかどうかは、[Claude Code が管理ソースを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) に従います。デフォルトでは、組織が任意のサーバー管理キーを配信する場合、セッションは [Claude Code がすべての管理ソースから読み取るキー](/docs/ja/managed-settings#keys-read-from-every-admin-source)(`env` ブロック、サンドボックスロック、サンドボックスバイナリパス、`forceRemoteSettingsRefresh` など)を除いて、ランナーイメージのファイルを無視します。[設定優先順位](/docs/ja/settings#settings-precedence) を参照してください。

579 579 

580Anthropic のコントロールプレーンがセッションに [Claude Code フック](/docs/ja/hooks) を提供する場合、ランナーはそれらを独自の設定の上ではなく隣に設定します。Claude Code v2.1.229 以降が必要です。580Anthropic のコントロールプレーンがセッションに [Claude Code フック](/docs/ja/hooks) を提供する場合、ランナーはそれらを独自の設定の上ではなく隣に設定します。Claude Code v2.1.229 以降が必要です。

581 581 


587 587 

588ランナーによるホストの `~/.claude/` のスナップショットには `projects/` ディレクトリは含まれません。自動メモリのデフォルトの保存場所はこのディレクトリの下にあります。そこにメモリファイルを置いても、ランナーはそれらをセッションにシードせず、自動メモリがオンになることもありません。588ランナーによるホストの `~/.claude/` のスナップショットには `projects/` ディレクトリは含まれません。自動メモリのデフォルトの保存場所はこのディレクトリの下にあります。そこにメモリファイルを置いても、ランナーはそれらをセッションにシードせず、自動メモリがオンになることもありません。

589 589 

590<h3 id="repository-settings-in-sessions-with-several-repositories">

591 複数のリポジトリを含むセッションでのリポジトリ設定

592</h3>

593 

594複数のリポジトリを含むセッションでは、Claude Code はセッションの開始ディレクトリからプロジェクト設定を読み取るため、プロジェクト設定として有効になるのは最大 1 つのリポジトリの `.claude/settings.json` のみです。別のリポジトリのファイルで定義されたフックは実行されず、そのファイル内の拒否ルールは適用されず、その `env` も設定されません。

595 

596* **`--capacity 1`(デフォルト)と組み込みのチェックアウトを使用する場合**:セッションはリポジトリリストの最初のリポジトリで開始します。そのリポジトリの `.claude/settings.json` がプロジェクト設定として有効になり、その `.mcp.json` が読み込まれますが、他のリポジトリのものは有効にならず、読み込まれません。

597* **1 より大きい `--capacity`、または [`checkout` フック](#checkout) を使用する場合**:セッションはチェックアウトを含むセッションごとのディレクトリで開始します。どのリポジトリの `.claude/settings.json` もプロジェクト設定として有効にならず、どのリポジトリの `.mcp.json` も読み込まれず、フックコマンド内の [`$CLAUDE_PROJECT_DIR`](/docs/ja/hooks#reference-scripts-by-path) はチェックアウトではなくそのディレクトリになります。

598 

599各リポジトリの `CLAUDE.md` とスキルは、セッションがどこで開始しても読み込まれます。ランナーはすべてのリポジトリを [追加ディレクトリ](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) として Claude Code に渡すため、Claude Code は各リポジトリの `.claude/settings.json` から `enabledPlugins` キーと `extraKnownMarketplaces` キーも読み取ります。

600 

601すべてのセッションでフックを実行したり権限ルールを適用したりするには、ランナーホストの `~/.claude/settings.json` に記述します。ランナーは、セッションがどこで開始しても、[ホストのファイルをすべてのセッションにシードします](#how-each-session’s-config-is-assembled)。`Read` ルールまたは `Edit` ルールのパスは、`//` による絶対パスまたは `~/` によるホーム相対の [パターン](/docs/ja/permissions#read-and-edit) として記述してください。それ以外のパターンは設定ソースまたは現在のディレクトリを基準とするためです。

602 

590<h3 id="repository-committed-permission-rules">603<h3 id="repository-committed-permission-rules">

591 リポジトリコミット権限ルール604 リポジトリコミット権限ルール

592</h3>605</h3>

Details

92 92 

93 <Step title="保存してデプロイする">93 <Step title="保存してデプロイする">

94 変更を保存します。Claude Code クライアントは、次回の起動時または 1 時間ごとのポーリングサイクルで更新された設定を受け取ります。94 変更を保存します。Claude Code クライアントは、次回の起動時または 1 時間ごとのポーリングサイクルで更新された設定を受け取ります。

95 

96 エディターは、公開されている Claude Code 設定の JSON スキーマに照らして JSON をチェックします。解析可能な JSON に問題が見つかった場合は、警告が表示され、保存ボタンのラベルが変わります。設定がすでに保存されている場合のラベルは **Update with errors**、まだ設定が保存されていない場合は **Add with errors** です。スキーマの警告は保存をブロックしないため、このボタンでも保存は行われます。

97 

98 スキーマは[最新リリースに追従していない場合がある](/docs/ja/settings#edit-a-settings-file)ため、エディターが[設定リファレンス](/docs/ja/settings-reference#all-settings)に記載されているキーや値を警告することがあります。Claude Code は保存されたキーと値を受け取り、読み込む際に[独自の検証](#invalid-entries-in-delivered-settings)を実行します。

95 </Step>99 </Step>

96</Steps>100</Steps>

97 101 

settings.md +35 −35

Details

404 404 

405| スコープ | ファイル | 誰に影響するか | 用途 |405| スコープ | ファイル | 誰に影響するか | 用途 |

406| :- | :- | :- | :- |406| :- | :- | :- | :- |

407| ユーザー | `~/.claude/settings.json` | あなた、このマシン上のすべてのプロジェクト | 個人設定:テーマ、エディターモード、デフォルトモデル、独自の権限ルール |407| ユーザー | `~/.claude/settings.json` | 自分自身、このマシン上のすべてのプロジェクト | 個人設定:テーマ、エディターモード、デフォルトモデル、独自の権限ルール |

408| 共有プロジェクト | `.claude/settings.json` | このフォルダを含むフォルダで作業しているすべての人。git リポジトリでは、コミットしてチームメイトが取得できるようにします | チーム権限、hooks、プラグイン、およびプロジェクトが必要とする環境変数 |408| 共有プロジェクト | `.claude/settings.json` | このファイルを含むフォルダで作業しているすべての人。git リポジトリでは、コミットしてチームメイトが取得できるようにします | チーム権限、フック、プラグイン、およびプロジェクトが必要とする環境変数 |

409| プロジェクトローカル | `.claude/settings.local.json` | あなた、このプロジェクトのみ。Claude Code はファイルを作成するときに git から除外します。手動で作成する場合は、自分で `.gitignore` に追加してください | 1 つのプロジェクトの個人的なオーバーライド、および共有する前のテスト |409| プロジェクトローカル | `.claude/settings.local.json` | 自分自身、このプロジェクトのみ。Claude Code はファイルを作成するときに git から除外します。手動で作成する場合は、自分で `.gitignore` に追加してください | 1 つのプロジェクトでの個人的な上書き、および共有する前のテスト |

410| 管理 | `managed-settings.json` およびその他の[管理ソース](/docs/ja/managed-settings#delivery-mechanisms) | 組織がデプロイするすべての人。何がこれを上書きできるかは[設定の優先順位](#settings-precedence)を参照してください | セキュリティポリシーおよびコンプライアンス要件 |410| 管理 | `managed-settings.json` およびその他の[管理ソース](/docs/ja/managed-settings#delivery-mechanisms) | 組織がデプロイするすべての人。何がこれを上書きできるかは[設定の優先順位](#settings-precedence)を参照してください | セキュリティポリシーおよびコンプライアンス要件 |

411 411 

412ファイル列では、`~/.claude` はホームディレクトリの `.claude` フォルダ、ベアの `.claude` はプロジェクト内の `.claude` フォルダです。412ファイル列では、`~/.claude` はホームディレクトリの `.claude` フォルダ、パスなしの `.claude` はプロジェクト内の `.claude` フォルダです。

413 413 

414<span id="where-each-file-applies" />414<span id="where-each-file-applies" />

415 415 


425 425 

426<SettingsScope />426<SettingsScope />

427 427 

428* **`~/.claude/settings.json`**:マシン上のすべてのプロジェクト、チームメイトまたはクラウドセッションには何もありません428* **`~/.claude/settings.json`**:自分のマシン上のすべてのプロジェクト。チームメイトのクローンやクラウドセッションには適用されません

429* **`acme-app/.claude/settings.json`**:あなたの `acme-app/`。バージョン管理にファイルをコミットする場合のみ、チームメイトのクローンとクラウドセッションに到達します。それまでは、他のファイルのようにディスク上のファイルであり、誰も持っていません429* **`acme-app/.claude/settings.json`**:自分の `acme-app/`。バージョン管理にファイルをコミットした場合のみ、チームメイトのクローンとクラウドセッションに到達します。それまでは、ディスク上の他のファイルと同じ単なるファイルであり、他の誰も持っていません

430* **`acme-app/.claude/settings.local.json`**:あなたの `acme-app/` のみ。Claude Code はファイルを初めて書き込むときに、グローバル git 除外に追加するため、コミットから除外されます。手動でファイルを作成する場合は、[自分で `.gitignore` に追加してください](#keep-personal-settings-out-of-a-repository)430* **`acme-app/.claude/settings.local.json`**:自分の `acme-app/` のみ。Claude Code はファイルを初めて書き込むときに、グローバル git 除外に追加するため、コミットから除外されます。手動でファイルを作成する場合は、[自分で `.gitignore` に追加してください](#keep-personal-settings-out-of-a-repository)

431* **管理設定**。`managed-settings.json` ファイル、MDM ポリシー、または claude.ai コンソールからの[サーバー管理設定](/docs/ja/server-managed-settings):組織がデプロイするすべてのマシン上のすべてのプロジェクト、またはあなたの組織アカウントでサインインするマシン。サーバー管理設定のみがクラウドセッションに到達します431* **管理設定**。`managed-settings.json` ファイル、MDM ポリシー、または claude.ai コンソールからの[サーバー管理設定](/docs/ja/server-managed-settings):組織がデプロイするすべてのマシン、または組織アカウントでサインインするマシン上のすべてのプロジェクト。クラウドセッションに到達するのはサーバー管理設定のみです

432 432 

433<span id="which-files-you-have" />433<span id="which-files-you-have" />

434 434 


436 設定ファイルを見つけるか作成する436 設定ファイルを見つけるか作成する

437</h3>437</h3>

438 438 

439Claude Code をインストールしても、設定ファイルは作成されません。マシンまたはプロジェクトに既に 1 つある場合は、これらのソースの 1 つから来ました:439Claude Code をインストールしても、設定ファイルは作成されません。マシンまたはプロジェクトに既に設定ファイルがある場合は、次のいずれかのソースから来たものです:

440 440 

441* **管理**:組織がデプロイします。作成または編集しません。441* **管理**:組織がデプロイします。自分で作成または編集することはありません。

442* **共有プロジェクト**:Claude Code を既に使用しているプロジェクトにはコミットされたものがあるかもしれません。ない場合は、プロジェクトフォルダに `.claude/settings.json` で作成してください。442* **共有プロジェクト**:Claude Code を既に使用しているプロジェクトには、コミットされたものがあるかもしれません。ない場合は、プロジェクトフォルダに `.claude/settings.json` として作成してください。

443* **ユーザー**および**プロジェクトローカル**:自分で作成するか、Claude Code に作成させます。テーマなどのユーザー設定に保存する `/config` メニューのオプションを初めて変更するときに `~/.claude/settings.json` を書き込み、Bash コマンドに対して「はい、今後は聞かないでください」などの権限プロンプトで立ったままの承認を初めて与えるときに `.claude/settings.local.json` を書き込みます。**ヒントを表示**を含むいくつかの `/config` オプションは、ユーザーファイルの代わりに `.claude/settings.local.json` に保存されます。443* **ユーザー**および**プロジェクトローカル**:自分で作成するか、Claude Code に作成させます。テーマなど、ユーザー設定に保存される `/config` メニューのオプションを初めて変更するときに `~/.claude/settings.json` を書き込み、Bash コマンドに対する「はい、今後は聞かないでください」など、権限プロンプトで恒久的な承認を初めて与えるときに `.claude/settings.local.json` を書き込みます。**ヒントを表示**を含むいくつかの `/config` オプションは、ユーザーファイルではなく `.claude/settings.local.json` に保存されます。

444 444 

445<Info>445<Info>

446 Windows では、`~/.claude` は `%USERPROFILE%\.claude` を意味します。ホームディレクトリファイルを別の場所に保つには、[`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars) を設定してください。Claude Code はその代わりに設定、セッション履歴、およびプラグインをそこに保存します。446 Windows では、`~/.claude` は `%USERPROFILE%\.claude` を意味します。ホームディレクトリのファイルを別の場所に保存するには、[`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars) を設定してください。Claude Code は設定、セッション履歴、およびプラグインを代わりにそこに保存します。

447</Info>447</Info>

448 448 

449Claude Code は、[`~/.claude.json`](/docs/ja/claude-directory#ce-claude-json) という 5 番目のファイルも保持します。これは自分で書き込みます。編集する必要はありません。サインインセッション、[MCP サーバー](/docs/ja/mcp)構成、信頼決定などのプロジェクトごとの状態、および `/config` があなたのために書き込む[グローバル構成キー](/docs/ja/settings-reference#global-config-settings)を保持します。449Claude Code は、[`~/.claude.json`](/docs/ja/claude-directory#ce-claude-json) という 5 番目のファイルも保持します。これは Claude Code 自身が書き込むもので、編集する必要はありません。サインインセッション、[MCP サーバー](/docs/ja/mcp)の設定、信頼の決定などのプロジェクトごとの状態、および `/config` が書き込む[グローバル設定キー](/docs/ja/settings-reference#global-config-settings)を保持します。

450 450 

451<h3 id="share-settings-with-your-team">451<h3 id="share-settings-with-your-team">

452 チームと設定を共有する452 チームと設定を共有する

453</h3>453</h3>

454 454 

455`.claude/settings.json` をコミットして、リポジトリをクローンするすべての人が同じ権限、hooks、およびプラグインを取得するようにします。各チームメイトは、個人的な例外がコミットを必要としないように、独自の `.claude/settings.local.json` でそれをオーバーライドできます。完全なチームファイルについては、[チームの共有設定](/docs/ja/settings-example#a-teams-shared-settings)を参照してください。455`.claude/settings.json` をコミットして、リポジトリをクローンするすべての人が同じ権限、フック、およびプラグインを取得するようにします。各チームメイトは、独自の `.claude/settings.local.json` で自分用にそれを上書きできるため、個人的な例外にコミットは必要ありません。完全なチームファイルについては、[チームの共有設定](/docs/ja/settings-example#a-teams-shared-settings)を参照してください。

456 456 

457コミットするものの一部は、各チームメイトが[フォルダを信頼する](/docs/ja/permissions#project-allow-rules-and-workspace-trust)まで待機し、いくつかのキーはリポジトリファイルから効果を発揮しません。[適用されない設定をトラブルシューティングする](#common-cases)は両方をカバーしています。457コミットするものの一部は、各チームメイトが[フォルダを信頼する](/docs/ja/permissions#project-allow-rules-and-workspace-trust)まで待機し、いくつかのキーはリポジトリファイルからは決して有効になりません。[適用されない設定をトラブルシューティングする](#common-cases)で両方を説明しています。

458 458 

459<span id="local-settings-file" />459<span id="local-settings-file" />

460 460 


468 リポジトリから個人設定を除外する468 リポジトリから個人設定を除外する

469</h3>469</h3>

470 470 

471プロジェクト内で自分の設定を変更し、チームメイトの設定を変更しないようにするには、プロジェクト内の `.claude/settings.local.json` に保存してください。Claude Code はそのファイルをコミットされた `.claude/settings.json` に適用するため、チームのファイルが `"model": "claude-sonnet-5"` を設定し、Opus が必要な場合は、ローカルファイルに `"model": "claude-opus-5-5"` を入れて、セッションのみを変更します。4711 つのプロジェクトで、チームメイトの設定を変えずに自分の設定だけを変更するには、プロジェクト内の `.claude/settings.local.json` に保存してください。Claude Code はそのファイルをコミットされた `.claude/settings.json` の上に適用するため、チームのファイルが `"model": "claude-sonnet-5"` を設定していて Opus を使いたい場合は、ローカルファイルに `"model": "claude-opus-5-5"` を入れれば、自分のセッションだけが変わります。

472 472 

473Claude Code もこのファイルに書き込み、コミットから除外し、信頼ステップなしに allow ルールを適用します:473Claude Code もこのファイルに書き込み、コミットから除外し、信頼ステップなしでその許可ルールを適用します:

474 474 

475* **Claude Code もそれを書き込みます。** Claude が Bash コマンドを実行する権限を求め、「はい、今後は聞かないでください」を選択すると、Claude Code はその[権限承認](/docs/ja/permissions#permission-system)をここに `allow` ルールとして保存します。475* **Claude Code もこのファイルに書き込みます。** Claude が Bash コマンドを実行する権限を求め、「はい、今後は聞かないでください」を選択すると、Claude Code はその[権限の承認](/docs/ja/permissions#permission-system)をここに `allow` ルールとして保存します。

476* **手動で作成した場合を除き、自分で gitignore する必要はありません。** Claude Code がリポジトリでファイルを初めて書き込むときに、既にそれを無視していない場合、グローバル git 除外ファイルに `**/.claude/settings.local.json` を追加するため、ファイルはすべてのリポジトリのコミットから除外されます。そのファイルは、グローバル git 構成がそれを絶対パスまたは `~` プレフィックス付きパスに設定する場合は `core.excludesFile`。それ以外の場合は `$XDG_CONFIG_HOME/git/ignore`、または `XDG_CONFIG_HOME` が設定されていない場合は `~/.config/git/ignore`。手動でファイルを作成し、Claude Code がまだそれに書き込んでいない場合は、自分で `.gitignore` に追加してください。476* **手動で作成した場合を除き、自分で gitignore する必要はありません。** Claude Code が、まだこのファイルを無視していない git リポジトリでファイルを初めて書き込むときに、グローバル git 除外ファイルに `**/.claude/settings.local.json` を追加するため、ファイルはすべてのリポジトリでコミットから除外されます。そのファイルは、グローバル git 設定で `core.excludesFile` が絶対パスまたは `~` で始まるパスに設定されている場合はそのファイル、それ以外の場合は `$XDG_CONFIG_HOME/git/ignore`、`XDG_CONFIG_HOME` が設定されていない場合は `~/.config/git/ignore` です。手動でファイルを作成し、Claude Code がまだそれに書き込んでいない場合は、自分で `.gitignore` に追加してください。

477* **ファイルが追跡されていない間、その allow ルールは信頼を待ちません。** ファイルはリポジトリのものではなくあなたのものであるため、Claude Code はコミットされたファイルが必要とする[ワークスペース信頼](/docs/ja/permissions#project-allow-rules-and-workspace-trust)ステップなしにその `allow` ルールを適用します。ファイルが git で追跡されている場合、信頼ステップもそれに適用されます。[ローカル設定ファイルが信頼を必要とする場合](/docs/ja/permissions#when-your-local-settings-file-needs-trust)を参照してください。477* **ファイルが追跡されていない間、その許可ルールは信頼を待ちません。** ファイルはリポジトリのものではなく自分のものであるため、Claude Code はコミットされたファイルに必要な[ワークスペースの信頼](/docs/ja/permissions#project-allow-rules-and-workspace-trust)ステップなしで、その `allow` ルールを適用します。ファイルが git で追跡されている場合は、信頼ステップがこのファイルにも適用されます。[ローカル設定ファイルが信頼を必要とする場合](/docs/ja/permissions#when-your-local-settings-file-needs-trust)を参照してください。

478 478 

479<span id="where-claude-code-looks-for-each-file" />479<span id="where-claude-code-looks-for-each-file" />

480 480 


486 Claude Code が git リポジトリでローカルファイルを保持する場所486 Claude Code が git リポジトリでローカルファイルを保持する場所

487</h4>487</h4>

488 488 

489Claude が Bash コマンドを実行する権限を求め、「はい、今後は聞かないでください」を選択すると、Claude Code はその承認を `.claude/settings.local.json` の `allow` ルールとして保存します。git リポジトリのサブディレクトリから Claude Code を開始する場合、リポジトリルートでそのファイルを読み取り、書き込み、リポジトリ全体に承認を適用します。[worktree](/docs/ja/worktrees) では、メインチェックアウトのルートのファイルを使用します。489Claude が Bash コマンドを実行する権限を求め、「はい、今後は聞かないでください」を選択すると、Claude Code はその承認を `.claude/settings.local.json` の `allow` ルールとして保存します。git リポジトリのサブディレクトリで Claude Code を開始した場合、リポジトリルートにあるそのファイルを読み書きし、承認をリポジトリ全体に適用します。[worktree](/docs/ja/worktrees) では、メインチェックアウトのルートにあるファイルを使用します。

490 490 

4912 つのルールがルートの場所を適格にします:491ルートの場所には 2 つの条件があります:

492 492 

493* **ファイルが `.claude/settings.json` の代わりに留まる場合**:git リポジトリの外、リポジトリルートがホームディレクトリ、Windows、またはリポジトリルート、その `.git` またはその `.claude` エントリがユーザーによって所有されていない場合。493* **ファイルが代わりに `.claude/settings.json` と同じ場所に置かれる場合**:git リポジトリの外、リポジトリルートがホームディレクトリである場合、Windows の場合、またはリポジトリルートやその `.git` または `.claude` エントリの所有者が自分のユーザーでない場合。

494* **ファイル内のパスはリポジトリルートに固定されません**:`/` で始まる権限ルール、または相対サンドボックスパスは、[セッションのプライマリ作業ディレクトリ](/docs/ja/permissions#read-and-edit)に固定されます。494* **ファイル内のパスはリポジトリルートを基準にしません**:`/` で始まる権限ルールや相対サンドボックスパスは、代わりに[セッションのプライマリ作業ディレクトリを基準にします](/docs/ja/permissions#read-and-edit)。

495 495 

496v2.1.211 より前では、Claude Code は開始ディレクトリにファイルを保持していました。以前のバージョンが残したファイルをルートファイルと並行して読み込みます。両方が同じキーを設定する場合、ルートの値が適用され、両方のファイルからの権限ルールが適用されます。Agent SDK の [`resolveSettings()`](/docs/ja/agent-sdk/typescript#resolvesettings) ヘルパーは常に開始ディレクトリからファイルを読み込みます。496v2.1.211 より前では、Claude Code は開始ディレクトリにファイルを保持していました。以前のバージョンがそこに残したファイルも、ルートのファイルと併せて読み込みます。両方が同じキーを設定している場合はルートの値が適用され、権限ルールは両方のファイルのものが適用されます。Agent SDK の [`resolveSettings()`](/docs/ja/agent-sdk/typescript#resolvesettings) ヘルパーは常に開始ディレクトリからファイルを読み込みます。

497 497 

498Claude Code は共有 `.claude/settings.json` をセッションの[プライマリ作業ディレクトリ](/docs/ja/permissions#working-directories)から読み込むため、リポジトリルートにコミットされたファイルを使用するには、そこから Claude Code を開始してください。[`/cd`](/docs/ja/permissions#move-the-session-to-another-directory) でセッションを移動した後、Claude Code は代わりに新しいディレクトリから両方のプロジェクトファイルを読み込み、同じルールでローカルファイルを配置します。移動したディレクトリから読み込むには Claude Code v2.1.246 以降が必要です。498Claude Code は共有 `.claude/settings.json` をセッションの[プライマリ作業ディレクトリ](/docs/ja/permissions#working-directories)から読み込むため、リポジトリルートにコミットされたファイルを使用するには、そこで Claude Code を開始してください。[`/cd` でセッションを移動した](/docs/ja/permissions#move-the-session-to-another-directory)後は、Claude Code は代わりに新しいディレクトリから両方のプロジェクトファイルを読み込み、ローカルファイルは同じルールで配置します。移動先のディレクトリから読み込むには Claude Code v2.1.246 以降が必要です。

499 499 

500<span id="managed-settings-delivery" />500<span id="managed-settings-delivery" />

501 501 


511 組織が強制する内容を確認する511 組織が強制する内容を確認する

512</h3>512</h3>

513 513 

514組織が Claude Code を管理する場合、いくつかの設定はあなたのために決定され、独自のファイルに入れるものは何もそれらを変更しません。どれを確認するには、`/status` を実行してください。`Setting sources` 行は、あなたに適用される管理ソースの名前を付けます。管理設定はこのマシンで Claude Code が実行される場所に到達します。[開発者が変更できる内容](/docs/ja/managed-settings#what-a-developer-can-change)はローカル管理者権限と Claude Code 以外のツールをカバーしています。514組織が Claude Code を管理している場合、一部の設定はあらかじめ決定されており、自分のファイルに何を書いても変更できません。どの設定が該当するかを確認するには、`/status` を実行してください。`Setting sources` 行に、適用される管理ソースの名前が表示されます。管理設定は、このマシン上で Claude Code が実行されるすべての場所に適用されます。ローカル管理者権限と Claude Code 以外のツールについては、[開発者が変更できる内容](/docs/ja/managed-settings#what-a-developer-can-change)を参照してください。

515 515 

516管理設定は[管理設定ページ](/docs/ja/managed-settings#delivery-mechanisms)の配信メカニズムを通じてあなたに到達します。最も一般的には:516管理設定は、管理設定ページで説明している[配信メカニズム](/docs/ja/managed-settings#delivery-mechanisms)を通じて届きます。最も一般的なものは次のとおりです:

517 517 

518* [サーバー管理設定](/docs/ja/server-managed-settings)。Claude Code が claude.ai 管理コンソールまたは自己ホスト型[Claude apps gateway](/docs/ja/claude-apps-gateway) から取得します518* [サーバー管理設定](/docs/ja/server-managed-settings)。Claude Code が claude.ai 管理コンソールまたはセルフホストの [Claude apps gateway](/docs/ja/claude-apps-gateway) から取得します

519* MDM または OS レベルのポリシー、およびシステムディレクトリの `managed-settings.json` ファイル519* MDM または OS レベルのポリシー、およびシステムディレクトリ内の `managed-settings.json` ファイル

520* Claude Desktop などの埋め込みホスト。SDK `managedSettings` オプション経由。[埋め込みホストからポリシーを制御する](/docs/ja/managed-settings#parent-settings-from-embedding-hosts)を参照してください520* Claude Desktop などの埋め込みホスト。SDK の `managedSettings` オプションを通じて配信されます。[埋め込みホストからポリシーを制御する](/docs/ja/managed-settings#parent-settings-from-embedding-hosts)を参照してください

521 521 

522Claude Desktop アプリで実行される[Cowork](https://claude.com/docs/cowork/overview) セッションでは、Claude Code は claude.ai 管理コンソールからサーバー管理設定を取得しません。組織の Claude Desktop 構成が `requireCoworkFullVmSandbox` を設定しない限り、デバイスにデプロイされたポリシーを読み込みます。[ポリシーが適用される場所と時期](/docs/ja/managed-settings#where-and-when-a-policy-applies)は Cowork とクラウドセッションをカバーしています。522Claude Desktop アプリで自分のマシン上で実行される [Cowork](https://claude.com/docs/cowork/overview) セッションでは、Claude Code は claude.ai 管理コンソールからサーバー管理設定を取得しません。また、組織の Claude Desktop 設定で `requireCoworkFullVmSandbox` が設定されていない限り、デバイスにデプロイされたポリシーを読み込みます。Cowork とクラウドセッションについては、[ポリシーが適用される場所と時期](/docs/ja/managed-settings#where-and-when-a-policy-applies)を参照してください。

523 523 

524管理者の場合、[組織向けに Claude Code をセットアップする](/docs/ja/admin-setup)は何を強制するかを選択する手順を説明し、[管理設定をデプロイする](/docs/ja/managed-settings)は配信と、ポリシーが有効であることを確認する方法をカバーしています。524管理者の場合、[組織向けに Claude Code をセットアップする](/docs/ja/admin-setup)で何を強制するかを選択する手順を、[管理設定をデプロイする](/docs/ja/managed-settings)で配信方法とポリシーが有効であることを確認する方法を説明しています。claude.ai 管理コンソールの管理設定エディターに表示されることがある警告については、[サーバー管理設定を構成する](/docs/ja/server-managed-settings#configure-server-managed-settings)を参照してください。

525 525 

526<h2 id="change-a-setting">526<h2 id="change-a-setting">

527 設定を変更する527 設定を変更する


809 809 

810[クラウドセッション](/docs/ja/claude-code-on-the-web)は[クラウド環境](/docs/ja/cloud-environments)で実行され、マシン上ではなくリポジトリの新しいクローンで実行されます。これにより、どの設定がそこに到達するかが変わります:810[クラウドセッション](/docs/ja/claude-code-on-the-web)は[クラウド環境](/docs/ja/cloud-environments)で実行され、マシン上ではなくリポジトリの新しいクローンで実行されます。これにより、どの設定がそこに到達するかが変わります:

811 811 

812* **共有プロジェクト設定**(`.claude/settings.json`):1 つのリポジトリを持つセッションで読み込まれます。ファイルはクローンの一部であり、セッションはその内部で開始されるためです。その設定をコミットして、それらのセッションに適用してください。複数のリポジトリを持つセッションはクローンの上で開始され、各リポジトリの `.claude/settings.json` から `enabledPlugins` と `extraKnownMarketplaces` キーのみを読み込み、権限ルール、hooks、`env`、またはその他のキーは読み込みません。これら 2 つのキーが宣言するマーケットプレイスとプラグインは、それでも[クラウドセッションでは読み込まれません](/docs/ja/cloud-environments#what-carries-over-from-your-setup)。812* **共有プロジェクト設定**(`.claude/settings.json`):1 つのリポジトリを持つセッションで読み込まれます。ファイルはクローンの一部であり、セッションはその内部で開始されるためです。その設定をコミットして、それらのセッションに適用してください。Anthropic がホストする環境では、複数のリポジトリを持つセッションはクローンの上で開始され、各リポジトリの `.claude/settings.json` から `enabledPlugins` と `extraKnownMarketplaces` キーのみを読み込み、権限ルール、フック、`env`、またはその他のキーは読み込みません。これら 2 つのキーが宣言するマーケットプレイスとプラグインは、それでも[クラウドセッションでは読み込まれません](/docs/ja/cloud-environments#what-carries-over-from-your-setup)。自己ホスト型環境については、[どのリポジトリの設定が適用されるか](/docs/ja/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories)を参照してください。

813* **ユーザーおよびプロジェクトローカル設定**(`~/.claude/settings.json` および `.claude/settings.local.json`):読み込まれません。両方ともマシンに留まり、ローカルファイルはクローンにありません。813* **ユーザーおよびプロジェクトローカル設定**(`~/.claude/settings.json` および `.claude/settings.local.json`):読み込まれません。両方ともマシンに留まり、ローカルファイルはクローンにありません。

814* **管理設定**:デバイスの `managed-settings.json` ファイルまたは MDM プロファイルはクラウドセッションに到達しません。組織の[サーバー管理設定](/docs/ja/server-managed-settings)は到達します。[サーフェスカバレッジ](/docs/ja/model-config#surface-coverage)はどのクラウドセッションがそれらを受け取るかをリストします。[自己ホスト型環境](/docs/ja/self-hosted-environments)もランナーイメージの管理設定ファイルを読み込みます。[Claude Code が管理ソースを結合する方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)はそのファイルがいつ適用されるかを説明します。814* **管理設定**:デバイスの `managed-settings.json` ファイルまたは MDM プロファイルはクラウドセッションに到達しません。組織の[サーバー管理設定](/docs/ja/server-managed-settings)は到達します。[サーフェスカバレッジ](/docs/ja/model-config#surface-coverage)はどのクラウドセッションがそれらを受け取るかをリストします。[自己ホスト型環境](/docs/ja/self-hosted-environments)もランナーイメージの管理設定ファイルを読み込みます。[Claude Code が管理ソースを結合する方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)はそのファイルがいつ適用されるかを説明します。

815* **`/config`**:ブラウザの claude.ai/code では、値を変更する代わりに Claude Code セクションの claude.ai 設定を開きます。クラウドセッションの設定を変更するには、環境で[環境変数](/docs/ja/cloud-environments#set-environment-variables)を設定するか、1 つのリポジトリを持つセッションでは、そのリポジトリの `.claude/settings.json` にキーをコミットしてください。815* **`/config`**:ブラウザの claude.ai/code では、値を変更する代わりに Claude Code セクションの claude.ai 設定を開きます。クラウドセッションの設定を変更するには、環境で[環境変数](/docs/ja/cloud-environments#set-environment-variables)を設定するか、1 つのリポジトリを持つセッションでは、そのリポジトリの `.claude/settings.json` にキーをコミットしてください。

setup.md +20 −10

Details

638 638 

639Claude Code を削除するには、インストール方法の指示に従ってください。アンインストール後も `claude` が実行される場合は、2 番目のインストールまたは古いインストーラーからの残存シェルエイリアスがある可能性があります。[競合するインストールを確認](/docs/ja/troubleshoot-install#check-for-conflicting-installations)を参照して、それを見つけて削除してください。639Claude Code を削除するには、インストール方法の指示に従ってください。アンインストール後も `claude` が実行される場合は、2 番目のインストールまたは古いインストーラーからの残存シェルエイリアスがある可能性があります。[競合するインストールを確認](/docs/ja/troubleshoot-install#check-for-conflicting-installations)を参照して、それを見つけて削除してください。

640 640 

641<h3 id="native-installation">641<span id="native-installation" />

642 ネイティブインストール642 

643<h3 id="uninstall-a-native-installation">

644 ネイティブインストールをアンインストール

643</h3>645</h3>

644 646 

645Claude Code バイナリとバージョンファイルを削除します:647Claude Code バイナリとバージョンファイルを削除します:


660 </Tab>662 </Tab>

661</Tabs>663</Tabs>

662 664 

663<h3 id="homebrew-installation">665<span id="homebrew-installation" />

664 Homebrew インストール666 

667<h3 id="uninstall-with-homebrew">

668 Homebrew でアンインストール

665</h3>669</h3>

666 670 

667インストールした Homebrew cask を削除します。安定版 cask をインストールした場合:671インストールした Homebrew cask を削除します。安定版 cask をインストールした場合:


676brew uninstall --cask claude-code@latest680brew uninstall --cask claude-code@latest

677```681```

678 682 

679<h3 id="winget-installation">683<span id="winget-installation" />

680 WinGet インストール684 

685<h3 id="uninstall-with-winget">

686 WinGet でアンインストール

681</h3>687</h3>

682 688 

683WinGet パッケージを削除します:689WinGet パッケージを削除します:


686winget uninstall Anthropic.ClaudeCode692winget uninstall Anthropic.ClaudeCode

687```693```

688 694 

689<h3 id="apt-/-dnf-/-apk">695<span id="apt-/-dnf-/-apk" />

690 apt / dnf / apk696 

697<h3 id="uninstall-with-apt-dnf-or-apk">

698 apt、dnf、または apk でアンインストール

691</h3>699</h3>

692 700 

693パッケージとリポジトリ構成を削除します:701パッケージとリポジトリ構成を削除します:


716 </Tab>724 </Tab>

717</Tabs>725</Tabs>

718 726 

719<h3 id="npm">727<span id="npm" />

720 npm728 

729<h3 id="uninstall-with-npm">

730 npm でアンインストール

721</h3>731</h3>

722 732 

723グローバル npm パッケージを削除します:733グローバル npm パッケージを削除します:

skills.md +2 −0

Details

94| `migrate` | 既存の Claude API コードを新しいモデルに更新する | v2.1.221 より前 |94| `migrate` | 既存の Claude API コードを新しいモデルに更新する | v2.1.221 より前 |

95| `upgrade` | プロジェクトの Anthropic SDK 依存関係をメジャーバージョン間で移動します。現在は Python `anthropic` パッケージを 0.x から 1.x に移動します | v2.1.236 以降 |95| `upgrade` | プロジェクトの Anthropic SDK 依存関係をメジャーバージョン間で移動します。現在は Python `anthropic` パッケージを 0.x から 1.x に移動します | v2.1.236 以降 |

96| `managed-agents-onboard` | 新しい Managed Agent の作成をウォークスルーする | v2.1.221 より前 |96| `managed-agents-onboard` | 新しい Managed Agent の作成をウォークスルーする | v2.1.221 より前 |

97| `managed-agents-onboard <url>` | URL のページが説明する Managed Agent を構築する。たとえば [Managed Agents ドキュメント](https://platform.claude.com/docs/en/managed-agents/overview) 内のページなど | v2.1.290 以降 |

98| `managed-agents-onboard <quickstart-name>` | `deep-researcher` など、Console のクイックスタートテンプレートの 1 つを構築する。テンプレート名ではない単語を 1 つ指定した場合、Claude は有効な名前を一覧表示します | v2.1.290 以降 |

97| `prompt-audit` | プロンプト、スキル、ツール説明に書かれた古いモデル向けの指示にフラグを立て、差分として修正を提案する | v2.1.221 以降 |99| `prompt-audit` | プロンプト、スキル、ツール説明に書かれた古いモデル向けの指示にフラグを立て、差分として修正を提案する | v2.1.221 以降 |

98| `cost-optimize` | プロジェクトの Claude API 支出がどこに行くかをプロファイルし、プロンプトキャッシング、不要な入出力トークンの削減、バッチ処理、努力、モデル選択などのオプションから節約を提案します。一度に 1 つの変更 | v2.1.247 以降 |100| `cost-optimize` | プロジェクトの Claude API 支出がどこに行くかをプロファイルし、プロンプトキャッシング、不要な入出力トークンの削減、バッチ処理、努力、モデル選択などのオプションから節約を提案します。一度に 1 つの変更 | v2.1.247 以降 |

99| `build-eval` | Claude を搭載したアプリ用の eval セットをビルドする | v2.1.259 以降 |101| `build-eval` | Claude を搭載したアプリ用の eval セットをビルドする | v2.1.259 以降 |

sub-agents.md +4 −2

Details

609メイン会話の権限モードは、Claude Code が設定した値を使用するかどうかを決定します。609メイン会話の権限モードは、Claude Code が設定した値を使用するかどうかを決定します。

610 610 

611* メイン会話が `bypassPermissions`、`acceptEdits`、または[自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)にある場合、サブエージェントはそのモードで実行され、Claude Code は設定した `permissionMode` を無視します。自動モードでは、分類器はメイン会話のブロックおよび許可ルールでサブエージェントのツール呼び出しを評価します。サブエージェントが終了すると、分類器はその作業と最終レポートもレビューしてから、レポートが配信されます。[自動モードがサブエージェントを処理する方法](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)を参照してください。611* メイン会話が `bypassPermissions`、`acceptEdits`、または[自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)にある場合、サブエージェントはそのモードで実行され、Claude Code は設定した `permissionMode` を無視します。自動モードでは、分類器はメイン会話のブロックおよび許可ルールでサブエージェントのツール呼び出しを評価します。サブエージェントが終了すると、分類器はその作業と最終レポートもレビューしてから、レポートが配信されます。[自動モードがサブエージェントを処理する方法](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)を参照してください。

612* メイン会話が `default`、`dontAsk`、または `plan` モードにある場合、サブエージェントは設定した権限モードで実行されます。ただし `bypassPermissions` を除きます。`bypassPermissions` を宣言するサブエージェントはメイン会話のモードを保持します。`bypassPermissions` 例外には Claude Code v2.1.267 以降が必要です。612* メイン会話が `default`、`dontAsk`、または `plan` モードの場合、サブエージェントは設定した権限モードで実行されます。次の場合は、代わりにメイン会話の権限モードを維持します。

613 * `bypassPermissions` を設定した場合。`bypassPermissions` の例外には Claude Code v2.1.267 以降が必要です。

614 * `auto` を設定し、サブエージェントで [auto モードが利用できない](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)場合。例えば、設定ファイルで [`disableAutoMode`](/docs/ja/settings-reference#disableautomode) が設定されている場合や、サブエージェントのモデルが auto モードをサポートしていない場合です。

613 615 

614`permissionMode` はこれらの値を受け入れ、`default` のエイリアスとして `manual` を受け入れます。616`permissionMode` はこれらの値を受け入れ、`default` のエイリアスとして `manual` を受け入れます。

615 617 


640Implement API endpoints. Follow the conventions and patterns from the preloaded skills.642Implement API endpoints. Follow the conventions and patterns from the preloaded skills.

641```643```

642 644 

643リストされた各スキルの完全なコンテンツは起動時にサブエージェントのコンテキストに注入されます。このフィールドはプリロードされるスキルを制御し、サブエージェントがアクセスできるスキルではありません。なしで、サブエージェントは実行中に Skill ツールを通じてプロジェクト、ユーザー、およびプラグインスキルを発見して呼び出すことができます。スキルを完全に呼び出すことを防ぐには、[`tools`](#available-tools)リストから `Skill` を省略するか、`disallowedTools` に追加します。645リストされた各スキルの完全なコンテンツは、リスト内の最初の 32 個の異なる名前まで、起動時にサブエージェントのコンテキストに注入されます。このフィールドはプリロードされるスキルを制御するものであり、サブエージェントがアクセスできるスキルを制御するものではありません。このフィールドがなくても、サブエージェントは実行中に Skill ツールを通じてプロジェクト、ユーザー、およびプラグインスキルを発見して呼び出すことができます。サブエージェントがスキルを呼び出すことを完全に防ぐには、[`tools`](#available-tools) リストから `Skill` を省略するか、`disallowedTools` に追加します。

644 646 

645[`disable-model-invocation: true`](/docs/ja/skills#control-who-invokes-a-skill)を設定するスキルはプリロードできません。プリロードは Claude が呼び出すことができるスキルと同じセットから取得されるためです。これには、Claude が単独で実行できないバンドルされた `/verify` スキルが含まれます。647[`disable-model-invocation: true`](/docs/ja/skills#control-who-invokes-a-skill)を設定するスキルはプリロードできません。プリロードは Claude が呼び出すことができるスキルと同じセットから取得されるためです。これには、Claude が単独で実行できないバンドルされた `/verify` スキルが含まれます。

646 648 

Details

666 666 

667* WebFetch は `localhost` およびドットのない他のホスト名(ベアなイントラネット名など)をリクエストを行う前に拒否します。[返されるエラー](/docs/ja/errors#webfetch-cannot-fetch-localhost) は Claude に Bash 経由で `curl` を使用してローカルサーバーに到達するよう指示します。667* WebFetch は `localhost` およびドットのない他のホスト名(ベアなイントラネット名など)をリクエストを行う前に拒否します。[返されるエラー](/docs/ja/errors#webfetch-cannot-fetch-localhost) は Claude に Bash 経由で `curl` を使用してローカルサーバーに到達するよう指示します。

668* HTTP URL は自動的に HTTPS にアップグレードされます。668* HTTP URL は自動的に HTTPS にアップグレードされます。

669* 大きなページは処理前に固定文字数制限に切り詰められます。669* WebFetch は 1 回の呼び出しにつき、ページのコンテンツを最大 100,000 文字まで読み取ります。Claude Code v2.1.290 以降では、より長いページの結果で読み取られなかった量が Claude に伝えられるため、Claude は次の部分をフェッチできます。

670* WebFetch はデフォルトで各レスポンスを 15 分間キャッシュするため、同じ URL の繰り返しフェッチは迅速に返されます。Claude Code v2.1.233 以降では、[`CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS`](/docs/ja/env-vars#variables) を設定して、WebFetch が各レスポンスを保持する期間を変更できます。670* WebFetch はデフォルトで各レスポンスを 15 分間キャッシュするため、同じ URL の繰り返しフェッチは迅速に返されます。Claude Code v2.1.233 以降では、[`CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS`](/docs/ja/env-vars#variables) を設定して、WebFetch が各レスポンスを保持する期間を変更できます。

671* ページが 5 分以内(WebFetch が従うリダイレクトを含む)にダウンロードを完了しない場合、デッドラインエラーで失敗します。Claude Code v2.1.268 以降では、[`CLAUDE_CODE_WEBFETCH_DEADLINE_MS`](/docs/ja/env-vars#variables) を設定して制限を変更するか、`0` に設定して削除できます。671* ページが 5 分以内(WebFetch が従うリダイレクトを含む)にダウンロードを完了しない場合、デッドラインエラーで失敗します。Claude Code v2.1.268 以降では、[`CLAUDE_CODE_WEBFETCH_DEADLINE_MS`](/docs/ja/env-vars#variables) を設定して制限を変更するか、`0` に設定して削除できます。

672* URL が別のホストにリダイレクトされる場合、WebFetch はそれに従う代わりに、元の URL とリダイレクト先を名前で示すテキスト結果を返します。その後 Claude は 2 番目の WebFetch 呼び出しで新しい URL をフェッチします。672* URL が別のホストにリダイレクトされる場合、WebFetch はそれに従う代わりに、元の URL とリダイレクト先を名前で示すテキスト結果を返します。その後 Claude は 2 番目の WebFetch 呼び出しで新しい URL をフェッチします。

Details

17| 表示内容 | 解決方法 |17| 表示内容 | 解決方法 |

18| :- | :- |18| :- | :- |

19| `command not found: claude` または `'claude' is not recognized` | [PATH を修正する](#command-not-found-claude-after-installation) |19| `command not found: claude` または `'claude' is not recognized` | [PATH を修正する](#command-not-found-claude-after-installation) |

20| `Native installation exists but ... is not in your PATH` | [インストールディレクトリを PATH に追加する](#verify-your-path) |

21| `where.exe claude` の実行結果に `INFO: Could not find files for the given pattern(s).` | [Claude Code がインストールされているか確認する](#check-for-conflicting-installations) |

22| `zsh: permission denied: /Users/you/.zshrc` または `bash: /home/you/.bashrc: Permission denied` | [シェル設定ファイルを書き込み可能にする](#permission-denied-when-adding-to-your-path) |

20| `syntax error near unexpected token '<'` | [インストールスクリプトが HTML を返す](#install-script-returns-html-instead-of-a-shell-script) |23| `syntax error near unexpected token '<'` | [インストールスクリプトが HTML を返す](#install-script-returns-html-instead-of-a-shell-script) |

24| CMD での `< was unexpected at this time` | [インストールスクリプトが HTML を返す](#install-script-returns-html-instead-of-a-shell-script) |

25| `The term 'System.Xml.XmlDocument' is not recognized` | [インストールスクリプトが HTML を返す](#install-script-returns-html-instead-of-a-shell-script) |

21| `curl: (22) The requested URL returned error: 403` | [インストールスクリプトが 403 を返す](#install-script-returns-html-instead-of-a-shell-script) |26| `curl: (22) The requested URL returned error: 403` | [インストールスクリプトが 403 を返す](#install-script-returns-html-instead-of-a-shell-script) |

22| `curl: (23)` または `curl: (56) Failure writing output to destination` | [接続性を確認するか、別のインストーラーを使用する](#curl-56-failure-writing-output-to-destination) |27| `curl: (23)` または `curl: (56) Failure writing output to destination` | [接続性を確認するか、別のインストーラーを使用する](#curl-56-failure-writing-output-to-destination) |

23| Linux でのインストール中に `Killed` または `Installation was killed before it could finish (exit code 137)` | [メモリを解放するか、スワップスペースを追加する](#install-killed-on-low-memory-linux-servers) |28| Linux でのインストール中に `Killed` | [メモリを解放するか、スワップスペースを追加する](#install-killed-on-low-memory-linux-servers) |

29| `Installation was killed before it could finish` | [メモリを解放してから、インストーラーを再実行する](#installation-was-killed-before-it-could-finish) |

24| インストール中に `Raw mode is not supported` | [インストーラーを再実行する](#raw-mode-is-not-supported-during-install) |30| インストール中に `Raw mode is not supported` | [インストーラーを再実行する](#raw-mode-is-not-supported-during-install) |

25| インストール中に `EACCES: permission denied` | [インストールディレクトリの権限を修正する](#permission-errors-during-installation) |31| インストール中に `EACCES: permission denied` | [インストールディレクトリの権限を修正する](#permission-errors-during-installation) |

26| `TLS connect error` または `SSL/TLS secure channel` | [CA 証明書を更新する](#tls-or-ssl-connection-errors) |32| `TLS connect error` または `SSL/TLS secure channel` | [CA 証明書を更新する](#tls-or-ssl-connection-errors) |

33| `CRYPT_E_NO_REVOCATION_CHECK` または `CRYPT_E_REVOCATION_OFFLINE` | [ブロックされた失効チェックを回避する](#tls-or-ssl-connection-errors) |

27| `Failed to fetch version` またはダウンロードサーバーに到達できない | [ネットワークとプロキシ設定を確認する](#check-network-connectivity) |34| `Failed to fetch version` またはダウンロードサーバーに到達できない | [ネットワークとプロキシ設定を確認する](#check-network-connectivity) |

35| `The connection dropped while downloading the update` または `Download timed out: exceeded the total deadline` | [更新を再度実行するか、プロキシを設定する](#the-connection-dropped-while-downloading-the-update) |

28| `irm is not recognized` または `The token '&&' is not a valid statement separator` | [シェルに適切なコマンドを使用する](#wrong-install-command-on-windows) |36| `irm is not recognized` または `The token '&&' is not a valid statement separator` | [シェルに適切なコマンドを使用する](#wrong-install-command-on-windows) |

29| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Homebrew を更新する](#homebrew-cask-unavailable-or-outdated) |37| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Homebrew を更新する](#homebrew-cask-unavailable-or-outdated) |

38| `Cask 'claude-code@latest' is not installed` | [インストールした cask をアップグレードする](#cask-is-not-installed) |

30| `'bash' is not recognized as the name of a cmdlet` | [Windows インストーラーコマンドを使用する](#wrong-install-command-on-windows) |39| `'bash' is not recognized as the name of a cmdlet` | [Windows インストーラーコマンドを使用する](#wrong-install-command-on-windows) |

31| `A parameter cannot be found that matches parameter name 'fsSL'` | [Windows インストーラーコマンドを使用する](#wrong-install-command-on-windows) |40| `A parameter cannot be found that matches parameter name 'fsSL'` | [Windows インストーラーコマンドを使用する](#wrong-install-command-on-windows) |

32| `Claude Code on Windows requires either Git for Windows (for bash) or PowerShell` | [シェルをインストールする](#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell) |41| `Claude Code on Windows requires either Git for Windows (for bash) or PowerShell` | [シェルをインストールする](#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell) |


45| npm の更新または再インストール中に `npm error code ENOTEMPTY` | [残されたパッケージディレクトリを削除する](#npm-enotempty-during-update-or-reinstall) |54| npm の更新または再インストール中に `npm error code ENOTEMPTY` | [残されたパッケージディレクトリを削除する](#npm-enotempty-during-update-or-reinstall) |

46| Windows での更新直後に `'claude' is not recognized` | [`claude.exe` をバックアップから復元する](#claude-exe-missing-after-an-update-on-windows) |55| Windows での更新直後に `'claude' is not recognized` | [`claude.exe` をバックアップから復元する](#claude-exe-missing-after-an-update-on-windows) |

47| Windows では、インストールコマンドがスクリプトテキストを出力し、何もインストールされない | [完全なインストールコマンドを実行する](#wrong-install-command-on-windows) |56| Windows では、インストールコマンドがスクリプトテキストを出力し、何もインストールされない | [完全なインストールコマンドを実行する](#wrong-install-command-on-windows) |

48| `App unavailable in region` | Claude Code はお客様の国では利用できません。[サポートされている国](https://www.anthropic.com/supported-countries)を参照してください。 |57| `App unavailable in region` | Claude Code はお住まいの国では利用できません。[サポートされている国](https://www.anthropic.com/supported-countries)を参照してください。 |

49| `unable to get local issuer certificate` | [企業 CA 証明書を設定する](#tls-or-ssl-connection-errors) |58| `unable to get local issuer certificate` | [企業 CA 証明書を設定する](#tls-or-ssl-connection-errors) |

50| `OAuth error` または `403 Forbidden` | [認証を修正する](#login-and-authentication) |59| `OAuth error` または `403 Forbidden` | [認証を修正する](#login-and-authentication) |

51| `Claude Code access has not been granted for this account` | [Claude Code を含むロールを取得する](#claude-code-access-has-not-been-granted-for-this-account) |60| `Claude Code access has not been granted for this account` | [Claude Code を含むロールを取得する](#claude-code-access-has-not-been-granted-for-this-account) |


88 97 

89最初の行が `200` ステータスを表示している場合、サーバーに到達しました。macOS と Linux では `HTTP/2 200` が表示され、Windows に含まれる `curl.exe` からは `HTTP/1.1 200 OK` が表示されます。その他の結果は原因を示しています:98最初の行が `200` ステータスを表示している場合、サーバーに到達しました。macOS と Linux では `HTTP/2 200` が表示され、Windows に含まれる `curl.exe` からは `HTTP/1.1 200 OK` が表示されます。その他の結果は原因を示しています:

90 99 

91* `403`:通常、プロキシまたはネットワークフィルターがホストをブロックしているか、Claude Code が[お客様の地域では利用できません](https://www.anthropic.com/supported-countries)100* `403`:通常、プロキシまたはネットワークフィルターがホストをブロックしているか、Claude Code が[ご利用の地域では利用できません](https://www.anthropic.com/supported-countries)

92* `5xx`:通常、一時的なサービスの問題です。数分待ってから再試行してください101* `5xx`:通常、一時的なサービスの問題です。数分待ってから再試行してください

93 102 

94出力がない、`Could not resolve host`、または接続タイムアウトが表示される場合、ネットワークが接続をブロックしています。一般的な原因:103出力がない、`Could not resolve host`、または接続タイムアウトが表示される場合、ネットワークが接続をブロックしています。一般的な原因:


125 134 

126インストールが成功しても、`claude` を実行するときに `command not found` または `not recognized` エラーが表示される場合、インストールディレクトリが PATH に含まれていません。シェルは PATH にリストされているディレクトリ内のプログラムを検索し、インストーラーは macOS/Linux では `~/.local/bin/claude` に、Windows では `%USERPROFILE%\.local\bin\claude.exe` に `claude` を配置します。135インストールが成功しても、`claude` を実行するときに `command not found` または `not recognized` エラーが表示される場合、インストールディレクトリが PATH に含まれていません。シェルは PATH にリストされているディレクトリ内のプログラムを検索し、インストーラーは macOS/Linux では `~/.local/bin/claude` に、Windows では `%USERPROFILE%\.local\bin\claude.exe` に `claude` を配置します。

127 136 

137インストーラーはこのケースを検出し、出力の `Setup notes:` の下に報告します。macOS と Linux では `Native installation exists but ~/.local/bin is not in your PATH.`、Windows では `Native installation exists but C:\Users\you\.local\bin is not in your PATH.` と表示されます。インストーラーはこの注記とともに修正方法を出力しますが、PATH 自体は変更しません。

138 

128<Note>139<Note>

129 [VS Code 拡張機能](/docs/ja/vs-code)は `claude` をこの場所に配置しません。拡張機能ディレクトリ内に CLI のプライベートコピーをバンドルし、独自のチャットパネル用に使用し、PATH に追加しません。拡張機能のみをインストールした場合、`~/.local/bin/claude` は存在しません。ターミナルから `claude` を使用するには[スタンドアロンインストール](/docs/ja/setup)を実行してから、以下を続行してください。140 [VS Code 拡張機能](/docs/ja/vs-code)は `claude` をこの場所に配置しません。拡張機能ディレクトリ内に CLI のプライベートコピーをバンドルし、独自のチャットパネル用に使用し、PATH に追加しません。拡張機能のみをインストールした場合、`~/.local/bin/claude` は存在しません。ターミナルから `claude` を使用するには[スタンドアロンインストール](/docs/ja/setup)を実行してから、以下を続行してください。

130</Note>141</Note>

131 142 

132インストールディレクトリが PATH に含まれているかどうかを確認するには、PATH エントリをリストして `local/bin` でフィルタリングしてください:143まずプログラムがそもそも存在するかを確認し、次にそのフォルダーが PATH に含まれているかを確認します。PATH の修正は永続的なので、一度適用すれば済みます。使用しているプラットフォームのタブを選び、そのコマンドを実行してください。macOS と Linux ではターミナルで、Windows では PowerShell またはコマンドプロンプトで実行します。

133 144 

134<Tabs>145<Tabs>

135 <Tab title="macOS/Linux">146 <Tab title="macOS/Linux">

147 インストーラーがプログラムを配置したことを確認します:

148 

149 ```bash theme={null}

150 ls -la ~/.local/bin/claude

151 ```

152 

153 * **`No such file or directory`**:ネイティブインストールがありません。npm、Homebrew、Linux パッケージマネージャーなど別の方法で Claude Code をインストールしていない場合は、[Claude Code をインストール](/docs/ja/setup#install-claude-code)してください。別の方法でインストールした場合は、[競合するインストールを確認する](#check-for-conflicting-installations)を参照してください。

154 * **ファイルの一覧が表示される**:プログラムは存在します。次に PATH を確認してください。

155 

156 PATH エントリをリストし、インストールフォルダーでフィルタリングします:

157 

136 ```bash theme={null}158 ```bash theme={null}

137 echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"159 echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

138 ```160 ```

139 161 

140 これが `/Users/you/.local/bin` または `/home/you/.local/bin` を出力する場合、ディレクトリは PATH に含まれており、[競合するインストールを確認する](#check-for-conflicting-installations)にスキップできます。出力がない場合は、シェル設定に追加してください。162 これが `/Users/you/.local/bin` または `/home/you/.local/bin` を出力する場合、ディレクトリは PATH に含まれており、[競合するインストールを確認する](#check-for-conflicting-installations)にスキップできます。出力がない場合は、使用しているシェル用の 2 つのコマンドでシェル設定に追加してください。`echo` コマンドは新しいターミナルすべてに対して設定を保存し、`source` は現在のウィンドウに設定を適用します。`echo` コマンドは成功しても何も出力しません。

141 163 

142 macOS のデフォルトである Zsh の場合:164 macOS のデフォルトである Zsh の場合:

143 165 


146 source ~/.zshrc168 source ~/.zshrc

147 ```169 ```

148 170 

149 ほとんどの Linux ディストリビューションのデフォルトである Bash の場合:171 Linux 上の Bash(ほとんどのディストリビューションでデフォルト)の場合:

150 172 

151 ```bash theme={null}173 ```bash theme={null}

152 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc174 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc


162 184 

163 または、ターミナルを閉じて再度開いてください。185 または、ターミナルを閉じて再度開いてください。

164 186 

187 `echo` コマンドが `permission denied` を出力する場合は、[PATH への追加時の `permission denied`](#permission-denied-when-adding-to-your-path) を参照してください。

188 

165 fish や Nushell などの他のシェルの場合は、シェル独自の設定構文を使用して `~/.local/bin` を PATH に追加してから、ターミナルを再起動してください。189 fish や Nushell などの他のシェルの場合は、シェル独自の設定構文を使用して `~/.local/bin` を PATH に追加してから、ターミナルを再起動してください。

166 190 

167 修正が機能したことを確認してください:191 修正が機能したことを確認してください:


169 ```bash theme={null}193 ```bash theme={null}

170 claude --version194 claude --version

171 ```195 ```

196 

197 それでも `claude` が見つからない場合は、次の原因を確認してください:

198 

199 * **ターミナルが変更前から開いている**:既に開いていたウィンドウは古い PATH を保持し、エディター内のターミナルはエディターから PATH を引き継ぎます。新しいウィンドウを開くか、エディターを終了して再度開いてください。

200 * **行が保存されていない**:使用しているシェルのファイル名で `grep -n '.local/bin' ~/.zshrc` を実行してください。行が存在すれば、行番号付きでその行が出力されます。何も出力されない場合は、2 つの PATH コマンドを再度実行してください。

201 * **行が別のシェルのファイルに追加された**:`echo $0` を実行して使用しているシェルを確認し、そのシェル用の 2 つの PATH コマンドを実行してください。

172 </Tab>202 </Tab>

173 203 

174 <Tab title="Windows PowerShell">204 <Tab title="Windows PowerShell">

205 インストーラーがプログラムを配置したことを確認します:

206 

207 ```powershell theme={null}

208 Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

209 ```

210 

211 * **`False`**:ネイティブインストールがありません。npm や WinGet など別の方法で Claude Code をインストールしていない場合は、[Claude Code をインストール](/docs/ja/setup#install-claude-code)してください。別の方法でインストールした場合は、[競合するインストールを確認する](#check-for-conflicting-installations)を参照してください。

212 * **`True`**:プログラムは存在します。次に PATH を確認してください。

213 

214 PATH エントリをリストし、インストールフォルダーでフィルタリングします:

215 

175 ```powershell theme={null}216 ```powershell theme={null}

176 $env:PATH -split ';' | Select-String '\.local\\bin'217 $env:PATH -split ';' | Select-String '\.local\\bin'

177 ```218 ```

178 219 

179 出力がない場合は、インストールディレクトリをユーザー PATH に追加してください:220 これが `C:\Users\you\.local\bin` を出力する場合、ディレクトリは PATH に含まれており、[競合するインストールを確認する](#check-for-conflicting-installations)にスキップできます。出力がない場合は、インストールディレクトリをユーザー PATH に追加してください:

180 221 

181 ```powershell theme={null}222 ```powershell theme={null}

182 $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')223 $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')


190 ```powershell theme={null}231 ```powershell theme={null}

191 claude --version232 claude --version

192 ```233 ```

234 

235 新しいターミナルでもまだ `claude` が見つからない場合は、次の原因を確認してください:

236 

237 * **ターミナルがエディター内で実行されている**:エディターから PATH を引き継ぐため、エディターを終了して再度開いてください。

238 * **変更が保存されていない**:`[Environment]::GetEnvironmentVariable('PATH', 'User')` を実行し、出力される PATH に `.local\bin` が含まれているか確認してください。含まれていない場合は、2 つのコマンドを再度実行してください。

193 </Tab>239 </Tab>

194 240 

195 <Tab title="Windows CMD">241 <Tab title="Windows CMD">

242 インストーラーがプログラムを配置したことを確認します:

243 

244 ```batch theme={null}

245 dir "%USERPROFILE%\.local\bin\claude.exe"

246 ```

247 

248 * **`File Not Found` または `The system cannot find the path specified.`**:ネイティブインストールがありません。npm や WinGet など別の方法で Claude Code をインストールしていない場合は、[Claude Code をインストール](/docs/ja/setup#install-claude-code)してください。別の方法でインストールした場合は、[競合するインストールを確認する](#check-for-conflicting-installations)を参照してください。

249 * **`claude.exe` の一覧が表示される**:プログラムは存在します。次に PATH を確認してください。

250 

251 PATH エントリをリストし、インストールフォルダーでフィルタリングします:

252 

196 ```batch theme={null}253 ```batch theme={null}

197 echo %PATH% | findstr /i "local\bin"254 echo %PATH% | findstr /i "local\bin"

198 ```255 ```


204 ```batch theme={null}261 ```batch theme={null}

205 claude --version262 claude --version

206 ```263 ```

264 

265 新しいターミナルでもまだ `claude` が見つからない場合、エディター内のターミナルはエディターから PATH を引き継ぐため、エディターも終了して再度開いてください。

207 </Tab>266 </Tab>

208</Tabs>267</Tabs>

209 268 


221 which -a claude280 which -a claude

222 ```281 ```

223 282 

224 これが何も出力しない場合、`claude` はまだ PATH にありません。[PATH を確認する](#verify-your-path)に戻ってください。283 これが `claude not found`、`no claude in` で始まる行を出力する場合、または何も出力しない場合、PATH 上に `claude` はありません。次のチェックで、そもそもインストールされているかどうかがわかります。

225 284 

226 `claude` バイナリが来ることができる 3 つの場所を確認してください。`~/.local/bin/claude` はネイティブインストーラー、`~/.claude/local/` は Claude Code の古いバージョンによって作成されたレガシーローカル npm インストール、npm グローバルリストは `-g` インストールを示します:285 `claude` バイナリが来ることができる 3 つの場所を確認してください。`~/.local/bin/claude` はネイティブインストーラー、`~/.claude/local/` は Claude Code の古いバージョンによって作成されたレガシーローカル npm インストール、npm グローバルリストは `-g` インストールを示します:

227 286 


231 290 

232 ネイティブインストールは `~/.local/share/claude/versions/` へのシンボリックリンクを表示します。このパスで自分で作成したスクリプトまたはシンボリックリンクはカスタムランチャーであり、[自動更新はそのまま残します](/docs/ja/setup#auto-updates)。291 ネイティブインストールは `~/.local/share/claude/versions/` へのシンボリックリンクを表示します。このパスで自分で作成したスクリプトまたはシンボリックリンクはカスタムランチャーであり、[自動更新はそのまま残します](/docs/ja/setup#auto-updates)。

233 292 

234 `ls` コマンドが `No such file or directory` を出力する場合、それはエラーではありません。その場所に何もインストールされていないことを意味するため、次のチェックに進んでください。293 いずれかの `ls` コマンドが `No such file or directory` を出力する場合、それはエラーではありません。その場所に何もインストールされていないことを意味するため、次のチェックに進んでください。

235 294 

236 ```bash theme={null}295 ```bash theme={null}

237 ls -la ~/.claude/local/296 ls -la ~/.claude/local/


240 ```bash theme={null}299 ```bash theme={null}

241 npm -g ls @anthropic-ai/claude-code 2>/dev/null300 npm -g ls @anthropic-ai/claude-code 2>/dev/null

242 ```301 ```

302 

303 `ls -la ~/.local/bin/claude` が `No such file or directory` を出力した場合、ネイティブインストールはありません。npm、Homebrew、Linux パッケージマネージャーなど別の方法で Claude Code をインストールしていない場合は、[Claude Code をインストール](/docs/ja/setup#install-claude-code)してください。`~/.local/bin/claude` が存在するのに `which -a claude` にリストされなかった場合、そのフォルダーは PATH に含まれていません。[PATH を確認する](#verify-your-path)を参照してください。

243 </Tab>304 </Tab>

244 305 

245 <Tab title="Windows PowerShell">306 <Tab title="Windows PowerShell">


249 where.exe claude310 where.exe claude

250 ```311 ```

251 312 

313 これが `INFO: Could not find files for the given pattern(s).` を出力する場合、PATH 上に `claude` はありません。

314 

252 ネイティブインストーラーがバイナリを配置したかどうかを確認してください:315 ネイティブインストーラーがバイナリを配置したかどうかを確認してください:

253 316 

254 ```powershell theme={null}317 ```powershell theme={null}

255 Test-Path "$env:USERPROFILE\.local\bin\claude.exe"318 Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

256 ```319 ```

320 

321 * **`True`**:ネイティブインストールは存在します。`where.exe` で何も見つからなかった場合、そのフォルダーは PATH に含まれていません。[PATH を確認する](#verify-your-path)を参照してください。

322 * **`False`**:ネイティブインストールがありません。npm や WinGet など別の方法で Claude Code をインストールしていない場合は、[Claude Code をインストール](/docs/ja/setup#install-claude-code)してください。

257 </Tab>323 </Tab>

258</Tabs>324</Tabs>

259 325 


328 バイナリが機能することを確認する394 バイナリが機能することを確認する

329</h3>395</h3>

330 396 

331`claude --version` がバージョンを出力しても `claude` がクラッシュまたはハングする場合は、これらのチェックを実行して原因を特定してください。`claude --version` がコマンドが見つからないと言う場合は、最初に [PATH を確認する](#verify-your-path)に移動してください。以下のコマンドは `claude` が PATH にあることを前提としています。397`claude --version` がバージョンを出力しても `claude` が起動時にクラッシュまたはハングする場合は、これらのチェックを実行して原因を特定してください。`claude --version` がコマンドが見つからないと言う場合は、最初に [PATH を確認する](#verify-your-path)に移動してください。以下のコマンドは `claude` が PATH にあることを前提としています。

332 398 

333バイナリが存在し、実行可能であることを確認してください:399バイナリが存在し、実行可能であることを確認してください:

334 400 


368 インストールスクリプトが shell スクリプトではなく HTML を返す434 インストールスクリプトが shell スクリプトではなく HTML を返す

369</h3>435</h3>

370 436 

371インストールコマンドを実行すると、次のようなエラーが表示される場合があります。437ダウンロードしたものがインストールスクリプトでない場合、インストールコマンドは次のいずれかのエラーで失敗します。

438 

439**Bash または Zsh**:エラーには返されたページの最初の行が引用されます。

372 440 

373```text theme={null}441```text theme={null}

374bash: line 1: syntax error near unexpected token `<'442bash: line 1: syntax error near unexpected token `<'

375bash: line 1: `<!DOCTYPE html>'443bash: line 1: `<!DOCTYPE html>'

376```444```

377 445 

378PowerShell では、同じ問題が返されたページを指すパースエラーとして表示され、`iex` が HTML と CSS を PowerShell として実行しようとします。446**PowerShell、パースエラー**:エラーは返されたページ内を指し、`iex` が HTML と CSS を PowerShell として実行しようとします。

379 447 

380```text theme={null}448```text theme={null}

381iex : At line:1 char:2310449iex : At line:1 char:2310


386 454 

387表現は PowerShell のバージョンとシステム言語によって異なります。`Missing expression after unary operator '--'` または `ParserError` と `ParseException` が表示される場合があります。引用符で囲まれたテキスト内の HTML タグまたは CSS がこの失敗を示します。代わりに `-OutFile install.ps1` でダウンロードしても、保存されたファイルは同じウェブページなので、それも役に立ちません。455表現は PowerShell のバージョンとシステム言語によって異なります。`Missing expression after unary operator '--'` または `ParserError` と `ParseException` が表示される場合があります。引用符で囲まれたテキスト内の HTML タグまたは CSS がこの失敗を示します。代わりに `-OutFile install.ps1` でダウンロードしても、保存されたファイルは同じウェブページなので、それも役に立ちません。

388 456 

389リクエストのルーティング方法によっては、HTML ボディなしで 403 が表示される場合があります。457**PowerShell、`System.Xml.XmlDocument`**:エラーはページを引用する代わりにこの型名を示します。

458 

459```text theme={null}

460System.Xml.XmlDocument : The term 'System.Xml.XmlDocument' is not recognized as the name of a cmdlet, function, script

461file, or operable program.

462```

463 

464`irm` がレスポンスを XML として解析できる場合、テキストではなく XML オブジェクトを返し、`iex` はそのオブジェクトの型名をコマンドとして実行しようとします。インストールスクリプトは PowerShell コードであり XML として解析できないため、このエラーもレスポンスがスクリプト以外のものだったことを意味します。型名の前後の表現は PowerShell のバージョンとシステム言語によって異なりますが、`System.Xml.XmlDocument` 自体は変わらないため、型名で照合してください。

465 

466**CMD**:次のエラーが表示され、その後に返されたページの HTML が続きます。

467 

468```text theme={null}

469< was unexpected at this time.

470 

471C:\Users\you><!DOCTYPE html>...

472```

473 

474最初の行はシステム言語で表示されるため、その後に続く HTML を確認してください。

475 

476**ページなしの 403**:リクエストのルーティング方法によっては、curl が HTML ボディなしで 403 ステータスを報告します。

390 477 

391```text theme={null}478```text theme={null}

392curl: (22) The requested URL returned error: 403479curl: (22) The requested URL returned error: 403

393```480```

394 481 

395これらはすべて、インストール URL がインストールスクリプトではなく HTML ページまたはエラーステータスを返したことを意味します。HTML ページに「App unavailable in region」と表示されている場合、Claude Code はお客様の国では利用できません。[サポートされている国](https://www.anthropic.com/supported-countries)を参照してください。482これらはすべて、インストール URL がインストールスクリプトではなく、ウェブページ、XML ドキュメント、またはエラーステータスを返したことを意味します。エラー出力に「App unavailable in region」と引用されている場合、お住まいの国では Claude Code を利用できません。[サポートされている国](https://www.anthropic.com/supported-countries)を参照してください。

396 483 

397ボディなしの 403 は多くの場合同じ原因ですが、企業プロキシまたはファイアウォールがダウンロードをブロックしている場合もあります。サポートされている国にいるのに 403 が表示される場合は、以下の代替インストーラーを試す前に[ネットワーク接続を確認](#check-network-connectivity)してください。これらは同じホストに到達するためです。484ボディなしの 403 は多くの場合同じ原因ですが、企業プロキシまたはファイアウォールがダウンロードをブロックしている場合もあります。サポートされている国にいるのに 403 が表示される場合は、以下の代替インストーラーを試す前に[ネットワーク接続を確認](#check-network-connectivity)してください。これらは同じホストに到達するためです。

398 485 


400 487 

401**解決策:**488**解決策:**

402 489 

4031. **別のインストール方法を使用する**:4901. **数分後に再試行する**:この問題は多くの場合一時的です。待機して元のコマンドを再度試してください。

491 

4922. **別のインストール方法を使用する**:ネイティブインストールとは異なり、Homebrew または WinGet でのインストールは[デフォルトでは自動更新されません](/docs/ja/setup#auto-updates)。

404 493 

405 macOS では、Homebrew 経由でインストールします。494 macOS では、Homebrew 経由でインストールします。

406 495 


416 505 

417 次に `claude --version` を実行して確認します。コマンドは `2.1.211 (Claude Code)` などのバージョン番号を出力します。シェルが `claude` が見つからないと報告する場合は、新しいターミナルウィンドウを開いて再試行してください。インストール元のセッションは古い `PATH` を保持しています。506 次に `claude --version` を実行して確認します。コマンドは `2.1.211 (Claude Code)` などのバージョン番号を出力します。シェルが `claude` が見つからないと報告する場合は、新しいターミナルウィンドウを開いて再試行してください。インストール元のセッションは古い `PATH` を保持しています。

418 507 

4192. **数分後に再試行する**:この問題は多くの場合一時的です。待機して元のコマンドを再度試してください。

420 

421<h3 id="command-not-found-claude-after-installation">508<h3 id="command-not-found-claude-after-installation">

422 インストール後の `command not found: claude`509 インストール後の `command not found: claude`

423</h3>510</h3>


435 522 

436それ以外の場合は、各プラットフォームの修正について[PATH を確認](#verify-your-path)を参照してください。523それ以外の場合は、各プラットフォームの修正について[PATH を確認](#verify-your-path)を参照してください。

437 524 

525<h3 id="permission-denied-when-adding-to-your-path">

526 PATH への追加時の `permission denied`

527</h3>

528 

529PATH に `~/.local/bin` を追加する `echo` コマンドが `zsh: permission denied: /Users/you/.zshrc` または `bash: /home/you/.bashrc: Permission denied` を出力する場合、ユーザーにはそのファイルへの書き込み権限がなく、何も保存されていません。ターミナルで、`~/.zshrc` の代わりに使用しているシェルのファイル名を指定して、ファイルの所有者を確認してください。

530 

531```bash theme={null}

532ls -l ~/.zshrc

533```

534 

535出力の 3 番目のフィールドが所有者です。

536 

537* **所有者が `root` などの別のユーザーの場合**:`sudo chown $(whoami) ~/.zshrc` で所有権を取得します。これには管理者権限が必要です。

538* **所有者が自分の場合**:ファイルは読み取り専用です。`chmod u+w ~/.zshrc` で書き込み可能にしてください。

539 

540その後、[PATH を確認](#verify-your-path)にあるシェル用の 2 つの PATH コマンドを再度実行してください。

541 

438<h3 id="curl-56-failure-writing-output-to-destination">542<h3 id="curl-56-failure-writing-output-to-destination">

439 `curl: (56) Failure writing output to destination`543 `curl: (56) Failure writing output to destination`

440</h3>544</h3>


456 560 

457Homebrew が予想より古い Claude Code バージョンをインストールする場合、同じ古いインデックスが通常の原因です。`claude-code` cask は安定チャネルを追跡し、通常は最新リリースより約 1 週間遅れています。最新バージョンを実行するには、代わりに `brew install --cask claude-code@latest` を実行してください。2 つの cask の違いについては、[リリースチャネルを設定](/docs/ja/setup#configure-release-channel)を参照してください。561Homebrew が予想より古い Claude Code バージョンをインストールする場合、同じ古いインデックスが通常の原因です。`claude-code` cask は安定チャネルを追跡し、通常は最新リリースより約 1 週間遅れています。最新バージョンを実行するには、代わりに `brew install --cask claude-code@latest` を実行してください。2 つの cask の違いについては、[リリースチャネルを設定](/docs/ja/setup#configure-release-channel)を参照してください。

458 562 

563<h3 id="cask-is-not-installed">

564 `Cask 'claude-code@latest' is not installed`

565</h3>

566 

567Homebrew には `claude-code` と `claude-code@latest` の 2 つの cask があります。インストールされていない方の cask に対して `brew upgrade --cask claude-code@latest` を実行すると、`Error: Cask 'claude-code@latest' is not installed.` と出力されます。どの cask がインストールされているかを確認するには、ターミナルで次を実行してください。

568 

569```bash theme={null}

570brew list --cask | grep claude-code

571```

572 

573出力された cask をアップグレードしてください。何も出力されない場合は、どちらの cask もインストールされていません。

574 

459<h3 id="tls-or-ssl-connection-errors">575<h3 id="tls-or-ssl-connection-errors">

460 TLS または SSL 接続エラー576 TLS または SSL 接続エラー

461</h3>577</h3>


467* PowerShell の `Could not create SSL/TLS secure channel`583* PowerShell の `Could not create SSL/TLS secure channel`

468* PowerShell の `Could not establish trust relationship for the SSL/TLS secure channel`584* PowerShell の `Could not establish trust relationship for the SSL/TLS secure channel`

469 585 

586`CRYPT_E_NO_REVOCATION_CHECK` または `CRYPT_E_REVOCATION_OFFLINE` の場合は、手順 4 に進んでください。

587 

470**解決策:**588**解決策:**

471 589 

4721. **システム CA 証明書を更新する**:5901. **システム CA 証明書を更新する**:


479 597 

480 macOS では、システム curl は Keychain トラストストアを使用します。macOS 自体を更新するとルート証明書が更新されます。598 macOS では、システム curl は Keychain トラストストアを使用します。macOS 自体を更新するとルート証明書が更新されます。

481 599 

4822. **Windows では、インストーラーを実行する前に PowerShell で TLS 1.2 を有効にする**:6002. **Windows PowerShell 5.1 では、TLS 1.2 を有効にする**:

483 ```powershell theme={null}601 ```powershell theme={null}

484 [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12602 [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

603 ```

604 次に、同じウィンドウでインストーラーを実行します。

605 ```powershell theme={null}

485 irm https://claude.ai/install.ps1 | iex606 irm https://claude.ai/install.ps1 | iex

486 ```607 ```

487 608 


537 658 

538インストーラーがダウンロードサーバーに到達できませんでした。これは通常、`downloads.claude.ai` がネットワークでブロックされていることを意味します。[ネットワーク接続を確認](#check-network-connectivity)を参照してください。659インストーラーがダウンロードサーバーに到達できませんでした。これは通常、`downloads.claude.ai` がネットワークでブロックされていることを意味します。[ネットワーク接続を確認](#check-network-connectivity)を参照してください。

539 660 

661<h3 id="the-connection-dropped-while-downloading-the-update">

662 The connection dropped while downloading the update

663</h3>

664 

665`claude install` または `claude update` が Claude Code バイナリを取得している間にダウンロードサーバーへの接続が切断され、再試行でも回復しませんでした。Claude Code は、接続が切断された場合、転送が停止した場合、またはダウンロードしたファイルがチェックサム検証に失敗した場合に、合計 3 回までダウンロードを再試行します。404 などの完了した HTTP エラーは、サーバーがすでに応答しているため再試行されません。v2.1.202 より前では、接続が 1 回切断されただけで、再試行せずに `aborted` という簡素なエラーでダウンロードがただちに失敗していました。

666 

667```text theme={null}

668The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

669```

670 

671括弧内のテキストは、どの試行が失敗したかと、その根本的なネットワークエラーを示します。`claude update` は、このメッセージの前に stderr へ `Error: Failed to install native update` を出力します。

672 

673接続が維持されていても 10 分以内に完了しないダウンロードは、代わりに `Download timed out: exceeded the total deadline` で失敗します。期限内に完了できないほど遅い接続では、すぐに再試行しても完了しないため、Claude Code はタイムアウトしたダウンロードを再試行しません。以下の手順は両方のメッセージに当てはまります。

674 

675プロキシやゲートウェイは長い転送を完了前に切断することがあり、Claude Code バイナリはサイズの大きいダウンロードです。

676 

677**対処方法:**

678 

679* `claude update` を再度実行してください。ネットワークにほかに問題がなければ、通常は次の実行でダウンロードが成功します。タイムアウトのメッセージの場合は、より高速な、または帯域制限の少ないネットワークから再度実行してください。

680* ネットワークでプロキシが必要な場合は、インストーラーまたは `claude update` を実行する前に `HTTPS_PROXY` を設定してください。[ネットワーク接続を確認](#check-network-connectivity)を参照してください。

681* 企業プロキシが転送を切断し続ける場合は、`downloads.claude.ai` からの完全なダウンロードを許可するようネットワークチームに依頼してください。[ネットワークアクセス要件](/docs/ja/network-config#network-access-requirements)を参照してください。

682* シェルから `claude doctor` を実行してインストールの診断を確認する

683 

540<h3 id="wrong-install-command-on-windows">684<h3 id="wrong-install-command-on-windows">

541 Windows での間違ったインストールコマンド685 Windows での間違ったインストールコマンド

542</h3>686</h3>

543 687 

544`'irm' is not recognized`、`The token '&&' is not a valid statement separator`、`A parameter cannot be found that matches parameter name 'fsSL'`、または `'bash' is not recognized as the name of a cmdlet` が表示される場合、別のシェルまたはオペレーティングシステムのインストールコマンドをコピーしました。コマンドがスクリプトのテキストを出力する場合、その一部のみを実行しました。688`'irm' is not recognized`、`The token '&&' is not a valid statement separator`、`A parameter cannot be found that matches parameter name 'fsSL'`、または `'bash' is not recognized as the name of a cmdlet` が表示される場合、別のシェルまたはオペレーティングシステムのインストールコマンドをコピーしました。コマンドが何もインストールせずにスクリプトのテキストを出力する場合、その一部のみを実行しました。

545 689 

546* **`irm` が認識されない**:CMD にいます。PowerShell ではありません。2 つのオプションがあります。690* **`irm` が認識されない**:CMD にいます。PowerShell ではありません。2 つのオプションがあります。

547 691 


572 irm https://claude.ai/install.ps1 | iex716 irm https://claude.ai/install.ps1 | iex

573 ```717 ```

574 718 

575* **コマンドがスクリプトテキストを出力する代わりにインストールする**:ダウンロード部分を実行部分なしで実行しました。`irm https://claude.ai/install.ps1` 単独でダウンロードされたスクリプトをターミナルに出力します。`iex` にパイプして実行してください。719* **コマンドがインストールせずにスクリプトテキストを出力する**:ダウンロード部分を実行部分なしで実行しました。`irm https://claude.ai/install.ps1` 単独でダウンロードされたスクリプトをターミナルに出力します。`iex` にパイプして実行してください。

576 720 

577 ```powershell theme={null}721 ```powershell theme={null}

578 irm https://claude.ai/install.ps1 | iex722 irm https://claude.ai/install.ps1 | iex


661 805 

662**解決策:**806**解決策:**

663 807 

6641. **スワップスペースを追加する**(サーバーの RAM が限定されている場合)。スワップはディスク領域をオーバーフロー メモリとして使用し、物理 RAM が少ない場合でもインストールを完了できます。8081. **スワップスペースを追加する**(サーバーの RAM が限定されている場合)。スワップはディスク領域をオーバーフローメモリとして使用し、物理 RAM が少ない場合でもインストールを完了できます。

665 809 

666 2 GB スワップファイルを作成して有効にします。810 2 GB スワップファイルを作成して有効にします。

667 811 


682 826 

6833. **可能であれば、より大きなインスタンスを使用する**。Claude Code には最低 4 GB の RAM が必要です。8273. **可能であれば、より大きなインスタンスを使用する**。Claude Code には最低 4 GB の RAM が必要です。

684 828 

829<h3 id="installation-was-killed-before-it-could-finish">

830 Installation was killed before it could finish

831</h3>

832 

833インストールスクリプトは、`claude install` ステップがシグナルによって終了された場合にそれを報告します。Linux では、終了コード 137 はプロセスが SIGKILL を受け取ったことを意味し、メモリの少ないホストでは通常、カーネルのメモリ不足(OOM)キラーによるものです。スクリプトは次の説明を出力し、終了コード 137 で終了します。

834 

835```text theme={null}

836Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

837Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

838```

839 

840その他の致命的なシグナルの場合、および macOS での終了コード 137 の場合、スクリプトは実際の終了コードを含む `Installation was killed before it could finish (exit code <N>)` を出力し、メモリ不足の説明は省略します。このメッセージは macOS と Linux が使用するインストールスクリプトから出力され、WSL 内でのインストールも対象になります。ネイティブ Windows のインストールスクリプトがこのメッセージを出力することはありません。v2.1.200 より前では、スクリプトはシェルの簡素な `Killed` 行だけを出力して終了していました。

841 

842**対処方法:**

843 

844* 他のプロセスを停止してメモリを解放してから、インストーラーを再実行する

845* スワップ領域を追加するか、より大きなインスタンスに移行する。スワップファイルのコマンドについては、[低メモリ Linux サーバーでインストールが強制終了される](#install-killed-on-low-memory-linux-servers)を参照してください。

846 

685<h3 id="install-hangs-in-docker">847<h3 id="install-hangs-in-docker">

686 Docker でのインストールハング848 Docker でのインストールハング

687</h3>849</h3>


704 866 

705組織の [サーバー管理設定](/docs/ja/server-managed-settings)に [セキュリティ承認](/docs/ja/server-managed-settings#security-approval-dialogs)が必要な変更が含まれている場合、v2.1.246 より前の Claude Code バージョンは `claude install` 中に承認ダイアログを表示しようとします。ダイアログは stdin のターミナルが必要です。インストーラーが `curl -fsSL https://claude.ai/install.sh | bash` のようにパイプから `claude install` を実行する場合、stdin はターミナルではなくパイプであるため、インストールは `Raw mode is not supported` を含むエラーで失敗します。867組織の [サーバー管理設定](/docs/ja/server-managed-settings)に [セキュリティ承認](/docs/ja/server-managed-settings#security-approval-dialogs)が必要な変更が含まれている場合、v2.1.246 より前の Claude Code バージョンは `claude install` 中に承認ダイアログを表示しようとします。ダイアログは stdin のターミナルが必要です。インストーラーが `curl -fsSL https://claude.ai/install.sh | bash` のようにパイプから `claude install` を実行する場合、stdin はターミナルではなくパイプであるため、インストールは `Raw mode is not supported` を含むエラーで失敗します。

706 868 

707Claude Code v2.1.246 以降は、`claude install` または `claude update` 中にダイアログを表示しません。コマンドは最後に承認した設定で実行され、Claude Code は次の対話型セッションでダイアログを表示します。組織のスタートアップ構成が [設定フェッチを待つ](/docs/ja/server-managed-settings#enforce-fail-closed-startup)場合(`forceRemoteSettingsRefresh` を設定する場合など)、ダイアログはこれらのコマンド中に表示され、パイプから実行されたインストールは失敗します。869Claude Code v2.1.246 以降は、`claude install` または `claude update` 中にダイアログを表示しません。コマンドは最後に承認した設定で実行され、Claude Code は次の対話型セッションでダイアログを表示します。組織のスタートアップ設定が [設定フェッチを待つ](/docs/ja/server-managed-settings#enforce-fail-closed-startup)場合(`forceRemoteSettingsRefresh` を設定する場合など)、ダイアログはこれらのコマンド中に表示され、パイプから実行されたインストールは失敗します。

708 870 

709他のすべての構成では、インストーラーを再実行するとこのエラーを回避できます。スクリプトは古いバージョンのインストールを要求した場合でも、最新リリースの `install` コマンドを実行するためです。プラットフォームのコマンドを再実行してください。871他のすべての設定では、インストーラーを再実行するとこのエラーを回避できます。スクリプトは古いバージョンのインストールを要求した場合でも、最新リリースの `install` コマンドを実行するためです。プラットフォームのコマンドを再実行してください。

710 872 

711<Tabs>873<Tabs>

712 <Tab title="macOS/Linux">874 <Tab title="macOS/Linux">


728 `claude update` または `claude doctor` がハングする890 `claude update` または `claude doctor` がハングする

729</h3>891</h3>

730 892 

731`claude update` と `claude doctor` は古い `claude` エイリアス `~/.zshrc`、`~/.bashrc`、`~/.config/fish/config.fish` のシェル構成ファイルをスキャンします。macOS では、存在する `~/.bash_profile`、`~/.bash_login`、または `~/.profile` の最初のものです。`ZDOTDIR` を設定する場合、Zsh ファイルは代わりに `$ZDOTDIR/.zshrc` です。これらのパスの 1 つがディレクトリの場合、Claude Code はそれをスキップし、両方のコマンドが正常に完了します。v2.1.214 より前では、これらのパスの 1 つにあるディレクトリは両方のコマンドをハングさせ、`/status` のシステム診断セクションを空白のままにしました。`claude doctor` はハングして出力がありません。`claude update` は `Checking for updates` を出力した直後にハングしました。893`claude update` と `claude doctor` は古い `claude` エイリアスを探してシェル設定ファイル `~/.zshrc`、`~/.bashrc`、`~/.config/fish/config.fish` をスキャンします。macOS では、さらに `~/.bash_profile`、`~/.bash_login`、`~/.profile` のうち最初に存在するものもスキャンします。`ZDOTDIR` を設定する場合、Zsh ファイルは代わりに `$ZDOTDIR/.zshrc` です。これらのパスの 1 つがディレクトリの場合、Claude Code はそれをスキップし、両方のコマンドが正常に完了します。v2.1.214 より前では、これらのパスの 1 つにあるディレクトリは両方のコマンドをハングさせ、`/status` のシステム診断セクションを空白のままにしました。`claude doctor` はハングして出力がありません。`claude update` は `Checking for updates` を出力した直後にハングしました。

732 894 

733影響を受けたバージョンでハングが発生した場合は、ディレクトリを見つけてください。このコマンドの出力では、`d` で始まる行がそのパスをディレクトリとしてマークします。`No such file or directory` 行は、そのパスに何も存在せず、原因ではないことを意味します。895影響を受けたバージョンでハングが発生した場合は、ディレクトリを見つけてください。このコマンドの出力では、`d` で始まる行がそのパスをディレクトリとしてマークします。`No such file or directory` 行は、そのパスに何も存在せず、原因ではないことを意味します。

734 896 


739ディレクトリを移動するか、v2.1.214 以降に更新してください。影響を受けたバージョンでは `claude update` がハングするため、代わりに [インストールスクリプト](/docs/ja/setup#install-claude-code)を再実行して更新してください。901ディレクトリを移動するか、v2.1.214 以降に更新してください。影響を受けたバージョンでは `claude update` がハングするため、代わりに [インストールスクリプト](/docs/ja/setup#install-claude-code)を再実行して更新してください。

740 902 

741<h3 id="claude-desktop-overrides-the-claude-command-on-windows">903<h3 id="claude-desktop-overrides-the-claude-command-on-windows">

742 Claude Desktop が Windows で `claude` コマンドをオーバーライドする904 Claude Desktop が Windows で `claude` コマンドを上書きする

743</h3>905</h3>

744 906 

745古いバージョンの Claude Desktop をインストールした場合、`WindowsApps` ディレクトリに `Claude.exe` を登録して、Claude Code CLI より PATH の優先度を高くする可能性があります。`claude` を実行すると、CLI ではなくデスクトップアプリが開きます。907古いバージョンの Claude Desktop をインストールした場合、`WindowsApps` ディレクトリに `Claude.exe` を登録して、Claude Code CLI より PATH の優先度を高くする可能性があります。`claude` を実行すると、CLI ではなくデスクトップアプリが開きます。


754 916 

755**PowerShell が PATH にない場合**、デフォルトの場所は `C:\Windows\System32\WindowsPowerShell\v1.0\` です。そのディレクトリを `PATH` に追加するか、`pwsh` を提供する [PowerShell 7](https://aka.ms/powershell) をインストールしてください。917**PowerShell が PATH にない場合**、デフォルトの場所は `C:\Windows\System32\WindowsPowerShell\v1.0\` です。そのディレクトリを `PATH` に追加するか、`pwsh` を提供する [PowerShell 7](https://aka.ms/powershell) をインストールしてください。

756 918 

757**Git for Windows をインストールする代わりに**、[git-scm.com/downloads/win](https://git-scm.com/downloads/win) からダウンロードしてください。セットアップ中に「Add to PATH」を選択してください。インストール後にターミナルを再起動してください。インストールすると Bash ツールが有効になり、Bash ベースのスクリプトとツーリングを操作するときに便利です。919**代わりに Git for Windows をインストールするには**、[git-scm.com/downloads/win](https://git-scm.com/downloads/win) からダウンロードしてください。セットアップ中に「Add to PATH」を選択してください。インストール後にターミナルを再起動してください。インストールすると Bash ツールが有効になり、Bash ベースのスクリプトとツーリングを操作するときに便利です。

758 920 

759**Git が既にインストールされている**が Claude Code が見つけられない場合は、その場所を Claude Code がチェックする場所と比較してください。`CLAUDE_CODE_GIT_BASH_PATH` が設定されていない場合、Claude Code は次の順序で `bash.exe` を探します。921**Git が既にインストールされている**が Claude Code が見つけられない場合は、その場所を Claude Code がチェックする場所と比較してください。`CLAUDE_CODE_GIT_BASH_PATH` が設定されていない場合、Claude Code は次の順序で `bash.exe` を探します。

760 922 

7611. デフォルトのインストール場所 `C:\Program Files\Git` と `C:\Program Files (x86)\Git`。9231. デフォルトのインストール場所 `C:\Program Files\Git` と `C:\Program Files (x86)\Git`。

7622. `PATH` 上の `git`。その Git インストールから `bin\bash.exe` を使用します。9242. `PATH` 上の `git`。その Git インストールから `bin\bash.exe` を使用します。

763 925 

764ステップ 2 では、Claude Code は Claude Code を起動したフォルダーに存在する `git`、またはそのパスの下で `node_modules` または `.venv` や `env` などの仮想環境フォルダーを含むパスをスキップします。例えば、`C:\dev\env\myproject` から起動した場合の `C:\dev\env\myproject\Git`。これにより、Claude Code がプロジェクトがそこに配置した実行可能ファイルを実行することを防ぎます。Git がそのような場所にある場合は、`CLAUDE_CODE_GIT_BASH_PATH` をそれに指します。926ステップ 2 では、Claude Code は Claude Code を起動したフォルダーに存在する `git`、またはその配下で `node_modules` や `.venv`、`env` などの仮想環境フォルダーを含むパスにある `git` をスキップします。例えば、`C:\dev\env\myproject` から起動した場合の `C:\dev\env\myproject\Git` です。これにより、Claude Code がプロジェクトがそこに配置した実行可能ファイルを実行することを防ぎます。Git がそのような場所にある場合は、`CLAUDE_CODE_GIT_BASH_PATH` でそのパスを指定してください。

765 927 

766**Claude Code を特定の Git インストールに指す**には、PowerShell で `where.exe git` を実行してそれを見つけ、そのインストールから `bin\bash.exe` パスを [settings.json ファイル](/docs/ja/settings)の `CLAUDE_CODE_GIT_BASH_PATH` として設定してください。928**Claude Code に特定の Git インストールを指定する**には、PowerShell で `where.exe git` を実行してそれを見つけ、そのインストールから `bin\bash.exe` パスを [settings.json ファイル](/docs/ja/settings)の `CLAUDE_CODE_GIT_BASH_PATH` として設定してください。

767 929 

768```json theme={null}930```json theme={null}

769{931{


773}935}

774```936```

775 937 

776**`CLAUDE_CODE_GIT_BASH_PATH` が正しいパスに設定されており、ファイルが存在する**が Claude Code がそれを使用しない場合は、ファイルの名前を最初に確認してください。Claude Code は `bash.exe`、`sh.exe`、`bash`、または `sh` という名前のファイルのみを受け入れます。Git for Windows の `git-bash.exe` ランチャーなど、他の名前では、変数を無視して Git Bash を自動検出し、`--debug` で表示される警告をログに記録します。存在しないパスは同じフォールバックと警告を取得します。v2.1.219 より前では、Claude Code は名前をチェックせずに既存のファイルを使用し、パスが存在しない場合は `Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path` で起動時に終了しました。938**`CLAUDE_CODE_GIT_BASH_PATH` が正しいパスに設定されており、ファイルが存在する**が Claude Code がそれを使用しない場合は、ファイルの名前を最初に確認してください。Claude Code は `bash.exe`、`sh.exe`、`bash`、または `sh` という名前のファイルのみを受け入れます。Git for Windows の `git-bash.exe` ランチャーなど、他の名前では、変数を無視して未設定の場合と同様に Git Bash を自動検出し、`--debug` で表示される警告をログに記録します。存在しないパスも同じフォールバックと警告の対象になります。v2.1.219 より前では、Claude Code は名前をチェックせずに既存のファイルをシェルとして使用し、パスが存在しない場合は `Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path` で起動時に終了しました。

777 939 

778ファイルの名前が正しい場合、AppLocker、グループポリシーソフトウェア制限ポリシー、EDR エージェントなどのエンドポイントセキュリティソフトウェアが干渉している可能性があります。IT チームに `claude.exe` と `cmd.exe` や `bash.exe` を含むそれが生成するプロセスをエンドポイント保護ポリシーでホワイトリストに登録するよう依頼してください。940ファイルの名前が正しい場合、AppLocker、グループポリシーソフトウェア制限ポリシー、EDR エージェントなどのエンドポイントセキュリティソフトウェアが干渉している可能性があります。IT チームに、エンドポイント保護ポリシーで `claude.exe` と、`cmd.exe` や `bash.exe` を含むそれが生成するプロセスを許可リストに登録するよう依頼してください。

779 941 

780<h3 id="claude-code-does-not-support-32-bit-windows">942<h3 id="claude-code-does-not-support-32-bit-windows">

781 Claude Code は 32 ビット Windows をサポートしていません943 Claude Code は 32 ビット Windows をサポートしていません


823 `Illegal instruction`985 `Illegal instruction`

824</h3>986</h3>

825 987 

826`claude` または インストーラーを実行すると `Illegal instruction` が出力される場合、ネイティブバイナリはプロセッサーがサポートしていない CPU 命令を使用しています。2 つの異なる原因があります。988`claude` またはインストーラーを実行すると `Illegal instruction` が出力される場合、ネイティブバイナリはプロセッサーがサポートしていない CPU 命令を使用しています。2 つの異なる原因があります。

827 989 

828**アーキテクチャの不一致。** インストーラーは間違ったバイナリをダウンロードしました。例えば ARM サーバーで x86。macOS または Linux で `uname -m` を使用して確認するか、PowerShell で `$env:PROCESSOR_ARCHITECTURE` を使用してください。結果が受け取ったバイナリと一致しない場合は、出力を含む [GitHub issue](https://github.com/anthropics/claude-code/issues) をファイルしてください。990**アーキテクチャの不一致。** インストーラーは間違ったバイナリをダウンロードしました。例えば ARM サーバーで x86。macOS または Linux で `uname -m` を使用して確認するか、PowerShell で `$env:PROCESSOR_ARCHITECTURE` を使用してください。結果が受け取ったバイナリと一致しない場合は、出力を含む [GitHub issue](https://github.com/anthropics/claude-code/issues) をファイルしてください。

829 991 


858 1020 

859**解決策:**1021**解決策:**

860 1022 

8611. **macOS バージョンを確認する**:Claude Code には macOS 13.0 以降が必要です。Apple メニューを開き、「このマックについて」を選択してバージョンを確認してください。10231. **macOS バージョンを確認する**:Claude Code には macOS 13.0 以降が必要です。Apple メニューを開き、「この Mac について」を選択してバージョンを確認してください。

862 1024 

8632. **macOS を更新する**(古いバージョンにいる場合)。バイナリは古い macOS バージョンがサポートしていないロードコマンドとシステムライブラリを使用しています。Homebrew などの代替インストール方法は同じバイナリをダウンロードし、このエラーを解決しません。10252. **macOS を更新する**(古いバージョンにいる場合)。バイナリは古い macOS バージョンがサポートしていないロードコマンドとシステムライブラリを使用しています。Homebrew などの代替インストール方法は同じバイナリをダウンロードし、このエラーを解決しません。

864 1026 


904 1066 

905**`claude` を実行するときの `exec: node: not found`。** WSL 環境は Node.js の Windows インストールを使用している可能性があります。`which npm` と `which node` で確認してください。`/mnt/c/` で始まるパスは Windows バイナリであり、Linux パスは `/usr/` で始まります。これを修正するには、Linux ディストリビューションのパッケージマネージャーまたは [`nvm`](https://github.com/nvm-sh/nvm) 経由で Node をインストールしてください。1067**`claude` を実行するときの `exec: node: not found`。** WSL 環境は Node.js の Windows インストールを使用している可能性があります。`which npm` と `which node` で確認してください。`/mnt/c/` で始まるパスは Windows バイナリであり、Linux パスは `/usr/` で始まります。これを修正するには、Linux ディストリビューションのパッケージマネージャーまたは [`nvm`](https://github.com/nvm-sh/nvm) 経由で Node をインストールしてください。

906 1068 

907**nvm バージョンの競合。** WSL と Windows の両方に nvm がインストールされている場合、WSL でノードバージョンを切り替えると、WSL がデフォルトで Windows PATH をインポートし、Windows nvm が優先されるため、破損する可能性があります。最も一般的な原因は、nvm がシェルに読み込まれていないことです。nvm ローダーを `~/.bashrc` または `~/.zshrc` に追加してください。1069**nvm バージョンの競合。** WSL と Windows の両方に nvm がインストールされている場合、WSL で Node バージョンを切り替えると、WSL がデフォルトで Windows PATH をインポートし、Windows nvm が優先されるため、破損する可能性があります。最も一般的な原因は、nvm がシェルに読み込まれていないことです。nvm ローダーを `~/.bashrc` または `~/.zshrc` に追加してください。

908 1070 

909```bash theme={null}1071```bash theme={null}

910export NVM_DIR="$HOME/.nvm"1072export NVM_DIR="$HOME/.nvm"


944 npm インストール後にネイティブバイナリが見つからない1106 npm インストール後にネイティブバイナリが見つからない

945</h3>1107</h3>

946 1108 

947`@anthropic-ai/claude-code` npm パッケージは、`@anthropic-ai/claude-code-darwin-arm64` などのプラットフォーム固有のオプション依存関係としてネイティブバイナリをダウンロードします。npm はパッケージの postinstall スクリプトを実行し、そのバイナリを `claude` コマンドとしてその場所にコピーします。実行されるまで、`claude` はプレースホルダースクリプトです。ダウンロードまたは postinstall ステップのいずれかがスキップされた場合、プレースホルダーはその場所に残り、macOS と Linux で `claude` を実行すると出力されます。1109`@anthropic-ai/claude-code` npm パッケージは、`@anthropic-ai/claude-code-darwin-arm64` などのプラットフォーム固有のオプション依存関係としてネイティブバイナリをダウンロードします。npm はパッケージの postinstall スクリプトを実行し、そのバイナリを `claude` コマンドとしてその場所にコピーします。実行されるまで、`claude` はプレースホルダースクリプトです。ダウンロードまたは postinstall ステップのいずれかがスキップされた場合、プレースホルダーはその場所に残り、macOS と Linux で `claude` を実行すると次のように出力されます。

948 1110 

949```text theme={null}1111```text theme={null}

950Error: claude native binary not installed.1112Error: claude native binary not installed.


964次の原因を確認してください。1126次の原因を確認してください。

965 1127 

966* **オプション依存関係が無効になっている。** npm インストールコマンドから `--omit=optional` を削除し、pnpm から `--no-optional` を削除し、yarn から `--ignore-optional` を削除し、`.npmrc` が `optional=false` を設定していないことを確認してください。次に再インストールしてください。ネイティブバイナリはオプション依存関係としてのみ配信されるため、スキップされた場合は JavaScript フォールバックがなく、`install.cjs` を再度実行してもダウンロードされなかったバイナリを配置できません。1128* **オプション依存関係が無効になっている。** npm インストールコマンドから `--omit=optional` を削除し、pnpm から `--no-optional` を削除し、yarn から `--ignore-optional` を削除し、`.npmrc` が `optional=false` を設定していないことを確認してください。次に再インストールしてください。ネイティブバイナリはオプション依存関係としてのみ配信されるため、スキップされた場合は JavaScript フォールバックがなく、`install.cjs` を再度実行してもダウンロードされなかったバイナリを配置できません。

967* **インストールスクリプトが無効になっている。** `--ignore-scripts` と一部の pnpm 構成は postinstall ステップをスキップしますが、プラットフォームパッケージはダウンロードします。メッセージが示唆するように `node node_modules/@anthropic-ai/claude-code/install.cjs` を実行するか、フラグなしで再インストールしてください。postinstall が環境でまったく実行できない場合、`node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs` はダウンロードされたパッケージを見つけて起動します。各開始時に追加の Node プロセスのコストで。ラッパーが代わりに `Could not find native binary package` を出力する場合、プラットフォームパッケージはダウンロードされなかったため、最初に上記のオプション依存関係の原因を修正してください。1129* **インストールスクリプトが無効になっている。** `--ignore-scripts` と一部の pnpm 設定は postinstall ステップをスキップしますが、プラットフォームパッケージはダウンロードします。メッセージが示唆するように `node node_modules/@anthropic-ai/claude-code/install.cjs` を実行するか、フラグなしで再インストールしてください。postinstall が環境でまったく実行できない場合、`node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs` はダウンロードされたパッケージを見つけて起動します。ただし、起動のたびに追加の Node プロセスが必要になります。ラッパーが代わりに `Could not find native binary package` を出力する場合、プラットフォームパッケージはダウンロードされなかったため、最初に上記のオプション依存関係の原因を修正してください。

968* **サポートされていないプラットフォーム。** プリビルトバイナリは `darwin-arm64`、`darwin-x64`、`linux-x64`、`linux-arm64`、`linux-x64-musl`、`linux-arm64-musl`、`win32-x64`、`win32-arm64` に対して公開されています。Claude Code は他のプラットフォーム用のバイナリを出荷しません。[システム要件](/docs/ja/setup#system-requirements)を参照してください。FreeBSD では、インストーラーはプラットフォームをサポートされていないと報告します。v2.1.205 より前では、FreeBSD を Linux として扱い、実行できないバイナリをダウンロードしました。1130* **サポートされていないプラットフォーム。** プリビルトバイナリは `darwin-arm64`、`darwin-x64`、`linux-x64`、`linux-arm64`、`linux-x64-musl`、`linux-arm64-musl`、`win32-x64`、`win32-arm64` に対して公開されています。Claude Code は他のプラットフォーム用のバイナリを出荷しません。[システム要件](/docs/ja/setup#system-requirements)を参照してください。FreeBSD では、インストーラーはプラットフォームをサポートされていないと報告します。v2.1.205 より前では、FreeBSD を Linux として扱い、実行できないバイナリをダウンロードしました。

969* **企業 npm ミラーがプラットフォームパッケージを欠落している。** レジストリがメタパッケージに加えて 8 つすべての `@anthropic-ai/claude-code-*` プラットフォームパッケージをミラーしていることを確認してください。1131* **企業 npm ミラーがプラットフォームパッケージを欠落している。** レジストリがメタパッケージに加えて 8 つすべての `@anthropic-ai/claude-code-*` プラットフォームパッケージをミラーしていることを確認してください。

970 1132 


983npm error ENOTEMPTY: directory not empty, rename '...'1145npm error ENOTEMPTY: directory not empty, rename '...'

984```1146```

985 1147 

986`npm error path` 行は npm が移動できなかったディレクトリに名前を付けます。そのディレクトリと、以前の中断された実行が残す可能性のある隣接する `.claude-code-*` ディレクトリを削除してください。以下のコマンドは `npm root -g` でグローバルパッケージディレクトリを見つけます。`npm error path` 行が名前を付けるディレクトリが `npm root -g` が出力するディレクトリの下にない場合(例えば nvm でノードバージョンを切り替えたため)、エラーが名前を付けるディレクトリを削除してください。1148`npm error path` 行は npm が移動できなかったディレクトリを示します。そのディレクトリと、以前の中断された実行が残す可能性のある隣接する `.claude-code-*` ディレクトリを削除してください。以下のコマンドは `npm root -g` でグローバルパッケージディレクトリを見つけます。`npm error path` 行が示すディレクトリが `npm root -g` が出力するディレクトリの下にない場合(例えば nvm で Node バージョンを切り替えたため)、エラーが示すディレクトリを削除してください。

987 1149 

988<Tabs>1150<Tabs>

989 <Tab title="macOS/Linux">1151 <Tab title="macOS/Linux">


991 rm -rf "$(npm root -g)/@anthropic-ai/claude-code"1153 rm -rf "$(npm root -g)/@anthropic-ai/claude-code"

992 ```1154 ```

993 1155 

994 次に残りのテンポディレクトリを削除してください。Zsh が `no matches found` を出力する場合、削除するものはありませんでした。1156 次に残りの一時ディレクトリを削除してください。Zsh が `no matches found` を出力する場合、削除するものはありませんでした。

995 1157 

996 ```bash theme={null}1158 ```bash theme={null}

997 rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*1159 rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*

Details

11| 症状 | 移動先 |11| 症状 | 移動先 |

12| :- | :- |12| :- | :- |

13| `command not found`、インストール失敗、PATH の問題、`EACCES`、TLS エラー | [インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install) |13| `command not found`、インストール失敗、PATH の問題、`EACCES`、TLS エラー | [インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install) |

14| 更新またはインストールダウンロードが `The connection dropped while downloading the update` または `aborted` で失敗する | [エラーリファレンス](/docs/ja/errors#the-connection-dropped-while-downloading-the-update) |14| 更新またはインストールダウンロードが `The connection dropped while downloading the update` または `aborted` で失敗する | [インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |

15| ログインループ、OAuth エラー、`403 Forbidden`、「organization disabled」、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry 認証情報 | [インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install#login-and-authentication) |15| ログインループ、OAuth エラー、`403 Forbidden`、「organization disabled」、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry 認証情報 | [インストールとログインのトラブルシューティング](/docs/ja/troubleshoot-install#login-and-authentication) |

16| 設定が適用されない、hooks が実行されない、MCP サーバーがロードされない | [設定をデバッグする](/docs/ja/debug-your-config) |16| 設定が適用されない、hooks が実行されない、MCP サーバーがロードされない | [設定をデバッグする](/docs/ja/debug-your-config) |

17| セッションが auto モードで開始された、または Claude がファイルを編集してコマンドを実行する(確認なし) | [セッションが開始するモード](/docs/ja/permission-modes#which-mode-a-session-starts-in) |17| セッションが auto モードで開始された、または Claude がファイルを編集してコマンドを実行する(確認なし) | [セッションが開始するモード](/docs/ja/permission-modes#which-mode-a-session-starts-in) |

ultrareview.md +6 −6

Details

56 プルリクエストをレビューする56 プルリクエストをレビューする

57</h3>57</h3>

58 58 

59GitHub プルリクエストをレビューするには、PR 番号を渡します。59ローカルブランチではなく `github.com` 上のプルリクエストをレビューするには、PR 番号を渡します。

60 60 

61```text theme={null}61```text theme={null}

62/code-review ultra 123462/code-review ultra 1234


64 64 

65このコマンドは `#1234`、`PR 1234`、および貼り付けられた PR URL も受け入れます。貼り付けられた URL は現在のディレクトリ内のリポジトリを指す必要があります。65このコマンドは `#1234`、`PR 1234`、および貼り付けられた PR URL も受け入れます。貼り付けられた URL は現在のディレクトリ内のリポジトリを指す必要があります。

66 66 

67PR モードでは、クラウドサンドボックスはローカルの作業ツリーをバンドルするのではなく、ホストから直接プルリクエストをクローンします。PR モードは `github.com` 上のリポジトリおよび Claude Code に接続されている Owner が設定した [GitHub Enterprise Server](/docs/ja/github-enterprise-server) インスタンスで機能します。67PR モードには `github.com` 上のリポジトリが必要です。[GitHub Enterprise Server](/docs/ja/github-enterprise-server) インスタンス上のリポジトリの場合は、PR 番号なしで `/code-review ultra` を実行し、代わりにローカルブランチをレビューしてください。

68 68 

69`github.com` 上のリポジトリの場合、サンドボックスは Claude アカウントに接続された GitHub アカウントでクローンするため、そのアカウントは PR のリポジトリを読み取ることができる必要があります。69PR モードでは、クラウドサンドボックスは作業ツリーをアップロードするのではなく、`github.com` からプルリクエストをクローンします。その際には Claude アカウントに接続された GitHub アカウントを使用するため、そのアカウントにはリポジトリへの読み取りアクセス権が必要です。

70 70 

71[`/web-setup`](/docs/ja/web-quickstart#connect-from-your-terminal) を実行して、GitHub CLI ログインを Claude アカウントに接続します。71[`/web-setup`](/docs/ja/web-quickstart#connect-from-your-terminal) を実行して、GitHub CLI ログインを Claude アカウントに接続します。

72 72 


74 プルリクエストに検出結果を投稿する74 プルリクエストに検出結果を投稿する

75</h3>75</h3>

76 76 

77Claude Code v2.1.227 以降では、`github.com` 上のプルリクエストをレビューするときに、Claude が完成した検出結果を PR に自分の GitHub アカウントからの単一のプレーンコメントとして投稿するようにできます。コメントはレビューまたは承認ではなく、「Generated by Claude Code」という注記で終わります。ブランチまたは GitHub Enterprise Server プルリクエストをレビューする場合、Claude Code はセッションにのみ検出結果を表示します。77Claude Code v2.1.227 以降では、`github.com` 上のプルリクエストをレビューするときに、Claude が完成した検出結果を PR に自分の GitHub アカウントからの単一のプレーンコメントとして投稿するようにできます。コメントはレビューまたは承認ではなく、「Generated by Claude Code」という注記で終わります。ブランチをレビューする場合、Claude Code はセッションにのみ検出結果を表示します。

78 78 

79Claude Code は選択しない限り投稿しません。`--no-post` がデフォルトです。投稿は実行ごとに行う選択です。79Claude Code は選択しない限り投稿しません。`--no-post` がデフォルトです。投稿は実行ごとに行う選択です。

80 80 


106Claude Code はテキストが複数の単語を持ち、ブランチ名または PR 参照ではない場合にのみ、テキストをメモとして扱います。単一の単語を読み取ると、ブランチ名または PR 参照として読み取られるため、タイプミスされたブランチ名は [異なるベースに対してレビューする](#review-against-a-different-base)からの最も近いブランチエラーを取得します。テキストが `check PR 123 again` などの PR 参照と他の単語を組み合わせる場合、Claude Code も起動しません。PR 番号のみで再実行してその PR をレビューするか、参照なしで現在のブランチをレビューするよう求めます。106Claude Code はテキストが複数の単語を持ち、ブランチ名または PR 参照ではない場合にのみ、テキストをメモとして扱います。単一の単語を読み取ると、ブランチ名または PR 参照として読み取られるため、タイプミスされたブランチ名は [異なるベースに対してレビューする](#review-against-a-different-base)からの最も近いブランチエラーを取得します。テキストが `check PR 123 again` などの PR 参照と他の単語を組み合わせる場合、Claude Code も起動しません。PR 番号のみで再実行してその PR をレビューするか、参照なしで現在のブランチをレビューするよう求めます。

107 107 

108<Tip>108<Tip>

109 リポジトリが大きすぎてバンドルできない場合、Claude Code は代わりに PR モードを使用するよう促します。ブランチをプッシュしてドラフト PR を開き、`/code-review ultra <PR-number>` を実行してください。109 リポジトリが大きすぎてバンドルできない場合、Claude Code は代わりに PR モードを使用するよう促します。`github.com` 上のリポジトリの場合は、ブランチをプッシュしてドラフト PR を開き、`/code-review ultra <PR-number>` を実行してください。

110</Tip>110</Tip>

111 111 

112<h3 id="diff-limits-and-fallbacks">112<h3 id="diff-limits-and-fallbacks">


173claude ultrareview origin/main173claude ultrareview origin/main

174```174```

175 175 

176引数なしの場合、サブコマンドは現在のブランチとデフォルトブランチ間の差分をレビューします。マージベースが存在しない場合は、`/code-review ultra` と同じ[リポジトリ全体フォールバック](#diff-limits-and-fallbacks)を使用します。PR 番号を渡してプルリクエストをレビューするか、ベースブランチを渡してそれに対してレビューします。[ベースブランチ処理](#review-against-a-different-base)は対話的コマンドと一致します。176引数なしの場合、サブコマンドは現在のブランチとデフォルトブランチ間の差分をレビューします。マージベースが存在しない場合は、`/code-review ultra` と同じ[リポジトリ全体フォールバック](#diff-limits-and-fallbacks)を使用します。PR 番号を渡して [`github.com` 上のプルリクエストをレビュー](#review-a-pull-request)するか、ベースブランチを渡してそれに対してレビューします。[ベースブランチ処理](#review-against-a-different-base)は対話的コマンドと一致します。

177 177 

178サブコマンドを実行すると、リポジトリ全体フォールバックと課金および利用規約プロンプトに同意したことになるため、入力を待たずに実行が開始されます。自分で実行することが同意としてカウントされます。Claude がたとえば Bash ツールを通じてサブコマンドを代わりに実行する場合、Claude Code はリポジトリ全体レビューを拒否します。178サブコマンドを実行すると、リポジトリ全体フォールバックと課金および利用規約プロンプトに同意したことになるため、入力を待たずに実行が開始されます。自分で実行することが同意としてカウントされます。Claude がたとえば Bash ツールを通じてサブコマンドを代わりに実行する場合、Claude Code はリポジトリ全体レビューを拒否します。

179 179 

vs-code.md +2 −0

Details

166* **ブックマーク**: 応答にマウスを置いて **Bookmark response** をクリックして保存するか、保存された応答で **Remove bookmark** をクリックして削除します。166* **ブックマーク**: 応答にマウスを置いて **Bookmark response** をクリックして保存するか、保存された応答で **Remove bookmark** をクリックして削除します。

167 167 

168 保存された応答を確認するには、Bookmarks パネルを開きます。Claude Code パネルの上部にあるブックマークアイコンをクリックするか、コマンドメニューの Context セクションで **Bookmarks** を選択するか、`/bookmarks` を入力します。Claude Code v2.1.286 以降が必要です。168 保存された応答を確認するには、Bookmarks パネルを開きます。Claude Code パネルの上部にあるブックマークアイコンをクリックするか、コマンドメニューの Context セクションで **Bookmarks** を選択するか、`/bookmarks` を入力します。Claude Code v2.1.286 以降が必要です。

169* **Claude が送信したファイル**: セッションが [Remote Control](/docs/ja/remote-control#start-a-remote-control-session) に接続されていて、Claude が [`SendUserFile` ツール](/docs/ja/tools-reference)でファイルを送信すると、会話に **Sent report.md, chart.png** のような行が表示されます。ファイル名をクリックするとエディターで開きます。

169* **コンテキスト表示**: プロンプトボックスは Claude のコンテキストウィンドウをどの程度使用しているかを表示します。Claude は必要に応じて自動的にコンパクトにするか、`/compact` を手動で実行できます。170* **コンテキスト表示**: プロンプトボックスは Claude のコンテキストウィンドウをどの程度使用しているかを表示します。Claude は必要に応じて自動的にコンパクトにするか、`/compact` を手動で実行できます。

170* **プロンプトキャッシュクロック**: コンテキスト表示の横にある時計アイコンは、会話の[プロンプトキャッシュ](/docs/ja/prompt-caching)が期限切れになるまでの時間を推定します。キャッシュの 5 分または 1 時間の[有効期限](/docs/ja/prompt-caching#cache-lifetime)からカウントダウンし、キャッシュを使用する各応答がカウントダウンを再開します。コンパクション以外に、[キャッシュを無効にするアクション](/docs/ja/prompt-caching#actions-that-invalidate-the-cache)はクロックをリセットしないため、モデルを切り替えた後も残り時間を表示できます。171* **プロンプトキャッシュクロック**: コンテキスト表示の横にある時計アイコンは、会話の[プロンプトキャッシュ](/docs/ja/prompt-caching)が期限切れになるまでの時間を推定します。キャッシュの 5 分または 1 時間の[有効期限](/docs/ja/prompt-caching#cache-lifetime)からカウントダウンし、キャッシュを使用する各応答がカウントダウンを再開します。コンパクション以外に、[キャッシュを無効にするアクション](/docs/ja/prompt-caching#actions-that-invalidate-the-cache)はクロックをリセットしないため、モデルを切り替えた後も残り時間を表示できます。

171 * カウントダウンが終了するまで、アイコンは **12m** などの残り時間を表示します。172 * カウントダウンが終了するまで、アイコンは **12m** などの残り時間を表示します。


597| `useCtrlEnterToSend` | `false` | Enter の代わりに Ctrl/Cmd+Enter を使用してプロンプトを送信します |598| `useCtrlEnterToSend` | `false` | Enter の代わりに Ctrl/Cmd+Enter を使用してプロンプトを送信します |

598| `scrollToBottomOnSend` | `true` | メッセージを送信するときに会話を下部にスクロールします。オフの場合、会話は元の位置に留まります。Claude Code v2.1.275 以降が必要です |599| `scrollToBottomOnSend` | `true` | メッセージを送信するときに会話を下部にスクロールします。オフの場合、会話は元の位置に留まります。Claude Code v2.1.275 以降が必要です |

599| `showMessageTimestamps` | `true` | 各メッセージが送信された日時を表示します。日付が変わる位置には日付行が表示されます。Claude Code v2.1.284 以降が必要です。v2.1.290 より前は、デフォルトは `false` でした |600| `showMessageTimestamps` | `true` | 各メッセージが送信された日時を表示します。日付が変わる位置には日付行が表示されます。Claude Code v2.1.284 以降が必要です。v2.1.290 より前は、デフォルトは `false` でした |

601| `spinnerVerbs` | `{"mode": "append", "verbs": []}` | ターンの実行中に会話のスピナーが順に表示する動詞を設定します。CLI の [`spinnerVerbs`](/docs/ja/settings-reference#spinnerverbs) と同じ `mode` フィールドと `verbs` フィールドを使用します。 |

600| `enableNewConversationShortcut` | `false` | Cmd/Ctrl+N を有効にして新しい会話を開始します |602| `enableNewConversationShortcut` | `false` | Cmd/Ctrl+N を有効にして新しい会話を開始します |

601| `enableReopenClosedSessionShortcut` | `true` | Cmd/Ctrl+Shift+T を使用して、最近閉じた Claude セッションタブを再度開きます。最後に閉じたタブが Claude セッションではなかった場合、ショートカットは VS Code の通常の再度開く閉じたエディターコマンドを実行します。 |603| `enableReopenClosedSessionShortcut` | `true` | Cmd/Ctrl+Shift+T を使用して、最近閉じた Claude セッションタブを再度開きます。最後に閉じたタブが Claude セッションではなかった場合、ショートカットは VS Code の通常の再度開く閉じたエディターコマンドを実行します。 |

602| `archiveInactiveSessions` | `14` | この日数アクティビティがない場合、[セッションを自動的にアーカイブします](#resume-past-conversations):`1`、`2`、`7`、または `14`。`0` に設定してオフにします。Claude Code v2.1.265 以降が必要です |604| `archiveInactiveSessions` | `14` | この日数アクティビティがない場合、[セッションを自動的にアーカイブします](#resume-past-conversations):`1`、`2`、`7`、または `14`。`0` に設定してオフにします。Claude Code v2.1.265 以降が必要です |

workflows.md +27 −1

Details

354 354 

355本体は最上位の `await` を持つプレーン JavaScript です。`agent()` は 1 つのサブエージェントを生成し、`pipeline()` はリスト内の 1 つのアイテムごとに 1 つを実行し、`parallel()` は一連のエージェント タスクを同時に実行してすべてが完了するのを待ちます。355本体は最上位の `await` を持つプレーン JavaScript です。`agent()` は 1 つのサブエージェントを生成し、`pipeline()` はリスト内の 1 つのアイテムごとに 1 つを実行し、`parallel()` は一連のエージェント タスクを同時に実行してすべてが完了するのを待ちます。

356 356 

357`agent()` 呼び出しは、実行中に停止した場合または回復不可能な API エラーが発生した場合は `null` に解決されます。`pipeline()` はその `null` を結果配列に保持するため、例は `.filter(Boolean)` で終わってそれらのエントリを削除します。357`agent()` 呼び出しは、実行中に停止した場合または回復不可能な API エラーが発生した場合は `null` に解決されます。`pipeline()` はその `null` を結果配列に保持するため、例は `.filter(Boolean)` で終わり、[すべての試行で停止したエージェント](#when-an-agent-stalls-and-restarts)のスロットを含め、それらのエントリを削除します。

358 358 

359[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)では、スクリプトが `agent()` に渡すプロンプトは、分類器がそのサブエージェントのアクションをレビューするときにあなたからのリクエストとしてカウントされません。Claude Code はそれをスクリプトが計算したテキストとしてマークするためです。359[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)では、スクリプトが `agent()` に渡すプロンプトは、分類器がそのサブエージェントのアクションをレビューするときにあなたからのリクエストとしてカウントされません。Claude Code はそれをスクリプトが計算したテキストとしてマークするためです。

360 360 


463* 制限は 24 時間以内にリセットされます。週単位の制限はさらに先にリセットされる可能性があります。463* 制限は 24 時間以内にリセットされます。週単位の制限はさらに先にリセットされる可能性があります。

464* ランはまだ 2 回待機していません。3 回目に制限に達すると、エージェントは失敗します。464* ランはまだ 2 回待機していません。3 回目に制限に達すると、エージェントは失敗します。

465 465 

466<h3 id="when-an-agent-stalls-and-restarts">

467 エージェントが停滞して再起動するとき

468</h3>

469 

470出力が十分長い時間届かなくなったエージェントは、同じプロンプトから最初からやり直します。[`/workflows`](#watch-the-run) では、その名前に `(retry 1)` サフィックスが付き、詳細に `attempt 2 (stalled)` と表示されます。再起動は自動で行われるため、何もする必要はありません。

471 

472新しい試行は、停滞した試行のトランスクリプトなしで開始されます。停滞した試行が既に変更したファイルは変更されたままで、その試行が消費したトークンはランの合計に残ります。停滞ウィンドウとは、Claude Code が試行を終了する前にエージェントからの出力を待つ時間です。エージェントが自身のツール呼び出しや[使用制限のリセット](#when-a-run-hits-your-usage-limit)を待っている時間は、停滞ウィンドウにカウントされません。

473 

474エージェントの再起動は、`r` で要求した再起動も含めて最大 5 回です。6 回目の試行も停滞した場合、`agent()` 呼び出しは失敗し、エラーの冒頭にその理由が示されます。

475 

476* `agent stalled on all 6 attempts`: すべての試行がウィンドウ全体の間、出力なしで経過しました。エージェントの作業がそれほど長く出力を伴わないものである場合は、ウィンドウを長くしてください

477* `agent lost its reply on all 6 attempts`: すべての試行の応答ストリームが途絶え、Claude Code がその待機を諦めました。[ストリーミングアイドルウォッチドッグ](/docs/ja/network-config#streaming-idle-watchdogs)が先に応答を終了させたため、停滞ウィンドウを長くしても効果はありません。そのウォッチドッグのタイムアウトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定します

478* `agent abandoned after 6 attempts`: 試行がそれぞれ異なる方法で終了しました。エラーにはそれらが順番に列挙されます

479 

480ウィンドウが終了する前に出力を生成するための時間をエージェントに多く与えるには:

481 

482* **1 つのエージェント**: その `agent()` 呼び出しでミリ秒単位の `stallMs` を渡します。たとえば 30 分なら `agent(prompt, { stallMs: 1800000 })` です

483* **すべてのエージェント**: [`CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`](/docs/ja/env-vars#variables) を設定します。これはワークフロー外のサブエージェントにも適用されます

484 

485失敗後にランが続行されるかどうかは、スクリプトがエージェントをどのように呼び出したかによって異なります。

486 

487* **[`parallel()` または `pipeline()`](#what-the-saved-script-looks-like) 内**: ランはエージェントの結果の代わりに `null` を使用して続行されます

488* **直接 await した場合**: ランはエラーで終了します

489 

490再試行するには、Claude にワークフローを再起動するよう依頼してください。何が再度実行されるかについては、[一時停止後に再開する](#resume-after-a-pause)を参照してください。

491 

466<h3 id="cost">492<h3 id="cost">

467 コスト493 コスト

468</h3>494</h3>

worktrees.md +1 −1

Details

104* **Git のリダイレクト**: Claude Code は、git をメインチェックアウトにリダイレクトする Bash または Monitor コマンドをブロックします。リダイレクトは、`git -C`、`--git-dir`、`GIT_DIR` または `GIT_WORK_TREE` 変数、あるいは git を実行する前のメインチェックアウトへの `cd` によって発生する可能性があります。104* **Git のリダイレクト**: Claude Code は、git をメインチェックアウトにリダイレクトする Bash または Monitor コマンドをブロックします。リダイレクトは、`git -C`、`--git-dir`、`GIT_DIR` または `GIT_WORK_TREE` 変数、あるいは git を実行する前のメインチェックアウトへの `cd` によって発生する可能性があります。

105* **コマンドの形式**: Claude Code は、コマンドが実行する git が worktree 内にとどまることをコマンドテキストから検証できない場合、Bash または Monitor コマンドをブロックします。これは、たとえばコマンド名が実行時に計算される場合、構文を解析できない場合、または `${!name}` や `${ command; }` などの展開がテキストに明記されていないコマンドを実行する可能性がある場合に発生します。Claude Code は、拒否されたコマンドを単純な個別のコマンドに分割するなど、書き直す方法を Claude に伝えます。このチェックをオフにすることはできません。105* **コマンドの形式**: Claude Code は、コマンドが実行する git が worktree 内にとどまることをコマンドテキストから検証できない場合、Bash または Monitor コマンドをブロックします。これは、たとえばコマンド名が実行時に計算される場合、構文を解析できない場合、または `${!name}` や `${ command; }` などの展開がテキストに明記されていないコマンドを実行する可能性がある場合に発生します。Claude Code は、拒否されたコマンドを単純な個別のコマンドに分割するなど、書き直す方法を Claude に伝えます。このチェックをオフにすることはできません。

106 106 

107これらのチェックが読み取るのは、編集の対象となるパス、コマンドが実行されるディレクトリ、およびコマンドのテキストです。シェルコマンドがどのファイルに書き込むかを追跡するチェックはないため、`cp` やシェルのリダイレクトなど、メインチェックアウトで git を実行せずにメインチェックアウトに書き込むコマンドは、これらのチェックでは拒否されません。Claude Code はそのようなコマンドを他のシェルコマンドと同様に扱うため、実行されるか確認を求められるかは、[権限モード](/docs/ja/permission-modes)とルールによって決まります。107これらのチェックが読み取るのは、編集の対象となるパス、コマンドが実行されるディレクトリ、およびコマンドのテキストです。シェルコマンドがどのファイルに書き込むかを追跡するチェックはないため、`cp` やシェルのリダイレクトなど、メインチェックアウトで git を実行せずにメインチェックアウトに書き込むコマンドは、これらのチェックでは拒否されません。Claude Code はそのようなコマンドを、[権限](/docs/ja/permissions)と[サンドボックス化](/docs/ja/sandboxing)の設定のもとで他のシェルコマンドと同様に扱います。

108 108 

109チェックは、Claude Code を起動したリポジトリに適用されます。リンクされた worktree のリンク元であるメインチェックアウトも対象になります。PowerShell コマンドについては、Claude Code は作業ディレクトリのチェックのみを適用します。109チェックは、Claude Code を起動したリポジトリに適用されます。リンクされた worktree のリンク元であるメインチェックアウトも対象になります。PowerShell コマンドについては、Claude Code は作業ディレクトリのチェックのみを適用します。

110 110