Junie CLI

Junie CLIはカスタムエンドポイントを$JUNIE_HOME/models/のJSONプロファイルとして受け取り、baseUrlには完全なエンドポイントURLを指定し、fasterModelで補助トラフィックの送信先を決めます。

{
  "id": "claude-sonnet-5",
  "baseUrl": "https://api.kunavo.com/v1/chat/completions",
  "displayName": "Kunavo",
  "providerName": "Kunavo",
  "apiType": "OpenAICompletion",
  "apiKey": "${KUNAVO_API_KEY}",
  "fasterModel": {
    "id": "claude-haiku-4-5"
  }
}

手順

1. /app/keysでキーを作成し、コピーします。表示されるのは1度だけです。Junieを起動するシェルでKUNAVO_API_KEYとしてエクスポートするか、代わりにファイルにキーを直接記述してください。JetBrainsは「$${...}参照を含まない値は、そのまま使用される」と説明しています。
2. 上記のJSONをアカウント用の$JUNIE_HOME/models/kunavo.json、またはリポジトリで共有する場合は.junie/models/kunavo.jsonに保存します。.jsonより前のファイル名がプロファイルIDになります。これにより、下のセレクターにcustom:kunavoと表示されます。
3. idに、実際に使用したいモデルIDを設定します。この項目は「APIエンドポイントが想定するモデル識別子」と説明されているため、下の表にあるKunavoのスラッグをそのまま指定します。IDを解決するのはJunie内部ではなく、エンドポイントです。
4. Junieを起動し、junie --model custom:kunavo、または対話セッション内の/modelコマンドでプロファイルを選択します。カスタムモデルは「モデル選択リストで組み込みプロバイダーの後に表示されます」。
5. 挨拶ではなく、ファイルを編集するタスクを依頼してください。Junieはエージェント型クライアントであり、ほとんどの処理でツール呼び出しを使うため、初回の実行で実際に何かを読み書きさせると、返信を1件受け取るだけよりはるかに多くのことを確認できます。

Junie向けJetBrains Custom LLMsページで2026年9月21日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

クライアントをデバッグする前に確認すること

1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これがJSONを返すなら、同じベースURLとキーがJunie CLIで機能します。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

フィールドに入力するモデルID

すべてのテキストモデルにはモデルIDでアクセスできます。現在の一覧はGET /v1/models、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。

Kunavoが応答する、もう2つのapiType値

apiTypeが指定するのはリクエスト形式であり、ベンダーではありません。Junieが受け付ける値は4つです。OpenAICompletion、OpenAIResponses、Google、Anthropicです。Kunavoが提供するルートは3つあるため、残り3つの値のうち2つは対応するbaseUrlをここで利用できます。また、Junieはパスを追加しないため、形式を変える場合は同じ編集でURLも変更してください。

1. "apiType": "OpenAICompletion"とhttps://api.kunavo.com/v1/chat/completionsの組み合わせです。上記のプロファイルで、本ページが推奨する設定です。3つのルートのうち、このルートが最も広く使われているためです。
2. "apiType": "Anthropic"とhttps://api.kunavo.com/v1/messagesの組み合わせです。このパスではKunavoがMessages形式に応答します。
3. "apiType": "OpenAIResponses"とhttps://api.kunavo.com/v1/responsesの組み合わせです。

特定のモデルに対してJunieの3つの方式のどれが最もよく動作するかは、まさに実行テストで答えるべき問題であり、ドキュメントを読むだけではわかりません。そのため、このページでは最初の行を超えて順位付けはしていません。1つを選び、URLとapiTypeの整合性を保ってください。キーを設定したプロファイルで401が返る場合は、Junieのヘッダーを推測するのではなく、認証情報を明示してください。JetBrainsがapiKeyについて記載しているのは、「省略した場合、リクエストはAuthorizationヘッダーなしで送信される」という否定形の説明だけで、指定した場合に使用されるスキームは明記していません。extraHeadersは「すべてのリクエストに含める追加のHTTPヘッダー」と説明されており、同じ$${VAR}参照を使用できるため、"extraHeaders": {"Authorization": "Bearer $${KUNAVO_API_KEY}"}が曖昧さのない形式になります。