클로드 코드는 '/compact'를 실행한 후 작업 세부사항을 잊어버렸는데, 이는 보통 키 상태가 채팅 기록에만 남아 프로젝트 파일에 포함되지 않기 때문입니다. /compact는 대화를 압축하여 문맥을 해제하지만, 압축된 요약에서 모든 세부사항을 보존하는 것은 불가능하므로 롱 작업은 상태가 파일에 기록되어야 합니다.
어떤 내용을 넣어야 하는지
어떤 파일이 변경되는지, 왜 변경되는지, 어떤 단계가 진행되지 않았는지, 어떤 검증 명령어가 있는지, 이것들은 채팅에만 있는 것이 아닙니다. 이는 'CLAUDE.md', 'TODO.md', 'notes/implementation-plan.md' 또는 임시 작업 문서에 작성할 수 있습니다.
Claude Code가 끝까지 채팅만 진행하게 두면, 컴팩트 이후의 대략적인 방향은 기억할 수 있지만, 경계 조건, 사용자 요구사항, 그리고 중간에 발생할 수 있는 함정은 잊게 됩니다.
컴팩트 전에 인수인계
문맥 제한에 접근할 때는 단순히 '/압축'만 하지 마세요. 핸드오버 기록을 작성하게 하세요: 현재 목표, 완료된 변경사항, 미완료 항목, 실행 완료된 테스트, 실패 사유, 다음 단계. 압축 작업을 수행하기 전에 이 기록이 정확한지 확인하세요.
Anthropic의 도움말 문서에도 '/compact'가 필요한 맥락을 보존하고 공간을 확보하기 위해 사용된다고 언급되어 있습니다; 프로젝트 문서와 'CLAUDE.md'은 후속 작업의 기초로 여전히 활용될 수 있습니다.
너무 많이 채우지 마 CLAUDE.md
'CLAUDE.md'는 각 작업 로그를 가득 채우기보다는 장기 규칙이나 프로젝트 항목에 적합합니다. 임시 작업 상태는 별도의 문서로 작성한 후 삭제되거나 정리하는 것이 더 적합합니다.
모든 역사를 'CLAUDE.md'에 쑤셔 넣으면, 다음 세션은 많은 맥락으로 시작하고 느려질 가능성이 높아집니다.
가장 안정적인 접근법
긴 작업이 짧은 섹션을 완료할 때마다 작업 문서가 업데이트됩니다. Compact는 채팅만 압축하며 프로젝트 관리 도구는 담당하지 않습니다. "작업 상태는 파일 안에 있고, 채팅은 단지 운영 인터페이스일 뿐"이라고 설정하면, Claude 코드가 쉽게 분할되지 않도록 합니다.
