SSD Nodes Learn Hosting plans →
가이드 Matt Connor작성자 Matt Connor

Claude Code 세션 재개 및 대화 기록 확인 방법

Claude Code 세션을 이름이나 선택기로 재개하는 방법과 로컬에 저장된 plaintext 대화 기록을 찾는 경로를 안내합니다. 터미널이 종료되어도 유지되는 세션 데이터의 구조와 재개 시 복원되지 않는 플래그 정보를 확인하여 작업을 안전하게 이어가십시오.

Claude Code 세션을 재개하는 방법

Claude Code 세션을 재개하려면 현재 디렉터리에서 가장 최근 대화를 불러오는 claude --continue을 실행하거나, 목록에서 이전 대화를 선택할 수 있는 claude --resume를 실행하십시오. 이미 실행 중인 세션 내부에서는 /resume 명령어를 사용하여 세션을 종료하지 않고도 다른 대화로 전환할 수 있습니다. 단축 명령어는 -c와 -r입니다.

claude --continue
claude --resume
claude --resume auth-refactor

세션 이름이나 ID를 이미 알고 있다면 이를 인수로 전달하십시오. 그러면 선택 화면을 거치지 않고 해당 세션으로 바로 이동합니다.

아래의 모든 내용은 2026년 11월 기준 공식 세션 문서와 일치합니다. Claude Code는 자주 릴리스되며 버전마다 플래그 이름이나 키보드 단축키가 변경될 수 있습니다. 따라서 이 문서의 내용이 터미널에 표시되는 내용과 다를 경우 claude --help와 해당 페이지를 우선적인 기준으로 삼으십시오.

세션의 실제 의미

세션은 프로젝트 디렉터리에 연결된 하나의 저장된 대화입니다. 여기에는 Claude가 수행한 도구 호출과 그 결과값을 포함한 전체 메시지 기록이 담겨 있습니다. Claude Code는 작업이 끝날 때 한 번만 저장하는 것이 아니라 작업하는 동안 지속적으로 디스크에 기록하므로, 터미널을 닫거나 SSH 연결이 끊겨도 대화 내용은 유지됩니다.

세션을 재개하면 텍스트 이상의 정보가 복원됩니다. 대화 기록 전체가 복원되며, 세션이 사용하던 모델과 --agent를 통해 시작된 서브 에이전트도 함께 돌아옵니다. --continue 또는 세션 ID를 사용하여 셸에서 재개할 때 권한 모드도 복원되지만, 안전을 위해 한 가지 예외가 있습니다. bypass-permissions 모드는 절대 복원되지 않으므로, 이 모드로 종료된 세션을 재개하면 새 세션이 시작되는 기본 모드로 돌아갑니다. Plan 모드는 세션 선택기에서 선택하거나 /resume로 전환할 때 복원됩니다. 이 두 가지 경로는 원래 저장된 모드를 유지하지 않지만, 터미널 재개 시에는 v2.1.290부터, 선택기와 /resume에서는 v2.1.292부터 Plan 모드가 복원되도록 변경되었습니다. 이전 버전에서는 재개 시 Plan 모드가 해제되었습니다. 셸에서 --permission-mode를 사용하면 복원되는 모드와 상관없이 해당 모드가 우선 적용됩니다.

일부 항목은 저장된 상태가 아니라 시작 시점의 플래그이므로 복원되지 않습니다. --add-dir로 추가한 디렉터리나 --mcp-config, --settings, --plugin-dir 같은 옵션은 재개할 때 다시 전달해야 합니다. settings.json와 같은 설정 파일은 시작 시점에 다시 읽어 들이므로, 해당 파일에 포함된 내용은 반복해서 설정할 필요가 없습니다. 자격 증명도 마찬가지입니다. Claude Code는 대화와 함께 복원하는 대신, 로그인 정보와 환경을 바탕으로 시작 시점에 인증 방식을 결정합니다. 따라서 셸에 잘못된 ANTHROPIC_API_KEY이 포함된 VPS에서 세션을 재개하면, 이전에는 잘 작동했더라도 잘못된 API 키 오류가 발생합니다.

VPS에서 세션 기록이 더 중요한 이유

