Claude Code 토큰 사용량 줄이는 법 (한도에 그만 걸리기)

먼저 토큰이 어디에 쓰이는지 확인하기

긴 세션에서 사용량이 치솟는 이유

• 긴 컨텍스트: 요청마다 전체 대화가 함께 가고, 도구 호출이 한 번 돌 때마다 요청이 또 나가요. 캐싱 덕분에 다시 읽는 비용이 싸지지만 공짜는 아니에요.
• 캐시 미스: 캐시 유지 시간보다 오래 자리를 비운 뒤 보내는 첫 메시지는 컨텍스트 전체를 다시 처리해요.
• 자리를 비운 동안 돌아가는 것들: 세션 범위의 예약 작업과 /loop, 다른 세션에서 온 메시지, 목표 점검, 세션 요약, 유휴 시 자동 compact.
• 병렬 작업자: 서브에이전트, 워크플로 에이전트, agent team 팀원은 각자 요청을 보내요. 팀원이 플랜 모드로 돌면 agent teams는 일반 세션의 약 7x 토큰을 써요.
• compact 자체: /compact는 요약할 대화를 읽어야 해요. /clear는 비용이 들지 않아요.

Claude Code 토큰 사용량을 줄이는 12가지 방법

1. 관련 없는 작업 사이에는 대화 비우기

   /clear로 새 대화를 시작하면 오래된 컨텍스트가 더 이상 따라붙지 않아요. 나중에 /resume으로 돌아오고 싶다면 먼저 /rename을 실행하세요.

2. 지시를 붙여서 compact하기

   /compact Focus on code samples and API usage처럼 무엇을 남길지 Claude에게 알려 주세요. 늘 쓰는 compact 지시는 CLAUDE.md에 넣어 둘 수도 있어요.

   # Compact instructions
   
   compact를 할 때는 테스트 출력과 코드 변경 사항을 중심으로 남겨 주세요.

3. 알맞은 모델 쓰기

   Sonnet은 대부분의 코딩을 처리하고 Opus보다 저렴해요. Opus는 아키텍처와 어려운 추론에 아껴 두세요. /model로 바꾸고, 단순한 서브에이전트에는 model: haiku를 지정하세요.

4. 간단한 작업은 effort 낮추기

   사고 토큰은 출력으로 과금되고, 요청 한 번에 수만 개까지 늘어날 수 있어요. 일상적인 작업에서는 /effort로 단계를 낮추세요.

5. CLAUDE.md는 짧게

   CLAUDE.md는 세션마다 통째로 로드돼요. 200줄 정도 이내로 유지하고, 특정 워크플로용 지시는 쓸 때만 로드되는 스킬로 옮기세요. CLAUDE.md 가이드와 Claude Code 스킬을 참고하세요.

6. MCP 서버 정리하기

   도구 정의는 기본적으로 지연 로드되지만, 서버마다 이름과 설명은 여전히 추가돼요. 안 쓰는 서버는 /mcp에서 끄고, 도구별 목록을 추가하지 않는 gh, aws, gcloud 같은 CLI를 우선 쓰세요.

7. 훅으로 시끄러운 출력 걸러내기

   PreToolUse 훅으로 테스트 명령을 고쳐 실패만 남기면, 수만 토큰짜리 로그가 수백 토큰으로 줄어요. Anthropic 문서에 바로 쓸 수 있는 필터 스크립트가 있어요.

   {
     "hooks": {
       "PreToolUse": [
         {
           "matcher": "Bash",
           "hooks": [
             { "type": "command", "command": "~/.claude/hooks/filter-test-output.sh" }
           ]
         }
       ]
     }
   }

8. 장황한 작업은 서브에이전트에 맡기기

   테스트 실행, 문서 읽기, 로그 처리를 서브에이전트에서 하면 출력은 그 컨텍스트에 남고 요약만 돌아와요. 이런 서브에이전트에는 더 작은 모델을 주세요.

9. 코드 인텔리전스 플러그인 설치하기

   타입이 있는 언어라면 언어 서버 플러그인이 "정의로 이동"을 한 번의 호출로 처리해요. grep을 하고 파일을 여러 개 읽을 필요가 없어요.

10. 구체적인 프롬프트 쓰기

    "auth.ts의 login 함수에 입력 검증을 추가해 줘"는 파일 몇 개만 읽지만, "이 코드베이스를 개선해 줘"는 전부 훑어요.

11. 먼저 계획하고, 일찍 멈추기

    큰 변경에는 플랜 모드를 써서 코드를 쓰기 전에 잘못된 방향을 잡아내세요. Claude가 엇나가는 순간 Escape를 누르고, /rewind로 체크포인트로 되돌리세요.

12. 자리를 비운 동안 돌아가는 것 살피기

    예약 작업, /loop 실행, 유휴 메시지는 모두 전체 컨텍스트를 보내요. 필요 없는 루프는 멈추고, crossSessionInbound를 hold로 설정해 다른 세션에서 온 메시지를 대기열에 쌓아 두고, /usage의 Loops 행을 확인하세요.

출처: Claude Code 문서, Manage costs effectively

사용량 한도와 팀 비용

Pro, Max, Ultra에서는 사용량이 청구서가 아니라 요금제 한도에서 차감돼요. 5시간 한도와 주간 한도가 어떻게 작동하는지는 Claude Code vs Codex를 참고하세요. API의 경우 Anthropic은 기업 평균이 개발자 1명당 활동일 하루 약 $13, 한 달 $150~$250이고, 사용자의 90%가 하루 $30 미만이라고 밝혔어요.

관리자는 팀에 지출 한도를 설정할 수 있고, 관리형 설정에 modelPricing 테이블을 넣으면 /usage에 정가 대신 계약 요율이 표시돼요.

일정에 맞춰 일하고, 밤새 토큰을 태우지 않는 에이전트

세션을 깨우는 건 무엇이든 전체 컨텍스트를 보내기 때문에, 늘 켜져 있는 에이전트에는 한계선이 필요해요. Crewmark는 Claude Code, Codex, DeepSeek Harness, OpenCode 세션을 AI 직원으로 바꾸고, 내가 정한 근무 시간에만 하트비트로 깨워요.

1. 근무 시간과 리듬 정하기

   15분, 30분, 60분 간격 중 하나와 근무하는 시간대를 고르세요. 그 밖의 시간에는 잠들어 있어요. Claude Code를 능동적으로 만드는 법을 참고하세요.

2. 한 번에 이슈 하나씩

   하트비트마다 보드에서 다음 이슈를 가져오기 때문에, 세션은 끝없는 탐색 대신 초점이 분명한 작업을 해요.

3. 이미 결제한 요금제 그대로

   직원은 기존 구독으로 돌아가고, 사용량은 요금제 한도에서 차감돼요. AI 직원이란을 읽어 보세요.

Claude Code 토큰 사용량 FAQ