Cline 使用方法 — 將 Plan 與 Act 分配給不同模型，並計算單項任務費用

Cline 是一個能在 VS Code 等編輯器中執行的開放原始碼 AI 程式編寫代理。使用分為 3 個階段——安裝擴充功能、設定 API 提供者和金鑰（Cline 本身不包含模型）、先在 Plan 模式中制定計畫，再在 Act 模式中執行。費用取決於分配給 Plan 和 Act 的模型；開啟設定中的「Use different models for Plan and Act」，用同一把金鑰將 claude-opus-5 分配給 Plan、將 claude-haiku-4-5 分配給 Act，就能讓 20 步驟工作任務的費用從全部使用 Opus 5 的約 $2.17 降至約 $0.69（按 Kunavo 單價計算）。

許多日文解說文章只介紹到安裝和提出第一個請求，模型則固定使用免費模型或單一付費模型。本頁會進一步介紹——為 Plan 和 Act 分配不同模型，以及計算一個工作任務的費用——並以一把金鑰完成整個流程。

Cline 是什麼——Plan 和 Act 兩種模式

Cline 會持續執行一個循環：讀取檔案、提出差異、在終端機執行指令、讀取結果，再進行修正。它有兩種模式，Cline 官方文件將其區分如下。

• Plan 模式：讀取程式碼庫、搜尋並討論方針。不能變更檔案或執行指令。
• Act 模式：承接 Plan 中對話的上下文，變更檔案並執行指令。

這種區分也直接對應到費用區分。Plan 的往返較少，但其中決策的品質會影響後續十多個步驟。Act 的往返較多，而且每次都會重新傳送工作任務上下文，因此 Token 單價會累積。將強大的模型用於 Plan，將便宜的模型用於 Act——Cline 文件本身也建議，計畫使用推理能力強的模型，實作使用速度快的模型。

安裝與初始設定

1. 在 VS Code 開啟擴充功能檢視區（Ctrl / Cmd + Shift + X），搜尋「Cline」並安裝。Cursor、Windsurf、JetBrains IDE 等也可以安裝。
2. 開啟側邊欄中的 Cline，在設定（⚙︎）中將 API Provider 設為「OpenAI Compatible」。
3. 輸入 Base URL、API Key 和 Model ID，並填寫 Model Configuration 欄位（上下文長度、最大輸出、圖像支援、輸入與輸出單價）。

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1   # /v1 まで入れる
API Key        sk-kn-...                    # /app/keys で発行（表示は一度きり）
Model ID       claude-opus-5

Base URL 請輸入到 /v1 為止。Cline 會在其後追加路徑，因此缺少 /v1 會得到 404。若回傳 401，表示 URL 正確但金鑰錯誤。不要一開始就交給它編輯，先用「請說明這個檔案」之類的小型請求確認連線較安全。請在 /app/keys 建立金鑰；金鑰只顯示一次，因此要當場保存。

Model Configuration 中的 Input Price / Output Price 是 Cline 計算工作任務期間所顯示費用的依據。端點不會自動提供這些數值，因此留白或維持預設值會導致顯示費用偏差。請輸入所用模型每 1M Token 的單價。設定項目清單請參閱 Cline 整合文件。

為 Plan 和 Act 分配不同模型

在設定中勾選「Use different models for Plan and Act」後，就能分別選擇 Plan 和 Act 使用的模型。兩者使用相同的 Base URL 和金鑰，只需變更 Model ID 和單價。

[✓] Use different models for Plan and Act

── Plan Mode ─────────────────────────────
API Provider       OpenAI Compatible
Base URL           https://api.kunavo.com/v1
API Key            sk-kn-...
Model ID           claude-opus-5
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        3.50      # 1M トークンあたり USD
  Output Price       17.50

── Act Mode ──────────────────────────────
API Provider       OpenAI Compatible
Base URL           https://api.kunavo.com/v1
API Key            sk-kn-...            # Plan と同じキーでよい
Model ID           claude-haiku-4-5
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        0.70
  Output Price       3.50

將 Opus 5 用於 Plan 的理由很簡單。Plan 只占全部 Token 的很小一部分，但若在這裡判斷錯誤，Act 的步驟可能全部浪費。將 Haiku 4.5 用於 Act，是因為計畫具體後，剩下的只是反覆編輯與執行，而 Token 單價在這裡最有影響。

將 Plan 設為 Sonnet 5 時，每一步約為 $0.0434；若使用 Opus 5，則約為 $0.11。Claude Sonnet 5 的價格是每 100 萬 token $1.40 / $7.00。

如果 Act 卡住，就只針對該工作任務將 Act 使用的模型升級為 Opus 5。同一個錯誤重複 2 次，就是切換的訊號。試圖用 Haiku 硬撐而導致步驟數增加，最終反而會花費更多。只需在設定中變更一個 Model ID，金鑰和端點都維持不變。

