Carpeta de novela y reglas CLAUDE.md para escribir con IA

En este artículo 9 secciones

Primero, la conclusión: carpetas en cuatro tipos, reglas duras en el archivo de reglas y registros actualizados en cada capítulo

Claude Code, Cursor y Codex CLI son herramientas pensadas para escribir código, pero cada vez más autores las usan para escribir novelas. El motivo es muy práctico: pueden leer y escribir toda una carpeta, un cambio puede abarcar decenas de archivos y, si algo sale mal, hay formas de retroceder (Claude Code y Cursor traen puntos de control integrados, y Codex CLI recomienda oficialmente crearlos con Git), lo que sirve para gestionar una novela larga con cientos de archivos.

Al escribir novelas con ellas, las prácticas públicas convergen más o menos en el mismo método:

1. Ajustes, personajes, esquema y texto en cuatro tipos de archivos separados;
2. Un archivo de reglas en la raíz (Claude Code usa CLAUDE.md, Codex usa AGENTS.md y Cursor usa archivos de reglas bajo .cursor/rules), con restricciones duras;
3. Un conjunto aparte de registros (estado de los personajes, pistas sembradas, cronología), que se actualiza al terminar cada capítulo y sirve de referencia única de «hasta dónde ha llegado la historia ahora»;
4. Gestionar las versiones con Git o con los puntos de control de la propia herramienta.

A continuación se explica punto por punto y, al final, cuándo conviene pasar a un software de escritura. Las prácticas públicas mencionadas en este artículo se comprobaron el 11 de octubre de 2026.

Estructura de carpetas: un esqueleto que se puede copiar directamente

Tomando como referencia proyectos y tutoriales públicos, el directorio de una novela larga en chino puede crearse así:

• CLAUDE.md (o AGENTS.md): archivo de reglas
• ajustes/: mundo.md, sistema-de-poder.md, facciones.md, lugares.md
• personajes/: un archivo por cada personaje importante, como lin-yao.md
• esquema/: esquema-general.md, volumenes/volumen-1.md, capitulos/001.md...
• texto/: 001-noche-de-lluvia.md, 002-ingreso-en-la-secta.md...
• registros/: estado-personajes.md, pistas.md, cronologia.md, progreso.md
• estilo/: pasajes-modelo.md
• archivo/: personajes retirados, lugares viejos

Algunos detalles:

• Los nombres de archivo de los capítulos empiezan por un número de tres cifras. Los nombres de capítulo en chino se ordenan mal alfabéticamente; un artículo de Juejin sobre escribir una novela larga con Cursor menciona este problema, y al final hubo que escribir un script para unir los capítulos (fuente). Nombres como «001-noche-de-lluvia.md» lo evitan.
• Un archivo contiene solo un personaje o un tipo de ajuste. Con archivos pequeños, la IA lee cada vez solo los que necesita; el autor que presentó Buckram Studio en el foro oficial de Cursor lo hace así, citando solo los archivos del capítulo que escribe (fuente).
• Lo que escribe el autor y lo que escribe la IA van separados. Un tutorial de CSDN divide el directorio en dos mitades: las restricciones duras que mantiene el autor (estilo, ajustes generales, personajes centrales, línea principal) y los registros que mantiene la IA (estado de los capítulos, cronología de personajes, pistas sembradas, líneas de personajes); la primera mitad la IA no puede modificarla (fuente).

Qué escribir en CLAUDE.md: solo lo que hay que cumplir siempre

El archivo de reglas surte efecto según las reglas de carga de cada herramienta; cuanto más largo, más contexto ocupa, así que debe ser corto y contener solo restricciones duras. Puede incluir estos puntos:

• Una frase que presente el libro: género, punto de vista, lector objetivo;
• Los archivos que hay que leer antes de escribir un capítulo: el esquema del capítulo, las fichas de los personajes que aparecen, el estado de los personajes en los registros, el texto de los dos capítulos anteriores;
• Reglas duras de escritura: persona y punto de vista, rango de palabras por capítulo, tópicos y estructuras prohibidos;
• Lo que hay que hacer al terminar un capítulo: actualizar los cuatro registros de estado de los personajes, pistas sembradas, cronología y progreso;
• Archivos que no se pueden cambiar: los ajustes y las fichas de personaje solo los cambia el autor; cuando la IA encuentre un conflicto, lo lista y no cambia nada por su cuenta;
• A quién se da la razón en un conflicto: los hechos ya escritos en el texto tienen prioridad sobre el esquema, y los registros se rigen por el último capítulo.

