Pi 编码代理价格：软件免费，但令牌不免费

Pi 编码代理无需付费即可安装：它是采用 MIT 许可证的软件，没有套餐，也没有席位价格。你在 Pi 上花费的每一美元都是模型 token 费用，而这些费用通过四类渠道支付。它们分别是 Earendil 自有的 Radius 网关、通过 /login 登录的账户——Pi 的供应商文档在 2026 年 9 月 22 日更新前列出了七种方式，其中包括 Claude Pro/Max、通过 Codex 使用的 ChatGPT Plus/Pro 以及 OpenRouter——直接的供应商 API 密钥，或你自行添加到 ~/.pi/agent/models.json 的任何 OpenAI 或 Anthropic 兼容端点。它们的计费方式差异很大，因此“Pi 要多少钱”没有单一答案。

本页面介绍的是 Earendil Inc. 在 pi.dev 发布的终端编码代理。它不是 Inflection AI 的 Pi（pi.ai），不是 Pi Network 代币，不是 Raspberry Pi，也不是 Oh My Pi——后者是另一位作者开发的独立 MIT 许可编码代理。它们的价格均不适用于此处。

Pi 编码代理定价：每一层如何收费

检查日期为 2026 年 9 月 18 日，并于 2026 年 9 月 21 日重新检查的来源：Pi 仓库（MIT，未归档）、官方网站、列出七种 /login 渠道的 Pi 供应商文档，以及 Radius FAQ。Pi 在 2026 年 9 月 22 日的文档更新中删除了七种方式的列表；供应商页面现在写着“使用 /login [provider] 查看供应商支持的方法”（于 2026 年 10 月 1 日重新阅读）。Radius 还说明自己“目前是闭源服务”。

有一个名称陷阱值得单独说明，因为它会悄悄影响你安装的内容。Pi 于 2026 年 5 月 7 日从 badlogic/pi-mono 和 @mariozechner npm 作用域迁移到 earendil-works/pi 和 @earendil-works；0.74.0 是新作用域下的首个版本，0.73.1 是旧名称下的最后一个版本，旧包已弃用但未取消发布。第三方教程和答案引擎仍会提供已失效的安装命令。当前安装命令是 npm install -g --ignore-scripts @earendil-works/pi-coding-agent；在 2026 年 9 月 21 日检查 npm 注册表时，最新版本为 0.86.1，于 2026 年 9 月 20 日发布。

订阅渠道是预算失控的地方

如果你已经付费订阅 Claude Pro 或 Max，显而易见的做法是使用该订阅登录。Pi 会告诉你这实际上意味着什么。在 2026 年 9 月 22 日文档更新之前，其供应商文档写道：“第三方 harness 的使用量会从额外用量中扣除，并按 token 计费，而不是计入 Claude 套餐限额。”更新删除了这句话，只留下一个设置项 warnings.anthropicExtraUsage，用于“在 Anthropic 订阅认证可能使用付费额外用量时发出警告”；在 Pi v0.99.2 的源码中，警告本身仍写着，第三方 harness 的使用量“会从额外用量中扣除，并按 token 计费，而不是计入你的 Claude 套餐限额”。一位看到 Pi 终端中同样警告的用户将其提交为 issue #3670；机器人自动关闭了该 issue，维护者回复称 Anthropic 不允许以这种方式使用套餐额度，同时指出订阅登录仍可用于额外用量。按 Pi 的说法，订阅不是 Pi 的预算，而是单独按 token 收费的前提条件。Anthropic 自己的 Agent SDK 文章目前对第三方应用的说法正好相反——自 2026 年 6 月 15 日更新以来，它称这些使用量“仍会从你的订阅使用限额中扣除”——因此请在短暂会话后检查 Settings > Usage，不要只相信其中任何一句话。

Anthropic 方面对费用的说法是一致的。其帮助中心称，使用额度按标准 API 费率计费，并在 Web 应用的 Settings > Usage 中启用。单独的使用量套餐文章公布了预付使用量套餐的折扣：

