Documentation 2026-09-30 23:00 UTC to 2026-10-01 21:02 UTC

106| [claude.ai 同期を無効にする](/docs/ja/settings-reference#syncclaudeaiskills) | Claude Code が開発者が claude.ai で有効にした[スキル](/docs/ja/skills#how-synced-skills-behave)と[プラグイン](/docs/ja/plugins/loading#synced-plugins)を読み込むのを停止します。組織の claude.ai でスキルをオフにすると、Claude Code は両方の同期を停止します。v2.1.273 以降では、既に同期したものも削除します。スキルをオフにせずにどちらか一方を停止するには、マネージド設定でそのキーを `false` に設定します | `syncClaudeAiSkills`、`syncClaudeAiPlugins` |106| [claude.ai 同期を無効にする](/docs/ja/settings-reference#syncclaudeaiskills) | Claude Code が開発者が claude.ai で有効にした[スキル](/docs/ja/skills#how-synced-skills-behave)と[プラグイン](/docs/ja/plugins/loading#synced-plugins)を読み込むのを停止します。組織の claude.ai でスキルをオフにすると、Claude Code は両方の同期を停止します。v2.1.273 以降では、既に同期したものも削除します。スキルをオフにせずにどちらか一方を停止するには、マネージド設定でそのキーを `false` に設定します | `syncClaudeAiSkills`、`syncClaudeAiPlugins` |

107| [フック制限](/docs/ja/settings-reference#allowmanagedhooksonly) | 実行するフックを制限し、HTTP フック URL を制限します。[`allowManagedHooksOnly` で実行される内容](/docs/ja/settings-reference#what-runs-under-allowmanagedhooksonly)の完全な効果リストを参照してください | `allowManagedHooksOnly`、`allowedHttpHookUrls` |107| [フック制限](/docs/ja/settings-reference#allowmanagedhooksonly) | 実行するフックを制限し、HTTP フック URL を制限します。[`allowManagedHooksOnly` で実行される内容](/docs/ja/settings-reference#what-runs-under-allowmanagedhooksonly)の完全な効果リストを参照してください | `allowManagedHooksOnly`、`allowedHttpHookUrls` |

108| [ログイン強制](/docs/ja/settings-reference#forceloginmethod) | ログインを特定の方法または Anthropic 組織に制限します。メソッド制限は VS Code 拡張機能、Agent SDK、`claude setup-token`、`/install-github-app` 全体に適用され、ターミナルのインタラクティブログイン画面（`/login` または初回オンボーディングで到達）はメソッドを事前選択しますが強制しません。Claude Code は、ターミナル、VS Code 拡張機能、Agent SDK での claude.ai アカウントログインの組織を検証し、Claude Console ログインまたは[ゲートウェイ](/docs/ja/claude-apps-gateway)サインインではチェックしません。v2.1.212 より前は、ターミナルログインのみが両方のキーを適用していました。設定すると、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` によって認証されたセッションはスタートアップでブロックされます。クラウドプロバイダーセッションは影響を受けません | `forceLoginMethod`、`forceLoginOrgUUID` |108| [ログイン強制](/docs/ja/settings-reference#forceloginmethod) | ログインを特定の方法または Anthropic 組織に制限します。メソッド制限は VS Code 拡張機能、Agent SDK、`claude setup-token`、`/install-github-app` 全体に適用され、ターミナルのインタラクティブログイン画面（`/login` または初回オンボーディングで到達）はメソッドを事前選択しますが強制しません。Claude Code は、ターミナル、VS Code 拡張機能、Agent SDK での claude.ai アカウントログインの組織を検証し、Claude Console ログインまたは[ゲートウェイ](/docs/ja/claude-apps-gateway)サインインではチェックしません。v2.1.212 より前は、ターミナルログインのみが両方のキーを適用していました。設定すると、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` によって認証されたセッションはスタートアップでブロックされます。クラウドプロバイダーセッションは影響を受けません | `forceLoginMethod`、`forceLoginOrgUUID` |

109| [プロバイダー制限](/docs/ja/settings-reference#allowedproviders) | マシンが使用できる API プロバイダーを制限します。リストに記載されていないプロバイダー上のセッションはスタートアップ時、ログイン時、および次に API に接続するときに拒否されます。Claude Code v2.1.285 以降が必要です | `allowedProviders` |

109| [エージェントビューを無効にする](/docs/ja/agent-view#how-background-sessions-are-hosted) | `claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザーをオフにします | `disableAgentView` |110| [エージェントビューを無効にする](/docs/ja/agent-view#how-background-sessions-are-hosted) | `claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザーをオフにします | `disableAgentView` |

110| [企業ランチャーを構成する](/docs/ja/corporate-launcher) | [バックグラウンドエージェントスーパーバイザー](/docs/ja/agent-view#how-background-sessions-are-hosted)、そのワーカー、および[その他のカバーされたバックグラウンドプロセス](/docs/ja/corporate-launcher#what-the-launcher-covers)に、エージェントビューをオフにする代わりに、必須の企業ランチャーをプレフィックスします | `processWrapper` |111| [企業ランチャーを構成する](/docs/ja/corporate-launcher) | [バックグラウンドエージェントスーパーバイザー](/docs/ja/agent-view#how-background-sessions-are-hosted)、そのワーカー、および[その他のカバーされたバックグラウンドプロセス](/docs/ja/corporate-launcher#what-the-launcher-covers)に、エージェントビューをオフにする代わりに、必須の企業ランチャーをプレフィックスします | `processWrapper` |

111| [モデル制限](/docs/ja/model-config#restrict-model-selection) | `availableModels` はピッカーに表示されるモデルをフィルタリングします。`enforceAvailableModels` を追加すると、自動選択されたデフォルトモデルも制限されます。このセッティングが CLI、ウェブ、IDE にどのように到達するかについては、[サーフェスカバレッジ](/docs/ja/model-config#surface-coverage)を参照してください | `availableModels`、`enforceAvailableModels` |112| [モデル制限](/docs/ja/model-config#restrict-model-selection) | `availableModels` はピッカーに表示されるモデルをフィルタリングします。`enforceAvailableModels` を追加すると、自動選択されたデフォルトモデルも制限されます。このセッティングが CLI、ウェブ、IDE にどのように到達するかについては、[サーフェスカバレッジ](/docs/ja/model-config#surface-coverage)を参照してください | `availableModels`、`enforceAvailableModels` |

418 ```418 ```

419</CodeGroup>419</CodeGroup>

420 420 

421リダイレクトをブロックを確認するには、コールバックを `PreToolUse` に `Write|Edit` マッチャーで登録し、エージェントに `/etc` の下にファイルを作成するよう指示します。メッセージストリーム内の Write ツールの結果に `Writing to /etc is not allowed` が含まれ、ファイルは作成されません。

422 

421<h3 id="auto-approve-specific-tools">423<h3 id="auto-approve-specific-tools">

422 特定のツールを自動承認する424 特定のツールを自動承認する

423</h3>425</h3>

468 470 

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

470 472 

471以下の例は、すべてのツール呼び出しに対して 3 つの独立したチェックを登録します。473以下の例は、すべてのツール呼び出しに対して 3 つの独立したチェックを登録します。例の中のフック名（Python の `audit_logger` や TypeScript の `auditLogger` など）は、定義するコールバックの代わりになります。

472 474 

473<CodeGroup>475<CodeGroup>

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

500 マルチツールマッチャーでフィルタリングする502 マルチツールマッチャーでフィルタリングする

501</h3>503</h3>

502 504 

503マルチツールマッチャーを使用して、関連するツール間で 1 つのコールバックを共有します。この例は異なるスコープを持つ 3 つのマッチャーを登録します。505マルチツールマッチャーを使用して、関連するツール間で 1 つのコールバックを共有します。この例は異なるスコープを持つ 3 つのマッチャーを登録し、各フックが名前の代わりになります。

504 506 

505* パイプで区切られた正確なリスト（`Write|Edit|NotebookEdit`）は、ファイル変更ツールに対してのみ `file_security_hook` をトリガーします。507* パイプで区切られた正確なリスト（`Write|Edit|NotebookEdit`）は、ファイル変更ツールに対してのみ `file_security_hook` をトリガーします。

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

585 ```587 ```

586</CodeGroup>588</CodeGroup>

587 589 

590フックが発火することを確認するには、コールバックを登録し、エージェントに小さなタスクをサブエージェントに委譲するよう指示します。例えば、現在のディレクトリ内のファイルをリストアップするなど。サブエージェントが完了すると、コールバックはサブエージェントの ID とトランスクリプトパスを含む `[SUBAGENT] Completed:` 行を出力します。

591 

588<h3 id="make-http-requests-from-hooks">592<h3 id="make-http-requests-from-hooks">

589 フックから HTTP リクエストを実行する593 フックから HTTP リクエストを実行する

590</h3>594</h3>

121 121 

122権限モードは、Claude がツールをどのように使用するかについてグローバルコントロールを提供します。`query()` を呼び出すときに権限モードを設定するか、ストリーミングセッション中に動的に変更できます。122権限モードは、Claude がツールをどのように使用するかについてグローバルコントロールを提供します。`query()` を呼び出すときに権限モードを設定するか、ストリーミングセッション中に動的に変更できます。

123 123 

124設定しない場合、Claude Code は [セッションが開始するモード](/docs/ja/permission-modes#which-mode-a-session-starts-in) のルールに従って開始権限モードを選択します。

125 

126* セッションの [設定ファイル](/docs/ja/settings#where-settings-live) から `permissions.defaultMode` が適用される場合

127* それ以外の場合は、[自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) である可能性がある組み込みデフォルト

128 

129自動モードで開始するセッションは、[自動モードがアクションを評価する方法](/docs/ja/permission-modes#how-auto-mode-evaluates-actions) で説明されているように、`Bash` エントリなどの広い許可ルールを削除します。アプリケーションが `default` モードまたはそのようなルールに依存している場合は、`default` を明示的に渡してください。

130 

131TypeScript Agent SDK v0.3.286 より前では、`permissionMode` を省略することは `default` を渡すことと同じでした。

132 

124<h3 id="available-modes">133<h3 id="available-modes">

125 利用可能なモード134 利用可能なモード

126</h3>135</h3>

517 async def set_model(self, model: str | None = None) -> None517 async def set_model(self, model: str | None = None) -> None

518 async def rewind_files(self, user_message_id: str) -> None518 async def rewind_files(self, user_message_id: str) -> None

519 async def get_mcp_status(self) -> McpStatusResponse519 async def get_mcp_status(self) -> McpStatusResponse

520 async def get_context_usage(self) -> ContextUsageResponse

520 async def reconnect_mcp_server(self, server_name: str) -> None521 async def reconnect_mcp_server(self, server_name: str) -> None

521 async def toggle_mcp_server(self, server_name: str, enabled: bool) -> None522 async def toggle_mcp_server(self, server_name: str, enabled: bool) -> None

522 async def stop_task(self, task_id: str) -> None523 async def stop_task(self, task_id: str) -> None

536| `receive_messages()` | Claude からのすべてのメッセージを非同期イテレータとして受け取ります |537| `receive_messages()` | Claude からのすべてのメッセージを非同期イテレータとして受け取ります |

537| `receive_response()` | ResultMessage を含むまでのメッセージを受け取ります |538| `receive_response()` | ResultMessage を含むまでのメッセージを受け取ります |

538| `interrupt()` | 割り込み信号を送信します（ストリーミングモードでのみ機能） |539| `interrupt()` | 割り込み信号を送信します（ストリーミングモードでのみ機能） |

539| `set_permission_mode(mode)` | 現在のセッションのパーミッションモードを変更します |540| `set_permission_mode(mode)` | 現在のセッションの権限モードを変更します |

540| `set_model(model)` | 現在のセッションのモデルを変更します。[Claude Code のデフォルトモデル](/docs/ja/model-config) にリセットするには `None` を渡します |541| `set_model(model)` | 現在のセッションのモデルを変更します。[Claude Code のデフォルトモデル](/docs/ja/model-config) にリセットするには `None` を渡します |

541| `rewind_files(user_message_id)` | ファイルを指定されたユーザーメッセージの状態に復元します。`enable_file_checkpointing=True` が必要です。[ファイルチェックポイント](/docs/ja/agent-sdk/file-checkpointing) を参照 |542| `rewind_files(user_message_id)` | ファイルを指定されたユーザーメッセージの状態に復元します。`enable_file_checkpointing=True` が必要です。[ファイルチェックポイント](/docs/ja/agent-sdk/file-checkpointing) を参照 |

542| `get_mcp_status()` | すべての設定済み MCP サーバーのステータスを取得します。[`McpStatusResponse`](#mcpstatusresponse) を返します |543| `get_mcp_status()` | すべての設定済み MCP サーバーのステータスを取得します。[`McpStatusResponse`](#mcpstatusresponse) を返します |

544| `get_context_usage()` | カテゴリ、スキル、ツール別のコンテキストウィンドウ使用状況の内訳を取得します。インタラクティブセッションで `/context` が表示するのと同じデータです。[`ContextUsageResponse`](#contextusageresponse) を返します。内訳を計算するために、Claude Code はメッセージストリームに表示されないいくつかのトークンカウント API リクエストを行います。[これらのリクエストがどのように処理されるかを参照](#contextusageresponse) |

543| `reconnect_mcp_server(server_name)` | 失敗したか切断された MCP サーバーへの再接続を試みます |545| `reconnect_mcp_server(server_name)` | 失敗したか切断された MCP サーバーへの再接続を試みます |

544| `toggle_mcp_server(server_name, enabled)` | セッション中に MCP サーバーを有効または無効にします。無効にするとそのツールが削除されます |546| `toggle_mcp_server(server_name, enabled)` | セッション中に MCP サーバーを有効または無効にします。stdio、SSE、または HTTP サーバーを無効にするとそのツールが削除されます |

545| `stop_task(task_id)` | 実行中のバックグラウンドタスクを停止します。ステータス `"stopped"` の [`TaskNotificationMessage`](#tasknotificationmessage) がメッセージストリームに続きます |547| `stop_task(task_id)` | 実行中のバックグラウンドタスクを停止します。ステータス `"stopped"` の [`TaskNotificationMessage`](#tasknotificationmessage) がメッセージストリームに続きます |

546| `get_server_info()` | サーバーの初期化情報（利用可能なコマンドと出力スタイルを含む）を取得します |548| `get_server_info()` | サーバーの初期化情報（利用可能なコマンドと出力スタイルを含む）を取得します |

547| `disconnect()` | Claude から切断します |549| `disconnect()` | Claude から切断します |

616 例 - ClaudeSDKClient でのストリーミング入力618 例 - ClaudeSDKClient でのストリーミング入力

617</h4>619</h4>

618 620 

621`query()` はユーザーメッセージ辞書の非同期イテレータも受け入れるため、送信時にプロンプトを組み立てたり、画像などのコンテンツブロックを含めたりできます。Claude Code は最初に生成されたメッセージが到着するとすぐに応答を開始し、イテレータが完了するのを待たず、`receive_response()` はそのレスポンスを終了する `ResultMessage` で停止します。Claude が回答する前に読むべきすべてのものを 1 つのメッセージに入れてください。このジェネレータが行うように、各 `query()` 呼び出しを独自の `receive_response()` ループとペアにしてください。

622 

619```python theme={null}623```python theme={null}

620import asyncio624import asyncio

621from claude_agent_sdk import ClaudeSDKClient625from claude_agent_sdk import ClaudeSDKClient

622 626 

623 627 

624async def message_stream():628async def message_stream():

625 """Generate messages dynamically."""629 """Assemble the prompt at send time and yield it as one user message."""

626 yield {630 readings = {"Temperature": "25°C", "Humidity": "60%"}

627 "type": "user",631 data = ", ".join(f"{name}: {value}" for name, value in readings.items())

628 "message": {"role": "user", "content": "Analyze the following data:"},

629 }

630 await asyncio.sleep(0.5)

631 yield {

632 "type": "user",

633 "message": {"role": "user", "content": "Temperature: 25°C, Humidity: 60%"},

634 }

635 await asyncio.sleep(0.5)

636 yield {632 yield {

637 "type": "user",633 "type": "user",

638 "message": {"role": "user", "content": "What patterns do you see?"},634 "message": {

635 "role": "user",

636 "content": f"Analyze the following sensor data and describe any patterns you see: {data}",

637 },

639 }638 }

640 639 

641 640 

705</Note>704</Note>

706 705 

707<h4 id="example-advanced-permission-control">706<h4 id="example-advanced-permission-control">

708 例 - 高度なパーミッション制御707 例 - 高度な権限制御

709</h4>708</h4>

710 709 

711```python theme={null}710```python theme={null}

1607| `scope` | `str`（オプション） | 設定スコープ |1606| `scope` | `str`（オプション） | 設定スコープ |

1608| `tools` | `list`（オプション） | このサーバーが提供するツール。各ツールには`name`、`description`、`annotations`フィールドがあります |1607| `tools` | `list`（オプション） | このサーバーが提供するツール。各ツールには`name`、`description`、`annotations`フィールドがあります |

1609 1608 

1609<h3 id="contextusageresponse">

1610 `ContextUsageResponse`

1611</h3>

1612 

1613[`ClaudeSDKClient.get_context_usage()`](#methods)からの応答。これはClaude Codeがインタラクティブセッションで`/context`コマンド用にレンダリングするのと同じペイロードであるため、トークンカウントと共に、Claude Codeが`/context`使用グリッドを描画するために使用する`color`と`gridRows`などの表示フィールドを含みます。

1614 

1615Claude Codeは[トークンカウント](https://platform.claude.com/docs/en/build-with-claude/token-counting)APIに複数のリクエストを送信することでこのペイロードを構築します。これらのリクエストはメッセージストリームに表示されないため、ストリームを読み取るコスト追跡はそれらを見ません。Anthropic APIでは、トークンカウントは請求されません。

1616 

1617```python theme={null}

1618class ContextUsageResponse(TypedDict):

1619 categories: list[ContextUsageCategory]

1620 totalTokens: int

1621 maxTokens: int

1622 rawMaxTokens: int

1623 percentage: float

1624 model: str

1625 isAutoCompactEnabled: bool

1626 memoryFiles: list[dict[str, Any]]

1627 mcpTools: list[dict[str, Any]]

1628 agents: list[dict[str, Any]]

1629 gridRows: list[list[dict[str, Any]]]

1630 autoCompactThreshold: NotRequired[int]

1631 deferredBuiltinTools: NotRequired[list[dict[str, Any]]]

1632 systemTools: NotRequired[list[dict[str, Any]]]

1633 systemPromptSections: NotRequired[list[dict[str, Any]]]

1634 slashCommands: NotRequired[dict[str, Any]]

1635 skills: NotRequired[dict[str, Any]] # skill usage with frontmatter breakdown

1636 messageBreakdown: NotRequired[dict[str, Any]] # message tokens by type

1637 apiUsage: NotRequired[dict[str, Any] | None]

1638```

1639 

1640各`ContextUsageCategory`エントリは`name`、`tokens`、`color`、およびオプションの`isDeferred`フラグを含みます。`totalTokens`はセッションの現在のコンテキスト使用状況であり、`maxTokens`はその使用状況が測定されるウィンドウです。そのウィンドウはモデルのコンテキストウィンドウ、または自動コンパクション ウィンドウが適用される場合はより低いウィンドウであり、`rawMaxTokens`は`maxTokens`と同じ値を含みます。`apiUsage`はセッションの実行合計ではなく、最新のAPI応答からの使用状況を保持します。Claude Codeはオプションの`deferredBuiltinTools`、`systemTools`、`systemPromptSections`キーを設定しないため、型が宣言していても、それらが存在しないことを期待してください。

1641 

1610<h3 id="sdkpluginconfig">1642<h3 id="sdkpluginconfig">

1611 `SdkPluginConfig`1643 `SdkPluginConfig`

1612</h3>1644</h3>

2712 2744 

2713すべての組み込み Claude Code ツールの入出力スキーマのドキュメント。Python SDK はこれらを型としてエクスポートしませんが、メッセージ内のツール入出力の構造を表します。2745すべての組み込み Claude Code ツールの入出力スキーマのドキュメント。Python SDK はこれらを型としてエクスポートしませんが、メッセージ内のツール入出力の構造を表します。

2714 2746 

2747各出力は、そのツールの [`UserMessage.tool_use_result`](#usermessage) から読み込む値です。キー名は Claude Code が発行する通りに表示されます。「存在する場合」または「オプション」というコメント付きで `| None` と注釈が付けられたキーは、適用されない場合は省略されます。

2748 

2715<h3 id="agent">2749<h3 id="agent">

2716 Agent2750 Agent

2717</h3>2751</h3>

2729 "run_in_background": bool | None, # エージェントはデフォルトでバックグラウンドで実行されます。同期実行する場合は False に設定2763 "run_in_background": bool | None, # エージェントはデフォルトでバックグラウンドで実行されます。同期実行する場合は False に設定

2730 "name": str | None, # スポーンされたエージェントの名前2764 "name": str | None, # スポーンされたエージェントの名前

2731 "team_name": str | None, # 非推奨。無視されます2765 "team_name": str | None, # 非推奨。無視されます

2732 "mode": "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan" | None, # 非推奨。無視されます。サブエージェントは親セッションの権限モードを継承します。エージェント定義フロントマターがこれをオーバーライドする場合があります2766 "mode": "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan" | None, # 非推奨。無視されます。サブエージェント継承ルールがサブエージェントの権限モードを決定します

2733 "isolation": "worktree" | "remote" | None, # エージェントの変更の分離モード2767 "isolation": "worktree" | "remote" | None, # エージェントの変更の分離モード

2734}2768}

2735```2769```

2884 2918 

2885**ツール名：** `Bash`2919**ツール名：** `Bash`

2886 2920 

2887フォアグラウンドの上限については、[タイムアウトと出力制限](/docs/ja/tools-reference#timeout-and-output-limits) を参照してください。バックグラウンド時間制限については、[バックグラウンドコマンド](/docs/ja/tools-reference#background-commands) を参照してください。2921フォアグラウンドの上限については、[タイムアウトと出力制限](/docs/ja/tools-reference#timeout-and-output-limits) を参照してください。バックグラウンド時間制限については、[バックグラウンドコマンドの時間制限](/docs/ja/tools-reference#time-limit-for-background-commands) を参照してください。

2888 2922 

2889**入力：**2923**入力：**

2890 2924 

2926 "command": str | None, # シェルスクリプト。各 stdout 行はイベント、終了はウォッチを終了2960 "command": str | None, # シェルスクリプト。各 stdout 行はイベント、終了はウォッチを終了

2927 "ws": dict | None, # WebSocket ソース：{"url": str, "protocols": list[str] | None}。各テキストフレームはイベント2961 "ws": dict | None, # WebSocket ソース：{"url": str, "protocols": list[str] | None}。各テキストフレームはイベント

2928 "description": str, # 通知に表示される短い説明2962 "description": str, # 通知に表示される短い説明

2929 "timeout_ms": int | None, # この期限後に強制終了（デフォルト 300000、最大 3600000。有効な期限は最大 1800000）2963 "timeout_ms": int | None, # 期限（ミリ秒）（デフォルト 300000、最大 3600000。有効な期限は最大 1800000）

2930}2964}

2931```2965```

2932 2966 

2961 2995 

2962```python theme={null}2996```python theme={null}

2963{2997{

2964 "message": str, # 確認メッセージ2998 "filePath": str, # 編集されたファイル

2965 "replacements": int, # 実行された置換の数2999 "oldString": str, # 置換されたテキスト

2966 "file_path": str, # 編集されたファイルパス3000 "newString": str, # それを置換したテキスト

3001 "originalFile": str | None, # 編集前のファイルコンテンツ

3002 "structuredPatch": [ # 変更の差分ハンク

3003 {

3004 "oldStart": int,

3005 "oldLines": int,

3006 "newStart": int,

3007 "newLines": int,

3008 "lines": list[str],

3009 }

3010 ],

3011 "userModified": bool, # ユーザーが提案された編集を受け入れる前に変更したかどうか

3012 "replaceAll": bool, # すべての出現が置換されたかどうか

3013 "gitDiff": { # ファイルのオプションの git 差分サマリー

3014 "filename": str,

3015 "status": "modified" | "added",

3016 "additions": int,

3017 "deletions": int,

3018 "changes": int,

3019 "patch": str,

3020 "repository": str | None, # 利用可能な場合は GitHub owner/repo

3021 } | None,

2967}3022}

2968```3023```

2969 3024 

2983}3038}

2984```3039```

2985 3040 

2986**出力（テキストファイル）：**3041出力は Claude が読み込んだ内容に応じて、以下の形状のいずれかを取ります。`type` キーをチェックして区別してください。

3042 

3043**出力（type：`"text"`）：**

3044 

3045```python theme={null}

3046{

3047 "type": "text",

3048 "file": {

3049 "filePath": str, # 読み込まれたファイル

3050 "content": str, # 返されたコンテンツ

3051 "numLines": int, # 返されたコンテンツの行数

3052 "startLine": int, # コンテンツが開始する行番号

3053 "totalLines": int, # ファイルの総行数

3054 "truncatedByTokenCap": bool | None, # 全ファイル読み込みがトークン上限を超えた場合に存在し True。コンテンツは最初のページ

3055 },

3056}

3057```

3058 

3059**出力（type：`"image"`）：**

3060 

3061```python theme={null}

3062{

3063 "type": "image",

3064 "file": {

3065 "base64": str, # Base64 エンコードされた画像データ

3066 "type": "image/jpeg" | "image/png" | "image/gif" | "image/webp", # 画像 MIME タイプ

3067 "originalSize": int, # 元のファイルサイズ（バイト）

3068 "dimensions": { # 座標マッピング用のオプションのサイジング情報

3069 "originalWidth": int | None, # オプション。元の幅（ピクセル）

3070 "originalHeight": int | None, # オプション。元の高さ（ピクセル）

3071 "displayWidth": int | None, # オプション。リサイズ後の幅

3072 "displayHeight": int | None, # オプション。リサイズ後の高さ

3073 } | None,

3074 },

3075}

3076```

3077 

3078**出力（type：`"notebook"`）：**

3079 

3080```python theme={null}

3081{

3082 "type": "notebook",

3083 "file": {

3084 "filePath": str, # 読み込まれたノートブック

3085 "cells": list, # ノートブックセル

3086 },

3087}

3088```

3089 

3090**出力（type：`"pdf"`）：**

3091 

3092```python theme={null}

3093{

3094 "type": "pdf",

3095 "file": {

3096 "filePath": str, # 読み込まれた PDF

3097 "base64": str, # Base64 エンコードされた PDF データ

3098 "originalSize": int, # ファイルサイズ（バイト）

3099 },

3100}

3101```

3102 

3103**出力（type：`"parts"`）：**

2987 3104 

2988```python theme={null}3105```python theme={null}

2989{3106{

2990 "content": str, # 行番号付きのファイル内容3107 "type": "parts",

2991 "total_lines": int, # ファイルの総行数3108 "file": {

2992 "lines_returned": int, # 実際に返された行数3109 "filePath": str, # 読み込まれた PDF

3110 "originalSize": int, # ファイルサイズ（バイト）

3111 "count": int, # 画像として抽出されたページ数

3112 "outputDir": str, # 抽出されたページ画像を含むディレクトリ

3113 },

3114 "firstPage": int | None, # オプション。最初に抽出されたページのドキュメントページ番号

2993}3115}

2994```3116```

2995 3117 

2996**出力（画像）：**3118**出力（type：`"file_unchanged"`）：**

2997 3119 

2998```python theme={null}3120```python theme={null}

2999{3121{

3000 "image": str, # Base64 エンコードされた画像データ3122 "type": "file_unchanged", # ファイルはこのセッションで Claude が最後に読み込んだ以降変更されていないため、コンテンツは繰り返されません

3001 "mime_type": str, # 画像の MIME タイプ3123 "file": {

3002 "file_size": int, # ファイルサイズ（バイト）3124 "filePath": str,

3125 },

3126 "source": "seeded" | None, # 以前のコピーが起動時に読み込まれた CLAUDE.md またはメモリファイルから来た場合に存在

3003}3127}

3004```3128```

3005 3129 

3022 3146 

3023```python theme={null}3147```python theme={null}

3024{3148{

3025 "message": str, # 成功メッセージ3149 "type": "create" | "update", # 書き込みが新しいファイルを作成したか、既存のファイルを上書きしたか

3026 "bytes_written": int, # 書き込まれたバイト数3150 "filePath": str, # 書き込まれたファイル

3027 "file_path": str, # 書き込まれたファイルパス3151 "content": str, # 書き込まれたコンテンツ

3152 "structuredPatch": [ # 差分ハンク。新しいファイル、何も変更されなかった場合、または Claude Code が差分をスキップした場合は空

3153 {

3154 "oldStart": int,

3155 "oldLines": int,

3156 "newStart": int,

3157 "newLines": int,

3158 "lines": list[str],

3159 }

3160 ],

3161 "originalFile": str | None, # 以前のコンテンツ。新しいファイルの場合または以前のコンテンツが大きすぎて含められない場合は None

3162 "gitDiff": { # ファイルのオプションの git 差分サマリー

3163 "filename": str,

3164 "status": "modified" | "added",

3165 "additions": int,

3166 "deletions": int,

3167 "changes": int,

3168 "patch": str,

3169 "repository": str | None, # 利用可能な場合は GitHub owner/repo

3170 } | None,

3171 "userModified": bool | None, # オプション。ユーザーが受け入れる前に提案されたコンテンツを編集したかどうか

3028}3172}

3029```3173```

3030 3174 

3047 3191 

3048```python theme={null}3192```python theme={null}

3049{3193{

3050 "matches": list[str], # マッチしたファイルパスの配列3194 "durationMs": int, # 検索の実行に要した時間（ミリ秒）

3051 "count": int, # 見つかったマッチの数3195 "numFiles": int, # 返されたパスの数。切り詰め後

3052 "search_path": str, # 使用された検索ディレクトリ3196 "filenames": list[str], # マッチしたファイルパス

3197 "truncated": bool, # 結果が 100 ファイルの上限で切り詰められたかどうか

3198 "totalMatches": int | None, # オプション。切り詰め前のマッチするファイルの総数。countIsComplete が False の場合は下限

3199 "countIsComplete": bool | None, # オプション。totalMatches が正確かどうか

3053}3200}

3054```3201```

3055 3202 

3203`totalMatches` と `countIsComplete` には Claude Code v2.1.191 以降が必要です。

3204 

3056<h3 id="grep">3205<h3 id="grep">

3057 Grep3206 Grep

3058</h3>3207</h3>

3073 "-B": int | None, # 各マッチの前に表示する行3222 "-B": int | None, # 各マッチの前に表示する行

3074 "-A": int | None, # 各マッチの後に表示する行3223 "-A": int | None, # 各マッチの後に表示する行

3075 "-C": int | None, # 前後に表示する行3224 "-C": int | None, # 前後に表示する行

3225 "context": int | None, # 前後に表示する行。-C はエイリアス

3226 "-o": bool | None, # 各行のマッチした部分のみを出力

3076 "head_limit": int | None, # 出力を最初の N 行/エントリに制限3227 "head_limit": int | None, # 出力を最初の N 行/エントリに制限

3228 "offset": int | None, # head_limit を適用する前に最初の N 行/エントリをスキップ

3077 "multiline": bool | None, # マルチラインモードを有効化3229 "multiline": bool | None, # マルチラインモードを有効化

3078}3230}

3079```3231```

3080 3232 

3081**出力（content モード）：**3233**出力：**

3082 3234 

3083```python theme={null}3235```python theme={null}

3084{3236{

3085 "matches": [3237 "mode": "content" | "files_with_matches" | "count" | None, # 使用された出力モード

3086 {3238 "numFiles": int, # 結果内のファイル数。content モードでは常に 0

3087 "file": str,3239 "filenames": list[str], # files_with_matches モードのマッチするファイル。他のモードでは空

3088 "line_number": int | None,3240 "content": str | None, # content モードのマッチする行、または count モードのファイルごとのカウント

3089 "line": str,3241 "numLines": int | None, # コンテンツ内の行数。content モードに存在

3090 "before_context": list[str] | None,3242 "numMatches": int | None, # 総マッチ数。count モードに存在

3091 "after_context": list[str] | None,3243 "totalFiles": int | None, # オプション。files_with_matches モードで head_limit と offset の前の総数

3092 }3244 "totalLines": int | None, # オプション。content モードで head_limit と offset の前の総数

3093 ],3245 "appliedLimit": int | None, # head_limit が結果を切り詰めた場合に存在

3094 "total_matches": int,3246 "appliedOffset": int | None, # オフセットが適用された場合に存在

3095}3247}

3096```3248```

3097 3249 

3098**出力（files\_with\_matches モード）：**3250Grep は各出力モードでこの dict 形状を返します。どのオプションキーが存在するかは `output_mode` に依存します。

3099 3251 

3100```python theme={null}3252`totalFiles` には Claude Code v2.1.208 以降が必要です。`totalLines` には Claude Code v2.1.210 以降が必要です。

3101{

3102 "files": list[str], # マッチを含むファイル

3103 "count": int, # マッチを含むファイルの数

3104}

3105```

3106 3253 

3107<h3 id="notebookedit">3254<h3 id="notebookedit">

3108 NotebookEdit3255 NotebookEdit

3126 3273 

3127```python theme={null}3274```python theme={null}

3128{3275{

3129 "message": str, # 成功メッセージ3276 "new_source": str, # セルに書き込まれたソース

3130 "edit_type": "replaced" | "inserted" | "deleted", # 実行された編集のタイプ3277 "old_source": str | None, # 以前のセルソース。replace と delete に存在

3131 "cell_id": str | None, # 影響を受けたセル ID3278 "cell_id": str | None, # 編集されたセルの ID。利用可能な場合

3132 "total_cells": int, # 編集後のノートブックの総セル数3279 "cell_type": "code" | "markdown", # セルタイプ

3280 "language": str, # ノートブックのプログラミング言語

3281 "edit_mode": str, # 使用された編集モード

3282 "error": str | None, # 操作が失敗した場合のエラーメッセージ

3283 "notebook_path": str, # ノートブックファイル

3284 "original_file": str, # 編集前のノートブックコンテンツ

3285 "updated_file": str, # 編集後のノートブックコンテンツ

3133}3286}

3134```3287```

3135 3288 

3227 3380 

3228```python theme={null}3381```python theme={null}

3229{3382{

3230 "message": str, # 成功メッセージ3383 "oldTodos": [ # 更新前の todo リスト

3231 "stats": {"total": int, "pending": int, "in_progress": int, "completed": int},3384 {

3385 "content": str,

3386 "status": "pending" | "in_progress" | "completed",

3387 "activeForm": str,

3388 }

3389 ],

3390 "newTodos": [ # 更新後の todo リスト

3391 {

3392 "content": str,

3393 "status": "pending" | "in_progress" | "completed",

3394 "activeForm": str,

3395 }

3396 ],

3232}3397}

3233```3398```

3234 3399 

3400 3565 

3401```python theme={null}3566```python theme={null}

3402{3567{

3403 "message": str, # 確認メッセージ3568 "plan": str | None, # ユーザーに提示されたプラン

3404 "approved": bool | None, # ユーザーがプランを承認したかどうか3569 "isAgent": bool, # サブエージェントがツールを呼び出した場合は True

3570 "filePath": str | None, # プランがファイルに保存された場合に存在

3571 "hasTaskTool": bool | None, # オプション。現在のコンテキストで Agent ツールが利用可能かどうか

3572 "planWasEdited": bool | None, # ユーザーが承認する前にプランを編集した場合に存在し True

3573 "awaitingLeaderApproval": bool | None, # チームメイトがプランをチームリーダーに承認を求めて送信した場合に存在し True

3574 "requestId": str | None, # その承認リクエストのオプション ID

3405}3575}

3406```3576```

3407 3577 

3419}3589}

3420```3590```

3421 3591 

3592結果は dict ではなくリストであるため、`tool_use_result` はこのツールに対して `list` を保持します。

3593 

3422**出力：**3594**出力：**

3423 3595 

3424```python theme={null}3596```python theme={null}

3425{3597[ # リソースごとに 1 つのエントリ

3426 "resources": [

3427 {3598 {

3428 "uri": str,3599 "uri": str, # リソース URI

3429 "name": str,3600 "name": str, # リソース名

3430 "description": str | None,3601 "mimeType": str | None, # オプション。MIME タイプ

3431 "mimeType": str | None,3602 "description": str | None, # オプション。説明

3432 "server": str,3603 "server": str, # このリソースを提供するサーバー

3433 }3604 }

3434 ],3605]

3435 "total": int,

3436}

3437```3606```

3438 3607 

3439<h3 id="readmcpresource">3608<h3 id="readmcpresource">

3456```python theme={null}3625```python theme={null}

3457{3626{

3458 "contents": [3627 "contents": [

3459 {"uri": str, "mimeType": str | None, "text": str | None, "blob": str | None}3628 {

3629 "uri": str, # リソース URI

3630 "mimeType": str | None, # オプション。MIME タイプ

3631 "text": str | None, # テキストコンテンツ、またはバイナリコンテンツに関する注記

3632 "blobSavedTo": str | None, # Claude Code がバイナリコンテンツをディスクに保存した場合に存在。保存されたファイルのパス

3633 }

3460 ],3634 ],

3461 "server": str,3635 "error": str | None, # サーバーがリソースを読み込めなかった場合に存在

3462}3636}

3463```3637```

3464 3638 

97 戻り値97 戻り値

98</h4>98</h4>

99 99 

100[`Query`](#query-object) オブジェクトを返します。これは `AsyncGenerator<`[`SDKMessage`](#sdkmessage)`, void>` を拡張し、追加のメソッドを備えています。100[`Query`](#query-object) オブジェクトを返します。このオブジェクトは `AsyncGenerator<`[`SDKMessage`](#sdkmessage)`, void>` を拡張し、追加のメソッドを備えています。

101 101 

102<h3 id="startup">102<h3 id="startup">

103 `startup()`103 `startup()`

104</h3>104</h3>

105 105 

106プロンプトが利用可能になる前に CLI サブプロセスをプリウォーミングします。これはサブプロセスを生成し、初期化ハンドシェイクを完了します。返された [`WarmQuery`](#warmquery) ハンドルは後でプロンプトを受け入れ、既に準備ができているプロセスに書き込むため、最初の `query()` 呼び出しはサブプロセスの生成と初期化コストをインラインで支払うことなく解決します。セッションの作業ディレクトリがまだわからない場合は、代わりに [`prewarm()`](#prewarm) を使用してください。106CLI サブプロセスをプリウォーミングします。プロセスを生成し、プロンプトが利用可能になる前に初期化ハンドシェイクを完了します。返された [`WarmQuery`](#warmquery) ハンドルは後でプロンプトを受け入れ、既に準備ができているプロセスに書き込むため、最初の `query()` 呼び出しはサブプロセスの生成と初期化のコストをインラインで支払うことなく解決します。セッションの作業ディレクトリがまだわからない場合は、代わりに [`prewarm()`](#prewarm) を使用してください。

107 107 

108```typescript theme={null}108```typescript theme={null}

109function startup(params?: {109function startup(params?: {

131 例131 例

132</h4>132</h4>

133 133 

134`startup()` を早期に呼び出します。たとえば、アプリケーション起動時に呼び出してから、プロンプトが準備できたら返されたハンドルで `.query()` を呼び出します。これにより、サブプロセスの生成と初期化をクリティカルパスから外します。134`startup()` を早期に呼び出します。たとえば、アプリケーション起動時に呼び出し、プロンプトが準備できたら返されたハンドルで `.query()` を呼び出します。これにより、サブプロセスの生成と初期化がクリティカルパスから外れます。

135 135 

136```typescript theme={null}136```typescript theme={null}

137import { startup } from "@anthropic-ai/claude-agent-sdk";137import { startup } from "@anthropic-ai/claude-agent-sdk";

151 151 

152*アルファ版。* どのセッションに対応するかわかる前に Claude Code プロセスをスペアとして開始します。後で [`claim()`](#spareprocess) を使用してセッションにバインドできます。ユーザーがフォルダを選択する前に起動するアプリケーションで使用します。TypeScript Agent SDK v0.3.282 以降が必要です。152*アルファ版。* どのセッションに対応するかわかる前に Claude Code プロセスをスペアとして開始します。後で [`claim()`](#spareprocess) を使用してセッションにバインドできます。ユーザーがフォルダを選択する前に起動するアプリケーションで使用します。TypeScript Agent SDK v0.3.282 以降が必要です。

153 153 

154`prewarm()` は [`startup()`](#startup) と同じ初期化ハンドシェイクを完了します。`options.cwd` を設定した場合はそのディレクトリで、それ以外の場合は Claude Code 設定ディレクトリの下のプライベート一時ディレクトリでプロセスが待機します。セッションの作業ディレクトリ、その `SessionStart` フック、その stdio MCP サーバー、その CLAUDE.md と git コンテキストはクレームを待ちます。スペアは待機中に約 230 ～ 260 MB のメモリを保持します。[`spawnClaudeCodeProcess`](#options) が別のマシンまたはコンテナで Claude Code を実行する場合は、`options.cwd` をそこに存在するディレクトリに設定して、スペアが待機するようにします。154`prewarm()` は [`startup()`](#startup) と同じ初期化ハンドシェイクを完了します。`options.cwd` を設定した場合はそのディレクトリで、それ以外の場合は Claude Code 設定ディレクトリ下のプライベート一時ディレクトリでプロセスが待機します。セッションの作業ディレクトリ、その `SessionStart` フック、その stdio MCP サーバー、その CLAUDE.md と git コンテキストはクレームを待ちます。スペアは待機中に約 230 ～ 260 MB のメモリを保持します。[`spawnClaudeCodeProcess`](#options) が別のマシンまたはコンテナで Claude Code を実行する場合は、`options.cwd` をそこに存在するディレクトリに設定して、スペアが待機するようにしてください。

155 155 

156```typescript theme={null}156```typescript theme={null}

157function prewarm(params?: {157function prewarm(params?: {

160}): Promise<SpareProcess>;160}): Promise<SpareProcess>;

161```161```

162 162 

163`options` と `initializeTimeoutMs` は `startup()` と同じ意味ですが、`options.cwd` はスペアが待機するディレクトリのみを設定します。プロミスはプロセスが初期化ハンドシェイクを完了したら [`SpareProcess`](#spareprocess) で解決します。`prewarm()` は `options` が `resume`、`continue`、または `forkSession` を設定する場合にスローします。スペアはまだセッションを持たないためです。クレームが設定できないすべてのもの（`mcpServers`、`hooks`、`canUseTool`、`settingSources`、`systemPrompt`、`plugins` など）はスペアの生涯にわたって固定されるため、これらのオプションの異なるセットごとに 1 つのスペアを保持し、それらが変更されたら再度プリウォームします。163`options` と `initializeTimeoutMs` は `startup()` と同じ意味ですが、`options.cwd` はスペアが待機するディレクトリのみを設定します。プロミスは、プロセスが初期化ハンドシェイクを完了したら [`SpareProcess`](#spareprocess) で解決します。`prewarm()` は `options` が `resume`、`continue`、または `forkSession` を設定する場合にスローします。スペアにはセッションがないためです。クレームが設定できないもの（`mcpServers`、`hooks`、`canUseTool`、`settingSources`、`systemPrompt`、`plugins` など）はスペアの存続期間中固定されるため、それらのオプションの異なるセットごとに 1 つのスペアを保持し、変更時に再度プリウォーミングしてください。

164 164 

165<h4 id="example-2">165<h4 id="example-2">

166 例166 例

167</h4>167</h4>

168 168 

169アプリケーション起動時にプリウォームしてから、ユーザーがセッションを開始したときにスペアをクレームします。169アプリケーション起動時にプリウォーミングし、ユーザーがセッションを開始したときにスペアをクレームします。

170 170 

171```typescript theme={null}171```typescript theme={null}

172import { prewarm } from "@anthropic-ai/claude-agent-sdk";172import { prewarm } from "@anthropic-ai/claude-agent-sdk";

223 `ToolAnnotations`223 `ToolAnnotations`

224</h4>224</h4>

225 225 

226`@modelcontextprotocol/sdk/types.js` から再エクスポートされます。すべてのフィールドはオプションのヒントです。クライアントはセキュリティ決定のためにそれらに依存すべきではありません。226`@modelcontextprotocol/sdk/types.js` で定義されています。すべてのフィールドはオプションのヒントです。クライアントはセキュリティ決定のためにそれらに依存すべきではありません。

227 227 

228| フィールド | 型 | デフォルト | 説明 |228| フィールド | 型 | デフォルト | 説明 |

229| :- | :- | :- | :- |229| :- | :- | :- | :- |

276| `options.instructions` | `string` | オプションのサーバー指示。`initialize` から返され、MCP 指示ブロックとしてモデルに表示されます |276| `options.instructions` | `string` | オプションのサーバー指示。`initialize` から返され、MCP 指示ブロックとしてモデルに表示されます |

277| `options.tools` | `Array<SdkMcpToolDefinition>` | [`tool()`](#tool) で作成されたツール定義の配列 |277| `options.tools` | `Array<SdkMcpToolDefinition>` | [`tool()`](#tool) で作成されたツール定義の配列 |

278| `options.alwaysLoad` | `boolean` | `true` の場合、このサーバーのすべてのツールは初期プロンプトに留まり、[ツール検索](/docs/ja/agent-sdk/tool-search) の背後で遅延されることはありません。[`tool()`](#tool) のツール単位の `alwaysLoad` と組み合わせます |278| `options.alwaysLoad` | `boolean` | `true` の場合、このサーバーのすべてのツールは初期プロンプトに留まり、[ツール検索](/docs/ja/agent-sdk/tool-search) の背後で遅延されることはありません。[`tool()`](#tool) のツール単位の `alwaysLoad` と組み合わせます |

279| `options.timeout` | `number` | このサーバーのツール呼び出しのタイムアウト（ミリ秒）。Claude Code はこれを [`MCP_TOOL_TIMEOUT`](/docs/ja/env-vars) の代わりにこのサーバーに適用します。1000 以上の整数を渡します。Claude Code は他の値を無視します。TypeScript Agent SDK v0.3.248 以降が必要です |279| `options.timeout` | `number` | このサーバーのツール呼び出しのタイムアウト（ミリ秒）。Claude Code はこれを [`MCP_TOOL_TIMEOUT`](/docs/ja/env-vars) の代わりにこのサーバーに適用します。1000 以上の整数を渡してください。Claude Code は他の値を無視します。TypeScript Agent SDK v0.3.248 以降が必要です |

280 280 

281<h3 id="listsessions">281<h3 id="listsessions">

282 `listSessions()`282 `listSessions()`

308| `summary` | `string` | 表示タイトル：カスタムタイトル、最新のプロンプト、自動生成されたサマリー、または最初のプロンプト |308| `summary` | `string` | 表示タイトル：カスタムタイトル、最新のプロンプト、自動生成されたサマリー、または最初のプロンプト |

309| `lastModified` | `number` | エポック以降のミリ秒単位での最後の変更時刻 |309| `lastModified` | `number` | エポック以降のミリ秒単位での最後の変更時刻 |

310| `fileSize` | `number \| undefined` | セッションファイルサイズ（バイト）。ローカル JSONL ストレージの場合のみ入力されます |310| `fileSize` | `number \| undefined` | セッションファイルサイズ（バイト）。ローカル JSONL ストレージの場合のみ入力されます |

311| `customTitle` | `string \| undefined` | ユーザーが設定したセッションタイトル（`--name`、`/rename`、フックの `sessionTitle` 出力、または [`renameSession()`](#renamesession) 経由など）。それ以外の場合は AI が生成したセッションタイトル（セッションがある場合） |311| `customTitle` | `string \| undefined` | `--name`、`/rename`、フックの `sessionTitle` 出力、または [`renameSession()`](#renamesession) で設定されている場合のセッションのカスタムタイトル。それ以外の場合は、セッションがある場合は AI 生成のセッションタイトル |

312| `firstPrompt` | `string \| undefined` | セッション内の最初の意味のあるユーザープロンプト |312| `firstPrompt` | `string \| undefined` | セッション内の最初の意味のあるユーザープロンプト |

313| `gitBranch` | `string \| undefined` | セッション終了時の git ブランチ |313| `gitBranch` | `string \| undefined` | セッション終了時の git ブランチ |

314| `cwd` | `string \| undefined` | セッションの作業ディレクトリ |314| `cwd` | `string \| undefined` | セッションの作業ディレクトリ |

351| パラメータ | 型 | デフォルト | 説明 |351| パラメータ | 型 | デフォルト | 説明 |

352| :- | :- | :- | :- |352| :- | :- | :- | :- |

353| `sessionId` | `string` | 必須 | 読み取るセッション UUID（`listSessions()` を参照） |353| `sessionId` | `string` | 必須 | 読み取るセッション UUID（`listSessions()` を参照） |

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

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

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

357 357 

408 408 

409| パラメータ | 型 | デフォルト | 説明 |409| パラメータ | 型 | デフォルト | 説明 |

410| :- | :- | :- | :- |410| :- | :- | :- | :- |

411| `sessionId` | `string` | 必須 | 検索するセッションの UUID |411| `sessionId` | `string` | 必須 | ルックアップするセッションの UUID |

412| `options.dir` | `string` | `undefined` | プロジェクトディレクトリパス。省略した場合、すべてのプロジェクトディレクトリを検索します |412| `options.dir` | `string` | `undefined` | プロジェクトディレクトリパス。省略した場合、すべてのプロジェクトディレクトリを検索します |

413 413 

414[`SDKSessionInfo`](#return-type-sdksessioninfo) を返すか、セッションが見つからない場合は `undefined` を返します。414[`SDKSessionInfo`](#return-type-sdksessioninfo) を返すか、セッションが見つからない場合は `undefined` を返します。

465 `resolveSettings()`465 `resolveSettings()`

466</h3>466</h3>

467 467 

468CLI と同じマージエンジンを使用して、Claude Code プロセスを生成せずに、指定されたディレクトリの有効な Claude Code 設定を解決します。`query()` 呼び出しを呼び出す前に、設定がどのような設定を見るかを検査するために使用します。468CLI を生成せずに、CLI と同じマージエンジンを使用して、指定されたディレクトリの有効な Claude Code 設定を解決します。`query()` 呼び出しを呼び出す前に、設定がどのような設定を見るかを検査するために使用します。

469 469 

470<Note>470<Note>

471 この関数はアルファ版であり、安定化前に API が変更される可能性があります。471 この関数はアルファ版であり、安定化前に API が変更される可能性があります。

474スナップショットはライブ `query()` セッションが適用するものと異なります。474スナップショットはライブ `query()` セッションが適用するものと異なります。

475 475 

476* **`policyHelper`**：`resolveSettings()` は MDM ソース（macOS plist と Windows HKLM/HKCU を含む）を読み取りますが、管理者が設定した `policyHelper` サブプロセスを実行しません。476* **`policyHelper`**：`resolveSettings()` は MDM ソース（macOS plist と Windows HKLM/HKCU を含む）を読み取りますが、管理者が設定した `policyHelper` サブプロセスを実行しません。

477* **サーバー管理設定**：`resolveSettings()` は [サーバー管理設定](/docs/ja/server-managed-settings#fetch-and-caching-behavior) をフェッチしません。それらを含めるには `options.serverManagedSettings` として渡します。477* **サーバー管理設定**：`resolveSettings()` は [サーバー管理設定](/docs/ja/server-managed-settings#fetch-and-caching-behavior) をフェッチしません。それらを含めるには `options.serverManagedSettings` として渡してください。

478* **`defaultMode`**：スナップショットは `permissions.defaultMode` をすべてのティアから現状のまま返すため、プロジェクトおよびローカル設定からの `'auto'` および `'bypassPermissions'` 値を含めることができます。これは [ライブセッションが無視する](/docs/ja/permission-modes#which-mode-a-session-starts-in) ものです。478* **`defaultMode`**：スナップショットは `permissions.defaultMode` をすべてのティアからそのまま返すため、プロジェクトおよびローカル設定からの `'auto'` および `'bypassPermissions'` 値を含めることができます。これは [ライブセッションが無視する](/docs/ja/permission-modes#which-mode-a-session-starts-in) ものです。

479 479 

480```typescript theme={null}480```typescript theme={null}

481function resolveSettings(481function resolveSettings(

492| パラメータ | 型 | デフォルト | 説明 |492| パラメータ | 型 | デフォルト | 説明 |

493| :- | :- | :- | :- |493| :- | :- | :- | :- |

494| `options.cwd` | `string` | `process.cwd()` | プロジェクトおよびローカル設定を相対的に解決するディレクトリ |494| `options.cwd` | `string` | `process.cwd()` | プロジェクトおよびローカル設定を相対的に解決するディレクトリ |

495| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | すべてのソース | どのファイルシステムソースをロードするか。ユーザー、プロジェクト、およびローカル設定をスキップするには `[]` を渡します。[エンドポイント管理ポリシー](/docs/ja/managed-settings#delivery-mechanisms) はすべての場合にロードされます。`resolveSettings()` は `options.serverManagedSettings` を渡す場合のみサーバー管理設定を含めます |495| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | すべてのソース | どのファイルシステムソースをロードするか。ユーザー、プロジェクト、およびローカル設定をスキップするには `[]` を渡してください。[エンドポイント管理ポリシー](/docs/ja/managed-settings#delivery-mechanisms) はすべての場合にロードされます。`resolveSettings()` は `options.serverManagedSettings` を渡す場合のみサーバー管理設定を含めます |

496| `options.managedSettings` | `Settings` | `undefined` | 埋め込みホストによって提供されるポリシーティア設定。[`Options`](#options) の [`managedSettings`](#options) と同じルールに従います。ただし、`resolveSettings()` は設定された [`policyHelper`](/docs/ja/settings-reference#policyhelper) を実行しないため、スナップショットはライブセッションがドロップする設定を含めることができます |496| `options.managedSettings` | `Settings` | `undefined` | 埋め込みホストによって提供されるポリシーティア設定。[`Options`](#options) の [`managedSettings`](#options) と同じルールに従います。ただし、`resolveSettings()` は設定された [`policyHelper`](/docs/ja/settings-reference#policyhelper) を実行しないため、スナップショットはライブセッションがドロップする設定を含めることができます |

497| `options.serverManagedSettings` | `Settings` | `undefined` | `/api/claude_code/settings` からのサーバー管理設定ペイロード。制限のないキーはフィルタリングなしで通過します |497| `options.serverManagedSettings` | `Settings` | `undefined` | `/api/claude_code/settings` からのサーバー管理設定ペイロード。制限のないキーはフィルタリングなしで通過します |

498 498 

504 504 

505| プロパティ | 型 | 説明 |505| プロパティ | 型 | 説明 |

506| :- | :- | :- |506| :- | :- | :- |

507| `effective` | `Settings` | すべての有効なソースを優先順位順に適用した後のマージされた設定 |507| `effective` | `Settings` | すべての有効なソースを優先順序で適用した後のマージされた設定 |

508| `provenance` | `Partial<Record<keyof Settings, ProvenanceEntry>>` | `effective` の各トップレベルキーについて、値を提供したソース |508| `provenance` | `Partial<Record<keyof Settings, ProvenanceEntry>>` | `effective` の各トップレベルキーについて、値を提供したソース |

509| `sources` | `Array<{ source, settings, path?, policyOrigin? }>` | ソースごとの生の設定。最も低い優先度から最も高い優先度の順に並べられています |509| `sources` | `Array<{ source, settings, path?, policyOrigin? }>` | ソースごとの生の設定。最も低い優先度から最も高い優先度の順に並べられています |

510 510 

512 例512 例

513</h4>513</h4>

514 514 

515以下の例はプロジェクトディレクトリの設定を解決し、クリーンアップ期間を制御するソースを出力します。設定ファイルが `cleanupPeriodDays` を設定しないマシンでは、両方の出力行は値に対して `undefined` を表示します。これはエラーではなく、予想される出力です。515以下の例は、プロジェクトディレクトリの設定を解決し、クリーンアップ期間を制御するソースを出力します。設定ファイルが `cleanupPeriodDays` を設定しないマシンでは、両方の出力行は値に対して `undefined` を表示します。これはエラーではなく、予想される出力です。

516 516 

517```typescript theme={null}517```typescript theme={null}

518import { resolveSettings } from "@anthropic-ai/claude-agent-sdk";518import { resolveSettings } from "@anthropic-ai/claude-agent-sdk";

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

540| :- | :- | :- | :- |540| :- | :- | :- | :- |

541| `abortController` | `AbortController` | `new AbortController()` | 操作をキャンセルするためのコントローラー |541| `abortController` | `AbortController` | `new AbortController()` | 操作をキャンセルするためのコントローラー |

542| `additionalDirectories` | `string[]` | `[]` | Claude Code がアクセスできる追加ディレクトリ。SDK は各エントリを Claude Code に `--add-dir` として渡すため、`project` 設定ソースを使用すると Claude Code は [ディレクトリのスキル、コマンド、サブエージェントも読み込みます](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) |542| `additionalDirectories` | `string[]` | `[]` | Claude が アクセスできる追加ディレクトリ。SDK は各エントリを Claude Code に `--add-dir` として渡すため、`project` 設定ソースを使用すると Claude Code は [ディレクトリのスキル、コマンド、サブエージェントも読み込みます](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) |

543| `agent` | `string` | `undefined` | メインスレッドのエージェント名。エージェントは `agents` オプションまたは設定で定義されている必要があります |543| `agent` | `string` | `undefined` | メインスレッドのエージェント名。エージェントは `agents` オプションまたは設定で定義されている必要があります |

544| `agents` | `Record<string, [`AgentDefinition`](#agentdefinition)>` | `undefined` | プログラムでサブエージェントを定義します |544| `agents` | `Record<string, [`AgentDefinition`](#agentdefinition)>` | `undefined` | プログラムでサブエージェントを定義します |

545| `agentProgressSummaries` | `boolean` | `false` | `true` の場合、サブエージェントの 1 行の進捗サマリーを生成し、`summary` フィールド経由で [`task_progress`](#sdktaskprogressmessage) イベントで転送します。フォアグラウンドおよびバックグラウンドサブエージェントに適用されます |545| `agentProgressSummaries` | `boolean` | `false` | `true` の場合、サブエージェントの 1 行の進捗サマリーを生成し、[`task_progress`](#sdktaskprogressmessage) イベントの `summary` フィールドで転送します。フォアグラウンドおよびバックグラウンドサブエージェントに適用されます |

546| `allowDangerouslySkipPermissions` | `boolean` | `false` | 権限をバイパスすることを有効にします。`permissionMode: 'bypassPermissions'` を使用する場合に必須です。スタートアップ時またはその後 `setPermissionMode()` を通じて設定できます。[plan mode](/docs/ja/agent-sdk/permissions#plan-mode-plan) で `permissionMode: 'plan'` との相互作用を確認してください |546| `allowDangerouslySkipPermissions` | `boolean` | `false` | 権限をバイパスすることを有効にします。`permissionMode: 'bypassPermissions'` を使用する場合に必須です。スタートアップ時またはその後 `setPermissionMode()` を通じて設定できます。[プランモード](/docs/ja/agent-sdk/permissions#plan-mode-plan)を参照して、`permissionMode: 'plan'` との相互作用を確認してください |

547| `allowedTools` | `string[]` | `[]` | プロンプトなしで自動承認するツール。これは Claude をこれらのツールのみに制限しません。[タスク追跡ツール](/docs/ja/agent-sdk/todo-tracking#model-availability) の 1 つをここで指定すると、Claude Code もセッションをオプトインします。リストされていない他のツールは `permissionMode` と `canUseTool` にフォールスルーします。ツールをブロックするには `disallowedTools` を使用してください。[権限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules) を参照してください |547| `allowedTools` | `string[]` | `[]` | プロンプトなしで自動承認するツール。これは Claude を これらのツールのみに制限しません。[タスク追跡ツール](/docs/ja/agent-sdk/todo-tracking#model-availability)の 1 つをここに名前を付けると、Claude Code もセッションをオプトインします。リストされていない他のツールは `permissionMode` と `canUseTool` にフォールスルーします。`disallowedTools` を使用してツールをブロックします。[権限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を参照してください |

548| `betas` | [`SdkBeta`](#sdkbeta)`[]` | `[]` | ベータ機能を有効にします |548| `betas` | [`SdkBeta`](#sdkbeta)`[]` | `[]` | ベータ機能を有効にします |

549| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | カスタム権限関数。[権限フロー](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated) がプロンプトにフォールスルーする場合にのみ呼び出されます。`allowedTools`、許可ルール、または `permissionMode` で自動承認された呼び出しには呼び出されません。許可ルールは [どのモードも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves) を事前承認しません。詳細は [`CanUseTool`](#canusetool) を参照してください |549| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | カスタム権限関数。[権限フロー](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)がプロンプトにフォールスルーする場合にのみ呼び出されます。`allowedTools`、許可ルール、または `permissionMode` で自動承認された呼び出しには呼び出されません。許可ルールは [どのモードも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認しません。詳細は [`CanUseTool`](#canusetool) を参照してください |

550| `continue` | `boolean` | `false` | 最新の会話を続行します |550| `continue` | `boolean` | `false` | 最新の会話を続行します |

551| `cwd` | `string` | `process.cwd()` | 現在の作業ディレクトリ |551| `cwd` | `string` | `process.cwd()` | 現在の作業ディレクトリ |

552| `debug` | `boolean` | `false` | Claude Code プロセスのデバッグモードを有効にします |552| `debug` | `boolean` | `false` | Claude Code プロセスのデバッグモードを有効にします |

553| `debugFile` | `string` | `undefined` | デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします |553| `debugFile` | `string` | `undefined` | デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします |

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

555| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | `undefined` | Claude が応答に費やす努力の量を制御します。適応的思考と連携して思考の深さをガイドします。[努力レベルを調整](/docs/ja/model-config#adjust-effort-level) を参照してください |555| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | `undefined` | Claude が応答に費やす努力の量を制御します。適応的思考と連携して思考の深さをガイドします。[努力レベルを調整](/docs/ja/model-config#adjust-effort-level)を参照してください |

556| `enableFileCheckpointing` | `boolean` | `false` | ファイル変更追跡を有効にして巻き戻しを可能にします。[ファイルチェックポイント](/docs/ja/agent-sdk/file-checkpointing) を参照してください |556| `enableFileCheckpointing` | `boolean` | `false` | ファイル変更追跡を有効にして巻き戻しを可能にします。[ファイルチェックポイント](/docs/ja/agent-sdk/file-checkpointing)を参照してください |

557| `env` | `Record<string, string \| undefined>` | `process.env` | 環境変数。設定すると、このサブプロセス環境を `process.env` とマージするのではなく置き換えるため、`PATH` のような継承変数を保持するには `{ ...process.env, YOUR_VAR: 'value' }` を渡してください。このパターンの例は [遅いまたは停止した API レスポンスを処理](#handle-slow-or-stalled-api-responses) を参照し、基盤となる CLI が読む変数については [環境変数](/docs/ja/env-vars) を参照してください。User-Agent ヘッダーでアプリを識別するには `CLAUDE_AGENT_SDK_CLIENT_APP` を設定してください |557| `env` | `Record<string, string \| undefined>` | `process.env` | 環境変数。設定すると、このサブプロセス環境を `process.env` とマージするのではなく置き換えるため、`PATH` のような継承変数を保持するには `{ ...process.env, YOUR_VAR: 'value' }` を渡してください。このパターンの例は [遅いまたは停止した API レスポンスを処理](#handle-slow-or-stalled-api-responses)を参照し、基盤となる CLI が読み取る変数については [環境変数](/docs/ja/env-vars)を参照してください。`CLAUDE_AGENT_SDK_CLIENT_APP` を設定して User-Agent ヘッダーでアプリを識別します |

558| `executable` | `'bun' \| 'deno' \| 'node'` | 自動検出 | 使用する JavaScript ランタイム |558| `executable` | `'bun' \| 'deno' \| 'node'` | 自動検出 | 使用する JavaScript ランタイム |

559| `executableArgs` | `string[]` | `[]` | 実行可能ファイルに渡す引数 |559| `executableArgs` | `string[]` | `[]` | 実行可能ファイルに渡す引数 |

560| `extraArgs` | `Record<string, string \| null>` | `{}` | 追加引数 |560| `extraArgs` | `Record<string, string \| null>` | `{}` | 追加引数 |

561| `fallbackModel` | `string` | `undefined` | プライマリモデルが失敗した場合に使用するモデル。カンマ区切りリストを受け入れます。順序とキャップについては [フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains) を参照してください。ガイダンスについては [モデルを選択](/docs/ja/agent-sdk/configuration#choose-a-model) を参照してください |561| `fallbackModel` | `string` | `undefined` | プライマリモデルが失敗した場合に使用するモデル。カンマ区切りリストを受け入れます。順序と上限については [フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)を参照してください。ガイダンスについては [モデルを選択](/docs/ja/agent-sdk/configuration#choose-a-model)を参照してください |

562| `forkSession` | `boolean` | `false` | `resume` で再開する場合、元のセッション ID を続行するのではなく新しいセッション ID にフォークします |562| `forkSession` | `boolean` | `false` | `resume` で再開する場合、元のセッション ID を続行する代わりに新しいセッション ID にフォークします |

563| `forwardSubagentText` | `boolean` | `false` | サブエージェントのテキストと思考ブロックをアシスタントおよびユーザーメッセージとして `parent_tool_use_id` を設定して転送し、コンシューマーがネストされたトランスクリプトをレンダリングできるようにします。このオプションがない場合、Claude Code はサブエージェント `tool_use` および `tool_result` ブロックを出力しますが、テキストや思考は出力しません。すべてのネストの深さのサブエージェントからのメッセージは Claude Code v2.1.219 以降で転送されます。v2.1.219 より前では、深さ 1 のサブエージェントからのメッセージのみが表示されました。フォークされたスキルが生成するサブエージェントのメッセージおよびネストされたフォークされたスキルのメッセージには v2.1.275 以降が必要です |563| `forwardSubagentText` | `boolean` | `false` | サブエージェントのテキストと思考ブロックをアシスタントおよびユーザーメッセージとして `parent_tool_use_id` を設定して転送し、コンシューマーがネストされたトランスクリプトをレンダリングできるようにします。このオプションがない場合、Claude Code はサブエージェント `tool_use` および `tool_result` ブロックを出力しますが、テキストまたは思考は出力しません。すべてのネストの深さのサブエージェントからのメッセージは Claude Code v2.1.219 以降で転送されます。v2.1.219 より前では、深さ 1 のサブエージェントからのメッセージのみが表示されました。フォークされたスキルが生成するサブエージェントのメッセージ、およびネストされたフォークされたスキルのメッセージには v2.1.275 以降が必要です |

564| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | イベントのフックコールバック |564| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | イベントのフックコールバック |

565| `includeHookEvents` | `boolean` | `false` | フックライフサイクルイベントをメッセージストリームに [`SDKHookStartedMessage`](#sdkhookstartedmessage)、[`SDKHookProgressMessage`](#sdkhookprogressmessage)、および [`SDKHookResponseMessage`](#sdkhookresponsemessage) として含めます。`SessionStart` および `Setup` フックのライフサイクルイベントは常に含まれ、このオプションは不要です。`Notification`、`SessionEnd`、`PreCompact`、`PostCompact` などの一部のフックイベントは、このオプションを使用しても `SDKHookStartedMessage` を生成しません。これらのイベントの場合、Claude Code は 1 秒以上実行されるコマンドフックが出力を生成している間は `SDKHookProgressMessage` を出力し、[バックグラウンドで実行](/docs/ja/hooks#run-hooks-in-the-background) されるフックが完了したときのみ `SDKHookResponseMessage` を出力します |565| `includeHookEvents` | `boolean` | `false` | フックライフサイクルイベントをメッセージストリームに [`SDKHookStartedMessage`](#sdkhookstartedmessage)、[`SDKHookProgressMessage`](#sdkhookprogressmessage)、および [`SDKHookResponseMessage`](#sdkhookresponsemessage) として含めます。`SessionStart` および `Setup` フックのライフサイクルイベントは常に含まれ、このオプションは不要です。`Notification`、`SessionEnd`、`PreCompact`、`PostCompact` などの一部のフックイベントは、このオプションを使用しても `SDKHookStartedMessage` を生成しません。これらのイベントについては、Claude Code は コマンドフックが 1 秒以上実行される場合に出力を生成する `SDKHookProgressMessage` を出力し、[バックグラウンドで実行](/docs/ja/hooks#run-hooks-in-the-background)するフックが完了した場合にのみ `SDKHookResponseMessage` を出力します |

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

567| `loadTimeoutMs` | `number` | `60000` | *アルファ。* 再開の具体化中に各 `sessionStore.load()` および `sessionStore.listSubkeys()` 呼び出しのタイムアウト（ミリ秒）。アダプターがこのウィンドウ内で解決しない場合、クエリはハングするのではなく失敗します。`sessionStore` が設定されていない場合は無視されます |567| `loadTimeoutMs` | `number` | `60000` | *アルファ。* 再開の具体化中に各 `sessionStore.load()` および `sessionStore.listSubkeys()` 呼び出しのタイムアウト（ミリ秒）。アダプターがこのウィンドウ内で解決しない場合、クエリはハングする代わりに失敗します。`sessionStore` が設定されていない場合は無視されます |

568| `managedSettings` | `Settings` | `undefined` | ホストプロセスがスポーンされたセッションに提供するポリシー層設定。管理者がデプロイした管理設定を持つマシンでは、管理者の最優先管理ソースが `parentSettingsBehavior: 'merge'` を設定しない限り、Claude Code はこれらを無視し、[`policyHelper`](/docs/ja/settings-reference#policyhelper) が管理設定を提供している間はマージしません。マージされた値は制限のみのフィルターを通過します。[親設定を制限](/docs/ja/claude-apps-gateway#restrict-parent-settings) はフィルターが許可するもの、および `allowManaged*Only` ロックをカバーします。[`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ja/env-vars) を設定するホストは、このペイロードから直接 3 つのキーを読み取ります。Claude Code v2.1.222 以降の [モデル設定](/docs/ja/model-config#restrict-model-selection)、管理ソースが設定していない場合は v2.1.246 以降の [`modelPricing`](/docs/ja/settings-reference#modelpricing)、および v2.1.247 以降の `ENABLE_TOOL_SEARCH` env エントリ |568| `managedSettings` | `Settings` | `undefined` | ホストプロセスがスポーンされたセッションに提供するポリシー層設定。管理者がデプロイした管理設定を持つマシンでは、管理者の最優先管理ソースが `parentSettingsBehavior: 'merge'` を設定しない限り、Claude Code はこれらを無視し、[`policyHelper`](/docs/ja/settings-reference#policyhelper) が管理設定を提供している間はマージしません。マージされた値は制限のみのフィルターを通過します。[親設定を制限](/docs/ja/claude-apps-gateway#restrict-parent-settings)はフィルターが許可するものと `allowManaged*Only` ロックをカバーしています。[`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ja/env-vars) を設定するホストには、このペイロードから直接読み取られる 3 つのキーがあります。Claude Code v2.1.222 以降の [モデル設定](/docs/ja/model-config#restrict-model-selection)、管理ソースが設定していない場合の v2.1.246 以降の [`modelPricing`](/docs/ja/settings-reference#modelpricing)、および v2.1.247 以降の `ENABLE_TOOL_SEARCH` env エントリ |

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

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

571| `maxTurns` | `number` | `undefined` | 最大エージェンティックターン数（ツール使用ラウンドトリップ） |571| `maxTurns` | `number` | `undefined` | 最大エージェンティックターン数（ツール使用ラウンドトリップ） |

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

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

574| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | MCP 誘導リクエストを処理するためのコールバック。MCP サーバーがユーザー入力をリクエストし、フックが最初に処理しない場合に呼び出されます。提供されない場合、未処理の誘導リクエストは自動的に拒否されます |574| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | MCP 誘導リクエストを処理するためのコールバック。MCP サーバーがユーザー入力をリクエストし、フックが最初に処理しない場合に呼び出されます。提供されない場合、処理されない誘導リクエストは自動的に拒否されます |

575| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | エージェント結果の出力形式を定義します。詳細は [構造化出力](/docs/ja/agent-sdk/structured-outputs) を参照してください |575| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | エージェント結果の出力形式を定義します。詳細は [構造化出力](/docs/ja/agent-sdk/structured-outputs)を参照してください |

576| `outputStyle` | `string` | `undefined` | `Options` フィールドではありません。インライン [`settings`](/docs/ja/settings) オブジェクトまたは設定ファイルで `outputStyle` を設定してください。[出力スタイルを有効化](/docs/ja/agent-sdk/modifying-system-prompts#activate-an-output-style) を参照してください |576| `outputStyle` | `string` | `undefined` | `Options` フィールドではありません。インライン [`settings`](/docs/ja/settings) オブジェクトまたは設定ファイルで `outputStyle` を設定してください。[出力スタイルを有効化](/docs/ja/agent-sdk/modifying-system-prompts#activate-an-output-style)を参照してください |

577| `pathToClaudeCodeExecutable` | `string` | バンドルされたネイティブバイナリから自動解決 | Claude Code 実行可能ファイルへのパス。オプション依存関係がインストール中にスキップされた場合、またはプラットフォームがサポートされているセットにない場合にのみ必要です |577| `pathToClaudeCodeExecutable` | `string` | バンドルされたネイティブバイナリから自動解決 | Claude Code 実行可能ファイルへのパス。オプションの依存関係がインストール中にスキップされた場合、またはプラットフォームがサポートされているセットにない場合にのみ必要です |

578| `permissionMode` | [`PermissionMode`](#permissionmode) | `'default'` | セッションの権限モード |578| `permissionMode` | [`PermissionMode`](#permissionmode) | `undefined` | セッションの権限モード。省略した場合、セッションはオートモードで開始できます。Claude Code がスタート権限モードを選択する方法については [権限モード](/docs/ja/agent-sdk/permissions#permission-modes)を参照してください |

579| `permissionPromptToolName` | `string` | `undefined` | 権限プロンプト用の MCP ツール名 |579| `permissionPromptToolName` | `string` | `undefined` | 権限プロンプトの MCP ツール名 |

580| `permissionPrompts` | `'host' \| 'none'` | `'host'` | 権限プロンプトに応答するのは誰か: `'host'` はそれらを [`canUseTool`](#canusetool) コールバックまたは `permissionPromptToolName` ツールにルーティングし、`'none'` は [プロンプトが表示されるはずだった呼び出しを拒否](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated) します。Claude Code v2.1.259 以降が必要です |580| `permissionPrompts` | `'host' \| 'none'` | `'host'` | 権限プロンプトに応答する者: `'host'` はそれらを [`canUseTool`](#canusetool) コールバックまたは `permissionPromptToolName` ツールにルーティングし、`'none'` は [プロンプトが表示されるはずだった呼び出しを拒否](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)します。Claude Code v2.1.259 以降が必要です |

581| `persistSession` | `boolean` | `true` | `false` の場合、セッションのディスクへの永続化を無効にします。セッションは後で再開できません |581| `persistSession` | `boolean` | `true` | `false` の場合、ディスクへのセッション永続化を無効にします。セッションは後で再開できません |

582| `planModeInstructions` | `string` | `undefined` | plan mode のカスタムワークフロー指示。`permissionMode` が `'plan'` の場合、この文字列はデフォルトの plan mode ワークフロー本体を置き換えます。CLI は引き続き読み取り専用強制プリアンブルと ExitPlanMode プロトコルフッターでラップします |582| `planModeInstructions` | `string` | `undefined` | プランモードのカスタムワークフロー指示。`permissionMode` が `'plan'` の場合、この文字列はデフォルトのプランモードワークフロー本体を置き換えます。CLI は引き続き読み取り専用強制プリアンブルと ExitPlanMode プロトコルフッターでラップします |

583| `plugins` | [`SdkPluginConfig`](#sdkpluginconfig)`[]` | `[]` | ローカルパスからカスタムプラグインを読み込みます。詳細は [プラグイン](/docs/ja/agent-sdk/plugins) を参照してください |583| `plugins` | [`SdkPluginConfig`](#sdkpluginconfig)`[]` | `[]` | ローカルパスからカスタムプラグインを読み込みます。詳細は [プラグイン](/docs/ja/agent-sdk/plugins)を参照してください |

584| `projectConfigRoot` | `string` | `undefined` | `cwd` がワークツリーである信頼できるチェックアウトの絶対パス。Claude Code はプロジェクト設定、`.mcp.json`、およびプロジェクトの `.claude/` コマンド、エージェント、スキル、ワークフロー、ルーチン、および出力スタイルを `cwd` ではなくこのディレクトリから読み込み、`CLAUDE_PROJECT_DIR` をそれに設定します。フック、`apiKeyHelper` などのヘルパースクリプト、および stdio MCP サーバーはこのディレクトリをワーキングディレクトリとして開始します。`CLAUDE.md` ファイルと `.claude/rules/` は引き続き `cwd` から読み込まれます。Claude Code v2.1.275 以降が必要です |584| `projectConfigRoot` | `string` | `undefined` | `cwd` がワークツリーである信頼できるチェックアウトの絶対パス。Claude Code はプロジェクト設定、`.mcp.json`、およびプロジェクトの `.claude/` コマンド、エージェント、スキル、ワークフロー、ルーチン、および出力スタイルをこのディレクトリから `cwd` の代わりに読み取り、`CLAUDE_PROJECT_DIR` をそれに設定します。フック、`apiKeyHelper` などのヘルパースクリプト、および stdio MCP サーバーはこのディレクトリをワーキングディレクトリとして開始します。`CLAUDE.md` ファイルと `.claude/rules/` は引き続き `cwd` から読み込まれます。Claude Code v2.1.275 以降が必要です |

585| `promptSuggestions` | `boolean` | `false` | プロンプト提案を有効にします。ターン後、Claude Code は予測される次のユーザープロンプトを含む `prompt_suggestion` メッセージを出力します。アカウントが使用制限に近い、または達している場合など、一部のターンでは Claude Code は提案を生成しません。[Claude Code が提案をスキップする場合](/docs/ja/interactive-mode#when-claude-code-skips-suggestions) を参照してください |585| `promptSuggestions` | `boolean` | `false` | プロンプト提案を有効にします。ターン後、Claude Code は予測される次のユーザープロンプトを含む `prompt_suggestion` メッセージを出力します。アカウントが使用制限に近い、または達している場合など、一部のターンでは Claude Code は提案を生成しません。[Claude Code が提案をスキップする場合](/docs/ja/interactive-mode#when-claude-code-skips-suggestions)を参照してください |

586| `resume` | `string` | `undefined` | 再開するセッション ID |586| `resume` | `string` | `undefined` | 再開するセッション ID |

587| `resumeDropsTurn` | `string` | `undefined` | `resumeSessionAt` を使用: 切り詰め再開が破棄するターンのプロンプト UUID。破棄された範囲に吸収されたキューに入ったメッセージなど、そのターンに帰属しないものが含まれている場合、Claude Code は再開を拒否し、拒否メッセージで `--resume-drops-turn` フラグを指定します。Agent SDK とプリントモード再開のみがペアを読み取ります。Claude Code v2.1.223 以降が必要です |587| `resumeDropsTurn` | `string` | `undefined` | `resumeSessionAt` を使用: 切り詰め再開が破棄することを意図するターンのプロンプト UUID。破棄された範囲に、吸収されたキューに入ったメッセージやタスク通知など、そのターンに帰属しないものが含まれている場合、Claude Code は再開を拒否し、拒否メッセージで `--resume-drops-turn` フラグを名前付けします。Agent SDK とプリントモード再開のみがペアを読み取ります。Claude Code v2.1.223 以降が必要です |

588| `resumeSessionAt` | `string` | `undefined` | 特定のメッセージ UUID でセッションを再開します |588| `resumeSessionAt` | `string` | `undefined` | 特定のメッセージ UUID でセッションを再開します |

589| `sandbox` | [`SandboxSettings`](#sandboxsettings) | `undefined` | サンドボックス動作をプログラムで設定します。詳細は [サンドボックス設定](#sandboxsettings) を参照してください |589| `sandbox` | [`SandboxSettings`](#sandboxsettings) | `undefined` | サンドボックス動作をプログラムで設定します。詳細は [サンドボックス設定](#sandboxsettings)を参照してください |

590| `sessionId` | `string` | 自動生成 | 自動生成する代わりに特定の UUID をセッションに使用します |590| `sessionId` | `string` | 自動生成 | 自動生成する代わりに特定の UUID をセッションに使用します |

591| `sessionStore` | [`SessionStore`](/docs/ja/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | セッショントランスクリプトを外部バックエンドにミラーリングして、別のホストがそれらを再開できるようにします。[セッションを外部ストレージに永続化](/docs/ja/agent-sdk/session-storage) を参照してください |591| `sessionStore` | [`SessionStore`](/docs/ja/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | セッショントランスクリプトを外部バックエンドにミラーリングして、別のホストがそれらを再開できるようにします。[セッションを外部ストレージに永続化](/docs/ja/agent-sdk/session-storage)を参照してください |

592| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *アルファ。* `sessionStore` のフラッシュモード。`sessionStore` が設定されていない場合は無視されます |592| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *アルファ。* `sessionStore` のフラッシュモード。`sessionStore` が設定されていない場合は無視されます |

593| `settings` | `string \| Settings` | `undefined` | インライン [settings](/docs/ja/settings) オブジェクト、設定ファイルパス、またはインライン JSON 文字列。[優先順位](/docs/ja/settings#settings-precedence) でフラグ設定層を入力します。[`applyFlagSettings()`](#applyflagsettings) で実行時に変更します |593| `settings` | `string \| Settings` | `undefined` | インライン [settings](/docs/ja/settings) オブジェクト、設定ファイルパス、またはインライン JSON 文字列。[優先順位](/docs/ja/settings#settings-precedence)でフラグ設定層を入力します。[`applyFlagSettings()`](#applyflagsettings) でランタイムに変更します |

594| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI デフォルト（すべてのソース） | 読み込むファイルシステム設定を制御します。ユーザー、プロジェクト、ローカル設定を無効にするには `[]` を渡します。[エンドポイント管理ポリシー](/docs/ja/managed-settings#delivery-mechanisms) は関係なく読み込まれます。サーバー管理設定は、セッションが [適格な設定](/docs/ja/server-managed-settings#platform-availability) で組織認証情報を使用して認証するときにフェッチされます。[Claude Code 機能を使用](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control) を参照してください |594| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI デフォルト（すべてのソース） | どのファイルシステム設定を読み込むかを制御します。ユーザー、プロジェクト、ローカル設定を無効にするには `[]` を渡します。[エンドポイント管理ポリシー](/docs/ja/managed-settings#delivery-mechanisms)は関係なく読み込まれます。サーバー管理設定は、セッションが [適格な設定](/docs/ja/server-managed-settings#platform-availability)で組織認証情報を使用して認証する場合に取得されます。[Claude Code 機能を使用](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control)を参照してください |

595| `skills` | `string[] \| 'all'` | `undefined` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `'all'` を渡すか、スキル名のリストを渡します。正確な名前のみを渡してください。Agent SDK v0.3.221 以降では、SDK は Claude Code プロセスを開始する前に、形式が正しくないワイルドカードフォーム名をエラーで拒否します。設定すると、SDK は Skill ツールを `allowedTools` に自動的に追加します。`tools` も渡す場合は、そのリストに `'Skill'` を含めてください。[スキル](/docs/ja/agent-sdk/skills) を参照してください |595| `skills` | `string[] \| 'all'` | `undefined` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `'all'` を渡すか、スキル名のリストを渡します。正確な名前のみを渡してください。Agent SDK v0.3.221 以降では、SDK は形式が正しくないワイルドカード形式の名前を Claude Code プロセスを開始する前にエラーで拒否します。設定すると、SDK は Skill ツールを `allowedTools` に自動的に追加します。`tools` も渡す場合は、そのリストに `'Skill'` を含めてください。[スキル](/docs/ja/agent-sdk/skills)を参照してください |

596| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Claude Code プロセスをスポーンするカスタム関数。VM、コンテナ、またはリモート環境で Claude Code を実行するために使用します |596| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Claude Code プロセスをスポーンするカスタム関数。VM、コンテナ、またはリモート環境で Claude Code を実行するために使用します |

597| `stderr` | `(data: string) => void` | `undefined` | stderr 出力のコールバック |597| `stderr` | `(data: string) => void` | `undefined` | stderr 出力のコールバック |

598| `strictMcpConfig` | `boolean` | `false` | `mcpServers` で渡されたサーバーのみを使用し、プロジェクト `.mcp.json`、ユーザー設定、プラグイン提供の MCP サーバー、および [claude.ai コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai) を無視します |598| `strictMcpConfig` | `boolean` | `false` | `mcpServers` で渡されたサーバーのみを使用し、プロジェクト `.mcp.json`、ユーザー設定、プラグイン提供の MCP サーバー、および [claude.ai コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai)を無視します |

599| `systemPrompt` | `string \| string[] \| { type: 'custom'; prompt: string \| string[]; snapshot?: boolean } \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean; snapshot?: boolean }` | `undefined`（最小プロンプト） | システムプロンプト設定。カスタムプロンプトの場合は文字列を渡すか、Claude Code のシステムプロンプトを使用するには `{ type: 'preset', preset: 'claude_code' }` を渡します。エクスポートされた `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` 定数を静的部分とリクエストごとの部分の間に含む文字列の配列を渡して、[カスタムプロンプトの静的部分をキャッシュ](/docs/ja/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt) します。プリセットオブジェクト形式を使用する場合、追加の指示で拡張するには `append` を追加し、セッションごとのコンテキストを最初のユーザーメッセージに移動するには `excludeDynamicSections: true` を設定して、[マシン間でのプロンプトキャッシュの再利用を改善](/docs/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) します。セッションが最初のリクエストで記録したプロンプトを再利用する代わりに、すべてのリクエストでプロンプトを再構築するには `snapshot: false` を設定します。カスタムプロンプトで `snapshot` を設定するには、`{ type: 'custom', prompt }` 形式を渡します。`{ type: 'custom' }` 形式と `snapshot` フィールドには TypeScript Agent SDK v0.3.257 以降が必要です |599| `systemPrompt` | `string \| string[] \| { type: 'custom'; prompt: string \| string[]; snapshot?: boolean } \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean; snapshot?: boolean }` | `undefined`（最小プロンプト） | システムプロンプト設定。カスタムプロンプトの場合は文字列を渡すか、Claude Code のシステムプロンプトを使用するには `{ type: 'preset', preset: 'claude_code' }` を渡します。エクスポートされた `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` 定数を静的部分とリクエストごとの部分の間に含む文字列の配列を渡して、[カスタムプロンプトの静的部分をキャッシュ](/docs/ja/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt)します。プリセットオブジェクト形式を使用する場合、追加の指示で拡張するには `append` を追加し、セッションごとのコンテキストを最初のユーザーメッセージに移動するには `excludeDynamicSections: true` を設定して、[マシン間でのプロンプトキャッシュの再利用を改善](/docs/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines)します。セッションが最初のリクエストで記録したプロンプトを再利用する代わりに、すべてのリクエストでプロンプトを再構築するには `snapshot: false` を設定します。カスタムプロンプトで `snapshot` を設定するには、`{ type: 'custom', prompt }` 形式を渡します。`{ type: 'custom' }` 形式と `snapshot` フィールドには TypeScript Agent SDK v0.3.257 以降が必要です |

600| `taskBudget` | `{ total: number }` | `undefined` | *アルファ。* API 側のタスク予算（トークン）。設定すると、モデルは残りのトークン予算を通知され、ツール使用のペースを調整し、制限前にラップアップできます |600| `taskBudget` | `{ total: number }` | `undefined` | *アルファ。* API 側のタスク予算（トークン）。設定すると、モデルは残りのトークン予算を知らされるため、ツール使用のペースを調整し、制限前にラップアップできます |

601| `thinking` | [`ThinkingConfig`](#thinkingconfig) | サポートされているモデルの場合は `{ type: 'adaptive' }` | Claude の思考/推論動作を制御します。オプションについては [`ThinkingConfig`](#thinkingconfig) を参照してください |601| `thinking` | [`ThinkingConfig`](#thinkingconfig) | サポートされているモデルの場合 `{ type: 'adaptive' }` | Claude の思考/推論動作を制御します。オプションについては [`ThinkingConfig`](#thinkingconfig)を参照してください |

602| `title` | `string` | `undefined` | セッションの表示タイトル。`resume` または `continue` で再開する場合、再開されたセッションの永続化されたタイトルが優先されます。既存のセッションを再タイトルするには [`renameSession()`](#renamesession) を使用してください |602| `title` | `string` | `undefined` | セッションの表示タイトル。`resume` または `continue` で再開する場合、再開されたセッションの永続化されたタイトルが優先されます。既存のセッションを再タイトルするには [`renameSession()`](#renamesession) を使用してください |

603| `toolAliases` | `Record<string, string>` | `undefined` | 組み込みツール名を MCP ツール名にマップして、Claude が組み込みの代わりに MCP 実装を呼び出すようにします。例えば、`{ Bash: 'mcp__workspace__bash' }` |603| `toolAliases` | `Record<string, string>` | `undefined` | 組み込みツール名を MCP ツール名にマップして、Claude が組み込みの代わりに MCP 実装を呼び出すようにします。例えば、`{ Bash: 'mcp__workspace__bash' }` |

604| `toolConfig` | [`ToolConfig`](#toolconfig) | `undefined` | 組み込みツール動作の設定。詳細は [`ToolConfig`](#toolconfig) を参照してください |604| `toolConfig` | [`ToolConfig`](#toolconfig) | `undefined` | 組み込みツール動作の設定。詳細は [`ToolConfig`](#toolconfig)を参照してください |

605| `tools` | `string[] \| { type: 'preset'; preset: 'claude_code' }` | `undefined` | ツール設定。ツール名の配列を渡すか、プリセットを使用して Claude Code のデフォルトツールを取得します |605| `tools` | `string[] \| { type: 'preset'; preset: 'claude_code' }` | `undefined` | ツール設定。ツール名の配列を渡すか、プリセットを使用して Claude Code のデフォルトツールを取得します |

606| `verbatimPrompts` | `boolean` | `false` | すべてのプロンプトを書かれたとおりに配信します。SDK は各ユーザーメッセージを `client_composed: true` で送信します。Claude Code がこれらのメッセージでスキップするものについては [`client_composed`](#sdkusermessage) を参照してください。プロンプトテキストにエンドユーザーが入力しなかったコンテンツが含まれている場合にこのオプションを使用してください。ターンごとの制御については、オフのままにして、代わりにストリーミングされたメッセージで個別に `client_composed` を設定してください。TypeScript Agent SDK v0.3.280 以降および Claude Code v2.1.248 以降が必要です。これらの SDK バージョンでバンドルされている Claude Code バージョンは Claude Code 要件を満たします |606| `verbatimPrompts` | `boolean` | `false` | すべてのプロンプトを書かれたとおりに配信します。SDK は各ユーザーメッセージを `client_composed: true` で送信します。Claude Code がこれらのメッセージでスキップするものについては [`client_composed`](#sdkusermessage)を参照してください。プロンプトテキストにエンドユーザーが入力しなかったコンテンツが含まれている場合にこのオプションを使用します。ターンごとの制御については、これをオフのままにして、代わりにストリーミングされたメッセージで個別に `client_composed` を設定してください。TypeScript Agent SDK v0.3.280 以降と Claude Code v2.1.248 以降が必要です。これらの SDK バージョンにバンドルされている Claude Code バージョンは Claude Code 要件を満たしています |

607 607 

608<h4 id="handle-slow-or-stalled-api-responses">608<h4 id="handle-slow-or-stalled-api-responses">

609 遅いまたは停止した API レスポンスを処理609 遅いまたは停止した API レスポンスを処理

610</h4>610</h4>

611 611 

612CLI サブプロセスは、API タイムアウトとスタール検出を制御するいくつかの環境変数を読み取ります。`env` オプションを通じてそれらを渡します:612CLI サブプロセスは、API タイムアウトと停止検出を制御するいくつかの環境変数を読み取ります。`env` オプションを通じてそれらを渡します:

613 613 

614```typescript theme={null}614```typescript theme={null}

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

628```628```

629 629 

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

631* `CLAUDE_CODE_MAX_RETRIES`: 最大 API リトライ数。デフォルト `10`、上限 `15`。各リトライは独自の `API_TIMEOUT_MS` ウィンドウを取得するため、最悪の場合の実時間は大約 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` プラスバックオフです。より長い停止を待つ必要がある無人実行の場合は、[`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/ja/errors#tune-retry-behavior) を設定してください: 一時的な容量エラーを無限に再試行し、Claude Code v2.1.199 以降では、他の一時的なエラーのデフォルトを `300` に引き上げ、この変数のキャップを削除します。631* `CLAUDE_CODE_MAX_RETRIES`: 最大 API リトライ数。デフォルト `10`、上限 `15`。各リトライは独自の `API_TIMEOUT_MS` ウィンドウを取得するため、最悪の場合の壁時間は大約 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` プラスバックオフです。無人実行で長いアウタージを待つ必要がある場合は、[`CLAUDE_CODE_RETRY_WATCHDOG=1`](/docs/ja/errors#tune-retry-behavior) を設定します。一時的な容量エラーを無限に再試行し、Claude Code v2.1.199 以降では、他の一時的なエラーのデフォルトを `300` に引き上げ、この変数の上限を削除します。

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

633 633 

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

635* `CLAUDE_ENABLE_STREAM_WATCHDOG` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: ヘッダーが到着したがレスポンスボディがストリーミングを停止したときにリクエストを中止するストリーム監視犬。監視犬はすべてのプロバイダーでデフォルトでオンです。無効にするには `CLAUDE_ENABLE_STREAM_WATCHDOG=0` を設定してください。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` はデフォルト `300000` で、その最小値にクランプされます。中止後、[自動リトライ](/docs/ja/errors#automatic-retries) は、レスポンスがどこまで進んだかに基づいて Claude Code が何をするかをカバーします。635* `CLAUDE_ENABLE_STREAM_WATCHDOG` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: ヘッダーが到着したがレスポンスボディがストリーミングを停止したときにリクエストを中止するストリームウォッチドッグ。ウォッチドッグはすべてのプロバイダーでデフォルトでオンです。無効にするには `CLAUDE_ENABLE_STREAM_WATCHDOG=0` を設定します。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` はデフォルト `300000` で、その最小値にクランプされます。中止後、[自動リトライ](/docs/ja/errors#automatic-retries)は Claude Code が何をするかをカバーしており、レスポンスがどこまで進んだかに基づいています。

636 636 

637 監視犬が `ANTHROPIC_BASE_URL` の背後にあるゲートウェイが保持するレスポンスをキープアライブピングで待機している間、`includePartialMessages` を設定するホストは `ping` [ストリームイベント](#sdkpartialassistantmessage) を受け取り続けるため、これらのフレームを実時間として読み取り、最後の実ストリームイベントから 5 分後のサイレンスでセッションをタイムアウトしないでください。v2.1.257 より前では、フレームは停止しました。637 ウォッチドッグが `ANTHROPIC_BASE_URL` の背後にあるゲートウェイが保持するレスポンスを待っている間、キープアライブピングで、`includePartialMessages` を設定するホストは引き続き `ping` [ストリームイベント](#sdkpartialassistantmessage)を受け取るため、これらのフレームを沈黙でセッションをタイムアウトするのではなく活性度として読み取ってください。v2.1.257 より前では、フレームは最後の実際のストリームイベントから 5 分後に停止しました。

638 638 

639<h3 id="query-object">639<h3 id="query-object">

640 `Query` オブジェクト640 `Query` オブジェクト

696 696 

697| メソッド | 説明 |697| メソッド | 説明 |

698| :- | :- |698| :- | :- |

699| `interrupt()` | クエリを中断します。ストリーミング入力モードでのみ利用可能です。CLI が [`SDKSystemMessage.capabilities`](#sdksystemmessage) で `interrupt_receipt_v1` 機能をアドバタイズする場合、中断が到着したときに保留中だった [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) メッセージをリストして解決します。v2.1.205 より前の CLI では `undefined` に解決します |699| `interrupt()` | クエリを中断します。ストリーミング入力モードでのみ利用可能です。CLI が [`SDKSystemMessage.capabilities`](#sdksystemmessage) で `interrupt_receipt_v1` 機能をアドバタイズする場合、中断が到着したときに保留中だったメッセージをリストする [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) で解決します。v2.1.205 より前の CLI では `undefined` で解決します |

700| `rewindFiles(userMessageId, options?)` | ファイルを指定されたユーザーメッセージの状態に復元します。変更をプレビューするには `{ dryRun: true }` を渡します。`enableFileCheckpointing: true` が必要です。[ファイルチェックポイント](/docs/ja/agent-sdk/file-checkpointing) を参照してください |700| `rewindFiles(userMessageId, options?)` | ファイルを指定されたユーザーメッセージの状態に復元します。`{ dryRun: true }` を渡して変更をプレビューします。`enableFileCheckpointing: true` が必要です。[ファイルチェックポイント](/docs/ja/agent-sdk/file-checkpointing)を参照してください |

701| `setPermissionMode()` | 権限モードを変更します（ストリーミング入力モードでのみ利用可能） |701| `setPermissionMode()` | 権限モードを変更します（ストリーミング入力モードでのみ利用可能） |

702| `setModel()` | モデルを変更します（ストリーミング入力モードでのみ利用可能）。`undefined` または文字列 `"default"` を渡すと、[Claude Code のデフォルトモデル](/docs/ja/model-config) にリセットされます |702| `setModel()` | モデルを変更します（ストリーミング入力モードでのみ利用可能）。`undefined` または文字列 `"default"` を渡すと、[Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットされます |

703| `setMaxThinkingTokens()` | *非推奨:* 代わりに `thinking` オプションを使用してください。最大思考トークン数を変更します。`null` を渡すと、思考をセッションデフォルトにリセットします: ミッドセッションオーバーライドはクリアされ、思考が無効になっているセッションでは思考はオフのままです |703| `setMaxThinkingTokens()` | *非推奨:* 代わりに `thinking` オプションを使用してください。最大思考トークンを変更します。`null` を渡すと、思考をセッションデフォルトにリセットします。セッション中のオーバーライドはクリアされ、思考が無効になっているセッションでは思考はオフのままです |

704| `applyFlagSettings(settings)` | 実行時にセッションのフラグ設定層に設定をマージします（ストリーミング入力モードでのみ利用可能）。[`applyFlagSettings()`](#applyflagsettings) を参照してください |704| `applyFlagSettings(settings)` | ランタイムでセッションのフラグ設定層に設定をマージします（ストリーミング入力モードでのみ利用可能）。[`applyFlagSettings()`](#applyflagsettings)を参照してください |

705| `updateSettings(source, settings)` | プロジェクトのローカル設定ファイルまたはユーザー設定ファイルに 1 つのホワイトリスト登録キーを書き込み、値が後のセッションで永続化されるようにします。[`updateSettings()`](#updatesettings) を参照してください。TypeScript SDK v0.3.257 以降が必要で、Claude Code v2.1.257 をバンドルしています |705| `updateSettings(source, settings)` | プロジェクトのローカル設定ファイルまたはユーザー設定ファイルに 1 つのホワイトリストキーを書き込み、値が後のセッションで永続化されるようにします。[`updateSettings()`](#updatesettings)を参照してください。TypeScript SDK v0.3.257 以降が必要で、Claude Code v2.1.257 をバンドルしています |

706| `initializationResult()` | サポートされているコマンド、モデル、アカウント情報、出力スタイル設定を含む完全な初期化結果を返します |706| `initializationResult()` | サポートされているコマンド、モデル、アカウント情報、および出力スタイル設定を含む完全な初期化結果を返します |

707| `reinitialize()` | 実行中の CLI に `initialize` 制御リクエストを再送信し、キャッシュされた最初の接続結果の代わりに新しい結果を返します。トランスポートギャップ後（セッションへの再接続後など）に使用して、保留中の権限リクエストが `canUseTool` コールバックに再度到達するようにします。リクエスト ID ごとにコールバックをべき等にしてください。応答が失敗したリクエストは再度ディスパッチされるためです。Claude Code v2.1.195 以降が必要です |707| `reinitialize()` | 実行中の CLI に `initialize` 制御リクエストを再送信し、キャッシュされた最初の接続結果の代わりに新しい結果を返します。トランスポートギャップ後（セッションを切断後に再接続するなど）に使用して、保留中の権限リクエストが `canUseTool` コールバックに再度到達するようにします。リクエスト ID ごとにコールバックをべき等にしてください。応答が失われたリクエストは再度ディスパッチされるためです。Claude Code v2.1.195 以降が必要です |

708| `supportedCommands()` | 利用可能なコマンドを返します。Agent SDK v0.3.216 からリストはミッドセッションコマンド変更を反映します。[`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) を参照してください |708| `supportedCommands()` | 利用可能なコマンドを返します。Agent SDK v0.3.216 からリストはセッション中のコマンド変更を反映します。[`SDKCommandsChangedMessage`](#sdkcommandschangedmessage)を参照してください |

709| `supportedModels()` | 表示情報を含む利用可能なモデルを返します |709| `supportedModels()` | 表示情報を含む利用可能なモデルを返します |

710| `supportedAgents()` | [`AgentInfo`](#agentinfo)`[]` として利用可能なサブエージェントを返します |710| `supportedAgents()` | 利用可能なサブエージェントを [`AgentInfo`](#agentinfo)`[]` として返します |

711| `mcpServerStatus()` | 接続された MCP サーバーのステータスを [`McpServerStatus`](#mcpserverstatus)`[]` として返します |711| `mcpServerStatus()` | 接続された MCP サーバーのステータスを [`McpServerStatus`](#mcpserverstatus)`[]` として返します |

712| `getContextUsage(opts?)` | セッションのコンテキストウィンドウ使用状況をカテゴリ、スキル、ツール別に分類した [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) を返します。デフォルト `detail` では、対話型セッションで `/context` が表示するのと同じデータです。[`detail` オプション](#sdkcontrolgetcontextusageresponse) には Agent SDK v0.3.257 以降が必要です |712| `getContextUsage(opts?)` | セッションのコンテキストウィンドウ使用状況をカテゴリ、スキル、ツール別に分類する [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse)を返します。デフォルト `detail` では、対話型セッションで `/context` が表示するのと同じデータで、メッセージストリームに表示されないトークンカウント API リクエストで計算されます。[これらのリクエストがどのように処理されるか](#sdkcontrolgetcontextusageresponse)を参照してください。[`detail` オプション](#sdkcontrolgetcontextusageresponse)には Agent SDK v0.3.257 以降が必要です |

713| `readFile(path, options?)` | セッションのファイルシステムからファイルを読み取ります。Claude Code は `cwd` に対してパスを解決します。[`readFile()` が読み取れるもの](#what-readfile-can-read) は提供するファイルをリストします。読み取りキャップを変更するには `{ maxBytes }` を渡します（デフォルト 1 MB、上限 10 MB）。画像などのバイナリファイルの場合は `{ encoding: 'base64' }` を渡します。[`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse) で解決するか、権限拒否、ファイルの欠落、またはトランスポートエラーの場合は `null` で解決します。TypeScript SDK v0.2.121 以降が必要です |713| `readFile(path, options?)` | セッションのファイルシステムからファイルを読み取ります。Claude Code はパスを `cwd` に対して解決します。[`readFile()` が読み取れるもの](#what-readfile-can-read)は提供するファイルをリストします。`{ maxBytes }` を渡して読み取りキャップを変更し（デフォルト 1 MB、上限 10 MB）、`{ encoding: 'base64' }` を画像などのバイナリファイルに渡します。[`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse)で解決するか、権限拒否、ファイルの欠落、またはトランスポートエラーで `null` で解決します。TypeScript SDK v0.2.121 以降が必要です |

714| `reloadPlugins(options?)` | ディスクからプラグインを再読み込みして、ミッドセッション中にインストールまたは編集したプラグインが実行中のセッションに到達するようにします。セッションのコマンド、サブエージェント、プラグイン、MCP サーバーステータスをリストする [`SDKControlReloadPluginsResponse`](#sdkcontrolreloadpluginsresponse) で解決します。Agent SDK v0.2.85 以降が必要です。[`holdOnCacheImpact` オプション](#sdkcontrolreloadpluginsresponse) には Agent SDK v0.3.268 以降が必要です |714| `reloadPlugins(options?)` | ディスクからプラグインを再読み込みして、セッション中にインストールまたは編集したプラグインが実行中のセッションに到達するようにします。セッションのコマンド、サブエージェント、プラグイン、および MCP サーバーステータスをリストする [`SDKControlReloadPluginsResponse`](#sdkcontrolreloadpluginsresponse)で解決します。Agent SDK v0.2.85 以降が必要です。[`holdOnCacheImpact` オプション](#sdkcontrolreloadpluginsresponse)には Agent SDK v0.3.268 以降が必要です |

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

716| `reloadOutputStyles()` | ディスクから [出力スタイル](/docs/ja/output-styles) を再読み込みして、ミッドセッション中に追加または編集したスタイルファイルが実行中のセッションで利用可能になるようにします。再読み込み後に利用可能なスタイル名をリストする [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) で解決します。Agent SDK v0.3.261 以降が必要です |716| `reloadOutputStyles()` | ディスクから [出力スタイル](/docs/ja/output-styles)を再読み込みして、セッション中に追加または編集したスタイルファイルが実行中のセッションで利用可能になるようにします。再読み込み後に利用可能なスタイル名をリストする [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse)で解決します。Agent SDK v0.3.261 以降が必要です |

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

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

719| `toggleMcpServer(serverName, enabled)` | `reconnectMcpServer()` と同じ名前解決で MCP サーバーを名前で有効または無効にします。無効にするとサーバーが切断されます |719| `toggleMcpServer(serverName, enabled)` | `reconnectMcpServer()` と同じ名前解決で MCP サーバーを名前で有効または無効にします。stdio、SSE、または HTTP サーバーを無効にするとそれを切断し、ツールを削除します。セッション中に `setMcpServers()` で追加したサーバーの場合、ツール削除には Claude Code v2.1.285 以降が必要です |

720| `setMcpServers(servers)` | このセッションの MCP サーバーセットを動的に置き換えます。追加および削除されたサーバーと任意のエラーを指定する [`McpSetServersResult`](#mcpsetserversresult) で解決します |720| `setMcpServers(servers)` | このセッションの MCP サーバーセットを動的に置き換えます。追加および削除されたサーバーと任意のエラーを名前付けする [`McpSetServersResult`](#mcpsetserversresult)で解決します |

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

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

723| `stopTask(taskId)` | ID でバックグラウンドタスクを実行中に停止します |723| `stopTask(taskId)` | ID でバックグラウンドタスクを実行中に停止します |

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

725 725 

726<h4 id="applyflagsettings">726<h4 id="applyflagsettings">

727 `applyFlagSettings()`727 `applyFlagSettings()`

728</h4>728</h4>

729 729 

730クエリを再開することなく実行中のセッションで [settings](/docs/ja/settings) を変更します。信頼できない入力をエージェントが読み取った後に権限を厳しくするなど、専用セッターがない設定がミッドセッション中に変更される必要がある場合に使用します。`setModel()` と `setPermissionMode()` はこれら 2 つのキーの専用セッターです。`applyFlagSettings()` は任意のサブセット設定キーを受け入れる一般的な形式で、ここで `model` を渡すことは `setModel()` と同じように動作します。730実行中のセッションで [設定](/docs/ja/settings)を変更し、クエリを再開しません。セッション中に変更が必要な専用セッターがない設定（信頼できない入力を読み取った後に `permissions` を厳しくするなど）を使用する場合に使用します。`setModel()` と `setPermissionMode()` はこれら 2 つのキーの専用セッターです。`applyFlagSettings()` は `model` をここに渡すと `setModel()` と同じように動作する一般的な形式です。

731 731 

732一部のキーのみがミッドセッション中に有効になります:732一部のキーのみがセッション中に有効になります:

733 733 

734* **次のターンで適用**: `effortLevel`、`ultracode`、`permissions`、`hooks`、`skillOverrides`、`fastMode`、`agent`。`agent` を切り替えると、そのエージェントのモデルオーバーライドとフックも次のターンで適用されます。そのシステムプロンプトは次のターンで、または [記録されたシステムプロンプトを再利用](/docs/ja/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session) するセッションではセッションがコンパクト化されると適用されます。734* **次のターンで適用**: `effortLevel`、`ultracode`、`permissions`、`hooks`、`skillOverrides`、`fastMode`、`agent`。`agent` を切り替えると、そのエージェントのモデルオーバーライドとフックも次のターンで適用されます。そのシステムプロンプトは次のターンで、または [記録されたシステムプロンプトを再利用](/docs/ja/agent-sdk/modifying-system-prompts#change-the-prompt-of-an-existing-session)するセッションではセッションがコンパクト化されると適用されます。

735* **現在のターン中に適用**: `model`。Claude がターンで作業している間に `model` を切り替えると、Claude が既に生成しているレスポンスは古いモデルで完了し、ターンの残り（Claude Code がモデルに対して行う次の呼び出しから開始）は新しいモデルを使用します。サブエージェントは独自のモデルを保持します。v2.1.212 より前では、ミッドターンスイッチは次のターンを待機していました。735* **現在のターン中に適用**: `model`。Claude がターンで作業している間に `model` を切り替えると、Claude が既に生成しているレスポンスは古いモデルで完了し、ターンの残り（Claude Code がモデルに対して行う次の呼び出しから開始）は新しいモデルを使用します。サブエージェントは独自のモデルを保持します。v2.1.212 より前では、セッション中の切り替えは次のターンを待ちました。

736* **ミッドセッション中に効果なし**: システムプロンプトオプション。これらはスタートアップで 1 回解決されるため、実行中のセッションは呼び出しが成功しても元の値を保持します。それらを変更するには、新しいセッションを開始してください。736* **セッション中に効果なし**: システムプロンプトオプション。これらはスタートアップで 1 回解決されるため、実行中のセッションは呼び出しが成功しても元の値を保持します。それらを変更するには、新しいセッションを開始してください。

737 737 

738`effortLevel` は [努力レベル](/docs/ja/model-config#adjust-effort-level) 名を受け入れます。また、`"ultracode"` も受け入れます。これは [ultracode](/docs/ja/workflows#let-claude-decide-with-ultracode) を使用した `xhigh` 努力をリクエストします。`applyFlagSettings()` は `effortLevel` をその値なしで宣言するため、TypeScript で同等の `{ ultracode: true, effortLevel: "xhigh" }` を渡すか、[`ultracode`](/docs/ja/settings-reference#ultracode) キーのみを渡して、セッションの現在の努力レベルで ultracode をオンにしてください。`ultracode` 値には Claude Code v2.1.203 以降が必要で、設定ファイルの `effortLevel` キーではなく `applyFlagSettings()` によってのみ受け入れられます。v2.1.284 より前では、`ultracode` キーのみもレベルを `xhigh` に設定していました。738`effortLevel` は [努力レベル](/docs/ja/model-config#adjust-effort-level)名を受け入れます。また、`"ultracode"` も受け入れます。これは [ultracode](/docs/ja/workflows#let-claude-decide-with-ultracode)をオンにして `xhigh` 努力をリクエストします。`applyFlagSettings()` はその値なしで `effortLevel` を宣言するため、TypeScript では同じ結果に対して `{ ultracode: true, effortLevel: "xhigh" }` を渡すか、[`ultracode`](/docs/ja/settings-reference#ultracode)キーのみを渡して ultracode をセッションの現在の努力レベルでオンにします。`ultracode` 値には Claude Code v2.1.203 以降が必要で、設定ファイルの `effortLevel` キーではなく `applyFlagSettings()` によってのみ受け入れられます。v2.1.284 より前では、`ultracode` キーのみもレベルを `xhigh` に設定しました。

739 739 

740値はフラグ設定層に書き込まれ、`query()` の `settings` オプションがスタートアップで設定したものにマージされます。これは [ページ上の優先順位セクション](#settings-precedence) がプログラムオプションと呼ぶのと同じ層です。740値はフラグ設定層に書き込まれ、`query()` の `settings` オプションがスタートアップで設定したものにマージされます。これは [ページ上の優先順位セクション](#settings-precedence)がプログラムオプションと呼ぶのと同じ層です。

741 741 

742連続した呼び出しは最上位キーを浅くマージします。`{ permissions: {...} }` を含む 2 番目の呼び出しは、前の呼び出しから `permissions` オブジェクト全体を置き換え、深くマージするのではなく置き換えます。742連続した呼び出しは最上位キーを浅くマージします。`{ permissions: {...} }` を含む 2 番目の呼び出しは、前の呼び出しから `permissions` オブジェクト全体を置き換えるのではなく、深くマージします。

743 743 

744`applyFlagSettings()` で設定したキーをクリアするには、そのキーに `null` を渡します。ほとんどのキーは、最初に `query()` の `settings` オプションで設定された値にフォールバックし、次に低優先度ソースにフォールバックします。クリアされた `model` は、設定ファイルが `model` を設定している場合でも、[Claude Code のデフォルトモデル](/docs/ja/model-config) にリセットされます。`undefined` を渡すと JSON シリアル化がそれをドロップするため効果がありません。744`applyFlagSettings()` で設定したキーをクリアするには、そのキーに `null` を渡します。ほとんどのキーは、最初に `query()` の `settings` オプションで設定された値にフォールバックし、次に低優先度のソースにフォールバックします。クリアされた `model` は、設定ファイルが `model` を設定している場合でも、[Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットされます。`undefined` を渡すと JSON シリアル化がそれをドロップするため効果がありません。

745 745 

746`model` 以外の 3 つのキーはフォールバックする代わりにセッション状態をリセットします:746`model` 以外の 3 つのキーはフォールバックする代わりにセッション状態をリセットします:

747 747 

748* `effortLevel: null` は、`query()` の `effort` オプションまたは設定ファイルの `effortLevel` ではなく、セッションをモデルのデフォルト努力レベルに戻します。748* `effortLevel: null` は、`query()` の `effort` オプションまたは設定ファイルの `effortLevel` ではなく、セッションをモデルのデフォルト努力レベルに戻します。

749* `agent: null` は、`query()` の `agent` オプションまたは設定ファイルの `agent` を復元するのではなく、次のターンからメインスレッドをエージェントなしで実行します。クリアされたエージェントが独自のモデルを適用していた場合、セッションはスタートアップで解決したモデルに戻ります。749* `agent: null` は、`query()` の `agent` オプションまたは設定ファイルの `agent` を復元するのではなく、次のターンから専用エージェントなしでメインスレッドを実行します。クリアされたエージェントが独自のモデルを適用していた場合、セッションはスタートアップで解決したモデルに戻ります。

750* `ultracode: null` は `false` と同様に ultracode をオフにし、設定ファイルから `ultracode` 値を復元するのではなく、オフにします。セッションは現在の努力レベルを保持するため、同じ呼び出しで `effortLevel` を渡して変更してください。750* `ultracode: null` は `false` と同様に ultracode をオフにし、設定ファイルから `ultracode` 値を復元するのではなく。セッションは現在の努力レベルを保持するため、同じ呼び出しで `effortLevel` を渡して変更します。

751 751 

752ストリーミング入力モードでのみ利用可能で、`setModel()` と `setPermissionMode()` と同じ制約があります。752ストリーミング入力モードでのみ利用可能で、`setModel()` と `setPermissionMode()` と同じ制約があります。

753 753 

754以下の例は、ミッドセッション中にアクティブなモデルを切り替え、その後オーバーライドをクリアして、モデルを [Claude Code のデフォルトモデル](/docs/ja/model-config) にリセットします。754以下の例は、セッション中にアクティブなモデルを切り替え、その後オーバーライドをクリアして、モデルを [Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットします。

755 755 

756```typescript theme={null}756```typescript theme={null}

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

758 758 

759const q = query({ prompt: messageStream });759const q = query({ prompt: messageStream });

760 760 

761// セッションの残りの部分のモデルをオーバーライドします761// セッションの残りの期間、モデルをオーバーライドします

762await q.applyFlagSettings({ model: "claude-opus-4-6" });762await q.applyFlagSettings({ model: "claude-opus-4-6" });

763 763 

764// 後で: オーバーライドをクリアします。モデルは Claude Code のデフォルトにリセットされます764// 後で: オーバーライドをクリアします。モデルは Claude Code のデフォルトにリセットされます

773 `updateSettings()`773 `updateSettings()`

774</h4>774</h4>

775 775 

776設定ファイルをディスクに 1 つのホワイトリスト登録キーを書き込み、値が後のセッションで永続化されるようにします。各ソースは 1 つのキーを受け入れ、文字列値を持ちます:776設定ファイルをディスクに書き込み、値が後のセッションで永続化されるようにします。各ソースは 1 つのキーを受け入れ、文字列値を持ちます:

777 777 

778* **`"localSettings"`**: `outputStyle` を受け入れ、プロジェクトのローカル設定ファイル `.claude/settings.local.json` にマージします。新しいスタイルはセッションの次のリクエストで有効になります。778* **`"localSettings"`**: `outputStyle` を受け入れ、プロジェクトのローカル設定ファイル `.claude/settings.local.json` にマージします。新しいスタイルはセッションの次のリクエストで有効になります。

779* **`"userSettings"`**: `effortLevel` を受け入れ、セッションの現在のモデルのデフォルト [努力レベル](/docs/ja/model-config#adjust-effort-level) としてユーザー設定ファイルの [`modelSettings`](/docs/ja/settings-reference#modelsettings) に保存します。`max` を渡すと、`max` はセッションのみであるため何も書き込みません。実行中のセッションはいずれにせよ現在の努力レベルを保持するため、それも変更したい場合は [`applyFlagSettings()`](#applyflagsettings) を呼び出してください。このソースには TypeScript SDK v0.3.277 以降が必要で、Claude Code v2.1.277 をバンドルしています。779* **`"userSettings"`**: `effortLevel` を受け入れ、セッションの現在のモデルのデフォルト [努力レベル](/docs/ja/model-config#adjust-effort-level)としてユーザー設定ファイルの [`modelSettings`](/docs/ja/settings-reference#modelsettings) の下に保存します。`max` を渡すと、`max` はセッションのみであるため何も書き込みません。実行中のセッションはいずれにせよ現在の努力レベルを保持するため、それも変更する場合は [`applyFlagSettings()`](#applyflagsettings)を呼び出してください。このソースには TypeScript SDK v0.3.277 以降が必要で、Claude Code v2.1.277 をバンドルしています。

780 780 

781リクエストが他のキーを含む場合、セッションがリモートトランスポートで実行される場合、およびセッションの [`settingSources`](#options) が指定したソースを除外する場合、呼び出しは拒否されます。キーの削除はサポートされていません。781呼び出しは、リクエストが他のキーを含む場合、セッションがリモートトランスポートで実行される場合、およびセッションの [`settingSources`](#options)が名前を付けたソースを除外する場合に拒否されます。キーの削除はサポートされていません。

782 782 

783<h3 id="warmquery">783<h3 id="warmquery">

784 `WarmQuery`784 `WarmQuery`

785</h3>785</h3>

786 786 

787[`startup()`](#startup) によって返されるハンドル。サブプロセスは既にスポーンされ初期化されているため、このハンドルで `query()` を呼び出すと、スタートアップレイテンシーなしで準備完了プロセスにプロンプトを直接書き込みます。787[`startup()`](#startup)によって返されるハンドル。サブプロセスは既にスポーンおよび初期化されているため、このハンドルで `query()` を呼び出すと、スタートアップレイテンシーなしで準備完了プロセスにプロンプトを直接書き込みます。

788 788 

789```typescript theme={null}789```typescript theme={null}

790interface WarmQuery extends AsyncDisposable {790interface WarmQuery extends AsyncDisposable {

799 799 

800| メソッド | 説明 |800| メソッド | 説明 |

801| :- | :- |801| :- | :- |

802| `query(prompt)` | 事前ウォーミングされたサブプロセスにプロンプトを送信し、[`Query`](#query-object) を返します。`WarmQuery` ごとに 1 回のみ呼び出すことができます |802| `query(prompt)` | 事前ウォーミングされたサブプロセスにプロンプトを送信し、[`Query`](#query-object)を返します。`WarmQuery` ごとに 1 回のみ呼び出すことができます |

803| `close()` | プロンプトを送信せずにサブプロセスを閉じます。不要になった warm query を破棄するために使用します |803| `close()` | プロンプトを送信せずにサブプロセスを閉じます。不要になった warm query を破棄するために使用します |

804 804 

805`WarmQuery` は `AsyncDisposable` を実装するため、自動クリーンアップのために `await using` で使用できます。805`WarmQuery` は `AsyncDisposable` を実装するため、自動クリーンアップのために `await using` で使用できます。

808 `SpareProcess`808 `SpareProcess`

809</h3>809</h3>

810 810 

811*アルファ。* [`prewarm()`](#prewarm) によって返されるハンドル: セッションにまだバインドされていない開始された Claude Code プロセスで、1 回クレームできます。TypeScript Agent SDK v0.3.282 以降が必要です。811*アルファ。* [`prewarm()`](#prewarm)によって返されるハンドル: セッションにまだバインドされていない開始された Claude Code プロセスで、1 回クレームできます。TypeScript Agent SDK v0.3.282 以降が必要です。

812 812 

813```typescript theme={null}813```typescript theme={null}

814interface SpareProcess extends AsyncDisposable {814interface SpareProcess extends AsyncDisposable {

828 828 

829| メンバー | 説明 |829| メンバー | 説明 |

830| :- | :- |830| :- | :- |

831| `claim({ prompt, options })` | スペアを `options.cwd` のセッションにバインドし、最初のメッセージを送信します。`query()` と同様に [`Query`](#query-object) を同期的に返します。1 回のみ呼び出すことができます |831| `claim({ prompt, options })` | スペアを `options.cwd` のセッションにバインドし、最初のメッセージを送信します。`query()` と同様に [`Query`](#query-object)を同期的に返します。1 回のみ呼び出すことができます |

832| `claimed` | Claude Code がクレームを受け入れると、セッションのワーキングディレクトリと ID で解決します。Claude Code がクレームを拒否する場合、プロセスが終了またはクローズされた場合、および `option_not_applied` で始まるメッセージを含む場合に拒否します。セッションは要求した `model` または `maxThinkingTokens` なしで実行されています |832| `claimed` | Claude Code がクレームを受け入れると、セッションのワーキングディレクトリと ID で解決します。Claude Code がクレームを拒否する場合、プロセスが終了または最初に閉じられた場合、および `option_not_applied` で始まるメッセージを含む場合に拒否します。要求した `model` または `maxThinkingTokens` なしでセッションが実行されている場合 |

833| `exited` | プロセスが終了すると、クレームされたかどうかに関わらず解決します。クレーム前に終了するスペアを置き換えます |833| `exited` | プロセスが終了すると解決します。クレーム前に終了するスペアを置き換えます |

834| `close()` | プロセスを終了します。クレーム前にこれはスペアを破棄し、`claimed` を拒否します |834| `close()` | プロセスを終了します。クレーム前にこれはスペアを破棄し、`claimed` を拒否します |

835 835 

836`options.cwd` は必須です。クレームは `additionalDirectories`、`model`、`permissionMode`、`maxThinkingTokens`、`settings` のフラグ設定オーバーレイ、`appendSystemPrompt`、`title`、`agents`、および `env` のセッションごとのトークンも設定できます。836`options.cwd` は必須です。クレームは `additionalDirectories`、`model`、`permissionMode`、`maxThinkingTokens`、`settings` のフラグ設定オーバーレイ、`appendSystemPrompt`、`title`、`agents`、および `env` のセッションごとのトークンも設定できます。

837 837 

838Claude Code はクレームを拒否できます。例えば、存在しないフォルダまたはプロジェクト設定が `env`、`agent`、または `model` を設定するフォルダの場合です。`claimed` が `option_not_applied` で始まるメッセージで拒否する場合、セッションは要求した `model` または `maxThinkingTokens` なしで実行されています。他の拒否の場合、プロンプトは実行されていないため、代わりに `query()` でセッションを開始してください。838Claude Code はクレームを拒否できます。例えば、存在しないフォルダまたはプロジェクト設定が `env`、`agent`、または `model` を設定するフォルダの場合。`claimed` が `option_not_applied` で始まるメッセージで拒否する場合、セッションは要求した `model` または `maxThinkingTokens` なしで実行されています。他の拒否の場合、プロンプトは実行されていないため、代わりに `query()` でセッションを開始してください。

839 839 

840<h3 id="sdkcontrolinitializeresponse">840<h3 id="sdkcontrolinitializeresponse">

841 `SDKControlInitializeResponse`841 `SDKControlInitializeResponse`

857};857};

858```858```

859 859 

860`hooks_applied` は Claude Code が `initialize` リクエストが含む `hooks` を登録したかどうかを報告します。SDK はセッション開始時にそのリクエストを 1 回送信し、各 [`reinitialize()`](#query-object) 呼び出しで再度送信します。フィールドには Agent SDK v0.3.238 以降が必要です。860`hooks_applied` は Claude Code が `initialize` リクエストが実行した `hooks` を登録したかどうかを報告します。SDK はセッションが開始されるときにそのリクエストを 1 回送信し、各 [`reinitialize()`](#query-object)呼び出しで再度送信します。フィールドには Agent SDK v0.3.238 以降が必要です。

861 861 

862Claude Code はリクエストがフックを含まない場合、フィールドを省略します。リクエストがフックを含む場合、値はリクエストがセッションの最初の初期化であるかどうか、および繰り返されるものの場合、それがセッションに到達した方法に依存します:862Claude Code はリクエストがフックを実行しなかった場合、フィールドを省略します。リクエストがフックを実行した場合、値はリクエストがセッションの最初の初期化であるかどうか、および繰り返されるものの場合、セッションに到達した方法に依存します:

863 863 

864* `true`: Claude Code はフックを登録しました。セッションの最初の初期化はこの値を返します。CLI の stdin を通じて送信された繰り返し初期化も `true` を返します。その場合、新しいリクエストのフックは以前に登録されたフックを置き換えます。864* `true`: Claude Code はフックを登録しました。セッションの最初の初期化はこの値を返します。CLI の stdin を通じて送信された繰り返し初期化もこの値を返します。その場合、新しいリクエストのフックは以前に登録されたフックを置き換えます。

865* `false`: Claude Code はフックを無視しました。リモートセッションに送信された繰り返し初期化はこの値を返すため、セッションに参加する 2 番目のクライアントは最初のクライアントが登録したフックを置き換えることはできません。865* `false`: Claude Code はフックを無視しました。リモートセッションに送信された繰り返し初期化はこの値を返すため、セッションに参加する 2 番目のクライアントは最初のクライアントが登録したフックを置き換えることはできません。

866 866 

867Agent SDK v0.3.238 より前では、レスポンスはフィールドを含まず、Claude Code はすべての繰り返し初期化で `hooks` を無視していました。867Agent SDK v0.3.238 より前では、レスポンスはフィールドを実行しなかったため、Claude Code はすべての繰り返し初期化でフックを無視しました。

868 868 

869レスポンスは常に `fast_mode_state` を報告し、何かが [fast mode](/docs/ja/fast-mode) をブロックする場合、`fast_mode_disabled_reason` はブロックされた状態を説明できるように理由コードを含めます。両方の動作には Claude Code v2.1.219 以降が必要です。v2.1.219 より前では、fast mode が利用できない場合、レスポンスは `fast_mode_state` を省略し、理由を含むことはありませんでした。理由コードとその意味については、結果メッセージの [`fast_mode_disabled_reason`](#sdkresultmessage) を参照してください。869レスポンスは常に `fast_mode_state` を報告し、何かが [fast mode](/docs/ja/fast-mode)をブロックする場合、`fast_mode_disabled_reason` はブロックされた状態を説明できるように理由コードを含みます。両方の動作には Claude Code v2.1.219 以降が必要です。v2.1.219 より前では、fast mode が利用可能でない場合、レスポンスは `fast_mode_state` を省略し、理由を実行しませんでした。理由コードとその意味については、結果メッセージの [`fast_mode_disabled_reason`](#sdkresultmessage)を参照してください。

870 870 

871成功した `initialize` の制御レスポンスラッパーは、`pending_permission_requests` 配列も含みます。フィールドは `SDKControlInitializeResponse` ペイロード内ではなく、レスポンスラッパー自体にあります。各エントリは、セッションが実行中に権限リクエストのためにストリーミングするのと同じ `{ type: "control_request", request_id, request }` 形状を持つ完全な `control_request` メッセージです。871成功した `initialize` の制御レスポンスラッパーは `pending_permission_requests` 配列も実行します。フィールドは上記の `SDKControlInitializeResponse` ペイロード内ではなく、レスポンスラッパー自体にあります。各エントリは、セッションが実行中にストリーミングする権限リクエストと同じ `{ type: "control_request", request_id, request }` 形状を持つ完全な `control_request` メッセージです。

872 872 

873配列は、この Claude Code プロセスが発行し、まだ解決していない権限リクエストをリストします。SDK はあなたのために配列を読み取り、各エントリを [`canUseTool`](#canusetool) コールバックにディスパッチします。これは、トランスポートギャップ後に [`reinitialize()`](#query-object) がトリガーするのと同じ再配信です。繰り返されたリクエスト ID をべき等に処理してください。エントリは、接続が切断される前にコールバックが既に受け取ったリクエストを繰り返すことができるためです。873配列は、この Claude Code プロセスが発行し、まだ解決していない権限リクエストをリストします。SDK はあなたのために配列を読み取り、各エントリを [`canUseTool`](#canusetool)コールバックにディスパッチします。これは [`reinitialize()`](#query-object)がトランスポートギャップ後にトリガーするのと同じ再配信です。繰り返されたリクエスト ID をべき等に処理してください。エントリは、接続が切断される前にコールバックが既に受け取ったリクエストを繰り返すことができるためです。

874 874 

875配列は成功した `initialize` レスポンスで常に存在し、このプロセスに未解決の権限リクエストがない場合は空です。Claude Code v2.1.268 以降が必要です。以前のバージョンはフィールドを省略できるため、ワイヤープロトコルを自分で解析する場合、欠落しているフィールドを古い CLI として扱い、何も保留中でないという証拠ではなく扱ってください。875配列は成功した `initialize` レスポンスで常に存在し、このプロセスに未解決の権限リクエストがない場合は空です。Claude Code v2.1.268 以降が必要です。以前のバージョンはフィールドを省略できるため、ワイヤプロトコルを自分で解析する場合、欠落しているフィールドを古い CLI として扱い、何も保留中でないという証拠ではなく扱ってください。

876 876 

877<h3 id="sdkcontrolinterruptresponse">877<h3 id="sdkcontrolinterruptresponse">

878 `SDKControlInterruptResponse`878 `SDKControlInterruptResponse`

879</h3>879</h3>

880 880 

881割り込み受信: [`interrupt()`](#query-object) が [`SDKSystemMessage.capabilities`](#sdksystemmessage) で `interrupt_receipt_v1` 機能をアドバタイズする CLI で解決する値。Claude Code v2.1.205 以降が必要です。以前の CLI は空の成功ペイロードで割り込みに応答するため、`interrupt()` は `undefined` に解決します。881中断レシート: [`interrupt()`](#query-object)が [`SDKSystemMessage.capabilities`](#sdksystemmessage)で `interrupt_receipt_v1` 機能をアドバタイズする CLI で解決する値。Claude Code v2.1.205 以降が必要です。以前の CLI は空の成功ペイロードで中断に応答するため、`interrupt()` は `undefined` で解決します。

882 882 

883```typescript theme={null}883```typescript theme={null}

884type SDKControlInterruptResponse = {884type SDKControlInterruptResponse = {

887};887};

888```888```

889 889 

890`still_queued` は割り込みが到着したときに保留中だったユーザーメッセージの UUID をリストします: キューに残っているメッセージ、および Claude Code が既に次のターンのキューから取り出したメッセージ。セッションの最初のターンが開始されると、Claude Code は割り込みがない限り、リストされたメッセージを処理します。最初のターンが開始される前に割り込みを行う場合、Claude Code はそのターンが開始されるとすぐに中止し、そのターンのリストされたメッセージはレスポンスを取得しません。890`still_queued` は、中断が到着したときに保留中だったユーザーメッセージの UUID をリストします。キューに入ったままのメッセージ、および Claude Code が既に次のターンのキューから取り出したメッセージ。セッションの最初のターンが開始されると、Claude Code は中断しない限り、リストされたメッセージを処理します。最初のターンが開始される前に中断する場合、Claude Code はそのターンが開始されるとすぐに中止し、そのターンのリストされたメッセージはレスポンスを取得しません。

891 891 

892受信を使用して、何かを再送信するかどうかを決定します。リストされたメッセージをキャンセルしない場合、レスポンスを取得するかどうかに関わらず会話に入るため、再送信するとそれを Claude に 2 回配信します。892レシートを使用して、何を再送信するかを決定します。リストされたメッセージで キャンセルしないものは、レスポンスを取得するかどうかに関わらず会話に入るため、それを再送信すると Claude に 2 回配信されます。

893 893 

894これらの注意事項でリストを解釈します:894これらの注意事項でリストを解釈します:

895 895 

896* UUID でエンキューされたメッセージのみが表示されます。空の配列は他に何も実行されないことを意味しません。896* UUID で登録されたメッセージのみが表示されます。空の配列は他に何も実行されないことを意味しません。

897* メインスレッドメッセージのみがリストされます。サブエージェントに宛てられたメッセージはスコープ外です。897* メインスレッドメッセージのみがリストされます。サブエージェントに対処されたメッセージはスコープ外です。

898* リストには、[スケジュール済みタスク](/docs/ja/scheduled-tasks) トリガーなど、クライアントが送信しなかった UUID を含めることができます。エラーとして扱うのではなく、認識しない UUID を無視してください。898* リストには、[スケジュール済みタスク](/docs/ja/scheduled-tasks)トリガーなど、クライアントが送信しなかった UUID が含まれる場合があります。認識しない UUID を無視し、エラーとして扱わないでください。

899 899 

900制御プロトコルを `interrupt()` ではなく直接駆動するクライアントは、`interrupt` 制御リクエストで `cancel_queued: true` を設定できます。Claude Code v2.1.219 以降は [`SDKSystemMessage.capabilities`](#sdksystemmessage) で `interrupt_cancel_queued_v1` 機能でサポートをアドバタイズします。古い CLI はフィールドを無視し、キューに入ったメッセージを通常どおり実行したままにします。そのような割り込みは、`still_queued` の下にリストされるすべてのメッセージをキャンセルします: 代わりに `cancelled` の下にリストされ、`still_queued` は空で、それらのどれも実行されません。900CLI の制御プロトコルを `interrupt()` ではなく直接駆動するクライアントは、`interrupt` 制御リクエストで `cancel_queued: true` を設定できます。Claude Code v2.1.219 以降は [`SDKSystemMessage.capabilities`](#sdksystemmessage)で `interrupt_cancel_queued_v1` 機能でサポートをアドバタイズします。以前の CLI はフィールドを無視し、キューに入ったメッセージを通常どおり実行したままにします。そのような中断はリストされるはずだったすべてのメッセージをキャンセルします: レシートはそれらを `cancelled` の下にリストし、`still_queued` は空で、それらのどれも実行されません。

901 901 

902`cancelled` リストは `still_queued` と同じ注意事項を含みます。`interrupt()` メソッドは `cancel_queued` を送信しないため、それが解決する受信は `cancelled` を含みません。902`cancelled` リストは `still_queued` と同じ注意事項を実行します。`interrupt()` メソッドは `cancel_queued` を送信しないため、それが解決するレシートは `cancelled` を実行しません。

903 903 

904受信は割り込みが処理される瞬間のスナップショットで、クリーン割り込みで中断されたターンの [`SDKResultMessage`](#sdkresultmessage) の前に到着します。その結果の後のキューを検査するのではなく、受信を読み取ってください: ループは次のキューに入ったターンをすぐに開始するため、結果の後に検査するキューは既に変更されています。904レシートは中断が処理される瞬間に撮られたスナップショットで、クリーンな中断では中断されたターンの [`SDKResultMessage`](#sdkresultmessage)の前に到着します。そのレシートの後のレシートを読み取るのではなく、キューを検査してください: ループは次のキューに入ったターンをすぐに開始するため、レシートの後に検査するキューは既に変更されています。

905 905 

906<h3 id="sdkcontrolgetcontextusageresponse">906<h3 id="sdkcontrolgetcontextusageresponse">

907 `SDKControlGetContextUsageResponse`907 `SDKControlGetContextUsageResponse`

908</h3>908</h3>

909 909 

910[`getContextUsage()`](#query-object) の戻り値の型。デフォルト `detail` では、これは対話型セッションで `/context` コマンドが Claude Code がレンダリングするのと同じペイロードで、トークンカウントと共に `/context` 使用グリッドを描画するために Claude Code が使用する `color` および `gridRows` などの表示フィールドを含みます。910[`getContextUsage()`](#query-object)の戻り値の型。デフォルト `detail` では、これは Claude Code が対話型セッションで `/context` コマンドに対してレンダリングするのと同じペイロードで、トークンカウントと共に `color` および `gridRows` などの表示フィールドを実行します。Claude Code は `/context` 使用グリッドを描画するために使用します。

911 911 

912メソッドのオプション `detail` 引数は、Claude Code が各カテゴリをカウントする方法を選択します。デフォルト `'full'` では、Claude Code はトークンカウント API リクエストで各カテゴリをカウントします。最後のレスポンスの使用状況とローカル推定から答えを取得するには `{ detail: 'summary' }` を渡します。トークンカウントリクエストは送信されず、カテゴリごとの数値は概算です。`detail` 引数には Agent SDK v0.3.257 以降が必要です。912メソッドのオプション `detail` 引数は、Claude Code が各カテゴリをカウントする方法を選択します。`detail` 引数には Agent SDK v0.3.257 以降が必要です。

913 913 

914メソッドの代わりに `/context` をプロンプトとして送信する場合、Claude Code は結果を配信するアシスタントメッセージの `context_usage` フィールドに [`SDKContextUsage`](#sdkcontextusage) ペイロードを添付します。そのフィールドには Agent SDK v0.3.232 以降が必要です。914* **`'full'`**: デフォルト。Claude Code は [トークンカウント](https://platform.claude.com/docs/en/build-with-claude/token-counting) API リクエストで各カテゴリをカウントします。これらのリクエストはメッセージストリームに表示されないため、ストリームを読み取るコスト追跡はそれらを表示しません。Anthropic API では、トークンカウントは請求されません。

915* **`'summary'`**: `{ detail: 'summary' }` を渡して、最後のレスポンスの使用状況とローカル推定から答えを取得します。トークンカウントリクエストは送信されず、カテゴリごとの数値は概算です。

916 

917代わりにメソッドを呼び出す場合、`/context` をプロンプトとして送信すると、Claude Code は結果を配信するアシスタントメッセージの `context_usage` フィールドに [`SDKContextUsage`](#sdkcontextusage)ペイロードを添付します。そのフィールドには Agent SDK v0.3.232 以降が必要です。

915 918 

916```typescript theme={null}919```typescript theme={null}

917type SDKControlGetContextUsageResponse = {920type SDKControlGetContextUsageResponse = {

1008};1011};

1009```1012```

1010 1013 

1011トークン帰属をコレクションフィールドから読み取ります:1014トークン属性をコレクションフィールドから読み取ります:

1012 1015 

1013* `categories` はカテゴリごとの合計を保持します。各エントリの `kind` は [`SDKContextUsageCategory`](#sdkcontextusagecategory) と同じ値でカテゴリを分類します。表示 `name` ではなく `kind` でカテゴリを分類してください。フィールドには Agent SDK v0.3.268 以降が必要です。1016* `categories` はカテゴリごとの合計を保持します。各エントリの `kind` は [`SDKContextUsageCategory`](#sdkcontextusagecategory)と同じ値で行を分類します。表示 `name` ではなく、それで行を分類します。フィールドには Agent SDK v0.3.268 以降が必要です。

1014* `mcpTools` と `agents` はトークンを個別の MCP ツールとサブエージェントに帰属させます。1017* `mcpTools` および `agents` は個々の MCP ツールおよびサブエージェントにトークンを属性付けします。

1015* `memoryFiles` は各読み込まれたメモリファイルとそのコストをリストします。1018* `memoryFiles` は読み込まれた各メモリファイルをそのコストと共にリストします。

1016* `skills.skillFrontmatter` は、含まれる各スキルにスキルリストのトークンを帰属させます。スキルごとの数値は、Claude Code が実際に送信するスキルリストエントリを測定します。これはスキルの完全なフロントマターより短くなる可能性があります。`skills.totalSkills` を `skills.includedSkills` と比較して、検出されたすべてのスキルがリストに含まれているかどうかを確認します。1019* `skills.skillFrontmatter` は各含まれるスキルにスキルリストのトークンを属性付けします。スキルごとの数値は、Claude Code が実際に送信するスキルのリストエントリを測定します。これはスキルの完全なフロントマターより短くなる可能性があります。`skills.totalSkills` を `skills.includedSkills` と比較して、すべての検出されたスキルがリストに含まれているかどうかを確認します。

1017 1020 

1018`totalTokens` はセッションの現在のコンテキスト使用状況で、`maxTokens` はその使用状況が測定されるウィンドウです。そのウィンドウはモデルのコンテキストウィンドウ、または 1 つが適用される場合は低い自動コンパクション ウィンドウです。`rawMaxTokens` は `maxTokens` と同じ値を含み、`percentage` は `totalTokens` をそのウィンドウのパーセンテージとして丸めたものです。1021`totalTokens` はセッションの現在のコンテキスト使用状況で、`maxTokens` はその使用状況が測定されるウィンドウです。そのウィンドウはモデルのコンテキストウィンドウ、または自動コンパクション ウィンドウが適用される場合はより低いウィンドウです。`rawMaxTokens` は `maxTokens` と同じ値を実行し、`percentage` は `totalTokens` をそのウィンドウのパーセンテージとして丸めたものです。`apiUsage` は、セッションの実行合計ではなく、最新の API レスポンスからの使用状況を保持します。

1019 1022 

1020Claude Code は、オプション `deferredBuiltinTools`、`systemTools`、および `systemPromptSections` 診断を設定しないままにするため、型が宣言していても存在しないことを期待してください。1023Claude Code はオプション `deferredBuiltinTools`、`systemTools`、および `systemPromptSections` 診断を設定しないため、型が宣言していても存在しないことを期待してください。

1021 1024 

1022<h3 id="sdkcontrolreadfileresponse">1025<h3 id="sdkcontrolreadfileresponse">

1023 `SDKControlReadFileResponse`1026 `SDKControlReadFileResponse`

1024</h3>1027</h3>

1025 1028 

1026[`readFile()`](#query-object) の戻り値の型。1029[`readFile()`](#query-object)の戻り値の型。

1027 1030 

1028```typescript theme={null}1031```typescript theme={null}

1029type SDKControlReadFileResponse = {1032type SDKControlReadFileResponse = {

1034};1037};

1035```1038```

1036 1039 

1037`contents` はファイルテキストを保持するか、`encoding: 'base64'` をリクエストした場合は base64 データを保持します。レスポンスの `encoding` フィールドはその場合 `'base64'` に設定されます。`absPath` は解決された絶対パスです。`truncated` は、ファイルが `maxBytes` キャップより長く、コンテンツがその制限で切り詰められた場合に設定されます。1040`contents` はファイルテキスト、または `encoding: 'base64'` をリクエストした場合は base64 データを保持します。レスポンスの `encoding` フィールドはその場合 `'base64'` に設定されます。`absPath` は解決された絶対パスです。`truncated` は、ファイルが `maxBytes` キャップより長く、コンテンツがその制限で切り詰められた場合に設定されます。

1038 1041 

1039<h4 id="what-readfile-can-read">1042<h4 id="what-readfile-can-read">

1040 `readFile()` が読み取れるもの1043 `readFile()` が読み取れるもの

1042 1045 

1043`readFile()` は Read ツールより狭いファイルセットを提供します:1046`readFile()` は Read ツールより狭いファイルセットを提供します:

1044 1047 

1045* `cwd` および `additionalDirectories` などのセッションのワーキングディレクトリの 1 つ内の通常ファイル1048* `cwd` および `additionalDirectories` などのセッションのワーキングディレクトリ内の通常ファイル

1046* セッションのツール結果などの Claude Code 独自のファイルのいくつか1049* ツール結果などのセッションの Claude Code 独自ファイルのいくつか

1047 1050 

1048Read 拒否および質問ルールは引き続き一致するパスをブロックし、広い Read 許可ルールは `readFile()` にファイルシステムの残りを開きません。他のすべてについて、呼び出しは `null` で解決します。1051Read 拒否および質問ルールは引き続き一致するパスをブロックし、広い Read 許可ルールは `readFile()` に残りのファイルシステムを開きません。他のすべてについて、呼び出しは `null` で解決します。

1049 1052 

1050<h3 id="sdkcontrolreloadpluginsresponse">1053<h3 id="sdkcontrolreloadpluginsresponse">

1051 `SDKControlReloadPluginsResponse`1054 `SDKControlReloadPluginsResponse`

1052</h3>1055</h3>

1053 1056 

1054[`reloadPlugins()`](#query-object) の戻り値の型。1057[`reloadPlugins()`](#query-object)の戻り値の型。

1055 1058 

1056```typescript theme={null}1059```typescript theme={null}

1057type SDKControlReloadPluginsResponse = {1060type SDKControlReloadPluginsResponse = {

1076 1079 

1077コレクションフィールドは呼び出し後のセッションを説明します:1080コレクションフィールドは呼び出し後のセッションを説明します:

1078 1081 

1079* `commands`、`agents`、および `mcpServers`: セッションのコマンド、サブエージェント、MCP サーバーステータス。`supportedCommands()`、`supportedAgents()`、および `mcpServerStatus()` が返すのと同じ形状です。`supportedAgents()` は初期化時にキャプチャされたリストを返し続けるため、再読み込み後のセットについてはここで `agents` を読み取ってください1082* `commands`、`agents`、および `mcpServers`: セッションのコマンド、サブエージェント、および MCP サーバーステータス。`supportedCommands()`、`supportedAgents()`、および `mcpServerStatus()` が返すのと同じ形状。`supportedAgents()` は初期化でキャプチャされたリストを返し続けるため、再読み込み後のセットについてはここで `agents` を読み取ります

1080* `plugins`: 各読み込まれたプラグインとその `name` およびインストール `path`。`version` はプラグインのマニフェストが宣言するものを繰り返し、プラグイン作成者が制御するため、信頼する前に検証してください。マニフェストが宣言しない場合は省略されます1083* `plugins`: 各読み込まれたプラグインとそのインストール `path`。`version` はプラグインのマニフェストが宣言するものを繰り返し、プラグイン作成者が制御するため、信頼する前に検証してください。マニフェストが宣言しない場合は省略されます

1081* `error_count`: プラグイン読み込みからのエラー数1084* `error_count`: プラグイン読み込みからのエラー数

1082 1085 

1083会話のプロンプトキャッシュを無効にするリロードを保持するには、`{ holdOnCacheImpact: true }` を `reloadPlugins()` に渡します。Claude Code は対話型 `/reload-plugins` コマンドが [キャッシュコストについて警告](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin) する前に行うチェックを実行します。オプションには Agent SDK v0.3.268 以降が必要です。v2.1.268 より古い Claude Code 実行可能ファイル（`pathToClaudeCodeExecutable` で指定したものなど）はオプションを無視し、リロードを適用します。1086`reloadPlugins()` に `{ holdOnCacheImpact: true }` を渡して、会話のプロンプトキャッシュを無効にする再読み込みを保持し、適用する代わりに保持します。Claude Code は対話型 `/reload-plugins` コマンドが [キャッシュコストについて警告](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)する前に行うチェックを実行します。オプションには Agent SDK v0.3.268 以降が必要です。`pathToClaudeCodeExecutable` が指す v2.1.268 より前の Claude Code 実行可能ファイルはオプションを無視し、再読み込みを適用します。

1084 1087 

1085オプションを渡すと、`held` を読み取って何が起こったかを確認します:1088オプションを渡すと、`held` を読み取って何が起こったかを学びます:

1086 1089 

1087* `true`: リロードは適用されず、コレクションフィールドはセッションをそのまま説明します。`cache_impact` は適用が何を変更するかを示します。とにかく適用するには、オプションなしで `reloadPlugins()` を再度呼び出してください。1090* `true`: 再読み込みは適用されず、コレクションフィールドはセッションをそのまま説明します。`cache_impact` は適用が変更するものを言います。とにかく適用するには、オプションなしで `reloadPlugins()` を再度呼び出します。

1088* `false`: チェックはキャッシュ影響を見つけず、リロードが適用されました。1091* `false`: チェックはキャッシュ影響を見つけず、再読み込みが適用されました。

1089* 存在しない: オプションを渡さなかったか、Claude Code 実行可能ファイルが v2.1.268 より古く、リロードを適用しました。1092* 不在: オプションを渡さなかったか、Claude Code 実行可能ファイルが v2.1.268 より前で再読み込みを適用しました。

1090 1093 

1091`cache_impact` は `held: true` と共にのみ存在します。`mcp_servers_added` と `mcp_servers_removed` はリロードが登録または削除するプラグイン MCP サーバーを、スコープ付き `plugin:<plugin>:<server>` 名として指定します。名前はプラグイン作成者が作成するため、表示する前に検証してください。`lsp_tool_change` は適用が LSP ツールを追加または削除するかどうかを示し、どちらもしない場合は `null` です。`may-` 形式は、チェックが保留中のプラグインセットを完全に見ることができなかったことを意味します。1094`cache_impact` は `held: true` と共にのみ存在します。`mcp_servers_added` および `mcp_servers_removed` は再読み込みが登録または削除するプラグイン MCP サーバーをスコープ付き `plugin:<plugin>:<server>` 名として名前付けます。名前はプラグイン作成者が作成するため、表示する前に検証してください。`lsp_tool_change` は適用が LSP ツールを追加または削除するかどうかを言うか、どちらでもない場合は `null`。`may-` 形式は、チェックが保留中のプラグインセットを完全に見ることができなかったことを意味します。

1092 1095 

1093<h3 id="sdkcontrolreloadskillsresponse">1096<h3 id="sdkcontrolreloadskillsresponse">

1094 `SDKControlReloadSkillsResponse`1097 `SDKControlReloadSkillsResponse`

1095</h3>1098</h3>

1096 1099 

1097[`reloadSkills()`](#query-object) の戻り値の型。1100[`reloadSkills()`](#query-object)の戻り値の型。

1098 1101 

1099```typescript theme={null}1102```typescript theme={null}

1100type SDKControlReloadSkillsResponse = {1103type SDKControlReloadSkillsResponse = {

1102};1105};

1103```1106```

1104 1107 

1105`skills` は再読み込み後に利用可能なスキルをリストします。`supportedCommands()` が返すのと同じ [`SlashCommand`](#slashcommand) 形状です。1108`skills` は再読み込み後に利用可能なスキルをリストし、`supportedCommands()` が返すのと同じ [`SlashCommand`](#slashcommand)形状です。

1106 1109 

1107<h3 id="sdkcontrolreloadoutputstylesresponse">1110<h3 id="sdkcontrolreloadoutputstylesresponse">

1108 `SDKControlReloadOutputStylesResponse`1111 `SDKControlReloadOutputStylesResponse`

1109</h3>1112</h3>

1110 1113 

1111[`reloadOutputStyles()`](#query-object) の戻り値の型。1114[`reloadOutputStyles()`](#query-object)の戻り値の型。

1112 1115 

1113```typescript theme={null}1116```typescript theme={null}

1114type SDKControlReloadOutputStylesResponse = {1117type SDKControlReloadOutputStylesResponse = {

1122 `SDKControlMcpReadResourceResponse`1125 `SDKControlMcpReadResourceResponse`

1123</h3>1126</h3>

1124 1127 

1125[`readMcpResource()`](#query-object) の戻り値の型。MCP サーバーの `resources/read` 結果を含みます。TypeScript Agent SDK v0.3.280 以降が必要です。1128[`readMcpResource()`](#query-object)の戻り値の型。MCP サーバーの `resources/read` 結果を実行します。TypeScript Agent SDK v0.3.280 以降が必要です。

1126 1129 

1127```typescript theme={null}1130```typescript theme={null}

1128type SDKControlMcpReadResourceResponse = {1131type SDKControlMcpReadResourceResponse = {

1136};1139};

1137```1140```

1138 1141 

1139`readMcpResource()` にサーバー名を `mcpServerStatus()` が報告するのと同様に、および `ui://` URI（ツールが [`_meta`](#mcpserverstatus) で宣言する `ui.resourceUri` など）を渡します。呼び出しは他の URI スキーム、アプリケーションが自分でホストする [SDK MCP サーバー](#createsdkmcpserver)、および接続されていないサーバーに対して拒否します。初期化メッセージの [`capabilities`](#sdksystemmessage) に `mcp_read_resource_v1` が含まれている場合に利用可能です。1142`readMcpResource()` にサーバー名を `mcpServerStatus()` が報告するのと同じように、および `ui://` URI（ツールが [`_meta`](#mcpserverstatus)で宣言する `ui.resourceUri` など）を渡します。呼び出しは他の URI スキーム、アプリケーションが自分でホストする [SDK MCP サーバー](#createsdkmcpserver)、および接続されていないサーバーに対して拒否します。初期化メッセージの [`capabilities`](#sdksystemmessage)に `mcp_read_resource_v1` が含まれている場合に利用可能です。

1140 1143 

1141各 `contents` エントリは、サーバーが送信した 1 つのコンテンツアイテムで、`com.anthropic/` プレフィックスの下の `_meta` キーを除きます。これは Claude Code 用に予約されています。`blob` はバイナリアイテムの base64 データを保持し、`_meta` はアイテム独自の `_meta` で、MCP Apps サーバーはリソースの `ui.csp` および `ui.permissions` を配置します。1144各 `contents` エントリは、`com.anthropic/` プレフィックスの下の `_meta` キーを除いて、サーバーが送信した 1 つのコンテンツアイテムです。これは Claude Code 用に予約されています。`blob` はバイナリアイテムの base64 データを保持し、`_meta` はアイテム自体の `_meta` で、MCP Apps サーバーはリソースの `ui.csp` および `ui.permissions` を配置します。

1142 1145 

1143コンテンツは信頼できない第三者の HTML であるため、サンドボックスでレンダリングしてください。1146コンテンツは信頼できない第三者の HTML であるため、サンドボックスでレンダリングしてください。

1144 1147 

1170 1173 

1171| フィールド | 必須 | 説明 |1174| フィールド | 必須 | 説明 |

1172| :- | :- | :- |1175| :- | :- | :- |

1173| `description` | はい | このエージェントを使用する場合の自然言語説明 |1176| `description` | はい | このエージェントをいつ使用するかの自然言語説明 |

1174| `tools` | いいえ | 許可されたツール名の配列。省略した場合、[サブエージェントで利用可能なすべてのツール](/docs/ja/sub-agents#available-tools) を継承します。スキルをエージェントのコンテキストにプリロードするには、ここで `'Skill'` をリストするのではなく `skills` フィールドを使用してください |1177| `tools` | いいえ | 許可されたツール名の配列。省略した場合、[サブエージェントで利用可能なすべてのツール](/docs/ja/sub-agents#available-tools)を継承します。スキルをエージェントのコンテキストにプリロードするには、ここで `'Skill'` をリストするのではなく `skills` フィールドを使用します |

1175| `disallowedTools` | いいえ | このエージェントで明示的に許可しないツール名の配列。MCP サーバーレベルのパターンも受け入れられます: `mcp__server` または `mcp__server__*` はそのサーバーからすべてのツールを削除し、`mcp__*` はすべての MCP ツールをすべてのサーバーから削除します |1178| `disallowedTools` | いいえ | このエージェントに対して明示的に許可しないツール名の配列。MCP サーバーレベルのパターンも受け入れられます: `mcp__server` または `mcp__server__*` はそのサーバーからすべてのツールを削除し、`mcp__*` はすべての MCP ツールをすべてのサーバーから削除します |

1176| `prompt` | はい | エージェントのシステムプロンプト |1179| `prompt` | はい | エージェントのシステムプロンプト |

1177| `model` | いいえ | このエージェントのモデルオーバーライド。`'fable'`、`'opus'`、`'sonnet'`、`'haiku'`、`'inherit'` などのエイリアス、または完全なモデル ID を受け入れます。`'inherit'` はメインモデルを使用します。省略した場合、Claude Code は [サブエージェントモデル順序](/docs/ja/sub-agents#choose-a-model) でモデルを選択します |1180| `model` | いいえ | このエージェントのモデルオーバーライド。`'fable'`、`'opus'`、`'sonnet'`、`'haiku'`、`'inherit'` などのエイリアス、または完全なモデル ID を受け入れます。`'inherit'` はメインモデルを使用します。省略した場合、Claude Code は [サブエージェントモデル順序](/docs/ja/sub-agents#choose-a-model)でモデルを選択します |

1178| `mcpServers` | いいえ | このエージェント用の MCP サーバー仕様 |1181| `mcpServers` | いいえ | このエージェントの MCP サーバー仕様 |

1179| `skills` | いいえ | エージェントコンテキストにプリロードするスキル名の配列 |1182| `skills` | いいえ | エージェントコンテキストにプリロードするスキル名の配列 |

1180| `initialPrompt` | いいえ | このエージェントがメインスレッドエージェントとして実行される場合、最初のユーザーターンとして自動送信されます |1183| `initialPrompt` | いいえ | このエージェントがメインスレッドエージェントとして実行される場合、最初のユーザーターンとして自動送信されます |

1181| `maxTurns` | いいえ | 停止する前のエージェンティックターン数（API ラウンドトリップ）の最大数 |1184| `maxTurns` | いいえ | 停止する前のエージェンティックターン数（API ラウンドトリップ）の最大数 |

1182| `background` | いいえ | 呼び出されたときにこのエージェントをノンブロッキングバックグラウンドタスクとして実行します |1185| `background` | いいえ | 呼び出されたときにこのエージェントをノンブロッキングバックグラウンドタスクとして実行します |

1183| `omitClaudeMd` | いいえ | このエージェントがサブエージェントとして実行される場合、ユーザー、プロジェクト、ローカル CLAUDE.md ファイルなしで実行します。管理ポリシーファイルは引き続き読み込まれます。Agent ツールプロンプトから必要なすべてを取得するエージェント用に使用します。このエージェントがメインスレッドエージェントとして実行される場合は無視されます。TypeScript Agent SDK v0.3.271 以降が必要です |1186| `omitClaudeMd` | いいえ | このエージェントがサブエージェントとして実行される場合、ユーザー、プロジェクト、ローカル CLAUDE.md ファイルなしでこのエージェントを実行します。管理ポリシーファイルは引き続き読み込まれます。Agent ツールプロンプトから必要なすべてを取得するエージェントに使用します。このエージェントがメインスレッドエージェントとして実行される場合は無視されます。TypeScript Agent SDK v0.3.271 以降が必要です |

1184| `memory` | いいえ | このエージェントのメモリソース: `'user'`、`'project'`、または `'local'` |1187| `memory` | いいえ | このエージェントのメモリソース: `'user'`、`'project'`、または `'local'` |

1185| `effort` | いいえ | このエージェントの推論努力レベル。名前付きレベルまたは整数を受け入れます |1188| `effort` | いいえ | このエージェントの推論努力レベル。名前付きレベルまたは整数を受け入れます |

1186| `permissionMode` | いいえ | このエージェント内のツール実行の権限モード。[サブエージェント継承ルール](/docs/ja/agent-sdk/permissions#available-modes) は、それが適用される場合を決定します。[`PermissionMode`](#permissionmode) を参照してください |1189| `permissionMode` | いいえ | このエージェント内のツール実行の権限モード。[サブエージェント継承ルール](/docs/ja/agent-sdk/permissions#available-modes)はいつ適用されるかを決定します。[`PermissionMode`](#permissionmode)を参照してください |

1187| `criticalSystemReminder_EXPERIMENTAL` | いいえ | 実験的: システムプロンプトに追加された重要なリマインダー |1190| `criticalSystemReminder_EXPERIMENTAL` | いいえ | 実験的: システムプロンプトに追加された重要なリマインダー |

1188 1191 

1189<h3 id="agentmcpserverspec">1192<h3 id="agentmcpserverspec">

1218 デフォルト動作1221 デフォルト動作

1219</h4>1222</h4>

1220 1223 

1221`settingSources` が省略されるか `undefined` の場合、`query()` は Claude Code CLI と同じファイルシステム設定を読み込みます: ユーザー、プロジェクト、ローカル。[Claude Code 機能を使用](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control) を参照して、入力を無効にする方法を確認してください。1224`settingSources` が省略されるか `undefined` の場合、`query()` は Claude Code CLI と同じファイルシステム設定を読み込みます: ユーザー、プロジェクト、ローカル。[settingSources が制御しないもの](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control)を参照して、関係なく読み込まれる入力と、それらを無効にする方法を確認してください。

1222 1225 

1223<h4 id="why-use-settingsources">1226<h4 id="why-use-settingsources">

1224 settingSources を使用する理由1227 settingSources を使用する理由

1250});1253});

1251```1254```

1252 1255 

1253CLAUDE.md プロジェクト指示を読み込むには、`settingSources` に `"project"` を含めてください。CLAUDE.md 読み込みがシステムプロンプトオプションとどのように相互作用するかについては、[システムプロンプトを変更](/docs/ja/agent-sdk/modifying-system-prompts#claude-md-files-for-project-level-instructions) を参照してください。1256CLAUDE.md プロジェクト指示を読み込むには、`settingSources` に `"project"` を含めます。CLAUDE.md 読み込みがシステムプロンプトオプションとどのように相互作用するかについては、[システムプロンプトを変更](/docs/ja/agent-sdk/modifying-system-prompts#claude-md-files-for-project-level-instructions)を参照してください。

1254 1257 

1255<h4 id="settings-precedence">1258<h4 id="settings-precedence">

1256 設定優先順位1259 設定優先順位

1273 | "default" // 標準権限動作1276 | "default" // 標準権限動作

1274 | "acceptEdits" // ファイル編集を自動受け入れ1277 | "acceptEdits" // ファイル編集を自動受け入れ

1275 | "bypassPermissions" // 権限チェックをバイパス。明示的な質問ルールはプロンプトを表示1278 | "bypassPermissions" // 権限チェックをバイパス。明示的な質問ルールはプロンプトを表示

1276 | "plan" // 計画モード - 編集なしで探索1279 | "plan" // プランニングモード - 編集なしで探索

1277 | "dontAsk" // 権限をプロンプトしない、事前承認されていない場合は拒否1280 | "dontAsk" // 権限をプロンプトしない、事前承認されていない場合は拒否

1278 | "auto"; // モデル分類器が権限プロンプトを承認または拒否1281 | "auto"; // モデル分類器がシェルコマンドやネットワークリクエストなどのアクションをレビュー

1279```1282```

1280 1283 

1281<h3 id="canusetool">1284<h3 id="canusetool">

1284 1287 

1285ツール使用を制御するためのカスタム権限関数型。1288ツール使用を制御するためのカスタム権限関数型。

1286 1289 

1287関数は対話型権限プロンプトの SDK 置き換えです: [権限評価フロー](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated) がプロンプトに解決する場合にのみ呼び出されます。`allowedTools` エントリ、設定許可ルール、または `acceptEdits` や `bypassPermissions` などの権限モードで既に承認されたツール呼び出しは、それを呼び出しません。すべてのツール呼び出しをゲートするには、代わりに [`PreToolUse` フック](/docs/ja/agent-sdk/hooks) を使用してください。1290関数は対話型権限プロンプトの SDK 置き換えです。[権限評価フロー](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)がプロンプトに解決する場合にのみ呼び出されます。`allowedTools` エントリ、設定許可ルール、または `acceptEdits` や `bypassPermissions` などの権限モードで既に承認されたツール呼び出しは、それを呼び出しません。すべてのツール呼び出しをゲートするには、代わりに [`PreToolUse` フック](/docs/ja/agent-sdk/hooks)を使用します。

1288 1291 

1289許可ルールは [どのモードも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves) を事前承認しません。[権限がどのように評価されるか](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated) を参照して、どれがコールバックに到達し、`dontAsk` および `auto` モードで何が起こるかを確認してください。1292許可ルールは [どのモードも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認しません。[権限がどのように評価されるか](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)を参照して、どれがコールバックに到達し、`dontAsk` および `auto` モードで何が起こるかを確認してください。

1290 1293 

1291```typescript theme={null}1294```typescript theme={null}

1292type CanUseTool = (1295type CanUseTool = (

1309 1312 

1310| オプション | 型 | 説明 |1313| オプション | 型 | 説明 |

1311| :- | :- | :- |1314| :- | :- | :- |

1312| `signal` | `AbortSignal` | 操作を中止する必要がある場合にシグナルされます |1315| `signal` | `AbortSignal` | 操作を中止する場合に通知されます |

1313| `suggestions` | [`PermissionUpdate`](#permissionupdate)`[]` | 提案された権限更新。ユーザーがこのツールに対して再度プロンプトされないようにします。Bash プロンプトは `localSettings` [宛先](#permissionupdatedestination) を含む提案を含むため、`updatedPermissions` で返すと、ルールを `.claude/settings.local.json` に書き込み、セッション間で永続化します。 |1316| `suggestions` | [`PermissionUpdate`](#permissionupdate)`[]` | 提案された権限更新。ユーザーがこのツールに対して再度プロンプトされないようにします。Bash プロンプトには `localSettings` [宛先](#permissionupdatedestination)を含む提案が含まれるため、`updatedPermissions` で返すと、ルールを `.claude/settings.local.json` に書き込み、セッション全体で永続化します。 |

1314| `blockedPath` | `string` | 権限リクエストをトリガーしたファイルパス（該当する場合） |1317| `blockedPath` | `string` | 権限リクエストをトリガーしたファイルパス（該当する場合） |

1315| `mcpServer` | `{ name: string; source: string }` | `mcp__*` ツールの場合、それを提供する MCP サーバーおよびそのサーバーの定義がどこから来たか。[`McpServerProvenance`](#mcpserverprovenance) のフィールド。他のツールの場合は存在しません。Agent SDK v0.3.274 以降が必要です |1318| `mcpServer` | `{ name: string; source: string }` | `mcp__*` ツールの場合、それを提供する MCP サーバーとそのサーバーの定義がどこから来たか。[`McpServerProvenance`](#mcpserverprovenance)のフィールド。他のツールでは不在です。Agent SDK v0.3.274 以降が必要です |

1316| `decisionReason` | `string` | この権限リクエストがトリガーされた理由を説明します |1319| `decisionReason` | `string` | この権限リクエストがトリガーされた理由を説明します |

1317| `defaultToNo` | `boolean` | ` true` の場合、単一の迷い込んだキーストロークがこのリクエストを承認してはいけません: プロンプトを拒否オプションで開き、承認を事前選択しないでください。ワンキー承認ショートカットを提供しないでください。Agent SDK v0.3.268 以降が必要です |1320| `defaultToNo` | `boolean` | `true` の場合、単一の迷走キーストロークがこのリクエストを承認してはいけません: プロンプトを拒否オプションで開き、承認を事前選択しないでください。1 キー承認ショートカットを提供しないでください。Agent SDK v0.3.268 以降が必要です |

1318| `suppressAlwaysAllowRule` | `boolean` | ` true` の場合、このリクエストの永続的な常時許可選択肢を提供しないでください。書き込むルールはリクエスト自体のアクションより多くを許可するためです。Agent SDK v0.3.268 以降が必要です |1321| `suppressAlwaysAllowRule` | `boolean` | `true` の場合、このリクエストに対して永続的な常時許可選択肢を提供しないでください。書き込むルールはリクエスト自体のアクションより多くを許可するためです。Agent SDK v0.3.268 以降が必要です |

1319| `toolUseID` | `string` | アシスタントメッセージ内のこの特定のツール呼び出しの一意の識別子 |1322| `toolUseID` | `string` | アシスタントメッセージ内のこの特定のツール呼び出しの一意の識別子 |

1320| `agentID` | `string` | サブエージェント内で実行している場合、サブエージェントの ID |1323| `agentID` | `string` | サブエージェント内で実行している場合、サブエージェントの ID |

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

1322 1325 

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

1324 1327 

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

1326 1329 

1362 1365 

1363| フィールド | 型 | 説明 |1366| フィールド | 型 | 説明 |

1364| :- | :- | :- |1367| :- | :- | :- |

1365| `askUserQuestion.previewFormat` | `'markdown' \| 'html'` | [`AskUserQuestion`](/docs/ja/agent-sdk/user-input#question-format) オプションの `preview` フィールドをオプトインし、そのコンテンツ形式を設定します。設定されていない場合、Claude はプレビューを出力しません |1368| `askUserQuestion.previewFormat` | `'markdown' \| 'html'` | [`AskUserQuestion`](/docs/ja/agent-sdk/user-input#question-format)オプションの `preview` フィールドをオプトインし、そのコンテンツ形式を設定します。設定されていない場合、Claude はプレビューを出力しません |

1366 1369 

1367<h3 id="mcpserverconfig">1370<h3 id="mcpserverconfig">

1368 `McpServerConfig`1371 `McpServerConfig`

1456 1459 

1457| フィールド | 型 | 説明 |1460| フィールド | 型 | 説明 |

1458| :- | :- | :- |1461| :- | :- | :- |

1459| `type` | `'local'` | `'local'` である必要があります（現在ローカルプラグインのみサポート） |1462| `type` | `'local'` | `'local'` である必要があります（現在ローカルプラグインのみがサポートされています） |

1460| `path` | `string` | プラグインディレクトリへの絶対パスまたは相対パス |1463| `path` | `string` | プラグインディレクトリへの絶対パスまたは相対パス |

1461| `skipMcpDiscovery` | `boolean` | `true` の場合、SDK はこのプラグインからスキル、フック、エージェント、コマンドを読み込みますが、その `.mcp.json` またはマニフェスト `mcpServers` は読み込みません。アプリケーションがプラグインの MCP 接続を所有している場合に設定します。 |1464| `skipMcpDiscovery` | `boolean` | `true` の場合、SDK はこのプラグインからスキル、フック、エージェント、コマンドを読み込みますが、その `.mcp.json` またはマニフェスト `mcpServers` は読み込みません。アプリケーションがプラグインの MCP 接続を所有している場合に設定します。 |

1462 1465 

1469];1472];

1470```1473```

1471 1474 

1472プラグインの作成と使用の完全な情報については、[プラグイン](/docs/ja/agent-sdk/plugins) を参照してください。1475プラグインの作成と使用に関する完全な情報については、[プラグイン](/docs/ja/agent-sdk/plugins)を参照してください。

1473 1476 

1474<h2 id="message-types">1477<h2 id="message-types">

1475 メッセージタイプ1478 メッセージタイプ

1544};1547};

1545```1548```

1546 1549 

1547`message` フィールドは Anthropic SDK の [`BetaMessage`](https://platform.claude.com/docs/en/api/messages/create) です。`id`、`content`、`model`、`stop_reason`、`usage` などのフィールドが含まれます。1550`message` フィールドは Anthropic SDK の [`BetaMessage`](https://platform.claude.com/docs/ja/api/messages/create) です。`id`、`content`、`model`、`stop_reason`、`usage` などのフィールドが含まれます。

1548 1551 

1549`SDKAssistantMessageError` は以下のいずれかです：`'authentication_failed'`、`'oauth_org_not_allowed'`、`'account_on_hold'`、`'billing_error'`、`'rate_limit'`、`'overloaded'`、`'invalid_request'`、`'model_not_found'`、`'server_error'`、`'max_output_tokens'`、`'cloud_credential_error'`、または `'unknown'`。これらの値のうち 4 つは名前以上の意味を持ちます：1552`SDKAssistantMessageError` は以下のいずれかです：`'authentication_failed'`、`'oauth_org_not_allowed'`、`'account_on_hold'`、`'billing_error'`、`'rate_limit'`、`'overloaded'`、`'invalid_request'`、`'model_not_found'`、`'server_error'`、`'max_output_tokens'`、`'cloud_credential_error'`、または `'unknown'`。これらの値のうち 4 つは名前以上の意味を持ちます：

1550 1553 

1555 1558 

1556`aborted` は、割り込みまたは中止がストリーム完了前にアシスタントメッセージを切り詰めた場合に `true` です：メッセージに `stop_reason` がなく、コンテンツが単語の途中で終わる可能性があります。フィールドは正常に完了したメッセージには存在しません。Agent SDK v0.3.214 以降が必要です。1559`aborted` は、割り込みまたは中止がストリーム完了前にアシスタントメッセージを切り詰めた場合に `true` です：メッセージに `stop_reason` がなく、コンテンツが単語の途中で終わる可能性があります。フィールドは正常に完了したメッセージには存在しません。Agent SDK v0.3.214 以降が必要です。

1557 1560 

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

1559 1562 

1560`timestamp` は、メッセージのコンテンツがそれを生成したプロセスで生成を完了した ISO 8601 時刻です。値はそのマシンのクロックから取得されるため、表示用にのみ使用し、メッセージを順序付けるために使用しないでください。1 つの API ターンは、同じ `message.id` を共有する複数のアシスタントメッセージを生成でき、それぞれが独自の `timestamp` を持ちます。フィールドが存在しない場合は、メッセージを受け取った時刻にフォールバックしてください。1563`timestamp` は、メッセージのコンテンツがそれを生成したプロセスで生成を完了した ISO 8601 時刻です。値はそのマシンのクロックから来ているため、表示用にのみ使用し、メッセージを順序付けないでください。1 つの API ターンは、同じ `message.id` を共有する複数のアシスタントメッセージを生成でき、それぞれが独自の `timestamp` を持ちます。フィールドが存在しない場合は、メッセージを受け取った時刻にフォールバックしてください。

1561 1564 

1562`context_usage` は `/context` レポートの構造化コピーで、[`SDKContextUsage`](#sdkcontextusage) として型付けされており、Agent SDK v0.3.232 以降が必要です。プロンプトとして `/context` を送信すると、Claude Code はレポートをアシスタントメッセージとして配信し、その `message.content` がマークダウンテーブルを保持し、`context_usage` を同じメッセージに添付します。Claude Code はこのフィールドを他のアシスタントメッセージには設定せず、以前のバージョンは `/context` テーブルなしで配信するため、フィールドが存在する場合は分析から読み取り、存在しない場合はマークダウンテキストにフォールバックしてください。1565`context_usage` は `/context` レポートの構造化コピーで、[`SDKContextUsage`](#sdkcontextusage) として型付けされており、Agent SDK v0.3.232 以降が必要です。プロンプトとして `/context` を送信すると、Claude Code はレポートをアシスタントメッセージとして配信し、その `message.content` がマークダウンテーブルを保持し、`context_usage` を同じメッセージに添付します。Claude Code はこのフィールドを他のアシスタントメッセージに設定せず、以前のバージョンは `/context` テーブルなしで配信するため、フィールドが存在する場合は分析を読み取り、存在しない場合はマークダウンテキストにフォールバックしてください。

1563 1566 

1564<h3 id="sdkusermessage">1567<h3 id="sdkusermessage">

1565 `SDKUserMessage`1568 `SDKUserMessage`

1584};1587};

1585```1588```

1586 1589 

1587ユーザーがプロンプト UI に入力したのではなく貼り付けたコンテンツを送信するために `pasted_content` を設定します。1 つのペーストごとに 1 つのエントリ、各エントリは文字列またはコンテンツブロックの配列です。Claude Code は各エントリのテキストを入力されたテキストの後に順番に追加し、各ペーストを `<pasted_content>` タグでラップする場合があります。テキスト以外のブロックは無視されるため、画像とドキュメントは `message.content` で送信してください。Agent SDK v0.3.277 以降が必要です。1590ユーザーがプロンプト UI に貼り付けたコンテンツを送信するには `pasted_content` を設定します。入力ではなく貼り付けたコンテンツを、貼り付けごとに 1 つのエントリで、各エントリは文字列またはコンテンツブロックの配列です。Claude Code は各エントリのテキストを入力されたテキストの後に順番に追加し、各貼り付けを `<pasted_content>` タグでラップする場合があります。テキスト以外のブロックは無視されるため、画像とドキュメントは `message.content` で送信してください。Agent SDK v0.3.277 以降が必要です。

1588 1591 

1589`shouldQuery` または `client_composed` を設定して、Claude Code がメッセージを処理する方法を変更します：1592Claude Code がメッセージを処理する方法を変更するには、`shouldQuery` または `client_composed` を設定します：

1590 1593 

1591* `shouldQuery`：`false` に設定して、アシスタントターンをトリガーせずにメッセージをトランスクリプトに追加します。メッセージは保持され、ターンをトリガーする次のユーザーメッセージにマージされます。これを使用して、バンド外で実行したコマンドの出力などのコンテキストを注入し、モデル呼び出しを費やさないようにします。1594* `shouldQuery`：アシスタントターンをトリガーせずにメッセージをトランスクリプトに追加するには `false` に設定します。メッセージは保持され、ターンをトリガーする次のユーザーメッセージにマージされます。ターンをトリガーせずにコンテキスト（実行したコマンドの出力など）を挿入するために使用します。

1592* `client_composed`：`true` に設定して、Claude Code がメッセージテキストを書かれたとおりに配信するようにします。Claude Code は `@path` または [`@server:resource`](/docs/ja/mcp#use-mcp-resources) メンションを展開せず、`/` で始まるテキストをコマンドとして実行しません。[`verbatimPrompts`](#options) オプションがオンの場合、SDK はすべてのメッセージにフィールドを設定します。TypeScript Agent SDK v0.3.280 以降と Claude Code v2.1.248 以降が必要です。1595* `client_composed`：Claude Code がメッセージテキストを書かれたとおりに配信するには `true` に設定します。Claude Code は `@path` または [`@server:resource`](/docs/ja/mcp#use-mcp-resources) メンションを展開せず、`/` で始まるテキストをコマンドとして実行しません。[`verbatimPrompts`](#options) オプションがオンの場合、SDK はすべてのメッセージでフィールドを設定します。TypeScript Agent SDK v0.3.280 以降と Claude Code v2.1.248 以降が必要です。

1593 1596 

1594`tool_result` ブロックを含むメッセージでは、`tool_use_result` はモデルに送信されたテキストではなく、ツールの構造化出力オブジェクトです。その形状は一致する `tool_use` ブロックで指定されたツールに依存するため、フィールドは `unknown` として型付けされます。組み込み形状は [ツール出力タイプ](#tool-output-types) の下にリストされています。1597`tool_result` ブロックを持つメッセージでは、`tool_use_result` はモデルに送信されたテキストではなく、ツールの構造化出力オブジェクトです。その形状は一致する `tool_use` ブロックで指定されたツールに依存するため、フィールドは `unknown` として型付けされます。組み込み形状は [ツール出力タイプ](#tool-output-types) の下にリストされています。

1595 1598 

1596`Agent` ツールの場合、`tool_use_result` は [`AgentOutput`](#agent-2) です。`completed` 結果では、`content` は Claude Code がテキスト `tool_result` に追加するエージェント ID と使用状況トレーラーなしでサブエージェントのレポートを保持するため、そのテキストを解析する代わりに `tool_use_result` からレンダリングしてください。1599`Agent` ツールの場合、`tool_use_result` は [`AgentOutput`](#agent-2) です。`completed` 結果では、`content` はサブエージェントのレポートを保持し、Claude Code が `tool_result` テキストに追加するエージェント ID と使用状況トレーラーは含みません。そのため、そのテキストを解析する代わりに `tool_use_result` からレンダリングしてください。

1597 1600 

1598結果に `resource_link` ブロックが含まれる MCP ツールの場合、`tool_use_result` は [`SDKMcpResourceLink`](#sdkmcpresourcelink) エントリの `resourceLinks` 配列を持つオブジェクトです。Claude は各リンクを `tool_result` ブロック内のテキスト行として受け取るため、そのテキストを解析する代わりに `resourceLinks` を読み取ってサーバーが返したファイルをレンダリングしてください。Claude Code は結果にリンクがない場合と結果がサブエージェントからの場合は `resourceLinks` を省略し、結果ごとに最大 50 個のリンクを保持し、配列が 64 KiB のシリアル化 JSON に達すると、リンクの追加を停止します。`resourceLinks` には Agent SDK v0.3.257 以降が必要です。1601結果に `resource_link` ブロックを含む MCP ツールの場合、`tool_use_result` は [`SDKMcpResourceLink`](#sdkmcpresourcelink) エントリの `resourceLinks` 配列を持つオブジェクトです。Claude は各リンクを `tool_result` ブロック内のテキスト行として受け取るため、そのテキストを解析する代わりに `resourceLinks` を読み取り、サーバーが返したファイルをレンダリングしてください。Claude Code は結果にリンクがない場合と、サブエージェントからの結果で `resourceLinks` を省略し、結果ごとに最大 50 リンクを保持し、配列が 64 KiB のシリアル化 JSON に達するとリンクの追加を停止します。`resourceLinks` には Agent SDK v0.3.257 以降が必要です。

1599 1602