◉CLAUDE LABEN
●CC 2.1.330 — Claude Code 2.1.330 で、長い会話を圧縮した直後に数分固まる問題が直りました●SONNET 4.5 — Claude API の Sonnet 4.5 は 11/30 で提供終了、残り8日です。推奨の移行先は claude-sonnet-5-5 です●MCP 401 — MCP サーバーが 401 を返しても、エラーにならず無言でタイムアウトする、という報告が出ています●NEW — 新着:Desktop が毎回 worktree を作るとき、確かめる3か所●OPUS 4.5 — Opus 4.5 の 11/24 は「これより前には廃止しない」下限日で、廃止の告知ではありません●SCHEMA — Agent SDK と Messages API の構造化出力は、同じスキーマでも返り値の形を一度見比べると安心です●CC 2.1.330 — Claude Code 2.1.330 で、長い会話を圧縮した直後に数分固まる問題が直りました●SONNET 4.5 — Claude API の Sonnet 4.5 は 11/30 で提供終了、残り8日です。推奨の移行先は claude-sonnet-5-5 です●MCP 401 — MCP サーバーが 401 を返しても、エラーにならず無言でタイムアウトする、という報告が出ています●NEW — 新着:Desktop が毎回 worktree を作るとき、確かめる3か所●OPUS 4.5 — Opus 4.5 の 11/24 は「これより前には廃止しない」下限日で、廃止の告知ではありません●SCHEMA — Agent SDK と Messages API の構造化出力は、同じスキーマでも返り値の形を一度見比べると安心です
記事一覧/API & SDK
⬡ API & SDK/2026-03-19上級

Claude API 高度なツール使用:Tool Search・Programmatic Tool Calling・Tool Use Examples で大規模エージェントを構築する

Claude API の Tool Search Tool・Programmatic Tool Calling・Tool Use Examples を、ベータヘッダーの指定から実装まで通しでまとめました。Anthropic が公表した削減率の読み方と、この3機能を使わない方がよい場面も併せて記録しています。

Claude API148tool use5function callingprogrammatic tool callingtool searchエージェント14本番環境5

✦ プレミアム記事

なぜ高度なツール使用が必要なのか

Claude API でエージェントを構築していると、ツールの数が増えるにつれて深刻な問題が発生します。100個のツール定義をすべてプロンプトに含めると、それだけで 55,000トークン以上を消費してしまいます。1リクエストあたりのコストが跳ね上がり、レスポンス速度も遅くなります。これは大規模なエージェントシステムにとって致命的な欠点です。

Anthropic が 2025年11月24日に公開した3つのツール使用機能が、この問題に正面から答えています。

  1. Tool Search Tool — ツールを動的に検索・ロードし、初期コンテキストからツール定義を追い出す
  2. Programmatic Tool Calling — Python コードでツールをオーケストレーションし、中間結果をコンテキスト外に保持する
  3. Tool Use Examples — ツール定義に入力例を添え、スキーマだけでは伝わらない使い方の作法を示す

いずれも本記事執筆時点(2026年8月)でベータ提供です。ベータヘッダーの指定が必須で、ここを落とすと defer_loading も allowed_callers も input_examples も、そもそも受け付けられません。最初につまずくのは、たいていこの一行です。

以下では3機能を組み合わせた実装を、動くコードとともに示します。あわせて、Anthropic が公表している削減率が「何を測った数字なのか」も切り分けておきます。ここを取り違えたまま見積もりを立てると、期待していた効果と実測がずれます。

対象読者は、Claude API の基本的なツール使用(入門ガイド)をすでに理解している中〜上級のエンジニアです。


公表されている数字が、それぞれ何を測ったものか

この3機能を紹介する記事では「85%削減」「37%削減」「72%→90%」という数字が並びます。私も最初は全部まとめて「速くなる」と受け取っていました。ところが実際に組んでみると、期待した箇所が縮まない。数字の出どころを読み直して、ようやく取り違えに気づきました。

