Claude Code生产级项目实战经验分享
Source: http://x.com/i/article/2039491375058796544
上周给一家公司交付了一个SaaS产品,产品、前端、后端一个人全干,300个接口,工期3个月,平均每天工作2-3小时,这个工作效率换做以前根本不敢想。这个项目的AI代码的覆盖率大概90%以上,大部分使用Claude Code,以下就是我在项目中使用Claude Code的一些经验。
CLAUDE.md 必须要写
很多人花大量时间研究怎么prompt,但其实上下文管理比提示词技巧更重要,Claude 每次对话都是从零开始的,它不记得你上次说了什么。在项目根目录放了一个 CLAUDE.md,把技术栈、目录结构、命名规范、哪些文件不能动、哪些模式是我们已经决定不用的,全部写进去。这个文件后来越写越长,最终有将近400行,CLAUDE.md 必须要写。
先让Claude给方案
不要一上来就说“帮我实现 xxx 功能”,Claude 会给你东西,能跑,测试也过,但两周之后你会发现那个架构选错了,改起来牵一发动全身。可以试试这样提问“这个需求有哪几种实现思路,各自的优缺点是什么,你倾向于哪个,为什么。”在这里强烈推荐安装 https://github.com/obra/superpowers 这个插件,在做功能方案的时候,它的brainstorming技能会跟你进行头脑风暴。
它给的分析不一定全对,但逼着你在写第一行代码之前先想清楚。很多时候它想到的东西你不一定能想到。选定方案之后再让它写代码,质量和可维护性都不是一个级别。
任务要拆小
一个项目会有多个模块清单:用户系统、权限管理、数据看板、报表导出等等。不要把一个大模块整体扔给 Claude,它会给你一个看起来完整实际上漏洞很多的实现。最好的实现方式是:一个用户系统拆成数据库设计、注册登录 API、session 管理、密码重置流程、权限校验中间件……每一块单独做,做完验证,再做下一块。表面上慢,实际上快。因为你每一步都知道自己在哪,出了问题好定位,改了一处不会意外影响另一处。
错误信息要完整粘贴
“报错了,帮我看看”,这是最低效的求助方式。你自己翻译一遍“它说什么类型不对”,信息已经损失了一半。Claude 需要的是原始材料:完整的错误堆栈、出问题的代码片段、你已经试过什么、在什么条件下会触发。给够了这些,Claude解决bug的速度才会提升。
不要死磕一个AI工具
不要死磕一个AI工具,虽然我大部分时间是在用Claude,但有时候Claude陷入死循环后,Codex可能很快就有解决方案,我的做法是:如果遇到难题,只给一个模型3次机会,如果无法解决,就换模型。另外,代码审查也很重要,Claude写的代码让Codex审查、Codex写的代码让Claude审查。
一些冷门或者比较新的库,提供官方文档给它
这个认知很重要,能帮你省掉很多冤枉时间。Next.js、React、PostgreSQL等常见的开源库, Claude 的输出质量非常高,基本可以信任。但如果你在用一个相对冷门的库,或者某个框架刚发布的新版本 API,它会给你看起来完全合理、实际上根本不存在的方法名和参数。在这种时候就要把最新的文档粘贴给AI。
记录你用过的 prompt,它们是可以复用的资产
随着你的项目积累,慢慢的就会形成这类项目的提示词和工作流模板。哪种任务用什么结构来描述、审查代码用什么角色设定、需求拆解用什么框架,这些东西第一次摸索出来要花时间,但记下来之后,下个项目直接用。之后做类似的项目,能大大的压缩项目时间。Prompt资产可以理解成古法编程时代的“轮子”,根据你的代码习惯积累下来的经验是可以复用的,不需要每个项目都重复造轮子。