Claude 从小白到大师:课程大纲
版本声明:本大纲对齐 2026 年 6 月官方文档状态(Claude Code 文档已改版:自定义斜杠命令并入 Skills,多端入口与自动化为新重点;模型家族为 Fable 5 / Opus 4.8 / Sonnet 5 / Haiku 4.5)。课程承诺随官方大版本更新。
修订记录:
- v2(2026-07-03):按「基础 → 进阶 → 高级」难度梯度重排为三部分九篇;移除 claude.ai 网页版专篇(不在本课范围);模型与提示工程前移至自动化之前;毕业项目改为二选一。目录设计对齐 claude-howto 的工程化原则(前置依赖 → 复杂度递增 → 使用频率)。
- v1(2026-07-03):初版,由 Claude(Fable 5)五路调研起草并与 GPT-5.5 独立版对照合并,见同目录《课程大纲·双模型对照报告》。
课程定位
- 主力受众:程序员(AI 小白但会编程,默认会终端和 Git)
- 次要受众:产品经理(第 0 篇 + 第 1、2 篇按「选学」标记跟随 + 第 4 篇提示工程;第三部分可跳过)
- 第三受众:计算机行业/想系统了解 Claude 的人(第 0 篇 + 各篇讲解课)
- 卖点:实战课带 Runbook(照抄可复现)· 参考链接可溯源 · 中国用户痛点专篇
- 目录设计原则(借鉴 claude-howto):篇章排序遵循三条工程原则——前置依赖(被依赖的先学)、复杂度递增(从简单到难)、使用频率(高频能力前置)。
入口自测:你该从哪一部分开始
逐项勾选(诚实作答):
- 我能启动
claude并完成一次对话 - 我创建或修改过 CLAUDE.md
- 我用过 3 个以上斜杠命令(/clear、/rewind、/model……)
- 我写过一个自己的 Skill(SKILL.md)
- 我配置过 MCP server(GitHub、数据库等)
- 我在 settings.json 里配过 hooks
- 我创建过自定义 subagent(.claude/agents/)
- 我用过
claude -p做脚本化或 CI/CD
| 勾选数 | 水平 | 建议起点 |
|---|---|---|
| 0-2 | 入门 | 第一部分(环境未就绪从第 0 篇起,已就绪从第 1 篇起) |
| 3-5 | 进阶 | 第二部分(第 3 篇起,用第一部分补缺) |
| 6-8 | 高级 | 第三部分(第 5 篇起,按需回查速查表) |
篇章总览(三部分,难度递增)
| 部分 | 篇 | 主题 | 难度 | 前置依赖 | 预估时长 |
|---|---|---|---|---|---|
| 第一部分 基础:跑起来 | 0 | 环境准备(中国用户专篇) | ⭐ | 无 | 3-4h |
| 1 | Claude Code 上手 | ⭐ | 第 0 篇 | 4-5h | |
| 2 | 核心工作流 | ⭐⭐ | 第 1 篇 | 6h | |
| 第二部分 进阶:定制与调优 | 3 | 扩展机制(Skills/Hooks/MCP/Subagents/插件) | ⭐⭐⭐ | 第 2 篇 | 6h |
| 4 | 模型与提示工程 | ⭐⭐⭐ | 第 2 篇 | 4h | |
| 第三部分 高级:工程化与开发 | 5 | 自动化、多端与团队 | ⭐⭐⭐⭐ | 第 3 篇 | 5-6h |
| 6 | Claude API 开发 | ⭐⭐⭐⭐ | 第 4 篇 + 会一门语言 | 6-7h | |
| 7 | Agent SDK 与毕业项目 | ⭐⭐⭐⭐⭐ | 第 6 篇 | 8-12h | |
| 8 | 结课 | — | 全部 | 2h | |
| 附录 | — | 速查表与资源合集 | — | 随查 | — |
全课共 68 课(实战课 49 门,全部带 Runbook),预估总时长 44-52 小时。
第一部分 基础:跑起来(Level 1)
第 0 篇 环境准备(中国用户专篇)
0.1 全景图:Claude 产品矩阵与你的学习地图 【讲解课】
用一张图讲清 claude.ai、Claude Code、API、Agent SDK 四个入口各解决什么问题、你该从哪里进,顺带把「AI 会不会取代我」的焦虑摆到桌面上聊透。做完你会得到一张按自己角色定制的学习路线图和一份前置条件清单(需要什么档位订阅、什么设备)。 参考:https://platform.claude.com/docs/en/intro.md · https://code.claude.com/docs/en/features-overview
0.2 接入路线决策:官方订阅 / Team 车 / API 中转 / 国产平替 【讲解课】
2026 年虚拟卡产业链覆灭、KYC 新政落地后,中国用户接入 Claude 只剩四条现实路线。这节课带你算清每条路线的成本、风险和适用人群,做完你会得到一张接入路线决策表,30 秒定位适合自己的方案。 参考:https://www.v2ex.com/t/1223484 · https://github.com/wmpeng/codingplan · https://www.21jingji.com/article/20260506/herald/2c23c0fbaa0f85c44e02443e2d91d547.html
0.3 账号注册与防风控 Runbook 【实战课】
注册即秒封、老号莫名被封是中文社区第一痛点。本课拆解 Claude 风控信号(IP/时区/指纹/客户端遥测),给出全流程注册操作。做完你会得到一套可复用的「海外身份一致性」注册与养号 Runbook。 参考:https://www.v2ex.com/t/1224025 · https://www.v2ex.com/t/1200112 · https://sspai.com/post/108063 · https://linux.do/t/topic/1982711
0.4 订阅与支付 Runbook:礼品卡、Google Play 与实体卡 【实战课】
WildCard 停运后国内双币卡在 Stripe 几乎全拒。本课给出三条经社区验证的付款通道的完整操作步骤和风险对比。做完你会得到一份能直接照抄的订阅付款 Runbook(含 App Store 外区礼品卡全流程)。 参考:https://www.v2ex.com/t/1205258 · https://global.v2ex.com/t/1186833 · https://www.xmsumi.com/detail/1208
0.5 网络环境与 IP 质量自检 Runbook 【实战课】
机场共享节点和数据中心 IP 是封号高危项,「假家宽」照样被封。本课教你自查 IP 质量、修好 WebRTC/DNS/时区泄漏。做完你会得到一份网络环境自检清单和一套固定出口的代理配置。 参考:https://www.v2ex.com/t/1224223 · https://www.v2ex.com/t/1143452 · https://v2ex.com/t/1212439
0.6 API 中转站避坑与验真 Runbook 【实战课】
中转站跑路、模型掺假、偷改倍率是重灾区。本课给出模型验真方法、充值纪律和口碑站筛选标准,并划清「临时测试可用、生产数据绝不可放」的底线。做完你会得到一份中转站验真 Runbook 和尽调检查单。 参考:https://segmentfault.com/a/1190000047718715 · https://linux.do/t/topic/1519722 · https://linux.do/t/topic/1312525
0.7 平替路线:国产模型接 Claude Code 【实战课】
不想承担封号与订阅成本?GLM Coding Plan、Kimi、DeepSeek 都能接进 Claude Code 的壳。本课讲透 ANTHROPIC_BASE_URL 原理、cc-switch 多配置切换和「官方模型决策 + 国产模型执行」的分层用法。做完你会得到一套一键切换多模型的 Claude Code 配置和一张同任务横评的模型对比表。 参考:https://linux.do/t/topic/1109956 · https://monkeywie.cn/posts/snap-up-glm-coding-plan · https://github.com/wmpeng/codingplan · https://zhuanlan.zhihu.com/p/1944667171704779382
0.8 风控、KYC 与数据隐私:规则、自救与底线 【讲解课】
讲清 KYC 身份验证新政对大陆用户的实际影响、封号后的申诉与数据抢救路径、训练数据开关怎么关,以及公司代码、客户数据哪些能给模型、哪些必须脱敏或走企业方案。做完你会得到一份封号自救 checklist 和一份数据分级与脱敏清单。 参考:https://www.v2ex.com/t/1206060 · https://zhuanlan.zhihu.com/p/1945772634404009208 · https://www.cnblogs.com/informatics/p/19808410
第 1 篇 Claude Code 上手(10 分钟跑起来)
1.1 安装与首次登录(macOS / Windows / Linux / WSL)【实战课】
三种官方安装方式 + 国内环境特有的 npm/WSL/代理坑位一次讲清。做完你会得到一个在自己机器上登录成功、能正常对话的 Claude Code 环境。 参考:https://code.claude.com/docs/en/quickstart · https://code.claude.com/docs/en/setup · https://code.claude.com/docs/zh-CN/troubleshoot-install · https://segmentfault.com/a/1190000047676028
1.2 第一小时:让 Claude 读项目、改代码、发提交 【实战课】
跟着做完你的第一个 AI 结对编程小时:让 Claude 分析项目结构、修改代码(提议→审批→编辑)、用对话完成 Git 提交。做完你会得到一次由 Claude 完成的真实代码提交和一份新手操作 Runbook。 参考:https://code.claude.com/docs/en/quickstart · https://code.claude.com/docs/en/common-workflows
1.3 建立你的 claude-learning-lab 学习仓库 【实战课】
全课贯穿设计:建一个专门沉淀 Claude 配置、提示词、评测样例、Runbook 和踩坑记录的 Git 仓库,后续每节实战课的产物都归档进去。做完你会得到一个随课成长的 claude-learning-lab 仓库——结课时它就是你的个人工具箱和作品集。 参考:https://code.claude.com/docs/en/quickstart · https://code.claude.com/docs/en/best-practices
1.4 Claude Code 如何工作:agent loop、内置工具与权限确认 【讲解课】
理解「收指令→选工具→执行→反馈」循环后,你对它的一切行为都能预判。做完你会得到一张 Claude Code 内置工具能力地图,知道它能动什么、不能动什么、什么时候会来问你。 参考:https://code.claude.com/docs/en/how-claude-code-works · https://code.claude.com/docs/en/tools-reference
1.5 上下文窗口:一切最佳实践的根源 【讲解课】
为什么会话越长越笨、什么时候该 /clear 什么时候该 /compact——官方把上下文管理列为所有最佳实践的第一原则。做完你会得到一套上下文管理决策规则(何时清、何时压、何时开新会话)。 参考:https://code.claude.com/docs/en/context-window · https://code.claude.com/docs/en/best-practices
1.6 后悔药:checkpoint 回滚与会话管理 【实战课】
先学会安全撤销,再放手实验。现场演示「让 Claude 搞砸再一键回滚」:/rewind 六个恢复选项、--continue/--resume 续聊。做完你会得到一套敢放手让 AI 大改代码的安全网操作 Runbook。 参考:https://code.claude.com/docs/en/checkpointing · https://code.claude.com/docs/en/sessions
1.7 VS Code 里的 Claude Code 【实战课】
在最主流的 IDE 里跑通全流程:@ 引用选区、diff 审阅直接编辑、权限模式切换、恢复云端会话。做完你会得到一个配置完整的 VS Code + Claude Code 工作环境。(Cursor 用户同样适用;JetBrains 用户见参考链接) 参考:https://code.claude.com/docs/en/vs-code · https://code.claude.com/docs/en/jetbrains
1.8 速查表①:高频命令、快捷键与 CLI 参数 【讲解课·速查】
把日常 90% 会用到的斜杠命令、快捷键、CLI 参数压进一张表。做完你会得到一张可打印的 Claude Code 高频操作速查表。 参考:https://code.claude.com/docs/en/commands · https://code.claude.com/docs/en/interactive-mode · https://code.claude.com/docs/en/cli-reference
第 2 篇 核心工作流:像高手一样驱动 Claude
2.1 标准工作流:Explore → Plan → Code → Commit 【实战课】
官方最佳实践的核心四阶段 + Plan Mode 实操:先让 Claude 只读探索、出计划、你编辑计划、再放行实现。做完你会得到一套可复用的四阶段工作流 Runbook 和一份 Plan Mode 使用清单。 参考:https://code.claude.com/docs/en/best-practices · https://code.claude.com/docs/en/common-workflows
2.2 CLAUDE.md 与记忆体系 【实战课】
/init 生成项目记忆、四级 CLAUDE.md 加载顺序、.claude/rules/ 路径作用域规则、auto memory 双记忆体系及其治理(错误记忆要定期清)。做完你会得到一份为自己项目量身定制的 CLAUDE.md、rules 目录和一份记忆治理清单。 参考:https://code.claude.com/docs/en/memory
2.3 提示词精确化:同一个需求的两种命运 【实战课】
用官方 Before/After 对照表演示模糊指令和精确指令的结果差距,总结「给验证手段、给边界、给上下文」三原则。做完你会得到一套需求描述模板,让返工率肉眼可见地下降。 参考:https://code.claude.com/docs/en/best-practices · https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices.md
2.4 读懂陌生代码库 【实战课】
接手新项目的三步法:概览→定位代码→追执行流,产出一份人和 AI 都能用的项目导览。做完你会得到一份「一小时上手陌生仓库」的提问剧本和一份项目导览文档(docs/project-map.md)。 参考:https://code.claude.com/docs/en/common-workflows
2.5 修 Bug 工作流 【实战课】
先复现、再定位、最小修改、回归测试的标准回路,以及怎么让 Claude 自己验证修没修好。做完你会得到一套带验证闭环的修 Bug Runbook 和一个可复现 bug 的修复 PR。 参考:https://code.claude.com/docs/en/common-workflows · https://code.claude.com/docs/en/best-practices
2.6 重构与补测试 【实战课】
先补保护性测试、再小步重构、行为保持验证的安全流程,配合 checkpoint 兜底。做完你会得到两份可直接套用的重构/补测试指令模板。 参考:https://code.claude.com/docs/en/common-workflows
2.7 Git 与 PR:从提交到代码审查 【实战课】
对话式 Git 操作、创建 PR、--from-pr 回溯会话、/code-review 自动审查(每条意见绑定文件行号与证据)。做完你会得到一条从改代码到 PR 合并的全 AI 辅助流水线和一份代码审查报告模板。 参考:https://code.claude.com/docs/en/common-workflows · https://code.claude.com/docs/en/code-review
2.8 权限系统:少打断、不失控 【实战课】
deny→ask→allow 规则语法、六种权限模式(含 Plan/Auto Mode)、沙箱双层防御,以及数据库迁移、删文件、执行脚本等危险操作的边界设定。做完你会得到一份为自己项目调好的权限 allowlist 配置和一份危险操作审批清单。 参考:https://code.claude.com/docs/en/permissions · https://code.claude.com/docs/en/permission-modes · https://code.claude.com/docs/en/sandboxing
2.9 多模态开发:截图驱动 UI 【实战课】
拖拽/Ctrl+V 贴图、让 Claude 照着设计稿写界面、用截图反馈改样式。做完你会得到一套「设计稿→代码→截图验收」的 UI 迭代 Runbook。 参考:https://code.claude.com/docs/en/common-workflows
2.10 坑合集①:五大失败模式与四级验证强度 【讲解课】
官方总结的五大常见失败模式(上下文污染、无验证放飞、模糊指令等)与对应修复,四级验证强度怎么选。做完你会得到一张失败模式自查对照表,翻车时按图索骥。 参考:https://code.claude.com/docs/en/best-practices · https://code.claude.com/docs/en/troubleshooting
第二部分 进阶:定制与调优(Level 2)
第 3 篇 扩展机制:把 Claude Code 改造成专属工具
3.1 扩展机制全景:Skills / Hooks / MCP / Subagents / 插件怎么选 【讲解课】
五种扩展机制解决五类问题,选错机制事倍功半。做完你会得到一张「需求→机制」决策表:想加指令用什么、想强制执行用什么、想接外部系统用什么。 参考:https://code.claude.com/docs/en/features-overview
3.2 第一个 Skill:把重复指令变成一条命令 【实战课】
SKILL.md 结构、frontmatter、$ARGUMENTS 传参、自动触发 vs 手动调用(注:自定义斜杠命令已并入 Skills)。做完你会得到一个自己写的、能用 /命令名 调用的 Skill,并掌握把任意重复工作固化成 Skill 的方法。 参考:https://code.claude.com/docs/en/skills
3.3 Hooks:保存即格式化、敏感文件保护、桌面通知 【实战课】
Hooks 是生命周期上确定性执行的 shell 命令——CLAUDE.md 是建议,Hooks 是强制。三个 5 分钟见效的例子带你入门。做完你会得到三个能直接抄进项目的 hook 配置(自动格式化/保护文件/任务完成通知)。 参考:https://code.claude.com/docs/en/hooks-guide · https://code.claude.com/docs/en/hooks
3.4 MCP:接入第一个外部服务 【实战课】
四种传输方式安装命令、local/project/user 三种 scope、OAuth 认证,实战接入 GitHub 或数据库 MCP server,并讲清过度授权、数据外泄等安全边界。做完你会得到一个连着真实外部服务的 MCP 配置和一份 MCP 接入安全审查清单。 参考:https://code.claude.com/docs/en/mcp · https://code.claude.com/docs/en/mcp-quickstart
3.5 Subagents:给自己配一队专家 【实战课】
子代理的独立上下文价值、.claude/agents/ 定义格式、自动委派与显式调用,照抄官方 code-reviewer/debugger 示例再改成自己的。做完你会得到两个跑在自己项目里的定制 subagent。 参考:https://code.claude.com/docs/en/sub-agents
3.6 个性化配置:settings、输出风格与状态栏 【实战课】
四层 settings 作用域与优先级、输出风格定制、statusline 玩法。做完你会得到一份团队可共享的项目级 settings.json 和一个个性化状态栏。 参考:https://code.claude.com/docs/en/settings · https://code.claude.com/docs/en/statusline · https://code.claude.com/docs/en/output-styles
3.7 打包成插件:团队规范一键分发 【实战课】
把前面做的 Skills/Hooks/agents 组装进一个插件工程(plugin.json + 各组件目录),本地测试到 marketplace 分发,顺带给出第三方插件的评估标准。做完你会得到一个可安装、可分发的团队规范插件——这也是本篇的整合项目。 参考:https://code.claude.com/docs/en/plugins · https://code.claude.com/docs/en/plugin-marketplaces
3.8 速查表②:配置文件、目录结构与扩展机制对照 【讲解课·速查】
~/.claude 和 .claude/ 里每个文件是干什么的、五种扩展机制的触发时机与适用场景对照。做完你会得到一张配置文件地图和扩展机制对照速查表。 参考:https://code.claude.com/docs/en/settings · https://code.claude.com/docs/en/memory · https://code.claude.com/docs/en/glossary
第 4 篇 模型与提示工程:跟 Claude 说话的学问
4.1 模型家族与选型:Fable 5 / Opus 4.8 / Sonnet 5 / Haiku 4.5 【讲解课】
模型能力/价格/上下文窗口对比、知识截止时间、什么任务配什么模型。做完你会得到一张模型选型决策表和成本速算方法。 参考:https://platform.claude.com/docs/en/about-claude/models/overview.md · https://platform.claude.com/docs/en/about-claude/pricing.md
4.2 先定成功标准,再调 Prompt:评测驱动实战 【实战课】
官方提示工程指南第一课不是技巧而是方法论:先定义成功标准和评测,再动 prompt。本课选 5 个真实任务,为每个写成功标准和评测样例,再用它横向比较不同 prompt。做完你会得到一套自己的 Prompt 评测样例集——后续所有实战课都用它验收。 参考:https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/overview.md
4.3 提示工程核心技法 【实战课】
清晰直接、示例(multishot)、XML 标签、角色扮演、长上下文技巧——每个技法配对比实验。做完你会得到一套做过 A/B 验证的提示技法笔记和官方互动教程的练习成果。 参考:https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices.md · https://github.com/anthropics/prompt-eng-interactive-tutorial
4.4 Agent 时代的提示工程:防幻觉、防过度积极、长程任务 【实战课】
官方指南 2026 新增的 Agent 章节:长程推理与状态跟踪、防乱建文件、防应试硬编码、减少幻觉。做完你会得到一份 Agent 系统提示词检查清单,直接用于你的 Claude Code 和 SDK 项目。 参考:https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices.md
4.5 Prompt 模板库与招式表 【讲解课·速查】
把全课提示技法沉淀成中文命名的「招式表」,配官方 prompt library 精选模板的本地化改写,归档进你的 learning-lab 仓库。做完你会得到一个拿来即用的 prompt 模板库(含开发/写作/分析三类场景,每条带成功标准与反例)。 参考:TODO:官方 Prompt Library 页面 · https://www.coursera.org/learn/prompt-engineering(模式命名法参考)
第三部分 高级:工程化与开发(Level 3)
第 5 篇 自动化、多端与团队
5.1 worktree 并行与双会话模式 【实战课】
claude --worktree 隔离并行任务、Writer/Reviewer 双会话互查、多方案并行探索后择优合并。做完你会得到一套同时推进多个任务的并行工作流配置和一份多方案实验模板。 参考:https://code.claude.com/docs/en/worktrees · https://code.claude.com/docs/en/best-practices
5.2 headless 脚本化:claude -p 进流水线 【实战课】
非交互模式、管道输入、JSON 结构化输出、--allowedTools 自动批准,实战做一个「AI linter」。做完你会得到一个接进 package.json/CI 的 AI 审查脚本。 参考:https://code.claude.com/docs/en/headless
5.3 GitHub Actions:在 PR 里 @claude 【实战课】
/install-github-app 一键安装,评论区 @claude 实现修复与答疑,定时任务 workflow(GitLab 用户见参考链接)。做完你会得到一个在自己仓库跑起来的 @claude 机器人(含可照抄的 workflow yaml)。 参考:https://code.claude.com/docs/en/github-actions · https://code.claude.com/docs/en/gitlab-ci-cd
5.4 定时与循环任务:Routines、/loop 与桌面定时 【实战课】
四种定时方案对比选型,配置每天自动跑的例行任务。做完你会得到一个真实运行的定时任务(如每日依赖检查/仓库健康巡检报告)。 参考:https://code.claude.com/docs/en/routines · https://code.claude.com/docs/en/scheduled-tasks · https://code.claude.com/docs/en/common-workflows
5.5 多智能体:agent teams 与 Agent View 【实战课】
多会话编排、共享任务列表、一屏监控多个后台 agent、复杂任务按研究/实现/测试/审查四角色拆解。做完你会得到一次多 agent 协作完成真实任务的完整编排配置和一份复杂任务拆解 Runbook。 参考:https://code.claude.com/docs/en/agent-teams · https://code.claude.com/docs/en/agent-view · https://code.claude.com/docs/en/agents
5.6 多端入口:桌面端、Web 版、Slack、Chrome 与手机远控 【讲解课】
Claude Code 已不止于终端:桌面 App、云端 Web 会话(--teleport 拉回本地)、Slack @Claude、Chrome 浏览器操控、手机远程控制。做完你会得到一张多端能力对照表,知道什么场景切什么端。 参考:https://code.claude.com/docs/en/desktop · https://code.claude.com/docs/en/claude-code-on-the-web · https://code.claude.com/docs/en/slack · https://code.claude.com/docs/en/chrome · https://code.claude.com/docs/en/remote-control
5.7 成本与限额管理:把额度花在刀刃上 【实战课】
Pro/Max 限额机制、模型切换与 effort 调节、用量监控、「贵模型决策 + 便宜模型执行」分流策略——直击社区限额焦虑。做完你会得到一套限额优化配置和自己的用量监控面板。 参考:https://code.claude.com/docs/en/costs · https://code.claude.com/docs/en/model-config · https://code.claude.com/docs/en/monitoring-usage · https://www.v2ex.com/t/1209890 · https://www.v2ex.com/t/1142519
5.8 团队与企业治理:从个人工具到团队能力 【讲解课】
面向 team lead:企业部署方式对比(Teams/Console/Bedrock/Vertex)、组织级 CLAUDE.md 与托管安全策略、成员用量分析、审计与合规边界。做完你会得到一份 Claude Code 团队试点方案模板(账号、权限、数据、成本四条边界)。 参考:https://code.claude.com/docs/en/third-party-integrations · https://code.claude.com/docs/en/admin-setup · https://code.claude.com/docs/en/analytics
第 6 篇 Claude API 开发:从第一次调用到生产级
6.1 第一次 API 调用 【实战课】
Console 开号、拿 Key、装 SDK、发出第一条消息,含中国开发者的计费与网络注意事项。做完你会得到一个跑通的 API 开发环境和第一段可复用的调用代码。 参考:https://platform.claude.com/docs/en/get-started.md
6.2 Messages API 核心:多轮对话与流式输出 【实战课】
无状态 API 的多轮对话管理、system prompt、SSE 流式事件处理。做完你会得到一个带流式输出的命令行聊天机器人(Python/TS 双版本代码)。 参考:https://platform.claude.com/docs/en/build-with-claude/working-with-messages.md · https://platform.claude.com/docs/en/build-with-claude/streaming.md
6.3 多模态输入:图片、PDF 与引用溯源 【实战课】
vision 图片输入、PDF 文档块、Files API 一传多用、citations 引用定位。做完你会得到一个「扔 PDF 进去、带页码引用的答案出来」的文档问答脚本。 参考:https://platform.claude.com/docs/en/build-with-claude/vision.md · https://platform.claude.com/docs/en/build-with-claude/pdf-support.md · https://platform.claude.com/docs/en/build-with-claude/files.md · https://platform.claude.com/docs/en/build-with-claude/citations.md
6.4 Tool use:让 Claude 调用你的函数 【实战课】
工具定义、tool_use/tool_result 回路、并行调用、strict 模式,跟着官方教程构建一个会用工具的 agent。做完你会得到一个能查天气/查数据库的工具调用 agent 完整代码。 参考:https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview.md · https://platform.claude.com/docs/en/agents-and-tools/tool-use/build-a-tool-using-agent.md · https://platform.claude.com/docs/en/agents-and-tools/tool-use/define-tools.md
6.5 服务端工具:搜索、代码执行与 computer use 【实战课】
官方托管的 web search/web fetch/code execution/computer use 工具的接入与计费,以及哪些工具适合托管、哪些该自己实现。做完你会得到一个带联网搜索和沙箱代码执行能力的分析 agent。 参考:https://platform.claude.com/docs/en/agents-and-tools/tool-use/server-tools.md · https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool.md · https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool.md · https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool.md
6.6 结构化输出与思考控制 【实战课】
structured outputs 的 json_schema 强约束、adaptive thinking、effort 五档调节。做完你会得到一个稳定输出合法 JSON 的信息抽取服务(附 schema 设计清单)。 参考:https://platform.claude.com/docs/en/build-with-claude/structured-outputs.md · https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking.md · https://platform.claude.com/docs/en/build-with-claude/effort.md
6.7 降本三板斧:Prompt Caching、Batch 与模型分层 【实战课】
缓存省 90%、Batch 五折、便宜模型分流的组合拳,含 cache 命中验证方法。做完你会得到一份自己业务的成本优化改造清单和实测省钱数据。 参考:https://platform.claude.com/docs/en/build-with-claude/prompt-caching.md · https://platform.claude.com/docs/en/build-with-claude/batch-processing.md · https://platform.claude.com/docs/en/about-claude/pricing.md · https://platform.claude.com/docs/en/build-with-claude/token-counting.md
6.8 生产可靠性实战:限速、重试与降级 【实战课】
RPM/ITPM/OTPM 三维限速、cache-aware 限速红利、429/529 重试退避、stop reason 处理、模型降级 fallback。做完你会得到一个生产级 API 调用封装(自动重试/降级/错误日志),可直接抄进项目。 参考:https://platform.claude.com/docs/en/api/rate-limits.md · https://platform.claude.com/docs/en/build-with-claude/handling-stop-reasons.md · TODO:API errors 参考页
6.9 云平台接入:Bedrock / Vertex / Foundry 【讲解课】
六种部署方式对比、云平台的模型 ID 与功能差异——对国内企业这也是绕开 KYC 的合规路径。做完你会得到一张企业接入方案对比决策表。 参考:https://code.claude.com/docs/en/third-party-integrations · https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock.md · https://platform.claude.com/docs/en/build-with-claude/claude-on-vertex-ai.md
6.10 速查表③:模型、价格与 API 参数 【讲解课·速查】
模型 ID/价格/上下文/限速档位/常用参数一表打尽。做完你会得到一张 API 开发桌面速查表(含成本估算公式)。 参考:https://platform.claude.com/docs/en/about-claude/models/overview.md · https://platform.claude.com/docs/en/about-claude/pricing.md
第 7 篇 Agent SDK 与毕业项目
7.1 Agent 架构选型:四条路怎么选 【讲解课】
Client SDK vs Agent SDK vs Claude Code CLI vs Managed Agents 官方对比:什么时候自己搭、什么时候用现成的。做完你会得到一张 Agent 技术选型决策树。 参考:https://code.claude.com/docs/en/agent-sdk/overview
7.2 Agent SDK 快速上手:一个会修 Bug 的 agent 【实战课】
pip/npm 安装、query() 核心 API、消息流处理,跟官方 quickstart 做出第一个 agent。做完你会得到一个能在你的仓库里自动修 bug 的 agent 脚本(Python/TS 双版本)。 参考:https://code.claude.com/docs/en/agent-sdk/quickstart · https://code.claude.com/docs/en/agent-sdk/python · https://code.claude.com/docs/en/agent-sdk/typescript
7.3 自定义工具与 MCP:浏览器自动化 agent 【实战课】
进程内自定义工具(把你的业务函数变成 agent 能力)、接入 Playwright MCP 做浏览器自动化。做完你会得到一个能自己打开网页、操作表单、抓结果的自动化 agent。 参考:https://code.claude.com/docs/en/agent-sdk/custom-tools · https://code.claude.com/docs/en/agent-sdk/mcp
7.4 生产级控制:权限、Hooks 与 Subagents 【实战课】
SDK 里的权限审批回调、生命周期 hooks、AgentDefinition 子代理编排。做完你会得到一个带人工审批关卡和审计日志的多 agent 工作流。 参考:https://code.claude.com/docs/en/agent-sdk/permissions · https://code.claude.com/docs/en/agent-sdk/hooks · https://code.claude.com/docs/en/agent-sdk/subagents
7.5 会话、结构化输出与可观测性 【实战课】
会话续传/fork、外部存储持久化、结构化输出、成本追踪与 OpenTelemetry。做完你会得到一个记得住历史、输出可解析、成本可监控的 agent 服务骨架。 参考:https://code.claude.com/docs/en/agent-sdk/sessions · https://code.claude.com/docs/en/agent-sdk/structured-outputs · https://code.claude.com/docs/en/agent-sdk/cost-tracking
7.6 部署上线与安全 【实战课】
hosting 部署模式、secure deployment 清单、密钥/限流/健康检查工程化,参考官方 demo 仓库的完整工程。做完你会得到一个部署到服务器、可对外服务的 agent 应用。 参考:https://code.claude.com/docs/en/agent-sdk/hosting · https://code.claude.com/docs/en/agent-sdk/secure-deployment · https://github.com/anthropics/claude-agent-sdk-demos
7.7 Managed Agents 与 Agent 工程趋势 【讲解课】
Anthropic 托管 agent 服务:Agent/Session/Environment 模型、事件流、定时部署、计费。做完你会得到一份「自托管 vs 托管」迁移评估清单,以及对 2026 Agent 技术路线的判断框架。 参考:https://platform.claude.com/docs/en/managed-agents/overview.md
7.8 毕业项目(二选一):一句话需求,自己带 Claude 完成 【实战课】
脚手架全部撤掉,只给验收标准,按方向二选一:A. AI 代码维护助手(Claude Code 工程化路线:CLAUDE.md+Skills+权限+Hooks+GitHub Actions 串成完整工程流水线);B. 可部署业务 Agent(开发路线:Agent SDK+自定义工具+MCP+会话持久化+部署上线)。做完你会得到一个可写进简历的完整作品集项目。 参考:https://github.com/anthropics/claude-agent-sdk-demos · https://code.claude.com/docs/en/github-actions · https://courseking.org/udemy-course-reviews/review-udemys-100-days-of-code-the-complete-python-pro-bootcamp-course/(脚手架递减设计参考)
第 8 篇 结课
8.1 毕业答辩:评测、复盘与工作流固化 【实战课】
不是展示 PPT,而是回到你在 4.2 定下的成功标准:跑验收脚本、统计成本与失败案例、把最有价值的 prompt/Skill/配置固化进 learning-lab 仓库。做完你会得到一份 Claude 工作流复盘报告,分清哪些流程值得长期使用、哪些只是课程练习。 参考:https://code.claude.com/docs/en/best-practices · https://platform.claude.com/docs/en/build-with-claude/token-counting.md
8.2 期末自测与能力 checklist 【讲解课】
按「我做过 X」而非「我懂 X」的行为化标准自测全课六大能力块。做完你会得到一份大师级能力对照 checklist 和补课路径建议。 参考:https://github.com/luongnv89/claude-howto(LEARNING-ROADMAP 自测设计参考)
8.3 保持更新:信息源与学习路径 【讲解课】
Claude 迭代极快,课程完结不是终点:官方 changelog、whats-new、值得关注的社区与信息源。做完你会得到一份持续跟进 Claude 生态的信息源订阅清单。 参考:TODO:code.claude.com changelog/whats-new 页 · https://code.claude.com/docs/en/glossary
附录(随课更新)
- 附 A:全书速查表合集(命令/配置/权限规则/模型价格四张表汇总下载)【速查】
- 附 B:踩坑合集总索引(按报错信息检索,覆盖安装/网络/账号/限额/上下文/权限/工具调用全链路)【速查】参考:https://segmentfault.com/a/1190000047676028 · https://code.claude.com/docs/en/troubleshooting
- 附 C:术语表(agent/MCP/token/上下文窗口等中英对照)参考:https://code.claude.com/docs/en/glossary
- 附 D:全课 Runbook 总集(所有实战课 Runbook 按「目标/前置条件/步骤/验证/回滚」统一格式汇编成 SOP 手册)
- 附 E:课程交付物总清单(按「Claude Code 工程化 / API·Agent 开发」两条主线列出全部结课资产,购前展示与结课对账两用)