Documentation 2026-11-09 23:02 UTC to 2026-11-10 21:57 UTC

160* **API 課金**: advisor トークンに対して advisor モデルの入力および出力レートで課金されます160* **API 課金**: advisor トークンに対して advisor モデルの入力および出力レートで課金されます

161* **サブスクリプションプラン**: advisor 使用量はプランの使用制限にカウントされます。ただし、Fable advisor は Fable 使用量が課金される計画では[使用クレジット](https://code.claude.com/docs/ja/model-config.md#fable-and-usage-credits)に課金されます161* **サブスクリプションプラン**: advisor 使用量はプランの使用制限にカウントされます。ただし、Fable advisor は Fable 使用量が課金される計画では[使用クレジット](https://code.claude.com/docs/ja/model-config.md#fable-and-usage-credits)に課金されます

162 162 

163アカウントが使用クレジット同意を必要とする場合、Fable advisor は同意を与えるまで何も課金されません。Claude Code はそれまで[選択を適用しない](#fable-advisor-and-usage-credits)ためです。163Fable advisor と使用クレジットの連携については、[Fable advisor と使用クレジット](#fable-advisor-and-usage-credits)を参照してください。

164 164 

165Claude は各ターンではなく決定ポイントで advisor を呼び出すため、より高速なメインモデルをより強力な advisor と組み合わせることは、通常、より強力なモデルを全体で実行するよりもコストが低くなります。advisor 使用量は [`/usage`](https://code.claude.com/docs/ja/costs#track-your-costs)で表示されるセッション合計にカウントされます。165Claude は各ターンではなく決定ポイントで advisor を呼び出すため、より高速なメインモデルをより強力な advisor と組み合わせることは、通常、より強力なモデルを全体で実行するよりもコストが低くなります。advisor 使用量は [`/usage`](https://code.claude.com/docs/ja/costs#track-your-costs)で表示されるセッション合計にカウントされます。

166 166 

247* **トップレベルフィールド**はすべてのイベントで受け入れられます。`systemMessage` はユーザーにメッセージを表示し、`continue`（Python では `continue_`）はこのフック後にエージェントが実行を続けるかどうかを決定します。一部のイベントはこれらを破棄するか、別の場所に配信します。各[イベントのセクション](https://code.claude.com/docs/ja/hooks.md#hook-events)はフックページでそれらがどこに着地するかを説明しています。247* **トップレベルフィールド**はすべてのイベントで受け入れられます。`systemMessage` はユーザーにメッセージを表示し、`continue`（Python では `continue_`）はこのフック後にエージェントが実行を続けるかどうかを決定します。一部のイベントはこれらを破棄するか、別の場所に配信します。各[イベントのセクション](https://code.claude.com/docs/ja/hooks.md#hook-events)はフックページでそれらがどこに着地するかを説明しています。

248* **`hookSpecificOutput`** は現在の操作を制御します。内部に設定するフィールドはフックイベントタイプに依存します。248* **`hookSpecificOutput`** は現在の操作を制御します。内部に設定するフィールドはフックイベントタイプに依存します。

249 * `PreToolUse` フックの場合、ここで `permissionDecision`（`"allow"`、`"deny"`、`"ask"`、または `"defer"`）、`permissionDecisionReason`、および `updatedInput` を設定します。`"defer"` を返すと、`stop_reason` が `"tool_deferred"` である結果メッセージでターンが終了するため、[後で呼び出しを再開](https://code.claude.com/docs/ja/hooks.md#defer-a-tool-call-for-later)できます。249 * `PreToolUse` フックの場合、ここで `permissionDecision`（`"allow"`、`"deny"`、`"ask"`、または `"defer"`）、`permissionDecisionReason`、および `updatedInput` を設定します。`"defer"` を返すと、`stop_reason` が `"tool_deferred"` である結果メッセージでターンが終了するため、[後で呼び出しを再開](https://code.claude.com/docs/ja/hooks.md#defer-a-tool-call-for-later)できます。

250 * `PostToolUse` フックの場合、`additionalContext` を設定してツール結果に情報を追加できます。Claude がそれを見る前にツールの出力を置き換えるには、`updatedToolOutput` を設定します。これは両方の SDK のすべてのツールで機能します。古い `updatedMCPToolOutput` フィールドは MCP ツール出力のみを置き換えます。250 * `PostToolUse` フックの場合、`additionalContext` を設定してツール結果に情報を追加できます。Claude がそれを見る前にツールの出力を置き換えるには、`updatedToolOutput` を設定します。これは両方の SDK で組み込みツールと MCP ツールに対して機能します。古い `updatedMCPToolOutput` フィールドは MCP ツール出力のみを置き換えます。

251 * TypeScript SDK では、`PostToolUse` コールバックは `classifierContext` を返すこともできます。これはツール呼び出しの結果に関する短いメモで、[auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)の権限分類器用です。コールバックはアプリケーション独自のプロセスで実行されるため、分類器はメモで中継するユーザーステートメントをユーザーの意図として重視する可能性があります。このフィールドは TypeScript Agent SDK v0.3.236 以降が必要です。[auto モード分類器の結果に注釈を付ける](https://code.claude.com/docs/ja/hooks.md#annotate-a-result-for-the-auto-mode-classifier)は長さの上限、同期のみのルール、およびメモに何を入れないかをカバーしています。251 * TypeScript SDK では、`PostToolUse` コールバックは `classifierContext` を返すこともできます。これはツール呼び出しの結果に関する短いメモで、[auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)の権限分類器用です。コールバックはアプリケーション独自のプロセスで実行されるため、分類器はメモで中継するユーザーステートメントをユーザーの意図として重視する可能性があります。このフィールドは TypeScript Agent SDK v0.3.236 以降が必要です。[auto モード分類器の結果に注釈を付ける](https://code.claude.com/docs/ja/hooks.md#annotate-a-result-for-the-auto-mode-classifier)は長さの上限、同期のみのルール、およびメモに何を入れないかをカバーしています。

252 252 

253変更なしで操作を許可するには `{}` を返します。SDK コールバックフックは、[Claude Code シェルコマンドフック](https://code.claude.com/docs/ja/hooks.md#json-output)と同じ JSON 出力形式を使用します。これはすべてのフィールドとイベント固有のオプションを文書化しています。SDK 型定義については、[TypeScript](https://code.claude.com/docs/ja/agent-sdk/typescript.md#synchookjsonoutput) および [Python](https://code.claude.com/docs/ja/agent-sdk/python.md#synchookjsonoutput) SDK リファレンスを参照してください。253変更なしで操作を許可するには `{}` を返します。SDK コールバックフックは、[Claude Code シェルコマンドフック](https://code.claude.com/docs/ja/hooks.md#json-output)と同じ JSON 出力形式を使用します。これはすべてのフィールドとイベント固有のオプションを文書化しています。SDK 型定義については、[TypeScript](https://code.claude.com/docs/ja/agent-sdk/typescript.md#synchookjsonoutput) および [Python](https://code.claude.com/docs/ja/agent-sdk/python.md#synchookjsonoutput) SDK リファレンスを参照してください。

1858 1858 

1859### `TaskStartedMessage`1859### `TaskStartedMessage`

1860 1860 

1861バックグラウンドタスクが開始されたときに発行されます。バックグラウンドタスクは、メインターンの外で追跡されるもの：バックグラウンド Bash コマンド、[Monitor](#monitor) ウォッチ、Agent ツール経由で生成されたサブエージェント、またはリモートエージェント。`task_type` フィールドはどれであるかを示します。このネーミングは `Task` から `Agent` ツールへの名前変更とは無関係です。1861バックグラウンドタスクが開始されたときに発行されます。バックグラウンドタスクとは、メインターンの外で追跡されるもので、バックグラウンド Bash コマンド、[Monitor](#monitor) ウォッチ、Agent ツール経由で生成されたサブエージェント、リモートエージェントなどがあります。このネーミングは `Task` から `Agent` ツールへの名前変更とは無関係です。

1862 1862 

1863```python theme={null}1863```python theme={null}

1864@dataclass1864@dataclass

1878| `uuid` | `str` | 一意のメッセージ識別子 |1878| `uuid` | `str` | 一意のメッセージ識別子 |

1879| `session_id` | `str` | セッション識別子 |1879| `session_id` | `str` | セッション識別子 |

1880| `tool_use_id` | `str \| None` | 関連するツール使用 ID |1880| `tool_use_id` | `str \| None` | 関連するツール使用 ID |

1881| `task_type` | `str \| None` | バックグラウンドタスクの種類：バックグラウンド Bash と Monitor ウォッチの場合は `"local_bash"`、`"local_agent"`、または `"remote_agent"` |1881| `task_type` | `str \| None` | バックグラウンドタスクの種類。たとえば、バックグラウンド Bash と Monitor ウォッチの場合は `"local_bash"`、サブエージェントの場合は `"local_agent"`、[バックグラウンドの MCP ツール呼び出し](https://code.claude.com/docs/ja/mcp.md#automatic-backgrounding-of-long-tool-calls) の場合は `"mcp_task"`、または `"remote_agent"` です |

1882 1882 

1883### `TaskUsage`1883### `TaskUsage`

1884 1884 

81 }81 }

82 })) {82 })) {

83 // 結果メッセージには検証済みデータを含む structured_output が含まれます83 // 結果メッセージには検証済みデータを含む structured_output が含まれます

84 if (message.type === "result" && message.subtype === "success" && message.structured_output) {84 if (message.type === "result" && message.subtype === "success" && !message.is_error && message.structured_output) {

85 console.log(message.structured_output);85 console.log(message.structured_output);

86 // { company_name: "Anthropic", founded_year: 2021, headquarters: "San Francisco, CA" }86 // { company_name: "Anthropic", founded_year: 2021, headquarters: "San Francisco, CA" }

87 }87 }

117 ),117 ),

118 ):118 ):

119 # 結果メッセージには検証済みデータを含む structured_output が含まれます119 # 結果メッセージには検証済みデータを含む structured_output が含まれます

120 if isinstance(message, ResultMessage) and message.structured_output:120 if (

121 isinstance(message, ResultMessage)

122 and not message.is_error

123 and message.structured_output

124 ):

121 print(message.structured_output)125 print(message.structured_output)

122 # {'company_name': 'Anthropic', 'founded_year': 2021, 'headquarters': 'San Francisco, CA'}126 # {'company_name': 'Anthropic', 'founded_year': 2021, 'headquarters': 'San Francisco, CA'}

123 except Exception as error:127 except Exception as error:

171 }175 }

172 }176 }

173 })) {177 })) {

174 if (message.type === "result" && message.subtype === "success" && message.structured_output) {178 if (message.type === "result" && message.subtype === "success" && !message.is_error && message.structured_output) {

175 // Validate and get fully typed result179 // Validate and get fully typed result

176 const parsed = FeaturePlan.safeParse(message.structured_output);180 const parsed = FeaturePlan.safeParse(message.structured_output);

177 if (parsed.success) {181 if (parsed.success) {

221 }225 }

222 ),226 ),

223 ):227 ):

224 if isinstance(message, ResultMessage) and message.structured_output:228 if (

229 isinstance(message, ResultMessage)

230 and not message.is_error

231 and message.structured_output

232 ):

225 # Validate and get fully typed result233 # Validate and get fully typed result

226 plan = FeaturePlan.model_validate(message.structured_output)234 plan = FeaturePlan.model_validate(message.structured_output)

227 print(f"Feature: {plan.feature_name}")235 print(f"Feature: {plan.feature_name}")

295 }303 }

296 }304 }

297 })) {305 })) {

298 if (message.type === "result" && message.subtype === "success" && message.structured_output) {306 if (message.type === "result" && message.subtype === "success" && !message.is_error && message.structured_output) {

299 const data = message.structured_output as { total_count: number; todos: Array<{ file: string; line: number; text: string; author?: string; date?: string }> };307 const data = message.structured_output as { total_count: number; todos: Array<{ file: string; line: number; text: string; author?: string; date?: string }> };

300 console.log(`Found ${data.total_count} TODOs`);308 console.log(`Found ${data.total_count} TODOs`);

301 data.todos.forEach((todo) => {309 data.todos.forEach((todo) => {

350 output_format={"type": "json_schema", "schema": todo_schema}358 output_format={"type": "json_schema", "schema": todo_schema}

351 ),359 ),

352 ):360 ):

353 if isinstance(message, ResultMessage) and message.structured_output:361 if (

362 isinstance(message, ResultMessage)

363 and not message.is_error

364 and message.structured_output

365 ):

354 data = message.structured_output366 data = message.structured_output

355 print(f"Found {data['total_count']} TODOs")367 print(f"Found {data['total_count']} TODOs")

356 for todo in data["todos"]:368 for todo in data["todos"]:

381 393 

382構造化された出力の生成は、エージェントがスキーマに一致する有効な JSON を生成できない場合に失敗する可能性があります。これは通常、スキーマがタスクに対して複雑すぎる場合、タスク自体が曖昧な場合、またはエージェントが検証エラーを修正しようとして再試行制限に達した場合に発生します。また、検証の失敗がなくても発生する可能性があります。[モデルフォールバック](https://code.claude.com/docs/ja/model-config.md#automatic-model-fallback)は既に完了した出力をストリーム中に取り消すことができ、再試行がそれを置き換えない場合、実行は同じエラーで終了します。スキーマをデバッグする前に、エラー結果メッセージの `errors` リストを確認して、2 つの原因を区別してください。394構造化された出力の生成は、エージェントがスキーマに一致する有効な JSON を生成できない場合に失敗する可能性があります。これは通常、スキーマがタスクに対して複雑すぎる場合、タスク自体が曖昧な場合、またはエージェントが検証エラーを修正しようとして再試行制限に達した場合に発生します。また、検証の失敗がなくても発生する可能性があります。[モデルフォールバック](https://code.claude.com/docs/ja/model-config.md#automatic-model-fallback)は既に完了した出力をストリーム中に取り消すことができ、再試行がそれを置き換えない場合、実行は同じエラーで終了します。スキーマをデバッグする前に、エラー結果メッセージの `errors` リストを確認して、2 つの原因を区別してください。

383 395 

384エラーが発生すると、結果メッセージには何が問題かを示す `subtype` があります：396結果メッセージの `subtype` を確認してください：

385 397 

386| Subtype | 意味 |398| Subtype | 意味 |

387| - | - |399| - | - |

388| `success` | 出力が正常に生成および検証されました |400| `success` | 実行がエラーの subtype なしで終了しました |

389| `error_max_structured_output_retries` | 複数の試行後に有効な出力が残りませんでした（検証の失敗、または成功した再試行のないモデルフォールバックによる取り消し） |401| `error_max_structured_output_retries` | 複数の試行後に有効な出力が残りませんでした（検証の失敗、または成功した再試行のないモデルフォールバックによる取り消し） |

390 402 

391結果は `subtype` が `success` でも `structured_output` 値がない場合に終了することもあります。例えば、実行がエージェントによる構造化出力の生成なしに完了した場合です。その場合も失敗として扱ってください。トラブルシューティングエントリ [structured\_output is None but the result says success](https://code.claude.com/docs/ja/agent-sdk/troubleshooting.md#structured_output-is-none-but-the-result-says-success) がこのケースをカバーしています。以下の例は、`subtype` が `success` で `structured_output` が存在する場合にのみ結果を成功として扱い、他のすべての結果を失敗として処理します：403`success` の subtype だけでは、実行が回答を生成したことを意味しません。結果の `is_error` が `true` の場合、または `structured_output` がない場合は、その結果を失敗として扱ってください：

404 

405* **結果の `is_error` が `true`**：例えば、最後のモデルリクエストが API エラーまたは拒否で終了した場合です。このような結果の `structured_output` 値は使用しないでください。

406* **`structured_output` がない**：原因を特定するには、[structured\_output is None but the result says success](https://code.claude.com/docs/ja/agent-sdk/troubleshooting.md#structured_output-is-none-but-the-result-says-success) を参照してください

407 

408以下の例では、これらのチェックを適用しています：

392 409 

393```typescript TypeScript theme={null}410```typescript TypeScript theme={null}

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

413 }430 }

414 })) {431 })) {

415 if (msg.type === "result") {432 if (msg.type === "result") {

416 if (msg.subtype === "success" && msg.structured_output) {433 if (msg.subtype === "success" && !msg.is_error && msg.structured_output) {

417 // 検証済み出力を使用434 // 検証済み出力を使用

418 console.log(msg.structured_output);435 console.log(msg.structured_output);

419 } else if (msg.subtype === "error_max_structured_output_retries") {436 } else if (msg.subtype === "error_max_structured_output_retries") {

420 console.error("Could not produce valid output");437 console.error("Could not produce valid output");

421 } else {438 } else {

422 console.error("Run ended without a structured output");439 console.error("Run ended with an error or without a structured output");

423 }440 }

424 }441 }

425 }442 }

454 ),471 ),

455 ):472 ):

456 if isinstance(message, ResultMessage):473 if isinstance(message, ResultMessage):

457 if message.subtype == "success" and message.structured_output:474 if (

475 message.subtype == "success"

476 and not message.is_error

477 and message.structured_output

478 ):

458 # 検証済み出力を使用479 # 検証済み出力を使用

459 print(message.structured_output)480 print(message.structured_output)

460 elif message.subtype == "error_max_structured_output_retries":481 elif message.subtype == "error_max_structured_output_retries":

461 print("Could not produce valid output")482 print("Could not produce valid output")

462 else:483 else:

463 print("Run ended without a structured output")484 print("Run ended with an error or without a structured output")

464 except Exception as error:485 except Exception as error:

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

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

142 142 

143結果メッセージは `subtype: "success"` で終わることがありますが、そのとき Python では `structured_output` が `None`、TypeScript では `undefined` になっている場合があります。実行は完了しますが、検証された出力は存在しません。143結果メッセージは `subtype: "success"` で終わることがありますが、そのとき Python では `structured_output` が `None`、TypeScript では `undefined` になっている場合があります。実行は完了しますが、検証された出力は存在しません。

144 144 

