Pi coding agent 定價：軟體免費，但 token 並非免費

Pi coding agent 的安裝費用為零：它是採 MIT 授權的軟體，沒有方案費，也沒有席次價格。你在 Pi 上花費的每一美元都是模型 token，而這些 token 透過四種路徑取得。 這些路徑包括 Earendil 自有的 Radius gateway、透過 /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 發布的終端機 coding agent。它不是 Inflection AI 的 Pi（pi.ai）、不是 Pi Network 的代幣、不是 Raspberry Pi，也不是由其他作者開發的另一個採 MIT 授權 coding agent——Oh My Pi。上述產品的價格均不適用於此處。

Pi coding agent 定價：各層的計費方式

查核日期為 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 scope 遷移至 earendil-works/pi 與 @earendil-works；0.74.0 是新 scope 下的第一個版本，0.73.1 是舊名稱下的最後一個版本，而舊套件已標示為 deprecated，但未從 npm 撤下。第三方教學與答案引擎仍會提供已失效的安裝指令。目前應使用 npm install -g --ignore-scripts @earendil-works/pi-coding-agent；在 2026 年 9 月 21 日查核 registry 時，最新版本為 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 費率計費，並可在網頁應用程式的 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 日禁止第三方 agent 工具使用 Claude 訂閱計費，之後恢復該路徑，改以按 API 費率計費的獨立每月 Agent SDK 額度池支援；該額度不會結轉，用完後也不能回退使用一般訂閱額度。Anthropic 自身的 Agent SDK 文章取代了該報導：它宣布 2026 年 6 月 15 日提供每月 Agent SDK 額度，接著在同日開頭加入更新，暫停該變更——該額度無法使用，Agent SDK、claude -p 與第三方應用程式用量仍計入方案使用上限。請將 VentureBeat 所述機制視為歷史，而非目前條款；在以此方式導入付費工作前，先檢查你自己帳戶中的 Settings > Usage。

Kunavo 相同模型旁的 Radius 費率

Radius 是此處唯一由 Earendil 自行定價的路徑。其模型表公布每百萬 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。因此，較長的 agent 對話會一次重新定價，而不是逐步增加。

以算術方式示範一個月

假設一個月使用一個模型，輸入 token 6,000,000 個且未快取，輸出 token 600,000 個，不包含快取讀取、快取寫入、影像或工具費用。這大致代表在儲存庫上持續每日進行 agent 工作的樣貌，不是經實測的任務。

這些是在上述假設下的示意性 token 估算，不是實測任務成本，也不是帳單上限。Radius 欄位另未包含儲值時未公布的付款處理商費用。請逐列閱讀兩欄，而不要把它們視為結論：若兩者落在同一數字，選擇因素就不在價格；若兩者不同，差距正說明你應針對預計執行的特定模型計價，而不是先選一條路徑、再假定其他條件都相同。

同一份估算中還有兩項 Kunavo 方面的注意事項。目錄金額是計費下限，而不是上限：當上游回報其費用時，帳單會取目錄成本與上游成本乘以適用加成兩者中的較高者，詳見計費指南。此外，最低儲值額為$10 預付額度，這是開立有資金帳戶所需的現金，不是任務費或訂閱費。快取費用另行計算，並記載於快取文件。

列出的最低費率不等於完成工作的最低成本

這是兩個不同的說法，把它們混為一談正是便宜路徑變昂貴的原因。每百萬 token 價格只有三分之一的小型模型，如果需要三次嘗試才能完成較強模型一次就能完成的變更，整體費用仍會更高。請先按路徑決定，再按模型決定：

• 想使用 Pi 內建的路徑時選 Radius：透過 /login 的 OAuth、公布的費率表，以及 Pi 已知如何顯示的成本中繼資料。其 FAQ表示企業客戶可使用 BYOK。
• 想使用供應商自有功能、支援與條款，且只需要一個模型系列時，選供應商直接提供的金鑰。
• 只有在讀完上文後才選既有訂閱。它是按 token 計費的額外用量之前提，而不是 Pi 的套裝額度。
• 當你選定模型的每 token 費率是決定因素，且願意手動設定自訂供應商時，選 Kunavo 等相容 gateway。
• 當硬體已經屬於你，且模型確實能處理你的工具工作流程時，選本機推論。Pi 將 Ollama、vLLM 與 LM Studio 記載為自訂供應商。

接著進行測量。Pi 的使用量文件說明 TUI 頁尾會顯示 token／快取用量、成本、內容使用量與目前模型，而 /session 會列印工作階段檔案、ID、訊息、token 與成本——前提是已設定成本，這正是下一節的關鍵。請先在兩個候選方案上執行相同且有界限的任務，再遷移排程工作。

將 Pi 指向你自己的端點

Pi 未記載通用的基礎 URL 環境變數。在其文件所列變數中沒有 ANTHROPIC_BASE_URL 或 OPENAI_BASE_URL——自 2026 年 9 月 22 日文件更新後，唯一的端點項目是供應商頁面上的 AZURE_OPENAI_BASE_URL；更新也移除了文件先前所示、可用於 Bedrock 代理的標準 AWS SDK 變數 AWS_ENDPOINT_URL_BEDROCK_RUNTIME——因此自訂端點應寫入 ~/.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. base URL 是 origin，不包含 /v1。Anthropic 風格的用戶端會自行附加 /v1/messages，因此 https://api.kunavo.com/v1 會產生對 /v1/v1/messages 的請求並回傳 404——請參閱base-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、以其標準輸出作為值的 !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 的費率與本頁的所有總額均由即時目錄呈現，且只是示意性的詞元用量計算，不是實測工作成本。未執行 Pi 到 Kunavo 的執行階段測試。