夜雨聆风学习资料网

ARTICLE · 1013475

Pi Agent:被 OpenClaw 偷偷借走内核的极简主义编程智能体

Pi Agent:被 OpenClaw 偷偷借走内核的极简主义编程智能体

Pi Agent:被 OpenClaw 偷偷借走内核的极简主义编程智能体

被顶级Agent借走的极简内核

如果说 2025 年是「AI 编程 Agent 大爆发」之年,那 2026 年真正值得记住的,可能不是一个功能最多的工具,而是一个「功能最少」的项目。它只有 4 个内置工具、系统提示词不到 1000 token、核心代码约 1500 行,却被去年最火的顶级开源 Agent OpenClaw 直接拿来当底层内核。它就是 Pi Agent——一个把「克制」写成架构哲学的编程智能体。

今天这篇文章,带你从起源、架构、实战案例到横向对比,彻底看懂 Pi 凭什么用「做减法」干翻一众功能堆砌的对手。

一、它不是一个新玩具,而是一套「Agent 乐高」

Pi 由奥地利开发者 Mario Zechner 发起。如果你做过游戏开发,一定听过他用 Java 写的 libGDX 框架——过去十年里无数独立手游都跑在它上面。2025 年 8 月,Zechner 以 `badlogic/pi-mono` 为名开了新坑,后来迁移并更名为 `earendil-works/pi`。

2026 年 4 月 8 日,公益公司 Earendil Inc.(由 Flask 之父 Armin Ronacher 创立)正式收购了 Pi 项目,Zechner 以「核心成员 + 大股东」身份加入。一支围绕维也纳的开发者小圈子——Zechner、Ronacher、OpenClaw 的 Peter Steinberger——被外界戏称为 「Vienna School of Agentic Coding」(维也纳 Agent 编程学派)。

几个硬数据先摆上桌: 

  • GitHub Star:约 8.5 万
    ,Fork 超 1 万(截至 2026 年 8 月)
  • 最新版本:v0.84.1
    (2026 年 8 月 7 日)
  • 协议:MIT 完全开源
    (核心层)
  • 核心代码量:约 1500 行
    ,没有黑盒
 从用户视角看,它像 Claude Code、Codex CLI 一类的终端编程 Agent;但从架构视角看,它更像一套 Agent 核心程序(Harness)——开发团队既能直接当工具用,也能把它拆成 SDK 嵌进自己的产品、CI 流水线或企业内部平台。

二、极简到「变态」:4 个工具 + 不到 1000 token 的提示词

Pi 官方刻意没有把子 Agent、计划模式、权限弹窗、MCP、后台 Bash 做成内置标配。这不是能力缺失,而是一个清醒的产品取舍:

核心只保留模型对话、工具调用、上下文管理等高频且稳定的基础能力,其余交给扩展、脚本、容器和外部工具实现。

具体「瘦」到什么程度?看这组对比:

维度
Pi Agent
Claude Code
Codex CLI
系统提示词
< 1000 token
~10,000–15,000 token
~12,000 token
内置工具
仅 4 个
20+
10+
核心代码量
~1,500 行
大型 Node.js 项目
Rust 项目
 Pi 默认只给模型 4 个工具:`read`(读文件)、`write`(写文件)、`edit`(改文件)、`bash`(跑命令)。Zechner 的原话是:他受够了那些「像太空船、80% 功能永远用不上」的 Agent,以及那些「偷偷在背后往上下文塞东西、还不让你看见」的设计。 代价直接体现在账单上:社区实测,同等任务下 Pi 的 Token 开销约为 Claude Code 的 30%–40%。更短的提示词不仅省钱,还减少了长上下文下的幻觉累积。Pi 的 slogan 把这层哲学说透了—— "Adapt Pi to your workflows, not the other way around."(让 Pi 适配你的工作流,而不是你被工作流绑架。)

三、五层架构:把 Agent 拆成可替换的积木

Pi 的代码仓库是一个 npm monorepo,刻意把每一层拆成可以独立使用的包: 

  • `@earendil-works/pi-ai`
    (模型接入层):统一的多厂商 LLM 抽象层,抹平 Anthropic、OpenAI、Google、xAI、Groq、Mistral、Bedrock、Azure、OpenRouter、Ollama、DeepSeek、Kimi 等 15+ 厂商的接口差异,并处理流式输出、认证与成本追踪。
  • `@earendil-works/pi-agent-core`
    (运行时内核):负责工具调用、会话状态、循环推理与流式事件,是整个项目的心脏。
  • `@earendil-works/pi-tui`
    (终端 UI 库):差分渲染,低闪烁的交互式命令行界面。
  • `@earendil-works/pi-coding-agent`
    (开箱即用 CLI):普通用户最直接的入口,装完敲 `pi` 就能跑。
  • `@earendil-works/pi-telemetry`
    (可观测性):厂商中立的遥测契约与类型化 Schema。
 一个形象的比喻:Cursor / Claude Code = 完整成品 IDE,功能全内置、无法拆解复用;Pi = 一套乐高积木,你能直接拼出终端代码助手,也能拆出底层 SDK 嵌入自研系统、CI 流水线和企业内部平台。

