Documentation 2026-09-27 23:59 UTC to 2026-09-28 22:59 UTC

39次の表は、各アクセシビリティオプション、フラグ、環境変数、または設定として設定するかどうか、および何を変更するかを示しています。39次の表は、各アクセシビリティオプション、フラグ、環境変数、または設定として設定するかどうか、および何を変更するかを示しています。

40 40 

41| オプション | タイプ | 変更内容 |41| オプション | タイプ | 変更内容 |

42| :---------------------------------------------------------------------- | :--- | :------------------------------------------------------------------------------------------------------------------------------------------------- |42| :- | :- | :- |

43| [`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) | フラグ | 1 つのセッションのスクリーンリーダーモード。 |43| [`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) | フラグ | 1 つのセッションのスクリーンリーダーモード。 |

44| [`CLAUDE_AX_SCREEN_READER`](/docs/ja/env-vars#variables) | 環境変数 | それを設定したシェルから開始されたセッションのスクリーンリーダーモード。 |44| [`CLAUDE_AX_SCREEN_READER`](/docs/ja/env-vars#variables) | 環境変数 | それを設定したシェルから開始されたセッションのスクリーンリーダーモード。 |

45| [`axScreenReader`](/docs/ja/settings-reference#axscreenreader) | 設定 | `true` の場合、すべてのセッションのスクリーンリーダーモード。 |45| [`axScreenReader`](/docs/ja/settings-reference#axscreenreader) | 設定 | `true` の場合、すべてのセッションのスクリーンリーダーモード。 |

71トランスクリプト内の各メッセージは、スクリーンリーダーが発表するラベルで始まり、それが何であるかを名前付けします：あなたのメッセージ、Claude の返信と思考、ツールアクティビティ、エラーと警告、およびプロンプト。ラベルは検索可能でもあるため、ターミナルのスクロールバックを検索してトランスクリプトのセクション間をジャンプできます：71トランスクリプト内の各メッセージは、スクリーンリーダーが発表するラベルで始まり、それが何であるかを名前付けします：あなたのメッセージ、Claude の返信と思考、ツールアクティビティ、エラーと警告、およびプロンプト。ラベルは検索可能でもあるため、ターミナルのスクロールバックを検索してトランスクリプトのセクション間をジャンプできます：

72 72 

73| ラベル | 意味 |73| ラベル | 意味 |

74| :--------------------- | :---------------------------------------------------------------- |74| :- | :- |

75| `you:` | あなたのメッセージ |75| `you:` | あなたのメッセージ |

76| `claude:` | Claude の返信 |76| `claude:` | Claude の返信 |

77| `thinking:` | Claude の思考 |77| `thinking:` | Claude の思考 |

15</Note>15</Note>

16 16 

17| 決定 | 選択内容 | 参照 |17| 決定 | 選択内容 | 参照 |

18| :-------------------------------------------------------- | :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |18| :- | :- | :- |

19| [API プロバイダーを選択する](#choose-your-api-provider) | Claude Code が認証される場所と課金方法 | [Authentication](/docs/ja/authentication)、[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry) |19| [API プロバイダーを選択する](#choose-your-api-provider) | Claude Code が認証される場所と課金方法 | [Authentication](/docs/ja/authentication)、[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry) |

20| [設定がデバイスに到達する方法を決定する](#decide-how-settings-reach-devices) | マネージドポリシーが開発者マシンに到達する方法 | [Server-managed settings](/docs/ja/server-managed-settings)、[Delivery mechanisms](/docs/ja/managed-settings#delivery-mechanisms) |20| [設定がデバイスに到達する方法を決定する](#decide-how-settings-reach-devices) | マネージドポリシーが開発者マシンに到達する方法 | [Server-managed settings](/docs/ja/server-managed-settings)、[Delivery mechanisms](/docs/ja/managed-settings#delivery-mechanisms) |

21| [実行する内容を決定する](#decide-what-to-enforce) | どのツール、コマンド、統合が許可されるか | [Permissions](/docs/ja/permissions)、[Sandboxing](/docs/ja/sandboxing) |21| [実行する内容を決定する](#decide-what-to-enforce) | どのツール、コマンド、統合が許可されるか | [Permissions](/docs/ja/permissions)、[Sandboxing](/docs/ja/sandboxing) |

29Claude Code は複数の API プロバイダーのいずれかを通じて Claude に接続します。選択は課金、認証、継承するコンプライアンス体制、および開発者が使用できる Claude Code 機能に影響します。29Claude Code は複数の API プロバイダーのいずれかを通じて Claude に接続します。選択は課金、認証、継承するコンプライアンス体制、および開発者が使用できる Claude Code 機能に影響します。

30 30 

31| プロバイダー | 選択する場合 |31| プロバイダー | 選択する場合 |

32| :---------------------------- | :----------------------------------------------------------------------------------------- |32| :- | :- |

33| Claude for Teams / Enterprise | Claude Code と claude.ai を 1 つのシート単位のサブスクリプションで実行したい場合。実行するインフラストラクチャは不要です。これがデフォルトの推奨事項です。 |33| Claude for Teams / Enterprise | Claude Code と claude.ai を 1 つのシート単位のサブスクリプションで実行したい場合。実行するインフラストラクチャは不要です。これがデフォルトの推奨事項です。 |

34| Claude Console | API ファーストまたは従量課金を希望する場合 |34| Claude Console | API ファーストまたは従量課金を希望する場合 |

35| Amazon Bedrock | 既存の AWS コンプライアンス制御と課金を継承したい場合 |35| Amazon Bedrock | 既存の AWS コンプライアンス制御と課金を継承したい場合 |

49マネージド設定は、組織ポリシーを定義します。Claude Code は以下の表に示す 4 つのソースを優先順位順にチェックします。[Claude Code がマネージドソースを組み合わせる方法](/docs/ja/managed-settings#precedence-within-the-managed-tier)は、どのソースが適用されるか、ポリシーヘルパーが何を変更するか、およびすべてのソースを構成する方法を説明しています。この表は決定マップです。49マネージド設定は、組織ポリシーを定義します。Claude Code は以下の表に示す 4 つのソースを優先順位順にチェックします。[Claude Code がマネージドソースを組み合わせる方法](/docs/ja/managed-settings#precedence-within-the-managed-tier)は、どのソースが適用されるか、ポリシーヘルパーが何を変更するか、およびすべてのソースを構成する方法を説明しています。この表は決定マップです。

50 50 

51| メカニズム | 配信 | 優先度 | プラットフォーム |51| メカニズム | 配信 | 優先度 | プラットフォーム |

52| :---------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-- | :------------ |52| :- | :- | :- | :- |

53| Server-managed | claude.ai 管理コンソール、またはゲートウェイサインイン用の自己ホスト型 [Claude apps gateway](/docs/ja/claude-apps-gateway) | 最高 | すべて |53| Server-managed | claude.ai 管理コンソール、またはゲートウェイサインイン用の自己ホスト型 [Claude apps gateway](/docs/ja/claude-apps-gateway) | 最高 | すべて |

54| plist / registry policy | macOS: `com.anthropic.claudecode` plist<br />Windows: `HKLM\SOFTWARE\Policies\ClaudeCode` | 高 | macOS、Windows |54| plist / registry policy | macOS: `com.anthropic.claudecode` plist<br />Windows: `HKLM\SOFTWARE\Policies\ClaudeCode` | 高 | macOS、Windows |

55| File-based managed | macOS: `/Library/Application Support/ClaudeCode/managed-settings.json`<br />Linux と WSL: `/etc/claude-code/managed-settings.json`<br />Windows: `C:\Program Files\ClaudeCode\managed-settings.json` | 中 | すべて |55| File-based managed | macOS: `/Library/Application Support/ClaudeCode/managed-settings.json`<br />Linux と WSL: `/etc/claude-code/managed-settings.json`<br />Windows: `C:\Program Files\ClaudeCode\managed-settings.json` | 中 | すべて |

94マネージド設定は、ツール、サンドボックス実行、MCP サーバーとプラグインソース、および実行するフック を制限できます。各行は、それを駆動する設定キーを持つ制御サーフェスです。94マネージド設定は、ツール、サンドボックス実行、MCP サーバーとプラグインソース、および実行するフック を制限できます。各行は、それを駆動する設定キーを持つ制御サーフェスです。

95 95 

96| 制御 | 機能 | キー設定 |96| 制御 | 機能 | キー設定 |

97| :------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- |97| :- | :- | :- |

98| [権限ルール](/docs/ja/permissions) | 特定のツールとコマンドを許可、確認、または拒否する | `permissions.allow`、`permissions.deny` |98| [権限ルール](/docs/ja/permissions) | 特定のツールとコマンドを許可、確認、または拒否する | `permissions.allow`、`permissions.deny` |

99| [権限ロックダウン](/docs/ja/permissions#managed-only-settings) | マネージド設定を[権限ルールの唯一の設定ソース](/docs/ja/settings-reference#allowmanagedpermissionrulesonly)にします。`--dangerously-skip-permissions` を無効にする | `allowManagedPermissionRulesOnly`、`permissions.disableBypassPermissionsMode` |99| [権限ロックダウン](/docs/ja/permissions#managed-only-settings) | マネージド設定を[権限ルールの唯一の設定ソース](/docs/ja/settings-reference#allowmanagedpermissionrulesonly)にします。`--dangerously-skip-permissions` を無効にする | `allowManagedPermissionRulesOnly`、`permissions.disableBypassPermissionsMode` |

100| [開始権限モード](/docs/ja/permission-modes#which-mode-a-session-starts-in) | 組み込みの開始権限モードの代わりに、開発者のターミナルセッションが開始する権限モードを選択するか、自動モードを削除します。VS Code 拡張機能は、Pro、Max、Team プランでのみ設定した `defaultMode` を読み取ります。[権限モードの切り替え](/docs/ja/permission-modes#switch-permission-modes)は、拡張機能が読み取る内容を一覧表示します | `permissions.defaultMode`、`permissions.disableAutoMode` |100| [開始権限モード](/docs/ja/permission-modes#which-mode-a-session-starts-in) | 組み込みの開始権限モードの代わりに、開発者のターミナルセッションが開始する権限モードを選択するか、自動モードを削除します。VS Code 拡張機能は、Pro、Max、Team プランでのみ設定した `defaultMode` を読み取ります。[権限モードの切り替え](/docs/ja/permission-modes#switch-permission-modes)は、拡張機能が読み取る内容を一覧表示します | `permissions.defaultMode`、`permissions.disableAutoMode` |

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

136 136 

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

138| :--------------------- | :----------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------- |138| :- | :- | :- | :- |

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

140| 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](/docs/ja/analytics) |140| 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](/docs/ja/analytics) |

141| 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](/docs/ja/costs#manage-costs-for-your-organization) |141| 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](/docs/ja/costs#manage-costs-for-your-organization) |

150Team、Enterprise、Claude API、およびクラウドプロバイダープランでは、Anthropic はコードまたはプロンプトでモデルをトレーニングしません。API プロバイダーが保持とコンプライアンス体制を決定します。150Team、Enterprise、Claude API、およびクラウドプロバイダープランでは、Anthropic はコードまたはプロンプトでモデルをトレーニングしません。API プロバイダーが保持とコンプライアンス体制を決定します。

151 151 

152| トピック | 知っておくべきこと | 開始場所 |152| トピック | 知っておくべきこと | 開始場所 |

153| :----------------------- | :--------------------------------------------- | :--------------------------------------------- |153| :- | :- | :- |

154| Data usage policy | Anthropic が収集する内容、保持期間、トレーニングに使用されない内容 | [Data usage](/docs/ja/data-usage) |154| Data usage policy | Anthropic が収集する内容、保持期間、トレーニングに使用されない内容 | [Data usage](/docs/ja/data-usage) |

155| Zero Data Retention（ZDR） | リクエスト完了後は何も保存されません。Claude for Enterprise で利用可能 | [Zero data retention](/docs/ja/zero-data-retention) |155| Zero Data Retention（ZDR） | リクエスト完了後は何も保存されません。Claude for Enterprise で利用可能 | [Zero data retention](/docs/ja/zero-data-retention) |

156| Security architecture | ネットワークモデル、暗号化、認証、監査証跡 | [Security](/docs/ja/security) |156| Security architecture | ネットワークモデル、暗号化、認証、監査証跡 | [Security](/docs/ja/security) |

98アドバイザーはメインモデル以上の能力を持つ必要があります。各メインモデルで受け入れられるアドバイザーは以下の通りです。98アドバイザーはメインモデル以上の能力を持つ必要があります。各メインモデルで受け入れられるアドバイザーは以下の通りです。

99 99 

100| メインモデル | 受け入れられるアドバイザー | 注記 |100| メインモデル | 受け入れられるアドバイザー | 注記 |

101| --------------------- | -------------------------- | ------------------------------------------------------------------------ |101| - | - | - |

102| Haiku 4.5 | Fable、Opus、Sonnet | Haiku はアドバイザーを呼び出すことはできますが、アドバイザーとして機能することはできません |102| Haiku 4.5 | Fable、Opus、Sonnet | Haiku はアドバイザーを呼び出すことはできますが、アドバイザーとして機能することはできません |

103| Sonnet 4.6 | Fable、Opus、Sonnet | |103| Sonnet 4.6 | Fable、Opus、Sonnet | |

104| Sonnet 5 | Fable、Opus 4.7 以降、Sonnet 5 | Sonnet 4.6 アドバイザーは拒否され、Opus 4.6 アドバイザーを使用したリクエストは API エラーで失敗します |104| Sonnet 5 | Fable、Opus 4.7 以降、Sonnet 5 | Sonnet 4.6 アドバイザーは拒否され、Opus 4.6 アドバイザーを使用したリクエストは API エラーで失敗します |

137受け入れられたペアリングはすべて機能します。これらの組み合わせは、異なる方法でコストと能力のバランスを取ります。137受け入れられたペアリングはすべて機能します。これらの組み合わせは、異なる方法でコストと能力のバランスを取ります。

138 138 

139| ペアリング | 使用する場合 |139| ペアリング | 使用する場合 |

140| -------------------------- | --------------------------------------------------------------------------------------- |140| - | - |

141| Sonnet メイン + Opus アドバイザー | Sonnet は日常的な作業を処理し、計画、曖昧な失敗、完了チェックを Opus にエスカレートします |141| Sonnet メイン + Opus アドバイザー | Sonnet は日常的な作業を処理し、計画、曖昧な失敗、完了チェックを Opus にエスカレートします |

142| Sonnet メイン + Fable アドバイザー | 決定ポイントで Fable ガイダンスを取得し、プロセス全体で Fable を実行しません。Fable アクセスが必要です |142| Sonnet メイン + Fable アドバイザー | 決定ポイントで Fable ガイダンスを取得し、プロセス全体で Fable を実行しません。Fable アクセスが必要です |

143| Haiku メイン + Opus アドバイザー | 強力な計画を備えた最も低コストのメインモデル。Haiku 単独よりも高いコストが予想されますが、メインモデルを Sonnet または Opus に切り替えるよりは低くなります |143| Haiku メイン + Opus アドバイザー | 強力な計画を備えた最も低コストのメインモデル。Haiku 単独よりも高いコストが予想されますが、メインモデルを Sonnet または Opus に切り替えるよりは低くなります |

218advisor は、モデルの強みを組み合わせるいくつかの方法の 1 つです。2 番目のモデルをいつ関与させるかに基づいて選択します。218advisor は、モデルの強みを組み合わせるいくつかの方法の 1 つです。2 番目のモデルをいつ関与させるかに基づいて選択します。

219 219 

220| アプローチ | より強力なモデルが実行される場合 | 開始方法 |220| アプローチ | より強力なモデルが実行される場合 | 開始方法 |

221| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ----------------------------- |221| - | - | - |

222| Advisor ツール | タスク中の決定ポイント | Claude がガイダンスが必要な場合に呼び出します |222| Advisor ツール | タスク中の決定ポイント | Claude がガイダンスが必要な場合に呼び出します |

223| [`opusplan`](/docs/ja/model-config#opusplan-model-setting) | プランモード中（[`availableModels`](/docs/ja/model-config#restrict-model-selection)で許可されている場合）、その後実行用に Sonnet に切り替わります | プランモードに入ります |223| [`opusplan`](/docs/ja/model-config#opusplan-model-setting) | プランモード中（[`availableModels`](/docs/ja/model-config#restrict-model-selection)で許可されている場合）、その後実行用に Sonnet に切り替わります | プランモードに入ります |

224| [サブエージェント](/docs/ja/sub-agents#choose-a-model)（`model` 設定） | 委任されたサブタスク全体 | Claude が委任するか、サブエージェントを呼び出します |224| [サブエージェント](/docs/ja/sub-agents#choose-a-model)（`model` 設定） | 委任されたサブタスク全体 | Claude が委任するか、サブエージェントを呼び出します |

165SDK には Claude Code を支えるのと同じツールが含まれています。165SDK には Claude Code を支えるのと同じツールが含まれています。

166 166 

167| カテゴリ | ツール | 機能 |167| カテゴリ | ツール | 機能 |

168| :------------- | :---------------------------------------------------------- | :------------------------------------ |168| :- | :- | :- |

169| **ファイル操作** | `Read`、`Edit`、`Write` | ファイルを読み取り、変更、作成 |169| **ファイル操作** | `Read`、`Edit`、`Write` | ファイルを読み取り、変更、作成 |

170| **検索** | `Glob`、`Grep` | パターンでファイルを検索、正規表現でコンテンツを検索 |170| **検索** | `Glob`、`Grep` | パターンでファイルを検索、正規表現でコンテンツを検索 |

171| **実行** | `Bash` | シェルコマンド、スクリプト、git 操作を実行 |171| **実行** | `Bash` | シェルコマンド、スクリプト、git 操作を実行 |

214</h3>214</h3>

215 215 

216| オプション | 制御内容 | デフォルト |216| オプション | 制御内容 | デフォルト |

217| :-------------------------------------- | :--------- | :---- |217| :- | :- | :- |

218| 最大ターン（`max_turns` / `maxTurns`） | 最大ツール使用往復数 | 制限なし |218| 最大ターン（`max_turns` / `maxTurns`） | 最大ツール使用往復数 | 制限なし |

219| 最大予算（`max_budget_usd` / `maxBudgetUsd`） | 停止前の最大コスト | 制限なし |219| 最大予算（`max_budget_usd` / `maxBudgetUsd`） | 停止前の最大コスト | 制限なし |

220 220 

231`effort` オプションは Claude が適用する推論の量を制御します。低い努力レベルはターンあたりのトークンが少なく、コストが削減されます。すべてのモデルが努力パラメータをサポートしているわけではありません。どのモデルがサポートしているかについては、[努力](https://platform.claude.com/docs/ja/build-with-claude/effort)を参照してください。231`effort` オプションは Claude が適用する推論の量を制御します。低い努力レベルはターンあたりのトークンが少なく、コストが削減されます。すべてのモデルが努力パラメータをサポートしているわけではありません。どのモデルがサポートしているかについては、[努力](https://platform.claude.com/docs/ja/build-with-claude/effort)を参照してください。

232 232 

233| レベル | 動作 | 適している用途 |233| レベル | 動作 | 適している用途 |

234| :--------- | :---------- | :------------------------------------------------------------------------------ |234| :- | :- | :- |

235| `"low"` | 最小限の推論、高速応答 | ファイル検索、ディレクトリのリスト |235| `"low"` | 最小限の推論、高速応答 | ファイル検索、ディレクトリのリスト |

236| `"medium"` | バランスの取れた推論 | ルーチン編集、標準タスク |236| `"medium"` | バランスの取れた推論 | ルーチン編集、標準タスク |

237| `"high"` | 徹底的な分析 | リファクタリング、デバッグ |237| `"high"` | 徹底的な分析 | リファクタリング、デバッグ |

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

254 254 

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

256| :-------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------- |256| :- | :- | :- |

257| `"default"` | 許可ルールでカバーされていないツール呼び出しは `canUseTool` コールバックをトリガーします。コールバックがない場合は拒否 | カスタム承認コールバックを備えたインタラクティブアプリケーション |257| `"default"` | 許可ルールでカバーされていないツール呼び出しは `canUseTool` コールバックをトリガーします。コールバックがない場合は拒否 | カスタム承認コールバックを備えたインタラクティブアプリケーション |

258| `"acceptEdits"` | ファイル編集と一般的なファイルシステムコマンド（`mkdir`、`touch`、`mv`、`cp` など）を自動承認します。他の Bash コマンドはデフォルトルールに従います | Claude の編集を信頼し、プロトタイピング中や隔離されたディレクトリで作業する場合など、より高速な反復を望む |258| `"acceptEdits"` | ファイル編集と一般的なファイルシステムコマンド（`mkdir`、`touch`、`mv`、`cp` など）を自動承認します。他の Bash コマンドはデフォルトルールに従います | Claude の編集を信頼し、プロトタイピング中や隔離されたディレクトリで作業する場合など、より高速な反復を望む |

259| `"plan"` | Claude はソースファイルを編集せずに探索して計画を作成します。ファイル編集は自動承認されず、`canUseTool` コールバックを通じてプロンプトされます | Claude が変更を提案するが実行しないようにしたい場合、例えばコードレビュー中または変更を実行する前に承認する必要がある場合 |259| `"plan"` | Claude はソースファイルを編集せずに探索して計画を作成します。ファイル編集は自動承認されず、`canUseTool` コールバックを通じてプロンプトされます | Claude が変更を提案するが実行しないようにしたい場合、例えばコードレビュー中または変更を実行する前に承認する必要がある場合 |

282SDK でのコンテキストへの各コンポーネントの影響は次のとおりです。282SDK でのコンテキストへの各コンポーネントの影響は次のとおりです。

283 283 

284| ソース | ロード時期 | 影響 |284| ソース | ロード時期 | 影響 |

285| :----------------- | :---------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |285| :- | :- | :- |

286| **システムプロンプト** | すべてのリクエスト | 小さい固定コスト、常に存在 |286| **システムプロンプト** | すべてのリクエスト | 小さい固定コスト、常に存在 |

287| **CLAUDE.md ファイル** | セッション開始時、[`settingSources`](/docs/ja/agent-sdk/claude-code-features)経由 | すべてのリクエストで完全なコンテンツ（ただしプロンプトキャッシュされるため、最初のリクエストのみが完全なコストを支払う） |287| **CLAUDE.md ファイル** | セッション開始時、[`settingSources`](/docs/ja/agent-sdk/claude-code-features)経由 | すべてのリクエストで完全なコンテンツ（ただしプロンプトキャッシュされるため、最初のリクエストのみが完全なコストを支払う） |

288| **ツール定義** | すべてのリクエスト。MCP スキーマはデフォルトで遅延 | 組み込みツールスキーマはすべてのリクエストをロードします。[ツール検索](/docs/ja/agent-sdk/mcp#mcp-tool-search)はデフォルトで MCP ツールスキーマを遅延させ、サポートされていないモデルと特定のプラットフォームでアップフロントロードにフォールバックします。完全なマトリックスについては、[ツール検索を構成](/docs/ja/agent-sdk/tool-search#configure-tool-search)を参照してください |288| **ツール定義** | すべてのリクエスト。MCP スキーマはデフォルトで遅延 | 組み込みツールスキーマはすべてのリクエストをロードします。[ツール検索](/docs/ja/agent-sdk/mcp#mcp-tool-search)はデフォルトで MCP ツールスキーマを遅延させ、サポートされていないモデルと特定のプラットフォームでアップフロントロードにフォールバックします。完全なマトリックスについては、[ツール検索を構成](/docs/ja/agent-sdk/tool-search#configure-tool-search)を参照してください |

353ループが終了すると、`ResultMessage` は何が起こったかを示し、出力を提供します。`subtype` フィールド（両方の SDK で利用可能）は、終了状態をチェックする主な方法です。353ループが終了すると、`ResultMessage` は何が起こったかを示し、出力を提供します。`subtype` フィールド（両方の SDK で利用可能）は、終了状態をチェックする主な方法です。

354 354 

355| 結果サブタイプ | 何が起こったか | `result` フィールドは利用可能か？ |355| 結果サブタイプ | 何が起こったか | `result` フィールドは利用可能か？ |

356| :------------------------------------ | :---------------------------------------------------------------------------------- | :-------------------: |356| :- | :- | :-: |

357| `success` | Claude は通常、タスクを完了しました | はい |357| `success` | Claude は通常、タスクを完了しました | はい |

358| `error_max_turns` | 完了前に `maxTurns` 制限に達しました | いいえ |358| `error_max_turns` | 完了前に `maxTurns` 制限に達しました | いいえ |

359| `error_max_budget_usd` | 完了前に `maxBudgetUsd` 制限に達しました | いいえ |359| `error_max_budget_usd` | 完了前に `maxBudgetUsd` 制限に達しました | いいえ |

387[Hooks](/docs/ja/agent-sdk/hooks)は、ループの特定のポイントで発火するコールバックです。ツールが実行される前、戻った後、エージェントが終了したときなど。一般的に使用されるフックは次のとおりです。387[Hooks](/docs/ja/agent-sdk/hooks)は、ループの特定のポイントで発火するコールバックです。ツールが実行される前、戻った後、エージェントが終了したときなど。一般的に使用されるフックは次のとおりです。

388 388 

389| フック | 発火時期 | 一般的な用途 |389| フック | 発火時期 | 一般的な用途 |

390| :------------------------------- | :------------- | :-------------------- |390| :- | :- | :- |

391| `PreToolUse` | ツール実行前 | 入力を検証、危険なコマンドをブロック |391| `PreToolUse` | ツール実行前 | 入力を検証、危険なコマンドをブロック |

392| `PostToolUse` | ツール戻り後 | 出力を監査、副作用をトリガー |392| `PostToolUse` | ツール戻り後 | 出力を監査、副作用をトリガー |

393| `UserPromptSubmit` | プロンプト送信時 | プロンプトに追加コンテキストを注入 |393| `UserPromptSubmit` | プロンプト送信時 | プロンプトに追加コンテキストを注入 |

76各ソースは特定の場所から設定を読み込みます。`<cwd>` は `cwd` オプション経由で渡す作業ディレクトリです（設定されていない場合はプロセスの現在のディレクトリ）。完全な型定義については、[`SettingSource`](/docs/ja/agent-sdk/typescript#settingsource)（TypeScript）または [`SettingSource`](/docs/ja/agent-sdk/python#settingsource)（Python）を参照してください。76各ソースは特定の場所から設定を読み込みます。`<cwd>` は `cwd` オプション経由で渡す作業ディレクトリです（設定されていない場合はプロセスの現在のディレクトリ）。完全な型定義については、[`SettingSource`](/docs/ja/agent-sdk/typescript#settingsource)（TypeScript）または [`SettingSource`](/docs/ja/agent-sdk/python#settingsource)（Python）を参照してください。

77 77 

78| ソース | 読み込むもの | 場所 |78| ソース | 読み込むもの | 場所 |

79| :---------- | :------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |79| :- | :- | :- |

80| `"project"` | プロジェクト `settings.json` とフック；プロジェクト CLAUDE.md と `.claude/rules/*.md`；プロジェクトスキル、コマンド、サブエージェント | `<cwd>/.claude/` （`settings.json` とフック用）；CLAUDE.md とルール用に `<cwd>` と全親ディレクトリ；スキル、コマンド、サブエージェント用に `<cwd>` とリポジトリルートまでの全親ディレクトリ、および `additionalDirectories` または `add_dirs` オプション経由で渡す各ディレクトリの `.claude/skills/`、`.claude/commands/`、`.claude/agents/` フォルダ（SDK は Claude Code に [`--add-dir`](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) として渡します） |80| `"project"` | プロジェクト `settings.json` とフック；プロジェクト CLAUDE.md と `.claude/rules/*.md`；プロジェクトスキル、コマンド、サブエージェント | `<cwd>/.claude/` （`settings.json` とフック用）；CLAUDE.md とルール用に `<cwd>` と全親ディレクトリ；スキル、コマンド、サブエージェント用に `<cwd>` とリポジトリルートまでの全親ディレクトリ、および `additionalDirectories` または `add_dirs` オプション経由で渡す各ディレクトリの `.claude/skills/`、`.claude/commands/`、`.claude/agents/` フォルダ（SDK は Claude Code に [`--add-dir`](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) として渡します） |

81| `"user"` | ユーザー `settings.json`；ユーザー CLAUDE.md と `~/.claude/rules/*.md`；ユーザースキル、コマンド、サブエージェント | `~/.claude/` （`settings.json`、CLAUDE.md、ルール用）；`~/.claude/skills/`、`~/.claude/commands/`、`~/.claude/agents/` （スキル、コマンド、サブエージェント用） |81| `"user"` | ユーザー `settings.json`；ユーザー CLAUDE.md と `~/.claude/rules/*.md`；ユーザースキル、コマンド、サブエージェント | `~/.claude/` （`settings.json`、CLAUDE.md、ルール用）；`~/.claude/skills/`、`~/.claude/commands/`、`~/.claude/agents/` （スキル、コマンド、サブエージェント用） |

82| `"local"` | CLAUDE.local.md、`.claude/settings.local.json` | `<cwd>/.claude/` （`settings.local.json` 用）；CLAUDE.local.md 用に `<cwd>` と全親ディレクトリ |82| `"local"` | CLAUDE.local.md、`.claude/settings.local.json` | `<cwd>/.claude/` （`settings.local.json` 用）；CLAUDE.local.md 用に `<cwd>` と全親ディレクトリ |

92`settingSources` はユーザー、プロジェクト、ローカル設定をカバーします。その値に関係なく読み込まれるいくつかの入力があります。92`settingSources` はユーザー、プロジェクト、ローカル設定をカバーします。その値に関係なく読み込まれるいくつかの入力があります。

93 93 

94| 入力 | 動作 | 無効にするには |94| 入力 | 動作 | 無効にするには |

95| :------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- |95| :- | :- | :- |

96| マネージドポリシー設定 | エンドポイント管理ポリシー（MDM plist、レジストリポリシー、またはマネージド設定ファイルなど）はホストから読み込まれます。[サーバー管理設定](/docs/ja/server-managed-settings)は、組織 OAuth ログイン、直接構成された API キー、または `user_oauth` [Anthropic プロファイル](/docs/ja/authentication#anthropic-profiles-and-federation-credentials)などの適格な認証情報でセッションが認証されるときに、[対象となる構成](/docs/ja/server-managed-settings#platform-availability)で取得されます | エンドポイントポリシー：ホストからマネージド設定ファイル、plist、またはレジストリポリシーを削除します。サーバー管理設定：Claude 組織の[オーナー](/docs/ja/server-managed-settings#access-control)によって制御されます；SDK から無効にすることはできません |96| マネージドポリシー設定 | エンドポイント管理ポリシー（MDM plist、レジストリポリシー、またはマネージド設定ファイルなど）はホストから読み込まれます。[サーバー管理設定](/docs/ja/server-managed-settings)は、組織 OAuth ログイン、直接構成された API キー、または `user_oauth` [Anthropic プロファイル](/docs/ja/authentication#anthropic-profiles-and-federation-credentials)などの適格な認証情報でセッションが認証されるときに、[対象となる構成](/docs/ja/server-managed-settings#platform-availability)で取得されます | エンドポイントポリシー：ホストからマネージド設定ファイル、plist、またはレジストリポリシーを削除します。サーバー管理設定：Claude 組織の[オーナー](/docs/ja/server-managed-settings#access-control)によって制御されます；SDK から無効にすることはできません |

97| `~/.claude.json` グローバル設定 | 常に読み込まれます | `env` の `CLAUDE_CONFIG_DIR` で再配置します |97| `~/.claude.json` グローバル設定 | 常に読み込まれます | `env` の `CLAUDE_CONFIG_DIR` で再配置します |

98| `~/.claude/projects/<project>/memory/` の自動メモリ | セッション開始時にシステムプロンプトに読み込まれます。エージェントは専用のメモリツールではなく、標準の `Write` および `Edit` ツールを使用して新しいメモリをそこに書き込むため、エージェントがメモリを保存するにはこれらのツールを有効にする必要があります。 | 設定で `autoMemoryEnabled: false` を設定するか、`env` で `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` を設定します |98| `~/.claude/projects/<project>/memory/` の自動メモリ | セッション開始時にシステムプロンプトに読み込まれます。エージェントは専用のメモリツールではなく、標準の `Write` および `Edit` ツールを使用して新しいメモリをそこに書き込むため、エージェントがメモリを保存するにはこれらのツールを有効にする必要があります。 | 設定で `autoMemoryEnabled: false` を設定するか、`env` で `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` を設定します |

114</h3>114</h3>

115 115 

116| レベル | 場所 | 読み込まれるとき |116| レベル | 場所 | 読み込まれるとき |

117| :-------------- | :------------------------------------------------------------------------- | :---------------------------------------------------------------------------- |117| :- | :- | :- |

118| プロジェクト（ルート） | `<cwd>/CLAUDE.md` または `<cwd>/.claude/CLAUDE.md` | `settingSources` に `"project"` が含まれる |118| プロジェクト（ルート） | `<cwd>/CLAUDE.md` または `<cwd>/.claude/CLAUDE.md` | `settingSources` に `"project"` が含まれる |

119| プロジェクトルール | `<cwd>/.claude/rules/*.md` および `cwd` より上のすべての親ディレクトリの `.claude/rules/*.md` | `settingSources` に `"project"` が含まれる |119| プロジェクトルール | `<cwd>/.claude/rules/*.md` および `cwd` より上のすべての親ディレクトリの `.claude/rules/*.md` | `settingSources` に `"project"` が含まれる |

120| プロジェクト（親ディレクトリ） | `cwd` より上のディレクトリの `CLAUDE.md` ファイル | `settingSources` に `"project"` が含まれ、セッション開始時に読み込まれます |120| プロジェクト（親ディレクトリ） | `cwd` より上のディレクトリの `CLAUDE.md` ファイル | `settingSources` に `"project"` が含まれ、セッション開始時に読み込まれます |

286</h3>286</h3>

287 287 

288| フックタイプ | 最適な用途 |288| フックタイプ | 最適な用途 |

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

290| **ファイルシステム** （`settings.json`） | CLI と SDK セッション間でフックを共有します。`"command"`（シェルスクリプト）、`"http"`（エンドポイントへの POST）、`"mcp_tool"`（接続された MCP サーバーのツールを呼び出す）、`"prompt"`（LLM がプロンプトを評価する）、`"agent"`（検証エージェントを生成する）をサポートします。これらはメインエージェントとそれが生成するサブエージェントで実行されます。 |290| **ファイルシステム** （`settings.json`） | CLI と SDK セッション間でフックを共有します。`"command"`（シェルスクリプト）、`"http"`（エンドポイントへの POST）、`"mcp_tool"`（接続された MCP サーバーのツールを呼び出す）、`"prompt"`（LLM がプロンプトを評価する）、`"agent"`（検証エージェントを生成する）をサポートします。これらはメインエージェントとそれが生成するサブエージェントで実行されます。 |

291| **プログラマティック** （`query()` のコールバック） | アプリケーション固有のロジック、構造化された決定、およびプロセス内統合。これらはサブエージェント内でも実行されます。フック入力（コールバックの最初の引数）は、どのエージェントがフックを実行したかを識別する `agent_id` と `agent_type` フィールドを含みます。 |291| **プログラマティック** （`query()` のコールバック） | アプリケーション固有のロジック、構造化された決定、およびプロセス内統合。これらはサブエージェント内でも実行されます。フック入力（コールバックの最初の引数）は、どのエージェントがフックを実行したかを識別する `agent_id` と `agent_type` フィールドを含みます。 |

292 292 

303Agent SDK は、エージェントの動作を拡張するいくつかの方法へのアクセスを提供します。どれを使用するか不確かな場合、このテーブルは一般的な目標を正しいアプローチにマップします。303Agent SDK は、エージェントの動作を拡張するいくつかの方法へのアクセスを提供します。どれを使用するか不確かな場合、このテーブルは一般的な目標を正しいアプローチにマップします。

304 304 

305| 実現したいこと | 使用 | SDK サーフェス |305| 実現したいこと | 使用 | SDK サーフェス |

306| :------------------------------------------------------ | :-------------------------------------------- | :----------------------------------------------------------------------------------- |306| :- | :- | :- |

307| エージェントが常に従うプロジェクト規約を設定する | [CLAUDE.md](/docs/ja/memory) | `settingSources: ["project"]` がそれを自動的に読み込みます |307| エージェントが常に従うプロジェクト規約を設定する | [CLAUDE.md](/docs/ja/memory) | `settingSources: ["project"]` がそれを自動的に読み込みます |

308| エージェントが関連するときに読み込む参考資料を提供する | [Skills](/docs/ja/agent-sdk/skills) | `settingSources` + `skills` オプション |308| エージェントが関連するときに読み込む参考資料を提供する | [Skills](/docs/ja/agent-sdk/skills) | `settingSources` + `skills` オプション |

309| 再利用可能なワークフロー（デプロイ、レビュー、リリース）を実行する | [User-invocable skills](/docs/ja/agent-sdk/skills) | `settingSources` + `skills` オプション |309| 再利用可能なワークフロー（デプロイ、レビュー、リリース）を実行する | [User-invocable skills](/docs/ja/agent-sdk/skills) | `settingSources` + `skills` オプション |

287以下の表は、各オプションをそれが設定する機能にマップします。このページでカバーされていないオプションについては、[TypeScript](/docs/ja/agent-sdk/typescript#options) および [Python](/docs/ja/agent-sdk/python#claudeagentoptions) リファレンスを参照してください。目標は知っているが、どのオプションがそれを提供するかわからない場合は、[正しい機能を選択する](/docs/ja/agent-sdk/claude-code-features#choose-the-right-feature)から始めてください。287以下の表は、各オプションをそれが設定する機能にマップします。このページでカバーされていないオプションについては、[TypeScript](/docs/ja/agent-sdk/typescript#options) および [Python](/docs/ja/agent-sdk/python#claudeagentoptions) リファレンスを参照してください。目標は知っているが、どのオプションがそれを提供するかわからない場合は、[正しい機能を選択する](/docs/ja/agent-sdk/claude-code-features#choose-the-right-feature)から始めてください。

288 288 

289| TypeScript | Python | 制御 | カバー対象 |289| TypeScript | Python | 制御 | カバー対象 |

290| ------------------------- | --------------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |290| - | - | - | - |

291| `permissionMode` | `permission_mode` | エージェントが承認なしでできることは何か | [権限を設定する](/docs/ja/agent-sdk/permissions) |291| `permissionMode` | `permission_mode` | エージェントが承認なしでできることは何か | [権限を設定する](/docs/ja/agent-sdk/permissions) |

292| `allowedTools` | `allowed_tools` | どのツール呼び出しが事前承認されるか | [権限を設定する](/docs/ja/agent-sdk/permissions) |292| `allowedTools` | `allowed_tools` | どのツール呼び出しが事前承認されるか | [権限を設定する](/docs/ja/agent-sdk/permissions) |

293| `canUseTool` | `can_use_tool` | ツール呼び出しの承認コールバック | [ツール承認リクエストを処理する](/docs/ja/agent-sdk/user-input#handle-tool-approval-requests) |293| `canUseTool` | `can_use_tool` | ツール呼び出しの承認コールバック | [ツール承認リクエストを処理する](/docs/ja/agent-sdk/user-input#handle-tool-approval-requests) |

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

97 97 

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

99| ---------------------------- | ---------------------------------------------------------- |99| - | - |

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

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

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

13</h2>13</h2>

14 14 

15| 実行したい操作 | 方法 |15| 実行したい操作 | 方法 |

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

17| ツールを定義する | Python では [`@tool`](/docs/ja/agent-sdk/python#tool)、TypeScript では [`tool()`](/docs/ja/agent-sdk/typescript#tool) を使用して、名前、説明、スキーマ、ハンドラーを指定します。[カスタムツールを作成する](#create-a-custom-tool)を参照してください。 |17| ツールを定義する | Python では [`@tool`](/docs/ja/agent-sdk/python#tool)、TypeScript では [`tool()`](/docs/ja/agent-sdk/typescript#tool) を使用して、名前、説明、スキーマ、ハンドラーを指定します。[カスタムツールを作成する](#create-a-custom-tool)を参照してください。 |

18| Claude にツールを登録する | `create_sdk_mcp_server` / `createSdkMcpServer` でラップし、`query()` の `mcpServers` に渡します。[カスタムツールを呼び出す](#call-a-custom-tool)を参照してください。 |18| Claude にツールを登録する | `create_sdk_mcp_server` / `createSdkMcpServer` でラップし、`query()` の `mcpServers` に渡します。[カスタムツールを呼び出す](#call-a-custom-tool)を参照してください。 |

19| ツールを事前承認する | 許可されたツールに追加します。[許可されたツールを設定する](#configure-allowed-tools)を参照してください。 |19| ツールを事前承認する | 許可されたツールに追加します。[許可されたツールを設定する](#configure-allowed-tools)を参照してください。 |

282[ツール注釈](https://modelcontextprotocol.io/docs/concepts/tools#tool-annotations)は、ツールの動作を説明するオプションのメタデータです。TypeScript の `tool()` ヘルパーの 5 番目の引数として、または Python の `@tool` デコレーターの `annotations` キーワード引数経由で渡します。すべてのヒントフィールドはブール値です。282[ツール注釈](https://modelcontextprotocol.io/docs/concepts/tools#tool-annotations)は、ツールの動作を説明するオプションのメタデータです。TypeScript の `tool()` ヘルパーの 5 番目の引数として、または Python の `@tool` デコレーターの `annotations` キーワード引数経由で渡します。すべてのヒントフィールドはブール値です。

283 283 

284| フィールド | デフォルト | 意味 |284| フィールド | デフォルト | 意味 |

285| :---------------- | :------ | :------------------------------------------------ |285| :- | :- | :- |

286| `readOnlyHint` | `false` | ツールは環境を変更しません。ツールを他の読み取り専用ツールと並列で呼び出せるかどうかを制御します。 |286| `readOnlyHint` | `false` | ツールは環境を変更しません。ツールを他の読み取り専用ツールと並列で呼び出せるかどうかを制御します。 |

287| `destructiveHint` | `true` | ツールは破壊的な更新を実行する可能性があります。情報提供のみ。 |287| `destructiveHint` | `true` | ツールは破壊的な更新を実行する可能性があります。情報提供のみ。 |

288| `idempotentHint` | `false` | 同じ引数での繰り返し呼び出しは追加の効果がありません。情報提供のみ。 |288| `idempotentHint` | `false` | 同じ引数での繰り返し呼び出しは追加の効果がありません。情報提供のみ。 |

338`tools` オプションと許可/禁止リストは、2 つのレイヤーに影響します。可用性はツールが Claude のコンテキストに表示されるかどうかを制御し、権限は Claude がツールを試みた後に呼び出しが承認されるかどうかを制御します。`tools` と単純名の `disallowedTools` エントリは可用性を変更します。`allowedTools` とスコープ付き `disallowedTools` ルールは権限を変更します。[タスク追跡ツール](/docs/ja/agent-sdk/todo-tracking#model-availability)の 1 つを `allowedTools` に名前を付けた場合、Claude Code もセッションをオプトインします。338`tools` オプションと許可/禁止リストは、2 つのレイヤーに影響します。可用性はツールが Claude のコンテキストに表示されるかどうかを制御し、権限は Claude がツールを試みた後に呼び出しが承認されるかどうかを制御します。`tools` と単純名の `disallowedTools` エントリは可用性を変更します。`allowedTools` とスコープ付き `disallowedTools` ルールは権限を変更します。[タスク追跡ツール](/docs/ja/agent-sdk/todo-tracking#model-availability)の 1 つを `allowedTools` に名前を付けた場合、Claude Code もセッションをオプトインします。

339 339 

340| オプション | レイヤー | 効果 |340| オプション | レイヤー | 効果 |

341| :------------------------ | :--- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |341| :- | :- | :- |

342| `tools: ["Read", "Grep"]` | 可用性 | リストされた組み込みツールのみが Claude のコンテキストに含まれます。リストされていない組み込みツールは削除されます。MCP ツールは影響を受けません。 |342| `tools: ["Read", "Grep"]` | 可用性 | リストされた組み込みツールのみが Claude のコンテキストに含まれます。リストされていない組み込みツールは削除されます。MCP ツールは影響を受けません。 |

343| `tools: []` | 可用性 | すべての組み込みツールが削除されます。Claude は MCP ツールのみを使用できます。 |343| `tools: []` | 可用性 | すべての組み込みツールが削除されます。Claude は MCP ツールのみを使用できます。 |

344| 許可されたツール | 権限 | リストされたツールは権限プロンプトなしで実行されます。その他のリストされていないツールは利用可能なままです。呼び出しは[権限フロー](/docs/ja/agent-sdk/permissions)を通じて行われます。 |344| 許可されたツール | 権限 | リストされたツールは権限プロンプトなしで実行されます。その他のリストされていないツールは利用可能なままです。呼び出しは[権限フロー](/docs/ja/agent-sdk/permissions)を通じて行われます。 |

353ハンドラーエラーはエージェントループを停止しません。SDK のインプロセス MCP サーバーはキャッチされない例外をキャッチし、エラー結果として返すため、エラーをどのように報告するかが Claude が読む内容を決定します。クエリが失敗するかどうかではありません。353ハンドラーエラーはエージェントループを停止しません。SDK のインプロセス MCP サーバーはキャッチされない例外をキャッチし、エラー結果として返すため、エラーをどのように報告するかが Claude が読む内容を決定します。クエリが失敗するかどうかではありません。

354 354 

355| 何が起こるか | 結果 |355| 何が起こるか | 結果 |

356| :------------------------------------------------------------------ | :---------------------------------------------------------------------------- |356| :- | :- |

357| ハンドラーがキャッチされない例外をスロー | MCP サーバーはそれをエラー結果に変換し、生の例外メッセージを含めます。Claude はそのメッセージを見て、エージェントループは続行します。 |357| ハンドラーがキャッチされない例外をスロー | MCP サーバーはそれをエラー結果に変換し、生の例外メッセージを含めます。Claude はそのメッセージを見て、エージェントループは続行します。 |

358| ハンドラーがエラーをキャッチして `isError: true`（TS）/ `"is_error": True`（Python）を返す | Claude はあなたが作成したメッセージを見ます。生の例外が欠いているコンテキスト（どのリクエストが失敗したか、代わりに何を試すかなど）を追加できます。 |358| ハンドラーがエラーをキャッチして `isError: true`（TS）/ `"is_error": True`（Python）を返す | Claude はあなたが作成したメッセージを見ます。生の例外が欠いているコンテキスト（どのリクエストが失敗したか、代わりに何を試すかなど）を追加できます。 |

359 359 

472画像ブロックは、画像バイトをインラインで、base64 としてエンコードされた形式で保持します。URL フィールドはありません。URL に存在する画像を返すには、ハンドラー内でそれをフェッチし、レスポンスバイトを読み取り、返す前に base64 エンコードしてください。結果は視覚入力として処理されます。472画像ブロックは、画像バイトをインラインで、base64 としてエンコードされた形式で保持します。URL フィールドはありません。URL に存在する画像を返すには、ハンドラー内でそれをフェッチし、レスポンスバイトを読み取り、返す前に base64 エンコードしてください。結果は視覚入力として処理されます。

473 473 

474| フィールド | 型 | 注記 |474| フィールド | 型 | 注記 |

475| :--------- | :-------- | :----------------------------------------------------------------- |475| :- | :- | :- |

476| `type` | `"image"` | |476| `type` | `"image"` | |

477| `data` | `string` | Base64 エンコードされたバイト。生の base64 のみ、`data:image/...;base64,` プレフィックスなし |477| `data` | `string` | Base64 エンコードされたバイト。生の base64 のみ、`data:image/...;base64,` プレフィックスなし |

478| `mimeType` | `string` | 必須。例えば `image/png`、`image/jpeg`、`image/webp`、`image/gif` |478| `mimeType` | `string` | 必須。例えば `image/png`、`image/jpeg`、`image/webp`、`image/gif` |

541リソースブロックは、URI で識別されるコンテンツを埋め込みます。URI はコンテンツの参照用ラベルです。実際のコンテンツはブロックの `text` または `blob` フィールドに含まれます。これは、ツールが後で名前で参照することが理にかなったもの（生成されたファイルや外部システムのレコードなど）を生成する場合に使用します。541リソースブロックは、URI で識別されるコンテンツを埋め込みます。URI はコンテンツの参照用ラベルです。実際のコンテンツはブロックの `text` または `blob` フィールドに含まれます。これは、ツールが後で名前で参照することが理にかなったもの（生成されたファイルや外部システムのレコードなど）を生成する場合に使用します。

542 542 

543| フィールド | 型 | 注記 |543| フィールド | 型 | 注記 |

544| :------------------ | :----------- | :------------------------------------------------------------------------------------- |544| :- | :- | :- |

545| `type` | `"resource"` | |545| `type` | `"resource"` | |

546| `resource.uri` | `string` | コンテンツの識別子。任意の URI スキーム |546| `resource.uri` | `string` | コンテンツの識別子。任意の URI スキーム |

547| `resource.text` | `string` | テキストの場合のコンテンツ。これまたは `blob` を提供します。両方ではなく |547| `resource.text` | `string` | テキストの場合のコンテンツ。これまたは `blob` を提供します。両方ではなく |

149 checkpointing を有効にして checkpoint UUID を受け取るように SDK オプションを設定します：149 checkpointing を有効にして checkpoint UUID を受け取るように SDK オプションを設定します：

150 150 

151 | オプション | Python | TypeScript | 説明 |151 | オプション | Python | TypeScript | 説明 |

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

153 | checkpointing を有効にする | `enable_file_checkpointing=True` | `enableFileCheckpointing: true` | 巻き戻しのためのファイル変更を追跡します |153 | checkpointing を有効にする | `enable_file_checkpointing=True` | `enableFileCheckpointing: true` | 巻き戻しのためのファイル変更を追跡します |

154 | checkpoint UUID を受け取る | `extra_args={"replay-user-messages": None}` | `extraArgs: { 'replay-user-messages': null }` | ストリーム内でユーザーメッセージ UUID を取得するために必須 |154 | checkpoint UUID を受け取る | `extra_args={"replay-user-messages": None}` | `extraArgs: { 'replay-user-messages': null }` | ストリーム内でユーザーメッセージ UUID を取得するために必須 |

155 155 

715ファイル checkpointing には、次の制限事項があります：715ファイル checkpointing には、次の制限事項があります：

716 716 

717| 制限事項 | 説明 |717| 制限事項 | 説明 |

718| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |718| - | - |

719| Write/Edit/NotebookEdit ツールのみ | Bash コマンドを通じて行われた変更は追跡されません |719| Write/Edit/NotebookEdit ツールのみ | Bash コマンドを通じて行われた変更は追跡されません |

720| Subagent の編集 | [subagent](/docs/ja/agent-sdk/subagents) が適用する編集は追跡または復元されません。ただし、`context: fork` を使用して foreground で実行されるスキルは除きます。追跡されていない編集を戻すには git を使用してください |720| Subagent の編集 | [subagent](/docs/ja/agent-sdk/subagents) が適用する編集は追跡または復元されません。ただし、`context: fork` を使用して foreground で実行されるスキルは除きます。追跡されていない編集を戻すには git を使用してください |

721| 同じセッション | Checkpoint は、それを作成したセッションに関連付けられています |721| 同じセッション | Checkpoint は、それを作成したセッションに関連付けられています |

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` | はい | はい | ツール実行失敗 | ツールエラーを処理またはログする |

230SDK マッチャーは[設定ファイルのマッチャー](/docs/ja/hooks#matcher-patterns)と同じルールに従います。そのセクションでは、正確な文字列と正規表現の評価パス、バージョン要件、および各イベントタイプのマッチャー値を文書化しています。230SDK マッチャーは[設定ファイルのマッチャー](/docs/ja/hooks#matcher-patterns)と同じルールに従います。そのセクションでは、正確な文字列と正規表現の評価パス、バージョン要件、および各イベントタイプのマッチャー値を文書化しています。

231 231 

232| オプション | 型 | デフォルト | 説明 |232| オプション | 型 | デフォルト | 説明 |

233| --------- | ---------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |233| - | - | - | - |

234| `matcher` | `string` | `undefined` | イベントのフィルタフィールドに対してマッチングされるパターン。[設定ファイルのマッチャーのルール](/docs/ja/hooks#matcher-patterns)に従います。ツールフックの場合、これはツール名です。組み込みツールには `Bash`、`Read`、`Write`、`Edit`、`Glob`、`Grep`、`WebFetch`、`Agent` などが含まれます（完全なリストについては[ツール入力型](/docs/ja/agent-sdk/typescript#tool-input-types)を参照）。MCP ツールはパターン `mcp__<server>__<action>` を使用します。ここで `<server>` は `mcpServers` 設定で使用するキーです。 |234| `matcher` | `string` | `undefined` | イベントのフィルタフィールドに対してマッチングされるパターン。[設定ファイルのマッチャーのルール](/docs/ja/hooks#matcher-patterns)に従います。ツールフックの場合、これはツール名です。組み込みツールには `Bash`、`Read`、`Write`、`Edit`、`Glob`、`Grep`、`WebFetch`、`Agent` などが含まれます（完全なリストについては[ツール入力型](/docs/ja/agent-sdk/typescript#tool-input-types)を参照）。MCP ツールはパターン `mcp__<server>__<action>` を使用します。ここで `<server>` は `mcpServers` 設定で使用するキーです。 |

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

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

295</CodeGroup>295</CodeGroup>

296 296 

297| フィールド | 型 | 説明 |297| フィールド | 型 | 説明 |

298| -------------- | -------- | ----------------------------------------------------------------------- |298| - | - | - |

299| `async` | `true` | 非同期モードを通知します。エージェントは待たずに続行します。Python では、予約キーワードを避けるために `async_` を使用します。 |299| `async` | `true` | 非同期モードを通知します。エージェントは待たずに続行します。Python では、予約キーワードを避けるために `async_` を使用します。 |

300| `asyncTimeout` | `number` | バックグラウンド操作のオプションのタイムアウト（ミリ秒単位） |300| `asyncTimeout` | `number` | バックグラウンド操作のオプションのタイムアウト（ミリ秒単位） |

301 301 

633 種類のエージェント状態がデフォルトでコンテナのファイルシステムに存在します。これらのいずれも、コンテナの再起動、スケールダウン、または別のノードへの移動を経ても保持されません。633 種類のエージェント状態がデフォルトでコンテナのファイルシステムに存在します。これらのいずれも、コンテナの再起動、スケールダウン、または別のノードへの移動を経ても保持されません。

64 64 

65| 状態 | デフォルトの場所 |65| 状態 | デフォルトの場所 |

66| ------------------- | ---------------------------------------------------------------------------------------------------- |66| - | - |

67| セッショントランスクリプト | `~/.claude/projects/`、または `CLAUDE_CONFIG_DIR` が設定されている場合は `CLAUDE_CONFIG_DIR` の下の `projects/` ディレクトリ |67| セッショントランスクリプト | `~/.claude/projects/`、または `CLAUDE_CONFIG_DIR` が設定されている場合は `CLAUDE_CONFIG_DIR` の下の `projects/` ディレクトリ |

68| `CLAUDE.md` メモリファイル | ユーザーティアの場合は `~/.claude/CLAUDE.md`、プロジェクトティアの場合はセッションの作業ディレクトリ |68| `CLAUDE.md` メモリファイル | ユーザーティアの場合は `~/.claude/CLAUDE.md`、プロジェクトティアの場合はセッションの作業ディレクトリ |

69| 作業ディレクトリアーティファクト | セッションの作業ディレクトリ |69| 作業ディレクトリアーティファクト | セッションの作業ディレクトリ |

379デプロイメント設計でこれらを考慮してください。379デプロイメント設計でこれらを考慮してください。

380 380 

381| 制限事項 | 対応方法 |381| 制限事項 | 対応方法 |

382| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |382| - | - |

383| トップレベルのセッションタイムアウトがない | セッションは自動的にタイムアウトしません。TypeScript の `maxTurns` または Python の `max_turns` を設定して、エージェントがツール使用ラウンドトリップを実行する回数を制限してから停止させます。 |383| トップレベルのセッションタイムアウトがない | セッションは自動的にタイムアウトしません。TypeScript の `maxTurns` または Python の `max_turns` を設定して、エージェントがツール使用ラウンドトリップを実行する回数を制限してから停止させます。 |

384| 長いセッションでのメモリ増加 | セッション長を制限するか、サブプロセスを定期的にリサイクルしてください。[スケーリングと並行処理](#scaling-and-concurrency)を参照してください。 |384| 長いセッションでのメモリ増加 | セッション長を制限するか、サブプロセスを定期的にリサイクルしてください。[スケーリングと並行処理](#scaling-and-concurrency)を参照してください。 |

385| 大規模な並列サブエージェントのファンアウトがレート制限に達する可能性がある | 1 つの広いディスパッチを発行するのではなく、作業をより小さなバッチに分割してください。 |385| 大規模な並列サブエージェントのファンアウトがレート制限に達する可能性がある | 1 つの広いディスパッチを発行するのではなく、作業をより小さなバッチに分割してください。 |

159Claude Code は `options.mcpServers` で渡すサーバーをスタートアップ時に登録し、最初のターンの待機（存在する場合）が解決されると [init メッセージ](#error-handling) を発行します。各 `options.mcpServers` サーバーが最初のターンを遅延させるかどうか、および接続するタイミングは、そのタイプによって異なります。159Claude Code は `options.mcpServers` で渡すサーバーをスタートアップ時に登録し、最初のターンの待機（存在する場合）が解決されると [init メッセージ](#error-handling) を発行します。各 `options.mcpServers` サーバーが最初のターンを遅延させるかどうか、および接続するタイミングは、そのタイプによって異なります。

160 160 

161| サーバータイプ | 最初のターンを遅延させるか | 最初のターン待機タイムアウト |161| サーバータイプ | 最初のターンを遅延させるか | 最初のターン待機タイムアウト |

162| :------------------------------------------------ | :--------------------------- | :------------------------------------------------------ |162| :- | :- | :- |

163| stdio サーバー、またはキャッシュされたツールリストのない HTTP/SSE サーバー | はい、接続されるまで | [`MCP_TIMEOUT`](/docs/ja/env-vars)、デフォルトは 30 秒。接続はその期限で失敗します |163| stdio サーバー、またはキャッシュされたツールリストのない HTTP/SSE サーバー | はい、接続されるまで | [`MCP_TIMEOUT`](/docs/ja/env-vars)、デフォルトは 30 秒。接続はその期限で失敗します |

164| キャッシュされたツールリストを持つリモートサーバー（Claude Code が以前の接続から保存） | いいえ。キャッシュされたツールは最初のターンから利用可能 | なし。最初のツール呼び出しで接続し、その遅延接続には独自のタイムアウトがあります |164| キャッシュされたツールリストを持つリモートサーバー（Claude Code が以前の接続から保存） | いいえ。キャッシュされたツールは最初のターンから利用可能 | なし。最初のツール呼び出しで接続し、その遅延接続には独自のタイムアウトがあります |

165| インプロセス [SDK サーバー](#sdk-mcp-servers) | はい、接続してツールをリストするまで | なし。接続とツールリスティングリクエストはそれぞれ独自のタイムアウトを持ちます |165| インプロセス [SDK サーバー](#sdk-mcp-servers) | はい、接続してツールをリストするまで | なし。接続とツールリスティングリクエストはそれぞれ独自のタイムアウトを持ちます |

19</h2>19</h2>

20 20 

21| 項目 | 旧版 | 新版 |21| 項目 | 旧版 | 新版 |

22| :---------------- | :-------------------------- | :----------------------------------------------------------------- |22| :- | :- | :- |

23| **パッケージ名（TS/JS）** | `@anthropic-ai/claude-code` | `@anthropic-ai/claude-agent-sdk` |23| **パッケージ名（TS/JS）** | `@anthropic-ai/claude-code` | `@anthropic-ai/claude-agent-sdk` |

24| **Python パッケージ** | `claude-code-sdk` | `claude-agent-sdk` |24| **Python パッケージ** | `claude-code-sdk` | `claude-agent-sdk` |

25| **ドキュメント場所** | Claude Code ドキュメント | Claude Code ドキュメント → 専用の [Agent SDK](/docs/ja/agent-sdk/overview) セクション |25| **ドキュメント場所** | Claude Code ドキュメント | Claude Code ドキュメント → 専用の [Agent SDK](/docs/ja/agent-sdk/overview) セクション |

25決定要因は、エージェントが Claude Code にどの程度似ているかです：リポジトリで動作するコーディングエージェント。人間がストリーミング出力を監視して作業を指導します。製品がそれから遠いほど、独自のプロンプトを作成する必要があります。25決定要因は、エージェントが Claude Code にどの程度似ているかです：リポジトリで動作するコーディングエージェント。人間がストリーミング出力を監視して作業を指導します。製品がそれから遠いほど、独自のプロンプトを作成する必要があります。

26 26 

27| 構築しているもの | 使用するもの | 得られるもの |27| 構築しているもの | 使用するもの | 得られるもの |

28| :------------------------------------------------------------- | :------------------------------- | :------------------------------------------------------ |28| :- | :- | :- |

29| 人間が監視して指導する CLI または IDE のようなコーディングツール。Claude Code のデフォルトが必要なもの | `claude_code` プリセット | Claude Code プロンプト（ツールガイダンス、安全ルール、環境コンテキストを含む） |29| 人間が監視して指導する CLI または IDE のようなコーディングツール。Claude Code のデフォルトが必要なもの | `claude_code` プリセット | Claude Code プロンプト（ツールガイダンス、安全ルール、環境コンテキストを含む） |

30| 同じ種類のツール、プラス、コーディング標準、出力形式、またはドメインコンテキストなどの製品固有のルール | `claude_code` プリセット（`append` 付き） | 上記のすべて。プリセットの後に命令が追加されます。何も削除されないため、これは最もリスクが低いカスタマイズです |30| 同じ種類のツール、プラス、コーディング標準、出力形式、またはドメインコンテキストなどの製品固有のルール | `claude_code` プリセット（`append` 付き） | 上記のすべて。プリセットの後に命令が追加されます。何も削除されないため、これは最もリスクが低いカスタマイズです |

31| 異なるサーフェス、アイデンティティ、または権限モデルを持つエージェント、またはコーディング以外のエージェント | カスタムプロンプト文字列 | 作成したもののみ。エージェントが必要とするツールガイダンスと安全命令を置き換える責任があります |31| 異なるサーフェス、アイデンティティ、または権限モデルを持つエージェント、またはコーディング以外のエージェント | カスタムプロンプト文字列 | 作成したもののみ。エージェントが必要とするツールガイダンスと安全命令を置き換える責任があります |

4254 つのカスタマイズ方法は、どこに存在するか、どのように共有されるか、および `claude_code` プリセットから何を保持するかが異なります。4254 つのカスタマイズ方法は、どこに存在するか、どのように共有されるか、および `claude_code` プリセットから何を保持するかが異なります。

426 426 

427| 機能 | CLAUDE.md | 出力スタイル | `systemPrompt` を追加 | カスタム `systemPrompt` |427| 機能 | CLAUDE.md | 出力スタイル | `systemPrompt` を追加 | カスタム `systemPrompt` |

428| -------------- | ------------- | ------------- | ------------------ | ------------------- |428| - | - | - | - | - |

429| **永続性** | プロジェクトごとのファイル | ファイルとして保存 | セッションのみ | セッションのみ |429| **永続性** | プロジェクトごとのファイル | ファイルとして保存 | セッションのみ | セッションのみ |

430| **再利用性** | プロジェクトごと | プロジェクト全体 | コード重複 | コード重複 |430| **再利用性** | プロジェクトごと | プロジェクト全体 | コード重複 | コード重複 |

431| **管理** | ファイルシステム上 | CLI + ファイル | コード内 | コード内 |431| **管理** | ファイルシステム上 | CLI + ファイル | コード内 | コード内 |

31CLI は 3 つの独立した OpenTelemetry シグナルをエクスポートします。各シグナルには独自の有効化スイッチと独自のエクスポーターがあるため、必要なものだけをオンにできます。31CLI は 3 つの独立した OpenTelemetry シグナルをエクスポートします。各シグナルには独自の有効化スイッチと独自のエクスポーターがあるため、必要なものだけをオンにできます。

32 32 

33| シグナル | 含まれるもの | 有効化方法 |33| シグナル | 含まれるもの | 有効化方法 |

34| ------ | ---------------------------------------- | ---------------------------------------------------------------- |34| - | - | - |

35| メトリクス | トークン、コスト、セッション、コード行数、ツール決定のカウンター | `OTEL_METRICS_EXPORTER` |35| メトリクス | トークン、コスト、セッション、コード行数、ツール決定のカウンター | `OTEL_METRICS_EXPORTER` |

36| ログイベント | 各プロンプト、API リクエスト、API エラー、ツール結果の構造化レコード | `OTEL_LOGS_EXPORTER` |36| ログイベント | 各プロンプト、API リクエスト、API エラー、ツール結果の構造化レコード | `OTEL_LOGS_EXPORTER` |

37| トレース | 各インタラクション、モデルリクエスト、ツール呼び出し、フック（ベータ版）のスパン | `OTEL_TRACES_EXPORTER` と `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1` |37| トレース | 各インタラクション、モデルリクエスト、ツール呼び出し、フック（ベータ版）のスパン | `OTEL_TRACES_EXPORTER` と `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1` |

244テレメトリはデフォルトで構造化されています。期間、モデル名、ツール名はすべてのスパンに記録されます。トークンカウントは基になる API リクエストが使用データを返すときに記録されるため、失敗または中止されたリクエストのスパンはそれらを省略する可能性があります。エージェントが読み取り、書き込むコンテンツはデフォルトでは記録されません。これらのオプトイン変数は、エクスポートされたデータにコンテンツを追加します。244テレメトリはデフォルトで構造化されています。期間、モデル名、ツール名はすべてのスパンに記録されます。トークンカウントは基になる API リクエストが使用データを返すときに記録されるため、失敗または中止されたリクエストのスパンはそれらを省略する可能性があります。エージェントが読み取り、書き込むコンテンツはデフォルトでは記録されません。これらのオプトイン変数は、エクスポートされたデータにコンテンツを追加します。

245 245 

246| 変数 | 追加内容 |246| 変数 | 追加内容 |

247| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |247| - | - |

248| `OTEL_LOG_USER_PROMPTS=1` | `claude_code.user_prompt` イベントと `claude_code.interaction` スパンのプロンプトテキスト |248| `OTEL_LOG_USER_PROMPTS=1` | `claude_code.user_prompt` イベントと `claude_code.interaction` スパンのプロンプトテキスト |

249| `OTEL_LOG_TOOL_DETAILS=1` | `claude_code.tool_result` イベントのツール入力引数（ファイルパス、シェルコマンド、検索パターン） |249| `OTEL_LOG_TOOL_DETAILS=1` | `claude_code.tool_result` イベントのツール入力引数（ファイルパス、シェルコマンド、検索パターン） |

250| `OTEL_LOG_TOOL_CONTENT=1` | `claude_code.tool` の [`tool.output` スパンイベント](/docs/ja/monitoring-usage#tool-output-span-event)とファイルコンテンツと Bash 出力を含み、デフォルトで 60 KB で切り詰められ、`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` で設定可能です。Claude Code v2.1.214 以降が必要です。[トレース](#read-agent-traces)が有効になっている必要があります。スパン属性は [独自のゲート](/docs/ja/monitoring-usage#new-context-gates)の下でツールコンテンツを保持します |250| `OTEL_LOG_TOOL_CONTENT=1` | `claude_code.tool` の [`tool.output` スパンイベント](/docs/ja/monitoring-usage#tool-output-span-event)とファイルコンテンツと Bash 出力を含み、デフォルトで 60 KB で切り詰められ、`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` で設定可能です。Claude Code v2.1.214 以降が必要です。[トレース](#read-agent-traces)が有効になっている必要があります。スパン属性は [独自のゲート](/docs/ja/monitoring-usage#new-context-gates)の下でツールコンテンツを保持します |

15Agent SDK、CLI、Client SDK、および Managed Agents は、エージェントを実行するのは誰か、何が組み込まれているか、どのようにアクセスするかが異なります。構築して実行する方法に合致する行を見つけてください。15Agent SDK、CLI、Client SDK、および Managed Agents は、エージェントを実行するのは誰か、何が組み込まれているか、どのようにアクセスするかが異なります。構築して実行する方法に合致する行を見つけてください。

16 16 

17| 対象 | 使用するツール | 取得内容 |17| 対象 | 使用するツール | 取得内容 |

18| ------------------------------------------------------------------------ | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |18| - | - | - |

19| Claude Code のエージェントを自分で操作するプロセスで、独自の Python または TypeScript アプリケーションに埋め込む | **Agent SDK** | Claude Code バイナリを実行するライブラリで、組み込みツール、権限、セッション、hooks などの Claude Code の[機能](#capabilities)を備えています。 |19| Claude Code のエージェントを自分で操作するプロセスで、独自の Python または TypeScript アプリケーションに埋め込む | **Agent SDK** | Claude Code バイナリを実行するライブラリで、組み込みツール、権限、セッション、hooks などの Claude Code の[機能](#capabilities)を備えています。 |

20| ターミナルから対話的な開発またはワンオフタスクを実行する | [**Claude Code CLI**](/docs/ja/overview) | 日常的な対話的使用のために構築されたターミナルインターフェース。 |20| ターミナルから対話的な開発またはワンオフタスクを実行する | [**Claude Code CLI**](/docs/ja/overview) | 日常的な対話的使用のために構築されたターミナルインターフェース。 |

21| 独自のコードから Claude API を直接呼び出す | [**Client SDK**](https://platform.claude.com/docs/en/cli-sdks-libraries/overview) | クライアント SDK 言語のいずれからでも Claude API に直接アクセスできます。ツールループを自分で記述するか、クライアント SDK のベータ版[ツールランナー](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-runner)に駆動させることができます。 |21| 独自のコードから Claude API を直接呼び出す | [**Client SDK**](https://platform.claude.com/docs/en/cli-sdks-libraries/overview) | クライアント SDK 言語のいずれからでも Claude API に直接アクセスできます。ツールループを自分で記述するか、クライアント SDK のベータ版[ツールランナー](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-runner)に駆動させることができます。 |

30これらの Claude Code 機能は SDK で利用可能です。30これらの Claude Code 機能は SDK で利用可能です。

31 31 

32| 機能 | 機能 | 詳細を学ぶ |32| 機能 | 機能 | 詳細を学ぶ |

33| --------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |33| - | - | - |

34| 組み込みツール | ファイルの読み取り、書き込み、編集、コマンド実行、ウェブ検索 | [ツールリファレンス](/docs/ja/tools-reference) |34| 組み込みツール | ファイルの読み取り、書き込み、編集、コマンド実行、ウェブ検索 | [ツールリファレンス](/docs/ja/tools-reference) |

35| Hooks | エージェントライフサイクルの重要なポイントでカスタムコードを実行 | [Hooks](/docs/ja/agent-sdk/hooks) |35| Hooks | エージェントライフサイクルの重要なポイントでカスタムコードを実行 | [Hooks](/docs/ja/agent-sdk/hooks) |

36| Subagents | 特定のサブタスク用に特化したエージェントを生成 | [Subagents](/docs/ja/agent-sdk/subagents) |36| Subagents | 特定のサブタスク用に特化したエージェントを生成 | [Subagents](/docs/ja/agent-sdk/subagents) |

76`allowed_tools` と `disallowed_tools`（TypeScript：`allowedTools` / `disallowedTools`）は、上記の評価フロー内の許可ルールと拒否ルールリストにエントリを追加します。`allowed_tools` に[タスク追跡ツール](/docs/ja/agent-sdk/todo-tracking#model-availability)の 1 つを名前で指定すると、Claude Code もセッションをオプトインします。`allowed_tools` にリストされていない他のツールは、Claude でも利用可能であり、承認が必要なそのツールへの呼び出しは権限モードにフォールスルーします。拒否ルールは、ツール名を指定するか、ツール内のパターンをスコープするかによって動作が異なります。76`allowed_tools` と `disallowed_tools`（TypeScript：`allowedTools` / `disallowedTools`）は、上記の評価フロー内の許可ルールと拒否ルールリストにエントリを追加します。`allowed_tools` に[タスク追跡ツール](/docs/ja/agent-sdk/todo-tracking#model-availability)の 1 つを名前で指定すると、Claude Code もセッションをオプトインします。`allowed_tools` にリストされていない他のツールは、Claude でも利用可能であり、承認が必要なそのツールへの呼び出しは権限モードにフォールスルーします。拒否ルールは、ツール名を指定するか、ツール内のパターンをスコープするかによって動作が異なります。

77 77 

78| オプション | 効果 |78| オプション | 効果 |

79| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |79| :- | :- |

80| `allowed_tools=["Read", "Grep"]` | `Read` と `Grep` は自動承認されます。ここにリストされていない他のツールは依然として存在し、承認が必要なそれらへの呼び出しは権限モードと `canUseTool` にフォールスルーします。 |80| `allowed_tools=["Read", "Grep"]` | `Read` と `Grep` は自動承認されます。ここにリストされていない他のツールは依然として存在し、承認が必要なそれらへの呼び出しは権限モードと `canUseTool` にフォールスルーします。 |

81| `disallowed_tools=["Bash"]` | `Bash` ツール定義はリクエストから削除されます。Claude はツールを認識せず、実行を試みることはできません。 |81| `disallowed_tools=["Bash"]` | `Bash` ツール定義はリクエストから削除されます。Claude はツールを認識せず、実行を試みることはできません。 |

82| `disallowed_tools=["Bash(rm *)"]` | `Bash` は利用可能なままです。`rm *`[に記載されているとおり](/docs/ja/permissions#bash-rule-limits)にマッチする呼び出しは、`bypassPermissions` を含むすべての権限モードで拒否されます。`/bin/rm` を含む他の `Bash` 呼び出しは、権限モードにフォールスルーします。 |82| `disallowed_tools=["Bash(rm *)"]` | `Bash` は利用可能なままです。`rm *`[に記載されているとおり](/docs/ja/permissions#bash-rule-limits)にマッチする呼び出しは、`bypassPermissions` を含むすべての権限モードで拒否されます。`/bin/rm` を含む他の `Bash` 呼び出しは、権限モードにフォールスルーします。 |

124SDK は以下の権限モードをサポートしています。124SDK は以下の権限モードをサポートしています。

125 125 

126| モード | 説明 | ツール動作 |126| モード | 説明 | ツール動作 |

127| :------------------ | :----------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |127| :- | :- | :- |

128| `default` | 標準的な権限動作 | モードベースの自動承認なし。承認が必要で許可ルールに一致しないコールは、`canUseTool` コールバックをトリガーします |128| `default` | 標準的な権限動作 | モードベースの自動承認なし。承認が必要で許可ルールに一致しないコールは、`canUseTool` コールバックをトリガーします |

129| `dontAsk` | プロンプトの代わりに拒否 | それ以外の場合はプロンプトが表示されるコールは拒否されます。`allowed_tools` またはルールで承認されたコール、および `default` モードで承認が不要なコールは実行されます。コネクタツール（[組織が `ask` に設定](/docs/ja/mcp#organization-controls-on-connector-tools)）およびユーザーインタラクションが必要なツール、ならびに [重要なパス](/docs/ja/permission-modes#critical-paths) をターゲットとする `rm` および `rmdir` の削除は、事前に承認していても拒否されます。`canUseTool` は呼び出されません |129| `dontAsk` | プロンプトの代わりに拒否 | それ以外の場合はプロンプトが表示されるコールは拒否されます。`allowed_tools` またはルールで承認されたコール、および `default` モードで承認が不要なコールは実行されます。コネクタツール（[組織が `ask` に設定](/docs/ja/mcp#organization-controls-on-connector-tools)）およびユーザーインタラクションが必要なツール、ならびに [重要なパス](/docs/ja/permission-modes#critical-paths) をターゲットとする `rm` および `rmdir` の削除は、事前に承認していても拒否されます。`canUseTool` は呼び出されません |

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

27Python SDK は Claude Code と対話するための 2 つの方法を提供します。27Python SDK は Claude Code と対話するための 2 つの方法を提供します。

28 28 

29| 機能 | `query()` | `ClaudeSDKClient` |29| 機能 | `query()` | `ClaudeSDKClient` |

30| :------------ | :----------------------------------------- | :---------------- |30| :- | :- | :- |

31| **セッション** | デフォルトで新しいセッションを作成 | 同じセッションを再利用 |31| **セッション** | デフォルトで新しいセッションを作成 | 同じセッションを再利用 |

32| **会話** | 単一の交換 | 同じコンテキスト内の複数の交換 |32| **会話** | 単一の交換 | 同じコンテキスト内の複数の交換 |

33| **接続** | 自動的に管理 | 手動制御 |33| **接続** | 自動的に管理 | 手動制御 |

66</h4>66</h4>

67 67 

68| パラメータ | 型 | 説明 |68| パラメータ | 型 | 説明 |

69| :---------- | :--------------------------- | :------------------------------------------------------ |69| :- | :- | :- |

70| `prompt` | `str \| AsyncIterable[dict]` | 入力プロンプト（文字列またはストリーミングモード用の非同期イテレータ） |70| `prompt` | `str \| AsyncIterable[dict]` | 入力プロンプト（文字列またはストリーミングモード用の非同期イテレータ） |

71| `options` | `ClaudeAgentOptions \| None` | オプションの設定オブジェクト（None の場合は `ClaudeAgentOptions()` がデフォルト） |71| `options` | `ClaudeAgentOptions \| None` | オプションの設定オブジェクト（None の場合は `ClaudeAgentOptions()` がデフォルト） |

72| `transport` | `Transport \| None` | CLI プロセスとの通信用のオプションのカスタムトランスポート |72| `transport` | `Transport \| None` | CLI プロセスとの通信用のオプションのカスタムトランスポート |

119</h4>119</h4>

120 120 

121| パラメータ | 型 | 説明 |121| パラメータ | 型 | 説明 |

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

123| `name` | `str` | ツールの一意の識別子 |123| `name` | `str` | ツールの一意の識別子 |

124| `description` | `str` | ツールが何をするかの人間が読める説明 |124| `description` | `str` | ツールが何をするかの人間が読める説明 |

125| `input_schema` | `type \| dict[str, Any]` | ツールの入力パラメータを定義するスキーマ。[入力スキーマオプション](#input-schema-options) を参照してください |125| `input_schema` | `type \| dict[str, Any]` | ツールの入力パラメータを定義するスキーマ。[入力スキーマオプション](#input-schema-options) を参照してください |

178すべてのフィールドはオプションです。クライアントはセキュリティ決定のためにこれらのヒントに依存すべきではありません。178すべてのフィールドはオプションです。クライアントはセキュリティ決定のためにこれらのヒントに依存すべきではありません。

179 179 

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

181| :------------------- | :------------- | :------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |181| :- | :- | :- | :- |

182| `title` | `str \| None` | `None` | ツールの人間が読める題名 |182| `title` | `str \| None` | `None` | ツールの人間が読める題名 |

183| `readOnlyHint` | `bool \| None` | `False` | `True` の場合、ツールはその環境を変更しません |183| `readOnlyHint` | `bool \| None` | `False` | `True` の場合、ツールはその環境を変更しません |

184| `destructiveHint` | `bool \| None` | `True` | `True` の場合、ツールは破壊的な更新を実行する可能性があります（`readOnlyHint` が `False` の場合のみ意味があります） |184| `destructiveHint` | `bool \| None` | `True` | `True` の場合、ツールは破壊的な更新を実行する可能性があります（`readOnlyHint` が `False` の場合のみ意味があります） |

220</h4>220</h4>

221 221 

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

223| :-------- | :------------------------------ | :-------- | :--------------------------- |223| :- | :- | :- | :- |

224| `name` | `str` | - | サーバーの一意の識別子 |224| `name` | `str` | - | サーバーの一意の識別子 |

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

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

282</h4>282</h4>

283 283 

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

285| :------------------ | :------------ | :----- | :---------------------------------------------------------- |285| :- | :- | :- | :- |

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

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

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

293</h4>293</h4>

294 294 

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

296| :-------------- | :------------ | :---------------------------------------------------- |296| :- | :- | :- |

297| `session_id` | `str` | 一意のセッション識別子 |297| `session_id` | `str` | 一意のセッション識別子 |

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

299| `last_modified` | `int` | エポック以降のミリ秒単位での最後の変更時刻 |299| `last_modified` | `int` | エポック以降のミリ秒単位での最後の変更時刻 |

338</h4>338</h4>

339 339 

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

341| :----------- | :------------ | :----- | :--------------------------------------- |341| :- | :- | :- | :- |

342| `session_id` | `str` | 必須 | メッセージを取得するセッション ID |342| `session_id` | `str` | 必須 | メッセージを取得するセッション ID |

343| `directory` | `str \| None` | `None` | 検索するプロジェクトディレクトリ。省略した場合、すべてのプロジェクトを検索します |343| `directory` | `str \| None` | `None` | 検索するプロジェクトディレクトリ。省略した場合、すべてのプロジェクトを検索します |

344| `limit` | `int \| None` | `None` | 返すメッセージの最大数 |344| `limit` | `int \| None` | `None` | 返すメッセージの最大数 |

349</h4>349</h4>

350 350 

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

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

353| `type` | `Literal["user", "assistant"]` | メッセージロール |353| `type` | `Literal["user", "assistant"]` | メッセージロール |

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

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

389</h4>389</h4>

390 390 

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

392| :----------- | :------------ | :----- | :------------------------------------------- |392| :- | :- | :- | :- |

393| `session_id` | `str` | 必須 | 検索するセッションの UUID |393| `session_id` | `str` | 必須 | 検索するセッションの UUID |

394| `directory` | `str \| None` | `None` | プロジェクトディレクトリパス。省略した場合、すべてのプロジェクトディレクトリを検索します |394| `directory` | `str \| None` | `None` | プロジェクトディレクトリパス。省略した場合、すべてのプロジェクトディレクトリを検索します |

395 395 

428</h4>428</h4>

429 429 

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

431| :----------- | :------------ | :----- | :------------------------------------------- |431| :- | :- | :- | :- |

432| `session_id` | `str` | 必須 | 名前を変更するセッションの UUID |432| `session_id` | `str` | 必須 | 名前を変更するセッションの UUID |

433| `title` | `str` | 必須 | 新しいタイトル。空白をストリップした後、空でない必要があります |433| `title` | `str` | 必須 | 新しいタイトル。空白をストリップした後、空でない必要があります |

434| `directory` | `str \| None` | `None` | プロジェクトディレクトリパス。省略した場合、すべてのプロジェクトディレクトリを検索します |434| `directory` | `str \| None` | `None` | プロジェクトディレクトリパス。省略した場合、すべてのプロジェクトディレクトリを検索します |

468</h4>468</h4>

469 469 

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

471| :----------- | :------------ | :----- | :---------------------------------------------- |471| :- | :- | :- | :- |

472| `session_id` | `str` | 必須 | タグを付けるセッションの UUID |472| `session_id` | `str` | 必須 | タグを付けるセッションの UUID |

473| `tag` | `str \| None` | 必須 | タグ文字列、またはクリアする場合は `None`。保存前に Unicode サニタイズされます |473| `tag` | `str \| None` | 必須 | タグ文字列、またはクリアする場合は `None`。保存前に Unicode サニタイズされます |

474| `directory` | `str \| None` | `None` | プロジェクトディレクトリパス。省略した場合、すべてのプロジェクトディレクトリを検索します |474| `directory` | `str \| None` | `None` | プロジェクトディレクトリパス。省略した場合、すべてのプロジェクトディレクトリを検索します |

529</h4>529</h4>

530 530 

531| メソッド | 説明 |531| メソッド | 説明 |

532| :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------------- |532| :- | :- |

533| `__init__(options)` | オプションの設定でクライアントを初期化します |533| `__init__(options)` | オプションの設定でクライアントを初期化します |

534| `connect(prompt)` | オプションの初期プロンプトまたはメッセージストリームで Claude に接続します |534| `connect(prompt)` | オプションの初期プロンプトまたはメッセージストリームで Claude に接続します |

535| `query(prompt, session_id)` | ストリーミングモードで新しいリクエストを送信します |535| `query(prompt, session_id)` | ストリーミングモードで新しいリクエストを送信します |

780```780```

781 781 

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

783| :------------- | :---------------------------------------------- | :------------------------------------------------------------------------------------ |783| :- | :- | :- |

784| `name` | `str` | ツールの一意の識別子 |784| `name` | `str` | ツールの一意の識別子 |

785| `description` | `str` | 人間が読める説明 |785| `description` | `str` | 人間が読める説明 |

786| `input_schema` | `type[T] \| dict[str, Any]` | 入力検証用のスキーマ |786| `input_schema` | `type[T] \| dict[str, Any]` | 入力検証用のスキーマ |

824```824```

825 825 

826| メソッド | 説明 |826| メソッド | 説明 |

827| :---------------- | :----------------------------------------- |827| :- | :- |

828| `connect()` | トランスポートを接続し、通信の準備をします |828| `connect()` | トランスポートを接続し、通信の準備をします |

829| `write(data)` | 生データ（JSON + 改行）をトランスポートに書き込みます |829| `write(data)` | 生データ（JSON + 改行）をトランスポートに書き込みます |

830| `read_messages()` | 解析されたJSONメッセージを生成する非同期イテレータ |830| `read_messages()` | 解析されたJSONメッセージを生成する非同期イテレータ |

894```894```

895 895 

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

897| :---------------------------- | :------------------------------------------------------------------------------------ | :----------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |897| :- | :- | :- | :- |

898| `tools` | `list[str] \| ToolsPreset \| None` | `None` | ツール設定。Claude Codeのデフォルトツールには`{"type": "preset", "preset": "claude_code"}`を使用します |898| `tools` | `list[str] \| ToolsPreset \| None` | `None` | ツール設定。Claude Codeのデフォルトツールには`{"type": "preset", "preset": "claude_code"}`を使用します |

899| `allowed_tools` | `list[str]` | `[]` | プロンプトなしで自動承認するツール。これはClaudeをこれらのツールのみに制限しません。ここで[タスク追跡ツール](/docs/ja/agent-sdk/todo-tracking#model-availability)の1つに名前を付けた場合、Claude Codeもセッションをオプトインします。その他のリストされていないツールは`permission_mode`と`can_use_tool`を通じて処理されます。`disallowed_tools`を使用してツールをブロックします。[権限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を参照してください |899| `allowed_tools` | `list[str]` | `[]` | プロンプトなしで自動承認するツール。これはClaudeをこれらのツールのみに制限しません。ここで[タスク追跡ツール](/docs/ja/agent-sdk/todo-tracking#model-availability)の1つに名前を付けた場合、Claude Codeもセッションをオプトインします。その他のリストされていないツールは`permission_mode`と`can_use_tool`を通じて処理されます。`disallowed_tools`を使用してツールをブロックします。[権限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を参照してください |

900| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptCustom \| SystemPromptFile \| None` | `None` | システムプロンプト設定。カスタムプロンプトの場合は文字列を渡し、Claude Codeのシステムプロンプトの場合は`{"type": "preset", "preset": "claude_code"}`をオプションの`"append"`で渡すか、カスタムプロンプトの場合は`{"type": "custom", "prompt": "..."}`を渡して`"snapshot"`も設定するか、`{"type": "file", "path": "..."}`でディスクから大きなプロンプトを読み込みます。[`SystemPromptPreset`](#systempromptpreset)、[`SystemPromptCustom`](#systempromptcustom)、[`SystemPromptFile`](#systempromptfile)を参照してください |900| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptCustom \| SystemPromptFile \| None` | `None` | システムプロンプト設定。カスタムプロンプトの場合は文字列を渡し、Claude Codeのシステムプロンプトの場合は`{"type": "preset", "preset": "claude_code"}`をオプションの`"append"`で渡すか、カスタムプロンプトの場合は`{"type": "custom", "prompt": "..."}`を渡して`"snapshot"`も設定するか、`{"type": "file", "path": "..."}`でディスクから大きなプロンプトを読み込みます。[`SystemPromptPreset`](#systempromptpreset)、[`SystemPromptCustom`](#systempromptcustom)、[`SystemPromptFile`](#systempromptfile)を参照してください |

986```986```

987 987 

988| フィールド | 必須 | 説明 |988| フィールド | 必須 | 説明 |

989| :------- | :- | :--------------------------------------- |989| :- | :- | :- |

990| `type` | はい | JSON スキーマ検証の場合は`"json_schema"`である必要があります |990| `type` | はい | JSON スキーマ検証の場合は`"json_schema"`である必要があります |

991| `schema` | はい | 出力検証用のJSON スキーマ定義 |991| `schema` | はい | 出力検証用のJSON スキーマ定義 |

992 992 

1006```1006```

1007 1007 

1008| フィールド | 必須 | 説明 |1008| フィールド | 必須 | 説明 |

1009| :------------------------- | :-- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1009| :- | :- | :- |

1010| `type` | はい | プリセットシステムプロンプトを使用するには`"preset"`である必要があります |1010| `type` | はい | プリセットシステムプロンプトを使用するには`"preset"`である必要があります |

1011| `preset` | はい | Claude Codeのシステムプロンプトを使用するには`"claude_code"`である必要があります |1011| `preset` | はい | Claude Codeのシステムプロンプトを使用するには`"claude_code"`である必要があります |

1012| `append` | いいえ | プリセットシステムプロンプトに追加する追加の指示 |1012| `append` | いいえ | プリセットシステムプロンプトに追加する追加の指示 |

1027```1027```

1028 1028 

1029| フィールド | 必須 | 説明 |1029| フィールド | 必須 | 説明 |

1030| :--------- | :-- | :-------------------------------------------------------------------------- |1030| :- | :- | :- |

1031| `type` | はい | `"custom"`である必要があります |1031| `type` | はい | `"custom"`である必要があります |

1032| `prompt` | はい | システムプロンプトテキスト。CLIにコマンドライン引数として渡されるため、[コマンドライン長制限](#systempromptfile)が適用されます |1032| `prompt` | はい | システムプロンプトテキスト。CLIにコマンドライン引数として渡されるため、[コマンドライン長制限](#systempromptfile)が適用されます |

1033| `snapshot` | いいえ | [`SystemPromptPreset.snapshot`](#systempromptpreset)と同じ。`prompt`に適用されます |1033| `snapshot` | いいえ | [`SystemPromptPreset.snapshot`](#systempromptpreset)と同じ。`prompt`に適用されます |

1045```1045```

1046 1046 

1047| フィールド | 必須 | 説明 |1047| フィールド | 必須 | 説明 |

1048| :----- | :- | :----------------------------------- |1048| :- | :- | :- |

1049| `type` | はい | ディスクからプロンプトを読み込むには`"file"`である必要があります |1049| `type` | はい | ディスクからプロンプトを読み込むには`"file"`である必要があります |

1050| `path` | はい | システムプロンプトを含むファイルへのパス |1050| `path` | はい | システムプロンプトを含むファイルへのパス |

1051 1051 

1060```1060```

1061 1061 

1062| 値 | 説明 | 場所 |1062| 値 | 説明 | 場所 |

1063| :---------- | :------------------------------------------- | :---------------------------- |1063| :- | :- | :- |

1064| `"user"` | グローバルユーザー設定 | `~/.claude/settings.json` |1064| `"user"` | グローバルユーザー設定 | `~/.claude/settings.json` |

1065| `"project"` | 共有プロジェクト設定（バージョン管理） | `.claude/settings.json` |1065| `"project"` | 共有プロジェクト設定（バージョン管理） | `.claude/settings.json` |

1066| `"local"` | ローカルプロジェクト設定、Claude Codeが設定を保存するときにgitignore | `.claude/settings.local.json` |1066| `"local"` | ローカルプロジェクト設定、Claude Codeが設定を保存するときにgitignore | `.claude/settings.local.json` |

1189```1189```

1190 1190 

1191| フィールド | 必須 | 説明 |1191| フィールド | 必須 | 説明 |

1192| :---------------- | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------ |1192| :- | :- | :- |

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

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

1195| `tools` | いいえ | 許可されたツール名の配列。省略した場合、[サブエージェントで利用可能なすべてのツール](/docs/ja/sub-agents#available-tools)を継承します |1195| `tools` | いいえ | 許可されたツール名の配列。省略した場合、[サブエージェントで利用可能なすべてのツール](/docs/ja/sub-agents#available-tools)を継承します |

1286```1286```

1287 1287 

1288| フィールド | 型 | 説明 |1288| フィールド | 型 | 説明 |

1289| :---------------- | :----------------------- | :---------------------------------------------------------------------------------------------------------------------------------- |1289| :- | :- | :- |

1290| `signal` | `Any \| None` | 将来の中止シグナルサポート用に予約済み |1290| `signal` | `Any \| None` | 将来の中止シグナルサポート用に予約済み |

1291| `suggestions` | `list[PermissionUpdate]` | CLIからの権限更新提案。Bashプロンプトには`localSettings`宛先の提案が含まれるため、`updated_permissions`で返すと、ルールを`.claude/settings.local.json`に書き込み、セッション間で永続化します。 |1291| `suggestions` | `list[PermissionUpdate]` | CLIからの権限更新提案。Bashプロンプトには`localSettings`宛先の提案が含まれるため、`updated_permissions`で返すと、ルールを`.claude/settings.local.json`に書き込み、セッション間で永続化します。 |

1292| `tool_use_id` | `str \| None` | このプロンプトが対象とする特定のツール呼び出しの識別子。`can_use_tool`に配信されるときは常に入力されます |1292| `tool_use_id` | `str \| None` | このプロンプトが対象とする特定のツール呼び出しの識別子。`can_use_tool`に配信されるときは常に入力されます |

1322```1322```

1323 1323 

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

1325| :-------------------- | :------------------------------- | :-------- | :---------------- |1325| :- | :- | :- | :- |

1326| `behavior` | `Literal["allow"]` | `"allow"` | 「allow」である必要があります |1326| `behavior` | `Literal["allow"]` | `"allow"` | 「allow」である必要があります |

1327| `updated_input` | `dict[str, Any] \| None` | `None` | 元の代わりに使用する変更された入力 |1327| `updated_input` | `dict[str, Any] \| None` | `None` | 元の代わりに使用する変更された入力 |

1328| `updated_permissions` | `list[PermissionUpdate] \| None` | `None` | 適用する権限更新 |1328| `updated_permissions` | `list[PermissionUpdate] \| None` | `None` | 適用する権限更新 |

1342```1342```

1343 1343 

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

1345| :---------- | :---------------- | :------- | :-------------------- |1345| :- | :- | :- | :- |

1346| `behavior` | `Literal["deny"]` | `"deny"` | 「deny」である必要があります |1346| `behavior` | `Literal["deny"]` | `"deny"` | 「deny」である必要があります |

1347| `message` | `str` | `""` | ツールが拒否された理由を説明するメッセージ |1347| `message` | `str` | `""` | ツールが拒否された理由を説明するメッセージ |

1348| `interrupt` | `bool` | `False` | 現在の実行を中断するかどうか |1348| `interrupt` | `bool` | `False` | 現在の実行を中断するかどうか |

1374```1374```

1375 1375 

1376| フィールド | 型 | 説明 |1376| フィールド | 型 | 説明 |

1377| :------------ | :---------------------------------------- | :--------------------- |1377| :- | :- | :- |

1378| `type` | `Literal[...]` | 権限更新操作のタイプ |1378| `type` | `Literal[...]` | 権限更新操作のタイプ |

1379| `rules` | `list[PermissionRuleValue] \| None` | 追加/置換/削除操作用のルール |1379| `rules` | `list[PermissionRuleValue] \| None` | 追加/置換/削除操作用のルール |

1380| `behavior` | `Literal["allow", "deny", "ask"] \| None` | ルールベースの操作の動作 |1380| `behavior` | `Literal["allow", "deny", "ask"] \| None` | ルールベースの操作の動作 |

1436```1436```

1437 1437 

1438| バリアント | フィールド | 説明 |1438| バリアント | フィールド | 説明 |

1439| :--------- | :------------------------------- | :------------------------ |1439| :- | :- | :- |

1440| `adaptive` | `type`、`display` | Claudeが適応的に思考するかどうかを決定します |1440| `adaptive` | `type`、`display` | Claudeが適応的に思考するかどうかを決定します |

1441| `enabled` | `type`、`budget_tokens`、`display` | 特定のトークン予算で思考を有効にします |1441| `enabled` | `type`、`budget_tokens`、`display` | 特定のトークン予算で思考を有効にします |

1442| `disabled` | `type` | 思考を無効にします |1442| `disabled` | `type` | 思考を無効にします |

1469```1469```

1470 1470 

1471| フィールド | 型 | 説明 |1471| フィールド | 型 | 説明 |

1472| :------ | :---- | :----------- |1472| :- | :- | :- |

1473| `total` | `int` | タスクの合計トークン予算 |1473| `total` | `int` | タスクの合計トークン予算 |

1474 1474 

1475これは`TypedDict`であるため、`ClaudeAgentOptions(task_budget={"total": 50000})`などのプレーンな辞書として渡します。1475これは`TypedDict`であるため、`ClaudeAgentOptions(task_budget={"total": 50000})`などのプレーンな辞書として渡します。

1596```1596```

1597 1597 

1598| フィールド | 型 | 説明 |1598| フィールド | 型 | 説明 |

1599| :----------- | :------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------- |1599| :- | :- | :- |

1600| `name` | `str` | サーバー名 |1600| `name` | `str` | サーバー名 |

1601| `status` | `str` | `"connected"`、`"failed"`、`"needs-auth"`、`"pending"`、`"disabled"`のいずれか |1601| `status` | `str` | `"connected"`、`"failed"`、`"needs-auth"`、`"pending"`、`"disabled"`のいずれか |

1602| `serverInfo` | `dict`（オプション） | サーバー名とバージョン（`{"name": str, "version": str}`） |1602| `serverInfo` | `dict`（オプション） | サーバー名とバージョン（`{"name": str, "version": str}`） |

1618```1618```

1619 1619 

1620| フィールド | 型 | 説明 |1620| フィールド | 型 | 説明 |

1621| :----- | :----------------- | :------------------------------------- |1621| :- | :- | :- |

1622| `type` | `Literal["local"]` | `"local"`である必要があります（現在ローカルプラグインのみサポート） |1622| `type` | `Literal["local"]` | `"local"`である必要があります（現在ローカルプラグインのみサポート） |

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

1624 1624 

1672```1672```

1673 1673 

1674| フィールド | 型 | 説明 |1674| フィールド | 型 | 説明 |

1675| :------------------- | :-------------------------- | :------------------------------------------------------------------------------------------------------ |1675| :- | :- | :- |

1676| `content` | `str \| list[ContentBlock]` | テキストまたはコンテンツブロックとしてのメッセージコンテンツ |1676| `content` | `str \| list[ContentBlock]` | テキストまたはコンテンツブロックとしてのメッセージコンテンツ |

1677| `uuid` | `str \| None` | 一意のメッセージ識別子 |1677| `uuid` | `str \| None` | 一意のメッセージ識別子 |

1678| `parent_tool_use_id` | `str \| None` | このメッセージがツール結果応答の場合のツール使用 ID |1678| `parent_tool_use_id` | `str \| None` | このメッセージがツール結果応答の場合のツール使用 ID |

1704```1704```

1705 1705 

1706| フィールド | 型 | 説明 |1706| フィールド | 型 | 説明 |

1707| :------------------- | :----------------------------------------------------------- | :-------------------------------------------------------------- |1707| :- | :- | :- |

1708| `content` | `list[ContentBlock]` | 応答内のコンテンツブロックのリスト |1708| `content` | `list[ContentBlock]` | 応答内のコンテンツブロックのリスト |

1709| `model` | `str` | 応答を生成したモデル |1709| `model` | `str` | 応答を生成したモデル |

1710| `parent_tool_use_id` | `str \| None` | これがネストされた応答の場合のツール使用 ID |1710| `parent_tool_use_id` | `str \| None` | これがネストされた応答の場合のツール使用 ID |

1791`usage` dict はメインエージェントループのみをカバーし、サブエージェントおよび他のネストされた、または補助的なモデル呼び出しを除外します。[ストリーミング入力モード](/docs/ja/agent-sdk/streaming-vs-single-mode) では、値はターンごとです。トークンとコストのアカウンティングについては `model_usage` を優先してください。`usage` dict は、存在する場合、以下のキーを含みます：1791`usage` dict はメインエージェントループのみをカバーし、サブエージェントおよび他のネストされた、または補助的なモデル呼び出しを除外します。[ストリーミング入力モード](/docs/ja/agent-sdk/streaming-vs-single-mode) では、値はターンごとです。トークンとコストのアカウンティングについては `model_usage` を優先してください。`usage` dict は、存在する場合、以下のキーを含みます：

1792 1792 

1793| キー | 型 | 説明 |1793| キー | 型 | 説明 |

1794| ----------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |1794| - | - | - |

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

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

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

1804`model_usage` の各値は `ModelUsage` TypedDict で、`from claude_agent_sdk.types import ModelUsage` でインポートされます。そのキーは camelCase を使用します。これは、基になる CLI プロセスから変更されずに渡される値であり、TypeScript [`ModelUsage`](/docs/ja/agent-sdk/typescript#modelusage) 型と一致するためです：1804`model_usage` の各値は `ModelUsage` TypedDict で、`from claude_agent_sdk.types import ModelUsage` でインポートされます。そのキーは camelCase を使用します。これは、基になる CLI プロセスから変更されずに渡される値であり、TypeScript [`ModelUsage`](/docs/ja/agent-sdk/typescript#modelusage) 型と一致するためです：

1805 1805 

1806| キー | 型 | 説明 |1806| キー | 型 | 説明 |

1807| -------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1807| - | - | - |

1808| `inputTokens` | `int` | このモデルの入力トークン。 |1808| `inputTokens` | `int` | このモデルの入力トークン。 |

1809| `outputTokens` | `int` | このモデルの出力トークン。 |1809| `outputTokens` | `int` | このモデルの出力トークン。 |

1810| `cacheReadInputTokens` | `int` | このモデルのキャッシュ読み取りトークン。 |1810| `cacheReadInputTokens` | `int` | このモデルのキャッシュ読み取りトークン。 |

1833```1833```

1834 1834 

1835| フィールド | 型 | 説明 |1835| フィールド | 型 | 説明 |

1836| :------------------- | :--------------- | :-------------------------------------------------------------------------------------------------------------------- |1836| :- | :- | :- |

1837| `uuid` | `str` | このイベントの一意の識別子 |1837| `uuid` | `str` | このイベントの一意の識別子 |

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

1839| `event` | `dict[str, Any]` | 生の Claude API ストリームイベントデータ |1839| `event` | `dict[str, Any]` | 生の Claude API ストリームイベントデータ |

1854```1854```

1855 1855 

1856| フィールド | 型 | 説明 |1856| フィールド | 型 | 説明 |

1857| :---------------- | :-------------------------------- | :--------- |1857| :- | :- | :- |

1858| `rate_limit_info` | [`RateLimitInfo`](#ratelimitinfo) | 現在のレート制限状態 |1858| `rate_limit_info` | [`RateLimitInfo`](#ratelimitinfo) | 現在のレート制限状態 |

1859| `uuid` | `str` | 一意のイベント識別子 |1859| `uuid` | `str` | 一意のイベント識別子 |

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

1885```1885```

1886 1886 

1887| フィールド | 型 | 説明 |1887| フィールド | 型 | 説明 |

1888| :------------------------ | :------------------------ | :--------------------------------------------------------------------------- |1888| :- | :- | :- |

1889| `status` | `RateLimitStatus` | 現在のステータス。`"allowed_warning"` は制限に近づいていることを意味します。`"rejected"` は制限に達したことを意味します |1889| `status` | `RateLimitStatus` | 現在のステータス。`"allowed_warning"` は制限に近づいていることを意味します。`"rejected"` は制限に達したことを意味します |

1890| `resets_at` | `int \| None` | レート制限ウィンドウがリセットされる Unix タイムスタンプ |1890| `resets_at` | `int \| None` | レート制限ウィンドウがリセットされる Unix タイムスタンプ |

1891| `rate_limit_type` | `RateLimitType \| None` | どのレート制限ウィンドウが適用されるか |1891| `rate_limit_type` | `RateLimitType \| None` | どのレート制限ウィンドウが適用されるか |

1910```1910```

1911 1911 

1912| フィールド | 型 | 説明 |1912| フィールド | 型 | 説明 |

1913| :-------------------- | :---- | :----------------------------------------------------------------- |1913| :- | :- | :- |

1914| `new_conversation_id` | `str` | 新しい会話の不透明な識別子。後続のメッセージの `session_id` ではありません。次のメッセージからそれを読み取ってください |1914| `new_conversation_id` | `str` | 新しい会話の不透明な識別子。後続のメッセージの `session_id` ではありません。次のメッセージからそれを読み取ってください |

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

1916| `session_id` | `str` | リセットされたセッションの ID。リセット後のメッセージは新しい `session_id` を持ちます |1916| `session_id` | `str` | リセットされたセッションの ID。リセット後のメッセージは新しい `session_id` を持ちます |

1933```1933```

1934 1934 

1935| フィールド | 型 | 説明 |1935| フィールド | 型 | 説明 |

1936| :------------ | :------------ | :-------------------------------------------------------------------------------------------------- |1936| :- | :- | :- |

1937| `task_id` | `str` | タスクの一意の識別子 |1937| `task_id` | `str` | タスクの一意の識別子 |

1938| `description` | `str` | タスクの説明 |1938| `description` | `str` | タスクの説明 |

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

1973```1973```

1974 1974 

1975| フィールド | 型 | 説明 |1975| フィールド | 型 | 説明 |

1976| :--------------- | :------------ | :------------------ |1976| :- | :- | :- |

1977| `task_id` | `str` | タスクの一意の識別子 |1977| `task_id` | `str` | タスクの一意の識別子 |

1978| `description` | `str` | 現在のステータス説明 |1978| `description` | `str` | 現在のステータス説明 |

1979| `usage` | `TaskUsage` | これまでのこのタスクのトークン使用状況 |1979| `usage` | `TaskUsage` | これまでのこのタスクのトークン使用状況 |

2002```2002```

2003 2003 

2004| フィールド | 型 | 説明 |2004| フィールド | 型 | 説明 |

2005| :------------ | :----------------------- | :--------------------------------------------- |2005| :- | :- | :- |

2006| `task_id` | `str` | タスクの一意の識別子 |2006| `task_id` | `str` | タスクの一意の識別子 |

2007| `status` | `TaskNotificationStatus` | `"completed"`、`"failed"`、または `"stopped"` のいずれか |2007| `status` | `TaskNotificationStatus` | `"completed"`、`"failed"`、または `"stopped"` のいずれか |

2008| `output_file` | `str` | タスク出力ファイルへのパス |2008| `output_file` | `str` | タスク出力ファイルへのパス |

2307```2307```

2308 2308 

2309| フィールド | 型 | 説明 |2309| フィールド | 型 | 説明 |

2310| :---------------- | :----------- | :-------------------- |2310| :- | :- | :- |

2311| `session_id` | `str` | 現在のセッション識別子 |2311| `session_id` | `str` | 現在のセッション識別子 |

2312| `transcript_path` | `str` | セッショントランスクリプトファイルへのパス |2312| `transcript_path` | `str` | セッショントランスクリプトファイルへのパス |

2313| `cwd` | `str` | 現在の作業ディレクトリ |2313| `cwd` | `str` | 現在の作業ディレクトリ |

2330```2330```

2331 2331 

2332| フィールド | 型 | 説明 |2332| フィールド | 型 | 説明 |

2333| :---------------- | :---------------------- | :------------------------------------ |2333| :- | :- | :- |

2334| `hook_event_name` | `Literal["PreToolUse"]` | 常に "PreToolUse" |2334| `hook_event_name` | `Literal["PreToolUse"]` | 常に "PreToolUse" |

2335| `tool_name` | `str` | 実行しようとしているツールの名前 |2335| `tool_name` | `str` | 実行しようとしているツールの名前 |

2336| `tool_input` | `dict[str, Any]` | ツールの入力パラメータ |2336| `tool_input` | `dict[str, Any]` | ツールの入力パラメータ |

2356```2356```

2357 2357 

2358| フィールド | 型 | 説明 |2358| フィールド | 型 | 説明 |

2359| :---------------- | :----------------------- | :------------------------------------ |2359| :- | :- | :- |

2360| `hook_event_name` | `Literal["PostToolUse"]` | 常に "PostToolUse" |2360| `hook_event_name` | `Literal["PostToolUse"]` | 常に "PostToolUse" |

2361| `tool_name` | `str` | 実行されたツールの名前 |2361| `tool_name` | `str` | 実行されたツールの名前 |

2362| `tool_input` | `dict[str, Any]` | 使用された入力パラメータ |2362| `tool_input` | `dict[str, Any]` | 使用された入力パラメータ |

2384```2384```

2385 2385 

2386| フィールド | 型 | 説明 |2386| フィールド | 型 | 説明 |

2387| :---------------- | :------------------------------ | :----------------------------------------------------------------------------------------------------------------------- |2387| :- | :- | :- |

2388| `hook_event_name` | `Literal["PostToolUseFailure"]` | 常に "PostToolUseFailure" |2388| `hook_event_name` | `Literal["PostToolUseFailure"]` | 常に "PostToolUseFailure" |

2389| `tool_name` | `str` | 失敗したツールの名前 |2389| `tool_name` | `str` | 失敗したツールの名前 |

2390| `tool_input` | `dict[str, Any]` | 使用された入力パラメータ |2390| `tool_input` | `dict[str, Any]` | 使用された入力パラメータ |

2407```2407```

2408 2408 

2409| フィールド | 型 | 説明 |2409| フィールド | 型 | 説明 |

2410| :---------------- | :---------------------------- | :-------------------- |2410| :- | :- | :- |

2411| `hook_event_name` | `Literal["UserPromptSubmit"]` | 常に "UserPromptSubmit" |2411| `hook_event_name` | `Literal["UserPromptSubmit"]` | 常に "UserPromptSubmit" |

2412| `prompt` | `str` | ユーザーが送信したプロンプト |2412| `prompt` | `str` | ユーザーが送信したプロンプト |

2413 2413 

2424```2424```

2425 2425 

2426| フィールド | 型 | 説明 |2426| フィールド | 型 | 説明 |

2427| :----------------- | :---------------- | :------------------- |2427| :- | :- | :- |

2428| `hook_event_name` | `Literal["Stop"]` | 常に "Stop" |2428| `hook_event_name` | `Literal["Stop"]` | 常に "Stop" |

2429| `stop_hook_active` | `bool` | stop hook がアクティブかどうか |2429| `stop_hook_active` | `bool` | stop hook がアクティブかどうか |

2430 2430 

2444```2444```

2445 2445 

2446| フィールド | 型 | 説明 |2446| フィールド | 型 | 説明 |

2447| :---------------------- | :------------------------ | :------------------------ |2447| :- | :- | :- |

2448| `hook_event_name` | `Literal["SubagentStop"]` | 常に "SubagentStop" |2448| `hook_event_name` | `Literal["SubagentStop"]` | 常に "SubagentStop" |

2449| `stop_hook_active` | `bool` | stop hook がアクティブかどうか |2449| `stop_hook_active` | `bool` | stop hook がアクティブかどうか |

2450| `agent_id` | `str` | サブエージェントの一意の識別子 |2450| `agent_id` | `str` | サブエージェントの一意の識別子 |

2465```2465```

2466 2466 

2467| フィールド | 型 | 説明 |2467| フィールド | 型 | 説明 |

2468| :-------------------- | :-------------------------- | :--------------- |2468| :- | :- | :- |

2469| `hook_event_name` | `Literal["PreCompact"]` | 常に "PreCompact" |2469| `hook_event_name` | `Literal["PreCompact"]` | 常に "PreCompact" |

2470| `trigger` | `Literal["manual", "auto"]` | コンパクションをトリガーしたもの |2470| `trigger` | `Literal["manual", "auto"]` | コンパクションをトリガーしたもの |

2471| `custom_instructions` | `str \| None` | コンパクション用のカスタム指示 |2471| `custom_instructions` | `str \| None` | コンパクション用のカスタム指示 |

2485```2485```

2486 2486 

2487| フィールド | 型 | 説明 |2487| フィールド | 型 | 説明 |

2488| :------------------ | :------------------------ | :---------------- |2488| :- | :- | :- |

2489| `hook_event_name` | `Literal["Notification"]` | 常に "Notification" |2489| `hook_event_name` | `Literal["Notification"]` | 常に "Notification" |

2490| `message` | `str` | 通知メッセージコンテンツ |2490| `message` | `str` | 通知メッセージコンテンツ |

2491| `title` | `str`（オプション） | 通知タイトル |2491| `title` | `str`（オプション） | 通知タイトル |

2505```2505```

2506 2506 

2507| フィールド | 型 | 説明 |2507| フィールド | 型 | 説明 |

2508| :---------------- | :------------------------- | :----------------- |2508| :- | :- | :- |

2509| `hook_event_name` | `Literal["SubagentStart"]` | 常に "SubagentStart" |2509| `hook_event_name` | `Literal["SubagentStart"]` | 常に "SubagentStart" |

2510| `agent_id` | `str` | サブエージェントの一意の識別子 |2510| `agent_id` | `str` | サブエージェントの一意の識別子 |

2511| `agent_type` | `str` | サブエージェントの型 |2511| `agent_type` | `str` | サブエージェントの型 |

2527```2527```

2528 2528 

2529| フィールド | 型 | 説明 |2529| フィールド | 型 | 説明 |

2530| :----------------------- | :----------------------------- | :------------------------------------ |2530| :- | :- | :- |

2531| `hook_event_name` | `Literal["PermissionRequest"]` | 常に "PermissionRequest" |2531| `hook_event_name` | `Literal["PermissionRequest"]` | 常に "PermissionRequest" |

2532| `tool_name` | `str` | パーミッションをリクエストするツールの名前 |2532| `tool_name` | `str` | パーミッションをリクエストするツールの名前 |

2533| `tool_input` | `dict[str, Any]` | ツールの入力パラメータ |2533| `tool_input` | `dict[str, Any]` | ツールの入力パラメータ |

3608```3608```

3609 3609 

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

3611| :-------------------------- | :---------------------------------------------------- | :------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |3611| :- | :- | :- | :- |

3612| `enabled` | `bool` | `False` | コマンド実行のサンドボックスモードを有効にします |3612| `enabled` | `bool` | `False` | コマンド実行のサンドボックスモードを有効にします |

3613| `autoAllowBashIfSandboxed` | `bool` | `True` | サンドボックスが有効な場合、bash コマンドを自動承認します |3613| `autoAllowBashIfSandboxed` | `bool` | `True` | サンドボックスが有効な場合、bash コマンドを自動承認します |

3614| `excludedCommands` | `list[str]` | `[]` | サンドボックス制限をバイパスするコマンド（例：`["docker *"]`）。これらはモデルの関与なしに自動的にサンドボックスなしで実行されます。[`sandbox.excludedCommands`](/docs/ja/settings-reference#sandbox-excludedcommands) は、エントリが適用される場合をカバーしています |3614| `excludedCommands` | `list[str]` | `[]` | サンドボックス制限をバイパスするコマンド（例：`["docker *"]`）。これらはモデルの関与なしに自動的にサンドボックスなしで実行されます。[`sandbox.excludedCommands`](/docs/ja/settings-reference#sandbox-excludedcommands) は、エントリが適用される場合をカバーしています |

3680```3680```

3681 3681 

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

3683| :------------------------ | :---------- | :------ | :------------------------------------------------------------------------------------------------------------------------- |3683| :- | :- | :- | :- |

3684| `allowedDomains` | `list[str]` | `[]` | サンドボックス化されたプロセスがアクセスできるドメイン名 |3684| `allowedDomains` | `list[str]` | `[]` | サンドボックス化されたプロセスがアクセスできるドメイン名 |

3685| `deniedDomains` | `list[str]` | `[]` | サンドボックス化されたプロセスがアクセスできないドメイン名。`allowedDomains` より優先されます |3685| `deniedDomains` | `list[str]` | `[]` | サンドボックス化されたプロセスがアクセスできないドメイン名。`allowedDomains` より優先されます |

3686| `allowManagedDomainsOnly` | `bool` | `False` | マネージド設定のみ：マネージド設定で設定されている場合、`allowedDomains` と非マネージド設定ソースからの `WebFetch(domain:...)` 許可ルールを無視します。SDK オプションで設定された場合は効果がありません |3686| `allowManagedDomainsOnly` | `bool` | `False` | マネージド設定のみ：マネージド設定で設定されている場合、`allowedDomains` と非マネージド設定ソースからの `WebFetch(domain:...)` 許可ルールを無視します。SDK オプションで設定された場合は効果がありません |

3708```3708```

3709 3709 

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

3711| :-------- | :---------- | :---- | :---------------- |3711| :- | :- | :- | :- |

3712| `file` | `list[str]` | `[]` | 違反を無視するファイルパスパターン |3712| `file` | `list[str]` | `[]` | 違反を無視するファイルパスパターン |

3713| `network` | `list[str]` | `[]` | 違反を無視するネットワークパターン |3713| `network` | `list[str]` | `[]` | 違反を無視するネットワークパターン |

3714 3714 

367**ツール** はエージェントが何ができるかを制御します：367**ツール** はエージェントが何ができるかを制御します：

368 368 

369| ツール | エージェントが実行できること |369| ツール | エージェントが実行できること |

370| ---------------------------------- | -------------- |370| - | - |

371| `Read`、`Glob`、`Grep` | 読み取り専用分析 |371| `Read`、`Glob`、`Grep` | 読み取り専用分析 |

372| `Read`、`Edit`、`Glob` | コードの分析と変更 |372| `Read`、`Edit`、`Glob` | コードの分析と変更 |

373| `Read`、`Edit`、`Bash`、`Glob`、`Grep` | 完全な自動化 |373| `Read`、`Edit`、`Bash`、`Glob`、`Grep` | 完全な自動化 |

52必要に応じて、エージェントを特定のタスクに必要な機能のみに制限できます。52必要に応じて、エージェントを特定のタスクに必要な機能のみに制限できます。

53 53 

54| リソース | 制限オプション |54| リソース | 制限オプション |

55| -------- | -------------------------- |55| - | - |

56| ファイルシステム | 必要なディレクトリのみをマウント、読み取り専用を優先 |56| ファイルシステム | 必要なディレクトリのみをマウント、読み取り専用を優先 |

57| ネットワーク | プロキシ経由で特定のエンドポイントに制限 |57| ネットワーク | プロキシ経由で特定のエンドポイントに制限 |

58| 認証情報 | 直接公開するのではなく、プロキシ経由で注入 |58| 認証情報 | 直接公開するのではなく、プロキシ経由で注入 |

82</Info>82</Info>

83 83 

84| テクノロジー | 分離強度 | パフォーマンスオーバーヘッド | 複雑さ |84| テクノロジー | 分離強度 | パフォーマンスオーバーヘッド | 複雑さ |

85| -------------------- | -------------- | -------------- | ------ |85| - | - | - | - |

86| Sandbox runtime | 良好（安全なデフォルト） | 非常に低い | 低い |86| Sandbox runtime | 良好（安全なデフォルト） | 非常に低い | 低い |

87| コンテナ（Docker） | セットアップに依存 | 低い | 中程度 |87| コンテナ（Docker） | セットアップに依存 | 低い | 中程度 |

88| gVisor | 優秀（正しいセットアップで） | 中程度/高い | 中程度 |88| gVisor | 優秀（正しいセットアップで） | 中程度/高い | 中程度 |

147各オプションの機能は次のとおりです。147各オプションの機能は次のとおりです。

148 148 

149| オプション | 目的 |149| オプション | 目的 |

150| ---------------------------------- | --------------------------------------------------------------------------------------------------------- |150| - | - |

151| `--cap-drop ALL` | `NET_ADMIN` や `SYS_ADMIN` などの権限昇格を可能にする可能性のある Linux 機能を削除します |151| `--cap-drop ALL` | `NET_ADMIN` や `SYS_ADMIN` などの権限昇格を可能にする可能性のある Linux 機能を削除します |

152| `--security-opt no-new-privileges` | setuid バイナリを通じてプロセスが権限を取得するのを防ぎます |152| `--security-opt no-new-privileges` | setuid バイナリを通じてプロセスが権限を取得するのを防ぎます |

153| `--security-opt seccomp=...` | 利用可能なシステムコールを制限します。Docker のデフォルトは約 44 をブロックし、カスタムプロファイルはさらにブロックできます |153| `--security-opt seccomp=...` | 利用可能なシステムコールを制限します。Docker のデフォルトは約 44 をブロックし、カスタムプロファイルはさらにブロックできます |

169**追加の強化オプション:**169**追加の強化オプション:**

170 170 

171| オプション | 目的 |171| オプション | 目的 |

172| ---------------- | ------------------------------------------------------------- |172| - | - |

173| `--userns-remap` | コンテナルートを非特権ホストユーザーにマップします。デーモン設定が必要ですが、コンテナエスケープからのダメージを制限します |173| `--userns-remap` | コンテナルートを非特権ホストユーザーにマップします。デーモン設定が必要ですが、コンテナエスケープからのダメージを制限します |

174| `--ipc private` | プロセス間通信を分離して、クロスコンテナ攻撃を防ぎます |174| `--ipc private` | プロセス間通信を分離して、クロスコンテナ攻撃を防ぎます |

175 175 

202**パフォーマンスに関する考慮事項:**202**パフォーマンスに関する考慮事項:**

203 203 

204| ワークロード | オーバーヘッド |204| ワークロード | オーバーヘッド |

205| ------------ | ------------------------------ |205| - | - |

206| CPU バウンド計算 | 約 0%（システムコールインターセプションなし） |206| CPU バウンド計算 | 約 0%（システムコールインターセプションなし） |

207| シンプルなシステムコール | 約 2 倍遅い |207| シンプルなシステムコール | 約 2 倍遅い |

208| ファイル I/O 集約的 | 大量のオープン/クローズパターンで最大 10～200 倍遅い |208| ファイル I/O 集約的 | 大量のオープン/クローズパターンで最大 10～200 倍遅い |

345 コードディレクトリへの読み取り専用アクセスでも、認証情報を公開する可能性があります。マウント前に除外またはサニタイズする一般的なファイル:345 コードディレクトリへの読み取り専用アクセスでも、認証情報を公開する可能性があります。マウント前に除外またはサニタイズする一般的なファイル:

346 346 

347 | ファイル | リスク |347 | ファイル | リスク |

348 | ------------------------------------------------------- | ------------------------- |348 | - | - |

349 | `.env`、`.env.local` | API キー、データベースパスワード、シークレット |349 | `.env`、`.env.local` | API キー、データベースパスワード、シークレット |

350 | `~/.git-credentials` | プレーンテキストの git パスワード/トークン |350 | `~/.git-credentials` | プレーンテキストの git パスワード/トークン |

351 | `~/.aws/credentials` | AWS アクセスキー |351 | `~/.aws/credentials` | AWS アクセスキー |

95`subpath` を不透明なキーサフィックスとして扱います。これはオンディスクレイアウトに従います。例えば `subagents/agent-<id>` です。`subpath` が未定義の場合、キーはメイントランスクリプトを参照します。95`subpath` を不透明なキーサフィックスとして扱います。これはオンディスクレイアウトに従います。例えば `subagents/agent-<id>` です。`subpath` が未定義の場合、キーはメイントランスクリプトを参照します。

96 96 

97| メソッド | 必須 | 呼び出されるタイミング |97| メソッド | 必須 | 呼び出されるタイミング |

98| :--------------------- | :-- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |98| :- | :- | :- |

99| `append` | はい | トランスクリプトエントリの各バッチがローカルに書き込まれた後。エントリは JSON セーフなオブジェクトで、ローカル JSONL では 1 行に 1 つです。 |99| `append` | はい | トランスクリプトエントリの各バッチがローカルに書き込まれた後。エントリは JSON セーフなオブジェクトで、ローカル JSONL では 1 行に 1 つです。 |

100| `load` | はい | `resume` が設定されている場合、またはサブプロセスが生成される前に `continue: true` が最新のストアセッションを解決する場合、およびリスティングが `listSessionSummaries` からフォールバックする場合は 1 セッションあたり 1 回。セッションが不明な場合は `null` を返します。 |100| `load` | はい | `resume` が設定されている場合、またはサブプロセスが生成される前に `continue: true` が最新のストアセッションを解決する場合、およびリスティングが `listSessionSummaries` からフォールバックする場合は 1 セッションあたり 1 回。セッションが不明な場合は `null` を返します。 |

101| `listSessions` | いいえ | `listSessions({ sessionStore })` および `continue: true` を指定した `query()`/`startup()` によって。未定義の場合、`continue: true` はスロー、`listSessions({ sessionStore })` は `listSessionSummaries` が実装されていない限りスロー。 |101| `listSessions` | いいえ | `listSessions({ sessionStore })` および `continue: true` を指定した `query()`/`startup()` によって。未定義の場合、`continue: true` はスロー、`listSessions({ sessionStore })` は `listSessionSummaries` が実装されていない限りスロー。 |

206両方の SDK リポジトリには、TypeScript の [`examples/session-stores/`](https://github.com/anthropics/claude-agent-sdk-typescript/tree/main/examples/session-stores) と Python の [`examples/session_stores/`](https://github.com/anthropics/claude-agent-sdk-python/tree/main/examples/session_stores) の下に実行可能なリファレンスアダプターが含まれています。ストレージタイプごとに 1 つのアダプターがあり、各アダプターは `append` と `load` がそのバックエンドの種類にどのようにマップされるかを示しています。これらはパッケージとして公開されていません。バックエンドに最も近いタイプのアダプターをプロジェクトにコピーし、バックエンドのクライアントをインストールして、それを適応させてください。206両方の SDK リポジトリには、TypeScript の [`examples/session-stores/`](https://github.com/anthropics/claude-agent-sdk-typescript/tree/main/examples/session-stores) と Python の [`examples/session_stores/`](https://github.com/anthropics/claude-agent-sdk-python/tree/main/examples/session_stores) の下に実行可能なリファレンスアダプターが含まれています。ストレージタイプごとに 1 つのアダプターがあり、各アダプターは `append` と `load` がそのバックエンドの種類にどのようにマップされるかを示しています。これらはパッケージとして公開されていません。バックエンドに最も近いタイプのアダプターをプロジェクトにコピーし、バックエンドのクライアントをインストールして、それを適応させてください。

207 207 

208| ストレージタイプ | ストレージモデル | サンプルアダプター |208| ストレージタイプ | ストレージモデル | サンプルアダプター |

209| :------------------------ | :--------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |209| :- | :- | :- |

210| オブジェクトストア | `append()` ごとに 1 つのパートファイル。`load()` はパートをリストアップ、ソート、連結します。 | S3 （[TypeScript](https://github.com/anthropics/claude-agent-sdk-typescript/tree/main/examples/session-stores/s3)、[Python](https://github.com/anthropics/claude-agent-sdk-python/blob/main/examples/session_stores/s3_session_store.py)） |210| オブジェクトストア | `append()` ごとに 1 つのパートファイル。`load()` はパートをリストアップ、ソート、連結します。 | S3 （[TypeScript](https://github.com/anthropics/claude-agent-sdk-typescript/tree/main/examples/session-stores/s3)、[Python](https://github.com/anthropics/claude-agent-sdk-python/blob/main/examples/session_stores/s3_session_store.py)） |

211| キーバリューストア | トランスクリプトごとに 1 つのリスト。`append()` がプッシュし、`load()` が範囲で読み込み、さらにセッションのソート済みインデックスがあります。 | Redis （[TypeScript](https://github.com/anthropics/claude-agent-sdk-typescript/tree/main/examples/session-stores/redis)、[Python](https://github.com/anthropics/claude-agent-sdk-python/blob/main/examples/session_stores/redis_session_store.py)） |211| キーバリューストア | トランスクリプトごとに 1 つのリスト。`append()` がプッシュし、`load()` が範囲で読み込み、さらにセッションのソート済みインデックスがあります。 | Redis （[TypeScript](https://github.com/anthropics/claude-agent-sdk-typescript/tree/main/examples/session-stores/redis)、[Python](https://github.com/anthropics/claude-agent-sdk-python/blob/main/examples/session_stores/redis_session_store.py)） |

212| リレーショナルデータベースまたはドキュメントストア | エントリごとに 1 行またはドキュメント。JSON として保存され、挿入時に割り当てられたキーで順序付けされます。 | Postgres （[TypeScript](https://github.com/anthropics/claude-agent-sdk-typescript/tree/main/examples/session-stores/postgres)、[Python](https://github.com/anthropics/claude-agent-sdk-python/blob/main/examples/session_stores/postgres_session_store.py)） |212| リレーショナルデータベースまたはドキュメントストア | エントリごとに 1 行またはドキュメント。JSON として保存され、挿入時に割り当てられたキーで順序付けされます。 | Postgres （[TypeScript](https://github.com/anthropics/claude-agent-sdk-typescript/tree/main/examples/session-stores/postgres)、[Python](https://github.com/anthropics/claude-agent-sdk-python/blob/main/examples/session_stores/postgres_session_store.py)） |

23必要なセッション処理の量は、アプリケーションの形状によって異なります。セッション管理は、コンテキストを共有する必要がある複数のプロンプトを送信する場合に関係します。単一の `query()` 呼び出し内では、エージェントは既に必要なだけのターンを実行し、権限プロンプトと `AskUserQuestion` は[ループ内で処理](/docs/ja/agent-sdk/user-input)されます（呼び出しを終了しません）。23必要なセッション処理の量は、アプリケーションの形状によって異なります。セッション管理は、コンテキストを共有する必要がある複数のプロンプトを送信する場合に関係します。単一の `query()` 呼び出し内では、エージェントは既に必要なだけのターンを実行し、権限プロンプトと `AskUserQuestion` は[ループ内で処理](/docs/ja/agent-sdk/user-input)されます（呼び出しを終了しません）。

24 24 

25| 構築しているもの | 使用するもの |25| 構築しているもの | 使用するもの |

26| :-------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |26| :- | :- |

27| ワンショットタスク：単一プロンプト、フォローアップなし | 追加は不要です。1 つの `query()` 呼び出しで処理されます。 |27| ワンショットタスク：単一プロンプト、フォローアップなし | 追加は不要です。1 つの `query()` 呼び出しで処理されます。 |

28| 1 つのプロセス内のマルチターンチャット | [`ClaudeSDKClient`（Python）または `continue: true`（TypeScript）](#automatic-session-management)。SDK はセッションを自動的に追跡し、ID 処理は不要です。 |28| 1 つのプロセス内のマルチターンチャット | [`ClaudeSDKClient`（Python）または `continue: true`（TypeScript）](#automatic-session-management)。SDK はセッションを自動的に追跡し、ID 処理は不要です。 |

29| プロセス再起動後に中断したところから再開 | `continue_conversation=True`（Python）/ `continue: true`（TypeScript）。ディレクトリ内の最新セッションを再開し、ID は不要です。 |29| プロセス再起動後に中断したところから再開 | `continue_conversation=True`（Python）/ `continue: true`（TypeScript）。ディレクトリ内の最新セッションを再開し、ID は不要です。 |

91`event` フィールドには、[Claude API](https://platform.claude.com/docs/en/build-with-claude/streaming#event-types) からの生のストリーミングイベントが含まれます。一般的なイベントタイプは以下の通りです：91`event` フィールドには、[Claude API](https://platform.claude.com/docs/en/build-with-claude/streaming#event-types) からの生のストリーミングイベントが含まれます。一般的なイベントタイプは以下の通りです：

92 92 

93| イベントタイプ | 説明 |93| イベントタイプ | 説明 |

94| :-------------------- | :---------------------------- |94| :- | :- |

95| `message_start` | 新しいメッセージの開始 |95| `message_start` | 新しいメッセージの開始 |

96| `content_block_start` | 新しいコンテンツブロック（テキストまたはツール使用）の開始 |96| `content_block_start` | 新しいコンテンツブロック（テキストまたはツール使用）の開始 |

97| `content_block_delta` | コンテンツへのインクリメンタルな更新 |97| `content_block_delta` | コンテンツへのインクリメンタルな更新 |

393エラーが発生すると、結果メッセージには何が問題かを示す `subtype` があります：393エラーが発生すると、結果メッセージには何が問題かを示す `subtype` があります：

394 394 

395| Subtype | 意味 |395| Subtype | 意味 |

396| ------------------------------------- | ---------------------------------------------------------- |396| - | - |

397| `success` | 出力が正常に生成および検証されました |397| `success` | 出力が正常に生成および検証されました |

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

399 399 

153</h3>153</h3>

154 154 

155| フィールド | 型 | 必須 | 説明 |155| フィールド | 型 | 必須 | 説明 |

156| :---------------- | :---------------------------------------------------------- | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |156| :- | :- | :- | :- |

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

158| `prompt` | `string` | はい | エージェントの役割と動作を定義するシステムプロンプト |158| `prompt` | `string` | はい | エージェントの役割と動作を定義するシステムプロンプト |

159| `tools` | `string[]` | いいえ | 許可されたツール名の配列。省略した場合、[サブエージェントで利用可能なすべてのツール](/docs/ja/sub-agents#available-tools)を継承します |159| `tools` | `string[]` | いいえ | 許可されたツール名の配列。省略した場合、[サブエージェントで利用可能なすべてのツール](/docs/ja/sub-agents#available-tools)を継承します |

198以下の表は、フォークではないサブエージェントのコンテキストに含まれるもの、および含まれないものを示しています。198以下の表は、フォークではないサブエージェントのコンテキストに含まれるもの、および含まれないものを示しています。

199 199 

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

201| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------- |201| :- | :- |

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

203| Project CLAUDE.md（[`settingSources`](/docs/ja/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) 経由でロード）（[`omitClaudeMd`](#agentdefinition-configuration) をエージェントが設定しない限り） | プリロードされたスキルコンテンツ（`AgentDefinition.skills` にリストされている場合を除く） |203| Project CLAUDE.md（[`settingSources`](/docs/ja/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) 経由でロード）（[`omitClaudeMd`](#agentdefinition-configuration) をエージェントが設定しない限り） | プリロードされたスキルコンテンツ（`AgentDefinition.skills` にリストされている場合を除く） |

204| ツール定義（親から継承、または `tools` のサブセット、[バックグラウンド実行用にフィルタリング](/docs/ja/sub-agents#available-tools)） | 親のシステムプロンプト |204| ツール定義（親から継承、または `tools` のサブセット、[バックグラウンド実行用にフィルタリング](/docs/ja/sub-agents#available-tools)） | 親のシステムプロンプト |

626</h3>626</h3>

627 627 

628| ユースケース | ツール | 説明 |628| ユースケース | ツール | 説明 |

629| :------- | :---------------------------------- | :---------------------------------------- |629| :- | :- | :- |

630| 読み取り専用分析 | `Read`、`Grep`、`Glob` | コードを検査できますが、変更または実行はできません |630| 読み取り専用分析 | `Read`、`Grep`、`Glob` | コードを検査できますが、変更または実行はできません |

631| テスト実行 | `Bash`、`Read`、`Grep` | コマンドを実行し、出力を分析できます |631| テスト実行 | `Bash`、`Read`、`Grep` | コマンドを実行し、出力を分析できます |

632| コード変更 | `Read`、`Edit`、`Write`、`Grep`、`Glob` | コマンド実行なしで完全な読み取り/書き込みアクセス |632| コード変更 | `Read`、`Edit`、`Write`、`Grep`、`Glob` | コマンド実行なしで完全な読み取り/書き込みアクセス |

645この成長は 3 つの方法でキャップできます。サブエージェントがどの程度深くネストするか、一度に何個実行するか、クエリ全体がいくら支出するかです。深さと並行実行数の制限は [`env`](/docs/ja/agent-sdk/typescript#options) オプションを通じて環境変数として設定し、支出制限はクエリオプションとして設定します。645この成長は 3 つの方法でキャップできます。サブエージェントがどの程度深くネストするか、一度に何個実行するか、クエリ全体がいくら支出するかです。深さと並行実行数の制限は [`env`](/docs/ja/agent-sdk/typescript#options) オプションを通じて環境変数として設定し、支出制限はクエリオプションとして設定します。

646 646 

647| 制限 | 設定方法 | デフォルト | Claude Code が制限に達したときの動作 |647| 制限 | 設定方法 | デフォルト | Claude Code が制限に達したときの動作 |

648| :---- | :------------------------------------------------------ | :------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |648| :- | :- | :- | :- |

649| 深さ | [`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/ja/env-vars) | メインエージェントの下に `3` 層のサブエージェント。`1` はサブエージェントが独自のサブエージェントを生成することを停止します | 下層のサブエージェントが生成できないようにして、委譲された作業を自分で実行します。[ネストされたサブエージェント](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents)を参照してください |649| 深さ | [`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/ja/env-vars) | メインエージェントの下に `3` 層のサブエージェント。`1` はサブエージェントが独自のサブエージェントを生成することを停止します | 下層のサブエージェントが生成できないようにして、委譲された作業を自分で実行します。[ネストされたサブエージェント](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents)を参照してください |

650| 並行実行数 | [`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`](/docs/ja/env-vars) | `20` 個のサブエージェントが同時に実行され、Agent ツールで Claude が生成するすべてのサブエージェントをカウントします | 別のサブエージェントの生成を拒否し、`Concurrent subagent limit reached` を返します。実行中のカウントが制限を下回るまで待機します。[ultracode](/docs/ja/model-config#adjust-effort-level)がアクティブなセッションは拒否されることはありません。[並行サブエージェント制限](/docs/ja/sub-agents#concurrent-subagent-limit)を参照してください |650| 並行実行数 | [`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`](/docs/ja/env-vars) | `20` 個のサブエージェントが同時に実行され、Agent ツールで Claude が生成するすべてのサブエージェントをカウントします | 別のサブエージェントの生成を拒否し、`Concurrent subagent limit reached` を返します。実行中のカウントが制限を下回るまで待機します。[ultracode](/docs/ja/model-config#adjust-effort-level)がアクティブなセッションは拒否されることはありません。[並行サブエージェント制限](/docs/ja/sub-agents#concurrent-subagent-limit)を参照してください |

651| 支出 | TypeScript では `maxBudgetUsd`、Python では `max_budget_usd` | 制限なし。呼び出し自体の支出をカウントし、サブエージェントリクエストが含まれます | キャップを 3 つの方法で実装します。より多くのサブエージェントの生成を拒否し、`Budget limit reached` を返します。実行中のバックグラウンドサブエージェントを停止し、`error_max_budget_usd` 結果サブタイプでクエリを終了します。セッション全体でキャップがどのように動作するかについては、[ターンと予算](/docs/ja/agent-sdk/agent-loop#turns-and-budget)を参照してください |651| 支出 | TypeScript では `maxBudgetUsd`、Python では `max_budget_usd` | 制限なし。呼び出し自体の支出をカウントし、サブエージェントリクエストが含まれます | キャップを 3 つの方法で実装します。より多くのサブエージェントの生成を拒否し、`Budget limit reached` を返します。実行中のバックグラウンドサブエージェントを停止し、`error_max_budget_usd` 結果サブタイプでクエリを終了します。セッション全体でキャップがどのように動作するかについては、[ターンと予算](/docs/ja/agent-sdk/agent-loop#turns-and-budget)を参照してください |

43SDK は、`ANTHROPIC_BASE_URL` が非ファーストパーティホストを指す場合もツール検索を無効にします。ほとんどのプロキシは `tool_reference` ブロックを転送しないためです。`ENABLE_TOOL_SEARCH` 環境変数でそのデフォルトをオーバーライドできます。43SDK は、`ANTHROPIC_BASE_URL` が非ファーストパーティホストを指す場合もツール検索を無効にします。ほとんどのプロキシは `tool_reference` ブロックを転送しないためです。`ENABLE_TOOL_SEARCH` 環境変数でそのデフォルトをオーバーライドできます。

44 44 

45| 値 | 動作 |45| 値 | 動作 |

46| :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |46| :- | :- |

47| （未設定） | ツール検索はオンです。ツール定義は遅延され、オンデマンドで検出されます。Google Cloud の Agent Platform の Claude 4.5 世代より前のモデル、非ファーストパーティ `ANTHROPIC_BASE_URL`、または Microsoft Foundry デプロイメント（Azure でホストされている場合）では、事前読み込みにフォールバックします。 |47| （未設定） | ツール検索はオンです。ツール定義は遅延され、オンデマンドで検出されます。Google Cloud の Agent Platform の Claude 4.5 世代より前のモデル、非ファーストパーティ `ANTHROPIC_BASE_URL`、または Microsoft Foundry デプロイメント（Azure でホストされている場合）では、事前読み込みにフォールバックします。 |

48| `true` | ツール検索は常にオンです。ただし、Microsoft Foundry デプロイメント（Azure でホストされている場合）ではサーバー側の拒否により事前読み込みが強制され、Google Cloud の Agent Platform の Claude 4.5 世代より前のモデルでは SDK がツール定義を事前に読み込み続けます。SDK はプロキシ経由でベータヘッダーを送信し、`tool_reference` ブロックをサポートしないプロキシではリクエストが失敗します。 |48| `true` | ツール検索は常にオンです。ただし、Microsoft Foundry デプロイメント（Azure でホストされている場合）ではサーバー側の拒否により事前読み込みが強制され、Google Cloud の Agent Platform の Claude 4.5 世代より前のモデルでは SDK がツール定義を事前に読み込み続けます。SDK はプロキシ経由でベータヘッダーを送信し、`tool_reference` ブロックをサポートしないプロキシではリクエストが失敗します。 |

49| `auto` | ツール検索が遅延できるツール定義のトークン数をカウントし、合計をモデルのコンテキストウィンドウと比較します。合計がウィンドウの 10% に達すると、ツール検索がアクティブになります。それ以下の場合、SDK はすべてのツール定義をコンテキストに事前読み込みします。 |49| `auto` | ツール検索が遅延できるツール定義のトークン数をカウントし、合計をモデルのコンテキストウィンドウと比較します。合計がウィンドウの 10% に達すると、ツール検索がアクティブになります。それ以下の場合、SDK はすべてのツール定義をコンテキストに事前読み込みします。 |

11フック発火やスキル使用など、機能に関連する症状については、その機能のページにトラブルシューティングセクションがあります。以下の表は、各症状をカバーするセクションまたはページを示しています。11フック発火やスキル使用など、機能に関連する症状については、その機能のページにトラブルシューティングセクションがあります。以下の表は、各症状をカバーするセクションまたはページを示しています。

12 12 

13| 症状 | 参照先 |13| 症状 | 参照先 |

14| :------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------- |14| :- | :- |

15| スキルが見つからない、スキルが使用されていない、`Invalid skill name` エラー | [スキルのトラブルシューティング](/docs/ja/agent-sdk/skills#troubleshooting) |15| スキルが見つからない、スキルが使用されていない、`Invalid skill name` エラー | [スキルのトラブルシューティング](/docs/ja/agent-sdk/skills#troubleshooting) |

16| MCP サーバーが `failed` ステータスを表示、ツールが呼び出されない、接続タイムアウト、最大許容トークン数を超えるツール出力 | [MCP のトラブルシューティング](/docs/ja/agent-sdk/mcp#troubleshooting) |16| MCP サーバーが `failed` ステータスを表示、ツールが呼び出されない、接続タイムアウト、最大許容トークン数を超えるツール出力 | [MCP のトラブルシューティング](/docs/ja/agent-sdk/mcp#troubleshooting) |

17| プラグインが読み込まれない、プラグインスキルが表示されない | [プラグインのトラブルシューティング](/docs/ja/agent-sdk/plugins#troubleshooting) |17| プラグインが読み込まれない、プラグインスキルが表示されない | [プラグインのトラブルシューティング](/docs/ja/agent-sdk/plugins#troubleshooting) |

81SDK は解決されたパスでファイルを見つけましたが、起動できませんでした。Python はこれらの失敗を `CLIConnectionError` として発生させます。TypeScript はメッセージ反復を SDK クラスを持たないエラーで拒否します。以下の表は各メッセージを何を示しているかにマップします。表示されるメッセージに一致させてください：81SDK は解決されたパスでファイルを見つけましたが、起動できませんでした。Python はこれらの失敗を `CLIConnectionError` として発生させます。TypeScript はメッセージ反復を SDK クラスを持たないエラーで拒否します。以下の表は各メッセージを何を示しているかにマップします。表示されるメッセージに一致させてください：

82 82 

83| メッセージ | SDK | 意味 |83| メッセージ | SDK | 意味 |

84| ----------------------------------------------------------------- | ---------- | ---------------------------------- |84| - | - | - |

85| `Failed to start Claude Code: <detail>` | Python | メッセージの残りはオペレーティングシステム自体のエラーです |85| `Failed to start Claude Code: <detail>` | Python | メッセージの残りはオペレーティングシステム自体のエラーです |

86| `Claude Code executable at <path> exists but failed to launch` | TypeScript | 設定されたパスのスクリプトは実行できません |86| `Claude Code executable at <path> exists but failed to launch` | TypeScript | 設定されたパスのスクリプトは実行できません |

87| `Claude Code native binary at <path> exists but failed to launch` | TypeScript | バイナリは実行できません。libc の提案がメッセージに追加されます |87| `Claude Code native binary at <path> exists but failed to launch` | TypeScript | バイナリは実行できません。libc の提案がメッセージに追加されます |

79</h4>79</h4>

80 80 

81| パラメータ | 型 | 説明 |81| パラメータ | 型 | 説明 |

82| :-------- | :--------------------------------------------------------------- | :--------------------------------------- |82| :- | :- | :- |

83| `prompt` | `string \| AsyncIterable<`[`SDKUserMessage`](#sdkusermessage)`>` | 入力プロンプト（文字列またはストリーミングモード用の非同期反復可能オブジェクト） |83| `prompt` | `string \| AsyncIterable<`[`SDKUserMessage`](#sdkusermessage)`>` | 入力プロンプト（文字列またはストリーミングモード用の非同期反復可能オブジェクト） |

84| `options` | [`Options`](#options) | オプションの設定オブジェクト（以下の Options 型を参照） |84| `options` | [`Options`](#options) | オプションの設定オブジェクト（以下の Options 型を参照） |

85 85 

107</h4>107</h4>

108 108 

109| パラメータ | 型 | 説明 |109| パラメータ | 型 | 説明 |

110| :-------------------- | :-------------------- | :------------------------------------------------------------------------------ |110| :- | :- | :- |

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

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

113 113 

156</h4>156</h4>

157 157 

158| パラメータ | 型 | 説明 |158| パラメータ | 型 | 説明 |

159| :------------ | :----------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |159| :- | :- | :- |

160| `name` | `string` | ツールの名前 |160| `name` | `string` | ツールの名前 |

161| `description` | `string` | ツールが何をするかの説明 |161| `description` | `string` | ツールが何をするかの説明 |

162| `inputSchema` | `Schema extends AnyZodRawShape` | ツールの入力パラメータを定義する Zod スキーマ（Zod 3 と Zod 4 の両方をサポート） |162| `inputSchema` | `Schema extends AnyZodRawShape` | ツールの入力パラメータを定義する Zod スキーマ（Zod 3 と Zod 4 の両方をサポート） |

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

171 171 

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

173| :---------------- | :-------- | :---------- | :------------------------------------------------------------------------------------ |173| :- | :- | :- | :- |

174| `title` | `string` | `undefined` | ツールの人間が読める形のタイトル |174| `title` | `string` | `undefined` | ツールの人間が読める形のタイトル |

175| `readOnlyHint` | `boolean` | `false` | `true` の場合、ツールはその環境を変更しません |175| `readOnlyHint` | `boolean` | `false` | `true` の場合、ツールはその環境を変更しません |

176| `destructiveHint` | `boolean` | `true` | `true` の場合、ツールは破壊的な更新を実行する可能性があります（`readOnlyHint` が `false` の場合のみ意味があります） |176| `destructiveHint` | `boolean` | `true` | `true` の場合、ツールは破壊的な更新を実行する可能性があります（`readOnlyHint` が `false` の場合のみ意味があります） |

214</h4>214</h4>

215 215 

216| パラメータ | 型 | 説明 |216| パラメータ | 型 | 説明 |

217| :--------------------- | :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |217| :- | :- | :- |

218| `options.name` | `string` | MCP サーバーの名前 |218| `options.name` | `string` | MCP サーバーの名前 |

219| `options.version` | `string` | オプションのバージョン文字列 |219| `options.version` | `string` | オプションのバージョン文字列 |

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

237</h4>237</h4>

238 238 

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

240| :------------------------- | :-------- | :---------- | :--------------------------------------------------- |240| :- | :- | :- | :- |

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

242| `options.limit` | `number` | `undefined` | 返すセッションの最大数 |242| `options.limit` | `number` | `undefined` | 返すセッションの最大数 |

243| `options.includeWorktrees` | `boolean` | `true` | `dir` が git リポジトリ内にある場合、すべての worktree パスからセッションを含めます |243| `options.includeWorktrees` | `boolean` | `true` | `dir` が git リポジトリ内にある場合、すべての worktree パスからセッションを含めます |

247</h4>247</h4>

248 248 

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

250| :------------- | :-------------------- | :-------------------------------------------------- |250| :- | :- | :- |

251| `sessionId` | `string` | 一意のセッション識別子（UUID） |251| `sessionId` | `string` | 一意のセッション識別子（UUID） |

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

253| `lastModified` | `number` | 最後に変更された時刻（エポック以降のミリ秒） |253| `lastModified` | `number` | 最後に変更された時刻（エポック以降のミリ秒） |

293</h4>293</h4>

294 294 

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

296| :--------------- | :------- | :---------- | :--------------------------------------------- |296| :- | :- | :- | :- |

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

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

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

304</h4>304</h4>

305 305 

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

307| :------------------- | :---------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |307| :- | :- | :- |

308| `type` | `"user" \| "assistant"` | メッセージロール |308| `type` | `"user" \| "assistant"` | メッセージロール |

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

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

351</h4>351</h4>

352 352 

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

354| :------------ | :------- | :---------- | :------------------------------------------- |354| :- | :- | :- | :- |

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

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

357 357 

376</h4>376</h4>

377 377 

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

379| :------------ | :------- | :---------- | :------------------------------------------- |379| :- | :- | :- | :- |

380| `sessionId` | `string` | 必須 | 名前を変更するセッションの UUID |380| `sessionId` | `string` | 必須 | 名前を変更するセッションの UUID |

381| `title` | `string` | 必須 | 新しいタイトル。空白をトリミングした後、空でない必要があります |381| `title` | `string` | 必須 | 新しいタイトル。空白をトリミングした後、空でない必要があります |

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

400</h4>400</h4>

401 401 

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

403| :------------ | :--------------- | :---------- | :------------------------------------------- |403| :- | :- | :- | :- |

404| `sessionId` | `string` | 必須 | タグを付けるセッションの UUID |404| `sessionId` | `string` | 必須 | タグを付けるセッションの UUID |

405| `tag` | `string \| null` | 必須 | タグ文字列、またはクリアする場合は `null` |405| `tag` | `string \| null` | 必須 | タグ文字列、またはクリアする場合は `null` |

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

434`resolveSettings()` は単一のオプションオブジェクトを受け入れます。すべてのフィールドはオプションです。434`resolveSettings()` は単一のオプションオブジェクトを受け入れます。すべてのフィールドはオプションです。

435 435 

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

437| :------------------------------ | :------------------------------------ | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |437| :- | :- | :- | :- |

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

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

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

447`resolveSettings()` はマージされた設定と各キーに貢献したソースを説明するオブジェクトを返します。447`resolveSettings()` はマージされた設定と各キーに貢献したソースを説明するオブジェクトを返します。

448 448 

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

450| :----------- | :-------------------------------------------------- | :--------------------------------------- |450| :- | :- | :- |

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

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

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

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

482 482 

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

484| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |484| :- | :- | :- | :- |

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

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

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

634</h4>634</h4>

635 635 

636| メソッド | 説明 |636| メソッド | 説明 |

637| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |637| :- | :- |

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

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

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

733</h4>733</h4>

734 734 

735| メソッド | 説明 |735| メソッド | 説明 |

736| :-------------- | :------------------------------------------------------------------------------------------ |736| :- | :- |

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

738| `close()` | プロンプトを送信せずにサブプロセスを閉じます。不要になった暖かいクエリを破棄するために使用します |738| `close()` | プロンプトを送信せずにサブプロセスを閉じます。不要になった暖かいクエリを破棄するために使用します |

739 739 

1011```1011```

1012 1012 

1013| フィールド | 必須 | 説明 |1013| フィールド | 必須 | 説明 |

1014| :------------------------------------ | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |1014| :- | :- | :- |

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

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

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

1051```1051```

1052 1052 

1053| 値 | 説明 | 場所 |1053| 値 | 説明 | 場所 |

1054| :---------- | :------------------------------------------------- | :---------------------------- |1054| :- | :- | :- |

1055| `'user'` | グローバルユーザー設定 | `~/.claude/settings.json` |1055| `'user'` | グローバルユーザー設定 | `~/.claude/settings.json` |

1056| `'project'` | 共有プロジェクト設定（バージョン管理） | `.claude/settings.json` |1056| `'project'` | 共有プロジェクト設定（バージョン管理） | `.claude/settings.json` |

1057| `'local'` | ローカルプロジェクト設定、Claude Code が設定をそれに保存するときに gitignored | `.claude/settings.local.json` |1057| `'local'` | ローカルプロジェクト設定、Claude Code が設定をそれに保存するときに gitignored | `.claude/settings.local.json` |

1148```1148```

1149 1149 

1150| オプション | 型 | 説明 |1150| オプション | 型 | 説明 |

1151| :--------------- | :------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1151| :- | :- | :- |

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

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

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

1199```1199```

1200 1200 

1201| フィールド | 型 | 説明 |1201| フィールド | 型 | 説明 |

1202| :------------------------------ | :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ |1202| :- | :- | :- |

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

1204 1204 

1205<h3 id="mcpserverconfig">1205<h3 id="mcpserverconfig">

1293```1293```

1294 1294 

1295| フィールド | 型 | 説明 |1295| フィールド | 型 | 説明 |

1296| :----------------- | :-------- | :----------------------------------------------------------------------------------------------------------------------------------------- |1296| :- | :- | :- |

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

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

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

1547理由コードを使用して、独自の UI で高速モードがオフになっている理由を説明し、可用性を再導出する代わりに説明します。各コードは高速モードをブロックしたチェックに名前を付けます：1547理由コードを使用して、独自の UI で高速モードがオフになっている理由を説明し、可用性を再導出する代わりに説明します。各コードは高速モードをブロックしたチェックに名前を付けます：

1548 1548 

1549| 理由コード | 意味 |1549| 理由コード | 意味 |

1550| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------- |1550| - | - |

1551| `free` | アカウントが高速モードに必要な有料サブスクリプションまたは使用クレジットを持っていません |1551| `free` | アカウントが高速モードに必要な有料サブスクリプションまたは使用クレジットを持っていません |

1552| `preference` | 組織が高速モードを無効にしました |1552| `preference` | 組織が高速モードを無効にしました |

1553| `extra_usage_disabled` | 使用クレジットがアカウントに対してオフになっています |1553| `extra_usage_disabled` | 使用クレジットがアカウントに対してオフになっています |

1651各値は 1 つの拒否に名前を付けます：1651各値は 1 つの拒否に名前を付けます：

1652 1652 

1653| 値 | セッションを停止したもの |1653| 値 | セッションを停止したもの |

1654| :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |1654| :- | :- |

1655| `org_pin_api_key_conflict` | 管理設定が [ファーストパーティまたはクラウドゲートウェイサインイン](/docs/ja/authentication#restrict-login-to-your-organization) を必要とし、Anthropic API キー、認証トークン、または `apiKeyHelper` が代わりに設定されています |1655| `org_pin_api_key_conflict` | 管理設定が [ファーストパーティまたはクラウドゲートウェイサインイン](/docs/ja/authentication#restrict-login-to-your-organization) を必要とし、Anthropic API キー、認証トークン、または `apiKeyHelper` が代わりに設定されています |

1656| `org_verify_failed` | サインインの組織をピンに対して検証できませんでした。例えば、ネットワーク障害または失効したトークンのため |1656| `org_verify_failed` | サインインの組織をピンに対して検証できませんでした。例えば、ネットワーク障害または失効したトークンのため |

1657| `org_pin_mismatch` | サインインはピンが許可しない組織に属しています |1657| `org_pin_mismatch` | サインインはピンが許可しない組織に属しています |

1716`capabilities` 配列は、この CLI が実装するプロトコル動作に名前を付けるため、`claude_code_version` 文字列を比較する代わりに機能検出を行うことができます。これはオープンセットです：認識しない値は無視し、依存する特定の動作の機能をチェックしてください。フィールドには Claude Code v2.1.205 以降が必要で、以前の CLI では存在しません。1716`capabilities` 配列は、この CLI が実装するプロトコル動作に名前を付けるため、`claude_code_version` 文字列を比較する代わりに機能検出を行うことができます。これはオープンセットです：認識しない値は無視し、依存する特定の動作の機能をチェックしてください。フィールドには Claude Code v2.1.205 以降が必要で、以前の CLI では存在しません。