Hay que ser comedido con la extensión. Tomando Codex como ejemplo, la documentación oficial indica que el tamaño total de AGENTS.md tiene por defecto un límite de 32 KiB (fuente); Codex recomienda oficialmente poner en AGENTS.md las reglas de obligado cumplimiento y no depender solo de la función de memoria (fuente); y la documentación de Cursor también explica que el modelo no conserva memoria entre dos compleciones, y que las reglas sirven para proporcionar contexto persistente (fuente).

Registros: la clave para poder seguir escribiendo una novela larga

El archivo de reglas se ocupa de «cómo escribir» y los registros de «hasta dónde se ha escrito». En los proyectos públicos, las prácticas más maduras tienen tres puntos:

• Una sola fuente de hechos. oh-story-claudecode guarda el seguimiento del estado en un archivo, como fuente total del estado estructurado, además de un resumen de «contexto» con apartados fijos y un límite de tamaño (fuente). webnovel-writer también guarda por separado el esquema general, el de volúmenes, la cronología, el esquema de capítulos y el índice de estado (fuente).
• Se anota por separado «lo que sabe el autor» y «lo que sabe el lector». oh-story-claudecode lo hace así para evitar que los personajes conozcan la respuesta antes de tiempo.
• Se actualiza al terminar cada capítulo. El estado de los personajes (dónde están, heridas, nivel de poder, qué saben), las pistas sembradas (en qué capítulo se plantaron, cuándo se cierran) y la cronología (cuántos días han pasado en el libro). Un autor de Reddit que terminó con Claude una novela larga de 300 000 palabras registró para cada personaje «qué sabe en cada momento» y pidió a Claude Code que hiciera comprobaciones de continuidad en cientos de archivos (fuente).

Versiones: además de los puntos de control, hace falta Git

• Claude Code crea un punto de control automáticamente con cada petición y se puede retroceder con /rewind; la documentación oficial indica que conserva los últimos 100 (fuente).
• Los puntos de control de Cursor se guardan en local, separados de Git, y la recomendación oficial es usar Git para la gestión de versiones a largo plazo (fuente).
• Codex CLI recomienda oficialmente crear puntos de control con Git antes y después de las tareas, para poder retroceder (fuente).

Por eso, el hábito más seguro es: hacer un commit de Git al terminar cada capítulo, con el número de capítulo en el mensaje.

Problemas que se repiten en las prácticas públicas

Al reunir estos tutoriales y debates públicos, aparecen con bastante frecuencia varios problemas:

• Cuando la conversación se alarga, todo se «empasta». El autor de Buckram Studio menciona que en conversaciones largas de doscientos mensajes hay degradación del contexto, subida de costes, repeticiones y texto genérico (fuente); el artículo de Juejin también dice que a menudo «se olvida de los ajustes de la novela».
• Deriva de personajes y de estilo. Las palabras textuales del tutorial de CSDN son «la capacidad del protagonista sube y baja, como si hubiera cambiado de persona»; el autor de Reddit menciona que hacia el capítulo 80 ya no tenía el ritmo del capítulo 12 y había que volver a dar pasajes modelo una y otra vez.
• Consumo y costes. Pedir a la IA que una archivos de uno en uno agota rápidamente la cuota (fuente).
• Barrera para quien no es programador. El mismo artículo menciona que VS Code «suena aterrador» para quien no programa; otro artículo considera que se puede empezar sin un título de informática y, al mismo tiempo, juzga que la mayoría de los autores usará sobre todo la interfaz de chat (fuente).

Todos estos problemas tienen forma de atenuarse: archivos más pequeños, registros actualizados en cada capítulo, leer en cada capítulo solo los archivos necesarios y abrir conversaciones nuevas periódicamente. El precio es que el autor tiene que diseñar el directorio, escribir las reglas, mantener los registros y mirar las comparaciones de archivos.

Cuándo pasar a un software de escritura de novelas

Los agentes de programación te dan control total: los archivos están en local, la estructura la defines tú y cambiar de modelo o de herramienta es fácil. Para los autores a quienes les gusta esta forma de trabajar y conocen el terminal y Git, escribir novelas con ellos es una buena opción.

En estos casos se puede plantear pasar a un software de escritura específico:

• El tiempo dedicado a mantener los registros y el archivo de reglas empieza a superar el dedicado a escribir el texto;
• No conoces el terminal ni Git, y cada vez que miras los cambios tienes que descifrar una comparación de archivos;
• Quieres escribir en cualquier momento en la web o en el móvil, sin estar atado a un solo ordenador;
• Quieres ver fichas de personajes, el índice y la lista de pistas sembradas, y no un montón de archivos Markdown;
• Las condiciones de red o de cuenta son limitadas. Por ejemplo, la lista oficial de regiones compatibles de Claude no incluye la China continental, y esta restricción abarca Claude.ai, Claude Code y la API (fuente).

