소설 폴더와 CLAUDE.md 규칙 쓰는 법: 코딩 도구로 장편 쓰는 디렉터리와 장부

이 글의 목차 9개 섹션

먼저 결론: 폴더는 네 종류로, 규칙 파일에는 강제 제약을, 장부는 회차마다 갱신

Claude Code, Cursor, Codex CLI는 원래 코드를 쓰는 도구이지만 갈수록 많은 작가가 이것들로 소설을 씁니다. 이유는 실질적입니다. 폴더 전체를 읽고 쓸 수 있고, 한 번의 변경이 수십 개 파일에 걸칠 수 있으며, 망가져도 되돌릴 방법이 있어서(Claude Code와 Cursor는 체크포인트 내장, Codex CLI는 공식적으로 Git으로 체크포인트를 만들길 권장) 파일이 100개가 넘는 장편을 관리하기에 알맞습니다.

이것들로 소설을 쓰는 공개 사례는 대체로 같은 방법으로 수렴합니다.

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, 권 플롯/1권.md, 회차 플롯/001.md……
• 본문/: 001-비 내리는 밤.md, 002-입문.md……
• 장부/: 인물 상태.md, 복선.md, 타임라인.md, 진행.md
• 문체/: 샘플 단락.md
• 보관/: 퇴장 인물, 옛 장소

몇 가지 세부 사항입니다.

• 회차 파일명은 세 자리 숫자로 시작하세요. 중국어 회차명은 알파벳순으로 정렬하면 순서가 흐트러지는데, Juejin에서 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로 100개가 넘는 파일에 걸쳐 연속성 점검을 하게 했습니다(출처).

버전: 체크포인트 외에 Git도 필요

• Claude Code는 매 프롬프트마다 자동으로 체크포인트를 만들고 /rewind로 되돌릴 수 있으며, 공식 문서에 최근 100개를 보관한다고 명시되어 있습니다(출처).
• Cursor의 체크포인트는 로컬에 저장되며 Git과 분리되어 있고, 공식은 장기 버전 관리에 Git을 쓰라고 권합니다(출처).
• Codex CLI는 공식적으로 작업 전후에 Git 체크포인트를 만들어 되돌릴 수 있게 하라고 권합니다(출처).

그래서 비교적 안정적인 습관은 한 회차를 쓸 때마다 Git에 커밋하고 커밋 설명에 회차 번호를 쓰는 것입니다.

공개 사례에서 반복해서 나오는 문제

이 공개 튜토리얼과 논의를 정리하면 몇 가지 문제가 비교적 자주 나옵니다.

• 대화가 길어지면 「흐려」집니다. Buckram Studio의 작가는 200개 메시지의 긴 대화에서 컨텍스트 열화, 비용 상승, 반복과 두루뭉술한 글이 나온다고 했고(출처), Juejin의 그 글도 「소설 설정을 잊곤 한다」고 했습니다.
• 캐릭터와 문체가 표류합니다. CSDN 튜토리얼의 원문 표현은 「주인공의 능력이 갑자기 세졌다 약해졌다 하며 다른 사람 같다」였고, Reddit의 그 작가는 80회차에 이르면 이미 12회차의 리듬이 없어 샘플 단락을 반복해서 다시 제공해야 했다고 말했습니다.
• 사용량과 비용. AI에게 파일을 하나씩 합치게 하면 한도가 금방 소진됩니다(출처).
• 비프로그래머에게는 진입 장벽이 있습니다. 같은 글은 VS Code가 비프로그래머에게는 「듣기만 해도 겁난다」고 했고, 다른 글은 컴퓨터 학위 없이도 시작할 수 있다고 보면서 대부분의 작가가 주로 채팅 인터페이스를 쓸 것이라고 판단했습니다(출처).

이 문제들은 모두 완화할 방법이 있습니다. 파일을 작게 나누고, 장부를 회차마다 갱신하고, 회차마다 필요한 파일만 읽게 하고, 주기적으로 새 대화를 여는 것입니다. 대가는 작가가 직접 디렉터리를 설계하고, 규칙을 쓰고, 장부를 관리하고, 파일 비교를 봐야 한다는 점입니다.

