Best practices for Claude Code

• 公司：Anthropic
• 来源类型：Claude Code 官方文档，综合 Anthropic 内部团队和工程师实践
• 原文：https://code.claude.com/docs/en/best-practices
• 可靠性：高；官方当前文档，适用于 Agentic coding environment。

最重要的实践

1. 给 Agent 一个能读懂的验证信号

不要只说“把它做得更好”。给出测试、构建、Lint、截图比对、fixture 对比或其他可执行检查，让 Agent 能完成“修改—运行检查—读取结果—继续修正”的闭环。

2. 先探索，再计划，再实现

让 Agent 先理解代码库和约束，再形成计划，最后修改代码。复杂任务不要一上来就让它直接写。

3. 提供具体上下文

明确目标、边界、相关文件、示例、非目标和验收标准。丰富但相关的上下文比一大段抽象要求更有效。

4. 把项目规则写进环境

使用 CLAUDE.md、项目脚本、权限配置、MCP、hooks、skills 和自定义 subagents，把重复说明从聊天中移入可复用配置。

5. 管理上下文窗口

对话、文件内容和命令输出都会占用上下文；上下文填满后性能会下降。应主动压缩、分阶段工作、只读取相关内容，必要时开新会话并带上简洁的状态摘要。

6. 尽早纠偏

不要等 Agent 走完错误路径才纠正。发现方向、假设或范围不对时立即打断；使用检查点和可恢复的会话管理降低返工成本。

7. 把调查和实现分开

可以先使用 subagent 或独立会话做代码库调查、寻找相关文件和提出方案，再让主 Agent 实现；这样可以减少主上下文被探索过程污染。

8. 并行化和自动化要有边界

对互不依赖的文件或任务可以并行开多个会话；自动模式适合低风险、可验证的任务。涉及删除、发布、资金、权限和生产环境时保留人工审批。

9. 增加对抗式复核

实现完成后，让另一个 Agent 或独立步骤专门寻找遗漏、回归、边界条件和安全问题，而不是让同一个上下文只为自己的结果辩护。

一套可复制的 Claude Code 提示结构

目标：要达成什么结果
背景：项目、用户、现有实现
范围：允许修改什么，不要修改什么
约束：技术、风格、兼容性、权限
验收：必须运行哪些测试/命令，什么算通过
过程：先探索并给计划，再实现；遇到高风险动作先停下
交付：总结改动、验证结果、遗留风险

适用场景

代码库维护、重构、调试、UI 迭代、批量改文件、持续集成和需要 Agent 自己验证的工程任务。

原文中的重要提醒

Claude Code 文档将“上下文窗口是最重要的资源”作为贯穿性约束。高质量使用 Agent 的关键不只是更强模型，而是让任务、上下文、工具和验证机制形成闭环。