跳轉到主要內容
Kilo Code 是一款開源 AI 編碼代理，可在 VS Code、JetBrains、CLI、Slack 與 Cloud 中使用。它透過其 Custom provider（自訂 provider）（一個 OpenAI 相容端點）連接 OrcaRouter。本指南同時涵蓋 VS Code 擴充功能（使用 Kilo Code 最常見的方式）與 CLI （@kilocode/cli，用於無介面情境）。
協定：OpenAI 相容
  • Base URL： https://api.orcarouter.ai/v1（保留 /v1）
  • 模型 ID 使用 vendor/model 格式——最簡單的選擇是 orcarouter/auto

​
VS Code 擴充功能

  1. 從 VS Code Marketplace 安裝 Kilo Code（開啟 Extensions 面板 並搜尋「Kilo Code」），然後從 活動列（Activity Bar）中的 Kilo Code 圖示（左側圖示列）開啟它。在面板中，點擊右上角的 ⚙ 齒輪 以開啟設定。
Kilo Code 面板，已醒目標示設定齒輪
  1. 前往 Providers（提供方）。在 Popular providers（熱門提供方） 下，找到 Custom provider（自訂 provider） （「Add an OpenAI-compatible provider by base URL」），然後點擊 + Connect。
Kilo Code 的 Providers 設定中的 Custom provider 項目
  1. 填寫 provider 欄位：
    • Provider ID：orcarouter（僅限小寫字母、數字、連字號或 底線——不可有斜線；orcarouter/auto 在此會被拒絕）。
    • Display name：OrcaRouter（可任意填寫）。
    • Base URL：https://api.orcarouter.ai/v1
    • API key：你的 OrcaRouter 密鑰（sk-orca-...）。
Kilo Code 中的 OrcaRouter provider ID、base URL 與 API key
  1. 選擇你的模型。一旦密鑰與 base URL 有效，Kilo Code 會 從 OrcaRouter 取得即時的模型清單——勾選你想要的模型（或 Select all）， 然後點擊 Submit。若要使用自動路由，還需 + Add model，填入 模型 ID orcarouter/auto（它是路由別名，因此不會出現 在取得的清單中）。
Kilo Code 模型選擇器，顯示從 OrcaRouter 取得的模型
  1. 該 provider 現在會以 OrcaRouter (CUSTOM) 顯示在 Connected providers（已連接的提供方） 下。
OrcaRouter 列於 Kilo Code 的 Connected providers 下
  1. 在聊天面板的模型選擇器中選取 OrcaRouter 模型並送出一則 測試訊息——收到回覆即確認連線成功。
Kilo Code 透過 OrcaRouter 回覆
在大型儲存庫上，Kilo Code 可能會先詢問是否要等待其快照 系統初始化——選擇 Disable for this project（停用於此專案） 以略過它（git 仍會 追蹤所有內容），讓請求得以送出。
JetBrains 外掛使用相同的 Custom provider（自訂 provider），並採用相同的 base URL／密鑰／模型值。

​
CLI

對於無介面／指令稿情境，請安裝 CLI。

​
安裝

npm install -g @kilocode/cli
指令為 kilo。

​
設定

設定檔：~/.config/kilo/kilo.jsonc（也接受 kilo.json；專案層級的 ./kilo.jsonc 會覆寫）。 
{
  "$schema": "https://app.kilo.ai/config.json",
  "provider": {
    "orcarouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OrcaRouter",
      "options": { "baseURL": "https://api.orcarouter.ai/v1", "apiKey": "sk-orca-..." },
      "models": { "orcarouter/auto": { "name": "OrcaRouter Auto" } }
    }
  },
  "model": "orcarouter/orcarouter/auto"
}
若你偏好，可換成特定模型，例如 anthropic/claude-opus-4.8 或 google/gemini-2.5-flash。模型 ID 使用 vendor/model 格式。

​
執行

echo "Reply with exactly: OK" | kilo run --auto --format json
預期結果：一則含 "type":"text" 與 "text":"OK" 的 JSON 事件。

​
注意事項

  • base_url 保留 /v1。
  • 模型參照使用 provider/model。由於 provider 名為 orcarouter，而模型 ID 本身也帶有 vendor 前綴，因此參照為三段式：orcarouter/orcarouter/auto（或 orcarouter/anthropic/claude-opus-4.8）。
  • 無介面模式為 kilo run "<prompt>" --auto（或透過 stdin 傳入提示）。--format json 會提供機器可讀的事件串流。
  • 推理／思考（Reasoning/thinking）： 使用 --variant <name> 旗標設定 provider 專屬的推理 effort（例如 high、max、minimal），並以 --thinking 顯示思考區塊。
已知問題： --auto 有回報案例會在完成後／或在 密鑰缺失時卡住 （kilocode issues）。請在 CI 中以 timeout 包裹，並確保密鑰已載入。