返回指南
程式設計代理程式·2026年9月21日·更新於 2026年10月1日·閱讀約 9 分鐘

Pi 程式碼代理替代方案:根據退出原因和遷移成本選擇

Pi 在本頁查核當天發布了一個版本,因此你要離開的是一組有意採取的設計選擇,而非一個日漸衰亡的專案——切換成本則集中在一個目錄:~/.pi/agent。

最後審核於 。

您不必因生命週期因素離開 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 的終端機 coding agent,repo 為 earendil-works/pi,npm 為 @earendil-works/pi-coding-agent。它不是 Inflection AI 在 pi.ai 的 Pi(完全不同的產品);不是 Pi Network 的代幣;不是 Raspberry Pi;也不是數學常數。舊的 shittycodingagent.ai 網域現在會重新導向至 pi.dev,而 badlogic/pi-mono 會解析至目前的 repo,因此舊連結會正確抵達目的地,但不會告訴您它們已經搬遷。

將離開的理由對應至目的地

以下每一列都是 Pi 自身文件中出現過的理由,代表刻意省略的功能或邊界,並配對一個有記錄該功能的專案。本文沒有任何內容經過執行時測試。

您希望 Pi 提供的功能對應的目的地您需要改為承擔的內容
將子代理程式、核准彈出視窗、規劃模式、待辦事項和背景 bash 作為內建功能,而非擴充功能——MCP 自 v0.99.0 起已內建於 PiOh My Pi,Pi 的 fork不同的維護者和版本序列、位於 ~/.omp/agent/models.yml 的 YAML 設定,以及需要學習的自有核准模型
針對自託管或非標準端點,提供超出 Pi 所列四種協定的已記錄 wire protocol 集合Oh My Pi——已記錄十一個 api 值;截至 2026 年 9 月 22 日 Pi 記錄了四個,現在則一個都未列出,但其原始碼(v0.99.2)會派送十個相同的 fork 注意事項;十一個值中有兩個是判斷 API,而不是聊天傳輸;Pi 未記錄的六個值在此未經測試
改用託管環境執行代理程式,而不是使用自己的 shellOpenHands免費 SaaS Individual 方案將「Max Daily Conversations」上限設為 10;自行執行的 MIT 版本則列為 Unlimited
在您已使用的編輯器內執行代理程式Cline編輯器擴充功能的工作流程,而非終端機工作流程;其 ClinePass 訂閱文件標示為「完全選用」,同一頁也表示您可以同時使用任何其他供應商
其供應商不稱為 early alpha 的第一方 gateway,正如 Earendil 對 Radius 的描述OpenCode(Zen)或 Crush(Hyper)第二個帳戶。OpenCode 稱 Zen「完全選用」;Charm 稱 Hyper「官方 Crush 供應商」,並未使用該詞。兩個用戶端都記錄了可為其他供應商提供自有金鑰的方式
基金會治理,而非單一公司的管理goose,採用 Apache-2.0,現在隸屬於 Linux Foundation 的 Agentic AI Foundation通往相同端點的兩種不同路徑可供選擇:將內建 OpenAI 供應商指向搭配 OPENAI_HOST 的自訂基礎 URL,或建立自訂供應商項目;其文件將後者描述為適用於「尚未支援的」服務
單一供應商自有的代理程式,從頭到尾皆由該供應商提供Claude Code,或 Codex CLICodex CLI 在自訂端點方面嚴格比 Pi 更受限——請參閱常見問題。GitHub API 未回報 Claude Code repository 的 SPDX 授權。

在選擇前,值得先說明兩項邊界。Pi 的安全性頁面在 2026 年 9 月 22 日文件更新中重寫後明確表示,Pi「可以使用啟動它的帳戶權限讀取、變更及執行檔案,而且不會在每次工具呼叫前要求核准」,並將「缺乏內建 sandbox」列為通常位於其安全性邊界之外的行為之一。其專案信任提示也不是缺少的權限系統:同一頁表示,信任「控制 Pi 是否載入工作資料夾提供的大多數設定和資源」,且「不限制工具呼叫可以存取或影響的內容」。如果隔離是您離開的理由,答案是使用具核准模式的用戶端或容器,而不是預設改用另一個終端機代理程式。

