这门课拆的 pi，不是一份躺在网页上的代码——你现在就能把它装进自己电脑，让它真跑起来。你装上的这个 pi，和我们后面一行行拆的，是同一份源码。学的即用的。
前面几节讲了你要造什么、agent 拆开是哪几块、以及一套边学边查的术语。这一节，把工具装上——让一个真的 agent 在你电脑里跑起来。
为什么这门课挑 pi
市面上的 agent 不少，我们拆 pi（官网 pi.dev），理由很实在：
- 小、干净、没魔法。pi 自己的说法是”一个最小的终端编码工具”。默认只给模型四个工具——
read、write、edit、bash——小到你能一段段读懂，不会迷路在几十个抽象层里。 - 学的即用的是同一份。你等下装的这个 pi，就是我们后面一行行拆的那份源码。别的教程里，“例子代码”和”真工具”是两码事；这门课里它们是同一个东西。你学完回头看源码，会发现基本没有生词。
- 它能自己解释自己。pi 是开源的，装上之后你甚至可以直接问它：“你这套会话是怎么存的？“——课程 + 真源码 + 能问的 agent，三样凑齐了。
一句话：要学 agent，最好的教材就是一个你能跑起来、又拆得开的真 agent。 pi 正好是。
装之前：一个前提
pi 跑在 Node.js 上，需要 22.19.0 以上的版本。
不确定装没装过？在终端里敲
node -v。显示v22.19.0或更高就行；提示”命令未找到”或版本太低，先去 nodejs.org 装一个新的。完全没碰过”终端”？ 别怕。Mac 上打开”终端”（Terminal）应用，Windows 上打开 PowerShell——就是一个能敲命令的黑框。这门课要敲的命令，我都整段给你，复制粘贴、回车，就行。
第一步 · 安装
两条路，二选一，效果一样：
# 路 A：用 npm 全局安装
npm install -g --ignore-scripts @earendil-works/pi-coding-agent# 路 B：用官方安装脚本（不想碰 npm 就用这条）
curl -fsSL https://pi.dev/install.sh | sh装完，敲一下 pi。能看到它启动起来（一个交互界面），就说明装对了。
--ignore-scripts是 pi 官方推荐的写法：装依赖时不跑额外脚本，更干净、更安全。照抄即可。
第二步 · 让它连上模型（认证）
pi 自己不含大模型，它得连到一家模型服务商。两种方式，选你手头有的那种：
A · 你已经有订阅（比如 Claude Pro/Max、ChatGPT Plus/Pro、GitHub Copilot）——推荐这条，不用额外花钱：
pi启动后，在里面敲 /login，按提示选你的服务商、在弹出的页面里授权。回来就能用了。
B · 你有 API key：
export ANTHROPIC_API_KEY=sk-ant-你自己的key
pi
sk-ant-...只是占位，换成你自己在服务商后台申请的那一串。API key 等于你的钱包，别贴给任何人、别提交进代码仓库。
第三步 · 初始化：在一个文件夹里跑起来
pi 是跟着文件夹走的。想让它帮你做一个项目里的事，就先进到那个文件夹，再启动：
cd 你的项目文件夹
pi然后就是跟它说话。试一句最简单的：
帮我看看这个文件夹里都有什么文件。
它会调用 read/bash 去看，然后回答你。看到它自己动手读文件、给你结论，这一节就算过了。
一个能立刻回扣课程的细节：你这次对话——那本”账本”——落盘就存在
~/.pi/agent/sessions/下、以这个文件夹命名的目录里。换个文件夹再开pi，就是另一本账。这正是我们后面 Session 章要一层层拆的东西：每个会话一本账，按工作目录分抽屉。
一个安全习惯
pi 要读文件、改文件、跑命令时，首次会先问你批准——别嫌烦，这是好事。看清楚它要动什么再放行，尤其是删除、覆盖类的操作。判断权在你手里，这也正是这门课的底色：执行交给它，判断留给你。
达标线
装上 pi、连上模型、让它读一个文件给你结论——三样做到，环境就绪。
写不出命令没关系，整段复制粘贴、跑通，就算过。
下一章
工具备好了。下一章我们正式动手——从整个 agent 里最难、也最先要搞定的一块开始：Session（会话）。先不写代码，先玩坏它。
