클로드코드의 서브에이전트 메모리 전략

Question

안녕하세요 강사님 강의 잘 듣고 있습니다. 서브에이전트를 학습중에 궁금한게 있어 질문드립니다. 보통 메인 에이전트가 생성한 서브에이전트는 글로벌/프로젝트/로컬 단위로 어떻게 메모리를 관리하나요? 단일 에이전트의 경우 ~/.claude/CLAUDE.md 파일과 같이 파일시스템을 활용하는 건 알겠는데, 서브에이전트의 경우에는 어떻게 하는지 궁금해서요. 정해진게 없다면, 주로 어떻게 처리하는지가 궁금합니다.

미쿡엔지니어 · Answer

안녕하세요 유준모님, 좋은 질문입니다. 자세한 내용은 https://code.claude.com/docs/en/sub-agents 에 답변이 되어 있지만, 간단하게 말씀드리자면 다음과 같습니다. 그리고 질문 주신 게 사실 두 가지가 살짝 섞여 있어서 나눠서 말씀드릴게요. 먼저 서브에이전트도 메인이 읽는 CLAUDE.md 계층( ~/.claude/CLAUDE.md 글로벌 + 프로젝트 + CLAUDE.local.md )을 그대로 상속받아 로드합니다. 그러니까 "단일 에이전트만 파일시스템 쓰고 서브에이전트는 안 쓴다"가 아니라, 똑같이 받아요. 다만 각 호출은 매번 fresh context로 시작하기 때문에 메인 대화 히스토리나 이미 읽은 파일은 못 봅니다. (예외로 내장 Explore/Plan만 속도 때문에 CLAUDE.md를 건너뜁니다.) 그리고 질문하신 "글로벌/프로젝트/로컬 단위로 메모리를 어떻게 관리하냐"는 건 세션을 넘어 누적되는 영구 메모리 얘기인데, 이게 frontmatter의 memory 필드로 정확히 정해져 있어요 (v2.1.33부터). scope가 딱 세 개라서 말씀하신 구분과 그대로 맞아떨어집니다: memory: user → ~/.claude/agent-memory/<이름>/ (글로벌, 모든 프로젝트 공통) memory: project → .claude/agent-memory/<이름>/ (프로젝트 특화, git으로 팀 공유) memory: local → .claude/agent-memory-local/<이름>/ (프로젝트 특화지만 git 제외) 이걸 켜면 해당 폴더의 MEMORY.md (앞 200줄/25KB까지)가 system prompt에 자동으로 들어가고, Read/Write/Edit도 자동 활성화돼서 에이전트가 스스로 메모리를 읽고 갱신합니다. 단일 에이전트의 CLAUDE.md 랑 똑같이 파일시스템 기반인데, 에이전트별로 격리된 폴더를 갖는다는 점만 다른 거죠. "정해진 게 없어서 알아서"가 아니라 명확히 규약이 있다고 보시면 됩니다. 보통은 project 를 기본으로 쓰시고, 메모리가 알아서 잘 안 채워지는 편이라 프롬프트에 "끝나면 배운 거 메모리에 저장해" 정도를 박아두면 효과 좋습니다. ㅎㅎ 그리고 강의가 마음에 드셨다면 좋은 리뷰 꼭 부탁드리겠습니다!