TOKENSE.

TOKENSE / ブログ / Claude APIのWeb検索ツールの課金の仕組み。1,000件あたり$10+トークン代

使い方

Claude APIのWeb検索ツールの課金の仕組み。1,000件あたり$10+トークン代

公開日: 2026-08-05 ・ TOKENSE Blog

Claude APIにWeb検索ツールを組み込むと、通常のトークン課金とは別に検索の実行回数に応じた追加費用が発生します。公式ドキュメントに書かれている課金の仕組みと、意図せず費用がかさむポイントをまとめました。
この記事の内容
  1. Web検索ツールの追加費用
  2. 何が「1回の検索」としてカウントされるか
  3. 検索結果のトークン代も別途かかる
  4. 似た機能「Web取得ツール」は追加費用なし
  5. 意図せず費用がかさむポイント
  6. よくある質問

1. Web検索ツールの追加費用

Anthropic公式ドキュメントには、Web検索ツールの料金について次のように明記されています(2026-08-05取得)。

Web検索の追加費用検索1,000回あたり $10(+検索結果として取得したコンテンツぶんの通常トークン課金)

出典:Anthropic公式「Pricing」(2026-08-05取得)「Web search is available on the Claude API for $10 per 1,000 searches, plus standard token costs for search-generated content.」

つまりWeb検索ツールを有効にすると、「検索の実行回数に応じた費用」「検索結果を読み込むためのトークン費用」の2つが上乗せされる仕組みです。TOKENSEのようなチャットで単にモデルと会話するだけの使い方では発生しない費用のため、Web検索機能を使う予定がなければ意識する必要はありません。

2. 何が「1回の検索」としてカウントされるか

公式ドキュメントには「Each web search counts as one use, regardless of the number of results returned.」と明記されています。つまり、1回の検索リクエストで何件のページがヒットしても、課金は「1回」でカウントされます。一方で、1つの会話の中でモデルが複数回検索を実行すれば(最初の検索結果を見て、さらに別のキーワードで検索し直す、など)、その分だけ検索回数がカウントされていきます。

また「If an error occurs during web search, the web search will not be billed.」ともあり、検索中にエラーが発生した場合は課金対象外という記載もあります。

3. 検索結果のトークン代も別途かかる

検索結果として取得したWebページの内容は、会話の文脈に組み込まれるため、通常の入力トークンとして別途課金されます。公式ドキュメントの目安では、平均的なWebページ(10KB程度)でおよそ2,500トークン、大きめのドキュメントページ(100KB程度)でおよそ25,000トークンという例が示されています(この目安は近い機能である「Web取得ツール」のドキュメントに記載のものです)。

つまり、Web検索を1回使うだけでも「$10/1,000回」の検索費用に加えて、ヒットしたページの内容ぶんの入力トークン費用が上乗せされます。長い記事や大きなドキュメントが検索結果に含まれるほど、トークン費用のほうが検索費用より大きくなることもあります。

4. 似た機能「Web取得ツール」は追加費用なし

Anthropic公式ドキュメントには、指定したURLの内容を取得する「Web fetch(取得)ツール」について「The web fetch tool is available on the Claude API at no additional cost. You only pay standard token costs for the fetched content.」と明記されています。こちらは検索1回あたりの追加費用($10/1,000回)は発生せず、取得したコンテンツぶんの通常トークン費用のみです。「候補を探す(検索)」と「決まったURLの中身を読む(取得)」は別機能で、課金体系も異なる点に注意してください。

5. 意図せず費用がかさむポイント

Web検索ツールを使う開発者向けの機能を組み込む場合は、検索回数と取得コンテンツのサイズの両方を意識しておくと、想定外の高額請求を避けやすくなります。

よくある質問

よくある質問

Q. TOKENSEを使うだけでWeb検索の費用が発生しますか?
A. TOKENSEは基本的にモデルとの対話に対するトークン課金のみです。Web検索ツールは開発者がAPI側で明示的に組み込む機能のため、通常のチャット利用だけでは発生しません。
Q. 検索結果が0件でも課金されますか?
A. 公式ドキュメントには「結果の件数によらず1回の検索として課金される」と明記されています。検索を実行した時点で1回とカウントされ、ヒット件数の多寡では変わりません。
Q. Web検索とWeb取得(fetch)はどちらが安いですか?
A. 用途が異なります。決まったURLの中身だけを読みたいなら追加費用のないWeb取得ツールで十分ですが、検索してURLを探す必要がある場合はWeb検索ツール($10/1,000回+トークン代)が必要です。
Q. 料金は今後変わりますか?
A. 本記事の金額は2026-08-05時点でAnthropic公式ページに掲載されている内容です。機能・料金は変更される可能性があるため、最新情報は必ず公式ページでご確認ください。

TOKENSEは登録不要・無料で使えます

自分のAnthropic APIキーを貼るだけで、コスト計測型のClaudeクライアントとして今すぐ使えます。アカウント登録もサーバーもありません。

あわせて読みたい

Claude APIの料金の計算方法。1質問あたりの実費を出す計算式 長い会話でAI APIの料金が高くなる理由と対処法