Best practices
约 5 分钟
加载中...
Claude Code Docs 主页！图片 1：光徽标！图2：黑暗标志
⌘K问AI
克劳德开发者平台 网络上的克劳德代码
使用克劳德代码
克劳德代码的最佳实践
入门与 Claude 一起构建代码部署管理配置参考什么新资源
概述 快速入门 变更日志
Claude Code 的工作原理 扩展克劳德代码 探索 .claude 目录 探索上下文窗口
编写有效的 CLAUDE.md
使用克劳德代码
充分利用 Claude Code 的技巧和模式，从配置环境到跨并行会话进行扩展。
Claude Code 是一个代理编码环境。与回答问题和等待的聊天机器人不同，Claude Code 可以读取您的文件、运行命令、进行更改，并在您观看、重定向或完全离开时自主解决问题。这会改变您的工作方式。您不必自己编写代码并要求 Claude 进行审查，而是描述您想要的内容，然后 Claude 弄清楚如何构建它。克劳德探索、计划和实施。但这种自主权仍然伴随着一个学习曲线。 Claude 在您需要了解的某些限制下工作。本指南涵盖了在 Anthropic 内部团队以及跨各种代码库、语言和环境使用 Claude Code 的工程师中已被证明有效的模式。有关代理循环在后台如何工作的信息，请参阅 Claude Code 的工作原理。
大多数最佳实践都基于一个约束：Claude 的上下文窗口很快就会填满，而性能会随着填满而降低。Claude 的上下文窗口保存您的整个对话，包括每条消息、Claude 读取的每个文件以及每个命令输出。然而，这很快就会被填满。单个调试会话或代码库探索可能会生成并消耗数以万计的令牌。这很重要，因为 LLM 性能会随着上下文填充而降低。当上下文窗口变满时，克劳德可能会开始“忘记”之前的指示或犯更多错误。上下文窗口是最重要的管理资源。要了解会话在实践中如何填满，请观看交互式演练，了解启动时加载的内容以及每个文件读取的成本。使用自定义状态行持续跟踪上下文使用情况，并参阅减少令牌使用了解减少令牌使用的策略。
给克劳德一个验证其工作的方法
包括测试、屏幕截图或预期输出，以便克劳德可以检查自己。这是你能做的最有影响力的事情。
当 Claude 能够验证自己的工作（例如运行测试、比较屏幕截图和验证输出）时，它的表现会显着提高。如果没有明确的成功标准，它可能会产生一些看起来正确但实际上行不通的东西。你成为唯一的反馈循环，每个错误都需要你的注意。
| 战略 | 之前 | 之后 |
|---|---|---|
| 提供验证标准 | “实现验证电子邮件地址的功能” | “编写一个 validateEmail 函数。示例测试用例： [email protected] 为 true，invalid 为 false，[email protected] 实施后运行测试” |
| 直观地验证 UI 更改 | “让仪表板看起来更好” | “[粘贴屏幕截图]实现此设计。对结果进行屏幕截图并将其与原始结果进行比较。列出差异并修复它们” |
| 解决根本原因，而不是症状 | “构建失败” | “构建失败并出现此错误：[粘贴错误]。修复它并验证构建是否成功。解决根本原因，不要抑制错误” |
UI 更改可以使用 Chrome 扩展中的 Claude 进行验证。它会在浏览器中打开新选项卡，测试 UI，然后进行迭代，直到代码正常工作。您的验证也可以是测试套件、linter 或检查输出的 Bash 命令。投资让您的验证坚如磐石。
先探索，然后计划，最后编码
将研究和规划与实施分开，以避免解决错误的问题。
让克劳德直接跳到编码可能会生成解决错误问题的代码。使用计划模式将探索与执行分开。推荐的工作流程有四个阶段：
探索
进入计划模式。克劳德阅读文件并回答问题，但不进行任何更改。
克劳德（计划模式）
还要看看我们如何管理机密的环境变量。
计划
请克劳德制定详细的实施计划。
克劳德（计划模式）
我想添加 Google OAuth。需要更改哪些文件？ 会话流程是怎样的？制定计划。
在 Claude 继续之前，按“Ctrl+G”在文本编辑器中打开该计划以便直接编辑。
实施
切换回正常模式并让克劳德编码，验证其计划。
克劳德（普通模式）
根据您的计划实施 OAuth 流程。为 回调处理程序，运行测试套件并修复任何故障。
提交
要求 Claude 提交描述性消息并创建 PR。
克劳德（普通模式）
提交描述性消息并打开 PR
计划模式很有用，但也会增加开销。对于范围明确且修复量较小的任务（例如修复拼写错误、添加日志行或重命名变量），请直接要求 Claude 执行。当您不确定方法、更改修改了多个文件或不熟悉所修改的代码时，计划最有用。如果您可以用一句话描述差异，请跳过该计划。
在提示中提供具体上下文
您的指示越精确，您需要的纠正就越少。
克劳德可以推断意图，但它无法读取你的意思