Claude Code 사용량이 빨리 닳을 때 — /usage로 원인 찾고 줄이는 7단계

KAITABASE가 공식 문서와 원문을 직접 읽고 새로 쓴 가이드입니다.

이 가이드로 할 수 있는 것

공식 비용 문서는 Claude Code가 API 토큰 사용량으로 비용이 매겨지며, 같은 일을 해도 모델 선택 · 코드베이스 크기 · 쓰는 방식에 따라 크게 달라진다고 설명합니다. 기업 배포 평균은 활동한 날 하루 약 13달러, 개발자 한 명당 월 150~250달러이고, 사용자의 90%는 하루 30달러 아래라고 밝힙니다.

사용량이 빨리 닳는 원인은 대개 세 가지입니다. 대화가 길어져 요청마다 보내는 맥락이 커진 경우, 캐시가 깨져 같은 내용을 다시 처리한 경우, 내가 모르는 사이 다른 작업(서브에이전트 · 예약 작업)이 돌아간 경우입니다. 이 가이드는 이 셋을 확인하고 줄이는 순서입니다.

빠른 시작

Claude Code 세션에서 다음을 입력합니다.

/usage

공식 문서 기준(직접 실행 안 함): 맨 위 Session 블록에 이번 세션의 토큰 · 추정 비용이, 구독 요금제라면 아래에 요금제 사용량 막대와 "무엇이 사용량을 차지했는지" 분석이 나옵니다. /cost 와 /stats 는 같은 명령의 다른 이름입니다.

Total cost:            $0.55
Usage by model:
   claude-sonnet-4-6:  1.2k input, 5.3k output, 940.0k cache read, 50.0k cache write ($0.55)

(공식 문서에 실린 예시 화면입니다.)

STEP 1. /usage로 어디서 썼는지 보기

목표: 감으로 줄이지 말고 숫자로 원인을 찾습니다. · 예상 시간: 3분

1. /usage 를 엽니다.
2. 구독 요금제(Pro · Max · Team · Enterprise)라면 Attribution 에서 스킬 · 서브에이전트 · 플러그인 · MCP 서버별 비중을 봅니다.
3. Recommendations 행을 읽습니다. 최근 사용량의 10% 이상을 차지하는 행동만 행으로 나옵니다. 예: 25% Trim ~/code/api/CLAUDE.md · 49k tokens per request
4. d 와 w 로 최근 24시간 · 7일을 바꿔 봅니다.

확인 화면 아래에 f to fix 2 of 3 같은 안내가 보이면 f 를 눌러 Claude Code가 적용할 수 있는 권고를 맡길 수 있습니다(v2.1.305 이상). 바꾸기 전에 변경 내용을 보여 달라고 요청하는 방식입니다.

막히면 구독자에게 Session 블록의 달러 금액은 청구액이 아닙니다. 공식 문서는 이 금액이 정가로 계산한 추정치이며, 실제 청구는 Claude Console의 Usage 페이지(API 사용자)에서 보라고 안내합니다. 수치는 이 컴퓨터의 기록만 계산하므로 다른 기기 · claude.ai 사용분은 빠집니다.

STEP 2. 캐시가 잘 맞는지 보기

목표: 같은 내용을 다시 처리하는 낭비(캐시 미스)를 찾습니다. · 예상 시간: 3분

/usage 의 Session 블록에는 첫 응답 뒤부터 Prompt cache (main) 줄이 붙습니다(v2.1.251 이상).

Prompt cache (main):   14 requests · 91% of input tokens from cache · 2 misses ... · warm (1h TTL, last activity 40s ago)

(공식 문서 예시) 캐시에서 읽은 비율이 높을수록 좋고, misses 가 많으면 무언가가 앞부분을 계속 바꾸고 있다는 뜻입니다. 원인을 알 수 있으면 likely cause: tool definitions changed 처럼 이유도 적어 줍니다(v2.1.260 이상).

