클로드 코드 세션 재개하는 법 총정리

터미널을 닫고 나서야 “아까 그 대화, 다시 볼 수 있나” 하는 생각이 들었던 적 있으신가요. 재부팅 한 번으로 몇 시간짜리 작업 맥락이 통째로 날아갈까 봐 조마조마했던 분이라면 이 글이 정확히 필요한 순간에 온 겁니다.

결론부터 말하면, 클로드 코드(Claude Code)는 작업 내용을 로컬에 계속 저장해 두기 때문에 몇 가지 명령어만 알면 중단했던 지점 그대로 이어갈 수 있습니다. 이 글에서는 기본 재개 명령어부터 상황별 대응법, 방식별 비교, 그리고 막혔을 때 확인할 체크리스트까지 순서대로 정리했습니다.

클로드 코드 세션이란 무엇인가

클로드 코드에서 세션이란 하나의 프로젝트 폴더에 묶여 저장되는 대화 기록입니다. 새 창을 열거나 컴퓨터를 재시작해도 이 기록은 로컬에 그대로 남아 있어서, 나중에 같은 폴더로 돌아가면 이어서 작업할 수 있습니다.

많은 사람이 오해하는 부분이 있습니다. 창을 닫으면 대화가 사라진다고 생각하는 것입니다. 실제로는 작업하는 동안 계속 파일로 저장되고 있어서, 종료하거나 화면을 정리하는 명령을 써도 기록 자체는 지워지지 않습니다. 다만 저장 위치가 프로젝트 폴더 단위로 나뉘어 있다는 점은 기억해 둘 필요가 있습니다. 다른 폴더에서는 이전 세션이 보이지 않을 수 있기 때문입니다.

세션 재개가 필요한 상황은 다양합니다. 컴퓨터를 재부팅했을 때, 실수로 터미널을 닫았을 때, 오전에 하던 작업을 오후에 이어야 할 때, 혹은 여러 작업을 동시에 진행하다가 어제 하던 것으로 돌아가야 할 때입니다. 이런 순간마다 처음부터 상황을 다시 설명하지 않아도 된다는 점이 핵심입니다.

클로드 코드 세션 재개하는 기본 방법

세션을 재개하는 가장 기본적인 방법은 두 가지 명령어를 아는 것입니다. 하나는 가장 최근 대화로 바로 돌아가는 방법이고, 다른 하나는 여러 대화 중 하나를 골라 돌아가는 방법입니다.

같은 폴더에서 작업하던 가장 최근 대화로 곧바로 돌아가고 싶다면 claude --continue를 입력하면 됩니다. 이어갈 대화가 없는 경우에는 대화를 찾을 수 없다는 안내가 뜨고 새로 시작하게 됩니다. 반면 여러 대화 중에서 골라서 돌아가고 싶다면 claude --resume을 입력합니다. 이 명령은 지금까지 저장된 세션 목록을 보여주는 선택 화면을 열어 줍니다.

세션에 이름을 미리 붙여 두었다면 claude --resume 이름처럼 이름을 직접 지정해 곧바로 돌아갈 수도 있습니다. 이미 작업 중인 세션 안에서 다른 대화로 옮기고 싶을 때는 /resume을 입력하면 됩니다.

여러 작업을 동시에 진행한다면 세션 이름을 붙여 두는 습관이 도움이 됩니다. 시작할 때 claude -n 작업이름으로 이름을 정하거나, 작업 도중 /rename 작업이름으로 바꿀 수 있습니다. 선택 화면에서 원하는 세션을 고른 뒤 특정 키를 눌러 이름을 바로 고치는 방법도 있습니다. 이름을 붙여 두면 나중에 목록이 길어져도 헷갈리지 않고 원하는 대화를 바로 찾을 수 있다고 알려져 있습니다.

상황별 세션 재개 전략

상황에 따라 어떤 방법을 쓸지가 달라집니다. 여기서는 자주 마주치는 세 가지 상황을 나눠 살펴보겠습니다.

먼저 재부팅이나 터미널 종료 직후 바로 이어서 작업하고 싶은 경우입니다. 이때는 같은 프로젝트 폴더로 이동한 뒤 claude --continue를 쓰는 것이 가장 빠릅니다. 별도로 무엇을 고를 필요 없이 곧바로 직전 대화로 들어가기 때문입니다.

다음은 여러 작업을 병행하다가 특정 작업으로 되돌아가야 하는 경우입니다. 이럴 때는 claude --resume으로 목록을 열어 이름이나 마지막 활동 시간을 보고 고르는 방식이 낫습니다. 목록 화면에서는 폭넓게 검색 범위를 넓히는 단축키도 있어서, 같은 저장소의 다른 작업 폴더(worktree)까지 포함해 찾아볼 수 있습니다.

