이 글은 Claude Code(Anthropic의 터미널용 AI 코딩 도구)를 사용해 본 적은 있지만, "터미널을 닫으면 방금까지의 대화는 어디로 갔을까?"라고 한 번이라도 생각해 본 분들을 위해 작성되었습니다. 다루는 내용은 단 하나입니다. claude --continue와 claude --resume를 통해, 직전의 대화를 그대로 재개하는 기능입니다. 이 글을 다 읽고 나면, 실수로 창을 닫거나 /clear를 해버려도 이전 작업부터 계속 이어갈 수 있는 상태가 될 것입니다.

저 자신도 긴 대화 도중에 터미널을 닫아버려서 "아, 다시 처음부터 설명해야 하나..."라며 낙담했던 경험이 있습니다. 하지만 사실 그 대화는 사라지지 않았습니다.

1. 이 글을 통해 할 수 있는 것

claude --continue를 실행하여, 방금까지의 대화(이력·문맥)가 돌아오는 것을 직접 눈으로 확인하는 것. 이것이 목표입니다.

2. 사전에 필요한 것

• OS: macOS / Linux / Windows 중 하나
• 계정: Claude Code에 로그인되어 있을 것
• 설치: claude 명령어를 사용할 수 있는 상태 (claude --version으로 버전이 표시되면 OK)
• 대상 폴더: 무엇이든 좋으니, 이전에 한 번이라도 Claude Code로 대화한 적이 있는 프로젝트 폴더

아직 한 번도 대화하지 않았다면, 후술할 절차 중에서 한 번만 짧은 대화를 나눈 뒤에 시도해 주세요.

3. 3분 용어 메모

• 터미널 (Terminal): 문자로 명령어를 입력하여 PC를 조작하는 화면. macOS라면 "터미널.app", Windows라면 "PowerShell" 등.
• CLI: Command Line Interface의 약자. 마우스가 아닌 명령어(문자 명령)로 조작하는 방식. claude도 CLI입니다.
• 세션 (Session): Claude Code의 "하나의 대화 묶음". 작업 중인 폴더에 귀속되어 로컬(본인의 PC 내부)에 자동으로 저장됩니다.
• 재개 (resume): 저장된 세션을 다시 열어 대화를 이어가는 것.

4. 원리 (입력 → 기능 → 결과)

• 입력: 사용자가 Claude Code로 대화함.
• 기능: Claude Code는 해당 대화를 작업하는 동안 계속 로컬 파일에 지속적으로 저장합니다. 저장 위치는 기본적으로 ~/.claude/projects/<프로젝트>/<세션ID>.jsonl입니다 (이 파일은 내부 형식이므로 직접 열어서 편집하는 용도가 아닙니다).
• 결과: 따라서 --continue나 --resume을 지정하면, 저장된 대화를 그대로 불러와서 이어서 시작할 수 있습니다.

여기서 중요한 점은 세션은 폴더별로 저장된다는 점입니다. "A 프로젝트에서 재개하고 싶은데, B 폴더에서 실행해서 찾을 수 없는" 상황을 방지하기 위해, 원래의 폴더에서 실행하는 것이 기본입니다.

5. 절차

절차 1: 재개하고 싶은 대화를 대상 폴더에서 한 번 만들기

• 할 일: 대상 폴더로 이동하여 claude를 실행하고, 기억하기 쉬운 한마디(예: "이 프로젝트의 개요를 3줄로 알려줘")를 건네어 응답을 받습니다. 그 후, Ctrl+C를 누르거나 화면을 닫는 등의 방식으로 종료합니다.
• 이유: 재개할 "원래의 대화"를 준비하기 위해서입니다.
• 성공 지표: Claude로부터 어떤 응답이라도 돌아왔다면, 그 시점에 세션은 로컬에 저장되어 있습니다.

claude --continue 실행하기

절차 2: 같은 폴더에서

cd 당신의 프로젝트 폴더
claude --continue

• 할 일: 직전 폴더에서 최신 세션을 그대로 재개합니다.
• 이유: --continue는 "현재 디렉토리의 가장 최신 세션"을 선택하여 여는 단축키이기 때문입니다. 무엇을 선택할지 고민할 필요가 없습니다.
• 성공 지표: 실행 직후 화면에 절차 1에서의 대화 내용이 이력으로 남아 있는 것. "방금 무슨 말을 했었지?"라고 물으면 이전 내용을 바탕으로 대답해 줍니다.

claude --resume

단계 3: 여러 대화 중에서 선택하고 싶을 때는

claude --resume

• 수행 내용: 세션 목록(세션 피커 (Session Picker))이 열립니다. 화살표 키로 선택하고 Enter를 눌러 재개합니다. -
• 이유: 폴더 내에 대화가 여러 개 있을 때, --continue (최신 1건)만으로는 목적한 대화에 도달하지 못할 수 있기 때문입니다. 목록을 통해 선택할 수 있습니다. -
• 성공 지표: 각 행에 "마지막 활동으로부터 경과된 시간", "git 브랜치" 등이 나열된 목록이 나타나고, 선택한 대화로 들어갈 수 있어야 합니다. 목록이 너무 넓거나 좁을 때는 Ctrl+W로 동일 리포지토리의 모든 워크트리(Worktree)를, Ctrl+A로 이 PC의 모든 프로젝트까지 표시 범위를 넓힐 수 있습니다.

단계 4 (선택 사항): 대화에 이름을 붙여 이름으로 불러오기

