Pi 对比 Claude Code：值得切换到 Pi 吗？

简短结论：Pi 与 Claude Code 的核心差异在于“开箱默认”还是“自主掌控”。Pi 是采用 MIT 许可证的免费终端编程 Agent，体积精简，主动省去了子 Agent、计划模式和权限弹窗，支持通过 TypeScript 扩展按需添加功能；Claude Code 则直接内置了这些工作流。Pi 安装费用为 0 美元，只需按接入的模型服务商付费。

本周 Hacker News 上《Goodbye Claude, hello Pi》一帖突破 700 分和 430 条评论。这场争论的核心问题是：你的 Agent 壳层（包裹模型、工具与提示词的宿主程序，harness）究竟该由你自由配置，还是只能作为黑盒被动适应？

本文将梳理 Pi 的定位、计费与安装配置，结合热帖正反双方的真实反馈对比 Claude Code，并介绍如何在 HiFox 中将两者作为同一台电脑的运行时（Runtime）并存使用。

Pi 编程 Agent 是什么？

Pi 官方定位是“极简、可扩展、能彻底改造成专属工具的 Agent 壳层”。它在终端运行，负责读写文件、执行命令并与所选模型交互。项目最早由 Mario Zechner 在 pi-mono 仓库发起，现归入 Earendil 旗下，当前 npm 版本为 1.5.0。

Pi 终端编程 Agent 启动界面，显示已加载 AGENTS.md 上下文与底部模型状态栏

它有四个核心特点：

不绑定模型厂商：Pi 官网支持 15 家以上服务商和数百款模型，涵盖 Anthropic、OpenAI、Google、Bedrock、Mistral、Groq、OpenRouter、Ollama 等，会话中途可随时输入 /model 切换。
刻意保持精简：官网明确列出了未内置功能清单，省去了子 Agent、权限弹窗、计划模式、内置待办列表和后台 Bash。
使用 TypeScript 扩展：扩展可注册工具、命令、快捷键、模型服务商及终端 UI。技能、提示词模板和主题可打包通过 npm 或 Git 分发。
易于脚本化调用：提供交互式 TUI、纯文本打印与 JSON 模式（pi -p）、基于标准输入输出的 RPC 协议及 TypeScript SDK。

此外，它的会话按树状结构存储，输入 /tree 即可跳回任意历史节点并分叉出新分支。

Pi 免费吗？

免费。Pi 采用 MIT 开源许可，安装费用为 0 美元，你只需为模型用量买单。官方快速上手文档说明，可通过已有订阅、API 密钥或本地模型获取访问权限：

接入方式	费用构成	配置方法
API 密钥	按模型服务商的 Token 单价计费	执行 `export ANTHROPIC_API_KEY=...` 后运行 `pi`
通过 `/login` 使用已有订阅	复用你现有的订阅套餐	输入 `/login`，选择服务商并完成 OAuth 登录流程
本地模型（Ollama、llama.cpp）	仅消耗本机硬件资源	将 Pi 指向本地模型服务地址

需要注意：讨论帖中有评论者提醒，将官方订阅用于第三方壳层可能面临违反服务条款（ToS）导致封号的风险。用付费订阅登录前建议先核对服务商条款，或直接使用 API 密钥避开合规争议。

如何安装与配置 Pi

本机安装 Node.js 22.19 或更高版本后，只需两行命令即可完成安装：

# 方式 1：官方安装脚本（锁定依赖版本，后续可通过 `pi update` 升级）
curl -fsSL https://pi.dev/install.sh | sh

# 方式 2：通过 npm 安装
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

# 进入项目目录启动
cd ~/code/my-service
pi

进入 Pi 后，运行 /login 连接模型服务商，再运行 /model 选择模型。Pi 会自动读取 AGENTS.md 和 CLAUDE.md 上下文文件，原本为 Claude Code 配置的代码库可直接沿用原有指令。

开始真实任务前，建议先阅读 Pi 的安全说明页。文档指出，Pi 不会在每次工具调用前弹窗请求批准，且直接继承启动账户的系统权限，官方建议通过容器、虚拟机或沙盒进行隔离。

Pi 对比 Claude Code：客观拆解

