模型定價文件指南應用場景對比關於
登入開始使用
返回指南
教學·2026年10月1日·閱讀約 8 分鐘

goose 程式碼代理教學：安裝、模型來源、API 設定與費用

安裝、選模型來源、開工作階段 —— 三步上手；外加最多人卡住的 Host URL /v1 陷阱。

goose 是一個開源（Apache-2.0）的 AI 程式碼代理，可以在終端機或桌面 App 裡讀檔、改檔、跑指令。上手只要三步：安裝、選一個模型來源（provider）、開一個工作階段給它任務。它本身免費，費用來自你接上的模型。這篇教學依照 2026 年 10 月 1 日的官方文件，說明安裝、三條付費路線、怎麼把它接到 OpenAI 相容端點（包括最常踩的 /v1 陷阱），以及常用操作。最新版本是 2026 年 9 月 23 日發佈的 v1.52.0。

先釐清名字。本頁講的是 goose-docs.ai 上的程式碼代理，程式庫在 aaif-goose/goose，原本叫 block/goose，2026 年 4 月移到 Linux 基金會的 Agentic AI Foundation 底下。它不是 goose.ai —— 那是另一個代管推論服務，價格也與此無關。goose 目前沒有繁體中文介面，下面的選單名稱都照英文原文寫。

安裝

官方提供桌面版（goose Desktop）和命令列版（goose CLI），兩者讀同一份設定。

安裝（擇一）
# goose Desktop(macOS)
brew install --cask block-goose

# goose CLI（macOS / Linux / Windows 的 Git Bash）
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

# 只安裝、先不進入設定
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

# 或用 Homebrew 裝 CLI
brew install block-goose-cli

Windows 可以從官網下載桌面版；CLI 建議在 Git Bash 裡跑同一行安裝指令（PowerShell 也行）。Homebrew 的套件名稱還是 block-goose，這是改名沒有完全傳遞到安裝套件的結果，不代表專案還在 Block 手上。

第一次啟動：選模型來源

第一次打開 goose Desktop 會出現歡迎畫面；CLI 則會自動進入設定模式（之後要改可以跑 goose configure）。安裝頁列出的選項有三種：

  • OpenRouter Login —— 用 OpenRouter 帳號登入，自動設定模型。
  • Tetrate Agent Router Service Login —— 用 Tetrate 登入；文件寫明第一次透過 goose 自動驗證會拿到 $10 免費額度，新舊用戶都適用。
  • Manual Configuration —— 自己選 provider、填金鑰。要接 OpenAI 相容端點（例如 Kunavo）就走這條。

三條付費路線，先選對再設定

路線怎麼付錢注意
API 金鑰（OpenAI、Anthropic、OpenRouter、相容端點）按 token 計費最有彈性；費用跟著用量走，下面有試算
ACP provider（Claude ACP、Codex ACP、Amp ACP、Pi ACP）用你現有的 Claude Code 或 ChatGPT Plus/Pro 等訂閱，文件說「沒有按 token 的 API 費用」需要 Node.js、npm 和各家的 ACP 轉接器；目前不支援 goose session resume 和 fork
本機模型（Ollama 等）沒有按次費用要有夠力的硬體，模型也必須支援工具呼叫

ACP 路線的說明出自 goose 的 ACP providers 文件，它也提醒 ACP 的 session ID 和 goose 的不同，遙測欄位可能對不起來。已經有訂閱、只想省 API 錢的人，先看這條。

接 OpenAI 相容端點：Host URL 不加 /v1

這是最多人卡住的地方。goose 不吃一整串 base URL，而是把它拆成「主機」和「路徑」兩段。依 providers 文件，OPENAI_HOST 是「自訂端點 URL（預設 api.openai.com）」，OPENAI_BASE_PATH 是「附加在主機後面的請求路徑（預設 v1/chat/completions）」，接代理時要把 OPENAI_HOST 設成「代理的根位址（不帶路徑）」。以 Kunavo 為例：

