10.2 內建工具介紹

Claude Code 提供了豐富的內建工具集，涵蓋了檔案操作、搜尋、命令執行、專案管理等多個方面。這些工具可以幫助您高效完成各種開發任務，提高工作效率。

1. 文件操作工具

Read 工具

Read 工具用於讀取檔案內容，支援讀取整個檔案或特定範圍的行。

语法 :

bash


读取文件 [文件路径]

示例 :

bash


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

参数 :

• file_path: 檔案路徑（必需）
• limit: 讀取行數（可選，預設讀取整個檔案）
• offset: 起始行號（可選，預設從第 1 行開始）

返回结果 :

json


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

Write 工具

Write 工具用於寫入檔案內容，可以建立新檔案或覆蓋現有檔案。

语法 :

bash


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

示例 :

bash


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

注意 : Write 工具會覆蓋整個檔案內容。如果需要修改檔案的特定部分，請使用 Edit 工具。

参数 :

• file_path: 檔案路徑（必需）
• content: 檔案內容（必需）

Edit 工具

Edit 工具用於編輯檔案的特定部分，支援搜尋替換、插入、刪除等操作。

**语法** :

    bash


    编辑文件 [文件路径]

**示例** :

    bash


    修改函数签名: 将 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 工具用於刪除檔案或目錄。

**语法** :

    bash


    删除文件 [文件路径]

**示例** :

    bash


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


**注意** : 刪除操作不可逆，請謹慎使用。在刪除重要檔案前，建議先備份。

**参数** :


  * `file_path`: 檔案或目錄路徑（必需）

### Glob 工具

Glob 工具用於按模式查詢檔案，支援萬用字元匹配。

**语法** :

    bash


    查找文件 [模式]

**示例** :

    bash


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

**参数** :


  * `pattern`: 檔案匹配模式（必需）
  * `path`: 搜尋路徑（可選，預設當前目錄）

## 2\. 搜索工具

### Grep 工具

Grep 工具用於在檔案中搜尋文字模式，支援正規表示式。

语法 :

bash


搜索 [模式] [路径]

示例 :

bash


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

参数 :

• pattern: 搜尋模式（必需，支援正規表示式）
• path: 搜尋路徑（可選，預設當前目錄）
• glob: 檔案模式（可選，限制搜尋的檔案型別）
• -i: 忽略大小寫（可選）
• -v: 反向匹配（可選，顯示不匹配的行）

**返回结果** :

    json


    {
      "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 工具用於語義搜尋程式碼庫，查詢與查詢相關的程式碼片段。

语法 :

bash


搜索代码 [查询]

示例 :

bash


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

优势 :

• 語義理解 : 理解程式碼的含義，而不僅僅是文字匹配
• 跨檔案搜尋 : 搜尋整個程式碼庫
• 智慧推薦 : 提供相關的程式碼片段

参数 :

• query: 搜尋查詢（必需）
• limit: 返回結果數量（可選，預設 10）

Find 工具

Find 工具用於查詢檔案和目錄，支援複雜的搜尋條件。

语法 :

bash


查找 [条件]

示例 :

bash


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

参数 :

• size: 檔案大小條件（可選）
• mtime: 修改時間條件（可選）
• type: 檔案型別（可選，f 表示檔案，d 表示目錄）

3. 命令执行工具

Bash 工具

Bash 工具用於執行 shell 命令。

**语法** :

    bash


    执行命令 [命令]

**示例** :

    bash


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

**参数** :


  * `command`: 要執行的 shell 命令（必需）
  * `cwd`: 工作目錄（可選，預設當前目錄）

**返回结果** :

    json


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

### RunCommand 工具

RunCommand 工具用於執行特定命令或指令碼，提供更多的控制選項。

语法 :

bash


运行命令 [命令]

示例 :

bash


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

参数 :

• command: 要執行的命令（必需）
• env: 環境變數（可選）
• timeout: 超時時間（可選）

Background 工具

Background 工具用於在後臺執行命令，允許您繼續其他操作。

语法 :

bash


在后台运行 [命令]

示例 :

bash


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

参数 :

• command: 要在後臺執行的命令（必需）
• task_id: 任務 ID（可選，用於後續管理）

4. 项目管理工具

Git 工具

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

语法 :

bash


Git [操作]

示例 :

bash


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

参数 :

• operation: Git 操作（必需）

NPM 工具

NPM 工具用於執行 NPM 操作，如安裝、更新、構建等。

语法 :

bash


NPM [操作]

示例 :

bash


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

参数 :

• operation: NPM 操作（必需）

Docker 工具

Docker 工具用於執行 Docker 操作，如構建、執行、推送等。

**语法** :

    bash


    Docker [操作]

**示例** :

    bash


    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 的能力。

语法 :

bash


MCP [服务] [操作]

示例 :

bash


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

参数 :

• service: 要互動的服務（必需）
• operation: 要執行的操作（必需）

Plugins 工具

Plugins 工具用於載入和管理外掛，擴充套件 Claude 的功能。

语法 :

bash


插件 [操作]

示例 :

bash


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

参数 :

• operation: 外掛操作（必需）

Skills 工具

Skills 工具用於載入和使用技能，提供特定領域的專業知識。

语法 :

bash


技能 [名称]

示例 :

bash


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

参数 :

• name: 技能名稱（必需）

工具選擇指南

選擇合適的工具可以提高工作效率，以下是一些選擇建議：

1. 檔案操作 : 使用 Read、Write、Edit、Delete 工具
2. 文字搜尋 : 使用 Grep 工具
3. 程式碼搜尋 : 使用 SearchCodebase 工具
4. 命令執行 : 使用 Bash 或 RunCommand 工具
5. 後臺任務 : 使用 Background 工具
6. 專案管理 : 使用 Git、NPM、Docker 工具
7. 外部整合 : 使用 MCP 工具

透過熟練掌握這些內建工具，您可以充分發揮 Claude Code 的能力，高效完成各種開發任務。