以下是《Claude Code：智能编码最佳实践》一文的中文完整翻译，所有内容均基于 Anthropic 官方文章 (Anthropic)：
发布时间：2025 年 4 月 18 日 (Anthropic)
Claude Code 是一款命令行工具，用于“agentic coding”（智能体式编码）。本文总结了在多种代码库、编程语言和运行环境中，使用 Claude Code 的实践经验与技巧。
Claude Code 最初作为一个研究项目，由 Anthropic 工程师和研究人员开发，用于更原生地将 Claude 集成到日常编码流程中。它的设计思想是低层、无偏好，给予接近原始模型访问的能力，而不强制特定工作流。这种弹性提供了强大而灵活的脚本能力，但也对首次接触智能体编码工具的工程师提出学习门槛。因此，本文列出经过内部与外部用户验证的通用模式，供参考。
注：本文建议作为起点使用，并无固定套路，效果因项目而异。更多细节与示例可参见官方文档 claude.ai/code。 (Anthropic)
1. 定制你的环境
a. 创建 CLAUDE.md 文件
在项目根目录或运行 claude 的目录创建 CLAUDE.md 文件。该文件将自动被 Claude 拉入对话上下文中，可用于记录：
常用的 bash 命令
重要文件与工具函数
代码风格规范
测试方法说明
仓库协作流程（如分支命名、合并策略）
本地开发环境配置
已知异常或警告信息
其他你希望 Claude 记住的信息
建议格式简洁易读，例如：
# Bash Commands
- npm run build：构建项目
- npm run typecheck：运行类型检查
# Code Style
- 使用 ES module（import/export），而非 CommonJS（require）
- 优先解构导入（eg. import { foo } from 'bar'）
# Workflow
- 每次改动后务必进行类型检查
- 优先单测而非全套测试以提升执行速度
CLAUDE.md 可放在仓库根目录、子目录或用户主目录（如 ~/.claude/CLAUDE.md），以控制对话上下文引入的范围。运行 /init 命令时，Claude 会尝试自动生成该文件。 (Anthropic)
b. 调整你的 CLAUDE.md
此文件会被当做提示一部分，因此需要精心打磨。建议不断测试其在 Claude 中的效果，优化指令表达。可以通过 # 快捷键在对话中添加提示，Claude 会自动合并至 CLAUDE.md。Anthropic 还会将该文件输入“提示优化器”进行优化，例如加入强调句“IMPORTANT”或“YOU MUST”以确保严格遵守。 (Anthropic)
c. 管理允许工具列表
默认Claude对所有可能影响系统的操作都会请求授权。你可以通过以下方式调整：
交互式选择“Always allow”
运行
/permissions命令增删工具权限编辑
.claude/settings.json或~/.claude.json启动时使用
--allowedTools标志
这样既能获得安全性，又能提升效率。 (Anthropic)
d. 若使用 GitHub，建议安装 gh 命令行
安装 gh 后，Claude 可直接创建 issue、PR、查看评论等操作。它也可通过 GitHub API 联动，无此工具时仍可工作但体验不如 gh 流畅。 (Anthropic)
2. 扩展工具链
a. 配置 Bash 工具
Claude 会继承你的 shell 环境，包括常见 unix 工具与 gh。对自定义脚本同样有效果，建议：
向 Claude 说明工具名称与用法示例
提示其运行
tool --help查看文档将频繁使用的工具记录到
CLAUDE.md中，以确保持续可访问。
b. 接入 MCP（多英勇代理协议）
Claude Code 可作为 MCP client 与 server 使用，接入如 Puppeteer、Sentry 等外部工具。你可以通过项目配置、全局配置或 .mcp.json 搭建 agent 工具链。同时，--mcp-debug 可帮助诊断配置问题。 (Anthropic)
c. 自定义斜杠命令
将常用流程写入 .claude/commands 文件夹，以 Markdown 模板形式存入（支持 $ARGUMENTS 变量），即可在对话中通过 / 菜单调用。例如修复 GitHub issue、批量调试等。 (Anthropic)
3. 常见工作流
a. 探索 → 规划 → 编码 → 提交
四步策略适用于大多数任务：
让 Claude 阅读文件，暂不写代码（可启用子代理分工）。
生成详细计划（使用
think系念技触发更深思考层级）。按计划编码，并嵌入自检逻辑。
最终 commit 并创建 PR，更新 README 或 changelog。 (Anthropic)
b. TDD（先写测试，再写代码）
逻辑顺序：
指示 Claude 根据 I/O 写测试，不生成 mock 实现。
运行测试，确认失败。
提交测试。
写代码让测试通过，确保不改测试，反复迭代；可用子代理交叉验证。
提交代码。 (Anthropic)
c. 图形化迭代
适用于 UI 开发：
输入设计图（Puppeteer 截图、模拟器或手动贴图）。
让 Claude 按图实现、截屏、对比、反复迭代。
满意后 commit。 (Anthropic)
d. “安全 YOLO” 模式
使用 claude --dangerously-skip-permissions 可跳过权限提示，适合 lint 修复、跳板代码生成。建议在隔离环境或无网络容器中运行以防意外破坏。 (Anthropic)
e. 代码库问答式探索
适合新代码库熟悉过程。可提问题如“logging 是怎么实现的？”，“如何新增 API endpoint？” etc. Claude 会 agentic 搜索并回答，显著提升上手效率。 (Anthropic)
f. Git 操作协助
Claude 可读取 git 历史、撰写 commit 信息、处理 revert、解决冲突、应用补丁等；超过90% 的 Anthropic 工程师使用它完成 git 工作。 (Anthropic)
g. GitHub 操作协助
支持一键生成 PR、修复评论、合并 build 失败、issues 分类和分流，无需记忆 gh 语法。 (Anthropic)
h. 处理 Jupyter 笔记本
Claude 可读写 .ipynb，解析输出图表，并改进视觉效果。建议与 VSCode 并列视窗使用，让 Claude 优化排版与图形表现。 (Anthropic)
4. 优化使用效果
a. 指令要具体
明确说明场景和预期效果。例如“写 foo.py 的测试覆盖登出场景，禁止用 mock”远比“写测试”更有效。 (Anthropic)
b. 提供图像
可通过截图、拖拽或路径输入方式加入上下文，特别适用于 UI mock 与调试图表。 (Anthropic)
c. 指定文件
使用 tab 自动补全文件路径，让 Claude 准确编辑特定资源。 (Anthropic)
d. 提供 URL
在 prompt 中贴入文档链接，并预先 /permissions 授权，让 Claude 可以访问。 (Anthropic)
e. 及时纠偏
即使启用自动模式，建议频繁协调。可输出初步计划，打断或撤销方式调整流程，提高质量与速度。 (Anthropic)
f. 使用 /clear
在会话中断点调用此命令，清理无关上下文，保持性能优良。 (Anthropic)
g. 使用清单与草稿文件
适用于大型任务。可让 Claude 运行 lint 命令，生成 markdown 清单并逐项修复、验证。 (Anthropic)
h. 向 Claude 提供数据
可粘贴日志／CSV，或通过管道 cat foo.txt | claude，或使用工具命令，使其协同处理上下文。 (Anthropic)
5. 在 CI／自动化中以无头模式运行
使用 claude -p（headless），支持 non-interactive 场景（如 CI/pre‑commit/build 脚本）。配合 --output-format stream-json 可获得结构化输出。注意无状态续存，每次运行需重新调用。 (Anthropic)
a. Issue 分流
可在新 issue 创建时自动运行分析并贴标签，用于 triage 流程自动化。 (Anthropic)
b. 代码审查型 lint
可提供比传统 lint 更丰富、主观的 review，如拼写错误、陈旧注释、命名不当。 (Anthropic)
6. 升级为多 Claude 工作流
a. 一写一审
并行启动两个 Claude，一个用来写代码，一个审查。流程可迭代：
Claude A 写代码；
/clear 或 第二终端 启动 Claude B 审查；
Claude B 提 review；
可以第三 Claude 综合 review 和代码再修改。 (Anthropic)
b. 多 checkout
工程师常开 3–4 个代码 checkout，分别在不同分支独立执行任务，并并行运行多个 Claude 会话，再定期切换校验。 (Anthropic)
c. 使用 git worktree
比多 checkout 更轻量。为每个任务创建独立工作区，各 Claude 会话锁定各自上下文，不会冲突。 (Anthropic)
d. Headless 模式 + 自定义脚本
批量处理：由 Claude 生成任务清单，循环执行，如大规模迁移文件；
管道整合：
claude -p "…" --json | your_command接入后续处理步骤。建议调试阶段开启--verbose，线上关掉以简化输出。 (Anthropic)
致谢
本文作者 Boris Cherny，内容综合 Anthropic 及社区最佳实践，特别感谢 Daisy Hollman、Ashwin Bhat、Cat Wu、Sid Bidasaria、Cal Rueb、Nodir Turakulov、Barry Zhang、Drew Hodun 等提供宝贵反馈。 (Anthropic)
如你还有更多使用心得或建议，欢迎 tag @AnthropicAI 分享！