同一篇文章规定，个人 Pro 和 Max 套餐每月购买用量包的金额上限为 $2,000，Team 套餐为每月 $3,000，并说明价格和套餐可能发生变化。该文章日期为 2026 年 5 月 18 日；额外用量文章日期为 2026 年 8 月 10 日。

两篇文章描述的是不同的余额和不同的界面，因此应同时阅读，而不是只看其中一篇。套餐文章称，使用量套餐余额“适用于 Claude、Claude Desktop、Claude Mobile（iOS 和 Android）、Claude Code、Cowork，以及使用你的 Claude 账户的第三方产品”。额外用量文章称，“使用额度同时适用于 Claude 对话和 Claude Code 终端使用”，但没有明确说明第三方 harness，既未支持也未排除。两篇文章都明确说明、且对预算最重要的计费结果是：按 token、以标准 API 费率计费。

这一警告字符串背后的政策历史也值得了解，但它来自二手报道：VentureBeat 于 2026 年 5 月 13 日报道，Anthropic 于 2026 年 4 月 4 日禁止第三方代理工具使用 Claude 订阅计费，随后通过单独的月度 Agent SDK 额度池恢复该渠道，并按 API 费率计费；该额度不会结转，用尽后也不能回退到普通订阅额度。Anthropic 自己的 Agent SDK 文章提供了取代该报道的更新信息：文章曾宣布将于 2026 年 6 月 15 日推出月度 Agent SDK 额度，随后又在同一天于文章开头加入更新，暂停了这一变化——该额度不可用，Agent SDK、claude -p 和第三方应用的使用量仍计入套餐使用限额。将 VentureBeat 所述机制视为历史，而非当前条款；在通过此方式处理付费工作前，请检查你自己账户中的 Settings > Usage。

Radius 与 Kunavo 中相同模型的费率对比

这里唯一由 Earendil 自行定价的渠道是 Radius。其模型表公布了每百万 token 的费率，并明确写道“模型可用性和价格可能发生变化”。其 FAQ 称，充值按标价另加支付处理商费用，但未公布百分比，因此无法从外部计算 Radius 的总价。下表将其公布的费率与 Kunavo 当前目录中相同三个 Claude 模型的实时费率，以及模型供应商自己的标价进行比较。

Radius 数据取自其自有文档，读取日期为 2026 年 9 月 18 日，2026 年 9 月 21 日未发生变化；Kunavo 数据来自实时目录。请注意一个比费率表更能改变账单的 Radius 机制：对于分层模型，“层级根据请求的输入 token 总数选择，并应用于整个请求”——其 gpt-5.4 行在请求超过 272,000 个输入 token 后，会从 $2.50 / $15.00 变为 $5.00 / $22.50。因此，较长的代理对话会一次性重新定价，而不是逐渐变化。

一个月度示例，按算术计算

假设一个月、一个模型、6,000,000 个未缓存输入 token 和 600,000 个输出 token，不包含缓存读取、缓存写入、图像或工具费用。这大致是一名代理在仓库上稳定进行每日工作的形态，并非经过测量的任务。

这些是在上述假设下的示例性 token 估算，不是经过测量的任务成本，也不是账单上限。Radius 一栏还不包含充值时未公布的支付处理商费用。请逐行阅读两栏，不要把它们当作结论：如果两者最终是同一个数字，选择取决于价格以外的因素；如果两者不同，差额说明你应为计划运行的具体模型定价，而不是先选择渠道再假定其余因素。

同一份估算中还应加入两点 Kunavo 方面的注意事项。目录金额是计费下限，而不是上限：当上游报告其费用时，账单取目录成本与上游成本乘以适用加价之间的较大值，计费指南对此有说明。此外，最低充值额是$10 的预付余额，这是开通有资金账户所需的现金，不是任务费用或订阅费。缓存费用另行计算，详见缓存。

列出的最低费率不等于完成任务的最低成本

这是两个不同的说法，将它们混为一谈，就会让便宜渠道变得昂贵。每百万 token 价格只有三分之一的小模型，如果需要三次尝试才能完成一次更强模型一次就能完成的修改，整体成本仍然更高。先按渠道决定，再按模型决定：