사람들이 놀라는 사실이 하나 있습니다. 대화 기록(transcript)은 에이전트가 실행된 머신에 저장됩니다. 이는 귀하의 계정에 보관되거나 클라우드로 동기화되지 않습니다. 해당 장비의 디스크에 있는 파일일 뿐입니다.

따라서 VPS의 tmux 창에 남겨둔 세션은 노트북의 선택기(picker)에 나타나지 않으며, 노트북에서 수행한 세션도 VPS에 나타나지 않습니다. 두 환경 사이에서 데이터가 이동하지 않기 때문입니다. 대부분의 사용자가 VPS의 tmux에서 Claude Code를 실행하는 방식으로 작업할 경우, 실제 대화 기록은 서버에 누적되며 로컬에서 보이는 선택기에는 훨씬 적은 수의 세션만 표시됩니다.

이러한 분리 현상은 인터페이스 간에도 동일하게 적용됩니다. 데스크톱 앱과 VS Code 확장 프로그램은 각각 고유한 세션 기록을 유지하며, 이들은 CLI의 기록과 별개입니다. 단, 데스크톱 앱은 CLI 세션을 이어받을 수 있습니다. 웹 버전의 Claude Code 역시 별도의 기록을 유지합니다. Cowork는 이보다 더 분리되어 있습니다. Cowork 세션은 기본적으로 Anthropic 클라우드에서 실행되며 사용자가 소유한 하드웨어가 아닌 Claude 계정에 저장됩니다. 로컬 실행은 기존 데스크톱 배포 환경에서만 유지됩니다. 따라서 Cowork와 Claude Code를 비교할 때, 대화 기록이 어디에 저장되는지는 결정의 중요한 요소가 됩니다.

한 머신 내부에서의 검색 범위는 예상보다 넓습니다. claude --resume <session-id>은 현재 프로젝트 디렉터리와 해당 git 워크트리를 먼저 검색한 다음, 해당 머신에 있는 다른 모든 프로젝트를 검색합니다. 여기서 기억해야 할 핵심은 "해당 머신 내에서"라는 점입니다. 다른 호스트의 세션 ID는 아무것도 불러올 수 없으며, Claude Code는 No conversation found with session ID: <session-id>을 통해 이를 알려줍니다.

Claude Code는 세션 기록을 어디에 저장합니까

기본적으로 기록은 Claude Code 설정 디렉터리 내의 ~/.claude/projects/<project>/<session-id>.jsonl 경로에 저장됩니다.

<project>은 사용자의 작업 디렉터리 경로에서 영문자와 숫자가 아닌 모든 문자를 하이픈으로 치환한 값입니다. 따라서 /home/deploy/apps/api에서 시작된 세션은 -home-deploy-apps-api라는 이름의 디렉터리에 저장됩니다. 변환된 이름이 200자를 초과하면 Claude Code는 이를 잘라내고 전체 경로의 해시값을 덧붙여 디렉터리 이름이 파일 시스템 제한 내에 유지되도록 합니다.

파일 형식은 JSONL입니다. 한 줄에 하나의 JSON 객체가 포함되며, 각 줄은 메시지, 도구 사용 또는 그 결과, Claude Code가 모델로 보낸 요청 기록, 혹은 메타데이터 항목을 나타냅니다. 이는 읽을 수 있는 텍스트이므로 내용을 확인해도 괜찮습니다.

이 파일을 파싱하는 것은 권장하지 않습니다. 항목 형식은 Claude Code 내부용이며 버전마다 변경될 수 있으므로, 이 파일을 직접 읽는 스크립트는 업데이트 시 작동하지 않을 수 있습니다. Anthropic의 공식 문서에서도 정확히 이러한 이유로 /export이나 문서화된 스크립트 인터페이스를 사용할 것을 권장합니다.

두 가지 설정을 통해 저장 위치와 방식을 변경할 수 있습니다. CLAUDE_CONFIG_DIR는 전체 설정 디렉터리의 위치를 옮기며, 이를 통해 기록을 별도의 볼륨이나 암호화된 볼륨에 저장할 수 있습니다. settings.json의 cleanupPeriodDays는 기록 보관 기간을 제어하며, 기본값은 30일이고 최소 1일로 설정할 수 있습니다.

트랜스크립트 파일 내부에는 무엇이 포함되는가

