본문으로 건너뛰기
ReviewRamble

주간 브리프

AI 리뷰를 받은편지함으로.

  • 도구, 모델, MCP 서버, 저장소의 새 리뷰(결론부터)
  • 변경이 있을 때 다시 확인한 가격과 평점
  • 새로 발행된 분석 글

모델, 에이전트, MCP 서버, 그리고 정말 시간을 들일 만한 도구.

일주일에 한 통입니다. 각 브리프의 링크로 구독을 해지할 수 있습니다. 이메일 사용 방식

분석 코딩

Claude Code 메모리냐 Markdown 위키냐: 각각이 끝나는 지점

작성자 ReviewRamble editors ·

Claude Code의 메모리는 모델이 읽는 메모의 모음이지, 반드시 지켜야 하는 규칙의 모음이 아닙니다. CLAUDE.md에는 여러분의 지시가, Auto Memory에는 Claude가 여러분에 대해 배운 내용이 담기지만, 둘 다 어떤 작업도 막지 못합니다. 보관하고 출처를 밝히고 검증하고 싶은 자료가 많아지면 Markdown 위키가 더 알맞은 형태이고, 그 위키를 자동으로 채우는 hooks는 마지막에 조심스럽게 더할 선택지입니다.

이 글은 이 층들 사이의 경계를 긋습니다. Claude Code에 관한 모든 내용은 Anthropic의 메모리, hooks, Agent SDK 문서에서 왔고, 위키 패턴은 Andrej Karpathy의 LLM Wiki gist, 자동화는 claude-memory-compiler README에서 왔습니다. 저희가 이 구성을 직접 돌려 보지는 않았습니다.

CLAUDE.md: 여러분이 쓰는 지시

CLAUDE.md는 여러분이 쓰고 Claude Code가 매 세션 시작 때 읽는 Markdown 파일입니다. 프로젝트 안, 홈 폴더, 조직 단위 어디에나 둘 수 있고, @path 가져오기로 다른 파일을 최대 4단계 깊이까지 불러올 수 있습니다. Anthropic은 파일마다 200줄 미만을 권합니다. 파일이 길수록 컨텍스트를 더 차지하고 지시가 덜 지켜지기 때문입니다. 일부 파일 형식에만 해당하는 지시를 위해서는 .claude/rules/를 제공합니다.

Claude Code 웹사이트 스크린샷
Claude Code 공식 사이트

새 동료에게 건네는 업무 안내라고 생각하면 됩니다. 빌드 명령, 사내 스타일, 아무도 건드리면 안 되는 폴더. 계속 불어나는 사실을 쌓아 두는 곳이 아닙니다.

Auto Memory: Claude가 스스로를 위해 남기는 메모

Auto Memory는 로컬 세션에서 기본으로 켜져 있습니다. Claude는 작업하면서 여러분의 수정과 선호를 바탕으로 자기 메모를 ~/.claude/projects/<project>/memory/에 씁니다. MEMORY.md 파일이 메모 하나당 한 줄씩 색인을 만들고, 각 메모는 별도의 주제 파일에 들어갑니다. 세션을 시작할 때 불러오는 것은 MEMORY.md의 처음 200줄 또는 25KB 중 먼저 닿는 쪽까지뿐이고, 주제 파일은 Claude가 필요하다고 판단할 때 읽습니다.

중요한 점이 두 가지 있습니다. 메모리는 기기에만 저장되므로 다른 컴퓨터나 클라우드 세션으로 따라오지 않습니다. 그리고 평범한 Markdown이어서 /memory를 열면 Claude가 여러분에 대해 무엇을 정해 두었는지 읽고 틀린 것을 지울 수 있습니다. 프로젝트별로 autoMemoryEnabled를 false로 두면 끌 수 있습니다.

컨텍스트는 강제가 아니다

Anthropic의 메모리 문서는 이렇게 분명히 말합니다. Claude는 CLAUDE.md와 Auto Memory를 강제되는 설정이 아니라 컨텍스트로 다룹니다. "migrations 폴더는 절대 지우지 말 것"이라는 한 줄은 모델이 대개 따르는 조언일 뿐입니다. 두 지시가 서로 충돌하면 Claude가 그중 하나를 임의로 고를 수 있다고 문서는 경고합니다.

작업을 실제로 막는 것은 PreToolUse hook입니다. 도구 호출 전에 실행되며, 종료 코드 2로 끝나거나 permissionDecision을 deny로 돌려주면 Claude Code가 그 호출을 멈춥니다. 그러니 나누는 법은 간단합니다. 선호는 메모리에, 절대 일어나면 안 되는 일은 hook이나 권한 설정에 둡니다.

위키가 이어받는 지점

메모리가 답하는 질문은 "나는 어떻게 일하고 싶은가"입니다. "이 마흔 편의 논문, 회의 메모, 업체 페이지에는 무엇이 적혀 있고, 각 주장은 어디서 왔는가"에는 약합니다. 그 일을 맡는 것이 Karpathy의 LLM Wiki 패턴으로, 2026년 4월에 자기 에이전트에 붙여 넣어 쓰는 아이디어 파일로 공개되었습니다.