在決定採用某個名稱前先檢查狀態

Pi 的替代方案清單包含處於三種不同狀態的專案,而 GitHub 上有一個欄位會造成誤導。請閱讀發布日期和提交日期,不要看 pushed_at。

專案授權最新發行版2026 年 9 月 21 日的狀態
Pi(earendil-works/pi)MITv0.87.0,2026 年 9 月 21 日活躍;三天內發布三個版本
Oh My Pi(can1357/oh-my-pi)MITv18.2.8,2026 年 9 月 21 日運作中的分支;是獨立產品,不是 Pi 的拼寫
OpenCode(anomalyco/opencode)MITv1.18.31,2026 年 9 月 14 日運作中。sst/opencode會重新導向至此;opencode-ai/opencode已封存,且是不同的專案
Crush(charmbracelet/crush)FSL-1.1-MIT — GitHub 自身的欄位僅回報 NOASSERTIONv0.96.1,2026 年 9 月 21 日運作中。Functional Source License 並非 OSI 核准的開放原始碼授權;在假設它是開放原始碼授權前,請先閱讀 LICENSE.md
goose(aaif-goose/goose)Apache-2.0v1.51.0,2026 年 9 月 17 日運作中;block/goose會重新導向至此,文件已移至 goose-docs.ai
OpenHands(OpenHands/OpenHands)MITv1.20.0,2026 年 9 月 17 日運作中;All-Hands-AI/OpenHands會重新導向至此
Cline(cline/cline)Apache-2.0v4.1.19,2026 年 9 月 17 日(桌面版本使用自己的版本標籤系列發布)運作中:儲存庫未封存,於 2026 年 9 月 21 日推送
Codex CLI(openai/codex)Apache-2.0rust-v0.155.1,2026 年 9 月 18 日運作中;其文件已搬遷兩次,因此數個看似合理的文件 URL 會回傳 404
AiderApache-2.0v0.86.0,2025 年 8 月 9 日休眠中,但專案尚未終止:未封存,但自 2026 年 5 月 22 日起沒有提交
ContinueApache-2.0v2.0.0-vscode,2026 年 6 月 19 日(最新穩定版)不再發布。continue.dev 表示它「已加入 Cursor」,並指出開放原始碼程式碼庫「仍可免費取得」;最後一次程式碼提交為 2026 年 6 月 19 日。這是遷移來源,而非目的地

儲存庫事實取自 GitHub API 及各專案自身網站,時間為 2026 年 9 月 21 日。星數和推送時間戳記每天都會變動,因此刻意省略。Continue 是需要讀兩次的那一列:其 pushed_at 欄位因僅有文件提交而顯示近期日期,這正是它持續出現在目前推薦清單上的原因。Kunavo 自身的 Continue 替代方案 與 Aider 替代方案 頁面,分別涵蓋這兩個專案。

實際離開 ~/.pi/agent 時會帶走什麼

這是比較表略過的部分,也是實際切換成本所在。Pi 將所有內容保存在同一個目錄中,而其中七項內容的命運並不相同。

