Claude Mem

🇨🇳 中文 •
🇹🇼 繁體中文 •
🇯🇵 日本語 •
🇵🇹 Português •
🇧🇷 Português •
🇰🇷 한국어 •
🇪🇸 Español •
🇩🇪 Deutsch •
🇫🇷 Français •
🇮🇱 עברית •
🇸🇦 العربية •
🇷🇺 Русский •
🇵🇱 Polski •
🇨🇿 Čeština •
🇳🇱 Nederlands •
🇹🇷 Türkçe •
🇺🇦 Українська •
🇻🇳 Tiếng Việt •
🇵🇭 Tagalog •
🇮🇩 Indonesia •
🇹🇭 ไทย •
🇮🇳 हिन्दी •
🇧🇩 বাংলা •
🇵🇰 اردو •
🇷🇴 Română •
🇸🇪 Svenska •
🇮🇹 Italiano •
🇬🇷 Ελληνικά •
🇭🇺 Magyar •
🇫🇮 Suomi •
🇩🇰 Dansk •
🇳🇴 Norsk

Claude Code를 위해 구축된 영구 메모리 압축 시스템입니다.

빠른 시작 •
작동 방식 •
검색 도구 •
문서 •
설정 •
문제 해결 •
라이선스

Claude-Mem은 도구 사용 관찰을 자동으로 캡처하고, 의미론적 요약을 생성하며, 이를 향후 세션에서 사용할 수 있게 함으로써 세션 전반에 걸쳐 컨텍스트를 매끄럽게 보존합니다. 이를 통해 Claude는 세션이 종료되거나 다시 연결된 후에도 프로젝트에 대한 지식의 연속성을 유지할 수 있습니다.

빠른 시작
Grok Bot용 claude-mem 설치:

npx claude-mem install --ide grok-bot
Grok Bot에는 호스트 훅이 없으므로 채팅 로그 파일을 감시합니다. 기본값은 호스팅 메모리인 CMEM Pro입니다. 로컬 옵저버는 옵트인 방식입니다: --provider host . 이 플러그인을 설치해도 Cursor는 설치되지 않습니다.

인식 푸시 파일럿(LFG + Orifice): 니들 관찰( decision , bugfix , security_alert , sensitive )이 해당 봇의 memory/log/YYYY-MM.md 에 날짜가 붙은 - YYYY-MM-DD [awareness] … 형식의 줄로 추가됩니다. Grok Bot은 이미 디스크에서 로그를 다시 읽습니다. 이는 profile.md , user-memory 또는 프로젝트 메모리에 기록하지 않습니다. CLAUDE_MEM_GROK_BOT_AWARENESS_ENABLED=false 로 비활성화할 수 있습니다.

단일 명령으로 설치:

npx claude-mem install
설치 프로그램이 먼저 모든 것을 설정한 다음, 브라우저에서 claude-mem에 로그인하도록 요청합니다(이메일 매직 링크 — 카드 불필요). 로그인하면 계정에 대한 메모리 키가 프로비저닝되고 30일 무료 체험과 함께 claude-mem 옵저버가 활성화됩니다: 메모리는 플랜 외부에서 실행되므로 플랜에서 최대 100% 더 많은 사용량을 얻을 수 있습니다. 무료 체험이 끝나면 구독하지 않는 한 메모리는 자동으로 Anthropic 플랜으로 폴백됩니다. 로그인 후 메모리 제공자를 선택합니다 — claude-mem 옵저버, 자체 OpenRouter 또는 Gemini 키, 또는 Anthropic 플랜.

로그인을 건너뛰고 싶으신가요? 명시적 --provider 플래그를 전달하거나, CLAUDE_MEM_ONLINE_OPTIN=false 를 설정하거나, CI/비대화형 셸에서 실행하세요 — 설치 프로그램이 계정 상호작용 없이 완료됩니다.

또는 OpenCode용으로 설치:

npx claude-mem install --ide opencode
OpenCode 2를 포함한 OpenCode 1.3.4 이상에서 작동합니다. 설치 후 OpenCode를 재시작하세요.

또는 T3 Code용으로 설치(Codex 및 Claude Code 제공자):

