SpyBara
Go Premium

sessions.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 66 additions and 57 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Sun 4 23:58 Tue 6 23:59 Wed 7 23:59 Sat 10 23:01 Sat 17 23:57 Mon 19 23:58 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59 Mon 26 22:57 Tue 27 22:59 Fri 30 23:01

세션 관리

Claude Code 대화의 이름을 지정하고, 재개하고, 분기하고, 전환합니다. --continue, --resume, --from-pr, /resume 선택기, 세션 이름 지정, 대화 기록 내보내기 및 대화 기록 저장 위치를 다룹니다.

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

데스크톱 앱, claude.ai/code, VS Code 확장은 각각 자신의 세션 목록을 유지하며, 데스크톱 앱은 CLI 세션을 재개할 수도 있습니다. 이 페이지는 CLI를 다룹니다.

세션 재개

세션은 작업할 때 로컬 트랜스크립트 파일에 지속적으로 저장되므로 종료하거나 /clear를 실행한 후에 세션으로 돌아갈 수 있습니다. 다음 진입점을 사용합니다:

명령 기능
claude --continue 현재 디렉토리에서 가장 최근 세션을 다시 엽니다
claude --resume 세션 선택기를 엽니다
claude --resume <name> 지정된 이름의 세션을 직접 재개합니다
claude --resume <transcript-path> 해당 절대 경로의 .jsonl 트랜스크립트 파일에 저장된 세션을 재개합니다
claude --from-pr <number> 해당 풀 리퀘스트에 연결된 세션으로 필터링된 세션 선택기를 엽니다
/resume 활성 세션 내에서 다른 세션으로 전환합니다

실행 중인 백그라운드 세션 재개

claude --resume 또는 /resume으로 재개하는 대화가 여전히 실행 중인 백그라운드 세션에 속하면 Claude Code는 실행 중인 세션 자체를 엽니다. 명령줄에서 --bg를 사용하면 재개는 대신 백그라운드 디스패치로 수행됩니다. v2.1.285 이전에는 Claude Code가 거부하고 claude attach <id>로 세션을 열거나 먼저 claude stop <id>로 중지하도록 안내했습니다.

  • 셸에서: claude --resume <session>은 트랜스크립트 자체를 로드하는 대신 같은 터미널에서 해당 세션에 대해 claude attach를 실행합니다. claude --resume <session> "check the tests too"와 같이 명령줄에서 전달하는 프롬프트는 먼저 세션의 다음 턴으로 이동하고 Claude Code는 Sent your prompt to the background session (<id>); opening it…를 출력한 후 연결합니다. 터미널에서 입력한 claude -p --resume <session> "prompt"도 동일하게 작동하므로 -p는 해당 실행을 비대화형으로 유지하지 않습니다.

    Claude Code는 명령줄에 다음 중 하나가 있으면 세션을 열지 않습니다:

    • 파이프되거나 리디렉션된 입력 또는 출력
    • --permission-mode, --model 또는 --settings와 같이 세션을 구성하는 플래그
    • --output-format json 또는 --json-schema와 같이 출력을 읽는 플래그
    • --max-turns 또는 --max-budget-usd와 같이 실행을 제한하거나 되감기하는 플래그

    이 중 하나가 있거나 에이전트 보기가 꺼져 있으면 Claude Code는 아무것도 보내지 않고 상태 1로 종료하며 세션이 백그라운드에서 실행 중임을 출력하고 ID를 결정할 수 없을 때 claude agents에서 찾도록 지시하거나 claude attach <id> 명령을 출력합니다. 대신 대화의 복사본을 재개하려면 --fork-session을 추가합니다. 자신의 플래그가 적용된 자신의 세션에서 대화 자체를 계속하려면 claude stop <id>를 실행한 다음 명령을 반복합니다.

    / 또는 !로 시작하는 프롬프트는 전송되지 않으며 세션이 질문에 대한 답변을 기다리는 동안 어떤 프롬프트도 전송되지 않습니다. 두 경우 모두 Claude Code는 세션을 열지 않으며 메시지에는 Your prompt was not sent to it과 이유가 포함됩니다.

  • 세션 내에서: /resume은 현재 대화를 백그라운드로 이동하고 이 터미널을 실행 중인 세션에 연결하며 Opening "<title>", running in the background (<id>)를 출력합니다. 빈 프롬프트에서 ←를 눌러 에이전트 보기로 돌아가면 남긴 대화도 나열됩니다. 현재 대화가 백그라운드로 이동할 수 없으면(예: 이미 백그라운드 세션에 연결되어 있거나 세션 지속성이 꺼져 있음) /resume은 대신 실행할 claude attach 명령을 출력합니다.

