Anthropic 新文章 -「Claude Code: 代理式编程最佳实践」

什么是 Claude Code？
Claude Code 是一个灵活、低层次的命令行工具，提供接近原始模型的访问权限，支持自定义和脚本化，适合各种代码库、语言和环境。它不强制特定工作流程，但需要用户摸索适合自己的使用方法。

💡最佳实践 💡

1. 自定义设置
· CLAUDE. md 文件
- 在存储库根目录创建 CLAUDE. md，记录常用命令、核心文件、代码风格、测试说明等
- 检入 git 共享给团队，或命名为 CLAUDE. local. md 并忽略提交
- 优化内容以提高 Claude 的指令遵循性（可用提示改进器调整）

· 工具权限
- 默认需手动授权修改系统的操作（如文件写入、bash 命令）
- 可通过会话内“始终允许”、/allowed-tools 命令、编辑配置文件或 CLI 标志管理权限

2. 扩展 Claude 的工具
· Bash 工具
- Claude 继承你的 bash 环境，可通过示例、运行 --help 或记录在 CLAUDE. md 中教会它使用自定义工具

· MCP
- 作为客户端连接 MCP 服务器，访问更多工具，可通过配置文件或 .mcp.json 管理

· 自定义斜杠命令
- 在 .claude/commands 文件夹中存储提示模板（如 Markdown 文件），通过 / 访问，支持参数传递（如 $ARGUMENTS）

3. 常见工作流程
· 探索、计划、编码、提交
- 让 Claude 阅读文件、制定计划、编写代码并提交

· 测试驱动开发（TDD）
- 先写测试，确认失败，再写代码通过测试

· 视觉迭代
- 提供设计目标（如截图），让 Claude 迭代直到匹配

· YOLO 模式
- 用 --dangerously-skip-permissions 跳过权限检查，适合快速修复 lint 错误（建议在隔离容器中运行）

· 代码库问答
- 询问代码相关问题，快速学习新项目

· Git 和 GitHub
- 处理 git 操作（如提交历史、消息）和 GitHub 任务（如创建 PR、修复评论）

4. 优化工作流程
· 具体指令：详细说明需求，避免模糊
· 提供素材：粘贴图片、URL 或用制表符补全引用文件
· 及时调整：提前规划、中断或撤销操作，保持方向正确
· 清理上下文：用 /clear 重置无关内容
· 复杂任务：用 Markdown 文件作为清单或便笺
· 数据输入：支持粘贴、管道、读取文件或 URL

5. 无头模式
· 用 -p 标志启用非交互模式，适合 CI、钩子等自动化
· 输出可用 --output-format stream-json 格式化

6. 多 Claude 协作
· 分工：一个写代码，另一个审查或测试
· 多检出：在不同文件夹运行多个 Claude，分配任务
· Git worktrees：在同一存储库检出多分支并行工作
· 自动化集成：用无头模式嵌入大型工作流程

点击图片查看原图