본문으로 건너뛰기
블로그로
공개 가이드팁 & 트릭

Claude Code 비용 줄이는 7가지: 컨텍스트·모델·캐시

비용은 컨텍스트 크기에 비례합니다. /clear·/compact 지시·모델 선택·effort·캐시 유지·MCP 정리·plan 모드까지 공식 비용 문서의 방법을 효과 순으로 정리했습니다.

공식 출처 4건 · 본문 하단 확인 섹션과 동일

Claude Code 비용은 컨텍스트 크기에 비례합니다. 2026년 9월 11일 기준 공식 비용 문서는 기업 배포 평균을 개발자 1인당 활동일 기준 약 $13, 월 $150~250로 적고, 사용자 90%는 하루 $30 아래라고 밝힙니다. 구독(Pro·Max)은 한도 안에서 쓰고 API 키는 토큰마다 과금되지만, 줄이는 방법은 같습니다. 문서가 제시하는 방법을 효과가 큰 순서로 일곱 가지로 정리했습니다.

먼저 얼마나 쓰는지 본다

세션에서 /usage를 칩니다. 맨 위 Session 블록에 총비용·모델별 토큰·캐시 읽기 비율이 나옵니다. 구독자에게 달러 표시는 참고용이지만, 어떤 세션이 무거운지 보는 데는 충분합니다. 상태 표시줄에 컨텍스트 사용량을 항상 띄워 두면 더 좋습니다. /insights는 토큰이 아니라 작업 습관을 분석한 HTML 보고서를 만듭니다.

1. 작업이 바뀌면 /clear

가장 큰 낭비는 오래 열어 둔 세션입니다. 모든 요청은 대화 전체를 다시 보냅니다. 캐시 덕에 싸게 다시 읽긴 하지만, 하루 종일 연 세션에서 한 줄 질문을 해도 전체 대화만큼 사용량이 나갑니다. 무관한 작업으로 넘어갈 때 /clear로 새로 시작합니다. 나중에 찾을 세션은 /rename 후 지우고 /resume으로 돌아옵니다.

2. /compact에 지시를 붙인다

압축은 공짜가 아닙니다. 요약하려고 대화를 다시 읽으므로 큰 컨텍스트를 압축하는 것 자체가 큰 요청입니다. 대신 /compact Focus on code samples and API usage처럼 남길 것을 지정하면 요약이 쓸모 있어집니다. CLAUDE.md에 "# Compact instructions" 섹션으로 기본 지시를 둘 수도 있습니다.

3. 모델을 일에 맞춘다

문서 표현은 명확합니다. "Sonnet이 대부분의 코딩 작업을 잘 처리하고 Opus보다 싸다." Opus는 복잡한 설계나 여러 단계 추론에 남겨 둡니다. 세션 중에는 /model, 기본값은 /config. 서브에이전트에는 model: haiku를 지정할 수 있습니다. 모델 단가 차이는 비용 계산기에서 바로 비교됩니다.

4. 생각 깊이를 낮춘다

확장 사고(thinking)는 기본으로 켜져 있고 출력 토큰으로 과금됩니다. 단순한 작업은 /effort/model에서 effort를 낮춥니다. 고정 예산 모델은 MAX_THINKING_TOKENS=8000 같은 환경 변수로 줄이고, 적응형 모델은 effort만 듣습니다. Fable 계열은 사고를 끌 수 없습니다.

5. 캐시가 깨지는 행동을 피한다

/usagePrompt cache (main) 줄이 캐시 적중률과 미스 원인을 보여줍니다. 문서가 꼽는 대표 원인은 두 가지입니다. 휴식이 캐시 수명보다 길 때(구독은 1시간, API 키는 기본 5분)와 도구 정의가 바뀔 때입니다. 긴 휴식 뒤 큰 세션을 다시 열면 Pro·Max에서는 요약본으로 재개할지 물어보는데, 이때 요약을 고르면 이후 요청이 전체 이력을 끌고 다니지 않습니다.

6. 컨텍스트를 채우는 것들을 정리한다

  • MCP 서버: 도구 정의는 기본적으로 지연 로드되지만, /mcp에서 안 쓰는 서버를 끕니다. gh, aws, gcloud 같은 CLI가 있으면 그쪽이 더 가볍습니다.
  • CLAUDE.md: 세션마다 로드됩니다. 특정 워크플로 지침은 스킬로 옮기고 200줄 아래로 유지합니다. 작성법은 CLAUDE.md 작성법에.
  • 긴 출력: 테스트·로그·문서 읽기는 서브에이전트에 맡겨 요약만 받습니다. 훅으로 ERROR 줄만 남기는 전처리도 문서에 예제가 있습니다.

7. 처음부터 맞는 방향으로 간다

잘못된 방향으로 몇 턴 진행한 뒤 되돌리는 것이 가장 비쌉니다.

  • 복잡한 작업은 Shift+Tab으로 plan 모드에 들어가 계획부터 승인합니다.
  • 방향이 틀리면 Esc로 즉시 멈추고 /rewind로 체크포인트로 돌아갑니다.
  • 프롬프트에 테스트 케이스·기대 출력·스크린샷 같은 검증 기준을 넣습니다.
  • "이 코드베이스를 개선해 줘" 대신 "auth.ts의 login 함수에 입력 검증을 추가해 줘"처럼 구체적으로 씁니다.

조용히 나가는 비용

세션이 놀고 있어도 토큰이 조금 나갑니다. --resume용 대화 요약, /usage 같은 상태 확인이 대표적이고 문서는 세션당 보통 $0.04 미만이라고 적습니다. 예약 작업(/loop)이나 다른 세션에서 온 메시지는 매번 전체 컨텍스트를 보내므로, 큰 세션에 걸어 두지 않습니다. 에이전트 팀은 plan 모드에서 약 7배 토큰을 쓴다고 문서에 명시돼 있습니다.

다음 단계

출처와 확인 (2026-09-11)