핵심 요약
- 먼저 /context를 실행하세요. 시스템 프롬프트·도구·MCP 서버·메시지가 각각 토큰을 얼마나 먹는지, 줄이기 전에 실태부터 파악됩니다.
- 이어서 작업하면 /compact, 새로 시작하면 /clear. 오래 기억할 내용은 대화가 아니라 CLAUDE.md에 적으세요.
- 시작 시 로딩을 다듬으세요. MCP 서버는 최소한으로, CLAUDE.md는 간결하게 — 설치된 skill과 agent는 설명 문째 컨텍스트에 들어갑니다.
- 답만 필요한 질문은 서브에이전트로, 단순 작업은 저렴한 모델로. effort를 낮추거나 CLI 전체를 DeepSeek 가격으로 결제되게 바꾸세요.
Context Management in Claude Code
채널: Claude — official YouTube channel3:31
How to Optimize Token Usage in Claude Code
채널: Greg14:59
Managing context — official Claude Code docs
문서: code.claude.com/docs
7 Ways To Cut Your Claude Code Token Usage In Half
채널: Sean Kochel28:13
How to Reduce Token Usage in Claude Code (2026)
채널: The Code City5:09
화면 캡처는 공식 컨텍스트 관리 워크스루와 깔끔한 pricing 슬라이드 녹화에서 가져왔습니다. 단계 본문은 이 영상들과 비용·컨텍스트 관리 공식 문서를 따릅니다.
커뮤니티 팩트 소스(출처 표기만, 캡처 미사용): Sean Kochel의 「7 Ways To Cut Your Claude Code Token Usage In Half」, The Code City의 「How to Reduce Token Usage in Claude Code (2026)」. 스크린샷 권리는 각 제작자에게 있으며 정확한 타임스탬프로 연결됩니다.
12단계 토큰 다이어트
토큰이 어디로 가는지 보기
- 1
토큰 하나의 값을 알기
모델은 입력과 출력 모두 백만 토큰 단위로 과금합니다. 비대해진 시스템 프롬프트, 다시 읽은 파일, 장황한 답변 — 낭비된 토큰 하나하나가 Opus 급 가격에서는 실제 돈입니다.
Opus 4는 입력 백만 토큰에 15달러. 세션마다 수천 토큰씩 낭비하면 금방 모입니다.1:20 에서 시청 - 2
타이핑 전에 무엇이 로드됐는지 보기
세션 시작 시 Claude Code는 설치된 모든 custom agent와 skill의 이름과 설명을 컨텍스트에 싣습니다. 이 세션만 봐도 code-reviewer가 355 토큰, doc-helper가 68 토큰 — 첫 프롬프트를 입력하기도 전에요.
이 목록의 모든 agent와 skill은 첫 턴부터 입장료를 내고 있습니다.1:00 에서 시청 - 3
/context 대시보드 열기
/context를 입력하면 전체 내역이 한눈에 보입니다. 시스템 프롬프트·시스템 도구·MCP 서버·메시지가 각각 얼마나 차지하는지, 컨텍스트 윈도우가 얼마나 남았는지까지요.
200k 윈도우 중 21k 사용, 11% — 그런데 세션은 이제 막 시작했습니다.1:30 에서 시청
굼벵이부터 치우기
- 4
긴 세션은 /compact로 압축
컨텍스트 한도에 가까워지면 Claude Code가 자동으로 압축하지만, 기다릴 필요는 없습니다. /compact를 입력하면 그 자리에서 대화를 요약으로 압축합니다.
/compact 한 번이면 대화 전체가 그 자리에서 요약으로 바뀝니다.1:08 에서 시청 - 5
압축 후에도 바로 이어서 작업
요약에는 중요한 세부가 남습니다. 읽은 파일, 내린 결정, 남은 할 일 — 윈도우를 잡아먹던 중복 도구 출력만 사라집니다.
압축 직후: 계획과 미완료 항목은 살고, 노이즈만 사라졌습니다.1:45 에서 시청 - 6
작업 사이에는 /clear
경험 법칙: 현재 기능을 계속할 땐 /compact, 새 기능을 시작할 땐 /clear로 히스토리를 지우고 윈도우 전체를 확보합니다. 오래 기억해야 할 것은 CLAUDE.md에 적습니다.
/clear의 자동완성 설명이 말해줍니다: 대화 기록을 지우고 컨텍스트를 확보한다.1:18 에서 시청
프롬프트 습관 바꾸기
- 7
조사는 서브에이전트에게
"인증 엔드포인트가 어디 있죠?"처럼 답만 필요한 질문은 메인 스레드에서 뒤지지 말고 서브에이전트에게 넘기세요.
code-reviewer 서브에이전트가 코드를 리뷰하는 동안 뒤에서 git diff가 돌고 있습니다.2:50 에서 시청 - 8
서브에이전트가 토큰을 아끼는 이유
서브에이전트는 격리된 자체 컨텍스트 윈도우에서 돌아갑니다. 파일을 읽고, grep하고, 필요한 만큼 탐색한 뒤, 메인 스레드로 돌아오는 건 최종 답변뿐입니다.
메인 에이전트와 서브에이전트는 각자의 컨텍스트를 가지며, 답변만 되돌아옵니다.2:55 에서 시청 - 9
한 번에, 정확히 말하기
첫 프롬프트에서 파일명과 변경 범위를 직접 지목하세요. 모호한 지시는 모델이 코드베이스 전체를 뒤지게 만들고, 탐색 한 번마다 토큰이 타오릅니다.
로딩과 응답 줄이기
- 10
안 쓰는 MCP 서버는 뽑기
켜져 있는 MCP 서버는 손대지 않아도 도구 정의 전체를 컨텍스트에 싣습니다. 프로젝트에 불필요한 것은 비활성화하세요. 가벼운 용도라면 skill이 훨씬 저렴한 대안입니다.
- 11
CLAUDE.md도 다이어트 시키기
다듬어진 CLAUDE.md에는 프로젝트 한 줄 소개, 자명하지 않은 도구 제약, 검증 가능한 규칙, 피해야 할 안티패턴, 더 깊은 문서 링크만 담습니다. 비대한 CLAUDE.md는 매 턴 조금씩 토큰을 새는 만성 출혈입니다.
- 12
값싼 작업은 값싼 모델에게
단순 작업은 effort 단계를 낮추고(effort 가이드 참고), CLI 전체를 DeepSeek 엔드포인트에 연결해 모든 프롬프트를 DeepSeek 가격으로 결제하세요(Claude Code에서 DeepSeek 쓰기 가이드 참고).
토큰을 줄여주는 커뮤니티 도구와 플러그인
내장 명령 외에도 플러그인 마켓플레이스와 커뮤니티 CLI들이 토큰 소모를 직접 겨냥합니다. 아래는 전부 커뮤니티 영상의 실측에서 나온 것으로 공식 문서가 아닙니다. 참고 포인터로만 보세요.
- 1Token Optimizer 같은 감사 플러그인은 감사 서브에이전트 여럿을 돌려 skill·MCP 서버·CLAUDE.md가 세션마다 얼마를 쓰는지 목록화합니다. 설정을 한 번 촬영하는 X레이죠. (출처: Sean Kochel 실측 영상.)
- 2Matt Pocock의 Caveman 같은 출력 압축 skill은 서술을 걷어내고 기술적 내용만 남깁니다. README는 75% 절감을 주장하고, Sean Kochel의 실측은 30-40%. 두 숫자 모두 알아둘 만합니다. (출처: Sean Kochel 실측 영상.)
- 3Handoff 같은 인계 skill은 리서치 세션의 결론을 인계 문서로 묶어 /clear 후 새 세션에 가져갈 수 있게 합니다. 탐색 과정 전체를 컨텍스트에 두고 있을 필요가 없어집니다. (출처: Sean Kochel 실측 영상.)
- 4RTK 같은 출력 프록시 CLI는 도구와 Claude 사이에서 git status·git diff 같은 장황한 출력을, 입력 토큰이 되기 전에 필요한 줄만 남겨 필터링합니다. (출처: Sean Kochel 실측 영상.)
- 5Intent Layers 같은 디렉터리 단위 도구는 디렉터리별 CLAUDE.md/AGENTS.md를 자동 생성해, 세션이 작업 중인 디렉터리의 지침만 로드합니다. 지침이 2만 토큰을 넘는 디렉터리가 대상입니다. (출처: Sean Kochel 실측 영상.)
한 가지 주의: 이 도구들도 토큰을 씁니다. 감사는 서브에이전트를 돌리고, 프록시에도 처리 비용이 있습니다. 일회성 감사는 본전을 뽑지만, 상시 상주는 그렇지 않을 수 있습니다. 먼저 /context로 실태를 보고 누구를 남길지 정하세요.