other tools

除了 FileEditTool、BashTool 和 AgentTool，Claude Code 还包含多个重要工具。

代码理解工具

ReadCodeTool

智能代码阅读工具，支持 AST 解析：

// 小文件 (<10KB) - 返回完整内容
await readCode({ path: 'src/utils.ts' });

// 大文件 - 返回函数签名
await readCode({ path: 'src/large-file.ts' });
// 输出: function foo(), class Bar, const baz = ...

// 搜索特定符号
await readCode({
  path: 'src/components/',
  selector: 'Button',
});
// 输出: class Button 的完整实现

GetDiagnosticsTool

获取编译和类型错误：

await getDiagnostics({
  paths: ['src/main.ts', 'src/utils.ts'],
});

// 输出:
// src/main.ts:10:5 - error TS2304: Cannot find name 'foo'
// src/utils.ts:25:10 - warning: Unused variable 'bar'

SemanticRenameTool

语义重命名，自动更新所有引用：

await semanticRename({
  path: 'src/utils.ts',
  line: 10,
  character: 9,
  oldName: 'oldFunctionName',
  newName: 'newFunctionName',
});

// 自动更新:
// - 函数定义
// - 所有调用点
// - 导入语句

搜索工具

GrepSearchTool

正则表达式搜索：

await grepSearch({
  query: 'function\\s+\\w+',
  includePattern: '**/*.ts',
  excludePattern: 'node_modules/**',
});

FileSearchTool

模糊文件名搜索：

await fileSearch({
  query: 'utils',
  explanation: 'Find utility files',
});

// 输出:
// - src/utils.ts
// - src/lib/utils.ts
// - tests/utils.test.ts

文件系统工具

ListDirectoryTool

列出目录内容：

await listDirectory({
  path: 'src',
  depth: 2,  // 递归深度
});

SmartRelocateTool

移动文件并自动更新导入：

await smartRelocate({
  sourcePath: 'src/utils.ts',
  destinationPath: 'src/lib/utils.ts',
});

// 自动更新所有导入:
// import { foo } from './utils'
// → import { foo } from './lib/utils'

Web 工具

WebSearchTool

网络搜索：

await remote_web_search({
  query: 'React 19 new features',
});

// 返回搜索结果列表

WebFetchTool

获取网页内容：

await webFetch({
  url: 'https://react.dev/blog/2024/12/05/react-19',
  mode: 'truncated',  // 或 'full', 'selective'
});

扩展工具

CreateHookTool

创建自动化 Hook：

await createHook({
  id: 'lint-on-save',
  name: 'Lint on Save',
  description: 'Run linter when files are saved',
  eventType: 'fileEdited',
  hookAction: 'runCommand',
  command: 'npm run lint',
  filePatterns: '*.ts,*.tsx',
});

KiroPowersTool

管理 Powers（工具包）：

// 列出已安装的 Powers
await kiroPowers({ action: 'list' });

// 激活 Power
await kiroPowers({
  action: 'activate',
  powerName: 'weather-power',
});

// 使用 Power 中的工具
await kiroPowers({
  action: 'use',
  powerName: 'weather-power',
  serverName: 'weather-api',
  toolName: 'get_forecast',
  arguments: { location: 'Seattle' },
});

DiscloseContextTool

激活 Skills：

await discloseContext({
  name: 'frontend-design',
});

// 加载 frontend-design skill 的内容到 System Prompt

进程管理工具

ControlPwshProcessTool

管理后台进程：

// 启动后台进程
const result = await controlPwshProcess({
  action: 'start',
  command: 'npm run dev',
  cwd: 'project',
});

// 返回: { terminalId: 'abc123', isReused: false }

// 停止进程
await controlPwshProcess({
  action: 'stop',
  terminalId: 'abc123',
});

ListProcessesTool

列出所有后台进程：

await listProcesses();

// 输出:
// - terminalId: abc123, command: npm run dev, status: running
// - terminalId: def456, command: webpack --watch, status: running

GetProcessOutputTool

读取进程输出：

await getProcessOutput({
  terminalId: 'abc123',
  lines: 50,  // 最近 50 行
});

工具组合模式

Pipeline Pattern

// 读取 → 分析 → 修复
const code = await readCode({ path: 'src/main.ts' });
const diagnostics = await getDiagnostics({ paths: ['src/main.ts'] });
await strReplace({ path: 'src/main.ts', /* fix */ });

Fan-out Pattern

// 并行读取多个文件
const results = await Promise.all([
  readFile({ path: 'file1.ts' }),
  readFile({ path: 'file2.ts' }),
  readFile({ path: 'file3.ts' }),
]);

Delegate Pattern

// 委派给子 Agent
const result = await invokeSubAgent({
  name: 'context-gatherer',
  prompt: 'Find all authentication related files',
});

下一步

• 了解 流式工具执行

• 探索 MCP 集成 的外部工具

• 查看 Plugins 系统 的自定义工具