새 대화마다 처음부터 다시 설명하는 일을 없애는 claude-mem 가이드

추석 AI 부트캠프 하루 6시간 만에
AI 기초부터 나만의
서비스까지 완성 이번 연휴를 기회로 삼으세요일정 보기 ↗

역할: claude-mem 의 설치와 동작 확인을 맡는 담당

맥락: 이 컴퓨터의 클로드 코드는 대화가 끝나면 그 대화에서 정한 것을 다음 대화로 넘기지 못하는
상태입니다. claude-mem 이 깔려 있는지, 깔았다면 요약이 실제로 쌓이고 있는지
지금은 확인할 방법이 없습니다

입력: <운영체제와 셸, 예: macOS zsh>, <경험, 예: 터미널에 명령을 붙여넣을 수만 있음>,
<요약을 만들 때 쓰고 싶은 것, 예: 지금 쓰는 클로드 로그인 그대로>

작업: 아래 네 단계를 순서대로 진행하세요.
1. 설치 여부 확인: 홈 폴더에 ~/.claude-mem/ 이 있는지, 그 안에 claude-mem.db 와
   settings.json 이 있는지 보고하세요. 이미 있으면 다시 설치하지 말고 설정값만 알려주세요.
2. 설치: 저장소 README 를 먼저 열어 지금 시점의 설치 명령을 확인한 뒤 그대로 실행하세요.
   기억으로 명령을 쓰지 말고 README 에 적힌 것을 쓰세요.
   npm install -g 로 까는 방법은 README 가 안 된다고 적어 두었으니 쓰지 마세요.
3. 설정 확인: ~/.claude-mem/settings.json 을 열어 요약을 어떤 AI 로 만들게 돼 있는지
   (CLAUDE_MEM_PROVIDER), 새 대화에 몇 건을 올리게 돼 있는지
   (CLAUDE_MEM_CONTEXT_OBSERVATIONS) 값을 그대로 알려주세요.
4. 마지막에 이 도구가 무엇을 저장하고 무엇은 저장하지 않는지, 설정을 스스로 만들어 본 적 없는
   사람도 알아들을 말로 다섯 줄 이내로 설명하세요.

제약: 명령 이름과 설정 이름을 추측하지 마세요. README 와 공식 문서에서 확인한 것만 쓰세요.
설치 뒤에 클로드 코드를 다시 열어야 한다는 점을 빠뜨리지 마세요.
~/.claude-mem/ 안에 쌓인 기록의 내용과 비밀키가 든 파일을 화면에 출력하지 마세요.

출력: 확인한 설치 상태, 실행한 명령, 설정값 두 개, 저장된 요약 개수, 남은 문제를 정리해 주세요.

검증: ~/.claude-mem/claude-mem.db 파일이 있어야 하고,
sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM session_summaries;" 가
숫자를 한 줄 내야 합니다. 대화를 아직 한 번도 끝내지 않았다면 그 값은 0입니다.
하나라도 실패하면 완료로 보고하지 말고 실패 지점과 다음 조치를 알려주세요.

이걸 깔면 무엇이 달라지나

새 대화를 열 때 가장 먼저 치는 말이 무엇입니까. 아마 "어제 우리가 뭘 정했냐면"으로 시작하는 배경 설명일 것입니다.

문제는 AI의 머리가 아니라 대화의 경계입니다. 사람이라면 어제 회의에서 정한 것을 오늘 아침에도 기억합니다. AI 도구는 대화 한 판이 닫히면 그 안에서 오간 것을 통째로 잊습니다. 그래서 매번 같은 설명을 다시 칩니다.

claude-mem은 그 경계에 두 가지를 끼워 넣습니다. 대화가 끝날 때 요약을 만들어 내 컴퓨터에 저장하고, 새 대화가 열리면 그 요약을 맨 앞에 붙입니다. 공식 문서는 새 대화를 열면 최근 대화 10개의 맥락이 자동으로 올라온다고 적었습니다.

부르는 게 아니라는 점이 중요합니다. 외울 명령어가 없습니다. 한 번 깔고 클로드 코드를 다시 열면, 그다음부터는 대화를 열고 닫을 때 알아서 걸립니다.

Quick Start

공식 저장소: claude-mem 공식 GitHub · Apache-2.0 무료

README에 적힌 설치는 한 줄입니다. 터미널에 그대로 붙여넣습니다.

npx claude-mem install

클로드 코드 대화창 안에서 깔고 싶으면 아래 두 줄입니다.

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

