클로드 코드가 점점 멍청해질 때
초보자를 위한 5단 메모리·컨텍스트 정리법
Claude Code를 쓰다 보면 처음에는 똑똑하다가 시간이 갈수록 같은 실수를 반복하고, 매번 설명을 다시 해야 하고, 사용량 제한에도 빨리 걸린다. 문제는 모델이 갑자기 나빠져서라기보다 정보를 아무 곳에나 쌓아두는 운영 방식에 있는 경우가 많다.
원본 영상
아래 글은 원본 영상과 공개 상세 가이드, Claude Code 공식 문서를 바탕으로 초보자가 바로 따라 할 수 있게 재구성한 실전 안내입니다.
1. 왜 Claude Code가 “멍청해진 것처럼” 보일까
Claude Code는 대화가 이어질수록 이전 대화, 프로젝트 지침, 메모리, 도구 설명, 열어본 파일 내용을 함께 참고한다. 이것은 장점이지만, 모든 정보를 계속 책상 위에 올려두면 작업 공간이 금방 좁아진다.
프로젝트 목적, 글쓰기 톤, 금지 표현, 파일 위치를 매번 다시 설명한다면 기억 위치가 잘못 잡힌 것이다.
긴 컨텍스트에서는 중간 정보가 약해지는 문제가 생긴다. 중요한 내용이 대화 중간에 묻히면 답변 품질이 떨어진다.
새 요청마다 과거 대화와 긴 지침이 같이 들어가면 실제 작업보다 배경 설명에 토큰을 더 많이 쓴다.
긴 `CLAUDE.md`, 너무 많은 외부 도구 연결, 자동 로드되는 룰이 많으면 시작부터 컨텍스트가 찬 상태가 된다.
따라서 초보자가 먼저 배워야 할 것은 “좋은 질문법” 이전에 “정보를 어디에 둘지 정하는 법”이다.
2. 먼저 계기판을 켠다: /context, /cost, /statusline
컨텍스트 관리는 다이어트와 비슷하다. 얼마나 쓰는지 보이지 않으면 줄일 수 없다. Claude Code를 본격적으로 쓴다면 아래 세 가지부터 익히는 것이 좋다.
| 명령 | 무엇을 확인하나 | 초보자 사용 타이밍 |
|---|---|---|
/context | 현재 세션이 어떤 항목에 컨텍스트를 쓰는지 확인 | 새 작업을 시작했는데 답변이 무겁거나 느릴 때 |
/cost | 현재 세션의 토큰 사용량과 비용 흐름 확인 | 긴 작업 중간에 한 번씩 점검 |
/statusline | 터미널 하단에 컨텍스트 사용률을 상시 표시 | 매일 켜두는 기본 계기판 |
/compact | 긴 대화를 요약 압축 | 컨텍스트가 50~60%쯤 찼을 때 |
/clear | 대화 흐름 초기화 | 작업 주제가 바뀔 때 |
초보자는 `/clear`를 아까워하지 않는 것이 좋다. 한 세션에서 글쓰기, 코드 수정, 설정 변경, 리서치를 모두 이어가면 주제가 섞이고 품질이 흔들린다. 작업 단위가 바뀌면 새 회의실로 옮긴다고 생각하면 된다.
3. 5단 메모리·컨텍스트 시스템 한눈에 보기
영상의 핵심은 AI를 “채팅창”이 아니라 “직원”처럼 운영하는 것이다. 직원에게도 책상, 공책, 서랍, 매뉴얼, 책장이 따로 필요하다.
| 단계 | 비유 | 실제 도구 | 넣을 정보 |
|---|---|---|---|
| 1단 | 책상 위 메모 | CLAUDE.md | 매 세션 반드시 필요한 핵심 규칙 |
| 2단 | 공책 | Auto memory, /memory | 사용자 선호, 프로젝트 진행, 반복 교정 |
| 3단 | 서랍 | .claude/rules/ + paths | 특정 파일·폴더 작업에만 필요한 룰 |
| 3단 강화 | 검색되는 서랍 | memsearch | 많아진 메모와 결정 로그의 의미 기반 검색 |
| 4단 | 작업 매뉴얼 | Skills, Subagents | 반복 절차와 무거운 리서치 |
| 5단 | 사무실 책장 | NotebookLM, Wiki, Obsidian, DB | 긴 자료, 회의록, 리포트, 지식베이스 |
4. 1단: CLAUDE.md는 200줄 이하 안내판으로 만든다
`CLAUDE.md`는 Claude Code가 프로젝트를 열 때 자동으로 참고하는 기본 지침 파일이다. 그래서 정말 중요한 규칙만 넣어야 한다.
복사해서 시작할 수 있는 CLAUDE.md 기본 구조
# Project Guide
## 목표
- 이 프로젝트는 [무엇을 만드는지]를 다룬다.
- 사용자는 [어떤 결과물]을 원한다.
## 기본 작업 방식
- 큰 변경 전에는 먼저 계획을 제시한다.
- 95% 확신이 없으면 작업 전에 질문한다.
- 수정 후에는 가능한 검증 명령을 실행한다.
## 자주 쓰는 명령
- 테스트: npm test
- 빌드: npm run build
- 린트: npm run lint
## 자세한 규칙 위치
- 글쓰기 톤: .claude/rules/content-tone.md
- 고객 메일: .claude/rules/client-comm.md
- 주간 보고서: .claude/rules/weekly-report.md여기서 중요한 것은 세부 규칙을 직접 길게 쓰지 않고 “어디를 보면 되는지” 알려주는 것이다. `CLAUDE.md`가 짧아질수록 새 세션이 가벼워진다.
5. 2단: Auto memory는 공책처럼 쓰되, 가끔 정리한다
Auto memory는 Claude Code가 세션 중 배운 내용을 기록하는 공책에 가깝다. 사용자의 선호, 반복 교정, 프로젝트 상태, 참고 링크 같은 정보를 담기에 좋다.
답변 톤, 선호하는 보고 방식, 자주 쓰는 도구처럼 사람 자체에 관한 정보.
“제목은 이렇게 써줘”, “이 표현은 피하자”처럼 반복 실수를 줄이는 교정.
이번 프로젝트의 목표, 진행 상황, 다음에 이어서 할 일.
대시보드 위치, 문서 링크, 자주 확인하는 파일 경로.
다만 Auto memory도 방치하면 오래된 정보가 쌓인다. 바로 삭제하라고 하기보다, 먼저 정리 후보를 제안하게 하는 편이 안전하다.
6. 3단: .claude/rules/와 paths로 필요한 룰만 켠다
프로젝트가 커지면 글쓰기 룰, 고객 메일 룰, 보고서 룰, 코드 스타일 룰이 모두 달라진다. 이걸 `CLAUDE.md` 하나에 넣으면 모든 작업에 모든 룰이 따라붙는다.
이때 `.claude/rules/` 폴더를 만들고, 각 룰 파일에 `paths`를 달면 특정 파일을 만질 때만 해당 룰이 적용된다.
예시: 콘텐츠 작업에만 적용되는 룰
이 방식의 장점은 명확하다. 콘텐츠 파일을 만질 때는 콘텐츠 룰이 켜지고, 고객 메일 파일을 만질 때는 고객 메일 룰이 켜진다. 불필요한 룰이 매번 컨텍스트를 차지하지 않는다.
7. 4단: 반복 업무는 Skills, 무거운 조사는 Subagents로 뺀다
자주 하는 일을 매번 설명하면 시간도 토큰도 낭비된다. 예를 들어 주간 보고서, 블로그 품질 점검, 경쟁사 리서치, 견적서 작성처럼 절차가 정해진 일은 Skill로 만드는 것이 좋다.
반대로 자료를 많이 읽어야 하는 리서치는 메인 대화에서 직접 하지 않는 편이 좋다. Subagent에게 맡기고, 메인 세션에는 결론과 파일 경로만 가져오면 된다.
| 작업 | 추천 방식 | 이유 |
|---|---|---|
| 매주 같은 형식의 보고서 | Skill | 절차가 반복되고 산출물 형식이 고정됨 |
| 블로그 글 품질 점검 | Skill | 체크리스트와 점수 기준이 중요함 |
| 최근 2주 AI 뉴스 50개 수집 | Subagent | 메인 세션이 무거워지는 것을 방지 |
| 긴 PDF 여러 개 요약 | Subagent 또는 외부 지식베이스 | 대량 자료를 메인 컨텍스트에 올리지 않기 위함 |
8. 5단: 긴 자료는 Claude Code 밖의 책장에 둔다
회의록 1년치, 산업 리포트, 고객 자료, 긴 PDF를 Claude Code 안에 그대로 넣으면 컨텍스트가 빠르게 막힌다. 이런 자료는 NotebookLM, Obsidian, Wiki, 데이터베이스 같은 외부 저장소에 두고 필요한 답만 가져오는 것이 좋다.
원칙은 단순하다. 자료 전체를 책상 위로 가져오지 말고, 질문 결과만 가져온다. 예를 들어 “회의록 전체를 읽어줘”보다 “가격 협상 관련 결정만 시간순 5줄로 정리해줘”가 훨씬 좋다.
9. 오늘 바로 따라 하는 30분 셋업 순서
처음부터 memsearch, hooks, 외부 DB까지 다 만들 필요는 없다. 초보자는 아래 순서만 따라 해도 체감이 크다.
Claude Code에서 `/context`와 `/cost`를 실행해 지금 무엇이 컨텍스트를 쓰는지 확인한다.
`/statusline`으로 컨텍스트 사용률, 모델, 브랜치, 비용을 터미널 하단에 표시하게 만든다.
200줄 이하로 줄이고, 꼭 필요한 기본 룰과 자세한 문서 위치만 남긴다.
콘텐츠, 고객 메일, 보고서처럼 작업별 룰을 나누고 `paths`를 붙인다.
한 세션에 모든 일을 섞지 않는다. 작업 주제가 바뀌면 새 세션으로 간다.
PDF, 회의록, 장기 자료는 NotebookLM이나 Wiki에 두고 필요한 답만 가져온다.
10. 운영 체크리스트
- `CLAUDE.md`가 200줄을 넘으면 줄일 후보를 찾는다.
- 같은 설명을 두 번 했다면 메모리나 룰 파일에 넣을지 판단한다.
- 특정 폴더에서만 필요한 규칙은 `.claude/rules/`와 `paths`로 뺀다.
- 컨텍스트가 50~60%를 넘으면 `/compact` 또는 `/clear`를 검토한다.
- 무거운 리서치는 메인 세션에서 하지 말고 별도 작업으로 분리한다.
- 긴 자료는 외부 지식베이스에 두고 질문 결과만 가져온다.