← 블로그로
Ai약 11 분 읽기

claude-mem, 기억을 저장하는 대신 압축하는 에이전트 메모리

게시일 2026년 11월 2일
claude-mem, 기억을 저장하는 대신 압축하는 에이전트 메모리

모든 코딩 에이전트에는 같은 민망한 버릇이 있습니다. 인증 미들웨어는 왜 건드리면 안 되는지, 레거시 설정이 어디 숨어 있는지, 어느 두 테스트가 일부러 불안정한지 한나절 설명합니다. 그리고 노트북을 덮죠. 다음 날 아침 에이전트는 처음 보는 사람처럼 인사하고, 건드리지 말라고 했던 바로 그 파일을 상쾌하게 리팩터링하자고 제안합니다.

claude-mem이 겨냥하는 게 그 간극이고, 숫자를 보면 꽤 많은 사람이 같은 걸 느낀 모양입니다. 저장소는 대략 11만 스타, 지난주에만 약 5,850개가 붙었고, 며칠째 GitHub 주간 트렌딩 1위입니다. Alex Newman의 이 프로젝트는 스스로를 Claude Code용 '지속형 기억 압축 시스템'이라고 소개합니다. 여기서 중요한 단어는 저장이 아니라 압축입니다.

실제로 저장되는 것

구조는 홍보 문구만큼 마법 같지 않습니다. claude-mem은 Claude Code가 이미 노출하는 생명주기 훅에 자신을 등록합니다. SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop, SessionEnd입니다. 각 훅은 claude-mem hook claude-code <event> 한 줄이고, 설치 프로그램이 PATH에 떨어뜨린 작은 런처가 이걸 실행합니다.

작업하는 동안 도구 호출은 '관찰'로 바뀝니다. 에이전트가 무엇을 했고 무슨 일이 일어났는지에 대한 짧은 의미 메모죠. Bun으로 관리되는 백그라운드 워커 서비스가 이걸 SQLite에 씁니다. 새 세션이 시작되면, 당신이 뭔가를 입력하기 전에 관련도 높은 관찰들이 컨텍스트로 다시 주입됩니다.

스택에는 의미 검색용 Chroma 벡터 데이터베이스도 있고, 키워드 검색용 SQLite FTS5도 있습니다. 실전에서는 이 혼합이 중요합니다. “화요일 그 마이그레이션 스크립트”는 키워드 질의고, “토큰 갱신이 조용히 실패하던 그거”는 의미 질의입니다. 그리고 사람은 둘 다 입력합니다.

두 가지 디테일은 짚고 갈 만합니다. 프로젝트가 실전에서 굴러 본 흔적이니까요. 첫째, <private> 태그. 이걸로 감싼 내용은 절대 저장되지 않습니다. 둘째, 스크린샷은 옵트인이고 기본값은 꺼짐이며, 이미지 추론을 따로 켜야만 관찰 모델로 갑니다. 기억 도구가 조용히 감시 도구가 되는 실패 모드를 누군가 생각해 본 겁니다.

A wooden card catalog drawer pulled open, index cards fanned out under soft blue light

3단계 검색이라는 장치

제가 진짜 잘 짰다고 본 부분은 검색 표면입니다. 기억을 컨텍스트에 쏟아붓고 모델이 알아서 정리하길 바라는 대신, claude-mem은 3단계 MCP 워크플로를 내놓습니다.

search는 ID가 붙은 압축 인덱스를 돌려줍니다. 결과 하나당 대략 50~100 토큰입니다. timeline은 흥미로운 결과 주변의 시간순 맥락을 줍니다. get_observations는 전체 내용을 가져오는데, 개당 500~1,000 토큰이지만 실제로 고른 ID에만 적용됩니다. README는 가져오기 전에 걸러서 토큰을 약 10배 아낀다고 하는데, 주장의 모양이 맞습니다. 능력의 문제가 아니라 회계의 문제라는 거죠.

이게 기억 시스템과 컨텍스트 윈도의 차이입니다. 더 큰 창은 매 턴마다 내는 정액 비용입니다. 점진적 공개는 찾아볼 때만 내는 비용이고요. 긴 세션이 낡은 도구 출력에 토큰을 태우는 걸 본 사람이라면 어느 쪽이 확장되는지 압니다.

설치는 한 줄, 그게 요점이다

정석 경로는 이렇습니다.

npx claude-mem install

--ide opencode, --ide t3code, --ide pi, --ide antigravity 등 몇 가지와 함께 쓸 수 있고, 훅이 없는 호스트를 위해 채팅 로그를 지켜보는 Grok Bot 모드도 있습니다. Claude Code 안에서는 플러그인 마켓플레이스로도 됩니다.

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

Node 20 이상이 필요합니다. Bun과 uv는 없으면 자동으로 끌어옵니다. Windows에서는 설치 프로그램이 %LOCALAPPDATA%\claude-mem\bin에 런처를 넣고 사용자 PATH에 추가합니다. 훅이 실행 파일을 못 찾는다고 하면 npx claude-mem doctor가 트러블슈팅 입구입니다.

README에서 반복해 강조하는 함정이 하나 있습니다. npm install -g claude-mem은 SDK만 설치합니다. 훅을 등록하지도, 워커를 세팅하지도 않습니다. 그래서 아무 일도 일어나지 않고, 당신은 이 도구가 고장 났다고 생각하게 됩니다.

마음이 편치 않은 부분

설치 중에 이메일 매직 링크로 로그인하라는 요청이 나옵니다. 카드는 필요 없습니다. 로그인하면 기억 키가 발급되고 30일 체험판이 붙은 호스팅 관찰자가 열립니다. 체험이 끝나면 구독하지 않는 한 기억은 당신의 Anthropic 플랜으로 되돌아갑니다. --provider를 넘기거나 CLAUDE_MEM_ONLINE_OPTIN=false를 설정하거나 CI에서 돌리면 전부 건너뛸 수 있습니다. 여기까지는 괜찮습니다.

그런데 README 아래쪽에 “What About CMEM?”이라는 절이 있습니다. CMEM은 제3자가 만든 토큰이고, 프로젝트 저자가 “공식적으로 받아들였다”는 설명이 컨트랙트 주소와 함께 붙어 있습니다.

그렇다고 이 소프트웨어가 나쁘다는 건 아닙니다. 코드는 Apache-2.0이고 구조가 문서화돼 있으며, 라이선스 선택도 개발 도구에 지속형 기억을 심는 데 걸겠다는 베팅이라고 명시적으로 설명합니다. 하지만 밈코인을 함께 배포하고, 기억을 시작하기 전에 로그인을 요구하는 기억 시스템은 특정한 종류의 신뢰를 요구하는 겁니다. 사설 저장소에 들이대기 전에 그 신뢰를 줄지 말지 결정하세요. 로컬 전용 경로는 있습니다. 우연이 아니라 의도적으로 쓰면 됩니다.

기억이 실제로 에이전트를 낫게 만드나

솔직한 답은 '덜 반복하게 만든다'입니다. 같은 말은 아닙니다. 기억된 관찰은 과거에 대한 주장이고, 코드베이스는 그사이 움직였을 가능성이 큽니다. 주입된 컨텍스트가 “마이그레이션은 db/legacy.ts에 있다”고 하는데 누군가 3주 전에 그 파일을 쪼갰다면, 당신은 에이전트에게 지식을 준 게 아니라 낡은 사실에 대한 확신을 준 겁니다.

이 지점에서 claude-mem의 자기 규정이 도움이 됩니다. 관찰은 ID로 인용되고, 워커 URL의 로컬 뷰어에서 직접 확인할 수 있습니다. 진실이 아니라 메모로 취급하세요. 여기서 값을 뽑아내는 프로젝트는 쌓기만 하는 곳이 아니라 쳐내는 곳일 겁니다.

2차 효과도 있고, 제가 주시하는 건 이쪽입니다. 기억은 에이전트가 묻지 않고 하는 일의 범위를 바꿉니다. 이력이 있는 에이전트는 지난주에 물려받은 가정 위에서 기꺼이 나아갑니다. 그건 생산성 향상이고, 아주 비싼 오해가 되는 순간까지는요.

누가 쓸 만한가

에이전트 세션이 짧고 그 자체로 완결된다면 건너뛰세요. 오버헤드가 값을 못 하고, 새 컨텍스트는 그 자체로 기능입니다.

저장소 하나를 며칠에 걸쳐 다루거나, 같은 아키텍처 결정을 계속 다시 설명하거나, 병렬 에이전트들이 서로의 결론을 알아야 한다면, 지금 이 아이디어의 가장 완성도 높은 공개 구현입니다. 설치가 한 줄이라 실험 비용은 10분입니다.

기대치는 맞춰 놓고 들어가세요. claude-mem은 에이전트에게 기억을 주지 않습니다. 서류 캐비닛과 검색 도구, 그리고 뭔가를 적어 두는 습관을 줄 뿐입니다. 그 메모가 아직 사실인지는 언제나처럼 당신 몫입니다.

관련 글