재개된 세션이 복원하는 것

Claude Code가 트랜스크립트에서 대화를 로드할 때 재개된 세션은 대화와 함께 저장된 상태를 복원합니다:

  • 대화 기록: 메시지, 도구 호출 및 결과입니다. 세션이 압축된 경우 대화는 Conversation compacted 행에서 열립니다. Claude는 마지막 압축의 요약, 해당 압축이 요약하지 않고 남긴 메시지, 그리고 그 이후의 모든 메시지로 계속합니다. 마지막 압축이 요약한 메시지는 다시 로드되지 않습니다.
  • 중단된 도구 호출: 이전 프로세스가 종료될 때(예: 충돌) 여전히 실행 중이던 도구는 재개할 때 완료되거나 다시 실행되지 않습니다. CLAUDE_CODE_RESUME_INTERRUPTED_TURN이 설정되지 않은 경우, Claude는 결과가 기록되기 전에 중단된 것으로 표시된 호출을 보게 되며 다시 실행하기 전에 효과가 있었는지 확인하도록 지시받습니다.
  • 모델: 세션은 사용 중이던 모델에서 계속됩니다. 단, 모델 설정에 설명된 경우는 제외됩니다.
  • 에이전트: --agent 또는 agent 설정으로 시작된 세션은 해당 에이전트로 계속되며 도구 제한 및 모델을 유지합니다. 재개할 때 --agent를 전달하여 다른 에이전트를 선택합니다. 두 경우 모두 시스템 프롬프트는 재개된 대화의 시스템 프롬프트 플래그를 참조하세요. Claude Code는 두 위치에서 에이전트를 찾습니다: 세션의 원본 디렉토리(해당 워크스페이스를 신뢰한 경우) 및 재개하는 디렉토리이므로 프로젝트 범위 에이전트는 다른 디렉토리에서 재개할 때도 로드됩니다. Claude Code가 두 위치 모두에서 에이전트를 찾지 못하면 세션은 기본 도구로 재개되고 에이전트 이름을 지정하는 경고를 표시합니다.
  • 권한 모드: 터미널에서 claude --continue, claude --resume <session-id> 또는 이름이 한 세션과 일치할 때 -p 없이 claude --resume <name>으로 재개하면 Claude Code는 세션이 있던 권한 모드를 복원합니다. 단, 재개 시 권한 모드의 경우는 제외되며, 이는 세션 선택기, /resume 및 claude -p로 재개하는 경우도 포함합니다. --permission-mode 또는 --dangerously-skip-permissions를 전달하여 복원된 모드를 재정의합니다.
  • 활성 목표: 세션이 종료될 때 여전히 활성이던 목표는 이월됩니다. 해당 턴 수, 타이머 및 토큰 지출 기준선이 재설정됩니다.
  • 세션 범위 예약 작업: 만료되지 않은 작업이 복원됩니다. 백그라운드 Bash 및 모니터 작업은 복원되지 않습니다.
  • 백그라운드 작업: 백그라운드 서브에이전트, 백그라운드 Bash 명령 또는 이전 프로세스로 끝난 워크플로는 재개된 트랜스크립트에 완료되지 않았다는 메모로 표시됩니다. Claude Code는 이러한 메모에서 턴을 시작하지 않습니다. Claude는 다음 프롬프트와 함께 이를 읽습니다.

원본 시작의 모든 구성 플래그가 복원되는 것은 아닙니다. 세션이 --mcp-config, --settings, --plugin-dir, --fallback-model 또는 --add-dir로 추가된 디렉토리에 의존하는 경우 재개할 때 다시 전달합니다. 세션 중간에 /add-dir로 추가된 디렉토리도 복원되지 않지만 세션 선택기는 여전히 이를 사용하여 세션을 찾습니다. settings.json 및 settings.local.json과 같은 표준 설정 파일은 시작 시 다시 읽히므로 이들 파일에 있는 구성은 다시 전달할 필요가 없습니다. --system-prompt 및 --append-system-prompt는 재개된 대화의 시스템 프롬프트 플래그를 참조하세요.

