useAutoModeDuringPlanとは — Plan mode中の審査を切り替える設定

useAutoModeDuringPlanとは何か

Claude CodeのPlan mode(計画モード)は、ファイルを編集せずに調査と計画づくりだけを行うモードです。編集は止まりますが、調査のためのBashコマンドは実行する必要があります。useAutoModeDuringPlanは、そのBashコマンドをどう審査するかを決めるbool型の設定です。settings.jsonのPermission settingsに属し、/configには「Use auto mode during plan」として表示されます。

既定値はtrueです。auto modeが利用できるアカウントでは、Plan mode中のBashコマンドはauto modeの分類器(classifier)が審査し、承認されたコマンドはプロンプトなしで実行されます。falseに変更すると、組み込みの読み取り専用コマンド以外のすべてのコマンドで、実行前に確認を求められるようになります。

trueとfalseで実際に何が変わるか

差は「誰が承認するか」の一点に絞られます。

auto modeが利用できないアカウントでは、trueにしていても効果はありません。この場合はPlan mode中も読み取り専用コマンド以外はすべて確認プロンプト扱いになり、falseのときと同じ挙動になります。auto modeの利用条件は次の4点です。

条件を満たしているかはuseAutoModeDuringPlanの値そのものより優先して確認する価値があります。値をtrueのまま変えていないのに毎回確認を求められる場合、原因は設定ではなくauto modeの利用可否にあることが多いためです。auto modeの判定内容そのものはauto mode分類器は何を止めているかで扱っています。

設定できる場所とできない場所

useAutoModeDuringPlanのスコープは「User、Local、Managed」で、プロジェクト共有のsettings.jsonは対象外です。

{
  "useAutoModeDuringPlan": false
}

上記を書けるのは~/.claude/settings.json(User)・.claude/settings.local.json(Local)・組織のmanaged settingsの3か所だけです。リポジトリで共有する.claude/settings.jsonにこのキーを書いても無視され、チームメンバーの挙動は変わりません。個人の作業スタイルか組織のポリシーとして決める設定で、プロジェクト側から強制する対象にはなっていません。

falseにしても止まらないコマンドがある

falseにすると「読み取り専用コマンド以外」が確認対象になりますが、この読み取り専用コマンドの集合はPlan mode固有ではなく、Claude Code全体で共通の組み込みリストです。次のコマンドはfalseでもプロンプトなしで実行されます。

このリストは設定で増減できません。個別のコマンドをさらに確認対象にしたいときは、/permissionsコマンドでpermissions.askにルールを追加します。逆にfindやsedのように書き込み系フラグを持つコマンドは、上のリストに含まれていても、クォートしないglobパターンを渡すとfalseかどうかによらず確認を求められます。globが-deleteのような書き込みフラグに展開しうるためです。

この挙動が今の形になった経緯

useAutoModeDuringPlanが制御している「分類器が承認したコマンドをプロンプトなしで通す」という挙動そのものには、2026年7月に短い空白期間がありました。v2.1.212で、Plan mode中にtouchやrmのようなファイル変更コマンドが確認なしに実行されてしまう不具合が修正されましたが、この修正はPlan mode全体で分類器による承認ショートカットを一時的に止める形で行われました。v2.1.212からv2.1.217までは、auto modeが利用できるかどうかにかかわらず、読み取り専用セット以外の全コマンドが確認プロンプトの対象になっていました。v2.1.218で、静的解析が読み取り専用と証明できないBashコマンドを確認なしで通さない形に改められ、分類器による審査が改めて既定の挙動として戻りました。

現在のtrueの既定動作は、このv2.1.218で復元された挙動と同じです。falseはこの経緯とは別に用意された選択肢で、分類器を信頼せず常に自分で確認したい利用者のための切り替えです。

分類器はPlan mode中に何を通し何を止めるか

trueのときPlan mode中のBashコマンドを審査するのは、通常モードのauto modeと同じ分類器です。判断基準もほぼ共通で、代表的なコマンドで見ると次のように分かれます。

trueとfalseの違いは「プロンプトが出るか出ないか」だけでなく、「拒否されたコマンドがそもそも実行されないか、確認さえすれば実行できるか」という点にも及びます。分類器がブロックする操作はtrueでは実行前に止まりますが、falseでは利用者が確認プロンプトで許可すれば実行されてしまいます。慎重さを優先するならfalseが安全というわけではなく、最終判断が利用者に委ねられるだけという違いです。

