클로드 코드 compact·clear·rewind 차이: 지워지는 것과 남는 것

이 글 순서

1. 셋이 하는 일
2. /compact 가 남기는 것
3. 자동 압축은 언제
4. /clear 하면 생기는 일
5. /rewind 로 되돌리기
6. 되돌리지 못하는 것
7. 일부만 요약하기
8. 사용량은 어떻게
9. 언제 무엇을 쓸까
10. 한국에서 되나
11. 코덱스·제미나이 CLI 는 어떨까
12. 참고한 자료

클로드 코드를 오래 붙잡고 있으면 자동 압축 안내가 뜨거나, 아까 분명히 말한 걸 클로드가 잊은 듯한 순간이 와요. 이때 손이 가는 명령이 셋이에요. /compact, /clear, /rewind. 셋 다 대화를 줄이는 명령처럼 보이지만 지우는 것과 남기는 것이 꽤 달라요.

클로드 코드 명령·체크포인트·컨텍스트 윈도우·세션·비용 문서를 2026년 10월 7일에 읽고 세 명령만 비교해 적었어요. 캐시가 몇 분 버티는지, /compact 가 캐시를 어떻게 다시 쌓는지는 클로드 코드 프롬프트 캐시 글에 따로 있어요. 문서에서 찾지 못한 것은 “미확인”으로 적었어요.

셋이 하는 일

공식 명령 표에 적힌 설명부터 보면 이래요. /clear 는 빈 컨텍스트로 새 대화를 시작하고, /compact 는 지금까지의 대화를 요약해서 자리를 비우고, /rewind 는 대화나 코드를 앞 지점으로 되돌리거나 고른 메시지부터 요약해요.

그림은 명령 표에서 네 줄만 남기고 다른 명령 줄은 가렸어요. /clear 는 /reset·/new 로, /rewind 는 /checkpoint·/undo 로 쳐도 같은 명령이에요.

명령	대화	파일	사용량
/compact	요약 하나로 바꿈	그대로	요약 요청 한 번
/clear	비우고 새로 시작	그대로	들지 않음
/rewind	고른 차례로 되돌림	클로드가 고친 것 되돌림	앞서 캐시된 부분 다시 씀

출처: 클로드 코드 명령·세션·체크포인트·비용·프롬프트 캐싱 문서. 10월 7일 확인.

세 명령 모두 클로드 코드 안에서 바로 쳐요. 지금 무엇이 자리를 차지하는지는 /context 가 색칠한 칸으로 보여 줘요. CLAUDE.md, 읽은 파일, 도구 결과 가운데 무엇이 큰지 보고 셋 중 무엇을 쓸지 고르면 돼요.

/compact 가 남기는 것

/compact 는 지금까지의 대화를 구조화된 요약 하나로 바꿔요. 같은 세션 안에서 이어 가니까 하던 일의 흐름은 남고, 컨텍스트 윈도우(한 번에 읽을 수 있는 양, 아래에선 줄여서 창) 자리는 비어요. 뒤에 챙길 것을 붙이면 요약이 그쪽을 더 챙겨요. 예를 들어 /compact focus on the API changes 처럼요.

요약 말고도 따로 다시 들어오는 것이 있고, 요약에 묻혀 빠지는 것도 있어요.

무엇	압축 뒤
시스템 프롬프트·출력 스타일	그대로
프로젝트 CLAUDE.md·자동 메모리	디스크에서 다시 읽음
계획 모드에서 쓴 계획	디스크에서 다시 읽음
읽거나 고친 파일	최근 바뀐 것 다섯 개까지
불러 쓴 스킬 본문	하나 5천·합계 2만 5천 토큰까지
paths 규칙·하위 폴더 CLAUDE.md	요약에 묻힘, 그 파일 읽을 때 다시
훅이 넣은 내용	대화와 같이 요약
백그라운드 명령·서브에이전트	계속 실행됨

출처: 클로드 코드 문서 “Explore the context window”의 What survives compaction 표. 10월 7일 확인.

다시 읽는 파일이 5,000 토큰을 넘으면 내용 없이 경로만 남아요(화면에 Read 대신 Referenced file 로 표시). 스킬은 합계 한도를 넘으면 오래 전에 호출한 것부터 빠지고, 하나가 5천 토큰을 넘으면 앞부분만 남아요. 처음 켤 때 올라오던 스킬 설명 목록은 압축 뒤에 다시 넣지 않아서, 실제로 불러 쓴 스킬만 남아요.

