claude --continue 와 claude --resume 의 차이는 무엇인가요?

claude --continue(-c) 는 지금 폴더의 가장 최근 대화를 바로 엽니다. claude --resume(-r) 은 세션 ID 나 이름을 주면 그 대화를 열고, 아무것도 주지 않으면 고를 수 있는 세션 목록을 띄웁니다.

Claude Code 대화 기록은 어디에 저장되나요?

기본적으로 ~/.claude/projects/ / .jsonl 에 저장됩니다. 공식 문서 기준 보관 기간은 30일이고 cleanupPeriodDays 설정으로 바꿀 수 있습니다.

재부팅 후 hivemux 가 어떤 칸의 Claude 를 다시 열지 않았습니다.

hivemux-panes list 로 재개할 칸 목록을, ~/.local/share/hivemux/panes.log 로 재개 기록을 확인하세요. 마지막 저장 전에 시작했거나 /exit 로 끝낸 세션은 재개하지 않으며, 이때는 그 폴더에서 claude -c 로 이어가면 됩니다.

한 번만 복원 없이 깨끗하게 시작할 수 있나요?

touch ~/tmux_no_auto_restore 를 실행하면 다음 시작 때 복원을 건너뜁니다. 파일을 지우면 다시 복원합니다.

Claude Code 세션 복구, 재부팅 후 이어서 작업하는 방법

macOS 업데이트나 갑작스러운 재부팅 뒤에 Claude Code 세션 여러 개를 다시 띄우는 일은 생각보다 번거롭습니다. 어떤 폴더에서 어떤 대화를 하고 있었는지 기억해 내야 하기 때문입니다. 이 글은 Claude Code 자체 기능으로 대화를 다시 여는 방법, tmux 배치까지 되살리는 방법, hivemux 가 이 과정을 자동으로 처리하는 방식을 차례로 설명합니다.

Claude Code 대화 다시 열기

Claude Code 는 작업하는 동안 대화를 로컬 파일에 계속 저장합니다. 공식 문서 기준 기본 위치는 ~/.claude/projects/<project>/<session-id>.jsonl 입니다. 그래서 프로세스가 끝나도 대화를 다시 열 수 있습니다.

# 이 폴더의 가장 최근 대화
claude --continue

# 세션 목록에서 골라 열기
claude --resume

# 이름이나 세션 ID 로 바로 열기
claude --resume auth-refactor

실행 중인 세션 안에서는 /resume 으로 다른 대화로 바꿀 수 있습니다. 목록에서는 ↑ ↓ 로 고르고 Enter 로 엽니다. 기본 목록은 지금 폴더의 세션만 보여 주고, Ctrl+A 를 누르면 이 Mac 의 모든 프로젝트로 넓어집니다.

세션에 이름을 붙여 두면 다시 찾기가 훨씬 쉽습니다. 시작할 때 claude -n auth-refactor 로, 실행 중에는 /rename 으로 붙입니다. 이름을 정하지 않으면 Claude Code 가 첫 프롬프트를 요약한 제목을 붙이고, 그 제목으로도 --resume 할 수 있습니다.

tmux-resurrect 로 배치 복원

tmux 안에서 여러 세션을 쓰고 있었다면 대화뿐 아니라 tmux 세션, 창, 분할 배치도 되살려야 합니다. tmux 서버는 재부팅하면 사라지기 때문입니다. 흔히 쓰는 조합은 tmux 플러그인 tmux-resurrect 와 tmux-continuum 입니다. resurrect 는 세션, 창, 분할, 작업 폴더를 저장하고 복원하며, continuum 은 이 저장을 주기적으로 자동 실행합니다.

다만 resurrect 는 칸 안에서 어떤 Claude 대화가 열려 있었는지는 모릅니다. 배치가 돌아와도 각 칸은 빈 셸이고, 칸마다 들어가 claude --resume 으로 맞는 대화를 직접 골라야 합니다.

hivemux 의 세션 복구 방식

hivemux 는 모든 Claude Code 세션을 실행 중·입력 대기·완료 상태로 보여 주고, 나를 기다리는 세션으로 바로 이동하게 해 주는 tmux 사이드바입니다. hivemux setup 을 실행하면 tmux-resurrect 와 tmux-continuum 을 받아 오고(이미 ~/.tmux/plugins 에 있으면 그것을 씀), 칸과 Claude 대화를 잇는 훅을 등록합니다.

curl -fsSL https://hivemux.dev/install.sh | bash

구성 요소의 역할은 다음과 같습니다.

Claude Code 훅: 세션이 시작될 때마다 세션 ID 와 폴더를 해당 tmux 칸에 기록합니다.
resurrect + continuum: 5분마다 세션, 창, 분할 배치, 작업 폴더를 저장합니다. 저장할 때 hivemux 가 칸과 세션 ID 목록도 함께 남깁니다.
hivemux-panes: 복원할 때 저장된 칸과 세션 ID 를 짝지어 칸마다 claude --resume <id> 를 입력합니다.

재부팅 후 복원 순서

Ghostty 를 열면 다음 순서로 진행됩니다.

hivemux-attach 가 tmux 서버가 없으면 임시 세션 하나로 서버를 띄웁니다.
tmux-resurrect 가 마지막 저장본으로 세션, 창, 분할, 폴더를 다시 만듭니다.
hivemux-panes restore 가 셸 프롬프트 상태인 칸에만 원래 폴더로 이동해 claude --resume <id> 를 입력합니다.
복원 전에 마지막으로 보던 세션에 붙습니다.

/exit 로 직접 끝낸 세션은 재개하지 않습니다. 자동 저장은 5분마다라서, 방금 만든 창이 복원 목록에 없을 수 있습니다. 중요한 작업을 시작했다면 prefix 다음 Ctrl+S 로 바로 저장하세요.

재부팅 뒤 같은 배치로 돌아온 hivemux 사이드바와 Claude Code 세션 카드

복원 확인과 제어

hivemux-panes list                           # 재부팅 후 재개할 칸 목록
cat ~/.local/share/hivemux/panes.log         # 재개 기록
touch ~/tmux_no_auto_restore                 # 다음 시작 때 복원 건너뛰기
tmux set-environment -g HIVEMUX_NO_RESUME 1  # 배치만 복원하고 Claude 는 재개하지 않기

재개 기록에 busy 가 있으면 그 칸이 셸 프롬프트가 아니어서 건너뛴 것이고, pane missing 이면 배치가 바뀌어 칸이 없어진 것입니다. 이럴 때는 그 폴더에서 claude -c 로 이어가면 됩니다. 더 많은 증상은 문제 해결 문서를 참고하세요.