勢いで走らせると、だいたいあとで直す羽目になる。Claude Code でもそこは同じで、いきなり実行させるより、先に方針だけ確認させたほうがずっと事故が少ない。
プランモードは、作業を始める前に「何をどう進めるつもりか」を先に出させる使い方だ。コード修正でも、フォルダ整理でも、文章のたたき台作りでも効く。しかも、単に相談するだけではなく、こちらが許可した筋道で進ませやすい。やる前に地図を見せる、という感覚に近い。
筆者は最初、普通に「これ直して」「これ整理して」とだけ投げていた。すると、意図は合っていても手順が遠回りだったり、無関係なファイルまで触りそうになったりする。小さな修正ならまだいいが、ディレクトリ全体をまたぐ整理や、文章ファイルの一括整形になると、確認なしで走らせるのはけっこう怖い。そこで先に方針を出させると、手戻りが目に見えて減る。
Claude Code でこれをやるコツは、最初の依頼で「実行」ではなく「計画」を求めることだ。たとえば次のように頼む。
この作業を始める前に、方針だけ先に出してください。
目的、変更対象、進める順番、危ない点、確認したい点を短く整理して。
まだファイルは変更しないでください。
コード整理なら、もう少し具体的にする。
このリポジトリで、古い設定ファイルの整理をしたい。
いきなり変更せず、まずプランを出してほしい。
1. どのファイルを見に行くか
2. どの順番で確認するか
3. 削除候補と保留候補の分け方
4. 先に確認すべき危険ポイント
を挙げてから進めて。
非エンジニアの用途でも同じだ。たとえば大量の文書を整えるなら、こういう頼み方が使いやすい。
このフォルダ内の文書を整理したいです。
まずは作業方針を提案してください。
重複していそうなもの、名前の揺れがありそうなもの、移動の前に確認したいものを分けてください。
まだ移動や削除はしないでください。
ここで大事なのは、「何をしたいか」だけでなく「何をしないか」を最初に言うことだ。Claude Code は頼めば広く動けるぶん、曖昧だと広く見に行く。すると、関係ないファイルまで読んでコンテキストを食うし、そこから先の判断もぶれやすい。最初に「変更しない」「削除しない」「一旦止める」を入れておくと、やり取りが締まる。
一度、筆者はフォルダ整理を「要らないものを片付けて」と雑に頼んで失敗した。こちらはキャッシュや一時ファイルの掃除を想定していたのに、Claude Code は保存済みの資料の扱いまで候補に入れてきた。もちろん、その場で止めれば済む話だが、こういうズレは最初にプランを出させればかなり防げる。特にディスク削減や書類整理は、削除の一歩手前までの確認が命だ。
プランを見たら、そこで遠慮なく直す。遠回しな修正は要らない。だめなものはだめと言う。
その順番だと広すぎる。
先に変更候補を列挙してから、最後に削除判断をしてほしい。
自動で削除はしないで、必ず確認を挟んで。
この「一回止めて、筋を直す」動きがプランモードの肝だ。実行後の差し戻しより、実行前の修正のほうが圧倒的に安い。diff が肥大化する前に止められるし、あとで「なんでここまで触ったんだ」と頭を抱えずに済む。
もう一つ、プランモードを使うときに効くのが、完成形より判断基準を渡すことだ。たとえば文章の下書きなら、こんなふうに置く。
この文章の下書きを作る前に、編集方針を確認したい。
・読み手は非エンジニアもいる
・専門用語は少なめ
・断定はしていいが、事実は盛らない
・不要な重複は削る
まずはこの条件で、どう進めるかを整理して。
この形にしておくと、Claude Code は「何を作るか」だけでなく「どういう基準で作るか」を先に合わせてくる。文章でもコードでも、基準が先に揃っていると、途中でブレにくい。
注意点もある。プランモードは、あくまで方針確認であって、万能の安全装置ではない。プランがよく見えても、実際の作業で予想外の差分が出ることはある。だから、削除や上書きが絡むなら、最後まで丸投げにしない。小分けに進めさせて、そのたびに確認するほうが堅い。特に大量ファイルの整理では、最初の一手を間違えると後戻りが面倒だ。
逆に、プランモードが向いていない場面もある。ほんの一行直すだけの作業で、毎回プランを作らせるのはだるい。そこは普通に頼んでいい。方針確認が効くのは、範囲が広い、影響が大きい、判断が混じる、この三つのどれかがあるときだ。
慣れてきたら、プランモードを「許可の前置き」として使うといい。先に方針を出させ、こちらが筋を直し、納得できたら実行へ進ませる。この流れを作っておくと、Claude Code はただの自動化ツールではなく、やり方を詰める相棒になる。雑に走らせるより、ずっと仕事が軽くなる。