클로드 코드 세션마다 기억이 사라지는 문제, 메모리 허브가 답일까
워크플로우·방법론

클로드 코드 세션마다 기억이 사라지는 문제, 메모리 허브가 답일까

세션을 여러 개 띄워놓고 쓰다 맥락을 잃는 문제, 공식 자동 메모리와 커뮤니티 메모리 허브 도구가 어디까지 해결해주는지 살펴본다

2026-08-13논의 1회 정리

클로드 코드로 서버 마이그레이션이나 여러 모듈을 한꺼번에 손보는 사람이 늘었다. 터미널 창을 여러 개 띄워놓고 작업하다가 다음 날 다시 열면, 전날 어디까지 했는지부터 다시 설명해야 하는 불편이 반복해서 나온다. 클코단에서도 이 문제를 어떻게 풀지, 이른바 메모리 허브를 직접 만들 수 있는지 질문이 나왔다. 이 기사는 앤스로픽이 이미 내장한 자동 메모리 기능이 이 문제를 어디까지 해결하는지, 그리고 세션을 여러 개 동시에 켜두는 경우엔 왜 별도의 장치가 더 필요한지를 짚는다.

세션마다 처음부터 다시 설명해야 했던 이유

클로드 코드 공식 문서에 따르면 세션은 열릴 때마다 빈 컨텍스트 윈도우에서 시작한다. 과거엔 이 공백을 메우는 수단이 CLAUDE.md 하나뿐이었다. 사람이 직접 써넣는 지침 파일이라 빌드 명령이나 코딩 규칙은 잘 남았지만 어제 어떤 버그를 어떻게 잡았는지 같은 경험은 매번 사람이 다시 타이핑해야 했다.

방에서 나온 "세션을 켤 때마다 진행 상황을 리캡해주면 좋겠다"는 바람은 실은 상당 부분 이미 구현돼 있다. 문제는 그 기능의 이름과 작동 범위를 정확히 모르는 채로 새로 만들려 든다는 점이다.

자동 메모리가 실제로 하는 일

앤스로픽은 2026년 2월 자동 메모리 기능을 공개했다. Claude가 작업하면서 스스로 판단해 기억할 가치가 있는 내용(빌드 명령, 디버깅 인사이트, 사용자가 고쳐준 습관)을 MEMORY.md에 기록한다. 다음 세션이 시작될 때는 그 파일의 첫 200줄 또는 25KB까지를 자동으로 불러온다. 저장 위치는 사용자 홈 아래 저장소별 폴더다. 같은 저장소의 여러 워크트리가 이 폴더 하나를 공유한다. `/memory` 명령으로 무엇이 저장됐는지 열람하고 켜고 끌 수 있다.

여기에 더해 대화 자체를 이어가는 기능도 따로 있다. `--continue` 옵션은 같은 디렉터리의 가장 최근 세션을, `--resume` 옵션은 세션 목록에서 골라 이어갈 수 있게 해준다. 세션이 10만 토큰을 넘고 한 시간 넘게 방치됐다 돌아오면 요약본으로 이어갈지 원본 그대로 이어갈지 고르는 창도 뜬다.

여러 작업을 동시에 굴리는 사람이라면 세션에 이름을 붙여두는 습관도 실무에서 꽤 도움이 된다. 시작할 때 이름을 지정해두면 나중에 그 이름으로 바로 이어갈 수 있다. 세션 목록만 봐도 어느 창이 무슨 작업이었는지 헷갈리지 않는다. 정리하면 어제 뭐 했는지 다시 설명하는 수고는 자동 메모리와 세션 재개 기능만으로도 크게 줄어든다.

세션 여러 개를 동시에 켤 때는 다른 문제가 생긴다

방에서 언급한 상황, 즉 다중 세션을 동시에 열어두는 작업 방식은 이야기가 다르다. 앤스로픽 깃허브에 올라온 요청 사례를 보면, 한 사용자가 서버 마이그레이션·데이터베이스 변경·검색 모듈·대시보드 작업을 세션 다섯 개로 나눠 동시에 돌렸다. 마이그레이션 세션에서 서버 IP를 바꿔도 나머지 네 세션은 옛날 값을 그대로 들고 있었다고 한다. 컨텍스트가 부풀어 세션이 죽으면 새로 띄운 세션은 다른 세션이 무슨 작업 중인지 전혀 모르는 채로 시작한다.

자동 메모리는 같은 저장소 안에서는 공유되지만 서로 다른 세션이 실시간으로 서로의 진행 상황을 아는 구조는 아니다. 세션 간 메시지를 주고받거나 공유 스크래치패드를 두는 기능은 아직 정식으로 없다. 해당 요청은 미해결 이슈로 남아 있다. 서브에이전트도 비슷한 처지다. 프로젝트나 사용자 단위로 메모리를 지정해두면 그 서브에이전트만의 지식은 쌓이지만 기본값은 호출할 때마다 백지에서 시작하는 쪽이다.

