클로드 웹 페치 요금 — 추가 요금 없이 토큰만 계산

클로드 API의 웹 페치 도구는 추가 요금이 없습니다. 가져온 페이지 내용이 대화 문맥에 들어가면서 생기는 표준 입력 토큰 값만 냅니다. 같은 서버 도구인 웹 검색이 1,000회당 10달러를 따로 받는 것과 갈리는 지점입니다. 클로드 플랫폼 공식 요금 문서를 2026-09-05에 확인한 기준입니다.

이 글의 요금·조건은 2026년 9월 5일에 각 서비스 공식 페이지에서 확인한 값입니다. 이후 변경됐을 수 있습니다.

웹 페치는 도구 요금이 0이다

공식 요금 문서는 웹 페치 사용에 표준 토큰 비용 외의 추가 요금이 없다고 적습니다. 응답의 사용량 항목에는 web_fetch_requests가 1로 잡히지만, 그 횟수에 붙는 단가는 없습니다. 내는 것은 가져온 내용이 문맥에 포함되면서 늘어난 입력 토큰뿐입니다.

문서가 예로 든 사용량은 입력 25,039토큰, 출력 931토큰에 웹 페치 1회입니다. 여기서 청구되는 항목은 입력과 출력 토큰 두 줄이고, 페치 횟수 줄은 청구 항목이 아닙니다.

웹 검색은 횟수당 요금이 따로 있다

같은 문서에서 웹 검색은 1,000회당 10달러에 검색으로 생긴 내용의 표준 토큰 비용을 더한 값입니다. 검색 한 번은 결과 개수와 무관하게 1회로 세고, 검색 중 오류가 나면 청구되지 않습니다. 검색 결과는 그 턴과 이후 턴에서 입력 토큰으로 계속 세어집니다.

웹 검색 요금의 계산 예는 AI 웹 검색 API 요금에 있습니다. 이 글은 페치 쪽만 다룹니다.

비용은 페이지 크기에서 나온다

도구 요금이 없으니 비용을 가르는 것은 가져온 페이지의 크기입니다. 문서는 콘텐츠 종류별 토큰 예시를 세 가지 적습니다.

500kB짜리 PDF 한 장이 12만 5천 토큰이면, 입력 단가가 100만 토큰당 5달러인 모델에서 페치 한 번에 0.6달러가 넘습니다. 페이지 하나가 아니라 대화가 이어지는 동안 그 내용이 매 턴 입력에 실린다는 점까지 계산에 넣어야 합니다.

max_content_tokens로 상한을 건다

문서는 큰 콘텐츠를 뜻하지 않게 가져와 토큰을 과하게 쓰는 일을 막으려면 max_content_tokens 파라미터로 상한을 두라고 안내합니다. 용도와 예산에 맞춰 값을 정하라는 문구이며, 문서가 권장 숫자를 정해 주지는 않습니다. 페치한 내용이 문맥에 남는 구조이므로 상한은 한 번의 비용이 아니라 대화 전체의 비용을 줄입니다.

코드 실행과 같이 쓰면 그쪽도 무료다

같은 문서에 따르면 웹 페치(web_fetch_20260209 이후 버전)나 웹 검색을 요청에 포함하면 코드 실행 도구 호출에도 추가 요금이 없습니다. 코드 실행 요금의 조건은 클로드 코드 실행 요금에 정리했습니다.

다음에 확인할 것

페치를 쓰는 코드가 있으면 응답 사용량의 입력 토큰이 페치 전후로 얼마나 뛰는지 보고, max_content_tokens를 그 값에 맞춰 넣으십시오.