本次分享聚焦于 Claude Code 的使用技巧和最佳实践，展示了 Claude Code 如何赋能软件开发全生命周期。文章强调了 Claude Code 的心智模式，将其比喻为只使用终端的同事，并阐述了其通过“Agentic Search”而非代码索引来感知代码库的工作原理。文中提供了诸如使用 claude.md 文件进行跨会话共享、优化权限管理、集成更多 CLI 工具、以及有效的上下文管理（如 /clear 和 /compact 命令）等具体实践方法。此外，还介绍了高级技巧，如并行运行多个 Claude 实例、通过 Escape 键中断和调整 Claude 行为，以及利用 Headless SDK 实现自动化集成。文章还涵盖了现场 QA，解答了关于多个 claude.md 文件、模型指令遵循以及多智能体协作等用户关心的问题，为开发者提供了 Claude Code 的高效使用指南。

📝 **Claude Code 的心智模式与代码库感知**：Claude Code 被设计成类似只使用终端的开发者，它不依赖代码索引，而是通过“Agentic Search”模拟团队新人，利用 glob、grep、find 等工具搜索代码库，从而理解项目结构和实现方式。这种方式使其能在软件开发的整个生命周期中提供帮助。

📄 **claude.md 文件与初始化设置**：使用 `claude.md` 文件是实现跨会话和团队共享状态的关键。用户可以通过 `/init` 命令生成此文件，并在其中定义项目布局、测试文件位置、代码风格指南等信息，使 Claude 在开始工作时能自动加载这些配置，确保工作的一致性。

⚙️ **权限管理与集成增强**：Claude Code 默认允许读操作，但写操作需要用户确认。为了提高效率，用户可以通过 `auto-accept` 模式或配置特定命令来简化写操作流程。此外，通过安装更多 CLI 工具（如 GitHub 的 `gh` 工具）可以增强 Claude 的能力，使其能够处理更广泛的任务。

🔄 **上下文管理与高效工作流**：Claude Code 的上下文会随着工具调用累积，可以使用 `/clear` 命令重置，或 `/compact` 命令让 Claude 总结当前会话以压缩上下文。更重要的是，在执行具体任务前，可以先让 Claude 搜索代码库并提出计划，或遵循测试驱动开发（TDD）模式，甚至使用截图进行引导和调试，从而优化工作流程。

💡 **高级技巧与多智能体协作**：文章还分享了高级技巧，如可以并行运行多个 Claude 实例来处理不同任务，以及通过按两次 `Escape` 键来中断 Claude 并进行干预。对于多智能体协作，当前最佳实践是通过文件共享状态，未来可能探索更原生的协作功能。

Presented at Code w/ Claude by ‪@anthropic-ai‬ on May 22, 2025 in San Francisco, CA, USA. Speakers: Cal Rueb, Member of Technical Staff at ‪@anthropic-ai‬

原视频：Claude Code best practices

国内搬运：Claude Code 最佳实践 | Code w/ Claude 大会

Claude Code 心智模式

Claude 就像是那些只用 Terminal 从来不用 GUI 工具的同事

Codebase 感知

Claude Code 没有做 codebase indexing，而是通过“Agentic Search”的方式，其工作原理更像是团队新人，利用 glob、grep、find 去搜索。搜索过程模型来决策

Claude Code 在全软件开发周期都有帮助

让 Claude Code 先 plan 再执行，作者在演讲中脱口而出的提示词

I'm thinking about implementing this feature. Can you just kind of like search around and kind of figure out how we would do it and maybe report back with like two or three different options. Don't start working, don't start writing any files yet.

最佳实践

使用 claude.md 文件: 这是一个跨会话和团队共享状态的关键工具。你可以将项目布局、测试文件位置、代码风格指南等信息放在这个文件中，让 Claude 在开始工作时自动加载。第一次可以使用/init命令生成。权限管理: Claude 默认对读操作放行，但写操作需要确认。你可以通过 auto-accept 模式或配置特定命令来提高效率。集成设置: 利用 Claude 擅长终端的特点，安装更多的 CLI 工具（如 GitHub 的 gh 工具），让 Claude 能够处理更多任务。上下文管理: Claude 的上下文会随着工具调用而不断累积。可以使用 /clear 命令清除所有内容重新开始，或使用 /compact 命令让 Claude 总结当前会话，从而压缩上下文。高效工作流: 在让 Claude 修复 bug 或开发功能前，可以先让它搜索代码库并提出一个计划。也可以让 Claude 遵循测试驱动开发（TDD）模式，并使用截图进行引导和调试。高级技巧:
可以同时运行多个 Claude 实例并行处理任务使用 Escape 键叫停 Claude Code 并插话，对其行为做出调整，连续按两次回到对话开始处，相当于重置通过 Headless SDK 整合自动化流程，如在 GitHub Actions 中调用 Claude 进行持续集成或自动部署

因为演讲是在 5.22，到今天视频中介绍的 /model、/config 以及在两次工具调用间思考已经被大家所熟知

现场 QA

问：一个项目里可以有多个 claude.md 文件吗？

答：在同一个目录下不行。Claude 启动时只读取当前工作目录下的 claude.md。为避免在单一代码库中上下文爆炸，它不会默认读取子目录的 claude.md。但你可以在主 claude.md 中用@符号引用其他文件，或者在启动 Claude 时，鼓励它去搜索并阅读相关子目录中的 claude.md。

问：我让 Claude 遵守 claude.md 里的指令，但它不听怎么办？

答：这是一个典型的模型行为问题，尤其在旧模型上更常见。好消息是新一代模型在遵循指令方面的能力已大幅提升。我们收到的反馈显示，用户普遍感觉 claude.md 的指令在新模型上被遵守得更好了。建议您升级模型，并借此机会重新审视和优化 claude.md 文件。

问：可以实现多智能体并行执行，并让它们共享上下文吗？

答：目前我们的理念是专注于打造一个极度强大的单一智能体。对于多智能体协作，今天的最佳实践是通过文件进行状态同步。你可以让一个智能体将其中间结果或状态写入一个共享文件，然后让另一个智能体去读取这个文件，从而实现间接的协作。未来我们可能会探索更原生的多智能体协作功能。

可以看下全文稿：soraor.com/archives/ai…