재개 시 권한 모드

Claude Code가 재개된 세션을 시작하는 권한 모드는 재개 방식에 따라 달라집니다. 아래 경우는 Claude Code가 트랜스크립트에서 대화를 로드할 때 적용됩니다. 여전히 실행 중인 백그라운드 세션을 열 때는 해당 세션이 있는 권한 모드를 유지합니다.

  • 터미널: claude --continue, claude --resume <session-id> 또는 이름이 한 세션과 일치할 때 -p 없이 claude --resume <name>. Claude Code는 세션이 있던 권한 모드를 복원합니다. 단, 표의 경우는 제외됩니다. --permission-mode 또는 --dangerously-skip-permissions를 전달하여 복원된 모드를 재정의합니다.
  • 비대화형: claude -p --resume 또는 claude -p --continue. Claude Code는 새로운 claude -p 실행이 시작될 권한 모드로 실행을 시작합니다. 단, 플랜 모드에서 종료된 세션은 아래 조건에서 플랜 모드로 재개됩니다.
  • VS Code: 확장의 대화 패널입니다. 표는 플랜 모드에서 종료된 대화만 다룹니다. 나머지는 과거 대화 재개를 참조하세요.
  • 시작 시 세션 선택기: claude --resume 단독, claude --from-pr 또는 여러 세션과 일치하는 이름 중 어느 방법으로 열었든 세션 선택기에서 선택한 세션입니다. Claude Code는 동일한 명령줄에서 새 세션을 시작할 권한 모드로 세션을 시작합니다. 단, 플랜 모드에서 종료된 세션은 플랜 모드로 재개됩니다. --permission-mode, --dangerously-skip-permissions 또는 --fork-session을 전달하면 Claude Code는 플랜 모드를 복원하지 않습니다. 그 외의 저장된 권한 모드는 복원되지 않습니다.
  • 세션 내 /resume(인수 있음 또는 없음): 전환하는 대화는 현재 세션이 있는 권한 모드에서 계속됩니다. 단, 플랜 모드에서 종료된 대화는 --permission-mode 또는 --dangerously-skip-permissions로 Claude Code를 시작했더라도 플랜 모드로 재개됩니다. 해당 대화가 이번 Claude Code 실행에서 이미 열린 적이 있다면(예: 처음 시작한 대화나 /clear 또는 /resume으로 떠난 대화) 대신 현재 권한 모드에서 계속됩니다.

거부 규칙이 ExitPlanMode 도구를 제거하면 Claude가 승인을 위해 계획을 제시할 수 없으므로 Claude Code는 플랜 모드를 복원하지 않습니다. 세션은 동일한 명령줄에서 새 세션이 시작될 권한 모드로 시작됩니다. /resume을 사용하면 대화는 현재 권한 모드에서 계속됩니다.

비대화형 및 VS Code 경로에서 플랜 모드 복원은 Claude Code v2.1.246 이상이 필요합니다. 각 행은 세션이 종료된 권한 모드, 재개하는 터미널, 비대화형 및 VS Code 경로 중 어느 것인지, 그리고 Claude Code가 재개된 세션을 시작하는 권한 모드를 나타냅니다.

세션이 종료된 모드 재개 방식 재개 후 권한 모드
bypassPermissions 터미널 새 세션이 시작될 권한 모드입니다. 권한을 다시 우회하려면 시작 시 해당 플래그 중 하나 또는 사용자, --settings 또는 관리형 설정의 permissions.defaultMode: "bypassPermissions"로 활성화합니다
plan 터미널 플랜 모드입니다. --fork-session을 사용하면 새 세션이 시작될 권한 모드입니다
plan 터미널(거부 규칙이 ExitPlanMode를 제거하는 경우) 새 세션이 시작될 권한 모드입니다
auto 터미널 auto(계정이 여전히 자동 모드 요구 사항을 충족하는 경우에만)
Manual 터미널 새 세션이 기본 제공 기본값에서 자동 모드로 시작될 때 수동입니다. 설정 파일의 defaultMode가 적용되면 Claude Code는 재개된 세션을 해당 모드로 시작합니다
plan 비대화형(아래 조건에서) 플랜 모드
모든 모드 비대화형(다른 모든 경우) 새로운 claude -p 실행이 시작될 권한 모드입니다
plan VS Code 플랜 모드(VS Code 페이지의 예외 포함)
-p로 플랜 모드에서 재개

