클로드 코드에 도입된 세션 메모리 기능

Claude Code의 최신 버전에는 새로운 기능인 세션 메모리가 도입되었습니다. 더 큰 대화형 세션을 관리하는 데 도움을 주기 위해 설계된 이 기능은 각 프로젝트 디렉토리에 summary.md 파일을 자동으로 생성하고 유지합니다. 기본적으로 비활성화되어 있지만, tweakcc를 사용하여 활성화하고 사용자 정의할 수 있습니다.

주요 세부 사항

활성화되면 세션 메모리는 ~/.claude/projects/{sanitized-project-path}/{session-id}/session-memory/summary.md 경로에 summary.md 파일을 생성합니다. 이 파일은 특정 임계값에 따라 업데이트됩니다: 세션 크기가 10k 토큰과 3개의 도구 호출에 도달하면 첫 업데이트가 이루어지며, 이후에는 5k 추가 토큰과 3개의 추가 도구 호출 이후에 업데이트가 발생합니다.

tweakcc 도구는 환경 변수를 사용하여 이러한 임계값을 사용자 정의할 수 있도록 합니다:

• CC_SM_MINIMUM_MESSAGE_TOKENS_TO_INIT=200 – 첫 번째 추출 전에 필요한 토큰; 기본값은 10,000입니다.
• CC_SM_MINIMUM_TOKENS_BETWEEN_UPDATE=200 – 업데이트 사이에 필요한 토큰; 기본값은 5,000입니다.
• CC_SM_TOOL_CALLS_BETWEEN_UPDATES=0 – 업데이트 사이에 필요한 도구 호출; 기본값은 3입니다.
• CC_SM_PER_SECTION_TOKENS=3000 – 섹션당 최대 토큰 수(경고 발생 전); 기본값은 2,000입니다.
• CM_SM_TOTAL_FILE_LIMIT=12000 – 전체 요약의 최대 토큰 수; 기본값은 12,000입니다.

세션 메모리 기능을 활성화하려면 npx tweakcc@latest --apply를 실행하고 필요한 환경 변수를 설정해야 합니다. 이 기능은 포괄적인 활동 추적이 유용한 중간에서 대규모 대화형 세션을 처리하는 개발자를 대상으로 합니다.