学习路线图
全书结构
九章内容分三个阶段。点击卡片可以直接跳到对应章节。
最短路径：尽快跑起来
如果你只想尽快用上，按这个顺序走（第 2 章网络环境可以跳过）：
学会用终端
认识终端：打开终端、输入命令、了解"环境变量"。
装好基础工具
安装 Git 和 安装 Node.js 与 npm 镜像。Node.js 是安装两款 Agent 的前提，Git 是 Agent 改坏代码时的"后悔药"。
安装一款 Agent
安装 Claude Code 或 安装 Codex CLI，二选一，也可以都装。
接入 DeepSeek
准备 DeepSeek API Key，然后看对应工具的接入页。
完成第一个任务
回到 Claude Code 第一次上手 或 Codex 第一次上手，让 AI 帮你做出第一个网页。
为什么装好工具后要先跳到第 5 章？
工具装好之后，必须先接入一个模型才能用。第 3、4 章讲工具本身，第 5 章讲接入 DeepSeek，所以实际的操作顺序是：安装 → 接入模型 → 上手。
我该选 Claude Code 还是 Codex？
两个都很好。接入 DeepSeek 之后，它们背后用的是同一个模型，区别主要在交互方式和生态。
| 如果你…… | 建议 |
|---|---|
| 纠结不知道选哪个 | 先学 Claude Code。它默认每一步都先问你，更适合新手观察和学习；中文社区的资料也更多 |
| 以后打算用 ChatGPT 订阅 | 选 Codex，可以直接用订阅额度 |
| 想都试试 | 两个都装。它们互不冲突，配置文件也分开存放 |
两者的主要区别：
| Claude Code | Codex CLI | |
|---|---|---|
| 默认怎么把关 | 修改文件、执行命令前先问你 | 在项目文件夹内直接修改，越界时才问你（沙箱机制） |
| 项目说明文件 | CLAUDE.md | AGENTS.md |
| Skill 放在哪 | ~/.claude/skills/ | ~/.agents/skills/ |
| 接入 DeepSeek 的方式 | 改 settings.json | 改 config.toml + 设置环境变量 |
本教程的约定
页面顶部的标签
每页标题下方有一排小标签：
- 预计用时：跟着做一遍大约需要的时间；
- 最后验证：作者最后一次按步骤检查这一页的日期；
- 工具版本：验证时使用的软件版本。你的版本更新时，界面可能略有不同；
- 已实测 / 部分待实测 / 待实测：作者是否在真实环境中跑通了这一页的步骤。
代码块和系统切换
灰色背景的框里是要输入的命令或文件内容。右上角有复制按钮，建议直接复制，不要手打。
同一个操作在不同系统下命令不同时，会用标签页区分，点击切换：
# Windows 下的命令# macOS 或 Linux 下的命令"你会看到"
深色窗口展示的是命令执行后正确的输出，用来和你屏幕上的结果对照：
v24.21.0版本号等细节和你看到的不完全一样是正常的，只要格式对得上就行。
按键
Ctrl + C 表示先按住 Ctrl，再按 C。
macOS 用户注意
在终端和 Agent 里，Ctrl 快捷键在 macOS 上也是按 Control 键，不是 Command。复制、粘贴这类图形界面操作，教程会分别写明两个系统的按键。
尖括号占位符
<你的 API Key> 这种写法表示"把整个尖括号连同里面的文字，替换成你自己的内容"。例如 <你的 API Key> 要替换成 sk-abc123...，尖括号也要删掉。
提示框
提示
小技巧或补充说明。
注意
容易出错的地方，请仔细看。
危险
可能导致数据丢失或安全问题的操作。
遇到和教程不一样的情况
软件更新很快。如果你按步骤操作时发现界面、文字和教程不一样：
- 先以你看到的实际界面为准，找意思相近的选项；
- 查看 常见问题；
- 还解决不了，欢迎到 GitHub 提 Issue，附上你的系统版本、工具版本和截图。