클로드 코드(Claude Code)로 하나의 프로젝트를 오래 이어가다 보면 대화가 길어지고, 앞선 대화 내용이 새 작업에 영향을 주기도 합니다. 터미널을 닫았다가 다시 열었을 때 이전 작업을 어떻게 이어야 할지도 고민이 됩니다. 대화가 길어질 때 컨텍스트를 확인하고, 정리하고, 다시 이어가는 데 쓰는 명령어 5가지를 상황별로 정리했습니다.

■ 컨텍스트란 무엇이고 관리가 필요한 이유

컨텍스트(context)는 클로드 코드가 현재 세션에서 기억하고 있는 모든 대화 내용과 작업 정보입니다. 대화가 길어질수록 컨텍스트가 차지하는 토큰이 늘어나고, AI가 기억할 수 있는 공간은 줄어듭니다.

자동 압축(auto-compact)은 컨텍스트가 실행 임곗값에 도달하면 오래된 대화를 압축해 토큰 사용량을 줄인 뒤 작업을 계속하는 기능입니다. 클로드 코드는 컨텍스트가 임곗값에 가까워지면 자동 압축까지 남은 컨텍스트 비율을 경고 메시지로 알려 줍니다.

자동 압축의 한계는 정보 손실 가능성입니다. 클로드가 전체 대화의 일부를 자동으로 요약하는 과정에서 정보가 빠질 수 있고, 작업 단위를 끝까지 마무리하지 않은 중간 지점에서 요약이 일어나기도 합니다. 따라서 자동 압축이 일어나기 전에 컨텍스트 상태를 수시로 확인하고, 적절한 시점에 직접 압축하는 것이 좋습니다.

■ /context와 /compact로 컨텍스트를 관리하는 방법

/context는 현재 컨텍스트 상태와 사용량을 확인하는 명령어입니다. 클로드 코드에 /context를 입력하면 현재까지의 컨텍스트 사용량을 컬러 그리드로 시각화해 보여 줍니다.

/context 화면은 전체 사용량을 토큰 한도 대비 비율로 표시하고, 항목별 사용량을 나누어 보여 줍니다. 실습 예시에서 전체 사용량은 93k/200k 토큰(46%)이며, 시스템 프롬프트 3.1k(1.5%), 시스템 도구 11.5k(5.7%), 메모리 파일 84토큰(0.0%), 메시지 78.0k(39.0%), 여유 공간 107.4k(53.7%)로 구성됩니다. 토큰 한도는 구독 플랜에 따라 다릅니다.

:context 실행 화면(컨텍스트 사용량 컬러 그리드).png

[/context 실행 화면(컨텍스트 사용량 컬러 그리드)]

/compact는 현재까지의 대화 내용을 요약해 컨텍스트 공간을 확보하는 압축 명령어입니다. /compact는 대화 기록을 지우고 요약본을 남겨 두는 방식으로 동작합니다. 명령어 뒤에 요약 지침을 붙여 /compact [요약 지침] 형태로 쓸 수도 있습니다. 예를 들어 /compact 코드 변경사항 위주로 요약해 줘와 같이 입력하면 클로드 코드는 해당 지침에 맞춰 요약합니다.

/compact 실행 결과는 압축 완료 메시지로 확인합니다. 실습 화면에서는 압축이 끝나면 'Compacted (ctrl+o to see full summary)' 메시지가 표시되고, 화면 하단의 auto-compact 경고 메시지가 사라집니다. 안내에 따라 Ctrl + O 키를 누르면 압축 과정에서 생성된 전체 요약을 보고, 중요한 작업 내용이 제대로 보존되었는지 확인할 수 있습니다.

/compact의 압축 효과는 /context로 다시 확인할 수 있습니다. 실습 예시에서 압축 후 메시지(Messages)는 78.0k에서 1.9k로 줄었고, 여유 공간(Free space)은 107.4k(53.7%)에서 183.4k(91.7%)로 늘어났습니다. 컨텍스트 압축은 대화 내용만 요약하고, 프로젝트에 필요한 시스템 프롬프트, 도구, 메모리 파일은 그대로 유지합니다.

[압축 후 /context 실행 화면]

■ /clear와 /memory로 새 작업을 준비하는 방법

/clear는 현재 세션의 대화와 작업 컨텍스트를 모두 지우고 초기화하는 명령어입니다. /clear는 다음과 같은 상황에서 사용합니다.

대화 기록이 너무 길어져서 작업에 불필요한 컨텍스트가 개입할 때
이전 프로젝트의 흔적을 지우고 완전히 새로운 작업을 시작할 때
테스트 도중 잘못된 컨텍스트 때문에 혼선이 있을 때

클로드 코드에 /clear를 입력하면 대화 기록이 삭제되고 컨텍스트가 비워집니다.

[/clear 실행 전후 화면]

/clear와 /compact는 둘 다 컨텍스트를 정리하고 최적화하는 명령어이지만, 대화를 다루는 방식이 다릅니다. /compact는 대화를 요약해 유지하고, /clear는 대화를 완전히 초기화합니다. 두 명령어의 차이는 다음과 같습니다.

