# Claude Agent SDKの便利で実践的な使い方
🔍 数百〜数千のツールを効率的に管理し、必要なツールだけオンデマンドでロードできます。
ツール検索は、大量のツールをコンテキストに事前ロードする代わりに、必要なツールだけを実行時に検索・ロードする機能です。
📌 タイトル:多くのツールにスケーリングするツール検索
🔗 URL:
🧩 概要
`ENABLE_TOOL_SEARCH=auto` でツール定義がコンテキストを圧迫する場合に自動的にツール検索を有効化します。50ツールで10〜20Kトークン消費、30〜50ツール超で選択精度が低下する問題を解決します。
🛠 使い方
```bash
export ENABLE_TOOL_SEARCH=auto:5 # コンテキストの5%超で有効化
```
🏗 実践的な使い方
・エンタープライズ MCP サーバー(数百ツール)接続時に、必要なツールだけオンデマンド検索してコンテキスト圧迫を防ぎます。
・`auto:5` で「ツール定義がコンテキストの5%超ならツール検索を有効化」と自動判定。小規模(10ツール未満)なら `false` で事前ロードの方が高速です。
・ツール説明に「キーワード、チャネル、日付範囲で Slack メッセージを検索」のような具体的キーワードを入れ、検索ヒット率を向上させます。
💡 ユースケース
🏢 大規模 MCP サーバーのツール管理
💰 トークンコストの最適化
🎯 ツール選択精度の維持
⚠️ 注意点
Claude Sonnet 4 / Opus 4 以降が必要です(Haiku 非対応)。カタログ上限1万ツール、検索ごとに3〜5ツール返却。Vertex AI とサードパーティ `ANTHROPIC_BASE_URL` ではデフォルト無効です。
#
ClaudeAgentSDK# #
AI#