claude -p --resume 또는 claude -p --continue 실행은 다음 조건이 모두 충족될 때만 플랜 모드에서 재개됩니다:

  • --permission-prompt-tool을 전달하고 --permission-prompts none을 전달하지 않아서 Claude Code가 승인을 위해 계획을 제시할 수 있습니다
  • --permission-mode 또는 --dangerously-skip-permissions를 전달하지 않습니다
  • --fork-session을 전달하지 않습니다
  • 실행이 채널을 통해 시작되지 않습니다
  • 거부 규칙이 ExitPlanMode 도구를 제거하지 않습니다

"Resume this conversation?" 대화 상자

세션을 재개할 때 "Resume this conversation?" 대화 상자가 표시되면, 여기에 표시되는 추정치는 저장된 대화만으로 사용하게 될 5시간 사용 한도의 비율입니다. 이 추정치에는 이미 사용한 양이 포함되지 않습니다.

Pro 및 Max 플랜에서는 오랜 공백 후 또는 다른 모델에서 긴 대화를 재개할 때 이 대화 상자가 나타날 수 있습니다. 추정된 사용량은 Resume을 선택할 때가 아니라 그 후 첫 메시지를 보낼 때 발생합니다. 다음 작업에 저장된 대화가 여전히 필요한지에 따라 선택합니다:

  • Resume: 저장된 대화에서 계속 작업합니다.
  • Start a new conversation: 저장된 대화가 필요 없는 작업으로 전환합니다. 나중에 다시 열려면 프롬프트에서 /resume을 실행합니다. 이 추정치는 새 대화의 첫 메시지에는 적용되지 않습니다. 옵션에 Claude가 이 대화를 조회할 수 있다고 표시되면 새 대화에서도 이전 작업을 참조할 수 있습니다.

세션 선택기가 찾는 위치

Claude Code는 세션을 프로젝트 디렉토리별로 저장합니다. 기본적으로 세션 선택기는 다음을 표시합니다:

  • 현재 worktree의 세션(백그라운드 세션 포함, 목록에서 bg로 표시됨)
  • /add-dir로 현재 디렉토리를 추가한 다른 곳에서 시작된 세션

Ctrl+W를 사용하여 저장소의 모든 worktree로 확장하거나 Ctrl+A를 사용하여 이 머신의 모든 프로젝트로 확장합니다.

/loop, -p, Agent SDK 및 백그라운드 세션

첫 번째 프롬프트가 /loop 명령인 세션은 선택기에 나타나지 않으며 claude --continue도 이를 건너뜁니다. 대화 후반에 /loop를 실행해도 세션이 숨겨지지 않습니다.

Claude Code는 claude -p 또는 Agent SDK로 생성된 세션을 세션 선택기 및 claude --continue에서 제외합니다. 세션 ID를 claude --resume <session-id>에 전달하여 여전히 재개할 수 있습니다. claude -p --continue를 실행하면 Claude Code는 -p, SDK 및 /loop 세션을 포함합니다.

claude --continue는 완료된 백그라운드 세션을 열지만 여전히 실행 중인 세션은 열지 않습니다. 완료된 백그라운드 세션을 열려면 Claude Code v2.1.257 이상이 필요합니다. 가장 최근 대화가 백그라운드로 이동한 세션이고 여전히 그곳에서 실행 중인 경우 Claude Code는 Your most recent conversation is running in the background와 해당 세션의 ID로 종료됩니다. claude agents에서 세션에 연결하거나 claude --resume을 실행하여 다른 세션을 선택합니다.

다른 worktree 및 프로젝트의 세션

같은 저장소의 다른 worktree에서 세션을 선택하면 그 위치에서 재개됩니다. 세션의 자체 worktree가 더 이상 존재하지 않으면 Claude Code는 현재 디렉토리에서 재개합니다. 관련 없는 프로젝트에서 세션을 선택하면 Claude Code는 cd 및 재개 명령을 클립보드에 복사합니다. 해당 프로젝트의 디렉토리가 더 이상 존재하지 않으면 Claude Code는 실패할 cd 명령을 복사하는 대신 현재 디렉토리에서 세션을 재개합니다.

