Kilo Code APIキー設定

Kilo Code APIキー: kilo.jsonで自分のキーを設定

以下のブロックをkilo.jsonに貼り付け、自分のAPIキーに置き換えると、Kilo CodeでClaudeおよびGPTモデルを使用できます。従量課金です。

~/.config/kilo/kilo.jsonjson
config
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "aicodewith/claude-haiku-4-5-20251001",
  "provider": {
    "aicodewith": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI Code With",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "sk-***"
      },
      "models": {
        "claude-haiku-4-5-20251001": {
          "name": "Claude Haiku 4.5"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  }
}

セットアップ手順

後でターミナルで使用するためにこのキーを保存

サインインすると、このコマンドにはあなたのキーが含まれます。コピーして一度実行すると、ツールはテスト済みの場所にキーを保存します。

bash
mkdir -p "$(dirname "$HOME/.config/kilo/kilo.json")"
cat > "$HOME/.config/kilo/kilo.json" << 'EOF'
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "aicodewith/claude-haiku-4-5-20251001",
  "provider": {
    "aicodewith": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI Code With",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "sk-***"
      },
      "models": {
        "claude-haiku-4-5-20251001": {
          "name": "Claude Haiku 4.5"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  }
}
EOF

サインアウトした訪問者にはプレースホルダーのみが表示されます。サインインすると、あなたのキーが入力されます。 Sign in · コンソールでキーを取得

コピーすると、コマンドがクリップボードに置かれるだけです。まだターミナルで実行するか、ツールの設定にキーを貼り付ける必要があります。 APIキーの取得方法

これらの手順は Linux(bash)でテスト済みです。macOS と Windows はまだテストしていないため、記載していません。

  1. Kilo Code がまだない?インストールする(インストール済みならスキップ)

    npm i -g @kilocode/cli を実行し、次に kilo --version を実行します。バージョン番号が表示されればインストール済みです。

    npm i -g @kilocode/cli で Kilo Code CLI をインストールし、kilo --version が 7.8.8 を表示すれば動作確認できます
  2. 設定を kilo.json に貼り付けて API キーを追加する

    ~/.config/kilo/kilo.json を開き、このページの上部にあるブロックを貼り付けて、sk-*** を API キーに置き換えます(API キーを取得)。保存後、ファイルには "apiKey": "sk-…" の行があり、新しいターミナルまたは再起動でも保持されます。

    キーは ~/.config/kilo/kilo.json の provider.aicodewith.options.apiKey に直接入れます(ここでは sk-*** とマスクしています)
  3. 新しいターミナルを開いて Kilo Code をテストする

    新しいターミナルを開き、kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" を実行します。OK と返れば、Kilo Code が API キーを使用しています。

    確認:ターミナルを閉じて新しいものを開き(export なし)、kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" を実行します。OK と返れば設定完了です
  4. OK にならない?エラーを照合する

    ターミナルに表示されたエラーを、下のよくあるエラーと照合します。それぞれに原因と修正方法が記載されています。

  5. Kilo Code のモデルを切り替える:-m の後ろの名前を変更する

    -m の後ろには、aicodewith/ に続けて、kilo.json の models に記載されたモデルを書きます。たとえば aicodewith/gpt-5.5 です。モデルを追加するには、まずその Model ID を models に記載してください。モデルと価格をご覧ください。

よくあるエラー

キー未設定: Error: Unauthorized: リクエストに有効な API Key を指定してください。

表示内容

Error: Unauthorized: リクエストに有効な API Key を指定してください。
(英語: "Please provide a valid API key in the request.")
原因
kilo.json の apiKey が {env:AICODEWITH_API_KEY} になっており、新しいターミナルにはその変数がありません
直し方
手順2と同様に、キーを apiKey に直接記述してください

ステップ 2 に戻る:設定を kilo.json に貼り付けます →

キー未設定: apiKey はまだ {env:AICODEWITH_API_KEY} のままで、新しいターミナルにはその変数がありません。kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" を実行すると、次のように出力されます: Error: Unauthorized: リクエストに有効な API Key を指定してください。 (英語: "Please provide a valid API key in the request.")

キーが間違っている: Error: Unauthorized: リクエストに有効な API Key を指定してください。

表示内容

Error: Unauthorized: リクエストに有効な API Key を指定してください。
(英語: "Please provide a valid API key in the request.")
原因
apiKey が間違っています。エラーはキー未設定の場合と同じです
直し方
コンソールからキーをもう一度コピーし、apiKey の引用符内の値を置き換えてください

ステップ 2 に戻る:設定を kilo.json に貼り付けます →

キーが間違っている: grep -n sk-wrong ~/.config/kilo/kilo.json を実行すると、10行目が "apiKey": "sk-wrong" であることが表示されます。kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" を実行すると、次のように出力されます: Error: Unauthorized: リクエストに有効な API Key を指定してください。 (英語: "Please provide a valid API key in the request.") — キー未設定のエラーと同じです

Error: モデルが見つかりません

表示内容

Error: モデルが見つかりません
原因
-m の後に指定したモデルが kilo.json の models に一覧されていません(たとえば aicodewith/no-such-model)。そのため Kilo Code はリクエストを送信する前に停止します
直し方
models に一覧されているモデルを使用してください。たとえば aicodewith/gpt-5.5 です

ステップ 3 に戻る:新しいターミナルを開いて Kilo Code をテストします →

よくあるエラー: モデル名が間違っている場合(ここでは aicodewith/no-such-model)、kilo は Error: Model not found を返します。これは Kilo 自身が(モデルが kilo.json に一覧されていないため)リクエストを送信する前に発生させます。設定に一覧されているモデルを使用してください。たとえば aicodewith/gpt-5.5 です

FAQ

Kilo Code で自分の API キーを使用するにはどうすればよいですか?

~/.config/kilo/kilo.json で、baseURL を https://api.aicodewith.ai/v1 にした aicodewith プロバイダーを追加し、キーを apiKey に記述します。新しいターミナルでも保持されます。

Kilo Code のベース URL に /v1 を含める必要がありますか?

はい。https://api.aicodewith.ai/v1 を使用してください。

Kilo Code の kilo.json はどこにありますか?

グローバル設定は ~/.config/kilo/kilo.json です。

Kilo Code が Unauthorized と言っています。どうすればよいですか?

kilo.json の apiKey が欠落しているか間違っています。修正方法は上記の「よくあるエラー」を参照してください。

出典

関連リンク