Pi 编程代理与 Claude Code：工作流、权限和总成本

Pi 和 Claude Code 都是可以指向您选择的端点的终端编码代理，但它们不是同一种产品。Pi 是采用 MIT 许可证的软件，将大部分 agent 支架交给扩展；Claude Code 是专有软件，围绕强制执行的权限系统和 Anthropic Messages 协议构建。 这两个事实比任何功能列表都更能决定比较结果，因为其中一个旨在运行您的端点所提供的任意模型，而 Anthropic 将另一个记录为不支持这种用法。

首先澄清一个名称冲突。这里的“Pi”是 Earendil Inc. 在 pi.dev 发布的编码代理——不是 Inflection AI 在 pi.ai 发布的 Pi，不是 Pi Network 代币，也不是 Raspberry Pi。其 CLI 是 @earendil-works/pi-coding-agent，采用 MIT 许可证；最新版本为 0.86.1，于 2026 年 9 月 20 日在 npm 注册表 发布；其仓库 earendil-works/pi 采用 MIT 许可证、未归档，并于 2026 年 9 月 21 日最后一次推送（GitHub API）。Claude Code 从 @anthropic-ai/claude-code 安装，最新版本为 2.1.278，于 2026 年 9 月 19 日发布；其 LICENSE.md 全文写道：“© Anthropic PBC。保留所有权利。使用须遵守 Anthropic 的商业服务条款”。两个客户端都频繁发布，因此请将这些视为 2026 年 9 月 21 日的数字，而非当前数字；下面的文档检查日期为 2026 年 9 月 19 日。

应该选哪一个

按顺序回答这些问题。第一个能给出明确答案的问题就是决策依据。

• 您是否需要他人可以依赖的权限规则？ 那么选择 Claude Code。其 权限文档定义了六种模式——default（标记为 Manual）、acceptEdits、plan、auto、dontAsk 和 bypassPermissions——并说明“权限规则由 Claude Code 而不是模型强制执行”，其中 allow、ask 和 deny 规则可以提交到版本控制，或在托管设置中配置。Pi 的 安全页面在 2026 年 9 月 22 日文档更新中重写后，用直白的措辞说明了相反情况：“Pi 可以使用启动它的账户权限读取、更改和执行文件，并且不会在每次工具调用前请求批准”，并将“缺少内置沙箱”列为通常不属于其安全边界的行为。其 使用页面也用一句话表达了相同内容：“Pi 不会在每次工具调用前请求批准。”
• 您是否需要在一个客户端中运行来自多个实验室的模型？ 那么选择 Pi。在 2026 年 9 月 22 日更新之前、文档最后一次列出取值时，其 自定义 provider schema支持 openai-completions、openai-responses、anthropic-messages 和 google-generative-ai，而其 v0.99.2 源码会分派十种形态。Anthropic 的 网关页面称其“不支持通过任何网关将 Claude Code 路由到非 Claude 模型”。
• 你是否需要子代理、计划模式和待办事项，却不想自己构建这些功能？那就选 Claude Code。在其 2026 年 9 月 22 日文档刷新之前，Pi 的使用页面写道：“它有意不包含内置 MCP、子代理、权限弹窗、计划模式、待办事项或后台 bash”；刷新后删除了这句话，MCP 也不再属于该列表——自 v0.99.0 起，Pi 的 MCP 页面称其“通过 stdio 或可流式传输的 HTTP 连接到 Model Context Protocol 服务器，并使其工具和资源可供模型使用”。截至 v0.99.2，子代理、计划模式和待办事项仍未内置；仓库仅将它们作为示例扩展提供。
• 代理本身需要开源吗？那就选 Pi：它在 npm 和仓库中均采用 MIT 许可，可派生，并可通过 --mode rpc 由另一进程驱动。Claude Code 的许可证保留所有权利。
• 你是否需要桌面应用、Web 界面或 Remote Control？那就选 Claude Code，但不能通过你自己的端点使用。其 概览写道：“大多数界面需要 Claude 订阅或 Anthropic Console 账户。Terminal CLI、VS Code 和 JetBrains 也支持第三方提供商”，桌面标签页还补充说需要付费订阅。Remote Control 是另一种情况：Anthropic 的 环境变量参考指出：“截至 v2.1.196，当该变量指向 api.anthropic.com 以外的主机时，Remote Control 会被禁用。”

