별 10만 개 받은 claude-mem 설치 방법은? 3단계로 메모리 연결하고 체험판 함정 피하기

Claude Code를 종료했다가 다시 켜면 지난번에 무엇을 수정했는지 잊어버려요. 그래서 많은 사람이 GitHub 스타 10만 개를 받은 claude-mem을 설치하죠. 설치는 해도 좋지만, 설치 과정에서 무작정 엔터만 누르지는 마세요. 2026년 10월 기준 v15 설치 프로그램은 CMEM Pro 호스팅 옵저버를 기본 선택해요. 30일 무료 체험이 끝나면 월 $30가 청구됩니다. 월 요금 없이 쓰려면 설치할 때 --provider claude를 추가하거나, 설치 후 옵저버를 자신의 API 키를 사용하도록 바꾸세요.

이 글은 ‘설치하면 영원히 기억한다’는 홍보 글이 아닙니다. 아래 내용을 ‘공식 자체 발표 / 제3자의 단일 사례 / 직접 테스트 / 미확인’으로 구분해 설명해요. 모든 데이터의 확인 기준일은 2026-10-30입니다.

claude-mem 핵심 요약

먼저 표를 보고 계속 읽을지 결정해 보세요.

핵심	설명	나에게 미치는 영향
인기도	GitHub `thedotmack/claude-mem`, 별 105,017개, Apache-2.0 라이선스(2026-10-30 GitHub API 기준)	별 개수는 인기도를 보여줄 뿐이에요. 쓸 만한지는 직접 판단해야 해요
버전	npm과 GitHub release의 최신 버전은 모두 15.6.0(2026-10-29)이지만, README 배지에는 15.7.0으로 표시돼요	배지에 현혹되지 말고 npm 버전을 기준으로 삼으세요
기본 유료 설정	설치 프로그램은 기본적으로 CMEM Pro를 선택해요. 30일 체험 후 월 $30이 부과돼요	구독을 원하지 않는다면 다른 방법을 선택하세요
월 구독료 없는 방법	`--provider claude`로 자신의 Claude 요금제를 사용하거나, 설치 후 직접 준비한 키를 사용하도록 변경해요	요금제 사용량이나 API 잔액이 소모돼요
완전한 로컬 방식은 아님	observer 모델이 도구 호출 내용을 읽어요	민감한 저장소에서 사용하기 전에 충분히 검토해야 해요

📷 스크린샷 자리, 편집 시 추가: GitHub 저장소 첫 화면(thedotmack/claude-mem, 별 개수와 최신 release 표시)

claude-mem은 무엇을 기억할까요?

한마디로, claude-mem은 로컬에서 실행되는 기억 계층이에요. 새로운 채팅 모델이나 클라우드 노트가 아니에요. 세션에서 ‘일어난 일’을 수집해 압축하고 저장했다가, 다음 세션을 시작할 때 Claude에 다시 전달해요.

전체 파이프라인은 5단계로 이루어져 있어요.

hooks(생명주기 훅): Claude Code는 세션 시작, 프롬프트 제출, 도구 호출 전후, 중지 및 종료 시 이벤트를 발생시켜요. claude-mem은 이 지점들에 훅을 연결해요.
worker: 로컬에서 Bun으로 실행되는 HTTP 서비스로, 훅 이벤트를 받아요. 기본 포트는 37700 + (uid % 100)이므로 반드시 37700인 것은 아니에요.
observer(관찰자 모델): worker가 원본 도구 호출 내용을 모델에 전달하면, 모델이 이를 구조화된 observation으로 압축해요.
observation(관찰 기록): 각 기록에는 유형, 제목, 설명, 관련 파일이 포함돼요. ~/.claude-mem/claude-mem.db(SQLite)에 저장하고, 벡터 인덱스는 ~/.claude-mem/chroma/에 보관해요. Chroma는 의미 검색에 사용하는 벡터 데이터베이스예요.
다음 SessionStart에 주입: 새 세션이 시작되면 현재 프로젝트와 관련된 최근 observation을 기본적으로 최대 50개까지 자동 주입해요. Claude는 MCP 도구의 3단계 흐름(search → timeline → get_observations)을 통해 필요할 때 더 오래된 기억도 검색할 수 있어요.

