여러 날에 걸쳐 Claude Code나 Codex로 코딩하면서 지난 결정과 테스트 실패 원인을 매번 다시 설명하는 개발자는 claude-mem을 고려할 만합니다. 작업 중 관찰과 세션 요약을 저장하고, 다음 세션에 맥락을 넣거나 과거 기록을 검색하는 도구입니다. 반복 설명을 줄일 여지는 있지만, 어떤 내용을 저장하고 어떤 제공자에게 보내는지 동의할 수 있는 팀부터 작은 시험 프로젝트에서 평가하는 데 맞습니다. 아래 판단은 2026년 10월 6일 문서 조사와 v13.31.0 릴리스에 근거합니다. (공식 저장소)

한눈에 보기

궁금한 점 확인한 내용
어떤 문제에 맞습니까? 여러 세션에 흩어진 버그 원인·해결 과정·설계 결정을 다시 찾는 작업에 맞습니다.
기억을 어떻게 만듭니까? 세션 요청과 도구 사용을 수집하고 모델이 관찰·요약을 생성합니다.
어디에 남깁니까? 로컬 SQLite에 기록합니다. 클라우드 동기화는 CMEM Pro 구독자가 설정했을 때만 cmem.ai 서버로 복제합니다.
무엇이 추가됩니까? 플러그인 연결, 런타임 의존성, 백그라운드 워커와 검색 도구가 추가됩니다.
비용은 어떻게 나뉩니까? 코드는 Apache-2.0으로 무료입니다. 기억 처리는 CMEM Pro(최대 14일 체험 뒤 구독), 개인 API 키 과금, 기존 Anthropic 플랜 사용량 중 하나로 나갑니다.
설치기의 기본 선택은? 기억 제공자 화면에서 CMEM Pro가 미리 선택돼 있습니다. 비용을 늘리지 않으려면 직접 바꿉니다.
검토한 버전은 무엇입니까? 2026년 10월 5일 공개된 v13.31.0, 커밋 a1a1f0a입니다.
도입 판단은 무엇입니까? 특정 상황에 유용합니다. 여러 세션에서 과거 판단을 자주 다시 찾고, 수집·전송 범위에 동의할 수 있을 때 시험할 만합니다.

구조와 이용 조건은 README와 공식 소개, 기준 버전은 릴리스에서 확인했습니다. GitHub Trending의 2026년 10월 6일 원문 사본에는 누적 96,622 stars, 당일 534 stars today가 표시됩니다. 이는 프로젝트를 발견한 인기 신호로만 사용하며, 기억의 정확도나 보안 평가로 해석하지 않습니다. (Trending)

어떤 작업에 도움이 됩니까?

가령 어제 테스트를 고쳤는데 오늘 새 세션에서 같은 오류를 다시 조사하는 상황입니다. 당시에는 테스트 코드 문제가 아니라 환경 변수의 로딩 순서가 원인이었고, 테스트 실행 전에 설정을 읽도록 바꿨습니다. 현재 코드에는 수정이 남아 있어도 ‘왜 이 순서인가’와 ‘이미 확인한 가설은 무엇인가’는 대화 기록에 흩어질 수 있습니다. claude-mem이 겨냥하는 것은 이 판단 과정을 다음 작업에서 찾아 쓰는 일입니다.

공식 소개는 세션 시작의 맥락 주입(최근 10개 세션의 맥락), 사용자 요청 저장, 도구 실행 관찰, 워커의 학습 내용 추출, 세션 요약 순서로 설명합니다. 워커는 코딩 에이전트의 작업 이벤트를 처리하는 별도 프로세스이고, 관찰은 그 과정에서 알아낸 버그 수정·결정·발견 등을 정리한 기록입니다. 따라서 저장되는 기억의 재료에는 최종 답변 외에 파일을 읽고 수정하며 알아낸 내용도 포함됩니다. (동작 흐름)