모든 도구 실행 결과가 기록되므로, 트랜스크립트에는 Claude가 읽은 파일의 내용과 Claude가 실행한 명령의 출력 결과가 포함됩니다. Anthropic의 데이터 사용 페이지는 이를 명확히 밝히고 있습니다. Claude Code는 세션 트랜스크립트를 ~/.claude/projects/ 경로에 일반 텍스트(plaintext) 형태로 로컬에 저장합니다. 트랜스크립트에는 Claude Code가 모델로 전송하는 내용도 기록되므로, 시스템 프롬프트, 도구 정의, 요청 매개변수 및 로드된 CLAUDE.md 파일이 포함될 수 있습니다.

서버 환경에서 이것이 무엇을 의미하는지 고려해야 합니다. Claude가 서비스가 시작되지 않는 원인을 파악하기 위해 .env 파일을 읽었다면, 해당 파일의 내용은 이제 홈 디렉터리의 JSONL 파일 안에 저장됩니다. 명령어가 연결 문자열을 출력했다면, 그 문자열 역시 파일 안에 존재합니다. 데이터가 유출된 것은 아닙니다. 트랜스크립트는 발생한 일을 기록하며, 그것이 바로 트랜스크립트의 존재 목적입니다. 그렇기에 트랜스크립트는 반드시 위협 모델(threat model)에 포함되어야 합니다.

  • 백업: /home 또는 /root 경로를 단순히 백업하면 트랜스크립트도 백업 저장소로 함께 복사됩니다. 제외 설정을 추가하거나, 프롬프트와 파일 내용의 사본이 백업 저장소에 저장된다는 점을 인지하십시오.
  • 스냅샷 및 이미지: 어떤 이유로든 생성된 VPS 스냅샷에는 해당 디렉터리 전체가 포함됩니다. 두 번째 서버를 구축하기 위해 복제한 이미지도 마찬가지입니다.
  • 서버 내 다른 계정: 권한이 엄격하게 설정되어 있다고 가정하지 말고, ls -ld ~/.claude ~/.claude/projects 명령을 사용하여 직접 모드를 확인하십시오.
  • 의도적인 업로드: /feedback 명령은 대화 기록을 Anthropic으로 의도적으로 전송하며, /bug 및 /share 명령도 동일한 경로를 통해 보고합니다. 피드백 대화 상자에는 현재 세션뿐만 아니라 지난 24시간 또는 7일 동안의 동일 프로젝트 내 다른 세션이 포함될 수 있습니다. 이는 사용자가 선택하는 동작이므로, 확인 버튼을 누르기 전에 어떤 내용에 동의하는지 파악하십시오.

트랜스크립트가 생성되지 않기를 원한다면, CLAUDE_CODE_SKIP_PROMPT_HISTORY 옵션으로 트랜스크립트 기록을 억제할 수 있으며, --no-session-persistence 옵션으로 단일 비대화형 claude -p 실행 시에만 기록을 억제할 수 있습니다. 설정을 변경하기 전에 이로 인한 트레이드오프를 명확히 이해하십시오. 트랜스크립트는 재개(resume) 기능이 읽어 들이는 데이터이므로, 트랜스크립트가 없으면 재개 기능을 사용할 수 없습니다.

이전 대화 내용을 찾는 방법

claude --resume을 입력하거나 실행 중인 세션 내에서 /resume을 입력하여 선택 창을 엽니다. 각 행에는 사용자가 설정한 세션 이름이 표시되며, 설정하지 않은 경우에는 생성된 제목이 표시됩니다. 또한 마지막 활동 이후 경과 시간, git 브랜치, 파일 크기가 함께 나타납니다.

선택 창에서 검색을 수행할 수 있습니다. /를 누르거나 바로 입력을 시작하여 목록을 필터링하십시오. 유용한 단축키로는 검색 범위를 넓히는 기능들이 있습니다. Ctrl+A은 이 머신에 있는 모든 프로젝트의 세션을 표시하고, Ctrl+W는 현재 저장소의 모든 작업 트리를 표시하며, Ctrl+B는 현재 git 브랜치로 필터링합니다. Space을 누르면 세션을 선택하기 전에 내용을 미리 볼 수 있으며, Ctrl+R을 누르면 강조 표시된 세션의 이름을 변경할 수 있습니다.

