8.5 万星背后，Pi 不只是另一个”平替 Claude Code”

拾光·开源拾遗 技术创作者 2026-08-08 1385 阅读

8.5 万星背后，Pi 不只是另一个”平替 Claude Code”

一个开源项目，能让社区主动喊出”唯一能平替 Claude Code 的选择”——这话出自见过世面的独立开发者之口，不是随便说说。

earendil-works/pi 就是这样一个项目。上线不到一年，GitHub Star 突破 85,376，Forks 超过 10,594，持续占据 Trending 头部。它到底是什么，解决了什么问题？

这个”pi”不是圆周率，是一个 Agent 运行时

Pi 来自独立开发者 badlogicgames（libgdx 游戏引擎的作者），不是一个单独的 CLI 工具，而是一套完整模块化的 Agent 开发框架：

包 功能
pi-coding-agent 交互式编程 Agent CLI，类 Claude Code 体验
pi-agent-core Agent 运行时，含工具调用和状态管理
pi-ai 统一多模型 API，OpenAI/Anthropic/Google 等
pi-tui 终端 UI 库，差分渲染
pi-telemetry 厂商中立的遥测契约和适配器

安装方式：

npm install -g @earendil-works/pi   # 全局安装
npx @earendil-works/pi              # 或者直接 npx
pi config                           # 首次配置 API Key

支持通过 curl -fsSL https://pi.dev/install.sh | sh 安装独立二进制，也有 Homebrew 包。配置完成后，pi -c 继续上次会话，pi -r 浏览并选择历史会话。

为什么值得关注：它解决的是真实痛点

痛点一：多模型 API 管理混乱

每个模型提供商的 SDK 不一样，切换模型要改代码。Pi 的 pi-ai 包提供了统一的多模型 API 层，支持 OpenAI、Anthropic、Google 等多个提供商，模型注册表从 OpenRouter 和 models.dev 数据自动生成。切换模型只需要改一行配置，而不是改一堆 SDK 调用。

痛点二：Claude Code 们是”黑箱”，不透明

Claude Code 和 Codex 功能强大，但底层逻辑对开发者是封闭的。Pi 的优势在于它是开源的、模块化的——你可以看到 Agent 运行时的每一个决策点，可以替换掉你不想要的组件。

痛点三：会话共享和复用

Pi 支持通过 badlogic/pi-share-hf 将编程会话发布到 Hugging Face 数据集。这意味着你可以把自己的 AI 编程过程分享给社区，也可以学习他人解决真实任务时的思路。badlogicgames 本人就定期公开自己的 pi-mono 工作会话到 Hugging Face。

实测对比：Pi vs Codex

CSDN 上一位开发者做了详细的横向评测，核心维度打分如下：

维度 Codex Pi 说明
安装与启动流程流畅度 7/10 9/10 Codex 中间被沙箱和提权打断；Pi 流程更顺
任务完成度 9/10 8/10 Codex 在复杂任务上略强
交互体验 7/10 9/10 Pi 更克制，不容易”过度发挥”
开源透明性 2/10 10/10 Pi 完全开源，可审计可扩展

“能力更克制，但交互更顺手。如果问我更愿意长期把哪个工具放在命令行里，我目前还是会选 Pi。”
—— 独立开发者评测

独立开发者社区的评价更直接：“Pi Agent 是目前唯一能平替 Claude Code 的选择”（优设网，2026年7月）。

项目边界与真实使用门槛

它能做什么

  • 命令行编程 Agent：直接跑在终端里，适合日常编码任务
  • 多模型统一调用：不需要分别管理各家的 SDK
  • Agent 运行时二次开发：pi-agent-core 是通用运行时，可以接入自己的工具链
  • 会话共享：Hugging Face 数据集发布机制，适合团队知识沉淀

它的局限

  • 不是 IDE 插件：没有 VS Code / JetBrains 插件，更适合纯命令行事风格的开发者
  • 没有内置的强隔离沙箱：默认以启动用户权限运行，需要自己容器化隔离（文档有 三种容器化方案）
  • 对 Windows 用户不太友好：主要优化在 macOS 和 Linux

适合谁

  • 习惯在终端干活的独立开发者
  • 需要透明可审计 Agent 行为的团队
  • 想基于开源运行时二次开发自有 Agent 系统的开发者

不适合谁

  • 习惯 GUI IDE 全家桶的开发者
  • 需要开箱即用完整项目管理能力的用户（它只管编程任务，不管项目本身）
  • 对安全性有高要求、无法自己维护隔离环境的用户

可执行的下一步

如果你是独立开发者：

# 5 分钟跑起来
npm install -g @earendil-works/pi
pi config   # 配置 Anthropic API Key
pi          # 直接开始对话

如果你在评估团队用 AI 编程工具：

  1. 先用 npx @earendil-works/pi 跑两周，感受它的交互节奏
  2. 关注它的 GitHub Issues 和 RFC 文档，了解路线图
  3. 如果需要更强隔离，参考文档里的 Gondolin / Docker / OpenShell 三种方案

如果你是框架开发者：

  • 看看 pi-agent-core 的设计：它的工具调用和状态管理是如何分离的
  • 它用了 TypeScript，如果你的项目是 TS 的，上手会更快

链接汇总：

评论区

0 条评论

登录后可评论。

拾光·开源拾遗 1385 阅读