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

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

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

本文系统整理了 Anthropic 公司 Claude Code 创始人和负责人 Boris Cherny 在 X（Twitter）上分享的 69 条 Claude Code 使用最佳实践，由开发者 shanraisshan 整理成 GitHub 仓库 claude-code-best-practice（42k+ Star）。文章按 13 大类别组织，从提示工程到高级工作流，核心目标是帮助开发者从随性的"Vibe Coding"转向结构化的"Agentic Engineering"。

核心论点

  • 从 Vibe Coding 到 Agentic Engineering：AI 编程需要系统化的方法论，而非凭感觉使用。
  • 信任代理、管理上下文、减少微操：三大核心原则贯穿所有实践。
  • 上下文是核心资源：上下文窗口有限，必须精打细算，CLAUDE.md 超过 200 行会失效，上下文使用超过 50% 应立即压缩。
  • 规划先行：复杂任务必须先规划，投入 20% 精力在规划上，可使实施阶段一次性成功率达到 80%。

13 大类别概览

  1. 提示工程（3 条）：Challenge Claude 验证变更、mediocre fix 后重构优雅方案、让 Claude 自主修复 bug。
  2. 规划与规格（6 条）：始终从 Plan Mode 开始、用 AskUserQuestion 工具采访用户、分阶段门控计划、第二 Claude 审查计划、写详细规格、原型优于 PRD。
  3. CLAUDE.md（7-8 条）：控制在 200 行以内、关键规则用 <important> 标签、Monorepo 分层加载、大指令拆到 .claude/rules/ 文件夹。
  4. 代理（4 条）：功能特定子代理、说"use subagents"抛更多算力、用 tmux + git worktrees 组建代理团队、利用 test-time compute。
  5. 命令（3 条）：工作流优先用 Commands、inner loop 转 slash command、每日重复操作转 Command/Skill。
  6. 技能（9 条）：context: fork 隔离运行、Skill 是文件夹、Gotchas 章节记录失败点、description 字段是触发器。
  7. 钩子（5 条）：on-demand hooks、PreToolUse 测量使用率、PostToolUse 自动格式化、权限请求路由到 Opus、Stop hook nudging。
  8. 工作流（7 条）：避免 agent dumb zone、Vanilla Claude Code 优于复杂 workflow、熟练使用 slash 命令、开启 thinking mode。
  9. 高级工作流（6 条）：ASCII 图理解架构、/loop 和 /schedule、Ralph Wiggum 插件、/permissions 通配符、/sandbox 隔离。
  10. Git/PR（5 条）：PR 保持小而专注、始终 squash merge、每小时至少 commit 一次。
  11. 调试：用日志 + “fix”。
  12. 工具：日常用 voice dictation 等。
  13. 日常：完整内容可直接查仓库。

关键见解

  • CLAUDE.md 是行为守则，不是知识库：精炼 > 堆砌，超 200 行即进入"变蠢区间"。
  • Plan Mode 是最被低估的功能：规划阶段投入 20% 精力，能让实施阶段 one-shot 成功 80%。
  • Skills 是"自进化"机制：Gotchas 部分让 Skill 越用越聪明。
  • Hooks 减少人工干预：Boris 团队内部用此将权限提示减少 84%。
  • 上下文管理是"上下文预算"艺术：超 50% 立即 /compact，手动 /clear 重置。

与现有维基的连接

  • 为 [[ai-junior-engineer]] 概念提供了详细的"管理手册"。
  • 为 [[context-engineering]] 概念提供了具体的技术细节。
  • 引入了 [[ai-skill]] 概念的具体实现方式。
  • 与 [[大模型不是真理机器-而是论证机器]] 相关，"Challenge Claude"实践利用了大模型作为"论证机器"的特性。
分享到