클로드 코드 컨텍스트 관리 — 대화가 길어질 때 compact와 clear

클로드 코드 컨텍스트, 대화 길이보다 들어 있는 내용을 본다

컨텍스트는 클로드가 다음 답을 만들 때 참고하는 내용이다. 컨텍스트 윈도우는 그 내용을 한꺼번에 담을 수 있는 범위다. 사용자가 쓴 문장 외에 읽은 파일, 명령 실행 결과, 클로드의 답, 지침도 들어간다. 질문을 짧게 적었어도 앞서 받은 긴 오류 출력이 남아 있다면, 그 대화의 참고 내용은 짧지 않다.

작업 중에 이미 정한 내용을 다시 묻거나 끝낸 조사를 다시 시작한다면, 먼저 어떤 내용이 쌓였는지 볼 만하다. 다만 이런 증상만으로 컨텍스트가 모자라다고 단정할 수는 없다. 요구사항이 모호하거나 대상 파일을 잘못 읽었을 수도 있다. 이 글에서는 상태를 보고, 지금 목표를 짧게 적고, 필요한 조치만 고르는 순서로 간다.

슬래시 명령(대화 입력란에 / 로 시작해 치는 제어 명령)은 클로드 코드 대화 안에서 입력한다. PowerShell 창에 바로 치는 명령과는 입력 자리가 다르다. 아래 코드는 클로드 코드의 입력란에 그대로 붙여 넣는다. 설치부터 막힌 상태라면 컨텍스트를 손보기 전에 실행 환경을 먼저 준비해야 한다.

/context all

잘 표시되면 현재 컨텍스트 사용량이 색상 그리드(칸마다 색으로 칠한 사용량 그림)로 나온다. 전체 화면 모드에서는 그리드가 보이도록 항목별 세부 내역이 접히므로, 여기서는 펼쳐 보는 all을 붙였다. 사용 비율만 보고 짐작하기보다 무엇이 자리를 차지하는지 읽는 것이 목적이다.

컨텍스트 상태에서 다음 행동을 고르는 순서

1. 상태 화면에서 대화, 메모리 파일, 도구 관련 항목을 살핀다. 잘 됐으면 큰 비중을 차지하는 항목을 하나 꼽을 수 있다. 항목이 접혀 있다면 위 명령에 all을 붙였는지 본다.
2. 지금 끝내려는 일을 문장 하나로 적는다. 잘 됐으면 «보고서 생성 오류 고치기»처럼 끝났는지 판단할 대상이 나온다. «프로젝트 개선»처럼 넓으면 이번에 바꿀 결과를 좁힌다.
3. 그 일을 계속하는 데 앞선 결정이 필요한지 표시한다. 잘 됐으면 남길 결정과 더 읽지 않아도 될 출력이 갈린다. 결정이 기억나지 않으면 압축 전에 대화에서 그 부분을 찾아 메모한다.

이 판단을 사용량의 고정 비율과 묶을 필요는 없다. 자동 압축 시점부터 모델마다 다르다. 공식 모델 문서는 확장 컨텍스트가 없는 Sonnet 4.6과 Opus 4.6이 200K(20만 토큰) 경계에서 압축한다고 적는다. 같은 문서는 기본 1M 윈도우를 쓰는 모델도 환경변수 하나로 200K 경계에서 압축하게 바뀐다고 설명한다. 화면의 비율 숫자 하나로 모든 환경에서 똑같이 움직일 근거는 없다. 같은 작업이 계속되는지, 앞선 결정이 다음 판단에 필요한지가 사람이 고를 기준이다.

넷째 줄은 공식 권장 사항에서 왔다. 두 번 바로잡았는데도 엇나가면 세 번째로 고치기보다 /clear 뒤 더 나은 요청을 새로 쓰라고 권한다. 나머지 줄은 공식 기능을 묶은 이 글의 제안이다. 클로드가 알아서 어느 줄인지 판정해 준다는 뜻은 아니다. 명령 전체의 위치와 용도가 낯설면 클로드 코드 슬래시 명령 모음에서 입력 방법을 먼저 읽으면 된다.

