클로드 메모리 기능 활용법 — 대화형 메모리와 CLAUDE.md 구분법

대화가 길어질 대로 길어진 창에서 갑자기 엉뚱한 답변이 튀어나온 순간, 스크롤을 한참 올려 어디서부터 꼬였는지 찾아본 적이 있습니다. 그런데 원인을 찾는 것보다 더 자주 하게 되는 일이 있었는데요. 그 대화를 통째로 새로 시작하는 것이었습니다.

이 글은 클로드(Claude.ai·클로드 코드)를 업무나 개발에 쓰면서 "대화형 메모리"와 "CLAUDE.md 같은 파일 기반 메모리"를 둘 다 접해본 분들을 대상으로, 클로드 메모리 기능이 실제로 어떻게 작동하는지와 이 둘을 언제 나눠 써야 하는지를 정리합니다. 클로드 메모리, CLAUDE.md, 컨텍스트 압축(오토 컴팩트), 대화 내보내기까지 — 이름은 비슷해 보여도 역할이 완전히 다른 이 기능들을 하나씩 구분해보겠습니다.

솔직히 저희 팀도 처음에는 이 기능들의 경계가 뚜렷하지 않았습니다. CLAUDE.md에 적어야 할 내용을 대화창에서 매번 다시 설명하고 있거나, 반대로 지금 이 대화 하나에만 필요한 잡다한 맥락을 굳이 파일로 남기려다 CLAUDE.md만 점점 두꺼워지는 식이었는데요. 그런데 직접 쓰면서 겪은 시행착오를 하나씩 정리하다 보니, 결국 판단 기준은 "이 정보가 프로젝트에 속하는가, 아니면 지금 이 대화 하나에 속하는가"라는 질문 하나로 좁혀지는 것을 알게 됐습니다.

그 기준이 어떻게 만들어졌는지, 대화형 메모리와 CLAUDE.md가 실제로 어떤 원리로 작동하는지부터 순서대로 짚어보겠습니다.

클로드 메모리 기능, 정확히 뭘 가리키는 걸까요?

한 단어처럼 쓰이지만 실제로는 서로 다른 세 가지를 가리킵니다. 첫째는 claude.ai·클로드 앱에서 쓰는 대화형 메모리(Claude Memory), 둘째는 개발자가 API로 직접 제어하는 메모리 툴(memory tool), 셋째는 클로드 코드가 쓰는 CLAUDE.md·오토 메모리(auto memory)입니다.

Anthropic은 2026년 3월 2일부터 클로드 메모리를 무료 사용자까지 포함한 전체 사용자에게 열었습니다. 그전까지는 2025년 10월부터 유료 사용자에게만 제공되던 기능이었는데요(MacRumors, 2026). 이 셋을 뭉뚱그려 "메모리 기능"이라고 부르다 보면, 정작 내가 지금 어떤 메모리를 쓰고 있는지 헷갈리기 쉽습니다.

대화형 메모리(Claude Memory)는 어떻게 작동할까요?

대화 전체를 저장하는 게 아니라, 대화가 끝날 때마다 사용자의 역할·선호·응답 형식 취향 같은 정보를 추출해서 하나의 누적 요약으로 남기는 방식으로 작동합니다. 그래서 "사용자는 간결한 불릿 포인트 답변을 선호한다"처럼 사실과 선호가 저장되는 것이지, 대화 원문이 로그로 그대로 쌓이는 것은 아닙니다(MacRumors, 2026).

사용자가 "기억해줘"라고 말하지 않아도 클로드가 기억할 가치가 있다고 판단하면 스스로 메모리 항목을 만듭니다. 요약 프로필은 대략 24시간마다 갱신되고, 사용자가 직접 특정 사실을 기억하라고 지시하면 즉시 반영됩니다. 여러 개의 프로젝트(Projects)를 쓴다면 프로젝트마다 독립된 메모리 공간을 가지며, 이는 전역 대화 메모리와 분리되어 있습니다(MacRumors, 2026).

여기서 한 가지 짚어야 할 제약이 있는데요. 이 대화형 메모리는 claude.ai·클로드 앱 전용입니다. 개발자가 API로 클로드를 호출하거나 클로드 코드를 쓸 때는 이 메모리 레이어가 아예 존재하지 않고, 호출할 때마다 새로 시작합니다(MacRumors, 2026). 클로드 코드에서 "왜 지난번에 말한 걸 기억 못 하지"라는 의문이 든다면, 애초에 그 메모리 레이어 자체가 다른 곳에 있다는 뜻입니다.

