클로드 코드 자동 압축, 긴 세션에서 규칙을 잊는 이유와 해결법

클로드 코드 자동 압축이 일어나면 무엇이 남고 무엇이 사라지는지, 그래서 긴 세션 후반에 규칙을 놓치는 이유가 무엇인지 정리했습니다. 압축 뒤에도 규칙이 살아남게 하는 두 가지 방법과, 영상이 말하지 않은 파일 위치·확인 명령·미리 압축하는 법까지 덧붙였습니다.

클로드 코드가 갑자기 규칙을 안 지킨다면

마일드코드 채널의 48초 쇼츠에서 화자는 이렇게 시작합니다. 클로드 코드(터미널에서 코드를 읽고 고치는 앤트로픽의 AI 코딩 도구)가 긴 세션 후반에 갑자기 규칙을 안 지킨다면 방금 압축이 일어난 것이고, 갑자기 멍청해진 것 같은 느낌은 기분 탓이 아니라 압축 때문이라는 겁니다.

압축(compaction)은 대화가 길어져 컨텍스트 창(모델이 한 번에 기억할 수 있는 대화 분량)이 차오를 때, 지난 대화를 요약해 자리를 비우는 동작입니다. 요약하는 과정에서 앞에서 읽어 둔 규칙 일부가 빠질 수 있습니다.

• 화자는 한도에 가까워지면 클로드 코드가 알아서 압축을 돌린다고 말합니다. 직접 누르지 않아도요.
• 화자 설명으로는 압축 뒤 루트 CLAUDE.md와 쓰던 스킬 본문은 다시 들어오고, 경로를 걸어 둔 규칙과 하위 폴더 CLAUDE.md, 스킬 목록은 다시 들어오지 않습니다.
• 해결책은 두 단계입니다. 끝까지 지킬 규칙은 루트 CLAUDE.md로, 스킬의 중요한 지시는 맨 위로.

압축 뒤 남는 것과 묻히는 것 (화자 설명)

화자는 클로드 코드 공식 문서에 압축 뒤 무엇이 남는지 표로 나와 있다고 말합니다. 압축 동작에 대한 설명과 "스킬 하나당 5,000 토큰"이라는 수치는 화자가 전한 것입니다. 편집자가 공식 문서의 해당 표를 찾아 대조한 결과는 아래 편집자 정리에 따로 적었습니다.

다시 읽어 오는 것

• 루트(프로젝트 맨 위 폴더)에 있는 CLAUDE.md는 다시 읽어 온다고 합니다.
• 쓰던 스킬의 본문도 다시 넣어 준다고 합니다.

묻혀 버리는 것

• 경로를 걸어 둔 규칙, 그리고 하위 폴더에 있는 CLAUDE.md는 대화와 같이 요약돼서 묻혀 버린다고 화자는 말합니다.
• 스킬 목록도 다시 안 들어온다고 합니다.

스킬은 조금 더 까다롭다

화자에 따르면 스킬 본문은 스킬 하나에 5,000 토큰까지만 다시 넣고, 그걸 넘으면 앞부분만 남깁니다.

화자가 든 예는 이렇습니다. 배포 스킬 맨 아래에 "마지막엔 테스트를 돌리라"는 지시가 있으면, 압축 뒤에는 그 지시가 빠질 수 있다고 합니다.

압축을 안 하면 되지 않나

화자는 이 질문을 먼저 꺼냅니다. 답은 이렇습니다. 직접 누르지 않아도 한도에 가까워지면 클로드 코드가 알아서 압축을 돌린다고요.

피할 수 없다면, 압축 뒤에도 남는 자리에 규칙을 두라는 것이 화자의 결론입니다.

클로드 코드 자동 압축 뒤에도 규칙을 남기는 2단계

영상 발화에는 명령어나 파일 경로가 나오지 않습니다. 아래 위치와 명령은 클로드 코드 공식 문서 기준으로 편집자가 채웠습니다.

1단계. 끝까지 지킬 규칙을 루트 CLAUDE.md로 옮긴다

끝까지 지켜야 하는 규칙을 루트 CLAUDE.md로 옮깁니다.

