Skip to Content
aicentos

Kilo CLI

Kilo コマンドラインツールで設定ファイルを使って aicentos に接続する

最終更新:

Kilo CLI は JSON / JSONC の設定ファイルで Provider とモデルを宣言し、@ai-sdk/openai-compatible で任意の OpenAI 互換エンドポイントに接続できるため、aicentos に直接接続できます。

準備

まずコンソールの「API Key」ページで CLI 用の専用キーを作成します(名前は kilo-cli がおすすめです)。

あわせて、Kilo CLI がグローバルインストール済みか確認します:

npm install -g @kilocode/cli

設定値

項目値
Provider パッケージ(npm)@ai-sdk/openai-compatible
options.baseURLhttps://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