Pi 儲存的內容其中包含的內容移轉時會發生什麼
AGENTS.md / CLAUDE.md~/.pi/agent/AGENTS.md中的全域規則,加上上層目錄與目前目錄中的規則;AGENTS.override.md會針對該目錄取代它們會跟著移轉。OpenCode 的文件說明,專案根目錄中的 AGENTS.md 和 ~/.config/opencode/AGENTS.md 都會被讀取;若不存在 OpenCode 專用檔案,則退回使用 ~/.claude/CLAUDE.md。Oh My Pi 的文件則將 AGENTS.md 探索列為其工作區遍歷的一部分
models.json自訂提供者區塊:baseUrl、api、apiKey、headers、models、modelOverrides會重新輸入,但 Oh My Pi 除外。其文件表示,如果兩個 YAML 檔案都不存在,而 models.json「位於相同位置」,就會將其遷移至 models.yml——該位置是 ~/.omp/agent/,因此需要自行將檔案複製到那裡。Oh My Pi 文件說明首次執行時會繼承的目錄包括 .claude、.cursor、.windsurf、.gemini、.codex、.cline、.github/copilot 和 .vscode;其中不包括 ~/.pi
mcp.jsonMCP 伺服器定義,於 v0.99.0(2026 年 9 月 29 日)加入:使用者層級位於 ~/.pi/agent/mcp.json,每個專案位於 .pi/mcp.json,OAuth 權杖則獨立保存在 ~/.pi/agent/mcp-auth.json大多會跟著移轉。Pi 的 MCP 頁面表示「格式符合其他 MCP 用戶端」,其自身的轉換表會逐欄位對應 OpenCode 的 local 與 remote項目——這就是離開時需要反向套用的對應關係。Pi 專用欄位(例如 exposure)不會一併移轉,OAuth 權杖也不會移轉:請在目的地重新登入
auth.jsonPi 的 /login提供者所使用的 API 金鑰與 OAuth 權杖,自動重新整理不會移轉。每個用戶端都會自行建立。離開時同樣值得注意:Pi 文件所記載的解析順序(2026 年 9 月 22 日文件更新中如此說明)是執行階段的 --api-key,接著是 auth.json,再接著是 models.json 中的 apiKey,最後才是提供者的環境變數——因此這裡的舊權杖仍會在沒有提示的情況下優先於您剛設定的金鑰
sessions/每個工作階段各有一個 JSONL 檔案,依工作目錄整理成樹狀結構,其中每個項目都有 id 和 parentId不會移轉。Pi 文件記載兩種匯出方式——將 /export 匯出為 HTML,以及將 /share 匯出至私人 GitHub gist——另有 /bug 報告,可將目前分支打包為 session.jsonl。在此檢查的用戶端中,未找到這種格式的匯入器——這是缺乏證據,而不是文件明確禁止
trust.json依標準路徑鍵控的每個目錄專案信任決策,其中 defaultProjectTrust預設為 ask沒有可移轉的對應項目。它控管的是設定載入,而非工具呼叫,因此沒有任何內容可在目的地重現為權限政策
擴充功能、技能、提示範本、套件TypeScript 模組與工作流程資產,位於專案 .pi/目錄或全域的 ~/.pi/agent/中,使用與 Pi 本身相同的權限執行未找到文件記載的遷移路徑。這是離開時最大、且未量化的成本,正因為 Pi 對剩餘五個缺少的內建功能所採取的做法,是在此處自行建立。估算遷移成本前,先盤點實際依賴的內容

內容取自 Pi 的使用方式、安全性、模型、工作階段與 提供者頁面、OpenCode 的規則頁面及 Oh My Pi 的模型文件,全部於 2026 年 9 月 21 日讀取;auth.json列的解析順序於 2026 年 10 月 1 日重新從 Pi 更新後的模型頁面讀取,mcp.json列則於同日從其 MCP 頁面讀取。

進行移轉,同時保留回頭路

migrate-out-of-pi.sh
# 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區塊預設為全零,並同時設定 128,000-token 的 contextWindow 與 16,384 的 maxTokens——因此你正在離開的 Pi 成本讀數可能一直顯示 $0。目的地是否也有相同盲點,值得在將其數字視為預算前確認。Pi 定價包含完整的自訂提供者區塊及其注意事項;本頁刻意不重複這些內容。

如果你比較的是特定配對,而不是某個類別,Oh My Pi 與 Pi會詳細說明該分支,Pi 與 OpenCode及 Pi 與 Claude Code會正面比較這兩者,而 OpenCode 替代方案則從另一方進行相同的分析。

更換用戶端不會改變 token 帳單

這些用戶端本身都不收取費用,而且每個用戶端都可以使用你設定的任意模型路由——這就是上方表格中的 api、baseUrl 和金鑰欄位的用途。數家供應商也提供自有金鑰的第一方替代方案(Radius、Zen、Hyper、ClinePass、OpenHands provider),而 Claude Code 與 Codex CLI 另外還能使用其供應商自身的訂閱方案登入,因此以下數字僅描述自帶路由的情況。無論如何,離開的理由必須是功能,而不是價格:切換代理程式本身不會改變模型成本。