1. 클로드 코드를 켠 상태에서 채팅창에 /memory를 입력합니다.
   • 확인: CLAUDE.md 파일 위치 목록이 뜹니다.
2. 목록에서 프로젝트 CLAUDE.md(./CLAUDE.md 또는 ./.claude/CLAUDE.md)를 골라 엽니다. 아직 없으면 고르는 순간 새로 만들어집니다.
3. 옮길 규칙을 찾아 붙여 넣습니다. 옮길 대상은 .claude/rules/ 폴더 안에서 파일 맨 위에 paths:가 적힌 규칙 파일, 그리고 하위 폴더에 따로 둔 CLAUDE.md에 있던 규칙입니다.
4. 원래 자리의 같은 규칙은 지웁니다. 같은 규칙이 두 곳에 다르게 적혀 있으면 클로드가 둘 중 하나를 임의로 따를 수 있습니다.

• 확인: 그 규칙이 루트 CLAUDE.md 안에 적혀 있다.
• 확인 명령: 채팅창에 /context를 입력하면 Memory files 아래에 지금 읽힌 CLAUDE.md 목록이 보입니다.
• 주의: 루트 CLAUDE.md는 매번 통째로 읽히므로 너무 길어지지 않게 합니다. 공식 문서는 파일 하나를 200줄 안으로 쓰라고 권합니다. "끝까지 지켜야 하는" 규칙만 올립니다.

2단계. 스킬의 중요한 지시를 맨 위로 올린다

스킬에서 중요한 지시를 스킬 본문 맨 위로 올립니다.

1. 스킬 파일을 엽니다. 프로젝트 스킬은 보통 .claude/skills/스킬이름/SKILL.md, 개인 스킬은 ~/.claude/skills/스킬이름/SKILL.md에 있습니다.
2. 맨 위 머리말(--- 두 줄 사이) 바로 아래에 "반드시 지킬 것" 묶음을 만듭니다.
3. 본문 아래쪽에 있던 핵심 지시를 그 묶음으로 옮깁니다.

예를 들어 배포 스킬이라면 이렇게 바꿉니다.

---
name: deploy
description: 배포 순서. 배포해 달라는 요청을 받았을 때 사용한다.
---
## 반드시 지킬 것
- 배포가 끝나면 마지막에 반드시 테스트를 돌리고 결과를 보고한다.
- 테스트가 실패하면 운영 배포를 하지 않는다.

## 순서
1. main 브랜치가 최신인지 확인한다.
2. 스테이징에 먼저 배포한다.
...

• 확인: 중요한 지시가 스킬 본문 첫머리에 있다.
• 예: 배포 스킬 맨 아래에 있던 "마지막엔 테스트를 돌리라"는 지시를 위로 올리는 경우입니다.

화자는 이렇게 하면 세션이 길어져도 규칙이 살아남는다고 말합니다.

최종 체크리스트

• 끝까지 지켜야 하는 규칙이 루트 CLAUDE.md에 있다
• 같은 규칙이 다른 파일에 중복으로 남아 있지 않다
• 각 스킬의 중요한 지시가 본문 맨 위에 있다
• /context에서 루트 CLAUDE.md가 Memory files에 보인다

자주 막히는 곳

긴 세션 후반에 규칙을 안 지킨다

• 화자 설명: 압축이 일어났다
• 해결: 규칙을 루트 CLAUDE.md로 옮긴다

스킬 맨 아래 지시가 무시된다

• 화자 설명: 스킬당 5,000 토큰을 넘으면 앞부분만 남는다
• 해결: 중요한 지시를 맨 위로 올린다

압축이 일어났는지 모르겠다

영상은 확인 방법을 말하지 않습니다. 클로드 코드는 압축할 때 대화 화면에 요약했다는 표시를 남깁니다. 지금 컨텍스트가 얼마나 찼는지는 /context로 볼 수 있습니다. 표시가 거의 찼다면 곧 자동 압축이 돈다고 보면 됩니다.

/compact 지금 고치고 있는 로그인 오류와 CLAUDE.md 규칙을 중심으로 요약해 줘

출처: youtube.com/…