Claude Code 토큰 비용: 세션이 실제로 소비하는 것

빠른 답변: 센트가 아니라 달러 단위를 예상하세요.

Claude Code는 채팅창이 아니라 에이전트형 도구입니다. 당신의 요청 하나가 수십 번의 모델 호출을 촉발할 수 있고, 각 호출은 점점 커지는 전체 대화를 입력 토큰으로 다시 보냅니다. 그래서 출력이 아니라 입력량이 비용을 좌우합니다. 출력 토큰은 보통 입력 옆에서는 반올림 오차 수준입니다. 커뮤니티에서 보고된 대략적인 수치로는, 중간 규모 저장소에서 진지하게 한 시간 작업한 세션이 대략 500만에서 2,000만 토큰에 이릅니다. Sonnet 4.6의 Anthropic 직접 요율(100만 개당 입력 $3, 출력 $15) 기준으로, 대부분의 세션은 캐싱 할인 전 약 $2에서 $40 사이에 자리 잡고, Opus를 많이 쓰는 날은 그보다 훨씬 위로 올라갑니다. 프롬프트 캐싱은 실제 청구액을 단순 계산보다 낮추지만, 큰 그림은 그대로입니다. 큰 저장소에서 진행되는 긴 세션은 실제로 돈이 듭니다. 레버는 세 가지입니다. 컨텍스트 창에 들어가는 것을 줄이고, 반복 작업은 더 저렴한 모델로 라우팅하고, 요청이 과금되는 위치를 바꿔 토큰당 요율을 낮추는 것입니다. 이 페이지의 나머지 부분에서 각각을 구체적인 숫자로 다룹니다.

토큰이 실제로 어디로 가는가.

두 가지 메커니즘이 이를 완화합니다. 첫째, Anthropic 프롬프트 캐싱: Claude Code는 안정적인 접두사를 캐시 가능으로 표시하고, 캐시 쓰기는 프리미엄이 붙지만 캐시 읽기는 일반 입력 요율의 약 10분의 1로 과금됩니다. 둘째, 컨텍스트 압축: /compact 명령이 기록을 요약하고 원본 트랜스크립트를 버립니다. 둘 다 큰 도움이 되지만, 어느 쪽도 근본 규칙을 바꾸지는 못합니다. 창에 들어 있는 모든 것은 그것을 포함하는 모든 호출에서 과금됩니다. 이것이 같은 프롬프트가 저장소마다 전혀 다른 비용이 나오는 이유입니다. 가벼운 CLAUDE.md를 가진 새 세션에서 던진 질문은 저렴합니다. 대형 파일을 여러 개 읽은 세션에서 30턴째 던진 같은 질문은 여섯 자릿수 토큰 창 위에 얹혀 있습니다.

• 시스템 프롬프트와 툴 정의: 대략 1만 5천에서 2만 토큰이며, 모든 단일 모델 호출마다 다시 전송됩니다.
• CLAUDE.md, 규칙 파일, MCP 툴 스키마: 세션 시작 시 로드되어 이후 모든 호출에 실립니다.
• 파일 읽기: 500줄짜리 소스 파일은 대략 5,000에서 7,000토큰이며, 한 번 읽고 나면 창에 계속 남습니다.
• 툴 결과: 테스트 출력, grep 결과, 터미널 로그는 대화에 추가되어 이후 모든 턴에서 입력으로 재과금됩니다.
• 에이전트 루프 자체: "이 실패한 테스트 고쳐줘" 한 마디가 Claude Code가 응답을 보고하기 전에 10에서 40번의 모델 호출을 만들어낼 수 있습니다.

현실적인 세션 비용 계산.

추측 대신 턴 단위로 모델링해보세요. 일반적인 중간 규모 세션은 약 40번의 모델 호출을 실행합니다. 파일 몇 개와 테스트 출력이 쌓이고 나면, 호출당 전체 창은 평균 약 9만 토큰이 됩니다. 40번 호출에 9만 토큰이면 입력 토큰 360만 개입니다. 출력은 작게 유지됩니다. 40번 호출에 각 약 1,000토큰이면 출력 토큰은 약 4만 개입니다. 아래 표는 Anthropic 직접 정가로 세 가지 세션 프로필의 가격을 매긴 것입니다. 이를 상한선으로 보세요. 프롬프트 캐싱이 반복되는 접두사를 크게 할인해주므로, 캐싱된 세션은 보통 더 낮게 나옵니다. 그 패턴은 개발자들이 보고하는 것과 일치합니다. 가끔 있는 오후 작업은 몇 달러가 들고, Opus를 매일 API에서 주력으로 쓰면 한 달에 수백 달러가 나올 수 있습니다.

