使用 Claude API 的 Kilo Code——base URL、模型與成本（也適用於 Cline 和 Roo Code）

Kilo Code、Cline 和 Roo Code 是 VS Code 中最常用的開源程式開發代理，三者都支援自訂的 OpenAI 相容端點。也就是說，你可以在編輯器中執行 Claude，只需一把 sk-kn- 金鑰；主要模型的價格比 Anthropic 官方定價低約 30%。本指南介紹各工具的三個設定欄位、如何依任務類型選擇 Claude 模型、一次代理式程式開發工作階段的實際成本，以及如何從巴西透過 Pix 付款，無需國際信用卡。

為什麼這些工具需要 API 金鑰

Kilo Code、Cline 和 Roo Code 本身都不內建任何模型：每個操作（讀取檔案、提出修改建議、執行指令、檢查結果）都是按 token 計費的 API 呼叫。Claude Pro 之類的聊天訂閱不涵蓋這些呼叫——你需要直接存取 API。Kunavo 正是為此而設：儲值 $10 起即可按用量付費，一把金鑰即可使用 Claude 和 GPT，餘額永不過期，並支援從巴西透過 Pix 或信用卡付款（延遲、LGPD 和發票的完整說明請參閱巴西 Claude API 指南）。由於代理式迴圈會在每一步重新傳送上下文，因此每 token 的費率是調整一次工作階段成本的首要因素。

三個欄位（適用於這三種工具）

這三個擴充功能共用同一種 provider 模型——Kilo Code 和 Roo Code 是 Cline 系列的分支，因此設定完全相同：

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

在註冊並儲值 $10 後，於控制台建立金鑰——金鑰只顯示一次，請立即儲存。

配置 Kilo Code

1. 從 VS Code marketplace 安裝 Kilo Code，然後開啟側邊欄中的面板。
2. 開啟擴充功能設定（齒輪圖示），進入 Providers 區段。
3. 將 API Provider 保持為 OpenAI Compatible。
4. 基礎 URL：https://api.kunavo.com/v1 · API 金鑰：你的 sk-kn-… · 模型：claude-sonnet-5。
5. 儲存設定，並先用一個簡單請求（「解釋此檔案」）進行測試，然後再讓工具編輯程式碼。

Kilo Code 允許每種模式使用不同模型（Architect / Code / Debug），便於將規劃交給更強的模型、將執行交給更便宜的模型。

配置 Cline

1. 安裝 Cline 並開啟其面板。
2. 點選設定齒輪，在 API Provider 中選擇 OpenAI Compatible。
3. 填寫相同的三個值：基礎 URL https://api.kunavo.com/v1、你的金鑰以及 model ID claude-sonnet-5。
4. 如果 Cline 要求填寫模型中繼資料（上下文視窗、輸出上限），請使用模型頁面中的數值。

配置 Roo Code

與另外兩個工具相同：Settings → Providers → API Provider → OpenAI Compatible，然後填寫基礎 URL https://api.kunavo.com/v1、金鑰和 model ID。Roo Code 的模式系統（Code / Architect / Ask / Debug）也支援每種模式使用一個模型。

這三個工具也都提供原生的 Anthropic 供應商選項，並支援自訂基底 URL。指向 https://api.kunavo.com 後，就會使用原生的 Messages API（/v1/messages）——這個方式值得考慮，因為 cache_control 會直接傳遞，而快取輸入按輸入費率的 10% 計費（請參閱提示詞快取文件）。兩種方式都可行；與 OpenAI 相容的方式最容易上手。

從巴西付款——Pix，無須國際信用卡

令大多數巴西開發人員受阻的不是設定，而是付款：直接向 Anthropic 支付 API 費用，需要啟用海外交易功能的國際信用卡。在 Kunavo，付款由 Stripe 處理，對於從巴西付款的使用者，Pix 會顯示為付款方式——金額以巴西雷亞爾顯示並立即入帳，不需要依賴國際信用卡。國際信用卡（Visa、Mastercard、American Express）、Apple Pay、Google Pay 和 Link 也都能正常使用。

每個 token 的費率以 USD 設定：使用 Pix（以及結帳頁面以巴西雷亞爾顯示時使用信用卡）時，Stripe 會在您確認前顯示巴西雷亞爾換算金額，該費率包含由買家支付的 2–4% 換匯成本；若選擇以美元支付信用卡款項，這項成本會消失，換匯則按照發卡行匯率進行（請在銀行應用程式中確認 IOF 與國際交易費）——Pix 儲值的逐步說明請參閱使用 Pix 支付 API 的指南。這是預付錢包：最低儲值金額為 $10，無月費，且餘額永遠不會過期——因此一個月沒有進行程式設計不會產生任何費用，與訂閱方案不同。

應選擇哪個 Claude 模型？

模型欄位只是同一端點上的一個 slug：切換模型只需更改一個詞，無需新的金鑰，也無需新的供應商。完整費率請參閱Claude API 價格指南和價格頁面。

一次工作階段的實際成本

代理式工具的設計會消耗大量 token：每一步都會重新傳送系統提示詞、任務歷史紀錄和檔案上下文。以下是按 Kunavo 費率計算的合理估算數字：

也就是說，透過 Pix 儲值 $10，在 Sonnet 5 上大約可以完成 11 個 20 步代理式任務。你可以自行按以下方式計算：

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

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

# Um passo do agente: a ferramenta reenvia o contexto + os arquivos lidos.
print(custo_passo("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# Uma tarefa realista de 20 passos (editar, rodar, corrigir, repetir):
print(20 * custo_passo("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

相同內容使用葡萄牙語時，消耗的 token 比英語多約 10–20%——提示詞和程式碼註解使用葡萄牙語時，值得將這點納入考量。

如何降低帳單

1. 開啟新任務，不要一直延長同一個任務。 工具會在每一步重新傳送完整對話：無止境的任務會讓成本以平方級數成長。新任務 = 較短的上下文。
2. 按模式路由。Kilo Code 和 Roo Code 支援每種模式使用一個模型——Architect 使用 claude-opus-5、Code 使用 claude-sonnet-5、快速問題使用 claude-haiku-4-5。
3. 使用原生 Anthropic 路由來啟用快取。 快取輸入按原費率的 10% 計費——在每一步都重新傳送固定前綴的迴圈中，這是最能節省成本的方式（運作方式）。
4. 按金鑰追蹤支出。 為編輯器配置專用金鑰，並在儀表板中設定支出上限，再到用量面板查看一週代理式程式開發的實際成本。

常見問題