• 当你希望使用 Pi 内置的路径时选择Radius：通过 /login 使用 OAuth、拥有公布的费率表，并且 Pi 已经知道如何显示成本元数据。其 FAQ称，企业客户可以使用 BYOK。
• 当你希望获得供应商自己的功能、支持和条款，并且只需要一个模型系列时，选择直接的供应商密钥。
• 只有在阅读上文相关部分后，才选择现有订阅。它是按 token 收取额外用量费用的前提条件，不是 Pi 的捆绑额度。
• 当你所选模型的每 token 费率是决定因素，并且愿意手动配置自定义供应商时，选择 Kunavo 这样的兼容网关。
• 当硬件已经属于你，且模型确实能够处理你的工具工作流时，选择本地推理。Pi 将 Ollama、vLLM 和 LM Studio 列为自定义供应商。

然后进行测量。Pi 的使用文档介绍了一个 TUI 页脚，其中显示 token/缓存使用量、成本、上下文使用量和当前模型；/session则会打印会话文件、ID、消息、token 和成本——前提是已配置成本，这是下一节要说明的关键点。在迁移计划任务前，先对两个候选方案运行同一个有明确边界的任务。

让 Pi 指向你自己的端点

Pi 的文档没有列出通用的 base-URL 环境变量。其文档列出的变量中没有 ANTHROPIC_BASE_URL 或 OPENAI_BASE_URL——自 2026 年 9 月 22 日文档更新以来，唯一的端点条目是 AZURE_OPENAI_BASE_URL，位于供应商页面；更新删除了 AWS_ENDPOINT_URL_BEDROCK_RUNTIME，此前文档将其列为用于 Bedrock 代理的标准 AWS SDK 变量——因此自定义端点应写入 ~/.pi/agent/models.json。每次打开 /model 时，该文件都会重新加载，因此你可以在会话中途编辑它。在同一次更新之前，Pi 为该配置文件列出的通信协议恰好有四种：openai-completions、openai-responses、anthropic-messages 和 google-generative-ai。更新后的模型页面没有列出任何协议——它在一个示例中显示 openai-completions，并将该情况描述为“OpenAI、Anthropic 或 Google 兼容端点”——而 Pi v0.99.2 的源码将该字段的类型定义为不受枚举限制的字符串，并将其分派给十种内置实现中匹配的一种，即上述四种加上 mistral-conversations、azure-openai-responses、openai-codex-responses、bedrock-converse-stream、google-vertex 和 pi-messages。只有前四种曾在文档中被说明可用于自定义供应商，其他六种此处均未测试。Kunavo 支持四种中的前三种；它没有 Google Generative AI 路由，因此第四种类型没有对应的 Kunavo 路由。

以下配置根据Pi 的模型文档和 Kunavo 文档中列出的端点编写；对于 Pi 在 2026 年 9 月 22 日文档更新中删除的细节，则参考 Pi v0.99.2 的源码。此处未针对 Kunavo 运行该配置。Kunavo 的 Pi 集成指南是该客户端的已发布配置参考；它使用 OpenAI 兼容路由，没有将此 anthropic-messages 路由放入供你粘贴使用的代码块中，并且也未进行运行时测试。请将下面的代码块视为需要验证的起点，保留你当前可用的路由，并准备根据情况进行调整。

{
  "providers": {
    "kunavo": {
      "baseUrl": "https://api.kunavo.com",
      "api": "anthropic-messages",
      "apiKey": "$KUNAVO_API_KEY",
      "models": [
        {
          "id": "claude-sonnet-5",
          "name": "Claude Sonnet 5",
          "reasoning": true,
          "input": [
            "text",
            "image"
          ],
          "cost": {
            "input": 1.4,
            "output": 7,
            "cacheRead": 0.14,
            "cacheWrite": 1.75
          }
        }
      ]
    }
  }
}

关于该代码块，有四点说明，每一点都是实际容易踩坑的地方：

