5 分钟在浏览器里跑通生成式 AI 课程generative-ai-for-beginners 云端开发环境与 API 密钥配置完整指南【免费下载链接】generative-ai-for-beginners21 Lessons, Get Started Building with Generative AI项目地址: https://gitcode.com/GitHub_Trending/ge/generative-ai-for-beginnersgenerative-ai-for-beginners 是一门覆盖 21 节课、教你动手构建生成式 AI 应用的开源课程。本文解决两件事零安装搭好云端开发环境以及把 API 密钥安全地注入课程代码。主线按你的实际操作顺序展开Fork 仓库 → 创建 Codespaces 实例 → 注入密钥 → 运行第一个示例 → 故障速查全程约 10 分钟即可进入动手环节。为什么值得先选云端三格对比看懂成本课程官方指南 01-setup-cloud.md 开篇就写明了适用人群如果你不想在本地安装任何东西请使用本指南。它给出的三格对比翻译过来就是零安装只要有浏览器就能学习Chromebook、iPad、学校机房电脑都行预置开发容器Python 3、Node.js、.NET、Java 运行时已内置第 13 行免费额度个人账户每月 120 core-hours / 60 GB-hours第 14 行。⚠️ 上表的额度数字引自课程文档原文。GitHub 的免费配额与计费规则可能随时间调整请以 GitHub 官方当前条款为准。对只想快速体验大模型 API 的初学者来说这意味着省掉了装 Python、装依赖、装 IDE 扩展的全部前置工作——Fork 仓库里预置的Dev Container开发容器配置会替你完成这一切。Fork 加两步点击课程进入你自己的账号创建过程在官方文档里被压缩成两步第 22–29 行Fork 仓库点仓库页面右上角的Fork按钮把 21 节课的代码复制到你自己的账户下。先 Fork 的原因很实际——后面的作业需要你能自由改代码、提交变更而且 Codespaces 建在 Fork 上更安全你的密钥和改动都不会污染上游。新建 Codespace在你的 Fork 页面点击Code ▸ Codespaces ▸ Create codespace on main在main分支上创建云端工作区。浏览器随即打开一个 VS Code 窗口并开始构建容器文档原话是首次构建约需 2 分钟第 29 行之后因为有缓存会明显更快。构建清单全公开41 行 devcontainer.json 决定一切预装依赖不是宣传语。仓库根目录的 .devcontainer/devcontainer.json 一共 41 行把构建管线写得清清楚楚按行拆开看第 5 行基础镜像mcr.microsoft.com/devcontainers/universal:2.13——GitHub 官方通用镜像Python 3、Node.js、.NET、Java 运行时都在里面第 6–11 课的各种脚本因此能直接跑第 6–8 行hostRequirements.cpus: 4声明需要至少 4 核的规格这是首次 2 分钟假设的机器前提第 10 行updateContentCommand执行python3 -m pip install -r requirements.txt把 requirements.txt 里的 10 个依赖装进容器其中python-dotenv1.2.2第 6 行和openai1.12.0第 7 行正是后面读密钥的两个关键包第 11 行postCreateCommand调用 .devcontainer/post-create.sh 脚本额外安装python-dotenv、openai以及ruff、black、mypy、pytest四件开发工具。脚本里的注释写明这四件与仓库 CI 的code-quality.yml质量检查保持一致方便贡献者本地复现同样的结果第 17–26 行自动安装 8 个 VS Code 扩展包括 Python、Pylance、Jupyter、Black、Ruff、ESLint、Prettier、GitHub Copilot第 28 行开启editor.formatOnSave保存即格式化且第 29–37 行为 Python 绑定 Black、为 JavaScript/TypeScript 绑定 Prettier。所以在你按运行键的那一刻运行时、包依赖、代码检查器、IDE 扩展全部就位——开箱即用的出处就是这份 41 行的清单。API 密钥安全配置两种方式的汇合点代码能跑还缺一把钥匙——API 密钥。课程的总原则见 02-setup-local.md 第 141 行永远不要把密钥写进代码并提交到仓库而是注入环境变量让代码运行时从环境里取。官方给了两种方式方式 ACodespaces Secrets云端推荐。操作路径在官方文档第 35–37 行点左下角 ⚙️ 齿轮图标进入命令面板 →Codespaces: Manage user secret → Add a new secret→ 名称填OPENAI_API_KEY→ 值粘贴你的密钥 → 保存。文档原话是我们的代码会自动识别它。方式 B.env 文件本地或 Docker Desktop 场景必选。仓库自带模板 .env.copy只需两步cp .env.copy .env然后用编辑器打开.env把OPENAI_API_KEYadd your OpenAI API key here模板第 2 行右侧的占位符换成真实密钥。.env已被 .gitignore 第 123 行列入忽略清单永远不会进入版本库。两种方式的区别如下对比项方式 ACodespaces Secrets方式 B.env 文件密钥存放位置加密托管在 GitHub 账户配置中仓库根目录的本地文件适用环境仅 GitHub Codespaces03-providers.md 第 67 行明确说明Codespaces、Docker Desktop、纯本地皆可代码读取机制启动时自动成为进程环境变量由python-dotenv的load_dotenv()载入防泄漏保障密钥不落盘依赖 .gitignore 拦截提交为什么两种方式都有效看 shared/python/env_utils.py 的源码就明白了。get_required_env第 11–35 行用os.getenv从进程环境变量取值缺失时抛出的报错明确写着Please set it in your .env file or environment第 33 行validate_env_vars第 38–71 行负责批量校验多个变量。也就是说课程代码拿到的永远是同一个环境变量——Secrets 注入和.env兜底殊途同归。这也是为什么没配置某个服务商时作业只会得到一条清晰的缺变量提示而不是把整个学习环境卡死。模板 .env.copy 不止预置了 OpenAI 一家还留好了 Azure OpenAI已并入 Microsoft Foundry、Microsoft Foundry Models、Hugging Face 的变量位。其中AZURE_OPENAI_API_VERSION在第 7 行已设默认值2024-10-21无需改动。文件名带aoai/oai/hf/githubmodels标记的作业分别对应不同服务商各变量怎么从控制台获取见课程内的 03-providers.md。三条命令自检然后跑第一课示例容器就绪、密钥就位后打开 Codespace 终端做三件快速自检确认密钥已注入python -c import os; print(os.getenv(OPENAI_API_KEY) is not None)输出True即 ✅ 生效输出False回到上一节检查名称是否拼写为OPENAI_API_KEY。确认依赖齐全pip show openai python-dotenv跑一个真实示例打开第 6 课的 oai-app.py 在编辑器里直接运行。若返回401 Unauthorized通常是密钥填错或已过期重新生成后再更新即可。故障速查表五个高频症状与官方解法免费额度需要经营环境偶发问题也有套路。课程总览 00-course-setup/README.md 第 40–46 行整理了一张排障表改写如下你看到的现象对应处理容器构建卡住超过 10 分钟Codespaces 菜单选Rebuild Container重建容器终端报python: command not found终端没挂进容器点号手动选bashOpenAI 返回401 UnauthorizedOPENAI_API_KEY填错或已过期重新生成界面一直停在 Dev container mounting…刷新浏览器标签页即可恢复连接Notebook 找不到内核Notebook 菜单 → Kernel → Select Kernel → Python 3配额健康提示闲置的 Codespace 会持续烧掉免费额度。不学习时通过 视图 ▸ 命令面板 ▸Codespaces: Stop Codespace停掉它或直接删除官方指南第 16–18 行就是这么建议的。三条路线云端、本地还是多家服务商云端只是课程设置00-course-setup给出的路径之一按条件对号入座继续云端确认已完成 Fork → 建 Codespace → 注入密钥三步直接进入 第 1 课本地/离线学习02-setup-local.md 提供原生 Python 虚拟环境要求 Python 3.10第 11 行、VS Code Docker 容器首次构建约 3 分钟第 66 行、Miniconda 等选项克隆仓库即可开始git clone https://gitcode.com/GitHub_Trending/ge/generative-ai-for-beginners同时对接多家服务商03-providers.md 说明各变量的获取入口并给出建议默认模型——对话用gpt-4o-mini、向量用text-embedding-3-small第 111–112 行。文档同时提醒GitHub Models 将于 2026 年 7 月底退役由 Microsoft Foundry Models 接替第 7 行。来源与参考本文的事实依据均为本仓库当前版本内容云端流程与配额描述取自 00-course-setup/01-setup-cloud.md构建配置取自 .devcontainer/devcontainer.json 与 post-create.sh 脚本密钥读取机制取自 shared/python/env_utils.py变量模板取自 .env.copy。其中免费额度数字、界面菜单位置、AZURE_OPENAI_API_VERSION版本号等细节会随平台演进变化请以 GitHub 官方文档与仓库最新提交为准。【免费下载链接】generative-ai-for-beginners21 Lessons, Get Started Building with Generative AI项目地址: https://gitcode.com/GitHub_Trending/ge/generative-ai-for-beginners创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
