Plugin ★ 59.8k

Claude-Mem

claude-mem.ai → thedotmack/claude-mem →
#메모리#컨텍스트#세션#검색#Progressive Disclosure

업데이트

💡

Claude Code 세션의 모든 작업을 자동으로 관찰·압축해 다음 세션에 필요한 컨텍스트만 다시 주입하는 영구 메모리 플러그인.

🔓
세션 간 컨텍스트 지속 새로운 능력
설치 방법 · plugin marketplace (thedotmack/claude-mem)
Claude Code (플러그인 마켓플레이스) $ /plugin marketplace add thedotmack/claude-mem && /plugin install claude-mem
NPX (범용) $ npx claude-mem install
Gemini CLI $ npx claude-mem install --ide gemini-cli
OpenCode $ npx claude-mem install --ide opencode

왜 필요한가?

Claude Code 세션을 새로 시작할 때마다 이전 대화의 결정, 수정한 파일, 해결한 버그 등을 다시 설명해야 합니다. 세션이 길어지면 컨텍스트 윈도우를 다 써버려 /compact로 압축하는 수밖에 없고, 그 과정에서 중요한 세부가 손실됩니다.

Claude-Mem은 세션 중 Claude가 수행한 작업을 백그라운드 관찰자 에이전트가 실시간으로 기록·분류하고, AI로 압축해 저장합니다. 다음 세션이 시작되면 프로젝트 히스토리에서 관련 항목만 자동으로 주입되어, 반복 설명 없이 작업을 이어갈 수 있습니다.

주요 기능

  • 실시간 관찰(Observation) — 전담 관찰자 에이전트가 세션 중 검색 가능한 “관찰”을 생성. 의사결정·버그 수정·기능 추가·발견 등으로 자동 분류
  • Progressive Disclosure — 세션 시작 시 가벼운 인덱스(~2.1k 토큰)만 로드, 필요할 때 상세 관찰(~850 토큰)을 추가 로드. 토큰 비용 가시화
  • mem-search 스킬 — 자연어로 프로젝트 이력 질의 (예: “token refresh 관련 결정 찾아줘”, “index.ts에 영향 준 결정은?”)
  • Web Viewer — http://localhost:37777에서 메모리 스트림 실시간 확인 및 관리
  • Claude Desktop 스킬 — Desktop 앱 대화에서도 동일한 메모리 검색 사용 가능
  • Privacy 제어 — <private> 태그로 감싼 내용은 저장에서 제외
  • Citation — 관찰 ID로 과거 기록 참조. 어디서 온 정보인지 추적 가능
  • 자동 작동 — 설치 후 추가 조작 없이 백그라운드에서 동작

지원 환경

클라이언트지원
Claude Code✓ (플러그인 또는 NPX)
Claude Desktop✓ (메모리 검색 스킬)
Gemini CLI✓ (--ide gemini-cli)
OpenCode✓ (--ide opencode)
Cursor IDE✓ (문서 내 통합 가이드 제공)

요구 사항

  • Node.js 18.0.0 이상
  • Claude Code (플러그인 지원 버전)
  • Bun, uv, SQLite 3 — 설치 과정에서 자동 설치/번들

알아두면 좋은 점

  • 작성자는 Alex Newman(@thedotmack), 공식 문서에서 아키텍처·통합 가이드·고급 설정 확인
  • 라이선스는 AGPL-3.0 — 네트워크 서비스 형태로 배포 시 소스 공개 의무 발생. 단, ragtime/ 디렉토리는 PolyForm Noncommercial License 적용
  • 베타 채널에서 Endless Mode 등 실험적 기능 사용 가능
  • claude.com/plugins에 등록된 플러그인이 아니므로 마켓플레이스 추가(/plugin marketplace add thedotmack/claude-mem) 후 설치 필요

자주 묻는 질문

Claude-Mem은 무엇인가요?

Claude Code 세션 중 작업을 백그라운드 관찰자 에이전트가 실시간으로 기록·분류·압축해 저장하고, 다음 세션 시작 시 관련 항목을 자동으로 주입하는 영구 메모리 플러그인입니다. Alex Newman(@thedotmack)이 만들었습니다.

어떤 환경에서 동작하나요?

Claude Code, Claude Desktop, Gemini CLI, OpenCode, Cursor IDE에서 동작합니다.

어떻게 설치하나요?

Claude Code에서는 마켓플레이스 추가 후 설치합니다: `/plugin marketplace add thedotmack/claude-mem && /plugin install claude-mem`. NPX를 통한 범용 설치(`npx claude-mem install`) 또는 Gemini CLI·OpenCode 전용 옵션도 지원합니다.

사전 요구 사항은 무엇인가요?

Node.js 18.0.0 이상과 Claude Code(플러그인 지원 버전)가 필요합니다. Bun, uv, SQLite 3는 설치 과정에서 자동으로 설치되거나 번들됩니다.

라이선스는 어떻게 되나요?

AGPL-3.0이며, 네트워크 서비스 형태로 배포 시 소스 공개 의무가 발생합니다. 단, `ragtime/` 디렉토리는 PolyForm Noncommercial License가 적용됩니다.

민감한 내용을 메모리에서 제외할 수 있나요?

네. `<private>` 태그로 감싼 내용은 저장에서 제외됩니다.