Documentation 2026-10-15 23:58 UTC to 2026-10-16 22:59 UTC

9フックはエージェントイベントに応答してコードを実行するコールバック関数です。ツールが呼び出されたり、セッションが開始したり、実行が停止したりするなどのイベントに対応します。フックを使用すると、以下のことができます。9フックはエージェントイベントに応答してコードを実行するコールバック関数です。ツールが呼び出されたり、セッションが開始したり、実行が停止したりするなどのイベントに対応します。フックを使用すると、以下のことができます。

10 10 

11* **危険な操作をブロック**する：破壊的なシェルコマンドや不正なファイルアクセスなど、実行前に危険な操作をブロックします11* **危険な操作をブロック**する：破壊的なシェルコマンドや不正なファイルアクセスなど、実行前に危険な操作をブロックします

12* **ログと監査**：コンプライアンス、デバッグ、分析のためにすべてのツール呼び出しをログして監査します12* **ログと監査**：コンプライアンス、デバッグ、分析のためにツール呼び出しをログに記録して監査します

13* **入力と出力を変換**する：データをサニタイズしたり、認証情報を注入したり、ファイルパスをリダイレクトしたりします13* **入力と出力を変換**する：データをサニタイズしたり、認証情報を注入したり、ファイルパスをリダイレクトしたりします

14* **人間の承認を要求**する：データベース書き込みや API 呼び出しなどの機密アクションに対して14* **人間の承認を要求**する：データベース書き込みや API 呼び出しなどの機密アクションに対して

15* **セッションライフサイクルを追跡**する：状態を管理したり、リソースをクリーンアップしたり、通知を送信したりします15* **セッションライフサイクルを追跡**する：状態を管理したり、リソースをクリーンアップしたり、通知を送信したりします

40 </Step>40 </Step>

41</Steps>41</Steps>

42 42 

43次の例は、これらのステップをまとめたものです。`PreToolUse` フック（ステップ 1）を `"Write|Edit"` matcher（ステップ 3）で登録して、コールバックがファイル書き込みツールに対してのみ発火するようにします。トリガーされると、コールバックはツールの入力（ステップ 4）を受け取り、ファイルパスが `.env` ファイルをターゲットにしているかどうかをチェックし、`permissionDecision: "deny"` を返して操作をブロックします（ステップ 5）。43この例では、`PreToolUse` フック（ステップ 1）を `"Write|Edit"` matcher（ステップ 3）で登録して、コールバックが Write ツールと Edit ツールに対して発火するようにします。トリガーされると、コールバックはツールの入力（ステップ 4）を受け取り、ファイルパスが `.env` ファイルをターゲットにしているかどうかをチェックし、`permissionDecision: "deny"` を返して操作をブロックします（ステップ 5）。

44 44 

45<CodeGroup>45<CodeGroup>

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

61 file_name = file_path.split("/")[-1]61 file_name = file_path.split("/")[-1]

62 62 

63 # .env ファイルをターゲットにしている場合は操作をブロックする63 # .env ファイルをターゲットにしている場合は操作をブロックする

64 if file_name == ".env":64 if file_name.lower() == ".env":

