核心理念

装好工具只是第一步。这一页讲清楚 Claude Code 背后的设计哲学——为什么它要这么设计，你才能用得深、用得稳。

从「氛围编程」到「智能体工程」

社区高赞仓库 claude-code-best-practice 的开篇第一句就是：

From Vibe Coding to Agentic Engineering.

「Vibe Coding」（氛围编程）是 Andrej Karpathy 在 2025 年初造的词——凭感觉、靠运气、对着 AI 喊一句「帮我做个登录页」然后祈祷。Claude Code 不反对氛围编程，但它要更进一步：把开发从「靠感觉」变成「靠工程」。

差别在哪？

氛围编程：随手喊一句，AI 改两下，跑通了收工，跑不通就再喊一句。
智能体工程：先想清楚要做什么，把标准写下来，让 AI 按标准执行，执行结果可验证、可回退、可复现。

一句话：模型一直够强，缺的是模型外面的那个「循环」。 Claude Code 的所有设计，都是围绕「怎么把强模型塞进一个稳定的工程循环」展开的。

上下文窗口是核心资源

这是 Claude Code 心智模型的地基。

Claude Code 给你的上下文窗口大约是 200K token。听起来很大？很快会用满。每读一个文件、跑一次命令、看一段日志，都在往这块「短期记忆」里塞东西。

塞满了会怎样？它会变笨。前面读过的代码它记不清了，刚定的方案它忘了，问它「你刚才说的那个函数叫啥」它会答错。

社区把这条比作「Claude 的短期记忆」——人脑也这样，刚看过的电话号码转头就忘，得靠笔记。Claude Code 的「笔记」就是 /clear、/compact、CLAUDE.md、Subagent 隔离上下文这些机制。管好上下文，是用好 Claude Code 的第一门课。

三层能力：Skills / Subagents / MCP

社区作者 Eyad 在进阶系列里把 Claude Code 的核心能力归纳成三件套，本教程深以为然：

能力	比喻	解决什么
Skills	一份操作手册	让 Claude 在特定任务上「按规矩来」
Subagents	一个独立工位的同事	不污染主上下文，专心干子任务
MCP	一根外接插头	让 Claude 连接外部服务（GitHub、Sentry、数据库…）

三件单看都不稀奇，组合起来才有威力。一个典型配方：

用 MCP 接 GitHub，让 Claude 能读 issue 和 PR
派一个 Subagent 专门做代码审查，独立上下文不抢主流程
给它配一份 Skill，规定审查要查哪几项、用什么风格写评论

Skill + Subagent + MCP = 一个自动化的代码审查系统。 这就是「智能体工程」的样子。

Plan First：先想后做

Claude Code 有个 Plan Mode（按 Shift+Tab 切换），让它只读、不写，先列方案再动手。官方和社区一致推荐：

先探索，再计划，最后动手。

为什么？因为模型一旦开始写代码，就会沿着自己的方向往下走，写到一半发现方向错了很难掉头。让它先在 Plan 模式里把方案列出来，你点头了再切回执行模式，能省掉 80% 的返工。

这跟人脑一个道理——动手写代码之前先在脑子里跑一遍，谁都知道，但谁都不做。Claude Code 把这件事变成了一个键。

把建议变成代码

团队协作里最头疼的是「标准写了没人看，看了没人执行」。Claude Code 给了两个工具：

CLAUDE.md：建议性。每次会话开头 Claude 会读它，但只是「建议」，Claude 可能忘了。
Hooks：强制性。挂在生命周期事件上，100% 执行。

社区有个好比喻：CLAUDE.md 是「贴在墙上的标语」，Hooks 是「门口那个不可贿赂的门卫」。你想让 lint 每次必跑？别写在 CLAUDE.md 里祈求，写进 Hooks 里强制：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "npm run lint && npm run test" }
        ]
      }
    ]
  }
}

这条挂上之后，每次 Claude 改完文件，lint 和 test 都会自动跑，跑挂了它自己看着办。软标准变硬规则，是工程化的关键一步。

模型一直够强，缺的是「循环」

最后回到开头那句话。

2024 年开始，GPT-4、Claude 3.5、Claude 4 一个比一个强，但大家用着用着都觉得「AI 编码不过如此」。为什么？因为强模型塞进糟糕的工作流里，产出还是糟糕。

Claude Code 真正卖的不是模型——模型大家都能调。它卖的是「模型外面的那个循环」：

上下文怎么管理（不要塞满）
标准怎么落地（CLAUDE.md 软 + Hooks 硬）
任务怎么拆分（Subagent 隔离）
外部怎么连接（MCP）
怎么先想后做（Plan First）

把这五件事搭好，弱模型都能跑出像样的活。这就是「智能体工程」的真意。

一句话总结

先探索，再计划，最后动手；把标准写进 CLAUDE.md，把硬规则交给 Hooks。

下一站，去安装与环境配置把它装上。🚀