🧠 Auto Memory — Claude가 나를 기억하는 법 — 클로드 코드 무료 학습

Auto Memory = Claude가 스스로 배워가는 시스템

회사에 신입사원이 들어오면 어떤가요? 첫날에는 프린터가 어디 있는지, 보고서 양식이 뭔지, 하나하나 알려줘야 하잖아요. 그런데 한 달쯤 지나면? 알아서 해요. 따로 말 안 해도 보고서 양식을 맞추고, 회의실 예약 방법도 알고 있어요.

Claude Code의 Auto Memory도 똑같아요. 처음엔 여러분 프로젝트에 대해 아무것도 몰라요. 그런데 함께 작업하면 할수록, 점점 여러분의 프로젝트를 “기억”해요. 빌드 명령이 뭔지, 파일 구조가 어떻게 되는지, 자주 하는 실수가 뭔지까지요.

신입사원	Claude Code (Auto Memory)
첫날: 모든 걸 물어봐야 함	첫 대화: 프로젝트 구조 파악부터
1주: 기본 업무 패턴 습득	몇 번 작업: 빌드/실행 방법 기억
1달: 알아서 일처리	지속 사용: 코딩 스타일까지 맞춤
메모장에 업무 노트 정리	MEMORY.md에 프로젝트 정보 저장
업무 가이드북 참고	CLAUDE.md 자동 참조

한 줄 요약

Auto Memory = Claude Code가 함께 일하면서 스스로 배워가는 시스템. 여러분이 매번 같은 설명을 반복할 필요가 없어져요.

어떻게 기억하는 걸까?

Auto Memory의 작동 방식은 정말 단순해요. Claude Code가 여러분과 대화하면서 “이건 나중에도 알면 좋겠다” 싶은 정보를 발견하면, 자동으로 메모해두는 거예요. 마치 옆에서 일하는 동료가 포스트잇에 메모하는 것처럼요.

기억이 만들어지는 과정

여러분이 Claude Code와 작업

평소처럼 대화하면서 코딩, 파일 수정, 빌드 등을 해요

Claude가 중요한 정보 발견

"이 프로젝트는 npm run build로 빌드하는구나" 같은 패턴을 감지해요

여러분에게 확인 요청

"이걸 기억해도 될까요?" 하고 물어봐요. 허락해야 저장돼요

MEMORY.md에 저장

허락하면 프로젝트 메모리 파일에 기록해요

다음 대화에서 자동 참조

새 대화를 시작해도 이전에 기억한 내용을 알고 있어요

가장 중요한 건 3번이에요. Claude Code가 마음대로 기억하는 게 아니라, 항상 “이걸 기억해도 될까요?” 하고 여러분의 허락을 받아요. 원치 않는 정보가 저장되는 걸 막을 수 있어요.

허락하면

MEMORY.md 파일에 해당 내용이 추가돼요. 다음 대화부터 Claude Code가 이 정보를 알고 있어요. “빌드 명령이 뭐였지?” 다시 물어볼 필요 없어요.

거절하면

아무것도 저장되지 않아요. 해당 정보는 현재 대화에서만 사용되고, 다음 대화에서는 모르는 상태로 돌아가요.

대화가 끝나면 기억이 사라져요 (Memory 없이는)

Claude Code는 기본적으로 대화가 끝나면 모든 걸 잊어버려요. 매번 새 대화를 시작하면 “이 프로젝트가 뭐하는 건지”부터 다시 파악해야 해요. Auto Memory가 있으면 이 문제가 해결돼요 — 이전 대화에서 기억한 내용이 다음 대화에도 이어지거든요.

Auto Memory = AI의 업무 노트

함께 일할수록 여러분의 프로젝트를 더 잘 이해하게 돼요

어떤 것들을 기억할까?

Auto Memory가 기억하는 정보는 크게 6가지 종류로 나눌 수 있어요. 모두 “다음에도 알면 유용한 것들”이에요.

🛠

빌드 & 실행 명령

npm run build, python manage.py runserver 같은 프로젝트 실행 방법을 기억해요. 매번 “빌드 어떻게 해?” 안 물어봐도 돼요.

📁

파일 & 폴더 구조

“src/components/ 아래에 UI 컴포넌트가 있다”, “api/ 폴더가 백엔드다” 같은 프로젝트 구조를 기억해요.

🔧

해결한 문제 & 에러

