古法编程

Claude Code最佳实践的核心是构建可复用、可组合的代理工作流，而非零散的提示技巧。本指南基于官方最佳实践仓库，系统梳理了从基础配置（Settings、Memory）到高级编排（Command → Agent → Skill）的核心概念，并对比了社区主流的开发工作流，帮助开发者从随意的“Vibe Coding”转向结构化、可维护的“Agentic Engineering”。

Claude Code Best Practice 完整指南：从 Vibe Coding 到 Agentic Engineering

Claude Code 的强大不仅在于它能写代码，更在于它可以通过一套丰富的扩展点被塑造成你专属的自动化开发引擎。从 Vibe Coding（随性、基于提示的交互）迈向 Agentic Engineering（系统化、可组合的代理工程），关键在于理解和实践其 最佳实践。本文将作为你的导航地图，概述核心概念、当前热点以及社区验证的开发工作流。

核心扩展体系：构建你的代理能力

Claude Code 的能力并非一成不变。通过在其项目目录下配置特定文件和结构，你可以为其注入新的技能和工作模式。这构成了一个分层、可扩展的架构，其核心组件如下表所示：

核心概念 配置位置 核心作用
子代理 (Subagents) .claude/agents/<name>.md 定义专注于特定领域的代理，可拥有独立的技能、模型和权限，用于隔离任务上下文。
命令 (Commands) .claude/commands/<name>.md 创建可复用的斜杠命令（如 /goal、/ultrareview），作为复杂工作流的入口点。
技能 (Skills) .claude/skills/<name>/SKILL.md 定义可组合的知识或操作模块，可被命令或子代理调用，实现逻辑复用。
工作流 (Workflows) 组合上述组件 通过编排命令、代理和技能，实现多步骤的自动化开发流程。
钩子 (Hooks) .claude/hooks/ 在 Claude Code 生命周期事件（如工具调用前后）注入自定义脚本，实现自动化检查或通知。
设置 (Settings) .claude/settings.json 配置全局或项目级的权限、模型偏好、输出样式等基础行为。
记忆 (Memory) CLAUDE.md, .claude/rules/ 提供持久化的上下文指令，引导 Claude 理解项目结构、编码规范和特定要求。

这些组件并非孤立存在，而是遵循一个清晰的 Command → Agent → Skill 架构模式进行协作。一个典型的编排工作流是：命令作为入口，收集用户输入并调度流程；子代理负责执行具体任务（如数据获取、分析）；技能则为代理提供执行所需的详细知识和步骤。想要深入了解这个架构的细节，可以参阅 Claude Code 编排工作流实战。

当前热点功能与新范式

Claude Code 的功能迭代迅速，许多新特性正在重塑开发体验。以下是社区和官方关注的热点：

  • 代理团队 (Agent Teams)：允许你同时运行多个独立的 Claude Code 实例（通常配合 tmux 和 Git Worktrees），在隔离的上下文中并行处理不同任务，极大提升开发吞吐量。
  • 自动模式 (Auto Mode)：通过 --permission-mode auto 或 Shift+Tab 切换。在此模式下，Claude 会尽可能自主地完成任务，仅在需要重大决策时才请求确认，适合执行明确、低风险的任务。
  • 浏览器自动化 (Chrome)：通过 --chrome 标志或专用的 MCP 服务器，让 Claude Code 能够操作浏览器，进行前端调试、自动化测试或数据抓取。
  • 定时任务 (Scheduled Tasks)：利用 /loop、/schedule 等命令，让 Claude Code 定期执行维护、监控或报告生成任务。
  • 超级审查 (Ultrareview) 与 超级计划 (Ultraplan)：这两个处于 Beta 阶段的命令，分别专注于提供深度、全面的代码审查和生成极其详细的实施计划。

这些特性共同指向一个趋势：Claude Code 正从一个对话式助手，演变为一个能够自主执行、并行工作、并深度集成到开发和运维环境中的 代理运行时。

社区实践：主流开发工作流对比

社区已经探索并验证了多种基于 Claude Code 的代理工程工作流。它们大多遵循 研究 → 计划 → 执行 → 审查 → 交付 的宏观结构，但在具体实现和组件选择上各有侧重。下表对比了几个星标数较高的代表性项目：

