使用 Claude API 的 Roo Code——提供者設定與各模式模型

Roo Code 是適用於 VS Code 的開放原始碼自主程式碼代理——Cline 家族的分支，以其模式系統與每模式模型路由為特色。它不提供自有模型，因此需要 API 金鑰。本指南完整說明如何使用一把 sk-kn- 金鑰，以低於 Anthropic 牌價約 30% 的價格，在主要模型上於 Roo Code 中執行 Claude；如何使用設定檔，只在值得使用的地方花費強大模型的成本；工作階段的費用；以及相較於直接呼叫 Anthropic 的真實取捨。

Roo Code 為何需要 API 金鑰

Roo Code 的每個步驟——讀取檔案、寫入差異、執行指令、讀取結果——都是按 Token 計費的模型呼叫。claude.ai Pro 或 Max 訂閱不涵蓋這些費用：聊天方案與 API 存取是不同產品，而 Roo Code 會與 API 通訊。由於代理迴圈在每個步驟都會重新傳送不斷增長的工作上下文，每 Token 費率是工作階段成本最大的槓桿——這正是閘道的價值：從 $10 儲值起採隨用隨付，一把金鑰也能存取 GPT，且餘額永不過期。

設定——三個欄位

開啟 Settings → Providers，將 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 金鑰文件說明輪替與支出限制。如果 Roo Code 要求上下文視窗或輸出上限等模型中繼資料，請從模型頁面取得數值——設定過小的上下文視窗會使它提早截斷。

先用小型工作測試，再讓它編輯程式碼。此處的 401 幾乎總是金鑰問題；404 幾乎總是基礎 URL 或不存在的模型 slug——Kunavo 會精確比對 slug，不會為帶日期後綴的名稱建立別名，因此 claude-sonnet-4-5-20250929 會回傳 404，而 claude-sonnet-4-6 能成功解析。

模式與設定檔——成本槓桿

Roo Code 內建數個模式——Code、Architect、Ask 與 Debug——以及你自行定義的自訂模式。與成本相關的重點是，Roo Code 會儲存具名 API 設定檔，並記住你在每個模式中上次使用的設定檔。因此模型會成為模式的屬性，而不是你需要記得切換的設定：

# One API configuration profile per job, all on the same sk-kn- key.
# Roo Code remembers the profile you last used in each mode.

Profile "strong"         model claude-opus-5        -> bind to Architect and Debug
Profile "code-default"   model claude-sonnet-5      -> bind to Code mode
Profile "ask-cheap"      model claude-haiku-4-5     -> bind to Ask mode

這種配置有效的原因，在於各模式的 Token 特性大不相同。Architect 是少量但高度依賴推理的回合；模型品質決定接下來二十個步驟是否有效——只佔總 Token 的一小部分，因此強大模型的絕對成本很低。Code 包含許多機械式步驟，每一步都會重新傳送上下文，這正是每 Token 費率累積影響的地方。Ask 通常是一次性問題，完全不需要旗艦模型。

以下是實際計算：Opus 5 執行三個 Architect 步驟，加上 Sonnet 5 執行十七個 Code 步驟，約為 $1.06；全部使用 Sonnet 的執行則為 $0.87——多花約 23% 就能獲得明顯更好的規劃，而且遠低於全部使用 Opus 的成本。

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

Roo Code 也提供原生的 Anthropic 提供者，並具備自訂基礎 URL 欄位。將其指向 https://api.kunavo.com——只填origin，不要填 /v1，因為該用戶端會自行附加 /v1/messages——即可透過原生 Messages API 路由。此處貼上 /v1 格式會產生看似模型遺失的 404。

這條路由提供的是提示快取：cache_control會原樣傳遞，而快取輸入按輸入費率的 10% 計費（運作方式）。對於每一步都重新傳送固定前綴的迴圈，這是可取得的最大單項節省——比更換模型還大。兩條路由都可使用；OpenAI Compatible 更容易開始，兩者之間切換只需變更設定。

將哪個 Claude 模型綁定到哪個模式

這些模式全部使用同一把金鑰與同一個端點——只有模型 slug 不同，因此設定檔只需變更一個字。相對於 Anthropic 官方牌價的完整模型費率，請參閱Anthropic Claude API 價格表；即時目錄則位於價格頁面。

Roo Code 在 Kunavo 上 vs. 直接呼叫 Anthropic

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

容量這一列才是真正的取捨，應該坦白說明。如果你需要保證配額、合約 SLA 或與模型供應商建立採購關係，請直接使用——價格差異買到的就是這些。對使用 Roo Code 的個人開發者或小型團隊而言，取捨通常相反。

Roo Code 工作階段的實際成本

代理式工具天生耗用大量 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 Code-mode step: Roo 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 on the Code-mode default:
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# Architect mode on Opus 5 for 3 steps, Code mode on Sonnet 5 for 17:
print(3 * step_cost("claude-opus-5", 25_000, 1_200)
      + 17 * step_cost("claude-sonnet-5", 25_000, 1_200))   # -> ~$1.06

降低帳單的方法

1. 開始新工作，不要無限延長同一個工作。Roo Code 每一步都會重新傳送整段對話，因此長時間執行的工作成本會呈二次方增長。新工作代表全新且較小的上下文——這是此處槓桿最高的習慣。
2. 為每個模式綁定設定檔。前文已說明：這會將模型路由變成設定，而不是你在工作中途必須記得做的事。
3. 使用原生 Anthropic 路由進行快取。快取輸入按輸入費率的 10% 計費，對於每一步都重新傳送固定前綴的迴圈而言，這是最大的結構性節省。
4. 為編輯器使用有支出限制的專用金鑰。在控制台建立獨立金鑰，並在實際使用一週後查看使用量——這是唯一能誠實估算你實際成本的方法。

常見問題