以下數字是示意性的 token 算術,不是實測的任務成本,也不是帳單上限。假設一個工作階段傳送 200,000 個未快取輸入 token 並接收 15,000 個輸出 token,不含快取讀取、快取寫入、圖像輸入及工具費用。費率取自即時的 Kunavo 目錄,以每百萬 token 計算。

模型每 1M 的輸入/輸出一次假設工作階段的估算
Claude Haiku 4.5$0.70 / $3.50$0.192
GPT-5.6 Terra$0.70 / $4.20$0.203
Claude Sonnet 5$1.40 / $7.00$0.385
Claude Opus 5$3.50 / $17.50$0.963

在將其中任何數字視為預算前,請依你每天的工作階段數量進行換算,並分開看待這兩項主張:列出的最低費率,與完成任務的最低成本,是不同的事情,因為需要嘗試三次的小型模型,成本可能高於一次就完成變更的更強模型。Kunavo 目錄金額是計費底線,而非上限——上游回報費用時,帳單金額取目錄成本與上游成本乘以適用加成兩者中較高者,計費頁面有說明。預付額度的最低加值是 $10 ,這是資金存入最低額,而不是任務費或訂閱費。

如果你比較的是內建程式碼庫索引功能的代理程式,有一項能力差距需要事先規劃:Kunavo 不提供 embeddings。它不提供任何 embedding 模型,也不提供文字轉語音或語音轉文字模型,因此需要 embedding endpoint 的索引步驟必須交由其他提供者處理。

Kunavo 在本頁為 Pi 及數個目的地提供設定參考。已發布的設定指南不等於相容性測試:這些用戶端都未針對 Kunavo endpoint 進行執行階段測試,上述每項協定主張也都是從各專案文件讀取,而非實際執行驗證。如果分支是你的目的地,請從 Pi 整合指南或 Oh My Pi 整合指南開始測試,測試期間保留可運作的路由,準備好針對選定模型為一項界定範圍的任務估算價格時,再建立 Kunavo 帳戶。

常見問題

最佳的 Pi coding agent 替代方案是什麼?

沒有唯一的勝者,因為真正該問的是 Pi 缺少的哪些功能是您需要的。在 2026 年 9 月 22 日文件更新前,Pi 自己的設計原則章節表示,它刻意不內建 MCP、子代理程式、權限彈出視窗、規劃模式、待辦事項或背景 bash,並告訴您可將這些功能以擴充功能或套件加入。更新後該句已移除,而 2026 年 9 月 29 日發布的 v0.99.0 已將 MCP 作為內建擴充功能提供;截至 v0.99.2,其餘五項仍未內建。如果您希望這些功能原本就已內建,Oh My Pi 是最接近的選擇,因為它是 Pi 的分支版本,且文件正好說明這些功能。如果您想要託管環境來執行代理程式,OpenHands Cloud 提供免費的 Individual 方案。如果您想讓代理程式位於編輯器內,則選擇 Cline。如果您想要第一方閘道,且其供應商不會將其描述為早期 alpha 階段——radius.earendil.com 表示「Radius 目前處於早期 alpha 階段」——OpenCode 提供 Zen,其文件稱其「完全選用」,而 Crush 提供 Hyper,Charm 稱其為「官方 Crush 供應商」,同時也記錄了十二個可貼入自有金鑰的其他供應商。所有狀態均於 2026 年 9 月 21 日檢查。

Pi coding agent 目前仍在維護嗎?

是,且維護活躍。2026 年 9 月 21 日,GitHub API 回報 earendil-works/pi 採用 MIT 授權、未封存,並於當日推送;版本 v0.87.0 也於 2026 年 9 月 21 日發布。因此,您不需要因生命週期因素離開 Pi。這對本次比較很重要,因為替代方案清單中出現的兩個名稱處於不同狀態:Continue 已被 Cursor 收購,最後一次程式碼提交為 2026 年 6 月 19 日;Aider 自 2026 年 5 月 22 日後沒有提交,且自 2025 年 8 月 9 日發布 v0.86.0 後沒有新版本。

Oh My Pi 只是 Pi 的另一個名稱嗎?