145アプリケーションコードでこの結果を失敗として扱ってください。`structured_output` を使用する前に、`subtype` が `success` であり、`structured_output` が存在することの両方を確認してください。[エラーハンドリング](https://code.claude.com/docs/ja/agent-sdk/structured-outputs.md#error-handling)セクションは両方の SDK のこのパターンを示しています。そのうえで、次の原因を確認してください。145アプリケーションコードでこの結果を失敗として扱ってください。[エラーハンドリング](https://code.claude.com/docs/ja/agent-sdk/structured-outputs.md#error-handling)セクションは両方の SDK のこのパターンを示しています。そのうえで、次の原因を確認してください。

146 146 

147* **Claude が拒否したリクエスト**：コードでこのケースを検出するには、結果メッセージの `stop_reason` が `"refusal"` であるかを確認してください。次に試すことについては、[Usage Policy refusal](https://code.claude.com/docs/ja/errors.md#usage-policy-refusal) を参照してください。147* **Claude が拒否したリクエスト**：コードでこのケースを検出するには、結果メッセージの `stop_reason` が `"refusal"` であるかを確認してください。次に試すことについては、[Usage Policy refusal](https://code.claude.com/docs/ja/errors.md#usage-policy-refusal) を参照してください。

148* **どの出力も満たすことができないスキーマ**：たとえば、`minLength` が `maxLength` より大きい文字列です。正しいと思われるスキーマで `structured_output` が繰り返し欠落する場合は、互いに矛盾する制約がないか確認してください。見つからない場合は、出力が検証されるまでスキーマを単純化し、制約を 1 つずつ再導入してください。148* **どの出力も満たすことができないスキーマ**：たとえば、`minLength` が `maxLength` より大きい文字列です。正しいと思われるスキーマで `structured_output` が繰り返し欠落する場合は、互いに矛盾する制約がないか確認してください。見つからない場合は、出力が検証されるまでスキーマを単純化し、制約を 1 つずつ再導入してください。

1923| `extra_usage_disabled` | アカウントの使用クレジットがオフになっている |1923| `extra_usage_disabled` | アカウントの使用クレジットがオフになっている |

1924| `network_error` | [利用可否チェック](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)が `api.anthropic.com` に到達できなかった |1924| `network_error` | [利用可否チェック](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)が `api.anthropic.com` に到達できなかった |

1925| `unknown` | Claude Code が利用可否を判定できなかった |1925| `unknown` | Claude Code が利用可否を判定できなかった |

1926| `not_first_party` | セッションが Anthropic API 以外のプロバイダーを使用している |1926| `not_first_party` | セッションが fast mode を提供していないプロバイダーを使用しています |

1927| `disabled_by_env` | [`CLAUDE_CODE_DISABLE_FAST_MODE`](https://code.claude.com/docs/ja/env-vars) が設定されている |1927| `disabled_by_env` | [`CLAUDE_CODE_DISABLE_FAST_MODE`](https://code.claude.com/docs/ja/env-vars) が設定されているか、[Google Cloud の Agent Platform](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-on-agent-platform) 上のモデルのリージョンが fast mode を提供していません |

1928| `model_not_allowed` | fast mode の Opus モデルが組織の [`availableModels`](https://code.claude.com/docs/ja/model-config#restrict-model-selection) 許可リストに含まれていない |1928| `model_not_allowed` | fast mode のモデルが組織の [`availableModels`](https://code.claude.com/docs/ja/model-config#restrict-model-selection) 許可リストに含まれていないか、プロバイダーがセッションのモデルに対して fast mode を拒否しました |

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

1930| `pending` | 利用可否チェックがまだ完了していない |1930| `pending` | 利用可否チェックがまだ完了していない |

1931 1931 

2007 2007 

2008#### `startup_failure_reason`2008#### `startup_failure_reason`

2009 2009 

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

2011 2011 

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

2013 2013 

5709 5709 

5710### `SDKTaskStartedMessage`5710### `SDKTaskStartedMessage`

5711 5711 

5712タスクが開始するときに発行されます。`task_type` フィールドは Bash コマンドと [Monitor](#monitor) ウォッチの場合は `"local_bash"`、サブエージェントの場合は `"local_agent"`、または `"remote_agent"` です。5712タスクが開始するときに発行されます。`task_type` はタスクの種類を示し、Bash コマンドと [Monitor](#monitor) ウォッチの場合は `"local_bash"`、サブエージェントの場合は `"local_agent"`、[バックグラウンドの MCP ツール呼び出し](https://code.claude.com/docs/ja/mcp.md#automatic-backgrounding-of-long-tool-calls)の場合は `"mcp_task"`、または `"remote_agent"` などの値を取ります。

5713 5713 

5714```typescript theme={null}5714```typescript theme={null}

5715type SDKTaskStartedMessage = {5715type SDKTaskStartedMessage = {

5918 errorCode?: "credits_required";5918 errorCode?: "credits_required";

5919 canUserPurchaseCredits?: boolean;5919 canUserPurchaseCredits?: boolean;

5920 hasChargeableSavedPaymentMethod?: boolean;5920 hasChargeableSavedPaymentMethod?: boolean;

5921 overageEnabled?: boolean;

5921 };5922 };

5922 uuid: UUID;5923 uuid: UUID;

5923 session_id: string;5924 session_id: string;

5926 5927 

5927`errorCode` が `"credits_required"` の場合、拒否は含まれる使用量を使い切った claude.ai サブスクリプションからのもので、ユーザーが使用クレジットを購入するまでセッションは続行できません。`canUserPurchaseCredits` は認証されたユーザーがアカウントのクレジットを購入できるかどうかを示し、`hasChargeableSavedPaymentMethod` は保存された支払い方法が登録されているかどうかを示します。3 つのフィールドはすべて、クレジット必須の拒否ではないレート制限イベントでは存在しません。Claude Code v2.1.181 以降が必要です。5928`errorCode` が `"credits_required"` の場合、拒否は含まれる使用量を使い切った claude.ai サブスクリプションからのもので、ユーザーが使用クレジットを購入するまでセッションは続行できません。`canUserPurchaseCredits` は認証されたユーザーがアカウントのクレジットを購入できるかどうかを示し、`hasChargeableSavedPaymentMethod` は保存された支払い方法が登録されているかどうかを示します。3 つのフィールドはすべて、クレジット必須の拒否ではないレート制限イベントでは存在しません。Claude Code v2.1.181 以降が必要です。

5928 5929 

5930プランの使用制限に関する警告（`status` が `"allowed_warning"` の場合）では、`overageEnabled` はアカウントで[使用クレジット](https://code.claude.com/docs/ja/costs.md#add-usage-credits-to-your-subscription)がオンになっているかどうかを報告します。Claude Code v2.1.295 以降が必要です。

5931 

5929### `SDKLocalCommandOutputMessage`5932### `SDKLocalCommandOutputMessage`

5930 5933 

5931Claude Code はこのメッセージタイプを発行しません。`/context` または `/usage` などのコマンドをプロンプトとして送信する場合、その出力は [`SDKAssistantMessage`](#sdkassistantmessage) として到着します。5934Claude Code はこのメッセージタイプを発行しません。`/context` または `/usage` などのコマンドをプロンプトとして送信する場合、その出力は [`SDKAssistantMessage`](#sdkassistantmessage) として到着します。

647 647 

648 648 

649def parse_response(response: str, options: list) -> str:649def parse_response(response: str, options: list) -> str:

650 """ユーザー入力をオプション番号または自由テキストとして解析します。"""650 """Parse user input as option number(s) or free text."""

651 try:651 try:

652 indices = [int(s.strip()) - 1 for s in response.split(",")]652 indices = [int(s.strip()) - 1 for s in response.split(",")]

653 labels = [options[i]["label"] for i in indices if 0 <= i < len(options)]653 labels = [options[i]["label"] for i in indices if 0 <= i < len(options)]

657 657 

658 658 

659async def handle_ask_user_question(input_data: dict) -> PermissionResultAllow:659async def handle_ask_user_question(input_data: dict) -> PermissionResultAllow:

660 """Claude の質問を表示してユーザーの回答を収集します。"""660 """Display Claude's questions and collect user answers."""

661 answers = {}661 answers = {}

662 662 

663 for q in input_data.get("questions", []):663 for q in input_data.get("questions", []):

8 8 

9> [!WARNING]9> [!WARNING]

10>10>

11> エージェントチームは実験的機能であり、デフォルトでは無効になっています。[settings.json](https://code.claude.com/docs/ja/settings.md) または環境に `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を設定して有効にしてください。その変数がない場合、セッション開始時にチームが設定されず、チームディレクトリが書き込まれず、Claude はチームメンバーをスポーンまたは提案しません。エージェントチームには、セッション再開、タスク調整、シャットダウン動作に関する[既知の制限](#limitations)があります。11> エージェントチームは実験的機能であり、デフォルトでは無効になっています。[settings.json](https://code.claude.com/docs/ja/settings.md) または環境に `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を設定して有効にしてください。エージェントチームには、セッション再開、タスク調整、シャットダウン動作に関する[既知の制限](#limitations)があります。

12 12 

13エージェントチームを使用すると、複数の Claude Code インスタンスが連携して動作するように調整できます。1 つのセッションがチームリーダーとして機能し、作業を調整し、タスクを割り当て、結果を統合します。チームメンバーは独立して動作し、それぞれ独自のコンテキストウィンドウで動作し、互いに直接通信します。リーダーを経由せずに、任意のチームメンバーと直接対話することもできます。13エージェントチームを使用すると、複数の Claude Code インスタンスが連携して動作するように調整できます。1 つのセッションがチームリーダーとして機能し、作業を調整し、タスクを割り当て、結果を統合します。チームメンバーは独立して動作し、それぞれ独自のコンテキストウィンドウで動作し、互いに直接通信します。リーダーを経由せずに、任意のチームメンバーと直接対話することもできます。

14 14 

841 841 

842セッションが独自の言葉で進捗を報告するようにしたい場合は、`state.json` を編集する代わりに、例えば `$CLAUDE_JOB_DIR/tmp` の下など、独自のファイルを書き込むようにしてください。842セッションが独自の言葉で進捗を報告するようにしたい場合は、`state.json` を編集する代わりに、例えば `$CLAUDE_JOB_DIR/tmp` の下など、独自のファイルを書き込むようにしてください。

843 843 

844## バックグラウンドセッションのホスティング方法844## バックグラウンドセッションのホスト方法

845 845 

846Claude Code は、エージェントビューに表示されているすべてのセッションをバックグラウンドセッションとして扱います。現在接続しているかどうかに関わらず、バックグラウンドセッションとして扱われます。これに対して、`claude` を直接実行して開始したセッションはそのターミナルに紐付けられ、ターミナルが閉じると終了します。ただし、[バックグラウンドに送信](#from-inside-a-session)することはできます。846Claude Code は、エージェントビューに一覧表示されるすべてのセッションを、現在アタッチしているかどうかにかかわらずバックグラウンドセッションとして扱います。これに対して、`claude` を直接実行して開始したセッションはそのターミナルに紐付けられ、[バックグラウンドに送る](#from-inside-a-session)場合を除き、ターミナルを閉じると終了します。

847 847 

848どのような種類のセッションにいるかを確認するには、[`/status`](https://code.claude.com/docs/ja/commands) を実行してください。バックグラウンドセッションでは、`Session kind` の行に `background job · attached` または `background job · unattended` と表示されます。ターミナルが接続されているかどうかによって異なります。その他のセッションでは `interactive` と表示されます。848現在どの種類のセッションにいるかを確認するには、[`/status`](https://code.claude.com/docs/ja/commands) を実行します。`Session kind` 行には、バックグラウンドセッションではターミナルがアタッチされているかどうかに応じて `background job · attached` または `background job · unattended` と表示され、それ以外のセッションでは `interactive` と表示されます。

849 849 

850### スーパーバイザープロセス850### スーパーバイザープロセス

851 851 

852スーパーバイザーはバックグラウンドサービスで、バックグラウンドセッションを実行し、エージェントビューやターミナルを閉じた後もセッションが動作し続けるようにします。Claude Code は、セッションをバックグラウンドに送信するか、エージェントビューを開いた時点で最初にスーパーバイザーを起動します。自分で管理する必要はありません。852スーパーバイザーは、エージェントビューやターミナルを閉じた後もバックグラウンドセッションが動作し続けるよう、それらを実行するバックグラウンドサービスです。Claude Code は、初めてセッションをバックグラウンドに送るかエージェントビューを開いたときにスーパーバイザーを起動するため、自分で管理する必要はありません。

853 853 

854各セッションはスーパーバイザーの下で独自の Claude Code プロセスであり、そのプロセスに何が起こるかはセッションの状態によって異なります。854各セッションはスーパーバイザー配下の個別の Claude Code プロセスであり、そのプロセスがどうなるかはセッションの状態によって異なります。

855 855 

856* **動作中、権限プロンプトまたは他のダイアログで一時停止中、または接続中**：プロセスは実行を続けます。実行中のサブエージェント、ワークフロー、またはモニターは動作中としてカウントされます。`/loop` のウェイクアップなど、保留中の[セッションスコープのスケジュールタスク](https://code.claude.com/docs/ja/scheduled-tasks.md)も同様です。856* **作業中、権限プロンプトやその他のダイアログで一時停止中、またはアタッチ中**：プロセスは実行を続けます。実行中のサブエージェント、ワークフロー、モニターは作業中とみなされ、`/loop` のウェイクアップなど保留中の[セッションスコープのスケジュールタスク](https://code.claude.com/docs/ja/scheduled-tasks.md)も同様です。

857* **完了したか次のメッセージを待機中で、約 1 時間未接続**：スーパーバイザーはリソースを解放するためにプロセスを停止します。質問を投げかけてターンを終了したセッションは、次のメッセージを待機中としてカウントされます。会話はディスクに保存され、次回接続または返信するときに、セッションは中断したところから再開されます。`Ctrl+T` でセッションをピンして、プロセスの実行を継続させます。857* **完了済み、または次のメッセージを待機中で、約 1 時間アタッチされていない**：スーパーバイザーはリソースを解放するためにプロセスを停止します。質問をしてターンを終えたセッションは、次のメッセージを待機中とみなされます。会話はディスク上に残り、次にアタッチまたは返信すると、セッションは中断したところから再開します。プロセスを実行し続けるには、`Ctrl+T` でセッションをピン留めします。

858* **スーパーバイザーが実行中に予期せず終了した**：スーパーバイザーはプロセスを再起動します。`←` または `/background` で自分でバックグラウンドに送信したセッションを、たとえば `kill` で終了した場合は、再起動されずに停止済みとしてマークされます。シャットダウンで終了したセッションについては、[セッションがシャットダウン後に失敗または停止として表示される](#sessions-show-as-failed-after-shutdown) を参照してください。858* **スーパーバイザーの実行中にセッションのプロセスが予期せず終了した**：スーパーバイザーがそのプロセスを再起動します。`←` または `/background` で自分でバックグラウンドに送ったセッションを、たとえば `kill` で終了した場合は、再起動されずに停止済みとしてマークされます。シャットダウンによって終了したセッションについては、[シャットダウン後にセッションが失敗または停止と表示される](#sessions-show-as-failed-after-shutdown)を参照してください。

859* **自動更新後**：スーパーバイザーは新しいバージョンに再起動し、アイドル状態のセッションをバックグラウンドで移動します。動作中、ユーザーの応答を待機中、または接続中のセッションは中断されません。859* **自動更新の後**：スーパーバイザーは新しいバージョンで自身を再起動し、アイドル状態のセッションをバックグラウンドで移行します。作業中、ユーザーの応答待ち、またはアタッチ中のセッションは中断されません。

860* **スーパーバイザー自体が停止した**（たとえば、そのプロセスが Claude Code の外部から終了された場合）：macOS と Linux では、約 1 分以内に新しいスーパーバイザーが接続しない限り、セッションは停止します。スーパーバイザーを起動するには、シェルで `claude agents` を実行してください。その 1 分が経過した後については、[スーパーバイザーの停止後もセッションを実行し続ける](#keep-sessions-running-after-the-supervisor-stops) を参照してください。860* **スーパーバイザー自体が停止した**（たとえば、そのプロセスが Claude Code の外部から終了された場合）：macOS と Linux では、約 1 分以内に新しいスーパーバイザーが接続しない限り、セッションは停止します。スーパーバイザーを起動するには、シェルで `claude agents` を実行します。その 1 分を過ぎた場合は、[スーパーバイザー停止後もセッションを実行し続ける](#keep-sessions-running-after-the-supervisor-stops)を参照してください。

861 861 

862セッションのプロセスが停止または再起動されると、Claude がそのセッションで開始したバックグラウンドシェルコマンドとバックグラウンドサブエージェントは次のプロセスに引き継がれます。動的ワークフローは、[Claude が再起動した場合にのみ続行されます](#dynamic-workflows-when-you-background)。実行中のモニターとサブエージェントが開始したシェルコマンドはプロセスで停止します。セッションを削除すると、引き継がれたすべてのものが停止します。代わりにプロセスで停止させるには、[`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](https://code.claude.com/docs/ja/env-vars#variables) を `1` に設定してください。862セッションのプロセスが停止または再起動すると、Claude がそのセッションで開始したバックグラウンドのシェルコマンドとバックグラウンドのサブエージェントは、次のプロセスに引き継がれます。動的ワークフローは、[Claude が再起動した場合にのみ続行されます](#dynamic-workflows-when-you-background)。実行中のモニターと、サブエージェントが開始したシェルコマンドは、プロセスとともに停止します。セッションを削除すると、引き継がれたものはすべて停止します。代わりにこれらすべてをプロセスとともに停止するには、[`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](https://code.claude.com/docs/ja/env-vars#variables) を `1` に設定します。

863 863 

864スーパーバイザーとそのセッションは、インタラクティブセッションと同じ保存された認証情報で認証されます。セッションに到達する設定とシェル変数（`PATH` を含む）については、[設定とプロバイダー](#settings-and-provider) を参照してください。ゲートウェイエンドポイントについては、[LLM ゲートウェイ](#llm-gateway) を参照してください。864スーパーバイザーとそのセッションは、対話型セッションと同じ保存済みの認証情報で認証します。`PATH` を含め、どの設定とシェル変数がセッションに渡されるかについては、[設定とプロバイダー](#settings-and-provider)を参照してください。ゲートウェイのエンドポイントについては、[LLM ゲートウェイ](#llm-gateway)を参照してください。

865 865 

866#### スーパーバイザーの停止後もセッションを実行し続ける866#### スーパーバイザー停止後もセッションを実行し続ける

867 867 

868エージェントビューの終了時に次の通知が表示された場合、[スーパーバイザー](#the-supervisor-process)は実行されていません。868エージェントビューの終了時に次の通知が表示された場合、[スーパーバイザー](#the-supervisor-process)は実行されていません。

869 869 

871Background sessions still running will stop in about a minute. Run 'claude agents' to keep them.871Background sessions still running will stop in about a minute. Run 'claude agents' to keep them.

872```872```

873 873 

874その 1 分以内にシェルで `claude agents` を実行すると、新しいスーパーバイザーが起動し、セッションの実行が継続されます。874その 1 分以内にシェルで `claude agents` を実行すると、新しいスーパーバイザーが起動し、セッションが実行され続けます。

875 875 

876先に 1 分が経過した場合、セッションは停止しますが、保存された会話はディスクに残ります。保存された会話からセッションを再起動するには、[セッションがシャットダウン後に失敗または停止として表示される](#sessions-show-as-failed-after-shutdown) で説明されているように、セッションに[接続](#attach-to-a-session)するか[返信](#peek-and-reply)してください。876先に 1 分が経過した場合、セッションは停止しますが、保存された会話はディスク上に残ります。保存された会話からセッションを再開するには、[シャットダウン後にセッションが失敗または停止と表示される](#sessions-show-as-failed-after-shutdown)で説明しているとおり、そのセッションに[アタッチ](#attach-to-a-session)するか[返信](#peek-and-reply)します。

877 877 

878### 状態の保存場所878### 状態の保存場所

879 879 

880セッション状態は Claude Code 設定ディレクトリの下に保存されます。[`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ja/env-vars) を設定した場合、スーパーバイザーは `~/.claude` の代わりにそのディレクトリを使用し、独自のセッションを持つ別のインスタンスとして実行されます。880セッションの状態は Claude Code の設定ディレクトリに保存されます。[`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ja/env-vars) を設定している場合、スーパーバイザーは `~/.claude` の代わりにそのディレクトリを使用し、独自のセッションを持つ別のインスタンスとして実行されます。

881 881 

882| パス | 内容 |882| パス | 内容 |

883| :- | :- |883| :- | :- |

884| `~/.claude/daemon.log` | スーパーバイザーログ |884| `~/.claude/daemon.log` | スーパーバイザーのログ |

885| `~/.claude/daemon/roster.json` | 実行中のバックグラウンドセッションのリスト。再起動後の再接続に使用されます |885| `~/.claude/daemon/roster.json` | 実行中のバックグラウンドセッションの一覧。再起動後の再接続に使用されます |

886| `~/.claude/jobs/<id>/state.json` | エージェントビューに表示されるセッションごとの状態。ファイルを解析する代わりに、[`claude agents --json`](#read-session-state-from-a-script) を通じて読み取ってください |886| `~/.claude/jobs/<id>/state.json` | エージェントビューに表示されるセッションごとの状態。ファイルを解析する代わりに、[`claude agents --json`](#read-session-state-from-a-script) を通じて読み取ってください |

887| `~/.claude/jobs/<id>/tmp/` | セッションごとのスクラッチディレクトリ。Claude の `Write` および `Edit` 呼び出しはここで権限を求めるプロンプトを表示しません。セッションが削除されると削除されます |887| `~/.claude/jobs/<id>/tmp/` | セッションごとの作業用ディレクトリ。ここでの Claude の `Write` および `Edit` の呼び出しでは権限の確認が求められません。セッションの削除時に削除されます |

888 888 

889各バックグラウンドセッションには、`CLAUDE_JOB_DIR` 環境変数が `~/.claude/jobs/<id>` ディレクトリに設定されているため、セッションが実行するシェルコマンドは、並列セッションと衝突することなく、`$CLAUDE_JOB_DIR/tmp` に一時ファイルを書き込むことができます。889各バックグラウンドセッションには、`CLAUDE_JOB_DIR` 環境変数がその `~/.claude/jobs/<id>` ディレクトリに設定されているため、セッションが実行するシェルコマンドは、並行するセッションと衝突することなく `$CLAUDE_JOB_DIR/tmp` に一時ファイルを書き込めます。

890 890 

891ファイルを直接読み取らずにこの状態を検査するには、`claude daemon status` を実行してください。スーパーバイザーに到達可能かどうか、そのプロセス ID とバージョン、ソケットディレクトリ、およびライブバックグラウンドセッションの数を報告します。891ファイルを直接読まずにこの状態を確認するには、`claude daemon status` を実行します。スーパーバイザーに到達可能かどうか、そのプロセス ID とバージョン、ソケットディレクトリ、稼働中のバックグラウンドセッションの数が報告されます。

892 892 

893このコマンドは、実行中のスーパーバイザーが呼び出した `claude` とは異なるバージョンにある場合に警告を表示します。これは、スーパーバイザーがまだ再起動していない更新後に発生します。警告は両方のバージョンを表示し、`claude daemon stop --any` を実行して新しいバージョンを取得するよう指示します。893このコマンドは、実行中のスーパーバイザーのバージョンが呼び出した `claude` と異なる場合にも警告を表示します。これは、更新後にスーパーバイザーがまだ新しいバージョンで再起動していない場合に発生します。警告には両方のバージョンが表示され、新しいバージョンを反映するために `claude daemon stop --any` を実行するよう案内されます。

894 

895セッションはそのバージョンの不一致を無傷で生き残ります。セッションの `state.json` を更新する古い Claude Code バージョンは、認識しないフィールドを保持し、セッションをリストに保ちます。`roster.json` のセッションリストも同じルールに従うため、新しいバージョンで開始されたセッションは到達可能なままで、スーパーバイザーが再起動した後も入力を受け付け続けます。

896 894 

897### エージェントビューをオフにする895### エージェントビューをオフにする

898 896 

899バックグラウンドエージェントとエージェントビューを完全にオフにするには、`disableAgentView` [設定](https://code.claude.com/docs/ja/settings.md) を `true` に設定するか、`CLAUDE_CODE_DISABLE_AGENT_VIEW` 環境変数を設定してください。管理者は [管理設定](https://code.claude.com/docs/ja/managed-settings.md) を通じてこれを強制できます。897バックグラウンドエージェントとエージェントビューを完全にオフにするには、`disableAgentView` [設定](https://code.claude.com/docs/ja/settings.md)を `true` にするか、`CLAUDE_CODE_DISABLE_AGENT_VIEW` 環境変数を設定します。管理者は[管理設定](https://code.claude.com/docs/ja/managed-settings.md)を通じてこれを強制できます。

900 898 

901## トラブルシューティング899## トラブルシューティング

902 900 

367| `ap-*` | `apac.` |367| `ap-*` | `apac.` |

368| その他すべてのリージョン | `global.` |368| その他すべてのリージョン | `global.` |

369 369 

370`ANTHROPIC_BEDROCK_REGION_PREFIX` を設定して、Claude Code が最初に試すプレフィックスを選択します。Claude Code がプロファイルの可用性を確認でき、モデルに一致するプロファイルが見つからない場合、以下の解決順序に従ってフォールバックします。有効な値は `us`、`eu`、`apac`、`jp`、`au`、および `global` です。たとえば、アカウントに `global.` プロファイルが有効になっているが、Claude Code が AWS リージョンから地理的に固有のプロファイルを導出する場合は、`global` に設定します。Claude Code v2.1.224 以降が必要です。370`ANTHROPIC_BEDROCK_REGION_PREFIX` を設定して、Claude Code が最初に試すプレフィックスを選択します。有効な値は `us`、`eu`、`apac`、`jp`、`au`、および `global` です。たとえば、アカウントに `global.` プロファイルが有効になっているが、Claude Code が AWS リージョンから地理的に固有のプロファイルを導出する場合は、`global` に設定します。

371 371 

372この例は、デフォルトモデルを `global.` プロファイルを通じてルーティングします。372この例は、デフォルトモデルを `global.` プロファイルを通じてルーティングします。

373 373 

386 3. 一致するプロファイルがないモデルの場合、優先プレフィックスを持つ組み込みモデル ID。Claude Code はこのステップで可用性を確認せずにこの ID を適用します。[スタートアップモデルチェック](#startup-model-checks) はセッションのデフォルトモデルをカバーします。386 3. 一致するプロファイルがないモデルの場合、優先プレフィックスを持つ組み込みモデル ID。Claude Code はこのステップで可用性を確認せずにこの ID を適用します。[スタートアップモデルチェック](#startup-model-checks) はセッションのデフォルトモデルをカバーします。

387* プロファイル検出が利用できない場合、Claude Code は可用性を確認せずにプレフィックスを適用します。アカウントにそのプレフィックスを持つ推論プロファイルが有効になっていない場合、リクエストは 400 エラーで失敗します。387* プロファイル検出が利用できない場合、Claude Code は可用性を確認せずにプレフィックスを適用します。アカウントにそのプレフィックスを持つ推論プロファイルが有効になっていない場合、リクエストは 400 エラーで失敗します。

388 388 

389Claude Code は、自分で設定した Amazon Bedrock 推論プロファイル ID または ARN、または [`modelOverrides`](#map-each-model-version-to-an-inference-profile) 値を書き直しません。Anthropic 形式のモデル ID は [/model ピッカーと同じマッピング](#map-each-model-version-to-an-inference-profile) を通じて解決されます。Claude Code は 2 つのケースで変数を無視します。389Claude Code は、自分で設定した Amazon Bedrock 推論プロファイル ID または ARN、または [`modelOverrides`](#map-each-model-version-to-an-inference-profile) 値を書き直しません。Anthropic 形式のモデル ID は [`/model` ピッカーと同じマッピング](#map-each-model-version-to-an-inference-profile) を通じて解決されます。Claude Code は次の 2 つのケースでも変数を無視します。

390 390 

391* AWS GovCloud リージョンでは、Claude Code は常に `us-gov.` を使用します。これは GovCloud パーティション内でルーティングする唯一のプレフィックスです。391* AWS GovCloud リージョンでは、Claude Code は常に `us-gov.` を使用します。これは GovCloud パーティション内でルーティングする唯一のプレフィックスです。

392* 有効な値の 1 つではない値を設定した場合、Claude Code はリージョン導出の優先プレフィックスにフォールバックします。392* 有効な値の 1 つではない値を設定した場合、Claude Code はリージョン導出の優先プレフィックスにフォールバックします。

64| :- | :- |64| :- | :- |

65| セッションが [plan モード](https://code.claude.com/docs/ja/permission-modes.md#analyze-before-you-edit-with-plan-mode)になっている | 各アーティファクトの最初の公開前に確認する |65| セッションが [plan モード](https://code.claude.com/docs/ja/permission-modes.md#analyze-before-you-edit-with-plan-mode)になっている | 各アーティファクトの最初の公開前に確認する |

66| 公開が、[コネクタ呼び出し](#pull-live-data-with-mcp-connectors)や[ファイルダウンロード](#offer-a-file-download)など、ページのランタイム機能を宣言している | その公開の前に確認する |66| 公開が、[コネクタ呼び出し](#pull-live-data-with-mcp-connectors)や[ファイルダウンロード](#offer-a-file-download)など、ページのランタイム機能を宣言している | その公開の前に確認する |

67| アーティファクトを公開共有している | 変更前に会話ごとに 1 回確認する |67| アーティファクトを公開共有している | 変更前に会話ごとに 1 回確認し、アーティファクトへのコメントに返信する前にも毎回確認する |

68| 入力したプロンプトではなく、セッション内で実行された[セッションスコープのスケジュールタスク](https://code.claude.com/docs/ja/scheduled-tasks.md)によって開始されたターンで Claude が公開する | 各アーティファクトの最初の公開前に確認する |68| 入力したプロンプトではなく、セッション内で実行された[セッションスコープのスケジュールタスク](https://code.claude.com/docs/ja/scheduled-tasks.md)によって開始されたターンで Claude が公開する | 各アーティファクトの最初の公開前に確認する |

69| Claude がユーザーの承認なしではファイルを読み取れない | 公開前に確認する。`Artifact` ツールの許可ルールがあっても、このプロンプトはスキップされない |69| Claude がユーザーの承認なしではファイルを読み取れない | 公開前に確認する。`Artifact` ツールの許可ルールがあっても、このプロンプトはスキップされない |

70| [Manual](https://code.claude.com/docs/ja/permission-modes.md) モードまたは `acceptEdits` モードで、Claude がユーザーの承認なしでは編集できないアーティファクトのファイル（Manual モードでのプロジェクトファイルなど）に小さな変更を加える | 変更を公開する前に確認する。ファイルの編集にはユーザーの承認が必要なため、`Artifact` ツールが許可ルールの対象になっていても確認される |70| [Manual](https://code.claude.com/docs/ja/permission-modes.md) モードまたは `acceptEdits` モードで、Claude がユーザーの承認なしでは編集できないアーティファクトのファイル（Manual モードでのプロジェクトファイルなど）に小さな変更を加える | 変更を公開する前に確認する。ファイルの編集にはユーザーの承認が必要なため、`Artifact` ツールが許可ルールの対象になっていても確認される |

89https://claude.ai/code/artifact/5fbea6f3-... を本日の数値で更新します。89https://claude.ai/code/artifact/5fbea6f3-... を本日の数値で更新します。

90```90```

91 91 

92### ワンステップのアーティファクト更新をオフにする

93 

94ワンステップ更新とは、Claude が `Edit` や `Write` の呼び出しを介さずに、公開処理の一部としてアーティファクトのファイルに加える小さな変更です。

95 

96ワンステップ更新をオフにするには、[`CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS`](https://code.claude.com/docs/ja/env-vars) を `0` に設定します。次の例では、`~/.claude/settings.json` の `env` ブロックにこの変数を追加しています。

97 

98```json theme={null}

99{

100 "env": {

101 "CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS": "0"

102 }

103}

104```

105 

106その後、Claude Code を終了して再起動してください。実行中のセッションは変数を再読み込みしないためです。

107 

92## アーティファクトを再度見つける108## アーティファクトを再度見つける

93 109 

94Claude Code で `/artifacts` を実行すると、所有しているアーティファクトと共有されているアーティファクトが一覧表示されます。現在のセッションのアーティファクトは **This session** の下に最初に表示されます。110Claude Code で `/artifacts` を実行すると、所有しているアーティファクトと共有されているアーティファクトが一覧表示されます。現在のセッションのアーティファクトは **This session** の下に最初に表示されます。

111共有できる相手はプランによって異なります。127共有できる相手はプランによって異なります。

112 128 

113* **組織内**: Team プランと Enterprise プランでは、組織内の特定のユーザーまたは全員にアクセス権を付与できます。ビューアーは、ページを表示するために claude.ai に組織のメンバーとしてサインインします。129* **組織内**: Team プランと Enterprise プランでは、組織内の特定のユーザーまたは全員にアクセス権を付与できます。ビューアーは、ページを表示するために claude.ai に組織のメンバーとしてサインインします。

130* **共有フォルダーにアクセスできるユーザー**: Team プランと Enterprise プランでは、自分が所有しているフォルダー、または自分がエディターになっているフォルダーにアーティファクトを移動します。移動は [Artifacts ページ](https://claude.ai/artifacts) から行います。このページは claude.ai のチャットを利用できる場合に使用できます。移動後は、フォルダーにアクセスできるすべてのユーザーがアーティファクトを開けるようになり、フォルダーの所有者とエディターはアーティファクトを変更できます。

114* **公開**: インターネット上の誰でも開くことができるリンクを共有でき、claude.ai へのサインインは不要です。Team プランと Enterprise プランでは、Owner が [組織に対して公開共有を有効にする](#control-public-sharing) まで、公開共有はオフになっています。131* **公開**: インターネット上の誰でも開くことができるリンクを共有でき、claude.ai へのサインインは不要です。Team プランと Enterprise プランでは、Owner が [組織に対して公開共有を有効にする](#control-public-sharing) まで、公開共有はオフになっています。

115 132 

116### 特定のビューにリンクする133### 特定のビューにリンクする

178[権限モード](https://code.claude.com/docs/ja/permission-modes.md)によって、送信されたコメントが到着したときに Claude が何をするかが決まります。195[権限モード](https://code.claude.com/docs/ja/permission-modes.md)によって、送信されたコメントが到着したときに Claude が何をするかが決まります。

179 196 

180* **Claude が自動で返信する**：権限モードで Claude が確認を求めずに返信を投稿できる場合、Claude はスレッドを読んで返信します。`Auto-replied to comment thread on Artifact: <name>` が表示されます。197* **Claude が自動で返信する**：権限モードで Claude が確認を求めずに返信を投稿できる場合、Claude はスレッドを読んで返信します。`Auto-replied to comment thread on Artifact: <name>` が表示されます。

181* **Claude があなたを待つ**：プランモード外で、返信の投稿に承認が必要な場合、`Comments are waiting on Artifact: <name>` が表示されます。その後、Claude はスレッドを読む承認を求め、返信を投稿する承認を再度求めます。198* **Claude がユーザーを待つ**：plan モード外で、返信の投稿に[ユーザーの承認が必要な場合](#when-claude-code-asks-before-publishing)、`Comments are waiting on Artifact: <name>` が表示されます。その後、Claude はスレッドを読む承認を求め、返信を投稿する承認を再度求めます。

182* **Claude がプランモードで一時停止する**：`Comments are waiting on Artifact: <name>` が表示され、Claude はプランモードを終了して読んで返信するよう求めるまで返信しません。199* **Claude がプランモードで一時停止する**：`Comments are waiting on Artifact: <name>` が表示され、Claude はプランモードを終了して読んで返信するよう求めるまで返信しません。

183 200 

184Claude は、1 時間以内にそのアーティファクトで 60 件の送信されたコメントまたはスレッド有効化を処理した後、アーティファクトへの自動返信を停止します。`Comments are waiting on Artifact: <name>` が 1 回表示され、Claude はその時間のコメントが古くなると再開します。201Claude は、1 時間以内にそのアーティファクトで 60 件の送信されたコメントまたはスレッド有効化を処理した後、アーティファクトへの自動返信を停止します。`Comments are waiting on Artifact: <name>` が 1 回表示され、Claude はその時間のコメントが古くなると再開します。

34* **リクエスト**: チェックを通すために、ゲートウェイは `anthropic-beta` ヘッダーと `safeguards` ボディフィールドの両方を変更せずに転送します。[この 2 つはペアで送られる](https://code.claude.com/docs/ja/llm-gateway-protocol.md#beta-header-and-body-field-pairs)ためです。[Amazon Bedrock InvokeModel 形式](https://code.claude.com/docs/ja/llm-gateway-protocol.md#api-formats)では、ヘッダーの代わりに `anthropic_beta` ボディフィールドを転送します。34* **リクエスト**: チェックを通すために、ゲートウェイは `anthropic-beta` ヘッダーと `safeguards` ボディフィールドの両方を変更せずに転送します。[この 2 つはペアで送られる](https://code.claude.com/docs/ja/llm-gateway-protocol.md#beta-header-and-body-field-pairs)ためです。[Amazon Bedrock InvokeModel 形式](https://code.claude.com/docs/ja/llm-gateway-protocol.md#api-formats)では、ヘッダーの代わりに `anthropic_beta` ボディフィールドを転送します。

35* **レスポンス**: ゲートウェイは、フィールドをドロップしたり tool-use ID を書き換えたりせずに、レスポンスとストリーミングイベントを返します。チェックの結果を通すために、`safeguard_results` フィールドを保持します。35* **レスポンス**: ゲートウェイは、フィールドをドロップしたり tool-use ID を書き換えたりせずに、レスポンスとストリーミングイベントを返します。チェックの結果を通すために、`safeguard_results` フィールドを保持します。

36 36 

37このようにトラフィックを通すゲートウェイは、この機能と将来の機能で動作し続けます。その後、新しいセッションはサーバーのチェックを再度使用します。37ゲートウェイがこのように動作するようになると、新しいセッションはサーバーのチェックを再度使用します。

38 38 

39ゲートウェイがサーバーのチェックを提供できないことが既にわかっている場合、セッションを開始する前に、シェルまたは [`env` 設定キー](https://code.claude.com/docs/ja/settings-reference#env)で `CLAUDE_CODE_AUTO_MODE_SERVER` を `0` に設定して、Claude Code にそこでチェックを要求しないよう指示してください。39ゲートウェイがサーバーのチェックを提供できないことが既にわかっている場合、セッションを開始する前に、シェルまたは [`env` 設定キー](https://code.claude.com/docs/ja/settings-reference#env)で `CLAUDE_CODE_AUTO_MODE_SERVER` を `0` に設定して、Claude Code にそこでチェックを要求しないよう指示してください。

40 40 

180 180 

181Claude Code はバックグラウンドでスキャンを行い、その後草案を表示します。草案は全体として承認または破棄するため、個々のエントリを調整するには後で `~/.claude/settings.json` を編集してください。承認すると、Claude Code は草案を書き込み、既存の設定と整合させます。181Claude Code はバックグラウンドでスキャンを行い、その後草案を表示します。草案は全体として承認または破棄するため、個々のエントリを調整するには後で `~/.claude/settings.json` を編集してください。承認すると、Claude Code は草案を書き込み、既存の設定と整合させます。

182 182 

183* Claude Code は `environment` リストを `"$defaults"` なしで書き込みます。草案には、変更されなかった組み込みエントリが明記されているためです183* `~/.claude/settings.json` の `environment` リストへの追加を選んだ場合、リスト内の `"$defaults"` エントリは保持されます。そのリストの置き換えを選んだ場合はそのエントリが失われるため、デフォルトのエントリが必要な場合は `"$defaults"` を追加し直してください

184* Claude Code は、草案がエントリを追加する `allow`、`soft_deny`、`hard_deny` の各リストに `"$defaults"` を含めます（ただし、`"$defaults"` を含まない `allow` リストをすでに書いている場合を除きます）。これにより、置き換えていない[組み込みルール](#override-the-block-and-allow-rules)が引き続き有効になります184* Claude Code は、草案がエントリを追加する `allow`、`soft_deny`、`hard_deny` の各リストに `"$defaults"` を含めます（ただし、`"$defaults"` を含まない `allow` リストをすでに書いている場合を除きます）。これにより、置き換えていない[組み込みルール](#override-the-block-and-allow-rules)が引き続き有効になります

185* 保存後、Claude Code は `~/.claude/settings.json` 内の `permissions.allow` ルールのうち、`Bash(*)` のように auto モードが無視するもの、または破壊的なコマンドを自動承認するものを削除するよう提案します185* 保存後、Claude Code は `~/.claude/settings.json` 内の `permissions.allow` ルールのうち、`Bash(*)` のように auto モードが無視するもの、または破壊的なコマンドを自動承認するものを削除するよう提案します

186 186 

216 216 

2173 つの追加フィールドを使用すると、分類器の組み込みルールリストを置き換えることができます。2173 つの追加フィールドを使用すると、分類器の組み込みルールリストを置き換えることができます。

218 218 

219* `autoMode.hard_deny`：無条件のセキュリティ境界219* `autoMode.hard_deny`：ユーザーが求めた場合でもブロックするアクション

220* `autoMode.soft_deny`：ユーザーの意図でクリアできる破壊的なアクション220* `autoMode.soft_deny`：ユーザーの意図でクリアできる破壊的なアクション

221* `autoMode.allow`：ソフトブロックルールの例外221* `autoMode.allow`：ソフトブロックルールの例外

222 222 

231 231 

232一般的なリクエストは明示的な意図としてカウントされません。Claude に「リポジトリをクリーンアップする」ように依頼することは force push を認可しませんが、「このブランチを force push する」ように依頼することは認可します。232一般的なリクエストは明示的な意図としてカウントされません。Claude に「リポジトリをクリーンアップする」ように依頼することは force push を認可しませんが、「このブランチを force push する」ように依頼することは認可します。

233 233 

234緩和するには、分類器がデフォルトの例外がカバーしていないルーチンパターンを繰り返しフラグする場合、`allow` に追加します。厳しくするには、環境に固有で、デフォルトが見落としているリスクについて `soft_deny` に追加するか、絶対に越えてはいけないセキュリティ境界について `hard_deny` に追加します。234緩和するには、分類器がデフォルトの例外がカバーしていない日常的なパターンを繰り返し警告する場合、`allow` に追加します。厳しくするには、環境に固有でデフォルトが見落としている破壊的なリスクについて `soft_deny` に追加するか、ユーザーが求めた場合でもブロックするアクションについて `hard_deny` に追加します。

235 235 

236組み込みルールを保持しながら独自のルールを追加するには、配列にリテラル文字列 `"$defaults"` を含めます。デフォルトルールはその位置に挿入されるため、カスタムルールはそれらの前後に配置でき、リリース全体でビルトインリストが変更されるにつれて更新を継続して継承します。236組み込みルールを保持しながら独自のルールを追加するには、配列にリテラル文字列 `"$defaults"` を含めます。デフォルトルールはその位置に挿入されるため、カスタムルールはそれらの前後に配置でき、リリース全体でビルトインリストが変更されるにつれて更新を継続して継承します。

237 237 

252 "soft_deny": [252 "soft_deny": [

253 "$defaults",253 "$defaults",

254 "Never run database migrations outside the migrations CLI, even against dev databases",254 "Never run database migrations outside the migrations CLI, even against dev databases",

255 "Never modify files under infra/terraform/prod/: production infrastructure changes go through the review workflow"255 "Running terraform apply in infra/terraform/prod/ needs an explicit request: production infrastructure changes go through the review workflow"

256 ],256 ],

257 "hard_deny": [257 "hard_deny": [

258 "$defaults",258 "$defaults",

322 322 

323以下は、双方向サポート付きの完全な `webhook.ts` です。アウトバウンド返信は [Server-Sent Events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events)（SSE）を使用して `GET /events` でストリーミングされるため、`curl -N localhost:8788/events` はそれらをライブで見ることができます。インバウンドチャットは `POST /` に到着します：323以下は、双方向サポート付きの完全な `webhook.ts` です。アウトバウンド返信は [Server-Sent Events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events)（SSE）を使用して `GET /events` でストリーミングされるため、`curl -N localhost:8788/events` はそれらをライブで見ることができます。インバウンドチャットは `POST /` に到着します：

324 324 

325```ts title="返信ツール付きの完全な webhook.ts' expandable theme={null}325```ts title="返信ツール付きの完全な webhook.ts" expandable theme={null}

326#!/usr/bin/env bun326#!/usr/bin/env bun

327import { Server } from '@modelcontextprotocol/sdk/server/index.js'327import { Server } from '@modelcontextprotocol/sdk/server/index.js'

328import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'328import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'

763. そのアップストリーム ID にマップした [`models[].id`](https://code.claude.com/docs/ja/claude-apps-gateway-config#models) のリスト価格。Amazon Bedrock アプリケーション推論プロファイル ARN や Microsoft Foundry デプロイメント名など、モデル名を含まないアップストリーム文字列の場合です。v2.1.218 以降が必要です。763. そのアップストリーム ID にマップした [`models[].id`](https://code.claude.com/docs/ja/claude-apps-gateway-config#models) のリスト価格。Amazon Bedrock アプリケーション推論プロファイル ARN や Microsoft Foundry デプロイメント名など、モデル名を含まないアップストリーム文字列の場合です。v2.1.218 以降が必要です。

774. 不明なモデルティアの 100 万入力/出力トークンあたり $5/$25。メーターが配置できない ID は決して無料ではありません。gateway はブート時と実行時に ID ごとに 1 回、このティアを使用する場合に警告します。774. 不明なモデルティアの 100 万入力/出力トークンあたり $5/$25。メーターが配置できない ID は決して無料ではありません。gateway はブート時と実行時に ID ごとに 1 回、このティアを使用する場合に警告します。

78 78 

79どの料金が適用されても、メーターは金額に [`pricing.multiplier`](https://code.claude.com/docs/ja/claude-apps-gateway-config#pricing) を乗算します。デフォルトは `1` です。79どの料金が適用されても、メーターは金額に [`pricing.multiplier`](https://code.claude.com/docs/ja/claude-apps-gateway-config#pricing) を乗算します。デフォルトは `1` です。Claude Code v2.1.227 以降を実行しているゲートウェイサーバーが必要です。

80 80 

81クライアント中止も請求されます。アップストリームの最終使用量フレームなしでストリームが終了した場合、メーターはクライアントに既に送信されたテキストについて、出力トークンあたり約 4 文字のフロア推定値を請求します。そのため、リクエストを早期に中止しても上限を回避できません。81クライアント中止も請求されます。アップストリームの最終使用量フレームなしでストリームが終了した場合、メーターはクライアントに既に送信されたテキストについて、出力トークンあたり約 4 文字のフロア推定値を請求します。そのため、リクエストを早期に中止しても上限を回避できません。

82 82 

205* **`/teleport` を使用する**: 既存の CLI セッション内で `/teleport` または `/tp` を実行すると、Claude Code を再起動せずに同じセッション選択画面を開けます。205* **`/teleport` を使用する**: 既存の CLI セッション内で `/teleport` または `/tp` を実行すると、Claude Code を再起動せずに同じセッション選択画面を開けます。

206* **`/tasks` から**: `/tasks` を実行してバックグラウンドセッションを表示し、`t` を押してセッションに teleport します。206* **`/tasks` から**: `/tasks` を実行してバックグラウンドセッションを表示し、`t` を押してセッションに teleport します。

207* **claude.ai/code から**: セッションメニューから **Open in > Terminal** を選択すると、ターミナルに貼り付けられるコマンドがコピーされます。207* **claude.ai/code から**: セッションメニューから **Open in > Terminal** を選択すると、ターミナルに貼り付けられるコマンドがコピーされます。

208* **クラウドセッション内から**: `/teleport` と入力すると、Claude Code がそのセッション用の正確な `claude --teleport <session-id>` コマンドを返します。このコマンドはリポジトリのチェックアウトからすぐに実行できます。セッションの環境に Claude Code v2.1.223 以降が必要です。208* **クラウドセッション内から**: `/teleport` と入力すると、Claude Code がそのセッション用の正確な `claude --teleport <session-id>` コマンドを返します。このコマンドはリポジトリのチェックアウトからすぐに実行できます。

209 209 

210セッションを teleport すると、Claude は正しいリポジトリにいることを確認し、クラウドセッションのブランチをフェッチしてチェックアウトし、会話をターミナルに読み込みます。210セッションを teleport すると、Claude は正しいリポジトリにいることを確認し、クラウドセッションのブランチをフェッチしてチェックアウトし、会話をターミナルに読み込みます。

211 211 

499* **リポジトリ認証**: クラウドセッションをターミナルに取り込むことができるのは、同じアカウントで認証されている場合のみです。499* **リポジトリ認証**: クラウドセッションをターミナルに取り込むことができるのは、同じアカウントで認証されている場合のみです。

500* **プラットフォーム制限**: Anthropic ホスト環境でのリポジトリのクローンとプルリクエストの作成には GitHub が必要です。自己ホスト型の [GitHub Enterprise Server](https://code.claude.com/docs/ja/github-enterprise-server.md) インスタンスは Team および Enterprise プランでサポートされています。GitLab、Bitbucket、またはその他の非 GitHub リポジトリをクラウドセッションに [ローカルバンドル](#send-local-repositories-without-github) として送信できます。これは `CCR_FORCE_BUNDLE=1` を設定することで実現できますが、セッションはその結果をリモートにプッシュバックできません。500* **プラットフォーム制限**: Anthropic ホスト環境でのリポジトリのクローンとプルリクエストの作成には GitHub が必要です。自己ホスト型の [GitHub Enterprise Server](https://code.claude.com/docs/ja/github-enterprise-server.md) インスタンスは Team および Enterprise プランでサポートされています。GitLab、Bitbucket、またはその他の非 GitHub リポジトリをクラウドセッションに [ローカルバンドル](#send-local-repositories-without-github) として送信できます。これは `CCR_FORCE_BUNDLE=1` を設定することで実現できますが、セッションはその結果をリモートにプッシュバックできません。

501 * **自己ホスト環境**: 他の git ホスト上のリポジトリについては、[`--environment` でセッションを開始するための要件](https://code.claude.com/docs/ja/self-hosted-environments-deploy#start-a-session-on-a-repository-outside-github) を参照してください。501 * **自己ホスト環境**: 他の git ホスト上のリポジトリについては、[`--environment` でセッションを開始するための要件](https://code.claude.com/docs/ja/self-hosted-environments-deploy#start-a-session-on-a-repository-outside-github) を参照してください。

502* **組織 IP 許可リスト**: クラウドセッションは、ユーザーのネットワークではなく Anthropic 管理のインフラストラクチャから Anthropic API を呼び出します。一方、[自己ホスト環境](https://code.claude.com/docs/ja/self-hosted-environments) のセッションは自身のネットワークから呼び出します。組織で [IP 許可リスト](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting) が有効になっている場合、Anthropic ホスト型のすべてのクラウドセッションは認証エラーで失敗します。

503 * **Code Review とスケジュールタスク**: 同じことが [Code Review](https://code.claude.com/docs/ja/code-review.md) と、Anthropic ホスト環境で実行される [クラウドスケジュールタスク](https://code.claude.com/docs/ja/routines.md) にも当てはまります。自己ホスト環境にルーティングされたスケジュールタスクは、自身のネットワークから API を呼び出します。

504 * **除外の取得**: Anthropic ホスト型サービスを組織の IP 許可リストから除外するには、[Anthropic サポート](https://support.claude.com/) にお問い合わせください。

505 502 

506## 関連リソース503## 関連リソース

507 504 

142`sessions/` のセッションファイル、自動メモリ、Claude Desktop および Cowork トランスクリプトは、それぞれ独自の保持ルールに従います：142`sessions/` のセッションファイル、自動メモリ、Claude Desktop および Cowork トランスクリプトは、それぞれ独自の保持ルールに従います：

143 143 

144* **`sessions/`**：実行中の各セッションに 1 つの小さいファイルを保持します。同時実行セッションとクラッシュを検出するために使用されます。年齢ベースのスイープの一部ではありません。Claude Code は、セッションが終了するときに各ファイルを削除し、次の起動時にクラッシュの残りをクリアします。144* **`sessions/`**：実行中の各セッションに 1 つの小さいファイルを保持します。同時実行セッションとクラッシュを検出するために使用されます。年齢ベースのスイープの一部ではありません。Claude Code は、セッションが終了するときに各ファイルを削除し、次の起動時にクラッシュの残りをクリアします。

145* **`seed-admin/`**：[ultrareview](https://code.claude.com/docs/ja/ultrareview.md) または[クラウドセッションのアップロード](https://code.claude.com/docs/ja/claude-code-on-the-web.md#send-local-repositories-without-github)のためにリポジトリをパッケージ化する際に、Claude Code が作成する一時的な git ディレクトリです。アップロードが終了したとき、または中断された場合は後のセッションで、Claude Code はそのアップロードのディレクトリを削除し、`seed-admin/` 自体はそのまま残します。

145* **自動メモリ**：スイープは、プロジェクトの[自動メモリ](https://code.claude.com/docs/ja/memory.md#auto-memory)ディレクトリ `projects/<project>/memory/` 内のメモリファイルを削除しません。Claude Code は、保持期間全体が空だった場合にのみそのディレクトリを削除します。v2.1.228 より前では、スイープはメモリディレクトリ内のフォルダをセッションデータとして扱い、その下の古いファイルを削除できました。146* **自動メモリ**：スイープは、プロジェクトの[自動メモリ](https://code.claude.com/docs/ja/memory.md#auto-memory)ディレクトリ `projects/<project>/memory/` 内のメモリファイルを削除しません。Claude Code は、保持期間全体が空だった場合にのみそのディレクトリを削除します。v2.1.228 より前では、スイープはメモリディレクトリ内のフォルダをセッションデータとして扱い、その下の古いファイルを削除できました。

146* **Claude Desktop および Cowork トランスクリプト**：Claude Code は、Claude Desktop または Cowork で開始または最後に続行したセッションのトランスクリプトを任意の年齢で保持します。これらのトランスクリプトに年齢制限を与えるには、[`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/ja/settings-reference#desktopsessioncleanupperioddays) を設定します。Claude Code v2.1.248 以降が必要です。それより前のバージョンでは、`cleanupPeriodDays` の後に削除します。147* **Claude Desktop および Cowork トランスクリプト**：Claude Code は、Claude Desktop または Cowork で開始または最後に続行したセッションのトランスクリプトを任意の年齢で保持します。これらのトランスクリプトに年齢制限を与えるには、[`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/ja/settings-reference#desktopsessioncleanupperioddays) を設定します。Claude Code v2.1.248 以降が必要です。それより前のバージョンでは、`cleanupPeriodDays` の後に削除します。

147 148 

153Claude Code は、以下の場合に年齢ベースのスイープをスキップします：154Claude Code は、以下の場合に年齢ベースのスイープをスキップします：

154 155 

155* **ベアモード**：[`--bare`](https://code.claude.com/docs/ja/headless#start-faster-with-bare-mode)で `claude -p` を実行する場合、Claude Code はそのセッションでスイープを実行しません。156* **ベアモード**：[`--bare`](https://code.claude.com/docs/ja/headless#start-faster-with-bare-mode)で `claude -p` を実行する場合、Claude Code はそのセッションでスイープを実行しません。

156* **一時停止されたスイープ**：Claude Code が保持期間を安全に判定できない場合、保持クリーンアップスイープを一時停止します。[`retention_sweep` イベント](https://code.claude.com/docs/ja/monitoring-usage#retention-sweep-event)は、それを一時停止する各設定をリストします。原因が読み込みまたは解析できない設定ファイル、または `cleanupPeriodDays` または `desktopSessionCleanupPeriodDays` が明示的に設定された設定エラーの場合、Claude Code は設定エラーを修正するまで `/status` に警告も表示します。[管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)が `cleanupPeriodDays` を提供する場合、Claude Code はどちらの場合でも管理値でスイープを実行します。157* **一時停止されたスイープ**：Claude Code が保持期間を安全に判定できない場合、スイープを一時停止します。[`retention_sweep` イベント](https://code.claude.com/docs/ja/monitoring-usage#retention-sweep-event)には、スイープを一時停止させる各設定が記載されます。原因が読み込みまたは解析できない設定ファイルである場合、または `cleanupPeriodDays` や `desktopSessionCleanupPeriodDays` が設定された状態で設定エラーがある場合は、原因を修正するまで `/status` に警告が表示されます。

158 

159[管理設定](https://code.claude.com/docs/ja/managed-settings.md)が `cleanupPeriodDays` を提供している場合、優先度の低い設定ファイルにエラーがあっても、Claude Code は管理値でスイープを実行します。

157 160 

158組織内のマシンが設定した保持期間でスイープを実行していることを確認するには、[保持スイープを確認する](https://code.claude.com/docs/ja/monitoring-usage.md#check-the-retention-sweep)を参照してください。161組織内のマシンが設定した保持期間でスイープを実行していることを確認するには、[保持スイープを確認する](https://code.claude.com/docs/ja/monitoring-usage.md#check-the-retention-sweep)を参照してください。

159 162 

20 20 

21* **作業を 1 つの場所に送信する**: バグレポート、スタックトレース、またはタスクのリストが発生するたびに会話に貼り付けます。Claude は各作業のスレッドを開始するか、その領域で既に作業しているスレッドに渡し、その場で簡単な質問に答えます。21* **作業を 1 つの場所に送信する**: バグレポート、スタックトレース、またはタスクのリストが発生するたびに会話に貼り付けます。Claude は各作業のスレッドを開始するか、その領域で既に作業しているスレッドに渡し、その場で簡単な質問に答えます。

22* **コンテキストを 1 回設定する**: すべての新しいスレッドはプロジェクトの指示で開始されるため、対象ブランチなどの 1 回述べたルールがすべてのスレッドに到達します。22* **コンテキストを 1 回設定する**: すべての新しいスレッドはプロジェクトの指示で開始されるため、対象ブランチなどの 1 回述べたルールがすべてのスレッドに到達します。

23* **立ち去って完了した作業に戻る**: 1 時間後または翌朝に戻ると、**Overview** ペインに完了したスレッド、レビュー準備ができたプルリクエスト、回答を待っているスレッドが表示されます。23* **立ち去って完了した作業に戻る**: Overview ペインに、完了したスレッド、レビューの準備ができたプルリクエスト、回答を待っているスレッドが表示されます。

24 24 

25プロジェクトで実行する作業が既にわかっている場合は、[プロジェクトを作成する](#create-a-project) に直接進んでください。25プロジェクトで実行する作業が既にわかっている場合は、[プロジェクトを作成する](#create-a-project) に直接進んでください。

26 26 

28 28 

29プロジェクトは、作業に 1 つのセッションを超えて続く目標があり、タスクを生成し続ける場合に作成する価値があります。これらの種類の作業はプロジェクトに適しています。29プロジェクトは、作業に 1 つのセッションを超えて続く目標があり、タスクを生成し続ける場合に作成する価値があります。これらの種類の作業はプロジェクトに適しています。

30 30 

31* **多くのリポジトリにまたがる 1 つの目標**: 「すべてのサービスを新しい lint 設定に対応させる」。Claude はリポジトリごとに 1 つのスレッドを実行でき、各スレッドは独自のプルリクエストを持ち、[**Overview** ペイン](#see-what-needs-you-in-overview) にはどのスレッドがレビュー準備ができているかが表示されます。31* **多くのリポジトリにまたがる 1 つの目標**: 「すべてのサービスを新しい lint 設定に対応させる」。Claude はリポジトリごとに 1 つのスレッドを実行でき、各スレッドは独自のプルリクエストを持ち、[Overview ペイン](#see-what-needs-you-in-overview) にはどのスレッドがレビュー準備ができているかが表示されます。

32* **継続的に供給する領域**: 1 つのサービスのバグ、スタックトレース、レビューリクエストが到達するたびに会話に貼り付けられます。1 つの修正後に Claude に覚えておくよう指示した落とし穴は、次のために [プロジェクトメモリ](#give-a-project-standing-context) に含まれます。32* **継続的に供給する領域**: 1 つのサービスのバグ、スタックトレース、レビューリクエストが到達するたびに会話に貼り付けられます。1 つの修正後に Claude に覚えておくよう指示した落とし穴は、次のために [プロジェクトメモリ](#give-a-project-standing-context) に含まれます。

33* **セッションより大きいビルドまたはマイグレーション**: 「`docs/spec.md` が説明していることをビルドする」または「アプリを非推奨の ORM から移動する」。作業は各部分を取得するスレッドに分割され、Claude に早期に覚えておくよう求めた決定は後のスレッドに到達し、ビルド中に見つかった仕様の変更とバグが同じ会話に入ります。33* **セッションより大きいビルドまたはマイグレーション**: 「`docs/spec.md` が説明していることをビルドする」または「アプリを非推奨の ORM から移動する」。作業は各部分を取得するスレッドに分割され、Claude に早期に覚えておくよう求めた決定は後のスレッドに到達し、ビルド中に見つかった仕様の変更とバグが同じ会話に入ります。

34* **コードではない作業**: 「これらのチケットで最も一般的な 10 の統合ミスを見つける」など、新しい質問で何度も戻ってくる契約フォルダまたはサポートチケットエクスポート。リポジトリを追加する代わりにドキュメントをアップロードし、スレッドはプロジェクトの [**Library** タブ](#see-what-needs-you-in-overview) にファイルとして各レポートを配信します。34* **コードではない作業**: 「これらのチケットで最も一般的な 10 の統合ミスを見つける」など、新しい質問で何度も戻ってくる契約フォルダまたはサポートチケットエクスポート。リポジトリを追加する代わりにドキュメントをアップロードし、スレッドはプロジェクトの [**Library**](#see-what-needs-you-in-overview) にファイルとして各レポートを配信します。

35 35 

36これらのいずれの場合も、タスクのバッチを送信し、確認を求めずに開始するよう Claude に指示して、その場を離れることができます。戻ったときには、対応が必要なスレッドを [**Waiting on you**](#see-what-needs-you-in-overview) の下で見つけられます。また、作業の一部を [クラウドスケジュールタスク](https://code.claude.com/docs/ja/routines.md) としてスケジュールに入れるよう Claude に求めることもできます。これらのいずれかが状況に当てはまる場合は、[プロジェクトを作成してください](#create-a-project)。36これらのいずれの場合も、タスクのバッチを送信し、確認を求めずに開始するよう Claude に指示して、その場を離れることができます。戻ったときには、対応が必要なスレッドを [**Waiting on you**](#see-what-needs-you-in-overview) の下で見つけられます。また、作業の一部を [クラウドスケジュールタスク](https://code.claude.com/docs/ja/routines.md) としてスケジュールに入れるよう Claude に求めることもできます。これらのいずれかが状況に当てはまる場合は、[プロジェクトを作成してください](#create-a-project)。

37 37 

57 * [プロジェクトの各リポジトリ](#what-threads-pick-up-from-your-repositories) にある `CLAUDE.md`。ただし、リポジトリのスキル、`.claude/settings.json`、`.mcp.json` は含まれません57 * [プロジェクトの各リポジトリ](#what-threads-pick-up-from-your-repositories) にある `CLAUDE.md`。ただし、リポジトリのスキル、`.claude/settings.json`、`.mcp.json` は含まれません

58 * claude.ai アカウントの [コネクタ](#get-skills-plugins-connectors-and-tools-into-threads)58 * claude.ai アカウントの [コネクタ](#get-skills-plugins-connectors-and-tools-into-threads)

59 * ネットワークアクセス、環境変数、ネットワークシークレット、インストール済みツールを設定する [クラウド環境](#choose-an-environment-for-threads)59 * ネットワークアクセス、環境変数、ネットワークシークレット、インストール済みツールを設定する [クラウド環境](#choose-an-environment-for-threads)

60* **Overview ペイン**: [すべてのスレッドを一度に確認](#see-what-needs-you-in-overview) でき、どのスレッドが必要かを確認できる場所。その他のタブは、追加したファイルとスレッドが生成したファイルの **Library**、スレッドが開いたプルリクエストの **Pull requests**、プロジェクト内のスケジュールされた作業の **Scheduled tasks** です。60* **Overview ペイン**: [すべてのスレッドを一度に確認](#see-what-needs-you-in-overview) でき、どのスレッドがユーザーの対応を必要としているかを確認できる場所。

61 61 

62クラウドスレッドは、独自のマシンの Claude Code セットアップから何も取得しません。[スキル、プラグイン、コネクタ、ツールをスレッドに取得する](#get-skills-plugins-connectors-and-tools-into-threads) は、それらが不足しているものを提供する方法をカバーしています。62クラウドスレッドは、独自のマシンの Claude Code セットアップから何も取得しません。[スキル、プラグイン、コネクタ、ツールをスレッドに取得する](#get-skills-plugins-connectors-and-tools-into-threads) は、それらが不足しているものを提供する方法をカバーしています。

63 63 

64これは、会話を通じてスレッドが作業を行う方法と、**Overview** がその状態を追跡する方法です。64以下は、ユーザーから会話を経て作業を行うスレッドに至るまで、これらの部分がどのようにつながり、Overview がその状態をどのように追跡するかを示したものです。

65 65 

66![プロジェクトの図。プロジェクト会話に書き込み、Claude が回答するか、スレッドを開始します。各クラウドスレッドは独自のブランチとプルリクエストで作業します。Overview ペインはスレッドを状態別にリストします。例えば、レビュー準備完了、あなたを待機中、作業中など。](https://mintcdn.com/claude-code/e8CLbxM17eD7cAiv/images/claude-projects-overview.svg?fit=max\&auto=format\&n=e8CLbxM17eD7cAiv\&q=85\&s=dbf446f69f0bbdb9961d21af207cb93b)66![プロジェクトの図。プロジェクト会話に書き込み、Claude が回答するか、スレッドを開始します。各クラウドスレッドは独自のブランチとプルリクエストで作業します。Overview ペインはスレッドを状態別にリストします。例えば、レビュー準備完了、あなたを待機中、作業中など。](https://mintcdn.com/claude-code/e8CLbxM17eD7cAiv/images/claude-projects-overview.svg?fit=max\&auto=format\&n=e8CLbxM17eD7cAiv\&q=85\&s=dbf446f69f0bbdb9961d21af207cb93b)

67 67 

96 96 

97* **Name**：**Projects** リストでプロジェクトがどのように表示されるか。97* **Name**：**Projects** リストでプロジェクトがどのように表示されるか。

98* **What do you want to work on?**（オプション）：プロジェクトのゴールになる 1 行の説明。「p95 API レイテンシを 200 ms 以下に保つ」など。会話内の Claude はそれに向かって作業します。ゴールがない場合、Claude は送信したタスクから作業し、後で **Project settings > General** でゴールを追加できます。98* **What do you want to work on?**（オプション）：プロジェクトのゴールになる 1 行の説明。「p95 API レイテンシを 200 ms 以下に保つ」など。会話内の Claude はそれに向かって作業します。ゴールがない場合、Claude は送信したタスクから作業し、後で **Project settings > General** でゴールを追加できます。

99* **Context**（オプション）：このプロジェクトが作業する GitHub リポジトリ、およびスレッドが読むべきファイル、フォルダ、または Google Drive フォルダ。各項目に対して **Add** をクリックします。作業が触れる可能性のあるすべてのリポジトリではなく、ほとんどのタスクが必要とするリポジトリを追加します。[追加するリポジトリを決定する](#decide-which-repositories-to-add)で選択について説明しており、後で **Project settings > Environment** でさらに追加できます。99* **Context**（オプション）：このプロジェクトが作業する GitHub リポジトリ、およびスレッドが読むべきファイル、フォルダ、または Google Drive フォルダ。各項目に対して **+** をクリックします。作業が触れる可能性のあるすべてのリポジトリではなく、ほとんどのタスクが必要とするリポジトリを追加します。[追加するリポジトリを決定する](#decide-which-repositories-to-add)で選択について説明しており、後で **Project settings > Environment** でさらに追加できます。

100 100 

101スレッドがどのように機能すべきかについての常設ルールは [プロジェクト指示](#give-a-project-standing-context)に記載されており、プロジェクトが存在した後に設定します。101スレッドがどのように機能すべきかについての常設ルールは [プロジェクト指示](#give-a-project-standing-context)に記載されており、プロジェクトが存在した後に設定します。

102 102 

109* プロジェクトが読み取り可能なリポジトリを持っている場合、何も変更せずにリポジトリを探索し、次のステップを提案する 1 つのスレッドを開始します。109* プロジェクトが読み取り可能なリポジトリを持っている場合、何も変更せずにリポジトリを探索し、次のステップを提案する 1 つのスレッドを開始します。

110* 最近のクラウドセッションから取得した **Setup recommendations** を投稿します。追加するリポジトリ、作成するスケジュールタスク、開始できるスレッド。推奨されるすべてのリポジトリとスケジュールタスクはデフォルトでオンになっています。不要なものはオフに切り替えてから **Update setup** をクリックして残りを追加するか、推奨事項を無視して自分で作業を説明します。110* 最近のクラウドセッションから取得した **Setup recommendations** を投稿します。追加するリポジトリ、作成するスケジュールタスク、開始できるスレッド。推奨されるすべてのリポジトリとスケジュールタスクはデフォルトでオンになっています。不要なものはオフに切り替えてから **Update setup** をクリックして残りを追加するか、推奨事項を無視して自分で作業を説明します。

111 111 

112プロジェクトはサイドバーの **Projects** の下にリストされ、その会話が開いています。[最初のバッチ](#your-first-batch)では、作業を送信する前に何をセットアップするかについて説明しています。112プロジェクトがサイドバーに表示され、その会話が開いています。[最初のバッチ](#your-first-batch)では、作業を送信する前に何をセットアップするかについて説明しています。

113 113 

114### 既存のセッションから開始する114### 既存のセッションから開始する

115 115 

168 168 

169Claude がメッセージを希望と異なる方法でルーティングした場合は、そう言ってください。[Claude がプロジェクトを実行する方法を調整する](#tune-how-claude-runs-a-project)は、既存のスレッドをフォローアップに再利用するか、代わりにその場で回答するなど、Claude に伝えることができることをリストしています。169Claude がメッセージを希望と異なる方法でルーティングした場合は、そう言ってください。[Claude がプロジェクトを実行する方法を調整する](#tune-how-claude-runs-a-project)は、既存のスレッドをフォローアップに再利用するか、代わりにその場で回答するなど、Claude に伝えることができることをリストしています。

170 170 

171スレッドの完全な結果はスレッドに留まり、会話でそのカードを開いて読みます。スレッドが生成したファイルは、**概要**の**ライブラリ**タブにもあります。171スレッドの完全な結果はスレッドに留まり、会話でそのカードを開いて読みます。スレッドが生成したファイルは、プロジェクトの[**ライブラリ**](#see-what-needs-you-in-overview)にもあります。

172 172 

173時々 Claude はスレッドを開始する代わりに提案し、**提案されたスレッド**リストに表示されます。提案の矢印をクリックしてそのスレッドを開始します。複数がリストされている場合、リストの下のボタンはすべてを開始します。173時々 Claude はスレッドを開始する代わりに提案し、**提案されたスレッド**リストに表示されます。提案の矢印をクリックしてそのスレッドを開始します。複数がリストされている場合、リストの下のボタンはすべてを開始します。

174 174 

190 190 

191### 概要で必要なものを確認する191### 概要で必要なものを確認する

192 192 

193会話の横の**概要**ペインは、プロジェクトのスレッドを追跡します。新しいプロジェクトを初めて開いたときは既に開いています。プロジェクトヘッダーの**概要**ボタンはそれを閉じて再度開き、スレッドがあなたを待っているときにドットを表示します。193会話の横の概要ペインは、プロジェクトのスレッドを追跡します。新しいプロジェクトを初めて開いたときは既に開いています。閉じた後に再度開くには、プロジェクトヘッダーの**スレッド**ボタンをクリックします。スレッドが対応を待っているときは、このボタンにドットが表示されます。

194 194 

195デスクトップアプリでは、Claude が会話に投稿したとき、スレッドがエラーに達したとき、またはスレッドがあなたの入力を必要とするときにデスクトップ通知も取得します。プロジェクトを開いたままにしておく必要はありません。スレッドが各ターンを完了するたびに 1 つ取得するか、プロジェクトの通知をオフにするには、プロジェクトのサイドバーメニューで**通知**を選択します。これらの通知はデスクトップのみです。ブラウザでは、**概要**ボタンのドットを確認してください。195デスクトップアプリでは、Claude が会話に投稿したとき、スレッドがエラーに達したとき、またはスレッドが入力を必要とするときに、デフォルトで通知が表示されます。プロジェクトを表示している間は通知は表示されません。スレッドがターンを完了するたびにも通知を受け取るには、またはプロジェクトの通知をオフにするには、プロジェクトのサイドバーメニューで**通知**を選択します。ブラウザでは、**スレッド**ボタンのドットを確認してください。

196 196 

197ペインの**スレッド**タブはスレッドを状態でグループ化します。197ペインの**スレッド**ビューはスレッドを状態でグループ化します。

198 198 

199| グループ | 含まれるもの |199| グループ | 含まれるもの |

200| :- | :- |200| :- | :- |

205| **アイドル** | 完了し、何も待っていないスレッド |205| **アイドル** | 完了し、何も待っていないスレッド |

206| **解決済み** | 完了としてマークされたスレッド。スレッドのメニューからあなたが、プルリクエストのマージなど最後のステップを実行した後に Claude が、または活動がない 1 週間後に自動的に。同じメニューから 1 つを再度開くことができます |206| **解決済み** | 完了としてマークされたスレッド。スレッドのメニューからあなたが、プルリクエストのマージなど最後のステップを実行した後に Claude が、または活動がない 1 週間後に自動的に。同じメニューから 1 つを再度開くことができます |

207 207 

208ペインの他のタブは次のとおりです。208プロジェクトヘッダーから、プロジェクトのファイルとスケジュールタスクをペインで開きます。

209 209 

210* **ライブラリ**：追加したファイルとフォルダ、およびスレッドが生成したファイル210* **ライブラリ**：追加したファイルとフォルダ、およびスレッドが生成したファイル。**スレッド**の横の**ライブラリ**ボタンをクリックします。

211* **プルリクエスト**：スレッドがプルリクエストを開くと表示されます211* **スケジュールタスク**：このプロジェクトから Claude が設定した[クラウドスケジュールタスク](https://code.claude.com/docs/ja/routines.md)。ヘッダーの **⋯** メニューで選択します。

212* **スケジュールタスク**：このプロジェクトから Claude が設定した[クラウドスケジュールタスク](https://code.claude.com/docs/ja/routines.md)

213 212 

214### コントロールが必要なときにスレッドを開く213### コントロールが必要なときにスレッドを開く

215 214 

216会話でスレッドのカードをクリックするか、**概要**でその行をクリックして、概要ペインでそのトランスクリプトを開きます。そこから以下を実行できます。215会話でスレッドのカードをクリックするか、概要でその行をクリックして、概要ペインでそのトランスクリプトを開きます。そこから以下を実行できます。

217 216 

218* Claude が何をしたかをステップバイステップで読みます。217* Claude が何をしたかをステップバイステップで読みます。

219* スレッド独自のメッセージボックスに書き込んでタスクを操舵します。そこのメッセージはそのスレッドに直接送られ、プロジェクト会話でのフォローアップは Claude がフォローアップをそのスレッドと一致させるときにのみそれに到達します。218* スレッド独自のメッセージボックスに書き込んでタスクを操舵します。そこのメッセージはそのスレッドに直接送られ、プロジェクト会話でのフォローアップは Claude がフォローアップをそのスレッドと一致させるときにのみそれに到達します。

290| :- | :- | :- |289| :- | :- | :- |

291| プロジェクトメモリ | Claude がプロジェクトについて保持するメモ（要件、決定、落とし穴など）をファイルとして保存します。すべてのクラウドスレッドは開始時にインデックスファイル `MEMORY.md` を読み込み、必要に応じて他のファイルを開きます | プロジェクト会話またはクラウドスレッド内で Claude に要件、決定、落とし穴を記憶するよう依頼するか、忘れるよう依頼します。**プロジェクト設定 > メモリ** でファイルを読み込み、編集、削除します |290| プロジェクトメモリ | Claude がプロジェクトについて保持するメモ（要件、決定、落とし穴など）をファイルとして保存します。すべてのクラウドスレッドは開始時にインデックスファイル `MEMORY.md` を読み込み、必要に応じて他のファイルを開きます | プロジェクト会話またはクラウドスレッド内で Claude に要件、決定、落とし穴を記憶するよう依頼するか、忘れるよう依頼します。**プロジェクト設定 > メモリ** でファイルを読み込み、編集、削除します |

292| プロジェクト指示 | 各新しいスレッドおよびプロジェクト会話内の Claude に送信されるテキスト（最大 16,000 文字）。[プロジェクト指示を書く](#write-project-instructions) に記載内容を説明しています | **プロジェクト設定 > メモリ > プロジェクト指示**、または会話内で Claude に指示の変更を依頼します |291| プロジェクト指示 | 各新しいスレッドおよびプロジェクト会話内の Claude に送信されるテキスト（最大 16,000 文字）。[プロジェクト指示を書く](#write-project-instructions) に記載内容を説明しています | **プロジェクト設定 > メモリ > プロジェクト指示**、または会話内で Claude に指示の変更を依頼します |

293| リポジトリ、ファイル、環境 | すべてのクラウドスレッドがクローンするリポジトリ、すべてのクラウドスレッドが `/mnt/project-files` の下で読み取ることができるフォルダとファイル、およびクラウドスレッドが実行されるクラウド環境 | **プロジェクト設定 > 環境** のリポジトリと環境、または会話内で Claude にリポジトリをプロジェクトに追加するよう依頼します。[ファイルとフォルダを追加](#add-files-and-folders) から **概要** の **ライブラリ** タブの **追加** を使用します |292| リポジトリ、ファイル、環境 | すべてのクラウドスレッドがクローンするリポジトリ、すべてのクラウドスレッドが `/mnt/project-files` の下で読み取ることができるフォルダとファイル、およびクラウドスレッドが実行されるクラウド環境 | リポジトリと環境は **プロジェクト設定 > 環境** で設定するか、会話内で Claude にリポジトリをプロジェクトに追加するよう依頼します。[ファイルとフォルダ](#add-files-and-folders) はプロジェクトの [**ライブラリ**](#see-what-needs-you-in-overview) の **追加** から追加します |

294 293 

295**プロジェクト設定 > メモリ** は、これらのファイルを **自動メモリ** の下にリストしています。これは Claude がプロジェクト内で作業する際に自分で書き込むためです。これらは、Claude Code があなたのマシンで保持する [自動メモリ](https://code.claude.com/docs/ja/memory.md) とは別です。両方とも `MEMORY.md` インデックスを使用していますが、プロジェクトメモリはプロジェクトのリポジトリ内の `CLAUDE.md` ファイルとは別です。各クラウドスレッドは開始時にクローンからこれらの `CLAUDE.md` ファイルを読み込むため、リポジトリに関する指示をその `CLAUDE.md` に、プロジェクトに関するメモをプロジェクトメモリに記載してください。294**プロジェクト設定 > メモリ** は、これらのファイルを **自動メモリ** の下にリストしています。これは Claude がプロジェクト内で作業する際に自分で書き込むためです。これらは、Claude Code があなたのマシンで保持する [自動メモリ](https://code.claude.com/docs/ja/memory.md) とは別です。両方とも `MEMORY.md` インデックスを使用していますが、プロジェクトメモリはプロジェクトのリポジトリ内の `CLAUDE.md` ファイルとは別です。各クラウドスレッドは開始時にクローンからこれらの `CLAUDE.md` ファイルを読み込むため、リポジトリに関する指示をその `CLAUDE.md` に、プロジェクトに関するメモをプロジェクトメモリに記載してください。

296 295 

297### プロジェクト指示を書く296### プロジェクト指示を書く

298 297 

299プロジェクト指示は、各新しいスレッドが開始する際の指示書です。プロジェクトヘッダーのギアアイコンをクリックして **プロジェクト設定** を開き、**メモリ > プロジェクト指示** に移動します。有用な指示書には以下が含まれます：298プロジェクト指示は、各新しいスレッドが開始する際の指示書です。プロジェクトヘッダーの **⋯** メニューで **設定** を選択して **プロジェクト設定** を開き、**メモリ > プロジェクト指示** に移動します。有用な指示書には以下が含まれます：

300 299 

301* プロジェクトの目的300* プロジェクトの目的

302* 作業が行われる場所：どのリポジトリ、どのブランチから開始するか、プルリクエストの命名方法301* 作業が行われる場所：どのリポジトリ、どのブランチから開始するか、プルリクエストの命名方法

324* **プロジェクトに追加します**。**新規プロジェクト** ダイアログ、**プロジェクト設定 > 環境**、または会話内で Claude にプロジェクトへの追加を依頼します。その後のすべてのクラウドスレッドは、タスクがそれに触れるかどうかに関わらず、それをクローンし、`CLAUDE.md` を読み込んだ状態で開始します。323* **プロジェクトに追加します**。**新規プロジェクト** ダイアログ、**プロジェクト設定 > 環境**、または会話内で Claude にプロジェクトへの追加を依頼します。その後のすべてのクラウドスレッドは、タスクがそれに触れるかどうかに関わらず、それをクローンし、`CLAUDE.md` を読み込んだ状態で開始します。

325* **プロジェクトには追加せず、必要な場合にスレッドに追加させます。** タスクがプロジェクトにないリポジトリを必要とするクラウドスレッドは、自分自身にそれを追加でき、スレッド内のメモはそれがこのスレッドのみに追加されたことを示します。クローンはタスクの途中で行われるため、スレッド開始時にはそのリポジトリの `CLAUDE.md` は存在しませんでした。次のスレッドはそれなしで開始します。この方法で追加するリポジトリには、プロジェクトリポジトリと同じ [前提条件](#check-the-prerequisites) が必要です：リポジトリに Claude GitHub App がインストールされていることと、GitHub アカウントからのプッシュアクセスです。324* **プロジェクトには追加せず、必要な場合にスレッドに追加させます。** タスクがプロジェクトにないリポジトリを必要とするクラウドスレッドは、自分自身にそれを追加でき、スレッド内のメモはそれがこのスレッドのみに追加されたことを示します。クローンはタスクの途中で行われるため、スレッド開始時にはそのリポジトリの `CLAUDE.md` は存在しませんでした。次のスレッドはそれなしで開始します。この方法で追加するリポジトリには、プロジェクトリポジトリと同じ [前提条件](#check-the-prerequisites) が必要です：リポジトリに Claude GitHub App がインストールされていることと、GitHub アカウントからのプッシュアクセスです。

326 325 

327プロジェクトはリポジトリをまったく必要としません。そのクラウドスレッドは、研究、ドキュメント作成、独自のサンドボックスでのコード作成と実行を行うことができ、**ライブラリ** タブにファイルを配信します。そこのクラウドスレッドは、タスクが必要な場合、自分自身にリポジトリを追加することもできます。326プロジェクトはリポジトリをまったく必要としません。そのクラウドスレッドは、引き続き調査、ドキュメント作成、独自のサンドボックスでのコード作成と実行を行うことができます。ファイルはプロジェクトの **ライブラリ** に配信されます。そのクラウドスレッドはいずれも、タスクで必要な場合、引き続き自分自身にリポジトリを追加できます。

328 327 

329プロジェクトにリポジトリがある場合、Claude はプロジェクトが既に使用している GitHub オーナーからのみリポジトリを追加できます。プロジェクトに追加するか、スレッドが自分自身に追加するかに関わらず同じです。別のオーナーからリポジトリを持ってくるには、**プロジェクト設定 > 環境** で自分でプロジェクトに追加してください。328プロジェクトにリポジトリがある場合、Claude はプロジェクトが既に使用している GitHub オーナーからのみリポジトリを追加できます。プロジェクトに追加するか、スレッドが自分自身に追加するかに関わらず同じです。別のオーナーからリポジトリを持ってくるには、**プロジェクト設定 > 環境** で自分でプロジェクトに追加してください。

330 329 

332 331 

333### ファイルとフォルダを追加する332### ファイルとフォルダを追加する

334 333 

335**新規プロジェクト** ダイアログの **コンテキスト** フィールド、または後で **概要** の **ライブラリ** タブの **追加** を使用して、スレッドに読み込ませたいファイルとフォルダを追加します。追加するものに適用される制限は以下の通りです：334**新規プロジェクト** ダイアログの **コンテキスト** フィールド、または後でプロジェクトの [**ライブラリ**](#see-what-needs-you-in-overview) の **追加** を使用して、スレッドに読み込ませたいファイルとフォルダを追加します。追加するものに適用される制限は以下の通りです：

336 335 

337* **ライブラリタブ**：1 回の選択で最大 100 ファイル、2 GB、単一ファイルは最大 480 MB。336* **claude.ai/code またはデスクトップアプリでアップロードするファイル**：1 回あたり最大 1,000 ファイル、2 GB、単一ファイルは最大 480 MB。

338* **新規プロジェクトダイアログ**：30 MB を超えるファイルはスキップされるため、プロジェクト作成後に **ライブラリ** タブから大きなファイルを追加してください。337* **アップロードするフォルダ**：隠しファイルと `node_modules` は追加されません。プロジェクトはフォルダと Google Drive フォルダを合わせて最大 10 個まで保持でき、単一ファイルはこの制限にカウントされません。

339* **フォルダ**：どちらの場所からフォルダを追加する場合でも、プロジェクトは最初の 100 ファイルまで 200 MB までのコピーを受け取ります。30 MB を超えるファイル、隠しファイル、`node_modules` は含まれません。プロジェクトは最大 10 個のフォルダと Google Drive フォルダを保持でき、単一ファイルはこの制限にカウントされません。

340* **アップロード後の変更**：アップロードはコピーであるため、その後コンピュータで行った変更は、ファイルを再度アップロードして既存の名前について **置換** を選択するまで、プロジェクトに到達しません。338* **アップロード後の変更**：アップロードはコピーであるため、その後コンピュータで行った変更は、ファイルを再度アップロードして既存の名前について **置換** を選択するまで、プロジェクトに到達しません。

341 339 

342### スレッドがリポジトリから取得するもの340### スレッドがリポジトリから取得するもの

373 371 

374## プロジェクト設定リファレンス372## プロジェクト設定リファレンス

375 373 

376プロジェクト設定は `settings.json` ではなく claude.ai/code またはデスクトップアプリで変更します。プロジェクトのサイドバーメニューの **Settings** からまたはプロジェクトヘッダーのギアアイコンから **Project settings** を開きます。374プロジェクト設定は `settings.json` ではなく claude.ai/code またはデスクトップアプリで変更します。プロジェクトのサイドバーメニューの **Settings** から、またはプロジェクトヘッダーの **⋯** メニューから **Project settings** を開きます。

377 375 

378設定は変更時に保存されます。目標や指示などの編集中のテキストフィールドには、そのフィールドを離れるまで **Save changes** と **Discard** が表示されます。**Project settings** の指示、リポジトリ、プラグイン、環境への変更は、既に実行中のスレッドではなく、新しいスレッドに到達します。376設定は変更時に保存されます。目標や指示などの編集中のテキストフィールドには、そのフィールドを離れるまで **Save changes** と **Discard** が表示されます。**Project settings** の指示、リポジトリ、プラグイン、環境への変更は、既に実行中のスレッドではなく、新しいスレッドに到達します。

379 377 

434 432 

435 プロジェクトは Pro、Max、Ultra で利用できます。プロジェクトは自分だけのものです。作業を送信したり、スレッドを見たりするのは自分だけで、自分の GitHub アクセスとコネクタを使用します。[Claude Tag が Cowork および Claude Code とどのように異なるか](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code)に並べて比較があります。433 プロジェクトは Pro、Max、Ultra で利用できます。プロジェクトは自分だけのものです。作業を送信したり、スレッドを見たりするのは自分だけで、自分の GitHub アクセスとコネクタを使用します。[Claude Tag が Cowork および Claude Code とどのように異なるか](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code)に並べて比較があります。

436* **クラウドセッション**: すべてのスレッドは[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)です。ただし、Claude にマシン上で実行するよう要求する場合を除きます。どちらの場合でも、Claude がユーザーに代わってそれを開始して追跡します。自分で開始したクラウドセッションの作業をプロジェクトに取り込むこともできます。そのセッションのサイドバーメニューで [**Continue in project**](#start-from-an-existing-cloud-session) を選択します。434* **クラウドセッション**: すべてのスレッドは[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)です。ただし、Claude にマシン上で実行するよう要求する場合を除きます。どちらの場合でも、Claude がユーザーに代わってそれを開始して追跡します。自分で開始したクラウドセッションの作業をプロジェクトに取り込むこともできます。そのセッションのサイドバーメニューで [**Continue in project**](#start-from-an-existing-cloud-session) を選択します。

437* **スケジュールタスク**: プロジェクトでスケジュールされた作業を要求すると、Claude はそのプロジェクト内のスレッドとして実行され、その **Scheduled tasks** タブに表示される[クラウドスケジュールタスク](https://code.claude.com/docs/ja/routines.md)を作成します。プロジェクト外で作成したスケジュールタスクは独立して動作し続けます。435* **スケジュールタスク**: プロジェクトでスケジュールされた作業を要求すると、Claude はそのプロジェクト内のスレッドとして実行され、その **Scheduled tasks** ビューに表示される[クラウドスケジュールタスク](https://code.claude.com/docs/ja/routines.md)を作成します。プロジェクト外で作成したスケジュールタスクは独立して動作し続けます。

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

439* **ローカルセッションと agent view**: ターミナル、IDE、またはデスクトップアプリのローカル環境で自分で開始したセッションはプロジェクトの外に留まりますが、[その作業をプロジェクトに取り込む](#start-from-an-existing-cloud-session)ことはできます。[Agent view](https://code.claude.com/docs/ja/agent-view.md) は複数のローカルセッションを並べて追跡するための画面であり、各セッションの開始とタスクの割り当ては引き続き自分で行います。437* **ローカルセッションと agent view**: ターミナル、IDE、またはデスクトップアプリのローカル環境で自分で開始したセッションはプロジェクトの外に留まりますが、[その作業をプロジェクトに取り込む](#start-from-an-existing-cloud-session)ことはできます。[Agent view](https://code.claude.com/docs/ja/agent-view.md) は複数のローカルセッションを並べて追跡するための画面であり、各セッションの開始とタスクの割り当ては引き続き自分で行います。

440* **worktree**: [worktree](https://code.claude.com/docs/ja/worktrees.md) は各ローカルセッションにリポジトリの独自の作業コピーを提供します。クラウドスレッドはそれらを必要としません。各スレッドはリポジトリを独自のクラウドサンドボックスにクローンし、独自のブランチで作業します。438* **worktree**: [worktree](https://code.claude.com/docs/ja/worktrees.md) は各ローカルセッションにリポジトリの独自の作業コピーを提供します。クラウドスレッドはそれらを必要としません。各スレッドはリポジトリを独自のクラウドサンドボックスにクローンし、独自のブランチで作業します。

466複数のスレッドが間違った仮定をしたり、アクセスの欠落を回避したり、「ブロック」で停止して戻ってきた場合、原因は通常、各タスクの問題ではなく、プロジェクトのセットアップの同じギャップです。何かを修正する前に、どのスレッドが正常であるかを確認してください。464複数のスレッドが間違った仮定をしたり、アクセスの欠落を回避したり、「ブロック」で停止して戻ってきた場合、原因は通常、各タスクの問題ではなく、プロジェクトのセットアップの同じギャップです。何かを修正する前に、どのスレッドが正常であるかを確認してください。

467 465 

4681. 会話で Claude に「すべてのオープン スレッドについて、それを何をするよう求めたか、何を仮定したか、または到達できなかったか、そして何を待機しているかをリストアップしてください」と尋ねます。Claude は各スレッドを読み、会話で応答します。4661. 会話で Claude に「すべてのオープン スレッドについて、それを何をするよう求めたか、何を仮定したか、または到達できなかったか、そして何を待機しているかをリストアップしてください」と尋ねます。Claude は各スレッドを読み、会話で応答します。

4692. 間違った仮定から開始したスレッドについては、**概要**からスレッドを開き、そのメニューから解決済みとしてマークするか、メッセージ ボックスで代わりに何をするかを指示します。そのブランチと任意のプル リクエストは、削除するまで GitHub に残ります。4672. 間違った仮定から開始したスレッドについては、概要からスレッドを開き、そのメニューから解決済みとしてマークするか、代わりに何をするかを指示します。そのブランチと任意のプルリクエストは、削除するまで GitHub に残ります。

4703. [プロジェクト指示](#give-a-project-standing-context)または[環境](#choose-an-environment-for-threads)でギャップを 1 回修正してから、残りの作業を新しいスレッドとして再度送信する前に、1 つのスレッドを送信します。4683. [プロジェクト指示](#give-a-project-standing-context)または[環境](#choose-an-environment-for-threads)でギャップを 1 回修正してから、残りの作業を新しいスレッドとして再度送信する前に、1 つのスレッドを送信します。

471 469 

472### Claude が応答していない470### Claude が応答していない

71 71 

72**2. スキャンする内容を選択する**72**2. スキャンする内容を選択する**

73 73 

74プラグインはまずリポジトリを読み込み、その後、リポジトリ全体またはフォーカスされた領域を提供します。各オプションのファイル数と相対コストが記載されています。リポジトリ全体を選択するか、「I don't know」と答えると、プラグインはリポジトリのサイズに合わせて適切なデフォルトを選択します。74プラグインはまずリポジトリを読み込み、その後、リポジトリ全体またはフォーカスされた領域を提供します。リポジトリ全体を選択するか、「I don't know」と答えると、プラグインはリポジトリのサイズに合わせて適切なデフォルトを選択します。

75 75 

76**3. 実行を確認する**76**3. 実行を確認する**

77 77 

95 95 

96ブランチにベースにないコミットがある場合、`/claude-security` メニューはその差分のみをスキャンするオプションを提供するため、マージ前にブランチを確認できます。開いているプルリクエストの 1 つをスキャンするか、「scan commit abc1234」のように要求して単一のコミットをスキャンすることもできます。コミットされた変更のみがスキャンされます。進行中の編集をコミットまたはスタッシュするか、作業ツリーを読み込む完全スキャンを実行してください。96ブランチにベースにないコミットがある場合、`/claude-security` メニューはその差分のみをスキャンするオプションを提供するため、マージ前にブランチを確認できます。開いているプルリクエストの 1 つをスキャンするか、「scan commit abc1234」のように要求して単一のコミットをスキャンすることもできます。コミットされた変更のみがスキャンされます。進行中の編集をコミットまたはスタッシュするか、作業ツリーを読み込む完全スキャンを実行してください。

97 97 

98変更スキャンには git リポジトリが必要です。バージョン管理されていないディレクトリの完全スキャンは引き続き機能します。開いているプルリクエストを見つけることは、ネットワークに到達する唯一のステップであり、セッションが既に GitHub CLI を実行する権限を持ち、`gh` がサインインしている場合にのみ提供されます。98変更スキャンには git リポジトリが必要です。バージョン管理されていないディレクトリの完全スキャンは引き続き機能します。開いているプルリクエストを見つけるオプションは、セッションが既に GitHub CLI を実行する権限を持ち、`gh` がサインインしている場合にのみ提供されます。

99 99 

100### 大規模なリポジトリのスコープを設定する100### 大規模なリポジトリのスコープを設定する

101 101 

120* **`CLAUDE-SECURITY-RESULTS.md`**: レポート。各検出結果の ID（`F1` など）、影響、悪用シナリオ、重大度、信頼度、推奨事項が含まれています。120* **`CLAUDE-SECURITY-RESULTS.md`**: レポート。各検出結果の ID（`F1` など）、影響、悪用シナリオ、重大度、信頼度、推奨事項が含まれています。

121* **`CLAUDE-SECURITY-RESULTS.jsonl`**: 同じ検出結果を機械可読形式で、1 行に 1 つの JSON オブジェクト。121* **`CLAUDE-SECURITY-RESULTS.jsonl`**: 同じ検出結果を機械可読形式で、1 行に 1 つの JSON オブジェクト。

122* **`CLAUDE-SECURITY-RESULTS.sarif`**: 同じ検出結果を [SARIF 2.1.0](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html) ログとして。GitHub コードスキャンおよび標準を読む他のツール用です。スキャンは検出結果を [CWE](https://cwe.mitre.org/) 弱点カテゴリの下に分類します。122* **`CLAUDE-SECURITY-RESULTS.sarif`**: 同じ検出結果を [SARIF 2.1.0](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html) ログとして。GitHub コードスキャンおよび標準を読む他のツール用です。スキャンは検出結果を [CWE](https://cwe.mitre.org/) 弱点カテゴリの下に分類します。

123* **`CLAUDE-SECURITY-REVISION-<commit>.json`**: リビジョンスタンプ。スキャンされたコミット、どの[スキャンの労力](#choose-a-scan-effort)で実行されたか、コミットされていない変更がスキャンされたツリーの一部であったかどうか、実行がどの程度徹底的に検証されたかを記録します。これにより、レポートは常にそれが説明するコードに関連付けられます。バージョン管理外のスキャンは、コミットの代わりに `UNVERSIONED` をスタンプします。123* **`CLAUDE-SECURITY-REVISION-<commit>.json`**: リビジョンスタンプ。スキャンされたコミット、どの[スキャンの労力](#choose-a-scan-effort)で実行されたか、コミットされていない変更がスキャンされたツリーの一部であったかどうか、実行がどの程度徹底的に検証されたかを記録します。バージョン管理外のスキャンは、コミットの代わりに `UNVERSIONED` をスタンプします。

124 124 

125そのディレクトリはスキャンがチェックアウトに加える唯一の変更であり、独自の `.gitignore` を含むため、迷った `git add` がレポートをコミットに掃き込むことはありません。監査証跡のためにレポートを履歴に保持するには、その 1 つの `.gitignore` ファイルを削除して、ディレクトリを他のものと同様にコミットします。125そのディレクトリはスキャンがチェックアウトに加える唯一の変更であり、独自の `.gitignore` を含むため、迷った `git add` がレポートをコミットに掃き込むことはありません。監査証跡のためにレポートを履歴に保持するには、その 1 つの `.gitignore` ファイルを削除して、ディレクトリを他のものと同様にコミットします。

126 126 

127検出結果は、独立した検証エージェントが分析した後にのみレポートに表示されます。これにより、レポートは短く、読む価値があります。スキャンは非決定的です。同じコードの 2 つのスキャンは異なる検出結果を表示できます。スキャンを定期的に実行し、リビジョンスタンプを使用して、各レポートをそれがカバーする正確なコードと設定に属性付けします。127検出結果は、独立した検証エージェントが分析した後にのみレポートに表示されます。これにより、レポートは短く、読む価値があります。スキャンは非決定的です。同じコードの 2 つのスキャンは異なる検出結果を表示できます。スキャンを定期的に実行してください。

128 128 

129## 検出結果の修正129## 検出結果の修正

130 130 

102* **ロール**: すべてのプランで、ロールに関係なく自分の環境でシークレットを追加および削除できます。Team および Enterprise では、Owner は claude.ai 組織内で組織管理者ロールを保持し、Admin は保持しません。これにより、次のケースで表示される内容が変わります。102* **ロール**: すべてのプランで、ロールに関係なく自分の環境でシークレットを追加および削除できます。Team および Enterprise では、Owner は claude.ai 組織内で組織管理者ロールを保持し、Admin は保持しません。これにより、次のケースで表示される内容が変わります。

103 * **自分の環境**: 組織管理者ロールがない場合、**シークレットを追加** を選択すると [短いフォーム](#add-a-secret-without-the-role) が開きます103 * **自分の環境**: 組織管理者ロールがない場合、**シークレットを追加** を選択すると [短いフォーム](#add-a-secret-without-the-role) が開きます

104 * **共有環境**: Owner が管理設定から [シークレットを追加および削除](#add-a-credential) します。組織管理者ロールがない場合は、環境のダイアログに **ネットワークシークレット** セクションがないため、Owner にシークレットの追加を依頼してください104 * **共有環境**: Owner が管理設定から [シークレットを追加および削除](#add-a-credential) します。組織管理者ロールがない場合は、環境のダイアログに **ネットワークシークレット** セクションがないため、Owner にシークレットの追加を依頼してください

105* **環境タイプ**: 既に存在する Anthropic ホスト型クラウド環境。[自己ホスト型環境](https://code.claude.com/docs/ja/self-hosted-environments) にはネットワークシークレットがありません105* **環境タイプ**: Anthropic ホスト型クラウド環境。[自己ホスト型環境](https://code.claude.com/docs/ja/self-hosted-environments) にはネットワークシークレットがありません

106* **API 到達可能性**: API がインターネットからの接続を受け入れます。リクエストは Anthropic のネットワークから離れるためです106* **API 到達可能性**: API がインターネットからの接続を受け入れます。リクエストは Anthropic のネットワークから離れるためです

107* **暗号化キー**: 組織が顧客管理の暗号化キーを使用する場合、ネットワークシークレットを保存できません107* **暗号化キー**: 組織が顧客管理の暗号化キーを使用する場合、ネットワークシークレットを保存できません

108 108 

14>14>

15> GitHub 上でリポジトリ内のすべてのプルリクエストを自動的にレビューするには、Owner が組織に対して有効にするマネージドサービスである [Code Review](https://code.claude.com/docs/ja/code-review.md) を参照してください。15> GitHub 上でリポジトリ内のすべてのプルリクエストを自動的にレビューするには、Owner が組織に対して有効にするマネージドサービスである [Code Review](https://code.claude.com/docs/ja/code-review.md) を参照してください。

16 16 

17`/review` は `/code-review` のエイリアスです。v2.1.223 より前は、`/review` は GitHub プルリクエストに対してシングルパスの読み取り専用レビューを実行する別のコマンドでした。17`/review` は `/code-review` のエイリアスです。

18 18 

19**1. /code-review を実行する**19**1. /code-review を実行する**

20 20 

91* **`ultra`**: レビューは記憶されているレベルを使用も更新もしません91* **`ultra`**: レビューは記憶されているレベルを使用も更新もしません

92* **一度もレベルを入力していない場合**: レビューはセッションの現在の effort を使用します92* **一度もレベルを入力していない場合**: レビューはセッションの現在の effort を使用します

93 93 

94v2.1.223 より前は、レベルを指定しない `/code-review` は常にセッションの現在の effort を使用していました。

95 

96### 指摘事項を GitLab マージリクエストに投稿する94### 指摘事項を GitLab マージリクエストに投稿する

97 95 

98GitLab マージリクエストに対して `--comment` を渡すと、Claude Code は GitLab の `glab` CLI を通じて指摘事項を投稿します。Claude Code v2.1.257 以降が必要です。`glab` がインストールされていない場合、Claude は代わりにターミナルに指摘事項を出力します。96GitLab マージリクエストに対して `--comment` を渡すと、Claude Code は GitLab の `glab` CLI を通じて指摘事項を投稿します。Claude Code v2.1.257 以降が必要です。`glab` がインストールされていない場合、Claude は代わりにターミナルに指摘事項を出力します。

104| `/install-github-app` | リポジトリの Claude GitHub App をインストールし、[GitHub Actions](https://code.claude.com/docs/ja/github-actions.md) ワークフローとシークレットをセットアップするオプションのステップを実行します。リポジトリを選択して統合を設定するウォークスルーを行います。github.com リポジトリでのみ機能します。リポジトリの git リモートが gitlab.com または bitbucket.org にある場合、コマンドは通知を出力してセットアップを開始する代わりに終了します。GitLab パイプラインから Claude Code を実行するには、[GitLab CI/CD](https://code.claude.com/docs/ja/gitlab-ci-cd.md) を参照してください |104| `/install-github-app` | リポジトリの Claude GitHub App をインストールし、[GitHub Actions](https://code.claude.com/docs/ja/github-actions.md) ワークフローとシークレットをセットアップするオプションのステップを実行します。リポジトリを選択して統合を設定するウォークスルーを行います。github.com リポジトリでのみ機能します。リポジトリの git リモートが gitlab.com または bitbucket.org にある場合、コマンドは通知を出力してセットアップを開始する代わりに終了します。GitLab パイプラインから Claude Code を実行するには、[GitLab CI/CD](https://code.claude.com/docs/ja/gitlab-ci-cd.md) を参照してください |

105| `/install-slack-app` | Claude Slack アプリをインストールします。OAuth フローを完了するためにブラウザを開きます |105| `/install-slack-app` | Claude Slack アプリをインストールします。OAuth フローを完了するためにブラウザを開きます |

106| `/keybindings` | [キーボードショートカット](https://code.claude.com/docs/ja/keybindings.md)ファイルを開きます |106| `/keybindings` | [キーボードショートカット](https://code.claude.com/docs/ja/keybindings.md)ファイルを開きます |

107| `/list-agents` | サブエージェント、[エージェントチーム](https://code.claude.com/docs/ja/agent-teams.md)のチームメイト、および Claude がメッセージを送信できるその他の Claude Code セッションを、それぞれに使用する名前とともに一覧表示します。[クロスセッションメッセージング](https://code.claude.com/docs/ja/cross-session-messaging.md)を参照してください。`/peers` としても利用可能です。Claude Code v2.1.224 以降が必要です。以前のバージョンは `Unknown command: /list-agents` を報告します。チームメイト行とこのセッション自身の名前を示す最初の行には v2.1.239 以降が必要です。[クロスセッションメッセージングが有効](https://code.claude.com/docs/ja/cross-session-messaging.md#availability)なセッションでのみ利用可能です |107| `/list-agents` | サブエージェント、[エージェントチーム](https://code.claude.com/docs/ja/agent-teams.md)のチームメイト、および Claude がメッセージを送信できるその他の Claude Code セッションを、それぞれに使用する名前とともに一覧表示します。[クロスセッションメッセージング](https://code.claude.com/docs/ja/cross-session-messaging.md)を参照してください。`/peers` としても利用可能です。チームメイト行とこのセッション自身の名前を示す最初の行には v2.1.239 以降が必要です。[クロスセッションメッセージングが有効](https://code.claude.com/docs/ja/cross-session-messaging.md#availability)なセッションでのみ利用可能です |

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

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

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

132| `/rename [name]` | 現在のセッションの名前を変更し、プロンプトバーに名前を表示します。名前がない場合、会話履歴から自動生成されます。非対話モード（`-p`）でも利用可能です。claude.ai とデスクトップアプリを含むすべての名前変更サーフェスから、Claude Code は新しい名前の制御文字と非表示文字をスペースに置き換え、名前を 200 文字に制限します。非表示文字を削除すると名前が空になる場合、Claude Code はそれを拒否し、`That name is empty once invisible characters are removed. Usage: /rename <name>` を表示します。文字置換と長さ制限には Claude Code v2.1.221 以降が必要です |132| `/rename [name]` | 現在のセッションの名前を変更し、プロンプトバーに名前を表示します。名前がない場合、会話履歴から自動生成されます。非対話モード（`-p`）でも利用可能です。claude.ai とデスクトップアプリを含むすべての名前変更サーフェスから、Claude Code は新しい名前の制御文字と非表示文字をスペースに置き換え、名前を 200 文字に制限します。非表示文字を削除すると名前が空になる場合、Claude Code はそれを拒否し、`That name is empty once invisible characters are removed. Usage: /rename <name>` を表示します。文字置換と長さ制限には Claude Code v2.1.221 以降が必要です |

133| `/restart` | Claude Code を再起動してこのセッションを再開し、インストール済みのアップデートを適用します。アップデートのインストール後にフッターで提案されたときに実行してください。Pro、Max、または Ultra プランと、macOS または Linux 上のネイティブインストール（WSL は不可）が必要です。Claude Code v2.1.288 以降が必要です。エイリアス：`/update` |133| `/restart` | Claude Code を再起動してこのセッションを再開し、インストール済みのアップデートを適用します。アップデートのインストール後にフッターで提案されたときに実行してください。Pro、Max、または Ultra プランと、macOS または Linux 上のネイティブインストール（WSL は不可）が必要です。Claude Code v2.1.288 以降が必要です。エイリアス：`/update` |

134| `/resume [session]` | ID または名前で会話を再開するか、セッションピッカーを開きます。[バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md)はピッカーに `bg` でマークされて表示されます。実行中のセッションをピッカーから、または ID または名前で再開すると、[そのセッションが開きます](https://code.claude.com/docs/ja/sessions.md#resume-a-running-background-session)：現在の会話はバックグラウンドに移動し、このターミナルは実行中のセッションにアタッチされます。空のプロンプトで `←` を押すとエージェントビューに戻ります。エージェントビューには離れた会話も一覧表示されます。v2.1.285 より前は、Claude Code は拒否し、`claude attach` でセッションを開くか、先にそれを停止するよう指示していました。エイリアス：`/continue` |134| `/resume [session]` | ID または名前で会話を再開するか、セッションピッカーを開きます。[バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md)はピッカーに `bg` でマークされて表示されます。実行中のセッションをピッカーから、または ID または名前で再開すると、[そのセッションが開きます](https://code.claude.com/docs/ja/sessions.md#resume-a-running-background-session)：現在の会話はバックグラウンドに移動し、このターミナルは実行中のセッションにアタッチされます。空のプロンプトで `←` を押すとエージェントビューに戻ります。エージェントビューには離れた会話も一覧表示されます。v2.1.285 より前は、Claude Code は拒否し、`claude attach` でセッションを開くか、先にそれを停止するよう指示していました。エイリアス：`/continue` |

135| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | [`/code-review`](https://code.claude.com/docs/ja/code-review-local) のエイリアス：現在の差分、または `/review 1234` などの渡す PR 番号、ブランチ、またはパスをレビューし、同じ effort レベルとフラグを取ります。レベルが指定されていない場合、レビューは最後に入力した `low` ～ `max` のレベルを再利用します。正確なルールについては、[`/code-review` でローカルにレビューする](https://code.claude.com/docs/ja/code-review-local)を参照してください。ディープクラウドレビューの場合は、[`/code-review ultra`](https://code.claude.com/docs/ja/ultrareview) を使用してください。v2.1.223 より前は、`/review` は GitHub プルリクエストを番号で指定して単一パスの読み取り専用レビューを実行する別のコマンドで、引数なしで実行すると開いている PR を一覧表示して選択できました。v2.1.186 ～ v2.1.201 では、`/code-review medium` と同じマルチエージェントエンジンを実行しました |135| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | [`/code-review`](https://code.claude.com/docs/ja/code-review-local) のエイリアス：現在の差分、または `/review 1234` などの渡す PR 番号、ブランチ、またはパスをレビューし、同じ effort レベルとフラグを取ります。レベルが指定されていない場合、レビューは最後に入力した `low` ～ `max` のレベルを再利用します。正確なルールについては、[`/code-review` でローカルにレビューする](https://code.claude.com/docs/ja/code-review-local)を参照してください。ディープクラウドレビューの場合は、[`/code-review ultra`](https://code.claude.com/docs/ja/ultrareview) を使用してください |

136| `/rewind` | 会話またはコードを前の時点に巻き戻すか、選択したメッセージから要約します。[チェックポイント機能](https://code.claude.com/docs/ja/checkpointing.md)を参照してください。エイリアス：`/checkpoint`、`/undo` |136| `/rewind` | 会話またはコードを前の時点に巻き戻すか、選択したメッセージから要約します。[チェックポイント機能](https://code.claude.com/docs/ja/checkpointing.md)を参照してください。エイリアス：`/checkpoint`、`/undo` |

137| `/run` | **[Skill](https://code.claude.com/docs/ja/skills.md#bundled-skills).** プロジェクトのアプリを起動して操作し、テストに合格するだけでなく、変更が実際に機能していることを確認します。[アプリを実行して検証する](https://code.claude.com/docs/ja/skills.md#run-and-verify-your-app)を参照してください |137| `/run` | **[Skill](https://code.claude.com/docs/ja/skills.md#bundled-skills).** プロジェクトのアプリを起動して操作し、テストに合格するだけでなく、変更が実際に機能していることを確認します。[アプリを実行して検証する](https://code.claude.com/docs/ja/skills.md#run-and-verify-your-app)を参照してください |

138| `/run-skill-generator` | **[Skill](https://code.claude.com/docs/ja/skills.md#bundled-skills).** プロジェクトごとの[スキル](https://code.claude.com/docs/ja/skills.md#run-and-verify-your-app)を書くことで、クリーンな環境からプロジェクトのアプリをビルド、起動、操作する方法を `/run` と `/verify` に教えます |138| `/run-skill-generator` | **[Skill](https://code.claude.com/docs/ja/skills.md#bundled-skills).** プロジェクトごとの[スキル](https://code.claude.com/docs/ja/skills.md#run-and-verify-your-app)を書くことで、クリーンな環境からプロジェクトのアプリをビルド、起動、操作する方法を `/run` と `/verify` に教えます |

294 294 

295カスタム [フック](https://code.claude.com/docs/ja/hooks.md) は Claude がそれを見る前にデータを前処理できます。Claude が 10,000 行のログファイルを読んでエラーを見つける代わりに、フックは `ERROR` に対して grep を実行し、一致する行のみを返すことができます。これにより、コンテキストを数万トークンから数百に削減します。295カスタム [フック](https://code.claude.com/docs/ja/hooks.md) は Claude がそれを見る前にデータを前処理できます。Claude が 10,000 行のログファイルを読んでエラーを見つける代わりに、フックは `ERROR` に対して grep を実行し、一致する行のみを返すことができます。これにより、コンテキストを数万トークンから数百に削減します。

296 296 

297[スキル](https://code.claude.com/docs/ja/skills.md) は Claude にドメイン知識を与えることができるため、探索する必要がありません。たとえば、「codebase-overview」スキルはプロジェクトのアーキテクチャ、主要なディレクトリ、命名規則を説明できます。Claude がスキルを呼び出すと、構造を理解するために複数のファイルを読むトークンを費やす代わりに、このコンテキストが即座に得られます。297この PreToolUse フックは、テスト出力を最後の 100 行に切り詰めます。

298 

299たとえば、この PreToolUse フックはテスト出力をフィルタリングして失敗のみを表示します。

300 298 

301> [tab] settings.json299> [tab] settings.json

302>300>

322 320 

323> [tab] filter-test-output.sh321> [tab] filter-test-output.sh

324>322>

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

326>324>

327> ```bash theme={null}325> ```bash theme={null}

328> #!/bin/bash326> #!/bin/bash

329> input=$(cat)327> input=$(cat)

330> cmd=$(echo "$input" | jq -r '.tool_input.command')328> cmd=$(echo "$input" | jq -r '.tool_input.command')

331>329>

332> # If running tests, filter to show only failures330> # If running tests, keep only the last 100 lines

333> pattern='^(npm test|pytest|go test)( [^;&|<>`$#\\[:cntrl:]]*)?$'331> pattern='^(npm test|pytest|go test)( [^;&|<>`$#\\[:cntrl:]]*)?$'

334> if [[ "$cmd" =~ $pattern ]]; then332> if [[ "$cmd" =~ $pattern ]]; then

335> filtered_cmd="$cmd 2>&1 | grep -A 5 -E '(FAIL|ERROR|error:)' | head -100"333> filtered_cmd="$cmd 2>&1 | tail -n 100"

336> echo "$input" | jq --arg filtered "$filtered_cmd" \334> echo "$input" | jq --arg filtered "$filtered_cmd" \

337> '{hookSpecificOutput: {hookEventName: "PreToolUse", updatedInput: (.tool_input + {command: $filtered})}}'335> '{hookSpecificOutput: {hookEventName: "PreToolUse", updatedInput: (.tool_input + {command: $filtered})}}'

338> else336> else

342 340 

343セットアップを確認するには、`/hooks` を実行して、フックが PreToolUse の下に表示されることを確認します。`claude --debug-file ./claude-debug.txt` で Claude Code を起動し、Claude に `npm test` を実行するよう依頼することもできます。フックがコマンドを書き直すと、そのログファイルには `command` と他の Bash 入力フィールドをリストする `modified tool input keys` 行が含まれます。341セットアップを確認するには、`/hooks` を実行して、フックが PreToolUse の下に表示されることを確認します。`claude --debug-file ./claude-debug.txt` で Claude Code を起動し、Claude に `npm test` を実行するよう依頼することもできます。フックがコマンドを書き直すと、そのログファイルには `command` と他の Bash 入力フィールドをリストする `modified tool input keys` 行が含まれます。

344 342 

343[スキル](https://code.claude.com/docs/ja/skills.md) は Claude にドメイン知識を与えることができるため、探索する必要がありません。たとえば、「codebase-overview」スキルはプロジェクトのアーキテクチャ、主要なディレクトリ、命名規則を説明できます。Claude がスキルを呼び出すと、構造を理解するために複数のファイルを読むトークンを費やす代わりに、このコンテキストが即座に得られます。

344 

345### CLAUDE.md からスキルに指示を移動する345### CLAUDE.md からスキルに指示を移動する

346 346 

347[CLAUDE.md](https://code.claude.com/docs/ja/memory.md) ファイルはセッション開始時にコンテキストに読み込まれます。PR レビューやデータベースマイグレーションなどの特定のワークフロー用の詳細な指示が含まれている場合、関連のない作業を行っているときでもそれらのトークンが存在します。[スキル](https://code.claude.com/docs/ja/skills.md) はオンデマンドでのみ呼び出されたときに読み込まれるため、特殊な指示をスキルに移動することで、ベースコンテキストを小さく保ちます。必須項目のみを含めることで、CLAUDE.md を 200 行以下に保つことを目指します。347[CLAUDE.md](https://code.claude.com/docs/ja/memory.md) ファイルはセッション開始時にコンテキストに読み込まれます。PR レビューやデータベースマイグレーションなどの特定のワークフロー用の詳細な指示が含まれている場合、関連のない作業を行っているときでもそれらのトークンが存在します。[スキル](https://code.claude.com/docs/ja/skills.md) はオンデマンドでのみ呼び出されたときに読み込まれるため、特殊な指示をスキルに移動することで、ベースコンテキストを小さく保ちます。必須項目のみを含めることで、CLAUDE.md を 200 行以下に保つことを目指します。

23* **長時間実行される作業からステータスを取得する**: マイグレーションまたはテスト実行を監視しているセッションに報告させるか、そこから自分で尋ねます。そのセッションがこのマシン上にある場合、Claude は[次にアイドル状態になるか終了するときに 1 つの通知を求める](#get-a-notice-when-another-session-goes-idle)こともできます。23* **長時間実行される作業からステータスを取得する**: マイグレーションまたはテスト実行を監視しているセッションに報告させるか、そこから自分で尋ねます。そのセッションがこのマシン上にある場合、Claude は[次にアイドル状態になるか終了するときに 1 つの通知を求める](#get-a-notice-when-another-session-goes-idle)こともできます。

24* **マシン間でメッセージを送信する**: 別のマシンまたはウェブ上の 1 つのセッションに到達します。24* **マシン間でメッセージを送信する**: 別のマシンまたはウェブ上の 1 つのセッションに到達します。

25 25 

26## 別のセッションにメッセージを送信する26## 別のセッションにメッセージを送る

27 27 

28あるセッションが別のセッションで必要な情報（調査結果、ステータス、決定など）を学んだ場合、Claude はターミナル間でコピー＆ペーストする代わりに、その情報を自動的に渡します。Claude は `ListAgents` でターゲットを検出し、`SendMessage` で送信するため、ユーザーがこれらのツールを呼び出す必要はありません。Claude は要求されなくてもメッセージを送信することを決定できますし、ユーザーがメッセージを促すこともできます。28あるセッションが、発見した事実、ステータス、決定事項など、別のセッションが必要とする情報を得たときは、ターミナル間でコピー＆ペーストする代わりに Claude がそれを伝えます。Claude は `ListAgents` で送信先を見つけ、`SendMessage` で送信するため、どちらのツールもユーザー自身が呼び出す必要はありません。Claude は頼まれなくてもメッセージを送ることを判断できますし、プロンプトで送信を指示することもできます。

29 29 

30自分でメッセージを促すには、別のセッションが知る必要があることや実行する必要があることを Claude に伝えます。以下の例は Claude が送信するメッセージではなく、ユーザーが入力するプロンプトです。30自分で指示するには、別のセッションに知らせたいことや、してほしいことを Claude に伝えます。次の例は、Claude が送るメッセージではなく、ユーザーが入力するプロンプトです。

31 31 

32```text wrap theme={null}32```text wrap theme={null}

33Ask the session running in my other terminal whether the migration finished33Ask the session running in my other terminal whether the migration finished

34```34```

35 35 

36Claude は実際のメッセージ自体を作成するため、ユーザーのプロンプトはコンテンツを Claude に任せることができます。このプロンプトは表現方法を指定せずに要約を求めており、Claude が送信する内容は異なります。36実際のメッセージは Claude 自身が書くため、プロンプトでは内容を Claude に任せることができます。次のプロンプトは文言を指定せずに要約を求めるもので、Claude が送る内容は毎回異なります。

37 37 

38```text wrap theme={null}38```text wrap theme={null}

39Explain what we just did to the session working on the payments API39Explain what we just did to the session working on the payments API

40```40```

41 41 

42ターゲットを自分で指定するには、プロンプトでセッションに言及します。`@` に続けてセッション名の最初の文字を入力し、タイプアヘッドからセッションを選択します。これは [サブエージェントを明示的に呼び出す](https://code.claude.com/docs/ja/sub-agents.md#invoke-subagents-explicitly) 場合と同じ方法です。Claude Code v2.1.232 以降が必要です。Claude Code はメンション（`@api-worker` など）を挿入し、Claude にそのセッションを指定するため、Claude はセッションを最初にリストアップせずにそのセッションにメッセージを送信できます。このプロンプトはメンションでターゲットを指定します。42送信先を自分で指定するには、プロンプト内でセッションをメンションします。[サブエージェントを @ メンションする](https://code.claude.com/docs/ja/sub-agents.md#invoke-subagents-explicitly)のと同じ方法で、`@` に続けてセッション名の先頭の数文字を入力し、入力候補からセッションを選びます。Claude Code v2.1.232 以降が必要です。Claude Code は `@api-worker` のようなメンションを挿入し、それがどのセッションを指すかを Claude に伝えるため、Claude はセッションの一覧を取得せずにそのセッションへメッセージを送れます。次のプロンプトは、メンションで送信先を指定しています。

43 43 

44```text wrap theme={null}44```text wrap theme={null}

45Let @api-worker know the schema migration finished45Let @api-worker know the schema migration finished

46```46```

47 47 

48タイプアヘッドには、このマシン上の他のライブセッションが表示されます。名前の最初の文字以上が必要な場合は 2 つあります。48入力候補には、このマシン上で実行中の他のセッションが表示されます。次の 2 つの場合は、名前の先頭の数文字を入力するだけでは足りません。

49 49 

50* **このマシンを超えたセッション**：クラウドまたはリモートコントロールセッションは、Claude がこのマシンを超えたセッションをリストアップまたはメッセージした後にのみタイプアヘッドに表示されるため、Claude に最初にそれらをリストアップするよう依頼してください。50* **このマシン以外のセッション**: クラウドセッションや Remote Control セッションは、Claude がこのマシン以外のセッションの一覧を取得するか、それらにメッセージを送った後でなければ入力候補に表示されません。そのため、まず Claude に一覧を取得するよう依頼してください。

51* **スペースまたは文字、数字、ハイフン、アンダースコア以外の文字を含む名前**：`@"release notes"` のようにダブルクォートで入力してください。タイプアヘッドからセッションを選択すると、Claude Code がクォートを自動的に挿入します。51* **スペースや、英字、数字、ハイフン、アンダースコア以外の文字を含む名前**: `@"release notes"` のように二重引用符で囲んで入力します。入力候補からセッションを選ぶと、Claude Code が引用符を自動で挿入します。

52 52 

53ピッカーなしでメンションを入力することもできます。複数のライブセッションが指定された名前に応答する場合、Claude は送信前にどちらを意味するのかを尋ねます。53候補を使わずにメンションを入力することもできます。メンションした名前に該当する実行中のセッションが複数ある場合、Claude は送信前にどのセッションを指しているかをユーザーに確認します。

54 54 

55メッセージが到着したときの Claude が作成するメッセージの外観（例を含む）については、[メッセージの外観](#what-a-message-looks-like) を参照してください。55Claude が書いたメッセージが届いたときにどのように見えるか（例を含む）については、[メッセージの見え方](#what-a-message-looks-like)を参照してください。

56 56 

57### メッセージ配信57### メッセージの配信

58 58 

59受信側の Claude はアクティブなターンの間にツール呼び出しの間でメッセージを読むため、実行中のツールが中断されることはありません。受信セッションがアイドル状態の場合、Claude Code はメッセージで新しいターンを開始します。59受信側の Claude は、アクティブなターン中のツール呼び出しの合間にメッセージを読みます。受信側のセッションがアイドル状態の場合、Claude Code はそのメッセージで新しいターンを開始します。

60 60 

61別のセッションからのメッセージはプレーンテキストとして到着します。`@` でファイルまたは [MCP リソース](https://code.claude.com/docs/ja/mcp.md#use-mcp-resources) に言及する場合、Claude は記述されたメンションを見て、Claude Code は何も添付しません。メッセージが新しいターンを開始するか、既存のターン中に到着するかに関わらず、です。Claude は依然として受信マシン上の指定されたパスを独自のツールで開くことができます。そのセッションの権限に従います。61別のセッションからのメッセージはプレーンテキストとして届きます。メッセージが `@` でファイルや [MCP リソース](https://code.claude.com/docs/ja/mcp.md#use-mcp-resources)をメンションしていても、Claude には書かれたとおりのメンションが見えるだけで、Claude Code は何も添付しません。これは、メッセージが新しいターンを開始する場合もターン中に届く場合も同じです。ただし Claude は、受信側セッションの権限の範囲内で、自身のツールを使って受信側マシン上のメンションされたパスを開くことができます。

62 62 

63Claude Code は以下の場合、メッセージを拒否します。63Claude Code は次の場合にメッセージを拒否します。

64 64 

65* メッセージが [サイズ上限を超えている](#limitations)。Claude Code はそれを送信セッションで拒否します。送信前に。65* メッセージが[サイズ上限を超えている](#limitations)。Claude Code は送信側のセッションで、メッセージが送出される前に拒否します。

66* このマシン上のセッションへの急速なバースト送信が [そのセッションのインボックスが受け入れる内容](#limitations) に達しています。Claude Code はそのセッションへのさらなるメッセージを拒否します。66* このマシン上のセッションへの短時間の連続送信が、[そのセッションの受信箱が受け付ける量](#limitations)に達した。Claude Code はそのセッションへのそれ以上のメッセージを拒否します。

67* このマシンを超えたセッションが [クロスセッションメッセージを受信できないとリストに表示されている](#message-sessions-on-other-machines)。Claude Code は、メッセージがこのマシンを離れる前に送信セッションで拒否します。67* このマシン以外のセッションが、[クロスセッションメッセージを受信できないと一覧に表示されている](#message-sessions-on-other-machines)。Claude Code は送信側のセッションで、メッセージがこのマシンから送出される前に拒否します。

68* このマシン上の返信ターゲットが、シンリンクされたターゲットなど、安全性チェックに失敗します。[クロスセッションメッセージの送信を拒否する](https://code.claude.com/docs/ja/errors.md#refusing-to-send-a-cross-session-message) にこれらのチェックが記載されています。68* このマシン上の返信先が、シンボリックリンクされた送信先など、安全性チェックに失敗した。これらのチェックについては [Refusing to send a cross-session message](https://code.claude.com/docs/ja/errors.md#refusing-to-send-a-cross-session-message) を参照してください。

69 69 

70受信セッションは到着した各メッセージを独自の [インバウンドコントロール](#control-inbound-messages) に対してチェックし、チェックは 3 つの結果のいずれかで終了します。70受信側のセッションは、届いた各メッセージを自身の[受信制御](#control-inbound-messages)と照合し、そのチェックは次の 3 つの結果のいずれかになります。

71 71 

72* **配信済み**：Claude Code はメッセージを受信側の Claude に渡します。72* **配信**: Claude Code はメッセージを受信側の Claude に渡します。

73* **保留中**：Claude Code はメッセージを配信されないまま脇に置きます。保留中のメッセージは、ユーザーが承認するか、後のモードまたは設定変更がそれを許可する場合にのみ Claude に到達します。73* **保留**: Claude Code はメッセージを配信せずに保留します。保留されたメッセージが Claude に届くのは、ユーザーが承認したとき、または後のモードや設定の変更で許可されたときだけです。

74* **拒否**：Claude Code はメッセージを配信せずに削除します。74* **拒否**: Claude Code はメッセージを配信せずに破棄します。

75 75 

76配信されると、メッセージはユーザーが入力したプロンプトと同様に [使用量](https://code.claude.com/docs/ja/costs.md) にカウントされます。受信側の Claude は `SendMessage` で送信者に返信できます。ただし、[他のマシンおよびクラウドセッションからの返信](#replies-from-other-machines-and-cloud-sessions) と [クロスセッションメッセージングをオフにする](#turn-off-cross-session-messaging) で説明されている場合を除きます。76配信されたメッセージは、ユーザーが入力するプロンプトと同様に[使用量](https://code.claude.com/docs/ja/costs.md)にカウントされます。受信側の Claude は `SendMessage` で送信元に返信できます。ただし、[他のマシンやクラウドセッションからの返信](#replies-from-other-machines-and-cloud-sessions)と[クロスセッションメッセージをオフにする](#turn-off-cross-session-messaging)で説明する場合を除きます。

77 77 

78権限の境界はセッションごとに保たれます。Claude は、自身のセッションで拒否またはブロックされたアクション、または独自の権限設定がブロックするアクションを別のセッションに要求しないよう指示されており、その作業をユーザーに戻すよう指示されています。受信側では、[受信セッション独自の権限プロンプトとルール](#how-a-session-treats-an-incoming-message) がメッセージが要求するすべてのものに適用されます。78権限の境界はセッションごとに維持されます。Claude は、自身のセッションで拒否またはブロックされた操作や、自身の権限設定でブロックされるはずの操作を別のセッションに依頼しないよう指示されており、そうした作業はユーザーに差し戻します。受信側では、メッセージが求めるあらゆる操作に対して、[受信側セッション自身の権限プロンプトとルールが引き続き適用されます](#how-a-session-treats-an-incoming-message)。

79 79 

80### 別のセッションがアイドル状態になったときに通知を受け取る80### 別のセッションがアイドルになったときに通知を受け取る

81 81 

82Claude は、このマシン上のセッションの 1 つに、そのセッションが次にアイドル状態になるか終了するときに 1 つの通知を送り返すよう依頼できます。ここでアイドルとは、セッションがキューに入っているものがない状態でターンを完了したことを意味します。別のセッションで長いタスクを待っていて、チェックする代わりに完了したときに聞きたい場合に使用します。両方のセッションで Claude Code v2.1.236 以降が必要です。82Claude は、このマシン上のセッションの 1 つに対し、そのセッションが次にアイドル状態になったとき、または終了したときに通知を 1 件返すよう依頼できます。ここでのアイドルとは、セッションがキューに何も残さずにターンを終えた状態を指します。別のセッションで長時間のタスクを待っていて、確認しに行く代わりに完了したときに知らせてほしい場合に使います。両方のセッションで Claude Code v2.1.236 以降が必要です。

83 83 

84#### 通知をリクエストする84#### 通知を依頼する

85 85 

86待機中の内容を Claude に伝えます。このプロンプトはマイグレーションセッションから通知をリクエストします。86何を待っているかを Claude に伝えます。次のプロンプトは、マイグレーションのセッションからの通知を依頼します。

87 87 

88```text wrap theme={null}88```text wrap theme={null}

89Tell me when the migration session finishes what it's working on89Tell me when the migration session finishes what it's working on

90```90```

91 91 

92Claude は `SendMessage` ツールの `notify_when_idle` 入力で購読します。送信しているメッセージに添付するか、単独で。単独の場合、Claude Code は監視対象セッションでターンを開始したり、トークンを消費したりせずに購読し、そのセッションが既にアイドル状態の場合は通知をすぐに送信します。メッセージに添付する場合、Claude Code はメッセージを最初に配信し、後で通知を送信します。92Claude は `SendMessage` ツールの `notify_when_idle` 入力を使ってサブスクライブします。これは、いずれにせよ送るメッセージに付けることも、単独で使うこともできます。単独の場合、Claude Code は監視対象のセッションでターンを開始したりトークンを消費したりせずにサブスクライブし、そのセッションがすでにアイドル状態であればすぐに通知を送ります。メッセージに付けた場合、Claude Code はまずメッセージを配信し、後で通知を送ります。

93 93 

94#### 各セッションが表示するもの94#### 各セッションの表示内容

95 95 

96監視対象セッションは、別のプロセスがセッションが次にアイドル状態になったときに通知されるよう要求したことを示す行を表示します。要求側セッションは、監視対象セッションに名前を付ける行として通知を表示します。この行には、そのセッションのターンが完了した時刻と、そのターンからの 1 行のステータスを含めることができます。要求側セッションがアイドル状態の場合、Claude Code は通知で新しいターンを開始します。96監視対象のセッションには、別のプロセスがこのセッションが次にアイドルになったときに知らせるよう依頼した旨の行が表示されます。依頼したセッションには、監視対象のセッション名を示す行として通知が表示されます。この行には、そのセッションのターンが終了した時刻と、そのターンの 1 行のステータスが含まれる場合があります。依頼したセッションがアイドル状態の場合、Claude Code はその通知で新しいターンを開始します。

97 97 

98#### 制限98#### 制限

99 99 

100通知は 1 回限りです。Claude Code は監視対象セッションから 1 回送信し、どちらのセッションも他方をポーリングしません。12 時間以内に通知が到着しない場合、Claude Code は購読を削除し、Claude に通知するため、待機を続けません。10012 時間以内に通知が届かない場合、Claude Code はサブスクリプションを破棄して Claude に伝えるため、Claude が待ち続けることはありません。

101 101 

102各側の [インバウンドコントロール](#control-inbound-messages) はメッセージのような通知に適用されます。102通知にも、メッセージと同様に各側の[受信制御](#control-inbound-messages)が適用されます。

103 103 

104* **どちらかの側で `refuse`**：何も到着しません。監視対象セッションは要求を記録または応答せずに削除するため、購読は 12 時間後に未応答で期限切れになり、`refuse` を持つ要求側セッションは購読しません。104* **どちらかの側が `refuse`**: 何も届きません。監視対象のセッションはリクエストを記録も応答もせずに破棄するため、サブスクリプションは 12 時間後に応答がないまま期限切れになります。また、`refuse` の依頼側セッションはサブスクライブしません。

105* **どちらかの側で `hold`**：通知は少なく到着します。監視対象セッションは 1 行のステータスを除外し、要求側セッションは Claude に配信せずにトランスクリプトに通知を表示します。105* **どちらかの側が `hold`**: 通知は内容が減った状態で届きます。監視対象のセッションは 1 行のステータスを省き、依頼側のセッションは通知を Claude に配信せずにトランスクリプトに表示します。

106 106 

107メインの会話の Claude のみが購読でき、このマシン上のセッションのみに購読できます。Claude がチームメイト、サブエージェント、またはこのマシンを超えたセッションなど、他のエージェントから通知をリクエストする場合、Claude Code は添付されたメッセージを含む呼び出し全体を拒否します。107サブスクライブできるのはメインの会話の Claude だけで、対象はこのマシン上のユーザーのセッションに限られます。チームメイト、サブエージェント、このマシン以外のセッションなど、それ以外の対象に Claude が通知を求めた場合、Claude Code は付随するメッセージも含めて呼び出し全体を拒否します。

108 108 

109### Claude が到達できるセッションを確認する109### Claude が到達できるセッションを確認する

110 110 

111Claude はメッセージのターゲットを独自に検出するため、送信を依頼する前に何かを実行する必要はありません。Claude が到達できるセッションを自分で確認するには、`/list-agents` コマンドを実行します。最初の行（存在する場合）はこのセッション自体の名前で、他のセッションがそれにメッセージを送信するために使用する名前です。以下の行は Claude が到達できるセッションです。111Claude はメッセージの送信先を自分で見つけるため、送信を依頼する前に何かを実行する必要はありません。Claude が到達できるセッションを自分で確認するには、`/list-agents` コマンドを実行します。最初の行がある場合、それはこのセッション自身の名前で、他のセッションがこのセッションにメッセージを送る際に使う名前です。その下の行は、Claude が到達できるセッションです。

112 112 

113* **サブエージェント**：現在のセッション内で実行されているエージェント。113* **サブエージェント**: 現在のセッション内で実行中のエージェント。

114* **チームメイト**：このセッション独自の [エージェントチーム](https://code.claude.com/docs/ja/agent-teams.md) チームメイト。114* **チームメイト**: このセッション自身の[エージェントチーム](https://code.claude.com/docs/ja/agent-teams.md)のチームメイト。

115* **他のローカルセッション**：同じマシン上で実行されている Claude Code セッション。[バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md) を含みます。セッションは [インボックスソケット](#the-sessions-inbox-socket) をバインドするときにのみ表示されます。115* **他のローカルセッション**: [バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md)を含む、同じマシン上で実行中の Claude Code セッション。セッションが表示されるのは、[受信箱ソケット](#the-sessions-inbox-socket)をバインドしている場合だけです。

116* **[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)**：このセッションが [リモートコントロール](https://code.claude.com/docs/ja/remote-control.md) に接続されている間に表示されます。116* **[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)**: このセッションが [Remote Control](https://code.claude.com/docs/ja/remote-control.md) に接続している間に表示されます。

117* **他のマシン上のリモートコントロールセッション**：このセッションが [リモートコントロール](https://code.claude.com/docs/ja/remote-control.md) に接続されている間に表示され、`Remote Control` とラベル付けされます。Claude Code は、リモートコントロール接続が切断されたセッションのステータスを `offline` として表示します。117* **他のマシン上の Remote Control セッション**: このセッションが [Remote Control](https://code.claude.com/docs/ja/remote-control.md) に接続している間に表示され、`Remote Control` というラベルが付きます。Remote Control 接続が切断されたセッションのステータスには、Claude Code が `offline` と表示します。

118 118 

119このセッションが [リモートコントロール](https://code.claude.com/docs/ja/remote-control.md) に接続されている間、Claude Code は `/list-agents` 出力からローカルセッションの詳細の一部を保留し、Claude 自体がセッションをメッセージするために検索するときに見るものは変わりません。119このセッションが [Remote Control](https://code.claude.com/docs/ja/remote-control.md) に接続している間、Claude Code は `/list-agents` の出力からローカルセッションの詳細の一部を伏せます。ただし、メッセージの送信先を探す際に Claude 自身が見る内容は変わりません。

120 120 

121* **作業ディレクトリ**：各ローカルセッションの作業ディレクトリを除外します。121* **作業ディレクトリ**: 各ローカルセッションの作業ディレクトリを省きます。

122* **セッション名**：人に属性付けできないセッション名を除外するため、名前が残っていない行は `(unnamed session)` と読みます。122* **セッション名**: 人に帰属させられないセッション名を省くため、名前がなくなった行は `(unnamed session)` と表示されます。

123* **最初の行**：このセッション自体の名前を持つ行を除外します。ユーザーがこのターミナルでその名前を入力した場合を除き、`--name` または `/rename` と名前を使用して、セッションを起動または再開してから。123* **最初の行**: セッションを起動または最後に再開してから、このターミナルで `--name` または `/rename` と名前を使ってその名前を入力していない限り、このセッション自身の名前を示す行を省きます。

124 124 

125出力が何かをリストアップする場合、詳細が保留されたことを示す注記で終了します。セッション独自のキーボードで `/rename` に続いて未使用の名前を実行すると、そのセッションに出力に表示される名前が付与されます。125出力に何かが表示される場合、末尾に詳細が伏せられたことを示す注記が付きます。セッション自身のキーボードで `/rename` に続けて未使用の名前を実行すると、そのセッションに出力に表示される名前が付きます。

126 126 

127セッションは [`/rename`](https://code.claude.com/docs/ja/commands) コマンドまたは [`--name`](https://code.claude.com/docs/ja/cli-reference#cli-flags) フラグで設定した名前に応答します。設定しない場合、Claude Code はセッション自体に名前を付けます。インタラクティブセッションの場合、これは [実行中のセッションのリスト](https://code.claude.com/docs/ja/sessions.md#name-your-sessions) に表示される名前です。127セッションは、[`/rename`](https://code.claude.com/docs/ja/commands) コマンドまたは [`--name`](https://code.claude.com/docs/ja/cli-reference#cli-flags) フラグで設定した名前に応答します。名前を設定しない場合は、Claude Code がセッションに名前を付けます。対話型セッションの場合、それは[実行中のセッションの一覧](https://code.claude.com/docs/ja/sessions.md#name-your-sessions)に表示される名前です。

128 128 

129このセッションが Remote Control に接続されていない限り、Claude Code は `/list-agents` 出力に各ローカルセッションの作業ディレクトリを表示するため、異なるディレクトリで実行されている同じ名前のセッションを区別できます。Claude はメッセージを 2 つの方法のいずれかで送信します。名前に応答するライブセッションの数によって異なります。129このセッションが Remote Control に接続していない限り、Claude Code は `/list-agents` の出力に各ローカルセッションの作業ディレクトリを表示するため、同じ名前のセッションが異なるディレクトリで実行されていても区別できます。Claude は、その名前に応答する実行中のセッションの数に応じて、次の 2 つの方法のいずれかでメッセージの宛先を指定します。

130 130 

131* **1 つのセッションが名前に応答する**：Claude Code は名前だけでメッセージを配信します。131* **その名前に応答するセッションが 1 つの場合**: Claude Code は名前だけでメッセージを配信します。

132* **複数のセッションが名前を共有するか、Claude Code がセッションを実行するすべての場所をチェックできない**：Claude はリストの各行に短い識別子を追加し、アドレスで識別子を使用します。132* **複数のセッションが同じ名前を共有している場合、または Claude Code がセッションの実行場所をすべて確認できなかった場合**: Claude は一覧の各行に短い識別子を付け、その識別子を宛先に使います。

133 133 

134### 他のマシン上のセッションにメッセージを送信する134### 他のマシン上のセッションにメッセージを送る

135 135 

136メッセージがどのように移動するか、および Anthropic サーバーを通過するかどうかは、ターゲットセッションが実行される場所によって異なります。136メッセージがどのように伝わるか、また Anthropic のサーバーを経由するかどうかは、送信先のセッションが実行されている場所によって異なります。

137 137 

138| 他のセッションが実行される場所 | メッセージの移動方法 |138| 他のセッションの実行場所 | メッセージの伝わり方 |

139| :- | :- |139| :- | :- |

140| このマシン上 | macOS および Linux 上のセッションごとのソケット、またはネイティブ Windows 上のセッションごとの名前付きパイプ。Anthropic サーバーを通じて決してない |140| このマシン上 | macOS と Linux ではセッションごとのソケット、ネイティブ Windows ではセッションごとの名前付きパイプを経由し、Anthropic のサーバーは経由しません |

141| 他のマシンの 1 つ | Anthropic サーバーを通じて、そのマシンの [リモートコントロール](https://code.claude.com/docs/ja/remote-control.md) 接続を通じて到着 |141| 自分の別のマシン上 | Anthropic のサーバーを経由し、そのマシンの [Remote Control](https://code.claude.com/docs/ja/remote-control.md) 接続を通じて届きます |

142| [クラウド](https://code.claude.com/docs/ja/claude-code-on-the-web.md) | Anthropic サーバーを通じて、クラウドセッションに直接 |142| [クラウド](https://code.claude.com/docs/ja/claude-code-on-the-web.md) | Anthropic のサーバーを経由し、クラウドセッションに直接届きます |

143 143 

144他のマシン上のセッションとの会話を開始するには、Claude Code v2.1.225 以降と、[リストに表示される](#see-which-sessions-claude-can-reach) ターゲットが必要です。144自分の別のマシン上のセッションとの会話を開始するには、Claude Code v2.1.225 以降と、[一覧に表示される](#see-which-sessions-claude-can-reach)送信先が必要です。

145 145 

146[リスト](#see-which-sessions-claude-can-reach) のセッションの行には、Claude がそのセッションにメッセージを送信したときの動作を変える状態が表示されることがあります。146[一覧](#see-which-sessions-claude-can-reach)のセッションの行には、Claude がそのセッションにメッセージを送ったときの動作を変える状態が表示される場合があります。

147 147 

148* **`offline`**：そのセッションの Remote Control 接続が切断されています。メッセージは送信されますが、そのセッションのマシンが再接続した後にのみ到着します。148* **`offline`**: そのセッションの Remote Control 接続が切断されています。メッセージは送信されますが、届くのはそのセッションのマシンが再接続した後です。

149* **`can't receive cross-session messages (off in that session)`**：そのセッションでメッセージ送受信が [利用できない](#availability) か、その [`crossSessionInbound`](https://code.claude.com/docs/ja/settings-reference#crosssessioninbound) の値が `refuse` です。Claude Code は、メッセージがこのマシンを離れる前に、そのセッションへのメッセージを拒否します。Claude の `SendMessage` 呼び出しの結果は `Not sent` で始まり、理由が示されます。そのセッションで原因が解消されると、以降のリストにはこの状態が表示されなくなり、Claude はそのセッションにメッセージを送信できます。149* **`can't receive cross-session messages (off in that session)`**: そのセッションではメッセージ機能が[利用できない](#availability)か、その [`crossSessionInbound`](https://code.claude.com/docs/ja/settings-reference#crosssessioninbound) の値が `refuse` です。Claude Code は、メッセージがこのマシンから送出される前に、そのセッションへのメッセージを拒否します。Claude の `SendMessage` 呼び出しの結果は `Not sent` で始まり、理由が示されます。そのセッションで原因が解消されると、以降の一覧にはこの状態が表示されなくなり、Claude はそのセッションにメッセージを送れるようになります。

150 150 

151コンテナ内のセッションとホスト上のセッションは互いに到達できません。同じコンテナ内の 2 つのセッションは依然としてメッセージを送信できます。[セルフホストランナー](https://code.claude.com/docs/ja/self-hosted-environments) を含みます。WSL 2 内のセッションと同じコンピュータ上のネイティブ Windows セッションも互いに到達できません。151コンテナ内のセッションとホスト上のセッションは、互いに到達できません。同じコンテナ内の 2 つのセッションは、[セルフホストランナー](https://code.claude.com/docs/ja/self-hosted-environments)上を含め、引き続き互いにメッセージを送れます。同じコンピューター上の WSL 2 内のセッションとネイティブ Windows のセッションも、互いに到達できません。

152 152 

153このマシンを超えたメッセージが送信される前にユーザーの承認を要求するには、[`isolatePeerMachines`](#require-approval-for-cross-machine-messages) を設定します。153このマシンの外にメッセージが送られる前に必ず自分の承認を求めるようにするには、[`isolatePeerMachines`](#require-approval-for-cross-machine-messages) を設定します。

154 154 

155#### 他のマシンおよびクラウドセッションからの返信155#### 他のマシンやクラウドセッションからの返信

156 156 

157[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)（[セルフホストランナー](https://code.claude.com/docs/ja/self-hosted-environments) 上のものを含む）は、メッセージに [返信アドレス](#what-a-message-looks-like) が含まれている場合でも、`SendMessage` を使用して別のマシンからのメッセージに応答できません。メッセージ自体は到着します。クラウドセッションの応答は、[claude.ai/code](https://claude.ai/code) のトランスクリプトで確認してください。157[セルフホストランナー](https://code.claude.com/docs/ja/self-hosted-environments)上のものを含む[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)は、メッセージに[返信アドレス](#what-a-message-looks-like)が含まれていても、`SendMessage` を使って別のマシンからのメッセージに返信することはできません。メッセージ自体は届きます。クラウドセッションの応答は、[claude.ai/code](https://claude.ai/code) のトランスクリプトで確認してください。

158 158 

159Claude がこのマシンを超えたセッションに送信するときにこのセッションが Remote Control に接続されていない場合、メッセージは依然として送信されますが、[返信アドレス](#what-a-message-looks-like) は含まれません。受信側の Claude はそれに応答できません。159Claude がこのマシン以外のセッションに送信する際にこのセッションが Remote Control に接続していない場合、メッセージは送信されますが、[返信アドレス](#what-a-message-looks-like)は付きません。受信側の Claude はそのメッセージに返信できません。

160 160 

161## セッションが受信メッセージをどのように扱うか161## セッションが受信メッセージをどのように扱うか

162 162 

256 256 

257### ペインを最小化する257### ペインを最小化する

258 258 

259Terminal、Browser、または [iOS Simulator](https://code.claude.com/docs/ja/desktop-ios-simulator.md) を小さいサイズで表示したままにするには、ペインのヘッダーにある**Minimize**をクリックします。このボタンを使用するには、Claude Desktop v4.0.0 以降と、[サードパーティプロバイダー](https://code.claude.com/docs/ja/third-party-integrations.md)ではなく Claude アカウントが必要です。Browser ペインでは、ローカルセッションでのみこのボタンが表示されます。259Terminal、Browser、[iOS Simulator](https://code.claude.com/docs/ja/desktop-ios-simulator.md)、または[サイドチャット](#ask-a-side-question-without-derailing-the-session)を小さいサイズで表示したままにするには、ペインのヘッダーにある**Minimize**をクリックします。このボタンを使用するには、Claude Desktop v4.0.0 以降と、[サードパーティプロバイダー](https://code.claude.com/docs/ja/third-party-integrations.md)ではなく Claude アカウントが必要です。Browser ペインでは、ローカルセッションでのみこのボタンが表示されます。

260 260 

261最小化されたペインは、[セッション詳細パネル](#see-session-details)が画面に表示されている間はそのパネル内に配置され、それ以外の場合はチャットの隅にフローティング表示されます：261最小化されたペインは、[セッション詳細パネル](#see-session-details)が画面に表示されている間はそのパネル内に配置され、それ以外の場合はチャットの隅にフローティング表示されます：

262 262 

1380* **ワークフロー**：Desktop は新しい[ワークフロー](https://code.claude.com/docs/ja/workflows.md)をそれぞれ開始前にチェックするため、Desktop が切断されている間、新しいワークフローは最大 10 分間待機した後に失敗します1380* **ワークフロー**：Desktop は新しい[ワークフロー](https://code.claude.com/docs/ja/workflows.md)をそれぞれ開始前にチェックするため、Desktop が切断されている間、新しいワークフローは最大 10 分間待機した後に失敗します

1381* **MCP サーバー**：Claude Code がリモートマシンで起動する MCP サーバーは Desktop を経由しないため、Claude は引き続きそれらのツールを呼び出せます。`claude_desktop_config.json` のサーバーがこれに含まれるのは、Desktop が[組み込みの SSH クライアント](#worktree-edits-while-disconnected)を使用していない場合のみです。それ以外の場合、および[一部の Windows リモートマシン](#windows-remote-machines)では、Desktop が切断されている間、Claude はそれらのツールを呼び出せません。1381* **MCP サーバー**：Claude Code がリモートマシンで起動する MCP サーバーは Desktop を経由しないため、Claude は引き続きそれらのツールを呼び出せます。`claude_desktop_config.json` のサーバーがこれに含まれるのは、Desktop が[組み込みの SSH クライアント](#worktree-edits-while-disconnected)を使用していない場合のみです。それ以外の場合、および[一部の Windows リモートマシン](#windows-remote-machines)では、Desktop が切断されている間、Claude はそれらのツールを呼び出せません。

1382 1382 

1383> [accordion] worktree 内の編集が引き続き機能する場合1383> [accordion] worktree での編集が引き続き機能する場合

1384>1384>

1385> Linux または macOS のリモートマシンでは、チェックが Desktop を経由しないため、Desktop が切断されている間も worktree 内の編集は引き続き機能します。Claude Desktop v2.37337.0 より前では、これは Linux リモートマシンにのみ当てはまります。1385> Linux または macOS のリモートマシンでは、各編集のチェックを Desktop なしで実行できるため、Desktop の接続が切れている間も worktree 内の編集が引き続き機能することがあります。[Claude Desktop v2.37337.0](#check-your-version) より前は、これは Linux のリモートマシンでのみ機能します。

1386>1386>

1387> 次のような場合には、編集は引き続き失敗します：1387> 次のような場合には、編集は引き続き失敗します：

1388>1388>

2050 2050 

2051* **このマシン上のローカルセッション**：ディスクにデプロイされた管理設定ファイルが適用されます。管理コンソールを通じてリモートでプッシュされた管理設定は、セッションが[適格なログイン](https://code.claude.com/docs/ja/server-managed-settings.md#platform-availability)で認証する場合、Anthropic の API でこれらのセッションに到達します。ターミナル CLI と同じ[設定の優先順位](https://code.claude.com/docs/ja/settings.md#settings-precedence)に従います。2051* **このマシン上のローカルセッション**：ディスクにデプロイされた管理設定ファイルが適用されます。管理コンソールを通じてリモートでプッシュされた管理設定は、セッションが[適格なログイン](https://code.claude.com/docs/ja/server-managed-settings.md#platform-availability)で認証する場合、Anthropic の API でこれらのセッションに到達します。ターミナル CLI と同じ[設定の優先順位](https://code.claude.com/docs/ja/settings.md#settings-precedence)に従います。

2052* **[クラウドセッション](#cloud-sessions)**：[サーバー管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)を受け取ります。デバイスにデプロイされたファイルはこれらのセッションに到達しません。Anthropic が管理する VM で実行されるためです。[自己ホスト環境](https://code.claude.com/docs/ja/self-hosted-environments)にルーティングされたセッションは、ランナーイメージ内の管理設定ファイルも読み取ります。[Claude Code が管理ソースを組み合わせる方法](https://code.claude.com/docs/ja/managed-settings.md#how-claude-code-combines-managed-sources)は、そのファイルが適用される場合を示しています。2052* **[クラウドセッション](#cloud-sessions)**：[サーバー管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)を受け取ります。デバイスにデプロイされたファイルはこれらのセッションに到達しません。Anthropic が管理する VM で実行されるためです。[自己ホスト環境](https://code.claude.com/docs/ja/self-hosted-environments)にルーティングされたセッションは、ランナーイメージ内の管理設定ファイルも読み取ります。[Claude Code が管理ソースを組み合わせる方法](https://code.claude.com/docs/ja/managed-settings.md#how-claude-code-combines-managed-sources)は、そのファイルが適用される場合を示しています。

2053* **[SSH セッション](#ssh-sessions)**：セッションはリモートホストから管理設定ファイルを読み取ります。Desktop 自体は、ローカルマシン上で`sshConfigs`、`sshHostAllowlist`、`disableSshSavedPasswords`、および`disableDesktopLocalSessions`を読み取ります。複数の管理ソースを配信する場合、Desktop は[デフォルトではそのうち 1 つから](https://code.claude.com/docs/ja/managed-settings.md#how-claude-code-combines-managed-sources)これらを読み取ります。2053* **[SSH セッション](#ssh-sessions)**：セッションはリモートホストから管理設定ファイルを読み取ります。Desktop 自体は、ローカルマシン上で`sshConfigs`、`sshHostAllowlist`、`disableSshSavedPasswords`、および`disableDesktopLocalSessions`を読み取ります。複数の管理ソースを配信する場合、Desktop は[デフォルトではそのうち 1 つから](https://code.claude.com/docs/ja/managed-settings.md#how-claude-code-combines-managed-sources)これらを読み取ります。ローカルマシンで有効な管理設定で`permissions.disableBypassPermissionsMode`または`disableAutoMode`を設定すると、リモートホストの設定に関係なく、SSH セッションのモードセレクタにはそのモードが表示されません。

2054* **[Cowork](https://claude.com/docs/cowork/overview)セッション**：このマシン上の Cowork セッションでは、ユーザーが Team または Enterprise アカウントでサインインしている場合でも、Claude Code は管理コンソール設定をフェッチしません。マシンにデプロイされたポリシーを読み取ります。ただし、Claude Desktop 設定が`requireCoworkFullVmSandbox`を設定している場合を除きます。リモート Cowork セッションはどちらも受け取りません。[ポリシーが適用される場所と時期](https://code.claude.com/docs/ja/managed-settings.md#where-and-when-a-policy-applies)を参照して、どのデバイスファイルが Cowork に到達するかを確認してください。[MCP 権限ルール](https://code.claude.com/docs/ja/permissions.md#mcp)を参照して、`Bash`および`WebFetch`ルールが Cowork のツールにどのように適用されるかを確認してください。2054* **[Cowork](https://claude.com/docs/cowork/overview)セッション**：このマシン上の Cowork セッションでは、ユーザーが Team または Enterprise アカウントでサインインしている場合でも、Claude Code は管理コンソール設定をフェッチしません。マシンにデプロイされたポリシーを読み取ります。ただし、Claude Desktop 設定が`requireCoworkFullVmSandbox`を設定している場合を除きます。リモート Cowork セッションはどちらも受け取りません。[ポリシーが適用される場所と時期](https://code.claude.com/docs/ja/managed-settings.md#where-and-when-a-policy-applies)を参照して、どのデバイスファイルが Cowork に到達するかを確認してください。[MCP 権限ルール](https://code.claude.com/docs/ja/permissions.md#mcp)を参照して、`Bash`および`WebFetch`ルールが Cowork のツールにどのように適用されるかを確認してください。

2055 2055 

2056ローカルおよび SSH セッションでは、デスクトップアプリは各ユーザーの接続された claude.ai コネクタを Claude Code に直接配信します。MCP 設定または`managed-mcp.json`はこれらのコネクタに到達しません。使用する設定ソースまたはファイルの場所に関係なく。これらのセッションでコネクタのツールをブロックするには、組織の[コネクタツールコントロール](https://code.claude.com/docs/ja/mcp.md#organization-controls-on-connector-tools)を使用してください。[コネクタが Claude Code に到達する方法](https://code.claude.com/docs/ja/mcp.md#how-connectors-reach-claude-code)は、各種類のセッションでコネクタを管理する設定を示しています。2056ローカルおよび SSH セッションでは、デスクトップアプリは各ユーザーの接続された claude.ai コネクタを Claude Code に直接配信します。MCP 設定または`managed-mcp.json`はこれらのコネクタに到達しません。使用する設定ソースまたはファイルの場所に関係なく。これらのセッションでコネクタのツールをブロックするには、組織の[コネクタツールコントロール](https://code.claude.com/docs/ja/mcp.md#organization-controls-on-connector-tools)を使用してください。[コネクタが Claude Code に到達する方法](https://code.claude.com/docs/ja/mcp.md#how-connectors-reach-claude-code)は、各種類のセッションでコネクタを管理する設定を示しています。

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> iOS シミュレータペインは、macOS 上の Claude Code Desktop でパブリックベータ版です。Pro、Max、Ultra、Team、Enterprise プランで利用可能です。ただし、HIPAA 設定が有効になっている Enterprise 組織では利用できません。11> iOS シミュレータペインは、macOS 上の Claude Code Desktop でパブリックベータ版です。Pro、Max、Ultra、Team、Enterprise プランで利用可能です。ただし、HIPAA 設定が有効になっている Enterprise 組織では利用できません。[サードパーティプロバイダー](https://code.claude.com/docs/ja/third-party-integrations.md)を使用している場合は利用できません。

12 12 

13iOS シミュレータペインは、Claude Code Desktop の会話の横に Apple の iOS シミュレータで実行されているアプリを表示します。Claude がシミュレータでアプリをビルド、インストール、起動、またはチェックするときに、ペインが自動的に開き、デバイス画面がライブでストリーミングされます。Claude がアプリを実行してテストするのを見守ったり、Claude が作業を続けている間に自分でアプリをタップして操作したりできます。13iOS シミュレータペインは、Claude Code Desktop の会話の横に Apple の iOS シミュレータで実行されているアプリを表示します。Claude がシミュレータでアプリをビルド、インストール、起動、またはチェックするときに、ペインが自動的に開き、デバイス画面がライブでストリーミングされます。Claude がアプリを実行してテストするのを見守ったり、Claude が作業を続けている間に自分でアプリをタップして操作したりできます。

14 14 

147* 目標を明確に述べます。例えば「iOS シミュレータでアプリを実行し、サインアップフローをタップして操作してください」。147* 目標を明確に述べます。例えば「iOS シミュレータでアプリを実行し、サインアップフローをタップして操作してください」。

148* Xcode と iOS シミュレータがインストールされており、Xcode バージョンが [要件](#requirements)を満たしていることを確認します。148* Xcode と iOS シミュレータがインストールされており、Xcode バージョンが [要件](#requirements)を満たしていることを確認します。

149* 組織が Claude Code を管理している場合、[シミュレータツールはポリシーによって無効にされている可能性があります](#turn-off-simulator-access)。149* 組織が Claude Code を管理している場合、[シミュレータツールはポリシーによって無効にされている可能性があります](#turn-off-simulator-access)。

150* Enterprise 組織で HIPAA 設定が有効になっている場合、シミュレータペインは利用できません。150* Enterprise 組織で HIPAA 設定が有効になっている場合、または[サードパーティプロバイダー](https://code.claude.com/docs/ja/third-party-integrations.md)を使用している場合、シミュレータペインは利用できません。

151* シミュレータペインには Claude Desktop v1.24012.0 以降が必要です。**Claude > Check for Updates…** を開き、アプリを再起動します。151* シミュレータペインには Claude Desktop v1.24012.0 以降が必要です。**Claude > Check for Updates…** を開き、アプリを再起動します。

152 152 

153### シミュレータペインにシミュレータが見つからないと表示される153### シミュレータペインにシミュレータが見つからないと表示される

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

205| `CLAUDE_CODE_ARTIFACT_COMMENTS` | `0` に設定すると、Claude が[アーティファクトへのコメント](https://code.claude.com/docs/ja/artifacts.md#collect-comments-on-an-artifact)を読んで返信しないようにします。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` によって[アーティファクトがオフになっている](https://code.claude.com/docs/ja/artifacts.md#availability)場合は効果がありません。Claude Code v2.1.221 以降が必要です |205| `CLAUDE_CODE_ARTIFACT_COMMENTS` | `0` に設定すると、Claude が[アーティファクトへのコメント](https://code.claude.com/docs/ja/artifacts.md#collect-comments-on-an-artifact)を読んで返信しないようにします。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` によって[アーティファクトがオフになっている](https://code.claude.com/docs/ja/artifacts.md#availability)場合は効果がありません。Claude Code v2.1.221 以降が必要です |

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

207| `CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS` | `0` に設定すると、Claude が[アーティファクト](https://code.claude.com/docs/ja/artifacts.md#update-an-artifact)の公開処理の一環としてファイルに小さな変更を適用しないようにします。その場合、Claude はファイル編集ツールでファイルを編集し、別のステップとして公開します。Claude Code v2.1.300 以降が必要です |207| `CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS` | `0` に設定すると、Claude がアーティファクトの公開の一環として、アーティファクトのファイルに [小さな変更を適用する](https://code.claude.com/docs/ja/artifacts.md#turn-off-one-step-artifact-updates) ことを停止します。その場合、Claude はファイル編集ツールでファイルを編集し、別のステップとして公開します。Claude Code v2.1.300 以降が必要です |

208| `CLAUDE_CODE_ATTRIBUTION_HEADER` | `0` に設定すると、クライアントのバージョンとプロンプトのフィンガープリントを含む[帰属ブロック](https://code.claude.com/docs/ja/llm-gateway-protocol.md#system-prompt-attribution-block)を、システムプロンプトの先頭から省略します。Anthropic API への直接接続でのキャッシュは、どちらの場合も影響を受けません。一部の直接接続構成では、`0` を設定した場合でも、Claude Code は [auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)の分類器リクエストでブロックを保持します。どの接続と認証情報が対象になるかは、[システムプロンプトの帰属ブロック](https://code.claude.com/docs/ja/llm-gateway-protocol.md#system-prompt-attribution-block)で確認してください。v2.1.181 より前は、カスタムベース URL と Microsoft Foundry の接続ではブロックにリクエストごとのトークンが含まれていました。そのため、それらのバージョンでは、LLM ゲートウェイがリクエストボディに基づいてキャッシュする場合、リクエストをサードパーティプロバイダーに転送する場合、または Microsoft Foundry に直接接続する場合に `0` に設定してください |208| `CLAUDE_CODE_ATTRIBUTION_HEADER` | `0` に設定すると、クライアントのバージョンとプロンプトのフィンガープリントを含む[帰属ブロック](https://code.claude.com/docs/ja/llm-gateway-protocol.md#system-prompt-attribution-block)を、システムプロンプトの先頭から省略します。Anthropic API への直接接続でのキャッシュは、どちらの場合も影響を受けません。一部の直接接続構成では、`0` を設定した場合でも、Claude Code は [auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)の分類器リクエストでブロックを保持します。どの接続と認証情報が対象になるかは、[システムプロンプトの帰属ブロック](https://code.claude.com/docs/ja/llm-gateway-protocol.md#system-prompt-attribution-block)で確認してください。v2.1.181 より前は、カスタムベース URL と Microsoft Foundry の接続ではブロックにリクエストごとのトークンが含まれていました。そのため、それらのバージョンでは、LLM ゲートウェイがリクエストボディに基づいてキャッシュする場合、リクエストをサードパーティプロバイダーに転送する場合、または Microsoft Foundry に直接接続する場合に `0` に設定してください |

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

210| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 自動圧縮ウィンドウ（圧縮前にコンテキストがどこまで埋まるか）を `100000` から `1000000` トークンの範囲で設定します。`200k` などのサフィックス付きの値には v2.1.304 以降が必要です。ウィンドウを設定する他の方法との優先順位と、ステータスラインの `used_percentage` への影響については、[自動圧縮ウィンドウを設定する](https://code.claude.com/docs/ja/model-config.md#set-the-auto-compact-window)を参照してください |210| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 自動圧縮ウィンドウ（圧縮前にコンテキストがどこまで埋まるか）を `100000` から `1000000` トークンの範囲で設定します。`200k` などのサフィックス付きの値には v2.1.304 以降が必要です。ウィンドウを設定する他の方法との優先順位と、ステータスラインの `used_percentage` への影響については、[自動圧縮ウィンドウを設定する](https://code.claude.com/docs/ja/model-config.md#set-the-auto-compact-window)を参照してください |

502| `OTEL_LOG_TOOL_CONTENT` | `1` に設定すると、`tool.output` OpenTelemetry スパンイベントにツールのコンテンツを含めます。スパン属性は[独自のゲート](https://code.claude.com/docs/ja/monitoring-usage.md#new-context-gates)のもとでツールのコンテンツを保持します。[トレーシング](https://code.claude.com/docs/ja/monitoring-usage.md#traces-beta)が必要です。機密データを保護するため、デフォルトでは無効です。シェル、ユーザー設定、または管理設定で設定します。[プロジェクト設定とローカル設定](https://code.claude.com/docs/ja/settings-reference.md#variables-claude-code-ignores-in-env)では、そのセクションで説明されているオフの値を除き、無視されます。[モニタリング](https://code.claude.com/docs/ja/monitoring-usage.md#tool-output-span-event)を参照してください |502| `OTEL_LOG_TOOL_CONTENT` | `1` に設定すると、`tool.output` OpenTelemetry スパンイベントにツールのコンテンツを含めます。スパン属性は[独自のゲート](https://code.claude.com/docs/ja/monitoring-usage.md#new-context-gates)のもとでツールのコンテンツを保持します。[トレーシング](https://code.claude.com/docs/ja/monitoring-usage.md#traces-beta)が必要です。機密データを保護するため、デフォルトでは無効です。シェル、ユーザー設定、または管理設定で設定します。[プロジェクト設定とローカル設定](https://code.claude.com/docs/ja/settings-reference.md#variables-claude-code-ignores-in-env)では、そのセクションで説明されているオフの値を除き、無視されます。[モニタリング](https://code.claude.com/docs/ja/monitoring-usage.md#tool-output-span-event)を参照してください |

503| `OTEL_LOG_TOOL_DETAILS` | `1` に設定すると、ツールの入力引数、MCP サーバー名、ユーザーが作成したワークフロー名、ツール失敗時の生のエラー文字列、`api_refusal` イベントの拒否 `category`、[コストとトークンのメトリクス](https://code.claude.com/docs/ja/monitoring-usage.md#cost-counter)における実際のエージェント、スキル、プラグイン、MCP サーバーの名前、およびその他のツールの詳細を、OpenTelemetry のメトリクス、トレース、ログに含めます。PII を保護するため、デフォルトでは無効です。シェル、ユーザー設定、または管理設定で設定します。[プロジェクト設定とローカル設定](https://code.claude.com/docs/ja/settings-reference.md#variables-claude-code-ignores-in-env)では、そのセクションで説明されているオフの値を除き、無視されます。[モニタリング](https://code.claude.com/docs/ja/monitoring-usage.md)を参照してください |503| `OTEL_LOG_TOOL_DETAILS` | `1` に設定すると、ツールの入力引数、MCP サーバー名、ユーザーが作成したワークフロー名、ツール失敗時の生のエラー文字列、`api_refusal` イベントの拒否 `category`、[コストとトークンのメトリクス](https://code.claude.com/docs/ja/monitoring-usage.md#cost-counter)における実際のエージェント、スキル、プラグイン、MCP サーバーの名前、およびその他のツールの詳細を、OpenTelemetry のメトリクス、トレース、ログに含めます。PII を保護するため、デフォルトでは無効です。シェル、ユーザー設定、または管理設定で設定します。[プロジェクト設定とローカル設定](https://code.claude.com/docs/ja/settings-reference.md#variables-claude-code-ignores-in-env)では、そのセクションで説明されているオフの値を除き、無視されます。[モニタリング](https://code.claude.com/docs/ja/monitoring-usage.md)を参照してください |

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

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

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

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

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

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

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

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

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

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

104| `Failed to authenticate: OAuth session expired and could not be refreshed` | [認証](#login-expired) |104| `Failed to authenticate: OAuth session expired and could not be refreshed` | [認証](#login-expired) |

105| `Could not refresh your login because another Claude Code process is refreshing it` | [認証](#could-not-refresh-your-login) |105| `Could not refresh your login because another Claude Code process is refreshing it` | [認証](#could-not-refresh-your-login) |

106| `Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh` | [認証](#could-not-refresh-your-login) |106| `Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh` | [認証](#could-not-refresh-your-login) |

107| `Could not refresh your login: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full` | [認証](#could-not-refresh-your-login-disk-full) |

108| `Failed to refresh OAuth token: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full` | [認証](#could-not-refresh-your-login-disk-full) |

107| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [認証](#your-account-is-on-hold) |109| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [認証](#your-account-is-on-hold) |

108| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [認証](#your-account-is-on-hold) |110| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [認証](#your-account-is-on-hold) |

109| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [認証](#anthropic-profile-login-expired) |111| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [認証](#anthropic-profile-login-expired) |

242| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [コマンドラインエラー](#the-current-directory-no-longer-exists) |244| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [コマンドラインエラー](#the-current-directory-no-longer-exists) |

243| `Temp directory <dir> ... Refusing to use it` / `Claude Code's temporary directory <dir> could not be created` | [コマンドラインエラー](#temp-directory-refused-or-cannot-be-created) |245| `Temp directory <dir> ... Refusing to use it` / `Claude Code's temporary directory <dir> could not be created` | [コマンドラインエラー](#temp-directory-refused-or-cannot-be-created) |

244| `ENOSPC: no space left on device, mkdir '<dir>'` | [コマンドラインエラー](#temp-directory-refused-or-cannot-be-created) |246| `ENOSPC: no space left on device, mkdir '<dir>'` | [コマンドラインエラー](#temp-directory-refused-or-cannot-be-created) |

247| `Error: Claude Code could not save ... because the disk is full (ENOSPC)` / `because your disk quota is used up (EDQUOT)` | [コマンドラインエラー](#could-not-save-because-the-disk-is-full) |

245| `couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded` | [コマンドラインエラー](#directory-couldnt-be-resolved-to-a-real-location) |248| `couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded` | [コマンドラインエラー](#directory-couldnt-be-resolved-to-a-real-location) |

246| `Error: Workspace not trusted` when starting Remote Control | [コマンドラインエラー](#workspace-not-trusted-when-starting-remote-control) |249| `Error: Workspace not trusted` when starting Remote Control | [コマンドラインエラー](#workspace-not-trusted-when-starting-remote-control) |

247| `claude ultrareview` の実行時に表示される `Error: Workspace not trusted` | [コマンドラインエラー](#workspace-not-trusted-when-running-claude-ultrareview) |250| `claude ultrareview` の実行時に表示される `Error: Workspace not trusted` | [コマンドラインエラー](#workspace-not-trusted-when-running-claude-ultrareview) |

248| `Ultrareview did not start` | [コマンドラインエラー](#ultrareview-did-not-start) |251| `Ultrareview did not start` | [コマンドラインエラー](#ultrareview-did-not-start) |

252| `Remote Control did not start: "<question>" got no answer` | [コマンドラインエラー](#remote-control-did-not-start-got-no-answer) |

249| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [コマンドラインエラー](#not-carried-over-to-the-sessions-remote-control-starts) |253| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [コマンドラインエラー](#not-carried-over-to-the-sessions-remote-control-starts) |

250| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [コマンドラインエラー](#sandbox-is-not-supported-by-claude-remote-control) |254| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [コマンドラインエラー](#sandbox-is-not-supported-by-claude-remote-control) |

251| `` `claude import` is not yet available in this build `` | [コマンドラインエラー](#claude-import-is-not-yet-available-in-this-build) |255| `` `claude import` is not yet available in this build `` | [コマンドラインエラー](#claude-import-is-not-yet-available-in-this-build) |

320| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [プラグインのトラブルシューティング](https://code.claude.com/docs/ja/plugins/troubleshooting.md#the-packages-it-lists-are-not-installed) |324| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [プラグインのトラブルシューティング](https://code.claude.com/docs/ja/plugins/troubleshooting.md#the-packages-it-lists-are-not-installed) |

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

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

327| `path not read: <path> is absolute or has a ".." part` | [プラグインエラー](#server-file-path-not-read) |

323| `Plugin not loaded: its manifest <path> was not read` | [プラグインエラー](#plugin-not-loaded-its-manifest-was-not-read) |328| `Plugin not loaded: its manifest <path> was not read` | [プラグインエラー](#plugin-not-loaded-its-manifest-was-not-read) |

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

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

368| `Refusing to write <path>: where it leads on disk could not be determined` / `Refusing to read <path>: where it leads on disk could not be determined` | [ツールエラー](#refusing-after-a-symlink-changed) |373| `Refusing to write <path>: where it leads on disk could not be determined` / `Refusing to read <path>: where it leads on disk could not be determined` | [ツールエラー](#refusing-after-a-symlink-changed) |

369| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [ツールエラー](#refusing-after-a-symlink-changed) |374| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [ツールエラー](#refusing-after-a-symlink-changed) |

370| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [ツールエラー](#refusing-after-a-symlink-changed) |375| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [ツールエラー](#refusing-after-a-symlink-changed) |

376| `The search failed, so this is not a "no matches" result: matches may exist` | [ツールエラー](#the-search-failed) |

371| `task output swap refused (tasks dir moved or linked)` | [ツールエラー](#task-output-swap-refused) |377| `task output swap refused (tasks dir moved or linked)` | [ツールエラー](#task-output-swap-refused) |

372| `Command killed: its output file was replaced or could no longer be verified` | [ツールエラー](#task-output-swap-refused) |378| `Command killed: its output file was replaced or could no longer be verified` | [ツールエラー](#task-output-swap-refused) |

373| `Disk full: this computer's volume holding <dir> (Claude Code's temporary directory) has <n> MB free` / `Nearly out of inodes: this computer's volume holding <dir>` | [ツールエラー](#disk-quota-or-temp-filesystem-is-full) |379| `Disk full: this computer's volume holding <dir> (Claude Code's temporary directory) has <n> MB free` / `Nearly out of inodes: this computer's volume holding <dir>` | [ツールエラー](#disk-quota-or-temp-filesystem-is-full) |

377| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [ツールエラー](#disk-quota-or-temp-filesystem-is-full) |383| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [ツールエラー](#disk-quota-or-temp-filesystem-is-full) |

378| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [ツールエラー](#file-is-not-valid-utf-8) |384| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [ツールエラー](#file-is-not-valid-utf-8) |

379| `git is not installed on this Mac. To install it, run xcode-select --install, then try again.` | [ツールエラー](#git-is-not-installed-on-this-mac) |385| `git is not installed on this Mac. To install it, run xcode-select --install, then try again.` | [ツールエラー](#git-is-not-installed-on-this-mac) |

386| `Refusing to apply edits to <path>: a hook is configured for file edits in this session` | [ツールエラー](#a-hook-is-configured-for-file-edits) |

380| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [ツールエラー](#the-source-file-is-not-valid-utf-8-text) |387| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [ツールエラー](#the-source-file-is-not-valid-utf-8-text) |

381| `the source file has the replacement character U+FFFD` | [ツールエラー](#the-source-file-is-not-valid-utf-8-text) |388| `the source file has the replacement character U+FFFD` | [ツールエラー](#the-source-file-is-not-valid-utf-8-text) |

382| `Not published: that file is on a network share` | [ツールエラー](#not-published-that-file-is-on-a-network-share) |389| `Not published: that file is on a network share` | [ツールエラー](#not-published-that-file-is-on-a-network-share) |

387| `The safety check for domain ... is rate-limited` | [ツールエラー](#webfetch-domain-safety-check-failed) |394| `The safety check for domain ... is rate-limited` | [ツールエラー](#webfetch-domain-safety-check-failed) |

388| `The safety check for domain ... is temporarily rate-limited` | [ツールエラー](#webfetch-domain-safety-check-failed) |395| `The safety check for domain ... is temporarily rate-limited` | [ツールエラー](#webfetch-domain-safety-check-failed) |

389| `Unable to verify if domain ... is safe to fetch` | [ツールエラー](#webfetch-domain-safety-check-failed) |396| `Unable to verify if domain ... is safe to fetch` | [ツールエラー](#webfetch-domain-safety-check-failed) |

397| `MCP tool "<tool>" on server "<server>" gave no answer that could be read` / `answered without its text` | [MCP ツールフックの結果の読み取り方](https://code.claude.com/docs/ja/hooks.md#how-the-tools-result-is-read) |

390| `Can't open MCP settings while no terminal is attached to this background session` | [バックグラウンドセッションエラー](#commands-refused-in-a-background-session) |398| `Can't open MCP settings while no terminal is attached to this background session` | [バックグラウンドセッションエラー](#commands-refused-in-a-background-session) |

391| `Can't open MCP settings in a background session` | [バックグラウンドセッションエラー](#commands-refused-in-a-background-session) |399| `Can't open MCP settings in a background session` | [バックグラウンドセッションエラー](#commands-refused-in-a-background-session) |

392| `blocked because the path is spelled in a form that cannot be safely resolved` | [バックグラウンドセッションエラー](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |400| `blocked because the path is spelled in a form that cannot be safely resolved` | [バックグラウンドセッションエラー](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |

397| `Can't open — this session is running in another terminal` | [バックグラウンドセッションエラー](#this-session-is-running-in-another-terminal) |405| `Can't open — this session is running in another terminal` | [バックグラウンドセッションエラー](#this-session-is-running-in-another-terminal) |

398| `This conversation is already open in another running Claude session` | [バックグラウンドセッションエラー](#this-session-is-running-in-another-terminal) |406| `This conversation is already open in another running Claude session` | [バックグラウンドセッションエラー](#this-session-is-running-in-another-terminal) |

399| `This session's saved conversation is no longer on disk` | [バックグラウンドセッションエラー](#this-sessions-saved-conversation-is-no-longer-on-disk) |407| `This session's saved conversation is no longer on disk` | [バックグラウンドセッションエラー](#this-sessions-saved-conversation-is-no-longer-on-disk) |

408| `This forked session could not be started. Fork the conversation again to retry.` | [バックグラウンドセッションのエラー](#this-forked-session-could-not-be-started) |

400| `Bypass permissions was requested at launch and ignored` | [バックグラウンドセッションで Bypass permissions が無視される](https://code.claude.com/docs/ja/permission-modes.md#bypass-permissions-ignored-in-a-background-session) |409| `Bypass permissions was requested at launch and ignored` | [バックグラウンドセッションで Bypass permissions が無視される](https://code.claude.com/docs/ja/permission-modes.md#bypass-permissions-ignored-in-a-background-session) |

401| `kept <id> — its worktree is still at <path>` | メッセージの次の行にプッシュされていないコミットへの言及がある場合は [バックグラウンドセッションのエラー](#worktree-has-commits-that-are-not-pushed-anywhere)、それ以外の場合は [セッションを削除すると何が削除されるか](https://code.claude.com/docs/ja/agent-view.md#what-deleting-a-session-removes) |410| `kept <id> — its worktree is still at <path>` | メッセージの次の行にプッシュされていないコミットへの言及がある場合は [バックグラウンドセッションのエラー](#worktree-has-commits-that-are-not-pushed-anywhere)、それ以外の場合は [セッションを削除すると何が削除されるか](https://code.claude.com/docs/ja/agent-view.md#what-deleting-a-session-removes) |

402| `kept <id> — <n> unpushed commits on <branch>` | [バックグラウンドセッションエラー](#worktree-has-commits-that-are-not-pushed-anywhere) |411| `kept <id> — <n> unpushed commits on <branch>` | [バックグラウンドセッションエラー](#worktree-has-commits-that-are-not-pushed-anywhere) |

548| [`CLAUDE_CODE_MAX_RETRIES`](https://code.claude.com/docs/ja/env-vars) | 10 | 再試行の回数。v2.1.186 以降では上限は 15 です。v2.1.199 以降では、`CLAUDE_CODE_RETRY_WATCHDOG` によってデフォルトが引き上げられ、上限が撤廃されます。スクリプトで障害をより早く表面化させるには、値を下げてください。 |557| [`CLAUDE_CODE_MAX_RETRIES`](https://code.claude.com/docs/ja/env-vars) | 10 | 再試行の回数。v2.1.186 以降では上限は 15 です。v2.1.199 以降では、`CLAUDE_CODE_RETRY_WATCHDOG` によってデフォルトが引き上げられ、上限が撤廃されます。スクリプトで障害をより早く表面化させるには、値を下げてください。 |

549| [`CLAUDE_CODE_RETRY_WATCHDOG`](https://code.claude.com/docs/ja/env-vars) | 未設定 | CI ジョブなどの無人セッションで `1` に設定すると、`429` および `529` の容量エラーを、`CLAUDE_CODE_MAX_RETRIES` 回の試行後に失敗させる代わりに無期限に再試行します。標準速度のリクエストが支出上限または使用クレジットの枯渇を報告する `429` を受け取った場合、スケジュールに従ってリセットされる[ゲートウェイの支出上限](#spend-limit-reached)によるものであっても、Claude Code は即座に失敗します。v2.1.239 より前は、ウォッチドッグはこれらを無期限に再試行していました。fast mode のリクエストについては、[Handle rate limits](https://code.claude.com/docs/ja/fast-mode.md#handle-rate-limits) を参照してください。v2.1.199 以降では、サーバーエラー、タイムアウト、切断された接続など、その他の一時的なエラーのデフォルトの再試行回数も 300 (約 3 時間分のバックオフ) に引き上げられ、`CLAUDE_CODE_MAX_RETRIES` を明示的に設定した場合の上限 15 も撤廃されます。 |558| [`CLAUDE_CODE_RETRY_WATCHDOG`](https://code.claude.com/docs/ja/env-vars) | 未設定 | CI ジョブなどの無人セッションで `1` に設定すると、`429` および `529` の容量エラーを、`CLAUDE_CODE_MAX_RETRIES` 回の試行後に失敗させる代わりに無期限に再試行します。標準速度のリクエストが支出上限または使用クレジットの枯渇を報告する `429` を受け取った場合、スケジュールに従ってリセットされる[ゲートウェイの支出上限](#spend-limit-reached)によるものであっても、Claude Code は即座に失敗します。v2.1.239 より前は、ウォッチドッグはこれらを無期限に再試行していました。fast mode のリクエストについては、[Handle rate limits](https://code.claude.com/docs/ja/fast-mode.md#handle-rate-limits) を参照してください。v2.1.199 以降では、サーバーエラー、タイムアウト、切断された接続など、その他の一時的なエラーのデフォルトの再試行回数も 300 (約 3 時間分のバックオフ) に引き上げられ、`CLAUDE_CODE_MAX_RETRIES` を明示的に設定した場合の上限 15 も撤廃されます。 |

550| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](https://code.claude.com/docs/ja/env-vars) | 未設定 | `CLAUDE_CODE_RETRY_WATCHDOG` が設定されている場合に、各 API リクエストが `429` および `529` エラーの解消を待つのに費やす最大時間。単位はミリ秒です。未設定の場合、待機時間に制限はありません。Claude Code v2.1.295 以降が必要です。 |559| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](https://code.claude.com/docs/ja/env-vars) | 未設定 | `CLAUDE_CODE_RETRY_WATCHDOG` が設定されている場合に、各 API リクエストが `429` および `529` エラーの解消を待つのに費やす最大時間。単位はミリ秒です。未設定の場合、待機時間に制限はありません。Claude Code v2.1.295 以降が必要です。 |

560| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS` | 上限なし | `CLAUDE_CODE_RETRY_WATCHDOG` が設定されている場合に、1 つのリクエストがプランの[使用制限](#youve-hit-your-session-limit)（セッション制限や週間制限など）のリセットを待つ最長時間。単位はミリ秒です。リセットまでの時間がこの上限より長い場合、リクエストは即座に失敗します。ただし、使用クレジットに余裕がある場合、または API がそれを確認できなかった場合は除きます。それらの場合はリクエストが再試行され、成功する前に上限の時間を過ぎると失敗します。Claude Code v2.1.301 以降が必要です。 |

551| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](https://code.claude.com/docs/ja/env-vars) | 未設定 | `CLAUDE_CODE_RETRY_WATCHDOG` が設定された状態でリクエストが[使用制限](#youve-hit-your-session-limit)のリセットを待っている間に、その制限がすでに解除されたかどうかを確認する間隔の最小値 (ミリ秒)。確認で制限の解除が判明した場合、リクエストは即座に送信されます。`60000` から `10800000` までの数字のみで指定してください。未設定の場合、またはその範囲外の場合は、確認は行われません。Claude Code がこれらの確認をスキップする場合については、[環境変数リファレンス](https://code.claude.com/docs/ja/env-vars.md)を参照してください。Claude Code v2.1.305 以降が必要です。 |561| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](https://code.claude.com/docs/ja/env-vars) | 未設定 | `CLAUDE_CODE_RETRY_WATCHDOG` が設定された状態でリクエストが[使用制限](#youve-hit-your-session-limit)のリセットを待っている間に、その制限がすでに解除されたかどうかを確認する間隔の最小値 (ミリ秒)。確認で制限の解除が判明した場合、リクエストは即座に送信されます。`60000` から `10800000` までの数字のみで指定してください。未設定の場合、またはその範囲外の場合は、確認は行われません。Claude Code がこれらの確認をスキップする場合については、[環境変数リファレンス](https://code.claude.com/docs/ja/env-vars.md)を参照してください。Claude Code v2.1.305 以降が必要です。 |

552| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/ja/env-vars) | 500 | API が `529` 過負荷エラーで拒否したリクエストの再試行間のバックオフにおける、開始時の遅延 (ミリ秒)。API が容量の上限に達している場合に、再試行をより長い期間に分散させるには、最大 32000 まで値を引き上げてください。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](https://code.claude.com/docs/ja/fast-mode.md#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.292 以降が必要です。 |562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/ja/env-vars) | 500 | API が `529` 過負荷エラーで拒否したリクエストの再試行間のバックオフにおける、開始時の遅延 (ミリ秒)。API が容量の上限に達している場合に、再試行をより長い期間に分散させるには、最大 32000 まで値を引き上げてください。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](https://code.claude.com/docs/ja/fast-mode.md#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.292 以降が必要です。 |

553| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/ja/env-vars) | 32000 | API が `529` 過負荷エラーで拒否したリクエストの再試行間のバックオフにおける、遅延の上限 (ミリ秒)。API が容量の上限に達している場合に、後の再試行の間隔が引き続き広がるようにするには、最大 64000 まで値を引き上げてください。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](https://code.claude.com/docs/ja/fast-mode.md#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.296 以降が必要です。 |563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/ja/env-vars) | 32000 | API が `529` 過負荷エラーで拒否したリクエストの再試行間のバックオフにおける、遅延の上限 (ミリ秒)。API が容量の上限に達している場合に、後の再試行の間隔が引き続き広がるようにするには、最大 64000 まで値を引き上げてください。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](https://code.claude.com/docs/ja/fast-mode.md#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.296 以降が必要です。 |

1436 1446 

1437これは [OAuth トークンが取り消された、または期限切れです](#oauth-token-revoked-or-expired)とは異なる状態です。そちらのメッセージは API が返した拒否を報告します。`Login expired` は、すでに更新に失敗したログインに対して Claude Code 自身が生成するものであり、リクエストは送信されません。ログインが古くなったのではなくアカウント自体が停止されているために更新が失敗した場合、Claude Code は代わりに[アカウントが保留中です](#your-account-is-on-hold)を表示します。1447これは [OAuth トークンが取り消された、または期限切れです](#oauth-token-revoked-or-expired)とは異なる状態です。そちらのメッセージは API が返した拒否を報告します。`Login expired` は、すでに更新に失敗したログインに対して Claude Code 自身が生成するものであり、リクエストは送信されません。ログインが古くなったのではなくアカウント自体が停止されているために更新が失敗した場合、Claude Code は代わりに[アカウントが保留中です](#your-account-is-on-hold)を表示します。

1438 1448 

1439API キー、[`CLAUDE_CODE_OAUTH_TOKEN`](https://code.claude.com/docs/ja/env-vars)、またはサードパーティプロバイダーで認証されたセッションは保存済みのログインを使用しないため、このメッセージが表示されることはありません。

1440 

1441リクエストが失敗する前にこの状態を確認できます。[`/status`](https://code.claude.com/docs/ja/commands) には、`Expired — log in again` と表示される `Login` 行と、期限切れのログインについて保存されている組織とメールアドレスが表示されます。この行は、保存済みのログインが有効な認証情報であり、かつ更新できなくなった場合にのみ表示されます。別の方法で認証されたセッションでは、期限切れのログインが保存されたままでも、この行は表示されません。v2.1.210 より前では、認証情報が消去されて報告する内容がなくなるため、この状態の `/status` にはログインが存在していたことを示すものが何も表示されませんでした。1449リクエストが失敗する前にこの状態を確認できます。[`/status`](https://code.claude.com/docs/ja/commands) には、`Expired — log in again` と表示される `Login` 行と、期限切れのログインについて保存されている組織とメールアドレスが表示されます。この行は、保存済みのログインが有効な認証情報であり、かつ更新できなくなった場合にのみ表示されます。別の方法で認証されたセッションでは、期限切れのログインが保存されたままでも、この行は表示されません。v2.1.210 より前では、認証情報が消去されて報告する内容がなくなるため、この状態の `/status` にはログインが存在していたことを示すものが何も表示されませんでした。

1442 1450 

1443**対処方法：**1451**対処方法：**

1461Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again1469Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again

1462```1470```

1463 1471 

1464API キー、[`CLAUDE_CODE_OAUTH_TOKEN`](https://code.claude.com/docs/ja/env-vars)、またはサードパーティプロバイダーで認証されたセッションは保存済みのログインを使用しないため、このメッセージが表示されることはありません。

1465 

1466**対処方法：**1472**対処方法：**

1467 1473 

1468* 1 分後に再試行します。別のプロセスが先に更新を完了した場合、このセッションは更新されたログインを使用します。1474* 1 分後に再試行します。別のプロセスが先に更新を完了した場合、このセッションは更新されたログインを使用します。

1469* メッセージが繰り返し表示される場合は、他の Claude Code ウィンドウとプロセスを閉じてから再試行します。1475* メッセージが繰り返し表示される場合は、他の Claude Code ウィンドウとプロセスを閉じてから再試行します。

1470* 他に Claude Code プロセスが実行されていないのにメッセージが表示される場合は、`/login` を実行します。再度サインインする場合は、更新ロックを待機しません。1476* 他に Claude Code プロセスが実行されていないのにメッセージが表示される場合は、`/login` を実行します。再度サインインする場合は、更新ロックを待機しません。

1471 1477 

1478### Could not refresh your login: the disk that holds the Claude Code config directory is full

1479 

1480Claude Code の設定ディレクトリがあるディスクの空き容量を確保してから、メッセージを再送信してください。ディスクがいっぱいの間は新しいログインを保存できないため、サインインしても解決しません。[`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ja/env-vars) を設定していない限り、設定ディレクトリはホームディレクトリの `~/.claude` です。

1481 

1482```text wrap theme={null}

1483Could not refresh your login: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full · Delete files you no longer need on that disk, then try again · Signing in again won't help

1484```

1485 

1486[非対話モード](https://code.claude.com/docs/ja/headless.md)（`-p`）と [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) では、メッセージは次のようになります：

1487 

1488```text wrap theme={null}

1489Failed to refresh OAuth token: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full. Delete files you no longer need on that disk and retry; signing in again won't help

1490```

1491 

1492**対処方法：**

1493 

1494* スクリプトの場合は、その `claude -p` コマンドを再実行します

1495* ディスクにすでに空き容量がある場合でも、ディスククォータまたは inode が不足していると同じメッセージが表示されます。そのディスク上の自分のファイルを削除してください。メッセージが再び表示される場合は、サイズに関係なく各ファイルが 1 つの inode を使用するため、少数の大きなファイルではなく多数の小さなファイルを削除します。

1496 

1472### ログインを保存できませんでした1497### ログインを保存できませんでした

1473 1498 

1474claude.ai でサインインしましたが、Claude Code がログインを認証情報ストアに保存できなかったため、ログインが完了しませんでした。macOS では、同じセッション中に Claude Code がすでにログインキーチェーンの認証情報を読み取りまたは保存した後で、スリープやアイドルなどによってキーチェーンがロックされた場合に発生することがあります。1499claude.ai でサインインしましたが、Claude Code がログインを認証情報ストアに保存できなかったため、ログインが完了しませんでした。macOS では、同じセッション中に Claude Code がすでにログインキーチェーンの認証情報を読み取りまたは保存した後で、スリープやアイドルなどによってキーチェーンがロックされた場合に発生することがあります。

2442 2467 

2443### コンテキストがトークン制限を超えています2468### コンテキストがトークン制限を超えています

2444 2469 

2445`/context` は、会話がモデルのコンテキストウィンドウを超えて成長した場合、出力の上部にこの警告を表示します。スペースを解放するまで、リクエストは [`Prompt is too long`](#prompt-is-too-long) で失敗します。対話セッションはそのエラーを `Context limit reached` 行として表示します。2470会話がモデルのコンテキストウィンドウを超えて大きくなると、`/context` は出力の先頭にこの警告を表示します。

2446 2471 

2447```text theme={null}2472```text theme={null}

2448Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.2473Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.

2449```2474```

2450 2475 

2476`Context exceeds` の警告が表示された後、[自動圧縮](https://code.claude.com/docs/ja/settings-reference.md#autocompactenabled)がオン（デフォルト）であれば、どちらのコマンドも実行する必要はありません。

2477 

2478* **自動圧縮がオンの場合**: 次のメッセージを送信します。それでも [`Prompt is too long`](#prompt-is-too-long) で失敗する場合は、その項目を参照してください。

2479* **自動圧縮がオフの場合**: セッション内で、警告に `/compact` が示されていればそれを実行するか、`/clear` を実行して最初からやり直します。どちらかを実行するまで、メッセージは `Context limit reached`（`-p` の出力では `Prompt is too long`）で失敗します。

2480 

2451超過した制限が 1M コンテキストモデルの 200K 境界などの圧縮ウィンドウである場合、警告は異なる表現になります。圧縮ウィンドウはモデルのコンテキストウィンドウより小さい場合があるため、それを超えたリクエストでも成功する可能性があります。2481超過した制限が 1M コンテキストモデルの 200K 境界などの圧縮ウィンドウである場合、警告は異なる表現になります。圧縮ウィンドウはモデルのコンテキストウィンドウより小さい場合があるため、それを超えたリクエストでも成功する可能性があります。

2452 2482 

2453```text theme={null}2483```text theme={null}

2458 2488 

2459**対応方法：**2489**対応方法：**

2460 2490 

2461* マルチターン会話では、`/compact` を実行して以前のターンを要約し、スペースを解放してください。代わりに新しく開始するには、`/clear` を実行してください2491* **コンテキスト圧縮ウィンドウの警告の後**: 複数ターンの会話では、`/compact` を実行して以前のターンを要約し、空き領域を確保します。代わりに新しく始める場合は、`/clear` を実行します。

2462* 使用量を削減するその他の方法については、[Prompt is too long](#prompt-is-too-long)を参照してください2492* 使用量を削減するその他の方法については、[Prompt is too long](#prompt-is-too-long)を参照してください

2463 2493 

2464v2.1.216 より前では、`/context` は 100% を超える使用量を表示し、それが何を意味するか、または復旧方法を説明する警告行がありませんでした。2494v2.1.216 より前では、`/context` は 100% を超える使用量を表示し、それが何を意味するか、または復旧方法を説明する警告行がありませんでした。

3116* 最後のメッセージを言い換えるか、別のアプローチを試してください3146* 最後のメッセージを言い換えるか、別のアプローチを試してください

3117* ブロックをトリガーしたターンの前のチェックポイントに戻るには、Esc キーを 2 回押すか、`/rewind` を実行してください。[チェックポイント機能](https://code.claude.com/docs/ja/checkpointing.md)を参照してください3147* ブロックをトリガーしたターンの前のチェックポイントに戻るには、Esc キーを 2 回押すか、`/rewind` を実行してください。[チェックポイント機能](https://code.claude.com/docs/ja/checkpointing.md)を参照してください

3118 3148 

3119## コマンドラインのエラー3149## コマンドラインエラー

3120 3150 

3121これらのエラーは、`claude` コマンドラインとそのサブコマンド、プロンプトで送信したコマンド名、および `/security-review` のようにプロンプトの実行前にシェルコマンドを実行してコンテキストを収集するコマンドから発生します。CLI を再起動する `/tui` からも発生します。3151これらのエラーは、`claude` コマンドラインとそのサブコマンド、プロンプトで送信したコマンド名、およびプロンプトの実行前にシェルコマンドを実行してコンテキストを収集する `/security-review` などのコマンドから発生します。CLI を再起動する `/tui` からも発生します。

3122 3152 

3123### `--bg` と `--print` の競合3153### `--bg` と `--print` の競合

3124 3154 

3125このメッセージには Claude Code v2.1.198 以降が必要です。同じ `claude` 呼び出しで `--bg` と `-p` または `--print` を組み合わせました。`--bg` は、後で `claude agents` でアタッチする[バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を開始しますが、`--print` は[非対話的に](https://code.claude.com/docs/ja/headless.md)実行され、`claude agents` がアタッチする対話セッションを開始しません。v2.1.198 より前は、この組み合わせによって、アタッチできないバックグラウンドジョブが何も通知されずに作成されていました。3155このメッセージには Claude Code v2.1.198 以降が必要です。同じ `claude` の呼び出しで `--bg` と `-p` または `--print` を組み合わせています。`--bg` は後で `claude agents` でアタッチする[バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を開始しますが、`--print` は[非対話](https://code.claude.com/docs/ja/headless.md)で実行され、`claude agents` がアタッチする対話セッションを開始しません。v2.1.198 より前は、この組み合わせによって、決してアタッチできないバックグラウンドジョブが何も通知されずに作成されていました。

3126 3156 

3127```text theme={null}3157```text theme={null}

3128--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>'`.3158--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>'`.

3129```3159```

3130 3160 

3131**対処方法：**3161**対処方法:**

3132 3162 

3133* `-p` または `--print` を削除します。`--bg` はプロンプトを位置引数として受け取るため、`claude --bg "<task>"` で完全なコマンドになります。[シェルから新しいエージェントをディスパッチする](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を参照してください。3163* `-p` または `--print` を削除します。`--bg` はプロンプトを位置引数として受け取るため、`claude --bg "<task>"` で完全なコマンドになります。[シェルから新しいエージェントを Dispatch する](https://code.claude.com/docs/ja/agent-view.md#from-your-shell)を参照してください。

3134* バックグラウンドセッションを作成せずにプロンプトを非対話的に実行して結果を出力するには、`--bg` を削除して `claude -p "<task>"` を実行します3164* バックグラウンドセッションを作成せずにプロンプトを非対話で実行して結果を出力するには、`--bg` を削除して `claude -p "<task>"` を実行します

3135 3165 

3136### Couldn't tell whether `--bg` is a flag or text3166### Couldn't tell whether `--bg` is a flag or text

3137 3167 

3138`claude` を `--bg` または `--background` 付きで実行しましたが、その位置では、Claude Code はそれがバックグラウンドフラグなのかテキストなのかを判別できませんでした。コマンドは何も開始せず、次の行を出力して終了コード 1 で終了しました：3168`claude` を実行した際、`--bg` または `--background` が、バックグラウンドフラグとして意図したのかテキストとして意図したのか Claude Code が判断できない位置にありました。コマンドは何も開始せず、次の行を出力して終了コード 1 で終了しました:

3139 3169 

3140```text theme={null}3170```text theme={null}

3141Couldn't tell whether --bg is a flag or text here, so nothing was started. To start a background session put it first: claude --bg <prompt>3171Couldn't tell whether --bg is a flag or text here, so nothing was started. To start a background session put it first: claude --bg <prompt>

3142```3172```

3143 3173 

3144`--background` と入力した場合、この行には代わりに `--background` が示されます。3174`--background` と入力した場合は、この行には代わりに `--background` が表示されます。