수일 동안 같은 저장소를 다루거나 서로 다른 작업 세션에서 과거의 선택을 자주 확인하는 개발자에게 이 구조가 유용할 수 있습니다. 반대로 일회성 수정 하나로 끝나는 프로젝트에서는 설치와 기록 관리가 더 큰 일이 될 수 있습니다. 모든 팀에 자동 기록을 추가하기보다, 이미 반복되는 질문 한 개를 골라 그 질문을 다시 찾는 데 도움이 되는지 평가합니다.

기존 도구와 무엇이 다릅니까?

수동으로 유지하는 CLAUDE.md·AGENTS.md는 프로젝트 규칙, 실행 명령, 금지 사항처럼 오래 유지할 지침을 적는 데 적합합니다. claude-mem은 작업 중 생긴 관찰을 저장·요약·검색하고 다음 세션에 전달하는 역할을 추가합니다. 여기서 비교하는 기준은 지침 파일과 수동 기록이며, 코딩 도구마다 제공하는 모든 기본 메모리 기능의 우열을 평가한 결과는 포함하지 않습니다.

기록 방식 개발자가 하는 일 다음 세션에서 확인하는 내용
지침 파일 팀이 유지할 규칙을 직접 편집합니다. 테스트 명령, 코드 관례, 작업 제한을 읽습니다.
수동 작업 일지 중요한 결정과 실패 원인을 골라 적습니다. 사람이 남긴 이유와 링크를 찾아 읽습니다.
claude-mem 수집·요약·주입 범위와 제공자를 설정합니다. 최근 관찰의 맥락을 받고 관련 기록을 검색합니다.

README는 search로 작은 결과 목록을 받고, timeline으로 주변 시점의 맥락을 살펴본 다음, get_observations로 선택한 기록의 자세한 내용을 가져오는 흐름을 설명합니다. 처음부터 전체 기록을 읽는 대신 필요한 관찰을 좁혀 가는 방식입니다. 저장소에 적힌 토큰 절감 주장은 프로젝트 측 설명이며, 이 블로그의 작업 비용 측정값으로 옮기지 않습니다. (검색 구조)

여러 에이전트의 기록이 기본으로 모두 합쳐지는 것은 아닙니다. README에 따르면 세션 시작에서 모든 실행 도구의 관찰을 포함하는 CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES의 기본값은 false입니다. Claude Code와 Codex 사이의 기록 공유를 원한다면 주입 대상을 따로 검토합니다. 팀 지침은 직접 관리하고, 찾은 과거 관찰은 현재 파일·테스트 결과와 대조하세요. (설정 안내)

어떻게 사용합니까?

구체적인 시험 작업은 **‘지난 세션의 환경 변수 문제를 다음 세션에서 찾아 설명하기’**로 정합니다. 아래 입력은 문서의 기능을 적용한 시험 설계이며 실제 실행 결과가 아닙니다. 테스트 실패를 만들기 위해 운영 설정을 바꾸기보다, 비밀값 없는 예제 프로젝트의 기존 실패를 사용합니다.

  1. 첫 세션에서 ‘설정 파일은 존재하는데 테스트에서 환경 변수가 비어 있는 원인을 찾고, 수정 전후 결과와 변경 이유를 정리해 주세요’라고 요청합니다. 입력은 예제 코드, 실패 로그, 변수 이름이며 실제 API 키는 제외합니다.
  2. 에이전트가 파일을 읽고 테스트를 조사하는 동안 관찰이 저장되는지 확인합니다. 해결 뒤에는 로컬 뷰어에서 원인과 수정 내용이 구분되어 기록됐는지 살펴봅니다. 공식 소개에 따르면 세션 종료 때 다음 세션용 요약을 생성합니다.
  3. 새 세션에서 ‘지난 세션에서 환경 변수 때문에 테스트가 실패한 이유와 고친 방법을 찾아 주세요’라고 요청합니다. 시작 맥락에 없으면 검색으로 관련 관찰을 좁히고 상세 기록을 확인합니다.
  4. 기대 결과는 원인, 바꾼 파일, 수정 이유, 확인했던 테스트를 과거 기록과 연결하는 설명입니다. 현재 코드와 테스트를 다시 대조해 당시의 해결이 지금도 적용되는지 확인합니다.