층은 세 개입니다. raw/ 폴더에는 자료를 두며, 모델은 읽기만 하고 절대 고치지 않으므로 이 자료가 늘 기준이 됩니다. wiki/ 폴더에는 모델이 쓰고 관리하는 Markdown 페이지가 들어갑니다. 요약, 인물과 개념 페이지, 비교 같은 것들입니다. 스키마 파일, Claude Code에서는 CLAUDE.md가 구조와 함께 자료를 추가하고, 질문에 답하고, 정리하는 절차를 정합니다. 두 파일이 전체를 둘러보기 쉽게 해 줍니다. index.md는 모든 페이지를 링크와 한 줄 요약으로 나열하고, log.md는 가져오기, 질의, 점검이 있을 때마다 덧붙이기만 하는 기록입니다.

메모를 믿을 수 있는 지식으로 바꾸는 것은 이 정리 단계입니다. Karpathy는 이를 lint라고 부릅니다. 주기적으로 훑으면서 페이지 사이의 모순, 더 새로운 자료로 대체된 주장, 어디에서도 링크되지 않은 페이지, 따로 페이지를 둘 만한 개념, 빠진 상호 참조를 찾습니다. 새 자료 하나가 10~15개 페이지를 건드릴 수 있다고 그는 적었습니다.

저희 리뷰 두 개가 이 패턴의 실제 모습을 보여 줍니다. claude-obsidian (3.8)은 Karpathy의 아이디어를 바탕으로 출처가 달린 Obsidian 위키를 만들며, 계획하고 기록하는 쓰기 방식 덕분에 믿을 만하지만 도입은 느립니다. OpenWiki (4.2)는 같은 생각을 코드베이스에 적용해, 코드가 바뀌면 자기가 쓴 문장 중 어떤 것이 낡았는지 추적합니다. 낯선 저장소를 한 번 훑어보는 지도가 필요하다면 Understand Anything (3.5)이 대신 지식 그래프를 만들어 주지만, 첫 실행에 토큰이 많이 듭니다.

OpenWiki 웹사이트 스크린샷
OpenWiki 공식 사이트

위키를 대신 채워 주는 hooks

다음 단계는 손으로 정리하는 일을 그만두는 것입니다. claude-memory-compiler는 Karpathy의 패턴을 고쳐서, 원재료가 여러분 자신의 Claude Code 세션이 되게 합니다. SessionEnd hook이 세션이 끝날 때 대화 기록을 가져오고, PreCompact hook이 자동 압축으로 중간 부분이 요약되기 전에 한 번 더 가져오며, 백그라운드 스크립트가 모델에게 결정, 교훈, 함정을 뽑아 일일 로그에 담게 합니다. 컴파일 단계가 이 로그를 서로 연결된 개념 글로 바꾸고, SessionStart hook이 다음 세션에 색인을 넣습니다. lint 스크립트는 일곱 가지 점검을 합니다.

영리한 순환 구조지만, README가 별로 다루지 않는 실제 위험이 따릅니다.

  • hooks는 셸 코드를 실행합니다. hook은 Claude Code가 자기 환경, 즉 여러분 사용자 계정의 권한으로 실행하는 명령입니다. 설치 안내대로 남의 .claude/settings.json을 프로젝트에 복사하면, 세션이 시작하고 끝날 때마다 그 사람의 스크립트를 실행하게 됩니다. 먼저 읽어 보세요.
  • 대화 기록에는 비밀 정보가 들어 있습니다. 세션 기록에는 그 세션을 거쳐 간 모든 것이 담깁니다. 붙여 넣은 키, Claude가 읽은 .env 파일 내용, 로그에 찍힌 고객 데이터. 컴파일러는 이 텍스트를 모델에 보내고 뽑아낸 내용을 Markdown 파일에 쓰는데, 저희가 README와 AGENTS.md를 읽어 본 바로는 민감한 정보를 가리는 단계가 없습니다.
  • 컴파일 단계는 묻지 않고 씁니다. AGENTS.md를 보면 compile.py는 permission_mode를 acceptEdits로 두고 실행되어, 자기 폴더 안의 모든 파일 작업을 자동으로 승인합니다.
  • 요금에 관한 주장이 Anthropic 문서와 어긋납니다. README는 Anthropic이 "has clarified that personal use of the Claude Agent SDK is covered under your existing Claude subscription"이라고 하고, AGENTS.md는 Claude Code에 저장된 인증 정보를 쓰므로 API 키가 필요 없다고 합니다. 출처는 없습니다. Anthropic의 Agent SDK 개요와 빠른 시작 문서는 API 키를 설정하라고 안내하며, 사전 승인이 없는 한 외부 개발자는 SDK로 만든 에이전트에서 claude.ai 로그인이나 그 사용 한도를 제공할 수 없다고 밝힙니다. 구독 관련 주장은 확인되지 않은 것으로 보고 API 사용료를 예산에 넣으세요. 프로젝트 자체의 표에 따르면 일일 로그 하나를 컴파일하는 데 $0.45~$0.65가 듭니다.

