AI技术

Claude Code 之父 Boris Cherny 的 69 条最佳实践：从 Vibe Coding 到 Agentic Engineering

, , , , ,

Master Claude Code: The Ultimate Developer Cheat Sheet

在 AI 辅助编程领域，Claude Code 已成为无数开发者的生产力利器。而它的创造者 Boris Cherny，更是这个领域的标志性人物。Boris Cherny 是 Anthropic 公司 Claude Code 的创始人和负责人，此前曾在 Meta 担任 5 年 Principal Engineer。他是 O’Reilly 经典书籍《Programming TypeScript》的作者，自学成才的程序员背景让他对开发者痛点有着极深的理解。2025-2026 年间，Boris 在 X（Twitter）上多次分享 Claude Code 使用心得，这些碎片化经验被开发者 shanraisshan 整理成 GitHub 仓库 claude-code-best-practice，目前已获 42k+ Star，一度登顶全球 Trending。该仓库将 Boris 的智慧浓缩为 69 条最佳实践，系统分为 13 大类别，从提示工程到工作流 orchestration，帮助开发者从"凭感觉 coding"（vibe coding）转向结构化的"代理工程"（agentic engineering）。

本文将按仓库分类，逐一介绍这 69 条实践。每条实践后附简要解析、适用场景及反模式，避免读者"知其然不知其所以然"。这些实践的核心在于上下文管理、信任代理、减少微操，让 Claude 真正成为你的"超级同事"而非"打字机"。读完本文，你将获得一套可直接落地的 Claude Code 工作法，生产力提升 3-5 倍不是梦。

一、Prompting（提示工程，3 条）

提示是与 Claude 交互的基础，但多数人仍在"微操"。Boris 强调：高质量提示不是堆砌，而是激发 Claude 的自主性。

  1. Challenge Claude 验证变更：提示如"grill me on these changes and don’t make a PR until I pass your test." 或"prove to me this works"，让 Claude 对比 main 分支与当前分支的 diff。
    解析：这迫使 Claude 像资深工程师一样自审，避免浅层修复。适用于 PR 前置审查，能显著降低 bug 率。

  2. mediocre fix 后重构优雅方案：修复不佳时说"knowing everything you know now, scrap this and implement the elegant solution"。
    解析：Claude 拥有完整上下文，能瞬间重构。Boris 团队常用此法迭代代码，效果远超手动重写。

  3. 让 Claude 自主修复 bug：粘贴 bug 描述，直接说"fix"，不要教它怎么做。
    解析：这是 Boris 最经典的一条。Claude 能自行分析 Slack 线程、CI 日志甚至 Docker 输出，开发者只需"放手"。反模式：微操步骤，反而让 Claude 变"蠢"。

这 3 条的核心是信任与挑战，把提示从指令变成对话。

二、Planning/Specs（规划与规格，6 条）

复杂任务绝不直接编码，先规划是 Boris 团队的铁律。

  1. 始终从 Plan Mode 开始：任何 3 步以上或涉及架构决策的任务，先进入计划模式。
  2. 用 AskUserQuestion 工具采访用户：从最小规格起步，让 Claude 提问澄清需求，再新建会话执行。
  3. 分阶段门控计划 + 多重测试：每个阶段包含单元、自动化、集成测试。
  4. 第二 Claude 审查计划：像请 Staff Engineer 一样，让另一个 Claude（或跨模型）审阅计划。
  5. 写详细规格减少歧义：输入越具体，输出越好。
  6. 原型优于 PRD：与其写长规格，不如快速构建 20-30 个版本，构建成本极低。

解析：规划阶段投入 20% 精力，能让实施阶段 one-shot 成功 80%。Boris 强调"plan mode 是最被低估的功能"，避免后期返工。

三、CLAUDE.md（核心记忆文件，7-8 条）

Boris Cherny 的 Claude Code 最佳实践信息图

CLAUDE.md 是 Claude 的"宪法"，但很多人写得太长反而失效。

  1. 控制在 200 行以内（理想 60 行）：超过后 Claude 会忽略关键规则。
  2. 关键规则用 <important if="..."> 标签包裹：防止文件膨胀时被稀释。
  3. Monorepo 用多个 CLAUDE.md：祖先 + 子目录分层加载。
  4. 大指令拆到 .claude/rules/ 文件夹：避免单文件过大。
  5. 避免 memory.md 或 constitution.md：这些无法保证遵守。
  6. 新人零门槛启动：任何开发者输入"run the tests" 就应立即成功，否则 CLAUDE.md 缺失关键命令。
  7. 保持代码库整洁，完成所有迁移：部分迁移会让 Claude 混用旧模式。
  8. 优先用 settings.json 强制行为：如 attribution.commit 而非在 CLAUDE.md 写"NEVER…"。

