第 84 页 / 共 100 页 / 飞书修订版 7

3.Claude Code in action

此文档由 学习AI的1000天 翻译制作(抖音,B站,YouTube)

邮箱: szqshan@gmail.com | 微信: szqshan
网址: www.xueai.org

==================================================

M2rXbkvbaobg9rx2WzBcXzScnXg.zip

Claude Code 不仅仅是一个编写代码的工具——它旨在在软件项目的每个阶段都与您协同工作。您可以将其视为团队中的另一位工程师,能够处理从初始设置到部署和支持的所有工作。

image1.jpeg

/init 命令

当您开始使用Claude Code处理项目时,首先要做的是运行`/init`命令。这会让Claude扫描您的整个代码库,并理解您项目的结构、依赖关系、编码风格和架构。

Claude 会将它学到的所有内容总结在一个名为 CLAUDE.md 的特殊文件中。该文件会自动作为上下文包含在所有未来的对话中,因此 Claude 能够记住关于你项目的重要细节。

你可以为不同的作用域创建多个 CLAUDE.md 文件:

  • 项目 - 在项目中工作的所有工程师之间共享
  • 本地 - 您未提交到 git 的个人笔记
  • 用户 - 在您的所有项目中使用

在运行 `/init` 时,你可以添加特殊指令来指定希望 Claude 重点关注的领域。生成的文件将包含构建命令、编码规范以及 Claude 应该遵循的项目特定模式。

image2.jpeg

您也可以使用 # 命令快速向 CLAUDE.md 文件添加备注。例如,输入 `# Always use descriptive variable names` 将提示您将此准则添加到项目、本地或用户内存中。

常见工作流程

Claude 在作为效率倍增器使用时效果最佳。你提供的上下文和结构越多,获得的结果就越好。以下是最有效的工作流程:

image3.jpeg

步骤1:向Claude输入上下文

在要求 Claude 构建某个功能之前,请先识别代码库中与您要创建的功能相关的文件。首先要求 Claude 读取并分析这些文件。这样可以为 Claude 提供您的编码模式示例以及可以构建的现有功能基础。

步骤 2:让 Claude 制定解决方案

不要直接跳到实现阶段,而是让 Claude 先思考问题并制定计划。明确告诉 Claude 暂时不要编写任何代码——只需专注于方法和所需的步骤。

步骤3:要求 Claude 实现解决方案

一旦你有了完善的计划,就可以要求 Claude 来实现它。Claude 将基于你们已经共同完成的上下文和规划工作来编写代码。

测试驱动开发工作流

为了获得更好的结果,您可以使用测试驱动的方法:

image4.jpeg
  1. 向 Claude 提供上下文 - 与之前相同,向 Claude 展示相关文件
  2. 让Claude思考测试用例 - 让Claude头脑风暴哪些测试能够验证你的新功能
  3. 请 Claude 实现这些测试 - 选择最相关的测试并让 Claude 编写它们
  4. 让 Claude 编写通过测试的代码 - Claude 会不断迭代实现,直到所有测试都通过

这种方法通常能产生更健壮的代码,因为Claude有明确的成功标准可以遵循。

实际示例

以下是这些工作流程在实际应用中的表现。假设你想要在现有项目中添加一个文档转换工具:

// 首先,让 Claude 读取相关文件

> 读取 math.py 和 document.py 文件

// 然后请求规划(而非实现)

> 计划实现 document_path_to_markdown 工具:

1. 创建一个函数,该函数:

- 接受一个文件路径参数

- 验证文件是否存在

- 根据扩展名确定文件类型

- 从文件读取二进制数据

- 利用现有的 binary_document_to_markdown 函数

- 返回 markdown 字符串

2. 添加适当的文档

3. 向 MCP 服务器注册工具

4. 添加测试

// 最后,请求实现

> 实施计划

Claude 将创建该函数,更新必要的文件,编写测试,甚至运行测试套件来验证一切都能正常工作。

附加命令

Claude Code 包含多个有用的命令:

  • /clear - 清除对话历史记录并重置上下文
  • /init - 扫描代码库并创建 CLAUDE.md 文档
  • # - 向您的 CLAUDE.md 文件添加注释

Claude 还可以处理常规的开发任务,如暂存和提交 git 更改、运行测试以及管理依赖项。您无需在编辑器和终端之间来回切换,可以让 Claude 处理这些任务,而您专注于更重要的整体工作。

Claude Code 成功使用的关键在于记住它被设计为协作伙伴,而不仅仅是代码生成器。您提供的上下文和结构越多,Claude 就能越有效地帮助您构建和维护项目。

==================================================



此文档由 学习AI的1000天 翻译制作(抖音,B站,YouTube)
邮箱: szqshan@gmail.com | 微信: szqshan
网址: www.xueai.org