以下是用 Claude Code 高效、高质量开发的核心实践,按影响力排序:
🏗️ 一、配置 CLAUDE.md(最重要)
CLAUDE.md 是 Claude 自动读取的项目"大脑",把以下内容写进去:常用命令(npm run test,npm run build)、代码风格规范(“使用 ES modules,而非 CommonJS”)、关键文件和架构模式。
CLAUDE.md 建议控制在 200 行以内,对于 monorepo 可以使用多个 CLAUDE.md(父目录 + 子目录分层加载)。
📋 二、先规划,再执行
上下文管理是最核心的成功因素。最成功的 Claude Code 用户会通过 CLAUDE.md、积极使用/clear、维护开发文档等方式管理上下文。上下文质量退化是最主要的失败原因。每个高质量来源都强调:编码前必须先规划,"随心所欲地码"只适合一次性 MVP,生产级代码需要结构化思考和验证。
工作流:Plan → 小 diff → 测试 → Review,任何情况下都不跳步骤。
🔁 三、管理上下文窗口
频繁使用/clear。每次开始新任务就清空上下文,不需要让旧对话占用 token,也不需要 Claude 花时间压缩历史会话。
用Esc Esc或/rewind在 Claude 跑偏时回退,而不是在相同上下文里试图修复。
⚡ 四、并行 Session 加速开发
用多个 Claude session 并行工作来加快开发:可以用 Git worktrees 隔离任务,也可以用 Writer/Reviewer 模式——一个 Claude 写代码,另一个新鲜上下文的 Claude 审查代码,因为它不会对自己刚写的代码产生偏见,从而更有效地发现 bug。
🛠️ 五、接入 CLI 工具与 MCP
优先让 Claude Code 使用gh、aws、gcloud、sentry-cli等 CLI 工具来操作外部服务——这是最节省上下文的方式。通过claude mcp add接入 Notion、Figma 或数据库,可以让 Claude 直接从 issue tracker 实现功能、查询数据库或分析 Figma 设计稿。
🧠 六、写出高质量 Prompt
在 prompt 中给出具体示例文件(Few-shot 提示):“按照components/UserCard.tsx的模式创建一个 ProductCard 组件”——一个具体的参考文件胜过 100 字的文字描述。
在 prompt 中明确指定:上下文(相关文件路径)+意图(要做什么)+期望格式(输出要求)。
🔒 七、安全与质量保障
AI 生成的代码通常表面能运行,但可能隐藏细微 bug。测试是唯一可靠的验证机制。对 AI 输出保持不信任态度,用测试和人工 review 来把控合并质量。
使用/permissions配合通配符语法(如Bash(npm run *))来精细管理权限,而不是直接用--dangerously-skip-permissions。使用/sandbox在文件和网络隔离环境下运行,降低风险同时减少权限提示打扰。
💡 八、积累个人直觉
这些只是通用的起点,不一定对每种情况都最优。有时应该让上下文积累,因为你正深入一个复杂问题,历史信息很有价值。注意哪些方式产出了好结果,当 Claude 输出优质代码时,记住你做了什么:prompt 结构、提供的上下文、使用的模式。
快速参考表
| 场景 | 最佳做法 |
|---|---|
| 新项目启动 | 先写好 CLAUDE.md |
| 复杂功能开发 | Plan Mode → 分阶段实现 |
| 遇到 bug | /rewind回退而非继续修 |
| 代码审查 | 开新 session,用 fresh context |
| 重复任务 | 自定义 slash commands |
| 上下文混乱 | /clear清空重来 |