한 프로젝트에서 Claude Code 자동 메모리를 끄는 방법

Claude Code 자동 메모리를 한 프로젝트에서만 끄려면 해당 프로젝트의 .claude/settings.json 파일에 "autoMemoryEnabled": false를 추가하세요. /memory 명령의 토글은 이 용도에 적합하지 않습니다. 전역 파일에 설정을 기록해 컴퓨터의 모든 프로젝트에서 메모리를 끄기 때문입니다.

에이전트에는 필요 없는 정보가 금세 쌓일 수 있습니다. 여기서 설명하는 사례에서 Hermes는 한 작업을 두고 2시간 동안 생각했습니다. “토큰을 몇 개 썼어?”라고 묻자 “대략 1억 개 썼습니다”라고 답했습니다. 작업을 해결했나요? “아니요, 조사했습니다.” 모든 파일을 차례로 계속 살펴보다가 혼란에 빠졌습니다.

그래서 에이전트의 메모리에는 가장 가치 있는 정보만 넣어야 합니다. 그리고 여기서 제시하는 평가에 따르면 Claude Code 자동 메모리는 꽤 취약합니다. 용량이 매우 작고 압축률도 높습니다. Claude가 오직 여러분의 규칙에 따라서만 작업하게 하려면 프로젝트 설정에 1줄을 추가하면 됩니다.

자동 메모리가 CLAUDE.md와 어떻게 다른지, 자동 메모리를 끄는 방법, 오래된 메모를 처리하는 방법을 살펴보겠습니다. 시작해 보죠.

Ailoot 참고 문서: ailoot.ai/docs/.

자동 메모리는 CLAUDE.md와 어떻게 다른가요?#

CLAUDE.md는 주요 지침 파일이며, 직접 작성합니다. 새 채팅을 시작할 때마다 Claude는 사실상 “여기에 뭐가 있지? 나는 누구지? 무엇을 해야 하지?”라고 묻습니다. CLAUDE.md에 모든 내용을 명확히 적어 두면 Claude는 “그렇지, 나는 전문가야. 알겠어.”라고 말합니다.

자동 메모리는 Claude가 직접 작성합니다. “내가 선호하는 언어로 항상 답해야 한다는 걸 기억해” 또는 “값을 코드에 고정하지 말고 항상 데이터베이스에서 가져와”라고 말하면, Claude는 메모리 폴더에 “다시는 그렇게 하지 말 것” 같은 내용을 파일로 씁니다. 다음 세션에서 Claude는 이를 떠올립니다.

물론 항상 그런 것은 아닙니다. 에이전트는 여전히 무언가를 잊어버리므로 계속 지켜봐야 합니다. “이봐, 또 잊었잖아. 우리 이 얘기 이미 했어.” 그러면 “아, 맞아요. 기억났어요. 파일에서 찾았어요.”라고 답합니다. 그래서 일반적으로는 메모리에 기대기보다 중요한 내용을 모두 CLAUDE.md에 넣습니다.

CLAUDE.md에 어떤 규칙을 넣어야 하는지 별도 글에서 자세히 설명하고, Claude 채팅의 메모리와 CLAUDE.md가 어떻게 다른지는 다른 글에서 다룹니다.

AI 에이전트로 프로젝트를 만든다면 사용하는 도구의 문서를 가까이에 두세요.

Claude가 스스로 작성하는 내용#

Claude Code는 4가지 유형의 메모를 저장합니다.

• user — 사용자의 역할, 경험, 선호하는 작업 방식
• feedback — 사용자가 수정한 내용과 확인한 접근 방식
• project — 코드에서 확인할 수 없는 현재 작업, 기한, 결정 사항
• reference — 작업 추적기처럼 프로젝트 외부의 정보를 찾을 위치

이 모든 내용은 ~/.claude/projects/<project>/memory/에 저장됩니다. 그 안의 주요 파일은 메모마다 1줄씩 담긴 목차인 MEMORY.md입니다. 세션을 시작할 때 Claude는 이 파일의 처음 200줄 또는 25 KB를 읽고, 필요할 때 다른 파일을 엽니다. 메모리는 사용자의 컴퓨터에만 저장되며 다른 컴퓨터나 클라우드로 옮겨지지 않습니다.

여기서 설명하는 사례에는 사용자의 이름과 역할, 동적 값을 코드에 고정하지 말라는 규칙이 들어 있으며, 전체 분량은 5–7줄에 불과합니다. 에이전트가 어떻게 작업해야 하는지를 알려 주는 에이전트 자체를 위한 규칙입니다.