npx claude-mem install --ide t3code
설치 프로그램은 T3 Code의 활성화된 제공자를 발견하고, 구성된 홈에 네이티브 Claude-Mem 플러그인을 등록하며, T3 관리형 Codex를 지원합니다. T3 Code를 재시작하고, 메시지가 표시되면 제공자의 훅을 신뢰하고, 새 스레드를 시작하세요. 사용자 지정 서버 설정, 상태 및 제거는 T3 Code 통합 가이드를 참조하세요.

또는 Antigravity CLI용으로 설치( 설정 가이드 ):

npx claude-mem install --ide antigravity
또는 OMP(Oh My Pi)용으로 설치:

npx claude-mem install --ide omp
또는 네이티브 Pi 확장 또는 DeepSeek Harness 플러그인 설치:

npx claude-mem install --ide pi
npx claude-mem install --ide dsh --dsh-profile tui
Pi와 DeepSeek Harness는 워커 런타임을 사용합니다. 캡처, 리콜 및 문제 해결은 네이티브 하네스 설정을 참조하세요.

또는 Claude Code 내부의 플러그인 마켓플레이스에서 설치:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem
Claude Code를 재시작하세요. 이전 세션의 컨텍스트가 새 세션에 자동으로 나타납니다.

참고: Claude-Mem은 npm에도 게시되어 있지만, npm install -g claude-mem 은 SDK/라이브러리만 설치하며 — 플러그인 훅을 등록하거나 워커 서비스를 설정하지 않습니다. 항상 npx claude-mem install 또는 위의 /plugin 명령을 통해 설치하세요.

🦞 OpenClaw Gateway
단일 명령으로 OpenClaw 게이트웨이에 영구 메모리 플러그인으로 claude-mem을 설치:

curl -fsSL https://install.cmem.ai/openclaw.sh | bash
설치 프로그램은 종속성, 플러그인 설정, AI 제공자 구성, 워커 시작, 그리고 Telegram, Discord, Slack 등으로의 선택적 실시간 관찰 피드를 처리합니다. 자세한 내용은 OpenClaw 통합 가이드를 참조하세요.

주요 기능:

🧠 영구 메모리 - 세션 전반에 걸쳐 컨텍스트 유지
📊 점진적 공개 - 토큰 비용 가시성을 갖춘 계층적 메모리 검색
🔍 스마트 검색(기본) - 3단계 mem-search 스킬로 프로젝트 기록 쿼리
🖥️ 로컬 My Work - 시작 시 출력되는 워커 URL에서 실시간 요청, 진행 상황, 사람 인계 및 저장된 검토 대기열. 가이드 . 메모리, 세션 및 설정은 /viewer 에 유지됩니다.
👥 TeamBrain - My Work 옆의 선택적 공유 워크스페이스로, 실제 팀 작업 목록, 멤버 기여도 및 연결된 발견 사항 제공. 각 개인은 공유할 항목을 선택하며, 개인 요청과 검토 노트는 별도로 유지됩니다. 팀 설정 .
💻 Claude Desktop Skill - Claude Desktop 대화에서 메모리 검색
🔒 개인정보 제어 - <private> 태그를 사용하여 저장소에서 민감한 콘텐츠 제외
⚙️ 컨텍스트 구성 - 주입되는 컨텍스트에 대한 세밀한 제어
🤖 자동 작동 - 수동 개입 불필요
🔗 인용 - 워커 API를 통해 ID로 과거 관찰 참조 또는 웹 뷰어에서 모두 보기

문서
📚 전체 문서 보기 - 공식 웹사이트에서 탐색

시작하기

설치 가이드 - 빠른 시작 및 고급 설치
사용 가이드 - Claude-Mem이 자동으로 작동하는 방식
검색 도구 - 자연어로 프로젝트 기록 쿼리
클라우드 동기화 - 메모리를 cmem.ai에 백업 — 데몬 없이, 워커가 쓰기 시 동기화

모범 사례

컨텍스트 엔지니어링 - AI 에이전트 컨텍스트 최적화 원칙
점진적 공개 - Claude-Mem의 컨텍스트 프라이밍 전략 뒤의 철학

