Documentation 2026-08-03 20:02 UTC to 2026-08-04 22:59 UTC

22 22 

23* 1 つのセッション用：`claude --ax-screen-reader` を実行します。23* 1 つのセッション用：`claude --ax-screen-reader` を実行します。

24* 1 つのシェルから開始されたセッション用：`CLAUDE_AX_SCREEN_READER` 環境変数を `1` に設定します。Bash または Zsh では `export CLAUDE_AX_SCREEN_READER=1` を実行し、PowerShell では `$env:CLAUDE_AX_SCREEN_READER = "1"` を実行します。すべてのシェルをカバーするために、シェルプロファイルに行を追加します。24* 1 つのシェルから開始されたセッション用：`CLAUDE_AX_SCREEN_READER` 環境変数を `1` に設定します。Bash または Zsh では `export CLAUDE_AX_SCREEN_READER=1` を実行し、PowerShell では `$env:CLAUDE_AX_SCREEN_READER = "1"` を実行します。すべてのシェルをカバーするために、シェルプロファイルに行を追加します。

25* マシン上のすべてのセッション用：ユーザー[設定ファイル](/ja/settings)に `"axScreenReader": true` を追加します。これは VS Code 統合ターミナルを含むすべてのターミナルをカバーします。25* マシン上のすべてのセッション用：ユーザー[設定ファイル](/docs/ja/settings)に `"axScreenReader": true` を追加します。これは VS Code 統合ターミナルを含むすべてのターミナルをカバーします。

26 26 

27<Note>27<Note>

