Pi 编程代理替代方案：根据离开原因和迁移成本进行选择

你不必因生命周期原因离开 Pi 编码代理：2026 年 9 月 21 日，GitHub API 报告 earendil-works/pi 采用 MIT 许可证且未归档，版本 v0.87.0 于当天发布。人们真正迁移的原因是设计选择。在 2026 年 9 月 22 日文档更新之前，Pi 自己的文档称其“有意不包含内置 MCP、子代理、权限弹窗、计划模式、待办事项或后台 bash”，并建议你“将这些工作流构建或安装为扩展或软件包，或使用容器和 tmux 等外部工具”。更新删除了这句话；2026 年 9 月 29 日发布的 v0.99.0 将六项中的一项纳入其中——MCP 现在是默认加载的内置扩展。在 v0.99.2 中，其余五项仍未内置。因此，有用的问题不是哪个代理更好，而是你希望这五项中的哪些项内置，以及从 ~/.pi/agent 迁移会让你承担什么代价。

需要先消除一个歧义，因为搜索结果至少混淆了五种不同事物。本页面介绍的是位于 pi.dev 的终端编码代理，仓库为 earendil-works/pi，npm 包为 @earendil-works/pi-coding-agent。它不是 pi.ai 上 Inflection AI 的 Pi，后者是完全不同的产品；也不是 Pi Network 代币、Raspberry Pi 或数学常数。旧的 shittycodingagent.ai 域名现在会重定向到 pi.dev，而 badlogic/pi-mono 会解析到当前仓库，因此旧链接会落到正确位置，却不会告诉你它们已经迁移。

将离开的原因与目标相匹配

下面每一行都是 Pi 自己的文档中作为有意省略或边界出现过的一个原因，并配有一个记录了相应功能的项目。本文没有进行运行时测试。

在选择之前，有两个边界值得说明。Pi 的安全页面在 2026 年 9 月 22 日文档更新中重写后明确表示，Pi“可以使用启动它的账户权限读取、修改和执行文件，并且不会在每次工具调用前请求批准”，同时将“缺少内置沙箱”列为通常不属于其安全边界的行为之一。其项目信任提示也不是缺失的权限系统：同一页面表示，信任“控制 Pi 是否加载工作文件夹提供的大多数设置和资源”，并且“不限制工具调用可以访问或影响的内容”。如果隔离是你离开的原因，那么答案是采用审批模式的客户端或容器，而不是默认换用另一个终端代理。

在确定名称之前先检查状态

Pi 的替代方案列表包含处于三种不同状态的项目，而 GitHub 上有一个字段会主动误导人。请读取发布和提交日期，而不是读取 pushed_at。

仓库事实取自 GitHub API 及各项目官网，日期为 2026 年 9 月 21 日。Star 数量和推送时间戳每天都会变化，因此有意省略。Continue 是需要读两遍的那一行：其 pushed_at 字段显示较近的日期，是因为存在仅涉及文档的提交，这正是它持续出现在当前推荐列表中的原因。Kunavo 自己的 Continue 替代方案和 Aider 替代方案页面分别介绍这两个项目。

真正离开 ~/.pi/agent 的是什么

这是对比表格略过的部分，也是实际切换成本所在。Pi 将所有内容保存在一个目录中，而其中七类内容的命运并不相同。

信息取自 Pi 的使用、安全、模型、会话和 提供商页面、OpenCode 的规则页面以及 Oh My Pi 的模型文档，均于 2026 年 9 月 21 日查阅；auth.json行的解析顺序于 2026 年 10 月 1 日从 Pi 更新后的模型页面重新读取，mcp.json行同日从其 MCP 页面读取。

迁移时不要烧掉回头路

# 1. Change nothing in Pi. Everything below leaves ~/.pi/agent intact.

# 2. Rules travel as-is. Pi already reads the repo's AGENTS.md;
#    so do the destinations that document AGENTS.md support.
cp ~/.pi/agent/AGENTS.md ~/.config/opencode/AGENTS.md   # global rules, OpenCode

# 3. Of the destinations checked here, only Oh My Pi documents a converter,
#    and it only fires from its OWN directory — not from ~/.pi/.
mkdir -p ~/.omp/agent
cp ~/.pi/agent/models.json ~/.omp/agent/models.json     # omp writes models.yml

# 4. Do NOT copy auth.json. Mint credentials in the destination instead.

# 5. Roll back at any time: pi still reads ~/.pi/agent, sessions included.
pi

