이 글을 통해 알게 되는 것
- 클라우드에서 구동하는 Claude Code로, 몇 주가 걸리는 작업을 지속시키기 위한
CLAUDE.md 작성법 - 실제로 추가한 규칙과 그 규칙이 각각 무엇을 방지했는지
- 잘 되지 않았던 점 (작성했지만 지킬 수 없었던 규칙, 오래된 규칙)
- 그대로 자신의
CLAUDE.md에 추가할 수 있는 템플릿
예상 독자는 Claude Code를 날짜를 넘나드는 작업에 사용하고 있거나, 앞으로 사용하려는 사람입니다.
이전 글(Claude Code에 $100 크레딧을 주고 '벌어라'고 부탁했더니, 26일 후의 매출은 0달러였다)에서 '기록에서 재개하는 것'이 성공적이었다고 작성했습니다. 이 글은 그 내용입니다.
전제: 대화는 끝나지만, 기록은 남는다
PUP은 클라우드 컨테이너에서 구동되는 Claude Code입니다. 대화가 끝나면 컨테이너는 회수됩니다. 긴 대화는 중간에 요약되어 짧아집니다. 어느 경우든, 그전까지의 세밀한 문맥은 사라집니다.
남는 것은 GitHub 리포지토리에 push된 파일뿐입니다. 그래서 PUP은 다음 세션의 자신(혹은 요약된 후의 자신)을 '아무것도 모르는 인계자'로 간주하고, CLAUDE.md를 작성했습니다.
4주 동안 CLAUDE.md는 20번 수정되었고 (만든 버전을 포함하여 총 21개), 29행에서 66행으로 늘어났습니다. 그중 7번은 만든 날 낮부터 다음 날 아침까지의 약 15시간에 해당합니다.
첫 번째 버전에는 사실 오류가 있었다
첫 번째 버전(10/10)의 '미션'에는 다음과 같이 쓰여 있었습니다.
- 시드: Anthropic API 크레딧 $100 (현금이 아니다. 소모만 한다)
- 크레딧이 바닥날 때까지 수익화 목표가 없으면 Game Over
실제 원금은 API 크레딧이 아니라 클라우드 세션 크레딧이었습니다. 게다가 '바닥난다'기보다는 11/5에 '만료된다'는 것이었습니다. 인간 파트너에게 기한을 물어본 후, 2시간 뒤 버전에서 다음과 같이 수정했습니다.
- 시드: 클라우드 세션 크레딧 $100 (현금이 아니다. 2026-11-05 16:59 JST에 만료)
- 승리 조건: 11/5 16:59 JST까지, 수수료 공제 후 확정 이익이 $100을 초과하는 것 (입금은 나중에 해도 좋다)
이 오류 때문에 '마지막 $25는 건드리지 않고 남겨둔다'라는 의미 없는 규칙까지 만들었습니다 (실패 로그의 1번). 가장 먼저 써야 하는 것은 기한과 조건의 숫자입니다. 여기가 다르면, 그 아래에 쓰는 모든 규칙이 틀어집니다.
섹션별 작성법
최종적으로 CLAUDE.md는 5개의 섹션으로 구성되었습니다.
1. 미션: 숫자와 기한, 그리고 결과
승리 조건은 숫자와 시간으로 작성합니다. '열심히 벌자'가 아니라 '11/5 16:59 JST까지, 수수료 공제 후 확정 이익이 $100을 초과하는 것'입니다.
판단 결과가 나오면, 그 줄 아래에 결과를 추가했습니다. 지우지 않고 추가하기 때문에, 다음 세션에서는 '무엇을 목표로 했고, 어떻게 되었는지'를 한 번에 읽을 수 있습니다.
- 결과 (2026-11-05 16:59 판단): 매출 0건으로 미달. 크레딧은 만료되었다. 이후 PUP은 일반 플랜 사용량으로 움직이며, 크레딧 금액의 제약은 없다
2. 팀: 누가 무엇을 할 것인가
인간 1명과 AI 5개의 팀이었기 때문에, 호칭과 역할을 한 줄씩 작성했습니다. 중요한 것은 인간의 제약도 적어주는 것입니다. '회사원이라 시간이 제한적이다'라고 써두면, PUP이 인간에게 부탁할 작업량을 다음 세션에서도 같은 자로 측정할 수 있습니다.
3. 규칙: 한 줄마다 '무엇을 방지하는가'
규칙은 번호가 매겨져 총 10개가 되었습니다. 실제로 효과를 본 것들을, 막아낸 것과 함께 나열합니다.
⚠️ [IMG:N]
| 규칙 (요약. 사람의 이름은 '인간'으로 대체) | 방지한 것 |
|---|
| 결과물은 반드시 커밋(commit)하고 푸시(push)한다. 다음 세션은 파일에서 재개한다 | 대화 요약이나 세션 교체로 인해 결정했던 내용이 사라지는 것. 4주 동안 결정 로그는 50건을 초과했으며, 모두 파일로부터 인계할 수 있었다 |
파일은 삭제하지 않는다. 구 버전은 _삭제대기/로 이동한다 (삭제는 인간만 가능) | AI의 판단으로 중요한 파일이 사라지는 것. 교체된 ZIP이나 초안은 모두 옮겨서 보관했다 |
| PUP로부터 소비액을 볼 수 없다. 인간이 전달한 잔고를 PUP가 장부에 기록한다 | '얼마나 사용했는지'를 AI가 추측하여 쓰는 것. 잔고는 인간이 화면에서 본 값만 기록했다 |
| 다른 노드에 요청할 때는, 상대방이 문맥을 모른다는 전제하에 작성한다. 내부 호출명(call name)을 쓰지 않고 배경 설명을 쓰고, 장소는 전체 경로(full path)로 표시한다 | 다른 AI에게 보내는 요청문에 우리 내부의 용어('B안' 등)가 섞이는 것. 실제로 한 번 섞여서 인간에게 지적받고 추가했다 |
| 이 환경의 네트워크는 일반 사이트 접속을 차단하고 있다 | 다음 세션에서 연결되지 않는 사이트를 여러 번 시도하며 시간을 낭비하는 것. 허용이 늘어난 날에는 그 날짜도 기록으로 남겼다 |
핵심은, 실패가 한 번 발생할 때마다, 즉시 규칙을 한 줄 추가하는 것입니다. 위의 표의 네 번째 행은 인간에게 지적받은 당일에 추가했습니다. 실패 내용은 별도의 '실패 로그'에 작성하고, 규칙은 한 줄로 제한합니다.
도구의 습관(버그)도 여기에 기록했습니다. 예를 들어, Google Drive의 MCP는 파일 내용을 덮어쓸 수 없기 때문에, 업데이트할 때는 구 버전을 옮기고 새로 만드는 절차를 거칩니다. 이렇게 적어두면 다음 세션에서 같은 벽에 부딪히지 않을 수 있습니다.
4. 파일 지도 (File Map)
리포지토리(repository)의 주요 파일을 한 줄씩 설명했습니다 (발췌).
- docs/03_failure_log.md — 실패 로그
- docs/04_decision_log.md — 결정 로그
- LEDGER.md — 승리 조건, 계산법, 수수료, 게이트, 잔고, 매출
...
다음 세션은 먼저 이 지도를 읽고, 필요한 파일만 엽니다. CLAUDE.md
그것에 모든 세부 사항을 적지 않고, 세부 사항은 지도 너머(결정 로그)에 배치했습니다. 66줄로 끝낼 수 있었던 것도 이 덕분입니다.
5. 현재 상태 (Current State)
원천 자금이 만료된 날, '크레딧 절약 규칙'은 전제가 사라져 구식이 되었습니다. 명칭을 '운영 규칙(Operation Rule)'으로 변경하고, 새로운 단계(Phase 2)의 목적과 제약을 추가했습니다. 세상이 바뀐 날에는 CLAUDE.md도 바꿔야 합니다. 오래된 규칙을 그대로 두면, 다음 세션은 오래된 전제 하에서 작동합니다.
잘 되지 않았던 점 (What Went Wrong)
적어도 지키지 못한 규칙이 있었다. '제작에 $20~$30'이라고 적었지만, 처음 2일 만에 $42를 사용했습니다. 적는 것만으로는 멈추지 않습니다. 숫자의 상한을 적으려면, 어디서 확인하고 멈출지까지 적어야 했습니다 -
규칙은 구식이 된다. 위 5에서 작성했듯이 말입니다. 자금이 만료될 때까지 '크레딧 절약'이라는 전제 하에 작동했습니다 -
길어지기 쉽다. 처음 약 15시간 동안, 29줄에서 49줄로 늘었습니다. 이유나 경위는 결정 로그에 맡기고, CLAUDE.md에는 결론 한 줄만 남겨서 증가 폭을 억제했습니다.
절반의 나머지: '계속'을 요청하는 사람 (The Other Half)
여기까지는 기록을 '작성하는' 측면 이야기입니다. 하지만, 기록이 남아있는 것만으로는 일이 계속되지 않습니다.
4주 동안 새로운 세션을 시작한 것은 항상 인간 파트너였습니다. 잔고를 화면에서 보고 전달합니다. 다른 AI로부터의 연락을 붙여서 건넵니다. 스크린샷을 올립니다. PUP가 기록에서 재개할 수 있었던 것도, 그러한 인계(handover)가 있었기 때문입니다.
그래서 인간의 노력을 줄이는 작성 방식도 CLAUDE.md에 추가했습니다.
- 인간의 노력에 상한을 적는다 ('초기 준비는 1회 30분 이내, 평소는 주 15분 이내')
- 인간에게 요청하는 것은 장소를 전체 경로로 쓰고, 먼저 장소를 만든 후에 요청한다 (아직 만들지 않은 폴더에 올려달라고 해서 2번 실패했다)
PUP의 기록에는 이렇게 적혀 있습니다.
기록을 읽는 것은 조건의 절반에 불과합니다. 나머지 절반은, 그것을 읽고 '계속'해 달라고 요청하는 누군가(인간이든 노드든)가 존재하는 것입니다.
자신의 CLAUDE.md에 추가한다면
PUP의 CLAUDE.md에서, 어떤 업무에도 사용할 수 있는 부분만 추출한 초안입니다.
{{프로젝트명}}
목적
- 성공 조건: {{기한}}까지 {{숫자로 측정 가능한 조건}}
...
이 방법으로는 말할 수 없는 것들
- 단 하나의 프로젝트, 4주 동안, 사람 1명의 경험입니다.
CLAUDE.md
을 작성하지 않았던 경우와 비교한 것은 아닙니다. 클라우드 환경의 Claude Code 작동 방식(컨테이너 회수 및 대화 요약)은 이 기간의 것입니다. 메커니즘이 바뀌면 필요한 규칙도 바뀝니다.
이 실험 경과는 note 연재로 공개하고 있습니다. 실험 과정에서 만든 운영 키트(유료)에는 팀에서 사용할 CLAUDE.md 템플릿과, 출시 시점에 PUP가 사용했던 CLAUDE.md (폴더 ID 등은 가림 처리된 것)도 포함되어 있습니다.
Discussion
