Claude Code / 使用
Claude Code 最佳实践
把 Claude Code 当成会执行命令的协作者：先读、再计划、小步改、跑验证、审查 diff。
给 Claude 验证方式
官方最佳实践强调：让 Claude 有办法验证自己的工作。没有验收标准，智能体只能猜“好没好”。
| 弱提示 | 更好的提示 |
|---|---|
| 实现一个邮箱验证函数。 | 实现 validateEmail，并用 user@example.com、invalid、user@.com 等用例验证。 |
| 让仪表盘好看点。 | 按截图实现，完成后截图对比差异并修复。 |
| 构建失败了。 | 这是错误日志，修根因，不要 suppress，最后确认构建通过。 |
先探索再计划再编码
复杂任务应要求 Claude 先调查和计划。计划不是仪式，它能暴露会改哪些文件、哪些风险、验证路径是否完整。
先不要改文件。
请阅读相关代码并输出：
1. 你理解的问题
2. 需要修改的文件
3. 实施计划
4. 风险点
5. 验证命令配置环境
高质量 Claude Code 使用体验来自项目环境：CLAUDE.md、权限、CLI 工具、MCP、Hooks、Skills、Subagents 和 Plugins。
- CLAUDE.md 写项目命令和非显而易见的约定。
- 权限规则控制哪些工具能自动运行。
- Hooks 用于格式化、测试、通知和阻断危险行为。
- Skills 和 Subagents 用于可复用流程和隔离调查。
管理会话
最佳实践还包括及时纠偏和积极管理上下文。长任务不要放任 Claude 一路跑到最后才看结果。
早纠偏
如果方向不对，立即打断并给具体反馈。
控上下文
让 Claude 总结当前状态，再进入下一阶段。
用子代理
调查型任务交给子代理，主会话只保留结论。
审查 diff
最终必须看实际文件变化和验证输出。
完整使用要点
补充官方文档中容易被压缩遗漏的核心概念、操作顺序、权限边界和验证要求，方便中文学习者按页面完整学习。
最佳实践补充
Claude Code 最佳实践可以归纳为：给它环境、给它目标、给它验证方式、及时纠偏、控制上下文、审查结果。
- 环境：项目能安装、能运行、能测试，CLAUDE.md 写清命令和约定。
- 目标：任务范围明确，禁止事项明确，验收标准明确。
- 验证：让 Claude 运行真实命令、复现流程或浏览器检查。
- 纠偏：方向不对时立刻打断，给具体反馈。
- 上下文：长任务分阶段总结，大规模调查交给子代理。
- 审查：看 diff、测试、风险，而不是只看自然语言总结。
最佳实践的目标不是让 Claude 永远自主，而是让它在可控边界内更长时间稳定工作。
学习检查清单
把本页内容落到真实任务中，用入口、上下文、权限、验证和团队规则五个维度检查是否真正掌握。
学习检查清单
读完本页后，不要只记住概念名。你应该能把“Claude Code 最佳实践”放回 Claude Code 的真实工程流程里：任务从哪里发起，系统会加载什么上下文，哪些动作需要审批，结果如何验证，失败时如何回退。
如果这是入口或平台页面，要特别确认本入口能访问哪些上下文：本地文件、云端仓库、浏览器登录态、团队消息、外部工具，以及这些上下文是否足以完成验证。
- 能用自己的话说明本页解决的具体问题，而不是只复述标题。
- 能写出一个最小示例任务，并标明目标、范围、禁止事项和验收标准。
- 能判断哪些信息应该放进当前提示，哪些应该沉淀到项目规则或配置里。
- 能说明哪些长期规则应该写进 CLAUDE.md，哪些运行行为应该交给 settings、permissions、Hooks、Skills 和 MCP。
- 能在任务完成后检查 diff、命令输出、测试结果、截图或 PR 说明，而不是只相信自然语言总结。
如果要把本页用于团队培训，可以让学员用 Claude Code 完成一个小任务：先只读解释，再提交计划，再执行最小改动，最后用真实验证命令和人工 diff 审查收尾。