참고로 개발자용으로는 API에서 직접 제어하는 메모리 툴(memory_20250818)도 따로 있습니다. 클로드가 파일 작업을 요청하면 개발자의 애플리케이션이 자신의 인프라에 실제로 저장하는 클라이언트 사이드 방식인데, Anthropic은 이 방식으로 장기 워크플로에서 토큰 사용량을 84% 절감했다고 밝혔습니다(platform.claude.com 공식 문서, 2026).

CLAUDE.md와 오토 메모리는 뭐가 다를까요?

CLAUDE.md는 사람이 쓰는 지침이고, 오토 메모리는 클로드가 스스로 남기는 메모입니다. 클로드 코드 공식 문서는 둘을 아래처럼 구분합니다(code.claude.com 공식 문서, 2026).

CLAUDE.md는 조직 전체 관리형 정책부터 ~/.claude/CLAUDE.md(개인 전체 프로젝트), 프로젝트 루트의 ./CLAUDE.md(팀 공유), ./CLAUDE.local.md(개인 전용, gitignore 대상)까지 저장 위치에 따라 범위가 나뉩니다. 공식 가이드는 파일당 200줄 이하를 권장하는데요. 길어질수록 컨텍스트를 더 먹고, 오히려 지침 준수율이 떨어지기 때문입니다(code.claude.com 공식 문서, 2026).

두 시스템 모두 "강제 설정"이 아니라 "컨텍스트"로 취급된다는 점도 알아둘 필요가 있습니다. 클로드가 반드시 따르는 규칙이 아니라 참고하는 정보라는 뜻인데요. 특정 행동을 무조건 막고 싶다면 CLAUDE.md가 아니라 별도의 훅(hook) 설정이 필요합니다(code.claude.com 공식 문서, 2026).

대화가 길어지면 압축은 어떻게 이뤄질까요?

클로드 코드는 컨텍스트 창(약 200K 토큰)이 한계에 가까워지면 대화 기록을 자동으로 요약해 압축하는 오토 컴팩트(Auto Compact) 기능을 갖고 있습니다. 최근 코드 diff, 아키텍처 결정, 네이밍 컨벤션처럼 중요한 정보는 남기고, 이미 해결된 디버깅 루프나 곁가지 탐색은 덜어내는 방식입니다(CometAPI, 2026; ClaudeLog, 2026).

정확한 트리거 시점은 자료마다 조금씩 다르게 보고됩니다. 어떤 자료는 남은 컨텍스트가 약 25%(사용량 75%) 수준일 때 자동 압축이 걸린다고 하고, 다른 자료는 사용량이 80%에 도달하면 걸린다고 설명하는데요(ClaudeLog, 2026; Zenva Academy, 2026). 정확한 숫자는 엇갈리지만, "컨텍스트 사용량이 70~80%를 넘으면 자동으로 압축이 걸린다"는 방향만큼은 공통적으로 관찰됩니다. /compact 명령으로 리팩터링을 끝낸 직후나 버그를 고친 직후처럼 원하는 시점에 직접 압축을 걸 수도 있습니다(fazm.ai, 2026).

저희 팀도 예전에는 대화 세션이 길어질 때마다 컨텍스트를 압축해주는 스킬을 따로 불러와야 했습니다. 그런데 요즘은 그럴 필요가 거의 없어졌는데요. 클로드가 대화 길이와 컨텍스트 사용량을 스스로 판단해서 알아서 압축을 걸어주고 있기 때문입니다. 예전 같으면 압축 타이밍을 놓쳐서 컨텍스트가 꽉 찬 채로 작업을 이어가야 했던 경우가 있었는데, 지금은 그런 순간이 확실히 줄었습니다.

한 가지 알아두면 좋은 점은, 프로젝트 루트의 CLAUDE.md는 이 압축 이후에도 살아남는다는 것입니다. 클로드가 디스크에서 다시 읽어 세션에 재주입하기 때문인데요. 반면 하위 디렉터리의 CLAUDE.md나 특정 경로에만 적용되는 규칙은 자동으로 재주입되지 않고, 해당 파일을 다시 다룰 때가 되어야 다시 로드됩니다(code.claude.com 공식 문서, 2026).

