10.2 内置工具介绍

约 1661 字大约 6 分钟

Claude Code 提供了丰富的内置工具集，涵盖了文件操作、搜索、命令执行、项目管理等多个方面。这些工具可以帮助您高效完成各种开发任务，提高工作效率。

1. 文件操作工具

Read 工具

Read 工具用于读取文件内容，支持读取整个文件或特定范围的行。

读取文件 [文件路径]

读取 package.json
读取 src/components/Header.tsx
读取 src/utils.js 从第 10 行开始的 20 行

file_path: 文件路径（必需）
limit: 读取行数（可选，默认读取整个文件）
offset: 起始行号（可选，默认从第 1 行开始）

{
  "file_path": "package.json",
  "content": "{\"name\": \"my-project\", \"version\": \"1.0.0\"}",
  "line_count": 10
}

Write 工具

Write 工具用于写入文件内容，可以创建新文件或覆盖现有文件。

写入文件 [文件路径] [内容]

创建一个新的组件文件: src/components/Button.tsx
更新 README.md: # My Project\n\nThis is my project.

注意: Write 工具会覆盖整个文件内容。如果需要修改文件的特定部分，请使用 Edit 工具。

file_path: 文件路径（必需）
content: 文件内容（必需）

Edit 工具

Edit 工具用于编辑文件的特定部分，支持搜索替换、插入、删除等操作。

编辑文件 [文件路径]

修改函数签名: 将 function add(a, b) 改为 function add(a: number, b: number): number
更新导入语句: 将 import React from 'react' 改为 import * as React from 'react'

精确修改: 只修改目标部分，保留文件其他内容
安全: 减少意外更改整个文件的风险
高效: 无需手动查找和替换
file_path: 文件路径（必需）
old_str: 要替换的旧内容（必需）
new_str: 替换后的新内容（必需）

Delete 工具

Delete 工具用于删除文件或目录。

删除文件 [文件路径]

删除旧的配置文件: .env.old
清理临时文件: tmp/*.log

注意: 删除操作不可逆，请谨慎使用。在删除重要文件前，建议先备份。

file_path: 文件或目录路径（必需）

Glob 工具

Glob 工具用于按模式查找文件，支持通配符匹配。

查找文件 [模式]

查找所有 JavaScript 文件: *.js
查找所有测试文件: **/*.test.js

pattern: 文件匹配模式（必需）
path: 搜索路径（可选，默认当前目录）

2. 搜索工具

Grep 工具

Grep 工具用于在文件中搜索文本模式，支持正则表达式。

搜索 [模式] [路径]

搜索所有 TODO 注释: TODO
查找包含 "error" 的文件: error
搜索特定函数调用: functionName\(\)

pattern: 搜索模式（必需，支持正则表达式）
path: 搜索路径（可选，默认当前目录）
glob: 文件模式（可选，限制搜索的文件类型）
-i: 忽略大小写（可选）
-v: 反向匹配（可选，显示不匹配的行）

{
  "matches": [
    {
      "file_path": "src/App.js",
      "line_number": 42,
      "line_content": "// TODO: Add error handling"
    },
    {
      "file_path": "src/utils.js",
      "line_number": 100,
      "line_content": "// TODO: Optimize performance"
    }
  ]
}

SearchCodebase 工具

SearchCodebase 工具用于语义搜索代码库，查找与查询相关的代码片段。

搜索代码 [查询]

搜索代码: 处理用户认证的函数
搜索代码: 实现数据缓存的逻辑

语义理解: 理解代码的含义，而不仅仅是文本匹配
跨文件搜索: 搜索整个代码库
智能推荐: 提供相关的代码片段
query: 搜索查询（必需）
limit: 返回结果数量（可选，默认 10）

Find 工具

Find 工具用于查找文件和目录，支持复杂的搜索条件。

查找 [条件]

查找所有大于 1MB 的文件
查找最近 7 天修改的文件

size: 文件大小条件（可选）
mtime: 修改时间条件（可选）
type: 文件类型（可选，f 表示文件，d 表示目录）

3. 命令执行工具

Bash 工具

Bash 工具用于执行 shell 命令。

执行命令 [命令]

执行命令: npm install
执行命令: git status
执行命令: ls -la

command: 要执行的 shell 命令（必需）
cwd: 工作目录（可选，默认当前目录）

{
  "command": "npm install",
  "exit_code": 0,
  "output": "added 1423 packages in 2m",
  "error": ""
}

RunCommand 工具

RunCommand 工具用于运行特定命令或脚本，提供更多的控制选项。

运行命令 [命令]

运行命令: python script.py
运行命令: ./build.sh

command: 要运行的命令（必需）
env: 环境变量（可选）
timeout: 超时时间（可选）

Background 工具

Background 工具用于在后台运行命令，允许您继续其他操作。

在后台运行 [命令]

在后台运行: npm run dev
在后台运行: webpack --watch

command: 要在后台运行的命令（必需）
task_id: 任务 ID（可选，用于后续管理）

4. 项目管理工具

Git 工具

Git 工具用于执行 Git 操作，如提交、推送、拉取等。

Git [操作]

Git 提交: git commit -m "Add new feature"
Git 推送: git push origin main
Git 拉取: git pull origin main

operation: Git 操作（必需）

NPM 工具

NPM 工具用于执行 NPM 操作，如安装、更新、构建等。

NPM [操作]

NPM 安装: npm install react
NPM 更新: npm update
NPM 构建: npm run build

operation: NPM 操作（必需）

Docker 工具

Docker 工具用于执行 Docker 操作，如构建、运行、推送等。

Docker [操作]

Docker 构建: docker build -t my-image .
Docker 运行: docker run -p 8080:80 my-image
Docker 推送: docker push my-image

operation: Docker 操作（必需）

5. 集成工具

MCP 工具

MCP（模型上下文协议）工具用于与外部服务交互，扩展 Claude 的能力。

MCP [服务] [操作]

MCP 数据库 查询: SELECT * FROM users
MCP API 调用: GET /api/data

service: 要交互的服务（必需）
operation: 要执行的操作（必需）

Plugins 工具

Plugins 工具用于加载和管理插件，扩展 Claude 的功能。

插件 [操作]

插件 安装: my-plugin
插件 启用: my-plugin
插件 禁用: my-plugin

operation: 插件操作（必需）

Skills 工具

Skills 工具用于加载和使用技能，提供特定领域的专业知识。

技能 [名称]

技能 前端开发
技能 数据分析
技能 机器学习

name: 技能名称（必需）

工具选择指南

选择合适的工具可以提高工作效率，以下是一些选择建议：

文件操作: 使用 Read、Write、Edit、Delete 工具
文本搜索: 使用 Grep 工具
代码搜索: 使用 SearchCodebase 工具
命令执行: 使用 Bash 或 RunCommand 工具
后台任务: 使用 Background 工具
项目管理: 使用 Git、NPM、Docker 工具
外部集成: 使用 MCP 工具

通过熟练掌握这些内置工具，您可以充分发挥 Claude Code 的能力，高效完成各种开发任务。