Claude Code 비용 폭탄 막는 법: 토큰·구독 플랜 절약 핵심 정리

매달 청구서 확인하다가 눈이 번쩍 뜨인 적 있나요? Claude Code를 API로 쓰는 개발자 중에 한 달에 수십만 원을 예상치 못하게 쓴 사례가 심심찮게 나와요. 2026년 들어 Team 플랜 기준으로 Claude Code가 전 시트 기본 포함되면서, 비용은 개인 취향이 아니라 팀 예산 얘기가 됐죠.
핵심 요약
- Claude Code는 매 메시지마다 전체 대화 기록과 프로젝트 컨텍스트를 API에 전송해서, 메시지 개수가 아닌 세션 크기가 비용을 결정해요.
- AWS 기술 블로그에 따르면,
/compact명령어 타이밍 하나로 수만 토큰 낭비를 막을 수 있어요.- 구독 vs. API 과금 선택이 가장 큰 절약 포인트예요. 440세션 기준으로 $200 구독 플랜이 API 직접 과금보다 약 여덟 배 저렴한 사례도 확인됐어요.
- 기본 모델을 Opus에서 Sonnet으로 바꾸는 것만으로 비용을 60~80% 줄일 수 있어요.
ANTHROPIC_API_KEY환경 변수가 설정된 채로 구독 플랜을 쓰면, 구독 한도가 아닌 API 요금으로 과금되는 함정이 있어요.
단순히 “많이 쓰면 비싸다"가 아니에요
Claude Code의 과금 구조는 메시지 길이가 아니라 세션 크기가 핵심이에요. 이 차이를 모르면 짧은 대화를 나눠도 비용이 눈에 띄게 쌓이죠.
AWS 기술 블로그에 따르면 매 메시지는 세 레이어를 전송해요:
- 시스템 프롬프트 — 도구 정의, 출력 스타일
- 프로젝트 컨텍스트 — CLAUDE.md, 메모리 파일
- 대화 기록 — 매 턴마다 업데이트
이 세 가지가 합쳐진 전체 세션이 매번 API를 탄다는 거예요. 메시지 하나 보낼 때마다요.
플랜 구조를 보면 이렇게 돼요:
- Pro: 월 $20 — 개인 시작점
- Max 5x: 월 $100 — 하루 종일 쓰는 개발자용
- Max 20x: 월 $200 — 긴 세션을 반복하는 헤비 유저용
- Team Standard: 월 시트당 $25 (연간 $20) — 팀 전체 포함
여기까지는 간단해요. 그런데 API 과금이 끼어들면서 복잡해지죠. Claude Sonnet 5 기준으로 입력 토큰 100만 개당 $2, 출력 100만 개당 $10이에요. 가격 변동이 있을 수 있으니 Anthropic 콘솔에서 직접 확인하는 게 맞아요.
가장 많이 당하는 함정도 있어요. 개발 환경에 ANTHROPIC_API_KEY가 설정돼 있으면, 구독 플랜을 써도 API 콘솔 요금으로 과금돼요. 구독 한도가 있는데 API 요금도 따로 나가는 거죠. 이걸 몇 달 동안 모르고 쓴 사례가 적지 않아요.
실전에서 가장 효과 큰 절약법 비교
컨텍스트 관리 명령어 선택
상황별로 쓸 명령어가 달라요:
| 상황 | 명령어 | 비용 영향 |
|---|---|---|
| 작업 전환 | /clear | 추가 비용 없음 |
| 컨텍스트 유지하며 요약 | /compact | 요약 요청 1회 발생 |
| 잘못된 방향 되돌리기 | /rewind | 기존 캐시 직접 활용 |
| 캐시 만료 후 재개 | /compact 자동 실행 | 가장 비싼 조합 ⚠️ |
핵심은 타이밍이에요. 자동 compact는 컨텍스트가 95%일 때 실행되지만, ClOr에 따르면 70% 시점에 수동으로 실행하는 게 훨씬 낫다고 해요. 낭비되는 컨텍스트가 훨씬 적거든요.
도구 사용도 주의해야 해요. 한 번의 응답 안에서 도구를 여러 번 쓰면 각각이 별도 API 요청이에요. MCP 서버를 붙이면 연결/해제 한 번에 전체 캐시가 날아가요.
모델 선택: 가장 쉬운 절약
| 모델 | 입력 (1M 토큰) | 출력 (1M 토큰) | 추천 용도 |
|---|---|---|---|
| Haiku 4.5 | $1 | $5 | 단순 서브에이전트 작업 |
| Sonnet 5 | $2~$3 | $10~$15 | 기본값으로 권장 |
| Opus 4.8 | $5 | $25 | 복잡한 아키텍처 결정만 |
ClOr는 Opus를 계획 단계에만 쓰는 /model opusplan 설정을 권장해요. 이것 하나로 전체 비용의 60~80%를 아낄 수 있어요.
구독 vs. API — 누구에게 뭐가 맞나
실제로 한 개발자가 $200 Max 플랜으로 440세션, 18,000턴을 썼을 때 API 직접 과금으로는 $1,588이 나왔을 거예요. 여덟 배 이상 차이가 나는 거죠. 하지만 한 달에 몇 번만 가볍게 쓰는 사람에게는 API가 더 맞아요. 항상 구독이 답은 아니에요.
지금 당장 확인해야 할 것들
“구독 쓰는데 왜 요금이 나오지?”
터미널에서 echo $ANTHROPIC_API_KEY를 실행해서 값이 있으면, 그게 청구의 원인이에요. 구독만 쓸 거라면 해당 변수를 제거하세요. LaoZhang AI Blog는 이걸 “예상치 못한 청구의 가장 흔한 원인"이라고 명확히 짚어요.
“팀 전체가 Claude Code를 쓰기 시작했어요”
멀티 에이전트 설정에 주의하세요. ClOr에 따르면 에이전트 팀은 단일 세션 대비 약 일곱 배 토큰을 써요. 에이전트를 5개 이상 붙이면 비용이 기하급수적으로 커질 수 있어요. 3~5개로 제한하고 각 에이전트에 Haiku를 쓰는 구조가 현실적이에요.
“CLAUDE.md가 너무 커졌어요”
200줄 이상이면 매 세션마다 그 내용이 전부 전송돼요. 워크플로우별 지침은 Skills 파일로 분리하고, 필요할 때만 로드하는 구조로 바꾸세요. /context 명령어로 컴포넌트별 점유율을 바로 확인할 수 있어요.
모니터링 습관 세 가지:
/usage: 세션 토큰 통계와 예상 비용 확인/context: 어디서 컨텍스트를 가장 많이 쓰는지 파악/insights: 최근 200개 세션 분석 — 마찰 지점을 HTML 리포트로 보여줘요
지금 아는 게 6개월 후 청구서를 바꿔요
정리하면 이렇게 돼요.
- 비용은 메시지 수가 아니라 세션 크기로 결정돼요
- 구독 vs. API 선택이 가장 큰 절약 포인트이고, 환경 변수 설정이 혼용의 원인이에요
- Sonnet을 기본값으로, Opus는 꼭 필요한 순간만 써요
/compact는 자동이 아닌 70% 시점에 수동으로 실행해요- CLAUDE.md는 200줄 이하로 유지하고, MCP 연결/해제는 신중하게 해요
앞으로 6~12개월 사이에 Claude Code를 쓰는 팀이 더 늘어날 거예요. Anthropic이 Team Standard에 Claude Code를 기본 포함한 건 방향을 명확히 보여줘요. CI/CD 파이프라인, 자동화 에이전트에 붙이는 사례도 빠르게 늘고 있고요.
지금 제대로 알아두면 팀에서 AI 도구 예산을 설득할 때 훨씬 구체적인 근거를 댈 수 있어요. 환경 변수 설정부터 먼저 한번 확인해 보세요.
참고자료
- Manage costs effectively - Claude Code Docs
- Claude 콘솔의 비용 및 사용량 보고 | Anthropic 지원 센터
- Claude Code by Anthropic | AI Coding Agent, Terminal, IDE
Photo by Bernd 📷 Dittrich on Unsplash


