Claude Code に頼むとき、同じ一文に「何がどうなっているか説明して」と「ついでに直して」まで詰め込むと、返ってくる作業の焦点がぼやけます。
この TIPS は、依頼を「説明」「修正」「整理」に分けて投げるだけで、やり取りの手戻りを減らすためのものです。特に、ファイル整理や文書作成のように、コード以外の作業でも効きます。
Claude Code は、たしかに一度にいろいろ頼めます。ですが、全部を同じ粒度で混ぜると、どこまでが現状把握で、どこからが変更作業なのかが曖昧になります。曖昧なまま進むと、意図しない修正をしたり、説明は合っているのに直し方がずれたりします。
人が隣で仕事を受けるときと同じで、「まず現状を見て」「次に直して」と順番を切るほうが、結果が安定します。
まずは、頼み方を分けるところから始めます。たとえば、文章の推敲ならこうです。
この文書の構成を説明して。まだ直さないで。気になる点だけ箇条書きで挙げて。
次に、説明を受けたあとで修正を頼みます。
さっき挙げた気になる点のうち、語尾の重複だけ直して。内容は変えないで。
この二段階にすると、Claude Code が「どこを見ているのか」が揃います。最初の段階では観察に徹し、二段階目で作業に入る。小さなことですが、長い文書ほど差が出ます。議事録、契約の下書き、社内手順書、README のように、内容を壊したくない文書では特に有効です。
ファイル整理でも同じです。たとえば、散らかったフォルダを見せて一気に片づけさせたくなりますが、先に「説明」、後で「実行」に分けるほうが安全です。
このフォルダの中身を見て、重複しやすそうなものと不要そうなものを説明して。削除はしないで。
次に、削除候補のうちキャッシュだけを対象に、削除してよいものを提案して。
ここで大事なのは、最初の依頼に「直して」を入れないことです。「説明して」と「直して」を同時に言うと、返答の途中で修正が始まり、判断材料としての説明が見えにくくなります。
とくに非エンジニアの作業では、何が変わるのかを先に把握したい場面が多いはずです。いきなり削除や書き換えに進まず、まず現状を言葉にさせる。これだけで安心感がかなり違います。
逆に、修正を急ぐ場面では、説明を短くして作業に寄せます。
この文書の見出しレベルだけ整えて。理由の説明は短くていい。内容は変えないで。
このフォルダ名を、意味が伝わる短い名前に直して。候補は3案だけ出して。
「説明して」が長くなりすぎると、作業の指示が埋もれます。そこを避けるために、最初に自分で目的を決めておくとよいです。
見たいのか、変えたいのか。両方必要なら、順番を決める。これだけです。
少し実務寄りに言うと、粒度を揃えるとは「1 回の依頼で動かすレバーを 1 本にする」ことです。
たとえば弁護士や事務職の人が案件フォルダを整理するとき、「この案件フォルダの構成を説明して」と「PDF を整理して命名ルールをそろえて」を同時に投げるより、まず構成を見せ、次に命名だけを直すほうが、途中で判断がぶれません。
大量の資料を扱う作業ほど、説明と修正を同じ文に混ぜない価値が出ます。
この考え方をそのまま使うなら、依頼文は次の形に寄せると扱いやすいです。
1. まず現状を説明して。
2. まだ変更しないで。
3. 問題点を挙げて。
4. そのあとで、指定した範囲だけ直して。
あるいは、最初から「どちらを優先するか」を宣言してもよいです。
今回は説明が優先。直す提案は最後にまとめて。
今回は修正が優先。途中の説明は最小限にして、必要なら差分だけ示して。
こう書くだけで、Claude Code は役割を取り違えにくくなります。
反対に避けたいのは、こんな頼み方です。
この文章を説明しながら直して、ついでに読みやすくして。
これだと「何を説明するのか」「どこまで直すのか」「どのくらい変えていいのか」が全部あいまいです。読みやすく、の一言も曲者で、語尾なのか段落構成なのか、言い回しなのかが決まりません。結果として、返答も広く浅くなりがちです。
うまくいくコツは、修正の対象を小さく切ることです。文体、見出し、ファイル名、不要ファイル、コメント、表記ゆれ。ひとつずつなら、Claude Code はかなり素直に動きます。
最初は面倒に見えますが、実際にはこちらの確認回数が減ります。直してほしいものだけが直り、見たいものだけが見えるからです。
もし迷ったら、次の順で頼んでください。
まず「説明して、まだ直さないで」。
次に「ここだけ直して」。
最後に必要なら「今の変更を確認して」。
この切り分けは、コードでも文書でも、フォルダ整理でも同じように効きます。Claude Code をうまく使う人ほど、たくさん頼むのではなく、依頼の粒度を揃えています。