Documentation 2026-07-15 22:00 UTC to 2026-07-16 22:59 UTC

30 30 

31SSH 経由で Claude Code を使用する場合は、Claude Code が実行されるリモートマシンで環境変数または設定を設定します。31SSH 経由で Claude Code を使用する場合は、Claude Code が実行されるリモートマシンで環境変数または設定を設定します。

32 32 

33モードがオンの場合、Claude Code が最初に出力するのは、それをオンにした方法を名前付けする確認行です。`[Screen Reader Mode: on via flag]`、`[Screen Reader Mode: on via env]`、または `[Screen Reader Mode: on via settings]` です。このメソッド命名形式には Claude Code v2.1.206 以降が必要です。33モードがオンの場合、Claude Code が最初に出力するのは、それをオンにした方法を名前付けする確認行です。`[Screen Reader Mode: on via flag]`、`[Screen Reader Mode: on via env]`、または `[Screen Reader Mode: on via settings]` です。このメソッド命名形式には Claude Code v2.1.206 以降が必要です。Claude Code が自身を再起動する場合（例えば、アップデートのインストールを完了するため）、新しいプロセスは `CLAUDE_AX_SCREEN_READER` 環境変数を通じてモードを継承するため、使用した方法に関係なく、その確認行は `[Screen Reader Mode: on via env]` と表示されます。

34{/* max-version: 2.1.205 */}以前のバージョンは `[Accessible screen reader mode: on]` を出力します。34{/* max-version: 2.1.205 */}以前のバージョンは `[Accessible screen reader mode: on]` を出力します。

35 35 

36<h2 id="turn-off-screen-reader-mode">36<h2 id="turn-off-screen-reader-mode">

95| [Sandboxing](/ja/sandboxing) | ドメイン許可リスト付きの OS レベルのファイルシステムとネットワーク分離 | `sandbox.enabled`、`sandbox.network.allowedDomains` |95| [Sandboxing](/ja/sandboxing) | ドメイン許可リスト付きの OS レベルのファイルシステムとネットワーク分離 | `sandbox.enabled`、`sandbox.network.allowedDomains` |

