Claude Code의 Session Recap이란 무엇인가요? 자리를 비운 후 표시되는 시점과 대화 내용이 유지되는 이유 (2026)

Anthropic의 대화형 모드(interactive-mode) 문서는 이를 다음과 같이 설명합니다: "자리를 비웠다가 터미널로 돌아오면, Claude Code는 지금까지 세션에서 발생한 일에 대한 한 줄 요약을 보여줍니다."

명령어 참조 문서에는 수동 버전이 나열되어 있습니다: /recap은 "요청 시 현재 세션의 한 줄 요약을 생성합니다."

두 기능 모두 상황 파악을 위한 용도입니다. 휴식 후 스크롤을 올리지 않고도 작업 흐름을 다시 파악할 수 있게 도와줍니다. 이는 세션의 영구적인 기록은 아닙니다.

문서에는 다음과 같은 특정 조건이 명시되어 있습니다:

• 시간 및 포커스. "마지막 턴이 완료된 후 최소 3분이 지났고 터미널 포커스가 해제된 상태에서 백그라운드에서 Recap이 생성되므로, 다시 돌아왔을 때 바로 확인할 수 있습니다."
• 충분한 대화. "Recap은 세션에 최소 3개 이상의 턴이 있을 때만 나타나며, 연속으로 두 번 나타나지 않습니다."
• 대화형 세션 전용. "자동 Recap은 비대화형(non-interactive) 모드에서는 나타나지 않습니다." 즉, claude -p 실행 시에는 표시되지 않습니다.

따라서 짧은 세션이거나, 터미널을 떠나지 않았거나, 새로운 턴 없이 두 번 연속으로 자리를 비운 경우에는 Recap이 생성되지 않습니다. 이러한 조건들이 일부 상황에서만 Recap이 보이는 이유를 설명해 줍니다.

에이전트 뷰(Agent view)에서의 동작

백그라운드 세션도 이와 관련된 동작을 보입니다. Anthropic의 에이전트 뷰 가이드에 따르면, 백그라운드 세션에 다시 연결할 때 "Claude는 자리를 비운 동안 발생한 일에 대한 짧은 Recap을 게시합니다." Claude Code 에이전트 뷰 가이드에서 이러한 세션이 어떻게 실행되는지 자세히 설명합니다.

/recap은 요청 시 동일한 종류의 요약을 생성합니다. 두 형태 모두에 두 가지 제한 사항이 적용됩니다.

길이. "Claude Code는 자동 Recap과 /recap 출력 모두 400자로 제한합니다." Recap은 상태 보고서가 아니라 한두 문장 정도의 짧은 요약입니다. 변경 로그에 따르면 이 제한은 "단어 경계"에서 끊깁니다.

실행 권한. "사용자가 직접 요청할 때만 실행됩니다." 오류 참조 문서에 따르면, Slack, Teams 또는 프로젝트 스레드에서 전달된 메시지나 클라우드 예약 작업 또는 다른 프로그램이 보낸 프롬프트에서 /recap이 실행되면 요약 대신 안내 메시지가 표시됩니다. Anthropic이 나열한 실행 가능 장소는 "터미널, Claude 앱 또는 claude.ai/code, 또는 원격 제어(Remote Control)"입니다. 또한 문서에는 "claude -p에 전달하는 /recap이나 자체 에이전트 SDK 애플리케이션이 시작한 세션에 보내는 /recap은 사용자의 직접 입력으로 간주됩니다."

만약 /recap이 직접 요청할 때만 실행된다는 메시지가 표시된다면, Anthropic은 세션을 열어 직접 명령어를 실행하거나 예약 작업/프로그램이 보내는 프롬프트에서 /recap을 제거할 것을 권장합니다.

이것이 Recap의 가장 유용한 점이며 프롬프트 캐싱 가이드에도 명시되어 있습니다: "/compact와 달리, 메시지 기록을 대체하는 대신 요약을 명령 출력으로 추가하므로 캐시된 접두사가 그대로 유지됩니다."

이로 인해 두 가지 결과가 나타납니다.

요약되어 사라지는 내용이 없습니다. Compaction은 이전 턴을 요약으로 대체하므로 일부 세부 정보가 손실될 수 있습니다. 반면 Recap은 아무것도 대체하지 않으므로 이전의 모든 메시지가 대화에 그대로 남아 있습니다.

캐시가 방해받지 않습니다. 기록이 다시 작성되지 않기 때문에 이후 요청의 효율성을 유지하는 캐시된 접두사가 여전히 유효합니다.

Claude Code가 만드는 모든 요약이 이와 같은 것은 아닙니다. 별도의 기능인 유휴 상태 compaction(Idle compaction)은 자리를 비운 동안 세션을 압축할 수 있습니다. Anthropic의 설정 참조 문서에 따르면, 이 기능이 실행된 후 "다음 메시지는 전체 대화 대신 요약을 보냅니다." Anthropic의 비용 가이드에서는 두 기능을 함께 언급합니다: "Session recap과 유휴 상태 compaction은 유휴 상태일 때 토큰을 사용할 수 있습니다." 세션으로 돌아왔을 때 Recap과 compaction에 대한 메모가 모두 보인다면, 두 기능이 각각 다른 작업을 수행한 것입니다.