65 return {65 return {

66 "hookSpecificOutput": {66 "hookSpecificOutput": {

67 "hookEventName": input_data["hook_event_name"],67 "hookEventName": input_data["hook_event_name"],

108 const fileName = filePath?.split("/").pop();108 const fileName = filePath?.split("/").pop();

109 109 

110 // .env ファイルをターゲットにしている場合は操作をブロックする110 // .env ファイルをターゲットにしている場合は操作をブロックする

111 if (fileName === ".env") {111 if (fileName?.toLowerCase() === ".env") {

112 return {112 return {

113 hookSpecificOutput: {113 hookSpecificOutput: {

114 hookEventName: preInput.hook_event_name,114 hookEventName: preInput.hook_event_name,

140 ```140 ```

141</CodeGroup>141</CodeGroup>

142 142 

143どちらのスクリプトを実行しても、Claude は `.env` ファイルを作成しようとし、フックはツール呼び出しを拒否します。143このフックは、`file_path` が `/.env` で終わる Write または Edit の呼び出しを、大文字・小文字を問わず拒否します。Windows では `file_path` は `C:\project\.env` のようにバックスラッシュを使用するため、このフックは `C:\project\.env` への Write または Edit の呼び出しを許可します。

144 

145<Warning>

146 `Write|Edit` matcher は、このフックの対象を Write ツールと Edit ツールに限定します。Claude が Bash コマンドで `.env` を書き込む場合、フックは実行されません。[サンドボックスが動作する](/docs/ja/sandboxing)場所にあるファイルへの Bash による書き込みをブロックするには、[Python](/docs/ja/agent-sdk/python#sandbox-configuration) または [TypeScript](/docs/ja/agent-sdk/typescript#sandbox-configuration) のサンドボックス設定を参照してください。

147</Warning>

144 148 

145<h2 id="available-hooks">149<h2 id="available-hooks">

146 利用可能なフック150 利用可能なフック

151| フックイベント | Python SDK | TypeScript SDK | トリガーされる条件 | 使用例 |155| フックイベント | Python SDK | TypeScript SDK | トリガーされる条件 | 使用例 |

152| - | - | - | - | - |156| - | - | - | - | - |

153| `PreToolUse` | はい | はい | ツール呼び出しリクエスト（ブロックまたは変更可能） | 危険なシェルコマンドをブロックする |157| `PreToolUse` | はい | はい | ツール呼び出しリクエスト（ブロックまたは変更可能） | 危険なシェルコマンドをブロックする |

154| `PostToolUse` | はい | はい | ツール実行結果 | すべてのファイル変更を監査証跡にログする |158| `PostToolUse` | はい | はい | ツール実行結果 | ファイル変更を監査証跡にログする |

155| `PostToolUseFailure` | はい | はい | ツール実行失敗 | ツールエラーを処理またはログする |159| `PostToolUseFailure` | はい | はい | ツール実行失敗 | ツールエラーを処理またはログする |

156| `PostToolBatch` | いいえ | はい | ツール呼び出しの完全なバッチが解決される。次のモデル呼び出しの前に 1 回 | バッチ全体に対して規約を 1 回注入する |160| `PostToolBatch` | いいえ | はい | ツール呼び出しの完全なバッチが解決される。次のモデル呼び出しの前に 1 回 | バッチ全体に対して規約を 1 回注入する |

157| [`UserPromptSubmit`](/docs/ja/hooks#userpromptsubmit) | はい | はい | プロンプトが送信される。Claude Code が自ら開始するターンを含む | プロンプトに追加のコンテキストを注入する |161| [`UserPromptSubmit`](/docs/ja/hooks#userpromptsubmit) | はい | はい | プロンプトが送信される。Claude Code が自ら開始するターンを含む | プロンプトに追加のコンテキストを注入する |

235| `hooks` | `HookCallback[]` | - | 必須。パターンがマッチしたときに実行するコールバック関数の配列 |239| `hooks` | `HookCallback[]` | - | 必須。パターンがマッチしたときに実行するコールバック関数の配列 |

236| `timeout` | `number` | `undefined` | タイムアウト（秒単位）。省略した場合、Claude Code は[イベントのデフォルトタイムアウト](#hook-timeout)を適用します。SDK コールバックは `command` フックのデフォルトに従います |240| `timeout` | `number` | `undefined` | タイムアウト（秒単位）。省略した場合、Claude Code は[イベントのデフォルトタイムアウト](#hook-timeout)を適用します。SDK コールバックは `command` フックのデフォルトに従います |

237 241 

238可能な限り `matcher` パターンを使用して特定のツールをターゲットにします。`'Bash'` のマッチャーは Bash コマンドに対してのみ実行されますが、パターンを省略するとコールバックはそのイベントのすべての発生に対して実行されます。セッションが行うすべてのツール呼び出しをログするために、意図的にパターンを省略します。242可能な限り `matcher` パターンを使用して特定のツールをターゲットにします。`'Bash'` のマッチャーは Bash コマンドに対してのみ実行されますが、パターンを省略するとコールバックはそのイベントのすべての発生に対して実行されます。

239 243 

240<h3 id="callback-functions">244<h3 id="callback-functions">

241 コールバック関数245 コールバック関数

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

269 273 

270<Note>274<Note>

271 複数のフックまたは権限ルールが適用される場合、`deny` は `defer` より優先され、`defer` は `ask` より優先され、`ask` は `allow` より優先されます。いずれかのフックが `deny` を返す場合、他のフックに関係なく操作はブロックされます。275 複数の `PreToolUse` フックが異なる[決定](/docs/ja/hooks#pretooluse-decision-control)を返す場合、`deny` は `defer` より優先され、`defer` は `ask` より優先され、`ask` は `allow` より優先されます。

272</Note>276</Note>

273 277 

274<h4 id="asynchronous-output">278<h4 id="asynchronous-output">

313 ツール入力を変更する317 ツール入力を変更する

314</h3>318</h3>

315 319 

316この例では、Write ツールの呼び出しをインターセプトし、`file_path` 引数の先頭に `/sandbox` を付加するように書き換えることで、すべてのファイル書き込みをサンドボックス化されたディレクトリにリダイレクトします。コールバックは、変更後のパスを含む `updatedInput` と、書き換えた操作を自動承認するための `permissionDecision: 'allow'` を返します。320この例では、Write ツールの呼び出しをインターセプトし、`file_path` 引数の先頭に `/sandbox` を付加するように書き換えます。コールバックは、変更後のパスを含む `updatedInput` と、書き換えた操作を自動承認するための `permissionDecision: 'allow'` を返します。

317 321 

318<CodeGroup>322<CodeGroup>

319 ```python Python theme={null}323 ```python Python theme={null}

370 コンテキストを追加してツールをブロックする374 コンテキストを追加してツールをブロックする

371</h3>375</h3>

372 376 

373この例では、`/etc` ディレクトリへの書き込みをブロックし、その理由をモデルとユーザーの両方に説明します。377この例では、`file_path` が `/etc` で始まるツール呼び出しを拒否し、その理由をモデルとユーザーの両方に説明します。

374 378 

375* `permissionDecision: 'deny'` はツール呼び出しを停止します。379* `permissionDecision: 'deny'` はツール呼び出しを停止します。

376* `permissionDecisionReason` はモデルに理由を伝え、再試行を避けられるようにします。380* `permissionDecisionReason` はモデルに理由を伝えます。

377* `systemMessage` は何が起きたかをユーザーに表示します。381* `systemMessage` は何が起きたかをユーザーに表示します。

378 382 

379<CodeGroup>383<CodeGroup>

468 複数のフックを登録する472 複数のフックを登録する

469</h3>473</h3>

470 474 

471イベントが発生すると、一致するすべてのフックが並列に実行されます。権限の決定については、最も制限の厳しい結果が適用されます。1 つでも `deny` があれば、他のフックが何を返したかに関係なくツール呼び出しはブロックされます。完了順序は非決定的であるため、別のフックが先に実行されていることに依存せず、各フックが独立して動作するように記述してください。475イベントが発生すると、一致するすべてのフックが並列に実行されます。権限の決定については、最も制限の厳しい結果が適用されます。1 つのフックの `deny` でツール呼び出しはブロックされます。完了順序は非決定的であるため、別のフックが先に実行されていることに依存せず、各フックが独立して動作するように記述してください。

472 476 

473以下の例では、すべてのツール呼び出しに対して 3 つの独立したチェックを登録します。例中のフック名（Python の `audit_logger` や TypeScript の `auditLogger` など）は、ユーザーが定義するコールバックを表しています。477以下の例では、それぞれ [matcher を省略した](/docs/ja/hooks#matcher-patterns) 3 つの独立したチェックを登録します。例中のフック名（Python の `audit_logger` や TypeScript の `auditLogger` など）は、ユーザーが定義するコールバックを表しています。

474 478 

475<CodeGroup>479<CodeGroup>

476 ```python Python theme={null}480 ```python Python theme={null}

504 508 

505複数ツールの matcher を使用すると、関連するツール間で 1 つのコールバックを共有できます。この例ではスコープの異なる 3 つの matcher を登録しており、例中の各フックはユーザーが定義するコールバックを表しています。509複数ツールの matcher を使用すると、関連するツール間で 1 つのコールバックを共有できます。この例ではスコープの異なる 3 つの matcher を登録しており、例中の各フックはユーザーが定義するコールバックを表しています。

506 510 

507* パイプ区切りの完全一致リスト（`Write|Edit|NotebookEdit`）は、ファイル変更ツールに対してのみ `file_security_hook` をトリガーします。511* パイプ区切りの完全一致リスト（`Write|Edit|NotebookEdit`）は、Write、Edit、NotebookEdit ツールに対して `file_security_hook` をトリガーします。

508* 正規表現（`^mcp__`）は、名前が `mcp__` で始まるすべての MCP ツールに対して `mcp_audit_hook` をトリガーします。512* 正規表現（`^mcp__`）は、名前が `mcp__` で始まるすべての MCP ツールに対して `mcp_audit_hook` をトリガーします。

509* matcher を省略すると、名前に関係なくすべてのツール呼び出しに対して `global_logger` をトリガーします。513* matcher を省略すると、ツール名でフィルタリングせずに `global_logger` をトリガーします。

510 514 

511<CodeGroup>515<CodeGroup>

512 ```python Python theme={null}516 ```python Python theme={null}

832 836 

833コールバックがタイムアウトを超過した場合、Claude Code はそれをキャンセルし、その出力を破棄し、セッションはハングするのではなく続行します。次に何が起こるかはイベントによって異なります：837コールバックがタイムアウトを超過した場合、Claude Code はそれをキャンセルし、その出力を破棄し、セッションはハングするのではなく続行します。次に何が起こるかはイベントによって異なります：

834 838 

835* `PreToolUse`：Claude Code はツール呼び出しを実行せず、Claude はフックがタイムアウト前に応答しなかったことを示すツール結果を受け取り、ターンが続行されます。別の `PreToolUse` フックが明示的な拒否を返した場合、Claude はタイムアウトエラーの代わりにその拒否を受け取ります。v2.1.210 より前では、Claude Code はタイムアウトを Claude にユーザー拒否として報告していたため、無人セッションは停止して入力を待つようになっていました。839* `PreToolUse`：Claude Code はツール呼び出しをブロックします。その代わりに、Claude はフックがタイムアウト前に応答しなかったことを示すツール結果を受け取り、ターンが続行されます。v2.1.210 より前では、Claude Code はタイムアウトを Claude にユーザー拒否として報告していたため、無人セッションは停止して入力を待つようになっていました。

836* `PostToolUse` および `PostToolUseFailure`：Claude Code はツール結果を保持し、ターンが続行されます。840* `PostToolUse` および `PostToolUseFailure`：Claude Code はツール結果を保持し、ターンが続行されます。

837* `UserPromptSubmit` および [`UserPromptExpansion`](/docs/ja/hooks#userpromptexpansion)：Claude Code はフックとタイムアウトを名前で示すメッセージでプロンプトをブロックし、セッションが続行されます。これらのイベントのコールバックはポリシーゲートとして機能できるため、Claude Code はタイムアウトしたプロンプトをスクリーニングなしで通すことはありません。v2.1.208 より前では、これらのイベントのコールバックがタイムアウトした場合、Claude Code はクエリを `error_during_execution` で終了していました。841* `UserPromptSubmit` および [`UserPromptExpansion`](/docs/ja/hooks#userpromptexpansion)：Claude Code はフックとタイムアウトを名前で示すメッセージでプロンプトをブロックし、セッションが続行されます。v2.1.208 より前では、これらのイベントのコールバックがタイムアウトした場合、Claude Code はクエリを `error_during_execution` で終了していました。

838* `Stop` および `SubagentStop`：タイムアウトしたコールバックは決定を返さないとカウントされます。エージェントまたはサブエージェントは、そのコールバックがそれを許可したかのように停止し、イベントの他のフックからの決定が適用されます。Claude Code v2.1.273 より前では、タイムアウトした `Stop` または `SubagentStop` コールバックは失敗したフック実行としてカウントされ、Claude Code はイベントの他のフックの決定を破棄していました。842* `Stop` および `SubagentStop`：タイムアウトしたコールバックは決定を返さないとカウントされます。エージェントまたはサブエージェントは、そのコールバックがそれを許可したかのように停止し、イベントの他のフックからの決定が適用されます。Claude Code v2.1.273 より前では、タイムアウトした `Stop` または `SubagentStop` コールバックは失敗したフック実行としてカウントされ、Claude Code はイベントの他のフックの決定を破棄していました。

839* `SessionStart`：タイムアウトしたコールバックは出力を返さないとカウントされ、セッションは他の `SessionStart` フックの出力で続行されます。843* `SessionStart`：タイムアウトしたコールバックは出力を返さないとカウントされ、セッションは他の `SessionStart` フックの出力で続行されます。

840* `PreModelSwitch`：Claude Code はモデルスイッチをブロックします。応答しないフックはスイッチを承認していません。844* `PreModelSwitch`：Claude Code はモデルスイッチをブロックします。応答しないフックはスイッチを承認していません。

3880<Note>3880<Note>

3881 サンドボックスはプラットフォームサポートに依存し、Linux では `bubblewrap` や `socat` などのツールが必要です。デフォルトでは、`enabled` が `True` でもサンドボックスが起動できない場合、コマンドはサンドボックスなしで実行され、stderr に警告が表示されます。このデフォルト動作は TypeScript SDK とは異なり、TypeScript SDK では `failIfUnavailable` がデフォルトで `true` です。3881 サンドボックスはプラットフォームサポートに依存し、Linux では `bubblewrap` や `socat` などのツールが必要です。デフォルトでは、`enabled` が `True` でもサンドボックスが起動できない場合、コマンドはサンドボックスなしで実行され、stderr に警告が表示されます。このデフォルト動作は TypeScript SDK とは異なり、TypeScript SDK では `failIfUnavailable` がデフォルトで `true` です。

3882 3882 

3883 サンドボックス設定で `"failIfUnavailable": True` を設定して、代わりに停止するようにしてください。このキーはまだ `SandboxSettings` で宣言されていませんが、SDK は Claude Code に転送し、Claude Code がこれを尊重します。その後、`query()` は `subtype="error_during_execution"` の `ResultMessage` を報告し、理由は `errors` に含まれます。これは単一ショットの `query()` 呼び出しであるため、SDK はそのエラー結果を生成した後に発生させるため、ループを try ブロックでラップして、それを超えて続行してください。詳細は [結果を処理する](/docs/ja/agent-sdk/agent-loop#handle-the-result) を参照してください。3883 サンドボックス設定で `"failIfUnavailable": True` を設定して、代わりに停止するようにしてください。SDK は、宣言された `SandboxSettings` フィールドとともに `failIfUnavailable` を Claude Code に転送します。その後、`query()` は `subtype="error_during_execution"` の `ResultMessage` を報告し、理由は `errors` に含まれます。これは単一ショットの `query()` 呼び出しであるため、SDK はそのエラー結果を生成した後に例外を発生させます。そのため、ループを try ブロックでラップして、それを超えて続行してください。エラーの仕様については [結果を処理する](/docs/ja/agent-sdk/agent-loop#handle-the-result) を参照してください。

3884</Note>3884</Note>

3885 3885 

3886サンドボックス化されたコマンドがファイルに書き込まないようにするには、サンドボックス設定の [`denyWrite`](/docs/ja/settings-reference#sandbox-filesystem-denywrite) にその絶対パスを記載します（例：`"filesystem": {"denyWrite": ["/home/user/project/.env"]}`）。SDK は、宣言された `SandboxSettings` フィールドとともに `filesystem` を Claude Code に転送します。サンドボックスが起動すると、記載された各パスへの書き込みがブロックされます。`.env` または `./.env` を記載した場合、サンドボックス化されたコマンドはセッションの作業ディレクトリ内の `.env` ファイルに書き込むことができます。

3887 

3886<h4 id="example-usage">3888<h4 id="example-usage">

3887 使用例3889 使用例

3888</h4>3890</h4>

557[Claude Code Skills ガイド](/docs/ja/skills)は、作成を詳細にカバーしています。そのガイダンスは SDK セッションに適用されます。これらのセクションから始めてください：557[Claude Code Skills ガイド](/docs/ja/skills)は、作成を詳細にカバーしています。そのガイダンスは SDK セッションに適用されます。これらのセクションから始めてください：

558 558 

559* [フロントマターリファレンス](/docs/ja/skills#frontmatter-reference)：サポートされているすべてのフィールド559* [フロントマターリファレンス](/docs/ja/skills#frontmatter-reference)：サポートされているすべてのフィールド

560* [Skills に引数を渡す](/docs/ja/skills#pass-arguments-to-skills)：`$ARGUMENTS`、`$0`、`$1`、および Skill スタッキング。[完全な置換テーブル](/docs/ja/skills#available-string-substitutions)は、名前付き引数および `${CLAUDE_*}` 変数を追加します560* [Skills に引数を渡す](/docs/ja/skills#pass-arguments-to-skills)：`$ARGUMENTS`、`$0`、および `$1`。[完全な置換テーブル](/docs/ja/skills#available-string-substitutions)は、名前付き引数および `${CLAUDE_*}` 変数を追加します

561* [動的コンテキストを注入する](/docs/ja/skills#inject-dynamic-context)：Claude が Skill コンテンツを見る前に実行される `` !`command` `` 行561* [動的コンテキストを注入する](/docs/ja/skills#inject-dynamic-context)：Claude が Skill コンテンツを見る前に実行される `` !`command` `` 行

562* [Skills が読み込まれる場所を選択する](/docs/ja/skills#where-skills-live)：すべての Skill の場所、プラグイン名前空間、および 2 つが名前を共有するときにどの Skill が実行されるか562* [Skills が読み込まれる場所を選択する](/docs/ja/skills#where-skills-live)：すべての Skill の場所、プラグイン名前空間、および 2 つが名前を共有するときにどの Skill が実行されるか

563 563 

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

6369| :- | :- | :- | :- |6369| :- | :- | :- | :- |

6370| `allowWrite` | `string[]` | `[]` | 書き込みアクセスを許可するファイルパターン |6370| `allowWrite` | `string[]` | `[]` | 書き込みアクセスを許可するファイルパターン |

6371| `denyWrite` | `string[]` | `[]` | 書き込みアクセスを拒否するファイルパターン |6371| `denyWrite` | `string[]` | `[]` | 書き込みアクセスを拒否するファイルパスパターン。セッションの作業ディレクトリ内のファイルへのサンドボックス化された書き込みをブロックするには、その絶対パスを指定してください。`.env` または `./.env` を指定した場合、サンドボックス化されたコマンドはセッションの作業ディレクトリ内の `.env` ファイルに書き込めます |

6372| `denyRead` | `string[]` | `[]` | 読み取りアクセスを拒否するファイルパターン |6372| `denyRead` | `string[]` | `[]` | 読み取りアクセスを拒否するファイルパターン |

6373 6373 

6374<h3 id="permissions-fallback-for-unsandboxed-commands">6374<h3 id="permissions-fallback-for-unsandboxed-commands">

6389 options: {6389 options: {

6390 sandbox: {6390 sandbox: {

6391 enabled: true,6391 enabled: true,

6392 allowUnsandboxedCommands: true // モデルはサンドボックス外実行をリクエストできます6392 allowUnsandboxedCommands: true // Model can request unsandboxed execution

6393 },6393 },

6394 permissionMode: "default",6394 permissionMode: "default",

6395 canUseTool: async (tool, input) => {6395 canUseTool: async (tool, input) => {

6396 // モデルがサンドボックスをバイパスするようにリクエストしているかチェック6396 // Check if the model is requesting to bypass the sandbox

6397 if (tool === "Bash" && input.dangerouslyDisableSandbox) {6397 if (tool === "Bash" && input.dangerouslyDisableSandbox) {

6398 // モデルはこのコマンドをサンドボックス外で実行するようにリクエストしています6398 // The model is requesting to run this command outside the sandbox

6399 console.log(`Unsandboxed command requested: ${input.command}`);6399 console.log(`Unsandboxed command requested: ${input.command}`);

6400 6400 

6401 if (isCommandAuthorized(input.command)) {6401 if (isCommandAuthorized(input.command)) {

231 231 

232リーダーはシャットダウンリクエストを送信します。チームメンバーは承認して適切に終了するか、説明付きで却下できます。232リーダーはシャットダウンリクエストを送信します。チームメンバーは承認して適切に終了するか、説明付きで却下できます。

233 233 

234チームの共有ディレクトリは、セッションが終了すると自動的にクリーンアップされるため、別のクリーンアップステップはありません。削除されるディレクトリと、再開されたセッションのために保持されるディレクトリについては、[Architecture](#architecture) を参照してください。234チームの共有ディレクトリは、セッションが終了すると自動的にクリーンアップされるため、別のクリーンアップステップはありません。削除されるディレクトリと、ディスク上に残るディレクトリについては、[Architecture](#architecture) を参照してください。

235 235 

236<h3 id="enforce-quality-gates-with-hooks">236<h3 id="enforce-quality-gates-with-hooks">

237 hooks で品質ゲートを実施する237 hooks で品質ゲートを実施する

278 278 

279チームとタスクはセッション派生名でローカルに保存されます。名前は `session-` の後にセッション ID の最初の 8 文字が続きます。279チームとタスクはセッション派生名でローカルに保存されます。名前は `session-` の後にセッション ID の最初の 8 文字が続きます。

280 280 

281* **チーム設定**：`~/.claude/teams/{team-name}/config.json`281* **チーム設定**：`~/.claude/teams/{team-name}/config.json`。Claude Code はセッション終了時にチーム設定ディレクトリを削除します。

282* **タスクリスト**：`~/.claude/tasks/{team-name}/`282* **タスクリスト**：`~/.claude/tasks/{team-name}/`。このディレクトリはセッション終了後もディスク上に残ります。[Claude Code が保持する期間](/docs/ja/claude-directory#cleaned-up-automatically) を変更するには、[`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) を設定してください。

283 283 

284Claude Code はセッション起動時にこれらの両方を自動的に生成し、チームメンバーが参加、アイドル状態になる、または離脱するときに更新します。チーム設定ディレクトリはセッション終了時に削除されます。タスクリストディレクトリはローカルに保持され、アップロードされることはないため、再開されたセッションはタスクを保持します。保持期間は、セッショントランスクリプト用に既に制御している同じ [`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) によって管理され、[保持スイープルール](/docs/ja/claude-directory#cleaned-up-automatically) に従います。284Claude Code はセッション起動時にこれらの両方を自動的に生成し、チームメンバーが参加、アイドル状態になる、または離脱するときに更新します。

285 285 

286チーム設定はセッション ID と tmux ペイン ID などのランタイム状態を保持しているため、手動で編集したり、事前に作成したりしないでください。次の状態更新時に変更が上書きされます。286チーム設定はセッション ID と tmux ペイン ID などのランタイム状態を保持しているため、手動で編集したり、事前に作成したりしないでください。次の状態更新時に変更が上書きされます。

287 287 

325 325 

3262 回目の押下は、たとえば [バックグラウンドサービスが応答していない](#agent-view-says-the-background-service-did-not-respond) ために停止の試みが失敗した場合でも、セッションを削除します。確認はさらに 2 秒間有効なままで、削除によってセッションのプロセス自体が終了されます。削除せずに確認を閉じるには `Esc` を押します。3262 回目の押下は、たとえば [バックグラウンドサービスが応答していない](#agent-view-says-the-background-service-did-not-respond) ために停止の試みが失敗した場合でも、セッションを削除します。確認はさらに 2 秒間有効なままで、削除によってセッションのプロセス自体が終了されます。削除せずに確認を閉じるには `Esc` を押します。

327 327 

328[セッションを削除するときに削除されるもの](#what-deleting-a-session-removes) で説明されている保持されるケースを除き、削除するとセッションはリストから削除され、Claude がそのセッション用に作成した worktree は、削除方法と worktree の内容に応じて、削除、保持、またはそのまま残されます。会話のトランスクリプトは常にローカルマシンに残り、`claude --resume` から利用できます。328[セッションを削除するときに削除されるもの](#what-deleting-a-session-removes) で説明されている保持されるケースを除き、削除するとセッションはリストから削除され、Claude がそのセッション用に作成した worktree は、削除方法と worktree の内容に応じて、削除、保持、またはそのまま残されます。会話のトランスクリプトはローカルマシンに残り、`claude --resume` から利用できます。

329 329 

330Claude Code v2.1.212 以降でセッションを戻すには、ディスパッチ入力に `/resume` と入力します。ピッカーが開き、エージェントビューを開いたリポジトリの過去のセッションが新しい順に表示されます。リストから削除したセッションも含まれますが、既に行があるセッションは表示されません。`↑`/`↓` で選択を移動し、`Enter` で選択したセッションをバックグラウンドセッションとして再開して行としてリストに戻し、`Esc` でピッカーを閉じます。330Claude Code v2.1.212 以降でセッションを戻すには、ディスパッチ入力に `/resume` と入力します。ピッカーが開き、エージェントビューを開いたリポジトリの過去のセッションが新しい順に表示されます。リストから削除したセッションも含まれますが、既に行があるセッションは表示されません。`↑`/`↓` で選択を移動し、`Enter` で選択したセッションをバックグラウンドセッションとして再開して行としてリストに戻し、`Esc` でピッカーを閉じます。

331 331 

12We're changing auto mode to no longer charge for classifier requests in Claude Code. However, this session isn't eligible.12We're changing auto mode to no longer charge for classifier requests in Claude Code. However, this session isn't eligible.

13```13```

14 14 

15プロンプトで、Claude Code はこのようにチェックする最初のアクションを保留し、回答を待ちます。何も壊れていません：auto mode は動作し続け、その分類器リクエストは以前と同じように請求されます。最も一般的な原因は Claude Code と API の間の LLM ゲートウェイまたはプロキシであり、Claude Code がそれを識別できる場合、通知はそれに名前を付けます。**Enter** キーを押して続行するか、[セッションを対象にする](#make-the-session-eligible)を参照して、新しいセッションに表示されないようにしてください。15プロンプトで、Claude Code はこのようにチェックする最初のアクションを保留し、回答を待ちます。auto モードは引き続き動作し、その分類器リクエストは以前と同じように課金されます。

16 

17最も一般的な原因は Claude Code と API の間の LLM ゲートウェイまたはプロキシであり、Claude Code がそれを識別できる場合、通知はそれに名前を付けます。**Enter** キーを押して続行するか、[セッションを対象にする](#make-the-session-eligible)を参照して、新しいセッションに表示されないようにしてください。

16 18 

17<h2 id="respond-to-the-notice">19<h2 id="respond-to-the-notice">

18 ダイアログに応答する20 ダイアログに応答する

45 インストールが失敗した場合は、Claude Code が報告するメッセージと照合してください。45 インストールが失敗した場合は、Claude Code が報告するメッセージと照合してください。

46 46 

47 * `Marketplace "claude-plugins-official" not found`：`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行してください。47 * `Marketplace "claude-plugins-official" not found`：`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行してください。

48 * プラグインが[マーケットプレイスで見つかりません](/docs/ja/plugins/install#install-a-plugin)：プラグイン名を確認してください。48 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`：ローカルにあるマーケットプレイスカタログのコピーが古くなっている可能性があります。`/plugin marketplace update claude-plugins-official` で更新してから、インストールを再試行してください。再試行しても同じメッセージが表示される場合は、[Plugin not found in marketplace](/docs/ja/plugins/troubleshooting#plugin-not-found-in-marketplace) を参照してください。

49 49 

50 インストールがインストールスコープを求めるとき、ユーザースコープオプションを選択して、プラグインがすべてのプロジェクト全体で利用可能になるようにしてください。インストール概要を確認してください。`Run /reload-plugins to apply.` と報告されている場合は、[プラグイン変更を再起動なしで適用する](/docs/ja/plugins/cli-reference#reload-plugins)を参照して、プラグインの設定コマンドを利用可能にしてください。50 インストールがインストールスコープを求めるとき、ユーザースコープオプションを選択して、プラグインがすべてのプロジェクト全体で利用可能になるようにしてください。インストール概要を確認してください。`Run /reload-plugins to apply.` と報告されている場合は、[プラグイン変更を再起動なしで適用する](/docs/ja/plugins/cli-reference#reload-plugins)を参照して、プラグインの設定コマンドを利用可能にしてください。

51 </Step>51 </Step>

123 インストールが失敗した場合は、Claude Code が報告するメッセージと照合してください。123 インストールが失敗した場合は、Claude Code が報告するメッセージと照合してください。

124 124 

125 * `Marketplace "claude-plugins-official" not found`：`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行してください。125 * `Marketplace "claude-plugins-official" not found`：`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行してください。

126 * プラグインが[マーケットプレイスで見つかりません](/docs/ja/plugins/install#install-a-plugin)：プラグイン名を確認してください。126 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`：ローカルにあるマーケットプレイスカタログのコピーが古くなっている可能性があります。`/plugin marketplace update claude-plugins-official` で更新してから、インストールを再試行してください。再試行しても同じメッセージが表示される場合は、[Plugin not found in marketplace](/docs/ja/plugins/troubleshooting#plugin-not-found-in-marketplace) を参照してください。

127 127 

128 インストールがインストールスコープを求めるとき、ユーザースコープオプションを選択して、プラグインがすべてのプロジェクト全体で利用可能になるようにしてください。インストール概要を確認してください。`Run /reload-plugins to apply.` と報告されている場合は、[プラグイン変更を再起動なしで適用する](/docs/ja/plugins/cli-reference#reload-plugins)を参照して、プラグインの設定コマンドを利用可能にしてください。128 インストールがインストールスコープを求めるとき、ユーザースコープオプションを選択して、プラグインがすべてのプロジェクト全体で利用可能になるようにしてください。インストール概要を確認してください。`Run /reload-plugins to apply.` と報告されている場合は、[プラグイン変更を再起動なしで適用する](/docs/ja/plugins/cli-reference#reload-plugins)を参照して、プラグインの設定コマンドを利用可能にしてください。

129 </Step>129 </Step>

188 インストールが失敗した場合は、Claude Code が報告するメッセージと照合してください。188 インストールが失敗した場合は、Claude Code が報告するメッセージと照合してください。

189 189 

190 * `Marketplace "claude-plugins-official" not found`：`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行してください。190 * `Marketplace "claude-plugins-official" not found`：`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行してください。

191 * プラグインが[マーケットプレイスで見つかりません](/docs/ja/plugins/install#install-a-plugin)：プラグイン名を確認してください。191 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`：ローカルにあるマーケットプレイスカタログのコピーが古くなっている可能性があります。`/plugin marketplace update claude-plugins-official` で更新してから、インストールを再試行してください。再試行しても同じメッセージが表示される場合は、[Plugin not found in marketplace](/docs/ja/plugins/troubleshooting#plugin-not-found-in-marketplace) を参照してください。

192 192 

193 インストールがインストールスコープを求めるとき、ユーザースコープオプションを選択して、プラグインがすべてのプロジェクト全体で利用可能になるようにしてください。193 インストールがインストールスコープを求めるとき、ユーザースコープオプションを選択して、プラグインがすべてのプロジェクト全体で利用可能になるようにしてください。

194 194 

247 インストールが失敗した場合は、Claude Code が報告するメッセージに一致させてください。247 インストールが失敗した場合は、Claude Code が報告するメッセージに一致させてください。

248 248 

249 * `Marketplace "claude-plugins-official" not found`：`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行してください。249 * `Marketplace "claude-plugins-official" not found`：`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行してください。

250 * プラグインが [マーケットプレイスで見つかりません](/docs/ja/plugins/install#install-a-plugin)：プラグイン名を確認してください。250 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`：ローカルにあるマーケットプレイスカタログのコピーが古くなっている可能性があります。`/plugin marketplace update claude-plugins-official` で更新してから、インストールを再試行してください。再試行しても同じメッセージが表示される場合は、[Plugin not found in marketplace](/docs/ja/plugins/troubleshooting#plugin-not-found-in-marketplace) を参照してください。

251 251 

252 インストールがインストールスコープを求めるとき、ユーザースコープオプションを選択して、プラグインがすべてのプロジェクト全体で利用可能になるようにしてください。252 インストールがインストールスコープを求めるとき、ユーザースコープオプションを選択して、プラグインがすべてのプロジェクト全体で利用可能になるようにしてください。

253 253 

290 note: commandsNote,290 note: commandsNote,

291 when: <>User types <C>/command-name</C></>,291 when: <>User types <C>/command-name</C></>,

292 description: <>A file at <C>commands/deploy.md</C> creates <C>/deploy</C> the same way a skill at <C>skills/deploy/SKILL.md</C> does, and both can be auto-invoked by Claude. Skills use a directory with SKILL.md, letting you bundle reference docs, templates, or scripts alongside the prompt.</>,292 description: <>A file at <C>commands/deploy.md</C> creates <C>/deploy</C> the same way a skill at <C>skills/deploy/SKILL.md</C> does, and both can be auto-invoked by Claude. Skills use a directory with SKILL.md, letting you bundle reference docs, templates, or scripts alongside the prompt.</>,

293 tips: [<>Use <C>$ARGUMENTS</C> in the file to accept parameters: <C>/fix-issue 123</C></>, 'If a skill and command share a name, the skill takes precedence', 'New commands should usually be skills instead; commands remain supported'],293 tips: [<>Use <C>$ARGUMENTS</C> in the file to accept parameters: <C>/fix-issue 123</C></>, 'If a skill and command share a name, the skill takes precedence', 'New commands should usually be skills instead; command files still work'],

294 docsLink: '/en/skills',294 docsLink: '/en/skills',

295 children: [{295 children: [{

296 id: 'cmd-example',296 id: 'cmd-example',

48 48 

49コマンドはプラグインの詳細を開き、[インストールスコープ](/docs/ja/plugins/install#install-a-plugin)を選択してインストールを開始します。49コマンドはプラグインの詳細を開き、[インストールスコープ](/docs/ja/plugins/install#install-a-plugin)を選択してインストールを開始します。

50 50 

51インストールが失敗した場合、修正は Claude Code が報告するメッセージによって異なります。51インストールが失敗した場合は、Claude Code が報告するメッセージに応じて対処してください。

52 52 

53* `Marketplace "claude-plugins-official" not found` と報告された場合は、`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行してください。53* `Marketplace "claude-plugins-official" not found` と報告された場合は、`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行してください。

54* マーケットプレイスで [プラグインが見つからないと報告された](/docs/ja/plugins/install#install-a-plugin)場合は、プラグイン名のタイプミスを確認してください。54* `Plugin "claude-security" not found in marketplace "claude-plugins-official"` と報告された場合は、マーケットプレイスカタログのローカルコピーが古くなっている可能性があります。`/plugin marketplace update claude-plugins-official` で更新してから、インストールを再試行してください。再試行しても同じメッセージが表示される場合は、[マーケットプレイスでプラグインが見つからない](/docs/ja/plugins/troubleshooting#plugin-not-found-in-marketplace)を参照してください。

55 55 

56インストール概要を確認してください。`Run /reload-plugins to apply.` と報告された場合は、[プラグインの変更を再起動なしで適用](/docs/ja/plugins/cli-reference#reload-plugins)を参照して、現在のセッションでプラグインをアクティブにしてください。56インストール概要を確認してください。`Run /reload-plugins to apply.` と報告された場合は、[プラグインの変更を再起動なしで適用](/docs/ja/plugins/cli-reference#reload-plugins)を参照して、現在のセッションでプラグインをアクティブにしてください。

57 57 

118effort レベルとフラグの後、Claude Code は行の残りをレビュー対象として読み取ります。`ultra` 引数はこの解釈を変更します。118effort レベルとフラグの後、Claude Code は行の残りをレビュー対象として読み取ります。`ultra` 引数はこの解釈を変更します。

119 119 

120* **`ultra` を指定した場合**: Claude Code は単一の単語をベースブランチまたは PR 番号として読み取ります。ブランチや PR を指していない長いテキストは、[レビューに添付されるメモ](/docs/ja/ultrareview#pass-a-request-in-plain-words)になります。`/code-review ultra check my auth changes` は現在のブランチをレビューし、Claude は指摘事項をメモと関連付けます。120* **`ultra` を指定した場合**: Claude Code は単一の単語をベースブランチまたは PR 番号として読み取ります。ブランチや PR を指していない長いテキストは、[レビューに添付されるメモ](/docs/ja/ultrareview#pass-a-request-in-plain-words)になります。`/code-review ultra check my auth changes` は現在のブランチをレビューし、Claude は指摘事項をメモと関連付けます。

121* **`ultra` を指定しない場合**: 残りはすべてレビュー対象になります。これは別のコマンド名で始まる場合も同様です。`/code-review /fix-issue 123` は、`/fix-issue` を 2 つ目の[スタックされたスキル](/docs/ja/skills#pass-arguments-to-skills)として読み込むのではなく、`/fix-issue 123` を対象テキストとしてレビューします。v2.1.218 より前は、`/code-review` の後にスタックされたコマンドは独立したスキルとして展開されていました。121* **`ultra` を指定しない場合**: 残りはすべてレビュー対象になります。これは別のコマンド名で始まる場合も同様です。`/code-review /fix-issue 123` は、`/fix-issue` を 2 つ目の[スタックされたスキル](/docs/ja/skills#stack-several-skills-in-one-message)として読み込むのではなく、`/fix-issue 123` を対象テキストとしてレビューします。v2.1.218 より前は、`/code-review` の後にスタックされたコマンドは独立したスキルとして展開されていました。

122 122 

123<h2 id="run-in-the-foreground">123<h2 id="run-in-the-foreground">

124 フォアグラウンドで実行する124 フォアグラウンドで実行する

10 10 

11`/` と入力するとご利用いただけるコマンドが表示されます。または `/` の後に文字を入力してフィルタリングできます。[コマンドメニューが入力内容にどのようにマッチするか](#how-the-command-menu-matches-what-you-type)では、ハイライト、タイプミス、および Claude Code がメニューから非表示にするコマンドについて説明しています。これらのコマンドは完全な名前を入力するまで表示されません。11`/` と入力するとご利用いただけるコマンドが表示されます。または `/` の後に文字を入力してフィルタリングできます。[コマンドメニューが入力内容にどのようにマッチするか](#how-the-command-menu-matches-what-you-type)では、ハイライト、タイプミス、および Claude Code がメニューから非表示にするコマンドについて説明しています。これらのコマンドは完全な名前を入力するまで表示されません。

12 12 

13コマンドはメッセージの開始時にのみ認識されます。コマンド名の後に続くテキストがその引数になります。[スキル](/docs/ja/skills#pass-arguments-to-skills)は例外です。スキル呼び出しの後に別のスキルが続く場合（例：`/skill-a /skill-b do XYZ`）、開始時に指定されたスキルが読み込まれ、末尾のテキストが各スキルに引数として渡されます。最大 6 つのスキルをチェーンできます。13コマンドはメッセージの開始時にのみ認識されます。コマンド名の後に続くテキストがその引数になります。ターミナルのプロンプトでは、1 つのメッセージを複数の[スキル](/docs/ja/skills#stack-several-skills-in-one-message)で始めることができます。`/skill-a /skill-b do XYZ` と入力すると両方のスキルが読み込まれ、末尾のテキストが各スキルに引数として渡されます。最大 6 つのスキルをチェーンできます。

14 14 

15Claude が応答中にコマンドを送信した場合、Claude Code はそれをキューに入れ、現在のターンが終了した後に実行します。Claude Code は `/status`、`/tasks`、`/usage` など、応答を中断せずにすぐに実行するコマンドもあります。[フルスクリーンレンダリング](/docs/ja/fullscreen)では、Claude Code は `/theme` や `/help` などのダイアログコマンドもすぐに開きます。v2.1.234 より前では、Claude Code はこれらのダイアログをターンが終了するまでキューに入れていました。15Claude が応答中にコマンドを送信した場合、Claude Code はそれをキューに入れ、現在のターンが終了した後に実行します。Claude Code は `/status`、`/tasks`、`/usage` など、応答を中断せずにすぐに実行するコマンドもあります。[フルスクリーンレンダリング](/docs/ja/fullscreen)では、Claude Code は `/theme` や `/help` などのダイアログコマンドもすぐに開きます。v2.1.234 より前では、Claude Code はこれらのダイアログをターンが終了するまでキューに入れていました。

16 16 

1137</Warning>1137</Warning>

1138 1138 

1139* **スリープまたはネットワーク切断の後**：プロセスが[まだ実行されて](#limits-while-desktop-is-disconnected)おり、Desktop がプロンプトなしでログインできる場合、実行中のタスクに戻れます。ログインできない場合は、[メッセージを送信](#reconnect-after-sleep-or-a-network-loss)してください。1139* **スリープまたはネットワーク切断の後**：プロセスが[まだ実行されて](#limits-while-desktop-is-disconnected)おり、Desktop がプロンプトなしでログインできる場合、実行中のタスクに戻れます。ログインできない場合は、[メッセージを送信](#reconnect-after-sleep-or-a-network-loss)してください。

1140* **終了後、macOS または Linux の Desktop で Claude アカウントを使用している場合**：Desktop が[プロセスに再参加](#reopen-a-session-after-you-quit-desktop)できれば、実行中のタスクに戻れます。再参加できない場合、タスクは停止します。停止したままの場合は、メッセージを送信してください。1140* **終了の後**: タスクは実行を続けますが、Desktop がそのプロセスに再参加できない限り、セッションを再度開いたときにタスクは失われます。終了する前に [Desktop が再参加できる場合](#reopen-a-session-after-you-quit-desktop)を確認してください。タスクが失われた場合は、メッセージを送信して続行します。

1141* **終了後、Windows の Desktop または[サードパーティプロバイダー](/docs/ja/third-party-integrations)を使用している場合**：Desktop はセッションを開いたときにプロセスを終了するため、実行中のタスクは失われます。続行するにはメッセージを送信してください。

1142 1141 

1143戻ったときにタスクが完了していない場合は、Desktop が再接続できないという知らせ、認証エラー、または待機中のリクエストがないか確認してください：1142戻ったときにタスクが完了していない場合は、Desktop が再接続できないという知らせ、認証エラー、または待機中のリクエストがないか確認してください：

1144 1143 

1154</h5>1153</h5>

1155 1154 

1156* **先に更新する**：長いタスクを開始する前に Desktop を更新してください。macOS と Windows では、Desktop はダウンロード済みのアップデートをインストールするために自動的に再起動することがあります。この再起動は、Claude が SSH タスクに取り組んでいる間は待機します。macOS で Claude アカウントを使用している場合、デフォルトでは、アップデートが 72 時間待機した後は、それでも再起動が実行されることがあります。1155* **先に更新する**：長いタスクを開始する前に Desktop を更新してください。macOS と Windows では、Desktop はダウンロード済みのアップデートをインストールするために自動的に再起動することがあります。この再起動は、Claude が SSH タスクに取り組んでいる間は待機します。macOS で Claude アカウントを使用している場合、デフォルトでは、アップデートが 72 時間待機した後は、それでも再起動が実行されることがあります。

1157* **Desktop を終了しない**：Desktop が Windows で実行されている場合、またはサードパーティプロバイダーを使用している場合は、長いタスクの実行中は Desktop を開いたままにしてください。終了した場合、Desktop はセッションを開いたときに[実行中のタスクを終了します](#reopen-a-session-after-you-quit-desktop)。開いたままにしても、[ユーザーを待機している](#handle-requests-that-arrive-while-you-are-away)リクエストは保護されません。1156* **Windows の場合、またはサードパーティプロバイダーで v2.42304.0 より前の場合は終了しない**: その場合は終了すると実行中のタスクが失われるため、タスクの間は Desktop を開いたままにしてください。それ以外の場合は、終了する前に[何が戻るか](#reopen-a-session-after-you-quit-desktop)を確認してください。

1158* **リクエストを減らす**：[タスクがユーザーを待つ頻度を減らす](#handle-requests-that-arrive-while-you-are-away)権限モード、ルール、またはフックを選択します1157* **リクエストを減らす**：[タスクがユーザーを待つ頻度を減らす](#handle-requests-that-arrive-while-you-are-away)権限モード、ルール、またはフックを選択します

1159* **ジャンプホストを確認する**：ジャンプホストがサインイン（スマートフォンへのプッシュ通知など）を求める場合は、プロンプトなしで機能するログインに切り替えてください。そうしないと、Desktop は再接続を試みるたびに別のプッシュ通知を送信する可能性があります。1158* **ジャンプホストを確認する**：ジャンプホストがサインイン（スマートフォンへのプッシュ通知など）を求める場合は、プロンプトなしで機能するログインに切り替えてください。そうしないと、Desktop は再接続を試みるたびに別のプッシュ通知を送信する可能性があります。

1160* **リモートマシンをテストする**：短いタスクを開始し、タスクの実行中に Desktop を終了して、タスクが完了しているはずの時刻を十分に過ぎてからセッションを再度開きます。タスクが完了しておらず、セッションに認証エラーが表示されていない場合は、リモートマシンで[タスクを終了させうる要因](#limits-while-desktop-is-disconnected)を確認してください。1159* **リモートマシンをテストする**：短いタスクを開始し、タスクの実行中に Desktop を終了して、タスクが完了しているはずの時刻を十分に過ぎてからセッションを再度開きます。タスクが完了しておらず、セッションに認証エラーが表示されていない場合は、リモートマシンで[タスクを終了させうる要因](#limits-while-desktop-is-disconnected)を確認してください。

1206 1205 

1207Desktop が切断されている間に Claude が承認を必要とするか質問をした場合、Claude はリモートマシン上で待機します。この待機自体には時間制限はありません。Desktop がプロセスに再参加すると、リクエストが表示されます。Desktop が代わりに新しいプロセスを開始した場合、リクエストは失われます。1206Desktop が切断されている間に Claude が承認を必要とするか質問をした場合、Claude はリモートマシン上で待機します。この待機自体には時間制限はありません。Desktop がプロセスに再参加すると、リクエストが表示されます。Desktop が代わりに新しいプロセスを開始した場合、リクエストは失われます。

1208 1207 

1209タスクがユーザーを待機している間に、Desktop はアップデートのインストールなどのために自動的に再起動することがあります。Desktop が Windows で実行されている場合、またはサードパーティプロバイダーを使用している場合、その再起動後にリクエストは失われます。1208戻ったときに待機していたリクエストがなくなっている場合、原因の 1 つとして、アップデートのインストールなどのために Desktop が自動的に再起動したことが考えられます。再起動後もリクエストが保持されるのは Desktop がプロセスに再参加できる場合のみであるため、タスクを実行したままにする前に [Desktop が再参加できる場合](#reopen-a-session-after-you-quit-desktop)を確認してください。

1210 1209 

1211リクエストが失われた場合は、メッセージを送信して続行してください。1210リクエストが失われた場合は、メッセージを送信して続行してください。

1212 1211 

1238 - **ジャンプホスト、プッシュ通知が届き続ける**：Windows の Desktop のように、Desktop が誰も応答していないことを判別できない場合、再参加するプロセスがある間は、そのプロセスがまだ実行中かどうかにかかわらず試行を続けます。試行のたびに別のプッシュ通知が届くことがあります。試行を終了するには Desktop を終了しますが、その場合は[実行中のタスクが失われる可能性があります](#reopen-a-session-after-you-quit-desktop)。1237 - **ジャンプホスト、プッシュ通知が届き続ける**：Windows の Desktop のように、Desktop が誰も応答していないことを判別できない場合、再参加するプロセスがある間は、そのプロセスがまだ実行中かどうかにかかわらず試行を続けます。試行のたびに別のプッシュ通知が届くことがあります。試行を終了するには Desktop を終了しますが、その場合は[実行中のタスクが失われる可能性があります](#reopen-a-session-after-you-quit-desktop)。

1239 - **長時間の停止**：Desktop は約 5 分ごとに 1 回の試行にペースを落とします。早く再接続するには、セッションで再試行するか、メッセージを送信します。メッセージは接続後に Desktop が配信します。1238 - **長時間の停止**：Desktop は約 5 分ごとに 1 回の試行にペースを落とします。早く再接続するには、セッションで再試行するか、メッセージを送信します。メッセージは接続後に Desktop が配信します。

1240 - **出力の欠落**：Desktop が切断されている間、ヘルパーは各セッションの最新の Claude Code 出力を 16 MiB のバッファに保持し、それより古い出力は破棄します。Desktop が再接続した後、セッションに `Loading recent output from <host>…` と表示されることがあります。Desktop がすべての出力を読み込めない場合は、`Some output produced while you were disconnected may be missing here.` という行が表示されます。この行はタスクが停止したことを意味するものではありません。1239 - **出力の欠落**：Desktop が切断されている間、ヘルパーは各セッションの最新の Claude Code 出力を 16 MiB のバッファに保持し、それより古い出力は破棄します。Desktop が再接続した後、セッションに `Loading recent output from <host>…` と表示されることがあります。Desktop がすべての出力を読み込めない場合は、`Some output produced while you were disconnected may be missing here.` という行が表示されます。この行はタスクが停止したことを意味するものではありません。

1241 - **プロセスが存在しない**：Desktop の再接続時にプロセスが存在しない場合、Desktop は会話の保存された履歴から新しいプロセスを開始し、タスクを続行するよう Claude に指示することがあります。プロセスが繰り返し終了する場合、または Desktop がサードパーティプロバイダーを使用している場合、Desktop はタスクを自動的に続行しません。メッセージを送信して続行してください。1240 - **プロセスがなくなった**: リモートマシンの再起動時など、Desktop が切断されている間にプロセスが終了した状態です。その場合、Desktop は会話の保存された履歴から新しいプロセスを開始し、Claude にタスクを続行するよう指示できます。タスクが停止したままの場合は、メッセージを送信してください。サードパーティプロバイダーの場合は、それより前のバージョンでは自動的にタスクが続行されることはないため、Claude Desktop v2.42304.0 以降に更新してください。

1242</Accordion>1241</Accordion>

1243 1242 

1244<a id="reopen-a-session-after-you-quit-desktop" />1243<a id="reopen-a-session-after-you-quit-desktop" />

1247 Desktop を終了した後にセッションを再度開く1246 Desktop を終了した後にセッションを再度開く

1248</h5>1247</h5>

1249 1248 

1250Desktop を終了した後も、タスクはリモートマシン上で、完了するか、ユーザーの対応が必要になるか、いずれかの[制限](#limits-while-desktop-is-disconnected)に達するまで実行を続けます。1249Desktop を終了した後もタスクはリモートマシン上で実行を続けますが、Desktop がそのプロセスに再参加できない限り、セッションを再度開いたときに停止します。Desktop が閉じている間、タスクは完了するか、ユーザーの対応が必要になるか、[制限](#limits-while-desktop-is-disconnected)のいずれかに達するまで実行されます。

1251 1250 

1252* **macOS または Linux の Desktop で Claude アカウントを使用している場合**：Desktop を起動してセッションを開きます。Desktop がプロセスに再参加できると、実行中のタスクに戻れます。一部の Desktop アップデートの後や、組織が管理設定を変更した後など、常に再参加できるとは限りません。1251* **Windows の Desktop**: Desktop は終了後に再参加することがないため、実行中のタスクは戻りません。Desktop の起動時にセッションが開くことがあるため、タスクが完了していると見込まれるときにのみ Desktop を再度起動してください。

1253* **macOS または Linux で、Desktop が再参加できない場合**：Desktop はプロセスを終了し、会話の保存された履歴から新しいプロセスを開始します。実行中のタスクは停止し、待機していた承認や質問は失われます。アップデートの後は、Desktop がその後 Claude に続行を指示することがあります。タスクが停止したままの場合は、メッセージを送信してください。1252* **サードパーティプロバイダー、以前のバージョンのタスク**: v2.42304.0 より前の Desktop バージョンでタスクを開始した場合、macOS や Linux でもタスクは戻りません。タスクが完了していると見込まれるときにのみ Desktop を再度起動してください。

1254* **Windows の Desktop、または任意のプラットフォームでサードパーティプロバイダーを使用している場合**：タスクが完了していると見込まれるときにのみ Desktop を再起動してください。Desktop は終了後に再参加することがないため、実行中のタスクには戻れません。Desktop はセッションを開いたときにプロセスを終了し、これは Desktop の起動時に発生することがあります。メッセージを送信して続行してください。1253* **その他のタスク（macOS または Linux の Desktop）**: Desktop を起動してセッションを開くと、Desktop が再参加した場合はタスクが続行されます。一部の Desktop アップデートの後など、常に再参加できるとは限らないため、[長時間のタスクの前に更新してください](#prepare-a-long-task)。

1254 

1255Desktop が再参加できない場合、待機していた承認や質問も失われます。タスクが自動的に続行されない場合はメッセージを送信すると、Claude は会話の保存された履歴から続行します。

1255 1256 

1256サードパーティのデプロイについては、[SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions) を参照してください。1257サードパーティのデプロイについては、[SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions) を参照してください。

1257 1258 

186 | - | - | - |186 | - | - | - |

187 | **実行** | シェルコマンド、HTTP リクエスト、MCP ツール呼び出し、LLM プロンプト、または subagent | Claude が読み取って従う指示 |187 | **実行** | シェルコマンド、HTTP リクエスト、MCP ツール呼び出し、LLM プロンプト、または subagent | Claude が読み取って従う指示 |

188 | **トリガー** | [ライフサイクルイベント](/docs/ja/hooks#hook-events)（`PostToolUse` または `SessionStart` など） | `/<name>` を入力するか、Claude が説明をタスクに一致させる |188 | **トリガー** | [ライフサイクルイベント](/docs/ja/hooks#hook-events)（`PostToolUse` または `SessionStart` など） | `/<name>` を入力するか、Claude が説明をタスクに一致させる |

189 | **決定論** | イベントで常に発火します。トリガーは保証されます | Claude が指示を解釈します。結果は異なる場合があります |189 | **決定論** | Claude の判断なしにイベントで発火します | Claude が指示を解釈します。結果は異なる場合があります |

190 | **コンテキストコスト** | フックが出力を返さない限りゼロ | 説明は各セッションで読み込まれます。完全なコンテンツは使用時に読み込まれます |190 | **コンテキストコスト** | フックが出力を返さない限りゼロ | 説明は各セッションで読み込まれます。完全なコンテンツは使用時に読み込まれます |

191 | **最適な用途** | 編集後のリント、安全でないコマンドのブロック、ログ、通知 | Claude が手順を適用する方法を決定する必要があるワークフロー、参照資料、複数ステップのタスク |191 | **最適な用途** | 編集後のリント、安全でないコマンドのブロック、ログ、通知 | Claude が手順を適用する方法を決定する必要があるワークフロー、参照資料、複数ステップのタスク |

192 192 

1832 1832 

1833[PreToolUse の決定制御](#pretooluse-decision-control)を使用して、ツール呼び出しを許可、拒否、確認、または遅延します。1833[PreToolUse の決定制御](#pretooluse-decision-control)を使用して、ツール呼び出しを許可、拒否、確認、または遅延します。

1834 1834 

1835タイムアウトを超えた `PreToolUse` の [Agent SDK コールバックフック](/docs/ja/agent-sdk/hooks)はツール呼び出しをブロックし、Claude はタイムアウトを示すエラー結果を受け取ります。別のフックが返した明示的な拒否は引き続き優先されます。1835`PreToolUse` の [Agent SDK コールバックフック](/docs/ja/agent-sdk/hooks)がタイムアウトを超えると、ツール呼び出しはブロックされ、Claude はタイムアウトを示すエラー結果を受け取ります。

1836 1836 

1837<h4 id="pretooluse-input">1837<h4 id="pretooluse-input">

1838 PreToolUse の入力1838 PreToolUse の入力

213インストールが失敗した場合は、Claude Code が報告するメッセージに一致させます。213インストールが失敗した場合は、Claude Code が報告するメッセージに一致させます。

214 214 

215* `Marketplace "claude-plugins-official" not found`: `/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行します。215* `Marketplace "claude-plugins-official" not found`: `/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行します。

216* プラグインが[マーケットプレイスで見つかりません](/docs/ja/plugins/install#install-a-plugin): プラグイン名を確認します。216* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: マーケットプレイスカタログのローカルコピーが古くなっている可能性があります。`/plugin marketplace update claude-plugins-official` で更新してから、インストールを再試行します。再試行しても同じメッセージが表示される場合は、[Plugin not found in marketplace](/docs/ja/plugins/troubleshooting#plugin-not-found-in-marketplace) を参照してください。

217 217 

218プラグインを自分でインストールするのではなく、リポジトリ内のすべての人に対して有効にするには、[`enabledPlugins` プロジェクト設定](/docs/ja/settings-reference#plugin-settings)に追加します。218プラグインを自分でインストールするのではなく、リポジトリ内のすべての人に対して有効にするには、[`enabledPlugins` プロジェクト設定](/docs/ja/settings-reference#plugin-settings)に追加します。

219 219 

50 インストールが失敗した場合は、Claude Code が報告するメッセージに一致させてください：50 インストールが失敗した場合は、Claude Code が報告するメッセージに一致させてください：

51 51 

52 * `Marketplace "claude-plugins-official" not found`：`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行してください。52 * `Marketplace "claude-plugins-official" not found`：`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行してください。

53 * [プラグインがマーケットプレイスで見つかりません](/docs/ja/plugins/install#install-a-plugin)：プラグイン名を確認してください。53 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`：マーケットプレイスカタログのローカルコピーが古くなっている可能性があります。`/plugin marketplace update claude-plugins-official` で更新してから、インストールを再試行してください。再試行しても同じメッセージが表示される場合は、[Plugin not found in marketplace](/docs/ja/plugins/troubleshooting#plugin-not-found-in-marketplace) を参照してください。

54 54 

55 インストール概要が `Run /reload-plugins to apply.` を報告する場合、Claude Code はその後、そのリロードを実行します。リロードが次のメッセージが会話を再度読み込むことになると警告する場合は、`/reload-plugins --force` を実行してください。55 インストール概要が `Run /reload-plugins to apply.` を報告する場合、Claude Code はその後、そのリロードを実行します。リロードが次のメッセージが会話を再度読み込むことになると警告する場合は、`/reload-plugins --force` を実行してください。

56 </Step>56 </Step>

772**属性**:772**属性**:

773 773 

774* すべての[標準属性](#standard-attributes)774* すべての[標準属性](#standard-attributes)

775* `type`: （`"input"`、`"output"`、`"cacheRead"`、`"cacheCreation"`）。`"input"` タイプには、プロンプトキャッシュから読み取られた、またはプロンプトキャッシュに書き込まれたトークンは含まれません。これらは `"cacheRead"` と `"cacheCreation"` でカウントされます775* `type`: (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`)。`"input"` タイプには、プロンプトキャッシュから読み取られた、またはプロンプトキャッシュに書き込まれたトークンは含まれず、それらは `"cacheRead"` と `"cacheCreation"` でカウントされます。`"cacheCreation"` タイプは、5 分と 1 時間の[キャッシュ有効期間](/docs/ja/prompt-caching#cache-lifetime)のキャッシュ書き込みをまとめてカウントします。

776* `model`: モデル識別子（例: "claude-sonnet-5"）776* `model`: モデル識別子（例: "claude-sonnet-5"）

777* `query_source`: リクエストを発行したサブシステムのカテゴリ。`"main"`、`"subagent"`、`"auxiliary"` のいずれか777* `query_source`: リクエストを発行したサブシステムのカテゴリ。`"main"`、`"subagent"`、`"auxiliary"` のいずれか

778* `speed`: リクエストが fast mode を使用した場合は `"fast"`。それ以外の場合は含まれません778* `speed`: リクエストが fast mode を使用した場合は `"fast"`。それ以外の場合は含まれません

749次のチェックは引き続き適用されます。749次のチェックは引き続き適用されます。

750 750 

751* `Bash(git push *)` のような内容を限定した確認ルールは、引き続き確認を強制します751* `Bash(git push *)` のような内容を限定した確認ルールは、引き続き確認を強制します

752* 明示的な拒否ルールは引き続き適用されます

753* [重要なパス](/docs/ja/permission-modes#critical-paths)を対象とする `rm` または `rmdir` コマンドは、引き続き通常の権限フローを経由します

754* [自動許可モード](/docs/ja/sandboxing#auto-allow-mode)で説明されているように、その他のサンドボックス化されたコマンドも通常の権限フローを経由する場合があります752* [自動許可モード](/docs/ja/sandboxing#auto-allow-mode)で説明されているように、その他のサンドボックス化されたコマンドも通常の権限フローを経由する場合があります

755 753 

756除外されたコマンドなど、サンドボックス内で実行されないコマンドは、通常どおり単独の `Bash` 確認ルールに従います。この動作を変更するには、[サンドボックスモード](/docs/ja/sandboxing#sandbox-modes)を参照してください。754除外されたコマンドなど、サンドボックス内で実行されないコマンドは、通常どおり単独の `Bash` 確認ルールに従います。この動作を変更するには、[サンドボックスモード](/docs/ja/sandboxing#sandbox-modes)を参照してください。

78 78 

79Mod は既に持っているコントロールを置き換えません。79Mod は既に持っているコントロールを置き換えません。

80 80 

81* **設定フックは引き続き機能します。** 設定ファイルおよびプラグインの `hooks/hooks.json` 内のコマンド、HTTP、プロンプト、エージェントフックは以前と同じように実行され、mod と並行して実行されます。これについて非推奨のものはありません。81* **設定フックは引き続き機能します。** 設定ファイルおよびプラグインの `hooks/hooks.json` 内のコマンド、HTTP、プロンプト、エージェントフックは以前と同じように実行され、mod と並行して実行されます。

82* **拒否ルールはガードが読み込まれる場所で優先されます。** ユーザーの mod は、`deny` ルールが拒否する呼び出しを承認することはできません。ただし、[`allowModsToOverrideDenyRules`](#set-options-on-the-built-in-guard) を設定する場合を除きます。82* **拒否ルールはガードが読み込まれる場所で優先されます。** ユーザーの mod は、`deny` ルールが拒否する呼び出しを承認することはできません。ただし、[`allowModsToOverrideDenyRules`](#set-options-on-the-built-in-guard) を設定する場合を除きます。

83* **管理フックが最初に実行されます。** 管理設定の `PreToolUse` フックは、mod がツール呼び出しを見る前に実行され、そのブロックは最終的です。mod がその後呼び出しを書き直す場合、管理フックは書き直された呼び出しで再度実行されるため、ブロックは引き続き適用されます。他の設定ファイルおよびプラグインからの `PreToolUse` フックは最後の mod の後に実行されるため、独自の結果を返すツール実行の代わりに返す mod は、それらが実行されるのを防ぎます。[Mod が実行される順序](/docs/ja/plugins/mods/events#the-order-mods-run-in) を参照してください。83* **管理フックが最初に実行されます。** 管理設定の `PreToolUse` フックは、mod がツール呼び出しを見る前に実行され、そのブロックは最終的です。mod がその後呼び出しを書き直す場合、管理フックは書き直された呼び出しで再度実行されるため、ブロックは引き続き適用されます。他の設定ファイルおよびプラグインからの `PreToolUse` フックは最後の mod の後に実行されるため、独自の結果を返すツール実行の代わりに返す mod は、それらが実行されるのを防ぎます。[Mod が実行される順序](/docs/ja/plugins/mods/events#the-order-mods-run-in) を参照してください。

84* **ネットワークポリシーは `$.http.fetch` をカバーします。**84* **ネットワークポリシーは `$.http.fetch` をカバーします。**

114 `Text`114 `Text`

115</h3>115</h3>

116 116 

117`Text` は、指定したスタイルで文字列を描画します。このサンプルでは、スタイルごとに 1 行ずつ表示します。117`Text` は、指定したスタイルで文字列を描画します。このサンプルでは、プレーンテキストと 8 つのスタイルを 1 行ずつ表示します。

118 118 

119```javascript theme={null}119```javascript theme={null}

120Box({120Box({

455 455 

456| 要素 | 描画する内容 | 使用できる場所 |456| 要素 | 描画する内容 | 使用できる場所 |

457| :- | :- | :- |457| :- | :- | :- |

458| `Box` | flex コンテナ。`flexDirection`、`columnGap`、`padding`、[`borderStyle`](/docs/ja/plugins/mods/reference#box-border-styles)、`width` などのレイアウト props を受け取ります。 | すべて |458| `Box` | flex コンテナ。`flexDirection`、[`borderStyle`](/docs/ja/plugins/mods/reference#box-border-styles)、`width` などのレイアウト props を受け取ります。`columnGap` や `padding` などの間隔の props には、数値、または `'xs'` から `'xl'` までの[ステップ名](/docs/ja/plugins/mods/reference#box-spacing-steps)を指定します。 | すべて |

459| `Text` | スタイル付きテキスト。`color`、`bold`、`dimColor`、`italic`、`wrap` を受け取ります。`color` はテーマキー、または `'red'` などのカラーです。`wrap` は `'wrap'`、`'truncate'`、`'truncate-start'`、`'truncate-middle'`、`'truncate-end'` のいずれかです。 | すべて |459| `Text` | スタイル付きテキスト。`color`、`bold`、`dimColor`、`italic`、`wrap` のほか、[`weight`](/docs/ja/plugins/mods/reference#text-typography) などを受け取ります。`color` はテーマキー、または `'red'` などのカラーです。`wrap` は `'wrap'`、`'truncate'`、`'truncate-start'`、`'truncate-middle'`、`'truncate-end'` のいずれかです。 | すべて |

460| `Button` | `onPress` を呼び出すコントロール | すべて |460| `Button` | `onPress` を呼び出すコントロール | すべて |

461| `Link`、`Code`、`Markdown` | `href` と任意の `label` を持つリンク、コードブロック、Claude の返信と同じ形式で整形されたテキスト。`Markdown` はコンテンツを `children` ではなく `text` props で受け取り、`onLinkPress` を渡す場合は `key` が必要です。 | すべて |461| `Link`、`Code`、`Markdown` | `href` と任意の `label` を持つリンク、コードブロック、Claude の返信と同じ形式で整形されたテキスト。`Markdown` はコンテンツを `children` ではなく `text` props で受け取り、`onLinkPress` を渡す場合は `key` が必要です。 | すべて |

462| `Input`、`Select` | テキストフィールドとドロップダウン | ターミナル、Desktop、VS Code |462| `Input`、`Select` | テキストフィールドとドロップダウン | ターミナル、Desktop、VS Code |

293 293 

294| 要素 | 主な props | Terminal | Desktop | VS Code |294| 要素 | 主な props | Terminal | Desktop | VS Code |

295| :- | :- | :-: | :-: | :-: |295| :- | :- | :-: | :-: | :-: |

296| [`Box`](/docs/ja/plugins/mods/interface#build-a-tree-from-elements) | `key`、flex レイアウト、`gap`、`padding`、`margin`、`width`、`height`、[`borderStyle`](#box-border-styles)、`backgroundColor`、`position`、`hover` | ✓ | ✓ | ✓ |296| [`Box`](/docs/ja/plugins/mods/interface#build-a-tree-from-elements) | `key`、flex レイアウト、[`gap`、`padding`、`margin`](#box-spacing-steps)、`width`、`height`、[`borderStyle`](#box-border-styles)、`backgroundColor`、`position`、`hover` | ✓ | ✓ | ✓ |

297| [`Text`](/docs/ja/plugins/mods/interface#build-a-tree-from-elements) | `color`、`backgroundColor`、`bold`、`italic`、`underline`、`dimColor`、`inverse`、`wrap` | ✓ | ✓ | ✓ |297| [`Text`](/docs/ja/plugins/mods/interface#build-a-tree-from-elements) | `color`、`backgroundColor`、[`bold`](#text-bold)、`italic`、`underline`、`dimColor`、`inverse`、`wrap`、[`size`、`weight`、`mono`、`tabular`](#text-typography) | ✓ | ✓ | ✓ |

298| [`Button`](/docs/ja/plugins/mods/interface#respond-to-presses-and-typing) | `key`、`label`、`onPress`、`hotkey`、`plain`、`dimColor`、`autoFocus`、`action` | ✓ | ✓ | ✓ |298| [`Button`](/docs/ja/plugins/mods/interface#respond-to-presses-and-typing) | `key`、`label`、`onPress`、`hotkey`、`plain`、`dimColor`、`autoFocus`、`action` | ✓ | ✓ | ✓ |

299| [`Link`](/docs/ja/plugins/mods/interface#link-in-the-desktop-app) | `href`、`label`。[制限](#limits)を参照してください。 | ✓ | ✓ | ✓ |299| [`Link`](/docs/ja/plugins/mods/interface#link-in-the-desktop-app) | `href`、`label`。[制限](#limits)を参照してください。 | ✓ | ✓ | ✓ |

300| [`Code`](/docs/ja/plugins/mods/gallery#show-code-and-changes) | `source`、`language`、`path`、`startLine`、`format`、`wrap` | ✓ | ✓ | ✓ |300| [`Code`](/docs/ja/plugins/mods/gallery#show-code-and-changes) | `source`、`language`、`path`、`startLine`、`format`、`wrap` | ✓ | ✓ | ✓ |

311VS Code 拡張機能は一部の要素の props を無視し、それらを省略した場合と同じように要素を描画します。311VS Code 拡張機能は一部の要素の props を無視し、それらを省略した場合と同じように要素を描画します。

312 312 

313* **`Box`**：`position` と `hover`313* **`Box`**：`position` と `hover`

314* **`Text`**：`size`、`mono`、`tabular`

314* **`Button`**：`hotkey`、`plain`、`autoFocus`、`action`。そのため VS Code では、ユーザーはクリックするか、ボタンにフォーカスがある状態で Enter キーを押してボタンを押します315* **`Button`**：`hotkey`、`plain`、`autoFocus`、`action`。そのため VS Code では、ユーザーはクリックするか、ボタンにフォーカスがある状態で Enter キーを押してボタンを押します

315* **`Code`**：`language`、`path`、`startLine`、`format`、`wrap`。そのため、コードは色や行番号なしで描画され、`format: 'diff'` のブロックは差分の生のテキストを表示します316* **`Code`**：`language`、`path`、`startLine`、`format`、`wrap`。そのため、コードは色や行番号なしで描画され、`format: 'diff'` のブロックは差分の生のテキストを表示します

316* **`Input` と `Select`**：`autoFocus`317* **`Input` と `Select`**：`autoFocus`

336 337 

337`borderStyle` に `'rounded'` など、これら以外の名前を指定した `Box` は枠線なしで描画されます。338`borderStyle` に `'rounded'` など、これら以外の名前を指定した `Box` は枠線なしで描画されます。

338 339 

340<h3 id="box-spacing-steps">

341 `Box` の間隔ステップ

342</h3>

343 

344`Box` の間隔 props は `gap`、`columnGap`、`rowGap`、`padding`、`margin`、および `paddingX` や `marginTop` のような `padding` と `margin` の片側・片軸の形式です。それぞれ `gap: 1` のようなターミナルのセル数、または `gap: 'md'` のようなステップ名を受け取ります。ターミナルと VS Code 拡張機能では、各ステップは次のセル数になります。

345 

346| ステップ | 横方向のセル数 | 縦方向のセル数 |

347| :- | :- | :- |

348| `'xs'` | 1 | 0 |

349| `'sm'` | 1 | 0 |

350| `'md'` | 2 | 1 |

351| `'lg'` | 3 | 1 |

352| `'xl'` | 4 | 2 |

353 

354`gap`、`padding`、`margin` にステップを設定すると、そのステップは横方向と縦方向の両方に同時に適用されます。たとえばターミナルと VS Code 拡張機能では、`padding: 'md'` は左右それぞれ 2 セル、上下それぞれ 1 行になります。

355 

356ステップ名には Claude Code v2.1.299 以降が必要です。それより前のリリースでは、ステップ名を使用するツリーの代わりに、Claude Code が[独自バージョンのサイトを描画します](/docs/ja/plugins/mods/interface#build-a-tree-from-elements)。

357 

358<h3 id="text-typography">

359 `Text` のタイポグラフィ props

360</h3>

361 

362`Text` に `size`、`weight`、`mono`、`tabular` を設定すると、ツリーを描画するアプリに対して、文字サイズ、太さ、等幅書体、または等幅の数字を要求できます。props を利用する前に、ターミナルと VS Code 拡張機能でその props がどう扱われるかを確認してください。設定した props をアプリが無視する場合でも、ツリーはそのアプリで描画され、テキストはその props を省略した場合と同じように表示されます。

363 

364| props | 値 | ターミナルでの動作 | VS Code 拡張機能での動作 |

365| :- | :- | :- | :- |

366| `size` | `'caption'`、`'footnote'`、`'body'`、`'heading'`、`'title'` | 無視されます（ターミナルの文字サイズは 1 種類のみ） | 無視されます |

367| `weight` | `'regular'`、`'medium'`、`'semibold'`、`'bold'` | `semibold` と `bold` は太字で描画されます | `semibold` と `bold` は太字で描画されます |

368| `mono` | `true` でアプリの等幅書体を要求します | 無視されます（ターミナルは常に等幅） | 無視され、テキストは拡張機能独自の書体のままになります |

369| `tabular` | `true` で等幅の数字を要求し、その場で更新される数値や数値の列の位置を揃えます | 無視されます（ターミナルの数字はすでに 1 セル幅） | 無視されます |

370 

371これら 4 つの props には Claude Code v2.1.299 以降が必要です。それより前のリリースでは、`size`、`weight`、`mono`、`tabular` を設定したツリーの代わりに、Claude Code が[独自バージョンのサイトを描画します](/docs/ja/plugins/mods/interface#build-a-tree-from-elements)。

372 

373<h4 id="text-bold">

374 `bold` を `weight` に置き換える

375</h4>

376 

377`Text` の `bold` は非推奨となり `weight` が推奨されていますが、引き続き動作します。`weight` を指定していない `Text` で置き換えるには、`bold: true` を `weight: 'semibold'` に変更すると、Claude Code v2.1.299 以降で同じ結果になります。

378 

379v2.1.299 より前のリリースでは、`weight` を設定したツリーは描画されず、代わりに Claude Code が[独自バージョンのサイトを描画します](/docs/ja/plugins/mods/interface#build-a-tree-from-elements)。`Text` に `bold` と `weight` の両方を設定した場合、`bold` は効果を持ちません。

380 

339<h2 id="limits">381<h2 id="limits">

340 制限382 制限

341</h2>383</h2>

235 235 

236mod が読み込まれ、そのペイン、バンド、トースト、またはコントロールが期待どおりに動作しません。236mod が読み込まれ、そのペイン、バンド、トースト、またはコントロールが期待どおりに動作しません。

237 237 

238<h3 id="another-mods-band-shows-and-yours-doesnt">

239 別の mod のバンドが表示され、自分のバンドが表示されない

240</h3>

241 

242プロンプトの上にはバンドが 1 つしかなく、すべての mod がそれを共有します。[自分の mod より前に](/docs/ja/plugins/mods/events#the-order-mods-run-in) 実行される mod が `next(e)` の結果を含まないツリーを返すと、自分のバンドが置き換えられます。両方のバンドを表示するには、その mod のフックを変更するか、作成者に変更を依頼してください。

243 

244* **後続のバンドを残す**: [描画する場所を選ぶ](/docs/ja/plugins/mods/interface#pick-where-to-draw) の「プロンプトの上のバンド」タブのように、`await next(e)` の結果をツリー内の `Box` の子要素に含めます

245* **ツリーを有効に保つ**: その `Box` や、それを囲む `Box` に、`width`、`height`、`minWidth`、`minHeight`、`position`、`top`、`left`、`right`、`bottom`、`display`、`overflow` の props を指定しないでください

246 

247その mod を見つけるには、[デバッグログを書き出し](#read-the-debug-log)、`answered ui.render without next()` を検索します。`other-mod (user) answered ui.render without next()` のような行は、`next(e)` を呼び出さずにツリーを返した mod を示します。この行は [描画箇所](/docs/ja/plugins/mods/reference#render-sites) を示さないため、ペインのみの mod が表示されることもあります。`next(e)` を呼び出してもその結果を破棄する mod については行が出力されないため、自分の mod より前のフックも確認してください。

248 

249変更後、いずれかの mod が検証を通らないツリーを返すと、バンドには何も表示されません。理由を確認するには、`--plugin-dir` セッションのトランスクリプトで `ui.render (AbovePrompt) refused:` の行を探すか、デバッグログで `does not validate` を検索します。バンドに複数の mod がある場合、どちらの行も mod を示さないため、各 mod のツリーを確認してください。

250 

238<h3 id="a-pane-or-band-is-empty-or-shows-claude-code’s-usual-content">251<h3 id="a-pane-or-band-is-empty-or-shows-claude-code’s-usual-content">

239 ペインまたはバンドが空であるか、Claude Code の通常のコンテンツを表示する252 ペインまたはバンドが空であるか、Claude Code の通常のコンテンツを表示する

240</h3>253</h3>

199 199 

200auto-allow モードでも、次の点は引き続き適用されます。200auto-allow モードでも、次の点は引き続き適用されます。

201 201 

202* 明示的な[拒否ルール](/docs/ja/permissions)は常に尊重されます202* [`Bash` の拒否ルールが一致する形式](/docs/ja/permissions#bash-rule-limits)のコマンドは、引き続きブロックされます

203* [重要なパス](/docs/ja/permission-modes#critical-paths)を対象とする `rm` または `rmdir` コマンドは、引き続き通常の権限フローを経由します203* [重要なパス](/docs/ja/permission-modes#which-paths-are-critical)を対象とすると認識された `rm` または `rmdir` コマンドは、引き続き通常の権限フローを経由します

204* `Bash(git push *)` のような内容を限定した[確認ルール](/docs/ja/permissions)は、サンドボックス化されたコマンドであっても引き続きプロンプトを強制します204* `Bash(git push *)` のような内容を限定した[確認ルール](/docs/ja/permissions)は、サンドボックス化されたコマンドであっても引き続きプロンプトを強制します

205* 単独の `Bash` 確認ルール、またはそれと同等の `Bash(*)` 形式は、サンドボックス化されて実行されるコマンドではスキップされます。サンドボックス外で実行されるコマンドには引き続き適用されます。[plan モード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)では、このルールはスキップされず、読み取り専用のものも含め、サンドボックス化されたコマンドに対してもプロンプトを表示します205* 単独の `Bash` 確認ルール、またはそれと同等の `Bash(*)` 形式は、サンドボックス化されて実行されるコマンドではスキップされます。サンドボックス外で実行されるコマンドには引き続き適用されます。[plan モード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)では、このルールはスキップされず、読み取り専用のものも含め、サンドボックス化されたコマンドに対してもプロンプトを表示します

206* [Monitor ツール](/docs/ja/tools-reference#monitor-tool)のコマンドは、引き続きサンドボックス内で実行されますが、自動的には承認されません。プロンプトをスキップするには、`Bash(npm run *)` など、そのコマンドに一致する[許可ルール](/docs/ja/permissions#bash)を追加します206* [Monitor ツール](/docs/ja/tools-reference#monitor-tool)のコマンドは、引き続きサンドボックス内で実行されますが、自動的には承認されません。プロンプトをスキップするには、`Bash(npm run *)` など、そのコマンドに一致する[許可ルール](/docs/ja/permissions#bash)を追加します

112 IDE セキュリティ112 IDE セキュリティ

113</h2>113</h2>

114 114 

115IDE で Claude Code を実行する場合の詳細については、[VS Code security and privacy](/docs/ja/vs-code#security-and-privacy) を参照してください。115IDE で Claude Code を実行する場合の詳細については、[組み込みの IDE MCP サーバー](/docs/ja/vs-code#the-built-in-ide-mcp-server)を参照してください。

116 116 

117<h2 id="cloud-execution-security">117<h2 id="cloud-execution-security">

118 クラウド実行セキュリティ118 クラウド実行セキュリティ

42インストールが失敗した場合、Claude Code が報告するメッセージに一致させてください：42インストールが失敗した場合、Claude Code が報告するメッセージに一致させてください：

43 43 

44* `Marketplace "claude-plugins-official" not found`：`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行してください。44* `Marketplace "claude-plugins-official" not found`：`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行してください。

45* [プラグインがマーケットプレイスで見つかりません](/docs/ja/plugins/install#install-a-plugin)：プラグイン名を確認してください。45* `Plugin "<name>" not found in marketplace "claude-plugins-official"`：ローカルにあるマーケットプレイスカタログのコピーが古くなっている可能性があります。`/plugin marketplace update claude-plugins-official` で更新してから、インストールを再試行してください。再試行しても同じメッセージが表示される場合は、[マーケットプレイスでプラグインが見つからない](/docs/ja/plugins/troubleshooting#plugin-not-found-in-marketplace)を参照してください。

46 46 

47インストール概要を確認してください。`Run /reload-plugins to apply.` と報告された場合、[プラグイン変更を再起動なしで適用](/docs/ja/plugins/cli-reference#reload-plugins)を参照して、現在のセッションでプラグインを有効化してください。47インストール概要を確認してください。`Run /reload-plugins to apply.` と報告された場合、[プラグイン変更を再起動なしで適用](/docs/ja/plugins/cli-reference#reload-plugins)を参照して、現在のセッションでプラグインを有効化してください。

48 48 

718 718 

719スキルに引数を指定して呼び出しても、スキルのコンテンツのプレースホルダーが 1 つも受け取らない場合、Claude Code は `ARGUMENTS: <your input>` をスキルコンテンツの最後に追加するため、Claude は依然として入力したものを見ます。プレースホルダーは `$ARGUMENTS`、`$1` などのインデックス形式、または名前付き引数です。対応する引数がないインデックス付きプレースホルダーはリテラルテキストのままで、1 つを受け取ったとしてカウントされません。名前付きプレースホルダーは、位置に引数がない場合でも、空の文字列に展開されるため、カウントされます。719スキルに引数を指定して呼び出しても、スキルのコンテンツのプレースホルダーが 1 つも受け取らない場合、Claude Code は `ARGUMENTS: <your input>` をスキルコンテンツの最後に追加するため、Claude は依然として入力したものを見ます。プレースホルダーは `$ARGUMENTS`、`$1` などのインデックス形式、または名前付き引数です。対応する引数がないインデックス付きプレースホルダーはリテラルテキストのままで、1 つを受け取ったとしてカウントされません。名前付きプレースホルダーは、位置に引数がない場合でも、空の文字列に展開されるため、カウントされます。

720 720 

7211 つのメッセージの先頭に複数のスキルをスタックすることもできます。`/write-tests /fix-issue 123` と入力すると、両方のスキルが読み込まれ、末尾のテキスト `123` が `$ARGUMENTS` として各スキルに渡されます。

722 

723Claude Code は最初のスキルと、その後にスタックされた最大 5 つのスキルを展開します。展開は、インラインのユーザー呼び出し可能スキルではない最初のトークンで停止するため、[フォークされたサブエージェント](#run-skills-in-a-subagent) として実行されるスキル（[`/code-review`](/docs/ja/code-review-local) など）、またはその引数自体がスラッシュコマンドで始まる可能性があるスキル（`/loop` など）も、そこで展開を終了します。そのトークンとその後のすべてが、展開されたすべてのスキルの引数テキストになります。v2.1.218 から `/code-review` はフォークされたサブエージェントとして実行されます。以前のバージョンではインラインで実行され、スタックされました。

724 

725位置で個別の引数にアクセスするには、`$ARGUMENTS[N]` または短い `$N` を使用します。721位置で個別の引数にアクセスするには、`$ARGUMENTS[N]` または短い `$N` を使用します。

726 722 

727```yaml theme={null}723```yaml theme={null}

746Preserve all existing behavior and tests.742Preserve all existing behavior and tests.

747```743```

748 744 

745<h4 id="stack-several-skills-in-one-message">

746 1 つのメッセージに複数のスキルをスタックする

747</h4>

748 

749ターミナルで Claude Code のプロンプトに入力する場合、1 つのメッセージの先頭に複数のスキルをスタックできます。Agent SDK または `claude -p` を通じた場合、Claude Code は最初のスキルのみを読み込み、行の残りの部分をその引数とします。ターミナルのプロンプトで `/write-tests /fix-issue 123` と入力すると、両方のスキルが読み込まれ、末尾のテキスト `123` が `$ARGUMENTS` として各スキルに渡されます。

750 

751Claude Code は最初のスキルと、その後にスタックされた最大 5 つのスキルを展開します。展開は、インラインのユーザー呼び出し可能スキルではない最初のトークンで停止します。[フォークされたサブエージェント](#run-skills-in-a-subagent) として実行されるスキル（[`/code-review`](/docs/ja/code-review-local) など）や、引数が別のコマンドで始まる可能性があるスキル（`/loop` など）をスタックした場合、展開はそこで終了します。そのトークンとその後のすべてが、展開されたすべてのスキルの引数テキストになります。

752 

749<h2 id="advanced-patterns">753<h2 id="advanced-patterns">

750 高度なパターン754 高度なパターン

751</h2>755</h2>

1044インストールが失敗した場合は、Claude Code が報告するメッセージと一致させます。1048インストールが失敗した場合は、Claude Code が報告するメッセージと一致させます。

1045 1049 

1046* `Marketplace "claude-plugins-official" not found`：`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行します。1050* `Marketplace "claude-plugins-official" not found`：`/plugin marketplace add anthropics/claude-plugins-official` でマーケットプレイスを追加してから、インストールを再試行します。

1047* [プラグインがマーケットプレイスで見つかりません](/docs/ja/plugins/install#install-a-plugin)：プラグイン名を確認します。1051* `Plugin "<name>" not found in marketplace "claude-plugins-official"`：マーケットプレイスカタログのローカルコピーが古くなっている可能性があります。`/plugin marketplace update claude-plugins-official` で更新してから、インストールを再試行します。再試行しても同じメッセージが表示される場合は、[プラグインがマーケットプレイスで見つからない](/docs/ja/plugins/troubleshooting#plugin-not-found-in-marketplace) を参照してください。

1048 1052 

1049インストール概要が `Run /reload-plugins to apply.` を報告する場合、Claude Code はそのリロードを実行します。リロードが次のメッセージが会話を再読み込みすることを警告する場合は、`/reload-plugins --force` を実行してプラグインのスキルを現在のセッションで利用可能にします。その後、Claude に既存のスキルを評価するよう依頼します。例えば `evaluate my summarize-changes skill with skill-creator` です。プラグインはテストケースの作成をガイドし、ループを実行します。1053インストール概要が `Run /reload-plugins to apply.` を報告する場合、Claude Code はそのリロードを実行します。リロードが次のメッセージが会話を再読み込みすることを警告する場合は、`/reload-plugins --force` を実行してプラグインのスキルを現在のセッションで利用可能にします。その後、Claude に既存のスキルを評価するよう依頼します。例えば `evaluate my summarize-changes skill with skill-creator` です。プラグインはテストケースの作成をガイドし、ループを実行します。

1050 1054 

281 フルスクリーンモード281 フルスクリーンモード

282 </h4>282 </h4>

283 283 

284 Claude Code は、デフォルトとフルスクリーンレンダラーの両方で `userMessageBackground`、`bashMessageBackgroundColor`、および `memoryBackgroundColor` を描画します。[フルスクリーンレンダリングモード](/docs/ja/fullscreen)でのみ `userMessageBackgroundHover` と `selectionBg` を使用します。284 Claude Code は、`userMessageBackgroundHover`、`selectionBg`、および `composerSidebarBackground` を[フルスクリーンレンダリングモード](/docs/ja/fullscreen)でのみ使用します。`userMessageBackground`、`bashMessageBackgroundColor`、および `memoryBackgroundColor` は、デフォルトとフルスクリーンレンダラーの両方で描画します。

285 285 

286 | トークン | 制御対象 |286 | トークン | 制御対象 |

287 | :- | :- |287 | :- | :- |

290 | `bashMessageBackgroundColor` | トランスクリプト内の `!` シェルコマンドエントリの背後の背景 |290 | `bashMessageBackgroundColor` | トランスクリプト内の `!` シェルコマンドエントリの背後の背景 |

291 | `memoryBackgroundColor` | トランスクリプト内の `#` メモリエントリの背後の背景 |291 | `memoryBackgroundColor` | トランスクリプト内の `#` メモリエントリの背後の背景 |

292 | `selectionBg` | マウスで選択されたテキストの背景 |292 | `selectionBg` | マウスで選択されたテキストの背景 |

293 | `composerSidebarBackground` | 会話の横に表示されるパネル（[差分パネル](/docs/ja/fullscreen#watch-your-changes-in-the-diff-panel)や [mod のペイン](/docs/ja/plugins/mods/interface)など）の背景 |

293 294 

294 <h4 id="usage-meter-and-speaker-labels">295 <h4 id="usage-meter-and-speaker-labels">

295 使用量メーターとスピーカーラベル296 使用量メーターとスピーカーラベル

10 10 

11VS Code 拡張機能は、Claude Code 用のネイティブグラフィカルインターフェースを提供し、IDE に直接統合されています。これは VS Code で Claude Code を使用する推奨方法です。11VS Code 拡張機能は、Claude Code 用のネイティブグラフィカルインターフェースを提供し、IDE に直接統合されています。これは VS Code で Claude Code を使用する推奨方法です。

12 12 

13この拡張機能を使用すると、Claude のプランを受け入れる前に確認および編集でき、編集が行われるときに自動的に受け入れることができ、選択範囲から特定の行範囲を持つファイルを @-メンションでき、会話履歴にアクセスでき、複数の会話を別々のタブまたはウィンドウで開くことができます。13この拡張機能を使用すると、次のことができます。

14 

15* Claude のプランを受け入れる前に確認および編集する

16* 編集が行われるときに自動的に受け入れる

17* 選択範囲から特定の行範囲を指定してファイルを @-メンションする

18* 会話履歴にアクセスする

19* 複数の会話を別々のタブまたはウィンドウで開く

14 20 

15<h2 id="prerequisites">21<h2 id="prerequisites">

16 前提条件22 前提条件

29 拡張機能をインストールする35 拡張機能をインストールする

30</h2>36</h2>

31 37 

32IDE のリンクをクリックして直接インストールします。38使用している IDE のリンクをクリックすると、直接インストールできます。

33 39 

34* [VS Code 用にインストール](vscode:extension/anthropic.claude-code)40* [VS Code 用にインストール](vscode:extension/anthropic.claude-code)

35* [Cursor 用にインストール](cursor:extension/anthropic.claude-code)41* [Cursor 用にインストール](cursor:extension/anthropic.claude-code)

36 42 

37または、VS Code で `Cmd+Shift+X`（Mac）または `Ctrl+Shift+X`（Windows/Linux）を押して拡張機能ビューを開き、「Claude Code」を検索して、**インストール**をクリックします。43または、VS Code で `Cmd+Shift+X`（Mac）または `Ctrl+Shift+X`（Windows/Linux）を押して拡張機能ビューを開き、「Claude Code」を検索して **Install** をクリックします。

38 44 

39拡張機能のバージョン番号は、同梱されている Claude Code のバージョンです。たとえば、Claude Code v2.1.286 以降を必要とする機能には、拡張機能のバージョン 2.1.286 以降が必要です。拡張機能のバージョンは拡張機能ビューに表示されます。45拡張機能のバージョン番号は、同梱されている Claude Code のバージョンです。たとえば、Claude Code v2.1.286 以降を必要とする機能には、拡張機能のバージョン 2.1.286 以降が必要です。拡張機能のバージョンは拡張機能ビューに表示されます。

40 46 

41拡張機能は Devin Desktop や Kiro などの他の VS Code フォークにもインストールされます。エディタの拡張機能ビューで「Claude Code」を検索するか、[Open VSX レジストリ](https://open-vsx.org/extension/Anthropic/claude-code)からインストールしてください。エディタが拡張機能をインストールできない場合は、[CLI](/docs/ja/quickstart) をインストールして、統合ターミナルで `claude` を実行してください。CLI はどのターミナルでも動作します。47Claude Code は、ほかのエディタやコンテナでも動作します。

42 48 

43開発コンテナ内で Claude Code を実行するには、[開発コンテナ](/docs/ja/devcontainer)を参照してください。49* **その他の VS Code フォーク**：拡張機能は Devin Desktop や Kiro などのフォークにもインストールできます。エディタの拡張機能ビューで「Claude Code」を検索するか、[Open VSX レジストリ](https://open-vsx.org/extension/Anthropic/claude-code)からインストールしてください。

50* **拡張機能をインストールできないエディタ**：代わりに [CLI をインストール](/docs/ja/quickstart)し、エディタの統合ターミナルで `claude` を実行してください。CLI はどのターミナルでも動作します。

51* **開発コンテナ**：開発コンテナ内で Claude Code を実行するには、[開発コンテナ](/docs/ja/devcontainer)を参照してください。

44 52 

45<Note>インストール後に拡張機能が表示されない場合は、VS Code を再起動するか、コマンドパレットから「Developer: Reload Window」を実行してください。</Note>53<Note>インストール後に拡張機能が表示されない場合は、VS Code を再起動するか、コマンドパレットから「Developer: Reload Window」を実行してください。</Note>

46 54 

48 はじめに56 はじめに

49</h2>57</h2>

50 58 

51インストール後、VS Code インターフェースを通じて Claude Code の使用を開始できます。59インストールが完了したら、VS Code のインターフェースから Claude Code を使い始めることができます。

52 60 

53<Steps>61<Steps>

54 <Step title="Claude Code パネルを開く">62 <Step title="Claude Code パネルを開く">

55 VS Code 全体で、Spark アイコンは Claude Code を示します。<img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Spark icon" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />63 VS Code 全体を通して、Spark アイコンは Claude Code を表します: <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Spark アイコン" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

56 64 

57 Claude を開く最も速い方法は、**エディタツールバー**（エディタの右上隅）の Spark アイコンをクリックすることです。このアイコンはファイルを開いている場合にのみ表示されます。65 Claude を開く最も簡単な方法は、**エディターツールバー**（エディターの右上隅）にある Spark アイコンをクリックすることです。このアイコンは、ファイルを開いているときにのみ表示されます。

58 66 

59 <img src="https://mintcdn.com/claude-code/mfM-EyoZGnQv8JTc/images/vs-code-editor-icon.png?fit=max&auto=format&n=mfM-EyoZGnQv8JTc&q=85&s=eb4540325d94664c51776dbbfec4cf02" alt="VS Code エディタでエディタツールバーに表示された Spark アイコン" width="2796" height="734" data-path="images/vs-code-editor-icon.png" />67 <img src="https://mintcdn.com/claude-code/mfM-EyoZGnQv8JTc/images/vs-code-editor-icon.png?fit=max&auto=format&n=mfM-EyoZGnQv8JTc&q=85&s=eb4540325d94664c51776dbbfec4cf02" alt="エディターツールバーに Spark アイコンが表示されている VS Code エディター" width="2796" height="734" data-path="images/vs-code-editor-icon.png" />

60 68 

61 Claude Code を開くその他の方法：69 Claude Code を開くその他の方法:

62 70 

63 * **アクティビティバー**：左サイドバーの Spark アイコンをクリックしてセッションリストを開きます。任意のセッションをクリックして[優先位置](#extension-settings)で開くか、新しいセッションを開始します。このアイコンはアクティビティバーに常に表示されます。71 * **アクティビティバー**: 左サイドバーの Spark アイコンをクリックしてセッション一覧を開きます。任意のセッションをクリックすると[優先する場所](#extension-settings)で開くことができ、新しいセッションを開始することもできます。このアイコンはアクティビティバーに常に表示されています。

64 * **コマンドパレット**：`Cmd+Shift+P`（Mac）または `Ctrl+Shift+P`（Windows/Linux）を押し、「Claude Code」と入力して、「Open in New Tab」などのオプションを選択します。72 * **コマンドパレット**: `Cmd+Shift+P`（Mac）または `Ctrl+Shift+P`（Windows/Linux）を押して「Claude Code」と入力し、「Open in New Tab」などのオプションを選択します

65 * **ステータスバー**：ウィンドウの右下隅の **✻ Claude Code** をクリックします。ファイルが開いていない場合でも機能します。73 * **ステータスバー**: ウィンドウの右下隅にある **✻ Claude Code** をクリックします。これはファイルを開いていないときでも機能します。

66 74 

67 Claude パネルをドラッグして VS Code 内の任意の場所に移動できます。詳細は[ワークフローをカスタマイズする](#customize-your-workflow)を参照してください。75 Claude パネルはドラッグして VS Code 内の任意の場所に移動できます。詳しくは[ワークフローをカスタマイズする](#customize-your-workflow)を参照してください。

68 </Step>76 </Step>

69 77 

70 <Step title="サインイン">78 <Step title="サインインする">

71 パネルを初めて開くと、サインイン画面が表示されます。**Sign in** をクリックしてブラウザで認可を完了します。79 初めてパネルを開くと、サインイン画面が表示されます。**Sign in** をクリックし、ブラウザーで認可を完了してください。

72 80 

73 後で **Not logged in · Please run /login** が表示される場合、拡張機能はサインイン画面を自動的に再度開きます。表示されない場合は、コマンドパレットから **Developer: Reload Window** でウィンドウをリロードします。81 後で **Not logged in · Please run /login** と表示された場合、拡張機能は自動的にサインイン画面を再度開きます。表示されない場合は、コマンドパレットから **Developer: Reload Window** を実行してウィンドウを再読み込みしてください。

74 82 

75 シェルに `ANTHROPIC_API_KEY` が設定されているのにサインインプロンプトが表示される場合、VS Code がシェル環境を継承していない可能性があります。ターミナルから `code .` で VS Code を起動して環境変数を継承するか、代わりに Claude アカウントでサインインしてください。83 シェルで `ANTHROPIC_API_KEY` を設定しているにもかかわらずサインインプロンプトが表示される場合は、VS Code がシェル環境を引き継いでいない可能性があります。環境変数を引き継ぐようにターミナルから `code .` で VS Code を起動するか、代わりに Claude アカウントでサインインしてください。

76 84 

77 サインイン後、**Learn Claude Code** チェックリストが表示されます。**Show me** をクリックして各項目を実行するか、X で閉じます。後で再度開くには、VS Code 設定の Extensions → Claude Code で **Hide Onboarding** をオフにします。85 サインインすると、**Learn Claude Code** チェックリストが表示されます。**Show me** をクリックして各項目を順に進めるか、X で閉じてください。後で再度開くには、VS Code の設定の **Extensions > Claude Code** で **Hide Onboarding** のチェックを外します。

78 </Step>86 </Step>

79 87 

80 <Step title="プロンプトを送信する">88 <Step title="プロンプトを送信する">

81 コードやファイルについて Claude に支援を求めます。これは、何かの仕組みを説明すること、問題をデバッグすること、または変更を加えることなど、様々なことが含まれます。89 仕組みの説明、問題のデバッグ、変更の実施など、コードやファイルに関する手助けを Claude に依頼しましょう。

82 90 

83 <Tip>Claude は自動的に選択したテキストを認識します。`Option+K`（Mac）/ `Alt+K`（Windows/Linux）を押して、@-mention 参照（`@file.ts#5-10` など）をプロンプトに挿入することもできます。</Tip>91 <Tip>Claude は選択したテキストを自動的に認識します。`Option+K`（Mac）/ `Alt+K`（Windows/Linux）を押すと、@メンション参照（`@file.ts#5-10` など）をプロンプトに挿入することもできます。</Tip>

84 92 

85 ファイル内の特定の行について質問する例を以下に示します。93 ファイル内の特定の行について質問する例を次に示します。

86 94 

87 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-send-prompt.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=ede3ed8d8d5f940e01c5de636d009cfd" alt="VS Code エディタで Python ファイルの 2～3 行が選択されており、Claude Code パネルに @-mention 参照を含むそれらの行についての質問が表示されている" width="3288" height="1876" data-path="images/vs-code-send-prompt.png" />95 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-send-prompt.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=ede3ed8d8d5f940e01c5de636d009cfd" alt="Python ファイルの 2〜3 行目が選択された VS Code エディターと、@メンション参照を使ってそれらの行について質問している Claude Code パネル" width="3288" height="1876" data-path="images/vs-code-send-prompt.png" />

88 </Step>96 </Step>

89 97 

90 <Step title="変更を確認する">98 <Step title="変更を確認する">

91 表示内容は、プロンプトボックスの下部に表示される[権限モード](/docs/ja/permission-modes#which-mode-a-session-starts-in)によって異なります。99 <span id="security-considerations" />

100 

101 <span id="security-and-privacy" />

102 

103 プロンプトボックスの下部に表示されている[権限モード](/docs/ja/permission-modes#which-mode-a-session-starts-in)を確認してください。

92 104 

93 * Auto または Edit automatically モードでは、Claude はワークスペース内のほとんどのファイルを確認なしで編集します。105 * Auto または Edit automatically モードでは、Claude はワークスペース内の[ほとんどのファイル](/docs/ja/permission-modes#protected-paths)を確認なしで編集します。

94 * Manual モードでは、Claude がファイルを編集したい場合、元のコンテンツと提案された変更の並べて比較を表示し、権限を求めます。受け入れたり、拒否したり、代わりに Claude に何をするかを指示したりできます。受け入れる前に diff ビューで提案されたコンテンツを直接編集した場合、Claude はそれを修正したことが通知されるため、ファイルが元の提案と一致していると想定されません。106 * Manual モードでは、Claude がファイルを編集しようとすると、元の内容と提案された変更を並べて比較表示し、権限を求めます。承認、拒否、または代わりに何をすべきかを Claude に伝えることができます。承認する前に差分ビューで提案内容を直接編集した場合は、変更したことが Claude に伝えられるため、Claude はファイルが元の提案と一致しているとは想定しません。

95 107 

96 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code が Claude の提案された変更の diff を表示し、編集を行うかどうかを尋ねる権限プロンプトが表示されている" width="3292" height="1876" data-path="images/vs-code-edits.png" />108 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="Claude が提案した変更の差分と、編集を行うかどうかを尋ねる権限プロンプトを表示している VS Code" width="3292" height="1876" data-path="images/vs-code-edits.png" />

97 109 

98 提案された編集を 1 つずつ確認するには、diff 内の各変更の下にある **Accept this change** および **Reject this change** ボタンを使用します。変更を拒否すると、提案されたコンテンツ内でそれが元に戻されます。受け入れると、確認済みとしてマークされます。ファイル全体を受け入れるか拒否すると、確認が完了します。100 を超える変更を含む diff は、変更ごとのボタンなしで開かれるため、ファイル全体として確認してください。変更ごとの確認には Claude Code v2.1.275 以降が必要です。110 提案された編集を 1 つの変更ずつ確認するには、差分内の各変更の下にある **Accept this change** ボタンと **Reject this change** ボタンを使用します。変更を拒否すると提案内容からその変更が元に戻され、承認するとその変更は確認済みとしてマークされます。変更ごとの確認には Claude Code v2.1.275 以降が必要です。

99 111 

100 同じアクションは、エディタのコンテキストメニューおよびコマンドパレットから **Claude Code: Accept Change at Cursor** および **Claude Code: Reject Change at Cursor** として利用できます。112 ファイル全体を承認または拒否しても、引き続き確認を完了できます。100 を超える変更を含む差分は変更ごとのボタンなしで開かれるため、ファイル全体として確認してください。

113 

114 同じ操作は、エディターのコンテキストメニューからカーソル位置で、またコマンドパレットから **Claude Code: Accept Change at Cursor** および **Claude Code: Reject Change at Cursor** として実行することもできます。

101 </Step>115 </Step>

102</Steps>116</Steps>

103 117 

104Claude Code でできることについてのアイデアについては、[一般的なワークフロー](/docs/ja/common-workflows)を参照してください。118Claude Code でできることのその他のアイデアについては、[一般的なワークフロー](/docs/ja/common-workflows)を参照してください。

105 119 

106<Tip>120<Tip>

107 コマンドパレットから「Claude Code: Open Walkthrough」を実行して、基本的な機能のガイド付きツアーを表示します。121 コマンドパレットから「Claude Code: Open Walkthrough」を実行すると、基本操作のガイド付きツアーを利用できます。

108</Tip>122</Tip>

109 123 

110<h2 id="use-the-prompt-box">124<h2 id="use-the-prompt-box">

111 プロンプトボックスを使用する125 プロンプトボックスを使用する

112</h2>126</h2>

113 127 

114プロンプトボックスは複数の機能をサポートしています。128プロンプトボックスには次の機能があります。

129 

130* **権限モード**: プロンプトボックス下部のモードインジケーターをクリックすると、権限モードを切り替えられます。Claude Code v2.1.283 以降では Auto が組み込みの開始時の権限モードです。それより前のバージョンでは、Pro、Max、Team プランでのみ Auto が開始時の権限モードになります。何によって変わるか、およびインジケーターで選択できるすべての権限モードについては、[拡張機能が開始時の権限モードを選択する仕組み](/docs/ja/permission-modes#switch-permission-modes)を参照してください。

131 * **Auto**: ユーザーに確認する代わりに、分類器がほとんどのアクションをレビューします。レビューおよびブロックされる内容については、[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)を参照してください。

132 * **Manual**: Claude はファイルの編集やほとんどのシェルコマンドの前に権限を求めます。

133 * **Plan**: Claude は実行する内容を説明し、変更を加える前に承認を待ちます。VS Code はプランを完全な Markdown ドキュメントとして自動的に開き、Claude が作業を始める前にインラインコメントを追加してフィードバックを伝えられます。

115 134 

116* **権限モード**: プロンプトボックスの下部にあるモード表示をクリックして、権限モードを切り替えます。Claude Code v2.1.283 以降では、Auto が組み込みの開始権限モードであり、それより前のバージョンでは Pro、Max、Team プランのみです。[拡張機能が開始権限モードを選択する方法](/docs/ja/permission-modes#switch-permission-modes)と、表示されるすべての権限モードについては、こちらをご覧ください。135 プロンプトボックスに `/plan` と入力することもできます。Claude Code v2.1.280 以降が必要です。

117 * **Auto**: ほとんどのアクションについて、分類器があなたに尋ねる代わりに確認します。[自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)で、確認およびブロックされる内容をご覧ください。

118 * **Manual**: Claude はファイル編集とほとんどのシェルコマンドの前に権限を求めます。

119 * **Plan**: Claude は変更を加える前に、実行内容を説明し、承認を待ちます。VS Code は計画を完全な Markdown ドキュメントとして自動的に開き、Claude が開始する前にフィードバックを提供するためのインラインコメントを追加できます。

120 136 

121 プロンプトボックスで `/plan` を入力することもできます。Claude Code v2.1.280 以降が必要です。137 * `/plan`: plan モードに切り替えます。すでに plan モードの場合は、現在のプランを表示します。

138 * `/plan fix the auth bug` のようにタスクを付けた `/plan`: plan モードに切り替え、そのタスクの計画を開始します。

139 * `/plan open`: すでに plan モードの場合、エディターでプランファイルを開きます。

140 * **Edit automatically**: Claude は確認せずに編集を行います。

141* **モデル**: コマンドメニューから **Switch model…** を選択すると、セッションの途中でモデルを変更できます。プロンプトボックス下部のモデル名をクリックしても、同じピッカーを開けます。Claude Code v2.1.284 以降では、プロンプトボックスに `/model` のみを入力してもピッカーが開きます。

122 142 

123 * `/plan`: 計画モードに切り替えます。既に計画モードの場合は、現在の計画を表示します。143 現在のモデルが [effort レベル](/docs/ja/model-config#adjust-effort-level)をサポートしている場合、ピッカーには **Effort** 行も表示され、モデル名ボタンには選択したレベルが表示されます。`max` 以外のレベルを選択すると、Claude Code はそれを現在のモデルのデフォルトとして、ユーザー設定の [`modelSettings`](/docs/ja/settings-reference#modelsettings) に保存します。`max` は現在のセッションにのみ適用されます。モデル名ボタンと **Effort** 行には Claude Code v2.1.257 以降が必要です。

124 * `/plan` とタスク（例：`/plan fix the auth bug`）: 計画モードに切り替えて、そのタスクの計画を開始します。

125 * `/plan open`: 既に計画モードの場合、エディターで計画ファイルを開きます。

126 * **Edit automatically**: Claude は確認を求めずに編集を行います。

127* **Model**: コマンドメニューから **Switch model…** を選択して、セッション中にモデルを変更します。プロンプトボックスの下部にあるモデル名をクリックして、同じピッカーを開くこともできます。Claude Code v2.1.284 以降では、プロンプトボックスで `/model` のみを入力してもピッカーが開きます。

128 144 

129 現在のモデルが[努力レベル](/docs/ja/model-config#adjust-effort-level)をサポートしている場合、ピッカーは **Effort** 行も表示し、モデル名ボタンは選択されたレベルを表示します。`max` 以外のレベルを選択すると、Claude Code はそれを現在のモデルのデフォルトとしてユーザー設定の [`modelSettings`](/docs/ja/settings-reference#modelsettings) に保存します。`max` は現在のセッションにのみ適用されます。モデル名ボタンと **Effort** 行には Claude Code v2.1.257 以降が必要です。145 [動的ワークフロー](/docs/ja/workflows)が有効で、現在のモデルがそれをサポートしている場合、**Effort** 行の下に **Ultracode** スイッチが表示されます。これをオンにすると、Claude はこのセッションの実質的なタスクごとに、選択した effort レベルで[ワークフロー](/docs/ja/workflows#let-claude-decide-with-ultracode)を計画します。オンの間、モデル名ボタンにはレベルの後に `· Ultracode` と表示されます。このスイッチには Claude Code v2.1.284 以降が必要です。

146* **コマンドメニュー**: `/` をクリックするか `/` と入力すると、コマンドメニューが開きます。ファイルの添付、モデルの切り替え、拡張思考の切り替えなどのオプションがあります。

130 147 

131 [動的ワークフロー](/docs/ja/workflows)が有効になっており、現在のモデルがそれをサポートしている場合、**Effort** 行の下に **Ultracode** スイッチが表示されます。オンにして、Claude がこのセッションの各実質的なタスクに対して、選択された努力レベルで[ワークフロー](/docs/ja/workflows#let-claude-decide-with-ultracode)を計画するようにします。オンの間、モデル名ボタンはレベルの後に `· Ultracode` を表示します。スイッチには Claude Code v2.1.284 以降が必要です。148 Customize セクションには、MCP サーバー、コマンド、出力スタイル、フック、メモリ、指示、権限、プラグインなどの項目があります。ターミナルアイコンの付いた項目は統合ターミナルで開きます。

132* **コマンドメニュー**: `/` をクリックするか `/` を入力してコマンドメニューを開きます。オプションには、ファイルの添付、モデルの切り替え、拡張思考の切り替えが含まれます。

133 149 

134 Customize セクションは、MCP サーバー、コマンド、出力スタイル、hooks、メモリ、instructions、権限、プラグインへのアクセスを提供します。ターミナルアイコンが付いているアイテムは統合ターミナルで開きます。150 * `/usage` や [`/remote-control`](/docs/ja/remote-control) などのコマンドを一覧するには、Customize セクションで **Slash commands** を選択します。フィルターボックス付きのダイアログにコマンドが一覧表示されます。いずれかを選ぶと実行されます。プロンプトボックスに `/` と入力した場合も、引き続きインラインでコマンドが候補表示されます。Claude Code v2.1.257 以降が必要です。

135 151 

136 * Customize セクションで **Slash commands** を選択して、`/usage` や [`/remote-control`](/docs/ja/remote-control) などのコマンドを参照します。ダイアログにはフィルターボックス付きでそれらが一覧表示されます。実行するコマンドを選択します。プロンプトボックスで `/` を入力すると、引き続きコマンドがインラインで提案されます。Claude Code v2.1.257 以降が必要です。152 `/skills` と入力してもこのダイアログが開きます。各[スキル](/docs/ja/skills)の行には、**On** や **Name only** などの[表示設定](/docs/ja/skills#override-skill-visibility-from-settings)が表示されます。表示設定をクリックすると変更できます。ただし、プラグインのスキルなど **locked** と表示された行は変更できません。`/skills` ショートカットと表示設定のコントロールには Claude Code v2.1.280 以降が必要です。

153 * Customize セクションで **Output styles** を選択すると、カスタムスタイルを含む[出力スタイル](/docs/ja/output-styles)を選択できます。Claude Code v2.1.257 以降が必要です。

137 154 

138 また、`/skills` を入力してもこのダイアログが開きます。各[スキル](/docs/ja/skills)行は、**On** や **Name only** などの[表示設定](/docs/ja/skills#override-skill-visibility-from-settings)を表示します。表示設定をクリックして変更できます。ただし、プラグインスキルなど **locked** とマークされた行は除きます。`/skills` ショートカットと表示設定コントロールには Claude Code v2.1.280 以降が必要です。155 代わりにカスタムスタイルを作成するには、**Output styles** メニューから **Build a custom style** を選択します。Claude Code がプロジェクトレベルまたはユーザーレベルで[スタイルファイル](/docs/ja/output-styles#create-a-custom-output-style)を作成します。Claude Code v2.1.261 以降が必要です。

139 * Customize セクションで **Output styles** を選択して、カスタムスタイルを含む[出力スタイル](/docs/ja/output-styles)を選択します。Claude Code v2.1.257 以降が必要です。156 * Customize セクションで **Hooks** を選択すると、セッションで読み込まれている[フック](/docs/ja/hooks)をイベントごとにグループ化して表示できます。ユーザー、プロジェクト、ローカルの設定ファイルに保存されているフックは追加、編集、削除できます。管理設定やプラグインなど、その他のソースからのフックは読み取り専用です。Claude Code v2.1.269 以降が必要です。

157 * Customize セクションで **Permissions** を選択すると、セッションの[権限ルール](/docs/ja/permissions)を Allow、Ask、Deny に分けて表示できます。ユーザー、プロジェクト、ローカルの設定にルールを追加したり、そこに保存されているルールを削除したりできます。管理設定や、このセッションのみを対象とした承認など、その他のソースからのルールは読み取り専用です。Claude Code v2.1.269 以降が必要です。

158 * Customize セクションで **Memory** を選択すると、[自動メモリ](/docs/ja/memory#auto-memory)のオン/オフを切り替えられます。オンの間は、Claude が保存したメモリを参照したり、それらを保存しているフォルダーをファイルマネージャーで表示したりすることもできます。Claude Code v2.1.274 以降が必要です。

140 159 

141 代わりにカスタムスタイルを作成するには、**Output styles** メニューから **Build a custom style** を選択します。Claude Code はプロジェクトまたはユーザーレベルで[スタイルファイル](/docs/ja/output-styles#create-a-custom-output-style)を作成します。Claude Code v2.1.261 以降が必要です。160 保存されたメモリをクリックするとダイアログで内容を読むことができ、そこでテキストの編集、メモリの削除、エディターでのファイルのオープンが行えます。ダイアログでのメモリの表示、編集、削除には Claude Code v2.1.275 以降が必要です。

142 * Customize セクションで **Hooks** を選択して、セッションに読み込まれた[hooks](/docs/ja/hooks)をイベント別にグループ化して表示します。ユーザー、プロジェクト、ローカル設定ファイルに保存された hooks を追加、編集、または削除できます。マネージド設定やプラグインなどの他のソースからの Hooks は読み取り専用です。Claude Code v2.1.269 以降が必要です。161 * Customize セクションで **Instructions** を選択すると、Claude が読み込む [CLAUDE.md ファイル](/docs/ja/memory#claude-md-files)を編集できます。ファイルを選ぶとエディターで開きます。ファイルがまだ存在しない場合は、Claude Code が先に作成します。Claude Code v2.1.274 以降が必要です。

143 * Customize セクションで **Permissions** を選択して、セッションの[権限ルール](/docs/ja/permissions)を Allow、Ask、Deny にグループ化して表示します。ユーザー、プロジェクト、またはローカル設定にルールを追加し、そこに保存されたルールを削除できます。マネージド設定やこのセッションのみの承認など、他のソースからのルールは読み取り専用です。Claude Code v2.1.269 以降が必要です。162 * Customize セクションで **Status** を選択するか `/status` と入力すると、セッションの Claude Code のバージョン、アカウント、モデル、MCP サーバーの詳細を確認できます。Claude Code v2.1.280 以降が必要です。

144 * Customize セクションで **Memory** を選択して、[自動メモリ](/docs/ja/memory#auto-memory)をオンまたはオフにします。オンの場合、Claude が保存したメモリを参照し、それらを保存するフォルダをファイルマネージャーで表示することもできます。Claude Code v2.1.274 以降が必要です。163 * Customize セクションで **Sandbox** を選択するか `/sandbox` と入力すると、Claude の Bash コマンドが[サンドボックス内](/docs/ja/sandboxing)で実行されるかどうかを確認できます。そこでサンドボックスモードを切り替えたり、[除外コマンド](/docs/ja/settings-reference#sandbox-excludedcommands)を追加したりできます。Claude Code v2.1.280 以降が必要です。

164 * Customize セクションで **Claude in Chrome** を選択するか `/chrome` と入力すると、[Claude in Chrome](/docs/ja/chrome) の接続を確認および管理できます。いずれも claude.ai アカウントでのサインインが必要です。Claude Code v2.1.280 以降が必要です。

165 * Context セクションで **Export conversation** を選択するか `/export` と入力すると、会話をプレーンテキストとしてコピーしたり、ファイルに保存したりできます。`/export notes.txt` のようにファイル名を付けると、ダイアログを省略してファイルの保存先を選択できます。Claude Code v2.1.280 以降が必要です。

166 * Settings セクションには **Enable Remote Control for all sessions** があり、[`remoteControlAtStartup`](/docs/ja/settings-reference#remotecontrolatstartup) を設定して、[新しい対話型セッションが自動的に Remote Control に接続するか](/docs/ja/remote-control#enable-remote-control-for-all-sessions)どうかを制御します。Claude Code v2.1.203 以降が必要です。

145 167 

146 保存されたメモリをクリックしてダイアログで読み取り、テキストを編集したり、メモリを削除したり、そのファイルをエディターで開いたりできます。ダイアログでメモリを表示、編集、削除するには Claude Code v2.1.275 以降が必要です。168 VS Code ウィンドウでこのトグルをオンまたはオフにすると、その変更は以降に開始するセッションだけに限定されません。その VS Code ウィンドウですでに開いているセッションにも適用されます。オフにすると、開いているセッションは切断されます。Claude Code v2.1.261 以降では、この変更は他の VS Code ウィンドウで開いているセッションにも反映されます。

147 * Customize セクションで **Instructions** を選択して、Claude が読む[CLAUDE.md ファイル](/docs/ja/memory#claude-md-files)を編集します。ファイルを選択してエディターで開きます。ファイルがまだ存在しない場合、Claude Code は最初にそれを作成します。Claude Code v2.1.274 以降が必要です。169 * Settings セクションには **Focus view** もあり、ツール呼び出し、ツールの結果、思考を展開可能な行の中に隠し、ユーザーのプロンプトと Claude の応答だけを表示します。そこで切り替えるか、`Ctrl+Option+F`（Mac）/ `Ctrl+Alt+F`（Windows/Linux）を使うか、コマンドパレットから **Claude Code: Toggle Focus view** を実行して切り替えます。変更は開いているすべてのセッションに適用され、セッションをまたいで保持されます。Claude Code v2.1.221 以降が必要です。

148 * Customize セクションで **Status** を選択するか、`/status` を入力して、セッションの Claude Code バージョン、アカウント、モデル、MCP サーバーの詳細を確認します。Claude Code v2.1.280 以降が必要です。

149 * Customize セクションで **Sandbox** を選択するか、`/sandbox` を入力して、Claude の Bash コマンドが[サンドボックス化](/docs/ja/sandboxing)されているかどうかを確認します。サンドボックスモードを切り替えたり、[除外コマンド](/docs/ja/settings-reference#sandbox-excludedcommands)を追加したりできます。Claude Code v2.1.280 以降が必要です。

150 * Customize セクションで **Claude in Chrome** を選択するか、`/chrome` を入力して、[Claude in Chrome](/docs/ja/chrome)接続を確認および管理します。どちらも claude.ai アカウントでサインインする必要があります。Claude Code v2.1.280 以降が必要です。

151 * Context セクションで **Export conversation** を選択するか、`/export` を入力して、会話をプレーンテキストとしてコピーするか、ファイルに保存します。`/export notes.txt` などのファイル名を追加して、ダイアログをスキップし、ファイルの保存場所を選択します。Claude Code v2.1.280 以降が必要です。

152 * Settings セクションには **Enable Remote Control for all sessions** が含まれており、これは [`remoteControlAtStartup`](/docs/ja/settings-reference#remotecontrolatstartup) を設定して、[新しいインタラクティブセッションが Remote Control に自動的に接続するかどうか](/docs/ja/remote-control#enable-remote-control-for-all-sessions)を制御します。Claude Code v2.1.203 以降が必要です。

153 170 

154 VS Code ウィンドウでトグルをオンまたはオフにすると、その変更は、その後に開始するセッションだけでなく、その VS Code ウィンドウで既に開いているセッションに適用されます。オフにすると、開いているセッションは切断されます。Claude Code v2.1.261 以降では、その変更は他の VS Code ウィンドウで開いているセッションにも適用されます。171 Claude の最新の To-Do リストは表示されたままになり、Claude からの保留中の質問が対象としているテキストも表示されたままになります。これには Claude Code v2.1.225 以降が必要です。Claude が[サブエージェント](/docs/ja/sub-agents)を実行している間は、それらを開始したツール呼び出しグループの下に、最新のアクティビティを示すライブ進捗行が表示されます。これには Claude Code v2.1.269 以降が必要です。

155 * Settings セクションには **Focus view** も含まれており、これはツール呼び出し、ツール結果、思考を展開可能な行の背後に隠し、プロンプトと Claude の応答を残します。そこで切り替えるか、`Ctrl+Option+F`（Mac）/ `Ctrl+Alt+F`（Windows/Linux）で切り替えるか、コマンドパレットから **Claude Code: Toggle Focus view** で切り替えます。変更はすべての開いているセッションに適用され、セッション全体で保持されます。Claude Code v2.1.221 以降が必要です。172 * Anthropic アカウントからサインアウトするには、Settings セクションで **Sign out** を選択するか、`/logout` と入力します。[サードパーティプロバイダー](#use-third-party-providers)を使用している場合、メニューにはどちらも表示されません。Claude Code v2.1.277 以降が必要です。

173 * バグを報告するには、メニュー下部の **Report a problem** をクリックするか、`/bug` または `/feedback` と入力します。任意で説明を付けると、それがレポートにあらかじめ入力されます。ファーストパーティ接続で Anthropic にサインインしている状態でレポートを送信すると、Claude Code はそれを Anthropic に送信します。Claude Code v2.1.229 以降が必要です。

156 174 

157 Claude の最新のやることリストは表示されたままになり、Claude からの保留中の質問が尋ねているテキストも表示されたままになります。これには Claude Code v2.1.225 以降が必要です。Claude が[サブエージェント](/docs/ja/sub-agents)を実行している間、最新のアクティビティを含むライブ進捗行が、それらを開始したツール呼び出しグループの下に表示されます。これには Claude Code v2.1.269 以降が必要です。175 サードパーティプロバイダーを使用している場合や Anthropic の認証情報がない場合は、何も送信されません。そのことは、入力を始める前にダイアログに表示されます。送信すると、既知の API キーやトークンのパターンを伏せた上で、レポートが [`~/.claude/feedback-bundles/` 配下のローカルアーカイブ](/docs/ja/data-usage#telemetry-services)として保存されます。レポートをコンピューターに保存するには Claude Code v2.1.284 以降が必要です。

158 * Anthropic アカウントからサインアウトするには、Settings セクションで **Sign out** を選択するか、`/logout` を入力します。[サードパーティプロバイダー](#use-third-party-providers)では、メニューはどちらも提供しません。Claude Code v2.1.277 以降が必要です。

159 * バグを報告するには、メニューの下部にある **Report a problem** をクリックするか、`/bug` または `/feedback` をオプションの説明と共に入力して、レポートに事前入力します。レポートを送信し、ファーストパーティ接続で Anthropic にサインインしている場合、Claude Code はそれを Anthropic に送信します。Claude Code v2.1.229 以降が必要です。

160 176 

161 サードパーティプロバイダーまたは Anthropic 認証情報がない場合、何も送信されません。ダイアログは送信前にそのことを示します。レポートを送信すると、既知の API キーとトークンパターンが削除された状態で、[`~/.claude/feedback-bundles/` の下のローカルアーカイブ](/docs/ja/data-usage#telemetry-services)として保存されます。そのファイルを Anthropic アカウント担当者に送信するか、サポートリクエストに添付してください。確認ではファイル名が表示され、**Show folder** ボタンが含まれます。コンピューターにレポートを保存するには Claude Code v2.1.284 以降が必要です。177 レポートが保存されると、確認メッセージにファイル名が表示され、**Show folder** ボタンが含まれます。そのファイルを Anthropic のアカウント担当者に送るか、サポートリクエストに添付してください。

162 178 

163 組織のポリシーが製品フィードバックをオフにしている場合、**Report a problem** はメニューに表示されず、`/bug` と `/feedback` はレポートを開く代わりに `Feedback is turned off by your organization's policy or this environment's settings.` という通知を表示します。Claude Code v2.1.284 以降では、`DISABLE_FEEDBACK_COMMAND` または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 環境変数を設定した場合、フィードバックもオフになり、レポートを開くとその通知が表示されます。179 組織のポリシーで製品フィードバックがオフになっている場合、メニューに **Report a problem** は表示されず、`/bug` と `/feedback` はレポートを開く代わりに `Feedback is turned off by your organization's policy or this environment's settings.` という通知を表示します。Claude Code v2.1.284 以降では、`DISABLE_FEEDBACK_COMMAND` または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 環境変数を設定した場合もフィードバックがオフになり、レポートを開こうとするとその通知が表示されます。

164* **サイドクエスチョン**: `/btw` の後に質問を入力して、[会話に追加せずに](/docs/ja/interactive-mode#side-questions-with-%2Fbtw)セッションについて質問します。答えはチャットの横のパネルで開き、そこでフォローアップの質問をすることができます。スレッドはウィンドウの再読み込みを通じて保持されます。Claude Code は最新の 20 回の交換を保持し、Claude Code が[保持期間を安全に判断できる](/docs/ja/claude-directory#cleaned-up-automatically)限り、[`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays)スケジュールに従って保存されたスレッドを期限切れにします。スレッドをクリアするには、パネルのゴミ箱アイコンをクリックします。Claude Code v2.1.227 以降が必要です。180* **サイドクエスチョン**: `/btw` に続けて質問を入力すると、[会話に追加せずに](/docs/ja/interactive-mode#side-questions-with-%2Fbtw)セッションについて質問できます。回答はチャットの横のパネルに開き、そこでフォローアップの質問ができます。Claude Code v2.1.227 以降が必要です。

165* **応答をコピー**: 応答にマウスを置いて **Copy response** をクリックしてクリップボードにコピーするか、`/copy` を入力して最新の応答をコピーします。`/copy 2` は 2 番目に新しい応答をコピーします。Claude Code v2.1.277 以降が必要です。

166* **ブックマーク**: 応答にマウスを置いて **Bookmark response** をクリックして保存するか、保存された応答で **Remove bookmark** をクリックして削除します。

167 181 

168 保存された応答を確認するには、Bookmarks パネルを開きます。Claude Code パネルの上部にあるブックマークアイコンをクリックするか、コマンドメニューの Context セクションで **Bookmarks** を選択するか、`/bookmarks` を入力します。Claude Code v2.1.286 以降が必要です。182 このスレッドはウィンドウを再読み込みしても保持されます。Claude Code は最新の 20 件のやり取りを保持し、Claude Code が[保持期間を安全に判断できる](/docs/ja/claude-directory#cleaned-up-automatically)限り、保存されたスレッドを [`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) のスケジュールに従って期限切れにします。スレッドを消去するには、パネルのゴミ箱アイコンをクリックします。

169* **Claude が送信したファイル**: セッションが [Remote Control](/docs/ja/remote-control#start-a-remote-control-session) に接続されていて、Claude が [`SendUserFile` ツール](/docs/ja/tools-reference)でファイルを送信すると、会話に **Sent report.md, chart.png** のような行が表示されます。ファイル名をクリックするとエディターで開きます。183* **応答をコピーする**: 応答にカーソルを合わせて **Copy response** をクリックするとクリップボードにコピーされます。また、`/copy` と入力すると最新の応答をコピーできます。`/copy 2` は最後から 2 番目の応答をコピーします。Claude Code v2.1.277 以降が必要です。

170* **コンテキスト表示**: プロンプトボックスは Claude のコンテキストウィンドウをどの程度使用しているかを表示します。Claude は必要に応じて自動的にコンパクトにするか、`/compact` を手動で実行できます。184* **ブックマーク**: 応答にカーソルを合わせて **Bookmark response** をクリックすると保存されます。保存済みの応答で **Remove bookmark** をクリックすると削除されます。

171* **プロンプトキャッシュクロック**: コンテキスト表示の横にある時計アイコンは、会話の[プロンプトキャッシュ](/docs/ja/prompt-caching)が期限切れになるまでの時間を推定します。キャッシュの 5 分または 1 時間の[有効期限](/docs/ja/prompt-caching#cache-lifetime)からカウントダウンし、キャッシュを使用する各応答がカウントダウンを再開します。コンパクション以外に、[キャッシュを無効にするアクション](/docs/ja/prompt-caching#actions-that-invalidate-the-cache)はクロックをリセットしないため、モデルを切り替えた後も残り時間を表示できます。

172 * カウントダウンが終了するまで、アイコンは **12m** などの残り時間を表示します。

173 * カウントダウンが終了すると、分が消え、アイコンは赤くなるか、次の応答までテーマのエラーカラーになります。キャッシュは期限切れの可能性があるため、次のメッセージへの応答が遅くなり、キャッシュが再構築される間、より高くなることを予想してください。5 分の有効期限がメッセージ間で実行され続ける場合は、[TTL を自分で選択](/docs/ja/prompt-caching#choose-the-ttl-yourself)を参照してください。

174 * 会話が[コンパクト化](/docs/ja/prompt-caching#compacting-the-conversation)された直後、アイコンは次の応答までの分なしで赤くなります。キャッシュはまだコンパクト化された会話をカバーしていないためです。

175* **エージェントマップ**: 会話に[サブエージェント](/docs/ja/sub-agents)が含まれている場合、プロンプトボックスの下部に **2 agents** などのエージェント数が表示されます。そのドットは、サブエージェントが動作しているか、権限を待っているかを示します。

176 185 

177 エージェント数をクリックしてエージェントマップを開きます。これは会話のサブエージェントをメインエージェントの下のツリーとして描画し、それぞれのステータス、経過時間、トークン数を表示します。サブエージェントをクリックして、そのプロンプトとツール呼び出しを表示したり、読み取り専用トランスクリプトを開いたり、実行中に停止したりできます。Claude Code v2.1.269 以降が必要です。186 保存した応答を確認するには、Bookmarks パネルを開きます。Claude Code パネル上部のブックマークアイコンをクリックするか、コマンドメニューの Context セクションで **Bookmarks** を選択するか、`/bookmarks` と入力します。Claude Code v2.1.286 以降が必要です。

187* **Claude から送られたファイル**: セッションが [Remote Control](/docs/ja/remote-control#start-a-remote-control-session) に接続されていて、Claude が [`SendUserFile` ツール](/docs/ja/tools-reference)でファイルを送った場合、会話には **Sent report.md, chart.png** のような行が表示されます。ファイル名をクリックするとエディターで開きます。

188* **コンテキストインジケーター**: プロンプトボックスには、Claude のコンテキストウィンドウをどれだけ使用しているかが表示されます。Claude は必要に応じて自動的に圧縮しますが、`/compact` を手動で実行することもできます。

189* **プロンプトキャッシュの時計**: コンテキストインジケーターの横にある時計アイコンは、会話の[プロンプトキャッシュ](/docs/ja/prompt-caching)の有効期限が切れるまでの残り時間を推定して表示します。キャッシュの 5 分または 1 時間の[有効期間](/docs/ja/prompt-caching#cache-lifetime)からカウントダウンし、キャッシュを使用する応答があるたびにカウントダウンがリセットされます。コンテキスト圧縮を除き、[キャッシュを無効化するアクション](/docs/ja/prompt-caching#actions-that-invalidate-the-cache)では時計はリセットされないため、モデルを切り替えた後も残り時間が表示されることがあります。

190 * カウントダウンが終わるまで、アイコンには **12m** のように残りの分数が表示されます。

191 * カウントダウンが終わると、次の応答まで分数が消え、アイコンが赤色（またはテーマのエラーカラー）に変わります。キャッシュは期限切れになっている可能性が高いため、キャッシュが再構築される間、次のメッセージへの応答は遅く、コストも高くなると考えてください。5 分の有効期間がメッセージの間に何度も切れてしまう場合は、[TTL を自分で選択する](/docs/ja/prompt-caching#choose-the-ttl-yourself)を参照してください。

192 * 会話が[圧縮](/docs/ja/prompt-caching#compacting-the-conversation)された直後も、キャッシュが圧縮後の会話をまだカバーしていないため、次の応答までアイコンは分数なしで赤色になります。

193* **エージェントマップ**: 会話に[サブエージェント](/docs/ja/sub-agents)が含まれている場合、プロンプトボックス下部に **2 agents** のようなエージェント数が表示されます。そのドットは、いずれかのサブエージェントが作業中か、ユーザーの権限を待っているかを示します。

178 194 

179 マップは、バックグラウンドシェルコマンドや[モニター](/docs/ja/tools-reference#monitor-tool)などのセッションの他の[バックグラウンドタスク](/docs/ja/tools-reference#background-commands)もエージェントの下に一覧表示します。行をクリックしてタスクのカードを開き、そこで停止します。195 エージェント数をクリックするとエージェントマップが開き、会話のサブエージェントがメインエージェントの下にツリーとして描画され、それぞれのステータス、経過時間、トークン数が表示されます。サブエージェントをクリックすると、そのプロンプトとツール呼び出しを確認したり、読み取り専用のトランスクリプトを開いたり、実行中のサブエージェントを停止したりできます。Claude Code v2.1.269 以降が必要です。

180 196 

181 エージェント数が表示されていない場合（Claude がバックグラウンドシェルを開始したがサブエージェントがない場合など）にマップを開くには、プロンプトボックスで `/tasks` を入力します。マップ内のバックグラウンドタスクと入力された `/tasks` には Claude Code v2.1.277 以降が必要です。197 マップには、エージェントの下にセッションのその他の[バックグラウンドタスク](/docs/ja/tools-reference#background-commands)（バックグラウンドのシェルコマンドや[モニター](/docs/ja/tools-reference#monitor-tool)など）も一覧表示されます。行をクリックするとタスクのカードが開き、そこで停止できます。

182 198 

183 Claude Code v2.1.286 以降では、**Stop** をクリックするか `Esc` を押すと、現在のターンが終了します。バックグラウンドエージェントは、完了するかマップから停止するまで実行を続けます。199 Claude がバックグラウンドシェルを開始したもののサブエージェントがない場合など、エージェント数が表示されていないときにマップを開くには、プロンプトボックスに `/tasks` と入力します。マップ内のバックグラウンドタスクと、入力による `/tasks` には Claude Code v2.1.277 以降が必要です。

184* **拡張思考**: Claude が複雑な問題を推論するためにより多くの時間を費やすことができます。コマンドメニュー（`/`）経由でオンに切り替えます。Claude の推論は会話に折りたたまれたブロックとして表示されます。ブロックをクリックして読むか、`Ctrl+O` を押してセッション内のすべての思考ブロックを展開または折りたたみます。詳細については、[拡張思考](/docs/ja/model-config#extended-thinking)を参照してください。200 

185* **複数行入力**: `Shift+Enter` を押して、送信せずに新しい行を追加します。これは質問ダイアログの「その他」フリーテキスト入力でも機能します。201 Claude Code v2.1.286 以降では、**Stop** をクリックするか `Esc` を押すと、現在のターンが終了します。バックグラウンドエージェントは、完了するか、マップから停止するまで実行を続けます。

202* **拡張思考**: 複雑な問題について Claude がより多くの時間をかけて推論できるようにします。コマンドメニュー（`/`）からオンに切り替えます。Claude の推論は会話内に折りたたまれたブロックとして表示されます。ブロックをクリックすると内容を読むことができ、`Ctrl+O` を押すとセッション内のすべての思考ブロックを展開または折りたたむことができます。詳細は[拡張思考](/docs/ja/model-config#extended-thinking)を参照してください。

203* **複数行入力**: `Shift+Enter` を押すと、送信せずに改行を追加できます。これは質問ダイアログの「Other」自由記述入力でも機能します。

186 204 

187<h3 id="reference-files-and-folders">205<h3 id="reference-files-and-folders">

188 ファイルとフォルダを参照する206 ファイルとフォルダーを参照する

189</h3>207</h3>

190 208 

191@-メンションを使用して、特定のファイルまたはフォルダに関するコンテキストを Claude に提供します。`@` の後にファイルまたはフォルダ名を入力すると、Claude はそのコンテンツを読み取り、それについて質問に答えたり、変更を加えたりできます。Claude Code はあいまい一致をサポートしているため、部分的な名前を入力して必要なものを見つけることができます。209@メンションを使用すると、特定のファイルやフォルダーに関するコンテキストを Claude に与えられます。`@` に続けてファイル名やフォルダー名を入力すると、Claude はその内容を読み込み、それについての質問に答えたり、変更を加えたりできます。Claude Code はあいまい一致をサポートしているため、名前の一部を入力するだけで目的のものを見つけられます。

192 210 

193```text wrap theme={null}211```text wrap theme={null}

194Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)212Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)

195What's in @src/components/ (include a trailing slash for folders)213What's in @src/components/ (include a trailing slash for folders)

196```214```

197 215 

198大きな PDF の場合、ファイル全体ではなく特定のページを読むよう Claude に依頼できます。単一ページ、1～10 ページなどの範囲、またはページ 3 以降などのオープンエンド範囲。特定のページを読むには、Claude Code が実行されるマシンに [poppler-utils](/docs/ja/tools-reference#read-tool-behavior) が必要です。216大きな PDF の場合は、ファイル全体ではなく特定のページを読むよう Claude に依頼できます。単一のページ、1～10 ページのような範囲、3 ページ以降のような終わりを指定しない範囲を指定できます。特定のページを読むには、Claude Code を実行しているマシンに [poppler-utils](/docs/ja/tools-reference#read-tool-behavior) が必要です。

217 

218エディターでテキストを選択すると、Claude はハイライトされたコードを自動的に認識できます。プロンプトボックスのフッターには選択されている行数が表示されます。`Option+K`（Mac）/ `Alt+K`（Windows/Linux）を押すと、`@app.ts#5-10` のように、ファイルパスと行番号を含む @メンションが挿入されます。選択範囲インジケーターの **X** をクリックすると選択範囲が解除され、Claude はその選択範囲を受け取らなくなります。別のテキストを選択すると、インジケーターは再び表示されます。

219 

220拡張機能は、一部のファイルの選択テキストを Claude に渡しません。

199 221 

200エディターでテキストを選択すると、Claude は強調表示されたコードを自動的に表示できます。プロンプトボックスのフッターは、選択されている行数を表示します。`Option+K`（Mac）/ `Alt+K`（Windows/Linux）を押して、ファイルパスと行番号を含む @-メンション（例：`@app.ts#5-10`）を挿入します。選択表示の **X** をクリックして削除し、Claude が選択を受け取らないようにします。他のテキストを選択すると、表示が戻ります。222* ファイルがワークスペース内にあり、`files.exclude` または `search.exclude` の設定に一致する場合、Claude が受け取るのは最大でもファイルのパスのみで、選択したテキストは受け取りません。

223* VS Code の `search.useIgnoreFiles` 設定と拡張機能の [`respectGitIgnore` 設定](#extension-settings)の両方がオン（デフォルト）の場合、git が無視するファイルにも同じことが当てはまります。

201 224 

202拡張機能は一部のファイルから選択されたテキストを保留します。ファイルがワークスペース内にあり、`files.exclude` または `search.exclude` 設定と一致する場合、Claude は最大でもファイルのパスを受け取り、選択したテキストは受け取りません。同じことが git が無視するファイルにも適用されます。ただし、VS Code の `search.useIgnoreFiles` 設定と拡張機能の [`respectGitIgnore` 設定](#extension-settings)の両方がオンになっている場合に限ります。これはデフォルトです。このフィルターはチャットパネルのみをカバーします。Claude Code が統合ターミナルで実行される場合、CLI はファイルに関係なく選択されたテキストを送信するため、[`Read` 拒否ルール](#the-built-in-ide-mcp-server)を追加して、ファイルのコンテンツが Claude にそこに到達しないようにします。225このフィルターはチャットパネルにのみ適用されます。Claude Code が統合ターミナルで実行されている場合、CLI はファイルに関係なく選択したテキストを送信します。その場合にファイルの内容を Claude に渡さないようにするには、[`Read` の拒否ルール](#the-built-in-ide-mcp-server)を追加します。

203 226 

204Claude はエディターで開いているファイルも表示します。何も選択されていない場合でも、プロンプトボックスはその名前を表示します。選択されたテキストのみを追加するには、[Attach Open File 設定](vscode://settings/claudeCode.attachOpenFile)をオフにします。この設定には Claude Code v2.1.271 以降が必要です。227何も選択していない場合でも、Claude はエディターで開いているファイルを認識し、プロンプトボックスにはその名前が表示されます。選択したテキストのみを追加するには、[Attach Open File 設定](vscode://settings/claudeCode.attachOpenFile)をオフにします。この設定には Claude Code v2.1.271 以降が必要です。

205 228 

206メッセージに画像とファイルを添付することもできます。229メッセージに画像やファイルを添付することもできます。

207 230 

208* 画像を添付するには、クリップボードからプロンプトボックスに貼り付けます。231* 画像を添付するには、クリップボードからプロンプトボックスに貼り付けます。

209* ファイルを添付するには、`Shift` を押しながらプロンプトボックスにドラッグします。232* ファイルを添付するには、`Shift` を押しながらプロンプトボックスにドラッグします。

210* コンテキストから添付ファイルを削除するには、その X をクリックします。233* 添付ファイルをコンテキストから削除するには、その X をクリックします。

234 

235<h3 id="include-terminal-output-in-prompts">

236 プロンプトにターミナル出力を含める

237</h3>

238 

239`@terminal:name`（`name` はターミナルのタイトル）を使用して、プロンプトでターミナル出力を参照できます。これにより、コピー＆ペーストせずに、コマンド出力、エラーメッセージ、ログを Claude に見せることができます。

211 240 

212<h3 id="paste-text">241<h3 id="paste-text">

213 テキストを貼り付ける242 テキストを貼り付ける

214</h3>243</h3>

215 244 

216貼り付けたテキストはプロンプトボックスに表示されたままになり、[ターミナル](/docs/ja/terminal-config#paste-large-content)のようにプレースホルダーに折りたたまれません。Claude Code が[貼り付けたテキストをマーク](/docs/ja/terminal-config#how-claude-treats-pasted-text)するセッションでは、Claude は大きな貼り付けを入力したテキストではなく貼り付けたテキストとして認識します。245貼り付けたテキストは、[ターミナル](/docs/ja/terminal-config#paste-large-content)のようにプレースホルダーに折りたたまれることなく、プロンプトボックスに表示されたままになります。Claude Code が[貼り付けたテキストをマークする](/docs/ja/terminal-config#how-claude-treats-pasted-text)セッションでは、大きな貼り付けは、入力したものではなく貼り付けたテキストとして Claude に認識されます。

217 246 

218Claude Code は、プロンプトボックスに貼り付けたテキストと送信するその他すべてのテキストから[目に見えない Unicode 文字](/docs/ja/interactive-mode#invisible-characters-in-prompts)も削除します。247Claude Code は、プロンプトボックスに貼り付けたテキストや送信するその他すべての内容から、[不可視の Unicode 文字](/docs/ja/interactive-mode#invisible-characters-in-prompts)も削除します。

219 248 

220* `Removed 3 invisible characters from the pasted text` などの通知が貼り付け時に表示される場合、テキストはそれらの文字なしで入力されました。249* 貼り付け時に `Removed 3 invisible characters from the pasted text` のような通知が表示された場合、テキストはそれらの文字を除いて入力されています。

221* 送信時に削除された文字に関する通知が表示される場合、何も送信されていません。クリーンなテキストはプロンプトボックスに戻ります。表示されたテキストを送信するために再度送信します。250* 送信時に削除された文字に関する通知が表示された場合、何も送信されていません。クリーンアップされたテキストはプロンプトボックスに戻されています。表示されたとおりのテキストを送信するには、再度送信してください。

222 251 

223<h3 id="latex-math-in-responses">252<h3 id="latex-math-in-responses">

224 応答内の LaTeX 数式253 応答内の LaTeX 数式

226 255 

227チャットパネルは、Claude の応答内の LaTeX 数式を組版された数式として表示します。数式のレンダリングには Claude Code v2.1.301 以降が必要です。[ターミナルモード](#switch-to-terminal-mode)では、数式は組版されません。パネルはディスプレイ数式とインライン数式の両方を組版します。256チャットパネルは、Claude の応答内の LaTeX 数式を組版された数式として表示します。数式のレンダリングには Claude Code v2.1.301 以降が必要です。[ターミナルモード](#switch-to-terminal-mode)では、数式は組版されません。パネルはディスプレイ数式とインライン数式の両方を組版します。

228 257 

229* **ディスプレイ数式**: 独立した 1 行または複数行に置かれた `$$ … $$` または `\[ … \]` ブロック、および言語に `math` を指定したフェンス付きコードブロック258* **ディスプレイ数式**: 独立した 1 行または複数行に記述された `$$ … $$` または `\[ … \]` ブロック、および言語が `math` のフェンス付きコードブロック

230* **インライン数式**: 同じ行で開いて閉じる `$…$` または `\(…\)`（例：`$E = mc^2$` や `\(a^2 + b^2 = c^2\)`）259* **インライン数式**: `$E = mc^2$` や `\(a^2 + b^2 = c^2\)` のように、同じ行で開始と終了がある `$…$` または `\(…\)`

231 260 

232パネルは数式と同じ文字の他の用途を区別しようとするため、`$HOME`、`$5` のような価格、`sed 's/\(foo\)/\1/'` などのテキストは組版されません。コードスパン内のテキストや、フェンス付き `math` ブロック以外のコードブロック内のテキストも組版されません。組版されるはずの数式が書かれたままで表示される場合は、[A formula shows as raw LaTeX](#a-formula-shows-as-raw-latex) を参照してください。261パネルは同じ文字の他の用途と数式を区別しようとするため、`$HOME`、`$5` のような価格、`sed 's/\(foo\)/\1/'` などのテキストは組版されません。コードスパン内や、フェンス付き `math` ブロック以外のコードブロック内のテキストも組版されません。組版されるはずの数式が記述どおりに表示される場合は、[数式が生の LaTeX として表示される](#a-formula-shows-as-raw-latex)を参照してください。

233 262 

234組版された数式を含むテキストを選択してコピーすると、描画された記号ではなく、`$…$` または `$$…$$` の区切り文字で囲まれた数式の TeX ソースが得られます。[**Copy response**](#use-the-prompt-box) と `/copy` では、TeX ソースを含め、Claude が書いたとおりの応答が得られます。263組版された数式を含むテキストを選択してコピーすると、描画された記号ではなく、`$…$` または `$$…$$` の区切り文字で囲まれた数式の TeX ソースが得られます。[**Copy response**](#use-the-prompt-box) と `/copy` では、TeX ソースを含め、Claude が書いたとおりの応答が得られます。

235 264 

237 過去の会話を再開する266 過去の会話を再開する

238</h3>267</h3>

239 268 

240Claude Code パネルの上部にある **Session history** ボタンをクリックして、会話履歴にアクセスします。キーワードで検索するか、時間で参照できます。269Claude Code パネル上部の **Session history** ボタンをクリックすると、会話履歴にアクセスできます。キーワードで検索したり、時系列で参照したりできます。

270 

271任意の会話をクリックすると、完全なメッセージ履歴とともに再開できます。その会話が現在のウィンドウの別のタブですでに開いている場合は、クリックするとそのタブに切り替わります。最初にメッセージが空白のままの場合は、[空白になる理由と表示されるタイミング](#a-resumed-conversation-is-blank-at-first)を参照してください。セッションの再開について詳しくは、[セッションを管理する](/docs/ja/sessions)を参照してください。

272 

273* **セッションタイトル**: 新しいセッションには、最初のメッセージに基づいて AI が生成したタイトルが付けられます。

274* **名前の変更とアーカイブ**: セッションにカーソルを合わせると、これらのアクションが表示されます。名前を変更してわかりやすいタイトルを付けたり、アーカイブしてリスト下部の **Archived sessions** グループに移動したりできます。

275 

276会話が別の Claude Code プロセス（ターミナルの `claude` や別の VS Code ウィンドウなど）で開かれている場合、プロンプトボックスの代わりに次の通知が表示されます。

277 

278```text theme={null}

279This conversation is still open somewhere else. Using it in two places at once can mix up its messages.

280```

241 281 

242任意の会話をクリックして、完全なメッセージ履歴で再開します。会話が現在のウィンドウの別のタブで既に開いている場合、クリックするとそのタブに切り替わります。最初にメッセージが空白のままになる場合は、[空白になる理由と表示されるタイミング](#a-resumed-conversation-is-blank-at-first)を参照してください。セッションの再開の詳細については、[セッションを管理](/docs/ja/sessions)を参照してください。282ここで続行するには、もう一方の場所で会話を閉じてから **Open here anyway** をクリックします。閉じずにクリックすると、会話は両方の場所で開かれた状態になります。[`claudeProcessWrapper`](#extension-settings) が設定されている場合、拡張機能はこのチェックをスキップして会話を直接開きます。

243 283 

244* **セッションタイトル**: 新しいセッションは最初のメッセージに基づいて AI が生成したタイトルを受け取ります。284デフォルトでは、14 日間アクティビティのないセッションは、開いている、未読である、または[グループ](#organize-sessions-into-groups)に属している場合を除き、自動的に **Archived sessions** に移動します。自動アーカイブには Claude Code v2.1.265 以降が必要です。期間を変更したりオフにしたりするには、[Archive Inactive Sessions 設定](vscode://settings/claudeCode.archiveInactiveSessions)を開き、日数または **Never** を選択します。

245* **名前変更とアーカイブ**: セッションにマウスを置いて、これらのアクションを表示します。説明的なタイトルを付けるために名前を変更するか、リストの下部にある **Archived sessions** グループに移動するためにアーカイブします。

246 285 

247会話が別の Claude Code プロセス（ターミナルの `claude` や別の VS Code ウィンドウなど）で開いている場合、プロンプトボックスの代わりに次の通知が表示されます：`This conversation is still open somewhere else. Using it in two places at once can mix up its messages.` ここで続行するには、別の場所で会話を閉じてから **Open here anyway** をクリックします。閉じずにクリックすると、会話は両方の場所で開いた状態になります。[`claudeProcessWrapper`](#extension-settings) が設定されている場合、拡張機能はこのチェックをスキップし、会話を直接開きます。286アーカイブしたセッションを復元するには、次のようにします。

248 287 

249デフォルトでは、14 日間アクティビティがないセッションは、開いている、未読、または[グループ](#organize-sessions-into-groups)内にない限り、自動的に **Archived sessions** に移動します。自動アーカイブには Claude Code v2.1.265 以降が必要です。期間を変更するか、オフにするには、[Archive Inactive Sessions 設定](vscode://settings/claudeCode.archiveInactiveSessions)を開き、日数または **Never** を選択します。288* **1 つのセッション**: **Archived sessions** を展開し、**Unarchive session** をクリックします。

289* **アーカイブしたすべてのセッションを一括で**: アクティビティバーのセッションリストにある **Archived sessions** ヘッダーにカーソルを合わせ、そのアーカイブ解除アイコンをクリックします。Claude Code v2.1.277 以降が必要です。

250 290 

251アーカイブされたセッションを復元するには、**Archived sessions** を展開して **Unarchive session** をクリックします。アーカイブされたすべてのセッションを一度に復元するには、セッションリストの Activity Bar で **Archived sessions** ヘッダーにマウスを置き、その復元アイコンをクリックします。これには Claude Code v2.1.277 以降が必要です。v2.1.257 より前では、アクションは **Delete session** でした。これはセッションを非表示にし、復元する方法がありませんでした。その後削除したセッションは、アップグレード後に **Archived sessions** の下に表示されます。291v2.1.257 より前は、このアクションは **Delete session** で、セッションを復元する手段のない形で非表示にしていました。その際に削除したセッションは、アップグレード後に **Archived sessions** の下に表示されます。

252 292 

253再開した会話が plan モードで終了した場合、Claude Code は plan モードを復元します。Claude Code v2.1.246 以降が必要です。次の場合、Claude Code は復元しません。293再開した会話が plan モードで終了していた場合、Claude Code は plan モードを復元します。Claude Code v2.1.246 以降が必要です。次の場合、Claude Code は plan モードを復元しません。

254 294 

255* 拡張機能が `claudeCode.initialPermissionMode` から開始権限モードを[選択](/docs/ja/permission-modes#switch-permission-modes)するか、以前の会話から引き継がれたピックがある295* 拡張機能が `claudeCode.initialPermissionMode` から、または以前の会話から引き継がれた選択から[開始時の権限モードを選択する](/docs/ja/permission-modes#switch-permission-modes)場合

256* `claudeCode.claudeProcessWrapper` が設定されている296* `claudeCode.claudeProcessWrapper` を設定している場合

257* [拒否ルール](/docs/ja/permissions#manage-permissions)によって [`ExitPlanMode`](/docs/ja/tools-reference) ツールが除外されている場合297* [拒否ルール](/docs/ja/permissions#manage-permissions)によって [`ExitPlanMode`](/docs/ja/tools-reference) ツールが除外されている場合

258 298 

259<h3 id="resume-cloud-sessions-from-claude-ai">299<h3 id="resume-cloud-sessions-from-claude-ai">

260 Claude.ai からクラウドセッションを再開する300 claude.ai のクラウドセッションを再開する

261</h3>301</h3>

262 302 

263[クラウドセッション](/docs/ja/claude-code-on-the-web)を実行している場合、VS Code で直接再開できます。これには **Claude.ai Subscription** でのサインインが必要です。Anthropic Console ではありません。303[クラウドセッション](/docs/ja/claude-code-on-the-web)を実行している場合は、VS Code で直接再開できます。これには、Anthropic Console ではなく **Claude.ai Subscription** でのサインインが必要です。

264 304 

265<Steps>305<Steps>

266 <Step title="セッション履歴を開く">306 <Step title="セッション履歴を開く">

267 Claude Code パネルの上部にある **Session history** ボタンをクリックします。307 Claude Code パネル上部の **Session history** ボタンをクリックします。

268 </Step>308 </Step>

269 309 

270 <Step title="Web タブを選択">310 <Step title="Web タブを選択する">

271 ダイアログには 2 つのタブが表示されます。Local と Web です。**Web** をクリックして claude.ai からのセッションを表示します。311 ダイアログには Local と Web の 2 つのタブが表示されます。**Web** をクリックすると、claude.ai のセッションが表示されます。

272 </Step>312 </Step>

273 313 

274 <Step title="再開するセッションを選択">314 <Step title="再開するセッションを選択する">

275 セッションを参照または検索します。任意のセッションをクリックして会話をローカルで続行します。315 セッションを参照または検索します。いずれかをクリックすると、ローカルで会話を続行できます。

276 </Step>316 </Step>

277</Steps>317</Steps>

278 318 

279<Note>319<Note>

280 フォルダが GitHub リポジトリの場合、Web タブはそのリポジトリからのセッションのみを表示します。320 開いているフォルダーが GitHub リポジトリの場合、Web タブにはそのリポジトリのセッションのみが表示されます。

281 321 

282 クラウドセッションを再開すると、拡張機能は会話履歴のコピーをダウンロードします。変更は claude.ai に同期されません。322 クラウドセッションを再開すると、拡張機能は会話履歴のコピーをダウンロードします。変更は claude.ai には同期されません。

283</Note>323</Note>

284 324 

285Web タブは、[Remote Control](/docs/ja/remote-control)セッションもリストします。開いているフォルダで実行されたセッションをクリックすると、拡張機能はコピーをダウンロードする代わりにそのローカル会話を開き、それを表示しているタブが既にある場合はそのタブにフォーカスします。拡張機能が別の Claude プロセスが会話を開いている可能性を除外できない場合、代わりにダウンロードされたコピーを取得します。325Web タブには [Remote Control](/docs/ja/remote-control) セッションも一覧表示されます。開いているフォルダーで実行されたセッションをクリックすると、拡張機能はコピーをダウンロードする代わりにそのローカルの会話を開きます。すでにその会話を表示しているタブがある場合は、そのタブにフォーカスします。別の Claude プロセスがその会話を開いている可能性を拡張機能が排除できない場合は、代わりにダウンロードしたコピーが開かれます。

286 326 

287会話のいずれかの部分がダウンロードに失敗した場合、エラーが表示され、コピーは保存されません。セッションを再度選択して再試行します。ダウンロードする会話がまだないセッションを選択した場合、エラーはそれを続行する場所を示します。327会話の一部のダウンロードに失敗した場合は、エラーが表示され、コピーは保存されません。再試行するには、もう一度セッションを選択してください。ダウンロードできる会話がまだないセッションを選択した場合は、代わりにどこで続行すればよいかをエラーで案内します。

288 328 

289<h3 id="check-account-and-usage">329<h3 id="check-account-and-usage">

290 アカウントと使用状況を確認する330 アカウントと使用量を確認する

291</h3>331</h3>

292 332 

293`/usage` を実行して Account & usage ダイアログを開きます。サインインしているアカウントを表示し、報告される使用状況はサインインによって異なります。333`/usage` を実行すると Account & usage ダイアログが開き、サインインしているアカウントと使用量が表示されます。使用量の数値はサインイン方法に応じて異なります。

294 334 

295* **claude.ai プラン**: 現在のセッションと週など、プランの制限の使用状況バー。各バーは、制限がリセットされるまでの時間を表示します。335* **claude.ai プラン**: 現在のセッションや週など、プランの制限ごとの使用量バーが表示されます。各バーには、その制限がリセットされるまでの時間が表示されます。

296 336 

297 ダイアログは、プランの制限に寄与しているものも詳しく説明します。キャッシュミス、長いコンテキスト、サブエージェント集約型または高度に並列化されたセッションなど、最近の使用状況の 10% 以上を占める動作にフラグを立て、それぞれを削減するためのヒントを提供します。属性テーブルは、各スキル、サブエージェント、プラグイン、MCP サーバーからどの程度の使用状況が来たかを示します。337 ダイアログでは、プランの制限に影響している要因の内訳も確認できます。キャッシュミス、長いコンテキスト、サブエージェントを多用するセッションや並列性の高いセッションなど、最近の使用量の 10% 以上を占める動作が指摘されます。指摘された動作にはそれぞれ、削減するためのヒントが示されます。帰属テーブルには、各スキル、サブエージェント、プラグイン、MCP サーバーによる使用量が表示されます。

298 338 

299 Day と Week トグルを使用して、過去 24 時間と過去 7 日間を切り替えます。数値は概算であり、このマシン上のローカルセッションから計算されるため、他のデバイスまたは claude.ai からの使用状況は含まれません。339 Day と Week のトグルを使用すると、過去 24 時間と過去 7 日間を切り替えられます。数値は概算であり、このマシン上のローカルセッションから計算されるため、他のデバイスや claude.ai での使用量は含まれません。

300* **その他のサインイン**: [サードパーティプロバイダー](#use-third-party-providers)または API キーなど、プランの制限がサインインに適用されない場合、Usage セクションはセッション自体のコストとトークン使用状況を代わりに表示します。CLI の `/usage` は[セッションブロック](/docs/ja/costs#track-your-costs)で同じ合計を表示します。Activity Bar のセッションリストは、**Account & usage** ヘッダーの下にアクティブセッションの合計も表示します。Claude Code v2.1.277 以降が必要です。340* **その他のサインイン**: [サードパーティプロバイダー](#use-third-party-providers)や API キーを使用している場合など、サインイン方法にプランの制限が適用されない場合は、Usage セクションに代わりにセッション自体のコストとトークン使用量が表示されます。CLI の `/usage` でも、[Session ブロック](/docs/ja/costs#track-your-costs)に同じ合計が表示されます。アクティビティバーのセッションリストにも、**Account & usage** ヘッダーの下にアクティブなセッションの合計が表示されます。Claude Code v2.1.277 以降が必要です。

301 341 

302使用状況の追跡と削減の詳細については、[コストを追跡](/docs/ja/costs#track-your-costs)を参照してください。342使用量の追跡と削減について詳しくは、[コストを追跡する](/docs/ja/costs#track-your-costs)を参照してください。

343 

344<h3 id="rewind-with-checkpoints">

345 チェックポイントで巻き戻す

346</h3>

347 

348VS Code 拡張機能はチェックポイントをサポートしています。チェックポイントは Claude によるファイル編集を追跡し、以前の状態に巻き戻せるようにします。任意のメッセージにカーソルを合わせると巻き戻しボタンが表示されるので、次の 3 つのオプションから選択します。

349 

350* **Fork conversation from here**: すべてのコード変更をそのまま保持しつつ、このメッセージから新しい会話の分岐を開始します

351* **Rewind code to here**: 会話履歴全体を保持しつつ、ファイルの変更を会話のこの時点まで元に戻します

352* **Fork conversation and rewind code**: 新しい会話の分岐を開始し、ファイルの変更をこの時点まで元に戻します

353 

354チェックポイントの仕組みと制限について詳しくは、[チェックポイント機能](/docs/ja/checkpointing)を参照してください。

303 355 

304<h2 id="customize-your-workflow">356<h2 id="customize-your-workflow">

305 ワークフローをカスタマイズする357 ワークフローをカスタマイズする

306</h2>358</h2>

307 359 

308Claude パネルの位置を変更したり、複数の会話を実行したり、セッションリストをグループに整理したり、ターミナルモードに切り替えたりできます。360Claude パネルの位置を変更したり、複数の会話を実行したり、セッションリストをグループ化またはフィルタリングしたり、ターミナルモードに切り替えたりできます。

309 361 

310<h3 id="choose-where-claude-lives">362<h3 id="choose-where-claude-lives">

311 Claude の配置場所を選択する363 Claude の配置場所を選ぶ

312</h3>364</h3>

313 365 

314Claude パネルを VS Code 内の任意の場所に移動できます。パネルのタブまたはタイトルバーをつかんで、以下の場所にドラッグします。366Claude パネルをドラッグして、VS Code 内の任意の場所に移動できます。パネルのタブまたはタイトルバーをつかんで、次の場所にドラッグします。

315 367 

316* **セカンダリサイドバー**: ウィンドウの右側。コード作成中に Claude を表示したままにします。368* **セカンダリサイドバー**：ウィンドウの右側です。コーディング中も Claude を表示したままにできます。

317* **プライマリサイドバー**: Explorer、Search などのアイコンがある左側のサイドバー。369* **プライマリサイドバー**：エクスプローラーや検索などのアイコンがある左側のサイドバーです。

318* **エディタ領域**: Claude をファイルの横のタブとして開きます。サイドタスクに便利です。370* **エディター領域**：Claude をファイルと並ぶタブとして開きます。サイドタスクに便利です。

319 371 

320Claude がエディタグループの新しいタブを開くと、拡張機能はそのグループをロックするため、Claude タブがフォーカスされている間に開いたファイルは別のグループに移動します。372Claude が新しいエディターグループでタブを開くと、拡張機能はそのグループをロックします。その後、Claude のタブにフォーカスがある状態で開いたファイルは、その隣ではなく別のグループに開かれます。

321 373 

322拡張機能がグループをロックするのを停止するには、[Lock Editor Groups 設定](vscode://settings/claudeCode.lockEditorGroups)をオフにします。既にロックされているグループは、ロック解除するまでロックされたままです。この設定には Claude Code v2.1.274 以降が必要です。374拡張機能がグループをロックしないようにするには、[Lock Editor Groups 設定](vscode://settings/claudeCode.lockEditorGroups)をオフにします。すでにロックされているグループは、ロックを解除するまでロックされたままです。この設定には Claude Code v2.1.274 以降が必要です。

323 375 

324<Tip>376<Tip>

325 メイン Claude セッションにはサイドバーを使用し、サイドタスク用に追加タブを開きます。Claude は優先される場所を記憶します。アクティビティバーのセッションリストアイコンは Claude パネルとは別です。セッションリストは常にアクティビティバーに表示されますが、Claude パネルアイコンは左側のサイドバーにドッキングされている場合にのみそこに表示されます。377 メインの Claude セッションにはサイドバーを使い、サイドタスクには追加のタブを開きましょう。Claude は好みの配置場所を記憶します。アクティビティバーのセッションリストアイコンは Claude パネルとは別のものです。セッションリストは常にアクティビティバーに表示されますが、Claude パネルのアイコンがそこに表示されるのは、パネルが左側のサイドバーにドッキングされている場合のみです。

326</Tip>378</Tip>

327 379 

328<h3 id="continue-conversations-after-a-reload">380<h3 id="continue-conversations-after-a-reload">

329 リロード後に会話を続行する381 リロード後に会話を続ける

330</h3>382</h3>

331 383 

332**Developer: Reload Window** を実行するか VS Code を再起動した後、チャットがその会話とともに戻るかどうかは、それがどこで開かれていたかによって異なります。384**Developer: Reload Window** を実行するか VS Code を再起動した後は、会話がどこで開かれていたかを確認してください。

385 

386* **エディタータブ**：会話はそのタブとともに復元されます。

387* **サイドバー**：過去 10 分以内にその会話でメッセージを送信したか Claude が応答した場合、会話は復元されます。復元されない場合は、[セッション履歴](#resume-past-conversations)から会話を再開してください。

333 388 

334* **エディタタブ**: 会話はそのタブとともに戻ります。389別の Claude Code プロセスがまだその会話を開いている場合は、ここで開く前に確認が求められます。これは[セッション履歴から再開する](#resume-past-conversations)ときと同じ **Open here anyway** の通知です。最初にメッセージが空白のままの場合は、[空白になる理由と表示されるタイミング](#a-resumed-conversation-is-blank-at-first)を参照してください。

335* **サイドバー**: 過去 10 分以内にメッセージを送信したか Claude が応答した場合、会話は戻ります。戻らない場合は、[セッション履歴](#resume-past-conversations)から会話を再開してください。

336 390 

337別の Claude Code プロセスがまだその会話を開いている場合は、ここで開く前に確認を求められます。その際には、[セッション履歴から再開する](#resume-past-conversations)ときと同じ **Open here anyway** の通知が表示されます。メッセージが最初は空白のままの場合は、[空白になる理由と表示されるタイミング](#a-resumed-conversation-is-blank-at-first)を参照してください。391<h4 id="interrupted-steps-after-a-reload">

392 リロード後に中断されたステップ

393</h4>

338 394 

339リロードが Claude の途中のステップを中断した場合、会話が戻ると Claude はそのステップを続行し、チャット内の通知が継続をマークします。Claude Code v2.1.274 以降が必要です。ステップが 1 時間以上前に中断されたか、セッションが別の場所で開かれている場合、会話はアイドル状態で戻ります。395リロードによって Claude がステップの途中で中断された場合、会話が復元されると Claude はそのステップを続行し、チャット内の通知で続行であることが示されます。Claude Code v2.1.274 以降が必要です。ステップが中断されてから 1 時間以上経過している場合や、セッションが別の場所で開かれている場合は、代わりに会話はアイドル状態で復元されます。

396 

397<h4 id="turn-off-continuation-after-a-reload">

398 リロード後の続行をオフにする

399</h4>

340 400 

341継続をオフにするには、[Continue After Reload 設定](vscode://settings/claudeCode.continueAfterReload)を開いてチェックを外します。VS Code の環境または [`environmentVariables` 設定](#extension-settings)で [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ja/env-vars#variables) やその他の `CLAUDE_CODE_RESUME_` 変数を設定しても、パネルでは効果がありません。拡張機能がパネルのセッションを開始する前にこれらの変数を削除するためです。401リロード後に Claude が中断されたステップを続行しないようにするには、[Continue After Reload 設定](vscode://settings/claudeCode.continueAfterReload)を開いてチェックを外します。

402 

403VS Code の環境または [`environmentVariables` 設定](#extension-settings)で [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ja/env-vars#variables) やその他の `CLAUDE_CODE_RESUME_` 変数を設定しても、パネルでは効果がありません。これは、拡張機能がパネルのセッションを開始する前にそれらの変数を削除するためです。

342 404 

343<h4 id="a-conversation-was-not-reopened">405<h4 id="a-conversation-was-not-reopened">

344 会話が再度開かれなかった場合406 会話が再度開かれなかった

345</h4>407</h4>

346 408 

347リロード後、プロンプトボックスの上に次のような通知がある新しいチャットが表示された場合、その会話を開く処理が直近 2 回とも完了しなかったため、パネルが会話を閉じたままにしたことを意味します。409リロード後、プロンプトボックスの上に次のような通知が表示された新しいチャットが開いた場合、その会話の直近 2 回の読み込みが完了しなかったため、パネルが会話を閉じたままにしたことを意味します。

348 410 

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

350“Fix the login bug” was not reopened. It did not finish opening the last 2 times, and opening it again may stop Claude Code from responding here.412“Fix the login bug” was not reopened. It did not finish opening the last 2 times, and opening it again may stop Claude Code from responding here.

351```413```

352 414 

353会話の読み込み中にパネルがクラッシュしたり応答しなくなったりした場合、または会話が開いてから約 3 秒以内にウィンドウをリロードしたり閉じたりした場合、開く処理は完了しません。失われるものはありません。会話は変更されず、[セッション履歴](#resume-past-conversations)に残ります。415会話の読み込み中にパネルがクラッシュしたり応答しなくなったりした場合、または会話が開いてから約 3 秒以内にウィンドウをリロードしたり閉じたりした場合、読み込みは完了しません。会話は変更されず、[セッション履歴](#resume-past-conversations)に残ります。

354 416 

355* **それでも開くには**: **Open it anyway** をクリックするか、セッション履歴から会話を選択します。会話が開いてパネルが正常に動作し続ける場合、以降のリロード後は通常どおり戻ります。パネルが再び応答しなくなった場合は、ウィンドウをリロードすると通知付きの新しいチャットに戻ります。417* **それでも開く場合**：**Open it anyway** をクリックするか、セッション履歴から会話を選択します。会話が開いてパネルが正常に動作し続ければ、以降のリロード後も通常どおり復元されます。パネルが再び応答しなくなった場合は、ウィンドウをリロードすると、通知付きの新しいチャットに戻ります。

356* **閉じたままにするには**: 新しいチャットで作業を続けます。プロンプトを送信すると通知は消えます。418* **閉じたままにする場合**：新しいチャットで作業を続けてください。プロンプトを送信すると通知は消えます。

357 419 

358<h3 id="run-multiple-conversations">420<h3 id="run-multiple-conversations">

359 複数の会話を実行する421 複数の会話を実行する

360</h3>422</h3>

361 423 

362コマンドパレットから **Open in New Tab** または **Open in New Window** を使用して、追加の会話を開始します。各会話は独自の履歴とコンテキストを保持し、異なるタスクを並行して処理できます。424コマンドパレットから **Open in New Tab** または **Open in New Window** を使用して、追加の会話を開始できます。各会話は独自の履歴とコンテキストを保持するため、異なるタスクを並行して進められます。

363 425 

364タブを使用する場合、スパークアイコンの小さなカラーの点がステータスを示します。青は権限リクエストが保留中であることを意味し、オレンジはタブが非表示の間に Claude が完了したことを意味します。426タブを使用している場合、スパークアイコン上の小さな色付きのドットがステータスを示します。青は権限リクエストが保留中であること、オレンジはタブが非表示の間に Claude が処理を完了したことを意味します。

365 427 

366<h3 id="organize-sessions-into-groups">428<h3 id="organize-sessions-into-groups">

367 セッションをグループに整理する429 セッションをグループに整理する

368</h3>430</h3>

369 431 

370アクティビティバーのセッションリストで、関連するセッションを名前付きの折りたたみ可能なグループに集めることができます。Claude Code v2.1.229 以降が必要です。432アクティビティバーのセッションリストでは、関連するセッションを名前付きの折りたたみ可能なグループにまとめられます。Claude Code v2.1.229 以降が必要です。

371 433 

372* **セッションをグループ化または非グループ化する**: セッションを右クリックしてそれからグループを作成したり、既存のグループに移動したり、グループから削除したりします。各セッションは一度に 1 つのグループに属するため、別のグループに移動すると最初のグループから削除されます。434* **セッションをグループ化またはグループ解除する**：セッションを右クリックして、そのセッションからグループを作成したり、既存のグループに移動したり、グループから削除したりします。各セッションは一度に 1 つのグループにのみ所属するため、別のグループに移動すると元のグループからは削除されます。

373* **複数のセッションを一度に移動する**: `Cmd` キー（Mac）/ `Ctrl` キー（Windows/Linux）を押しながら各セッションをクリックするか、`Shift` キーを押しながらクリックして範囲を選択してから、選択内容を右クリックします。435* **複数のセッションを一度に移動する**：各セッションを `Cmd` クリック（Mac）/ `Ctrl` クリック（Windows/Linux）するか、`Shift` クリックで範囲を選択してから、選択部分を右クリックします。

374* **タブからセッションをグループ化する**: コマンドパレットから **Claude Code: Add Session Tab to Group** を実行してからグループを選択または作成します。Claude Code v2.1.257 以降が必要です。436* **タブからセッションをグループ化する**：コマンドパレットから **Claude Code: Add Session Tab to Group** を実行し、グループを選択または作成します。Claude Code v2.1.257 以降が必要です。

375* **グループの名前を変更または削除する**: グループヘッダーを右クリックします。グループを削除するとグループのみが削除され、そのセッションは非グループ化されたリストに戻ります。437* **グループの名前を変更または削除する**：グループのヘッダーを右クリックします。グループを削除してもグループ自体が削除されるだけで、そのセッションはグループ化されていないリストに戻ります。

376 438 

377拡張機能はワークスペースフォルダごとにグループを保存するため、ウィンドウの再読み込み後も保持され、同じフォルダを開くすべてのウィンドウに表示されます。リストを検索すると、拡張機能はすべてのグループ全体で 1 つのフラットリストに一致するものを表示します。439拡張機能はグループをワークスペースフォルダーごとに保存するため、グループはウィンドウのリロード後も保持され、同じフォルダーを開いたすべてのウィンドウに表示されます。リストを検索すると、拡張機能はすべてのグループにまたがる一致結果を 1 つのフラットなリストで表示します。

378 440 

379<h3 id="filter-the-sessions-list">441<h3 id="filter-the-sessions-list">

380 セッションリストをフィルタリングする442 セッションリストをフィルタリングする

381</h3>443</h3>

382 444 

383アクティビティバーの長いセッションリストを絞り込むには、リストの上部にある 2 つのフィルタコントロールを使用します。Claude Code v2.1.271 以降が必要です。アーカイブされたセッションは、どちらかのフィルタがオンの間は表示されません。445アクティビティバーの長いセッションリストを絞り込むには、リスト上部にある 2 つのフィルターコントロールを使用します。Claude Code v2.1.271 以降が必要です。いずれかのフィルターがオンの間は、アーカイブされたセッションは表示されません。

384 446 

385* **アクティブ**: このトグルをオンにして、入力が必要なセッション、処理中のセッション、未読のセッション、および最後にフォーカスした Claude タブのセッションのみを表示します。447* **Active**：このトグルをオンにすると、入力が必要なセッション、処理中のセッション、未読のセッションと、最後にフォーカスした Claude タブのセッションのみが表示されます。

386* **ステータスでフィルタリング**: ファネルアイコンをクリックしてから、**入力が必要**、**処理中**、または **完了** をチェックして、これらの状態のセッションを表示します。**開く** または **閉じる** をチェックして、セッションが開いているかどうかで絞り込みます。セッションは、このウィンドウにタブがある場合、またはターミナルなどのこのマシン上の別の Claude Code プロセスで実行されている場合、開いていると見なされます。448* **ステータスでフィルタリング**：じょうごアイコンをクリックし、**Needs input**、**Working**、または **Completed** にチェックを入れると、それらのいずれかの状態にあるセッションが表示されます。**Open** または **Closed** にチェックを入れると、セッションが開いているかどうかで絞り込めます。このウィンドウにタブがある場合、またはこのマシン上の別の Claude Code プロセス（ターミナルなど）で実行中の場合、セッションは開いているとみなされます。