Claude Code 从原理到实战

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

这条路线先建立心智模型，再进入可复用能力和权限边界。不要从插件、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 篇之间不是孤立的功能清单，而是一条互相依赖的生长线：

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 的打包容器）。