环境与学习方式

本课交付结果

完成本页后，你会得到一套可以运行训练营测试、构建课程网站并执行 Mini Code Agent 的本地环境。

前置要求

• Node.js 20 或更高版本。
• pnpm 10 或更高版本。
• Git 2.39 或更高版本。
• ripgrep 14 或更高版本，命令名为 rg。
• macOS、Linux 或 Windows WSL2。

课程主线统一使用 TypeScript、Node.js 和 pnpm。真实模型 API Key 不是安装训练营和完成必过测试的前提。

安装项目

git clone https://github.com/cq0206/learn-traeai.git
cd learn-traeai
pnpm install --frozen-lockfile

安装会依据已提交的 pnpm-lock.yaml 获取确定版本的依赖。不要提交 node_modules、本地缓存或环境变量文件。

运行基础验证

pnpm bootcamp:verify:foundation

基础验证会检查 40 课清单、TypeScript 类型、验证器单元测试和 VitePress 构建。它不会把尚未完成的课文或 Lab 当成通过。

两种学习方式

从单课 Lab 开始

进入课文对应的 Lab 目录，先运行 Starter：

pnpm --dir bootcamps/coding-agent/labs/01-course-map/starter test

Starter 应该以课文声明的练习缺口失败。完成代码后再次运行同一命令，再与 Solution 对照：

pnpm --dir bootcamps/coding-agent/labs/01-course-map/solution test

跟随总项目成长

每课的“总项目增量”会标出 projects/mini-code-agent 中对应的文件和验证命令。每周结束后，还可以进入当周 checkpoint 运行：

pnpm --dir bootcamps/coding-agent/checkpoints/week-01-minimal-agent test
pnpm --dir bootcamps/coding-agent/checkpoints/week-01-minimal-agent smoke

可选真实模型配置

真实模型只用于第 8 周演示。课程不会要求把密钥写进仓库，也不允许通过 CLI 参数传递密钥。需要演示时，在当前 shell 中设置：

export CODE_AGENT_API_KEY="你的密钥"
export CODE_AGENT_MODEL="你的模型名"

请勿把真实密钥写进 .env 后提交。如果测试或 Trace 中出现密钥，应立即撤销密钥并运行发布扫描。

出现问题时先收集证据

先记录实际命令、完整错误、Node/pnpm/Git/rg 版本和当前工作目录。不要一上来删除锁文件或整个仓库。训练营的学员手册会提供诊断命令和常见问题表。

下一步

环境验证通过后，从第 1 课“训练营地图与任务契约”开始。它会先定义一次代码任务的输入、约束和可验收结果，再进入 Runtime 实现。