pi-mono:在终端中直接创建 AI 编码代理
- GitHub Stars: 5.9k
- 语言: TypeScript 96.5%
- 许可证: MIT
这个项目火爆的原因
一位开发者觉得 Claude Code 太复杂了。Mario Zechner 在试验了 3 年的 LLM 编码工具后,最终决定自己创建一个。[Mario Zechner]
pi-mono 是一个以“不需要就不创建”的哲学诞生的 AI 代理工具包。它从 1000 个 token 的系统提示和 4 个核心工具(read、write、edit、bash)开始。与 Claude Code 数千 token 的提示相比,它极其轻量。[GitHub]
能做什么?
- 集成 LLM API:使用一个接口来使用 OpenAI、Anthropic、Google、Azure、Mistral、Groq 等 15 个以上的提供商
- 编码代理 CLI:在终端中以交互方式编写、测试和调试代码
- 会话管理:可以中断任务并继续,也可以像分支一样进行分支
- Slack 机器人:将 Slack 消息委托给编码代理
- vLLM Pod 管理:部署和管理 GPU Pod 上的自定义模型
- TUI/Web UI 库:可以创建自己的 AI 聊天界面
快速开始
# 安装
npm install @mariozechner/pi-coding-agent
# 运行
npx pi
# 或者从源代码构建
git clone https://github.com/badlogic/pi-mono
cd pi-mono
npm install && npm run build
./pi-test.sh
在哪里使用比较好?
如果 Claude Code 每月 20 万韩元的费用让你感到负担,并且你是一个以终端为中心工作的开发者,那么 pi 可以成为一个替代方案。因为你只需要支付 API 费用。
如果你想使用自托管的 LLM,但现有的工具不支持,那么 pi 就是答案。它甚至内置了 vLLM Pod 管理功能。
我个人认为“透明性”是最大的优点。Claude Code 内部运行着你看不到的子代理。而 pi 可以让你直接确认所有模型交互。
注意事项
- 极简主义是其哲学。有意省略了 MCP(模型上下文协议)的支持
- 默认情况下是被称为“YOLO 模式”的完全访问权限。权限检查比 Claude Code 更宽松,请注意
- 文档仍然不足。必须仔细阅读 AGENTS.md 文件
类似的项目
Aider:同样是开源终端编码工具。与模型无关这一点很相似,但 pi 涵盖了更广泛的范围(UI 库、Pod 管理等)。[AIMultiple]
Claude Code:功能更多,但需要每月订阅,并且定制性有限。pi 可以通过 TypeScript 扩展自由地添加功能。[Northflank]
Cursor:AI 集成到 IDE 中的形式。如果你更喜欢 GUI 而不是终端,那么 Cursor 更好。
常见问题 (FAQ)
Q: 可以免费使用吗?
A: pi 本身是 MIT 许可证,完全免费。但是,如果使用 OpenAI、Anthropic 等外部 LLM API,则会产生相关费用。如果在本地使用 Ollama 或自托管的 vLLM,则无需 API 费用即可使用。
Q: 性能足以替代 Claude Code 吗?
A: 在 Terminal-Bench 2.0 基准测试中,附加了 Claude Opus 4.5 的 pi 显示出与 Codex、Cursor、Windsurf 竞争的结果。这证明了极简的方法不会降低性能。
Q: 支持韩语吗?
A: UI 是英文的,但如果连接的 LLM 支持韩语,则可以用韩语进行对话和编码。如果连接 Claude 或 GPT-4,则可以使用韩语提示编写代码。
如果这篇文章对您有帮助,请订阅 AI Digester。
参考资料
- GitHub 存储库
- What I learned building an opinionated and minimal coding agent – Mario Zechner (2025-11-30)
- Claude Code vs Cursor 比较 – Northflank (2026-01-15)
- Agentic CLI Tools Compared – AIMultiple (2026-01-20)