Documentation 2026-10-24 22:59 UTC to 2026-10-25 23:58 UTC

771 771 

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

773 773 

774* `PreToolUse`：Claude Code はツール呼び出しをブロックします。その代わりに、Claude はフックがタイムアウト前に応答しなかったことを示すツール結果を受け取り、ターンが続行されます。v2.1.210 より前では、Claude Code はタイムアウトを Claude にユーザー拒否として報告していたため、無人セッションは停止して入力を待つようになっていました。774* `PreToolUse`：Claude Code はツール呼び出しをブロックします。他のすべてのフックが何も返さなかったか、`allow` の決定のみを返した場合、ツール結果はフックがタイムアウト前に応答しなかったことを Claude に伝え、ターンが続行されます。他のフックがすでにその呼び出しを拒否していた場合でも、その拒否は Claude に届きます：ツール結果にはそのフックの理由が含まれ、その後にタイムアウトのテキストが続くことがあります。

775 

776 v2.1.210 より前では、Claude Code はタイムアウトを Claude にユーザー拒否として報告していたため、無人セッションは停止して入力を待つようになっていました。

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

776* `UserPromptSubmit` および [`UserPromptExpansion`](https://code.claude.com/docs/ja/hooks#userpromptexpansion)：Claude Code はフックとタイムアウトを名前で示すメッセージでプロンプトをブロックし、セッションが続行されます。v2.1.208 より前では、これらのイベントのコールバックがタイムアウトした場合、Claude Code はクエリを `error_during_execution` で終了していました。778* `UserPromptSubmit` および [`UserPromptExpansion`](https://code.claude.com/docs/ja/hooks#userpromptexpansion)：Claude Code はフックとタイムアウトを名前で示すメッセージでプロンプトをブロックし、セッションが続行されます。v2.1.208 より前では、これらのイベントのコールバックがタイムアウトした場合、Claude Code はクエリを `error_during_execution` で終了していました。

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

309| `options.dir` | `string` | `undefined` | セッションを検出するプロジェクトディレクトリ。省略した場合、すべてのプロジェクトを検索します |309| `options.dir` | `string` | `undefined` | セッションを検出するプロジェクトディレクトリ。省略した場合、すべてのプロジェクトを検索します |

310| `options.limit` | `number` | `undefined` | 返すメッセージの最大数 |310| `options.limit` | `number` | `undefined` | 返すメッセージの最大数 |

311| `options.offset` | `number` | `undefined` | 開始からスキップするメッセージ数 |311| `options.offset` | `number` | `undefined` | 開始からスキップするメッセージ数 |

312| `options.includeSystemMessages` | `boolean` | `false` | `true` の場合、ユーザーとアシスタントのメッセージに加えて、コンパクト境界などのシステムメッセージも返します |

312 313 

313#### 戻り値の型：`SessionMessage`314#### 戻り値の型：`SessionMessage`

314 315 

315| プロパティ | 型 | 説明 |316| プロパティ | 型 | 説明 |

316| :- | :- | :- |317| :- | :- | :- |

317| `type` | `"user" \| "assistant"` | メッセージロール |318| `type` | `"user" \| "assistant" \| "system"` | メッセージロール。`"system"` は `options.includeSystemMessages` が `true` の場合にのみ表示されます |

318| `uuid` | `string` | 一意のメッセージ識別子 |319| `uuid` | `string` | 一意のメッセージ識別子 |

319| `session_id` | `string` | このメッセージが属するセッション |320| `session_id` | `string` | このメッセージが属するセッション |

320| `message` | `unknown` | トランスクリプトからの生のメッセージペイロード |321| `message` | `unknown` | トランスクリプトからの生のメッセージペイロード |

632 }): Promise<SDKControlReloadPluginsResponse>;633 }): Promise<SDKControlReloadPluginsResponse>;

633 reloadSkills(): Promise<SDKControlReloadSkillsResponse>;634 reloadSkills(): Promise<SDKControlReloadSkillsResponse>;

634 reloadOutputStyles(): Promise<SDKControlReloadOutputStylesResponse>;635 reloadOutputStyles(): Promise<SDKControlReloadOutputStylesResponse>;

636 seedReadState(path: string, mtime: number): Promise<void>;

635 accountInfo(): Promise<AccountInfo>;637 accountInfo(): Promise<AccountInfo>;

636 reconnectMcpServer(serverName: string): Promise<void>;638 reconnectMcpServer(serverName: string): Promise<void>;

637 toggleMcpServer(serverName: string, enabled: boolean): Promise<void>;639 toggleMcpServer(serverName: string, enabled: boolean): Promise<void>;

638 setMcpServers(servers: Record<string, McpServerConfig>): Promise<McpSetServersResult>;640 setMcpServers(servers: Record<string, McpServerConfig>): Promise<McpSetServersResult>;

641 setMcpPermissionModeOverride(

642 serverName: string,

643 mode: 'default' | 'auto' | null

644 ): Promise<{ warning?: string }>;

639 readMcpResource(serverName: string, uri: string): Promise<SDKControlMcpReadResourceResponse>;645 readMcpResource(serverName: string, uri: string): Promise<SDKControlMcpReadResourceResponse>;

640 streamInput(stream: AsyncIterable<SDKUserMessage>): Promise<void>;646 streamInput(stream: AsyncIterable<SDKUserMessage>): Promise<void>;

641 stopTask(taskId: string): Promise<void>;647 stopTask(taskId: string): Promise<void>;

648 backgroundTasks(toolUseId?: string): Promise<boolean>;

642 close(): void;649 close(): void;

643}650}

644```651```

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

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

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

