工具系统

Claude Code 拥有 54 个内置工具，每个工具都有独立的目录、输入 Schema、执行逻辑和可选的 React 渲染组件。

工具系统概览

Tool 接口定义

每个工具都实现 Tool 接口（src/Tool.ts）：

interface Tool {
  name: string                        // 唯一标识 (如 "Bash", "Read")
  searchHint: string                  // 工具搜索描述
  description: string                 // 发送给模型的工具描述
  inputSchema: JSONSchema              // Zod 验证的 JSON Schema

  call(input, context): ToolResult   // 执行逻辑
  userFacingName(): string           // UI 显示名称
  getToolUseSummary(): string        // 活动描述

  isReadOnly(): boolean              // 只读操作？
  isConcurrencySafe(): boolean       // 线程安全？
  isEnabled(): boolean              // 运行时启用/禁用
  shouldDefer: boolean               // 延迟加载 (ToolSearch)

  maxResultSizeChars: number         // 结果截断阈值 (~100,000)

  // 可选：React 渲染组件
  renderResult?(result): JSX.Element
}
    

工具注册 & 条件加载

工具在 src/tools.ts 中注册，部分工具根据 feature flag 或环境条件有选择地加载：

// src/tools.ts — 工具组装
function assembleToolPool(): Tool[] {
  const tools = [
    // 始终可用
    AgentTool, BashTool, FileReadTool, FileEditTool, FileWriteTool,
    WebFetchTool, WebSearchTool, SkillTool, AskUserQuestionTool, ...

    // 条件加载
    ...(!hasEmbeddedSearchTools() ? [GlobTool, GrepTool] : []),
    ...(feature('AGENT_TRIGGERS') ? [CronCreateTool, ...] : []),
    ...(USER_TYPE === 'ant' ? [ConfigTool, REPLTool] : []),
    ...(isTodoV2Enabled() ? [TaskCreateTool, ...] : [TodoWriteTool]),
  ];
  return tools;
}
    

完整工具目录

条件加载矩阵

工具的加载受多种条件控制：