Claude Code 세션 끊겼을 때 recap으로 작업 이어가기

Claude Code 입문 · 세션 관리

Claude Code로 한창 작업하다가 터미널이 툭 닫히거나, 노트북 덮개를 덮었다 열었더니 세션이 사라져 있던 적 있으신가요? 파일은 그대로 남아 있는데 "내가 뭘 하던 중이었는지"만 통째로 증발하는 상황이요.

오늘은 세션이 끊겼을 때 /recap 명령으로 빠르게 복구하는 방법과, 애초에 끊겨도 타격이 없도록 미리 대비하는 습관까지 정리해드릴게요.

📌 3줄 요약

① 세션이 끊기면 파일 수정 내역은 남지만 작업 맥락은 통째로 사라져요.

② 새 세션에서 /recap을 입력하면 직전 세션의 수정 파일·대화·진행 상황을 요약해줘요.

③ 가장 안정적인 조합은 작업 쪼개기 + progress.md 중간 저장이에요.

📑 목차

1. 세션이 끊기면 생기는 진짜 문제

2. recap 명령으로 이전 작업 내용 불러오기

3. 세션 요약을 직접 저장해두는 방법

4. 세션 끊김을 미리 방지하는 실전 팁

세션이 끊기면 생기는 진짜 문제

Claude Code로 복잡한 리팩토링이나 자동화 작업을 하다 보면, 세션이 예상치 못하게 끊기는 경우가 있어요. 터미널을 실수로 닫거나, 컴퓨터가 절전 모드에 들어가거나, 네트워크가 불안정해지는 상황이 대표적이에요. 노트북 사용자라면 덮개를 닫았다가 다시 열었을 때 세션이 사라져 있는 경험도 한 번쯤은 해보셨을 거예요. 의외로 Windows 업데이트가 백그라운드에서 재시작을 예약해놓는 바람에 끊기는 경우도 있어요.

문제는 단순히 연결이 끊기는 게 아니에요. Claude Code는 세션 내 대화 맥락(context)을 기반으로 작업하기 때문에, 세션이 끊기면 "지금까지 뭘 했는지"를 통째로 잃어버려요.

🔍 왜 유독 Claude Code에서 치명적일까요?

일반적인 코드 에디터와 달리 Claude Code는 대화 기반 도구이기 때문에, 세션이 곧 작업 공간 자체인 셈이에요. 파일 수정 내역은 디스크에 남아 있지만, "왜 이렇게 수정했는지", "다음에 뭘 해야 하는지"라는 맥락은 세션과 함께 사라져요.

새 세션을 열고 "아까 하던 거 이어서 해줘"라고 말해도, Claude는 이전 대화를 기억하지 못해요. 결국 처음부터 다시 설명해야 하고, 이미 완료한 부분을 또 수정하는 일이 생겨요.

⚠️ 더 심각한 시나리오

더 심각한 건, 이전 세션에서 의도적으로 남겨둔 부분을 Claude가 새 세션에서 "버그"로 인식하고 되돌려버리는 상황이에요. 작업 순서가 중요한 경우에는 이미 완료한 3단계를 다시 실행하면서 충돌이 발생하기도 해요.

특히 파일 10개 이상을 동시에 수정하는 대규모 작업에서 이런 일이 발생하면 시간 낭비가 상당해요.

💬 제 경험을 덧붙이자면

제가 직접 겪어보니, 30분짜리 작업을 세션 끊김 때문에 1시간 넘게 반복한 적도 있었어요. 단순 반복이면 그나마 낫지만, 이전에 어디까지 했는지 파악하는 시간까지 포함하면 실질적인 손실은 더 커요.

그래서 세션이 끊기기 전에 미리 대비하는 습관이 정말 중요해요.

recap 명령으로 이전 작업 내용 불러오기

Claude Code에는 /recap 명령이 있어요. 이 명령을 새 세션에서 입력하면, 직전 세션에서 수행한 작업 내용을 요약해서 보여줘요. 별도의 설정이나 플러그인 설치 없이 바로 사용할 수 있는 내장 기능이에요.

