精通 Claude Code：来自 Anthropic 的官方最佳实践

Anthropic 的 claude-code 是一款前沿的命令行工具，旨在将 Claude 的强大语言模型能力深度集成到开发者的日常工作流中。它并非一个简单的代码补全工具，而是一个强大的“代理式”编程伙伴，能够理解上下文、使用工具、执行命令，并与开发者协作完成复杂的软件工程任务。为了帮助用户最大化其效能，Anthropic 官方分享了一系列被证明行之有效的最佳实践。

1. 个性化你的工作环境

高效使用 Claude Code 的第一步，是从精心配置你的工作环境开始。

  • 创建 CLAUDE.md 文件: 这是最重要的实践。在你的项目根目录下创建一个 CLAUDE.md 文件，Claude 会在每次启动时加载它。这相当于为 Claude 提供了一份项目入职手册，使其能迅速理解你的需求。一个好的 CLAUDE.md 文件应该简洁且信息丰富。

  • 管理工具权限: 出于安全考虑，Claude Code 在执行文件写入或特定 shell 命令前会请求许可。你可以通过在会话中选择“总是允许”，或使用 /permissions 命令，将你信任且安全的操作加入白名单。例如，如果你频繁使用 pytest，将其加入白名单后，Claude 在运行测试时便不会再三询问。

  • 集成 GitHub CLI: 如果你的工作流深度依赖 GitHub，安装 gh 命令行工具能让 Claude 更流畅地处理创建 issue、发起拉取请求（PR）等任务。

2. 为 Claude 配备更多工具

Claude 的能力不止于其内置功能，它能充分利用你本地的工具生态。

  • 利用 Bash 工具: Claude 可以直接访问你终端环境中的所有工具。例如，如果你有一个自定义的部署脚本 deploy-to-staging.sh，你可以在 CLAUDE.md 中简单描述它：deploy-to-staging.sh: deploys the current branch to the staging environment. Claude 在接收到相关指令时，便会知道如何使用这个脚本。

  • 连接 MCP 服务: 通过元代理通信协议（MCP），Claude Code 可以作为客户端连接到任意数量的 MCP 服务器。这使其能执行更复杂的操作，例如通过连接 Puppeteer 服务来控制浏览器（“请截图登录页面”），或通过连接 Sentry 服务来分析错误（“总结一下过去24小时最常见的五个生产环境错误”）。

  • 自定义斜杠命令: 对于重复性的工作流，你可以将提示模板保存在 .claude/commands 文件夹中。例如，创建一个名为 debug.md 的文件，内容是一个用于调试的详细提示。之后，在聊天中只需输入 /debug，即可快速调用整个工作流。

3. 探索高效的工作流模式

灵活的工作流是 Claude Code 的一大魅力，社区已沉淀出几种非常高效的模式。

  • 探索、规划、编码、提交: 这是最通用的模式。通过分步指令引导 Claude 完成任务。

    1. 探索: 我想为用户资料添加一个新的 API 端点。请先研究一下项目中现有的 API 是如何构建的。
    2. 规划: 好的，现在请为这个新端点提出一个详细的实现计划，包括需要修改哪些文件。
    3. 编码: 计划看起来不错，请开始编写代码。

  • 测试驱动开发 (TDD): 这在代理式编程中极为强大，因为它为 AI 提供了清晰的目标。

    1. 编写失败的测试: 请为 utils.py 写一个新的 pytest 测试用例，测试一个名为 calculate_sum 的函数。确保测试包含一个空列表的场景，此时函数应返回 0。
    2. 编写通过测试的代码: 在确认测试会失败后，发出指令：现在，请编写 calculate_sum 函数的实现代码，使其能通过刚刚创建的测试。

  • 可视化迭代: 为 Claude 提供视觉目标，尤其适用于前端开发。你可以粘贴一张理想 UI 样式的截图，并指示：请更新我们主页上按钮的 CSS，使其样式与这张截图中的按钮完全一致。

  • 代码库问答 (Q&A): 在接触新项目时，把 Claude 当作一位资深同事。直接提问，而非手动搜索：这个项目的数据库连接是在哪里配置的？ 或 请向我解释一下用户认证的完整流程。

4. 优化你的指令与交互

清晰的沟通和及时的引导能让 Claude 的表现再上一个台阶。

  • 指令要具体: 模糊的指令效果不佳。避免使用“添加测试”，而是给出明确的要求：“请为 user_model.py 中的 update_password 方法添加一个新的单元测试，专门覆盖密码过短时应抛出 InvalidPasswordError 的场景。”

  • 及时纠偏与迭代: Claude Code 提供了为快速迭代而生的交互设计。如果你在 Claude 执行任务中途发现指令有误，无需等待它完成。

    • 中断任务 (Escape): 按 Escape 键可以立即中断当前任务。
    • 编辑上一步 (Double-Escape): 这是其独特的亮点。快速连按两次 Escape 键，不仅能中断任务，还会将你上一条指令重新加载到输入框中，让你能够立刻修改并重新提交。这个功能极大地提升了修正和迭代的效率。

5. 自动化与高级工作流

Claude Code 的能力不止于交互式使用，它还能融入自动化流程。

  • 无头模式 (Headless Mode): 使用 -p 参数可以在非交互式环境（如 CI/CD 流水线）中运行 Claude。例如，你可以设置一个 Git 钩子，在每次提交时自动运行 Claude，为新增的函数生成或更新文档字符串。

  • 多 Claude 协作: 对于大型复杂任务，可以尝试“多 Claude”工作流。想象一下，你打开两个终端窗口：

    • 终端A: Claude，你是首席开发者。你的任务是在 feature-x 分支上实现核心业务逻辑。
    • 终端B: Claude，你是质量保证工程师。你的任务是持续监控 feature-x 分支，并为任何新添加的代码编写测试用例。

6. gemini-cli的相似之处

值得注意的是，由 claude-code 所引领的这种深度集成、基于上下文的代理式命令行工具范式，正在成为行业趋势。后续出现的同类工具，如 Google 的 gemini-cli，在很大程度上也继承了这些核心思想。无论是通过一个特殊的 .md 文件来建立项目记忆（GEMINI.md），还是对测试驱动开发（TDD）等工作流的强调，都体现了这些最佳实践的普适性和有效性。因此，掌握 Claude Code 的实践方法，不仅能让你精通这款工具，也为驾驭未来更多 AI 编程助手打下了坚实的基础。

参考资料

欢迎关注+点赞+推荐+转发