28 メソッドは優先順位順にリストされています。[`--ax-screen-reader`](/ja/cli-reference#cli-flags) フラグは [`CLAUDE_AX_SCREEN_READER`](/ja/env-vars) 環境変数をオーバーライドし、これは [`axScreenReader`](/ja/settings#available-settings) 設定をオーバーライドします。28 メソッドは優先順位順にリストされています。[`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) フラグは [`CLAUDE_AX_SCREEN_READER`](/docs/ja/env-vars) 環境変数をオーバーライドし、これは [`axScreenReader`](/docs/ja/settings#available-settings) 設定をオーバーライドします。

29</Note>29</Note>

30 30 

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

32 32 

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

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

35 35 

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

37 スクリーンリーダーモードをオフにする37 スクリーンリーダーモードをオフにする

48* インターフェースクロムのボックス描画文字なし48* インターフェースクロムのボックス描画文字なし

49* 色のみのキューなし49* 色のみのキューなし

50* 変更されていないコンテンツの再描画なし。プログレススピナーは静的テキストとしてレンダリングされます50* 変更されていないコンテンツの再描画なし。プログレススピナーは静的テキストとしてレンダリングされます

51* Claude の返信のテーブルは、ボックス文字グリッドの代わりに `Header: value` 文として読み上げられます。{/* min-version: 2.1.198 */}Claude Code v2.1.198 以降が必要です。以前のバージョンはスクリーンリーダーモードでもテーブルをグリッドとして描画します。51* Claude の返信のテーブルは、ボックス文字グリッドの代わりに `Header: value` 文として読み上げられます。Claude Code v2.1.198 以降が必要です。以前のバージョンはスクリーンリーダーモードでもテーブルをグリッドとして描画します。

52 52 

53出力はターミナルのスクロールバックに蓄積されるため、スクリーンリーダーのレビューコマンドまたはターミナルの検索を使用して以前のターンを再度読むことができます。53出力はターミナルのスクロールバックに蓄積されるため、スクリーンリーダーのレビューコマンドまたはターミナルの検索を使用して以前のターンを再度読むことができます。

54 54 

55スクリーンリーダーモードは、[フルスクリーンレンダリング](/ja/fullscreen)を [`tui` 設定](/ja/settings#available-settings)でオンにしている場合でも、プレーンなスクロールテキストとしてレンダリングされます。モードがアクティブな間、設定は効果がありません。アタッチされたバックグラウンドセッションは引き続きフルスクリーンでレンダリングされます。[既知の制限事項](#known-limitations)を参照してください。55スクリーンリーダーモードは、[フルスクリーンレンダリング](/docs/ja/fullscreen)を [`tui` 設定](/docs/ja/settings#available-settings)でオンにしている場合でも、プレーンなスクロールテキストとしてレンダリングされます。モードがアクティブな間、設定は効果がありません。アタッチされたバックグラウンドセッションは引き続きフルスクリーンでレンダリングされます。[既知の制限事項](#known-limitations)を参照してください。

56 56 

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

58 58 

64| `tool error:` | 失敗したツール |64| `tool error:` | 失敗したツール |

65| `error:` | 失敗した API リクエストなどの会話内のエラー |65| `error:` | 失敗した API リクエストなどの会話内のエラー |

66| `Permission Required:` | あなたの回答を待っている権限プロンプト |66| `Permission Required:` | あなたの回答を待っている権限プロンプト |

67| `Cost:` | Claude Code が終了するときのセッションコスト概要（アカウントが[コストを表示](/ja/costs)している場合） |67| `Cost:` | Claude Code が終了するときのセッションコスト概要（アカウントが[コストを表示](/docs/ja/costs)している場合） |

68 68 

69ターミナルカーソルは入力キャレットに従うため、スクリーンリーダーの現在の行を読むコマンドは「どこにいるのか」に編集しているプロンプトで答えます。69ターミナルカーソルは入力キャレットに従うため、スクリーンリーダーの現在の行を読むコマンドは「どこにいるのか」に編集しているプロンプトで答えます。

70 70 

102* 権限プロンプトが表示される102* 権限プロンプトが表示される

103* 5 秒以上実行されたツールが完了する103* 5 秒以上実行されたツールが完了する

104 104 

105ベルはターミナルの標準アラートです。それをサイレントにするには、ターミナルアプリケーションのベル設定を変更します。ベルはスクリーンリーダーモードを必要としません。モード外では、[`preferredNotifChannel`](/ja/settings#available-settings) を `"terminal_bell"` に設定して、Claude があなたを待っているときに同様のアラートを取得します。[ターミナルベルまたは通知を取得する](/ja/terminal-config#get-a-terminal-bell-or-notification)を参照してください。105ベルはターミナルの標準アラートです。それをサイレントにするには、ターミナルアプリケーションのベル設定を変更します。ベルはスクリーンリーダーモードを必要としません。モード外では、[`preferredNotifChannel`](/docs/ja/settings#available-settings) を `"terminal_bell"` に設定して、Claude があなたを待っているときに同様のアラートを取得します。[ターミナルベルまたは通知を取得する](/docs/ja/terminal-config#get-a-terminal-bell-or-notification)を参照してください。

106 106 

107<h2 id="accessibility-settings-beyond-screen-reader-mode">107<h2 id="accessibility-settings-beyond-screen-reader-mode">

108 スクリーンリーダーモード以外のアクセシビリティ設定108 スクリーンリーダーモード以外のアクセシビリティ設定

110 110 

111これらのオプションはスクリーンリーダーモード外のアクセシビリティニーズに対応しています。すべてそれと一緒に機能します。111これらのオプションはスクリーンリーダーモード外のアクセシビリティニーズに対応しています。すべてそれと一緒に機能します。

112 112 

113* `CLAUDE_CODE_ACCESSIBILITY` [環境変数](/ja/env-vars)はスクリーン拡大鏡用です。`CLAUDE_CODE_ACCESSIBILITY=1` を設定して、ネイティブターミナルカーソルを表示したままにして、macOS Zoom などの拡大鏡がカーソル位置を追跡できるようにします。113* `CLAUDE_CODE_ACCESSIBILITY` [環境変数](/docs/ja/env-vars)はスクリーン拡大鏡用です。`CLAUDE_CODE_ACCESSIBILITY=1` を設定して、ネイティブターミナルカーソルを表示したままにして、macOS Zoom などの拡大鏡がカーソル位置を追跡できるようにします。

114* `prefersReducedMotion` [設定](/ja/settings#available-settings)は、インターフェースの残りを変更せずにスピナー、シマー、その他のアニメーションを削減または無効にします。114* `prefersReducedMotion` [設定](/docs/ja/settings#available-settings)は、インターフェースの残りを変更せずにスピナー、シマー、その他のアニメーションを削減または無効にします。

115* `theme` [設定](/ja/settings#available-settings)はインターフェースの色を選択します。カラーブラインド対応の `dark-daltonized` および `light-daltonized` テーマを含みます。115* `theme` [設定](/docs/ja/settings#available-settings)はインターフェースの色を選択します。カラーブラインド対応の `dark-daltonized` および `light-daltonized` テーマを含みます。

116 116 

117<h2 id="known-limitations">117<h2 id="known-limitations">

118 既知の制限事項118 既知の制限事項

121一部の動作はスクリーンリーダーモード用に適応していません。121一部の動作はスクリーンリーダーモード用に適応していません。

122 122 

123* スクリーンリーダーモードは、スクリーンリーダーが実行されているときに自動的にオンになりません。123* スクリーンリーダーモードは、スクリーンリーダーが実行されているときに自動的にオンになりません。

124* [プランモード](/ja/permission-modes#analyze-before-you-edit-with-plan-mode)に入るなどのモード変更はまだ発表されていません。124* [プランモード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)に入るなどのモード変更はまだ発表されていません。

125* `claude attach` または agent view から[バックグラウンドセッション](/ja/agent-view)にアタッチすると、ターミナルの代替画面に入ります。これはネイティブスクロールバックがありません。これは[他のアタッチされたセッションと同じ動作](/ja/fullscreen)です。抜け出すには、空のプロンプトで左矢印を押すか、ダイアログにフォーカスがある場合は Ctrl+Z を押します。125* `claude attach` または agent view から[バックグラウンドセッション](/docs/ja/agent-view)にアタッチすると、ターミナルの代替画面に入ります。これはネイティブスクロールバックがありません。これは[他のアタッチされたセッションと同じ動作](/docs/ja/fullscreen)です。抜け出すには、空のプロンプトで左矢印を押すか、ダイアログにフォーカスがある場合は Ctrl+Z を押します。

126* Claude Code はコストを終了時に出力するサマリーで発表し、ターンごとではありません。126* Claude Code はコストを終了時に出力するサマリーで発表し、ターンごとではありません。

127* スクリーンリーダーモードは `-p` フラグで[非対話型モード](/ja/headless)を変更しません。非対話型モードは既にプレーンテキストを書き込み、スクリプト作成の代替案のままです。127* スクリーンリーダーモードは `-p` フラグで[非対話型モード](/docs/ja/headless)を変更しません。非対話型モードは既にプレーンテキストを書き込み、スクリプト作成の代替案のままです。

128 128 

129<h2 id="report-an-issue">129<h2 id="report-an-issue">

130 問題を報告する130 問題を報告する

138 138 

139これらのページには、このページがカバーする内容の完全なリファレンスエントリと関連セットアップが含まれています。139これらのページには、このページがカバーする内容の完全なリファレンスエントリと関連セットアップが含まれています。

140 140 

141* [設定](/ja/settings#available-settings)：`axScreenReader`、`prefersReducedMotion`、`theme`、および `preferredNotifChannel` エントリ141* [設定](/docs/ja/settings#available-settings)：`axScreenReader`、`prefersReducedMotion`、`theme`、および `preferredNotifChannel` エントリ

142* [環境変数](/ja/env-vars)：`CLAUDE_AX_SCREEN_READER` および `CLAUDE_CODE_ACCESSIBILITY` エントリ142* [環境変数](/docs/ja/env-vars)：`CLAUDE_AX_SCREEN_READER` および `CLAUDE_CODE_ACCESSIBILITY` エントリ

143* [CLI リファレンス](/ja/cli-reference#cli-flags)：`--ax-screen-reader` フラグ143* [CLI リファレンス](/docs/ja/cli-reference#cli-flags)：`--ax-screen-reader` フラグ

144* [ターミナル設定](/ja/terminal-config)：スクリーンリーダーモード外のベル、通知、テーマ144* [ターミナル設定](/docs/ja/terminal-config)：スクリーンリーダーモード外のベル、通知、テーマ

145* [非対話型モード](/ja/headless)：スクリプト化された `claude -p` 実行。スクリーンリーダーモードなしでプレーンテキストを書き込みます145* [非対話型モード](/docs/ja/headless)：スクリプト化された `claude -p` 実行。スクリーンリーダーモードなしでプレーンテキストを書き込みます

22 22 

23advisor は、ほとんどのターンが定型的であるが、プラン品質が結果を決定する長い複数ステップのタスクに適しています。例としては、大規模なリファクタリング、エラーが繰り返し発生するデバッグセッション、および Claude が完了を宣言する前に独立して確認したいタスクが挙げられます。23advisor は、ほとんどのターンが定型的であるが、プラン品質が結果を決定する長い複数ステップのタスクに適しています。例としては、大規模なリファクタリング、エラーが繰り返し発生するデバッグセッション、および Claude が完了を宣言する前に独立して確認したいタスクが挙げられます。

24 24 

25計画する必要がほとんどない短いタスク、またはすべてのターンで最強のモデルが必要な作業では、価値が低くなります。その場合は、[メインモデルを切り替える](/ja/model-config#setting-your-model)か、[advisor が opusplan およびサブエージェントとどのように比較されるか](#compare-with-related-features)を参照して、2 番目の意見を得る他の方法を確認してください。25計画する必要がほとんどない短いタスク、またはすべてのターンで最強のモデルが必要な作業では、価値が低くなります。その場合は、[メインモデルを切り替える](/docs/ja/model-config#setting-your-model)か、[advisor が opusplan およびサブエージェントとどのように比較されるか](#compare-with-related-features)を参照して、2 番目の意見を得る他の方法を確認してください。

26 26 

27<h2 id="enable-the-advisor">27<h2 id="enable-the-advisor">

28 advisor を有効にする28 advisor を有効にする

31advisor モデルは 3 つの方法で設定できます。31advisor モデルは 3 つの方法で設定できます。

32 32 

33* **`/advisor` コマンド**：セッション中に advisor を設定または変更し、デフォルトとして保存します33* **`/advisor` コマンド**：セッション中に advisor を設定または変更し、デフォルトとして保存します

34* **`advisorModel` 設定**：[設定ファイル](/ja/settings)で永続的なデフォルトを構成します34* **`advisorModel` 設定**：[設定ファイル](/docs/ja/settings)で永続的なデフォルトを構成します

35* **`--advisor` フラグ**：起動時に単一セッションの advisor を設定します35* **`--advisor` フラグ**：起動時に単一セッションの advisor を設定します

36 36 

37これらのいずれかが advisor モデルを設定する場合、advisor はメインモデルが[それをサポートしている](#choose-an-advisor-model)セッションで有効になります。使用を停止するには、[advisor をオフにする](#turn-the-advisor-off)を参照してください。37これらのいずれかが advisor モデルを設定する場合、advisor はメインモデルが[それをサポートしている](#choose-an-advisor-model)セッションで有効になります。使用を停止するには、[advisor をオフにする](#turn-the-advisor-off)を参照してください。

38 38 

39<Note>39<Note>

40 Fable 5 を advisor として使用するには、Claude Code v2.1.170 以降と、組織の [Fable 5 アクセス](/ja/model-config#work-with-fable-5)が必要です。40 Fable 5 を advisor として使用するには、Claude Code v2.1.170 以降と、組織の [Fable 5 アクセス](/docs/ja/model-config#work-with-fable-5)が必要です。

41</Note>41</Note>

42 42 

43<h3 id="use-the-/advisor-command">43<h3 id="use-the-/advisor-command">

50/advisor opus50/advisor opus

51```51```

52 52 

53選択は、ユーザー設定の `advisorModel` に保存され、セッション全体で保持されます。組織の [`availableModels`](/ja/model-config#restrict-model-selection)許可リストが保存された advisor モデルを除外している場合、`/advisor` で許可されたモデルを選択するまで advisor は呼び出されません。現在のメインモデルが advisor をサポートしていない場合、選択は引き続き保存され、[`/model`](/ja/model-config#setting-your-model)で[互換性のあるメインモデル](#choose-an-advisor-model)に切り替えるときにアクティブになります。53選択は、ユーザー設定の `advisorModel` に保存され、セッション全体で保持されます。組織の [`availableModels`](/docs/ja/model-config#restrict-model-selection)許可リストが保存された advisor モデルを除外している場合、`/advisor` で許可されたモデルを選択するまで advisor は呼び出されません。現在のメインモデルが advisor をサポートしていない場合、選択は引き続き保存され、[`/model`](/docs/ja/model-config#setting-your-model)で[互換性のあるメインモデル](#choose-an-advisor-model)に切り替えるときにアクティブになります。

54 54 

55<h3 id="set-advisormodel-in-settings">55<h3 id="set-advisormodel-in-settings">

56 設定で `advisorModel` を設定する56 設定で `advisorModel` を設定する

74claude --advisor opus74claude --advisor opus

75```75```

76 76 

77フラグはそのセッションの `advisorModel` 設定よりも優先されます。セッションのメインモデルが advisor をサポートしていない場合、またはリクエストされた advisor モデルが組織の [`availableModels`](/ja/model-config#restrict-model-selection)許可リストで除外されている場合、エラーで終了します。77フラグはそのセッションの `advisorModel` 設定よりも優先されます。セッションのメインモデルが advisor をサポートしていない場合、またはリクエストされた advisor モデルが組織の [`availableModels`](/docs/ja/model-config#restrict-model-selection)許可リストで除外されている場合、エラーで終了します。

78 78 

79<h2 id="choose-an-advisor-model">79<h2 id="choose-an-advisor-model">

80 advisor モデルを選択する80 advisor モデルを選択する

83advisor はメインモデル以上の機能を持つ必要があります。各メインモデルで受け入れられる advisor は次のとおりです。83advisor はメインモデル以上の機能を持つ必要があります。各メインモデルで受け入れられる advisor は次のとおりです。

84 84 

85| メインモデル | 受け入れられる advisor | 注記 |85| メインモデル | 受け入れられる advisor | 注記 |

86| ----------------------------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------- |86| ------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------- |

87| Haiku 4.5 | Fable、Opus、Sonnet | Haiku は advisor を呼び出すことはできますが、advisor として機能することはできません |87| Haiku 4.5 | Fable、Opus、Sonnet | Haiku は advisor を呼び出すことはできますが、advisor として機能することはできません |

88| Sonnet 4.6 | Fable、Opus、Sonnet | |88| Sonnet 4.6 | Fable、Opus、Sonnet | |

89| Sonnet 5 | Fable、Opus、Sonnet 5 | Sonnet 4.6 advisor は拒否されます |89| Sonnet 5 | Fable、Opus、Sonnet 5 | Sonnet 4.6 advisor は拒否されます |

90| Opus 4.6 | Fable、Opus、Sonnet 5 | Sonnet 5 と Opus 4.6 は同等の機能として評価されるため、Opus 4.6 メインは Sonnet 5 advisor を受け入れます |90| Opus 4.6 | Fable、Opus、Sonnet 5 | Sonnet 5 と Opus 4.6 は同等の機能として評価されるため、Opus 4.6 メインは Sonnet 5 advisor を受け入れます |

91| Opus 4.7 以降 | Fable、Opus 4.7、Opus 4.8 | Opus 4.7 と Opus 4.8 は同等の機能として評価されるため、どちらでも他方を advisor として受け入れます。Opus 4.6 または Sonnet 5 advisor を持つ Opus 4.7 メインは拒否されます |91| Opus 4.7 以降 | Fable、Opus 4.7、Opus 4.8 | Opus 4.7 と Opus 4.8 は同等の機能として評価されるため、どちらでも他方を advisor として受け入れます。Opus 4.6 または Sonnet 5 advisor を持つ Opus 4.7 メインは拒否されます |

92| Fable 5 ({/* min-version: 2.1.170 */}v2.1.170+) | Fable | Opus または Sonnet advisor は拒否されます |92| Fable 5 (v2.1.170+) | Fable | Opus または Sonnet advisor は拒否されます |

93 93 

94Fable 5 は、メインモデルとして機能するか advisor として機能するかに関わらず、Claude Code v2.1.170 以降と Fable 5 アクセスが必要です。94Fable 5 は、メインモデルとして機能するか advisor として機能するかに関わらず、Claude Code v2.1.170 以降と Fable 5 アクセスが必要です。

95 95 

141 141 

142各 advisor 呼び出しは会話を advisor モデルに送信するため、メインモデルの使用に加えて advisor モデルのレートでトークンを消費します。API 課金では、advisor トークンは advisor モデルの入力および出力レートで課金されます。サブスクリプションプランでは、advisor 使用量はプランの使用制限にカウントされます。142各 advisor 呼び出しは会話を advisor モデルに送信するため、メインモデルの使用に加えて advisor モデルのレートでトークンを消費します。API 課金では、advisor トークンは advisor モデルの入力および出力レートで課金されます。サブスクリプションプランでは、advisor 使用量はプランの使用制限にカウントされます。

143 143 

144Claude は各ターンではなく決定ポイントで advisor を呼び出すため、より高速なメインモデルをより強力な advisor と組み合わせることは、通常、より強力なモデルを全体で実行するよりもコストが低くなります。advisor 使用量は [`/usage`](/ja/costs#track-your-costs)で表示されるセッション合計にカウントされます。144Claude は各ターンではなく決定ポイントで advisor を呼び出すため、より高速なメインモデルをより強力な advisor と組み合わせることは、通常、より強力なモデルを全体で実行するよりもコストが低くなります。advisor 使用量は [`/usage`](/docs/ja/costs#track-your-costs)で表示されるセッション合計にカウントされます。

145 145 

146advisor トークンが API レスポンスでどのように報告されるかについては、Claude API ドキュメントの [使用量と課金](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool#usage-and-billing)を参照してください。146advisor トークンが API レスポンスでどのように報告されるかについては、Claude API ドキュメントの [使用量と課金](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool#usage-and-billing)を参照してください。

147 147 

149 プロンプトキャッシュへの影響149 プロンプトキャッシュへの影響

150</h2>150</h2>

151 151 

152セッション中に advisor を有効または無効にしても、メインモデルの[プロンプトキャッシュ](/ja/prompt-caching)は無効になりません。[モデルまたは努力レベルを変更する](/ja/prompt-caching#actions-that-invalidate-the-cache)とは異なり、`/advisor` を切り替えるとキャッシュされたプレフィックスはそのまま保持され、advisor が返したガイダンスは後のターンでトランスクリプトの一部としてキャッシュされます。152セッション中に advisor を有効または無効にしても、メインモデルの[プロンプトキャッシュ](/docs/ja/prompt-caching)は無効になりません。[モデルまたは努力レベルを変更する](/docs/ja/prompt-caching#actions-that-invalidate-the-cache)とは異なり、`/advisor` を切り替えるとキャッシュされたプレフィックスはそのまま保持され、advisor が返したガイダンスは後のターンでトランスクリプトの一部としてキャッシュされます。

153 153 

154advisor モデル自体の会話の読み取りはキャッシュされません。各 advisor 呼び出しは完全なトランスクリプトを新たに処理し、呼び出し間での再利用はありません。154advisor モデル自体の会話の読み取りはキャッシュされません。各 advisor 呼び出しは完全なトランスクリプトを新たに処理し、呼び出し間での再利用はありません。

155 155 

159 159 

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

161 161 

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

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

164 164 

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

166 advisor をオフにする166 advisor をオフにする

172/advisor off172/advisor off

173```173```

174 174 

175advisor ツール全体を無効にするには、`CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1` を設定します。`/advisor` コマンドは利用できなくなり、設定された `advisorModel` は無視されます。`--advisor` フラグは受け入れられますが、効果はありません。このフラグを渡す既存のスクリプトはエラーなしで動作し続けます。[環境変数](/ja/env-vars)を参照してください。175advisor ツール全体を無効にするには、`CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1` を設定します。`/advisor` コマンドは利用できなくなり、設定された `advisorModel` は無視されます。`--advisor` フラグは受け入れられますが、効果はありません。このフラグを渡す既存のスクリプトはエラーなしで動作し続けます。[環境変数](/docs/ja/env-vars)を参照してください。

176 176 

177<h2 id="compare-with-related-features">177<h2 id="compare-with-related-features">

178 関連機能との比較178 関連機能との比較

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

184| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ----------------------------- |184| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ----------------------------- |

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

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

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

188| [`/model`](/ja/model-config#setting-your-model) | 後続のすべてのターン | モデルを切り替えます |188| [`/model`](/docs/ja/model-config#setting-your-model) | 後続のすべてのターン | モデルを切り替えます |

189 189 

190<h2 id="see-also">190<h2 id="see-also">

191 関連項目191 関連項目

192</h2>192</h2>

193 193 

194* [モデル構成](/ja/model-config)：モデルを切り替え、努力レベルを設定し、`opusplan` を使用します194* [モデル構成](/docs/ja/model-config)：モデルを切り替え、努力レベルを設定し、`opusplan` を使用します

195* [コストを効果的に管理する](/ja/costs)：モデル全体のトークン使用量を追跡します195* [コストを効果的に管理する](/docs/ja/costs)：モデル全体のトークン使用量を追跡します

196* [Claude API の Advisor ツール](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool)：基盤となるサーバーツールを理解するか、Messages API から直接使用します196* [Claude API の Advisor ツール](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool)：基盤となるサーバーツールを理解するか、Messages API から直接使用します

197* [advisor 戦略](https://claude.com/blog/the-advisor-strategy)：高速メインモデルをより強力な advisor と組み合わせる理由197* [advisor 戦略](https://claude.com/blog/the-advisor-strategy)：高速メインモデルをより強力な advisor と組み合わせる理由

26 </Step>26 </Step>

27 27 

28 <Step title="SDK が登録されたフックを収集する">28 <Step title="SDK が登録されたフックを収集する">

29 SDK は、そのイベントタイプに登録されたフックをチェックします。これには、`options.hooks` に渡すコールバックフックと、対応する [`settingSources`](/ja/agent-sdk/typescript#settingsource) または [`setting_sources`](/ja/agent-sdk/python#settingsource) エントリが有効になっているときの設定ファイルからのシェルコマンドフックが含まれます。これはデフォルトの `query()` オプションで有効になっています。29 SDK は、そのイベントタイプに登録されたフックをチェックします。これには、`options.hooks` に渡すコールバックフックと、対応する [`settingSources`](/docs/ja/agent-sdk/typescript#settingsource) または [`setting_sources`](/docs/ja/agent-sdk/python#settingsource) エントリが有効になっているときの設定ファイルからのシェルコマンドフックが含まれます。これはデフォルトの `query()` オプションで有効になっています。

30 </Step>30 </Step>

31 31 

32 <Step title="マッチャーがどのフックを実行するかをフィルタリングする">32 <Step title="マッチャーがどのフックを実行するかをフィルタリングする">

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

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

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

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

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

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

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

213 マッチャー213 マッチャー

214</h3>214</h3>

215 215 

216マッチャーを使用して、コールバックがいつ発火するかをフィルタリングします。`matcher` フィールドは、フックイベントタイプに応じて異なる値に対してマッチングされます。たとえば、ツールベースのフックはツール名に対してマッチングされ、`Notification` フックは通知タイプに対してマッチングされます。各イベントタイプのマッチャー値の完全なリストについては、[Claude Code フックリファレンス](/ja/hooks#matcher-patterns)を参照してください。216マッチャーを使用して、コールバックがいつ発火するかをフィルタリングします。`matcher` フィールドは、フックイベントタイプに応じて異なる値に対してマッチングされます。たとえば、ツールベースのフックはツール名に対してマッチングされ、`Notification` フックは通知タイプに対してマッチングされます。各イベントタイプのマッチャー値の完全なリストについては、[Claude Code フックリファレンス](/docs/ja/hooks#matcher-patterns)を参照してください。

217 217 

218SDK マッチャーは[設定ファイルのマッチャー](/ja/hooks#matcher-patterns)と同じルールに従います。文字、数字、`_`、`-`、スペース、`,`、および `|` のみを含むマッチャーは正確な文字列として比較され、`|` または `,` で区切られた代替案とオプションの周囲の空白があるため、`Write|Edit` と `Write, Edit` はそれぞれこれら 2 つのツールと正確にマッチし、`code-reviewer` はそのエージェント型のみにマッチします。`*` のマッチャー、空の文字列、またはマッチャーを完全に省略すると、イベントのすべての発生にマッチします。218SDK マッチャーは[設定ファイルのマッチャー](/docs/ja/hooks#matcher-patterns)と同じルールに従います。文字、数字、`_`、`-`、スペース、`,`、および `|` のみを含むマッチャーは正確な文字列として比較され、`|` または `,` で区切られた代替案とオプションの周囲の空白があるため、`Write|Edit` と `Write, Edit` はそれぞれこれら 2 つのツールと正確にマッチし、`code-reviewer` はそのエージェント型のみにマッチします。`*` のマッチャー、空の文字列、またはマッチャーを完全に省略すると、イベントのすべての発生にマッチします。

219 219 

220他の文字を含むマッチャーはアンカーなしの正規表現として評価されるため、`^mcp__` はすべての MCP ツールにマッチし、`Edit.*` は `Edit` と `NotebookEdit` の両方にマッチします。全文字列マッチが必要な場合は、正規表現を `^` と `$` でラップします。220他の文字を含むマッチャーはアンカーなしの正規表現として評価されるため、`^mcp__` はすべての MCP ツールにマッチし、`Edit.*` は `Edit` と `NotebookEdit` の両方にマッチします。全文字列マッチが必要な場合は、正規表現を `^` と `$` でラップします。

221 221 

225 225 

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

227| --------- | ---------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |227| --------- | ---------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

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

230| `timeout` | `number` | `60` | タイムアウト（秒単位） |230| `timeout` | `number` | `60` | タイムアウト（秒単位） |

231 231 

234ツールベースのフックの場合、マッチャーはツール名でのみフィルタリングされ、ファイルパスやその他の引数ではフィルタリングされません。ファイルパスでフィルタリングするには、コールバック内で `tool_input.file_path` をチェックします。234ツールベースのフックの場合、マッチャーはツール名でのみフィルタリングされ、ファイルパスやその他の引数ではフィルタリングされません。ファイルパスでフィルタリングするには、コールバック内で `tool_input.file_path` をチェックします。

235 235 

236<Tip>236<Tip>

237 **ツール名の発見：** 組み込みツール名の完全なリストについては[ツール入力型](/ja/agent-sdk/typescript#tool-input-types)を参照するか、マッチャーなしでフックを追加して、セッションが行うすべてのツール呼び出しをログします。237 **ツール名の発見：** 組み込みツール名の完全なリストについては[ツール入力型](/docs/ja/agent-sdk/typescript#tool-input-types)を参照するか、マッチャーなしでフックを追加して、セッションが行うすべてのツール呼び出しをログします。

238 238 

239 **MCP ツール命名：** MCP ツールは常に `mcp__` で始まり、その後にサーバー名とアクション `mcp__<server>__<action>` が続きます。たとえば、`playwright` という名前のサーバーを設定した場合、そのツールは `mcp__playwright__browser_screenshot`、`mcp__playwright__browser_click` などという名前になります。サーバー名は `mcpServers` 設定で使用するキーから取得されます。239 **MCP ツール命名：** MCP ツールは常に `mcp__` で始まり、その後にサーバー名とアクション `mcp__<server>__<action>` が続きます。たとえば、`playwright` という名前のサーバーを設定した場合、そのツールは `mcp__playwright__browser_screenshot`、`mcp__playwright__browser_click` などという名前になります。サーバー名は `mcpServers` 設定で使用するキーから取得されます。

240</Tip>240</Tip>

249 249 

250すべてのフックコールバックは 3 つの引数を受け取ります。250すべてのフックコールバックは 3 つの引数を受け取ります。

251 251 

252* **入力データ：** イベント詳細を含む型付きオブジェクト。各フック型には独自の入力形状があります。たとえば、`PreToolUseHookInput` には `tool_name` と `tool_input` が含まれ、`NotificationHookInput` には `message` が含まれます。[TypeScript](/ja/agent-sdk/typescript#hookinput) および [Python](/ja/agent-sdk/python#hookinput) SDK リファレンスで完全な型定義を参照してください。252* **入力データ：** イベント詳細を含む型付きオブジェクト。各フック型には独自の入力形状があります。たとえば、`PreToolUseHookInput` には `tool_name` と `tool_input` が含まれ、`NotificationHookInput` には `message` が含まれます。[TypeScript](/docs/ja/agent-sdk/typescript#hookinput) および [Python](/docs/ja/agent-sdk/python#hookinput) SDK リファレンスで完全な型定義を参照してください。

253 * すべてのフック入力は `session_id`、`cwd`、および `hook_event_name` を共有します。253 * すべてのフック入力は `session_id`、`cwd`、および `hook_event_name` を共有します。

254 * `agent_id` と `agent_type` は、フックがサブエージェント内で発火するときに入力されます。TypeScript では、これらはベースフック入力にあり、すべてのフック型で利用可能です。Python では、これらは `PreToolUse`、`PostToolUse`、`PostToolUseFailure`、および `PermissionRequest` のオプションフィールドであり、`SubagentStart` および `SubagentStop` の必須フィールドです。254 * `agent_id` と `agent_type` は、フックがサブエージェント内で発火するときに入力されます。TypeScript では、これらはベースフック入力にあり、すべてのフック型で利用可能です。Python では、これらは `PreToolUse`、`PostToolUse`、`PostToolUseFailure`、および `PermissionRequest` のオプションフィールドであり、`SubagentStart` および `SubagentStop` の必須フィールドです。

255* **ツール使用 ID**（`str | None` / `string | undefined`）：同じツール呼び出しの `PreToolUse` と `PostToolUse` イベントを相関させます。255* **ツール使用 ID**（`str | None` / `string | undefined`）：同じツール呼び出しの `PreToolUse` と `PostToolUse` イベントを相関させます。

262コールバックは 2 つのカテゴリのフィールドを持つオブジェクトを返します。262コールバックは 2 つのカテゴリのフィールドを持つオブジェクトを返します。

263 263 

264* **トップレベルフィールド**はすべてのイベントで同じように機能します。`systemMessage` はユーザーにメッセージを表示し、`continue`（Python では `continue_`）はこのフック後にエージェントが実行を続けるかどうかを決定します。264* **トップレベルフィールド**はすべてのイベントで同じように機能します。`systemMessage` はユーザーにメッセージを表示し、`continue`（Python では `continue_`）はこのフック後にエージェントが実行を続けるかどうかを決定します。

265* **`hookSpecificOutput`** は現在の操作を制御します。内部のフィールドはフックイベントタイプに依存します。`PreToolUse` フックの場合、ここで `permissionDecision`（`"allow"`、`"deny"`、`"ask"`、または `"defer"`）、`permissionDecisionReason`、および `updatedInput` を設定します。`"defer"` を返すとクエリが終了し、[後で再開](/ja/hooks#defer-a-tool-call-for-later)できます。`PostToolUse` フックの場合、`additionalContext` を設定してツール結果に情報を追加できます。Claude がそれを見る前にツールの出力を置き換えるには、`updatedToolOutput` を設定します。これは両方の SDK のすべてのツールで機能します。古い `updatedMCPToolOutput` フィールドは MCP ツール出力のみを置き換え、非推奨です。265* **`hookSpecificOutput`** は現在の操作を制御します。内部のフィールドはフックイベントタイプに依存します。`PreToolUse` フックの場合、ここで `permissionDecision`（`"allow"`、`"deny"`、`"ask"`、または `"defer"`）、`permissionDecisionReason`、および `updatedInput` を設定します。`"defer"` を返すとクエリが終了し、[後で再開](/docs/ja/hooks#defer-a-tool-call-for-later)できます。`PostToolUse` フックの場合、`additionalContext` を設定してツール結果に情報を追加できます。Claude がそれを見る前にツールの出力を置き換えるには、`updatedToolOutput` を設定します。これは両方の SDK のすべてのツールで機能します。古い `updatedMCPToolOutput` フィールドは MCP ツール出力のみを置き換え、非推奨です。

266 266 

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

268 268 

269<Note>269<Note>

270 複数のフックまたはパーミッションルールが適用される場合、`deny` は `defer` より優先され、`defer` は `ask` より優先され、`ask` は `allow` より優先されます。いずれかのフックが `deny` を返す場合、他のフックに関係なく操作はブロックされます。270 複数のフックまたはパーミッションルールが適用される場合、`deny` は `defer` より優先され、`defer` は `ask` より優先され、`ask` は `allow` より優先されます。いずれかのフックが `deny` を返す場合、他のフックに関係なく操作はブロックされます。

539 サブエージェントアクティビティを追跡する539 サブエージェントアクティビティを追跡する

540</h3>540</h3>

541 541 

542`SubagentStop` フックを使用して、サブエージェントが作業を完了するときを監視します。[TypeScript](/ja/agent-sdk/typescript#hookinput) および [Python](/ja/agent-sdk/python#hookinput) SDK リファレンスで完全な入力型を参照してください。この例は、サブエージェントが完了するたびに概要をログします。542`SubagentStop` フックを使用して、サブエージェントが作業を完了するときを監視します。[TypeScript](/docs/ja/agent-sdk/typescript#hookinput) および [Python](/docs/ja/agent-sdk/python#hookinput) SDK リファレンスで完全な入力型を参照してください。この例は、サブエージェントが完了するたびに概要をログします。

543 543 

544<CodeGroup>544<CodeGroup>

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

791* フックイベント名が正しく、大文字と小文字が区別されていることを確認します（`preToolUse` ではなく `PreToolUse`）791* フックイベント名が正しく、大文字と小文字が区別されていることを確認します（`preToolUse` ではなく `PreToolUse`）

792* マッチャーパターンがツール名と正確にマッチしていることを確認します792* マッチャーパターンがツール名と正確にマッチしていることを確認します

793* フックが `options.hooks` の正しいイベントタイプの下にあることを確認します793* フックが `options.hooks` の正しいイベントタイプの下にあることを確認します

794* `Notification` や `SubagentStop` などの非ツールフックでマッチャーをサポートする場合、マッチャーは異なるフィールドに対してマッチングされ、`Stop` はマッチャーを完全に無視します（[マッチャーパターン](/ja/hooks#matcher-patterns)を参照）794* `Notification` や `SubagentStop` などの非ツールフックでマッチャーをサポートする場合、マッチャーは異なるフィールドに対してマッチングされ、`Stop` はマッチャーを完全に無視します（[マッチャーパターン](/docs/ja/hooks#matcher-patterns)を参照）

795* エージェントが [`max_turns`](/ja/agent-sdk/python#claudeagentoptions) 制限に達するとセッションが終了する前にフックが実行される可能性があるため、フックが発火しない場合があります795* エージェントが [`max_turns`](/docs/ja/agent-sdk/python#claudeagentoptions) 制限に達するとセッションが終了する前にフックが実行される可能性があるため、フックが発火しない場合があります

796 796 

797<h3 id="matcher-not-filtering-as-expected">797<h3 id="matcher-not-filtering-as-expected">

798 マッチャーが期待どおりにフィルタリングしない798 マッチャーが期待どおりにフィルタリングしない

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

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

820 820 

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

822 822 

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

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

852 Python でセッションフックが利用できない852 Python でセッションフックが利用できない

853</h3>853</h3>

854 854 

855`SessionStart` と `SessionEnd` は TypeScript で SDK コールバックフックとして登録できますが、Python SDK では利用できません（`HookEvent` は除外されています）。Python では、設定ファイルで定義された[シェルコマンドフック](/ja/hooks#hook-events)としてのみ利用可能です（たとえば、`.claude/settings.json`）。SDK アプリケーションからシェルコマンドフックをロードするには、[`setting_sources`](/ja/agent-sdk/python#settingsource) または [`settingSources`](/ja/agent-sdk/typescript#settingsource) で適切な設定ソースを含めます：855`SessionStart` と `SessionEnd` は TypeScript で SDK コールバックフックとして登録できますが、Python SDK では利用できません（`HookEvent` は除外されています）。Python では、設定ファイルで定義された[シェルコマンドフック](/docs/ja/hooks#hook-events)としてのみ利用可能です（たとえば、`.claude/settings.json`）。SDK アプリケーションからシェルコマンドフックをロードするには、[`setting_sources`](/docs/ja/agent-sdk/python#settingsource) または [`settingSources`](/docs/ja/agent-sdk/typescript#settingsource) で適切な設定ソースを含めます：

856 856 

857<CodeGroup>857<CodeGroup>

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

890 systemMessage が出力に表示されない890 systemMessage が出力に表示されない

891</h3>891</h3>

892 892 

893`systemMessage` フィールドはユーザーにメッセージを表示します。デフォルトでは SDK はメッセージストリームにフック出力を表示しないため、`includeHookEvents`（Python では `include_hook_events`）を設定しない限り、メッセージが表示されない場合があります。代わりにモデルにコンテキストを渡すには、[`additionalContext`](/ja/hooks#add-context-for-claude)を返します。893`systemMessage` フィールドはユーザーにメッセージを表示します。デフォルトでは SDK はメッセージストリームにフック出力を表示しないため、`includeHookEvents`（Python では `include_hook_events`）を設定しない限り、メッセージが表示されない場合があります。代わりにモデルにコンテキストを渡すには、[`additionalContext`](/docs/ja/hooks#add-context-for-claude)を返します。

894 894 

895フック決定をアプリケーションに確実に表示する必要がある場合は、別途ログするか、専用の出力チャネルを使用します。895フック決定をアプリケーションに確実に表示する必要がある場合は、別途ログするか、専用の出力チャネルを使用します。

896 896 

898 関連リソース898 関連リソース

899</h2>899</h2>

900 900 

901* [Claude Code フックリファレンス](/ja/hooks)：完全な JSON 入力/出力スキーマ、イベント文書、およびマッチャーパターン901* [Claude Code フックリファレンス](/docs/ja/hooks)：完全な JSON 入力/出力スキーマ、イベント文書、およびマッチャーパターン

902* [Claude Code フックガイド](/ja/hooks-guide)：シェルコマンドフックの例とウォークスルー902* [Claude Code フックガイド](/docs/ja/hooks-guide)：シェルコマンドフックの例とウォークスルー

903* [TypeScript SDK リファレンス](/ja/agent-sdk/typescript)：フック型、入力/出力定義、および設定オプション903* [TypeScript SDK リファレンス](/docs/ja/agent-sdk/typescript)：フック型、入力/出力定義、および設定オプション

904* [Python SDK リファレンス](/ja/agent-sdk/python)：フック型、入力/出力定義、および設定オプション904* [Python SDK リファレンス](/docs/ja/agent-sdk/python)：フック型、入力/出力定義、および設定オプション

905* [パーミッション](/ja/agent-sdk/permissions)：エージェントが何をできるかを制御します905* [パーミッション](/docs/ja/agent-sdk/permissions)：エージェントが何をできるかを制御します

906* [カスタムツール](/ja/agent-sdk/custom-tools)：エージェント機能を拡張するツールを構築します906* [カスタムツール](/docs/ja/agent-sdk/custom-tools)：エージェント機能を拡張するツールを構築します

6 6 

7> パーミッションモード、フック、宣言的な許可/拒否ルールを使用して、エージェントがツールをどのように使用するかを制御します。7> パーミッションモード、フック、宣言的な許可/拒否ルールを使用して、エージェントがツールをどのように使用するかを制御します。

8 8 

9Claude Agent SDK は、Claude がツールをどのように使用するかを管理するためのパーミッション制御を提供します。パーミッションモードとルールを使用して、自動的に許可されるものを定義し、[`canUseTool` コールバック](/ja/agent-sdk/user-input)を使用して、実行時にそれ以外のすべてを処理します。9Claude Agent SDK は、Claude がツールをどのように使用するかを管理するためのパーミッション制御を提供します。パーミッションモードとルールを使用して、自動的に許可されるものを定義し、[`canUseTool` コールバック](/docs/ja/agent-sdk/user-input)を使用して、実行時にそれ以外のすべてを処理します。

10 10 

11<Note>11<Note>

12 このページはパーミッションモードとルールについて説明しています。ユーザーが実行時にツールリクエストを承認または拒否する対話的な承認フローを構築するには、[承認とユーザー入力の処理](/ja/agent-sdk/user-input)を参照してください。12 このページはパーミッションモードとルールについて説明しています。ユーザーが実行時にツールリクエストを承認または拒否する対話的な承認フローを構築するには、[承認とユーザー入力の処理](/docs/ja/agent-sdk/user-input)を参照してください。

13</Note>13</Note>

14 14 

15<h2 id="how-permissions-are-evaluated">15<h2 id="how-permissions-are-evaluated">

20 20 

21<Steps>21<Steps>

22 <Step title="フック">22 <Step title="フック">

23 最初に[フック](/ja/agent-sdk/hooks)を実行します。フックはコールを直接拒否するか、それを渡すことができます。`allow` を返すフックは、以下の拒否および質問ルールをスキップしません。これらはフックの結果に関係なく評価されます。23 最初に[フック](/docs/ja/agent-sdk/hooks)を実行します。フックはコールを直接拒否するか、それを渡すことができます。`allow` を返すフックは、以下の拒否および質問ルールをスキップしません。これらはフックの結果に関係なく評価されます。

24 </Step>24 </Step>

25 25 

26 <Step title="拒否ルール">26 <Step title="拒否ルール">

27 `deny` ルール（`disallowed_tools` および[settings.json](/ja/settings#permission-settings)から）をチェックします。拒否ルールが一致する場合、`bypassPermissions` モードでもツールはブロックされます。`Bash` のような裸名の拒否ルールはこの評価が開始される前に Claude のコンテキストからツールを削除するため、このステップでチェックされるのは `Bash(rm *)` のようなスコープ付きルールのみです。27 `deny` ルール（`disallowed_tools` および[settings.json](/docs/ja/settings#permission-settings)から）をチェックします。拒否ルールが一致する場合、`bypassPermissions` モードでもツールはブロックされます。`Bash` のような裸名の拒否ルールはこの評価が開始される前に Claude のコンテキストからツールを削除するため、このステップでチェックされるのは `Bash(rm *)` のようなスコープ付きルールのみです。

28 </Step>28 </Step>

29 29 

30 <Step title="質問ルール">30 <Step title="質問ルール">

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

32 32 

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

34 34 

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

36 </Step>36 </Step>

37 37 

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

39 アクティブな[権限モード](#permission-modes)を適用します。`bypassPermissions` はこのステップに到達したすべてを承認します。`acceptEdits` はファイル操作を承認します。`plan` はファイル編集およびシェル書き込みツールを許可ルールに関係なく [`canUseTool` コールバック](/ja/agent-sdk/user-input)にルーティングするため、計画中は書き込み操作を自動承認することはできません。その他のモードはフォールスルーします。39 アクティブな[権限モード](#permission-modes)を適用します。`bypassPermissions` はこのステップに到達したすべてを承認します。`acceptEdits` はファイル操作を承認します。`plan` はファイル編集およびシェル書き込みツールを許可ルールに関係なく [`canUseTool` コールバック](/docs/ja/agent-sdk/user-input)にルーティングするため、計画中は書き込み操作を自動承認することはできません。その他のモードはフォールスルーします。

40 </Step>40 </Step>

41 41 

42 <Step title="許可ルール">42 <Step title="許可ルール">

44 </Step>44 </Step>

45 45 

46 <Step title="canUseTool コールバック">46 <Step title="canUseTool コールバック">

47 上記のいずれでも解決されない場合、決定のために[`canUseTool` コールバック](/ja/agent-sdk/user-input)を呼び出します。`dontAsk` モードでは、このステップはスキップされ、ツールは拒否されます。47 上記のいずれでも解決されない場合、決定のために[`canUseTool` コールバック](/docs/ja/agent-sdk/user-input)を呼び出します。`dontAsk` モードでは、このステップはスキップされ、ツールは拒否されます。

48 </Step>48 </Step>

49</Steps>49</Steps>

50 50 

57 57 

58`Bash(ls *)` などの指定子を持つエントリと `acceptEdits` モードはこれをトリガーしません。また、設定ファイルから来る許可ルールはチェックに表示されません。58`Bash(ls *)` などの指定子を持つエントリと `acceptEdits` モードはこれをトリガーしません。また、設定ファイルから来る許可ルールはチェックに表示されません。

59 59 

60`process.on('warning', ...)` でリッスンしてコードをマッチングしてログに記録するか、それを抑制します。モードとルールに関係なくすべてのツールコールをゲートするには、代わりに[`PreToolUse` フック](/ja/agent-sdk/hooks)を使用します。60`process.on('warning', ...)` でリッスンしてコードをマッチングしてログに記録するか、それを抑制します。モードとルールに関係なくすべてのツールコールをゲートするには、代わりに[`PreToolUse` フック](/docs/ja/agent-sdk/hooks)を使用します。

61 61 

62このページは**許可および拒否ルール**と**パーミッションモード**に焦点を当てています。その他のステップについては、以下を参照してください。62このページは**許可および拒否ルール**と**パーミッションモード**に焦点を当てています。その他のステップについては、以下を参照してください。

63 63 

64* **フック：** カスタムコードを実行して、ツールリクエストを許可、拒否、または変更します。[フックで実行を制御](/ja/agent-sdk/hooks)を参照してください。64* **フック：** カスタムコードを実行して、ツールリクエストを許可、拒否、または変更します。[フックで実行を制御](/docs/ja/agent-sdk/hooks)を参照してください。

65* **canUseTool コールバック：** 実行時にユーザーに承認を促します。[承認とユーザー入力の処理](/ja/agent-sdk/user-input)を参照してください。65* **canUseTool コールバック：** 実行時にユーザーに承認を促します。[承認とユーザー入力の処理](/docs/ja/agent-sdk/user-input)を参照してください。

66 66 

67<h2 id="allow-and-deny-rules">67<h2 id="allow-and-deny-rules">

68 許可および拒否ルール68 許可および拒否ルール

81 81 

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

83 83 

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

85 85 

86<Warning>86<Warning>

87 **自動承認されたツールは `canUseTool` に到達しません。** 任意の前のステップで承認されたツール呼び出し（`acceptEdits` または `bypassPermissions` による、または許可ルールによる）は、`canUseTool` コールバックをスキップするため、そこに配置した権限チェックはそのツールに対して静かにバイパスされます。`AskUserQuestion`、MCP ツール（[`_meta["anthropic/requiresUserInteraction"]`](/ja/mcp#require-approval-for-a-specific-tool) でマークされたもの）、およびコネクタツール（[組織が `ask` に設定したもの](/ja/mcp#organization-controls-on-connector-tools)）は、許可ルールが一致する場合でもコールバックに到達します。87 **自動承認されたツールは `canUseTool` に到達しません。** 任意の前のステップで承認されたツール呼び出し（`acceptEdits` または `bypassPermissions` による、または許可ルールによる）は、`canUseTool` コールバックをスキップするため、そこに配置した権限チェックはそのツールに対して静かにバイパスされます。`AskUserQuestion`、MCP ツール（[`_meta["anthropic/requiresUserInteraction"]`](/docs/ja/mcp#require-approval-for-a-specific-tool) でマークされたもの）、およびコネクタツール（[組織が `ask` に設定したもの](/docs/ja/mcp#organization-controls-on-connector-tools)）は、許可ルールが一致する場合でもコールバックに到達します。

88 88 

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

90</Warning>90</Warning>

91 91 

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

102 **`allowed_tools` は `bypassPermissions` を制限しません。** `allowed_tools` はリストしたツールのみを事前承認します。リストされていないツールは許可ルールと一致せず、パーミッションモードにフォールスルーします。ここで `bypassPermissions` はそれらを承認します。`allowed_tools=["Read"]` を `permission_mode="bypassPermissions"` と一緒に設定すると、`Bash`、`Write`、`Edit` を含むすべてのツールが承認されます。`bypassPermissions` が必要だが特定のツールをブロックしたい場合は、`disallowed_tools` を使用してください。102 **`allowed_tools` は `bypassPermissions` を制限しません。** `allowed_tools` はリストしたツールのみを事前承認します。リストされていないツールは許可ルールと一致せず、パーミッションモードにフォールスルーします。ここで `bypassPermissions` はそれらを承認します。`allowed_tools=["Read"]` を `permission_mode="bypassPermissions"` と一緒に設定すると、`Bash`、`Write`、`Edit` を含むすべてのツールが承認されます。`bypassPermissions` が必要だが特定のツールをブロックしたい場合は、`disallowed_tools` を使用してください。

103</Warning>103</Warning>

104 104 

105`.claude/settings.json` で許可、拒否、および質問ルールを宣言的に設定することもできます。これらのルールは、`project` 設定ソースが有効な場合に読み込まれます。デフォルトの `query()` オプションではこれが有効です。`setting_sources`（TypeScript：`settingSources`）を明示的に設定する場合は、それらを適用するために `"project"` を含めてください。ルール構文については、[パーミッション設定](/ja/settings#permission-settings)を参照してください。105`.claude/settings.json` で許可、拒否、および質問ルールを宣言的に設定することもできます。これらのルールは、`project` 設定ソースが有効な場合に読み込まれます。デフォルトの `query()` オプションではこれが有効です。`setting_sources`（TypeScript：`settingSources`）を明示的に設定する場合は、それらを適用するために `"project"` を含めてください。ルール構文については、[パーミッション設定](/docs/ja/settings#permission-settings)を参照してください。

106 106 

107<h2 id="permission-modes">107<h2 id="permission-modes">

108 パーミッションモード108 パーミッションモード

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

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

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

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

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

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

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

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

127 127 

128<Warning>128<Warning>

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

130</Warning>130</Warning>

131 131 

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

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

261</h4>261</h4>

262 262 

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

264 264 

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

266 266 

273<Warning>273<Warning>

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

275 275 

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

277</Warning>277</Warning>

278 278 

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

280 計画モード（`plan`）280 計画モード（`plan`）

281</h4>281</h4>

282 282 

283Claude はコードベースを探索および計画を作成し、ソースファイルを編集しません。読み取り専用ツールはデフォルトモードと同じように実行されます。ファイル編集は計画モードで自動承認されることはなく、許可ルールが一致する場合でも、代わりに `canUseTool` コールバックを通じてプロンプトが表示されます。Claude は計画を最終化する前に要件を明確にするために `AskUserQuestion` を使用する場合があります。これらのプロンプトの処理については、[承認とユーザー入力の処理](/ja/agent-sdk/user-input#handle-clarifying-questions)を参照してください。283Claude はコードベースを探索および計画を作成し、ソースファイルを編集しません。読み取り専用ツールはデフォルトモードと同じように実行されます。ファイル編集は計画モードで自動承認されることはなく、許可ルールが一致する場合でも、代わりに `canUseTool` コールバックを通じてプロンプトが表示されます。Claude は計画を最終化する前に要件を明確にするために `AskUserQuestion` を使用する場合があります。これらのプロンプトの処理については、[承認とユーザー入力の処理](/docs/ja/agent-sdk/user-input#handle-clarifying-questions)を参照してください。

284 284 

285**使用時期：** Claude に変更を提案させたいが実行させたくない場合、たとえばコードレビュー中または変更を実行する前に承認が必要な場合。285**使用時期：** Claude に変更を提案させたいが実行させたくない場合、たとえばコードレビュー中または変更を実行する前に承認が必要な場合。

286 286 

290 290 

291パーミッション評価フロー内の他のステップについては、以下を参照してください。291パーミッション評価フロー内の他のステップについては、以下を参照してください。

292 292 

293* [承認とユーザー入力の処理](/ja/agent-sdk/user-input)：対話的な承認プロンプトと明確化の質問293* [承認とユーザー入力の処理](/docs/ja/agent-sdk/user-input)：対話的な承認プロンプトと明確化の質問

294* [フックガイド](/ja/agent-sdk/hooks)：エージェントライフサイクルの主要なポイントでカスタムコードを実行294* [フックガイド](/docs/ja/agent-sdk/hooks)：エージェントライフサイクルの主要なポイントでカスタムコードを実行

295* [パーミッションルール](/ja/settings#permission-settings)：`settings.json` の宣言的な許可/拒否ルール295* [パーミッションルール](/docs/ja/settings#permission-settings)：`settings.json` の宣言的な許可/拒否ルール

18pip install claude-agent-sdk18pip install claude-agent-sdk

19```19```

20 20 

21uv、Windows PowerShell、API キーのセットアップについては、[Agent SDK 概要の「Get started」セクション](/ja/agent-sdk/overview#get-started)を参照してください。21uv、Windows PowerShell、API キーのセットアップについては、[Agent SDK 概要の「Get started」セクション](/docs/ja/agent-sdk/overview#get-started)を参照してください。

22 22 

23<h2 id="choosing-between-query-and-claudesdkclient">23<h2 id="choosing-between-query-and-claudesdkclient">

24 `query()` と `ClaudeSDKClient` の選択24 `query()` と `ClaudeSDKClient` の選択

73 `query()`73 `query()`

74</h3>74</h3>

75 75 

76Claude Code との各インタラクションのために新しいセッションを作成します。デフォルトでは、メッセージが到着するにつれて生成される非同期イテレータを返します。`query()` への各呼び出しは、`continue_conversation=True` または [`ClaudeAgentOptions`](#claudeagentoptions) の `resume` を渡さない限り、前のインタラクションのメモリなしで新しく開始します。[セッション](/ja/agent-sdk/sessions) を参照してください。76Claude Code との各インタラクションのために新しいセッションを作成します。デフォルトでは、メッセージが到着するにつれて生成される非同期イテレータを返します。`query()` への各呼び出しは、`continue_conversation=True` または [`ClaudeAgentOptions`](#claudeagentoptions) の `resume` を渡さない限り、前のインタラクションのメモリなしで新しく開始します。[セッション](/docs/ja/agent-sdk/sessions) を参照してください。

77 77 

78```python theme={null}78```python theme={null}

79async def query(79async def query(

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

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

567| `set_model(model)` | 現在のセッションのモデルを変更します。デフォルトにリセットするには `None` を渡します |567| `set_model(model)` | 現在のセッションのモデルを変更します。デフォルトにリセットするには `None` を渡します |

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

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

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

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

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

908| :---------------------------- | :------------------------------------------------------------------------------------ | :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |908| :---------------------------- | :------------------------------------------------------------------------------------ | :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

910| `allowed_tools` | `list[str]` | `[]` | プロンプトなしで自動承認するツール。これは Claude をこれらのツールのみに制限しません。リストされていないツールは `permission_mode` と `can_use_tool` にフォールスルーします。`disallowed_tools` を使用してツールをブロックします。[パーミッション](/ja/agent-sdk/permissions#allow-and-deny-rules) を参照 |910| `allowed_tools` | `list[str]` | `[]` | プロンプトなしで自動承認するツール。これは Claude をこれらのツールのみに制限しません。リストされていないツールは `permission_mode` と `can_use_tool` にフォールスルーします。`disallowed_tools` を使用してツールをブロックします。[パーミッション](/docs/ja/agent-sdk/permissions#allow-and-deny-rules) を参照 |

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

912| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | MCP サーバー設定または設定ファイルへのパス |912| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | MCP サーバー設定または設定ファイルへのパス |

913| `strict_mcp_config` | `bool` | `False` | `True` の場合、`mcp_servers` で渡されたサーバーのみを使用し、プロジェクト `.mcp.json`、ユーザー設定、プラグイン提供の MCP サーバー、および [claude.ai コネクタ](/ja/mcp#use-mcp-servers-from-claude-ai) を無視します。CLI `--strict-mcp-config` フラグにマップされます |913| `strict_mcp_config` | `bool` | `False` | `True` の場合、`mcp_servers` で渡されたサーバーのみを使用し、プロジェクト `.mcp.json`、ユーザー設定、プラグイン提供の MCP サーバー、および [claude.ai コネクタ](/docs/ja/mcp#use-mcp-servers-from-claude-ai) を無視します。CLI `--strict-mcp-config` フラグにマップされます |

914| `permission_mode` | `PermissionMode \| None` | `None` | ツール使用のパーミッションモード |914| `permission_mode` | `PermissionMode \| None` | `None` | ツール使用のパーミッションモード |

915| `continue_conversation` | `bool` | `False` | 最新の会話を続ける |915| `continue_conversation` | `bool` | `False` | 最新の会話を続ける |

916| `resume` | `str \| None` | `None` | 再開するセッション ID |916| `resume` | `str \| None` | `None` | 再開するセッション ID |

917| `max_turns` | `int \| None` | `None` | 最大 agentic ターン数（ツール使用ラウンドトリップ） |917| `max_turns` | `int \| None` | `None` | 最大 agentic ターン数（ツール使用ラウンドトリップ） |

918| `max_budget_usd` | `float \| None` | `None` | クライアント側のコスト推定がこの USD 値に達したときにクエリを停止します。`total_cost_usd` と同じ推定と比較されます。[コストと使用状況を追跡](/ja/agent-sdk/cost-tracking) で精度の注意事項を参照 |918| `max_budget_usd` | `float \| None` | `None` | クライアント側のコスト推定がこの USD 値に達したときにクエリを停止します。`total_cost_usd` と同じ推定と比較されます。[コストと使用状況を追跡](/docs/ja/agent-sdk/cost-tracking) で精度の注意事項を参照 |

919| `disallowed_tools` | `list[str]` | `[]` | 拒否するツール。`Bash` などの単純な名前はツールを Claude のコンテキストから削除します。`Bash(rm *)` などのスコープ付きルールはツールを利用可能なままにし、`bypassPermissions` を含むすべてのパーミッションモードで一致する呼び出しを拒否します。[パーミッション](/ja/agent-sdk/permissions#allow-and-deny-rules) を参照 |919| `disallowed_tools` | `list[str]` | `[]` | 拒否するツール。`Bash` などの単純な名前はツールを Claude のコンテキストから削除します。`Bash(rm *)` などのスコープ付きルールはツールを利用可能なままにし、`bypassPermissions` を含むすべてのパーミッションモードで一致する呼び出しを拒否します。[パーミッション](/docs/ja/agent-sdk/permissions#allow-and-deny-rules) を参照 |

920| `enable_file_checkpointing` | `bool` | `False` | ファイル変更追跡を有効にして巻き戻しを可能にします。[ファイルチェックポイント](/ja/agent-sdk/file-checkpointing) を参照 |920| `enable_file_checkpointing` | `bool` | `False` | ファイル変更追跡を有効にして巻き戻しを可能にします。[ファイルチェックポイント](/docs/ja/agent-sdk/file-checkpointing) を参照 |

921| `model` | `str \| None` | `None` | Claude モデルエイリアスまたは完全なモデル名。[受け入れられた値とプロバイダー固有の ID](/ja/model-config#available-models) を参照 |921| `model` | `str \| None` | `None` | Claude モデルエイリアスまたは完全なモデル名。[受け入れられた値とプロバイダー固有の ID](/docs/ja/model-config#available-models) を参照 |

922| `fallback_model` | `str \| None` | `None` | プライマリモデルが失敗した場合に使用するフォールバックモデル |922| `fallback_model` | `str \| None` | `None` | プライマリモデルが失敗した場合に使用するフォールバックモデル |

923| `betas` | `list[SdkBeta]` | `[]` | 有効にするベータ機能。利用可能なオプションについては [`SdkBeta`](#sdkbeta) を参照 |923| `betas` | `list[SdkBeta]` | `[]` | 有効にするベータ機能。利用可能なオプションについては [`SdkBeta`](#sdkbeta) を参照 |

924| `output_format` | `dict[str, Any] \| None` | `None` | 構造化応答の出力形式（例：`{"type": "json_schema", "schema": {...}}`）。詳細については [構造化出力](/ja/agent-sdk/structured-outputs) を参照 |924| `output_format` | `dict[str, Any] \| None` | `None` | 構造化応答の出力形式（例：`{"type": "json_schema", "schema": {...}}`）。詳細については [構造化出力](/docs/ja/agent-sdk/structured-outputs) を参照 |

925| `permission_prompt_tool_name` | `str \| None` | `None` | パーミッションプロンプト用の MCP ツール名 |925| `permission_prompt_tool_name` | `str \| None` | `None` | パーミッションプロンプト用の MCP ツール名 |

926| `cwd` | `str \| Path \| None` | `None` | 現在の作業ディレクトリ |926| `cwd` | `str \| Path \| None` | `None` | 現在の作業ディレクトリ |

927| `cli_path` | `str \| Path \| None` | `None` | Claude Code CLI 実行可能ファイルへのカスタムパス |927| `cli_path` | `str \| Path \| None` | `None` | Claude Code CLI 実行可能ファイルへのカスタムパス |

928| `settings` | `str \| None` | `None` | 設定ファイルへのパス |928| `settings` | `str \| None` | `None` | 設定ファイルへのパス |

929| `add_dirs` | `list[str \| Path]` | `[]` | Claude がアクセスできる追加ディレクトリ |929| `add_dirs` | `list[str \| Path]` | `[]` | Claude がアクセスできる追加ディレクトリ |

930| `env` | `dict[str, str]` | `{}` | 継承されたプロセス環境の上にマージされた環境変数。[環境変数](/ja/env-vars) で、基盤となる CLI が読み込む変数を参照し、[遅いまたは停止した API レスポンスを処理](#handle-slow-or-stalled-api-responses) でタイムアウト関連の変数を参照してください |930| `env` | `dict[str, str]` | `{}` | 継承されたプロセス環境の上にマージされた環境変数。[環境変数](/docs/ja/env-vars) で、基盤となる CLI が読み込む変数を参照し、[遅いまたは停止した API レスポンスを処理](#handle-slow-or-stalled-api-responses) でタイムアウト関連の変数を参照してください |

931| `extra_args` | `dict[str, str \| None]` | `{}` | CLI に直接渡す追加 CLI 引数 |931| `extra_args` | `dict[str, str \| None]` | `{}` | CLI に直接渡す追加 CLI 引数 |

932| `max_buffer_size` | `int \| None` | `None` | CLI stdout をバッファリングする場合の最大バイト数 |932| `max_buffer_size` | `int \| None` | `None` | CLI stdout をバッファリングする場合の最大バイト数 |

933| `debug_stderr` | `Any` | `sys.stderr` | *非推奨* - デバッグ出力用のファイルのようなオブジェクト。代わりに `stderr` コールバックを使用してください |933| `debug_stderr` | `Any` | `sys.stderr` | *非推奨* - デバッグ出力用のファイルのようなオブジェクト。代わりに `stderr` コールバックを使用してください |

934| `stderr` | `Callable[[str], None] \| None` | `None` | CLI からの stderr 出力用のコールバック関数 |934| `stderr` | `Callable[[str], None] \| None` | `None` | CLI からの stderr 出力用のコールバック関数 |

935| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | ツールパーミッションコールバック関数。[パーミッション評価フロー](/ja/agent-sdk/permissions#how-permissions-are-evaluated) がプロンプトに解決される場合にのみ呼び出されます。`allowed_tools` エントリ、設定許可ルール、または `permission_mode` によって事前承認されたツール呼び出しは呼び出されません。すべてのツール呼び出しをゲートするには、代わりに [`PreToolUse` hook](/ja/agent-sdk/hooks) を使用してください。[`CanUseTool`](#canusetool) を参照 |935| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | ツールパーミッションコールバック関数。[パーミッション評価フロー](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated) がプロンプトに解決される場合にのみ呼び出されます。`allowed_tools` エントリ、設定許可ルール、または `permission_mode` によって事前承認されたツール呼び出しは呼び出されません。すべてのツール呼び出しをゲートするには、代わりに [`PreToolUse` hook](/docs/ja/agent-sdk/hooks) を使用してください。[`CanUseTool`](#canusetool) を参照 |

936| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | イベントをインターセプトするための hook 設定 |936| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | イベントをインターセプトするための hook 設定 |

937| `user` | `str \| None` | `None` | ユーザー識別子 |937| `user` | `str \| None` | `None` | ユーザー識別子 |

938| `include_partial_messages` | `bool` | `False` | 部分的なメッセージストリーミングイベントを含めます。有効にすると、[`StreamEvent`](#streamevent) メッセージが生成されます |938| `include_partial_messages` | `bool` | `False` | 部分的なメッセージストリーミングイベントを含めます。有効にすると、[`StreamEvent`](#streamevent) メッセージが生成されます |

939| `include_hook_events` | `bool` | `False` | hook ライフサイクルイベントをメッセージストリームに `HookEventMessage` オブジェクトとして含めます |939| `include_hook_events` | `bool` | `False` | hook ライフサイクルイベントをメッセージストリームに `HookEventMessage` オブジェクトとして含めます |

940| `fork_session` | `bool` | `False` | `resume` で再開する場合、元のセッションを続ける代わりに新しいセッション ID にフォークします |940| `fork_session` | `bool` | `False` | `resume` で再開する場合、元のセッションを続ける代わりに新しいセッション ID にフォークします |

941| `agents` | `dict[str, AgentDefinition] \| None` | `None` | プログラムで定義されたサブエージェント |941| `agents` | `dict[str, AgentDefinition] \| None` | `None` | プログラムで定義されたサブエージェント |

942| `plugins` | `list[SdkPluginConfig]` | `[]` | ローカルパスからカスタムプラグインを読み込みます。詳細については [プラグイン](/ja/agent-sdk/plugins) を参照 |942| `plugins` | `list[SdkPluginConfig]` | `[]` | ローカルパスからカスタムプラグインを読み込みます。詳細については [プラグイン](/docs/ja/agent-sdk/plugins) を参照 |

943| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | プログラムでサンドボックス動作を設定します。詳細については [サンドボックス設定](#sandboxsettings) を参照 |943| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | プログラムでサンドボックス動作を設定します。詳細については [サンドボックス設定](#sandboxsettings) を参照 |

944| `setting_sources` | `list[SettingSource] \| None` | `None`（CLI デフォルト：すべてのソース） | 読み込むファイルシステム設定を制御します。`[]` を渡してユーザー、プロジェクト、ローカル設定を無効にします。管理ポリシー設定は常に読み込まれます。[Claude Code 機能を使用](/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control) を参照 |944| `setting_sources` | `list[SettingSource] \| None` | `None`（CLI デフォルト：すべてのソース） | 読み込むファイルシステム設定を制御します。`[]` を渡してユーザー、プロジェクト、ローカル設定を無効にします。管理ポリシー設定は常に読み込まれます。[Claude Code 機能を使用](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control) を参照 |

945| `skills` | `list[str] \| Literal["all"] \| None` | `None` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `"all"` を渡すか、スキル名のリストを渡します。設定すると、SDK は `allowed_tools` にリストしなくても Skill ツールを自動的に有効にします。[スキル](/ja/agent-sdk/skills) を参照 |945| `skills` | `list[str] \| Literal["all"] \| None` | `None` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `"all"` を渡すか、スキル名のリストを渡します。設定すると、SDK は `allowed_tools` にリストしなくても Skill ツールを自動的に有効にします。[スキル](/docs/ja/agent-sdk/skills) を参照 |

946| `max_thinking_tokens` | `int \| None` | `None` | *非推奨* - 思考ブロックの最大トークン数。代わりに `thinking` を使用してください |946| `max_thinking_tokens` | `int \| None` | `None` | *非推奨* - 思考ブロックの最大トークン数。代わりに `thinking` を使用してください |

947| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | 拡張思考動作を制御します。`max_thinking_tokens` より優先されます |947| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | 拡張思考動作を制御します。`max_thinking_tokens` より優先されます |

948| `effort` | [`EffortLevel`](#effortlevel) ` \| None` | `None` | 思考の深さの努力レベル。[努力レベルを調整](/ja/model-config#adjust-effort-level) を参照 |948| `effort` | [`EffortLevel`](#effortlevel) ` \| None` | `None` | 思考の深さの努力レベル。[努力レベルを調整](/docs/ja/model-config#adjust-effort-level) を参照 |

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

950| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | ミラーリングされたトランスクリプトエントリを `session_store` にフラッシュするタイミング。`"batched"` はターンごと、またはバッファが満杯になったときにフラッシュします。`"eager"` はすべてのフレームの後にバックグラウンドフラッシュをトリガーします。`session_store` が `None` の場合は無視されます |950| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | ミラーリングされたトランスクリプトエントリを `session_store` にフラッシュするタイミング。`"batched"` はターンごと、またはバッファが満杯になったときにフラッシュします。`"eager"` はすべてのフレームの後にバックグラウンドフラッシュをトリガーします。`session_store` が `None` の場合は無視されます |

951 951 

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

966```966```

967 967 

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

969* `CLAUDE_CODE_MAX_RETRIES`：最大 API リトライ数。デフォルト `10`、上限 `15`。各リトライは独自の `API_TIMEOUT_MS` ウィンドウを取得するため、最悪の場合の実時間はおおよそ `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` にバックオフを加えたものです。無人実行で長時間の停止を待つ必要がある場合は、`CLAUDE_CODE_RETRY_WATCHDOG=1` を設定します：容量エラーを無限に再試行し、{/* min-version: 2.1.199 */}Claude Code v2.1.199 以降は他の一時的なエラーのデフォルトを `300` に引き上げ、この変数の上限を削除します。969* `CLAUDE_CODE_MAX_RETRIES`：最大 API リトライ数。デフォルト `10`、上限 `15`。各リトライは独自の `API_TIMEOUT_MS` ウィンドウを取得するため、最悪の場合の実時間はおおよそ `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` にバックオフを加えたものです。無人実行で長時間の停止を待つ必要がある場合は、`CLAUDE_CODE_RETRY_WATCHDOG=1` を設定します：容量エラーを無限に再試行し、Claude Code v2.1.199 以降は他の一時的なエラーのデフォルトを `300` に引き上げ、この変数の上限を削除します。

970* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`：`run_in_background` で起動されたサブエージェント用の停止ウォッチドッグ。デフォルト `600000`。各ストリームイベントでリセットされます。停止時にサブエージェントを中止し、タスクを失敗とマークし、部分的な結果を含むエラーを親に表示します。同期サブエージェントには適用されません。970* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`：`run_in_background` で起動されたサブエージェント用の停止ウォッチドッグ。デフォルト `600000`。各ストリームイベントでリセットされます。停止時にサブエージェントを中止し、タスクを失敗とマークし、部分的な結果を含むエラーを親に表示します。同期サブエージェントには適用されません。

971* `CLAUDE_ENABLE_STREAM_WATCHDOG` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`：ヘッダーが到着したがレスポンスボディがストリーミングを停止したときにリクエストを中止します。ウォッチドッグはすべてのプロバイダーでデフォルトで有効です。`CLAUDE_ENABLE_STREAM_WATCHDOG=0` を設定して無効にします。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` はデフォルト `300000` で、その最小値にクランプされます。中止されたリクエストは通常のリトライパスを通ります。971* `CLAUDE_ENABLE_STREAM_WATCHDOG` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`：ヘッダーが到着したがレスポンスボディがストリーミングを停止したときにリクエストを中止します。ウォッチドッグはすべてのプロバイダーでデフォルトで有効です。`CLAUDE_ENABLE_STREAM_WATCHDOG=0` を設定して無効にします。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` はデフォルト `300000` で、その最小値にクランプされます。中止されたリクエストは通常のリトライパスを通ります。

972 972 

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

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

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

1011| `exclude_dynamic_sections` | いいえ | 作業ディレクトリ、git リポジトリフラグ、自動メモリパスなどのセッションごとのコンテキストをシステムプロンプトから最初のユーザーメッセージに移動します。ユーザーとマシン全体でのプロンプトキャッシュの再利用を改善します。[システムプロンプトを変更](/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) を参照 |1011| `exclude_dynamic_sections` | いいえ | 作業ディレクトリ、git リポジトリフラグ、自動メモリパスなどのセッションごとのコンテキストをシステムプロンプトから最初のユーザーメッセージに移動します。ユーザーとマシン全体でのプロンプトキャッシュの再利用を改善します。[システムプロンプトを変更](/docs/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) を参照 |

1012 1012 

1013<h3 id="systempromptfile">1013<h3 id="systempromptfile">

1014 `SystemPromptFile`1014 `SystemPromptFile`

1015</h3>1015</h3>

1016 1016 

1017ファイルからカスタムシステムプロンプトを読み込むための設定。文字列として渡す代わりに、ファイル形式を使用します。SDK はこれを CLI [`--system-prompt-file`](/ja/cli-reference#system-prompt-flags) フラグにマップします。プロンプトが大きい場合はファイル形式を使用します：SDK は文字列 `system_prompt` を CLI サブプロセス argv に渡します。これは OS コマンドライン長制限の対象となり、SDK が API リクエストを送信する前に失敗します。Linux では、単一の引数が約 128 KB より長い場合、`Argument list too long` でプロセス生成に失敗します。Windows では、コマンドライン全体が約 32 KB に制限されているため、文字列形式はより低いしきい値で失敗します。1017ファイルからカスタムシステムプロンプトを読み込むための設定。文字列として渡す代わりに、ファイル形式を使用します。SDK はこれを CLI [`--system-prompt-file`](/docs/ja/cli-reference#system-prompt-flags) フラグにマップします。プロンプトが大きい場合はファイル形式を使用します：SDK は文字列 `system_prompt` を CLI サブプロセス argv に渡します。これは OS コマンドライン長制限の対象となり、SDK が API リクエストを送信する前に失敗します。Linux では、単一の引数が約 128 KB より長い場合、`Argument list too long` でプロセス生成に失敗します。Windows では、コマンドライン全体が約 32 KB に制限されているため、文字列形式はより低いしきい値で失敗します。

1018 1018 

1019```python theme={null}1019```python theme={null}

1020class SystemPromptFile(TypedDict):1020class SystemPromptFile(TypedDict):

1047 デフォルト動作1047 デフォルト動作

1048</h4>1048</h4>

1049 1049 

1050`setting_sources` が省略されるか `None` の場合、`query()` は Claude Code CLI と同じファイルシステム設定を読み込みます：ユーザー、プロジェクト、ローカル。管理ポリシー設定はすべての場合に読み込まれます。サーバー管理設定は、セッションが [適格な設定](/ja/server-managed-settings#platform-availability) 上の組織認証情報で認証されるときに取得されます。[Claude Code 機能を使用](/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control) を参照して、このオプションに関係なく読み込まれる入力と、それらを無効にする方法を確認してください。1050`setting_sources` が省略されるか `None` の場合、`query()` は Claude Code CLI と同じファイルシステム設定を読み込みます：ユーザー、プロジェクト、ローカル。管理ポリシー設定はすべての場合に読み込まれます。サーバー管理設定は、セッションが [適格な設定](/docs/ja/server-managed-settings#platform-availability) 上の組織認証情報で認証されるときに取得されます。[Claude Code 機能を使用](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control) を参照して、このオプションに関係なく読み込まれる入力と、それらを無効にする方法を確認してください。

1051 1051 

1052<h4 id="why-use-setting_sources">1052<h4 id="why-use-setting_sources">

1053 setting\_sources を使用する理由1053 setting\_sources を使用する理由

1257 1257 

1258`PermissionResult`（`PermissionResultAllow` または `PermissionResultDeny`）を返します。1258`PermissionResult`（`PermissionResultAllow` または `PermissionResultDeny`）を返します。

1259 1259 

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

1261 1261 

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

1263 1263 

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

1265 `ToolPermissionContext`1265 `ToolPermissionContext`

1606]1606]

1607```1607```

1608 1608 

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

1610 1610 

1611<h2 id="message-types">1611<h2 id="message-types">

1612 メッセージ型1612 メッセージ型

1749 1749 

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

1751| ----------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |1751| ----------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |

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

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

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

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

1756 1756 

1757`model_usage` dict はモデル名をモデルごとの使用状況にマップします。内部 dict キーは camelCase を使用します。これは、基になる CLI プロセスから変更されずに渡される値であり、TypeScript [`ModelUsage`](/ja/agent-sdk/typescript#modelusage) 型と一致するためです：1757`model_usage` dict はモデル名をモデルごとの使用状況にマップします。内部 dict キーは camelCase を使用します。これは、基になる CLI プロセスから変更されずに渡される値であり、TypeScript [`ModelUsage`](/docs/ja/agent-sdk/typescript#modelusage) 型と一致するためです：

1758 1758 

1759| キー | 型 | 説明 |1759| キー | 型 | 説明 |

1760| -------------------------- | ------- | --------------------------------------------------------------------------------------------- |1760| -------------------------- | ------- | --------------------------------------------------------------------------------------------- |

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

1764| `cacheCreationInputTokens` | `int` | このモデルのキャッシュ作成トークン。 |1764| `cacheCreationInputTokens` | `int` | このモデルのキャッシュ作成トークン。 |

1765| `webSearchRequests` | `int` | このモデルが行った Web 検索リクエスト。 |1765| `webSearchRequests` | `int` | このモデルが行った Web 検索リクエスト。 |

1766| `costUSD` | `float` | このモデルの推定 USD コスト。クライアント側で計算されます。[コストと使用状況を追跡](/ja/agent-sdk/cost-tracking) で請求の注意事項を参照してください。 |1766| `costUSD` | `float` | このモデルの推定 USD コスト。クライアント側で計算されます。[コストと使用状況を追跡](/docs/ja/agent-sdk/cost-tracking) で請求の注意事項を参照してください。 |

1767| `contextWindow` | `int` | このモデルのコンテキストウィンドウサイズ。 |1767| `contextWindow` | `int` | このモデルのコンテキストウィンドウサイズ。 |

1768| `maxOutputTokens` | `int` | このモデルの最大出力トークン制限。 |1768| `maxOutputTokens` | `int` | このモデルの最大出力トークン制限。 |

1769 1769 

2090 Hook 型2090 Hook 型

2091</h2>2091</h2>

2092 2092 

2093hooks の使用に関する包括的なガイド、例、一般的なパターンについては、[Hooks ガイド](/ja/agent-sdk/hooks) を参照してください。2093hooks の使用に関する包括的なガイド、例、一般的なパターンについては、[Hooks ガイド](/docs/ja/agent-sdk/hooks) を参照してください。

2094 2094 

2095<h3 id="hookevent">2095<h3 id="hookevent">

2096 `HookEvent`2096 `HookEvent`

2474 `HookSpecificOutput`2474 `HookSpecificOutput`

2475</h4>2475</h4>

2476 2476 

2477hook イベント名とイベント固有のフィールドを含む `TypedDict`。形状は `hookEventName` 値に依存します。hook イベントごとに利用可能なフィールドの詳細については、[hooks で実行を制御](/ja/agent-sdk/hooks#outputs) を参照してください。2477hook イベント名とイベント固有のフィールドを含む `TypedDict`。形状は `hookEventName` 値に依存します。hook イベントごとに利用可能なフィールドの詳細については、[hooks で実行を制御](/docs/ja/agent-sdk/hooks#outputs) を参照してください。

2478 2478 

2479イベント固有の出力型の判別 union。`hookEventName` フィールドはどのフィールドが有効かを決定します。2479イベント固有の出力型の判別 union。`hookEventName` フィールドはどのフィールドが有効かを決定します。

2480 2480 

2639 2639 

2640**ツール名：** `AskUserQuestion`2640**ツール名：** `AskUserQuestion`

2641 2641 

2642実行中にユーザーに明確化の質問をします。使用の詳細については [承認とユーザー入力を処理](/ja/agent-sdk/user-input#handle-clarifying-questions) を参照してください。2642実行中にユーザーに明確化の質問をします。使用の詳細については [承認とユーザー入力を処理](/docs/ja/agent-sdk/user-input#handle-clarifying-questions) を参照してください。

2643 2643 

2644**入力：**2644**入力：**

2645 2645 

2717 2717 

2718バックグラウンドソースを実行し、各イベントを Claude に配信して、ポーリングなしで反応できるようにします。`command` はスクリプトを実行し、stdout 行ごとに 1 つのイベントを発行し、`ws` は WebSocket を開き、テキストフレームごとに 1 つのイベントを発行します。`command` または `ws` のいずれか 1 つを正確に指定してください。2718バックグラウンドソースを実行し、各イベントを Claude に配信して、ポーリングなしで反応できるようにします。`command` はスクリプトを実行し、stdout 行ごとに 1 つのイベントを発行し、`ws` は WebSocket を開き、テキストフレームごとに 1 つのイベントを発行します。`command` または `ws` のいずれか 1 つを正確に指定してください。

2719 2719 

2720Monitor がコマンドを実行する場合、Bash と同じパーミッションルールに従います。WebSocket ウォッチは別途承認を求めます。{/* min-version: 2.1.195 */}`ws` ソースには Claude Code v2.1.195 以降が必要です。動作とプロバイダーの可用性については、[Monitor ツールリファレンス](/ja/tools-reference#monitor-tool) を参照してください。2720Monitor がコマンドを実行する場合、Bash と同じパーミッションルールに従います。WebSocket ウォッチは別途承認を求めます。`ws` ソースには Claude Code v2.1.195 以降が必要です。動作とプロバイダーの可用性については、[Monitor ツールリファレンス](/docs/ja/tools-reference#monitor-tool) を参照してください。

2721 2721 

2722**入力：**2722**入力：**

2723 2723 

2995**ツール名：** `TodoWrite`2995**ツール名：** `TodoWrite`

2996 2996 

2997<Note>2997<Note>

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

2999</Note>2999</Note>

3000 3000 

3001**入力：**3001**入力：**

3699 `SandboxNetworkConfig`3699 `SandboxNetworkConfig`

3700</h3>3700</h3>

3701 3701 

3702サンドボックスモード用のネットワーク固有の設定。これらの設定は、親の [`SandboxSettings`](#sandboxsettings) で `enabled` が `True` の場合、サンドボックス化された Bash コマンドに適用されます。WebFetch ツールには適用されず、WebFetch ツールは代わりに [パーミッションルール](/ja/permissions#webfetch) を使用します。3702サンドボックスモード用のネットワーク固有の設定。これらの設定は、親の [`SandboxSettings`](#sandboxsettings) で `enabled` が `True` の場合、サンドボックス化された Bash コマンドに適用されます。WebFetch ツールには適用されず、WebFetch ツールは代わりに [パーミッションルール](/docs/ja/permissions#webfetch) を使用します。

3703 3703 

3704```python theme={null}3704```python theme={null}

3705class SandboxNetworkConfig(TypedDict, total=False):3705class SandboxNetworkConfig(TypedDict, total=False):

3727| `socksProxyPort` | `int` | `None` | ネットワークリクエスト用の SOCKS プロキシポート |3727| `socksProxyPort` | `int` | `None` | ネットワークリクエスト用の SOCKS プロキシポート |

3728 3728 

3729<Note>3729<Note>

3730 組み込みサンドボックスプロキシは、リクエストされたホスト名に基づいてネットワーク許可リストを強制し、TLS トラフィックを終了または検査しないため、[ドメインフロンティング](https://en.wikipedia.org/wiki/Domain_fronting) などの技術がそれをバイパスする可能性があります。詳細は [サンドボックスセキュリティの制限事項](/ja/sandboxing#security-limitations) を参照し、TLS 終了プロキシの設定については [セキュアなデプロイ](/ja/agent-sdk/secure-deployment#traffic-forwarding) を参照してください。3730 組み込みサンドボックスプロキシは、リクエストされたホスト名に基づいてネットワーク許可リストを強制し、TLS トラフィックを終了または検査しないため、[ドメインフロンティング](https://en.wikipedia.org/wiki/Domain_fronting) などの技術がそれをバイパスする可能性があります。詳細は [サンドボックスセキュリティの制限事項](/docs/ja/sandboxing#security-limitations) を参照し、TLS 終了プロキシの設定については [セキュアなデプロイ](/docs/ja/agent-sdk/secure-deployment#traffic-forwarding) を参照してください。

3731</Note>3731</Note>

3732 3732 

3733<h3 id="sandboxignoreviolations">3733<h3 id="sandboxignoreviolations">

3831 関連項目3831 関連項目

3832</h2>3832</h2>

3833 3833 

3834* [SDK 概要](/ja/agent-sdk/overview) - 一般的な SDK 概念3834* [SDK 概要](/docs/ja/agent-sdk/overview) - 一般的な SDK 概念

3835* [TypeScript SDK リファレンス](/ja/agent-sdk/typescript) - TypeScript SDK ドキュメント3835* [TypeScript SDK リファレンス](/docs/ja/agent-sdk/typescript) - TypeScript SDK ドキュメント

3836* [CLI リファレンス](/ja/cli-reference) - コマンドラインインターフェース3836* [CLI リファレンス](/docs/ja/cli-reference) - コマンドラインインターフェース

3837* [一般的なワークフロー](/ja/common-workflows) - ステップバイステップガイド3837* [一般的なワークフロー](/docs/ja/common-workflows) - ステップバイステップガイド

17 17 

18サブエージェントは 3 つの方法で作成できます。18サブエージェントは 3 つの方法で作成できます。

19 19 

20* **プログラム的に**: `query()` オプションの `agents` パラメータを使用します。[TypeScript](/ja/agent-sdk/typescript#agentdefinition) および [Python](/ja/agent-sdk/python#agentdefinition) リファレンスを参照してください20* **プログラム的に**: `query()` オプションの `agents` パラメータを使用します。[TypeScript](/docs/ja/agent-sdk/typescript#agentdefinition) および [Python](/docs/ja/agent-sdk/python#agentdefinition) リファレンスを参照してください

21* **ファイルシステムベース**: `.claude/agents/` ディレクトリ内のマークダウンファイルとしてエージェントを定義します。[ファイルとしてサブエージェントを定義する](/ja/sub-agents)を参照してください21* **ファイルシステムベース**: `.claude/agents/` ディレクトリ内のマークダウンファイルとしてエージェントを定義します。[ファイルとしてサブエージェントを定義する](/docs/ja/sub-agents)を参照してください

22* **組み込みの汎用**: Claude は、何も定義することなく、Agent ツールを介して組み込みの `general-purpose` サブエージェントをいつでも呼び出すことができます22* **組み込みの汎用**: Claude は、何も定義することなく、Agent ツールを介して組み込みの `general-purpose` サブエージェントをいつでも呼び出すことができます

23 23 

24このガイドでは、SDK アプリケーションに推奨されるプログラム的なアプローチに焦点を当てています。24このガイドでは、SDK アプリケーションに推奨されるプログラム的なアプローチに焦点を当てています。

197| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max' \| number` | いいえ | このエージェントの推論努力レベル |197| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max' \| number` | いいえ | このエージェントの推論努力レベル |

198| `permissionMode` | `PermissionMode` | いいえ | このエージェント内のツール実行のパーミッションモード |198| `permissionMode` | `PermissionMode` | いいえ | このエージェント内のツール実行のパーミッションモード |

199 199 

200Python SDK では、`disallowedTools` や `mcpServers` などの複数単語のフィールド名は、Python の snake\_case 規約に従うのではなく、wire フォーマットに一致するように camelCase を保持します。詳細については、[`AgentDefinition` リファレンス](/ja/agent-sdk/python#agentdefinition)を参照してください。200Python SDK では、`disallowedTools` や `mcpServers` などの複数単語のフィールド名は、Python の snake\_case 規約に従うのではなく、wire フォーマットに一致するように camelCase を保持します。詳細については、[`AgentDefinition` リファレンス](/docs/ja/agent-sdk/python#agentdefinition)を参照してください。

201 201 

202Claude Code v2.1.198 でサブエージェントの動作が 2 つ変更されました。202Claude Code v2.1.198 でサブエージェントの動作が 2 つ変更されました。

203 203 

204* サブエージェントはデフォルトでバックグラウンドで実行されます。[`run_in_background`](/ja/agent-sdk/typescript) 入力を省略する Agent ツール呼び出しはバックグラウンドサブエージェントを起動し、Claude が続行する前に結果が必要な場合は `run_in_background: false` を設定します。v2.1.198 より前は、`run_in_background` を省略するとサブエージェントが同期的に実行されていました。特定のエージェントに対してバックグラウンド実行を強制するには、`background` フィールドを `true` に設定してください。これは Claude が要求する内容に関わらず適用されます。204* サブエージェントはデフォルトでバックグラウンドで実行されます。[`run_in_background`](/docs/ja/agent-sdk/typescript) 入力を省略する Agent ツール呼び出しはバックグラウンドサブエージェントを起動し、Claude が続行する前に結果が必要な場合は `run_in_background: false` を設定します。v2.1.198 より前は、`run_in_background` を省略するとサブエージェントが同期的に実行されていました。特定のエージェントに対してバックグラウンド実行を強制するには、`background` フィールドを `true` に設定してください。これは Claude が要求する内容に関わらず適用されます。

205* サブエージェントはメインセッションの拡張思考設定を継承します。以前のバージョンでは、メインセッションの設定に関わらず、サブエージェント内で拡張思考が無効になっていました。205* サブエージェントはメインセッションの拡張思考設定を継承します。以前のバージョンでは、メインセッションの設定に関わらず、サブエージェント内で拡張思考が無効になっていました。

206 206 

207<Note>207<Note>

208 {/* min-version: 2.1.172 */}Claude Code v2.1.172 以降、サブエージェントは独自のサブエージェントを生成できます。メインエージェントの 5 レベル下のサブエージェントは、フォアグラウンドまたはバックグラウンドで実行されるかどうかに関わらず、それ以上のサブエージェントを生成できません。サブエージェントが他のサブエージェントを生成するのを防ぐには、その `tools` 配列から `Agent` を省略するか、`disallowedTools` に追加してください。完全な深さルールについては、[ネストされたサブエージェント](/ja/sub-agents#spawn-nested-subagents)を参照してください。208 Claude Code v2.1.172 以降、サブエージェントは独自のサブエージェントを生成できます。メインエージェントの 5 レベル下のサブエージェントは、フォアグラウンドまたはバックグラウンドで実行されるかどうかに関わらず、それ以上のサブエージェントを生成できません。サブエージェントが他のサブエージェントを生成するのを防ぐには、その `tools` 配列から `Agent` を省略するか、`disallowedTools` に追加してください。完全な深さルールについては、[ネストされたサブエージェント](/docs/ja/sub-agents#spawn-nested-subagents)を参照してください。

209</Note>209</Note>

210 210 

211<h3 id="filesystem-based-definition-alternative">211<h3 id="filesystem-based-definition-alternative">

212 ファイルシステムベースの定義（代替）212 ファイルシステムベースの定義（代替）

213</h3>213</h3>

214 214 

215`.claude/agents/` ディレクトリ内のマークダウンファイルとしてサブエージェントを定義することもできます。このアプローチの詳細については、[Claude Code サブエージェントドキュメント](/ja/sub-agents)を参照してください。プログラム的に定義されたエージェントは、同じ名前のファイルシステムベースのエージェントより優先されます。215`.claude/agents/` ディレクトリ内のマークダウンファイルとしてサブエージェントを定義することもできます。このアプローチの詳細については、[Claude Code サブエージェントドキュメント](/docs/ja/sub-agents)を参照してください。プログラム的に定義されたエージェントは、同じ名前のファイルシステムベースのエージェントより優先されます。

216 216 

217<Note>217<Note>

218 カスタムサブエージェントを定義しなくても、Claude は組み込みの `general-purpose` サブエージェントを生成できます。これは、特殊なエージェントを作成せずに研究または探索タスクを委譲するのに便利です。`allowedTools` に `Agent` を含めて、これらの呼び出しがパーミッション プロンプトなしで自動承認されるようにしてください。218 カスタムサブエージェントを定義しなくても、Claude は組み込みの `general-purpose` サブエージェントを生成できます。これは、特殊なエージェントを作成せずに研究または探索タスクを委譲するのに便利です。`allowedTools` に `Agent` を含めて、これらの呼び出しがパーミッション プロンプトなしで自動承認されるようにしてください。

224 224 

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

226 226 

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

228 228 

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

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

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

232| プロジェクト CLAUDE.md（[`settingSources`](/ja/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) 経由でロード） | プリロードされたスキルコンテンツ（`AgentDefinition.skills` にリストされている場合を除く） |232| プロジェクト CLAUDE.md（[`settingSources`](/docs/ja/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) 経由でロード） | プリロードされたスキルコンテンツ（`AgentDefinition.skills` にリストされている場合を除く） |

233| ツール定義（親から継承、または `tools` のサブセット） | 親のシステムプロンプト |233| ツール定義（親から継承、または `tools` のサブセット） | 親のシステムプロンプト |

234 234 

235<Note>235<Note>

236 親はサブエージェントの最終メッセージを Agent ツール結果として逐語的に受け取りますが、独自の応答で要約する場合があります。サブエージェント出力を逐語的にユーザー向けの応答で保持するには、メイン `query()` 呼び出しに渡すプロンプトまたは `systemPrompt` オプションに指示を含めてください。236 親はサブエージェントの最終メッセージを Agent ツール結果として逐語的に受け取りますが、独自の応答で要約する場合があります。サブエージェント出力を逐語的にユーザー向けの応答で保持するには、メイン `query()` 呼び出しに渡すプロンプトまたは `systemPrompt` オプションに指示を含めてください。

237</Note>237</Note>

238 238 

239サブエージェントを早期に終了させるレート制限などの API エラーは、その結果として配信されることはありません。レート制限、オーバーロード、またはサーバーエラーがすでにテキスト出力を生成しているフォアグラウンドサブエージェントを遮断した場合、Agent ツールはサブエージェントが完了しなかったというメモ付きでその部分的な出力を返します。何も出力しなかったサブエージェント、またはテキストのないツール呼び出しのみが出力だったサブエージェントは、エラーメッセージ「Agent terminated early due to an API error」の後にエラーの詳細が続いて失敗します。フォアグラウンドおよびバックグラウンドの動作については、[サブエージェントの API エラー](/ja/sub-agents#api-errors-in-subagents)を参照してください。239サブエージェントを早期に終了させるレート制限などの API エラーは、その結果として配信されることはありません。レート制限、オーバーロード、またはサーバーエラーがすでにテキスト出力を生成しているフォアグラウンドサブエージェントを遮断した場合、Agent ツールはサブエージェントが完了しなかったというメモ付きでその部分的な出力を返します。何も出力しなかったサブエージェント、またはテキストのないツール呼び出しのみが出力だったサブエージェントは、エラーメッセージ「Agent terminated early due to an API error」の後にエラーの詳細が続いて失敗します。フォアグラウンドおよびバックグラウンドの動作については、[サブエージェントの API エラー](/docs/ja/sub-agents#api-errors-in-subagents)を参照してください。

240 240 

241この部分的な出力処理には Claude Code v2.1.199 以降が必要です。v2.1.199 では、レート制限、オーバーロード、またはサーバーエラーは、ツール呼び出しのみの形状を遮断メモのみを含む空の部分的な結果のままにしました。241この部分的な出力処理には Claude Code v2.1.199 以降が必要です。v2.1.199 では、レート制限、オーバーロード、またはサーバーエラーは、ツール呼び出しのみの形状を遮断メモのみを含む空の部分的な結果のままにしました。

242 242 

441 441 

442サブエージェントを再開して、中断したところから続行できます。再開されたサブエージェントは、以前のすべてのツール呼び出し、結果、推論を含む完全な会話履歴を保持します。442サブエージェントを再開して、中断したところから続行できます。再開されたサブエージェントは、以前のすべてのツール呼び出し、結果、推論を含む完全な会話履歴を保持します。

443 443 

444サブエージェントが完了すると、Agent ツール結果には `agentId: <id>` を含むテキストブロックが含まれます。組み込みの [`Explore` および `Plan` エージェント](/ja/sub-agents#built-in-subagents) はワンショットであり、`agentId` を返さないため、再開が必要な場合はカスタムエージェントまたは `general-purpose` を使用してください。サブエージェントをプログラム的に再開するには：444サブエージェントが完了すると、Agent ツール結果には `agentId: <id>` を含むテキストブロックが含まれます。組み込みの [`Explore` および `Plan` エージェント](/docs/ja/sub-agents#built-in-subagents) はワンショットであり、`agentId` を返さないため、再開が必要な場合はカスタムエージェントまたは `general-purpose` を使用してください。サブエージェントをプログラム的に再開するには：

445 445 

4461. **セッション ID をキャプチャする**: 最初のクエリ中にメッセージから `session_id` を抽出します4461. **セッション ID をキャプチャする**: 最初のクエリ中にメッセージから `session_id` を抽出します

4472. **エージェント ID を抽出する**: Agent ツール結果テキストから `agentId` を解析します4472. **エージェント ID を抽出する**: Agent ツール結果テキストから `agentId` を解析します

661 動的ワークフローでスケールアップ661 動的ワークフローでスケールアップ

662</h2>662</h2>

663 663 

664サブエージェントは、ターンごとに数個の委譲されたタスクに適しています。数十から数百のエージェントを調整する実行の場合は、`Workflow` ツールを使用してください。これにより、オーケストレーションを会話コンテキストの外で実行時が実行するスクリプトに移動します。[動的ワークフロー](/ja/workflows)を参照して、ワークフローがターンごとのサブエージェント委譲とどのように異なるかを確認してください。664サブエージェントは、ターンごとに数個の委譲されたタスクに適しています。数十から数百のエージェントを調整する実行の場合は、`Workflow` ツールを使用してください。これにより、オーケストレーションを会話コンテキストの外で実行時が実行するスクリプトに移動します。[動的ワークフロー](/docs/ja/workflows)を参照して、ワークフローがターンごとのサブエージェント委譲とどのように異なるかを確認してください。

665 665 

666`Workflow` ツールは TypeScript Agent SDK v0.3.149 以降で利用可能です。`allowedTools` に `Workflow` を含めてワークフロー実行を自動承認します。ツール入力および出力スキーマは [TypeScript リファレンス](/ja/agent-sdk/typescript#workflow)に記載されています。666`Workflow` ツールは TypeScript Agent SDK v0.3.149 以降で利用可能です。`allowedTools` に `Workflow` を含めてワークフロー実行を自動承認します。ツール入力および出力スキーマは [TypeScript リファレンス](/docs/ja/agent-sdk/typescript#workflow)に記載されています。

667 667 

668<h2 id="troubleshooting">668<h2 id="troubleshooting">

669 トラブルシューティング669 トラブルシューティング

690* **`--disable-slash-commands`**: このフラグで開始されたセッションはこれらのディレクトリを監視せず、新しいファイルを読み込むには常に再起動が必要です。690* **`--disable-slash-commands`**: このフラグで開始されたセッションはこれらのディレクトリを監視せず、新しいファイルを読み込むには常に再起動が必要です。

691* **同じ名前のプログラマティックエージェント**: `query()` に渡される `agents` は、同じ名前のファイルシステムエージェントをオーバーライドします。691* **同じ名前のプログラマティックエージェント**: `query()` に渡される `agents` は、同じ名前のファイルシステムエージェントをオーバーライドします。

692 692 

693ファイル形式については、[サブエージェントファイルの書き方](/ja/sub-agents#write-subagent-files)を参照してください。693ファイル形式については、[サブエージェントファイルの書き方](/docs/ja/sub-agents#write-subagent-files)を参照してください。

694 694 

695<h3 id="long-prompt-failures-on-windows">695<h3 id="long-prompt-failures-on-windows">

696 Windows での長いプロンプトの失敗696 Windows での長いプロンプトの失敗

702 関連ドキュメント702 関連ドキュメント

703</h2>703</h2>

704 704 

705* [Claude Code サブエージェント](/ja/sub-agents)：ファイルシステムベースの定義を含む包括的なサブエージェントドキュメント705* [Claude Code サブエージェント](/docs/ja/sub-agents)：ファイルシステムベースの定義を含む包括的なサブエージェントドキュメント

706* [動的ワークフロー](/ja/workflows)：スクリプトから多くのサブエージェントをオーケストレートして、1 つの会話には大きすぎるジョブを実行します706* [動的ワークフロー](/docs/ja/workflows)：スクリプトから多くのサブエージェントをオーケストレートして、1 つの会話には大きすぎるジョブを実行します

707* [SDK 概要](/ja/agent-sdk/overview)：Claude Agent SDK の開始方法707* [SDK 概要](/docs/ja/agent-sdk/overview)：Claude Agent SDK の開始方法

38 例38 例

39</h2>39</h2>

40 40 

41これらの例を実行する前に、[クイックスタート](/ja/agent-sdk/quickstart)に従って Claude Agent SDK をインストールしてください。41これらの例を実行する前に、[クイックスタート](/docs/ja/agent-sdk/quickstart)に従って Claude Agent SDK をインストールしてください。

42 42 

43各例はエージェントが完了して最終結果メッセージを生成するまで実行されます。セッションがターン制限に最初に達した場合、その結果メッセージは `error_max_turns` サブタイプを持ちます。終了を検出するために `subtype` を確認してください。43各例はエージェントが完了して最終結果メッセージを生成するまで実行されます。セッションがターン制限に最初に達した場合、その結果メッセージは `error_max_turns` サブタイプを持ちます。終了を検出するために `subtype` を確認してください。

44 44 

45これらの例は単一ショットの `query()` 呼び出しを使用します。`error_max_turns` 結果を生成した後、`query()` は `Reached maximum number of turns` を含むエラーを発生させます。各例はそれが発生したときにクリーンに終了するために、ループを try ブロックでラップします。45これらの例は単一ショットの `query()` 呼び出しを使用します。`error_max_turns` 結果を生成した後、`query()` は `Reached maximum number of turns` を含むエラーを発生させます。各例はそれが発生したときにクリーンに終了するために、ループを try ブロックでラップします。

46 46 

47結果サブタイプについては、[結果を処理する](/ja/agent-sdk/agent-loop#handle-the-result)を参照してください。47結果サブタイプについては、[結果を処理する](/docs/ja/agent-sdk/agent-loop#handle-the-result)を参照してください。

48 48 

49<h3 id="monitoring-todo-changes">49<h3 id="monitoring-todo-changes">

50 Todo 変更の監視50 Todo 変更の監視

251 Task ツールへの移行251 Task ツールへの移行

252</h2>252</h2>

253 253 

254Task ツールは、単一の `TodoWrite` 呼び出しを、各新規アイテムの `TaskCreate` と各ステータス変更の `TaskUpdate` に分割し、`TaskList` と `TaskGet` はモデルが現在のリストを読み戻すために利用可能です。監視コードは引き続きアシスタントストリーム内の `tool_use` ブロックを検査しますが、すべての呼び出しでリスト全体を置き換える代わりに、タスク ID でキー付けされたマップを保持します。{/* min-version: 2.1.142 */}Task ツールは TypeScript Agent SDK 0.3.142 および Claude Code v2.1.142 以降のデフォルトであるため、`options.env` の変更は不要です。254Task ツールは、単一の `TodoWrite` 呼び出しを、各新規アイテムの `TaskCreate` と各ステータス変更の `TaskUpdate` に分割し、`TaskList` と `TaskGet` はモデルが現在のリストを読み戻すために利用可能です。監視コードは引き続きアシスタントストリーム内の `tool_use` ブロックを検査しますが、すべての呼び出しでリスト全体を置き換える代わりに、タスク ID でキー付けされたマップを保持します。Task ツールは TypeScript Agent SDK 0.3.142 および Claude Code v2.1.142 以降のデフォルトであるため、`options.env` の変更は不要です。

255 255 

256| `TodoWrite` を使用 | Task ツールを使用 |256| `TodoWrite` を使用 | Task ツールを使用 |

257| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |257| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

336 関連ドキュメント336 関連ドキュメント

337</h2>337</h2>

338 338 

339* [TypeScript SDK リファレンス](/ja/agent-sdk/typescript)339* [TypeScript SDK リファレンス](/docs/ja/agent-sdk/typescript)

340* [Python SDK リファレンス](/ja/agent-sdk/python)340* [Python SDK リファレンス](/docs/ja/agent-sdk/python)

341* [ストリーミング vs シングルモード](/ja/agent-sdk/streaming-vs-single-mode)341* [ストリーミング vs シングルモード](/docs/ja/agent-sdk/streaming-vs-single-mode)

342* [カスタムツール](/ja/agent-sdk/custom-tools)342* [カスタムツール](/docs/ja/agent-sdk/custom-tools)

6 6 

7> TypeScript Agent SDK の完全な API リファレンス。すべての関数、型、インターフェースを含みます。7> TypeScript Agent SDK の完全な API リファレンス。すべての関数、型、インターフェースを含みます。

8 8 

9<script src="/components/typescript-sdk-type-links.js" defer />9<script src="/docs/components/typescript-sdk-type-links.js" defer />

10 10 

11<h2 id="installation">11<h2 id="installation">

12 インストール12 インストール

296</h4>296</h4>

297 297 

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

299| :------------------- | :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |299| :------------------- | :---------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

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

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

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

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

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

306 306 

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

308 例308 例

423| :------------------------------ | :------------------------------------ | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |423| :------------------------------ | :------------------------------------ | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

425| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | すべてのソース | 読み込むファイルシステムソース。ユーザー、プロジェクト、およびローカル設定をスキップするには `[]` を渡します。管理ポリシー設定はすべての場合に読み込まれます。サーバー管理設定はホストが `serverManagedSettings` を渡すときにそこから取得されるか、そうでない場合は CLI のオンディスクキャッシュから読み取られます。スナップショットはネットワークからそれらをフェッチしません |425| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | すべてのソース | 読み込むファイルシステムソース。ユーザー、プロジェクト、およびローカル設定をスキップするには `[]` を渡します。管理ポリシー設定はすべての場合に読み込まれます。サーバー管理設定はホストが `serverManagedSettings` を渡すときにそこから取得されるか、そうでない場合は CLI のオンディスクキャッシュから読み取られます。スナップショットはネットワークからそれらをフェッチしません |

426| `options.managedSettings` | `Settings` | `undefined` | 埋め込みホストによって提供される制限的なポリシーティア設定。管理者がデプロイした管理ティアが存在する場合、ドロップされます。[`parentSettingsBehavior`](/ja/settings#available-settings) が `"merge"` の場合、そのティアの下でマージされます。`model` などの非制限的なキーは静かにドロップされるため、このオプションは管理ポリシーを厳しくできますが、緩くすることはできません |426| `options.managedSettings` | `Settings` | `undefined` | 埋め込みホストによって提供される制限的なポリシーティア設定。管理者がデプロイした管理ティアが存在する場合、ドロップされます。[`parentSettingsBehavior`](/docs/ja/settings#available-settings) が `"merge"` の場合、そのティアの下でマージされます。`model` などの非制限的なキーは静かにドロップされるため、このオプションは管理ポリシーを厳しくできますが、緩くすることはできません |

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

428 428 

429<h4 id="return-type-resolvedsettings">429<h4 id="return-type-resolvedsettings">

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

499| `maxBudgetUsd` | `number` | `undefined` | クライアント側のコスト推定がこの USD 値に達したときにクエリを停止します。`total_cost_usd` と同じ推定と比較されます。[コストと使用状況を追跡](/ja/agent-sdk/cost-tracking) で精度の注意事項を参照してください |499| `maxBudgetUsd` | `number` | `undefined` | クライアント側のコスト推定がこの USD 値に達したときにクエリを停止します。`total_cost_usd` と同じ推定と比較されます。[コストと使用状況を追跡](/docs/ja/agent-sdk/cost-tracking) で精度の注意事項を参照してください |

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

501| `maxTurns` | `number` | `undefined` | 最大 agentic ターン数（ツール使用ラウンドトリップ） |501| `maxTurns` | `number` | `undefined` | 最大 agentic ターン数（ツール使用ラウンドトリップ） |

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

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

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

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

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

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

508| `permissionMode` | [`PermissionMode`](#permissionmode) | `'default'` | セッションの権限モード |508| `permissionMode` | [`PermissionMode`](#permissionmode) | `'default'` | セッションの権限モード |

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

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

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

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

513| `promptSuggestions` | `boolean` | `false` | プロンプト提案を有効にします。各ターン後に予測される次のユーザープロンプトを含む `prompt_suggestion` メッセージを発行します |513| `promptSuggestions` | `boolean` | `false` | プロンプト提案を有効にします。各ターン後に予測される次のユーザープロンプトを含む `prompt_suggestion` メッセージを発行します |

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

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

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

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

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

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

520| `settings` | `string \| Settings` | `undefined` | インライン [設定](/ja/settings) オブジェクトまたは設定ファイルへのパス。[優先順位](/ja/settings#settings-precedence) のフラグ設定レイヤーを入力します。[`applyFlagSettings()`](#applyflagsettings) でランタイムに変更します |520| `settings` | `string \| Settings` | `undefined` | インライン [設定](/docs/ja/settings) オブジェクトまたは設定ファイルへのパス。[優先順位](/docs/ja/settings#settings-precedence) のフラグ設定レイヤーを入力します。[`applyFlagSettings()`](#applyflagsettings) でランタイムに変更します |

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

522| `skills` | `string[] \| 'all'` | `undefined` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `'all'` を渡すか、スキル名のリストを渡します。設定すると、SDK は `allowedTools` に `'Skill'` を含めていなくても Skill ツールを自動的に追加します。`tools` も渡す場合は、そのリストに `'Skill'` を含めます。[スキル](/ja/agent-sdk/skills) を参照してください |522| `skills` | `string[] \| 'all'` | `undefined` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `'all'` を渡すか、スキル名のリストを渡します。設定すると、SDK は `allowedTools` に `'Skill'` を含めていなくても Skill ツールを自動的に追加します。`tools` も渡す場合は、そのリストに `'Skill'` を含めます。[スキル](/docs/ja/agent-sdk/skills) を参照してください |

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

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

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

526| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined`（最小限のプロンプト） | システムプロンプト設定。カスタムプロンプト用の文字列を渡すか、Claude Code のシステムプロンプトを使用するには `{ type: 'preset', preset: 'claude_code' }` を渡します。プリセットオブジェクト形式を使用する場合、追加の指示で拡張するには `append` を追加し、[マシン全体でプロンプトキャッシュの再利用を改善](/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) するためにセッションごとのコンテキストを最初のユーザーメッセージに移動するには `excludeDynamicSections: true` を設定します |526| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined`（最小限のプロンプト） | システムプロンプト設定。カスタムプロンプト用の文字列を渡すか、Claude Code のシステムプロンプトを使用するには `{ type: 'preset', preset: 'claude_code' }` を渡します。プリセットオブジェクト形式を使用する場合、追加の指示で拡張するには `append` を追加し、[マシン全体でプロンプトキャッシュの再利用を改善](/docs/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) するためにセッションごとのコンテキストを最初のユーザーメッセージに移動するには `excludeDynamicSections: true` を設定します |

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

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

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

552```552```

553 553 

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

555* `CLAUDE_CODE_MAX_RETRIES`：最大 API リトライ数。デフォルト `10`、上限 `15`。各リトライは独自の `API_TIMEOUT_MS` ウィンドウを取得するため、最悪の場合の経過時間は約 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` にバックオフを加えたものです。無人実行で長い停止を待つ必要がある場合は、`CLAUDE_CODE_RETRY_WATCHDOG=1` を設定して容量エラーを無限に再試行します。{/* min-version: 2.1.199 */}Claude Code v2.1.199 以降では、他の一時的なエラーのデフォルトを `300` に引き上げ、この変数の上限を削除します。555* `CLAUDE_CODE_MAX_RETRIES`：最大 API リトライ数。デフォルト `10`、上限 `15`。各リトライは独自の `API_TIMEOUT_MS` ウィンドウを取得するため、最悪の場合の経過時間は約 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` にバックオフを加えたものです。無人実行で長い停止を待つ必要がある場合は、`CLAUDE_CODE_RETRY_WATCHDOG=1` を設定して容量エラーを無限に再試行します。Claude Code v2.1.199 以降では、他の一時的なエラーのデフォルトを `300` に引き上げ、この変数の上限を削除します。

556* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`：`run_in_background` で起動されたサブエージェントの停止ウォッチドッグ。デフォルト `600000`。各ストリームイベントでリセットされます。停止時にサブエージェントを中止し、タスクを失敗とマークし、部分的な結果を含むエラーを親に表示します。同期サブエージェントには適用されません。556* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`：`run_in_background` で起動されたサブエージェントの停止ウォッチドッグ。デフォルト `600000`。各ストリームイベントでリセットされます。停止時にサブエージェントを中止し、タスクを失敗とマークし、部分的な結果を含むエラーを親に表示します。同期サブエージェントには適用されません。

557* `CLAUDE_ENABLE_STREAM_WATCHDOG` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`：ヘッダーが到着したがレスポンスボディがストリーミングを停止したときにリクエストを中止します。ウォッチドッグはすべてのプロバイダーでデフォルトでオンになっています。`CLAUDE_ENABLE_STREAM_WATCHDOG=0` で無効にします。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` はデフォルトで `300000` で、その最小値にクランプされます。中止されたリクエストは通常のリトライパスを通ります。557* `CLAUDE_ENABLE_STREAM_WATCHDOG` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`：ヘッダーが到着したがレスポンスボディがストリーミングを停止したときにリクエストを中止します。ウォッチドッグはすべてのプロバイダーでデフォルトでオンになっています。`CLAUDE_ENABLE_STREAM_WATCHDOG=0` で無効にします。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` はデフォルトで `300000` で、その最小値にクランプされます。中止されたリクエストは通常のリトライパスを通ります。

558 558 

594</h4>594</h4>

595 595 

596| メソッド | 説明 |596| メソッド | 説明 |

597| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |597| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

598| `interrupt()` | クエリを中断します。ストリーミング入力モードでのみ利用可能です。{/* min-version: 2.1.205 */}CLI が [`SDKSystemMessage.capabilities`](#sdksystemmessage) で `interrupt_receipt_v1` 機能をアドバタイズする場合、中断を生き残るキューに入れられたメッセージをリストする [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) で解決します。v2.1.205 より前の CLI では `undefined` で解決します |598| `interrupt()` | クエリを中断します。ストリーミング入力モードでのみ利用可能です。CLI が [`SDKSystemMessage.capabilities`](#sdksystemmessage) で `interrupt_receipt_v1` 機能をアドバタイズする場合、中断を生き残るキューに入れられたメッセージをリストする [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) で解決します。v2.1.205 より前の CLI では `undefined` で解決します |

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

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

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

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

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

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

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

606| `supportedCommands()` | 利用可能なスラッシュコマンドを返します |606| `supportedCommands()` | 利用可能なスラッシュコマンドを返します |

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

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

619 `applyFlagSettings()`619 `applyFlagSettings()`

620</h4>620</h4>

621 621 

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

623 623 

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

625 625 

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

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

628 628 

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

630 630 

631値はフラグ設定レイヤーに書き込まれます。これは、`query()` のインライン `settings` オプションがスタートアップ時に入力するのと同じレイヤーです。フラグ設定は [設定優先順位](/ja/settings#settings-precedence) の上部付近に位置します。ユーザー、プロジェクト、ローカル設定をオーバーライドし、管理ポリシー設定のみがそれらをオーバーライドできます。これは、[優先順位セクション](#settings-precedence) がプログラム的なオプションと呼ぶのと同じティアです。631値はフラグ設定レイヤーに書き込まれます。これは、`query()` のインライン `settings` オプションがスタートアップ時に入力するのと同じレイヤーです。フラグ設定は [設定優先順位](/docs/ja/settings#settings-precedence) の上部付近に位置します。ユーザー、プロジェクト、ローカル設定をオーバーライドし、管理ポリシー設定のみがそれらをオーバーライドできます。これは、[優先順位セクション](#settings-precedence) がプログラム的なオプションと呼ぶのと同じティアです。

632 632 

633連続した呼び出しは、トップレベルキーを浅くマージします。`{ permissions: {...} }` を含む 2 番目の呼び出しは、前の呼び出しから `permissions` オブジェクト全体を置き換えます。深くマージするのではなく。フラグレイヤーからキーをクリアして、より低い優先度のソースにフォールバックするには、そのキーに `null` を渡します。`undefined` を渡すと、JSON シリアル化がそれをドロップするため、効果がありません。633連続した呼び出しは、トップレベルキーを浅くマージします。`{ permissions: {...} }` を含む 2 番目の呼び出しは、前の呼び出しから `permissions` オブジェクト全体を置き換えます。深くマージするのではなく。フラグレイヤーからキーをクリアして、より低い優先度のソースにフォールバックするには、そのキーに `null` を渡します。`undefined` を渡すと、JSON シリアル化がそれをドロップするため、効果がありません。

634 634 

714 714 

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

716* メインスレッドメッセージのみがリストされます。サブエージェントにアドレス指定されたメッセージはスコープ外です。716* メインスレッドメッセージのみがリストされます。サブエージェントにアドレス指定されたメッセージはスコープ外です。

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

718 718 

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

720 720 

792 デフォルト動作792 デフォルト動作

793</h4>793</h4>

794 794 

795`settingSources` が省略または `undefined` の場合、`query()` は Claude Code CLI と同じファイルシステム設定をロードします：ユーザー、プロジェクト、ローカル。[エンドポイント管理ポリシー](/ja/settings#settings-files) はすべての場合にロードされます。サーバー管理設定は、[適格な設定](/ja/server-managed-settings#platform-availability) で組織認証情報を使用してセッションが認証されるときにフェッチされます。このオプションに関係なく読み取られる入力については [Claude Code 機能を使用](/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control) を参照してください。795`settingSources` が省略または `undefined` の場合、`query()` は Claude Code CLI と同じファイルシステム設定をロードします：ユーザー、プロジェクト、ローカル。[エンドポイント管理ポリシー](/docs/ja/settings#settings-files) はすべての場合にロードされます。サーバー管理設定は、[適格な設定](/docs/ja/server-managed-settings#platform-availability) で組織認証情報を使用してセッションが認証されるときにフェッチされます。このオプションに関係なく読み取られる入力については [Claude Code 機能を使用](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control) を参照してください。

796 796 

797<h4 id="why-use-settingsources">797<h4 id="why-use-settingsources">

798 settingSources を使用する理由798 settingSources を使用する理由

913 913 

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

915 915 

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

917 917 

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

919type CanUseTool = (919type CanUseTool = (

983 983 

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

985| :------------------------------ | :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ |985| :------------------------------ | :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ |

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

987 987 

988<h3 id="mcpserverconfig">988<h3 id="mcpserverconfig">

989 `McpServerConfig`989 `McpServerConfig`

1089];1089];

1090```1090```

1091 1091 

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

1093 1093 

1094<h2 id="message-types">1094<h2 id="message-types">

1095 メッセージ型1095 メッセージ型

1208};1208};

1209```1209```

1210 1210 

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

1212 1212 

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

1214 `SDKResultMessage`1214 `SDKResultMessage`

1277 1277 

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

1279 1279 

1280`PreToolUse` フックが `permissionDecision: "defer"` を返すと、結果は `stop_reason: "tool_deferred"` を持ち、`deferred_tool_use` は保留中のツールの `id`、`name`、`input` を保持します。このフィールドを読んで、独自の UI でリクエストをサーフェスし、同じ `session_id` で再開して続行します。完全なラウンドトリップについては、[ツール呼び出しを後で延期する](/ja/hooks#defer-a-tool-call-for-later)を参照してください。1280`PreToolUse` フックが `permissionDecision: "defer"` を返すと、結果は `stop_reason: "tool_deferred"` を持ち、`deferred_tool_use` は保留中のツールの `id`、`name`、`input` を保持します。このフィールドを読んで、独自の UI でリクエストをサーフェスし、同じ `session_id` で再開して続行します。完全なラウンドトリップについては、[ツール呼び出しを後で延期する](/docs/ja/hooks#defer-a-tool-call-for-later)を参照してください。

1281 1281 

1282<h3 id="sdksystemmessage">1282<h3 id="sdksystemmessage">

1283 `SDKSystemMessage`1283 `SDKSystemMessage`

1311};1311};

1312```1312```

1313 1313 

1314{/* min-version: 2.1.205 */}

1315 

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

1317 1315 

1318| 機能 | 意味 |1316| 機能 | 意味 |

1394 `SDKPluginInstallMessage`1392 `SDKPluginInstallMessage`

1395</h3>1393</h3>

1396 1394 

1397プラグインインストール進捗イベント。[`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/ja/env-vars) が設定されている場合に発行されるため、Agent SDK アプリケーションは最初のターンの前にマーケットプレイスプラグインのインストールを追跡できます。`started` と `completed` ステータスは全体的なインストールをブラケットします。`installed` と `failed` ステータスは個別のマーケットプレイスをレポートし、`name` を含みます。1395プラグインインストール進捗イベント。[`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/ja/env-vars) が設定されている場合に発行されるため、Agent SDK アプリケーションは最初のターンの前にマーケットプレイスプラグインのインストールを追跡できます。`started` と `completed` ステータスは全体的なインストールをブラケットします。`installed` と `failed` ステータスは個別のマーケットプレイスをレポートし、`name` を含みます。

1398 1396 

1399```typescript theme={null}1397```typescript theme={null}

1400type SDKPluginInstallMessage = {1398type SDKPluginInstallMessage = {

1477```1475```

1478 1476 

1479| `kind` | 意味 |1477| `kind` | 意味 |

1480| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1478| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1481| `human` | エンドユーザーからの直接入力。ユーザーメッセージでは、`origin` が存在しないこともヒューマン入力を意味します。 |1479| `human` | エンドユーザーからの直接入力。ユーザーメッセージでは、`origin` が存在しないこともヒューマン入力を意味します。 |

1482| `channel` | [チャネル](/ja/channels)に到着するメッセージ。`server` はソース MCP サーバー名です。 |1480| `channel` | [チャネル](/docs/ja/channels)に到着するメッセージ。`server` はソース MCP サーバー名です。 |

1483| `peer` | 別のエージェントからのメッセージ。プロセス内の [teammate](/ja/agent-teams) が `SendMessage` 経由で `main` に送信する場合、`from` は teammate の名前で、`senderTaskId` はそのタスク ID です。別のローカル Claude Code プロセスなどのクロスセッションピアの場合、`from` は送信者アドレスで、`senderTaskId` は存在しません。{/* min-version: 2.1.205 */}`name` と `body` には Claude Code v2.1.205 以降が必要です。`name` は送信者の表示名で、Claude Code によって正規化されます：Unicode 制御、形式、サロゲート、および行または段落区切り文字コードポイントを削除し、結果をトリミングして 64 コードポイントで上限に達し、省略記号を付けます。`body` はピアエンベロープを削除したデコードされたメッセージ本体で、モデルが見るものとバイト単位で正確です。teammate メッセージの場合、`body` は常に存在します。クロスセッションピアの場合、ターンが Claude Code によって形成された正確に 1 つのピアエンベロープである場合にのみ存在します。メッセージテキストを再解析する代わりに、`name` と `body` をレンダリングします。 |1481| `peer` | 別のエージェントからのメッセージ。プロセス内の [teammate](/docs/ja/agent-teams) が `SendMessage` 経由で `main` に送信する場合、`from` は teammate の名前で、`senderTaskId` はそのタスク ID です。別のローカル Claude Code プロセスなどのクロスセッションピアの場合、`from` は送信者アドレスで、`senderTaskId` は存在しません。`name` と `body` には Claude Code v2.1.205 以降が必要です。`name` は送信者の表示名で、Claude Code によって正規化されます：Unicode 制御、形式、サロゲート、および行または段落区切り文字コードポイントを削除し、結果をトリミングして 64 コードポイントで上限に達し、省略記号を付けます。`body` はピアエンベロープを削除したデコードされたメッセージ本体で、モデルが見るものとバイト単位で正確です。teammate メッセージの場合、`body` は常に存在します。クロスセッションピアの場合、ターンが Claude Code によって形成された正確に 1 つのピアエンベロープである場合にのみ存在します。メッセージテキストを再解析する代わりに、`name` と `body` をレンダリングします。 |

1484| `task-notification` | バックグラウンドタスク完了後に注入される合成ターン。[`SDKTaskNotificationMessage`](#sdktasknotificationmessage) を参照してください。 |1482| `task-notification` | バックグラウンドタスク完了後に注入される合成ターン。[`SDKTaskNotificationMessage`](#sdktasknotificationmessage) を参照してください。 |

1485| `coordinator` | [エージェントチーム](/ja/agent-teams)のチームコーディネーターからのメッセージ。 |1483| `coordinator` | [エージェントチーム](/docs/ja/agent-teams)のチームコーディネーターからのメッセージ。 |

1486| `auto-continuation` | セッションが新しいユーザー入力なしで続行するときに注入される合成ターン（コマンド結果がフォローアッププロンプトをトリガーするなど）。 |1484| `auto-continuation` | セッションが新しいユーザー入力なしで続行するときに注入される合成ターン（コマンド結果がフォローアッププロンプトをトリガーするなど）。 |

1487 1485 

1488<h2 id="hook-types">1486<h2 id="hook-types">

1489 フック型1487 フック型

1490</h2>1488</h2>

1491 1489 

1492フックの使用に関する包括的なガイド、例、一般的なパターンについては、[フックガイド](/ja/agent-sdk/hooks) を参照してください。1490フックの使用に関する包括的なガイド、例、一般的なパターンについては、[フックガイド](/docs/ja/agent-sdk/hooks) を参照してください。

1493 1491 

1494<h3 id="hookevent">1492<h3 id="hookevent">

1495 `HookEvent`1493 `HookEvent`

1598};1596};

1599```1597```

1600 1598 

1601`prompt_id` フィールドは、現在処理中のユーザープロンプトを識別する UUID です。[OpenTelemetry イベントの `prompt.id` 属性](/ja/monitoring-usage#event-correlation-attributes) と一致し、最初のユーザー入力まで存在しません。Claude Code v2.1.196 以降が必要です。1599`prompt_id` フィールドは、現在処理中のユーザープロンプトを識別する UUID です。[OpenTelemetry イベントの `prompt.id` 属性](/docs/ja/monitoring-usage#event-correlation-attributes) と一致し、最初のユーザー入力まで存在しません。Claude Code v2.1.196 以降が必要です。

1602 1600 

1603<h4 id="pretoolusehookinput">1601<h4 id="pretoolusehookinput">

1604 `PreToolUseHookInput`1602 `PreToolUseHookInput`

2069};2067};

2070```2068```

2071 2069 

2072実行中にユーザーに明確化の質問をします。使用方法の詳細については、[承認とユーザー入力を処理](/ja/agent-sdk/user-input#handle-clarifying-questions) を参照してください。2070実行中にユーザーに明確化の質問をします。使用方法の詳細については、[承認とユーザー入力を処理](/docs/ja/agent-sdk/user-input#handle-clarifying-questions) を参照してください。

2073 2071 

2074<h3 id="bash">2072<h3 id="bash">

2075 Bash2073 Bash

2108};2106};

2109```2107```

2110 2108 

2111バックグラウンドソースを実行し、各イベントを Claude に配信するため、ポーリングなしで反応できます。`command` はスクリプトを実行し、stdout 行ごとに 1 つのイベントを発行し、`ws` は WebSocket を開き、テキストフレームごとに 1 つのイベントを発行します。`command` または `ws` のいずれか正確に 1 つを指定してください。{/* min-version: 2.1.195 */}`ws` ソースには Claude Code v2.1.195 以降が必要です。2109バックグラウンドソースを実行し、各イベントを Claude に配信するため、ポーリングなしで反応できます。`command` はスクリプトを実行し、stdout 行ごとに 1 つのイベントを発行し、`ws` は WebSocket を開き、テキストフレームごとに 1 つのイベントを発行します。`command` または `ws` のいずれか正確に 1 つを指定してください。`ws` ソースには Claude Code v2.1.195 以降が必要です。

2112 2110 

2113セッション長のウォッチ（ログテールなど）の場合は `persistent: true` を設定します。Monitor がコマンドを実行する場合、Bash と同じパーミッションルールに従います。WebSocket ウォッチは別途承認を求めます。動作とプロバイダーの可用性については、[Monitor ツールリファレンス](/ja/tools-reference#monitor-tool) を参照してください。2111セッション長のウォッチ（ログテールなど）の場合は `persistent: true` を設定します。Monitor がコマンドを実行する場合、Bash と同じパーミッションルールに従います。WebSocket ウォッチは別途承認を求めます。動作とプロバイダーの可用性については、[Monitor ツールリファレンス](/docs/ja/tools-reference#monitor-tool) を参照してください。

2114 2112 

2115<h3 id="taskoutput">2113<h3 id="taskoutput">

2116 TaskOutput2114 TaskOutput

2232};2230};

2233```2231```

2234 2232 

2235ID でバックグラウンドタスクまたはシェルを停止します。{/* min-version: 2.1.198 */}v2.1.198 以降、`task_id` はエージェントチームのチームメイト、またはエージェント ID または名前で名前付きバックグラウンドエージェントも受け入れます。2233ID でバックグラウンドタスクまたはシェルを停止します。v2.1.198 以降、`task_id` はエージェントチームのチームメイト、またはエージェント ID または名前で名前付きバックグラウンドエージェントも受け入れます。

2236 2234 

2237<h3 id="notebookedit">2235<h3 id="notebookedit">

2238 NotebookEdit2236 NotebookEdit

2299};2297};

2300```2298```

2301 2299 

2302[動的ワークフロー](/ja/workflows) を実行します。これは多くのサブエージェントをバックグラウンドで調整し、1 つの統合結果を返すスクリプトです。`Workflow` ツールは Agent SDK v0.3.149 以降で利用可能です。`script`、`name`、または `scriptPath` の少なくとも 1 つが必要です。2300[動的ワークフロー](/docs/ja/workflows) を実行します。これは多くのサブエージェントをバックグラウンドで調整し、1 つの統合結果を返すスクリプトです。`Workflow` ツールは Agent SDK v0.3.149 以降で利用可能です。`script`、`name`、または `scriptPath` の少なくとも 1 つが必要です。

2303 2301 

2304| フィールド | 型 | 説明 |2302| フィールド | 型 | 説明 |

2305| ----------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |2303| ----------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

2328進捗を追跡するための構造化タスクリストを作成および管理します。2326進捗を追跡するための構造化タスクリストを作成および管理します。

2329 2327 

2330<Note>2328<Note>

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

2332</Note>2330</Note>

2333 2331 

2334<h3 id="taskcreate">2332<h3 id="taskcreate">

2568 2566 

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

2570 2568 

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

2572 2570 

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

2574 2572 

2934前のタスクリストと更新されたタスクリストを返します。2932前のタスクリストと更新されたタスクリストを返します。

2935 2933 

2936<Note>2934<Note>

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

2938</Note>2936</Note>

2939 2937 

2940<h3 id="taskcreate-2">2938<h3 id="taskcreate-2">

3228```3226```

3229 3227 

3230| フィールド | 型 | 説明 |3228| フィールド | 型 | 説明 |

3231| :------------------------- | :----------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |3229| :------------------------- | :----------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3232| `value` | `string` | API 呼び出しで渡すモデル識別子 |3230| `value` | `string` | API 呼び出しで渡すモデル識別子 |

3233| `resolvedModel` | `string \| undefined` | このエントリの `value` が解決される正規のワイヤモデル ID。`sonnet` などのエイリアスエントリは `claude-sonnet-5` などの明示的なモデル ID に解決されるため、ホストは保存された明示的なモデル ID をそれをカバーするエイリアスエントリと照合できます。{/* min-version: 2.1.197 */}Claude Code v2.1.197 以降が必要です。 |3231| `resolvedModel` | `string \| undefined` | このエントリの `value` が解決される正規のワイヤモデル ID。`sonnet` などのエイリアスエントリは `claude-sonnet-5` などの明示的なモデル ID に解決されるため、ホストは保存された明示的なモデル ID をそれをカバーするエイリアスエントリと照合できます。Claude Code v2.1.197 以降が必要です。 |

3234| `displayName` | `string` | 人間が読める表示名 |3232| `displayName` | `string` | 人間が読める表示名 |

3235| `description` | `string` | モデルの機能の説明 |3233| `description` | `string` | モデルの機能の説明 |

3236| `supportsEffort` | `boolean \| undefined` | このモデルが努力レベルをサポートするかどうか |3234| `supportsEffort` | `boolean \| undefined` | このモデルが努力レベルをサポートするかどうか |

3325 `ModelUsage`3323 `ModelUsage`

3326</h3>3324</h3>

3327 3325 

3328結果メッセージで返されるモデルごとの使用統計。`costUSD` 値はクライアント側の推定です。請求に関する注意事項については、[コストと使用状況を追跡](/ja/agent-sdk/cost-tracking) を参照してください。3326結果メッセージで返されるモデルごとの使用統計。`costUSD` 値はクライアント側の推定です。請求に関する注意事項については、[コストと使用状況を追跡](/docs/ja/agent-sdk/cost-tracking) を参照してください。

3329 3327 

3330```typescript theme={null}3328```typescript theme={null}

3331type ModelUsage = {3329type ModelUsage = {

3390 `CallToolResult`3388 `CallToolResult`

3391</h3>3389</h3>

3392 3390 

3393MCP ツール結果型（`@modelcontextprotocol/sdk/types.js` から）。`structuredContent` は `content` と一緒に返すことができる JSON オブジェクトで、画像ブロックを含みます。詳細は [構造化データを返す](/ja/agent-sdk/custom-tools#return-structured-data) を参照してください。3391MCP ツール結果型（`@modelcontextprotocol/sdk/types.js` から）。`structuredContent` は `content` と一緒に返すことができる JSON オブジェクトで、画像ブロックを含みます。詳細は [構造化データを返す](/docs/ja/agent-sdk/custom-tools#return-structured-data) を参照してください。

3394 3392 

3395```typescript theme={null}3393```typescript theme={null}

3396type CallToolResult = {3394type CallToolResult = {

3740 3738 

3741起動時には何も発行されません。セッションの CLI プロセスが開始または再開されるたびに空のセットにリセットし、次のメンバーシップ変更でそれを再入力させてください。3739起動時には何も発行されません。セッションの CLI プロセスが開始または再開されるたびに空のセットにリセットし、次のメンバーシップ変更でそれを再入力させてください。

3742 3740 

3743{/* min-version: 2.1.203 */}Claude Code v2.1.203 以降が必要です。3741Claude Code v2.1.203 以降が必要です。

3744 3742 

3745```typescript theme={null}3743```typescript theme={null}

3746type SDKBackgroundTasksChangedMessage = {3744type SDKBackgroundTasksChangedMessage = {

3760 `SDKThinkingTokensMessage`3758 `SDKThinkingTokensMessage`

3761</h3>3759</h3>

3762 3760 

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

3764 3762 

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

3766 3764 

3767```typescript theme={null}3765```typescript theme={null}

3768type SDKThinkingTokensMessage = {3766type SDKThinkingTokensMessage = {

3815};3813};

3816```3814```

3817 3815 

3818{/* min-version: 2.1.181 */}`errorCode` が `"credits_required"` の場合、拒否は含まれた使用量が枯渇した claude.ai サブスクリプションからのもので、ユーザーが使用クレジットを購入するまでセッションは続行できません。`canUserPurchaseCredits` は認証されたユーザーがアカウントのクレジットを購入できるかどうかを示し、`hasChargeableSavedPaymentMethod` は保存された支払い方法がファイルにあるかどうかを示します。3 つのフィールドすべてはクレジット必須の拒否ではないレート制限イベントには存在しません。Claude Code v2.1.181 以降が必要です。3816`errorCode` が `"credits_required"` の場合、拒否は含まれた使用量が枯渇した claude.ai サブスクリプションからのもので、ユーザーが使用クレジットを購入するまでセッションは続行できません。`canUserPurchaseCredits` は認証されたユーザーがアカウントのクレジットを購入できるかどうかを示し、`hasChargeableSavedPaymentMethod` は保存された支払い方法がファイルにあるかどうかを示します。3 つのフィールドすべてはクレジット必須の拒否ではないレート制限イベントには存在しません。Claude Code v2.1.181 以降が必要です。

3819 3817 

3820<h3 id="sdklocalcommandoutputmessage">3818<h3 id="sdklocalcommandoutputmessage">

3821 `SDKLocalCommandOutputMessage`3819 `SDKLocalCommandOutputMessage`

3879};3877};

3880```3878```

3881 3879 

3882{/* min-version: 2.1.203 */}SDK の公開された型定義は Claude Code v2.1.203 以降で `SDKConversationResetMessage` を宣言しています。v2.1.203 より前では、`SDKMessage` は型を宣言せずに参照していたため、`skipLibCheck` が無効な場合、`type === "conversation_reset"` での絞り込みは型チェックに失敗しました。3880SDK の公開された型定義は Claude Code v2.1.203 以降で `SDKConversationResetMessage` を宣言しています。v2.1.203 より前では、`SDKMessage` は型を宣言せずに参照していたため、`skipLibCheck` が無効な場合、`type === "conversation_reset"` での絞り込みは型チェックに失敗しました。

3883 3881 

3884<h3 id="aborterror">3882<h3 id="aborterror">

3885 `AbortError`3883 `AbortError`

3930| `ripgrep` | `{ command: string; args?: string[] }` | `undefined` | サンドボックス環境のカスタム ripgrep バイナリ設定 |3928| `ripgrep` | `{ command: string; args?: string[] }` | `undefined` | サンドボックス環境のカスタム ripgrep バイナリ設定 |

3931 3929 

3932<Note>3930<Note>

3933 サンドボックスはプラットフォームサポートに依存し、Linux では `bubblewrap` や `socat` などのツールが必要です。`enabled` が `true` でサンドボックスが起動できない場合、`query()` は `subtype: "error_during_execution"` の `result` メッセージを報告し、理由を `errors` に含めます。単一メッセージの `query()` 呼び出しの場合、SDK はそのエラー結果を生成した後にスローするため、ループを try ブロックでラップして、それを超えて続行してください。エラーコントラクトについては [結果を処理する](/ja/agent-sdk/agent-loop#handle-the-result) を参照してください。3931 サンドボックスはプラットフォームサポートに依存し、Linux では `bubblewrap` や `socat` などのツールが必要です。`enabled` が `true` でサンドボックスが起動できない場合、`query()` は `subtype: "error_during_execution"` の `result` メッセージを報告し、理由を `errors` に含めます。単一メッセージの `query()` 呼び出しの場合、SDK はそのエラー結果を生成した後にスローするため、ループを try ブロックでラップして、それを超えて続行してください。エラーコントラクトについては [結果を処理する](/docs/ja/agent-sdk/agent-loop#handle-the-result) を参照してください。

3934 3932 

3935 代わりにサンドボックス外で実行するには、`failIfUnavailable: false` を設定してください。3933 代わりにサンドボックス外で実行するには、`failIfUnavailable: false` を設定してください。

3936</Note>3934</Note>

3972 `SandboxNetworkConfig`3970 `SandboxNetworkConfig`

3973</h3>3971</h3>

3974 3972 

3975サンドボックスモードのネットワーク固有の設定。これらの設定は、親の [`SandboxSettings`](#sandboxsettings) で `enabled` が `true` の場合、サンドボックス化された Bash コマンドに適用されます。WebFetch ツールには適用されず、代わりに [パーミッションルール](/ja/permissions#webfetch) を使用します。3973サンドボックスモードのネットワーク固有の設定。これらの設定は、親の [`SandboxSettings`](#sandboxsettings) で `enabled` が `true` の場合、サンドボックス化された Bash コマンドに適用されます。WebFetch ツールには適用されず、代わりに [パーミッションルール](/docs/ja/permissions#webfetch) を使用します。

3976 3974 

3977```typescript theme={null}3975```typescript theme={null}

3978type SandboxNetworkConfig = {3976type SandboxNetworkConfig = {

3991| :------------------------ | :--------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |3989| :------------------------ | :--------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

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

3994| `allowManagedDomainsOnly` | `boolean` | `false` | 管理設定のみ。[管理設定](/ja/permissions#managed-settings) で設定された場合、管理設定からの `allowedDomains` エントリのみが尊重され、ユーザー、プロジェクト、またはローカル設定からのエントリは無視されます。SDK オプション経由で設定された場合は効果がありません |3992| `allowManagedDomainsOnly` | `boolean` | `false` | 管理設定のみ。[管理設定](/docs/ja/permissions#managed-settings) で設定された場合、管理設定からの `allowedDomains` エントリのみが尊重され、ユーザー、プロジェクト、またはローカル設定からのエントリは無視されます。SDK オプション経由で設定された場合は効果がありません |

3995| `allowLocalBinding` | `boolean` | `false` | プロセスがローカルポートにバインドすることを許可します（例：開発サーバー） |3993| `allowLocalBinding` | `boolean` | `false` | プロセスがローカルポートにバインドすることを許可します（例：開発サーバー） |

3996| `allowUnixSockets` | `string[]` | `[]` | プロセスがアクセスできる Unix ソケットパス（例：Docker ソケット） |3994| `allowUnixSockets` | `string[]` | `[]` | プロセスがアクセスできる Unix ソケットパス（例：Docker ソケット） |

3997| `allowAllUnixSockets` | `boolean` | `false` | すべての Unix ソケットへのアクセスを許可します |3995| `allowAllUnixSockets` | `boolean` | `false` | すべての Unix ソケットへのアクセスを許可します |

3999| `socksProxyPort` | `number` | `undefined` | ネットワークリクエスト用の SOCKS プロキシポート |3997| `socksProxyPort` | `number` | `undefined` | ネットワークリクエスト用の SOCKS プロキシポート |

4000 3998 

4001<Note>3999<Note>

4002 組み込みサンドボックスプロキシは、リクエストされたホスト名に基づいて `allowedDomains` を強制し、TLS トラフィックを終了または検査しないため、[ドメインフロンティング](https://en.wikipedia.org/wiki/Domain_fronting) などの技術がそれをバイパスする可能性があります。詳細は [サンドボックスセキュリティの制限](/ja/sandboxing#security-limitations) を参照し、TLS 終了プロキシの設定については [セキュアなデプロイ](/ja/agent-sdk/secure-deployment#traffic-forwarding) を参照してください。4000 組み込みサンドボックスプロキシは、リクエストされたホスト名に基づいて `allowedDomains` を強制し、TLS トラフィックを終了または検査しないため、[ドメインフロンティング](https://en.wikipedia.org/wiki/Domain_fronting) などの技術がそれをバイパスする可能性があります。詳細は [サンドボックスセキュリティの制限](/docs/ja/sandboxing#security-limitations) を参照し、TLS 終了プロキシの設定については [セキュアなデプロイ](/docs/ja/agent-sdk/secure-deployment#traffic-forwarding) を参照してください。

4003</Note>4001</Note>

4004 4002 

4005<h3 id="sandboxfilesystemconfig">4003<h3 id="sandboxfilesystemconfig">

4077<Warning>4075<Warning>

4078 `dangerouslyDisableSandbox: true` で実行されるコマンドはシステムへの完全なアクセスを持ちます。`canUseTool` ハンドラーがこれらのリクエストを慎重に検証することを確認してください。4076 `dangerouslyDisableSandbox: true` で実行されるコマンドはシステムへの完全なアクセスを持ちます。`canUseTool` ハンドラーがこれらのリクエストを慎重に検証することを確認してください。

4079 4077 

4080 `permissionMode` が `bypassPermissions` に設定され、`allowUnsandboxedCommands` が有効な場合、モデルは承認プロンプトなしにサンドボックス外でコマンドを自律的に実行できます（明示的な [`ask` ルール](/ja/agent-sdk/permissions#how-permissions-are-evaluated) はそれでも強制します）。この組み合わせにより、モデルはサンドボックス分離を静かにエスケープできます。4078 `permissionMode` が `bypassPermissions` に設定され、`allowUnsandboxedCommands` が有効な場合、モデルは承認プロンプトなしにサンドボックス外でコマンドを自律的に実行できます（明示的な [`ask` ルール](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated) はそれでも強制します）。この組み合わせにより、モデルはサンドボックス分離を静かにエスケープできます。

4081</Warning>4079</Warning>

4082 4080 

4083<h2 id="see-also">4081<h2 id="see-also">

4084 関連項目4082 関連項目

4085</h2>4083</h2>

4086 4084 

4087* [SDK 概要](/ja/agent-sdk/overview) - 一般的な SDK 概念4085* [SDK 概要](/docs/ja/agent-sdk/overview) - 一般的な SDK 概念

4088* [Python SDK リファレンス](/ja/agent-sdk/python) - Python SDK ドキュメント4086* [Python SDK リファレンス](/docs/ja/agent-sdk/python) - Python SDK ドキュメント

4089* [CLI リファレンス](/ja/cli-reference) - コマンドラインインターフェース4087* [CLI リファレンス](/docs/ja/cli-reference) - コマンドラインインターフェース

4090* [一般的なワークフロー](/ja/common-workflows) - ステップバイステップガイド4088* [一般的なワークフロー](/docs/ja/common-workflows) - ステップバイステップガイド

12 12 

13確認質問については、Claude が質問とオプションを生成します。あなたの役割は、それらをユーザーに提示して、ユーザーの選択を返すことです。このフローに独自の質問を追加することはできません。ユーザーに何か尋ねる必要がある場合は、アプリケーションロジックで別途実行してください。13確認質問については、Claude が質問とオプションを生成します。あなたの役割は、それらをユーザーに提示して、ユーザーの選択を返すことです。このフローに独自の質問を追加することはできません。ユーザーに何か尋ねる必要がある場合は、アプリケーションロジックで別途実行してください。

14 14 

15コールバックは無期限に保留中のままにすることができます。実行はコールバックが返されるまで一時停止したままであり、SDK はクエリ自体がキャンセルされた場合にのみ待機をキャンセルします。ユーザーがプロセスが合理的に実行し続けることができるより長く応答するのに時間がかかる可能性がある場合、[`defer` フック決定](/ja/hooks#defer-a-tool-call-for-later)を返します。これにより、プロセスを終了して、後で永続化されたセッションから再開できます。15コールバックは無期限に保留中のままにすることができます。実行はコールバックが返されるまで一時停止したままであり、SDK はクエリ自体がキャンセルされた場合にのみ待機をキャンセルします。ユーザーがプロセスが合理的に実行し続けることができるより長く応答するのに時間がかかる可能性がある場合、[`defer` フック決定](/docs/ja/hooks#defer-a-tool-call-for-later)を返します。これにより、プロセスを終了して、後で永続化されたセッションから再開できます。

16 16 

17このガイドでは、各タイプのリクエストを検出し、適切に応答する方法を示します。17このガイドでは、各タイプのリクエストを検出し、適切に応答する方法を示します。

18 18 

44 44 

45コールバックは 2 つのケースで発火します。45コールバックは 2 つのケースで発火します。

46 46 

471. **ツールが承認を必要とする場合**：Claude が [許可ルール](/ja/agent-sdk/permissions)またはモードによって自動承認されていないツールを使用したい場合。`tool_name` でツール（例：`"Bash"`、`"Write"`）を確認します。471. **ツールが承認を必要とする場合**：Claude が [許可ルール](/docs/ja/agent-sdk/permissions)またはモードによって自動承認されていないツールを使用したい場合。`tool_name` でツール（例：`"Bash"`、`"Write"`）を確認します。

482. **Claude が質問をする場合**：Claude が `AskUserQuestion` ツールを呼び出します。`tool_name == "AskUserQuestion"` をチェックして、異なる方法で処理します。`tools` 配列を指定する場合は、これが機能するように `AskUserQuestion` を含めます。詳細は [確認質問を処理する](#handle-clarifying-questions)を参照してください。482. **Claude が質問をする場合**：Claude が `AskUserQuestion` ツールを呼び出します。`tool_name == "AskUserQuestion"` をチェックして、異なる方法で処理します。`tools` 配列を指定する場合は、これが機能するように `AskUserQuestion` を含めます。詳細は [確認質問を処理する](#handle-clarifying-questions)を参照してください。

49 49 

50<Warning>50<Warning>

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

52 52 

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

54</Warning>54</Warning>

55 55 

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

57 57 

58<h2 id="handle-tool-approval-requests">58<h2 id="handle-tool-approval-requests">

59 ツール承認リクエストを処理する59 ツール承認リクエストを処理する

65| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |65| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

66| `toolName` | Claude が使用したいツールの名前（例：`"Bash"`、`"Write"`、`"Edit"`） |66| `toolName` | Claude が使用したいツールの名前（例：`"Bash"`、`"Write"`、`"Edit"`） |

67| `input` | Claude がツールに渡しているパラメーター。内容はツールによって異なります。 |67| `input` | Claude がツールに渡しているパラメーター。内容はツールによって異なります。 |

68| `options`（TS）/ `context`（Python） | 再度プロンプトを表示しないための提案された `PermissionUpdate` エントリを含むオプション `suggestions` とキャンセル信号を含む追加コンテキスト。TypeScript では、`signal` は `AbortSignal` です。Python では、信号フィールドは将来の使用のために予約されています。Python については [`ToolPermissionContext`](/ja/agent-sdk/python#toolpermissioncontext)を参照してください。 |68| `options`（TS）/ `context`（Python） | 再度プロンプトを表示しないための提案された `PermissionUpdate` エントリを含むオプション `suggestions` とキャンセル信号を含む追加コンテキスト。TypeScript では、`signal` は `AbortSignal` です。Python では、信号フィールドは将来の使用のために予約されています。Python については [`ToolPermissionContext`](/docs/ja/agent-sdk/python#toolpermissioncontext)を参照してください。 |

69 69 

70`input` オブジェクトにはツール固有のパラメーターが含まれます。一般的な例：70`input` オブジェクトにはツール固有のパラメーターが含まれます。一般的な例：

71 71 

76| `Edit` | `file_path`、`old_string`、`new_string` |76| `Edit` | `file_path`、`old_string`、`new_string` |

77| `Read` | `file_path`、`offset`、`limit` |77| `Read` | `file_path`、`offset`、`limit` |

78 78 

79完全な入力スキーマについては SDK リファレンスを参照してください。[Python](/ja/agent-sdk/python#tool-input%2Foutput-types) | [TypeScript](/ja/agent-sdk/typescript#tool-input-types)。79完全な入力スキーマについては SDK リファレンスを参照してください。[Python](/docs/ja/agent-sdk/python#tool-input%2Foutput-types) | [TypeScript](/docs/ja/agent-sdk/typescript#tool-input-types)。

80 80 

81この情報をユーザーに表示して、アクションを許可するか拒否するかを決定してから、適切な応答を返すことができます。81この情報をユーザーに表示して、アクションを許可するか拒否するかを決定してから、適切な応答を返すことができます。

82 82 

200</CodeGroup>200</CodeGroup>

201 201 

202<Note>202<Note>

203 Python では、`can_use_tool` は [ストリーミングモード](/ja/agent-sdk/streaming-vs-single-mode)が必要です。有限のメッセージストリームを `query(prompt=generator)` または `ClaudeSDKClient.connect(prompt=async_iterable)` を通じて渡すと、登録されたフックまたはプロセス内 MCP サーバーがストリームを開いたままにしていない限り、SDK は最後のメッセージの後、許可コールバックが呼び出される前にストリームを閉じます。上記の例は、`{"continue_": True}` を返す `PreToolUse` フックでストリームを開いたままにします。プロンプトなしで接続し、`ClaudeSDKClient.query()` を通じてメッセージを送信すると、ストリームは自動的に開いたままになり、フックは不要です。203 Python では、`can_use_tool` は [ストリーミングモード](/docs/ja/agent-sdk/streaming-vs-single-mode)が必要です。有限のメッセージストリームを `query(prompt=generator)` または `ClaudeSDKClient.connect(prompt=async_iterable)` を通じて渡すと、登録されたフックまたはプロセス内 MCP サーバーがストリームを開いたままにしていない限り、SDK は最後のメッセージの後、許可コールバックが呼び出される前にストリームを閉じます。上記の例は、`{"continue_": True}` を返す `PreToolUse` フックでストリームを開いたままにします。プロンプトなしで接続し、`ClaudeSDKClient.query()` を通じてメッセージを送信すると、ストリームは自動的に開いたままになり、フックは不要です。

204</Note>204</Note>

205 205 

206この例では y/n フローを使用しており、`y` 以外の入力は拒否として扱われます。実際には、ユーザーがリクエストを変更したり、フィードバックを提供したり、Claude を完全にリダイレクトしたりできるより豊富な UI を構築する可能性があります。すべての応答方法については [ツールリクエストに応答する](#respond-to-tool-requests)を参照してください。206この例では y/n フローを使用しており、`y` 以外の入力は拒否として扱われます。実際には、ユーザーがリクエストを変更したり、フィードバックを提供したり、Claude を完全にリダイレクトしたりできるより豊富な UI を構築する可能性があります。すべての応答方法については [ツールリクエストに応答する](#respond-to-tool-requests)を参照してください。

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

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

218 218 

219許可する場合、Claude がリクエストした入力でツールが実行されます。ただし、変更された入力を返す場合は、TypeScript では `updatedInput`、Python では `updated_input` を返すことができます。{/* min-version: 2.1.207 */}v2.1.207 より前では、Claude Code は `updatedInput` を省略した許可結果を拒否し、検証エラーでツール呼び出しを拒否していました。219許可する場合、Claude がリクエストした入力でツールが実行されます。ただし、変更された入力を返す場合は、TypeScript では `updatedInput`、Python では `updated_input` を返すことができます。v2.1.207 より前では、Claude Code は `updatedInput` を省略した許可結果を拒否し、検証エラーでツール呼び出しを拒否していました。

220 220 

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

222 222 

247* **承認して記憶**：提案された許可ルールをエコーバックして、一致する呼び出しが次回プロンプトをスキップするようにする247* **承認して記憶**：提案された許可ルールをエコーバックして、一致する呼び出しが次回プロンプトをスキップするようにする

248* **拒否**：ツールをブロックして Claude に理由を伝える248* **拒否**：ツールをブロックして Claude に理由を伝える

249* **代替案を提案**：ブロックするが、ユーザーが望むものに向かって Claude をガイドする249* **代替案を提案**：ブロックするが、ユーザーが望むものに向かって Claude をガイドする

250* **完全にリダイレクト**：[ストリーミング入力](/ja/agent-sdk/streaming-vs-single-mode)を使用して Claude に完全に新しい指示を送信する250* **完全にリダイレクト**：[ストリーミング入力](/docs/ja/agent-sdk/streaming-vs-single-mode)を使用して Claude に完全に新しい指示を送信する

251 251 

252<Tabs>252<Tabs>

253 <Tab title="承認">253 <Tab title="承認">

311 </Tab>311 </Tab>

312 312 

313 <Tab title="承認して記憶">313 <Tab title="承認して記憶">

314 ユーザーが承認し、この種の呼び出しについて再度尋ねられたくない場合。3 番目のコールバック引数は `suggestions` を含み、これは準備完了した [`PermissionUpdate`](/ja/agent-sdk/typescript#permissionupdate) エントリの配列です。`updatedPermissions` で 1 つをエコーバックして適用します。`localSettings` 宛先を持つ提案は、ルールを `.claude/settings.local.json` に書き込むため、将来のセッションは一致する呼び出しのプロンプトをスキップします。314 ユーザーが承認し、この種の呼び出しについて再度尋ねられたくない場合。3 番目のコールバック引数は `suggestions` を含み、これは準備完了した [`PermissionUpdate`](/docs/ja/agent-sdk/typescript#permissionupdate) エントリの配列です。`updatedPermissions` で 1 つをエコーバックして適用します。`localSettings` 宛先を持つ提案は、ルールを `.claude/settings.local.json` に書き込むため、将来のセッションは一致する呼び出しのプロンプトをスキップします。

315 315 

316 Python の例には `claude-agent-sdk` 0.1.80 以降が必要です。316 Python の例には `claude-agent-sdk` 0.1.80 以降が必要です。

317 317