개요
클로드 코드가 새롭게 선보인 Auto Memory 기능은 세션이 초기화되어도 중요한 정보를 잃지 않도록 마크다운 파일 기반의 영구 기억 공간을 제공한다. 기존에는 대화 세션이 종료되거나 컨텍스트 윈도우가 초과되면 앞선 대화 내용이 모두 사라지는 한계가 있었다. 이 기능을 통해 토큰 낭비를 줄이고 반복적인 재조사 없이 이전 작업의 맥락을 이어갈 수 있다.
기존 클로드 코드의 맥락 제한 문제
클로드 코드는 AI와 대화를 이어가며 작업을 진행하는 방식으로 동작한다. 이 과정에서 대화 맥락이 누적되고, AI는 이 맥락을 토대로 이어지는 작업을 수행한다. 그러나 대화 내용은 무한정 길어질 수 없으며, 컨텍스트 윈도우라는 제한된 공간이 존재한다.
이 한계를 초과하면 요약해서 줄이거나 일부를 버리는 방식으로 처리된다. 클로드 코드를 껐다가 다시 켜거나 대화를 클리어하면 앞서 나눴던 대화 내용은 사라진다. 이 상태에서 이전 내용을 다시 물어보면 클로드 코드는 세션에 해당 대화가 없다며 처음부터 다시 조사를 시작한다.
영상에서는 이런 재조사가 “만만치 않게 토큰 낭비가 만들어지는 일”이라고 직접 언급했다. 매번 세션이 초기화될 때마다 같은 내용을 다시 파악하게 하는 것은 비효율적이다.
Auto Memory의 작동 방식
Auto Memory는 이 문제를 해결하기 위해 마크다운 파일을 기억 공간으로 활용한다. 벡터 데이터베이스 같은 복잡한 시스템이 아니라 단순한 마크다운 파일 두 개를 사용한다는 점이 특징이다.
영상에서 시연한 방식은 다음과 같다. “지금 이 내용을 메모리에 기억해 달라”고 요청하면, 클로드 코드는 메모리 공간이 있는지 먼저 확인하고 없으면 기록할 공간을 준비한다. 그 결과 두 개의 파일이 생성된다.
첫 번째 파일은 memory.md로, 앞으로 기억될 다양한 내용들의 목차 역할을 한다. 이 파일은 최대 200라인으로 제한되어 있으며 매 요청마다 상시로 컨텍스트에 담긴다. 두 번째 파일은 기억할 내용의 본체를 담는 별도 마크다운 파일이다. 이 파일은 상시로 컨텍스트에 담기지 않고, 관련 내용이 필요할 때만 목차를 통해 참조된다.
이렇게 목차 파일과 내용 파일을 분리함으로써 토큰을 절약하고 컨텍스트 윈도우를 더 넓게 사용할 수 있게 된다.
자율 기억과 명시적 기억
클로드 코드의 메모리 관리 지침에 따르면, 저장할 내용과 저장하지 말아야 할 내용을 자율적으로 구분하여 기억하도록 설계되어 있다. 사용자가 직접 “기억해 달라”고 요청하지 않아도 클로드 코드가 스스로 판단해서 중요한 내용을 메모리에 저장한다.
물론 영상에서 시연한 것처럼 명시적으로 “메모리에 기억해 달라”고 요청하는 방식도 사용할 수 있다. 메모리 파일은 코드 파일을 편집하듯이 내장된 쓰기 및 편집 도구를 통해 관리된다. 생성된 파일들은 마크다운 형식이기 때문에 코드 에디터로 직접 열어서 편집할 수도 있다.
실전 가이드
클로드 코드의 Auto Memory를 실제로 활용하는 방법은 다음과 같다.
먼저 중요한 프로젝트 컨텍스트를 메모리에 저장해 두는 것부터 시작한다. 예를 들어 특정 프로젝트의 아키텍처, 주요 변수명 규칙, 반복적으로 사용하는 설정 등을 “이 내용을 메모리에 기억해 달라”고 요청해 저장한다. 한 번 저장하면 이후 세션에서도 클로드 코드가 목차 파일을 통해 해당 내용을 참조할 수 있다.
다음으로 memory.md 파일의 내용을 직접 확인하고 관리한다. 이 파일은 최대 200라인 제한이 있으므로 불필요해진 내용은 직접 코드 에디터로 열어 삭제하거나 수정하는 것이 좋다. 메모리 공간을 효율적으로 유지할수록 컨텍스트 윈도우 활용도가 높아진다.
마지막으로 세션 초기화 이후 동작을 확인한다. 클로드 코드를 재시작한 후 이전에 기억해 달라고 요청한 내용을 다시 물어보면, 클로드 코드가 메모리 파일에서 해당 내용을 찾아 응답하는 것을 확인할 수 있다. 재조사 없이 즉시 응답이 가능한 경우 메모리 기능이 정상적으로 동작하고 있는 것이다.
핵심 요점
- 클로드 코드의 기존 한계는 세션 초기화 시 모든 맥락이 사라지는 것이었으며, 이로 인한 재조사가 토큰 낭비를 만들었다. Auto Memory는 이 문제를 마크다운 파일 기반 영구 저장으로 해결한다.
- 메모리는
memory.md목차 파일과 내용 본체 파일 두 가지로 구성된다. 목차 파일(최대 200라인)만 매 요청마다 컨텍스트에 포함되고, 세부 내용은 필요할 때만 참조되어 토큰을 절약한다. - 사용자가 명시적으로 “기억해 달라”고 요청할 수도 있고, 클로드 코드가 자율적으로 저장 여부를 판단할 수도 있다. 두 방식 모두 동일한 마크다운 파일 구조를 사용한다.
- 생성된 메모리 파일은 일반 마크다운 파일이므로 코드 에디터로 직접 열어 편집할 수 있다. 이는 사용자가 메모리 내용을 완전히 제어할 수 있음을 의미한다.
- 이 방식은 LLM 활용의 일반적인 트렌드와 일치한다. MCP 활용에서도 유사한 맥락 관리 방식이 확산되고 있으며, 컨텍스트를 효율적으로 관리하는 것이 AI 활용의 핵심 역량이 되고 있다.