这种分层是 Pi 能被「借走内核」的根本原因——想要 Agent 循环能力的人(比如 OpenClaw 早期),直接 `import` 运行时即可,完全不需要那套 CLI。

四、为什么 OpenClaw 选它做底座?

这是 Pi 最硬的一块「行业背书」: 

  • OpenClaw
    (Peter Steinberger 的项目,2026 年 1 月爆火、数十万 Star)早期深度复用 Pi 的 Agent Runtime 与 TUI 终端组件,官方 README 专门致谢 Pi 作者;
  • MiniMax Code
     也基于 Pi 构建;
  • Oh My Pi
    (约 2 万 Star)直接 Fork 了 Pi 内核,新增浏览器、子 Agent 与海量内置工具;
  • Ronacher 公开称 Pi 是他「几乎 exclusively( exclusively)」使用的编码 Agent。
 换句话说,你在 2026 年看到的很多「顶流 Agent」,底层跑的其实是同一套极简内核。Pi 自己甘当「看不见的底座」,把聚光灯让给了上层产品。

五、横向硬核对比:Pi vs Claude Code vs Codex CLI

把三者放在同一张表上,差异一目了然:

对比维度
Pi Agent
Claude Code
Codex CLI
开源协议
MIT 完全开源
闭源商业
MIT 开源
系统提示词
< 1000 token
~10k–15k token
~12k token
内置工具数
4 个
20+
10+
模型绑定
模型无关,15+ 厂商
仅限 Claude 系列
偏 OpenAI 系列
Plan 模式
无(靠扩展/文件实现)
内置
内置
子 Agent
无(靠扩展实现)
内置黑盒子 Agent
部分内置
权限弹窗
默认 YOLO,无弹窗
完整审批弹窗
有操作确认
会话结构
树状分支,可回溯 fork
线性 + 分支恢复
线性 + 续接
本地模型
原生支持(llama.cpp)
有限
有限
Token 开销
极低(约 CC 的 30–40%)
很高
较高
部署形态
SDK 嵌入 / TUI / RPC
CLI 为主
CLI 为主
 一句话总结:Pi 不是「更强」,而是「更克制」。 它的高级特性几乎都要自己装配,但换来的是完全的透明、可控与模型解耦。 

六、选型决策树:你该用哪一个?

  • 选 Pi,如果你
    :要做二次开发 / 私有化部署 / 本地模型跑代码(数据不出内网)/ 想读通 Agent 源码当学习样本。它的内核干净透明,可以直接把 `pi-agent-core` 当 SDK 嵌进你的产品。
  • 选 Claude Code,如果你
    :想要开箱即用、不折腾配置、信任官方生态,能接受系统提示词膨胀带来的 Token 成本。
  • 选 Codex CLI,如果你
    :深度绑定 OpenAI 生态、看重内核级沙箱安全(macOS Seatbelt / Linux Landlock),需要云端定向优化的编码体验。

七、极简的代价与趋势总结

诚实地说,Pi 的「减法」是有代价的: 

  • 默认没有 MCP、子 Agent、权限沙箱
    ——这些能力要通过装扩展包补齐(Pi 仓库自带 50+ 扩展示例,覆盖子 Agent、Plan 模式、权限门、MCP 集成、沙箱等);
  • 默认 YOLO 模式无弹窗
    ,把安全决策权完全交给你,风险自担;
  • 生态偏早期
    ,社区扩展量还不如 Claude Code 成熟。
 但同样确定的是,2026 年的 Agent 设计正从「功能堆砌」转向「内核克制 + 扩展优先」。Pi 用 1500 行代码证明了一件事:Agent 真正容易失控的,不是模型不够强,而是运行框架替用户做了太多不可修改的决定。 把控制权还给用户,才是长期主义的答案。

上手一次就懂

安装与启动只需两步:

# 安装(注意新包名已迁到 @earendil-works 作用域) npm install -g @earendil-works/pi-coding-agent 

启动,进入项目目录后直接敲 pi

 pi 

想扩展能力,也是一条命令的事:

# 从 npm 或 git 安装扩展包 pi install npm:@foo/pi-tools pi install git:github.com/badlogic/pi-doom 

会话还支持树状分叉——用 `/tree` 回到任意历史节点继续实验,用 `/export` 导出 HTML、用 `/share` 生成 gist 分享。这种「完全可观测」的体验,正是 Pi 铁粉最舍不得的地方。

极简不是简陋,而是把复杂留给自己、把控制交给用户。这,就是 Pi。

相关学习资料