Claude Code Hooks로 「세션 종료 시 자동 요약」을 만든 이야기

이 기사에서 만드는 것

Claude Code의 세션이 끝났을 때, 자동으로 「오늘 무엇을 했는지」에 대한 요약(Summary)을 생성하여 파일에 저장하는 메커니즘.

다음 세션을 열었을 때, 이전 작업의 연속성을 파악하는 데 단 몇 초밖에 걸리지 않는다.

문제: 매번 「지난번에 어디까지 했더라?」

Claude Code는 세션이 끝나면 모든 것을 잊어버린다. 이것은 사양(Specification)이다.

실제 작업 흐름에서는:

• 세션을 연다
• git 로그를 확인한다 (2~3분)
• 이전 대화를 되돌아본다 (2~3분)
• 겨우 작업을 시작한다

매일 이것이 반복되면 한 달에 20~30분이 「문맥 회복 (Context Recovery)」에 소모된다.

해결책: Stop 후크로 Haiku에게 요약시키기

Claude Code에는 후크(Hook) 기능이 있다. settings.json에 설정함으로써, 세션 종료 시 자동으로 스크립트를 실행할 수 있다.

파일 구성

~/.claude/
├── settings.json
└── hooks/
...

session-summary.js

const { spawnSync } = require('child_process');
const fs = require('fs');
const path = require('path');
...

settings.json 에 추가

{
"hooks": {
"Stop": [
...

결과

세션 종료 시 자동으로 session_current.md가 업데이트된다:

## 2026-05-18
**변경**: Zenn 북의 제1~3장 집필 (약 1만 자), 프로젝트 디렉토리 분리
**결정**: 유료 Book의 가격을 1,500엔으로 설정, Firefox 자동화는 수동 복사/붙여넣기로 대체
...

다음 세션을 열었을 때, Claude에게 「지난번 작업의 이어서 시작해줘」라고 말하기만 하면, 이 파일을 읽고 즉시 문맥을 파악해 준다.

Haiku를 사용하는 이유

요약 태스크는 L1~L3 (기억·이해·응용) 레벨이므로, Sonnet보다 저렴하고 빠른 Haiku가 적절하다.

1회 요약 비용: 약 0.1~0.3엔

매일 사용해도 한 달에 3~9엔

Stop 후크가 실패하더라도 세션 종료를 차단하지 않도록 설계했기 때문에, 스크립트 에러로 인해 세션이 중단되는 일은 없다.

더 깊게 사용하고 싶은 분들에게

이 Stop 후크 패턴은 「하네스 엔지니어링 (Harness Engineering)」의 일부다.

그 외에도:

• PreToolUse 후크로 git push를 자동 차단
• UserPromptSubmit 후크로 세션 시작 시 하네스 감사를 자동 주입
• retro 스킬로 주간 회고를 반자동화

이것들을 체계적으로 해설한 유료 Book 「Claude Code 하네스 엔지니어링 실전 Playbook」을 Zenn에서 공개 중.

→ [링크를 나중에 추가]