클로드 코드 compact, 남길 결정을 먼저 적는다

압축은 앞선 대화를 요약해 참고 공간을 확보하는 기능이다. 자동 압축도 대화를 요약하며, 대화 초반의 자세한 지시가 빠질 수 있다는 것이 공식 설명이다. 같은 오류를 계속 고치는 중이라면 결론, 바꾼 이유, 남은 일이 이어져야 한다. 실패한 시도의 긴 출력까지 모두 같은 무게로 남길 이유는 적다.

여기서 파일이 다시 읽힌다는 설명의 범위를 알아 둘 필요가 있다. 확인한 공식 문서는 압축 직후 읽거나 편집했던 파일을 최대 5개 다시 읽으며, 가장 나중에 수정된 파일부터 고른다고 설명한다. 5,000토큰을 초과하는 파일은 내용 없이 경로 참조로 돌아오고, Read 대신 Referenced file로 표시된다고 적는다. 토큰은 모델이 글을 잘게 나눠 처리하는 단위다. 글자 수나 줄 수와 같다고 계산하지 않는다.

그래서 꼭 필요한 파일이 자동으로 통째 돌아올 것이라고 기대하기보다, 필요한 경로와 그 파일에서 볼 부분을 인계 메모에 남기는 편이 낫다. 예를 들어 처음에 읽은 요구사항 문서는 그대로인데 뒤에 구현 파일을 여럿 고쳤다면, 자동 재읽기 순서와 지금 필요한 근거가 다를 수 있다. 수정 시각 순으로 고른다는 조건에서 나온 판단이다. 인계 메모에 요구사항의 관련 절과 지금 검토할 구현 위치를 함께 적어 두면, 요약만 보고 짐작하지 않고 원문으로 돌아갈 수 있다. 큰 오류 기록이라면 전체를 다시 넣는 대신 실패한 검사 이름과 관련 부분의 위치만 남긴다.

compact 전에 남길 인계 메모

아래는 이 글에서 만든 요청문이다. 아직 돌리지 않은 검사를 성공했다고 채우지 않도록, 확인한 결과와 할 일을 나눈다. 가령 파일 저장은 끝났지만 결과 문서를 열어 보지 않았다면, 검증 결과에는 저장한 사실만 쓰고 미완료에는 열람을 남긴다. 실패한 명령은 이름만 적지 말고 무엇이 실패했는지 짧게 붙인다. 다음 대화가 같은 실패를 성공으로 잘못 이어받지 않게 하려는 양식이다.

이 대화를 이어갈 인계 메모를 답으로 정리해 줘.
목표: 지금 끝내려는 결과
확정한 사실: 근거를 확인한 내용만
변경한 파일: 실제 경로와 변경 이유
검증 결과: 실행한 명령과 관찰한 결과
미완료: 아직 실행하지 않았거나 실패한 검사
유지할 조건: 바꾸면 안 되는 요구사항
다음 행동: 이어서 시작할 일
모르는 항목은 추측하지 말고 미확인으로 적어 줘.

1. 받은 메모를 실제 파일과 대조한다. 잘 됐으면 경로와 완료, 미완료 상태가 맞는다. 기록에 없는 성공 결과가 들어가 있으면 그 줄부터 고친다.
2. 남길 범위를 적어 압축 명령을 보낸다. 잘 됐으면 압축이 끝나고 같은 대화에서 계속 입력할 수 있다. 아래 예시의 초점 항목은 프로젝트에 맞춰 바꿔 쓴다.
3. 압축 뒤에는 목표와 다음 행동부터 물어본다. 잘 됐으면 앞서 검토한 메모와 같은 작업을 가리킨다. 파일 내용이 필요하면 그 파일의 해당 부분을 다시 읽도록 요청한다.

/compact 확정한 원인, 변경한 파일과 이유, 실행한 검증 결과, 미완료 검사, 유지할 조건을 중심으로 요약해 줘.

