環境変数

ENABLE_TOOL_SEARCH

MCP ツール検索を制御する。未設定または true の場合、ツール検索をオフに保つケースを除き、MCP ツールを後回しにする。auto は定義がコンテキストウィンドウの 10% に達するとツール検索をオンにする。auto:N はカスタムしきい値を設定する(たとえば auto:5 で 5%)。false はすべてのツールを事前に読み込む。ゲートウェイがツール検索を拒否する場合は、Tool search through an LLM gateway を参照。

使い方・用途

  • MCP サーバーを多数登録してもコンテキストウィンドウの消費を抑えたい場合、ツール定義の読み込みを Claude が必要になるまで遅延させるために設定する。
  • LLM ゲートウェイ越しに利用していて、すべてのツール定義を毎ターン事前に読み込みたい場合、ENABLE_TOOL_SEARCH=false を設定してツール検索を無効にする。
  • 遅延可能なツール定義がコンテキストウィンドウの一定割合に達したときにだけツール検索を有効化したい場合、auto や auto:N を指定してしきい値を調整する。
英語原文(公式ドキュメントより)

Controls MCP tool search. Unset or true defers MCP tools, except in the cases that keep tool search off. auto turns tool search on once definitions reach 10% of the context window. auto:N sets a custom threshold, such as auto:5 for 5%. false loads all tools upfront. If a gateway rejects tool search, see Tool search through an LLM gateway

関連ドキュメント

関連する変更履歴

v2.1.300(1件)

Fixed
自動ツール検索(ENABLE_TOOL_SEARCH=auto)が会話の途中で、たとえば再開後の MCP サーバー再接続中などにオフになってしまう問題を修正した
英語原文を表示
Fixed automatic tool search (ENABLE_TOOL_SEARCH=auto) turning off part-way through a conversation, for example while MCP servers reconnect after a resume

v2.1.119(1件)

Changed
Vertex AI でのサポートされていないベータヘッダーエラーを避けるため、ツール検索をデフォルトで無効にしました(ENABLE_TOOL_SEARCH で有効化可能)。
英語原文を表示
Tool search is now disabled by default on Vertex AI to avoid an unsupported beta header error (opt in with ENABLE_TOOL_SEARCH)

関連ドキュメント

v2.1.72(1件)

Fixed
ANTHROPIC_BASE_URL 使用時でも ENABLE_TOOL_SEARCH が設定されていればツール検索が有効になるよう修正
英語原文を表示
Fixed tool search to activate even with ANTHROPIC_BASE_URL as long as ENABLE_TOOL_SEARCH is set.

変更後

カスタムプロキシやゲートウェイを経由するエンタープライズ環境でも、Claude Code の強力なツール検索機能を確実に利用できるようになります。

関連ドキュメント