Claude Code极简入门：3条规则杜绝代码屎山

BadAGI.org极简指南 - 只有3条，但绝对有效

非常基础，非常初级，非常短，但绝对有效。如果你能遵守这3条规则，就能杜绝Claude Code把代码写成屎山。

📋 Table of contents

规则1：用飞书文档写需求，做到「任何人看都没有歧义」

和Claude Code沟通新需求时，用飞书文档写需求，需求描述超过1000字，图文并茂，然后复制给Claude Code。

尝试让Claude Code直接写代码，是新手最容易犯的第一个错误。特别容易把代码改成屎山。

为什么这么重要？

一定要意识到：如果代码成了屎山，这不是Claude Code的问题，是你的问题。

新手容易不知道自己是否把需求描述得没有歧义，他们会倾向于甩锅给AI。为了万无一失，你还需要看下一条。

如何做到「没有歧义」？

• 写完需求后，想象一个完全不了解项目背景的人能否理解
• 包含具体的用户故事、业务逻辑、边界条件
• 配上界面草图、流程图、数据结构示例
• 1000字是底线，复杂需求可能需要3000-5000字

规则2：新需求首次沟通时，强调「不要急着写代码！」

在新需求沟通的末尾，一定要加上这句话：

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

尝试让Claude Code直接写代码，是新手最容易犯的第二个错误。

为什么不用Plan Mode？

有同学问我，为什么不用Plan Mode？是的，Plan Mode可以得到类似的效果，但是，切换模式有点麻烦了。我喜欢提前授予Claude Code一切权限，解放双手。

讨论过程是什么样的？

一般而言，新需求需要反复讨论3～5轮，直到Claude Code完全找不出来下一个需要你决策的点，我们再让它开始写代码。

我的讨论回复通常是非常长的，事无巨细。这些内容都是从飞书文档里复制粘贴出来的。

如果出现Claude Code不展示你的需求原文（因为太长）的情况——这是好现象，说明你回复得很详细。

完全讨论清楚后，只需要回复「同意」或者「开始」，Claude Code就会开始编码。

规则3：界面需求时，快速画草图 + ASCII确认 + 强调拆分

涉及界面需求时，按这三步走：

A. 快速画草图

最快的是在纸上画，也可以在Excalidraw上画，怎么快怎么来。无论怎么画，Claude Code都能明白你的意思。

推荐工具：

• 纸笔（最快）
• Excalidraw（在线画图）
• Draw.io（流程图）

B. 让Claude Code用ASCII画出来确认

关于ASCII画图，你可以让Claude Code出3~5种不同的布局，然后你来选择。

示例对话：

你：基于我的草图，用ASCII画出3种不同的布局方案
Claude Code：[画出ASCII布局]
你：我选择方案2，但顶部导航改成侧边栏

C. 强调合理拆分控件

最后，在开始编码前，强调让Claude Code：

• 仔细理解项目结构
• 尽可能合理地拆分控件
• 把控件放到合适的位置

这也是新手常见坑：如果不做强调，Claude Code可能会写出来单文件很大的控件。

正确的提示词：

“开始编码前，先分析项目结构，合理拆分组件，每个组件单独文件，避免单文件过大”

🎯 总结：极简但有效

这3条规则看起来简单，但能解决90%的新手问题：

1. 详细的需求文档 = 避免理解偏差
2. 先讨论再编码 = 避免返工
3. 界面三步走 = 避免组件混乱

记住：如果代码成了屎山，不是Claude Code的问题，是你没有正确使用它。

遵守这3条规则，你的Claude Code将永远输出高质量的代码。

💡 进阶提示

当你熟练掌握这3条基础规则后，可以尝试：

• 使用 ultrathink 后缀让Claude深度思考
• 建立项目专属的CLAUDE.md文档
• 探索SubAgents和专业智能体
• 学习更高级的vibe coding技巧

但在那之前，先把这3条规则练熟。

本文首发于BadAGI.org - 专注于vibe coding和AI编程革命的社区

这是给Claude Code新手的极简入门指南，老手请移步我们的进阶文章。