長文を一気に投げて、あとで「どこまでやったんだっけ」となるのは、かなりありがちな失敗だ。Claude Code は賢いが、長い作業を雑に渡せば、平気で話が横に広がる。だから最初から章立てして、途中の迷子を減らす。別名で言えば、章ごとに分けて頼む、長文を分割して進める、だ。
このやり方は、コード修正だけの話ではない。散らかったフォルダの整理、重複ファイルの洗い出し、長い文書の清書、案件ごとの資料整理にもそのまま効く。要するに、ひと続きに見える作業を、Claude Code が追いやすい単位に切るという話である。
筆者は最初、ひと塊の依頼文で全部やらせて失敗した。途中で方針がブレるし、出力も冗長になる。修正のたびに前半の指示が薄まり、後半だけやけに詳しい、みたいなアンバランスも起きる。長い作業ほど、章ごとに切ったほうが早い。これは気分論ではなく、コンテキストの使い方の問題だ。
やり方は単純だ。まず作業全体を、人間の目で見て4〜6章くらいに割る。たとえば文書作成なら、「材料の整理」「目次づくり」「本文の下書き」「用語の統一」「最終確認」に分ける。ファイル整理なら、「現状の棚卸し」「重複候補の抽出」「不要物の判定」「移動・削除」「結果確認」に分ける。ここで大事なのは、各章が“ひとことで説明できる仕事”になっていることだ。曖昧な章は、そのまま曖昧な出力を呼ぶ。
Claude Code への頼み方も、最初から章を宣言したほうがいい。たとえば文書ならこんな感じだ。
この作業は5章に分けて進めたい。
第1章: 既存資料の要点を拾って整理する
第2章: 目次案を作る
第3章: 各章の下書きを作る
第4章: 表現を統一する
第5章: 誤字や抜けを確認する
まず第1章だけやって。終わったら止まって、次に進める前に確認したい。
これだけで、いきなり全部を完成させにいく暴走をかなり抑えられる。特に長文の執筆では、最初の指示に混ぜ込んだ細かい条件が後半で抜け落ちやすい。章ごとに区切ると、今どの指示が有効なのかが明確になる。
もう少し実務寄りにするなら、各章の最後に「成果物」と「確認ポイント」をセットで書いておくといい。たとえばこんな感じだ。
第2章では、次の2点を出してほしい。
- 章立ての案
- 各章で何を書くかの短い説明
この段階では本文は書かなくていい。
この書き方はかなり効く。Claude Code は頼めば先に進むが、頼まれていない粒度まで勝手に埋めることがある。逆に、今は見出しだけ欲しいのか、本文まで欲しいのかをはっきり分けると、無駄な出力が減る。結果として、修正対象も小さくなる。diff が膨らんで目が死ぬ、あのいやな感じを避けやすい。
長い作業を章立てするときに、やってはいけないのは「章は分けたが、各章の関係を説明しない」ことだ。たとえば「第3章で本文を書く」とだけ言われると、Claude Code は第1章や第2章とのつながりを取りこぼすことがある。なので、各章の冒頭に、前の章の成果を一行で引き継がせるのがいい。
第3章では、第2章で決めた見出し構成に沿って本文を作る。
前章で確定した見出し名は変えない。
これを入れるだけで、章の途中で勝手に構成をいじる事故がかなり減る。筆者もここを甘く見て、何度か手戻りした。章ごとに分けたつもりで、実は各章の依存関係を渡していなかったのだ。すると後の章で、前の章の前提が微妙にずれている、という地味に痛い状態になる。
ファイル整理でも同じだ。いきなり「このフォルダ全部を片付けて」と投げるより、こう切るほうが安全だ。
次の順で進めてほしい。
第1章: このフォルダの中身を種類ごとに棚卸しする
第2章: 重複ファイル候補を洗い出す
第3章: 残してよさそうなものと、削除候補を分ける
第4章: 実際の移動や削除は、私の確認後に行う
まず第1章だけ実行して、結果を一覧で出して。
特に削除が絡む仕事は、章立てがほぼ必須だ。1回で全部やらせると、確認の前に不可逆な操作へ進みかねない。Claude Code に限らず、こういう作業は「調べる」「提案する」「実行する」を分けるのが基本である。
章立てをうまく使うコツは、章の数を増やしすぎないことでもある。細かく切りすぎると、今度は段取りの管理がだるくなる。迷ったら、次のどちらかで切るといい。ひとつは「情報を集める章」と「手を動かす章」に分けること。もうひとつは「壊していい変更」と「確認が要る変更」を分けることだ。この2軸は、文書でもファイル整理でも、かなり外さない。
そして最後に、各章の終わりで止める習慣をつけることだ。Claude Code に「続けて」と言う前に、一度こちらが見直す。ここを飛ばすと、章立てした意味が薄れる。長い作業は、途中で迷子になった瞬間に手戻りが大きくなる。だから、止まりどころを先に決める。これだけで、作業の疲れ方がかなり変わる。
長文の依頼や大きな整理作業を投げるときは、最初から完成形を一気に狙わないほうがいい。章立てして、章ごとに確認する。Claude Code を使うときの地味だが強いコツは、だいたいここに尽きる。