/cd로 세션을 이동하면 새 디렉토리의 프로젝트 스토리지로 재배치되므로 이후 해당 디렉토리의 선택기에 나타납니다.

세션 ID 또는 이름으로 재개

claude --resume <session-id>는 모든 디렉토리에서 실행할 수 있으므로 다른 곳에서 시작되었거나 /cd로 이동한 세션도 재개할 수 있습니다. Claude Code는 다음 순서로 ID를 찾습니다:

  1. 현재 프로젝트 디렉토리 및 해당 git worktree
  2. 이 머신의 다른 모든 프로젝트

교차 프로젝트 검색은 정확히 하나의 다른 프로젝트가 해당 ID에 대한 메시지가 있는 트랜스크립트를 보유할 때만 ID를 확인하므로, 손으로 복사한 중복이 있으면 Claude Code는 임의의 복사본을 재개하지 않고 찾을 수 없음을 보고합니다. 저장된 세션이 ID와 일치하지 않으면 Claude Code는 No conversation found with session ID: <session-id>를 보고합니다.

이름으로 재개하면 현재 저장소 및 해당 worktree 전체에서 확인됩니다. 두 형식 모두 정확한 일치를 찾고 다른 worktree에 있더라도 직접 재개합니다:

명령 정확한 일치 모호한 이름
claude --resume <name> 직접 재개 이름을 검색어로 미리 채운 세션 선택기를 엽니다
/resume <name> 직접 재개 오류를 보고합니다. 세션 선택기를 열려면 인수 없이 /resume를 실행합니다

세션 이름 지정

세션에 설명적인 이름을 지정하여 세션 선택기에서 찾을 수 있고 이름으로 재개할 수 있도록 합니다. 이는 여러 작업을 병렬로 진행할 때 가장 중요합니다.

시기 이름을 설정하는 방법
시작 시 claude -n auth-refactor
세션 중 /rename auth-refactor. 이름은 프롬프트 표시줄에도 나타납니다
세션 선택기에서 세션을 강조 표시하고 Ctrl+R을 누릅니다
계획 수락 시 플랜 모드에서 계획을 수락하면 이미 이름을 지정하지 않은 경우 계획 내용에 따라 세션에 생성된 제목을 부여합니다
claude.ai 또는 Claude 앱에서 Remote Control 세션의 이름을 변경합니다. Claude Code는 CLI에서 동일한 이름을 적용합니다. Claude Code v2.1.221 이상이 필요합니다
데스크톱 앱에서 데스크톱 앱에서 세션의 이름을 변경합니다

CLI 경로를 통해 또는 claude.ai에서 세션의 이름을 지정한 후 claude --resume <name> 또는 /resume <name>으로 돌아갑니다. 데스크톱 앱 세션은 데스크톱 앱에서 재개됩니다. worktree 전체에서 이름 확인이 어떻게 작동하는지는 세션 재개를 참조합니다.

이름을 지정하지 않은 세션도 Claude Code가 할당하는 두 가지 레이블을 받습니다. 생성된 제목만 재개 핸들로 작동합니다:

  • 기본 표시 이름: 이름을 지정하지 않은 대화형 세션도 시작할 때 기본 표시 이름을 받습니다. 기본값은 작업 디렉터리의 이름과 두 문자 접미사를 결합합니다(예: my-app-3f). 이는 에이전트 보기 및 claude agents --json 출력과 같은 실행 중인 세션의 목록에서 세션을 식별합니다. 기본값은 재개 핸들이 아닙니다. claude --resume 또는 /resume에 전달하면 Claude Code는 세션을 찾지 못합니다.

  • 생성된 제목: 세션의 이름을 지정하지 않으면 Claude Code는 세션 제목을 생성합니다. 제목은 첫 번째 프롬프트의 짧은 요약으로, 일반적으로 Haiku 클래스 모델인 소형/빠른 모델에 대한 백그라운드 요청으로 작성됩니다. 셸이나 스크립트에서 직접 시작한 claude -p 실행은 제목을 받지 않습니다.

    계획을 수락하면 생성된 제목이 계획 기반 제목으로 바뀝니다. 두 제목 중 하나를 claude --resume 또는 /resume에 전달할 수 있으며, Claude Code는 설정한 이름과 동일한 방식으로 확인합니다.

세션 선택기 사용