这些内容都无法决定哪一个能写出更好的代码。本页面没有对二者进行受控比较，以下内容也不应被解读为此类比较。

并排比较

表格内容于 2026 年 9 月 19 日从 Pi 的快速入门、使用和安全页面，以及 Claude Code 的概览、权限和 费用文档中读取；Pi 的权限和 MCP 行于 2026 年 10 月 1 日根据 Pi v0.99.2 重新核对。

执行模型才是真正的差异

Pi 的省略列表过去更像一份规格说明，而不是缺失功能：在 2026 年 9 月 22 日文档刷新之前，其使用页面列出了大多数买家认为每个代理都应具备的六项功能——内置 MCP、子代理、权限弹窗、计划模式、待办事项和后台 bash——并表示它是有意不提供这些功能。刷新后删除了这句话，一周后发布的 v0.99.0 实现了其中一项：MCP 现在是默认加载的内置扩展，可通过 pi mcp add 或 mcp.json 文件配置。其余列表仍适用于 v0.99.2。如果你的工作流依赖编辑前的规划步骤，或依赖可以拒绝的权限提示，Pi 要求你构建或安装这些功能，而不是进行配置。

Claude Code 位于另一端。规则由客户端评估，拒绝优先，并且 PreToolUse 钩子无法覆盖拒绝规则——因此无论提示词或 CLAUDE.md 如何设置，这些规则都能继续生效，这正是它们对组织而非单个开发者有用的原因。Pi 最接近的概念是项目信任，但按其自身描述范围更窄：“项目信任控制 Pi 是否加载工作文件夹提供的大多数设置和资源。它会阻止文件夹在你批准之前静默加载可执行扩展。”同一页面明确说明了限制：“项目信任不会限制工具调用可以访问或影响的内容。”

两种立场都没有错，但只有一种能回答审计问题。在比较价格之前先确定这一点：配置无法弥合这一差距。

让每个客户端指向你自己的端点

这是第二个结构性差异，而且方向相反。Claude Code 接受一个环境变量和一类协议；Pi 接受一个 JSON 文件以及截至 2026 年 9 月 22 日文档所记录的四种协议——其源代码接受的协议更多。

Claude Code 列的内容来自其 环境变量参考和 网关兼容性指南，于 2026 年 9 月 19 日核对。“关闭”一行值得详细说明，因为每一项都是你会悄然失去的功能，而不是会看到的错误。非第一方 ANTHROPIC_BASE_URL 默认会禁用 MCP 工具搜索；如果代理转发 tool_reference 块，则可通过 ENABLE_TOOL_SEARCH=true 重新启用；截至 v2.1.196，当该变量指向 api.anthropic.com 以外的任何位置时，Remote Control 会被禁用；细粒度工具流式传输默认关闭；模型发现需要选择加入，CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 会发送 GET /v1/models?limit=1000，将请求超时时间设为三秒，将任何重定向视为失败，并仅保留 ID 包含 claude 或 anthropic 的条目。两项检查完全绕过该变量，直接调用 api.anthropic.com——快速模式可用性检查和 WebFetch 域安全检查——因此，即使推理正常，阻止该主机的网络也会使它们失效。

凭据这一行关系到计费，而不仅仅是身份验证。Anthropic 的网关页面明确说明：网关凭据处于活动状态时，“该凭据会在该会话中替代订阅登录，订阅的用量限制不适用”，相关流量按 token 向凭据所有者计费。仅设置基础 URL 不会产生这种效果——已保存的 claude.ai 登录仍是活动凭据，其限制仍然适用。

# Claude Code: two environment variables, and whatever answers at that
# origin has to speak the Anthropic Messages API.
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # origin only, no /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...              # replaces the subscription

# Pin models Kunavo serves: Claude Code's default and its opus alias are the
# newest Opus, and if Kunavo does not serve it yet, the first request 404s.
# The sonnet alias asks for Sonnet 5.5, which Kunavo does not serve: unpinned,
# /model sonnet, opusplan's execution phase and sonnet subagents all 404.
# Opus 5.5 needs Claude Code v2.1.280 or later (run `claude update`).
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