96| [Managed policy CLAUDE.md](/ja/memory#deploy-organization-wide-claude-md) | すべてのセッションで読み込まれる組織全体の指示。除外できない | マネージドポリシーパスのファイル |96| [Managed policy CLAUDE.md](/ja/memory#deploy-organization-wide-claude-md) | すべてのセッションで読み込まれる組織全体の指示。除外できない | マネージドポリシーパスのファイル |

97| [MCP server control](/ja/managed-mcp) | ユーザーが追加または接続できる MCP サーバーを制限するか、固定セットをデプロイする | `allowedMcpServers`、`deniedMcpServers`、`allowManagedMcpServersOnly`、またはデプロイされた `managed-mcp.json` ファイル |97| [MCP server control](/ja/managed-mcp) | ユーザーが追加または接続できる MCP サーバーを制限するか、固定セットをデプロイする | `allowedMcpServers`、`deniedMcpServers`、`allowManagedMcpServersOnly`、またはデプロイされた `managed-mcp.json` ファイル |

98| [Plugin marketplace control](/ja/plugin-marketplaces#managed-marketplace-restrictions) | ユーザーが追加およびインストールできるマーケットプレイスソースを制限し、単一実行のためにプラグイン、エージェント、MCP サーバーをサイドロードする CLI フラグを拒否する | `strictKnownMarketplaces`、`blockedMarketplaces`、`disableSideloadFlags` |98| [Plugin marketplace control](/ja/plugin-marketplaces#managed-marketplace-restrictions) | ユーザーが追加およびインストールできるマーケットプレイスソースを制限し、単一実行のためにプラグイン、エージェント、MCP サーバーをサイドロードする CLI フラグを拒否し、どのマーケットプレイスのプラグインが提案されるかをホワイトリストに登録する | `strictKnownMarketplaces`、`blockedMarketplaces`、`disableSideloadFlags`、`pluginSuggestionMarketplaces` |

99| [Customization lockdown](/ja/settings#strictpluginonlycustomization) | スキル、エージェント、フック、および MCP サーバーをユーザーおよびプロジェクトソースからブロックし、プラグインまたはマネージド設定からのみ取得できるようにする | `strictPluginOnlyCustomization` |99| [Customization lockdown](/ja/settings#strictpluginonlycustomization) | スキル、エージェント、フック、および MCP サーバーをユーザーおよびプロジェクトソースからブロックし、プラグインまたはマネージド設定からのみ取得できるようにする | `strictPluginOnlyCustomization` |

100| [Hook restrictions](/ja/settings#hook-configuration) | マネージドフックのみが読み込まれる。HTTP フック URL を制限する | `allowManagedHooksOnly`、`allowedHttpHookUrls` |100| [Hook restrictions](/ja/settings#hook-configuration) | マネージドフックのみが読み込まれる。HTTP フック URL を制限する | `allowManagedHooksOnly`、`allowedHttpHookUrls` |

101| [Login enforcement](/ja/settings#available-settings) | インタラクティブログインを特定の方法または Anthropic 組織に制限する。設定されている場合、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` によって認証されたセッションはスタートアップでブロックされます。クラウドプロバイダーセッションは影響を受けません | `forceLoginMethod`、`forceLoginOrgUUID` |

101| [Disable agent view](/ja/agent-view#how-background-sessions-are-hosted) | `claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザーをオフにする | `disableAgentView` |102| [Disable agent view](/ja/agent-view#how-background-sessions-are-hosted) | `claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザーをオフにする | `disableAgentView` |

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

103| [Version floor](/ja/settings) | 自動更新が組織全体の最小値より下にインストールされるのを防ぐ | `minimumVersion` |104| [Version floor](/ja/settings) | 自動更新が組織全体の最小値より下にインストールされるのを防ぐ | `minimumVersion` |

105 106 

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

107 108 

109[Claude Code on the web](/ja/claude-code-on-the-web) には独自の管理サーフェスがあります。管理設定のクラウド環境ページで、オーナーと管理者は、メンバーのクラウドセッションの [network access level](/ja/claude-code-on-the-web#network-access)、環境変数、セットアップスクリプトを設定する [organization-shared environments](/ja/claude-code-on-the-web#organization-shared-environments) を作成し、組織のデフォルト環境を選択します。

110 

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

109 112 

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

116必要なレポート内容に基づいて監視を選択してください。ダッシュボード、API、支出管理は Claude for Teams または Enterprise プランと Claude Console 組織で異なるため、機能に基づいてレポートを計画する前に「利用可能性」列を確認してください。119必要なレポート内容に基づいて監視を選択してください。ダッシュボード、API、支出管理は Claude for Teams または Enterprise プランと Claude Console 組織で異なるため、機能に基づいてレポートを計画する前に「利用可能性」列を確認してください。

117 120 

118| 機能 | 取得内容 | 利用可能性 | 開始場所 |121| 機能 | 取得内容 | 利用可能性 | 開始場所 |

119| :--------------------- | :----------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------- |122| :--------------------- | :----------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------- |

120| Usage monitoring | セッション、ツール、トークンの OpenTelemetry エクスポート | すべてのプロバイダー | [Monitoring usage](/ja/monitoring-usage) |123| Usage monitoring | セッション、ツール、トークンの OpenTelemetry エクスポート | すべてのプロバイダー | [Monitoring usage](/ja/monitoring-usage) |

121| Analytics dashboard | Teams / Enterprise でのリーダーボード付き採用度と貢献度メトリクス、Console でのユーザーごとの使用状況と支出メトリクス | Teams / Enterprise は [claude.ai/analytics](https://claude.ai/analytics/claude-code)、Console は [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | [Analytics](/ja/analytics) |124| Analytics dashboard | Teams / Enterprise でのリーダーボード付き採用度と貢献度メトリクス、Console でのユーザーごとの使用状況と支出メトリクス | Teams / Enterprise は [claude.ai/analytics](https://claude.ai/analytics/claude-code)、Console は [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | [Analytics](/ja/analytics) |

122| Programmatic reporting | API を通じたユーザーごとの使用状況とコストデータ | Enterprise 向け [Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide)、Console 向け [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) | [Costs](/ja/costs#manage-costs-for-your-organization) |125| Programmatic reporting | API を通じたユーザーごとの使用状況とコストデータ | Enterprise 向け [Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics)、Console 向け [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) | [Costs](/ja/costs#manage-costs-for-your-organization) |

123| Spend controls | 支出制限とレート制限 | Teams / Enterprise の管理者設定、Console のワークスペース制限、サードパーティクラウドではクラウド予算管理またはユーザーごとの [支出制限](/ja/claude-apps-gateway-spend-limits) を備えた [Claude apps gateway](/ja/claude-apps-gateway) | [Costs](/ja/costs#manage-costs-for-your-organization) |126| Spend controls | 支出制限とレート制限 | Teams / Enterprise の管理者設定、Console のワークスペース制限、サードパーティクラウドではクラウド予算管理またはユーザーごとの [支出制限](/ja/claude-apps-gateway-spend-limits) を備えた [Claude apps gateway](/ja/claude-apps-gateway) | [Costs](/ja/costs#manage-costs-for-your-organization) |

124 127 

125Teams および Enterprise では、ユーザーごとの使用状況と支出の数値は分析ダッシュボードではなく、組織の分析設定の [支出レポート](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) から取得されます。クラウドプロバイダーは AWS Cost Explorer、GCP Billing、または Azure Cost Management を通じて支出を公開します。Claude チャット、Claude Code、Cowork 全体にわたるエンタープライズ予算計画については、[Claude Enterprise 消費ガイド](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide) を参照してください。128Teams および Enterprise では、ユーザーごとの使用状況と支出の数値は分析ダッシュボードではなく、組織の分析設定の [支出レポート](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) から取得されます。クラウドプロバイダーは AWS Cost Explorer、GCP Billing、または Azure Cost Management を通じて支出を公開します。Claude チャット、Claude Code、Cowork 全体にわたるエンタープライズ予算計画については、[Claude Enterprise 消費ガイド](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide) を参照してください。

7> メインモデルをより強力な advisor モデルと組み合わせて、タスク中の重要な瞬間に Claude が相談できるようにします。7> メインモデルをより強力な advisor モデルと組み合わせて、タスク中の重要な瞬間に Claude が相談できるようにします。

8 8 

9<Note>9<Note>

10 advisor ツールは実験的機能であり、Anthropic API が必要です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では利用できません。動作、価格設定、および利用可能性は変更される可能性があります。10 advisor ツールは実験的機能であり、Anthropic API が必要です。Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry では利用できません。動作、価格設定、および利用可能性は変更される可能性があります。

11</Note>11</Note>

12 12 

13advisor ツールを使用すると、Claude はタスク中の重要な瞬間（アプローチをコミットする前、繰り返し発生するエラーで行き詰まった場合、またはタスク完了を宣言する前など）に、通常はより強力な 2 番目のモデルに相談できます。advisor は、すべてのツール呼び出しと結果を含む完全な会話を受け取り、Claude が続行する前に適用するガイダンスを返します。13advisor ツールを使用すると、Claude はタスク中の重要な瞬間（アプローチをコミットする前、繰り返し発生するエラーで行き詰まった場合、またはタスク完了を宣言する前など）に、通常はより強力な 2 番目のモデルに相談できます。advisor は、すべてのツール呼び出しと結果を含む完全な会話を受け取り、Claude が続行する前に適用するガイダンスを返します。

159 159 

160advisor ツールには、以下のすべてが必要です。160advisor ツールには、以下のすべてが必要です。

161 161 

162* **Anthropic API のみ**：advisor はサーバー実行ツールです。Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。[LLM ゲートウェイ](/ja/llm-gateway)を通じて `ANTHROPIC_BASE_URL` で構成されている場合、利用可能性はゲートウェイがリクエストを Anthropic API に完全に転送するかどうかに依存します。162* **Anthropic API のみ**：advisor はサーバー実行ツールです。Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。[LLM ゲートウェイ](/ja/llm-gateway)を通じて `ANTHROPIC_BASE_URL` で構成されている場合、利用可能性はゲートウェイがリクエストを Anthropic API に完全に転送するかどうかに依存します。

163* **サポートされているメインモデル**：Opus 4.6 以降、Sonnet 4.6 以降、または Haiku 4.5。{/* min-version: 2.1.170 */}Fable 5 も Claude Code v2.1.170 以降で適格です。163* **サポートされているメインモデル**：Opus 4.6 以降、Sonnet 4.6 以降、または Haiku 4.5。{/* min-version: 2.1.170 */}Fable 5 も Claude Code v2.1.170 以降で適格です。

164 164 

165<h2 id="turn-the-advisor-off">165<h2 id="turn-the-advisor-off">

55 55 

56* **`SystemMessage`：** セッションライフサイクルイベント。`subtype` フィールドはそれらを区別します。56* **`SystemMessage`：** セッションライフサイクルイベント。`subtype` フィールドはそれらを区別します。

57 57 

58 * `"init"`：セッションメタデータを含む最初のメッセージ58 * `"init"`：実行のセッションメタデータ。セッション起動中に `SessionStart` または `Setup` フックが実行される場合、その[フックライフサイクルメッセージ](/ja/agent-sdk/typescript#sdkhookstartedmessage)は `init` メッセージの前に到着します

59 * `"compact_boundary"`：[圧縮](#automatic-compaction)後に発火します59 * `"compact_boundary"`：[圧縮](#automatic-compaction)後に発火します

60 * `"informational"`：ループからのプレーンテキストステータスバナー60 * `"informational"`：ループからのプレーンテキストステータスバナー

61 * `"worker_shutting_down"`：ホストが終了しているか Remote Control が切断されたため、現在のターン後にループが終了します61 * `"worker_shutting_down"`：ホストが終了しているか Remote Control が切断されたため、現在のターン後にループが終了します

233権限モードオプション（Python では `permission_mode`、TypeScript では `permissionMode`）は、エージェントがツールを使用する前に承認を求めるかどうかを制御します。233権限モードオプション（Python では `permission_mode`、TypeScript では `permissionMode`）は、エージェントがツールを使用する前に承認を求めるかどうかを制御します。

234 234 

235| モード | 動作 |235| モード | 動作 |

236| :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |236| :-------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

237| `"default"` | 許可ルールでカバーされていないツールは承認コールバックをトリガーします。コールバックがない場合は拒否 |237| `"default"` | 許可ルールでカバーされていないツールは承認コールバックをトリガーします。コールバックがない場合は拒否 |

238| `"acceptEdits"` | ファイル編集と一般的なファイルシステムコマンド（`mkdir`、`touch`、`mv`、`cp` など）を自動承認します。他の Bash コマンドはデフォルトルールに従います |238| `"acceptEdits"` | ファイル編集と一般的なファイルシステムコマンド（`mkdir`、`touch`、`mv`、`cp` など）を自動承認します。他の Bash コマンドはデフォルトルールに従います |

239| `"plan"` | Claude はソースファイルを編集せずに探索して計画を作成します。ファイル編集は自動承認されず、`canUseTool` コールバックを通じてプロンプトされます |239| `"plan"` | Claude はソースファイルを編集せずに探索して計画を作成します。ファイル編集は自動承認されず、`canUseTool` コールバックを通じてプロンプトされます |

240| `"dontAsk"` | プロンプトしません。[権限ルール](/ja/settings#permission-settings)によって事前承認されたツールが実行され、その他はすべて拒否されます |240| `"dontAsk"` | プロンプトしません。[権限ルール](/ja/settings#permission-settings)によって事前承認されたツールが実行され、その他はすべて拒否されます。`AskUserQuestion`、組織が[`ask` に設定](/ja/mcp#organization-controls-on-connector-tools)したコネクタツール、および[`requiresUserInteraction`](/ja/mcp#require-approval-for-a-specific-tool)とマークされた MCP ツールは、許可していても拒否されます |

241| `"auto"` | モデル分類器を使用して各ツール呼び出しを承認または拒否します。利用可能性と動作については、[自動モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)を参照してください |241| `"auto"` | モデル分類器を使用して各ツール呼び出しを承認または拒否します。利用可能性と動作については、[自動モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)を参照してください |

242| `"bypassPermissions"` | 明示的な[`ask` ルール](/ja/settings#permission-settings)に一致しない限り、尋ねずにすべての許可されたツールを実行します。権限がどのように評価されるかについては、[権限の評価方法](/ja/agent-sdk/permissions#how-permissions-are-evaluated)を参照してください。Unix でルートとして実行する場合は使用できません。エージェントのアクションが気にするシステムに影響を与えられない隔離環境でのみ使用します |242| `"bypassPermissions"` | 明示的な[`ask` ルール](/ja/settings#permission-settings)に一致するツール、組織が[`ask` に設定](/ja/mcp#organization-controls-on-connector-tools)したコネクタツール、およびユーザーインタラクションが必要なツールを除き、尋ねずにすべての許可されたツールを実行します。権限がどのように評価されるかについては、[権限の評価方法](/ja/agent-sdk/permissions#how-permissions-are-evaluated)を参照してください。Unix でルートとして実行する場合は使用できません。エージェントのアクションが気にするシステムに影響を与えられない隔離環境でのみ使用します |

243 243 

244インタラクティブアプリケーションの場合は、ツール承認コールバックで `"default"` を使用して承認プロンプトを表示します。開発マシン上の自律型エージェントの場合は、`"acceptEdits"` を使用してファイル編集と一般的なファイルシステムコマンド（`mkdir`、`touch`、`mv`、`cp` など）を自動承認しながら、他の `Bash` コマンドを許可ルールの背後にゲートします。CI、コンテナ、またはその他の隔離環境に対して `"bypassPermissions"` を予約します。詳細については、[権限](/ja/agent-sdk/permissions)を参照してください。244インタラクティブアプリケーションの場合は、ツール承認コールバックで `"default"` を使用して承認プロンプトを表示します。開発マシン上の自律型エージェントの場合は、`"acceptEdits"` を使用してファイル編集と一般的なファイルシステムコマンド（`mkdir`、`touch`、`mv`、`cp` など）を自動承認しながら、他の `Bash` コマンドを許可ルールの背後にゲートします。CI、コンテナ、またはその他の隔離環境に対して `"bypassPermissions"` を予約します。詳細については、[権限](/ja/agent-sdk/permissions)を参照してください。

245 245 

486* **エージェントが何をできるかについてより厳密な制御が必要ですか？** [権限](/ja/agent-sdk/permissions)でツールアクセスをロックダウンし、[フック](/ja/agent-sdk/hooks)を使用して、実行前にツール呼び出しを監査、ブロック、または変換します。486* **エージェントが何をできるかについてより厳密な制御が必要ですか？** [権限](/ja/agent-sdk/permissions)でツールアクセスをロックダウンし、[フック](/ja/agent-sdk/hooks)を使用して、実行前にツール呼び出しを監査、ブロック、または変換します。

487* **長時間または高コストのタスクを実行していますか？** 隔離された作業を[サブエージェント](/ja/agent-sdk/subagents)にオフロードして、メインコンテキストをリーンに保ちます。487* **長時間または高コストのタスクを実行していますか？** 隔離された作業を[サブエージェント](/ja/agent-sdk/subagents)にオフロードして、メインコンテキストをリーンに保ちます。

488 488 

489agentic ループのより広い概念的な図（SDK 固有ではない）については、[Claude Code の仕組み](/ja/how-claude-code-works)を参照してください。489agentic ループのより広い概念的な図（SDK 固有ではない）については、[Claude Code の仕組み](/ja/how-claude-code-works)を参照してください。Claude Code でループを設計するための実践的なガイド（ターンベースループからゴールベースループおよびプロアクティブループまで）については、ブログの[ループエンジニアリング：ループの開始](/ja/blog/getting-started-with-loops)を参照してください。

57 57 

58結果メッセージ（[TypeScript](/ja/agent-sdk/typescript#sdkresultmessage)、[Python](/ja/agent-sdk/python#resultmessage)）は、`query()` 呼び出しのエージェントループの終了をマークします。これには `total_cost_usd` が含まれており、その呼び出し内のすべてのステップにわたる累積推定コストです。これは成功とエラー結果の両方で機能します。セッションを使用して複数の `query()` 呼び出しを行う場合、各結果はその個別の呼び出しのコストのみを反映します。58結果メッセージ（[TypeScript](/ja/agent-sdk/typescript#sdkresultmessage)、[Python](/ja/agent-sdk/python#resultmessage)）は、`query()` 呼び出しのエージェントループの終了をマークします。これには `total_cost_usd` が含まれており、その呼び出し内のすべてのステップにわたる累積推定コストです。これは成功とエラー結果の両方で機能します。セッションを使用して複数の `query()` 呼び出しを行う場合、各結果はその個別の呼び出しのコストのみを反映します。

59 59 

603 つの結果レベルのフィールドは、エージェントが[サブエージェント](/ja/agent-sdk/subagents)を生成する場合に何をカウントするかが異なります。ツリー全体のトークンアカウンティングには `modelUsage` または Python の `model_usage` を使用してください。`usage` フィールドはネストが発生するとすぐに過小カウントされます。

61 

62| フィールド | サブエージェントアクティビティ |

63| ---------------------------- | ---------------------------------------------------------- |

64| `usage` | 除外。トップレベルのエージェントループのみをカウントするため、サブエージェント内で消費されたトークンは追加されません |

65| `total_cost_usd` | 含まれます。トップレベルループと並行してサブエージェントリクエストをカウントします |

66| `modelUsage` / `model_usage` | 含まれます。トップレベルループと並行してサブエージェントリクエストをカウントし、モデル別に分類されます |

67 

60次の例は、`query()` 呼び出しからのメッセージストリームを反復処理し、`result` メッセージが到着したときに総コストを出力します。68次の例は、`query()` 呼び出しからのメッセージストリームを反復処理し、`result` メッセージが到着したときに総コストを出力します。

61 69 

62<CodeGroup>70<CodeGroup>

149SDK はエージェント実行のさまざまなステージのフックを提供します。一部のフックは両方の SDK で利用可能ですが、その他は TypeScript のみです。149SDK はエージェント実行のさまざまなステージのフックを提供します。一部のフックは両方の SDK で利用可能ですが、その他は TypeScript のみです。

150 150 

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

152| -------------------- | ---------- | -------------- | --------------------------------------------------- | ---------------------------------------- |152| ------------------------------------------------------ | ---------- | -------------- | --------------------------------------------------- | ------------------------------------------- |

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

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

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

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

157| `UserPromptSubmit` | はい | はい | ユーザープロンプト送信 | プロンプトに追加のコンテキストを注入する |157| `UserPromptSubmit` | はい | はい | ユーザープロンプト送信 | プロンプトに追加のコンテキストを注入する |

158| [`UserPromptExpansion`](/ja/hooks#userpromptexpansion) | いいえ | はい | ユーザーが入力したコマンドが Claude に到達する前にプロンプトに展開される | コマンドの直接呼び出しをブロックするか、スキルが入力されたときにコンテキストを追加する |

158| `MessageDisplay` | いいえ | はい | テキスト付きのアシスタントメッセージが完了する。メッセージごとに 1 回、完全なメッセージテキスト付き | 表示されたテキストを編集または再フォーマットする（トランスクリプトは変更しない） |159| `MessageDisplay` | いいえ | はい | テキスト付きのアシスタントメッセージが完了する。メッセージごとに 1 回、完全なメッセージテキスト付き | 表示されたテキストを編集または再フォーマットする（トランスクリプトは変更しない） |

159| `Stop` | はい | はい | エージェント実行停止 | 終了前にセッション状態を保存する |160| `Stop` | はい | はい | エージェント実行停止 | 終了前にセッション状態を保存する |

160| `SubagentStart` | はい | はい | サブエージェント初期化 | 並列タスク生成を追跡する |161| `SubagentStart` | はい | はい | サブエージェント初期化 | 並列タスク生成を追跡する |

817* `HookMatcher` 設定で `timeout` 値を増やします818* `HookMatcher` 設定で `timeout` 値を増やします

818* TypeScript で 3 番目のコールバック引数から `AbortSignal` を使用して、キャンセルを適切に処理します819* TypeScript で 3 番目のコールバック引数から `AbortSignal` を使用して、キャンセルを適切に処理します

819 820 

821{/* min-version: 2.1.208 */}`UserPromptSubmit` または [`UserPromptExpansion`](/ja/hooks#userpromptexpansion) コールバックがタイムアウトを超過した場合、そのプロンプトはタイムアウトメッセージでブロックされ、セッションは続行されます。クエリを中断すると、保留中のツール呼び出しがキャンセルされます。v2.1.208 より前では、これらのイベントのコールバックタイムアウトはクエリを `error_during_execution` で終了し、保留中の `PreToolUse` コールバック中の中断はツール呼び出しを続行させる可能性がありました。

822 

820<h3 id="tool-blocked-unexpectedly">823<h3 id="tool-blocked-unexpectedly">

821 ツールが予期せずブロックされた824 ツールが予期せずブロックされた

822</h3>825</h3>

831* エージェントを開始する前にサーバーをプリウォーミングする831* エージェントを開始する前にサーバーをプリウォーミングする

832* 遅い初期化の原因についてサーバーログを確認する832* 遅い初期化の原因についてサーバーログを確認する

833 833 

834<h3 id="tool-output-exceeds-maximum-allowed-tokens">

835 ツール出力が許可される最大トークン数を超える

836</h3>

837 

838SDK は Claude Code と同じ MCP 出力制限を適用します。ツール結果が 25,000 トークンより大きい場合、完全な出力はファイルに保存され、ツール結果はファイルパスを名前に含むエラーメッセージに置き換えられるため、エージェントは出力を部分的に読み戻すことができます。[`MAX_MCP_OUTPUT_TOKENS`](/ja/env-vars) 環境変数でリミットを上げてください。サーバーがツールごとにより高いリミットを宣言する方法を含む完全な動作については、[MCP 出力制限と警告](/ja/mcp#mcp-output-limits-and-warnings)を参照してください。

839 

834<h2 id="related-resources">840<h2 id="related-resources">

835 関連リソース841 関連リソース

836</h2>842</h2>

6 6 

7> Claude Code をライブラリとして使用して、本番環境対応の AI エージェントを構築します7> Claude Code をライブラリとして使用して、本番環境対応の AI エージェントを構築します

8 8 

9ファイルを自動的に読み取り、コマンドを実行し、ウェブを検索し、コードを編集するなど、さらに多くのことができる AI エージェントを構築します。Agent SDK は、Claude Code を強化する同じツール、エージェントループ、およびコンテキスト管理を提供し、Python と TypeScript でプログラム可能です。9ファイルを自動的に読み取り、コマンドを実行し、ウェブを検索し、コードを編集するなど、さらに多くのことができる AI エージェントを構築します。Agent SDK は、Claude Code を強化する同じツール、エージェントループ、およびコンテキスト管理を提供し、Python と TypeScript でプログラム可能です。エージェントハーネス設計の背景については、ブログの「[A harness for every task: dynamic workflows in Claude Code](https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code)」を参照してください。

10 10 

11<CodeGroup>11<CodeGroup>

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

31 [settings.json](/ja/settings#permission-settings)から `ask` ルールをチェックします。質問ルールが一致する場合、`bypassPermissions` モードでも、コールは確認のために[`canUseTool` コールバック](/ja/agent-sdk/user-input)にフォールスルーします。31 [settings.json](/ja/settings#permission-settings)から `ask` ルールをチェックします。質問ルールが一致する場合、`bypassPermissions` モードでも、コールは確認のために[`canUseTool` コールバック](/ja/agent-sdk/user-input)にフォールスルーします。

32 32 

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

34 

35 [claude.ai コネクタ](/ja/mcp#organization-controls-on-connector-tools)ツール（組織が `ask` に設定したもの）もこのステップでフローを離れます。すべてのコールはコールバックにフォールスルーします。`bypassPermissions` モードでも、許可ルールが一致する場合でもです。コールバックは理由 `Your organization requires approval for this tool` を受け取ります。`dontAsk` モードではコールが拒否される代わりに、このモードはプロンプトを表示しないためです。

34 </Step>36 </Step>

35 37 

36 <Step title="権限モード">38 <Step title="権限モード">

77 79 

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

79 81 

82`Read` および `Edit` のスコープ付きルールはパスパターンを取ります。`Edit(path)` ルールは、`Write` および `NotebookEdit` を含む、ファイルを書き込むすべての組み込みツールを管理します。`Write(path)` ルールはファイル権限チェックと一致することはありません。

83 

84絶対ファイルシステムパスには `//path` を使用します。`Edit(//secrets/**)` の拒否ルールは、ディスク上の `/secrets` の下のどこでも書き込みをブロックします。単一の先頭スラッシュを使用する場合、`Edit(/secrets/**)` はルールのソースでアンカーされます。`allowed_tools` または `disallowed_tools` を通じて渡されるルールの場合、これはセッションの作業ディレクトリを意味するため、ルールはディスク上の `/secrets` をブロックしません。4 つのアンカー形式と設定ファイルからのルール解決方法については、[Read および Edit ルール](/ja/permissions#read-and-edit)を参照してください。

85 

80<Warning>86<Warning>

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

88 

89 カバレッジはエントリの形式に依存します。`Read` または `mcp__github__get_issue` のような単純な名前は、そのツールへのすべての呼び出しを自動承認しますが、`Bash(ls *)` のようなスコープ付きルールは一致する呼び出しのみを自動承認し、その他の `Bash` 呼び出しはコールバックにフォールスルーします。すべてのツール呼び出しで実行する必要があるチェックについては、[`PreToolUse` フック](/ja/agent-sdk/hooks)を使用してください。フックはすべての他のステップの前に実行され、フック拒否は `bypassPermissions` モードでも適用されます。

82</Warning>90</Warning>

83 91 

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

85 93 

86```typescript theme={null}94```typescript theme={null}

87const options = {95const options = {

109SDK は以下のパーミッションモードをサポートしています。117SDK は以下のパーミッションモードをサポートしています。

110 118 

111| モード | 説明 | ツール動作 |119| モード | 説明 | ツール動作 |

112| :------------------ | :--------------- | :----------------------------------------------------------------------------------------------------------- |120| :------------------ | :--------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

113| `default` | 標準パーミッション動作 | 自動承認なし。一致しないツールは `canUseTool` コールバックをトリガーします |121| `default` | 標準パーミッション動作 | 自動承認なし。一致しないツールは `canUseTool` コールバックをトリガーします |

114| `dontAsk` | プロンプトの代わりに拒否 | `allowed_tools` またはルールで事前承認されていないものはすべて拒否されます。`canUseTool` は呼び出されません |122| `dontAsk` | プロンプトの代わりに拒否 | `allowed_tools` またはルールで事前承認されていないものはすべて拒否されます。コネクタツール[組織が `ask` に設定](/ja/mcp#organization-controls-on-connector-tools)したもの、およびユーザーインタラクションが必要なツールは、事前承認していても拒否されます。`canUseTool` は呼び出されません |

115| `acceptEdits` | ファイル編集を自動受け入れ | ファイル編集および[ファイルシステム操作](#accept-edits-mode-acceptedits)（`mkdir`、`rm`、`mv` など）は自動的に承認されます |123| `acceptEdits` | ファイル編集を自動受け入れ | ファイル編集および[ファイルシステム操作](#accept-edits-mode-acceptedits)（`mkdir`、`rm`、`mv` など）は自動的に承認されます |

116| `bypassPermissions` | パーミッションチェックをバイパス | ツールは明示的な [`ask` ルール](#how-permissions-are-evaluated)が一致しない限り、パーミッションプロンプトなしで実行されます（注意して使用してください） |124| `bypassPermissions` | パーミッションチェックをバイパス | ツールは明示的な [`ask` ルール](#how-permissions-are-evaluated)が一致する場合、コネクタツール[組織が `ask` に設定](/ja/mcp#organization-controls-on-connector-tools)した場合、およびユーザーインタラクションが必要なツール以外は、パーミッションプロンプトなしで実行されます（注意して使用してください） |

117| `plan` | 計画モード | Claude はソースファイルを編集せずにコードベースを探索および計画します。ファイル編集は自動承認されず、`canUseTool` コールバックを通じてプロンプトが表示されます |125| `plan` | 計画モード | Claude はソースファイルを編集せずにコードベースを探索および計画します。ファイル編集は自動承認されず、`canUseTool` コールバックを通じてプロンプトが表示されます |

118| `auto` | モデル分類承認 | モデル分類器が各ツール呼び出しを承認または拒否します。利用可能性については[自動モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)を参照してください |126| `auto` | モデル分類承認 | モデル分類器が各ツール呼び出しを承認または拒否します。利用可能性については[自動モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)を参照してください |

119 127 

120<Warning>128<Warning>

121 **サブエージェント継承：** 親が `bypassPermissions`、`acceptEdits`、または `auto` を使用する場合、すべてのサブエージェントはそのモードを継承し、サブエージェントごとにオーバーライドすることはできません。サブエージェントはシステムプロンプトが異なり、メインエージェントよりも制約が少ない動作をする可能性があるため、`bypassPermissions` を継承すると、完全な自律的なシステムアクセスが付与されます。明示的な [`ask` ルール](#how-permissions-are-evaluated)は引き続きプロンプトを強制します。129 **サブエージェント継承：** 親が `bypassPermissions`、`acceptEdits`、または `auto` を使用する場合、すべてのサブエージェントはそのモードを継承し、サブエージェントごとにオーバーライドすることはできません。サブエージェントはシステムプロンプトが異なり、メインエージェントよりも制約が少ない動作をする可能性があるため、`bypassPermissions` を継承すると、完全な自律的なシステムアクセスが付与されます。明示的な [`ask` ルール](#how-permissions-are-evaluated)、コネクタツール[組織が `ask` に設定](/ja/mcp#organization-controls-on-connector-tools)したもの、およびユーザーインタラクションが必要なツールは引き続きプロンプトを強制します。

122</Warning>130</Warning>

123 131 

124<h3 id="set-permission-mode">132<h3 id="set-permission-mode">

252 質問しないモード（`dontAsk`）260 質問しないモード（`dontAsk`）

253</h4>261</h4>

254 262 

255パーミッションプロンプトを拒否に変換します。`allowed_tools`、`settings.json` 許可ルール、またはフックで事前承認されたツールは通常どおり実行されます。その他のすべては `canUseTool` を呼び出さずに拒否されます。263パーミッションプロンプトを拒否に変換します。`allowed_tools`、`settings.json` 許可ルール、またはフックで事前承認されたツールは通常どおり実行されます。コネクタツール[組織が `ask` に設定](/ja/mcp#organization-controls-on-connector-tools)したもの、およびユーザーインタラクションが必要なツールは、許可ルールが一致する場合でも拒否されます。その他のすべては `canUseTool` を呼び出さずに拒否されます。

256 264 

257**使用時期：** ヘッドレスエージェント用に固定された明示的なツール表面が必要で、`canUseTool` が存在しないことへの暗黙的な依存よりもハード拒否を優先する場合。265**使用時期：** ヘッドレスエージェント用に固定された明示的なツール表面が必要で、`canUseTool` が存在しないことへの暗黙的な依存よりもハード拒否を優先する場合。

258 266 

265<Warning>273<Warning>

266 極度の注意を持って使用してください。Claude はこのモードでフルシステムアクセスを持ちます。すべての可能な操作を信頼できる制御された環境でのみ使用してください。274 極度の注意を持って使用してください。Claude はこのモードでフルシステムアクセスを持ちます。すべての可能な操作を信頼できる制御された環境でのみ使用してください。

267 275 

268 `allowed_tools` はこのモードを制限しません。リストしたツールだけでなく、すべてのツールが承認されます。拒否ルール（`disallowed_tools`）、明示的な `ask` ルール、およびフックはモードチェック前に評価され、ツールをブロックできます。276 `allowed_tools` はこのモードを制限しません。リストしたツールだけでなく、すべてのツールが承認されます。拒否ルール（`disallowed_tools`）、明示的な `ask` ルール、およびフックはモードチェック前に評価され、ツールをブロックできます。コネクタツール[組織が `ask` に設定](/ja/mcp#organization-controls-on-connector-tools)したもの、およびユーザーインタラクションが必要なツールは引き続き `canUseTool` コールバックにフォールスルーします。

269</Warning>277</Warning>

270 278 

271<h4 id="plan-mode-plan">279<h4 id="plan-mode-plan">

138) -> Callable[[Callable[[Any], Awaitable[dict[str, Any]]]], SdkMcpTool[Any]]138) -> Callable[[Callable[[Any], Awaitable[dict[str, Any]]]], SdkMcpTool[Any]]

139```139```

140 140 

141<h4 id="parameters-1">141<h4 id="parameters-2">

142 パラメータ142 パラメータ

143</h4>143</h4>

144 144 

171 }171 }

172 ```172 ```

173 173 

174<h4 id="returns-1">174<h4 id="returns-2">

175 戻り値175 戻り値

176</h4>176</h4>

177 177 

234) -> McpSdkServerConfig234) -> McpSdkServerConfig

235```235```

236 236 

237<h4 id="parameters-2">237<h4 id="parameters-3">

238 パラメータ238 パラメータ

239</h4>239</h4>

240 240 

244| `version` | `str` | `"1.0.0"` | サーバーバージョン文字列 |244| `version` | `str` | `"1.0.0"` | サーバーバージョン文字列 |

245| `tools` | `list[SdkMcpTool[Any]] \| None` | `None` | `@tool` デコレータで作成されたツール関数のリスト |245| `tools` | `list[SdkMcpTool[Any]] \| None` | `None` | `@tool` デコレータで作成されたツール関数のリスト |

246 246 

247<h4 id="returns-2">247<h4 id="returns-3">

248 戻り値248 戻り値

249</h4>249</h4>

250 250 

251`ClaudeAgentOptions.mcp_servers` に渡すことができる `McpSdkServerConfig` オブジェクトを返します。251`ClaudeAgentOptions.mcp_servers` に渡すことができる `McpSdkServerConfig` オブジェクトを返します。

252 252 

253<h4 id="example-1">253<h4 id="example-2">

254 例254 例

255</h4>255</h4>

256 256 

291def list_sessions(291def list_sessions(

292 directory: str | None = None,292 directory: str | None = None,

293 limit: int | None = None,293 limit: int | None = None,

294 offset: int = 0,

294 include_worktrees: bool = True295 include_worktrees: bool = True

295) -> list[SDKSessionInfo]296) -> list[SDKSessionInfo]

296```297```

297 298 

298<h4 id="parameters-3">299<h4 id="parameters-4">

299 パラメータ300 パラメータ

300</h4>301</h4>

301 302 

303| :------------------ | :------------ | :----- | :---------------------------------------------------------- |304| :------------------ | :------------ | :----- | :---------------------------------------------------------- |

304| `directory` | `str \| None` | `None` | セッションをリストするディレクトリ。省略した場合、すべてのプロジェクト全体のセッションを返します |305| `directory` | `str \| None` | `None` | セッションをリストするディレクトリ。省略した場合、すべてのプロジェクト全体のセッションを返します |

305| `limit` | `int \| None` | `None` | 返すセッションの最大数 |306| `limit` | `int \| None` | `None` | 返すセッションの最大数 |

307| `offset` | `int` | `0` | ソート結果の開始からスキップするセッション数。`limit` と一緒に使用してページネーションを行います |

306| `include_worktrees` | `bool` | `True` | `directory` が git リポジトリ内にある場合、すべての worktree パスからのセッションを含めます |308| `include_worktrees` | `bool` | `True` | `directory` が git リポジトリ内にある場合、すべての worktree パスからのセッションを含めます |

307 309 

308<h4 id="return-type-sdksessioninfo">310<h4 id="return-type-sdksessioninfo">

322| `tag` | `str \| None` | ユーザーが設定したセッションタグ（[`tag_session()`](#tag_session) を参照） |324| `tag` | `str \| None` | ユーザーが設定したセッションタグ（[`tag_session()`](#tag_session) を参照） |

323| `created_at` | `int \| None` | エポック以降のミリ秒単位でのセッション作成時刻 |325| `created_at` | `int \| None` | エポック以降のミリ秒単位でのセッション作成時刻 |

324 326 

325<h4 id="example-2">327<h4 id="example-3">

326 例328 例

327</h4>329</h4>

328 330 

350) -> list[SessionMessage]352) -> list[SessionMessage]

351```353```

352 354 

353<h4 id="parameters-4">355<h4 id="parameters-5">

354 パラメータ356 パラメータ

355</h4>357</h4>

356 358 

373| `message` | `Any` | 生のメッセージコンテンツ |375| `message` | `Any` | 生のメッセージコンテンツ |

374| `parent_tool_use_id` | `None` | 将来の使用のために予約済み |376| `parent_tool_use_id` | `None` | 将来の使用のために予約済み |

375 377 

376<h4 id="example-3">378<h4 id="example-4">

377 例379 例

378</h4>380</h4>

379 381 

400) -> SDKSessionInfo | None402) -> SDKSessionInfo | None

401```403```

402 404 

403<h4 id="parameters-5">405<h4 id="parameters-6">

404 パラメータ406 パラメータ

405</h4>407</h4>

406 408 

411 413 

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

413 415 

414<h4 id="example-4">416<h4 id="example-5">

415 例417 例

416</h4>418</h4>

417 419 

439) -> None441) -> None

440```442```

441 443 

442<h4 id="parameters-6">444<h4 id="parameters-7">

443 パラメータ445 パラメータ

444</h4>446</h4>

445 447 

451 453 

452`session_id` が有効な UUID でない場合、または `title` が空の場合は `ValueError` を発生させます。セッションが見つからない場合は `FileNotFoundError`。454`session_id` が有効な UUID でない場合、または `title` が空の場合は `ValueError` を発生させます。セッションが見つからない場合は `FileNotFoundError`。

453 455 

454<h4 id="example-5">456<h4 id="example-6">

455 例457 例

456</h4>458</h4>

457 459 

479) -> None481) -> None

480```482```

481 483 

482<h4 id="parameters-7">484<h4 id="parameters-8">

483 パラメータ485 パラメータ

484</h4>486</h4>

485 487 

491 493 

492`session_id` が有効な UUID でない場合、またはサニタイズ後に `tag` が空の場合は `ValueError` を発生させます。セッションが見つからない場合は `FileNotFoundError`。494`session_id` が有効な UUID でない場合、またはサニタイズ後に `tag` が空の場合は `ValueError` を発生させます。セッションが見つからない場合は `FileNotFoundError`。

493 495 

494<h4 id="example-6">496<h4 id="example-7">

495 例497 例

496</h4>498</h4>

497 499 

1257 1259 

1258コールバックは対話的なパーミッションプロンプトの SDK 置き換えです：[パーミッション評価フロー](/ja/agent-sdk/permissions#how-permissions-are-evaluated) がプロンプトに解決される場合にのみ呼び出されます。`allowed_tools` エントリ、設定許可ルール、または `acceptEdits` や `bypassPermissions` などのパーミッションモードによって事前承認されたツール呼び出しは呼び出されません。すべてのツール呼び出しをゲートするには、代わりに [`PreToolUse` hook](/ja/agent-sdk/hooks) を使用してください。1260コールバックは対話的なパーミッションプロンプトの SDK 置き換えです：[パーミッション評価フロー](/ja/agent-sdk/permissions#how-permissions-are-evaluated) がプロンプトに解決される場合にのみ呼び出されます。`allowed_tools` エントリ、設定許可ルール、または `acceptEdits` や `bypassPermissions` などのパーミッションモードによって事前承認されたツール呼び出しは呼び出されません。すべてのツール呼び出しをゲートするには、代わりに [`PreToolUse` hook](/ja/agent-sdk/hooks) を使用してください。

1259 1261 

1262`AskUserQuestion`、[`requiresUserInteraction`](/ja/mcp#require-approval-for-a-specific-tool) とマークされた MCP ツール、および [組織が `ask` に設定したコネクタツール](/ja/mcp#organization-controls-on-connector-tools) は、許可ルールが一致する場合でもコールバックに到達します。`dontAsk` モードではこれらの呼び出しは代わりに拒否され、コールバックを呼び出しません。

1263 

1260<h3 id="toolpermissioncontext">1264<h3 id="toolpermissioncontext">

1261 `ToolPermissionContext`1265 `ToolPermissionContext`

1262</h3>1266</h3>

1744`usage` dict には、存在する場合、以下のキーが含まれます：1748`usage` dict には、存在する場合、以下のキーが含まれます：

1745 1749 

1746| キー | 型 | 説明 |1750| キー | 型 | 説明 |

1747| ----------------------------- | ----- | ------------------------------ |1751| ----------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |

1748| `input_tokens` | `int` | 消費された総入力トークン。 |1752| `input_tokens` | `int` | トップレベルエージェントループで消費された入力トークン。[サブエージェントトークンは含まれません](/ja/agent-sdk/cost-tracking#get-the-total-cost-of-a-query)。全体のアカウンティングについては `model_usage` を使用してください。 |

1749| `output_tokens` | `int` | 生成された総出力トークン。 |1753| `output_tokens` | `int` | トップレベルエージェントループで生成された出力トークン。サブエージェントトークンは含まれません。 |

1750| `cache_creation_input_tokens` | `int` | 新しいキャッシュエントリを作成するために使用されたトークン。 |1754| `cache_creation_input_tokens` | `int` | 新しいキャッシュエントリを作成するために使用されたトークン。 |

1751| `cache_read_input_tokens` | `int` | 既存のキャッシュエントリから読み取られたトークン。 |1755| `cache_read_input_tokens` | `int` | 既存のキャッシュエントリから読み取られたトークン。 |

1752 1756 

2688```python theme={null}2692```python theme={null}

2689{2693{

2690 "command": str, # 実行するコマンド2694 "command": str, # 実行するコマンド

2691 "timeout": int | None, # オプションのタイムアウト（ミリ秒、最大 600000）2695 "timeout": int | None, # オプションのタイムアウト（ミリ秒、最大 600000。より高い値は最大値にクランプされます）

2692 "description": str | None, # 明確で簡潔な説明（5～10 語）2696 "description": str | None, # 明確で簡潔な説明（5～10 語）

2693 "run_in_background": bool | None, # バックグラウンドで実行する場合は true に設定2697 "run_in_background": bool | None, # バックグラウンドで実行する場合は true に設定

2694}2698}

3667 サンドボックス設定で `"failIfUnavailable": True` を設定して、代わりに停止するようにしてください。このキーはまだ `SandboxSettings` で宣言されていませんが、SDK は Claude Code に転送し、Claude Code がこれを尊重します。その後、`query()` は `subtype="error_during_execution"` の `ResultMessage` を報告し、理由は `errors` に含まれます。`query()` がメッセージを生成する前に例外を発生させることを期待するのではなく、そのサブタイプを監視してください。3671 サンドボックス設定で `"failIfUnavailable": True` を設定して、代わりに停止するようにしてください。このキーはまだ `SandboxSettings` で宣言されていませんが、SDK は Claude Code に転送し、Claude Code がこれを尊重します。その後、`query()` は `subtype="error_during_execution"` の `ResultMessage` を報告し、理由は `errors` に含まれます。`query()` がメッセージを生成する前に例外を発生させることを期待するのではなく、そのサブタイプを監視してください。

3668</Note>3672</Note>

3669 3673 

3670<h4 id="example-usage-1">3674<h4 id="example-usage-2">

3671 使用例3675 使用例

3672</h4>3676</h4>

3673 3677 

368**権限モード** は、必要な人間の監視の量を制御します：368**権限モード** は、必要な人間の監視の量を制御します：

369 369 

370| モード | 動作 | ユースケース |370| モード | 動作 | ユースケース |

371| ------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------- |371| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |

372| `acceptEdits` | ファイル編集と一般的なファイルシステムコマンドを自動承認し、他のアクションについては確認します | 信頼できる開発ワークフロー |372| `acceptEdits` | ファイル編集と一般的なファイルシステムコマンドを自動承認し、他のアクションについては確認します | 信頼できる開発ワークフロー |

373| `plan` | 読み取り専用ツールを実行します。ファイル編集は自動承認されず、`canUseTool` コールバックに到達します | 実行を承認する前にタスクをスコープする |373| `plan` | 読み取り専用ツールを実行します。ファイル編集は自動承認されず、`canUseTool` コールバックに到達します | 実行を承認する前にタスクをスコープする |

374| `dontAsk` | `allowedTools` にないものを拒否します | ロックダウンされたヘッドレスエージェント |374| `dontAsk` | `allowedTools` にないものを拒否します。コネクタツール [組織が `ask` に設定](/ja/mcp#organization-controls-on-connector-tools) およびユーザーインタラクションが必要なツールは、リストに含めた場合でも拒否されます | ロックダウンされたヘッドレスエージェント |

375| `auto` | モデル分類器が各ツール呼び出しを承認または拒否します | 安全ガードレール付きの自律エージェント |375| `auto` | モデル分類器が各ツール呼び出しを承認または拒否します | 安全ガードレール付きの自律エージェント |

376| `bypassPermissions` | 明示的な [`ask` ルール](/ja/agent-sdk/permissions#how-permissions-are-evaluated) に一致しない限り、プロンプトなしですべてのツールを実行します | サンドボックス化された CI、完全に信頼できる環境 |376| `bypassPermissions` | 明示的な [`ask` ルール](/ja/agent-sdk/permissions#how-permissions-are-evaluated) に一致しない限り、プロンプトなしですべてのツールを実行します。コネクタツール [組織が `ask` に設定](/ja/mcp#organization-controls-on-connector-tools) およびユーザーインタラクションが必要なツールは拒否されます | サンドボックス化された CI、完全に信頼できる環境 |

377| `default` | 承認を処理するために `canUseTool` コールバックが必要です | カスタム承認フロー |377| `default` | 承認を処理するために `canUseTool` コールバックが必要です | カスタム承認フロー |

378 378 

379上記の例は `acceptEdits` モードを使用しており、ファイル操作を自動承認するため、エージェントはインタラクティブなプロンプトなしで実行できます。ユーザーに承認を促す場合は、`default` モードを使用し、ユーザー入力を収集する [`canUseTool` コールバック](/ja/agent-sdk/user-input) を提供します。より詳細な制御については、[権限](/ja/agent-sdk/permissions) を参照してください。379上記の例は `acceptEdits` モードを使用しており、ファイル操作を自動承認するため、エージェントはインタラクティブなプロンプトなしで実行できます。ユーザーに承認を促す場合は、`default` モードを使用し、ユーザー入力を収集する [`canUseTool` コールバック](/ja/agent-sdk/user-input) を提供します。より詳細な制御については、[権限](/ja/agent-sdk/permissions) を参照してください。

224 224 

225サブエージェントのコンテキストウィンドウは新しく開始されます（親の会話なし）が、空ではありません。親からサブエージェントへの唯一のチャネルは Agent ツールのプロンプト文字列なので、サブエージェントが必要とするファイルパス、エラーメッセージ、または決定をそのプロンプトに直接含めてください。225サブエージェントのコンテキストウィンドウは新しく開始されます（親の会話なし）が、空ではありません。親からサブエージェントへの唯一のチャネルは Agent ツールのプロンプト文字列なので、サブエージェントが必要とするファイルパス、エラーメッセージ、または決定をそのプロンプトに直接含めてください。

226 226 

227{/* min-version: 2.1.206 */}[`SendMessage`](/ja/tools-reference) ツールを持つサブエージェントは、セッションで実行されている他の名前付きエージェントのリストで開始されるため、メッセージを送信できる名前を認識しています。Claude Code はセッションの最初のターンでサブエージェントにリストを自動的に追加します。[フォーク](/ja/sub-agents#fork-the-current-conversation)は親の会話を継承するため、リストを取得しません。このリストには Claude Code v2.1.206 以降が必要です。

228 

227| サブエージェントが受け取るもの | サブエージェントが受け取らないもの |229| サブエージェントが受け取るもの | サブエージェントが受け取らないもの |

228| :------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------- |230| :------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------- |

229| 独自のシステムプロンプト（`AgentDefinition.prompt`）と Agent ツールのプロンプト | 親の会話履歴またはツール結果 |231| 独自のシステムプロンプト（`AgentDefinition.prompt`）と Agent ツールのプロンプト | 親の会話履歴またはツール結果 |

581* **セッション永続化**: サブエージェントのトランスクリプトはセッション内で永続化されます。同じセッションを再開することで、Claude Code を再起動した後にサブエージェントを再開できます。583* **セッション永続化**: サブエージェントのトランスクリプトはセッション内で永続化されます。同じセッションを再開することで、Claude Code を再起動した後にサブエージェントを再開できます。

582* **自動クリーンアップ**: トランスクリプトは `cleanupPeriodDays` 設定に基づいてクリーンアップされます（デフォルト：30 日）。584* **自動クリーンアップ**: トランスクリプトは `cleanupPeriodDays` 設定に基づいてクリーンアップされます（デフォルト：30 日）。

583 585 

584<h2 id="tool-restrictions-1">586<h2 id="tool-restrictions-2">

585 ツール制限587 ツール制限

586</h2>588</h2>

587 589 

19 ツール検索の仕組み19 ツール検索の仕組み

20</h2>20</h2>

21 21 

22ツール検索がアクティブな場合、ツール定義はコンテキストウィンドウから保留されます。エージェントは利用可能なツールの概要を受け取り、タスクが既に読み込まれていない機能を必要とする場合、関連するツールを検索します。最も関連性の高い 3～5 個のツールがコンテキストに読み込まれ、その後のターンで利用可能なままになります。会話が十分に長く、SDK が以前のメッセージをコンパクト化してスペースを解放する場合、以前に検出されたツールが削除される可能性があり、エージェントは必要に応じて再度検索します。22ツール検索がアクティブな場合、ツール定義はコンテキストウィンドウから保留されます。エージェントは利用可能なツールの概要を受け取り、タスクが既に読み込まれていない機能を必要とする場合、関連するツールを検索します。最も関連性の高い 5 個までのツールがデフォルトでコンテキストに読み込まれ、その後のターンで利用可能なままになります。会話が十分に長く、SDK が以前のメッセージをコンパクト化してスペースを解放する場合、以前に検出されたツールが削除される可能性があり、エージェントは必要に応じて再度検索します。

23 23 

24ツール検索は、Claude が初めてツールを検出するときに 1 つの追加ラウンドトリップを追加します（検索ステップ）。ただし、大規模なツールセットの場合、これはすべてのターンでより小さいコンテキストによってオフセットされます。ツールが約 10 個未満の場合、すべてを事前に読み込む方が通常は高速です。24ツール検索は、Claude が初めてツールを検出するときに 1 つの追加ラウンドトリップを追加します（検索ステップ）。ただし、大規模なツールセットの場合、これはすべてのターンでより小さいコンテキストによってオフセットされます。ツールが約 10 個未満の場合、すべてを事前に読み込む方が通常は高速です。

25 25 

26基盤となる API メカニズムの詳細については、[API のツール検索](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-search-tool)を参照してください。26基盤となる API メカニズムの詳細については、[API のツール検索](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-search-tool)を参照してください。

27 27 

28<Note>28<Note>

29 ツール検索は Haiku を除くすべての Claude モデルでサポートされています。29 ツール検索は Claude Sonnet 4.5、Claude Haiku 4.5、Claude Opus 4.5、およびそれ以降のモデルでサポートされています。現在のリストについては、[API ドキュメントのモデル互換性](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-search-tool#model-compatibility)を参照してください。Google Cloud の Agent Platform では、サポートされている最小モデルは Claude Sonnet 4.5 と Claude Opus 4.5 です。

30</Note>30</Note>

31 31 

32<h2 id="configure-tool-search">32<h2 id="configure-tool-search">

43| `auto:N` | カスタム割合を使用した `auto` と同じです。`auto:5` はツール定義がコンテキストウィンドウの 5% を超える場合にアクティブになります。値が低いほど、より早くアクティブになります。 |43| `auto:N` | カスタム割合を使用した `auto` と同じです。`auto:5` はツール定義がコンテキストウィンドウの 5% を超える場合にアクティブになります。値が低いほど、より早くアクティブになります。 |

44| `false` | ツール検索はオフです。すべてのツール定義がすべてのターンでコンテキストに読み込まれます。 |44| `false` | ツール検索はオフです。すべてのツール定義がすべてのターンでコンテキストに読み込まれます。 |

45 45 

46[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/ja/env-vars) を設定するとツール検索がオフになり、`ENABLE_TOOL_SEARCH` はそれをオーバーライドできません。この変数は、`defer_loading` ツール定義と `tool_reference` コンテンツブロックが必要とするベータヘッダーを削除します。

47 

46ツール検索は、リモート MCP サーバーから来るか、[カスタム SDK MCP サーバー](/ja/agent-sdk/custom-tools)から来るかに関わらず、すべての登録ツールに適用されます。`auto` を使用する場合、閾値はすべてのサーバー全体のすべてのツール定義の合計サイズに基づいています。48ツール検索は、リモート MCP サーバーから来るか、[カスタム SDK MCP サーバー](/ja/agent-sdk/custom-tools)から来るかに関わらず、すべての登録ツールに適用されます。`auto` を使用する場合、閾値はすべてのサーバー全体のすべてのツール定義の合計サイズに基づいています。

47 49 

48`query()` の `env` オプションで値を設定します。この例は、多くのツールを公開するリモート MCP サーバーに接続し、ワイルドカードですべてのツールを事前承認し、`auto:5` を使用して、ツール定義がコンテキストウィンドウの 5% を超える場合にツール検索をアクティブにします。50`query()` の `env` オプションで値を設定します。TypeScript では、`env` はサブプロセス環境を置き換えるため、継承された変数を保持するために `...process.env` を展開します。Python では、`env` は継承された環境の上にマージされます。この例は、多くのツールを公開するリモート MCP サーバーに接続し、ワイルドカードですべてのツールを事前承認し、`auto:5` を使用して、ツール定義がコンテキストウィンドウの 5% を超える場合にツール検索をアクティブにします。

49 51 

50<CodeGroup>52<CodeGroup>

51 ```typescript TypeScript theme={null}53 ```typescript TypeScript theme={null}

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

53 55 

56 try {

54 for await (const message of query({57 for await (const message of query({

55 prompt: "Find and run the appropriate database query",58 prompt: "Find and run the appropriate database query",

56 options: {59 options: {

63 },66 },

64 allowedTools: ["mcp__enterprise-tools__*"], // Wildcard pre-approves all tools from this server67 allowedTools: ["mcp__enterprise-tools__*"], // Wildcard pre-approves all tools from this server

65 env: {68 env: {

69 ...process.env, // env replaces the subprocess environment, so keep inherited variables

66 ENABLE_TOOL_SEARCH: "auto:5" // Activate tool search when tools exceed 5% of context70 ENABLE_TOOL_SEARCH: "auto:5" // Activate tool search when tools exceed 5% of context

67 }71 }

68 }72 }

71 console.log(message.result);75 console.log(message.result);

72 }76 }

73 }77 }

78 } catch (error) {

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

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

81 }

74 ```82 ```

75 83 

76 ```python Python theme={null}84 ```python Python theme={null}

94 },102 },

95 )103 )

96 104 

105 try:

97 async for message in query(106 async for message in query(

98 prompt="Find and run the appropriate database query",107 prompt="Find and run the appropriate database query",

99 options=options,108 options=options,

100 ):109 ):

101 if isinstance(message, ResultMessage) and message.subtype == "success":110 if isinstance(message, ResultMessage) and message.subtype == "success":

102 print(message.result)111 print(message.result)

112 except Exception as error:

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

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

103 115 

104 116 

105 asyncio.run(main())117 asyncio.run(main())

106 ```118 ```

107</CodeGroup>119</CodeGroup>

108 120 

121この例を実行するには、`https://tools.example.com/mcp` を独自の MCP サーバーの URL に置き換えてください。成功時に、結果テキストがコンソールに出力されます。

122 

123これは単一ショットの `query()` 呼び出しであるため、SDK はエラー結果を生成した後に発生するため、この例はループを try ブロックでラップします。実行が失敗した理由を確認するには、ループ内の結果メッセージの `subtype`（`error_during_execution` など）を確認してください。結果メッセージの詳細については、[結果を処理する](/ja/agent-sdk/agent-loop#handle-the-result)を参照してください。

124 

109`ENABLE_TOOL_SEARCH` を `"false"` に設定すると、ツール検索が無効になり、すべてのツール定義がすべてのターンでコンテキストに読み込まれます。これにより検索ラウンドトリップが削除されます。ツールセットが小さい（約 10 個未満のツール）場合、定義がコンテキストウィンドウに快適に収まる場合は、より高速になる可能性があります。125`ENABLE_TOOL_SEARCH` を `"false"` に設定すると、ツール検索が無効になり、すべてのツール定義がすべてのターンでコンテキストに読み込まれます。これにより検索ラウンドトリップが削除されます。ツールセットが小さい（約 10 個未満のツール）場合、定義がコンテキストウィンドウに快適に収まる場合は、より高速になる可能性があります。

110 126 

111<h2 id="optimize-tool-discovery">127<h2 id="optimize-tool-discovery">

114 130 

115検索メカニズムは、ツール名と説明に対してクエリを照合します。`search_slack_messages` のような名前は、`query_slack` よりも広い範囲のリクエストに対して表示されます。「キーワード、チャネル、または日付範囲で Slack メッセージを検索」などの具体的なキーワードを含む説明は、「Slack をクエリ」などの一般的な説明よりも多くのクエリに一致します。131検索メカニズムは、ツール名と説明に対してクエリを照合します。`search_slack_messages` のような名前は、`query_slack` よりも広い範囲のリクエストに対して表示されます。「キーワード、チャネル、または日付範囲で Slack メッセージを検索」などの具体的なキーワードを含む説明は、「Slack をクエリ」などの一般的な説明よりも多くのクエリに一致します。

116 132 

117利用可能なツールカテゴリをリストするシステムプロンプトセクションを追加することもできます。これにより、エージェントは検索対象のツールの種類に関するコンテキストを取得します。133利用可能なツールカテゴリをリストするシステムプロンプトセクションを追加することもできます。これにより、エージェントは検索対象のツールの種類に関するコンテキストを取得します。TypeScript では `systemPrompt` オプション、Python では `system_prompt` を使用してテキストを渡します。`claude_code` プリセットで `append` を使用すると、プリセットのプロンプトを置き換えるのではなく、テキストを追加します。

134 

135<CodeGroup>

136 ```typescript TypeScript theme={null}

137 options: {

138 systemPrompt: {

139 type: "preset",

140 preset: "claude_code",

141 append: "You can search for tools to interact with Slack, GitHub, and Jira."

142 }

143 }

144 ```

145 

146 ```python Python theme={null}

147 options = ClaudeAgentOptions(

148 system_prompt={

149 "type": "preset",

150 "preset": "claude_code",

151 "append": "You can search for tools to interact with Slack, GitHub, and Jira.",

152 }

153 )

154 ```

155</CodeGroup>

118 156 

119```text theme={null}157システムプロンプトオプションの完全なセットについては、[システムプロンプトの変更](/ja/agent-sdk/modifying-system-prompts)を参照してください。

120You can search for tools to interact with Slack, GitHub, and Jira.

121```

122 158 

123<h2 id="limits">159<h2 id="limits">

124 制限160 制限

125</h2>161</h2>

126 162 

127* **最大ツール数：** カタログ内の 10,000 個のツール163* **最大ツール数：** カタログ内の 10,000 個のツール

128* **検索結果：** 検索ごとに最も関連性の高い 3～5 個のツールを返します164* **検索結果：** デフォルトでは検索ごとに最も関連性の高い 5 つのツールを返します

129* **モデルサポート：** Haiku を除くすべての Claude モデル165* **モデルサポート：** Claude Sonnet 4.5、Claude Haiku 4.5、Claude Opus 4.5、およびそれ以降のモデル。現在のリストについては、[API ドキュメントのモデル互換性](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-search-tool#model-compatibility)を参照してください。Google Cloud の Agent Platform では、Claude Sonnet 4.5 以降および Claude Opus 4.5 以降。

130 166 

131<h2 id="related-documentation">167<h2 id="related-documentation">

132 関連ドキュメント168 関連ドキュメント

100}): Promise<WarmQuery>;100}): Promise<WarmQuery>;

101```101```

102 102 

103<h4 id="parameters-1">103<h4 id="parameters-2">

104 パラメータ104 パラメータ

105</h4>105</h4>

106 106 

109| `options` | [`Options`](#options) | オプションの設定オブジェクト。`query()` の `options` パラメータと同じです |109| `options` | [`Options`](#options) | オプションの設定オブジェクト。`query()` の `options` パラメータと同じです |

110| `initializeTimeoutMs` | `number` | サブプロセス初期化を待つ最大時間（ミリ秒）。デフォルトは `60000` です。初期化が時間内に完了しない場合、プロミスはタイムアウトエラーで拒否されます |110| `initializeTimeoutMs` | `number` | サブプロセス初期化を待つ最大時間（ミリ秒）。デフォルトは `60000` です。初期化が時間内に完了しない場合、プロミスはタイムアウトエラーで拒否されます |

111 111 

112<h4 id="returns-1">112<h4 id="returns-2">

113 戻り値113 戻り値

114</h4>114</h4>

115 115 

149): SdkMcpToolDefinition<Schema>;149): SdkMcpToolDefinition<Schema>;

150```150```

151 151 

152<h4 id="parameters-2">152<h4 id="parameters-3">

153 パラメータ153 パラメータ

154</h4>154</h4>

155 155 

204}): McpSdkServerConfigWithInstance;204}): McpSdkServerConfigWithInstance;

205```205```

206 206 

207<h4 id="parameters-3">207<h4 id="parameters-4">

208 パラメータ208 パラメータ

209</h4>209</h4>

210 210 

224function listSessions(options?: ListSessionsOptions): Promise<SDKSessionInfo[]>;224function listSessions(options?: ListSessionsOptions): Promise<SDKSessionInfo[]>;

225```225```

226 226 

227<h4 id="parameters-4">227<h4 id="parameters-5">

228 パラメータ228 パラメータ

229</h4>229</h4>

230 230 

251| `tag` | `string \| undefined` | ユーザーが設定したセッションタグ（[`tagSession()`](#tagsession) を参照） |251| `tag` | `string \| undefined` | ユーザーが設定したセッションタグ（[`tagSession()`](#tagsession) を参照） |

252| `createdAt` | `number \| undefined` | 最初のエントリのタイムスタンプからのエポック以降のミリ秒単位での作成時刻 |252| `createdAt` | `number \| undefined` | 最初のエントリのタイムスタンプからのエポック以降のミリ秒単位での作成時刻 |

253 253 

254<h4 id="example-1">254<h4 id="example-2">

255 例255 例

256</h4>256</h4>

257 257 

280): Promise<SessionMessage[]>;280): Promise<SessionMessage[]>;

281```281```

282 282 

283<h4 id="parameters-5">283<h4 id="parameters-6">

284 パラメータ284 パラメータ

285</h4>285</h4>

286 286 

304| `parent_tool_use_id` | `string \| null` | サブエージェントメッセージの場合、スポーニング `Agent` ツール呼び出しの `tool_use_id`。メインセッションメッセージおよび古いセッションの場合は `null` |304| `parent_tool_use_id` | `string \| null` | サブエージェントメッセージの場合、スポーニング `Agent` ツール呼び出しの `tool_use_id`。メインセッションメッセージおよび古いセッションの場合は `null` |

305| `parent_agent_id` | `string \| null` | [ネストされたサブエージェント](/ja/sub-agents#spawn-nested-subagents)からのメッセージの場合、それをスポーンしたサブエージェントの `agentId`。メインセッションメッセージ、トップレベルサブエージェントからのメッセージ、および古いセッションの場合は `null`。{/* min-version: 2.1.202 */}Claude Code v2.1.202 以降が必要です |305| `parent_agent_id` | `string \| null` | [ネストされたサブエージェント](/ja/sub-agents#spawn-nested-subagents)からのメッセージの場合、それをスポーンしたサブエージェントの `agentId`。メインセッションメッセージ、トップレベルサブエージェントからのメッセージ、および古いセッションの場合は `null`。{/* min-version: 2.1.202 */}Claude Code v2.1.202 以降が必要です |

306 306 

307<h4 id="example-2">307<h4 id="example-3">

308 例308 例

309</h4>309</h4>

310 310 

338): Promise<SDKSessionInfo | undefined>;338): Promise<SDKSessionInfo | undefined>;

339```339```

340 340 

341<h4 id="parameters-6">341<h4 id="parameters-7">

342 パラメータ342 パラメータ

343</h4>343</h4>

344 344 

363): Promise<void>;363): Promise<void>;

364```364```

365 365 

366<h4 id="parameters-7">366<h4 id="parameters-8">

367 パラメータ367 パラメータ

368</h4>368</h4>

369 369 

387): Promise<void>;387): Promise<void>;

388```388```

389 389 

390<h4 id="parameters-8">390<h4 id="parameters-9">

391 パラメータ391 パラメータ

392</h4>392</h4>

393 393 

413): Promise<ResolvedSettings>;413): Promise<ResolvedSettings>;

414```414```

415 415 

416<h4 id="parameters-9">416<h4 id="parameters-10">

417 パラメータ417 パラメータ

418</h4>418</h4>

419 419 

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

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

440 440 

441<h4 id="example-3">441<h4 id="example-4">

442 例442 例

443</h4>443</h4>

444 444 

467`query()` 関数の設定オブジェクト。467`query()` 関数の設定オブジェクト。

468 468 

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

470| :-------------------------------- | :------------------------------------------------------------------------------------------------------- | :------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |470| :-------------------------------- | :------------------------------------------------------------------------------------------------------- | :------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

472| `additionalDirectories` | `string[]` | `[]` | Claude がアクセスできる追加ディレクトリ |472| `additionalDirectories` | `string[]` | `[]` | Claude がアクセスできる追加ディレクトリ |

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

476| `allowDangerouslySkipPermissions` | `boolean` | `false` | 権限のバイパスを有効にします。`permissionMode: 'bypassPermissions'` を使用する場合に必須です |476| `allowDangerouslySkipPermissions` | `boolean` | `false` | 権限のバイパスを有効にします。`permissionMode: 'bypassPermissions'` を使用する場合に必須です |

477| `allowedTools` | `string[]` | `[]` | プロンプトなしで自動承認するツール。これは Claude をこれらのツールのみに制限しません。リストされていないツールは `permissionMode` と `canUseTool` にフォールスルーします。ツールをブロックするには `disallowedTools` を使用します。[権限](/ja/agent-sdk/permissions#allow-and-deny-rules) を参照してください |477| `allowedTools` | `string[]` | `[]` | プロンプトなしで自動承認するツール。これは Claude をこれらのツールのみに制限しません。リストされていないツールは `permissionMode` と `canUseTool` にフォールスルーします。ツールをブロックするには `disallowedTools` を使用します。[権限](/ja/agent-sdk/permissions#allow-and-deny-rules) を参照してください |

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

479| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | カスタム権限関数。[権限フロー](/ja/agent-sdk/permissions#how-permissions-are-evaluated) がプロンプトにフォールスルーする場合にのみ呼び出されます。`allowedTools`、許可ルール、または `permissionMode` によって自動承認されたツール呼び出しに対しては呼び出されません。詳細は [`CanUseTool`](#canusetool) を参照してください |479| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | カスタム権限関数。[権限フロー](/ja/agent-sdk/permissions#how-permissions-are-evaluated) がプロンプトにフォールスルーする場合にのみ呼び出されます。`allowedTools`、許可ルール、または `permissionMode` によって自動承認されたツール呼び出しに対しては呼び出されません。`AskUserQuestion`、コネクタツール [組織が `ask` に設定](/ja/mcp#organization-controls-on-connector-tools)、および [`requiresUserInteraction`](/ja/mcp#require-approval-for-a-specific-tool) とマークされた MCP ツールは、許可ルールで許可されていても到達します。`dontAsk` モードではこれらは代わりに拒否されます。詳細は [`CanUseTool`](#canusetool) を参照してください |

480| `continue` | `boolean` | `false` | 最新の会話を続けます |480| `continue` | `boolean` | `false` | 最新の会話を続けます |

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

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

492| `forkSession` | `boolean` | `false` | `resume` で再開するときに、元のセッション ID を続行する代わりに新しいセッション ID にフォークします |492| `forkSession` | `boolean` | `false` | `resume` で再開するときに、元のセッション ID を続行する代わりに新しいセッション ID にフォークします |

493| `forwardSubagentText` | `boolean` | `false` | サブエージェントのテキストと思考ブロックを `parent_tool_use_id` が設定されたアシスタントおよびユーザーメッセージとして転送し、コンシューマーがネストされたトランスクリプトをレンダリングできるようにします。デフォルトでは、サブエージェントからの `tool_use` および `tool_result` ブロックのみが発行されます |493| `forwardSubagentText` | `boolean` | `false` | サブエージェントのテキストと思考ブロックを `parent_tool_use_id` が設定されたアシスタントおよびユーザーメッセージとして転送し、コンシューマーがネストされたトランスクリプトをレンダリングできるようにします。デフォルトでは、サブエージェントからの `tool_use` および `tool_result` ブロックのみが発行されます |

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

495| `includeHookEvents` | `boolean` | `false` | フックライフサイクルイベントをメッセージストリームに [`SDKHookStartedMessage`](#sdkhookstartedmessage)、[`SDKHookProgressMessage`](#sdkhookprogressmessage)、[`SDKHookResponseMessage`](#sdkhookresponsemessage) として含めます |495| `includeHookEvents` | `boolean` | `false` | フックライフサイクルイベントをメッセージストリームに [`SDKHookStartedMessage`](#sdkhookstartedmessage)、[`SDKHookProgressMessage`](#sdkhookprogressmessage)、[`SDKHookResponseMessage`](#sdkhookresponsemessage) として含めます。`SessionStart` および `Setup` フックのライフサイクルイベントは常に含まれており、このオプションは不要です |

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

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

498| `managedSettings` | `Settings` | `undefined` | スポーニング親プロセスによって提供されるポリシーティア設定。マシンに IT 制御の管理設定ティアが既に存在する場合は削除されます。ただし、その管理者が `parentSettingsBehavior: 'merge'` でオプトインしない限り。関係なく制限的なキーのみにフィルタリングされます |498| `managedSettings` | `Settings` | `undefined` | スポーニング親プロセスによって提供されるポリシーティア設定。マシンに IT 制御の管理設定ティアが既に存在する場合は削除されます。ただし、その管理者が `parentSettingsBehavior: 'merge'` でオプトインしない限り。関係なく制限的なキーのみにフィルタリングされます |

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

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

601| `setModel()` | モデルを変更します（ストリーミング入力モードでのみ利用可能） |601| `setModel()` | モデルを変更します（ストリーミング入力モードでのみ利用可能） |

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

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

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

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

623 623 

624ミッドセッションで効果を発揮するキーのみ：624ミッドセッションで効果を発揮するキーのみ：

625 625 

626* **次のターンで適用される**：`model`、`effortLevel`、`ultracode`、`permissions`、`hooks`、`skillOverrides`、`fastMode`、`awaySummaryEnabled`、`agent`。`agent` を切り替えると、そのエージェントのモデルオーバーライド、フック、システムプロンプトも次のターンで適用されます。626* **次のターンで適用される**：`model`、`effortLevel`、`ultracode`、`permissions`、`hooks`、`skillOverrides`、`fastMode`、`agent`。`agent` を切り替えると、そのエージェントのモデルオーバーライド、フック、システムプロンプトも次のターンで適用されます。

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

628 628 

629`effortLevel` は [努力レベル](/ja/model-config#adjust-effort-level) 名を受け入れます。また、`"ultracode"` も受け入れます。これはセッションを `xhigh` 努力で実行し、[ultracode](/ja/workflows#let-claude-decide-with-ultracode) をオンにします。`Settings` 型はその値なしで `effortLevel` を宣言しているため、TypeScript では同等の `{ ultracode: true }` を渡します。{/* min-version: 2.1.203 */}`ultracode` 値には Claude Code v2.1.203 以降が必要であり、設定ファイルの `effortLevel` キーではなく、`applyFlagSettings()` によってのみ受け入れられます。629`effortLevel` は [努力レベル](/ja/model-config#adjust-effort-level) 名を受け入れます。また、`"ultracode"` も受け入れます。これはセッションを `xhigh` 努力で実行し、[ultracode](/ja/workflows#let-claude-decide-with-ultracode) をオンにします。`Settings` 型はその値なしで `effortLevel` を宣言しているため、TypeScript では同等の `{ ultracode: true }` を渡します。{/* min-version: 2.1.203 */}`ultracode` 値には Claude Code v2.1.203 以降が必要であり、設定ファイルの `effortLevel` キーではなく、`applyFlagSettings()` によってのみ受け入れられます。

663}663}

664```664```

665 665 

666<h4 id="methods-1">666<h4 id="methods-2">

667 メソッド667 メソッド

668</h4>668</h4>

669 669 

913 913 

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

915 915 

916関数は、インタラクティブな権限プロンプトの SDK 置き換えです。[権限評価フロー](/ja/agent-sdk/permissions#how-permissions-are-evaluated) がプロンプトに解決される場合にのみ呼び出されます。`allowedTools` エントリ、設定許可ルール、または `acceptEdits` や `bypassPermissions` などの権限モードによって既に承認されたツール呼び出しは、それを呼び出しません。すべてのツール呼び出しをゲートするには、代わりに [`PreToolUse` フック](/ja/agent-sdk/hooks) を使用します。916関数は、インタラクティブな権限プロンプトの SDK 置き換えです。[権限評価フロー](/ja/agent-sdk/permissions#how-permissions-are-evaluated) がプロンプトに解決される場合にのみ呼び出されます。`allowedTools` エントリ、設定許可ルール、または `acceptEdits` や `bypassPermissions` などの権限モードによって既に承認されたツール呼び出しは、それを呼び出しません。`AskUserQuestion`、[`requiresUserInteraction`](/ja/mcp#require-approval-for-a-specific-tool) とマークされた MCP ツール、および [組織が `ask` に設定](/ja/mcp#organization-controls-on-connector-tools) したコネクタツールは、許可ルールが一致する場合でも関数に到達します。`dontAsk` モードではこれらの呼び出しは代わりに拒否されます。すべてのツール呼び出しをゲートするには、代わりに [`PreToolUse` フック](/ja/agent-sdk/hooks) を使用します。

917 917 

918```typescript theme={null}918```typescript theme={null}

919type CanUseTool = (919type CanUseTool = (

1123 | SDKTaskProgressMessage1123 | SDKTaskProgressMessage

1124 | SDKTaskUpdatedMessage1124 | SDKTaskUpdatedMessage

1125 | SDKBackgroundTasksChangedMessage1125 | SDKBackgroundTasksChangedMessage

1126 | SDKThinkingTokensMessage

1126 | SDKSessionStateChangedMessage1127 | SDKSessionStateChangedMessage

1127 | SDKWorkerShuttingDownMessage1128 | SDKWorkerShuttingDownMessage

1128 | SDKCommandsChangedMessage1129 | SDKCommandsChangedMessage

1183 1184 

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

1185 1186 

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

1188 

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

1190 

1186<h3 id="sdkusermessagereplay">1191<h3 id="sdkusermessagereplay">

1187 `SDKUserMessageReplay`1192 `SDKUserMessageReplay`

1188</h3>1193</h3>

1203};1208};

1204```1209```

1205 1210 

1211セッション外から注入されたユーザーターン（[`origin`](#sdkmessageorigin) の種類が `peer` または `channel` であるもの）は、アクティブなターン中に配信されたか、セッションがアイドル状態の間に新しいターンを開始したかに関わらず、ストリームに再生として到達します。{/* min-version: 2.1.207 */}v2.1.207 より前では、セッションがアイドル状態の間に配信された注入されたターンはストリーム上にメッセージを生成せず、トランスクリプトを再読み込みするときにのみ表示されました。

1212 

1206<h3 id="sdkresultmessage">1213<h3 id="sdkresultmessage">

1207 `SDKResultMessage`1214 `SDKResultMessage`

1208</h3>1215</h3>

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

1266* `ttft_ms`：最初のトークンまでの時間（ミリ秒）。最初の完全なアシスタントメッセージが到着したときに測定されます。成功の場合のみ存在します。1273* `ttft_ms`：最初のトークンまでの時間（ミリ秒）。最初の完全なアシスタントメッセージが到着したときに測定されます。成功の場合のみ存在します。

1267* `ttft_stream_ms`：最初の `message_start` ストリームイベントまでの時間（ミリ秒）。レスポンスストリームが開くときです。`ttft_ms` より低く、2 つの間のギャップは最初のメッセージをストリーミングするのに費やされた時間です。成功の場合のみ存在します。1274* `ttft_stream_ms`：最初の `message_start` ストリームイベントまでの時間（ミリ秒）。レスポンスストリームが開くときです。`ttft_ms` より低く、2 つの間のギャップは最初のメッセージをストリーミングするのに費やされた時間です。成功の場合のみ存在します。

1268* `terminal_reason`：ループが終了した理由。`"completed"`、`"max_turns"`、`"tool_deferred"`、`"aborted_streaming"`、`"aborted_tools"`、`"hook_stopped"`、`"stop_hook_prevented"`、`"blocking_limit"`、`"rapid_refill_breaker"`、`"prompt_too_long"`、`"image_error"`、または `"model_error"` のいずれかです。1275* `terminal_reason`：ループが終了した理由。`"completed"`、`"max_turns"`、`"tool_deferred"`、`"aborted_streaming"`、`"aborted_tools"`、`"hook_stopped"`、`"stop_hook_prevented"`、`"background_requested"`、`"blocking_limit"`、`"rapid_refill_breaker"`、`"prompt_too_long"`、`"image_error"`、`"model_error"`、`"api_error"`、`"malformed_tool_use_exhausted"`、`"budget_exhausted"`、`"structured_output_retry_exhausted"`、`"tool_deferred_unavailable"`、または `"turn_setup_failed"` のいずれかです。

1269* `fast_mode_state`：`"on"`、`"off"`、または `"cooldown"` のいずれかです。1276* `fast_mode_state`：`"on"`、`"off"`、または `"cooldown"` のいずれかです。

1270 1277 

1271`origin` フィールドは、この結果をトリガーしたユーザーメッセージの [`SDKMessageOrigin`](#sdkmessageorigin) を転送します。バックグラウンドタスクが完了し、SDK が合成フォローアップターンを注入する場合、結果の `SDKResultMessage` は `origin: { kind: "task-notification" }` を持ちます。このフィールドをチェックして、プロンプトに答える結果とバックグラウンドタスクのフォローアップで発行される結果を区別し、後者をルーティングまたは抑制できます。このフィールドは、スタートアップエラーなど、ユーザーターンの前に発行される結果には存在しません。1278`origin` フィールドは、この結果をトリガーしたユーザーメッセージの [`SDKMessageOrigin`](#sdkmessageorigin) を転送します。バックグラウンドタスクが完了し、SDK が合成フォローアップターンを注入する場合、結果の `SDKResultMessage` は `origin: { kind: "task-notification" }` を持ちます。このフィールドをチェックして、プロンプトに答える結果とバックグラウンドタスクのフォローアップで発行される結果を区別し、後者をルーティングまたは抑制できます。このフィールドは、スタートアップエラーなど、ユーザーターンの前に発行される結果には存在しません。

2034type AgentInput = {2041type AgentInput = {

2035 description: string;2042 description: string;

2036 prompt: string;2043 prompt: string;

2037 subagent_type: string;2044 subagent_type?: string;

2038 model?: "sonnet" | "opus" | "haiku" | "fable";2045 model?: "sonnet" | "opus" | "haiku" | "fable";

2039 resume?: string;

2040 run_in_background?: boolean;2046 run_in_background?: boolean;

2041 max_turns?: number;

2042 name?: string;2047 name?: string;

2043 mode?: "acceptEdits" | "bypassPermissions" | "default" | "dontAsk" | "plan";2048 mode?: "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan";

2044 isolation?: "worktree";2049 isolation?: "worktree";

2045};2050};

2046```2051```

2075```typescript theme={null}2080```typescript theme={null}

2076type BashInput = {2081type BashInput = {

2077 command: string;2082 command: string;

2078 timeout?: number;2083 timeout?: number; // milliseconds, max 600000; higher values are clamped to the max

2079 description?: string;2084 description?: string;

2080 run_in_background?: boolean;2085 run_in_background?: boolean;

2081 dangerouslyDisableSandbox?: boolean;2086 dangerouslyDisableSandbox?: boolean;

2492 | WorkflowOutput;2497 | WorkflowOutput;

2493```2498```

2494 2499 

2495<h3 id="agent-1">2500<h3 id="agent-2">

2496 Agent2501 Agent

2497</h3>2502</h3>

2498 2503 

2503 | {2508 | {

2504 status: "completed";2509 status: "completed";

2505 agentId: string;2510 agentId: string;

2506 content: Array<{ type: "text"; text: string }>;2511 agentType?: string;

2512 content: Array<{ type: "text"; text: string; citations?: unknown[] | null }>;

2507 resolvedModel?: string;2513 resolvedModel?: string;

2508 totalToolUseCount: number;2514 totalToolUseCount: number;

2509 totalDurationMs: number;2515 totalDurationMs: number;

2517 web_search_requests: number;2523 web_search_requests: number;

2518 web_fetch_requests: number;2524 web_fetch_requests: number;

2519 } | null;2525 } | null;

2520 service_tier: ("standard" | "priority" | "batch") | null;2526 service_tier: string | null;

2521 cache_creation: {2527 cache_creation: {

2522 ephemeral_1h_input_tokens: number;2528 ephemeral_1h_input_tokens: number;

2523 ephemeral_5m_input_tokens: number;2529 ephemeral_5m_input_tokens: number;

2524 } | null;2530 } | null;

2531 inference_geo?: string | null;

2532 speed?: string | null;

2533 iterations?: unknown;

2534 };

2535 toolStats?: {

2536 readCount: number;

2537 searchCount: number;

2538 bashCount: number;

2539 editFileCount: number;

2540 linesAdded: number;

2541 linesRemoved: number;

2542 otherToolCount: number;

2543 frameCount?: number;

2525 };2544 };

2526 prompt: string;2545 prompt: string;

2546 worktreePath?: string;

2547 worktreeBranch?: string;

2527 }2548 }

2528 | {2549 | {

2529 status: "async_launched";2550 status: "async_launched";

2551 isAsync?: true;

2530 agentId: string;2552 agentId: string;

2531 description: string;2553 description: string;

2532 resolvedModel?: string;2554 resolvedModel?: string;

2535 canReadOutputFile?: boolean;2557 canReadOutputFile?: boolean;

2536 }2558 }

2537 | {2559 | {

2538 status: "sub_agent_entered";2560 status: "remote_launched";

2561 taskId: string;

2562 sessionUrl: string;

2539 description: string;2563 description: string;

2540 message: string;2564 prompt: string;

2565 outputFile: string;

2541 };2566 };

2542```2567```

2543 2568 

2544サブエージェントからの結果を返します。`status` フィールドで判別されます：完了したタスクの場合は `"completed"`、バックグラウンドタスクの場合は `"async_launched"`、インタラクティブサブエージェントの場合は `"sub_agent_entered"`。2569サブエージェントからの結果を返します。`status` フィールドで判別されます：完了したタスクの場合は `"completed"`、バックグラウンドタスクの場合は `"async_launched"`、Claude Code がリモートクラウドセッションにディスパッチしたタスクの場合は `"remote_launched"`。`sessionUrl` はそのセッションにリンクし、`taskId` はそれを識別します。

2545 2570 

2546`completed` および `async_launched` バリアントの `resolvedModel` フィールドは、サブエージェントが実際に実行されたモデルに名前を付けます。これは、[`availableModels`](/ja/model-config#restrict-model-selection) または別のオーバーライドが適用される場合、要求された `model` 入力と異なる場合があります。{/* min-version: 2.1.174 */}このフィールドには Claude Code v2.1.174 以降が必要です。2571`completed` および `async_launched` バリアントの `resolvedModel` フィールドは、サブエージェントが実際に実行されたモデルに名前を付けます。これは、[`availableModels`](/ja/model-config#restrict-model-selection) または別のオーバーライドが適用される場合、要求された `model` 入力と異なる場合があります。{/* min-version: 2.1.174 */}このフィールドには Claude Code v2.1.174 以降が必要です。

2547 2572 

2548<h3 id="askuserquestion-1">2573`completed` バリアントでは、サブエージェントが分離された git worktree で実行された場合に `worktreePath` が設定され、Claude Code がそれを作成した場合に `worktreeBranch` はその worktree のブランチに名前を付けます。`usage.service_tier` は、API がサブエージェントのリクエストに対して報告したサービスティア文字列を保持します。

2574 

2575v2.1.207 より前では、公開された型はより狭いものでした。`worktreePath`、`worktreeBranch`、`citations`、`toolStats.frameCount`、および `inference_geo`、`speed`、`iterations` 使用フィールドを省略し、`service_tier` を `"standard" | "priority" | "batch"` として型付けしていました。型がオプションとしてマークするフィールドは、以前のバージョンで記録された結果に存在しない場合があります。

2576 

2577<h3 id="askuserquestion-2">

2549 AskUserQuestion2578 AskUserQuestion

2550</h3>2579</h3>

2551 2580 

2566 2595 

2567質問とユーザーの回答を返します。`response` はユーザーが構造化された質問に答える代わりに自由形式の返信を入力した場合に設定されます。存在する場合、Claude は質問ごとの回答リストの代わりに「ユーザーが応答しました：…」を受け取ります。2596質問とユーザーの回答を返します。`response` はユーザーが構造化された質問に答える代わりに自由形式の返信を入力した場合に設定されます。存在する場合、Claude は質問ごとの回答リストの代わりに「ユーザーが応答しました：…」を受け取ります。

2568 2597 

2569<h3 id="bash-1">2598<h3 id="bash-2">

2570 Bash2599 Bash

2571</h3>2600</h3>

2572 2601 

2591 2620 

2592stdout/stderr が分割されたコマンド出力を返します。バックグラウンドコマンドには `backgroundTaskId` が含まれます。2621stdout/stderr が分割されたコマンド出力を返します。バックグラウンドコマンドには `backgroundTaskId` が含まれます。

2593 2622 

2594<h3 id="monitor-1">2623<h3 id="monitor-2">

2595 Monitor2624 Monitor

2596</h3>2625</h3>

2597 2626 

2607 2636 

2608実行中のモニターのバックグラウンドタスク ID を返します。この ID を `TaskStop` で使用して、ウォッチを早期にキャンセルします。2637実行中のモニターのバックグラウンドタスク ID を返します。この ID を `TaskStop` で使用して、ウォッチを早期にキャンセルします。

2609 2638 

2610<h3 id="edit-1">2639<h3 id="edit-2">

2611 Edit2640 Edit

2612</h3>2641</h3>

2613 2642 

2641 2670 

2642編集操作の構造化された diff を返します。2671編集操作の構造化された diff を返します。

2643 2672 

2644<h3 id="read-1">2673<h3 id="read-2">

2645 Read2674 Read

2646</h3>2675</h3>

2647 2676 

2701 2730 

2702ファイルタイプに適切な形式でファイルコンテンツを返します。`type` フィールドで判別されます。2731ファイルタイプに適切な形式でファイルコンテンツを返します。`type` フィールドで判別されます。

2703 2732 

2704<h3 id="write-1">2733<h3 id="write-2">

2705 Write2734 Write

2706</h3>2735</h3>

2707 2736 

2733 2762 

2734構造化された diff 情報を含む書き込み結果を返します。2763構造化された diff 情報を含む書き込み結果を返します。

2735 2764 

2736<h3 id="glob-1">2765<h3 id="glob-2">

2737 Glob2766 Glob

2738</h3>2767</h3>

2739 2768 

2750 2779 

2751glob パターンに一致するファイルパスを返します。変更時刻でソートされます。2780glob パターンに一致するファイルパスを返します。変更時刻でソートされます。

2752 2781 

2753<h3 id="grep-1">2782<h3 id="grep-2">

2754 Grep2783 Grep

2755</h3>2784</h3>

2756 2785 

2771 2800 

2772検索結果を返します。形状は `mode` によって異なります：ファイルリスト、マッチを含むコンテンツ、またはマッチ数。2801検索結果を返します。形状は `mode` によって異なります：ファイルリスト、マッチを含むコンテンツ、またはマッチ数。

2773 2802 

2774<h3 id="taskstop-1">2803<h3 id="taskstop-2">

2775 TaskStop2804 TaskStop

2776</h3>2805</h3>

2777 2806 

2788 2817 

2789バックグラウンドタスクを停止した後の確認を返します。2818バックグラウンドタスクを停止した後の確認を返します。

2790 2819 

2791<h3 id="notebookedit-1">2820<h3 id="notebookedit-2">

2792 NotebookEdit2821 NotebookEdit

2793</h3>2822</h3>

2794 2823 

2810 2839 

2811元のファイルと更新されたファイルコンテンツを含むノートブック編集の結果を返します。2840元のファイルと更新されたファイルコンテンツを含むノートブック編集の結果を返します。

2812 2841 

2813<h3 id="webfetch-1">2842<h3 id="webfetch-2">

2814 WebFetch2843 WebFetch

2815</h3>2844</h3>

2816 2845 

2829 2858 

2830HTTP ステータスとメタデータを含む取得されたコンテンツを返します。2859HTTP ステータスとメタデータを含む取得されたコンテンツを返します。

2831 2860 

2832<h3 id="websearch-1">2861<h3 id="websearch-2">

2833 WebSearch2862 WebSearch

2834</h3>2863</h3>

2835 2864 

2851 2880 

2852ウェブからの検索結果を返します。2881ウェブからの検索結果を返します。

2853 2882 

2854<h3 id="workflow-1">2883<h3 id="workflow-2">

2855 Workflow2884 Workflow

2856</h3>2885</h3>

2857 2886 

2881| `scriptPath` | `string` | この実行のために永続化されたワークフロースクリプトへのパス。編集して `scriptPath` として戻すことで、スクリプトを再送信せずに再実行できます |2910| `scriptPath` | `string` | この実行のために永続化されたワークフロースクリプトへのパス。編集して `scriptPath` として戻すことで、スクリプトを再送信せずに再実行できます |

2882| `error` | `string` | スクリプトが構文チェックに失敗した場合に設定されます。存在する場合、`async_launched` ステータスにもかかわらず実行は開始されませんでした |2911| `error` | `string` | スクリプトが構文チェックに失敗した場合に設定されます。存在する場合、`async_launched` ステータスにもかかわらず実行は開始されませんでした |

2883 2912 

2884<h3 id="todowrite-1">2913<h3 id="todowrite-2">

2885 TodoWrite2914 TodoWrite

2886</h3>2915</h3>

2887 2916 

2908 TypeScript Agent SDK 0.3.142 以降、`TodoWrite` はデフォルトで無効になっています。代わりに `TaskCreate`、`TaskGet`、`TaskUpdate`、および `TaskList` を使用してください。[タスクツールへの移行](/ja/agent-sdk/todo-tracking#migrate-to-task-tools)を参照して、監視コードを更新するか、`CLAUDE_CODE_ENABLE_TASKS=0` を設定して `TodoWrite` に戻してください。2937 TypeScript Agent SDK 0.3.142 以降、`TodoWrite` はデフォルトで無効になっています。代わりに `TaskCreate`、`TaskGet`、`TaskUpdate`、および `TaskList` を使用してください。[タスクツールへの移行](/ja/agent-sdk/todo-tracking#migrate-to-task-tools)を参照して、監視コードを更新するか、`CLAUDE_CODE_ENABLE_TASKS=0` を設定して `TodoWrite` に戻してください。

2909</Note>2938</Note>

2910 2939 

2911<h3 id="taskcreate-1">2940<h3 id="taskcreate-2">

2912 TaskCreate2941 TaskCreate

2913</h3>2942</h3>

2914 2943 

2925 2954 

2926割り当てられた ID を持つ作成されたタスクを返します。2955割り当てられた ID を持つ作成されたタスクを返します。

2927 2956 

2928<h3 id="taskupdate-1">2957<h3 id="taskupdate-2">

2929 TaskUpdate2958 TaskUpdate

2930</h3>2959</h3>

2931 2960 

2946 2975 

2947更新結果を返します。どのフィールドが変更されたかを含みます。2976更新結果を返します。どのフィールドが変更されたかを含みます。

2948 2977 

2949<h3 id="taskget-1">2978<h3 id="taskget-2">

2950 TaskGet2979 TaskGet

2951</h3>2980</h3>

2952 2981 

2967 2996 

2968完全なタスクレコードを返します。ID が見つからない場合は `null` を返します。2997完全なタスクレコードを返します。ID が見つからない場合は `null` を返します。

2969 2998 

2970<h3 id="tasklist-1">2999<h3 id="tasklist-2">

2971 TaskList3000 TaskList

2972</h3>3001</h3>

2973 3002 

2987 3016 

2988現在のリスト内のすべてのタスクのスナップショットを返します。3017現在のリスト内のすべてのタスクのスナップショットを返します。

2989 3018 

2990<h3 id="exitplanmode-1">3019<h3 id="exitplanmode-2">

2991 ExitPlanMode3020 ExitPlanMode

2992</h3>3021</h3>

2993 3022 

3006 3035 

3007計画モード終了後の計画状態を返します。3036計画モード終了後の計画状態を返します。

3008 3037 

3009<h3 id="listmcpresources-1">3038<h3 id="listmcpresources-2">

3010 ListMcpResources3039 ListMcpResources

3011</h3>3040</h3>

3012 3041 

3024 3053 

3025利用可能な MCP リソースの配列を返します。3054利用可能な MCP リソースの配列を返します。

3026 3055 

3027<h3 id="readmcpresource-1">3056<h3 id="readmcpresource-2">

3028 ReadMcpResource3057 ReadMcpResource

3029</h3>3058</h3>

3030 3059 

3042 3071 

3043要求された MCP リソースのコンテンツを返します。3072要求された MCP リソースのコンテンツを返します。

3044 3073 

3045<h3 id="enterworktree-1">3074<h3 id="enterworktree-2">

3046 EnterWorktree3075 EnterWorktree

3047</h3>3076</h3>

3048 3077 

3538 3567 

3539フックが実行を開始したときに発行されます。3568フックが実行を開始したときに発行されます。

3540 3569 

3570Claude Code は、このメッセージ、[`SDKHookProgressMessage`](#sdkhookprogressmessage)、および [`SDKHookResponseMessage`](#sdkhookresponsemessage) をメッセージストリームに直ちに配信します。これは、セッション起動中に `SessionStart` または `Setup` フックがまだ実行中であっても含まれます。Claude Code v2.1.169 から v2.1.203 は、`SessionStart` または `Setup` フックが完了した後、これらのメッセージを 1 つのバッチで配信していました。v2.1.204 はライブ配信を復元しました。

3571 

3541```typescript theme={null}3572```typescript theme={null}

3542type SDKHookStartedMessage = {3573type SDKHookStartedMessage = {

3543 type: "system";3574 type: "system";

3725};3756};

3726```3757```

3727 3758 

3759<h3 id="sdkthinkingtokensmessage">

3760 `SDKThinkingTokensMessage`

3761</h3>

3762 

3763Claude が思考ブロック（編集されたものを含む）を生成している間に発行され、これまでに生成された思考トークンの実行中の推定値を含みます。`estimated_tokens` は現在の思考ブロックの実行合計で、`estimated_tokens_delta` はこのフレームで実行された増分です。進捗表示に使用してください。トップレベルエージェントループの最終カウントは結果メッセージの `usage.output_tokens` です。これは [サブエージェントトークンを含みません](/ja/agent-sdk/cost-tracking#get-the-total-cost-of-a-query)。全体のツリーアカウンティングには [`modelUsage`](#modelusage) を使用してください。

3764 

3765{/* min-version: 2.1.153 */}Claude Code v2.1.153 以降が必要です。

3766 

3767```typescript theme={null}

3768type SDKThinkingTokensMessage = {

3769 type: "system";

3770 subtype: "thinking_tokens";

3771 estimated_tokens: number;

3772 estimated_tokens_delta: number;

3773 uuid: UUID;

3774 session_id: string;

3775};

3776```

3777 

3728<h3 id="sdkfilespersistedevent">3778<h3 id="sdkfilespersistedevent">

3729 `SDKFilesPersistedEvent`3779 `SDKFilesPersistedEvent`

3730</h3>3780</h3>

3976 サンドボックス外コマンドのパーミッションフォールバック4026 サンドボックス外コマンドのパーミッションフォールバック

3977</h3>4027</h3>

3978 4028 

3979`allowUnsandboxedCommands` が有効な場合、モデルはツール入力で `dangerouslyDisableSandbox: true` を設定することで、サンドボックス外でコマンドを実行するようにリクエストできます。これらのリクエストは既存のパーミッションシステムにフォールバックします。つまり、`canUseTool` ハンドラーが呼び出され、カスタム認可ロジックを実装できます。4029`allowUnsandboxedCommands` が有効な場合、モデルはツール入力で `dangerouslyDisableSandbox: true` を設定することで、サンドボックス外でコマンドを実行するようにリクエストできます。これらのリクエストは既存のパーミッションシステムにフォールバックします。つまり、`canUseTool` ハンドラーが呼び出され、カスタム認可ロジックを実装できます。下の例では、`isCommandAuthorized` は定義する認可チェックの代わりです。

3980 4030 

3981<Note>4031<Note>

3982 **`excludedCommands` vs `allowUnsandboxedCommands`：**4032 **`excludedCommands` vs `allowUnsandboxedCommands`：**

49 49 

50<Warning>50<Warning>

51 **コールバックは自動承認されたツールに対しては発火しません。** [許可評価フロー](/ja/agent-sdk/permissions#how-permissions-are-evaluated)の前の段階での承認、許可ルール、または `acceptEdits` や `bypassPermissions` のようなモードは、`canUseTool` が参照される前に呼び出しを解決します。`allowed_tools` にツールをそのまま列挙する場合、そのツールに対する `canUseTool` チェックは、ask ルールまたは `plan` モードが呼び出しをプロンプトに戻さない限り実行されません。すべてのツール呼び出しに適用する必要があるロジックについては、[`PreToolUse` フック](/ja/agent-sdk/hooks)を使用してください。このフックはフローの残りの部分の前に実行され、リクエストを許可、拒否、または変更できます。51 **コールバックは自動承認されたツールに対しては発火しません。** [許可評価フロー](/ja/agent-sdk/permissions#how-permissions-are-evaluated)の前の段階での承認、許可ルール、または `acceptEdits` や `bypassPermissions` のようなモードは、`canUseTool` が参照される前に呼び出しを解決します。`allowed_tools` にツールをそのまま列挙する場合、そのツールに対する `canUseTool` チェックは、ask ルールまたは `plan` モードが呼び出しをプロンプトに戻さない限り実行されません。すべてのツール呼び出しに適用する必要があるロジックについては、[`PreToolUse` フック](/ja/agent-sdk/hooks)を使用してください。このフックはフローの残りの部分の前に実行され、リクエストを許可、拒否、または変更できます。

52 

53 `AskUserQuestion`、[`requiresUserInteraction`](/ja/mcp#require-approval-for-a-specific-tool)とマークされた MCP ツール、および [組織が `ask` に設定したコネクタツール](/ja/mcp#organization-controls-on-connector-tools)は、許可ルールが一致する場合でもコールバックに到達します。`dontAsk` モードではこれらの呼び出しは代わりに拒否され、コールバックは呼び出されません。

52</Warning>54</Warning>

53 55 

54また、[`PermissionRequest` フック](/ja/agent-sdk/hooks#available-hooks)を使用して、Claude が承認を待っているときに外部通知（Slack、メール、プッシュ）を送信することもできます。56また、[`PermissionRequest` フック](/ja/agent-sdk/hooks#available-hooks)を使用して、Claude が承認を待っているときに外部通知（Slack、メール、プッシュ）を送信することもできます。

214| **許可** | `PermissionResultAllow(updated_input=...)` | `{ behavior: "allow", updatedInput }` |216| **許可** | `PermissionResultAllow(updated_input=...)` | `{ behavior: "allow", updatedInput }` |

215| **拒否** | `PermissionResultDeny(message=...)` | `{ behavior: "deny", message }` |217| **拒否** | `PermissionResultDeny(message=...)` | `{ behavior: "deny", message }` |

216 218 

217許可する場合、ツール入力（元の、または変更された）を渡します。拒否する場合、理由を説明するメッセージを提供します。Claude はこのメッセージを見て、アプローチを調整する可能性があります。219許可する場合、Claude がリクエストした入力でツールが実行されます。ただし、変更された入力を返す場合は、TypeScript では `updatedInput`、Python では `updated_input` を返すことができます。{/* min-version: 2.1.207 */}v2.1.207 より前では、Claude Code は `updatedInput` を省略した許可結果を拒否し、検証エラーでツール呼び出しを拒否していました。

220 

221拒否する場合、理由を説明するメッセージを提供します。Claude はこのメッセージを見て、アプローチを調整する可能性があります。

218 222 

219<CodeGroup>223<CodeGroup>

220 ```python Python theme={null}224 ```python Python theme={null}

249 249 

250表示設定オプションについては、[表示モードを選択](#choose-a-display-mode) を参照してください。チームメンバーのメッセージはリーダーに自動的に到着します。250表示設定オプションについては、[表示モードを選択](#choose-a-display-mode) を参照してください。チームメンバーのメッセージはリーダーに自動的に到着します。

251 251 

252各エージェントのメールボックスは `~/.claude/teams/{team-name}/inboxes/{agent-name}.json` にある JSON ファイルです。Claude Code はメールボックスファイルを読み取るときにすべてのエントリを検証します。メッセージ形式と一致しないエントリはエラーとして報告され、ファイルから削除されます。有効なメッセージは引き続き配信されます。v2.1.207 より前では、1 つの不正なメールボックスエントリが毎秒繰り返しエラーを引き起こし、ファイルを手動で削除するまでそのメールボックスの配信をブロックしていました。

253 

252システムはタスク依存関係を自動的に管理します。チームメンバーが他のタスクが依存するタスクを完了すると、ブロックされたタスクは手動介入なしにブロック解除されます。254システムはタスク依存関係を自動的に管理します。チームメンバーが他のタスクが依存するタスクを完了すると、ブロックされたタスクは手動介入なしにブロック解除されます。

253 255 

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

290 292 

291チームメンバーはリーダーの権限設定で開始します。リーダーが `--dangerously-skip-permissions` で実行する場合、すべてのチームメンバーも同様に実行します。生成後、個別のチームメンバーモードを変更できますが、生成時にチームメンバーごとのモードを設定することはできません。293チームメンバーはリーダーの権限設定で開始します。リーダーが `--dangerously-skip-permissions` で実行する場合、すべてのチームメンバーも同様に実行します。生成後、個別のチームメンバーモードを変更できますが、生成時にチームメンバーごとのモードを設定することはできません。

292 294 

2931 つのエージェントが `SendMessage` 経由で別のエージェントにメッセージを送信する場合、受信エージェントには、あなたからではなく別の Claude セッションから来たことが通知されます。チームメンバーは権限プロンプトを承認したり、あなたに代わって同意を提供したりすることはできません。また、アクションが拒否されたチームメンバーは、チェックをバイパスするために別のチームメンバーにそれをリレーすることはできません。[auto mode](/ja/permission-modes#eliminate-prompts-with-auto-mode) では、別のエージェントからリレーされた承認クレームは、あなたからの確認ではなく、信頼できない入力として分類器によって扱われます。チームメンバーの権限プロンプトはリーダーセッションにバブルアップするため、そこで自分で承認してください。2951 つのエージェントが `SendMessage` 経由で別のエージェントにメッセージを送信する場合、受信エージェントには、あなたからではなく別の Claude セッションから来たことが通知されます。チームメンバーは権限プロンプトを承認したり、あなたに代わって同意を提供したりすることはできません。また、アクションが拒否されたチームメンバーは、チェックをバイパスするために別のチームメンバーにそれをリレーすることはできません。[auto mode](/ja/permission-modes#eliminate-prompts-with-auto-mode) では、別のエージェントからリレーされた承認クレームは、あなたからの確認ではなく、信頼できない入力として分類器によって扱われます。

296 

297チームメンバーの権限プロンプトはリーダーセッションに表示されるため、そこで自分で承認してください。[プラン承認を要求する](#require-plan-approval-for-teammates) は設計された例外です。リーダーセッションはあなたへの別のプロンプトなしにチームメンバープラン承認を付与します。

294 298 

295<h3 id="context-and-communication">299<h3 id="context-and-communication">

296 コンテキストと通信300 コンテキストと通信

70 70 

71`claude agents` を `claude` の代わりにプライマリエントリーポイントとして使用できます。エージェントビューからすべてのタスクをディスパッチし、フル会話が必要な場合はアタッチし、`←` を押してテーブルに戻ります。71`claude agents` を `claude` の代わりにプライマリエントリーポイントとして使用できます。エージェントビューからすべてのタスクをディスパッチし、フル会話が必要な場合はアタッチし、`←` を押してテーブルに戻ります。

72 72 

73{/* min-version: 2.1.205 */}通常の `claude` セッション内では、プロンプトフッターの `←` ヒントは、`← 2 agents` のように入力を待機中のバックグラウンドエージェントの数をカウントし、入力が必要なエージェントがない場合は `← for agents` に戻ります。99 を超えるカウントは `99+` として表示されます。カウントはターミナルがフォーカスされている間は約 10 秒ごとに更新され、フォーカスが戻ると即座に更新されます。カウントが移動したときとエージェントが完了したときに色が一時的に変わります。ただし、[`prefersReducedMotion` 設定](/ja/settings#available-settings)がオンの場合は除きます。また、[スクリーンリーダーモード](/ja/accessibility)では非表示になります。[Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry](/ja/third-party-integrations)では、ヒントはカウントなしの通常の `← for agents` 形式のままです。Claude Code v2.1.205 以降が必要です。

74 

73<h2 id="monitor-sessions-with-agent-view">75<h2 id="monitor-sessions-with-agent-view">

74 エージェントビューでセッションを監視する76 エージェントビューでセッションを監視する

75</h2>77</h2>

76 78 

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

78 80 

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

80 82 

149 151 

150各行の 1 行の概要は [Haiku クラスモデル](/ja/model-config) によって生成されるため、トランスクリプトを開かずにセッションが何をしているか、何が必要か、または何を生成したかを伝えることができます。セッションがアクティブに作業している間、行テキストはセッション自身の最近の出力から最大 15 秒ごとに 1 回更新され、モデルリクエストを送信せず、各ターンが終了したときに新しい概要を書きます。152各行の 1 行の概要は [Haiku クラスモデル](/ja/model-config) によって生成されるため、トランスクリプトを開かずにセッションが何をしているか、何が必要か、または何を生成したかを伝えることができます。セッションがアクティブに作業している間、行テキストはセッション自身の最近の出力から最大 15 秒ごとに 1 回更新され、モデルリクエストを送信せず、各ターンが終了したときに新しい概要を書きます。

151 153 

152作業中の行はセッションが何をしているかを示し、ブロックされた行は質問を示します。長いターンの間、モデルは約 1 分ごとに概要を書き直し、各書き直しの後に 2 倍待機して最大 4 分まで待機するため、ビジーな行は古い概要を表示し続けません。テキストは 64 列で切り詰められます。[ピークパネル](#peek-and-reply) を開いて文全体を読みます。v2.1.205 より前では、作業中の行は生のツール呼び出しの代わりにレポートを表示でき、並列作業項目を実行しているセッションはテキストの前に `2/5` などの `done/total` カウントを表示していました。154作業中の行はセッションが何をしているかを示し、ブロックされた行は質問を示します。長いターンの間、モデルは約 1 分ごとに概要を書き直し、各書き直しの後に 2 倍待機して最大 4 分まで待機するため、ビジーな行は古い概要を表示し続けません。概要テキストは行の残りの幅を埋め、ターミナルの右端でのみ切り詰められます。[ピークパネル](#peek-and-reply) を開いてエッジが切り詰める文を読みます。v2.1.205 より前では、作業中の行は生のツール呼び出しの代わりにレポートを表示でき、並列作業項目を実行しているセッションはテキストの前に `2/5` などの `done/total` カウントを表示していました。

155 

156概要テキストは行の残りの幅を埋め、ターミナルの右端でのみ切り詰められます。[ピークパネル](#peek-and-reply) を開いてエッジが切り詰める文を読みます。v2.1.206 より前では、テキストはターミナル幅に関係なく 64 列で切り詰められていました。

153 157 

154リストが [ディレクトリでグループ化](#organize-the-list) されている場合、概要はセッションの状態を色付きの単語で開きます。例えば `Needs input · double jump or wall climb?` のようになります。デフォルトの状態グループ化では、グループヘッダーはすでに状態を名前付けするため、行は概要のみを表示します。v2.1.205 より前では、ディレクトリでグループ化された行は状態の単語を持ちませんでした。158リストが [ディレクトリでグループ化](#organize-the-list) されている場合、概要はセッションの状態を色付きの単語で開きます。例えば `Needs input · double jump or wall climb?` のようになります。デフォルトの状態グループ化では、グループヘッダーはすでに状態を名前付けするため、行は概要のみを表示します。v2.1.205 より前では、ディレクトリでグループ化された行は状態の単語を持ちませんでした。

155 159 

184 ピーク表示と返信188 ピーク表示と返信

185</h3>189</h3>

186 190 

187選択した行で `Space` を押してピークパネルを開きます。セッションの完全なステータス文で開き、行が切り詰める部分と、変更されてからの経過時間、その後にセッションにリンクされたプルリクエストが続きます。入力を待機しているセッションの場合、尋ねている正確な質問も返信入力の上に表示されます。ほとんどの場合、ピークパネルで十分であり、フルトランスクリプトを開く必要はありません。191選択した行で `Space` を押してピークパネルを開きます。行が切り詰める文で開き、どの文かはセッションの状態によって異なります：

192 

193* あなたを待機しているセッション：尋ねている正確な質問。返信入力の上に表示されます

194* 完了したセッション：その結果

195* 作業中のセッション：その完全なステータス文

196 

197セッションにリンクされたプルリクエストが次にリストされます。あなたを待機しているセッションの場合、`waiting 3m` のような行がそれらの下に表示され、待機時間を示します。これはパネルで表示される唯一の時間です。行の右端の経過時間は異なる数字です。セッションが開始されてからカウントされます。

198 

199ほとんどの場合、ピークパネルで十分であり、フルトランスクリプトを開く必要はありません。

188 200 

189v2.1.205 より前では、パネルはステータス文を繰り返すのは他に表示するものがない場合のみであり、最も長く実行されている並列作業項目を名前付けしていました。201v2.1.207 より前では、すべてのピークはステータス文と裸のタイムスタンプで開き、ブロックされたセッションの質問はそれらの下に同じタイムスタンプで 2 回目のプレフィックスで表示されました。

190 202 

191ピークパネルに返信を入力して `Enter` を押すと、そのセッションに送信されます。セッションが複数選択肢の質問をしている場合、ピークパネルはオプションを表示し、数字キーを押して 1 つを選択できます。他のブロックされたセッションの場合は、`Tab` を押して入力に提案された返信を入力し、送信前に編集できます。返信の前に `!` を付けて Bash コマンドを代わりに送信します。203ピークパネルに返信を入力して `Enter` を押すと、そのセッションに送信されます。セッションが複数選択肢の質問をしている場合、ピークパネルはオプションを表示し、数字キーを押して 1 つを選択できます。他のブロックされたセッションの場合は、`Tab` を押して入力に提案された返信を入力し、送信前に編集できます。返信の前に `!` を付けて Bash コマンドを代わりに送信します。

192 204 

205配信できない返信。バックグラウンドサービスに到達できないか、送信が失敗した場合、返信は保存され、そのプロセスが再度開始されるときにセッションの次のプロンプトとして送信されます。エラーメッセージは返信が保存されたことを示します。`!` でプレフィックスされた返信は保存されません。保存されたテキストはセッションにプレーンプロンプトとして到達するため、Bash コマンドとして実行されません。

206 

193[音声ディクテーション](/ja/voice-dictation) が有効な場合、返信入力がフォーカスされている間、プッシュトゥトークキーを押したままにするか、タップして返信をディクテーションします。これはエージェントビューの下部のディスパッチ入力でも同じように機能します。207[音声ディクテーション](/ja/voice-dictation) が有効な場合、返信入力がフォーカスされている間、プッシュトゥトークキーを押したままにするか、タップして返信をディクテーションします。これはエージェントビューの下部のディスパッチ入力でも同じように機能します。

194 208 

195`↑` と `↓` を使用してパネルを閉じずに隣接するセッションをピーク表示するか、`→` を使用してアタッチします。209`↑` と `↓` を使用してパネルを閉じずに隣接するセッションをピーク表示するか、`→` を使用してアタッチします。

200 214 

201選択した行で `Enter` または `→` を押してアタッチします。エージェントビューはフルインタラクティブセッションに置き換えられます。アタッチすると、Claude は不在中に何が起こったかの短い要約を投稿します。215選択した行で `Enter` または `→` を押してアタッチします。エージェントビューはフルインタラクティブセッションに置き換えられます。アタッチすると、Claude は不在中に何が起こったかの短い要約を投稿します。

202 216 

203アタッチ中、セッションは他の Claude Code セッションのように動作します。すべての [コマンド](/ja/commands)、キーボードショートカット、および機能が機能します。217アタッチ中、セッションは他の Claude Code セッションのように動作します。すべての [コマンド](/ja/commands)、キーボードショートカット、および機能が機能します。以下の例外があります。

218 

219バックグラウンドセッションは `/install-github-app` と [`/mcp`](/ja/mcp) 設定リスト（認証アクションを含む）を拒否します。アタッチされているか、ピークパネルから返信しているかに関係なく。メッセージは通常の `claude` セッションに指示し、`/mcp reconnect <server>`、`/mcp enable`、および `/mcp disable` は引き続き機能します。

204 220 

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

206 222 

241 257 

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

243 259 

260削除は、`Ctrl+X` で削除するか、シェルから [`claude rm`](#manage-sessions-from-the-shell) で削除するかに関係なく、[スーパーバイザーの](#the-supervisor-process) セッションリストからセッションをクリアするため、削除はスーパーバイザー再起動全体で保存されます。v2.1.206 より前では、スーパーバイザーが再起動中または到達不可能な間にセッションを削除すると、そのリストに残り、次のスーパーバイザーはそのプロセスを再開し、行を再度表示していました。

261 

262削除もセッションをクリアします。[スーパーバイザーの](#the-supervisor-process) セッションリストから。`Ctrl+X` で削除するか、シェルから [`claude rm`](#manage-sessions-from-the-shell) で削除するかに関係なく。削除はスーパーバイザー再起動全体で保存されます。v2.1.206 より前では、スーパーバイザーが再起動中または到達不可能な間にセッションを削除すると、そのリストに残り、次のスーパーバイザーはそのプロセスを再開し、行を再度表示していました。

263 

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

245 265 

246<h3 id="filter-sessions">266<h3 id="filter-sessions">

293 313 

294エージェントビューの下部の入力にプロンプトを入力して `Enter` を押すと、新しいバックグラウンドセッションが開始されます。セッションはプロンプトから自動的に名前が付けられます。後で `Ctrl+R` で名前を変更できます。314エージェントビューの下部の入力にプロンプトを入力して `Enter` を押すと、新しいバックグラウンドセッションが開始されます。セッションはプロンプトから自動的に名前が付けられます。後で `Ctrl+R` で名前を変更できます。

295 315 

316セッションが後で取得する名前は、その行にも表示されます。これには、そのセッションで [プランを承認](/ja/permission-modes#review-and-approve-a-plan) するときに Claude が導出する名前も含まれます。v2.1.207 より前は、プランを承認することで名前が付けられたバックグラウンドセッションは `/status` にその名前を表示していましたが、自分で名前を変更するまでエージェントビューの行には表示されていませんでした。

317 

296プロンプトに画像を貼り付けて、タスクにスクリーンショットまたは図を含めます。318プロンプトに画像を貼り付けて、タスクにスクリーンショットまたは図を含めます。

297 319 

320800 文字を超えるか 2 行以上の貼り付けられたテキストは `[Pasted text #N]` プレースホルダーに折りたたまれるため、入力は 1 行のままです。ディスパッチするときに完全なテキストが送信されます。{/* min-version: 2.1.207 */}ディスパッチする前に折りたたまれたテキストを確認または編集するには、同じテキストを再度貼り付けると、プレースホルダーが入力に展開されます。少なくとも 90 列幅のターミナルでは、貼り付け後数秒間、入力の下に `paste again to expand` リマインダーが表示されます。v2.1.207 より前は、同じテキストを再度貼り付けると、最初のプレースホルダーを展開する代わりに 2 番目のプレースホルダーが追加されていました。

321 

298プロンプトの一部をプレフィックスまたは言及してセッションの開始方法を制御します：322プロンプトの一部をプレフィックスまたは言及してセッションの開始方法を制御します：

299 323 

300| 入力 | 効果 |324| 入力 | 効果 |

445 469 

446フックが git リポジトリではないディレクトリで失敗した場合、セッションはそのディレクトリの分離をスキップし、作業ディレクトリを所定の位置で編集します。git リポジトリ内では、セッションが分離されるまで書き込みはブロックされたままです。v2.1.203 より前は、その状態のバックグラウンドセッションはファイルを編集できませんでした。すべての書き込みは分離されるまで拒否され、フックはそのディレクトリを分離できませんでした。470フックが git リポジトリではないディレクトリで失敗した場合、セッションはそのディレクトリの分離をスキップし、作業ディレクトリを所定の位置で編集します。git リポジトリ内では、セッションが分離されるまで書き込みはブロックされたままです。v2.1.203 より前は、その状態のバックグラウンドセッションはファイルを編集できませんでした。すべての書き込みは分離されるまで拒否され、フックはそのディレクトリを分離できませんでした。

447 471 

448エージェントビューでセッションを削除する（`Ctrl+X` を 2 回）と、Claude が作成したワークツリーが削除されます。コミットされていない変更を含めて削除されるため、保持したい変更をマージまたはプッシュしてから削除します。シェルから [`claude rm`](#manage-sessions-from-the-shell) で削除すると、コミットされていない変更があるワークツリーが保持され、そのパスが出力されるため、自分でクリーンアップできます。自分で作成したワークツリーとセッションを開始した場合は、どちらの方法でも所定の位置に残されます。472セッションを削除する方法によって、Claude が作成したワークツリーが削除されるか保持されるかが異なります：

473 

474* エージェントビューで `Ctrl+X` を 2 回で削除すると、コミットされていない変更を含めてワークツリーが削除されるため、保持したい変更をまずコミットしてください。

475* シェルから [`claude rm`](#manage-sessions-from-the-shell) で削除すると、コミットされていない変更があるワークツリーが保持され、セッション行と一緒に保持されます。

476* どちらのパスでも、どこかにプッシュされていないコミットがあるワークツリーは削除されません。ワークツリーは [セッションと一緒に保持](#organize-the-list) され、出力は保持されたパスと理由を名前付けします。

477* 自分で作成したワークツリーとセッションを開始した場合は、どちらの方法でも所定の位置に残されます。

449 478 

450セッションのワークツリーパスを見つけるには、セッションをピークするか、アタッチして作業ディレクトリを確認します。479セッションのワークツリーパスを見つけるには、セッションをピークするか、アタッチして作業ディレクトリを確認します。

451 480 

475各バックグラウンドセッションは異なるモデルで実行できます。1 つのセッションでオーバーライドするには：504各バックグラウンドセッションは異なるモデルで実行できます。1 つのセッションでオーバーライドするには：

476 505 

477* シェルから、`claude --bg` で `--model` を渡します。506* シェルから、`claude --bg` で `--model` を渡します。

478* 実行中のセッションにアタッチして、そこで `/model` を開き、モデルで `s` を押してそのセッションのみのモデルを切り替えます。セッションが再生成される場合、変更は保持されます。507* 実行中のセッションにアタッチして、そこで `/model` を実行します。ピッカーから選択するか、入力した `/model <name>` は、ピッカーで `s` を押してセッションのみの切り替えを行わない限り、新しいセッションのデフォルトとして保存されます。セッションが再生成される場合、セッションのみの切り替えは保持されます。

479* frontmatter が `model` フィールドを設定する [subagent](/ja/sub-agents) をディスパッチします。508* frontmatter が `model` フィールドを設定する [subagent](/ja/sub-agents) をディスパッチします。

480 509 

481<h3 id="permission-mode-model-and-effort">510<h3 id="permission-mode-model-and-effort">

484 513 

485バックグラウンドセッションは、そこで `claude` を開始した場合と同じように、実行されるディレクトリから [settings](/ja/settings) を読み取ります。これには、プロジェクト設定の [`env` values](/ja/settings#available-settings) が含まれるため、そこで設定された `ANTHROPIC_MODEL` またはプロバイダー変数がそのディレクトリのバックグラウンドセッションに適用されます。514バックグラウンドセッションは、そこで `claude` を開始した場合と同じように、実行されるディレクトリから [settings](/ja/settings) を読み取ります。これには、プロジェクト設定の [`env` values](/ja/settings#available-settings) が含まれるため、そこで設定された `ANTHROPIC_MODEL` またはプロバイダー変数がそのディレクトリのバックグラウンドセッションに適用されます。

486 515 

487`CLAUDE_CODE_USE_BEDROCK` または `CLAUDE_CODE_USE_VERTEX` などのクラウドプロバイダー選択、および `ANTHROPIC_DEFAULT_*_MODEL` エイリアスは、セッションをディスパッチしたシェルに従います。ゲートウェイ `ANTHROPIC_BASE_URL` はそのシェルで エクスポートされ、スーパーバイザーが同じゲートウェイ環境で実行され、セッションがディスパッチ元のディレクトリで実行されるか、`←` または `/background` でバックグラウンド化された独自のセッションである場合、`ANTHROPIC_CUSTOM_HEADERS` と一緒に従います。これは、エージェントビューを開くか、バックグラウンドセッションをディスパッチする最初のシェルがゲートウェイシェルである場合の通常のケースです。`@repo` または `--cwd` で別のディレクトリにディスパッチすると、シェルのゲートウェイは実行されません。そのプロジェクトの [settings](/ja/settings) がエンドポイントを提供します。バックグラウンドセッションがプロバイダー設定と認証情報をどのようにソースするかについては、[スーパーバイザープロセス](#the-supervisor-process) を参照してください。516`CLAUDE_CODE_USE_BEDROCK` または `CLAUDE_CODE_USE_VERTEX` などのクラウドプロバイダー選択、および `ANTHROPIC_DEFAULT_*_MODEL` エイリアスは、セッションをディスパッチしたシェルに従います。{/* min-version: 2.1.206 */}そのシェルで [`CLAUDE_CODE_EXTRA_BODY`](/ja/env-vars) リクエストボディオーバーライドをエクスポートする場合、それはセッションに同じ方法で到達します。v2.1.206 より前は、バックグラウンドワーカーはシェルでエクスポートされた `CLAUDE_CODE_EXTRA_BODY` を無視していました。

517 

518ディスパッチシェルでゲートウェイ `ANTHROPIC_BASE_URL` をエクスポートする場合、スーパーバイザーが同じゲートウェイ環境で実行され、セッションがディスパッチ元のディレクトリで実行されるか、`←` または `/background` でバックグラウンド化された独自のセッションである場合、`ANTHROPIC_CUSTOM_HEADERS` と一緒にセッションにも到達します。これは、エージェントビューを開くか、バックグラウンドセッションをディスパッチする最初のシェルがゲートウェイシェルである場合の通常のケースです。`@repo` または `--cwd` で別のディレクトリにディスパッチすると、シェルのゲートウェイは実行されません。そのプロジェクトの [settings](/ja/settings) がエンドポイントを提供します。バックグラウンドセッションがプロバイダー設定と認証情報をどのようにソースするかについては、[スーパーバイザープロセス](#the-supervisor-process) を参照してください。

488 519 

489[permission mode](/ja/permissions) は、セッションをどのように開始したかによって異なります。`/bg` または `←` でインタラクティブセッションをバックグラウンド化すると、現在の権限モードが保持されるため、`acceptEdits` または `auto` に切り替えたセッションはデタッチ後もそのモードのままです。エージェントビュー入力からディスパッチするか、シェルから `claude --bg` を実行すると、そのディレクトリの設定から `defaultMode` を使用するか、ディスパッチされた [subagent の frontmatter](/ja/sub-agents#supported-frontmatter-fields) から `permissionMode` を使用します。520[permission mode](/ja/permissions) は、セッションをどのように開始したかによって異なります。`/bg` または `←` でインタラクティブセッションをバックグラウンド化すると、現在の権限モードが保持されるため、`acceptEdits` または `auto` に切り替えたセッションはデタッチ後もそのモードのままです。エージェントビュー入力からディスパッチするか、シェルから `claude --bg` を実行すると、そのディレクトリの設定から `defaultMode` を使用するか、ディスパッチされた [subagent の frontmatter](/ja/sub-agents#supported-frontmatter-fields) から `permissionMode` を使用します。

490 521 

548| `claude stop <id>` | セッションを停止する。`claude kill` も受け入れます |579| `claude stop <id>` | セッションを停止する。`claude kill` も受け入れます |

549| `claude respawn <id>` | セッションを再開する。会話を保持したまま実行または停止状態から再開します。例えば、更新された Claude Code バイナリを取得するため |580| `claude respawn <id>` | セッションを再開する。会話を保持したまま実行または停止状態から再開します。例えば、更新された Claude Code バイナリを取得するため |

550| `claude respawn --all` | すべての実行中のセッションを再開する。例えば、すべてのセッションを一度に更新された Claude Code バイナリに移動するため |581| `claude respawn --all` | すべての実行中のセッションを再開する。例えば、すべてのセッションを一度に更新された Claude Code バイナリに移動するため |

551| `claude rm <id>` | セッションをリストから削除する。コミットされていない変更がない場合、セッション用に Claude が作成した worktree を削除します。それ以外の場合は、クリーンアップできるように worktree パスを出力します。自分で作成した worktree はそのままにしておきます。会話トランスクリプトはローカルマシンに保存され、`claude --resume` を通じて利用可能なままです |582| `claude rm <id>` | セッションをリストから削除する。コミットされていない変更がない場合、セッション用に Claude が作成した worktree を削除します。それ以外の場合は、セッションも保持され、コマンドは worktree パスと理由を出力するので、それを解決して `claude rm` を再度実行できます。自分で作成した worktree はそのままにしておきます。会話トランスクリプトはローカルマシンに保存され、`claude --resume` を通じて利用可能なままです |

552| `claude daemon status` | [supervisor](#the-supervisor-process) の状態、バージョン、ソケットディレクトリ、およびワーカー数を出力する |583| `claude daemon status` | [supervisor](#the-supervisor-process) の状態、バージョン、ソケットディレクトリ、およびワーカー数を出力する |

553| `claude daemon stop --any` | supervisor プロセスとそれがホストするバックグラウンドセッションを停止します。`--keep-workers` を渡して、バックグラウンドセッションを実行したままにして、次の supervisor が再接続できるようにします。次の `claude agents` または `claude --bg` は新しい supervisor を開始します |584| `claude daemon stop --any` | supervisor プロセスとそれがホストするバックグラウンドセッションを停止します。`--keep-workers` を渡して、バックグラウンドセッションを実行したままにして、次の supervisor が再接続できるようにします。次の `claude agents` または `claude --bg` は新しい supervisor を開始します |

554 585 

564 595 

565バックグラウンドセッションはユーザーごとのスーパーバイザープロセスによってホストされ、ターミナルおよびエージェントビューとは別です。スーパーバイザーはセッションを初めてバックグラウンド化するか、エージェントビューを開くときに自動的に開始され、直接管理することはありません。596バックグラウンドセッションはユーザーごとのスーパーバイザープロセスによってホストされ、ターミナルおよびエージェントビューとは別です。スーパーバイザーはセッションを初めてバックグラウンド化するか、エージェントビューを開くときに自動的に開始され、直接管理することはありません。

566 597 

598実行中の Claude Code プロセスが起動されたバイナリが更新によって置き換えられたか削除された場合、そのプロセスはインストールされた `claude` ランチャーやディスク上の最新バージョンなど、別のインストール済みコピーからスーパーバイザーを開始します。

599 

567スーパーバイザーは、エージェントビューまたは `claude --bg` からのディスパッチがコールドローンチの遅延なく開始されるように、1 つのプリウォーミングされたワーカープロセスを準備完了の状態で保持しています。ディスパッチすると、スーパーバイザーはプリウォーミングされたワーカーをセッションに割り当て、そのセッションのディレクトリ、設定、認証情報をそれに適用してから、次のディスパッチ用の置き換えを開始します。健全なプリウォーミングされたワーカーが利用できない場合、スーパーバイザーは代わりに新しいプロセスを起動します。600スーパーバイザーは、エージェントビューまたは `claude --bg` からのディスパッチがコールドローンチの遅延なく開始されるように、1 つのプリウォーミングされたワーカープロセスを準備完了の状態で保持しています。ディスパッチすると、スーパーバイザーはプリウォーミングされたワーカーをセッションに割り当て、そのセッションのディレクトリ、設定、認証情報をそれに適用してから、次のディスパッチ用の置き換えを開始します。健全なプリウォーミングされたワーカーが利用できない場合、スーパーバイザーは代わりに新しいプロセスを起動します。

568 601 

569スーパーバイザーとそのセッションはインタラクティブセッションと同じ認証情報で認証され、モデル API を超えて追加のネットワーク接続を行いません。`CLAUDE_CODE_USE_BEDROCK` や `ANTHROPIC_DEFAULT_*_MODEL` エイリアスなどのプロバイダー選択変数は、各セッションをディスパッチしたシェルから読み取られ、そのワーカーに適用されます。602スーパーバイザーとそのセッションはインタラクティブセッションと同じ認証情報で認証され、モデル API を超えて追加のネットワーク接続を行いません。`CLAUDE_CODE_USE_BEDROCK` や `ANTHROPIC_DEFAULT_*_MODEL` エイリアスなどのプロバイダー選択変数は、各セッションをディスパッチしたシェルから読み取られ、そのワーカーに適用されます。

592 625 

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

594 627 

628再開されたプロセスは、タスク中に[worktree に移動した](#how-file-edits-are-isolated)セッションの会話を見つけます。トランスクリプトがセッションが開始した場所にない場合、Claude Code はリポジトリの登録済み worktree の下も確認します。v2.1.207 より前は、プロセスが停止した後にエージェントビューからそのセッションを再度開くと、元のプロンプトのみを含む空の会話が表示される可能性があり、トランスクリプトはディスク上に無傷のままでした。v2.1.207 以降でセッションを再度開くと、それを復旧します。

629 

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

596 631 

597`←` を押して残された空の行で、プロンプトが与えられたことがない場合は、約 5 分後に完全に削除されるため、リストは自動的にクリアされます。`claude --bg` で開始されたセッションおよびトラストダイアログなどのセットアッププロンプトを待機しているセッションはこの方法では削除されません。632`←` を押して残された空の行で、プロンプトが与えられたことがない場合は、約 5 分後に完全に削除されるため、リストは自動的にクリアされます。`claude --bg` で開始されたセッションおよびトラストダイアログなどのセットアッププロンプトを待機しているセッションはこの方法では削除されません。

600 635 

601スーパーバイザーはディスク上にインストールされた Claude Code バイナリを監視し、通常の[自動更新プログラム](/ja/setup#auto-updates)がそれを置き換えた後、新しいバージョンに再開します。これはネットワークチェックではなく、ローカルファイルウォッチです。バックグラウンドセッションはデタッチされたプロセスであるため、再開を通じて実行し続け、新しいスーパーバイザーはそれらに再接続します。アイドル状態のピン留めセッションも新しいバージョンに再開されるため、再度アタッチすることなく更新を取得します。636スーパーバイザーはディスク上にインストールされた Claude Code バイナリを監視し、通常の[自動更新プログラム](/ja/setup#auto-updates)がそれを置き換えた後、新しいバージョンに再開します。これはネットワークチェックではなく、ローカルファイルウォッチです。バックグラウンドセッションはデタッチされたプロセスであるため、再開を通じて実行し続け、新しいスーパーバイザーはそれらに再接続します。アイドル状態のピン留めセッションも新しいバージョンに再開されるため、再度アタッチすることなく更新を取得します。

602 637 

638新しいスーパーバイザーが引き継ぐと、残りのアイドルセッションも新しいバージョンに再開されます。短い遅延の後、バックグラウンドで数個ずつ再開されます。この遅延により、再開を通じて接続されたターミナルが最初に再接続できます。アクティブに作業しているセッション、入力を待機しているセッション、またはターミナルが接続されているセッションは中断されません。次回そのプロセスが再開されるときに新しいバージョンに移動します。v2.1.206 より前は、スーパーバイザーは新しいバージョンごとに 1 分あたり数個のアイドルセッションのみを移動したため、セッションは更新後しばらくの間古いバージョンを実行し続ける可能性がありました。

639 

640これらの再開は常にセッションをより新しいバージョンに移動するだけです。セッションのプロセスが開始されたバージョンより古い Claude Code バージョンを実行しているスーパーバイザーはそのプロセスをそのままにします。セッションはより新しいスーパーバイザーが引き継ぐまで、より新しいバージョンを実行し続けます。

641 

603スーパーバイザーがセッションを再開している間に `claude attach` を実行すると、更新、スタール、またはマイグレーションのいずれであっても、失敗するのではなく置き換えプロセスを待機します。`Agent is updating to the new Claude Code…` などのステータス行は、待機している内容を名前付けし、経過秒数をカウントし、セッションの準備ができるとすぐにコマンドが接続されます。約 60 秒後、待機を停止してエラーを報告します。v2.1.205 より前は、`claude attach` は数秒後に再試行を停止し、セッションがまだ再開している間にエラーを出力しました。642スーパーバイザーがセッションを再開している間に `claude attach` を実行すると、更新、スタール、またはマイグレーションのいずれであっても、失敗するのではなく置き換えプロセスを待機します。`Agent is updating to the new Claude Code…` などのステータス行は、待機している内容を名前付けし、経過秒数をカウントし、セッションの準備ができるとすぐにコマンドが接続されます。約 60 秒後、待機を停止してエラーを報告します。v2.1.205 より前は、`claude attach` は数秒後に再試行を停止し、セッションがまだ再開している間にエラーを出力しました。

604 643 

605<h3 id="where-state-is-stored">644<h3 id="where-state-is-stored">

737 776 

738セッションが完了し、約 1 時間アタッチされていない状態で待機すると、スーパーバイザーはリソースを解放するためにプロセスを停止します。アタッチすると、中断したところから新しいプロセスが開始され、プロセスが再起動している間にセッションにすぐに切り替わります。作業中または入力を待機しているセッション、または[ピン留めされた](#organize-the-list)セッションはこの方法で停止されることはありません。セッションを `Ctrl+T` でピン留めして、応答性を保つことができます。777セッションが完了し、約 1 時間アタッチされていない状態で待機すると、スーパーバイザーはリソースを解放するためにプロセスを停止します。アタッチすると、中断したところから新しいプロセスが開始され、プロセスが再起動している間にセッションにすぐに切り替わります。作業中または入力を待機しているセッション、または[ピン留めされた](#organize-the-list)セッションはこの方法で停止されることはありません。セッションを `Ctrl+T` でピン留めして、応答性を保つことができます。

739 778 

779プロセスが開始している間、セッションのトランスクリプトの最後の画面が `Session is starting` ノートとともに表示され、ライブセッションは準備ができるとすぐにそれを置き換えます。

780 

740<h3 id="claude/worktrees/-is-filling-up">781<h3 id="claude/worktrees/-is-filling-up">

741 `.claude/worktrees/` が満杯になっている782 `.claude/worktrees/` が満杯になっている

742</h3>783</h3>

743 784 

744エージェントビューでセッションを削除すると、Claude が作成したワークツリーが削除されます。`claude rm` はコミットされていない変更があるワークツリーを保持し、そのパスを出力します。プロジェクトディレクトリで `git worktree list` を使用して残りのエントリをリストし、各エントリを `git worktree remove <path>` で削除します。[ワークツリーをクリーンアップする](/ja/worktrees#clean-up-worktrees)を参照してください。785エージェントビューでセッションを削除すると、Claude が作成したワークツリーが削除されます。安全に削除できないワークツリーは[セッション行を保持](#organize-the-list)して、孤立しないようにします。`claude rm` はコミットされていない変更があるワークツリーを保持し、そのセッション行を保持し、保持されたパスを出力します。プロジェクトディレクトリで `git worktree list` を使用して残りのエントリをリストし、各エントリを `git worktree remove <path>` で削除します。[ワークツリーをクリーンアップする](/ja/worktrees#clean-up-worktrees)を参照してください。

745 786 

746<h2 id="limitations">787<h2 id="limitations">

747 制限事項788 制限事項

751 792 

752* **レート制限が適用される**：バックグラウンドセッションはインタラクティブセッションと同じようにサブスクリプション使用量を消費するため、10 個のエージェントを並行して実行するとクォータが 10 倍速く消費されます。793* **レート制限が適用される**：バックグラウンドセッションはインタラクティブセッションと同じようにサブスクリプション使用量を消費するため、10 個のエージェントを並行して実行するとクォータが 10 倍速く消費されます。

753* **セッションはローカル**：バックグラウンドセッションはマシンで実行され、スリープ中は保持されますが、マシンがシャットダウンすると停止します。794* **セッションはローカル**：バックグラウンドセッションはマシンで実行され、スリープ中は保持されますが、マシンがシャットダウンすると停止します。

754* **Claude が作成した worktrees はエージェント view のセッションで削除される**：セッションが独自の worktree でファイルを編集した場合、セッションを削除する前に変更をマージまたはプッシュしてください。`claude rm` は未コミットの変更がある worktree を保持します。自分で作成した worktree はそのまま残されます。795* **Claude が作成した worktrees はエージェント view のセッションで削除される**：セッションが独自の worktree でファイルを編集した場合、セッションを削除する前に変更をコミットしてください。コミットがどこにもプッシュされていない worktree はセッションと一緒に保持されます。`claude rm` は未コミットの変更がある worktree をセッションと一緒に保持し、自分で作成した worktree はそのまま残されます。

755 796 

756<h2 id="related-resources">797<h2 id="related-resources">

757 関連リソース798 関連リソース

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

771 812 

772| バージョン | 変更 |813| バージョン | 変更 |

773| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |814| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

815| v2.1.208 | {/* min-version: 2.1.208 */}プロセスが停止したセッションにアタッチすると、プロセスが開始する間、`Session is starting` ノートのみではなく、トランスクリプトの最後の画面分が表示されます。バックグラウンドサービスに到達できないか送信に失敗したため配信できない返信は保存され、プロセスが再度開始するときにセッションの次のプロンプトとして送信されます。このリリース前は、バックグラウンドサービスに到達できない間に失われた返信は破棄されました。独自のバイナリが更新によって置き換えられたプロセスは、Claude Code が再開されるまで失敗する代わりに、インストール済みの `claude` ランチャーまたはディスク上の最新バージョンからスーパーバイザーを開始できます。古いバージョンを実行しているスーパーバイザーは、新しいバージョンで開始されたアイドルセッションを独自の古いバイナリに再開しません。セッションを削除すると、セッションが worktree を別のブランチに移動した後でも worktree が削除され、worktree にプッシュされていないコミットがある場合、または別のセッションがそれを要求する場合、worktree をセッション行と一緒に保持します。コミットを破棄したり worktree を孤立させたりする代わりに。`/install-github-app` とその `/mcp` 設定リストおよび認証アクションはバックグラウンドセッションで代替案を名前で示すメッセージで拒否されます。v2.1.208 のみでは、`/model` ピッカーは同じ方法で拒否され、入力された `/model <name>` はデフォルトモデルも保存する代わりに、そのセッションのみを切り替えました。 |

816| v2.1.207 | {/* min-version: 2.1.207 */}ピークパネルは行が切り詰める文で開きます。例えば、あなたを待っているセッションの正確な質問など。ブロックされたセッションがどのくらい待機しているかを、ステータス文と質問に同じタイムスタンプをプレフィックスする代わりに、単一の `waiting 3m` 行として表示します。ディスパッチ入力に同じテキストを再度貼り付けると、2 番目のテキストを追加する代わりに、折りたたまれた `[Pasted text #N]` プレースホルダーが展開されます。プランを受け入れることで名前が付けられたバックグラウンドセッションはその行にその名前を表示します。worktree に移動したバックグラウンドセッションは、プロセスが agent view から再開されるときに会話を保持します。 |

817| v2.1.206 | {/* min-version: 2.1.206 */}行の概要は行の残りの幅を埋め、64 列ではなくターミナルの右端でのみ切り詰められます。スーパーバイザーが新しい Claude Code バージョンに再開した後、残りのアイドルバックグラウンドセッションを 1 分あたり数個ではなくバックグラウンドでそのバージョンに再開します。`Ctrl+X` または `claude rm` でセッションを削除すると、スーパーバイザーのセッションリストからもクリアされるため、スーパーバイザーの再開後に行が再度表示されません。 |

774| v2.1.205 | {/* min-version: 2.1.205 */}行の概要はセッション自体の 1 行レポートを表示し、64 列で切り詰められます。生のツール呼び出しまたは `done/total` カウントの代わりに表示されます。ディレクトリグループ化された行は色付きの状態単語で開きます。ピークパネルは完全なステータス文で開き、あなたを待っているセッションの場合、返信入力の上にその正確な質問が表示されます。`gh` でプルリクエストを編集、コメント、クローズ、またはレディマークするセッションはそれにリンクされます。プルリクエストを作成またはチェックアウトするセッションだけではなく、プッシュはローカルブランチ名が一致しない場合でもプルリクエストをリンクし、作成コマンドの出力がインライン制限を超えたプルリクエストもリンクされます。読み取り可能なテキストがないターンは、セッションの前の状態を保持し、`Working` に戻すのではなく、フリップします。`claude attach` は再開中のセッションを約 60 秒間待機し、理由を名前で示すステータス行を表示します。失敗する代わりに。 |818| v2.1.205 | {/* min-version: 2.1.205 */}行の概要はセッション自体の 1 行レポートを表示し、64 列で切り詰められます。生のツール呼び出しまたは `done/total` カウントの代わりに表示されます。ディレクトリグループ化された行は色付きの状態単語で開きます。ピークパネルは完全なステータス文で開き、あなたを待っているセッションの場合、返信入力の上にその正確な質問が表示されます。`gh` でプルリクエストを編集、コメント、クローズ、またはレディマークするセッションはそれにリンクされます。プルリクエストを作成またはチェックアウトするセッションだけではなく、プッシュはローカルブランチ名が一致しない場合でもプルリクエストをリンクし、作成コマンドの出力がインライン制限を超えたプルリクエストもリンクされます。読み取り可能なテキストがないターンは、セッションの前の状態を保持し、`Working` に戻すのではなく、フリップします。`claude attach` は再開中のセッションを約 60 秒間待機し、理由を名前で示すステータス行を表示します。失敗する代わりに。 |

775| v2.1.203 | {/* min-version: 2.1.203 */}ディスパッチシェルでエクスポートされたゲートウェイ `ANTHROPIC_BASE_URL` は、スーパーバイザーがそのゲートウェイ環境を共有する場合、それと同じディレクトリにディスパッチされたセッションに到達します。これは、それと一緒にエクスポートされた API キーが保持されている間にドロップされるのではなく、到達します。ディスパッチシェルの `PATH` は各セッションのワーカーに適用されます。サブエージェントが実行中に `←` を押すと、10 秒後に再開する代わりに、それらが完了するのを待ちます。空のリストは常にセクションヘッダーを各ヘッダーの下に説明とともに表示します。ディスパッチ入力で `@` を入力すると、起動リポジトリの登録済み git worktrees もそのディレクトリツリー内に存在するものをリストします。`effortLevel` 設定から継承された努力は、ディスパッチで固定されるのではなく、その設定への後の編集に従います。別の実行中のセッションで会話がすでに開いている停止されたセッションを開くと、行が失敗するのではなく、メッセージで拒否されます。agent view で利用できないコマンドは、入力に入力されたテキストを残します。git リポジトリの外で失敗する `WorktreeCreate` フックは、セッションがファイルを編集するのをもはやブロックしません。 |819| v2.1.203 | {/* min-version: 2.1.203 */}ディスパッチシェルでエクスポートされたゲートウェイ `ANTHROPIC_BASE_URL` は、スーパーバイザーがそのゲートウェイ環境を共有する場合、それと同じディレクトリにディスパッチされたセッションに到達します。これは、それと一緒にエクスポートされた API キーが保持されている間にドロップされるのではなく、到達します。ディスパッチシェルの `PATH` は各セッションのワーカーに適用されます。サブエージェントが実行中に `←` を押すと、10 秒後に再開する代わりに、それらが完了するのを待ちます。空のリストは常にセクションヘッダーを各ヘッダーの下に説明とともに表示します。ディスパッチ入力で `@` を入力すると、起動リポジトリの登録済み git worktrees もそのディレクトリツリー内に存在するものをリストします。`effortLevel` 設定から継承された努力は、ディスパッチで固定されるのではなく、その設定への後の編集に従います。別の実行中のセッションで会話がすでに開いている停止されたセッションを開くと、行が失敗するのではなく、メッセージで拒否されます。agent view で利用できないコマンドは、入力に入力されたテキストを残します。git リポジトリの外で失敗する `WorktreeCreate` フックは、セッションがファイルを編集するのをもはやブロックしません。 |

776| v2.1.202 | {/* min-version: 2.1.202 */}`/rename` または `Ctrl+R` でバックグラウンドセッションに設定された名前は、スーパーバイザーがそのプロセスを停止して再開しても、セッションがディスパッチされた時の名前に戻るのではなく、永続化されます。 |820| v2.1.202 | {/* min-version: 2.1.202 */}`/rename` または `Ctrl+R` でバックグラウンドセッションに設定された名前は、スーパーバイザーがそのプロセスを停止して再開しても、セッションがディスパッチされた時の名前に戻るのではなく、永続化されます。 |

54 54 

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

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

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

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

59 59 

60すべてのセッションのデスクトップビューについては、[デスクトップアプリでのセッションの並列実行](/ja/desktop#work-in-parallel-with-sessions) を参照してください。60すべてのセッションのデスクトップビューについては、[デスクトップアプリでのセッションの並列実行](/ja/desktop#work-in-parallel-with-sessions) を参照してください。

111 </Step>111 </Step>

112</Steps>112</Steps>

113 113 

114サインイン後、いつでも `/setup-bedrock` を実行してウィザードを再度開き、認証情報、リージョン、またはモデルピンを変更できます。114サインイン後、いつでも `/setup-bedrock` を実行してウィザードを再度開き、認証情報、リージョン、またはモデルピンを変更できます。モデルピンステップは、現在ピン留めされているモデルから開始されます。ウィザードは `~/.claude/settings.json` に書き込むか、[`CLAUDE_CONFIG_DIR`](/ja/env-vars#variables) が設定されている場合は `$CLAUDE_CONFIG_DIR/settings.json` に書き込みます。