Claude에게 기억을 가르치기: 같은 실수가 되돌아오지 않게 하는 법

Claude를 고쳐 줍니다. 사과하고, 실수를 바로잡고, 당신은 넘어갑니다. 다음 날 아침 새 대화를 엽니다 — 그런데 같은 실수가 돌아와 있습니다. 그만 쓰라고 부탁한 날짜 형식일 수도, 쓰지 않는다고 두 번이나 말한 라이브러리일 수도 있습니다. 그리고 더 조용한 문제들도 있습니다: 자신만만하지만 틀린 산수, 가끔 들어맞지 않는 논리의 비약.

이 중 무엇도 도구가 망가졌다는 뜻은 아닙니다. 당신이 아직 Claude에게 메모리를 — 다음 세션이 그 교훈을 이미 안 채로 시작하도록 보관할 곳을 — 주지 않았다는 뜻입니다. 이 글은 바로 그것을 어떻게 하는지에 관한 것입니다: 메모리가 어디에 사는지, Claude가 실제로 따를 규칙을 어떻게 작성하는지, 그중 무엇이라도 자동으로 일어나는지(대체로 아닙니다 — 그리고 그것이 이해해야 할 핵심입니다), 그리고 잘못된 산수를 고치는 별도의 요령까지.

애초에 왜 잊는가

모든 새 대화는 백지에서 시작합니다. 월요일에 한 교정은 월요일의 대화 안에서만 삽니다. 화요일의 Claude는 그것을 본 적이 없습니다. 그것은 인간적 의미의 건망증이 아니라 — 그저 대화는 당신이 배운 것을 다시 읽힐 어딘가에 저장하지 않는 한 이어지지 않는다는 것뿐입니다.

그래서 사실 두 가지 일이 있습니다. 첫째, Claude에게 기억할 곳을 주는 것. 둘째, 거기 적는 것을 모호한 바람이 아니라 따를 수 있는 규칙으로 쓰는 것. 둘 다 제대로 하면 같은 교정을 두 번 줄 일이 없습니다.

CLAUDE.md — 프로젝트의 메모리

당신이 할 수 있는 가장 유용한 한 가지는 CLAUDE.md라는 파일을 두는 것입니다. 이것은 Claude가 다른 무엇을 하기 전에 모든 세션 시작 시 자동으로 읽는 평문 파일입니다. 거기에 넣은 규칙, 관례, 함정은 그 프로젝트의 상시 컨텍스트가 됩니다 — 매번 적용되고, 상기시킬 필요가 없습니다.

## House style
- Use British spelling (colour,
  organise) — never US spelling.

그것은 주로 두 곳에 살며, 당신은 둘 다 쓰게 됩니다:

• 프로젝트 메모리 — 프로젝트 루트의 CLAUDE.md. Git에 커밋하면 팀 전체(와 모든 자동 실행)가 같은 규칙을 공유합니다. 프로젝트별 관례가 들어가는 곳입니다.
• 개인 메모리 — 당신의 ~/.claude/ 폴더에 있는 CLAUDE.md. 당신의 모든 프로젝트에 걸쳐 적용되며 오직 당신만을 위한 것입니다 — 당신만의 선호와 습관.

백지에서 시작할 필요는 없습니다: 프로젝트에서 /init을 실행하면 Claude에게 코드베이스를 읽고 첫 CLAUDE.md 초안을 작성하라고 요청합니다. 거기서부터 손으로 다듬으면 됩니다.

“스스로 업데이트되나요?” — 메모리는 둘이 있다

모두가 묻는 질문이고, 정직한 답에는 두 측면이 있습니다 — Claude Code가 실제로 두 개의 메모리를 두기 때문입니다.

CLAUDE.md는 당신이 작성하는 것이고, 스스로 업데이트되지 않습니다. Claude를 고쳐 줘도 Claude가 당신을 위해 CLAUDE.md를 조용히 다시 쓰지는 않습니다 — 그리고 그것은 의도된 것입니다. 이 파일은 당신의 숙고된, 버전 관리되는, 팀과 공유되는 규칙집입니다; 당신 모르게 스스로 편집하기를 원치 않을 겁니다. 규칙을 추가하려면 파일을 직접 열거나, /memory를 실행해 찾아 편집하거나, 그냥 Claude에게 “이걸 CLAUDE.md에 추가해 줘: …”라고 말해 변경하게 하면 됩니다.

