長文を一気に書かせて、あとで整えればいい——このやり方、たいてい途中で崩れる。Claude Code は便利だが、雑に丸投げすると、前半で決めた言い回しが後半で勝手にズレたり、同じ話を二度書いたりする。長い文章ほど、分割執筆、章立て執筆に切り替えたほうがいい。
これは開発の話だけではない。仕様書、手順書、社内向けの案内文、案件ごとのメモ整理、重複した文章の圧縮まで、長文を扱う場面は多い。章ごとに作らせると、各パートの狙いがぶれにくくなるし、直しやすい。全文を一発で出させるより、最後まで読める下書きになりやすい。
やり方は単純だ。最初に全体構成を作らせ、そのあとで章単位に書かせる。ここで大事なのは、「最初から完成文を求めない」ことだ。完成品を一気に欲しがると、Claude Code は広い文脈を抱えたまま無難な文章を量産しがちになる。結果、どこかで力尽きる。筆者はこれで、序盤は切れ味があるのに後半だけ急に総論っぽくなる下書きを何度も踏んだ。あれは直すのがだるい。
たとえば、こんな流れにする。
この文章を章ごとに分けて下書きしたい。先に全体の章立てを提案して。
条件:
- 読者は非エンジニアも含む
- 文章は長め
- 各章は役割が被らないようにする
- まずは見出し案だけでいい
章立てが出てきたら、次に一章ずつ頼む。
第2章だけを下書きして。
この章の目的は「長文を一気に書かせると崩れる理由」を説明すること。
次の点を必ず入れる:
- 途中で話が重複しやすい
- 指示の意図が後半で薄れる
- 修正時に全文差し替えになりやすい
文体は常体。読み物として自然に。
さらに安定させたいなら、各章の前に短い役割文を置くといい。
第3章の役割は「実際の頼み方を見せること」。
ここでは説明よりも、コピペできる依頼文を中心に書いて。
この「役割を先に言う」やり方が効く。Claude Code は指示が具体的なほど迷わない。逆に「いい感じに長文を書いて」で投げると、何を優先するかが曖昧なまま走る。そこが手戻りの元だ。
よくある失敗もはっきりしている。まず、章ごとに分けたつもりで、毎回同じ前置きを入れてしまうこと。たとえば各章の冒頭で「ここでは〜について説明する」と書きすぎると、文章がのっぺりする。必要なのは説明の重複ではなく、章の役割の分離だ。もうひとつは、前の章の内容を次の章でまた要約させること。これは見た目はつながるが、トークンを食うし、冗長になる。前章の要点は短く参照し、本文は新しい情報に寄せたほうがいい。
筆者が一度やらかしたのは、長い社内文書を「とりあえず全文で」と頼んだことだ。前半はまあ読めるのに、後半で急に話が散った。しかも修正指示を入れるたびに、関係ない章まで巻き込んで書き換わる。分割していれば、直すのはその章だけで済んだ。長文は、作るより直すほうが面倒になる。だから最初から章で切る。
非エンジニア用途でも同じだ。たとえば、案件ファイルを整理するときに「先にフォルダ構成、その次に各フォルダの中身の命名規則、そのあと不要ファイルの洗い出し」と分けると、混乱が減る。文書作成も同じで、序盤に全体像、次に各章、最後に整形、という順にしたほうが崩れない。いきなり全部を同時にやらせると、何でも入ったが何も伝わらない文になる。
章ごとに作らせるときは、各章の終わりで一度止めるのも大事だ。自動で次へ進ませず、次の指示を出す前に「この章で決めたいことは何か」を確認する。そうすると、長文でも軸がぶれない。Claude Code に長文を任せるコツは、才能を期待することではなく、迷わない形で区切ることだ。
最後に一つだけ。章立て執筆は、細かくしすぎると逆に遅い。1 段落ごとに止めると、編集の手間ばかり増える。大きな文章なら章、短めの文書なら節。そこは割り切る。長文の下書きは、全部を一度に押し出すより、区切って進めたほうが結局早い。Claude Code を使うなら、この手間をケチらないほうがいい。