OpenAI provider 的填法
# goose Desktop → Settings → Models → Configure providers → OpenAI
API Key           sk-kn-...
Host URL          https://api.kunavo.com      ← 只寫網域，不加 /v1
Organization ID   （留空）
Project           （留空）

# 或用環境變數（CLI 也讀）
export OPENAI_API_KEY=sk-kn-...
export OPENAI_HOST=https://api.kunavo.com
# OPENAI_BASE_PATH 不要設：預設就是 v1/chat/completions

在 goose Desktop 裡的位置是 Settings → Models → Configure providers → OpenAI；CLI 則是 goose configure → Configure Providers → OpenAI。Organization ID 和 Project 是給 OpenAI 自家帳號用的，留空即可。如果 Host URL 寫成 https://api.kunavo.com/v1，請求會變成 /v1/v1/chat/completions；文件自己也說「404 通常代表 OPENAI_BASE_PATH 對你的代理不對」—— 是路徑錯，不是金鑰錯。反過來，若出現 401「No api key passed in」，那是金鑰沒被讀到，例如把金鑰寫進 config.yaml（goose 會忽略它）。

另一條更乾淨的路，是讓它成為清單裡獨立的一個 provider。goose 會讀 custom_providers 資料夾裡的 JSON 定義檔，Kunavo 提供了一份從即時價目表產生的檔案，裡面只有支援工具呼叫的模型，也只寫金鑰的變數名稱、不含金鑰：

另一條路：Kunavo 的 provider 檔
# macOS / Linux:goose 會讀這個資料夾裡所有 JSON
mkdir -p ~/.config/goose/custom_providers
curl -fsSL https://kunavo.com/goose/kunavo.json \
  -o ~/.config/goose/custom_providers/kunavo.json

# 檔案裡只有變數名稱，金鑰另外設定
export KUNAVO_API_KEY=sk-kn-...
goose session start --provider kunavo

Windows 的資料夾是 %APPDATA%\Block\goose\config\custom_providers\。放好之後，goose Desktop 的 Configure providers 會出現 Kunavo，金鑰可以存進系統鑰匙圈而不是環境變數。依 goose 原始碼，ID 以 gpt-5 或 gpt-6 開頭的模型會走 /v1/responses，其他走 /v1/chat/completions，兩者 Kunavo 都有提供。想手動建也可以：Configure providers → Add Custom Provider，類型選 OpenAI Compatible，API URL 填 https://api.kunavo.com/v1。完整的英文設定頁在 goose integration guide。

老實說明：以上設定是讀 goose 的文件和原始碼整理出來的，Kunavo 沒有實際用 goose 跑過自家端點 —— 沒有跑過工作階段、串流或工具往返。請保留你現在能用的路線，先給它一個會讀寫檔案的小任務試試。

常用操作

  • 開工作階段：goose session（可用 -n 名稱 命名），之後用 goose session --resume -n 名稱 接續；goose session list 列出歷史。
  • 切換授權模式：在工作階段裡輸入 /mode，可選 auto、approve、chat、smart_approve。想讓它每一步都先問你，就用 approve。
  • 選模型：goose configure 不能輸入自訂模型名稱；清單裡沒有的 ID，請在 goose Desktop 輸入，或在 config.yaml 設 GOOSE_MODEL。
  • 專案說明檔：goose 預設會讀 .goosehints 和 AGENTS.md（由 CONTEXT_FILE_NAMES 控制），把專案規則寫在裡面，換到別的代理時也帶得走。
  • 不要選不支援工具呼叫的模型：文件說那種模型「只能做聊天補全」，擴充功能也必須關閉。

一次工作階段大概多少錢

以下是說明用的 token 算術，不是實測的任務費用，也不是帳單上限。假設一次代理工作階段在多輪之間總共送出 400,000 未快取輸入 token、收到 25,000 輸出 token（代理每一輪都會重送上下文，所以輸入特別多）。單價取自 Kunavo 價目表的即時每百萬 token 價格。

模型輸入 / 輸出（每百萬 token）一次工作階段估算
Claude Haiku 4.5$0.70 / $3.50$0.367
Claude Sonnet 5$1.40 / $7.00$0.735
GPT-5.6 Sol$2.00 / $12.00$1.100