세 번째는 기존 방식과 다른 접근을 시험해 보고 싶지만 원래 대화는 그대로 남겨 두고 싶은 경우입니다. 이때는 /branch 명령으로 지금까지의 대화를 복사해 새로운 분기로 전환할 수 있습니다. 원본 세션은 그대로 목록에 남아 있으므로 언제든 원래 대화로 돌아갈 수 있습니다. 명령줄에서 바로 시작하고 싶다면 claude --continue --fork-session처럼 옵션을 조합하는 방법도 있습니다.

자동화 스크립트나 CI 파이프라인에서 claude -p 형태로 실행한 세션, 또는 개발자가 직접 프로그램으로 연동해 만든 세션은 선택 화면에는 나타나지 않습니다. 이런 세션은 세션 아이디를 알고 있다면 claude --resume 세션아이디 형태로 재개할 수 있습니다. 단, 이 조회는 세션이 시작된 프로젝트 폴더 안에서만 가능하다는 점을 기억해야 합니다.

세션 관리 방식 비교

여러 재개 방법 중 무엇을 쓸지 헷갈린다면 아래 표를 참고하면 됩니다. 상황에 맞는 방법을 고르는 기준을 한눈에 정리했습니다.

상황	추천 명령어	특징
방금 닫은 대화로 바로 복귀	claude –continue	선택 과정 없이 가장 빠름
여러 대화 중 하나 선택	claude –resume	목록에서 이름·시간으로 확인 후 선택
이름을 이미 붙여둔 대화로 이동	claude –resume 이름	정확한 이름이면 바로 이동, 모호하면 목록이 열림
다른 접근을 시험하되 원본 보존	/branch 또는 –fork-session	대화 복사본을 만들어 전환
자동화·스크립트로 만든 세션 재개	claude –resume 세션아이디	선택 화면에는 안 뜨지만 아이디로 접근 가능

표에서 보듯 상황이 단순할수록 명령어도 단순합니다. 반대로 여러 작업을 병행하거나 협업하는 환경이라면 이름 지정과 분기 기능을 함께 익혀 두는 편이 실무에서 더 유용합니다.

자주 발생하는 오류와 해결법

세션을 재개하다가 막히는 경우 대부분은 몇 가지 패턴으로 좁혀집니다. 하나씩 짚어보겠습니다.

가장 흔한 경우는 이어갈 대화가 없다는 안내가 뜨는 상황입니다. 이는 대부분 다른 프로젝트 폴더에서 명령을 실행했기 때문입니다. 세션은 폴더 단위로 저장되므로, 원래 작업하던 폴더로 정확히 이동한 뒤 다시 시도하면 해결되는 경우가 많습니다.

이름으로 세션을 찾았는데 원하는 대화가 바로 열리지 않고 목록 화면이 뜨는 경우도 있습니다. 이는 입력한 이름이 정확히 일치하지 않아서 비슷한 이름 여러 개가 걸렸기 때문입니다. 이럴 때는 뜬 목록에서 원하는 세션을 직접 골라 주면 됩니다.

같은 세션을 두 개의 터미널 창에서 동시에 열어 작업하는 경우도 주의가 필요합니다. 분기 없이 같은 세션을 양쪽에서 이어가면 두 곳의 메시지가 하나의 기록에 섞여 들어갈 수 있습니다. 동시에 다른 방향으로 작업을 시험하고 싶다면 처음부터 분기 기능을 써서 별도의 대화로 나누는 편이 안전합니다.

자동화 환경에서 만든 세션을 인터랙티브 화면에서 찾으려다가 보이지 않아 당황하는 경우도 있습니다. 이는 오류가 아니라 원래 그런 구조입니다. 그런 세션은 목록이 아니라 세션 아이디를 직접 입력하는 방식으로 접근해야 한다는 점을 기억해 두면 헷갈리지 않습니다.

일부 사용 환경에서는 특정 방식으로 재개한 뒤 다른 명령으로 다시 찾으려 할 때 예상과 다르게 동작했다는 보고도 있다고 알려져 있습니다. 이런 사례는 사용 환경이나 버전에 따라 다를 수 있으므로, 중요한 작업이라면 세션 이름을 명확히 붙여 두고 그 이름으로 재개하는 방식을 우선 활용하는 것이 안전합니다.

마무리

클로드 코드 세션 재개는 생각보다 단순합니다. 가장 최근 대화로 바로 돌아가려면 claude --continue, 목록에서 골라 돌아가려면 claude --resume, 이름을 붙여 뒀다면 그 이름을 그대로 쓰면 됩니다. 여기에 분기 기능과 세션 이름 지정을 더하면 여러 작업을 동시에 진행할 때도 헷갈리지 않고 정리할 수 있습니다.

오늘부터 새 세션을 시작할 때 이름부터 붙여 보는 것을 권해 드립니다. 나중에 목록이 길어졌을 때 훨씬 수월하게 원하는 대화를 찾을 수 있을 것입니다. 여러분은 세션을 재개할 때 주로 어떤 방법을 쓰시나요.

커뮤니티 참여하기