아키텍처

개요 - 시스템 구성 요소 및 데이터 흐름
아키텍처 진화 - v3에서 v5까지의 여정
훅 아키텍처 - Claude-Mem이 라이프사이클 훅을 사용하는 방식
훅 참조 - 모든 훅 항목 설명
워커 서비스 - HTTP API 및 Bun 관리
데이터베이스 - SQLite 스키마 및 FTS5 검색
검색 아키텍처 - Chroma 벡터 데이터베이스를 사용한 하이브리드 검색

구성 및 개발

구성 - 환경 변수 및 설정
개발 - 빌드, 테스트, 기여
문제 해결 - 일반적인 문제 및 해결책

작동 방식
핵심 구성 요소:

라이프사이클 훅 - SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop, SessionEnd. 각각은 셸 없는 단일 명령인 claude-mem hook claude-code <event> 이며, 설치 프로그램이 PATH에 배치하는 작은 런처에 의해 실행됩니다.
스마트 설치 - 캐시된 종속성 검사기(claude --init / --maintenance 의 Setup 훅, 그리고 npx claude-mem install / repair )
워커 서비스 - 웹 뷰어 UI 및 검색 엔드포인트가 있는 로컬 HTTP API, Bun으로 관리
SQLite 데이터베이스 - 세션, 관찰, 요약 저장
mem-search 스킬 - 점진적 공개를 통한 자연어 쿼리
Chroma 벡터 데이터베이스 - 지능형 컨텍스트 검색을 위한 하이브리드 의미론적 + 키워드 검색

자세한 내용은 아키텍처 개요를 참조하세요.

MCP 검색 도구
Claude-Mem은 토큰 효율적인 3계층 워크플로 패턴을 따르는 4개의 MCP 도구를 통해 지능형 메모리 검색을 제공합니다:

3계층 워크플로:

search - ID가 포함된 간결한 인덱스 가져오기(결과당 ~50-100 토큰)
timeline - 흥미로운 결과 주변의 시간순 컨텍스트 가져오기
get_observations - 필터링된 ID에 대해서만 전체 세부 정보 가져오기(결과당 ~500-1,000 토큰)

작동 방식:

Claude는 MCP 도구를 사용하여 메모리를 검색합니다
search로 시작하여 결과 인덱스를 가져옵니다
timeline을 사용하여 특정 관찰 주변에서 무슨 일이 있었는지 확인합니다
get_observations를 사용하여 관련 ID에 대한 전체 세부 정보를 가져옵니다
세부 정보를 가져오기 전에 필터링하여 ~10배의 토큰 절약

사용 가능한 MCP 도구:

search - 전체 텍스트 쿼리로 메모리 인덱스 검색, 유형/날짜/프로젝트별 필터링
timeline - 특정 관찰 또는 쿼리 주변의 시간순 컨텍스트 가져오기
get_observations - ID로 전체 관찰 세부 정보 가져오기(항상 여러 ID를 일괄 처리)

사용 예:

// 1단계: 인덱스 검색
search ( query = "authentication bug" , type = "bugfix" , limit = 10 )

// 2단계: 인덱스 검토, 관련 ID 식별(예: #123, #456)

// 3단계: 전체 세부 정보 가져오기
get_observations ( ids = [ 123 , 456 ] )
자세한 예는 검색 도구 가이드를 참조하세요.

시스템 요구 사항

Node.js : 20.0.0 이상
Claude Code : 플러그인 지원이 있는 최신 버전
Bun : JavaScript 런타임 및 프로세스 관리자(없으면 자동 설치)
uv : 벡터 검색용 Python 패키지 관리자(없으면 자동 설치)
SQLite 3 : 영구 저장용(번들)

Windows 설정 참고 사항
다음과 같은 오류가 표시되는 경우:

npm : The term ' npm ' is not recognized as the name of a cmdlet
Node.js와 npm이 설치되어 있고 PATH에 추가되어 있는지 확인하세요. https://nodejs.org 에서 최신 Node.js 설치 프로그램을 다운로드하고 설치 후 터미널을 재시작하세요.