不是。Oh My Pi 是以 Pi 的分支版本建立的獨立產品,擁有不同的維護者、不同的版本序列和不同的設定格式。其 README 表示它是 @mariozechner 所開發的 Pi 的分支版本;其 LICENSE 列出 Mario Zechner、Can Bölük 和 Stencil Labs, Inc.;而它在 2026 年 9 月 21 日發布 v18.2.8,當時 Pi 的版本為 v0.87.0。Pi 將 ~/.pi/agent/models.json 讀取為 JSON;Oh My Pi 將 ~/.omp/agent/models.yml 讀取為 YAML。切勿混用兩者的設定範例或版本號。第三個陷阱是:npm 套件 @mariozechner/pi 完全不是較舊的 Pi 版本——套件登錄庫將其描述為用於管理 GPU pod 上 vLLM 部署的 CLI。Pi 的 npm 套件是 @earendil-works/pi-coding-agent;pi.dev 也提供 curl 和 PowerShell 安裝程式。

我可以將 Pi 設定移至另一個 coding agent 嗎?

部分可以,而且其分界比大多數移轉建議所承認的更明顯。專案規則可以移轉:Pi 會從 ~/.pi/agent、祖先目錄及目前目錄載入 AGENTS.md 或 CLAUDE.md;OpenCode 則記錄專案根目錄的 AGENTS.md,以及 ~/.config/opencode/AGENTS.md,並將 Claude Code 的慣例作為 fallback。除了 Oh My Pi 之外,在此檢查的每個目的地都會重新輸入供應商設定;Oh My Pi 可將 models.json 轉換為 models.yml,但前提是該檔案已位於 ~/.omp/agent/,因此您必須自行將檔案複製到那裡。憑證不會移轉;每個用戶端都會建立自己的憑證。工作階段歷史也不會移轉:Pi 會將工作階段以 JSONL 樹狀結構儲存在 ~/.pi/agent/sessions/ 下,並記錄兩種匯出方式:/export 匯出為 HTML、/share 匯出為私人 GitHub gist;另有 /bug 報告可將目前分支打包為 session.jsonl。在此檢查的用戶端中未找到可匯入該格式的工具;這代表缺乏證據,而不是已記錄的封鎖。

哪個替代方案接受最廣泛的自訂 API 端點?

在已檢查的用戶端中,Oh My Pi 記錄的集合最廣泛。在 Pi 於 2026 年 9 月 22 日更新文件前,其 models 頁面為 models.json 列出四個 api 值——標示為最具相容性的 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;因此 Pi 與 Oh My Pi 的差距更多在於文件記錄內容,而非 Pi 實際會派送的內容;Pi 額外的六個值在此未經測試。Oh My Pi 的 models.yml 接受由十一個值組成的嚴格超集,新增 openai-codex-responses、azure-openai-responses、bedrock-converse-stream、google-gemini-cli 和 google-vertex;不過十一個值中的兩個 typesafe 和 openrouter-decisions 是判斷 API,而不是聊天傳輸。Codex CLI 的範圍最窄:其設定參考指出,responses 是唯一支援的 wire_api 值,且內建供應商 id openai、ollama 和 lmstudio 已保留,無法覆寫。內容取自各專案於 2026 年 9 月 21 日的官方文件;Pi 的文件和原始碼則於 2026 年 10 月 1 日重新讀取。

我應該從 Pi 切換至 Continue 嗎?

不應該。Continue 已停止以獨立產品形式發布:continue.dev 表示 Continue 已加入 Cursor,並已被 Cursor 收購;其開源程式碼庫仍可免費取得。在 GitHub 上,其最新穩定版本是 2026 年 6 月 19 日的 v2.0.0-vscode,最後一次程式碼提交也是當天,之後只有文件提交。其 GitHub pushed_at 欄位仍顯示近期日期,這就是過時的清單文章持續推薦它的原因——請改看發布日期和提交日期。應將 Continue 視為移轉來源,而不是目的地。

本頁檢查的內容與方式如下。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 費率取自即時目錄,本頁每個金額都是示意性的 token 算術。本頁沒有任何用戶端針對 Kunavo 進行執行階段測試。