papercode
노트/도구 Obsidian

Claude Code 비용 절감과 컨텍스트 관리 - everything-claude-code 영상 요약

Claude Code가 길게 쓸수록 둔해지는 context rot의 원인과, settings.json 세 줄로 비용을 줄이는 법, everything-claude-code 저장소 핵심을 정리한 영상 요약

읽는 데 6분

출처: 헤이제임스 유튜브 영상 「Claude Code 비용 80% 절감하는 settings.json 3줄과 14만명이 쓰는 everything-claude-code 설정법」 (https://www.youtube.com/watch?v=4rN-UWKSmp0) 영상을 보고 내 말로 정리한 요약이다. 수치(절감률, 스타 수, 구성 개수)는 영상에서 말한 값이고 직접 검증하지 않았다.

한 줄 요약#

Claude Code가 오래 쓰면 멍청해지는 건 버그가 아니라 context rot라는 구조적 문제이고, settings.json 세 줄과 /clear·/compact 습관만 바꿔도 비용과 품질이 같이 좋아진다.

1. Context rot: 왜 갑자기 멍청해지나#

같은 실수를 반복하고, 알려준 규칙을 잊고, 시키지 않은 파일을 건드리는 현상. 원인은 네 가지다.

  1. 어텐션 희석: 문맥이 길수록 중간에 있는 정보를 잘 못 떠올린다.
  2. 명령 충돌: 쌓인 지시문끼리 모순돼 어느 쪽을 따를지 헷갈린다.
  3. 토큰 예산 압박: 부풀어 오른 시작 파일(CLAUDE.md 등)이 작업용 토큰을 먼저 차지한다.
  4. 관련성 불일치: 지금 작업과 상관없는 정보까지 매번 다 로드된다.

비유하자면 20만 토큰짜리 연료 탱크를 갖고 트렁크에 짐을 가득 실은 채 출발하는 셈이다. 그래서 CLAUDE.md 같은 파일 하나가 2,000~3,000 토큰을 넘으면 점검 신호로 보라고 한다.

2. 비용을 줄이는 settings.json 세 줄#

~/.claude/settings.json에 아래 세 가지를 넣는다.

json
{
  "model": "sonnet",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
  }
}
설정 내용 영상에서 말한 절감
model: sonnet 기본 모델을 Opus 대신 Sonnet으로. 코딩 작업의 80%는 Sonnet으로 충분하고, 깊은 설계·어려운 디버깅 때만 /model opus로 잠깐 바꾼다 약 60%
MAX_THINKING_TOKENS=10000 답하기 전 보이지 않는 thinking 토큰 상한을 기본 31,999에서 1만으로 숨은 비용 약 70%
CLAUDE_CODE_SUBAGENT_MODEL=haiku 자동으로 뜨는 보조 서브에이전트는 Haiku로 약 80%

세 가지를 합치면 기본 설정 대비 80% 이상 줄어든다고 한다.

3. 손 습관: /clear와 /compact#

  • /clear: 서로 관계없는 작업 사이에 쓴다. 컨텍스트를 즉시 통째로 비운다.
  • /compact: 마일스톤 사이에 쓴다. 리서치가 끝나고 구현에 들어가기 직전, 디버깅이 끝나고 다음 기능으로 넘어가기 직전처럼 자연스럽게 끊기는 지점에서 요약·압축한다.
  • 구현 도중에는 compact하지 않는다. 변수명, 파일 경로, 진행 중인 상태를 잃는다.
  • MCP 서버는 적게. MCP마다 도구 설명이 토큰을 차지해서, 많이 켜 두면 20만 토큰 창이 7만 토큰 수준까지 줄어든다. 프로젝트당 MCP 10개 이하, 활성 도구 80개 이하를 권장한다.

4. everything-claude-code 저장소#

Anthropic 해커톤 우승자 Affaan Mustafa가 열 달 동안 다듬은 Claude Code 설정을 공개한 GitHub 저장소다(영상 시점 스타 약 14만 3천 개).

  • 서브에이전트 38개, 필요할 때만 로드되는 스킬 56개, 슬래시 명령 72개, 항상 따르는 룰 34개, MCP 연동 설정 14개
  • 루트의 AGENTS.md 하나로 Claude Code뿐 아니라 Cursor, Codex, OpenCode, Antigravity, Gemini에서도 같은 설정이 동작한다고 한다.

메모리 학습 시스템 (Continuous Learning v2)#

  • 도구 호출 직전·직후에 hook이 돌면서 작업 방식을 관찰하고 반복 패턴을 찾는다. 예: "새 컴포넌트는 항상 이 폴더 구조로", "에러 처리는 항상 이 라이브러리로".
  • 이 패턴을 instinct 단위로 저장하고, 각각에 0.3~0.9 신뢰도 점수를 붙인다.
  • 관련 instinct가 3개 이상 모이면 /evolve로 재사용 가능한 스킬로 승격한다.
  • instinct는 export/import로 동료와 주고받을 수 있다. 팀 코딩 컨벤션을 한 번 가르치면 신입에게도 그대로 넘겨줄 수 있다.

보안 스캐너 AgentShield#

  • 설치 없이 npx 한 줄로 실행한다(영상 음성 기준 npx ecc-agentshield scan, 실제 명령은 저장소 README에서 확인).
  • CLAUDE.md, settings.json, MCP 설정, hook, 에이전트 정의를 스캔해 비밀키 노출, 과한 권한, hook 인젝션, 위험한 MCP 서버를 찾는다.
  • --opus 옵션을 붙이면 레드팀·블루팀·감사자 역할의 에이전트 셋이 서로 검증하며 위험 우선순위를 매긴다.

5. 시작 순서#

  1. 오늘 바로: settings.json 세 줄 적용.
  2. 다음: /plugin marketplace add로 everything-claude-code를 추가하고 /plugin install로 플러그인 설치. 룰은 저장소를 clone해서 설치 스크립트로 따로 넣는다.
  3. 주의: 스킬을 한꺼번에 다 깔지 않는다. search-first, TDD workflow, strategic-compact 같은 핵심부터 시작하고 필요할 때 하나씩 추가한다. 멀티 에이전트 명령은 별도 런타임이 필요하니 처음엔 건너뛴다.

정리#

  • 품질이 떨어지는 원인은 context rot이다. 시작 파일을 가볍게 유지하고, 끊기는 지점마다 /clear·/compact를 쓴다.
  • 비용은 모델·thinking 토큰·서브에이전트 모델 세 줄로 줄인다.
  • 여유가 생기면 strategic-compact 스킬, 그다음 메모리 학습 시스템 순서로 도입한다.
papercode