Claude Code는 모든 대화를 ~/.claude/history.jsonl에 저장한다. 내장 명령만으로도 세션 이어받기·탐색이 가능하고, 커스텀 /history 명령을 추가하면 수백 개 세션에 걸친 전체 기록을 한눈에 볼 수 있다.

기본 제공 세션 관리 명령

최근 세션 이어받기

claude --continue
# 또는
claude -c

현재 디렉터리에서 마지막으로 작업한 세션을 그대로 재개한다. 점심 후 돌아와서 작업을 이어갈 때 가장 자주 쓰는 명령이다.

특정 세션 선택해서 재개

claude --resume
# 또는
claude -r

인터랙티브 목록을 표시한다. 세션 요약, 메시지 수, Git 브랜치명, 타임스탬프가 함께 표시된다. A를 누르면 전체 프로젝트 목록, B를 누르면 현재 Git 브랜치 기준 필터링으로 전환된다.

세션 ID를 알고 있으면 바로 이동:

claude --resume abc123def456

실행 중 세션 전환

/resume

Claude Code를 종료하지 않고도 세션 전환이 가능하다. 여러 작업을 동시에 진행할 때 특히 유용하다.

세션 이름 지정

/rename auth-refactor

자동 생성된 요약 대신 사람이 읽을 수 있는 이름을 붙인다. 나중에 찾기 위해 시작부터 이름을 붙이는 습관이 권장된다.

대화 내보내기

/export my-session.md
# 파일명 없이 클립보드로도 가능
/export

전체 대화를 파일로 저장한다. 팀과 공유하거나 대규모 리팩터 전 작업 근거를 보관할 때 유용하다.

커스텀 /history 명령

내장 /resume은 세션 단위 요약을 보여주지만, 특정 프롬프트를 세션에 무관하게 전체 기록에서 찾으려면 커스텀 명령이 필요하다. history.jsonl의 원시 로그를 파싱해 모든 프로젝트에 걸친 전체 기록을 보여준다.

# 명령 디렉터리 생성
mkdir -p ~/.claude/commands

# /history 명령 파일 생성
cat > ~/.claude/commands/history.md << 'EOF'
Please read my global conversation history from ~/.claude/history.jsonl and present it in an easy-to-scan format.

For each conversation, show:
- Entry number
- Date/time (human readable format: "Nov 10, 2025 15:48")
- Project name (just the folder name, not full path)
- First 60-80 characters of the conversation topic
- Session ID (if available)

IMPORTANT: Format as a plain text table with properly padded columns (NOT markdown tables).

Focus on the most recent 10 conversations in the first table. If there are more, show another 5-7 in an "Additional Recent Conversations" table.

At the end, include:
Tip: Resume any conversation by running:
- claude --resume <session-id>
- claude --resume (to see an interactive list of recent sessions)
EOF

설정 후 어느 세션에서든 /history를 입력하면 다음과 같은 결과를 볼 수 있다:

| #  | Date               | Project           | Topic                             | Session ID    |
|----|--------------------|--------------------|-----------------------------------|---------------|
| 68 | Nov 10, 2025 09:32 | astro-blog         | Let's add PostHog analytics...    | abc123def456  |
| 67 | Nov 9, 2025 16:45  | tip-calculator     | Help me set up GitHub actions...  | 789xyz123abc  |

~/.claude/commands/에 저장되므로 모든 프로젝트에서 공통으로 사용된다.

대화 데이터 관리

자동 압축(auto-compaction)은 컨텍스트가 일정 크기를 초과하면 자동으로 요약해 새 세션에 전달한다. 압축이 발생하기 전 중요한 세션은 /export로 보관해 두는 것이 좋다.

참고 자료

• How to resume, search, and manage Claude Code conversations — @kentgigger (2026-03-23)