两个细节决定了切换是干净利落，还是换来一个充满 404 的下午。首先，在一个完整的编辑、测试和审查周期通过之前，将目标客户端置于单独的 worktree 或分支中——Pi 始终（包括会话在内）读取 ~/.pi/agent，因此回滚只需再次运行 pi。其次，在目标客户端中重新填写成本和限制元数据，不要假设它们会随之迁移。Pi 的源代码（v0.99.2）会将自行添加模型的 cost 块默认设为全零，同时将 contextWindow 设为 128,000 个令牌、将 maxTokens 设为 16,384——因此，你正在迁出的 Pi 成本读数可能一直显示为 $0。值得在将目标客户端的数字视为预算之前，检查它是否存在同样的盲点。Pi 定价包含完整的自定义提供商块及其注意事项；本页面有意不重复这些内容。

如果你比较的是特定组合而非某一类别，Oh My Pi 与 Pi 对比会详细介绍这个分支，Pi 与 OpenCode 对比和 Pi 与 Claude Code 对比会分别进行正面对比，而 OpenCode 替代方案则从另一方进行同样的分析。

更换客户端不会改变令牌账单

这些客户端本身都不会向你收费，而且每个客户端都可以使用你配置的任意模型路由——这正是上方表格中 api、baseUrl 和密钥字段的用途。若干供应商还提供自有密钥的第一方替代方案（Radius、Zen、Hyper、ClinePass、OpenHands provider），Claude Code 和 Codex CLI 还可以登录其供应商自己的订阅计划，因此下面的数字仅描述自带路由的情况。无论如何，退出的理由必须是功能，而不是价格：切换代理本身不会改变模型成本。

下面的数字是示例性的令牌算术，不是实测任务成本，也不是账单上限。假设一个会话发送 200,000 个未缓存输入令牌并接收 15,000 个输出令牌，不读取缓存、不写入缓存、不输入图像且不产生工具费用。费率按每百万令牌从实时的 Kunavo 目录呈现。

在将其中任何数字视为预算之前，先按你每天的会话数进行缩放，并将两个说法分开：列出的最低费率与完成任务的最低成本是两回事，因为一个需要尝试三次的小模型，成本可能高于一次就完成修改的更强模型。Kunavo 目录金额是计费下限，而不是上限——当上游报告其费用时，账单取目录成本与上游成本乘以适用加价两者中的较高者，计费页面对此有说明。预付余额的最低充值额为 $10 ，这是资金充值最低额，而不是任务费用或订阅费。

如果你在比较内置代码库索引的代理，需要提前规划一个能力缺口：Kunavo 不提供 embeddings。它不提供任何 embedding 模型，也不提供文本转语音或语音转文本模型，因此需要 embedding 端点的索引步骤必须使用独立的提供商。

Kunavo 在本页面为 Pi 及若干目标客户端提供配置参考。已发布的设置指南不等于兼容性测试：这些客户端都未针对 Kunavo 端点进行运行时测试，上述每项协议声明都来自各项目文档，而不是实际运行结果。如果该分支是你的目标，请从 Pi 集成指南或 Oh My Pi 集成指南开始，测试期间保留一条可用路由，并在准备好针对入选模型为一项范围明确的任务估算价格时创建 Kunavo 账户。

常见问题

此处检查的内容及方式。Pi 和 Oh My Pi 的仓库状态及最新发布版本于 2026 年 9 月 21 日从 GitHub API 读取；Pi 的使用、安全和模型文档、Oh My Pi 的模型文档以及 OpenCode 的规则页面也于同日读取。Pi 于 2026 年 9 月 22 日更新文档后，其凭据顺序和 api 列表于 2026 年 10 月 1 日在模型页面重新检查；更新后的文档不再说明的自定义模型默认值，则从其 v0.99.2 源代码中检查。当天，在 Pi v0.99.0 发布内置 MCP 后，针对其使用、MCP、设置和 CLI 页面以及 v0.99.2 源代码重新检查了省略功能列表，针对其重写后的安全页面重新检查了沙箱和项目信任相关引文，并检查了其源代码分派的 api 值。剩余各行——OpenCode、Crush、goose、OpenHands、Cline、Codex CLI、Aider 和 Continue——同日从 GitHub API 及各项目链接的页面读取：OpenHands 的定价表、Cline 的 ClinePass 页面、OpenCode 的 Zen 页面、Crush 的 README 和 LICENSE.md、goose 的提供商文档、Codex CLI 的配置参考以及 continue.dev。此处内容没有与上述任何服务的实时账户进行核对。Kunavo 费率从实时目录呈现，此处所有美元数字都是示例性的令牌算术。本页面中的客户端均未针对 Kunavo 进行运行时测试。