“이 프로젝트에서 포트 3000 충돌이 자주 난다”, “TypeScript strict 모드라 any 금지” 같은 트러블슈팅 경험을 기억해요.

🎨

코딩 스타일 & 규칙

“함수명은 camelCase”, “컴포넌트는 화살표 함수” 같은 여러분 프로젝트의 코딩 스타일을 기억해요.

🔐

환경 설정 & 인증

“API 키는 .env 파일에 있다”, “배포는 Vercel로 한다” 같은 환경 설정 정보를 기억해요.

📖

여러분이 직접 알려준 것

“이 프로젝트는 한국어 UI야”, “테스트는 항상 Jest로 해줘” 같이 여러분이 명시적으로 알려준 정보예요.

실제로 이렇게 기억해요

예를 들어볼게요. 여러분이 3일 동안 Claude Code로 작업했다면, Memory에 이런 내용들이 쌓여 있을 수 있어요.

실제 MEMORY.md 예시

# 프로젝트 메모리

## 프로젝트 구조
- Next.js 14 App Router + Tailwind CSS + TypeScript
- 컴포넌트: src/components/
- API 라우트: src/app/api/
- 배포: Vercel (git push로 자동 배포)

## 빌드 & 실행
- 개발 서버: npm run dev (포트 3000)
- 빌드: npm run build
- 린트: npm run lint

## 코딩 스타일
- 컴포넌트: export default function 방식 (화살표 X)
- CSS: Tailwind만 사용 (인라인 스타일 X)
- 상태 관리: zustand

## 해결한 문제
- hydration 에러: "use client" 누락 시 발생
- 이미지 최적화: next/image 사용 필수
- 환경변수: .env.local에 저장, NEXT_PUBLIC_ 접두사

이 내용이 MEMORY.md에 저장되어 있으면, 다음에 새 대화를 시작해도 Claude Code가 “아, 이 프로젝트는 Next.js 14에 Tailwind를 쓰고, npm run dev로 실행하는구나” 하고 바로 알고 시작해요.

기억이 쌓일수록 효율이 올라가요

처음 1~2번 작업할 때는 Memory가 거의 비어 있어요. 하지만 일주일, 한 달 쓰다 보면 여러분 프로젝트의 전문가가 돼요. “이 프로젝트에서 이런 패턴으로 하면 에러 나요”까지 알아서 피해가기 시작해요.

Memory 파일은 어디에 저장되나요?

Auto Memory가 저장하는 파일은 일반 텍스트 파일이에요. 비밀스러운 곳에 숨겨져 있는 게 아니라, 여러분 컴퓨터의 특정 폴더에 MEMORY.md라는 이름으로 저장돼요. 직접 열어서 읽을 수도 있고, 수정할 수도 있어요.

2가지 종류의 Memory

1. 전역 메모리 (Global)

모든 프로젝트에서 공통으로 적용돼요. “한국어로 답변해줘”, “커밋 메시지는 영어로” 같은 개인 선호도를 저장하기 좋아요.

저장 위치

# Windows
~/.claude/MEMORY.md

# Mac/Linux
~/.claude/MEMORY.md

2. 프로젝트 메모리 (Project)

해당 프로젝트에서만 적용돼요. 빌드 명령, 파일 구조, 코딩 스타일 등 프로젝트 고유 정보를 저장해요.

저장 위치

# Windows
~/.claude/projects/<경로해시>/memory/MEMORY.md

# Mac/Linux
~/.claude/projects/<경로해시>/memory/MEMORY.md

<경로해시> 부분은 프로젝트 폴더 경로를 기반으로 자동 생성되는 폴더명이에요. 직접 찾아갈 필요 없이, Claude Code에게 “메모리 파일 보여줘”라고 하면 돼요.

Memory 파일 직접 확인하기

Claude Code에 이렇게 말하세요

이 프로젝트에 대해 기억하고 있는 거 보여줘.

이렇게 하면 Claude Code가 현재 프로젝트의 MEMORY.md 내용을 보여줘요. 전역 메모리도 같이 읽어서 알려줘요.

파일을 직접 열어볼 수도 있어요

# 전역 메모리 열기
cat ~/.claude/MEMORY.md

# 또는 메모장/VS Code로 열기
code ~/.claude/MEMORY.md

MEMORY.md vs CLAUDE.md

비슷해 보이지만 다른 파일이에요.MEMORY.md는 Claude Code가 자동으로 작성하는 메모장이에요.CLAUDE.md는 여러분이 직접 작성하는 프로젝트 설명서예요. 다음 챕터에서 CLAUDE.md를 자세히 다룰 거예요.

	MEMORY.md	CLAUDE.md