Bashコマンド以外にも及ぶ範囲

useAutoModeDuringPlanがtrueのとき、分類器の審査対象はBashコマンドだけではありません。Claude CodeがサブエージェントへSendMessageでメッセージを送る操作も、Plan mode中は同じ分類器を経由します(v2.1.222以降)。対象は平文のメッセージと、agent teams機能の構造化メッセージの両方です。調査を複数のsub-agentに分担させながらPlan modeで進めるワークフローでは、コマンドの審査だけでなくエージェント間のメッセージ授受にも同じ切り替えが影響します。

サンドボックスのauto-allowとは別の仕組み

Bashコマンドをコンテナ等に隔離して自動実行する「サンドボックスのauto-allowモード」は、useAutoModeDuringPlanとは独立した機能です。通常モードではサンドボックスの境界に閉じ込められたコマンドがプロンプトなしで実行されますが、Plan mode中はこのauto-allowが承認範囲を広げません。Plan mode中にサンドボックス化されたコマンドを実行してよいかどうかは、サンドボックスの設定ではなくuseAutoModeDuringPlanとauto modeの分類器が決めます。

この境界線もv2.1.212で引き直されました。それ以前はPlan mode中でもサンドボックスのauto-allowがそのままプロンプトを省略していましたが、v2.1.212以降はPlan mode中のBashに対するask ruleがサンドボックス化されたコマンドにも適用されるようになり、読み取り専用のコマンドを含めて確認対象になり得る形に変わりました。サンドボックスを有効にしていても、Plan mode中の審査を分類器任せにするか都度確認するかは、結局useAutoModeDuringPlanの値で決まります。

関連する設定とどう役割が違うか

Plan mode中の確認まわりには、似た名前の設定がいくつかあります。役割はそれぞれ別です。

autoMode.classifyAllShellはPlan mode専用ではなく、Bash(npm test)のような個別コマンドを許可するallowルールが分類器を素通りしてしまう抜け穴を塞ぐための設定です。Plan mode中の挙動だけを変えたいならuseAutoModeDuringPlan、通常モードも含めてシェルコマンド全体を分類器に回したいならautoMode.classifyAllShellと、対象範囲で使い分けます。

falseにする判断はどこに置かれているか

useAutoModeDuringPlanがProject設定から締め出されている設計は、他の多くのpermissions関連キーと対照的です。permissions.allowやpermissions.askはリポジトリで共有してチームの挙動を揃えられますが、Plan mode中に分類器を信じるかどうかは共有ルールにできません。組織として一律に確認を挟ませたいならmanaged settingsで固定し、個人の判断で慎重にしたいならUserまたはLocalの設定に書く、という2択に絞られています。

分類器の判定基準そのものを細かく調整したい場合は、useAutoModeDuringPlanをfalseにするより、autoModeのsoft_deny・hard_denyルールを編集するほうが筋が良い選択です。falseは「分類器を経由させない」という全か無かの切り替えで、特定のコマンドだけを確認対象にする細かい制御はできません。

よくある質問

useAutoModeDuringPlanをfalseにすると、Plan modeを使う意味は薄れるか

薄れません。Plan modeの本体は「編集をブロックして計画を承認制にする」仕組みで、Bashコマンドの確認方法はその一部です。falseにしても編集のブロックと計画の承認フローはそのまま働きます。

/configから変更できるか

できます。/configの設定一覧に「Use auto mode during plan」として表示され、トグルで切り替えられます。設定ファイルを直接編集する方法と同じキーを書き換えます。

まとめ

useAutoModeDuringPlanは、Plan mode中のBashコマンドをauto modeの分類器に審査させるか、都度自分で確認するかを切り替える設定です。既定のtrueでは分類器が承認したコマンドがそのまま実行され、falseにすると読み取り専用コマンド以外のすべてが確認プロンプトの対象に戻ります。プロジェクト共有の設定ファイルからは変更できず、Userまたはmanaged settingsで個人か組織の判断として決める設計です。bypass permissionsが使えるセッションでは設定自体が働かないため、慎重な確認を徹底したいなら別の権限モードと組み合わせる必要があります。