RealRelay.ai
程式碼代理

Kilo Code 設定指南

把 RealRelay.ai 設為 VS Code 中的 Kilo Code 與 Kilo CLI 的自訂 OpenAI 相容供應商:新增供應商、設定 token 上限、檢查連線並切換模型。

建立 API 密鑰瀏覽模型目錄
協定
OpenAI Chat Completions · OpenAI Responses
基礎位址
https://www.realrelay.ai/v1
官方文件
kilo.ai
已對照工具官方文件核對
2026-10
實驗性. 尚未在 RealRelay.ai 上完整端對端測試。步驟依據該工具的官方文件；若某一步失敗，請附上錯誤訊息聯絡支援。

概覽

Kilo Code 是一個開源程式碼代理。它可以作為 VS Code 擴充功能執行,也可以作為終端機應用程式 Kilo CLI 執行;目前的擴充功能建構在 CLI 之上,並與它共用設定。你以 OpenAI Compatible API 把 RealRelay.ai 加為自訂供應商後,Kilo 會把請求送到 Chat Completions 端點 /v1/chat/completions。

  • 一組 API 金鑰,在主控台的 API 金鑰頁面取得。

  • 結尾要含 /v1 的基礎位址。Kilo 會在後面加上 /chat/completions。

  • 一個模型 ID,完全依照 GET /v1/models 列出的寫法,例如 z-ai/glm-5.2。該模型必須支援工具呼叫。

本指南屬實驗性質:內容依據 Kilo 的文件撰寫,但尚未在 RealRelay.ai 上完整端對端跑過。自訂供應商表單中沒有 token 上限的欄位,所以下方有一個步驟需要手動編輯設定檔。

安裝

  1. 1

    開啟擴充功能

    按 Ctrl+Shift+X(macOS 上為 Cmd+Shift+X),然後搜尋「Kilo Code」。

  2. 2

    安裝目前版本

    點選 Install 旁的箭頭,並選擇 Install Pre-Release Version。Kilo 透過這個 Marketplace 通道發布目前的擴充功能,並建議所有人都使用它。

使用 Open VSX Registry 的編輯器(例如 VSCodium),可以在擴充功能檢視中以同樣的名稱找到 Kilo Code。你也可以從 Kilo 的 GitHub releases 下載 .vsix,再使用 Install from VSIX…。

npm
npm install -g @kilocode/clikilo --version

如果 kilo --version 印出版本號,就代表安裝成功。

設定

  1. 1

    開啟自訂供應商表單

    在 Kilo Code 中開啟 Settings(齒輪圖示),前往 Providers 分頁,捲到最下方並點選 Custom provider。

  2. 2

    填寫欄位

    基礎位址與金鑰有效時,Kilo 會從 RealRelay.ai 取得模型清單。只選取你打算使用的模型,或手動輸入 ID。然後點選 Submit。

    Kilo Code → Settings → Providers → Custom provider
    1Provider ID:   realrelay2Display name:  RealRelay.ai3Provider API:  OpenAI Compatible4Base URL:      https://www.realrelay.ai/v15API key:       sk-***6Models:        z-ai/glm-5.2
  3. 3

    在設定檔中加入 token 上限

    Kilo 會把供應商儲存在它的全域設定中。開啟 ~/.config/kilo/kilo.jsonc(或同一資料夾中的 kilo.json),找到 provider.realrelay.models,並為每個模型加上上限:

    ~/.config/kilo/kilo.jsonc → provider.realrelay.models
    1"z-ai/glm-5.2": {2  "name": "z-ai/glm-5.2",3  "tool_call": true,4  "limit": {5    "context": 200000,6    "output": 320007  }8}
  1. 1

    把金鑰存進環境變數

    設定會從 REALRELAY_API_KEY 讀取金鑰,所以檔案本身不含任何機密。

    ~/.zshrc · ~/.bashrc
    export REALRELAY_API_KEY="sk-***"
    Windows PowerShell
    [Environment]::SetEnvironmentVariable("REALRELAY_API_KEY", "sk-***", "User")
  2. 2

    在 kilo.jsonc 中新增供應商

    編輯後請重新啟動 CLI。專案資料夾中的 kilo.jsonc 會覆寫全域檔案。

    ~/.config/kilo/kilo.jsonc
    1{2  "$schema": "https://app.kilo.ai/config.json",3  "provider": {4    "realrelay": {5      "npm": "@ai-sdk/openai-compatible",6      "name": "RealRelay.ai",7      "env": ["REALRELAY_API_KEY"],8      "options": {9        "baseURL": "https://www.realrelay.ai/v1"10      },11      "models": {12        "z-ai/glm-5.2": {13          "name": "z-ai/glm-5.2",14          "tool_call": true,15          "limit": {16            "context": 200000,17            "output": 3200018          }19        }20      }21    }22  },23  "model": "realrelay/z-ai/glm-5.2"24}

  • Provider ID(realrelay)是你為這個供應商取的名稱。只能使用小寫字母、數字、連字號與底線。模型參照以它開頭,例如 realrelay/z-ai/glm-5.2。

  • Provider API 選 OpenAI Compatible,等同於檔案中的 "npm": "@ai-sdk/openai-compatible"。兩者都會送出 Chat Completions 請求。

  • limit.context 是模型的上下文視窗,limit.output 是它的最大輸出量。沒有設定時兩者都會被視為 0:Kilo 會關閉自動壓縮,並把輸出上限定為 32,000 token。

  • env 指定存放金鑰的變數名稱。在 VS Code 中,你輸入的金鑰會與設定檔分開儲存。

