文件

Roo Code

Roo Code 的 OpenAI Compatible 提供者需要填寫三個欄位，並設定一個模型能力區塊。能力區塊不是可有可無的裝飾——Roo Code 會依據其中資訊計算上下文用量。

選擇 OpenAI Compatible 供應商，貼上基礎 URL 與金鑰，並設定模型的上下文視窗與最大輸出，讓 Roo Code 的預算計算正確。

Roo Code 設定面板

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...
Model          claude-sonnet-5

Model Configuration
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on

Roo Code 使用原生工具呼叫，沒有後備模式，因此您選擇的模型必須支援 OpenAI 相容的工具呼叫。下表中的所有 id 都符合此條件；若在此設定純文字或媒體模型，代理程式第一次嘗試使用工具時就會失敗，而不是在設定階段出錯。

請填寫 Context Window 和 Max Output Tokens，不要沿用預設值。Roo Code 會根據這些數值判斷何時精簡對話；上下文視窗設得太低，會使它截掉原本不必捨棄的歷史內容；設得太高則會導致上游傳回 400 錯誤，而非順利精簡對話。

還沒有金鑰？建立 Kunavo 帳戶，建立金鑰（以 sk-kn- 開頭），並從 $10 起新增額度——呼叫會從該餘額扣款，失敗的呼叫不會計費。之後儀表板會開啟 Roo Code 設定。

逐步操作

在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
開啟 Roo Code 設定面板，並將 API Provider 設為 OpenAI Compatible。
輸入 Base URL https://api.kunavo.com/v1 和您的金鑰。Base URL 必須包含 /v1 後綴——Roo Code 只會附加路徑。
選取或輸入模型 id，接著開啟 Model Configuration，並依照下表設定上下文視窗、最大輸出 token 數、圖片支援，以及輸入／輸出價格。
在 Code mode 中傳送訊息。此處輸入的價格會用於 Roo Code 自身的每項任務費用顯示，因此值得仔細填寫。

已於 2026年9月6日根據 Roo Code 的 OpenAI Compatible 提供者頁面進行確認。第三方設定會變動；如果這裡的欄位名稱不再與你看到的內容相符，應以該頁面為準，而不是本頁。

這是簡短版本。完整指南——模型選擇、實際工作階段費用，以及失敗情況——請參閱 Roo Code + Claude 操作指南。

除錯用戶端前先驗證

一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON，則相同的基礎 URL 與金鑰在 Roo Code 中也能運作。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

欄位中應填入哪個模型 ID

每個文字模型都能以模型 ID 存取——即時清單位於 GET /v1/models，帶有價格的目錄位於模型頁面。費率是每 1M 權杖的美元價格，輸入／輸出。

模型 ID	Kunavo 輸入／輸出	它在 Roo Code 中的位置
`claude-sonnet-5`	$1.40 / $7.00	Code mode——預設模式，也是費用顯示所依據的模式
`claude-opus-5`	$3.50 / $17.50	Architect mode；在此模式中，計畫出錯的代價比 token 更高
`claude-haiku-4-5`	$0.70 / $3.50	Ask mode 與重複讀取檔案
`gpt-5-6-terra`	$0.70 / $4.20	長上下文檢視大型儲存庫

計費方式是從預付餘額按權杖計費，沒有月費——請參閱 billing。在重複的上下文中——這是編輯器或聊天用戶端傳送內容的大部分——提示快取對帳單的影響比模型選擇更大。

常見問題

如何讓 Roo Code 使用自訂 OpenAI 相容端點？

在 Roo Code 設定面板中，將 API Provider 設為 "OpenAI Compatible"，接著填入該端點的 Base URL 和 API Key，並選擇模型。Base URL 應設為服務的 /v1 根路徑，因為 Roo Code 只會在其後附加路徑。Roo Code 自身的文件特別指出 Base URL 欄位至關重要——這個欄位決定每一個請求的目的地。

透過自訂端點，哪些模型可搭配 Roo Code 使用？

端點所提供且支援 OpenAI 相容原生工具呼叫的任何模型。Roo Code 只使用原生工具呼叫，沒有後備模式，因此不支援工具的模型雖然會連線成功，但代理程式一嘗試讀取或寫入檔案就會失敗。Claude 和 GPT 文字模型都符合條件；圖片、影片和音訊模型則不符合。

Roo Code 的 Context Window 和 Max Output Tokens 應填多少？

請填入所選模型的實際限制，不要使用預設值。Roo Code 會依據這兩個數值判斷何時精簡對話；數值低於模型的實際上下文限制，會使它不必要地捨棄歷史內容；高於限制則會導致上游傳回 400 錯誤，而非順利精簡對話。各模型的數值可在端點的模型目錄中查閱。

為什麼 Roo Code 顯示的任務費用不正確？

因為 Model Configuration 中的 Input Price 和 Output Price 是手動輸入的，預設值為零或其他提供者的費率。Roo Code 的每項任務費用顯示完全依據這兩個欄位計算——它不會從端點讀取價格——因此數值是否準確，取決於輸入內容。請從提供者自己的目錄複製費率。