관찰에 ‘실패했다’만 남고 원인이나 변경 이유가 빠지면 기대한 기억을 얻었다고 평가하기 어렵습니다. 반대로 요약이 과거의 추정을 확정된 원인처럼 전달하면 재조사에 혼선을 줍니다. 시험에서는 원자료와 요약을 나란히 보고, 같은 질문에 수동 일지를 읽는 경우와 어떤 차이가 있는지 기록합니다. 자동 주입에 원하는 기록이 포함되는지와 검색으로 찾을 수 있는지는 별도 항목으로 봅니다. (수집·요약 흐름, 검색 단계)

설치와 이용 조건

최소 시작 명령은 다음과 같습니다. 패키지명은 claude-mem이며 버전과 추가 플래그를 지정하지 않는 공식 명령입니다. 따라서 실행 당시 배포된 패키지와 이 글의 검토 버전이 같을지는 설치 전에 확인합니다. (설치 안내)

npx claude-mem install

설치 문서는 런타임 준비, 로그인, 기억 제공자 선택의 세 단계로 설명합니다. 설치기는 사용 중인 IDE를 감지하고 연결할 대상을 고르게 하며, 플러그인 파일·등록·의존성을 준비합니다. Claude Code가 없으면 설치도 제안합니다. 이 명령은 사용자 환경에 파일을 설치하고 에이전트 연결을 바꿉니다. 로그인 단계는 기기 코드를 보여 주고 브라우저에서 인증하는 방식이며, 이어지는 제공자 선택 화면에서는 CMEM Pro가 미리 선택돼 있습니다. 그대로 넘기면 체험 뒤 구독으로 이어지는 호스팅 제공자를 고르게 되므로, 비용 조건을 정하지 않았다면 이 화면에서 선택을 직접 바꿉니다. --provider claude는 자기 Anthropic 플랜으로 기억을 처리하고 로그인 단계를 건너뛰는 공식 선택지이며, 압축에 쓸 Claude 모델(Haiku·Sonnet·Opus)도 고릅니다. --provider host는 이미 로그인된 에이전트를 로컬로 연결하는 선택형 옵션입니다. (설치기의 단계와 옵션)

공식 소개의 요구 조건은 Node.js 20.0.0 이상, Bun 1.0 이상, uv, 지원하는 코딩 도구입니다. Bun과 uv는 없으면 자동 설치하며, SQLite는 bun:sqlite로 포함됩니다. 소개 문서에는 Claude Code 외 Cursor·Windsurf·OpenCode·Codex CLI 등의 경로가 있습니다. 설치 문서는 의존성 준비가 Windows·macOS·Linux에서 동작한다고 설명하지만, 각 IDE와 OS의 모든 기능을 조합한 호환성 표는 이번 조사에서 미확인입니다. 한국에서의 계정 가입·결제와 한국어 기억 검색 품질도 미확인입니다. (요구 조건, 설치 후 확인)

Claude Code 안의 별도 설치 경로는 아래 두 명령 뒤 재시작하는 절차입니다. README는 npm install -g claude-mem이 SDK·라이브러리만 설치하며 플러그인 훅과 워커 설정을 대신하지 않는다고 명시합니다. 훅은 세션 시작·도구 사용·종료 같은 이벤트에 연결해 동작하는 기능입니다. (공식 설치 경로)

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

비용과 라이선스

공개 코드를 로컬에 설치하는 비용과 관찰·요약을 만드는 모델 비용을 구분합니다. README는 기억 제공자로 claude-mem observer, 개인 OpenRouter·Gemini 키, Anthropic 플랜 등을 설명합니다. 기존 구독을 연결하면 기억 처리도 해당 플랜의 사용량에 영향을 줄 수 있고, 개인 API 키를 연결하면 그 제공자의 과금 조건을 따릅니다. 기록은 로컬 데이터베이스에 남지만, 관찰을 요약하는 일은 고른 제공자의 모델이 합니다. 설치 문서는 Anthropic 플랜을 고르면 프롬프트를 cmem.ai로 보내지 않고, 가입 때 숫자만 담은 사용량 요약(관찰 수·토큰 합계, 프롬프트·경로·프로젝트명 제외)만 보낸다고 설명합니다. (제공자 선택)

