AI摘要
本文翻译自官方关于Claude Code 最佳实践的理论总结。文中虽未提供具体实践操作步骤，深度使用Claude Code 完成一个项目后，你就能从该理论中获得大量有价值的经验指导及见解。文中主要介绍Claude Code 是什么及如何工作？其中使用者、Claude Code、AI（LLM）之间协同关系为作者新增的内容，Claude Code 增强你的整个软件产品开发生命周期，环境设置与配置，高效工作流及进阶技巧。
实践中如使用实现截图为Claude提供如何设计指导、同一时间并行多个任务方法，在图形化编码工具如Cursor、Trae、Kiro等编辑器中同样奏效。作者使用该方法在项目开发中将原定三周的工作量提前至一周多完成。实际上Claude Code的能力边界除编码外，涵盖了更为广泛的领域。这在后续文章中会逐一介绍到。本文目录大纲如下：
Claude Code 编码最佳实践
- Claude Code 是什么
- Claude Code 如何工作？
- 使用者、Claude Code、AI（LLM）之间协同关系
3.1. 使用者
3.2. Claude Code（中间层）
3.3. AI/LLM（决策大脑） - 使用 Claude Code 增强你的整个软件产品开发生命周期
4.1. 发现（Discover）
4.2. 设计（Design）
4.3. 构建（Build）
4.4. 部署（Deploy）
4.5. 支持与扩展（Support & Scale） - 环境设置与配置
- 高效工作流
- 进阶技巧
Claude Code 是什么？
Claude Code 是 Anthropic 推出的命令行工具。 Claude Code 就像一个凡事都在终端搞定，从不触碰图形界面的 AI 代理人或AI 工程师。
你给它一个任务，它就像代理人一样，在终端里自主式（理解需求后独立执行）循环：读代码→思考→调用工具（改文件、运行命令、搜索）→检查结果→ 请示关键决策→ 继续执行，直到任务完成。全程没有图形界面。
Claude Code 如何工作？
强大的操作与集成
编辑和创建文件，使用您的 CLI 和 MCP 工具，并创建提交。既能处理像 bug 修复这样的具体任务，也能处理大范围的重构
文件操作：编辑和创建文件
CLI 集成：使用命令行工具
MCP 工具：支持模型上下文协议工具（为大模型提供数据，如：使用查询天气信息、自动化测试等）
Git 操作：创建提交
任务范围：从小型 bug 修复到大范围重构处理
代码库感知
保持对您项目结构的感知。无需手动将文件添加到上下文中——Claude 会根据需要自主搜索您的代码库
智能理解：保持对项目结构的感知
自主搜索：无需手动将文件添加到上下文
按需查找：Claude 根据需要自主搜索代码库
透明性
Claude 展示其工作过程，并使用分层权限系统来平衡权力与控制
可见工作流程：Claude 展示其工作过程
分层权限系统：平衡自动化能力与用户控制权
明确操作意图：用户清楚知道 AI 在做什么
安全性
直连 API：查询直接发送到 Anthropic 模型
无中间服务器：数据不经过第三方
多平台支持：
- Anthropic API（官方）
- AWS Bedrock
- Google Cloud Vertex AI
3.使用者、Claude Code、AI（LLM）之间协同关系
使用者下达任务，LLM（Claude Sonnet 4.5）作为推理引擎通过函数调用（Function Calling）请求工具，Claude Code CLI 作为执行层完成系统调用，三者构成 Agentic AI 架构。
3.1. 使用者（你）
发出需求："帮我修复某个具体需求缺陷 bug"
查看结果和进度
批准敏感操作（文件写入、命令执行等）
3.2. Claude Code（中间层）
功能： 连接用户和 AI 的"执行系统"，职责主要如下：
- 接收你的输入，传递给 AI
- 提供工具集（文件读写、bash 命令、代码搜索、git 操作等）
- 执行 AI 返回的工具调用（实际改文件、运行命令）
- 管理对话历史和上下文
- 把执行结果返回给 AI
- 显示最终结果给你
3.3. AI/LLM（决策大脑）
角色： Claude 大模型（Sonnet 4.5、Opus 4.5、Haiku 4.5 等）职责主要如下：
- 理解你的需求
- 分析代码和上下文
- 决策下一步做什么、用哪些工具
- 生成响应文本
但它不能直接操作你的电脑 → 必须通过 Claude Code 的工具
其使用者启动 Claude Code 提出一个需求后，与 Claude Code、 Claude 大模型（Sonnet 4.5、Opus 4.5、Haiku 4.5 等） 三者之间的协同关系如下：
核心在于：
AI 没有"手"，不能直接碰你的文件 → 必须通过 Claude Code 的工具
Claude Code 没有"脑"，不知道该做什么 → 必须听 AI 的决策
你（使用者/指挥者）是掌控者，可以随时介入、批准或拒绝操作
可简要概括为：Claude Code 是 执行系统，AI是决策大脑，你是下达任务的老板。三者协作完成任务。
4.使用者、Claude Code、AI（LLM）之间协同关系
4.1. 发现（Discover）
探索代码库和历史
搜索文档
a、读取项目文档：自动读取 README、CLAUDE.md、CONTRIBUTING 等
b、Web 搜索：WebSearch 工具查找外部文档和最新技术资料
c、Web 抓取：WebFetch 工具获取特定文档页面内容
入职与学习
- 代码解释：解释复杂函数、模块的工作原理
- 依赖分析：理解函数/模块之间的调用关系
- 最佳实践学习：从代码库中提取现有的编码模式和约定
- 上下文理解：通过 Read 工具深入阅读关键文件
4.2. 设计（Design）
- 规划项目
- 开发技术规范
- 定义架构
4.3. 构建（Build）
- 实现代码
- 编写和执行测试
- 创建提交和 PR
4.4. 部署（Deploy）
- 自动化 CI/CD （持续集成、交付、部署）
- 配置环境
- 管理部署
4.5. 支持与扩展（Support & Scale）
- 调试错误
- 大规模重构
- 监控使用情况和性能
5、环境设置与配置
CLAUDE.md 文件
在战略位置创建这些文件，用于记录命令、风格指南和关键上下文。Claude 在开始对话时会自动将其纳入上下文。包括：
- Bash 命令及其用途
- 核心文件和实用函数
- 代码风格指南
- 测试说明
- 仓库约定（分支、合并策略）
- 开发者环境设置
- 项目特定的警告或行为
- 任何其他上下文信息
这些文件可以放在仓库根目录、父目录（对单一仓库很有用）、子目录或主文件夹（~/.claude/CLAUDE.md）中，以便在所有会话中全局应用。
如使用Claude Code 中 /init 命令扫描代码仓库后，可自动创建 CLAUDE.md 格式提示词文件，可包含构建项目命令、代码分割、工作流等如下：
# Bash 命令
- npm run build: 构建项目
- npm run typecheck: 运行类型检查
# 代码风格
- 使用 ES modules (import/export) 语法，而不是 CommonJS (require)
- 尽可能使用解构导入（例如 import { foo } from 'bar'）
# 工作流
- 完成一系列代码变更后，务必进行类型检查
- 为了性能考虑，优先运行单个测试，而不是整个测试套件
权限管理
精心选择允许的工具，以减少编码会话期间的中断
集成设置
安装像 gh CLI 这样的工具以实现无缝的 GitHub 工作流程，让 Claude 处理版本控制
上下文管理
定期使用 /clear 命令来保持对话的专注性
6、高效工作流
规划和待办事项（Planning and TODOs）
首先要求 Claude 阅读相关文件并制定详细计划。验证 Claude 的待办事项列表。
智能代码审查（Smart vibe coding）
利用测试驱动开发和定期提交，以正确的防护级别来审查代码
使用截图指导和调试（Use screenshots to guide & debug）
使用截图将实现与模型进行比较，并为 Claude 提供关于如何设计的指导
7、进阶技巧
多 Claude 实例与并行化（Multi-Claude & parallelization）
使用独立的实例进行编码、审查和测试。部署工作树或子代理来同时处理复杂问题。如：基于远端git仓库，使用git worktree创建多个分支来并行执行多个任务，任务完成通过后可将分支任务合并到主分支上。
使用 Escape 键（Use escape）
在Claude Code 中plan model 计划模式下，大模型会向使用者澄清怎么做，再使用工具动手实现，这个过程中我们可以使用 Escape 键在适当时机介入或调整任务的方向。从而为使用者节约更多的时间。
平衡让 Claude 工作和在适当的时机介入。按一次 Escape 键停止。按两次 Escape 键跳回对话中。
工具扩展与 MCP（Tool expansion & MCP）
集成 bash 工具、MCP 服务器和自定义斜杠命令。注意：Claude Code 既是 MCP 客户端也是服务器！
无头自动化（Headless automation）
使用 -p 模式进行 CI/CD 流水线和大规模变更
文章来源：https://mp.weixin.qq.com/s/RT_ytL8gpP4044XOzwIRkA
扫码关注作者公众号