공식 캐시 문서가 꼽는 "캐시를 깨는 행동"은 다음과 같습니다.

• 작업 도중 /model 로 모델 바꾸기(모델마다 캐시가 따로입니다)
• 대부분의 모델에서 작업 도중 effort 바꾸기(Opus 5.5 · Sonnet 5.5 · Haiku 5.5 · Fable 5.1은 API 키 · 구독에서 캐시 유지)
• 빠른 모드(fast mode) 켜기, MCP 서버 연결 · 해제, 플러그인 켜고 끄기
• /compact(설계상 대화 부분을 새로 만듭니다), 이미지 · PDF가 많이 쌓여 오래된 것이 빠질 때
• Claude Code 업그레이드 뒤 첫 세션

반대로 파일 수정, 세션 중 CLAUDE.md 수정, 권한 모드 바꾸기, 스킬 · 명령 부르기, /rewind 는 캐시를 유지합니다.

확인 바꿀 게 있으면 작업 중간이 아니라 작업과 작업 사이에 바꿉니다.

STEP 3. 쉬었다 돌아올 때를 알기

목표: 첫 질문이 유독 비싼 이유를 이해합니다. · 예상 시간: 2분

캐시는 일정 시간 요청이 없으면 만료됩니다. 공식 문서 기준 기본값은 다음과 같습니다.

만료 뒤 첫 메시지는 전체 대화를 다시 처리합니다. 그래서 하루 종일 열어 둔 긴 세션에 한 줄 질문을 해도 사용량이 크게 잡힐 수 있습니다. 필요하면 promptCacheTtl 설정이나 CLAUDE_CODE_PROMPT_CACHE_TTL 환경 변수로 5m · 1h 를 직접 고를 수 있습니다(v2.1.242 이상). 1시간은 캐시 쓰기 요금이 더 비싸므로, 5분 안에 끝나는 짧은 작업만 한다면 오히려 손해입니다.

STEP 4. /clear · /compact · /rewind 고르기

목표: 맥락을 줄이는 세 명령을 상황에 맞게 씁니다. · 예상 시간: 3분

막히면 /compact 뒤에 지시가 사라진 것 같으면, 그 지시가 대화로만 전달됐기 때문일 수 있습니다. 공식 문서에 따르면 프로젝트 루트 CLAUDE.md는 압축 뒤 다시 읽히므로, 계속 지켜야 할 지시는 CLAUDE.md로 옮깁니다. CLAUDE.md에 # Compact instructions 절을 두면 압축 때 남길 것을 정할 수 있습니다.

STEP 5. 매 요청에 실리는 고정 비용 줄이기

목표: 질문하지 않아도 매번 따라가는 맥락을 줄입니다. · 예상 시간: 5분

1. /context 로 무엇이 맥락을 차지하는지 봅니다.
2. CLAUDE.md는 200줄 안으로 줄이고, 특정 작업에만 필요한 절차는 스킬로 옮깁니다. 스킬 본문은 불렀을 때만 읽힙니다.
3. /mcp 에서 지금 안 쓰는 MCP 서버를 끕니다. 공식 문서는 gh, aws 같은 CLI가 있으면 MCP보다 맥락을 덜 쓴다고 설명합니다.
4. 긴 테스트 로그 · 문서 검색은 서브에이전트에 맡겨 요약만 받습니다. 다만 서브에이전트의 요청도 사용량에 포함됩니다.

확인 STEP 1의 /usage Recommendations에 CLAUDE.md 줄이기 같은 행이 있었다면, 고친 뒤 다음 날 다시 열어 그 행이 사라졌는지 봅니다.

STEP 6. 모델 · effort 맞추기

목표: 일의 난이도에 맞는 모델과 생각 깊이를 고릅니다. · 예상 시간: 2분