세션 내에서 /resume을 실행하거나 인수 없이 claude --resume을 실행하여 대화형 세션 선택기를 엽니다. 다음 키보드 단축키를 사용하여 탐색, 검색 및 목록 확장:

단축키 작업
↑ / ↓ 또는 k / j 세션 간 탐색
→ / ← 그룹화된 세션 확장 또는 축소
Enter 강조 표시된 세션 재개
1부터 9까지 목록에서 해당 위치의 세션 재개
Space 세션 내용 미리보기. 터미널이 붙여넣기로 캡처하지 않는 경우 Ctrl+V도 작동합니다
Ctrl+R 강조 표시된 세션 이름 바꾸기
/ 또는 Space, j, k, 숫자 이외의 인쇄 가능한 문자 검색 모드를 입력하고 세션을 필터링합니다. GitHub, GitHub Enterprise, GitLab 또는 Bitbucket 풀 또는 병합 요청 URL을 붙여넣어 이를 생성한 세션을 찾습니다
Ctrl+A 이 머신의 모든 프로젝트에서 세션을 표시합니다. 다시 누르면 현재 저장소로 돌아갑니다
Ctrl+W 현재 저장소의 모든 worktree에서 세션을 표시합니다. 다시 누르면 현재 worktree로 돌아갑니다. 다중 worktree 저장소에서만 표시됩니다
Ctrl+B 현재 git 분기의 세션으로 필터링합니다. 다시 누르면 모든 분기를 표시합니다
Esc 세션 선택기 또는 검색 모드를 종료합니다

각 행은 설정된 경우 세션 이름을 표시하고, 그렇지 않으면 AI 생성 세션 제목, 대화 요약 또는 첫 번째 프롬프트와 마지막 활동 이후 경과 시간, git 브랜치 및 파일 크기를 표시합니다.

/branch 또는 --fork-session으로 생성된 세션은 자신의 세션 ID를 가지며 별도의 행으로 나타납니다. 선택기가 동일한 세션에 대해 둘 이상의 항목을 찾으면 단일 행 아래에 그룹화됩니다. →를 눌러 그룹을 확장합니다.

Claude Code가 claude --resume 선택기에서 선택한 세션을 로드할 수 없으면 Failed to resume the conversation 메시지를 인쇄하고 재시도 명령을 표시한 후 코드 1로 종료됩니다. 세션 내의 /resume 선택기에서 Claude Code는 실패를 보고하고 현재 대화는 계속 실행됩니다.

세션 분기하기

분기하면 지금까지의 대화 사본이 만들어지고 해당 사본으로 전환되며, 원본은 그대로 유지됩니다. 진행 중이던 흐름을 잃지 않고 다른 접근 방식을 시도할 때 사용합니다.

세션 내에서 선택적으로 이름을 지정하여 /branch를 실행합니다.

/branch try-streaming-approach

이름을 생략하면 Claude Code가 대화의 첫 번째 프롬프트를 기준으로 새 분기의 이름을 지정합니다.

명령줄에서는 --continue 또는 --resume을 --fork-session과 함께 사용합니다.

claude --continue --fork-session

/branch 확인 메시지에는 두 개의 세션 ID가 출력됩니다. 하나는 현재 전환된 새 분기의 ID이고, 다른 하나는 원본의 ID입니다. 원본은 디스크에 변경 없이 남아 있으며 세션 선택기에도 계속 표시됩니다. /resume <original-name>을 실행하거나 해당 ID를 /resume에 전달하여 원본으로 돌아갈 수 있습니다.

/branch는 트랜스크립트를 복사하고, 실행 중인 Claude Code 프로세스가 복사된 트랜스크립트에 기록하도록 전환합니다. 이 차이에 따라 분기가 무엇을 이어받는지가 결정됩니다.

상태 /branch 이후
대화 기록 /branch를 실행한 시점까지의 내용이 분기에 복사됩니다
"이 세션에 대해 허용" 권한 부여 그대로 이어집니다. 분기는 동일한 프로세스에서 실행되므로 기존 권한 부여가 계속 적용됩니다. --fork-session으로 별도 프로세스에 분기하면 새 프로세스는 기존 권한 부여가 없는 상태로 시작되므로 해당 프로세스에서 다시 승인해야 합니다
실행 중인 백그라운드 서브에이전트 및 백그라운드 Bash 명령 계속 실행됩니다. 출력은 원래 세션이 아니라 전환된 새 분기에 표시됩니다
Remote Control 연결 연결이 유지됩니다. 세션에 연결된 휴대폰이나 브라우저가 분기로 함께 전환되어 해당 분기에서 새 메시지를 계속 수신합니다

