使用 Claude API 的 Kilo Code——OpenAI 相容基礎 URL 設定與按模式路由

Kilo Code 是 VS Code 中最常用的開源 AI 程式開發代理之一，與 Cline 家族的其他代理一樣，支援使用您自己的 OpenAI 相容 API 端點。這表示您只需一組 sk-kn- 金鑰，就能在編輯器內使用 Claude，而主流模型的價格比 Anthropic 的牌價低約 30%。本指南涵蓋三個欄位的設定方式、各種任務應選擇哪個 Claude 模型，以及一次代理式程式開發工作階段的實際費用。

Kilo Code 為什麼需要 API 金鑰

Kilo Code 不會捆綁模型——每個動作（讀取檔案、提出編輯、執行命令、檢查結果）都是一次 API 呼叫，並按 token 計費。Claude Pro 這類聊天訂閱不涵蓋此功能；擴充功能需要直接 API 存取權。這正是 Kunavo 提供的形式：從 $10 開始按用量付費加值，一組金鑰即可使用 Claude 與 GPT，且餘額永不過期。由於代理式迴圈會在每個步驟重新傳送不斷增長的工作上下文，因此每 token 費率是影響工作階段成本的最大槓桿——這也是 claude-sonnet-5 上約 30% 的折扣會快速累積的原因。

三個欄位

Kilo Code 將供應商公開為三個設定欄位：

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...          # create at kunavo.com/app/keys
Model ID       claude-sonnet-5        # or claude-opus-5 / claude-haiku-4-5

註冊並儲值 $10 後，即可從儀表板取得金鑰 — 金鑰只會顯示一次，請立即妥善保存。完整的金鑰管理說明請參閱 Claude API 金鑰文件。

Kilo Code 設定

1. 從 VS Code 市集安裝Kilo Code，然後從側邊欄開啟它。
2. 開啟擴充功能設定（齒輪圖示），並前往Providers區段。
3. 將API Provider設為OpenAI Compatible。
4. Base URL：https://api.kunavo.com/v1 · API key：你的 sk-kn-… 金鑰 · Model：claude-sonnet-5。
5. 儲存設定，然後先要求它處理一件小事（「解釋這個檔案」），確認連線正常後，再讓它編輯程式碼。

Kilo Code 支援依模式覆寫模型（Architect／Code／Debug）——這是將規劃工作路由至較強模型（claude-opus-5）、將執行工作路由至較便宜模型（claude-sonnet-5）的理想位置。

Cline 與 Roo Code

Kilo Code 與 Roo Code 都是 Cline 家族的分支，因此上方三個欄位在三個工具中完全相同——供應商為OpenAI Compatible、base URL 為 https://api.kunavo.com/v1、金鑰與模型 ID。不同之處在於各工具提供的模型路由功能，而節省成本的關鍵就在這裡，因此各自都有專屬指南：Cline 搭配 Claude API說明其 Plan／Act 分割，Roo Code 搭配 Claude API說明其具名設定檔與依模式繫結模型。

三個工具另外都提供原生Anthropic供應商，以及自訂 base-URL 選項。將其指向 https://api.kunavo.com 後，會改用原生Messages API（/v1/messages）——這很實用，因為 cache_control 會原樣轉送，且快取輸入按輸入費率的 10% 計費（請參閱提示快取文件）。兩種路線都可行；OpenAI 相容路線最容易開始。

應選擇哪個 Claude 模型

claude-opus-5 是這裡強推理能力的選擇：它是 Anthropic 最新的 Opus，費率與前一代 claude-opus-4-7 相同，均為 $3.50／$17.50（$3.50／$17.50）；如果你已固定使用前一代模型，它仍可繼續使用。由於模型欄位在同一端點上只是一個 slug，切換只需改一個字——不需要新金鑰，也不需要新的供應商設定。所有模型的完整費率請參閱Claude API 定價指南與定價頁面。

一次工作階段實際花費多少

代理式工具天生耗用大量 token：每個步驟都會重新傳送系統提示、任務歷史記錄和新的檔案內容。按照 Kunavo 的費率，實際數字如下：

可直接執行的計算：

# Kunavo Claude rates (USD per 1M tokens): (input, output)
RATES = {
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-5":   (1.40, 7.00),
}

def step_cost(model, in_tokens, out_tokens):
    i, o = RATES[model]
    return in_tokens / 1_000_000 * i + out_tokens / 1_000_000 * o

# One agentic step: the tool resends the task context + file reads.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task (edit, run, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

降低帳單的方法

1. 開始新任務，不要無限延長同一項任務。 工具每個步驟都會重新傳送完整對話，因此長時間執行的任務會產生二次方成本。新任務 = 新鮮、精簡的內容。
2. 依模式分流。 Kilo Code 支援為每種模式指定模型——Architect 使用 claude-opus-5、Code 使用 claude-sonnet-5、快速問題使用 claude-haiku-4-5。規劃只占 token 的一小部分，因此在此使用較強的模型，成本也很低。
3. 使用原生 Anthropic 路由以啟用快取。 快取輸入按輸入費率的 10% 計費——對於每個步驟都重新傳送固定前綴的迴圈來說，這是目前最大的可用節省方式（運作方式）。
4. 監控每個金鑰的支出。 為編輯器使用獨立金鑰，在控制面板中設定支出上限，並查看用量，了解代理式編碼一週實際花費多少。

常見問題