Claude Code 学习手册：竖版电子书优化版

竖版电子书优化版 Generated 2026-05-15 Claude Code 学习手册 从入门到高级工程化实践：AI Agent 新手的系统学习路线。 生成日期：2026-05-15 阅读说明 本书面向已经具备编程基础、刚开始系统学习 Claude Code 和 AI Agent的读者。全书采用案例驱动方式，每章都包含学习目标、操作案例、练习、检查清单和常见坑。 总目录 • 第 1 章：为什么 Claude Code 不只是聊天机器人• 第 2 章：环境、账号、模型和第一个任务• 第 3 章：Claude Code 的文件读写和工具系统• 第 4 章：学习用项目准备• 第 5 章：代码理解与项目地图• 第 6 章：Bug 定位与修复• 第 7 章：重构、测试和文档• 第 8 章：Git 工作流与提交质量• 第 9 章：从一次性问答到可复用工作流• 第 10 章：Markdown 不是文档格式，而是 Agent 控制层• 第 11 章：CLAUDE.md 记忆系统• 第 12 章：项目规则、AGENTS.md 和规则文件夹• 第 13 章：本地知识库• 第 14 章：记忆系统的反模式• 第 15 章：Claude Code 提示词基本功• 第 16 章：计划模式与探索模式• 第 17 章：驯服 Opus 4.7：模型、努力级别和思考预算• 第 18 章：复杂工程任务的提示词编排• 第 19 章：上下文窗口与文件选择• 第 20 章：压缩、恢复和长会话管理• 第 21 章：Token节省与成本优化• 第 22 章：Skills 基础• 第 23 章：自定义命令与任务型 Skill• 第 24 章：SubAgents 基础• 第 25 章：多Agent协作 • 第 26 章：Hooks事件驱动自动化• 第 27 章：MCP 基础与外部工具连接• 第 28 章：Plugins插件系统• 第 29 章：Tools 与 Rules体系• 第 30 章：Skill、Agent、MCP、Plugin 的组合模式• 第 31 章：扩展系统实战小项目• 第 32 章：Headless 模式与命令行自动化• 第 33 章：Agent SDK 入门• 第 34 章：Routines、定时任务和自动化工作流• 第 35 章：GitHub PR / CI 工作流• 第 36 章：IDE、浏览器和外部开发工具集成• 第 37 章：权限系统和安全工作模式• 第 38 章：沙箱、数据安全和提示注入• 第 39 章：Git、安全发布和回滚• 第 40 章：生产级 Claude Code使用规范• 第 41 章：Claude Code内部工作机制导览• 第 42 章：上下文工程、缓存和成本工程• 第 43 章：从个人能力到团队AI 编码体系• 第 44 章：实战一 - 个人 Python 项目从 Bug 到 PR• 第 45 章：实战二-团队Claude Code 工具包 附录目录 •附录A：Claude Code 常用命令速查•附录B：目录与文件速查•附录C：Markdown 写作模板•附录D：提示词模板库•附录E：Skill 模板库•附录F：SubAgent 模板库•附录G：MCP配置示例•附录H：Hooks 示例•附录I：Token 与成本清单•附录J：安全清单•附录K：术语表 第 1 章：为什么 Claude Code 不只是聊天机器人 本章导读 帮助读者建立第一个正确心智模型：Claude Code是能读取项目、调用工具、修改文件、运行命令并受权限约束的 AI 编码Agent，不是只回答问题的聊天窗口。 本章先用一个简单函数分析任务展示聊天模型和 Claude Code 的区别，再解释Claude Code 的核心闭环：理解目标、探索项目、使用工具、修改文件、验证结果、总结交付。重点强调“上下文不是魔法”“权限不是麻烦”“验证不是可选项”。读者应明白，后续所有高级功能都建立在这个闭环之上。 学习目标 • 理解“为什么 Claude Code 不只是聊天机器人”在Claude Code 学习路线中的位置。•能把本章知识转化为一个可交给Claude Code执行的小任务。•能使用 PowerShell命令完成主流程，并能读懂macOS/Linux对照命令。•能用 Python 示例完成本章案例，并知道如何迁移到其他语言项目。•能根据检查清单判断任务是否真正完成。 先做一个小案例 本章先使用 Python 项目做一个最小案例。目标不是一次性完成复杂工程，而是训练“提出明确任务 ->让Claude Code 探索 ->获取可验证输出-> 记录结果”的闭环。 # Windows PowerShellSet-Location "D:\AI\claude code学习手册\book\examples\chapter-01"claude "基于本章主题“为什么 Claude Code 不只是聊天机器人”，设计一个最小可执行案例，并给出验证清单。" # macOS / Linuxcd ~/claude-code-handbook/book/examples/chapter-01claude "基于本章主题“为什么 Claude Code 不只是聊天机器人”，设计一个最小可执行案例，并给出验证清单。" 案例中的最小代码对象如下： from pathlib import PathPROJECT_ROOT = Path.cwd()def summarize_target(path: str) -> dict:target = PROJECT_ROOT / pathreturn {"path": str(target),"exists": target.exists(),"suffix": target.suffix,}if __name__ == "__main__":print(summarize_target("README.md")) 目录 • 1.1 AI Chat、AI Agent、AI 编码 Agent 的区别• 1.1.1普通聊天模型能做什么• 1.1.2 AI Agent多了哪些能力• 1.1.3 AI 编码 Agent 为什么需要文件系统、命令行和权限• 1.2 Claude Code 的核心工作方式• 1.2.1 用户目标如何变成模型任务• 1.2.2 模型如何选择读取、搜索、编辑、执行命令• 1.2.3 工具结果如何反过来影响下一步决策• 1.3 新手最容易误解的地方• 1.3.1以为模型天然知道整个项目• 1.3.2以为说一句“帮我修好”就足够• 1.3.3以为 AI 修改代码不需要验证• 1.4 本书的学习方法• 1.4.1 每章先做一个小任务• 1.4.2 用检查清单判断是否真正掌握• 1.4.3把成功经验写回Markdown 和规则文件 1.1 AI Chat、AI Agent、AI 编码 Agent 的区别 学习目标 • 理解 AI Chat、AI Agent、AI 编码 Agent 的区别在本章主题中的具体作用。•能把AI Chat、AI Agent、AI 编码 Agent 的区别转化为一个可执行、可验证的 Claude Code 任务。•能识别这一节常见的误用场景，并知道如何修正。•能说明本节三个重点：普通聊天模型能做什么、AI Agent多了哪些能力、AI 编码 Agent为什么需要文件系统、命令行和权限。 核心概念 AI Chat、AI Agent、AI 编码 Agent 的区别的重点不是记住术语，而是把它放回真实工程动作里理解。对于Claude Code来说，一个好的任务必须同时说明目标、边界、可用资料、允许执行的动作和验收方式。 本节可以按下面的顺序理解： • 1.1.1普通聊天模型能做什么：先解释它解决的问题，再给出一个可观察的操作。• 1.1.2 AI Agent多了哪些能力：先解释它解决的问题，再给出一个可观察的操作。• 1.1.3 AI 编码 Agent为什么需要文件系统、命令行和权限：先解释它解决的问题，再给出一个可观察的操作。 本节主案例语言是 Python。用一个小型 Python CLI或脚本项目作为观察对象，重点展示文件读取、测试和自动化流程。 操作步骤 1.明确当前任务只覆盖本节范围，不把后续章节内容提前展开。2.让Claude Code先读取或搜索与任务相关的最小资料集。3.要求Claude Code输出它基于哪些文件、命令或文档得出结论。4.让Claude Code给出可执行步骤，并在执行前说明风险。5.完成后用检查清单验证结果，而不是只看回答是否流畅。 # Windows PowerShellSet-Location "D:\AI\claude code学习手册\book\examples\chapter-01" claude "只围绕“AI Chat、AI Agent、AI 编码 Agent 的区别”做一次可验证的小任务：先说明计划，再给出操作步骤、验证方式和风险。" # macOS / Linuxcd ~/claude-code-handbook/book/examples/chapter-01claude "只围绕“AI Chat、AI Agent、AI 编码 Agent 的区别”做一次可验证的小任务：先说明计划，再给出操作步骤、验证方式和风险。" 示例 下面的示例不是为了展示复杂代码，而是为了给Claude Code 一个可以读取、运行或解释的最小对象。 from pathlib import Path PROJECT_ROOT = Path.cwd()def summarize_target(path: str) -> dict:target = PROJECT_ROOT / pathreturn {"path": str(target),"exists": target.exists(),"suffix": target.suffix,}if __name__ == "__main__":print(summarize_target("README.md")) 可以把这段代码交给Claude Code，并要求它只完成一个小目标：解释入口、指出潜在问题、补一个测试，或者生成一段文档。 练习 • 练习 1：把AI Chat、AI Agent、AI 编码 Agent 的区别改写成一个包含目标、范围、限制、输出格式的提示词。• 练习 2：要求Claude Code先列计划，不直接修改文件。• 练习 3：让Claude Code给出验证命令，并记录验证结果。 检查清单 • [ ]我能用自己的话解释AI Chat、AI Agent、AI 编码 Agent 的区别 解决什么问题。• [ ]我能写出一个不会让Claude Code误解的任务说明。• [ ]我能指出本节任务的输入、输出、风险和验证方式。• [ ]我能判断Claude Code 的回答是否基于真实证据。 1.2 Claude Code 的核心工作方式 学习目标 • 理解 Claude Code 的核心工作方式在本章主题中的具体作用。 •能把Claude Code 的核心工作方式转化为一个可执行、可验证的 Claude Code 任务。•能识别这一节常见的误用场景，并知道如何修正。•能说明本节三个重点：用户目标如何变成模型任务、模型如何选择读取、搜索、编辑、执行命令、工具结果如何反过来影响下一步决策。 核心概念 Claude Code 的核心工作方式 的重点不是记住术语，而是把它放回真实工程动作里理解。对于ClaudeCode来说，一个好的任务必须同时说明目标、边界、可用资料、允许执行的动作和验收方式。 本节可以按下面的顺序理解： • 1.2.1 用户目标如何变成模型任务：先解释它解决的问题，再给出一个可观察的操作。•