Claude Code를 팀에 도입하고 나면 비슷한 질문들이 찾아옵니다. 짧은 한 문장의 질문만 했는데 토큰 사용량이 왜 이렇게 높은지, 하루가 끝날 때쯤이면 세션이 왜 이렇게 무거워져 있는지 같은 의문입니다. Claude Code는 메시지를 보낼 때마다 시스템 프롬프트, 프로젝트 컨텍스트, 지금까지의 전체 대화 이력을 다시 전송하고, 비용은 그 컨텍스트 크기에 비례합니다. 그리고 실제로 지불하는 토큰 단가는 프롬프트 캐싱(prompt […] ||
Claude Code를 팀에 도입하고 나면 비슷한 질문들이 찾아옵니다. 짧은 한 문장의 질문만 했는데 토큰 사용량이 왜 이렇게 높은지, 하루가 끝날 때쯤이면 세션이 왜 이렇게 무거워져 있는지 같은 의문입니다.
Claude Code는 메시지를 보낼 때마다 시스템 프롬프트, 프로젝트 컨텍스트, 지금까지의 전체 대화 이력을 다시 전송하고, 비용은 그 컨텍스트 크기에 비례합니다. 그리고 실제로 지불하는 토큰 단가는 프롬프트 캐싱(prompt caching) 적중률이 정합니다. 이 글은 Claude Code 토큰 비용 최적화를 다루는 2부작 시리즈의 1부로, 비용 구조와 측정 도구, 그리고 개인이 바로 적용할 수 있는 세션 습관을 다룹니다. 캐시 경제학과 Amazon Bedrock을 포함한 조직 단위 비용 관리는 2부에서 이어집니다. 대상 독자는 Claude Code를 실무에서 사용해 본 분들이며, 토큰과 기본 슬래시 명령 사용 경험은 전제하되 프롬프트 캐싱 같은 핵심 개념은 본문에서 정의합니다. 본문의 수치와 기본값은 Claude Code 공식 문서와 Amazon Bedrock 사용자 가이드의 2026년 8월 기준입니다.
1. 비용 구조: 토큰은 어디서 쓰이는가
모델은 요청 사이에 아무것도 기억하지 않습니다. 그래서 Claude Code는 메시지를 보낼 때마다 시스템 프롬프트, 프로젝트 컨텍스트, 지금까지의 모든 대화와 도구 결과 전체를 다시 전송합니다. 한 번의 턴(Turn) 안에서 Claude가 도구를 여러 번 사용하면 그때마다 또 한 번의 요청이 전송됩니다. 토큰 비용이 질문의 길이가 아니라 세션의 크기에 비례하는 이유입니다.
요청은 세 계층으로 이뤄지며, 잘 변하지 않는 내용일수록 앞에 옵니다.
계층
내용
바뀌는 시점
시스템 프롬프트
코어 지시, 도구 정의, 출력 스타일
도구 정의 집합이 바뀌거나 Claude Code 업그레이드 시
프로젝트 컨텍스트
CLAUDE.md, 자동 메모리, 스코프별 규칙
세션 시작, /clear 또는 /compact 이후
대화
사용자 메시지, 응답, 도구 결과
매 턴(Turn)
표 1. 요청을 구성하는 세 계층
이 반복 전송을 감당할 수 있게 해 주는 장치가 프롬프트 캐싱입니다. 직전 요청과 동일한 프리픽스(prefix)는 재처리하는 대신 캐시에서 읽어오고, 표준 입력 단가의 약 10%로 과금됩니다. 캐시를 새로 쓰는 비용은 표준보다 비싸지만 한 번뿐이고, 이후 턴은 그 프리픽스를 계속 낮은 단가로 재사용합니다. 표의 TTL(Time To Live)은 캐시가 유지되는 시간입니다.
처리 경로
상대 단가(표준 입력 = 1.0배)
캐시 쓰기(1시간 TTL)
2.0배
캐시 쓰기(5분 TTL)
1.25배
표준 입력
1.0배
캐시 읽기
약 0.1배
표 2. 처리 경로별 상대 단가. 캐시 쓰기 비용은 이후 턴의 할인을 얻기 위한 1회성 투자입니다
과금 방식은 접속 방법에 따라 달라집니다. 구독 플랜(Pro, Max, Team)은 달러 대신 사용량 한도를 소모하고, 이 한도는 5시간 롤링 윈도우와 주간 윈도우 단위로 관리됩니다. Claude Console의 API 및 Claude Enterprise와 Amazon Bedrock 같은 클라우드 프로바이더는 토큰 단위로 과금됩니다.
원칙은 하나입니다. 비용은 컨텍스트 크기에 비례하고, 실제로 지불하는 토큰 단가는 캐시 적중률이 정합니다. 이 글의 모든 전략은 이 두 가지 변수를 줄이는 방법입니다.
2