답변이 엉뚱해지면 어떻게 리셋해야 할까요?

압축이 맥락을 요약해서 이어가는 방식이라면, 아예 새로 시작하는 방식도 있습니다. 바로 대화 내보내기입니다.

Claude.ai가 공식으로 제공하는 내보내기는 개별 대화 단위가 아니라 계정 전체 데이터 덤프입니다. Settings > Privacy > Export Data에서 요청하면 24시간 안에 만료되는 다운로드 링크(ZIP, JSON 형식)를 이메일로 받는 구조인데요. 개별 대화 하나만 바로 마크다운으로 내보내는 공식 버튼은 2026년 8월 현재 확인되지 않고, 이 공백은 여러 서드파티 브라우저 확장이 채우고 있습니다(ai-toolbox.co, 2026).

반면 클로드 코드는 /export 명령을 공식적으로 지원합니다. 현재 세션 대화록을 마크다운(기본값)이나 JSON으로 바로 파일 저장할 수 있는데요. 다만 이 명령은 활성 세션 하나만 대상으로 하고, 과거 세션을 한 번에 전부 내보내는 기능은 공식적으로는 없습니다(recombobulate.dev, 2026).

저희 팀은 답변이 엉뚱한 방향으로 흘러간다 싶으면, 그 대화를 MD 파일로 다운로드받아 두고 새 대화창을 열어서 그 파일을 첨부하는 방식으로 다시 시작합니다. 이 방식이 통하는 이유는 명확합니다. 대화형 메모리는 "선호와 사실의 요약"만 저장할 뿐, 대화 전체 맥락을 보존하지는 않기 때문인데요. 맥락이 꼬일 대로 꼬였을 때는 압축된 요약만으로 원래 흐름을 되살리기 어렵고, 원본 대화록 전체를 새 세션에 통째로 다시 공급하는 편이 확실합니다.

그래서 대화형 메모리와 CLAUDE.md, 언제 나눠 써야 할까요?

핵심 질문은 하나입니다 — "이 정보가 프로젝트에 속하는가, 아니면 나 개인·이 대화 하나에 속하는가?"(loreai.dev, 2026)

CLAUDE.md에는 빌드 명령어·테스트 요구사항처럼 팀 전체가 따라야 할 규칙, 보안 제약, 코드 리뷰에서 검증 가능해야 하는 지침, 파일 구조나 알려진 버그 같은 "코드베이스에 대한 사실"을 담습니다. 반대로 대화형 메모리·세션 내 맥락에는 역할·전문성·소통 스타일 같은 개인적 특성, 사용자가 준 교정과 피드백, 바뀔 가능성이 있는 일시적 맥락을 맡깁니다(loreai.dev, 2026).

저희 팀 나름의 기준을 세워보면 이렇습니다. CLAUDE.md 같은 파일 기반 기억은 프로젝트의 수행 기준과 목표를 정해둘 때 쓰고, 대화형 메모리는 복잡하게 이어지는 대화를 계속 끌고 가거나 하나의 대화를 마무리 지어야 할 때 씁니다. 프로젝트가 바뀌어도 계속 지켜야 할 규칙이라면 파일에 적어두고, 지금 이 대화 안에서만 유효한 맥락이라면 굳이 파일로 남기지 않는 것입니다.

가장 흔한 실수는 정반대 방향으로 두 가지입니다. 모든 정보를 CLAUDE.md에 몰아넣으면 파일이 비대해지고 정작 중요한 지침이 묻히고, 반대로 대화형 메모리에만 의존하면 매 세션·매 대화창마다 같은 맥락을 반복 설명해야 합니다(loreai.dev, 2026).

☑ 지금 상황에 맞는 메모리 고르기 체크리스트

• 팀원 전체가 알아야 할 규칙인가 → CLAUDE.md

• 프로젝트가 바뀌어도 계속 지켜야 할 기준·목표인가 → CLAUDE.md

• 클로드가 스스로 배운 빌드 명령어·디버깅 팁인가 → 오토 메모리

• 지금 이 대화 하나를 마무리 짓기 위한 맥락인가 → 대화형 메모리(세션 내)

• 답변이 엉뚱해질 만큼 맥락이 꼬였는가 → 압축된 요약 대신 대화 내보내기(MD) 후 재시작

자주 묻는 질문 (FAQ)

