本章总览

工具系统是 Agent 的双手：51 个内置工具 + MCP 动态工具，统一实现 Tool 接口。本章教你看工具分类、并发规则、注册表如何组装 prompt。

总览图

渲染图表中…

学完本章你应该能

  • 理解 Tool 接口各字段含义
  • 按类别记忆主要工具（文件/Shell/Web/Agent）
  • 知道 concurrency-safe 与 exclusive 的差异

核心概念（先读懂这些）

tool_use 是 Claude API 的扩展点

模型输出 tool_use block → 运行时找同名 Tool → call() → 结果以 tool_result 回传。Claude Code 的价值很大程度在「默认工具集」的质量与权限设计。

为什么 Bash 和 Read 并发策略不同

Read/Grep 无副作用可并行；Bash/Edit 可能改系统状态，必须独占或串行。StreamingToolExecutor 用 isConcurrencySafe() 分流队列。

建议学习步骤

  1. 浏览分类表
  2. 选一个工具进 tool-* 详解页
  3. 对照 Tool.ts 接口定义

Tool 生命周期（类图）

渲染图表中…

工具池组装流程

渲染图表中…

工具分类（思维导图式）

渲染图表中…

概览

共 51 个工具目录。工具通过 Tool.ts 接口统一，tools.ts 的 getAllBaseTools() 按 feature flag 组装。

文件操作

工具目录文件行数
FileEdittools/FileEditTool61,818
FileReadtools/FileReadTool51,607
FileWritetools/FileWriteTool3859
Greptools/GrepTool3798
NotebookEdittools/NotebookEditTool4591
Globtools/GlobTool3270

Shell

工具目录文件行数
Bashtools/BashTool1812,429
PowerShelltools/PowerShellTool148,973
TerminalCapturetools/TerminalCaptureTool12

Agent/任务

工具目录文件行数
Agenttools/AgentTool206,802
TaskOutputtools/TaskOutputTool2586
TaskUpdatetools/TaskUpdateTool3487
TodoWritetools/TodoWriteTool3303
TaskCreatetools/TaskCreateTool3198
TaskStoptools/TaskStopTool3182
TaskListtools/TaskListTool3169
TaskGettools/TaskGetTool3156

Web

工具目录文件行数
WebFetchtools/WebFetchTool51,136
WebSearchtools/WebSearchTool3572
WebBrowsertools/WebBrowserTool14

计划模式

工具目录文件行数
ExitPlanModetools/ExitPlanModeTool4609
EnterPlanModetools/EnterPlanModeTool4333
VerifyPlanExecutiontools/VerifyPlanExecutionTool12

MCP

工具目录文件行数
MCPtools/MCPTool41,090
ToolSearchtools/ToolSearchTool3596
ReadMcpResourcetools/ReadMcpResourceTool3213
ListMcpResourcestools/ListMcpResourcesTool3174

Skill

工具目录文件行数
Skilltools/SkillTool41,481
DiscoverSkillstools/DiscoverSkillsTool12

Worktree

工具目录文件行数
ExitWorktreetools/ExitWorktreeTool4390
EnterWorktreetools/EnterWorktreeTool4181

Team/Swarm

工具目录文件行数
SendMessagetools/SendMessageTool41,001
TeamCreatetools/TeamCreateTool4363
TeamDeletetools/TeamDeleteTool4179

交互

工具目录文件行数
Configtools/ConfigTool5814
Brieftools/BriefTool5615
AskUserQuestiontools/AskUserQuestionTool2311

Tool 接口

interface Tool {
  name: string
  inputSchema: ToolInputJSONSchema
  call(input, context): Promise<ToolResult>
  isConcurrencySafe(): boolean
  isEnabled(): boolean
  permissionType: PermissionType
}

工具注册流程

getTools(permissionContext)
  → getAllBaseTools()        // 51 基础工具
  → filterToolsByDenyRules() // 权限 deny 过滤
  → assembleToolPool()       // 合并 MCP 工具
  → getMergedTools()         // 最终工具池

完整工具列表

#工具行数文件
1Bash12,42918
2PowerShell8,97314
3Agent6,80220
4LSP2,0116
5FileEdit1,8186
6FileRead1,6075
7Skill1,4814
8WebFetch1,1365
9MCP1,0904
10SendMessage1,0014
11FileWrite8593
12Config8145
13Grep7983
14Brief6155
15ExitPlanMode6094
16ToolSearch5963
17NotebookEdit5914
18TaskOutput5862
19WebSearch5723
20ScheduleCron5485
21TaskUpdate4873
22ExitWorktree3904
23TeamCreate3634
24EnterPlanMode3334
25AskUserQuestion3112
26TodoWrite3033
27Glob2703
28McpAuth2161
29ReadMcpResource2133
30TaskCreate1983
31RemoteTrigger1953
32TaskStop1823
33EnterWorktree1814
34TeamDelete1794
35ListMcpResources1743
36TaskList1693
37SyntheticOutput1641
38TaskGet1563
39REPL872
40Tungsten552
41Sleep181
42Workflow124
43WebBrowser41
44DiscoverSkills21
45Monitor21
46OverflowTest21
47ReviewArtifact21
48SendUserFile21
49Snip21
50TerminalCapture21
51VerifyPlanExecution21

Top 10 工具详解

  • Bash — 12,429 行 · Builds a command segment, stripping output redirections to avoid
  • PowerShell — 8,973 行 · PowerShell Constrained Language Mode allowed types.
  • Agent — 6,802 行 · 核心 Agent 工具
  • LSP — 2,011 行 · Formats a URI by converting it to a relative path if possible.
  • FileEdit — 1,818 行 · 核心 Agent 工具
  • FileRead — 1,607 行 · Resolves macOS screenshot paths that may have different space characters.
  • Skill — 1,481 行 · 核心 Agent 工具
  • WebFetch — 1,136 行 · 核心 Agent 工具
  • MCP — 1,090 行 · Classify an MCP tool as a search/read operation for UI collapsing.
  • SendMessage — 1,001 行 · 核心 Agent 工具

本章小结与延伸

工具 = 名称 + schema + call + 权限。加新能力就是加新 Tool。 继续学习：