설치가 끝나면 클로드 코드를 껐다 다시 여세요. README가 설치 안내 바로 다음 줄에 적어 둔 한 문장입니다.

진짜 붙는지 확인

깔렸는지가 아니라 다음 대화에 실제로 올라오는지를 봐야 합니다. 요약은 대화가 끝날 때 만들어지므로, 깔자마자 새 대화를 열면 붙일 것이 아직 없습니다. 대화를 한 번 끝까지 해 본 뒤에 세어 봅니다.

sqlite3 ~/.claude-mem/claude-mem.db "SELECT COUNT(*) FROM session_summaries;"

이 명령은 제가 지어낸 것이 아니라 공식 문제 해결 문서의 「Context Not Appearing」 절에 적혀 있는 것을 그대로 옮긴 것입니다.

STEP 1 · 3분무엇을 저장하는 도구인지 먼저 알기

이 단계에서는 명령을 치기 전에 이게 무엇을 저장하는 도구인지부터 잡습니다. 대화를 통째로 보관해 주는 도구로 착각하면 기대가 어긋나기 때문입니다.

claude-mem은 대화를 녹취록처럼 보관하지 않습니다. AI가 움직일 때마다 — 파일을 읽고, 고치고, 명령을 돌릴 때마다 — 그 일을 짧은 기록으로 남기고, 대화가 끝나면 그것들을 묶어 요약 한 장을 만듭니다. 공식 문서가 밝힌 요약 항목은 다섯 개입니다. 무엇을 부탁했나, 무엇을 살펴봤나, 무엇을 알아냈나, 무엇을 끝냈나, 다음에 무엇을 할까.

숫자부터 봅니다. 아래는 2026년 8월 30일에 깃허브가 공개하는 저장소 정보에서 직접 읽은 값입니다.

열린 문제보다 열린 수정 제안이 열 배 넘게 많습니다. 손이 많이 붙는 프로젝트라는 뜻이고, 그만큼 버전이 자주 바뀝니다.

STEP 2 · 4분설치하고 클로드 코드 다시 열기

이 단계에서는 실제로 깝니다. 명령은 한 줄인데 설치 마법사가 묻는 것이 몇 개 있고, 거기서 고른 것이 이 도구의 비용을 정하기 때문입니다.

공식 설치 안내가 밝힌, 설치 마법사가 하는 일은 이렇습니다.

• 필요한 프로그램이 없으면 알아서 깝니다
• 이 컴퓨터에 깔린 도구를 찾아 보여주고 어디에 연결할지 고르게 합니다 — 클로드 코드 · 커서 · 윈드서프 · OpenCode · Codex CLI · Antigravity CLI
• 요약을 만들 AI를 고르게 합니다 — 지금 쓰는 클로드 로그인 · Gemini 키 · OpenRouter 키
• 클로드로 고르면 요약에 쓸 모델을 고르게 합니다 — Haiku · Sonnet · Opus
• 마지막에 익명 사용 통계를 보내도 되는지 한 번 묻습니다

세 번째 질문이 돈이 걸린 자리입니다. 기본값은 지금 쓰는 클로드 로그인으로 요약을 만드는 것입니다. 일을 시키는 데 쓰는 한도를 요약도 나눠 쓴다는 뜻입니다.

클로드 코드가 아닌 다른 도구에 깔 때는 뒤에 도구 이름을 붙입니다.

npx claude-mem install --ide opencode

설치가 끝나면 클로드 코드를 껐다 다시 여세요. 이 한 줄을 빠뜨려서 "깔았는데 아무 일도 안 일어난다"고 넘어가는 경우가 가장 많습니다.

STEP 3 · 3분새 대화 첫머리에 무엇이 붙는지 보기

이 단계에서는 켜기 전후의 차이를 눈으로 확인합니다. 이 도구는 새 창을 띄우지 않고 대화 맨 앞을 바꾸기 때문에, 어디를 봐야 하는지 모르면 깔고도 못 알아봅니다.

지난 대화 요약    무엇을 부탁했나 / 무엇을 살펴봤나 / 무엇을 알아냈나
                 무엇을 끝냈나 / 다음에 무엇을 할까

최근 기록 목록    시간 순서로 늘어선 제목들 (기본 50건)
                 어떤 파일을 건드렸는지 파일별로 묶여서 보인다

요약 전체가 항상 보이는 것은 아닙니다. 공식 문서는 마지막 요약을 만든 뒤에 새 기록이 더 쌓였으면 그 요약의 자세한 내용은 감춘다고 적었습니다. 낡은 요약을 최신인 것처럼 보여주지 않으려는 장치입니다.

