클로드에게 두 번째 뇌 붙이기: CLAUDE.md와 자동 메모리 설정법
세션마다 같은 지시를 다시 타이핑하는 분께 맞는 글입니다. CLAUDE.md와 자동 메모리로 규칙과 선호를 남기는 3단계와 분량, 저장 범위 주의점을 정리했습니다.
클로드는 세션마다 새 컨텍스트로 시작하므로, 남기고 싶은 규칙은 CLAUDE.md 파일과 자동 메모리로 옮겨야 합니다. 기억은 대화 안이 아니라 파일에 남기는 것이고, 파일로 옮긴 것만 이어집니다.
이 프로젝트에서 내가 세션마다 반복해서 지시한 규칙을 정리해 줘. - 항상 지켜야 하는 규칙만 골라 CLAUDE.md에 넣을 초안으로 만들어 줘 (200줄 미만) - 가끔만 필요한 참고 자료는 스킬로 옮길 후보로 따로 표시해 줘 - 다 만든 뒤 /context로 이번 세션에 로드됐는지 확인하는 방법도 알려 줘
클로드의 메모리는 세션(대화 한 번의 단위)이 끝나도 남는 지식을 클로드에게 붙여주는 두 가지 장치, CLAUDE.md 파일과 자동 메모리를 뜻합니다.
공식 문서는 이 둘을 "상호 보완적인 두 메모리 시스템"이라고 부르고, 둘 다 대화가 시작할 때마다 불러온다고 설명합니다.
왜 자꾸 잊나요
클로드 코드는 세션마다 완전히 새로운 컨텍스트(대화가 기억하는 범위)로 시작합니다. 어제 정해준 규칙도, 오늘 아침에 고친 오타도 새 세션에는 아무 흔적이 없습니다.
저는 처음에 이걸 몰라서 같은 지시를 세션마다 다시 타이핑했습니다. "이 프로젝트는 pnpm을 씁니다"를 열 번 넘게 친 적도 있습니다.
그러다 CLAUDE.md라는 파일에 한 번만 적어 두면 매 세션 자동으로 읽힌다는 걸 알았습니다.
CLAUDE.md 만들기
/init 명령을 실행하면 클로드가 코드베이스를 훑어 빌드 명령·테스트 방법·프로젝트 관례가 담긴 파일을 자동으로 만들어 줍니다. 이미 파일이 있으면 덮어쓰지 않고 개선안을 제안합니다.
/init자동 메모리 확인하기
자동 메모리는 클로드가 스스로 알아서 적어 두는 메모입니다. 기본값이 켜짐이고, /memory를 실행하면 켜짐·꺼짐을 토글할 수 있습니다.
저장하는 것은 네 종류입니다. 여러분의 역할·선호, 클로드가 받은 피드백, 진행 중인 작업, 참고할 외부 자료입니다.
불러왔는지 확인하기
/context를 실행하면 이번 세션에 실제로 로드된 메모리 파일 목록을 볼 수 있습니다. 목록에 없으면 클로드는 그 파일의 존재를 모릅니다.
자주 하는 실수
CLAUDE.md에 프로젝트 설명을 너무 길게 적었던 적이 있습니다. 공식 문서는 200줄 미만을 권장하고, 길어질수록 컨텍스트를 많이 먹고 지시를 따르는 정확도도 떨어진다고 안내합니다.
지금은 "항상 해야 하는 규칙"만 CLAUDE.md에 남기고, 가끔만 필요한 참고 자료는 스킬(작업 절차를 담은 별도 파일)로 옮깁니다. 매번 읽을 필요가 없는 내용을 상시 로드 파일에 넣어 두면, 그만큼 매 요청마다 비용을 치르는 셈입니다.
자주 묻는 질문
CLAUDE.md와 자동 메모리는 뭐가 다른가요?
CLAUDE.md는 제가 직접 쓰는 지시문이고, 자동 메모리는 클로드가 제 교정·선호를 보고 스스로 적는 메모입니다. 공식 문서 표현으로는 전자가 "지시와 규칙", 후자가 "학습과 패턴"입니다.
다른 컴퓨터에서도 이어지나요?
아닙니다. 자동 메모리는 기기 안에 저장됩니다(machine-local). 같은 저장소의 다른 워크트리끼리는 공유되지만, 다른 컴퓨터나 클라우드 환경으로는 넘어가지 않습니다.
CLAUDE.md는 저장소에 커밋하면 팀과 공유됩니다.
정말 "절대" 안 잊나요?
아닙니다. 대화가 길어져 자동 압축이 걸리면 세부 내용은 요약으로 바뀝니다. CLAUDE.md는 압축 후에도 디스크에서 다시 읽어 오지만, 대화 중에만 오간 지시는 파일로 옮겨 두지 않으면 사라집니다.
"절대 안 잊는다"는 제목의 표현이고, 실제로는 "파일로 옮긴 것만 안 잊는다"에 가깝습니다.
정리
기억은 대화 안에 남기는 게 아니라 파일로 옮겨야 남습니다. CLAUDE.md에는 항상 지켜야 할 규칙을, 자동 메모리에는 제가 굳이 안 써도 되는 학습을 맡기면 됩니다.