세션에 이름을 지정하면 이 모든 과정이 훨씬 쉬워집니다. claude -n auth-refactor로 세션을 시작하거나, 대화가 본격적인 작업으로 전환되었다고 판단되는 시점에 /rename auth-refactor를 실행하십시오. 이름을 지정한 세션은 셸에서 이름만으로 바로 재개할 수 있습니다.

이름이 없는 세션도 첫 번째 프롬프트를 요약하는 작고 빠른 모델의 백그라운드 요청을 통해 생성된 제목을 갖게 됩니다. 이 제목은 선택 창에서 해당 행을 식별하는 데 도움을 주며, 재개 핸들로도 작동합니다. 즉, claude --resume은 사용자가 설정한 이름과 동일한 방식으로 해당 세션을 찾아냅니다. 다만, 실행 중인 세션 목록에 표시되는 my-app-3f과 같은 기본 표시 이름은 재개 핸들로 작동하지 않습니다. 이를 claude --resume에 전달하면 Claude Code는 해당 세션을 찾지 못합니다.

트랜스크립트 grep을 통한 세션 찾기

특정 문구만 기억나고 다른 정보가 없을 때가 있습니다. 트랜스크립트는 텍스트 형식이므로 검색이 가능합니다.

grep -rl "nftables" ~/.claude/projects/

이 명령은 일치하는 트랜스크립트의 경로를 출력합니다. .jsonl 확장자를 제외한 파일 이름이 세션 ID이며, claude --resume <session-id>는 이 ID를 인자로 받습니다. 또한 claude --resume는 트랜스크립트의 절대 경로를 직접 입력받을 수도 있습니다. grep을 사용하여 원하는 세션을 찾아낸 뒤, 해당 세션을 재개하거나 내보내어 내용을 확인하십시오.

두 가지 주의 사항이 있습니다. 첫째, 콘텐츠가 JSON으로 이스케이프되어 있으므로 따옴표가 포함된 문구나 줄 바꿈으로 나뉜 문구는 리터럴 문자열로 일치하지 않을 수 있습니다. 둘째, 도구 실행 결과 내에서 일치하는 항목이 발견되었다면 이는 누군가 입력한 내용이 아니라 Claude가 해당 텍스트를 확인했음을 의미합니다.

대화 내용 읽기 및 내보내기

/export는 현재 대화 내용을 JSON 형식이 아닌 읽기 쉬운 일반 텍스트로 렌더링합니다. 인수를 지정하지 않으면 클립보드 복사 또는 파일 저장 메뉴가 나타납니다. 파일 이름을 지정하면 /export handover.txt은 해당 경로로 즉시 내용을 기록합니다. 이 방법은 서버의 대화 내용을 로컬 노트북으로 옮기거나 티켓에 첨부할 때 사용하는 올바른 방식입니다.

자동화가 필요한 작업에는 안정성이 보장된 인터페이스를 사용하십시오. 훅(hook)과 상태 표시줄 명령어는 입력값으로 transcript_path 필드를 받으므로, SessionEnd 훅을 사용하면 세션이 종료될 때 대화 기록을 보관할 수 있습니다. 또한 저장된 세션을 열지 않고도 질문을 던질 수 있습니다.

claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'

이 명령은 이전 대화 내용에 후속 프롬프트를 전송하고 구조화된 JSON을 반환합니다. 이는 다음 릴리스에서 변경될 수 있는 JSONL 형식을 파싱하는 것보다 훨씬 더 나은 기반이 됩니다.

새로 시작하는 것이 이어하기보다 나은 경우

대화를 이어가면 전체 기록이 다시 불러와지며, 이후의 모든 요청은 이 전체 기록을 포함하게 됩니다. 어제 4시간 동안 진행된 대화를 오늘 계속하는 것은 비용이 많이 듭니다. 긴 세션에서 토큰 사용량이 누적되는 방식에서 이러한 비용이 실제로 어디서 발생하는지 설명합니다.