언제 소설 집필 소프트웨어로 바꿀까

코딩 에이전트가 주는 것은 완전한 통제권입니다. 파일은 로컬에 있고 구조는 직접 정하며 모델이나 도구를 바꾸기도 편합니다. 이 방식을 좋아하고 터미널과 Git에 익숙한 작가에게 이것으로 소설을 쓰는 것은 좋은 선택입니다.

아래와 같은 경우에는 전용 집필 소프트웨어로 바꾸는 것을 고려해 볼 수 있습니다.

• 장부와 규칙 파일을 관리하는 데 쓰는 시간이 본문을 쓰는 시간을 넘기 시작했다.
• 터미널과 Git에 익숙하지 않아 변경을 볼 때마다 파일 비교를 궁리해야 한다.
• 웹이나 휴대폰에서 언제든 쓰고 싶고, 컴퓨터 한 대에 묶이고 싶지 않다.
• Markdown 파일 더미가 아니라 캐릭터 카드, 목차, 복선 목록을 보고 싶다.
• 네트워크나 계정 조건이 제한된다. 예를 들어 Claude 공식 지원 지역 목록에 중국 본토가 포함되지 않으며, 이 제한은 Claude.ai, Claude Code, API 전체에 해당합니다(출처).

Maliang Writer가 자동화한 단계

위의 디렉터리, 규칙, 장부는 Maliang Writer에서 이렇게 대응됩니다.

• 네 종류의 파일이 각자 자리를 가집니다. 인물, 설정, 복선, 스토리라인은 왼쪽 설정 바의 카드이고, 총괄 플롯은 따로 보관되며, 문체 샘플과 집필 시작 자료는 「문서」 안의 문서입니다. AI는 집필할 때 필요에 따라 읽고, 당신이 보는 것은 카드와 목차이며 직접 폴더를 관리할 필요가 없습니다.
• 장부는 기록 담당이 정리합니다. 회차를 다 쓰고 이 구간의 집필이 끝나면 기록 담당이 본문에 따라 스토리 아카이브를 정리합니다. 인물 상태, 관계, 위치, 복선. 기존 설정과 안 맞는 곳은 「확인 대기」에 올라가 어느 쪽에 맞춰 고칠지 당신이 정합니다. 원하지 않으면 「아카이브」에서 끌 수 있습니다.
• 비교와 되돌리기는 편집기 안에 있습니다. AI가 고친 본문은 삭제와 추가가 바로 표시되고, 항목별로 유지하거나 되돌릴 수 있습니다. 마음에 안 들면 이번 라운드를 취소하거나, 이번 라운드 이전에서 분기하거나, 수정 후 다시 보낼 수 있습니다. 분기와 원래 대화는 같은 원고를 공유합니다.

• 본문은 집필 에이전트에게 맡깁니다. 이어 쓸 때 집필 에이전트는 이번 회차에 필요한 자료만 받습니다. 회차 플롯, 관련 인물 설정, 앞 내용, 문체 샘플.
• 권별로 옛 설정을 치웁니다. 새 권을 쓸 때 지난 몇 권에만 등장한 인물, 장소, 복선은 보관함으로 들어가 AI가 새 회차를 쓸 때 더는 참고하지 않으며, 필요하면 여전히 찾을 수 있습니다.
• 웹에서 바로 쓰며 설치가 필요 없습니다.

두 방식의 자세한 비교는 Claude Code와 Maliang Writer 비교, 코딩 에이전트와 소설 집필 앱 선택, 폴더와 구조화 집필 선택을 보세요.

자주 묻는 질문

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을 쓰고 싶지 않거나, 웹이나 휴대폰에서 쓰고 싶거나, 파일보다 카드를 보는 것이 더 익숙하다면 전용 소설 집필 소프트웨어로 바꾸는 것을 고려해 볼 수 있습니다.