주의할 점은 hooks가 포착한 내용만 기록한다는 거예요. 세션 밖에서 떠올린 생각이나 도구 호출을 거치지 않은 대화는 자동으로 저장되지 않아요. 또한 Claude Code에 내장된 자체 memory(MEMORY.md)와 claude-mem은 서로 다른 시스템이에요. 기본적으로 두 시스템이 병렬로 실행돼요.

claude-mem 설치 전 필수 조건 3가지

아래 조건 중 하나라도 충족하지 못한다면 설치를 서두르지 마세요.

Claude Code ≥ 2.1.139: 이 버전보다 낮으면 hook의 args가 무시돼 아무 알림 없이 기록이 누락되므로 원인을 찾기 어려워요. 먼저 claude --version을 실행하고, 버전이 낮다면 claude update를 실행하세요.
Node 20+: npm 패키지에 명시된 버전은 ^20.19.0 || >=22.12.0이에요. node -v로 확인하세요. Bun(≥1.1.31)과 uv는 설치 프로그램이 자동으로 설치해요. 한 외부 테스트에서 Ubuntu 26.04 기준 Bun, uv, Chroma가 차지하는 디스크 공간은 총 약 1.2GB였어요.
observer가 도구 호출 내용을 볼 수 있다는 점을 수용할 수 있어야 해요: 어떤 경로를 선택하든 도구 호출, 프롬프트, 요약 자료가 선택한 observer 제공업체로 전송돼요. 저장소에 키, 고객 데이터 또는 비공개 코드가 있다면 사용을 보류하세요.

Windows에서는 hooks를 실행하는 데 Git Bash가 필요하지 않아요. 다만 설치 후 새 PATH가 적용되도록 터미널이나 IDE를 다시 시작해야 해요.

claude-mem 설치 경로 3가지, 어떻게 고를까요?

경로	cmem 계정 필요 여부	비용 지불 방식	콘텐츠 전송 대상	추천 대상
A: 기본 CMEM Pro	필요, 체험 시에도 카드 등록 필요	월 $30부터, 30일 체험	cmem.ai가 호스팅하는 observer	키를 설정하고 싶지 않거나 클라우드 동기화·여러 기기가 필요한 사용자
B: `--provider claude`	불필요	Claude 구독 사용량 차감	Anthropic	이미 Claude를 구독 중인 사용자
C: B로 설치한 뒤 자체 키로 변경	불필요	제공업체 사용량 기준 과금	APIYI apiyi.com 등 직접 설정한 엔드포인트	비용을 관리하고 싶거나 API 잔액이 있는 사용자

플러그인 마켓플레이스는 또 다른 설치 방법으로, 아래에서 경로 C’로 따로 설명해요. 세 번째 경로는 반드시 B로 먼저 설치해야 해요. openai-compatible은 설치 프로그램의 --provider 선택지가 아니므로, 설치 후 settings를 직접 변경해야 해요.

경로 A: 기본 CMEM Pro 사용하기（claude-mem 설치 프로그램의 기본 옵션）

npx claude-mem install을 실행해요.
설치 중 보이는 화면: 첫 단계에서는 감지된 Agent가 미리 선택되고 런타임이 설치돼요. 두 번째 단계에서는 XXXX-XXXX 형식의 기기 코드가 표시되고, 브라우저에서 OAuth 인증을 진행해요. 로그인 단계에서 멈추지 않도록 주의하세요. 세 번째 단계에서는 메모리 provider로 CMEM Pro가 기본 선택되어 있으며, 선택하면 결제 또는 체험 페이지가 열려요.
주의할 약관（공식 요금제 페이지, 2026-10-30 확인）:
체험하려면 신용카드나 직불카드가 필요해요. 선불카드는 사용할 수 없어요.
「체험 종료」 또는 「포함된 사용량 소진」 중 먼저 발생한 시점부터 요금이 청구돼요.
자동 업그레이드 설정에 따라 구독이 Pro에서 Heavy（월 $70） 또는 Max（월 $100）로 올라갈 수 있어요. 많은 튜토리얼이 「no card required」만 언급하고 이 부분을 빠뜨려요.
설치 성공 확인: 설치가 끝나면 Version, Plugin dir, IDEs, Account, Cloud sync, Worker URL이 표시돼요. 이후에 나오는 5가지 검증 항목도 실행해 보세요.

