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