Claude Code v2.1.108의 새로운 /recap 기능 및 작동 원리 분석

커뮤니티 반응

기능의 유용성에 대해서는 긍정적인 평가가 있으나, 토큰 소모와 빈번한 트리거로 인해 비활성화를 원하는 사용자들을 위한 구체적인 설정법이 공유되며 실용적인 반응을 얻고 있다.

주요 논점

01중립다수

기능 자체는 유용하지만 토큰 비용이 발생하고 상황에 따라 번거로울 수 있으므로 선택적 사용이 필요하다.

합의점 vs 논쟁점

합의점

자동 요약 기능이 프롬프트 캐시 상태를 체크하여 효율적으로 작동한다는 점
요약 기능으로 인해 발생하는 토큰이 사용자의 비용 예산에 포함된다는 사실

실용적 조언

토큰 비용을 절약하고 싶다면 /config 명령어를 통해 away_summary를 false로 설정하여 기능을 비활성화할 수 있다.
수동으로 요약이 필요한 경우에만 /recap 명령어를 입력하여 제어권을 가질 수 있다.

섹션별 상세

Claude Code v2.1.108 버전부터 5분 이상 자리를 비운 후 복귀하면 이전 작업 내용을 40단어 내외로 요약해주는 /recap 기능이 도입됐다. 이 기능은 별도의 API 호출을 발생시키지 않고 사용자의 다음 정규 턴에 시스템 지침을 주입하는 방식으로 작동한다. 프롬프트 캐시 상태를 확인하여 캐시가 유효할 때만 실행되며, 캐시가 만료되었거나 없는 경우에는 자동으로 생략된다.

자동 요약 기능은 프롬프트 캐싱 상태를 기반으로 안전성을 체크한 후 실행 여부를 결정한다. 사용자가 3~5분 이상 유휴 상태였다가 메시지를 입력하면 시스템은 CacheSafeParams 저장 여부와 캐시의 신선도를 순차적으로 검증한다. 모든 체크를 통과하면 캐싱되지 않은 꼬리 부분에 요약 지침을 주입하여 모델이 응답 서두에 요약을 포함하도록 유도한다.

json

"awaySummaryEnabled": false

설정 JSON 파일에서 자동 요약 기능을 비활성화하는 방법

편의 기능임에도 불구하고 요약 과정에서 발생하는 입력 및 출력 토큰이 사용자의 토큰 예산에 합산된다는 점이 지적됐다. 작성자는 이 기능이 번거로울 수 있음을 언급하며 세 가지 비활성화 경로를 제시했다. /config 명령어로 away_summary를 false로 설정하거나, 설정 JSON 수정, 또는 환경 변수 CLAUDE_CODE_ENABLE_AWAY_SUMMARY 설정을 해제함으로써 기능을 끌 수 있다.

용어 해설

프롬프트 캐싱(Prompt Caching): — 자주 사용되는 프롬프트 데이터를 서버에 저장해두고 재사용하는 기술이다. 동일한 컨텍스트를 반복해서 입력할 때 발생하는 연산 비용과 지연 시간을 줄여주며, Claude Code에서는 캐시 상태를 확인하여 요약 기능을 실행할지 결정하는 기준으로 활용된다.
시스템 지침(System Instruction): — AI 모델의 행동 방식이나 응답 형식을 규정하기 위해 입력하는 최상위 명령문이다. Claude Code의 /recap 기능은 사용자가 자리를 비운 후 복귀했을 때 이 지침을 다음 턴에 주입하여 이전 작업 내용을 요약하도록 유도한다.
토큰 예산(Token Budget): — LLM API 사용 시 설정된 입력 및 출력 토큰의 제한량 또는 비용 한도를 의미한다. 자동 요약 기능은 추가적인 입출력 토큰을 생성하므로 사용자의 전체 사용량에 포함되어 비용이나 할당량에 영향을 줄 수 있다.

언급된 도구

Claude Code추천

Anthropic에서 제공하는 CLI 기반 AI 코딩 에이전트