Claude Code、Codex CLI、Cursor——终端里写代码的 AI 助手越来越多了。但有一个项目你可能还没注意到：Pi Agent，GitHub 上 79,000+ Stars，不到一年冲到这个量级。
它不是某个大厂的出品，而是开源社区自发长出来的东西。一套 AI 编码代理工具包，包括统一的多 Provider LLM API、Agent 运行时、TUI 终端库和一个能直接用的编码 Agent CLI。
今天聊聊它到底是什么、厉害在哪、以及跟 Claude Code 比怎么样。
一句话：一个 AI Agent 工具箱
Pi Agent 本质上是一套分层设计的 AI Agent 工具包，从底层到上层分了三个核心包：
- @earendil-works/pi-ai： 统一的多 Provider LLM API。OpenAI、Anthropic、Google、DeepSeek……你想用的它都包了，一套接口换模型不用改代码
- @earendil-works/pi-agent-core： Agent 运行时。消息循环、工具调用、状态管理、会话树、上下文压缩都在这一层
- @earendil-works/pi-coding-agent： 直接上手的编码 Agent CLI。终端交互、自动补全、文件编辑、代码执行都做好了
另外还有个 @earendil-works/pi-tui，一个差分渲染的终端 UI 库，用来做漂亮终端界面。
也就是说，你可以拿 Pi Agent 当 Claude Code 的平替直接用，也可以把它当框架，在上面搭自己的 Agent 应用。
核心亮点
统一 LLM 接口。 你写一次代码，切模型不用改逻辑。Pi AI 层抽象了 OpenAI、Anthropic、Google 等多家 Provider 的差异。想从 GPT-4 换到 Claude Sonnet？改个配置就行。
编码 Agent CLI 开箱即用。 装好之后直接在终端敲 pi 就能跟它聊天写代码。支持多轮会话、工具调用、文件系统操作、命令执行。
会话树设计。 不是简单的对话列表，Pi 用树结构管理会话。你可以分支探索不同的解决思路，回退到任意节点重来。这个设计在 Agent 里挺少见。
上下文压缩。 长会话自动压缩历史，节省 Token 也保持上下文连贯性。对长会话场景很实用。
Rust 移植版（pi_agent_rust）。 社区有人用 Rust 从头移植了一遍，1,400+ Stars，零 unsafe 代码，启动更快、内存更低。原版是 TypeScript，Rust 版适合对性能有要求的人。
活跃的生态。 pi-skills 项目 2,200+ Stars，大量社区贡献的扩展。还有中文教程教你从头实现一个 Agent。
装上试试
安装很简单，一行命令：
npm install -g @earendil-works/pi-coding-agent
或者用 Rust 版（如果更看重性能）：
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/pi_agent_rust/main/install.sh" | bash
用了之后在终端敲 pi 就能开始对话。跟 Claude Code 的体验类似——描述需求，AI 帮你写代码、改文件、执行命令。
不是没有槽点
Node.js 依赖。 原版基于 TypeScript，需要 Node.js 运行时。启动速度比 Rust 版慢一些。不过 Rust 移植版解决了这个问题。
文档体验。 pi.dev 有官方文档，但项目发展太快（接近每周发版），有些功能文档跟不太上。
权限模型。 原版 Pi Agent 没有内置权限隔离系统，默认以当前用户权限运行。官方推荐 Docker / OpenShell 沙箱方案来加强安全。Rust 版在这方面做得更好——内置了能力门控、扩展执行策略、信任生命周期管理。
跟 Claude Code 比，各有千秋。 Claude Code 有 Anthropic 的模型加持，在复杂推理场景更强。Pi Agent 的优势是开源、可定制、多 Provider 自由切换。如果你不想被绑死在单一模型上，Pi 更灵活。
跟同类比
| 对比项 | Pi Agent | Claude Code | Codex CLI |
|---|
| 价格 | 免费开源 | 免费开源 | 免费开源 |
| 模型绑定 | 多 Provider | Anthropic | OpenAI |
| 语言 | TypeScript + Rust | TypeScript | TypeScript |
| 框架价值 | 可做框架 | 仅 CLI | 仅 CLI |
| Stars | 79,667 | ~30K | ~25K |
| 会话树 | ✅ | ❌ | ❌ |
Claude Code 强在模型本身，Pi Agent 强在架构灵活。选哪个取决于你是要「直接用最好的模型」还是「自己搭 Agent 系统」。
适合谁
- AI Agent 开发者： 拿 pi-agent-core 当框架，省去从零写 Agent 循环的麻烦
- 多模型用户： 不想被单一 Provider 绑定，需要自由切换模型
- 编码效率党： 终端里直接跟 AI 协作写代码，不用切到 IDE
- 学习研究： Pi Agent 的源码结构清晰，中文教程（cellinlab/how-pi-agent-works，607⭐）从零到一教你实现 Agent
值不值得试
将近 80K Stars 的项目不会差。如果你已经在用 AI 写代码，Pi Agent 值得装一个试试——反正免费、装起来也快。更重要的可能是它的 Agent 工具包设计思路，对于想做 Agent 开发的人来说，比 Claude Code 有价值得多。
GitHub：earendil-works/pi
官网：pi.dev
Rust 版：Dicklesworthstone/pi_agent_rust
标签：#PiAgent #AI编码助手 #CLI #Agent框架 #多Provider #开源 #TypeScript
关注我，每期分享一个帮你省事的强大工具 🛠️