Kilo CLI
Kilo コマンドラインツールで設定ファイルを使って aicentos に接続する
最終更新:
Kilo CLI は JSON / JSONC の設定ファイルで Provider とモデルを宣言し、@ai-sdk/openai-compatible で任意の OpenAI 互換エンドポイントに接続できるため、aicentos に直接接続できます。
準備
まずコンソールの「API Key」ページで CLI 用の専用キーを作成します(名前は kilo-cli がおすすめです)。
- コンソール:https://aicentos.com
- キーの作成: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 | コンソールで作成したキー({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