경로 B: `--provider claude`로 월 구독료 없이 claude-mem 설치하기

npx claude-mem install --provider claude를 실행해요.
메모리 시스템을 하나만 유지하고 싶다면 npx claude-mem install --provider claude --disable-auto-memory를 사용하세요. 이 매개변수는 CLAUDE_CODE_DISABLE_AUTO_MEMORY=1을 설정해 Claude Code의 기본 auto-memory를 꺼요.
설치 중 보이는 화면: Skipping claude-mem login: --provider claude runs memory on your own Anthropic plan., Cloud sync: OFF (local), Auto-memory: left enabled（disable 매개변수를 추가하지 않은 경우）가 표시돼요. 설치 프로그램에서 observer 모델도 선택하라고 하는데, Opus가 아닌 Haiku를 선택하세요.
설치 성공 확인: 설치 과정에서 cmem 로그인이나 결제 페이지가 나타나지 않고, npx claude-mem doctor의 모든 항목에 체크 표시가 뜨면 성공이에요.

소스 코드에서 로그인 없이 사용할 수 있는 provider는 claude와 host뿐이에요. 서드파티 테스트에 따르면 --provider openrouter는 Waiting for OAuth login in the browser… 단계에서 멈춰요. 따라서 서드파티 키를 사용하려면 먼저 경로 B로 설치를 마친 다음 설정을 변경하세요.

경로 C’: Claude Code 플러그인 마켓플레이스

Claude Code에서 /plugin marketplace add thedotmack/claude-mem을 입력하세요.
이어서 /plugin install claude-mem을 입력한 다음 Claude Code를 재시작하세요.
설치 후 확인할 점: 첫 번째 세션에서는 launcher가 아직 컴파일 중이라 기억이 없을 수 있어요. 이 공백을 없애려면 npx claude-mem install --provider claude를 한 번 실행하면 돼요.
npm install -g claude-mem은 절대 사용하지 마세요. SDK 라이브러리만 설치할 뿐, hook을 등록하거나 worker를 시작하지 않아요. 게다가 실제 launcher를 가릴 수 있어요.

claude-mem 설치 후 확인하기: 5가지 점검 항목

먼저 기억해 두세요. 첫 번째 세션은 「수집 세션」이에요. 주입할 이전 기록이 없으므로 두 번째 세션부터 기억을 확인할 수 있어요. 첫 세션부터 「나를 기억하겠지」라고 기대하면 설치가 실패했다고 오해하기 쉬워요.

#	점검 항목	명령어 / 작업	통과 기준
1	doctor	`npx claude-mem doctor`	Bun, uv, Plugin, Hook launcher, Worker, Claude Code version(2.1.139+), Chroma가 모두 ✓
2	status	`npx claude-mem status`	worker가 정상 상태이고 포트 번호가 표시됨
3	viewer	브라우저에서 `http://127.0.0.1:<PORT>/`를 열고 `/viewer`에서 기억 확인	페이지가 열리고, 세션을 한 번 진행한 후 항목이 표시됨
4	sqlite count	`sqlite3 ~/.claude-mem/claude-mem.db "select count(*) from observations;"`	첫 번째 세션 종료 후 반환값이 0보다 큼
5	context inject	`curl "http://127.0.0.1:<PORT>/api/context/inject?project=<项目名>"`	반환된 내용이 다음 세션에 주입될 기억

포트는 ~/.claude-mem/settings.json의 CLAUDE_MEM_WORKER_PORT에서 확인할 수 있어요. curl http://127.0.0.1:<PORT>/api/health로도 확인할 수 있어요. doctor 출력에서 문제가 가장 자주 생기는 곳은 Hook launcher 항목이에요. not on PATH 또는 is not the claude-mem hook launcher가 표시되면 먼저 해결한 뒤 다른 항목을 확인하세요.

📷 스크린샷 자리, 편집 시 추가: worker viewer 페이지(/viewer, observation 목록 표시)

claude-mem 비용: 공식 발표의 ‘96% 절약’과 제3자 테스트의 ‘+4,226 tokens’

