Theia IDE

Ein Eintrag in ai-features.openAiCustom.customOpenAiModels — model, url und apiKey — bringt Kunavo hinter Theia Coder, den Architect und die Inline-Vervollständigung.

{
  "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"
    }
  ]
}

Schritt für Schritt

1. Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
2. Aktivieren Sie die Funktion: Laut Theia-Dokumentation gehen Sie dazu zu Preferences und aktivieren die Einstellung „AI-features => AI Enable“. Erst danach werden die folgenden Optionen angezeigt.
3. Öffnen Sie die Ansicht AI Configuration – Alt+A oder AI Configuration im Menü Manage (Zahnradsymbol) unten links, direkt unter Settings. Die Kategorien lauten General, Providers & Models, Model Aliases, Agents, Prompts & Skills, Variables, Tools, Token Usage und MCP Servers.
4. Fügen Sie die Einträge oben hinzu. In der Dokumentation wird beschrieben, dass Sie dazu im Einstellungsbereich auf den Link OpenAI Compatible Models klicken. Die Einstellung ist eine strukturierte Liste. Theia weist darauf hin, dass strukturierte Einstellungen ohne eigenen Editor „an settings.json weitergereicht werden“; dort landen Sie dann. Verwenden Sie ein Objekt pro Modell-ID; url und apiKey sind identisch.
5. Weisen Sie etwas dem Modell zu. Unter Agents hat jeder Agent eine Auswahl Language Model. Viele Agenten lösen stattdessen einen Modellalias auf. Wenn Sie default/code, default/universal, default/code-completion, default/summarize und default/fast unter Model Aliases festlegen, weisen Sie das Modell mehreren Agenten auf einmal zu.
6. Senden Sie Theia Coder eine Chatnachricht und bitten Sie anschließend um etwas, das eine Datei betrifft. Die Agenten in dieser IDE stützen sich auf Toolaufrufe und Inhalte des Arbeitsbereichs. Ein erster Durchlauf, bei dem etwas gelesen oder bearbeitet wird, sagt Ihnen daher mehr als eine Begrüßung. Token Usage in derselben Ansicht zeigt, wie viele Tokens der Durchlauf gekostet hat.

Abgeglichen mit Die Seite zu den KI-Funktionen der Theia IDE, Abschnitt OpenAI Compatible Models am 21. September 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in 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-..."

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Was Theia für diesen Anbieter angibt

In der Tabelle „LLM Providers Overview“ auf Theias eigener Seite wird jeder Anbieter anhand von drei Kriterien bewertet. Das sind Theias Angaben zu Theia, übernommen aus dieser Tabelle mit Stand vom oben genannten Datum. Es handelt sich nicht um ein Kunavo-Testergebnis. Nur die Spalte „What that needs from the model id“ wurde für diese Tabelle hier verfasst.

Zwei Absätze über der Tabelle fügt Theia einen eigenen Vorbehalt hinzu, den es sich zu wiederholen lohnt, denn er gibt den ehrlichen Rahmen für die ganze Seite vor: Nicht alle Modelle „funktionieren möglicherweise sofort, da sie bestimmte Anpassungen oder Optimierungen erfordern können“.

Was tatsächlich Geld kostet

Die Theia IDE ist quelloffen und kann kostenlos heruntergeladen werden. Für die KI-Funktionen selbst wird nichts berechnet. Kosten verursachen die Modellaufrufe; abgerechnet werden sie von der Person oder Stelle, die den Schlüssel unter apiKey besitzt. Zwei Einstellungen wirken sich stärker auf die Rechnung aus als die Wahl des Modells, und beide sind in der Dokumentation aufgeführt:

1. Automatic Code Completion ist standardmäßig aktiviert. Laut Dokumentation sendet die Funktion „während des Programmierens fortlaufend Anfragen an das zugrunde liegende LLM“. Der Agent wird tausendfach am Tag ausgeführt. Weisen Sie default/code-completion eine günstige Modell-ID zu oder stellen Sie den Agenten unter 'AIFeatures'=>'CodeCompletion' auf den manuellen Modus um und lösen Sie ihn mit Ctrl+Alt+Space aus.
2. Max Context Lines begrenzt in derselben Einstellungsgruppe, wie viel Text aus dem Umfeld einer Datei in jede Vervollständigungsanfrage eingeht. Jede Zeile davon wird bei jedem durch einen Tastendruck ausgelösten Aufruf als Eingabe abgerechnet.

Bei den Chat-Agenten ist es umgekehrt: Sie stellen weniger Anfragen, verwenden aber einen viel größeren Kontext und senden dieselben Arbeitsbereichsdateien bei jedem Durchlauf erneut. Genau dafür gibt es Prompt-Caching – siehe /docs/caching. Deshalb ist die obige Modelltabelle danach aufgeteilt, wie oft der Agent ausgeführt wird, und nicht danach, wie leistungsfähig er ist.

Wenn keine Verbindung zustande kommt

1. 404 – der url. Kunavo stellt /v1/chat/completions bereit, daher benötigt das Feld den /v1-Stamm. Eine reine Ursprungsadresse oder ein vollständiger .../chat/completions ist in beiden Fällen falsch.
2. 401 – der Schlüssel. Laut Theias Readme wird der apiKey „als Bearer Token in der Autorisierungsanfrage gesendet“. Genau das erwartet ein sk-kn--Schlüssel. Beachten Sie den dokumentierten Standardwert: Wenn apiKey ganz fehlt, sendet Theia no-key. Ein fehlendes Feld sieht dann wie ein abgelehnter Schlüssel aus und nicht wie ein fehlender. (true bedeutet „den globalen OpenAI-API-Schlüssel verwenden“ – das ist hier nicht erwünscht.)
3. Die Modell-ID erscheint nicht in der Auswahlliste – diese Liste stammt aus Ihren eigenen customOpenAiModels-Einträgen und nicht vom Endpunkt. Fehlt eine ID, fehlt also ein Objekt. Das Feld id wird in der Benutzeroberfläche angezeigt; lassen Sie es weg, wird stattdessen der Modellname verwendet.
4. Die erste Systemnachricht wird abgelehnt oder ignoriert – dafür ist developerMessageSettings zuständig. Standardmäßig ist developer festgelegt, eine Rolle im OpenAI-Format. In Theias eigenem Beispiel für einen Anbieter, der nicht von OpenAI stammt, ist system festgelegt. Deshalb steht dieser Wert im obigen Block. user, mergeWithFollowingUserMessage und skip sind die dokumentierten Alternativen.
5. Es erfolgt überhaupt keine Reaktion – prüfen Sie Workspace Trust. Theia macht alle KI-Funktionen davon abhängig. Bei einem nicht vertrauenswürdigen Arbeitsbereich werden die Chateingabe und die Inline-Vervollständigung deaktiviert und die Meldung AI Features are Restricted angezeigt.