Claude Code 学习教程 —— 大纲

方案选择

经过对比三种架构方案（渐进式 / 领域式 / 情景式），最终采用方案一：七大模块渐进式。

• 核心理念：按学习深度线性推进，从“能用”到“会用”到“精通”。每一篇都是下一篇的前置基础。
• 目标读者：混合定位，零基础和有 AI 工具经验的读者都能找到入口
• 主要工具：Claude Code for VSCode
• 默认模型：DeepSeek V4 系列（通过 cc-switch 切换）
• 预估体量：20-40 万字，40-60+ 个页面
• 现有内容关系：旧版 src/ai/claudecode/ 保留作为快速入门，新版作为完整教程

---

第一篇：入门篇 —— 认识 Claude Code

目标：零基础读者建立对 AI Agent 编程工具的完整认知，完成环境搭建，跑通第一个对话。

第 1 章：AI 编程时代的到来

• 1.1 传统编程 vs AI 辅助编程 vs Agentic Coding
• 1.2 什么是 AI Agent：不只是聊天机器人
• 1.3 主流 AI 编程工具全景图（Copilot / Cursor / Windsurf / Claude Code）
• 1.4 Claude Code 的独特定位：Agentic Coding 工具而非补全工具
• 1.5 本书学习路径导航

第 2 章：核心概念：Agent 与模型

• 2.1 Agent 是什么：框架、工具系统、权限控制
• 2.2 模型是什么：LLM 作为 Agent 的“大脑”
• 2.3 Agent 与模型的分离关系（汽车与发动机类比）
• 2.4 Claude 模型家族（Opus / Sonnet / Haiku）
• 2.5 DeepSeek 模型家族（V4 Flash / V4 Pro）
• 2.6 什么时候用哪个模型：决策框架

第 3 章：环境搭建

• 3.1 前置依赖：Node.js、Git、网络
• 3.2 安装 Claude Code for VSCode
• 3.3 安装 cc-switch（GUI 模型切换工具）
• 3.4 配置 DeepSeek API 接入
• 3.5 配置 Anthropic 官方 API（双账号策略）
• 3.6 第一个对话：“介绍一下这个项目”
• 3.7 VSCode 界面导览：侧边栏、Diff 视图、终端、权限弹窗
• 3.8 安装检查清单

第 4 章：平台生态概览

• 4.1 五种使用方式的对比（CLI / VSCode / JetBrains / Web / Desktop）
• 4.2 为什么本书以 VSCode 扩展为主
• 4.3 快捷键一览
• 4.4 三种启动方式与选择策略

---

第二篇：基础篇 —— 日常核心操作

目标：掌握 Claude Code 的四大核心能力（对话、编辑、终端、Git），能在日常开发中流畅使用。

第 5 章：对话与代码理解

• 5.1 基础提问：问项目、问代码、问逻辑
• 5.2 上下文技巧：指定文件范围、引用选中代码
• 5.3 代码解释（Explain This）
• 5.4 主动添加上下文（Add to Context）
• 5.5 最佳实践：把 Claude Code 当新人同事来带

第 6 章：代码编辑与重构

• 6.1 Edit 工具：精确替换文本
• 6.2 Write 工具：创建新文件
• 6.3 Diff 审查工作流：逐文件 Accept / Reject
• 6.4 内联编辑（Cmd+Shift+I）：光标处直接生成
• 6.5 批量重命名与跨文件重构
• 6.6 右键菜单功能详解
• 6.7 撤销与回退策略

第 7 章：终端命令执行

• 7.1 让 Claude Code 替你运行命令
• 7.2 常见命令场景：安装依赖、运行构建、执行测试
• 7.3 中断与重试
• 7.4 读取命令输出来判断结果
• 7.5 危险命令防护

第 8 章：Git 集成

• 8.1 自动 Git 状态感知
• 8.2 让 Claude Code 写 Commit Message
• 8.3 代码变更追踪
• 8.4 分支操作与工作流
• 8.5 Git 最佳实践

第 9 章：模式切换

• 9.1 五种权限模式详解（Ask / Auto / Edit / Plan / Bypass）
• 9.2 模式选择策略：什么时候用哪种
• 9.3 模型 Effort 设置（5 个等级）
• 9.4 思考模式开关
• 9.5 个人推荐配置

---

第三篇：进阶篇 —— 深入掌握

目标：理解 Claude Code 的内部运作机制，掌握上下文管理、权限配置、CLAUDE.md 编写等进阶技能。

第 10 章：工作原理

• 10.1 Agent Loop 完整流程图解
• 10.2 工具系统详解：每个工具的原理与用途
  • Read / Write / Edit
  • Bash / BashOutput
  • Glob / Grep
  • WebSearch / WebFetch
  • Task / TaskOutput
  • TodoWrite
  • NotebookEdit
• 10.3 从输入到输出的完整生命周期
• 10.4 理解工具调用日志

第 11 章：上下文管理

