小説フォルダとCLAUDE.mdの書き方：プログラミングツールで長編を書く
プログラミングツールで長編を書くときのフォルダ分け、CLAUDE.mdの内容、人物と伏線の台帳を解説。Claude Code・Cursor・Codex CLI対応。執筆ソフトに替える目安も紹介します。
この記事の目次 9セクション
まず結論：フォルダは4種類に分け、ルールファイルには強い制約を書き、台帳は1章ごとに更新する
Claude Code、Cursor、Codex CLIはもともとコードを書くためのツールですが、これらで小説を書く作者がどんどん増えています。理由は現実的です：フォルダ全体を読み書きでき、1回の変更が数十のファイルにまたがり、壊れても戻す手段があり（Claude CodeとCursorにはチェックポイントが付属し、Codex CLIは公式にGitでチェックポイントを作ることを勧めている）、百ものファイルのある長編の管理に向いています。
これらで小説を書くとき、公開されている実践は、おおむね同じやり方に収束しています：
- 設定、人物、プロット、本文の4種類のファイルを分けて置く。
- ルートにルールファイルを1つ置く（Claude CodeはCLAUDE.md、CodexはAGENTS.md、Cursorは.cursor/rules以下のルールファイル）。強い制約を書く。
- 台帳を別に一組作る（人物の状態、伏線、時系列）。1章書き終えるごとに更新し、「今、物語はどこまで進んだか」の統一した根拠にする。
- Gitまたはツールのチェックポイントでバージョンを管理する。
以下、項目ごとに述べ、最後に、どんなときに執筆ソフトに替えると手間が省けるかを述べます。本記事で触れる公開実践は、いずれも2026-10-11に確認しました。
フォルダ構成：そのまま写せる骨組み
公開されているプロジェクトとチュートリアルを参考に、中国語の長編のディレクトリは、こう作れます：
- CLAUDE.md（またはAGENTS.md）：ルールファイル
- 設定/：世界観.md、力の体系.md、勢力.md、地点.md
- 人物/：重要な人物ごとに1ファイル。例：林遥.md
- プロット/：全体プロット.md、巻プロット/第一巻.md、章プロット/001.md……
- 本文/：001-雨夜.md、002-入門.md……
- 台帳/：人物状態.md、伏線.md、時系列.md、進捗.md
- 文体/：サンプル段落.md
- アーカイブ/：退場した人物、古い地点
いくつかの細部：
- 章のファイル名は、3桁の数字で始める。 中国語の章名はアルファベット順に並べると乱れ、掘金のCursorで長編を書いた記事も、この問題に触れており、最後はスクリプトを書いて章を結合するしかなかったとしています（出典）。「001-雨夜.md」のような名前なら避けられます。
- 1つのファイルには、1人の人物か1種類の設定だけを入れる。 ファイルが小さいと、AIは毎回必要な数個だけを読みます。Cursorの公式フォーラムでBuckram Studioを共有した作者もそうしていて、どの章を書くかで、どのファイルを参照するかが決まります（出典）。
- 作者が書いたものと、AIが書いたものを分ける。 あるCSDNのチュートリアルは、ディレクトリを2つに分けています：作者が管理する強い制約（文体、全体設定、中核キャラクター、本筋）と、AIが管理する台帳（章の状態、人物の時系列、伏線、キャラクターの線）で、前者はAIが直してはならない（出典）。
CLAUDE.mdに書く内容：毎回守るべきことだけ
ルールファイルは、各ツールの読み込みルールに従って効きます。長く書くほど、占めるコンテキストが増えるので、短くし、強い制約だけを書きます。次の要点を含められます：
- この本の一言紹介：ジャンル、視点、想定読者。
- 章を書く前に必ず読むファイル：この章の章プロット、登場人物カード、台帳の人物状態、直前2章の本文。
- 執筆の強いルール：人称と視点、1章の字数の範囲、使用禁止の決まり文句と言い回し。
- 1章書き終えたら必ずやること：人物状態、伏線、時系列、進捗の4つの台帳を更新する。
- 直してはいけないファイル：設定と人物カードは作者だけが直し、AIは矛盾を見つけたら挙げるだけで、勝手に直さない。
- 矛盾したときにどちらを優先するか：本文にすでに書いた事実はプロットに優先し、台帳は最新の章に従う。
分量は抑えるべきです。Codexを例にすると、公式ドキュメントには、AGENTS.mdの合計サイズの既定の上限は32 KiBと明記されており（出典）、Codexは、必ず守るべきルールはAGENTS.mdに入れ、記憶機能だけに頼らないよう公式に勧めており（出典）、Cursorのドキュメントも、モデルは2回の補完の間に記憶を保持せず、ルールは持続的なコンテキストを提供するためのものだと説明しています（出典）。
台帳：長編が書き続けられるかどうかの鍵
ルールファイルは「どう書くか」を、台帳は「今どこまで書いたか」を管理します。公開プロジェクトの中で、比較的成熟したやり方は3点あります：
- 事実の出所を1つだけにする。 oh-story-claudecodeは、追跡状態を1つのファイルに置き、構造化された状態の総元にして、ほかに項目が固定され、サイズの上限がある「コンテキスト」の要約を持たせています（出典）。webnovel-writerも同様に、全体プロット、巻プロット、時系列、章プロット、状態インデックスを別々に保存しています（出典）。
- 「作者が知っていること」と「読者が知っていること」を分けて記録する。 oh-story-claudecodeがこうしているのは、人物が答えを先に知ってしまうのを防ぐためです。
- 1章書き終えたらすぐ更新する。 人物の状態（どこにいるか、負傷、実力、何を知っているか）、伏線（どの章で仕込み、いつ回収するか）、時系列（作中で何日経ったか）。Redditで、Claudeで30万語の長編を書き上げた作者は、各キャラクターについて「各時点で何を知っているか」を記録し、Claude Codeに百を超えるファイルをまたいで連続性のチェックをさせていました（出典）。
バージョン：チェックポイントに加えて、Gitも必要
- Claude Codeは、プロンプトのたびに自動でチェックポイントを作り、/rewindで戻せ、公式ドキュメントには直近100個を保持すると明記されています（出典）。
- Cursorのチェックポイントはローカルに保存され、Gitとは別で、公式は長期のバージョン管理にはGitを勧めています（出典）。
- Codex CLIは、タスクの前後でGitのチェックポイントを作り、戻せるようにすることを公式に勧めています（出典）。
そのため、比較的確実な習慣は：1章書き終えるごとにGitにコミットし、コミットメッセージに章番号を書くことです。
公開実践で繰り返し出てくる問題
これらの公開チュートリアルと議論を整理すると、いくつかの問題が比較的多く出てきます：
- 会話が長くなると「ぼやける」。 Buckram Studioの作者は、200件のメッセージの長い会話では、コンテキストの劣化、コストの上昇、重複、漠然とした文章が出ると述べており（出典）、掘金のあの記事も、よく「小説の設定を忘れる」と言っています。
- キャラ設定と文体のぶれ。 CSDNのチュートリアルの原文は「主人公の能力が強くなったり弱くなったりして、別人のようだ」で、Redditのあの作者は、第80章まで書くと、第12章のテンポがもうなくなっていて、サンプル段落を繰り返し与え直す必要があったと述べています。
- 使用量とコスト。 AIにファイルを1つずつ結合させると、枠はすぐに使い切られます（出典）。
- プログラマー以外にはハードルがある。 同じ記事は、VS Codeは非プログラマーには「聞くだけで怖い」と述べ、別の記事は、コンピュータの学位がなくても始められるとしつつ、多くの作者は主にチャットインターフェースを使うだろうと判断しています（出典）。
これらの問題は、どれも緩和できます：ファイルを小さく分け、台帳を1章ごとに更新し、1章ごとに必要なファイルだけを読ませ、定期的に新しい会話を開く。代償は、作者が自分でディレクトリを設計し、ルールを書き、台帳を維持し、ファイルの差分を見ることです。
どんなときに小説執筆ソフトに替えるか
プログラミングエージェントがあなたに与えるのは、完全な制御権です：ファイルはローカルにあり、構造は自分で決められ、モデルの交換もツールの交換も便利です。この方式が好きで、ターミナルとGitに慣れた作者にとって、これで小説を書くのは良い選択です。
次のような状況が出たら、専用の執筆ソフトに替えることを検討できます：
- 台帳とルールファイルの維持にかける時間が、本文を書く時間を超え始めた。
- ターミナルやGitに慣れておらず、変更を見るたびにファイルの差分を考え込む。
- ウェブやスマートフォンでいつでも書きたく、1台のパソコンに縛られたくない。
- Markdownファイルの山ではなく、人物カード、目次、伏線リストを見たい。
- ネットワークやアカウントの条件に制限がある。 たとえば、Claudeの公式のサポート地域リストには中国本土が含まれておらず、この制限は、Claude.ai、Claude Code、APIに及びます（出典）。
Maliang Writerは、どの手順を自動化しているか
上記のディレクトリ、ルール、台帳に、Maliang Writerはこう対応しています：
- 4種類のファイルが、それぞれの場所にある。 人物、設定、伏線、ストーリーラインは、左側の設定欄の1枚1枚のカードで、全体プロットは別に保存され、文体サンプルと作品開始時の資料は「ドキュメント」の中のドキュメントです。AIは執筆時に必要に応じて読み、あなたに見えるのはカードと目次で、自分でフォルダを管理する必要はありません。
- 台帳は記録係が整理する。 章を書き終え、この区間の執筆が終わると、記録係が本文に沿ってストーリーアーカイブを整理します：人物の状態、関係、位置、伏線。既存の設定と合わない箇所は「確認待ち」に挙がり、どちらに合わせて直すかをあなたが決めます。不要なら「アーカイブ」でオフにできます。
- 比較と取り消しはエディタにある。 AIが直した本文は、削除と追加が直接示され、1か所ずつ保持または元に戻せます。気に入らなければ、このラウンドを取り消す、このラウンドの前から別の枝を作る、または直して再送信ができます。枝は元の会話と同じ原稿を共有します。
- 本文は執筆エージェントに任せる。 続きを書くとき、執筆エージェントはこの章に必要な資料だけを受け取ります：章プロット、関連する人物設定、前の本文、文体サンプル。
- 巻ごとに古い設定をしまう。 新しい巻を書くとき、前の数巻にしか登場しない人物、地点、伏線はアーカイブにしまわれ、AIが新しい章を書くときは参照されなくなり、必要なときには調べられます。
- ウェブでそのまま使え、インストール不要。
2つの方式の詳しい比較は、Claude CodeとMaliang Writerの比較、プログラミングエージェントと小説執筆アプリの選び方、フォルダと構造化執筆の選び方を見てください。
よくある質問
Q：Claude Codeで小説は書けますか？
書けます。フォルダ全体を読み書きでき、ファイルをまたいで修正でき、付属のチェックポイントで戻せます。すでに、Claudeで本文を書き、Claude Codeでファイルをまたぐチェックをして、長編を完成させた作者もいます。ディレクトリの設計、CLAUDE.mdの記述、人物状態と伏線の台帳の維持は、自分で行う必要があります。
Q：CLAUDE.mdには何を書くべきですか？
毎回守るべきことだけを書きます：この本の一言紹介、章を書く前に必ず読むファイル、執筆の強いルール、1章書き終えたら更新する台帳、AIに直させてはいけないファイル、矛盾したときにどちらを優先するか。簡潔に保ちます。
Q：Cursorで小説を書くとき、ルールはどう設定しますか？
プロジェクトの.cursor/rulesディレクトリにルールファイルを作り、必読ファイルと強いルールをはっきり書きます。AGENTS.mdを使うこともできます。設定と人物は小さなファイルに分け、どの章を書くかで、どのファイルを参照するかを決めます。Cursorのチェックポイントはローカルに保存され、公式は長期のバージョンはGitで管理することを勧めています。
Q：Codex CLIで小説は書けますか？
書けます。やり方はClaude Codeに似ています：AGENTS.mdでルールを書き、ディレクトリで設定、プロット、本文を整理します。公式ドキュメントには、AGENTS.mdの合計サイズの既定の上限は32 KiBと明記されており、ルールは精錬して書く必要があります。
Q：Claude Codeで小説を書くのに、プログラミングはできる必要がありますか？
コードを書く必要はありませんが、ターミナルやエディタに慣れ、ファイルとディレクトリの管理が少しわかっていて、Gitでバージョンを管理できると、より便利です。これらにまったく不慣れな作者には、慣れるまでの期間があります。
Q：中国でClaude Codeは使えますか？
Claudeの公式のサポート地域リストには中国本土が含まれておらず、この説明は、Claude.ai、Claude Code、APIに及びます。具体的には公式ページに従ってください。
Q：いつ、プログラミングエージェントから執筆ソフトに替えるべきですか？
台帳とルールの維持にかける時間が本文を書く時間を超えたとき、ターミナルとGitを使いたくないとき、ウェブやスマートフォンで書きたいとき、あるいはファイルよりカードを見るほうに慣れているときは、専用の小説執筆ソフトに替えることを検討できます。