Claude Code：Agent 编码的最佳实践

原文链接: https://www.anthropic.com/engineering/claude-code-best-practices 发布日期: 2025 年 4 月 18 日

我们最近发布了 Claude Code，这是一个用于 Agent 编码的命令行工具。作为一个研究项目开发，Claude Code 为 Anthropic 的工程师和研究人员提供了一种更原生的方式，将 Claude 集成到他们的编码工作流程中。

Claude Code 设计理念是低层次且不带偏见，提供接近原始模型的访问，而不强制特定的工作流程。这种设计哲学创造了一个灵活、可定制、可脚本化且安全的强大工具。虽然强大，但这种灵活性为不熟悉 Agent 编码工具的工程师带来了学习曲线——至少在他们开发出自己的最佳实践之前。

本文概述了已被证明有效的通用模式，无论是 Anthropic 的内部团队还是在各种代码库、语言和环境中使用 Claude Code 的外部工程师。这份清单中的内容都不是一成不变的，也不是普遍适用的；将这些建议视为起点。我们鼓励你进行实验，找到最适合你的方法！

想了解更多详细信息？我们在 claude.ai/code 的综合文档涵盖了本文中提到的所有功能，并提供了额外的示例、实现细节和高级技术。

1. 自定义你的设置

Claude Code 是一个自动将上下文拉入提示的 Agent 编码助手。这种上下文收集会消耗时间和 token，但你可以通过环境调优来优化它。

a. 创建 CLAUDE.md 文件

CLAUDE.md 是一个特殊文件，Claude 在开始对话时会自动将其拉入上下文。这使它成为记录以下内容的理想位置：

• 常见的 bash 命令
• 核心文件和实用函数
• 代码风格指南
• 测试说明
• 仓库礼仪（例如，分支命名、merge vs rebase 等）
• 开发环境设置（例如，pyenv use，哪些编译器有效）
• 项目特有的任何意外行为或警告
• 你希望 Claude 记住的其他信息

CLAUDE.md 文件没有固定格式。我们建议保持简洁且易读。例如：

# Bash 命令 - 运行测试：`npm test`
- 构建项目：`npm run build`
- 启动开发服务器：`npm run dev` # 核心文件 - `src/utils/api.ts` - API 辅助函数
- `src/hooks/useAuth.ts` - 认证 hook # 代码风格 - 使用 TypeScript strict 模式
- Prefer functional components
- 使用 ESLint 和 Prettier