공식 문서 기준으로 첫머리에 붙는 목록은 50~200 토큰 정도입니다. 자세한 내용은 물어볼 때만 가져오고 한 건당 100~500 토큰이 듭니다. 처음부터 다 펴지 않고 제목만 붙이는 방식입니다.

몇 건을 붙일지는 설정 파일에서 바꿉니다. 먼저 파일이 있는지 봅니다.

ls ~/.claude-mem/

settings.json 안의 CLAUDE_MEM_CONTEXT_OBSERVATIONS 가 기본 50건입니다. 대화가 무겁게 느껴지면 이 숫자를 줄입니다.

STEP 4 · 3분지난 기록을 말로 꺼내기

이 단계에서는 저장된 기록을 꺼내 씁니다. 첫머리에 붙는 것은 최근 것뿐이라, 그보다 오래된 것은 물어봐야 나오기 때문입니다.

외울 명령어가 없습니다. 평소 말로 물으면 됩니다.

지난주에 로그인 쪽에서 무슨 버그를 고쳤는지 기록에서 찾아 줘

공식 문서는 이 찾기가 세 걸음으로 나뉜다고 적었습니다. 먼저 제목만 훑고, 볼 만한 것 주변을 시간순으로 보고, 진짜 필요한 것만 펼칩니다. 한 번에 다 펼치면 대화가 무거워지기 때문에 일부러 나눠 둔 구조입니다.

STEP 5 · 2분남기고 싶지 않은 것 빼기

이 단계에서는 저장되면 곤란한 내용을 빼는 방법을 잡습니다. 이 도구는 기본적으로 AI가 하는 일을 전부 기록하기 때문입니다.

공식 비공개 표시 문서가 알려주는 방법은 내용에 표시를 씌우는 것입니다. 이 표시 안에 넣은 내용은 지금 대화에서는 클로드가 읽지만 기록으로는 저장되지 않습니다.

<private>
서버 주소와 계정 정보처럼, 남기고 싶지 않은 내용을 여기 넣습니다
</private>

위 내용을 보고 원인이 뭘지 알려 줘

한 번 저장된 것을 나중에 골라 지우는 방법은 이 글에서 확인하지 못했습니다. 남기기 싫은 것은 넣기 전에 표시를 씌우는 쪽이 확실합니다.

STEP 6 · 3분통계 수집 끄고 저장 위치 확인하기

이 단계에서는 이 도구가 밖으로 보내는 것을 정리합니다. 기본값이 「보냄」이라, 모르고 두면 계속 보내기 때문입니다.

공식 통계 문서는 익명 사용 통계가 기본으로 켜져 있다고 스스로 밝히고, 무엇을 보내고 무엇은 절대 안 보내는지 표로 적어 두었습니다. 설치 마지막에 한 번 묻기도 합니다. 끄는 것은 한 줄입니다.

npx claude-mem telemetry disable

기록 자체는 내 컴퓨터의 ~/.claude-mem/ 에 파일로 쌓입니다. 다만 요약을 만드는 순간에는 대화 내용이 내가 고른 AI 회사로 나갑니다. 지금 쓰는 클로드로 골랐다면 클로드 쪽으로, Gemini 키를 넣었다면 구글 쪽으로 갑니다. 이건 설정으로 끄는 항목이 아니라 이 도구가 굴러가는 방식입니다.

자주 막히는 곳

FAQ

npm install -g claude-mem 으로 깔면 안 됩니까

안 됩니다. README가 굵은 글씨로 못 박아 둔 함정입니다. 그 명령으로는 부품만 깔리고, 대화가 끝날 때 요약을 만드는 부분과 새 대화에 기록을 붙이는 부분이 등록되지 않습니다. npx claude-mem install 이나 클로드 코드 안의 /plugin 명령으로 까세요.

깔았는데 새 대화에 아무것도 안 붙습니다

두 가지를 봅니다. 첫째, 클로드 코드를 껐다 다시 열었는지. README는 설치 직후 다시 열라고 적었습니다. 둘째, 저장된 요약이 하나라도 있는지. 요약은 대화가 끝날 때 만들어지므로, 깔자마자 새 대화를 열면 붙일 것이 없습니다. Quick Start의 세는 명령으로 확인하세요.

돈이 듭니까

