WEEK 6 / 8

Hooks +
자동 메모리

"이런 일 일어나면 → 자동으로" — 진짜 보좌관 만들기

이번 주 배우는 것

  • Hooks — 이벤트 기반 자동 트리거
  • 자동 메모리 — Claude가 알아서 기억하는 시스템
  • 메모리 4가지 타입 — user · feedback · project · reference
  • 핸즈온: 자기 보좌관 1개 셋업

→ 끝나면: Claude가 대화 끝날 때마다 자동으로 학습·기록·정리합니다.

Hook = 이벤트 트리거

Claude가 특정 행동을 할 때 — 자동으로 내가 정한 명령이 끼어들어 실행되는 것.

일상 비유

  • "화재 감지 → 자동 살수"
  • "문 열림 → 알람 울림"
  • "메일 도착 → 라벨 자동 부여"

Claude Code에서

  • "파일 저장 → 자동 백업"
  • "세션 종료 → 메모리 갱신"
  • "위험 명령 시도 → 한 번 더 묻기"

자주 쓰는 Hook 4종

1

PreToolUse

도구 실행 전에 끼어듦. 위험 명령 차단·로그 기록.

2

PostToolUse

도구 실행 후. 결과 검증·자동 백업·후속 처리.

3

Stop

대화 끝날 때. 메모리 갱신·요약 기록·다음 세션 준비.

4

SubagentStop

서브에이전트 끝날 때. 결과를 메인 작업에 통합.

설정 위치: ~/.claude/settings.json 또는 프로젝트 .claude/settings.json

자동 메모리 — Claude가 알아서 기억

내가 뭐 말 안 해도 — Claude가 대화 중 중요한 것을 골라 자동 저장. 다음 대화에서 자동으로 떠올림.

예시 — 자동 저장되는 것

  • 내가 알려준 직업·역할·프로젝트 정보
  • 내가 한 피드백 ("그 방식 말고 이 방식으로")
  • 이 프로젝트의 진행 상황·결정사항
  • 외부 도구·계정·URL 같은 자주 참조하는 것

효과: 매 대화마다 같은 설명을 반복할 필요가 사라짐.

메모리 4가지 타입

user나에 대한 정보 — 직업·관심사·역할·선호 (예: "8체질 금음")
feedback내가 한 피드백 — 하지 말 것·계속할 것 (예: "이미지에 글씨 금지")
project현재 프로젝트 상태 — 진행 중인 일·결정·다음 단계
reference외부 자원 — 봇 토큰·도메인·계정·자주 보는 URL

Claude가 4종 중 어디 속하는지 자동 판단해서 적절한 폴더에 저장. 우리는 건드리지 않아도 됨.

Hook + 메모리 = 진짜 보좌관

이 조합의 의미

  • Stop hook이 매 대화 끝에 "오늘 뭐 했지?" 정리
  • 그 정리를 자동 메모리가 적절한 타입으로 저장
  • 다음 대화 시작 시 자동으로 관련 메모리 떠올림

대화 한 번 = 학습 한 번.
매 대화마다 보좌관이 똑똑해짐.

실제 운영 사례 — Sean의 AI Factory에서는 89개 메모리가 자동 누적되어 있음 (작업 패턴·피드백·프로젝트 상태)
HANDS-ON · 15분

지금, 자동 메모리 셋업

  1. (2') 자기 메인 작업 폴더로 이동 — cd 프로젝트 → claude
  2. (5') Claude에게 부탁: 
    자동 메모리 시스템을 셋업해줘.

1) ~/.claude/projects/이폴더/memory/ 만들고
2) Stop hook 등록 — 대화 끝날 때 메모리 갱신
3) MEMORY.md 인덱스 파일 만들기
4) 4가지 타입(user/feedback/project/reference) 분류 규칙

설정 끝나면 어떻게 작동하는지 설명.
  3. (5') 시험 — 나에 대한 정보 1줄 알려주기 → 새 대화에서 기억하는지 확인
  4. (3') Hook 동작 확인 — cat ~/.claude/projects/.../memory/MEMORY.md

자주 하는 실수 3가지

  1. Hook 너무 많이 등록 — 매 도구 호출마다 끼어들면 느려짐. 꼭 필요한 것만.
  2. 메모리 직접 수정 — 자동 시스템이 헷갈림. "이거 까먹어줘"로 Claude한테 시키기.
  3. 민감 정보 메모리에 저장 — API 키·비밀번호 절대 금지. 코드/설정 파일로.

원칙: 자동 메모리는 "메타 정보"(누가 / 뭘 / 왜) 저장용. 비밀·민감 데이터 금지.

실전 팁 4가지

① 메모리 자주 점검

주 1회 — MEMORY.md 열어서 잘못된 항목·중복 정리.

② 강력한 트리거는 PreToolUse

실수 방지에 최강. "rm 명령 시 한 번 더 묻기" 같은 가드.

③ 메모리 인용 명령

"메모리 보고 답해줘" — 무시하면 다시 시키기.

④ 백업

memory 폴더 자체를 git에 커밋해두면 — 사고 시 복구 가능.

오늘은 여기까지.

이번 주 — 자동 메모리 셋업하고 매일 한 번씩 Claude와 대화해보세요.
일주일 후 MEMORY.md에 어떤 항목이 쌓였는지 확인 = 다음주 발표 거리.

수고하셨습니다 :)

다음주 — W7 · 시스템 통합
CLAUDE CODE DEEP DIVE · W6 · 2026