安装前先确认环境
装 Pi 前，确认你能用 npm（或 pnpm / yarn / bun）装全局包。Pi 主要以 npm 包形式分发：
node --version # 建议用较新的 LTS 版本
如果你习惯一键安装，macOS/Linux 也有官方安装脚本（不同平台细节以你所用版本文档为准）。
用 npm 安装
在终端里执行：
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
--ignore-scripts 会禁用依赖的生命周期脚本。Pi 正常 npm 安装不需要安装脚本，所以加上这个标志更安全。
装完验证：
pi --version
能看到版本号，就说明装好了。
用其他包管理器
如果系统用了 pnpm / yarn / bun，也可以换着装：
# pnpm
pnpm add -g @earendil-works/pi-coding-agent
# Yarn
yarn global add @earendil-works/pi-coding-agent
# Bun
bun add -g @earendil-works/pi-coding-agent
贯穿项目记住我们的
md-tools——它也是 Node.js 工具。你现在装好的 pi 环境，就是之后让 Pi 帮你写这套工具的基础。提示选一个你平时用的包管理器就行，别都装。混用不同包管理器管同一个全局包，容易造成路径混乱。
卸载
用当初安装的那个包管理器卸载即可：
# 如果是 npm 装的（curl 安装脚本也是走 npm 全局）
npm uninstall -g @earendil-works/pi-coding-agent
# pnpm
pnpm remove -g @earendil-works/pi-coding-agent
# Yarn
yarn global remove @earendil-works/pi-coding-agent
# Bun
bun uninstall -g @earendil-works/pi-coding-agent
注意卸载 Pi 不会删掉你的设置、凭据、会话和已装的 Pi Packages——它们留在
~/.pi/agent/。想彻底清理得手动删这个目录。启动它
装好后，进入一个项目目录启动：
cd /path/to/project
pi
第一次进入会先要求认证（下一节讲），认证完就能开始用了。
落地练习：装好并验证
三步确认你准备好了：
- 用你习惯的包管理器装好
pi（建议npm install -g --ignore-scripts @earendil-works/pi-coding-agent） - 跑
pi --version，看到版本号 - 建个空目录，
cd进去，跑pi，确认它能启动（进入认证流程也说明装好了）
怎么判断做对了？——
pi --version有正常输出，pi能启动进入界面或认证提示。
卡住了怎么办？ pi 找不到 → npm 全局目录没进 PATH，或装失败了重装。装得很慢 → 换成国内 npm 镜像源再装。版本不对 → 更新包管理器后重装。
常见坑：忘记 --ignore-scripts
新手照抄安装命令时，容易手滑去掉 --ignore-scripts。
虽然 Pi 不依赖安装脚本，但带上这个标志更安全——它能防止依赖安装时执行不必要的生命周期脚本，减少供应链风险。装的时候照着文档的完整命令抄，别删参数。
小结
npm install -g --ignore-scripts @earendil-works/pi-coding-agent安装- 也支持 pnpm / yarn / bun
- 卸载用当初那个包管理器
- 卸载不删
~/.pi/agent/里的数据 pi --version验证，cd 项目目录 && pi启动
下一节，我们配置认证和模型，让 Pi 真正能干活。