이 명령은 보존할 초점을 전달하는 기능이다. 빠지면 곤란한 내용이 요약에 남았는지는 이어지는 답으로 대조한다. 특히 «검사할 예정»이 «검사 통과»로 바뀌지 않았는지 읽는다. 고친 코드가 디스크에 남아 있어도, 왜 고쳤는지와 어느 입력을 아직 안 봤는지는 따로 챙길 맥락이다.

같은 초점을 매번 치기 번거롭다면 CLAUDE.md에 Compact Instructions라는 절을 만들어 압축 때 남길 내용을 적어 둘 수 있다. 공식 설명은 압축 때 남길 것을 정하는 방법으로 이 절과 초점을 붙인 /compact 두 가지를 든다. 메모에 적은 검증 뒤에 같은 파일을 또 고쳤다면, 그 결과를 지금 코드의 통과 근거로 옮기지 않는다. 검증을 끝낸 시점과 그 뒤의 변경을 나눠 적으면 다음 대화에서 다시 돌릴 검사를 고르기 쉽다.

압축을 자주 하면 비용이 줄 것이라고 단순하게 계산하기도 어렵다. 공식 권장 사항은 긴 대화의 압축 자체가 전체 대화를 읽는 큰 요청이며, 캐시가 만료된 뒤에는 부담이 더 커진다고 설명한다. 캐시는 앞서 처리한 입력을 다시 쓰는 장치다. 같은 문서는 프롬프트 캐시가 구독에서는 약 1시간, API 키에서는 5분쯤 유지된다고 적는다. 이 글은 압축 간격에 정답을 정하지 않는다. 오래된 내용이 다음 작업을 방해하기 시작할 때를 기준으로 삼는다.

인용 — Anthropic · How Claude Code works

It compacts the conversation into a summary.

우리말 뜻: 대화를 요약으로 압축한다. 클로드 코드가 컨텍스트를 스스로 관리하는 방식을 설명한 문장이다.

클로드 코드 새 대화, 끝난 작업과 관계없는 일을 나눈다

보고서 오류를 고친 뒤 전혀 다른 화면의 문구를 다듬는다면, 앞선 오류 기록이 새 판단에 도움이 되는지 따져 볼 일이다. 공식 명령 문서에서 clear는 빈 컨텍스트의 새 대화를 시작하며, 같은 대화를 요약해 이어갈 때는 compact를 쓰도록 구별한다. 이 차이가 새 대화로 나눌지를 고르는 출발점이다.

긴 대화가 사용량에도 영향을 준다는 설명은 비용 문서에 있다. 클로드 코드는 요청마다 대화 전체를 보내므로, 끝난 작업의 맥락이 뒤의 요청에도 계속 실린다. 캐시가 있어도 긴 대화가 요청에서 빠지는 것은 아니다. 이 글에서는 토큰 단가나 절감률을 계산하지 않는다. 관계없는 내용을 계속 참고할 이유가 있는지만 따진다.

새 대화를 시작할 때 떠나는 대화에 이름을 붙일 수 있다. 공식 권장 사항도 /clear oauth-migration처럼 이름을 붙여 두면 나중에 그 대화로 돌아올 수 있다고 예를 든다. 아래 이름은 가상의 보고서 수정 작업을 구별하려고 정한 예시다. 나중에 어떤 일을 찾을지 드러나는 이름이면 된다.

/clear report-fix

/clear 뒤 새 대화에 넘길 첫 요청

1. 이전 작업의 인계 메모를 검토한 뒤 위 명령으로 새 대화를 연다. 잘 됐으면 이전 대화가 이어지지 않고 빈 입력란에서 새로 시작한다. 명령이 일반 부탁처럼 처리되면 입력란 맨 앞이 / 로 시작하는지 다시 본다.
2. 새 작업의 목표와 대상, 완료 조건을 보낸다. 잘 됐으면 첫 답이 새 목표를 기준으로 필요한 파일을 찾거나 확인할 내용을 묻는다. 이전 대화에만 적었던 요구사항이 필요하다면 이번 요청에 직접 적는다.
3. 이전 작업을 계속해야 했다면 아래 명령으로 세션 선택기를 연다. 세션은 클로드 코드를 켜서 이어 가는 대화 한 묶음이다. 잘 됐으면 이름을 붙인 대화가 목록에 보인다. 클로드 코드는 세션을 프로젝트 폴더마다 따로 저장하므로, 다른 폴더에서 시작한 대화는 이 목록에 안 보일 수 있다.

