Kilo CLI
在 Kilo 命令列工具中透過設定檔接入 aicentos
最後更新於:
Kilo CLI 透過一份 JSON / JSONC 設定檔宣告 Provider 與模型,支援用 @ai-sdk/openai-compatible 指向任意 OpenAI 相容端點,因此可以直接接入 aicentos。
準備工作
先在控制台「API Key」頁面為命令列建立一個專用 Key(建議命名 kilo-cli)。
- 控制台:https://aicentos.com
- 建立 Key:https://aicentos.com/keys
- 錢包儲值:https://aicentos.com/wallet
同時確認已全域安裝 Kilo CLI:
npm install -g @kilocode/cli需要填寫的設定
| 欄位 | 值 |
|---|---|
Provider 套件(npm) | @ai-sdk/openai-compatible |
options.baseURL | https://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