Claude Code Docs 해체 분석 (3): 세션 관리

Claude 공식 문서(sessions) 내용을 간략히 요약한다.

세션은 프로젝트 디렉토리에 연결된 저장된 대화.
Claude Code는 작업할 때 로컬에 저장하므로 중단한 지점부터 재개하거나, 다른 접근 방식을 시도하기 위해 분기하거나, 작업 간에 전환할 수 있다.

데스크톱 앱, 웹 Claude Code, VS Code 확장, CLI는 모두 각각 자신의 세션 기록을 유지한다.
또한 세션은 프로젝트 디렉토리별로 저장된다.

세션 재개

명령	기능
claude --continue	현재 디렉토리에서 가장 최근 세션 재개
claude --resume	‘세션 선택기’를 확인
claude --resume <name>	‘세션 선택기’를 확인
/resume	활성 세션 내에서 ‘세션 선택기’를 확인 및 전환

세션 이름 지정

시기	이름 설정 방법
시작 시	claude -n <name>
세션 중	/rename <name>

세션 분기 및 컨텍스트 관리

분기는 지금까지의 대화 복사본을 만들고 이를 전환하여 원본은 그대로 유지합니다.
진행 중인 경로를 잃지 않고 다른 접근 방식을 시도하는 데 사용합니다.

세션 내에서 선택적 이름과 함께 /branch를 실행:

/branch try-streaming-approach

명령줄에서 –continue 또는 –resume을 –fork-session과 결합:

claude --continue --fork-session

세션을 떠나지 않고 컨텍스트 윈도우에 있는 내용을 제어하는 명령어:

명령어	동작
/clear	빈 컨텍스트로 새로 시작. 이전 대화는 저장되고 재개
/compact [instructions]	기록을 요약으로 바꾸고, 선택적으로 지정한 내용에 초점을 맞춘다
/compact	현재 컨텍스트를 소비하는 것을 표시

instructions은 자연어 작성을 뜻함.

세션 데이터 내보내기 및 찾기

/export를 실행하여 현재 대화를 클립보드에 복사하거나 일반 텍스트 파일로 저장.
대화 기록은 ~/.claude/projects//.jsonl에 JSONL로 저장되며, 여기서는 작업 디렉토리 경로에서 파생된다. 각 줄은 메시지, 도구 사용 또는 메타데이터 항목에 대한 JSON 객체.