그래서 문서는 대화 내내 지켜야 할 규칙은 말로 하지 말고 CLAUDE.md 에 적어 두라고 해요. CLAUDE.md 에 “Compact instructions” 절을 두면 요약할 때마다 챙길 것을 미리 정해 둘 수도 있어요. 문서 예시는 “고친 파일 목록과 테스트 명령은 꼭 남기기”예요.

자동 압축은 언제

창이 거의 차면 클로드 코드가 알아서 압축해요. 먼저 오래된 도구 출력부터 비우고, 그래도 모자라면 대화를 요약해요. 요약하는 방식은 /compact 와 같아요. 다만 문서는 일 도중에 자동 압축이 돌면 대화 초반의 자세한 지시가 빠질 수 있다고 적었어요.

언제 도느냐는 모델이 쓰는 창 크기에 달려요. Fable 5.1·Fable 5, Sonnet 5 이후, Haiku 5.5, Opus 4.7 이후 모델은 따로 정하지 않아도 100만 토큰 창으로 돌고(10월 10일 모델 설정 문서), 따로 정하지 않으면 약 96만 7천 토큰에서 압축해요. Opus 4.6·Sonnet 4.6을 기본 창으로 쓰거나 CLAUDE_CODE_DISABLE_1M_CONTEXT=1 을 켜 두면 20만 토큰 경계에서 압축해요.

더 일찍 압축하게 하려면 /autocompact 500k 처럼 값을 주면 돼요. 지금 모델용으로 사용자 설정에 저장되고 이번 세션부터 바로 적용돼요(v2.1.221 이상, 모델마다 따로 저장하는 건 v2.1.288부터). /autocompact auto 로 원래대로 돌아가요. 값은 10만에서 100만 토큰 사이이고, 모델 창보다 크게 잡아도 창 크기에서 멈춰요. 설정 파일의 autoCompactWindow, 실행할 때 붙이는 --autocompact, 환경 변수 CLAUDE_CODE_AUTO_COMPACT_WINDOW 로도 정할 수 있고, 환경 변수가 가장 우선이에요.

자동 압축을 아예 끄려면 /config 의 Auto-compact 를 끄거나(설정 autoCompactEnabled false) 환경 변수 DISABLE_AUTO_COMPACT=1 을 켜요. 이때도 /compact 는 손으로 쓸 수 있어요. DISABLE_COMPACT=1 은 /compact 까지 막는 설정이라 헷갈리지 마세요. 문서는 200K 로 묶어 둔 세션에서 자동 압축을 끄면 압축하는 대신 길이 초과 오류로 멈춘다고 적었어요.

“Autocompact is thrashing” 오류가 뜨면, 압축은 됐는데 큰 파일이나 도구 출력이 곧바로 창을 다시 채우기를 몇 번 반복했다는 뜻이에요. 클로드 코드가 헛도는 걸 막으려고 자동 압축을 멈춘 거예요. 문서가 권하는 대처는 큰 파일을 줄 범위로 나눠 읽게 하기, /compact keep only the plan and the diff 처럼 큰 출력을 빼고 요약하기, 큰 파일 작업을 서브에이전트로 넘기기, 앞 대화가 필요 없으면 /clear 예요.

/clear 하면 생기는 일

/clear 는 빈 컨텍스트로 새 대화를 시작해요. 그래도 프로젝트 기억은 남아요. CLAUDE.md 와 자동 메모리는 새 대화가 시작될 때 다시 읽기 때문이에요. 명령 문서 말로는 “프로젝트 메모리는 둔 채 새 일을 시작”하는 명령이에요. 지운 대화도 사라지지는 않아요.

• /resume: 대화 기록은 계속 저장되고 있어서 /clear 전 대화를 목록에서 골라 다시 열 수 있어요.
• /rewind 맨 위 항목: 그 사이 클로드 코드를 끄지 않았다면 /rewind 메뉴 맨 위에 “/resume <session-id> (previous session)” 항목이 생겨요. 클로드 코드를 끄거나 다른 세션을 열면 사라져요.
• /clear 이름: /clear release-prep 처럼 이름을 주면 떠나는 대화에 그 이름이 붙어 /resume 목록에서 찾기 쉬워요. 비용 문서는 /clear 전에 /rename 으로 이름을 붙여 두라고 권해요.

/usage 맨 위 Session 칸의 토큰·달러 합계도 /clear 하면 0부터 다시 세요(v2.1.211부터, 그 전에는 클로드 코드를 끌 때까지 쌓였어요). 문서는 이 칸이 API 사용자용 추정치이고 Pro·Max 구독자는 같은 화면의 요금제 사용량 막대를 보면 된다고 적었어요. 5시간·주간 한도가 언제 풀리는지는 클로드 사용량 초기화 글에 있어요.

문서가 /clear 를 권하는 때는 둘이에요. 관계없는 일로 넘어갈 때, 그리고 같은 문제로 클로드를 두 번 넘게 바로잡았을 때예요. 두 번째 경우엔 컨텍스트가 실패한 시도로 어지러워진 상태라서, /clear 하고 그동안 알게 된 점을 넣은 더 구체적인 첫 요청으로 다시 시작하는 쪽이 거의 언제나 낫다고 적었어요.

/rewind 로 되돌리기

클로드 코드는 차례를 시작하는 요청을 보낼 때마다 그 직전 코드 상태를 체크포인트로 저장해 둬요. 입력 칸이 비어 있을 때 Esc 를 두 번 누르거나 /rewind 를 치면 이번 세션에서 보낸 요청 목록이 뜨고, 하나를 골라 할 일을 정해요. 입력 칸에 글이 있으면 Esc 두 번은 글만 지우니(위 화살표로 다시 불러올 수 있어요) 칸을 비운 뒤 눌러요.

메뉴	대화	코드
Restore code and conversation	그때로	그때로
Restore conversation	그때로	지금 그대로
Restore code	지금 그대로	그때로
Summarize from here	그 뒤를 요약	그대로
Summarize up to here	그 앞을 요약	그대로

출처: 클로드 코드 체크포인트 문서 Rewind and summarize. 10월 7일 확인.

코드를 되돌리는 두 옵션은 고른 지점 뒤로 클로드가 고친 파일이 있을 때만 떠요. 대화를 되돌리면 그때 보냈던 요청이 입력 칸에 다시 들어와서, 고쳐서 다시 보낼 수 있어요.

체크포인트는 세션마다 최근 100개까지 파일 사본을 들고 있어요. 대화와 같이 저장돼서 클로드 코드를 껐다가 세션을 다시 열어도 /rewind 가 돼요. 다만 사본은 기본으로 그 세션이 마지막으로 사본을 남긴 뒤 30일쯤 지나면 정리되고, 그 뒤엔 “No files were restored” 로 실패할 수 있어요. 더 오래 두려면 설정 cleanupPeriodDays 를 늘려요.

되돌리지 못하는 것

체크포인트는 클로드의 파일 편집 도구로 고친 것만 따라가요. 그 밖의 길로 바뀐 파일은 /rewind 로 돌아오지 않아요.

이렇게 바뀐 것	/rewind 로
Bash 명령(rm·mv·cp 등)	못 되돌림
서브에이전트가 고친 파일	대부분 못 되돌림
내가 직접 고친 파일·다른 세션	보통 안 잡힘
일하는 도중 끼워 보낸 메시지	그 차례 통째로만
심볼릭 링크·하드 링크 파일	건너뜀(경고 표시)
DB·API·배포 같은 바깥 시스템	못 되돌림

출처: 클로드 코드 체크포인트 문서 Limitations, “How Claude Code works”의 체크포인트 절. 10월 7일 확인.

서브에이전트 가운데 앞에서 도는 fork 스킬(context: fork 스킬을 background: false 로 돌린 것)만 내 턴 안에서 고치는 거라 되돌려져요. 기본인 백그라운드 fork 스킬, 백그라운드로 돈 /code-review --fix 를 포함한 나머지 서브에이전트가 고친 파일은 git 으로 되돌리라고 문서가 적었어요. 클로드가 일하는 도중에 끼워 보낸 메시지는 그 차례에 합쳐지면 체크포인트가 따로 생기지 않아서, 되돌리려면 그 차례를 시작한 요청으로 돌아가야 해요.

문서도 체크포인트는 세션 안에서 빨리 되돌리는 용도이고 git 같은 버전 관리를 대신하지 않는다고 적었어요. 제 생각에는 파일을 지우거나 옮기는 일이 섞인 큰 작업을 맡기기 전에는 커밋을 하나 해 두는 편이 마음 편해요.

일부만 요약하기

/compact 는 대화 전체를 요약하지만, /rewind 메뉴의 Summarize 두 가지는 고른 지점을 기준으로 한쪽만 요약해요. 문서는 이걸 “겨냥한 /compact”라고 불러요.