두 번째 메모리는 자동입니다. 최근 버전의 Claude Code는 “자동 메모리”를 둡니다 — Claude가 일하면서 자기 자신에게 쓰는 노트로, 알아낸 것과 당신이 준 교정을 당신의 어떤 행동도 없이 조용히 담아 둡니다. 기본으로 켜져 있습니다. 그래서 사람들이 “그냥 기억하면 안 되나?”라고 물으면, 답은: 어느 정도는 이미 기억합니다. 하지만 자동 메모리는 Claude의 작업용 노트이지 당신의 규칙집이 아닙니다 — 저장소가 아니라 당신의 머신에 살며, 매 세션 그것의 짧은 색인만 불러와집니다. 결코 다시 설명하고 싶지 않은 규칙들 — 팀 관례, 단호한 “절대 이러지 마라” — 은 여전히 당신이 의도적으로 작성한 CLAUDE.md에 두는 게 좋습니다.

그 순간에 무언가를 담는 가장 빠른 방법은 # 단축키입니다: # we deploy on Fridays — never touch main after 4pm처럼 줄을 #로 시작하면 Claude가 그것을 곧장 자동 메모리에 기록합니다. 빠른 메모로 다루되, 정리할 때 간직할 것들은 CLAUDE.md로 승격하세요. 한편 /memory 명령은 현재 불러와진 모든 것을 보여 주고, 어떤 파일이든 열어 편집하게 하며, 자동 메모리를 켜거나 끕니다.

어느 쪽을 쓰든, 모든 것을 바꾸는 습관은 같습니다: Claude를 고쳐 주는 순간, 그 교정을 다시 읽힐 어딘가에 적어 두세요. 그것이 어떤 것을 영원히 설명하는 것과 한 번만 설명하는 것 사이의 모든 차이입니다.

규칙을 바람이 아니라 규칙으로 써라

메모리 파일은 규칙이 따를 수 있을 때만 도움이 됩니다. Claude가 당신의 CLAUDE.md를 “무시하는” 가장 흔한 이유는 규칙이 너무 모호해서 행동할 수 없었기 때문입니다. 세 가지 습관이 규칙을 자리 잡게 합니다:

• 구체적이고 검증 가능하게. “깔끔한 코드를 작성하라”는 바람입니다. “함수는 하나의 일만 한다; 어떤 함수도 40줄을 넘지 않는다”는 규칙입니다.
• 이유를 대라. “모든 네트워크 호출에 우리의 api/client.ts 래퍼를 쓰라 — 인증 헤더와 재시도를 더해 주고, 우회하면 조용한 401이 발생한다.” 이유가 있으면 Claude가 당신이 나열하지 않은 경우에도 규칙을 적용할 수 있습니다.
• 좋은 예와 나쁜 예를 보여라. 옳은 방식과 그른 방식의 짧은 예 하나가 한 단락의 설명만큼 가치 있습니다.

잘 작동하는 규칙 몇 가지를, 감을 잡으시라고:

# Conventions
- Dates are always ISO 8601 (2026-06-29), never DD/MM/YYYY.
- Use British spelling (colour, organise) — this is a UK product.
- Money is stored in integer pence, never floats. Floats cause
  rounding bugs at checkout.
- Never add a dependency without asking — we keep the bundle small.
- Run the test suite before saying a task is done.

산수와 논리 문제는 다른 해법이 필요하다

Claude에게 산수를 “더 조심하라”고 말하는 것은 통하지 않습니다 — 문제가 부주의가 아니기 때문입니다. 언어 모델은 텍스트를 예측합니다; 뛰어난 패턴 매처이지 계산기가 아닙니다. 복리 백분율을 머릿속으로 계산하라고 하면 자신만만하고, 빠르고, 살짝 틀린 숫자를 내놓습니다.

