小说文件夹与CLAUDE.md写作规则怎么写？用编程工具写长篇的目录与台账

本篇目录 9 节

先说结论：文件夹分四类，规则文件写硬约束，台账每章更新

Claude Code、Cursor、Codex CLI 原本是写代码的工具，但越来越多作者拿它们写小说。原因很实在：它们能读写整个文件夹，一次改动可以跨几十个文件，改坏了也有办法回退（Claude Code、Cursor 自带检查点，Codex CLI 官方建议用 Git 建检查点），适合管理一本有上百个文件的长篇。

用它们写小说，公开实践里大致收敛到同一套做法：

1. 设定、人物、大纲、正文四类文件分开放；
2. 根目录放一个规则文件（Claude Code 用 CLAUDE.md，Codex 用 AGENTS.md，Cursor 用 .cursor/rules 下的规则文件），写硬约束；
3. 另建一组台账（人物状态、伏笔、时间线），每章写完更新，作为"现在故事走到哪了"的统一依据；
4. 用 Git 或工具自带的检查点管理版本。

下面逐项讲，最后说什么时候换成写作软件更省事。本文提到的公开实践均核对于 2026-10-11。

文件夹结构：一个可以直接照抄的骨架

参考公开项目和教程，一个中文长篇的目录可以这样建：

• CLAUDE.md（或 AGENTS.md）：规则文件
• 设定/：世界观.md、力量体系.md、势力.md、地点.md
• 人物/：每个重要人物一个文件，如 林遥.md
• 大纲/：总纲.md、卷纲/第一卷.md、章纲/001.md……
• 正文/：001-雨夜.md、002-入门.md……
• 台账/：人物状态.md、伏笔.md、时间线.md、进度.md
• 文风/：样例段落.md
• 归档/：退场人物、旧地点

几个细节：

• 章节文件名用三位数字开头。 中文章节名按字母排序会乱，掘金上一篇用 Cursor 写长篇的文章就提到过这个问题，最后只好写脚本合并章节（来源）。"001-雨夜.md"这样的命名能避开。
• 一个文件只放一个人物或一类设定。 文件小，AI 每次只读需要的那几个，Cursor 官方论坛上分享 Buckram Studio 的作者就是这样做的，写哪章就引用哪几个文件（来源）。
• 作者写的和 AI 写的分开。 一篇 CSDN 教程把目录分成两半：作者维护的硬约束（文风、整体设定、核心角色、主线）和 AI 维护的台账（章节状态、人物时间线、伏笔、角色线），前者 AI 不许改（来源）。

CLAUDE.md 写什么：只写每次都要遵守的事

规则文件按各工具的加载规则生效，写得越长，占用的上下文越多，所以要短，只写硬约束。可以包含这些要点：

• 一句话介绍这本书：题材、视角、目标读者；
• 写章前必读的文件：本章章纲、出场人物卡、台账里的人物状态、前两章正文；
• 写作硬规则：人称和视角、每章字数范围、禁用的套话和句式；
• 写完一章必须做的事：更新人物状态、伏笔、时间线、进度四个台账；
• 不许改的文件：设定和人物卡只能由作者改，AI 发现冲突时列出来，不擅自修改；
• 冲突时以谁为准：正文已写的事实优先于大纲，台账以最新一章为准。

篇幅上要克制。以 Codex 为例，官方文档写明 AGENTS.md 合计大小默认上限为 32 KiB（来源）；Codex 官方建议必须遵守的规则放进 AGENTS.md，不要只依赖记忆功能（来源）；Cursor 文档也说明模型在两次补全之间不保留记忆，规则用来提供持久的上下文（来源）。

台账：长篇能不能写下去的关键

规则文件管"怎么写"，台账管"现在写到哪了"。公开项目里比较成熟的做法有三点：

• 只认一个事实来源。 oh-story-claudecode 把追踪状态放在一个文件里，作为结构化状态的总来源，另有一份固定栏目、有大小上限的"上下文"摘要（来源）。webnovel-writer 同样把总纲、卷纲、时间线、章纲和状态索引分开存放（来源）。
• "作者知道的"和"读者知道的"分开记。 oh-story-claudecode 这样做，是为了防止人物提前知道答案。
• 每章写完就更新。 人物状态（在哪、伤势、实力、知道什么）、伏笔（埋在哪章、何时收）、时间线（书中过了多少天）。Reddit 上一位用 Claude 写完 30 万词长篇的作者，为每个角色记录了"在各个时间点知道什么"，并让 Claude Code 跨上百个文件做连续性检查（来源）。

