정의

Auto Memory는 사용자가 정정·선호를 자연어로 말하면 Claude가 자동으로 노트해 두는 머신 로컬 메모리 시스템이다. ChatGPT 메모리와 비슷하지만 클라우드가 아닌 본인 노트북의 마크다운 파일로 저장돼, 무엇이 기억됐는지 직접 보고 편집·삭제할 수 있다.

핵심 동작

  • 저장 위치는 ~/.claude/projects/<project>/memory/. project 경로는 git repo로부터 도출돼, 같은 repo의 모든 worktree·하위 디렉터리가 한 메모리 디렉터리를 공유한다
  • 매 세션 시작 시 MEMORY.md의 첫 200행 또는 25KB가 자동 로드된다. 토픽 파일(debugging.md·api-conventions.md)은 필요할 때만 Claude가 read한다
  • “다음부터 표 끝에는 출처를 붙여 줘” 같은 자연어 정정이 자동 저장된다
  • /memory 슬래시 커맨드로 토글하거나 폴더를 직접 열 수 있다
  • 끄려면 환경 변수 CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 또는 settings의 autoMemoryEnabled: false

사용법

# 토글·폴더 열기
claude
> /memory

# 자연어 정정 (자동 저장됨)
> 그림 캡션 끝에는 마침표 빼는 게 우리 학교 표준이야. 다음부터 그렇게 해 줘

# 끄기
$env:CLAUDE_CODE_DISABLE_AUTO_MEMORY=1
claude

settings.json 예시.

{
  "autoMemoryEnabled": true,
  "autoMemoryDirectory": "~/my-custom-memory-dir"
}

강사 멘트

Auto Memory는 “왜 자꾸 같은 정정을 해야 하지” 라는 좌절을 풀어 주는 기능이다. 매일 열두 번 정정하던 것이 자동으로 누적되면, 한 달 뒤에는 본인 톤이 거의 자동으로 잡힌다. 핵심 차별점은 — ChatGPT 메모리는 클라우드에서만 보이지만, Claude Code는 ~/.claude/projects/<project>/memory/ 아래 마크다운으로 쌓인다. 본인이 손으로 열어 보고 지울 수 있다. 민감한 정정(예. 미발표 자료의 약어)이 자동 저장되는 게 부담스러우면 환경 변수 한 줄로 끈다. 학생 개인정보·평가 자료를 다루는 교사는 이것을 꺼 두고 시작하는 것이 안전하다.

실습

세션 안에서 자연어로 “다음부터 평가 루브릭은 4단계 표로 만들어 줘”라고 말한 뒤, 다른 폴더에서 같은 프롬프트를 보내 규칙이 자동 적용되는지 확인한다. /memory로 폴더를 열어 저장된 마크다운을 직접 본다.

활용 시사점

교육 현장에서 Auto Memory는 다음 두 가지로 활용된다.

  • 반복 정정 누적. “활동지 시간 표기는 분 단위로”, “학생 호칭은 학생 이름 대신 이니셜로” 같은 정정이 자동 누적돼, 한 학기 뒤에는 본인 톤이 거의 자동으로 잡힌다
  • 민감 정보 환경에서는 OFF. 학생 개인정보·미공개 평가 문항을 다루는 폴더는 CLAUDE_CODE_DISABLE_AUTO_MEMORY=1로 메모리 저장을 끄고 시작한다. 내부 작업과 외부 작업의 디렉터리·메모리 설정을 분리하는 것이 안전하다
← 이전 기능 허브로 돌아가기 다음 기능 →

업데이트:

공유