驗證

  1. 1

    直接呼叫端點

    用你的金鑰執行這段指令。若收到含 choices 陣列的 JSON 回覆,就代表位址、金鑰與模型都沒問題。

    Terminal
    1curl -sS "https://www.realrelay.ai/v1/chat/completions" \2  -H "Authorization: Bearer sk-***" \3  -H "content-type: application/json" \4  -d '{"model": "z-ai/glm-5.2", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with OK"}]}'
  2. 2

    在 VS Code 中檢查

    RealRelay.ai 現在應該出現在已連線的供應商中。在模型選單中選擇它的某個模型,並送出一則簡短訊息。該請求會出現在主控台的用量日誌中。

  3. 3

    在 CLI 中檢查

    第一個指令應會把你的模型列為 realrelay/…。第二個指令會送出一則訊息並印出回覆。

    Terminal
    kilo models realrelaykilo run -m "realrelay/z-ai/glm-5.2" "Reply with OK"

模型

在 VS Code 中,請在模型選單中選擇模型。要新增或移除模型,請在 Providers 分頁中點選 RealRelay.ai 旁的 Edit provider。在 CLI 中,請使用 /models,或以 kilo -m 加上 realrelay/ 與模型 ID 啟動。你新增的每個模型都需要自己的 limit 項目。

這些範例中的上限是安全的起始值。請設為模型目錄頁面上的實際數字。

少數 OpenAI 模型是在 Responses 端點 /v1/responses 上提供。請以 OpenAI Responses API 把它們加為第二個自訂供應商,其他模型則繼續使用第一個供應商:

Kilo Code → Settings → Providers → Custom provider
1Provider ID:   realrelay-responses2Display name:  RealRelay.ai (Responses)3Provider API:  OpenAI Responses4Base URL:      https://www.realrelay.ai/v15API key:       sk-***6Models:        openai/gpt-5.3-codex
~/.config/kilo/kilo.jsonc → provider
1"realrelay-responses": {2  "npm": "@ai-sdk/openai",3  "name": "RealRelay.ai (Responses)",4  "env": ["REALRELAY_API_KEY"],5  "options": { "baseURL": "https://www.realrelay.ai/v1" },6  "models": {7    "openai/gpt-5.3-codex": {8      "name": "openai/gpt-5.3-codex",9      "tool_call": true,10      "limit": { "context": 400000, "output": 128000 }11    }12  }13}

哪些模型適合代理使用、哪些模型由 Responses 端點提供,請見選擇模型。

疑難排解

  • 輸入基礎位址後沒有出現任何模型。URL 或金鑰錯誤,導致取得模型失敗。請修正後點選 Fetch models,或手動輸入模型 ID。

  • 「Invalid API Key」或 401。請在供應商表單中重新輸入金鑰。在 CLI 中,請確認啟動 kilo 的終端機中已設定 REALRELAY_API_KEY,並檢查已儲存的憑證:

    Terminal
    kilo auth list

  • 404。基礎位址缺少 /v1,或路徑有拼字錯誤。請使用以 /v1 結尾的位址。

  • 「Model Not Found」。模型 ID 必須與 GET /v1/models 傳回的完全相同,包括斜線之前的部分。

  • 對話不斷變長,直到請求被拒絕。該模型沒有 limit.context,所以壓縮功能是關閉的。請依「設定」一節加上上限。

  • 回覆中斷,並出現回應可能不完整的警告。模型已達到 limit.output。請調高,但不超過模型的實際最大值。

  • Responses 供應商底下的模型出現錯誤。只有「選擇模型」中列出的模型在 /v1/responses 上提供。請把其他模型移回 OpenAI Compatible 供應商。