不是因为内容多高级。而是因为它点了一个大多数人不敢承认的问题:Claude Code 用不好,不是模型问题,是你一直用聊天工具的脑子在操作一个工程系统。
01 CLAUDE.md 越长越没用,500 字封顶
很多人一知道它重要,就开始堆。架构原则、编码规范、团队约定,再加一句"请你成为一个严谨的资深工程师"。
写完洋洋洒洒两千字,Claude 照样干不明白。
原因很简单:它不是你们组新来的实习生,不会把你的培训手册背下来。它更像一个注意力有限的执行者——你塞太多,它只是更容易抓不到重点。
经验值:控制在 500 字以内。超过这个数,大概率是在给自己写,不是在给 Claude 写。
能马上改变 Claude 行为的,留下。不能的,删掉。 CLAUDE.md 不是文化墙,是操作手册。
02 agent 越多越乱,3 个够用了
看到 .claude/agents/ 能扩展,很多人马上来劲:review-agent、debug-agent、architect-agent……目录打开跟插件市场一样,看着很 full stack,其实大半都是自我感动。
真正有价值的 agent,只有一个标准:它有没有在真实工作里被反复用到。
实际用下来,大多数项目 3 个 agent 就已经够。超过这个数,先问自己:这个是真需求,还是配了好看?
少而精,比满墙挂件强多了。
03 质量靠回路,不靠自觉
很多人用 Claude Code,停留在"生成"这一步。它写完了,看两眼,差不多,合了。前期效率起飞,后期用加班买单。
工程思维不是"Claude,你记得跑一下测试"。
你可以忘,但流程不能忘。测试不过,别想收工。
把质量寄托在"大模型这次比较自觉"上,跟把线上稳定性寄托在"开发同学这次比较细心"一样——听着就不太吉利。
04 别神化记忆
"它越来越懂我了"——这话有时候没错,但别高兴太早。记忆本质上是缓存。缓存干净当然爽,缓存脏了系统就开始阴你。
真正值得沉淀的:项目常用命令、长期稳定的架构约束、验证过的规范。
不值得沉淀的:某次排查时的错误猜测、应急修法、已经被推翻的旧结论。
沉淀规则,是复利。沉淀噪音,是慢性中毒。
所以这篇帖子为什么会爆?
因为它说透了一件事:Claude Code 不是聊天工具的高级版,它应该被纳入你的工程流程。
这两句话看起来差不多,实际差得很远。一个让你迷恋 prompt,另一个让你先管规则、先卡验收、先清边界。
会生成,不稀奇。能稳定收口,才值钱。
更多深度内容与完整文章,欢迎关注我的微信公众号:SamLai 效率研习社
主要分享:
AI 编程与开发效率
技术趋势与工程思考
实用工具与工作流