メインコンテンツへスキップ
Kilo Code は、VS Code、JetBrains、CLI、Slack、Cloud で利用できるオープンソースの AI コーディングエージェントです。Custom 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 マーケットプレイスから Kilo Code をインストールし（拡張機能パネルを 開いて「Kilo Code」を検索）、アクティビティバー（左端のアイコン列）の Kilo Code アイコンから開きます。パネル内で右上の ⚙ 歯車をクリックして設定を開きます。
設定の歯車がハイライトされた Kilo Code パネル
  1. Providers（プロバイダー）へ移動します。Popular providers（人気のプロバイダー） の下で Custom provider（カスタムプロバイダー）（「Add an OpenAI-compatible provider by base URL」）を見つけ、+ Connect をクリックします。
Kilo Code の Providers 設定にある Custom provider の項目
  1. プロバイダーのフィールドを入力します:
    • 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 キー
  1. モデルを選択します。キーと base URL が有効になると、Kilo Code は OrcaRouter から 稼働中のモデル一覧を取得します — 使いたいものにチェックを入れ（または Select all）、 Submit をクリックします。自動ルーティングを使うには、さらに + Add model で モデル ID orcarouter/auto を追加します（これはルーティングのエイリアスなので、 取得された一覧には表示されません）。
OrcaRouter から取得したモデルを表示する Kilo Code のモデルピッカー
  1. プロバイダーが **Connected providers（接続済みプロバイダー）**の下に OrcaRouter (CUSTOM) として表示されるようになります。
Kilo Code の Connected providers に一覧表示された OrcaRouter
  1. チャットパネルのモデルピッカーで OrcaRouter モデルを選択し、テストメッセージを 送信します — 返信があれば接続が確認できます。
OrcaRouter 経由で返信する Kilo Code
大きなリポジトリでは、Kilo Code がまずスナップショットシステムの初期化を待つかどうかを 尋ねることがあります — リクエストを通すには **Disable for this project（このプロジェクト では無効化）**を選んでスキップしてください（git は引き続きすべてを追跡します）。
JetBrains プラグインは、同一の base URL / キー / モデルの値で同じ **Custom provider （カスタムプロバイダー）**を使用します。

​
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 を使います。プロバイダー名が orcarouter で、モデル ID にも vendor プレフィックスが付くため、参照は 3 セグメントになります: orcarouter/orcarouter/auto（または orcarouter/anthropic/claude-opus-4.8）。
  • ヘッドレスモードは kilo run "<prompt>" --auto です（またはプロンプトを stdin 経由でパイプします）。--format json で機械可読のイベントストリームが得られます。
  • Reasoning/thinking: プロバイダー固有の reasoning エフォートには --variant <name> フラグ（例: high、max、minimal）を、思考ブロックを表示するには --thinking を使います。
既知の問題: --auto には、完了後やキーが欠けている場合にハングする報告例が あります (kilocode issues)。CI では timeout でラップし、キーが読み込まれていることを確認してください。