실무 후기 중에는 동시에 관리하는 세션이 서너 개를 넘어가면 조율에 드는 품이 병렬 작업으로 얻는 이득보다 커진다는 경험담도 있다. 개인 개발자나 소규모 팀이라면 애초에 다섯 개, 여섯 개씩 세션을 벌리기보다 두세 개 안에서 역할을 명확히 나누는 쪽이 관리 부담을 줄이는 현실적인 선택이다.

메모리 허브를 직접 만들려는 시도들

이 공백을 메우려고 커뮤니티가 내놓은 도구는 여럿이다. MCP 서버 형태로 결정·에러·아키텍처 노트를 프로젝트 바깥의 별도 저장소에 쌓아두고 검색하게 해주는 프로젝트들이 있다. 최근 세션 몇 개를 새 세션 시작 시 자동으로 주입하는 플러그인도 있다. 전자는 여러 프로젝트·여러 머신에 걸친 장기 기억을, 후자는 방금 전 세션의 맥락을 빠르게 되살리는 데 초점을 맞춘다. 서브에이전트마다 결과가 흩어지는 문제를 겨냥해 서브에이전트 전체가 하나의 학습 저장소를 공유하도록 설계한 도구도 나와 있다.

다만 이런 서드파티 메모리 서버에도 대가가 따른다. 세션 하나당 서버 프로세스가 새로 뜨는 구조다. 세션을 여러 개 동시에 켜두면 프로세스 수가 곱절로 늘어나 메모리를 과하게 잡아먹는다는 버그 리포트도 확인된다.

"레퍼런스를 찾아달라"는 요청도 방에서 나왔다. 여기에 실질적으로 답하자면, 완제품 도구를 먼저 찾기보다 지금 겪는 문제가 '세션 재시작 시 리캡'인지 '병렬 세션 간 실시간 공유'인지부터 구분하는 쪽이다. 앞의 문제는 공식 기능으로 대부분 풀린다. 뒤의 문제만 아직 커뮤니티 도구나 파일 기반 핸드오프 문서에 기대야 한다.

자동 메모리를 얼마나 믿어야 하나

"프롬프트 기술보다 실제 사용 경험이 중요하다"는 의견은 방에서도 나왔는데, 자동 메모리를 실제로 굴려본 사람들의 반응과 맞닿아 있다. 자동 메모리는 강제 설정이 아니라 맥락으로 취급되기 때문에, "이런 상황이면 항상 이렇게 하라"는 식의 규칙을 적어둬도 매번 지켜진다는 보장은 없다는 게 공식 설명이다. 실사용자 사이에서는 CLAUDE.md는 직접 검토해 확정해두고, 자동 메모리는 보조 수단 정도로만 켜둔다는 방식이 종종 눈에 띈다. MEMORY.md가 200줄이나 25KB를 넘기면 그 뒤 내용은 다음 세션에 아예 읽히지 않는다는 제약도 실사용에서 자주 걸리는 지점으로 꼽힌다.

경쟁 도구들과 비교하면 방향은 비슷하다. 윈드서프의 메모리 기능도 사용자가 지정한 메모와 자동으로 쌓이는 메모를 나눠 다음 대화에 반영하는 식으로 작동한다. 다만 클로드 코드 쪽은 파일이 그대로 마크다운으로 남아 눈으로 확인하고 고칠 수 있다는 점이 실무에서는 강점으로 꼽힌다. 세션 하나를 이어가는 문제는 껐다 켜는 것만으로 풀리지만 세션 여러 개를 나란히 굴리며 같은 사실을 공유하는 문제는 여전히 사람이 파일이나 커밋 메시지로 직접 이어붙여야 하는 영역으로 남아 있다.

클로드코드자동 메모리MEMORY.mdCLAUDE.md메모리 허브MCP 서버세션 관리

참고 링크

자주 묻는 질문

Q

클로드 코드 자동 메모리는 어떻게 켜나요?

기본값이 켜짐 상태다. 세션 안에서 `/memory`를 실행하면 켜고 끄는 토글과 저장된 파일 목록을 볼 수 있고, 특정 프로젝트만 끄려면 설정 파일에 autoMemoryEnabled를 false로 지정하면 된다.

Q

CLAUDE.md와 MEMORY.md는 뭐가 다른가요?

CLAUDE.md는 사람이 직접 써서 매 세션 그대로 불러오는 지침 파일이고, MEMORY.md는 Claude가 스스로 판단해 기록하는 메모다. MEMORY.md는 첫 200줄 또는 25KB까지만 자동으로 로드된다.

Q

여러 세션이 서로 정보를 공유하게 만들 수 있나요?

공식 기능으로는 아직 세션 간 실시간 메시지 전달이나 공유 스크래치패드가 없다. 커뮤니티가 만든 MCP 기반 메모리 서버나 파일 기반 핸드오프 문서로 대신하는 경우가 많다.

같은 주제 더 보기