Theia IDE

ai-features.openAiCustom.customOpenAiModels内の1つのエントリ — model、url、apiKey — で、Theia Coder、Architect、インライン補完のバックエンドとしてKunavoを利用できます。

{
  "ai-features.openAiCustom.customOpenAiModels": [
    {
      "model": "claude-sonnet-5",
      "url": "https://api.kunavo.com/v1",
      "id": "kunavo-sonnet-5",
      "apiKey": "sk-kn-...",
      "developerMessageSettings": "system"
    },
    {
      "model": "claude-haiku-4-5",
      "url": "https://api.kunavo.com/v1",
      "id": "kunavo-haiku-4-5",
      "apiKey": "sk-kn-...",
      "developerMessageSettings": "system"
    }
  ]
}

手順

1. /app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
2. 機能を有効にします。Theiaのドキュメントでは、Preferencesを開き、設定「AI-features => AI Enable」を有効にするよう案内しています。この操作を行うまで、以下の項目は表示されません。
3. AI Configurationビューを開きます。Alt+Aを選択するか、左下のManage（歯車）メニューで、Settingsのすぐ下にあるAI Configurationを選択します。カテゴリはGeneral、Providers & Models、Model Aliases、Agents、Prompts & Skills、Variables、Tools、Token Usage、MCP Serversです。
4. 上記のエントリーを追加します。ドキュメントでは、OpenAI Compatible Modelsの設定セクションにあるリンクをクリックする手順として説明されています。この設定項目は構造化リストです。専用エディターのない構造化設定は「settings.jsonに委ねられる」とTheiaは説明しており、そこから開くのがこのファイルです。モデルidごとにオブジェクトを1つ設定します。urlとapiKeyは繰り返し使います。
5. 接続先を指定します。Agentsでは、各エージェントにLanguage Modelセレクターがあります。多くのエージェントはモデルエイリアスを参照するため、Model Aliasesの下にあるdefault/code、default/universal、default/code-completion、default/summarize、default/fastを設定すれば、複数のエージェントをまとめて切り替えられます。
6. Theia Coderにチャットメッセージを送り、ファイルに関わる作業を依頼します。このIDEのエージェントはツール呼び出しとワークスペース内のコンテンツを活用するため、挨拶ではなく、何かを読み取ったり編集したりする初回実行のほうが多くのことを確認できます。同じビューのToken Usageでは、そのターンのトークン消費量も確認できます。

Theia IDEのAI機能ページの「OpenAI Compatible Models」セクションで2026年9月21日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

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

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

# 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で、入力 / 出力の順です。

Theiaがこのプロバイダーについて説明している内容

Theia自身のページにある「LLM Providers Overview」表では、各プロバイダーを3つの軸で評価しています。これはTheiaがTheiaについて述べている内容で、上記の日付にその表から転記したものです。Kunavoによるテスト結果ではありません。また、「モデルIDに必要な条件」という列だけが、このページで記載した内容です。

Theiaは、この表の2段落上で注意点も述べています。このページ全体の誠実な前提として、繰り返す価値があります。すべてのモデルが「そのまま動作するとは限らず、特定のカスタマイズや最適化が必要になる場合があります」。

実際に費用がかかるもの

Theia IDEはオープンソースで、無料でダウンロードできます。また、AI機能自体に料金はかかりません。費用が発生するのはapiKey内のキーを保持する事業者が請求するモデル呼び出しです。モデルの選択よりも請求額に大きく影響する設定が2つあり、どちらもドキュメントに記載されています。

1. Automatic Code Completionはデフォルトで有効になっており、ドキュメントでは「コーディング中に基盤となるLLMへ継続的にリクエストを送信する」と説明されています。これは1日に何千回も実行されるエージェントです。default/code-completionを低価格のIDに固定するか、'AIFeatures'=>'CodeCompletion'でエージェントを手動モードに切り替えて、Ctrl+Alt+Spaceで実行してください。
2. 同じ設定グループにあるMax Context Linesは、各補完リクエストで周辺ファイルから取り込む量を制限します。その行はすべて、キー入力に応じて送られるリクエストごとに入力トークンとして課金されます。

チャットエージェントは対照的です。リクエスト回数は少ない一方、コンテキストははるかに大きく、同じワークスペースのファイルがターンごとに再送信されます。これがプロンプトキャッシュを使う場面です。詳しくは/docs/cachingをご覧ください。そのため、上のモデル表の2つの部分は、エージェントの賢さではなく、実行頻度で分けています。

接続できない場合

1. 404 — urlです。Kunavoは/v1/chat/completionsを提供しているため、このフィールドには/v1のルートを指定します。オリジンだけの場合も、.../chat/completions全体を指定した場合も一致しません。
2. 401 — キーの問題です。TheiaのReadmeには、apiKeyは「認可リクエストでBearerトークンとして送信される」と記載されており、これはsk-kn-キーが想定する動作とまったく同じです。文書に記載されたデフォルトの動作に注意してください。apiKeyがまったくない場合、Theiaはno-keyを送信するため、フィールドが欠落していると、キーが存在しないのではなく、キーが拒否されたように見えます。（trueは「グローバルのOpenAI APIキーを使用する」という意味であり、ここで意図する動作ではありません。）
3. モデルIDが選択肢にない — この一覧はエンドポイントから取得するのではなく、独自のcustomOpenAiModelsエントリから作られるため、IDが見当たらない場合はオブジェクトがありません。idフィールドに指定した値がUIに表示されます。省略すると、モデル名が代わりに使われます。
4. 最初のsystemメッセージが拒否または無視される — 原因はdeveloperMessageSettingsです。デフォルトはdeveloperで、OpenAI形式のロールです。OpenAI以外のベンダー向けにTheiaが示している例ではsystemを設定しているため、上の設定例もそうしています。user、mergeWithFollowingUserMessage、skipもドキュメントに記載された代替方法です。
5. どこでも何も応答しない — Workspace Trustを確認してください。TheiaはすべてのAI機能をこれで制御しており、信頼されていないワークスペースではチャット入力とインライン補完が無効になり、AI Features are Restrictedというメッセージが表示されます。