두 수치 모두 맞지만, 측정 기준이 다르므로 같은 기준으로 비교하면 안 돼요.

공식 자체 추정: observation 4개는 약 1,093 tokens이고, 원본 작업량은 26,447 tokens이므로 ‘약 96% 절약’한다고 해요. MCP 3단계 검색은 ‘전체 주입보다 약 10배 절약’한다고 설명해요. 이는 프로젝트 측의 자체 추정치로, 제3자 감사를 거친 수치가 아니에요.
제3자 단일 사례(ComputingForGeeks, 2026-10-24, claude-mem 15.0.2, OpenRouter를 통한 Sonnet): 동일한 문장인 ‘Reply with the single word ready’를 입력했을 때, claude-mem을 끄면 입력이 28,489 tokens였어요. 켜면 메모리가 비어 있어도 입력이 32,715 tokens로, 4,226 tokens(약 14.8%) 늘고 비용도 $0.010 증가했어요. 이는 한 대의 기기에서 한 프로젝트를 대상으로 한 번 테스트한 결과일 뿐, 여러분의 청구 비용을 대변하지는 않아요.

결론부터 말하면, ‘절약’은 메모리 자체가 원본 기록보다 압축되어 있다는 뜻이고, ‘증가’는 매 세션마다 고정 오버헤드가 추가된다는 뜻이에요. 프로젝트가 활발하고 주입되는 항목이 많을수록 고정 오버헤드도 커져요. 2026년 상반기의 Issue #618과 #2469에서도 토큰이 빠르게 소모된다는 사용자 의견이 있었어요. 구버전에서의 경험이므로 15.6.0의 현재 상황과 같다고 볼 수는 없지만, 메모리가 공짜는 아니라는 점은 보여줘요.

claude-mem 비용 제어 설정 5가지

CLAUDE_MEM_CONTEXT_OBSERVATIONS: 기본값은 50이에요. 10~20으로 낮추면 주입되는 양을 바로 줄일 수 있어요.
CLAUDE_MEM_SEMANTIC_INJECT: 기본값인 false를 유지하세요. 활성화하면 매 프롬프트에 관련 메모리가 추가돼요.
CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES: 기본값인 false를 유지하세요. 그렇지 않으면 모든 호스트의 메모리가 주입돼요.
CLAUDE_MEM_DISABLE_TOOL_HOOKS=1: 도구 호출 단위의 observation을 끄고 세션 단위 요약만 남겨요. 토큰과 프로세스 오버헤드를 모두 줄일 수 있어요.
CLAUDE_MEM_OPENAI_COMPAT_OBSERVATION_BATCH_SIZE: 기본값은 1이에요. 이벤트가 쌓일 때 조금씩 늘리고, 처음부터 32로 설정하지 마세요.

세 가지 방식의 비용 비교

방식	과금 방식	가격(미국 달러)	적합한 사용자
CMEM Pro	구독	월 $30, 30일 체험판 제공(Heavy $70, Max $100)	사용량이 많거나 클라우드 동기화가 필요한 사용자
Claude 구독	구독 사용량 차감	별도 과금은 없지만 코딩과 사용량을 나눠 써야 해요	Claude를 이미 구독 중인 사용자
APIYI `claude-haiku-5-5`	사용량 기반	토큰 100만 개당 입력 $0.1 / 출력 $0.5 / 캐시 읽기 $0.01(단일 요청 ≤100,000토큰; 100,000토큰 초과 시 입력 $0.5/1M, 구간별 과금)	사용량이 적거나 중간 정도인 사용자

가격 데이터는 APIYI apiyi.com의 전체 가격표를 기준으로 해요(페이지 업데이트: 2026-10-27 14:50 UTC+8). 모델과 가격은 플랫폼의 모델 목록을, 실제 청구 금액은 콘솔을 확인하세요. 참고로 같은 플랫폼에서 claude-haiku-4-5-20251001은 입력 $1 / 출력 $5 / 캐시 읽기 $0.1, claude-sonnet-5-5는 $2 / $10 / $0.1, claude-opus-5-5는 $4 / $20 / $0.2예요. observer는 자주 실행되는 작은 구조화 작업이므로 Haiku급 모델이면 충분해요. 사용량 기반 과금은 사용량이 적거나 중간 정도일 때 적합해요. 사용량이 많다면 일주일간 실제 사용량으로 비용을 계산해 월 $30과 비교해 보세요.