Claude Code 是 Anthropic 官方编程 Agent，内置了子 Agent、钩子（Hooks）、MCP、计划模式，以及在高风险操作前请求确认的权限系统。Pi 则只保留极简核心，其余能力按需扩展。

对比维度	Pi	Claude Code
许可证	MIT 开源	Anthropic 专有闭源
支持模型	15+ 家服务商及本地模型	Claude 系列模型
子 Agent	未内置，可通过扩展添加	内置支持
计划模式（Plan mode）	未内置	内置支持
权限确认弹窗	按设计不弹窗，建议用容器隔离	可配置的批准提示
自定义方式	TypeScript 扩展、扩展包	Hooks、MCP、技能、配置文件
无头（Headless）调用	打印模式、JSON、RPC、SDK	打印模式、Agent SDK

为什么不少开发者表示正在切向 Pi

引发热议的博文《Goodbye Claude, hello Pi》（作者 Caleb）将原因归结为日常小挫败的长期累积，主要集中在四点：

系统提示词频繁变动：作者统计 Claude Code 今年已发布 244 个版本，超四分之三修改了系统提示词或工具描述，导致工作流表现漂移。
Token 额外开销：据作者统计，默认 Bash 工具描述文本就占用近 3,000 个 Token，且大部分内容在讲 Git 和 Pull Request。
IDE 连接限制：同一时间只允许连接一个 VS Code 会话，而作者在 Pi 里花约 20 分钟写扩展就解决了该问题。
产品定位偏移：作者认为内置 Agent 团队和审阅模式更倾向消耗企业级 Token，而非服务单个开发者。

评论区开发者还补充了终端渲染闪烁、回滚缓冲区（scrollback）错乱及对 AGENTS.md 支持较晚等问题。

为什么另一些开发者选择留在 Claude Code

反对声音同样具体。有评论者表示，让 Pi 达到 Claude Code 的能力水平需耗费大量时间自己折腾且几乎必须装扩展；同时 Claude Code 在 Anthropic 模型上的上下文压缩（compaction）和提示词缓存表现更好。也有人提醒，安装第三方扩展意味着必须信任能接触到 OAuth 令牌的外部代码。

此外还有成本考量：不少开发者留在 Claude Code 是因为固定订阅相比按 Token 计费具备明显的额度补贴（后续可参考 Claude Code 用量上限与各档位额度指南）。

哪一款更适合你

想掌控 Agent 壳层、自由切换多厂商模型、保持提示词精简，且习惯在容器内运行 Agent，选 Pi；希望子 Agent、计划模式和权限审批开箱即用，且主力使用 Claude 模型，选 Claude Code。许多开发者会同时保留两者，按任务类型分工调用。

在 HiFox 中同时运行 Pi 与 Claude Code

如果任务描述、执行进展和代码审阅都锁在单个终端会话里，每换一个工具都要重搭工作流。HiFox 是位于编程工具之上的协作层：你在看板创建任务并指派给 Agent，Agent 通过已接入电脑上的运行时（Runtime）执行工作。电脑详情中可通过「支持更多 Runtime」查看并安装其他受支持的 Runtime（Pi 是否已纳入线上「支持更多 Runtime」列表以线上产品为准，待核实；若未被自动检测到，也可在电脑详情中添加自定义 ACP Runtime）。

在目标电脑安装对应工具后，打开电脑详情页点击重新检测即可。电脑与运行时文档说明了各状态含义：标为「未检测到」的运行时需先在本机安装对应 CLI，状态为「可用」才能接收并执行 Agent 任务。

# 在运行 Agent 的电脑上安装 Pi 并连接 HiFox
curl -fsSL https://pi.dev/install.sh | sh
hifox computer register --install-token hit_...   # 每台电脑首次接入时执行一次
hifox computer list                               # 确认电脑状态已在线

接入后，同一看板即可并行调度两类 Agent：将复杂模块重构指派给运行在 Claude Code 上的 Agent，将依赖升级交给运行在 Pi 上的 Agent，并在同一任务视图集中审阅改动。HiFox 本身不售卖 Token，模型消耗仍走各运行时原有的订阅或 API 密钥。