Claude Code 完全教程:从 CLI 助手到 Agent 工程与一人公司产品化
把 Claude Code 从玄学变工程。不堆命令,讲原理;不凭感觉,给配置;面向真实工程,照做即可落地;直面失败,给补救。
一本面向开发者、一人公司与 Agent 工程师的 Claude Code 完整教程。全书以"原理优先"组织——先建立架构、上下文、权限、工具的底层认知,再用可执行闭环把 Claude Code 从问答工具升级为可验证工程代理,最终进阶到多智能体编排与一人公司产品化。
- 规模:约 15 万字,32 章,6 部分 + 附录
- 版本基准:Claude Code v2.1.202+(2026-07-08 核对),Opus 4.8 / Fable 5
- 定位:既可从头通读建立体系,也可案头按需查阅
全书目录
前言:把 Claude Code 从玄学变工程
本书定位、承诺、适合读者、使用方法、核心理念。
第一部分 · 入门篇 — 从零到第一个项目
| 章 | 标题 | 链接 |
|---|---|---|
| 01 | 什么是 Claude Code | 进入 |
| 02 | 安装与订阅 | 进入 |
| 03 | 第一次对话 | 进入 |
| 04 | CLAUDE.md 与上下文入门 | 进入 |
| 05 | 权限模型入门 | 进入 |
第二部分 · 工程篇 — 可验证工程代理
| 章 | 标题 | 链接 |
|---|---|---|
| 06 | 核心心智模型与命令真实性 | 进入 |
| 07 | Plan Mode:计划优先 | 进入 |
| 08 | 精准指令与任务拆分 | 进入 |
| 09 | 遗留代码重构与 Bug 修复 | 进入 |
| 10 | 全栈功能开发 | 进入 |
| 11 | 上下文管理进阶 | 进入 |
| 12 | Token 控本与故障恢复 | 进入 |
| 13 | Git 工作流与 Code Review | 进入 |
第三部分 · 扩展篇 — 配置与扩展能力
| 章 | 标题 | 链接 |
|---|---|---|
| 14 | Hooks 系统 | 进入 |
| 15 | MCP 服务器 | 进入 |
| 16 | Skills 与自定义命令 | 进入 |
| 17 | Status Line / Output Style / 主题 | 进入 |
| 18 | 调试与排障实战 | 进入 |
第四部分 · Agent 工程篇 — 多智能体与编排
| 章 | 标题 | 链接 |
|---|---|---|
| 19 | Subagents | 进入 |
| 20 | Dynamic Workflows 与 Ultracode | 进入 |
| 21 | Claude Agent SDK | 进入 |
| 22 | Managed Agents | 进入 |
| 23 | 三家架构哲学对比 | 进入 |
| 24 | Agent 产品可复用骨架 | 进入 |
第五部分 · 实战案例篇 — 真实项目
| 章 | 标题 | 链接 |
|---|---|---|
| 25 | 代码安全审查实战 | 进入 |
| 26 | 红队对抗式审查 | 进入 |
| 27 | RAG 与 Agent 项目 | 进入 |
| 28 | 内容生产工作流 | 进入 |
第六部分 · 产品化与一人公司篇
| 章 | 标题 | 链接 |
|---|---|---|
| 29 | 接单开发网站 | 进入 |
| 30 | 一人公司系统性框架 | 进入 |
| 31 | 备份与迁移 | 进入 |
| 32 | 多模型与成本策略 | 进入 |
附录 · 速查手册
命令真实性总表、设置文件层级与字段、权限规则语法、Hook 事件全表、Skills/Commands frontmatter、常见报错速查、版本与新功能时间线、官方资料。
合并版全书
单文件完整版,适合离线阅读与打印。
如何使用本书
如果你是新手:按目录顺序通读第一部分建立认知底座(架构、安装、交互、CLAUDE.md、权限),再进入第二部分掌握可执行闭环。遇问题查第 18 章排障与附录 F 报错速查。
如果你是有经验的开发者:直接读第 06 章核心心智模型与命令真实性表,然后按第二、三部分把 Claude Code 落到工程闭环。第四部分按需深入。
如果你是 Agent 工程师 / 一人公司:可跳过入门篇,直接进入第四部分 Agent 工程篇,辅以第五部分实战案例与第六部分产品化。第 23 章三家架构对比与第 24 章产品骨架是选型决策的底层框架。
案头查阅时:附录的命令真实性总表、Hook 事件全表、frontmatter 字段速查建议常驻手边。
约定
- 命令真实性:本书严格区分官方内置命令与自定义 skill。内置命令标注"内置",自定义命令标注来源。不把自定义伪装成内置。
- 版本基准:2026-07-08 核对,Claude Code v2.1.202+。版本敏感信息标注核对日期;
research preview/beta功能(Workflows、Ultracode、Managed Agents、Auto Mode 部分、Agent Teams)明确标注。 - 终端转录:标注为"示例"的终端对话是说明性模拟,不暗示来自真实仓库。
- 语言:中文叙述,命令、代码、路径、配置键、frontmatter 字段用英文。
与市面同类书的差异
本书不追求穷尽所有命令(那是官方文档的职责),而是提供三条独特价值:
- 2026 新功能深度。Dynamic Workflows 脚本编写、Ultracode 架构原理、Managed Agents 云端部署、Fast Mode、Auto Mode、Agent Teams——多数现有资料停留在 Skills/Subagent 基础,本书深挖这些仍在 preview/beta 但已可用的能力。
- 独家实战素材。20+ 真实项目的代码安全审查(带 CRIT/HIGH/MED/LOW/P0 风险分级)、Claude Code/Codex/Cursor 三家架构哲学对比、Agent 产品可复用骨架、红队对抗式审查工作流——这些来自一线实践,任何市面书都没有。
- 一人公司产品化视角。不只教写代码,还教用 Claude Code 接单交付、做产品调研、构建 Agent 产品、备份迁移、多模型成本策略——面向把工具变成生意的超级个体。
人机协作的最优模式是:人定方向,机器填细节。本书所有章节都朝着这个方向用力。
本书成稿于 2026 年 7 月。Claude Code 迭代极快(2025 年发布 176 次更新),请以官方文档为准。理解了原理,命令随它变。