AI 工具实践 · 安装与核对
Pi Coding Agent 安装指南：Windows 命令与版本核对
先认准项目和包名，再检查命令是否可用，最后接入自己的模型服务。
本页目录
先确认你要安装的是哪个 Pi
本页讨论 earendil-works/pi 的 Pi Coding Agent：在终端里配合模型处理文件与编程任务的工具。其他同名产品不能直接套用这些命令。
当前核对的 npm 包为 @earendil-works/pi-coding-agent，命令名为 pi。旧包 @mariozechner/pi-coding-agent 的 npm 页面已标记弃用，并指向新包。阅读旧教程时，应先核对包名和来源。
Windows：按顺序检查和安装
npm 方案需要 Node.js 22.19 或更高版本。先打开终端检查环境：
node --version
npm --version环境满足要求后，可用官方 npm 方案安装。本页将顶层包固定在已核对的 1.5.2 版本：
npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.5.2官方也提供安装器，安装器与 npm 方案对依赖固定方式的处理不同。选择安装器时，请直接查看官方 Quickstart，避免混用旧文章中的安装包名称。固定 Pi 包版本也不等于固定所有传递依赖。
原生 Windows 若要使用内置 Bash 工具，还需按官方 Windows 文档准备 Git Bash 等命令环境。macOS、Linux 的安装器用法请查看官方文档，本页未做这些平台的运行验证。
安装后，分别验证这两条命令
pi --version
pi --help对于本页固定版本，第一条应显示 1.5.2，第二条应显示命令帮助。它们能验证命令行入口，不代表已经完成模型连接或任务执行。
本次实际检查记录
- 检查环境
- Windows，Node.js v24.20.0。
- 安装方式
- 在独立目录安装同一个固定版本包，使用
--ignore-scripts；没有执行全局安装命令。 - 实际结果
pi --version返回1.5.2；pi --help正常返回，两者退出码均为 0。- 验证范围
- 使用独立配置目录和离线检查选项；未登录服务商、未调用模型，也未执行代理任务。
命令可用后，再连接模型
进入你准备工作的文件夹，再运行 pi。在 Pi 的交互界面中使用 /login，选择自己有权限使用的服务并完成授权；需要更换模型时使用 /model。这两条斜杠命令是在 Pi 内输入的，不是在 PowerShell 提示符下执行。
随后用一个小任务验证服务连接，并核对实际返回和文件变化。仅能显示版本号时，还不能说模型已经可用；本页也不提供已完成模型调用的承诺。
常见问题，先区分发生在哪一步
- 提示找不到 pi
- 先确认 npm 安装是否成功，再检查全局 npm 命令目录是否位于 PATH；重新打开终端后再试。Node 能运行不代表 Pi 已安装。
- Windows 中 Bash 不可用
- 按官方 Windows 文档核对 Git Bash 的安装和定位方式，不要把终端入口正常当作 Bash 工具已通过验证。
- 版本能显示，但模型无法回答
- 检查服务授权、所选模型和连接配置；这属于模型连接步骤，不是版本号检查本身。
- 旧教程写的是 piagent
- 对于本页指定的 Pi Coding Agent，npm 包声明的入口是
pi。先确认旧教程谈论的项目，再采用对应命令，不要只凭“Pi Agent”名称判断。
官方来源与核对日期
以下资料核对于 2026-11-16。后续版本的安装、授权与平台要求可能调整，升级前请重新查看来源。