免费技术书 · 中文全六卷Claude Code 详解一本系统深入讲解 AI 代理式编程工具的中文技术书随着 AI 编码工具成为程序员的日常一本从入门到精通的中文系统教程变得尤为珍贵。本文为你带来这本免费开源的《Claude Code 详解》完整目录一并奉上。本书为作者自己撰写现免费提供下载阅读可以参考“微邮互动”公众号中对应文章获取下载地址内容提要本书是一本系统深入讲解Claude Code的中文技术书籍。Claude Code 是 Anthropic 推出的 AI 代理式编程工具凭借强大的推理能力、丰富的扩展机制Skills、Hooks、Subagent、MCP和灵活的权限系统已成为开发者日常使用最广泛的 AI 编码工具之一。全书共 6 章完整覆盖 Claude Code 的全部核心能力第 1 章基本概念与快速上手第 2 章深入 CLAUDE.md 项目记忆与权限系统第 3 章梳理 55 内置斜杠命令与会话管理技巧第 4 章讲解 Skills 与自定义命令开发第 5 章覆盖 30 个 Hook 事件的自动化实战第 6 章介绍 Subagent、Worktree 与 MCP 外部工具集成前言写作动机2025 年AI 编码工具已经从「新鲜玩意」变成了程序员的日常工具。Claude Code、Cursor、GitHub Copilot 等工具让编写代码的效率得到了数量级的提升。然而效率提升的同时也带来了新的挑战AI 写的代码是否符合预期如何在多轮对话中保持需求的一致性如何真正摸清并发挥工具的能力边界在众多 AI 编码工具中Claude Code 凭借其强大的 Skills、Hooks、Subagent 等扩展机制成为其中最值得深入研究的一个。它不是一个被动的代码补全器而是一个能在终端中自主读取文件、执行命令、修改代码的 AI 编程伙伴。但要真正发挥它的潜力需要的不是「会敲命令」而是理解它背后的工作机制CLAUDE.md 如何塑造项目记忆权限系统如何平衡效率与安全扩展机制如何各司其职又协同工作。希望通过本书为中文读者提供一条从入门到精通的完整学习路径。读者对象本书面向以下读者• 使用 Claude Code 进行日常开发希望全面掌握其能力的程序员• 使用 Cursor、GitHub Copilot 等其他 AI 编码工具对 Claude Code 感兴趣的开发者• 希望提高团队 AI 编码规范性和可追溯性的技术管理者• 任何希望从「氛围编程」走向「工程化 AI 协作」的软件工程师阅读本书前读者应具备基本的命令行操作能力和一定的软件开发经验熟悉 Git、了解前后端基本概念。不要求提前了解 Claude Code。本书结构全书共 6 章。第 1 章「Claude Code 概述与快速上手」介绍 Claude Code 的核心理念、环境安装、权限控制与检查点机制并通过首次对话让读者快速上手。第 2 章「CLAUDE.md 与项目记忆」深入 CLAUDE.md 的作用原理与层级体系讲解如何编写有效的项目记忆文件掌握 /init、/memory 等管理命令。第 3 章「斜杠命令与会话管理」梳理 55 内置斜杠命令与会话管理技巧覆盖模型切换、上下文管理、Plan Mode 等主题。第 4 章「Skills 与自定义命令」讲解 Skills 的机制与开发流程带领读者亲手编写可复用的 Skill。第 5 章「Hooks 自动化实战」覆盖 30 个 Hook 事件的自动化实战展示如何在关键节点自动执行校验与流程约束。第 6 章「Subagent、Worktree 与 MCP」介绍 Subagent 并行编排、Worktree 隔离与 MCP 外部工具集成构成 Claude Code 扩展机制的最后一块拼图。完整目录第 1 章 Claude Code 概述与快速上手1.1 什么是 Claude Code1.1.1 从代码补全到 AI 代理1.1.2 Claude Code 与其他工具的对比1.2 安装 Claude Code1.2.1 终端安装命令行方式1.2.2 VS Code 扩展1.2.3 JetBrains 插件1.2.4 桌面应用1.2.5 Web 界面1.2.6 配置第三方模型提供商1.3 权限模式1.3.1 权限模式的概念1.3.2 切换权限模式1.3.3 检查点机制1.4 首次对话1.4.1 启动会话1.4.2 基本交互示例1.4.3 理解 Claude Code 的文件读写机制1.4.4 理解 Claude Code 的命令执行机制1.5 基本斜杠命令1.5.1 /help — 获取帮助1.5.2 /model — 切换模型1.5.3 /clear — 清除对话历史1.5.4 /compact — 压缩上下文1.5.5 /cost — 查看成本1.5.6 /context — 查看上下文1.6 Claude Code 的定位与价值1.6.1 不只是代码补全1.6.2 SWE-bench 上的表现1.6.3 Claude Code 的核心优势1.7 本章小结思考与练习第 2 章 CLAUDE.md 与项目记忆2.1 什么是 CLAUDE.md2.1.1 CLAUDE.md 与系统提示的区别2.1.2 为什么 CLAUDE.md 是必要的2.2 CLAUDE.md 编写策略2.2.1 法则一保持简短2.2.2 法则二解释“为什么”2.2.3 法则三在它犯错的地方加固2.2.4 法则四通过 Git 团队共享2.3 CLAUDE.md 的层级体系2.3.1 四种层级2.3.2 加载顺序与合并规则2.3.3 使用 .claude/rules/ 组织条件化规则2.3.4 /init — 快速生成项目 CLAUDE.md2.3.5 /memory — 打开并编辑记忆文件2.4 团队共享 CLAUDE.md2.4.1 将 CLAUDE.md 纳入 Git 版本管理2.4.2 Code Review CLAUDE.md 变更2.4.3 维护跨项目一致性2.5 常见反模式2.5.1 反模式一过于冗长2.5.2 反模式二过于模糊2.5.3 反模式三信息过时2.5.4 反模式四规则矛盾2.6 本章小结思考与练习第 3 章 斜杠命令与会话管理3.1 内置斜杠命令速查3.1.1 会话管理命令3.1.2 模型与成本命令3.1.3 开发流程命令3.1.4 自动化命令3.1.5 扩展管理命令3.1.6 系统命令3.2 上下文管理3.2.1 上下文窗口的大小与限制3.2.2 使用 /context 查看上下文占用3.2.3 /compact 压缩策略3.2.4 “20-40% 原则”3.3 Plan Mode3.3.1 什么是 Plan Mode3.3.2 Plan Mode 的使用场景3.4 持续任务与自动化3.4.1 /goal — 跨会话持久化目标3.4.2 /loop — 循环执行任务3.4.3 /schedule — 定时调度3.5 会话恢复与多终端协作3.5.1 /resume — 恢复历史会话3.5.2 /rename — 重命名会话3.6 无头模式与 CI/CD3.6.1 -p / --print 标志3.6.2 管道模式3.6.3 CI/CD 集成示例3.6.4 无头模式的适用场景总结3.6.5 关键 CLI 标志3.6.6 Docker 化部署3.6.7 无头模式的注意事项3.7 本章小结思考与练习第 4 章 Skills 与自定义命令4.1 Skills 机制概述4.1.1 什么是 Skill4.1.2 Skill 与系统提示词、CLAUDE.md 的区别4.1.3 Skills 目录结构4.1.4 触发方式4.2 SKILL.md 完整结构4.2.1 基本骨架4.2.2 身份字段name 与 description4.2.3 调用控制字段4.2.4 执行上下文字段context 与 agent4.2.5 约束字段allowed-tools、disallowed-tools 与 model4.2.6 Skill 级别的 Hooks4.2.7 其他重要字段4.2.8 Body 指令体4.3 参数与变量4.3.1 变量机制4.3.2 变量使用示例4.3.3 多参数场景4.4 实战编写规范驱动 Skill4.4.1 需求分析4.4.2 创建 SKILL.md4.4.3 使用 Skill4.4.4 扩展思路4.5 自定义斜杠命令4.5.1 什么是自定义命令4.5.2 自定义命令示例4.5.3 Commands 与 Skills 的差异4.5.4 何时使用 Commands4.6 Skills vs Commands vs Subagent4.6.1 选择决策树4.6.2 组合使用示例4.7 Skills 最佳实践4.7.1 保持专注一个 Skill 只做一件事4.7.2 渐进测试4.7.3 为参数编写清晰的文档4.7.4 纳入版本控制4.7.5 善用 allowed-tools 降低风险4.7.6 定期清理与审查4.8 本章小结思考与练习第 5 章 Hooks 自动化实战5.1 Hooks 概述5.2 工具 Hooks5.2.1 PreToolUse — 工具调用前拦截5.2.2 PostToolUse — 工具调用成功后处理5.2.3 PostToolUseFailure — 工具调用失败后处理5.2.4 PermissionRequest — 权限请求拦截5.2.5 if 字段 — 精细化条件过滤5.2.6 PreToolUse 的决策控制5.3 会话 Hooks5.3.1 SessionStart — 会话启动时加载上下文5.3.2 SessionEnd — 会话结束时清理5.3.3 Stop 与 StopFailure — 停止事件5.3.4 SubagentStart 与 SubagentStop — 子代理生命周期5.4 任务 Hooks5.4.1 UserPromptSubmit — 用户输入记录5.4.2 TaskCompleted — 任务完成后的自动验证5.4.3 TaskCreated — 任务创建时的初始化5.5 生命周期 Hooks5.5.1 PreCompact 与 PostCompact5.5.2 WorktreeCreate 与 WorktreeRemove5.5.3 FileChanged — 文件变更监听5.6 退出码与反馈机制5.7 实战搭建自动化工作流5.7.1 工作流一会话启动自动注入项目上下文5.7.2 工作流二提交前自动验证5.7.3 工作流三敏感文件保护5.8 Hooks 最佳实践5.8.1 保持脚本快速5.8.2 仔细测试退出码5.8.3 避免无限循环5.8.4 善用 Matcher 缩小作用域5.8.5 设置合理的超时时间5.8.6 区分项目级与用户级配置5.9 本章小结思考与练习第 6 章 Subagent、Worktree 与 MCP6.1 Subagent 概述6.1.1 什么是子代理6.1.2 为什么需要子代理6.1.3 子代理的类型6.2 Agent 配置文件6.2.1 配置目录结构6.2.2 Frontmatter 配置项6.2.3 实战示例代码审查代理6.2.4 实战示例测试编写代理6.3 Subagent 实战模式6.3.1 代码审查委派6.3.2 并行测试生成6.3.3 文档生成6.4 Worktree 概述6.4.1 Git Worktree 概念6.4.2 CC 的 Worktree 集成6.4.3 Worktree 与子代理的对比6.4.4 高级配置6.5 Worktree 四种并行模式6.5.1 模式 A多终端并行6.5.2 模式 B竞争方案6.5.3 模式 C后台编排6.5.4 模式 D专家子代理并行6.6 MCP 集成6.6.1 什么是 MCP6.6.2 MCP 架构6.6.3 可用的 MCP 服务器6.6.4 配置 MCP6.6.5 上下文优化Tool Search6.6.6 MCP 实战示例6.7 本章小结思考与练习本书免费开放下载扫码即可获取从入门到精通一篇读懂 Claude Code 的全部核心能力 《Claude Code 详解》：一本从入门到精通的中文技术书，全 6 章免费下载
免费技术书 · 中文全六卷Claude Code 详解一本系统深入讲解 AI 代理式编程工具的中文技术书随着 AI 编码工具成为程序员的日常一本从入门到精通的中文系统教程变得尤为珍贵。本文为你带来这本免费开源的《Claude Code 详解》完整目录一并奉上。本书为作者自己撰写现免费提供下载阅读可以参考“微邮互动”公众号中对应文章获取下载地址内容提要本书是一本系统深入讲解Claude Code的中文技术书籍。Claude Code 是 Anthropic 推出的 AI 代理式编程工具凭借强大的推理能力、丰富的扩展机制Skills、Hooks、Subagent、MCP和灵活的权限系统已成为开发者日常使用最广泛的 AI 编码工具之一。全书共 6 章完整覆盖 Claude Code 的全部核心能力第 1 章基本概念与快速上手第 2 章深入 CLAUDE.md 项目记忆与权限系统第 3 章梳理 55 内置斜杠命令与会话管理技巧第 4 章讲解 Skills 与自定义命令开发第 5 章覆盖 30 个 Hook 事件的自动化实战第 6 章介绍 Subagent、Worktree 与 MCP 外部工具集成前言写作动机2025 年AI 编码工具已经从「新鲜玩意」变成了程序员的日常工具。Claude Code、Cursor、GitHub Copilot 等工具让编写代码的效率得到了数量级的提升。然而效率提升的同时也带来了新的挑战AI 写的代码是否符合预期如何在多轮对话中保持需求的一致性如何真正摸清并发挥工具的能力边界在众多 AI 编码工具中Claude Code 凭借其强大的 Skills、Hooks、Subagent 等扩展机制成为其中最值得深入研究的一个。它不是一个被动的代码补全器而是一个能在终端中自主读取文件、执行命令、修改代码的 AI 编程伙伴。但要真正发挥它的潜力需要的不是「会敲命令」而是理解它背后的工作机制CLAUDE.md 如何塑造项目记忆权限系统如何平衡效率与安全扩展机制如何各司其职又协同工作。希望通过本书为中文读者提供一条从入门到精通的完整学习路径。读者对象本书面向以下读者• 使用 Claude Code 进行日常开发希望全面掌握其能力的程序员• 使用 Cursor、GitHub Copilot 等其他 AI 编码工具对 Claude Code 感兴趣的开发者• 希望提高团队 AI 编码规范性和可追溯性的技术管理者• 任何希望从「氛围编程」走向「工程化 AI 协作」的软件工程师阅读本书前读者应具备基本的命令行操作能力和一定的软件开发经验熟悉 Git、了解前后端基本概念。不要求提前了解 Claude Code。本书结构全书共 6 章。第 1 章「Claude Code 概述与快速上手」介绍 Claude Code 的核心理念、环境安装、权限控制与检查点机制并通过首次对话让读者快速上手。第 2 章「CLAUDE.md 与项目记忆」深入 CLAUDE.md 的作用原理与层级体系讲解如何编写有效的项目记忆文件掌握 /init、/memory 等管理命令。第 3 章「斜杠命令与会话管理」梳理 55 内置斜杠命令与会话管理技巧覆盖模型切换、上下文管理、Plan Mode 等主题。第 4 章「Skills 与自定义命令」讲解 Skills 的机制与开发流程带领读者亲手编写可复用的 Skill。第 5 章「Hooks 自动化实战」覆盖 30 个 Hook 事件的自动化实战展示如何在关键节点自动执行校验与流程约束。第 6 章「Subagent、Worktree 与 MCP」介绍 Subagent 并行编排、Worktree 隔离与 MCP 外部工具集成构成 Claude Code 扩展机制的最后一块拼图。完整目录第 1 章 Claude Code 概述与快速上手1.1 什么是 Claude Code1.1.1 从代码补全到 AI 代理1.1.2 Claude Code 与其他工具的对比1.2 安装 Claude Code1.2.1 终端安装命令行方式1.2.2 VS Code 扩展1.2.3 JetBrains 插件1.2.4 桌面应用1.2.5 Web 界面1.2.6 配置第三方模型提供商1.3 权限模式1.3.1 权限模式的概念1.3.2 切换权限模式1.3.3 检查点机制1.4 首次对话1.4.1 启动会话1.4.2 基本交互示例1.4.3 理解 Claude Code 的文件读写机制1.4.4 理解 Claude Code 的命令执行机制1.5 基本斜杠命令1.5.1 /help — 获取帮助1.5.2 /model — 切换模型1.5.3 /clear — 清除对话历史1.5.4 /compact — 压缩上下文1.5.5 /cost — 查看成本1.5.6 /context — 查看上下文1.6 Claude Code 的定位与价值1.6.1 不只是代码补全1.6.2 SWE-bench 上的表现1.6.3 Claude Code 的核心优势1.7 本章小结思考与练习第 2 章 CLAUDE.md 与项目记忆2.1 什么是 CLAUDE.md2.1.1 CLAUDE.md 与系统提示的区别2.1.2 为什么 CLAUDE.md 是必要的2.2 CLAUDE.md 编写策略2.2.1 法则一保持简短2.2.2 法则二解释“为什么”2.2.3 法则三在它犯错的地方加固2.2.4 法则四通过 Git 团队共享2.3 CLAUDE.md 的层级体系2.3.1 四种层级2.3.2 加载顺序与合并规则2.3.3 使用 .claude/rules/ 组织条件化规则2.3.4 /init — 快速生成项目 CLAUDE.md2.3.5 /memory — 打开并编辑记忆文件2.4 团队共享 CLAUDE.md2.4.1 将 CLAUDE.md 纳入 Git 版本管理2.4.2 Code Review CLAUDE.md 变更2.4.3 维护跨项目一致性2.5 常见反模式2.5.1 反模式一过于冗长2.5.2 反模式二过于模糊2.5.3 反模式三信息过时2.5.4 反模式四规则矛盾2.6 本章小结思考与练习第 3 章 斜杠命令与会话管理3.1 内置斜杠命令速查3.1.1 会话管理命令3.1.2 模型与成本命令3.1.3 开发流程命令3.1.4 自动化命令3.1.5 扩展管理命令3.1.6 系统命令3.2 上下文管理3.2.1 上下文窗口的大小与限制3.2.2 使用 /context 查看上下文占用3.2.3 /compact 压缩策略3.2.4 “20-40% 原则”3.3 Plan Mode3.3.1 什么是 Plan Mode3.3.2 Plan Mode 的使用场景3.4 持续任务与自动化3.4.1 /goal — 跨会话持久化目标3.4.2 /loop — 循环执行任务3.4.3 /schedule — 定时调度3.5 会话恢复与多终端协作3.5.1 /resume — 恢复历史会话3.5.2 /rename — 重命名会话3.6 无头模式与 CI/CD3.6.1 -p / --print 标志3.6.2 管道模式3.6.3 CI/CD 集成示例3.6.4 无头模式的适用场景总结3.6.5 关键 CLI 标志3.6.6 Docker 化部署3.6.7 无头模式的注意事项3.7 本章小结思考与练习第 4 章 Skills 与自定义命令4.1 Skills 机制概述4.1.1 什么是 Skill4.1.2 Skill 与系统提示词、CLAUDE.md 的区别4.1.3 Skills 目录结构4.1.4 触发方式4.2 SKILL.md 完整结构4.2.1 基本骨架4.2.2 身份字段name 与 description4.2.3 调用控制字段4.2.4 执行上下文字段context 与 agent4.2.5 约束字段allowed-tools、disallowed-tools 与 model4.2.6 Skill 级别的 Hooks4.2.7 其他重要字段4.2.8 Body 指令体4.3 参数与变量4.3.1 变量机制4.3.2 变量使用示例4.3.3 多参数场景4.4 实战编写规范驱动 Skill4.4.1 需求分析4.4.2 创建 SKILL.md4.4.3 使用 Skill4.4.4 扩展思路4.5 自定义斜杠命令4.5.1 什么是自定义命令4.5.2 自定义命令示例4.5.3 Commands 与 Skills 的差异4.5.4 何时使用 Commands4.6 Skills vs Commands vs Subagent4.6.1 选择决策树4.6.2 组合使用示例4.7 Skills 最佳实践4.7.1 保持专注一个 Skill 只做一件事4.7.2 渐进测试4.7.3 为参数编写清晰的文档4.7.4 纳入版本控制4.7.5 善用 allowed-tools 降低风险4.7.6 定期清理与审查4.8 本章小结思考与练习第 5 章 Hooks 自动化实战5.1 Hooks 概述5.2 工具 Hooks5.2.1 PreToolUse — 工具调用前拦截5.2.2 PostToolUse — 工具调用成功后处理5.2.3 PostToolUseFailure — 工具调用失败后处理5.2.4 PermissionRequest — 权限请求拦截5.2.5 if 字段 — 精细化条件过滤5.2.6 PreToolUse 的决策控制5.3 会话 Hooks5.3.1 SessionStart — 会话启动时加载上下文5.3.2 SessionEnd — 会话结束时清理5.3.3 Stop 与 StopFailure — 停止事件5.3.4 SubagentStart 与 SubagentStop — 子代理生命周期5.4 任务 Hooks5.4.1 UserPromptSubmit — 用户输入记录5.4.2 TaskCompleted — 任务完成后的自动验证5.4.3 TaskCreated — 任务创建时的初始化5.5 生命周期 Hooks5.5.1 PreCompact 与 PostCompact5.5.2 WorktreeCreate 与 WorktreeRemove5.5.3 FileChanged — 文件变更监听5.6 退出码与反馈机制5.7 实战搭建自动化工作流5.7.1 工作流一会话启动自动注入项目上下文5.7.2 工作流二提交前自动验证5.7.3 工作流三敏感文件保护5.8 Hooks 最佳实践5.8.1 保持脚本快速5.8.2 仔细测试退出码5.8.3 避免无限循环5.8.4 善用 Matcher 缩小作用域5.8.5 设置合理的超时时间5.8.6 区分项目级与用户级配置5.9 本章小结思考与练习第 6 章 Subagent、Worktree 与 MCP6.1 Subagent 概述6.1.1 什么是子代理6.1.2 为什么需要子代理6.1.3 子代理的类型6.2 Agent 配置文件6.2.1 配置目录结构6.2.2 Frontmatter 配置项6.2.3 实战示例代码审查代理6.2.4 实战示例测试编写代理6.3 Subagent 实战模式6.3.1 代码审查委派6.3.2 并行测试生成6.3.3 文档生成6.4 Worktree 概述6.4.1 Git Worktree 概念6.4.2 CC 的 Worktree 集成6.4.3 Worktree 与子代理的对比6.4.4 高级配置6.5 Worktree 四种并行模式6.5.1 模式 A多终端并行6.5.2 模式 B竞争方案6.5.3 模式 C后台编排6.5.4 模式 D专家子代理并行6.6 MCP 集成6.6.1 什么是 MCP6.6.2 MCP 架构6.6.3 可用的 MCP 服务器6.6.4 配置 MCP6.6.5 上下文优化Tool Search6.6.6 MCP 实战示例6.7 本章小结思考与练习本书免费开放下载扫码即可获取从入门到精通一篇读懂 Claude Code 的全部核心能力