源地址没有 /v1：Anthropic 风格的客户端会自行附加 /v1/messages，因此 https://api.kunavo.com/v1 会生成指向 /v1/v1/messages 的请求并返回 404。请参阅 基础 URL 页面和 Claude Code 设置指南。还有一个 Kunavo 特有的后果：此 API 不提供 /v1/messages/count_tokens 路由，而 Claude Code 的兼容性指南称 token 计数端点是唯一可选端点——没有它，“Claude Code 会回退到基于字符的上下文用量估算”，因此 /context 显示的是近似计数。

Pi 对同一问题的解决方式是一个文件，而且由于它接受 OpenAI 形状的 API，因此可以采用 Claude Code 没有的路径：

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

注意末尾的 /v1。openai-completions 提供商需要 https://api.kunavo.com/v1。对于 anthropic-messages 形状，Pi 的文档从未解决这个问题：截至 2026 年 9 月 22 日文档刷新之前，Pi 的 模型文档在自己的示例中展示了两种拼写——自定义标头下使用 https://proxy.example.com/v1，Anthropic Messages 兼容性下使用不带路径的 https://proxy.example.com；刷新后删除了两者但仍未解决，因此如果首次调用返回 404，这就是需要修改的行。还有两个 Pi 特有的陷阱，Pi 的源代码（v0.99.2）仍会设置它们，尽管刷新后的文档不再明确说明：自定义模型的 cost 块在所有费率类别中默认均为零，因此你添加的提供商会在页脚显示 $0，Pi 将其说明为显示会话费用，直到你输入费率；此外，contextWindow 和 maxTokens 会静默默认为 128,000 和 16,384，因此应将二者设置为模型 目录页面公布的窗口。凭据优先级已有文档说明，旧密钥获胜时尤其值得了解：自刷新以来，Pi 的模型页面称其使用“首先是运行时 --api-key，然后是已存储的 auth.json 凭据、来自 models.json 的 apiKey，最后是提供商的环境变量或环境中的云凭据”。

同一页面上的计划与 token 账单

两个客户端本身都不收费，因此成本的全部差异在于你购买哪一层。Pi 根本没有需要购买的东西：它采用 MIT 许可，而且 pi.dev 不提供任何计划、层级、席位或托管服务。Claude Code 可以免费安装，但随后需要从某处获得访问权限。

所有 Anthropic 计划价格均引自 2026 年 9 月 19 日的 claude.com/pricing。有两个诚实的空白：Max 页面没有公布 20 倍层级的单独价格，因此你在其他地方看到的任何“Max 20 倍 $200”都不是该页面提供的；高级席位价格确实在价格页面与企业部署概览之间存在差异，后者显示“团队：$150/席位（高级），可使用 PAYG”。这里不解决任何一个问题——请以结账时实际报出的数字为准。此次检查找到的 Anthropic 页面没有为 Pro、Max 5 倍或 Max 20 倍公布小时数、消息数或 token 数量，因此本页面也不显示任何用量数字。

token 的成本

让两个客户端使用同一个端点，它们每个 token 支付的费率相同；二者的差异在于每一步重新发送多少上下文，这更取决于你的仓库，而不是工具，本页面也未对此进行测量。

下表是用于说明的 token 算术，不是经过测量的任务成本，也不是账单上限。假设代理使用一个工作日：12 轮，每轮发送 60,000 个未缓存输入 token 并接收 3,000 个输出 token，总计输入 720,000、输出 36,000，且没有缓存读取、缓存写入、图像或工具费用。Kunavo 费率取自实时目录；供应商列为 claude.com/pricing，于 2026 年 9 月 19 日核对。

阅读各行，而不是排名。Claude Sonnet 5 在两列中都是同一个数字，因此对于该模型，路径根本不是价格问题；Claude Opus 5 才是两列产生差异的地方。在把任何数字当作预算之前，按你自己的工作日进行缩放——并注意这里假设没有缓存，这是最大的单项遗漏。Anthropic 自己的费用页面指出，提示缓存的生命周期“订阅状态下为一小时，而一旦使用用量余额则降至五分钟；使用 API 密钥或云提供商时，默认是五分钟”，因此你的付费方式会改变缓存命中率，进而改变账单。Kunavo 的缓存费用记录在 缓存页面；尚未测试 Pi 的 PI_CACHE_RETENTION=long 是否能到达此端点。

