수개월간 매일 사용해 본 나의 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 또는 범용 에이전트를 생성해라. 그들은 자신의 컨텍스트를 소모하고 요약본을 반환한다. 당신의 메인 창은 깨끗하게 유지된다.

워크플로우 관리가 안 되면 대부분의 설정은 무너진다.

사소하지 않은 모든 세션 후에는 자동 회고(Auto-retros)를 수행해라. docs/retros/YYYY-MM-DD-topic.md에 저장해라. 다음 세션은 최신 회고를 자동으로 로드한다. 다시 설명할 필요 없이 연속성이 유지된다.

완료 전 검증(verification-before-completion)을 엄격한 규칙으로 삼아라. Claude는 verify 명령을 실행하고 결과를 보여주기 전까지는 "완료"나 "수정됨"이라고 말할 수 없다. 환각으로 인한 성공 보고를 완전히 차단한다.

원자적 커밋, 커밋당 하나의 수정, 엄격한 줄 제한. 깔끔한 기록, 쉬운 롤백, 그리고 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.