Pi：GitHub 112k Star 的开源 AI 编程智能体，一条命令安装，新手上手教程

最近刷 GitHub Trending 的朋友应该发现了，排在前列的不是又一个大模型，而是一个叫 Pi 的项目——earendil-works/pi，目前 112k+ Star，v1.0 正式版刚在 10 月初发布。评论区一句话总结得很到位：模型越来越不值钱，能把模型用出花样的”壳”才是真刚需。

今天这篇是一篇纯新手向的安装使用教程，不讲玄学，跟着敲命令就能跑起来。

Pi 到底是个啥？

一句话：跑在终端里的开源 AI 编程智能体。你可以把它理解成”开源版的 Claude Code”——在命令行里用自然语言指挥 AI 改代码、跑命令、查资料。

它有几个核心特点，用大白话过一遍：

• 极简可扩展：官方定位是”agent harness”（智能体骨架），默认功能克制，但支持装 Skills（技能）、Extensions（扩展）、Themes（主题），想要啥自己加；
• 多模型随便接：内置统一的 LLM 接口，Anthropic、OpenAI、Google、OpenRouter 都支持，还支持本地模型（比如 Ollama），不想被任何一家绑定；
• MIT 开源：代码完全公开，商用随便，无后门焦虑；
• 多种玩法：交互式终端 UI、print/JSON 模式跑自动化、RPC 远程控制、还有 TypeScript SDK 可以拿去二次开发。

安装前的准备

Pi 用 Node.js 写的，所以硬性要求就一条：

Node.js >= 22.19

先检查一下自己的 Node 版本：

node -v
# 输出类似 v22.19.0 或更高即可

版本不够的话，推荐用 nvm 装（Linux/macOS 通用）：

curl -o- https://gitee.com/mirrors/nvm/raw/master/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

Windows 用户直接去 nodejs.org 下 LTS 安装包即可。

三分钟安装 Pi

方式一：官方安装脚本（推荐）

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

Windows PowerShell：

powershell -c "irm https://pi.dev/install.ps1 | iex"

这个脚本会把所有依赖版本锁死（供应链安全做得比较到位），以后升级直接在 Pi 里敲 pi update 就行。

方式二：npm 安装

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

注意带 --ignore-scripts，官方推荐的安全做法。区别是 npm 方式不会锁定间接依赖版本，介意的话用方式一。

方式三：从源码构建

国内网络访问 pi.dev 不稳的话，可以从我文末的夸克网盘下载 GitHub v1.0.1 源码包，本地构建：

tar -xzf pi-v1.0.1-source.tar.gz
cd pi-1.0.1
npm install --ignore-scripts
npm run build:offline

装完验证一下：

pi --version

第一次运行：让它干点活

安装完成后，进入你的项目目录再启动 Pi（它默认操作当前目录的文件）：

cd /path/to/your/project
pi

首次启动需要连接模型，在 Pi 里输入：

/login

按提示选择供应商（Anthropic / OpenAI / Google / OpenRouter 等），填入 API Key 或者登录订阅账号即可。连上之后，直接用中文给它下任务：

帮我看看这个项目的目录结构，解释一下入口文件做了什么

Pi 会自己读文件、分析代码，终端里实时输出它的思考和操作过程。它没有内置权限系统（官方文档明确说了），默认以你当前用户的权限运行，建议在测试项目或容器里先玩熟，别一上来就对着生产代码用。

常用命令速查

新手常见问题

Q：装完提示 command not found？
A：检查 npm 全局 bin 目录是否在 PATH 里，或者重开一个终端窗口试试。

Q：连不上模型？
A：国内直连 Anthropic/OpenAI 大概率超时，配一个代理环境变量（HTTPS_PROXY）或者走 OpenRouter 中转。本地党可以装 Ollama 接本地模型，完全不依赖外网。

Q：会不会乱动我的文件？
A：Pi 默认没有权限沙箱，官方建议需要隔离时用 Docker 或微虚拟机跑。练手期建议先建个空项目目录玩。

下载

本文使用的 Pi v1.0.1 源码包已上传网盘：

夸克网盘下载：https://pan.quark.cn/s/ca5ade4870b7

（网盘内含 pi-v1.0.1-source.tar.gz 源码压缩包 + README 安装说明，文件夹里还有当天收录的其他工具）

官方仓库：https://github.com/earendil-works/pi
项目官网：https://pi.dev/

写在最后

说实话，现在 AI 编程工具卷成这样，Pi 这种”不绑模型、开源可控、极简可扩展”的路线反而越来越吃香。112k Star 不是刷出来的，是真有一批开发者把它当日常主力在用。如果你已经用腻了订阅制的商业工具，或者单纯想折腾一下开源智能体，Pi 值得花半小时装上试试。

关注公众号：”实用软技”，在公众号窗口里回复关键字”软件”即可免费获取更多实用工具推荐！
觉得有用？点个在看👇

https://www.88531.cn/?p=57570

创作不易，用心坚持，请喝一怀爱心咖啡！继续坚持创作~~