加载中

使用 Claude Code 进行构建

第 13 课5 分钟
加载中

使用 Claude Code 进行构建

手动编写调用 Claude API 的代码当然可行,但还有一条更快的路径:让 Claude 为您编写代码。在本课中,我们将使用 Claude Code 从一个已搭好框架的文件中补全一个 API 集成——使用您在本课程中学到的相同基本要素。

从一个框架文件开始

这个项目很简单:一个用于获取天气的 TypeScript 文件。它包含两个待补全的部分:

  • getWeather —— 接受一个城市名称,返回温度和天气状况。
  • run —— 一个应该使用工具运行器(tool runner)和 Claude TypeScript SDK 的函数。

工具运行器是为您处理工具调用和代理循环(agent loop)的部分,因此您不必手动搭建这些逻辑。

Claude API 技能

Claude Code 内置了一个名为 Claude API 的技能。您可以直接使用 /claude-api 调用它,或者当 Claude Code 检测到您正在使用 TypeScript SDK 时,它会自动调用该技能。

一条提示,即可得到可运行的代码

在终端中打开项目文件夹并启动 Claude Code。

接下来,只需一条提示即可完成任务。一条好的提示需要做到三件事:

  • 指明要修改的文件。
  • 指明要使用的模式。
  • 指明您期望的最终状态。

随后,Claude Code 会根据类型定义补全 getWeather 和 run,在文件末尾追加一次调用,执行该脚本,并报告输出结果。如果出现错误,它会读取错误信息并就地修复代码。

Claude Code 在终端中读取 weather.ts 和工具运行器文件,接收提示后的情况

Claude Code 生成的内容

在这次运行中,Claude Code 创建了一个Zod 工具,该工具解析输入,并根据城市类型返回输出。它还创建了我们所要求的工具运行器和 run 函数,并打印出了代理循环的最终结果。

Claude Code 在终端中生成天气代码,可见 betaZodTool 的导入语句和硬编码的城市数据

需要记住的模式

您针对 Claude API 编写的大部分代码都遵循一个熟悉的结构:

  1. 定义一个工具。
  2. 将其交给一个运行器。
  3. 返回结果。

您不需要每次都凭记忆把这些代码敲出来。相反,只需搭好文件框架,交给 Claude Code,然后审查差异(diff)即可。

回顾

  • Claude Code 是一个能够编辑文件并在您的终端中运行命令的代理。
  • 内置的 Claude API 技能会在 Claude Code 检测到 TypeScript SDK 时自动加载,您也可以使用 /claude-api 手动调用它。
  • 给它一条提示,指明文件、模式和最终状态——它就会编写代码、运行代码,并就地修复错误。
  • Claude API 代码遵循一个熟悉的结构:定义一个工具,交给一个运行器,返回结果。搭好框架,委托出去,审查差异。