작성자	Claude Code (자동)	사람 (수동)
내용	작업하면서 배운 것들	프로젝트 설명서, 규칙
위치	~/.claude/ (숨겨진 폴더)	프로젝트 루트 (같이 커밋)
용도	개인 메모장	팀 전체가 보는 가이드북
수정	Claude가 주로 수정 + 직접 수정도 가능	사람이 직접 수정
공유	내 컴퓨터에서만 사용	Git으로 팀과 공유 가능

기억 직접 관리하기

Auto Memory는 자동이지만, 수동으로도 제어할 수 있어요. “이걸 꼭 기억해”라고 시킬 수도 있고, “이건 잊어버려”라고 할 수도 있어요.

기억시키기

Claude Code에게 명시적으로 “기억해줘”라고 말하면, 바로 MEMORY.md에 저장해요. 중요한 규칙이나 반복되는 실수를 미리 알려줄 때 유용해요.

프로젝트 규칙 알려주기

이 프로젝트에서는 컴포넌트 파일명을 PascalCase로 써.
이걸 기억해줘.

개인 선호도 알려주기

나는 커밋 메시지를 한국어로 쓰고 싶어.
항상 "feat:", "fix:", "chore:" 접두사를 붙여줘.
이걸 전역 메모리에 기억해줘.

반복 실수 방지

이 프로젝트에서 Image 컴포넌트는 next/image를 사용해야 해.
HTML img 태그를 쓰면 빌드가 실패해.
이걸 기억해줘.

잊게 하기

잘못된 정보가 기억됐거나, 더 이상 유효하지 않은 규칙이 있다면 “잊어줘”라고 말하면 돼요.

특정 기억 삭제

"포트 3000 충돌" 관련 기억을 삭제해줘.
이제 포트 설정이 바뀌었거든.

잘못된 기억 수정

메모리에 "배포는 Netlify"라고 되어 있는데,
지금은 Vercel로 변경됐어.
메모리를 업데이트해줘.

MEMORY.md 직접 수정하기

MEMORY.md는 일반 텍스트(마크다운) 파일이에요. 메모장이나 VS Code로 직접 열어서 수정해도 돼요. Claude Code가 다음에 읽을 때 수정된 내용이 반영돼요.

직접 수정도 가능해요

# 메모장이나 VS Code로 직접 열기
code ~/.claude/MEMORY.md

# 또는 Claude Code에게 시키기
메모리 파일을 열어서 보여줘. 수정할 게 있어.

직접 수정할 때 주의