計算一個工作任務的費用

Cline 每個步驟都會重新傳送系統提示、工作任務歷史和讀取的檔案，因此費用不是由時間，而是由步驟數決定。如同本網站其他價格頁面，這裡以每個步驟輸入 25,000 / 輸出 1,200 Token、一個工作任務 20 個步驟（Plan 3 + Act 17）計算。

將 Plan 和 Act 分開後，只需支付全部使用 Opus 5 時約 32%的費用，同時保留 Opus 5 的計畫品質。全部使用 Haiku 會更便宜，但考慮到計畫錯誤可能導致重做，差額 $0.26 作為 Plan 的保險費仍然划算。用於驗算的程式碼只有這些。

# 1 タスクの費用を、ステップ数から出す。
# 単価は Kunavo の 1M トークンあたり USD (input, output)。
RATES = {
    "claude-opus-5":    (3.50, 17.50),
    "claude-haiku-4-5": (0.70, 3.50),
}

def step(model, inp=25_000, out=1_200):
    i, o = RATES[model]
    return inp / 1e6 * i + out / 1e6 * o

all_opus = 20 * step("claude-opus-5")
split = 3 * step("claude-opus-5") + 17 * step("claude-haiku-4-5")

print(round(all_opus, 2))   # -> 2.17  全部 Opus 5
print(round(split, 2))      # -> 0.69  Plan = Opus 5 / Act = Haiku 4.5

如何選擇模型

當 GPT-5.6 Sol 的提示超過 272K Token 時，整個請求會按輸入 2 倍、輸出 1.5 倍計費。若用於 Plan，將 Context Window 設為低於 272K 較安全。若想更詳細了解 Opus 和 Sonnet 的差異，請參閱Claude Opus 與 Sonnet 的差異；Claude 全部模型的單價整理在Claude 價格中。

降低費用的 5 個習慣

1. 不要延長工作任務，分段建立新的工作任務。每個步驟都會重新傳送完整歷史，因此工作任務越長，每個步驟的費用越高。這是最有效的習慣。
2. 若要使用提示快取，請透過 Anthropic 提供者。將 API Provider 設為「Anthropic」，勾選「Use custom base URL」，並指定 https://api.kunavo.com（/v1 不要加上，客戶端會自行追加 /v1/messages）。Claude 的快取讀取費用是輸入單價的 10%，寫入費用是輸入單價的 1.25 倍。原理請參閱快取文件。
3. 將規則寫入 .clinerules/。這是放在專案根目錄的 Markdown 檔案，會對所有對話套用指示。由於它會包含在每次請求中，請保持簡短，只寫必要規則（Cline 規則文件）。
4. 只對讀取類操作啟用自動核准。在 Auto Approve 中允許讀取檔案等操作，可以減少確認次數。正如 Cline 文件明確指出，會自動核准所有操作的 YOLO 模式很危險，只應在可拋棄的環境中使用。變更可以透過 Checkpoints 還原。
5. 建立 Cline 專用金鑰，並設定每月上限。在 /app/keys 中，您可以為每把金鑰設定每月使用上限（達到後會回傳 402）和 IP 允許清單。想停止編輯器時，也只需停用該金鑰。

坦白說——適合使用訂閱或直接簽約的情況

如果您已訂閱 Claude Pro / Max，也可以選擇 Cline 的「Claude Code」提供者。這會透過已安裝的 Claude Code CLI 使用訂閱額度，而不是按 Token 計費。根據Cline 文件，此方式會限制圖像上傳和提示快取，回應也可能不會以 Token 為單位串流。使用額度上限與聊天及 Claude Code 共用，相關機制請參閱Claude Pro 限制。

若使用 API 金鑰，透過 Kunavo 的服務使用共用容量，且沒有專用配額，也沒有合約上的 SLA。需要保證的團隊應直接與 Anthropic 簽約。若是個人或小型團隊執行 Cline，使用一把金鑰分開 Plan 和 Act 的按量付費方式較合適。

與 Roo Code 使用方式的差異

Roo Code 是從 Cline 衍生的擴充功能，可直接使用 OpenAI Compatible 設定（Base URL、金鑰和模型）。差異在於模式結構：它不是 Plan / Act，而是 Architect、Code、Ask、Debug 等模式，並為每個模式指派 API 設定檔。將 Opus 5 用於 Architect、便宜模型用於 Code 的相同思路也適用。操作步驟請參閱Roo Code 設定文件和Roo Code + Claude API（英文）。

更詳細的英文說明請參閱Cline + Claude API 指南；若要與終端機型代理比較，請參閱Cline 與 Claude Code 的比較和Claude Code 使用方式；所有模型的單價請參閱價格頁面。

常見問題