---
title: "Claude Code 从原理到实战"
description: "12 篇Aaron深度讲解的阅读地图：从 Claude Code 是什么，到上下文、记忆、命令文件、SubAgents、MCP、权限和插件。"
verifiedAt: "2026-05-08"
---

Claude Code 不只是一个终端里的聊天框。理解它的关键，是把它看成一个进入工程现场的 coding agent：它能读项目、执行命令、遵守规则、调用工具，也会被上下文、权限和验证方式约束。

> [!NOTE]
> 这条路线先建立心智模型，再进入可复用能力和权限边界。不要从插件、MCP 或 SubAgents 开始学，先理解 Claude Code 在哪里工作、能看到什么、被什么约束。

这套从原理到实战适合两类人：刚开始用 Claude Code、但还停留在“让 AI 写代码”层面的人；以及已经在用，但想把规则、权限、SubAgents、MCP 和插件串成一套工程方法的人。

## 推荐读法

12 篇分三个阶段，每个阶段解决一类核心问题。**按顺序读**最稳；带着自己的具体问题挑读也行——每篇开头都标注"这一篇用 N 分钟换什么"。

| 阶段 | 篇号 | 核心问题 | 读完能做什么 |
|---|---|---|---|
| **A · 基础心智** | 01-04 | AI 在哪里工作 / 它能看到什么 / 怎么记住你的项目 / 怎么跟它说话 | 不再当 AI 的搬运工，写出能稳定收敛的提示词 |
| **B · 工程化协作** | 05-08 | 思考多深 / 流程怎么复用 / 任务怎么隔离 / 多 Agent 怎么协作 | 把重复工作沉淀成 Skill，把长任务拆给 SubAgent 不污染主桌子 |
| **C · 扩展与边界** | 09-12 | 外部系统怎么接 / 操作怎么自动检查 / 权限怎么管 / 能力怎么打包分发 | 用 MCP 接外部数据源，用 Hooks 守住高危操作，用 Plugin 把团队工具一键分发 |

12 篇之间不是孤立的功能清单，而是一条互相依赖的生长线：

```mermaid
flowchart TB
    Start["你的工程项目"]
    P01["01 位置<br/>AI 住在你电脑里"]
    P02["02 上下文<br/>当前能看到的"]
    P03["03 记忆<br/>跨会话保留的"]
    P04["04 提示词<br/>四件套输入"]
    P05["05 思考深度<br/>effort 旋钮"]
    P06["06 Skills<br/>流程复用"]
    P07["07 SubAgents<br/>上下文隔离"]
    P08["08 Agent Teams<br/>多会话协作"]
    P09["09 MCP<br/>外部系统连接"]
    P10["10 Hooks<br/>到点必查"]
    P11["11 Permissions<br/>访问边界"]
    P12["12 Plugins<br/>打包分发"]

    Start --> P01
    P01 --> P02 --> P03
    P03 --> P04 --> P05
    P05 --> P06 --> P07 --> P08
    P05 --> P09
    P09 --> P10 --> P11
    P11 --> P12
    P06 -.-> P12
    P07 -.-> P12

    style P01 fill:#dcfce7,stroke:#22c55e,stroke-width:2px
    style P06 fill:#fef3c7,stroke:#f59e0b
    style P09 fill:#dbeafe,stroke:#3b82f6
    style P11 fill:#fee2e2,stroke:#ef4444
    style P12 fill:#f3e8ff,stroke:#a855f7,stroke-width:2px
```

实线 = 主线依赖（建议先读）；虚线 = 进阶引用（Plugin 是 Skill / SubAgent 的打包容器）。

## 路线入口

<Cards>
  <Card title="01-04 基础心智" description="先理解 Claude Code 是什么、上下文窗口、记忆和提示词四件套。" href="/docs/claude-code/understanding/01-what-is-claude-code" />
  <Card title="05-08 工程化协作" description="理解 thinking effort、Skills、SubAgents 和多 Agent 协作边界。" href="/docs/claude-code/understanding/05-thinking-depth" />
  <Card title="09-12 扩展与权限" description="进入 MCP、操作控制、权限设计和插件化能力。" href="/docs/claude-code/understanding/09-mcp" />
  <Card title="官方教程" description="需要命令、配置、安装和官方字段时，回官方教程中文版。" href="/docs/claude-code/official" />