Qué pasos automatiza Maliang Writer

Así corresponden a Maliang Writer los directorios, reglas y registros anteriores:

• Los cuatro tipos de archivos tienen su sitio. Los personajes, ajustes, pistas sembradas y líneas argumentales son fichas de la barra lateral de ajustes; el esquema general se guarda aparte; las muestras de estilo y los materiales de inicio del libro son documentos de «Documentos». La IA los lee según hace falta al escribir, y tú ves fichas y un índice, sin tener que mantener carpetas.
• Los registros los organiza el archivista. Cuando se termina un capítulo y concluye ese tramo de escritura, el archivista organiza los archivos de la historia según el texto: estado de los personajes, relaciones, posiciones y pistas sembradas. Los puntos que no cuadran con los ajustes existentes se listan en «Pendiente de confirmación», y tú decides hacia qué lado se cambia. Si no los quieres, puedes desactivarlos en «Archivos».
• La comparación y el deshacer están en el editor. El texto que la IA ha cambiado muestra directamente lo eliminado y lo añadido, y se puede conservar o revertir pasaje a pasaje; si no te convence, puedes deshacer la ronda actual, abrir una rama desde antes de esa ronda o editar y reenviar. La rama y la conversación original comparten el mismo manuscrito.

• El texto se encarga al agente redactor. Al continuar, el agente redactor recibe solo el material que necesita este capítulo: esquema del capítulo, ajustes de los personajes relacionados, texto anterior y muestras de estilo.
• Los ajustes viejos se recogen por volúmenes. Al llegar a un volumen nuevo, los personajes, lugares y pistas sembradas que solo aparecieron en los volúmenes anteriores se mueven al archivo y la IA ya no los consulta al escribir capítulos nuevos, aunque se pueden seguir consultando cuando hace falta.
• Se usa directamente en la web, sin instalar nada.

Una comparación detallada de las dos formas está en Claude Code frente a Maliang Writer, Agentes de programación frente a software de escritura de novelas: cómo elegir y Carpetas frente a escritura estructurada: cómo elegir.

Preguntas frecuentes

P: ¿Puede Claude Code escribir novelas?
Sí. Puede leer y escribir toda una carpeta y modificar entre archivos, trae puntos de control para retroceder, y ya hay autores que han terminado novelas largas usando Claude para el texto y Claude Code para las comprobaciones entre archivos. Tienes que diseñar tú el directorio, escribir CLAUDE.md y mantener los registros de estado de los personajes y pistas sembradas.

P: ¿Qué debe ir en CLAUDE.md?
Solo lo que hay que cumplir siempre: la presentación del libro en una frase, los archivos que hay que leer antes de escribir un capítulo, las reglas duras de escritura, los registros que hay que actualizar al terminar un capítulo, qué archivos no puede cambiar la IA y a quién se da la razón en un conflicto. Que sea breve.

P: ¿Cómo se configuran las reglas para escribir novelas con Cursor?
Crea archivos de reglas en el directorio .cursor/rules del proyecto, con los archivos de lectura obligatoria y las reglas duras; también puedes usar AGENTS.md. Divide los ajustes y los personajes en archivos pequeños y cita solo los que correspondan al capítulo que escribes. Los puntos de control de Cursor se guardan en local, y la recomendación oficial es gestionar las versiones a largo plazo con Git.

P: ¿Puede Codex CLI escribir novelas?
Sí, de forma parecida a Claude Code: escribe las reglas en AGENTS.md y organiza los ajustes, el esquema y el texto por directorios. La documentación oficial indica que el tamaño total de AGENTS.md tiene por defecto un límite de 32 KiB, así que las reglas deben ser concisas.

P: ¿Hace falta saber programar para escribir novelas con Claude Code?
No hace falta escribir código, pero sí estar acostumbrado al terminal o a un editor, entender un poco de gestión de archivos y directorios, y resulta más cómodo si se sabe usar Git para gestionar versiones. Para autores que no conocen nada de esto, habrá un período de adaptación.

P: ¿Se puede usar Claude Code en China?
La lista oficial de regiones compatibles de Claude no incluye la China continental, y esta indicación abarca Claude.ai, Claude Code y la API. Lo concreto depende de la página oficial.

P: ¿Cuándo conviene pasar de un agente de programación a un software de escritura?
Cuando el tiempo de mantener registros y reglas supera al de escribir el texto, cuando no quieres usar el terminal ni Git, cuando quieres escribir en la web o en el móvil, o cuando te resulta más natural ver fichas que archivos, puedes plantearte pasar a un software de escritura de novelas específico.