claude-mem의 observer를 APIYI로 바꾸기

이미 API 잔액이 있고 메모리 기능을 위해 별도 구독을 하고 싶지 않은 중국 개발자에게 적합한 경로 C의 전체 설정 방법이에요. APIYI는 위안화 충전을 지원하며, 공식 가격 페이지 기준 1:7 고정 환율로 정산해요.

먼저 경로 B에 따라 설치하세요: npx claude-mem install --provider claude.
~/.claude-mem/settings.json을 열고 네 가지 키를 입력하세요.
"CLAUDE_MEM_PROVIDER": "openai-compatible"
"CLAUDE_MEM_OPENAI_COMPAT_BASE_URL": "https://api.apiyi.com/v1"
"CLAUDE_MEM_OPENAI_COMPAT_MODEL": "claude-haiku-5-5"
"CLAUDE_MEM_OPENAI_COMPAT_API_KEY": "sk-내-APIYI-키"
settings에 키를 평문으로 저장하고 싶지 않다면 ~/.claude-mem/.env에 대신 입력할 수 있어요: OPENAI_COMPAT_API_KEY=sk-내-APIYI-키（디렉터리 권한 0700, 파일 권한 0600）.
npx claude-mem restart를 실행하세요. 인증 정보는 worker가 시작될 때만 읽으므로 재시작해야 적용돼요.
성공 확인 방법: npx claude-mem doctor에서 provider가 openai-compatible로 표시되고, 새 세션에서 생성된 다음 observation이 viewer에 나타나면 성공이에요.

주의할 점이 두 가지 있어요. 첫째, base URL에는 반드시 /v1을 포함하고 끝에 슬래시를 붙이지 마세요. 슬래시가 중복되면 404 오류가 발생해요. 세 가지 base URL의 차이는 다음 문서를 참고하세요: help.apiyi.com/apiyi-base-url-v1-claude-gemini-endpoint-config-guide.html. 둘째, 네 가지 키 중 하나라도 빠지면 claude-mem이 별도 알림 없이 Claude 경로로 돌아가요. 겉으로는 정상 작동하는 것처럼 보여도 구독 사용량이 차감돼요.

인터페이스 실측 결과（2026-10-30에 APIYI 키로 테스트）:

GET /v1/models는 200을 반환했고, claude-haiku-5-5를 포함해 총 259개 모델이 있었어요.
POST /v1/chat/completions에서 claude-haiku-5-5와 response_format: {type: "json_object"}를 사용했을 때 200을 반환했어요. 약 2.0초가 걸렸고 유효한 JSON이 반환됐으며, 사용량은 59 tokens였어요.
claude-mem이 전송하는 reasoning: {enabled: false} 필드를 추가해도 400 오류 없이 200을 반환했어요.
Anthropic 네이티브 /v1/messages도 200을 반환했어요.

결론의 범위: 위 테스트에서 확인한 것은 「APIYI 엔드포인트가 claude-mem에 필요한 요청 형식을 받아들일 수 있다」는 점뿐이에요. 로컬에서 claude-mem의 observation 처리 흐름 전체를 실행해 보지는 않았으므로, 인터페이스 테스트 통과가 플러그인 전체 동작 검증을 뜻하지는 않아요.

🚀 빠른 시작 팁: APIYI apiyi.com 콘솔에서 claude-mem 전용 별도 키를 먼저 만드세요. 일주일 뒤 해당 키의 사용량을 따로 확인해 종량제가 구독보다 저렴한지 판단할 수 있어요. Claude Code 자체에도 연결할 계획이라면 다음 문서를 참고하세요: help.apiyi.com/claude-code-apiyi-integration-tutorial.html.

claude-mem 프라이버시: 로컬에 남는 데이터와 외부로 전송되는 데이터

로컬에 저장되는 데이터는 모두 ~/.claude-mem/에 있으며, CLAUDE_MEM_DATA_DIR로 위치를 변경할 수 있어요. claude-mem.db(sessions, observations, summaries, prompts), chroma/ 벡터 인덱스, logs/, settings.json, 그리고 기본적으로 비활성화된 스크린샷 디렉터리 media-v1/이 여기에 해당해요.

