文章目錄
Pi Coding Agent 和 Claude Code、Codex、OpenCode 最大的差別在於，它預設只啟用 read、edit、write 與 bash 四種工具，系統提示詞很短，也沒有子代理。需要其他功能時，大多靠安裝擴充模組加上。
和 Claude Code、Codex 相比，用 Pi 可以完全掌控自己的開發工具，代價是少了模型廠商調校過的系統提示詞、工具與周邊服務。有一篇知乎文章估計 Pi 的 Token 消耗量是 Claude Code 的 30 到 35%，不過它估算的是非開發的需求，開發時能省多少還要看專案規模、需求複雜度與 Prompt。
安裝前需要 Node.js 22.19 以上的 npm 環境，安裝與設定方式依照 Pi 官方文件。Pi 執行指令或修改檔案前不會詢問，所有工具都以目前使用者的權限執行，官方的安全說明建議放進容器或虛擬機裡使用，做法可以參考把 Agent 關在開發容器。擴充模組會執行第三方程式碼，專案層級的模組與設定要等專案被信任後才會載入。
安裝與更新
Pi 支援 Windows、macOS 與 Linux，任何終端機都能執行。我會盡量在能跑 Bash 的環境使用，因為 AI 在 Windows 的 PowerShell 裡很容易打錯指令，來回修正很浪費時間。
Pi 用 npm 安裝到全域環境，開啟終端機輸入：
1npm install -g --ignore-scripts @earendil-works/pi-coding-agent
安裝完成後，在專案資料夾開啟終端機，輸入 pi 就能啟動 Agent：
1pi
要更新 Pi與擴充模組時，使用以下指令：
1# 更新 Pi 本體
2pi update
3
4# 只更新所有擴充模組
5pi update --extensions
6
7# 更新 Pi 本體與所有擴充模組
8pi update --all
安裝擴充模組
沒有裝擴充模組時，Agent 缺什麼工具就自己寫程式碼補，反而更燒 Token。以下是我開發軟體時必裝的幾個模組。
網路搜尋
必裝，讓 Agent 自己上網找資料，裝好就能用，也可以在 ~/.pi/agent/web-search.json 加入自己的 Exa、Brave 等服務的 API，請參考 pi-web-access 說明。
1pi install npm:pi-web-access
選項提問
必裝，Agent 反問問題時可以直接用方向鍵選答案，不用每次都打字回答。
1pi install npm:@juicesharp/rpiv-ask-user-question
模組生效後，Agent 提問時會列出選項：
子代理
必裝，讓 Agent 把探索與實作派給子代理處理，主對話的上下文不會被探索過程塞滿。子代理要用哪個模型，可以在 pi-subagents 的模型設定依角色指定。
1pi install npm:pi-subagents
MCP
選配，需要用 Unity MCP、Serena MCP 這類 MCP 時再設定。很多 MCP 的功能現在都有 Skills 或 CLI 可以取代，所以我沒有把它列為必裝。Pi 已內建 MCP 支援，不用另外裝擴充模組，直接用 pi mcp add 加入伺服器，再用 pi mcp list 確認連線：
1pi mcp add <伺服器名稱> -- <指令> [參數]
2pi mcp list
使用 Codex 訂閱
Pi 內建 Claude、Codex 與 GitHub Copilot 的訂閱登入，也可以用 API Key，完整清單見官方文件的模型提供者列表。
進入 Pi 後執行：
1/login
選擇 Use a subscription。
在 provider 選單中選擇 ChatGPT Plus/Pro。
再選擇 Browser login，終端機會印出一個連結，點擊後在網頁登入已訂閱的 ChatGPT 帳號，連結成功後 Pi 就能使用 GPT 模型。
基本操作
/model 可以選擇模型，反覆按 Ctrl + P 可以直接切換模型。
反覆按 Shift + Tab 可以調整推理等級。
用子代理分攤 Codex 額度
Pi 可以同時登入多家的訂閱，子代理也能指定不同家的模型。公司有提供 Cursor，我用 pi-cursor 模組在 Pi 裡同時接上 Cursor 與 Codex 的訂閱，規劃時用 GPT-5.5 xhigh，實作時依複雜度派 GPT-5.4 或 Cursor 的 Composer 2.5 擔任子代理，用貴的模型規劃、便宜的模型實作。工作分到兩家的訂閱上，近期被大砍的 Codex 額度就比較撐得住。
確認安裝與登入成功
在專案目錄執行 pi 應能進入互動介面。完成 /login 後開啟 /model，能看到 ChatGPT Plus/Pro（Codex）提供的模型，送出一個簡短問題也能取得回應，才算登入完成。擴充模組可以用 pi list 核對，例如裝好選項提問模組後，Agent 提問時會出現方向鍵選單。
問題排除
終端機找不到 pi，先確認 npm 的全域執行路徑已加入 PATH。/login 成功但模型清單不正確時，可重新登入或執行 pi update --models 更新模型目錄。模組沒有載入時，先用 pi list 確認安裝位置。官方文件區分使用者設定與加上 -l 的專案設定，裝到另一邊就會看不到模組。
移除單一模組用 pi remove npm:套件名稱。不再使用 Pi 時，用以下指令移除即可，不必手動刪除全域套件目錄：
1npm uninstall -g @earendil-works/pi-coding-agent
總結
Pi 預設只啟用四種工具，開發前要先裝好網路搜尋、選項提問與子代理三個模組。它能同時登入多家的訂閱，子代理改派其他家的模型，就能替 Codex 訂閱分攤額度。
延伸閱讀