Claude Code는 때때로 사용자를 위해 절충안을 제시합니다. 대화형 터미널 세션에서 긴 대화를 유휴 상태로 두면, Claude 구독 플랜에 따라 기본적으로 제공되는 1시간 프롬프트 캐시 내에서 유휴 압축(idle compaction) 기능이 캐시 만료 직전인 약 54분 후에 대화를 압축합니다. 이 기능은 대화의 컨텍스트가 기본값인 200,000 토큰 임계값에 도달하고, 자동 압축이 켜져 있으며, 해당 시점에 기기가 깨어 있을 때 적용됩니다. v2.1.314 이전에는 Claude Code가 Anthropic으로부터 기능 플래그를 가져와야 했기 때문에 원격 측정을 끈 구독자는 이 기능을 사용할 수 없었습니다. v2.1.314부터는 원격 측정을 끈 사용자도 이 기능을 사용할 수 있으며, VS Code 확장 프로그램의 채팅 패널과 데스크톱 앱의 Code 탭에서도 작동합니다. 별도의 확인 대화 상자는 나타나지 않습니다. 다시 돌아오면 대화창에 Compacted while idle, before the prompt cache expired로 시작하는 줄이 표시되며, 다음 메시지부터는 전체 기록 대신 요약본이 전송됩니다.

  • 기능을 켜두면 이후 요청 비용은 저렴해지지만, 요약 과정에서 제외된 내용은 더 이상 참조할 수 없습니다. CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS를 사용하여 임계값을 낮출 수 있으나, 100,000 미만의 값은 100,000으로 상향 조정됩니다.
  • settings.json에서 idleCompaction을 false로 설정하거나, v2.1.302 이상 버전의 /config에 있는 유휴 압축 행에서 기능을 끄면 대화 전체가 유지되며 요청당 비용은 대화 크기에 비례하여 증가합니다. 다음 메시지를 보낼 때 캐시가 만료되었다면, 해당 요청은 전체 기록을 한 번 다시 처리하게 됩니다.

Pro 및 Max 플랜의 경우 v2.1.304에서 검사 단계가 하나 더 추가되었으며, 현재 문서에는 Ultra 플랜도 포함되어 있습니다. 긴 휴식 후 긴 대화를 이어가거나 다른 모델을 사용할 때 5시간 사용 제한의 상당 부분을 차지하게 되면, Resume this conversation? 대화 상자가 예상 점유율을 표시하며 대화를 계속할지 아니면 새로 시작할지 선택하게 합니다. 새 대화 옵션에서 안내하는 대로, 이전 대화를 언급하면 Claude가 해당 내용을 조회할 수 있습니다.

판단은 생각보다 간단합니다. 다음에 입력할 내용이 이전에 나눈 대화에 의존한다면 이어하기를 선택하십시오. 그렇지 않다면 새로 시작하십시오. Claude가 한 시간 전에 삭제한 파일을 언급하거나 세션 초기에 이미 결정된 사항을 다시 논의하는 등 대화의 흐름이 어긋나는 현상은 쉽게 발견할 수 있습니다. 이는 오래된 컨텍스트이며, 이를 계속 유지하는 것은 토큰 비용을 발생시킬 뿐만 아니라 정확도도 떨어뜨립니다.

이전 대화에서 유용한 결정 사항이나 사실을 다시 사용해야 한다면, 이어하기 기능에 의존하지 마십시오. 모든 세션에서 확인할 수 있도록 기록해 두어야 하며, 이것이 바로 Claude Code의 메모리 파일이 존재하는 이유입니다.

이 상황에서는 /branch도 알아두면 유용합니다. 이 명령은 현재 시점까지의 대화를 복사하고 해당 복사본으로 전환하며, 원본은 그대로 유지하여 선택기에서 계속 확인할 수 있게 합니다. 첫 번째 접근 방식을 잃지 않고 두 번째 방식을 시도할 때 사용하십시오.

재개(Resume)와 압축(Compaction), 그리고 메모리(Memory)의 차이

이 개념들은 자주 혼동되지만, 각각 해결하는 문제가 다릅니다.

재개는 종료, 재부팅 또는 다른 작업으로 전환한 후 대화를 다시 불러오는 기능입니다. 압축은 활성 대화 내의 컨텍스트 윈도우를 다룹니다. /compact는 Claude가 유지하고 있는 내용을 요약으로 대체하여, 이후 요청에서 더 적은 토큰을 사용하도록 합니다. 컨텍스트 윈도우가 가득 찬 것이 문제라면 압축 기능을 사용해야 하며, Claude Code 컨텍스트 윈도우 관리에서 이를 적절히 다룹니다.