Claude Code에는 세션을 변경하지 않고 상태를 보여주는 몇 가지 명령어와 세션을 변경하는 몇 가지 명령어가 있습니다.

• /recap. 출력으로 추가되는 한 줄 요약입니다. 대화 내용은 그대로 유지됩니다.
• /context. 컨텍스트 창을 채우고 있는 내용의 분석입니다. 우리 가이드의 /context 명령어에서 읽는 방법을 설명합니다.
• /btw. 대화 흐름에 포함되지 않는 별도의 질문입니다. /btw 가이드에서 별도 질문이 참조할 수 있는 범위를 다룹니다.
• /compact. 이전 턴을 요약으로 대체합니다.
• /clear. 새로운 대화를 시작합니다. /clear 가이드에서 무엇이 유지되는지 다룹니다.

처음 세 개는 현재 상황을 이해하는 데 도움을 줍니다. 마지막 두 개는 Claude가 작업하는 기반을 변경합니다. Recap은 첫 번째 그룹에 속합니다.

Recap은 기본적으로 활성화되어 있습니다: "Session recap은 모든 플랜과 제공업체에서 기본적으로 켜져 있습니다."

이를 끄거나 재정의하는 세 가지 방법이 있습니다:

• /config에서. "자동 Recap을 끄려면 /config를 열고 Session recap을 비활성화하세요."
• 설정에서. awaySummaryEnabled 설정을 통해서도 가능합니다. Anthropic의 설정 참조 문서에 따르면 이를 false로 설정하면 Recap이 중지되며, 기본값은 설정되지 않음(켜짐)입니다.
• 단일 세션의 경우. CLAUDE_CODE_ENABLE_AWAY_SUMMARY 환경 변수는 "해당 세션에 대해 이 설정보다 우선 적용됩니다." 0으로 설정하면 강제로 끄고, 1로 설정하면 강제로 켭니다.

/config 토글은 자동 Recap을 끄는 것으로 설명됩니다. /recap은 필요할 때 직접 사용하는 형태입니다.

왜 끌까요? Recap은 백그라운드에서 생성되며, Anthropic은 유휴 상태일 때 토큰을 사용할 수 있다고 명시합니다. 자주 자리를 비우지만 요약을 거의 읽지 않는다면, 이를 꺼서 토큰 사용을 절약할 수 있습니다.

자동 Recap은 터미널 포커스 상태와 연결된 터미널 기능입니다. /recap은 더 넓은 범위에서 작동합니다. Anthropic의 원격 제어 가이드에 따르면 /compact, /clear, /context와 함께 텍스트 출력 명령어로 나열되어 있어, 휴대폰으로 제어 중인 세션에서도 Recap을 요청할 수 있습니다.

제공업체(Provider)도 상관없습니다. 기능 출시 초기에는 텔레메트리(telemetry)와 연결되어 있었으나, 이후 릴리스 노트에 따르면 "Session recap은 이제 텔레메트리가 비활성화된 사용자(Bedrock, Vertex, Foundry, DISABLE_TELEMETRY)에게도 활성화됩니다." 동일한 릴리스 노트에서 옵트아웃 방법으로 /config 및 CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0을 안내합니다.

세션 재개(Resuming)는 별개의 사례입니다. 또 다른 릴리스 노트에 따르면 Claude Code는 "compaction 후 재개 시 더 이상 계속하기 전에 서문 Recap을 생성하지 않도록 변경되었습니다." 따라서 압축된 세션을 재개할 때는 상단에 추가 요약 없이 바로 시작됩니다.

Recap은 리마인더일 뿐, 기억(memory)이 아닙니다.

문서에서는 이를 세션에 추가되는 표시용 출력으로 설명하며, 나중에 다른 세션에서 이를 로드한다는 내용은 없습니다. 새로운 세션을 시작하거나 /clear를 실행할 때 Claude가 가져오는 지식은 이전 세션의 Recap이 아니라 CLAUDE.md 파일과 자동 기억(auto memory)에서 옵니다.

또한 인수인계(handoff) 수단도 아닙니다. 400자 제한이 있는 Recap은 진행 중인 작업은 알려줄 수 있지만, 결정 뒤의 논리나 제외된 옵션 목록까지 전달할 수는 없습니다. 다른 세션이나 다른 사람에게 작업을 넘기려면 인수인계 프롬프트 작성 가이드를 참고하세요.

모든 휴식 후에 Recap이 나타날 것이라 기대함. 3분의 시간, 포커스 해제된 터미널, 최소 3개의 턴, 그리고 지난 Recap 이후 새로운 턴이 필요합니다.

Slack이나 루틴에서 /recap 전송. 전달된 메시지나 예약된 프롬프트는 요약 대신 안내 메시지를 받게 됩니다. 세션에서 직접 실행하세요.

