いきなり実行させてから「違う、そうじゃない」と止めるのは、だいたい一番高くつく。Claude Code のプランモードは、その手戻りを先に潰すための道具だ。作業を走らせる前に、方針・手順・危ない点を一回紙に出させる。これを挟むだけで、コンテキストの無駄食いも、雑な一括変更も、かなり減る。
プランモードは「何をするか」を先に固めるために使う。実行そのものを急がない。ここを逆にすると、便利な機能がただの遠回りになる。筆者も最初は、いきなり修正を走らせて、あとから「その前に依存関係を整理してほしかった」と気づいてやり直した。差分が肥大化すると、どこから崩れたのか追うのがだるい。だから先に方針確認だ。
使い方は単純で、最初に「変更はまだしないで、計画だけ出して」と頼む。たとえばコード修正なら、こんなふうに始める。
この作業はまだ実行しないでください。
まず方針を確認したいです。
目的:
- 既存のログ出力を整理したい
- ただし振る舞いは変えすぎたくない
やってほしいこと:
1. 関係するファイルを洗い出す
2. 変更方針を3案くらい出す
3. それぞれのメリット・リスクを書く
4. どの順番で進めるべきか提案する
まだ編集はしないで、計画だけ返してください。
この頼み方のいいところは、「何をしたいか」だけでなく「何を避けたいか」も先に渡せる点だ。Claude Code は指示が曖昧だと、もっともらしいけれど広すぎる作業案を出しがちになる。ログを整えたいだけなのに、関連箇所をまとめて触る計画を返してくる、みたいなやつだ。そういうときは、変更禁止の条件をはっきり書けばいい。
方針案を出す前提として、次はしないでください。
- ファイル構成の大改造
- 挙動変更を伴うリファクタリング
- まとめて置換するだけの雑な修正
できるだけ小さく、安全に進める案を優先してください。
ファイル整理や文書作成でも同じだ。たとえば「案件ごとのフォルダをどう切るか決めたい」「古い書類をまとめたい」「重複していそうなファイルを消す前に、どう分けるべきか確認したい」といった場面で、いきなり削除させると危ない。先に「分類ルール」を作らせるほうがいい。実務でありがちな失敗は、作業を急いで、あとから命名や保管ルールがぐちゃぐちゃになることだ。片づけは終わったのに、次の週には元に戻る。あれが一番むなしい。
非エンジニア向けなら、指示はもっと素直でいい。
このフォルダの中身を整理したいです。
まだ削除や移動はしないで、まず整理方針だけ決めてください。
見たい内容:
- 似た名前のファイルの分け方
- 残すもの、移すもの、捨て候補の基準
- 先に確認したほうがいい危険なファイル
最終的に、手順を短く分かりやすく出してください。
ここで大事なのは、プランモードに「判断」をさせることだ。単なる要約じゃ足りない。判断の根拠まで出させる。たとえばコードなら「この変更はこの3ファイルに閉じられる」「この方法だとテストを先に足すべき」「この依存があるので順番を逆にすると壊れる」といった、実作業の地雷を先に見つけさせる。文書作成でも、「先に見出し案を決めるべき」「用語の統一を先にやるべき」といった段取りの確認が効く。
プランを出させたあと、そのまま走らせず、一回だけ詰めると精度が上がる。ここでの返し方は短くていい。
案Bで進めたいです。
ただし、変更範囲は最小にしてください。
テストや確認手順も先に書いてください。
あるいは、逆にこう切るのもありだ。
この案は広すぎます。
目的に対して、もっと小さい一歩に分け直してください。
こういうやり取りを挟むと、実行時の迷いが減る。いきなり手を動かすより、最初の数分で方向を揃えたほうが、結局は早い。特に Claude Code は、指示の粒度が合っているときに強い。大雑把に投げると、大雑把に返ってくる。そこをプランモードで締めるわけだ。
注意点もある。プランモードを「長い相談モード」みたいに使い続けると、いつまでも決まらない。計画はあくまで実行前の確認だ。方針が固まったら、次はその案で進める。もう一つ、計画だけ出させたつもりでも、依頼文が弱いと曖昧な前提が混ざる。筆者は以前、対象範囲を書かずに整理方針を聞いて、関係ない古い資産まで巻き込む案を返されて冷や汗をかいた。範囲指定をケチると、あとで倍返しになる。ここは本当に気を抜かないほうがいい。
実務でのコツは、最初の一発目に次の3点を入れることだ。目的、やってはいけないこと、確認したい粒度。この3つがあるだけで、プランの質が目に見えて変わる。逆に言うと、ここが抜けているなら、まだ実行に移す段階ではない。
目的:
- 何を終わらせたいか
禁止:
- 何を勝手に変えないでほしいか
粒度:
- どこまで細かい手順がほしいか
- 変更前に確認したい観点は何か
これを癖にすると、Claude Code は「走らせる道具」から「先に事故を減らす相棒」に変わる。修正でも整理でも文書化でも、まず方針を確認する。急がば回れ、だが回り方を雑にしない。それだけで、あとがかなり楽になる。