Claude Code 最佳实践：从官方心法到社区工作流

用 Claude Code 的人很多，但真正用对的人不多。同样的工具，有人拿来一键生成代码频频翻车，有人却能用它稳定交付复杂项目。差距往往不在工具本身，而在用法。

最近，Tech with Mak 在 X 上把 Claude Code 团队（负责人 Boris Cherny 亲自下场）与社区高手的最佳实践浓缩成了一张 cheatsheet，引发大量转发。本文把这张图和背后的要点合并整理成一篇完整的实战指南，建议先保存下面这张长图，再逐条对照正文查阅。

一、官方最佳实践：来自 Boris Cherny 团队的心法

这些实践直接来自 Claude Code 开发团队。他们自己天天用这个工具，踩过的坑比谁都多，以下按主题分组拆解。

核心工作流

1. 永远用 plan 模式，并给 Claude 一个可验证的方法。 这是排在第一条的铁律。Plan 模式（Shift+Tab 按两次进入）让 Claude 先想后写：先出一份书面计划，你审过它才动手。Boris Cherny 反复强调，不要让 Claude 一上来就写代码。而且计划里必须写清验证方式：它怎么知道自己做对了？结果要能被客观判定，而不是靠感觉。

2. 让 Claude 用 AskUserQuestion 工具来"采访"你。 不要自己费劲描述需求，反过来让 Claude 主动问你。它会用 AskUserQuestion 一次问一个问题，逼你把模糊的需求说清楚。Matt Pocock 的 /loop-me 和 /grilling 走的正是这条盘问式需求澄清的路子。

3. 用 Git Worktree 做并行开发。 这是官方团队最推崇的技巧之一。开 3 到 5 个 worktree，每个跑一个独立的 Claude 会话，同时推进多个功能。有的工程师甚至给它们起 shell 别名（za、zb、zc）快速切换。一个 worktree 跑崩了不影响别的，上下文还互不污染。

4. 用 /loop 排程最长 7 天的周期任务。 比如"每天早上 review 一次生产日志""每晚补一次文档"，把它变成 loop，让它自己跑。

5. 代码审查用全新上下文窗口。 一个反直觉但极重要的洞察：让一个全新、干净的上下文来做 code review，能抓出原来写代码的 agent 漏掉的 bug。因为原 agent 有确认偏误，自己写的自己看不出问题。这就是 builder 与 reviewer 角色分离的价值。

6. 分阶段、带门禁的计划，每阶段配测试。 把大任务拆成阶段，每个阶段设门禁（gate）：必须通过测试才能进入下一阶段。软件工程的经典做法，用在 AI 上一样成立。

7. 跨模型审查计划。 让一个模型写、另一个模型审：Claude 出计划，Codex 来挑刺。不同模型的盲点不一样，交叉验证能堵住单模型的漏洞。

配置与文件

8. CLAUDE.md 单文件控制在 200 行以内。 CLAUDE.md 是 Claude 的项目记忆，但不是写得越多越好，太长它反而会忽略。单文件 200 行封顶，多了就拆分。

9. 用 commands 做工作流，而不是 sub-agents。 需要固定工作流时做成 command（/xxx），而不是 sub-agent。command 更轻、更可控、更可复用。

10. sub-agent 要功能专属，带明确 skill。 如果要用 sub-agent，让它专精某个功能并配上对应 skill，而不是做一个什么都管的"通用 QA 工程师"。专精的比通用的靠谱得多。

11. 小任务用原味 Claude Code。 别过度工程化，小任务直接用原生 Claude Code 就行，套一堆复杂工作流反而碍事。工具要匹配任务规模。

调试与排障

12. 卡住时，截图发给 Claude。 它能"看"图：UI 问题、报错弹窗、设计稿，给它看比用文字描述强得多。

13. 用 MCP 让 Claude 看到 Chrome 控制台日志。 接一个 MCP（Model Context Protocol）服务，Claude 就能直接读到浏览器控制台的报错，前端调试不用再复制粘贴。

14. 让 Claude 把终端命令当后台任务跑。 dev server、watch 这类长跑命令放后台，不阻塞主流程，调试体验好得多。

15. 跨模型做 QA。 与计划审查同理：Claude 写，Codex 审计划与实现，堵住单一模型的盲区。

上下文管理（最关键的一组）

16. context rot 在 30 到 40 万 token 时开始发作。 这是全文最重要的技术洞察之一。上下文窗口虽然大，但质量会随长度衰减：到了 30 到 40 万 token，模型开始忘事、跑偏、前后矛盾。别让单个会话无限拉长，到了量就该开新会话。

17. 回退优先于纠正：用 /rewind 回到失败之前。 一次尝试搞砸了，不要在那个失败的基础上继续让它修，那会让上下文堆满失败痕迹。用 /rewind 回退到失败尝试之前，干干净净重来。保持上下文干净，比反复打补丁强。

18. 用 /schedule 跑云端周期任务。 与 /loop 不同，/schedule 在云端排程，本机关了也在跑，适合定时巡检、定时报告。

19. 用 Auto 模式替代 dangerously-skip-permissions。 后者等于放开全部权限。Auto 模式由一个基于模型的分类器逐条判断命令是否安全，该问就问，该放就放，安全与效率兼顾。

20. 在每个 skill 里维护一节 Gotchas（坑）。 把 Claude 在这个 skill 上反复栽的跟头记录下来，随时间积累，skill 会越来越聪明。

二、社区工作流：五个高星框架与三个新玩法

