README

Claude Code 的工具系统是其核心能力的基础，提供了类型安全、插件化的工具架构。

工具概览

Claude Code 内置 30+ 工具，分为以下类别：

文件操作

• readFile - 读取文件内容

• readMultipleFiles - 批量读取文件

• fsWrite - 创建或覆盖文件

• fsAppend - 追加内容到文件

• strReplace - 字符串替换编辑

• deleteFile - 删除文件

• smartRelocate - 移动/重命名文件（自动更新引用）

代码理解

• readCode - 读取代码结构（AST 解析）

• getDiagnostics - 获取编译/类型错误

• semanticRename - 语义重命名（自动更新引用）

• grepSearch - 正则搜索

• fileSearch - 文件名搜索

Shell 执行

• executePwsh - 执行 Shell 命令

• controlPwshProcess - 后台进程管理

• listProcesses - 列出后台进程

• getProcessOutput - 读取进程输出

Agent 协作

• invokeSubAgent - 调用子 Agent

• 内置 Agent: context-gatherer, custom-agent-creator

Web 访问

• remote_web_search - 网络搜索

• webFetch - 获取网页内容

其他

• listDirectory - 列出目录内容

• createHook - 创建自动化 Hook

• kiroPowers - Powers 管理

• discloseContext - 激活 Skills

工具接口设计

详细了解工具的设计和实现：

• 工具接口设计 - Tool 接口和类型系统

• FileEditTool - 文件编辑的实现细节

• BashTool - Shell 执行和权限检查

• AgentTool - 子 Agent 调用机制

• 其他核心工具 - 其他重要工具的实现

工具执行流程

工具调用请求
  ↓
参数验证 (Zod Schema)
  ↓
权限检查 (preToolUse hooks)
  ↓
工具执行 (Tool.execute)
  ↓
结果处理 (postToolUse hooks)
  ↓
返回结果

扩展机制

工具系统支持多种扩展方式：

1. 自定义工具 - 实现 Tool 接口

2. MCP 工具 - 通过 MCP 协议集成外部工具

3. Plugin 工具 - 通过 Plugin 系统添加工具

4. Composite 工具 - 组合现有工具创建新工具

下一步

• 了解 工具接口设计

• 深入 FileEditTool 实现

• 探索 BashTool 的权限机制