CLI Agents 參考指南¶
這份 reference doc 用「現在要做什麼」和可核對的官方資料整理 9 個 terminal CLI。它不替工具打分，也不以熱門度或主觀排行決定入口；先看身分，再依你的 provider、登入方式與安全邊界選擇。
先分清楚：agent 不等於模型或 API¶
| 種類 | 它負責什麼 | 例子 | 不要混淆 |
|---|---|---|---|
| LLM | 產生文字、程式碼或工具呼叫 | Claude、GPT、Gemini | 模型不自動擁有你電腦的檔案權限 |
| Provider API | 提供某家模型的請求、認證與計費 | Anthropic API、OpenAI API、Gemini API | API 不是 terminal 工作台 |
| Router | 把請求轉接到多家 provider | OpenRouter | Router 不會代替 agent 管理檔案或命令權限 |
| Coding agent／harness | 在終端機讀檔、編輯、執行命令並回報結果 | Claude Code、Codex、OpenCode、Pi | 它的 approval、sandbox 與 project trust 要另外查 |
| Local runtime | 在本機載入並執行模型 | Ollama | 它可供 agent 呼叫，但本身不是 coding agent |
用情境找入口¶
| 你的條件 | 先查哪一類 | 要記錄的差異 |
|---|---|---|
| 已有一家模型服務的帳號 | 該生態的 CLI，例如 Claude Code、Codex 或 Gemini CLI | 登入流程、approval、sandbox、用量頁面 |
| 需要更換 provider | OpenCode、goose、Aider、Hermes Agent 或 Pi | 支援的 endpoint、模型 ID、API key 儲存位置 |
| 想集中轉接多個 provider | OpenRouter 搭配一個 agent | 實際路由到的 provider、資料政策、usage 與 billing |
| 想在本機練習 | Ollama 搭配支援相容 API 的 agent | 模型是否在本機、agent 是否仍可執行 shell／寫檔 |
9 個 CLI 工具¶
完整表預設收合；展開後請把「查核日」與你的安裝版本一起記下。官方資料查核日：2026-08-30 UTC。
展開 9 個 CLI 的安裝、認證、provider 與安全事實
| 類型 | 工具 | 現在適合誰 | 模型／provider 選擇 | 登入方式 | 安全起手式 | 狀態 | 官方來源 |
|---|---|---|---|---|---|---|---|
| 官方模型生態 | Claude Code | 要在終端機使用 Anthropic 生態的人 | Claude；Anthropic API | Claude 帳號或 Anthropic API key | 用 demo repo；保留 permission prompt | Anthropic 官方 terminal、desktop、IDE 與 cloud 介面之一 | 文件 · repo |
| Codex CLI | 要在終端機使用 OpenAI／ChatGPT 登入的人 | GPT 系列；OpenAI API | ChatGPT 登入或 OpenAI API key | 使用預設 approval 與 workspace sandbox；先看 diff | OpenAI 開源 terminal coding agent | 文件 · repo | |
| Gemini CLI | 已有 Google 認證，想在 terminal 使用 Gemini 的人 | Gemini；Google AI API 或 Vertex AI | Google 登入、Gemini API key 或 Vertex AI | 使用 approval 模式；需要時明確開啟 --sandbox |
Google 開源 terminal agent | 文件 · repo | |
| Grok Build | 要試用 xAI Grok terminal TUI 的人 | Grok；xAI 登入或 API key | 首次互動瀏覽器登入；CI 可用 XAI_API_KEY |
先用 demo repo；不要複製 ~/.grok/auth.json |
xAI 官方開源 TUI coding agent | 認證 · repo | |
| 可換 provider | OpenCode | 需要在多個 provider 間切換的人 | 多 provider；可接 OpenRouter 或相容 endpoint | 依 provider 設定 API key、OAuth 或環境變數 | 先檢查 permission 設定；只在 demo repo 試外部目錄 | 開源 terminal coding agent；AGENTS.md 優先，沒有時才用 CLAUDE.md 相容 fallback |
provider · repo |
| goose | 需要 CLI、desktop 或 API，並想接工具與資料來源的人 | 15+ provider，包含 Anthropic、OpenAI、Google、Ollama、OpenRouter | provider API key，或部分既有訂閱的 ACP 登入 | 先用低權限 extension 與 sandbox；不連 production 資料 | AAIF 的開源本機 agent，提供 CLI、desktop、API | 文件 · repo | |
| Aider | 希望以 git diff／commit 管理程式修改的人 | 多家 cloud API、OpenRouter、OpenAI-compatible endpoint 與本機模型 | provider API key、設定檔或環境變數 | 先用乾淨 demo repo；留意 Aider 的 git auto-commit 行為 | 開源 terminal pair-programming 工具，官方文件明列 git 整合 | 文件 · repo | |
| Pi | 想從小核心開始，用 extensions、skills 或 RPC 擴充的人 | 訂閱 provider、API key provider、自訂 provider；可接本機 endpoint | /login 或 provider API key |
Pi 沒有內建 sandbox；用 disposable repo 或容器，並人工審查命令 | 可擴充的 minimal terminal coding harness | provider · repo | |
| Hermes Agent | 要在 terminal、desktop 或聊天平台使用同一 agent 的人 | Nous Portal、OpenRouter、Anthropic、Google 與其他 provider | hermes model 設定 API key 或 OAuth；Nous Portal 可用 OAuth |
先在低風險 repo；把 skills、MCP 與 provider 權限逐項開啟 | Nous Research 的開源 agent，文件提供 CLI 與多介面整合 | provider · repo |
OpenRouter 與 Ollama 放在哪裡？¶
OpenRouter 是 Router，不列入上表的 9 個 coding CLI；它提供統一 API、provider routing 與集中用量。Ollama 是 local runtime，不是 agent；它可在 http://localhost:11434/v1 提供相容 API，供 OpenCode、goose、Aider 或其他 client 使用。兩者都不能取代 agent 的檔案權限與 sandbox 設計。
Prompt 跨 CLI 搬移時保留四件事¶
- 寫清楚檔案路徑、允許的範圍與「先列計畫、確認後再改」的順序。
- 把模型、provider、API key、approval／sandbox 設定分開記錄；不要假設換 CLI 後相同。
- 用一般文字描述目標；
/login、/permissions等斜線指令只在對應工具的區塊使用。 - 要求輸出
git diff、測試結果與未完成項目，並在另一個 CLI 前先復原工作樹。
展開規則檔、sandbox 與常見問題
- Claude Code 的專案規則是
CLAUDE.md；Codex 使用AGENTS.md。OpenCode 以AGENTS.md優先，沒有時才使用CLAUDE.md相容 fallback；不要把不存在的OPENCODE.md當共通格式。 - Gemini CLI 的專案上下文與
.gemini/設定依官方文件；--sandbox、approval mode 與--yolo的風險不同，第一次不要跳過確認。 - Pi 的 project trust 不是 sandbox，官方安全文件明確提醒它依啟動使用者權限執行；需要隔離時改用容器或其他 OS 層邊界。
- Aider 官方文件說明編輯後的 git 整合與 auto-commit；先在乾淨 demo repo 觀察，確認 commit 內容再帶入工作 repo。
- goose、Hermes Agent 與其他可接 MCP／extension 的 agent，先開一個低權限、只讀取的整合；不要以 Gmail、Slack 或 production DB 作第一個外部連線。
- API key 只放在官方支援的 credential store 或環境變數；不進 repo、不進 prompt、不進截圖與 issue。費用按當日官方價格和實際 usage 計算，不按模型名稱猜測。
官方查核入口（2026-08-30 UTC）¶
回到 Track A¶
維護原則：工具、登入、價格、sandbox 與 provider 都會變動；每次改表前重查官方文件，並更新查核日。這份表保持事實欄位，不維護熱門度或主觀評分。