Summarize from here 는 고른 지점부터 뒤를 요약하고 앞은 그대로 둬요. 처음에 길게 설명한 요구 사항은 남기고, 그 뒤로 길어진 디버깅만 줄이고 싶을 때 맞아요. Summarize up to here 는 반대로 그 앞을 요약하고 최근 대화는 그대로 둬요. 두 경우 모두 요약한 자리에 Summarized conversation 표시가 남아요.

화살표 키로 Summarize 항목에 올라가 add context (optional) 자리에 요약할 때 챙길 것을 적고 Enter 를 누르면 그 안내대로 요약해요. 숫자 키로 바로 고르면 안내 없이 요약해요. 요약해도 디스크의 파일은 바뀌지 않고, 원래 메시지도 대화 기록 파일에는 남아 있어요.

지금 대화는 그대로 두고 다른 방법을 따로 시험해 보고 싶다면 요약보다 /branch 가 맞아요. 지금 지점에서 브랜치를 만들어 그쪽으로 옮겨 가고, 원래 대화는 /resume 으로 돌아갈 수 있게 남겨 둬요.

사용량은 어떻게

클로드 코드는 요청마다 대화 전체를 실어 보내요. 비용 문서는 그래서 하루 종일 열어 둔 세션에서는 한 줄 질문도 대화 전체만큼 사용량을 쓴다고 적었어요. 대화를 줄이는 게 곧 사용량을 줄이는 일이에요.

세 명령이 드는 값은 서로 달라요. 비용 문서는 /clear 에 드는 비용이 없다고 적었어요. /compact 는 요약을 만들려고 대화 전체를 읽는 요청을 따로 보내니 그 자체가 큰 요청이에요. /rewind 는 예전에 캐시된 앞부분으로 돌아가는 거라 다음 요청이 그 캐시를 다시 읽어요. 캐시가 살아 있을 때와 식은 뒤 /compact 값이 얼마나 달라지는지는 프롬프트 캐시 글의 “/compact 는 언제” 절에 계산과 같이 있어요.

언제 무엇을 쓸까

여기부터는 위 문서들을 놓고 본 제 생각이에요.

이럴 때	쓸 것	이유
같은 일을 잇는데 창이 참	/compact + 챙길 것	흐름은 남고 자리만 빔
관계없는 일로 넘어감	/clear	비용 없음, 옛 컨텍스트가 방해
방금 몇 차례가 엇나감	/rewind	코드·대화 같이 되돌림
같은 실수를 두 번 넘게 고침	/clear 후 새 요청	실패한 시도가 쌓임
첫 지시만 두고 줄이기	Summarize from here	앞부분은 그대로
다른 방법을 따로 시험	/branch	원래 대화를 남김

출처: 위 공식 문서들을 보고 고른 제 의견. 10월 7일 기준.

자동 압축을 기다리기보다 일과 일 사이에 직접 /compact 하는 편을 권해요. 무엇을 남길지 내가 정할 수 있고, 일 도중에 요약이 끼어들어 초반 지시가 빠지는 일도 줄어요. 압축 뒤에도 꼭 지켜야 할 규칙이 있다면 대화 대신 CLAUDE.md 에 두세요. 그리고 Bash 로 파일을 많이 건드리는 일은 /rewind 를 믿기보다 시작 전에 커밋부터 해 두는 게 낫다고 봐요.

한국에서 되나

클로드 코드와 Pro·Max 는 한국에서 가입해 쓸 수 있어요(Anthropic 지원 국가 목록에 South Korea). 명령 표 위에는 플랫폼·요금제·환경에 따라 안 보이는 명령이 있다고 적혀 있는데, 예로 든 건 /desktop·/upgrade 이고 세 명령에는 요금제나 나라 조건이 따로 적혀 있지 않아요. 세 명령이 언제부터 있었는지는 문서에서 찾지 못했어요(미확인). 이 글에 나온 버전은 /autocompact v2.1.221 이상, 모델마다 저장 v2.1.288부터, /clear 할 때 /usage 합계가 0이 되는 건 v2.1.211부터예요. 요금제를 고르는 이야기는 클로드 Pro Max 차이 글에 있어요.

코덱스·제미나이 CLI 는 어떨까

OpenAI 의 코덱스 CLI 와 구글의 제미나이 CLI 에도 비슷한 명령이 있어요. 문서에 적힌 것만 같은 줄에 놓으면 이래요.

하는 일	클로드 코드	코덱스 CLI	제미나이 CLI
요약으로 줄이기	/compact	/compact	/compress
자동으로 줄이는 때	약 96만 7천 토큰(100만 창 모델)	모델 기본값, 숫자 없음	창의 50%
새로 시작	/clear	/new, /clear	/clear
파일 되돌리기	/rewind	공식 안내 없음, git 권함	/rewind