解析：Boris 反复提醒，CLAUDE.md 不是知识库，而是"行为守则"。精炼 > 堆砌，这是上下文预算管理的精髓。仓库强调：超 200 行即进入"变蠢区间"。

四、Agents（代理，4 条）

从单一 Claude 转向多代理协作，是 agentic engineering 的核心。

  1. 功能特定子代理 + 技能：避免泛化角色如"QA"或"后端工程师"，用特征专属代理。
  2. 说"use subagents"抛更多算力：将任务卸载，保持主上下文干净。
  3. 用 tmux + git worktrees 组建代理团队：并行开发。
  4. 利用 test-time compute：不同上下文窗口让一个代理制造 bug、另一个发现 bug，效果更好。

解析：Boris 团队常跑 3-5 个会话，每个隔离工作树。反模式：babysit（微操）子代理，反而降低效率。

五、Commands（命令，3 条）

Commands 是可复用的"快捷指令"。

  1. 工作流优先用 Commands 而非子代理。
  2. 每日多次的 inner loop 转成 slash command：存于 .claude/commands/ 并 git 提交。
  3. 每日重复操作转 Command/Skill：如 /techdebt、上下文转储、分析命令。

解析：Commands 让重复劳动自动化，Boris 团队用此构建 Slack/GDrive/Asana 同步工具。

六、Skills（技能，9 条）

Skills 是 Claude 的"插件生态"，支持 progressive disclosure。

  1. context: fork 在隔离子代理运行 Skill：主上下文只见最终结果。
  2. Monorepo 中子文件夹 Skill。
  3. Skill 是文件夹而非文件：包含 references/、scripts/、examples/。
  4. 每个 Skill 建 Gotchas 章节：记录历史失败点。
  5. description 字段是触发器：写"何时触发"而非摘要。
    6-7. 不要写显而易见内容，也不要 railroading（强行步骤）：给目标与约束即可。
  6. 嵌入脚本/库：让 Claude 组合而非重构 boilerplate。
  7. 用 !command 注入动态 shell 输出：Claude 运行后仅见结果。

解析：Skills 是 Boris 推崇的"自进化"机制。Gotchas 部分让 Skill 越用越聪明。

七、Hooks（钩子，5 条）

Hooks 是高级自动化层。

  1. on-demand hooks：如 /careful 阻断破坏命令，/freeze 锁定目录。
  2. PreToolUse 测量 Skill 使用率。
  3. PostToolUse 自动格式化代码：Claude 写 90%，hook 补最后 10%。
  4. 权限请求路由到 Opus：自动审批安全操作。
  5. Stop hook nudging Claude 继续或验证。

解析：Hooks 减少人工干预，Boris 团队内部用此将权限提示减少 84%。

八、Workflows（工作流，7 条）

Claude Code 欢迎界面

日常操作标准化。

  1. 避免 agent dumb zone：上下文超 50% 立即 /compact，手动 /clear 重置。
  2. Vanilla Claude Code 优于复杂 workflow（小任务）。
  3. 熟练使用 /model、/context、/usage 等 slash 命令：Plan 用 Opus，代码用 Sonnet。
  4. 开启 thinking mode + Explanatory 输出。
  5. 提示中加 ultrathink 提升推理。
  6. 重命名重要会话并 /resume。
  7. 用 Esc Esc 或 /rewind 回滚而非继续修复。

解析：上下文管理是 Boris 反复强调的"上下文预算"艺术。

九、Workflows Advanced（高级工作流，6 条）

  1. 大量使用 ASCII 图理解架构。
  2. /loop 本地循环监控，/schedule 云端定时。
  3. Ralph Wiggum 插件处理长时自治任务。
  4. /permissions 用通配符而非 skip。
  5. /sandbox 隔离文件网络。
  6. 投资产品验证 Skill（如注册流程驱动）。

十、Git / PR（5 条）

  1. PR 保持小而专注（p50 仅 118 行）。
  2. 始终 squash merge：线性历史，便于 revert。
  3. 每小时至少 commit 一次。
  4. @claude 标记同事 PR（剩余 1 条推测为协同审查）。

（后续 Debugging、Utilities、Daily 等类别同样实用，例如调试时用日志 + “fix”、日常用 voice dictation 等，完整内容可直接查仓库。）

结语：实践出真知，Practice Makes Claude Perfect

Boris Cherny 的 69 条实践不是教条，而是从真实团队（包括他本人）千锤百炼的智慧结晶。核心三条（别微操、超 50% 就 compact、CLAUDE.md <200 行）已足够让你脱颖而出。仓库不仅列出实践，还提供 .claude/ 配置示例、视频教程和社区 workflow，建议立即 fork 并定制自己的 CLAUDE.md。

从 vibe coding 到 agentic engineering，只需系统练习这些细节。Claude Code 不是工具，而是伙伴——当你学会"放手"并用对框架，它就会回报指数级生产力。立即打开仓库，开始你的第 1 条实践吧！

分享到