いずれも Anthropic が Introducing advanced tool use on the Claude Developer Platform で公表した社内計測値です。測っている対象は、機能ごとにまるで違います。

数字機能実際に測っているもの
85%削減Tool Search Tool初期コンテキストのトークン量。50以上の MCP ツールで約77Kトークンだった消費が、約8.7Kトークンになった比較
37%削減Programmatic Tool Callingトークン量。複雑なリサーチタスクの平均で 43,588 → 27,297 トークン
72%→90%Tool Use Examples複雑なパラメータ処理の正確性。ネストした入力を持つツールでの社内評価

ここで一番間違えやすいのが 37% です。これはレイテンシではなく、トークンの削減率です。Programmatic Tool Calling のレイテンシについて Anthropic が述べているのは、「20回以上のツール呼び出しを1つのコードブロックにまとめると、19回以上の推論パスがなくなる」という別の説明です。往復が減るぶん結果として速くはなりますが、「37%速くなる」と読むのは誤りです。

私はこの取り違えのまま、自分の環境で応答時間を計って「37%も縮まないではないか」と首をひねっていました。縮んでいたのはトークンの方で、そちらは実際に相応の削減が出ていたのです。測る対象を間違えると、効いている改善まで見落とします。

精度についても補助線を引いておきます。Tool Search Tool を有効にした MCP 評価では、Opus 4 が 49% から 74%、Opus 4.5 が 79.5% から 88.1% へ改善したと報告されています。トークンが減るだけでなく、候補が絞られることで選択ミスそのものが減るという筋です。似た名前のツールが並ぶカタログでは、こちらの効果の方が体感に近いかもしれません。

そのうえで前提を一つ。これらは Anthropic の社内テスト環境での数字であり、ツールカタログの構成にも作業内容にも強く依存します。自分の環境で見積もりを立てるときは、比率をそのまま当てはめるのではなく、「現在ツール定義に何トークン払っているか」を先に測る方が確実です。usage.input_tokens をツールなし・ツールありで一度ずつ取れば、その差が削減の上限になります。


✦

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
✦defer_loading・allowed_callers・input_examples を実際に通すための beta ヘッダー指定と、指定を忘れたときに何が起きるかが分かる
✦Anthropic が公表した「85%削減」「37%削減」「72%→90%」が何を測った数字なのかを切り分けられるようになり、自分の環境に当てはめる前提を誤らない
✦3機能それぞれについて、導入して割に合う条件と、入れない方が速い条件を判断できる
Stripe による安全な決済 · いつでもキャンセル可能
✦

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Claude Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

⬡ API & SDK2026-03-28
Claude API 音声エージェント本番アーキテクチャ構築ガイド
Whisper/DeepgramとClaude APIを束ねた音声エージェントを、Cloudflare WorkersとGoogle Cloud Runの両方で運用してきた個人開発者の実体験から、レイテンシ予算・コスト逆算・障害切り替え・本番監視の判断材料を整理しました。
⬡ API & SDK2026-09-02
thinking ブロックを弾く 400 が出たとき、会話履歴のどこが書き換わっていたか
Claude Fable 5.1 から、thinking ブロックより前の system・tools・messages を書き換えたリクエストが 400 で弾かれるようになりました。自分のエージェントループが該当するかを1リクエストで確かめる手順と、system の組み立て直し・履歴の切り詰めを書き換えなしのやり方へ移す実装をまとめます。
⬡ API & SDK2026-11-18
Linked billing で顧客に払ってもらう前に — 402 と 403 が返ったとき、どの財布が空なのかを見分ける
11月17日にベータ公開された Claude API の Linked billing では、リクエストごとに billing_policy で支払元を選べます。顧客に請求したリクエストが 402 や 403 で拒まれたとき、どの財布が原因かを切り分け、自分の負担で返すかを決める手順と、Python のラッパーをまとめました。