[TIL] Claude Code Resume Session 활용하기

Claude Code 로 작업을 하다가, 회의를 다녀오거나 잠깐 다른 얘기를 하고 오면 
어디까지 했지? 하고 버퍼링이 걸릴 때가 종종 있다

그럴 때 유용한 게 Resume Session 기능이다

 

Resume Session 이란

이전에 중단한 Claude Code 대화를 그대로 복원하는 기능

 

복원되는 것들:

• 전체 대화 기록
• 파일 변경 이력
• 작업 컨텍스트

즉, 아까 하던 거 계속 하자!가 가능하다 

 

기본 사용법

1. 가장 최근 세션 이어가기

claude --continue
# 또는
claude -c

어제 작업하던 세션이 그대로 열린다

2. 세션 목록에서 선택하기

claude --resume
# 또는
claude -r

화살표 키로 원하는 세션 선택할 수 있다

3. 특정 세션 바로 열기

claude --resume oauth-integration

이 방법 쓰려면 먼저 세션에 이름을 붙여야 한다

 

세션 이름 붙이기

세션 선택기에서 "implement user authentication..." 같은 긴 프롬프트 보고 찾는 것보다 이름으로 관리하는 게 훨씬 낫다

# 세션 시작 후 바로 이름 지정
> /rename login-api

# 나중에 이 이름으로 바로 재개
claude --resume login-api

네이밍은 이렇게 하면 편하다:

• 기능명: oauth-integration
• 이슈 번호: fix-123
• 브랜치명: feature/login

 

세션 선택기 단축키

/resume 또는 claude -r 로 열리는 선택기에서 쓸 수 있는 단축키:

키	기능
↑ ↓	세션 이동
Enter	선택한 세션 재개
P	세션 내용 미리보기
R	세션 이름 변경
/	검색
B	현재 Git 브랜치 세션만 표시

B 키가 유용하다
브랜치별로 세션 관리하면 관련 세션만 빠르게 필터링할 수 있다

 

/compact vs /resume

이 두 개가 헷갈릴 수 있는데 목적이 다르다

/compact

> /compact

현재 진행 중인 세션의 컨텍스트를 압축한다
대화가 길어져서 Claude 가 "컨텍스트가 부족합니다" 라고 할 때 쓴다

🐣 Context low 가 0% 이 되기 전에 /compact 를 해줘야 한다! 🐣

/resume

claude --resume

종료된 이전 세션을 다시 연다
터미널 닫았다가 나중에 다시 작업할 때 쓴다

구분	/compact	/resume
대상	현재 세션	이전 세션
동작	컨텍스트 압축	세션 복원
시점	대화 중	Claude Code 재시작 시

 

실전 워크플로우

장기 프로젝트

# Day 1: 프로젝트 시작
claude "결제 시스템 리팩토링 해줘"
> /rename payment-refactor

# 작업 진행...
# 퇴근 (Ctrl+C)

# Day 2: 이어서 작업
claude -c

병렬 작업

# 터미널 1: 기능 개발
claude --resume feature-a

# 터미널 2: 버그 수정
claude --resume hotfix-login

다른 접근 시도

기존 방향 말고 새로운 접근 시도하고 싶을 때 fork 를 사용한다

# 원본 세션 보존하고 새로운 분기 생성
claude --resume current-task --fork-session

원본은 그대로 유지되고, 복사본에서 다른 방향으로 시도할 수 있다

 

주의사항

1. 세션은 디렉토리 기반: 다른 폴더에서 claude -r 하면 그 폴더의 세션 목록이 나온다
2. 같은 세션 동시 사용 금지: 여러 터미널에서 같은 세션 열면 메시지가 꼬인다 --fork-session 쓰자
3. 권한 재확인: 재개된 세션에서도 파일 수정 등은 다시 승인 요청할 수 있다

 

정리

Resume Session 쓰면서 느낀 점:

• /rename 습관 들이면 나중에 찾기 편하다
• claude -c 가 진짜 많이 쓴다
• 복잡한 작업일수록 세션 관리가 중요하다

이제, 어제 어떤 작업하고 있었지? 고민 안 해도 된다!

 

핵심 명령어 요약

# 최근 세션 이어가기
claude -c

# 세션 선택기
claude -r

# 특정 세션 재개
claude --resume my-session

# 포크
claude -c --fork-session

# 세션 내부에서
> /rename my-session    # 이름 지정
> /compact              # 컨텍스트 압축
> /resume               # 다른 세션으로 전환