Warp 使用教學：從 Block 終端機到 Warp Agent，AGENTS.md、權限與費用一次設定好

很多工程師第一次聽到 Warp，是因為同事螢幕上那個「指令一格一格」的終端機。過了兩三年再回頭看，它的官網首頁已經在講軟體工廠、Agent 評測與自我改進迴圈，終端機反而變成三條產品線之一。

這篇只聚焦大多數人真正會碰到的部分：Warp 終端機本身、內建的 Warp Agent，以及跟費用有關的幾個設定。內容依 2026 年 11 月 5 日查閱的 Warp 官網、定價頁與官方文件整理，我們沒有訂閱付費方案實際跑專案，提到的效果都是依官方文件或官方示範，請用自己的專案驗證。

是什麼：從終端機長成 Agent 開發環境

官方文件現在把 Warp 定位成開源的 Agentic Development Environment，原始碼放在 GitHub 的 warpdotdev/warp，授權是 AGPL-3.0。產品分三層：

• Warp 終端機：macOS、Windows、Linux 都有的桌面 App，日常打指令就在這裡。
• Warp Agent：內建的 coding agent，可以在 App 裡用，也能透過 Warp Agent CLI 在任何終端機、甚至 SSH 連線的機器上跑。
• 雲端 Agent 與 Warp Factories：把工作丟到雲端背景執行，Factories 則是一整隊 Agent 從分流、實作到審查自動交出 PR。文件側欄把 Factories 標為 Early Access，個人開發者可以先不管。

官網寫的使用者規模是 80 萬名以上開發者，客戶案例有 Docker。

能做什麼：先搞懂三個核心概念

Blocks。每一次指令和它的輸出被包成一個 Block，可以單獨複製、搜尋、篩選。跑完一個上千行的 log，按 Block 上的篩選圖示只看含 ERROR 的行，這是傳統終端機做不到的。

編輯器式輸入。輸入列是真的文字編輯器，滑鼠點哪游標就到哪，Shift+Enter 換行，一次貼三行指令會依序執行並各自產生 Block。打過的指令會以淡色自動建議，按右方向鍵接受。

Warp Agent。按 ⌘↩（Windows／Linux 是 Ctrl+Shift+Enter）切到 Agent 模式，用自然語言下指令。依官方文件，它會在真的終端機裡跑指令、讀輸出決定下一步，連 REPL、資料庫 shell 這類互動程式都能操作。改程式碼前會先給你 diff 確認。

另外，Warp 對 Claude Code、OpenAI Codex、OpenCode 這些第三方 CLI agent 有專門支援，例如 Agent 跑完會通知、可以在 Warp 裡直接審 diff。已經習慣 Claude Code 的人，不必為了 Warp 換掉手上的 agent。

怎麼用：從安裝到第一個 Agent 對話

1. 安裝。到官網下載頁裝，Mac 也可以用 brew install --cask warp。官方 quickstart 寫明登入帳號是選擇性的，不登入也能直接當終端機用；雲端對話、Warp Drive 這類跟帳號綁定的功能才需要登入。
2. 匯入舊設定。文件有從 iTerm2、macOS 內建終端機、Windows Terminal、VS Code 終端機，以及從 Cursor、Claude Code 搬過來的遷移指南，快捷鍵與主題可以照著搬。
3. 打開專案。cd 進一個 Git 專案，Warp 會自動開始建索引。到 Settings → Code → Indexing and projects 看狀態，顯示 Synced 才代表 Agent 能用上這份索引。
4. 跑 /init。在專案目錄的 Agent 模式輸入 /init，它會建索引並產生 AGENTS.md，如果專案裡已經有 CLAUDE.md、.cursorrules、GEMINI.md 或 .windsurfrules，也能直接連結過來，不用重寫一份。
5. 問第一個問題。官方建議從「Explain the architecture of this project」這類問題開始。用中文問也可以下指令，但回答品質取決於你選的模型，官方文件沒有特別談中文表現。

舉個台灣工程團隊常見的情境：電商在雙十一前做壓測，某台機器的 API 回應突然變慢。傳統做法是 ssh 進去，自己翻 log、查連線數、看記憶體。換成 Warp，可以直接在 Agent 模式說「看一下這台機器最近十分鐘 nginx 的 5xx 錯誤和連線數，判斷是不是資料庫連線池滿了」，Agent 會依序提出它要跑的指令，你一條條看過再放行。重點不在省下打字時間，而是它把查問題的過程留成一串 Block，事後寫檢討報告時可以直接回頭翻，也能用 Block 分享連結丟給同事看。

