院科协软件培训 · 执行提纲------YHT负责
一、你的任务概述
| 项目 | 内容 |
|---|---|
| 你负责 | 全程主讲（PPT制作 + 现场授课 + Demo演示） |
| 时间 | 共100-110分钟（含实操和答疑） |
| 目标 | 让现场80%的人装好环境、能用Claude Code写代码、能用Git管理代码 |
二、你不用操心的事（找两位部长包，你催进度）
- 借教室、测投影 ✅
- 发通知、拉群、统计人数 ✅
- 签到、拍照、写新闻稿 ✅
- 招募5名助手（大二/大三，精通环境安装，给义工时）✅
- 培训部员提前学会所有安装步骤（培训前一天，部长+助手必须全部跑通一遍）✅
- 提前在群文件上传所有离线安装包 ✅
⚠️ 重要：如果部员和助手自己都没装过，现场他们没法帮别人。培训前一天晚上，所有人必须完成一次完整安装演练。 遇到搞不定的，提前找我或WXT解决，不要把问题留到现场。
三、现场分工
| 角色 | 人员 | 职责 |
|---|---|---|
| 主讲 | YHT | 台上讲PPT、投屏演示每一步 |
| 巡场A组 | 部长1 + 助手2人 | 负责左半区，帮同学解决报错 |
| 巡场B组 | 部长2 + 助手3人 | 负责右半区，帮同学解决报错 |
| 总后勤 | 副主席 | 签到、拍照、控制时间 |
四、重要提醒（培训开场时就要说）
以下4点必须在PPT第2页就告诉所有人：
- 学校有公共WiFi直接连。
- 校园网可以直连GitHub，不需要翻墙。
- ESP-IDF安装很麻烦 ，今天不装，下周硬件培训会专门讲。今天只装Arduino IDE（轻量级，够用）。
- Arduino IDE今天装不好没关系，下周硬件培训会手把手带大家装。
五、PPT内容大纲（共约52页）
Part 0：课前准备
| 事项 | 具体操作 |
|---|---|
| 测试投影 | 带自己的HDMI转接头，确认能投屏 |
| 测试校园网+GitHub | 打开github.com，确认直连正常 |
| 测试DeepSeek APIKEY | 提前准备好可用的公共APIKEY（多备2个），现场演示时直接复制粘贴 |
| 准备离线包U盘 | 把Python/VS Code/Git/Minconda/Arduino IDE/Node.js 安装包都存一份 |
| 助手/部员提前到场 | 培训前30分钟到场，每人认领负责区域，调试好自己的电脑 |
Part 1：开场（4页，5分钟）
| 页码 | 内容 | 话术参考 |
|---|---|---|
| 1 | 封面 | "大家好，我是YHT。今天不考试、不点名，全程跟着点鼠标就行。" |
| 2 | 重要提醒（4条） | 1. 学校有公共WiFi 2. 校园网直连GitHub 3. ESP-IDF今天不装，下周硬件培训讲 4. Arduino装不好没关系，下周还教 |
| 3 | 今天的4个目标 | "装好基础环境、用AI帮你写代码、去GitHub偷代码、为下周点灯做准备。" |
| 4 | 资料获取方式 | 投屏显示：QQ群文件位置 + 所有离线包列表 |
Part 2：环境配置篇（14页，28分钟）
节奏控制：你点一步，等5秒，扫一眼全场，再点下一步。卡住的人交给巡场助手。
| 页码 | 内容 | 具体操作步骤 | 翻车点 + 解决 |
|---|---|---|---|
| 5 | Python安装 | 1. 双击安装包 2. 勾选"Add Python to PATH" ⚠️ 3. 点Install | 没勾PATH → 重装 |
| 6 | 验证Python | 终端输入 python --version |
提示"不是内部命令" → PATH没配 → 重装 |
| 7 | 讲一下Python是干嘛的 | "代码翻译官：你写的代码靠它变成电脑能执行的指令。做AI、数据处理、硬件上位机都要用它。" | --- |
| 8 | VS Code安装 | 1. 双击安装包 2. 全部默认选项 | 路径有中文 → 重装到英文路径 |
| 9 | VS Code必装插件 | 装3个：Python（微软）、GitLens、中文语言包 | 装不上 → 先跳过，回去再装 |
| 10 | 讲一下VS Code是干嘛的 | "代码编辑器，比记事本强一万倍。写代码、看代码、跑代码都在这里。" | --- |
| 11 | 第一个Python文件 | 新建 hello.py → 写 print("你好") → 运行 |
找不到运行键 → Ctrl+Shift+F10 |
| 12 | Git安装 | 双击 → 全部默认选项 | 选项看不懂 → 强调"全部默认" |
| 13 | 讲一下Git是干嘛的 | "代码时光机+云端备份。你写的代码可以随时恢复到任何一个历史版本，再也不怕删错了。" | --- |
| 14 | Git基础配置 | git config --global user.name "名字" git config --global user.email "邮箱" |
邮箱格式不对 → 必须是 xxx@xx.com |
| 15 | 讲一下备份的必要性 | "辛辛苦苦写三天，电脑一摔全完蛋。Git + GitHub = 代码永不丢失。" | --- |
| 16 | Miniconda安装（推荐） | 1. 双击安装包 2. 勾选"Add to PATH" ⚠️ 3. 重启终端验证 conda --version |
conda找不到 → 重装勾PATH |
| 17 | 讲一下Conda是干嘛的 | "Python环境管家。不同项目可能需要不同Python版本，conda帮你切换，互不干扰。" | --- |
| 18 | Arduino IDE安装（简化版） | 1. 双击安装包 2. 全部默认选项 3. 启动看界面是否正常 | 卡启动 → 直接说"没事，下周硬件培训我们会统一搞定，今天只要装上了就行" |
Part 3：Node.js环境（Claude Code前置条件）（5页，8分钟）
| 页码 | 内容 | 具体操作步骤 | 说明 |
|---|---|---|---|
| 19 | 为什么需要装Node.js？ | "Claude Code依赖Node.js环境运行。装了Node，才能用npm安装Claude Code。" | 话术：这只是个运行环境，不用理解它是什么 |
| 20 | Node.js安装 | 1. 双击安装包 2. 全部默认选项 | --- |
| 21 | 验证Node | 终端输入 node --version 和 npm --version |
两个都能看到版本号 = 成功 |
| 22 | 讲一下npm和nvm是什么 | • npm ：Node.js的"应用商店"，用来下载Claude Code • nvm：Node版本管理器（今天不装，了解一下就行） | "装好Node.js，npm自动就有了。" |
| 23 | 验证环境 | 确认Node 18+（node --version 显示的版本号大于18即可） |
--- |
Part 4：AI编程工具篇 ------ Claude Code 接入 DeepSeek（12页，22分钟）
核心逻辑： 我们不是用Claude官方（需要海外信用卡），而是用DeepSeek的API Key + 环境变量配置，让Claude Code跑在DeepSeek的模型上。效果一样，但完全免费（新用户送额度）且国内直连。
| 页码 | 内容 | 具体操作步骤 | 话术/说明 |
|---|---|---|---|
| 24 | 为什么要用DeepSeek接入Claude？ | "Claude官方需要海外信用卡，对大家不友好。DeepSeek国内可用，注册就送额度，API完全兼容Claude的调用方式。 我们搭桥，让Claude Code跑在DeepSeek上。" | 一句话：国产模型驱动国际工具 |
| 25 | 整体链路图（PPT画个流程图） | 流程图： DeepSeek官网注册 → 获取APIKEY → 安装Node.js → 安装Git → npm安装Claude Code → 配置环境变量 → 输入claude启动 |
"今天全程跟着我走完这7步，你就能在终端里拥有一个AI编程助手。" |
| 26 | 第一步：注册DeepSeek获取APIKEY | 1. 打开官网 platform.deepseek.com（投屏展示） 2. 注册/登录 3. 进入"API Keys"页面 4. 点击"创建API Key" 5. 复制并保存到本地txt文件 | 重要提醒： API Key只显示一次，务必保存好。忘了只能重新生成。 |
| 27 | 【操作顺序】 先发公共APIKEY | 现场提供2个公共KEY（提前准备好），投屏展示+发群 | "来不及注册的同学先用公共KEY，有效期2天，到时间我会关闭。建议大家之后自己注册，长期使用。" |
| 28 | 第二步：安装Node.js（前置） | 1. 双击安装包 2. 全部默认选项 3. 终端验证：node --version 和 npm --version |
--- |
| 29 | 第三步：安装Git（前置） | 双击安装包 → 全部默认选项 → 终端验证：git --version |
Windows用户必须装，否则Claude Code无法运行 |
| 30 | 第四步：安装Claude Code | 终端执行： npm install -g @anthropic-ai/claude-code 等待安装完成（约1-2分钟） |
翻车：权限不足 → 加sudo（Mac/Linux）或用管理员终端（Win） |
| 31 | 验证Claude Code安装 | 终端执行：claude --version 看到版本号 = 成功 |
--- |
| 32 | 第五步：配置环境变量（Windows演示） | 投屏演示Windows版（大部分新生用Win），逐条复制粘贴，每粘一条按回车 ： $env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN="你的APIKEY" $env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]" $env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]" $env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash" $env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash" $env:CLAUDE_CODE_EFFORT_LEVEL="max" $env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432" |
不要一次性粘全部，容易出错。 Mac/Linux用户单独展示： export 替换 $env:，格式为 export ANTHROPIC_BASE_URL="https://..." |
| 33 | 验证环境变量 | 终端执行：echo $env:ANTHROPIC_BASE_URL（Win）或 echo $ANTHROPIC_BASE_URL（Mac） |
能显示 https://api.deepseek.com/anthropic 即成功 |
| 34 | 第六步：启动Claude Code | 终端输入：claude 等待加载，看到 Claude Code ready 或类似提示 |
"如果第一次启动有点慢，正常。等着就行。" |
| 35 | 讲一下为什么不用B站教程 | "B站视频很好，但无法及时回复。我们的价值是实时反馈、现场解决。 " | --- |
Part 4.5：现场演示------用Claude Code写代码（5页，8分钟）
| 页码 | 内容 | 具体操作步骤 | 话术 |
|---|---|---|---|
| 36 | 新建一个项目文件夹 | mkdir claude-test → cd claude-test |
--- |
| 37 | 启动Claude Code | 在项目目录下输入 claude |
--- |
| 38 | 给Claude下指令 | 在终端里输入： 帮我写一个Python脚本，读取当前文件夹下所有txt文件，统计每个单词出现的次数，按次数从高到低排序输出。 |
展示AI在终端里逐行生成代码的过程 |
| 39 | 运行生成的代码 | 把生成的代码保存为 count.py → 终端执行 python count.py |
"全程你只做了一件事：说人话，告诉它你要什么。 代码是它写的。" |
| 40 | 总结 | "三分钟前你不会，现在已经'会'了。这就是AI时代。" | --- |
Part 5：GitHub篇（6页，12分钟）
| 页码 | 内容 | 具体操作步骤 | 说明 |
|---|---|---|---|
| 41 | GitHub是什么 | "代码界的社交平台+云备份。" | --- |
| 42 | 搜索与Clone | 搜"ESP32" → 找Star最多的 → Clone URL | --- |
| 43 | Clone到本地 | git clone URL |
网络不通 → 用镜像站 |
| 44 | Fork与Issue | 演示Fork到自己的仓库，搜Issue看别人踩过的坑 | "遇到问题先搜Issue，90%的坑有人踩过了。" |
| 45 | 开源协议速查 | MIT：随便用；GPL：用了你的代码也得开源 | --- |
| 46 | 用Claude Code帮你版本管理 | 在claude对话中输入： 帮我生成一个git commit消息，内容是修复了读取文件编码的bug 然后把AI生成的消息复制到 git commit -m "..." |
"提交信息都不用自己想了。" |
Part 6：现场实操（25分钟）
| 页码 | 内容 | 具体操作 |
|---|---|---|
| 47 | 发布任务 | "用Claude Code生成一个Python脚本：读取一个CSV文件，画出三列的折线图并保存为PNG。" |
| 48 | 大家自己做 | 5名助手 + 2名部长 全场巡场，一对一解决 |
| 49 | 跑通的举手拍照 | 拍照留底 |
Part 7：结尾 + 答疑（5分钟）
| 页码 | 内容 | 话术 |
|---|---|---|
| 51 | 今天你学会了什么 | "能装环境、能用Claude Code写代码、能从GitHub偷代码------入门了。" |
| 52 | 下周硬件培训预告 | "X月X日，教你点亮人生第一颗LED。Arduino没装好的没关系，下周我们现场搞定。" |
| 53 | 答疑 | 现场排队提问，解决不了的问题记录下来，培训后找我或WXT |
六、关于ESP-IDF的特别说明（YHT不用讲，但你要知道）
YHT，关于ESP-IDF：
- 今天不装，原因是你自己也知道------ESP-IDF安装要下载大量依赖，快则40分钟，慢则半天，现场搞不定。
- VS Code有ESP-IDF插件（搜索"ESP-IDF Extension"），下周硬件培训我们会用这个插件来简化安装流程。
- 所以你今天的PPT里完全不用提ESP-IDF，只说"Arduino IDE今天简单装，下周硬件培训会详细搞定ESP32开发环境"即可。
七、关于APIKEY的特别说明
操作顺序（重要）：
| 步骤 | 操作 | 说明 |
|---|---|---|
| 1 | 培训开始前 | 准备好2-3个公共APIKEY备用（DeepSeek平台生成） |
| 2 | Part 4 第27页 | 先把公共APIKEY投屏展示 + 发到群里，确保每个人都拿到KEY |
| 3 | 等大家复制好KEY | 扫视全场，确认大部分人已复制，再继续往下讲环境变量配置 |
| 4 | 继续演示 | 用同一个KEY配置环境变量，启动Claude Code |
| 5 | 培训结束后 | 2天后我会在后台关闭KEY，届时停止使用 |
关于大家自己注册DeepSeek：
- 现场如果时间够，可以让新生自己注册（手机号+验证码，2分钟搞定）
- 如果网速慢或注册拥堵，直接用公共KEY，回去后再自己注册长期使用
⚠️ 现场最容易出现的状况：你还没发KEY就开始讲环境变量配置，全场都在问"KEY填什么"。 所以务必做到：先发KEY，再配置环境变量。
八、关于Claude Code链路的总结（给YHT的一句话说明）
"我们走的是 DeepSeek API → 环境变量伪装成Anthropic → Claude Code调用 这条链路。DeepSeek兼容Claude的API格式，所以Claude Code以为自己连的是Claude官方，实际上调的是DeepSeek的模型。不需要海外信用卡，国内网络直连。 你只要按步骤操作就行，不需要跟新生深入解释原理，说'用DeepSeek驱动Claude Code'就够了。"
九、YHT需要提前准备的物料清单
| 物料 | 状态 | 备注 |
|---|---|---|
| PPT（按以上53页结构做） | 待做 | 培训前3天发我过目 |
| Python 3.x 离线安装包 | 存U盘+群文件 | |
| VS Code 离线安装包 | 存U盘+群文件 | |
| Git 离线安装包 | 存U盘+群文件 | |
| Miniconda 离线安装包 | 存U盘+群文件 | |
| Arduino IDE 离线安装包 | 存U盘+群文件 | |
| Node.js 离线安装包 | 存U盘+群文件 | |
| DeepSeek APIKEY × 3个（公共） | 提前准备好 | 先发KEY再演示。有效期2天，到时间我会关闭。 |
| DeepSeek官网注册流程截图（PPT备用） | 提前截好图 | 万一现场注册拥堵，直接用公共KEY跳过 |
| 签到表 | 部长准备 | |
| 助手/部员任务确认表 | 培训前1天确认所有人已演练过 |
十、时间节点
| 事项 | 截止时间 |
|---|---|
| 招募5名助手 + 确认名单 | 培训前5天 |
| 部员+助手完整安装演练（必须全部跑通） | 培训前1天晚上 |
| PPT初稿 | 培训前3天发我 |
| PPT定稿 + 所有离线包 + APIKEY就绪 | 培训前1天 |
| 去教室测试投影 | 培训当天 |
| 正式开讲 | 培训当天 |