README는 claude-mem observer의 무료 체험을 최대 14일로 안내하며, 구독하지 않으면 Anthropic 플랜으로 돌아간다고 설명합니다. CMEM Pro의 구체적인 요금액은 확인한 자료에서 미확인입니다. 무료 체험 뒤 기억 처리가 계속되면 기존 플랜 사용량으로 비용이 옮겨갈 수 있다는 점까지 예산에 넣습니다. 설치 문서는 CMEM Pro 선택 시 체험·체크아웃 화면이 열리는 절차를 안내합니다. (체험 안내, 제공자 설정 절차)

코드 라이선스는 Apache-2.0입니다. 상업 이용, 수정, 재배포를 허용하며 재배포에는 라이선스 사본, 변경 표시, 관련 권리 고지와 적용되는 NOTICE 고지를 유지하는 조건이 있습니다. 상표 사용 권한과 모델·클라우드 서비스의 이용 조건은 별도로 확인합니다. (v13.31.0 LICENSE)

클라우드 동기화의 데이터 범위는 비용과 함께 판단할 조건입니다. 공식 문서는 관찰, 세션 요약, 사용자 프롬프트를 복제한다고 설명하고, 관찰 서술과 전체 프롬프트가 cmem.ai 계정의 동기화 서버로 올라간다고 명시합니다. 200KB를 넘는 프롬프트는 처음 200KB와 잘림 안내를 업로드하고 원본은 수집한 기기에 남깁니다. 동기화는 cmem.ai Pro 전용이고 따로 켜는 스위치가 없습니다. ~/.claude-mem/settings.json의 CLAUDE_MEM_CLOUD_SYNC_TOKEN·CLAUDE_MEM_CLOUD_SYNC_USER_ID·CLAUDE_MEM_CLOUD_SYNC_HUB_URL 세 값이 모두 채워지면 동작하고, 하나라도 비우면 꺼집니다. 시험 전에 이 세 값이 비어 있는지 확인하면 동기화 여부를 직접 판단할 수 있습니다. 제공자에게 요약을 요청하는 흐름과 기기 간 동기화를 위해 기록을 복제하는 흐름을 각각 검토합니다. 회사 코드나 고객 정보를 포함하는 팀은 저장·전송 허용 범위를 먼저 정한 뒤 예제 기록으로 시작합니다. (동기화와 개인정보 조건)

한계와 유지보수

가장 먼저 확인할 한계는 과거 기억과 현재 지침이 만나는 지점입니다. 이슈 #2837은 v13.4.0에서 저장소 루트 AGENTS.md에 생성 맥락이 붙어 작업본이 변경된다고 보고했습니다. 이 이슈는 닫혔고, 추가 확인한 PR #2862는 2026년 6월 9일 병합되었으며 네이티브 훅을 사용하는 Codex transcript watch의 AGENTS.md 쓰기 억제를 포함합니다. 이 수정 범위 밖의 연동에서는 시험 전후 작업본을 비교해 파일 쓰기 여부를 확인하세요. (원보고 #2837, 병합된 수정 #2862)

현재 문서에는 폴더별 CLAUDE.md 활동 기록을 생성하는 별도 기능도 있습니다. 이 기능은 기본적으로 꺼져 있고 설정 키는 CLAUDE_MEM_FOLDER_CLAUDEMD_ENABLED입니다. 켜면 관찰을 바탕으로 각 하위 폴더의 CLAUDE.md에 활동 타임라인을 <claude-mem-context> 태그 안에 쓰고, 태그 밖에 사람이 적은 내용은 유지합니다. .git이 있는 프로젝트 루트는 수동 문서를 지키기 위해 제외됩니다. 시작 맥락 주입, 폴더 파일 생성, 과거 Codex 파일 쓰기 문제를 구분해 검토하면 자동 기억 기능의 영향을 더 정확히 파악할 수 있습니다. 시험 전후 git status --short와 git diff -- AGENTS.md CLAUDE.md로 루트를 확인하고, 새 하위 폴더 파일도 함께 살펴봅니다. (폴더 맥락 기능, 기본 설정)

