30 分鐘完成第一次 Pi 任務
第一次使用 Pi，不以“介面開啟了”或“模型回覆了”作為終點。你的目標是讓 Pi 幫你整理一份虛構會議記錄，得到可以親自檢查的行動清單，並確認輸入沒有被改動。
這條路線在網路和安裝環境正常時大約需要 30 分鐘；下載速度、瀏覽器授權和帳戶狀態可能讓它更久。時間不是驗收標準，右側證據全部透過才算完成。這頁只負責帶路，具體操作仍以對應課程為準。
先看完整閉環
| 階段 | 預計時間 | 進入哪一頁 | 透過證據 |
|---|---|---|---|
| 1. 準備環境 | 5 分鐘 | macOS/Linux：安裝前檢查；Windows：中文安裝路徑 | 終端機、練習目錄、Node.js 與 npm 檢查透過 |
| 2. 安裝 Pi | 5–10 分鐘 | 安裝並啟動 Pi | pi --version 有輸出，能啟動並退出 |
| 3. 連接模型 | 5 分鐘 | 登入與模型設定 | 模型準確回覆“Pi 已連接”，沒有使用工具 |
| 4. 確認工作位置 | 2 分鐘 | 從練習目錄開始 | 狀態列目錄、模型與信賴決定都能解釋清楚 |
| 5. 完成第一次任務 | 10 分鐘 | 第一次任務 | 輸入指紋未變，輸出存在，三條事項逐項對應 |
本輪先保持零外掛程式
第一次任務不需要擴充功能（Extension）、技能（Skill）、包（Package）、子代理（Subagent）、Plan Mode 或瀏覽器自動化。先確認原版 Pi 的安裝、模型、檔案和驗收閉環都正常；只有遇到一個重複出現的具體需求，才進入外掛程式推薦選擇一個方案。
開始用 Agent，先準備這四樣
- 一臺能穩定工作的電腦。 我更喜歡在 Mac 或 Linux 上做命令行任務；手頭是 Windows 也可以，Pi 有官方 Windows 路徑，本書給出了完整中文步驟。先用現有裝置跑通 Node.js、終端機和 Pi，不必為了入門先換電腦。
- 一個順手的終端機。 Mac 上我最推薦 iTerm2；它只支援 macOS，系統自帶終端機也能執行 Pi。Linux 可以先用發行版自帶終端機。Windows 初學者先安裝並開啟 Git Bash；如果喜歡 Windows Terminal 的視窗介面，也要確認實際執行的是 Git Bash，不能把預設開啟的 PowerShell 當成同一套命令環境。Pi 終端機相容說明
- 一個簡單、可擴充的 Agent。 我推薦從 Pi Coding Agent 開始。這裡實際安裝的是帶
pi命令的完整終端機應用，底層pi-agent-core是它使用的元件；兩者並非同一層。Pi 負責連接模型、組織工具和儲存工作階段；安裝它本身不會附送模型額度。macOS/Linux 可以選擇官方安裝器或 npm，Windows 初學者繼續使用本書的 Git Bash 路線。 - 一種可用的模型存取方式。 想按實際用量付費，可以先看 DeepSeek 官方 API；想用 OpenAI 的 Codex 模型並同時使用 ChatGPT，可以從每月 $20 的 ChatGPT Plus開始。先檢視四種選擇與接入邊界。Plus 是否夠長期使用，取決於任務量和當時的額度；用量不夠時，先檢查帳戶當前限額和可用的補充額度或更高檔方案，再決定是否升級。Plus 不包含單獨計費的 OpenAI API 用量。
這四樣準備好後，先完成一次無檔案的真實回覆，再進入檔案任務。安裝 Pi、登入模型服務商（Provider）、選中模型、完成任務是四個不同的驗收點；前一步成功不能替後一步作證。
上述平台、終端機和模型存取方式資訊最後核驗於 2026 年 9 月 23 日；實際購買和安裝時，請再檢視文中連結的官方頁面。
Pi 之外，還有兩條分支路線
本書用原版 Pi 教基礎，因為它便於看清模型、工具和檔案實際怎樣配合。已經能完成基礎任務、想要更多現成能力時，可以閱讀OMP 與 Selesai Code 對照：OMP 更重程式碼導航、除錯和工具介面；Selesai 更重成套子代理、研究與工作階段交接。它們是獨立的 Agent，不是 Pi 外掛程式，也不會因為安裝了它們就自動獲得模型額度。
找到你現在的位置
| 當前狀態 | 從哪裡開始 | 完成標誌 |
|---|---|---|
| Mac 或 Linux 上還沒裝 Pi | 安裝前檢查 → 安裝 Pi | Node.js、npm 和 Pi 能返回版本號，能啟動和退出 |
| Windows 上還沒裝 Pi | Windows 路線選擇與 Git Bash 實作 | 選定一種 Windows 環境；在 Git Bash 入門路線中建立練習目錄並啟動 Pi |
| 已安裝，但還不能回覆 | 登入與模型設定 | 確認存取方式和費用，收到一次真實回覆 |
| 已經能收到回覆 | 從練習目錄開始 → 第一次任務 | 產生行動清單，三條事項完整，輸入檔案未變 |
Linux 使用者可以跟隨 macOS/Linux 通用命令，檔案指紋使用 sha256sum。本書不提供 Linux 桌面介面的逐屏教學。
第一次成功應該留下什麼
pi --version的真實輸出，以及一次準確的“Pi 已連接”回覆。input/專案會議記錄.md：你親自檢查過的固定材料。output/行動清單.md：包含事項、負責人、截止日期和風險提醒。- 輸入指紋校驗透過，輸出恰好包含三條事項。
命令找不到、模型沒有真實回覆、檔案不存在、欄位遺漏或輸入被改動，都不算完成。回到對應階段只解決這一項，不要同時重灌 Pi、切換模型服務商、安裝外掛程式並修改終端機設定。
做完以後怎麼選
想理解剛才發生了什麼，繼續讀檔案與工作目錄、工作階段儲存，再跟隨完整主線。想先建立概念全貌，可以回到導論和Pi 工作原理。
完成基礎課程後，用內容整理遷移練習處理相互衝突的資料，或用小型程式碼修復練習“先復現失敗，再驗證修復”。學完第 14 課後進入畢業專案，把前面的方法串成一次完整工作流。
卡住時先縮小問題
啟動不了，查啟動故障；沒有模型，查模型與認證；找不到產物，查檔案與目錄錯誤。求助時帶上章節、作業系統、Pi 版本、執行位置和去除憑據後的錯誤文字。