DataCamp: Claude Code Best Practices
- 分组：四、社区教程与实践文章
- 原始链接：https://www.datacamp.com/tutorial/claude-code-best-practices
- 抓取来源：http://www.datacamp.com/tutorial/claude-code-best-practices
- 原始文件：/Users/yuanruiqin/Desktop/知识库/ClaudeCode-系统化知识库/04-社区教程与实践/32-datacamp-claude-code-best-practices.md
- 精读版生成时间：2026-04-05 13:50:44
中文精读版（去噪）
Claude Code 奖励了一种大多数开发工具不要求的纪律。如果您已经使用它一段时间了，您会注意到有些会话会产生您想要的结果，而另一些会话则消耗掉代币而无处可去。 Anthropic 自己的团队发现无指导的尝试成功率约为 33%，而该工具的创建者放弃了 10-20% 的会话。
差异取决于您在工具周围放置的模式，而不是您输入的提示。
本文介绍了这些模式在实践中的样子，这些模式取自 Abnormal AI、incident.io 和 Trail of Bits 等公司的生产工作流程。
如果您需要复习设置和核心功能，我们的 Claude Code 2.1 指南可以满足您的需求。这里的所有内容都假设您已经了解基础知识并且希望从该工具中获得更多信息。
为了更广泛地了解代理如何推理以及本教程的模式适合的位置，我强烈建议注册我们的AI代理基础知识轨道，其中涵盖了所有基本原则。
为什么规划纪律会改变一切
克劳德在没有指导的情况下做出的每一个决定都可能具有很高的准确性，这对于单一选择来说听起来不错，但当在具有许多决策点的功能中进行复合时，一切正确的机会就会减少。如果假设 20 个决策的准确度为 80%，则得到 0.8^20，因此实现完全正确实现的功能的机会大约只有 1%。
规划将这 20 个模棱两可的决策压缩为经过审查的规范，其中每个决策都接近 100%，因为您已经做出了决定。
使用注释周期工作流程进行规划
正如 Boris Tane 建议的那样，最适合规模化的规划工作流程是注释周期。你让 Claude 起草一个 plan.md，在编辑器中打开它，并在 Claude 做出错误调用或留下一些不明确的地方添加内联注释：“使用 drizzle:generate，而不是原始 SQL”或“这应该是 PATCH，而不是 PUT。”
然后，您将带注释的计划发回，并附上保护短语“解决所有注释，暂不实施”。这个保护短语很重要，因为如果没有它，克劳德就会跳过计划并立即开始编码。这个循环不断重复，直到计划不再有任何含糊之处，此时克劳德实施的错误次数要少得多，因为每个决定都已经做出了。
plan.md — 注释周期
第三步：数据库迁移
为用户表创建新的迁移。
注意：使用 drizzle:generate，而不是原始 SQL 注意：添加带有默认 NOW() 的created_at
步骤 4：API 端点
添加 PUT /users/:id 端点。
注意：这应该是 PATCH，而不是 PUT。仅部分更新。
注释后，发回：
#“解决所有注释，尚未实施”
使用 Claude Code 计划模式
如果注释周期感觉很重，Claude Code 的内置计划模式 是一个更轻的选择：
- 按 Shift+Tab 两次。
- 在谈话中重申计划。
- 使用 Shift+Tab 一次切换到自动接受。
计划会持久保存到“~/.claude/plans/”，因此它们可以在压缩和会话重新启动后继续存在，从而使内置计划模式成为大多数任务的可靠默认设置。对于非常大的功能，预先编写完整的规范也很有效：一名开发人员花了 2 个小时编写 12 个步骤的规范，并节省了估计 6-10 小时的实施时间。
进一步规划
无论采用哪种方法，将良好的开源代码与计划请求一起粘贴都会显着提高输出，因为克劳德使用工作参考比使用抽象描述效果更好。
规划还可以通过 git worktre es 水平扩展。 event.io 的工程师在不同的分支上运行 4-5 个并行的 Claude 会话，每个分支都按照自己的计划进行工作。一位工程师花费了 8 美元的 Claude 信用，开发了一个实现，将 API 生成时间缩短了 18%，整个团队日常使用的工具节省了 30 秒。
一些开发人员更进一步，运行相互竞争的工作树，对同一问题实施不同的方法并比较结果。
CLAUDE.md 架构最佳实践
您的“CLAUDE.md”文件有一个您可能不知道的预算。 HumanLayer 对 Claude Code 内部结构的分析 发现系统在您的指令上方注入了一条提醒：“此上下文可能与您的任务相关，也可能不相关。”