이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.
클로드 코드 자동 압축, 긴 세션에서 규칙을 잊는 이유와 해결법
클로드 코드 자동 압축이 일어나면 무엇이 남고 무엇이 사라지는지, 그래서 긴 세션 후반에 규칙을 놓치는 이유가 무엇인지 알려 드립니다. 압축 뒤에도 규칙이 살아남게 하는 두 가지 방법과 파일 위치, 확인 명령, 내가 먼저 압축하는 법까지 함께 담았습니다.

클로드 코드가 갑자기 규칙을 안 지킨다면
클로드 코드(터미널에서 코드를 읽고 고치는 Anthropic의 AI 코딩 도구)가 긴 세션 후반에 갑자기 규칙을 안 지킨다면, 방금 압축이 일어났을 가능성이 큽니다. 갑자기 멍청해진 것 같은 느낌은 기분 탓이 아닙니다.
압축(compaction)은 대화가 길어져 컨텍스트 창(모델이 한 번에 기억할 수 있는 대화 분량)이 차오를 때, 지난 대화를 요약해 자리를 비우는 동작입니다. 요약하는 과정에서 앞에서 읽어 둔 규칙 일부가 빠질 수 있습니다.
- 한도에 가까워지면 클로드 코드가 알아서 압축을 돌립니다. 직접 누르지 않아도요.
- 압축 뒤 루트 CLAUDE.md와 쓰던 스킬 본문은 다시 들어오고, 경로를 걸어 둔 규칙과 하위 폴더 CLAUDE.md, 스킬 목록은 다시 들어오지 않습니다.
- 해결책은 두 단계입니다. 끝까지 지킬 규칙은 루트 CLAUDE.md로, 스킬의 중요한 지시는 맨 위로.
압축 뒤 남는 것과 묻히는 것
클로드 코드 공식 문서에는 압축 뒤 무엇이 남는지 정리한 "What survives compaction"(압축 뒤 남는 것) 표가 있습니다. 핵심은 디스크에서 다시 읽어 오는 것과, 대화와 함께 요약돼 버리는 것이 나뉜다는 점입니다.
다시 읽어 오는 것
- 루트(프로젝트 맨 위 폴더)에 있는 CLAUDE.md, 그리고
paths:가 없는 규칙은 압축 뒤 디스크에서 다시 읽어 넣습니다. - 자동 메모리(MEMORY.md)도 다시 읽어 넣습니다.
- 쓰던 스킬의 본문도 다시 넣어 줍니다.
- 최근에 읽거나 고친 파일은 최근 수정 순으로 최대 다섯 개를 다시 읽습니다.
묻혀 버리는 것
- 경로를 걸어 둔 규칙(
paths:가 걸린 규칙), 그리고 하위 폴더에 있는 CLAUDE.md는 대화와 같이 요약돼서 묻혀 버립니다. - 스킬 목록도 다시 안 들어옵니다.
다만 묻힌 규칙이 영영 사라지는 것은 아닙니다. 클로드가 해당 경로의 파일을 다시 읽으면 그때 다시 불려 옵니다. "그 파일을 다시 읽기 전까지는 빠져 있다"고 이해하면 정확합니다.
스킬은 조금 더 까다롭다
스킬 본문은 스킬 하나에 5,000 토큰까지만 다시 넣고, 그걸 넘으면 앞부분만 남깁니다. 전체 한도도 있어서 모든 스킬을 합쳐 25,000 토큰까지입니다. 이를 넘으면 오래된 스킬부터 빠집니다.
예를 들어 배포 스킬 맨 아래에 "마지막엔 테스트를 돌리라"는 지시가 있으면, 압축 뒤에는 그 지시가 빠질 수 있습니다.
압축을 안 하면 되지 않나
자연스럽게 떠오르는 질문입니다. 하지만 직접 누르지 않아도 한도에 가까워지면 클로드 코드가 알아서 압축을 돌립니다.
피할 수 없다면, 압축 뒤에도 남는 자리에 규칙을 두는 것이 답입니다.
클로드 코드 자동 압축 뒤에도 규칙을 남기는 2단계
1단계. 끝까지 지킬 규칙을 루트 CLAUDE.md로 옮긴다
끝까지 지켜야 하는 규칙을 루트 CLAUDE.md로 옮깁니다.
- 클로드 코드를 켠 상태에서 채팅창에
/memory를 입력합니다. - 확인: CLAUDE.md 파일 위치 목록이 뜹니다.
- 목록에서 프로젝트 CLAUDE.md(
./CLAUDE.md또는./.claude/CLAUDE.md)를 골라 엽니다. 아직 없으면 고르는 순간 새로 만들어집니다. - 옮길 규칙을 찾아 붙여 넣습니다. 옮길 대상은
.claude/rules/폴더 안에서 파일 맨 위에paths:가 적힌 규칙 파일, 그리고 하위 폴더에 따로 둔 CLAUDE.md에 있던 규칙입니다. - 원래 자리의 같은 규칙은 지웁니다. 같은 규칙이 두 곳에 다르게 적혀 있으면 클로드가 둘 중 하나를 임의로 따를 수 있습니다.
- 확인: 그 규칙이 루트 CLAUDE.md 안에 적혀 있다.
- 확인 명령: 채팅창에
/context를 입력하면 Memory files 아래에 지금 읽힌 CLAUDE.md 목록이 보입니다. - 주의: 루트 CLAUDE.md는 매번 통째로 읽히므로 너무 길어지지 않게 합니다. 공식 문서는 파일 하나를 200줄 안으로 쓰라고 권합니다. "끝까지 지켜야 하는" 규칙만 올립니다.
2단계. 스킬의 중요한 지시를 맨 위로 올린다
스킬에서 중요한 지시를 스킬 본문 맨 위로 올립니다.
- 스킬 파일을 엽니다. 프로젝트 스킬은 보통
.claude/skills/스킬이름/SKILL.md, 개인 스킬은~/.claude/skills/스킬이름/SKILL.md에 있습니다. - 맨 위 머리말(
---두 줄 사이) 바로 아래에 "반드시 지킬 것" 묶음을 만듭니다. - 본문 아래쪽에 있던 핵심 지시를 그 묶음으로 옮깁니다.
예를 들어 배포 스킬이라면 이렇게 바꿉니다.
---
name: deploy
description: 배포 순서. 배포해 달라는 요청을 받았을 때 사용한다.
---
## 반드시 지킬 것
- 배포가 끝나면 마지막에 반드시 테스트를 돌리고 결과를 보고한다.
- 테스트가 실패하면 운영 배포를 하지 않는다.
## 순서
1. main 브랜치가 최신인지 확인한다.
2. 스테이징에 먼저 배포한다.
...
- 확인: 중요한 지시가 스킬 본문 첫머리에 있다.
- 예: 배포 스킬 맨 아래에 있던 "마지막엔 테스트를 돌리라"는 지시를 위로 올리는 경우입니다.
이렇게 해 두면 세션이 길어져 압축이 몇 번 돌아도 규칙이 살아남습니다.
압축을 내가 먼저 조절하는 법
자동 압축을 끄는 대신, 타이밍과 내용을 내가 고를 수 있습니다.
- 요점을 지정해 압축: 긴 새 작업을 시작하기 전에 아래처럼 입력하면, 요약할 때 지정한 내용을 남깁니다.
/compact 지금 고치고 있는 로그인 오류와 CLAUDE.md 규칙을 중심으로 요약해 줘
- 작업이 바뀔 때 비우기: 관계없는 일로 넘어갈 때는
/clear로 대화를 비우고 새로 시작합니다. 루트 CLAUDE.md는 새 대화에서도 다시 읽힙니다. - 더 일찍 압축:
/autocompact뒤에 토큰 수를 붙여 자동 압축이 도는 시점을 앞당길 수 있습니다. 받는 값의 형식은 공식 문서에서 확인합니다.
규칙을 어디에 둘지 고르는 기준
먼저 용어부터 짚습니다.
- CLAUDE.md: 클로드 코드가 대화를 시작할 때마다 자동으로 읽는 프로젝트 설명서.
- 경로를 걸어 둔 규칙:
.claude/rules/폴더의 규칙 파일 맨 위에paths:로 적용할 파일 경로를 적은 것. 그 경로의 파일을 다룰 때만 읽힙니다. - 스킬: 특정 작업을 할 때 꺼내 읽는 절차 문서. 평소에는 설명 한 줄만 올라가 있다가 쓸 때 본문을 읽습니다.
규칙의 성격에 따라 자리를 정합니다.
- 모든 작업에서 지켜야 하는 규칙: 루트 CLAUDE.md.
- 특정 폴더에서만 의미 있는 규칙: 경로 규칙에 두되, 압축 뒤에도 꼭 필요하면 루트로 올립니다.
- 순서가 있는 절차: 스킬에 두고, 빠지면 안 되는 한두 줄은 맨 위에.
- 절대 어기면 안 되는 동작(파일 삭제, 비밀 키 수정 등): 문장 규칙보다 훅(특정 동작 직전에 자동으로 실행돼 막는 스크립트)으로 막는 편이 확실합니다. 공식 문서도 CLAUDE.md는 강제 설정이 아니라 참고 맥락이라고 설명합니다.
최종 체크리스트
- 끝까지 지켜야 하는 규칙이 루트 CLAUDE.md에 있다
- 같은 규칙이 다른 파일에 중복으로 남아 있지 않다
- 각 스킬의 중요한 지시가 본문 맨 위에 있다
/context에서 루트 CLAUDE.md가 Memory files에 보인다
자주 막히는 곳
긴 세션 후반에 규칙을 안 지킨다
- 원인: 압축이 일어났다
- 해결: 규칙을 루트 CLAUDE.md로 옮긴다
스킬 맨 아래 지시가 무시된다
- 원인: 스킬당 5,000 토큰을 넘으면 앞부분만 남는다
- 해결: 중요한 지시를 맨 위로 올린다
압축이 일어났는지 모르겠다
클로드 코드는 압축할 때 대화 화면에 요약했다는 표시를 남깁니다. 지금 컨텍스트가 얼마나 찼는지는 /context
자주 묻는 질문
클로드 코드 자동 압축은 끌 수 없나요?
컨텍스트가 한도에 가까워지면 클로드 코드는 직접 누르지 않아도 자동으로 압축합니다. 대신 /compact/clear
압축 뒤에도 남는 규칙은 어디에 둬야 하나요?
프로젝트 루트의 CLAUDE.md입니다. 압축 뒤 디스크에서 다시 읽어 넣기 때문입니다. paths:.claude/rules/ 규칙도 같은 대우를 받습니다.
스킬이 길면 어떻게 되나요?
압축 뒤에는 스킬 하나당 5,000 토큰까지만 다시 넣고 앞부분을 남깁니다. 그래서 빠지면 안 되는 지시는 SKILL.md 맨 위에 둡니다.
지금 어떤 CLAUDE.md가 읽혔는지 어떻게 확인하나요?
채팅창에 /context/memory
이 글의 본문은 아래 원본 유튜브 영상의 내용을 바탕으로 쓸모연구소가 다시 정리해 쓴 것입니다. 세부 내용과 최신 정보는 원본 영상과 공식 안내에서 확인해 주세요.
원본 영상 보러가기 ↗