저장소도 새롭고 조용합니다. 2026년 4월 6일에 만들어졌고, 커밋은 두 개, 별은 약 1,300개이며, 라이선스 파일이 없어서 코드를 다시 쓸 권리가 어디에도 명시되어 있지 않습니다.

RAG가 필요해지는 마법의 크기는 없다

여기 나온 자료들은 저마다 기준선을 제시하지만 서로 맞지 않습니다. Karpathy는 색인을 읽는 방식이 자료 약 100개, 페이지 수백 개 규모에서는 잘 통하며, 그 이상이면 제대로 된 검색 도구를 쓰라고 권합니다. 컴파일러 문서는 글 50~500개에서는 색인 읽기가 벡터 검색보다 낫고, 글 약 2,000개 또는 200만 토큰쯤에서 하이브리드 검색이 필요해진다고 합니다. 어느 쪽도 측정 결과를 내놓지 않습니다.

쓸모 있는 숫자는 여러분 자신의 숫자입니다. 답을 알고 있는 질문 스무 개를 목록으로 두고 몇 주마다 물어본 뒤, 모델이 어떤 페이지를 열었고 올바른 자료를 인용했는지 적어 두세요. 있는 페이지를 답이 놓치기 시작하거나, 색인이 한 세션에 넉넉히 들어가지 않게 되면 그때 검색을 더하면 됩니다. 그 시점에는 Supermemory (4.0) 같은 호스팅형 메모리나 Memory 참조 서버 (3.5) 같은 로컬 그래프가 다른 선택지입니다. MemoryBase (3.2)는 별개의 문제, 즉 ChatGPT와 Claude 사이에서 대화 맥락을 옮기는 문제를 풉니다.

어떤 층이 어떤 일을 하나

층쓰는 주체용도작업을 막을 수 있나
CLAUDE.md여러분작업 지시와 사내 규칙아니요, 컨텍스트입니다
Auto MemoryClaude학습한 선호와 수정 사항아니요, 컨텍스트입니다
PreToolUse hook여러분반드시 지켜져야 하는 규칙예
LLM WikiClaude, 여러분의 자료로부터출처가 남는 정리된 지식아니요
대화 기록 수집 hooks스크립트, 자동으로세션에서 위키 채우기아니요, 게다가 코드를 실행합니다

단계별 도입

  1. CLAUDE.md부터 시작하세요. 가장 자주 되풀이하는 지시를 적고, 파일을 200줄 미만으로 유지하고, 특정 파일에만 해당하는 규칙은 .claude/rules/로 옮깁니다.
  2. Auto Memory는 켜 두고, 내용을 읽으세요. 한두 주마다 /memory를 열어 틀렸거나 낡은 것을 지웁니다.
  3. 엄격한 규칙은 hooks로 옮기세요. 어겨지면 곤란한 것은 모두 문장이 아니라 PreToolUse hook이나 권한 거부 설정으로 만듭니다.
  4. 위키는 손으로 시작하세요. raw/, wiki/, index.md, log.md를 만들고, 규칙은 CLAUDE.md에 적고, 자료는 하나씩 가져오고, lint를 정기적으로 돌립니다.
  5. 검색을 더하기 전에 측정하세요. 테스트 질문을 보관해 두고, 그 질문들이 틀리기 시작할 때만 검색을 더합니다.
  6. 수집 자동화는 마지막에, 한다면. hook 스크립트는 모두 읽고, 위키는 공유 폴더 밖에 두고, 로그에 무엇이 들어가는지 확인하고, 지출 한도를 건 API 키를 씁니다.

주의할 점: 모델이 관리하는 위키는 lint 점검과 그 결과를 여러분이 읽는지에 따라 품질이 정해집니다. lint는 모순을 짚을 수는 있어도 어느 쪽이 맞는지는 모르고, 잘못 읽은 자료를 자신 있게 요약한 글은 올바른 요약과 똑같아 보입니다. raw/를 바꾸지 않고 두기 때문에 확인할 수 있는 것이고, 그것도 누군가 실제로 확인해야 의미가 있습니다.

결론: CLAUDE.md는 냉장고에 붙인 쪽지, Auto Memory는 룸메이트가 익혀 가는 습관, hook은 문의 자물쇠, 위키는 영수증이 든 서류함이라고 생각하세요. 대부분은 이번 주에 앞의 세 가지가 필요하고, 서류함은 영수증이 쌓인 뒤에야 필요합니다. 모든 것을 대신 정리해 주는 로봇은 그 코드를 다 읽을 때까지 기다리게 두면 됩니다.

ReviewRamble 브리프

AI 리뷰를 일주일에 한 번, 받은편지함으로 보내 드립니다.

AI, 로보틱스, 테크 분야의 중요한 평가를 쓸 것과 건너뛸 것과 함께 전해 드립니다. 과장도, 모든 것을 늘어놓은 요약도 없습니다.

모델, 에이전트, MCP 서버, 그리고 정말 시간을 들일 만한 도구.

일주일에 한 통입니다. 각 브리프의 링크로 구독을 해지할 수 있습니다. 이메일 사용 방식