Pi coding agent 與 Claude Code：工作流程、權限和總成本

Pi 和 Claude Code 都是可指向你選擇之端點的終端機 coding agent，但它們不是同一類產品。Pi 是採 MIT 授權的軟體，將大部分代理程式腳手架留給擴充功能；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 而非模型強制執行」，且允許、詢問和拒絕規則可以提交至版本控制，或在受管理的設定中設定。Pi 的 安全性頁面（於 2026 年 9 月 22 日文件更新時重寫）則以明確措辭表示相反內容：「Pi 可以使用啟動該程序之帳戶的權限讀取、變更和執行檔案，而且不會在每次工具呼叫前要求核准」，並將「缺少內建沙箱」列為通常位於其安全邊界之外的行為。其 使用方式頁面 也用一句話表達相同內容：「Pi 不會在每次工具呼叫前詢問。」
• 你是否需要在同一個用戶端中執行來自多個實驗室的模型？ 那麼選 Pi。在文件上次列出值、即 2026 年 9 月 22 日更新前，其 自訂提供者結構描述 支援 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 授權，可自由 fork，也能透過 --mode rpc 由其他程序驅動。Claude Code 的授權保留所有權利。
• 需要桌面應用程式、網頁介面或 Remote Control 嗎？那就選 Claude Code，但不能透過你自己的端點。其概覽寫著：「大多數介面需要 Claude 訂閱或 Anthropic Console 帳戶。Terminal CLI、VS Code 和 JetBrains 也支援第三方供應商」，桌面分頁則補充說需要付費訂閱。Remote Control 是另一種情況：Anthropic 的環境變數參考指出：「截至 v2.1.196，當此項目指向 api.anthropic.com 以外的主機時，Remote Control 會停用。」

這些內容都無法判定哪一個能寫出更好的程式碼。本頁未對兩者進行受控比較，以下內容也不應被解讀為受控比較。

並列比較

資料列取自 Pi 的快速入門、使用方式和安全性頁面，以及 Claude Code 的概覽、權限和費用文件，日期為 2026 年 9 月 19 日；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 hook 無法覆寫拒絕規則——因此無論提示或 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 使用量估算」，因此 /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」並非來自該頁面；而且定價頁面與企業部署概覽的 Premium 席位數字確實不同，後者顯示「Teams：$150/席位（Premium），可使用 PAYG」。本文不解決其中任何一項——請確認結帳時實際向你報出的數字。本次檢查找到的 Anthropic 頁面都沒有公布 Pro、Max 5 倍或 Max 20 倍的使用時數、訊息數或 token 數，因此本頁也不列出任何使用量數字。

Token 的成本

讓兩個用戶端指向同一端點，它們每個 token 支付相同費率；兩者的差異在於每個步驟重新傳送多少 context，這取決於你的儲存庫，遠比取決於工具本身，而且本頁未進行測量。

下表是示意性的 token 算術，不是測得的工作成本，也不是帳單上限。假設代理程式使用一個工作日：12 次回合，每次傳送 60,000 個未快取輸入 token，並接收 3,000 個輸出 token，總計 720,000 個輸入 token 和 36,000 個輸出 token，不含快取讀取、快取寫入、圖片和工具費用。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，而登入文章中的許可是裁量性的，不是保證。三者一致的唯一部分是發展方向：API 憑證是 Anthropic 偏好的第三方用戶端路徑；在 Claude Code 中，閘道憑證會完全將訂閱移出工作階段。在透過方案路由付費工作前，請先在自己的帳戶中檢查「設定」再到「使用量」。Claude 方案限制涵蓋訂閱部分，而Pi 定價進一步說明 Pi 的四種付款方式。

兩者之間切換實際會產生的成本

在一個方向上，低於功能清單所暗示的程度。儲存庫 context 會原樣轉移：Pi 會從目前目錄和父目錄載入 AGENTS.md 或 CLAUDE.md，並使用 ~/.pi/agent/AGENTS.md 載入全域指示，因此已為 Claude Code 設定好的儲存庫不需修改，Pi 就能讀取。腳本化使用在兩邊也都有對應方式——claude -p 和 pi -p，而 Pi 另提供 --mode json 和 --mode rpc 以整合程序。

無法轉移的是執行模型區段的大部分內容：權限規則、子代理定義和規劃模式在 Pi 中沒有可供遷移的內建對應功能——儲存庫僅以範例擴充功能提供它們——而桌面和網頁介面完全沒有這些功能。自 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 進行執行階段測試，也未進行兩者之間的品質、速度或基準比較。