很多人第一次接触 Claude Code，都会忍不住直接甩一句「帮我写个代码」。结果往往不尽人意——AI 给你一坨能跑但不可维护的“屎山”，改来改去，最后比自己写还费劲。

其实问题根源不在 AI，而在沟通方式。AI 再聪明，也无法读心。如果需求模糊、边界不清，那它只能“猜”。一旦猜错，你得到的就是错误实现，或者堆满技术债的代码。想要和 Claude Code 高效协作，需要养成一个习惯：先让需求不带歧义，再让 AI 参与实现。

第一步：写一份“零歧义”的需求文档

找一个顺手的需求文档工具（常见的文档协作平台都可以），把新需求详细描述清楚。标准是：

• 任何人拿到这份文档，都能毫无歧义地理解你想要什么。

• 内容尽量图文并茂：流程图、页面示例、输入输出样例，甚至操作步骤，都写进去。

• 字数不要吝啬，1000字以上是个安全线。描述越清晰，AI 的输出越准确。

完成后，再把这份文档粘贴给 Claude Code。记住：如果最后产出的代码是一座屎山，问题不是 Claude Code，而是你文档不够清晰。

第二步：首次沟通，别让 AI 急着写代码

第一次把需求丢给 Claude Code 时，千万别一上来就要求“写完整代码”。

正确的做法是在需求末尾加上这样一句话：

不要急着写代码！先理解需求，给出实现思路，我们先讨论，看还有啥需要我决策的点？ ultrathink