최근 claude가 잦은 compation을 일으켜 뭐가 문제인지 claude와 상담해봤더니 사용하고 있는 PDCA 플러그인이 너무 무겁다고 해서 확인해보니 우리가 안쓰는 기능들이 너무 많이 들어가 있더군
스킬 로드 할때 마다 어마무시한 컨텍스트가 쏟아지니 그럴수 밖에
이참에 우리가 쓸것만 뽑아내서 새 스킬을 뽑아내기로 했습니다
하네스 사이클 1회 돌때마다 30k의 토큰이 낭비 됐는데 거의 70퍼센트를 절감할 수 있었습니다
꽤나 훌륭한 성과라고 생각했죠
다음날도 여느때와 같이 claude와 놀고 있는데 어제한 작업에도 불구하고 compation이 오는 속도가 크게 줄어든 느낌이 들지 않더군요. 그래서 claude한테 "너 세션 시작할때랑, 턴 시작할때 들어오는 컨텍스트량이 얼마냐" 라고 물어보니 불필요한 rule과 플러그인, skill이 잔뜩 들어있었더군요, 유튜브 보면서 이거좋다 저거 좋다 이러면 반사적으로 설치했다가 이런지경이...
claude한테 우리가 사용하않는 rule, plugin,skill을 총 망라 해달라고 했더니 어마어마하게 많이 나오더군요
이것도 이것저것 다 합쳐보니 8250 토큰을 절약 할 수 있었습니다
이걸로 compaction에 대비해서 만든 remember 스킬을 사용해도 부담이 없어 졌습니다
아래는 claude가 써준 보고서 입니다
⚡ Claude Code 컨텍스트 최적화
세션 시작 시 불필요한 토큰 낭비를 줄이기 위한 감사·정리 방법론.
볼트처럼 개발과 무관한 프로젝트에서 코딩 rules/스킬이 계속 로드되면 컨텍스트 압박이 생긴다.
컨텍스트에 로드되는 항목
항목 | 경로 | 트리거 |
|---|
전역 CLAUDE.md | ~/.claude/CLAUDE.md
| 항상 |
프로젝트 CLAUDE.md | {project}/CLAUDE.md
| 항상 |
전역 rules | ~/.claude/rules/**/*.md
| 항상 (스킬 호출과 무관) |
로컬 skills | ~/.claude/skills/
| 목록 메타만 매 턴 로드 (본문은 호출 시) |
플러그인 agents | 플러그인 활성 시 | 항상 (system prompt 포함) |
rules는 스킬·명령과 무관하게 항상 로드된다
skills는 명시 호출 전까지 목록 메타만 매 턴 주입된다 (스킬 수 × 메타 크기).
최적화 방법 3가지
1. claudeMdExcludes — 프로젝트별 전역 rule 제외
{project}/.claude/settings.local.json에 추가:
{
"claudeMdExcludes": [
"/Users/macbook/.claude/rules/common/testing.md",
"/Users/macbook/.claude/rules/common/code-review.md",
"/Users/macbook/.claude/rules/common/git-workflow.md",
"/Users/macbook/.claude/rules/common/development-workflow.md",
"/Users/macbook/.claude/rules/common/security.md",
"/Users/macbook/.claude/rules/common/coding-style.md",
"/Users/macbook/.claude/rules/common/patterns.md",
"/Users/macbook/.claude/rules/web/**"
]
}
2. Skills 정리 — 불필요한 스킬 삭제
ls ~/.claude/skills/
rm -rf ~/.claude/skills/{사용안하는-스킬}
분류 기준:
유지 | 삭제 |
|---|
실제 호출하는 스킬 | 언어별 자동트리거 (사용 안 함) |
워크플로우 핵심 스킬 | 도메인 특화 (해당 도메인 없음) |
| 실험적·미사용 스킬 |
3. 플러그인 비활성화
~/.claude/settings.json:
{
"enabledPlugins": {
"bkit@bkit-marketplace": false
}
}
bkit 플러그인 활성화 시 agents 39개 + system prompt가 매 세션 로드됨.
실측 절약 효과 (2026-04-19, 볼트 프로젝트)
최적화 항목 | 절약 크기 | 절약 토큰 |
|---|
claudeMdExcludes 8개 rule 제외
| ~23 KB | ~5,750 |
skills 163→37개 정리 | ~8 KB | ~2,000 |
bkit 플러그인 OFF | ~2 KB+ | ~500 |
합계 | ~33 KB | ~8,250 |
감사 절차
~/.claude/rules/ 목록 확인 → 프로젝트 성격과 무관한 파일 식별
~/.claude/skills/ 목록 확인 → 실제 사용 여부 분류 후 삭제
~/.claude/settings.json enabledPlugins 확인 → 불필요 플러그인 OFF
settings.local.json에 claudeMdExcludes 적용
새 세션 시작 후 컨텍스트 토큰 비교
When to Use
새 프로젝트에서 Claude Code 처음 설정할 때
세션 시작 토큰이 과도하게 높을 때 (3,000+ 토큰)
컴팩트가 예상보다 일찍 발생할 때
볼트·문서 작업처럼 개발 rules가 불필요한 프로젝트
