Resume or fork sessions

https://code.claude.com/docs/ko/how-claude-code-works

Claude Code의 작동 방식 - Claude Code Docs

 

🔄 Claude Code 세션 마스터하기: 재개(Resume)와 포크(Fork)

안녕하세요! 오늘은 Claude Code를 사용할 때 작업을 이어가거나, 새로운 시도를 하고 싶을 때 꼭 알아야 할 세션 제어 스킬을 정리해 보았습니다. 🛠️

단순히 claude를 실행하는 것을 넘어, 기존 작업을 어떻게 스마트하게 관리할 수 있는지 함께 살펴볼까요?

 

1. 중단된 지점에서 다시 시작하기: --continue & --resume ⏯️

바쁜 개발 일과 중에 터미널을 닫아야 했나요? 걱정 마세요. --continue 또는 --resume 플래그를 사용하면 동일한 세션 ID로 이전에 중단했던 지점부터 즉시 대화를 이어갈 수 있습니다.

• 동작 방식: 기존 대화 기록이 그대로 복원되며, 새로운 메시지는 이전 대화 뒤에 차곡차곡 쌓입니다.
• ⚠️ 주의사항 (권한 재승인): 대화 기록은 복원되지만, 보안을 위해 세션 범위 권한(Session-scoped permissions)은 초기화됩니다. 파일 쓰기나 명령어 실행 시 다시 한번 승인 절차가 필요합니다.

# 이전에 하던 작업을 그대로 이어가고 싶을 때
claude --continue

 

2. 평행 우주 만들기: --fork-session 🍴

"지금까지의 맥락은 유지하되, 원래 세션은 건드리지 않고 다른 방식으로 코드를 고쳐보고 싶어!" 이럴 때 필요한 것이 바로 포크(Fork) 기능입니다.

• 동작 방식: 현재까지의 대화 기록은 그대로 복원하지만, 새로운 세션 ID를 생성합니다.
• 장점: 원본 세션에는 아무런 영향을 주지 않으면서 새로운 실험을 마음껏 할 수 있습니다.
• 권한: 재개와 마찬가지로 세션 권한은 상속되지 않으므로 새로 승인해야 합니다.

# 기존 맥락을 복사해 새로운 세션에서 실험하기
claude --continue --fork-session

 

3. 여러 터미널에서 동일 세션 사용 시 주의점 ⚠️👯

가끔 실수로(혹은 의도적으로) 여러 개의 터미널 창에서 동일한 세션 ID를 재개할 때가 있습니다. 이때 어떤 일이 벌어질까요?

• 인터리빙(Interleaving) 현상: 마치 하나의 공책에 두 사람이 동시에 글을 쓰는 것과 같습니다.
• 실시간: 각 터미널 창에서는 자신이 보낸 메시지만 보입니다.
• 사후: 하지만 세션을 종료한 뒤 나중에 다시 열어보면, 두 터미널의 대화가 시간순으로 뒤섞여(Interleaved) 있는 것을 보게 됩니다.
• 결론: 데이터가 깨지지는 않지만 대화 맥락이 엉망이 될 수 있습니다. 병렬 작업을 원하신다면 반드시 위에서 배운 --fork-session을 사용해 각 터미널에 독립된 세션을 부여하세요!

 

💡 요약 및 팁 (Cheatsheet)

상황	추천 플래그	결과
하던 작업 그대로 이어하기	--continue	동일 ID, 기록 복원
기존 맥락에서 새 시도하기	--continue --fork-session	새 ID, 기록 복사
여러 창에서 동시 작업하기	--fork-session 필수!	세션 간 간섭 방지

 

마무리하며 🏁

Claude Code의 세션 관리 기능을 잘 활용하면, 복잡한 리팩토링이나 실험적인 기능을 구현할 때 훨씬 안전하고 효율적으로 작업할 수 있습니다. 이제 --continue와 --fork-session으로 여러분의 워크플로우를 한 단계 업그레이드해 보세요! 🚀✨