분기하지 않고 두 터미널에서 같은 세션을 재개하면 양쪽의 메시지가 하나의 트랜스크립트에 뒤섞여 기록됩니다. 단일 세션 내에서 체크포인트 기반으로 되감으려면 체크포인트를 참조하세요.

세션 내 컨텍스트 관리

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

  • /clear: 빈 컨텍스트로 새로 시작합니다. Claude Code는 이전 세션을 저장하며, /resume으로 재개하거나, 동일한 Claude Code 프로세스에서 되감기 메뉴의 이전 세션 항목에서 재개할 수 있습니다. 인수가 없으면 새 세션은 --name 또는 /rename으로 설정한 이름을 유지하지만 AI가 생성한 세션 제목은 유지하지 않습니다. 대신 떠나는 세션의 이름을 지정하려면 /clear release-prep처럼 이름을 전달하면 새 세션이 이름 없이 시작됩니다
  • /compact [instructions]: 기록을 요약으로 바꾸고, 선택적으로 지정한 내용에 초점을 맞춥니다
  • /context: 현재 컨텍스트를 소비하는 것을 표시합니다

압축이 CLAUDE.md, 기술, 규칙과 상호 작용하는 방식은 컨텍스트 윈도우 가이드를 참조합니다. 언제 지우기 대 압축을 사용할지에 대한 전략은 모범 사례를 참조합니다.

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

/export를 실행하여 현재 대화를 클립보드에 복사하거나 일반 텍스트 파일로 저장합니다. 메시지와 도구 출력은 읽을 수 있는 텍스트로 렌더링됩니다. 파일 이름을 전달하여 메뉴를 건너뛰고 해당 파일에 직접 작성합니다.

스크립트에서 대화 기록 접근

/export는 사람이 읽을 수 있도록 렌더링된 기록을 생성합니다. 아래 인터페이스는 스크립트가 파싱할 수 있는 구조화된 데이터를 생성합니다. 실행 결과의 JSON, 세션의 기록 파일 경로, 또는 이벤트의 라이브 스트림입니다. 스크립트를 트리거하는 것에 따라 선택합니다:

  • Claude를 한 번 실행하고 결과 캡처: --output-format json 또는 stream-json과 함께 claude -p를 호출하여 비대화형 실행의 결과, 세션 ID, 사용량 및 비용을 구조화된 JSON으로 캡처합니다.
  • 기존 세션에 질문하기: 세션 ID를 claude -p --resume에 전달하여 요약 요청과 같은 후속 프롬프트를 보내고 구조화된 응답을 캡처합니다.
  • 세션 이벤트에 반응: hooks 및 상태 줄 명령이 입력으로 받는 transcript_path 필드를 읽습니다. SessionEnd hook은 세션이 끝날 때 기록을 보관할 수 있습니다.
  • TypeScript 또는 Python 앱에 Claude 포함: Agent SDK를 사용하여 각 메시지를 프로그래밍 방식으로 수신합니다.

아래 예제는 두 번째 인터페이스를 사용합니다. 기존 세션에 후속 프롬프트를 보내고 jq로 답변을 읽습니다:

claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'

기록이 저장되는 위치

기본적으로 Claude Code는 기록을 ~/.claude/projects/<project>/<session-id>.jsonl에 JSONL로 저장합니다. 여기서 <project>는 작업 디렉토리 경로에서 파생되고 영숫자가 아닌 문자는 -로 대체됩니다. 변환된 이름이 200자를 초과하는 작업 디렉토리의 경우 Claude Code는 이름을 200자로 자르고 전체 경로의 해시를 추가하므로 디렉토리 이름이 파일 시스템 제한 내에 유지됩니다.

각 줄은 메시지, 도구 사용 또는 메타데이터 항목에 대한 JSON 객체입니다. 항목 형식은 Claude Code 내부 형식이며 버전 간에 변경되므로 이러한 파일을 직접 파싱하는 스크립트는 모든 릴리스에서 손상될 수 있습니다. 세션 데이터를 기반으로 구축하려면 /export 또는 스크립트 인터페이스 대신 사용합니다.

