官方最佳实践（Official Best Practices）
核心原则
上下文窗口是最重要的资源。 它会快速填满，性能会随之下降。所有策略都围绕高效使用上下文展开。
六大策略
1. 给 Claude 验证手段
单一最高杠杆动作。 提供测试、截图、预期输出，让 Claude 能够自我验证。
运行测试并确保所有测试通过后再说完成。
如果有测试失败，修复代码而不是修改测试。
验证手段包括：
- 现有测试套件
- 截图（支持粘贴图片）
- 预期输出示例
- Lint/类型检查命令
2. 先探索，再规划，再编码
推荐工作流（按 Ctrl+G 进入/退出计划模式）：
探索（计划模式）→ 规划（计划模式）→ 实现（普通模式）→ 提交
- 探索：让 Claude 阅读相关代码，理解现有架构
- 规划：让 Claude 制定实现方案，你审阅并调整
- 实现：切换到普通模式执行
- 提交：验证后提交
3. 提供具体上下文
- 用
@引用文件 - 粘贴图片（错误截图、设计稿）
- 管道输入数据：
cat logs.txt | claude - 指明约束条件和参考模式
4. 配置你的环境
按优先级排序的配置项：
| 配置 | 作用 |
|---|---|
| CLAUDE.md | 项目级指令（< 200 行，具体规则） |
| 权限/沙箱 | 安全边界 |
| CLI 工具 | gh、aws、gcloud 等 |
| MCP 服务器 | 连接外部服务 |
| Hooks | 确定性自动化（不是建议性的） |
| 技能和子代理 | 可复用的专业工作流 |
| 插件 | 打包和分发的扩展 |
5. 管理会话
| 操作 | 快捷键/命令 | 用途 |
|---|---|---|
| 停止 | Esc |
中断当前操作 |
| 回退 | Esc+Esc 或 /rewind |
撤销上一步 |
| 清屏 | /clear |
不相关任务之间清理上下文 |
| 压缩 | /compact <指令> |
定向压缩上下文 |
| 旁白 | /btw |
快速侧问（不进入历史） |
| 子代理调研 | 使用 Agent 工具 | 保护主上下文窗口 |
6. 并行扩展
- 非交互/CI：
claude -p "prompt" - 多会话：桌面应用、Web、Agent Teams
- 扇出：
for file in $(cat files.txt); do claude -p "..." done
常见反模式
❌ 厨房水槽会话
在一个会话中做所有事情。上下文污染导致后续任务质量下降。
解决：不相关任务之间用 /clear。
❌ 反复纠正
同一个错误纠正 2 次以上。Claude 可能陷入局部循环。
解决：纠正 2 次失败后，/clear 并重写提示词。
❌ 过度指定 CLAUDE.md
CLAUDE.md 太长、太详细，导致关键规则被淹没。
解决：无情精简。只保留 Claude 无法从代码中推断的信息。
❌ 先信任后验证的缺口
没有给 Claude 验证手段，只看最终结果。
解决：始终提供验证手段（测试、lint、类型检查）。
❌ 无限探索
Claude 不断读取文件但不开始实际工作。
解决：限定调研范围，或用子代理隔离调研。
Writer/Reviewer 模式
一种高效的协作模式：
- Writer：Claude 编写代码
- Reviewer：Claude（或另一个子代理）审查代码
- 循环直到审查通过
可以通过技能或子代理自动化这个模式。
上下文管理决策指南
| 当你需要... | 使用... |
|---|---|
| 项目级永久指令 | CLAUDE.md |
| 按路径差异化规则 | .claude/rules/ |
| 可复用的专业工作流 | 技能（Skills） |
| 委派聚焦任务 | 子代理（Subagents） |
| 确定性自动化 | Hooks |
| 连接外部服务 | MCP 服务器 |
| 打包和分发扩展 | 插件（Plugins） |
| 跨会话学习 | 自动记忆 |