Cmd. /resume
ID·이름으로 이전 대화를 재개하거나 세션 피커를 열어 작업 맥락을 복원하는 명령
핵심 요약
/resume은 ID나 이름으로 이전 대화를 곧바로 재개하고, 인자 없이 실행하면 세션 피커를 열어 작업 맥락을 복원한다.- 별칭
/continue는 완전히 동일하게 동작하며, CLI에서는claude --continue(최근 대화)·claude --resume(피커)로 진입한다. - v2.1.144부터 백그라운드 세션이 피커에
bg표식으로 함께 나타나 전면으로 가져올 수 있다. /clear로 새 대화를 시작해도 이전 대화는 피커에 남으며,/clear [name]으로 라벨링하면 그 이름으로 표시된다.- 재개 직후
/status로 환경·권한을 점검하고, 오래된 세션은/compact로 컨텍스트를 정리한 뒤 진행하자.
명령어 원본 선언
/resume [session]session 인자는 선택 사항입니다. 세션 ID나 이름을 넘기면 해당 대화를 곧바로 재개하고, 인자를 생략하면 세션 피커가 열립니다.
공식 설명 요약
공식 문서의 정의는 다음과 같습니다.
Resume a conversation by ID or name, or open the session picker. As of v2.1.144, background sessions appear in the picker marked with
bg. Alias:/continue.
/resume은 ID 또는 이름으로 이전 대화를 재개하거나, 인자 없이 실행하면 세션 피커(picker)를 여는 명령입니다. 중단했던 작업을 그 시점의 맥락 그대로 이어 받아 컨텍스트 손실을 줄여 줍니다.
- 별칭(Alias):
/continue— 둘은 완전히 동일하게 동작합니다. - 백그라운드 세션 표시: v2.1.144부터 백그라운드 세션도 피커 목록에 함께 나타나며,
bg표식으로 구분됩니다. /clear로 새 대화를 시작해도 이전 대화는/resume피커에 그대로 남습니다./clear [name]처럼 이름을 붙이면 피커에서 그 이름으로 라벨링됩니다./branch(별칭/fork)로 만든 분기에서 원래 대화로 돌아올 때도/resume을 사용합니다.
최소 지원 버전
- 공식 문서는 명령 도입 버전을 밝히지 않습니다. 다만 v2.1.144부터 백그라운드 세션이 피커에
bg표식으로 나타나는 동작이 추가됐다고 적혀 있습니다. - 그 외 동작 변경 이력은 Changelog 기준이며, 아래 주의사항에 정리했습니다.
사용법
# 세션 피커 열기 (인자 없음)
/resume
# 세션 ID 또는 이름으로 직접 재개
/resume <session>
# 별칭도 동일하게 동작
/continueCLI 진입 시점에서 이어 받으려면 플래그를 사용할 수도 있습니다.
# 가장 최근 대화를 곧바로 이어서 시작
claude --continue
# 피커에서 선택해 재개
claude --resume
/add-dir로 추가한 작업 디렉터리에서도--continue또는--resume플래그로 세션을 다시 이어 받을 수 있습니다.
좋은 사용 예
- 어제 작업한 기능 브랜치 맥락을 그대로 복원
- 긴급 이슈 대응 후 본작업으로 복귀
- 다중 세션 운영 시 ID나 이름으로 특정 흐름만 재연결
/clear [name]으로 라벨링해 둔 대화를 피커에서 골라 재개bg표식이 붙은 백그라운드 세션을 피커에서 골라 전면으로 가져오기
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/resume (/continue) | ID·이름으로 이전 대화 재개 | 작업 연속성 확보 |
/branch (/fork) | 현재 대화를 분기, 원본은 보존 | 안전하게 다른 길 탐색 |
/clear (/reset, /new) | 빈 컨텍스트로 새 대화 시작 | 새 흐름 시작 |
/teleport (/tp) | 웹 세션을 현재 터미널로 가져오기 | 웹 작업을 로컬에서 이어가기 |
/memory | 장기 정보 유지 | 반복 규칙/지식 축적 |
활용 사례
- 주간 단위 태스크 트래킹: 같은 작업 대화를 매일
/resume으로 이어 받기 - 장애 대응 세션 재개 및 히스토리 추적
- 백그라운드 에이전트로 돌려둔 장기 작업을
bg세션 피커에서 골라 점검
주의사항
- 재개 직후
/status로 환경·권한 상태를 먼저 점검하세요. - 오래된 세션은
/compact로 컨텍스트를 정리하거나 목표를 다시 추린 뒤 진행하세요. - 백그라운드 세션은 v2.1.144부터 피커에
bg표식으로 함께 나타납니다. - v2.1.69에서 세션 식별 시 첫 번째 프롬프트 대신 가장 최근 프롬프트를 표시하도록 변경되었고,
(session)타이틀 표시 문제도 함께 해결되었습니다. - v2.1.73에서 현재 활성 세션이 picker 목록에 표시되지 않도록 수정되었습니다.
- v2.1.77에서
--resume로딩 속도가 최대 45% 빨라지고 피크 메모리가 약 100–150MB 절감되었습니다. - v2.1.81에서 worktree 세션 재개 시 해당 worktree로 자동 전환됩니다.
출처
- Claude Code Docs — Commands: https://code.claude.com/docs/en/commands
- Claude Code Docs — Background agents (Agent view): https://code.claude.com/docs/en/agent-view
- Changelog: https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md