41310 * (1 - 0.06) ** 6
= 41310 * 0.6899
= 28,500 customers

해법은 더 열심히 시도하게 만드는 것이 아니라 — 머릿속으로 계산하기를 멈추게 하는 것입니다. 도구로 답을 계산하고(코드 스니펫을 실행하거나 스프레드시트에 수식을 만들어) 당신이 검산할 수 있도록 풀이를 보여 주라고 시키세요. 현대의 Claude는 계산을 위해 코드를 실행할 수 있고, 계산해서 출력한 숫자는 검증할 수 있는 것입니다; “그냥 알았던” 숫자는 그렇지 않습니다.

답하기 전에 생각하게 하는 것도 도움이 됩니다. 더 새로운 Claude 모델은 확장된 “사고” 단계를 — 답하기 전 문제를 차근차근 풀어 보는 사적인 연습장을 — 가질 수 있고, Anthropic은 정확도가 측정 가능하게 향상되는 다단계 산수와 까다로운 논리에 바로 이것을 권장합니다. 실제로는 답을 확정하기 전에 “이걸 신중하게 끝까지 생각하고 각 단계를 보여 줘”라고 요청하는 것만큼 간단합니다.

같은 아이디어가 불안정한 논리도 고칩니다. 답으로 건너뛰는 대신 단계별로 생각하고 추론을 보여 달라고 하고, 검증 단계를 더하세요 — “이제 그 결과를 원래 숫자와 대조해 확인해 줘.” 정말 중요한 무엇이든, 가장 강력한 수는 테스트를 작성하게 하는 것입니다: 테스트는 통과하거나 실패하며, 그것은 의견의 문제가 아닙니다. 이것을 메모리에 새겨 둘 수도 있습니다:

# Reasoning
- For any non-trivial calculation, compute it with code and show
  the working. Never estimate a number you can compute.
- For tricky logic, reason step by step, then verify the result
  before presenting it.

메모리 파일이 무시되는 세 가지 이유

1. 너무 길다. 비대한 CLAUDE.md는 흡수되지 않고 훑어집니다; 실용적인 지침은 각 파일을 대략 200줄 아래로 유지하는 것입니다. 모든 줄이 제 자리를 벌어야 합니다 — “이걸 지우면 실수가 생길까?”라고 물어보세요. 계속 자란다면, 그 일부가 경로 범위 규칙 파일이나 스킬에 속한다는 신호입니다.
2. 규칙이 모호하다. 위를 보세요 — “일관되게 하라”는 따를 수 없고; “2칸 들여쓰기를 쓰라”는 따를 수 있습니다.
3. 스스로 모순된다. 반대 방향으로 끌어당기는 두 규칙은 상쇄됩니다. 가끔 파일을 검토해 낡은 줄을 지우세요.

교훈이 한 프로젝트보다 클 때

CLAUDE.md는 사실과 규칙을 위한 것입니다. 알아 둘 가치가 있는 이웃이 둘 있습니다. 스킬은 “이 작업은 항상 이렇게 하라”를 위한 것입니다 — 한 번 건네는 반복 가능한 방법입니다(여기에서 깊이 다룹니다). 그리고 영속 메모리는 Claude가 프로젝트와 세션을 가로지르는 메모를 유지하게 하여, 더 오래 가는 작업이 매번 차갑게 시작하지 않게 합니다. 다른 도구, 같은 본능: 교훈을 다시 읽힐 어딘가에 적어 두는 것.

핵심 요점

Claude는 당신을 위해 기억해 주지 않습니다 — 하지만 당신이 적어 둔 것은 결코 잊지 않습니다. 당신을 미치게 하는 실수는 거의 언제나 살 곳이 없던 교정들입니다. 그것들에 CLAUDE.md라는 집을 주고, 이유가 딸린 규칙으로 표현하고, 숫자를 추측하는 대신 실제로 계산하게 하세요. 지난 다섯 개의 교정을 다섯 줄로 바꾸는 10분은 이번 주 이 도구로 할 가장 높은 수익의 일입니다 — 그것이 그 다섯 개의 교정을 줘야 하는 마지막이기 때문입니다.