플랜 vs API: Claude Code는 어느 쪽이 더 저렴한가?

Anthropic은 Claude Code를 두 가지 방식으로 판매합니다. 롤링 창 안에서 사용량 상한이 적용되는 정액 구독 플랜에 번들로 포함하거나, API에서 토큰 단위로 계량하는 방식입니다. Claude Code API 가격은 단순히 위 모델 요율을 세션이 실제로 태우는 만큼 적용한 것이며, 상한도 차단도 없습니다. 손익분기점은 단순한 산수입니다. 일반적인 세션이 Sonnet 직접 요율로 약 $11이 든다면, $20 플랜은 상한을 넘지 않는다는 전제 하에 한 달에 약 두 세션만 써도 본전을 뽑습니다. 문제는 그 상한 자체입니다. 무거운 에이전트형 사용은 정확히 롤링 리밋에 걸리기 쉬운 패턴이며, 세션 도중 잠기는 순간 정액 요금은 더 이상 저렴하지 않게 됩니다. API 과금은 이 거래를 뒤집습니다. 절대 끊기지 않고, 태운 만큼만 지불합니다. 많은 헤비 유저는 결국 혼합형으로 정착합니다. 인터랙티브 작업에는 플랜을, CI 작업과 오버플로우에는 API 키를 씁니다.

Claude Code 토큰 비용을 줄이는 법.

마지막 두 레버는 함께 쌓입니다. 저렴한 모델을 할인된 엔드포인트로 라우팅하면, 반복 작업에서 $10짜리 세션이 1달러도 안 되게 줄어들 수 있습니다. 게이트웨이 옵션 중 하나가 APIsRouter입니다. 구독 없이 사용량 기반으로 과금되는 OpenAI 호환 API로, 글로벌 모델은 공식 정가보다 20% 낮고, 중국 모델은 공식 요율보다 낮으며, 첫 충전은 잔액이 100% 추가되고, 가입 없는 결제인 /topup은 결제를 먼저 받고 이메일로 키를 보냅니다. 아래 카탈로그는 실제로 어떤 라우팅 사다리가 가능한지 보여줍니다. 예산 등급을 선호한다면 Kimi K2.6(kimi-k2.6)도 이용할 수 있습니다.

• CLAUDE.md를 가볍게 유지하세요. 모든 줄이 모든 세션의 모든 모델 호출에서 반복 청구되는 항목입니다.
• 작업마다 새 세션을 시작하고, 긴 세션이 늘어지면 /compact를 실행하세요. 15만 토큰짜리 창은 매 호출마다 15만 토큰을 과금합니다.
• 읽기 범위를 좁히세요. Claude Code가 알아서 훑고 다니게 두는 대신 특정 파일을 지정하고, 빌드 산출물과 벤더 디렉터리는 제외하세요.
• 쓰지 않는 MCP 서버는 꺼두세요. 그 툴 스키마는 모든 호출의 시스템 프롬프트에 함께 실립니다.
• 모델별로 라우팅하세요. 아키텍처와 까다로운 디버깅에는 Opus를 남겨두고, 기본값은 Sonnet으로, 보일러플레이트, 테스트 뼈대, 커밋 메시지는 더 저렴한 모델로 넘기세요.
• base URL을 직접 정가 대신 게이트웨이로 지정해 토큰당 요율 자체를 낮추세요.

설정 예시: Claude Code를 재지정하고 확인하기.

Claude Code는 시작할 때 ANTHROPIC_BASE_URL을 읽으므로, 토큰이 과금되는 위치를 바꾸는 것은 워크플로 변경이 아니라 설정 변경입니다. 엔드포인트와 키를 ~/.claude/settings.json에 넣으면 모든 세션이 이를 그대로 가져다 씁니다. 모델 ID는 그대로 유지되고, 툴 실행은 여전히 내 컴퓨터에서 로컬로 이뤄지며, 롤백은 한 줄을 주석 처리하면 끝입니다. OpenAI 호환 도구와 스크립트라면 base URL은 /v1로 끝납니다(https://api.apisrouter.com/v1). 매일 쓰는 드라이버로 지정하기 전에 한 번 curl로 키를 확인해보세요.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apisrouter.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-APIsRouter-...",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6"
  }
}

자주 묻는 질문