구분	/clear	/compact
기본 동작	대화 기록을 완전히 초기화	대화 내용을 요약하여 압축
컨텍스트 윈도우	완전히 비움	요약된 형태로 유지
CLAUDE.md 파일	유지됨	유지됨
사용 시점	새 작업/기능 시작, 완전히 다른 주제로 전환, 잘못된 방향으로 진행된 대화 리셋	컨텍스트 창이 가득 찰 때, 같은 작업을 계속하면서 최적화가 필요할 때, 토큰 사용량 줄이기

CLAUDE.md 파일은 /clear와 /compact를 실행해도 유지됩니다. 따라서 대화를 초기화한 뒤에도 지켜야 할 중요한 규칙은 CLAUDE.md에 저장해 두는 것이 효과적입니다.

/memory는 AI가 기억하고 있는 프로젝트 관련 정보를 확인하고 관리하는 명령어입니다. /memory를 쓰면 클로드가 지금까지 기억하고 있는 내용을 확인하고, 필요하면 수정하거나 삭제할 수 있습니다.

/memory를 입력하면 메모리 파일을 저장할 위치를 먼저 고릅니다. 프로젝트 메모리(Project memory)는 현재 프로젝트 폴더 안에서만 적용되는 규칙을 저장하고, 사용자 메모리(User memory)는 모든 프로젝트에 공통으로 적용되는 사용자 전역 규칙을 저장합니다. Project memory를 선택하면 현재 프로젝트의 CLAUDE.md 파일이 열리고, 여기에 규칙을 추가한 뒤 저장합니다.

:memory 실행 후 메모리 저장 위치 선택 화면.png

[/memory 실행 후 메모리 저장 위치 선택 화면]

CLAUDE.md는 정해진 형식이 없는 파일이므로, 간결하고 사람이 읽기 쉽게 작성하는 것이 핵심입니다. CLAUDE.md는 클로드의 프롬프트 일부로 작동하기 때문에 자주 쓰는 프롬프트처럼 지속적으로 다듬고 개선하는 것이 좋습니다. 중요한 규칙에는 '중요', '반드시' 같은 강조 표현을 추가해 AI가 더 잘 따르도록 할 수 있습니다.

■ claude --resume으로 이전 세션을 이어가는 방법

claude --resume은 이전 대화 기록을 불러와 마지막 상태 그대로 이어서 작업할 수 있게 하는 명령어입니다. 세션(session)은 클로드 코드에서 대화를 시작해 명령을 주고받는 동안 유지되는 상태를 말합니다. 클로드 코드는 터미널을 닫으면 대화가 사라진 것처럼 보이지만, 실제로는 모든 대화 내용이 프로젝트 폴더에 자동 저장됩니다.

--resume 옵션은 저장된 세션 파일을 읽어 와 이전 컨텍스트를 복원합니다. 프로젝트 폴더에서 명령 프롬프트를 열고 claude --resume을 입력하면 현재 프로젝트의 대화 목록이 표시됩니다. 화살표 키로 원하는 대화를 찾아 Enter 키를 누르면 대화가 중단된 시점부터 세션이 복원됩니다.

— claude --resume 실행 후 대화 목록 화면.png

[claude --resume 실행 후 대화 목록 화면]

클로드 코드는 프로젝트별로 대화 세션을 저장하므로, 작업 중 터미널이 닫히거나 대화가 끊겨도 이전 작업을 이어갈 수 있습니다. 세션 재개 방법은 claude --resume 외에 두 가지가 더 있습니다.

/resume: claude를 입력해 클로드 코드를 먼저 실행한 뒤 /resume을 입력하면, 이전 대화를 선택해 재개할 수 있습니다.
--continue 또는 -c: 가장 최근의 마지막 대화를 자동으로 복구하는 플래그입니다. 작업 중 연결이 끊기거나 터미널이 종료되었을 때 사용할 수 있습니다.

다섯 가지 명령어는 대화가 길어지는 상황마다 역할이 나뉩니다. 컨텍스트를 확인할 때는 /context, 같은 작업을 이어갈 때는 /compact, 새 작업을 시작할 때는 /clear, 규칙을 남길 때는 /memory, 터미널을 다시 열었을 때는 claude --resume을 쓰면 됩니다.

『혼자 공부하는 바이브 코딩 with 클로드 코드』는 할 일 관리 앱과 상식 퀴즈 게임을 직접 만들면서 세션 관리, 컨텍스트 압축, CLAUDE.md 규칙 관리를 단계별로 실습합니다. 명령어를 실제 프로젝트 흐름 안에서 익히고 싶다면 함께 살펴보기 좋습니다.

[한빛앤] 입체표지_혼자 공부하는 바이브 코딩.png

위 컨텐츠는 조태호 저자의
『혼자 공부하는 바이브 코딩 with 클로드 코드』를 재구성하여 작성되었습니다.

댓글