Pi Coding Agent 輕量級終端機 AI 助手安裝與工作流實戰

範例影片

我們先來看看 Pi 實際運作起來是什麼樣子，感受一下它在終端機裡面的絲滑體驗：

這段影片展示了 Pi 最殺手的 Tree View 分支功能：

簡介

大家好！今天來跟大家分享一款非常特別的終端機 AI 寫扣助手 —— Pi。

官方 GitHub 專案： https://github.com/badlogic/pi-mono

如果你跟我一樣，喜歡在終端機裡面搞定一切，但又覺得市面上的 AI 工具（像是 Cursor 或是其他整合型 IDE）太過龐大，或者總是自作主張幫你生一堆你不需要的檔案，那你一定會愛上 Pi。

Pi 是一個極簡的終端機 coding harness。它的核心理念是：「讓 Pi 適應你的工作流程，而不是要你去適應它」。

它故意不內建一堆複雜的「子代理 (sub-agents)」或「計畫模式 (plan mode)」，而是給你最純粹、最強大的預設工具（讀寫檔案、執行 bash 等）。如果你需要更多功能，完全可以透過它的擴充套件 (Extensions)、技能 (Skills) 或是提示詞範本 (Prompt Templates) 自己加上去，甚至透過 pi install 安裝社群發布的套件。

下載與安裝

安裝非常簡單，只要環境裡有 Node.js，一行 npm 指令就能搞定全域安裝：

bash

npm install -g @mariozechner/pi-coding-agent

安裝完成後，最方便的啟動方式就是直接綁定你現有的 AI 訂閱服務！

如果你已經有訂閱 Claude Pro、ChatGPT Plus、GitHub Copilot 或 Google Gemini 等服務，完全不需要去後台生什麼 API Key，直接透過 OAuth 登入就好：

bash

pi
/login  # 接著在選單中選擇你的服務提供商

只需幾秒鐘完成授權，就能馬上開始無縫對話！

(當然，如果你是重度開發者，想要自帶各家 API Key 也是完全支援的。以 Anthropic 的 Claude 為例，只要設定環境變數 export ANTHROPIC_API_KEY=sk-ant-... 再執行 pi 即可。)

功能試用：完全在終端機裡的流暢體驗

在專案目錄下輸入 pi，就會進入它的 Interactive Mode (互動模式)。

介面非常乾淨，但在這個純文字介面裡，藏著很多好用的功能：

快速引用檔案：直接在輸入框打 @，就能模糊搜尋並載入專案內的檔案給 AI 參考。
直接執行 Bash：輸入 !npm run test，Pi 就會執行指令並把跑出來的錯誤訊息直接餵給 AI 幫你 debug。
貼上截圖：如果你的終端機支援，按 Ctrl+V (或直接拖曳) 就能把圖片傳給支援多模態的模型。
非同步對話：AI 在思考或打字的時候，你完全不用乾等！按下 Enter 可以隨時「插話 (steering message)」修正它的方向，或是用 Alt+Enter 把下一個問題排進佇列。

特殊功能：時光機般的 Session Branching

這是我覺得 Pi 裡面最酷、最實用的功能！

平常我們用 AI 聊天，如果 AI 中途理解錯了，或者給的程式碼把專案搞爛了，我們通常只能不斷下 prompt 去糾正它，浪費 Token 又浪費時間。

但是在 Pi 裡面，你只要輸入 /tree，畫面就會叫出整個對話歷史的樹狀圖。你可以直接 「跳回」 AI 走偏之前的那個對話節點，修改你當時的指令，然後從那裡長出一個新的分支繼續對話。

這就像是幫你的對話紀錄上了 Git 一樣！而且所有的分支紀錄都只會存在同一個 JSONL 檔案裡，非常乾淨。

等等... 還有更多擴充玩法

Pi 的可玩性遠不止這樣：

AGENTS.md 上下文約定：在專案根目錄放一個 AGENTS.md，就能自動讓 Pi 知道這個專案的開發慣例與常用指令。
熱重載主題 (Themes)：看膩了預設配色？輸入 /settings 可以即時切換深色/淺色主題。
超強的外掛生態系 (Pi Packages)：你甚至可以用 TypeScript 自己寫擴充，或者安裝別人寫好的。像是自訂 UI、串接 MCP server、甚至在等待 AI 回應時在終端機裡打一局 Doom 都可以！

如果你也在尋找一個輕量、專注，而且完全由你掌控的終端機 AI 助手，強烈建議你在下一個專案試試看 Pi。

相關連結：