공식 문서는 대부분의 코딩 작업은 Sonnet이 잘 처리하고 Opus보다 저렴하므로, Opus는 복잡한 설계 판단이나 여러 단계 추론에 쓰라고 권합니다. 간단한 일은 /effort 로 생각 깊이를 낮춥니다. 생각(thinking) 토큰은 출력 토큰으로 계산됩니다. Opus 5.5 · Sonnet 5.5 · Haiku 5.5 · Fable 모델은 생각을 끌 수 없으므로 effort로 조절합니다.

/model
/effort low

주의 모델 바꾸기는 STEP 2에서 본 캐시 미스를 부릅니다. 작업 중간에 자주 바꾸지 말고, 새 작업을 시작할 때 고릅니다.

STEP 7. 한도에 닿았을 때

목표: 구독 한도를 넘겨도 계속 쓸지, 멈출지 정합니다. · 예상 시간: 2분

Pro · Max 구독자는 /usage-credits 로 claude.ai의 Settings > Usage 를 열어 사용량 크레딧을 켜고 끄고, 월 지출 한도를 정할 수 있습니다. Team · Enterprise 구성원은 결제 권한이 있으면 조직 사용량 설정이 열리고, 없으면 관리자에게 요청을 보냅니다. 이 명령은 API 키 로그인에서는 쓸 수 없습니다.

주의 공식 문서에 따르면 사용량 크레딧으로 넘어가면 메인 대화의 캐시 기본값이 1시간에서 5분으로 바뀝니다.

잘못 쓰는 예 · 바르게 쓰는 예

바로 쓰는 프롬프트 · 템플릿

압축할 때:

/compact 지금까지 바꾼 파일 목록, 실패한 테스트 이름, 남은 할 일만 남기고 요약해 주세요.

비용 점검을 맡길 때:

/context 결과를 보고, 매 요청에 실리는 항목 중 줄일 수 있는 것을 큰 순서대로 3개만 알려 주세요.
CLAUDE.md에서 스킬로 옮길 만한 절이 있으면 절 이름만 짚어 주세요. 파일은 아직 고치지 마세요.

CLAUDE.md에 넣는 압축 지시:

## Compact instructions

압축할 때는 테스트 출력과 코드 변경 내용을 우선 남긴다

주의할 점

• 요금: 구독 요금제 가격은 claude.com/pricing에서 확인합니다. 이 가이드는 가격을 옮겨 적지 않았습니다. 바뀔 수 있기 때문입니다.
• 추정치: /usage 의 달러 금액과 사용량 분석은 이 컴퓨터 기록으로 계산한 근사치입니다.
• 팀 관리: 조직은 Claude Console이나 Team · Enterprise 관리 화면에서 지출 한도를 둘 수 있습니다. 공식 문서는 작은 시범 그룹으로 기준선을 먼저 재고 넓히라고 권합니다.
• 보이지 않는 사용량: 예약 작업(/loop), 다른 세션에서 온 메시지, 서브에이전트 · 에이전트 팀은 내가 입력하지 않아도 요청을 보냅니다. 공식 문서는 팀원이 plan 모드로 돌 때 에이전트 팀이 일반 세션보다 약 7배 토큰을 쓴다고 밝힙니다.
• 라이선스: 이 가이드는 Anthropic 공식 문서를 우리 말로 다시 정리한 것입니다.

공식 자료

• Manage costs effectively — https://code.claude.com/docs/en/costs
• How Claude Code uses prompt caching — https://code.claude.com/docs/en/prompt-caching
• Commands 목록(/usage, /clear, /compact, /rewind, /effort) — https://code.claude.com/docs/en/commands
• 사용량 크레딧 안내 — https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans
• 요금제 — https://claude.com/pricing

더 보기

이 가이드는 KAITABASE가 공식 문서와 원문을 직접 읽고 실행해 본 뒤 새로 쓴 자료입니다. 같은 주제의 다른 글은 KAITABASE에서 이어서 볼 수 있습니다.

• AI 코딩 자료 모음 — https://kaitabase.vercel.app/?area=coding
• KAITABASE 전체 자료 — https://kaitabase.vercel.app