Claude Code 的工具按需加载
内容提要
Claude Code 采用懒加载机制优化工具使用，减少不必要的 token 消耗。通过延迟加载不常用工具，用户仅在需要时加载完整工具定义，从而节省资源。工具分为常驻和延迟两类，使用 ToolSearch 进行查询，确保对话中只发送必要的工具，提升效率。
延伸解读
懒加载机制的优势
Claude Code 的懒加载机制通过按需加载工具，显著降低了 token 消耗。这种方法使得用户在使用时只需加载必要的工具定义，避免了不必要的资源浪费，尤其在处理大量工具时，能够有效提升系统的整体效率。
工具分类与使用场景
Claude Code 将工具分为常驻工具和延迟工具，前者在每次请求中都发送完整定义，后者则仅在需要时加载。这种分类使得高频使用的工具始终可用，而不常用的工具则可以根据实际需求动态加载，优化了用户体验。
ToolSearch 的重要性
ToolSearch 是延迟加载的核心，支持精确选择和关键词搜索。用户可以通过它快速找到所需工具，确保在对话中只发送必要的工具子集，从而提高了交互的效率和准确性。
延迟加载的潜在风险
尽管延迟加载机制带来了显著的资源节省，但也可能导致在某些情况下工具的可用性延迟，尤其是在工具首次被调用时。用户需注意这一点，以避免在关键时刻无法及时获取所需工具。
Q&A
Claude Code 的懒加载机制是如何工作的？
Claude Code 通过延迟加载不常用工具，仅在需要时加载完整工具定义，从而减少 token 消耗。
Claude Code 中的工具分为哪两类？
工具分为常驻工具和延迟工具，常驻工具每次请求发送完整 schema，延迟工具仅发送名称。
ToolSearch 在 Claude Code 中的作用是什么？
ToolSearch 是延迟加载的核心工具，支持精确选择和关键词搜索，帮助用户发现所需工具。
如何控制延迟加载的行为？
延迟加载的行为由 ENABLE_TOOL_SEARCH 环境变量控制，支持总是延迟、自动和从不延迟三种模式。
延迟加载机制对 token 消耗有什么影响？
延迟加载机制有效节省了 token 消耗，提高了系统的效率，减少了不必要的开销。
MCP 工具在 Claude Code 中的处理方式是什么？
MCP 工具默认延迟加载，但可以通过设置免除延迟，确保关键工具在第一轮就可用。