/resume

새 작업을 시작하며 이전 대화를 통째로 다시 붙이면, 나눌 때 덜어 낸 내용이 곧바로 돌아온다. 필요한 결론이 있다면 그 결론과 근거 파일만 넘기는 편이 이 글의 목적에 맞는다. 문구 수정을 맡기는데 보고서 오류의 모든 시도를 보낼 필요는 없다. 고칠 화면 파일과 원하는 표현 기준이면 된다.

이번 목표는 보고서 화면의 안내 문구를 고치는 것이다.
대상은 프로젝트에서 실제로 쓰는 보고서 화면 파일이다.
먼저 대상 파일의 위치를 찾아 알려 줘.
사용자가 입력할 내용과 오류가 난 이유를 구별해서 설명해야 한다.
앞선 오류 수정 작업의 코드는 바꾸지 않는다.
완료 조건은 수정한 문구와 바뀐 위치를 대조할 수 있는 것이다.

위 요청은 가상의 예시다. 대상 파일 이름을 지어 넣지 않고 위치부터 찾도록 했다. 기존 수정과 새 목표가 같은 파일에서 겹친다면, 바뀐 범위를 먼저 읽고 문구 수정에 들어간다. 새 대화를 열었다고 작업 범위까지 저절로 나뉘지는 않으므로 대상과 조건을 직접 적는다.

재개도 압축을 없던 일로 만들지는 않는다. 공식 세션 문서는 압축된 대화를 재개할 때 마지막 요약, 요약하지 않고 남긴 메시지, 그 이후 메시지로 이어 간다고 설명한다. 마지막 압축이 요약한 메시지는 다시 로드하지 않는다. 기록을 찾는 일과, 요약 전 원문 전체를 클로드의 참고 내용으로 되돌리는 일은 다르다.

이 표는 대화를 잇는 일과 근거를 되찾는 일을 나눠 고르기 위한 것이다. 클로드 앱의 지난 대화 메모리를 관리하려는 분은 클로드 메모리와 지난 대화 찾기를 보면 된다. 클로드 코드의 세션 선택기와 클로드 앱의 메모리 설정을 같은 화면으로 생각하면 메뉴를 찾다가 막히기 쉽다.

클로드 코드 컨텍스트, 계속 지킬 규칙은 파일에 둔다

압축할 때마다 같은 금지 사항을 다시 말한다면, 그 내용이 매번 필요한 프로젝트 규칙인지 볼 만하다. 공식 메모리 문서는 프로젝트 루트의 CLAUDE.md가 압축 뒤 디스크에서 다시 읽혀 세션에 주입된다고 설명한다. 하위 디렉터리의 중첩 파일과 경로 조건이 붙은 규칙은 필요할 때 다시 로드된다. 같은 파일 이름이라도 놓인 자리와 조건에 따라 다시 들어오는 때가 다르다.

CLAUDE.md는 프로젝트에서 계속 참고할 지침을 적는 마크다운 파일이다. 여기에는 작업마다 바뀌는 상태보다 검증 명령, 바꾸면 안 되는 대상, 공통 작성 규칙처럼 다음 대화에도 필요한 내용을 둔다. 어느 오류가 아직 미완료인지는 인계 메모에 두면, 해결된 문제가 영구 규칙에 쌓이지 않는다.

공식 권고는 CLAUDE.md 파일당 200줄 이하를 목표로 한다. 같은 문서는 200줄을 넘는 파일이 컨텍스트를 더 차지하고, 지시를 따르는 정도도 떨어질 수 있다고 적는다. 긴 파일을 다른 파일로 나눠 가져오기(@경로로 다른 파일을 불러 붙이는 기능)를 써도 참고 비용은 줄지 않는다. 가져온 파일도 그 CLAUDE.md와 함께 로드되기 때문이다. 모든 대화에 필요한 규칙과 특정 작업에만 필요한 설명부터 나누는 편이 낫다.

