権限の設定

Claude Agent SDKは、Claudeがツールを使用する方法を管理するための権限制御を提供します。権限モードとルールを使用して自動的に許可される内容を定義し、canUseTool コールバックを使用してランタイムでその他すべてを処理します。

権限の評価方法

Claudeがツールをリクエストすると、SDKは以下の順序で権限をチェックします：

このページでは権限モード（ステップ3）、つまりデフォルトの動作を制御する静的設定に焦点を当てています。その他のステップについては：

• フック：カスタムコードを実行してツールリクエストを許可、拒否、または変更します。フックによる実行制御を参照してください。
• 権限ルール：settings.jsonで宣言的な許可/拒否ルールを設定します。権限設定を参照してください。
• canUseTool コールバック：ランタイムでユーザーに承認を求めます。承認とユーザー入力の処理を参照してください。

権限モード

権限モードは、Claudeがツールを使用する方法をグローバルに制御します。query()を呼び出す際に権限モードを設定するか、ストリーミングセッション中に動的に変更できます。

利用可能なモード

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

権限モードの設定

クエリを開始する際に権限モードを一度設定するか、セッションがアクティブな間に動的に変更できます。

モードの詳細

編集承認モード（acceptEdits）

ファイル操作を自動承認するため、Claudeはプロンプトなしでコードを編集できます。その他のツール（ファイルシステム操作ではないBashコマンドなど）は通常の権限が必要です。

自動承認される操作：

• ファイル編集（Edit、Writeツール）
• ファイルシステムコマンド：mkdir、touch、rm、mv、cp

使用する場面： Claudeの編集を信頼し、より高速なイテレーションを望む場合。プロトタイピング中や隔離されたディレクトリで作業する場合など。

権限バイパスモード（bypassPermissions）

プロンプトなしですべてのツール使用を自動承認します。フックは引き続き実行され、必要に応じて操作をブロックできます。

計画モード（plan）

ツールの実行を完全に防止します。Claudeはコードを分析して計画を作成できますが、変更を加えることはできません。Claudeは計画を確定する前に要件を明確にするためにAskUserQuestionを使用する場合があります。これらのプロンプトの処理については、承認とユーザー入力の処理を参照してください。

使用する場面： Claudeに変更を実行せずに提案させたい場合。コードレビュー中や、変更が行われる前に承認が必要な場合など。

関連リソース

権限評価フローのその他のステップについて：

• 承認とユーザー入力の処理：インタラクティブな承認プロンプトと明確化の質問
• フックガイド：エージェントライフサイクルの重要なポイントでカスタムコードを実行
• 権限ルール：settings.jsonでの宣言的な許可/拒否ルール