進階技巧：讓 Agent 照你的規矩做事

AGENTS.md 分層寫。專案根目錄放共通規則，api/、ui/ 子目錄各放一份專屬規則。依文件，所在子目錄的規則優先於根目錄，再優先於全域規則。有兩個細節容易踩：檔名一定要全大寫，寫成 agents.md 不會被讀到；同一層若同時有 WARP.md 和 AGENTS.md，WARP.md 優先。

用 Profile 分開「謹慎」與「放手」。Settings → Agents → Profiles 可以建多組設定，每組各自選模型、決定套用 diff、讀檔、執行指令、操作執行中程式時是 Agent Decides、Always ask、Always allow 還是 Never。我會建一組只讀不改的 Profile 給正式環境的維運機器用。另外留意，套用 diff 選 Agent Decides 時，行為其實等同 Always ask，只有 Always allow 才會跳過審閱。指令黑名單優先於所有權限，curl、rm 被擋時先去那裡看。

大型專案記得排除。Free 方案只能索引 3 個專案、每個 3,000 個檔案，monorepo 很容易顯示 Codebase too large。在專案放一份 .warpindexingignore，把建置產出、測試快照這類不需要給 Agent 看的檔案排掉，比急著升級划算。另外 WSL 環境目前還不支援程式碼索引。

SSH 與遠端機器。Agent CLI 是一般的命令列程式，可以在沒裝 Warp App 的伺服器上跑，對要進客戶機房除錯的維運人員很實用。

注意事項：方案、費用與 10 人門檻

方案	月繳（美元）	年繳換算每月	重點
Free	0	0	終端機完整、Agent 用量需另購或自帶金鑰
Build	20	18	每月含 20 美元用量（1,500 credits）、索引 40 個專案
Max	200	180	用量約 Build 的十倍
Business	50／人	45／人	最多 25 席、SAML SSO、管理員控管資料

價格以官網為準。幾個台灣團隊導入前要先看清楚的點：

• Free 沒有內含 Agent 用量。加購的價格比付費方案貴 20%，常用 Agent 的話 Build 反而便宜。
• 自帶 API 金鑰有公司規模限制。依官方說明，BYOK 與自訂推論端點只開放個人與 10 人以下的組織，超過 10 人的公司要用 Business 以上方案。另外內建的 Auto 模型一律走 Warp 的推論，就算設了自己的金鑰也一樣，想走自己帳單要手動選特定模型。
• 雲端 Agent 另計平台費。雲端執行每 agent hour 收 3 美元，Free、Build、Max 在本機跑則不收平台費。
• 資料與資安。官方表示通過 SOC 2，與簽約的模型供應商都有零資料保留協議、不拿客戶資料訓練，程式碼索引也不存在 Warp 伺服器。有法遵要求的團隊，仍建議拿官方隱私文件讓資安同事看過；完全不想碰 AI，可以到 Settings → Agents → Warp Agent 整個關掉。

如果你在比較同類工具，可以對照我們寫過的 Claude Code 教學 和 Kiro 教學，兩者的工作方式跟 Warp 差異很大。

TheAI學院評語

Warp 最實在的價值，其實還是那個終端機：Block 式輸出和編輯器式輸入，對每天看 log 的人是體感差很多的改善，而且不付錢就能用。Agent 這層則要看你的情況，已經在用 Claude Code 或 Codex 的人，把 Warp 當成好用的外殼就夠了；還沒挑定 agent、又常需要在多台機器間切換的人，Warp Agent 加上 Agent CLI 的組合值得試一個月。

評語：Warp 是少數「不用 AI 也值得裝」的 AI 開發工具。導入時先把 AGENTS.md 和 Profile 權限設好，再依公司人數決定要不要自帶金鑰，十人以上的團隊別忘了 BYOK 的門檻。

資料來源

• Warp 官方網站
• Warp 定價頁
• Warp 文件：Quickstart
• Warp 文件：Agents
• Warp 文件：Warp Agent CLI
• Warp 文件：Rules for agents
• Warp 文件：Profiles & Permissions
• Warp 文件：Codebase Context
• Warp 文件：Platform usage
• Warp GitHub 原始碼

依 2026 年 11 月 5 日公開資訊整理，功能與價格以官方最新公告為準。