• 11.1 什么是上下文窗口
• 11.2 上下文膨胀问题
• 11.3 /compact 压缩命令详解
  • 自动压缩 vs 手动压缩
  • 保留关键信息的技巧
  • 压缩后恢复策略
• 11.4 /clear 清空对话
• 11.5 会话管理：Save / Resume / History
• 11.6 多会话并存策略

第 12 章：CLAUDE.md —— 项目的大脑

• 12.1 CLAUDE.md 的作用与加载时机
• 12.2 CLAUDE.md 编写规范
  • 项目概述
  • 技术栈说明
  • 目录结构
  • 编码规范
  • 常用命令
  • 注意事项
• 12.3 CLAUDE.md 模板与最佳实践
• 12.4 大型项目的 CLAUDE.md 分层策略
• 12.5 Memory 系统：持久化记忆

第 13 章：配置体系深度解析

• 13.1 四层配置优先级
• 13.2 ~/.claude/settings.json 完整参考
• 13.3 .claude/settings.json 团队配置
• 13.4 .claude/settings.local.json 本地覆盖
• 13.5 环境变量完整参考
• 13.6 VSCode 专属配置项
• 13.7 配置调试与排错

第 14 章：权限与安全

• 14.1 权限系统架构
• 14.2 allow / deny 规则语法
• 14.3 通配符与正则匹配
• 14.4 常见权限配置模板
  • 个人开发环境
  • 团队开发环境
  • CI/CD 环境
• 14.5 沙箱与安全边界
• 14.6 安全最佳实践

---

第四篇：生态篇 —— 扩展能力边界

目标：掌握 Claude Code 的完整扩展生态，包括 MCP、Plugins、Skills、Hooks、斜杠命令、快捷键体系。

第 15 章：MCP 协议与服务器

• 15.1 什么是 MCP（Model Context Protocol）
• 15.2 MCP 架构：Client → Server → Resource
• 15.3 内置 MCP 服务器
• 15.4 第三方 MCP 服务器配置
• 15.5 Context7 文档查询实战
• 15.6 自定义 MCP 服务器开发入门
• 15.7 MCP 服务器最佳实践

第 16 章：插件系统（Plugins）

• 16.1 插件架构与生命周期
• 16.2 官方插件市场
• 16.3 ECC 社区插件市场
• 16.4 插件安装与权限管理
• 16.5 全局级 vs 项目级插件
• 16.6 推荐插件清单与使用指南
• 16.7 插件开发入门

第 17 章：Skills 技能系统

• 17.1 什么是 Skill：可复用的指令模板
• 17.2 内置 Skills 详解
  • brainstorming / writing-plans / executing-plans
  • test-driven-development / systematic-debugging
  • code-review / subagent-driven-development
  • verification-before-completion / finishing-a-development-branch
• 17.3 自定义 Skill 编写
• 17.4 组织个人 Skill 库

第 18 章：Hooks 钩子系统

• 18.1 Hooks 架构：事件驱动的自动化
• 18.2 可用事件类型（PreToolUse / PostToolUse / SessionStart / Stop 等）
• 18.3 常用 Hook 场景
  • 自动执行代码格式化
  • 操作前自动备份
  • 自定义权限提醒
• 18.4 Hook 编写与调试

第 19 章：命令系统进阶

• 19.1 斜杠命令完整列表
• 19.2 自定义斜杠命令
• 19.3 键盘快捷键体系
• 19.4 自定义 Keybindings
• 19.5 常用操作的一键绑定

---

第五篇：实战篇 —— 真实场景案例

目标：通过真实开发场景的完整案例，将前四篇的知识融会贯通。

第 20 章：场景一：理解陌生项目

• 20.1 场景描述：接手一个遗留项目
• 20.2 第一步：让 Claude Code 建立项目认知
• 20.3 第二步：梳理核心业务流程
• 20.4 第三步：生成项目文档
• 20.5 第四步：识别技术债务
• 20.6 复盘与技巧总结

第 21 章：场景二：从零搭建新功能

• 21.1 场景描述：为一个 Web 应用新增用户认证模块
• 21.2 需求分析阶段
• 21.3 架构设计阶段
• 21.4 编码实现阶段
• 21.5 测试验证阶段
• 21.6 复盘与技巧总结

第 22 章：场景三：大规模重构

• 22.1 场景描述：将 jQuery 页面迁移到 React
• 22.2 评估与规划
• 22.3 分步重构策略
• 22.4 增量验证方法
• 22.5 复盘与技巧总结

第 23 章：场景四：调试与排错

• 23.1 场景描述：定位一个生产环境的棘手 Bug
• 23.2 让 Claude Code 分析错误日志
• 23.3 假设驱动的调试流程
• 23.4 逐步缩小问题范围
• 23.5 验证修复
• 23.6 复盘与技巧总结

第 24 章：场景五：Code Review

• 24.1 场景描述：审查一个 PR
• 24.2 代码质量问题识别
• 24.3 安全隐患扫描
• 24.4 性能问题发现
• 24.5 生成 Review 报告
• 24.6 复盘与技巧总结

