Cmd. /recap
현재 세션의 한 줄 요약을 즉시 생성해 오랜 세션 복귀 비용을 줄이는 명령
핵심 요약
- 현재 session 한 줄 요약
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
현재 session 한 줄 요약
/recap사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-10-23 · Claude Code 2.1.308 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/recap- 인자(arguments)를 받지 않습니다. 입력 시작에
/recap만 입력하면 됩니다. - 별칭(alias)은 별도로 제공되지 않습니다.
선택 시점
- 점심 이후 세션에 복귀하기 전 현재 상태를 한 줄로 다시 정리
/compact직후 핵심 진행 상태가 제대로 남았는지 확인- 긴 세션의 handoff 메모 초안 만들기
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/recap | 한 줄 현재 상태 요약 | 복귀 비용 최소화 목적 |
/compact | 대화 자체를 압축 | 컨텍스트 절감 목적 |
/resume | 이전 세션으로 이동 | 다른 세션 자체를 재개할 때 |
/rename | 세션 이름 부여 | 여러 세션을 구분·식별할 때 |
실행 결과와 유지 범위
현재 대화를 짧게 요약해 보여 줍니다. 컨텍스트를 압축하는 compact와 목적이 다릅니다.
공식 문서의 설명은 다음과 같습니다.
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은 세션 상태 요약이지 장기 기록 보관 수단이 아닙니다.- 중요한 결정, TODO, 운영 규칙은 메모리나 문서에 따로 남겨야 합니다.
- 자동 세션 요약이 거슬린다면
/config를 열어 Session recap 항목을 꺼서 비활성화할 수 있습니다(/recap수동 호출은 그대로 사용 가능). - 자동 요약은 최소 3턴 이상, 마지막 턴 종료 후 3분 경과 + 터미널 비활성 조건에서만 생성되므로, 막 시작한 짧은 세션에서는 자동으로 나타나지 않을 수 있습니다.
- v2.1.284부터 채팅 thread(본인 것 포함)·routine·webhook을 거쳐 전달된
/recap은 짧은 안내와 함께 거절됩니다. 터미널·Claude 앱·Remote Control·-p·SDK host에서 직접 입력하면 이전처럼 실행됩니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록