외부로 전송되는 데이터:

observer 호출: 도구 호출 내용, 프롬프트, 요약에 쓰이는 자료가 선택한 provider로 전송돼요. Anthropic을 선택하면 Anthropic으로, CMEM을 선택하면 cmem.ai로, APIYI를 선택하면 APIYI로 전송돼요.
텔레메트리는 기본적으로 활성화: 데이터가 PostHog로 전송돼요. 무작위 설치 UUID를 사용하며, 오류 메시지의 민감 정보는 제거돼요. 비활성화하려면 npx claude-mem telemetry disable을 실행하거나 DO_NOT_TRACK=1을 설정하세요. 설치 과정의 마지막에도 설정 여부를 물어봐요.
클라우드 동기화는 직접 활성화해야 해요: 기본적으로 비활성화되어 있어요. 활성화하면 observations, 세션 요약, 전체 프롬프트 텍스트가 cmem.ai에 업로드돼요.

직접 설정할 수 있는 보호 수단:

<private>...</private>로 감싼 내용은 hook 단계에서 제거되므로 데이터베이스에 저장되지 않아요.
자동 민감 정보 제거는 기본적으로 비활성화되어 있어요. CLAUDE_MEM_REDACT_ENABLED=true로 설정해야 16개의 내장 키 패턴(AWS, GitHub PAT, OpenAI/Anthropic key, JWT, PEM 등)이 활성화돼요. CLAUDE_MEM_REDACT_GENERIC_ENABLED=true를 추가하면 범용 패턴 3개가 더 적용돼요. 별도 설정 없이 민감 정보를 자동으로 제거해 준다고 생각하지 마세요.

claude-mem 자주 발생하는 문제 해결표

