Documentation — Spybara

admin-setup.md +2 −0

Details

92 92

93claude.ai または Anthropic API を通じて認証するメンバーを持つ組織は、設定をデプロイせずにモデルを管理することもできます。[organization model restrictions](/ja/model-config#organization-model-restrictions) は個別のモデルを無効化し、[organization default model](/ja/model-config#organization-default-model) は新しいセッションが開始するモデルを設定し、[organization effort limits](/ja/model-config#organization-effort-limits) はロールごとのエフォートレベルを制限します。3 つのコントロールすべてに Claude Enterprise プランが必要です。モデル制限とエフォート制限はサーバー側で実行されます。デフォルトモデルは、組織がそれを実行しない限り、ユーザーが変更できる開始点です。実行は限定的な組織セットで利用可能です。可用性については、Anthropic アカウントチームにお問い合わせください。これらのコントロールのいずれも、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または [Claude Platform on AWS](/ja/claude-platform-on-aws) 上のセッションには到達しません。これらのプロバイダーでは、制限に上記の `availableModels` を使用し、マネージド設定の `model` キーをデフォルトに使用してください。

93パーミッションルールとサンドボックスは異なるレイヤーをカバーします。WebFetch を拒否すると Claude の fetch ツールがブロックされますが、Bash が許可されている場合、`curl` と `wget` は依然として任意の URL に到達できます。サンドボックスは OS レベルで実行されるネットワークドメイン許可リストでそのギャップを閉じます。95パーミッションルールとサンドボックスは異なるレイヤーをカバーします。WebFetch を拒否すると Claude の fetch ツールがブロックされますが、Bash が許可されている場合、`curl` と `wget` は依然として任意の URL に到達できます。サンドボックスは OS レベルで実行されるネットワークドメイン許可リストでそのギャップを閉じます。

94 96

95これらの制御が防御する脅威モデルについては、[Security](/ja/security) を参照してください。97これらの制御が防御する脅威モデルについては、[Security](/ja/security) を参照してください。

advisor.md +4 −3

Details

85advisor はメインモデル以上の機能を持つ必要があります。各メインモデルで受け入れられる advisor は次のとおりです。85advisor はメインモデル以上の機能を持つ必要があります。各メインモデルで受け入れられる advisor は次のとおりです。

86 86

87| メインモデル | 受け入れられる advisor | 注記 |87| メインモデル | 受け入れられる advisor | 注記 |

~~88| ----------------------------------------------- | -------------------------- | ----------------------------------------------------------------------------- |~~88| ----------------------------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------- |

90| Sonnet 4.6 | Fable、Opus、Sonnet | |90| Sonnet 4.6 | Fable、Opus、Sonnet | |

93| Opus 4.7 以降 | Fable、Opus 4.7、Opus 4.8 | Opus 4.7 と Opus 4.8 は同等の機能として評価されるため、どちらでも他方を advisor として受け入れます。Opus 4.6 または Sonnet 5 advisor を持つ Opus 4.7 メインは拒否されます |

93| Fable 5 ({/* min-version: 2.1.170 */}v2.1.170+) | Fable | Opus または Sonnet advisor は拒否されます |94| Fable 5 ({/* min-version: 2.1.170 */}v2.1.170+) | Fable | Opus または Sonnet advisor は拒否されます |

94 95

95Fable 5 は、メインモデルとして機能するか advisor として機能するかに関わらず、Claude Code v2.1.170 以降と Fable 5 アクセスが必要です。96Fable 5 は、メインモデルとして機能するか advisor として機能するかに関わらず、Claude Code v2.1.170 以降と Fable 5 アクセスが必要です。

174/advisor off175/advisor off

175```176```

176 177

177advisor ツール全体（`/advisor` コマンドと `--advisor` フラグを含む）を無効にするには、`CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1` を設定します。[環境変数](/ja/env-vars)を参照してください。178advisor ツール全体を無効にするには、`CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1` を設定します。`/advisor` コマンドは利用できなくなり、設定された `advisorModel` は無視されます。`--advisor` フラグは受け入れられますが、効果はありません。このフラグを渡す既存のスクリプトはエラーなしで動作し続けます。[環境変数](/ja/env-vars)を参照してください。

178 179

179<h2 id="compare-with-related-features">180<h2 id="compare-with-related-features">

180 関連機能との比較181 関連機能との比較

agent-sdk/agent-loop.md +43 −2

Details

66* **`StreamEvent`：** 部分メッセージが有効な場合のみ生成されます。生の API ストリーミングイベント（テキストデルタ、ツール入力チャンク）を含みます。[ストリーム応答](/ja/agent-sdk/streaming-output)を参照してください。66* **`StreamEvent`：** 部分メッセージが有効な場合のみ生成されます。生の API ストリーミングイベント（テキストデルタ、ツール入力チャンク）を含みます。[ストリーム応答](/ja/agent-sdk/streaming-output)を参照してください。

67* **`ResultMessage`：** エージェントループの終了をマークします。最終テキスト結果、トークン使用量、コスト、およびセッション ID を含みます。`subtype` フィールドをチェックして、タスクが成功したか制限に達したかを判断します。`prompt_suggestion` などの少数の末尾システムイベントはその後に到着する可能性があるため、結果で中断するのではなく、ストリームを完了まで反復処理します。[結果を処理する](#handle-the-result)を参照してください。67* **`ResultMessage`：** エージェントループの終了をマークします。最終テキスト結果、トークン使用量、コスト、およびセッション ID を含みます。`subtype` フィールドをチェックして、タスクが成功したか制限に達したかを判断します。`prompt_suggestion` などの少数の末尾システムイベントはその後に到着する可能性があるため、結果で中断するのではなく、ストリームを完了まで反復処理します。[結果を処理する](#handle-the-result)を参照してください。

68 68

69これら 5 つのタイプは、両方の SDK でエージェントループライフサイクル全体をカバーしています。TypeScript SDK は、追加の観測可能性イベント（フックイベント、ツール進捗、レート制限、タスク通知）も生成し、追加の詳細を提供しますが、ループを駆動するために必須ではありません。完全なリストについては、[Python メッセージタイプリファレンス](/ja/agent-sdk/python#message-types)と[TypeScript メッセージタイプリファレンス](/ja/agent-sdk/typescript#message-types)を参照してください。69これら 5 つのタイプは、両方の SDK でエージェントループライフサイクル全体をカバーしています。TypeScript SDK は、追加の観測可能性イベント（フックイベント、ツール進捗、レート制限、タスク通知）も生成し、追加の詳細を提供しますが、ループを駆動するために必須ではありません。完全なリストについては、[Python メッセージタイプリファレンス](/ja/agent-sdk/python#message-types)と [TypeScript メッセージタイプリファレンス](/ja/agent-sdk/typescript#message-types)を参照してください。

70 70

71<h3 id="handle-messages">71<h3 id="handle-messages">

72 メッセージを処理する72 メッセージを処理する

86<Accordion title="例：メッセージタイプをチェックして結果を処理する">86<Accordion title="例：メッセージタイプをチェックして結果を処理する">

87 <CodeGroup>87 <CodeGroup>

88 ```python Python theme={null}88 ```python Python theme={null}

89 import asyncio

89 from claude_agent_sdk import query, AssistantMessage, ResultMessage90 from claude_agent_sdk import query, AssistantMessage, ResultMessage

90 91

93 async def main():

94 try:

91 async for message in query(prompt="Summarize this project"):95 async for message in query(prompt="Summarize this project"):

92 if isinstance(message, AssistantMessage):96 if isinstance(message, AssistantMessage):

93 print(f"Turn completed: {len(message.content)} content blocks")97 print(f"Turn completed: {len(message.content)} content blocks")

96 print(message.result)100 print(message.result)

97 else:101 else:

98 print(f"Stopped: {message.subtype}")102 print(f"Stopped: {message.subtype}")

103 except Exception as error:

104 # A single-shot query() raises after yielding an error result. If the

105 # failure was an error result, the error subtype branches above have

106 # already run; connection or process failures yield no result message.

107 print(f"Session ended with an error: {error}")

108

109

110 asyncio.run(main())

99 ```111 ```

100 112

101 ```typescript TypeScript theme={null}113 ```typescript TypeScript theme={null}

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

103 115

116 try {

104 for await (const message of query({ prompt: "Summarize this project" })) {117 for await (const message of query({ prompt: "Summarize this project" })) {

105 if (message.type === "assistant") {118 if (message.type === "assistant") {

106 console.log(`Turn completed: ${message.message.content.length} content blocks`);119 console.log(`Turn completed: ${message.message.content.length} content blocks`);

113 }126 }

114 }127 }

115 }128 }

129 } catch (error) {

130 // A single-shot query() throws after yielding an error result. If the

131 // failure was an error result, the error subtype branches above have

132 // already run; connection or process failures yield no result message.

133 console.log(`Session ended with an error: ${error}`);

134 }

116 ```135 ```

117 </CodeGroup>136 </CodeGroup>

118</Accordion>137</Accordion>

321 340

322`result` フィールド（最終テキスト出力）は `success` バリアントにのみ存在するため、読み取る前に常にサブタイプをチェックしてください。すべての結果サブタイプは `total_cost_usd`、`usage`、`num_turns`、および `session_id` を持つため、コストを追跡し、エラー後でも再開できます。Python では、`total_cost_usd` と `usage` はオプションとして型付けされ、一部のエラーパスで `None` である可能性があるため、フォーマットする前にガードしてください。[コストと使用量の追跡](/ja/agent-sdk/cost-tracking)を参照して、`usage` フィールドの解釈の詳細を確認してください。341`result` フィールド（最終テキスト出力）は `success` バリアントにのみ存在するため、読み取る前に常にサブタイプをチェックしてください。すべての結果サブタイプは `total_cost_usd`、`usage`、`num_turns`、および `session_id` を持つため、コストを追跡し、エラー後でも再開できます。Python では、`total_cost_usd` と `usage` はオプションとして型付けされ、一部のエラーパスで `None` である可能性があるため、フォーマットする前にガードしてください。[コストと使用量の追跡](/ja/agent-sdk/cost-tracking)を参照して、`usage` フィールドの解釈の詳細を確認してください。

323 342

324結果には、モデルが最終ターンで生成を停止した理由を示す `stop_reason` フィールド（TypeScript では `string | null`、Python では `str | None`）も含まれます。一般的な値は `end_turn`（モデルが通常終了）、`max_tokens`（出力トークン制限に達した）、および `refusal`（モデルがリクエストを拒否）です。エラー結果サブタイプでは、`stop_reason` はループが終了する前の最後のアシスタント応答からの値を持ちます。拒否を検出するには、`stop_reason === "refusal"`（TypeScript）または `stop_reason == "refusal"`（Python）をチェックしてください。完全なタイプについては、[`SDKResultMessage`](/ja/agent-sdk/typescript#sdkresultmessage)（TypeScript）または[`ResultMessage`](/ja/agent-sdk/python#resultmessage)（Python）を参照してください。343<Note>

344 クエリがエラー結果で終了する場合：

345

346 * 単一ショットの `query()` 呼び出しは最終結果メッセージを生成し、その後 `Reached maximum number of turns` などの失敗テキストを含むエラーを発生させます。発生は意図的です。コードがそれを超えて続行する必要がある場合は、ループを try ブロックでラップしてください。基盤となる Claude Code プロセスも 0 以外のコードで終了します。

347 * ストリーミング入力セッションは生きたままで、メッセージを送信し続けることができます。

348</Note>

349

350結果には、モデルが最終ターンで生成を停止した理由を示す `stop_reason` フィールド（TypeScript では `string | null`、Python では `str | None`）も含まれます。一般的な値は `end_turn`（モデルが通常終了）、`max_tokens`（出力トークン制限に達した）、および `refusal`（モデルがリクエストを拒否）です。エラー結果サブタイプでは、`stop_reason` はループが終了する前の最後のアシスタント応答からの値を持ちます。拒否を検出するには、`stop_reason === "refusal"`（TypeScript）または `stop_reason == "refusal"`（Python）をチェックしてください。完全なタイプについては、[`SDKResultMessage`](/ja/agent-sdk/typescript#sdkresultmessage)（TypeScript）または [`ResultMessage`](/ja/agent-sdk/python#resultmessage)（Python）を参照してください。

325 351

326<h2 id="hooks">352<h2 id="hooks">

327 Hooks353 Hooks

348 374

349この例は、このページの主要な概念を、失敗するテストを修正する単一のエージェントに組み合わせています。許可されたツール（自動承認されるため、エージェントが自律的に実行される）、プロジェクト設定、およびターンと推論努力の安全制限でエージェントを構成します。ループが実行されると、潜在的な再開のためにセッション ID をキャプチャし、最終結果を処理し、総コストを出力します。375この例は、このページの主要な概念を、失敗するテストを修正する単一のエージェントに組み合わせています。許可されたツール（自動承認されるため、エージェントが自律的に実行される）、プロジェクト設定、およびターンと推論努力の安全制限でエージェントを構成します。ループが実行されると、潜在的な再開のためにセッション ID をキャプチャし、最終結果を処理し、総コストを出力します。

350 376

377単一の `query()` 呼び出しはエラー結果を生成した後に発生するため、ループは try ブロックでラップされており、制限に達したときにスクリプトがクリーンに終了します。

378

351<CodeGroup>379<CodeGroup>

352 ```python Python theme={null}380 ```python Python theme={null}

353 import asyncio381 import asyncio

357 async def run_agent():385 async def run_agent():

358 session_id = None386 session_id = None

359 387

388 try:

360 async for message in query(389 async for message in query(

361 prompt="Find and fix the bug causing test failures in the auth module",390 prompt="Find and fix the bug causing test failures in the auth module",

362 options=ClaudeAgentOptions(391 options=ClaudeAgentOptions(

389 print(f"Stopped: {message.subtype}")418 print(f"Stopped: {message.subtype}")

390 if message.total_cost_usd is not None:419 if message.total_cost_usd is not None:

391 print(f"Cost: ${message.total_cost_usd:.4f}")420 print(f"Cost: ${message.total_cost_usd:.4f}")

421 except Exception as error:

422 # A single-shot query() raises after yielding an error result. If the

423 # failure was an error result, the error subtype branches above have

424 # already run; connection or process failures yield no result message.

425 print(f"Session ended with an error: {error}")

392 426

393 427

394 asyncio.run(run_agent())428 asyncio.run(run_agent())

399 433

400 let sessionId: string | undefined;434 let sessionId: string | undefined;

401 435

436 try {

402 for await (const message of query({437 for await (const message of query({

403 prompt: "Find and fix the bug causing test failures in the auth module",438 prompt: "Find and fix the bug causing test failures in the auth module",

404 options: {439 options: {

428 console.log(`Cost: $${message.total_cost_usd.toFixed(4)}`);463 console.log(`Cost: $${message.total_cost_usd.toFixed(4)}`);

429 }464 }

430 }465 }

466 } catch (error) {

467 // A single-shot query() throws after yielding an error result. If the

468 // failure was an error result, the error subtype branches above have

469 // already run; connection or process failures yield no result message.

470 console.log(`Session ended with an error: ${error}`);

471 }

431 ```472 ```

432</CodeGroup>473</CodeGroup>

433 474

agent-sdk/cost-tracking.md +45 −2

Details

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

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

65 65

66 try {

66 for await (const message of query({ prompt: "Summarize this project" })) {67 for await (const message of query({ prompt: "Summarize this project" })) {

67 if (message.type === "result") {68 if (message.type === "result") {

68 console.log(`Total cost: $${message.total_cost_usd}`);69 console.log(`Total cost: $${message.total_cost_usd}`);

69 }70 }

70 }71 }

72 } catch (error) {

73 // A single-shot query() throws after yielding an error result. If the

74 // failure was an error result, it still carried total_cost_usd and the

75 // branch above has already run; connection or process failures yield

76 // no result message.

77 console.error(`Session ended with an error: ${error}`);

78 }

71 ```79 ```

72 80

73 ```python Python theme={null}81 ```python Python theme={null}

76 84

77 85

78 async def main():86 async def main():

87 try:

79 async for message in query(prompt="Summarize this project"):88 async for message in query(prompt="Summarize this project"):

80 if isinstance(message, ResultMessage):89 if isinstance(message, ResultMessage):

81 print(f"Total cost: ${message.total_cost_usd or 0}")90 print(f"Total cost: ${message.total_cost_usd or 0}")

91 except Exception as error:

92 # A single-shot query() raises after yielding an error result. If the

93 # failure was an error result, it still carried total_cost_usd and the

94 # branch above has already run; connection or process failures yield

95 # no result message.

96 print(f"Session ended with an error: {error}")

82 97

83 98

84 asyncio.run(main())99 asyncio.run(main())

110let totalInputTokens = 0;125let totalInputTokens = 0;

111let totalOutputTokens = 0;126let totalOutputTokens = 0;

112 127

113for await (const message of query({ prompt: "Summarize this project" })) {128try {

129 for await (const message of query({ prompt: "Summarize this project" })) {

114 if (message.type === "assistant") {130 if (message.type === "assistant") {

115 const msgId = message.message.id;131 const msgId = message.message.id;

116 132

121 totalOutputTokens += message.message.usage.output_tokens;137 totalOutputTokens += message.message.usage.output_tokens;

122 }138 }

123 }139 }

140 }

141} catch (error) {

142 // A single-shot query() throws after yielding an error result, so the

143 // totals below still reflect the steps that ran before the failure.

144 console.error(`Session ended with an error: ${error}`);

124}145}

125 146

126console.log(`Steps: ${seenIds.size}`);147console.log(`Steps: ${seenIds.size}`);

139```typescript theme={null}160```typescript theme={null}

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

141 162

142for await (const message of query({ prompt: "Summarize this project" })) {163try {

164 for await (const message of query({ prompt: "Summarize this project" })) {

143 if (message.type !== "result") continue;165 if (message.type !== "result") continue;

144 166

145 for (const [modelName, usage] of Object.entries(message.modelUsage)) {167 for (const [modelName, usage] of Object.entries(message.modelUsage)) {

149 console.log(` Cache read: ${usage.cacheReadInputTokens}`);171 console.log(` Cache read: ${usage.cacheReadInputTokens}`);

150 console.log(` Cache creation: ${usage.cacheCreationInputTokens}`);172 console.log(` Cache creation: ${usage.cacheCreationInputTokens}`);

151 }173 }

174 }

175} catch (error) {

176 // A single-shot query() throws after yielding an error result. If the

177 // failure was an error result, the per-model breakdown above has already

178 // printed; connection or process failures yield no result message.

179 console.error(`Session ended with an error: ${error}`);

152}180}

153```181```

154 182

173 ];201 ];

174 202

175 for (const prompt of prompts) {203 for (const prompt of prompts) {

204 try {

176 for await (const message of query({ prompt })) {205 for await (const message of query({ prompt })) {

177 if (message.type === "result") {206 if (message.type === "result") {

178 totalSpend += message.total_cost_usd;207 totalSpend += message.total_cost_usd;

179 console.log(`This call: $${message.total_cost_usd}`);208 console.log(`This call: $${message.total_cost_usd}`);

180 }209 }

181 }210 }

211 } catch (error) {

212 // A single-shot query() throws after yielding an error result. If the

213 // failure was an error result, this call's cost was already counted;

214 // connection or process failures yield no result message. Continue

215 // with the next prompt.

216 console.error(`Call failed: ${error}`);

217 }

182 }218 }

183 219

184 console.log(`Total spend: $${totalSpend.toFixed(4)}`);220 console.log(`Total spend: $${totalSpend.toFixed(4)}`);

199 ]235 ]

200 236

201 for prompt in prompts:237 for prompt in prompts:

238 try:

202 async for message in query(prompt=prompt):239 async for message in query(prompt=prompt):

203 if isinstance(message, ResultMessage):240 if isinstance(message, ResultMessage):

204 cost = message.total_cost_usd or 0241 cost = message.total_cost_usd or 0

205 total_spend += cost242 total_spend += cost

206 print(f"This call: ${cost}")243 print(f"This call: ${cost}")

244 except Exception as error:

245 # A single-shot query() raises after yielding an error result. If

246 # the failure was an error result, this call's cost was already

247 # counted; connection or process failures yield no result message.

248 # Continue with the next prompt.

249 print(f"Call failed: {error}")

207 250

208 print(f"Total spend: ${total_spend:.4f}")251 print(f"Total spend: ${total_spend:.4f}")

209 252

agent-sdk/file-checkpointing.md +25 −7

Details

50 50

51ファイル checkpointing を使用するには、オプションで有効にし、レスポンスストリームから checkpoint UUID をキャプチャしてから、復元が必要な場合に `rewindFiles()`（TypeScript）または `rewind_files()`（Python）を呼び出します。51ファイル checkpointing を使用するには、オプションで有効にし、レスポンスストリームから checkpoint UUID をキャプチャしてから、復元が必要な場合に `rewindFiles()`（TypeScript）または `rewind_files()`（Python）を呼び出します。

52 52

53次の例は、完全なフロー（checkpointing を有効にし、レスポンスストリームから checkpoint UUID とセッション ID をキャプチャしてから、後でセッションを再開してファイルを巻き戻す）を示しています。各ステップについては、以下で詳しく説明します。53次の例は、完全なフロー（checkpointing を有効にし、レスポンスストリームから checkpoint UUID とセッション ID をキャプチャしてから、後でセッションを再開してファイルを巻き戻す）を示しています。各ステップについては、以下で詳しく説明します。このセクションの例では、プロンプト「Refactor the authentication module」を使用しています。認証モジュールを含むプロジェクトで実行するか、プロンプトを変更してプロジェクトに存在するファイルを指定してください。ファイルの変更を確認し、巻き戻しがそれらを復元するのを見ることができます。

54 54

55<CodeGroup>55<CodeGroup>

56 ```python Python theme={null}56 ```python Python theme={null}

197 session_id = None197 session_id = None

198 198

199 async for message in client.receive_response():199 async for message in client.receive_response():

200 # 各ユーザーメッセージで checkpoint を更新（最新を保持）200 # 最初のユーザーメッセージ UUID を checkpoint としてキャプチャ

201 if isinstance(message, UserMessage) and message.uuid:201 if isinstance(message, UserMessage) and message.uuid and checkpoint_id is None:

202 checkpoint_id = message.uuid202 checkpoint_id = message.uuid

203 # 結果メッセージからセッション ID をキャプチャ203 # 結果メッセージからセッション ID をキャプチャ

204 if isinstance(message, ResultMessage):204 if isinstance(message, ResultMessage):

210 let sessionId: string | undefined;210 let sessionId: string | undefined;

211 211

212 for await (const message of response) {212 for await (const message of response) {

213 // 各ユーザーメッセージで checkpoint を更新（最新を保持）213 // 最初のユーザーメッセージ UUID を checkpoint としてキャプチャ

214 if (message.type === "user" && message.uuid) {214 if (message.type === "user" && message.uuid && !checkpointId) {

215 checkpointId = message.uuid;215 checkpointId = message.uuid;

216 }216 }

217 // セッション ID を持つメッセージからキャプチャ217 // セッション ID を持つメッセージからキャプチャ

250 ```250 ```

251 </CodeGroup>251 </CodeGroup>

252 252

253 セッション ID と checkpoint ID をキャプチャした場合、CLI からも巻き戻すことができます：253 セッション ID と checkpoint ID をキャプチャした場合、CLI からも巻き戻すことができます。このコマンドには、[Claude Code をインストール](/ja/setup)することで取得できる `claude` 実行ファイルが必要です。これは SDK パッケージではインストールされません。SDK は checkpointing を有効にしますが、`claude -p` を直接実行する場合は、`CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING` 環境変数を設定する必要があります：

254 254

255 ```bash theme={null}255 ```bash theme={null}

256 claude -p --resume <session-id> --rewind-files <checkpoint-uuid>256 CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true claude -p --resume <session-id> --rewind-files <checkpoint-uuid>

257 ```257 ```

258

259 `--rewind-files` フラグは `claude --help` 出力には表示されませんが、CLI は上記のように受け入れます。

258 </Step>260 </Step>

259</Steps>261</Steps>

260 262

270 272

271このパターンは、最新の checkpoint UUID のみを保持し、各エージェントターンの前に更新します。処理中に問題が発生した場合、最後の安全な状態にすぐに巻き戻して、ループから抜け出すことができます。273このパターンは、最新の checkpoint UUID のみを保持し、各エージェントターンの前に更新します。処理中に問題が発生した場合、最後の安全な状態にすぐに巻き戻して、ループから抜け出すことができます。

272 274

275このサンプルを実行する前に、`your_revert_condition`（Python）または `yourRevertCondition`（TypeScript）を独自のチェック（エラー検出や検証失敗など）に置き換えてください。プレースホルダーはサンプルでは定義されていません。

276

273<CodeGroup>277<CodeGroup>

274 ```python Python theme={null}278 ```python Python theme={null}

275 import asyncio279 import asyncio

752 756

753**解決策**：元のセッションで `enable_file_checkpointing=True`（Python）または `enableFileCheckpointing: true`（TypeScript）が設定されていることを確認してから、例に示されているパターンを使用します：最初のユーザーメッセージ UUID をキャプチャし、セッションを完全に完了してから、空のプロンプトで再開し、`rewindFiles()` を 1 回呼び出します。757**解決策**：元のセッションで `enable_file_checkpointing=True`（Python）または `enableFileCheckpointing: true`（TypeScript）が設定されていることを確認してから、例に示されているパターンを使用します：最初のユーザーメッセージ UUID をキャプチャし、セッションを完全に完了してから、空のプロンプトで再開し、`rewindFiles()` を 1 回呼び出します。

754 758

759<h3 id="file-rewinding-is-not-enabled-error">

760 「File rewinding is not enabled」エラー

761</h3>

762

763このエラーは、checkpointing が有効になっていない非対話的な巻き戻しを試みた場合に発生します：`--rewind-files` を使用して bare `claude -p` を実行するか、checkpointing を有効にしないオプションを持つ SDK セッション（再開されたセッションを含む）を実行します。SDK は、`enable_file_checkpointing`（Python）または `enableFileCheckpointing`（TypeScript）が巻き戻しを実行するセッションで有効になっている場合にのみ、`CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING` 環境変数を内部的に設定します。bare CLI はこれを設定しません。

764

765**解決策**：bare CLI の場合、コマンドを実行するときに環境変数を設定します：

766

767```bash theme={null}

768CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true claude -p --resume <session-id> --rewind-files <checkpoint-uuid>

769```

770

771SDK の場合、このページの例で行うように、再開されたセッションで `enable_file_checkpointing=True`（Python）または `enableFileCheckpointing: true`（TypeScript）を設定します。

772

755<h3 id="processtransport-is-not-ready-for-writing-error">773<h3 id="processtransport-is-not-ready-for-writing-error">

756 「ProcessTransport is not ready for writing」エラー774 「ProcessTransport is not ready for writing」エラー

757</h3>775</h3>

agent-sdk/permissions.md +15 −4

Details

28 </Step>28 </Step>

29 29

30 <Step title="質問ルール">30 <Step title="質問ルール">

31 [settings.json](/ja/settings#permission-settings)から `ask` ルールをチェックします。質問ルールが一致する場合、`bypassPermissions` モードでも、コールは確認のために[`canUseTool` コールバック](/ja/agent-sdk/user-input)にフォールスルーします。`dontAsk` モードでは、一致する質問ルールは代わりに拒否されます。このモードはプロンプトを表示しないためです。31 [settings.json](/ja/settings#permission-settings)から `ask` ルールをチェックします。質問ルールが一致する場合、`bypassPermissions` モードでも、コールは確認のために[`canUseTool` コールバック](/ja/agent-sdk/user-input)にフォールスルーします。

33 ユーザーインタラクションが必要なツールは同じように動作します。`AskUserQuestion` および MCP ツール（サーバーが[`_meta["anthropic/requiresUserInteraction"]`](/ja/mcp#require-approval-for-a-specific-tool)を設定）は、許可ルールが一致する場合でも常にコールバックにフォールスルーします。`dontAsk` モードでは、このモードはプロンプトを表示しないため、両方のケースが代わりに拒否されます。{/* min-version: 2.1.199 */}MCP アノテーションには Claude Code v2.1.199 以降が必要です。

32 </Step>34 </Step>

33 35

~~34 <Step title="パーミッションモード">~~36 <Step title="権限モード">

35 アクティブな[パーミッションモード](#permission-modes)を適用します。`bypassPermissions` はこのステップに到達したすべてを承認します。`acceptEdits` はファイル操作を承認します。`plan` はファイル編集およびシェル書き込みツールを許可ルールに関係なく [`canUseTool` コールバック](/ja/agent-sdk/user-input)にルーティングするため、計画中は書き込み操作を自動承認することはできません。その他のモードはフォールスルーします。37 アクティブな[権限モード](#permission-modes)を適用します。`bypassPermissions` はこのステップに到達したすべてを承認します。`acceptEdits` はファイル操作を承認します。`plan` はファイル編集およびシェル書き込みツールを許可ルールに関係なく [`canUseTool` コールバック](/ja/agent-sdk/user-input)にルーティングするため、計画中は書き込み操作を自動承認することはできません。その他のモードはフォールスルーします。

36 </Step>38 </Step>

37 39

38 <Step title="許可ルール">40 <Step title="許可ルール">

46 48

47<img src="https://mintcdn.com/claude-code/jYgs7qigNjO1Badj/images/agent-sdk/permissions-flow.svg?fit=max&auto=format&n=jYgs7qigNjO1Badj&q=85&s=c771ad9085b1277d3708027a49c744bc" alt="6 ステップのパーミッション評価フロー図。ツールリクエストはフック、拒否ルール、質問ルール、パーミッションモード、許可ルール、canUseTool を通過します。フック、拒否ルール、canUseTool はブロックにルーティングでき、パーミッションモードバイパス、許可ルール、canUseTool は実行にルーティングできます。質問ルールは canUseTool にルーティングします。" width="1180" height="260" data-path="images/agent-sdk/permissions-flow.svg" />49<img src="https://mintcdn.com/claude-code/jYgs7qigNjO1Badj/images/agent-sdk/permissions-flow.svg?fit=max&auto=format&n=jYgs7qigNjO1Badj&q=85&s=c771ad9085b1277d3708027a49c744bc" alt="6 ステップのパーミッション評価フロー図。ツールリクエストはフック、拒否ルール、質問ルール、パーミッションモード、許可ルール、canUseTool を通過します。フック、拒否ルール、canUseTool はブロックにルーティングでき、パーミッションモードバイパス、許可ルール、canUseTool は実行にルーティングできます。質問ルールは canUseTool にルーティングします。" width="1180" height="260" data-path="images/agent-sdk/permissions-flow.svg" />

48 50

51v2.1.198 以降、このパーミッション評価順序が到達できない `canUseTool` コールバックを渡す場合、TypeScript SDK はクエリが構築されるときに Node.js プロセス警告を 1 回発行します。警告のコードは `CLAUDE_SDK_CAN_USE_TOOL_SHADOWED` です。2 つの設定がこれをトリガーします。

53* `permissionMode: 'bypassPermissions'`。これはパーミッションモードステップに到達するすべてのコールを自動承認します。

54* `"Read"` などの各裸の `allowedTools` エントリ。これはコールバックが相談される前にそのツール全体を自動承認します。

56`Bash(ls *)` などの指定子を持つエントリと `acceptEdits` モードはこれをトリガーしません。また、設定ファイルから来る許可ルールはチェックに表示されません。

58`process.on('warning', ...)` でリッスンしてコードをマッチングしてログに記録するか、それを抑制します。モードとルールに関係なくすべてのツールコールをゲートするには、代わりに[`PreToolUse` フック](/ja/agent-sdk/hooks)を使用します。

49このページは**許可および拒否ルール**と**パーミッションモード**に焦点を当てています。その他のステップについては、以下を参照してください。60このページは**許可および拒否ルール**と**パーミッションモード**に焦点を当てています。その他のステップについては、以下を参照してください。

50 61

51* **フック：** カスタムコードを実行して、ツールリクエストを許可、拒否、または変更します。[フックで実行を制御](/ja/agent-sdk/hooks)を参照してください。62* **フック：** カスタムコードを実行して、ツールリクエストを許可、拒否、または変更します。[フックで実行を制御](/ja/agent-sdk/hooks)を参照してください。

67許可ルールは、リテラル `mcp__<server>__` プレフィックスの後にのみツール名グロブを受け入れます。サーバーセグメントはグロブフリーである必要があり、設定したサーバーに名前を付けます。`mcp__puppeteer__*` は `puppeteer` サーバーからのすべてのツールに一致し、`mcp__github__get_*` はその `get_` ツールに一致します。`allowed_tools=["*"]` または `allowed_tools=["mcp__*"]` のようなアンカーされていないエントリは、スタートアップ警告で無視され、何も自動承認しません。78許可ルールは、リテラル `mcp__<server>__` プレフィックスの後にのみツール名グロブを受け入れます。サーバーセグメントはグロブフリーである必要があり、設定したサーバーに名前を付けます。`mcp__puppeteer__*` は `puppeteer` サーバーからのすべてのツールに一致し、`mcp__github__get_*` はその `get_` ツールに一致します。`allowed_tools=["*"]` または `allowed_tools=["mcp__*"]` のようなアンカーされていないエントリは、スタートアップ警告で無視され、何も自動承認しません。

68 79

69<Warning>80<Warning>

70 **自動承認されたツールは `canUseTool` に到達しません。** 任意の前のステップで承認されたツール呼び出し（`acceptEdits` または `bypassPermissions` による、または許可ルールによる）は、`canUseTool` コールバックをスキップするため、そこに配置した権限チェックはそのツールに対して静かにバイパスされます。カバレッジはエントリの形式に依存します。`Read` または `mcp__github__get_issue` のような単純な名前は、そのツールへのすべての呼び出しを自動承認しますが、`Bash(ls *)` のようなスコープ付きルールは一致する呼び出しのみを自動承認し、その他の `Bash` 呼び出しはコールバックにフォールスルーします。すべてのツール呼び出しで実行する必要があるチェックについては、[`PreToolUse` フック](/ja/agent-sdk/hooks)を使用してください。フックはすべての他のステップの前に実行され、フック拒否は `bypassPermissions` モードでも適用されます。81 **自動承認されたツールは `canUseTool` に到達しません。** 任意の前のステップで承認されたツール呼び出し（`acceptEdits` または `bypassPermissions` による、または許可ルールによる）は、`canUseTool` コールバックをスキップするため、そこに配置した権限チェックはそのツールに対して静かにバイパスされます。例外は、ユーザーインタラクションが必要なツール、`AskUserQuestion` および [`_meta["anthropic/requiresUserInteraction"]`](/ja/mcp#require-approval-for-a-specific-tool) でマークされた MCP ツールです。これらは許可ルールが一致する場合でもコールバックに到達します。カバレッジはエントリの形式に依存します。`Read` または `mcp__github__get_issue` のような単純な名前は、そのツールへのすべての呼び出しを自動承認しますが、`Bash(ls *)` のようなスコープ付きルールは一致する呼び出しのみを自動承認し、その他の `Bash` 呼び出しはコールバックにフォールスルーします。すべてのツール呼び出しで実行する必要があるチェックについては、[`PreToolUse` フック](/ja/agent-sdk/hooks)を使用してください。フックはすべての他のステップの前に実行され、フック拒否は `bypassPermissions` モードでも適用されます。

71</Warning>82</Warning>

72 83

73ロックダウンされたエージェントの場合、`allowedTools` を `permissionMode: "dontAsk"` と組み合わせます。リストされたツールは承認されます。その他のものはプロンプトの代わりに直接拒否されます。84ロックダウンされたエージェントの場合、`allowedTools` を `permissionMode: "dontAsk"` と組み合わせます。リストされたツールは承認されます。その他のものはプロンプトの代わりに直接拒否されます。

agent-sdk/python.md +1 −1

Details

958```958```

959 959

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

961* `CLAUDE_CODE_MAX_RETRIES`：最大 API リトライ数。デフォルト `10`、上限 `15`。各リトライは独自の `API_TIMEOUT_MS` ウィンドウを取得するため、最悪の場合の実時間はおおよそ `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` にバックオフを加えたものです。無人実行で長時間の停止を待つ必要がある場合は、`CLAUDE_CODE_RETRY_WATCHDOG=1` を設定して容量エラーを無限に再試行します。961* `CLAUDE_CODE_MAX_RETRIES`：最大 API リトライ数。デフォルト `10`、上限 `15`。各リトライは独自の `API_TIMEOUT_MS` ウィンドウを取得するため、最悪の場合の実時間はおおよそ `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` にバックオフを加えたものです。無人実行で長時間の停止を待つ必要がある場合は、`CLAUDE_CODE_RETRY_WATCHDOG=1` を設定します：容量エラーを無限に再試行し、{/* min-version: 2.1.199 */}Claude Code v2.1.199 以降は他の一時的なエラーのデフォルトを `300` に引き上げ、この変数の上限を削除します。

962* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`：`run_in_background` で起動されたサブエージェント用の停止ウォッチドッグ。デフォルト `600000`。各ストリームイベントでリセットされます。停止時にサブエージェントを中止し、タスクを失敗とマークし、部分的な結果を含むエラーを親に表示します。同期サブエージェントには適用されません。962* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`：`run_in_background` で起動されたサブエージェント用の停止ウォッチドッグ。デフォルト `600000`。各ストリームイベントでリセットされます。停止時にサブエージェントを中止し、タスクを失敗とマークし、部分的な結果を含むエラーを親に表示します。同期サブエージェントには適用されません。

963* `CLAUDE_ENABLE_STREAM_WATCHDOG` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`：ヘッダーが到着したがレスポンスボディがストリーミングを停止したときにリクエストを中止します。ウォッチドッグはすべてのプロバイダーでデフォルトで有効です。`CLAUDE_ENABLE_STREAM_WATCHDOG=0` を設定して無効にします。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` はデフォルト `300000` で、その最小値にクランプされます。中止されたリクエストは通常のリトライパスを通ります。963* `CLAUDE_ENABLE_STREAM_WATCHDOG` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`：ヘッダーが到着したがレスポンスボディがストリーミングを停止したときにリクエストを中止します。ウォッチドッグはすべてのプロバイダーでデフォルトで有効です。`CLAUDE_ENABLE_STREAM_WATCHDOG=0` を設定して無効にします。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` はデフォルト `300000` で、その最小値にクランプされます。中止されたリクエストは通常のリトライパスを通ります。

964 964

agent-sdk/subagents.md +36 −20

Details

7> サブエージェントを定義して呼び出し、コンテキストを分離し、タスクを並列実行し、Claude Agent SDK アプリケーションで特殊な指示を適用します。7> サブエージェントを定義して呼び出し、コンテキストを分離し、タスクを並列実行し、Claude Agent SDK アプリケーションで特殊な指示を適用します。

8 8

9サブエージェントは、メインエージェントが生成できる個別のエージェントインスタンスで、焦点を絞ったサブタスクを処理します。9サブエージェントは、メインエージェントが生成できる個別のエージェントインスタンスで、焦点を絞ったサブタスクを処理します。

10サブエージェントを使用して、焦点を絞ったサブタスクのコンテキストを分離し、複数の分析を並列実行し、メインエージェントのプロンプトを肥大化させずに特殊な指示を適用します。10サブエージェントを使用して、コンテキストを分離し、複数の分析を並列実行し、メインエージェントのプロンプトを肥大化させずに特殊な指示を適用します。

11 11

12このガイドでは、`agents` パラメータを使用して SDK でサブエージェントを定義および使用する方法について説明します。12このガイドでは、`agents` パラメータを使用して SDK でサブエージェントを定義および使用する方法について説明します。

13 13

17 17

18サブエージェントは 3 つの方法で作成できます。18サブエージェントは 3 つの方法で作成できます。

19 19

20* **プログラム的に**: `query()` オプションの `agents` パラメータを使用します（[TypeScript](/ja/agent-sdk/typescript#agentdefinition)、[Python](/ja/agent-sdk/python#agentdefinition)）20* **プログラム的に**: `query()` オプションの `agents` パラメータを使用します。[TypeScript](/ja/agent-sdk/typescript#agentdefinition) および [Python](/ja/agent-sdk/python#agentdefinition) リファレンスを参照してください

21* **ファイルシステムベース**: `.claude/agents/` ディレクトリ内のマークダウンファイルとしてエージェントを定義します（[ファイルとしてサブエージェントを定義する](/ja/sub-agents)を参照）21* **ファイルシステムベース**: `.claude/agents/` ディレクトリ内のマークダウンファイルとしてエージェントを定義します。[ファイルとしてサブエージェントを定義する](/ja/sub-agents)を参照してください

22* **組み込みの汎用**: Claude は、何も定義することなく、Agent ツールを介して組み込みの `general-purpose` サブエージェントをいつでも呼び出すことができます22* **組み込みの汎用**: Claude は、何も定義することなく、Agent ツールを介して組み込みの `general-purpose` サブエージェントをいつでも呼び出すことができます

23 23

24このガイドでは、SDK アプリケーションに推奨されるプログラム的なアプローチに焦点を当てています。24このガイドでは、SDK アプリケーションに推奨されるプログラム的なアプローチに焦点を当てています。

25 25

26サブエージェントを定義する場合、Claude は各サブエージェントの `description` フィールドに基づいて、それらを呼び出すかどうかを判断します。サブエージェントをいつ使用すべきかを説明する明確な説明を書いてください。Claude は自動的に適切なタスクを委譲します。プロンプトでサブエージェントを名前で明示的にリクエストすることもできます（例えば、「code-reviewer エージェントを使用して...」）。26サブエージェントを定義する場合、Claude は各サブエージェントの `description` フィールドに基づいて、それらを呼び出すかどうかを判断します。サブエージェントをいつ使用すべきかを説明する明確な説明を書いてください。Claude は自動的に適切なタスクを委譲します。プロンプトでサブエージェントを名前で明示的にリクエストすることもできます。例えば「code-reviewer エージェントを使用して...」のようにです。

27 27

28<h2 id="benefits-of-using-subagents">28<h2 id="benefits-of-using-subagents">

29 サブエージェントを使用する利点29 サブエージェントを使用する利点

61 61

62**例:** `doc-reviewer` サブエージェントは Read と Grep ツールのみにアクセスでき、ドキュメントファイルを分析できますが、誤って変更することはありません。62**例:** `doc-reviewer` サブエージェントは Read と Grep ツールのみにアクセスでき、ドキュメントファイルを分析できますが、誤って変更することはありません。

63 63

~~64<h2 id="creating-subagents">~~64<h2 id="create-subagents">

65 サブエージェントの作成65 サブエージェントの作成

66</h2>66</h2>

67 67

69 プログラム的な定義（推奨）69 プログラム的な定義（推奨）

70</h3>70</h3>

71 71

72`agents` パラメータを使用してコード内でサブエージェントを直接定義します。この例では、読み取り専用アクセスを持つコードレビュアーとコマンドを実行できるテストランナーの 2 つのサブエージェントを作成します。Claude はサブエージェントを Agent ツール経由で呼び出すため、`allowedTools` に `Agent` を含めて、パーミッションプロンプトなしでサブエージェント呼び出しを自動承認する必要があります。72`agents` パラメータを使用してコード内でサブエージェントを直接定義します。Claude はサブエージェントを Agent ツール経由で呼び出すため、`allowedTools` に `Agent` を含めて、パーミッションプロンプトなしでサブエージェント呼び出しを自動承認する必要があります。

73 73

74このページのほとんどの例は最終結果のみを出力します。Claude がサブエージェントに委譲したことを確認するには、[サブエージェント呼び出しの検出](#detecting-subagent-invocation)を参照してください。74このページのほとんどの例は最終結果のみを出力します。Claude がサブエージェントに委譲したことを確認するには、[サブエージェント呼び出しの検出](#detect-subagent-invocation)を参照してください。

76この例では、読み取り専用アクセスを持つコードレビュアーとコマンドを実行できるテストランナーの 2 つのサブエージェントを作成します。

75 77

76<CodeGroup>78<CodeGroup>

77 ```python Python theme={null}79 ```python Python theme={null}

197 199

198Python SDK では、`disallowedTools` や `mcpServers` などの複数単語のフィールド名は、Python の snake\_case 規約に従うのではなく、wire フォーマットに一致するように camelCase を保持します。詳細については、[`AgentDefinition` リファレンス](/ja/agent-sdk/python#agentdefinition)を参照してください。200Python SDK では、`disallowedTools` や `mcpServers` などの複数単語のフィールド名は、Python の snake\_case 規約に従うのではなく、wire フォーマットに一致するように camelCase を保持します。詳細については、[`AgentDefinition` リファレンス](/ja/agent-sdk/python#agentdefinition)を参照してください。

199 201

202Claude Code v2.1.198 でサブエージェントの動作が 2 つ変更されました。

203

204* サブエージェントはデフォルトでバックグラウンドで実行されます。[`run_in_background`](/ja/agent-sdk/typescript) 入力を省略する Agent ツール呼び出しはバックグラウンドサブエージェントを起動し、Claude が続行する前に結果が必要な場合は `run_in_background: false` を設定します。v2.1.198 より前は、`run_in_background` を省略するとサブエージェントが同期的に実行されていました。特定のエージェントに対してバックグラウンド実行を強制するには、`background` フィールドを `true` に設定してください。これは Claude が要求する内容に関わらず適用されます。

205* サブエージェントはメインセッションの拡張思考設定を継承します。以前のバージョンでは、メインセッションの設定に関わらず、サブエージェント内で拡張思考が無効になっていました。

206

200<Note>207<Note>

201 {/* min-version: 2.1.172 */}Claude Code v2.1.172 以降、サブエージェントは独自のサブエージェントを生成できます。メインエージェントの 5 レベル下のサブエージェントは、フォアグラウンドまたはバックグラウンドで実行されるかどうかに関わらず、それ以上のサブエージェントを生成できません。サブエージェントが他のサブエージェントを生成するのを防ぐには、その `tools` 配列から `Agent` を省略するか、`disallowedTools` に追加してください。完全な深さルールについては、[ネストされたサブエージェント](/ja/sub-agents#spawn-nested-subagents)を参照してください。208 {/* min-version: 2.1.172 */}Claude Code v2.1.172 以降、サブエージェントは独自のサブエージェントを生成できます。メインエージェントの 5 レベル下のサブエージェントは、フォアグラウンドまたはバックグラウンドで実行されるかどうかに関わらず、それ以上のサブエージェントを生成できません。サブエージェントが他のサブエージェントを生成するのを防ぐには、その `tools` 配列から `Agent` を省略するか、`disallowedTools` に追加してください。完全な深さルールについては、[ネストされたサブエージェント](/ja/sub-agents#spawn-nested-subagents)を参照してください。

202</Note>209</Note>

225 232

226<Note>233<Note>

227 親はサブエージェントの最終メッセージを Agent ツール結果として逐語的に受け取りますが、独自の応答で要約する場合があります。サブエージェント出力を逐語的にユーザー向けの応答で保持するには、**メイン** `query()` 呼び出しに渡すプロンプトまたは `systemPrompt` オプションに指示を含めてください。234 親はサブエージェントの最終メッセージを Agent ツール結果として逐語的に受け取りますが、独自の応答で要約する場合があります。サブエージェント出力を逐語的にユーザー向けの応答で保持するには、メイン `query()` 呼び出しに渡すプロンプトまたは `systemPrompt` オプションに指示を含めてください。

228</Note>235</Note>

229 236

230<h2 id="invoking-subagents">237Claude Code v2.1.199 以降、レート制限などでサブエージェントを早期に終了させる API エラーは、その結果として配信されることはありません。サブエージェントが既に出力を生成している場合、Agent ツールはサブエージェントが完了しなかったというメモ付きでその部分的な出力を返します。それ以外の場合、ツール結果はエラーメッセージ「Agent terminated early due to an API error」の後にエラーの詳細が続きます。バックグラウンドおよびフォアグラウンドの動作については、[サブエージェントの API エラー](/ja/sub-agents#api-errors-in-subagents)を参照してください。

238

239<h2 id="invoke-subagents">

231 サブエージェントの呼び出し240 サブエージェントの呼び出し

232</h2>241</h2>

233 242

329 ```338 ```

330</CodeGroup>339</CodeGroup>

331 340

332<h2 id="detecting-subagent-invocation">341<h2 id="detect-subagent-invocation">

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

334</h2>343</h2>

335 344

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

337 346

338<Note>347<Note>

339 ツール名は Claude Code v2.1.63 で `"Task"` から `"Agent"` に変更されました。現在の SDK リリースは `tool_use` ブロックで `"Agent"` を出力しますが、`system:init` ツールリストと `result.permission_denials[].tool_name` では引き続き `"Task"` を使用します。SDK バージョン全体での互換性を確保するために、`block.name` で両方の値をチェックしてください。348 ツール名は Claude Code v2.1.63 で `"Task"` から `"Agent"` に変更されました。現在の SDK リリースは `tool_use` ブロックで `"Agent"` を出力しますが、`system:init` ツールリストと `result.permission_denials[].tool_name` では引き続き `"Task"` を使用します。SDK バージョン全体での互換性を確保するために、`block.name` で両方の値をチェックしてください。

422 ```431 ```

423</CodeGroup>432</CodeGroup>

424 433

425<h2 id="resuming-subagents">434<h2 id="resume-subagents">

426 サブエージェントの再開435 サブエージェントの再開

427</h2>436</h2>

428 437

429サブエージェントを再開して、中断したところから続行できます。再開されたサブエージェントは、以前のすべてのツール呼び出し、結果、推論を含む完全な会話履歴を保持します。サブエージェントは新しく開始するのではなく、停止したところから正確に再開します。438サブエージェントを再開して、中断したところから続行できます。再開されたサブエージェントは、以前のすべてのツール呼び出し、結果、推論を含む完全な会話履歴を保持します。

430 439

431サブエージェントが完了すると、Agent ツール結果には `agentId: <id>` を含むテキストブロックが含まれます。組み込みの [`Explore` および `Plan` エージェント](/ja/sub-agents#built-in-subagents) はワンショットであり、`agentId` を返さないため、再開が必要な場合はカスタムエージェントまたは `general-purpose` を使用してください。サブエージェントをプログラム的に再開するには：440サブエージェントが完了すると、Agent ツール結果には `agentId: <id>` を含むテキストブロックが含まれます。組み込みの [`Explore` および `Plan` エージェント](/ja/sub-agents#built-in-subagents) はワンショットであり、`agentId` を返さないため、再開が必要な場合はカスタムエージェントまたは `general-purpose` を使用してください。サブエージェントをプログラム的に再開するには：

432 441

662 671

663Claude がサブエージェントに委譲する代わりにタスクを直接完了する場合：672Claude がサブエージェントに委譲する代わりにタスクを直接完了する場合：

664 673

6651. **Agent ツールの呼び出しが承認されていることを確認する**: `allowedTools` に `Agent` を含めて、サブエージェント呼び出しを自動承認します。これがない場合、Agent 呼び出しは `canUseTool` コールバックにフォールスルーするか、`dontAsk` モードでは拒否されます674* **Agent ツールの呼び出しが承認されていることを確認する**: `allowedTools` に `Agent` を含めて、サブエージェント呼び出しを自動承認します。これがない場合、Agent 呼び出しは `canUseTool` コールバックにフォールスルーするか、`dontAsk` モードでは拒否されます

6662. **明示的なプロンプトを使用する**: プロンプトでサブエージェントを名前で言及します（例えば、「code-reviewer エージェントを使用して...」）675* **明示的なプロンプトを使用する**: プロンプトでサブエージェントを名前で言及します。例えば「code-reviewer エージェントを使用して...」のように

6673. **明確な説明を書く**: サブエージェントをいつ使用すべきかを正確に説明し、Claude がタスクを適切にマッチングできるようにします676* **明確な説明を書く**: サブエージェントをいつ使用すべきかを正確に説明し、Claude がタスクを適切にマッチングできるようにします

668 677

669<h3 id="filesystem-based-agents-not-loading">678<h3 id="filesystem-based-agents-not-loading">

670 ファイルシステムベースのエージェントが読み込まれていない679 ファイルシステムベースのエージェントが読み込まれていない

671</h3>680</h3>

672 681

673`.claude/agents/` で定義されたエージェントはスタートアップ時にのみ読み込まれます。Claude Code の実行中に新しいエージェントファイルを作成した場合、セッションを再起動して読み込んでください。682Claude Code は `~/.claude/agents/` と `.claude/agents/` を監視し、数秒以内に新しいまたは編集されたエージェントファイルを検出します。再起動は不要です。定義が表示されない場合は、以下の原因を確認してください：

683

684* **新しい `agents` ディレクトリ**: ウォッチャーはセッション開始時に存在していたディレクトリのみをカバーするため、新しいディレクトリ内の最初のファイルはセッション再起動が必要です。これが最も一般的な原因です。

685* **無効なフロントマターまたは重複した `name`**: ファイルの YAML を確認し、既存のエージェントが同じ `name` を使用していないか確認してください。

686* **`--disable-slash-commands`**: このフラグで開始されたセッションはこれらのディレクトリを監視せず、新しいファイルを読み込むには常に再起動が必要です。

687* **同じ名前のプログラマティックエージェント**: `query()` に渡される `agents` は、同じ名前のファイルシステムエージェントをオーバーライドします。

688

689ファイル形式については、[サブエージェントファイルの書き方](/ja/sub-agents#write-subagent-files)を参照してください。

674 690

675<h3 id="windows-long-prompt-failures">691<h3 id="long-prompt-failures-on-windows">

676 Windows：長いプロンプトの失敗692 Windows での長いプロンプトの失敗

677</h3>693</h3>

678 694

679Windows では、非常に長いプロンプトを持つサブエージェントは、コマンドライン長の制限（8191 文字）により失敗する場合があります。プロンプトを簡潔に保つか、複雑な指示にはファイルシステムベースのエージェントを使用してください。695Windows では、非常に長いプロンプトを持つサブエージェントは、コマンドラインの長さ制限である 8191 文字により失敗する場合があります。プロンプトを簡潔に保つか、複雑な指示にはファイルシステムベースのエージェントを使用してください。

680 696

681<h2 id="related-documentation">697<h2 id="related-documentation">

682 関連ドキュメント698 関連ドキュメント

agent-sdk/todo-tracking.md +65 −5

Details

9Todo 追跡は、タスクを管理し、ユーザーに進捗を表示するための構造化された方法を提供します。Claude Agent SDK には、複雑なワークフローを整理し、ユーザーにタスク進捗を知らせるのに役立つ組み込み todo 機能が含まれています。9Todo 追跡は、タスクを管理し、ユーザーに進捗を表示するための構造化された方法を提供します。Claude Agent SDK には、複雑なワークフローを整理し、ユーザーにタスク進捗を知らせるのに役立つ組み込み todo 機能が含まれています。

10 10

11<Note>11<Note>

12 TypeScript Agent SDK 0.3.142 および Claude Code v2.1.142 以降、セッションは `TodoWrite` の代わりに構造化された Task ツール `TaskCreate`、`TaskUpdate`、`TaskGet`、および `TaskList` を使用します。監視コードの変更方法については、[Task ツールへの移行](#migrate-to-task-tools)を参照してください。このページの例では、まだ移行していないセッションの `TodoWrite` を引き続き表示するために `CLAUDE_CODE_ENABLE_TASKS=0` を設定しています。12 TypeScript Agent SDK 0.3.142 および Claude Code v2.1.142 以降、セッションは `TodoWrite` の代わりに構造化された Task ツール `TaskCreate`、`TaskUpdate`、`TaskGet`、および `TaskList` を使用します。Python SDK は Python パッケージバージョンではなく、起動する Claude Code CLI からこの変更を取得します。スイッチは、その CLI（pip パッケージ内にバンドルされているコピー、または `cli_path` で指定するコピー）が v2.1.142 以降の場合に適用されます。監視コードの変更方法については、[Task ツールへの移行](#migrate-to-task-tools)を参照してください。このページの例では、まだ移行していないセッションの `TodoWrite` を引き続き表示するために `CLAUDE_CODE_ENABLE_TASKS=0` を設定しています。

13</Note>13</Note>

14 14

15<h3 id="todo-lifecycle">15<h3 id="todo-lifecycle">

38 例38 例

39</h2>39</h2>

40 40

41これらの例を実行する前に、[クイックスタート](/ja/agent-sdk/quickstart)に従って Claude Agent SDK をインストールしてください。

43各例はエージェントが完了して最終結果メッセージを生成するまで実行されます。セッションがターン制限に最初に達した場合、その結果メッセージは `error_max_turns` サブタイプを持ちます。終了を検出するために `subtype` を確認してください。

45これらの例は単一ショットの `query()` 呼び出しを使用します。`error_max_turns` 結果を生成した後、`query()` は `Reached maximum number of turns` を含むエラーを発生させます。各例はそれが発生したときにクリーンに終了するために、ループを try ブロックでラップします。

47結果サブタイプについては、[結果を処理する](/ja/agent-sdk/agent-loop#handle-the-result)を参照してください。

41<h3 id="monitoring-todo-changes">49<h3 id="monitoring-todo-changes">

42 Todo 変更の監視50 Todo 変更の監視

43</h3>51</h3>

46 ```typescript TypeScript theme={null}54 ```typescript TypeScript theme={null}

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

48 56

57 try {

49 for await (const message of query({58 for await (const message of query({

50 prompt: "Optimize my React app performance and track progress with todos",59 prompt: "Optimize my React app performance and track progress with todos",

51 // Re-enable TodoWrite, which this example monitors. Without it, the SDK uses60 // Re-enable TodoWrite, which this example monitors. Without it, the SDK uses

68 }77 }

69 }78 }

70 }79 }

80 } catch (error) {

81 // A single-shot query() throws after yielding an error result,

82 // such as when the maxTurns limit is hit.

83 console.log(`Session ended with an error: ${error}`);

84 }

71 ```85 ```

72 86

73 ```python Python theme={null}87 ```python Python theme={null}

88 import asyncio

74 from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ToolUseBlock90 from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ToolUseBlock

75 91

93 async def main():

94 try:

76 async for message in query(95 async for message in query(

77 prompt="Optimize my React app performance and track progress with todos",96 prompt="Optimize my React app performance and track progress with todos",

78 # Re-enable TodoWrite, which this example monitors. Without it, the SDK uses97 # Re-enable TodoWrite, which this example monitors. Without it, the SDK uses

95 else "❌"114 else "❌"

96 )115 )

97 print(f"{i + 1}. {status} {todo['content']}")116 print(f"{i + 1}. {status} {todo['content']}")

117 except Exception as error:

118 # A single-shot query() raises after yielding an error result,

119 # such as when the max_turns limit is hit.

120 print(f"Session ended with an error: {error}")

121

122

123 asyncio.run(main())

98 ```124 ```

99</CodeGroup>125</CodeGroup>

100 126

128 }154 }

129 155

130 async trackQuery(prompt: string) {156 async trackQuery(prompt: string) {

157 try {

131 for await (const message of query({158 for await (const message of query({

132 prompt,159 prompt,

133 // Re-enable TodoWrite, which this tracker watches for.160 // Re-enable TodoWrite, which this tracker watches for.

142 }169 }

143 }170 }

144 }171 }

172 } catch (error) {

173 // A single-shot query() throws after yielding an error result,

174 // such as when the maxTurns limit is hit.

175 console.log(`Session ended with an error: ${error}`);

176 }

145 }177 }

146 }178 }

147 179

151 ```183 ```

152 184

153 ```python Python theme={null}185 ```python Python theme={null}

186 import asyncio

187

154 from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ToolUseBlock188 from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ToolUseBlock

155 from typing import List, Dict189 from typing import List, Dict

156 190

186 print(f"{i + 1}. {icon} {text}")220 print(f"{i + 1}. {icon} {text}")

187 221

188 async def track_query(self, prompt: str):222 async def track_query(self, prompt: str):

223 try:

189 async for message in query(224 async for message in query(

190 prompt=prompt,225 prompt=prompt,

191 # Re-enable TodoWrite, which this tracker watches for.226 # Re-enable TodoWrite, which this tracker watches for.

196 if isinstance(block, ToolUseBlock) and block.name == "TodoWrite":231 if isinstance(block, ToolUseBlock) and block.name == "TodoWrite":

197 self.todos = block.input["todos"]232 self.todos = block.input["todos"]

198 self.display_progress()233 self.display_progress()

234 except Exception as error:

235 # A single-shot query() raises after yielding an error result,

236 # such as when the max_turns limit is hit.

237 print(f"Session ended with an error: {error}")

199 238

200 239

201 # Usage240 # Usage

241 async def main():

202 tracker = TodoTracker()242 tracker = TodoTracker()

203 await tracker.track_query("Build a complete authentication system with todos")243 await tracker.track_query("Build a complete authentication system with todos")

244

245

246 asyncio.run(main())

204 ```247 ```

205</CodeGroup>248</CodeGroup>

206 249

217| アイテム形状：`{ content, status, activeForm }` | `TaskCreate` 入力：`{ subject, description, activeForm?, metadata? }`。`TaskUpdate` 入力：`{ taskId, status?, subject?, description?, activeForm?, addBlocks?, addBlockedBy?, owner?, metadata? }`。`status` は `"pending"`、`"in_progress"`、または `"completed"`；削除するには `status: "deleted"` を設定 |260| アイテム形状：`{ content, status, activeForm }` | `TaskCreate` 入力：`{ subject, description, activeForm?, metadata? }`。`TaskUpdate` 入力：`{ taskId, status?, subject?, description?, activeForm?, addBlocks?, addBlockedBy?, owner?, metadata? }`。`status` は `"pending"`、`"in_progress"`、または `"completed"`；削除するには `status: "deleted"` を設定 |

219 262

220割り当てられたタスク ID は `TaskCreate` 入力にはありません。マッチング `tool_result` で `{ task: { id, subject } }` として返されるため、マップをキー付けするために結果ブロックからそれをキャプチャします。次の例は、[Todo 変更の監視](#monitoring-todo-changes)ループへの最小限の変更を示しています。完全なリストをレンダリングするには、ストリーム内の `TaskList` ツール結果を監視するか、`TaskCreate` 結果と `TaskUpdate` 入力をマップに蓄積します。263割り当てられたタスク ID は `TaskCreate` 入力にはありません。マッチング `tool_result` で `{ task: { id, subject } }` として返されるため、マップをキー付けするために結果ブロックからそれをキャプチャします。次の例は、[Todo 変更の監視](#monitoring-todo-changes)ループへの最小限の変更を示しています。ストリーム内の `TaskList` ツール結果を監視するか、`TaskCreate` 結果と `TaskUpdate` 入力をマップに蓄積することで、完全なリストをレンダリングできます。

221 264

222ストリーミングされた `tool_use` 入力は、モデルが発行した生の形状です。Claude Code は実行前にいくつかの近いが正確でないキー名を修復し、`id` または `task_id` を `taskId` にマッピングし、`active_form` を `activeForm` にマッピングしますが、その修復はストリームに反映されません。以下のサンプルのように、常に正規名が存在すると仮定するのではなく、`TaskUpdate` 入力フィールドを防御的に読み取ります。265ストリーミングされた `tool_use` 入力は、モデルが発行した生の形状です。Claude Code は実行前にいくつかの近いが正確でないキー名を修復し、`id` または `task_id` を `taskId` にマッピングし、`active_form` を `activeForm` にマッピングしますが、その修復はストリームに反映されません。以下のサンプルのように、常に正規名が存在すると仮定するのではなく、`TaskUpdate` 入力フィールドを防御的に読み取ります。

223 266

225 ```typescript TypeScript theme={null}268 ```typescript TypeScript theme={null}

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

227 270

271 try {

228 for await (const message of query({272 for await (const message of query({

229 prompt: "Optimize my React app performance",273 prompt: "Optimize my React app performance and track progress with todos",

274 options: { maxTurns: 15 },

230 })) {275 })) {

231 if (message.type !== "assistant") continue;276 if (message.type !== "assistant") continue;

232 for (const block of message.message.content) {277 for (const block of message.message.content) {

246 }291 }

247 }292 }

248 }293 }

294 } catch (error) {

295 // A single-shot query() throws after yielding an error result.

296 console.log(`Session ended with an error: ${error}`);

297 }

249 ```298 ```

250 299

251 ```python Python theme={null}300 ```python Python theme={null}

252 from claude_agent_sdk import query, AssistantMessage, ToolUseBlock301 import asyncio

253 302

303 from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ToolUseBlock

304

305 async def main():

306 try:

254 async for message in query(307 async for message in query(

255 prompt="Optimize my React app performance",308 prompt="Optimize my React app performance and track progress with todos",

309 options=ClaudeAgentOptions(max_turns=15),

256 ):310 ):

257 if not isinstance(message, AssistantMessage):311 if not isinstance(message, AssistantMessage):

258 continue312 continue

269 )323 )

270 if task_id:324 if task_id:

271 print(f" {task_id} -> {block.input['status']}")325 print(f" {task_id} -> {block.input['status']}")

326 except Exception as error:

327 # A single-shot query() raises after yielding an error result.

328 print(f"Session ended with an error: {error}")

329

330

331 asyncio.run(main())

272 ```332 ```

273</CodeGroup>333</CodeGroup>

274 334

agent-sdk/typescript.md +19 −7

Details

551```551```

552 552

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

554* `CLAUDE_CODE_MAX_RETRIES`：最大 API リトライ数。デフォルト `10`、上限 `15`。各リトライは独自の `API_TIMEOUT_MS` ウィンドウを取得するため、最悪の場合の経過時間は約 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` にバックオフを加えたものです。無人実行で長い停止を待つ必要がある場合は、`CLAUDE_CODE_RETRY_WATCHDOG=1` を設定して容量エラーを無限に再試行します。554* `CLAUDE_CODE_MAX_RETRIES`：最大 API リトライ数。デフォルト `10`、上限 `15`。各リトライは独自の `API_TIMEOUT_MS` ウィンドウを取得するため、最悪の場合の経過時間は約 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` にバックオフを加えたものです。無人実行で長い停止を待つ必要がある場合は、`CLAUDE_CODE_RETRY_WATCHDOG=1` を設定して容量エラーを無限に再試行します。{/* min-version: 2.1.199 */}Claude Code v2.1.199 以降では、他の一時的なエラーのデフォルトを `300` に引き上げ、この変数の上限を削除します。

555* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`：`run_in_background` で起動されたサブエージェントの停止ウォッチドッグ。デフォルト `600000`。各ストリームイベントでリセットされます。停止時にサブエージェントを中止し、タスクを失敗とマークし、部分的な結果を含むエラーを親に表示します。同期サブエージェントには適用されません。555* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`：`run_in_background` で起動されたサブエージェントの停止ウォッチドッグ。デフォルト `600000`。各ストリームイベントでリセットされます。停止時にサブエージェントを中止し、タスクを失敗とマークし、部分的な結果を含むエラーを親に表示します。同期サブエージェントには適用されません。

556* `CLAUDE_ENABLE_STREAM_WATCHDOG` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`：ヘッダーが到着したがレスポンスボディがストリーミングを停止したときにリクエストを中止します。ウォッチドッグはすべてのプロバイダーでデフォルトでオンになっています。`CLAUDE_ENABLE_STREAM_WATCHDOG=0` で無効にします。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` はデフォルトで `300000` で、その最小値にクランプされます。中止されたリクエストは通常のリトライパスを通ります。556* `CLAUDE_ENABLE_STREAM_WATCHDOG` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`：ヘッダーが到着したがレスポンスボディがストリーミングを停止したときにリクエストを中止します。ウォッチドッグはすべてのプロバイダーでデフォルトでオンになっています。`CLAUDE_ENABLE_STREAM_WATCHDOG=0` で無効にします。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` はデフォルトで `300000` で、その最小値にクランプされます。中止されたリクエストは通常のリトライパスを通ります。

557 557

901 decisionReason?: string;901 decisionReason?: string;

902 toolUseID: string;902 toolUseID: string;

903 agentID?: string;903 agentID?: string;

904 requestId: string;

904 }905 }

905) => Promise<PermissionResult>;906) => Promise<PermissionResult | null>;

906```907```

907 908

908| オプション | 型 | 説明 |909| オプション | 型 | 説明 |

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

918

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

920

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

916 922

917<h3 id="permissionresult">923<h3 id="permissionresult">

918 `PermissionResult`924 `PermissionResult`

2179};2185};

2180```2186```

2181 2187

2182ID でバックグラウンドタスクまたはシェルを停止します。2188ID でバックグラウンドタスクまたはシェルを停止します。{/* min-version: 2.1.198 */}v2.1.198 以降、`task_id` はエージェントチームのチームメイト、またはエージェント ID または名前で名前付きバックグラウンドエージェントも受け入れます。

2183 2189

2184<h3 id="notebookedit">2190<h3 id="notebookedit">

2185 NotebookEdit2191 NotebookEdit

3788| `ripgrep` | `{ command: string; args?: string[] }` | `undefined` | サンドボックス環境のカスタム ripgrep バイナリ設定 |3794| `ripgrep` | `{ command: string; args?: string[] }` | `undefined` | サンドボックス環境のカスタム ripgrep バイナリ設定 |

3789 3795

3790<Note>3796<Note>

3791 サンドボックスはプラットフォームサポートに依存し、Linux では `bubblewrap` や `socat` などのツールが必要です。`enabled` が `true` でサンドボックスが起動できない場合、`query()` は `subtype: "error_during_execution"` の `result` メッセージを報告し、理由を `errors` に含めて停止します。`query()` がメッセージを生成する前に例外をスローすることを期待するのではなく、そのサブタイプを監視してください。3797 サンドボックスはプラットフォームサポートに依存し、Linux では `bubblewrap` や `socat` などのツールが必要です。`enabled` が `true` でサンドボックスが起動できない場合、`query()` は `subtype: "error_during_execution"` の `result` メッセージを報告し、理由を `errors` に含めます。単一メッセージの `query()` 呼び出しの場合、SDK はそのエラー結果を生成した後にスローするため、ループを try ブロックでラップして、それを超えて続行してください。エラーコントラクトについては [結果を処理する](/ja/agent-sdk/agent-loop#handle-the-result) を参照してください。

3792 3798

3793 代わりにサンドボックス外で実行するには、`failIfUnavailable: false` を設定してください。3799 代わりにサンドボックス外で実行するには、`failIfUnavailable: false` を設定してください。

3794</Note>3800</Note>

3800```typescript theme={null}3806```typescript theme={null}

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

3802 3808

3803for await (const message of query({3809try {

3810 for await (const message of query({

3804 prompt: "Build and test my project",3811 prompt: "Build and test my project",

3805 options: {3812 options: {

3806 sandbox: {3813 sandbox: {

3811 }3818 }

3812 }3819 }

3813 }3820 }

3814})) {3821 })) {

3815 if ("result" in message) console.log(message.result);3822 if ("result" in message) console.log(message.result);

3823 }

3824} catch (error) {

3825 // A single-shot query() throws after yielding an error result,

3826 // such as when the sandbox can't start (failIfUnavailable defaults to true).

3827 console.log(`Session ended with an error: ${error}`);

3816}3828}

3817```3829```

3818 3830

3929<Warning>3941<Warning>

3930 `dangerouslyDisableSandbox: true` で実行されるコマンドはシステムへの完全なアクセスを持ちます。`canUseTool` ハンドラーがこれらのリクエストを慎重に検証することを確認してください。3942 `dangerouslyDisableSandbox: true` で実行されるコマンドはシステムへの完全なアクセスを持ちます。`canUseTool` ハンドラーがこれらのリクエストを慎重に検証することを確認してください。

3931 3943

3932 `permissionMode` が `bypassPermissions` に設定され、`allowUnsandboxedCommands` が有効な場合、モデルは承認プロンプトなしにサンドボックス外でコマンドを自律的に実行できます。この組み合わせにより、モデルはサンドボックス分離を静かにエスケープできます。3944 `permissionMode` が `bypassPermissions` に設定され、`allowUnsandboxedCommands` が有効な場合、モデルは承認プロンプトなしにサンドボックス外でコマンドを自律的に実行できます（明示的な [`ask` ルール](/ja/agent-sdk/permissions#how-permissions-are-evaluated) はそれでも強制します）。この組み合わせにより、モデルはサンドボックス分離を静かにエスケープできます。

3933</Warning>3945</Warning>

3934 3946

3935<h2 id="see-also">3947<h2 id="see-also">

agent-teams.md +12 −3

Details

89* **Enter**: 選択したチームメンバーのトランスクリプトを開き、直接メッセージを送信する89* **Enter**: 選択したチームメンバーのトランスクリプトを開き、直接メッセージを送信する

90* **Escape**: 選択したチームメンバーの現在のターンを中断する90* **Escape**: 選択したチームメンバーの現在のターンを中断する

91 91

92{/* min-version: 2.1.181 */}v2.1.181 以降、アイドル状態のチームメンバーの行は 30 秒後に非表示になり、次のターンで再表示されます。チームメンバーは非表示中も実行中で対応可能な状態が続きます。92{/* min-version: 2.1.199 */}v2.1.199 以降、アイドル状態のチームメンバーの行は、他のチームメンバーまたはサブエージェントがまだ作業中の間、パネルに留まるため、トランスクリプトを確認したり、さらに作業を割り当てたりするために選択できます。パネル内のすべてのエージェントがアイドル状態になると、アイドル行は 30 秒後に非表示になり、チームメンバーの次のターンで再表示されます。チームメンバーは非表示中も実行中で対応可能な状態が続きます。v2.1.181 から v2.1.198 では、アイドル行は他のチームメンバーがまだ作業中であっても、独自のターンが終了してから 30 秒後に非表示になりました。v2.1.181 より前のバージョンではアイドル行は非表示になりません。

943 人以上のチームメンバーが同時にアイドル状態の場合、最初の 3 行を超える行は、折りたたまれたチームメンバーをカウントする単一の行に折りたたまれます。例えば、5 人がアイドル状態の場合は `2 idle agents` のようになります。それを選択して Enter キーを押すと折りたたまれた行が展開され、Esc キーを押すと再び折りたたまれます。作業中のチームメンバー、失敗したチームメンバー、および表示中のチームメンバーは常に独自の行を保持します。

93 95

94各チームメンバーを独自の分割ペインに配置したい場合は、[表示モードを選択](#choose-a-display-mode)を参照してください。96各チームメンバーを独自の分割ペインに配置したい場合は、[表示モードを選択](#choose-a-display-mode)を参照してください。

95 97

174* **In-process モード**：エージェントパネルで上下矢印キーを使用してチームメンバーを選択し、Enter キーを押してそのセッションを表示して、メッセージを入力してください。選択したチームメンバーで `x` を押してそれを停止してください。Ctrl+T を押してタスクリストを切り替えてください。176* **In-process モード**：エージェントパネルで上下矢印キーを使用してチームメンバーを選択し、Enter キーを押してそのセッションを表示して、メッセージを入力してください。選択したチームメンバーで `x` を押してそれを停止してください。Ctrl+T を押してタスクリストを切り替えてください。

175* **分割ペインモード**：チームメンバーのペインをクリックして、セッションと直接対話してください。各チームメンバーは独自のターミナルの完全なビューを持っています。177* **分割ペインモード**：チームメンバーのペインをクリックして、セッションと直接対話してください。各チームメンバーは独自のターミナルの完全なビューを持っています。

176 178

179In-process チームメンバーを表示している間、プレーンテキストと [skills](/ja/skills) はそのチームメンバーに送信されますが、組み込みコマンドはリーダーのセッションで実行されます。

180

181チームメンバーのモデルと高速モードはそれが生成されるときに固定されるため、`/model` と `/fast` はリーダーの設定のみを変更します。{/* min-version: 2.1.199 */}v2.1.199 以降、チームメンバーを表示している間にいずれかのコマンドを入力すると、変更がリーダーに適用されることを示す通知が表示されます。それより前のバージョンでは、指示なしでリーダーに適用されました。`/effort` はチームメンバーの後続のターンに適用されます。これはチームメンバーがリーダーの[努力レベル](/ja/model-config#adjust-effort-level)に従うためです。

182

177<h3 id="assign-and-claim-tasks">183<h3 id="assign-and-claim-tasks">

178 タスクを割り当てて要求する184 タスクを割り当てて要求する

179</h3>185</h3>

295**チームメンバーが情報を共有する方法：**301**チームメンバーが情報を共有する方法：**

296 302

297* **自動メッセージ配信**：チームメンバーがメッセージを送信すると、受信者に自動的に配信されます。リーダーは更新をポーリングする必要はありません。303* **自動メッセージ配信**：チームメンバーがメッセージを送信すると、受信者に自動的に配信されます。リーダーは更新をポーリングする必要はありません。

298* **アイドル通知**：チームメンバーが完了して停止すると、リーダーに自動的に通知します。304* **アイドル通知**：チームメンバーが完了して停止すると、リーダーに自動的に通知します。{/* min-version: 2.1.198 */}v2.1.198 以降、ターンが API エラーで終了するチームメンバーは、通常に完了したように見えるのではなく、失敗したことをリーダーに通知し、エラーテキストを含めます。

299* **共有タスクリスト**：すべてのエージェントはタスクステータスを表示でき、利用可能な作業を要求できます。305* **共有タスクリスト**：すべてのエージェントはタスクステータスを表示でき、利用可能な作業を要求できます。

300* **チームメンバーメッセージング**：その名前で特定のチームメンバーにメッセージを送信します。全員に到達するには、受信者ごとに 1 つのメッセージを送信してください。306* **チームメンバーメッセージング**：その名前で特定のチームメンバーにメッセージを送信します。全員に到達するには、受信者ごとに 1 つのメッセージを送信してください。

301 307

430Claude にチームメンバーを生成するよう指示した後、チームメンバーが表示されない場合は、以下を実行してください。436Claude にチームメンバーを生成するよう指示した後、チームメンバーが表示されない場合は、以下を実行してください。

431 437

432* In-process モードでは、チームメンバーはプロンプト入力の下のエージェントパネルに表示されます。上下矢印キーを使用して 1 つを選択し、Enter キーを押して表示してください。438* In-process モードでは、チームメンバーはプロンプト入力の下のエージェントパネルに表示されます。上下矢印キーを使用して 1 つを選択し、Enter キーを押して表示してください。

433* アイドル状態で消えたチームメンバー行は停止されていなく、非表示になっています。アイドル行は 30 秒後に非表示になり、チームメンバーの次のターンで再表示されます。チームメンバーに名前でメッセージを送信して、それを戻してください。439* アイドル状態で消えたチームメンバー行は停止されていなく、非表示になっています。アイドル行はパネル全体がアイドル状態になってから 30 秒後に非表示になり、チームメンバーの次のターンで再表示されます。3 人以上のチームメンバーがアイドル状態の場合、余剰行は `N idle agents` という 1 つの行に折りたたまれ、Enter キーで展開されます。チームメンバーに名前でメッセージを送信して、非表示の行を戻してください。

434* Claude に提供したタスクがチームを必要とするほど十分複雑であることを確認してください。Claude はタスクに基づいてチームメンバーを生成するかどうかを決定します。440* Claude に提供したタスクがチームを必要とするほど十分複雑であることを確認してください。Claude はタスクに基づいてチームメンバーを生成するかどうかを決定します。

435* 明示的に分割ペインをリクエストした場合は、tmux がインストールされ、PATH で利用可能であることを確認してください。441* 明示的に分割ペインをリクエストした場合は、tmux がインストールされ、PATH で利用可能であることを確認してください。

436 ```bash theme={null}442 ```bash theme={null}

453* 直接追加の指示を与える459* 直接追加の指示を与える

454* 作業を続行するために置き換えチームメンバーを生成する460* 作業を続行するために置き換えチームメンバーを生成する

455 461

462{/* min-version: 2.1.198 */}v2.1.198 以降、リーダーまたは別のチームメンバーからのメッセージは、失敗した API リクエストの再試行を待機している In-process チームメンバーをウェイクアップするため、完全な再試行遅延を待つ代わりに、すぐに再試行されます。

463

456<h3 id="lead-shuts-down-before-work-is-done">464<h3 id="lead-shuts-down-before-work-is-done">

457 リーダーが作業完了前にシャットダウンする465 リーダーが作業完了前にシャットダウンする

458</h3>466</h3>

481* **シャットダウンが遅い可能性**：チームメンバーは現在のリクエストまたはツール呼び出しを完了してからシャットダウンし、時間がかかる可能性があります。489* **シャットダウンが遅い可能性**：チームメンバーは現在のリクエストまたはツール呼び出しを完了してからシャットダウンし、時間がかかる可能性があります。

482* **セッションあたり 1 つのチーム**：セッションは正確に 1 つのチームを持ち、そのセッションにスコープされています。追加の名前付きチームを作成したり、セッション間でチームを共有したりすることはできません。490* **セッションあたり 1 つのチーム**：セッションは正確に 1 つのチームを持ち、そのセッションにスコープされています。追加の名前付きチームを作成したり、セッション間でチームを共有したりすることはできません。

483* **ネストされたチームなし**：チームメンバーは独自のチームメンバーを生成できません。リーダーのみがチームを管理できます。491* **ネストされたチームなし**：チームメンバーは独自のチームメンバーを生成できません。リーダーのみがチームを管理できます。

492* **In-process チームメンバーからのバックグラウンドサブエージェントなし**：in-process チームメンバー自身のサブエージェントはフォアグラウンドで実行されます。`run_in_background` を使用するか、`background: true` を設定するサブエージェント定義を使用して、バックグラウンドのものを要求すると、エラーが返されます。これは、チームメンバーのバックグラウンド作業がリーダーのプロセスより長く存在できないためです。メイン会話から起動されたサブエージェントは、[バックグラウンドデフォルト](/ja/sub-agents#run-subagents-in-foreground-or-background)に従います。

484* **リーダーは固定**：メインセッションはその生涯のリーダーです。チームメンバーをリーダーに昇格させたり、リーダーシップを譲渡したりすることはできません。493* **リーダーは固定**：メインセッションはその生涯のリーダーです。チームメンバーをリーダーに昇格させたり、リーダーシップを譲渡したりすることはできません。

485* **権限は生成時に設定**：すべてのチームメンバーはリーダーの権限モードで開始します。生成後に個別のチームメンバーモードを変更できますが、生成時にチームメンバーごとのモードを設定することはできません。494* **権限は生成時に設定**：すべてのチームメンバーはリーダーの権限モードで開始します。生成後に個別のチームメンバーモードを変更できますが、生成時にチームメンバーごとのモードを設定することはできません。

486* **分割ペインには tmux または iTerm2 が必要**：デフォルトの in-process モードは任意のターミナルで動作します。分割ペインモードは VS Code の統合ターミナル、Windows Terminal、または Ghostty ではサポートされていません。495* **分割ペインには tmux または iTerm2 が必要**：デフォルトの in-process モードは任意のターミナルで動作します。分割ペインモードは VS Code の統合ターミナル、Windows Terminal、または Ghostty ではサポートされていません。

agent-view.md +85 −22

Details

27* [クイックスタート](#quick-start)：Claude にバックグラウンドで作業するタスクを与え、確認し、必要なときに介入する27* [クイックスタート](#quick-start)：Claude にバックグラウンドで作業するタスクを与え、確認し、必要なときに介入する

28* [エージェントビューでセッションを監視する](#monitor-sessions-with-agent-view)。状態アイコン、ピーク表示と返信、アタッチ、整理、キーボードショートカットを含みます28* [エージェントビューでセッションを監視する](#monitor-sessions-with-agent-view)。状態アイコン、ピーク表示と返信、アタッチ、整理、キーボードショートカットを含みます

29* [新しいエージェントをディスパッチする](#dispatch-new-agents)。エージェントビューから、セッション内から、またはシェルから29* [新しいエージェントをディスパッチする](#dispatch-new-agents)。エージェントビューから、セッション内から、またはシェルから

~~30* [シェルからセッションを管理する](#manage-sessions-from-the-shell)~~30* [シェルからセッションを管理する](#manage-sessions-from-the-shell)。`claude agents`、`claude attach`、および関連コマンドを使用して

31* [バックグラウンドセッションがどのようにホストされるか](#how-background-sessions-are-hosted)。スーパーバイザープロセスによって31* [バックグラウンドセッションがどのようにホストされるか](#how-background-sessions-are-hosted)。スーパーバイザープロセスによって

32 32

33<h2 id="quick-start">33<h2 id="quick-start">

64 </Step>64 </Step>

65 65

66 <Step title="既存のセッションを持ち込む">66 <Step title="既存のセッションを持ち込む">

67 既に開いているセッションをエージェントビューに移動するには、セッション内で `/bg` を実行するか、空のプロンプトで `←` を押してセッションをバックグラウンドにし、1 ステップでエージェントビューを開きます。セッションは実行し続け、ディスパッチしたセッションと並行して行として表示されます。67 このステップは実行中のセッションが必要です。前のステップに従った場合、このターミナルで開いているセッションはないため、別のターミナルで通常の `claude` セッションを開き、最初にメッセージを送信してください。既に開いているセッションをエージェントビューに移動するには、セッション内で `/bg` を実行するか、空のプロンプトで `←` を押してセッションをバックグラウンドにし、1 ステップでエージェントビューを開きます。セッションは実行し続け、ディスパッチしたセッションと並行して行として表示されます。

68 </Step>68 </Step>

69</Steps>69</Steps>

70 70

76 76

77`claude agents` を実行してエージェントビューを開きます。ターミナル全体を占有し、状態でグループ化されたすべてのセッションをリストします。ピン留めされたセッションと入力が必要なセッションが上部に表示されます。各行はセッションの名前、現在のアクティビティ、最後に変更されてからの経過時間を表示します。77`claude agents` を実行してエージェントビューを開きます。ターミナル全体を占有し、状態でグループ化されたすべてのセッションをリストします。ピン留めされたセッションと入力が必要なセッションが上部に表示されます。各行はセッションの名前、現在のアクティビティ、最後に変更されてからの経過時間を表示します。

78 78

79名前は、そのセッションで [`/color`](/ja/commands) によって設定されたカラーで色付けされます。{/* min-version: 2.1.199 */}v2.1.199 以降、`←` または `/background` で [セッションをバックグラウンドにする](#from-inside-a-session) ときにカラーが引き継がれます。

79デフォルトでは、リストはすべてのプロジェクト全体で開始したすべてのバックグラウンドセッションを表示します。1 つのリポジトリで作業しているセッションと別のワークツリーで作業している別のセッションの両方がここに表示されます。エージェントビューを開いたディレクトリに関係なく表示されます。リストを 1 つのプロジェクトに絞り込むには、`--cwd` を渡します：81デフォルトでは、リストはすべてのプロジェクト全体で開始したすべてのバックグラウンドセッションを表示します。1 つのリポジトリで作業しているセッションと別のワークツリーで作業している別のセッションの両方がここに表示されます。エージェントビューを開いたディレクトリに関係なく表示されます。リストを 1 つのプロジェクトに絞り込むには、`--cwd` を渡します：

80 82

81```bash theme={null}83```bash theme={null}

91 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m93 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m

92 94

93Ready for review95Ready for review

~~94 ∙ jump physics Opened PR with collision fix PR #2048 2h~~96 ∙ jump physics Opened PR with collision fix #2048 2h

95 97

96Needs input98Needs input

97 ✻ power-up design needs input: double jump or wall climb? 1m99 ✻ power-up design needs input: double jump or wall climb? 1m

110 セッション状態を読む112 セッション状態を読む

111</h3>113</h3>

112 114

113各行は、セッションの状態を示すアイコンで始まります。アイコンの色とアニメーションはセッションの状態を示します。115各行は、セッションの状態を示すアイコンで始まります。アイコンの色とアニメーションはセッションの状態を示します：

114 116

115| 状態 | アイコン表示 | 意味 |117| 状態 | アイコン表示 | 意味 |

116| :---- | :------ | :----------------------------------------- |118| :---- | :------ | :----------------------------------------- |

121| 失敗 | 赤 | タスクがエラーで終了しました |123| 失敗 | 赤 | タスクがエラーで終了しました |

122| 停止 | グレー | セッションは `Ctrl+X` または `claude stop` で停止されました |124| 停止 | グレー | セッションは `Ctrl+X` または `claude stop` で停止されました |

123 125

124別に、アイコンの形状は基盤となるプロセスが実行しているかどうかを示します。126別に、アイコンの形状は基盤となるプロセスが実行しているかどうかを示します：

125 127

126| 形状 | 意味 |128| 形状 | 意味 |

127| :----------------- | :--------------------------------------------------------------------------- |129| :----------------- | :--------------------------------------------------------------------------- |

129| `∙` | プロセスは終了しました。ピーク表示、返信、またはアタッチはできます。Claude は中断したところから再開します |131| `∙` | プロセスは終了しました。ピーク表示、返信、またはアタッチはできます。Claude は中断したところから再開します |

130| `✢` | [`/loop`](/ja/scheduled-tasks) セッションはイテレーション間でスリープしています。行は実行回数とカウントダウンを表示します |132| `✢` | [`/loop`](/ja/scheduled-tasks) セッションはイテレーション間でスリープしています。行は実行回数とカウントダウンを表示します |

131 133

132行の右端に表示される `PR #N` ラベルは [セッションが開いたプルリクエスト](#pull-request-status) であり、状態アイコンの一部ではありません。セッションが複数のプルリクエストを開いた場合、ラベルはカウントを表示します。例えば `3 PRs` のようになります。134行の右端に表示される `#N` ラベルは [セッションが開いたプルリクエスト](#pull-request-status) であり、状態アイコンの一部ではありません。

133 135

134ターミナルタブのタイトルは、エージェントビューが開いている間、待機中の入力カウントを表示します。セッションが入力を必要とする場合は `2 awaiting input · claude agents`、そうでない場合は `claude agents` です。136ターミナルタブのタイトルは、エージェントビューが開いている間、待機中の入力カウントを表示します。セッションが入力を必要とする場合は `2 awaiting input · claude agents`、そうでない場合は `claude agents` です。

135 137

138v2.1.198 以降、エージェントビューが開いている間、Claude Code はローカルバックグラウンドセッションが入力を必要とし始めたとき、完了したとき、または失敗したときに、設定された [ターミナル通知チャネル](/ja/terminal-config#get-a-terminal-bell-or-notification) を通じて通知を送信します。[`/loop`](/ja/scheduled-tasks) セッションなどのスケジュールで実行されるセッションは、入力が必要な場合にのみ通知します。通知は Claude Code の残りの部分と同じ [`preferredNotifChannel` 設定](/ja/settings#available-settings) を使用し、`agent_needs_input` または `agent_completed` タイプで [`Notification` フック](/ja/hooks#notification) を発火します。

139

136バックグラウンドセッションは作業を続けるためにターミナルを開く必要がありません。別の [スーパーバイザープロセス](#the-supervisor-process) がセッションを実行するため、エージェントビューを閉じたり、シェルを閉じたり、新しいインタラクティブセッションを開始したりしても、ディスパッチされた作業は続きます。140バックグラウンドセッションは作業を続けるためにターミナルを開く必要がありません。別の [スーパーバイザープロセス](#the-supervisor-process) がセッションを実行するため、エージェントビューを閉じたり、シェルを閉じたり、新しいインタラクティブセッションを開始したりしても、ディスパッチされた作業は続きます。

137 141

138セッション状態はディスク上に永続化され、自動更新とスーパーバイザー再起動を通じて保存されます。セッションはマシンがスリープするときも保存されます。プロセスはウェイク時に再開され、スーパーバイザーはアイドルとして時間ギャップを扱う代わりにそれらに再接続します。シャットダウンはまだ実行中のセッションを停止します。[シャットダウン後にセッションが失敗として表示される](#sessions-show-as-failed-after-shutdown) を参照して、それらを復旧する方法を確認してください。142セッション状態はディスク上に永続化され、自動更新とスーパーバイザー再起動を通じて保存されます。セッションはマシンがスリープするときも保存されます。プロセスはウェイク時に再開され、スーパーバイザーはアイドルとして時間ギャップを扱う代わりにそれらに再接続します。シャットダウンはまだ実行中のセッションを停止します。[シャットダウン後にセッションが失敗として表示される](#sessions-show-as-failed-after-shutdown) を参照して、それらを復旧する方法を確認してください。

151 プルリクエストステータス155 プルリクエストステータス

152</h3>156</h3>

153 157

154セッションがプルリクエストを開くと、`PR #1234` ラベルが行の右端に表示され、ハイパーリンクをサポートするターミナルではプルリクエストにリンクされます。セッションにフォローアップを送信するときもラベルは保存されるため、行がライブプログレスに戻るときもプルリクエストは表示されたままです。158セッションがプルリクエストを開くと、`#1234` ラベルが行の右端に表示され、ハイパーリンクをサポートするターミナルではプルリクエストにリンクされます。セッションにフォローアップを送信するときもラベルは保存されるため、行がライブプログレスに戻るときもプルリクエストは表示されたままです。ワークツリーで変更を分離したバックグラウンドセッションはこれらのプルリクエストを自分で開きます。[ファイル編集がどのように分離されるか](#how-file-edits-are-isolated) はそれが起こるときと、セッションが尋ねずに何をしないかをカバーしています。

155 159

156セッションが複数のプルリクエストを開いた場合、ラベルはカウントを表示します。例えば `3 PRs` のようになり、最も注意が必要なオープンプルリクエストで色付けされます。[ピークパネル](#peek-and-reply) を開いてすべてを表示します。160セッションが複数のプルリクエストを開いた場合、ラベルはカウントを表示します。例えば `3 PRs` のようになり、最も注意が必要なオープンプルリクエストで色付けされます。[ピークパネル](#peek-and-reply) を開いてすべてを表示します。

157 161

158プルリクエスト番号はそのステータスで色付けされます。162プルリクエスト番号はそのステータスで色付けされます：

159 163

160| カラー | プルリクエストステータス |164| カラー | プルリクエストステータス |

161| :-- | :------------------------- |165| :-- | :------------------------- |

190 194

191アタッチされたセッションは、`tui` 設定に関係なく、常に [フルスクリーンモード](/ja/fullscreen) でレンダリングされます。バックグラウンドセッションには追加するターミナルスクロールバックがないためです。`PgUp`、`PgDn`、またはマウスホイールでスクロールし、トランスクリプトモードの場合は `Ctrl+O` を押します。ターミナルのネイティブスクロールと tmux コピーモードは現在のビューポートのみを表示します。これはフルスクリーンアプリケーションを実行するときと同じです。195アタッチされたセッションは、`tui` 設定に関係なく、常に [フルスクリーンモード](/ja/fullscreen) でレンダリングされます。バックグラウンドセッションには追加するターミナルスクロールバックがないためです。`PgUp`、`PgDn`、またはマウスホイールでスクロールし、トランスクリプトモードの場合は `Ctrl+O` を押します。ターミナルのネイティブスクロールと tmux コピーモードは現在のビューポートのみを表示します。これはフルスクリーンアプリケーションを実行するときと同じです。

192 196

193空のプロンプトで `←` を押してデタッチし、エージェントビューに戻ります。ダイアログがフォーカスを持っており、`←` に応答していない場合は、`Ctrl+Z` を押して直ちにデタッチします。197空のプロンプトで `←` を押すか、`/exit` を実行してデタッチし、エージェントビューに戻ります。v2.1.198 以降、これはエージェントビューからセッションを開いたか、シェルから `claude attach <id>` を実行したかに関係なく同じように機能します。

198

199`Ctrl+Z` もデタッチしますが、開始した場所に戻ります。エージェントビューから接続した場合はエージェントビュー、またはシェルから `claude attach` を実行した場合はシェルです。ダイアログがフォーカスを持っており、`←` に応答していない場合は `Ctrl+Z` を使用します。

194 200

195`Ctrl+C` はアタッチ中に標準的な割り込み動作を保持します。実行中の応答または `!` シェルコマンドをキャンセルするのであり、デタッチするのではありません。空のプロンプトで `Ctrl+C` を 2 回押すとデタッチします。これは他のセッションと同じです。201`Ctrl+C` はアタッチ中に標準的な割り込み動作を保持します。実行中の応答または `!` シェルコマンドをキャンセルするのであり、デタッチするのではありません。空のプロンプトで `Ctrl+C` を 2 回押すとデタッチします。これは他のセッションと同じです。

196 202

197デタッチはバックグラウンドセッションを停止しません。`←`、`Ctrl+Z`、`/exit`、および二重 `Ctrl+C` または二重 `Ctrl+D` はすべてセッションを実行し続けます。セッション内からセッションを終了するには、`/stop` を実行します。203デタッチはバックグラウンドセッションを停止しません。`←`、`Ctrl+Z`、`/exit`、および二重 `Ctrl+C` または二重 `Ctrl+D` はすべてセッションを実行し続けます。セッション内からセッションを終了するには、`/stop` を実行します。

198 204

199空のプロンプトで `←` を押すと、エージェントビューからアタッチしたセッションだけでなく、任意の Claude Code セッションから機能します。現在のセッションをバックグラウンドにし、そのセッションが事前に選択された状態でエージェントビューを開くため、ターミナルを離れずにセッションを切り替えることができます。行は会話履歴がない新しいセッションからでも作成されるため、`→` はそれに戻ります。その行が唯一の行である場合、エージェントビューはその下にオンボーディングヒントを表示します。このショートカットは `/config` でオフにできます（`leftArrowOpensAgents` 設定）。205フォアグラウンドで実行しているセッション、つまりエージェントビューからアタッチするのではなくターミナルで開始したセッションでは、空のプロンプトで `←` を押すとセッションをバックグラウンドにし、そのセッションが事前に選択された状態でエージェントビューを開きます。これにより、ターミナルを離れずにセッションを切り替えることができます。同じ単一の押下でアタッチされたセッションをデタッチします。

206

207`←` を押すときにツールが実行されている場合、Claude Code はそれが完了するまで約 10 秒待機してからバックグラウンドにし、応答はバックグラウンドセッションで続きます。代わりに待機せずにすぐにバックグラウンドにするには、`←` を再度押します。進行中の作業がバックグラウンドセッションに引き継ぐことができない場合、`Background this session?` ダイアログが最初に表示されます。これは [`/background`](#from-inside-a-session) と同じです。

208

209行は会話履歴がない新しいセッションからでも作成されるため、`→` はそれに戻ります。その行が唯一の行である場合、エージェントビューはその下にオンボーディングヒントを表示します。

210

211このショートカットは `/config` の `leftArrowOpensAgents` 設定でオフにできます。

200 212

201<h3 id="organize-the-list">213<h3 id="organize-the-list">

202 リストを整理する214 リストを整理する

203</h3>215</h3>

204 216

205エージェントビューはセッションをグループ化し、入力が必要なセッションが上部に表示されます。`Ready for review` と `Needs input` は `Working` と `Completed` の上に表示されます。これらのグループ名は上記の [状態](#read-session-state) と 1 対 1 でマップされません。セッションはオープンなプルリクエストを持つときに `Ready for review` に移動し、`Completed` は完了、失敗、および停止したセッションを一緒に収集します。`Ctrl+S` を押してディレクトリでグループ化に切り替えます。選択内容は実行全体で保存されます。217エージェントビューはセッションをグループ化し、入力が必要なセッションが上部に表示されます。`Ready for review` と `Needs input` は `Working` と `Completed` の上に表示されます。これらのグループ名は上記の [状態](#read-session-state) と 1 対 1 でマップされません。セッションはオープンなプルリクエストを持つときに `Ready for review` に移動し、`Completed` は完了、失敗、および停止したセッションを一緒に収集します。

218

219`Ctrl+S` を押してディレクトリでグループ化に切り替えます。選択内容は実行全体で保存されます。

206 220

207グループ内で：221グループ内で：

208 222

215 229

216削除するとセッションがエージェントビューから削除されます。Claude が [ワークツリーを作成した](#how-file-edits-are-isolated) 場合、削除するとそのワークツリーも削除されます。コミットされていない変更を含みます。保持したい作業をプッシュまたはコミットしてから削除します。自分で作成したワークツリーとセッションを開始した場合は、そのままにしておきます。会話トランスクリプトはローカルマシンに残り、`claude --resume` を通じて利用可能です。230削除するとセッションがエージェントビューから削除されます。Claude が [ワークツリーを作成した](#how-file-edits-are-isolated) 場合、削除するとそのワークツリーも削除されます。コミットされていない変更を含みます。保持したい作業をプッシュまたはコミットしてから削除します。自分で作成したワークツリーとセッションを開始した場合は、そのままにしておきます。会話トランスクリプトはローカルマシンに残り、`claude --resume` を通じて利用可能です。

217 231

218古い完了したセッションは「… N more」行に折りたたまれ、リストを短く保ちます。失敗とオープンなプルリクエストを持つセッションは常に表示されます。232画面に収まらない完了したセッションは「… N more」行に折りたたまれます。失敗とオープンなプルリクエストを持つセッションは常に表示されます。`Completed` グループはライブグループの後に残された垂直スペースを埋め、短いターミナルではヘッダーが単一の概要行にコンパクトされるため、作業中または入力が必要なセッションが表示されたままです。

219 233

220<h3 id="filter-sessions">234<h3 id="filter-sessions">

221 セッションをフィルタリングする235 セッションをフィルタリングする

222</h3>236</h3>

223 237

224ディスパッチ入力に入力してディスパッチの代わりにフィルタリングします。238ディスパッチ入力に入力してディスパッチの代わりにフィルタリングします：

225 239

226| フィルター | 表示 |240| フィルター | 表示 |

227| :--------------------- | :----------------------------------------------------------------------- |241| :--------------------- | :----------------------------------------------------------------------- |

283 297

284エージェントビュー自体で実行される少数のコマンドがあります。ディスパッチの代わりに：`/exit` および `/quit` はエージェントビューを閉じ、`/logout` はサインアウトします。`/model` は [ディスパッチモデル](#set-the-model) を設定します。skills、独自のコマンド、および `/init` などのプロンプト展開組み込みは、新しいバックグラウンドセッションにその最初のプロンプトとして送信されます。その他の組み込みコマンドは、代わりに `attach to a session to run it` ヒントを表示します。298エージェントビュー自体で実行される少数のコマンドがあります。ディスパッチの代わりに：

299

300* `/exit` および `/quit` はエージェントビューを閉じます

301* `/logout` はサインアウトします

302* `/model` は [ディスパッチモデル](#set-the-model) を設定します

303* {/* min-version: 2.1.198 */}v2.1.198 以降、`/login` はサインインダイアログを開き、セッションにアタッチせずに再度サインインできます

304

305skills、独自のコマンド、および `/init` などのプロンプト展開組み込みは、新しいバックグラウンドセッションにその最初のプロンプトとして送信されます。その他の組み込みコマンドは、代わりに `attach to a session to run it` ヒントを表示します。

285 306

286繰り返しタスクを [skill](/ja/skills) としてパッケージ化すると、プロンプトを再入力せずにエージェントビューから同じワークフローを何度も開始できます。307繰り返しタスクを [skill](/ja/skills) としてパッケージ化すると、プロンプトを再入力せずにエージェントビューから同じワークフローを何度も開始できます。

287 308

294新しいセッションはエージェントビューを開いたディレクトリで実行されます。別のディレクトリをターゲットにするには、以下のいずれかを実行します：315新しいセッションはエージェントビューを開いたディレクトリで実行されます。別のディレクトリをターゲットにするには、以下のいずれかを実行します：

295 316

296* そのディレクトリで `claude agents` を開きます。317* そのディレクトリで `claude agents` を開きます。

297* 親ディレクトリで `claude agents` を開き、プロンプトで `@<repo>` を使用して子リポジトリを言及してセッションをそこで実行します。`@` を入力すると、起動ディレクトリの 1 レベル下の git リポジトリ、およびリスト内に既にセッションがあるディレクトリがリストされます。名前にスペースが含まれるディレクトリはリストされません。318* 親ディレクトリで `claude agents` を開き、プロンプトで `@<repo>` を使用して子リポジトリを言及します。`@` を入力すると、起動ディレクトリの 1 レベル下の git リポジトリ、およびリスト内に既にセッションがあるディレクトリがリストされます。名前にスペースが含まれるディレクトリはリストされません。

298* シェルから、ディレクトリに `cd` して `claude --bg "<prompt>"` を実行します。319* シェルから、ディレクトリに `cd` して `claude --bg "<prompt>"` を実行します。

299 320

300エージェントビューがディレクトリでグループ化されている場合、ハイライトされた行のディレクトリがディスパッチターゲットになるため、グループにスクロールしてパスを再入力せずにそこにディスパッチできます。321エージェントビューがディレクトリでグループ化されている場合、ハイライトされた行のディレクトリがディスパッチターゲットになるため、グループにスクロールしてパスを再入力せずにそこにディスパッチできます。

305 326

306`/background` またはそのエイリアス `/bg` を実行して現在の会話をバックグラウンドセッションに移動します。`/bg run the test suite and fix any failures` などのプロンプトを渡して、バックグラウンド化する前に 1 つの追加命令を送信します。Claude が応答中に `/bg` を実行した場合、応答はバックグラウンドセッションで続行されます。327`/background` またはそのエイリアス `/bg` を実行して現在の会話をバックグラウンドセッションに移動します。`/bg run the test suite and fix any failures` などのプロンプトを渡して、バックグラウンド化する前に 1 つの追加命令を送信します。Claude が応答中に `/bg` を実行した場合、応答はバックグラウンドセッションで続行されます。

307 328

308インタラクティブセッションからバックグラウンド化すると、保存された会話から再開する新しいプロセスが開始されます。実行中のバックグラウンドシェルコマンド、backgrounded subagent、動的ワークフロー、および [`/loop`](/ja/scheduled-tasks) で作成したスケジュール済みタスクはバックグラウンドセッションに転送され、そこで実行し続けます。subagent はそれが開始したすべてのものと一緒に移動するため、すべての作業が転送できる場合にのみ転送されます。Windows を含みます。バックグラウンドセッションに転送できない実行中の作業（[monitor](/ja/tools-reference#monitor-tool) など）は停止されます。backgrounded subagent が monitor を所有している場合、それは monitor と一緒に停止されます。そのような作業が実行されている場合、Claude Code は `Background this session?` ダイアログを表示するため、停止する前に確認できます。329バックグラウンド作業が実行中のインタラクティブセッション（subagent、バックグラウンドシェルコマンド、ワークフロー、または [monitor](/ja/tools-reference#monitor-tool) など）を終了すると、直ちに終了する代わりに `Background work is running` ダイアログが表示されます。{/* min-version: 2.1.198 */}v2.1.198 以降、ダイアログは `Exit anyway` および `Stay` と並んで `Move to background and exit` を提供します。これを選択すると、セッションは `/background` と同じ方法でバックグラウンドに移動し、その後シェルに戻るため、転送可能な作業は実行し続け、セッションはエージェントビューに表示されます。このオプションは、エージェントビューが [オフ](#turn-off-agent-view) になっている場合は表示されません。

330

331インタラクティブセッションからバックグラウンド化すると、保存された会話から再開する新しいプロセスが開始され、実行中の作業がそこに移動します。実行中のバックグラウンドシェルコマンド、backgrounded subagent、動的ワークフロー、および [`/loop`](/ja/scheduled-tasks) で作成したスケジュール済みタスクはバックグラウンドセッションに転送され、そこで実行し続けます。subagent はそれが開始したすべてのものと一緒に移動するため、すべての作業が転送できる場合にのみ転送されます。Windows を含みます。バックグラウンド化の代わりに実行中の作業を停止するには、[`CLAUDE_DISABLE_ADOPT=1`](/ja/env-vars#variables) 環境変数を設定します。Claude Code はバックグラウンド化する前に確認を求めます。

332

333転送できない作業（実行中の [monitor](/ja/tools-reference#monitor-tool) など）は停止されます。monitor を所有している backgrounded subagent は monitor と一緒に停止されます。そのような作業が実行されている場合、Claude Code は `Background this session?` ダイアログを表示するため、停止する前に確認できます。

309 334

310バックグラウンドに入ると、セッションは新しい subagent、monitor、およびバックグラウンドコマンドを開始でき、それらは後のデタッチとリアタッチ全体で実行し続けます。335バックグラウンドに入ると、セッションは新しい subagent、monitor、およびバックグラウンドコマンドを開始でき、それらは後のデタッチとリアタッチ全体で実行し続けます。

311 336

332claude --bg "investigate the flaky SettingsChangeDetector test"357claude --bg "investigate the flaky SettingsChangeDetector test"

333```358```

334 359

360プロンプトは `-p` 値ではなく、位置引数です。{/* min-version: 2.1.198 */}v2.1.198 以降、`--bg` を `-p` または `--print` と組み合わせることは、セッションが作成される前にエラーで拒否されます。`--print` は `claude agents` がアタッチするインタラクティブセッションを開始しないためです。

361

335特定の subagent をセッションのメインエージェントとして実行するには、`--bg` を `--agent` と組み合わせます：362特定の subagent をセッションのメインエージェントとして実行するには、`--bg` を `--agent` と組み合わせます：

336 363

337```bash theme={null}364```bash theme={null}

344claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"371claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"

345```372```

346 373

347バックグラウンド化の後、Claude はセッションの短い ID とセッションを管理するためのコマンドを出力します。`--name` を渡すと、短い ID の後に名前が表示されます：374バックグラウンド化の後、Claude はセッションの短い ID とセッションを管理するためのコマンドを出力します。バックグラウンドセッションをホストするサービスがまだ実行されていない場合、`--bg` はこの出力の上に `Starting background service…` を最初に出力する可能性があります。`--name` を渡すと、短い ID の後に名前が表示されます：

348 375

349```text theme={null}376```text theme={null}

350backgrounded · 7c5dcf5d · flaky-test-fix377backgrounded · 7c5dcf5d · flaky-test-fix

404 431

405バックグラウンドセッションが生成する [subagent](/ja/sub-agents) は、セッションの作業ディレクトリを継承するため、そのファイル編集はセッションのワークツリーではなく作業コピーに配置されます。subagent に独自の個別ワークツリーを代わりに提供するには、frontmatter で [`isolation: worktree`](/ja/sub-agents#supported-frontmatter-fields) を設定するか、生成時に `isolation: "worktree"` を渡します。432バックグラウンドセッションが生成する [subagent](/ja/sub-agents) は、セッションの作業ディレクトリを継承するため、そのファイル編集はセッションのワークツリーではなく作業コピーに配置されます。subagent に独自の個別ワークツリーを代わりに提供するには、frontmatter で [`isolation: worktree`](/ja/sub-agents#supported-frontmatter-fields) を設定するか、生成時に `isolation: "worktree"` を渡します。

406 433

434v2.1.198 以降、ワークツリーでコード変更を分離したバックグラウンドセッションは、確認を求めずにコミット、独自のブランチをプッシュ、およびドラフトプルリクエストを開きます。プルリクエストが開くと、[`#N` ラベル](#pull-request-status) がその行に表示されます。`main` または `master` にプッシュすることはなく、強制プッシュまたはマージを行わず、プルリクエストを開かないように指示した場合、またはリポジトリにリモートがない場合はプルリクエストをスキップします。

435

436分離されていないチェックアウトを編集するセッションは、コミットまたはブランチの切り替え前に確認を求めます。これは、分離が `"none"` に設定されている場合、ワークツリーの移動が失敗した場合、またはセッションが既に存在していたワークツリー内で開始された場合に適用されます。

437

407<h3 id="set-the-model">438<h3 id="set-the-model">

408 モデルを設定する439 モデルを設定する

409</h3>440</h3>

410 441

411エージェントビューヘッダーに表示されるモデル名はディスパッチのデフォルトです。入力から開始する新しいセッションはこのモデルを使用します。これは [`model` setting](/ja/settings#available-settings) からユーザー設定で取得されます。[`/model` picker](/ja/model-config) でモデルを選択して設定するか、設定を直接編集します。エージェントビューセッション全体でオーバーライドするには、エージェントビューを開く際に `--model` を渡します。[権限モード、モデル、および努力](#permission-mode-model-and-effort) を参照してください。442エージェントビューヘッダーに表示されるモデル名はディスパッチのデフォルトです。入力から開始する新しいセッションはこのモデルを使用します。これは [`model` setting](/ja/settings#available-settings) からユーザー設定で取得されます。[`/model` picker](/ja/model-config) でモデルを選択して設定するか、設定を直接編集します。

412 443

413エージェントビューの入力でディスパッチモデルを変更するには、ディスパッチ入力に `/model` の後にモデル名を入力して `Enter` を押します。ヘッダーは `(session)` マーカー付きでそのモデルを表示するように更新され、その後ディスパッチするセッションはそれを使用します。`/model default` と入力してオーバーライドをクリアし、ディスパッチのデフォルトに戻します。このオーバーライドは現在の `claude agents` 実行の残りの間続き、設定ファイルに書き込まれません。次の例は、1 つのセッションを Opus でディスパッチし、次のセッションを Sonnet でディスパッチします：444エージェントビューセッション全体でディスパッチのデフォルトをオーバーライドするには、エージェントビューを開く際に `--model` を渡します。[権限モード、モデル、および努力](#permission-mode-model-and-effort) を参照してください。

445

446エージェントビューの内部からディスパッチのデフォルトを変更するには、ディスパッチ入力に `/model` の後にモデル名を入力して `Enter` を押します。ヘッダーは `(session)` マーカー付きでそのモデルを表示するように更新され、その後ディスパッチするセッションはそれを使用します。`/model default` と入力してオーバーライドをクリアし、ディスパッチのデフォルトに戻します。このオーバーライドは現在の `claude agents` 実行の残りの間続き、設定ファイルに書き込まれません。次の例は、1 つのセッションを Opus でディスパッチし、次のセッションを Sonnet でディスパッチします：

414 447

415```text theme={null}448```text theme={null}

416/model opus449/model opus

517 550

518セッションが完了し、約 1 時間アタッチされていない状態で待機すると、スーパーバイザーはリソースを解放するためにプロセスを停止します。`Ctrl+T` で[ピン留めした](#organize-the-list)セッションは除外され、アイドル状態でもプロセスを実行し続けます。トランスクリプトと状態はディスク上に残り、次回アタッチ、ピーク表示、または返信するときに、スーパーバイザーは中断したところから新しいプロセスを開始します。すべてのセッションが完了し、ターミナルが接続されていない場合、スーパーバイザー自体が終了し、次回セッションをバックグラウンド化するか、エージェントビューを開くときに再度開始します。551セッションが完了し、約 1 時間アタッチされていない状態で待機すると、スーパーバイザーはリソースを解放するためにプロセスを停止します。`Ctrl+T` で[ピン留めした](#organize-the-list)セッションは除外され、アイドル状態でもプロセスを実行し続けます。トランスクリプトと状態はディスク上に残り、次回アタッチ、ピーク表示、または返信するときに、スーパーバイザーは中断したところから新しいプロセスを開始します。すべてのセッションが完了し、ターミナルが接続されていない場合、スーパーバイザー自体が終了し、次回セッションをバックグラウンド化するか、エージェントビューを開くときに再度開始します。

519 552

520バックグラウンドシェルコマンドと動的ワークフローはセッションのプロセスが停止、再開、または更新されても実行し続けます。Windows を含みます。そのセッション用に開始された次のプロセスはそれらを取得し、その間に完了したシェルコマンドは完了として報告され、その出力が表示され、ワークフローは中断したところから再開されます。subagent によって開始されたシェルコマンドと実行中の [monitors](/ja/tools-reference#monitor-tool) はまだプロセスで停止し、セッションを削除するとそれが引き継いだすべてのものが停止されます。バックグラウンドシェルコマンドとワークフローをプロセスで停止するには、[`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/ja/env-vars#variables) 環境変数を `1` に設定します。553セッション自体がトップレベルで開始したバックグラウンド作業は、そのプロセスが停止、再開、または更新されるときに引き継がれます。Windows を含みます。そのセッション用に開始された次のプロセスはそれらを取得します。

554

555* その間に完了したバックグラウンドシェルコマンドは、その出力とともに完了として報告されます

556* 動的ワークフローは中断したところから再開されます

557* [バックグラウンド subagent](/ja/sub-agents#run-subagents-in-foreground-or-background)は独自のトランスクリプトから再開されます

558

559{/* min-version: 2.1.198 */}v2.1.198 以降、引き継ぎは 3 つすべてをカバーしています。v2.1.198 より前は、シェルコマンドとワークフローのみをカバーしていたため、バックグラウンド subagent はプロセスで停止し、次回の起動時に失敗として報告されました。

560

561プロセス内部にのみ状態が存在する作業は、引き継がれるのではなく、プロセスで停止します。これは subagent が開始したシェルコマンドであり、再開された subagent は再度開始でき、実行中の[モニター](/ja/tools-reference#monitor-tool)はイベントストリームを別のプロセスに移動できません。

562

563セッションを削除すると、それが引き継いだすべてのものが停止されます。セッションのすべてのバックグラウンド作業を引き継ぎの代わりにプロセスで停止するには、[`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/ja/env-vars#variables)環境変数を `1` に設定します。

521 564

522再開されたセッションが、Claude Code がトランスクリプトを空として誤読したため、元のプロンプトのみを表示して戻ってきた場合、会話トランスクリプトは削除される代わりに `.orphaned-` サフィックスで名前が変更されるため、マシンに残ります。565再開されたセッションが、Claude Code がトランスクリプトを空として誤読したため、元のプロンプトのみを表示して戻ってきた場合、会話トランスクリプトは削除される代わりに `.orphaned-` サフィックスで名前が変更されるため、マシンに残ります。

523 566

546 589

547このコマンドは、実行中のスーパーバイザーが呼び出した `claude` とは異なるバージョンにある場合に警告を表示します。これはスーパーバイザーがまだ再開していない更新後に発生します。警告は両方のバージョンを表示し、`claude daemon stop --any` を実行して新しいバージョンを取得するよう指示します。Claude Code が OS サービスとしてインストールされている場合、推奨されるコマンドはフラグなしの `claude daemon stop` です。590このコマンドは、実行中のスーパーバイザーが呼び出した `claude` とは異なるバージョンにある場合に警告を表示します。これはスーパーバイザーがまだ再開していない更新後に発生します。警告は両方のバージョンを表示し、`claude daemon stop --any` を実行して新しいバージョンを取得するよう指示します。Claude Code が OS サービスとしてインストールされている場合、推奨されるコマンドはフラグなしの `claude daemon stop` です。

548 591

592セッションはそのバージョンの不一致を無傷で生き残ります。セッションの `state.json` を更新する古い Claude Code バージョンは、認識しないフィールドを保持し、セッションをリストに保持します。

593

549Windows では、`claude daemon status` はデーモンのパイプキーファイルがロックされているか読み取り不可の場合、一般的な接続失敗を報告する代わりに、基になるファイルエラーを表示します。594Windows では、`claude daemon status` はデーモンのパイプキーファイルがロックされているか読み取り不可の場合、一般的な接続失敗を報告する代わりに、基になるファイルエラーを表示します。

550 595

551<h3 id="turn-off-agent-view">596<h3 id="turn-off-agent-view">

592 637

593スリープだけではこれは発生しません。セッションはスリープ全体で保持され、スーパーバイザーはウェイク時にそれらに再接続します。638スリープだけではこれは発生しません。セッションはスリープ全体で保持され、スーパーバイザーはウェイク時にそれらに再接続します。

594 639

640<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">

641 セッションが開始前に `possibly low memory` ノートで失敗する

642</h3>

643

644v2.1.199 以降、バックグラウンドセッションのプロセスが開始を完了する前に終了し、ホストのメモリが不足している場合、行のステータスは終了を名前で表示し、`possibly low memory — free some up and retry` を追加します。以前のバージョンでは、この失敗に対して終了理由のみを表示していました。

645

646ノートは仮説であり、確認された原因ではありません。Claude Code はプロセスがエラーを書き込まずに静かに終了し、シグナルによって停止されず、ホストがその時点で低メモリを報告した場合にのみ追加します。プロセスが終了前にエラーを書き込んだ場合、行はそのエラーを代わりに表示します。

647

648マシンのメモリを解放してから、行にアタッチ、ピーク表示、または返信して、スーパーバイザーがセッションの新しいプロセスを開始します。メモリが低いままの場合、スーパーバイザーは[アイドルセッションを停止](#the-supervisor-process)して、独自にリソースを解放します。

649

595<h3 id="agent-view-says-the-background-service-did-not-respond">650<h3 id="agent-view-says-the-background-service-did-not-respond">

596 エージェントビューがバックグラウンドサービスが応答しなかったと表示される651 エージェントビューがバックグラウンドサービスが応答しなかったと表示される

597</h3>652</h3>

622 677

623原因と修正の完全なリストについては、[エラーリファレンス](/ja/errors#could-not-resolve-authentication-method)を参照してください。678原因と修正の完全なリストについては、[エラーリファレンス](/ja/errors#could-not-resolve-authentication-method)を参照してください。

624 679

625<h3 id="background-sessions-cannot-read-desktop-documents-or-downloads-on-macos">680<h3 id="background-sessions-can’t-read-desktop-documents-or-downloads-on-macos">

626 macOS でバックグラウンドセッションが Desktop、Documents、または Downloads を読み取ることができない681 macOS でバックグラウンドセッションが Desktop、Documents、または Downloads を読み取ることができない

627</h3>682</h3>

628 683

630 685

631ネイティブインストーラーを使用すると、エントリは Claude Code として表示され、許可は更新全体で保持されます。Homebrew または npm などの他のインストール方法を使用すると、エントリはバイナリパスを表示し、更新後に再度許可が必要になる場合があります。686ネイティブインストーラーを使用すると、エントリは Claude Code として表示され、許可は更新全体で保持されます。Homebrew または npm などの他のインストール方法を使用すると、エントリはバイナリパスを表示し、更新後に再度許可が必要になる場合があります。

632 687

688<h3 id="background-sessions-can’t-reach-local-network-hosts-on-macos">

689 macOS でバックグラウンドセッションがローカルネットワークホストに到達できない

690</h3>

691

692macOS 15 以降では、ローカルネットワークアクセス権限を付与するまで、システムはプロセスがローカルネットワーク上のデバイスに到達することをブロックします。v2.1.198 より前は、バックグラウンドセッションホストはその権限をリクエストしなかったため、LAN アドレスをターゲットとするコマンドは、同じコマンドがフォアグラウンドターミナルで機能していても `connect: no route to host` で失敗しました。v2.1.198 以降、バックグラウンドセッションでローカルネットワークアドレスに接続する最初のコマンドは、Claude Code の macOS ローカルネットワークアクセス権限プロンプトをトリガーします。一度許可すると、これらのコマンドはフォアグラウンドターミナルと同じ方法で LAN ホストに到達します。

693

633<h3 id="a-session-is-slow-to-respond-after-attaching">694<h3 id="a-session-is-slow-to-respond-after-attaching">

634 セッションがアタッチ後に応答が遅い695 セッションがアタッチ後に応答が遅い

635</h3>696</h3>

669Agent view はリサーチプレビュー中に急速に進化しました。古い Claude Code バージョンを使用している場合、このページの一部の動作が異なる可能性があります。特に、`claude agents` はまだサポートしていないフラグを `unknown option` エラーで拒否します。下の表は各フラグと動作がいつ追加されたかをリストしています。730Agent view はリサーチプレビュー中に急速に進化しました。古い Claude Code バージョンを使用している場合、このページの一部の動作が異なる可能性があります。特に、`claude agents` はまだサポートしていないフラグを `unknown option` エラーで拒否します。下の表は各フラグと動作がいつ追加されたかをリストしています。

670 731

671| バージョン | 変更 |732| バージョン | 変更 |

672| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |733| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

734| v2.1.199 | {/* min-version: 2.1.199 */}プロセスが低メモリホストで起動を完了する前に終了するバックグラウンドセッションは、単に終了理由だけではなく、その行ステータスに `possibly low memory — free some up and retry` を表示します。`←` または `/background` でセッションをバックグラウンド化すると、その `/color` が新しい行に引き継がれます。 |

735| v2.1.198 | {/* min-version: 2.1.198 */}Agent view はバックグラウンドセッションが入力を必要とする場合、完了する場合、または失敗する場合に `preferredNotifChannel` を通じて通知を送信し、`agent_needs_input` または `agent_completed` タイプで `Notification` フックを発火します。`claude attach <id>` 内の `←` と `/exit` はシェルに終了するのではなく agent view に戻ります。`Ctrl+Z` はシェルに戻ります。バックグラウンドセッションは作業を worktree に分離し、コミットして独自の分離ブランチをプッシュし、`main` または `master` をプッシュしません。完了時に最初に確認するのではなく、ドラフトプルリクエストを開きます。`/login` は agent view で実行され、サインインダイアログを開きます。`Background work is running` 終了ダイアログは `Move to background and exit` を提供します。終了ハンドオフはバックグラウンドサブエージェントもカバーし、失敗として報告される代わりに次の起動時にトランスクリプトから再開します。`claude --bg` を `-p` または `--print` と組み合わせるとエラーで拒否されます。 |

673| v2.1.196 | {/* min-version: 2.1.196 */}単一の `←` 押下がフォアグラウンドセッションをバックグラウンド化します。以前のバージョンでは 2 回の押下が必要で、フッターヒントと確認がありました。`claude agents` に渡された `--dangerously-skip-permissions` は、静かにドロップされるのではなく、バイパス免責事項を表示します。対話的なセッションで名前を付けたことがない場合は、セッションリストと `claude agents --json` で `my-app-3f` などのデフォルト名を持ちます。バックグラウンドシェルコマンドと動的ワークフローはセッションのプロセスが停止、再開、または更新されても生き残ります。Windows を含みます。ハンドオフをオフにするには `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` を設定します。再開時に空として誤読されたトランスクリプトは削除される代わりに `.orphaned-` サフィックスで名前が変更されます。 |736| v2.1.196 | {/* min-version: 2.1.196 */}単一の `←` 押下がフォアグラウンドセッションをバックグラウンド化します。以前のバージョンでは 2 回の押下が必要で、フッターヒントと確認がありました。`claude agents` に渡された `--dangerously-skip-permissions` は、静かにドロップされるのではなく、バイパス免責事項を表示します。対話的なセッションで名前を付けたことがない場合は、セッションリストと `claude agents --json` で `my-app-3f` などのデフォルト名を持ちます。バックグラウンドシェルコマンドと動的ワークフローはセッションのプロセスが停止、再開、または更新されても生き残ります。Windows を含みます。ハンドオフをオフにするには `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` を設定します。再開時に空として誤読されたトランスクリプトは削除される代わりに `.orphaned-` サフィックスで名前が変更されます。 |

674| v2.1.195 | {/* min-version: 2.1.195 */}実行中の作業は Windows でセッションをバックグラウンド化するときに転送されます。`CLAUDE_DISABLE_ADOPT=1` を設定して代わりに停止します。`Completed` グループは残りの垂直スペースを埋め、ヘッダーは短いターミナルでコンパクトになります。古い Claude Code バージョンはもはや新しいセッションの `state.json` フィールドをドロップしたり、それらのセッションを `claude agents` から隠したりしません。停止されたセッションにアタッチすると、最大 5 秒間の空白画面を表示する代わりに直ちに切り替わります。接続を受け入けることができないスーパーバイザーは独自に終了してロックを解放します。 |737| v2.1.195 | {/* min-version: 2.1.195 */}実行中の作業は Windows でセッションをバックグラウンド化するときに転送されます。`CLAUDE_DISABLE_ADOPT=1` を設定して代わりに停止します。`Completed` グループは残りの垂直スペースを埋め、ヘッダーは短いターミナルでコンパクトになります。古い Claude Code バージョンはもはや新しいセッションの `state.json` フィールドをドロップしたり、それらのセッションを `claude agents` から隠したりしません。停止されたセッションにアタッチすると、最大 5 秒間の空白画面を表示する代わりに直ちに切り替わります。接続を受け入けることができないスーパーバイザーは独自に終了してロックを解放します。 |

675| v2.1.174 | {/* min-version: 2.1.174 */}バックグラウンドセッションはスーパーバイザーの起動シェルからゲートウェイエンドポイント変数（`ANTHROPIC_BASE_URL` など）を継承しなくなります。スーパーバイザーはプリウォーミングされたワーカーに新しい認証情報スナップショットを提供し、誤った `Could not resolve authentication method` エラーを修正します。 |738| v2.1.174 | {/* min-version: 2.1.174 */}バックグラウンドセッションはスーパーバイザーの起動シェルからゲートウェイエンドポイント変数（`ANTHROPIC_BASE_URL` など）を継承しなくなります。スーパーバイザーはプリウォーミングされたワーカーに新しい認証情報スナップショットを提供し、誤った `Could not resolve authentication method` エラーを修正します。 |

agents.md +1 −1

Details

53実行中の作業を確認するコマンドは、使用したアプローチによって異なります。53実行中の作業を確認するコマンドは、使用したアプローチによって異なります。

54 54

55* バックグラウンドセッションの場合、`claude agents` は [エージェントビュー](/ja/agent-view) を開きます。すべてのセッション、その状態、および入力が必要なセッションを表示する 1 つの画面です。55* バックグラウンドセッションの場合、`claude agents` は [エージェントビュー](/ja/agent-view) を開きます。すべてのセッション、その状態、および入力が必要なセッションを表示する 1 つの画面です。

56* 現在のセッション内のサブエージェントの場合、`/agents` はパネルを開き、ライブサブエージェントをリストする **Running** タブと、[カスタムサブエージェントを作成および編集](/ja/sub-agents#use-the-%2Fagents-command) できる **Library** タブがあります。名前は似ていますが、これは `claude agents` とは別です。56* 現在のセッション内のサブエージェントの場合、名前付きバックグラウンドサブエージェントは @-メンション入力補完に状態とともに表示されます。{/* min-version: 2.1.198 */}v2.1.198 以降、`/agents` はパネルを開かなくなり、サブエージェントファイルの場所を指すお知らせを出力します。[カスタムサブエージェントを作成および編集](/ja/sub-agents#configure-subagents) するには、Claude に質問するか、ファイルを直接編集してください。名前は似ていますが、`/agents` は `claude agents` とは別です。

57* 現在のセッションのバックグラウンドで実行されているもの場合、`/tasks` は各項目をリストし、確認、アタッチ、または停止できます。57* 現在のセッションのバックグラウンドで実行されているもの場合、`/tasks` は各項目をリストし、確認、アタッチ、または停止できます。

58* 動的ワークフローの場合、`/workflows` は実行中および完了した実行、各実行がある段階、および完了したエージェント数をリストします。58* 動的ワークフローの場合、`/workflows` は実行中および完了した実行、各実行がある段階、および完了したエージェント数をリストします。

59 59

amazon-bedrock.md +1 −1

Details

184 184

185これら 2 つの設定には異なるトリガー条件があります。185これら 2 つの設定には異なるトリガー条件があります。

186 186

187* **`awsAuthRefresh`**：Claude Code がローカルのタイムスタンプに基づくか、Bedrock が認証情報エラーを返した場合に AWS 認証情報の有効期限が切れていることを検出した場合にのみ実行され、更新された認証情報でリクエストを再試行します。187* **`awsAuthRefresh`**：Claude Code がローカルのタイムスタンプに基づくか、API が認証情報エラーを返した場合に AWS 認証情報の有効期限が切れていることを検出した場合にのみ実行され、更新された認証情報でリクエストを再試行します。

188* **`awsCredentialExport`**：セッション開始時および各認証情報リロード時に実行されます。AWS デフォルト認証情報プロバイダーチェーン内の認証情報がまだ有効な場合でも実行されます。Bedrock アカウントがデフォルトプロバイダーチェーンが解決するものと異なるクロスアカウント認証情報を必要とする場合に使用します。188* **`awsCredentialExport`**：セッション開始時および各認証情報リロード時に実行されます。AWS デフォルト認証情報プロバイダーチェーン内の認証情報がまだ有効な場合でも実行されます。Bedrock アカウントがデフォルトプロバイダーチェーンが解決するものと異なるクロスアカウント認証情報を必要とする場合に使用します。

189 189

190<h5 id="example-configuration">190<h5 id="example-configuration">

auto-mode-config.md +18 −7

Details

54 54

55ほとんどの組織では、`autoMode.environment` が設定する必要がある唯一のフィールドです。これは、分類器に、どのリポジトリ、バケット、ドメインが信頼できるかを指定します。分類器はこれを使用して「外部」が何を意味するかを決定するため、リストに記載されていない宛先は潜在的な流出ターゲットです。55ほとんどの組織では、`autoMode.environment` が設定する必要がある唯一のフィールドです。これは、分類器に、どのリポジトリ、バケット、ドメインが信頼できるかを指定します。分類器はこれを使用して「外部」が何を意味するかを決定するため、リストに記載されていない宛先は潜在的な流出ターゲットです。

56 56

~~57Claude Code v2.1.195 以降、`claude auto-mode defaults` は 2 種類の環境エントリを出力します。~~57Claude Code v2.1.198 以降、`claude auto-mode defaults` は 3 種類の環境エントリを出力します。v2.1.195 より前のバージョンは、最初の 5 つの信頼スロットのみを出力します。

58 58

59* **コンテキストスロット**：分類器が他のルールをコンテキストで読み込むように、組織、スタック、セキュリティ体制を説明します。他の 2 種類と異なり、コンテキストスロットはそれらをターゲットにする独自のルールはありません。各スロットはデフォルトで `None configured` または次に記載されている保守的な仮定になります。

60 * **Organization**

61 * **Primary use of Claude Code**：デフォルトはソフトウェア開発

62 * **Cloud provider(s)**

63 * **Repository visibility**：リポジトリはリモートホストと名前が別途示さない限り、プライベートと見なされます

64 * **Internal sharing / snippet hosting**：パブリックペーストおよび gist サービスは、指定するまで信頼境界の外側として扱われます

65 * **Org-specific CLIs**

66 * **Secrets management**

67 * **Default / protected branches**：`main` と `master` は、他を指定するまで保護されたものとして扱われます

68 * **CI/CD deploy targets**

69 * **Network posture**

70 * **Protected deployment namespaces / environments**：指定するまで、機密リモートターゲットヒューリスティックにフォールバックします

71 * **Data retention / declassification**

59* **信頼スロット**：分類器が境界内として扱うものを指定します。スロットは「信頼できるリポジトリ」、「ソース管理」、「信頼できる内部ドメイン」、「信頼できるクラウドバケット」、「主要な内部サービス」、および「内部パッケージレジストリ」です。リポジトリとソース管理エントリはデフォルトで作業リポジトリとその設定されたリモートになります。他のすべての信頼スロットはデフォルトで `None configured` になるため、追加するまで他には何も信頼されません。72* **信頼スロット**：分類器が境界内として扱うものを指定します。スロットは「信頼できるリポジトリ」、「ソース管理」、「信頼できる内部ドメイン」、「信頼できるクラウドバケット」、「主要な内部サービス」、および「内部パッケージレジストリ」です。リポジトリとソース管理エントリはデフォルトで作業リポジトリとその設定されたリモートになります。他のすべての信頼スロットはデフォルトで `None configured` になるため、追加するまで他には何も信頼されません。

60* **感度スロット**：保護ルールが高リスクとして扱うものを指定します。スロットは「PII / 規制対象データの場所」、「機密リモートターゲット」、および「保護された IaC スコープ」です。各スロットはデフォルトで広いヒューリスティックになります。例えば、名前に `prod` または `production` を含むホストまたはネームスペースを機密リモートターゲットとして扱うため、保護ルールは何も設定する前にアクティブになります。感度スロットで具体的なターゲットを指定すると、これらのルールはヒューリスティックではなく指定されたターゲットに適用されます。73* **感度スロット**：保護ルールが高リスクとして扱うものを指定します。スロットは「機密データの場所とオーディエンス」、「機密リモートターゲット」、および「保護された IaC スコープ」です。各スロットはデフォルトで広いヒューリスティックになります。例えば、名前に `prod` または `production` を含むホストまたはネームスペースを機密リモートターゲットとして扱うため、保護ルールは何も設定する前にアクティブになります。感度スロットで具体的なターゲットを指定すると、これらのルールはヒューリスティックではなく指定されたターゲットに適用されます。

~~62v2.1.195 より前のバージョンは、最初の 5 つの信頼スロットのみを出力します。~~

63 74

64デフォルトと一緒に独自のエントリを追加するには、配列にリテラル文字列 `"$defaults"` を含めます。デフォルトエントリはその位置に挿入されるため、カスタムエントリはそれらの前後に配置できます。75デフォルトと一緒に独自のエントリを追加するには、配列にリテラル文字列 `"$defaults"` を含めます。デフォルトエントリはその位置に挿入されるため、カスタムエントリはそれらの前後に配置できます。

65 76

87* **信頼できる内部ドメイン**：ネットワーク内の API、ダッシュボード、サービスのホスト名（`*.internal.example.com` など）98* **信頼できる内部ドメイン**：ネットワーク内の API、ダッシュボード、サービスのホスト名（`*.internal.example.com` など）

88* **主要な内部サービス**：CI、アーティファクトレジストリ、内部パッケージインデックス、インシデント対応ツール99* **主要な内部サービス**：CI、アーティファクトレジストリ、内部パッケージインデックス、インシデント対応ツール

89* **内部パッケージレジストリ**：インストールがルーティングされるべき private npm、PyPI、またはその他のレジストリ。パブリックレジストリをバイパスするインストールはブロックされます100* **内部パッケージレジストリ**：インストールがルーティングされるべき private npm、PyPI、またはその他のレジストリ。パブリックレジストリをバイパスするインストールはブロックされます

90* **PII / 規制対象データの場所**：個人データまたは規制対象データを保持するバケット、データベース、またはパス。分類器がコンテンツから推測する代わりにこれらの場所を保護します101* **Sensitive data locations & audiences**：個人データ、機密ビジネスデータ、認証情報、規制対象データ、または同様に機密性の高い情報を保持するバケット、データベース、またはパス。各場所のデータが共有される可能性があるオーディエンス。分類器がコンテンツから推測する代わりにこれらの場所を保護します。{/* min-version: 2.1.195 */}{/* max-version: 2.1.197 */}Claude Code v2.1.195 から v2.1.197 はこのエントリを PII / 規制対象データの場所として指定し、オーディエンスディメンションなしで個人データまたは規制対象データを保持する場所のみをカバーします

91* **機密リモートターゲット**：本番環境としてカウントされるネームスペース、ホスト、またはコンテナ。リモートシェルとポートフォワードはこれらへの明示的な承認が必要です102* **機密リモートターゲット**：本番環境としてカウントされるネームスペース、ホスト、またはコンテナ。リモートシェルとポートフォワードはこれらへの明示的な承認が必要です

92* **保護された IaC スコープ**：apply または destroy が常にあなたが変更を指定する必要があるインフラストラクチャリソース103* **保護された IaC スコープ**：apply または destroy が常にあなたが変更を指定する必要があるインフラストラクチャリソース

93* **追加コンテキスト**：規制業界の制約、マルチテナントインフラストラクチャ、または分類器がリスクとして扱うべき内容に影響するコンプライアンス要件104* **追加コンテキスト**：規制業界の制約、マルチテナントインフラストラクチャ、または分類器がリスクとして扱うべき内容に影響するコンプライアンス要件

94 105

95内部パッケージレジストリ、PII / 規制対象データの場所、機密リモートターゲット、および保護された IaC スコープエントリには Claude Code v2.1.195 以降が必要です。以前のバージョンはそれらをプレーンコンテキストとして読み込みますが、それらをターゲットにする組み込みルールはありません。106内部パッケージレジストリ、機密データの場所とオーディエンス、機密リモートターゲット、および保護された IaC スコープエントリには Claude Code v2.1.195 以降が必要です。以前のバージョンはそれらをプレーンコンテキストとして読み込みますが、それらをターゲットにする組み込みルールはありません。

96 107

97有用な開始テンプレート。括弧内のフィールドを入力し、適用されない行を削除します。108有用な開始テンプレート。括弧内のフィールドを入力し、適用されない行を削除します。

98 109

chrome.md +15 −2

Details

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4

~~5# Chrome で Claude Code を使用する（ベータ版）~~5# Chrome で Claude Code を使用する

6 6

7> Claude Code を Chrome ブラウザに接続して、Web アプリをテストし、コンソールログでデバッグし、フォーム入力を自動化し、Web ページからデータを抽出します。7> Claude Code を Chrome ブラウザに接続して、Web アプリをテストし、コンソールログでデバッグし、フォーム入力を自動化し、Web ページからデータを抽出します。

8 8

11Claude はブラウザタスク用に新しいタブを開き、ブラウザのログイン状態を共有するため、既にサインインしているサイトにアクセスできます。ブラウザアクションはリアルタイムで表示される Chrome ウィンドウで実行されます。Claude がログインページまたは CAPTCHA に遭遇した場合、一時停止して手動で処理するよう求めます。11Claude はブラウザタスク用に新しいタブを開き、ブラウザのログイン状態を共有するため、既にサインインしているサイトにアクセスできます。ブラウザアクションはリアルタイムで表示される Chrome ウィンドウで実行されます。Claude がログインページまたは CAPTCHA に遭遇した場合、一時停止して手動で処理するよう求めます。

12 12

13<Note>13<Note>

14 Chrome 統合はベータ版であり、現在 Google Chrome と Microsoft Edge で動作します。Brave、Arc、またはその他の Chromium ベースのブラウザではまだサポートされていません。WSL（Windows Subsystem for Linux）もサポートされていません。14 Chrome 統合は Google Chrome と Microsoft Edge で動作します。Brave、Arc、またはその他の Chromium ベースのブラウザではまだサポートされていません。Windows Subsystem for Linux（WSL）でもサポートされていません。

15</Note>15</Note>

16 16

17<h2 id="capabilities">17<h2 id="capabilities">

90 90

91サイトレベルの権限は Chrome 拡張機能から継承されます。Chrome 拡張機能の設定で権限を管理して、Claude がブラウズ、クリック、入力できるサイトを制御します。91サイトレベルの権限は Chrome 拡張機能から継承されます。Chrome 拡張機能の設定で権限を管理して、Claude がブラウズ、クリック、入力できるサイトを制御します。

92 92

93<h3 id="browser-tools-in-plan-mode">

94 ブラウザツールをプランモードで使用する

95</h3>

97[プランモード](/ja/permission-modes#analyze-before-you-edit-with-plan-mode) では、ページまたはブラウザの状態のみを読み取るブラウザツール呼び出しは権限プロンプトなしで実行され、状態を変更する呼び出しは承認を求めるプロンプトが表示されます。

99* **読み取り専用呼び出し**: `read_page`、`get_page_text`、`find`、コンソールメッセージまたはネットワークリクエストの読み取り、およびスクリーンショットの撮影

100* **状態変更呼び出し**: クリック、入力、ナビゲーション、タブとウィンドウ管理、および GIF の記録

101

102v2.1.199 以降、`tabs_context_mcp` の `createIfEmpty`、コンソールおよびネットワークリーダーの `clear`、またはスクリーンショットの `save_to_disk` など、状態変更入力フラグを設定する読み取り専用呼び出しも承認を求めるプロンプトが表示されます。`browser_batch` 呼び出しは、その内部のすべてのアクションが読み取り専用の場合にのみ、プロンプトなしで実行されます。

103

93<h2 id="example-workflows">104<h2 id="example-workflows">

94 ワークフロー例105 ワークフロー例

95</h2>106</h2>

208 219

209Chrome 統合を初めて有効にすると、Claude Code はネイティブメッセージングホスト設定ファイルをインストールします。Chrome はスタートアップ時にこのファイルを読み取るため、最初の試行で拡張機能が検出されない場合、Chrome を再起動して新しい設定を取得します。220Chrome 統合を初めて有効にすると、Claude Code はネイティブメッセージングホスト設定ファイルをインストールします。Chrome はスタートアップ時にこのファイルを読み取るため、最初の試行で拡張機能が検出されない場合、Chrome を再起動して新しい設定を取得します。

210 221

222v2.1.199 以降、Claude Code は初回インストール時のみ拡張機能の接続を促すブラウザタブを開きます。設定ファイルを書き直す後続セッション（例えば Claude Code ビルドまたは設定ディレクトリを切り替えた後）では、再度開きません。

223

211接続がまだ失敗する場合、ホスト設定ファイルが以下の場所に存在することを確認します。224接続がまだ失敗する場合、ホスト設定ファイルが以下の場所に存在することを確認します。

212 225

213Chrome の場合：226Chrome の場合：

claude-apps-gateway-config.md +59 −7

Details

4 4

5# Claude apps gateway 設定5# Claude apps gateway 設定

6 6

7> gateway.yaml のすべてのオプションのリファレンス：リスナーと TLS、OIDC、セッション、Postgres ストア、Bedrock/Agent Platform/Foundry アップストリーム、モデルルーティング、マネージドポリシー、テレメトリー。7> gateway.yaml のすべてのオプションのリファレンス：リスナーと TLS、OIDC、セッション、Postgres ストア、Bedrock/Claude Platform on AWS/Agent Platform/Foundry アップストリーム、モデルルーティング、マネージドポリシー、テレメトリー。

8 8

9Claude apps gateway デプロイメントは、慣例的に `gateway.yaml` という 1 つの YAML ファイルで設定されます。このファイルは、ゲートウェイが行うすべてのことを定義します：どこでリッスンするか、開発者がどのようにサインインするか、推論がどこに行くか、どのポリシーとテレメトリーが適用されるかです。このページは、そのファイル内のすべてのオプションのリファレンスです。最初のファイルを作成するには、[クイックスタート](/ja/claude-apps-gateway#quickstart)から始めてください。これは最小限の動作設定を構築して実行します。設定に満足したら、[デプロイメントガイド](/ja/claude-apps-gateway-deploy)で、Kubernetes、Cloud Run、または独自のプラットフォームでのコンテナ化とホスティングについて説明しています。9Claude apps gateway デプロイメントは、慣例的に `gateway.yaml` という 1 つの YAML ファイルで設定されます。このファイルは、ゲートウェイが行うすべてのことを定義します：どこでリッスンするか、開発者がどのようにサインインするか、推論がどこに行くか、どのポリシーとテレメトリーが適用されるかです。このページは、そのファイル内のすべてのオプションのリファレンスです。最初のファイルを作成するには、[クイックスタート](/ja/claude-apps-gateway#quickstart)から始めてください。これは最小限の動作設定を構築して実行します。設定に満足したら、[デプロイメントガイド](/ja/claude-apps-gateway-deploy)で、Kubernetes、Cloud Run、または独自のプラットフォームでのコンテナ化とホスティングについて説明しています。

10 10

24* [`oidc`](#oidc)：ID プロバイダー（IdP）、発行者、クライアント、クレームマッピング、サインイン可能なユーザーを含む24* [`oidc`](#oidc)：ID プロバイダー（IdP）、発行者、クライアント、クレームマッピング、サインイン可能なユーザーを含む

25* [`session`](#session)：ゲートウェイが発行するベアラートークン、シークレット、有効期間25* [`session`](#session)：ゲートウェイが発行するベアラートークン、シークレット、有効期間

26* [`store`](#store)：デバイスグラント、レート制限カウンターの PostgreSQL26* [`store`](#store)：デバイスグラント、レート制限カウンターの PostgreSQL

~~27* [`upstreams`](#upstreams)：推論がどこに行くか、Anthropic、Bedrock、Agent Platform、または Foundry かどうか~~27* [`upstreams`](#upstreams)：推論がどこに行くか、Anthropic、Bedrock、Claude Platform on AWS、Agent Platform、または Foundry かどうか

28 28

29**オプションセクション：**29**オプションセクション：**

30 30

68 `oidc`68 `oidc`

69</h3>69</h3>

70 70

71OpenID Connect（OIDC）は、ゲートウェイが ID プロバイダーで使用する SSO プロトコルです。IdP 側で登録する内容については、[ID プロバイダー設定](/ja/claude-apps-gateway-deploy#identity-provider-setup)を参照してください。`oidc` ブロックはゲートウェイを ID プロバイダーに接続し、サインイン可能なユーザーを決定します。発行者と OAuth クライアントに名前を付け、メールとグループを含むクレームをマップし、メールドメインまたはグループによるサインインを制限します。71`oidc` ブロックはゲートウェイを ID プロバイダーに接続し、サインイン可能なユーザーを決定します。発行者と OAuth クライアントに名前を付け、メールとグループを含むクレームをマップし、メールドメインまたはグループによるサインインを制限します。

73OpenID Connect（OIDC）は、ゲートウェイが ID プロバイダーで使用する SSO プロトコルです。IdP 側で登録する内容については、[ID プロバイダー設定](/ja/claude-apps-gateway-deploy#identity-provider-setup)を参照してください。

72 74

73| フィールド | 必須 | 説明 |75| フィールド | 必須 | 説明 |

74| ------------------------------- | --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |76| ------------------------------- | --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

121 `upstreams`123 `upstreams`

122</h3>124</h3>

123 125

124`upstreams` は順序付きリストです。ゲートウェイは、要求されたモデルを解決する最初のアップストリームに推論を転送します。`5xx`、`429`、またはタイムアウト時に次にフェイルオーバーします。他の `4xx` はしません。これらのエラーはリクエストではなくアップストリームに起因するためです。同じプロバイダーの複数のアップストリームは、異なる `name:` を設定する必要があります。126`upstreams` は順序付きリストです。ゲートウェイは、要求されたモデルを解決する最初のアップストリームに推論を転送します。`5xx`、`429`、`401`、`403`、`404`、またはタイムアウト時に次にフェイルオーバーします。他の `4xx` はしません。これらのエラーはリクエストではなくアップストリームに起因するためです。`401` または `403` はゲートウェイ自身の認証情報がそのアップストリームに対して失敗したことを意味し、`404` はそのアップストリームが要求されたモデルを提供していないことを意味するため、リスト内の後のアップストリームはまだ提供できます。

127

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

129

130同じプロバイダーの複数のアップストリームは、異なる `name:` を設定する必要があります。

125 131

126Bedrock、Agent Platform、Foundry クライアントはスタートアップ時に 1 回構築され、SDK は内部的に認証情報をリフレッシュするため、クラウド認証情報のローテーションは再起動を必要としません。静的 Anthropic API キーとベアラーはスタートアップ時に読み込まれます。[Anthropic API](#anthropic-api) を参照してください。132Bedrock、Claude Platform on AWS、Agent Platform、Foundry クライアントはスタートアップ時に 1 回構築され、SDK は内部的に認証情報をリフレッシュするため、クラウド認証情報のローテーションは再起動を必要としません。静的 Anthropic API キーとベアラーはスタートアップ時に読み込まれます。[Anthropic API](#anthropic-api) を参照してください。

127 133

128<h4 id="anthropic-api">134<h4 id="anthropic-api">

129 Anthropic API135 Anthropic API

193| その他の場所 | `AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、`AWS_SESSION_TOKEN` env vars を通じて認証情報を渡すか、`auth:` で `${VAR}` 展開を使用して明示的に設定します。 |199| その他の場所 | `AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、`AWS_SESSION_TOKEN` env vars を通じて認証情報を渡すか、`auth:` で `${VAR}` 展開を使用して明示的に設定します。 |

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

195 201

202<h4 id="claude-platform-on-aws">

203 Claude Platform on AWS

204</h4>

205

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

207

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

209

210```yaml theme={null}

211upstreams:

212 - provider: anthropicAws

213 region: us-east-1

214 workspace_id: wrkspc_...

215 auth:

216 api_key: ${ANTHROPIC_AWS_API_KEY} # x-api-key として送信

217 # または AWS デフォルト認証情報チェーン経由の SigV4：

218 # auth: {}

219 # または明示的な SigV4 認証情報：

220 # auth:

221 # aws_access_key_id: ${AWS_ACCESS_KEY_ID}

222 # aws_secret_access_key: ${AWS_SECRET_ACCESS_KEY}

223 # 派生エンドポイントをオーバーライド：

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

225```

226

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

228

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

230| ------------------------------------------------------- | --- | -------------------------------------------------------------------------------------------------- |

231| `region` | はい | AWS リージョン。小文字、数字、ハイフン。ゲートウェイは `https://aws-external-anthropic.<region>.api.aws` としてエンドポイントを派生させます。 |

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

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

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

235| `base_url` | いいえ | 派生エンドポイントをオーバーライド |

236

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

238

196<h4 id="google-cloud-agent-platform">239<h4 id="google-cloud-agent-platform">

197 Google Cloud Agent Platform240 Google Cloud Agent Platform

198</h4>241</h4>

255 298

256同じプロバイダーは、異なる `name:` で複数回表示できます。これは異なるリージョン、異なる認証情報チェーン経由の異なるアカウント、プロビジョニングスループット対オンデマンド、クロスプロバイダーフェイルオーバーをカバーします。299同じプロバイダーは、異なる `name:` で複数回表示できます。これは異なるリージョン、異なる認証情報チェーン経由の異なるアカウント、プロビジョニングスループット対オンデマンド、クロスプロバイダーフェイルオーバーをカバーします。

257 300

258ゲートウェイはアップストリームを順番に試します。`5xx`、`429`、タイムアウト、および欠落エンドポイント（`501`）はフェイルオーバーします。他の `4xx` はしません。`429` はアップストリーム容量ごとです。プロビジョニングスループット（PT）枯渇はオンデマンドにフェイルオーバーします。要求されたモデルを解決できないアップストリームはネットワークラウンドトリップなしでスキップされます。301ゲートウェイはアップストリームを順番に試します。`5xx`、`429`、`401`、`403`、`404`、タイムアウト、および欠落エンドポイント（`501`）はフェイルオーバーします。他の `4xx` はしません。

302

303`429` はアップストリーム容量ごとです。プロビジョニングスループット（PT）枯渇はオンデマンドにフェイルオーバーします。`404` はアップストリームモデル可用性ごとです。モデルを有効にしていないアップストリームは、後のアップストリームがそれを提供するのをブロックしません。要求されたモデルを解決できないアップストリームはネットワークラウンドトリップなしでスキップされます。

259 304

260この例は、プロビジョニングスループット Bedrock 割り当てを最初にルーティングし、オンデマンドと 2 番目のアカウントにオーバーフロー、最後に Anthropic API にフォールバックします：305この例は、プロビジョニングスループット Bedrock 割り当てを最初にルーティングし、オンデマンドと 2 番目のアカウントにオーバーフロー、最後に Anthropic API にフォールバックします：

261 306

508* [`allowAllClaudeAiMcps`](/ja/settings#available-settings)：claude.ai MCP サーバー許可リストの許可のみオーバーライド553* [`allowAllClaudeAiMcps`](/ja/settings#available-settings)：claude.ai MCP サーバー許可リストの許可のみオーバーライド

509* `sandbox.bwrapPath` と `sandbox.socatPath`：[サンドボックス](/ja/sandboxing)ヘルパーバイナリへのファイルシステムパス554* `sandbox.bwrapPath` と `sandbox.socatPath`：[サンドボックス](/ja/sandboxing)ヘルパーバイナリへのファイルシステムパス

510 555

511`allowManagedPermissionRulesOnly` と `disableBypassPermissionsMode` はクロスソースではないため、勝利ソースの値のみが適用されます。556`allowManagedPermissionRulesOnly` と `disableBypassPermissionsMode` はクロスソースではないため、勝利ソースの値のみが適用されます。[設定の優先順位](/ja/settings#settings-precedence)で、設定ページの同じルールを参照してください。

512 557

513ゲートウェイポリシーはマシン上のすべての Claude Code 呼び出しに適用されます。非インタラクティブ `claude -p` 実行と Agent SDK によって生成されたセッションを含みます。ゲートウェイがスタートアップ時に到達不可能な場合、署名されたセッションはポリシーなしで実行するのではなく、エラーで終了します。558ゲートウェイポリシーはマシン上のすべての Claude Code 呼び出しに適用されます。非インタラクティブ `claude -p` 実行と Agent SDK によって生成されたセッションを含みます。ゲートウェイがスタートアップ時に到達不可能な場合、署名されたセッションはポリシーなしで実行するのではなく、エラーで終了します。

514 559

652 # region: us-east-1697 # region: us-east-1

653 # auth: {}698 # auth: {}

654 699

700 # - provider: anthropicAws

701 # region: us-east-1

702 # workspace_id: wrkspc_...

703 # auth:

704 # api_key: ${ANTHROPIC_AWS_API_KEY}

705

655 # - provider: vertex706 # - provider: vertex

656 # region: us-east5707 # region: us-east5

657 # project_id: example-prod708 # project_id: example-prod

668 upstream_model:719 upstream_model:

669 anthropic: claude-opus-4-8720 anthropic: claude-opus-4-8

670 # bedrock: us.anthropic.claude-opus-4-8721 # bedrock: us.anthropic.claude-opus-4-8

722 # anthropicAws: claude-opus-4-8

671 # vertex: claude-opus-4-8723 # vertex: claude-opus-4-8

672 # foundry: <your-opus-deployment-name>724 # foundry: <your-opus-deployment-name>

673 - id: claude-sonnet-4-6725 - id: claude-sonnet-4-6

claude-code-on-the-web.md +2 −2

Details

721テレポートはセッションを再開する前にこれらの要件をチェックします。要件が満たされていない場合は、エラーが表示されるか、問題を解決するよう求められます。721テレポートはセッションを再開する前にこれらの要件をチェックします。要件が満たされていない場合は、エラーが表示されるか、問題を解決するよう求められます。

722 722

723| 要件 | 詳細 |723| 要件 | 詳細 |

724| ------------ | ------------------------------------------------------------------ |724| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

725| クリーンな git 状態 | 作業ディレクトリにコミットされていない変更がないことが必要です。テレポートは必要に応じて変更をスタッシュするよう求めます。 |725| クリーンな git 状態 | 作業ディレクトリにコミットされていない変更がないことが必要です。テレポートは必要に応じて変更をスタッシュするよう求めます。 |

726| 正しいリポジトリ | フォークではなく、同じリポジトリのチェックアウトから `--teleport` を実行する必要があります。 |726| 正しいリポジトリ | フォークではなく、同じリポジトリのチェックアウトから `--teleport` を実行する必要があります。{/* min-version: 2.1.199 */}v2.1.199 以降、Claude Code は `git@work:owner/repo.git` のような SSH ホストエイリアスや `insteadOf` で書き直された短い形式など、リモートをホスト名に解析できない場合でも、チェックアウトを受け入れます。最初に確認プロンプトを表示し、リモートの所有者とリポジトリ名がセッションのリポジトリと一致する場合のみです。 |

727| ブランチが利用可能 | クラウドセッションからのブランチがリモートにプッシュされている必要があります。テレポートは自動的にフェッチしてチェックアウトします。 |727| ブランチが利用可能 | クラウドセッションからのブランチがリモートにプッシュされている必要があります。テレポートは自動的にフェッチしてチェックアウトします。 |

728| 同じアカウント | クラウドセッションで使用された同じ claude.ai アカウントに認証される必要があります。 |728| 同じアカウント | クラウドセッションで使用された同じ claude.ai アカウントに認証される必要があります。 |

729 729

claude-platform-on-aws.md +1 −1

Details

230 230

231CI と自動化の場合、Anthropic サービスを呼び出す権限を持つ IAM ロールをランナーに付与し、`AWS_REGION` を設定します。認証情報チェーンはロールを自動的に取得します。231CI と自動化の場合、Anthropic サービスを呼び出す権限を持つ IAM ロールをランナーに付与し、`AWS_REGION` を設定します。認証情報チェーンはロールを自動的に取得します。

232 232

233SSO 認証情報がセッション中に期限切れになった場合、[`awsAuthRefresh`](/ja/amazon-bedrock#advanced-credential-configuration) を設定して、Claude Code がログインコマンドを再実行し、失敗する代わりに再試行するようにします。コマンドを `settings.json` に追加します。233SSO 認証情報がセッション中に期限切れになった場合、[`awsAuthRefresh`](/ja/amazon-bedrock#advanced-credential-configuration) を設定して、Claude Code がログインコマンドを再実行し、失敗する代わりに再試行するようにします。AWS 上の Claude Platform での自動更新には Claude Code v2.1.198 以降が必要です。それより前のバージョンは `/login` を実行するプロンプトで停止します。これは AWS 認証情報を更新できません。コマンドを `settings.json` に追加します。

234 234

235```json theme={null}235```json theme={null}

236{236{

cli-reference.md +4 −2

Details

47 47

48サブコマンドを誤入力した場合、Claude Code は最も近い一致を提案して、セッションを開始せずに終了します。たとえば、`claude udpate` は `Did you mean claude update?` と出力します。48サブコマンドを誤入力した場合、Claude Code は最も近い一致を提案して、セッションを開始せずに終了します。たとえば、`claude udpate` は `Did you mean claude update?` と出力します。

49 49

50{/* min-version: 2.1.199 */}v2.1.199 以降、`claude --dangerously-skip-permissions daemon <subcommand>` は `daemon` サブコマンドを実行します。以前のバージョンでは、`daemon <subcommand>` を新しいインタラクティブセッションのプロンプトとして扱ったため、フラグが最初に来た場合、サブコマンドは実行されませんでした。これは `claude` がフラグを含むようにエイリアスされている場合の一般的なセットアップです。先頭の `--dangerously-skip-permissions` または `--allow-dangerously-skip-permissions` のみが `daemon` にこの方法でルーティングされます。他の先頭フラグはまだインタラクティブセッションを開始します。

50<h2 id="cli-flags">52<h2 id="cli-flags">

51 CLI フラグ53 CLI フラグ

52</h2>54</h2>

66| `--ax-screen-reader` | {/* min-version: 2.1.181 */}スクリーンリーダーフレンドリーな出力をレンダリングします：装飾的なボーダーやアニメーションなしのフラットテキスト。クラシックレンダラーを強制するため、このセッションでは [`tui`](/ja/settings#available-settings) 設定は効果がありません。[`CLAUDE_AX_SCREEN_READER`](/ja/env-vars) と [`axScreenReader`](/ja/settings#available-settings) 設定より優先されます。Claude Code v2.1.181 以降が必要です | `claude --ax-screen-reader` |68| `--ax-screen-reader` | {/* min-version: 2.1.181 */}スクリーンリーダーフレンドリーな出力をレンダリングします：装飾的なボーダーやアニメーションなしのフラットテキスト。クラシックレンダラーを強制するため、このセッションでは [`tui`](/ja/settings#available-settings) 設定は効果がありません。[`CLAUDE_AX_SCREEN_READER`](/ja/env-vars) と [`axScreenReader`](/ja/settings#available-settings) 設定より優先されます。Claude Code v2.1.181 以降が必要です | `claude --ax-screen-reader` |

67| `--bare` | 最小限モード：hooks、skills、plugins、MCP サーバー、自動メモリ、CLAUDE.md の自動検出をスキップして、スクリプト化された呼び出しをより高速に開始します。Claude は Bash、ファイル読み取り、ファイル編集ツールにアクセスできます。[`CLAUDE_CODE_SIMPLE`](/ja/env-vars) を設定します。[bare mode](/ja/headless#start-faster-with-bare-mode) を参照してください | `claude --bare -p "query"` |69| `--bare` | 最小限モード：hooks、skills、plugins、MCP サーバー、自動メモリ、CLAUDE.md の自動検出をスキップして、スクリプト化された呼び出しをより高速に開始します。Claude は Bash、ファイル読み取り、ファイル編集ツールにアクセスできます。[`CLAUDE_CODE_SIMPLE`](/ja/env-vars) を設定します。[bare mode](/ja/headless#start-faster-with-bare-mode) を参照してください | `claude --bare -p "query"` |

69| `--bg`、`--background` | セッションを [バックグラウンドエージェント](/ja/agent-view) として開始し、すぐに戻ります。セッション ID と管理コマンドを出力します。`--exec` と組み合わせて、Claude セッションの代わりにシェルコマンドをバックグラウンドジョブとして実行するか、`--agent` と組み合わせて特定の subagent を実行します | `claude --bg "investigate the flaky test"` |71| `--bg`、`--background` | セッションを [バックグラウンドエージェント](/ja/agent-view) として開始し、すぐに戻ります。セッション ID と管理コマンドを出力します。`--exec` と組み合わせて、Claude セッションの代わりにシェルコマンドをバックグラウンドジョブとして実行するか、`--agent` と組み合わせて特定の subagent を実行します。{/* min-version: 2.1.198 */}`-p`/`--print` と組み合わせることはできません。[エラーリファレンス](/ja/errors#command-line-errors) を参照してください | `claude --bg "investigate the flaky test"` |

70| `--channels` | （研究プレビュー）Claude がこのセッションでリッスンすべき [channel](/ja/channels) 通知を持つ MCP サーバー。`plugin:<name>@<marketplace>` エントリのスペース区切りリスト。Claude.ai 認証が必要です | `claude --channels plugin:my-notifier@my-marketplace` |72| `--channels` | （研究プレビュー）Claude がこのセッションでリッスンすべき [channel](/ja/channels) 通知を持つ MCP サーバー。`plugin:<name>@<marketplace>` エントリのスペース区切りリスト。Claude.ai 認証が必要です | `claude --channels plugin:my-notifier@my-marketplace` |

100| `--no-session-persistence` | セッション永続化を無効にして、セッションがディスクに保存されず、再開できないようにします（プリントモードのみ）。[`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ja/env-vars) 環境変数は任意のモードで同じことを行います | `claude -p --no-session-persistence "query"` |102| `--no-session-persistence` | セッション永続化を無効にして、セッションがディスクに保存されず、再開できないようにします（プリントモードのみ）。[`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ja/env-vars) 環境変数は任意のモードで同じことを行います | `claude -p --no-session-persistence "query"` |

102| `--permission-mode` | 指定された [権限モード](/ja/permission-modes) で開始します。`default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、または `bypassPermissions` を受け入れます。設定ファイルの `defaultMode` をオーバーライドします | `claude --permission-mode plan` |104| `--permission-mode` | 指定された [権限モード](/ja/permission-modes) で開始します。`default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、または `bypassPermissions` を受け入れます。設定ファイルの `defaultMode` をオーバーライドします | `claude --permission-mode plan` |

103| `--permission-prompt-tool` | 非インタラクティブモードで権限プロンプトを処理する MCP ツールを指定します | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |105| `--permission-prompt-tool` | 非インタラクティブモードで権限プロンプトを処理する MCP ツールを指定します。{/* min-version: 2.1.199 */}v2.1.199 以降、プロンプトツールは [ユーザーインタラクションが必要](/ja/mcp#require-approval-for-a-specific-tool) とマークされた MCP ツールを承認できません：そのようなツールの `allow` 結果は拒否に変換されます | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |

104| `--plugin-dir` | このセッションのみのプラグインをディレクトリまたは `.zip` アーカイブから読み込みます。各フラグは 1 つのパスを取ります。複数のプラグインの場合はフラグを繰り返します：`--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |106| `--plugin-dir` | このセッションのみのプラグインをディレクトリまたは `.zip` アーカイブから読み込みます。各フラグは 1 つのパスを取ります。複数のプラグインの場合はフラグを繰り返します：`--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |

105| `--plugin-url` | このセッションのみのプラグイン `.zip` アーカイブを URL から取得します。複数のプラグインの場合はフラグを繰り返すか、スペース区切りの URL を単一の引用符で囲まれた値で渡します | `claude --plugin-url https://example.com/plugin.zip` |107| `--plugin-url` | このセッションのみのプラグイン `.zip` アーカイブを URL から取得します。複数のプラグインの場合はフラグを繰り返すか、スペース区切りの URL を単一の引用符で囲まれた値で渡します | `claude --plugin-url https://example.com/plugin.zip` |

commands.md +9 −8

Details

10 10

11`/` と入力すると、利用可能なすべてのコマンドが表示されます。または `/` の後に文字を入力してフィルタリングできます。11`/` と入力すると、利用可能なすべてのコマンドが表示されます。または `/` の後に文字を入力してフィルタリングできます。

12 12

~~13コマンドはメッセージの開始時にのみ認識されます。コマンド名の後に続くテキストは引数として渡されます。~~13コマンドはメッセージの開始時にのみ認識されます。コマンド名の後に続くテキストは引数として渡されます。v2.1.199 以降、[スキル](/ja/skills#pass-arguments-to-skills)は例外です。スキル呼び出しの後に別のスキルが続く場合（例：`/skill-a /skill-b do XYZ`）、開始時に指定されたすべてのスキルが読み込まれ、末尾のテキストが各スキルに引数として渡されます。最大 6 つのスキルをチェーンできます。

14 14

15<h2 id="commands-across-a-typical-workflow">15<h2 id="commands-across-a-typical-workflow">

16 典型的なワークフロー全体でのコマンド16 典型的なワークフロー全体でのコマンド

18 18

19ほとんどのコマンドはセッション内の特定の時点で有用です。プロジェクトのセットアップから変更のリリースまでです。19ほとんどのコマンドはセッション内の特定の時点で有用です。プロジェクトのセットアップから変更のリリースまでです。

20 20

21**リポジトリでの最初のセッション。** `/init` を実行してスターター `CLAUDE.md` を生成し、その後 `/memory` を実行して改善します。`/mcp` と `/agents` を使用してプロジェクトが必要とするサーバーまたはサブエージェントをセットアップし、`/permissions` を使用して必要な承認ルールを設定します。21**リポジトリでの最初のセッション。** `/init` を実行してスターター `CLAUDE.md` を生成し、その後 `/memory` を実行して改善します。`/mcp` を使用してプロジェクトが必要とするサーバーをセットアップし、Claude に作成してほしい[サブエージェント](/ja/sub-agents)を依頼し、`/permissions` を実行して承認ルールを設定します。

22 22

23**タスク中。** `/plan` は大きな変更の前に Plan Mode に切り替えます。`/model` と `/effort` は使用している推論量を調整します。会話が長くなったら、`/context` はウィンドウがどこに向かっているかを表示し、`/compact` はそれを要約します。`/btw` を使用して、履歴を膨らませるべきではない素早い脇道を作成します。23**タスク中。** `/plan` は大きな変更の前に Plan Mode に切り替えます。`/model` と `/effort` は使用しているモデルと適用する推論量を調整します。会話が長くなったら、`/context` はウィンドウを埋めているものを表示し、`/compact` はそれを要約してスペースを解放します。`/btw` を使用して、会話履歴に追加すべきではない素早い脇道を作成します。

24 24

25**並行して作業を実行する。** `/agents` は Claude が副次的なタスクを委譲できる[サブエージェント](/ja/sub-agents)のマネージャーを開き、`/tasks` は現在のセッションのバックグラウンドで実行されているものをリストします。`/background` はセッション全体をデタッチして[バックグラウンドエージェント](/ja/agent-view)として実行し続け、ターミナルを解放します。コードベース全体にまたがる大きな変更の場合、`/batch` はそれを独立したユニットに分解し、各ユニットを独自の[worktree](/ja/worktrees)で実行します。これらのアプローチがどのように関連しているかについては、[エージェントを並行して実行する](/ja/agents)を参照してください。25**並行して作業を実行する。** Claude は副次的なタスクを[サブエージェント](/ja/sub-agents)に委譲し、`/tasks` は現在のセッションのバックグラウンドで実行されているものをリストします。`/background` はセッション全体をデタッチして[バックグラウンドエージェント](/ja/agent-view)として実行し続け、ターミナルを解放します。コードベース全体にまたがる大きな変更の場合、`/batch` はそれを独立したユニットに分解し、各ユニットを独自の[worktree](/ja/worktrees)で実行します。これらのアプローチがどのように関連しているかについては、[エージェントを並行して実行する](/ja/agents)を参照してください。

26 26

27**リリース前。** `/diff` は変更内容を表示し、`/code-review` は diff の正確性のバグをチェックし、`--fix` で検出結果を適用できます。`/review` は GitHub プルリクエストで同じ読み取り専用レビューを実行し、`/security-review` はより深い読み取り専用パスを提供します。`/code-review ultra` はクラウドでマルチエージェントレビューを実行します。27**リリース前。** `/diff` は変更内容を表示し、`/code-review` は diff の正確性のバグをチェックし、`--fix` で検出結果を適用できます。`/review` は GitHub プルリクエストで同じ読み取り専用レビューを実行し、`/security-review` はより深い読み取り専用パスを提供します。`/code-review ultra` はクラウドでマルチエージェントレビューを実行します。

28 28

51| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |51| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

52| `/add-dir <path>` | 現在のセッション中にファイルアクセス用の作業ディレクトリを追加します。ほとんどの `.claude/` 設定は追加されたディレクトリから[検出されません](/ja/permissions#additional-directories-grant-file-access-not-configuration)。後で `--continue` または `--resume` を使用して、追加されたディレクトリからセッションを再開できます |52| `/add-dir <path>` | 現在のセッション中にファイルアクセス用の作業ディレクトリを追加します。ほとんどの `.claude/` 設定は追加されたディレクトリから[検出されません](/ja/permissions#additional-directories-grant-file-access-not-configuration)。後で `--continue` または `--resume` を使用して、追加されたディレクトリからセッションを再開できます |

53| `/advisor [model\|off]` | {/* min-version: 2.1.98 */}[アドバイザーツール](/ja/advisor)を有効または無効にします。このツールはタスク中の重要な瞬間に 2 番目のモデルに相談して指導を受けます。`opus`、`sonnet`、`fable`（{/* min-version: 2.1.170 */}v2.1.170+）、または完全なモデル ID を受け入れます。引数なしで、ピッカーを開きます。Claude Code v2.1.98 以降が必要です |53| `/advisor [model\|off]` | {/* min-version: 2.1.98 */}[アドバイザーツール](/ja/advisor)を有効または無効にします。このツールはタスク中の重要な瞬間に 2 番目のモデルに相談して指導を受けます。`opus`、`sonnet`、`fable`（{/* min-version: 2.1.170 */}v2.1.170+）、または完全なモデル ID を受け入れます。引数なしで、ピッカーを開きます。Claude Code v2.1.98 以降が必要です |

54| `/agents` | [エージェント](/ja/sub-agents)設定を管理します |54| `/agents` | {/* min-version: 2.1.198 */}v2.1.198 以降、`/agents` を実行すると、Claude に[サブエージェント](/ja/sub-agents)を作成または管理するよう依頼するか、`.claude/agents/` または `~/.claude/agents/` を直接編集するよう促すリマインダーが出力されます。{/* max-version: 2.1.197 */}v2.1.197 以前では、サブエージェント設定を作成および管理するためのインタラクティブインターフェースを開きます |

55| `/autofix-pr [prompt]` | 現在のブランチの PR を監視し、CI が失敗するか、レビュアーがコメントを残したときに修正をプッシュする [Claude Code on the web](/ja/claude-code-on-the-web#auto-fix-pull-requests) セッションを生成します。`gh pr view` で開いている PR を検出します。別の PR を監視するには、最初にそのブランチをチェックアウトしてください。デフォルトでは、クラウドセッションはすべての CI 失敗とレビューコメントを修正するよう指示されます。プロンプトを渡して異なる指示を与えることができます。例えば `/autofix-pr only fix lint and type errors`。`gh` CLI と [Claude Code on the web](/ja/claude-code-on-the-web) へのアクセスが必要です |55| `/autofix-pr [prompt]` | 現在のブランチの PR を監視し、CI が失敗するか、レビュアーがコメントを残したときに修正をプッシュする [Claude Code on the web](/ja/claude-code-on-the-web#auto-fix-pull-requests) セッションを生成します。`gh pr view` で開いている PR を検出します。別の PR を監視するには、最初にそのブランチをチェックアウトしてください。デフォルトでは、クラウドセッションはすべての CI 失敗とレビューコメントを修正するよう指示されます。プロンプトを渡して異なる指示を与えることができます。例えば `/autofix-pr only fix lint and type errors`。`gh` CLI と [Claude Code on the web](/ja/claude-code-on-the-web) へのアクセスが必要です |

56| `/background [prompt]` | 現在のセッションをデタッチして[バックグラウンドエージェント](/ja/agent-view)として実行し、このターミナルを解放します。デタッチする前に 1 つ以上の指示を送信するためにプロンプトを渡します。`claude agents` でセッションを監視します。エイリアス: `/bg` |56| `/background [prompt]` | 現在のセッションをデタッチして[バックグラウンドエージェント](/ja/agent-view)として実行し、このターミナルを解放します。デタッチする前に 1 つ以上の指示を送信するためにプロンプトを渡します。`claude agents` でセッションを監視します。エイリアス: `/bg` |

57| `/batch <instruction>` | **[スキル](/ja/skills#bundled-skills)。** コードベース全体にわたる大規模な変更を並列で調整します。コードベースを調査し、作業を 5 ～ 30 個の独立したユニットに分解し、計画を提示します。承認されると、分離された [git worktree](/ja/worktrees) 内の各ユニットごとに 1 つの[バックグラウンドサブエージェント](/ja/sub-agents#run-subagents-in-foreground-or-background)を生成します。各サブエージェントはそのユニットを実装し、テストを実行し、プルリクエストを開きます。git リポジトリが必要です。例: `/batch migrate src/ from Solid to React` |57| `/batch <instruction>` | **[スキル](/ja/skills#bundled-skills)。** コードベース全体にわたる大規模な変更を並列で調整します。コードベースを調査し、作業を 5 ～ 30 個の独立したユニットに分解し、計画を提示します。承認されると、分離された [git worktree](/ja/worktrees) 内の各ユニットごとに 1 つの[バックグラウンドサブエージェント](/ja/sub-agents#run-subagents-in-foreground-or-background)を生成します。各サブエージェントはそのユニットを実装し、テストを実行し、プルリクエストを開きます。git リポジトリが必要です。例: `/batch migrate src/ from Solid to React` |

68| `/context [all]` | 現在のコンテキスト使用状況をカラーグリッドとして視覚化します。コンテキストが多いツール、メモリ肥大化、容量警告の最適化提案を表示します。[フルスクリーンモード](/ja/fullscreen)では、項目ごとの内訳はグリッドを表示したままにするために折りたたまれます。`all` を渡して展開します |68| `/context [all]` | 現在のコンテキスト使用状況をカラーグリッドとして視覚化します。コンテキストが多いツール、メモリ肥大化、容量警告の最適化提案を表示します。[フルスクリーンモード](/ja/fullscreen)では、項目ごとの内訳はグリッドを表示したままにするために折りたたまれます。`all` を渡して展開します |

69| `/copy [N]` | 最後のアシスタント応答をクリップボードにコピーします。数字 `N` を渡して N 番目に新しい応答をコピーします。`/copy 2` は 2 番目に新しい応答をコピーします。コードブロックが存在する場合、個別ブロックまたは完全な応答を選択するインタラクティブピッカーを表示します。ピッカーで `w` を押して、クリップボードの代わりにファイルに選択内容を書き込みます。SSH 経由で便利です |69| `/copy [N]` | 最後のアシスタント応答をクリップボードにコピーします。数字 `N` を渡して N 番目に新しい応答をコピーします。`/copy 2` は 2 番目に新しい応答をコピーします。コードブロックが存在する場合、個別ブロックまたは完全な応答を選択するインタラクティブピッカーを表示します。ピッカーで `w` を押して、クリップボードの代わりにファイルに選択内容を書き込みます。SSH 経由で便利です |

71| `/dataviz [request]` | **[スキル](/ja/skills#bundled-skills)。** チャート、グラフ、ダッシュボードの設計ガイダンス。Claude はデータのチャート形式を選択し、役割別に色を割り当て、バンドルされたスクリプトで色覚異常対応と対比をパレットで検証し、マーク、相互作用、アクセシビリティルールを適用します。ブランド中立的なプレースホルダーパレットを使用します。これを独自のパレットに置き換えます。{/* min-version: 2.1.198 */}Claude Code v2.1.198 以降が必要です |

71| `/debug [description]` | **[スキル](/ja/skills#bundled-skills)。** 現在のセッションのデバッグログを有効にし、セッションデバッグログを読むことで問題をトラブルシューティングします。デバッグログはデフォルトではオフです。`claude --debug` で開始した場合を除き、セッション中に `/debug` を実行するとその時点からログのキャプチャを開始します。オプションで問題を説明して分析にフォーカスを当てます |72| `/debug [description]` | **[スキル](/ja/skills#bundled-skills)。** 現在のセッションのデバッグログを有効にし、セッションデバッグログを読むことで問題をトラブルシューティングします。デバッグログはデフォルトではオフです。`claude --debug` で開始した場合を除き、セッション中に `/debug` を実行するとその時点からログのキャプチャを開始します。オプションで問題を説明して分析にフォーカスを当てます |

72| `/deep-research <question>` | **[ワークフロー](/ja/workflows#bundled-workflows)。** 質問に関するウェブ検索をファンアウトし、ソースをフェッチして相互検証し、引用されたレポートを合成します |73| `/deep-research <question>` | **[ワークフロー](/ja/workflows#bundled-workflows)。** 質問に関するウェブ検索をファンアウトし、ソースをフェッチして相互検証し、引用されたレポートを合成します |

74| `/design-sync [hint]` | **[スキル](/ja/skills#bundled-skills)。** リポジトリの React デザインシステムを変換して [Claude Design](https://claude.ai/design) にアップロードします。これにより、デザインが実際のコンポーネントを使用するようになります。オプションでデザインシステムに名前を付けます。例えば `/design-sync Acme DS`。初回同期はすべてのコンポーネントを検証し、大規模なリポジトリでは数時間かかる場合があります。Anthropic API で利用可能です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では、基盤となるツールが claude.ai に到達できないため、コマンドは利用できません |75| `/design-sync [hint]` | **[スキル](/ja/skills#bundled-skills)。** リポジトリの React デザインシステムを変換して [Claude Design](https://claude.ai/design) にアップロードします。これにより、デザインが実際のコンポーネントを使用するようになります。オプションでデザインシステムに名前を付けます。例えば `/design-sync Acme DS`。初回同期はすべてのコンポーネントを検証し、大規模なリポジトリでは数時間かかる場合があります。Anthropic API で利用可能です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では、基盤となるツールが claude.ai に到達できないため、コマンドは利用できません |

76| `/diff` | コミットされていない変更と各ターンの diff を表示するインタラクティブ diff ビューアを開きます。左右矢印を使用して現在の git diff と個別の Claude ターンを切り替え、上下矢印でファイルをブラウズします |77| `/diff` | コミットされていない変更と各ターンの diff を表示するインタラクティブ diff ビューアを開きます。左右矢印を使用して現在の git diff と個別の Claude ターンを切り替え、上下矢印でファイルをブラウズします。{/* min-version: 2.1.198 */}v2.1.198 以降、開いているビューアは、別のターミナルでのブランチ切り替えやコミットなど、セッション外でリポジトリの git 状態が変更されたときに自動的に更新されます |

78| `/effort [level\|auto]` | モデルの[努力レベル](/ja/model-config#adjust-effort-level)を設定します。`low`、`medium`、`high`、`xhigh`、`max`、または `ultracode` を受け入れます。利用可能なレベルはモデルに依存し、`max` と `ultracode` はセッションのみです。`ultracode` は Claude Code 設定で、`xhigh` 推論と自動[ワークフロー](/ja/workflows#let-claude-decide-with-ultracode)オーケストレーションを組み合わせています。`auto` はモデルのデフォルトにリセットします。引数なしで、インタラクティブスライダーを開きます。左右矢印でレベルを選択し、`Enter` で適用します。現在の応答の完了を待たずに即座に有効になります |79| `/effort [level\|auto]` | モデルの[努力レベル](/ja/model-config#adjust-effort-level)を設定します。`low`、`medium`、`high`、`xhigh`、`max`、または `ultracode` を受け入れます。利用可能なレベルはモデルに依存し、`max` と `ultracode` はセッションのみです。`ultracode` は Claude Code 設定で、`xhigh` 推論と自動[ワークフロー](/ja/workflows#let-claude-decide-with-ultracode)オーケストレーションを組み合わせています。`auto` はモデルのデフォルトにリセットします。引数なしで、インタラクティブスライダーを開きます。左右矢印でレベルを選択し、`Enter` で適用します。現在の応答の完了を待たずに即座に有効になります |

81| `/fast [on\|off]` | [高速モード](/ja/fast-mode)のオン/オフを切り替えます |82| `/fast [on\|off]` | [高速モード](/ja/fast-mode)のオン/オフを切り替えます |

83| `/fewer-permission-prompts` | **[スキル](/ja/skills#bundled-skills)。** トランスクリプトで一般的な読み取り専用 Bash と MCP ツール呼び出しをスキャンし、プロジェクト `.claude/settings.json` に優先度付きの許可リストを追加して権限プロンプトを削減します |84| `/fewer-permission-prompts` | **[スキル](/ja/skills#bundled-skills)。** トランスクリプトで一般的な読み取り専用 Bash と MCP ツール呼び出しをスキャンし、プロジェクト `.claude/settings.json` に優先度付きの許可リストを追加して権限プロンプトを削減します |

84| `/focus` | フォーカスビューを切り替えます。最後のプロンプト、編集 diffstats を含む 1 行のツール呼び出し要約、および最終応答のみを表示します。選択は複数セッション間で保持されます。設定で [`viewMode`](/ja/settings#available-settings) を設定してオーバーライドします。[フルスクリーンレンダリング](/ja/fullscreen)でのみ利用可能です |85| `/focus` | フォーカスビューを切り替えます。最後のプロンプト、編集 diffstats を含む 1 行のツール呼び出し要約、および最終応答のみを表示します。{/* min-version: 2.1.198 */}v2.1.198 以降、ツール呼び出し要約はターン内で起動されたサブエージェントの数もカウントし、完了したバックグラウンドタスク通知を単一のカウントに折りたたみます。選択は複数セッション間で保持されます。設定で [`viewMode`](/ja/settings#available-settings) を設定してオーバーライドします。[フルスクリーンレンダリング](/ja/fullscreen)でのみ利用可能です |

85| `/fork <directive>` | {/* min-version: 2.1.161 */}[フォークされたサブエージェント](/ja/sub-agents#fork-the-current-conversation)を生成します。完全な会話を継承し、指示に対して作業するバックグラウンドサブエージェント。その結果は完了時に会話に戻ります。会話自体のコピーに切り替えるには、`/branch` を使用します。v2.1.161 より前では、`/fork` は `/branch` のエイリアスです |86| `/fork <directive>` | {/* min-version: 2.1.161 */}[フォークされたサブエージェント](/ja/sub-agents#fork-the-current-conversation)を生成します。完全な会話を継承し、指示に対して作業するバックグラウンドサブエージェント。その結果は完了時に会話に戻ります。会話自体のコピーに切り替えるには、`/branch` を使用します。v2.1.161 より前では、`/fork` は `/branch` のエイリアスです |

86| `/goal [condition\|clear]` | [目標](/ja/goal)を設定します。Claude は条件が満たされるまでターン間で作業を続けます。引数なしで、現在または最後に達成された目標を表示します。`clear`、`stop`、`off`、`reset`、`none`、または `cancel` はアクティブな目標を早期に削除します |87| `/goal [condition\|clear]` | [目標](/ja/goal)を設定します。Claude は条件が満たされるまでターン間で作業を続けます。引数なしで、現在または最後に達成された目標を表示します。`clear`、`stop`、`off`、`reset`、`none`、または `cancel` はアクティブな目標を早期に削除します |

87| `/heapdump` | JavaScript ヒープスナップショットとメモリ分析を `~/Desktop` に書き込んで、高いメモリ使用量を診断します。Linux で Desktop フォルダがない場合はホームディレクトリに書き込みます。[トラブルシューティング](/ja/troubleshooting#high-cpu-or-memory-usage)を参照してください |88| `/heapdump` | JavaScript ヒープスナップショットとメモリ分析を `~/Desktop` に書き込んで、高いメモリ使用量を診断します。Linux で Desktop フォルダがない場合はホームディレクトリに書き込みます。[トラブルシューティング](/ja/troubleshooting#high-cpu-or-memory-usage)を参照してください |

127| `/setup-bedrock` | [Amazon Bedrock](/ja/amazon-bedrock) 認証、リージョン、モデルピンをインタラクティブウィザードで構成します。`CLAUDE_CODE_USE_BEDROCK=1` が設定されている場合のみ表示されます。初回 Bedrock ユーザーはログイン画面からこのウィザードにアクセスすることもできます |128| `/setup-bedrock` | [Amazon Bedrock](/ja/amazon-bedrock) 認証、リージョン、モデルピンをインタラクティブウィザードで構成します。`CLAUDE_CODE_USE_BEDROCK=1` が設定されている場合のみ表示されます。初回 Bedrock ユーザーはログイン画面からこのウィザードにアクセスすることもできます |

128| `/setup-vertex` | [Google Vertex AI](/ja/google-vertex-ai) 認証、プロジェクト、リージョン、モデルピンをインタラクティブウィザードで構成します。`CLAUDE_CODE_USE_VERTEX=1` が設定されている場合のみ表示されます。初回 Vertex AI ユーザーはログイン画面からこのウィザードにアクセスすることもできます |129| `/setup-vertex` | [Google Vertex AI](/ja/google-vertex-ai) 認証、プロジェクト、リージョン、モデルピンをインタラクティブウィザードで構成します。`CLAUDE_CODE_USE_VERTEX=1` が設定されている場合のみ表示されます。初回 Vertex AI ユーザーはログイン画面からこのウィザードにアクセスすることもできます |

129| `/simplify [target]` | {/* min-version: 2.1.154 */}**[スキル](/ja/skills#bundled-skills)。** 変更されたコードをクリーンアップの機会についてレビューし、修正を適用します。4 つのレビュー[エージェント](/ja/sub-agents)が並列で実行され、既存のヘルパーの再利用、簡潔化、効率化、および変更が抽象化の正しいレベルにあるかどうかをカバーします。v2.1.154 以降、レビューは正確性バグを探しません。バグを見つけるには `/code-review` を使用してください。以前のバージョンでは `/simplify` は `/code-review --fix` と同等です。特定のターゲットをレビューするためにパスまたは PR リファレンスを渡します |130| `/simplify [target]` | {/* min-version: 2.1.154 */}**[スキル](/ja/skills#bundled-skills)。** 変更されたコードをクリーンアップの機会についてレビューし、修正を適用します。4 つのレビュー[エージェント](/ja/sub-agents)が並列で実行され、既存のヘルパーの再利用、簡潔化、効率化、および変更が抽象化の正しいレベルにあるかどうかをカバーします。v2.1.154 以降、レビューは正確性バグを探しません。バグを見つけるには `/code-review` を使用してください。以前のバージョンでは `/simplify` は `/code-review --fix` と同等です。特定のターゲットをレビューするためにパスまたは PR リファレンスを渡します |

130| `/skills` | 利用可能な[スキル](/ja/skills)をリスト表示します。`t` を押してトークン数でソートします。`Space` を押して[スキルを Claude または `/` メニューから非表示にし](/ja/skills#override-skill-visibility-from-settings)、`Enter` で保存します |131| `/skills` | 利用可能な[スキル](/ja/skills)をリスト表示します。{/* min-version: 2.1.121 */}v2.1.121 以降、名前でリストをフィルタリングするために入力します。`t` を押してトークン数でソートします。`Space` を押して[スキルを Claude または `/` メニューから非表示にし](/ja/skills#override-skill-visibility-from-settings)、`Enter` で保存します |

context-window.md +1 −1

Details

1587 コンパクション後に残るもの1587 コンパクション後に残るもの

1588</h2>1588</h2>

1589 1589

1590長いセッションがコンパクションされると、Claude Code は会話履歴をコンテキストウィンドウに収まるようにまとめます。あなたの指示に何が起こるかは、それらがどのように読み込まれたかによって異なります。1590長いセッションがコンパクションされると、Claude Code は会話履歴をコンテキストウィンドウに収まるようにまとめます。{/* min-version: 2.1.198 */}v2.1.198 以降、要約リクエストはセッションの[拡張思考](/ja/model-config#extended-thinking)設定を継承するため、セッションで有効になっている場合は思考を有効にして推論し、そうでない場合はオフのままになります。思考は要約の生成方法にのみ影響します。セッション設定はその後変更されません。あなたの指示に何が起こるかは、それらがどのように読み込まれたかによって異なります。

1591 1591

1592| メカニズム | コンパクション後 |1592| メカニズム | コンパクション後 |

1593| :----------------------------- | :-------------------------------------------------------------------- |1593| :----------------------------- | :-------------------------------------------------------------------- |

costs.md +3 −3

Details

107* **タスク間でクリアする**: 関連のない作業に切り替える場合は `/clear` を使用して新しく開始します。古いコンテキストは後続のすべてのメッセージでトークンを浪費します。クリアする前に `/rename` を使用してセッションに名前を付けると、後で簡単に見つけることができます。その後、`/resume` を使用して戻ります。107* **タスク間でクリアする**: 関連のない作業に切り替える場合は `/clear` を使用して新しく開始します。古いコンテキストは後続のすべてのメッセージでトークンを浪費します。クリアする前に `/rename` を使用してセッションに名前を付けると、後で簡単に見つけることができます。その後、`/resume` を使用して戻ります。

108* **カスタムコンパクション指示を追加する**: `/compact Focus on code samples and API usage` は、要約中に保持する内容を Claude に指示します。108* **カスタムコンパクション指示を追加する**: `/compact Focus on code samples and API usage` は、要約中に保持する内容を Claude に指示します。

109 109

110CLAUDE.md でコンパクション動作をカスタマイズすることもできます。110プロジェクトのルートにある CLAUDE.md ファイルでコンパクション動作をカスタマイズすることもできます。

111 111

112```markdown theme={null}112```markdown theme={null}

113# Compact instructions113# Compact instructions

170 </Tab>170 </Tab>

171 171

172 <Tab title="filter-test-output.sh">172 <Tab title="filter-test-output.sh">

173 フックはこのスクリプトを呼び出し、コマンドがテストランナーであるかどうかを確認し、失敗のみを表示するように変更します。173 フックはこのスクリプトを呼び出します。`mkdir -p ~/.claude/hooks` でフォルダを作成し、以下のスクリプトを `~/.claude/hooks/filter-test-output.sh` として保存し、`chmod +x ~/.claude/hooks/filter-test-output.sh` で実行可能にします。コマンドがテストランナーであるかどうかを確認し、失敗のみを表示するように変更します。

174 174

175 ```bash theme={null}175 ```bash theme={null}

176 #!/bin/bash176 #!/bin/bash

198 拡張思考を調整する198 拡張思考を調整する

199</h3>199</h3>

200 200

201拡張思考はデフォルトで有効になっています。これは複雑な計画と推論タスクのパフォーマンスを大幅に向上させるためです。思考トークンは出力トークンとして課金され、デフォルト予算はモデルに応じて数万トークンになる場合があります。深い推論が必要ない単純なタスクの場合、`/effort` で [努力レベル](/ja/model-config#adjust-effort-level) を低下させるか、`/model` で、`/config` で思考を無効にするか、`MAX_THINKING_TOKENS=8000` で予算を低下させることでコストを削減できます。適応推論モデルはゼロ以外の予算を無視するため、代わりに努力レベルを使用します。Fable 5 では思考を無効にすることはできません。これは常に拡張思考を使用します。201拡張思考はデフォルトで有効になっています。これは複雑な計画と推論タスクのパフォーマンスを大幅に向上させるためです。思考トークンは出力トークンとして課金され、デフォルト予算はモデルに応じて数万トークンになる場合があります。深い推論が必要ない単純なタスクの場合、`/effort` で [努力レベル](/ja/model-config#adjust-effort-level) を低下させるか、`/model` で、`/config` で思考を無効にするか、[固定思考予算](/ja/model-config#adaptive-reasoning-and-fixed-thinking-budgets) を持つモデルで、`MAX_THINKING_TOKENS=8000` などの `MAX_THINKING_TOKENS` [環境変数](/ja/env-vars) を設定して予算を低下させることでコストを削減できます。適応推論モデルはゼロ以外の予算を無視するため、代わりに努力レベルを使用します。Fable 5 では思考を無効にすることはできません。これは常に拡張思考を使用します。

202 202

203<h3 id="delegate-verbose-operations-to-subagents">203<h3 id="delegate-verbose-operations-to-subagents">

204 詳細な操作を subagent に委任する204 詳細な操作を subagent に委任する

debug-your-config.md +1 −2

Details

14 コンテキストに読み込まれた内容を確認する14 コンテキストに読み込まれた内容を確認する

15</h2>15</h2>

16 16

17`/context` コマンドは、現在のセッションのコンテキストウィンドウを占めるすべてのものを表示します。カテゴリ別に分類されます：システムプロンプト、メモリファイル、スキル、MCP ツール、会話メッセージです。まず実行して、`CLAUDE.md`、ルール、またはスキルの説明が存在するかどうかを確認します。17`/context` コマンドは、現在のセッションのコンテキストウィンドウを占めるすべてのものを表示します。カテゴリ別に分類されます：システムプロンプト、メモリファイル、スキル、カスタムサブエージェント（読み込み元を含む）、MCP ツール、会話メッセージです。まず実行して、`CLAUDE.md`、ルール、またはスキルの説明が存在するかどうかを確認します。

18 18

19特定のカテゴリの詳細については、専用コマンドで確認してください：19特定のカテゴリの詳細については、専用コマンドで確認してください：

20 20

22| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------- |22| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------- |

~~25| `/agents` | 設定されたサブエージェントとその設定 |~~

26| `/hooks` | アクティブなフック設定 |25| `/hooks` | アクティブなフック設定 |

27| `/mcp` | 接続された MCP サーバーとそのステータス |26| `/mcp` | 接続された MCP サーバーとそのステータス |

28| `/permissions` | 現在有効な許可と拒否ルール |27| `/permissions` | 現在有効な許可と拒否ルール |

desktop.md +1 −1

Details

829* **Linux（ベータ版）**：Linux デスクトップアプリではコンピュータ使用はまだ利用できません。[Claude Desktop on Linux](/ja/desktop-linux)を参照してください。829* **Linux（ベータ版）**：Linux デスクトップアプリではコンピュータ使用はまだ利用できません。[Claude Desktop on Linux](/ja/desktop-linux)を参照してください。

830* **インラインコード提案**：Desktop はオートコンプリートスタイルの提案を提供しません。会話型プロンプトと明示的なコード変更を通じて機能します。830* **インラインコード提案**：Desktop はオートコンプリートスタイルの提案を提供しません。会話型プロンプトと明示的なコード変更を通じて機能します。

831* **エージェントチーム**：並列 Claude Code セッションが互いにメッセージを送信するのは [CLI](/ja/agent-teams) で利用可能であり、Desktop では利用できません。1 つのセッション内でマルチエージェント作業を行う場合は、[動的ワークフロー](/ja/workflows)を使用します。これは Desktop で実行されます。831* **エージェントチーム**：並列 Claude Code セッションが互いにメッセージを送信するのは [CLI](/ja/agent-teams) で利用可能であり、Desktop では利用できません。1 つのセッション内でマルチエージェント作業を行う場合は、[動的ワークフロー](/ja/workflows)を使用します。これは Desktop で実行されます。

832* **ターミナルダイアログコマンド**：`/permissions`、`/config`、`/agents`、`/doctor` などのターミナルで対話型パネルを開く組み込みコマンドは、Code タブでは利用できず、`isn't available in this environment` で応答します。[設定ファイル](/ja/settings)を直接編集して権限ルールと設定を管理するか、スタンドアロン CLI からコマンドを実行します。832* **ターミナルダイアログコマンド**：`/permissions`、`/config`、`/doctor` などのターミナルで対話型パネルを開く組み込みコマンドは、Code タブでは利用できず、`isn't available in this environment` で応答します。[設定ファイル](/ja/settings)を直接編集して権限ルールと設定を管理するか、スタンドアロン CLI からコマンドを実行します。

833 833

834<h2 id="troubleshooting">834<h2 id="troubleshooting">

835 トラブルシューティング835 トラブルシューティング

env-vars.md +8 −4

Details

146| `CCR_FORCE_BUNDLE` | GitHub アクセスが利用可能な場合でも、[`claude --remote`](/ja/claude-code-on-the-web#send-local-repositories-without-github) がローカルリポジトリをバンドルしてアップロードするよう強制するには `1` に設定します |146| `CCR_FORCE_BUNDLE` | GitHub アクセスが利用可能な場合でも、[`claude --remote`](/ja/claude-code-on-the-web#send-local-repositories-without-github) がローカルリポジトリをバンドルしてアップロードするよう強制するには `1` に設定します |

147| `CLAUDECODE` | Claude Code がスポーンするサブプロセス（Bash と PowerShell ツール、tmux セッション、[フック](/ja/hooks) コマンド、[ステータスライン](/ja/statusline) コマンド、stdio [MCP サーバー](/ja/mcp) サブプロセス）で `1` に設定されます。IDE 拡張機能は統合ターミナルでもこれを設定します。スクリプトが Claude Code によってスポーンされたサブプロセス内で実行されているかどうかを検出するために使用します。現在のプロセスがツール呼び出しまたはフックによって直接スポーンされたか、Claude Code が開始した stdio MCP サーバー内かどうかを確認するには、代わりに `CLAUDE_CODE_CHILD_SESSION` を使用します |147| `CLAUDECODE` | Claude Code がスポーンするサブプロセス（Bash と PowerShell ツール、tmux セッション、[フック](/ja/hooks) コマンド、[ステータスライン](/ja/statusline) コマンド、stdio [MCP サーバー](/ja/mcp) サブプロセス）で `1` に設定されます。IDE 拡張機能は統合ターミナルでもこれを設定します。スクリプトが Claude Code によってスポーンされたサブプロセス内で実行されているかどうかを検出するために使用します。現在のプロセスがツール呼び出しまたはフックによって直接スポーンされたか、Claude Code が開始した stdio MCP サーバー内かどうかを確認するには、代わりに `CLAUDE_CODE_CHILD_SESSION` を使用します |

148| `CLAUDE_AFK_COUNTDOWN_MS` | {/* min-version: 2.1.198 */}自動継続する前に、応答されていない `AskUserQuestion` ダイアログにオンスクリーンカウントダウンが表示されるまでのミリ秒数。デフォルト `20000`（20 秒）。`CLAUDE_AFK_TIMEOUT_MS` を参照してください。Claude Code v2.1.198 以降が必須です |

149| `CLAUDE_AFK_TIMEOUT_MS` | {/* min-version: 2.1.198 */}応答されていない [`AskUserQuestion`](/ja/tools-reference) ダイアログが自動継続するまでのアイドル時間（ミリ秒）。デフォルト `60000`（60 秒）。不在中に質問を開いたままにするには、`86400000`（24 時間）などの大きな値を設定します。`0` に設定してもタイムアウトはオフになりません。ダイアログはすぐに閉じられます。Claude Code v2.1.198 以降が必須です |

148| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | すべての組み込み [subagent](/ja/sub-agents) タイプ（Explore や Plan など）を無効にするには `1` に設定します。非対話モード（`-p` フラグ）でのみ適用されます。SDK ユーザーが白紙の状態を望む場合に役立ちます |150| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | すべての組み込み [subagent](/ja/sub-agents) タイプ（Explore や Plan など）を無効にするには `1` に設定します。非対話モード（`-p` フラグ）でのみ適用されます。SDK ユーザーが白紙の状態を望む場合に役立ちます |

149| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | SDK で作成された MCP サーバーからのツール名の `mcp__<server>__` プレフィックスをスキップするには `1` に設定します。ツールは元の名前を使用します。SDK 使用のみ |151| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | SDK で作成された MCP サーバーからのツール名の `mcp__<server>__` プレフィックスをスキップするには `1` に設定します。ツールは元の名前を使用します。SDK 使用のみ |

150| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | バックグラウンド subagent のスタルタイムアウト（ミリ秒）。デフォルト `600000`（10 分）。タイマーは各ストリーミング進捗イベントでリセットされます。ウィンドウ内に進捗が到着しない場合、subagent は中止され、タスクは失敗とマークされ、部分的な結果が親に表示されます |152| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | バックグラウンド subagent のスタルタイムアウト（ミリ秒）。デフォルト `600000`（10 分）。タイマーは各ストリーミング進捗イベントでリセットされます。ウィンドウ内に進捗が到着しない場合、subagent は中止され、タスクは失敗とマークされ、部分的な結果が親に表示されます |

162| `CLAUDE_CODE_ATTRIBUTION_HEADER` | システムプロンプトの開始から属性ブロック（クライアントバージョンとプロンプトフィンガープリント）を省略するには `0` に設定します。これを無効にすると、[LLM ゲートウェイ](/ja/llm-gateway) を通じてルーティングする場合のプロンプトキャッシュヒット率が向上します。Anthropic API キャッシングは影響を受けません |164| `CLAUDE_CODE_ATTRIBUTION_HEADER` | システムプロンプトの開始から属性ブロック（クライアントバージョンとプロンプトフィンガープリント）を省略するには `0` に設定します。これを無効にすると、[LLM ゲートウェイ](/ja/llm-gateway) を通じてルーティングする場合のプロンプトキャッシュヒット率が向上します。Anthropic API キャッシングは影響を受けません |

163| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | オートコンパクション計算に使用されるコンテキスト容量をトークン単位で設定します。デフォルトはモデルのコンテキストウィンドウです：標準モデルの場合は 200K、[拡張コンテキスト](/ja/model-config#extended-context) モデルの場合は 1M。1M モデルで `500000` などの低い値を使用して、コンパクション目的でウィンドウを 500K として扱います。値はモデルの実際のコンテキストウィンドウでキャップされます。`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` はこの値のパーセンテージとして適用されます。この変数を設定すると、コンパクション閾値がステータスラインの `used_percentage` から分離されます。これは常にモデルの完全なコンテキストウィンドウを使用します |165| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | オートコンパクション計算に使用されるコンテキスト容量をトークン単位で設定します。デフォルトはモデルのコンテキストウィンドウです：標準モデルの場合は 200K、[拡張コンテキスト](/ja/model-config#extended-context) モデルの場合は 1M。1M モデルで `500000` などの低い値を使用して、コンパクション目的でウィンドウを 500K として扱います。値はモデルの実際のコンテキストウィンドウでキャップされます。`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` はこの値のパーセンテージとして適用されます。この変数を設定すると、コンパクション閾値がステータスラインの `used_percentage` から分離されます。これは常にモデルの完全なコンテキストウィンドウを使用します |

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

167| `CLAUDE_CODE_BRIDGE_SESSION_ID` | {/* min-version: 2.1.199 */}セッションがアクティブな [Remote Control](/ja/remote-control) 接続を持っている間、Bash ツールと [フックコマンド](/ja/hooks) サブプロセスで自動的に設定され、接続が終了すると削除されます。値は `session_` 形式のセッション ID で、セッションの `claude.ai/code` URL に表示される同じ識別子です。スクリプトはそれを実行したセッションにリンクバックできます。Claude Code v2.1.199 以降が必須です。[クラウドセッション](/ja/claude-code-on-the-web) では、代わりに `CLAUDE_CODE_REMOTE_SESSION_ID` を読み取ります |

165| `CLAUDE_CODE_CERT_STORE` | TLS 接続用の CA 証明書ソースのカンマ区切りリスト。`bundled` は Claude Code に付属する Mozilla CA セットです。`system` はオペレーティングシステムの信頼ストアです。読み取り専用のランタイムで `tls.getCACertificates` を持つ：ネイティブバイナリ、または npm インストール用の Node 22.15 以降。[CA 証明書ストア](/ja/network-config#ca-certificate-store) を参照してください。デフォルトは `bundled,system` です |168| `CLAUDE_CODE_CERT_STORE` | TLS 接続用の CA 証明書ソースのカンマ区切りリスト。`bundled` は Claude Code に付属する Mozilla CA セットです。`system` はオペレーティングシステムの信頼ストアです。読み取り専用のランタイムで `tls.getCACertificates` を持つ：ネイティブバイナリ、または npm インストール用の Node 22.15 以降。[CA 証明書ストア](/ja/network-config#ca-certificate-store) を参照してください。デフォルトは `bundled,system` です |

166| `CLAUDE_CODE_CHILD_SESSION` | {/* min-version: 2.1.172 */}Claude Code が Bash、PowerShell、Monitor ツール、[フック](/ja/hooks) コマンド、[ステータスライン](/ja/statusline) コマンドを通じてスポーンするサブプロセスで `1` に設定されます。stdio [MCP サーバー](/ja/mcp) サブプロセスでは設定されません。これらは長寿命で、それらをスポーンしたセッションより長く存在します。`CLAUDECODE` とは異なり、これは Claude Code 独自のスポーンパスによってのみ設定され、IDE 拡張機能によっては設定されないため、ネストされたセッションをトップレベルの `claude` から確実に区別します。IDE 統合ターミナルで起動されました。この方法で開始されたネストされた対話的な `claude` TUI は、`--resume`、`--continue`、上矢印履歴、`claude agents` リストから自動的に除外されます。非対話的な `claude -p` セッションは依然として永続化されます。`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` を設定してこの除外をオーバーライドします。Claude Code v2.1.172 以降が必須です |169| `CLAUDE_CODE_CHILD_SESSION` | {/* min-version: 2.1.172 */}Claude Code が Bash、PowerShell、Monitor ツール、[フック](/ja/hooks) コマンド、[ステータスライン](/ja/statusline) コマンドを通じてスポーンするサブプロセスで `1` に設定されます。stdio [MCP サーバー](/ja/mcp) サブプロセスでは設定されません。これらは長寿命で、それらをスポーンしたセッションより長く存在します。`CLAUDECODE` とは異なり、これは Claude Code 独自のスポーンパスによってのみ設定され、IDE 拡張機能によっては設定されないため、ネストされたセッションをトップレベルの `claude` から確実に区別します。IDE 統合ターミナルで起動されました。この方法で開始されたネストされた対話的な `claude` TUI は、`--resume`、`--continue`、上矢印履歴、`claude agents` リストから自動的に除外されます。非対話的な `claude -p` セッションは依然として永続化されます。`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` を設定してこの除外をオーバーライドします。Claude Code v2.1.172 以降が必須です |

179| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 添付ファイル処理を無効にするには `1` に設定します。`@` 構文を使用したファイルメンションはファイルコンテンツに展開される代わりにプレーンテキストとして送信されます |182| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 添付ファイル処理を無効にするには `1` に設定します。`@` 構文を使用したファイルメンションはファイルコンテンツに展開される代わりにプレーンテキストとして送信されます |

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

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

182| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | {/* min-version: 2.1.196 */}[バックグラウンドセッション](/ja/agent-view) の実行中のバックグラウンドシェルコマンドと動的ワークフローを停止するには `1` に設定します。[スーパーバイザー](/ja/agent-view#the-supervisor-process) が停止、再起動、またはそのセッションのプロセスを更新する場合、それらをセッションの次のプロセスに引き継ぐ代わりに。このハンドオフのみに影響します：`←` または [`/background`](/ja/agent-view#from-inside-a-session) でセッションをバックグラウンド化すると、進行中の作業が引き継がれます。`CLAUDE_DISABLE_ADOPT` は両方をオフにします。Claude Code v2.1.196 以降が必須です |185| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | {/* min-version: 2.1.196 */}[バックグラウンドセッション](/ja/agent-view) の実行中のバックグラウンドシェルコマンド、動的ワークフロー、{/* min-version: 2.1.198 */}v2.1.198 以降、バックグラウンド subagent を停止するには `1` に設定します。[スーパーバイザー](/ja/agent-view#the-supervisor-process) が停止、再起動、またはそのセッションのプロセスを更新する場合、それらをセッションの次のプロセスに引き継ぐ代わりに。このハンドオフのみに影響します：`←` または [`/background`](/ja/agent-view#from-inside-a-session) でセッションをバックグラウンド化すると、進行中の作業が引き継がれます。`CLAUDE_DISABLE_ADOPT` は両方をオフにします。Claude Code v2.1.196 以降が必須です |

183| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | {/* min-version: 2.1.193 */}オペレーティングシステムがメモリ圧力を報告する場合、Claude Code が [バックグラウンドシェルコマンド](/ja/interactive-mode#background-bash-commands) を終了するのを停止するには `1` に設定します。デフォルトでは、macOS と Linux では、Claude Code はメモリ圧力信号でメインセッションで開始されたバックグラウンドシェルを終了します。セッションが 30 分間アイドル状態で、ターンまたは subagent が実行されていない場合。Windows にはメモリ圧力信号がないため、この変数は効果がありません。Claude Code v2.1.193 以降が必須です |186| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | {/* min-version: 2.1.193 */}オペレーティングシステムがメモリ圧力を報告する場合、Claude Code が [バックグラウンドシェルコマンド](/ja/interactive-mode#background-bash-commands) を終了するのを停止するには `1` に設定します。デフォルトでは、macOS と Linux では、Claude Code はメモリ圧力信号でメインセッションで開始されたバックグラウンドシェルを終了します。セッションが 30 分間アイドル状態で、ターンまたは subagent が実行されていない場合。Windows にはメモリ圧力信号がないため、この変数は効果がありません。Claude Code v2.1.193 以降が必須です |

184| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Claude Code に付属する [スキル](/ja/skills) とワークフローを無効にするには `1` に設定します：バンドルされたスキルとワークフローは完全に削除されます。`/init` などの組み込みスラッシュコマンドは入力可能なままですが、モデルから非表示になります。プラグイン、`.claude/skills/`、`.claude/commands/` からのスキルは影響を受けません。[`disableBundledSkills`](/ja/settings#available-settings) 設定と同等です。`0` はそれをオーバーライドしません |187| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Claude Code に付属する [スキル](/ja/skills) とワークフローを無効にするには `1` に設定します：バンドルされたスキルとワークフローは完全に削除されます。`/init` などの組み込みスラッシュコマンドは入力可能なままですが、モデルから非表示になります。プラグイン、`.claude/skills/`、`.claude/commands/` からのスキルは影響を受けません。[`disableBundledSkills`](/ja/settings#available-settings) 設定と同等です。`0` はそれをオーバーライドしません |

186| `CLAUDE_CODE_DISABLE_CRON` | [スケジュール済みタスク](/ja/scheduled-tasks) を無効にするには `1` に設定します。`/loop` スキルと cron ツールが利用できなくなり、既にスケジュール済みのタスクはすべて実行を停止します。これには既にセッション中に実行中のタスクも含まれます |189| `CLAUDE_CODE_DISABLE_CRON` | [スケジュール済みタスク](/ja/scheduled-tasks) を無効にするには `1` に設定します。`/loop` スキルと cron ツールが利用できなくなり、既にスケジュール済みのタスクはすべて実行を停止します。これには既にセッション中に実行中のタスクも含まれます |

187| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Anthropic 固有の `anthropic-beta` リクエストヘッダーと beta ツールスキーマフィールド（`defer_loading` や `eager_input_streaming` など）を API リクエストから削除するには `1` に設定します。プロキシゲートウェイが「`anthropic-beta` ヘッダーの予期しない値」や「追加の入力は許可されていません」などのエラーでリクエストを拒否する場合に使用します。標準フィールド（`name`、`description`、`input_schema`、`cache_control`）は保持されます |190| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Anthropic 固有の `anthropic-beta` リクエストヘッダーと beta ツールスキーマフィールド（`defer_loading` や `eager_input_streaming` など）を API リクエストから削除するには `1` に設定します。プロキシゲートウェイが「`anthropic-beta` ヘッダーの予期しない値」や「追加の入力は許可されていません」などのエラーでリクエストを拒否する場合に使用します。標準フィールド（`name`、`description`、`input_schema`、`cache_control`）は保持されます |

191| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | {/* min-version: 2.1.198 */}組み込み [Explore と Plan subagent](/ja/sub-agents#built-in-subagents) を無効にするには `1` に設定します。Claude は検索ツールまたは一般的な subagent で探索し、[プランモード](/ja/permission-modes#analyze-before-you-edit-with-plan-mode) はファイルを直接読み取ります。Explore と Plan エージェントを起動する代わりに。`Explore` または `Plan` という名前のカスタム subagent は影響を受けません。Agent SDK または非対話モードのすべての組み込み subagent タイプを削除するには、代わりに `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` を使用します。Claude Code v2.1.198 以降が必須です |

189| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | 「Claude の調子はどうですか？」セッション品質調査を無効にするには `1` に設定します。`DISABLE_TELEMETRY`、`DO_NOT_TRACK`、または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が設定されている場合も調査は無効になります。`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` でオプトバックインしない限り。サンプルレートを設定する代わりに、[`feedbackSurveyRate`](/ja/settings#available-settings) 設定を使用します。[セッション品質調査](/ja/data-usage#session-quality-surveys) を参照してください |193| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | 「Claude の調子はどうですか？」セッション品質調査を無効にするには `1` に設定します。`DISABLE_TELEMETRY`、`DO_NOT_TRACK`、または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が設定されている場合も調査は無効になります。`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` でオプトバックインしない限り。サンプルレートを設定する代わりに、[`feedbackSurveyRate`](/ja/settings#available-settings) 設定を使用します。[セッション品質調査](/ja/data-usage#session-quality-surveys) を参照してください |

190| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | ファイル [チェックポイント](/ja/checkpointing) を無効にするには `1` に設定します。`/rewind` コマンドはコード変更を復元できなくなります |194| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | ファイル [チェックポイント](/ja/checkpointing) を無効にするには `1` に設定します。`/rewind` コマンドはコード変更を復元できなくなります |

231| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code がアクティブなモデルに対して想定するコンテキストウィンドウサイズをオーバーライドします。{/* min-version: 2.1.193 */}v2.1.193 以降、Claude Code が Claude モデルとして認識しないモデル名に対して直接適用されます。認識された Claude モデルの場合、`DISABLE_COMPACT` も設定されている場合にのみ有効になります。`ANTHROPIC_BASE_URL` を通じてモデルにルーティングする場合に使用します。その名前の組み込みサイズと一致しないコンテキストウィンドウを持つモデルの場合 |235| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code がアクティブなモデルに対して想定するコンテキストウィンドウサイズをオーバーライドします。{/* min-version: 2.1.193 */}v2.1.193 以降、Claude Code が Claude モデルとして認識しないモデル名に対して直接適用されます。認識された Claude モデルの場合、`DISABLE_COMPACT` も設定されている場合にのみ有効になります。`ANTHROPIC_BASE_URL` を通じてモデルにルーティングする場合に使用します。その名前の組み込みサイズと一致しないコンテキストウィンドウを持つモデルの場合 |

232| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ほとんどのリクエストの最大出力トークン数を設定します。デフォルトとキャップはモデルによって異なります。[最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) を参照してください。この値を増やすと、[オートコンパクション](/ja/costs#reduce-token-usage) がトリガーされる前に利用可能な有効なコンテキストウィンドウが減少します |236| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ほとんどのリクエストの最大出力トークン数を設定します。デフォルトとキャップはモデルによって異なります。[最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) を参照してください。この値を増やすと、[オートコンパクション](/ja/costs#reduce-token-usage) がトリガーされる前に利用可能な有効なコンテキストウィンドウが減少します |

233| `CLAUDE_CODE_MAX_RETRIES` | 失敗した API リクエストを再試行する回数をオーバーライドします（デフォルト：10）。{/* min-version: 2.1.186 */}v2.1.186 以降、最大 15 にキャップされます。無人セッションが長いアウタージを待つ必要がある場合は、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を設定します |237| `CLAUDE_CODE_MAX_RETRIES` | 失敗した API リクエストを再試行する回数をオーバーライドします（デフォルト：10）。{/* min-version: 2.1.186 */}v2.1.186 以降、最大 15 にキャップされます。{/* min-version: 2.1.199 */}v2.1.199 以降、`CLAUDE_CODE_RETRY_WATCHDOG` はデフォルト再試行回数を引き上げ、キャップを削除します。無人セッションが長いアウタージを待つ必要がある場合は、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を設定します |

235| `CLAUDE_CODE_MAX_TURNS` | 明示的な制限が渡されない場合、agentic ターン数をキャップします。[`--max-turns`](/ja/cli-reference#cli-flags) を渡すのと同等です。両方が設定されている場合、フラグが優先されます。正の整数ではない値は、キャップなしとして扱われるのではなく、スタートアップ時にエラーで拒否されます |239| `CLAUDE_CODE_MAX_TURNS` | 明示的な制限が渡されない場合、agentic ターン数をキャップします。[`--max-turns`](/ja/cli-reference#cli-flags) を渡すのと同等です。両方が設定されている場合、フラグが優先されます。正の整数ではない値は、キャップなしとして扱われるのではなく、スタートアップ時にエラーで拒否されます |

262| `CLAUDE_CODE_REMOTE_SESSION_ID` | [クラウドセッション](/ja/claude-code-on-the-web) で現在のセッションの ID に自動的に設定されます。セッショントランスクリプトへのリンクを構築するために読み取ります。[セッションに出力をリンク](/ja/claude-code-on-the-web#link-output-back-to-the-session) を参照してください |266| `CLAUDE_CODE_REMOTE_SESSION_ID` | [クラウドセッション](/ja/claude-code-on-the-web) で現在のセッションの ID に自動的に設定されます。セッショントランスクリプトへのリンクを構築するために読み取ります。[セッションに出力をリンク](/ja/claude-code-on-the-web#link-output-back-to-the-session) を参照してください |

263| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 前のセッションが途中で終了した場合に自動的に再開するには `1` に設定します。SDK モードで使用されるため、モデルは SDK がプロンプトを再送信する必要なく続行します |267| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 前のセッションが途中で終了した場合に自動的に再開するには `1` に設定します。SDK モードで使用されるため、モデルは SDK がプロンプトを再送信する必要なく続行します |

264| `CLAUDE_CODE_RESUME_PROMPT` | セッションが途中で終了した場合に再開するときに挿入される継続メッセージをオーバーライドします。デフォルトは `Continue from where you left off.` です。長時間実行されるエージェント用のスポーンスクリプトは、これをより指示的なブートメッセージに設定できます。空の文字列はデフォルトを使用します |268| `CLAUDE_CODE_RESUME_PROMPT` | セッションが途中で終了した場合に再開するときに挿入される継続メッセージをオーバーライドします。デフォルトは `Continue from where you left off.` です。長時間実行されるエージェント用のスポーンスクリプトは、これをより指示的なブートメッセージに設定できます。空の文字列はデフォルトを使用します |

265| `CLAUDE_CODE_RETRY_WATCHDOG` | {/* min-version: 2.1.186 */}eval ハーネス、CI ジョブ、リモートワーカーなどの無人セッション用に `1` に設定します。`429` と `529` キャパシティエラーを `CLAUDE_CODE_MAX_RETRIES` 試行後に失敗する代わりに無期限に再試行します。ウォッチドッグは試行間で最大 5 分までバックオフするか、レスポンスがレート制限リセット時間を持つ場合はリセットが制限されるまで待機するため、使用制限に達したセッションは残りのウィンドウを待機します。Claude Code v2.1.186 以降が必須です |269| `CLAUDE_CODE_RETRY_WATCHDOG` | {/* min-version: 2.1.186 */}eval ハーネス、CI ジョブ、リモートワーカーなどの無人セッション用に `1` に設定します。`429` と `529` キャパシティエラーを `CLAUDE_CODE_MAX_RETRIES` 試行後に失敗する代わりに無期限に再試行します。ウォッチドッグは試行間で最大 5 分までバックオフするか、レスポンスがレート制限リセット時間を持つ場合はリセットが制限されるまで待機するため、使用制限に達したセッションは残りのウィンドウを待機します。{/* min-version: 2.1.199 */}v2.1.199 以降、サーバーエラー、タイムアウト、ドロップされた接続などの他の一時的なエラーのデフォルト再試行回数も引き上げます。約 3 時間のバックオフまでの 300 回、`CLAUDE_CODE_MAX_RETRIES` を明示的に設定する場合は 15 のキャップを削除します。Claude Code v2.1.186 以降が必須です |

266| `CLAUDE_CODE_SAFE_MODE` | セーフモードで開始するには `1` に設定します：CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインディング、ステータスラインとファイル提案コマンド、LSP サーバー、自動メモリは読み込まれません。壊れた設定のトラブルシューティング用。管理設定ポリシーは依然として適用されます。ポリシー設定フック、ステータスライン、ファイル提案コマンドを含みます。管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシー設定 MCP サーバーは適用されません。[`--safe-mode`](/ja/cli-reference#cli-flags) を渡すのと同等です。直接スポーンされた子プロセスは変数を継承します |270| `CLAUDE_CODE_SAFE_MODE` | セーフモードで開始するには `1` に設定します：CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインディング、ステータスラインとファイル提案コマンド、LSP サーバー、自動メモリは読み込まれません。壊れた設定のトラブルシューティング用。管理設定ポリシーは依然として適用されます。ポリシー設定フック、ステータスライン、ファイル提案コマンドを含みます。管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシー設定 MCP サーバーは適用されません。[`--safe-mode`](/ja/cli-reference#cli-flags) を渡すのと同等です。直接スポーンされた子プロセスは変数を継承します |

267| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が設定されている場合、セッションごとに特定のスクリプトを呼び出すことができる回数を制限する JSON オブジェクト。キーはコマンドテキストに対して一致するサブストリングです。値は整数呼び出し制限です。例えば、`{"deploy.sh": 2}` は `deploy.sh` を最大 2 回呼び出すことを許可します。マッチングはサブストリングベースなので、`./scripts/deploy.sh $(evil)` などのシェル展開トリックは依然としてキャップに対してカウントされます。`xargs` または `find -exec` を通じた実行時ファンアウトは検出されません。これは多層防御制御です |271| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が設定されている場合、セッションごとに特定のスクリプトを呼び出すことができる回数を制限する JSON オブジェクト。キーはコマンドテキストに対して一致するサブストリングです。値は整数呼び出し制限です。例えば、`{"deploy.sh": 2}` は `deploy.sh` を最大 2 回呼び出すことを許可します。マッチングはサブストリングベースなので、`./scripts/deploy.sh $(evil)` などのシェル展開トリックは依然としてキャップに対してカウントされます。`xargs` または `find -exec` を通じた実行時ファンアウトは検出されません。これは多層防御制御です |

268| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリーンレンダリング](/ja/fullscreen#mouse-wheel-scrolling) でマウスホイールスクロール乗数を設定します。1～20 の値を受け入れます。`0.5` などの 1 未満の小数値で、加速されたトラックパッドとホイールスクロールを遅くします。ターミナルが増幅なしで 1 ノッチあたり 1 つのホイールイベントを送信する場合、`vim` に一致させるには `3` に設定します。JetBrains IDE ターミナルでは無視されます。Claude Code は独自のスクロール処理を使用します |272| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリーンレンダリング](/ja/fullscreen#mouse-wheel-scrolling) でマウスホイールスクロール乗数を設定します。1～20 の値を受け入れます。`0.5` などの 1 未満の小数値で、加速されたトラックパッドとホイールスクロールを遅くします。ターミナルが増幅なしで 1 ノッチあたり 1 つのホイールイベントを送信する場合、`vim` に一致させるには `3` に設定します。JetBrains IDE ターミナルでは無視されます。Claude Code は独自のスクロール処理を使用します |

345| `MAX_STRUCTURED_OUTPUT_RETRIES` | 非対話モード（`-p` フラグ）で [`--json-schema`](/ja/cli-reference#cli-flags) に対するモデルの応答検証が失敗した場合の再試行回数。デフォルト：5 |349| `MAX_STRUCTURED_OUTPUT_RETRIES` | 非対話モード（`-p` フラグ）で [`--json-schema`](/ja/cli-reference#cli-flags) に対するモデルの応答検証が失敗した場合の再試行回数。デフォルト：5 |

346| `MAX_THINKING_TOKENS` | [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) トークン予算をオーバーライドします。上限はモデルの [最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) から 1 を引いた値です。Anthropic API で思考を完全に無効にするには `0` に設定します。Fable 5 を除く。思考をオフにすることはできません。[サードパーティプロバイダー](/ja/third-party-integrations) では、`0` 同様にパラメータを省略するため、2 つの変数はそこで同じ動作をします。[適応的推論](/ja/model-config#adjust-effort-level) を備えたモデルでは、非ゼロ値の場合、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` を通じて適応的推論が無効にされない限り、予算は無視されます |350| `MAX_THINKING_TOKENS` | [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) トークン予算をオーバーライドします。上限はモデルの [最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) から 1 を引いた値です。Anthropic API で思考を完全に無効にするには `0` に設定します。Fable 5 を除く。思考をオフにすることはできません。[サードパーティプロバイダー](/ja/third-party-integrations) では、`0` 同様にパラメータを省略するため、2 つの変数はそこで同じ動作をします。[適応的推論](/ja/model-config#adjust-effort-level) を備えたモデルでは、非ゼロ値の場合、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` を通じて適応的推論が無効にされない限り、予算は無視されます |

347| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/ja/mcp#use-pre-configured-oauth-credentials) が必要な MCP サーバーの OAuth クライアントシークレット。`--client-secret` でサーバーを追加するときに対話的なプロンプトを回避します |351| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/ja/mcp#use-pre-configured-oauth-credentials) が必要な MCP サーバーの OAuth クライアントシークレット。`--client-secret` でサーバーを追加するときに対話的なプロンプトを回避します |

348| `MCP_CONNECTION_NONBLOCKING` | スタートアップが最初のクエリの前に MCP サーバーの接続を待機するかどうかを制御します。{/* min-version: 2.1.142 */}Claude Code v2.1.142 以降、MCP スタートアップはデフォルトで非ブロッキングです：サーバーはバックグラウンドで接続し、完了するとそのツールが利用可能になります。`0` に設定してブロッキング 5 秒接続待機を復元します。[`alwaysLoad: true`](/ja/mcp#exempt-a-server-from-deferral) で設定されたサーバーは、ツールが最初のプロンプトが構築されるときに存在する必要があるため、この設定に関係なく常にブロックします |352| `MCP_CONNECTION_NONBLOCKING` | スタートアップが最初のクエリの前に MCP サーバーの接続を待機するかどうかを制御します。{/* min-version: 2.1.142 */}Claude Code v2.1.142 以降、MCP スタートアップはデフォルトで非ブロッキングです：サーバーはバックグラウンドで接続し、完了するとそのツールが利用可能になります。`0` に設定してブロッキング 5 秒接続待機を復元します。[`alwaysLoad: true`](/ja/mcp#exempt-a-server-from-deferral) で設定されたサーバーは、ツールが最初のプロンプトが構築されるときに存在する必要があるため、この設定に関係なく常にブロックします |

349| `MCP_CONNECT_TIMEOUT_MS` | ブロッキング MCP スタートアップが接続バッチを待機する時間（ミリ秒）。ツールリストをスナップショットする前のデフォルト：5000。`MCP_CONNECTION_NONBLOCKING=0` の場合、または [`alwaysLoad: true`](/ja/mcp#exempt-a-server-from-deferral) でマークされたサーバーに適用されます。期限で保留中のサーバーはバックグラウンドで接続し続けますが、次のクエリまで表示されません。`MCP_TIMEOUT` とは異なります。これは個別のサーバーの接続試行を制限します |353| `MCP_CONNECT_TIMEOUT_MS` | ブロッキング MCP スタートアップが接続バッチを待機する時間（ミリ秒）。ツールリストをスナップショットする前のデフォルト：5000。`MCP_CONNECTION_NONBLOCKING=0` の場合、または [`alwaysLoad: true`](/ja/mcp#exempt-a-server-from-deferral) でマークされたサーバーに適用されます。期限で保留中のサーバーはバックグラウンドで接続し続けますが、次のクエリまで表示されません。`MCP_TIMEOUT` とは異なります。これは個別のサーバーの接続試行を制限します |

350| `MCP_OAUTH_CALLBACK_PORT` | OAuth リダイレクトコールバック用の固定ポート。[事前設定された認証情報](/ja/mcp#use-pre-configured-oauth-credentials) で MCP サーバーを追加する場合の `--callback-port` の代替 |354| `MCP_OAUTH_CALLBACK_PORT` | OAuth リダイレクトコールバック用の固定ポート。[事前設定された認証情報](/ja/mcp#use-pre-configured-oauth-credentials) で MCP サーバーを追加する場合の `--callback-port` の代替 |

errors.md +183 −35

Details

28| `Server error mid-response. The response above may be incomplete.` | [サーバーエラー](#the-response-above-may-be-incomplete) |

29| `Connection closed mid-response` / `Response stalled mid-stream` | [サーバーエラー](#the-response-above-may-be-incomplete) |

28| `<model> is temporarily unavailable, so auto mode cannot determine the safety of...` | [サーバーエラー](#auto-mode-cannot-determine-the-safety-of-an-action) |30| `<model> is temporarily unavailable, so auto mode cannot determine the safety of...` | [サーバーエラー](#auto-mode-cannot-determine-the-safety-of-an-action) |

29| `Auto mode could not evaluate this action and is blocking it for safety` | [サーバーエラー](#auto-mode-cannot-determine-the-safety-of-an-action) |31| `Auto mode could not evaluate this action and is blocking it for safety` | [サーバーエラー](#auto-mode-cannot-determine-the-safety-of-an-action) |

33| `Agent terminated early due to an API error` | [サーバーエラー](#agent-terminated-early-due-to-an-api-error) |

43| `Remote Control is only available when using Claude via api.anthropic.com` | [認証](#remote-control-requires-the-anthropic-api) |46| `Remote Control is only available when using Claude via api.anthropic.com` | [認証](#remote-control-requires-the-anthropic-api) |

44| `OAuth token revoked` / `OAuth token has expired` | [認証](#oauth-token-revoked-or-expired) |47| `OAuth token revoked` / `OAuth token has expired` | [認証](#oauth-token-revoked-or-expired) |

45| `does not meet scope requirement user:profile` | [認証](#oauth-scope-requirement) |48| `does not meet scope requirement user:profile` | [認証](#oauth-scope-requirement) |

49| `AWS credentials expired or invalid` | [認証](#aws-credentials-expired-or-invalid) |

50| `AWS authentication failed` | [認証](#aws-authentication-failed) |

54| `SSL certificate error (...)` during login or startup | [ネットワーク](#ssl-certificate-errors) |

63| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [リクエストエラー](#usage-policy-refusal) |69| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [リクエストエラー](#usage-policy-refusal) |

70| `--bg and --print conflict` | [コマンドラインエラー](#command-line-errors) |

64| レスポンスの品質が通常より低いように見える | [レスポンス品質](#responses-seem-lower-quality-than-usual) |71| レスポンスの品質が通常より低いように見える | [レスポンス品質](#responses-seem-lower-quality-than-usual) |

65 72

66<h2 id="automatic-retries">73<h2 id="automatic-retries">

67 自動リトライ74 自動リトライ

68</h2>75</h2>

69 76

70Claude Code は、エラーを表示する前に一時的な障害をリトライします。サーバーエラー、オーバーロードレスポンス、リクエストタイムアウト、一時的な 429 スロットル、および接続の切断はすべて、指数バックオフで最大 10 回リトライされます。リトライ中、スピナーは `Retrying in Ns · attempt x/y` カウントダウンを表示します。77Claude Code は、エラーを表示する前に一時的な障害をリトライします。サーバーエラー、オーバーロードレスポンス、リクエストタイムアウト、一時的な 429 スロットル、および接続の切断はすべて、指数バックオフで最大 10 回リトライされます。{/* min-version: 2.1.198 */}v2.1.198 以降では、これは、表示可能な出力がストリームされる前に応答の途中で切断される接続をカバーしています。Claude Code は同じバックオフでリクエストを再発行し、接続エラーで停止する代わりにターンが続行されます。{/* min-version: 2.1.199 */}v2.1.199 以降では、プランのクォータヘッダーを持たない一時的な 429 スロットルも、claude.ai サブスクリプションでサインインしている場合にリトライされます。それより前のバージョンでは、API キーおよびエンタープライズサインインの場合のみリトライされました。

792 つの障害クラスはリトライされません。リトライが成功できないためです。

81* {/* min-version: 2.1.199 */}v2.1.199 以降では、TLS 証明書検証の失敗（TLS 検査プロキシ、不足している `NODE_EXTRA_CA_CERTS` バンドル、または期限切れの証明書など）は最初の試行で失敗するため、完全なリトライ予算の後ではなく、修正がすぐに表示されます。[SSL 証明書エラー](#ssl-certificate-errors)を参照してください。ハンドシェイクタイムアウトなどの一時的な TLS 条件はまだリトライされます。

82* {/* min-version: 2.1.199 */}v2.1.199 以降では、Claude が既に表示可能な出力をストリームした後に到着するサーバーエラーは、部分的なレスポンスを保持し、リトライする代わりに[不完全なレスポンス通知](#the-response-above-may-be-incomplete)を追加します。同じツール呼び出しを 2 回実行する可能性があるためです。それより前のバージョンでは、部分的な出力を破棄し、ターン全体をエラーとして報告しました。

84リトライ中、スピナーはエラーラベルの後に `Retrying in Ns · attempt x/y` カウントダウンを表示します。ラベルは、すぐに対応できる障害の最初の試行からの具体的な理由を示します。ネットワークがダウンしている、TLS ハンドシェイクが失敗した、またはレート制限に達しました。他のエラーの場合は、最初は `API error` と表示されます。{/* min-version: 2.1.198 */}v2.1.198 以降では、3 番目の試行からの具体的な理由に切り替わるか、`CLAUDE_CODE_MAX_RETRIES` が 3 未満の試行を許可する場合は最終試行時に切り替わります。それより前のバージョンでは、最終試行時のみ切り替わります。

86{/* min-version: 2.1.198 */}v2.1.198 以降では、通常のスピナーチップはリトライ中に抑制されます。エラーの理由が明らかになると、障害が 529 オーバーロードの場合、カウントダウンの下の行はサービスステータスを確認する場所も示します。Anthropic API では `status.claude.com`、または他の設定ではメッセージに示されているプロバイダーまたはゲートウェイホスト。

71 87

72{/* min-version: 2.1.185 */}リクエストがまだ保留中の状態で、レスポンスストリームで 20 秒間データが到着しない場合、スピナーは `Waiting for API response · will retry in … · check your network` を表示します。これはリトライが開始される前です。リクエストはまだ失敗していません。カウントダウンは Claude Code が停止した接続を中止してリトライする時点まで実行されるため、データが再開されるか、リトライが成功するとバナーは自動的にクリアされます。v2.1.185 以降、閾値は 20 秒です。それより前のバージョンでは、異なる表現でバナーが 10 秒後に表示されます。すべての試行で再度表示される場合は、[ネットワークの問題](#unable-to-connect-to-api)として扱ってください。88{/* min-version: 2.1.185 */}リクエストがまだ保留中の状態で、レスポンスストリームで 20 秒間データが到着しない場合、スピナーは `Waiting for API response · will retry in … · check your network` を表示します。これはリトライが開始される前です。リクエストはまだ失敗していません。カウントダウンは Claude Code が停止した接続を中止してリトライする時点まで実行されるため、データが再開されるか、リトライが成功するとバナーは自動的にクリアされます。v2.1.185 以降、閾値は 20 秒です。それより前のバージョンでは、異なる表現でバナーが 10 秒後に表示されます。すべての試行で再度表示される場合は、[ネットワークの問題](#unable-to-connect-to-api)として扱ってください。

73 89

74このページのエラーの 1 つが表示されている場合、これらのリトライはすでに使い果たされています。これらの環境変数で動作をチューニングできます。90このページのエラーの 1 つが表示されている場合、これらのリトライはすでに使い果たされています。ただし、証明書検証の失敗など、リトライされないクラスに属する場合は除きます。これらの環境変数で動作をチューニングできます。

75 91

76| 変数 | デフォルト | 効果 |92| 変数 | デフォルト | 効果 |

~~77| :------------------------------------------- | :----- | :------------------------------------------------------------------------------------------------------- |~~93| :------------------------------------------- | :----- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

78| [`CLAUDE_CODE_MAX_RETRIES`](/ja/env-vars) | 10 | リトライ試行回数。{/* min-version: 2.1.186 */}v2.1.186 以降、15 に制限されています。スクリプトで障害をより速く表示するには低くします。 |94| [`CLAUDE_CODE_MAX_RETRIES`](/ja/env-vars) | 10 | リトライ試行回数。{/* min-version: 2.1.186 */}v2.1.186 以降、15 に制限されています。{/* min-version: 2.1.199 */}v2.1.199 以降では `CLAUDE_CODE_RETRY_WATCHDOG` がデフォルトを上げ、キャップを削除します。スクリプトで障害をより速く表示するには低くします。 |

79| [`CLAUDE_CODE_RETRY_WATCHDOG`](/ja/env-vars) | 未設定 | CI ジョブなどの無人セッションで `1` に設定して、`CLAUDE_CODE_MAX_RETRIES` 試行後に失敗する代わりに、`429` および `529` キャパシティエラーを無限にリトライします。 |95| [`CLAUDE_CODE_RETRY_WATCHDOG`](/ja/env-vars) | 未設定 | CI ジョブなどの無人セッションで `1` に設定して、`CLAUDE_CODE_MAX_RETRIES` 試行後に失敗する代わりに、`429` および `529` キャパシティエラーを無限にリトライします。{/* min-version: 2.1.199 */}v2.1.199 以降では、サーバーエラー、タイムアウト、接続の切断などの他の一時的なエラーのデフォルトリトライ数も上げ、バックオフの約 3 時間である 300 に上げ、変数を明示的に設定した場合は `CLAUDE_CODE_MAX_RETRIES` の 15 のキャップを削除します。 |

80| [`API_TIMEOUT_MS`](/ja/env-vars) | 600000 | リクエストごとのタイムアウト（ミリ秒単位）。遅いネットワークまたはプロキシの場合は高くします。 |96| [`API_TIMEOUT_MS`](/ja/env-vars) | 600000 | リクエストごとのタイムアウト（ミリ秒単位）。遅いネットワークまたはプロキシの場合は高くします。 |

81 97

82<h2 id="server-errors">98<h2 id="server-errors">

89 API Error: 500 Internal server error105 API Error: 500 Internal server error

90</h3>106</h3>

91 107

92Claude Code は、5xx レスポンスに対してステータスコードと API のエラーメッセージを表示します。以下の例は Anthropic API での 500 レスポンスを示しています：108Claude Code は、5xx レスポンスに対してステータスコードと API のエラーメッセージを表示します。以下の例は Anthropic API での 500 レスポンスを示しています。

93 109

94```text theme={null}110```text theme={null}

95API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.111API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

103 119

104* [status.claude.com](https://status.claude.com) またはメッセージに示されているプロバイダーのステータスページで、アクティブなインシデントを確認してください120* [status.claude.com](https://status.claude.com) またはメッセージに示されているプロバイダーのステータスページで、アクティブなインシデントを確認してください

105* 1 分待ってからメッセージを再度送信してください。元のメッセージはまだ会話に残っているため、長いプロンプトの場合は全体を貼り付ける代わりに `try again` と入力できます。121* 1 分待ってからメッセージを再度送信してください。元のメッセージはまだ会話に残っているため、長いプロンプトの場合は全体を貼り付ける代わりに `try again` と入力できます。

106* エラーが投稿されたインシデントなしで続く場合は、`/feedback` を実行して、Anthropic がリクエスト詳細で調査できるようにしてください。環境で `/feedback` が利用できない場合は、[エラーを報告する](#report-an-error) を参照してください。122* エラーが投稿されたインシデントなしで続く場合は、`/feedback` を実行して、Anthropic がリクエスト詳細で調査できるようにしてください。環境で `/feedback` が利用できない場合は、[エラーを報告する](#report-an-error)を参照してください。

107 123

108<h3 id="api-error-repeated-529-overloaded-errors">124<h3 id="api-error-repeated-529-overloaded-errors">

109 API Error: Repeated 529 Overloaded errors125 API Error: Repeated 529 Overloaded errors

110</h3>126</h3>

111 127

112API は、すべてのユーザー全体で一時的に容量に達しています。Claude Code は、このメッセージを表示する前に既に数回リトライしています：128API は、すべてのユーザー全体で一時的に容量に達しています。Claude Code は、このメッセージを表示する前に既に数回リトライしています。

113 129

114```text theme={null}130```text theme={null}

115API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.131API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

116```132```

117 133

118末尾の文は、500 エラーと同じ方法でプロバイダーによって異なります。529 は使用制限ではなく、クォータに対してカウントされません。134末尾の文は、500 エラーと同じ方法でプロバイダーによって異なります。

135

136529 は使用制限ではなく、クォータに対してカウントされません。

119 137

120**対応方法：**138**対応方法：**

121 139

139 157

140* リクエストを再試行してください158* リクエストを再試行してください

141* 長時間実行されるタスクの場合は、作業をより小さいプロンプトに分割してください159* 長時間実行されるタスクの場合は、作業をより小さいプロンプトに分割してください

142* 遅いネットワークまたはプロキシが原因の場合は、[自動リトライ](#automatic-retries) で説明されているように `API_TIMEOUT_MS` を上げてください160* 遅いネットワークまたはプロキシが原因の場合は、[自動リトライ](#automatic-retries)で説明されているように `API_TIMEOUT_MS` を上げてください

143* タイムアウトが頻繁で、ネットワークが正常な場合は、以下の[ネットワークと接続エラー](#network-and-connection-errors) を参照してください161* タイムアウトが頻繁で、ネットワークが正常な場合は、以下の[ネットワークと接続エラー](#network-and-connection-errors)を参照してください

162

163<h3 id="the-response-above-may-be-incomplete">

164 The response above may be incomplete

165</h3>

166

167ストリーミングレスポンスが Claude が既に表示可能な出力を生成した後に失敗しました。リクエストを再送信すると同じツール呼び出しが 2 回実行される可能性があるため、Claude Code は既にストリームされたものを保持し、ターンを破棄する代わりに不完全なレスポンス通知を追加します。表示されるバリアントは原因を示します。

168

169```text theme={null}

170API Error: Server error mid-response. The response above may be incomplete.

171API Error: Connection closed mid-response. The response above may be incomplete.

172API Error: Response stalled mid-stream. The response above may be incomplete.

173```

174

175* {/* min-version: 2.1.199 */}` Server error mid-response`：ストリーム中のオーバーロードまたは 5xx サーバーエラー。このバリアントには Claude Code v2.1.199 以降が必要です。それより前では、そのケースは部分的な出力を破棄し、ターン全体をエラーとして報告しました。

176* `Connection closed mid-response`：接続が切断されました。

177* `Response stalled mid-stream`：ストリームがデータの送信を停止しました。

178

179**対応方法：**

180

181* ストリームされたレスポンスを読んでください。何も失われていませんが、最後の文またはツール呼び出しが不足している可能性があります。

182* `continue` で返信して、Claude が停止した場所から再開するようにしてください

183* 表示可能な出力の前に同じエラーが表示される場合、Claude Code はそれを最終化する代わりにリクエストをリトライします。[自動リトライ](#automatic-retries)を参照してください。

144 184

145<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">185<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">

146 Auto mode cannot determine the safety of an action186 Auto mode cannot determine the safety of an action

147</h3>187</h3>

148 188

149[auto mode](/ja/permission-modes#eliminate-prompts-with-auto-mode) がアクションを分類するために使用するモデルが決定を生成できなかったため、auto mode はアクションを自動的に承認しませんでした。表示されるメッセージは、分類器が失敗した理由によって異なります。189[auto mode](/ja/permission-modes#eliminate-prompts-with-auto-mode)がアクションを分類するために使用するモデルが決定を生成できなかったため、auto mode はアクションを自動的に承認しませんでした。表示されるメッセージは、分類器が失敗した理由によって異なります。

150 190

151読み取り、検索、および作業ディレクトリ内の編集は分類器をスキップするため、これらすべてのケースで機能し続けます。191読み取り、検索、および作業ディレクトリ内の編集は分類器をスキップするため、これらすべてのケースで機能し続けます。

152 192

160 200

161* 数秒後に再試行してください。Claude は同じメッセージを見て、通常は自動的に再試行します201* 数秒後に再試行してください。Claude は同じメッセージを見て、通常は自動的に再試行します

162* リトライが失敗し続ける場合は、読み取り専用タスクを続行し、後でブロックされたアクションに戻ってください202* リトライが失敗し続ける場合は、読み取り専用タスクを続行し、後でブロックされたアクションに戻ってください

163* これは一時的であり、[auto mode 適格性](/ja/permission-modes#eliminate-prompts-with-auto-mode) とは無関係です。設定を変更する必要はありません203* これは一時的であり、[auto mode 適格性](/ja/permission-modes#eliminate-prompts-with-auto-mode)とは無関係です。設定を変更する必要はありません

164 204

165分類器が解析不可能なレスポンスを返した場合：205分類器が解析不可能なレスポンスを返した場合：

166 206

173* アクションを再試行してください。これは通常、次の試行で成功します213* アクションを再試行してください。これは通常、次の試行で成功します

174* `claude --debug` を実行してアクションを繰り返し、デバッグログで基になる分類器レスポンスを確認してください214* `claude --debug` を実行してアクションを繰り返し、デバッグログで基になる分類器レスポンスを確認してください

175 215

216会話の前のコンテンツが原因で、別の API セーフティチェックが分類器リクエストをブロックした場合：

217

218```text theme={null}

219Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details

220```

221

222**対応方法：**

223

224* これはアクションについての決定ではありません。会話に既にあるコンテンツが、auto mode が会話を分類器に送信したときに API のセーフティフィルターをトリガーしました

225* リトライは役に立ちません。同じ会話コンテンツがフィルターを再度トリガーします

226* 別の[権限モード](/ja/permission-modes)に切り替えて、プロンプトされたときにアクションを承認できるようにするか、トリガーコンテンツなしで新しい会話を開始してください

227

176会話が分類器のコンテキストウィンドウより大きくなった場合：228会話が分類器のコンテキストウィンドウより大きくなった場合：

177 229

178```text theme={null}230```text theme={null}

179Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)231Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

180```232```

181 233

182インタラクティブセッションでは、auto mode はそのアクションに対して通常の権限プロンプトにフォールバックするため、手動で承認または拒否できます。[非インタラクティブモード](/ja/headless) では、トランスクリプトのみが増加し、リトライが成功できないため、実行が中止されます。234インタラクティブセッションでは、auto mode はそのアクションに対して通常の権限プロンプトにフォールバックするため、手動で承認または拒否できます。[非インタラクティブモード](/ja/headless)では、トランスクリプトのみが増加し、リトライが成功できないため、実行が中止されます。

183 235

184**対応方法：**236**対応方法：**

185 237

186* 表示されるプロンプトでアクションを承認または拒否してください238* 表示されるプロンプトでアクションを承認または拒否してください

187* `/compact` を実行して会話サイズを削減し、後続のアクションが分類器ウィンドウ内に収まるようにしてください239* `/compact` を実行して会話サイズを削減し、後続のアクションが分類器ウィンドウ内に収まるようにしてください

188 240

241<h3 id="agent-terminated-early-due-to-an-api-error">

242 Agent terminated early due to an API error

243</h3>

244

245{/* min-version: 2.1.199 */}[サブエージェント](/ja/sub-agents)の API リクエストが終了的に失敗しました。たとえば、使用制限に達したか、サーバーエラーのリトライが使い果たされたため、サブエージェントはタスクを完了する前に停止しました。このメッセージには Claude Code v2.1.199 以降が必要です。それより前では、API エラーテキストはサブエージェントの結果であるかのように Claude に返されました。

246

247```text theme={null}

248Agent terminated early due to an API error: <error detail>

249```

250

251**対応方法：**

252

253* コロンの後のエラー詳細をこのページの独自のセクション（[使用制限](#usage-limits)または[サーバーエラー](#server-errors)など）と照合し、そのセクションの手順に従ってください

254* 基になるエラーがクリアされたら、Claude にタスクを再試行するよう依頼するか、[サブエージェントを再開](/ja/sub-agents#resume-subagents)してください

255

256レート制限、オーバーロード、またはサーバーエラーがすでに出力を生成したフォアグラウンドサブエージェントを中断する場合、Claude はその部分的な出力を不完全としてマークされて受け取り、このエラーではなく受け取ります。[サブエージェント内の API エラー](/ja/sub-agents#api-errors-in-subagents)を参照してください。

257

189<h2 id="usage-limits">258<h2 id="usage-limits">

190 使用制限259 使用制限

191</h2>260</h2>

193これらのエラーは、アカウントまたはプランに関連するクォータに達したことを意味します。これらは、すべてに影響する[サーバーエラー](#server-errors)とは異なります。262これらのエラーは、アカウントまたはプランに関連するクォータに達したことを意味します。これらは、すべてに影響する[サーバーエラー](#server-errors)とは異なります。

194 263

195<h3 id="you’ve-hit-your-session-limit">264<h3 id="you’ve-hit-your-session-limit">

196 セッション制限に達しました265 You've hit your session limit

197</h3>266</h3>

198 267

199サブスクリプションプランには、ローリング使用許容量が含まれています。使い果たされると、次のいずれかのメッセージが表示されます。268サブスクリプションプランには、ローリング使用許容量が含まれています。使い果たされると、次のいずれかのメッセージが表示されます。

210 279

211* エラーに表示されているリセット時刻を待ってください280* エラーに表示されているリセット時刻を待ってください

212* `/usage` を実行して、プランの制限とリセット時刻を確認してください281* `/usage` を実行して、プランの制限とリセット時刻を確認してください

213* `/usage-credits` を実行して、Pro および Max で追加使用量を購入するか、Team および Enterprise で管理者にリクエストしてください。[有料プランの使用量クレジット](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)を参照して、これがどのように請求されるかを確認してください。282* `/usage-credits` を実行して、Pro および Max で追加使用量を購入するか、Team および Enterprise で管理者にリクエストしてください。[有料プランの使用量クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を参照して、これがどのように請求されるかを確認してください。

214* プランをアップグレードしてより高いベース制限を取得するには、[claude.com/pricing](https://claude.com/pricing)を参照してください283* プランをアップグレードしてより高いベース制限を取得するには、[claude.com/pricing](https://claude.com/pricing)を参照してください

215 284

216制限に達する前に残りの許容量を監視するには、`rate_limits` フィールドを[カスタムステータスライン](/ja/statusline#rate-limit-usage)に追加するか、デスクトップアプリでモデルピッカーの横にある[使用量リング](/ja/desktop#check-usage)をクリックしてください。285制限に達する前に残りの許容量を監視するには、`rate_limits` フィールドを[カスタムステータスライン](/ja/statusline#rate-limit-usage)に追加するか、デスクトップアプリでモデルピッカーの横にある[使用量リング](/ja/desktop#check-usage)をクリックしてください。

217 286

218<h3 id="usage-credits-required-for-1m-context">287<h3 id="usage-credits-required-for-1m-context">

219 1M コンテキストに使用量クレジットが必要です288 Usage credits required for 1M context

220</h3>289</h3>

221 290

222選択されたモデルは 1M トークンの拡張コンテキストウィンドウを使用しており、お客様のプランではこれを使用量クレジットを通じてのみ含めています。291選択されたモデルは 1M トークンの拡張コンテキストウィンドウを使用しており、お客様のプランではこれを使用量クレジットを通じてのみ含めています。

237* モデルピッカーから 1M バリアントを完全に削除するには、[`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/ja/env-vars)を設定してください306* モデルピッカーから 1M バリアントを完全に削除するには、[`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/ja/env-vars)を設定してください

238 307

239<h3 id="server-is-temporarily-limiting-requests">308<h3 id="server-is-temporarily-limiting-requests">

240 サーバーが一時的にリクエストを制限しています309 Server is temporarily limiting requests

241</h3>310</h3>

242 311

243API は、プランクォータとは無関係の短期的なスロットルを適用しました。312API は、プランクォータとは無関係の短期的なスロットルを適用しました。

246API Error: Server is temporarily limiting requests (not your usage limit)315API Error: Server is temporarily limiting requests (not your usage limit)

247```316```

248 317

249これは、表示される前に[自動的にリトライ](#automatic-retries)されます。318Claude Code は、これらが実際の制限レスポンスが持つ統一クォータヘッダーの不在によって区別されます。{/* min-version: 2.1.199 */}v2.1.199 以降では、これは[自動的にリトライ](#automatic-retries)されます。認証方法に関係なく、表示される前にバックオフします。それより前のバージョンでは、claude.ai サブスクリプションでサインインしたセッションは最初の発生時にターンに失敗しました。API キーおよびエンタープライズサインインのみがリトライしました。

250 319

251**対応方法：**320**対応方法：**

252 321

254* 続く場合は [status.claude.com](https://status.claude.com)を確認してください323* 続く場合は [status.claude.com](https://status.claude.com)を確認してください

255 324

256<h3 id="request-rejected-429">325<h3 id="request-rejected-429">

257 リクエストが拒否されました（429）326 Request rejected (429)

258</h3>327</h3>

259 328

260API キー、Amazon Bedrock プロジェクト、または Google Vertex AI プロジェクト用に設定されたレート制限に達しました。329API キー、Amazon Bedrock プロジェクト、または Google Vertex AI プロジェクト用に設定されたレート制限に達しました。

269 338

270* `/status` を実行して、アクティブな認証情報が予想されるものであることを確認してください。環境内の迷走した `ANTHROPIC_API_KEY` は、サブスクリプションではなく低層キーを通じてリクエストをルーティングできます。339* `/status` を実行して、アクティブな認証情報が予想されるものであることを確認してください。環境内の迷走した `ANTHROPIC_API_KEY` は、サブスクリプションではなく低層キーを通じてリクエストをルーティングできます。

271* プロバイダーコンソールでアクティブな制限を確認し、必要に応じてより高い層をリクエストしてください340* プロバイダーコンソールでアクティブな制限を確認し、必要に応じてより高い層をリクエストしてください

272* Anthropic API キーについては、[レート制限リファレンス](https://platform.claude.com/docs/ja/api/rate-limits)を参照して、層がどのように機能し、ワークスペースごとのキャップを設定する方法を確認してください341* Anthropic API キーについては、[レート制限リファレンス](https://platform.claude.com/docs/en/api/rate-limits)を参照して、層がどのように機能し、ワークスペースごとのキャップを設定する方法を確認してください

273* 同時実行性を削減します。[`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/ja/env-vars)を低くするか、多くの並列サブエージェントの実行を避けるか、高ボリュームのスクリプト実行用に `/model` で小さいモデルに切り替えてください342* 同時実行性を削減します。[`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/ja/env-vars)を低くするか、多くの並列サブエージェントの実行を避けるか、高ボリュームのスクリプト実行用に `/model` で小さいモデルに切り替えてください

274 343

275<h3 id="credit-balance-is-too-low">344<h3 id="credit-balance-is-too-low">

276 クレジット残高が不足しています345 Credit balance is too low

277</h3>346</h3>

278 347

279Console 組織は、プリペイドクレジットを使い果たしました。348Console 組織は、プリペイドクレジットを使い果たしました。

373 Your organization has disabled API key authentication442 Your organization has disabled API key authentication

374</h3>443</h3>

375 444

445{/* min-version: 2.1.169 */}}

376Console 組織の管理者が API キー認証をオフにしているため、API が Claude Code が送信しているキーを拒否しています。`·` の後の復旧ヒントは、キーがどこから来たかによって異なります。446Console 組織の管理者が API キー認証をオフにしているため、API が Claude Code が送信しているキーを拒否しています。`·` の後の復旧ヒントは、キーがどこから来たかによって異なります。

377 447

378```text theme={null}448```text theme={null}

477 547

478* `/login` を実行して、現在のスコープで新しいトークンを作成してください。ログアウトする必要はありません。548* `/login` を実行して、現在のスコープで新しいトークンを作成してください。ログアウトする必要はありません。

479 549

550<h3 id="aws-credentials-expired-or-invalid">

551 AWS credentials expired or invalid

552</h3>

553

554{/* min-version: 2.1.198 */}}このメッセージには Claude Code v2.1.198 以降が必要であり、[`awsAuthRefresh`](/ja/amazon-bedrock#advanced-credential-configuration)が設定ファイルで設定されている場合のみ表示されます。AWS セッショントークンが期限切れになったか、拒否されました。Claude Code が既に実行した自動リフレッシュが、API が受け入れる認証情報を生成しませんでした。これは [Claude Platform on AWS](/ja/claude-platform-on-aws) または [Mantle エンドポイント](/ja/amazon-bedrock#use-the-mantle-endpoint)からの 401 に表示されます。これらのプロバイダーが期限切れのセキュリティトークンを報告する方法です。

555

556中央のアクションヒントは設定からの `awsAuthRefresh` コマンドを示すため、異なります。安定した部分は先頭の `AWS credentials expired or invalid` です。

557

558```text theme={null}

559AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...

560```

561

562`awsAuthRefresh` が設定されていない場合、同じ 401 は代わりに汎用の `Please run /login` メッセージを表示し、AWS 認証情報をリフレッシュできません。

563

564**対応方法：**

565

566* メッセージに示されている `awsAuthRefresh` コマンド（`aws sso login --profile myprofile` など）を別のターミナルで実行し、ブラウザサインインを完了してから、再試行してください

567* インタラクティブセッションでは、`/login` を実行し、**3 番目のパーティプラットフォーム**を選択してから、**3 番目のパーティプラットフォームを使用**の下で **Claude Platform on AWS · refresh credentials** を選択して、Claude Code を再起動せずに同じコマンドを実行してください。[AWS 認証情報を設定](/ja/claude-platform-on-aws#1-configure-aws-credentials)を参照してください

568* リフレッシュコマンドが成功した後もエラーが繰り返される場合は、同じシェルとプロファイルで `aws sts get-caller-identity` を使用して Claude Code の外で ID が有効であることを確認してください

569

570<h3 id="aws-authentication-failed">

571 AWS authentication failed

572</h3>

573

574{/* min-version: 2.1.198 */}}このメッセージには Claude Code v2.1.198 以降が必要であり、[`awsAuthRefresh`](/ja/amazon-bedrock#advanced-credential-configuration)が設定ファイルで設定されている場合のみ表示されます。AWS プロバイダーが 403 を返したか、[Amazon Bedrock](/ja/amazon-bedrock)が 401 を返しました。

575

576Claude Code はどの原因に当たったかを判断できません。Amazon Bedrock は期限切れのセキュリティトークンを 403 として報告しますが、403 は `AccessDeniedException` からの不足している IAM 権限やアカウントで有効になっていないモデルなどの認可拒否も報告する方法です。

577

578Amazon Bedrock からの 401 も [AWS credentials expired or invalid](#aws-credentials-expired-or-invalid) の下ではなくここに着地します。Bedrock は期限切れのトークンを 401 として報告しないためです。そのエンドポイントからの 401 は通常、企業プロキシなど、リクエストパスの他の何かから来ます。

579

580認証情報リフレッシュは期限切れのトークンを修正し、他の原因を修正できないため、メッセージは両方を提供します。

581

582```text theme={null}

583AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...

584```

585

586中央のアクションヒントは設定からの `awsAuthRefresh` コマンドを示すため、異なります。安定した部分は先頭の `AWS authentication failed` です。

587

588**対応方法：**

589

590* メッセージに示されている `awsAuthRefresh` コマンドまたは `aws sso login` を実行します。期限切れの認証情報が原因である可能性があります

591* 認証情報が最新の場合は、[IAM 設定](/ja/amazon-bedrock#iam-configuration)の IAM 権限が使用している ID に接続されていることを確認し、選択したモデルがアカウントとリージョンで有効になっていることを確認してください

592* `aws sts get-caller-identity` を実行して、リクエストが使用する ID を確認してください。古い `AWS_PROFILE` またはデフォルトプロファイルは、権限の不一致の一般的な原因です

593

480<h2 id="network-and-connection-errors">594<h2 id="network-and-connection-errors">

481 ネットワークと接続エラー595 ネットワークと接続エラー

482</h2>596</h2>

483 597

484これらのエラーは、Claude Code がネットワークリクエストで API に到達できなかったことを意味します。これらは通常、ローカルネットワーク、プロキシ、またはファイアウォール、あるいはクラウド環境のネットワークポリシーから発生します。598これらのエラーは、Claude Code からのネットワークリクエストが宛先に到達できなかったことを意味します。これらは通常、ローカルネットワーク、プロキシ、またはファイアウォール、あるいはクラウド環境のネットワークポリシーから発生します。

485 599

486<h3 id="unable-to-connect-to-api">600<h3 id="unable-to-connect-to-api">

487 API に接続できない601 Unable to connect to API

488</h3>602</h3>

489 603

490API への TCP 接続に失敗したか、完了しませんでした。604API への TCP 接続に失敗したか、完了しませんでした。

515* Docker Desktop および同様のコンテナランタイムは、アウトバウンドトラフィックをインターセプトできます。それらを終了して再試行し、これを除外してください。629* Docker Desktop および同様のコンテナランタイムは、アウトバウンドトラフィックをインターセプトできます。それらを終了して再試行し、これを除外してください。

516 630

517<h3 id="ssl-certificate-errors">631<h3 id="ssl-certificate-errors">

518 SSL 証明書エラー632 SSL certificate errors

519</h3>633</h3>

520 634

521ネットワーク上のプロキシまたはセキュリティアプライアンスが、独自の証明書で TLS トラフィックをインターセプトしており、Claude Code がそれを信頼していません。635ネットワーク上のプロキシまたはセキュリティアプライアンスが、独自の証明書で TLS トラフィックをインターセプトしており、Claude Code がそれを信頼していません。

525Unable to connect to API: Self-signed certificate detected639Unable to connect to API: Self-signed certificate detected

526```640```

527 641

642{/* min-version: 2.1.199 */}}v2.1.199 以降では、証明書検証の失敗はリトライされないため、このエラーは完全な[リトライ予算](#automatic-retries)の後ではなく最初の試行で表示されます。それより前のバージョンでは、表示する前に数分間リトライしました。ハンドシェイクタイムアウトなどの一時的な TLS 条件はまだリトライされます。

643

644`/login` とスタートアップ接続チェック中に、同じ障害は OpenSSL コードと修正がインラインで報告されます。

645

646```text theme={null}

647SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run /doctor for details.

648```

649

528**対応方法：**650**対応方法：**

529 651

530* 組織の CA バンドルをエクスポートし、`NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem` で Claude Code をポイントしてください652* 組織の CA バンドルをエクスポートし、`NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem` で Claude Code をポイントしてください

532* 証明書検証を完全に無効にする `NODE_TLS_REJECT_UNAUTHORIZED=0` を設定しないでください654* 証明書検証を完全に無効にする `NODE_TLS_REJECT_UNAUTHORIZED=0` を設定しないでください

533 655

534<h3 id="host-not-allowed-in-a-cloud-session">656<h3 id="host-not-allowed-in-a-cloud-session">

535 クラウドセッションでホストが許可されていない657 Host not allowed in a cloud session

536</h3>658</h3>

537 659

538クラウドセッションまたはルーチンからのアウトバウンド HTTP リクエストが、環境のネットワークポリシーによってブロックされました。660クラウドセッションまたはルーチンからのアウトバウンド HTTP リクエストが、環境のネットワークポリシーによってブロックされました。

627API Error: 400 ... image dimensions exceed max allowed size749API Error: 400 ... image dimensions exceed max allowed size

628```750```

629 751

630{/* min-version: 2.1.142 */}Claude Code は処理できない画像をテキストプレースホルダーに置き換えて再試行するため、後続のメッセージは成功します。v2.1.142 より前のバージョンでは、貼り付けられた画像は会話に残る可能性があり、後続のすべてのメッセージで同じエラーが繰り返される可能性があります。これらのバージョンで復旧するには、Esc を 2 回押して、画像が追加されたターンを過ぎて戻ってください。752{/* min-version: 2.1.142 */}}Claude Code は処理できない画像をテキストプレースホルダーに置き換えて再試行するため、後続のメッセージは成功します。v2.1.142 より前のバージョンでは、貼り付けられた画像は会話に残る可能性があり、後続のすべてのメッセージで同じエラーが繰り返される可能性があります。これらのバージョンで復旧するには、Esc を 2 回押して、画像が追加されたターンを過ぎて戻ってください。

631 753

632**対応方法：**754**対応方法：**

633 755

694 There's an issue with the selected model816 There's an issue with the selected model

695</h3>817</h3>

696 818

819{/* min-version: 2.1.160 */}}

697設定されたモデル名が認識されなかったか、アカウントがそれへのアクセスを持っていません。v2.1.160 以降、表示される末尾のヒントはサーフェスによって異なります。820設定されたモデル名が認識されなかったか、アカウントがそれへのアクセスを持っていません。v2.1.160 以降、表示される末尾のヒントはサーフェスによって異なります。

698 821

699```text theme={null}822```text theme={null}

729 Model is restricted by your organization's settings852 Model is restricted by your organization's settings

730</h3>853</h3>

731 854

855{/* min-version: 2.1.187 */}}

732組織の管理者が Claude Console でこのモデルを無効にしたか、管理設定の [`availableModels`](/ja/model-config#restrict-model-selection) 許可リストで除外されています。制限されたモデルが `--model`、`ANTHROPIC_MODEL`、または `model` 設定で設定された場合、Claude Code は許可されたモデルに置き換えて続行します。制限されたモデルに対して `/model <name>` を入力すると、`Run /model to choose a different model.` で拒否され、セッションは現在のモデルを保持します。856組織の管理者が Claude Console でこのモデルを無効にしたか、管理設定の [`availableModels`](/ja/model-config#restrict-model-selection) 許可リストで除外されています。制限されたモデルが `--model`、`ANTHROPIC_MODEL`、または `model` 設定で設定された場合、Claude Code は許可されたモデルに置き換えて続行します。制限されたモデルに対して `/model <name>` を入力すると、`Run /model to choose a different model.` で拒否され、セッションは現在のモデルを保持します。

733 857

734```text theme={null}858```text theme={null}

753 877

754**対応方法：**878**対応方法：**

755 879

880{/* min-version: 2.1.197 */}}

881

756* `claude update` を実行して Claude Code を再起動してください。Opus 4.7 は v2.1.111 以降が必要です。Opus 4.8 は v2.1.154 以降が必要です。Sonnet 5 は v2.1.197 以降が必要です882* `claude update` を実行して Claude Code を再起動してください。Opus 4.7 は v2.1.111 以降が必要です。Opus 4.8 は v2.1.154 以降が必要です。Sonnet 5 は v2.1.197 以降が必要です

757* アップグレードできない場合は、`/model` を実行して Opus 4.6 または Sonnet 4.6 を選択してください883* アップグレードできない場合は、`/model` を実行して Opus 4.6 または Sonnet 4.6 を選択してください

758* {/* min-version: agent-sdk@0.3.197 */}[Agent SDK](/ja/agent-sdk/overview)でこれに遭遇した場合は、SDK パッケージをアップグレードしてください。Opus 4.8 は TypeScript SDK v0.3.154 以降と Python SDK v0.2.88 以降が必要です。Sonnet 5 は TypeScript SDK v0.3.197 以降が必要です884* {/* min-version: agent-sdk@0.3.197 */}}[Agent SDK](/ja/agent-sdk/overview)でこれに遭遇した場合は、SDK パッケージをアップグレードしてください。Opus 4.8 は TypeScript SDK v0.3.154 以降と Python SDK v0.2.88 以降が必要です。Sonnet 5 は TypeScript SDK v0.3.197 以降が必要です

759 885

760<h3 id="thinking-budget-exceeds-output-limit">886<h3 id="thinking-budget-exceeds-output-limit">

761 Thinking budget exceeds output limit887 Thinking budget exceeds output limit

790 916

791**対応方法：**917**対応方法：**

792 918

793* {/* max-version: 2.1.155 */}Opus 4.7 または Opus 4.8 を使用している場合は、まず `claude update` を実行してください。v2.1.156 より前のバージョンは、通常のツール使用中にこのエラーをトリガーでき、`/rewind` はそれをクリアしません。919* {/* max-version: 2.1.155 */}}Opus 4.7 または Opus 4.8 を使用している場合は、まず `claude update` を実行してください。v2.1.156 より前のバージョンは、通常のツール使用中にこのエラーをトリガーでき、`/rewind` はそれをクリアしません。

794* `/rewind` を実行するか、Esc を 2 回押して、破損したターンの前のチェックポイントに戻り、そこから続行してください。[チェックポイント](/ja/checkpointing)を参照して、チェックポイントがどのように作成および復元されるかを確認してください。920* `/rewind` を実行するか、Esc を 2 回押して、破損したターンの前のチェックポイントに戻り、そこから続行してください。[チェックポイント](/ja/checkpointing)を参照して、チェックポイントがどのように作成および復元されるかを確認してください。

795 921

796<h3 id="usage-policy-refusal">922<h3 id="usage-policy-refusal">

811* どのターンが原因かを特定できない場合は、`/clear` を実行して同じプロジェクト内で新しい会話を開始してください。以前の会話はディスクに保存され、`/resume` で利用可能なままです。937* どのターンが原因かを特定できない場合は、`/clear` を実行して同じプロジェクト内で新しい会話を開始してください。以前の会話はディスクに保存され、`/resume` で利用可能なままです。

812* [非対話型モード](/ja/headless)（`-p`）では、巻き戻しが利用できないため、言い換えたプロンプトで再試行するか、`--continue` なしで新しいセッションを開始してください。ポリシーチェックはモデルによって異なるため、`--model` で別のモデルに切り替えると、場合によっては拒否が解決される可能性があります。938* [非対話型モード](/ja/headless)（`-p`）では、巻き戻しが利用できないため、言い換えたプロンプトで再試行するか、`--continue` なしで新しいセッションを開始してください。ポリシーチェックはモデルによって異なるため、`--model` で別のモデルに切り替えると、場合によっては拒否が解決される可能性があります。

813 939

940<h2 id="command-line-errors">

941 Command-line errors

942</h2>

943

944これらのエラーは、Claude Code の `claude` コマンドラインの独自の検証から発生します。Claude Code はそれらを直ちに出力し、セッションを作成したり、API リクエストを送信したりする前に出力します。

945

946<h3 id="conflict-between-bg-and-print">

947 Conflict between --bg and --print

948</h3>

949

950{/* min-version: 2.1.198 */}}

951このメッセージには Claude Code v2.1.198 以降が必要です。同じ `claude` 呼び出しで `--bg` を `-p` または `--print` と組み合わせました。`--bg` は[バックグラウンドセッション](/ja/agent-view#from-your-shell)を開始し、後で `claude agents` で接続します。`--print` は[非対話的に](/ja/headless)実行され、`claude agents` が接続するインタラクティブセッションを開始しません。v2.1.198 より前では、この組み合わせは静かに接続できないバックグラウンドジョブを作成しました。

952

953```text theme={null}

954--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.

955```

956

957**対応方法：**

958

959* `-p` または `--print` をドロップしてください。`--bg` はプロンプトを位置引数として取るため、`claude --bg "<task>"` が完全なコマンドです。[シェルから新しいエージェントをディスパッチ](/ja/agent-view#from-your-shell)を参照してください。

960* プロンプトを非対話的に実行し、バックグラウンドセッションを作成する代わりに結果を出力するには、`--bg` をドロップして `claude -p "<task>"` を実行してください

961

814<h2 id="responses-seem-lower-quality-than-usual">962<h2 id="responses-seem-lower-quality-than-usual">

815 Responses seem lower quality than usual963 Responses seem lower quality than usual

816</h2>964</h2>

826最初にこれらを確認してください。974最初にこれらを確認してください。

827 975

828* **モデル選択**：`/model` を実行して、予想されるモデルにいることを確認してください。以前の `/model` 選択または `ANTHROPIC_MODEL` 環境変数により、意図したより小さいモデルにいる可能性があります。976* **モデル選択**：`/model` を実行して、予想されるモデルにいることを確認してください。以前の `/model` 選択または `ANTHROPIC_MODEL` 環境変数により、意図したより小さいモデルにいる可能性があります。

829* **努力レベル**：`/effort` を実行して、現在の推論レベルを確認し、難しいデバッグまたは設計作業のためにそれを上げてください。デフォルトはモデルによって異なるため、最大値より下にあると仮定する前に確認してください。[Adjust effort level](/ja/model-config#adjust-effort-level) を参照して、モデルごとのデフォルトと `ultrathink` ショートカットを確認してください。977* **努力レベル**：`/effort` を実行して、現在の推論レベルを確認し、難しいデバッグまたは設計作業のためにそれを上げてください。デフォルトはモデルによって異なるため、最大値より下にあると仮定する前に確認してください。[Adjust effort level](/ja/model-config#adjust-effort-level)を参照して、モデルごとのデフォルトと `ultrathink` ショートカットを確認してください。

830* **コンテキスト圧力**：`/context` を実行して、ウィンドウがどの程度満杯かを確認してください。容量に近い場合は、自然な区切り点で `/compact` を実行するか、`/clear` を実行して新しく開始してください。[Explore the context window](/ja/context-window) を参照して、自動コンパクトが以前のターンにどのように影響するかを確認してください。978* **コンテキスト圧力**：`/context` を実行して、ウィンドウがどの程度満杯かを確認してください。容量に近い場合は、自然な区切り点で `/compact` を実行するか、`/clear` を実行して新しく開始してください。[Explore the context window](/ja/context-window)を参照して、自動コンパクトが以前のターンにどのように影響するかを確認してください。

831* **古い指示**：大きなまたは古い `CLAUDE.md` ファイルと MCP ツール定義はコンテキストを消費し、レスポンスを操作できます。`/doctor` は大きなメモリファイルとサブエージェント定義にフラグを立てます。`/context` は MCP ツールトークン使用量を表示します。979* **古い指示**：大きなまたは古い `CLAUDE.md` ファイルと MCP ツール定義はコンテキストを消費し、レスポンスを操作できます。`/doctor` は大きなメモリファイルとサブエージェント定義にフラグを立てます。`/context` は MCP ツールトークン使用量を表示します。

832 980

833レスポンスが間違っている場合、修正で返信するより、巻き戻しの方が通常うまくいきます。Esc を 2 回押すか、`/rewind` を実行して悪いターンの前に戻り、より詳細なプロンプトで言い換えてください。スレッド内で修正すると、間違った試みがコンテキストに残り、後の回答をそれに固定できます。[Checkpointing](/ja/checkpointing) を参照してください。981レスポンスが間違っている場合、修正で返信するより、巻き戻しの方が通常うまくいきます。Esc を 2 回押すか、`/rewind` を実行して悪いターンの前に戻り、より詳細なプロンプトで言い換えてください。スレッド内で修正すると、間違った試みがコンテキストに残り、後の回答をそれに固定できます。[Checkpointing](/ja/checkpointing)を参照してください。

834 982

835上記を確認した後も品質が異常に見える場合は、`/feedback` を実行して、期待したものと得たものを説明してください。このように送信されたフィードバックには会話トランスクリプトが含まれており、Anthropic が実際の回帰を診断する最速の方法です。環境で `/feedback` が利用できない場合は、[Report an error](#report-an-error) を参照してください。983上記を確認した後も品質が異常に見える場合は、`/feedback` を実行して、期待したものと得たものを説明してください。このように送信されたフィードバックには会話トランスクリプトが含まれており、Anthropic が実際の回帰を診断する最速の方法です。環境で `/feedback` が利用できない場合は、[Report an error](#report-an-error)を参照してください。

836 984

837<h2 id="report-an-error">985<h2 id="report-an-error">

838 エラーを報告する986 Report an error

839</h2>987</h2>

840 988

841このページでは Claude API からのエラーについて説明しています。Claude Code の他のコンポーネントからのエラーについては、関連するガイドを参照してください。989このページでは Claude API からのエラーについて説明しています。Claude Code の他のコンポーネントからのエラーについては、関連するガイドを参照してください。

848 996

849* Claude Code 内で `/feedback` を実行して、トランスクリプトと説明を Anthropic に送信してください。コマンドは、事前入力された GitHub イシューを開くことも提供します。Bedrock、Vertex AI、Foundry、およびその他のサードパーティプロバイダーでは、`/feedback` はローカルアーカイブを保存し、Anthropic アカウント担当者に送信できます。997* Claude Code 内で `/feedback` を実行して、トランスクリプトと説明を Anthropic に送信してください。コマンドは、事前入力された GitHub イシューを開くことも提供します。Bedrock、Vertex AI、Foundry、およびその他のサードパーティプロバイダーでは、`/feedback` はローカルアーカイブを保存し、Anthropic アカウント担当者に送信できます。

850* `/doctor` を実行してローカル設定の問題を確認してください998* `/doctor` を実行してローカル設定の問題を確認してください

851* [status.claude.com](https://status.claude.com) でアクティブなインシデントを確認してください999* [status.claude.com](https://status.claude.com)でアクティブなインシデントを確認してください

852* GitHub の[既存のイシュー](https://github.com/anthropics/claude-code/issues)を検索してください1000* GitHub の[既存のイシュー](https://github.com/anthropics/claude-code/issues)を検索してください

fullscreen.md +2 −2

Details

58* **`/` コマンドまたは `@` ファイルリストの候補をクリック**して受け入れます。ホバーするとカーソルの下の行がハイライトされます。58* **`/` コマンドまたは `@` ファイルリストの候補をクリック**して受け入れます。ホバーするとカーソルの下の行がハイライトされます。

59* **選択メニューのオプションをクリック**して選択します。これは権限プロンプト、`/model`、`/config`、およびオプションのリストを表示するその他のダイアログをカバーしています。ホバーするとカーソルの下の行にポインターが表示されます。{/* min-version: 2.1.187 */}Claude Code v2.1.187 以降が必要です。59* **選択メニューのオプションをクリック**して選択します。これは権限プロンプト、`/model`、`/config`、およびオプションのリストを表示するその他のダイアログをカバーしています。ホバーするとカーソルの下の行にポインターが表示されます。{/* min-version: 2.1.187 */}Claude Code v2.1.187 以降が必要です。

60* **折りたたまれたツール結果をクリック**して展開し、完全な出力を表示します。もう一度クリックして折りたたみます。ツール呼び出しとその結果は一緒に展開されます。表示するものがあるメッセージのみがクリック可能です。60* **折りたたまれたツール結果をクリック**して展開し、完全な出力を表示します。もう一度クリックして折りたたみます。ツール呼び出しとその結果は一緒に展開されます。表示するものがあるメッセージのみがクリック可能です。

61* **macOS では `Cmd` を押しながら、Linux と Windows では `Ctrl` を押しながら、URL またはファイルパスをクリック**して開きます。Edit または Write の後に出力されたものなど、ツール出力内のファイルパスはデフォルトアプリケーションで開きます。プレーン `http://` および `https://` URL はブラウザで開きます。v2.1.181 以降では、`Cmd` または `Ctrl` を押さずにクリックするだけではリンクが開かなくなり、ネイティブターミナルの動作に合わせています。VS Code 統合ターミナルおよび同様の xterm.js ベースのターミナルでは、Claude Code はターミナル独自のリンクハンドラに従い、同じジェスチャーを使用します。61* **macOS では `Cmd` を押しながら、Linux と Windows では `Ctrl` を押しながら、URL またはファイルパスをクリック**して開きます。Edit または Write の後に出力されたものなど、ツール出力内のファイルパスはデフォルトアプリケーションで開きます。プレーン `http://` および `https://` URL はブラウザで開きます。{/* min-version: 2.1.181 */}v2.1.181 以降では、`Cmd` または `Ctrl` を押さずにクリックするだけではリンクが開かなくなり、ネイティブターミナルの動作に合わせています。一部の macOS ターミナルは `Cmd`+クリックを実行中のアプリに転送し、ターミナルマウスプロトコルには `Cmd` キーをエンコードする方法がないため、Claude Code はプレーンクリックとして受け取ります。Ghostty では、{/* min-version: 2.1.198 */}v2.1.198 以降の Warp on macOS では、Claude Code はこれを検出し、リンク上のプレーンクリックで開くことができ、`Cmd` を押しながらでも機能します。VS Code 統合ターミナルおよび同様の xterm.js ベースのターミナルでは、Claude Code はターミナル独自のリンクハンドラに従い、同じジェスチャーを使用します。

62* **クリックしてドラッグ**して、会話内の任意の場所のテキストを選択します。ダブルクリックで単語を選択し、iTerm2 の単語境界に一致するため、ファイルパスは 1 つのユニットとして選択されます。トリプルクリックで行を選択します。62* **クリックしてドラッグ**して、会話内の任意の場所のテキストを選択します。ダブルクリックで単語を選択し、iTerm2 の単語境界に一致するため、ファイルパスは 1 つのユニットとして選択されます。{/* min-version: 2.1.198 */}v2.1.198 以降では、URL をダブルクリックするとスキームを含む URL 全体が選択されます。トリプルクリックで行を選択します。

63* **マウスホイールでスクロール**して会話を移動します。63* **マウスホイールでスクロール**して会話を移動します。

64 64

65選択されたテキストはマウスリリース時にクリップボードに自動的にコピーされます。これをオフにするには、`/config` で Copy on select をトグルします。65選択されたテキストはマウスリリース時にクリップボードに自動的にコピーされます。これをオフにするには、`/config` で Copy on select をトグルします。

gateways.md +1 −1

Details

44 Claude apps ゲートウェイ44 Claude apps ゲートウェイ

45</h3>45</h3>

46 46

47Claude apps ゲートウェイは Anthropic の自社ホスト型ゲートウェイで、`claude` バイナリに含まれています。Amazon Bedrock、Google Cloud、Microsoft Foundry、または Anthropic API にアップストリームとしてルーティングします。開発者は `/login` を通じて企業の ID プロバイダーでサインインし、ゲートウェイは IdP グループによってモデルアクセスと [管理設定](/ja/permissions#managed-settings) を強制し、[OpenTelemetry Protocol（OTLP）](/ja/monitoring-usage) 使用状況メトリクスを独自の可観測性スタックに出力します。47Claude apps ゲートウェイは Anthropic の自社ホスト型ゲートウェイで、`claude` バイナリに含まれています。Amazon Bedrock、Claude Platform on AWS、Google Cloud、Microsoft Foundry、または Anthropic API にアップストリームとしてルーティングします。開発者は `/login` を通じて企業の ID プロバイダーでサインインし、ゲートウェイは IdP グループによってモデルアクセスと [管理設定](/ja/permissions#managed-settings) を強制し、[OpenTelemetry Protocol（OTLP）](/ja/monitoring-usage) 使用状況メトリクスを独自の可観測性スタックに出力します。

48 48

49これは各 Claude Code リリースと共にビルドおよびテストされるため、Claude Code が送信するヘッダーとリクエストフィールドを転送します。別途保守されるゲートウェイは、各リリースでそれらのヘッダーとフィールドが変更されるため、[転送ルールを更新](/ja/llm-gateway-protocol#forward-as-open-lists) する必要があります。Claude apps ゲートウェイは CLI と共にリリースされるため、最新の状態を保つリストはありません。[可用性と制限事項](/ja/claude-apps-gateway#availability-and-limitations) を参照して、ゲートウェイセッションで異なる動作をする機能の小さなセットを確認してください。49これは各 Claude Code リリースと共にビルドおよびテストされるため、Claude Code が送信するヘッダーとリクエストフィールドを転送します。別途保守されるゲートウェイは、各リリースでそれらのヘッダーとフィールドが変更されるため、[転送ルールを更新](/ja/llm-gateway-protocol#forward-as-open-lists) する必要があります。Claude apps ゲートウェイは CLI と共にリリースされるため、最新の状態を保つリストはありません。[可用性と制限事項](/ja/claude-apps-gateway#availability-and-limitations) を参照して、ゲートウェイセッションで異なる動作をする機能の小さなセットを確認してください。

50 50

hooks.md +67 −33

Details

16 フックライフサイクル16 フックライフサイクル

17</h2>17</h2>

18 18

19フックは Claude Code セッション中の特定のポイントで発火します。イベントが発火してマッチャーがマッチすると、Claude Code はイベントに関する JSON コンテキストをフックハンドラーに渡します。コマンドフックの場合、入力は stdin に到着します。HTTP フックの場合、POST リクエスト本体として到着します。ハンドラーは入力を検査し、アクションを実行し、オプションで決定を返すことができます。イベントは 3 つのケイデンスに分類されます。セッションごとに 1 回（`SessionStart`、`SessionEnd`）、ターンごとに 1 回（`UserPromptSubmit`、`Stop`、`StopFailure`）、agentic ループ内のすべてのツール呼び出しで（`PreToolUse`、`PostToolUse`）です。19フックは Claude Code セッション中の特定のポイントで発火します。イベントが発火してマッチャーがマッチすると、Claude Code はイベントに関する JSON コンテキストをフックハンドラーに渡します。コマンドフックの場合、入力は stdin に到着します。HTTP フックの場合、POST リクエスト本体として到着します。ハンドラーは入力を検査し、アクションを実行し、オプションで決定を返すことができます。

21イベントは 3 つのケイデンスに分類されます。

23* セッションごとに 1 回：`SessionStart` と `SessionEnd`

24* ターンごとに 1 回：`UserPromptSubmit`、`Stop`、`StopFailure`

25* agentic ループ内のすべてのツール呼び出しで：`PreToolUse` と `PostToolUse`

20 26

21<div style={{maxWidth: "500px", margin: "0 auto"}}>27<div style={{maxWidth: "500px", margin: "0 auto"}}>

22 <Frame>28 <Frame>

315* **[プロンプトフック](#prompt-and-agent-hook-fields)** （`type: "prompt"`）: Claude モデルにプロンプトを送信して、単一ターンの評価を行います。モデルは yes/no 決定を JSON として返します。[プロンプトベースのフック](#prompt-based-hooks)を参照してください。321* **[プロンプトフック](#prompt-and-agent-hook-fields)** （`type: "prompt"`）: Claude モデルにプロンプトを送信して、単一ターンの評価を行います。モデルは yes/no 決定を JSON として返します。[プロンプトベースのフック](#prompt-based-hooks)を参照してください。

316* **[エージェントフック](#prompt-and-agent-hook-fields)** （`type: "agent"`）: Read、Grep、Glob などのツールを使用して条件を検証してから決定を返すことができるサブエージェントを生成します。エージェントフックは実験的であり、変更される可能性があります。[エージェントベースのフック](#agent-based-hooks)を参照してください。322* **[エージェントフック](#prompt-and-agent-hook-fields)** （`type: "agent"`）: Read、Grep、Glob などのツールを使用して条件を検証してから決定を返すことができるサブエージェントを生成します。エージェントフックは実験的であり、変更される可能性があります。[エージェントベースのフック](#agent-based-hooks)を参照してください。

317 323

318すべてのマッチングフックは並列で実行され、同一のハンドラーは自動的に重複排除されます。コマンドフックはコマンド文字列と `args` で重複排除され、HTTP フックは URL で重複排除されます。ハンドラーは Claude Code の環境を持つ現在のディレクトリで実行されます。`$CLAUDE_CODE_REMOTE` 環境変数はリモート Web 環境で `"true"` に設定され、ローカル CLI では設定されません。324すべてのマッチングフックは並列で実行され、同一のハンドラーは自動的に重複排除されます。コマンドフックはコマンド文字列と `args` で重複排除され、HTTP フックは URL で重複排除されます。ハンドラーは Claude Code の環境を持つ現在のディレクトリで実行されます。`$CLAUDE_CODE_REMOTE` 環境変数はリモート Web 環境で `"true"` に設定され、ローカル CLI では設定されません。{/* min-version: 2.1.199 */}v2.1.199 以降、[`$CLAUDE_CODE_BRIDGE_SESSION_ID`](/ja/env-vars)は、ローカルセッションがアクティブな Remote Control 接続を持つ間、[Remote Control](/ja/remote-control)セッション ID に設定されます。

319 325

320<h4 id="common-fields">326<h4 id="common-fields">

321 共通フィールド327 共通フィールド

352[共通フィールド](#common-fields)に加えて、コマンドフックはこれらのフィールドを受け入れます。358[共通フィールド](#common-fields)に加えて、コマンドフックはこれらのフィールドを受け入れます。

353 359

354| フィールド | 必須 | 説明 |360| フィールド | 必須 | 説明 |

355| :------------ | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |361| :------------ | :-- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

356| `command` | はい | 実行するシェルコマンド。`args` を使用する場合、直接生成する実行可能ファイル。[Exec フォームとシェルフォーム](#exec-form-and-shell-form)を参照してください |362| `command` | はい | 実行するシェルコマンド。`args` を使用する場合、直接生成する実行可能ファイル。[Exec フォームとシェルフォーム](#exec-form-and-shell-form)を参照してください |

357| `args` | いいえ | 引数リスト。存在する場合、`command` は実行可能ファイルとして解決され、`args` を引数ベクトルとして直接生成されます。シェルは関与しません。[Exec フォームとシェルフォーム](#exec-form-and-shell-form)を参照してください |363| `args` | いいえ | 引数リスト。存在する場合、`command` は実行可能ファイルとして解決され、`args` を引数ベクトルとして直接生成されます。シェルは関与しません。[Exec フォームとシェルフォーム](#exec-form-and-shell-form)を参照してください |

358| `async` | いいえ | `true` の場合、ブロックせずにバックグラウンドで実行されます。[バックグラウンドでフックを実行](#run-hooks-in-the-background)を参照してください |364| `async` | いいえ | `true` の場合、ブロックせずにバックグラウンドで実行されます。[バックグラウンドでフックを実行](#run-hooks-in-the-background)を参照してください |

359| `asyncRewake` | いいえ | `true` の場合、バックグラウンドで実行され、終了コード 2 で Claude を起動します。`async` を暗黙的に指定します。フックの stderr、または stderr が空の場合は stdout が、Claude がシステムリマインダーとして長時間実行されるバックグラウンド失敗に反応できるように表示されます |365| `asyncRewake` | いいえ | `true` の場合、バックグラウンドで実行され、終了コード 2 で Claude を起動します。`async` を暗黙的に指定します。フックの stderr、または stderr が空の場合は stdout が、Claude がシステムリマインダーとして長時間実行されるバックグラウンド失敗に反応できるように表示されます |

360| `shell` | いいえ | このフックに使用するシェル。`"bash"`（デフォルト）または `"powershell"` を受け入れます。`"powershell"` を設定すると、Windows 上で PowerShell 経由でコマンドが実行されます。`CLAUDE_CODE_USE_POWERSHELL_TOOL` は不要です。フックは PowerShell を直接生成するため。`args` が設定されている場合は無視されます |366| `shell` | いいえ | このフックに使用するシェル。`"bash"` または `"powershell"` を受け入れます。デフォルトは `"bash"`、または Git Bash がインストールされていない場合は Windows で `"powershell"`。`"powershell"` を設定すると、Windows 上で PowerShell 経由でコマンドが実行されます。`CLAUDE_CODE_USE_POWERSHELL_TOOL` は不要です。フックは PowerShell を直接生成するため。`args` が設定されている場合は無視されます |

361 367

362<a id="exec-form-and-shell-form" />368<a id="exec-form-and-shell-form" />

363 369

734| `InstructionsLoaded` | いいえ | 終了コードは無視 |740| `InstructionsLoaded` | いいえ | 終了コードは無視 |

735| `MessageDisplay` | いいえ | 元のテキストが表示される |741| `MessageDisplay` | いいえ | 元のテキストが表示される |

736 742

743`SessionStart`、`Setup`、および `SubagentStart` の場合、終了コード 2 stderr は[非ブロッキングエラー](#exit-code-output)と同じ方法で、トランスクリプトに `<hook name> hook error` 通知としてレンダリングされます。Claude はそれを見ず、セッションまたはサブエージェントは進行します。`SubagentStart` の場合、通知は親会話ではなく、サブエージェント自身のトランスクリプトに表示されます。

744

745Claude Code v2.1.199 以降、`SessionStart`、`Setup`、および `SubagentStart` はトランスクリプトに終了コード 2 stderr を表示します。以前のバージョンはデバッグログにのみ書き込みました。

746

737<h3 id="http-response-handling">747<h3 id="http-response-handling">

738 HTTP レスポンス処理748 HTTP レスポンス処理

739</h3>749</h3>

961 SessionStart 入力971 SessionStart 入力

962</h4>972</h4>

963 973

964[共通入力フィールド](#common-input-fields)に加えて、SessionStart フックは `source` と、オプションで `model`、`agent_type`、`session_title` を受け取ります。`source` フィールドはセッションがどのように開始されたかを示します。新しいセッションの場合は `"startup"`、再開されたセッションの場合は `"resume"`、`/clear` の後は `"clear"`、コンパクション後は `"compact"`。`model` フィールドはアクティブなモデル識別子を含みます。例えば `/clear` の後、またはセッションが会話復旧を通じて復元されるときなど、フィールドが省略される可能性があるため、読み取る前にフィールドをチェックしてください。`claude --agent <name>` で Claude Code を開始する場合、`agent_type` フィールドはエージェント名を含みます。`session_title` フィールドは、例えば `--name` または `/rename` 経由で既に設定されている場合、現在のセッションタイトルを含みます。`sessionTitle` を発行するフックは、ユーザーが明示的に設定したタイトルを上書きしないように、最初に `session_title` をチェックできます。974[共通入力フィールド](#common-input-fields)に加えて、SessionStart フックは `source` と、オプションで `model`、`agent_type`、`session_title` を受け取ります。

975

976| フィールド | 説明 |

977| :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------- |

978| `source` | セッションがどのように開始されたか: 新しいセッションの場合は `"startup"`、再開されたセッションの場合は `"resume"`、`/clear` の後は `"clear"`、コンパクション後は `"compact"` |

979| `model` | アクティブなモデル識別子。例えば `/clear` の後、またはセッションが会話復旧を通じて復元されるときなど、フィールドが省略される可能性があるため、読み取る前にフィールドをチェックしてください |

980| `agent_type` | `claude --agent <name>` で Claude Code を開始する場合、エージェント名が存在 |

981| `session_title` | 例えば `--name` または `/rename` 経由で既に設定されている場合、現在のセッションタイトル。`sessionTitle` を発行するフックは、ユーザーが明示的に設定したタイトルを上書きしないように、最初に `session_title` をチェックできます |

965 982

966```json theme={null}983```json theme={null}

967{984{

981フックスクリプトが stdout に出力するテキストは Claude のコンテキストとして追加されます。すべてのフックで利用可能な[JSON 出力フィールド](#json-output)に加えて、これらのイベント固有のフィールドを返すことができます。998フックスクリプトが stdout に出力するテキストは Claude のコンテキストとして追加されます。すべてのフックで利用可能な[JSON 出力フィールド](#json-output)に加えて、これらのイベント固有のフィールドを返すことができます。

982 999

983| フィールド | 説明 |1000| フィールド | 説明 |

984| :------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1001| :------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

985| `additionalContext` | Claude のコンテキストの開始時に追加される文字列。最初のプロンプトの前。[Claude のコンテキストを追加](#add-context-for-claude)を参照して、テキストがどのように配信されるか、何を含めるかを確認してください |1002| `additionalContext` | Claude のコンテキストの開始時に追加される文字列。最初のプロンプトの前。[Claude のコンテキストを追加](#add-context-for-claude)を参照して、テキストがどのように配信されるか、何を含めるかを確認してください |

986| `initialUserMessage` | セッションの最初のユーザーメッセージとして使用される文字列。[非対話型モード](/ja/headless)（`-p`）で適用され、プロンプトが提供されない場合でも最初のターンになります。プロンプトが提供される場合、次のターンとして続きます。`additionalContext` とは異なり、既存のターンに付加されるのではなく、このターンを作成します |1003| `initialUserMessage` | セッションの最初のユーザーメッセージとして使用される文字列。[非対話型モード](/ja/headless)で `-p` フラグで適用され、プロンプトが提供されない場合でも最初のターンになります。プロンプトが提供される場合、次のターンとして続きます。`additionalContext` とは異なり、既存のターンに付加されるのではなく、このターンを作成します |

987| `sessionTitle` | セッションタイトルを設定します。`/rename` と同じ効果があります。起動フォルダ、git ブランチ、またはワークツリー名からセッションを自動的に名前付けするのに使用します。`source` が `"startup"` または `"resume"` の場合のみ適用されます。`"clear"` と `"compact"` では無視されます |1004| `sessionTitle` | セッションタイトルを設定します。`/rename` と同じ効果があります。起動フォルダ、git ブランチ、またはワークツリー名からセッションを自動的に名前付けするのに使用します。`source` が `"startup"` または `"resume"` の場合のみ適用されます。`"clear"` と `"compact"` では無視されます |

989| `reloadSkills` | ブール値。`true` の場合、Claude Code は SessionStart フックが完了した後に[スキル](/ja/skills)とコマンドディレクトリを再スキャンするため、フックがインストールしたスキルは同じセッションで利用可能になり、最初のプロンプトから開始されます |1006| `reloadSkills` | ブール値。`true` の場合、Claude Code は SessionStart フックが完了した後に[スキル](/ja/skills)とコマンドディレクトリを再スキャンするため、フックがインストールしたスキルは同じセッションで利用可能になり、最初のプロンプトから開始されます |

1060 Setup1077 Setup

1061</h3>1078</h3>

1062 1079

1063`--init-only` で Claude Code を起動するか、プリントモード（`-p`）で `--init` または `--maintenance` で起動するときのみ発火します。通常のスタートアップでは発火しません。CI またはスクリプトから明示的にトリガーする 1 回限りの依存関係インストールまたはスケジュール済みクリーンアップに使用します。通常のセッションスタートアップとは別です。セッションごとの初期化の場合は、代わりに[SessionStart](#sessionstart)を使用してください。1080`--init-only` で Claude Code を起動するか、[非対話型モード](/ja/headless)で `-p` フラグを使用して `--init` または `--maintenance` で起動するときのみ発火します。通常のスタートアップでは発火しません。CI またはスクリプトから明示的にトリガーする 1 回限りの依存関係インストールまたはスケジュール済みクリーンアップに使用します。通常のセッションスタートアップとは別です。セッションごとの初期化の場合は、代わりに[SessionStart](#sessionstart)を使用してください。

1064 1081

1065マッチャー値はフックをトリガーした CLI フラグに対応しています。1082マッチャー値はフックをトリガーした CLI フラグに対応しています。

1066 1083

1071 1088

1072`--init-only` は Setup フックと `startup` マッチャーを持つ SessionStart フックを実行してから、会話を開始せずに終了します。`--init` と `--maintenance` は `-p`（プリントモード）と組み合わせた場合のみ Setup フックを発火させます。対話型セッションでは、これら 2 つのフラグは現在 Setup フックを発火させません。1089`--init-only` は Setup フックと `startup` マッチャーを持つ SessionStart フックを実行してから、会話を開始せずに終了します。`--init` と `--maintenance` は `-p` と組み合わせた場合のみ Setup フックを発火させます。対話型セッションでは、これら 2 つのフラグは現在 Setup フックを発火させません。

1073 1090

1074Setup はすべての起動で発火しないため、依存関係がインストールされている必要があるプラグインは Setup のみに依存できません。実用的なパターンは、最初の使用時に依存関係をチェックし、欠落している場合はインストールすることです。例えば、`${CLAUDE_PLUGIN_DATA}/node_modules` をテストし、欠落している場合は `npm install` を実行するフックまたはスキル。永続データディレクトリについては、[永続データディレクトリ](/ja/plugins-reference#persistent-data-directory)を参照して、インストールされた依存関係を保存する場所を確認してください。1091Setup はすべての起動で発火しないため、依存関係がインストールされている必要があるプラグインは Setup のみに依存できません。実用的なパターンは、最初の使用時に依存関係をチェックし、欠落している場合はインストールすることです。例えば、`${CLAUDE_PLUGIN_DATA}/node_modules` をテストし、欠落している場合は `npm install` を実行するフックまたはスキル。永続データディレクトリについては、[永続データディレクトリ](/ja/plugins-reference#persistent-data-directory)を参照して、インストールされた依存関係を保存する場所を確認してください。

1075 1092

1093 Setup 決定制御1110 Setup 決定制御

1094</h4>1111</h4>

1095 1112

1096Setup フックはブロックできません。終了コード 2 では、stderr がユーザーに表示されます。その他の非ゼロ終了コードでは、stderr は `--verbose` で起動した場合のみ表示されます。どちらの場合も実行は続行されます。Claude のコンテキストに情報を渡すには、JSON 出力で `additionalContext` を返します。プレーン stdout はデバッグログにのみ書き込まれます。すべてのフックで利用可能な[JSON 出力フィールド](#json-output)に加えて、これらのイベント固有のフィールドを返すことができます。1113Setup フックはブロックできません。非ゼロ終了コード（2 を含む）は stderr をユーザーに `<hook name> hook error` 通知として表示し、実行は続行されます。[非対話型モード](/ja/headless)では、フック出力は `--verbose` で起動した場合のみ表示されます。

1114

1115Claude のコンテキストに情報を渡すには、JSON 出力で `additionalContext` を返します。プレーン stdout はデバッグログにのみ書き込まれます。すべてのフックで利用可能な[JSON 出力フィールド](#json-output)に加えて、これらのイベント固有のフィールドを返すことができます。

1097 1116

1098| フィールド | 説明 |1117| フィールド | 説明 |

1099| :------------------ | :-------------------------------------- |1118| :------------------ | :-------------------------------------- |

1189* **プレーンテキスト stdout**: stdout に書き込まれた JSON 以外のテキストはコンテキストとして追加されます1208* **プレーンテキスト stdout**: stdout に書き込まれた JSON 以外のテキストはコンテキストとして追加されます

1190* **`additionalContext` を含む JSON**: より多くの制御のために以下の JSON 形式を使用します。`additionalContext` フィールドはコンテキストとして追加されます1209* **`additionalContext` を含む JSON**: より多くの制御のために以下の JSON 形式を使用します。`additionalContext` フィールドはコンテキストとして追加されます

1191 1210

1192プレーン stdout はトランスクリプトのフック出力として表示されます。`additionalContext` フィールドはより慎重に追加されます。1211プレーン stdout はトランスクリプトのフック出力として表示されます。`additionalContext` 値は Claude が見える通知なしで読むシステムリマインダーとして注入されます。

1193 1212

1194プロンプトをブロックするには、`decision` を `"block"` に設定した JSON オブジェクトを返します。1213プロンプトをブロックするには、`decision` を `"block"` に設定した JSON オブジェクトを返します。

1195 1214

1213}1232}

1214```1233```

1215 1234

1216<Note>

1217 JSON 形式は単純なユースケースには必須ではありません。コンテキストを追加するには、終了コード 0 で stdout にプレーンテキストを出力できます。プロンプトをブロックしたい場合、またはより構造化された制御が必要な場合は JSON を使用します。

1218</Note>

~~1219~~

1220<h3 id="userpromptexpansion">1235<h3 id="userpromptexpansion">

1221 UserPromptExpansion1236 UserPromptExpansion

1222</h3>1237</h3>

1223 1238

1224ユーザーが入力したスラッシュコマンドが Claude に到達する前にプロンプトに展開されるときに実行されます。特定のコマンドを直接呼び出しからブロックしたり、特定のスキルのコンテキストを注入したり、ユーザーが呼び出すコマンドをログしたりするのに使用します。例えば、`deploy` にマッチするフックは、承認ファイルが存在しない限り `/deploy` をブロックできます。または、レビュースキルにマッチするフックはチームのレビューチェックリストを `additionalContext` として追加できます。1239ユーザーが入力したコマンドが Claude に到達する前にプロンプトに展開されるときに実行されます。特定のコマンドを直接呼び出しからブロックしたり、特定のスキルのコンテキストを注入したり、ユーザーが呼び出すコマンドをログしたりするのに使用します。例えば、`deploy` にマッチするフックは、承認ファイルが存在しない限り `/deploy` をブロックできます。または、レビュースキルにマッチするフックはチームのレビューチェックリストを `additionalContext` として追加できます。

1225 1240

1226このイベントは `PreToolUse` がカバーしないパスをカバーします。`PreToolUse` フックが `Skill` ツールにマッチするのは Claude がツールを呼び出すときのみですが、`/skillname` を直接入力すると `PreToolUse` をバイパスします。`UserPromptExpansion` はその直接パスで発火します。1241このイベントは `PreToolUse` がカバーしないパスをカバーします。`PreToolUse` フックが `Skill` ツールにマッチするのは Claude がツールを呼び出すときのみですが、`/skillname` を直接入力すると `PreToolUse` をバイパスします。`UserPromptExpansion` はその直接パスで発火します。

1227 1242

1228`command_name` でマッチします。マッチャーを空のままにして、すべてのプロンプトタイプのスラッシュコマンドで発火します。1243`command_name` でマッチします。マッチャーを空のままにして、すべてのプロンプトタイプのコマンドで発火します。

1229 1244

1230<h4 id="userpromptexpansion-input">1245<h4 id="userpromptexpansion-input">

1231 UserPromptExpansion 入力1246 UserPromptExpansion 入力

1256 1271

1257| フィールド | 説明 |1272| フィールド | 説明 |

1258| :------------------ | :------------------------------------------------------------------------------------------- |1273| :------------------ | :------------------------------------------------------------------------------------------- |

1262 1277

1543`PostToolUse` では、完了した Agent 呼び出しの `tool_response` はサブエージェントの最終テキストと使用テレメトリを含みます。フックからサブエージェント単位のコストを記録するためにこれらのフィールドを読み取ります。1558`PostToolUse` では、完了した Agent 呼び出しの `tool_response` はサブエージェントの最終テキストと使用テレメトリを含みます。フックからサブエージェント単位のコストを記録するためにこれらのフィールドを読み取ります。

1544 1559

1545| フィールド | タイプ | 例 | 説明 |1560| フィールド | タイプ | 例 | 説明 |

1546| :------------------ | :----- | :---------------------------------------------------- | :------------------------------------------------------------------------------------------------- |1561| :------------------ | :----- | :---------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

1547| `status` | 文字列 | `"completed"` | 同期呼び出しの場合は `"completed"`、`run_in_background: true` の場合は `"async_launched"` |1562| `status` | 文字列 | `"completed"` | `"completed"` は同期呼び出しの場合、`"async_launched"` はバックグラウンドサブエージェントの場合。{/* min-version: 2.1.198 */}v2.1.198 以降では、サブエージェントはデフォルトでバックグラウンドで実行されるため、省略された `run_in_background` も `"async_launched"` を生成します |

1549| `content` | 配列 | `[{"type": "text", "text": "Found 12 endpoints..."}]` | サブエージェントの最終テキストブロック |1564| `content` | 配列 | `[{"type": "text", "text": "Found 12 endpoints..."}]` | サブエージェントの最終テキストブロック |

1550| `resolvedModel` | 文字列 | `"claude-sonnet-4-5"` | サブエージェントが実行されたモデル。要求されたモデルと異なる可能性があります。{/* min-version: 2.1.174 */}Claude Code v2.1.174 以降が必要 |1565| `resolvedModel` | 文字列 | `"claude-sonnet-4-5"` | サブエージェントが実行されたモデル。要求されたモデルと異なる可能性があります。{/* min-version: 2.1.174 */}Claude Code v2.1.174 以降が必要 |

1553| `totalToolUseCount` | 数値 | `7` | サブエージェントが行ったツール呼び出しの数 |1568| `totalToolUseCount` | 数値 | `7` | サブエージェントが行ったツール呼び出しの数 |

1554| `usage` | オブジェクト | `{"input_tokens": 8320, ...}` | タイプ別トークン分解: `input_tokens`、`output_tokens`、`cache_creation_input_tokens`、`cache_read_input_tokens` |1569| `usage` | オブジェクト | `{"input_tokens": 8320, ...}` | タイプ別トークン分解: `input_tokens`、`output_tokens`、`cache_creation_input_tokens`、`cache_read_input_tokens` |

1555 1570

1556`run_in_background: true` 呼び出しの場合、ツールはサブエージェント起動後すぐに返されるため、`tool_response` は使用フィールドを含みません。`status: "async_launched"`、`agentId`、`description`、`prompt`、`outputFile`、`resolvedModel` を含みます。1571バックグラウンドサブエージェントの場合、ツールはサブエージェント起動後すぐに返されるため、`tool_response` は使用フィールドを含みません。`status: "async_launched"`、`agentId`、`description`、`prompt`、`outputFile`、`resolvedModel` を含みます。

1557 1572

1558`resolvedModel` フィールドはサブエージェントが実行されたモデルを名前付けし、`tool_input` の `model` 値と異なる可能性があります。Claude Code v2.1.174 以降が必要です。1573`resolvedModel` フィールドはサブエージェントが実行されたモデルを名前付けし、`tool_input` の `model` 値と異なる可能性があります。Claude Code v2.1.174 以降が必要です。

1559 1574

1617 1632

1618`AskUserQuestion` と `ExitPlanMode` はユーザー操作が必要で、通常は[非対話型モード](/ja/headless)で `-p` フラグでブロックします。`permissionDecision: "allow"` を `updatedInput` と一緒に返すことでその要件を満たします。フックは stdin からツールの入力を読み取り、独自の UI を通じて回答を収集し、ツールがプロンプトなしで実行されるように `updatedInput` で返します。`"allow"` のみを返すことはこれらのツールには十分ではありません。`AskUserQuestion` の場合、元の `questions` 配列をエコーバックし、各質問のテキストを選択された回答にマップする [`answers`](#askuserquestion) オブジェクトを追加します。1633`AskUserQuestion` と `ExitPlanMode` はユーザー操作が必要で、通常は[非対話型モード](/ja/headless)で `-p` フラグでブロックします。`permissionDecision: "allow"` を `updatedInput` と一緒に返すことでその要件を満たします。フックは stdin からツールの入力を読み取り、独自の UI を通じて回答を収集し、ツールがプロンプトなしで実行されるように `updatedInput` で返します。`"allow"` のみを返すことはこれらのツールには十分ではありません。`AskUserQuestion` の場合、元の `questions` 配列をエコーバックし、各質問のテキストを選択された回答にマップする [`answers`](#askuserquestion) オブジェクトを追加します。

1619 1634

1635v2.1.199 以降では、サーバーが [`_meta["anthropic/requiresUserInteraction"]`](/ja/mcp#require-approval-for-a-specific-tool) でマークした MCP ツールはより厳密です。フックは `"allow"` で承認プロンプトをスキップできません。`updatedInput` の有無にかかわらず、Claude Code はフックがツールが必要とする操作を収集したことを確認できないためです。

1636

1620<Note>1637<Note>

1621 PreToolUse は以前、トップレベル `decision` と `reason` フィールドを使用していましたが、このイベントでは非推奨です。代わりに `hookSpecificOutput.permissionDecision` と `hookSpecificOutput.permissionDecisionReason` を使用してください。非推奨の値 `"approve"` と `"block"` は `"allow"` と `"deny"` にマップされます。PostToolUse と Stop などの他のイベントは、現在の形式としてトップレベル `decision` と `reason` を使用し続けます。1638 PreToolUse は以前、トップレベル `decision` と `reason` フィールドを使用していましたが、このイベントでは非推奨です。代わりに `hookSpecificOutput.permissionDecision` と `hookSpecificOutput.permissionDecisionReason` を使用してください。非推奨の値 `"approve"` と `"block"` は `"allow"` と `"deny"` にマップされます。PostToolUse と Stop などの他のイベントは、現在の形式としてトップレベル `decision` と `reason` を使用し続けます。

1622</Note>1639</Note>

2014 Notification2031 Notification

2015</h3>2032</h3>

2016 2033

2017Claude Code が通知を送信するときに実行されます。通知タイプでマッチします。`permission_prompt`、`idle_prompt`、`auth_success`、`elicitation_dialog`、`elicitation_complete`、`elicitation_response`。マッチャーを省略して、すべての通知タイプのフックを実行します。2034Claude Code が通知を送信するときに実行されます。通知タイプでマッチします。マッチャーを省略して、すべての通知タイプのフックを実行します。

2035

2036| マッチャー | いつ発火するか |

2037| :--------------------- | :-------------------------------------------------------------------- |

2038| `permission_prompt` | Claude が権限承認を必要とする |

2039| `idle_prompt` | Claude が完了して次のプロンプトを待機 |

2040| `auth_success` | 認証が完了 |

2041| `elicitation_dialog` | MCP サーバーが elicitation フォームを開く |

2042| `elicitation_complete` | MCP elicitation フォームが送信または却下 |

2043| `elicitation_response` | MCP elicitation レスポンスがサーバーに送信 |

2044| `agent_needs_input` | バックグラウンドセッションが入力を待機開始。[エージェントビュー](/ja/agent-view)がターミナルで開いている場合のみ発火 |

2045| `agent_completed` | バックグラウンドセッションが完了または失敗。[エージェントビュー](/ja/agent-view)がターミナルで開いている場合のみ発火 |

2046

2047`agent_needs_input` と `agent_completed` タイプには Claude Code v2.1.198 以降が必要です。

2018 2048

2019異なるマッチャーを使用して、通知タイプに応じて異なるハンドラーを実行します。この設定は、Claude が権限承認を必要とするときに権限固有のアラートスクリプトをトリガーし、Claude がアイドル状態になったときに異なる通知をトリガーします。2049異なるマッチャーを使用して、通知タイプに応じて異なるハンドラーを実行します。この設定は、Claude が権限承認を必要とするときに権限固有のアラートスクリプトをトリガーし、Claude がアイドル状態になったときに異なる通知をトリガーします。

2020 2050

2077 SubagentStart 入力2107 SubagentStart 入力

2078</h4>2108</h4>

2079 2109

2080[共通入力フィールド](#common-input-fields)に加えて、SubagentStart フックはサブエージェントの一意の識別子を含む `agent_id` とエージェント名を含む `agent_type`（`"general-purpose"`、`"Explore"`、`"Plan"` などの組み込みエージェント、またはカスタムエージェント名）を受け取ります。2110[共通入力フィールド](#common-input-fields)に加えて、SubagentStart フックはサブエージェントの一意の識別子を含む `agent_id` とエージェント名を含む `agent_type` を受け取ります。

2081 2111

2082```json theme={null}2112```json theme={null}

2083{2113{

2644 WorktreeCreate 入力2674 WorktreeCreate 入力

2645</h4>2675</h4>

2646 2676

2647[共通入力フィールド](#common-input-fields)に加えて、WorktreeCreate フックは `name` フィールドを受け取ります。これは新しいワークツリーのスラッグ識別子で、ユーザーが指定するか自動生成されます（例えば、`bold-oak-a3f2`）。2677[共通入力フィールド](#common-input-fields)に加えて、Workt reeCreate フックは `name` フィールドを受け取ります。これは新しいワークツリーのスラッグ識別子で、ユーザーが指定するか自動生成されます（例えば、`bold-oak-a3f2`）。

2648 2678

2649```json theme={null}2679```json theme={null}

2650{2680{

3060 3090

3061任意のイベントでより細かい制御が必要な場合は、[決定制御](#decision-control)で説明されているイベントごとのフィールドを使用して、[コマンドフック](#command-hook-fields)を使用してください。3091任意のイベントでより細かい制御が必要な場合は、[決定制御](#decision-control)で説明されているイベントごとのフィールドを使用して、[コマンドフック](#command-hook-fields)を使用してください。

3062 3092

3063<h3 id="example-multi-criteria-stop-hook">3093<h3 id="check-multiple-conditions-before-stopping">

3064 例：マルチ基準 Stop フック3094 停止する前に複数の条件をチェック

3065</h3>3095</h3>

3066 3096

3067この `Stop` フックは詳細なプロンプトを使用して、Claude が停止することを許可する前に 3 つの条件をチェックします。`"ok"` が `false` の場合、Claude は提供された理由を次の指示として受け取り、作業を続行します。`SubagentStop` フックは同じ形式を使用して、[サブエージェント](/ja/sub-agents)が停止すべきかどうかを評価します：3097この `Stop` フックは詳細なプロンプトを使用して、Claude が停止することを許可する前に 3 つの条件をチェックします。`SubagentStop` フックは同じ形式を使用して、[サブエージェント](/ja/sub-agents)が停止すべきかどうかを評価します。`"ok"` が `false` の場合、Claude は提供された理由を次の指示として受け取り、作業を続行します：

3068 3098

3069```json theme={null}3099```json theme={null}

3070{3100{

3188 3218

3189非同期フック完了通知はデフォルトで抑制されます。これらを表示するには、`Ctrl+O` で詳細モードを有効にするか、`--verbose` で Claude Code を開始します。3219非同期フック完了通知はデフォルトで抑制されます。これらを表示するには、`Ctrl+O` で詳細モードを有効にするか、`--verbose` で Claude Code を開始します。

3190 3220

3191<h3 id="example-run-tests-after-file-changes">3221<h3 id="run-tests-after-file-changes">

3192 例: ファイル変更後にテストを実行3222 ファイル変更後にテストを実行

3193</h3>3223</h3>

3194 3224

3195このフックは Claude がファイルを書き込むたびにバックグラウンドでテストスイートを開始し、テストが完了したら結果を Claude に報告します。このスクリプトをプロジェクトの `.claude/hooks/run-tests-async.sh` に保存し、`chmod +x` で実行可能にします。3225このフックは Claude がファイルを書き込むたびにバックグラウンドでテストスイートを開始し、テストが完了したら結果を Claude に報告します。このスクリプトをプロジェクトの `.claude/hooks/run-tests-async.sh` に保存し、`chmod +x` で実行可能にします。

3283 Windows PowerShell ツール3313 Windows PowerShell ツール

3284</h2>3314</h2>

3285 3315

3286Windows では、コマンドフックで `"shell": "powershell"` を設定することで、個別のフックを PowerShell で実行できます。フックは PowerShell を直接生成するため、`CLAUDE_CODE_USE_POWERSHELL_TOOL` が設定されているかどうかに関係なく機能します。Claude Code は `pwsh.exe`（PowerShell 7 以上）を自動検出し、`powershell.exe`（5.1）にフォールバックします。3316Windows では、コマンドフックで `"shell": "powershell"` を設定することで、個別のフックを PowerShell で実行できます。フックは PowerShell を直接生成するため、`CLAUDE_CODE_USE_POWERSHELL_TOOL` が設定されているかどうかに関係なく機能します。Claude Code は `pwsh.exe`（PowerShell 7 以降の実行可能ファイル）を自動検出し、Windows PowerShell 5.1 の `powershell.exe` にフォールバックします。

3287 3317

3288```json theme={null}3318```json theme={null}

3289{3319{

3304}3334}

3305```3335```

3306 3336

3307PowerShell シェル形式のコマンドからプロジェクトルートを参照するには、`$env:CLAUDE_PROJECT_DIR` を使用して環境変数として読み込みます。PowerShell は、`${CLAUDE_PROJECT_DIR}` の形式を環境ルックアップではなくローカル変数として扱い、Claude Code はシェル形式でのみそのプレースホルダーを [プラグインフック](#reference-scripts-by-path) に対して置換します。`settings.json` で定義されたフックの場合は、`$env:` 形式を使用するか、[exec 形式](#exec-form-and-shell-form) に切り替えます。exec 形式では、フックが定義されている場所に関係なく、各 `args` 要素で `${CLAUDE_PROJECT_DIR}` が置換されます。3337PowerShell シェル形式のコマンドからプロジェクトルートを参照するには、`${CLAUDE_PROJECT_DIR}` または `$env:CLAUDE_PROJECT_DIR` を記述します。v2.1.198 以降、Claude Code は `settings.json`、プラグイン、またはスキルで定義されているかどうかに関係なく、PowerShell シェル形式のコマンド内の `${CLAUDE_PROJECT_DIR}`、`${CLAUDE_PLUGIN_ROOT}`、および `${CLAUDE_PLUGIN_DATA}` プレースホルダーを PowerShell の `${env:NAME}` 形式に書き換えます。PowerShell は解析後にエクスポートされた環境から値を解決するため、プレースホルダーはダブルクォート文字列内では機能しますが、PowerShell が変数を展開しないシングルクォート文字列内では機能しません。

3338

3339v2.1.198 より前では、この書き換えはプラグインフックにのみ適用されていました。以前のバージョンでは、`settings.json` フックは `$env:` 形式または [exec 形式](#exec-form-and-shell-form) が必要です。exec 形式では、フックが定義されている場所に関係なく、各 `args` 要素で `${CLAUDE_PROJECT_DIR}` が置換されます。

3340

3341PowerShell フックで裸の `$CLAUDE_PROJECT_DIR` スペルを記述しないでください。PowerShell はそれを未定義のローカル変数として解析し、`$null` に解決します。これにより、スクリプトパスがプロジェクトルートプレフィックスなしで残されます。Claude Code はその形式を書き換えません。代わりに、[デバッグログ](#debug-hooks) に警告をログします。

3308 3342

3309以下の例は、`$env:` 形式でプロジェクトスクリプトを実行する `settings.json` フックを示しています。3343以下の例は、`$env:` 形式でプロジェクトスクリプトを実行する `settings.json` フックを示しています。これはすべてのバージョンで機能します。

3310 3344

3311```json theme={null}3345```json theme={null}

3312{3346{

hooks-guide.md +28 −24

Details

87 87

88Hooks を使用すると、Claude Code のライフサイクルの主要なポイントでコードを実行できます：編集後にファイルをフォーマットし、実行前にコマンドをブロックし、Claude が入力を必要とするときに通知を送信し、セッション開始時にコンテキストを注入するなど。Hook イベントの完全なリストについては、[Hooks リファレンス](/ja/hooks#hook-lifecycle) を参照してください。88Hooks を使用すると、Claude Code のライフサイクルの主要なポイントでコードを実行できます：編集後にファイルをフォーマットし、実行前にコマンドをブロックし、Claude が入力を必要とするときに通知を送信し、セッション開始時にコンテキストを注入するなど。Hook イベントの完全なリストについては、[Hooks リファレンス](/ja/hooks#hook-lifecycle) を参照してください。

89 89

~~90各例には、[設定ファイル](#configure-hook-location) に追加する準備ができた設定ブロックが含まれています。最も一般的なパターン：~~90各例には、[設定ファイル](#configure-hook-location) に追加する準備ができた設定ブロックが含まれています。

~~92* [Claude が入力を必要とするときに通知を受け取る](#get-notified-when-claude-needs-input)~~

~~93* [編集後にコードを自動フォーマットする](#auto-format-code-after-edits)~~

~~94* [保護されたファイルへの編集をブロックする](#block-edits-to-protected-files)~~

~~95* [圧縮後にコンテキストを再注入する](#re-inject-context-after-compaction)~~

~~96* [設定変更を監査する](#audit-configuration-changes)~~

~~97* [ディレクトリまたはファイルが変更されたときに環境をリロードする](#reload-environment-when-directory-or-files-change)~~

~~98* [特定の許可プロンプトを自動承認する](#auto-approve-specific-permission-prompts)~~

99 91

100本番環境での hooks の例として、別のモデルレビューを実行し、その結果をセッションにフィードバックする場合は、[`security-guidance` プラグインが Claude Code と統合する方法](/ja/security-guidance#how-the-plugin-integrates-with-claude-code) を参照してください。92本番環境での hooks の例として、別のモデルレビューを実行し、その結果をセッションにフィードバックする場合は、[`security-guidance` プラグインが Claude Code と統合する方法](/ja/security-guidance#how-the-plugin-integrates-with-claude-code) を参照してください。

101 93

182空の `matcher` はすべての通知タイプで発火します。特定のイベントでのみ発火させるには、次のいずれかの値に設定します：174空の `matcher` はすべての通知タイプで発火します。特定のイベントでのみ発火させるには、次のいずれかの値に設定します：

183 175

184| Matcher | 発火するタイミング |176| Matcher | 発火するタイミング |

185| :--------------------- | :-------------------------- |177| :--------------------- | :------------------------------------------------------------------------- |

184| `agent_needs_input` | バックグラウンドセッションがあなたの入力を待つのを開始します。[agent view](/ja/agent-view) が開いている間のみ発火します |

185| `agent_completed` | バックグラウンドセッションが完了または失敗します。[agent view](/ja/agent-view) が開いている間のみ発火します |

186

187`agent_needs_input` および `agent_completed` マッチャーには Claude Code v2.1.198 以降が必要です。

192 188

193`/hooks` と入力して `Notification` を選択し、hook が登録されていることを確認します。完全なイベントスキーマについては、[Notification リファレンス](/ja/hooks#notification) を参照してください。189`/hooks` と入力して `Notification` を選択し、hook が登録されていることを確認します。完全なイベントスキーマについては、[Notification リファレンス](/ja/hooks#notification) を参照してください。

194 190

198 194

199Claude が編集するすべてのファイルで [Prettier](https://prettier.io/) を自動的に実行し、手動操作なしでフォーマットの一貫性を保ちます。195Claude が編集するすべてのファイルで [Prettier](https://prettier.io/) を自動的に実行し、手動操作なしでフォーマットの一貫性を保ちます。

200 196

201この hook は `PostToolUse` イベントを `Edit|Write` マッチャーで使用するため、ファイル編集ツールの後にのみ実行されます。{/* min-version: 2.1.191 */}Claude Code v2.1.191 以降では、マッチャーを `Edit,Write` として記述することもできます。これらのバージョンではツール名マッチャーの `|` と `,` は相互に交換可能なリスト区切り文字だからです。コマンドは [`jq`](https://jqlang.github.io/jq/) で編集されたファイルパスを抽出し、Prettier に渡します。これをプロジェクトルートの `.claude/settings.json` に追加します：197この hook は `PostToolUse` イベントを `Edit|Write` マッチャーで使用するため、ファイル編集ツールの後にのみ実行されます。コマンドは [`jq`](https://jqlang.github.io/jq/) で編集されたファイルパスを抽出し、Prettier に渡します。これをプロジェクトルートの `.claude/settings.json` に追加します：

202 198

203```json theme={null}199```json theme={null}

204{200{

218}214}

219```215```

220 216

217Claude Code v2.1.191 以降では、マッチャーを `Edit,Write` として記述することもできます。これらのバージョンではツール名マッチャーの `|` と `,` は相互に交換可能なリスト区切り文字だからです。

218

221<Note>219<Note>

222 このページの Bash の例は JSON 解析に `jq` を使用します。`brew install jq`（macOS）、`apt-get install jq`（Debian/Ubuntu）でインストールするか、[`jq` ダウンロード](https://jqlang.github.io/jq/download/) を参照してください。220 このページの Bash の例は JSON 解析に `jq` を使用します。`brew install jq`（macOS）、`apt-get install jq`（Debian/Ubuntu）でインストールするか、[`jq` ダウンロード](https://jqlang.github.io/jq/download/) を参照してください。

223</Note>221</Note>

254 ```252 ```

255 </Step>253 </Step>

256 254

257 <Step title="スクリプトを実行可能にする（macOS/Linux）">255 <Step title="macOS と Linux でスクリプトを実行可能にする">

258 Claude Code が hook スクリプトを実行するには、実行可能である必要があります：256 Hook スクリプトが Claude Code で実行されるには、実行可能である必要があります：

259 257

260 ```bash theme={null}258 ```bash theme={null}

261 chmod +x .claude/hooks/protect-files.sh259 chmod +x .claude/hooks/protect-files.sh

564 Hook 出力562 Hook 出力

565</h4>563</h4>

566 564

567スクリプトは stdout または stderr に書き込み、特定のコードで終了することで、Claude Code に次に何をするかを伝えます。たとえば、コマンドをブロックしたい `PreToolUse` hook：565スクリプトは stdout または stderr に書き込み、特定のコードで終了することで、Claude Code に次に何をするかを伝えます。以下は、コマンドをブロックする `PreToolUse` hook の例です：

568 566

569```bash theme={null}567```bash theme={null}

570#!/bin/bash568#!/bin/bash

619 617

620他のイベントは異なる決定パターンを使用します。たとえば、`PostToolUse` および `Stop` hooks はトップレベルの `decision: "block"` フィールドを使用し、`PermissionRequest` は `hookSpecificOutput.decision.behavior` を使用します。リファレンスの [サマリーテーブル](/ja/hooks#decision-control) でイベント別の完全な内訳を参照してください。618他のイベントは異なる決定パターンを使用します。たとえば、`PostToolUse` および `Stop` hooks はトップレベルの `decision: "block"` フィールドを使用し、`PermissionRequest` は `hookSpecificOutput.decision.behavior` を使用します。リファレンスの [サマリーテーブル](/ja/hooks#decision-control) でイベント別の完全な内訳を参照してください。

621 619

622`UserPromptSubmit` hooks の場合、代わりに `additionalContext` を使用して Claude のコンテキストにテキストを注入します。プロンプトベースの hooks（`type: "prompt"`）は出力を異なる方法で処理します：[プロンプトベースの hooks](#prompt-based-hooks) を参照してください。620`UserPromptSubmit` hooks の場合、代わりに `additionalContext` を使用して Claude のコンテキストにテキストを注入します。

621

622Hooks with `type: "prompt"` handle output differently: see [Prompt-based hooks](#prompt-based-hooks).

623 623

624<h3 id="filter-hooks-with-matchers">624<h3 id="filter-hooks-with-matchers">

625 マッチャーで hooks をフィルタリングする625 マッチャーで hooks をフィルタリングする

807 807

808Claude Code で [`/hooks`](/ja/hooks#the-%2Fhooks-menu) を実行して、イベント別にグループ化されたすべての設定済み hooks を参照します。すべての hooks を一度に無効にするには、設定ファイルで `"disableAllHooks": true` を設定します。管理設定で設定された Hooks は、`disableAllHooks` がそこにも設定されていない限り、実行されます。808Claude Code で [`/hooks`](/ja/hooks#the-%2Fhooks-menu) を実行して、イベント別にグループ化されたすべての設定済み hooks を参照します。

809

810hooks を無効にするには、設定ファイルで `"disableAllHooks": true` を設定します。管理設定で設定された Hooks は、`disableAllHooks` がそこにも設定されていない限り、実行されます。

809 811

810Claude Code が実行中に設定ファイルを直接編集する場合、ファイルウォッチャーは通常、hook の変更を自動的に取得します。812Claude Code が実行中に設定ファイルを直接編集する場合、ファイルウォッチャーは通常、hook の変更を自動的に取得します。

811 813

925 制限927 制限

926</h3>928</h3>

927 929

930hooks を設計する際は、以下の制約を念頭に置いてください：

931

928* コマンド hooks は stdout、stderr、および終了コードを通じてのみ通信します。これらは `/` コマンドまたはツール呼び出しをトリガーできません。`additionalContext` を通じて返されたテキストは、Claude が平文として読むシステムリマインダーとして注入されます。HTTP hooks はレスポンスボディを通じて通信します。932* コマンド hooks は stdout、stderr、および終了コードを通じてのみ通信します。これらは `/` コマンドまたはツール呼び出しをトリガーできません。`additionalContext` を通じて返されたテキストは、Claude が平文として読むシステムリマインダーとして注入されます。HTTP hooks はレスポンスボディを通じて通信します。

929* Hook タイムアウトはタイプによって異なります。`timeout` フィールド（秒単位）で hook ごとにオーバーライドできます。933* Hook タイムアウトはタイプによって異なります。`timeout` フィールド（秒単位）で hook ごとにオーバーライドできます。

930 * `command`、`http`、`mcp_tool`：10 分。`UserPromptSubmit` はこれらを 30 秒に短縮し、`MessageDisplay` はこれらを 10 秒に短縮します。934 * `command`、`http`、`mcp_tool`：10 分。`UserPromptSubmit` はこれらを 30 秒に短縮し、`MessageDisplay` はこれらを 10 秒に短縮します。

931 * `prompt`：30 秒。935 * `prompt`：30 秒。

932 * `agent`：60 秒。936 * `agent`：60 秒。

933* `PostToolUse` hooks はツールが既に実行されているため、アクションを元に戻すことはできません。937* `PostToolUse` hooks はツールが既に実行されているため、アクションを元に戻すことはできません。

934* `PermissionRequest` hooks は [非インタラクティブモード](/ja/headless)（`-p`）では発火しません。自動化された許可決定には `PreToolUse` hooks を使用します。938* `PermissionRequest` hooks は [非インタラクティブモード](/ja/headless)（`-p` フラグ）では発火しません。自動化された許可決定には `PreToolUse` hooks を使用します。

935* `Stop` hooks はタスク完了時だけでなく、Claude が応答を終了するたびに発火します。ユーザーの割り込みでは発火しません。API エラーは代わりに [StopFailure](/ja/hooks#stopfailure) を発火させます。939* `Stop` hooks はタスク完了時だけでなく、Claude が応答を終了するたびに発火します。ユーザーの割り込みでは発火しません。API エラーは代わりに [StopFailure](/ja/hooks#stopfailure) を発火させます。

936* 複数の PreToolUse hooks が [`updatedInput`](/ja/hooks#pretooluse) を返してツールの引数を書き直す場合、最後に完了したものが勝ちます。Hooks は並列で実行されるため、順序は非決定的です。同じツールの入力を変更する複数の hooks を持つことを避けてください。940* 複数の `PreToolUse` hooks が [`updatedInput`](/ja/hooks#pretooluse) を返してツールの引数を書き直す場合、最後に完了したものが勝ちます。Hooks は並列で実行されるため、順序は非決定的です。同じツールの入力を変更する複数の hooks を持つことを避けてください。

937 941

938<h3 id="hooks-and-permission-modes">942<h3 id="hooks-and-permission-modes">

939 Hooks と許可モード943 Hooks と許可モード

940</h3>944</h3>

941 945

942PreToolUse hooks は任意の許可モードチェックの前に発火します。`permissionDecision: "deny"` を返す hook は、`bypassPermissions` モードまたは `--dangerously-skip-permissions` でもツールをブロックします。これにより、ユーザーが許可モードを変更してバイパスできないポリシーを適用できます。946`PreToolUse` hooks は任意の権限モードチェックの前に発火します。`permissionDecision: "deny"` を返す hook は、`bypassPermissions` モードまたは `--dangerously-skip-permissions` でもツールをブロックします。これにより、ユーザーが権限モードを変更してバイパスできないポリシーを適用できます。

943 947

944逆は真ではありません：`"allow"` を返す hook は、設定からの deny ルールをバイパスしません。Hooks は制限を厳しくできますが、許可ルールが許可する範囲を超えて緩和することはできません。948逆は真ではありません：`"allow"` を返す hook は、設定からの deny ルールをバイパスしません。Hooks は制限を厳しくできますが、許可ルールが許可する範囲を超えて緩和することはできません。

945 949

950Hook は設定されていますが、実行されません。954Hook は設定されていますが、実行されません。

951 955

952* `/hooks` を実行し、hook が正しいイベントの下に表示されることを確認します956* `/hooks` を実行し、hook が正しいイベントの下に表示されることを確認します

953* マッチャーパターンがツール名と正確にマッチすることを確認します（マッチャーは大文字小文字を区別します）957* マッチャーパターンがツール名と正確にマッチすることを確認します。マッチャーは大文字小文字を区別します

954* 正しいイベントタイプをトリガーしていることを確認します（例：`PreToolUse` はツール実行前に発火し、`PostToolUse` は後に発火します）958* 正しいイベントタイプをトリガーしていることを確認します：`PreToolUse` はツール実行前に発火し、`PostToolUse` は後に発火します

955* 非インタラクティブモード（`-p`）で `PermissionRequest` hooks を使用している場合は、代わりに `PreToolUse` に切り替えます959* 非インタラクティブモード（`-p` フラグ）で `PermissionRequest` hooks を使用している場合は、代わりに `PreToolUse` に切り替えます

956 960

957<h3 id="hook-error-in-output">961<h3 id="hook-error-in-output">

958 Hook エラーが出力に表示される962 Hook エラーが出力に表示される

976設定ファイルを編集しましたが、hooks がメニューに表示されません。980設定ファイルを編集しましたが、hooks がメニューに表示されません。

977 981

978* ファイル編集は通常自動的に取得されます。数秒後に表示されていない場合、ファイルウォッチャーが変更を見逃した可能性があります：セッションを再開して強制的にリロードします。982* ファイル編集は通常自動的に取得されます。数秒後に表示されていない場合、ファイルウォッチャーが変更を見逃した可能性があります：セッションを再開して強制的にリロードします。

979* JSON が有効であることを確認します（末尾のコンマとコメントは許可されていません）983* JSON が有効であることを確認します：末尾のコンマとコメントは許可されていません

980* 設定ファイルが正しい場所にあることを確認します：プロジェクト hooks の場合は `.claude/settings.json`、グローバル hooks の場合は `~/.claude/settings.json`984* 設定ファイルが正しい場所にあることを確認します：プロジェクト hooks の場合は `.claude/settings.json`、グローバル hooks の場合は `~/.claude/settings.json`

981 985

982<h3 id="stop-hook-hits-the-block-cap">986<h3 id="stop-hook-hits-the-block-cap">

how-claude-code-works.md +0 −1

Details

210組み込みコマンドもセットアップをガイドします：210組み込みコマンドもセットアップをガイドします：

211 211

212* `/init` はプロジェクト用の CLAUDE.md を作成するプロセスをウォークスルーします212* `/init` はプロジェクト用の CLAUDE.md を作成するプロセスをウォークスルーします

213* `/agents` はカスタム subagent を設定するのに役立ちます

214* `/doctor` はインストールの一般的な問題を診断します213* `/doctor` はインストールの一般的な問題を診断します

215 214

216<h3 id="it’s-a-conversation">215<h3 id="it’s-a-conversation">

llm-gateway-protocol.md +9 −1

Details

106 システムプロンプト属性ブロック106 システムプロンプト属性ブロック

107</h2>107</h2>

108 108

109Claude Code は、クライアントバージョンと会話から派生したフィンガープリントを含む短い属性ブロックをシステムプロンプトの前に付加します。`api.anthropic.com` エンドポイントは処理前にブロックを削除するため、ファーストパーティプロンプトキャッシングに影響しません。他のアップストリームはプロンプトの一部として受け取ります。Anthropic とクラウドプロバイダーの Claude エンドポイントは属性用に読み取るため、ゲートウェイで削除するのではなく [`CLAUDE_CODE_ATTRIBUTION_HEADER=0`](/ja/env-vars) を設定して省略してください。109Claude Code は、クライアントバージョンと会話から派生したフィンガープリントを含む短い属性ブロックをシステムプロンプトの前に付加します。`api.anthropic.com` エンドポイントは変更されていない状態で最初のシステムブロックとして到着したときに処理前にブロックを削除するため、ファーストパーティプロンプトキャッシングに影響しません。他のアップストリームはプロンプトの一部として受け取ります。

110

111削除は位置に基づいているため、ゲートウェイが `system` 配列を変更せずに転送する場合にのみ機能します。別のシステムブロックを前に付加したり、配列を並べ替えたり、単一の文字列に変換したりすると、削除が機能しなくなり、ブロックはモデルとプロンプトキャッシュキーに到達します。プロンプトから属性ブロックを除外しながら他のシステムコンテンツを保持するには、以下の方法があります。

112

113* 受け取った `system` 配列を正確に転送し、ブロックを最初に保つ：別のシステムブロックを前に付加したり、配列を並べ替えたり、単一の文字列に変換したりすると、削除が機能しなくなり、ブロックはモデルとプロンプトキャッシュキーに到達します。

114* ブロックを独自の配列エントリに保つ：エンドポイントは属性ヘッダーで始まるマージされたブロックを属性全体として扱い、マージされたすべてのコンテンツ（システムプロンプトの残りを含む）を削除します。

115* ゲートウェイがシステムコンテンツを再形成する必要がある場合は、[`CLAUDE_CODE_ATTRIBUTION_HEADER=0`](/ja/env-vars) を設定して Claude Code がブロックを省略するようにしてください。Anthropic とクラウドプロバイダーの Claude エンドポイントは属性用にブロックを読み取るため、ゲートウェイで削除または移動するのではなく、クライアント側で省略してください。

116

117変更されていない状態でエンドポイントに到達するリクエストは影響を受けません。

110 118

111{/* min-version: 2.1.181 */}Claude Code v2.1.181 から、リクエストがカスタムベース URL を通じてルーティングされる場合、ブロックは会話の存続期間中安定しているため、完全なリクエストボディをキーとするゲートウェイ側プロンプトキャッシュは無効化せずに機能します。v2.1.181 より前のバージョンでは、ブロックはリクエストごとのトークンを含みました。それらのバージョンでは、ゲートウェイがそのようなキャッシュを実装する場合は `CLAUDE_CODE_ATTRIBUTION_HEADER=0` を設定してください。119{/* min-version: 2.1.181 */}Claude Code v2.1.181 から、リクエストがカスタムベース URL を通じてルーティングされる場合、ブロックは会話の存続期間中安定しているため、完全なリクエストボディをキーとするゲートウェイ側プロンプトキャッシュは無効化せずに機能します。v2.1.181 より前のバージョンでは、ブロックはリクエストごとのトークンを含みました。それらのバージョンでは、ゲートウェイがそのようなキャッシュを実装する場合は `CLAUDE_CODE_ATTRIBUTION_HEADER=0` を設定してください。

112 120

mcp.md +43 −0

Details

1037 特定の MCP サーバーで出力警告が頻繁に発生する場合は、`MAX_MCP_OUTPUT_TOKENS` 制限を増やすことを検討してください。制御していないサーバーの場合は、サーバー作成者に `anthropic/maxResultSizeChars` 注釈を追加するか、応答をページネーションするよう依頼することもできます。注釈は画像コンテンツを返すツールには影響しません。これらの場合、`MAX_MCP_OUTPUT_TOKENS` を引き上げることが唯一のオプションです。1037 特定の MCP サーバーで出力警告が頻繁に発生する場合は、`MAX_MCP_OUTPUT_TOKENS` 制限を増やすことを検討してください。制御していないサーバーの場合は、サーバー作成者に `anthropic/maxResultSizeChars` 注釈を追加するか、応答をページネーションするよう依頼することもできます。注釈は画像コンテンツを返すツールには影響しません。これらの場合、`MAX_MCP_OUTPUT_TOKENS` を引き上げることが唯一のオプションです。

1038</Warning>1038</Warning>

1039 1039

1040<h2 id="tool-input-schemas-with-a-root-level-combinator">

1041 ツール入力スキーマとルートレベルのコンビネータ

1042</h2>

1043

1044一部の MCP サーバーは、ツールの入力スキーマを JSON Schema ユニオンとして宣言し、スキーマの最上位に `anyOf`、`oneOf`、または `allOf` があります。Claude API はこれらのキーワードをスキーマルートで受け入れません。`properties` 内にネストされたコンビネータは受け入れます。これは Claude Code が変更されずに送信します。

1045

1046Claude Code v2.1.195 以降、ルートレベルのコンビネータを持つツールは利用可能なままです。API にツールを送信する前に、Claude Code はスキーマを単一のオブジェクトにフラット化し、ツールの説明の先頭に、どのパラメータグループが一緒に属しているかを Claude に伝える文を追加します：

1047

1048* `allOf`：すべてのブランチのプロパティがマージされ、各ブランチの `required` リストは引き続き適用されます

1049* `anyOf` と `oneOf`：すべてのブランチのプロパティがマージされ、各ブランチの `required` リストはスキーマによって強制されるのではなく、ツール説明で説明されます

1050

1051サーバーは Claude が選択した引数を受け取るため、サーバー側で組み合わせの検証を続けてください。

1052

1053Claude Code が API が受け入れるスキーマを生成できない場合、またはリモート設定を受け取らないデプロイメント（オフラインマシンなど）では、そのツールをスキップし、理由をサーバーのログに記録し、サーバーの他のツールを利用可能なままにします。v2.1.195 より前のバージョンでは、入力スキーマにルートレベルの `anyOf`、`oneOf`、または `allOf` があるすべてのツールをスキップします。

1054

1055<h2 id="require-approval-for-a-specific-tool">

1056 特定のツールの承認を要求する

1057</h2>

1058

1059MCP サーバーを構築している場合、ツールの `tools/list` 応答エントリで `_meta["anthropic/requiresUserInteraction"]` を `true` に設定することで、ツールがすべての呼び出しで明示的な承認を必要とするとマークできます。値は JSON ブール値 `true` である必要があります。他の値は無視されます。

1060

1061Claude Code は、`acceptEdits`、`auto`、`bypassPermissions` [権限モード](/ja/permissions#permission-modes) でも、そのツールの権限プロンプトをすべての呼び出しで表示し、「今後は聞かない」オプションを提供しません。[許可ルール](/ja/permissions#permission-rule-syntax) がツールと一致しても、プロンプトをスキップしません。`dontAsk` モードでは、プロンプトを表示しないため、Claude Code は呼び出しを拒否します。

1062

1063プロンプトは人に到達する必要があります。[`--permission-prompt-tool`](/ja/cli-reference#cli-flags) を使用した非対話型モードでは、フラグ付きツールのプロンプトツールからの `allow` 結果は、メッセージ `MCP tool requires user interaction; not supported via --permission-prompt-tool` を含む拒否に変換されます。Agent SDK の [`canUseTool` コールバック](/ja/agent-sdk/permissions) はこれらの呼び出しを受け取り、承認できます。SDK ホストはユーザーに表示することが期待されるためです。

1064

1065これは、同意またはアクセス許可ステップなど、権限プロンプト自体がポイントであるツールに使用します。自動承認は人間が同意しないことを意味するため。同じサーバーの他のツールは通常の権限動作を保持します。

1066

1067次の `tools/list` エントリは、1 つのツールを常に承認が必要とマークします。

1068

1069```json theme={null}

1070{

1071 "name": "grant_access",

1072 "description": "Requests access to a protected resource",

1073 "_meta": {

1074 "anthropic/requiresUserInteraction": true

1075 }

1076}

1077```

1078

1079`anthropic/requiresUserInteraction` 注釈には Claude Code v2.1.199 以降が必要です。以前のバージョンはそれを無視し、標準的な権限フローを適用します。

1080

1081セッションが [Remote Control](/ja/remote-control) または SDK ホストに接続されている場合、Claude Code は権限リクエストをユーザーインタラクションが必要とマークするため、クライアントはワンタップ承認アクションの代わりにツールの権限プロンプトを表示します。

1082

1040<h2 id="respond-to-mcp-elicitation-requests">1083<h2 id="respond-to-mcp-elicitation-requests">

1041 MCP 応答要求に対応する1084 MCP 応答要求に対応する

1042</h2>1085</h2>

memory.md +1 −3

Details

235- OpenAPI ドキュメンテーションコメントを含めます235- OpenAPI ドキュメンテーションコメントを含めます

236```236```

237 237

238`paths` フィールドのないルールは無条件に読み込まれ、すべてのファイルに適用されます。パススコープルールは、すべてのツール使用時ではなく、パターンに一致するファイルを読むときにトリガーされます。238`paths` フィールドのないルールは無条件に読み込まれ、すべてのファイルに適用されます。パススコープルールは、すべてのツール使用時ではなく、パターンに一致するファイルを読むときにトリガーされます。`paths` フィールドでグロブパターンを使用して、拡張子、ディレクトリ、またはその組み合わせでファイルを一致させます。

~~239~~

240`paths` フィールドでグロブパターンを使用して、拡張子、ディレクトリ、またはその組み合わせでファイルを一致させます。

241 239

242| パターン | 一致 |240| パターン | 一致 |

243| ---------------------- | ------------------------------- |241| ---------------------- | ------------------------------- |

model-config.md +53 −7

Details

31 31

32| モデルエイリアス | 動作 |32| モデルエイリアス | 動作 |

33| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |33| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

84* `Enter`：モデルを切り替えてデフォルトとして保存84* `Enter`：モデルを切り替えてデフォルトとして保存

85* `s`：このセッションのみモデルを切り替え85* `s`：このセッションのみモデルを切り替え

86 86

~~87`/model <name>` を直接入力すると、`Enter` のように動作します。プロジェクトおよび管理設定は引き続き優先され、次の起動時に再度適用されます。~~87`/model <name>` を直接入力すると、`Enter` のように動作します。プロジェクトおよび管理設定は引き続き優先され、次の起動時に再度適用されます。{/* min-version: 2.1.196 */}管理者が設定した[組織デフォルトモデル](#organization-default-model)も次の起動時に再度適用されます。

88 88

89v2.1.144 から v2.1.152 では、`/model` は現在のセッションにのみ適用され、ピッカーで `d` を押すとデフォルトが保存されました。89v2.1.144 から v2.1.152 では、`/model` は現在のセッションにのみ適用され、ピッカーで `d` を押すとデフォルトが保存されました。

90 90

128* **メインセッションモデル**：`/model`、`--model` フラグ、`ANTHROPIC_MODEL` 環境変数、`model` 設定、および [セッションを再開する](#setting-your-model) ときに復元されるモデル128* **メインセッションモデル**：`/model`、`--model` フラグ、`ANTHROPIC_MODEL` 環境変数、`model` 設定、および [セッションを再開する](#setting-your-model) ときに復元されるモデル

129* **エイリアス解決**：{/* min-version: 2.1.176 */}`ANTHROPIC_DEFAULT_OPUS_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_HAIKU_MODEL`、および `ANTHROPIC_DEFAULT_FABLE_MODEL` 環境変数は、許可されたエイリアスをリスト外のモデルにリダイレクトすることはできません129* **エイリアス解決**：{/* min-version: 2.1.176 */}`ANTHROPIC_DEFAULT_OPUS_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_HAIKU_MODEL`、および `ANTHROPIC_DEFAULT_FABLE_MODEL` 環境変数は、許可されたエイリアスをリスト外のモデルにリダイレクトすることはできません

130* **高速モード**：{/* min-version: 2.1.176 */}`/fast` は、リスト外の Opus モデルに暗黙的に切り替わる場合、「is not in your organization's allowed models」というメッセージで切り替えを拒否します130* **高速モード**：{/* min-version: 2.1.176 */}`/fast` は、リスト外の Opus モデルに暗黙的に切り替わる場合、「is not in your organization's allowed models」というメッセージで切り替えを拒否します

131* **サブエージェントモデル**：[サブエージェント](/ja/sub-agents#choose-a-model) frontmatter の `model` フィールド、Agent ツールの `model` パラメータ、`/agents` のモデルピッカー、および `CLAUDE_CODE_SUBAGENT_MODEL`131* **サブエージェントモデル**：[サブエージェント](/ja/sub-agents#choose-a-model) frontmatter の `model` フィールド、Agent ツールの `model` パラメータ、`CLAUDE_CODE_SUBAGENT_MODEL`、および v2.1.197 以前では `/agents` ウィザードのモデルピッカー {/* max-version: 2.1.197 */}

132* **スキルおよびコマンドモデル**：[スキルおよびコマンド](/ja/skills) の `model` frontmatter132* **スキルおよびコマンドモデル**：[スキルおよびコマンド](/ja/skills) の `model` frontmatter

133* **アドバイザーモデル**：設定された [`advisorModel`](/ja/advisor) 設定および `--advisor` フラグ133* **アドバイザーモデル**：設定された [`advisorModel`](/ja/advisor) 設定および `--advisor` フラグ

134* **バックグラウンドエージェントモデル**：[ディスパッチピッカー](/ja/agent-view) で選択されたモデル134* **バックグラウンドエージェントモデル**：[ディスパッチピッカー](/ja/agent-view) で選択されたモデル

135 135

136`/model` でブロックされたモデルに切り替えるとエラーで拒否されますが、ブロックされた `--model` フラグ、`ANTHROPIC_MODEL`、または `model` 設定値は起動時に警告とともに置き換えられ、要求されたモデルと置き換えられたモデルの両方を名前で示し、セッションはデフォルトモデルで開始されます。ブロックされたサブエージェント、スキル、またはコマンドのオーバーライドは、リクエストを失敗させるのではなく、継承またはデフォルトモデルにフォールバックします。ブロックされた `advisorModel` 設定はセッションのアドバイザーを無効にし、ブロックされた `--advisor` フラグ値は起動時にエラーで終了します。除外されたモデルは `/model` ピッカーから非表示になります。136`/model` でブロックされたモデルに切り替えるとエラーで拒否されますが、ブロックされた `--model` フラグ、`ANTHROPIC_MODEL`、または `model` 設定値は起動時に警告とともに置き換えられ、要求されたモデルと置き換えられたモデルの両方を名前で示し、セッションはデフォルトモデルで開始されます。ブロックされたサブエージェント、スキル、またはコマンドのオーバーライドは、リクエストを失敗させるのではなく、継承またはデフォルトモデルにフォールバックします。ブロックされた `advisorModel` 設定はセッションのアドバイザーを無効にし、ブロックされた `--advisor` フラグ値は起動時にエラーで終了します。除外されたモデルは `/model` ピッカーから非表示になります。{/* min-version: 2.1.199 */}v2.1.199 以降では、リストに組み込みピッカー行がない完全なモデル ID（リストがピン留めする古いバージョンなど）は、`/model` ピッカーに独自のラベル付き行として表示されます。以前のバージョンではそのような ID は `/model <id>` を入力することでのみ選択可能です。

137 137

138自動モデル変更は同じ方法でチェックされます。[フォールバックモデルチェーン](#fallback-model-chains) のアローリスト外の要素は削除され、[`opusplan`](#opusplan-model-setting) などのプランモードアップグレードが除外されたモデルに対して実行される場合、計画はセッションのモデルで続行されるようにスキップされ、ターゲットが除外されている [自動モデルフォールバック](#automatic-model-fallback) は実行されないため、フラグが付けられたリクエストは拒否で終了します。[高速モード](/ja/fast-mode) を有効にすることは、セッションが実行されるモデルがアローリスト外にある場合に拒否されます。138自動モデル変更は同じ方法でチェックされます。[フォールバックモデルチェーン](#fallback-model-chains) のアローリスト外の要素は削除され、[`opusplan`](#opusplan-model-setting) などのプランモードアップグレードが除外されたモデルに対して実行される場合、計画はセッションのモデルで続行されるようにスキップされ、ターゲットが除外されている [自動モデルフォールバック](#automatic-model-fallback) は実行されないため、フラグが付けられたリクエストは拒否で終了します。[高速モード](/ja/fast-mode) を有効にすることは、セッションが実行されるモデルがアローリスト外にある場合に拒否されます。

139 139

165 デフォルトモデルの動作165 デフォルトモデルの動作

166</h3>166</h3>

167 167

168モデルピッカーの Default オプションは、[`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) も設定されていない限り、`availableModels` の影響を受けません。単独では、`availableModels` は Default を利用可能なままにし、[ユーザーのサブスクリプション層に基づいた](#default-model-setting) システムのランタイムデフォルトに解決されます。ティアのデフォルトが制限する予定のモデルである場合、`enforceAvailableModels` も設定してください。168モデルピッカーの Default オプションは、[`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) も設定されていない限り、`availableModels` の影響を受けません。単独では、`availableModels` は Default を利用可能なままにし、アカウントのシステムの [ランタイムデフォルト](#default-model-setting) に解決されます。ティアのデフォルトが制限する予定のモデルである場合、`enforceAvailableModels` も設定してください。

169 169

170空の `availableModels` 配列は Default モデル強制を実行しません。`availableModels: []` の場合、名前付きモデル選択はブロックされますが、アカウントタイプの Default モデルは `enforceAvailableModels` に関係なく使用可能なままです。170空の `availableModels` 配列は Default モデル強制を実行しません。`availableModels: []` の場合、名前付きモデル選択はブロックされますが、アカウントタイプの Default モデルは `enforceAvailableModels` に関係なく使用可能なままです。

171 171

244 244

2452 つの制限は一緒に適用されます。モデルは `availableModels` で許可され、組織によって制限されていない場合にのみ選択可能です。組織制限は Anthropic API および [LLM ゲートウェイ](/ja/llm-gateway) デプロイメント上のセッションに配信されます。Bedrock、Vertex AI、Foundry、および Claude Platform on AWS 上のセッションはそれらを受け取らないため、代わりにそれらのプロバイダーで `availableModels` を使用してください。2452 つの制限は一緒に適用されます。モデルは `availableModels` で許可され、組織によって制限されていない場合にのみ選択可能です。組織制限は Anthropic API および [LLM ゲートウェイ](/ja/llm-gateway) デプロイメント上のセッションに配信されます。Bedrock、Vertex AI、Foundry、および Claude Platform on AWS 上のセッションはそれらを受け取らないため、代わりにそれらのプロバイダーで `availableModels` を使用してください。

246 246

247<h2 id="organization-default-model">

248 組織デフォルトモデル

249</h2>

250

251{/* plan-availability: feature=org-default-model plans=enterprise */}

252

253Claude Enterprise プランの組織管理者は、claude.ai 管理コンソールから Claude Code メンバーのデフォルトモデルを、組織全体またはカスタムロール単位で設定できます。設定されている場合、Default オプションは [アカウントタイプのデフォルト](#default-model-setting) ではなく、そのモデルに解決されます。Claude Code v2.1.196 以降が必要です。

254

255`/model` ピッカーの Default 行は、組織デフォルトの名前を「Org default」というラベルで表示します。ラベルは、管理者が組織全体のデフォルトを設定したか、ロール用に設定したかに関係なく「Org default」と表示されます。ロールデフォルトはそのカスタムロールのメンバーをカバーし、組織全体のデフォルトより優先されます。複数のロールが異なるデフォルトを設定する場合、最も高性能なモデルが適用されます。

256

257組織デフォルトは開始点であり、制限ではなく、他のモデル選択はそれより優先されます。

258

259* `--model` フラグと `ANTHROPIC_MODEL` 環境変数

260* [管理設定](/ja/settings#settings-files) または `--settings` で提供される `model` 値

261* ユーザー、プロジェクト、またはローカル設定の `model` 値（`/model` で保存したモデルを含む）

262

263管理者は、組織デフォルトをユーザー選択をオーバーライドするように設定することもできます。オーバーライドがオンの場合、ユーザー、プロジェクト、およびローカル設定の `model` 値より優先されるため、`/model` で保存したモデルは現在のセッションに適用され、組織デフォルトは次の起動時に戻ります。選択が異なる場合、`/model` は `Your organization's default (<model>) applies on restart` を表示します。`--model` フラグ、`ANTHROPIC_MODEL`、管理設定、および `--settings` はオーバーライドがオンの場合でも優先されます。オーバーライドは限定的な組織セットで利用可能です。利用可能性については Anthropic アカウントチームに問い合わせてください。

264

265メンバーが選択できるモデルを制限するには、[組織モデル制限](#organization-model-restrictions) または [`availableModels`](#restrict-model-selection) を代わりに使用してください。

266

267Claude Code は起動時に組織デフォルトを 1 回読み込むため、管理者が中途で変更したデフォルトは次の起動時に有効になります。

268

269組織デフォルトがユーザー選択をオーバーライドしない場合、管理者がそれを変更した後の最初のインタラクティブ起動は、ユーザー設定から `model` キーを 1 回クリアするため、新しいデフォルトが適用されます。ファイル内の他の何も変更されず、その起動後に `/model` で保存したモデルは保持されます。

270

271組織デフォルトは、採用される前に他の Default モデルと同じ制限チェックを通過します。

272

273* [`availableModels`](#restrict-model-selection) 単独では Default オプションを制限しないため、アローリスト外の組織デフォルトは引き続き適用されます。[`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) も設定されている場合、アローリスト外の組織デフォルトは、他の Default と同様に最初のアローリストエントリに再マップされます

274* [組織モデル制限](#organization-model-restrictions) がアカウントに対して拒否する組織デフォルトは、そのファミリーの最新許可モデル、またはそのバージョンがすべて制限されている場合は低コストファミリーに置き換えられます

275* [ゼロデータ保持](/ja/zero-data-retention) の下での Fable 5 など、アカウントで利用できない組織デフォルトはスキップされ、Default オプションはアカウントタイプのデフォルトに解決されます

276

277v2.1.199 以降では、組織デフォルトがアカウントタイプの通常のデフォルトと異なるモデルファミリーである場合、`/model` ピッカーはそのファミリーの別の行を保持するため、セッション用にそれに切り替えることができます。v2.1.196 から v2.1.198 ではその行はピッカーから欠落しています。

278

279組織デフォルトは Anthropic API で認証されたセッションに配信されます。[LLM ゲートウェイ](/ja/llm-gateway) デプロイメント、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および Claude Platform on AWS 上のセッションはそれを受け取りません。これらのデプロイメントでデフォルトを設定するには、[管理設定](/ja/settings#settings-files) で `model` キーを代わりに使用してください。

280

281<h2 id="organization-effort-limits">

282 組織努力制限

283</h2>

284

285{/* plan-availability: feature=org-effort-limits plans=enterprise */}

286

287Claude Enterprise プランの組織管理者は、ロールレベルの [組織モデル制限](#organization-model-restrictions) と一緒に、各カスタムロール用のモデルごとに最大 [努力レベル](#adjust-effort-level) を設定できます。キャップ以上のレベルは `/effort` ピッカーで提供されず、`--effort` または `/effort` で高いレベルを名前で指定すると、キャップで実行されます。インタラクティブセッションおよびプレーンテキスト `--print` 実行では、警告は要求されたレベルと適用されたレベルを名前で示します。`json` または `stream-json` 出力またはバックグラウンドエージェントでは、クランプは静かに適用されます。キャップはモデルごとであるため、モデルを切り替えると利用可能なレベルが変わる可能性があります。複数のロールが同じモデルを付与する場合、最も制限の少ないキャップが適用されます。Claude Code v2.1.195 以降が必要です。

288

289努力制限は [組織モデル制限](#organization-model-restrictions) と一緒に配信され、同じプロバイダー利用可能性に従います。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および Claude Platform on AWS 上のセッションはそれらを受け取りません。

290

247<h2 id="special-model-behavior">291<h2 id="special-model-behavior">

248 特別なモデルの動作292 特別なモデルの動作

249</h2>293</h2>

261 305

262Enterprise 従量課金とは、サブスクリプションシートではなく使用量で請求される Enterprise 組織を意味します。306Enterprise 従量課金とは、サブスクリプションシートではなく使用量で請求される Enterprise 組織を意味します。

263 307

264管理設定が[Default モデルの許可リストを強制](#enforce-the-allowlist-for-the-default-model)し、アカウントタイプのデフォルトが `availableModels` にない場合、`default` は上記のアカウントタイプのデフォルトではなく、強制された Default に解決されます。308管理者が [組織デフォルトモデル](#organization-default-model) を設定している場合、`default` は上記のアカウントタイプのデフォルトではなく、そのモデルに解決されます。Claude Code v2.1.196 以降が必要です。

309

310管理設定が [Default モデルのアローリストを強制](#enforce-the-allowlist-for-the-default-model) し、アカウントタイプのデフォルトが `availableModels` にない場合、`default` は上記のアカウントタイプのデフォルトではなく、強制された Default に解決されます。両方が適用される場合、組織デフォルトはアカウントタイプのデフォルトを最初に置き換え、強制がそれに適用されます。許可リストに登録された組織デフォルトは保持され、リスト外のものは強制された Default に解決されます。

265 311

266Fable 5 はどのアカウントタイプでもデフォルトモデルではありません。セッションは `/model fable`、`model` 設定、または Fable 5 が利用可能な `best` エイリアスで選択した後にのみ Fable 5 を使用します。`/model` で選択すると、ユーザー設定で選択されたモデルとして保存されるため、モデルを変更するまで後続のセッションは Fable 5 で開始されます。312Fable 5 はどのアカウントタイプでもデフォルトモデルではありません。セッションは `/model fable`、`model` 設定、または Fable 5 が利用可能な `best` エイリアスで選択した後にのみ Fable 5 を使用します。`/model` で選択すると、ユーザー設定で選択されたモデルとして保存されるため、モデルを変更するまで後続のセッションは Fable 5 で開始されます。

267 313

379 425

380アクティブなモデルがサポートしないレベルを設定した場合、Claude Code は設定したレベル以下の最高サポートレベルにフォールバックします。例えば、`xhigh` は Opus 4.6 では `high` として実行されます。426アクティブなモデルがサポートしないレベルを設定した場合、Claude Code は設定したレベル以下の最高サポートレベルにフォールバックします。例えば、`xhigh` は Opus 4.6 では `high` として実行されます。組織は、モデルに対して利用可能なレベルをキャップすることもできます。[組織努力制限](#organization-effort-limits)を参照してください。

381 427

382デフォルト努力は Fable 5、Sonnet 5、Opus 4.8、Opus 4.6、Sonnet 4.6 では `high` で、Opus 4.7 では `xhigh` です。428デフォルト努力は Fable 5、Sonnet 5、Opus 4.8、Opus 4.6、Sonnet 4.6 では `high` で、Opus 4.7 では `xhigh` です。

383 429

monitoring-usage.md +1 −1

Details

1184 1184

1185Claude Code は失敗した API リクエストを内部的に再試行し、あきらめた後にのみ単一の `claude_code.api_error` イベントを出力するため、イベント自体がそのリクエストの終端信号です。中間再試行試行は個別のイベントとしてログされません。1185Claude Code は失敗した API リクエストを内部的に再試行し、あきらめた後にのみ単一の `claude_code.api_error` イベントを出力するため、イベント自体がそのリクエストの終端信号です。中間再試行試行は個別のイベントとしてログされません。

1186 1186

1187イベントの `attempt` 属性は、試行の総数を記録します。`CLAUDE_CODE_MAX_RETRIES` はデフォルトで 10 で、15 で上限です。リクエストが一時的なエラーのすべての再試行を枯渇させた場合、`attempt` はその有効な制限より 1 つ多くなります: デフォルトでは 11、16 を超えることはありません。より低い値は、`400` レスポンスなどの再試行不可能なエラーを示します。1187イベントの `attempt` 属性は、試行の総数を記録します。`CLAUDE_CODE_MAX_RETRIES` はデフォルトで 10 で、15 で上限です。v2.1.199 以降では、`CLAUDE_CODE_RETRY_WATCHDOG` はデフォルトを引き上げ、上限を削除します。リクエストが一時的なエラーのすべての再試行を枯渇させた場合、`attempt` はその有効な制限より 1 つ多くなります: デフォルトでは 11、ウォッチドッグが設定されていない限り 16 を超えることはありません。より低い値は、`400` レスポンスなどの再試行不可能なエラーを示します。

1188 1188

1189セッションが回復したものと停止したものを区別するには、イベントを `session.id` でグループ化し、エラーの後に後続の `api_request` イベントが存在するかどうかを確認します。1189セッションが回復したものと停止したものを区別するには、イベントを `session.id` でグループ化し、エラーの後に後続の `api_request` イベントが存在するかどうかを確認します。

1190 1190

permission-modes.md +22 −7

Details

237* フォースプッシュ、または `main` への直接プッシュ237* フォースプッシュ、または `main` への直接プッシュ

238* {/* min-version: 2.1.182 */}`git reset --hard`、`git checkout -- .`、`git restore .`、`git clean -fd`、`git stash drop`、または `git stash clear`。分類器はこれらがコミットされていない変更を破棄すると推定します238* {/* min-version: 2.1.182 */}`git reset --hard`、`git checkout -- .`、`git restore .`、`git clean -fd`、`git stash drop`、または `git stash clear`。分類器はこれらがコミットされていない変更を破棄すると推定します

239* `git commit --amend`。HEAD のコミットがこのセッションで作成されていない場合239* `git commit --amend`。HEAD のコミットがこのセッションで作成されていない場合

240* {/* min-version: 2.1.198 */}v2.1.198 から、`git commit --amend`。HEAD のコミットが既にプッシュされている場合。メッセージのみの言い換えはブロックされません。`--amend -m` で新たにステージされたものがなく、Claude がこのセッション中に作成したコミット上

240* `terraform destroy`、`pulumi destroy`、`cdk destroy`、または `terragrunt destroy`。リソースを破壊するプランを適用する場合241* `terraform destroy`、`pulumi destroy`、`cdk destroy`、または `terragrunt destroy`。リソースを破壊するプランを適用する場合

241 242

242Claude Code v2.1.195 以降はデフォルトでより多くのカテゴリをブロックします。いくつかは [環境](/ja/auto-mode-config#define-trusted-infrastructure) エントリに依存します。例えば、機密リモートターゲットと保護された IaC スコープなど。これらを具体的な名前に絞ることができます。243Claude Code v2.1.195 以降はデフォルトでより多くのカテゴリをブロックします。いくつかは [環境](/ja/auto-mode-config#define-trusted-infrastructure) エントリに依存します。例えば、機密リモートターゲットと保護された IaC スコープなど。これらを具体的な名前に絞ることができます。

251* 機密リモートターゲットへのインタラクティブシェルまたはポートフォワード252* 機密リモートターゲットへのインタラクティブシェルまたはポートフォワード

252* ローカルサービスをパブリックインターネットから到達可能にするトンネルまたはリバースシェルの開設253* ローカルサービスをパブリックインターネットから到達可能にするトンネルまたはリバースシェルの開設

253* トランスクリプトまたはファイルへのライブ認証情報またはトークンの印刷254* トランスクリプトまたはファイルへのライブ認証情報またはトークンの印刷

254* PII または規制対象データの場所へのアクセス、またはそこからのデータのコピー255* [環境](/ja/auto-mode-config#define-trusted-infrastructure) で機密データロケーションとしてリストされている場所へのアクセス、またはそこからのデータのコピー。{/* min-version: 2.1.198 */}v2.1.198 以降、これはエントリが除外する対象者にそこからデータを送信することもブロックします

255* パッケージインストールを内部パッケージレジストリの周りからパブリックレジストリにルーティング256* パッケージインストールを内部パッケージレジストリの周りからパブリックレジストリにルーティング。{/* min-version: 2.1.198 */}v2.1.198 以降、これは会話で Claude に内部レジストリまたはミラーが存在することを伝えた場合にも適用されます。環境にリストされている場合だけではなく

256* `--insecure` のようなセーフティガードを解除するフラグを使用したコマンドの実行257* `--insecure` のようなセーフティガードを解除するフラグを使用したコマンドの実行

258* `--dangerously-skip-permissions` または `--no-sandbox` で開始されたものなど、人間の承認またはサンドボックスなしで実行される自律エージェントループの起動。{/* min-version: 2.1.198 */}v2.1.198 以降、これは `--yes-always` で開始されたランナーなど、分離とアクションごとの承認を無効にして実行される第三者エージェントまたは eval ハーネスもカバーします

257* [Claude in Chrome](/ja/chrome) ブラウザアクション。ページコンテンツ、クッキー、または認証情報をオリジン外に送信する可能性があります259* [Claude in Chrome](/ja/chrome) ブラウザアクション。ページコンテンツ、クッキー、または認証情報をオリジン外に送信する可能性があります

258 260

261Claude Code v2.1.198 以降はこれらもデフォルトでブロックします。

262

263* `/tmp`、`$TMPDIR`、または別の共有スクラッチまたはキャッシュディレクトリ内のファイルを、特定の名前付きパスではなく、ワイルドカード、glob、または年齢フィルターで削除

264* 自身のメッセージがその受信者にそれらの詳細を認可しなかった場合、送信、アップロード、公開、または他の人または共有システムに書き込まれるコンテンツに機密詳細を含める

265* Claude Code 独自の tmux ペインにキーストロークを送信して独自のインターフェースを駆動。分類器はこれを Claude が独自の権限または監視を変更することとして扱います

266

259**デフォルトで許可**：267**デフォルトで許可**：

260 268

261* 作業ディレクトリ内のローカルファイル操作269* 作業ディレクトリ内のローカルファイル操作

272* [`environment`](/ja/auto-mode-config#define-trusted-infrastructure) にリストされている信頼できるドメイン、バケット、サービスへのデータ送信。これはデータフローのみをカバーし、同じインフラストラクチャ上の破壊的または認証情報操作ではありません280* [`environment`](/ja/auto-mode-config#define-trusted-infrastructure) にリストされている信頼できるドメイン、バケット、サービスへのデータ送信。これはデータフローのみをカバーし、同じインフラストラクチャ上の破壊的または認証情報操作ではありません

273* [Claude in Chrome](/ja/chrome) の信頼できる内部ドメイン、localhost、または名前を付けた URL へのナビゲーション281* [Claude in Chrome](/ja/chrome) の信頼できる内部ドメイン、localhost、または名前を付けた URL へのナビゲーション

274 282

275サンドボックスネットワークアクセスリクエストはデフォルトで許可されるのではなく、分類器を通じてルーティングされます。`claude auto-mode defaults` を実行して完全なルールリストを確認してください。日常的なアクションがブロックされている場合、管理者は `autoMode.environment` 設定を通じて信頼できるリポジトリ、バケット、サービスを追加できます。[自動モードを設定](/ja/auto-mode-config) を参照してください。283サンドボックスネットワークアクセスリクエストはデフォルトで許可されるのではなく、分類器を通じてルーティングされます。{/* min-version: 2.1.198 */}v2.1.198 以降、分類器はネットワークホストとポートの判定を再利用し、接続のたびに再実行するのではなく。

284

285* 許可は新しいコンテンツが会話に入るまで再利用され、その時点でそのホストが再度チェックされます

286* インタラクティブ CLI では、拒否はターンが終了するときにドロップされます

287* [非対話的モード](/ja/headless) と Agent SDK セッションではターン境界がないため、拒否はランの残りの間再利用されます

288* 権限モードまたはルールを変更すると、すべてのキャッシュされた判定がドロップされます

289

290`claude auto-mode defaults` を実行して完全なルールリストを確認してください。日常的なアクションがブロックされている場合、管理者は `autoMode.environment` 設定を通じて信頼できるリポジトリ、バケット、サービスを追加できます。[自動モードを設定](/ja/auto-mode-config) を参照してください。

276 291

277<h3 id="boundaries-you-state-in-conversation">292<h3 id="boundaries-you-state-in-conversation">

278 会話で述べる境界293 会話で述べる境界

300 315

301 1. [allow または deny ルール](/ja/permissions#manage-permissions) に一致するアクションは即座に解決されます。ただし、[保護されたパス](#protected-paths) への書き込みは、allow ルールが一致する場合でも分類器にルーティングされます316 1. [allow または deny ルール](/ja/permissions#manage-permissions) に一致するアクションは即座に解決されます。ただし、[保護されたパス](#protected-paths) への書き込みは、allow ルールが一致する場合でも分類器にルーティングされます

302 2. 読み取り専用アクションと作業ディレクトリ内のファイル編集は自動承認されます。[保護されたパス](#protected-paths) への書き込みを除く317 2. 読み取り専用アクションと作業ディレクトリ内のファイル編集は自動承認されます。[保護されたパス](#protected-paths) への書き込みを除く

303 3. その他すべては分類器に送られます318 3. その他すべては分類器に送られます。{/* min-version: 2.1.199 */}v2.1.199 以降、[`_meta["anthropic/requiresUserInteraction"]`](/ja/mcp#require-approval-for-a-specific-tool) でマークされた MCP ツールは分類器をスキップし、直接プロンプトを表示するため、同意ステップはツール作成者の代わりに自動承認されることはありません

304 4. 分類器がブロックする場合、Claude は理由を受け取り、別のアプローチを試みます319 4. 分類器がブロックする場合、Claude は理由を受け取り、別のアプローチを試みます

305 320

306 自動モードに入ると、任意のコード実行を許可する広いルールが削除されます。321 自動モードに入ると、任意のコード実行を許可する広いルールが削除されます。

326 </Accordion>341 </Accordion>

327 342

328 <Accordion title="コストとレイテンシ">343 <Accordion title="コストとレイテンシ">

329 分類器は `/model` 選択から独立したサーバー設定モデルで実行されるため、モデルの切り替えは分類器の可用性を変更しません。分類器呼び出しはトークン使用量にカウントされます。各チェックはトランスクリプトの一部と保留中のアクションを送信し、実行前にラウンドトリップを追加します。保護されたパス外の読み取りと作業ディレクトリ編集は分類器をスキップするため、オーバーヘッドは主にシェルコマンドとネットワーク操作から発生します。344 分類器は `/model` 選択から独立したサーバー設定モデルで実行されるため、モデルの切り替えは分類器の可用性を変更しません。分類器呼び出しはトークン使用量にカウントされます。各チェックはトランスクリプトの一部と保留中のアクションを送信し、実行前にラウンドトリップを追加します。保護されたパス外の読み取りと作業ディレクトリ編集は分類器をスキップするため、オーバーヘッドは主にシェルコマンドとネットワーク操作から発生します。{/* min-version: 2.1.198 */}v2.1.198 以降、サンドボックスネットワーク判定はホストとポートに対して再利用され、接続のたびに再分類されるのではなく、繰り返される接続は同じホストへのチェックを追加しません。[分類器がデフォルトでブロックするもの](#what-the-classifier-blocks-by-default) は許可と拒否がどのくらい続くかを説明しています。

330 </Accordion>345 </Accordion>

331</AccordionGroup>346</AccordionGroup>

332 347

334 dontAsk モードで事前承認済みツールのみを許可する349 dontAsk モードで事前承認済みツールのみを許可する

335</h2>350</h2>

336 351

337`dontAsk` モードはプロンプトが表示されるすべてのツール呼び出しを自動的に拒否します。`permissions.allow` ルールと [読み取り専用 Bash コマンド](/ja/permissions#read-only-commands)に一致するアクションのみが実行できます。明示的な [`ask` ルール](/ja/permissions#manage-permissions)はプロンプトするのではなく拒否されます。これにより、モードは CI パイプラインまたは Claude が実行を許可されているものを事前に定義する制限環境で完全に非対話的になります。[Claude Code on the web](/ja/claude-code-on-the-web)上のクラウドセッションは `defaultMode: "dontAsk"` を無視します。詳細は [bypassPermissions](#skip-all-checks-with-bypasspermissions-mode)を参照してください。352`dontAsk` モードはプロンプトが表示されるすべてのツール呼び出しを自動的に拒否します。このモードがアクティブな間、ステータスバーに `⏵⏵ don't ask on` が表示されます。`permissions.allow` ルールと [読み取り専用 Bash コマンド](/ja/permissions#read-only-commands)に一致するアクションのみが実行できます。明示的な [`ask` ルール](/ja/permissions#manage-permissions)はプロンプトするのではなく拒否されます。{/* min-version: 2.1.199 */}v2.1.199 以降、allow ルールが一致する場合でも、[`_meta["anthropic/requiresUserInteraction"]`](/ja/mcp#require-approval-for-a-specific-tool)でマークされた MCP ツールはこのモードで拒否されます。これは、その承認カードがこのモードが収集することのない回答を必要とするためです。これにより、モードは CI パイプラインまたは Claude が実行を許可されているものを事前に定義する制限環境で完全に非対話的になります。[Claude Code on the web](/ja/claude-code-on-the-web)上のクラウドセッションは `defaultMode: "dontAsk"` を無視します。詳細は [bypassPermissions](#skip-all-checks-with-bypasspermissions-mode)を参照してください。

338 353

339フラグで起動時に設定します。354フラグで起動時に設定します。

340 355

346 bypassPermissions モードですべてのチェックをスキップする361 bypassPermissions モードですべてのチェックをスキップする

347</h2>362</h2>

348 363

349`bypassPermissions` モードは権限プロンプトと安全チェックを無効にするため、ツール呼び出しは即座に実行されます。v2.1.126 以降、これには[保護されたパス](#protected-paths)への書き込みが含まれます。これより前のバージョンではまだプロンプトが表示されていました。明示的な[ask ルール](/ja/permissions#manage-permissions)はこのモードでもプロンプトを強制し、ファイルシステムのルートまたはホームディレクトリを対象とした削除（`rm -rf /` や `rm -rf ~` など）は、モデルエラーに対する回路遮断器として機能するため、引き続きプロンプトが表示されます。このモードは、Claude Code がホストシステムに損害を与えることができないコンテナ、VM、またはインターネットアクセスのない dev container のような隔離環境でのみ使用してください。364`bypassPermissions` モードは権限プロンプトと安全チェックを無効にするため、ツール呼び出しは即座に実行されます。v2.1.126 以降、これには[保護されたパス](#protected-paths)への書き込みが含まれます。これより前のバージョンではまだプロンプトが表示されていました。明示的な[ask ルール](/ja/permissions#manage-permissions)はこのモードでもプロンプトを強制し、ファイルシステムのルートまたはホームディレクトリを対象とした削除（`rm -rf /` や `rm -rf ~` など）は、モデルエラーに対する回路遮断器として機能するため、引き続きプロンプトが表示されます。{/* min-version: 2.1.199 */}v2.1.199 以降、[`_meta["anthropic/requiresUserInteraction"]`](/ja/mcp#require-approval-for-a-specific-tool)でマークされた MCP ツールもプロンプトが表示されます。このモードは、Claude Code がホストシステムに損害を与えることができないコンテナ、VM、またはインターネットアクセスのない dev container のような隔離環境でのみ使用してください。

350 365

351有効にするフラグの 1 つで開始したセッションから `bypassPermissions` に入ることはできません。有効にするために再起動してください。366有効にするフラグの 1 つで開始したセッションから `bypassPermissions` に入ることはできません。有効にするために再起動してください。

352 367

permissions.md +14 −3

Details

270Read と Edit ルールの両方は、[gitignore](https://git-scm.com/docs/gitignore) 仕様に従い、4 つの異なるパターンタイプがあります。270Read と Edit ルールの両方は、[gitignore](https://git-scm.com/docs/gitignore) 仕様に従い、4 つの異なるパターンタイプがあります。

271 271

272| パターン | 意味 | 例 | マッチ |272| パターン | 意味 | 例 | マッチ |

273| ------------------- | ---------------------- | -------------------------------- | ------------------------------ |273| ------------------- | ---------------------- | -------------------------------- | ------------------------------------------------ |

274| `//path` | ファイルシステムルートからの**絶対**パス | `Read(//Users/alice/secrets/**)` | `/Users/alice/secrets/**` |274| `//path` | ファイルシステムルートからの**絶対**パス | `Read(//Users/alice/secrets/**)` | `/Users/alice/secrets/**` |

275| `~/path` | **ホーム**ディレクトリからのパス | `Read(~/Documents/*.pdf)` | `/Users/alice/Documents/*.pdf` |275| `~/path` | **ホーム**ディレクトリからのパス | `Read(~/Documents/*.pdf)` | `/Users/alice/Documents/*.pdf` |

276| `/path` | **プロジェクトルートからの相対**パス | `Edit(/src/**/*.ts)` | `<project root>/src/**/*.ts` |276| `/path` | 設定ソースからの相対パス | `Edit(/src/**/*.ts)` | `<project root>/src/**/*.ts` in project settings |

277| `path` または `./path` | **現在のディレクトリからの相対**パス | `Read(*.env)` | `<cwd>/*.env` |277| `path` または `./path` | **現在のディレクトリからの相対**パス | `Read(*.env)` | `<cwd>/*.env` |

278 278

279<Warning>279<Warning>

280 `/Users/alice/file` のようなパターンは絶対パスではありません。プロジェクトルートからの相対パスです。絶対パスには `//Users/alice/file` を使用してください。280 `/Users/alice/file` のようなパターンは絶対パスではありません。単一の先頭スラッシュは設定ソースにアンカーされており、ファイルシステムルートではありません。絶対パスには `//Users/alice/file` を使用してください。

281</Warning>281</Warning>

282 282

283`/path` パターンは、それを定義する設定ファイルに関連付けられたディレクトリにアンカーされるため、同じルールは配置場所に応じて異なる場所にマッチします。

284

285| ルール定義場所 | `/path` の解決先 |

286| :----------------------------------------- | :------------------------- |

287| `.claude/settings.json` などのプロジェクトまたはローカル設定 | `<project root>/path` |

288| `~/.claude/settings.json` のユーザー設定 | `~/.claude/path` |

289| `--settings <file>` で渡されたファイル | `<directory of file>/path` |

290| CLI フラグ、`/permissions`、またはセッションルール | `<original cwd>/path` |

291

292`Read(/secrets/**)` のような deny ルールをユーザー設定で記述すると、プロジェクト内の `secrets` ディレクトリではなく、`~/.claude/secrets/**` をブロックします。すべてのプロジェクト内に適用されるユーザー設定でルールを記述するには、`//` 絶対パスまたは `~/` ホーム相対パスを使用してください。

293

283Windows では、パスはマッチング前に POSIX 形式に正規化されます。`C:\Users\alice` は `/c/Users/alice` になるため、`//c/**/.env` を使用してそのドライブ上の `.env` ファイルをマッチさせます。すべてのドライブ全体でマッチさせるには、`//**/.env` を使用します。294Windows では、パスはマッチング前に POSIX 形式に正規化されます。`C:\Users\alice` は `/c/Users/alice` になるため、`//c/**/.env` を使用してそのドライブ上の `.env` ファイルをマッチさせます。すべてのドライブ全体でマッチさせるには、`//**/.env` を使用します。

284 295

285例：296例：

plugins.md +2 −2

Details

352プラグインに変更を加えると、`/reload-plugins` を実行して再起動せずに更新を反映させます。これにより、プラグイン、スキル、エージェント、フック、プラグイン MCP サーバー、プラグイン LSP サーバーが再読み込みされます。プラグインコンポーネントをテストします。352プラグインに変更を加えると、`/reload-plugins` を実行して再起動せずに更新を反映させます。これにより、プラグイン、スキル、エージェント、フック、プラグイン MCP サーバー、プラグイン LSP サーバーが再読み込みされます。プラグインコンポーネントをテストします。

353 353

354* `/plugin-name:skill-name` でスキルを試す354* `/plugin-name:skill-name` でスキルを試す

355* `/agents` でエージェントが表示されることを確認する355* `/context` でエージェントがカスタムエージェントの下に表示されることを確認するか、スコープ付き名でエージェントを @-mention する

356* フックが期待どおりに機能することを確認する356* フックが期待どおりに機能することを確認する

357 357

358<Tip>358<Tip>

502 claude --plugin-dir ./my-plugin502 claude --plugin-dir ./my-plugin

503 ```503 ```

504 504

505 各コンポーネントをテストします。コマンドを実行し、`/agents` にエージェントが表示されることを確認し、フックが正しくトリガーされることを確認します。505 各コンポーネントをテストします。コマンドを実行し、`/context` にエージェントが表示されることを確認し、フックが正しくトリガーされることを確認します。

506 </Step>506 </Step>

507</Steps>507</Steps>

508 508

plugins-reference.md +1 −1

Details

79 79

80**統合ポイント**:80**統合ポイント**:

81 81

~~82* Agents は `/agents` インターフェイスに表示されます~~82* Agents は [@-mention typeahead](/ja/sub-agents#invoke-subagents-explicitly) に、`my-plugin:code-reviewer` などのスコープ付き名の下に表示されます。プラグインが有効になると

83* Claude はタスクコンテキストに基づいて自動的にエージェントを呼び出すことができます83* Claude はタスクコンテキストに基づいて自動的にエージェントを呼び出すことができます

84* Agents はユーザーが手動で呼び出すことができます84* Agents はユーザーが手動で呼び出すことができます

85* プラグインエージェントは組み込みの Claude エージェントと一緒に動作します85* プラグインエージェントは組み込みの Claude エージェントと一緒に動作します

sandboxing.md +43 −5

Details

199 認証情報を保護する199 認証情報を保護する

200</h3>200</h3>

201 201

202`sandbox.credentials` 設定は、サンドボックス化されたコマンドがアクセスしてはいけない認証情報ファイルと環境変数を宣言します。リストされたファイルパスは、`filesystem.denyRead` が適用するのと同じ制限がサンドボックス内の読み取りに適用され、リストされた環境変数は各サンドボックス化されたコマンド実行前に設定解除されます。専用の `credentials` ブロックは、環境変数の設定解除とともに認証情報ルールをグループ化し、一般的なファイルシステムルールから分離します。Claude Code v2.1.187 以降が必要です。202`sandbox.credentials` 設定は、サンドボックス化されたコマンドから保護する認証情報ファイルと環境変数を宣言します。各エントリはファイルパスまたは環境変数と `mode` を指定します。専用の `credentials` ブロックは、認証情報ルールをグループ化し、一般的なファイルシステムルールから分離します。Claude Code v2.1.187 以降が必要です。

203

204`"mode": "deny"` のエントリの場合、ファイルパスはサンドボックス内の読み取りに対して拒否されます。これは `filesystem.denyRead` が適用するのと同じ制限であり、環境変数は各サンドボックス化されたコマンド実行前に設定解除されます。

203 205

204以下の例は、AWS 認証情報ファイルと SSH ディレクトリの読み取りをブロックし、サンドボックス化されたコマンドの環境から `GITHUB_TOKEN` と `NPM_TOKEN` を削除します。206以下の例は、AWS 認証情報ファイルと SSH ディレクトリの読み取りをブロックし、サンドボックス化されたコマンドの環境から `GITHUB_TOKEN` と `NPM_TOKEN` を削除します。

205 207

221}223}

222```224```

223 225

224各エントリは `"mode": "deny"` を持ち、これが唯一サポートされている値です。明示的な `mode` フィールドは、スキーマを将来のモードとの互換性を保つようにします。ファイルパスは `sandbox.filesystem.*` 設定と同じ [プレフィックスルール](/ja/settings#sandbox-path-prefixes) に従い、すべての [設定スコープ](/ja/settings#settings-precedence) からのエントリはマージされます。唯一のモードが `deny` であるため、任意のスコープは制限を追加できますが、どのスコープも制限を削除することはできません。226ファイルエントリは `"mode": "deny"` のみをサポートします。環境変数エントリは `"mode": "mask"` も受け入れます。これについては以下で説明します。

227

228ファイルパスは `sandbox.filesystem.*` 設定と同じ [プレフィックスルール](/ja/settings#sandbox-path-prefixes) に従い、すべての [設定スコープ](/ja/settings#settings-precedence) からの `deny` エントリはマージされます。`deny` エントリはアクセスを狭めるだけなので、任意のスコープは 1 つを追加できますが、別のスコープが追加したものを削除することはできません。

225 229

226組み込みの認証情報拒否リストはないため、リストしたファイルと変数のみが制限されます。この設定は、サンドボックス化された Bash コマンドのみに影響します。サンドボックス化に関係なくすべてのサブプロセスから Anthropic およびクラウドプロバイダーの認証情報を削除するには、[`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/ja/env-vars) を設定します。230組み込みの認証情報拒否リストはないため、リストしたファイルと変数のみが制限されます。この設定は、サンドボックス化された Bash コマンドのみに影響します。サンドボックス化に関係なくすべてのサブプロセスから Anthropic およびクラウドプロバイダーの認証情報を削除するには、[`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/ja/env-vars) を設定します。

227 231

232<h4 id="mask-environment-variables">

233 環境変数をマスクする

234</h4>

235

236`"mode": "mask"` は認証情報を保護しながら、それで認証するツールが機能し続けるようにします。`deny` は変数を完全に削除するため、`gh` や `npm` などそれを必要とするツールも壊します。Claude Code v2.1.199 以降が必要です。

237

238`mask` を使用すると、サンドボックス化されたコマンドは実際の値の代わりにセッションごとのセンチネル値を見ます。リクエストが認証情報の `injectHosts` の 1 つに対してサンドボックスを離れるとき、[サンドボックスプロキシ](#network-isolation) はセンチネルを実際の値に置き換えます。コマンドとそれがログに記録するものは実際の認証情報を保持しませんが、そのリクエストは依然として認証されます。

239

240プロキシはリクエストコンテンツ内の認証情報を置き換えるため、それらを見る必要があります。[`network.tlsTerminate`](/ja/settings#sandbox-settings) を設定して、プロキシが HTTPS 自体を終了するようにします。それなしでは、マスキングは安全に失敗します。コマンドはセンチネルのみを見ますが、センチネルは変更されずにサーバーに到達し、認証は失敗します。Claude Code はこの設定ミスをスタートアップ時と `/doctor` で報告します。

241

242以下の例は 2 つのトークンをマスクします。`GH_TOKEN` は `api.github.com` へのリクエストでのみ置き換えられ、`NPM_TOKEN` は `injectHosts` を持たず、`network.allowedDomains` 内のすべてのホストへのリクエストで置き換えられます。各 `injectHosts` エントリ自体が `network.allowedDomains` でカバーされている必要があります。

243

244```json theme={null}

245{

246 "sandbox": {

247 "enabled": true,

248 "network": {

249 "tlsTerminate": {},

250 "allowedDomains": ["*.github.com", "registry.npmjs.org"]

251 },

252 "credentials": {

253 "envVars": [

254 { "name": "GH_TOKEN", "mode": "mask", "injectHosts": ["api.github.com"] },

255 { "name": "NPM_TOKEN", "mode": "mask" }

256 ]

257 }

258 }

259}

260```

261

262`deny` とは異なり、マスキングはプロキシに実際の認証情報をリストされたホストに送信することを認可するため、これはあなたまたはあなたの管理者が制御する設定からのみ尊重されます。ユーザー設定、管理設定、および `--settings` CLI フラグです。リポジトリの `.claude/settings.json` または `.claude/settings.local.json` 内の `mask` エントリ、`network.tlsTerminate`、および [`credentials.allowPlaintextInject`](/ja/settings#sandbox-settings) は無視されます。

263

264同じ変数が任意のスコープで `deny` でリストされている場合、`deny` が優先されます。

265

228<h2 id="how-sandboxing-works">266<h2 id="how-sandboxing-works">

229 サンドボックス化の仕組み267 サンドボックス化の仕組み

230</h2>268</h2>

255* **包括的なカバレッジ**：制限はすべてのスクリプト、プログラム、およびコマンドによって生成されるサブプロセスに適用されます293* **包括的なカバレッジ**：制限はすべてのスクリプト、プログラム、およびコマンドによって生成されるサブプロセスに適用されます

256 294

257<Note>295<Note>

258 組み込みプロキシは要求されたホスト名に基づいて許可リストを実施し、TLS トラフィックを終了または検査しません。このデザインのセキュリティ上の影響については [Security limitations](#security-limitations) を参照してください。脅威モデルが TLS 検査を必要とする場合は、[Custom proxy configuration](#custom-proxy-configuration) を参照してください。296 組み込みプロキシは要求されたホスト名に基づいて許可リストを実施し、デフォルトでは TLS トラフィックを終了または検査しません。Claude Code v2.1.199 以降で利用可能な実験的な [`network.tlsTerminate`](/ja/settings#sandbox-settings) 設定により、組み込みプロキシが TLS 自体を終了するようになり、[`mask` 認証情報エントリ](#protect-credentials)が必要になります。デフォルトの影響については [Security limitations](#security-limitations) を参照してください。脅威モデルが TLS 検査を必要とする場合は、[Custom proxy configuration](#custom-proxy-configuration) を参照してください。

259</Note>297</Note>

260 298

261<h3 id="os-level-enforcement">299<h3 id="os-level-enforcement">

412 セキュリティ上の制限450 セキュリティ上の制限

413</h3>451</h3>

414 452

415* **ネットワークフィルタリング**：ネットワークフィルタリングシステムは、プロセスが接続を許可されるドメインを制限することで動作します。組み込みプロキシは発信トラフィックを終了または TLS 検査を実行しないため、暗号化された接続の内容は検査されません。許可リストに含まれるドメインのみが信頼できることを確認する責任があります。453* **ネットワークフィルタリング**：サンドボックスは、プロセスが接続できるドメインを制限します。デフォルトでは、組み込みプロキシは発信トラフィックを終了または検査しないため、暗号化された接続の内容は検査されません。実験的な [`network.tlsTerminate`](/ja/settings#sandbox-settings) 設定は、[`mask` 認証情報置換](#protect-credentials)のためにプロキシで TLS を終了しますが、コンテンツフィルタリングは追加しません。ポリシーで許可されるのは信頼できるドメインのみであることを確認する責任があります。

416 454

417<Warning>455<Warning>

418 `github.com` などの広いドメインを許可すると、データ流出のパスが作成される可能性があります。プロキシは TLS を検査せずにクライアント提供のホスト名から許可決定を行うため、サンドボックス内で実行されるコードは [ドメインフロンティング](https://en.wikipedia.org/wiki/Domain_fronting)または同様の技術を使用して許可リスト外のホストに到達する可能性があります。脅威モデルがより強力な保証を必要とする場合は、TLS を終了してトラフィックを検査し、CA 証明書をサンドボックス内にインストールする [カスタムプロキシ](#custom-proxy-configuration)を設定してください。より強力な TLS 対応ネットワーク分離は開発の活発な領域です。456 `github.com` などの広いドメインを許可すると、データ流出のパスが作成される可能性があります。プロキシは TLS を検査せずにクライアント提供のホスト名から許可決定を行うため、サンドボックス内で実行されるコードは [ドメインフロンティング](https://en.wikipedia.org/wiki/Domain_fronting)または同様の技術を使用して許可リスト外のホストに到達する可能性があります。脅威モデルがより強力な保証を必要とする場合は、TLS を終了してトラフィックを検査し、CA 証明書をサンドボックス内にインストールする [カスタムプロキシ](#custom-proxy-configuration)を設定してください。より強力な TLS 対応ネットワーク分離は開発の活発な領域です。

440 478

441* **組み込みファイルツール**：Read、Edit、Write はサンドボックスを通じて実行するのではなく、許可システムを直接使用します。[permissions](/ja/permissions)を参照してください。479* **組み込みファイルツール**：Read、Edit、Write はサンドボックスを通じて実行するのではなく、許可システムを直接使用します。[permissions](/ja/permissions)を参照してください。

442* **コンピュータ使用**：Claude がアプリを開いてスクリーンを制御する場合、分離された環境ではなく実際のデスクトップで実行されます。アプリごとの許可プロンプトが各アプリケーションをゲートします。[CLI でのコンピュータ使用](/ja/computer-use)または [Desktop でのコンピュータ使用](/ja/desktop#let-claude-use-your-computer)を参照してください。480* **コンピュータ使用**：Claude がアプリを開いてスクリーンを制御する場合、分離された環境ではなく実際のデスクトップで実行されます。アプリごとの許可プロンプトが各アプリケーションをゲートします。[CLI でのコンピュータ使用](/ja/computer-use)または [Desktop でのコンピュータ使用](/ja/desktop#let-claude-use-your-computer)を参照してください。

443* **環境変数**：サンドボックス化された Bash コマンドはデフォルトで親プロセス環境を継承します。そこに設定されたすべての認証情報を含みます。サブプロセスから Anthropic とクラウドプロバイダーの認証情報を削除するには、[`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/ja/env-vars)を設定してください。481* **環境変数**：サンドボックス化された Bash コマンドはデフォルトで親プロセス環境を継承します。そこに設定されたすべての認証情報を含みます。サンドボックス化されたコマンドの特定の変数を設定解除またはマスクするには [`sandbox.credentials`](#protect-credentials) を使用するか、すべてのサブプロセスから Anthropic とクラウドプロバイダーの認証情報を削除するには [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/ja/env-vars) を設定してください。

444* **サブエージェント**：[subagents](/ja/sub-agents)は親セッションと同じプロセスで実行され、同じサンドボックス設定を使用します。親セッションでサンドボックス化が有効な場合、サブエージェント内の Bash コマンドはサンドボックス化されます。482* **サブエージェント**：[subagents](/ja/sub-agents)は親セッションと同じプロセスで実行され、同じサンドボックス設定を使用します。親セッションでサンドボックス化が有効な場合、サブエージェント内の Bash コマンドはサンドボックス化されます。

445 483

446<Warning>484<Warning>

server-managed-settings.md +22 −8

Details

151 設定の優先順位151 設定の優先順位

152</h3>152</h3>

153 153

154サーバー管理設定と[エンドポイント管理設定](/ja/settings#settings-files)は、Claude Code [設定階層](/ja/settings#settings-precedence)の最上位を占めます。コマンドライン引数を含む他の設定レベルはこれらをオーバーライドできません。管理層内では、設定された [`policyHelper`](/ja/settings#compute-managed-settings-with-a-policy-helper) は他のすべての管理ソース（サーバー管理設定を含む）に優先します。その出力は実行のための唯一の管理構成になります。それ以外の場合、空でない構成を配信する最初のソースが優先されます。サーバー管理設定が最初にチェックされ、次にエンドポイント管理設定がチェックされます。ソースはマージされません。サーバー管理設定がキーを配信する場合、他のエンドポイント管理設定は完全に無視されます。1 つの例外が適用されます。[クロスソースロックキー](/ja/settings#settings-precedence)（サンドボックスホワイトリストロックなど）の小さなセットは、管理者が管理する管理ソースがそれらを設定する場合に尊重されます。ユーザーが書き込み可能な HKCU レジストリ層は除外されます。サーバー管理設定が何も配信しない場合、エンドポイント管理設定が適用されます。154サーバー管理設定と[エンドポイント管理設定](/ja/settings#settings-files)は、Claude Code [設定階層](/ja/settings#settings-precedence)の最上位を占めます。コマンドライン引数を含む他の設定レベルはこれらをオーバーライドできません。管理層内では、設定された [`policyHelper`](/ja/settings#compute-managed-settings-with-a-policy-helper) は他のすべての管理ソース（サーバー管理設定を含む）に優先します。その出力は実行のための唯一の管理構成になります。それ以外の場合、Claude Code は空でない構成を配信する最初のソースを使用します。サーバー管理設定が最初にチェックされ、次にエンドポイント管理設定がチェックされます。ソースはマージされません。サーバー管理設定がキーを配信する場合、他のエンドポイント管理設定は無視されます。サーバー管理設定が何も配信しない場合、エンドポイント管理設定が適用されます。

155

1561 つの例外が適用されます。[クロスソースロックキー](/ja/settings#settings-precedence)（サンドボックスホワイトリストロックなど）の小さなセットは、管理者が管理する管理ソースがそれらを設定する場合に尊重されます。ユーザーが書き込み可能な HKCU レジストリ層は除外されます。

155 157

156管理コンソールでサーバー管理構成をクリアして、エンドポイント管理 plist またはレジストリポリシーにフォールバックする意図がある場合、[キャッシュされた設定](#fetch-and-caching-behavior)はクライアントマシンに保持され、次の成功したフェッチまで続きます。`/status` を実行して、どの管理ソースがアクティブであるかを確認してください。158管理コンソールでサーバー管理構成をクリアして、エンドポイント管理 plist またはレジストリポリシーにフォールバックする意図がある場合、[キャッシュされた設定](#fetch-and-caching-behavior)はクライアントマシンに保持され、次の成功したフェッチまで続きます。`/status` を実行して、どの管理ソースがアクティブであるかを確認してください。

157 159

169 171

170**キャッシュされた設定での後続の起動：**172**キャッシュされた設定での後続の起動：**

171 173

172* キャッシュされた設定は起動時に直ちに適用されます174* キャッシュされた設定は起動時に直ちに適用されます。ただし、以下で説明するトランスポート、ルーティング、認証環境変数は除きます

173* Claude Code はバックグラウンドで新しい設定をフェッチします175* Claude Code はバックグラウンドで新しい設定をフェッチします

174* キャッシュされた設定はネットワーク障害を通じて保持されます176* キャッシュされた設定はネットワーク障害を通じて保持されます。保留中の環境変数はフェッチが成功するまで保留されたままです

177

178v2.1.198 以降、Claude Code はセッションのペイロードをサーバーが確認するまで、キャッシュされた `env` ブロック内の 3 つのカテゴリの変数を保留します。これにより、キャッシュされたプロキシ、認証局、エンドポイント、または認証情報の値がペイロードを確認する設定フェッチをリダイレクト、傍受、または再認証することを防ぎます。強化はサーバーがフェッチした設定キャッシュにのみ適用されます。MDM または `managed-settings.json` を通じてデプロイされた[エンドポイント管理設定](/ja/settings#settings-files)は影響を受けません。保留中のカテゴリは以下の通りです。

179

180* `HTTPS_PROXY`、`NODE_EXTRA_CA_CERTS`、mTLS クライアント証明書変数 `CLAUDE_CODE_CLIENT_CERT` および `CLAUDE_CODE_CLIENT_KEY` などのプロキシと TLS 構成

181* `ANTHROPIC_BASE_URL`、`CLAUDE_CODE_USE_BEDROCK` および `CLAUDE_CODE_USE_VERTEX` などのプロバイダー選択変数、`ANTHROPIC_BEDROCK_BASE_URL` などのプロバイダーエンドポイント URL を含む API ルーティングとプロバイダー選択

182* `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、`CLAUDE_CODE_OAUTH_TOKEN` などの認証認証情報

175 183

176Claude Code は設定の更新を自動的に適用します。ただし、OpenTelemetry 構成などの高度な設定は、有効にするために完全な再起動が必要です。184キャッシュされた `env` ブロック内の他のすべてのキー（テレメトリと OpenTelemetry 構成など）は、以前と同様に起動時に適用されます。フェッチが成功すると、保留中の変数はセッションの残りの期間に適用されます。

185

186組織が `api.anthropic.com` に到達するためにプロキシが必要な場合、管理 `env` ブロックのみではなく、シェル環境または[ユーザー設定](/ja/settings#settings-files)で設定してください。初回起動にはキャッシュがないため、これらのソースは既に初期フェッチに必要でした。

187

188Claude Code は設定更新を自動的に適用します。ただし、OpenTelemetry 構成などの高度な設定は、有効にするために完全な再起動が必要です。

177 189

178<h3 id="invalid-entries-in-delivered-settings">190<h3 id="invalid-entries-in-delivered-settings">

179 配信された設定の無効なエントリ191 配信された設定の無効なエントリ

232 プラットフォームの可用性244 プラットフォームの可用性

233</h2>245</h2>

234 246

235サーバー管理設定は `api.anthropic.com` への直接接続が必要であり、配信にはセッションが組織 OAuth ログインまたは直接設定された API キーで認証される必要があります。[`apiKeyHelper`](/ja/settings#available-settings) スクリプトによって返されたキーは設定フェッチをトリガーしません。サーバー管理設定は、サードパーティのモデルプロバイダーを使用する場合は利用できません。247サーバー管理設定は `api.anthropic.com` への直接接続が必要であり、配信にはセッションが組織 OAuth ログインまたは直接設定された API キーで認証される必要があります。[`apiKeyHelper`](/ja/settings#available-settings) スクリプトによって返されたキーは設定フェッチをトリガーしません。

248

249サーバー管理設定は、サードパーティのモデルプロバイダーを使用する場合は利用できません。

236 250

237* Amazon Bedrock251* Amazon Bedrock

238* Google Vertex AI252* Google Vertex AI

257サーバー管理設定は一元的なポリシー適用を提供しますが、クライアント側の制御として機能し、セキュリティ境界ではありません。管理されていないデバイスでは、ユーザーは管理者または sudo アクセス権を持つ必要なく、これらをバイパスできます。271サーバー管理設定は一元的なポリシー適用を提供しますが、クライアント側の制御として機能し、セキュリティ境界ではありません。管理されていないデバイスでは、ユーザーは管理者または sudo アクセス権を持つ必要なく、これらをバイパスできます。

258 272

259| シナリオ | 動作 |273| シナリオ | 動作 |

260| :--------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |274| :--------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

261| ユーザーがキャッシュされた設定ファイルを編集する | 改ざんされたファイルは起動時に適用されますが、次のサーバーフェッチで正しい設定が復元されます |275| ユーザーがキャッシュされた設定ファイルを編集する | 改ざんされたファイルは起動時に適用されますが、次のサーバーフェッチで正しい設定が復元されます。{/* min-version: 2.1.198 */}v2.1.198 以降、`env` ブロック内のトランスポート、API ルーティング、および認証環境変数は、[サーバーがペイロードを確認するまで保留されます](#fetch-and-caching-behavior) |

265| API が利用不可 | キャッシュされた設定が利用可能な場合は適用されます。そうでない場合、管理設定は次の成功したフェッチまで適用されません。`forceRemoteSettingsRefresh: true` の場合、CLI は続行するのではなく終了します。ただし、[`claude auth` サブコマンド](#enforce-fail-closed-startup)を除きます |279| API が利用不可 | キャッシュされた設定が利用可能な場合は適用されます。そうでない場合、管理設定は次の成功したフェッチまで適用されません。{/* min-version: 2.1.198 */}v2.1.198 以降、キャッシュされた `env` ブロック内のトランスポート、API ルーティング、および認証環境変数は、[フェッチ失敗時に保留されます](#fetch-and-caching-behavior)。キャッシュの残りの部分は引き続き適用されます。`forceRemoteSettingsRefresh: true` の場合、CLI は続行するのではなく終了します。ただし、[`claude auth` サブコマンド](#enforce-fail-closed-startup)を除きます |

266| ユーザーが別の組織で認証する | 管理対象組織外のアカウントには設定が配信されません |280| ユーザーが別の組織で認証する | 管理対象組織外のアカウントには設定が配信されません |

267| ユーザーが[サードパーティモデルプロバイダー](#platform-availability)を構成する | サーバー管理設定はバイパスされます。これには `CLAUDE_CODE_USE_BEDROCK`、`CLAUDE_CODE_USE_MANTLE`、`CLAUDE_CODE_USE_VERTEX`、`CLAUDE_CODE_USE_FOUNDRY`、`CLAUDE_CODE_USE_ANTHROPIC_AWS`、またはデフォルト以外の `ANTHROPIC_BASE_URL` の設定が含まれます |281| ユーザーが[サードパーティモデルプロバイダー](#platform-availability)を構成する | サーバー管理設定はバイパスされます。これには `CLAUDE_CODE_USE_BEDROCK`、`CLAUDE_CODE_USE_MANTLE`、`CLAUDE_CODE_USE_VERTEX`、`CLAUDE_CODE_USE_FOUNDRY`、`CLAUDE_CODE_USE_ANTHROPIC_AWS`、またはデフォルト以外の `ANTHROPIC_BASE_URL` の設定が含まれます |

sessions.md +2 −0

Details

97/branch try-streaming-approach97/branch try-streaming-approach

98```98```

99 99

100名前を省略した場合、Claude Code は会話の最初のプロンプトに基づいて新しいブランチに名前を付けます。v2.1.198 以降では、これは[コンパクション](/ja/how-claude-code-works#when-context-fills-up)後にも適用されます。それより前のバージョンでは、元の最初のプロンプトを超えてコンパクション要約を参照する代わりに、リテラル名 `Branched conversation` にフォールバックしていました。

101

100コマンドラインから、`--continue` または `--resume` を `--fork-session` と組み合わせます。102コマンドラインから、`--continue` または `--resume` を `--fork-session` と組み合わせます。

101 103

102```bash theme={null}104```bash theme={null}

settings.md +6 −3

Details

398高度なサンドボックス動作を構成します。サンドボックスは bash コマンドをファイルシステムとネットワークから分離します。詳細については [サンドボックス](/ja/sandboxing)を参照してください。398高度なサンドボックス動作を構成します。サンドボックスは bash コマンドをファイルシステムとネットワークから分離します。詳細については [サンドボックス](/ja/sandboxing)を参照してください。

399 399

400| キー | 説明 | 例 |400| キー | 説明 | 例 |

401| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |401| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------- |

403| `failIfUnavailable` | `sandbox.enabled` が true だがサンドボックスが起動できない場合（依存関係の欠落、サポートされていないプラットフォーム）、起動時にエラーで終了します。false（デフォルト）の場合、警告が表示され、コマンドはサンドボックス化されずに実行されます。managed 設定デプロイメント用で、サンドボックスをハードゲートとして必要とします | `true` |403| `failIfUnavailable` | `sandbox.enabled` が true だがサンドボックスが起動できない場合（依存関係の欠落、サポートされていないプラットフォーム）、起動時にエラーで終了します。false（デフォルト）の場合、警告が表示され、コマンドはサンドボックス化されずに実行されます。managed 設定デプロイメント用で、サンドボックスをハードゲートとして必要とします | `true` |

410| `filesystem.allowRead` | `denyRead` 領域内での読み取りを再度許可するパス。`denyRead` よりも優先されます。配列はすべての設定スコープ全体でマージされます。これを使用してワークスペースのみの読み取りアクセスパターンを作成します。 | `["."]` |410| `filesystem.allowRead` | `denyRead` 領域内での読み取りを再度許可するパス。`denyRead` よりも優先されます。配列はすべての設定スコープ全体でマージされます。これを使用してワークスペースのみの読み取りアクセスパターンを作成します。 | `["."]` |

412| `credentials.files` | サンドボックス化されたコマンドが読み取りできない認証情報ファイルまたはディレクトリ。`filesystem.denyRead` と同じ読み取りブロックを適用します。個別のキーは認証情報パスを `credentials.envVars` と一緒にグループ化し、一般的なファイルシステムルールから離します。各エントリは `{ "path": "...", "mode": "deny" }` です。パスは `filesystem.*` 設定と同じ[プレフィックス](#sandbox-path-prefixes)を使用します。配列はすべての設定スコープ全体でマージされます。`deny` のみがサポートされています。Claude Code v2.1.187 以降が必要です。 | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |412| `credentials.files` | {/* min-version: 2.1.187 */}サンドボックス化されたコマンドが読み取りできない認証情報ファイルまたはディレクトリ。`filesystem.denyRead` と同じ読み取りブロックを適用します。個別のキーは認証情報パスを `credentials.envVars` と一緒にグループ化し、一般的なファイルシステムルールから離します。各エントリは `{ "path": "...", "mode": "deny" }` です。パスは `filesystem.*` 設定と同じ[プレフィックス](#sandbox-path-prefixes)を使用します。配列はすべての設定スコープ全体でマージされます。`deny` のみがサポートされています。Claude Code v2.1.187 以降が必要です。 | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |

413| `credentials.envVars` | サンドボックス化されたコマンドを実行する前に設定解除する環境変数。各エントリは `{ "name": "...", "mode": "deny" }` です。配列はすべての設定スコープ全体でマージされます。`deny` のみがサポートされています。Claude Code v2.1.187 以降が必要です。 | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |413| `credentials.envVars` | {/* min-version: 2.1.187 */}}[サンドボックス化されたコマンドから保護](/ja/sandboxing#protect-credentials)する環境変数。各エントリは `name` と `mode` を持ちます。名前は文字またはアンダースコアで始まり、文字、数字、アンダースコアのみを含む必要があります。`deny` は変数をサンドボックス化されたコマンドの環境から削除します。Claude Code v2.1.187 以降が必要です。{/* min-version: 2.1.199 */}}`mask` は変数をセッションごとのセンチネル値でサンドボックス内に置き換え、サンドボックスプロキシはそのエントリの `injectHosts` へのアウトバウンドリクエストで実際の値を置き換えます。`network.tlsTerminate` と Claude Code v2.1.199 以降が必要です。`mask` エントリはユーザー、managed、または CLI `--settings` 設定からのみ尊重され、`.claude/settings.json` または `.claude/settings.local.json` からは尊重されません。配列はすべての設定スコープ全体でマージされ、同じ変数が両方のモードで表示される場合、`deny` が優先されます。 | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |

414| `credentials.envVars[].injectHosts` | {/* min-version: 2.1.199 */}サンドボックスプロキシが `mask` エントリの実際の値を置き換えるホスト。各ホストは `network.allowedDomains` でもカバーされている必要があります。正確にまたはワイルドカードで。未設定の場合、プロキシは `network.allowedDomains` のすべてのホストへのリクエストで値を置き換えます。`mode` が `deny` の場合は受け入れられますが無視されます。Claude Code v2.1.199 以降が必要です。 | `["api.github.com"]` |

415| `credentials.allowPlaintextInject` | {/* min-version: 2.1.199 */}TLS 終了 HTTPS だけでなく、プレーン HTTP リクエストでも `mask` 置換を許可します。プレーン HTTP ではアップストリーム ID が検証されず、認証情報がクリアテキストで移動するため、信頼されたテストネットワーク外ではこれをオフのままにしてください。ユーザー、managed、または CLI `--settings` 設定からのみ尊重され、`.claude/settings.json` または `.claude/settings.local.json` からは尊重されません。デフォルト：false。Claude Code v2.1.199 以降が必要です。 | `true` |

414| `network.allowUnixSockets` | （macOS のみ）サンドボックスでアクセス可能な Unix ソケットパス。Linux と WSL2 では無視されます。seccomp フィルターは `socket(AF_UNIX, ...)` 呼び出しをブロックできないため、代わりに `allowAllUnixSockets` を使用します。 | `["~/.ssh/agent-socket"]` |416| `network.allowUnixSockets` | （macOS のみ）サンドボックスでアクセス可能な Unix ソケットパス。Linux と WSL2 では無視されます。seccomp フィルターは `socket(AF_UNIX, ...)` 呼び出しをブロックできないため、代わりに `allowAllUnixSockets` を使用します。 | `["~/.ssh/agent-socket"]` |

415| `network.allowAllUnixSockets` | サンドボックス内のすべての Unix ソケット接続を許可します。Linux と WSL2 ではこれが Unix ソケットを許可する唯一の方法です。seccomp フィルターをスキップするため、`socket(AF_UNIX, ...)` 呼び出しをブロックします。デフォルト：false | `true` |417| `network.allowAllUnixSockets` | サンドボックス内のすべての Unix ソケット接続を許可します。Linux と WSL2 ではこれが Unix ソケットを許可する唯一の方法です。seccomp フィルターをスキップするため、`socket(AF_UNIX, ...)` 呼び出しをブロックします。デフォルト：false | `true` |

420| `network.allowManagedDomainsOnly` | （Managed 設定のみ）managed 設定からの `allowedDomains` および `WebFetch(domain:...)` allow ルールのみが尊重されます。ユーザー、プロジェクト、およびローカル設定からのドメインは無視されます。許可されていないドメインはユーザーにプロンプトを表示せずに自動的にブロックされます。拒否されたドメインはすべてのソースから引き続き尊重されます。デフォルト：false | `true` |422| `network.allowManagedDomainsOnly` | （Managed 設定のみ）managed 設定からの `allowedDomains` および `WebFetch(domain:...)` allow ルールのみが尊重されます。ユーザー、プロジェクト、およびローカル設定からのドメインは無視されます。許可されていないドメインはユーザーにプロンプトを表示せずに自動的にブロックされます。拒否されたドメインはすべてのソースから引き続き尊重されます。デフォルト：false | `true` |

421| `network.httpProxyPort` | 独自のプロキシを使用する場合に使用される HTTP プロキシポート。指定されていない場合、Claude は独自のプロキシを実行します。 | `8080` |423| `network.httpProxyPort` | 独自のプロキシを使用する場合に使用される HTTP プロキシポート。指定されていない場合、Claude は独自のプロキシを実行します。 | `8080` |

422| `network.socksProxyPort` | 独自のプロキシを使用する場合に使用される SOCKS5 プロキシポート。指定されていない場合、Claude は独自のプロキシを実行します。 | `8081` |424| `network.socksProxyPort` | 独自のプロキシを使用する場合に使用される SOCKS5 プロキシポート。指定されていない場合、Claude は独自のプロキシを実行します。 | `8081` |

425| `network.tlsTerminate` | {/* min-version: 2.1.199 */}実験的。サンドボックスプロキシ内で TLS を終了して、HTTPS リクエストの内容を読み取ることができるようにします。`mask` [認証情報置換](/ja/sandboxing#protect-credentials)に必要です。セッション用に一時的な認証局を生成するには `{}` に設定するか、独自の CA を使用するには `caCertPath` と `caKeyPath` を設定します。ユーザー、managed、または CLI `--settings` 設定からのみ尊重され、`.claude/settings.json` または `.claude/settings.local.json` からは尊重されません。Claude Code v2.1.199 以降が必要です。 | `{}` |

424| `enableWeakerNetworkIsolation` | （macOS のみ）サンドボックス内のシステム TLS 信頼サービス（`com.apple.trustd.agent`）へのアクセスを許可します。`httpProxyPort` を MITM プロキシおよびカスタム CA と共に使用する場合、`gh`、`gcloud`、`terraform` などの Go ベースのツールが TLS 証明書を検証するために必要です。**セキュリティを低下させます**。データ流出の可能性のあるパスを開きます。デフォルト：false | `true` |427| `enableWeakerNetworkIsolation` | （macOS のみ）サンドボックス内のシステム TLS 信頼サービス（`com.apple.trustd.agent`）へのアクセスを許可します。`httpProxyPort` を MITM プロキシおよびカスタム CA と共に使用する場合、`gh`、`gcloud`、`terraform` などの Go ベースのツールが TLS 証明書を検証するために必要です。**セキュリティを低下させます**。データ流出の可能性のあるパスを開きます。デフォルト：false | `true` |

425| `allowAppleEvents` | （macOS のみ）サンドボックス化されたコマンドが Apple Events を送信することを許可します。`open`、`osascript`、および URL をブラウザで開くツールに必要です。これ以外の場合は error `-600` で失敗します。**コード実行分離を削除します。** サンドボックス化されたコマンドは、ユーザープロンプトなしで他のアプリケーションをサンドボックス化されていない状態で起動できます。また、Terminal などの実行中のアプリケーションに AppleScript コマンドを送信することもできます。macOS 自動化同意プロンプト（TCC）の対象となります。ユーザー、managed、または CLI 設定からのみ尊重され、プロジェクト設定からは尊重されません。デフォルト：false | `true` |428| `allowAppleEvents` | （macOS のみ）サンドボックス化されたコマンドが Apple Events を送信することを許可します。`open`、`osascript`、および URL をブラウザで開くツールに必要です。これ以外の場合は error `-600` で失敗します。**コード実行分離を削除します。** サンドボックス化されたコマンドは、ユーザープロンプトなしで他のアプリケーションをサンドボックス化されていない状態で起動できます。また、Terminal などの実行中のアプリケーションに AppleScript コマンドを送信することもできます。macOS 自動化同意プロンプト（TCC）の対象となります。ユーザー、managed、または CLI 設定からのみ尊重され、プロジェクト設定からは尊重されません。デフォルト：false | `true` |

setup.md +1 −1

Details

453 npm でのインストール453 npm でのインストール

454</h3>454</h3>

455 455

456Claude Code をグローバル npm パッケージとしてインストールすることもできます。パッケージには [Node.js 18 以上](https://nodejs.org/en/download)が必要です。456Claude Code をグローバル npm パッケージとしてインストールすることもできます。v2.1.198 以降、npm パッケージには [Node.js 22 以上](https://nodejs.org/en/download)が必要です。古い Node.js バージョンでは、npm はインストール中に `EBADENGINE` 警告を出力するのではなく失敗します。インストールは完了し、パッケージがランタイムで Node.js を使用しないネイティブバイナリをダウンロードするため、`claude` は引き続き実行されます。

457 457

458```bash theme={null}458```bash theme={null}

459npm install -g @anthropic-ai/claude-code459npm install -g @anthropic-ai/claude-code

skills.md +6 −0

Details

443 443

444引数を使用してスキルを呼び出しても、スキルに `$ARGUMENTS` が含まれていない場合、Claude Code はスキルコンテンツの最後に `ARGUMENTS: <your input>` を追加するため、Claude は入力したものを引き続き見ることができます。444引数を使用してスキルを呼び出しても、スキルに `$ARGUMENTS` が含まれていない場合、Claude Code はスキルコンテンツの最後に `ARGUMENTS: <your input>` を追加するため、Claude は入力したものを引き続き見ることができます。

445 445

446ユーザーと Claude の両方が 1 つのメッセージの開始時に複数のスキルをスタックできます。v2.1.199 以降では、`/code-review /fix-issue 123` を入力すると、両方のスキルが読み込まれ、末尾のテキスト `123` が `$ARGUMENTS` として各スキルに渡されます。以前のバージョンでは、最初のスキルのみが読み込まれ、`/fix-issue 123` をリテラル引数テキストとして受け取りました。

447

448Claude Code は最初のスキルと、その後にスタックされた最大 5 つのスキルを展開します。展開は、インラインユーザー呼び出し可能スキルではない最初のトークンで停止するため、[フォークされたサブエージェント](#run-skills-in-a-subagent)として実行されるスキル、または `/loop` など、その引数自体がスラッシュコマンドで始まる可能性があるスキルも、そこで実行を終了します。そのトークンとそれ以降のすべてが、すべての展開されたスキルの引数テキストになります。

449

446位置で個別の引数にアクセスするには、`$ARGUMENTS[N]` または短い `$N` を使用します：450位置で個別の引数にアクセスするには、`$ARGUMENTS[N]` または短い `$N` を使用します：

447 451

448```yaml theme={null}452```yaml theme={null}

624| `"user-invocable-only"` | 非表示 | はい |628| `"user-invocable-only"` | 非表示 | はい |

625| `"off"` | 非表示 | 非表示 |629| `"off"` | 非表示 | 非表示 |

626 630

631v2.1.199 以降、`"off"` はターミナル `/` メニューだけでなく、[Remote Control](/ja/remote-control)クライアントと[Agent SDK](/ja/agent-sdk/slash-commands)呼び出し元に通知されるコマンドリストからもスキルを非表示にします。非表示のスキルをその完全な名前で呼び出すと、実行する代わりに `skillOverrides` エラーが返されます。

632

627`skillOverrides` に存在しないスキルは `"on"` として扱われます。以下の例は 1 つのスキルを名前に折りたたみ、別のスキルを完全にオフにします：633`skillOverrides` に存在しないスキルは `"on"` として扱われます。以下の例は 1 つのスキルを名前に折りたたみ、別のスキルを完全にオフにします：

628 634

629```json theme={null}635```json theme={null}

sub-agents.md +88 −66

Details

24 24

25Claude は各サブエージェントの説明を使用して、タスクを委譲するかどうかを決定します。サブエージェントを作成するときは、Claude がいつそれを使用するかを知るように、明確な説明を書いてください。25Claude は各サブエージェントの説明を使用して、タスクを委譲するかどうかを決定します。サブエージェントを作成するときは、Claude がいつそれを使用するかを知るように、明確な説明を書いてください。

26 26

27Claude Code には、**Explore**、**Plan**、**general-purpose** などのいくつかの組み込みサブエージェントが含まれています。特定のタスクを処理するカスタムサブエージェントを作成することもできます。27Claude Code には、Explore、Plan、general-purpose などのいくつかの組み込みサブエージェントが含まれています。特定のタスクを処理するカスタムサブエージェントを作成することもできます。

28 28

29<h2 id="built-in-subagents">29<h2 id="built-in-subagents">

30 組み込みサブエージェント30 組み込みサブエージェント

38 <Tab title="Explore">38 <Tab title="Explore">

39 コードベースの検索と分析に最適化された高速な読み取り専用エージェント。39 コードベースの検索と分析に最適化された高速な読み取り専用エージェント。

40 40

~~41 * **モデル**：Haiku（高速、低レイテンシ）~~41 * **モデル**：メイン会話から継承され、Claude API では Opus でキャップされるため、Explore はセッション用に既に選択したモデルより高価なモデルで実行されることはありません

~~42 * **ツール**：読み取り専用ツール（Write および Edit ツールへのアクセスは拒否）~~42 * **ツール**：読み取り専用ツール。Write と Edit は拒否されます

43 * **目的**：ファイル検出、コード検索、コードベース探索43 * **目的**：ファイル検出、コード検索、コードベース探索

44 44

45 {/* min-version: 2.1.198 */}v2.1.198 以降、Explore はメイン会話のモデルを継承し、常に Haiku で実行されるわけではありません。Claude API では、継承されたモデルは Opus でキャップされます。より高いティアのメイン会話は Explore を Opus で実行し、Sonnet または Haiku のメイン会話は Explore をそのモデルで実行します。[Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または AWS 上の Claude Platform](/ja/third-party-integrations)などの他のプロバイダーでは、Explore はメイン会話のモデルを直接継承します。

47 `Explore` という名前の[ユーザーまたはプロジェクトサブエージェント](#choose-the-subagent-scope)は組み込みをオーバーライドし、独自の `model` フィールドを保持するため、`model: haiku` で定義して探索を低コストモデルに保つことができます。

45 Claude は、変更を加えずにコードベースを検索または理解する必要があるときに Explore に委譲します。これにより、探索結果がメインの会話コンテキストから除外されます。49 Claude は、変更を加えずにコードベースを検索または理解する必要があるときに Explore に委譲します。これにより、探索結果がメインの会話コンテキストから除外されます。

46 50

47 Explore を呼び出すときに、Claude は徹底度レベルを指定します：ターゲット検索の場合は **quick**、バランスの取れた探索の場合は **medium**、包括的な分析の場合は **very thorough**。51 Explore を呼び出すときに、Claude は徹底度レベルを指定します：ターゲット検索の場合は **quick**、バランスの取れた探索の場合は **medium**、包括的な分析の場合は **very thorough**。

77 </Tab>81 </Tab>

78</Tabs>82</Tabs>

79 83

~~80組み込みサブエージェントは常にインタラクティブセッションに登録されます。これらを制限するには：~~84組み込みサブエージェントはデフォルトでインタラクティブセッションに登録されます。これらを制限するには：

81 85

82* 特定の組み込みタイプをブロックするには、[特定のサブエージェントを無効にする](#disable-specific-subagents)に示されているように `permissions.deny` に追加します。86* 特定の組み込みタイプをブロックするには、[特定のサブエージェントを無効にする](#disable-specific-subagents)に示されているように `permissions.deny` に追加します。

83* Claude がサブエージェントに委譲することを防ぐには、[`permissions.deny`](/ja/permissions#tool-specific-permission-rules)で `Agent` ツール自体を拒否します。87* Claude がサブエージェントに委譲することを防ぐには、[`permissions.deny`](/ja/permissions#tool-specific-permission-rules)で `Agent` ツール自体を拒否します。

88* {/* min-version: 2.1.198 */}組み込みの `Explore` と `Plan` サブエージェントのみを削除するには、[`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1`](/ja/env-vars)を設定します。Claude はファイルを直接読み取り、探索し、サブエージェントに委譲する代わりに実行します。Claude Code v2.1.198 以降が必要です。

84* [非インタラクティブモード](/ja/headless)および [Agent SDK](/ja/agent-sdk/overview)では、[`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/ja/env-vars)を設定して、すべての組み込みタイプを削除し、独自のものだけを提供します。89* [非インタラクティブモード](/ja/headless)および [Agent SDK](/ja/agent-sdk/overview)では、[`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/ja/env-vars)を設定して、すべての組み込みタイプを削除し、独自のものだけを提供します。

85 90

86これらの組み込みサブエージェント以外に、カスタムプロンプト、ツール制限、権限モード、hooks、および skills を使用して独自のサブエージェントを作成できます。以下のセクションでは、開始方法とサブエージェントのカスタマイズ方法を示します。91これらの組み込みサブエージェント以外に、カスタムプロンプト、ツール制限、権限モード、hooks、および skills を使用して独自のサブエージェントを作成できます。以下のセクションでは、開始方法とサブエージェントのカスタマイズ方法を示します。

89 クイックスタート：最初のサブエージェントを作成する94 クイックスタート：最初のサブエージェントを作成する

90</h2>95</h2>

91 96

92サブエージェントは YAML フロントマターを含む Markdown ファイルで定義されます。[手動で作成](#write-subagent-files)することも、`/agents` コマンドを使用することもできます。97サブエージェントは YAML フロントマターを含む Markdown ファイルです。Claude に作成してもらうか、[手動で作成](#write-subagent-files)することができます。

93 98

94このチュートリアルでは、`/agents` コマンドを使用してユーザーレベルのサブエージェントを作成する手順を説明します。サブエージェントはコードをレビューし、コードベースの改善を提案します。99{/* min-version: 2.1.198 */}v2.1.198 以降、`/agents` コマンドはインタラクティブな作成ウィザードを開かなくなりました。実行すると、Claude に依頼するか `.claude/agents/` を直接編集するよう促すメッセージが表示されます。サブエージェントファイル、フロントマターフィールド、`.claude/agents/` および `~/.claude/agents/` の場所は変わりません。ターミナルウィザードのみが削除されました。

100

101このチュートリアルでは、コードをレビューして改善を提案するユーザーレベルのサブエージェントを作成します。

95 102

96<Steps>103<Steps>

~~97 <Step title="サブエージェントインターフェースを開く">~~104 <Step title="Claude にサブエージェントの作成を依頼する">

~~98 Claude Code で、以下を実行します：~~105 Claude Code で、作成したいサブエージェントと保存場所を説明します：

99 106

100 ```text wrap theme={null}107 ```text wrap theme={null}

101 /agents108 Create a personal code-improver subagent in ~/.claude/agents/ that scans

109 files and suggests improvements for readability, performance, and best

110 practices. It should explain each issue, show the current code, and

111 provide an improved version. Make it read-only and have it use Sonnet.

102 ```112 ```

103 </Step>

104 113

105 <Step title="場所を選択する">114 Claude は `name`、`description`、`tools` リスト、`model`、およびシステムプロンプトを含むファイルを作成します。

106 **Library** タブに切り替え、**Create new agent** を選択し、**Personal** を選択します。これにより、サブエージェントが `~/.claude/agents/` に保存され、すべてのプロジェクトで利用可能になります。

107 </Step>115 </Step>

108 116

109 <Step title="Claude で生成する">117 <Step title="ファイルを確認する">

110 **Generate with Claude** を選択します。プロンプトが表示されたら、サブエージェントを説明します：118 `~/.claude/agents/code-improver.md` を開き、フロントマターが要求内容と一致することを確認します。結果は次のようになります：

111 119

112 ```text wrap theme={null}120 ```markdown theme={null}

113 A code improvement agent that scans files and suggests improvements121 ---

114 for readability, performance, and best practices. It should explain122 name: code-improver

115 each issue, show the current code, and provide an improved version.123 description: Scans files and suggests improvements for readability, performance, and best practices. Use after writing or modifying code.

124 tools: Read, Grep, Glob

125 model: sonnet

126 ---

127

128 You are a code improvement specialist. For each issue you find, explain

129 the problem, show the current code, and provide an improved version.

116 ```130 ```

117 131

118 Claude は識別子、説明、およびシステムプロンプトを生成します。132 ファイルが `~/.claude/agents/` に存在するため、サブエージェントはマシン上のすべてのプロジェクトで利用可能です。代わりに 1 つのプロジェクトにスコープを設定するには、そのプロジェクトの `.claude/agents/` ディレクトリに移動します。[サブエージェントスコープを選択する](#choose-the-subagent-scope)で 2 つを比較しています。

119 </Step>133 </Step>

120 134

121 <Step title="ツールを選択する">135 <Step title="試してみる">

122 読み取り専用レビュアーの場合は、**Read-only tools** 以外のすべてを選択解除します。すべてのツールを選択したままにすると、サブエージェントはメイン会話で利用可能なすべてのツールを継承します。136 Claude に新しいサブエージェントに委譲するよう依頼します：

123 </Step>

~~124~~

125 <Step title="モデルを選択する">

126 サブエージェントが使用するモデルを選択します。このサンプルエージェントの場合は、**Sonnet** を選択します。これはコードパターンの分析のための機能と速度のバランスを取ります。

127 </Step>

~~128~~

129 <Step title="色を選択する">

130 サブエージェントの背景色を選択します。これにより、UI でどのサブエージェントが実行されているかを識別するのに役立ちます。

131 </Step>

~~132~~

133 <Step title="メモリを設定する">

134 **User scope** を選択して、サブエージェントに `~/.claude/agent-memory/` の[永続メモリディレクトリ](#enable-persistent-memory)を提供します。サブエージェントはこれを使用して、コードベースパターンや繰り返される問題など、会話全体で洞察を蓄積します。サブエージェントが学習を永続化しないようにする場合は、**None** を選択します。

135 </Step>

~~136~~

137 <Step title="保存して試す">

138 設定概要を確認します。`s` または `Enter` を押して保存するか、`e` を押してエディターで保存して編集します。サブエージェントはすぐに利用可能になります。試してみます：

139 137

140 ```text wrap theme={null}138 ```text wrap theme={null}

141 Use the code-improver agent to suggest improvements in this project139 Use the code-improver agent to suggest improvements in this project

142 ```140 ```

143 141

144 Claude は新しいサブエージェントに委譲し、コードベースをスキャンして改善提案を返します。142 Claude は新しいサブエージェントに委譲し、コードベースをスキャンして改善提案を返します。

143

144 Claude が新しいサブエージェントを見つけられない場合は、Claude Code を再起動してもう一度試してください。これは `~/.claude/agents/` がセッション開始前に存在しなかった場合にのみ発生します。実行中のセッションは新しく作成された `agents` ディレクトリを検出しないためです。

145 </Step>145 </Step>

146</Steps>146</Steps>

147 147

148これで、マシン上のプロジェクトでコードベースを分析し、改善を提案するために使用できるサブエージェントができました。148これで、マシン上のプロジェクトでコードベースを分析し、改善を提案するために使用できるサブエージェントができました。

149 149

150Markdown ファイルとして手動でサブエージェントを作成したり、CLI フラグを使用して定義したり、プラグインを通じて配布したりすることもできます。以下のセクションでは、すべての設定オプションについて説明します。150サブエージェントファイルを手動で作成したり、CLI フラグを使用して定義したり、プラグインを通じて配布したりすることもできます。以下のセクションでは、すべての設定オプションについて説明します。

151

152<Note>

153 Claude Code v2.1.197 以前では、`/agents` はライブサブエージェントを一覧表示する **Running** タブと、サブエージェントを作成、編集、削除するための **Library** タブを備えたインタラクティブウィザードを開きます。{/* max-version: 2.1.197 */}

154</Note>

151 155

152<h2 id="configure-subagents">156<h2 id="configure-subagents">

153 サブエージェントを設定する157 サブエージェントを設定する

154</h2>158</h2>

155 159

156<h3 id="use-the-/agents-command">160サブエージェントのファイルの場所によって、誰がそれを利用できるかが決まり、フロントマターによって何ができるかが決まります。このセクションでは、サブエージェントファイルがどこに存在するか、およびサポートするすべてのフィールドについて説明します。

157 /agents コマンドを使用する

158</h3>

~~159~~

160`/agents` コマンドは、サブエージェントを管理するためのタブ付きインターフェースを開きます。**Running** タブはライブおよび最近終了したサブエージェントをリストし、それらを開くまたは停止できます。**Library** タブでは以下を実行できます：

~~161~~

162* すべての利用可能なサブエージェント（組み込み、ユーザー、プロジェクト、プラグイン）を表示する

163* ガイド付きセットアップまたは Claude 生成を使用して新しいサブエージェントを作成する

164* 既存のサブエージェント設定とツールアクセスを編集する

165* カスタムサブエージェントを削除する

166* 重複が存在する場合、どのサブエージェントがアクティブであるかを確認する

~~167~~

168これはサブエージェントを作成および管理するための推奨される方法です。手動作成または自動化の場合は、サブエージェントファイルを直接追加することもできます。

169 161

170<h3 id="choose-the-subagent-scope">162<h3 id="choose-the-subagent-scope">

171 サブエージェントのスコープを選択する163 サブエージェントのスコープを選択する

172</h3>164</h3>

173 165

174サブエージェントは YAML フロントマターを含む Markdown ファイルです。スコープに応じて異なる場所に保存します。複数のサブエージェントが同じ名前を共有する場合、より高い優先度の場所が優先されます。166スコープに応じて、異なる場所にサブエージェントファイルを保存します。複数のサブエージェントが同じ名前を共有する場合、Claude Code はより高い優先度の場所からのものを使用します。

175 167

176| 場所 | スコープ | 優先度 | 作成方法 |168| 場所 | スコープ | 優先度 | 作成方法 |

177| :---------------------- | :---------- | :---- | :---------------------------- |169| :---------------------- | :---------- | :---- | :---------------------------- |

178| 管理設定 | 組織全体 | 1（最高） | [管理設定](/ja/settings)を通じてデプロイ |170| 管理設定 | 組織全体 | 1（最高） | [管理設定](/ja/settings)を通じてデプロイ |

183 175

184**プロジェクトサブエージェント** (`.claude/agents/`)は、コードベース固有のサブエージェントに最適です。バージョン管理にチェックインして、チームが協力して使用および改善できるようにします。176**プロジェクトサブエージェント** (`.claude/agents/`)は、コードベース固有のサブエージェントに最適です。バージョン管理にチェックインして、チームが協力して使用および改善できるようにします。

189 181

190**ユーザーサブエージェント** (`~/.claude/agents/`)は、すべてのプロジェクトで利用可能な個人用サブエージェントです。182**ユーザーサブエージェント** (`~/.claude/agents/`)は、すべてのプロジェクトで利用可能な個人用サブエージェントです。

191 183

192Claude Code は `.claude/agents/` と `~/.claude/agents/` を再帰的にスキャンするため、`agents/review/` や `agents/research/` などのサブフォルダに定義を整理できます。サブディレクトリパスはサブエージェントの識別方法や呼び出し方法に影響しません。これは `name` フロントマターフィールドからのみ識別されるためです。`name` 値をツリー全体で一意に保ちます：1 つのスコープ内の 2 つのファイルが同じ名前を宣言する場合、Claude Code は 1 つを保持し、警告なしに他を破棄します。{/* min-version: 2.1.196 */}v2.1.196 以降、`/doctor` を実行すると、同じスコープの重複するエージェント名が報告され、どの定義がアクティブであるかが表示されます。184Claude Code は `.claude/agents/` と `~/.claude/agents/` を再帰的にスキャンするため、`agents/review/` や `agents/research/` などのサブフォルダに定義を整理できます。サブディレクトリパスはサブエージェントの識別方法や呼び出し方法に影響しません。これは `name` フロントマターフィールドからのみ識別されるためです。

185

186`name` 値をツリー全体で一意に保ちます：1 つのスコープ内の 2 つのファイルが同じ名前を宣言する場合、Claude Code は 1 つのみを読み込みます。{/* min-version: 2.1.196 */}v2.1.196 以降、`/doctor` を実行すると、同じスコープの重複するエージェント名が報告され、どの定義がアクティブであるかが表示されます。

193 187

194プラグイン `agents/` ディレクトリも再帰的にスキャンされます。プロジェクトおよびユーザースコープとは異なり、プラグインの `agents/` ディレクトリ内のサブフォルダは[スコープ付き識別子](#invoke-subagents-explicitly)の一部になります：プラグイン `my-plugin` の `agents/review/security.md` にあるファイルは `my-plugin:review:security` として登録されます。188プラグイン `agents/` ディレクトリも再帰的にスキャンされます。プロジェクトおよびユーザースコープとは異なり、プラグインの `agents/` ディレクトリ内のサブフォルダは[スコープ付き識別子](#invoke-subagents-explicitly)の一部になります：プラグイン `my-plugin` の `agents/review/security.md` にあるファイルは `my-plugin:review:security` として登録されます。

195 189

237 231

238**管理サブエージェント** は、組織管理者によってデプロイされます。[管理設定ディレクトリ](/ja/settings#settings-files)内の `.claude/agents/` に markdown ファイルを配置し、プロジェクトおよびユーザーサブエージェントと同じフロントマター形式を使用します。管理定義は、同じ名前のプロジェクトおよびユーザーサブエージェントより優先されます。232**管理サブエージェント** は、組織管理者によってデプロイされます。[管理設定ディレクトリ](/ja/settings#settings-files)内の `.claude/agents/` に markdown ファイルを配置し、プロジェクトおよびユーザーサブエージェントと同じフロントマター形式を使用します。管理定義は、同じ名前のプロジェクトおよびユーザーサブエージェントより優先されます。

239 233

240**プラグインサブエージェント** は、インストールした[プラグイン](/ja/plugins)から提供されます。これらは、カスタムサブエージェントと一緒に `/agents` に表示されます。プラグインサブエージェントの作成の詳細については、[プラグインコンポーネントリファレンス](/ja/plugins-reference#agents)を参照してください。234**プラグインサブエージェント** は、インストールした[プラグイン](/ja/plugins)から提供されます。これらはカスタムサブエージェントと一緒に読み込まれ、スコープ付き名の下で @-mention タイプアヘッドに表示されます。プラグインサブエージェントの作成の詳細については、[プラグインコンポーネントリファレンス](/ja/plugins-reference#agents)を参照してください。

241 235

242<Note>236<Note>

243 セキュリティ上の理由から、プラグインサブエージェントは `hooks`、`mcpServers`、または `permissionMode` フロントマターフィールドをサポートしていません。これらのフィールドはプラグインからエージェントを読み込むときに無視されます。これらが必要な場合は、エージェントファイルを `.claude/agents/` または `~/.claude/agents/` にコピーしてください。また、`settings.json` または `settings.local.json` の [`permissions.allow`](/ja/settings#permission-settings)にルールを追加することもできますが、これらのルールはプラグインサブエージェントだけでなく、セッション全体に適用されます。237 セキュリティ上の理由から、プラグインサブエージェントは `hooks`、`mcpServers`、または `permissionMode` フロントマターフィールドをサポートしていません。これらのフィールドはプラグインからエージェントを読み込むときに無視されます。これらが必要な場合は、エージェントファイルを `.claude/agents/` または `~/.claude/agents/` にコピーしてください。また、`settings.json` または `settings.local.json` の [`permissions.allow`](/ja/settings#permission-settings)にルールを追加することもできますが、これらのルールはプラグインサブエージェントだけでなく、セッション全体に適用されます。

252サブエージェントファイルは、YAML フロントマターを使用して設定を行い、その後に Markdown でシステムプロンプトを続けます：246サブエージェントファイルは、YAML フロントマターを使用して設定を行い、その後に Markdown でシステムプロンプトを続けます：

253 247

254<Note>248<Note>

255 サブエージェントはセッション開始時に読み込まれます。ディスク上でサブエージェントファイルを直接追加または編集する場合は、セッションを再起動してそれを読み込みます。`/agents` インターフェースを通じて作成されたサブエージェントは、再起動なしで即座に有効になります。249 Claude Code は `~/.claude/agents/` と `.claude/agents/` を監視します。ディスク上でサブエージェントファイルを追加または編集するか、Claude にファイルを書くよう依頼すると、Claude Code は数秒以内に変更を検出し、次の委譲は更新された定義を使用します。再起動は不要です。

250

251 ただし、2 つのケースでは再起動が必要です：

252

253 * ウォッチャーはセッション開始時に存在していたディレクトリのみをカバーするため、新しい `agents` ディレクトリでスコープの最初のエージェントファイルを作成した後、再起動して読み込みます。

254 * `--disable-slash-commands` で開始されたセッションはこれらのディレクトリをまったく監視しません。

256</Note>255</Note>

257 256

258```markdown theme={null}257```markdown theme={null}

281| :---------------- | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |280| :---------------- | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

282| `name` | はい | 小文字とハイフンを使用した一意の識別子。[Hooks](/ja/hooks#subagentstart)はこの値を `agent_type` として受け取ります。ファイル名は一致する必要はありません |281| `name` | はい | 小文字とハイフンを使用した一意の識別子。[Hooks](/ja/hooks#subagentstart)はこの値を `agent_type` として受け取ります。ファイル名は一致する必要はありません |

283| `description` | はい | Claude がこのサブエージェントに委譲する場合 |282| `description` | はい | Claude がこのサブエージェントに委譲する場合 |

284| `tools` | いいえ | サブエージェントが使用できる[ツール](#available-tools)。省略した場合はすべてのツールを継承します。スキルをコンテキストにプリロードするには、`tools` にリストするのではなく `skills` フィールドを使用します |283| `tools` | いいえ | [ツール](#available-tools)サブエージェントが使用できます。省略した場合はすべてのツールを継承します。スキルをコンテキストにプリロードするには、`tools` にリストするのではなく `skills` フィールドを使用します |

285| `disallowedTools` | いいえ | 拒否するツール。継承または指定されたリストから削除 |284| `disallowedTools` | いいえ | 拒否するツール。継承または指定されたリストから削除 |

286| `model` | いいえ | 使用する[モデル](#choose-a-model)：`sonnet`、`opus`、`haiku`、`fable`、完全なモデル ID（例：`claude-opus-4-8`）、または `inherit`。デフォルトは `inherit` |285| `model` | いいえ | 使用する[モデル](#choose-a-model)：`sonnet`、`opus`、`haiku`、`fable`、完全なモデル ID（例：`claude-opus-4-8`）、または `inherit`。デフォルトは `inherit` |

287| `permissionMode` | いいえ | [権限モード](#permission-modes)：`default`、`acceptEdits`、`auto`、`dontAsk`、`bypassPermissions`、または `plan`。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |286| `permissionMode` | いいえ | [権限モード](#permission-modes)：`default`、`acceptEdits`、`auto`、`dontAsk`、`bypassPermissions`、または `plan`。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |

288| `maxTurns` | いいえ | サブエージェントが停止する前の最大 agentic ターン数 |287| `maxTurns` | いいえ | サブエージェントが停止する前の最大 agentic ターン数 |

289| `skills` | いいえ | スタートアップ時にサブエージェントのコンテキストに[プリロード](/ja/skills)する[スキル](/ja/skills)。完全なスキルコンテンツが注入されます。説明だけでなく、スキル全体が注入されます。サブエージェントは、Skill ツールを通じて、リストされていないプロジェクト、ユーザー、およびプラグインスキルを引き続き呼び出すことができます |288| `skills` | いいえ | [スキル](/ja/skills)スタートアップ時にサブエージェントのコンテキストに[プリロード](/ja/skills)します。完全なスキルコンテンツが注入されます。説明だけでなく、スキル全体が注入されます。サブエージェントは、Skill ツールを通じて、リストされていないプロジェクト、ユーザー、およびプラグインスキルを引き続き呼び出すことができます |

290| `mcpServers` | いいえ | このサブエージェントで利用可能な[MCP サーバー](/ja/mcp)。各エントリは、既に設定されたサーバーを参照するサーバー名（例：`"slack"`）または、サーバー名をキーとし、完全な[MCP サーバー設定](/ja/mcp#installing-mcp-servers)を値とするインライン定義のいずれかです。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |289| `mcpServers` | いいえ | このサブエージェントで利用可能な[MCP サーバー](/ja/mcp)。各エントリは、既に設定されたサーバーを参照するサーバー名（例：`"slack"`）または、サーバー名をキーとし、完全な[MCP サーバー設定](/ja/mcp#installing-mcp-servers)を値とするインライン定義のいずれかです。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |

291| `hooks` | いいえ | このサブエージェントにスコープされた[ライフサイクルフック](#define-hooks-for-subagents)。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |290| `hooks` | いいえ | このサブエージェントにスコープされた[ライフサイクルフック](#define-hooks-for-subagents)。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |

292| `memory` | いいえ | [永続メモリスコープ](#enable-persistent-memory)：`user`、`project`、または `local`。クロスセッション学習を有効にします |291| `memory` | いいえ | [永続メモリスコープ](#enable-persistent-memory)：`user`、`project`、または `local`。クロスセッション学習を有効にします |

293| `background` | いいえ | `true` に設定して、このサブエージェントを常に[バックグラウンドタスク](#run-subagents-in-foreground-or-background)として実行します。デフォルト：`false` |292| `background` | いいえ | `true` に設定して、このサブエージェントを常に[バックグラウンドタスク](#run-subagents-in-foreground-or-background)として実行します。設定されていない場合、Claude が選択し、{/* min-version: 2.1.198 */}v2.1.198 以降ではデフォルトでサブエージェントをバックグラウンドで実行します |

294| `effort` | いいえ | このサブエージェントがアクティブな場合の努力レベル。セッション努力レベルをオーバーライドします。デフォルト：セッションから継承。オプション：`low`、`medium`、`high`、`xhigh`、`max`。利用可能なレベルはモデルに依存します |293| `effort` | いいえ | このサブエージェントがアクティブな場合の努力レベル。セッション努力レベルをオーバーライドします。デフォルト：セッションから継承。オプション：`low`、`medium`、`high`、`xhigh`、`max`。利用可能なレベルはモデルに依存します |

295| `isolation` | いいえ | `worktree` に設定して、サブエージェントを一時的な[git worktree](/ja/worktrees)で実行し、リポジトリの分離されたコピーを提供します。デフォルトでは[デフォルトブランチ](/ja/worktrees#choose-the-base-branch)から分岐し、親セッションの `HEAD` ではなく、サブエージェントが変更を加えない場合、worktree は自動的にクリーンアップされます |294| `isolation` | いいえ | `worktree` に設定して、サブエージェントを一時的な[git worktree](/ja/worktrees)で実行し、リポジトリの分離されたコピーを提供します。デフォルトでは[デフォルトブランチ](/ja/worktrees#choose-the-base-branch)から分岐し、親セッションの `HEAD` ではなく、サブエージェントが変更を加えない場合、worktree は自動的にクリーンアップされます |

296| `color` | いいえ | タスクリストとトランスクリプトでサブエージェントの表示カラー。`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、または `cyan` を受け入れます |295| `color` | いいえ | タスクリストとトランスクリプトでサブエージェントの表示カラー。`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、または `cyan` を受け入れます |

318 317

319環境変数、呼び出しごとのパラメーター、およびフロントマター値は、組織の [`availableModels`](/ja/model-config#restrict-model-selection)許可リストに対してチェックされます。除外されたモデルに解決される値は使用されず、サブエージェントは継承されたモデルで実行されます。318環境変数、呼び出しごとのパラメーター、およびフロントマター値は、組織の [`availableModels`](/ja/model-config#restrict-model-selection)許可リストに対してチェックされます。除外されたモデルに解決される値は使用されず、サブエージェントは継承されたモデルで実行されます。

320 319

320{/* min-version: 2.1.198 */}v2.1.198 以降、サブエージェントはメイン会話の[拡張思考](/ja/model-config#extended-thinking)設定も継承します：セッションで思考がオンの場合、サブエージェントではオンになり、オフの場合はオフのままです。サブエージェントごとの思考設定はありません。v2.1.198 より前では、サブエージェントはメイン会話の設定に関係なく、拡張思考が無効で実行されていました。

321

321<h3 id="control-subagent-capabilities">322<h3 id="control-subagent-capabilities">

322 サブエージェント機能を制御する323 サブエージェント機能を制御する

323</h3>324</h3>

526 永続メモリのヒント527 永続メモリのヒント

527</h5>528</h5>

528 529

529* `project` は推奨されるデフォルトスコープです。バージョン管理を通じてサブエージェント知識を共有可能にします。サブエージェントの知識がプロジェクト全体で広く適用可能な場合は `user` を使用するか、知識がバージョン管理にチェックインされるべきでない場合は `local` を使用します。530* `project` は推奨されるデフォルトスコープです。バージョン管理を通じてサブエージェント知識を共有可能にします。

530* サブエージェントに作業を開始する前にメモリを確認するよう依頼します：「このプルリクエストをレビューし、以前に見たパターンについてメモリを確認してください。」531* サブエージェントに作業を開始する前にメモリを確認するよう依頼します：「このプルリクエストをレビューし、以前に見たパターンについてメモリを確認してください。」

531* タスク完了後、サブエージェントにメモリを更新するよう依頼します：「完了したので、学習したことをメモリに保存してください。」時間をかけて、これはサブエージェントをより効果的にする知識ベースを構築します。532* タスク完了後、サブエージェントにメモリを更新するよう依頼します：「完了したので、学習したことをメモリに保存してください。」時間をかけて、これはサブエージェントをより効果的にする知識ベースを構築します。

532* メモリ指示をサブエージェントの markdown ファイルに直接含めて、独自の知識ベースを積極的に維持するようにします：533* メモリ指示をサブエージェントの markdown ファイルに直接含めて、独自の知識ベースを積極的に維持するようにします：

774* **フォアグラウンドサブエージェント** は、完了するまでメイン会話をブロックします。権限プロンプトは発生時にあなたに渡されます。775* **フォアグラウンドサブエージェント** は、完了するまでメイン会話をブロックします。権限プロンプトは発生時にあなたに渡されます。

775* **バックグラウンドサブエージェント** は、作業を続ける間に並行して実行されます。v2.1.186 以降、バックグラウンドサブエージェントが権限が必要なツール呼び出しに到達すると、プロンプトがメインセッションに表示され、要求しているサブエージェントの名前が付けられます。承認してサブエージェントを続行させるか、Esc を押してそのツール呼び出しのみを拒否し、サブエージェントを停止しないようにします。v2.1.186 より前は、バックグラウンドサブエージェントはプロンプトが表示されるツール呼び出しを自動拒否していました。776* **バックグラウンドサブエージェント** は、作業を続ける間に並行して実行されます。v2.1.186 以降、バックグラウンドサブエージェントが権限が必要なツール呼び出しに到達すると、プロンプトがメインセッションに表示され、要求しているサブエージェントの名前が付けられます。承認してサブエージェントを続行させるか、Esc を押してそのツール呼び出しのみを拒否し、サブエージェントを停止しないようにします。v2.1.186 より前は、バックグラウンドサブエージェントはプロンプトが表示されるツール呼び出しを自動拒否していました。

776 777

777Claude は、タスクに基づいてサブエージェントをフォアグラウンドまたはバックグラウンドで実行するかどうかを決定します。また、以下を実行できます：778v2.1.198 以降、サブエージェントはデフォルトでバックグラウンドで実行されます。Claude は、結果を続行する前に必要な場合、サブエージェントをフォアグラウンドで実行します。デフォルトは、サブエージェントが実行される場所を変更し、何が許可されるかではありません：バックグラウンドサブエージェントは、メインセッションのすべての権限プロンプトを表示します。v2.1.198 より前は、Claude はタスクに基づいてフォアグラウンドとバックグラウンドの間で選択していました。

779

780また、以下を実行できます：

778 781

779* Claude に「run this in the background」と依頼する782* Claude に「run this in the background」と依頼する

780* **Ctrl+B** を押して実行中のタスクをバックグラウンドにする783* **Ctrl+B** を押して実行中のタスクをバックグラウンドにする

781 784

782すべてのバックグラウンドタスク機能を無効にするには、`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` 環境変数を `1` に設定します。[環境変数](/ja/env-vars)を参照してください。785すべてのバックグラウンドタスク機能を無効にするには、`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` 環境変数を `1` に設定します。[環境変数](/ja/env-vars)を参照してください。

783 786

784[`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation)が `1` に設定されている場合、すべてのサブエージェント生成は `background` フィールドに関係なくバックグラウンドで実行されます。これらのバックグラウンドサブエージェントからの権限プロンプトは、上記で説明したようにメインセッションに表示されます。787[`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation)が `1` に設定されている場合、すべてのサブエージェント生成はバックグラウンドで実行され、フロントマター `background` フィールドは効果がありません。これは、フォークモードが `Agent` ツールから `run_in_background` パラメータを削除するためです。`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` はフォークモードより優先され、サブエージェント生成をフォアグラウンドに保ちます。

788

789<h3 id="api-errors-in-subagents">

790 サブエージェント内の API エラー

791</h3>

792

793v2.1.199 以降、実行が API エラー（使用制限や繰り返されるサーバーエラーなど）で終了するサブエージェントは、エラーテキストをサブエージェントの検出結果のように返すのではなく、その失敗を Claude に報告します。Claude が受け取るものは、サブエージェントが実行された場所によって異なります：

794

795* **フォアグラウンド**：レート制限、オーバーロード、またはサーバーエラーが既に出力を生成したサブエージェントを遮断する場合、Agent ツールはその部分的な出力を、サブエージェントが遮断され、タスクを完了しなかったというメモ付きで返します。それ以外の場合、ツール呼び出しは [`Agent terminated early due to an API error`](/ja/errors#agent-terminated-early-due-to-an-api-error) で失敗し、その後にエラーの詳細が続きます。

796* **バックグラウンド**：サブエージェントは失敗とマークされ、Claude が終了時に受け取るメッセージは API エラーに名前を付け、サブエージェントの最後の出力を含むため、部分的な作業は失われません。

797

798基礎となる API エラーがクリアされたら、Claude にタスクを再試行するか、[サブエージェントを再開](#resume-subagents)するよう依頼してください。

785 799

786<h3 id="common-patterns">800<h3 id="common-patterns">

787 一般的なパターン801 一般的なパターン

852 866

853Claude Code v2.1.172 以降、サブエージェントは独自のサブエージェントを生成できます。委譲されたタスク自体が並行サブタスクに分割される場合、これを使用します。例えば、レビュアーサブエージェントが検出結果ごとに検証者をディスパッチする場合、中間出力がメイン会話に到達することはありません。トップレベルのサブエージェントの概要のみがあなたに返されます。867Claude Code v2.1.172 以降、サブエージェントは独自のサブエージェントを生成できます。委譲されたタスク自体が並行サブタスクに分割される場合、これを使用します。例えば、レビュアーサブエージェントが検出結果ごとに検証者をディスパッチする場合、中間出力がメイン会話に到達することはありません。トップレベルのサブエージェントの概要のみがあなたに返されます。

854 868

855ネストされたサブエージェントは、トップレベルのものと同じ方法で設定され、同じ[スコープ](#choose-the-subagent-scope)から解決されます。プロンプト入力の下のサブエージェントパネルは、完全なツリーを表示します：各行は子孫の `(+N)` カウントを表示し、v2.1.193 以降、行を開くとそのサブエージェントの兄弟と直接の子が `main` へのパスとともに表示されます。[`/agents`](#use-the-%2Fagents-command)の Running タブは、実行中のサブエージェントをフラットリストとして表示します。869ネストされたサブエージェントは、トップレベルのものと同じ方法で設定され、同じ[スコープ](#choose-the-subagent-scope)から解決されます。

856 870

857深さは、各レベルが[フォアグラウンドまたはバックグラウンド](#run-subagents-in-foreground-or-background)で実行されるかどうかに関係なく、メイン会話の下のサブエージェントレベルの数として数えられます。深さ 5 のサブエージェントは Agent ツールを受け取らず、さらに生成することはできません。制限は固定されており、設定不可能です。871深さは、各レベルが[フォアグラウンドまたはバックグラウンド](#run-subagents-in-foreground-or-background)で実行されるかどうかに関係なく、メイン会話の下のサブエージェントレベルの数として数えられます。深さ 5 のサブエージェントは Agent ツールを受け取らず、さらに生成することはできません。制限は固定されており、設定不可能です。

858 872

892 906

893再開されたサブエージェントは、すべての前のツール呼び出し、結果、および推論を含む、完全な会話履歴を保持します。サブエージェントは、新規に開始するのではなく、停止した場所から正確に再開します。907再開されたサブエージェントは、すべての前のツール呼び出し、結果、および推論を含む、完全な会話履歴を保持します。サブエージェントは、新規に開始するのではなく、停止した場所から正確に再開します。

894 908

895サブエージェントが完了すると、Claude はエージェント ID を受け取ります。組み込みの Explore および Plan エージェントは 1 回限りで、エージェント ID を返さないため、再開できません。作業を続ける必要がある場合は、`general-purpose` またはカスタムサブエージェントを使用してください。Claude は `SendMessage` ツールを使用してエージェントの ID を `to` フィールドとして使用してサブエージェントを再開します。`SendMessage` ツールは、エージェント ID または名前でサブエージェントを再開するために常に利用可能です。`shutdown_request` および `plan_approval_response` などの構造化チームプロトコルメッセージには、[エージェントチーム](/ja/agent-teams)が有効になっている必要があります。909サブエージェントが完了すると、Claude はエージェント ID を受け取ります。組み込みの Explore および Plan エージェントは 1 回限りで、エージェント ID を返さないため、再開できません。作業を続ける必要がある場合は、`general-purpose` またはカスタムサブエージェントを使用してください。

910

911Claude は `SendMessage` ツールを使用してエージェントの ID または名前を `to` フィールドとしてサブエージェントを再開します。`SendMessage` は[エージェントチーム](/ja/agent-teams)が有効になっている必要はありません。`shutdown_request` および `plan_approval_response` などの構造化チームプロトコルメッセージのみが必要です。

896 912

897サブエージェントを再開するには、Claude に前の作業を続けるよう依頼します：913サブエージェントを再開するには、Claude に前の作業を続けるよう依頼します：

898 914

906 922

907停止したサブエージェントが `SendMessage` を受け取った場合、新しい `Agent` 呼び出しを必要とせずにバックグラウンドで自動再開します。923停止したサブエージェントが `SendMessage` を受け取った場合、新しい `Agent` 呼び出しを必要とせずにバックグラウンドで自動再開します。

908 924

909エージェント ID を明示的に参照したい場合は Claude に依頼することもできます。または、`~/.claude/projects/{project}/{sessionId}/subagents/` のトランスクリプトファイルで ID を見つけることができます。各トランスクリプトは `agent-{agentId}.jsonl` として保存されます。925v2.1.199 以降、`SendMessage` は、名前が会話の前半で到達したのと同じエージェントを引き続き参照していることを確認します。より新しいエージェントが名前を取得した場合（例えば、名前を再利用した再生成されたバックグラウンドエージェント）、Claude Code は送信を拒否し、エラーは名前が現在到達するエージェントを報告するため、Claude は再ターゲットできます。チェックは現在の会話にスコープされ、`/clear` でリセットされます。

926

927v2.1.198 以降、サブエージェントは、それを起動したエージェントからのメッセージを通常のタスク指示として扱い、その権限設定内で機能します。2 つの制限は、メッセージの送信者に関係なく引き続き保持されます：保留中の権限プロンプトに対するエージェントメッセージからの承認はカウントされず、エージェントメッセージはサブエージェントの権限設定、`CLAUDE.md`、または設定を変更することはできません。権限システムまたはあなた自身のメッセージのみが承認を付与できます。

928

929Claude にエージェント ID を明示的に参照したい場合は依頼することもできます。または、`~/.claude/projects/{project}/{sessionId}/subagents/` のトランスクリプトファイルで ID を見つけることができます。各トランスクリプトは `agent-{agentId}.jsonl` として保存されます。

910 930

911サブエージェントトランスクリプトはメイン会話から独立して永続化されます：931サブエージェントトランスクリプトはメイン会話から独立して永続化されます：

912 932

973| `x` | 完了したフォークを閉じるか、実行中のフォークを停止 |993| `x` | 完了したフォークを閉じるか、実行中のフォークを停止 |

974| `Esc` | フォーカスをプロンプト入力に戻す |994| `Esc` | フォーカスをプロンプト入力に戻す |

975 995

996フォークまたはサブエージェントのトランスクリプトが開いている場合、フォローアップメッセージと [skills](/ja/skills) はそのエージェントに送信されますが、組み込みコマンドはメイン会話で実行されたままです。{/* min-version: 2.1.199 */}v2.1.199 以降では、そのビューで `/model` または `/fast` を入力すると、表示されているエージェントのモデルまたはファストモードではなく、メイン会話のモデルまたはファストモードを変更することを示す通知が表示されます。サイレントに実行される代わりに。

997

976<h3 id="how-forks-differ-from-named-subagents">998<h3 id="how-forks-differ-from-named-subagents">

977 フォークと名前付きサブエージェントの違い999 フォークと名前付きサブエージェントの違い

978</h3>1000</h3>

tools-reference.md +16 −10

Details

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

15| `Agent` | 独自のコンテキストウィンドウを持つ [subagent](/ja/sub-agents)を生成してタスクを処理します。[Agent ツールの動作](#agent-tool-behavior)を参照してください | いいえ |15| `Agent` | 独自のコンテキストウィンドウを持つ [subagent](/ja/sub-agents)を生成してタスクを処理します。[Agent ツールの動作](#agent-tool-behavior)を参照してください | いいえ |

16| `Artifact` | HTML または Markdown ファイルを [artifact](/ja/artifacts)として公開します：claude.ai 上の非公開でインタラクティブなページで、組織内で共有できます。{/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}Pro、Max、Team、または Enterprise プランが必要で、`/login` 認証が必要です。[可用性](/ja/artifacts#availability)を参照してください | はい |16| `Artifact` | HTML または Markdown ファイルを [artifact](/ja/artifacts)として公開します：claude.ai 上の非公開でインタラクティブなページで、組織内で共有できます。{/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}Pro、Max、Team、または Enterprise プランが必要で、`/login` 認証が必要です。[可用性](/ja/artifacts#availability)を参照してください | はい |

17| `AskUserQuestion` | 要件を収集したり曖昧さを明確にするために複数選択肢の質問をします | いいえ |17| `AskUserQuestion` | 要件を収集したり曖昧さを明確にするために複数選択肢の質問をします。{/* min-version: 2.1.198 */}v2.1.198 以降、60 秒以内に応答しない場合、ダイアログは自動的に閉じます：既に選択したオプションを送信し、キーボードから離れている可能性があることを Claude に伝えるため、Claude は独自の判断で進行し、後で再度質問できます。最後の 20 秒間はカウントダウンが表示されます。キープレスはダイアログを開いたままにし、フォーカスを報告するターミナルのフォーカスされたウィンドウも同様です。[`CLAUDE_AFK_TIMEOUT_MS`](/ja/env-vars#variables)環境変数を設定して、Claude Code が待機する時間を変更するか、`86400000`（24 時間）などの大きな値に設定して、離席中もクエスチョンを開いたままにします。このタイムアウトは `AskUserQuestion` の複数選択肢の質問にのみ適用されます。権限プロンプト（プラン承認を含む）は、アイドル時に自動解決されることはありません | いいえ |

18| `Bash` | 環境でシェルコマンドを実行します。[Bash ツールの動作](#bash-tool-behavior)を参照してください | はい |18| `Bash` | 環境でシェルコマンドを実行します。[Bash ツールの動作](#bash-tool-behavior)を参照してください | はい |

19| `CronCreate` | 現在のセッション内で定期的または 1 回限りのプロンプトをスケジュールします。タスクはセッションスコープであり、`--resume` または `--continue` で復元されます（有効期限が切れていない場合）。[スケジュール済みタスク](/ja/scheduled-tasks)を参照してください | いいえ |19| `CronCreate` | 現在のセッション内で定期的または 1 回限りのプロンプトをスケジュールします。タスクはセッションスコープであり、`--resume` または `--continue` で復元されます（有効期限が切れていない場合）。[スケジュール済みタスク](/ja/scheduled-tasks)を参照してください | いいえ |

20| `CronDelete` | ID でスケジュール済みタスクをキャンセルします | いいえ |20| `CronDelete` | ID でスケジュール済みタスクをキャンセルします | いいえ |

35| `Read` | ファイルの内容を読み取ります。[Read ツールの動作](#read-tool-behavior)を参照してください | いいえ |35| `Read` | ファイルの内容を読み取ります。[Read ツールの動作](#read-tool-behavior)を参照してください | いいえ |

36| `ReadMcpResourceTool` | URI で特定の MCP リソースを読み取ります | いいえ |36| `ReadMcpResourceTool` | URI で特定の MCP リソースを読み取ります | いいえ |

37| `RemoteTrigger` | claude.ai で[ルーチン](/ja/routines)を作成、更新、実行、リストします。`/schedule` コマンドをサポートします。{/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}ルーチンは claude.ai に存在し、Pro、Max、Team、または Enterprise プランが必要なため、このツールは Amazon Bedrock、Google Vertex AI、または Microsoft Foundry からはアクセスできません | いいえ |37| `RemoteTrigger` | claude.ai で[ルーチン](/ja/routines)を作成、更新、実行、リストします。`/schedule` コマンドをサポートします。{/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}ルーチンは claude.ai に存在し、Pro、Max、Team、または Enterprise プランが必要なため、このツールは Amazon Bedrock、Google Vertex AI、または Microsoft Foundry からはアクセスできません | いいえ |

38| `ReportFindings` | コードレビューの検出結果を構造化されたリストとして報告します。検出結果ごとにファイル、概要、失敗シナリオがあり、Claude Code はテキストとして出力するのではなく、それらをレンダリングできます。アクティブなコードレビュー指示が Claude にそれを呼び出すよう指示した場合、Claude はそれを呼び出します。{/* min-version: 2.1.196 */}Claude Code v2.1.196 以降が必要です | いいえ |38| `ReportFindings` | コードレビューの検出結果を構造化されたリストとして報告します。検出結果ごとにファイル、概要、失敗シナリオがあり、Claude Code はテキストとして出力するのではなく、それらをレンダリングできます。アクティブなコードレビュー指示が Claude にそれを呼び出すよう指示した場合、Claude はそれを呼び出します。{/* min-version: 2.1.196 */}Claude Code v2.1.196 以降が必要です。{/* min-version: 2.1.199 */}v2.1.199 以降、検出結果はオプションの `category` スラッグ（`correctness` や `test-coverage` など）を含めることもでき、レンダリングされたリストのファイル位置の横に表示されます | いいえ |

39| `ScheduleWakeup` | [self-paced `/loop`](/ja/scheduled-tasks#let-claude-choose-the-interval)の次の反復をスケジュール変更します。Claude は各反復の終了時にこれを呼び出して、次の実行時刻を 1 分から 1 時間の間で選択します。直接呼び出すことはありません。保留中のウェイクアップは [Stop hook input](/ja/hooks#stop-input)の `session_crons` に表示されます。{/* plan-availability: feature=loop-dynamic providers=anthropic */}Amazon Bedrock、Google Vertex AI、または Microsoft Foundry では利用できません。これらでは、間隔のない `/loop` プロンプトは固定スケジュールで実行されます | いいえ |39| `ScheduleWakeup` | [self-paced `/loop`](/ja/scheduled-tasks#let-claude-choose-the-interval)の次の反復をスケジュール変更します。Claude は各反復の終了時にこれを呼び出して、次の実行時刻を 1 分から 1 時間の間で選択します。直接呼び出すことはありません。保留中のウェイクアップは [Stop hook input](/ja/hooks#stop-input)の `session_crons` に表示されます。{/* plan-availability: feature=loop-dynamic providers=anthropic */}Amazon Bedrock、Google Vertex AI、または Microsoft Foundry では利用できません。これらでは、間隔のない `/loop` プロンプトは固定スケジュールで実行されます | いいえ |

40| `SendMessage` | [agent team](/ja/agent-teams)メンバーにメッセージを送信するか、agent ID で [subagent](/ja/sub-agents#resume-subagents)を再開します。停止した subagent はバックグラウンドで自動的に再開されます。構造化されたチームプロトコルメッセージには agent teams が必要です | いいえ |40| `SendMessage` | [agent team](/ja/agent-teams)メンバーにメッセージを送信するか、agent ID または名前で [subagent](/ja/sub-agents#resume-subagents)を再開します。停止した subagent はバックグラウンドで自動的に再開されます。構造化されたチームプロトコルメッセージには agent teams が必要です。受信者は別のエージェントからのメッセージを、あなたの同意または承認として扱うことはありません。{/* min-version: 2.1.198 */}v2.1.198 以降、subagent はそれを起動したエージェントからのメッセージをピアリクエストではなく通常のタスク指示として扱います。{/* min-version: 2.1.199 */}v2.1.199 以降、会話の早い段階で解決された名前とは異なるエージェントに現在解決される名前への送信は、配信される代わりに拒否されます。[subagent を再開](/ja/sub-agents#resume-subagents)を参照してください | いいえ |

41| `SendUserFile` | セッションからファイルをオプションのキャプション付きで送信するため、生成されたレポート、図、スクリーンショット、または構築されたアーティファクトがトランスクリプトでのみ言及されるのではなく、デバイスに到達します。{/* min-version: 2.1.196 */}v2.1.196 以降、オプションの `display` 入力がプレゼンテーションを制御します：`render` はファイルをクライアントにインラインで開き、`attach` はダウンロードカードのみを表示し、設定されていない場合はクライアントがファイルタイプで決定します。[Remote Control](/ja/remote-control)クライアントが接続されている場合、またはセッションが [Claude Code on the web](/ja/claude-code-on-the-web)などのマネージドクラウド環境で実行されている場合に利用可能です。配信は Anthropic ホストインフラストラクチャを通じて実行されるため、このツールは Amazon Bedrock、Google Vertex AI、または Microsoft Foundry では利用できません | いいえ |41| `SendUserFile` | セッションからファイルをオプションのキャプション付きで送信するため、生成されたレポート、図、スクリーンショット、または構築されたアーティファクトがトランスクリプトでのみ言及されるのではなく、デバイスに到達します。{/* min-version: 2.1.196 */}v2.1.196 以降、オプションの `display` 入力がプレゼンテーションを制御します：`render` はファイルをクライアントにインラインで開き、`attach` はダウンロードカードのみを表示し、設定されていない場合はクライアントがファイルタイプで決定します。[Remote Control](/ja/remote-control)クライアントが接続されている場合、またはセッションが [Claude Code on the web](/ja/claude-code-on-the-web)などのマネージドクラウド環境で実行されている場合に利用可能です。配信は Anthropic ホストインフラストラクチャを通じて実行されるため、このツールは Amazon Bedrock、Google Vertex AI、または Microsoft Foundry では利用できません | いいえ |

42| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}}`ONBOARDING.md` をアップロードし、チームメンバーが Claude Code で開くことができる共有リンクを返します。ガイドが作成された後、`/team-onboarding` から呼び出されます。claude.ai の Pro、Max、Team、および Enterprise プランのサブスクライバーが利用可能です | はい |42| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}}`ONBOARDING.md` をアップロードし、チームメンバーが Claude Code で開くことができる共有リンクを返します。ガイドが作成された後、`/team-onboarding` から呼び出されます。claude.ai の Pro、Max、Team、および Enterprise プランのサブスクライバーが利用可能です | はい |

43| `Skill` | メイン会話内で [skill](/ja/skills#control-who-invokes-a-skill)を実行します | はい |43| `Skill` | メイン会話内で [skill](/ja/skills#control-who-invokes-a-skill)を実行します | はい |

45| `TaskGet` | 特定のタスクの完全な詳細を取得します | いいえ |45| `TaskGet` | 特定のタスクの完全な詳細を取得します | いいえ |

46| `TaskList` | すべてのタスクとその現在のステータスをリストします | いいえ |46| `TaskList` | すべてのタスクとその現在のステータスをリストします | いいえ |

47| `TaskOutput` | （非推奨）バックグラウンドタスクから出力を取得します。タスクの出力ファイルパスで `Read` を使用することをお勧めします | いいえ |47| `TaskOutput` | （非推奨）バックグラウンドタスクから出力を取得します。タスクの出力ファイルパスで `Read` を使用することをお勧めします | いいえ |

48| `TaskStop` | ID で実行中のバックグラウンドタスクを終了します | いいえ |48| `TaskStop` | ID で実行中のバックグラウンドタスクを終了します。{/* min-version: 2.1.198 */}v2.1.198 以降、[agent team メンバー](/ja/agent-teams)または agent ID または名前で名前付きバックグラウンドエージェントも受け入れます | いいえ |

49| `TaskUpdate` | タスクステータス、依存関係、詳細を更新するか、タスクを削除します | いいえ |49| `TaskUpdate` | タスクステータス、依存関係、詳細を更新するか、タスクを削除します | いいえ |

50| `TodoWrite` | {/* min-version: 2.1.142 */}セッションタスクチェックリストを管理します。v2.1.142 以降、`TaskCreate`、`TaskGet`、`TaskList`、`TaskUpdate` を優先するため、デフォルトで無効になっています。`CLAUDE_CODE_ENABLE_TASKS=0` を設定して再度有効にします | いいえ |50| `TodoWrite` | {/* min-version: 2.1.142 */}セッションタスクチェックリストを管理します。v2.1.142 以降、`TaskCreate`、`TaskGet`、`TaskList`、`TaskUpdate` を優先するため、デフォルトで無効になっています。`CLAUDE_CODE_ENABLE_TASKS=0` を設定して再度有効にします | いいえ |

51| `ToolSearch` | [ツール検索](/ja/mcp#scale-with-mcp-tool-search)が有効な場合、遅延ツールを検索してロードします | いいえ |51| `ToolSearch` | [ツール検索](/ja/mcp#scale-with-mcp-tool-search)が有効な場合、遅延ツールを検索してロードします | いいえ |

52| `WaitForMcpServers` | {/* min-version: 2.1.142 */}バックグラウンドでまだ接続中の 1 つ以上の [MCP servers](/ja/mcp)を待機するため、セッションを再開することなくそのツールをリクエストで使用できます。必要なサーバーがまだ接続されていない場合、Claude はそれを呼び出します。[ツール検索](/ja/mcp#scale-with-mcp-tool-search)が無効な場合にのみ表示されます。有効な場合は `ToolSearch` が待機を処理するため | いいえ |52| `WaitForMcpServers` | バックグラウンドでまだ接続中の 1 つ以上の [MCP servers](/ja/mcp)を待機するため、セッションを再開することなくそのツールをリクエストで使用できます。必要なサーバーがまだ接続されていない場合、Claude はそれを呼び出します。[ツール検索](/ja/mcp#scale-with-mcp-tool-search)が無効な場合にのみ表示されます。有効な場合は `ToolSearch` が待機を処理するため | いいえ |

53| `WebFetch` | 指定された URL からコンテンツを取得します。[WebFetch ツールの動作](#webfetch-tool-behavior)を参照してください | はい |53| `WebFetch` | 指定された URL からコンテンツを取得します。[WebFetch ツールの動作](#webfetch-tool-behavior)を参照してください | はい |

54| `WebSearch` | Web 検索を実行します。[WebSearch ツールの動作](#websearch-tool-behavior)を参照してください | はい |54| `WebSearch` | Web 検索を実行します。[WebSearch ツールの動作](#websearch-tool-behavior)を参照してください | はい |

55| `Workflow` | [動的ワークフロー](/ja/workflows)を実行します：バックグラウンドで多くの subagent を調整し、1 つの統合結果を返すスクリプト | はい |55| `Workflow` | [動的ワークフロー](/ja/workflows)を実行します：バックグラウンドで多くの subagent を調整し、1 つの統合結果を返すスクリプト | はい |

102* **`disallowedTools` のみ**：subagent は親のすべてのツール（リストされたもの除く）を取得します。102* **`disallowedTools` のみ**：subagent は親のすべてのツール（リストされたもの除く）を取得します。

103* **両方設定**：`disallowedTools` が優先されます。両方にリストされているツールは削除されます。103* **両方設定**：`disallowedTools` が優先されます。両方にリストされているツールは削除されます。

104 104

105Subagent を起動しても、それ自体は権限を求めるプロンプトを表示しません。Subagent の独自のツール呼び出しは、実行時に権限ルールに対してチェックされます：105Subagent を起動しても、それ自体は権限を求めるプロンプトを表示しません。Claude Code は、実行時に subagent の独自のツール呼び出しを権限ルールに対してチェックします。

106

107{/* min-version: 2.1.198 */}v2.1.198 以降、subagent はデフォルトでバックグラウンドで実行されます。Claude は結果が必要になる前に続行する必要がある場合、フォアグラウンドで実行します。

106 108

107* **フォアグラウンド subagent** は、メイン会話で見られるのと同じ権限プロンプトを表示し、各ツール呼び出しが発生した時点で表示されます。109* **フォアグラウンド subagent** は、メイン会話で見られるのと同じ権限プロンプトを表示し、各ツール呼び出しが発生した時点で表示されます。

108* **バックグラウンド subagent** {/* min-version: 2.1.186 */}は v2.1.186 以降、メインセッションで権限プロンプトを表示します。プロンプトはどの subagent がリクエストしているかを示し、Esc キーを押すとその 1 つのツール呼び出しを拒否し、subagent を停止しません。v2.1.186 より前は、バックグラウンド subagent は、そうでなければプロンプトを表示するツール呼び出しを自動的に拒否し、そのツールなしで続行していました。110* **バックグラウンド subagent** {/* min-version: 2.1.186 */}は v2.1.186 以降、メインセッションで権限プロンプトを表示します。プロンプトはどの subagent がリクエストしているかを示し、Esc キーを押すとその 1 つのツール呼び出しを拒否し、subagent を停止しません。v2.1.186 より前は、バックグラウンド subagent は、そうでなければプロンプトを表示するツール呼び出しを自動的に拒否し、そのツールなしで続行していました。

266 PowerShell ツール268 PowerShell ツール

267</h2>269</h2>

268 270

269PowerShell ツールを使用すると、Claude は PowerShell コマンドをネイティブに実行できます。Windows では、これは Git Bash を経由するのではなく、PowerShell でコマンドが実行されることを意味します。Git Bash がない Windows では、ツールは自動的に有効になります。Git Bash がインストールされている Windows では、ツールは段階的にロールアウトされています。Linux、macOS、および WSL では、ツールはオプトインです。271PowerShell ツールを使用すると、Claude は PowerShell コマンドをネイティブに実行できます。Windows では、これは Git Bash を経由するのではなく、PowerShell でコマンドが実行されることを意味します。ツールが利用可能になる方法はプラットフォームによって異なります：

272

273* **Git Bash がない Windows**：ツールは自動的に有効になります。

274* **Git Bash がインストールされている Windows**：ツールは段階的にロールアウトされています。

275* **Linux、macOS、および WSL**：ツールはオプトインです。

270 276

271<h3 id="enable-the-powershell-tool">277<h3 id="enable-the-powershell-tool">

272 PowerShell ツールを有効にする278 PowerShell ツールを有効にする

286 292

287Windows では、Claude Code は PowerShell 7 以降の `pwsh.exe` を自動検出し、PowerShell 5.1 の `powershell.exe` にフォールバックします。ツールが有効になっている場合、Claude は PowerShell をプライマリシェルとして扱います。Git Bash がインストールされている場合、Bash ツールは POSIX スクリプト用に利用可能なままです。293Windows では、Claude Code は PowerShell 7 以降の `pwsh.exe` を自動検出し、PowerShell 5.1 の `powershell.exe` にフォールバックします。ツールが有効になっている場合、Claude は PowerShell をプライマリシェルとして扱います。Git Bash がインストールされている場合、Bash ツールは POSIX スクリプト用に利用可能なままです。

288 294

289Claude Code は `-ExecutionPolicy Bypass` を使用して PowerShell をプロセススコープのみで生成するため、`.ps1` スクリプトとモジュールのインポートは、マシンのポリシーを変更することなく、デフォルトの Windows インストールで機能します。プロセススコープのバイパスは、グループポリシーの `MachinePolicy` または `UserPolicy` をオーバーライドしないため、エンタープライズロックダウンは引き続き適用されます。マシンの有効な実行ポリシーを尊重する代わりに、`CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1` を設定します。295Claude Code は `-ExecutionPolicy Bypass` を使用して PowerShell をプロセススコープのみで生成するため、`.ps1` スクリプトとモジュールのインポートは、マシンのポリシーを変更することなく、デフォルトの Windows インストールで機能します。プロセススコープのバイパスは、グループポリシーの `MachinePolicy` または `UserPolicy` をオーバーライドしないため、エンタープライズポリシーは引き続き適用されます。マシンの有効な実行ポリシーを尊重する代わりに、`CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1` を設定します。

290 296

291<h3 id="shell-selection-in-settings-hooks-and-skills">297<h3 id="shell-selection-in-settings-hooks-and-skills">

292 設定、フック、スキルでのシェル選択298 設定、フック、スキルでのシェル選択

346 352

347明示的な `WebFetch(domain:...)` ルールが `deny`、`ask`、または `allow` にある場合、事前承認されたセットよりも優先されるため、事前承認されたドメインをブロックするか、そのドメインに対してプロンプトを要求できます。353明示的な `WebFetch(domain:...)` ルールが `deny`、`ask`、または `allow` にある場合、事前承認されたセットよりも優先されるため、事前承認されたドメインをブロックするか、そのドメインに対してプロンプトを要求できます。

348 354

349WebFetch は `Claude-User` で始まる `User-Agent` ヘッダーと、HTML よりも Markdown を優先する `Accept` ヘッダーを設定するため、コンテンツネゴシエーションをサポートするサーバーは Markdown を直接返すことができます。[Sandbox](/ja/sandboxing)ネットワークルールは別途構成されるため、サンドボックス化されたプロセスが到達したいドメインには、明示的なサンドボックス権限ルールが必要です。355WebFetch は `Claude-User` で始まる `User-Agent` ヘッダーと、HTML よりも Markdown を優先する `Accept` ヘッダーを設定するため、コンテンツネゴシエーションをサポートするサーバーは Markdown を直接返すことができます。[sandbox](/ja/sandboxing)ネットワークルールは別途構成されるため、サンドボックス化されたプロセスが到達したいドメインには、明示的なサンドボックス権限ルールが必要です。

350 356

351<h2 id="websearch-tool-behavior">357<h2 id="websearch-tool-behavior">

352 WebSearch ツールの動作358 WebSearch ツールの動作

361WebSearch 権限ルールは指定子を取りません。`allow` または `deny` の裸の `WebSearch` エントリのみが唯一の形式です。367WebSearch 権限ルールは指定子を取りません。`allow` または `deny` の裸の `WebSearch` エントリのみが唯一の形式です。

362 368

363<Note>369<Note>

364 WebSearch は Claude API と Microsoft Foundry で利用可能です。Google Cloud Vertex AI では、Opus、Sonnet、Haiku を含む Claude 4 モデル以降で機能します。Amazon Bedrock はサーバー側の Web 検索ツールを公開していません。370 WebSearch は Claude API、[Claude Platform on AWS](/ja/claude-platform-on-aws)、および Microsoft Foundry で利用可能です。Google Cloud Vertex AI では、Opus、Sonnet、Haiku を含む Claude 4 以降のモデルで機能します。Amazon Bedrock はサーバー側の Web 検索ツールを公開していません。

365</Note>371</Note>

366 372

367<h2 id="write-tool-behavior">373<h2 id="write-tool-behavior">

worktrees.md +2 −0

Details

36 36

37セッション中に Claude に「worktree で作業する」と指示することもでき、[`EnterWorktree`](/ja/tools-reference) ツールを使用して作成します。Worktree に入ると、Claude は `.claude/worktrees/` の下の別の worktree に `EnterWorktree` をターゲットパスで呼び出すことで直接切り替えることができます。前の worktree はディスク上に変更されずに残ります。37セッション中に Claude に「worktree で作業する」と指示することもでき、[`EnterWorktree`](/ja/tools-reference) ツールを使用して作成します。Worktree に入ると、Claude は `.claude/worktrees/` の下の別の worktree に `EnterWorktree` をターゲットパスで呼び出すことで直接切り替えることができます。前の worktree はディスク上に変更されずに残ります。

38 38

39{/* min-version: 2.1.198 */}v2.1.198 以降、worktree に入るか出るかは、セッショントランスクリプトをそのディレクトリのプロジェクトストレージに再配置します。これは [`/cd`](/ja/commands)と同じ方法で行われるため、`/desktop` と `--resume` はその後そこでセッションを見つけます。[`WorktreeCreate` フック](#non-git-version-control)によって作成された Worktree は除外され、トランスクリプトを起動ディレクトリに保持します。

39初めてディレクトリで `--worktree` をインタラクティブに使用する前に、そのディレクトリで `claude` を 1 回実行してワークスペース信頼ダイアログを受け入れてください。信頼がまだ受け入れられていない場合、`--worktree` はエラーで終了し、最初にディレクトリで `claude` を実行するよう求めるプロンプトが表示されます。`-p` を使用した非インタラクティブ実行は[信頼チェック](/ja/security)をスキップするため、`claude -p --worktree` はそれなしで進行します。41初めてディレクトリで `--worktree` をインタラクティブに使用する前に、そのディレクトリで `claude` を 1 回実行してワークスペース信頼ダイアログを受け入れてください。信頼がまだ受け入れられていない場合、`--worktree` はエラーで終了し、最初にディレクトリで `claude` を実行するよう求めるプロンプトが表示されます。`-p` を使用した非インタラクティブ実行は[信頼チェック](/ja/security)をスキップするため、`claude -p --worktree` はそれなしで進行します。

40 42

41<Tip>43<Tip>

Documentation 2026-07-02 23:59 UTC to 2026-07-03 23:00 UTC