Claude Codeのプランモード｜計画を確認してから実行する

何が変わるのか

重要なのは、プランモードでも調査は行われることです。「何も進まない」わけではなく、ファイルを読んで現状を把握したうえで、具体的な計画が出てきます。判断材料が揃った状態で承認できます。

使うべき場面の目安

毎回プランモードにすると、小さな修正まで承認待ちになって面倒です。実際に運用して落ち着いた目安を挙げます。

• 触るファイルが10個を超えそうなとき──範囲の取り違えに着手前に気づけます
• 削除や移動を含むとき──取り消しにくい操作は必ず計画を見ます
• 初めて触るコードベースのとき──AIの理解が正しいかを、計画の内容から判断できます
• 指示が曖昧だと自覚しているとき──「いい感じに整理して」のような頼み方をした時ほど、計画段階でズレが露見します
• 本番に近い環境のとき──言うまでもありません

逆に、読むだけの調査、1ファイルの小さな修正、対話しながら方向を変えていく作業では通常モードの方が快適です。プランモードは安全装置であって、常時つけるものではありません。

計画が出てきたときの読み方

承認前に見るべきは、次の3点です。

1. 対象範囲──触るファイルの一覧を見ます。想定していないファイルが混ざっていたら、そこで止めます。これだけで事故の大半が防げます
2. やらないことが明示されているか──「◯◯には手を触れない」が書かれているかを見ます。書かれていなければ、承認時に条件として付け足します
3. 前提の理解──計画の書き方から、AIがコードをどう理解しているかが読み取れます。理解が間違っていれば、計画も間違っています

計画が違うと感じたら、そのまま日本語で修正を伝えれば作り直されます。「この範囲は触らないで」「先にテストを書いてから」のような追加条件が、この段階なら安く入れられます。

実際に効いた場面

当サイトの改修でも、十数ページを一度に書き換える作業や、既存URLの構成を変える作業ではプランモードを使いました。特に効いたのは「対象ファイルの一覧を先に見る」という一点です。

実例として、既存ページの構成を整理する作業で、計画に想定していなかったページが含まれていたことがあります。通常モードなら書き換わってから気づく場面でした。承認前だったので、範囲を指定し直すだけで済んでいます。

大量のURLを統合する作業でも同じで、機械的に抽出した候補をそのまま実行させず、計画として一覧で確認してから進めました（その記録）。

他の安全策との組み合わせ

プランモードは単独で使うものではありません。3つの層で考えると設計が楽になります。

この3層があると、任せられる作業の規模が一段上がります。安全策は作業を遅くするためではなく、大きく任せるために置くものです。