Chuyển đến nội dung chính
Kilo Code là một agent lập trình AI mã nguồn mở có sẵn trên VS Code, JetBrains, CLI, Slack, và Cloud. Nó kết nối tới OrcaRouter thông qua Custom provider (provider tùy chỉnh) của nó (một endpoint tương thích OpenAI). Hướng dẫn này bao gồm cả tiện ích mở rộng VS Code (cách phổ biến nhất để dùng Kilo Code) lẫn CLI (@kilocode/cli, dùng cho chế độ không giao diện).
Giao thức: tương thích OpenAI
  • Base URL: https://api.orcarouter.ai/v1 (có chứa /v1)
  • ID model dùng định dạng vendor/model — đơn giản nhất là orcarouter/auto

Tiện ích mở rộng VS Code

  1. Cài đặt Kilo Code từ VS Code Marketplace (mở bảng Extensions và tìm “Kilo Code”), sau đó mở nó từ biểu tượng Kilo Code trên Activity Bar (dải biểu tượng bên trái). Trong bảng, nhấn vào ⚙ bánh răng (gear) ở góc trên bên phải để mở phần cài đặt.
Bảng Kilo Code với biểu tượng bánh răng cài đặt được làm nổi bật
  1. Vào Providers (provider). Dưới Popular providers (provider phổ biến), tìm Custom provider (provider tùy chỉnh) (“Add an OpenAI-compatible provider by base URL”) và nhấn + Connect.
Mục Custom provider trong phần cài đặt Providers của Kilo Code
  1. Điền các trường của provider:
    • Provider ID: orcarouter (chỉ chữ thường, số, dấu gạch ngang, hoặc dấu gạch dưới — không có dấu gạch chéo; orcarouter/auto sẽ bị từ chối tại đây).
    • Display name: OrcaRouter (tùy bạn đặt).
    • Base URL: https://api.orcarouter.ai/v1
    • API key: khóa OrcaRouter của bạn (sk-orca-...).
Provider ID, base URL, và API key của OrcaRouter trong Kilo Code
  1. Chọn các model của bạn. Khi khóa và base URL đã hợp lệ, Kilo Code sẽ lấy danh sách model trực tiếp từ OrcaRouter — tích chọn những model bạn muốn (hoặc Select all), rồi nhấn Submit. Để dùng định tuyến tự động, hãy thêm cả + Add model với ID model là orcarouter/auto (đây là một bí danh định tuyến, nên nó sẽ không xuất hiện trong danh sách được lấy về).
Trình chọn model của Kilo Code hiển thị các model được lấy từ OrcaRouter
  1. Provider giờ hiển thị dưới Connected providers (provider đã kết nối) với tên OrcaRouter (CUSTOM).
OrcaRouter được liệt kê dưới Connected providers trong Kilo Code
  1. Chọn model OrcaRouter trong trình chọn model của bảng chat và gửi một tin nhắn thử — một phản hồi sẽ xác nhận kết nối.
Kilo Code phản hồi qua OrcaRouter
Trên một kho lưu trữ lớn, Kilo Code có thể hỏi trước rằng có chờ hệ thống snapshot của nó khởi tạo hay không — chọn Disable for this project để bỏ qua nó (git vẫn theo dõi mọi thứ) để yêu cầu được gửi đi.
Plugin JetBrains dùng cùng Custom provider (provider tùy chỉnh) với các giá trị base URL / khóa / model giống hệt.

CLI

Để dùng ở chế độ không giao diện / theo kịch bản, hãy cài đặt CLI.

Cài đặt

npm install -g @kilocode/cli
Lệnh là kilo.

Cấu hình

Tệp cấu hình: ~/.config/kilo/kilo.jsonc (cũng chấp nhận kilo.json; ./kilo.jsonc ở cấp dự án sẽ ghi đè).
{
  "$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"
}
Thay bằng một model cụ thể nếu bạn thích, ví dụ anthropic/claude-opus-4.8 hoặc google/gemini-2.5-flash. ID model dùng định dạng vendor/model.

Chạy

echo "Reply with exactly: OK" | kilo run --auto --format json
Mong đợi: một sự kiện JSON với "type":"text""text":"OK".

Ghi chú

  • base_url chứa /v1.
  • Tham chiếu model dùng provider/model. Vì provider được đặt tên là orcarouter và ID model cũng mang một tiền tố vendor, nên tham chiếu có ba phân đoạn: orcarouter/orcarouter/auto (hoặc orcarouter/anthropic/claude-opus-4.8).
  • Chế độ không giao diện là kilo run "<prompt>" --auto (hoặc truyền prompt qua stdin). --format json cho ra một luồng sự kiện máy đọc được.
  • Suy luận/thinking: dùng cờ --variant <name> cho mức effort suy luận đặc thù theo provider (ví dụ high, max, minimal), và --thinking để hiển thị các khối thinking.
Vấn đề đã biết: --auto có các trường hợp được báo cáo là treo sau khi hoàn thành / khi khóa bị thiếu (kilocode issues). Hãy bọc bằng một timeout trong CI và đảm bảo khóa đã được nạp.