MEMORY.md를 직접 수정할 때는 마크다운 문법을 유지해주세요. 헤딩(##)이나 목록(-) 형식이 깨지면 Claude Code가 내용을 제대로 파싱하지 못할 수 있어요. 큰 구조 변경은 Claude Code에게 시키는 게 안전해요.

직접 해보기

직접 해봐야 감이 잡혀요. 아래 실습을 순서대로 따라해보세요.

실습 1: 현재 메모리 확인하기

Claude Code를 열고 지금 기억하고 있는 내용을 확인해보세요.

Claude Code에 이렇게 말하세요

이 프로젝트에 대해 기억하고 있는 거 전부 보여줘.

처음이라면 “기억하고 있는 내용이 없습니다”라고 나올 수 있어요. 그럼 2번으로 넘어가서 기억을 만들어봐요.

실습 2: 의도적으로 기억시키기

프로젝트에 대한 중요 정보를 Claude Code에게 기억시켜보세요.

Claude Code에 이렇게 말하세요

이 프로젝트에 대해 기억해줘:
- 이 프로젝트는 학습용 실험 프로젝트야
- 빌드 명령: npm run build
- 테스트 명령: npm test
- 배포는 아직 안 해

Claude Code가 “기억할까요?”라고 물으면 허락하세요. 그러면 MEMORY.md에 저장돼요.

실습 3: 기억이 작동하는지 확인

새 대화를 시작한 뒤, 기억이 유지되는지 확인해보세요.

새 대화에서 이렇게 말하세요

이 프로젝트 빌드 어떻게 해?

방금 기억시킨 “npm run build”를 알고 있으면 성공이에요!

실습 4: 기억 수정해보기

기억된 정보를 수정하거나 삭제해보세요.

Claude Code에 이렇게 말하세요

메모리에서 "배포는 아직 안 해" 부분을
"배포: Vercel (git push로 자동)"으로 바꿔줘.

확인 체크리스트

현재 메모리 내용을 확인했다Claude Code에게 정보를 기억시켰다새 대화에서 기억이 유지되는 걸 확인했다기억을 수정하거나 삭제해봤다

실습이 잘 안 되면 걱정하지 마세요. Auto Memory는 며칠 같이 작업하다 보면 자연스럽게 쌓여요. “기억해줘”를 억지로 반복할 필요 없이, 평소처럼 작업하면 알아서 기억해줘요.

활용 팁 + 주의사항

Auto Memory를 효과적으로 활용하기 위한 실용적인 팁들이에요.

1. 200줄 제한이 있어요

MEMORY.md는 200줄 제한이 있어요. 200줄이 넘으면 오래된 내용부터 잘려나갈 수 있어요. 정말 중요한 규칙은 CLAUDE.md(다음 챕터)에 별도로 적어두는 게 안전해요.

2. 잘못된 기억이 생길 수 있어요

가끔 Claude Code가 잘못된 정보를 기억하는 경우가 있어요. 예를 들어 임시로 바꿨던 설정을 영구 규칙으로 기억한다든지요. 가끔 “메모리 내용 보여줘”로 점검하는 습관을 들이세요.

3. 전역 vs 프로젝트 구분해서 기억시키기

“한국어로 답변”처럼 모든 프로젝트에 적용되는 건 전역 메모리에, “이 프로젝트는 TypeScript strict”처럼 특정 프로젝트에만 해당되는 건 프로젝트 메모리에 저장하세요. “전역 메모리에 기억해줘”라고 말하면 구분할 수 있어요.

4. 주기적으로 정리하기

한 달에 한 번 정도 “메모리 내용 보여주고 정리해줘”라고 하세요. 오래된 정보, 중복된 내용, 더 이상 유효하지 않은 규칙을 Claude Code가 알아서 정리해줘요.

메모리 정리 명령

메모리 파일을 보여줘.
오래된 정보나 중복을 정리하고,
카테고리별로 깔끔하게 재구성해줘.

5. 민감한 정보는 기억시키지 마세요

비밀번호, API 키, 개인정보 같은 민감한 정보는 Memory에 저장하지 마세요. MEMORY.md는 일반 텍스트 파일이라 다른 사람이 볼 수 있어요. 인증 정보는 .env 파일에 따로 관리하세요.

6. 토픽별 메모리 파일로 분리하기

메모리가 200줄을 넘어가면, 세부 내용을 별도 파일로 분리할 수 있어요. MEMORY.md는 목차(인덱스) 역할만 하고, 상세 내용은 같은 memory 폴더의 별도 .md 파일에 저장하는 거예요.

분리된 메모리 구조 예시

~/.claude/projects/my-project/memory/
  MEMORY.md           # 목차 + 핵심 정보만 (200줄 이내)
  deployment.md       # 배포 관련 상세 기록
  troubleshooting.md  # 해결한 에러 목록
  api-notes.md        # API 연동 정보

이럴 때	이렇게 하세요
프로젝트 규칙을 알려주고 싶을 때	"이걸 기억해줘"
잘못된 기억을 발견했을 때	"이건 잊어줘" 또는 "수정해줘"
메모리가 꽉 찼을 때	주제별로 별도 .md 파일로 분리
중요한 규칙이 사라질까 걱정될 때	CLAUDE.md에 별도로 기록 (다음 챕터)
민감한 정보를 저장해야 할 때	.env 파일 사용, Memory에 저장 X

Auto Memory = 함께 성장하는 AI 동료

오래 함께 일할수록 여러분의 스타일을 이해하고, 반복 설명 없이 바로 일을 시작해요. 다음 챕터에서는 여러분이 직접 프로젝트 매뉴얼을 작성하는 CLAUDE.md를 배워볼 거예요.

다음 챕터 미리보기: CLAUDE.md

Auto Memory가 Claude Code의 “자율 학습”이라면, CLAUDE.md는 여러분이 쓰는 “공식 교본”이에요. 둘을 함께 활용하면 Claude Code가 여러분 프로젝트의 최고 전문가가 돼요.

참고 자료

Claude Code Memory 공식 문서 — docs.anthropic.com/en/docs/claude-code/memory
MEMORY.md 작성 가이드 — docs.anthropic.com/en/docs/claude-code/memory#memory-files