Pi

Pi 是 Mario Zechner 做的轻量终端编程智能体。产品站是 pi.dev，源码在 MIT 许可的 badlogic/pi-mono（截至 2026-08-30 约 9.9 万 GitHub 星）。安装命令：npm install -g @mariozechner/pi-coding-agent。CLI 本身免费，模型费用付给你选用的提供商。

若你更想要官方重型方案，可对照 Claude Code、Gemini CLI 和 OpenCode。

核心功能

• 默认工具面很薄：短系统提示词，加上 read / write / edit / bash。更多能力靠扩展、技能、提示模板和主题补齐。
• 可分享的包：把定制能力打成 Pi package，用 npm 或 git 安装（pi install .）。也可以让 Pi 自己改自己，再 /reload。
• 多提供商：Anthropic、OpenAI、Google、Azure、Bedrock、OpenRouter、Ollama 等。会话里用 /model 或 Ctrl+L 切换。
• 四种运行模式：交互 TUI、脚本用的 print/JSON、stdin/stdout 上的 RPC，以及可嵌入的 SDK。
• 树状会话：用 /tree 回到历史节点，/export 出 HTML，或 /share 上传 gist。配合 AGENTS.md / SYSTEM.md 和压缩做上下文工程。

适用场景

谁应该使用这个工具？

• 觉得 Claude Code 太重、想要更瘦终端循环的人。
• 要在 CI / 脚本里跑智能体，用 pi -p 或 JSON 模式。
• 想自己长出套件的扩展作者，而不是 fork 一个封闭产品。

解决的问题

1. 功能堆满却用不上：默认不做子智能体、plan mode、MCP、权限弹窗；需要再自己加。
2. 绑死某一家模型：同一 CLI 换模型与鉴权（API key 或 OAuth）。
3. 会话不可回溯：树状历史比单线聊天更好排查。

限制：没有托管席位。你在本机跑 CLI，安全边界（容器、确认流）要自己负责，除非用扩展补上。

定价方案

快速开始

1. 读 pi.dev 或 pi-mono README。
2. 安装：npm install -g @mariozechner/pi-coding-agent（2026-08-30 查到的 npm latest 为 0.73.1）。
3. 在仓库里运行 pi，完成提供商登录，先做小改动任务。
4. 放开宽权限 bash 前，先写好项目级 AGENTS.md。

实用工作流

选一个小 bug，在交互模式里让 Pi 改代码并跑测试；需要留痕时用 /export。自动化场景用 print 模式并固定模型。

常见问题

Pi 免费吗？

CLI 与源码 MIT 免费。模型 token 仍按提供商账单支付。

默认带 MCP 或子智能体吗？

不带。项目有意省略；可用扩展、技能或 package 补类似能力。

该装哪个 npm 包？

按 badlogic/pi-mono README 安装 @mariozechner/pi-coding-agent。博客里更老的第三方包名可能已过时。

和 Claude Code 有何不同？

Claude Code 是 Anthropic 更完整的产品面（CLI、IDE、桌面、云）。Pi 保持最小核心、提供商无关；缺什么再扩展。

替代方案

• Claude Code：更重的官方 Anthropic 编程智能体。
• Gemini CLI：Google 的开源终端智能体。
• OpenCode：另一个开源编程 CLI。

使用技巧

1. 先用默认四工具；同一流程反复出现再装 package。
2. 放开无约束 bash 前，优先用容器或白名单。
3. 用 /model：探索阶段用便宜模型，难关再切贵的。

总结

Pi 适合想要免费、可扩展终端 harness，并自带模型密钥的开发者。从 pi.dev 起步，装上现行 npm 包，再决定 Claude Code 那套更重的产品面是否值得。