如果需要一个已发布的基准而不是算术，Anthropic 的费用文档报告称：“在企业部署中，平均成本约为每位开发者每个活跃日 $13、每位开发者每月 $150-250；对于 90% 的用户，每个活跃日的成本低于 $30”，后台进程通常低于每次会话 $0.04。这是 Anthropic 对按自身账单计费的 Claude Code 给出的数字；Pi 没有等价数字，因为没有人公布。Kunavo 目录金额是计费下限而不是上限——上游报告费用时，账单取目录成本与上游成本乘以适用加价之间的较大值，正如计费页面所说明——而最低充值是预付余额 $10，这是资金最低限额，不是任务费用或订阅费。

没人能替你解决的订阅问题

两个客户端都可以使用 Claude 计划登录，三个官方来源对这种登录的具体作用给出了不同描述。这里按日期引用它们，而不作定论，因为从外部解决会变成猜测。

Anthropic 的任何页面都没有明确提到 Pi，登录文章授予的权限也是酌情决定，而非保证。三个来源一致的部分是发展方向：对于第三方客户端，Anthropic 更倾向于使用 API 凭据；在 Claude Code 中，网关凭据会将订阅完全移出该会话。在通过计划处理付费工作之前，请先在自己的账户中检查“设置”然后是“用量”。Claude 计划限制介绍订阅方面，Pi 价格进一步介绍 Pi 的四种付费方式。

在二者之间迁移实际需要付出什么

在一个方向上，比功能列表暗示的少。仓库上下文原样迁移：Pi 会从当前目录和父目录加载 AGENTS.md 或 CLAUDE.md，并使用 ~/.pi/agent/AGENTS.md 加载全局说明，因此已为 Claude Code 设置好的仓库无需修改即可被 Pi 读取。两边也都有脚本化使用的对应方式——claude -p 和 pi -p，Pi 还增加了 --mode json 和 --mode rpc 以进行进程集成。

无法迁移的是执行模型部分的大多数内容：权限规则、子代理定义和计划模式在 Pi 中没有可迁移到的内置对应功能——仓库仅将它们作为示例扩展提供——而桌面和 Web 界面完全没有这些功能。自 v0.99.0 起，MCP 服务器是例外：对于 Claude Code 条目，Pi 的 MCP 页面写道：“复制现有的 mcpServers 条目。”反向迁移时，Pi 扩展没有可安装的 Claude Code 对应项。这里不提供迁移所需的小时数或天数估计，因为没有依据——在迁移计划任务之前，分别在两者上运行一个范围明确的真实任务。

如果你正在更广泛地筛选，Pi 与 OpenCode 对比和 OpenCode 与 Claude Code 对比涵盖相邻的两组比较，而Claude Code 替代方案会先将工具问题与计费问题分开。至于端点本身，Claude Code 设置指南是已发布的配置参考，创建 Kunavo 账户可获取密钥，以便针对一个任务进行测试。

常见问题

文档和计划价格于 2026 年 9 月 19 日核对，并于 2026 年 9 月 21 日再次确认：pi.dev 的快速入门、用量、模型、提供商和安全页面；code.claude.com 的概览、权限、费用、环境变量、网关和网关兼容性页面；claude.com/pricing；以及 support.claude.com 上的两篇文章。版本号、anthropics/claude-code 许可证文件和 earendil-works/pi 的 GitHub API 于 2026 年 9 月 21 日重新获取。Pi 于 2026 年 9 月 22 日完成文档刷新后，其模型页面上的凭据顺序和 anthropic-messages 基础 URL 示例于 2026 年 10 月 1 日重新核对，并核对了其 v0.99.2 源代码中的自定义模型默认值。同日，在 Pi v0.99.0 发布内置 MCP 后，重新阅读了其安全、用量、MCP、设置页面和文档概览，以核实沙箱、权限、项目信任和省略功能的说法；根据 v0.99.2 源代码核对 api 列表，并根据该源代码中的终端警告核对额外用量一行。Kunavo token 费率取自实时目录，此处每个美元数字都是用于说明的 token 算术，而非经过测量的任务成本。两个客户端均未针对 Kunavo 进行运行时测试，也未对二者进行质量、速度或基准比较。