第 2 篇 · 安装 Pi（Windows 版）

这一篇手把手教你：从零开始，在你的 Windows 电脑上装好 Pi。 全程照着做就行，不需要任何编程知识。

2.0 先认识"终端"（命令行窗口）

Pi 运行在"终端"里。终端是什么？

🖥️ 终端 = 电脑的"后台窗口"，一个黑底白字（或深色背景）的窗口， 在这里输入文字命令，电脑就会执行。

怎么打开终端（Windows 三种方法，任选其一）：

1. 方法一：按键盘 Win 键（带窗户图标的键），输入 PowerShell，回车

2. 方法二：按 Win + R，输入 cmd，回车

3. 方法三：推荐安装 Windows Terminal（微软商店搜"Terminal"免费下载），更好用

打开后你会看到一个可以输入文字的窗口，后面所有命令都输在这里。

💡 后面的教程里，凡是出现这种灰底小框框的，都是要你在终端里输入的命令：

BASH

这是一条命令

输入完按 回车（Enter） 执行。

2.1 第一步：安装 Node.js

Pi 需要 Node.js 才能运行（忘记是什么了？回看 第 1 篇 的比喻）。

1. 打开浏览器，访问：https://nodejs.org

2. 页面会显示两个版本，下载左边那个 LTS 版本（LTS = 长期稳定版，最安全）

   • 看不懂英文没关系，就找写着 LTS 的那个按钮点下载

3. 下载完成后，双击安装文件，一路点"下一步（Next）"，直到安装完成

   • 中间如果问要不要装"npm"，保持勾选（默认就是勾上的）

4. 验证是否装好：

   • 打开终端，输入下面命令，按回车：

   BASH

   node --version
   

   • 如果显示类似 v20.11.0 的一串数字 → ✅ 装好了！

   • 如果提示"不是内部或外部命令"→ 安装没成功，重新装一遍（或者重启一下终端/电脑再试）

⚠️ 装完 Node.js 后，建议重启一下终端窗口（关掉重开），这样新软件才生效。

2.2 第二步：安装 Git

Pi 在 Windows 上需要一个叫 bash 的环境，Git 自带这个环境。这也是小白必装项。

1. 打开浏览器，访问：https://git-scm.com/download/win

2. 点击下载（会自动开始下载 Windows 版安装包）

3. 双击安装，一路"下一步（Next）"

   • 中间有一页问默认编辑器（editor），保持默认（Notepad 或 Vim）不用改

   • 有一页问 PATH 设置，保持默认即可（如果你看不懂，全部默认就行）

4. 验证：打开终端，输入：

   BASH

   git --version
   

   显示类似 git version 2.x.x → ✅ 装好了！

2.3 第三步：安装 Pi

现在正式安装 Pi。在终端里输入下面这行命令，按回车：

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

逐段解释（了解即可，不用记）：

• npm → 调用 Node.js 自带的"软件商店"

• install → 安装

• -g → 全局安装（装好后电脑任何地方都能用）

• --ignore-scripts → 跳过一些自动脚本（官方推荐的安全做法）

• @earendil-works/pi-coding-agent → Pi 这个软件的名字

安装需要几分钟，屏幕上会滚动一些英文，不用管它，等它停。

验证安装成功：

pi --version

• 显示一个版本号（如 0.x.x）→ 🎉 安装成功！

• 提示 pi 不是内部或外部命令 → 见下方"排错"

⚠️ 排错：提示"pi 不是内部或外部命令"

npm 全局安装的软件目录可能不在系统的"搜索路径"里，解决：

1. 先找到 npm 全局目录：

   BASH

   npm config get prefix
   

   会显示一个路径，比如 C:\Users\你的用户名\AppData\Roaming\npm

2. 把上面的路径加到系统环境变量 PATH 里：

   • 按 Win 键，搜索"环境变量"，打开"编辑系统环境变量"

   • 点"环境变量"按钮 → 下方"系统变量"里找到 Path → 双击编辑

   • 点"新建"，粘贴刚才的路径（如 C:\Users\你的用户名\AppData\Roaming\npm），确定保存

   • 重新打开终端，再试 pi --version

2.4 第四步：搞定！验证完整流程

安装完成后，试着启动 Pi（现在还没登录，先看看能不能启动）：

pi

如果屏幕上出现了 Pi 的界面（顶部有英文，底部有输入框），说明一切正常！ 现在按 Ctrl + C 两次退出（或者直接关掉窗口），然后进入下一步。

💡 如果启动时提示需要登录/API Key，别慌，这正是 第 3 篇 要解决的问题。

2.5 装错了怎么卸载？（先留着备用）

如果以后想卸载 Pi，在终端输入：

npm uninstall -g @earendil-works/pi-coding-agent

卸载只删除 Pi 程序本身，你的聊天记录和设置会保留在 C:\Users\你的用户名\.pi\agent\ 文件夹里。

📌 本篇小结

✅ 全部装好了！下一步 → 第 3 篇 · 登录和选择 AI 模型