在《Claude Code的一次真实项目实践》一文中,为大家分享了在真实项目中使用Claude Code的体感以及部分经验分享。如果简单总结一下,那就是:真的很好用,真的能提效,真的能降低成本,推荐你也用一用。
上篇文章并没有描述整个实践的全流程,今天这篇文章就为大家梳理一下在这次真实的实践过程中,在哪些环节应用到了前面分享的哪些技巧和方法。
初始化CLAUDE.md
关于CLAUDE.md的作用,在《使用Claude Code最需要做的一件事:与AI签订一份契约(CLAUDE.md)》中已经讲到过。在本次项目实践中,由于项目基础架构已经存在,但之前并没有使用Claude Code来编程,所以第一步就是初始化一个本项目的CLAUDE.md文件。

在项目根目录,执行/init命令,Claude Code会根据当前项目的架构和现状,生成一份CLAUDE.md文件。
因为当前项目本身有README.md文档和guidelines.md文档,所以生成的CLAUDE.md文件内容还是比较多的,这里展示一部分内容。

当然,这份文档中还包含目录结构、数据库规范、配置文件规范以及如何启动和运行项目。有了这份文档,在后续的执行过程中Claude Code的将遵循原项目的规范来设计和生成代码。
集成数据库(Milvs)SDK
在这次项目实践的过程中,第二步做了数据库SDK的集成。这样做的初衷是方便后续AI可以直接利用集成好的SDK来操作数据库。
由于此处用的云服务数据库,在让Claude Code执行时,事先需要把SDK的文档、版本告诉AI,让AI遵照对应的版本来添加依赖和使用API。此时耗费的时间比较长,即便告知,因为有些SDK不是托管在Github上,还会出现一些依赖找不到的问题,不过Claude Code会想办法各种尝试。
Claude Code在集成时不仅仅会将依赖类库添加到项目中,编写一些基本的连接操作和封装,还会编写单元测试进行验证。这些基础的步骤就要依赖你所使用的Skills了,我这里主要用的Superpowers,前面文章多次提到。

上图是Claude Code在集成SDK时生成的执行计划,包含类型定义、配置加载、客户端封装、Collection管理、文档向量模型、以及添加依赖、错误码等操作。
数据库表结构生成
集成完SDK之后,便可以与Claude Code沟通生成表结构了。这里只生成一个单表,用来存储向量化的数据信息。

上图只是部分核心信息,Claude Code不仅生成了表结构,还配套生成了初始化脚本。当然,脚本中连接数据库的操作就是基于上一步的SDK集成来实现的。
然后让Claude Code执行脚本,初始化数据库表结构,执行脚本中本身就带有执行完之后的测试验证。
至此,SDK集成完毕,表结构设计和初始化完毕。
及时clear上下文
在上篇文章中,有朋友问,为什么消耗token那么少?这就涉及到另外一个经验,就是及时清除上下文。
像上面的操作步骤,每一步都会作为一个新的session或者每一步执行完之后都会执行一下/clear命令,来清除无用的上下文。

这个命令的使用是非常有必要的,不仅能够节省上下文,而且也能更好的提升当前任务的执行成功率,特别是两个任务不相关的时候,前面的任务的上下文甚至会对下面要执行的任务产生干扰。
在上面的操作中,每一个任务都可以拆分几次会话,比如生成代码走一个会话,修改Bug走一个会话,升级API走一个会话......
业务开发与提交
关于业务开发,就不说了,基本上就是尽量明确拆分任务,细化任务,然后基于Claude Code对Git的Worktree机制的支持,开启多个回话,并行执行。

每次执行完成之后,我所使用的Skills插件会自动进行对应功能的commit操作。然后指挥它在适时的时候进行push操作。

在这个过程中还会涉及到代码合并的merge操作,这个过程也全面交给Claude Code来执行了。它在进行Merge时如果发现有冲突,会自行解决冲突,验证,然后进行代码提交。
单元测试与自主测试
另外一个比较核心的功能就是测试与验证。在开发的过程中,一般会在任务中会进行Code Review保证设计的合理性,在最后环节进行单元测试,验证功能是否正确。如果有问题,Claude Code会自行反思修改,直到最终成功。

在这个过程中有个小插曲,由于开发的系统是基于JWT的验证访问,Claude Code在进行验证时无法拿到token,无法走全流程。
于是就让Claude Code先生成一个绕过登录,直接通过单元测试生成token,然后让它利用这个token基于curl命令进行对应的API接口验证。
随后,把每个接口的测试用例直接给它,让它直接跑对应的测试用例,当发现问题之后,它会基于日志自动来修复问题。这样把测试与Bug修复又融合为一体了。
小结
这篇文章已经将关于这次项目实践中大多数操作和经验都展示出来了,当然过程中还有一些其他小的技巧,小的沟通与调整,大家可以在实践的过程中进行尝试。
在前面的文章中也提到,既然尝试AI Coding,那就尽量全面使用(如果考虑token消耗就另当别论了),一行代码也不要写。在这次项目实践中完全践行了这一理论,甚至最开始本地没有goctrl,项目起不来等问题,也是让Claude Code帮忙自动操作的,再也不用为排查一个问题费天劲了,而且开发、测试、修复Bug的效率说翻倍都可能说少了,真心推荐大家尝试一番。
以下是Claude Code系列其的他相关文章:
第1篇:《国内环境下的Claude Code安装与使用教程》
第2篇:《使用Claude Code最需要做的一件事:与AI签订一份契约(CLAUDE.md)》
第3篇:《Claude Code实践:从零开始,一行代码不写生成一个项目》
第4篇:《Claude Code的Skills实践及利器推荐:工欲善其事,必先利其器》
第5篇:《6条Claude Code实践中的经验与思考》
第6篇:《Claude Code的一次真实项目实践》