유지보수는 최근 릴리스에서 확인됩니다. v13.31.0은 세션 시작의 데이터베이스 조회를 개선하고 클라우드 동기화를 기다리지 않고 로컬 기록으로 시작하도록 바꿉니다. v13.30.1은 Claude Code 대화 재개 때 새 맥락을 다시 주입하지 않도록 수정하고, v13.30.0은 워커 대기·검색·로그인 등 여러 문제를 다룹니다. 시작 지연과 재개 동작을 계속 고치고 있습니다. 릴리스의 성능 수치는 프로젝트 측 측정이며, 우리 환경에서 직접 잰 결과는 아닙니다. (릴리스 기록)

공식 Cloud Sync 문서에는 세션 시작 시 동기화를 먼저 당긴다는 설명이 남아 있는 반면, 최신 릴리스는 로컬 기록으로 즉시 시작하고 동기화는 배경에서 진행한다고 설명합니다. 시작 동작은 최신 릴리스 기준으로 읽고, 다른 기기의 새 기억이 즉시 보이는지는 별도 시험 항목으로 둡니다. 기록이 많이 쌓이면 요약의 정확도, 필요한 관찰의 검색 가능성, 주입량과 실제 제공자 사용량도 확인합니다. (동기화 설명, v13.31.0 변경)

확인한 범위

문서 확인: 공식 README·소개·릴리스·이슈·Cloud Sync와 설치·설정·폴더 맥락·LICENSE·병합 PR을 대조했습니다. 기준 리비전은 v13.31.0의 a1a1f0a입니다. 문서 사이트는 2026년 10월 6일 열람 내용이며, 모든 문서를 그 커밋에 고정하거나 저장소 전체 코드를 감사한 범위는 포함하지 않습니다. 스타 수는 같은 날 확인한 Trending의 표시값입니다.

직접 실행: 직접 실행하지 않았습니다. 환경 변수 예시는 독자가 평가할 입력·절차·기대 결과를 구체화한 시험 설계입니다. 설치, 모델 연결, 브라우저 인증, 한국어 검색, 최신 버전의 실제 파일 변경과 비용 측정은 미확인입니다. 대표 그림은 세션 기억을 옮기는 개념 일러스트입니다.

도입 판단

특정 상황에 유용합니다. 여러 세션에 걸친 문제 해결에서 과거 판단을 자주 찾아야 하고, 자동 수집·요약·주입의 데이터 흐름을 허용할 수 있는 개발자에게 시험 가치가 있습니다. 짧은 작업이나 수동 지침·일지만으로 맥락을 유지하는 팀은 현재 방식을 계속 쓰는 선택도 합리적입니다. 아직 확인 전인 검색 품질과 실제 지출을 수치로 기대하기보다, 반복되는 질문을 다시 찾는 데 도움이 되는지부터 판단합니다.

시험하려면 비밀값 없는 저장소에서 환경 변수 문제 하나를 두 세션으로 나눠 다뤄 보세요. 제공자와 동기화 여부를 정하고, 시작 전후 파일 변경, 저장된 관찰, 다음 세션의 검색 결과, 제공자 사용량을 기록합니다. 원하는 기억을 찾는지 확인한 뒤 주입량과 폴더 파일 생성 여부를 검토하고 대상 프로젝트를 넓힙니다. 기록이 쌓이는지만 보지 않고 다음 작업에서 필요한 기억을 찾는지 확인하는 시험입니다.

참고한 자료

확인일은 2026년 10월 6일입니다. 기능·조건은 공식 자료, 과거 문제는 원보고와 병합 기록을 사용했습니다.