10 月 1 日，Earendil 把 Pi 升到了 1.0。这家公司今年 4 月才把 Pi 买下来，创始人之一是 Flask 的作者 Armin Ronacher；Pi 本来的作者 Mario Zechner 是游戏框架 libGDX 的开发者。1.0 这个版本最不寻常的地方不是加了什么功能，而是它把自己坚持了一年的一条公开立场推翻了——Pi 曾经明确拒绝 MCP，还把这件事写在官网上当卖点。
这一篇不比较参数高低，只回答四个问题：它到底是什么东西、装上要什么门槛、免费这件事在它这里怎么算，以及那个最需要先想清楚的默认行为。
它到底是什么：一套马具，不是一匹马
Pi 官方给自己的定义是 agent harness。「harness」这个词直译是马具、挽具。模型是马，能跑多快、答得多好是马的属性；harness 决定的是这匹马能拉什么车、你怎么吆喝它。所以 Pi 自己不含模型，也不打算含——它要做的只是那条循环和那几件工具。
默认装上的工具只有四个：读文件、写文件、改文件、执行命令。另外三个（grep、find、列目录）默认是关的，需要自己开。官方在「我们没做什么」那一栏里列了六条：没有内置子智能体、没有权限确认弹窗、没有计划模式、没有内置待办、没有后台 bash，以及——在 1.0 之前——没有 MCP。每一条后面都跟着同一个答案：自己写扩展，或者装一个别人写好的包。
这个取舍带来的手感差异很直接。你让 Claude Code 或 Codex 干活，它先给你一份计划、再问你要不要执行；Pi 不问，它直接开始，把每一步的工具调用打在屏幕上。代价是整个工作方式要你自己定义。
装上它要多久：一条命令，门槛只在 Node 版本
安装本身是四选一。macOS 和 Linux 是一行 curl -fsSL https://pi.dev/install.sh | sh，Windows 是一行 powershell -c "irm https://pi.dev/install.ps1 | iex"，另外还有 npm 和 Nix 两条路。这里有个容易被忽略的差别：官方安装脚本会锁定全部依赖版本并校验 lockfile，而 npm 全局安装不锁传递依赖——官方文档把这条写在了明面上，对供应链敏感的团队，它推荐走安装脚本那一条。
真正的门槛在 Node 版本上：Pi 要求 Node.js 22.19 或更新。安装脚本会在缺失时自己装一个 Node，npm 路线则要你自己保证版本够新——用 Node 20 的人必须先升级，否则连起来就报错。
装完进到项目目录敲 pi 就起来了。第一次要在界面里敲 /login 接模型，可以选 Claude Pro/Max 订阅、ChatGPT 的订阅登录、GitHub Copilot 订阅，也可以直接填某家的 API key。想完全不花钱，就本地跑一个 Ollama，在配置文件里指向本机端口，再敲 /model 选中它。官方列出的供应商有 15 家以上，包括 Anthropic、OpenAI、Google、Azure、Bedrock、Mistral、Groq、Cerebras、xAI、Hugging Face、Kimi、MiniMax、NVIDIA、OpenRouter 和 Ollama。
升级要用 pi update，不要拿 npm 再装一遍——两条路线混用会互相覆盖。
「免费额度」这个问题，在 Pi 这里要换个问法
前面两期测的东西都绕不开一笔账：Qoder 给的是 Credits，小艺 Work 给的是 AI 点。Pi 没有点数，因为它的软件端根本不卖东西——MIT 授权，代码公开，装一百台机器也是零成本。Earendil 没有给 Pi 设订阅档，也没有「到期后云端产出立即删除」这类悬崖。
但「免费额度有多少」这句话问的其实是使用成本，那个数字依然存在，只是从厂商的配额表挪到了你自己的模型账单上。三条路线对应三种成本结构：手上已经有 Claude 或 ChatGPT 的付费订阅，可以在 Pi 里用订阅登录，等于把这笔已经付过的钱再用一遍；填 API key，就按那家模型自己的计价方式按量结算；接本地 Ollama，则是把钱换成电费和显卡占用，模型越大小心越慢。
这三种没有哪个更「划算」，取决于你本来就在为什么付钱。值得注意的是第三种的边界：能本地跑得动的模型和前沿模型不是一个量级，日常改小脚本够用，碰上大仓库的多文件重构会明显吃力。
已经在为某个模型订阅付费的，先去 Pi 里试订阅登录那条路，别急着买 API 额度。
1.0 最值钱的改动：把工具清单搬出上下文
这一版真正的技术内容都围着一件事转：怎么让模型「看得见的工具」变少，但能干的事不变。这件事之所以要紧，是因为 MCP 服务器普遍很占地方——Playwright、Chrome DevTools 这类常见的服务器，一次会话光工具定义就能塞进来二十几条，这些 token 在智能体干任何活之前就已经花掉了。
Pi 原先的立场很硬。2025 年 11 月 Zechner 写过一篇标题叫《如果你根本不需要 MCP 呢》的文章，主张用「小命令行工具加一份按需阅读的说明」来替代协议；Pi 官网当时也拿「没有 MCP」当卖点。1.0 掉头支持之后，Earendil 专门写了一篇解释，标题是《You Said No, MCP!》，给出的理由有两层：一是协议本身成熟了，二是实现 MCP 所需的那个沙箱，正好也是其他能力所需要的——用官方的话说，「Pi 需要的其实和 MCP 需要的东西很像：一个能玩的解释器沙箱」。
那层沙箱就是 Codemode。它换掉了工具调用的形态：模型不再一个一个地调工具、等结果、再调下一个，而是写一段 JavaScript 把多个调用串起来、在脚本里循环和过滤，只把结果交回上下文。脚本跑在 harness 这一侧的沙箱里，不带 Node、文件系统和网络的原生权限，要用这些资源必须走暴露出来的工具；脚本的中间状态留在会话记录里，不落到文件系统上。选 JavaScript 是因为小体积的引擎能以 WASM 二进制发布，隔离性可控。
配套的还有一条 deferred tool loading：工具定义不再在开头一次性全列给模型，而是按需加载。两者叠加后，官方给出的数字是——在默认工具加 Codemode 的情况下，一次 GPT-5.6 请求的提示词从约 5,300 个 token 降到约 3,300 个，降幅约四成。官方举的例子是从 Linear 的 MCP 服务器拉回 250 条待办、逐条判断评论情绪，几百次 MCP 调用最后折叠成上下文里能看见的一条结果。
需要说清的是边界在哪：Codemode 改变的是这些调用在哪里组合，不改变服务器往你上下文里塞什么。Earendil 在自己的解释文章里承认了这一点，也把矛头指向 MCP 服务器——很多服务器仍然是为「把全部工具定义灌进上下文」的客户端设计的，返回的是给模型直接读的文本而不是结构化数据。
同一个版本还顺手做了两件不放在主线上说的事
第一件是 Pi Durable，和 1.0 同一天发的实验性包。它把「长时间运行的智能体」这件事从终端里拿出来单独做：用 SQLite 或 JSONL 存会话状态，进程崩了或重启可以从上次的检查点接着跑，支持并发和分叉会话，也允许多个客户端同时接进同一段对话里干预。官方明确标着「实验性」，存储格式和 API 都可能变，所以拿它上生产要留退路。Earendil 把这一层单独拆出来，是为了不让 Pi 本身变胖——官方拿 Python 世界打了个比方，说 Pi 想当 Flask，不想当 Django。
第二件是虚拟模型。扩展可以把几个模型拼成一个「模型」暴露给用户。官方演示里，规划阶段跑 Claude Opus，由决策模型 Jev 判断什么时候进入实现阶段，然后交给 GPT-6 Luna 接着写，用户在界面上只看到一个叫作 router/auto 的模型。这件事的意义不在于具体用了哪几个模型，而在于混合调度被放在了你可以改的扩展层，而不是厂商替你定死的产品层。
最需要想清楚的一件事：它默认不问你一声
「没有权限确认弹窗」不是 1.0 新加的特性，而是一直写在官网「我们没做什么」那一栏里的设计。意思很直白：Pi 用你当前账号的权限执行命令、写入和改写文件，动手之前不问你。
这是它和 Claude Code、Codex 最明显的分歧点。Claude Code 默认会对改动收口，Codex 也会给你确认环节；Pi 认为这一步应该由你按自己的环境和安全要求来搭。好处是过程不被打断，一个任务能连着跑完；坏处同样直接——模型判断错一次，代价落在你的工作目录上，而它没有「撤销」这种东西。本地跑的时候，它和你在同一个文件系统里，权限一样大。
官方给的答案是两条：跑在容器里，或者用扩展自己写一套确认流程。Pi 的示例扩展里就有一个 permission-gate（在工具执行前拦一道）和一个 protected-paths（把某些路径锁住），都是现成的，装包就行。
准备在自己机器上试的，先腾一个可丢弃的目录，别在正在跑的项目根目录里敲这个命令。
谁该用、以及先别急的人
适合它的画像比较清楚：手上已经有好几个模型渠道（订阅、API、本地各一份）想用一套马具统一起来的人；愿意用 TypeScript 写扩展、把工具和界面改成自己形状的人；以及已经在用 OpenClaw 的人——OpenClaw 就是拿 Pi 当内核搭的，Pi 的这套设计决定会顺着传到它身上。还有一个被低估的用法：Pi 有 print 模式和 JSON 事件模式，可以直接塞进脚本和 CI 里跑，不必是交互式终端。
不适合的画像也清楚。想要开箱即用、自带计划模式和子智能体的成品，Claude Code、Codex 或者开源的 OpenCode 更省事；完全不碰命令行的人不用考虑；以及需要厂商兜底额度的团队——Pi 不提供这一层，额度的事从头到尾是你自己的。
放回本栏目测过的三个工具里看会更清楚：Qoder 是「一个工作台加 Credits」，小艺 Work 是「一个手机入口加 AI 点」，两者都把体验打包好了，代价是额度到期即停、云端产出有保存期限。Pi 是另一个极端——它把额度和流程这两件事整个交回给你，换来的是一份 MIT 授权、能改成任何形状的代码。星标和下载量都不算小，但这些数字说明的是关注度，不等于你的团队明天就能上手。
本文为公开信息整理与解读，数据以各厂商官方口径为准。
附：本文信息来源
一、一手信息
发布、设计与文档
- Earendil：Pi 1.0 官方发布帖（2026-10-01；1.0 新增 Codemode、原生 MCP、虚拟模型、延迟工具加载、Anthropic 缓存预热、会话中途系统消息、全屏默认）
- Earendil：Pi Durable 官方发布帖（实验性包；SQLite 与 JSONL 存储、检查点续跑、并发与分叉会话、多客户端接管）
- Earendil：You Said No, MCP!（官方解释掉头支持 MCP 的原因，以及「沙箱解释器」这条共同需求）
- Pi 官方网站：产品定位、15 家以上供应商与四种运行模式
- Pi 官方文档：安装、模型接入与 MCP 配置
- Pi 包目录：可安装的第三方扩展包索引
- 源码仓库：earendil-works/pi（GitHub）（MIT 授权；Node.js 22.19 及以上；issue 列表）
- npm 包页：@earendil-works/pi-coding-agent（当前包名与版本）
- Mario Zechner：为什么是 Pi（2025-11-30，作者本人对极简路线的说明）
- OpenClaw 仓库：把 Pi 当内核的真实项目（GitHub）
- 官方扩展示例：permission-gate 与 protected-paths（自己搭权限确认流的起点）
二、媒体报道
英文
- The Register：Pi coding agent pulls a 180 and adds MCP support（2026-10-02，Thomas Claburn；Earendil 由 Armin Ronacher 与 Colin Daymond Hanna 创办、2026 年 4 月收购 Pi、Flask 与 Django 的比喻）
- GIGAZINE：The free and open-source AI coding tool Pi 1.0 has been officially released（2026-10-02；四个基础工具、Codemode 与延迟工具加载的作用）
- DEV Community：Pi 1.0 reversed on MCP and shipped Codemode: where tool composition actually runs now（Codemode 的沙箱位置、状态存在会话记录里、Linear 拉 250 条待办的演示、选 JavaScript 是因为小体积引擎能以 WASM 发布）
- Beyond the News：Pi 1.0 makes Codemode and MCP part of a stable minimal coding-agent harness（1.0 的边界划分、稳定不等于沙箱化的提醒）
- The Terminal：Pi 1.0 coding agent: MCP support, MIT licence, what is new（六项更新清单、112,000 星标与 186 个未关 issue、官方未给 Codemode 基准数据）
- ClaudeWave：Pi, the minimalist coding agent, reverses course on MCP（Zechner 早年反对 MCP 的理由与上下文成本、MCP 已于 2025 年 12 月捐给 Linux 基金会下的 Agentic AI Foundation）
- Kanaries Docs：How to Use Pi Coding Agent 1.0: Install, Connect a Model, and Run Your First Task（安装四条路径与各自的坑、七个内置工具、明确写着「Pi 执行命令或改文件前不会请求许可」）
- Omid Saffari：Pi Coding Agent: Set Up Pi 1.0 With Your Own Model（订阅登录与 API key 是两条不同的计费路径、本地模型的自定义端点写法）
- The Dev News：Pi 1.0 Coding Agent Setup: Set up and MCP information（Codemode 约省四成提示词 token、MCP 服务器的添加与配置位置）
- AI/TLDR Daily Digest：2026-10-03 摘要（Pi 1.0 条目：全屏默认、Codemode 的 token 对比、Pi Durable 逐次检查点）
中文
- DAMO 开发者矩阵：AI 新闻日报 2026-10-03（中文口径的星标、分支与 npm 周下载量，以及「提示词瘦身属厂商自测口径」的说明）
- 龙虾智能体：用 Pi 1.0 搭一个极简可定制的编码智能体：安装、扩展包与 Codemode MCP 实操（中文上手流程、没有内置计划模式与子智能体的预期管理、安装脚本与 npm 路线在依赖锁定上的差别）
其他
- 开发者社区上 Pi 1.0 的发布讨论帖
相关阅读
原创声明：本文由 618A 情报站整理撰写，基于公开信息与实测记录，转载请注明出处并保留原文链接。