除了官方心法，cheatsheet 还整理了社区里最火的几个工作流框架，全部开源可抄。以下星数为 2026 年 10 月的 GitHub 快照。

Superpowers（obra/superpowers，约 29.5 万星）：brainstorming、git worktrees、subagent-driven development、TDD 的全家桶。从头脑风暴开始，进 worktree 并行，用 subagent 分工，全程测试驱动，适合中大型项目。

Everything Claude Code：一套完整的命令链 /ecc:plan、/tdd、/code-review、/security-scan、merge。先规划，再 TDD 开发，接 code review 与安全扫描，最后合并。每步都是独立命令，可单用也可串成流水线。

Matt Pocock Skills（mattpocock/skills，约 27.6 万星）：/grill-with-docs、/to-prd、/triage、/tdd、/handoff。先带文档盘问需求，转成 PRD（产品需求文档），分类、TDD 开发、最后交接，重点在需求澄清。

Spec Kit（github/spec-kit，约 14 万星）：specify、clarify、plan、tasks、implement、analyze 的规格驱动开发。先把需求规格化，再澄清、规划、拆任务、实现、分析，强调先有规格再有代码。

gstack（garrytan/gstack，约 13.5 万星）：office-hours、CEO/工程/设计三轮评审、spec、qa、ship、canary，模拟一个完整团队流程，像一个虚拟开发团队。

另外还有三类值得关注：专门做跨模型协作的 Cross-Model Workflow（Claude Code + Codex）、研究规划实现三段式的 RPI（Research Plan Implement），以及专门跑自治任务的 Ralph Wiggum Loop。

三、五个开放难题

cheatsheet 特别点出了五个真正困扰用户、尚无标准答案的开放难题：

1. CLAUDE.md 里到底该放什么、不该放什么？ 放太多它忽略，放太少它不懂你的项目，度的拿捏是门学问。

2. 什么时候该用 command、agent、还是 skill？ 三者各有适用场景，没有一刀切的答案，只能靠经验积累。

3. 为什么 Claude 会忽略 CLAUDE.md 里的指令，哪怕全大写写了 MUST？ 无数人抓狂的问题：大写 MUST 没用，背后是上下文优先级与注意力分配的复杂机制。

4. 能不能把代码库转成规格，再让 AI 从规格单独生成出完全一样的代码？ 这是规格驱动开发的终极理想，如果可行，代码可以完全由规格定义和再生。

5. 该用内置 plan 模式，还是自己搭规划命令？ 内置的方便，自建的灵活，取决于项目复杂度与定制需求。

四、三个日常习惯

每天更新 Claude Code。 工具迭代极快，每天都有改进，保持更新才能享受最新能力。

每天早上先读 changelog。 更新了什么、修了什么、加了什么，changelog 是跟上工具演化的最快方式。

关注 Reddit 的 r/ClaudeAI 和 r/ClaudeCode。 社区里最新的玩法、踩坑、技巧都在这，比官方文档更接地气。

五、怎么把这些用起来

信息量大，给你一个落地优先级：

第一优先（今天就用）：复杂任务先开 plan 模式；会话接近 30 万 token 就开新会话；失败了用 /rewind 回退而不是硬修；卡住了截图给 Claude 看。

第二优先（这周就配）：试试 Git Worktree 并行；把 CLAUDE.md 精简到 200 行内；给 skill 加一节 Gotchas。

第三优先（有空再玩）：挑一个社区工作流（推荐从 Spec Kit 或 Matt Pocock Skills 开始）；试试 Claude 加 Codex 的跨模型审查；玩玩 /loop 和 /schedule 周期任务。

六、这套实践背后的统一逻辑

把这些心法和工作流全看完，会发现它们指向几个共同的核心理念。

第一，上下文是王。 plan 模式、worktree、rewind、context rot、200 行的 CLAUDE.md，全是在管理上下文。Claude Code 用得好不好，很大程度上取决于你能不能让上下文保持干净、聚焦、不腐烂。

第二，验证胜于信任。 给 Claude 验证方法、分阶段配测试、跨模型 review、fresh context 审查，全是在建立"不靠感觉、靠证据"的验证机制。

第三，专精胜于通用。 功能专属 sub-agent、Gotchas 积累、工具匹配任务规模：别追求一个万能 agent，而要养一群各有所长的专家。

第四，分工胜于独干。 builder 与 reviewer 分离、跨模型协作、社区工作流的流水线，把"一个 agent 什么都干"换成"多个角色各司其职"。

这四条本质上是同一套哲学：用工程纪律约束 AI 的自由度，让它的产出可验证、可复现、可信任。

七、资源入口

• 官方 CLI 仓库：github.com/anthropics/claude-code
• 官方文档：code.claude.com/docs
• 社区工作流仓库：obra/superpowers、mattpocock/skills、github/spec-kit、garrytan/gstack
• 文首的 cheatsheet 长图建议存下来随时查

一句话总结：Claude Code 的强大不在工具本身，而在用法。这套从官方团队和社区高手身上萃取的最佳实践，就是那个"用法"的完整答案。把它当 checklist，一条条对照自己的习惯，AI 编程效率会上一个台阶。

---

本文基于 Tech with Mak 在 X 平台分享的 cheatsheet 整理扩展，综合了 Claude Code 团队（Boris Cherny 等）的官方实践与社区工作流；cheatsheet 长图来自其原推文配图，文中星数为 2026 年 10 月的 GitHub 快照。