工作流名称 GitHub 星标 工作流步骤概要 子代理数 命令数 技能数
Superpowers 206k 头脑风暴 → 使用 Git Worktrees → 编写计划 → 子代理驱动开发 → 测试驱动开发 → 请求代码审查 → 完成前验证 → 完成开发分支 0 0 14
Everything Claude Code 192k /ecc:plan → /tdd → /code-review → /security-scan → /e2e → merge 48 143 230
Matt Pocock Skills 104k /grill-with-docs → /to-prd → /to-issues → /triage → /tdd → /diagnose → /improve-codebase-architecture → /zoom-out 0 0 28
gstack 102k /office-hours → 多轮评审 (plan-ceo-review, plan-eng-review, plan-design-review) → 设计与实现 (design-shotgun, design-html) → /codex → /qa → /ship → /retro 0 0 47
Get Shit Done 64k /gsd-new-project → /gsd-discuss-phase → /gsd-plan-phase → /gsd-execute-phase → /gsd-verify-work → /gsd-ship → /gsd-complete-milestone 33 96 0

注：黄色标签表示子循环（例如每个任务、每个故事或直到验证条件通过都会重复的步骤）。

选择哪种工作流取决于你的项目阶段、团队习惯和对控制粒度的要求。例如，Everything Claude Code 提供了极其丰富的预定义命令和代理，适合希望“开箱即用”的团队；而 Superpowers 则更侧重于利用子代理和技能进行并行开发，适合大型功能的高效实现。无论选择哪种，其核心思想都是将模糊的需求转化为由明确命令、专用代理和可组合技能构成的结构化流水线。

如何开始你的 Agentic Engineering 之旅

  1. 从记忆与设置开始：首先写好你的 CLAUDE.md，明确项目上下文和基础规则。然后配置 .claude/settings.json，设置好权限和偏好。这是所有工作的基石。
  2. 将常用操作命令化：观察你反复对 Claude 提出的指令（如代码审查、生成测试），将其封装成 .claude/commands/ 下的斜杠命令。
  3. 为复杂任务创建子代理：当某个命令涉及多个步骤或需要隔离上下文时，为其创建专门的子代理（.claude/agents/），并为其配备必要的技能。
  4. 利用钩子自动化：在关键节点（如提交代码前）设置钩子，自动执行格式化、检查或通知。
  5. 迭代和优化：监控你的会话上下文使用率，在约 50% 时考虑使用 /compact 或开启新会话。根据效果调整你的代理和技能定义。

要深入了解命令、技能和子代理的具体字段与最佳写法，可以分别查阅 Claude Code Commands 指南 和 Claude Code Skills 深度解析。

FAQ

Q: Claude Code 的“最佳实践”和 IDE 插件（如 Copilot）有什么区别？ A: 核心区别在于 可编程性。IDE 插件主要提供内联补全和简单对话。而 Claude Code 最佳实践体系允许你通过子代理、命令、技能、钩子等机制，将 Claude 深度塑造成符合你项目特定流程和规范的、可复用、可组合的自动化系统，它更像一个你定制开发的“工程引擎”。

Q: 作为新手，我应该从哪个实践开始？ A: 从编写一个清晰、精简的 CLAUDE.md 文件开始。明确告诉 Claude 你的项目结构、如何构建和运行测试、以及主要的编码风格。这是成本最低、收益最高的投资，能立即改善所有对话的质量。

Q: 什么是 Command → Agent → Skill 架构？ A: 这是一种工作流编排模式。命令（Command）是用户触发的入口，负责协调；代理（Agent）是执行具体任务的单元，可以拥有独立技能和上下文；技能（Skill）是可复用的知识或操作模块，供代理或命令调用。这种模式实现了关注点分离和逻辑复用。

本系列文章

Repository overview and entry point — the README CONCEPTS table, project structure, and high-level guide to all Claude Code features documented in this repo.

核心最佳实践参考文档，涵盖 Claude Code 的所有主要配置和扩展机制：settings、commands、skills、subagents、memory、MCP、CLI 启动标志、Power-ups。

Command → Agent → Skill 编排模式的完整实现和流程图，以天气系统为运行示例。

Agent Teams 多智能体协作示例——用 agent team 从零构建时间编排工作流。

Claude Code 各核心功能的具体实现文档，展示如何在项目中落地 Agents、Commands、Skills、Goals、Scheduled Tasks、Agent Teams。

深度分析报告，涵盖 Agent/Command/Skill 区别、CLI vs SDK 系统提示、全局 vs 项目级设置、浏览器自动化对比、技能发现机制等。

来自 Boris Cherny（Claude Code 创始人）和 Thariq 的实用技巧集合，涵盖日常工作流、自定义配置、隐藏功能、Skills 实战、会话管理等。

Boris Cherny 和其他专家在播客、会议上的访谈/演讲转录，涵盖 Claude Code 创作故事、工作流哲学、行业趋势。

跨平台声音通知 Hook 系统的完整文档——支持 27 种 hook 事件、Python 脚本、配置管理、Agent frontmatter hooks。

高级开发工作流——跨模型（Claude Code + Codex）协作和 RPI（Research-Plan-Implement）系统化开发流程。