• 수행 내용: 세션 중에 /rename 인증 관련 조사와 같이 이름을 붙입니다. 실행 시에 붙이려면 claude --name 인증 관련 조사를 사용합니다. -
• 이유: 이름을 붙여두면 나중에 claude --resume 인증 관련 조사와 같이 이름으로 직접 재개할 수 있습니다. 병행하여 여러 작업을 진행할 때 유용합니다. -
• 성공 지표: 이름을 붙인 후, claude --resume <해당 이름>으로 한 번에 해당 대화로 돌아갈 수 있어야 합니다.

메모: 이름을 붙이지 않더라도, Claude Code는 첫 발언을 바탕으로 대화 제목을 자동으로 생성하여 목록에 표시합니다. 다만 이 자동 제목은 "표시용"이며, 이름 지정 재개를 위한 핸들(Handle)로는 사용되지 않습니다. 이름으로 불러오고 싶을 때는 직접 이름을 붙여주세요.

6. 최소 예제 (안전하게 테스트하기)

새로운 빈 폴더를 하나 만들어서 그곳에서만 테스트하는 것이 안전합니다.

mkdir resume-test && cd resume-test
claude
# 실행 후 "오늘 날짜를 한 줄로 알려줘"라고 말하고 응답을 받음
...

"오늘 날짜를 물어보셨군요"와 같은 식으로, 이전 문맥을 기억한 채로 답변이 돌아온다면 성공입니다. 빈 폴더이므로 기존 작업에 영향을 주지 않습니다.

7. 성공 확인 (직접 합격 여부 판정하기)

다음 중 하나가 확인되면 "재개 성공"으로 판단해도 좋습니다.

• 재개 후 화면에 이전 발언과 응답이 이력(History)으로 표시되어 있다. -
• "아까 하던 이야기의 이어서"라고 전제 조건을 생략하고 질문해도, 이전 내용을 바탕으로 답변한다.

반대로, 완전히 깨끗한 상태(이력이 비어 있음)로 시작되었다면 재개에 실패한 것입니다. 다음 절을 확인하세요.

8. 자주 발생하는 문제 (증상 → 원인 후보 → 해결 방법)

• 증상: --continue를 해도 이력이 비어 있거나, "대화를 찾을 수 없습니다"라고 나온다.
  원인 후보: 대화를 생성한 폴더와 현재 실행 중인 폴더가 다르다. 세션은 폴더에 귀속되기 때문입니다.
  해결 방법: 원래의 프로젝트 폴더로 cd 한 후 다시 실행한다. 어디에 있는지 모른다면 claude --resume 목록을 열고, Ctrl+A로 전체 프로젝트 표시를 하여 찾는다. -

• 증상: claude -p (자동 실행 모드)로 돌린 대화가 피커에 나오지 않는다.
  원인 후보: claude -p나 Agent SDK로 만든 세션은 사양상 피커 목록에 나열되지 않습니다.
  해결 방법: 해당 세션의 ID를 기록해 두었다가, claude --resume <세션 ID>로 직접 연다. 원래 폴더에서 실행해야 합니다 (ID 검색은 해당 프로젝트 내로 한정되기 때문입니다).

• 증상: 재개했는데 이전에 사용하던 설정(MCP 서버 등)이 적용되지 않는다.
  원인 후보: 실행 시 옵션 중 일부(--mcp-config, --settings, --add-dir 등)는 재개 시 자동으로 복원되지 않습니다.
  해결 방법: 원래 실행할 때 사용했던 옵션을 재개할 때도 다시 붙여서 실행한다. settings.json 등의 설정 파일은 실행 시 다시 읽어오므로, 해당 파일에 작성한 설정은 다시 붙일 필요가 없습니다. -

• 증상: "전에는 자동으로 승인 모드였는데, 재개하니 매번 확인 창이 뜬다".
  원인 후보: plan 및 bypassPermissions (확인 스킵) 모드는 재개 시 복원되지 않는 사양입니다.

복구 방법: 필요하다면 실행 시 권한 모드 (permission mode) 옵션으로 다시 지정하십시오. 이는 안전을 우선시하는 설계로, 의도치 않게 위험한 작업이 통과되는 것을 방지합니다.

9. 사용을 지양해야 하거나 주의해야 할 상황

• 대화가 매우 길어질 경우 (기준 약 10만 토큰 초과), 한동안 방치한 후 재개하면 Pro/Max 플랜에서는 재개 시 "요약해서 계속하기 / 그대로 전부 계속하기"를 선택하는 다이얼로그가 나타날 수 있습니다.
  그대로 전부를 선택하면 문맥을 모두 유지할 수 있는 반면, 요청당 토큰 비용 (token cost)이 대화 길이에 비례하여 상승합니다. 너무 긴 대화를 무한정 끌고 가기보다, 적절한 시점에서 새로운 대화로 전환하는 판단도 유효합니다. - 트랜스크립트 (transcript)의
  .jsonl

파일은 내부 형식이며 버전에 따라 달라집니다. 스크립트로 내용을 직접 파싱(parse)하는 것은 피하고, 읽을 수 있는 형태로 추출하고 싶을 때는 /export를 사용하십시오.

10. 다음 10분

빈 폴더에서 연습을 마쳤다면, **실제로 진행 중인 프로젝트에서 한 번 claude --continue**를 시도해 보세요. "닫아도 이어서 돌아올 수 있다"는 것을 체감하면, 대화를 잘게 나누는 것에 대한 불안감이 줄어들고, 끊고 싶을 때 부담 없이 닫을 수 있게 됩니다.

11. 공식 정보

• 확인 날짜: 2026-08-01
• Manage sessions (공식 문서): https://code.claude.com/docs/en/sessions

대화는 닫는 순간 사라지는 것이 아니었습니다. --continue를 알고 있는 것만으로도, "다시 처음부터 설명해야 하는" 한숨이 한 번 줄어듭니다. 내일의 나를 조금 더 편하게 만드는 작은 한 수입니다.

Discussion