Coding Agent のセットアップ

Kilo Code のインストールと API 設定

Kilo Code をインストールし、BetterToken の Base URL と API Key を設定して、モデルを選び、よくあるエラーを解決します。

Kilo Code を BetterToken に接続するには、API Key を用意し、以下の Base URL を入力して、モデル広場から現在の Model ID を選択します。

設定は 3 ステップです。Kilo Code の Providers 設定で Custom provider を追加し、OpenAI Compatible を選択して BetterToken API Key、https://bettertoken.ai/v1、現在の Model ID を入力します。保存後に拡張機能を再起動し、新しいチャットで短い初回リクエストを送って接続を確認します。

主要な設定

項目	値
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	モデル広場にある現在の Model ID

前提条件

現在のバージョンのツールがインストールされている
BetterToken API Key：登録して取得
モデル広場の Model ID

登録して BetterToken API Key を取得

アカウントをお持ちの方は、ログインして残高をチャージし、コンソールでキーを作成してください。

追加要件

VS Code がインストールされている

インストール

Kilo Code がインストール済みの場合は、手動設定へ進み、BetterToken API Key、Base URL、Model ID を入力してください。

拡張機能をまだインストールしていない場合や、インストールと地域での利用について背景を確認したい場合は、英語の Kilo Code インストール・カスタム API ガイドを読み、その後このページに戻って現在の設定項目を使用してください。

手動設定

この設定は Kilo Code の設定 UI で完了します。設定ファイルを編集する必要はありません。

項目	値
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	モデル広場にある現在の Model ID

設定手順

競合する環境変数を削除する

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Kilo Code の設定を開く

Settings（歯車アイコン）を開き、Providers を選択して、一覧の下にある Custom provider をクリックします。

API プロバイダーを設定する

次の値を入力します。

Provider ID → bettertoken
Display name → BetterToken
Provider API → OpenAI Compatible
Base URL → https://bettertoken.ai/v1
API Key → BetterToken API Key
Models → モデル広場からコピーしたモデル ID を手動で追加し、表示名にも同じ ID を指定します

Submit をクリックしてプロバイダーを保存します。これらは公式 Custom Models ガイドに記載された VS Code 拡張機能のフィールドです。

公式ドキュメントで明示的に要求される場合にのみ追加ヘッダーを設定する

確認した公式 Kilo Code 資料では、OpenAI 互換プロバイダー向けの任意のカスタムヘッダーに触れていますが、User-Agent は BetterToken の必須設定手順として扱われていません。

カスタムゲートウェイ、テナントルーティング、可観測性、キャッシュレイヤーも使用している場合は、その上流サービスの公式ドキュメントに従ってのみヘッダーを追加してください。

Kilo Code を再起動する

設定を変更した後、新しい設定を有効にするために VS Code を再起動するか、Kilo Code 拡張機能を再読み込みします。

接続を確認する

OK のみ返してください などの短い初回リクエストを送信します。認証または Model ID のエラーなしで応答すれば接続は成功です。設定変更後はツールを完全に再起動してください。失敗した場合はよくあるエラーを確認します。

Kilo CLI

公式 Kilo CLI をインストールします。拡張機能とは別にインストールしてください。GPT モデルを使った macOS のテストでは、Kilo CLI 7.8.17 が /v1/chat/completions 経由でテキストリクエストとファイル読み取りのツール呼び出しを完了しました。

ターミナルで BetterToken API Key を設定します。

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

プロジェクトに kilo.json を作成します。すべての YOUR_MODEL_ID をモデル広場にある正確な ID に置き換えます。

{
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://bettertoken.ai/v1",
        "apiKey": "{env:BETTERTOKEN_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": { "name": "YOUR_MODEL_ID" }
      }
    }
  },
  "model": "bettertoken/YOUR_MODEL_ID",
  "permission": { "read": "allow", "edit": "deny", "bash": "deny" },
  "agent": { "build": { "steps": 4 } }
}

KILO_CONFIG にこのファイルを指定し、非対話型のテキスト確認を実行します。

export KILO_CONFIG="$PWD/kilo.json"
kilo run --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

最終回答が OK であることを確認します。この設定ではファイル読み取りを許可し、編集とシェルコマンドを拒否します。KILO_CONFIG でファイルを指定すると信頼された設定ソースとなり、{env:...} の参照が展開されます。リポジトリから読み込んだだけのプロジェクト設定では環境変数参照が展開されません。上記のように KILO_CONFIG を明示してください。

モデルを切り替える

モデルセレクターを開くか、設定の Model フィールドを変更します。モデル広場にある正確な Model ID を使用してから、現在のセッションを再起動してください。

よくあるエラー

エラー	確認事項
`401` または `Unauthorized`	BetterToken API Key を確認し、先頭または末尾の空白を削除します。
`404`	Base URL を確認し、特定の Endpoint パスを追加しないでください。
`model not found`	モデル広場から現在の Model ID をコピーします。
変更が反映されない	設定を保存して、ツールを完全に再起動します。

技術詳細

プロトコル、Endpoint、内部プロバイダーフィールド

この設定では https://bettertoken.ai/v1 を使用します。ツールが OpenAI 互換の Endpoint パスを追加します。特定のフィールドで明示的に要求されない限り、/chat/completions や /responses を追加しないでください。