Coding Agent 最佳实践

Coding Agent 最佳实践

原文：Claude Code: Best practices for agentic coding | Anthropic | 2025.4.18

导语

Claude Code 是目前最强大的 Coding Agent 之一。但工具再强，用法不对也白搭。

这篇文章汇总了 Anthropic 内部实战经验，从提示词技巧到项目配置、从工作流设计到团队协作，帮你把 Claude Code 的能力榨干。

---

一、提供有效的上下文

CLAUDE.md 文件

在项目根目录创建 CLAUDE.md，告诉 Claude 关于你项目的关键信息：

# 项目信息

- 技术栈：React + TypeScript + Tailwind
- 包管理器：pnpm
- 测试框架：Vitest
- 代码风格：使用 Prettier，单引号

# 常用命令

- `pnpm dev` - 启动开发服务器
- `pnpm test` - 运行测试
- `pnpm lint` - 代码检查

# 架构约定

- 组件放在 src/components/
- API 路由放在 src/api/
- 使用 Zustand 管理状态

有效的提示技巧

• 具体：不说"优化这段代码"，说"将这个 O(n²) 的排序优化为 O(n log n)"
• 提供上下文：说明为什么要做这个改动，而不仅是要做什么
• 分步骤：复杂任务拆解为子任务
• 使用规划模式：按 Shift+Tab 让 Claude 先输出方案再编码

---

二、高效的工作流

探索 → 规划 → 编码 → 验证

1. 探索：让 Claude 先理解代码库结构
2. 规划：让 Claude 输出实现方案（不写代码）
3. 编码：确认方案后再开始实现
4. 验证：运行测试、检查 lint、手动验证

深度思考指令

在提示词中使用以下关键词触发更深入的思考：

• think - 基础思考
• think hard - 深度思考
• ultrathink - 最深层次思考

管道操作

# 让 Claude 解释代码
cat app.py | claude -p "解释这段代码"

# 代码审查
git diff main | claude -p "审查这些变更"

# 生成提交信息
git diff --staged | claude -p "为这些变更生成规范的提交信息"

---

三、项目配置最佳实践

分层配置

• 全局 CLAUDE.md：通用规则（代码风格、提交规范）
• 项目 CLAUDE.md：项目特定信息
• 目录 CLAUDE.md：子模块特定约定

权限管理

• 默认只读模式——确保安全
• 使用 --dangerously-skip-permissions 跳过权限确认（仅用于可信环境）
• 使用 /sandbox 启用沙箱模式

---

四、团队协作

共享配置

将 CLAUDE.md 加入版本控制，确保团队成员使用一致的 Agent 配置。

代码审查集成

# 自动化代码审查
git diff main | claude -p "审查代码，重点关注：
1. 安全漏洞
2. 性能问题
3. 代码风格一致性"

CI/CD 集成

将 Claude Code 集成到 CI 流程中，自动生成测试、检查代码质量。

---

五、常见陷阱与避免方法

陷阱	避免方法
提示太模糊	提供具体、可量化的要求
一次让 Claude 做太多	拆分为小任务，逐步完成
不验证 Claude 的输出	始终运行测试和 lint
忽略 CLAUDE.md	维护好项目配置文件
不使用规划模式	复杂任务先规划再编码

---

六、进阶技巧

多文件重构

帮我将 src/utils/ 目录下所有使用 moment.js 的文件迁移到 dayjs。
请先列出需要修改的文件，然后逐一修改，每个文件修改后运行测试确认。

调试辅助

这个测试失败了：[粘贴错误信息]
请分析原因并修复。修复后确保所有测试通过。

代码生成

根据以下 API 规范，生成完整的 CRUD 接口：
- 资源：User
- 字段：id, name, email, role
- 包含：路由、控制器、service、验证、测试

---

读后感

Claude Code 最佳实践的核心是一个简单的道理：你给 Agent 的上下文质量，直接决定了 Agent 的输出质量。

花 10 分钟写好 CLAUDE.md，可能比花 1 小时调提示词更有效。

---

本文是 Anthropic AI Agent 系列 第 14 篇，共 15 篇。下一篇：Agent 故障复盘：三个真实案例分析

关注公众号 coft 获取系列更新。