第 2 篇 · 安装 Pi（Windows 版）
这一篇手把手教你：从零开始，在你的 Windows 电脑上装好 Pi。 全程照着做就行，不需要任何编程知识。
2.0 先认识"终端"（命令行窗口）
Pi 运行在"终端"里。终端是什么？
🖥️ 终端 = 电脑的"后台窗口"，一个黑底白字（或深色背景）的窗口， 在这里输入文字命令，电脑就会执行。
怎么打开终端（Windows 三种方法，任选其一）：
方法一：按键盘
Win键（带窗户图标的键），输入PowerShell，回车方法二：按
Win + R，输入cmd，回车方法三：推荐安装 Windows Terminal（微软商店搜"Terminal"免费下载），更好用
打开后你会看到一个可以输入文字的窗口，后面所有命令都输在这里。
💡 后面的教程里，凡是出现这种灰底小框框的，都是要你在终端里输入的命令：
BASH这是一条命令输入完按 回车（Enter） 执行。
2.1 第一步：安装 Node.js
Pi 需要 Node.js 才能运行（忘记是什么了？回看 第 1 篇 的比喻）。
打开浏览器，访问：https://nodejs.org
页面会显示两个版本，下载左边那个
LTS版本（LTS = 长期稳定版，最安全）看不懂英文没关系，就找写着 LTS 的那个按钮点下载
下载完成后，双击安装文件，一路点"下一步（Next）"，直到安装完成
中间如果问要不要装"npm"，保持勾选（默认就是勾上的）
验证是否装好：
打开终端，输入下面命令，按回车：
BASHnode --version如果显示类似
v20.11.0的一串数字 → ✅ 装好了！如果提示"不是内部或外部命令"→ 安装没成功，重新装一遍（或者重启一下终端/电脑再试）
⚠️ 装完 Node.js 后，建议重启一下终端窗口（关掉重开），这样新软件才生效。
2.2 第二步：安装 Git
Pi 在 Windows 上需要一个叫 bash 的环境，Git 自带这个环境。这也是小白必装项。
打开浏览器，访问：https://git-scm.com/download/win
点击下载（会自动开始下载 Windows 版安装包）
双击安装，一路"下一步（Next）"
中间有一页问默认编辑器（editor），保持默认（Notepad 或 Vim）不用改
有一页问 PATH 设置，保持默认即可（如果你看不懂，全部默认就行）
验证：打开终端，输入：
BASHgit --version显示类似
git version 2.x.x→ ✅ 装好了！
2.3 第三步：安装 Pi
现在正式安装 Pi。在终端里输入下面这行命令，按回车：
BASH
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
逐段解释（了解即可，不用记）：
npm→ 调用 Node.js 自带的"软件商店"install→ 安装-g→ 全局安装（装好后电脑任何地方都能用）--ignore-scripts→ 跳过一些自动脚本（官方推荐的安全做法）@earendil-works/pi-coding-agent→ Pi 这个软件的名字
安装需要几分钟，屏幕上会滚动一些英文，不用管它，等它停。
验证安装成功：
BASH
pi --version
显示一个版本号（如
0.x.x）→ 🎉 安装成功！提示
pi 不是内部或外部命令→ 见下方"排错"
⚠️ 排错：提示"pi 不是内部或外部命令"
npm 全局安装的软件目录可能不在系统的"搜索路径"里，解决：
先找到 npm 全局目录：
BASHnpm config get prefix会显示一个路径，比如
C:\Users\你的用户名\AppData\Roaming\npm把上面的路径加到系统环境变量 PATH 里：
按
Win键，搜索"环境变量"，打开"编辑系统环境变量"点"环境变量"按钮 → 下方"系统变量"里找到
Path→ 双击编辑点"新建"，粘贴刚才的路径（如
C:\Users\你的用户名\AppData\Roaming\npm），确定保存重新打开终端，再试
pi --version
2.4 第四步：搞定！验证完整流程
安装完成后，试着启动 Pi（现在还没登录，先看看能不能启动）：
BASH
pi
如果屏幕上出现了 Pi 的界面（顶部有英文，底部有输入框），说明一切正常！ 现在按 Ctrl + C 两次退出（或者直接关掉窗口），然后进入下一步。
💡 如果启动时提示需要登录/API Key，别慌，这正是 第 3 篇 要解决的问题。
2.5 装错了怎么卸载？（先留着备用）
如果以后想卸载 Pi，在终端输入：
BASH
npm uninstall -g @earendil-works/pi-coding-agent
卸载只删除 Pi 程序本身，你的聊天记录和设置会保留在
C:\Users\你的用户名\.pi\agent\文件夹里。
📌 本篇小结
步骤 | 做了什么 | 验证命令 |
|---|---|---|
1 | 安装 Node.js |
|
2 | 安装 Git |
|
3 | 安装 Pi |
|
✅ 全部装好了！下一步 → 第 3 篇 · 登录和选择 AI 模型
