수개월간 매일 사용해 본 나의 Claude Code 설정법 — 컨텍스트 관리, MCP, 메모리, 서브 에이전트

Claude를 탓하지 마세요. 당신의 설정(harness)이 문제입니다.

저는 하루 8시간 이상 Opus 4.7에서 Max 5x로 Claude Code를 돌리고 있습니다. 쿼터 문제는 전혀 없습니다. 제가 실제로 한 일은 다음과 같습니다.

Claude가 '멍청해졌다'거나 '토큰을 잡아먹는다'고 불평하는 대부분의 사람들은 메모리도 없고, 도구도 없고, 규칙도 없이 40개의 파일을 한 번에 컨텍스트 창에 때려 넣고는 왜 할루시네이션이 발생하는지 궁금해합니다. 그건 Claude의 문제가 아닙니다.

컨텍스트 관리는 토큰 사용량을 거의 절반으로 줄여줍니다.

저장소 루트에 CLAUDE.md를 만드세요. 스택 개요, 소유권 매트릭스, 엄격한 규칙을 적으세요. 편집할 때마다 tsc --noEmit을 실행하고, 버그 수정당 최대 50줄, 커밋당 하나의 수정만 하고, 명시적인 승인 없이는 인증/Stripe/미들웨어를 건드리지 마세요. 세션마다 이 내용이 로드됩니다. Claude는 같은 질문을 반복하지 않게 됩니다.

영구 메모리는 ~/.claude/projects/yourproject/memory/에 저장됩니다. user_, feedback_, project_, reference_ 같은 접두사가 붙은 마크다운 파일들입니다. MEMORY.md에 인덱스를 유지하세요. 매번 대화를 시작할 때마다 프로젝트를 다시 설명할 필요가 없어집니다.

가장 큰 쿼터 절약 비결: grep 작업을 위한 서브 에이전트입니다. 파일 탐색을 수행할 Explore 또는 범용 에이전트를 생성하세요. 그들은 자신의 컨텍스트를 소모하고 요약본만 반환합니다. 메인 창은 깨끗하게 유지됩니다.

워크플로우 관리가 제대로 안 되면 설정이 무너집니다.

중요한 세션이 끝날 때마다 자동 회고를 수행하세요. docs/retros/YYYY-MM-DD-topic.md에 저장하세요. 다음 세션은 최신 회고를 자동으로 로드합니다. 다시 설명할 필요 없이 연속성이 유지됩니다.

완료 전 검증(verification-before-completion)을 엄격한 규칙으로 삼으세요. Claude는 검증 명령을 실행하고 결과를 보여주기 전까지는 '완료'나 '수정됨'이라고 말할 수 없습니다. 할루시네이션으로 인한 성공 보고를 완전히 차단합니다.

원자적 커밋, 커밋당 하나의 수정, 엄격한 줄 제한. 깔끔한 기록, 쉬운 롤백, 그리고 Claude가 작업 범위를 실제로 제한하도록 강제합니다.

아키텍처 결정이나 보안/마이그레이션 관련 작업 시: 한 문장으로 Claude가 Gemini Pro + Flash + Sonnet을 병렬로 생성하고 종합하도록 트리거하세요. 세 번의 독립적인 읽기가 자신감 넘치는 독백 하나보다 낫습니다.

MCP 서버 — 복사 붙여넣기 대신 직접 행동하게 하세요.

제가 실제로 사용하는 것들:

• supabase — SQL, 마이그레이션, 스키마를 채팅에서 직접 처리
• github — PR, diff, 이슈, 파일 읽기
• chrome-devtools-mcp + playwright — Claude가 배포된 사이트를 탐색하고, 스크린샷을 찍고, JS를 평가함. 스스로 QA를 수행함.
• context7 — 오래된 학습 데이터가 아닌 현재 라이브러리 문서. 특정 유형의 할루시네이션을 완전히 제거함.
• firecrawl — 온디맨드 스크래핑
• sentry — 프로덕션 에러를 채팅에서 읽고 분류
• gemini MCP — 다중 모델 상담 패널 구동

설치할 가치가 있는 OSS:

graphify — 모든 입력(코드, 문서, 논문, 이미지)을 받아 HTML + JSON 형태의 클러스터링된 지식 그래프를 생성합니다. 대규모 저장소에서 Claude는 200개의 파일 대신 그래프를 읽습니다. 엄청난 효과입니다.

claude-flow — 스웜 오케스트레이션, 훅, 메모리 조정, SPARC, TDD, 코드 리뷰 스웜. github.com/ruvnet/claude-flow

슈퍼파워 스킬 — GitHub에서 'superpowers skills claude code'를 검색하세요. 제가 가장 많이 사용하는 것: systematic-debugging, verification-before-completion, dispatching-parallel-agents, test-driven-development.