關於快取：goose 的文件說，透過 Anthropic、Amazon Bedrock、Databricks、OpenRouter、LiteLLM 這幾個 provider 使用 Claude 時，會自動加上 Anthropic 的 cache_control 標記。走通用 OpenAI provider 的 Claude 不在這份名單上，goose 就不會加這些標記，所以上表假設沒有快取折扣，這是保守的估法。Kunavo 的價目表金額是計費下限而不是上限：上游有回報費用時，帳單取「價目表金額」與「上游費用 × 適用加成」較高者。

在台灣付款

Kunavo 是預付儲值、按 token 扣款，沒有月費。最低儲值 $10，結帳走 Stripe，台灣可用信用卡（Visa、Mastercard、American Express、JCB、銀聯）、Apple Pay 和 Link；街口、LINE Pay 不在可用清單上。詳見計費說明，準備好之後可以建立帳號並產生金鑰。想比較其他代理，可以看英文的 goose alternatives 和 goose vs Claude Code。

FAQ

goose 和 goose.ai 是同一個東西嗎？

不是，這是這個關鍵字最常見的混淆。goose 是 Apache-2.0 授權的開源程式碼代理（coding agent），程式庫在 aaif-goose/goose，文件在 goose-docs.ai。goose.ai 則是另一個代管的 NLP 推論服務，網站自述為 CoreWeave 與 Anlatan 的合資事業，和這個程式碼代理無關；任何掛在 goose.ai 名下的按次價格，都是那個推論服務的價格。

goose 停止開發了嗎？

沒有。goose 從 block/goose 搬到 aaif-goose/goose，成為 Linux 基金會旗下 Agentic AI Foundation 的專案。2026 年 10 月 1 日查證時，GitHub API 顯示程式庫沒有封存、當天仍有推送，最新版本 v1.52.0 於 2026 年 9 月 23 日發佈。Homebrew 套件名稱（block-goose）、VS Code 擴充功能 ID 和 Windows 設定資料夾仍帶著 Block 的名字，所以搜尋結果有時看起來像是停了，其實沒有。

goose 要錢嗎？

goose 本身免費；要付錢的是它呼叫的模型。三種常見路線：用 API 金鑰按 token 計費（OpenAI、Anthropic、OpenRouter 或任何 OpenAI 相容端點）；用 ACP provider 接你現有的 Claude Code 或 ChatGPT Plus/Pro 訂閱，官方文件說這樣「沒有按 token 的 API 費用」；或用 Ollama 等本機模型，沒有按次費用。安裝頁也寫明，第一次透過 goose 自動登入 Tetrate 會得到 $10 的免費額度。

goose 的 Host URL 要加 /v1 嗎？

不要，加了反而會壞。goose 把端點拆成兩段：OPENAI_HOST 是主機（預設 api.openai.com），OPENAI_BASE_PATH 是附加在後面的請求路徑（預設 v1/chat/completions）。所以 Host URL 只填 https://api.kunavo.com，/v1 由預設路徑補上。若寫成 https://api.kunavo.com/v1，實際請求會變成 /v1/v1/chat/completions，回 404 而不是認證錯誤。

為什麼 goose configure 找不到我要的模型？

goose 的文件明說 goose configure 不支援輸入自訂模型名稱。清單裡沒有的模型 ID，請在 goose Desktop 裡直接輸入，或在 config.yaml 設 GOOSE_MODEL。另外 goose 幾乎每一步都靠工具呼叫（tool calling），文件提醒不支援工具呼叫的模型只能純聊天、擴充功能也得關掉，所以請選支援工具的模型。

2026 年 10 月 1 日查證：goose 的安裝、providers、ACP providers、CLI 指令與環境變數文件（aaif-goose/goose main 分支），以及 GitHub API 的版本與封存狀態。Kunavo 沒有用 goose 實際跑過自家端點；價格取自即時價目表，金額範例皆為說明用的 token 算術。