claude-mem 설치 가이드: AI 에이전트의 지속적인 컨텍스트 관리

claude-mem이란?

claude-mem은 AI 에이전트가 각 세션에서 수행한 작업을 기록하고, 이를 AI로 압축하여 다음 세션에 관련 컨텍스트로 다시 주입하는 도구입니다. 이를 통해 에이전트는 이전 대화나 작업 내용을 기억하며 일관성 있고 효율적인 상호작용을 이어갈 수 있습니다. "Persistent Context Across Sessions for Every Agent"라는 소개처럼, AI 에이전트의 기억력을 확장하는 데 중점을 둡니다.

설치 방법

claude-mem은 npx를 사용하여 간편하게 설치할 수 있습니다. 사용 중인 IDE나 환경에 따라 다음 명령어를 선택하여 실행하세요.

1. Grok Bot을 위한 설치

Grok Bot 환경에 claude-mem을 설치하려면 다음 명령어를 사용합니다. Grok Bot은 별도의 호스트 훅이 없어 채팅 로그 파일을 감시하는 방식으로 작동합니다. 설치 시 기본값은 호스팅된 메모리인 CMEM Pro입니다. 로컬 옵저버는 --provider host 옵션으로 활성화할 수 있습니다.

npx claude-mem install --ide grok-bot

이 명령은 Grok Bot의 memory/log/YYYY-MM.md 파일에 인식된 정보(decision, bugfix, security_alert, sensitive 등)를 날짜별로 기록합니다. 이 기능은 CLAUDE_MEM_GROK_BOT_AWARENESS_ENABLED=false로 비활성화할 수 있습니다. 이 설치는 Cursor를 별도로 설치하지는 않습니다.

2. 일반 설치 (가장 간단한 방법)

별도의 IDE 지정 없이 claude-mem을 설치하려면 다음 명령어를 실행합니다.

npx claude-mem install

설치 과정에서 이메일 매직 링크를 통해 claude-mem 계정에 로그인하게 됩니다. 이 과정은 신용카드 정보 없이 진행되며, 메모리 키를 발급받고 30일 무료 체험판이 포함된 claude-mem 옵저버를 활성화합니다. 무료 체험 기간이 끝나면 Anthropic 요금제로 자동 전환되거나, OpenRouter, Gemini 키 또는 Anthropic 요금제를 직접 선택하여 메모리 제공자를 설정할 수 있습니다.

로그인 과정을 건너뛰려면 --provider 플래그를 사용하거나 CLAUDE_MEM_ONLINE_OPTIN=false를 설정하거나, CI/비대화형 쉘에서 실행하면 계정 상호작용 없이 설치가 완료됩니다.

3. OpenCode를 위한 설치

OpenCode 1.3.4 이상 버전에서 claude-mem을 사용하려면 다음 명령어를 실행합니다.

npx claude-mem install --ide opencode

설치 후 OpenCode를 다시 시작해야 합니다.

4. T3 Code (Codex, Claude Code)를 위한 설치

T3 Code 환경에 설치하려면 다음 명령어를 사용합니다.

npx claude-mem install --ide t3code

이 명령어는 T3 Code의 활성화된 제공자를 감지하고, 네이티브 Claude-Mem 플러그인을 등록하며, T3에서 관리하는 Codex도 지원합니다. 설치 후 T3 Code를 다시 시작하고, 프롬프트가 나타나면 제공자의 훅을 신뢰한 후 새 스레드를 시작하세요. 사용자 지정 서버 설정, 상태 및 제거에 대한 자세한 내용은 T3 Code 통합 가이드를 참조하세요.

활용 사례

사례 1: Grok Bot에서 이전 코드 디버깅 정보 활용하기

사용자: Grok Bot을 사용하여 복잡한 JavaScript 코드를 디버깅하고 있었습니다. 특정 함수에서 반복적으로 오류가 발생하여 이전 세션에서 해결했던 유사한 문제를 다시 찾고 싶지만, 대화 기록이 너무 길어 찾기 어렵습니다.

해결 단계:

1. npx claude-mem install --ide grok-bot 명령어를 실행하여 Grok Bot에 claude-mem을 설치합니다.
2. Grok Bot과 이전 디버깅 세션에 대한 대화를 진행합니다. claude-mem은 이 대화 내용을 자동으로 memory/log/YYYY-MM.md 파일에 기록합니다.
3. 새로운 디버깅 세션을 시작합니다. claude-mem은 이전 로그 파일에서 관련 컨텍스트를 자동으로 감지하여 Grok Bot에 제공합니다.

결과: Grok Bot이 이전 디버깅 세션의 정보를 기억하고 있어, 동일한 유형의 오류에 대한 해결책을 더 빠르고 정확하게 제시합니다. 사용자는 이전 대화 내용을 일일이 검색할 필요 없이 문제 해결에 집중할 수 있습니다.

사례 2: OpenCode에서 프로젝트 컨텍스트 유지하며 코드 작성하기

사용자: OpenCode에서 특정 프로젝트의 여러 파일을 작업 중입니다. 현재 파일의 코드를 작성하다가 다른 파일의 함수나 변수에 대한 참조가 필요해졌습니다. 이전에는 파일을 전환할 때마다 컨텍스트를 잃어버려 불편했습니다.

해결 단계:

1. npx claude-mem install --ide opencode 명령어를 실행하여 OpenCode에 claude-mem을 설치합니다.
2. OpenCode를 다시 시작하고, 프로젝트 내 여러 파일을 열어 작업을 진행합니다. claude-mem은 작업 중인 파일과 코드 변경 사항을 추적합니다.
3. 작업 중 다른 파일로 전환하거나 IDE를 재시작해도, claude-mem이 이전 작업 컨텍스트를 유지하여 현재 파일에 대한 관련 정보를 자동으로 제공합니다.

결과: OpenCode 내에서 claude-mem이 활성화되어, 사용자가 여러 파일을 오가며 작업할 때도 프로젝트 컨텍스트를 잃지 않습니다. AI는 현재 작업과 관련된 다른 파일의 코드나 정의를 기억하고 있어, 코드 작성 및 수정 작업의 효율성이 향상됩니다.

주의사항

• claude-mem은 설치 시 계정 로그인 및 유료 구독이 필요할 수 있습니다. 무료 체험 기간을 활용하여 기능을 확인하세요.
• Grok Bot의 경우, CLAUDE_MEM_GROK_BOT_AWARENESS_ENABLED=false 설정을 통해 특정 기능(awareness push)을 비활성화할 수 있습니다.
• T3 Code 환경에서는 설치 후 IDE 재시작 및 제공자 훅 신뢰 과정이 필요합니다.

출처: https://github.com/thedotmack/claude-mem