第一部分，安装与入门

安装 Pi Coding Agent

检查 Node.js 要求，通过 npm 或官方脚本安装 Pi，并验证版本和卸载路径。

基础 / 8 分钟 / 第 2 篇

当前安装要求

当前官方包是 @earendil-works/pi-coding-agent，0.82.1 要求 Node.js 22.19.0 或更高版本。旧文章中的 @mariozechner 包名已经不是当前官方安装入口。

官方建议 npm 安装时使用 --ignore-scripts。Pi 的正常安装不依赖生命周期脚本，这可以减少供应链安装阶段的执行面。

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

curl -fsSL https://pi.dev/install.sh | sh
pi --version

使用 pi update --self 更新 Pi，也可以用原包管理器升级。卸载程序不会删除 ~/.pi/agent 中的设置、凭据、Sessions 和已安装 Packages，需要用户单独决定是否保留。

生产环境应固定经过验证的版本，并在升级前备份配置和运行代表性任务。

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

本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁，命令、包名和接口以官方最新文档为准。