Skip to Content
aicentos

Kilo CLI

在 Kilo 命令列工具中透過設定檔接入 aicentos

最後更新於:

Kilo CLI 透過一份 JSON / JSONC 設定檔宣告 Provider 與模型,支援用 @ai-sdk/openai-compatible 指向任意 OpenAI 相容端點,因此可以直接接入 aicentos。

準備工作

先在控制台「API Key」頁面為命令列建立一個專用 Key(建議命名 kilo-cli)。

同時確認已全域安裝 Kilo CLI:

npm install -g @kilocode/cli

需要填寫的設定

欄位值
Provider 套件(npm)@ai-sdk/openai-compatible
options.baseURLhttps://aicentos.com/v1
options.apiKey控制台建立的 Key(可用 {env:VAR} 引用)
模型引用(頂層 model)provider/model 形式,如 aicentos/gpt-5
limit.context / limit.output按所選模型填寫

設定步驟

  • 新建或編輯全域設定檔:
    • ~/.config/kilo/kilo.json(或 kilo.jsonc);設定了 XDG_CONFIG_HOME 時以該目錄為準。
    • 專案級 ./kilo.jsonc 會覆蓋全域設定的同名項。
  • 寫入以下內容:
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "aicentos/gpt-5",
  "provider": {
    "aicentos": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "aicentos",
      "options": {
        "baseURL": "https://aicentos.com/v1",
        "apiKey": "{env:AICENTOS_API_KEY}"
      },
      "models": {
        "gpt-5": {
          "name": "GPT-5",
          "limit": { "context": 128000, "output": 16384 }
        }
      }
    }
  }
}
  • 匯出環境變數:
export AICENTOS_API_KEY="sk-你的aicentos密钥"
  • 在專案目錄下執行 kilo,或在互動介面裡用 /model 切換模型。

測試

啟動後先用一句簡單提示詞輕量測試,確認能正常回傳結果再正式使用。

注意事項

  • options.baseURL 只填到 https://aicentos.com/v1,不要補成完整的 /v1/chat/completions。
  • {env:VAR} 這套環境變數替換語法只在全域設定檔中生效;專案級 kilo.jsonc 出於安全考慮不會解析 {env:...}。
  • 自訂模型必須顯式宣告 limit.context 與 limit.output,否則上下文長度按 0 處理,自動壓縮會失效。
  • 如果閘道不提供 /v1/models 清單介面,自動探測模型會失敗,按上面的寫法手動宣告即可。
  • 更多說明見文件站:https://docs.aicentos.com