675| `seedReadState(path, mtime)` | ファイルを読み取り済みとしてマークし、後の Edit が `File has not been read yet` で失敗しないようにします。[`seedReadState()`](#seedreadstate) を参照してください。TypeScript SDK v0.2.83 以降が必要です |

668| `accountInfo()` | アカウント情報を返します |676| `accountInfo()` | アカウント情報を返します |

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

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

671| `setMcpServers(servers)` | このメソッドが管理する MCP サーバー、つまりこのメソッドで追加したサーバーと[インプロセス SDK サーバー](#createsdkmcpserver)を置き換えます。追加および削除されたサーバーとエラーを示す [`McpSetServersResult`](#mcpsetserversresult) で解決されます。他のどのサーバーが接続されたままになるかは、そのセクションで説明しています |679| `setMcpServers(servers)` | このメソッドが管理する MCP サーバー、つまりこのメソッドで追加したサーバーと[インプロセス SDK サーバー](#createsdkmcpserver)を置き換えます。追加および削除されたサーバーとエラーを示す [`McpSetServersResult`](#mcpsetserversresult) で解決されます。他のどのサーバーが接続されたままになるかは、そのセクションで説明しています |

680| `setMcpPermissionModeOverride(serverName, mode)` | 1 つの MCP サーバーのツールの権限モードを、セッションよりも厳格なモードで上書きします。`null` を指定すると上書きがクリアされます。ストリーミング入力モードでのみ使用できます。[`setMcpPermissionModeOverride()`](#setmcppermissionmodeoverride) を参照してください。TypeScript SDK v0.3.187 以降が必要です |

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

673| `streamInput(stream)` | マルチターンの会話のために、入力メッセージをクエリにストリーミングします |682| `streamInput(stream)` | マルチターンの会話のために、入力メッセージをクエリにストリーミングします |

674| `stopTask(taskId)` | ID を指定して実行中のバックグラウンドタスクを停止します |683| `stopTask(taskId)` | ID を指定して実行中のバックグラウンドタスクを停止します |

684| `backgroundTasks(toolUseId?)` | ターンが待機している実行中の Bash コマンドとサブエージェントを、対話型ターミナルで Ctrl+B を押した場合と同様にバックグラウンドに移動します。[`backgroundTasks()`](#backgroundtasks) を参照してください。TypeScript SDK v0.2.139 以降が必要です |

675| `close()` | クエリを閉じ、基盤となるプロセスを終了します。クエリを強制的に終了し、すべてのリソースをクリーンアップします |685| `close()` | クエリを閉じ、基盤となるプロセスを終了します。クエリを強制的に終了し、すべてのリソースをクリーンアップします |

676 686 

687#### `setMcpPermissionModeOverride()`

688 

6891 つの MCP サーバーのツールの権限モードを、セッションよりも厳格なモードで上書きするか、`null` で上書きをクリアします。アクションごとのプロンプトをスキップするモードでセッションを実行しているものの、特定のサーバーのツールは引き続きレビューする必要がある場合に使用します。TypeScript SDK v0.3.187 以降が必要です。

690 

691`mode` には次の 3 つの値のいずれかを渡します。

692 

693* `'default'`：Claude Code は、そのサーバーのツール呼び出しを [Manual モード](https://code.claude.com/docs/ja/permission-modes.md#available-modes)と同様に評価します。

694* `'auto'`：Claude Code は、そのサーバーのツール呼び出しを [auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)の分類器に通します。セッションで分類器が使用できない場合、Claude Code はこの値を拒否します。

695* `null`：上書きをクリアします。

696 

697上書きは、セッションがアクションごとのプロンプトをスキップするモード（`bypassPermissions` または `auto`）にある間のみ有効です。それ以外のセッションモードでは Claude Code は上書きを無視するため、セッションが許可する範囲が広がることはありません。

698 

699その名前のサーバーがまだ認識されていない場合、promise は `{ warning }` で解決されます。Claude Code はそれでも上書きを保存し、その名前と完全に一致するサーバーが接続された時点で適用するため、この警告は失敗ではなく、入力ミスのチェックです。

700 

701`setModel()` や `setPermissionMode()` と同じ制約として、ストリーミング入力モードでのみ使用できます。

702 

703#### `seedReadState()`

704 

705ファイルを読み取り済みとしてマークし、後の Edit が `File has not been read yet` で失敗しないようにします。アプリケーションが以前の `Read` の結果を会話コンテキストから削除しており、Claude がその後そのファイルを編集する場合に使用します。TypeScript SDK v0.2.83 以降が必要です。

706 

707`mtime` には、その以前の読み取り時点でのファイルの更新時刻を、エポックからの整数ミリ秒で渡します（例：`Math.floor(stat.mtimeMs)`）。ディスク上のファイルがその時刻以降に変更されている場合、Claude Code はマークをスキップします。

708 

709promise はファイルがマークされたかどうかにかかわらず解決されるため、解決されたことからはどちらが起きたかはわかりません。

710 

711#### `backgroundTasks()`

712 

713ターンが待機している実行中の Bash コマンドとサブエージェントを、対話型ターミナルで Ctrl+B を押した場合と同様にバックグラウンドに移動します。ツール呼び出しの `toolUseId` を渡すとその呼び出しが開始した Bash コマンドまたはサブエージェントのみをバックグラウンドに移動し、省略するとすべてのフォアグラウンドタスクをバックグラウンドに移動します。TypeScript SDK v0.2.139 以降が必要です。

714 

715バックグラウンドに移動された各ツール呼び出しは、バックグラウンドで実行中であることを示す結果とともに即座に Claude に戻り、ターンは続行されます。タスクが終了すると、Claude Code は [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) を出力します。

716 

717バックグラウンドタスクが有効になっているセッションでは、promise はブール値で解決されます。

718 

719* **`true`**：タスクがバックグラウンドに移動されたか、`toolUseId` を省略した場合。

720* **`false`**：渡した `toolUseId` がどのフォアグラウンドタスクにも一致しなかった場合。

721 

722[`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](https://code.claude.com/docs/ja/env-vars) などでセッションのバックグラウンドタスクが無効になっている場合、promise は代わりに拒否され、何もバックグラウンドに移動されません。

723 

677#### `applyFlagSettings()`724#### `applyFlagSettings()`

678 725 

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

1472 | SDKPermissionDeniedMessage1519 | SDKPermissionDeniedMessage

1473 | SDKPromptSuggestionMessage1520 | SDKPromptSuggestionMessage

1474 | SDKAPIRetryMessage1521 | SDKAPIRetryMessage

1522 | SDKControlRequestProgressMessage

1523 | SDKModelRefusalFallbackMessage

1524 | SDKModelRefusalNoFallbackMessage

1475 | SDKMirrorErrorMessage1525 | SDKMirrorErrorMessage

1476 | SDKInformationalMessage1526 | SDKInformationalMessage

1477 | SDKConversationResetMessage;1527 | SDKConversationResetMessage;

1478```1528```

1479 1529 

1530このユニオンのうち 3 つのメッセージは、コントロールリクエストの進行状況とモデルの拒否を報告します。いずれも `type: "system"` を持つため、それぞれに記載されている `subtype` で区別してください。

1531 

1532* `SDKControlRequestProgressMessage`、`subtype: "control_request_progress"`：クライアントが送信した長時間実行のコントロールリクエストの進行状況を報告します。`request_id` によってメッセージがそのリクエストと対応付けられ、`status` は `"started"` または `"api_retry"` です。Agent SDK v0.3.203 以降が必要です。

1533* `SDKModelRefusalFallbackMessage`、`subtype: "model_refusal_fallback"`：モデルが拒否によってストリームを終了し、ターンがフォールバックモデルで再試行されるときに発行されます。`original_model` と `fallback_model` を含みます。Agent SDK v0.3.170 以降が必要です。

1534* `SDKModelRefusalNoFallbackMessage`、`subtype: "model_refusal_no_fallback"`：モデルが拒否によってストリームを終了し、再試行が実行されない場合（たとえばフォールバックモデルが設定されていない場合など）に発行されます。`original_model` を含みます。Agent SDK v0.3.193 以降が必要です。

1535 

1480### `SDKAssistantMessage`1536### `SDKAssistantMessage`

1481 1537 

1482アシスタントの応答メッセージです。1538アシスタントの応答メッセージです。

1636 stop_reason: string | null;1692 stop_reason: string | null;

1637 ttft_ms?: number;1693 ttft_ms?: number;

1638 ttft_stream_ms?: number;1694 ttft_stream_ms?: number;

1695 time_to_request_ms?: number;

1639 user_message_uuid?: string;1696 user_message_uuid?: string;

1640 user_message_uuids?: string[];1697 user_message_uuids?: string[];

1641 resume_reason?: string;1698 resume_reason?: string;

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

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

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

1761* `time_to_request_ms`：ターンの開始から Claude Code が API リクエストを送信するまでの時間（ミリ秒）です。成功時の型にのみ存在します。Claude Code v2.1.162 以降が必要です。

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

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

1706* `resume_reason`: このターンが再起動によって中断されたターンを継続する理由です。両方のアームに存在します。[`resume_reason`](#resume_reason) を参照してください。1764* `resume_reason`: このターンが再起動によって中断されたターンを継続する理由です。両方のアームに存在します。[`resume_reason`](#resume_reason) を参照してください。

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

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

1774 1832 

1833[`UserPromptSubmit`](https://code.claude.com/docs/ja/hooks#userpromptsubmit) フックが独自のターンを開始するメッセージをブロックした場合、または `continue: false` で停止した場合でも、そのメッセージの結果は得られます。それは `is_error: false` および `num_turns: 0` の成功結果で、その `result` は[ブロックメッセージ](https://code.claude.com/docs/ja/hooks.md#what-a-blocked-prompt-leaves-behind)または[停止メッセージ](https://code.claude.com/docs/ja/hooks.md#json-output)であり、他の結果と同じルールでメッセージの `uuid` をエコーします。この結果には `terminal_reason` がなく、`result` テキスト以外にフックがターンを終了したことを示すものはありません。別のターンの実行中にフックがブロックしたメッセージには、結果が返されない場合があります。[`user_message_uuids`](#user_message_uuids) を参照してください。

1834 

1775#### `user_message_uuids`1835#### `user_message_uuids`

1776 1836 

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

1778 1838 

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

1780 1840 

1781ターンの実行中に送信した通常のメッセージを Claude Code が拾った場合、そのメッセージの `uuid` が結果のリストに追加されます。1841ターンの実行中に送信した通常のメッセージを Claude Code が取り込むと、そのメッセージの `uuid` を結果のリストに追加します。[`UserPromptSubmit`](https://code.claude.com/docs/ja/hooks#userpromptsubmit) フックが取り込み時にメッセージをブロックすると、Claude Code は代わりにそれを破棄します。メッセージは Claude に届かず、後のターンのために保持されることもありません。そのメッセージの結果は得られず、その `uuid` はどの結果のリストにも現れません。フックがメッセージをブロックする可能性がある場合は、ターンの実行中に送信したメッセージを列挙する結果を待つ処理にタイムアウトを設定してください。

1842 

1843これはフックの出力がブロックのみの場合に当てはまります。出力が `continue: false` を設定している場合（`decision: "block"` と併せて設定している場合も含む）、またはフックが `continueOnBlock: true` なしで [`ok: false`](https://code.claude.com/docs/ja/hooks#response-schema) と応答するプロンプトフックである場合、Claude Code はメッセージを破棄する代わりに停止します。メッセージは独自のターンを待ち、その結果が得られ、そのテキストは会話に残るため、Claude は次のターンでそれを確認します。

1782 1844 

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

1784 1846 

525 params: z.object({525 params: z.object({

526 request_id: z.string(), // 5 つの小文字、プロンプトに逐語的に含める526 request_id: z.string(), // 5 つの小文字、プロンプトに逐語的に含める

527 tool_name: z.string(), // 例：'Bash'、'Write'527 tool_name: z.string(), // 例：'Bash'、'Write'

528 description: z.string(), // この呼び出しが何をするかの要約。信頼されないものとして扱う。528 description: z.string(), // この呼び出しの要約。信頼されないものとして扱う。

529 input_preview: z.string(), // ツール引数を JSON 形式のテキストとして。信頼されないものとして扱う。529 input_preview: z.string(), // ツール引数を JSON 形式のテキストとして。信頼されないものとして扱う。

530 }),530 }),

531})531})

581}581}

582```582```

583 583 

584期待されたフォーマットと正確に一致しないリモート返信は、2 つの方法のいずれかで失敗し、どちらの場合もローカルターミナルダイアログは開いたままです：584リモート返信が効果を持たず、ローカルターミナルダイアログが開いたままの場合は、次の原因を確認してください：

585 585 

586* **異なるフォーマット**：インバウンドハンドラーの正規表現が一致しないため、'approve it'または ID なしの'yes'のようなテキストは通常のメッセージとして Claude にフォールスルーします。586* **フォーマットが間違っている**：インバウンドハンドラーの正規表現が一致しないため、`approve it` や ID なしの `yes` のようなテキストは通常のメッセージとして Claude にフォールスルーします。

587* **正しいフォーマット、間違った ID**：サーバーは判定を発行しますが、Claude Code はその ID を持つ開いているリクエストを見つけず、サイレントにドロップします。587* **ID が間違っている**：サーバーは判定を発行しますが、Claude Code はその ID を持つ開いているリクエストを見つけられず、サイレントにドロップします。

588* **ID が以前のプロンプトで使用されていた**：サーバーはリクエストの ID を使って判定を発行しますが、セッション内の以前のプロンプトが同じ ID を持っていました。ID が重複すると、Claude Code はその ID を持つチャネル判定をすべてドロップします。これにより、一方のプロンプト向けの返信がもう一方を承認することはありません。ID はランダムな 5 文字なので、重複はまれです。代わりにターミナルで応答してください。

588 589 

589### 完全な例590### 完全な例

590 591 

90 90 

91### ターン中に送信されたメッセージはチェックポイントされません91### ターン中に送信されたメッセージはチェックポイントされません

92 92 

93巻き戻しメニューでは、[Claude がまだ作業中に入力した](https://code.claude.com/docs/ja/interactive-mode.md#queue-messages-while-claude-works)メッセージに **No code restore**（コードの復元なし）と表示されることがあります。Claude はそのメッセージをターンの終了前に読み取っています。[チェックポイントはターンを開始するプロンプトに対して作成される](#how-checkpoints-work)ため、このメッセージ自体にはチェックポイントがありません。Claude がそのメッセージを読んだ後に行った編集は、ターンを開始したプロンプトに含まれます。93巻き戻しメニューでは、[Claude がまだ作業中に入力した](https://code.claude.com/docs/ja/interactive-mode.md#queue-messages-while-claude-works)メッセージに **No code restore**（コードの復元なし）と表示されることがあります。このように表示されたメッセージには、それ自体の[チェックポイント](#how-checkpoints-work)がありません。

94 94 

95メッセージ自体について何かをする必要はありません。セッションのその部分でのファイル変更を取り消すには、ターンを開始したプロンプトを選択し、**Restore code**（コードを復元）または **Restore code and conversation**（コードと会話を復元）を選択します。これにより、メッセージが到達する前の編集を含め、ターン全体での Claude のファイル編集が元に戻されます。マークされたメッセージを選択した場合も **Restore conversation**（会話を復元）は利用でき、会話をそのメッセージまで巻き戻し、ファイルはそのまま残します。95そのメッセージの後に Claude が行ったファイル編集を取り消すには、ターンを開始したプロンプトを選択し、**Restore code**（コードを復元）または **Restore code and conversation**（コードと会話を復元）を選択します。これにより、メッセージが到達する前の編集を含め、ターン全体での Claude のファイル編集が元に戻されます。

96 96 

97### シンボリックリンクおよびハードリンクパスは復元されません97### シンボリックリンクおよびハードリンクパスは復元されません

98 98 

98 98 

99警告と使用率は `anthropic-ratelimit-unified-*` ヘッダーから取得されます。ゲートウェイは、上限が設定されている開発者に対する成功した各 `/v1/messages` レスポンスにこれらのヘッダーを追加します。ヘッダーは常に開発者自身の上限を表します。ゲートウェイは、共有クォータを表すアップストリームプロバイダーのレート制限ヘッダーを削除し、決して転送しません。99警告と使用率は `anthropic-ratelimit-unified-*` ヘッダーから取得されます。ゲートウェイは、上限が設定されている開発者に対する成功した各 `/v1/messages` レスポンスにこれらのヘッダーを追加します。ヘッダーは常に開発者自身の上限を表します。ゲートウェイは、共有クォータを表すアップストリームプロバイダーのレート制限ヘッダーを削除し、決して転送しません。

100 100 

101開発者に表示される支出額はゲートウェイ独自の [推定値](#how-requests-are-priced) であり、上限の適用に使われるのと同じ数値です。プロバイダーの請求書の金額ではありません。Claude Code はゲートウェイへの別のリクエストでドル金額を取得します。[コンプライアンス体制](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#compliance-posture) で推奨されているように開発者のマシンで `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` を設定している場合、Claude Code はそのリクエストを行いません。この変数が設定されている場合、またはゲートウェイサーバーが v2.1.284 より古い場合、バーとステータスラインは使用率のみの表示になります。101開発者に表示される支出額はゲートウェイ独自の [推定値](#how-requests-are-priced) であり、上限の適用に使われるのと同じ数値です。プロバイダーの請求書の金額ではありません。Claude Code はゲートウェイへの別のリクエストでドル金額を取得します。このリクエストは、開発者のマシンで `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` を設定している場合でも送信されます。v2.1.295 より前は、この変数が設定されていると Claude Code はそのリクエストを行わず、`/usage` とステータスラインには使用率とリセット日のみが表示され、ドル金額は表示されませんでした。

102 102 

103## 管理 API リファレンス103## 管理 API リファレンス

104 104 

18 18 

19* **ブラウザ**：[claude.ai/code](https://claude.ai/code)（ウェブ上の Claude Code とも呼ばれます）19* **ブラウザ**：[claude.ai/code](https://claude.ai/code)（ウェブ上の Claude Code とも呼ばれます）

20* **モバイル**：[Claude アプリ](https://code.claude.com/docs/ja/mobile.md)の**Code** タブ20* **モバイル**：[Claude アプリ](https://code.claude.com/docs/ja/mobile.md)の**Code** タブ

21* **デスクトップアプリ**：[セッションを開始](https://code.claude.com/docs/ja/desktop.md#run-long-running-tasks-in-the-cloud)するときに**Local** の代わりに**Cloud** を選択21* **デスクトップアプリ**：[セッションを開始](https://code.claude.com/docs/ja/desktop.md#run-long-running-tasks-in-the-cloud)するときに、環境セレクターの**Cloud** の下にある環境を選択

22* **ターミナル**：[`claude --cloud`](#from-terminal-to-cloud)22* **ターミナル**：[`claude --cloud`](#from-terminal-to-cloud)

23* **クラウドスケジュールタスク**：[スケジュール実行とトリガー実行](https://code.claude.com/docs/ja/routines.md)は各々クラウドセッションとして実行されます23* **クラウドスケジュールタスク**：[スケジュール実行とトリガー実行](https://code.claude.com/docs/ja/routines.md)は各々クラウドセッションとして実行されます

24 24 

247 247 

248### 変更を確認248### 変更を確認

249 249 

250各セッションは追加および削除された行数を示す差分インジケーター（例：`+42 -18`）を表示します。それを選択して差分ビューを開き、特定の行にインラインコメントを残し、次のメッセージで Claude に送信します。250Claude がブランチに変更をプッシュすると、チャットの横のパネルにある **Changes** カードに、`+42 -18` のように追加および削除された行数が表示されます。**Changes** カードの行数をクリックすると差分ビューが開きます。

251 251 

252差分ビューは、デフォルトでセッションの変更をそのベースブランチと比較します。リポジトリ内の他の任意のブランチと比較するには、**Compare against** を選択してブランチを 1 つ選びます。252* セッションのタイトルバー、またはバーの **⋮** メニューにある **Changes** をクリックすることもできます。

253* パネルが非表示のときに表示するには、セッションのタイトルバー、またはバーの **⋮** メニューにある **Show session rail** アイコンをクリックします。

254 

255差分ビューでは、行にコメントしたり、別のブランチと比較したりできます：

256 

257* **Comment**：特定の行にインラインコメントを残し、次のメッセージでそのコメントを Claude に送信します

258* **Compare**：差分ビューは、デフォルトでセッションの変更をそのベースブランチと比較します。リポジトリ内の他の任意のブランチと比較するには、**Compare against** を選択してブランチを 1 つ選びます

253 259 

254Claude Code はこれらの差分を raw git blob コンテンツから計算するため、リポジトリで設定された diff ドライバーと `textconv` フィルターは適用されません。260Claude Code はこれらの差分を raw git blob コンテンツから計算するため、リポジトリで設定された diff ドライバーと `textconv` フィルターは適用されません。

255 261 

313 319 

314### セッションをアーカイブ320### セッションをアーカイブ

315 321 

316セッションをアーカイブしてセッションリストを整理できます。アーカイブされたセッションはデフォルトのセッションリストから非表示になりますが、アーカイブされたセッションをフィルタリングして表示できます。322セッションをアーカイブすると、サイドバーのセッションリストから削除されます。セッションをアーカイブするには、サイドバーでセッションにマウスを合わせ、**⋯** メニューを開いて **Archive** を選択します。

317 323 

318セッションをアーカイブするには、サイドバーのセッションにマウスを合わせてアーカイブアイコンを選択します。324#### アーカイブされたセッションを見つける

325 

326アーカイブされたセッションを表示するには、[claude.ai/code/sessions](https://claude.ai/code/sessions) に移動して **Archived** タブを開きます。セッションをサイドバーのセッションリストに戻すには、そのタブでセッションにマウスを合わせ、**⋮** メニューを開いて **Unarchive** を選択します。

319 327 

320### セッションを削除328### セッションを削除

321 329 

322セッションを削除すると、セッションとそのデータが永続的に削除されます。このアクションは取り消せません。セッションは 2 つの方法で削除できます：330セッションを削除すると、セッションとそのデータが永続的に削除されます。このアクションは取り消せません。セッションは、サイドバー、セッションメニュー、またはすでにアーカイブしている場合は **Archived** タブから削除できます：

323 331 

324* **サイドバーから**：アーカイブされたセッションをフィルタリングし、削除するセッションにマウスを合わせて削除アイコンを選択します332* **サイドバーから**：セッションにマウスを合わせ、**⋯** メニューを開いて **Delete** を選択します

325* **セッションメニューから**：セッションを開き、セッションタイトルの横のドロップダウンを選択し、**Delete** を選択します333* **セッションメニューから**：セッションを開き、セッションタイトルの横のドロップダウンを選択し、**Delete** を選択します

334* **Archived タブから**：[**Archived** タブ](#find-an-archived-session)でセッションにマウスを合わせ、**⋮** メニューを開いて **Delete** を選択します

326 335 

327セッションが削除される前に確認するよう求められます。336セッションが削除される前に確認するよう求められます。

328 337 

336 345 

337PR がどこから来たか、どのデバイスを使用しているかに応じて、auto-fix をオンにするにはいくつかの方法があります：346PR がどこから来たか、どのデバイスを使用しているかに応じて、auto-fix をオンにするにはいくつかの方法があります：

338 347 

339* **クラウドセッションで作成された PR**：claude.ai/code でセッションを開き、CI ステータスバーを開き、**Auto-fix** を選択します348* **クラウドセッションで作成された PR**：claude.ai/code でセッションを開き、[**Changes** カード](#review-changes)でプルリクエストを見つけます。プルリクエストのタイトルの横にある **⋮** メニューを開き、**Auto-fix** をオンにします

340* **ターミナルから**：PR のブランチにいる間に [`/autofix-pr`](https://code.claude.com/docs/ja/commands) を実行します。Claude Code は `gh` で開いている PR を検出し、クラウドセッションをスポーンし、1 ステップで auto-fix をオンにします349* **ターミナルから**：PR のブランチにいる間に [`/autofix-pr`](https://code.claude.com/docs/ja/commands) を実行します。Claude Code は `gh` で開いている PR を検出し、クラウドセッションをスポーンし、1 ステップで auto-fix をオンにします

341* **モバイルアプリから**：Claude に PR を auto-fix するよう指示します。例えば「watch this PR and fix any CI failures or review comments」350* **モバイルアプリから**：Claude に PR を auto-fix するよう指示します。例えば「watch this PR and fix any CI failures or review comments」

342* **既存の PR**：PR URL をセッションに貼り付けて、Claude に auto-fix するよう指示します351* **既存の PR**：PR URL をセッションに貼り付けて、Claude に auto-fix するよう指示します

343 352 

344Auto-fix は PR ごとのトグルです。監視を停止するには、claude.ai/code のセッションで CI ステータスバーを開き、**Auto-fix** トグルをクリアするか、Claude に PR の監視を停止するよう指示します。353監視を停止するには、セッションの [**Changes** カード](#review-changes)にあるプルリクエストの **⋮** メニューで **Auto-fix** をオフにするか、Claude に PR の監視を停止するよう指示します。

345 354 

346### Claude が PR アクティビティにどのように応答するか355### Claude が PR アクティビティにどのように応答するか

347 356 

381* 1 分後に再試行してください。容量はオンデマンドでプロビジョニングされます390* 1 分後に再試行してください。容量はオンデマンドでプロビジョニングされます

382* [GitHub 接続後にリポジトリが表示されない](https://code.claude.com/docs/ja/web-quickstart.md#no-repositories-appear-after-connecting-github)に従って、GitHub 接続がリポジトリに到達できることを確認してください391* [GitHub 接続後にリポジトリが表示されない](https://code.claude.com/docs/ja/web-quickstart.md#no-repositories-appear-after-connecting-github)に従って、GitHub 接続がリポジトリに到達できることを確認してください

383 392 

393### Your new session couldn't start

394 

395プロンプトは、送信元の入力ボックスに戻されています。

396 

397* **Connection lost**: インターネット接続と、使用している VPN またはプロキシを確認してから、プロンプトを再度送信してください

398* **Server error**: しばらく待ってから、プロンプトを再度送信してください。この通知が再び表示される場合は、[status.claude.com](https://status.claude.com) を確認してください

399 

400### Can't rewind to this message

401 

402セッションが v2.1.246 より前の Claude Code を使用する[セルフホストランナー](https://code.claude.com/docs/ja/self-hosted-environments)で実行されている場合、最新のメッセージ以外のメッセージで **Rewind to here** を実行すると、このエラーで失敗します。組織のランナーを運用している担当者に[アップグレード](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#pin-the-version)を依頼してください。

403 

384### 組織 UUID を取得できない404### 組織 UUID を取得できない

385 405 

386`claude --cloud` と `claude --teleport` には claude.ai アカウントでのサインインが必要です。API キーで認証している場合、または保存されたアカウント詳細が古い場合、次のいずれかが表示されます。406`claude --cloud` と `claude --teleport` には claude.ai アカウントでのサインインが必要です。API キーで認証している場合、または保存されたアカウント詳細が古い場合、次のいずれかが表示されます。

111 111 

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

113 113 

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

115 115 

116自分で開始したクラウドセッションがプロジェクトに属する作業を行っている場合は、そのセッションのサイドバーメニューを開いて **Move to project** を選択し、サブメニューから選択します。116自分で開始したクラウドセッションがプロジェクトに属する作業を行っている場合は、そのセッションのサイドバーメニューを開いて **Move to project** を選択し、サブメニューから選択します。

117 117 

120 120 

121クラウドセッションのメッセージボックスの上に **Set up project** バナーが表示されることもあります。**Continue as new project** の代わりにこれを使用した場合も結果は同じですが、プロジェクトが開くとセッションの実行中のターンが停止します。121クラウドセッションのメッセージボックスの上に **Set up project** バナーが表示されることもあります。**Continue as new project** の代わりにこれを使用した場合も結果は同じですが、プロジェクトが開くとセッションの実行中のターンが停止します。

122 122 

123ローカルセッションにはこれらのオプションがありません。プロジェクトでその作業を続行するには、プロジェクト会話で作業を説明するか、ブランチをプッシュし、そのリポジトリをプロジェクトに追加して、タスクでブランチに名前を付けます。123自分のマシン上のセッションも、[Remote Control](https://code.claude.com/docs/ja/remote-control.md#start-a-remote-control-session) で接続すると、claude.ai/code で同じサイドバーメニューが使えるようになります。ただし、アカウントで [**Require trusted devices**](https://code.claude.com/docs/ja/remote-control.md#trusted-devices) がオンになっている間に接続したセッションのトランスクリプトは、プロジェクトから Claude が読み取ることはできません。この設定がオフの場合は、次の手順に従います。

124 

1251. セッションがまだ接続されていない場合は、そのセッションで `/remote-control` を実行します。この設定がオンの間に接続した場合は、まず切断してから再接続してください。

1262. ブラウザで [claude.ai/code](https://claude.ai/code) のサイドバーにあるセッションの行を見つけ、そのメニューを開いて、同じサブメニューから選択します。

127 

128**Require trusted devices** がオンの場合、または Remote Control を使用していない場合は、プロジェクトの会話で自分で作業を説明してください。または、セッションのブランチをプッシュし、そのリポジトリをプロジェクトに追加して、Claude にブランチ名を伝えます。

124 129 

125### GitHub アクセスをセットアップする130### GitHub アクセスをセットアップする

126 131 

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

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

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

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

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

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

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

437 442 

438* プロジェクトは claude.ai/code、デスクトップアプリ、Claude モバイルアプリで利用可能です。ターミナル CLI、VS Code 拡張機能、JetBrains プラグイン、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。443* プロジェクトは claude.ai/code、デスクトップアプリ、Claude モバイルアプリで利用可能です。ターミナル CLI、VS Code 拡張機能、JetBrains プラグイン、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。

439* プロジェクトスレッドは [クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md) です。または [Remote Control](https://code.claude.com/docs/ja/remote-control.md) を通じてお客様のマシン上のセッションです。どちらの場合も Anthropic がモデルプロバイダーです。[セキュリティ](https://code.claude.com/docs/ja/security.md) および [データ使用](https://code.claude.com/docs/ja/data-usage.md) はクラウドセッションがどのように分離され、何が保持されるかをカバーしています。また [接続とセキュリティ](https://code.claude.com/docs/ja/remote-control.md#connection-and-security) はお客様のマシン上のスレッドがどのように接続され、何が保存されるかをカバーしています。444* プロジェクトスレッドは [クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md) です。または [Remote Control](https://code.claude.com/docs/ja/remote-control.md) を通じてお客様のマシン上のセッションです。どちらの場合も Anthropic がモデルプロバイダーです。[セキュリティ](https://code.claude.com/docs/ja/security.md) および [データ使用](https://code.claude.com/docs/ja/data-usage.md) はクラウドセッションがどのように分離され、何が保持されるかをカバーしています。また [接続とセキュリティ](https://code.claude.com/docs/ja/remote-control.md#connection-and-security) はお客様のマシン上のスレッドがどのように接続され、何が保存されるかをカバーしています。

440* お客様のマシン上で自分で開始したセッションをプロジェクトに追加することはできません。プロジェクトがお客様のマシン上でスレッドを実行するには、[Remote Control を通じてお客様のマシン上でスレッドを実行](#run-a-thread-on-your-own-computer) し、そのセクションに必要なものが記載されています。445* 自分のマシン上で自分で開始したセッションをプロジェクトに追加することはできませんが、[その作業をプロジェクトに持ち込む](#start-from-an-existing-cloud-session) ことはできます。プロジェクトを自分のマシン上で使用するには、[Remote Control を通じてそこでスレッドを実行](#run-a-thread-on-your-own-computer) します。必要なものはそのセクションに記載されています。

441* クラウドスレッドのサンドボックスはターン間で一時停止し、スレッドが続くときに再開されます。サンドボックスを再開できない場合、スレッドは新しいクローンから続きます。コミットされていない変更は失われる可能性があります。長いタスクでは、Claude にコミットしてプログレス作業をプッシュするよう求めてください。446* クラウドスレッドのサンドボックスはターン間で一時停止し、スレッドが続くときに再開されます。サンドボックスを再開できない場合、スレッドは新しいクローンから続きます。コミットされていない変更は失われる可能性があります。長いタスクでは、Claude にコミットしてプログレス作業をプッシュするよう求めてください。

442* プロジェクトは 1 人のユーザーに属します。プロジェクトまたはそのスレッドを別のユーザーと共有することはできず、スレッドトランスクリプトは他のクラウドセッションが持つ共有オプションを持ちません。ベータ中、プロジェクトの組織レベルコントロールはありません。447* プロジェクトは 1 人のユーザーに属します。プロジェクトまたはそのスレッドを別のユーザーと共有することはできず、スレッドトランスクリプトは他のクラウドセッションが持つ共有オプションを持ちません。ベータ中、プロジェクトの組織レベルコントロールはありません。

443* スレッドはそれを開始した 1 つのプロジェクトに属します。スレッドを別のプロジェクトに移動またはコピーすることはできず、それを単独で移動することはできません。[**プロジェクトに移動**](#start-from-an-existing-cloud-session) は別の方向のみです。クラウドセッションの作業をプロジェクトに持ち込みます。2 つのプロジェクトを 1 つにマージすることはできません。448* スレッドはそれを開始した 1 つのプロジェクトに属します。スレッドを別のプロジェクトに移動またはコピーすることはできず、それを単独で移動することはできません。[**プロジェクトに移動**](#start-from-an-existing-cloud-session) は別の方向のみです。クラウドセッションの作業をプロジェクトに持ち込みます。2 つのプロジェクトを 1 つにマージすることはできません。

67 67 

68* **結果**：該当する行へのインラインコメントと、レビュー本文の概要68* **結果**：該当する行へのインラインコメントと、レビュー本文の概要

69* **チェック実行**：**Claude Code Review** という名前で、結果はその[詳細](https://code.claude.com/docs/ja/code-review-pull-requests.md#check-run-output)に一覧表示されます。チェック実行が失敗として完了することはありません。69* **チェック実行**：**Claude Code Review** という名前で、結果はその[詳細](https://code.claude.com/docs/ja/code-review-pull-requests.md#check-run-output)に一覧表示されます。チェック実行が失敗として完了することはありません。

70* **何も見つからなかった場合**：チェック実行のタイトルは **Code review found no issues** となり、Claude は同じ短いメモをプルリクエストに投稿します70* **結果の代わりのメモ**：チェック実行のタイトルが **Code review found no issues** となる場合に投稿されます

71 71 

72Code Review はレビューを実行する Claude モデルを選択し、その管理設定にモデルの選択肢はありません。レビューの徹底度を上げたり下げたりするには、[レビューレベル](#review-levels)を変更します。72Code Review はレビューを実行する Claude モデルを選択し、その管理設定にモデルの選択肢はありません。レビューの徹底度を上げたり下げたりするには、[レビューレベル](#review-levels)を変更します。

73 73 

152 152 

153### 以降のレビューの対象範囲153### 以降のレビューの対象範囲

154 154 

155プッシュ後など、自動的に開始される以降のレビューは、前回のレビュー以降に変更された部分に焦点を当て、Nit や既存の問題の指摘を少なく投稿します。そのサマリーには、除外した件数が "found and not posted" または "outside the scope of this re-review and not posted." で終わる行に記載されます。155プッシュ後など、自動的に開始される以降のレビューは、前回のレビュー以降に変更された部分に焦点を当て、[Nit や既存の問題の指摘](#severity-levels)を少なく投稿します。その結果として指摘が除外されたかどうかを確認するには、レビュー本文でその件数を示す文を探してください。

156 

157* **前回のレビュー以降に変更されていないコードに対する指摘**: 文の末尾が "outside the scope of this re-review and not posted" となります

158* **Nit と既存の問題の指摘**: 文の末尾が "found and not posted" となります

156 159 

157これらを何も除外しないレビューを受けるには、[`@claude review`](#comment-commands) をコメントしてください。プルリクエスト全体が改めてレビューされます。160これらを何も除外しないレビューを受けるには、[`@claude review`](#comment-commands) をコメントしてください。プルリクエスト全体が改めてレビューされます。

158 161 

15| チェック実行のタイトル | 意味 | 対処方法 |15| チェック実行のタイトル | 意味 | 対処方法 |

16| :- | :- | :- |16| :- | :- | :- |

17| **Code review queued...** または **Code review in progress...** | レビューがまだ完了していません | タイトルが変わるまで待ちます |17| **Code review queued...** または **Code review in progress...** | レビューがまだ完了していません | タイトルが変わるまで待ちます |

18| **Code review found no issues** | レビューが完了し、指摘すべき点は見つかりませんでした | 対処は不要です |18| **Code review found no issues** | レビューが完了し、指摘事項は投稿されませんでした | プルリクエストの最初のレビューでない場合は、レビュー本文で[レビューが除外した指摘事項](https://code.claude.com/docs/ja/code-review-pull-requests.md#what-a-later-review-covers)の件数を確認してください。それ以外の場合は、対処は不要です |

19| 問題が見つかったことを示すタイトル | レビューが完了し、指摘事項があります | 差分上に表示されない場合は、[インラインコメントとして表示されない問題を見つける](#find-issues-that-aren’t-showing-as-inline-comments)を参照してください |19| 問題が見つかったことを示すタイトル | レビューが完了し、指摘事項があります | 差分上に表示されない場合は、[インラインコメントとして表示されない問題を見つける](#find-issues-that-aren’t-showing-as-inline-comments)を参照してください |

20| **Code review skipped — no new changes** | 最新のプッシュに対して自動レビューが実行されませんでした | それでもレビューを受けたい場合は、`@claude review` とコメントします |20| **Code review skipped — no new changes** | 最新のプッシュに対して自動レビューが実行されませんでした | それでもレビューを受けたい場合は、`@claude review` とコメントします |

21| **Code review not repeated — earlier findings still open** | 最新のプッシュに対して自動レビューが実行されず、以前のレビューの Important の指摘事項がまだ未解決です | 修正をプッシュするか、それでもレビューを受けたい場合は `@claude review` とコメントします。[プッシュ後も以前の結果が維持される場合](https://code.claude.com/docs/ja/code-review-pull-requests.md#when-a-push-keeps-the-earlier-result)を参照してください |21| **Code review not repeated — earlier findings still open** | 最新のプッシュに対して自動レビューが実行されず、以前のレビューの Important の指摘事項がまだ未解決です | 修正をプッシュするか、それでもレビューを受けたい場合は `@claude review` とコメントします。[プッシュ後も以前の結果が維持される場合](https://code.claude.com/docs/ja/code-review-pull-requests.md#when-a-push-keeps-the-earlier-result)を参照してください |

223 223 

224#### セッション詳細パネルを表示または非表示にする224#### セッション詳細パネルを表示または非表示にする

225 225 

226パネルを表示または非表示にするには、セッションのタイトルバー、またはウィンドウの幅が狭い場合はバーの\*\*⋮**メニューで、**Hide session rail**または**Show session rail\*\*をクリックします。それでもパネルが表示されない場合は、[使用している Code タブのレイアウトを確認してください](#check-which-layout-you-have)。226パネルを表示または非表示にするには、セッションのタイトルバー、またはバーの\*\*⋮**メニューで、**Hide session rail**または**Show session rail\*\*をクリックします。それでもパネルが表示されない場合は、[使用している Code タブのレイアウトを確認してください](#check-which-layout-you-have)。

227 227 

228### ターミナルでコマンドを実行する228### ターミナルでコマンドを実行する

229 229 

984 984 

985* **システム**：x86\_64 または arm64 プロセッサ。マシンは Claude Code の[システム要件](https://code.claude.com/docs/ja/setup.md#system-requirements)も満たす必要があります。Linux では、Claude Code には glibc 2.17 以降、または musl が必要です。マシンがどちらを使用しているかを確認するには、そのマシンで `ldd --version` を実行します。Alpine Linux などの musl ベースのディストリビューションでは、[Claude Code が必要とするパッケージ](https://code.claude.com/docs/ja/setup.md#alpine-linux-and-musl-based-distributions)もインストールしてください。985* **システム**：x86\_64 または arm64 プロセッサ。マシンは Claude Code の[システム要件](https://code.claude.com/docs/ja/setup.md#system-requirements)も満たす必要があります。Linux では、Claude Code には glibc 2.17 以降、または musl が必要です。マシンがどちらを使用しているかを確認するには、そのマシンで `ldd --version` を実行します。Alpine Linux などの musl ベースのディストリビューションでは、[Claude Code が必要とするパッケージ](https://code.claude.com/docs/ja/setup.md#alpine-linux-and-musl-based-distributions)もインストールしてください。

986* **SFTP**：SSH サーバーが SFTP サブシステムを提供している必要があります。これは `sshd_config` の `Subsystem sftp` 行で有効になります。確認するには、コンピューターのターミナルで `sftp` を使用して同じホストとポートに接続します。正常に動作しているサーバーでは `sftp>` プロンプトが表示されます。986* **SFTP**：SSH サーバーが SFTP サブシステムを提供している必要があります。これは `sshd_config` の `Subsystem sftp` 行で有効になります。確認するには、コンピューターのターミナルで `sftp` を使用して同じホストとポートに接続します。正常に動作しているサーバーでは `sftp>` プロンプトが表示されます。

987* **接続あたりのセッション数**：macOS と Linux の Desktop は、1 つの SSH 接続で複数のセッションを開きます。サーバーの `sshd_config` で `MaxSessions 1` が設定されている場合は、OpenSSH のデフォルトである 10 などに引き上げてください。987* **サーバーでの `MaxSessions 1`**: `sshd_config` で `MaxSessions 1` が設定されているサーバーに接続するには、次のいずれかを行います。

988 * **コンピューターが macOS または Linux の場合**: Claude Desktop v3.1623.0 以降に更新します

989 * **コンピューターが Windows の場合**: Desktop の組み込み SSH クライアントはそのサーバーに接続できないため、Desktop が [OpenSSH クライアント経由で接続する](#use-your-ssh-configuration)ようにします

990 * **サーバーを変更できる場合**: `MaxSessions` を、たとえば OpenSSH のデフォルトである 10 に引き上げます

991* **`MaxSessions 1` でのログイン**: SSH エージェントが保持する鍵など、プロンプトなしで機能するログインを使用してください。Desktop は接続または再接続のたびに少なくとも 2 回ログインします。さらに、[ターミナル](#run-commands-in-the-terminal)タブごと、および `!` で始まるコマンドを実行する Desktop セッションごとに、少なくとも 1 回のログインが追加で発生します。Claude が実行するコマンドではログインは発生しません。

992* **`MaxSessions 1` でのワンタイムコード**: ワンタイムコードのようにログインのたびにプロンプトが表示される場合、`!` コマンドは失敗します。代わりに、それらのコマンドはターミナルタブで実行してください。ターミナルタブでは、独自のペインでプロンプトが表示されます。

988* **インストールフォルダ**：Desktop は、ホームディレクトリの `~/.claude/remote/` の下にヘルパープログラムと Claude Code をインストールします。そこからそれらを実行するため、そのフォルダを `noexec` でマウントされたファイルシステム上に置くことはできません。接続する各ユーザーのホームディレクトリに約 1 GB のディスク容量を確保してください。そのフォルダに含まれる内容については、[リモートマシン上のファイルとプロセス](#files-and-processes-on-the-remote-machine)を参照してください。993* **インストールフォルダ**：Desktop は、ホームディレクトリの `~/.claude/remote/` の下にヘルパープログラムと Claude Code をインストールします。そこからそれらを実行するため、そのフォルダを `noexec` でマウントされたファイルシステム上に置くことはできません。接続する各ユーザーのホームディレクトリに約 1 GB のディスク容量を確保してください。そのフォルダに含まれる内容については、[リモートマシン上のファイルとプロセス](#files-and-processes-on-the-remote-machine)を参照してください。

989* **シェル**：リモートマシン上のアカウントに設定されているシェルは、Bash、Zsh、`sh` と同様に、SSH 経由で送信されたコマンドを実行できる必要があります994* **シェル**：リモートマシン上のアカウントに設定されているシェルは、Bash、Zsh、`sh` と同様に、SSH 経由で送信されたコマンドを実行できる必要があります

990* **ネットワーク**：Claude Code はリモートマシンで実行され、そこからネットワークリクエストを行うため、マシンには [Claude Code が必要とするネットワークアクセス](https://code.claude.com/docs/ja/network-config.md#network-access-requirements)が必要です。マシンが Claude Code をダウンロードできない場合、Desktop はコンピューター上でダウンロードしてアップロードします。Claude Code のその他のリクエストは引き続きリモートマシンから送信されます。Linux のリモートマシンで、それらのリクエストにプロキシが必要な場合は、[SSH セッション用に設定してください](#set-a-proxy-or-a-ca-certificate-for-ssh-sessions)。995* **ネットワーク**：Claude Code はリモートマシンで実行され、そこからネットワークリクエストを行うため、マシンには [Claude Code が必要とするネットワークアクセス](https://code.claude.com/docs/ja/network-config.md#network-access-requirements)が必要です。マシンが Claude Code をダウンロードできない場合、Desktop はコンピューター上でダウンロードしてアップロードします。Claude Code のその他のリクエストは引き続きリモートマシンから送信されます。Linux のリモートマシンで、それらのリクエストにプロキシが必要な場合は、[SSH セッション用に設定してください](#set-a-proxy-or-a-ca-certificate-for-ssh-sessions)。

993 998 

994Linux のリモートマシンがプロキシ経由でインターネットに接続する場合、または CA 証明書が必要な場合は、そのマシン上の `~/.claude/settings.json` の `env` に[プロキシと CA の変数](https://code.claude.com/docs/ja/network-config.md)を追加してください。そのマシンの `~/.profile`、`~/.bash_profile`、`~/.zprofile`、または `~/.zshrc` ですでにエクスポートしている場合でも追加してください。999Linux のリモートマシンがプロキシ経由でインターネットに接続する場合、または CA 証明書が必要な場合は、そのマシン上の `~/.claude/settings.json` の `env` に[プロキシと CA の変数](https://code.claude.com/docs/ja/network-config.md)を追加してください。そのマシンの `~/.profile`、`~/.bash_profile`、`~/.zprofile`、または `~/.zshrc` ですでにエクスポートしている場合でも追加してください。

995 1000 

996そのマシンのターミナルで実行した `claude` がそれらのファイルから変数を取得する場合でも、SSH セッションはそれらのファイルから変数を取得しません。その結果、セッションが応答しなくなったり、**The connection from … to the API failed** や **Authentication failed** が表示されたりすることがあり、再度サインインしても解決しません。1001SSH セッションでは、そのマシンのターミナルで実行した `claude` にはそれらのファイルの変数が渡される場合でも、Claude Code には渡されません。その結果、セッションがハングしたり、**The connection from … to the API failed** や **Authentication failed** が表示されたりすることがあり、再度サインインしても解決しません。

997 1002 

998**1. 変数を追加する**1003**1. 変数を追加する**

999 1004 

1028 1033 

1029リモートマシンを再起動するか、[ヘルパーを削除する](#files-and-processes-on-the-remote-machine)手順の最初の 2 つのステップと同様に、Desktop を終了してヘルパーのプロセスを終了します。どちらの方法でも Claude の作業が中断されるため、タスクが実行されていないときに行ってください。1034リモートマシンを再起動するか、[ヘルパーを削除する](#files-and-processes-on-the-remote-machine)手順の最初の 2 つのステップと同様に、Desktop を終了してヘルパーのプロセスを終了します。どちらの方法でも Claude の作業が中断されるため、タスクが実行されていないときに行ってください。

1030 1035 

1031#### macOS と Linux で SSH 設定を使用する1036#### SSH 設定を使用する

1032 1037 

1033macOS と Linux では、Desktop はコンピューター上の OpenSSH クライアントを実行して接続するため、`~/.ssh/config` が使用されます。OpenSSH クライアントを介した接続には Claude Desktop v1.37937.0 以降が必要です。そのファイルの `Host` 名を **SSH host** フィールドに入力すると、`HostName`、`User`、`IdentityFile`、`CertificateFile`、`ProxyJump`、`ProxyCommand` など、そのエントリの設定が使用されます。1038Desktop が自分のコンピューター上の OpenSSH クライアント経由で接続する場合、macOS、Linux、Windows で SSH 設定を使用できます。

1039 

1040* **macOS と Linux**: Desktop は自分のコンピューター上で OpenSSH クライアントを実行して接続するため、`~/.ssh/config` を使用します。OpenSSH クライアント経由で接続するには、Claude Desktop v1.37937.0 以降が必要です。

1041* **Windows**: Desktop が OpenSSH クライアント経由で接続する場合、`%USERPROFILE%\.ssh\config` を使用します。サードパーティプロバイダーではなく Claude アカウントを使用している場合、OpenSSH クライアント経由で接続するには、次のすべてが必要です。

1042 

1043 * Claude Desktop v2.2553.0 以降。バージョンを確認するには、[バージョンを確認する](#check-your-version)を参照してください。

1044 * Microsoft の OpenSSH 9.4 以降

1045 * このページ上部のダウンロードボタンでインストールした Desktop。Microsoft Store 版の Desktop は OpenSSH クライアント経由で接続しないためです

1046 

1047 これらの要件を満たせない場合、またはサードパーティプロバイダーを使用している場合は、[OpenSSH クライアントを使用せずに Windows で接続する](#connect-on-windows-without-the-openssh-client)を参照してください。

1048 

1049OpenSSH クライアントを使用する場合は、**SSH host** フィールドに設定ファイルの `Host` 名を入力します。Desktop は、その `Host` エントリの `HostName`、`User`、`IdentityFile`、`CertificateFile`、`ProxyJump`、`ProxyCommand` などの設定を使用します。

1034 1050 

1035接続を追加する前に、コンピューターのターミナルでクライアントとエントリを確認してください：1051接続を追加する前に、コンピューターのターミナルでクライアントとエントリを確認してください：

1036 1052 

1037* **クライアントのバージョン**：`ssh -V` を実行します。クライアントは OpenSSH 7.6 以降である必要があります。1053* **macOS と Linux でのクライアントのバージョン**: `ssh -V` を実行します。クライアントは OpenSSH 7.6 以降である必要があります。

1038* **エントリ**：`ssh devbox` のように、`Host` 名を指定して `ssh` を実行します。失敗する場合は、先にエントリを修正してください。1054* **Windows でのクライアントのバージョン**: Desktop は最初に `PATH` 上の `ssh` を試すため、`ssh -V` を実行します。出力に `OpenSSH_for_Windows_` と 9.4 以降が表示されれば、そのクライアントは要件を満たしています。満たしていない場合は、Desktop が次に試す 2 つのフォルダーを確認します。`C:\Windows\System32\OpenSSH` で `.\ssh.exe -V` を実行し、次に `C:\Program Files\OpenSSH` で実行します。

1055* **Windows で要件を満たすクライアントがない場合**: Windows で **OpenSSH Client** オプション機能を追加して保留中の Windows 更新プログラムをインストールするか、[Microsoft の新しいビルド](https://learn.microsoft.com/en-us/troubleshoot/windows-server/system-management-components/upgrade-in-box-openssh-to-latest-openssh-release)をインストールします。その後、Desktop を終了して再度開きます。Desktop が使用可能な OpenSSH クライアントを見つけたかどうかを確認するには、[`ssh.log`](#get-desktops-logs-for-an-ssh-problem) で `Windows OpenSSH client:` とバージョン、または `no usable Windows OpenSSH client` を探します。

1056* **エントリ**: Windows では、バージョンチェックで要件を満たしたクライアントを使用します。`ssh devbox` のように、`Host` 名を指定して `ssh` を実行します。失敗する場合は、先にエントリを修正してください。

1039 1057 

1040**SSH port** と **SSH key (optional)** フィールドは空のままにできます。いずれかを入力した場合、Desktop はそれをエントリと組み合わせて使用します：1058**SSH port** と **SSH key (optional)** フィールドは空のままにできます。いずれかを入力した場合、Desktop はそれをエントリと組み合わせて使用します：

1041 1059 

1042* **SSH port**：ここに入力した値は、エントリの `Port` を上書きします1060* **SSH port**：ここに入力した値は、エントリの `Port` を上書きします

1043* **SSH key (optional)**：Desktop は、エントリの `IdentityFile` と SSH エージェント内の鍵に加えて、選択した鍵ファイルを提示します1061* **SSH key (optional)**: OpenSSH クライアントでは、Desktop はエントリの `IdentityFile` と SSH エージェント内の鍵に加えて、ここで選択した鍵ファイルを提示します。Windows では、`ssh` は PuTTY の `.ppk` ファイルを読み込まないため、OpenSSH 形式の鍵を選択してください。

1062 

1063##### OpenSSH クライアントを使用せずに Windows で接続する

1064 

1065Windows では、コンピューターが [OpenSSH クライアントの要件](#use-your-ssh-configuration)を満たしていない場合、Desktop の組み込み SSH クライアント経由で接続します。サードパーティプロバイダーでは、デフォルトで組み込みクライアント経由で接続しますが、管理者がこれを変更できます。この設定については、[SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions) を参照してください。

1066 

1067組み込みクライアントでも、`PATH` に `ssh` コマンドがあれば、**SSH host** フィールドに SSH 設定の `Host` 名を入力できます。ただし、次の制限があります。

1068 

1069* **エントリからの設定**: Desktop は `HostName`、`User`、`Port`、`IdentityFile` を使用します。`PATH` に `sh` シェルがある場合は `ProxyCommand` も使用します。

1070* **SSH key (optional)**: ここで選択した鍵ファイルは `IdentityFile` を置き換えるため、エントリの `IdentityFile` を使い続けるにはこのフィールドを空欄のままにします

1071* **`CertificateFile` と `ProxyJump`**: Desktop は `CertificateFile` を無視し、エントリで `ProxyJump` が設定されていると接続は失敗します。いずれかの設定を使用するには、[OpenSSH クライアント経由で接続してください](#use-your-ssh-configuration)。

1044 1072 

1045##### ジャンプホストの背後にあるマシンに接続する1073##### ジャンプホストの背後にあるマシンに接続する

1046 1074 

1095 1123 

1096##### `ProxyCommand` でシェルの変数を使用する1124##### `ProxyCommand` でシェルの変数を使用する

1097 1125 

1098`ProxyCommand` または `Match exec` コマンドで独自の環境変数を使用するには、`~/.zshrc` などのシェル起動ファイルでその変数をエクスポートしてから、Desktop を終了して再度開きます。Desktop は起動時にログインシェルがエクスポートする内容を読み取り、終了するまでその値を保持します。1126macOS と Linux で、`ProxyCommand` または `Match exec` コマンドで独自の環境変数を使用するには、`~/.zshrc` などのシェル起動ファイルでエクスポートします。その後、Desktop を終了して再度開きます。Desktop は起動時にログインシェルがエクスポートする内容を読み込み、終了するまでその値を保持します。

1099 1127 

1100これには Claude Desktop v2.37337.0 以降と、`-0` を受け付ける `env` コマンドが必要です。これはコンピューターのターミナルで `env -0` を実行して確認できます。1128これには Claude Desktop v2.37337.0 以降と、`-0` を受け付ける `env` コマンドが必要です。これはコンピューターのターミナルで `env -0` を実行して確認できます。

1101 1129 

1103>1131>

1104> シェルが一時的な AWS 認証情報を設定する場合は、`AWS_*` 変数をエクスポートする代わりに、[AWS CLI にプロファイルを指定してください](#use-aws-credentials-in-a-proxycommand)。1132> シェルが一時的な AWS 認証情報を設定する場合は、`AWS_*` 変数をエクスポートする代わりに、[AWS CLI にプロファイルを指定してください](#use-aws-credentials-in-a-proxycommand)。

1105 1133 

1106##### `ProxyCommand` で AWS 認証情報を使用する1134##### macOS と Linux で `ProxyCommand` に AWS 認証情報を使用する

1107 1135 

1108シェル起動ファイルで一時的な AWS 認証情報を設定している場合、AWS CLI を実行する `ProxyCommand` は、ターミナルでは接続できても Desktop では失敗することがあります。シェルが `AWS_SESSION_TOKEN`、`AWS_SECURITY_TOKEN`、または `AWS_CREDENTIAL_EXPIRATION` をエクスポートしていると、Desktop の `ssh` と `ProxyCommand` は、シェルの AWS 認証情報、`AWS_REGION`、`AWS_PROFILE` を取得しません。1136シェル起動ファイルで一時的な AWS 認証情報を設定している場合、AWS CLI を実行する `ProxyCommand` は、ターミナルでは接続できても Desktop では失敗することがあります。シェルが `AWS_SESSION_TOKEN`、`AWS_SECURITY_TOKEN`、または `AWS_CREDENTIAL_EXPIRATION` をエクスポートしていると、Desktop の `ssh` と `ProxyCommand` は、シェルの AWS 認証情報、`AWS_REGION`、`AWS_PROFILE` を取得しません。

1109 1137 

1242 1270 

1243##### 長いタスクを準備する1271##### 長いタスクを準備する

1244 1272 

1245* **先に更新する**：長いタスクを開始する前に Desktop を更新してください。macOS と Windows では、Desktop はダウンロード済みのアップデートをインストールするために自動的に再起動することがあります。この再起動は、Claude が SSH タスクに取り組んでいる間は待機します。macOS で Claude アカウントを使用している場合、デフォルトでは、アップデートが 72 時間待機した後は、それでも再起動が実行されることがあります。1273* **先に更新する**: 長時間のタスクを開始する前に Desktop を更新してください。macOS と Windows では、Desktop はダウンロード済みの更新をインストールするために自動的に再起動することがあります。この再起動は、Claude が SSH タスクで作業している間は待機します。デフォルトでは、更新が 72 時間待機した後、Desktop が[その後タスクに再接続できる](#reopen-a-session-after-you-quit-desktop)場合は、タスク中でも再起動が実行されることがあります。

1246* **Windows の場合、またはサードパーティプロバイダーで v2.42304.0 より前の場合は終了しない**: その場合は終了すると実行中のタスクが失われるため、タスクの間は Desktop を開いたままにしてください。それ以外の場合は、終了する前に[何が戻るか](#reopen-a-session-after-you-quit-desktop)を確認してください。1274* **終了する前に確認する**: 終了や再起動の後、たとえば一部の Desktop の更新後などには、実行中のタスクに必ず戻れるとは限りません。該当するケースについては、[Desktop を終了した後にセッションを再度開く](#reopen-a-session-after-you-quit-desktop)を参照してください。

1275* **古いバージョンでは Desktop を開いたままにする**: Windows で v3.1623.0 より前の Claude Desktop を使用している場合、Desktop が終了または再起動すると、実行中のタスクに戻れません。macOS または Linux で v2.42304.0 より前のサードパーティプロバイダーを使用している場合も同様です。どちらの場合も、タスクの実行中は Desktop を開いたままにしてください。バージョンを確認するには、[バージョンを確認する](#check-your-version)を参照してください。

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

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

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

1320 1349 

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

1322 1351 

1323* **Windows の Desktop**: Desktop は終了後に再参加することがないため、実行中のタスクは戻りません。Desktop の起動時にセッションが開くことがあるため、タスクが完了していると見込まれるときにのみ Desktop を再度起動してください。1352* **Windows の Desktop で、v3.1623.0 より前のバージョンで開始したタスク**: その後 Desktop が更新されていても、タスクには戻れません。Desktop の起動時にセッションが開くことがあり、セッションが開くとタスクは停止するため、タスクが完了していると予想される時点になってから Desktop を再度起動してください。どのバージョンでタスクを開始したかわからない場合も、タスクが完了していると予想される時点まで待ってください。

1324* **サードパーティプロバイダー、以前のバージョンのタスク**: v2.42304.0 より前の Desktop バージョンでタスクを開始した場合、macOS や Linux でもタスクは戻りません。タスクが完了していると見込まれるときにのみ Desktop を再度起動してください。1353* **macOS または Linux のサードパーティプロバイダーで、v2.42304.0 より前のバージョンで開始したタスク**: タスクには戻れません。タスクが完了していると予想される時点になってから Desktop を再度起動してください。

1325* **その他のタスク（macOS または Linux の Desktop）**: Desktop を起動してセッションを開くと、Desktop が再参加した場合はタスクが続行されます。一部の Desktop アップデートの後など、常に再参加できるとは限らないため、[長時間のタスクの前に更新してください](#prepare-a-long-task)。1354* **その他のタスク**: Desktop を起動してセッションを開くと、Desktop が再接続できればタスクは続行されます。一部の Desktop の更新後など、常に再接続できるとは限らないため、[長時間のタスクの前に更新してください](#prepare-a-long-task)。

1326 1355 

1327Desktop が再参加できない場合、待機していた承認や質問も失われます。タスクが自動的に続行されない場合はメッセージを送信すると、Claude は会話の保存された履歴から続行します。1356タスクが停止すると、Desktop が新しいプロセスを開始する間、セッションに `Restarting Claude Code on <host>…` が表示されることがあります。また、待機していた承認や質問も失われます。Claude が自動的に続行しない場合はメッセージを送信してください。Claude は会話の保存済み履歴から続行します。

1328 1357 

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

1330 1359 

1411 1440 

1412リモートマシンに誰が接続したかを確認するには、そのマシン上の SSH サーバーのログを読みます。ログでは、Desktop からのログインはターミナルからのログインと同じように表示されます。macOS または Linux の Desktop では、エントリはセッションごとではなく、Desktop が接続するたびに記録されます。1441リモートマシンに誰が接続したかを確認するには、そのマシン上の SSH サーバーのログを読みます。ログでは、Desktop からのログインはターミナルからのログインと同じように表示されます。macOS または Linux の Desktop では、エントリはセッションごとではなく、Desktop が接続するたびに記録されます。

1413 1442 

1443サーバーが `MaxSessions 1` を設定している場合、Desktop が接続または再接続するたびに少なくとも 2 つのエントリが記録されます。さらに、ターミナルタブごと、および `!` で始まるコマンドを実行する Desktop セッションごとに、少なくとも 1 つずつ追加されます。

1444 

1414Desktop の SSH 接続は、Claude Code の[メトリクスとイベント](https://code.claude.com/docs/ja/monitoring-usage.md#available-metrics-and-events)には含まれません。そこから SSH セッションがどのリモートマシンで実行されたかを確認するには、[Desktop SSH セッションにテレメトリを関連付ける](https://code.claude.com/docs/ja/monitoring-usage.md#attribute-telemetry-to-desktop-ssh-sessions)を参照してください。Desktop 自体の接続記録については、[SSH の問題について Desktop のログを取得する](#get-desktops-logs-for-an-ssh-problem)を参照してください。1445Desktop の SSH 接続は、Claude Code の[メトリクスとイベント](https://code.claude.com/docs/ja/monitoring-usage.md#available-metrics-and-events)には含まれません。そこから SSH セッションがどのリモートマシンで実行されたかを確認するには、[Desktop SSH セッションにテレメトリを関連付ける](https://code.claude.com/docs/ja/monitoring-usage.md#attribute-telemetry-to-desktop-ssh-sessions)を参照してください。Desktop 自体の接続記録については、[SSH の問題について Desktop のログを取得する](#get-desktops-logs-for-an-ssh-problem)を参照してください。

1415 1446 

1416#### ログイン前に閉じる接続1447#### ログイン前に閉じる接続

2112| - | - | - |2143| - | - | - |

2113| `<host>'s SSH server has SFTP turned off` | `[SFTP_UNAVAILABLE]` | [リモートマシンの要件](#remote-machine-requirements-for-ssh-sessions)で説明されているとおり、サーバーの `sshd_config` で SFTP をオンにします |2144| `<host>'s SSH server has SFTP turned off` | `[SFTP_UNAVAILABLE]` | [リモートマシンの要件](#remote-machine-requirements-for-ssh-sessions)で説明されているとおり、サーバーの `sshd_config` で SFTP をオンにします |

2114| `SFTP doesn't start on <host>` | `[SFTP_NOT_STARTED]` | コンピューターのターミナルで `sftp` を使用して同じホストに接続し、何が起動を妨げているかを確認してから、Desktop のメッセージに示されている設定とファイルを確認します |2145| `SFTP doesn't start on <host>` | `[SFTP_NOT_STARTED]` | コンピューターのターミナルで `sftp` を使用して同じホストに接続し、何が起動を妨げているかを確認してから、Desktop のメッセージに示されている設定とファイルを確認します |

2115| `<host> allows too few SSH sessions per connection` | `[SESSION_LIMIT]` | サーバーの `sshd_config` で `MaxSessions` を引き上げます（例：OpenSSH のデフォルトである 10） |2146| `<host> allows too few SSH sessions per connection` | `[SESSION_LIMIT]` | Claude Desktop v3.1623.0 以降に更新するか、サーバーの `sshd_config` で `MaxSessions` を引き上げます（例：OpenSSH のデフォルトである 10） |

2116| `<host> is out of disk space` | `[ENOSPC]` または `[EDQUOT]` | リモートマシンのホームディレクトリまたは `/tmp` で空き容量またはクォータを確保します |2147| `<host> is out of disk space` | `[ENOSPC]` または `[EDQUOT]` | リモートマシンのホームディレクトリまたは `/tmp` で空き容量またはクォータを確保します |

2117| `Free up disk space on this computer` | `[ENOSPC]` または `[EDQUOT]`（`Couldn't prepare the deploy locally` で始まるメッセージ内） | コンピューターの空き容量を確保します |2148| `Free up disk space on this computer` | `[ENOSPC]` または `[EDQUOT]`（`Couldn't prepare the deploy locally` で始まるメッセージ内） | コンピューターの空き容量を確保します |

2118| `Claude Code won't start on <host>` | `[CLI_UNRESPONSIVE]` | 1 分待ってから、もう一度試してください。失敗が続く場合は、メッセージに示されているコマンドをリモートマシンで実行し、そこで Claude Code が応答するかどうかを確認します。 |2149| `Claude Code won't start on <host>` | `[CLI_UNRESPONSIVE]` | 1 分待ってから、もう一度試してください。失敗が続く場合は、メッセージに示されているコマンドをリモートマシンで実行し、そこで Claude Code が応答するかどうかを確認します。 |

327| `Cannot read this as an image: <path> is a pipe or a device` | [ツールエラー](#file-is-too-large-to-read-as-an-image) |327| `Cannot read this as an image: <path> is a pipe or a device` | [ツールエラー](#file-is-too-large-to-read-as-an-image) |

328| `subagent_type is required: the general-purpose agent is not available in this session` | [ツールエラー](#subagent-type-is-required) |328| `subagent_type is required: the general-purpose agent is not available in this session` | [ツールエラー](#subagent-type-is-required) |

329| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [ツールエラー](#memory-index-is-over-its-read-limit) |329| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [ツールエラー](#memory-index-is-over-its-read-limit) |

330| `Sandbox is required but failed to initialize: <reason>` | [サンドボックス化のトラブルシューティング](https://code.claude.com/docs/ja/sandboxing.md#commands-refused-with-sandbox-is-required) |

331| `Sandbox is required (sandbox.failIfUnavailable) and stopped being available in this session: <reason>` | [サンドボックス化のトラブルシューティング](https://code.claude.com/docs/ja/sandboxing.md#commands-refused-with-sandbox-is-required) |

330| `pkill: refusing to run` | [ツールエラー](#pkill-pattern-matches-the-claude-code-process) |332| `pkill: refusing to run` | [ツールエラー](#pkill-pattern-matches-the-claude-code-process) |

331| `Failed to write to <name>'s inbox — nothing was sent` | [ツールエラー](#failed-to-write-to-a-teammate-inbox) |333| `Failed to write to <name>'s inbox — nothing was sent` | [ツールエラー](#failed-to-write-to-a-teammate-inbox) |

332| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [ツールエラー](#failed-to-write-to-a-teammate-inbox) |334| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [ツールエラー](#failed-to-write-to-a-teammate-inbox) |

80 80 

81高速モード価格は完全な 1M トークンコンテキストウィンドウ全体で一定です。比較対象となる標準 Opus レートについては、[Claude 価格リファレンス](https://platform.claude.com/docs/ja/about-claude/pricing)を参照してください。81高速モード価格は完全な 1M トークンコンテキストウィンドウ全体で一定です。比較対象となる標準 Opus レートについては、[Claude 価格リファレンス](https://platform.claude.com/docs/ja/about-claude/pricing)を参照してください。

82 82 

83会話で初めて fast mode を有効にすると、会話コンテキスト全体に対して、fast mode のキャッシュされていない入力トークンの価格を全額支払います。会話が進んでいるほどこのコストは高くなるため、最初に fast mode を有効にしたときに請求額が最も小さくなります。コストは会話ごとに 1 回だけ適用されるため、後で fast mode をオフにしてから再びオンに切り替えても、再度請求されることはありません。仕組みについては、[fast mode がプロンプトキャッシュとどのように相互作用するか](https://code.claude.com/docs/ja/prompt-caching.md#turning-on-fast-mode)を参照してください。83会話で初めて fast mode を有効にすると、会話コンテキスト全体に対して、fast mode のキャッシュされていない入力トークンの価格を全額支払います。会話が進んでいるほどこのコストは高くなるため、最初に fast mode を有効にしたときに請求額が最も小さくなります。fast mode と標準速度は[別々のキャッシュ](https://code.claude.com/docs/ja/prompt-caching.md#turning-on-fast-mode)を保持するため、その後切り替えるたびに、会話の一部または全体が再びキャッシュなしで読み込まれます。

84 84 

85### 高速モード支出がどこに表示されるかを確認する85### 高速モード支出がどこに表示されるかを確認する

86 86 

87高速モード支出がどこに表示されるかは、サインイン方法によって異なるため、まず [`/status`](https://code.claude.com/docs/ja/commands)を実行して確認してください。`Claude Max アカウント`などの `ログイン方法`行が表示される場合は、Claude サブスクリプションでサインインしています。代わりに `API キー`行が表示される場合は、リクエストが Claude Console 組織に請求されます。87fast mode の支出がどこに表示されるかは、サインイン方法によって異なるため、まず [`/status`](https://code.claude.com/docs/ja/commands) を実行して確認してください。`Claude Max account` などの `Login method` 行が表示される場合は、Claude サブスクリプションでサインインしています。代わりに `API key` 行が表示される場合は、リクエストが Claude Console 組織に請求されます。

88 88 

89* **Pro と Max**：使用クレジットから高速モードの料金を支払います。claude.ai の [**設定 > 使用状況**](https://claude.ai/settings/usage)に移動します。ここで、**使用クレジット**セクションに今月の使用クレジットの支出額が表示されます。この数字には高速モードが含まれていますが、別途に分類されていません。89* **Pro と Max**：使用クレジットから高速モードの料金を支払います。claude.ai の [**設定 > 使用状況**](https://claude.ai/settings/usage)に移動します。ここで、**使用クレジット**セクションに今月の使用クレジットの支出額が表示されます。この数字には高速モードが含まれていますが、別途に分類されていません。

90* **Team と Enterprise**：組織が使用クレジットから高速モード使用の料金を支払います。自分の使用クレジット支出を確認するには、[`/usage`](https://code.claude.com/docs/ja/costs#check-your-usage-credits-spend)を実行してください。組織がその支出をどこで確認するかについては、[Claude for Teams and Enterprise](https://code.claude.com/docs/ja/costs.md#claude-for-teams-and-enterprise)を参照してください。90* **Team と Enterprise**：組織が使用クレジットから高速モード使用の料金を支払います。自分の使用クレジット支出を確認するには、[`/usage`](https://code.claude.com/docs/ja/costs#check-your-usage-credits-spend)を実行してください。組織がその支出をどこで確認するかについては、[Claude for Teams and Enterprise](https://code.claude.com/docs/ja/costs.md#claude-for-teams-and-enterprise)を参照してください。

167 167 

168ゲートウェイの背後では、Claude Code が利用可否チェックを送信せず、以前に成功したチェックもキャッシュされていない、次の設定になっていないか確認してください：168ゲートウェイの背後では、Claude Code が利用可否チェックを送信せず、以前に成功したチェックもキャッシュされていない、次の設定になっていないか確認してください：

169 169 

170* `ANTHROPIC_BASE_URL` をゲートウェイに向け、[`ANTHROPIC_API_KEY`](https://code.claude.com/docs/ja/llm-gateway-connect#set-the-base-url-and-credential) に Anthropic API キーの形式ではないゲートウェイ発行のキーを設定している。Claude Code はそのようなキーを `api.anthropic.com` に送信しません。170* `ANTHROPIC_BASE_URL` をゲートウェイに向け、[`ANTHROPIC_API_KEY`](https://code.claude.com/docs/ja/llm-gateway-connect#set-the-base-url-and-credential) に Anthropic API キーの形式ではないゲートウェイ発行のキーを設定している。

171* [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/ja/env-vars) を設定しているため、Claude Code がチェックをスキップする。171* [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/ja/env-vars) を設定しているため、Claude Code がチェックをスキップする。

172 172 

173どちらの設定でも、fast mode を復元するには `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1` を設定します。173どちらの設定でも、fast mode を復元するには `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1` を設定します。

262 262 

263**コンテキストコスト：** 使用されるまで低い。ユーザーのみのスキルは呼び出されるまでゼロコストです。263**コンテキストコスト：** 使用されるまで低い。ユーザーのみのスキルは呼び出されるまでゼロコストです。

264 264 

265**Subagents 内：** スキルは subagents で異なる動作をします。オンデマンドロードの代わりに、subagent の `skills` フィールドにリストされているスキルは起動時にそのコンテキストに完全にプリロードされます。Subagents はスキルツールを通じて、リストされていないプロジェクト、ユーザー、プラグインスキルを発見して呼び出すことができます。265**サブエージェント内：** サブエージェントの `skills` フィールドにリストされているスキルの完全なコンテンツは、オンデマンドではなく[起動時にそのコンテキストにロードされます](https://code.claude.com/docs/ja/sub-agents.md#preload-skills-into-subagents)。サブエージェントは引き続き、Skill ツールを通じてリストされていないプロジェクト、ユーザー、プラグインのスキルを発見して呼び出すことができます。

266 266 

267> [!TIP]267> [!TIP]

268>268>

120 120 

121### Compaction121### Compaction

122 122 

123[コンテキストウィンドウ](#context-window)が上限に近づいたときに、会話を自動的に要約する処理です。まず古いツール出力がクリアされ、次に会話が要約されます。プロジェクトルートの CLAUDE.md と自動メモリは圧縮後も保持され、ディスクから再読み込みされますが、会話の中でのみ与えられた指示は失われる可能性があります。手動で実行するには `/compact` を実行します。`/compact focus on the API changes` のように重点を指定することもできます。123[コンテキストウィンドウ](#context-window)が上限に近づいたときに、会話を自動的に要約する処理です。プロジェクトルートの CLAUDE.md と自動メモリは圧縮後も保持されますが、会話の中でのみ与えられた指示は失われる可能性があります。手動で実行するには `/compact` を実行します。`/compact focus on the API changes` のように重点を指定することもできます。

124 124 

125詳細: [コンテキスト圧縮後も保持されるもの](https://code.claude.com/docs/ja/context-window.md#what-survives-compaction) · [コンテキストがいっぱいになったとき](https://code.claude.com/docs/ja/how-claude-code-works.md#when-context-fills-up)125詳細: [コンテキスト圧縮後も保持されるもの](https://code.claude.com/docs/ja/context-window.md#what-survives-compaction) · [コンテキストがいっぱいになったとき](https://code.claude.com/docs/ja/how-claude-code-works.md#when-context-fills-up) · [アイドル状態のままにした会話を Claude Code が圧縮するタイミング](https://code.claude.com/docs/ja/settings-reference.md#idlecompaction)

126 126 

127### Connector127### Connector

128 128 

1426 1426 

1427Setup フックはブロックできません。どの終了コードでも実行は継続されます。どの終了コードの場合も、Claude Code は Setup フックの [JSON 出力フィールド](#json-output)（`systemMessage`、`continue`、`hookSpecificOutput.additionalContext` など）を破棄します。`-p` では、Setup フックの stdout、stderr、終了コードは、`--output-format stream-json --verbose` で起動した場合にのみ、[`hook_response` イベント](https://code.claude.com/docs/ja/headless#read-session-metadata)として実行の出力に表示されます。1427Setup フックはブロックできません。どの終了コードでも実行は継続されます。どの終了コードの場合も、Claude Code は Setup フックの [JSON 出力フィールド](#json-output)（`systemMessage`、`continue`、`hookSpecificOutput.additionalContext` など）を破棄します。`-p` では、Setup フックの stdout、stderr、終了コードは、`--output-format stream-json --verbose` で起動した場合にのみ、[`hook_response` イベント](https://code.claude.com/docs/ja/headless#read-session-metadata)として実行の出力に表示されます。

1428 1428 

1429Setup フックは `CLAUDE_ENV_FILE` にアクセスできます。このファイルに書き込まれた変数は、[SessionStart フック](#persist-environment-variables)と同様に、セッションの後続の Bash コマンドに引き継がれます。`Setup` では `type: "command"` フックのみが実行されます。`Setup` の `type: "mcp_tool"` フックは、[MCP ツールフックのフィールド](#mcp-tool-hook-fields)で説明されているとおり、常にスキップされます。1429Setup フックは `CLAUDE_ENV_FILE` にアクセスできます。フックがこのファイルに変数を書き込むと、[SessionStart フック](#persist-environment-variables)と同様に、セッション中の後続の Bash コマンドに引き継がれます。`Setup` で実行されるのは `type: "command"` フックのみです。[MCP ツールフックのフィールド](#mcp-tool-hook-fields)で説明されているとおり、`Setup` の `type: "mcp_tool"` フックは常にスキップされます。

1430 1430 

1431### InstructionsLoaded1431### InstructionsLoaded

1432 1432 

1483 1483 

1484`UserPromptSubmit` の [Agent SDK コールバックフック](https://code.claude.com/docs/ja/agent-sdk/hooks.md)がタイムアウトに達すると、フック名とタイムアウトを示すメッセージとともにプロンプトがブロックされます。そこでのコールバックは、フェイルオープンしてはならないポリシーゲートとして機能している可能性があるためです。セッションは継続します。1484`UserPromptSubmit` の [Agent SDK コールバックフック](https://code.claude.com/docs/ja/agent-sdk/hooks.md)がタイムアウトに達すると、フック名とタイムアウトを示すメッセージとともにプロンプトがブロックされます。そこでのコールバックは、フェイルオープンしてはならないポリシーゲートとして機能している可能性があるためです。セッションは継続します。

1485 1485 

1486#### プロンプトのチェック中の `Esc`

1487 

1488フックがプロンプトをチェックしている最中に `Esc` を押すかセッションを中断すると、チェックは停止し、プロンプトは Claude に届きません。ターミナルで入力したテキストはプロンプトの入力欄に戻り、再送信したときにフックが再びチェックします。

1489 

1490中断したのと同じタイミングでフックがプロンプトをブロックすることもあります。その場合、プロンプトはブロックされたままになります：そのフックの[ブロックメッセージ](#what-a-blocked-prompt-leaves-behind)が表示され、テキストは入力欄に戻りません。

1491 

1486#### UserPromptSubmit の入力1492#### UserPromptSubmit の入力

1487 1493 

1488[共通入力フィールド](#common-input-fields)に加えて、UserPromptSubmit フックは送信されたテキストを含む `prompt` フィールドを受け取ります。`[Pasted text #N]` プレースホルダーに折りたたまれた貼り付けコンテンツは、その場で展開された状態で届きます。Claude Code が[貼り付けたテキストを Claude 向けにマークする](https://code.claude.com/docs/ja/terminal-config.md#how-claude-treats-pasted-text)セッションでは、展開されたコンテンツは `<pasted_content id="…">` の行と `</pasted_content id="…">` の行の間に置かれるため、フックがプロンプトを解析する場合はこれらの行を考慮してください。1494[共通入力フィールド](#common-input-fields)に加えて、UserPromptSubmit フックは送信されたテキストを含む `prompt` フィールドを受け取ります。`[Pasted text #N]` プレースホルダーに折りたたまれた貼り付けコンテンツは、その場で展開された状態で届きます。Claude Code が[貼り付けたテキストを Claude 向けにマークする](https://code.claude.com/docs/ja/terminal-config.md#how-claude-treats-pasted-text)セッションでは、展開されたコンテンツは `<pasted_content id="…">` の行と `</pasted_content id="…">` の行の間に置かれるため、フックがプロンプトを解析する場合はこれらの行を考慮してください。

1741 1747 

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

1743 1749 

1744`PreToolUse` の [Agent SDK コールバックフック](https://code.claude.com/docs/ja/agent-sdk/hooks.md)がタイムアウトを超えると、ツール呼び出しはブロックされ、Claude はタイムアウトを示すエラー結果を受け取ります。1750タイムアウトを超えた `PreToolUse` の [Agent SDK コールバックフック](https://code.claude.com/docs/ja/agent-sdk/hooks.md#hook-timeout)は、ツール呼び出しをブロックします。

1745 1751 

1746#### PreToolUse の入力1752#### PreToolUse の入力

1747 1753 

2457| `quota_auto_resume_fired` | claude.ai の使用制限によってタスクが一時停止された後、Claude Code がタスクを続行したとき。続行はリセット時に行われるか、待機中に Claude Code で使用クレジットの追加、プランのアップグレード、モデルの切り替えなどを行って使用量が再び利用可能になった場合はそれより早く行われます（[モデル設定の例外](https://code.claude.com/docs/ja/interactive-mode.md#wait-for-a-usage-limit-to-reset)あり） |2463| `quota_auto_resume_fired` | claude.ai の使用制限によってタスクが一時停止された後、Claude Code がタスクを続行したとき。続行はリセット時に行われるか、待機中に Claude Code で使用クレジットの追加、プランのアップグレード、モデルの切り替えなどを行って使用量が再び利用可能になった場合はそれより早く行われます（[モデル設定の例外](https://code.claude.com/docs/ja/interactive-mode.md#wait-for-a-usage-limit-to-reset)あり） |

2458| `quota_auto_resume_stale` | コンピューターが約 30 分以上スリープしている間に claude.ai の使用制限がリセットされたとき。Claude Code は続行せず、ユーザーが `Enter` を押すのを待ちます。スリープがそれより短い場合は続行し、代わりに `quota_auto_resume_fired` を発火します |2464| `quota_auto_resume_stale` | コンピューターが約 30 分以上スリープしている間に claude.ai の使用制限がリセットされたとき。Claude Code は続行せず、ユーザーが `Enter` を押すのを待ちます。スリープがそれより短い場合は続行し、代わりに `quota_auto_resume_fired` を発火します |

2459| `quota_auto_resume_disabled` | Claude Code が claude.ai の使用制限の待機を、タスクを続行せずに終了したとき。たとえば、Claude Code が自動的に開始した待機中に [`autoContinueAtUsageLimit`](https://code.claude.com/docs/ja/settings-reference#autocontinueatusagelimit) がオフにされた場合やリセットが 24 時間以上先に移動した場合、続行したタスクが繰り返し制限に達した場合、続行がモデルに到達する前にブロックされた場合です。ユーザーが `Esc` または `Ctrl+C` を押した場合や、**Don't continue automatically** を選択した場合は発火しません |2465| `quota_auto_resume_disabled` | Claude Code が claude.ai の使用制限の待機を、タスクを続行せずに終了したとき。たとえば、Claude Code が自動的に開始した待機中に [`autoContinueAtUsageLimit`](https://code.claude.com/docs/ja/settings-reference#autocontinueatusagelimit) がオフにされた場合やリセットが 24 時間以上先に移動した場合、続行したタスクが繰り返し制限に達した場合、続行がモデルに到達する前にブロックされた場合です。ユーザーが `Esc` または `Ctrl+C` を押した場合や、**Don't continue automatically** を選択した場合は発火しません |

2460| `plugin_notification` | [mod](https://code.claude.com/docs/ja/plugins/mods/api.md#show-something-without-starting-a-turn) が `$.ui.notify` で通知を発生させたとき。mod が `title` を設定していない限り、フックの `title` は mod の名前になります |2466| `plugin_notification` | [mod](https://code.claude.com/docs/ja/plugins/mods/api.md#show-something-without-starting-a-turn) が `$.ui.notify` で通知を発行したとき。mod がタイトルを設定していない限り、フックの `title` は mod の名前になります |

2461 2467 

2462`quota_auto_resume_fired`、`quota_auto_resume_stale`、`quota_auto_resume_disabled` タイプには Claude Code v2.1.234 以降が必要です。2468`quota_auto_resume_fired`、`quota_auto_resume_stale`、`quota_auto_resume_disabled` タイプには Claude Code v2.1.234 以降が必要です。

2463 2469 

2970 2976 

2971メインの会話内のシェルコマンドが作業ディレクトリを変更したとき、たとえば Claude が `cd` コマンドを実行したときに実行されます。環境変数の再読み込み、プロジェクト固有のツールチェーンの有効化、セットアップスクリプトの自動実行など、ディレクトリの変更に反応するために使用します。ディレクトリごとの環境を管理する [direnv](https://direnv.net/) のようなツールでは、[FileChanged](#filechanged) と組み合わせて使用します。2977メインの会話内のシェルコマンドが作業ディレクトリを変更したとき、たとえば Claude が `cd` コマンドを実行したときに実行されます。環境変数の再読み込み、プロジェクト固有のツールチェーンの有効化、セットアップスクリプトの自動実行など、ディレクトリの変更に反応するために使用します。ディレクトリごとの環境を管理する [direnv](https://direnv.net/) のようなツールでは、[FileChanged](#filechanged) と組み合わせて使用します。

2972 2978 

2973CwdChanged フックは [`CLAUDE_ENV_FILE`](#persist-environment-variables) にアクセスできます。そのファイルに書き込まれた変数は、次の CwdChanged イベントで Claude Code によってクリアされるまで、後続の Bash コマンドに引き継がれます。2979CwdChanged フックは [`CLAUDE_ENV_FILE`](#persist-environment-variables) にアクセスできます。フックがそのファイルに変数を書き込むと、それらの変数は次の CwdChanged イベントで Claude Code がクリアするまで、後続の Bash コマンドに引き継がれます。

2974 2980 

2975CwdChanged は matcher をサポートせず、すべての発生時に発火します。2981CwdChanged は matcher をサポートせず、すべての発生時に発火します。

2976 2982 

3135* Claude Code が[バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md#how-file-edits-are-isolated)を専用の worktree に分離した3141* Claude Code が[バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md#how-file-edits-are-isolated)を専用の worktree に分離した

3136* `worktree` モードの [`claude remote-control`](https://code.claude.com/docs/ja/remote-control#start-a-remote-control-session) が専用の worktree でセッションを開始した3142* `worktree` モードの [`claude remote-control`](https://code.claude.com/docs/ja/remote-control#start-a-remote-control-session) が専用の worktree でセッションを開始した

3137 3143 

3138Claude が `EnterWorktree` を呼び出すのではなく、Bash ツールを通じて `git worktree add` を実行した場合、WorktreeCreate フックは実行されません。そのコマンドを検査またはブロックするには、`Bash` matcher を持つ [`PreToolUse`](#pretooluse) フックを追加してください。3144WorktreeCreate フックは、Claude が Bash を通じて追加する worktree に対しては実行されません。また、`--worktree` と [`--tmux`](https://code.claude.com/docs/ja/cli-reference#cli-flags) で起動したときに作成される worktree に対しては、プラグインのフックは実行されません。

3145 

3146* **Bash を通じた `git worktree add`**: そのコマンドを検査またはブロックするには、`Bash` matcher を持つ [`PreToolUse`](#pretooluse) フックを追加してください。

3147* **`--worktree` と `--tmux` の併用**: Claude Code はプラグインを読み込む前に worktree を作成するため、プラグインの WorktreeCreate フックは実行されません。両方のフラグでフックを実行させるには、代わりに[設定ファイル](#configuration)でフックを定義してください。v2.1.300 より前は、`--worktree` 単独の場合でもプラグインの WorktreeCreate フックは実行されませんでした。

3139 3148 

3140デフォルトでは、Claude Code は `git worktree` を使って分離された作業コピーを作成します。WorktreeCreate フックを設定すると、このデフォルトの git の動作が置き換えられ、SVN、Perforce、Mercurial などの別のバージョン管理システムを使用できるようになります。3149デフォルトでは、Claude Code は `git worktree` を使って分離された作業コピーを作成します。WorktreeCreate フックを設定すると、このデフォルトの git の動作が置き換えられ、SVN、Perforce、Mercurial などの別のバージョン管理システムを使用できるようになります。

3141 3150 

4077 4086 

4078非同期フックが発火すると、Claude Code はフック プロセスを開始し、完了を待たずにすぐに続行します。フックは同期フックと同じ JSON 入力を stdin 経由で受け取ります。4087非同期フックが発火すると、Claude Code はフック プロセスを開始し、完了を待たずにすぐに続行します。フックは同期フックと同じ JSON 入力を stdin 経由で受け取ります。

4079 4088 

4080バックグラウンド プロセスが終了した後、Claude Code はフックの JSON レスポンスに含まれる `additionalContext` フィールドと `systemMessage` フィールドを次の会話ターンで Claude に配信します。同期フックの `systemMessage` とは異なり、どちらのフィールドもユーザーには表示されません。4089バックグラウンド プロセスが終了した後、Claude Code はフックの JSON レスポンスに含まれる `additionalContext` フィールドと `systemMessage` フィールドを次の会話ターンで Claude に配信します。ただし、[繰り返される `SessionStart` の出力](#limitations)は除きます。同期フックの `systemMessage` とは異なり、どちらのフィールドもユーザーには表示されません。

4081 4090 

4082JSON レスポンスは、stdout に単独で出力するか、それ自体だけの 1 行として出力します。4091JSON レスポンスは、stdout に単独で出力するか、それ自体だけの 1 行として出力します。

4083 4092 

4145 4154 

4146* フック出力は次の会話ターンで配信されます。セッションがアイドル状態の場合、レスポンスは次のユーザー操作まで待機します。例外: `asyncRewake` フックが終了コード 2 で終了すると、セッションがアイドル状態でも Claude を直ちに起動します。4155* フック出力は次の会話ターンで配信されます。セッションがアイドル状態の場合、レスポンスは次のユーザー操作まで待機します。例外: `asyncRewake` フックが終了コード 2 で終了すると、セッションがアイドル状態でも Claude を直ちに起動します。

4147* 各実行は個別のバックグラウンド プロセスを作成します。4156* 各実行は個別のバックグラウンド プロセスを作成します。

4157* 非同期の `SessionStart` フックは、イベントが発火するたびに実行されます。`additionalContext` と `systemMessage` のテキストが、Claude がそのフックから最後に受け取った内容と一致する場合、Claude Code はフックの出力をスキップします。ただし、それ以降に同期 `SessionStart` フックが別のテキストを追加した場合は除きます。Claude Code はテキストが変更されたときにそのテキストを配信し、コンテキスト圧縮または `/clear` の後に次にフックが実行されたときにも再度配信します。v2.1.295 より前は、Claude Code は再開のたびに同じテキストを会話に再度追加していました。

4148 4158 

4149## セキュリティに関する考慮事項4159## セキュリティに関する考慮事項

4150 4160 

954* `PostToolUse` フックは、ツールがすでに実行されているため、アクションを元に戻すことはできません。954* `PostToolUse` フックは、ツールがすでに実行されているため、アクションを元に戻すことはできません。

955* [`PermissionRequest`](https://code.claude.com/docs/ja/hooks#permissionrequest) フックは、Claude Code がユーザーに権限を求めようとするとき、またはプロンプトを表示できない呼び出しをそのままでは自動的に拒否するときに発火します。`-p` フラグを使用した[非対話モード](https://code.claude.com/docs/ja/headless.md)でも、[`dontAsk` モード](https://code.claude.com/docs/ja/permission-modes#allow-only-pre-approved-tools-with-dontask-mode)以外では引き続き実行され、どのフックも判断せず、他に応答できるものもない呼び出しは拒否されます。955* [`PermissionRequest`](https://code.claude.com/docs/ja/hooks#permissionrequest) フックは、Claude Code がユーザーに権限を求めようとするとき、またはプロンプトを表示できない呼び出しをそのままでは自動的に拒否するときに発火します。`-p` フラグを使用した[非対話モード](https://code.claude.com/docs/ja/headless.md)でも、[`dontAsk` モード](https://code.claude.com/docs/ja/permission-modes#allow-only-pre-approved-tools-with-dontask-mode)以外では引き続き実行され、どのフックも判断せず、他に応答できるものもない呼び出しは拒否されます。

956* `Stop` フックは、タスクの完了時だけでなく、Claude が応答を終えるたびに発火します。ユーザーによる中断では発火しません。API エラーの場合は代わりに [StopFailure](https://code.claude.com/docs/ja/hooks.md#stopfailure) が発火します。956* `Stop` フックは、タスクの完了時だけでなく、Claude が応答を終えるたびに発火します。ユーザーによる中断では発火しません。API エラーの場合は代わりに [StopFailure](https://code.claude.com/docs/ja/hooks.md#stopfailure) が発火します。

957* 複数の `PreToolUse` フックがツールの引数を書き換えるために [`updatedInput`](https://code.claude.com/docs/ja/hooks#pretooluse) を返す場合、最後に完了したものが有効になります。フックは並列に実行されるため、順序は非決定的です。同じツールの入力を複数のフックで変更することは避けてください。957* 複数の `PreToolUse` フックがツールの入力を書き換えるために [`updatedInput`](https://code.claude.com/docs/ja/hooks#pretooluse) を返す場合、Claude Code は書き換えをマージせず、どの書き換えでツールが実行されるかも保証しません。同じツールの入力を複数のフックで書き換えることは避けてください。

958 958 

959### フックと権限モード959### フックと権限モード

960 960 

131 131 

132#### コンテキストが満杯になったとき132#### コンテキストが満杯になったとき

133 133 

134Claude Code はコンテキストウィンドウの制限に近づくと、自動的にコンテキストを管理します。古いツール出力をクリアし、必要に応じて会話を要約します。リクエストと主要なコードスニペットは保持されます。会話の早い段階からの詳細な指示は失われる可能性があります。会話履歴に依存するのではなく、永続的なルールを CLAUDE.md に入れてください。134Claude Code は制限に近づくと、自動的にコンテキストを管理します。会話を要約に圧縮します。要約にはリクエストと主要なコードスニペットが保持されますが、会話の早い段階からの詳細な指示は失われる可能性があります。会話履歴に依存するのではなく、永続的なルールを CLAUDE.md に入れてください。

135 135 

136コンパクト化中に保持されるものを制御するには、CLAUDE.md に「Compact Instructions」セクションを追加するか、`/compact` をフォーカス付きで実行します（例：`/compact focus on the API changes`）。136コンパクト化中に保持されるものを制御するには、CLAUDE.md に「Compact Instructions」セクションを追加するか、`/compact` をフォーカス付きで実行します（例：`/compact focus on the API changes`）。

137 137 

659 659 

660ファイルリストのスクロールや比較対象の変更に使うキーを再バインドするには、[Diff パネルアクション](https://code.claude.com/docs/ja/keybindings.md#diff-panel-actions)を参照してください。660ファイルリストのスクロールや比較対象の変更に使うキーを再バインドするには、[Diff パネルアクション](https://code.claude.com/docs/ja/keybindings.md#diff-panel-actions)を参照してください。

661 661 

662マージ、リベース、チェリーピック、またはリバートが完了していない間、パネルは最後に git から読み取った変更を表示し続けるため、その操作で取り込まれる変更でパネルが埋まることはありません。パネルは操作の終了後の最初の更新時（たとえば、Claude が次にファイルを編集したとき）に更新されます。

663 

662### Diff ダイアログ664### Diff ダイアログ

663 665 

664diff ダイアログは、プロンプトの上に枠付きのブロックとして開き、変更されたファイルを追加行数と削除行数とともにリストアップします。ファイルは `HEAD` と比較されるか、このリポジトリで最後に [diff パネルで選択した](#diff-panel)対象と比較されます。666diff ダイアログは、プロンプトの上に枠付きのブロックとして開き、変更されたファイルを追加行数と削除行数とともにリストアップします。ファイルは `HEAD` と比較されるか、このリポジトリで最後に [diff パネルで選択した](#diff-panel)対象と比較されます。

678 678 

679## Vim モードの相互作用679## Vim モードの相互作用

680 680 

681Vim モードが `/config` → エディタモードで有効な場合、キーバインディングと Vim モードは独立して動作します。681`/config` のエディタモード設定で Vim モードを有効にすると、キーボードショートカットと Vim モードは独立して動作します。

682 682 

683* **Vim モード** はテキスト入力レベルで入力を処理します（カーソル移動、モード、モーション）683* **Vim モード**はテキスト入力レベルで入力を処理します：カーソル移動、モード、モーション

684* **キーバインディング** はコンポーネントレベルでアクションを処理します（todos を切り替え、送信など）684* **キーボードショートカット** はコンポーネントレベルでアクションを処理します（todo の切り替えやメッセージの送信など）

685* Vim モードの Escape キーは INSERT から NORMAL モードに切り替わります。`chat:cancel` をトリガーしません685* vim モードでは、Escape キーは INSERT モードから NORMAL モードに切り替えます。`chat:cancel` はトリガーされません

686* ほとんどの Ctrl+key ショートカットは Vim モードを通過してキーバインディングシステムに渡されます686* ほとんどの Ctrl+key ショートカットは Vim モードを通過してキーバインディングシステムに渡されます

687* Vim キーはキーバインディングファイルを通じて再マップできません。`jj` を Escape にマップするような 2 キーの INSERT モードシーケンスをマップするには、[`vimInsertModeRemaps`](https://code.claude.com/docs/ja/interactive-mode#remap-insert-mode-key-sequences) 設定を使用してください687* Vim キーはキーバインディングファイルを通じて再マップできません。`jj` を Escape にマップするような 2 キーの INSERT モードシーケンスをマップするには、[`vimInsertModeRemaps`](https://code.claude.com/docs/ja/interactive-mode#remap-insert-mode-key-sequences) 設定を使用してください

688* Vim NORMAL モードでは、`?` はヘルプメニューを表示します（Vim の動作）688* Vim NORMAL モードでは、`?` はヘルプメニューを表示します（Vim の動作）

306 306 

307## ディレクトリごとのスキルを追加する307## ディレクトリごとのスキルを追加する

308 308 

309任意のサブディレクトリは、独自のスタックにスコープされた[スキル](https://code.claude.com/docs/ja/skills.md)を定義できます。スキルは Claude が関連性があると判断したときにオンデマンドで読み込まれるため、API 固有のツーリングはフロントエンド作業中にコンテキストを消費しません。309任意のサブディレクトリは、独自のスタックにスコープされた[スキル](https://code.claude.com/docs/ja/skills.md)を定義できます。スキルは Claude が関連性があると判断したときにオンデマンドで読み込まれます。

310 310 

311スキルはディレクトリ内の `.claude/skills/` の下に存在します。その領域のコードと一緒にコミットして、リポジトリをクローンした誰もがそれらを取得できるようにします。モノレポでは、パッケージごとに 1 つのスキルセットを持つことができます。大規模な単一ツリーコードベースでは、`src/db/.claude/skills/` などのサブシステムごとに 1 つのセットを持つことができます。311スキルはディレクトリ内の `.claude/skills/` の下に存在します。その領域のコードと一緒にコミットして、リポジトリをクローンした誰もがそれらを取得できるようにします。モノレポでは、パッケージごとに 1 つのスキルセットを持つことができます。大規模な単一ツリーコードベースでは、`src/db/.claude/skills/` などのサブシステムごとに 1 つのセットを持つことができます。

312 312 

347- Mock external services in `src/__tests__/mocks/`347- Mock external services in `src/__tests__/mocks/`

348```348```

349 349 

350別のサブディレクトリは同じ方法で異なるスキルを保持します。`packages/web/.claude/skills/component-patterns/` はテストの代わりにフロントエンドのコンポーネント規約を説明します。Claude が `packages/api/` のファイルで作業するとき、api-testing スキルを読み込みます。`packages/web/` で作業するとき、component-patterns を読み込みます。どちらのディレクトリのスキルも他方のタスク中には読み込まれません。350別のサブディレクトリは同じ方法で異なるスキルを保持します。`packages/web/.claude/skills/component-patterns/` はテストの代わりにフロントエンドのコンポーネント規約を説明します。Claude が `packages/api/` のファイルで作業するとき、api-testing スキルを読み込みます。`packages/web/` で作業するとき、component-patterns を読み込みます。

351 351 

352配置の代わりにファイルパターンでスキルをスコープすることもできます。[`paths` フロントマターフィールド](https://code.claude.com/docs/ja/skills#frontmatter-reference)はグロブパターンを受け取り、Claude は一致するファイルで作業するときのみ自動的にスキルを読み込みます。これをリポジトリルートの `.claude/skills/` に存在するスキルに使用して、データベースマイグレーションスキルなど `**/migrations/**` にスコープされた特定のファイルにのみ適用します。352配置の代わりにファイルパターンでスキルをスコープすることもできます。[`paths` フロントマターフィールド](https://code.claude.com/docs/ja/skills#frontmatter-reference)はグロブパターンを受け取り、Claude は一致するファイルで作業するときのみ自動的にスキルを読み込みます。これをリポジトリルートの `.claude/skills/` に存在するスキルに使用して、データベースマイグレーションスキルなど `**/migrations/**` にスコープされた特定のファイルにのみ適用します。

353 353 

520| `400` エラーがすべてのリクエストで、ゲートウェイ独自の言葉で認識されないツールタイプを拒否します。例えば `Input tag 'advisor_20260301'`。Claude Code v2.1.275 | そのバージョンでの段階的なロールアウトで、リクエストはアドバイザーがオフの場合でも[アドバイザーツール](https://code.claude.com/docs/ja/advisor.md)エントリを含みます。Anthropic API はそれを受け入れますが、ツールタイプを検証するゲートウェイまたは上流はリクエスト全体を拒否します。[リクエスト本体フィールドを変更せずに転送](https://code.claude.com/docs/ja/llm-gateway-protocol.md#forward-as-open-lists)するものはそれを影響を受けずに通します。エントリは会話コンテンツを含まない宣言です | v2.1.276 以降に更新します。これは `ANTHROPIC_BASE_URL` ゲートウェイの背後でエントリを送信しません。アドバイザーをオンにしない限り。v2.1.275 では、[`CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`](https://code.claude.com/docs/ja/env-vars)を設定します。これはリクエストからエントリを削除します |520| `400` エラーがすべてのリクエストで、ゲートウェイ独自の言葉で認識されないツールタイプを拒否します。例えば `Input tag 'advisor_20260301'`。Claude Code v2.1.275 | そのバージョンでの段階的なロールアウトで、リクエストはアドバイザーがオフの場合でも[アドバイザーツール](https://code.claude.com/docs/ja/advisor.md)エントリを含みます。Anthropic API はそれを受け入れますが、ツールタイプを検証するゲートウェイまたは上流はリクエスト全体を拒否します。[リクエスト本体フィールドを変更せずに転送](https://code.claude.com/docs/ja/llm-gateway-protocol.md#forward-as-open-lists)するものはそれを影響を受けずに通します。エントリは会話コンテンツを含まない宣言です | v2.1.276 以降に更新します。これは `ANTHROPIC_BASE_URL` ゲートウェイの背後でエントリを送信しません。アドバイザーをオンにしない限り。v2.1.275 では、[`CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`](https://code.claude.com/docs/ja/env-vars)を設定します。これはリクエストからエントリを削除します |

521| `/model` ピッカーから欠落しているモデル | ゲートウェイモデル名は Claude Code の組み込みリストにありません。または Claude Code は組み込みオプションを置き換える [`modelPicker`](https://code.claude.com/docs/ja/settings-reference#modelpicker) ラインアップを表示しています | [ゲートウェイモデル検出](#add-gateway-models-to-the-model-picker)を有効にするか、[モデル設定](https://code.claude.com/docs/ja/model-config.md)変数で名前を追加します。Claude Code が置き換える `modelPicker` ラインアップを表示している場合は、ゲートウェイモデルをそれに追加するか、管理設定がそれを提供する場合は管理者に追加を依頼します |521| `/model` ピッカーから欠落しているモデル | ゲートウェイモデル名は Claude Code の組み込みリストにありません。または Claude Code は組み込みオプションを置き換える [`modelPicker`](https://code.claude.com/docs/ja/settings-reference#modelpicker) ラインアップを表示しています | [ゲートウェイモデル検出](#add-gateway-models-to-the-model-picker)を有効にするか、[モデル設定](https://code.claude.com/docs/ja/model-config.md)変数で名前を追加します。Claude Code が置き換える `modelPicker` ラインアップを表示している場合は、ゲートウェイモデルをそれに追加するか、管理設定がそれを提供する場合は管理者に追加を依頼します |

522| 推論リクエストが機能している間に `/fast` が `Fast mode unavailable due to network connectivity issues` を報告します | [fast mode](https://code.claude.com/docs/ja/fast-mode.md) の可用性チェックは `api.anthropic.com` に直接送られ、`ANTHROPIC_BASE_URL` に従いません。そのため、直接エグレスがブロックされているとチェックに失敗します | エグレスがブロックされている場合は `api.anthropic.com` を許可リストに登録するか、スキップ変数を設定します。[プロキシと LLM ゲートウェイの背後で fast mode を使用する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |522| 推論リクエストが機能している間に `/fast` が `Fast mode unavailable due to network connectivity issues` を報告します | [fast mode](https://code.claude.com/docs/ja/fast-mode.md) の可用性チェックは `api.anthropic.com` に直接送られ、`ANTHROPIC_BASE_URL` に従いません。そのため、直接エグレスがブロックされているとチェックに失敗します | エグレスがブロックされている場合は `api.anthropic.com` を許可リストに登録するか、スキップ変数を設定します。[プロキシと LLM ゲートウェイの背後で fast mode を使用する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |

523| `ANTHROPIC_API_KEY` のゲートウェイ発行キーで認証するセッションで、`/fast` が `Fast mode is currently unavailable` を報告します | `ANTHROPIC_BASE_URL` がゲートウェイを指している間、Claude Code は Anthropic API キーの形式ではないキーを `api.anthropic.com` に送信しません。そのため [fast mode](https://code.claude.com/docs/ja/fast-mode.md) の可用性チェックは送信されず、以前に成功したチェックがキャッシュされていない場合、Claude Code は fast mode を利用不可として扱います | `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1` を設定します。[プロキシと LLM ゲートウェイの背後で fast mode を使用する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |523| `ANTHROPIC_API_KEY` のゲートウェイ発行キーで認証するセッションで、`/fast` が `Fast mode is currently unavailable` を報告します | `ANTHROPIC_BASE_URL` がゲートウェイを指していて、キーが Anthropic API キーの形式ではない間、Claude Code は [fast mode](https://code.claude.com/docs/ja/fast-mode.md) の可用性チェックを送信しません。以前に成功したチェックがキャッシュされていない場合、fast mode を利用不可として扱います | `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1` を設定します。[プロキシと LLM ゲートウェイの背後で fast mode を使用する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |

524| `ANTHROPIC_AUTH_TOKEN` で認証されたセッションで `/fast` が `Fast mode has been disabled by your organization` を報告します。組織が fast mode を有効にしている場合でも | 可用性チェックには claude.ai ログインまたは API キーが必要です。ベアラートークンのみの場合、Claude Code は fast mode をチェックを送信せずに無効として扱います | `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` を設定します。[プロキシと LLM ゲートウェイの背後で fast mode を使用する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |524| `ANTHROPIC_AUTH_TOKEN` で認証されたセッションで `/fast` が `Fast mode has been disabled by your organization` を報告します。組織が fast mode を有効にしている場合でも | 可用性チェックには claude.ai ログインまたは API キーが必要です。ベアラートークンのみの場合、Claude Code は fast mode をチェックを送信せずに無効として扱います | `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` を設定します。[プロキシと LLM ゲートウェイの背後で fast mode を使用する](https://code.claude.com/docs/ja/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |

525| [curl テスト](#verify-the-connection)が成功しても、Claude Code はログインするよう求めます | CLI には独自の認証情報がありません。到達可能な基本 URL は 1 つではなく、対話型セッションではプロジェクトの `.claude/settings.json` または `.claude/settings.local.json` の `env` ブロックは最初の実行ウィザードと[信頼プロンプト](https://code.claude.com/docs/ja/permissions.md#what-runs-before-you-trust-a-folder)の後にのみ適用されます | `ANTHROPIC_AUTH_TOKEN` を Claude Code が最初の実行セットアップの前に読み取る場所に設定します。シェルエクスポート、`~/.claude/settings.json` の `env` ブロック、または管理設定 |525| [curl テスト](#verify-the-connection)が成功しても、Claude Code はログインするよう求めます | CLI には独自の認証情報がありません。到達可能な基本 URL は 1 つではなく、対話型セッションではプロジェクトの `.claude/settings.json` または `.claude/settings.local.json` の `env` ブロックは最初の実行ウィザードと[信頼プロンプト](https://code.claude.com/docs/ja/permissions.md#what-runs-before-you-trust-a-folder)の後にのみ適用されます | `ANTHROPIC_AUTH_TOKEN` を Claude Code が最初の実行セットアップの前に読み取る場所に設定します。シェルエクスポート、`~/.claude/settings.json` の `env` ブロック、または管理設定 |

526| `ANTHROPIC_API_KEY` が設定されていますが、プロンプトなしで無視されます | キーはインタラクティブセッションで 1 回の承認が必要で、以前に拒否されたキーは再度尋ねられずに無視されます | `/config` で `Use custom API key` オプションで有効にします |526| `ANTHROPIC_API_KEY` が設定されていますが、プロンプトなしで無視されます | キーはインタラクティブセッションで 1 回の承認が必要で、以前に拒否されたキーは再度尋ねられずに無視されます | `/config` で `Use custom API key` オプションで有効にします |

148| :- | :- |148| :- | :- |

149| `x-claude-code-request-class` | このリクエストの種類：メイン会話のターンの場合は `main`、[サブエージェント](https://code.claude.com/docs/ja/sub-agents.md)のターンの場合は `subagent`、ワークフロー内で実行されているエージェントの場合は `workflow`、会話をコンパクト化する要約リクエストの場合は `compaction`、セッションタイトル、分類器、および要約などのサイドリクエストの場合は `auxiliary`。すべてのリクエストで送信されます |149| `x-claude-code-request-class` | このリクエストの種類：メイン会話のターンの場合は `main`、[サブエージェント](https://code.claude.com/docs/ja/sub-agents.md)のターンの場合は `subagent`、ワークフロー内で実行されているエージェントの場合は `workflow`、会話をコンパクト化する要約リクエストの場合は `compaction`、セッションタイトル、分類器、および要約などのサイドリクエストの場合は `auxiliary`。すべてのリクエストで送信されます |

150| `x-claude-code-agent-type` | リクエストを発行したサブエージェントの種類：`Explore`、`Plan`、または `general-purpose` などの組み込みエージェント型名、ユーザー定義エージェントの場合は `custom`、[エージェントチーム](https://code.claude.com/docs/ja/agent-teams.md)メンバーがリードのプロセスで実行されている場合は `teammate`、または [フォーク](https://code.claude.com/docs/ja/sub-agents.md#fork-the-current-conversation)の場合は `fork`。サブエージェント自身のターンにのみ存在します。サブエージェントのコンパクト化またはサイドリクエストはエージェント ID を保持しますが、タイプは含みません。ユーザーが選択したエージェント名は送信されません |150| `x-claude-code-agent-type` | リクエストを発行したサブエージェントの種類：`Explore`、`Plan`、または `general-purpose` などの組み込みエージェント型名、ユーザー定義エージェントの場合は `custom`、[エージェントチーム](https://code.claude.com/docs/ja/agent-teams.md)メンバーがリードのプロセスで実行されている場合は `teammate`、または [フォーク](https://code.claude.com/docs/ja/sub-agents.md#fork-the-current-conversation)の場合は `fork`。サブエージェント自身のターンにのみ存在します。サブエージェントのコンパクト化またはサイドリクエストはエージェント ID を保持しますが、タイプは含みません。ユーザーが選択したエージェント名は送信されません |

151| `x-claude-code-compaction` | [コンテキスト圧縮](https://code.claude.com/docs/ja/prompt-caching.md#compacting-the-conversation)中に会話を要約するリクエストに存在します。値は何がトリガーしたかを示します。コンテキストウィンドウが容量に近づいた場合は `auto`、`/compact` の場合は `manual`、API がリクエストが長すぎると拒否した場合は `reactive`。[アイドル時の圧縮](https://code.claude.com/docs/ja/settings-reference.md#idlecompaction)の場合も値は `auto` です。他のすべてのリクエストでは存在しません |151| `x-claude-code-compaction` | [コンテキスト圧縮](https://code.claude.com/docs/ja/prompt-caching.md#compacting-the-conversation)中に会話を要約するリクエストに存在します。値は何がトリガーしたかを示します。コンテキストウィンドウが容量に近づいた場合は `auto`、`/compact` の場合は `manual`、API がリクエストが長すぎると拒否した場合は `reactive`。インタラクティブなターミナルセッションでの[アイドル時の圧縮](https://code.claude.com/docs/ja/settings-reference.md#idlecompaction)の場合も値は `auto` です。他のすべてのリクエストでは存在しません。これには、圧縮の前にバックグラウンドで要約を書き込むリクエストも含まれます |

152| `x-claude-code-context-compacted` | コンパクト化後の最初のメイン会話リクエストに 1 回存在し、`x-claude-code-compaction` と同じ値を持ちます。このリクエストの前の会話プレフィックスはもう使用されないため、それをキーとしたキャッシュは削除できます |152| `x-claude-code-context-compacted` | コンパクト化後の最初のメイン会話リクエストに 1 回存在し、`x-claude-code-compaction` と同じ値を持ちます。このリクエストの前の会話プレフィックスはもう使用されないため、それをキーとしたキャッシュは削除できます |

153| `x-claude-code-prev-tool-durations` | このリクエストが含む結果のツール呼び出しの測定実行時間。`<name>=<ms>;<name>=<ms>` として、例えば `Bash=742;Read=9`。同じ会話のツール呼び出しのバッチ後の次のリクエストで送信されます。メインセッションまたはサブエージェントから送信されます |153| `x-claude-code-prev-tool-durations` | このリクエストが含む結果のツール呼び出しの測定実行時間。`<name>=<ms>;<name>=<ms>` として、例えば `Bash=742;Read=9`。同じ会話のツール呼び出しのバッチ後の次のリクエストで送信されます。メインセッションまたはサブエージェントから送信されます |

154| `x-claude-code-prompt-id` | ユーザープロンプトがリクエストを提供するランダム UUID。1 つのプロンプトを提供するリクエストは値を共有します。これには、プロンプトが開始したサブエージェントのターンが含まれます。プロンプトに属性付けされていないリクエストはそれを省略します。セッションのリクエストをプロンプトでグループ化するために使用してください。Claude Code v2.1.283 以降が必要です |154| `x-claude-code-prompt-id` | ユーザープロンプトがリクエストを提供するランダム UUID。1 つのプロンプトを提供するリクエストは値を共有します。これには、プロンプトが開始したサブエージェントのターンが含まれます。プロンプトに属性付けされていないリクエストはそれを省略します。セッションのリクエストをプロンプトでグループ化するために使用してください。Claude Code v2.1.283 以降が必要です |

238* アップストリームが会話中のシステムメッセージの `cache_control` マーカーのみを拒否した場合、Claude Code はシステムメッセージを維持し、マーカーを移動して 1 回再試行します。その再試行と、Claude Code が終了するまでの以降のリクエストでは、マーカーは `messages` 内でシステムメッセージではない最後のエントリに付けられます238* アップストリームが会話中のシステムメッセージの `cache_control` マーカーのみを拒否した場合、Claude Code はシステムメッセージを維持し、マーカーを移動して 1 回再試行します。その再試行と、Claude Code が終了するまでの以降のリクエストでは、マーカーは `messages` 内でシステムメッセージではない最後のエントリに付けられます

239* アップストリームが[思考署名](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)を拒否する場合（`bound to a different conversation` という `400` を含む）、Claude Code はリクエストを以前の思考ブロックなしでリトライし、それらを後のすべてのリクエストから除外します。新しい応答には依然として思考が含まれます239* アップストリームが[思考署名](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)を拒否する場合（`bound to a different conversation` という `400` を含む）、Claude Code はリクエストを以前の思考ブロックなしでリトライし、それらを後のすべてのリクエストから除外します。新しい応答には依然として思考が含まれます

240* ゲートウェイまたはそのアップストリームが [advisor ツール](https://code.claude.com/docs/ja/advisor.md)エントリを `tools` で認識されないツールタイプとして拒否する場合、Claude Code はそのエントリとその `anthropic-beta` 値なしでリクエストを 1 回リトライします。その後のそのベース URL へのリクエストは Claude Code が終了するまで advisor を除外し、その時間は `/advisor` は開発者に利用不可です。Claude Code はこの拒否を `Input tag` の後にツールタイプを命名するメッセージを含む `400` または `422` レスポンスによって認識します。例えば `Input tag 'advisor_20260301'` です。v2.1.280 より前では、Claude Code はこの拒否をリトライしませんでした240* ゲートウェイまたはそのアップストリームが [advisor ツール](https://code.claude.com/docs/ja/advisor.md)エントリを `tools` で認識されないツールタイプとして拒否する場合、Claude Code はそのエントリとその `anthropic-beta` 値なしでリクエストを 1 回リトライします。その後のそのベース URL へのリクエストは Claude Code が終了するまで advisor を除外し、その時間は `/advisor` は開発者に利用不可です。Claude Code はこの拒否を `Input tag` の後にツールタイプを命名するメッセージを含む `400` または `422` レスポンスによって認識します。例えば `Input tag 'advisor_20260301'` です。v2.1.280 より前では、Claude Code はこの拒否をリトライしませんでした

241* アップストリームが `output_config.effort` を拒否する場合、Claude Code は努力なしでリクエストを再試行し、Claude Code が終了するまでそのモデルへの以降のリクエストから努力を除外します。Claude Code はこの拒否を、メッセージが `Extra inputs are not permitted` とともに `output_config.effort` を挙げている、またはモデルが努力パラメーターをサポートしていないと述べている `400` によって認識します241* アップストリームが `output_config.effort` またはその `anthropic-beta` 値を拒否する場合、Claude Code は再試行し、Claude Code が終了するまでそのモデルへのリクエストにはどちらも追加しません。ゲートウェイがアップストリームの `400` を変更せずに転送し、メッセージが次のいずれかに該当する場合、ゲートウェイ側の変更は不要です：

242 * `Extra inputs are not permitted` とともに `output_config.effort` を挙げている

243 * モデルが努力パラメーターをサポートしていないと述べている

244 * `Unexpected value(s)` で始まり、`anthropic-beta` ヘッダーについて `effort-2025-11-24` を挙げている。v2.1.310 以降が必要です。[`ANTHROPIC_BETAS`](https://code.claude.com/docs/ja/env-vars) にこの値を含めている開発者は引き続きそれを送信して `400` を受け取るため、そのエントリを削除してもらってください

242* アップストリームが `context_management` フィールドまたはその `anthropic-beta` 値を拒否する場合、ゲートウェイにはそれらを除いたリクエストがもう一度届きます。後のリクエストでゲートウェイが再びそれらを受け取り、アップストリームが再び拒否した場合も、同じ再試行が行われます。Claude Code はこの拒否をメッセージによって認識します。たとえば `context_management: Extra inputs are not permitted` を含むメッセージです。v2.1.304 より前では、Claude Code はこの拒否を再試行しませんでした245* アップストリームが `context_management` フィールドまたはその `anthropic-beta` 値を拒否する場合、ゲートウェイにはそれらを除いたリクエストがもう一度届きます。後のリクエストでゲートウェイが再びそれらを受け取り、アップストリームが再び拒否した場合も、同じ再試行が行われます。Claude Code はこの拒否をメッセージによって認識します。たとえば `context_management: Extra inputs are not permitted` を含むメッセージです。v2.1.304 より前では、Claude Code はこの拒否を再試行しませんでした

243* アップストリームが `strict` など `defer_loading` 以外のベータツールフィールドを拒否する場合、`400` は開発者に届きます。その前に、ゲートウェイには[ツール検索フィールドを除いた](#retry-without-tool-search)リクエストが再び届くことがあります。このようなフィールドの送信を停止するには、開発者に [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) を設定してもらってください246* アップストリームが `strict` など `defer_loading` 以外のベータツールフィールドを拒否する場合、`400` は開発者に届きます。その前に、ゲートウェイには[ツール検索フィールドを除いた](#retry-without-tool-search)リクエストが再び届くことがあります。このようなフィールドの送信を停止するには、開発者に [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) を設定してもらってください

244 247 

470名前が届かない場合は、次のいずれかの原因を確認してください。470名前が届かない場合は、次のいずれかの原因を確認してください。

471 471 

472* **Desktop を実行しているコンピューターで設定した**: Desktop は、そこで設定した値を SSH セッションに渡しません472* **Desktop を実行しているコンピューターで設定した**: Desktop は、そこで設定した値を SSH セッションに渡しません

473* **ログインファイルでエクスポートした**: `/etc/profile` などのファイルを読み取るのはログインシェルのみです。そこで `export` した値は、ログインシェルから起動した Claude Code には届きます。Desktop はログインシェル経由で Claude Code を起動しないため、Desktop SSH セッションには届きません。473* **`/etc/profile` など、ログインシェルのみが読み取るファイルでエクスポートした**: ログインシェルから `claude` を実行した場合は名前が届きますが、Desktop SSH セッションでは届きません。Desktop はログインシェル経由で Claude Code を起動しません。代わりに、リモートマシン上の[管理設定ファイル](https://code.claude.com/docs/ja/desktop.md#managed-settings)の `env` で変数を設定してください。

474* **値の中にスペースが含まれている**: この場合、Claude Code はどのキーもイベントやデータポイントにコピーせず、エラーも報告しません。[値からスペースを取り除いてください](#multi-team-organization-support)。474* **値の中にスペースが含まれている**: この場合、Claude Code はどのキーもイベントやデータポイントにコピーせず、エラーも報告しません。[値からスペースを取り除いてください](#multi-team-organization-support)。

475* **他の何かがすでにこの変数を設定している**: デスクトップアプリが開始するセッションでは、起動環境ですでに設定されている変数が[設定ファイルより優先されます](https://code.claude.com/docs/ja/settings-reference.md#how-env-values-interact-with-your-shell)。[デバッグログ](https://code.claude.com/docs/ja/debug-your-config.md)には、無視された各変数の名前が記録されます。サードパーティの Desktop デプロイが、提供する環境で [OTLP エンドポイントを指定している](#how-managed-settings-lock-the-otlp-destination)場合、その環境には Desktop 独自の `OTEL_RESOURCE_ATTRIBUTES` が含まれます。475* **他の何かがすでにこの変数を設定している**: デスクトップアプリが開始するセッションでは、起動環境ですでに設定されている変数が[設定ファイルより優先されます](https://code.claude.com/docs/ja/settings-reference.md#how-env-values-interact-with-your-shell)。[デバッグログ](https://code.claude.com/docs/ja/debug-your-config.md)には、無視された各変数の名前が記録されます。サードパーティの Desktop デプロイが、提供する環境で [OTLP エンドポイントを指定している](#how-managed-settings-lock-the-otlp-destination)場合、その環境には Desktop 独自の `OTEL_RESOURCE_ATTRIBUTES` が含まれます。

476 476 

1403* `pre_tokens`: 圧縮前のおおよそのトークン数1403* `pre_tokens`: 圧縮前のおおよそのトークン数

1404* `post_tokens`: 圧縮後のおおよそのトークン数1404* `post_tokens`: 圧縮後のおおよそのトークン数

1405* `error`: 圧縮が失敗した場合のエラーメッセージ1405* `error`: 圧縮が失敗した場合のエラーメッセージ

1406* `precompute_reuse`: `trigger` が `"manual"` の場合、または `trigger` を `"auto"` として報告する[アイドル時の圧縮](https://code.claude.com/docs/ja/settings-reference.md#idlecompaction)の場合にのみ設定されます。自動圧縮では、コンテキストウィンドウが埋まる前にバックグラウンドで要約を準備できます。この属性は、圧縮がその準備済みの要約を再利用したかどうかを記録します。`"hit"` は再利用されたことを意味し、`"miss_custom_instructions"`、`"miss_hook"`、`"miss_not_ready"` は代わりに新しい要約が計算された理由を示します1406* `precompute_reuse`: `trigger` が `"manual"` の場合、またはインタラクティブなターミナルセッションでの[アイドル時の圧縮](https://code.claude.com/docs/ja/settings-reference.md#idlecompaction)で `trigger` が `"auto"` の場合にのみ設定されます。自動圧縮では、コンテキストウィンドウがいっぱいになる前にバックグラウンドで要約を準備できます。この属性は、圧縮がその準備済みの要約を再利用したかどうかを記録します。`"hit"` は再利用されたことを意味し、`"miss_custom_instructions"`、`"miss_hook"`、`"miss_not_ready"` は代わりに新しい要約が計算された理由を示します

1407 1407 

1408#### Subagent completed event1408#### Subagent completed event

1409 1409 

248 248 

249**Web and mobile**249**Web and mobile**

250 250 

251[claude.ai/code](https://claude.ai/code) では、プロンプトボックスの横にあるモードドロップダウンを使用します。モバイルアプリでは、プロンプトボックスの **+** ボタンをタップし、次に **Permission** をタップします。クラウドセッションと Remote Control セッションでは、提供される権限モードが異なります。251[claude.ai/code](https://claude.ai/code) では、プロンプトボックスの下の行にあるモードドロップダウンを使用します。モバイルアプリでは、プロンプトボックスの **+** ボタンをタップし、次に **Permission** をタップします。クラウドセッションと Remote Control セッションでは、提供される権限モードが異なります。

252 252 

253* **[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)**：Accept edits、Plan、Auto。Accept edits は `default` モードに対応します。クラウドセッションはモードに関係なくファイル編集を事前承認するため、ドロップダウンは Manual の代わりに Accept edits を表示します。クラウドセッションは設定からの `defaultMode: "acceptEdits"` を引き続き尊重します。Auto モードは組織がそれを許可し、選択されたモデルがそれをサポートする場合にのみ表示されます。Bypass permissions は利用できません。253* **[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)**：Accept edits、Plan、Auto。Accept edits は `default` モードに対応します。クラウドセッションはモードに関係なくファイル編集を事前承認するため、ドロップダウンは Manual の代わりに Accept edits を表示します。クラウドセッションは設定からの `defaultMode: "acceptEdits"` を引き続き尊重します。Auto モードは組織がそれを許可し、選択されたモデルがそれをサポートする場合にのみ表示されます。Bypass permissions は利用できません。

254* **ローカルマシンの [Remote Control](https://code.claude.com/docs/ja/remote-control.md) セッション**：自分で開始したセッションの場合は Manual、Accept edits、Plan、Auto を使用でき、アプリから Bypass permissions を選択することはできません。Auto を使用するには、セッションが auto モードの[利用要件](#eliminate-prompts-with-auto-mode)を満たしている必要があります。コンピューター上で実行されるプロジェクトスレッドについては、[スレッドを自分のコンピューター上で実行する](https://code.claude.com/docs/ja/claude-projects.md#run-a-thread-on-your-own-computer)を参照してください。254* **ローカルマシンの [Remote Control](https://code.claude.com/docs/ja/remote-control.md) セッション**：自分で開始したセッションの場合は Manual、Accept edits、Plan、Auto を使用でき、アプリから Bypass permissions を選択することはできません。Auto を使用するには、セッションが auto モードの[利用要件](#eliminate-prompts-with-auto-mode)を満たしている必要があります。コンピューター上で実行されるプロジェクトスレッドについては、[スレッドを自分のコンピューター上で実行する](https://code.claude.com/docs/ja/claude-projects.md#run-a-thread-on-your-own-computer)を参照してください。

584 584 

585モニターのコマンドには、起動する場所と参照できる内容に制限があります。585モニターのコマンドには、起動する場所と参照できる内容に制限があります。

586 586 

587* **対話セッションのみ**: プラグインのモニターは対話セッションで起動し、`-p` フラグを使用した非対話モードでは決して起動しません。また、API プロバイダーやテレメトリの設定によって [Monitor ツール](https://code.claude.com/docs/ja/tools-reference.md#monitor-tool)が使用できないセッションでも起動しません587* **対話セッションのみ**: プラグインのモニターは、`-p` フラグを使用した非対話モードでは起動しません

588* **最小バージョン**: Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry のいずれかを使用している場合、または `DISABLE_TELEMETRY` か `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が設定されている場合、モニターには Claude Code v2.1.310 以降が必要です。この要件は[機能フラグの取得](https://code.claude.com/docs/ja/env-vars.md#features-that-need-feature-flag-fetching)がオフの場合に適用されます

588* **ユーザー設定は使用不可**: `command` は[パス変数](#path-variables-and-persistent-data)と環境からの `${ENV_VAR}` を取得しますが、`${user_config.*}` は決して取得しません。これを参照するモニターは起動せず、モニタープロセスは `CLAUDE_PLUGIN_OPTION_<KEY>` も受け取りません589* **ユーザー設定は使用不可**: `command` は[パス変数](#path-variables-and-persistent-data)と環境からの `${ENV_VAR}` を取得しますが、`${user_config.*}` は決して取得しません。これを参照するモニターは起動せず、モニタープロセスは `CLAUDE_PLUGIN_OPTION_<KEY>` も受け取りません

589* **セッション途中での無効化**: セッションの途中でプラグインを無効にしても、Claude Code はすでに実行中のモニターを停止しません。モニターはセッションの終了時に停止します590* **セッション途中での無効化**: セッションの途中でプラグインを無効にしても、Claude Code はすでに実行中のモニターを停止しません。モニターはセッションの終了時に停止します

590 591 

647 648 

648データディレクトリパスでは、`<id>` はプラグイン識別子で、文字、数字、`_`、`-` 以外のすべての文字が `-` に置き換わるため、`my-plugin@my-marketplace` は `my-plugin-my-marketplace` になります。649データディレクトリパスでは、`<id>` はプラグイン識別子で、文字、数字、`_`、`-` 以外のすべての文字が `-` に置き換わるため、`my-plugin@my-marketplace` は `my-plugin-my-marketplace` になります。

649 650 

650Windows では、置換されたパスはシェルがバックスラッシュをエスケープとして読み込まないように前方スラッシュを使用します。651Windows では、置換されたパスのほとんどは `C:/Users/you/...` のように前方スラッシュを使用します。[exec 形式のフック](https://code.claude.com/docs/ja/hooks.md#exec-form-and-shell-form)と、PowerShell を通じて実行されるフック（Git Bash がインストールされていない場合の Windows のデフォルトシェル）では、ネイティブのバックスラッシュが維持されます。

651 652 

652### データディレクトリに依存関係をインストールする653### データディレクトリに依存関係をインストールする

653 654 

670}671}

671```672```

672 673 

673最初のセッションの後、`~/.claude/plugins/data/<id>/node_modules` が存在します。MCP サーバーは `NODE_PATH` を `${CLAUDE_PLUGIN_DATA}/node_modules` に設定できます。どのフィールドがどの変数を置換するかについては、[環境変数](https://code.claude.com/docs/ja/plugins/manifest-reference.md#environment-variables)を参照してください。674最初のセッションの後、`~/.claude/plugins/data/<id>/node_modules` が存在します。MCP サーバーは、その `env` で `NODE_PATH` を `${CLAUDE_PLUGIN_DATA}/node_modules` に設定できます。どのフィールドがどの変数を置換するかについては、[環境変数](https://code.claude.com/docs/ja/plugins/manifest-reference.md#environment-variables)を参照してください。

674 675 

675## 次のステップ676## 次のステップ

676 677 

148 148 

1492 つの名前が異なり、誰かがマニフェスト名でインストールすると、Claude Code は `Plugin "<manifest-name>" not found in marketplace "<marketplace>"` を報告します。2 つの名前を同じに保ちます。Claude Code が 2 つの名前をどのように使用するかについての詳細については、[プラグイン読み込みリファレンス](https://code.claude.com/docs/ja/plugins/loading.md#find-where-a-plugin-came-from)を参照してください。1492 つの名前が異なり、誰かがマニフェスト名でインストールすると、Claude Code は `Plugin "<manifest-name>" not found in marketplace "<marketplace>"` を報告します。2 つの名前を同じに保ちます。Claude Code が 2 つの名前をどのように使用するかについての詳細については、[プラグイン読み込みリファレンス](https://code.claude.com/docs/ja/plugins/loading.md#find-where-a-plugin-came-from)を参照してください。

150 150 

151### 使用しないサブモジュールをクローンに含めない

152 

153誰かがマーケットプレイスを追加すると、Claude Code はリポジトリをクローンし、プラグインファイルを含む git サブモジュールのみを取得します。Claude Code v2.1.295 以降が必要です。

154 

155Claude Code がどのサブモジュールを取得するかは、各プラグインを配置する場所によって決まります：

156 

157* **サブディレクトリ内のプラグイン**：Claude Code は、プラグインのディレクトリ内にあるサブモジュールと、プラグインを含むサブモジュールを取得します。プラグインが必要とするサブモジュールはプラグインのディレクトリ内に置き、必要としないサブモジュールはその外に置いてください

158* **マーケットプレイスルートにあるプラグイン**：プラグインのファイルのいずれかがいずれかのサブモジュール内のパスを参照すると、Claude Code はリポジトリ内のすべてのサブモジュールを取得します。ビルドでのみ使用する大きなサブモジュールがリポジトリにある場合は、プラグインをサブディレクトリに移動してください

159 

160ルートにあるプラグインがサブモジュール内のファイルを実行する場合は、`${CLAUDE_PLUGIN_ROOT}/vendor/tool/run.sh` のように、プラグインのフックまたはサーバー設定にそのファイルのパスを明示的に記述してください。Claude Code はこれらのパスを読み取り、プラグインがサブモジュールを必要とするかどうかを判断します。スクリプトが実行中に組み立てるパスは認識できません。

161 

162完全なルールについては、[マーケットプレイスリポジトリ内の Git サブモジュール](https://code.claude.com/docs/ja/plugins/marketplace-reference.md#git-submodules-in-the-marketplace-repository)を参照してください。

163 

151## プラグインソースを選択する164## プラグインソースを選択する

152 165 

153`marketplace.json` の各プラグインエントリには、Claude Code がそのプラグインを取得する場所を指示する `source` があります。プラグインのファイルが保存されている場所によってソースを選択します。テーブルはマーケットプレイス所有者が最も使用するソースをリストアップします。166`marketplace.json` の各プラグインエントリには、Claude Code がそのプラグインを取得する場所を指示する `source` があります。プラグインのファイルが保存されている場所によってソースを選択します。テーブルはマーケットプレイス所有者が最も使用するソースをリストアップします。

111各プロトコルがマシンで必要とするものをユーザーに伝えてください：111各プロトコルがマシンで必要とするものをユーザーに伝えてください：

112 112 

113* **SSH**：キーはパスフレーズプロンプトなしで機能する必要があります。例えば `ssh-agent` に読み込まれているため。ホストは既に `known_hosts` にある必要があります。113* **SSH**：キーはパスフレーズプロンプトなしで機能する必要があります。例えば `ssh-agent` に読み込まれているため。ホストは既に `known_hosts` にある必要があります。

114* **HTTPS**：Claude Code はユーザーの git 認証情報ヘルパーを有効にしたままにしますが、プロンプトを禁止します。ヘルパーが既に保存している認証情報は機能します。要求する必要があるものは失敗します。GitHub では、`gh auth login` の後に `gh auth setup-git` を実行すると、認証情報が保存されます。114* **HTTPS**：Claude Code はユーザーの git 認証情報ヘルパーを有効にしたままにしますが、プロンプトを禁止し、`GIT_ASKPASS` で設定されたものなどの askpass プログラムも実行しません。ヘルパーが既に保存している認証情報は機能します。要求する必要があるものは失敗します。GitHub では、`gh auth login` の後に `gh auth setup-git` を実行すると、認証情報が保存されます。

115 115 

116GitHub Enterprise Server ホストの場合、ユーザーはマシンからそのホストへの git アクセスが必要です。[GHES 上のプラグインマーケットプレイス](https://code.claude.com/docs/ja/github-enterprise-server.md#plugin-marketplaces-on-ghes)を参照して、各 Claude Code サーフェスが GHES ホストマーケットプレイスに到達するために必要なものを確認してください。116GitHub Enterprise Server ホストの場合、ユーザーはマシンからそのホストへの git アクセスが必要です。[GHES 上のプラグインマーケットプレイス](https://code.claude.com/docs/ja/github-enterprise-server.md#plugin-marketplaces-on-ghes)を参照して、各 Claude Code サーフェスが GHES ホストマーケットプレイスに到達するために必要なものを確認してください。

117 117 

238 238 

239プライベートマーケットプレイスは、GitHub または他の git ホスト上の、クローンするために認証情報が必要なリポジトリ内のマーケットプレイスです。公開マーケットプレイスと同じ `/plugin marketplace add` または `claude plugin marketplace add` コマンドで追加します。Claude Code はマシンに既にある git 認証情報でそれをクローンし、プロンプトを表示しません。そのため、各接続方法には要件があります。239プライベートマーケットプレイスは、GitHub または他の git ホスト上の、クローンするために認証情報が必要なリポジトリ内のマーケットプレイスです。公開マーケットプレイスと同じ `/plugin marketplace add` または `claude plugin marketplace add` コマンドで追加します。Claude Code はマシンに既にある git 認証情報でそれをクローンし、プロンプトを表示しません。そのため、各接続方法には要件があります。

240 240 

241* **HTTPS**: git 認証情報ヘルパーが適用されるため、`gh auth login`、macOS Keychain、または `git-credential-store` で設定したアクセスが機能します。対話的なプロンプトは抑制されるため、認証したことのないホストはパスワードを求める代わりに失敗します。241* **HTTPS**: git 認証情報ヘルパーが適用されるため、`gh auth login`、macOS Keychain、または `git-credential-store` で設定したアクセスが機能します。Git のプロンプトと askpass プログラムは、`GIT_ASKPASS` で設定したものも含めて無効になっているため、git が認証情報を求める必要がある場合、クローンはプロンプトを表示する代わりに失敗します。

242* **SSH**: ホストは既に `known_hosts` ファイルに含まれている必要があり、キーはパスフレーズプロンプトなしで機能する必要があります。ホストフィンガープリントとパスフレーズプロンプトも抑制されるため。242* **SSH**: ホストは既に `known_hosts` ファイルに含まれている必要があり、キーはパスフレーズプロンプトなしで機能する必要があります。git の設定で `GIT_SSH_COMMAND`、`GIT_SSH`、または git config の `core.sshCommand` に SSH プログラムが指定されている場合、Claude Code はそのプログラムを実行します。

243* **GitHub `owner/repo` 短縮形**: Claude Code は SSH キーが `github.com` に認証するかどうかを確認し、認証する場合は SSH でクローンし、認証しない場合は HTTPS でクローンします。[`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](https://code.claude.com/docs/ja/env-vars#variables)を設定して、そのチェックをスキップし、常に HTTPS でクローンします。243* **GitHub `owner/repo` 短縮形**: Claude Code は SSH キーが `github.com` に認証するかどうかを確認し、認証する場合は SSH でクローンし、認証しない場合は HTTPS でクローンします。[`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](https://code.claude.com/docs/ja/env-vars#variables)を設定して、そのチェックをスキップし、常に HTTPS でクローンします。

244 244 

245同じ認証情報は、`/plugin install`、`/plugin marketplace update`、および `claude plugin update` を実行するときに適用されます。245同じ認証情報は、`/plugin install`、`/plugin marketplace update`、および `claude plugin update` を実行するときに適用されます。

41* **設定が宣言しているが `known_marketplaces.json` に欠けているマーケットプレイス**: Claude Code はそれをクローンし、プラグインを再度読み込み、キャッシュされていない有効なプラグインをダウンロードします41* **設定が宣言しているが `known_marketplaces.json` に欠けているマーケットプレイス**: Claude Code はそれをクローンし、プラグインを再度読み込み、キャッシュされていない有効なプラグインをダウンロードします

42* **宣言されたマーケットプレイスのソースが設定で変更された場合**: Claude Code は新しいソースから再度フェッチし、`Plugins changed. Run /reload-plugins to activate.` を表示します42* **宣言されたマーケットプレイスのソースが設定で変更された場合**: Claude Code は新しいソースから再度フェッチし、`Plugins changed. Run /reload-plugins to activate.` を表示します

43 43 

44どちらのパスもフェッチしておらず、使用可能なキャッシュディレクトリがない有効なプラグインは、`/plugin` **Errors** タブに `Plugin "<name>" not cached at <path>` を表示し、`claude plugin list` は同じ行に `— run /plugin to refresh` を追加します。修正については、[`Plugin "<name>" not cached at <path>`](https://code.claude.com/docs/ja/plugins/troubleshooting#plugin-not-cached-at)を参照してください。44どちらのパスもフェッチしておらず、使用可能なキャッシュディレクトリがない有効なプラグインは、`/plugin` **Errors** タブに `Plugin "<name>" not cached at <path>` を表示します。修正については、[`Plugin "<name>" not cached at <path>`](https://code.claude.com/docs/ja/plugins/troubleshooting#plugin-not-cached-at)を参照してください。

45 45 

46## プラグインがどこから来たかを見つける46## プラグインがどこから来たかを見つける

47 47 

155| `workflows` | Path, or array of paths | [ワークフロー](https://code.claude.com/docs/ja/workflows.md#distribute-a-workflow-in-a-plugin) `.js` ファイルまたはディレクトリ。デフォルトの `workflows/` スキャンを置き換えます |155| `workflows` | Path, or array of paths | [ワークフロー](https://code.claude.com/docs/ja/workflows.md#distribute-a-workflow-in-a-plugin) `.js` ファイルまたはディレクトリ。デフォルトの `workflows/` スキャンを置き換えます |

156| `experimental` | Object | `themes`、`monitors`、`evals` のコンテナ。マニフェスト形状はまだ変わる可能性があります |156| `experimental` | Object | `themes`、`monitors`、`evals` のコンテナ。マニフェスト形状はまだ変わる可能性があります |

157| `experimental.themes` | Path, or array of paths | テーマファイルまたはディレクトリ。デフォルトの `themes/` スキャンを置き換えます。トップレベルの `themes` キーはまだ読み込まれ、`claude plugin validate` 警告が表示されます |157| `experimental.themes` | Path, or array of paths | テーマファイルまたはディレクトリ。デフォルトの `themes/` スキャンを置き換えます。トップレベルの `themes` キーはまだ読み込まれ、`claude plugin validate` 警告が表示されます |

158| [`experimental.monitors`](#monitors) | Path, or inline array | monitors 配列を保持する `.json` ファイル、または配列自体。デフォルトは `monitors/monitors.json`。トップレベルの `monitors` キーはまだ読み込まれ、`claude plugin validate` 警告が表示されます。モニターはインタラクティブセッションでのみ実行され、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では実行されません |158| [`experimental.monitors`](#monitors) | Path, or inline array | monitors 配列を保持する `.json` ファイル、または配列自体。デフォルトは `monitors/monitors.json`。トップレベルの `monitors` キーはまだ読み込まれ、`claude plugin validate` 警告が表示されます。モニターは [`-p` フラグでは起動しません](https://code.claude.com/docs/ja/plugins/components#monitors) |

159| `experimental.evals` | Path, or array of paths | デフォルトが `evals/` でない場合、プラグインの[eval ケース](https://code.claude.com/docs/ja/plugin-evals.md#use-a-different-eval-directory)を保持するディレクトリ。`claude plugin eval --eval-dir` はそれをオーバーライドします |159| `experimental.evals` | Path, or array of paths | デフォルトが `evals/` でない場合、プラグインの[eval ケース](https://code.claude.com/docs/ja/plugin-evals.md#use-a-different-eval-directory)を保持するディレクトリ。`claude plugin eval --eval-dir` はそれをオーバーライドします |

160 160 

161型列では、パスはプラグインルートに相対する文字列です（例：`"./custom/commands"`）。161型列では、パスはプラグインルートに相対する文字列です（例：`"./custom/commands"`）。

606}606}

607```607```

608 608 

609Windows では、置き換えられたパスはフォワードスラッシュを使用するため、シェルはバックスラッシュをエスケープとして読み込みません。609Windows では、置き換えられたパスのほとんどは `C:/Users/you/...` のようにフォワードスラッシュを使用します。[exec 形式のフック](https://code.claude.com/docs/ja/hooks.md#exec-form-and-shell-form)と、PowerShell を通じて実行されるフックでは、ネイティブのバックスラッシュがそのまま保持されます。PowerShell は、Git Bash がインストールされていない場合の Windows のデフォルトシェルです。

610 610 

611## 標準レイアウト611## 標準レイアウト

612 612 

172* **`url`**: Claude Code は `marketplace.json` のみを取得するため、相対パスは解決できません。各プラグインに `github` や `git-subdir` などのオブジェクトソースを指定してください。172* **`url`**: Claude Code は `marketplace.json` のみを取得するため、相対パスは解決できません。各プラグインに `github` や `git-subdir` などのオブジェクトソースを指定してください。

173* **`settings`**: 相対パスは完全に拒否されます。173* **`settings`**: 相対パスは完全に拒否されます。

174 174 

175#### マーケットプレイスリポジトリ内の Git サブモジュール

176 

177Claude Code はマーケットプレイスリポジトリをクローンするとき、プラグインファイルを保持する git サブモジュールのみを取得します。Claude Code v2.1.295 以降が必要です。

178 

179それより前のバージョンでは、ネストされたものを含むすべてのサブモジュールを取得します。リポジトリに大きなサブモジュールがある場合、Claude Code はその取得中に[クローンタイムアウト](https://code.claude.com/docs/ja/plugins/troubleshooting.md#git-clone-timed-out-after-120s)を超過することがあります。

180 

181`./plugins/formatter` のようなサブディレクトリ内のプラグインの場合、Claude Code は次の場合にサブモジュールを取得します。

182 

183* **プラグインがサブモジュール内にある**: サブモジュールがプラグインのディレクトリ、またはその上位のディレクトリである

184* **サブモジュールがプラグイン内にある**: サブモジュールがプラグインのディレクトリ配下のいずれかの場所にある

185* **シンボリックリンクがサブモジュール内を指している**: リポジトリにコミットされたリンクのターゲットがサブモジュール内にある

186 

187`"source": "./"` でマーケットプレイスルートにあるプラグインは、リポジトリ内のすべてのサブモジュールを取得するか、まったく取得しないかのどちらかです。以下のいずれかがいずれかのサブモジュール内を指している場合、Claude Code はすべてのサブモジュールを取得します。

188 

189* **コンポーネントディレクトリ**: ルートにあるプラグインコンポーネントを保持するディレクトリ（`skills/`、`hooks/`、`bin/` など）

190* **プラグインの設定内のパス**: プラグインのマーケットプレイスエントリ、その `plugin.json`、または `.mcp.json` や `hooks/hooks.json` などの設定ファイル内のパス

191* **シンボリックリンク**: リポジトリにコミットされたリンク

192* **プラグインのファイル内のテキスト**: 設定ファイルまたはコンポーネントディレクトリ配下のファイルに記述された、`vendor/tool` のようなサブモジュールのパス

193 

194いずれも該当しない場合、Claude Code はそのプラグインのサブモジュールを取得しません。プロジェクトでありプラグインでもあるリポジトリには、プロジェクトのビルドでのみ使用されるサブモジュールがあることが多く、このルールによってそれらは除外されます。

195 

196また、どのサブモジュールがプラグインファイルを保持しているかを判断できない場合にも、Claude Code はすべてのサブモジュールを取得します。例えば次のような場合です。

197 

198* **ルートにある `SKILL.md`**: この場合、リポジトリ全体が 1 つのスキルのディレクトリになります

199* **Claude Code が読み取れないファイル**: マーケットプレイスファイル、プラグインの設定ファイルのいずれか、または `.gitmodules`

200 

201`--sparse` を指定してマーケットプレイスを追加した場合、またはそのソースで `sparsePaths` が設定されている場合、Claude Code はそこで指定されたディレクトリのみをチェックアウトし、サブモジュールは取得しません。それより前のバージョンでも同様です。

202 

203プラグインが使用しないサブモジュールをクローンから除外するには、[未使用のサブモジュールをクローンから除外する](https://code.claude.com/docs/ja/plugins/create-marketplace.md#keep-unused-submodules-out-of-the-clone)を参照してください。

204 

175#### pluginRoot の下の裸の名前205#### pluginRoot の下の裸の名前

176 206 

177裸の名前は `/` を含まない単一のディレクトリ名です。例えば `"formatter"` です。`./` パスの代わりに裸の名前を記述するには、[`metadata.pluginRoot`](#top-level-fields)をそれらが解決するディレクトリに設定します。`"pluginRoot": "./plugins"` の場合、`"source": "formatter"` は `./plugins/formatter` に解決されます。Claude Code v2.1.239 以降が必要です。207裸の名前は `/` を含まない単一のディレクトリ名です。例えば `"formatter"` です。`./` パスの代わりに裸の名前を記述するには、[`metadata.pluginRoot`](#top-level-fields)をそれらが解決するディレクトリに設定します。`"pluginRoot": "./plugins"` の場合、`"source": "formatter"` は `./plugins/formatter` に解決されます。Claude Code v2.1.239 以降が必要です。

313 313 

314#### 拒否された呼び出しが返すもの314#### 拒否された呼び出しが返すもの

315 315 

316結果内の `<reason>` は `the session was stopped and nobody has sent input since` を表します。316結果内の `<reason>` は、呼び出しが拒否された理由を表します。中断後の場合、それは `the session was stopped and nobody has sent input since` です。その他の理由については、[`claude -p` 実行と Agent SDK セッションで拒否される呼び出し](#calls-refused-in-non-interactive-runs)を参照してください。

317 317 

318| 拒否される呼び出しの例 | ユーザーの次の入力までの結果 |318| 拒否される呼び出しの例 | 結果 |

319| :- | :- |319| :- | :- |

320| `$.prompt.submit` | `{ drop: '<reason>' }` で解決し、プロンプトをキューに入れません |320| `$.prompt.submit` | `{ drop: '<reason>' }` で解決し、プロンプトをキューに入れません |

321| `$.command.run` | メッセージが `<reason>` で終わるエラーで reject します |321| `$.command.run` | メッセージが `<reason>` で終わるエラーで reject します |

324| [エージェントチーム](https://code.claude.com/docs/ja/agent-teams.md)のチームメイトへの `$.session.send` | `{ isDelivered: false, reason: 'Teammate "<name>" was not messaged: <reason>.' }` で解決します。`<name>` はチームメイトの名前です |324| [エージェントチーム](https://code.claude.com/docs/ja/agent-teams.md)のチームメイトへの `$.session.send` | `{ isDelivered: false, reason: 'Teammate "<name>" was not messaged: <reason>.' }` で解決します。`<name>` はチームメイトの名前です |

325| `run_in_background: true` を指定した Bash、Monitor、または CronCreate の [`$.tool.call`](https://code.claude.com/docs/ja/plugins/mods/reference#mods-api-methods) | `{ deny: '<tool> was not run: it starts background work, a schedule or a goal, and <reason>' }` で解決します。`<tool>` はツールの名前です |325| `run_in_background: true` を指定した Bash、Monitor、または CronCreate の [`$.tool.call`](https://code.claude.com/docs/ja/plugins/mods/reference#mods-api-methods) | `{ deny: '<tool> was not run: it starts background work, a schedule or a goal, and <reason>' }` で解決します。`<tool>` はツールの名前です |

326 326 

327これらの `$.session.send` と `$.tool.call` の結果に加えて、ユーザーには [`Stopped:` トースト](https://code.claude.com/docs/ja/plugins/mods/troubleshoot#stopped-type-a-message-to-continue)が表示されることがあります。327対話型セッションで中断後にこれらの `$.session.send` または `$.tool.call` の呼び出しが拒否された場合、ユーザーには [`Stopped:` トースト](https://code.claude.com/docs/ja/plugins/mods/troubleshoot#stopped-type-a-message-to-continue)が表示されることがあります。

328 328 

329#### 中断前に mod が開始した作業329#### 中断前に mod が開始した作業

330 330 

341 341 

342ユーザーの次の入力より前にスケジュールされたジョブが実行時刻になるか、モニターがイベントを発生させた場合、ユーザーには [`Stopped:` トースト](https://code.claude.com/docs/ja/plugins/mods/troubleshoot#stopped-type-a-message-to-continue)が表示されることがあります。342ユーザーの次の入力より前にスケジュールされたジョブが実行時刻になるか、モニターがイベントを発生させた場合、ユーザーには [`Stopped:` トースト](https://code.claude.com/docs/ja/plugins/mods/troubleshoot#stopped-type-a-message-to-continue)が表示されることがあります。

343 343 

344### `claude -p` 実行と Agent SDK セッションで拒否される呼び出し

345 

346`claude -p` 実行または [Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md) セッションでは、`{ drop: 'the run reached its --max-turns limit' }` のような結果は、実行が mod の呼び出しを拒否したことを意味します。

347 

348拒否された `$.prompt.submit` は `{ drop: '<reason>' }` で解決します。`$.command.run` や `$.agent.spawn` など、その他の拒否された呼び出しは、[拒否された呼び出しが返すもの](#what-refused-calls-return)に示す結果を返し、`<reason>` の部分に理由が入ります。以下で該当する `<reason>` を見つけ、対処方法を確認してください。

349 

350* **`the run reached its --max-turns limit`**: mod のプロンプトによるターンと、mod が生成したサブエージェントのターンは、[`--max-turns`](https://code.claude.com/docs/ja/cli-reference#cli-flags) または Agent SDK の[ターン制限](https://code.claude.com/docs/ja/agent-sdk/configuration.md#limit-turns-and-spend)にカウントされます。より多くのターンが必要な場合は、より高い制限で実行を開始してください。それができない場合は、拒否された呼び出しを行わないよう mod を変更してください。実行がユーザーまたは SDK アプリケーションから別のプロンプトを受け取ると、ターン数はリセットされ、実行は再び呼び出しを受け付けます。

351* **`the run is past its --max-budget-usd limit`**: より高い `--max-budget-usd` で実行を開始するか、Agent SDK の[支出制限](https://code.claude.com/docs/ja/agent-sdk/configuration.md#limit-turns-and-spend)を引き上げてください。それができない場合は、拒否された呼び出しを行わないよう mod を変更してください。この制限は、実行のこれまでの合計コストに適用されます。実行が別のプロンプトを受け取っても合計は加算され続けるため、再試行しても同じ理由が返ります。

352* **`the host has ended its input`**: たとえば、SDK アプリケーションが[ストリーミング入力](https://code.claude.com/docs/ja/agent-sdk/streaming-vs-single-mode.md)を終了した場合や、[`--input-format stream-json`](https://code.claude.com/docs/ja/cli-reference#cli-flags) で開始した実行で stdin が閉じた場合です。実行は終了しつつあり、それ以上の入力を受け付けないため、再試行しても同じ理由が返ります。拒否された呼び出しを行わないよう mod を変更してください。自分で実行を開始する場合は、次回から mod が行う呼び出しがなくなるまでその入力を開いたままにしてください。

353* **`the session was stopped and nobody has sent input since`**: 実行が[中断](#calls-and-background-work-after-the-user-interrupts-a-turn)されました（たとえば Agent SDK の [`interrupt()`](https://code.claude.com/docs/ja/agent-sdk/typescript#query-object) によって）。ユーザーまたは SDK アプリケーションからの次のメッセージの後に再度呼び出しを行うには、[拒否またはドロップされた呼び出しを再試行する](#retry-a-refused-or-dropped-call)の手順に従ってください。

354 

355### mod を使用した `claude -p` 実行が終了しない

356 

357mod がターンの終了ごとにプロンプトを送信すると、各プロンプトが別のターンを開始します。[`--max-turns`](https://code.claude.com/docs/ja/cli-reference#cli-flags) または `--max-budget-usd` がない場合、その mod を読み込む `claude -p` 実行は、自分で停止するまで続きます。

358 

359実行が自動的に終了するようにするには、シェルでコマンドにいずれかのフラグを追加します。他のユーザーが実行を開始する場合は、作業が完了したらプロンプトの送信を停止するよう mod を変更してください。次のコマンドは `--max-turns` を追加します。

360 

361```bash theme={null}

362claude -p "find the TODOs" --max-turns 5

363```

364 

365実行がその制限に達すると、mod の次のプロンプトはターンを開始せずに[拒否](#calls-refused-in-non-interactive-runs)され、実行は終了します。

366 

367それでも実行が制限を超える場合は、シェルで `claude --version` を実行し、バージョンが v2.1.304 より前であれば [Claude Code を更新](https://code.claude.com/docs/ja/setup.md#update-claude-code)してください。mod のプロンプトは v2.1.299 以降、制限に達すると拒否されます。mod がサブエージェントを生成する場合、それらのターンは v2.1.304 以降 `--max-turns` にカウントされます。

368 

344## セッション間でメッセージを送受信する369## セッション間でメッセージを送受信する

345 370 

346mod は、自分の別のセッション、このセッションのサブエージェントの 1 つ、またはその[エージェントチーム](https://code.claude.com/docs/ja/agent-teams.md)のチームメイトにプレーンテキストメッセージを送信できます。また、到着して離れるメッセージを観察することもできます。371mod は、自分の別のセッション、このセッションのサブエージェントの 1 つ、またはその[エージェントチーム](https://code.claude.com/docs/ja/agent-teams.md)のチームメイトにプレーンテキストメッセージを送信できます。また、到着して離れるメッセージを観察することもできます。

390| `$.http` | `http` または `https` 上の `fetch(url, init)`。本文が読み込まれたら `{ status, ok, headers, text }` に解決。 |415| `$.http` | `http` または `https` 上の `fetch(url, init)`。本文が読み込まれたら `{ status, ok, headers, text }` に解決。 |

391| `$.store` | プラグイン独自の JSON キー値ストア、セッション間で保持 |416| `$.store` | プラグイン独自の JSON キー値ストア、セッション間で保持 |

392| `$.env` | 環境変数を `get` および `set`。名前をリテラル文字列として記述。 |417| `$.env` | 環境変数を `get` および `set`。名前をリテラル文字列として記述。 |

393| `$.settings` | 設定ファイルと管理ポリシーが保持するものを `read` |418| `$.settings` | `read()` はすべての設定を 1 つのオブジェクトにマージしたものに解決。`{ source }` または `{ key }` を指定すると、代わりに[1 つのソースの設定または 1 つのキーの値](#read-one-source-or-one-key)に解決。 |

394| `$.session` | `messages()` はトランスクリプトを `{ role, text, toolUses }` のリストとして返す。また、作業ディレクトリ、モデルなど。[`usage()`](https://code.claude.com/docs/ja/plugins/mods/reference#mods-api-methods) はコンテキストウィンドウの使用とプラン制限を返す。 |419| `$.session` | `messages()` はトランスクリプトを `{ role, text, toolUses }` のリストとして返す。また、作業ディレクトリ、モデルなど。[`usage()`](https://code.claude.com/docs/ja/plugins/mods/reference#mods-api-methods) はコンテキストウィンドウの使用とプラン制限を返す。 |

395| `$.mcp` | 接続された MCP サーバーのツールを `call` |420| `$.mcp` | 接続された MCP サーバーのツールを `call` |

396 421 

408* **`$.process.spawn started, and a plugin withheld its result:`**：拒否した mod がコマンドの出力を最後まで読み取っていなかった。コマンドがまだ実行中の場合、Claude Code はコマンドを停止する。433* **`$.process.spawn started, and a plugin withheld its result:`**：拒否した mod がコマンドの出力を最後まで読み取っていなかった。コマンドがまだ実行中の場合、Claude Code はコマンドを停止する。

409* **`$.process.spawn ran, and a plugin withheld its result:`**：拒否した mod がコマンドの出力を最後まで読み取っていたため、コマンドはすでに終了していた434* **`$.process.spawn ran, and a plugin withheld its result:`**：拒否した mod がコマンドの出力を最後まで読み取っていたため、コマンドはすでに終了していた

410 435 

436### すべての設定、1 つのソース、または 1 つのキーを読み取る

437 

438`$.settings.read()` は、使用中のすべてのソースの設定を[優先順位](https://code.claude.com/docs/ja/settings.md#settings-precedence)に従ってマージした 1 つのオブジェクトに解決されます。代わりに 1 つのソースを読み取るには `{ source }` を、1 つのキーを読み取るには `{ key }` を渡します。両方を渡すこともできます。

439 

440| 呼び出し | 解決される値 |

441| :- | :- |

442| `$.settings.read()` | マージされた設定を 1 つのオブジェクトとして返す。そのトップレベルのキーは、`permissions` や `hooks` など、`settings.json` ファイルのキーと同じ。 |

443| `$.settings.read({ source: 'policy' })` | その 1 つのソースの設定を 1 つのオブジェクトとして返す。そのソースに設定がない場合は `{}` |

444| `$.settings.read({ key: 'spinnerTipsEnabled' })` | マージされた設定におけるそのキーの値。キーが設定されていない場合は `undefined` |

445| `$.settings.read({ key: 'spinnerTipsEnabled', source: 'user' })` | その 1 つのソースにおけるそのキーの値。そのソースで設定されていない場合は `undefined` |

446 

447`source` には、読み取る 1 つの設定ソースの名前を渡します。

448 

449* **`user`**：`~/.claude/settings.json`

450* **`project`**：`.claude/settings.json`

451* **`local`**：`.claude/settings.local.json`

452* **`flag`**：`--settings` で渡したもの、および SDK のインライン設定

453* **`policy`**：[管理設定](https://code.claude.com/docs/ja/managed-settings.md#how-claude-code-combines-managed-sources)

454 

455`key` には、1 つのトップレベルキーの正確な名前を渡します。ネストされたオブジェクトへのドット区切りのパスは指定できません。`key` 引数には Claude Code v2.1.304 以降が必要です。

456 

411## 次のステップ457## 次のステップ

412 458 

413* [イベントに反応する](https://code.claude.com/docs/ja/plugins/mods/events.md)：ツール呼び出し、プロンプト、ターンをフック459* [イベントに反応する](https://code.claude.com/docs/ja/plugins/mods/events.md)：ツール呼び出し、プロンプト、ターンをフック

48 48 

49要求したものを使用します。例のプロンプトの場合、現在のブランチ名がプロンプトボックスの上に表示されます。mod が期待したことをしない場合は、Claude に何を変更するかを伝えてください。mod は、そのファイルを変更するターンの終了時に再ロードされるため、Claude が終了するとすぐに変更を試すことができます。49要求したものを使用します。例のプロンプトの場合、現在のブランチ名がプロンプトボックスの上に表示されます。mod が期待したことをしない場合は、Claude に何を変更するかを伝えてください。mod は、そのファイルを変更するターンの終了時に再ロードされるため、Claude が終了するとすぐに変更を試すことができます。

50 50 

51mod の名前で始まるトランスクリプトの行に[変更がロードされなかった](https://code.claude.com/docs/ja/plugins/mods/troubleshoot.md#this-mods-change-didnt-load)と表示された場合は、Claude に修正を依頼する際に、その行を次のメッセージに貼り付けてください。貼り付けない限り、Claude はその行を確認できません。

52 

51### 他のセッションで mod を使用する53### 他のセッションで mod を使用する

52 54 

53Claude が書いた mod は、それを作成したセッションでのみロードされます。Claude Code は、そのセッションの mods フォルダを [`cleanupPeriodDays`](https://code.claude.com/docs/ja/settings-reference#cleanupperioddays) より古くなると削除します。mod を保持するには、mods フォルダからそのディレクトリを `~/mods/git-branch` などの自分の場所にコピーしてください。次に、ロード方法を選択します。55Claude が書いた mod は、それを作成したセッションでのみロードされます。Claude Code は、そのセッションの mods フォルダを [`cleanupPeriodDays`](https://code.claude.com/docs/ja/settings-reference#cleanupperioddays) より古くなると削除します。mod を保持するには、mods フォルダからそのディレクトリを `~/mods/git-branch` などの自分の場所にコピーしてください。次に、ロード方法を選択します。

93 93 

94## Claude の動作をフックする94## Claude の動作をフックする

95 95 

96これらのイベントを処理すると、ツール呼び出し、プロンプト、またはターンが発生した時点でそれを確認したり変更したりできます。すべてのイベントとフックが返せる値については、[イベントリファレンス](https://code.claude.com/docs/ja/plugins/mods/reference.md#events)を参照してください。96これらのイベントを処理すると、ツール呼び出し、プロンプト、ターン、または設定の読み取りが発生した時点でそれを確認したり変更したりできます。すべてのイベントとフックが返せる値については、[イベントリファレンス](https://code.claude.com/docs/ja/plugins/mods/reference.md#events)を参照してください。

97 97 

98### ツール呼び出しをガードまたは変更する98### ツール呼び出しをガードまたは変更する

99 99 

115 115 

116Claude が `git push --force` を試みると、フックが `next` を呼び出さないため、コマンドは実行されず、権限プロンプトも表示されません。Claude は `deny` のテキストをツールの結果として読むため、Claude が行動に移せる指示として書いてください。その他の Bash コマンドはすべて、mod がない場合と同じように実行されます。116Claude が `git push --force` を試みると、フックが `next` を呼び出さないため、コマンドは実行されず、権限プロンプトも表示されません。Claude は `deny` のテキストをツールの結果として読むため、Claude が行動に移せる指示として書いてください。その他の Bash コマンドはすべて、mod がない場合と同じように実行されます。

117 117 

118このフックが例外をスローするかタイムアウトした場合、Claude Code はフックをスキップし、コマンドは mod がない場合と同じように処理されます。代わりにコマンドを拒否するには、フックに [`.catch` ハンドラーを追加](#handle-a-hook-that-fails)してください。

119 

118ツールの実行後に処理を行うには、`await next(e)` を実行してから処理を行い、`next` が返したものを返します。このフックは、Claude が変更した各 `.mdx` ファイルを [`$.ui.log`](https://code.claude.com/docs/ja/plugins/mods/api#show-something-without-starting-a-turn) で記録します。これはトランスクリプトに薄い色の行を追加するもので、Claude はその行を読みません：120ツールの実行後に処理を行うには、`await next(e)` を実行してから処理を行い、`next` が返したものを返します。このフックは、Claude が変更した各 `.mdx` ファイルを [`$.ui.log`](https://code.claude.com/docs/ja/plugins/mods/api#show-something-without-starting-a-turn) で記録します。これはトランスクリプトに薄い色の行を追加するもので、Claude はその行を読みません：

119 121 

120```javascript theme={null}122```javascript theme={null}

177* **ユーザーが回答を入力する**：`$.ui.ask` は入力されたテキストに解決されます。フックはそれを `Run it` と比較するため、それ以外のテキストではコマンドが拒否されます。179* **ユーザーが回答を入力する**：`$.ui.ask` は入力されたテキストに解決されます。フックはそれを `Run it` と比較するため、それ以外のテキストではコマンドが拒否されます。

178* **誰も回答しない**：ユーザーが質問を閉じるか **Chat about this** を選んだ場合、および `claude -p` の実行では `$.ui.ask` が reject されるため、`catch` ブロックによって回答は `Refuse` のままになります180* **誰も回答しない**：ユーザーが質問を閉じるか **Chat about this** を選んだ場合、および `claude -p` の実行では `$.ui.ask` が reject されるため、`catch` ブロックによって回答は `Refuse` のままになります

179 181 

180待機は `$.ui.ask` などの mods API 呼び出しの中で行ってください。その時間はフックの[時間制限](https://code.claude.com/docs/ja/plugins/mods/reference.md#limits)に含まれないためです。自分で作成した promise を待つ時間は含まれます。Claude Code はタイムアウトしたフックをスキップするため、保留していたコマンドが実行されてしまいます。182待機は `$.ui.ask` などの mods API 呼び出しの中で行ってください。その時間はフックの[時間制限](https://code.claude.com/docs/ja/plugins/mods/reference.md#limits)に含まれないためです。自分で作成した promise を待つ時間は含まれます。

183 

184Claude Code はタイムアウトしたフックをスキップするため、保留していたコマンドが実行されてしまいます。代わりにコマンドを拒否するには、`on` が返す登録に [`.catch` ハンドラー](#handle-a-hook-that-fails)をチェーンしてください。このハンドラーは、フック内部の `catch` ブロックとは別のものです。

181 185 

182#### ユーザーに確認される前にツール呼び出しを承認または拒否する186#### ユーザーに確認される前にツール呼び出しを承認または拒否する

183 187 

207 211 

208* **`main` の場合**：ルールが `git push` を許可している場合でも、フックは `deny` を返します212* **`main` の場合**：ルールが `git push` を許可している場合でも、フックは `deny` を返します

209* **別のブランチの場合、および他のコマンドの場合**：呼び出しは mod がない場合と同じ決定を受けます213* **別のブランチの場合、および他のコマンドの場合**：呼び出しは mod がない場合と同じ決定を受けます

214* **フックが例外をスローするかタイムアウトした場合**：この場合も、呼び出しは mod がない場合と同じ決定を受けます。代わりに呼び出しを拒否するには、`{ decision: 'deny', reason: 'the reason' }` を返す [`.catch` ハンドラーを追加](#handle-a-hook-that-fails)してください。

210 215 

211フックはコマンドのテキストと照合するため、Claude へのリマインダーとして扱ってください。すべてのユーザーに対して `main` へのプッシュをブロックするには、Git ホストでブランチを保護してください。216フックはコマンドのテキストと照合するため、Claude へのリマインダーとして扱ってください。すべてのユーザーに対して `main` へのプッシュをブロックするには、Git ホストでブランチを保護してください。

212 217 

269 274 

270`open a PR for this change` などのプロンプトを送信すると、トランスクリプト上のメッセージは変わらず、Claude はその後に `Current branch: feature/auth` のような行も読みます。プルリクエストに言及しないプロンプトは変更されずに送信され、`git` は実行されません。275`open a PR for this change` などのプロンプトを送信すると、トランスクリプト上のメッセージは変わらず、Claude はその後に `Current branch: feature/auth` のような行も読みます。プルリクエストに言及しないプロンプトは変更されずに送信され、`git` は実行されません。

271 276 

272プロンプトを止めるには、`next` を呼び出さずに `{ drop: 'the reason' }` を返します。テキストはユーザーのプロンプト入力欄に戻り、ユーザーには `Prompt dropped by a hook:` に続けて理由が表示されるため、理由はユーザーに向けて書いてください。フックの `next(e)` 呼び出しでプロンプトを通過させた後に `drop` を返した場合、ターンはそのまま実行され、フックは `a drop after its next() was answered` を含むメッセージとともに[失敗](#handle-a-hook-that-fails)します。277プロンプトを止めるには、`next` を呼び出さずに `{ drop: 'the reason' }` を返します。テキストはユーザーのプロンプト入力欄に戻り、ユーザーには `Prompt dropped by a hook:` に続けて理由が表示されるため、理由はユーザーに向けて書いてください。次の場合、プロンプトはそのまま送信されます：

278 

279* **フックの `next(e)` 呼び出しでプロンプトを通過させた後に `drop` を返した場合**：ターンはそのまま実行され、フックは `a drop after its next() was answered` を含むメッセージとともに[失敗](#handle-a-hook-that-fails)します

280* **フックが例外をスローするかタイムアウトした場合**：Claude Code はフックをスキップしてプロンプトを送信します。フックが止めるはずだったプロンプトが失敗によって送信されないよう、[`.catch` ハンドラーを追加](#handle-a-hook-that-fails)してください。

273 281 

274Claude が読むその他の内容は[他のイベント](https://code.claude.com/docs/ja/plugins/mods/reference.md#prompts-and-what-claude-reads)で扱います。システムプロンプトの各セクションには `prompt.section`、最初のメッセージとともに送信されるコンテキストには `prompt.context`、スキルのテキストには `skill.prompt` を使用します。これらのフックからのテキストがリクエストごとに変わると、[プロンプトキャッシュが無効化されます](https://code.claude.com/docs/ja/prompt-caching.md)。`skill.prompt` フックでは、[スキルの取得元となったプラグインまたはファイル](https://code.claude.com/docs/ja/plugins/mods/reference.md#skill-prompt-fields)を読み取ることもできます。282Claude が読むその他の内容は[他のイベント](https://code.claude.com/docs/ja/plugins/mods/reference.md#prompts-and-what-claude-reads)で扱います。システムプロンプトの各セクションには `prompt.section`、最初のメッセージとともに送信されるコンテキストには `prompt.context`、スキルのテキストには `skill.prompt` を使用します。これらのフックからのテキストがリクエストごとに変わると、[プロンプトキャッシュが無効化されます](https://code.claude.com/docs/ja/prompt-caching.md)。`skill.prompt` フックでは、[スキルの取得元となったプラグインまたはファイル](https://code.claude.com/docs/ja/plugins/mods/reference.md#skill-prompt-fields)を読み取ることもできます。

275 283 

305 313 

306リクエスト中に API 自身が実行したツール呼び出し（[advisor ツール](https://code.claude.com/docs/ja/advisor.md)への呼び出しなど）を確認するには、`result.serverToolUses` を読み取ります。Claude Code はこれらの呼び出しを実行しないため、これらに対して `tool.call` フックや `tool.check` フックは発火しません。レスポンスにそのような呼び出しが含まれない場合、このフィールドは存在しません。また、このフィールドには Claude Code v2.1.290 以降が必要です。314リクエスト中に API 自身が実行したツール呼び出し（[advisor ツール](https://code.claude.com/docs/ja/advisor.md)への呼び出しなど）を確認するには、`result.serverToolUses` を読み取ります。Claude Code はこれらの呼び出しを実行しないため、これらに対して `tool.call` フックや `tool.check` フックは発火しません。レスポンスにそのような呼び出しが含まれない場合、このフィールドは存在しません。また、このフィールドには Claude Code v2.1.290 以降が必要です。

307 315 

316### 設定の読み取りを変更または拒否する

317 

318`settings.read` フックは、mod による読み取りと Claude Code 自身による読み取りで実行されます：

319 

320* **mod による読み取り**：mod が [`$.settings.read`](https://code.claude.com/docs/ja/plugins/mods/api#read-one-source-or-one-key) を呼び出します。

321* **Claude Code 自身による読み取り**：Claude Code がセッションのマージされた設定を構築します。この読み取りは、設定または読み込まれたプラグインが変わるたびに繰り返されます。

322 

323どちらの読み取りに依存する場合も、事前にガードとバージョンを確認してください：

324 

325* **組み込みガード**：管理設定がある場合、またはセッションの認証情報として Team または Enterprise の [`/login`](https://code.claude.com/docs/ja/authentication#authentication-precedence) を使用している場合、[組み込みガード](https://code.claude.com/docs/ja/plugins/mods/admin.md#know-what-happens-by-default)は、インストールした mod や `--plugin-dir` で読み込んだ mod のこのフックをスキップすることがあります。確認するには、[デバッグログ](https://code.claude.com/docs/ja/plugins/mods/troubleshoot.md#read-the-debug-log)で `settings.read bypassed by cc-plugin-sec-default` を検索してください。そのテキストを含む行に自分の mod の名前がある場合は、組織の管理者に[その mod を組織の mod の 1 つとしてインストールする](https://code.claude.com/docs/ja/plugins/mods/admin.md#install-your-organizations-mods)よう依頼してください。

326* **バージョン**：Claude Code 自身による読み取りでこのイベントが発火すること、および `e.layers` フィールドには、Claude Code v2.1.304 以降が必要です。

327 

328#### `settings.read` フックが受け取るもの

329 

330| フィールド | 型 | 保持する内容 |

331| :- | :- | :- |

332| `e.layers` | array | 設定を保持する使用中の各ソースごとに 1 つの `{ source, settings }` オブジェクト。[優先順位](https://code.claude.com/docs/ja/settings.md#settings-precedence)が最も低いものから順に並びます：`plugin`、`user`、`project`、`local`、`flag`、`policy`。`claude plugin test` では空です。 |

333| `e.source` | string | `$.settings.read({ source: 'policy' })` のように mod が要求した 1 つのソース。この場合、`e.layers` にはそのレイヤーだけが含まれます。Claude Code 自身による読み取りや、マージされた設定のその他の読み取りでは存在しません。 |

334 

335`e.layers` において、`plugin` は有効なプラグインが提供する設定を保持します。これはレイヤー名にすぎず、`$.settings.read` に渡せる `source` ではありません。`flag` は `--settings` で渡された設定を保持し、`policy` は管理設定を保持します。

336 

337#### Claude Code 自身による読み取りと mod による読み取りを区別する

338 

339[Claude Code 自身による読み取り](#settings-read-hook)では [`next.origin`](https://code.claude.com/docs/ja/plugins/mods/reference#the-hook-function) は `{ plugin: 'engine', tier: 'core' }` になり、mod による読み取りでは `next.origin.plugin` は呼び出し元の mod の名前になります。

340 

341#### `settings.read` フックが返せるもの

342 

343フックは、[`next(e)`](https://code.claude.com/docs/ja/plugins/mods/reference#the-hook-function) の結果をそのまま返すか、独自の `{ value }`、または `{ deny: reason }` を返すことができます。[Claude Code 自身による読み取り](#settings-read-hook)と mod による読み取りのどちらでも、`{ value }` は読み取り結果を置き換え、`{ deny: reason }` は読み取りを拒否します：

344 

345| 戻り値 | Claude Code 自身による読み取りの場合 | mod による読み取りの場合 |

346| :- | :- | :- |

347| `{ value }` | 変更した各キーについて、返した値がセッションのマージされた設定におけるそのキーの値全体を置き換えます（[キーのスキーマに適合する](https://code.claude.com/docs/ja/plugins/mods/troubleshoot.md#settings-read-key-refused)場合） | その mod の呼び出しは、返した `value`、または要求した `key` を `value` から取り出したものに解決されるため、配列ではなくオブジェクト全体を返してください |

348| `{ deny: reason }` | セッションは、いずれかのフックが応答する前にマージされた状態の設定を維持し、[デバッグログに `reason` が記録されます](https://code.claude.com/docs/ja/plugins/mods/troubleshoot#settings-read-refused) | その mod の呼び出しは `<calling mod>: $.settings.read: <reason>` で reject されます |

349 

350Claude Code 自身による読み取りでは、省略したキーは未設定になるため、[`next(e)` の `value`](#settings-read-next) をもとに `{ value }` を構築してください。Claude Code が `env` などのキーを各ソースから個別に読み取る場合、`value` でそのキーを変更しても[効果はありません](https://code.claude.com/docs/ja/plugins/mods/troubleshoot.md#settings-read-key-no-effect)。

351 

352#### `next(e)` が `settings.read` フックに返すもの

353 

354`next(e)` は `{ value }` または `{ deny }` に解決されます：

355 

356* **`{ value }`**：`value` はマージされた設定、または [`e.source`](#settings-read-receives) が設定されている場合は 1 つのソースの設定です。[自分のフックより後に実行される](#the-order-mods-run-in)フックが独自の `{ value }` を返した場合は、代わりにそのフックの `value` を受け取ります。

357* **`{ deny }`**：自分のフックより後に実行されるフックが読み取りを拒否しました。その `{ deny }` をそのまま返してください。

358 

359#### `settings.read` フックから 1 つの設定を変更する

360 

361まず、[どの mod がこのイベントを受け取るか、またどのバージョンからか](#settings-read-hook)を確認してください。

362 

3631 つのキーを変更するには、このフックが [`spinnerTipsEnabled`](https://code.claude.com/docs/ja/settings-reference#spinnertipsenabled) に対して行っているように、[`next(e)`](https://code.claude.com/docs/ja/plugins/mods/reference#the-hook-function) の `value` を展開してそのキーを設定します。このフックは [`next.origin`](#settings-read-origin) を確認しないため、[Claude Code 自身による読み取り](#settings-read-hook)でも mod によるマージされた設定の読み取りでも同様にキーを変更します：

364 

365```javascript theme={null}

366on('settings.read', async ($, e, next) => {

367 const read = await next(e)

368 // Pass through a read of one source, so that only the merged settings change.

369 // Pass through a { deny } from a later hook too: it has no value.

370 if (e.source || !read.value) return read

371 // Keep every other key and change this one

372 return { value: { ...read.value, spinnerTipsEnabled: false } }

373})

374```

375 

376Claude Code 自身による読み取りで、フックが文字列などキーのスキーマ外の値を返した場合、そのキーだけは、いずれかのフックが応答する前にマージされた値を維持します。その場合、デバッグログには [`the answer for <key> is no value the key can hold`](https://code.claude.com/docs/ja/plugins/mods/troubleshoot#settings-read-key-refused) と記録されます。値がスキーマに適合しているのにキーが変わらない場合は、[返したキーに効果がない理由](https://code.claude.com/docs/ja/plugins/mods/troubleshoot.md#settings-read-key-no-effect)を参照してください。

377 

308### 設定フックのイベントを処理する378### 設定フックのイベントを処理する

309 379 

310設定フックとは、設定ファイルで構成するコマンド、HTTP、プロンプト、エージェントの各フックです。各[設定フックイベント](https://code.claude.com/docs/ja/hooks.md#hook-events)（`Stop`、`SessionEnd`、`PostToolUse` など）は、`classic.` の後に設定フックイベントの名前が続くイベント（`classic.Stop` など）としても利用できます。`e` は設定フックが stdin で受け取る JSON で、`transcript_path` を含みます。380設定フックとは、設定ファイルで構成するコマンド、HTTP、プロンプト、エージェントの各フックです。各[設定フックイベント](https://code.claude.com/docs/ja/hooks.md#hook-events)（`Stop`、`SessionEnd`、`PostToolUse` など）は、`classic.` の後に設定フックイベントの名前が続くイベント（`classic.Stop` など）としても利用できます。`e` は設定フックが stdin で受け取る JSON で、`transcript_path` を含みます。

508* **`Input`**: `onSubmit(value)` と `onInput(value)` を受け取ります508* **`Input`**: `onSubmit(value)` と `onInput(value)` を受け取ります

509* **`Select`**: `onSelect(value)` を受け取り、選択肢は `options` に指定します。これは一意の値を持つ 1 つ以上の選択肢のリストで、たとえば `[{ value: 'sm', label: 'Small' }, { value: 'lg', label: 'Large' }]` のようになります509* **`Select`**: `onSelect(value)` を受け取り、選択肢は `options` に指定します。これは一意の値を持つ 1 つ以上の選択肢のリストで、たとえば `[{ value: 'sm', label: 'Small' }, { value: 'lg', label: 'Large' }]` のようになります

510 510 

511テストはコントロールの `key` を使ってそのコントロールを押したり入力したりするため、各コントロールに `key` を付けてください。コントロールが使用されるたびに、`e.element` に `key` を含む [`ui.press`、`ui.input`、または `ui.select`](https://code.claude.com/docs/ja/plugins/mods/reference#interface) も発火し、別の mod がこれらのイベントを処理できます。そのフックはコールバックより先に実行されるため、ユーザーが `Input` に入力した内容を確認し、変更したり、コールバックの代わりに応答したりできます。mods API には、別の mod のボタンを押すメソッドはありません。511### `key` が必要なコントロール

512 

513すべての `Input` と `Select` に、`key: 'size'` のような `key` props を付けてください。`Button` は、`label` props または単一の文字列の子を持つ場合は `key` を省略できます。その場合、キーは `label` の値またはその文字列になります。

514 

515テストと別の mod は、コントロールをそのキーで識別します。

516 

517* **テスト**: [テスト](https://code.claude.com/docs/ja/plugins/mods/test.md#test-a-drawing)は、キーを使ってコントロールを押したり入力したりします。

518* **別の mod**: Claude Code は、コントロールのコールバックを実行する前に、`e.element` にコントロールのキーを含めて [`ui.press`、`ui.input`、または `ui.select`](https://code.claude.com/docs/ja/plugins/mods/reference#interface) を発火します。そのイベントに対する別の mod のフックは、ユーザーが `Input` に入力した内容を確認でき、そのテキストを変更したり、コールバックが実行されないようにしたりできます。mods API には、その mod がボタンを押すためのメソッドはありません。

519 

520`needs a key` または `is drawn twice` というメッセージが表示された場合は、[そのメッセージから原因を特定してください](https://code.claude.com/docs/ja/plugins/mods/troubleshoot.md#needs-a-key)。

512 521 

513### キーボードフォーカスとホットキー522### キーボードフォーカスとホットキー

514 523 

21| `.claude-plugin/plugin.json` | はい | プラグインの[マニフェスト](https://code.claude.com/docs/ja/plugins/manifest-reference.md)。mod によって追加される必須フィールドはありません。 |21| `.claude-plugin/plugin.json` | はい | プラグインの[マニフェスト](https://code.claude.com/docs/ja/plugins/manifest-reference.md)。mod によって追加される必須フィールドはありません。 |

22| `hooks/hooks.json` | はい | `modules`：フックモジュールへのパスを 1 つ含む配列で、パスはこのファイルからの相対パスです（例：`"modules": ["./register.js"]`）。`hooks` の下に[設定フック](https://code.claude.com/docs/ja/hooks.md)を置くこともできます。 |22| `hooks/hooks.json` | はい | `modules`：フックモジュールへのパスを 1 つ含む配列で、パスはこのファイルからの相対パスです（例：`"modules": ["./register.js"]`）。`hooks` の下に[設定フック](https://code.claude.com/docs/ja/hooks.md)を置くこともできます。 |

23| [`hooks/register.js`](https://code.claude.com/docs/ja/plugins/mods/create#write-a-mod-yourself) などのフックモジュール | はい | mod のエントリポイント。`register(on, options)` をエクスポートします。名前は `.js`、`.mjs`、`.cjs`、`.jsx`、`.ts`、`.mts`、`.cts`、`.tsx` のいずれかで終わります。ES モジュールです。 |23| [`hooks/register.js`](https://code.claude.com/docs/ja/plugins/mods/create#write-a-mod-yourself) などのフックモジュール | はい | mod のエントリポイント。`register(on, options)` をエクスポートします。名前は `.js`、`.mjs`、`.cjs`、`.jsx`、`.ts`、`.mts`、`.cts`、`.tsx` のいずれかで終わります。ES モジュールです。 |

24| マニフェストの `types` で指定する [`types/index.d.ts`](https://code.claude.com/docs/ja/plugins/mods/interface#declare-the-values) | mod が `$.state` を使う場合、または mods API に名前空間を追加する場合 | `PluginState` の値と、mod が追加する名前空間を宣言します |24| [`types/index.d.ts`](https://code.claude.com/docs/ja/plugins/mods/interface#declare-the-values)（マニフェストの `types` で別のパスを指定している場合はそのパス） | mod が `$.state` を使う場合、または mods API に名前空間を追加する場合 | `PluginState` の値と、mod が追加する名前空間を宣言します。マニフェストで `types` を省略するには、v2.1.299 以降が必要です。 |

25| 名前が `.test.ts` または `.test.tsx` で終わるファイル | いいえ | [`claude plugin test`](https://code.claude.com/docs/ja/plugins/mods/test#write-a-test) が実行するテスト |25| 名前が `.test.ts` または `.test.tsx` で終わるファイル | いいえ | [`claude plugin test`](https://code.claude.com/docs/ja/plugins/mods/test#write-a-test) が実行するテスト |

26 26 

27`register` は `on` と `options` を受け取ります。`options` には、マニフェストが宣言する [`userConfig`](https://code.claude.com/docs/ja/plugins/components#user-configuration) フィールドの値が、デフォルト値を補った状態で入っています。27`register` は `on` と `options` を受け取ります。`options` には、マニフェストが宣言する [`userConfig`](https://code.claude.com/docs/ja/plugins/components#user-configuration) フィールドの値が、デフォルト値を補った状態で入っています。

110 110 

111### コマンドと設定111### コマンドと設定

112 112 

113コマンドと設定のイベントは、コマンドが実行または一覧表示されるとき、および `/config` の行が表示または変更されるときに発火します。113コマンドと設定のイベントは、コマンドが実行または一覧表示されるとき、`/config` の行が表示または変更されるとき、および設定の読み取り時に発火します。

114 114 

115| イベント | 発火するタイミング | フックが返せる値 |115| イベント | 発火するタイミング | フックが返せる値 |

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

118| `command.describe` | 各コマンドにつき 1 回、コマンド一覧のため | `{ description, argumentHint, isHidden }` |118| `command.describe` | 各コマンドにつき 1 回、コマンド一覧のため | `{ description, argumentHint, isHidden }` |

119| `config.set` | `/config` の行が変更される直前 | `next({ ...e, value })` または `{ deny: reason }` |119| `config.set` | `/config` の行が変更される直前 | `next({ ...e, value })` または `{ deny: reason }` |

120| `config.describe` | `/config` の各行につき 1 回 | `{ label, description, isHidden }` |120| `config.describe` | `/config` の各行につき 1 回 | `{ label, description, isHidden }` |

121| [`settings.read`](https://code.claude.com/docs/ja/plugins/mods/events#settings-read-hook) | mod が [`$.settings.read`](https://code.claude.com/docs/ja/plugins/mods/api#reach-files-processes-and-the-network) を呼び出すとき、または Claude Code がセッションのマージされた設定を構築するとき | `next(e)`、`{ value }`、または `{ deny: reason }` |

122 

123#### `settings.read` の `e.layers` と `e.source`

124 

125* **`e.layers`**: 設定を保持している使用中のソースごとに 1 つの `{ source, settings }` オブジェクト。[優先順位](https://code.claude.com/docs/ja/settings.md#settings-precedence)の最も低いものが先頭です。[`settings.read` フックが受け取るもの](https://code.claude.com/docs/ja/plugins/mods/events#settings-read-receives)を参照してください。

126* **`e.source`**: `$.settings.read({ source: 'policy' })` のように、mod が要求した 1 つのソース。Claude Code 自身の読み取りや、マージされた設定のその他の読み取りでは存在しません

127 

128`settings.read` において、Claude Code 自身の読み取り時にイベントが発火すること、および `e.layers` フィールドには Claude Code v2.1.304 以降が必要です。フックが実行されるタイミングとフックが返せる値については、例も含めて[設定の読み取りを変更または拒否する](https://code.claude.com/docs/ja/plugins/mods/events.md#settings-read-hook)を参照してください。

121 129 

122### ターン130### ターン

123 131 

168 168 

169v2.1.292 より前では、呼び出しが 2 回目も実行されたため、プロンプトの送信、コマンドの実行、またはサブエージェントの開始が 2 回行われていました。169v2.1.292 より前では、呼び出しが 2 回目も実行されたため、プロンプトの送信、コマンドの実行、またはサブエージェントの開始が 2 回行われていました。

170 170 

171### `This mod's change didn't load` または `the earlier version is no longer running`

172 

173[このセッションで Claude が作成した mod](https://code.claude.com/docs/ja/plugins/mods/create.md#ask-claude-for-a-mod) への変更を読み込めませんでした。トランスクリプトの行は mod の名前で始まり、理由で終わります。

174 

175* `This mod's change didn't load, so the earlier version is still running: <reason>.`

176* `This mod didn't load, and the earlier version is no longer running: <reason>.`

177 

178Claude はこの行を参照できないため、Claude に修正を依頼する際は、次のメッセージにこの行を貼り付けてください。

179 

171### `$.agent.register refused: the hooks module that made the call is no longer loaded`180### `$.agent.register refused: the hooks module that made the call is no longer loaded`

172 181 

173行は mod の名前で始まります。例えば `first-mod: $.agent.register refused: the hooks module that made the call is no longer loaded (it was reloaded or removed)` のようになり、エージェントは登録されません。mod が呼び出しの前にリロードまたはアンロードされました。リロードではフックモジュールの新しいコピーが読み込まれますが、この呼び出しは古いコピーでまだ実行中のコード（例えばまだ戻っていなかったフック）から行われました。182行は mod の名前で始まります。例えば `first-mod: $.agent.register refused: the hooks module that made the call is no longer loaded (it was reloaded or removed)` のようになり、エージェントは登録されません。mod が呼び出しの前にリロードまたはアンロードされました。リロードではフックモジュールの新しいコピーが読み込まれますが、この呼び出しは古いコピーでまだ実行中のコード（例えばまだ戻っていなかったフック）から行われました。

225 234 

226その行の理由を読んでください。一般的な原因は、要素が受け付けない props と、アプリに存在しない要素です。235その行の理由を読んでください。一般的な原因は、要素が受け付けない props と、アプリに存在しない要素です。

227 236 

237### `needs a key`、`is drawn twice`、または `key each once`

238 

239`ui.render` フックが返すツリー内の要素に有効な [`key`](https://code.claude.com/docs/ja/plugins/mods/interface#which-controls-need-a-key) がないか、2 つの要素が同じ key を共有しています。受け取ったメッセージを探してください。

240 

241* **`<Input> needs a key` または `<Select> needs a key`**: 要素に `key` props がないか、`key` が空であるか、`key: 3` のように文字列ではありません。`key` として空でない文字列を指定してください。

242* **`<Button> needs a key`**: ボタンの `key` として空でない文字列を指定します

243* **`is drawn twice; each takes its own key`**: メッセージが示す種類の 2 つの要素が同じ `key` を持っています。例えば `Input "size" is drawn twice; each takes its own key` のようになります。各要素に固有の `key` を指定してください。

244* **[テスト](https://code.claude.com/docs/ja/plugins/mods/test.md#test-a-drawing) での `press` からの `key each once`**: 描画内に、渡した key を持つボタンが複数あります。ラベルが同じで `key` props のないボタンは、そのラベルを key として共有します。各ボタンに固有の `key` を指定してください。

245 

228### `ui.render` の行に `threw while drawn` と表示される246### `ui.render` の行に `threw while drawn` と表示される

229 247 

230その行は [描画箇所](https://code.claude.com/docs/ja/plugins/mods/reference.md#render-sites) を示し、続いて `threw while drawn:` とエラーを示します。例えば `first-mod: ui.render (ToolUse) threw while drawn: <error>; the engine drew its own` のようになります。Claude Code は、[`ui.render`](https://code.claude.com/docs/ja/plugins/mods/reference#interface) フックが返したツリーを描画する際、または [フックが `next` に渡した `props`](https://code.claude.com/docs/ja/plugins/mods/interface#change-what-claude-code-already-draws) から描画箇所を描画する際に、そのエラーに遭遇しました。末尾の `the engine drew its own` は、その描画箇所に Claude Code の通常のコンテンツが表示されることを意味します。248その行は [描画箇所](https://code.claude.com/docs/ja/plugins/mods/reference.md#render-sites) を示し、続いて `threw while drawn:` とエラーを示します。例えば `first-mod: ui.render (ToolUse) threw while drawn: <error>; the engine drew its own` のようになります。Claude Code は、[`ui.render`](https://code.claude.com/docs/ja/plugins/mods/reference#interface) フックが返したツリーを描画する際、または [フックが `next` に渡した `props`](https://code.claude.com/docs/ja/plugins/mods/interface#change-what-claude-code-already-draws) から描画箇所を描画する際に、そのエラーに遭遇しました。末尾の `the engine drew its own` は、その描画箇所に Claude Code の通常のコンテンツが表示されることを意味します。

303 321 

304[`classic.SessionStart` hooks で保存された値を再度読み込みます](https://code.claude.com/docs/ja/plugins/mods/interface#load-a-saved-value-again-after-clear)。322[`classic.SessionStart` hooks で保存された値を再度読み込みます](https://code.claude.com/docs/ja/plugins/mods/interface#load-a-saved-value-again-after-clear)。

305 323 

324### `settings.read` フックが返すキーが有効にならない

325 

326返された `env` エントリは環境変数になりません。返された `allow`、`ask`、`deny` ルールはツール呼び出し時にチェックされません。これらは[設定ファイル](https://code.claude.com/docs/ja/settings.md)で設定するか、環境変数の場合は [`$.env.set`](https://code.claude.com/docs/ja/plugins/mods/api#reach-files-processes-and-the-network) を呼び出します。

327 

328その他のキーについては、[どの mod がどのバージョンから `settings.read` を受け取るか](https://code.claude.com/docs/ja/plugins/mods/events#settings-read-hook)を確認してから、[デバッグログ](#read-the-debug-log)で `settings.read` を検索し、次のいずれかの行を探します。

329 

330| ログ行 | 意味と対処 |

331| :- | :- |

332| `settings.read hook skipped`（mod の名前の後） | フックが失敗しました。[行が報告するエラーを修正します](#hook-skipped)。 |

333| `settings.read bypassed by cc-plugin-sec-default`（その前に mod の名前がある行） | [組み込みガード](https://code.claude.com/docs/ja/plugins/mods/admin.md#know-what-happens-by-default)がフックをスキップしました。組織の管理者に、[その mod を組織の mod の 1 つとしてインストールする](https://code.claude.com/docs/ja/plugins/mods/admin.md#install-your-organizations-mods)よう依頼します。 |

334| `settings.read: the answer for <key> is no value the key can hold` | 返された値がキーのスキーマに適合しません。[スキーマが許可する値を返します](#settings-read-key-refused)。 |

335| `settings.read: the merge never settles for <key>` | 行に示されたキーは設定ソースの値を保持します。それらを設定ファイルで設定します。 |

336| `answered settings.read without next()`（ある mod の名前の後） | その mod が[自分の mod より前に実行される](https://code.claude.com/docs/ja/plugins/mods/events.md#the-order-mods-run-in)場合にのみ関係します。その場合、その読み取りでは自分のフックが実行されませんでした。[その mod をオフにする](https://code.claude.com/docs/ja/plugins/mods/overview.md#turn-mods-on-or-off)か、組織がデプロイしたものであれば、その管理者にオフにするよう依頼します。 |

337| `settings.read: refused to the engine` | 読み取りが拒否されたため、どのフックの `{ value }` も適用されませんでした。[何が拒否したかを特定します](#settings-read-refused)。 |

338 

339どの行もキーについて説明していない場合は、自分の mod より前に実行される mod に、[そのキーを変更する](https://code.claude.com/docs/ja/plugins/mods/events.md#settings-read-example) `settings.read` フックがないか確認します。その mod をオフにするか、組織の管理者にオフにするよう依頼します。該当するフックがない場合は、キーを設定ファイルで設定します。

340 

341### `the answer for <key> is no value the key can hold`

342 

343この[デバッグログ](#read-the-debug-log)の行は、[`settings.read`](https://code.claude.com/docs/ja/plugins/mods/events#settings-read-hook) フックが指定のキーに対して返した値を Claude Code が拒否したことを意味します。拒否されたのはそのキーのみです。

344 

345```text theme={null}

346settings.read: the answer for <key> is no value the key can hold; the settings' own value stands

347```

348 

349指定のキーに対して返した値が、型や範囲などの点でそのキーのスキーマに適合しませんでした。キーの[設定リファレンス](https://code.claude.com/docs/ja/settings-reference.md)のエントリが許可する値を返します。値が適合しない間、そのキーはいずれかのフックが応答する前に設定ソースからマージされた値を保持します。この行ではそれを設定自身の値（the settings' own value）と呼んでいます。

350 

351### `settings.read: refused to the engine`

352 

353この[デバッグログ](#read-the-debug-log)の行は、[Claude Code 自身の読み取り](https://code.claude.com/docs/ja/plugins/mods/events.md#settings-read-hook)が拒否されたため、自分のフックを含め、どのフックの `{ value }` も適用されなかったことを意味します。`settings.read` フックが [`{ deny: reason }`](https://code.claude.com/docs/ja/plugins/mods/events#settings-read-returns) でその読み取りを拒否した場合、行にはそのフックの理由が含まれます。

354 

355```text theme={null}

356settings.read: refused to the engine (engine: $.settings.read: <reason>); the settings' own values stand

357```

358 

359自分のフックのコードで `<reason>` のテキストを検索します。

360 

361* **コードに含まれている場合**: 自分のフックが読み取りを拒否しました。[`next.origin`](https://code.claude.com/docs/ja/plugins/mods/events#settings-read-origin) が Claude Code 自身の読み取りを示す場合は `{ value }` を返すようにします。

362* **コードに含まれていない場合**: 他の mod を 1 つずつ[オフにします](https://code.claude.com/docs/ja/plugins/mods/overview.md#turn-mods-on-or-off)。それぞれの後に、このセッションのコマンドをシェルから新しいパスを指定した `--debug-file` を 1 つ付けて再実行し、そのファイルで `refused to the engine` を検索します。行がある場合は、次の mod をオフにします。ない場合は、最後にオフにした mod が読み取りを拒否したので、それをオフのままにします。

363 

364他にオフにする mod が残っていない場合は、フックが返すキーに[設定ファイル](https://code.claude.com/docs/ja/settings.md)を使用します。読み取りが拒否されている間も、その値は保持されます。

365 

306## デバッグログを読む366## デバッグログを読む

307 367 

308デバッグログには、Claude Code が読み込むまたは拒否するすべてのモジュール、失敗するすべてのフック、拒否するすべての結果の行があります。トランスクリプトに何も表示されない場合は、ここを確認してください。書き込むには、シェルで Claude Code を `--debug` で開始するか、`--debug-file <path>` で場所を選択します。368デバッグログには、Claude Code が読み込むまたは拒否するすべてのモジュール、失敗するすべてのフック、拒否するすべての結果の行があります。トランスクリプトに何も表示されない場合は、ここを確認してください。書き込むには、シェルで Claude Code を `--debug` で開始するか、`--debug-file <path>` で場所を選択します。

251 251 

252まずリポジトリ自体を確認してください：スペルが間違った `owner/repo`、存在しないリポジトリ、またはアクセスできないプライベートリポジトリもこのメッセージで終わります。ブラウザでリポジトリ URL を開くか、ターミナルで `git ls-remote <url>` を実行して、それが存在し、アクセス権があることを確認してください。252まずリポジトリ自体を確認してください：スペルが間違った `owner/repo`、存在しないリポジトリ、またはアクセスできないプライベートリポジトリもこのメッセージで終わります。ブラウザでリポジトリ URL を開くか、ターミナルで `git ls-remote <url>` を実行して、それが存在し、アクセス権があることを確認してください。

253 253 

254リポジトリが正しい場合、原因は認証情報です。Claude Code は git をインタラクティブプロンプト無効で実行するため、パスワード、キーパスフレーズ、またはターミナルが行うような認証情報を要求できません。git がプロンプトを必要とする場合、`fatal: Cannot prompt because user interactivity has been disabled` または `terminal prompts disabled` が元のエラーに表示されます。既に非対話的に機能する認証情報のみが成功します：254リポジトリが正しい場合、原因は認証情報です。Claude Code は、`GIT_ASKPASS` で設定されたものを含め、git のプロンプトと askpass プログラムをオフにし、SSH をバッチモードで実行します。git がプロンプトを必要とする場合、クローンのエラーには `fatal: Cannot prompt because user interactivity has been disabled`、`terminal prompts disabled`、または `fatal: unable to get password from user` が含まれます。git がプロンプトや askpass プログラムなしで取得できる認証情報のみが成功します：

255 255 

256* **SSH**：`ssh -T git@<host>` はパスフレーズを要求せずに成功する必要があり、ホストは既に `known_hosts` にある必要があります256* **SSH**：`ssh -T git@<host>` はパスフレーズを要求せずに成功する必要があり、ホストは既に `known_hosts` にある必要があります

257* **HTTPS**：認証情報ヘルパーはホストのトークンを保持する必要があります。GitHub の場合は、`gh auth login` と `gh auth setup-git` を実行してください。別のホストの場合は、個人用アクセストークンを git 認証情報ヘルパーに保存してください。`git ls-remote <url>` でテストしてください257* **HTTPS**：認証情報ヘルパーはホストのトークンを保持する必要があります。GitHub の場合は、`gh auth login` と `gh auth setup-git` を実行してください。別のホストの場合は、個人用アクセストークンを git 認証情報ヘルパーに保存してください。テストするには、ターミナルで `GIT_ASKPASS` の設定を解除し、`git -c core.askPass= ls-remote <url>` を実行してください。

258 258 

259ターミナルで `git ls-remote` がプロンプトなしで成功したら、追加または更新を再度実行してください。成功した追加は `Successfully added marketplace: <name>` を出力します。成功した更新はシェルから `Successfully updated marketplace: <name>` を出力するか、セッションで `✔ Updated 1 marketplace` を出力します。259使用しているプロトコルのチェックがプロンプトなしで成功したら、追加または更新を再度実行してください。成功した追加は `Successfully added marketplace: <name>` を出力します。成功した更新はシェルから `Successfully updated marketplace: <name>` を出力するか、セッションで `✔ Updated 1 marketplace` を出力します。

260 260 

261GitHub `owner/repo` ソースの SSH をスキップするように Claude Code を設定するには、`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` を設定してください。これがないと、Claude Code は `github.com` の SSH キーが設定されているように見える場合、これらのソースを SSH 経由でクローンし、SSH クローンが失敗するときに HTTPS にフォールバックします。261GitHub `owner/repo` ソースの SSH をスキップするように Claude Code を設定するには、`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` を設定してください。これがないと、Claude Code は `github.com` の SSH キーが設定されているように見える場合、これらのソースを SSH 経由でクローンし、SSH クローンが失敗するときに HTTPS にフォールバックします。

262 262 

318 318 

319リポジトリがモノレポの場合は、`claude plugin marketplace add <source> --sparse <paths>` で名前を付けたディレクトリにチェックアウトを制限してください。319リポジトリがモノレポの場合は、`claude plugin marketplace add <source> --sparse <paths>` で名前を付けたディレクトリにチェックアウトを制限してください。

320 320 

321リポジトリに大きな git サブモジュールがある場合は、Claude Code を更新してください。v2.1.295 以降では、Claude Code は[プラグインファイルを含むサブモジュール](https://code.claude.com/docs/ja/plugins/marketplace-reference.md#git-submodules-in-the-marketplace-repository)のみを取得します。それより前のバージョンはすべてのサブモジュールを取得するため、それだけで 120 秒を使い切ることがあります。

322 

321### マーケットプレイスの更新がオフラインで失敗し続ける323### マーケットプレイスの更新がオフラインで失敗し続ける

322 324 

323マーケットプレイスの git ホストに到達できない環境で作業しており、すべてのセッションがバックグラウンドで失敗した更新を繰り返します。マーケットプレイスの既存のチェックアウトは所定の位置に留まり、スタートアップは遅延しません。325マーケットプレイスの git ホストに到達できない環境で作業しており、すべてのセッションがバックグラウンドで失敗した更新を繰り返します。マーケットプレイスの既存のチェックアウトは所定の位置に留まり、スタートアップは遅延しません。

609| `<Plugin or Dependency> "<name>" has conflicting version requirements` | バージョンはすべての範囲を満たしていません。メッセージは範囲をリストします。 | 競合するプラグインの 1 つをアンインストールまたは更新するか、上流の作成者に制約を広げるよう依頼してください。 |611| `<Plugin or Dependency> "<name>" has conflicting version requirements` | バージョンはすべての範囲を満たしていません。メッセージは範囲をリストします。 | 競合するプラグインの 1 つをアンインストールまたは更新するか、上流の作成者に制約を広げるよう依頼してください。 |

610| `... has version requirements too complex to intersect` または `has an invalid version requirement` | 範囲は有効な semver ではないか、結合された範囲を交差させることができません。 | 無効な範囲を修正するか、長い `\|\|` チェーンを簡素化してください。 |612| `... has version requirements too complex to intersect` または `has an invalid version requirement` | 範囲は有効な semver ではないか、結合された範囲を交差させることができません。 | 無効な範囲を修正するか、長い `\|\|` チェーンを簡素化してください。 |

611| `... has no git tag satisfying <range>` | 依存関係のリポジトリには範囲内に `<name>--v*` タグがありません。 | 上流がその規約でリリースをタグ付けしていることを確認するか、範囲を緩和してください。 |613| `... has no git tag satisfying <range>` | 依存関係のリポジトリには範囲内に `<name>--v*` タグがありません。 | 上流がその規約でリリースをタグ付けしていることを確認するか、範囲を緩和してください。 |

612| `Dependency "<dep>" (required by <plugin>) is in <marketplace>, which is not in the allowlist` | 依存関係は別のマーケットプレイスにあり、クロスマーケットプレイス解決はデフォルトでオフです。 | 依存関係を自分でインストールしてください。シェルで `claude plugin install <dep>@<marketplace>` に加えて、プラグインをインストールしている `--scope` を使用してから、再試行してください。 |614| `Dependency "<dep>" (required by <plugin>) is in marketplace "<marketplace>", which is not in the allowlist` | 依存関係は別のマーケットプレイスにあり、クロスマーケットプレイス解決はデフォルトでオフです。 | 依存関係を同じスコープで自分でインストールしてから、再試行してください。シェルで `claude plugin install <dep>@<marketplace>` に、プラグインをインストールしているスコープの `--scope` を付けて実行します。 |

613 615 

614これらをプログラムで表示するには、シェルで `claude plugin list --json` を実行してください。問題のあるプラグインは、メッセージを含む `errors` フィールドと、各メッセージの `type` を含む `errorDetails` フィールドを運びます：最初の 3 行は `dependency-unsatisfied` で、4 番目は `dependency-version-unsatisfied` です。616これらをプログラムで表示するには、シェルで `claude plugin list --json` を実行してください。問題のあるプラグインは、メッセージを含む `errors` フィールドと、各メッセージの `type` を含む `errorDetails` フィールドを運びます：最初の 3 行は `dependency-unsatisfied` で、4 番目は `dependency-version-unsatisfied` です。

615 617 

949 951 

950### `commands path not found: <path>`952### `commands path not found: <path>`

951 953 

952**Errors** タブに `commands path not found: <absolute path>` が表示され、ガイダンスとして「マニフェストまたはマーケットプレイス設定のパスが正しいことを確認してください」と表示されます。同じメッセージは `skills`、`agents`、`hooks` に対しても表示されます。954**Errors** タブに `commands path not found: <absolute path>` が表示され、ガイダンスとして `Check that the path in your manifest or marketplace config is correct` と表示されます。同じメッセージは `skills`、`agents`、`hooks` に対しても表示されます。

953 955 

954Claude Code は `plugin.json` またはマーケットプレイスエントリからのパスをプラグインルートに対して解決し、そこに何も見つかりませんでした。メッセージ内のパスはチェックした絶対パスなので、ディスク上の内容と比較してください。パスを修正するか、ディレクトリを作成してから `/reload-plugins` を実行してください。956Claude Code は `plugin.json` またはマーケットプレイスエントリからのパスをプラグインルートに対して解決し、そこに何も見つかりませんでした。メッセージ内のパスはチェックした絶対パスなので、ディスク上の内容と比較してください。パスを修正するか、ディレクトリを作成してから `/reload-plugins` を実行してください。

955 957 

979 981 

980### `${CLAUDE_PLUGIN_ROOT}` が Windows で前方スラッシュを表示する982### `${CLAUDE_PLUGIN_ROOT}` が Windows で前方スラッシュを表示する

981 983 

982Windows では、プラグインフックが `${CLAUDE_PLUGIN_ROOT}` を `C:\Users\you\...` ではなく `C:/Users/you/...` として受け取り、バックスラッシュを期待するスクリプトが破損します。984Windows では、Git Bash を通じて実行されるプラグインフックが `${CLAUDE_PLUGIN_ROOT}` を `C:\Users\you\...` ではなく `C:/Users/you/...` として受け取り、バックスラッシュを期待するスクリプトが破損します。

983 985 

984Claude Code は Windows 上でシェル形式のフックを Git Bash を通じて実行し、意図的にプラグインルートを前方スラッシュ Win32 形式で置換します。Bash ビルトイン、MSYS ツール、ネイティブ Windows バイナリはすべてその形式を受け入れます。986Git Bash がインストールされている場合、[シェル形式のフック](https://code.claude.com/docs/ja/hooks.md#exec-form-and-shell-form) はデフォルトで Git Bash を通じて実行されます。Git Bash を通じて実行されるフックに対しては、Bash がバックスラッシュをエスケープとして解釈しないように、Claude Code は前方スラッシュでパスを渡します。Bash ビルトイン、MSYS ツール、ネイティブ Windows バイナリはすべてその形式を受け入れます。

985 987 

986スクリプトがバックスラッシュを必要とする場合は、フックを [exec 形式とシェル形式](https://code.claude.com/docs/ja/hooks.md#exec-form-and-shell-form) の下で説明されているネイティブパスを保持する形式の 1 つに切り替えてください。988スクリプトがバックスラッシュを必要とする場合は、フックを [exec 形式とシェル形式](https://code.claude.com/docs/ja/hooks.md#exec-form-and-shell-form) の下で説明されているネイティブパスを保持する形式の 1 つに切り替えてください。

987 989 

1090 1092 

1091または、マーケットプレイスを git リポジトリでホストし、ユーザーにリポジトリ URL で追加するよう指示してください。git ソースの場合、Claude Code はリポジトリ全体をクローンするため、相対パスは解決されます。ソースタイプは[マーケットプレイスリファレンス](https://code.claude.com/docs/ja/plugins/marketplace-reference.md)にあります。1093または、マーケットプレイスを git リポジトリでホストし、ユーザーにリポジトリ URL で追加するよう指示してください。git ソースの場合、Claude Code はリポジトリ全体をクローンするため、相対パスは解決されます。ソースタイプは[マーケットプレイスリファレンス](https://code.claude.com/docs/ja/plugins/marketplace-reference.md)にあります。

1092 1094 

1095### git サブモジュールにあるルートプラグインのファイルがインストール後に見つからない

1096 

1097プラグインがマーケットプレイスのルートにあり、リポジトリの git サブモジュールにあるファイルを実行または読み取ります。インストール後、サブモジュールのディレクトリが空になっています。v2.1.295 より前は、Claude Code がすべてのサブモジュールをフェッチしていたため、このディレクトリにはファイルが存在していました。

1098 

1099Claude Code はマーケットプレイスをクローンするとき、[プラグインファイルを含むサブモジュール](https://code.claude.com/docs/ja/plugins/marketplace-reference.md#git-submodules-in-the-marketplace-repository)のみをフェッチします。ルートにあるプラグインの場合は、プラグインの設定内のパスとプラグインのファイルのテキストを読み取って判断します。スクリプトが実行中に組み立てるパスは認識できません。

1100 

1101サブモジュール内へのパスは、フックコマンド内の `${CLAUDE_PLUGIN_ROOT}/vendor/tool/run.sh` のように、Claude Code が読み取れる場所に完全な形で記述してください。そうすると、Claude Code はそのプラグインについてリポジトリ内のすべてのサブモジュールをフェッチします。

1102 

1093### マーケットプレイス検証エラー1103### マーケットプレイス検証エラー

1094 1104 

1095マーケットプレイスディレクトリから `claude plugin validate .` を実行し、マーケットプレイスファイル自体のエラーまたは警告を報告しました。1105マーケットプレイスディレクトリから `claude plugin validate .` を実行し、マーケットプレイスファイル自体のエラーまたは警告を報告しました。

1115 1125 

1116v2.1.247 より前では、制御またはビジョナル形式の文字を含むマーケットプレイス名は、`Marketplace name impersonates an official Anthropic/Claude marketplace` としてのみ報告されました。1126v2.1.247 より前では、制御またはビジョナル形式の文字を含むマーケットプレイス名は、`Marketplace name impersonates an official Anthropic/Claude marketplace` としてのみ報告されました。

1117 1127 

1118## 組織によってブロック1128## 組織によってブロックされている

1119 1129 

1120組織は管理設定をデプロイしてプラグインを制限し、コマンドはポリシーメッセージで拒否されました。これらのエントリは各拒否の背後にある設定に名前を付けるため、管理者に何を依頼するかを知っています。管理者側については、[組織のプラグインを管理](https://code.claude.com/docs/ja/plugins/org.md)を参照してください。1130組織がプラグインを制限する管理設定を展開しており、コマンドがポリシーメッセージとともに拒否されました。以下の各項目では、それぞれの拒否の原因となっている設定を示しているため、管理者に何を依頼すればよいかがわかります。管理者側の手順については、[組織のプラグインを管理する](https://code.claude.com/docs/ja/plugins/org.md)を参照してください。

1121 1131 

1122### `Marketplace source '<source>' is blocked by enterprise policy`1132### `Marketplace source '<source>' is blocked by enterprise policy`

1123 1133 

1124`/plugin marketplace add`、`update`、またはインストールを実行し、Claude Code はこの行で拒否しました。GitHub または git ソースの場合、ホストはソースの後に括弧内に続きます。例えば、`'github:owner/repo' (github.com)`。1134`/plugin marketplace add`、`update`、またはインストールを実行したところ、Claude Code がこの行を表示して拒否しました。

1125 1135 

1126管理者は管理設定で `blockedMarketplaces` または `strictKnownMarketplaces` を設定し、このソースは許可されていません。管理者にソースを許可するよう依頼するか、メッセージがリストする許可されたソースの 1 つを追加してください。1136管理者が管理設定で `blockedMarketplaces` または `strictKnownMarketplaces` を設定しており、このソースは許可されていません。管理者にソースの許可を依頼するか、メッセージに列挙されている許可済みソースのいずれかを追加してください。

1127 1137 

1128メッセージの残りを一致させて、どのポリシーがソースをブロックしたかを確認してください：1138メッセージの残りの部分を照合して、どの種類のポリシーがソースをブロックしたかを確認してください。

1129 1139 

1130* **`Allowed sources: <list>`**：ブロックは `blockedMarketplaces` ブロックリストではなく `strictKnownMarketplaces` 許可リストから来ています1140* **`Allowed sources: <list>`**：ブロックは `blockedMarketplaces` 拒否リストではなく、`strictKnownMarketplaces` 許可リストによるものです

1131* **`No external marketplaces are allowed.`**：`strictKnownMarketplaces` 許可リストは空です1141* **`No external marketplaces are allowed.`**：`strictKnownMarketplaces` 許可リストが空です

1132* **ショートハンドが github.com を想定するという `Tip:`**：許可リストは git ホストをホスト名で許可し、渡した `owner/repo` ショートハンドは github.com を指しています。リポジトリが内部ホストに存在する場合は、`git@your-git-host.com:owner/repo.git` などの完全な URL で再度追加してください1142* **短縮形が github.com を前提としていることを示す `Tip:`**：許可リストはホスト名によって git ホストを許可しており、指定した `owner/repo` の短縮形は github.com を指しています。リポジトリが社内ホストにある場合は、`git@your-git-host.com:owner/repo.git` のような完全な URL で再度追加してください

1133 1143 

1134ポリシーがより制限的になる前に追加したマーケットプレイスは、ポリシーがすべての更新に適用されるため、更新を停止します。1144ポリシーが厳しくなる前に追加したマーケットプレイスも更新されなくなります。ポリシーは更新のたびに適用されるためです。

1135 1145 

1136### `Marketplace "<name>" is not in the allowed marketplace list`1146### `Marketplace "<name>" is not in the allowed marketplace list`

1137 1147 

1138**Errors** タブはこの行を表示するか、既に登録しているマーケットプレイスの場合は `Marketplace "<name>" is blocked by enterprise policy` を表示します。1148すでに登録済みのマーケットプレイスについて、**Errors** タブにこの行、または `Marketplace "<name>" is blocked by enterprise policy` が表示されます。

1139 1149 

1140[マーケットプレイスソース](#marketplace-source-is-blocked-by-enterprise-policy)をブロックする同じ管理設定は読み込み時に適用されます。`strictKnownMarketplaces` はこのマーケットプレイスを含まないか、`blockedMarketplaces` がそれに名前を付けるため、Claude Code は読み込みを停止し、そのプラグインも同様です。許可リストバリアントの場合、ガイダンス行は許可されたソースを表示するか、`Contact your administrator to configure allowed marketplace sources` を読みます。ブロックリストバリアントの場合、`This marketplace source is explicitly blocked by your administrator` を読みます。1150[マーケットプレイスソース](#marketplace-source-is-blocked-by-enterprise-policy)をブロックするのと同じ管理設定が、読み込み時にも適用されます。`strictKnownMarketplaces` にこのマーケットプレイスが含まれていないか、`blockedMarketplaces` にこのマーケットプレイスが指定されているため、Claude Code はこのマーケットプレイスとそのプラグインの読み込みを停止します。許可リストによる場合、ガイダンス行には許可済みソース、または `Contact your administrator to configure allowed marketplace sources` が表示されます。拒否リストによる場合は `This marketplace source is explicitly blocked by your administrator` と表示されます。

1141 1151 

1142### `Plugin "<name>" is blocked by your organization's policy and cannot be installed`1152### `Plugin "<name>" is blocked by your organization's policy and cannot be installed`

1143 1153 

1144インストールはこの行で拒否されたか、有効化は同じ行で終わったか、`Plugin "<name>" is from marketplace "<marketplace>", which is blocked by your organization's policy` または `Plugin "<name>" depends on "<dep>", which is blocked by your organization's policy` という理由で名前を付けたインストールまたは更新。1154インストールがこの行で拒否された、有効化が末尾が `cannot be enabled` となる同じ行で拒否された、またはインストールや更新が理由を示す行で拒否されました。理由を示す行は `Plugin "<name>" is from marketplace "<marketplace>", which is blocked by your organization's policy` または `Plugin "<name>" depends on "<dep>", which is blocked by your organization's policy` です。

1145 1155 

1146管理設定はこのプラグイン、そのマーケットプレイス、またはそれが必要とする依存関係をブロックします。どのエントリが適用されるかを管理者に尋ねてください。ブロックされた依存関係は、依存関係のマーケットプレイスが許可されるまでプラグインをインストールできないことを意味します。1156管理設定によって、このプラグイン、そのマーケットプレイス、または必要な依存関係がブロックされています。どの項目が該当するかを管理者に確認してください。依存関係がブロックされている場合、その依存関係のマーケットプレイスが許可されるまでプラグインはインストールできません。