Recap을 공유용 요약으로 사용. 400자로 제한됩니다. 대신 인수인계 프롬프트를 작성하세요.

Recap이 세션을 압축(compact)한다고 가정함. Recap은 출력을 추가할 뿐 기록을 그대로 유지합니다.

유휴 상태 compaction을 멈추기 위해 Recap을 끔. 두 기능은 별개입니다. 유휴 상태 compaction은 자체 설정이 있습니다.

1단계: 자동 Recap 사용 여부 결정

한 줄 리마인더가 작업 재개에 도움이 된다면 켜두세요. 거의 읽지 않는다면 /config에서 Session recap을 끄거나 awaySummaryEnabled를 false로 설정하세요.

2단계: 필요할 때 /recap 사용

긴 작업을 마친 후, 작업을 전환하기 전, 또는 메시지를 대기열에 넣고 흐름을 놓쳤을 때 /recap을 실행하세요. Claude Code의 메시지 대기열 가이드에서 메시지가 Claude에게 도달하는 시점을 설명합니다.

3단계: 세션보다 오래 유지될 내용 기록

결정 사항, 컨벤션, 또는 시도했으나 실패한 방법 등 나중에 다시 필요한 내용이 있다면 CLAUDE.md에 적거나 Claude에게 자동 기억(auto memory)에 저장해달라고 요청하세요. Recap은 '어디에 있었는지'를 알려주지만, 이러한 파일들은 다음 세션에 '무엇을 알고 있는지'를 알려줍니다.

Recap은 재개를 돕는 한 문장입니다. 작업 뒤의 결정과 그 이유는 한 세션, 한 기기, 한 도구보다 오래 유지되는 장소가 필요합니다.

MemoryLake는 이러한 결정 사항들을 한 곳에 보관하여 ChatGPT, Claude Code, Codex 등 연결된 어시스턴트들이 사용할 수 있게 해주는 기억 계층(memory layer)입니다.

사용자는 자신의 언어로 직접 항목을 작성합니다. Claude Code 세션, Recap, CLAUDE.md 파일, 자동 기억 또는 벤더의 저장소에서 내용을 읽거나 쓰거나 삭제하지 않습니다. Session recap과 /recap은 Anthropic이 설명한 방식 그대로 계속 작동합니다.

1단계: API 키 생성

로그인 후 대시보드에서 키를 생성합니다. 이 키는 MemoryLake 워크스페이스에 속하며 Claude 계정과는 별개입니다.

2단계: 첫 번째 기억 업로드

해결책 3단계에서 적었던 내용부터 시작하세요: 결정 사항, 컨벤션, 제외된 접근 방식 등입니다. 항목당 한 가지 포인트를 날짜와 함께 작성합니다.

3단계: AI 및 에이전트 연결

Claude Code와 사용하는 다른 어시스턴트들을 연결합니다. 동일한 항목들을 새로운 세션, /clear 이후, 또는 다른 도구에서도 사용할 수 있습니다.

첫 번째는 더 빠른 재시작입니다. Recap은 당신이 무엇을 하고 있었는지 상기시켜 주고, 저장된 항목들은 Claude에게 당신이 무엇을 결정했는지 알려줍니다.

두 번째는 세션에 대한 부담 감소입니다. 중요한 부분들이 기록되어 있기 때문에 긴 세션이 모든 것을 담고 있을 필요가 없습니다.

세 번째는 도구 간의 일관성입니다. Claude Code, Codex, ChatGPT에서 동일한 결정 사항을 공유할 수 있습니다.

자리를 자주 비운다면 켜두세요. 작업을 재개하는 빠른 방법입니다.

읽지 않는다면 끄세요. 유휴 상태에서 토큰을 사용할 수 있습니다.

직접 /recap을 실행하세요. 채팅 스레드나 예약된 작업에서 전달된 요청은 거부됩니다.

한 줄 이상의 내용을 기대하지 마세요. 출력은 400자로 제한됩니다.

Compaction과 혼동하지 마세요. Recap은 내용을 추가하고, compaction은 대체합니다.

중요한 것은 기록하세요. 다음 세션에 필요한 내용은 CLAUDE.md나 자동 기억을 사용하세요.

Session Recap은 세션에 3개 이상의 턴이 있고 3분 이상 자리를 비운 후 돌아왔을 때 Claude Code가 보여주는 한 줄 요약입니다. /recap은 요청 시 동일한 요약을 생성하며, 두 기능 모두 400자로 제한됩니다. /recap은 터미널, Claude 앱, 원격 제어, claude -p 또는 자체 SDK 애플리케이션에서 사용자만이 트리거할 수 있습니다.

Compaction과 달리 Recap은 출력을 추가할 뿐 메시지 기록과 캐시를 유지합니다. 따라서 안전한 리마인더가 될 수 있지만, 동시에 영구적인 기억은 아닙니다. 다음 세션이 알아야 할 내용은 Claude Code가 읽을 수 있는 곳에 직접 기록하세요.