</Cards>

## 章节地图

- [01 · Claude Code 是什么](/docs/claude-code/understanding/01-what-is-claude-code)：先搞清楚 AI 住在哪里，为什么 Claude Code 和普通聊天助手不是一类东西。
- [02 · 一次能看多少代码](/docs/claude-code/understanding/02-context-window)：上下文窗口不是“记忆”，而是当前工作台；工作台被堆满后，表现就会变差。
- [03 · 怎么记住你的习惯](/docs/claude-code/understanding/03-memory)：区分短期上下文和长期记忆，理解 Claude 怎么保存偏好与项目事实。
- [04 · 怎么和 AI 说话](/docs/claude-code/understanding/04-prompting)：提示词不是模板游戏，重点是给足目标、上下文、边界和验收方式。
- [05 · AI 怎么决定想多深](/docs/claude-code/understanding/05-thinking-depth)：不同任务需要不同思考深度，别让简单任务过度推理，也别让复杂任务秒答。
- [06 · 把重复的话写成文件](/docs/claude-code/understanding/06-command-files)：把常说的流程沉淀成命令文件，降低重复沟通成本。
- [07 · 派助手去干活](/docs/claude-code/understanding/07-subagents)：SubAgents 不是“开越多越好”，关键是任务能否清晰拆分。
- [08 · 多个 AI 怎么协作](/docs/claude-code/understanding/08-multi-agent)：多 Agent 的难点不是并行，而是接口、上下文和集成责任。
- [09 · 怎么连外部服务](/docs/claude-code/understanding/09-mcp)：MCP 解决“手不够长”的问题，让 Claude 接数据库、浏览器、GitHub 等外部服务。
- [10 · 怎么让操作 100% 执行](/docs/claude-code/understanding/10-operation-control)：靠规则和脚本把必须执行的动作固化下来，不让 AI 只凭记忆。
- [11 · 该给 AI 多少权限](/docs/claude-code/understanding/11-permissions)：权限不是越大越好，也不是越小越安全；要按风险分层。
- [12 · 怎么给 AI 装插件](/docs/claude-code/understanding/12-plugins)：把经验打包成可复用能力，让 Claude Code 从工具变成个人工作系统。

## 读完之后

读完这 12 篇，你应该能回答三件事：

1. **什么任务适合交给 Claude Code**——以及哪类任务它再聪明也做不好（位置 / 上下文 / 权限的硬约束）
2. **要给它哪些上下文和边界**——4 件套（目标 / 上下文 / 边界 / 验收）+ 该写进 CLAUDE.md 的 vs 该临时给的
3. **什么时候该把经验沉淀成文件、SubAgent、MCP 或插件**——也就是从"反复说同样的话"升级到"装成可复用工具"

如果三件事都能回答，再做一道动手题：**打开你当前在用的项目，列出 3 个你最近一周反复跟 AI 说的话**——按本系列的判断标准，每条该写进 CLAUDE.md / SKILL.md / Hook / 提示词模板 哪一个？读完 03 / 06 / 10 / 04 四篇你应该能直接给答案。

## 官方资料

- [Claude Code 官方文档](https://code.claude.com/docs/en/overview) —— 12 篇覆盖的所有概念都在这里有原始定义
- [Anthropic 模型配置](https://code.claude.com/docs/en/model-config) —— 模型别名、effort、上下文窗口的事实基准
- [Claude Code What's New](https://code.claude.com/docs/en/whats-new) —— 版本更新和能力变化

## 接下来去哪

<Cards>
  <Card title="先读第 1 篇" description="从 Claude Code 是什么开始，不要直接跳到高级机制。" href="/docs/claude-code/understanding/01-what-is-claude-code" />
  <Card title="提示词四件套" description="已经会用但经常不稳，先补目标、上下文、边界和验收。" href="/docs/claude-code/understanding/04-prompting" />
  <Card title="SubAgents" description="想并行或隔离脏上下文，再进入子代理篇。" href="/docs/claude-code/understanding/07-subagents" />
  <Card title="权限边界" description="真实项目里最容易出事的是权限，不是模型能力。" href="/docs/claude-code/understanding/11-permissions" />
</Cards>