증상	원인	해결 방법
모든 hook에서 `Executable not found in $PATH: "claude-mem"` 오류 발생	launcher가 PATH에 없음	`npx claude-mem install`로 재설치하고 터미널, IDE, Claude Code를 다시 시작
세션에 `memory hooks are not active`가 표시됨	launcher가 적용되지 않음	위와 같이 처리한 뒤 `npx claude-mem doctor`로 Hook launcher 항목 확인
아무것도 기록되지 않고 오류도 발생하지 않음	Claude Code 버전이 2.1.139보다 낮음	`claude update` 실행
다른 프로그램이 `claude-mem` 명령을 가로챔	이전에 `npm install -g claude-mem`을 실행함	`which -a claude-mem`으로 확인한 뒤 `npm uninstall -g claude-mem` 실행
viewer가 열리지 않음	포트가 37700이 아니거나 worker가 시작되지 않음	settings에서 포트를 확인하고 `curl http://127.0.0.1:<PORT>/health` 실행
포트가 이미 사용 중	다른 프로세스와 충돌	`export CLAUDE_MEM_WORKER_PORT=38000`을 설정한 뒤 worker 재시작
사용자 지정 엔드포인트에서 404 발생	base URL이 잘못됨	OpenAI 호환 API는 `/v1`, Anthropic 네이티브 API는 루트 도메인을 사용하고 `/v1/models`에 모델 id가 있는지 확인
서드파티 키를 설정했는데도 Claude를 사용함	네 가지 키를 모두 설정하지 않아 조용히 다음 설정으로 넘어감	settings를 완성하고 `npx claude-mem restart` 실행
observation이 비어 있거나 잘림	소형 모델이 JSON 구조를 따르지 않거나 출력 한도에 도달함	`CLAUDE_MEM_OBSERVER_MAX_OUTPUT_TOKENS`를 늘리거나(기본값 4096) 더 안정적인 모델로 변경
타임아웃이 반복됨	스트리밍 요청에서 90초 동안 토큰이 없으면 중단됨	`CLAUDE_MEM_LLM_STREAM_IDLE_TIMEOUT_MS`를 늘리거나 더 작은 모델로 변경
hook이 계속 worker를 종료함	플러그인과 worker 버전이 일치하지 않음(#3857, #3940, 수정됨)	`npx claude-mem update`를 실행하고 필요하면 `npx claude-mem@latest install` 실행
두 메모리 시스템이 서로 충돌함	네이티브 auto-memory와 claude-mem이 동시에 작동함	재설치할 때 `--disable-auto-memory` 추가

claude-mem 사용 위험과 계정 정지 책임

설치하기 전에 이 섹션을 끝까지 읽어 주세요.

커뮤니티 프로젝트이며 공식 보증 없음: claude-mem은 커뮤니티 오픈소스 프로젝트로, APIYI의 공식 제품이 아니에요. APIYI는 이 프로젝트를 보증하거나 SLA를 제공하지 않아요.
콘텐츠 외부 전송: 도구 호출 내용은 사용자가 선택한 observer로 전송돼요. 키, 고객 데이터, 미공개 코드가 포함된 저장소에서는 사용하지 않는 것이 좋아요.
사용량 소모: 많은 토큰이나 요금제 사용량을 소모할 수 있어요. 작은 프로젝트에서 일주일 정도 시험해 보고, 청구서를 확인한 뒤 결정하세요.
보안 정책 및 요청 제한: 빈번하게 실행되는 hooks, 공유 계정, 중계용 키는 플랫폼의 보안 정책이나 요청 제한을 유발할 수 있어요. 별도 키와 보조 계정, 단일 프로젝트로 시험해 보세요. 그 결과에 대한 책임은 사용자에게 있어요. 이 글에서는 APIYI 인터페이스가 실제 테스트에서 정상 작동한 것만 확인했으며, 요청 제한이 발생하지 않는다고 보장하지 않아요.
제거 후에도 파일이 남음: npx claude-mem uninstall을 실행해도 ~/.claude-mem은 남아 있어요. 데이터베이스와 저장된 키가 있을 수 있으므로 rm -rf ~/.claude-mem을 직접 실행해야 해요. 또한 ~/.bun과 ~/.cache/uv는 제3자의 실측 기준으로 약 1.1GB를 차지해요. 다른 프로젝트에서 사용하지 않는다면 함께 삭제해도 돼요.

claude-mem 자주 묻는 질문 FAQ

Q1: 별 10만 개면 claude-mem이 반드시 좋은 도구인가요?

그렇지는 않아요. 별 수는 인기를 보여줄 뿐이에요. 토큰 비용, 개인정보 보호 범위, 버전 업데이트 주기는 직접 평가해야 해요. 별 수 증가에 허수가 있는지도 독립적인 감사를 거치지 않았어요.

Q2: claude-mem은 Claude Code에 내장된 memory와 같은 건가요?

아니요. 내장 memory는 MEMORY.md이고, claude-mem은 별도의 hooks와 데이터베이스를 사용해요. 기본적으로 두 시스템이 함께 작동해요. 하나만 유지하고 싶다면 설치할 때 `–disable-auto-memory`를 추가하세요.

Q3: 설치 후 첫 번째 세션부터 기억이 생기나요?

아니요. 첫 번째 세션에서는 정보를 수집하고 압축하며, 두 번째 세션부터 주입해요. 확인 절차의 4번 항목(sqlite count)과 5번 항목(context inject)으로 확인하세요.

Q4: 카드 등록이나 구독 없이 claude-mem을 사용할 수 있나요?

네. `–provider claude`로 설치하면 Claude 요금제의 사용량을 소모해요. 또는 설치 후 observer를 APIYI apiyi.com의 사용량 기반 키로 바꾸면 실제 사용한 토큰만큼 비용이 청구돼요. 신규 사용자에게는 무료 테스트 사용량도 제공돼요.

Q5: observer에는 어떤 모델이 적합한가요?

`claude-haiku-5-5` 같은 Haiku급 모델을 사용하세요. observation은 자주 발생하는 작은 구조화 작업이에요. Opus 같은 최고급 모델은 비용이 많이 들고 출력 예산을 추론에 소모하기 쉬워요.

Q6: 로컬 모델만 사용할 수 있나요?

네. `openai-compatible`이 Ollama, LM Studio 또는 vLLM을 가리키도록 설정하면 돼요. 다만 소형 모델이 observation의 JSON 구조를 안정적으로 출력할 수 있어야 해요. 그렇지 않으면 빈 기록이 생성돼요.

Q7: 중국어 observation은 어떻게 설정하나요?

settings에서 `”CLAUDE_MEM_MODE”: “code–zh”`로 설정한 다음 Claude Code를 재시작하세요. 내장 모드이므로 별도로 설치할 필요는 없어요.

claude-mem 핵심 요약 Key Takeaways

작동 방식: hooks가 도구 호출을 수집하면 observer가 압축해 SQLite에 저장하고, 다음 세션에 주입해요.
기본 설정 주의: v15 설치 프로그램은 CMEM Pro를 미리 선택해요. 체험판을 쓰려면 카드를 등록해야 하고, 이후에는 월 $30이 청구돼요.
월정액 없이 사용하기: --provider claude로 설치한 뒤, 필요에 따라 settings를 수정해 직접 발급받은 키를 사용하세요.
비용: 공식 발표는 ‘96% 절약’, 제3자의 단일 사례는 ‘4,226 토큰 추가’예요. 두 수치는 측정 기준이 달라요.
개인정보: observer가 내용을 외부로 전송하고, 원격 측정은 기본적으로 켜져 있어요. 민감 정보 마스킹과 클라우드 동기화는 직접 켜야 해요.
시작 방법: APIYI apiyi.com에서 별도 키를 발급하고 claude-haiku-5-5를 종량제로 일주일간 사용한 뒤 비용을 계산해 보세요.

정리: claude-mem의 세션 간 기억 기능, 누구에게 적합할까요?

설치할 만한 사람 3가지 유형:

같은 프로젝트를 오래 유지하면서 Claude Code 세션을 자주 닫고 다시 여는 사람
‘지난번에 왜 이렇게 바꿨지?’, ‘그 버그는 결국 어떻게 고쳤지?’라는 질문에 자주 답해야 하는 사람
처음에 10분 정도 설정할 의향이 있고, observer가 도구 호출 내용을 읽는 것을 받아들일 수 있는 사람

설치하지 않는 편이 나은 사람 3가지 유형:

일회성 스크립트만 실행하고 프로젝트를 이어서 진행하지 않는 사람. CLAUDE.md와 개인 메모를 활용하는 편이 더 저렴해요.
코드나 데이터를 로컬 머신 또는 지정된 규정 준수 지역 밖으로 내보낼 수 없는 사람
디스크나 CPU 여유가 부족한 환경에서 작업하는 사람, 또는 ‘설치하자마자 바로 똑똑해지기’를 기대하는 사람

설치한다면 ‘경로 B → 5가지 검증 → 주입 항목 수 줄이기 → 필요에 따라 observer 변경’ 순서로 진행하는 것이 가장 안전해요. observer의 종량제 비용을 확인하고 싶다면 APIYI apiyi.com의 무료 크레딧으로 작은 프로젝트를 먼저 실행해 보세요.

📚 참고 자료

claude-mem GitHub 저장소: 소스 코드, 릴리스 및 이슈
링크: github.com/thedotmack/claude-mem
설명: 스타 수, 버전, #618, #2469, #3857, #3940 등의 이슈 기록
claude-mem 공식 문서: 설치, 설정, 문제 해결
링크: docs.claude-mem.ai/installation
설명: 시스템 요구 사항, settings 기본값, openai-compatible provider 설정
CMEM 요금제 페이지: CMEM Pro / Heavy / Max 이용 조건
링크: cmem.ai/pricing
설명: 30일 체험, 카드 등록 요건, 요금 청구 시작 시점(2026-10-30 확인)
ComputingForGeeks의 제3자 실측: 15.0.2 설치 및 토큰 사용량
링크: computingforgeeks.com/claude-mem-claude-code
설명: +4,226 tokens 단일 사례 데이터 출처(2026-10-24)
APIYI 모델 문서: 모델 및 가격 목록
링크: docs.apiyi.com/models
설명: 모델과 가격은 플랫폼의 모델 목록을 기준으로 해요

작성자: APIYI 기술팀
기술 문의: 설정 중 엔드포인트나 모델 관련 문제가 생기면 APIYI 공식 홈페이지에서 문의해 주세요. 자세한 연동 방법은 docs.apiyi.com 문서 센터에서 확인할 수 있어요.

별 10만 개 받은 claude-mem 설치 방법은? 3단계로 메모리 연결하고 체험판 함정 피하기