1. 基础 URL 是 origin，不包含 /v1。Anthropic 风格的客户端会自行追加 /v1/messages，因此 https://api.kunavo.com/v1 会生成指向 /v1/v1/messages 的请求并返回 404——请参阅基础 URL 页面。Pi 自己的文档从未解决这一点：在 2026 年 9 月 22 日文档更新之前，一个 anthropic-messages 示例使用仅含 origin 的 https://proxy.example.com，另一个使用 https://proxy.example.com/v1；更新删除了两者，但没有解决问题。如果第一次调用返回 404，应修改这一行。OpenAI 兼容供应商采用相反的约定，即使用 https://api.kunavo.com/v1，并将 api 设为 openai-completions。
2. cost 块在实际使用中并非可选。Pi 的源码（v0.99.2）将其默认值设为全零——更新后的文档不再说明这一点——因此你自行添加的供应商会在页脚和 /session 中报告 $0，直到你输入费率。内置供应商和 Radius 会从目录中获取费率；你的供应商不会。上面的数字来自当前 Kunavo 目录，缓存读取费率来自缓存表，Claude 缓存写入按输入费率的 1.25 倍计算。
3. 设置上下文和输出限制。同一份源码会将自定义模型默认设置为 128,000 token 的上下文窗口和最多 16,384 个输出 token。添加与所选模型匹配的 contextWindow 和 maxTokens，否则 Pi 会根据端点从未施加过的限制管理对话。
4. 一开始请保持 Anthropic 兼容性标志的默认设置。现在这些默认值位于 Pi 的源码（v0.99.2）中，而不在文档中，并且它们并非全部指向同一方向。supportsEagerToolInputStreaming 和 supportsLongCacheRetention 默认值为 true——Pi 会为每个工具发送 eager_input_streaming，除非后端拒绝该字段而你将第一个设置为 false——而 supportsStrictTools、allowEmptySignature 和 supportsMidConvoEffort 默认值为 false。在 2026 年 9 月 22 日文档更新之前，Pi 警告称，最后一个标志只能用于忠实的 Anthropic Messages 传输，而不能用于仅仅模仿该结构的 API；更新后的模型页面将其替换为适用于所有标志的一条规则：“兼容性设置‘应描述端点请求或响应行为中经过验证的差异。不要仅因为端点声明兼容 OpenAI 或 Anthropic 就启用它们。’”这里未测试 Kunavo 接受其中哪些标志，因此上面的代码块没有设置任何标志。

还有一个值得了解的机制：apiKey 接受 $ENV_VAR、以 stdout 输出作为值的 !shell-command，或字面值。加载该文件不要求提供此项；自 2026 年 9 月 22 日文档更新以来，Pi 的模型页面公布了凭据解析顺序：“首先使用运行时 --api-key，然后是存储的 auth.json 凭据、来自 models.json 的 apiKey，最后是供应商的环境变量或环境中的云凭据。”在 Pi 能够解析某个凭据之前，同一页面称，自定义模型会从 models.json 加载，但“在 /model 中仍不可用”。

如果你更愿意遵循已发布的设置页面，而不是调整此代码块，请从Pi 集成指南开始；如果你仍在选择客户端，Pi 与 OpenCode会比较这两个代理，而集成索引会列出每个带有 Kunavo 设置指南的客户端。准备为真实任务定价时，创建 Kunavo 账户，并针对你入选的模型运行一次有明确边界的修改。

常见问题

Pi、Radius 和 Anthropic 文档已于 2026 年 9 月 18 日核查，并于 9 月 21 日复核。Pi 在 2026 年 9 月 22 日刷新文档后，其凭据顺序和 anthropic-messages 基础 URL 示例已于 2026 年 10 月 1 日在其模型页面重新核查，源代码 v0.99.2 中的自定义模型默认值也已核查。同日，额外用量说明已根据 Pi 的设置页面和源代码 v0.99.2 中的终端警告重新核查；还核查了其提供商页面中的 /login 路由列表和端点变量、模型页面中的 api 列表和兼容性标志指南（包括源代码中的 api 分发逻辑和标志默认值），以及本站自己的集成索引。本页中的 Kunavo 费率和所有总额均由实时目录渲染，仅为示例性 token 算术，并非实测任务成本。尚未执行 Pi 到 Kunavo 的运行时测试。