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...