사용법은 간단해요.

1새 터미널을 열어요.

2Claude Code를 실행해요.

3프롬프트에 /recap을 입력하면 돼요.

특별한 인자나 옵션 없이 명령어 하나만 치면 되기 때문에, 초보자도 부담 없이 쓸 수 있어요.

 

recap이 보여주는 정보는 크게 세 가지예요. 이전 세션에서 어떤 파일을 수정했는지, 어떤 대화를 나눴는지, 마지막으로 진행 중이던 작업이 무엇인지를 알려줘요. 수정한 파일은 경로와 함께 나오기 때문에, git diff를 열어보지 않아도 변경 범위를 한눈에 파악할 수 있어요. 진행 중이던 작업도 "~를 수정하는 중이었다"처럼 구체적으로 표시되기 때문에 복구 방향을 잡기 쉬워요.

이 요약을 바탕으로 "위 작업을 이어서 진행해줘"라고 요청하면, Claude가 맥락을 파악하고 이어서 작업해요. 처음부터 다시 설명할 필요가 없으니 복구 시간이 크게 줄어들어요.

⚠️ recap의 한계

다만 recap은 직전 세션 1개만 요약해주기 때문에, 여러 세션 전의 작업을 복구하려면 다른 방법이 필요해요. 그래도 가장 흔한 "방금 끊겼는데 어떻게 이어가지?" 상황에서는 recap만으로 충분히 해결돼요.

 

세션 요약을 직접 저장해두는 방법

recap이 자동으로 제공하는 요약 외에도, 작업 중간에 직접 세션 요약을 저장해두면 더 안전해요. 긴 작업을 시작하기 전에 Claude에게 "지금까지 한 작업을 요약해서 파일로 저장해줘"라고 요청하면 돼요. 이 방법은 recap과 달리 내가 원하는 형식과 내용으로 저장할 수 있다는 장점이 있어요. 특히 여러 단계로 나뉜 작업에서는 각 단계의 완료 여부를 체크리스트로 저장하면 복구가 훨씬 정확해져요.

예를 들어 이렇게 말할 수 있어요. "현재까지 수정한 파일 목록과 남은 작업을 progress.md에 정리해줘." Claude는 마크다운 형식으로 깔끔하게 정리해주기 때문에, 사람이 읽기에도 편해요. 작업 복구 외에도 나중에 "이 프로젝트에서 뭘 했더라?" 하고 돌아볼 때 유용한 기록이 돼요.

 

이렇게 저장해두면 세션이 끊기더라도 progress.md 파일은 로컬에 남아 있어요. 새 세션에서 "progress.md를 읽고 남은 작업을 이어서 해줘"라고 하면 바로 복구돼요. 이 방식은 recap보다 정보량이 많고, 내가 중요하다고 판단한 맥락을 명시적으로 포함시킬 수 있어요. 예를 들어 "B 파일은 A 파일 수정이 끝난 후에 건드려야 함"과 같은 순서 의존성도 기록해둘 수 있어요.

CLAUDE.md 파일에 "긴 작업 시 10단계마다 진행 상황을 progress.md에 기록할 것"이라고 적어두는 것도 좋은 방법이에요. 이렇게 하면 Claude가 자동으로 중간 저장을 하기 때문에, 끊김에 대한 걱정 없이 대규모 작업을 맡길 수 있어요.

💡 설정 부담은 거의 없어요

CLAUDE.md에 한 줄만 추가하면 되니까 설정 부담도 거의 없어요. 한 번 설정해두면 프로젝트 내 모든 세션에서 자동으로 적용되기 때문에 매번 기억할 필요도 없어요.

 

💬 둘 중 하나만 고른다면

