Claude Code 学习教程
关于本书
这是一本系统性的 Claude Code 学习教程，以 Claude Code for VSCode 扩展为主要工具，以 DeepSeek V4 系列模型（通过 cc-switch 接入）为默认模型，带你从零基础逐步成长为 Claude Code 高手。
本书不同于市面上零散的博客文章或快速入门指南。它是一本结构完整、由浅入深、理论与实践并重的教程——全书共 8 篇、40 章、7 个附录，覆盖从安装配置到团队推广、从基础对话到自定义扩展开发的完整知识体系。
本书特色：
- 工具聚焦：以 Claude Code for VSCode 为主线，所有操作、截图、案例均基于 VSCode 扩展，确保读者可复现
- 模型实战：默认使用 DeepSeek V4 系列模型（V4 Flash / V4 Pro），大幅降低使用成本，同时支持 Anthropic 官方模型作为补充
- 混合定位：兼顾零基础开发者和有 AI 工具经验的读者，每篇提供明确的学习入口建议
- 体系完整：8 篇 40 章 + 7 个附录，从入门到精通，从概念到实战，从个人使用到团队推广
无论你是第一次接触 AI 编程工具，还是已经使用过 Copilot、Cursor 等工具想深入了解 Agentic Coding，本书都能为你提供清晰的学习路径。
核心概念：Agent 与模型
初次接触 Claude Code 时，最容易混淆的是 Agent 和 模型 的关系。理清这两个概念，是正确理解 Claude Code 工作方式的第一步。
Claude Code 是什么？
Claude Code 是一个 Agent——它是一个软件框架/工具，负责：
- 管理你和 AI 模型之间的对话
- 调用工具（读文件、写代码、执行命令、搜索网络等）
- 控制权限（决定何时需要你的确认）
- 维护上下文（CLAUDE.md、Memory、对话历史）
- 协调多个模型的调度
Claude 模型家族
模型是 Agent 的"大脑"——它提供理解和生成代码的智能。Anthropic 提供三个等级的模型：
| 模型 | 定位 | 特点 | 适用场景 | 总结 |
|---|---|---|---|---|
| Claude Opus 4.7 | 旗舰级 | 最强推理、最深理解、最准代码 | 复杂架构设计、深度调试、跨文件大规模重构 | 强 |
| Claude Sonnet 4.6 | 主力级 | 性能与速度的最佳平衡 | 日常编程、Bug 修复、功能开发（推荐默认使用） | 平衡模式 |
| Claude Haiku 4.5 | 轻量级 | 最快响应、最低成本 | 简单查询、代码格式化、文档整理 | 快 |
三者使用完全相同的 Agent 框架和工具系统，区别仅在于推理能力和速度。
Agent 与模型的关系
一个简单的类比
Agent = 汽车（方向盘、油门、刹车、导航）
模型 = 发动机（提供动力）
换模型 ≈ 换发动机（同样的车，不同的马力）
Agent 的能力 × 模型的智能 = 最终产出具体来说：
- Agent 决定"能做什么"：能读什么文件、能执行哪些命令、能否搜索网络、何时需要你确认——这些都是 Agent 层面的事，与使用哪个模型无关。
- 模型决定"做得有多好"：代码质量、逻辑推理深度、对复杂需求的理解——这些取决于模型能力。Opus 写的代码可能比 Haiku 更优雅，但它们用的都是同一套工具。
- 你可以随时切换模型：通过 cc-switch 在不同模型间切换（甚至接入 DeepSeek 等第三方模型），Agent 的行为框架保持不变，但输出质量会随模型而变化。
为什么这个区别很重要？
理解 Agent 和模型的分离，能帮你做出更好的决策：
- Agent 行为出问题（如改错文件、没读上下文）→ 检查 CLAUDE.md、对话状态、权限配置，换模型没用
- 输出质量出问题（如代码不够好、逻辑不严谨）→ 切换到更强的模型（Sonnet → Opus）
- 想省钱但 Agent 能力不受影响 → 日常用 Haiku/Sonnet，复杂任务切 Opus
DeepSeek 模型家族
除了 Anthropic 官方模型，本书默认使用 DeepSeek V4 系列模型，通过 cc-switch 工具接入 Claude Code。DeepSeek V4 是目前性价比极高的第三方模型选择：
| 模型 | 定位 | 特点 | 适用场景 |
|---|---|---|---|
| DeepSeek V4 Pro | 旗舰级 | 最强推理能力，接近 Claude Opus 水平 | 复杂任务、深度分析、架构设计 |
| DeepSeek V4 Flash | 主力级 | 快速响应，成本极低 | 日常开发、代码生成、文档整理 |
模型定价对比
选择合适的模型，成本是一个重要考量因素。以下是各模型的参考价格：
| 模型 | 输入价格（每百万 Token） | 输出价格（每百万 Token） | 性价比评级 |
|---|---|---|---|
| Claude Opus 4.7 | $15.00 | $75.00 | ★★☆☆☆ |
| Claude Sonnet 4.6 | $3.00 | $15.00 | ★★★☆☆ |
| Claude Haiku 4.5 | $0.80 | $4.00 | ★★★★☆ |
| DeepSeek V4 Pro | $1.50 | $6.00 | ★★★★★ |
| DeepSeek V4 Flash | $0.30 | $1.20 | ★★★★★ |
注：价格为 2026 年 5 月参考值，实际价格请以各平台官网为准。DeepSeek 模型的价格优势非常显著——在大多数日常场景中，使用 DeepSeek V4 Flash 的成本仅为 Claude Sonnet 的 1/10 甚至更低。
模型选择建议
| 场景 | 推荐模型 | 理由 |
|---|---|---|
| 日常开发、代码生成 | DeepSeek V4 Flash | 成本极低，日常任务表现足够好 |
| 复杂重构、架构设计 | DeepSeek V4 Pro | 推理能力强，接近 Opus 但成本低得多 |
| 深度调试、疑难杂症 | Claude Opus 4.7 | 最强推理，值得为关键任务投入 |
| 简单查询、文档整理 | DeepSeek V4 Flash | 成本最低，响应最快 |
| 代码审查、安全检查 | Claude Sonnet 4.6 | 平衡模式，审查质量有保障 |
本书的建议策略：日常开发默认使用 DeepSeek V4 Flash，遇到复杂任务切换到 DeepSeek V4 Pro，关键决策和深度分析时按需使用 Claude Opus。通过 cc-switch 可以在这些模型之间无缝切换——第 3 章会详细讲解配置方法。
本书特色
工具聚焦
全书以 Claude Code for VSCode 为主要工具。所有操作步骤、界面截图、快捷键示例均基于 VSCode 扩展，确保读者可以一边阅读一边在自己的编辑器中实践。同时也会介绍 CLI、JetBrains 插件等其他平台的使用方式，方便不同环境的读者。
模型实战
不同于大多数教程默认使用 Claude Sonnet，本书以 DeepSeek V4 系列为默认模型。这不仅大幅降低了学习成本（DeepSeek V4 Flash 的价格约为 Claude Sonnet 的 1/10），也展示了 Claude Code 作为 Agent 的模型无关性——你可以自由选择性价比最高的模型，而不被锁定在特定供应商。
混合定位
本书同时服务两类读者：
- 零基础开发者：从第一篇开始，逐步建立对 AI Agent 编程工具的完整认知
- 有 AI 工具经验的开发者：可以从第二篇或第三篇切入，快速定位到你需要的内容
每篇开头都标注了建议的阅读起点，你可以根据自己的背景灵活选择学习路径。
体系完整
本书不是碎片化的技巧合集，而是一本结构严谨的教程：
- 8 篇 40 章：从概念认知到高级工作流，覆盖 Claude Code 的全部能力
- 贯穿项目：第八篇的 SmartTodo 全栈应用贯穿全书，理论知识与动手实践交替进行
- 7 个附录：提供 Cheatsheet、配置参考、Prompt 模板等速查资料，方便日常查阅
学习路径
全书共 8 篇 40 章，按学习深度线性推进，每一篇都是下一篇的前置基础：
| 篇 | 名称 | 章节 | 目标 |
|---|---|---|---|
| 一 | 入门篇 | Ch 1-4 | 建立认知，完成环境搭建 |
| 二 | 基础篇 | Ch 5-9 | 掌握四大核心能力 |
| 三 | 进阶篇 | Ch 10-14 | 理解内部机制，掌握配置与权限 |
| 四 | 生态篇 | Ch 15-19 | 掌握 MCP、Plugins、Skills、Hooks 扩展生态 |
| 五 | 实战篇 | Ch 20-27 | 通过 8 个真实场景融会贯通 |
| 六 | 方法论篇 | Ch 28-31 | 建立 AI 编程思维 |
| 七 | 精通篇 | Ch 32-36 | 高级工作流、团队推广、前沿探索 |
| 八 | 贯穿项目 | Ch 37-40 | 从零构建全栈应用 |
各篇概览：
第一篇 入门篇：回答"Claude Code 是什么、能做什么、怎么装"。包含 AI 编程时代背景、Agent 与模型核心概念、环境搭建、平台生态概览。完成本篇后，你将跑通第一个对话，理解 Claude Code 的基本工作方式。
第二篇 基础篇：掌握日常开发的四大核心能力——对话与代码理解、代码编辑与重构、终端命令执行、Git 集成。同时学习权限模式切换和模型 Effort 设置。完成本篇后，你将能在日常工作中流畅使用 Claude Code。
第三篇 进阶篇：深入 Agent Loop 内部机制，全面理解工具系统，掌握上下文管理、CLAUDE.md 编写、四层配置体系、权限与安全配置。完成本篇后，你将能够为项目定制 Claude Code 的行为。
第四篇 生态篇：打开 Claude Code 的扩展能力边界——MCP 协议与服务器、插件系统、Skills 技能系统、Hooks 钩子系统、命令系统进阶。完成本篇后，你将能够利用社区生态大幅扩展 Claude Code 的能力。
第五篇 实战篇：通过 8 个真实开发场景（理解陌生项目、从零搭建新功能、大规模重构、调试排错、Code Review、测试编写、文档生成、CI/CD 集成），将前四篇的知识融会贯通。每个场景都包含完整的步骤拆解和技巧复盘。
第六篇 方法论篇：超越工具本身，建立 AI 时代的编程思维——Prompt 工程、让 AI 理解你的项目、人机协作模式、效率优化策略。完成本篇后，你将理解"用好 AI"背后的方法论。
第七篇 精通篇：掌握高级工作流（多 Agent 协作、Plan 模式、Worktree 隔离）、自定义扩展开发、团队推广策略、模型深度实测对比、前沿趋势探索。完成本篇后，你将具备在团队中推广 Claude Code 的能力。
第八篇 贯穿项目：从零构建一个完整的全栈应用 SmartTodo，将全书知识落地为一个可部署上线的项目。涵盖项目启动、后端开发、前端开发、部署与运维。
面向读者
本书为不同背景的读者设计了不同的阅读路径：
零基础开发者：从第一篇开始，按顺序阅读。第一篇帮你建立完整的认知框架，第二篇让你掌握日常操作，之后逐步深入。建议每读完一篇，在实际项目中练习 1-2 周再继续。
有 AI 工具经验的开发者（使用过 Copilot、Cursor 等）：可以从第二篇开始，直接进入 Claude Code 的核心操作。如果对 Agent 和模型的概念已经很清晰，也可以快速浏览第一篇的第 2 章后直接跳到第三篇学习进阶配置。
团队 Leader / 技术负责人：重点阅读第七篇（精通篇）中的团队推广章节（第 34 章）和第三篇（进阶篇）中的配置与权限章节（第 13-14 章），了解如何在团队中标准化 Claude Code 的使用。之后可以根据需要深入其他篇章。
推荐阅读节奏：
零基础： 第一篇 → 第二篇 → 实战练习 → 第三篇 → 第四篇 → 第五篇 → 第六篇 → 第七篇 → 第八篇
有经验： 快速浏览第一篇 → 第二篇 → 第三篇 → 选择感兴趣的篇章深入
Team Lead： 第七篇(Ch 34) → 第三篇(Ch 13-14) → 根据团队需要选择其他篇章与旧版指南的关系
本仓库中同时存在两个 Claude Code 相关的内容目录：
| 内容 | 路径 | 定位 | 体量 |
|---|---|---|---|
| Claude Code 培训指南（旧版） | src/ai/claudecode/ | 快速入门指南，适合快速上手 | 7 章 |
| Claude Code 学习教程（新版） | src/ai/claudecodenew/ | 系统性教程，适合深度学习 | 8 篇 40 章 + 7 附录 |
旧版指南（src/ai/claudecode/）定位为快速入门，用最精简的篇幅覆盖安装、基本概念、核心功能、生态和工作流，适合想快速上手的朋友。新版教程（src/ai/claudecodenew/）则是完整的学习体系，适合希望系统掌握 Claude Code、从"会用"到"精通"的读者。
两者的关系可以理解为：
旧版指南 = 快速上手手册（1 小时读完，马上能用）
新版教程 = 完整教材（系统学习，从入门到精通）两个版本长期共存，互不替代。你可以根据当前需求选择阅读：赶时间就看旧版，想深入就跟着新版走。
约定与工具
本书全文采用以下约定：
| 约定 | 说明 |
|---|---|
| 主要工具 | Claude Code for VSCode（VSCode 扩展） |
| 默认模型 | DeepSeek V4 Flash / V4 Pro（通过 cc-switch 切换） |
| 操作系统 | macOS（Windows/Linux 用户大部分操作通用，差异处会特别标注） |
| 快捷键 | 以 Mac 键盘为主，同时标注 Windows/Linux 对应键位 |
| 代码示例 | 以 TypeScript / Python 为主，不限定特定语言 |
好了，让我们开始这段学习之旅。翻开第一篇，了解 AI 编程时代的到来。