에이전트가 링크를 통해 읽는 파일 폴더를 두 번째 두뇌로 삼아 프로젝트 지식을 저장할 수 있습니다. 이 방법을 쓸 때는 ‘두 번째 두뇌’ 스킬을 정의하고 Hermes 설치 명령과 ‘작업별로 어떤 모델을 사용할지’를 정리한 표가 담긴 PDF를 프로젝트 파일과 함께 두면 편리합니다.

프로젝트 하나에서 자동 메모리 끄기#

1. 프로젝트 설정에 줄 추가하기

   프로젝트의 기본 폴더에는 숨김 .claude 폴더가 있고, 그 안에 settings.json 파일이 있습니다. 가장 쉬운 방법은 Claude Code에 직접 요청하는 것입니다. “이 프로젝트의 .claude/settings.json 파일에 "autoMemoryEnabled": false를 추가하고 다른 설정은 그대로 두세요.” 수동으로 파일을 열었는데 파일이 없다면 다음 내용을 넣어 만드세요.

   {
     "autoMemoryEnabled": false
   }
   

   파일에 설정이 이미 있다면 다른 설정은 그대로 두고 키를 추가하세요. autoMemoryEnabled가 false이면 Claude는 메모리 폴더를 읽지도 않고 그곳에 아무것도 쓰지도 않습니다.

2. 설정 적용 대상 선택하기

   .claude/settings.json은 공유 프로젝트 파일이며 프로젝트에서 작업하는 모든 사람에게 적용됩니다. 자신에게만 메모리를 끄고 싶다면 .claude/settings.local.json에 같은 키를 넣으세요. 이 파일은 해당 프로젝트의 개인 설정 파일입니다.

   프로젝트 설정은 전역 설정에 우선합니다. ~/.claude/settings.json에서 메모리가 활성화되어 있어도 이 프로젝트에는 false가 우선 적용됩니다.

3. Claude Code 재시작하기

   세션을 닫고 프로젝트 폴더에서 claude를 다시 실행하세요. /status를 입력하면 Setting sources 줄에 프로젝트 파일이 표시되어야 합니다. 표시되면 Claude가 파일을 읽은 것입니다. 인접한 다른 프로젝트에서는 메모리가 계속 활성화됩니다.

다른 방법도 2가지 있지만 용도가 다릅니다.

• CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 환경 변수. CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 claude를 실행하면 해당 실행에서만 메모리가 비활성화되고 설정 파일의 키보다 우선합니다. 하지만 매번 직접 입력해야 합니다.
• /memory의 토글. autoMemoryEnabled를 컴퓨터의 모든 프로젝트에 적용되는 전역 파일인 ~/.claude/settings.json에 기록합니다. 한 프로젝트에서 이 토글을 사용하면 모든 곳에서 메모리가 꺼집니다.

한 가지 더 있습니다. 백그라운드 세션에서는 토글로 메모리를 끌 수만 있고 다시 켤 수는 없습니다. 메모리를 활성화하려면 터미널에서 직접 claude를 실행해 시작한 일반 세션을 사용하세요.

오래된 메모 처리하기#

/memory 명령은 메모리 파일 목록을 보여 주고 파일을 열 수 있게 해 줍니다. 일반 텍스트 파일이므로 편집하거나 삭제할 수 있습니다.

무작정 삭제하지 말고 먼저 어떤 내용이 있는지 살펴보세요. 여기서 설명하는 규칙 폴더 정리 사례에서 에이전트는 자기 성찰 과정에서 사용자에 관한 불필요한 정보를 기록했습니다. 지저분한 규칙은 오래된 규칙으로 가득 찬 기본 CLAUDE.md 파일만큼 해롭습니다. 에이전트가 계속 그 규칙을 사용하면서 환각을 일으키고 더 부정확한 맥락을 제공합니다.

에이전트에게 정리를 요청할 수 있습니다. 일주일에 한 번 업무 폴더에 다음과 같은 작업을 맡기면 됩니다. 메모리 폴더에도 똑같이 적용할 수 있습니다.

더 이상 관련이 없거나 오래된 항목을 찾아내고, 실제로 오래된 것이 맞는지 입증하는 것이 당신의 임무입니다. 아직 삭제하면 안 됩니다. 찾아서 제게 보여 주세요.

에이전트는 근거와 함께 목록을 가져오고, 무엇을 삭제할지는 사용자가 결정합니다. 메모에서 가장 가치 있는 정보만 CLAUDE.md로 옮기세요. Claude가 지침을 따르도록 짧게 작성하는 방법은 별도 글에 설명되어 있습니다. 폴더와 규칙을 사용해 프로젝트 메모리 전체를 정리하는 방법은 두 번째 두뇌에 관한 글에서 다룹니다.

자동 메모리를 켜 두었나요, 아니면 껐나요? Claude가 당신에 대해 무엇을 기억했는지 확인해 보세요. ailoot.ai에서 Ailoot을 계속 둘러볼 수 있습니다.