블로그

Claude Memory: Memory, CLAUDE.md, Auto Memory

Markdown

Claude의 세 가지 메모리 시스템: 각 시스템이 작동하는 곳, 설정 관리 방법, 저장할 내용, 흔히 하는 실수 다섯 가지를 피하는 방법.

전체 글 읽기

핵심 내용

2026년 Claude에는 세 가지 메모리 시스템이 있습니다. 클라우드 기반이며 2026년 3월부터 무료인 Claude.ai의 Memory, 규칙을 적어 두는 Claude Code의 CLAUDE.md 파일, 프로젝트에 관한 에이전트의 메모인 Auto Memory입니다. 세 시스템은 서로 다른 방식으로, 서로 다른 제품에서 작동합니다. Memory는 Claude Code로 이어지지 않고 CLAUDE.md는 claude.ai에서 작동하지 않습니다. 이 글에서는 비교 표와 함께 각각을 언제 활성화할지, 어디에 무엇을 넣을지, 설정을 망가뜨리는 실수 다섯 가지를 살펴봅니다.

Ailoot 사용에 관한 실용적인 안내는 문서에서 확인할 수 있습니다.

Claude 메모리란 무엇이며, 왜 세 계층으로 나뉘나요?

핵심 내용

2026년 Claude에는 서로 다른 제품에 자리한 세 가지 메모리 계층이 있습니다. Memory는 웹 및 모바일 채팅인 Claude.ai에서 작동합니다. CLAUDE.md와 Auto Memory는 터미널을 통해 노트북에서 사용하는 Claude Code에서 작동합니다. 이들은 같은 것이 아닙니다. Memory는 Claude Code로 이어지지 않고 CLAUDE.md는 Claude.ai에서 작동하지 않습니다. 사람들이 “Claude가 내 프로젝트를 잊어버렸어”라고 말할 때는 대개 각 메모리 유형이 어디에 있는지 혼동하는 것입니다.

화요일에 Claude.ai를 열어 내 대상 고객, 답변 형식, 글쓰기 스타일을 알려 줍니다. 목요일에 새 채팅으로 돌아오면 Claude는 이미 그 내용을 기억하고 있습니다. 이것이 Memory의 작동 방식입니다.

터미널에서 Claude Code를 열고, 프로젝트를 파악하는 데 2주를 보내면서 폴더 구조와 배포 규칙, 즐겨 쓰는 라이브러리를 설명합니다. 세션을 닫았다가 한 시간 뒤 다시 열면 에이전트는 처음부터 시작합니다. 여기서는 Memory가 작동하지 않습니다. 이 문제를 해결하려면 CLAUDE.md가 필요합니다.

2026년에 세 번째 계층이 등장했습니다. Claude Code의 Auto Memory는 에이전트가 프로젝트에 관한 메모를 직접 작성한다는 뜻입니다. 어떤 명령이 작동하는지, 어떤 테스트가 통과하는지, 저장소에서 어떤 경로가 민감한지 등을 기록합니다. 이 메모는 디스크의 로컬에 저장되고 다음 세션에서 자동으로 불러옵니다.

가장 큰 혼란은 “이제 Claude가 기억한다”는 말을 듣고 어디서나 자동으로 작동한다고 생각하는 데서 생깁니다. 그렇지 않습니다. claude.ai의 Memory는 Claude Code로 이어지지 않습니다. 공식 Claude Code 문서는 두 가지 메모리 메커니즘을 설명하며, Chat Memory는 그중 하나가 아닙니다. CLAUDE.md와 Auto Memory는 Claude Code에서 작동하는 완전히 별개의 시스템입니다. Anthropic API도 마찬가지입니다. 채팅 메모리와 무관한 별도의 Memory 도구가 있습니다.

이 가이드에서는 세 가지를 모두 다루므로 어디에 무엇을 넣어야 하는지, “메모리를 설정했는데도” Claude가 갑자기 프로젝트를 “잊어버리는” 이유가 무엇인지 알 수 있습니다.

Claude.ai의 Memory란 무엇이며, 2026년에 누가 무료로 사용할 수 있나요?

핵심 내용

Claude.ai의 Memory는 계정에 연결된 클라우드 기반 메모리입니다. Anthropic은 2026년 3월부터 Free를 포함한 모든 요금제에서 이 기능을 무료로 제공하고 있습니다. claude.ai와 모바일 앱에서만 작동합니다. Claude는 대화에서 직업, 답변 스타일, 업무 맥락 같은 장기적으로 유용한 정보를 자동으로 파악해 Memory 프로필에 저장합니다. 설정 → 기능 → Memory에서 관리할 수 있습니다.

Memory가 정보를 수집하는 방식

Anthropic은 이를 Memory Synthesis라고 부릅니다. Claude는 하루에 한 번 정도 최근 대화를 처리해 장기적으로 유용할 정보를 파악하고, 짧은 요약을 Memory 프로필에 작성합니다. 메시지를 그대로 인용하는 것이 아니라 “사용자는 마케터이며 온라인 프로젝트를 운영하고 군더더기 없는 짧은 답변을 선호한다”와 같은 압축된 진술을 기록합니다.

다음 대화에서는 이 요약이 컨텍스트의 시작 부분에 자동으로 추가됩니다. Claude는 매번 채팅에서 반복해서 말하지 않아도 당신이 누구인지, 무엇을 하는지, 어떤 답변 스타일을 좋아하는지 알게 됩니다.

Memory를 지원하는 요금제

Anthropic은 Memory를 단계적으로 출시했습니다. 2025년 9월 11일 — Team 및 Enterprise, 2025년 10월 23일 — Pro 및 Max, 2026년 3월 2일 — 모든 요금제에서 무료 제공, 그리고 ChatGPT, Gemini, Grok에서 가져오는 도구도 함께 제공됩니다.

요금제Memory 작동 여부기능
Free예Memory 자체는 2026년 3월부터 작동하지만 Chat Search(대화 기록 검색)는 유료 요금제에서만 계속 제공됩니다
Pro ($20/mo)예Memory + Chat Search
Max예Memory + Chat Search
Team / Enterprise예팀 계정에 연결됨
API아니요Chat Memory는 이어지지 않습니다. 에이전트 개발자를 위한 별도의 Memory 도구가 있습니다
Claude Code아니요Claude Code에서는 CLAUDE.md와 Auto Memory를 사용하세요

이 점이 중요합니다. Memory는 Claude.ai 웹 인터페이스나 모바일 앱을 사용할 수 있는 곳에서 작동합니다. 자체 코드나 CLI를 통해 Claude를 사용하면 Memory는 제공되지 않습니다.

확인 및 수정 방법

claude.ai에서: 설정 → 기능 → Memory. 직접 URL: claude.ai/settings/capabilities?modal=memory. Claude가 당신에 대해 저장한 모든 항목의 목록이 열립니다. 버튼은 세 가지입니다.

  • 일시 중지 — Claude는 지금까지 쌓인 메모리를 보존하지만, 더 이상 사용하거나 추가하지 않습니다.
  • 메모리 초기화 — 모든 내용을 지웁니다.
    이 옵션을 선택하고 '메모리 초기화'를 클릭하면 되돌릴 수 없습니다.
    — Anthropic, https://support.claude.com/en/articles/11817273
  • 개별 항목 수정 — 개별 항목을 수동으로 삭제할 수 있습니다.

인라인 컨트롤은 채팅에서 바로 사용할 수 있습니다. Claude에게 “X를 기억해” 또는 “Y를 잊어”라고 말하면 설정으로 이동하지 않아도 Memory가 업데이트됩니다.

한 가지 더 중요한 점이 있습니다. Claude.ai의 프로젝트에는 별도의 메모리가 있습니다.

Claude는 프로젝트마다 별도의 메모리를 만듭니다. 덕분에 제품 출시 계획은 고객 업무와 분리되고, 기밀 논의는 일반적인 업무와 분리됩니다.
— Anthropic, https://www.claude.com/blog/memory

즉, 프로젝트 안의 대화는 일반 Memory로 새어 나가지 않으며 그 반대도 마찬가지입니다.

Claude에게 직접 물어볼 수 있습니다

어떤 채팅에서든 “나에 대해 무엇을 기억하고 있어?”라고 쓰세요. Claude는 이 대화를 위해 기억하는 내용을 나열합니다. Memory 프로필에 무엇이 저장되었는지 확인하는 가장 빠른 방법입니다.

개인정보 보호

Anthropic은 메모리가 계정에 한정된 비공개 정보이며 다른 사용자와 공유되지 않는다고 명시합니다. 기본적으로 Anthropic은 모델 개선을 위해 Memory에 들어간 내용을 포함한 대화를 사용할 수 있습니다. 개인정보 보호 설정의 데이터 제어에서 이 기능을 끌 수 있습니다.

Claude Code의 CLAUDE.md란 무엇이며 Memory와 어떻게 다른가요?

핵심 내용

CLAUDE.md는 프로젝트 루트에 있는 텍스트 파일로, Claude Code가 각 세션을 시작할 때 읽습니다. 어떤 도구를 사용할지, 폴더를 어떻게 구성했는지, 무엇을 하면 안 되는지 등 규칙은 직접 작성합니다. Memory와 달리 자동으로 수집되는 내용은 없습니다. 무엇을 넣을지 직접 결정합니다. 또한 계정 전체에 하나의 파일을 쓰는 것이 아니라 프로젝트마다 별도의 파일을 둡니다.

Memory는 당신이라는 사람에 관한 정보, 즉 스타일과 선호, 직업을 수집합니다. CLAUDE.md는 특정 프로젝트, 즉 이 저장소와 명령, 코드 작업 규칙에 관한 것입니다. 차이는 근본적입니다. Memory는 “나는 대체로 어떤 사람인가”를 정리하고, CLAUDE.md는 “이 작업은 어떻게 구성되어 있는가”를 알려 줍니다.

Claude Code가 CLAUDE.md를 찾는 위치

우선순위가 낮은 곳에서 높은 곳 순서로 네 위치를 동시에 확인합니다.

수준위치여기에 넣을 내용
조직 전체Mac의 /Library/Application Support/ClaudeCode/CLAUDE.md, Linux의 /etc/claude-code/CLAUDE.md팀의 모든 프로젝트에 적용되는 회사 규칙
사용자~/.claude/CLAUDE.md모든 프로젝트에 적용되는 개인 규칙
프로젝트프로젝트 루트의 ./CLAUDE.md프로젝트에 한정되며 git에 커밋하는 기본 파일
로컬./CLAUDE.local.mdgit에 커밋하지 않는 프로젝트 메모

네 파일은 모두 동시에 로드되어 이어 붙습니다. 서로 덮어쓰지 않습니다.

발견된 모든 파일은 서로 덮어쓰는 대신 컨텍스트에 이어 붙습니다. 디렉터리 트리에서는 파일 시스템 루트에서 작업 디렉터리 방향으로 내용이 정렬됩니다.
— Anthropic, https://code.claude.com/docs/en/memory

순서는 넓은 범위에서 좁은 범위로 이어집니다. 프로젝트와 로컬 파일이 마지막에 오므로 컨텍스트 끝부분, 요청에 더 가까운 곳에 놓입니다. 그렇기 때문에 중요한 내용은 모두 프로젝트의 CLAUDE.md에 두어야 합니다.

보통 넣는 내용

  • 프로젝트 기술 스택 — Next.js / Prisma / PostgreSQL / Redis
  • 명령 — 테스트, 빌드, 배포를 실행하는 방법
  • 민감한 경로 — 명시적인 요청 없이는 건드리지 말아야 하는 폴더
  • 규칙 — 커밋 스타일, 파일 이름 형식
  • 비즈니스 규칙 — 프로젝트에서 중요한 사항(예: 가격을 코드에 하드코딩하지 않기)
  • 컨텍스트 안내 — “비즈니스 로직은 docs/business/를, 디자인 시스템은 docs/design/을 참조” (폴더 이름은 원하는 대로 정하면 됩니다. 중요한 것은 모든 내용을 한 파일에 몰아넣지 않는 것입니다.)

전체 설명은 바로 사용할 수 있는 템플릿이 포함된 CLAUDE.md 가이드를 참조하세요.

Memory와 CLAUDE.md의 차이

항목Memory (Claude.ai)CLAUDE.md (Claude Code)
저장 위치Anthropic 클라우드저장소 안의 파일
작성자Claude가 자동으로 작성사용자
연결 대상사용자 계정특정 프로젝트
작동 위치claude.ai + 모바일 앱터미널의 Claude Code
내용 확인 방법설정 → Memory편집기에서 파일 열기
업데이트 방법하루 한 번 Memory Synthesis직접 편집
업데이트 명령Claude에게 말하거나 설정에서 삭제Claude Code에서 /memory

한마디로, Memory는 당신의 머리이고 CLAUDE.md는 사무실 벽에 붙여 놓은 프로젝트 지침입니다.

Claude Code의 Auto Memory란 무엇이며 어디에 저장되나요?

핵심 내용

Auto Memory는 2026년에 나온 Claude Code의 새 기능입니다. 에이전트는 어떤 명령이 작동하는지, 저장소에서 어떤 경로가 민감한지, 어떤 문제를 이미 겪었는지 등 프로젝트에 관한 메모를 로컬 폴더 ~/.claude/projects/[project-name]/memory/에 직접 작성합니다. 규칙을 직접 작성하는 CLAUDE.md와 달리 Auto Memory는 자동으로 채워집니다. 메모 파일은 로컬에 저장되고 선택된 텍스트는 모델 컨텍스트에 로드됩니다. CLAUDE.md를 보완하지만 대체하지는 않습니다.

Auto Memory와 CLAUDE.md의 차이

CLAUDE.md에는 사용자의 지침이 들어갑니다. Auto Memory에는 에이전트가 스스로에게 남기는 메모가 들어갑니다. 서로 다른 유형의 내용입니다.

CLAUDE.md는 직접 작성합니다. “항상 사용자가 선호하는 언어로 답하기”, “npm run deploy로 배포하기”, “legacy/ 폴더를 건드리지 않기” 같은 규칙입니다. 미리 설정하는 규칙입니다.

Auto Memory는 Claude가 작업하면서 알게 된 내용을 담습니다. 패키지가 없어 테스트가 실패하면 Claude는 “이 프로젝트에서는 테스트 전에 npm install을 실행할 것”이라고 기록합니다. 다음 세션에는 같은 실수를 반복하지 않습니다.

저장 위치

각 프로젝트마다 별도의 폴더를 사용하며, 디스크의 로컬에 저장됩니다.

~/.claude/projects/[project-name]/memory/

그 안의 기본 파일은 MEMORY.md입니다. 중요한 점은 Claude Code는 CLAUDE.md를 전부 불러오지만 MEMORY.md에는 제한이 있다는 것입니다. 200줄 또는 25KB 중 먼저 도달하는 기준까지만 로드됩니다. 이렇게 하면 Claude가 몇 달 동안 쌓인 자신의 메모에 파묻히지 않습니다. 메모는 프로젝트 저장소 밖의 로컬 디렉터리에 보관됩니다. 로드된 텍스트는 설정된 모델 서비스로 보내는 대화 컨텍스트에 들어갑니다. 로컬 보관은 오프라인 처리의 약속이 아닙니다. 이 파일에 비밀 정보를 넣지 마세요.

작동 조건

Auto Memory는 v2.1.59+부터 Claude Code에서 작동하며 새로 설치한 경우 기본적으로 활성화되어 있습니다. 상태를 확인하고 관리하려면 다음 명령을 사용하세요.

/memory

이 명령은 CLAUDE.md와 MEMORY.md를 포함한 모든 메모리 계층을 편집기로 엽니다. Auto Memory도 그중 하나입니다. Claude가 프로젝트에 관해 이미 기록한 내용을 확인하고, 수정하거나 지울 수 있습니다. Auto Memory를 완전히 비활성화하려면 ~/.claude/settings.json에서 autoMemoryEnabled: false를 설정하거나 환경 변수 CLAUDE_CODE_DISABLE_AUTO_MEMORY=1을 사용하세요.

보통 기록되는 내용

  • 작동했거나 실패한 명령
  • 에이전트가 파악한 프로젝트 구조
  • 발견한 안티패턴
  • 주요 파일과 함수 이름

Anthropic의 공식 Claude Code 문서는 차이를 다음과 같이 설명합니다.

CLAUDE.md 파일: Claude에 지속적인 컨텍스트를 제공하기 위해 사용자가 작성하는 지침. Auto memory: 사용자의 수정과 선호를 바탕으로 Claude가 직접 작성하는 메모.
— Anthropic, https://code.claude.com/docs/en/memory

다시 말해, CLAUDE.md = 사용자가 작성하는 지침. Auto Memory = 사용자의 수정과 선호를 바탕으로 Claude가 스스로에게 남기는 메모입니다.

Memory와 CLAUDE.md: 어떤 시스템이 어떤 작업을 맡을까요?

핵심 내용

claude.ai 브라우저에서 작업한다면 Claude가 사용자인 당신을 기억하도록 Memory가 필요합니다. Claude Code에서 프로젝트를 작업한다면 Claude가 프로젝트 규칙을 기억하도록 CLAUDE.md가 필요하고, Auto Memory가 보조 계층으로 작동합니다. 이 시스템들은 경쟁 관계가 아닙니다. 서로 다른 제품에서 서로 다른 문제를 해결합니다. Memory는 Claude Code로 이어지지 않고 CLAUDE.md는 claude.ai에서 작동하지 않습니다.

선택 기준표

상황활성화할 항목
브라우저에서 Claude와 여러 주제로 대화함Memory
터미널에서 Claude Code로 한 프로젝트를 작업함CLAUDE.md (기본) + Auto Memory (보조)
Claude Code에서 여러 프로젝트를 작업함각 프로젝트의 CLAUDE.md + Auto Memory
코드에서 API로 Claude를 사용함둘 다 작동하지 않음 — 시스템 프롬프트에 규칙을 직접 추가
Claude가 내 글쓰기 스타일을 기억하길 원함Claude.ai의 Memory
Claude가 프로젝트 구조를 기억하길 원함프로젝트의 CLAUDE.md

Memory와 CLAUDE.md는 서로 중복되지 않습니다. 서로 다른 제품에서 작동하며 서로 다른 정보를 저장합니다. 개인 일정표와 회사 정책처럼 둘 다 유용하지만 아무도 둘을 혼동하지 않습니다.

Memory를 활성화할 때: 실제로 도움이 되는 세 가지 상황

핵심 내용

claude.ai의 Memory는 세 가지 업무 상황에서 유용합니다. 다양한 주제로 자주 이야기하며 매번 자기소개하고 싶지 않을 때, 같은 스타일의 짧은 글을 많이 쓸 때, 또는 Claude가 내 역할에 관한 맥락을 기억해야 할 때입니다. 주로 Claude Code로 작업한다면 Memory는 필요하지 않습니다. 그곳에서는 작동하지 않기 때문입니다.

상황 1. claude.ai를 개인 비서로 사용합니다

매일 Claude에게 이메일을 다시 써 달라고 하거나, 스프레드시트를 분석해 달라고 하거나, 아이디어를 내 달라고 합니다. 주제는 달라도 당신은 같은 사람입니다. Memory를 쓰면 “안녕하세요, 저는 마케터이고 온라인 프로젝트를 운영합니다. 제가 좋아하는 답변 스타일은 이렇습니다”라고 말할 필요가 없습니다.

일주일 정도 사용하면 Claude는 당신의 직업, 답변 형식, 선호하는 형식과 길이, 어조를 알게 됩니다. 새 채팅은 매번 이 정보를 바탕으로 시작합니다. 대화마다 30~60초를 절약할 수 있습니다.

상황 2. 같은 스타일로 콘텐츠를 많이 작성합니다

광고, 소셜 미디어 게시물, 이메일 뉴스레터 등 같은 브랜드 보이스가 필요한 글을 씁니다. Memory는 어떤 단어를 피해야 하는지, 어떤 어조를 쓸지, 문단을 얼마나 길게 쓸지 등 당신의 스타일을 익힙니다.

2주 정도에 걸쳐 한 번 Claude에게 “우리 글에는 em dash를 쓰지 말고, 친근한 어조로, 문단은 3개를 넘지 않게 써”라고 말해 보세요. 이 내용이 기록됩니다. 그러면 이후 새 글은 별도의 알림 없이도 당신의 스타일에 맞춰 작성됩니다.

상황 3. 역할에 관한 맥락이 필요합니다

Photoshop이 아니라 Figma + Sketch를 사용하는 특정 스택의 디자이너라고 해 봅시다. 또는 이커머스가 아니라 SaaS 제품 관리자라고 해 봅시다.

Memory는 역할 맥락을 파악하고 답변을 자동으로 조정합니다. 일반적인 답변은 줄어들고, 실제 업무에 맞는 답변이 늘어납니다.

Memory가 필요하지 않은 경우

주로 터미널의 Claude Code를 사용한다면 Memory는 아무런 도움이 되지 않습니다. 그곳에서는 작동하지 않습니다. 대신 CLAUDE.md를 사용하고 두 시스템을 혼동하지 마세요.

코드에서 API로 Claude를 사용하는 경우에도 마찬가지로 작동하지 않습니다. 시스템 프롬프트에 지침을 직접 추가하세요.

한 종류의 작업만 하고 매번 채팅 시작에 맥락을 반복해도 괜찮다면 Memory는 필수적이지 않습니다. 편의를 위한 기능이지 필수 요건은 아닙니다.

CLAUDE.md에는 무엇을 넣고, Auto Memory는 무엇을 자동으로 기록하나요?

핵심 내용

세션마다 바뀌지 않는 안정적인 규칙, 즉 기술 스택과 규칙, 민감한 경로, 비즈니스 로직은 CLAUDE.md에 넣으세요. Auto Memory는 어떤 명령이 작동했는지, 어디에 문제가 있는지, 프로젝트 구조가 어떤지 등 달라지는 세부 사항을 자동으로 수집합니다. 간단한 기준은 이렇습니다. 예외 없이 항상 지켜야 하는 것은 CLAUDE.md에 넣습니다. Claude가 작업하면서 익힐 수 있는 것은 Auto Memory에 맡겨도 됩니다.

CLAUDE.md에 반드시 넣을 내용

  1. 한 문단으로 된 프로젝트 설명 — 프로젝트가 무엇인지, 누구를 위한 것인지, 왜 필요한지.
  2. 프로젝트 기술 — 사용하는 프레임워크, 라이브러리, 데이터베이스.
  3. 명령 — 테스트, 빌드, 게시에 사용하는 정확한 명령.
  4. 민감한 디렉터리 — 명시적인 요청 없이 건드리면 안 되는 곳.
  5. 규칙 — 커밋 스타일, 파일 이름 형식, 답변 언어.
  6. 컨텍스트 안내 — 예: “비즈니스 로직은 docs/business/에, 디자인은 docs/design/에 있습니다.” 폴더 이름은 원하는 대로 정하면 됩니다.

Auto Memory에 맡길 내용

  1. 로컬 환경 세부 사항 — 이 컴퓨터에서 Python은 /usr/local/bin/python3.11에 있습니다.
  2. 프로젝트 변경 사항 — 어제 어떤 명령이 실패했고 이유가 무엇이었는지.
  3. 중간에 알아낸 내용 — 특정 모듈의 테스트가 어디에 있는지.
  4. 작업 흐름 팁 — 각 단계 다음에 어떤 스크립트를 실행할지.

어느 쪽에도 넣으면 안 되는 내용

  • API 키, 비밀번호, 토큰 — 메모리 파일이 아니라 .env에 보관합니다.
  • 고객의 개인정보.
  • 가격, 기수 날짜, 임시 캠페인처럼 곧 오래된 정보가 될 수 있는 내용.
  • 일회성 작업을 위한 프롬프트 — 컨텍스트만 복잡하게 만듭니다.

200줄 규칙

Anthropic은 문서에서 CLAUDE.md를 약 100–200줄로 유지할 것을 권장합니다. 200줄을 넘으면 Claude가 내용을 덜 효과적으로 읽기 시작합니다. 긴 컨텍스트는 리소스를 사용하고 정확도를 떨어뜨립니다. 파일이 길어지면 일부 내용을 가까운 별도의 .md 파일로 옮기고 CLAUDE.md에는 “코드 스타일은 docs/code-style.md 참조”처럼 짧은 안내를 남기세요.

파일 구조를 자세히 설명한 내용은 Claude Code의 second brain 가이드를 참조하세요. CLAUDE.md에서 시작해 컨텍스트를 위한 다섯 개의 폴더로 구조를 확장하는 방법을 설명합니다.

Claude 메모리 설정을 망가뜨리는 실수 5가지와 예방법은 무엇인가요?

핵심 내용

2026년 Claude 메모리를 사용할 때 흔한 실수는 Memory와 CLAUDE.md를 혼동하는 것, 파일 이름의 대소문자를 잊는 것, 지나치게 큰 CLAUDE.md를 유지하는 것, 그 안에 비밀 정보를 넣는 것, Auto Memory가 머릿속에만 있는 내용을 알아서 기록하리라 기대하는 것입니다. 각 실수는 설정을 서로 다른 방식으로 망가뜨리며, 실제 문제는 설정에 있는데도 Claude가 “멍청하다”고 느끼게 만듭니다.

실수 1. Memory와 CLAUDE.md를 혼동하기

가장 흔한 실수입니다. 누군가 “Claude가 이제 기억한다”는 말을 듣고 claude.ai에서 Memory를 활성화한 뒤, 터미널에서 Claude Code를 열고 에이전트가 왜 또 “잊어버렸는지” 의아해합니다.

claude.ai의 Memory는 Claude Code로 이어지지 않습니다. 서로 다른 아키텍처를 사용하는 별개의 제품입니다. 터미널에서 Claude가 프로젝트를 기억하게 하려면 CLAUDE.md를 작성하세요. 브라우저에서 Claude가 당신을 기억하게 하려면 Memory를 활성화하세요.

예방법. 메모리를 설정하기 전에 주로 어디에서 작업하는지 정하세요. claude.ai라면 Memory를 사용하세요. Claude Code라면 CLAUDE.md와 Auto Memory를 사용하세요. 둘 다 사용한다면 두 시스템을 결합하려 하지 말고 각각 설정하세요.

실수 2. 파일 이름은 대소문자를 구분한다는 점을 잊기

CLAUDE.md는 대소문자를 구분하는 파일 이름입니다. 대문자를 사용한 CLAUDE.md는 에이전트가 읽습니다. claude.md와 Claude.md는 읽지 않습니다. CLAUDE.local.md도 마찬가지입니다. Claude Code를 처음 설정하는 사람들이 흔히 겪는 문제입니다. 파일을 만들고 지침을 작성한 뒤 작동하지 않는 이유를 고민하지만, 파일 이름이 소문자였던 것입니다.

예방법. 저장하기 전에 대소문자를 확인하세요. Mac에서는 Finder에서 파일을 선택하고 Enter를 누르면 전체 이름을 볼 수 있습니다. 터미널에서는 ls -la CLAUDE*를 실행하세요. claude.md로 표시되면 mv claude.md CLAUDE.md로 이름을 바꾸세요.

실수 3. CLAUDE.md가 800줄로 늘어남

완성된 템플릿을 받아 중요해 보이는 규칙을 모두 추가하다 보면 800줄짜리 파일이 됩니다. Claude가 읽는 데 더 오래 걸리고 답변 품질은 떨어집니다. 긴 컨텍스트는 모델의 주의를 소모합니다.

예방법. CLAUDE.md를 100–200줄 정도로 유지하세요. 200줄을 넘으면 일부 내용을 별도의 .md 파일로 옮기고 CLAUDE.md에 “코드 스타일은 docs/code-style.md 참조”와 같은 안내를 남기세요. 사람을 위한 문서와 마찬가지로 모든 내용을 한 파일에 몰아넣지 마세요.

실수 4. CLAUDE.md나 Auto Memory에 비밀 정보를 보관하기

API 키, 비밀번호, 토큰은 메모리 파일에 넣으면 안 됩니다. 보통 CLAUDE.md는 git에 커밋되므로 비밀 정보가 저장소에 유출됩니다. Auto Memory는 로컬에 저장되지만 스크린샷이나 공유 대화에 드러나거나, 디스크에 접근할 수 있는 MCP 서버를 통해 유출될 수 있습니다.

예방법. 비밀 정보는 .env에 보관하고 .gitignore에 .env를 추가하세요. CLAUDE.md에는 변수 이름만 언급하세요. “API 키는 STRIPE_KEY에 있으며 .env에서 가져올 것.”

실수 5. Auto Memory가 비즈니스 로직을 저절로 파악하리라 기대하기

Auto Memory는 명령과 오류, 구조 같은 기술적 관찰을 수집합니다. “부동산 중개업체에서는 특정 기준 미만의 주문을 받지 말 것”이나 “글에서 특정 어휘를 사용하지 말 것” 같은 비즈니스 규칙을 저절로 익히지는 않습니다. 이런 내용은 CLAUDE.md나 CLAUDE.md에서 참조하는 별도의 .md 파일에 넣어야 합니다.

예방법. 내용을 분리하세요. 기술적 세부 사항은 Auto Memory가 자동으로 수집합니다. 비즈니스 규칙과 스타일, 관례는 CLAUDE.md에 직접 넣으세요. 한쪽이 다른 쪽을 대체하리라 기대하지 마세요.

저녁 시간에 Memory + CLAUDE.md를 설정하는 방법은? (단계별 안내)

핵심 내용

전체 구성을 30–40분 안에 설정할 수 있습니다. Claude.ai에서 Memory를 활성화하고, 프로젝트에 CLAUDE.md를 만들고, Auto Memory가 작동하는지 확인하세요. 그다음 직접 다듬어 나가면 됩니다. 에이전트가 실수할 때마다 CLAUDE.md에 “이렇게 하지 말 것”이라는 문장 한 줄을 추가하세요. 한 달 뒤에는 계속 발전하는 “프로젝트 헌장”이 생깁니다.

  1. Claude.ai에서 Memory를 활성화합니다. 설정 → 기능 → Memory를 엽니다. 토글을 켭니다. 개인정보 보호 설정도 바로 확인하세요. Anthropic이 모델 학습을 위해 대화를 사용하도록 허용할지 결정합니다. 선택은 사용자에게 달려 있습니다.

  2. Claude에게 자신에 대해 이야기합니다. 다음 2–3개 채팅에서 자신이 누구인지, 무엇을 하는지, 어떤 답변 스타일을 선호하는지 말해 주세요. Memory Synthesis는 하루 안에 이를 기록합니다.

  3. 다음 날 기록된 내용을 확인합니다. 아무 채팅에서나 “나에 대해 무엇을 기억하고 있어?”라고 입력하세요. Claude가 기억하는 내용을 나열합니다. 마음에 들지 않는 것이 있다면 설정 → Memory에서 삭제하거나 Claude에게 잊으라고 하세요.

  4. 프로젝트에 CLAUDE.md를 만듭니다. 주요 프로젝트의 루트에 대문자를 사용한 CLAUDE.md 파일을 만드세요. CLAUDE.md 가이드에서 완성된 템플릿을 가져오세요. 템플릿은 6개 섹션으로 구성되어 있으며 Anthropic 권장 분량은 약 200줄입니다.

  5. 프로젝트에 맞게 섹션을 채웁니다. 기술 스택과 명령, 민감한 경로, 규칙을 설명하세요. 200줄을 넘기지 마세요. 그 이상이면 Claude가 내용을 덜 효과적으로 읽습니다.

  6. Auto Memory를 확인합니다. Claude Code에서 /memory 명령을 입력하세요. 모든 계층을 편집할 수 있는 편집기가 열립니다. Auto Memory도 그중 하나입니다. Claude가 프로젝트에 관해 이미 알고 있는 내용을 읽어 보세요.

  7. CLAUDE.md를 git에 커밋합니다. 이 파일은 프로젝트의 일부입니다. 팀으로 작업한다면 모두가 규칙을 확인할 수 있습니다.

  8. 평소처럼 계속 작업합니다. 에이전트가 실수할 때마다 CLAUDE.md에 “이렇게 하지 말 것”이라는 문장 한 줄을 추가하세요. 한 달 뒤에는 계속 발전하는 규칙 모음이 생기고 Claude는 익숙한 함정에 빠지지 않게 됩니다.

작동하지 않는 것: Claude 메모리가 유지하지 못하는 패턴 3가지

핵심 내용

세 가지 Claude 메모리 시스템 모두 모델을 전환할 때 현재 세션을 유지하지 못하고, 에이전트에게 명시적으로 보여 주지 않은 파일의 컨텍스트를 불러오지 못하며, 음성이나 휴대전화로 전달한 비공개 명령도 보존하지 않습니다. 이는 버그가 아니라 아키텍처상의 한계입니다. 이를 알아 두면 실망을 피하는 데 도움이 됩니다.

모델을 전환하면 세션 상태가 유지되지 않습니다

Claude Code에서 Opus 4.8로 작업하다가 Sonnet 4.6으로 전환하면 모델마다 컨텍스트 창이 다르기 때문에 세션 컨텍스트가 초기화될 수 있습니다. 새 세션에서 CLAUDE.md와 Auto Memory는 자동으로 로드되지만 진행 중인 논의는 이어지지 않습니다.

보여 주지 않은 파일은 로드되지 않습니다

Claude가 볼 수 있는 것은 CLAUDE.md에 있는 내용, Auto Memory에 있는 내용, 현재 세션에서 직접 연 내용뿐입니다. 프로젝트에 파일이 500개 있는데 “결제 처리를 어떻게 하는지 살펴봐”라고 쓰면 에이전트는 어떤 파일을 봐야 하는지 모릅니다. 경로를 직접 알려 주거나 CLAUDE.md에 안내를 추가해야 합니다.

API를 통한 일회성 대화에서는 Memory가 작동하지 않습니다

Claude API에 보내는 요청은 각각 독립적입니다. 메모리는 로드되지 않습니다. API를 통해 챗봇을 만들면 시스템 프롬프트와 메시지 기록을 직접 전달해야 합니다. Memory, CLAUDE.md, Auto Memory는 이 작업에 도움이 되지 않습니다.

다음 단계: Second Brain의 시작점인 메모리

핵심 내용

Claude 메모리는 프로젝트를 중심으로 Second Brain을 구축하는 첫 단계입니다. CLAUDE.md는 규칙을 정하고 Auto Memory는 기술적 변화를 모읍니다. 여기에 대상 고객과 경제성, 제품 같은 비즈니스 맥락의 폴더를 더할 때 진정한 가치가 생깁니다. 그러면 Claude는 특정 업무에 맞는 “전반적으로 품질 높은 해결책”을 작성하기 시작합니다.

CLAUDE.md와 Auto Memory는 코드가 어떻게 구성되어 있는지 Claude에게 알려 줍니다. 리팩터링과 버그 수정, 마이그레이션, 테스트 같은 기술 작업에는 충분합니다.

하지만 누구에게 이메일을 보낼지, 제안을 어떻게 표현할지, 가격을 얼마로 정할지 등 비즈니스 결정을 내려야 하면 기술 메모리만으로는 부족합니다. 고객이 누구인지, 어떻게 의사결정을 하는지, 사업의 경제성이 어떻게 작동하는지에 관한 맥락이 필요합니다.

이것이 Second Brain입니다. 프로젝트 옆에 두는 비즈니스 지식 폴더로, Claude는 CLAUDE.md의 안내를 통해 여기에 접근합니다. 코드에 관한 메모리와 비즈니스에 관한 메모리를 결합하면 에이전트는 “환각하는 똑똑한 어시스턴트”에서 당신의 공동 작성자로 바뀝니다.

출처

ailoot.ai에서 Ailoot를 계속 살펴보세요.

자세히 보기

Claude Memory: Memory, CLAUDE.md, Auto Memory: 자주 묻는 질문

Claude.ai에서 Memory를 켜도 터미널 프로젝트 맥락이 복원되지 않는 이유는 무엇인가요?

Claude.ai Memory와 Claude Code의 프로젝트 파일은 별도 시스템입니다. Claude Code에는 CLAUDE.md로 프로젝트 지침을 제공하고 별도의 Auto Memory 메모는 /memory로 확인하세요.

Auto Memory는 로컬 파일이므로 API 키를 저장해도 안전한가요?

아닙니다. 로드된 메모는 모델 컨텍스트가 되고 디스크 접근 도구가 읽을 수도 있습니다. Auto Memory와 CLAUDE.md 모두에 키와 비밀번호를 넣지 마세요. 비밀 정보는 따로 보관하고 변수 이름만 문서화하세요.

모든 글