오픈소스 CLAUDE.md가 Claude Code 에이전트를 몇 시간 동안 생산적으로 유지하며, 루핑 상태에 빠지지 않도록 함

자율적인 Claude Code 세션을 실행해 본 적이 있다면, 벽에 부딪힌 경험이 있을 것입니다: 에이전트는 처음에는 날카롭게 시작하지만, 2시간째에 이야기로 빠져들고, 3시간째에 같은 수정 작업을 반복하다가, 아무것도 배송하지 못하고 죽습니다. 수백 개의 세션을 소진한 한 개발자는 문제가 프레임워크나 도구가 아니라 프로젝트 루트에 CLAUDE.md 파일이 없다는 것을 발견했습니다.

운영 파일의 역할

이 파일은 70줄이며, MIT 라이선스로, ./CLAUDE.md에 위치합니다. Claude Code가 시작할 때 이를 읽고 행동이 즉시 바뀝니다. 핵심 지시 사항:

• 이야기보다 행동을 강제합니다. 에이전트가 도구를 호출하는 대신 "지금부터 ~하겠습니다"라고 쓰는 것을 발견하면, 즉시 멈추고 도구를 실행합니다.
• 완료를 주장하기 전에 증거를 요구합니다. 테스트 출력 없이 "수정되었을 것"은 허용되지 않습니다.
• 계획 언어를 없앱니다. 유효한 출력은 완료된 작업, 질문 또는 요약뿐입니다.
• 컨텍스트 압박 시 자체 감사를 수행하여 조용히 성능이 저하되는 것을 방지합니다.

세션에 미치는 영향

파일이 있으면 세션이 3시간짜리 이야기 반복에서 완전한 생산적 수명 주기로 바뀝니다. 에이전트는 코드를 배송하고, 제대로 배포되었는지 확인하며, 컨텍스트 압박이 올 때까지 계속 진행합니다. 그런 다음 상태를 저장하고 다음 세션이 깨끗하게 이어받습니다.

사용 방법

GitHub 저장소에서 파일을 복사하여 프로젝트 루트에 넣으세요. 설정이나 의존성이 필요 없습니다. Claude Code가 자동으로 읽습니다. 저장소에 정확한 CLAUDE.md가 있으니 가져다가 넣기만 하면 됩니다.