Cmd. /recap
현재 세션의 한 줄 요약을 즉시 생성해 오랜 세션 복귀 비용을 줄이는 명령
핵심 요약
/recap은 현재 세션의 한 줄 요약을 필요할 때 바로 만들어, 오랜 세션에 돌아왔을 때 무엇을 하던 중이었는지 빠르게 되짚게 해 준다.- 자동 세션 요약(Session recap) 기능을 수동으로 바로 부르는 진입점이고, 인자나 별칭은 없다.
- 자동 요약은 마지막 응답 후 최소 3분 경과·터미널 비활성·최소 3턴 조건에서만 백그라운드로 생성되고, 비대화형 모드에서는 항상 건너뛴다.
- 자동 요약이 거슬리면
/config의 Session recap 항목을 꺼도/recap수동 호출은 그대로 쓸 수 있다. - 세션 상태 요약일 뿐 장기 기록 수단은 아니므로, 중요한 결정·TODO는 메모리나 문서에 따로 남긴다.
명령어 원본 선언
/recap공식 설명 요약
공식 문서의 설명은 다음과 같습니다.
Generate a one-line summary of the current session on demand. See Session recap for the automatic recap that appears after you've been away.
/recap은 현재 세션의 한 줄 요약을 필요할 때 바로 만드는 명령입니다.
오랜 세션에 다시 돌아왔을 때 무엇을 하던 중이었는지 빠르게 되짚기 좋습니다.
Claude Code의 자동 세션 요약(Session recap) 기능과 짝을 이룹니다. 자동 세션 요약은 자리를 비웠다가 터미널로 돌아오면 지금까지의 진행 상황을 한 줄로 보여 줍니다. 동작 조건은 다음과 같습니다.
- 마지막 응답이 끝난 뒤 최소 3분이 지나고 터미널이 비활성(unfocused) 상태일 때 백그라운드에서 미리 생성됩니다.
- 세션에 최소 3턴 이상 대화가 쌓여야 표시되며, 연속해서 두 번 나타나지는 않습니다.
- 모든 플랜과 프로바이더에서 기본으로 켜져 있고, 비대화형(non-interactive) 모드에서는 항상 건너뜁니다.
/recap은 이 자동 요약을 수동으로 바로 부르는 진입점이라고 보면 됩니다.
최소 지원 버전
- 공식 명령어 레퍼런스에는
/recap에 대한 별도의 최소 버전 표기가 없습니다(현재 일반 명령으로 안내됨). - 자동 세션 요약(Session recap)은 모든 플랜·프로바이더에서 기본 활성화되어 있습니다.
사용법
/recap- 인자(arguments)를 받지 않습니다. 입력 시작에
/recap만 입력하면 됩니다. - 별칭(alias)은 별도로 제공되지 않습니다.
좋은 사용 예
- 점심 이후 세션에 복귀하기 전 현재 상태를 한 줄로 다시 정리
/compact직후 핵심 진행 상태가 제대로 남았는지 확인- 긴 세션의 handoff 메모 초안 만들기
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/recap | 한 줄 현재 상태 요약 | 복귀 비용 최소화 목적 |
/compact | 대화 자체를 압축 | 컨텍스트 절감 목적 |
/resume | 이전 세션으로 이동 | 다른 세션 자체를 재개할 때 |
/rename | 세션 이름 부여 | 여러 세션을 구분·식별할 때 |
활용 사례
- 장기 리팩터링 세션의 상태 체크포인트
- 팀원이 대신 이어받기 전 최소 상태 설명 생성
- 자리를 비웠다가 돌아왔을 때 자동 요약을 기다리지 않고 즉시 호출
주의사항
/recap은 세션 상태 요약이지 장기 기록 보관 수단이 아닙니다.- 중요한 결정, TODO, 운영 규칙은 메모리나 문서에 따로 남겨야 합니다.
- 자동 세션 요약이 거슬린다면
/config를 열어 Session recap 항목을 꺼서 비활성화할 수 있습니다(/recap수동 호출은 그대로 사용 가능). - 자동 요약은 최소 3턴 이상, 마지막 턴 종료 후 3분 경과 + 터미널 비활성 조건에서만 생성되므로, 막 시작한 짧은 세션에서는 자동으로 나타나지 않을 수 있습니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Interactive mode — Session recap: https://code.claude.com/docs/en/interactive-mode#session-recap