버그 수정을 반쯤 하다 터미널을 닫았습니다. 다음 날 다시 시작하려면 처음부터 설명해야 할까요. --resume으로 이전 세션을 그대로 이어받을 수 있습니다.
세션은 Claude Code의 하나의 작업 단위입니다. 세션이 유지되는 동안 대화 기록과 작업 상태가 보존됩니다.
# 새 세션 시작
claude
# 이전 세션 이어받기
claude --resume
# 특정 세션 지정해서 이어받기
claude --resume <session-id>
세션이 시작되면 고유 ID가 부여됩니다. 이 ID로 나중에 해당 세션을 재개할 수 있습니다.
세션 내에서도 이전 세션으로 전환할 수 있습니다.
claude> /resume
최근 세션 목록이 표시되고, 선택하면 해당 세션의 컨텍스트가 로드됩니다.
컨텍스트는 Claude가 현재 알고 있는 모든 정보의 합입니다.
컨텍스트 = CLAUDE.md + 대화 기록 + 읽은 파일 + 실행 결과 + Hook 주입 내용
컨텍스트가 풍부할수록 Claude는 더 정확한 판단을 합니다. 하지만 컨텍스트에는 한계(Context Window)가 있습니다.
Context Window: 언어 모델이 한 번에 처리할 수 있는 텍스트의 최대 크기. 대화가 길어지면 초기 내용이 잘릴 수 있습니다.
대화가 길어지면 오래된 내용을 요약해 컨텍스트를 줄입니다.
claude> /compact
전체 대화를 핵심 내용 위주로 요약해 새 컨텍스트로 교체합니다. 메모리는 줄이지만 세부 내용은 일부 손실됩니다.
자동 압축을 원하면 설정에서 활성화할 수 있습니다.
{
"autoCompact": true
}
현재 대화를 모두 지우고 새로 시작합니다.
claude> /clear
CLAUDE.md는 다시 읽지만 대화 기록은 사라집니다. 이전 작업과 무관한 새 작업을 시작할 때 씁니다.
claude> /context
현재 컨텍스트 크기와 구성 요소를 확인합니다. 컨텍스트 한계에 가까워졌는지 파악할 수 있습니다.
세션이 끝나도 유지되는 정보를 저장합니다.
claude> /memory
Claude Code가 학습한 프로젝트 패턴, 선호 설정, 반복적으로 필요한 컨텍스트를 메모리에 저장합니다. 다음 세션에서 자동으로 로드됩니다.
# 기능 A 작업
claude
> "로그인 기능 구현해줘"
> ... (작업 중)
# 세션 종료
# 기능 B 작업 (새 세션)
claude
> "결제 기능 구현해줘"
서로 무관한 작업은 세션을 분리하면 컨텍스트가 오염되지 않습니다.
# 1일차
claude
> "인증 모듈 전체 리팩토링해줘"
> ... (일부 완료)
# 종료
# 2일차
claude --resume
> "어제 어디까지 했어?"
> "계속 진행해줘"
claude> /btw
현재 브랜치: feature/auth-refactor
/btw 명령으로 현재 Git 상태를 컨텍스트에 추가할 수 있습니다.
claude> /export
현재 세션의 대화 내용을 파일로 내보냅니다. 문서화, 기록 보관, 팀 공유에 씁니다.