compact 뒤 CLAUDE.md 규칙이 빠진 것 같을 때

1. 아래 첫 명령으로 CLAUDE.md 파일과 자동 메모리 항목을 연다. 잘 됐으면 지키려던 내용이 파일에 있는지 알 수 있다. 대화에서만 말한 규칙이었다면 프로젝트 공통 규칙인지 따져 본 뒤 파일에 옮긴다.
2. 둘째 명령으로 컨텍스트 전체 내역을 열고 로드된 메모리 파일을 본다. 잘 됐으면 필요한 파일 이름이 목록에 나온다. 안 보이면 규칙이 다른 프로젝트에 있거나 경로 조건이 아직 맞지 않았는지 살핀다.
3. 실제 대상 파일의 필요한 부분을 읽고 규칙을 요약하게 한다. 잘 됐으면 적용할 조건과 바꿀 범위가 맞는다. 규칙끼리 부딪친다면 대화를 더 압축하기 전에 원문의 충돌부터 푼다.

/memory

/context all

스킬(반복 작업의 지침을 필요할 때 불러 쓰는 묶음)도 압축 뒤의 모습이 정해져 있다. 공식 변경 기록의 2.1.304 항목에는 압축 뒤 스킬 목록을 클로드에게 다시 보내도록 바꿨다는 줄이 있다. 이미 불러 쓴 스킬 본문은 압축 뒤 다시 넣되, 스킬당 5,000토큰과 합계 25,000토큰까지만 넣고 오래된 것부터 뺀다고 컨텍스트 문서는 적는다. 긴 스킬을 여럿 쓴 대화라면 압축 뒤 오래된 스킬의 지침이 빠졌는지 확인한다. 설정을 바꾸기 전에 쓰는 버전과 그 기능의 조건을 함께 읽는다.

/autocompact 200000

/autocompact auto

참고 내용이 덜 쌓이게 하는 방법도 있다. 긴 조사 결과가 계속 주 대화로 들어온다면 서브에이전트(주 대화와 떨어진 공간에서 일을 맡아 하고 요약만 돌려주는 보조 클로드)에 조사를 맡기고 결론만 받는 구성을 검토할 수 있다. 공식 문서는 서브에이전트가 별도 컨텍스트에서 일하지만 자체 요청은 주 대화와 같은 사용 한도에 포함된다고 설명한다. 주 대화의 공간을 덜 쓰는 것과 전체 사용량이 줄어드는 것은 따로 따질 문제다.

설정 방법은 클로드 코드 서브에이전트 안내에, 지속 규칙을 쓰는 법은 CLAUDE.md 쓰는 법에 있다. 이 글의 인계 메모에는 조사 원문을 모두 붙이기보다 결론을 받쳐 주는 파일 위치와 다음 검증을 남긴다. 근거로 돌아갈 길이 남아 있으면 요약을 짧게 두면서도 검토를 이어 갈 수 있다.

자주 묻는 것

compact를 쓰면 모든 파일 내용이 그대로 남나?

그렇게 보장하지 않는다. 공식 문서는 압축 뒤 다시 읽는 파일을 최대 5개로 설명하고, 5,000토큰을 넘는 파일은 내용 대신 경로 참조로 돌아온다고 적는다. 이어서 필요한 근거는 경로와 읽을 부분을 지정한다. 요약이 같은 목표를 가리키는지와 중요한 파일을 실제로 읽었는지는 따로 살핀다.

clear를 하면 이전 작업으로 돌아갈 수 없나?

돌아갈 수 있다. 공식 세션 문서는 작업하는 동안 세션이 로컬 기록 파일에 계속 저장되므로, 종료하거나 clear를 실행한 뒤에도 그 세션으로 돌아올 수 있다고 설명한다. 이름을 붙여 새 대화를 시작하면 나중에 찾기 편하다. 다만 압축된 대화를 재개한다고 요약된 메시지 전체가 다시 들어오지는 않는다.