출처: 코덱스 CLI 명령·설정 문서, 제미나이 CLI 명령·Rewind·설정 문서. 10월 7일 확인.

제미나이 CLI 의 /rewind 도 Esc 두 번으로 열고, AI 의 편집 도구가 고친 파일만 되돌려요. 코덱스 CLI 는 Esc 두 번이 앞 메시지를 고쳐 대화를 분기하는 기능이고, 파일이 같이 돌아가는지는 문서에 없어요. 요금제·캐시·서브에이전트까지 비교한 표는 클로드 코드·코덱스·제미나이 CLI 비교 글에 있어요.

이 글의 내용은 2026년 10월 7일 기준이에요.

같이 보면 좋은 글: 클로드 코드 프롬프트 캐시 1시간·5분: 끊기는 때와 한도·크레딧 아끼는 법

같이 보면 좋은 글: 클로드 Pro Max 차이: 22달러·110달러·220달러, 클로드 코드 쓰는 양 따라 고르기

같이 보면 좋은 글: 클로드 사용량 초기화: 5시간·주간 한도 언제 풀리고 어디서 확인할까

같이 보면 좋은 글: AI 비교 2026: 클로드·챗GPT·제미나이 요금제·한도·기능 표

같이 보면 좋은 글: 클로드 코드 서브에이전트 사용법: 컨텍스트 아끼기, 만드는 법, 모델 정하기

이 글이 들어간 총정리: 클로드 코드 사용량 아끼는 법

같이 보면 좋은 글: 클로드 코드 단축키 모음: 줄바꿈·Esc 두 번부터 keybindings.json·vim 모드까지

같이 보면 좋은 글: 클로드 코드 오류 해결: 529·Prompt is too long·로그인 오류 뜰 때 할 일

같이 보면 좋은 글: 클로드 코드 이전 대화 이어 하기: claude -c·-r·/resume 쓰는 법, 이름 붙이기와 30일 삭제

같이 보면 좋은 글: 클로드 코드 /simplify 사용법: 바꾼 코드 다듬기 한 줄부터 /code-review 차이·되돌리기까지

같이 보면 좋은 글: 클로드 코드 /context 사용법: 대화 창 얼마나 찼나 보기부터 줄이는 순서·창 크기까지

같이 보면 좋은 글: 클로드 코드 /branch·/fork·/subtask 차이: 대화를 복사해 다른 방향으로, 처음 쓰는 법부터 서브에이전트와 다른 점까지

참고한 자료

2026년 10월 7일에 확인했어요.

• Commands (클로드 코드 공식 문서, /compact·/clear·/rewind·/autocompact·/context·/branch)
• Checkpointing (클로드 코드 공식 문서, rewind 메뉴·체크포인트 100개·30일·되돌리지 못하는 것)
• Explore the context window (클로드 코드 공식 문서, 압축 뒤 남는 것)
• How Claude Code works (클로드 코드 공식 문서, 컨텍스트가 찰 때·체크포인트)
• Model configuration (클로드 코드 공식 문서, 100만 토큰 창·자동 압축 시점)
• Settings reference (클로드 코드 공식 문서, autoCompactEnabled·autoCompactWindow·cleanupPeriodDays)
• Environment variables (클로드 코드 공식 문서, DISABLE_AUTO_COMPACT·DISABLE_COMPACT)
• Troubleshooting (클로드 코드 공식 문서, Autocompact is thrashing)
• Manage sessions (클로드 코드 공식 문서, /clear 뒤 되찾기·/branch)
• Manage costs effectively (클로드 코드 공식 문서, /clear 비용 없음·/usage 합계)
• Best practices for Claude Code (클로드 코드 공식 문서, 세션 다루기)
• Interactive mode (클로드 코드 공식 문서, Esc 두 번)
• How Claude Code uses prompt caching (클로드 코드 공식 문서, /compact·/rewind 와 캐시)
• Supported countries (Anthropic, 지원 국가 목록)
• Developer commands (OpenAI 코덱스 공식 문서, CLI 의 /compact·/new·/clear·Esc 두 번)
• Configuration Reference (OpenAI 코덱스 공식 문서, model_auto_compact_token_limit)
• CLI commands (제미나이 CLI 공식 문서, /compress·/clear·/rewind)
• Rewind (제미나이 CLI 공식 문서, 되돌리는 범위)
• Configuration (google-gemini/gemini-cli 저장소 문서 v0.63.0, model.compressionThreshold 기본 0.5)