위치, 보존 및 쓰기 동작은 구성 가능합니다:

대상 설정 위치
~/.claude 외부로 저장소 이동 CLAUDE_CONFIG_DIR 환경 변수
<project> 디렉토리 이름 직접 지정 CLAUDE_CODE_PROJECT_DIR_NAME 환경 변수
30일 보존 기간 변경 cleanupPeriodDays settings.json
Claude Desktop 및 Cowork 기록에 대한 나이 제한 설정 desktopSessionCleanupPeriodDays 사용자 설정, 관리 설정 또는 --settings
-p 또는 Agent SDK 세션의 트랜스크립트 파일 크기 증가 제한 CLAUDE_CODE_TRANSCRIPT_LOCAL_GC 환경 변수
모든 모드에서 기록 쓰기 억제 CLAUDE_CODE_SKIP_PROMPT_HISTORY 환경 변수
한 번의 비대화형 실행에 대해 쓰기 억제 --no-session-persistence claude -p와 함께 CLI 플래그

세션 데이터 삭제

트랜스크립트는 보존 정리 규칙에 따라 만료됩니다. 프로젝트의 트랜스크립트 및 관련 상태를 더 빨리 삭제하려면 claude purge를 실행합니다. claude rm <id>로 백그라운드 세션을 삭제하면 해당 트랜스크립트는 디스크에 남아 있으며 claude --resume을 통해 계속 사용할 수 있습니다.

프로젝트 디렉토리 이름 직접 지정

기본적으로 Claude Code는 전체 작업 디렉토리 경로에서 <project> 이름을 파생합니다. 이름을 직접 선택하려면 CLAUDE_CONFIG_DIR과 함께 CLAUDE_CODE_PROJECT_DIR_NAME을 설정합니다. Claude Code는 해당 세션의 기록 및 자동 메모리를 사용자 이름 아래에 저장합니다. 이는 Claude Code를 포함하고 각 세션에 자체 구성 디렉토리를 제공하는 호스트에 적합합니다. Claude Code v2.1.234 이상이 필요합니다.

예를 들어 이 시작은 테넌트 A의 데이터를 /srv/tenant-a 아래에 유지하고 프로젝트 디렉토리 이름을 work로 지정합니다:

CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude

Claude Code는 세션의 기록을 /srv/tenant-a/projects/work/에 쓰고 자동 메모리를 /srv/tenant-a/projects/work/memory/에 쓰며, 작업 디렉토리가 무엇이든 상관없습니다.

설정할 때 세 가지 규칙이 적용됩니다:

  • CLAUDE_CONFIG_DIR도 설정: 이름이 작업 디렉토리에 따라 변하지 않으므로 기본 ~/.claude 아래에서는 모든 프로젝트의 기록 및 자동 메모리를 하나의 디렉토리로 병합합니다. Claude Code는 CLAUDE_CONFIG_DIR이 설정되지 않으면 CLAUDE_CODE_PROJECT_DIR_NAME을 무시합니다.
  • 1-64자의 문자, 숫자, 하이픈 또는 밑줄 사용: con과 같은 Windows 장치 이름을 사용하지 마십시오. Claude Code는 다른 값을 무시하고 파생된 이름을 사용합니다.
  • claude를 시작하는 셸 환경에서 설정: Claude Code는 시작 시 해당 환경에서 한 번만 읽으므로 설정 파일의 env 블록은 설정할 수 없습니다.

구성 디렉토리의 프로젝트 디렉토리 이름을 지정한 후에는 해당 이름으로 계속 시작합니다. 동일한 CLAUDE_CONFIG_DIR으로 Claude Code를 시작하지만 CLAUDE_CODE_PROJECT_DIR_NAME 없이 시작하면 파생된 디렉토리를 다시 읽고 씁니다. 사용자 이름 아래에 저장된 세션은 디스크에 남아 있습니다. 세션 선택기에서 Ctrl+A를 누르면 해당 구성 디렉토리 아래의 모든 프로젝트 디렉토리(고정된 디렉토리 포함)의 세션을 나열하고, 어떤 방식으로 시작하든 claude --resume <session-id>는 두 이름 중 하나로 저장된 세션을 찾습니다.

참고 항목

이 페이지들은 관련 세션 및 병렬 처리 메커니즘을 다룹니다: