Claude Code 자동 메모리란? AI가 이전 코딩 작업을 기억하는 원리와 확인법

AI에게 “지난번에 만든 홈페이지에서 버튼 색깔은 파란색으로 통일했잖아”라고 매번 다시 설명한다면 번거롭겠죠. 프로젝트가 커질수록 어떤 명령으로 실행했는지, 어떤 오류를 어떻게 고쳤는지 다시 찾아보는 일도 많아집니다. Claude Code의 자동 메모리(Auto Memory)는 작업 중 발견한 유용한 정보를 Claude가 직접 메모 파일에 기록하고, 나중에 같은 프로젝트에서 참고하는 기능입니다. 어렵게 생각하지 않아도 됩니다. 사람이 쓰는 업무 인수인계 노트를 AI가 스스로 정리해 두는 것과 비슷합니다. 다만 사람의 기억이나 완벽한 데이터베이스는 아닙니다. 저장하지 않은 사실까지 알아서 영원히 기억하지도 않습니다. 이 글에서는 자동 메모리라는 용어 하나에 집중해 무엇을 기억하는지, 파일은 어디에 있는지, 내가 어떻게 확인하고 고칠 수 있는지를 차례대로 알아봅니다.

기준일: 2026년 10월 17일. 기능과 메뉴는 Claude Code 업데이트에 따라 달라질 수 있습니다. 이 글의 예시는 공식 문서를 바탕으로 한 설명용 가상 사례이며, 특정 계정에서 직접 실행한 결과는 아닙니다.

Claude Code 자동 메모리가 작업 중 배운 내용을 파일에 저장하고 다음 세션에 활용하는 개념도 · 자체 제작 개념도, 실제 제품 화면 캡처가 아닙니다.

이 글의 순서

1. 자동 메모리는 왜 필요할까요?
2. 사람이 작성하는 CLAUDE.md 와 무엇이 다를까요?
3. 자동 메모리는 어디에 저장될까요?
4. 다음 대화에서는 메모리 전체를 전부 읽나요?
5. 실제로 어떤 정보를 기록할 수 있을까요?
6. 자동 메모리를 내가 확인하는 방법
7. 자동 메모리 내용을 직접 수정하거나 끌 수 있나요?
8. 여러 프로젝트나 다른 컴퓨터에서도 기억이 공유될까요?
9. 잘못된 내용이 기억되면 어떡하죠?
10. 비밀번호나 API 키도 기억시키면 편리하지 않을까요?
11. 자동 메모리를 잘 활용하는 간단한 습관
12. 자주 묻는 질문(FAQ)
핵심 정리
함께 보면 좋은 글

1. 자동 메모리는 왜 필요할까요?

Claude Code에서 대화를 새로 시작하면, 지난 대화 내용 전체가 언제나 현재 대화에 그대로 들어오는 것은 아닙니다. 그런데 작업에 꼭 필요한 사실은 다음에도 반복해서 쓰일 수 있습니다. 예를 들어 가상의 블로그 웹사이트를 만든다고 해볼까요?

이 프로젝트는 npm run dev로 개발 화면을 엽니다.
모바일 화면은 390px 너비에서도 확인해야 합니다.
지난번 버튼이 눌리지 않았던 원인은 이벤트 연결 누락이었습니다.
파일을 수정한 뒤에는 테스트 결과를 반드시 확인합니다. 이 중 일부는 앞으로도 도움이 될 만한 정보입니다. 자동 메모리가 활성화된 Claude Code는 필요한 경우 이런 사실을 메모로 남겨 다음 작업에 활용할 수 있습니다. 단, 매 대화마다 반드시 메모가 하나씩 만들어지는 것은 아닙니다. Claude가 미래에 유용하다고 판단한 정보를 선택해 기록합니다.

2. 사람이 작성하는 CLAUDE.md와 무엇이 다를까요?

헷갈리기 쉬운 핵심 차이를 먼저 구분해 보겠습니다.

비교	`CLAUDE.md`	자동 메모리
누가 작성할까요?	사용자·팀	Claude가 작업하면서 작성
주된 내용	반드시 지켜 달라고 명시한 프로젝트 규칙	문제 해결 경험·프로젝트에서 발견한 정보
대표 사례	“모바일 화면도 검토하라”	“이 프로젝트는 특정 테스트 명령을 쓴다”
성격	사람이 관리하는 작업 지침	AI가 축적하는 참고 노트
한계	규칙 작성만으로 동작이 강제되지는 않음	내용이 틀리거나 오래될 수 있음

가장 쉬운 구별법은 “해야 할 일”은 사람이 작성한 지침으로, “해 보니 알게 된 사실”은 자동 메모리로 관리한다고 생각하는 것입니다. 예를 들어 “배포 전에는 반드시 내 승인을 받아라”라는 중요한 운영 규칙은 자동으로 기억되기만 기다리기보다 사용자가 CLAUDE.md에 명확히 작성하는 편이 적절합니다. 그리고 실제 명령 실행 차단은 별도의 도구 권한·훅·승인 설정으로 보호해야 합니다.

3. 자동 메모리는 어디에 저장될까요?

Anthropic의 공식 설명에 따르면 일반적인 자동 메모리 저장 위치는 다음 구조입니다.

~/.claude/projects/<project>/memory/
├── MEMORY.md
├── debugging.md
└── api-conventions.md

여기서 ~는 내 컴퓨터의 사용자 홈 폴더를 가리킵니다. <project> 부분은 프로젝트를 구분하는 내부 경로이며, 정확한 이름은 환경에 따라 달라질 수 있습니다. 파일별 역할은 이렇게 이해하면 됩니다.

MEMORY.md: 메모리 폴더의 요약·색인 역할을 하는 첫 번째 문서.
debugging.md: 반복 오류와 해결 요령 같은 세부 주제를 적어 둘 수 있는 파일.
api-conventions.md: 프로젝트의 API 작성 관례 같은 별도 주제 파일의 예시. 두 번째와 세 번째 파일명은 설명용 사례입니다. 모든 프로젝트에 반드시 똑같은 파일들이 존재하는 것은 아닙니다. 중요한 사실은 자동 메모리가 읽고 편집할 수 있는 Markdown 파일이라는 점입니다. Claude가 알아서 쓴 메모라도 사용자가 내용을 살펴보고 고칠 수 있습니다.

4. 다음 대화에서는 메모리 전체를 전부 읽나요?

아닙니다. 공식 문서는 대화 시작 때 MEMORY.md의 앞 200줄 또는 25KB 중 먼저 도달하는 한계까지 로드한다고 설명합니다. 그래서 Claude는 중요한 정보를 짧은 색인에 정리하고, 자세한 내용은 별도의 주제 파일로 나눌 수 있습니다. debugging.md 같은 자세한 파일은 필요할 때 추가로 읽는 방식입니다. 초보자가 꼭 이해해야 할 부분은 다음입니다. 파일에 적혀 있다는 사실과, 지금 이 순간 AI가 그 내용을 읽었다는 사실은 다릅니다. 메모리 파일이 너무 길거나 주제 파일을 읽지 않았다면 원하는 정보가 현재 대화에 반영되지 않을 수 있습니다. 또한 자동 메모리는 디스크에 정보를 보관하는 방식이지, 대화의 모든 토큰을 영구 보존하거나 과거의 모든 발언을 그대로 재생하는 장치가 아닙니다.

5. 실제로 어떤 정보를 기록할 수 있을까요?

교육용 가상 프로젝트를 하나 만들어 보겠습니다. 프로젝트 이름은 '초보자 할 일 목록'입니다. 첫 번째 작업에서 사용자는 Claude에게 “버튼을 눌렀는데 할 일이 추가되지 않는다”고 말합니다. Claude는 파일을 살펴보고 원인을 분석합니다. 예를 들어 이벤트 연결이 빠져 있었다고 합시다. 작업이 끝난 뒤 Claude가 앞으로도 유용하다고 판단한다면 다음과 같은 내용을 자동 메모리에 남길 수 있습니다.

- 개발 화면 실행: npm run dev
- 할 일 추가 버튼: 클릭 이벤트 연결 상태를 먼저 확인
- 모바일 확인 기준: 390px 화면

두 번째 작업에서 사용자가 “이번에는 삭제 버튼을 추가해 줘”라고 요청합니다. Claude가 관련 메모를 읽었다면 프로젝트 실행 방법과 이전 문제의 맥락을 참고할 수 있습니다. 하지만 여기서 “자동 메모리가 무조건 이렇게 작성된다”는 뜻은 아닙니다. 위 내용은 기능을 이해하기 위한 가상 예시이며 실제 Claude Code 실행 결과를 캡처한 것이 아닙니다. 이 기능의 가치는 반복 설명을 줄일 가능성에 있습니다. 메모리가 정확히 저장됐는지, 다음 작업에 제대로 적용되는지는 별도로 확인해야 합니다.

6. 자동 메모리를 내가 확인하는 방법

Claude Code 세션을 사용하고 있다면 Claude Code 세션 입력창에 /memory를 입력할 수 있습니다. 이것은 일반 운영체제 터미널에 그대로 입력하는 셸 명령이 아니라, Claude Code 안에서 쓰는 내장 명령입니다. 공식 문서 기준으로 /memory에서는 메모리 관련 파일을 찾아 열고, 자동 메모리 기능을 켜거나 끄고, 메모리 폴더에 접근할 수 있습니다. 확인 순서는 어렵지 않습니다.

Claude Code에서 본인이 확인할 프로젝트를 엽니다.
세션 입력창에서 /memory를 사용합니다.
자동 메모리 파일 또는 폴더를 여는 항목을 확인합니다.
MEMORY.md에 실제로 어떤 내용이 기록돼 있는지 읽습니다.
오래된 명령, 잘못된 경로, 공개하면 안 되는 정보가 없는지 검토합니다. 파일 목록을 본 것만으로 현재 대화에 파일이 로드됐다고 단정하면 안 됩니다. /context는 시작 시 로드된 CLAUDE.md와 규칙 파일을 확인할 때 사용하고, 자동 메모리 파일은 /memory에서 실제로 열어 확인하세요.

7. 자동 메모리 내용을 직접 수정하거나 끌 수 있나요?

네. 자동 메모리 파일은 일반적인 텍스트 파일이므로 사용자가 읽고 편집하거나 삭제할 수 있습니다. 예를 들어 메모리에 “프로젝트 실행 명령은 npm start”라고 적혀 있지만 현재 실제 명령은 npm run dev라면, 확인한 사실에 맞게 수정할 수 있습니다. 정확한 실행 명령을 확인하지 않은 상태에서 추측으로 고쳐서는 안 됩니다. 자동 메모리를 잠시 사용하지 않고 싶다면 /memory의 설정 항목에서 기능 상태를 확인하거나 프로젝트 설정에서 autoMemoryEnabled를 비활성화할 수 있습니다.

{
  "autoMemoryEnabled": false
}

위 설정은 자동 메모리 비활성화의 예시입니다. 실제 설정 파일의 위치와 적용 범위는 사용자·프로젝트·관리 정책에 따라 달라집니다. 또한 기능을 끄는 것과 기존 메모리 파일을 삭제하는 것은 서로 다른 작업입니다. 기록 삭제나 수정 전에 필요한 정보가 아닌지 확인하고, 회사 프로젝트라면 팀 규칙도 검토하세요.

8. 여러 프로젝트나 다른 컴퓨터에서도 기억이 공유될까요?

자동 메모리 범위를 이해하는 것도 중요합니다. 공식 문서에 따르면 자동 메모리는 일반적으로 Git 저장소 단위로 분리됩니다. 같은 저장소의 하위 디렉터리나 Git worktree에서는 자동 메모리 폴더를 공유할 수 있습니다. 반대로 서로 다른 저장소는 보통 다른 자동 메모리 영역을 사용합니다. 다른 컴퓨터나 별도의 클라우드 작업 환경으로 자동 동기화되는 기능으로 가정해서도 안 됩니다. 자동 메모리는 기본적으로 컴퓨터에 저장되는 자료입니다. 따라서 “집 컴퓨터에서 Claude가 기억했으니 회사 PC에서도 당연히 기억하겠지”라고 기대하면 안 됩니다. 장치·실행 환경·저장소가 달라졌다면 실제 메모리 위치와 내용을 다시 확인해야 합니다.

9. 잘못된 내용이 기억되면 어떡하죠?

자동 메모리에서 주의할 점은 기억의 정확성입니다. AI가 오래된 명령을 적어 두거나, 일회성 문제를 모든 작업에 적용되는 규칙으로 착각할 수 있습니다. 메모리 문장이 그럴듯하다고 해서 실제 프로젝트 상태까지 보증하는 것은 아닙니다. 예를 들어 지난주에는 Node.js 20 버전이 필요했지만 오늘 프로젝트 구성이 달라졌다면, 예전 메모의 버전 정보는 다시 검증해야 합니다. 불일치를 발견했다면 실제 프로젝트 파일이나 명령 결과를 먼저 확인하고, 해당 메모를 정정하는 편이 안전합니다. 자동 메모리를 무조건 신뢰해 자동 배포하거나 큰 파일을 삭제하도록 두어서는 안 됩니다. 특히 중요 명령 실행·파일 수정·외부 전송·배포에는 도구 권한 설정, 사람의 승인, 테스트, 백업이 별도로 필요합니다.

10. 비밀번호나 API 키도 기억시키면 편리하지 않을까요?

권장하지 않습니다. 자동 메모리는 일반 Markdown 파일이므로 누가 해당 파일에 접근할 수 있는지와 어떤 프로그램이 읽는지를 고려해야 합니다. 다음 정보는 자동 메모리나 지침 파일에 그대로 보관하지 않는 것이 좋습니다.

로그인 비밀번호, API 키, 인증 토큰 등 실제 비밀정보
고객·동료의 개인정보나 비공개 자료
외부 서비스의 관리자 접근 정보를 담은 내용
공개 저장소에 포함되면 곤란한 내부 문서의 원문 민감한 설정은 프로젝트의 보안 정책에 맞는 자격증명 보관·환경변수·권한 제어 기능을 사용하세요. “AI에게 기억하지 말라고 했으니 안전하다”는 생각만으로 보안을 확보할 수는 없습니다.

11. 자동 메모리를 잘 활용하는 간단한 습관

가장 실용적인 방법은 중요한 정보는 짧게, 사실과 규칙은 분리하고, 필요할 때 실제 파일을 확인하는 것입니다. 프로젝트가 바뀌었다면 메모리를 다시 읽어 보고, 잘못된 기록을 업데이트하세요. 같은 오류를 반복해서 겪는다면 “지난번 해결 방법이 유효한지 확인해 줘”처럼 검증을 요청하는 것도 좋습니다. 무엇보다 자동 메모리를 모든 대화의 완벽한 보관소로 기대하지 마세요. 자동 메모리는 Claude가 다음 작업을 더 잘 이해하도록 돕는 참고 자료입니다.

12. 자주 묻는 질문(FAQ)

Q1. Claude Code는 모든 대화를 자동으로 저장하나요?

아닙니다. 자동 메모리는 대화 내용을 통째로 녹화하는 기능이 아닙니다. 미래에 유용하다고 판단한 정보를 선택적으로 기록할 수 있습니다.

Q2. 자동 메모리는 매번 새로 생기나요?

반드시 그렇지는 않습니다. Claude가 별도로 남길 가치가 있다고 판단하지 않으면 해당 세션에서 새 메모를 만들지 않을 수 있습니다.

Q3. 메모리 파일이 있으면 Claude가 내용을 전부 읽나요?

아닙니다. MEMORY.md에는 초기 로드 제한이 있고, 세부 파일은 필요할 때 읽을 수 있습니다. 현재 로드된 내용을 따로 확인해야 합니다.

Q4. 이전 대화를 지우면 자동 메모리도 모두 없어지나요?

같은 동작이라고 단정할 수 없습니다. 자동 메모리는 별도 로컬 파일입니다. 대화 기록과 메모리 파일, 백업은 서로 다른 저장 대상입니다.

Q5. ChatGPT의 메모리와 같은 기능인가요?

아닙니다. 여기서 설명하는 자동 메모리는 Claude Code의 프로젝트용 로컬 메모리입니다. 다른 AI 서비스의 계정 메모리 기능과 저장 위치나 관리 방법을 혼동하면 안 됩니다.

Q6. 직접 '이건 기억해 줘'라고 말해도 되나요?

Claude Code 공식 문서는 사용자가 지속해서 기억할 사항을 요청할 수 있다고 설명합니다. 다만 요청을 했다는 사실과 파일에 정확히 저장됐다는 사실은 다르므로 /memory에서 실제 기록을 확인하세요.

Q7. 메모리를 끄면 기존 파일도 자동 삭제되나요?

비활성화와 파일 삭제는 별개의 개념입니다. 중요한 파일이 남아 있는지 직접 확인해야 합니다.

Q8. 자동 메모리만 있으면 테스트를 안 해도 되나요?

아닙니다. 메모리는 과거 정보를 참고하는 수단일 뿐입니다. 실제 프로젝트의 정상 작동 여부는 별도로 확인해야 합니다.

핵심 정리

Claude Code 자동 메모리는 AI가 프로젝트 작업 중 배운 내용을 파일에 적어 두고 다음에 활용하도록 돕는 기능입니다. 기억해 둘 세 가지만 정리하겠습니다. 첫째, 사람이 지시를 적는 CLAUDE.md와 Claude가 발견한 사실을 적는 자동 메모리는 다릅니다. 둘째, 저장된 기록은 /memory로 살펴볼 수 있지만 실제 현재 로딩 여부는 별도 확인이 필요합니다. 셋째, 메모리는 실수할 수 있으므로 보안·테스트·권한 제어를 대신하지 못합니다. AI가 지난 작업을 “기억한다”는 말보다 중요한 것은 어떤 파일에 무엇이 저장됐고, 이번 작업에서 그 정보가 유효한가입니다.