Tool Search 是 Claude Code 中用于动态发现和按需加载 MCP 工具的功能。当你配置了大量 MCP 服务器时，它不会一次性加载所有工具定义，而是让 Claude
  按需搜索并只加载实际需要的工具。

  解决什么问题？

  1. 上下文臃肿：多个 MCP 服务器（GitHub、Slack、Sentry 等）可能消耗约 55K token 的工具定义。Tool Search 可减少 85%+ 的开销。
  2. 工具选择准确性：工具超过 30-50 个时，Claude 选择正确工具的能力会下降。按需加载可保持高准确率。

  如何配置？

  自动模式（默认）：当 MCP 工具定义超过上下文的 10% 时自动启用。

  通过环境变量控制： 

 # 自动模式（默认）
  ENABLE_TOOL_SEARCH=auto claude

  # 自定义阈值（5%）
  ENABLE_TOOL_SEARCH=auto:5 claude

  # 始终启用
  ENABLE_TOOL_SEARCH=true claude

  # 禁用
  ENABLE_TOOL_SEARCH=false claude

  通过 settings.json 配置：

 {
    "env": {
      "ENABLE_TOOL_SEARCH": "auto:5"
    }
  }

  工作流程

  1. 添加多个 MCP 服务器：
  claude mcp add --transport http github https://api.githubcopilot.com/mcp/
  claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
  2. 工具定义超过阈值时自动激活
  3. Claude 需要时动态搜索并加载相关工具
  4. 对用户来说体验无缝，工具照常使用

  模型要求

  - 支持：Sonnet 4 及以上、Opus 4 及以上
  - 不支持：Haiku 模型

  禁用搜索工具本身

  {
    "permissions": {
      "deny": ["MCPSearch"]
    }
  }

  简单来说，如果你用了很多 MCP 服务器，Tool Search 会自动帮你优化，一般不需要手动干预。如果工具较少，它不会激活。