클로드 코드 토큰 절약 방법
포니테일은 코드는 줄였지만 토큰·비용은 줄이지 않았습니다(실측 비용 27% 증가). 토큰을 아끼려면 아래 공식 설정 7가지가 먼저입니다.2026.10.14 확인
클로드 코드에서 같은 일을 하면서 토큰(사용량)을 덜 쓰는 방법입니다. 공식 문서가 권하는 설정부터, 토큰 절약 플러그인·스킬, 직접 잰 실측까지 정리했습니다.
클로드 코드 토큰 아끼는 설정 7가지(공식 문서)
1작업이 바뀌면 /clear
관련 없는 작업으로 넘어갈 때
/clear로 대화를 비웁니다. 오래된 맥락은 이후 메시지마다 토큰을 씁니다. 이전 대화는/rename해 두면/resume으로 되돌릴 수 있습니다.출처: code.claude.com
2/compact 에 남길 내용을 지정
/compact뒤에 "코드 예시와 API 사용법 위주로"처럼 요약 방향을 적을 수 있습니다.CLAUDE.md에 Compact instructions 절을 두면 자동 압축 때도 그 기준을 따릅니다.출처: code.claude.com
3CLAUDE.md 는 200줄 이하로
CLAUDE.md는 매번 읽힙니다. 공식 문서는 200줄 이하를 권하고 특정 작업에만 필요한 지침은 스킬로 옮기라고 합니다. 스킬은 부를 때만 불러옵니다.출처: code.claude.com
4대부분은 Sonnet, 어려운 설계만 Opus
/model로 모델을 바꿉니다. 공식 문서는 Sonnet 이 대부분의 코딩을 잘 처리하고 Opus 보다 싸다고 안내합니다. 서브에이전트는model: haiku로 따로 지정할 수 있습니다.출처: code.claude.com
5생각(thinking) 강도 낮추기
생각 토큰은 출력 토큰으로 계산됩니다.
/effort로 강도를 낮추거나MAX_THINKING_TOKENS로 예산을 줄일 수 있습니다. Opus 5.5·Sonnet 5.5·Haiku 5.5·Fable 모델은 생각을 끌 수는 없습니다.출처: code.claude.com
6/context 로 확인하고 안 쓰는 MCP 끄기
/context는 무엇이 맥락 창을 채우는지 보여 줍니다. 안 쓰는 MCP 서버는/mcp에서 끕니다. 공식 문서는 gh·aws 같은 CLI 가 MCP 보다 맥락을 덜 쓴다고 안내합니다.출처: code.claude.com
7출력이 큰 일은 서브에이전트에
테스트 실행·로그 확인처럼 출력이 긴 작업은 서브에이전트에 맡기면 본 대화에는 요약만 남습니다. 서브에이전트가 쓴 토큰도 사용량에 포함됩니다.
출처: code.claude.com
포니테일 쓰면 토큰이 줄어들까? 실측 결과
같은 작은 프로젝트에서 같은 요청 3개를 조건마다 3번씩 새로 실행한 평균입니다(Sonnet · 클로드 코드 2.1.293 · 2026.10.08 측정).
| 조건 | 출력 토큰 | 입력 토큰(캐시 포함) | 비용(API 환산) | 추가된 코드 줄 |
|---|---|---|---|---|
| 플러그인 없음 | 695 | 76,316 | $0.055 | 10.2 |
| 포니테일 켬 | 700 | 94,424 | $0.070 | 8.8 |
실행한 요청 3개:
- src/api.js 의 getUser 응답을 캐시해서 같은 id 를 다시 요청하면 네트워크를 다시 타지 않게 해 줘.
- src/utils.js 에 이메일 주소가 올바른 형식인지 검사하는 함수를 추가해 줘.
- src/utils.js 에 Date 를 "YYYY.MM.DD" 문자열로 바꾸는 함수를 추가해 줘.
클로드 코드 토큰 절약 스킬·플러그인
클로드 코드 안에 설치해 답변·코드 길이를 줄이는 플러그인입니다. 짧아진 만큼 토큰이 줄어드는지는 위 실측처럼 따로 확인해야 합니다.
포니테일 (ponytail)
가장 단순한 해결책(YAGNI·표준 라이브러리 우선)을 강제하는 스킬·훅. 한국어 README 있음무료 가능 무료(MIT)직접 잰 결과 토큰·비용은 줄지 않았습니다(위 실측). 코드를 짧게 만드는 용도로 쓰세요./plugin marketplace add DietrichGebert/ponytail /plugin install ponytail@ponytail케이브맨 (caveman)
에이전트가 짧게 말하게 하는 스킬 + 로그·JSON 입력을 줄이는 로컬 프록시무료 가능 무료(Apache-2.0)/plugin marketplace add JuliusBrussee/caveman /plugin install caveman@caveman
클로드 코드 토큰 절약 MCP·CLI 도구
명령 출력·로그·파일을 모델에 보내기 전에 줄이거나, 필요한 코드만 찾아 넣는 도구입니다.
context-mode
도구 출력을 샌드박스에 두고 맥락에 덜 넣는 MCP(로컬 전용, 계정 불필요)무료 가능 무료(Elastic License 2.0, 로컬 전용)/plugin marketplace add mksglu/context-mode /plugin install context-mode@context-modertk
자주 쓰는 개발 명령의 출력을 줄여 주는 CLI 프록시(Rust 단일 실행 파일)무료 가능 무료(오픈소스)brew install rtkheadroom
도구 출력·로그·파일을 모델에 보내기 전에 압축. 팀용 유료 플랜 별도일부 유료 오픈소스 무료(Apache-2.0), 팀용 유료 플랜 별도pip install "headroom-ai[all]"그래피파이 (graphify)
코드·문서·설정을 지식 그래프로 만들어 두고 질문할 때 전체 파일 대신 관련 연결만 먼저 찾게 하는 CLI·스킬. 그래프 생성은 LLM 호출 없이 로컬. PyPI 패키지 이름은 graphifyy(y 두 개)무료 가능 무료(Apache-2.0)uv tool install graphifyy graphify install마크잇다운 (MarkItDown)
PDF·워드·엑셀·PPT 를 마크다운으로 바꾸는 마이크로소프트의 파이썬 도구. 파일을 그대로 올리는 대신 변환한 글만 넣어 입력 토큰을 줄이는 용도. MCP 서버는 markitdown-mcp 패키지무료 가능 무료(MIT)pip install 'markitdown[all]'serena
언어 서버로 심볼 단위로 코드를 찾고 고치는 MCP 툴킷(파일 전체를 읽지 않음)무료 가능 무료uv tool install -p 3.13 serena-agentclaude-context
코드베이스를 벡터 검색해 필요한 코드만 넣는 MCP. Zilliz Cloud·임베딩 API 키 필요(별도 비용 가능)일부 유료 플러그인은 무료(MIT), Zilliz Cloud·임베딩 API 비용이 들 수 있음claude mcp add claude-context -- npx @zilliz/claude-context-mcp@latest
기준과 출처
- 설정·명령어 설명은 클로드 코드 공식 문서(code.claude.com)와 고객센터(support.claude.com)를 2026.10.14에 확인한 내용입니다.
- 설치 명령·라이선스·최근 업데이트는 각 GitHub 저장소 README 와 커밋 기록 기준입니다. 저장소가 내세우는 절감률·스타 수는 검증할 수 없어 싣지 않았습니다.
- 실측은 scripts/claude-code-bench.mjs 로 했습니다. 사용자 설정을 읽지 않는 상태(플러그인 없음)와 그 상태에 포니테일 하나만 더한 상태를 비교했고, 비용은 클로드 코드가 보고한 API 환산값이라 구독 요금제 사용량과는 다를 수 있습니다. 요청·프로젝트가 작아 큰 작업에서는 결과가 다를 수 있습니다.
- 제휴 관계는 없고, 추천에 제휴 여부를 반영하지 않습니다.
함께 보기
자주 묻는 질문
포니테일을 쓰면 클로드 코드 토큰이 줄어드나요?
직접 잰 결과, 작은 요청에서 비용은 줄지 않았습니다. Sonnet 모델로 같은 요청 3개를 3번씩 돌린 평균은 추가된 코드 줄 14% 감소, 답변 길이 21% 감소, 출력 토큰 1% 증가, 입력 토큰 24% 증가, 비용(API 환산) 27% 증가입니다. 플러그인 지침이 매 요청 입력에 더해지기 때문입니다. 코드가 길어지기 쉬운 큰 작업에서는 결과가 다를 수 있습니다(2026.10.08 측정).
클로드 코드 토큰 절약 스킬·플러그인은 무엇이 있나요?
코드·답변을 짧게 만드는 포니테일(ponytail)·케이브맨(caveman), 도구 출력을 줄이는 context-mode·rtk·headroom, 필요한 코드만 찾아 넣는 graphify·serena·claude-context, 파일을 마크다운으로 바꿔 올리는 MarkItDown 이 있습니다. 저장소가 내세우는 절감률은 검증하지 않았고 포니테일만 이 페이지에서 직접 쟀습니다.
클로드 코드 토큰 절약 MCP 가 있나요?
context-mode·claude-context·serena 가 MCP 형태입니다. 다만 공식 문서는 gh·aws 같은 CLI 가 MCP 보다 맥락을 덜 쓴다고 안내하고 MCP 도구 정의는 기본으로 필요할 때 불러온다고 설명합니다. /context 로 실제 점유량을 먼저 확인하세요.
플러그인 없이 클로드 코드 토큰을 아끼는 설정은?
작업이 바뀌면 /clear, 긴 대화는 요약 방향을 지정한 /compact, CLAUDE.md 200줄 이하, 대부분 Sonnet 사용, /effort 로 생각 강도 낮추기, 안 쓰는 MCP 끄기가 공식 문서의 권장입니다.
클로드 코드 토큰 사용량은 어떻게 확인하나요?
클로드 코드에서 /usage 를 입력하면 세션 사용량과 요금제 한도를 볼 수 있고 /context 는 무엇이 맥락 창을 채우는지 보여 줍니다. 자세한 방법은 클로드 코드 사용량 확인 방법에 정리했습니다.
클로드 코드 토큰 아끼는 프롬프트나 지침이 있나요?
공식 문서는 요청을 구체적으로 쓰고 큰 작업은 plan 모드로 계획부터 세우고 자주 쓰는 지침은 200줄 이하의 CLAUDE.md 나 필요할 때만 불러오는 스킬로 두라고 권합니다. 긴 대화는 /compact 뒤에 남길 내용을 적어 요약합니다.
클로드에 PDF 를 올리면 토큰을 더 쓰나요?
PDF 는 글자와 함께 페이지 이미지도 처리되므로 같은 내용의 글보다 토큰을 더 쓸 수 있습니다. 마이크로소프트의 MarkItDown 으로 PDF·워드·엑셀을 마크다운으로 바꿔 글만 넣으면 입력이 줄어듭니다. 얼마나 주는지는 파일마다 다르니 /context 로 확인하세요.
클로드 코드 컨텍스트 창이 다 차면 어떻게 되나요?
기본 설정에서는 정해진 비율까지 차면 클로드 코드가 오래된 대화를 자동으로 요약합니다(auto-compact). 그 전에 /compact 뒤에 남길 내용을 적어 직접 요약할 수도 있고 작업이 바뀌면 /clear 로 비우는 편이 토큰을 덜 씁니다. 무엇이 창을 채우는지는 /context 로 봅니다.