Switch얼리 액세스
← 전체 가이드
Claude Code

Claude Code resume: --continue, --resume, /resume로 세션 이어가기

가장 최근 Claude Code 세션을 이어가려면 같은 프로젝트 폴더에서 claude --continue를 실행합니다. 더 오래된 세션을 고르려면 claude --resume을 실행해 목록에서 선택하거나, 실행 중인 세션 안에서 /resume을 입력합니다. 세션은 프로젝트 폴더별, 설정 디렉터리별로 저장되며, 세션이 보이지 않는 경우 대부분 이 때문입니다.

Switch · 업데이트

다른 언어: English · Español · Deutsch · Français · 日本語 · 简体中文 · Português (Brasil) · Italiano · Nederlands · 繁體中文

독립적인 Claude Desktop 프로필 관리 앱 Switch가 작성한 가이드입니다. Switch는 정식 출시를 앞두고 얼리 액세스 중입니다.

명령줄에서 이어가기

Anthropic의 세션 문서는 다음 명령을 안내합니다.

claude --continue          # most recent session in this folder
claude --resume            # open the session picker
claude --resume auth-fix   # resume a named session
claude --from-pr 123       # sessions linked to a pull request

-c와 -r은 각각 --continue와 --resume의 짧은 형태입니다. --resume에 세션 ID를 넘길 수도 있습니다. 이때 Claude Code는 현재 프로젝트와 그 git 워크트리를 먼저 찾고, 그다음 Mac의 다른 프로젝트를 찾습니다(CLI 레퍼런스).

--fork-session을 추가하면 새 세션 ID를 가진 사본으로 이어가고 원본은 그대로 둡니다.

Claude Code 안에서 세션 전환하기

프롬프트에서 /resume(또는 별칭 /continue)을 입력하면 Claude Code를 떠나지 않고 같은 선택 목록이 열립니다. /resume 뒤에 이름이나 ID를 붙이면 바로 그 세션으로 이동합니다(명령 레퍼런스).

선택 목록에서 유용한 단축키는 다음과 같습니다.

  • Space: 세션 미리 보기.
  • Ctrl+A: 이 Mac의 모든 프로젝트 세션 표시.
  • Ctrl+W: 저장소의 모든 워크트리로 범위 확장.
  • Ctrl+B: 현재 git 브랜치로 필터링.
  • Ctrl+R: 선택한 세션 이름 바꾸기.

찾기 쉽게 세션에 이름 붙이기

이름이 없는 세션은 자동 생성된 제목이나 첫 프롬프트로 표시되어 훑어보기 어렵습니다. 중요한 세션은 시작할 때 claude -n auth-fix로, 또는 세션 중에 /rename auth-fix로 이름을 붙이세요. 그러면 claude --resume auth-fix로 바로 돌아갈 수 있습니다.

현재 방향을 잃지 않고 다른 접근을 시도하려면 /branch를 실행합니다. 지금까지의 대화를 복사하고 그 사본으로 전환해 줍니다. 포크하지 않고 같은 세션을 두 터미널에서 이어가는 것은 피하세요. Anthropic에 따르면 양쪽의 메시지가 하나의 기록에 뒤섞입니다.

세션이 보이지 않는 이유

Claude Code는 세션 기록을 ~/.claude/projects/<project>/<session-id>.jsonl에 프로젝트 폴더별로 저장합니다. 세션이 보이지 않는 흔한 이유는 다음과 같습니다.

  • 다른 폴더. 선택 목록은 현재 프로젝트부터 보여 줍니다. Ctrl+A를 누르면 전체를 볼 수 있습니다.
  • 다른 설정 디렉터리. CLAUDE_CONFIG_DIR이 설정되어 있으면 세션 기록이 그 디렉터리 아래에 저장되므로 계정마다 세션 목록이 따로 있습니다.
  • 스크립트 실행. claude -p나 Agent SDK로 실행한 세션, /loop로 시작한 세션은 선택 목록과 --continue에서 제외됩니다. -p나 SDK 세션은 ID로 이어가세요.
  • 보관 기간. 2026년 10월 기준, cleanupPeriodDays보다 오래된 세션 기록은 삭제되며 기본값은 30일입니다(.claude 디렉터리 문서).

Claude Desktop 앱에서 시작한 세션은 데스크톱 앱에서 이어갑니다.

세션은 계정과 함께 남습니다

기록이 설정 디렉터리에 저장되므로, 세션은 그것을 만든 계정 환경에 속합니다. 업무용 계정은 claude-work, 개인 계정은 그냥 claude를 쓴다면 각 선택 목록에는 자기 세션만 나옵니다. 이유는 CLAUDE_CONFIG_DIR이 하는 일에서 설명합니다. 같은 디렉터리에서 로그아웃한 뒤 다른 사람으로 다시 로그인하는 경우는 다릅니다. Claude Code 계정 변경하기를 참고하세요.

로컬 체크포인트가 더 나은 경우

세션을 이어가면 대화 전체를 다시 불러옵니다. 같은 계정에서 하던 일을 이어서 할 때는 이 방법이 맞습니다. 하지만 다른 계정에서 작업을 계속하거나 대화가 아주 길 때는 덜 적합합니다. Anthropic에 따르면 긴 대화를 한동안 쉬었다가 이어가면, 저장된 대화만으로 사용량 제한을 얼마나 쓰게 될지 추정해 보여 주는 대화 상자가 나타날 수 있습니다.

짧은 로컬 체크포인트가 더 나을 때가 많습니다. 작업 내용, 바뀐 것, 확인한 것, 다음 단계를 기록한 뒤 같은 프로젝트 폴더에서 새 채팅을 시작하고 그 체크포인트를 가리키면 됩니다. Switch는 이를 수동 핸드오프(작업 인계)로 지원하며, 세션 기록을 자동으로 옮기지는 않습니다. 로컬 체크포인트로 Claude Code 프로젝트 이어가기.

함께 읽기