使用 Claude API 搭配 Cline — 基礎 URL 設定、Plan/Act 模型路由與實際費用

Cline是 VS Code 的開放原始碼自主程式碼代理程式，本身不附帶模型 — 您需要連接一個模型，通常使用自己的 API 金鑰。本指南提供透過一個 sk-kn- 金鑰在 Kunavo 上執行Cline 中的 Claude的確切設定；主流模型的價格約比 Anthropic 官方定價低 30%：包括兩條供應商路由、如何利用 Plan/Act 模式降低帳單、實際工作階段的成本，以及相較於直接呼叫 Anthropic 必須放棄什麼的坦率說明。

Cline 為何需要 API 金鑰

Cline 採取的每個動作 — 讀取檔案、提出差異、執行終端機命令、讀取輸出並再次嘗試 — 都是一次模型呼叫。Cline 可以透過Claude Code 供應商使用Claude Pro 或 Max 訂閱執行這些呼叫；該供應商會驅動 Claude CLI，使用您的訂閱額度而非 API 計費 — 其中包括 Cline 文件截至 2026 年 9 月列出的取捨：回應可能不會逐 token 串流，且圖片上傳和提示快取受到限制。其他所有路由，包括本指南設定的 OpenAI Compatible 和 Anthropic 供應商，都會透過 API 金鑰按 token 計費。在這些路由上，問題不是是否要按 token 付費，而是要以什麼費率付費；由於代理程式迴圈會在每個步驟重新傳送不斷增長的工作上下文，每 token 費率是決定工作階段成本的最大槓桿。這就是此處使用閘道的全部理由：從 $10 儲值開始隨用隨付，一個同時可連接 GPT 的金鑰，以及永不過期的餘額。

設定——三個欄位

開啟 Cline 面板，點選設定齒輪，並將 API provider 設為OpenAI Compatible。三個值：

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

在控制面板中完成註冊並儲值後建立金鑰 — 金鑰只會顯示一次，因此請立即儲存。金鑰管理、輪替和支出限制請參閱Claude API 金鑰文件。如果 Cline 要求模型中繼資料，例如上下文視窗或輸出上限，請從模型頁面取得數字，不要猜測 — 低估上下文視窗會使 Cline 比必要時間更早截斷。

在允許它編輯任何內容前，先要求它完成小事（「說明這個檔案」）以確認連線。此時的 401 幾乎總是金鑰問題；404 幾乎總是基礎 URL 或不存在的模型 slug — Kunavo 嚴格比對 slug，不會為附日期的名稱建立別名，因此 claude-sonnet-4-5-20250929 會產生 404，而 claude-sonnet-4-6 可以解析。

Plan 模式與 Act 模式 — 最省錢的分工

Cline 的特色在於將Plan（讀取程式碼庫、提出問題、建議方法）與Act（進行編輯、執行命令）分開，並讓您為兩者設定不同模型。這幾乎完美對應成本，因為兩種模式具有非常不同的 token 特徵：

• Plan 簡短且著重推理。少量回合中，模型品質決定接下來二十個步驟是有效還是浪費。請在此使用 claude-opus-5 — 它只占少部分 token，因此較強模型的絕對成本很低。
• Act 漫長且機械化。許多步驟，每一步都會重新傳送上下文。這正是每 token 費率複合增加的地方，因此應在此使用較便宜的 Sonnet — 今日在 Kunavo 為 claude-sonnet-5。

以下成本章節列出了計算結果：在 Opus 5 上規劃三個步驟、在 Sonnet 5 上執行十七個步驟，成本約為 $1.06，而全程使用 Sonnet 的成本為 $0.87 — 為了顯著更好的規劃，成本約增加 23%，而且遠低於整項工作都使用 Opus。

原生 Anthropic 路由（以及你可能想使用它的原因）

Cline 也提供原生的Anthropic供應商，並附有自訂基礎 URL 欄位。將其指向 Kunavo 後，會使用原生的Messages API（/v1/messages），而不是 OpenAI 相容端點：

API Provider   Anthropic
Base URL       https://api.kunavo.com   # origin only — the client appends /v1/messages
API Key        sk-kn-...
Model ID       claude-sonnet-5

請注意兩條路由的基礎 URL 不同。OpenAI 相容供應商需要 https://api.kunavo.com/v1；Anthropic 供應商需要不含路徑的 origin https://api.kunavo.com，因為該用戶端會自行附加 /v1/messages。將 /v1 形式貼入 Anthropic 供應商，會產生看似找不到模型的 404。

原生路由帶來的是提示快取：cache_control會原樣傳遞，快取輸入按輸入費率的 10% 計費（請參閱提示快取文件）。在每一步都重新傳送穩定前綴的迴圈中，這是可用的最大節省 — 比更換模型還大。兩條路由都能運作；OpenAI 相容路由較容易開始，日後切換只需修改設定。

應設定哪個 Claude 模型

切換模型欄位只需改一個字 — 相同金鑰、相同供應商設定、相同端點。相對於 Anthropic 官方定價的完整各模型費率，請參閱Anthropic Claude API 價格表；即時目錄位於定價頁面。

Cline 使用 Kunavo 與直接呼叫 Anthropic 的比較

誠實的比較，也包含直接使用何時更適合：

請依照原文解讀該容量列。如果您的團隊需要保證配額、合約 SLA 或與模型供應商建立採購關係，請直接使用 — 您支付差額就是為了這些服務。對於使用 Cline 的個人開發者或小型團隊而言，通常情況正好相反。

Cline 工作階段的實際成本

代理式工具天生耗用大量 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),
    "claude-opus-5":     (3.50, 17.50),
}

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 Act-mode step: Cline resends the task context plus the files it read.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task (edit, run, read the error, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# The same task planned on Opus 5, executed on Sonnet 5:
print(3 * step_cost("claude-opus-5", 25_000, 1_200)
      + 17 * step_cost("claude-sonnet-5", 25_000, 1_200))   # -> ~$1.06

降低帳單的方法

1. 請開始新的工作，而不是無限延長同一項工作。Cline 會在每一步重新傳送整段對話，因此長時間執行的工作成本會以二次方增長。新的工作就是全新且較小的上下文 — 這是清單中槓桿最大的習慣。
2. 在不同模型之間分配 Plan 和 Act。上文已說明：這是設定欄位，而不是自律問題。
3. 使用原生 Anthropic 路由進行快取。快取輸入按輸入費率的 10% 計費，對於每一步都重新傳送固定前綴的迴圈而言，這是最大的結構性節省。
4. 為編輯器提供受支出限制的專用金鑰。在控制面板中建立獨立金鑰，為其設定每月支出上限，並查看用量 — 一週真實的代理程式編碼，才是估算對您成本的唯一誠實方式。該限制會在每次請求前檢查，並於每個月曆月重設；金鑰也可單獨撤銷，因此停止編輯器只需一個動作，無須輪替所有內容。
5. 仍在兩種工具之間猶豫嗎？Cline 與 Claude Code比較的是計費形式，而非功能列表 — 兩者都使用同一端點，因此選擇仍可逆。

常見問題