제가 직접 써보니, 자동 recap보다 수동 저장 방식이 훨씬 정확한 복구를 보장했어요. 특히 파일 수정 순서가 중요한 마이그레이션 작업에서는 수동 저장이 필수였어요. 두 방법을 병행하면 가장 안심이 되지만, 하나만 선택한다면 수동 저장 쪽을 추천드려요.

복구 방법	복구 범위	이럴 때 좋아요
/recap	직전 세션 1개 요약	방금 끊겼을 때, 설정 없이 즉시
progress.md 수동 저장	내가 정한 형식·순서 의존성까지	여러 단계 작업, 마이그레이션
claude --resume	세션 자체를 그대로 재개	네트워크 불안정, 가장 빠른 복구

세션 끊김을 미리 방지하는 실전 팁

가장 확실한 방법은 작업 단위를 작게 쪼개는 것이에요. "파일 50개를 한 번에 리팩토링해줘"보다 "먼저 controllers 폴더 파일 5개만 수정해줘"가 세션 안정성 면에서 훨씬 안전해요. 작업 단위가 작으면 설령 세션이 끊기더라도 손실되는 맥락의 양이 적어요. 한 번에 5개 파일만 처리하면 5~10분이면 끝나기 때문에, 끊길 확률 자체가 낮아지는 효과도 있어요.

💡 이중 안전장치

완료된 작업은 바로 커밋해두면 이중 안전장치가 돼요.

컨텍스트 윈도우(context window)가 가득 차면 Claude Code가 자동으로 오래된 대화를 압축해요. 이 과정에서 중요한 맥락이 사라질 수 있으므로, 작업 단위를 나누면 이 문제도 함께 예방돼요.

🔍 컨텍스트 윈도우란?

컨텍스트 윈도우란 Claude가 한 번에 기억할 수 있는 대화의 양이라고 생각하면 쉬워요. 대화가 길어질수록 초반 내용이 압축되거나 생략되기 때문에, 짧은 세션 여러 개로 나누는 게 유리해요.

 

터미널 설정도 확인해야 해요.

⚠️ 터미널 설정을 꼭 확인하세요

Windows 터미널의 경우, 설정에서 "비활성 시 프로세스 종료" 옵션이 켜져 있으면 장시간 작업 중 세션이 자동으로 끊길 수 있어요. 이 옵션은 터미널 설정 → 고급에서 확인할 수 있어요. macOS 사용자라면 에너지 절약 설정에서 "디스플레이 꺼진 후에도 시스템 활성 유지" 옵션을 켜두면 좋아요. 장시간 작업을 돌려놓고 자리를 비울 때 특히 중요한 설정이에요.

네트워크가 불안정한 환경에서는 --resume 플래그를 기억해두면 좋아요. claude --resume 명령으로 마지막 세션을 직접 재개할 수 있어서, recap보다 더 빠르게 복구할 수 있어요. resume은 요약이 아니라 세션 자체를 이어가는 것이기 때문에, 대화 맥락이 그대로 유지돼요. 특정 세션 ID를 지정해서 재개할 수도 있기 때문에, 여러 세션 중 원하는 것을 골라서 이어갈 수 있어요.

 

💬 여러 방법을 비교해본 결론

제가 여러 방법을 비교해본 결과, 작업 쪼개기 + 중간 저장 조합이 가장 안정적이었어요. 세션 끊김 자체를 완전히 막을 수는 없지만, 복구 시간을 1~2분 이내로 줄이는 것은 충분히 가능해요.

✍️ 마치며

오늘 알려드린 방법들을 하나씩 적용해보시면, 세션 끊김 때문에 스트레스받는 일이 확 줄어들 거예요.

끊긴 직후엔 /recap이나 claude --resume으로 급한 불을 끄고, 평소엔 작업을 잘게 쪼개 progress.md에 남겨두는 습관을 들여보세요. 딱 이 두 가지면 충분합니다.

#ClaudeCode #클로드코드 #recap #세션복구 #클로드코드사용법 #CLAUDEmd #progressmd #컨텍스트윈도우 #개발생산성 #AI코딩 #터미널설정 #claude_resume