01-개념

01. 개념 — 부트스트랩은 “기억”의 설계

Claude Code는 매 세션을 빈 컨텍스트로 시작한다. 두 가지 메커니즘이 그 사이에 다리를 놓는다 — CLAUDE.md 와 자동 메모리(Auto memory). 공식 문서 표가 명료하다:

“CLAUDE.md files: instructions you write to give Claude persistent context. Auto memory: notes Claude writes itself based on your corrections and preferences.”
의역: “CLAUDE.md는 당신이 직접 적는 영구 지시. 자동 메모리는 Claude가 당신의 교정·선호를 보고 스스로 적는 노트.”
— Anthropic, How Claude remembers your project

부트스트랩은 이 두 시스템의 초기 상태를 정하는 일이다. CLAUDE.md를 잘못 적으면 매 세션마다 같은 함정에 빠진다. 200줄을 넘기면 적힌 내용 조차 잘 안 따른다.

”매뉴얼”의 함정

가장 흔한 신규 사용자 실수는 CLAUDE.md를 회사 위키처럼 만드는 것이다. sshh가 정확하게 짚는다:

“Start with guardrails rather than comprehensive manuals… use the document as a forcing function to simplify internal tooling.”
의역: “포괄적 매뉴얼 대신 가드레일로 시작하라. 이 문서를 내부 툴링 단순화의 강제 장치로 써라.”

13KB(약 200~300줄)이 그의 사내 모노레포 CLAUDE.md 크기다. 그 이상은 토큰만 먹고 정확도를 떨어뜨린다.