Claude Code 훅은 Git Bash가 필요하지 않습니다. 각 훅은 claude-mem을 직접 실행하며, npx claude-mem install 은 해당 런처를 %LOCALAPPDATA%\claude-mem\bin\claude-mem.exe 에 배치하고 해당 폴더를 사용자 Path에 추가합니다. 이후 터미널이나 IDE를 재시작하여 Claude Code가 새 Path를 인식하도록 하세요. 훅이 Executable not found in $PATH: "claude-mem" 을 보고하면 npx claude-mem doctor 를 실행하고 문제 해결을 참조하세요.

설정
설정은 ~/.claude-mem/settings.json 에서 관리됩니다(첫 실행 시 기본값으로 자동 생성). AI 모델, 워커 포트, 데이터 디렉터리, 로그 수준 및 컨텍스트 주입 설정을 구성합니다.

Claude Code 및 Codex SessionStart 컨텍스트에 모든 하네스의 관찰을 포함하려면 해당 파일에 "CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES": "true" 를 설정하거나, 뷰어 설정에서 세션 시작 시 모든 소스 포함을 활성화하세요. 기본값은 "false" 이며, 시작 컨텍스트를 현재 하네스로 제한합니다. 관찰 수 제한은 선택된 소스 전반에 여전히 적용됩니다.

사용 가능한 모든 설정과 예는 구성 가이드를 참조하세요.

모드 및 언어 구성
Claude-Mem은 CLAUDE_MEM_MODE 설정을 통해 여러 워크플로 모드와 언어를 지원합니다.

이 옵션은 다음 두 가지를 모두 제어합니다:

워크플로 동작(예: code, chill, investigation)
생성된 관찰에 사용되는 언어

구성 방법
~/.claude-mem/settings.json 의 설정 파일을 편집하세요:

{
"CLAUDE_MEM_MODE" : " code--zh "
}
모드는 plugin/modes/ 에 정의되어 있습니다. 로컬에서 사용 가능한 모든 모드를 보려면:

ls ~ /.claude/plugins/marketplaces/thedotmack/plugin/modes/
사용 가능한 모드

모드
설명

code
기본 영어 모드

code--zh
중국어 간체 모드

code--ja
일본어 모드

언어별 모드는 code--[lang] 패턴을 따르며, 여기서 [lang]은 ISO 639-1 언어 코드입니다(예: 중국어는 zh, 일본어는 ja, 스페인어는 es).

참고: code--zh (중국어 간체)는 이미 내장되어 있습니다 — 추가 설치나 플러그인 업데이트가 필요하지 않습니다.

모드 변경 후
새 모드 구성을 적용하려면 Claude Code를 재시작하세요.
개발
빌드 지침, 테스트 및 기여 워크플로는 개발 가이드를 참조하세요.

문제 해결
문제가 발생하면 Claude에게 문제를 설명하세요. troubleshoot 스킬이 자동으로 진단하고 수정 사항을 제공합니다.

일반적인 문제 및 해결책은 문제 해결 가이드를 참조하세요.

버그 보고
자동 생성기로 포괄적인 버그 보고서 작성:

cd ~ /.claude/plugins/marketplaces/thedotmack
npm run bug-report
기여
기여를 환영합니다! 다음을 수행하세요:

저장소를 포크합니다
기능 브랜치를 생성합니다
테스트와 함께 변경 사항을 만듭니다
문서를 업데이트합니다
main에 대해 Pull Request를 제출합니다

릴리스는 main에서 출시되어 npm에 게시됩니다.

기여 워크플로는 개발 가이드를 참조하세요.

라이선스
Claude-Mem은 Apache License 2.0에 따라 라이선스가 부여됩니다.

우리는 지속 가능한 에이전트 메모리가 개발자 도구, 로컬 에이전트, MCP 서버, 엔터프라이즈 시스템, 로보틱스 스택 및 프로덕션 에이전트 하네스에 쉽게 내장될 수 있어야 한다고 생각하기 때문에 Apache-2.0을 선택했습니다.

전체 세부 사항은 LICENSE 파일을 참조하세요. docs/license.md 및 docs/ip-boundary를 참조하세요.…