도구 자체는 Apache-2.0 라이선스로 무료입니다. 다만 요약을 만들 때 AI를 쓰기 때문에, 기본 설정이면 지금 쓰는 클로드 로그인의 한도를 함께 씁니다. 공식 설정 문서는 Gemini 키나 OpenRouter 키로 바꿀 수 있게 열어 두었다고 적었습니다.

내가 작업한 내용이 밖으로 나갑니까

기록 자체는 내 컴퓨터의 ~/.claude-mem/ 에 파일로 쌓입니다. 다만 요약을 만드는 순간에는 대화 내용이 내가 고른 AI 회사로 갑니다. 특정 부분을 아예 안 남기려면 STEP 5의 표시를 쓰고, 익명 통계가 싫으면 STEP 6의 한 줄로 끄세요.

클로드 코드 말고 다른 도구에도 됩니까

공식 설치 문서 기준으로 설치 마법사가 이 컴퓨터에 깔린 도구를 찾아 보여줍니다. 클로드 코드 · 커서 · 윈드서프 · OpenCode · Codex CLI · Antigravity CLI가 목록에 있고, 여러 개를 한 번에 고를 수 있습니다.

지우려면 어떻게 합니까

저장소 소스에서 확인한 명령 목록에 npx claude-mem uninstall 이 있습니다. 다만 지운 뒤 기록 폴더가 어떻게 되는지는 이 글에서 확인하지 못했으니, 지운 다음 폴더를 직접 보고 판단하세요.

ls ~/.claude-mem/

별이 9만 개면 안전합니까

아닙니다. 별은 관심도 신호일 뿐 안전을 보장하지 않습니다. 특히 이 도구는 내가 무엇을 했는지를 계속 기록하는 종류라서, 무엇이 저장되고 무엇이 밖으로 나가는지를 먼저 보는 편이 낫습니다. 저장 위치·요약을 만드는 AI·통계 수집 이 세 가지는 STEP 6까지 오면 전부 확인됩니다.

알아 둘 한계

대화가 그대로 남는 게 아닙니다. 남는 것은 요약과 짧은 기록입니다. 새 대화 첫머리에 붙는 것은 제목 수준이고, 자세한 내용은 물어봐야 꺼내 옵니다. 어제 나눈 말을 문장 그대로 다시 읽는 용도가 아닙니다.

요약을 만드는 데도 AI를 씁니다. 공식 설정 문서 기준으로 기본값은 지금 쓰는 클로드 로그인이고, 요약에 쓰는 모델은 Haiku 계열이 기본입니다. 일을 시키는 한도와 요약을 만드는 한도가 한 주머니라는 뜻입니다. 얼마나 쓰는지는 이 글에서 재지 못했습니다.

익명 통계가 기본으로 켜져 있습니다. 공식 문서가 그렇게 밝히고 무엇을 보내는지 표까지 적어 두었습니다. 끄는 명령이 한 줄 있지만, 켜져 있다는 것을 모르면 끌 일도 없습니다.

버전이 빠르게 바뀝니다. 2026년 8월 30일에 확인했을 때 README 배지에 적힌 버전은 13.4.0인데 저장소의 실제 버전 파일은 13.17.2였고, 최신 릴리스는 v13.17.0이었습니다. 열린 수정 제안도 246건입니다. 문서에 적힌 숫자를 그대로 믿지 말고 설치하는 날 직접 확인하는 편이 낫습니다.

저장소 맨 아래에 코인 이야기가 있습니다. 제3자가 만든 토큰을 제작자가 공식적으로 받아들였다고 README에 적혀 있습니다. 설치나 동작과는 무관하지만 저장소를 열면 보이니 미리 알아 두는 편이 낫습니다.

저는 이 도구를 직접 설치해 돌려보지 않았습니다. 이 글의 숫자와 명령은 깃허브가 공개하는 저장소 정보와 저장소 README, 그리고 공식 문서를 2026년 8월 30일에 직접 읽어 옮긴 것입니다. 설치 화면에 실제로 뜨는 문구는 확인하지 못했으므로, 각 명령의 판정 문장은 문서가 밝힌 동작을 기준으로 적었습니다.

공식 자료

• 저장소 — claude-mem 공식 GitHub · Apache-2.0
• 문서 — claude-mem 공식 문서
• 설치 — 공식 설치 안내
• 동작 — 공식 사용 안내
• 설정값 — 공식 설정 문서
• 통계 수집 — 공식 통계 문서
• 안 될 때 — 공식 문제 해결 문서
• 클로드 코드 — 클로드 코드 공식 소개