Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
세션은 프로젝트 디렉토리에 연결된 저장된 대화입니다. Claude Code는 작업할 때 로컬에 저장하므로 중단한 지점부터 재개하거나, 다른 접근 방식을 시도하기 위해 분기하거나, 작업 간에 전환할 수 있습니다.
데스크톱 앱, 웹의 Claude Code, VS Code 확장은 각각 자신의 세션 기록을 유지합니다. 이 페이지는 CLI를 다룹니다:
- 재개 플래그, 이름 또는 PR로 이전 대화 재개
- 이름 세션에 이름을 지정하여 나중에 찾을 수 있도록 함
- 찾아보기
/resume 선택기로 세션 찾아보기
- 분기 대화를 분기하여 다른 접근 방식 시도
- 내보내기 대화 기록을 내보내고 디스크에서 찾기
세션 재개
세션은 작업할 때 로컬 대화 기록 파일에 지속적으로 저장되므로 종료하거나 /clear를 실행한 후에 세션으로 돌아갈 수 있습니다. 다음 진입점을 사용합니다:
| 명령 | 기능 |
|---|
claude --continue | 현재 디렉토리에서 가장 최근 세션을 재개합니다 |
claude --resume | 세션 선택기를 엽니다 |
claude --resume <name> | 지정된 이름의 세션을 직접 재개합니다 |
claude --from-pr <number> | 해당 풀 요청에 연결된 세션을 재개합니다 |
/resume | 활성 세션 내에서 다른 대화로 전환합니다 |
claude -p 또는 Agent SDK로 생성된 세션은 세션 선택기에 나타나지 않지만, 세션 ID를 claude --resume <session-id>에 전달하여 여전히 재개할 수 있습니다.
세션 선택기가 찾는 위치
세션은 프로젝트 디렉토리별로 저장됩니다. 기본적으로 세션 선택기는 현재 worktree의 대화형 세션과 /add-dir로 현재 디렉토리를 추가한 다른 곳에서 시작된 세션을 표시합니다. Ctrl+W를 사용하여 저장소의 모든 worktree로 확장하거나 Ctrl+A를 사용하여 이 머신의 모든 프로젝트로 확장합니다.
같은 저장소의 다른 worktree에서 세션을 선택하면 그 위치에서 재개됩니다. 관련 없는 프로젝트에서 세션을 선택하면 cd 및 재개 명령을 클립보드에 복사합니다.
이름으로 재개하면 현재 저장소 및 해당 worktree 전체에서 확인됩니다. 두 형식 모두 정확한 일치를 찾고 다른 worktree에 있더라도 직접 재개합니다:
| 명령 | 정확한 일치 | 모호한 이름 |
|---|
claude --resume <name> | 직접 재개 | 이름을 검색어로 미리 채운 세션 선택기를 엽니다 |
/resume <name> | 직접 재개 | 오류를 보고합니다. 세션 선택기를 열려면 인수 없이 /resume를 실행합니다 |
세션 이름 지정
세션에 설명적인 이름을 지정하여 세션 선택기에서 찾을 수 있고 이름으로 재개할 수 있도록 합니다. 이는 여러 작업을 병렬로 진행할 때 가장 중요합니다.
| 시기 | 이름을 설정하는 방법 |
|---|
| 시작 시 | claude -n auth-refactor |
| 세션 중 | /rename auth-refactor. 이름은 프롬프트 표시줄에도 나타납니다 |
| 세션 선택기에서 | 세션을 강조 표시하고 Ctrl+R을 누릅니다 |
| 계획 수락 시 | 계획 모드에서 계획을 수락하면 이미 설정하지 않은 경우 계획 내용에서 세션 이름을 지정합니다 |
claude --resume <name> 또는 /resume <name>으로 돌아갑니다. worktree 전체에서 이름 확인이 어떻게 작동하는지는 세션 재개를 참조합니다.
세션 선택기 사용
세션 내에서 /resume을 실행하거나 인수 없이 claude --resume을 실행하여 대화형 세션 선택기를 엽니다. 다음 키보드 단축키를 사용하여 탐색, 검색 및 목록 확장:
| 단축키 | 작업 |
|---|
↑ / ↓ | 세션 간 탐색 |
→ / ← | 그룹화된 세션 확장 또는 축소 |
Enter | 강조 표시된 세션 재개 |
Space | 세션 내용 미리보기. 터미널이 붙여넣기로 캡처하지 않는 경우 Ctrl+V도 작동합니다 |
Ctrl+R | 강조 표시된 세션 이름 바꾸기 |
/ 또는 Space 이외의 인쇄 가능한 문자 | 검색 모드를 입력하고 세션을 필터링합니다. GitHub, GitHub Enterprise, GitLab 또는 Bitbucket 풀 또는 병합 요청 URL을 붙여넣어 이를 생성한 세션을 찾습니다 |
Ctrl+A | 이 머신의 모든 프로젝트에서 세션을 표시합니다. 다시 누르면 현재 저장소로 돌아갑니다 |
Ctrl+W | 현재 저장소의 모든 worktree에서 세션을 표시합니다. 다시 누르면 현재 worktree로 돌아갑니다. 다중 worktree 저장소에서만 표시됩니다 |
Ctrl+B | 현재 git 분기의 세션으로 필터링합니다. 다시 누르면 모든 분기를 표시합니다 |
Esc | 세션 선택기 또는 검색 모드를 종료합니다 |
Ctrl+A로 모든 프로젝트로 확장한 후 프로젝트 경로가 나타납니다.
/branch, /rewind 또는 --fork-session으로 생성된 분기된 세션은 루트 세션 아래에 그룹화됩니다. →를 눌러 그룹을 확장합니다.
세션 분기
분기는 지금까지의 대화 복사본을 만들고 이를 전환하여 원본은 그대로 유지합니다. 진행 중인 경로를 잃지 않고 다른 접근 방식을 시도하는 데 사용합니다.
세션 내에서 선택적 이름과 함께 /branch를 실행합니다:
/branch try-streaming-approach
--continue 또는 --resume을 --fork-session과 결합합니다:
claude --continue --fork-session
/branch 확인은 두 개의 세션 ID를 인쇄합니다: 현재 있는 새 분기와 원본입니다. 원본으로 돌아가려면 해당 ID를 /resume에 전달하거나, 세션 선택기를 사용하거나, /resume <original-name>을 실행합니다. “이 세션에 대해 허용”으로 승인한 권한은 새 분기로 이월되지 않습니다. 분기 없이 두 터미널에서 같은 세션을 재개하면 두 터미널의 메시지가 하나의 대화 기록으로 인터리브됩니다.
단일 세션 내에서 체크포인트 기반 되감기는 체크포인팅을 참조합니다.
세션 내 컨텍스트 관리
이 명령은 세션을 떠나지 않고 컨텍스트 윈도우에 있는 내용을 제어합니다:
/clear: 빈 컨텍스트로 새로 시작합니다. 이전 대화는 저장되고 재개 가능합니다/compact [instructions]: 기록을 요약으로 바꾸고, 선택적으로 지정한 내용에 초점을 맞춥니다/context: 현재 컨텍스트를 소비하는 것을 표시합니다
압축이 CLAUDE.md, 기술, 규칙과 상호 작용하는 방식은 컨텍스트 윈도우 가이드를 참조합니다. 언제 지우기 대 압축을 사용할지에 대한 전략은 모범 사례를 참조합니다.
세션 데이터 내보내기 및 찾기
/export를 실행하여 현재 대화를 클립보드에 복사하거나 일반 텍스트 파일로 저장합니다. 메시지와 도구 출력은 읽을 수 있는 텍스트로 렌더링됩니다. 파일 이름을 전달하여 해당 파일에 직접 작성합니다.
대화 기록은 ~/.claude/projects/<project>/<session-id>.jsonl에 JSONL로 저장되며, 여기서 <project>는 작업 디렉토리 경로에서 파생됩니다. 각 줄은 메시지, 도구 사용 또는 메타데이터 항목에 대한 JSON 객체입니다. ~/.claude 이외의 위치에 세션을 저장하려면 CLAUDE_CONFIG_DIR을 설정합니다. 이 로컬 파일은 기본적으로 30일 후 제거됩니다. cleanupPeriodDays로 변경합니다.
대화 기록 쓰기를 완전히 억제하려면 CLAUDE_CODE_SKIP_PROMPT_HISTORY를 설정하거나, 비대화형 모드에서 --no-session-persistence를 사용합니다.
참고 항목
이 페이지들은 관련 세션 및 병렬 처리 메커니즘을 다룹니다:
