Claude-Mem: 코딩 에이전트에 지속 메모리를 더하는 시스템
코딩 에이전트의 도구 사용 관찰과 요약을 저장하고 다음 세션에서 관련 내용을 검색·주입하는 지속 메모리 시스템이에요.
주요 기능
- 세션 훅으로 관찰·요약을 수집해 세션이 끝난 뒤에도 프로젝트 맥락을 재사용해요.
- MCP 검색에서 인덱스→시간 흐름→선택 관찰 상세의 단계적 조회를 제공해요.
- 로컬 뷰어·설정과 다양한 에이전트 연동을 제공하며 클라우드 동기화·팀 공유는 선택적 서비스 영역이에요.
구조
TypeScript 기반 설치 CLI·에이전트 훅, Bun으로 관리하는 로컬 HTTP worker, SQLite 기록과 검색 계층으로 구성돼요. README는 Chroma를 통한 의미·키워드 검색을 설명해요. 요약을 생성하는 observer 모델과 로컬 저장소는 구별해야 해요.
누구에게 쓸모 있나요
여러 세션에 걸쳐 프로젝트를 작업하며 이전 결정·버그·진행 상황을 찾아야 하는 AI 코딩 사용자와 도구 개발자.
설치 전 준비
- 정확한 manifest Node 범위는 ^20.19.0 || >=22.12.0, Bun >=1.1.31예요. README의 단순 Node 20+보다 엄격해요.
- Claude Code 플러그인 지원 버전 또는 선택한 지원 harness. Bun·uv는 필요 시 자동 설치될 수 있다고 문서에 나옵니다.
- 선택한 observer 모델의 계정·사용 권한과 데이터 보관 공간이 필요해요.
- 로컬 Node·Bun 환경 및 Claude Code 플러그인
- Windows 실행기/PATH 설정 안내 포함
- OpenCode·T3 Code·Pi 등 별도 IDE/에이전트 통합 경로
설치 방법
공식 설치 CLI
기본 설치는 브라우저 계정 로그인과 observer 선택을 안내할 수 있어요. 명시적 –provider, CLAUDE_MEM_ONLINE_OPTIN=false 또는 비대화식 환경은 계정 상호작용을 건너뛴다고 README에 설명해요.
npx claude-mem installClaude Code 마켓플레이스 대안
설치 후 Claude Code를 재시작해요. npm 전역 설치만으로는 훅과 worker 설정이 등록되지 않는다고 문서가 경고해요.
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem사용 방법
- observer 공급자와 저장·동기화 설정을 확인한 뒤 새 세션에서 작업해요.
- 검색 결과의 작은 인덱스를 먼저 보고 필요한 관찰 상세만 요청해요.
- ~/.claude-mem/settings.json 또는 뷰어에서 주입 범위·모델·로그 설정을 조정하고 민감 내용은 저장 전에 제외해요.
비용과 API 키
Apache-2.0 공개 코드는 무료지만 observer 모델 호출·클라우드·팀 기능은 별도 조건이에요. README는 호스팅 observer 30일 체험과 종료 후 Anthropic 플랜으로의 대체 경로를 설명하므로 무료 체험 종료가 전체 무비용을 뜻하지 않습니다. 사용량 절감 주장은 독립 실측하지 않았어요.
라이선스
확인 커밋의 루트 LICENSE는 Apache-2.0예요. docs/ip-boundary.md는 코어·서버·CLI·SDK 등을 공개 범위로, hosted cloud·팀 동기화·기업 관리 기능 등을 상용/비공개 영역으로 구분해요.
주의사항과 알려진 이슈
- 도구 출력·프로젝트 맥락을 지속 저장하므로 비밀·개인정보가 기억에 들어가지 않도록 보관·삭제·제외 정책이 필요해요.
- 로컬 데이터베이스라도 observer에 보내는 내용과 Cloud Sync는 외부 전송일 수 있어요. 공급자와 동기화 설정을 확인해야 해요.
- 스크린샷 보관은 기본 꺼짐이며 클라우드 업로드·이미지 추론은 각각 별도 설정이에요. 켜기 전 민감 화면 포함 여부를 검토해요.
- 자동 설치는 의존성·PATH·훅 설정을 바꿀 수 있어요. 기존 설정 백업과 변경 검토가 필요하며 <private> 태그만으로 보안 감사를 대체하지 않습니다.
확인 범위
확인 날짜: 2026-11-02
확인 커밋: 26ccf4d8a029d97fb5fb88a9f1ddd73729ad1b1a
확인한 범위: 공식 GitHub main 커밋을 조회하고 해당 커밋에 고정된 README.md, package.json, LICENSE, docs/ip-boundary.md를 정적으로 확인했어요. 공개 이슈 개별 재현·상태 전수 조사는 하지 않았어요.
확인 한계: 저장소 코드·의존성을 설치하거나 실행하지 않았어요. 계정 연결·모델 호출·과금·빌드·기기별 동작·성능·전체 보안 감사는 미검증이며 안내는 공식 문서 기준이에요.