CLAUDE.md가 있는데도 앞선 지시가 사라진 이유는 무엇인가?

그 지시가 대화에만 있었는지, 프로젝트 루트가 아닌 하위 파일에 있었는지, 경로 조건이 아직 맞지 않았는지 나눠 본다. 메모리 파일을 열어 내용이 있는지 보고, 컨텍스트 내역에서 무엇이 로드됐는지 살핀다. 파일에 적었다는 사실과 그 대화에 들어왔다는 사실을 구별하면 원인을 좁히기 쉽다. 규칙을 되살린 뒤에도 답이 어긋나면, 이번 변경에 적용할 조건을 클로드가 직접 말하게 한다. 그 조건을 실제 요청과 대조하면 빠진 지시인지, 서로 부딪치는 지시인지 가릴 수 있다.

컨텍스트가 줄면 사용 한도도 바로 초기화되나?

컨텍스트를 줄이는 일과 계정의 사용 한도는 다른 문제다. 압축은 대화를 요약하는 기능이며, 긴 대화의 압축 요청 자체에도 처리 비용이 든다. clear를 사용 한도를 채우는 명령으로 이해하지 않는다. 새 작업에 관계없는 맥락을 보내지 않도록 나누는 데 목적이 있다.

정리 — 다음 판단에 필요한 맥락을 남긴다

클로드 코드 컨텍스트가 길어지면 먼저 사용 내역을 보고 다음 작업에 앞선 결정이 필요한지 따진다. 같은 수정이 계속되면 확정 사실과 미완료 검사를 남겨 압축하고, 관계없는 목표로 바뀌면 이전 대화에 이름을 붙여 새로 시작한다. 다시 돌아올 기록은 세션 선택기로 찾고, 빠진 파일 근거는 필요한 부분을 다시 읽는다.

인계 메모에서 놓치면 안 되는 구별은 끝난 일과 아직 확인하지 않은 일이다. 지속 규칙은 CLAUDE.md에, 지금 상태는 메모에 두면 압축 뒤에도 출발점을 대조하기 쉽다. 압축 뒤 답이 엇나간다면 위 인계 메모 양식부터 한 번 채워 보는 것으로 시작하면 된다.

참고 자료

1. Anthropic. How Claude Code works — 컨텍스트 구성과 대화 요약, Compact Instructions 절(2026-11-13 확인). code.claude.com
2. Anthropic. 명령어 — /context all·/compact·/clear·/resume·/memory의 구문과 역할(2026-11-13 확인). code.claude.com
3. Anthropic. 컨텍스트 윈도우 살펴보기 — 압축 뒤 파일 재읽기와 경로 참조, 스킬 본문 재주입 조건(2026-11-13 확인). code.claude.com
4. Anthropic. Claude가 프로젝트를 기억하는 방법 — 루트·중첩 CLAUDE.md와 권장 길이, 가져오기(2026-11-13 확인). code.claude.com
5. Anthropic. Manage sessions — /clear 뒤 재개, 폴더별 세션 저장, 압축된 세션의 복원 범위(2026-11-13 확인). code.claude.com
6. Anthropic. Manage costs effectively — 긴 대화의 반복 입력과 압축 요청의 크기(2026-11-13 확인). code.claude.com
7. Anthropic. 모델 구성 — 자동 압축 경계와 명령·환경변수의 숫자 해석 차이(2026-11-13 확인). code.claude.com
8. Anthropic. Create custom subagents — 별도 컨텍스트의 조사와 같은 사용 한도에 포함되는 요청(2026-11-13 확인). code.claude.com
9. Anthropic. Best practices — 초점을 지정한 압축, 캐시 유지 시간, 두 번 바로잡은 뒤 새로 시작하는 기준(2026-11-13 확인). code.claude.com
10. Anthropic claude-code. CHANGELOG 2.1.304 — 압축 뒤 스킬 목록을 다시 보내도록 바꾼 기록(2026-11-13 확인). raw.githubusercontent.com