第 25 章：场景六：测试编写

• 25.1 场景描述：为现有代码补充测试
• 25.2 单元测试生成
• 25.3 集成测试编写
• 25.4 测试覆盖率优化
• 25.5 复盘与技巧总结

第 26 章：场景七：文档生成

• 26.1 API 文档自动生成
• 26.2 架构决策记录（ADR）
• 26.3 README 与项目文档
• 26.4 复盘与技巧总结

第 27 章：场景八：CI/CD 集成

• 27.1 Claude Code 在 CI 中的角色
• 27.2 自动化 PR Review
• 27.3 自动化 Issue 分类
• 27.4 非交互模式的使用
• 27.5 复盘与技巧总结

---

第六篇：方法论篇 —— AI 编程之道

目标：超越工具本身，建立 AI 时代的编程思维和方法论。

第 28 章：Prompt 工程

• 28.1 好 Prompt 的四个要素（角色 / 上下文 / 约束 / 输出格式）
• 28.2 Prompt 模板库
  • 代码生成类
  • 代码分析类
  • 重构类
  • 调试类
  • 文档类
• 28.3 渐进式细化技巧
• 28.4 常见 Prompt 反模式
• 28.5 Claude Code 特有的 Prompt 技巧

第 29 章：让 AI 理解你的项目

• 29.1 项目结构设计原则（AI 友好型架构）
• 29.2 文件命名与组织规范
• 29.3 注释与文档策略
• 29.4 CLAUDE.md 作为“项目的说明书”
• 29.5 模块化与单一职责

第 30 章：人机协作模式

• 30.1 你的新角色：从写代码到定方向 + 审结果
• 30.2 分工原则：什么交给 AI，什么自己把控
• 30.3 信任梯度：逐步授予自主权
• 30.4 验证习惯：永远 Review AI 的输出
• 30.5 高效反馈循环：如何纠正 AI 的错误

第 31 章：效率优化策略

• 31.1 任务粒度：一次做多少最合适
• 31.2 上下文预算管理
• 31.3 模型选择经济学（成本 vs 质量）
• 31.4 批量任务策略
• 31.5 并行工作流的组织

---

第七篇：精通篇 —— 成为 Claude Code 专家

目标：掌握高级工作流、团队推广、自定义扩展和前沿探索。

第 32 章：高级工作流

• 32.1 多 Agent 协作（Subagent）
• 32.2 Plan 模式驱动的分阶段开发
• 32.3 多会话并行工作
• 32.4 Git Worktree 隔离开发
• 32.5 定时任务与自动化（Cron）
• 32.6 Workflow 编排

第 33 章：自定义扩展开发

• 33.1 编写自定义 MCP Server
• 33.2 编写自定义 Plugin
• 33.3 编写自定义 Skill
• 33.4 编写自定义 Hook
• 33.5 分享与发布扩展

第 34 章：团队推广指南

• 34.1 说服团队：ROI 论证
• 34.2 逐步推广策略
• 34.3 团队配置标准化
• 34.4 内部培训计划
• 34.5 常见阻力与应对
• 34.6 效果度量与持续优化

第 35 章：模型深度对比

• 35.1 Claude Opus 4.7 vs Sonnet 4.6 vs Haiku 4.5 实测对比
• 35.2 DeepSeek V4 Pro vs V4 Flash 实测对比
• 35.3 Claude vs DeepSeek 跨家族对比
• 35.4 不同任务类型的模型推荐矩阵
• 35.5 cc-switch 高级配置技巧

第 36 章：前沿探索与趋势

• 36.1 Agentic Coding 的发展趋势
• 36.2 MCP 协议的演进
• 36.3 AI 编程的伦理与边界
• 36.4 开发者的未来角色

---

第八篇：贯穿项目 —— “SmartTodo”全栈应用实战

目标：贯穿全书的大型实战项目，从零构建一个完整的前后端应用。各章节的实战内容逐步叠加，最终交付一个可部署上线的完整项目。

第 37 章：项目启动

• 37.1 项目介绍与技术选型
• 37.2 用 Claude Code 初始化项目
• 37.3 编写 CLAUDE.md
• 37.4 建立开发工作流

第 38 章：后端开发

• 38.1 数据库设计与 ORM 配置
• 38.2 API 路由与控制器
• 38.3 认证与授权
• 38.4 测试编写

第 39 章：前端开发

• 39.1 组件架构设计
• 39.2 页面实现
• 39.3 状态管理
• 39.4 与后端联调

第 40 章：部署与运维

• 40.1 构建配置
• 40.2 CI/CD 流水线
• 40.3 部署上线
• 40.4 监控与日志

---

附录

• 附录 A：Cheatsheet — 常用命令与快捷键速查
• 附录 B：settings.json 配置项完整参考
• 附录 C：环境变量完整参考表
• 附录 D：Prompt 模板速查
• 附录 E：cc-switch 配置速查卡
• 附录 F：常见问题排查指南
• 附录 G：术语表