Q. 클로드 코드에서도 claude.ai의 대화형 메모리가 적용되나요? A. 아니요. 클로드 메모리는 claude.ai·클로드 앱 전용 기능이며, API 접근이나 클로드 코드에는 적용되지 않습니다. 클로드 코드는 대신 CLAUDE.md와 오토 메모리로 세션 간 지식을 이어갑니다(MacRumors, 2026).

Q. CLAUDE.md는 대화가 압축(`/compact`)돼도 사라지지 않나요? A. 프로젝트 루트의 CLAUDE.md는 압축 후에도 클로드가 디스크에서 다시 읽어 재주입하므로 살아남습니다. 다만 하위 디렉터리 CLAUDE.md나 경로 지정 규칙은 해당 파일을 다시 다룰 때가 되어야 재로드됩니다(code.claude.com 공식 문서, 2026).

Q. 대화 하나를 통째로 마크다운으로 내보내려면 어떻게 하나요? A. 클로드 코드라면 /export 명령으로 현재 세션을 바로 마크다운·JSON 파일로 저장할 수 있습니다. claude.ai는 개별 대화 단위의 공식 내보내기 버튼이 없어, 계정 전체 데이터 내보내기(Settings > Privacy > Export Data)나 서드파티 확장을 활용해야 합니다(recombobulate.dev; ai-toolbox.co, 2026).

여기까지 클로드 메모리 기능을 대화형 메모리(Claude Memory), API 메모리 툴, CLAUDE.md·오토 메모리, 컨텍스트 압축, 대화 내보내기 순서로 짚어봤습니다. 이름은 비슷해도 저장되는 장소도, 유지되는 범위도, 심지어 적용되는 제품(claude.ai인지 클로드 코드인지)도 전부 다르다는 것이 핵심입니다. 이 다섯 가지를 뭉뚱그려 "메모리"라는 한 단어로 부르는 순간, 어디에 뭘 적어야 할지에 대한 판단도 함께 흐려진다는 것을 저희 팀도 이번에 정리하면서 다시 확인했습니다.

결국 나눠 쓰는 기준은 단순합니다.

"이 정보가 프로젝트 차원에서 계속 지켜야 할 기준인지, 지금 이 대화 하나에만 필요한 맥락인지."

프로젝트의 수행 기준과 목표라면 CLAUDE.md에 적어두고, 복잡한 대화를 이어가거나 하나의 대화를 마무리 지어야 하는 상황이라면 대화형 메모리와 압축 기능에 맡기면 됩니다. 맥락이 꼬여서 답변이 엉뚱해졌다면, 무리해서 그 대화를 되살리려 하기보다 MD로 내보내 새 대화창에서 다시 시작하는 편이 빠릅니다.

네 가지 기능을 한 번에 다 파악하려 하지 않아도 괜찮습니다. 당장은 지금 쓰고 있는 CLAUDE.md 한 파일만 열어서, 그 안에 적힌 문장들이 정말 "프로젝트 차원에서 계속 지켜야 할 기준"인지 하나씩만 확인해봐도 충분합니다.

지금 CLAUDE.md에 적어둔 것 중에, 사실은 대화형 메모리나 그때그때의 대화 맥락에 맡겨도 됐을 문장이 있지는 않으신가요?

참고자료

1. MacRumors — Anthropic Adds Free Memory Feature and Import Tool to Lure ChatGPT Users to Claude (2026-03-02)

2. Dataconomy — Anthropic Makes Claude Memory Feature Free For All Users (2026-03-04)

3. Claude Platform 공식 문서 — Memory tool (platform.claude.com, 2026)

4. Claude Code 공식 문서 — How Claude remembers your project (code.claude.com, 2026)

5. Claude Code 공식 문서 — Explore the context window (code.claude.com, 2026)

6. LoreAI — Claude Memory vs CLAUDE.md: Which Persistence Layer Should You Use? (loreai.dev, 2026)

7. CometAPI — What Is Auto Compact in Claude Code (2026)

8. ClaudeLog — What is Claude Code auto compact (2026)

9. Zenva Academy — Claude Code Context Window: When to Use /compact vs /clear (2026)

10. ai-toolbox.co — Export Claude Conversations: Download as TXT, Markdown, or JSON (2026)

11. Recombobulate — Export Your Session Transcript with claude export (2026)

(확인일자는 원본 표기를 그대로 유지)