版本：检查点之外，还要有 Git

• Claude Code 每次提示会自动建检查点，可以用 /rewind 回退，官方文档写明保留最近 100 个（来源）。
• Cursor 的检查点存在本地、与 Git 分开，官方建议长期版本管理用 Git（来源）。
• Codex CLI 官方建议在任务前后建 Git 检查点，以便回退（来源）。

所以比较稳妥的习惯是：每写完一章提交一次 Git，提交说明写章节号。

公开实践里反复出现的问题

整理这些公开教程和讨论，几个问题出现得比较多：

• 对话一长就"糊"。 Buckram Studio 的作者提到，两百条消息的长对话会出现上下文退化、成本上升、重复和泛泛的文字（来源）；掘金那篇文章也说经常"忘了小说设定"。
• 人设和文风漂移。 CSDN 教程的原话是"主角能力忽强忽弱，像换了人"；Reddit 那位作者提到写到第 80 章已经没有第 12 章的节奏，需要反复重新提供样例段落。
• 用量和成本。 让 AI 逐个合并文件会很快用完额度（来源）。
• 对非程序员有门槛。 同一篇文章提到 VS Code 对非程序员"听起来就吓人"；另一篇文章认为不需要计算机学位也能上手，同时判断多数作者会主要使用聊天界面（来源）。

这些问题都有办法缓解：文件拆小、台账每章更新、每章只读需要的文件、定期开新对话。代价是作者要自己设计目录、写规则、维护台账、看文件对比。

什么时候换成小说写作软件

编程智能体给你的是完全的控制权：文件在本地，结构自己定，换模型、换工具都方便。喜欢这种方式、熟悉终端和 Git 的作者，用它写小说是很好的选择。

出现下面几种情况时，可以考虑换成专门的写作软件：

• 维护台账和规则文件花的时间，开始超过写正文的时间；
• 不熟悉终端、Git，每次看改动都要琢磨文件对比；
• 想在网页或手机上随时写，不想绑在一台电脑上；
• 想看人物卡、目录、伏笔列表，而不是一堆 Markdown 文件；
• 网络或账号条件受限。 例如 Claude 官方支持地区列表未包含中国大陆，这一限制覆盖 Claude.ai、Claude Code 和 API（来源）。

马良写作把哪些步骤自动化了

上面的目录、规则和台账，马良写作是这样对应的：

• 四类文件各有位置。 人物、设定、伏笔、故事线是左侧设定栏里的一张张卡片；总纲单独存放；文风样本、开书资料是「文档」里的文档。AI 写作时按需读取，你看到的是卡片和目录，不用自己维护文件夹。
• 台账由档案员整理。 章节写完、这一段写作结束后，档案员按正文整理故事档案：人物状态、关系、位置、伏笔。和既有设定对不上的地方列进「待确认」，由你决定按哪边改。不想要可以在「档案」里关闭。
• 对比和撤回在编辑器里。 AI 改过的正文直接标出删除和新增，可以逐处保留或还原；不满意可以撤销本轮、从本轮之前另起分支，或修改后重发。分支和原对话共用同一份书稿。

• 正文交给写手。 续写时写手只拿这一章需要的材料：章纲、相关人物设定、前文、文风样本。
• 按卷收起旧设定。 写到新一卷时，只在前几卷出场的人物、地点、伏笔会被收进归档，AI 写新章时不再参考，需要时仍能查到。
• 网页直接用，不用安装。

两种方式的详细比较见 Claude Code 与马良写作对比、编程智能体与小说写作软件怎么选和文件夹与结构化写作怎么选。

常见问题

Q：Claude Code 能写小说吗？
能。它能读写整个文件夹、跨文件修改，自带检查点可以回退，已经有作者用 Claude 写正文、用 Claude Code 做跨文件检查，完成了长篇。需要你自己设计目录、写 CLAUDE.md、维护人物状态和伏笔台账。

Q：CLAUDE.md 应该写什么？
只写每次都要遵守的事：这本书的一句话介绍、写章前必读的文件、写作硬规则、写完一章要更新的台账、哪些文件不许 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、想在网页或手机上写、或者更习惯看卡片而不是文件时，可以考虑换成专门的小说写作软件。