클로드 API에서 도구를 하나라도 선언하면 요청마다 도구용 시스템 프롬프트 토큰이 입력에 더해집니다. 크기는 모델과 tool_choice에 따라 Opus 5의 286토큰부터 Opus 4.7의 804토큰까지 갈립니다. 여기에 도구 정의와 tool_use·tool_result 블록의 토큰이 따로 붙습니다. 클로드 플랫폼 공식 요금 문서를 2026-09-05에 확인한 기준입니다.
이 글의 요금·조건은 2026년 9월 5일에 각 서비스 공식 페이지에서 확인한 값입니다. 이후 변경됐을 수 있습니다.
도구 요청의 요금은 세 갈래다
공식 요금 문서는 도구 사용 요청의 요금이 세 가지로 정해진다고 적습니다. 모델에 보내는 입력 토큰 전체(tools 파라미터 포함), 생성된 출력 토큰, 그리고 서버 도구의 경우 사용량 기반 추가 요금입니다. 클라이언트 쪽 도구는 다른 API 요청과 같은 방식으로 청구되고, 서버 도구만 웹 검색처럼 횟수당 요금이 붙을 수 있습니다.
추가 토큰은 어디서 오나
도구를 쓰면 보통 요청보다 토큰이 늘어나는 자리가 셋입니다. 요청의 tools 파라미터(도구 이름·설명·스키마), 요청과 응답의 tool_use 콘텐츠 블록, 요청의 tool_result 콘텐츠 블록입니다. 도구 정의가 길고 왕복이 많을수록 이 세 자리의 토큰이 늘어납니다.
시스템 프롬프트 토큰은 모델마다 다르다
도구를 쓰면 API가 도구 사용을 위한 특별 시스템 프롬프트를 자동으로 넣습니다. 문서는 그 토큰 수를 모델별·tool_choice별로 표로 적습니다. 표는 도구가 하나 이상 있다는 전제이고, 도구가 없으면서 tool_choice가 none이면 추가 시스템 프롬프트 토큰은 0입니다.
| 모델 | auto·none | any·tool |
|---|---|---|
| Claude Opus 5 | 286 | 406 |
| Claude Opus 4.8 | 290 | 410 |
| Claude Opus 4.7 | 675 | 804 |
| Claude Opus 4.6 | 497 | 589 |
| Claude Sonnet 5 | 354 | 474 |
| Claude Sonnet 4.6 | 497 | 589 |
| Claude Haiku 4.5 | 496 | 588 |
같은 세대라도 값이 다릅니다. Opus 4.7이 675토큰인데 Opus 4.8은 290토큰으로 줄었고, Opus 5는 286토큰입니다. 도구를 강제하는 any나 tool은 auto보다 92~129토큰 더 듭니다.
요청당 몇 백 토큰이 누적된다
이 토큰은 요청마다 붙습니다. 하루 1만 건을 보내는 서비스가 Opus 4.7에서 auto로 도구를 쓰면 시스템 프롬프트 토큰만 하루 675만 토큰입니다. 같은 조건에서 Opus 5는 286만 토큰입니다. 입력 단가를 곱하면 모델 선택만으로 이 항목의 비용이 두 배 넘게 갈립니다. 단가 표는 앤트로픽 클로드 API 모델별 요금표에 있습니다.
다음에 확인할 것
도구를 쓰는 요청의 응답 사용량에서 입력 토큰이 프롬프트 길이보다 얼마나 큰지 보십시오. tool_choice를 any에서 auto로 바꿀 수 있는 자리가 있는지도 확인하십시오.