메모리는 이와 또 다릅니다. CLAUDE.md 파일과 자동 메모리는 모든 세션 시작 시 로드되는 지침과 사실 정보를 담고 있으므로, 사용자가 돌아가는 대화가 아닙니다. 이는 다시 돌아갈 필요가 없도록 미리 기록해 두는 정보입니다.

두 개의 대화를 동시에 실행하면서 조율하고 싶다면, 이는 별도의 메커니즘이 필요합니다. Claude Code 세션 간 메시지 전송은 두 세션이 모두 활성화된 상태에서 이루어지며, 이는 어제의 세션을 디스크에서 다시 불러오는 것과는 다른 문제입니다.

FAQ

Claude Code는 세션 기록을 어디에 저장합니까?

기본적으로 설정 디렉터리 내의 ~/.claude/projects/<project>/<session-id>.jsonl에 저장됩니다. 여기서 <project>은 작업 디렉터리 경로의 영숫자가 아닌 문자를 하이픈으로 치환한 값입니다. 각 파일은 JSONL 형식이며, 한 줄에 메시지, 도구 사용 또는 그 결과, 모델에 전송된 요청 기록, 메타데이터 항목이 JSON 객체 하나씩 기록됩니다. CLAUDE_CONFIG_DIR을 사용하면 설정 디렉터리를 다른 곳으로 옮길 수 있으며, settings.json의 cleanupPeriodDays를 통해 기록 보관 기간을 설정할 수 있습니다. 기본값은 30일이며 최소 1일로 설정 가능합니다.

노트북의 선택기(picker)에서 왜 VPS 세션이 보이지 않습니까?

기록은 에이전트가 실행된 머신의 디스크에 저장되며, 머신 간에 동기화되지 않기 때문입니다. VPS의 tmux 내부에서 나눈 대화는 해당 VPS에만 존재합니다. SSH를 통해 해당 VPS에서 세션을 재개하거나, 내부에서 /export을 실행하여 텍스트 파일을 복사해 로컬 기록으로 남기십시오.

다른 디렉터리에서 시작한 세션을 재개할 수 있습니까?

네, 세션 ID를 알고 있다면 가능합니다. claude --resume <session-id>는 현재 프로젝트 디렉터리와 해당 git 워크트리를 먼저 탐색한 뒤, 동일한 머신 내의 다른 모든 프로젝트를 탐색합니다. 선택기 내부에서 Ctrl+A을 누르면 머신 내의 모든 프로젝트로 범위를 넓히고, Ctrl+W를 누르면 현재 저장소의 모든 워크트리로 범위를 넓힙니다. 일치하는 항목이 없으면 Claude Code는 No conversation found with session ID: <session-id>를 보고합니다.

이전 세션을 재개해야 합니까, 아니면 새 세션을 시작해야 합니까?

다음 메시지가 이전 대화 내용에 의존한다면 세션을 재개하십시오. 그렇지 않다면 새로 시작하는 것이 좋습니다. 세션을 재개하면 전체 기록을 다시 불러오며, 이후의 모든 요청에 해당 기록이 포함되기 때문입니다. 컨텍스트 드리프트를 주의하십시오. 이미 삭제한 파일을 계속 참조하는 세션은 오래된 컨텍스트를 포함하고 있으며, 이 컨텍스트는 매 턴마다 토큰 비용을 발생시키고 정확도를 떨어뜨립니다.

Claude Code가 디스크에 기록을 남기지 않게 할 수 있습니까?

네. CLAUDE_CODE_SKIP_PROMPT_HISTORY을 사용하면 기록 저장을 비활성화할 수 있으며, --no-session-persistence은 비대화형 claude -p 실행 시에만 기록 저장을 비활성화합니다. 기록은 재개(resume) 기능이 읽어 들이는 데이터이므로, 이를 끄면 --continue 및 --resume이 불러올 데이터가 없어진다는 점을 먼저 이해해야 합니다. 파일의 존재 자체가 아니라 저장 위치가 문제라면, CLAUDE_CONFIG_DIR을 암호화된 볼륨으로 지정하고 cleanupPeriodDays를 낮추는 방식을 고려하십시오.

이 글이 도움이 되었나요?