Abschnitte der Wissensbasis ▾

Navigation

▸ Hier starten Nach Rollen

Kategorien

Werkzeuge 52
Glossar 12

Tools

Trae + JoinGonka Gateway — Gonka-Netzwerkmodelle in der AI-IDE

Trae ist eine AI-IDE mit Agenten, einem autonomen SOLO-Modus und einer Reihe integrierter Modelle, deren Verbrauch vom monatlichen Tariflimit abgezogen wird. Seit August 2026 wird die Desktop-Umgebung in der Dokumentation TraeCode genannt – falls Sie auf diesen Namen in der Benutzeroberfläche oder in der Hilfe stoßen, ist dieselbe IDE gemeint.

Neben den integrierten Modellen kann Trae auch mit eigenen arbeiten: Im Fenster Add Model gibt es die Option Custom Model, wo API-Format, Anfrageadresse, Modell-ID und Schlüssel festgelegt werden. Es gibt zwei Formate – OpenAI Chat Completions und Anthropic Messages – und das JoinGonka Gateway unterstützt beide mit einem einzigen Schlüssel. So erhalten Trae-Agenten Zugriff auf Modelle des dezentralen Gonka-Netzwerks mit Token-basierter Bezahlung zu den Live-Preisen des Netzwerks. Nach der Registrierung und Bestätigung der Adresse erhalten Sie 3M kostenlose Token auf Ihr Konto – genug, um die Verbindung mit Ihrem Projekt zu testen.

Die Menüpunkte und Feldbezeichnungen unten basieren auf der offiziellen Trae-Dokumentation für die englische Benutzeroberfläche; in der lokalisierten Benutzeroberfläche sind die Bezeichnungen übersetzt, die Reihenfolge der Schritte bleibt jedoch gleich.

Was Sie benötigen: Trae-Build, Version und Schlüssel

Build und Version. Trae hat zwei Zweige: den internationalen (Dokumentation unter docs.trae.ai) und den chinesischen (docs.trae.cn). Das Formular Custom Model gibt es in beiden und es ist identisch aufgebaut; unterschiedlich sind die integrierten Modelle und die Auswahl an Presets in den erweiterten Einstellungen. Eine beliebige Anfrage-Adresse für das eigene Modell wird ab Version 3.5.51 vom 14. April 2026 unterstützt — wenn Ihr Build älter ist, aktualisieren Sie. Der internationale Build ist nicht in allen Ländern verfügbar: Prüfen Sie vor der Installation die Liste der unterstützten Länder und Regionen.

System. macOS 12 und neuer, Windows 10 oder 11 (x64), Linux als .deb- und .rpm-Pakete. Beim ersten Start schlägt Trae vor, Theme und Sprache zu wählen, Einstellungen aus VS Code oder Cursor zu importieren und sich anzumelden.

JoinGonka-Schlüssel. Registrieren Sie sich beim Gateway, öffnen Sie im Konto den Abschnitt „API-Schlüssel" und klicken Sie auf „Schlüssel erstellen". Der Schlüssel beginnt mit jg- und wird nur einmal angezeigt — speichern Sie ihn sofort. Es empfiehlt sich, für Trae einen eigenen Schlüssel anzulegen: Im Abschnitt „Nutzung" ist sein Verbrauch dann als separate Zeile sichtbar.

Trae-Tarif. Das eigene Modell muss man in der Modellliste manuell auswählen, und in der Tariftabelle von Trae steht beim kostenlosen Plan in der Zeile zur Modellauswahl nur der Auto-Modus — dort werden eigene Modelle nicht verwendet. Ob diese Einschränkung auch für Modelle mit eigenem Schlüssel gilt, sagt die Dokumentation nicht eindeutig. Die praktische Regel ist einfach: Lässt sich der Auto Mode in Ihrem Plan in der Modellliste abschalten, ist alles bereit; wenn nicht, brauchen Sie einen kostenpflichtigen Plan.

Verbindung: Settings → Models → Add Model → Custom Model

  1. Öffnen Sie Settings → Models — das Bedienfeld für die Modellverwaltung.
  2. Klicken Sie auf Add Model. Wählen Sie im sich öffnenden Fenster die Option Custom Model, nicht einen Anbieter aus der vorgefertigten Liste.
  3. Füllen Sie die Felder mit den Werten aus der Tabelle. Es gibt zwei Spalten — für jedes der beiden API-Formate; wählen Sie eines.
  4. Klicken Sie auf Add Model. Trae führt einen Test-API-Aufruf durch und prüft den Schlüssel: Bei Erfolg erscheint das Modell in der Liste, bei einem Fehler zeigt das Fenster eine Fehlermeldung und das Antwortprotokoll des Anbieters an.
FeldOpenAI-FormatAnthropic-Format
API FormatOpenAI Chat CompletionsAnthropic Messages
Custom Request URL, Schalter Full URL aushttps://gate.joingonka.ai/v1https://gate.joingonka.ai
Custom Request URL, Schalter Full URL anhttps://gate.joingonka.ai/v1/chat/completionshttps://gate.joingonka.ai/v1/messages

Die übrigen Felder sind unabhängig vom Format:

FeldWertErläuterung
Model IDdeepseek-ai/DeepSeek-V4-Flash-0731Die exakte Modell-ID, wie sie das Gateway ausgibt
Display NameDeepSeek V4 Flash (Gonka)Der Name in der Modellliste; ohne ihn zeigt Trae die Model ID an
API Keyjg-your-keyEin Schlüssel gilt für beide Formate

Welches Format wählen. Beginnen Sie mit OpenAI Chat Completions: Das ist der Hauptweg des Gateways, mit dem die meisten Tools arbeiten. Anthropic Messages ist nützlich, wenn Sie dieses Format aus anderen Tools gewohnt sind oder das Verhalten des Agenten über zwei Protokolle hinweg vergleichen möchten — Schlüssel und Guthaben sind bei beiden identisch.

So funktioniert Full URL. Der Schalter entscheidet, wer den Pfad ergänzt. Aus — Sie geben die Basisadresse an, und Trae hängt den Pfad je nach gewähltem Format an: /chat/completions an die Adresse mit /v1 für OpenAI und /v1/messages an die Root für Anthropic. An — die Adresse wird unverändert verwendet, und der Pfad muss vollständig darin stehen. Der häufigste Fehler ist, die Modi zu vermischen: einen vollständigen Pfad bei ausgeschaltetem Schalter einzutragen oder eine Basisadresse bei eingeschaltetem Schalter.

Ein Eintrag — ein Modell. Wiederholen Sie die Schritte für die übrigen Modelle des Netzwerks, um ohne Rückkehr in die Einstellungen zwischen ihnen wechseln zu können: deepseek-ai/DeepSeek-V4-Flash-0731, MiniMaxAI/MiniMax-M2.7 und zai-org/GLM-5.3-Flash. Die aktuelle Liste liefert GET https://gate.joingonka.ai/v1/models. Ein hinzugefügtes Modell lässt sich später bearbeiten, deaktivieren (es bleibt im Bedienfeld, verschwindet aber aus der Liste im Chat) oder löschen.

Erweiterte Einstellungen und Modellauswahl

Unter den Basisfeldern befindet sich eine einklappbare Liste Advanced Settings. Sie müssen diese nicht ändern – Trae setzt Standardwerte ein –, aber zwei Einstellungen sollten bewusst vorgenommen werden: die Modellserie und das Kontextfenster.

EinstellungAuswahlWarum
Model SeriesDefaultSerien-Presets ändern Prompts, Hyperparameter und das Kontextfenster gemäß den APIs der Anbieter. Das Deepseek-4-Preset erhöht beispielsweise die Limits auf 616.000 Token für den Input und 384.000 für den Output – das ist mehr, als das Modell im Gonka-Netzwerk ausgibt
Context Window (Token)Input und Output – siehe Modelltabelle untenTrae füllt leere Felder mit Standardwerten; manuell eingegebene Werte haben Vorrang und verhindern, dass der Agent mehr Kontext ansammelt, als das Modell akzeptieren kann
Image Input SupportAusNetzwerkmodelle sind textbasiert. Mit deaktivierter Einstellung warnt Trae, dass das Modell keine Bilder akzeptiert
Thinking ModeFollow model defaultDas Denken wird vom Modell selbst gesteuert; bei GLM-5.3 Flash ist es standardmäßig aktiviert
Tool Call Rounds, HyperparametersLeer lassenStandardwerte sind geeignet; Temperature, Top P und Top K können bei Bedarf später angepasst werden

Die Preise der Netzwerkmodelle sind gleich, daher geht es bei der Auswahl um das Verhalten. Alle Modelle in der Tabelle unterstützen natives Tool Calling, auf dem die Arbeit der Trae-Agenten basiert.

ModellModel IDContext Window: Input / OutputWann in Trae verwenden
DeepSeek V4 Flashdeepseek-ai/DeepSeek-V4-Flash-0731380000 / 32768Hauptmodell des Agenten: große Repositories, lange Sitzungen, Generierung umfangreicher Dateien – das größte Antwort-Limit im Netzwerk
MiniMax M2.7MiniMaxAI/MiniMax-M2.7200000 / 8192Schnelle Korrekturen, Codefragen, Erklärung eines Fragments – kurzer „Frage-Antwort“-Zyklus
GLM-5.3 Flashzai-org/GLM-5.3-Flash390000 / 8192Reasoning-Modell: denkt vor der Antwort nach. Design, kompliziertes Debugging, Analyse fremder Architekturen; ein Teil des Output-Limits entfällt auf die Denkvorgänge

Wie das Reasoning-Budget aufgebaut ist und warum bei Reasoning-Modellen das Output-Limit nicht zu niedrig angesetzt werden darf, wird im GLM-5.3 Flash-Überblick behandelt; ein Vergleich der Modelle bei Entwicklungsaufgaben finden Sie im Artikel über die besten Modelle für Code.

Überprüfung und Diagnose

Ihre eigenen Modelle leben in der allgemeinen Liste: Klicken Sie auf den Namen des aktuellen Modells in der unteren rechten Ecke des Chat-Eingabefelds und wählen Sie das hinzugefügte Modell aus. Dort befindet sich auch der Schalter Auto Mode — dieser muss ausgeschaltet sein: Im Auto-Modus wählt Trae selbst ein Modell aus den integrierten aus und verwendet die von Ihnen hinzugefügten nicht.

Geben Sie dem Agenten eine Aufgabe, die ein Tool erfordert, zum Beispiel: „Lies package.json und liste die Build-Skripte auf“. Der Agent sollte die Datei öffnen und inhaltlich antworten — das bedeutet, dass der Zyklus „Anfrage – Tool-Aufruf – Antwort“ über das Gateway funktioniert. Öffnen Sie dann das Gateway-Dashboard, Bereich „Nutzung“: Im Block „Nach Schlüsseln“ erscheinen bei dem Trae-Schlüssel Anfragen und der Zeitpunkt des letzten Zugriffs, im Block „Nach Modellen“ das gewählte Modell.

Wenn etwas schiefgelaufen ist, achten Sie auf den Fehlertext. Trae versteckt die Antwort seines eigenen Modells nicht: Den Fehler des Anbieters zeigt es so an, wie er ist, mit dem eigenen Code 4028.

Was man siehtWas das bedeutetWas zu tun ist
401, Invalid API key — im Add Model-Fenster oder im ChatDas Gateway hat den Schlüssel nicht erkanntÜberprüfen Sie, ob der Schlüssel mit jg- beginnt, ohne Leerzeichen eingefügt wurde und im Bereich „API-Keys“ aktiv ist
404, Invalid URL (POST …)Im Pfad ist ein überflüssiges Segment; im Fehlertext zeigt das Gateway, wo die Anfrage angekommen istVergleichen Sie die Adresse mit der Tabelle: Der vollständige Pfad ist nur bei aktiviertem Full URL zulässig, und die Basisadresse für das Anthropic-Format wird ohne /v1 geschrieben
405 Not Allowed, 301 oder HTML statt einer AntwortDie Anfrage ging am API vorbei: Für das OpenAI-Format fehlt in der Basisadresse /v1 oder bei aktiviertem Full URL wurde nur die Basisadresse angegebenPassen Sie die Adresse an eine der Tabellenoptionen an: Basisadresse bei deaktiviertem Full URL, vollständiger Pfad bei aktiviertem
Code 984, Incorrect model nameDie Model ID stimmt nicht mit der Kennung auf dem Gateway übereinKopieren Sie die Kennung Zeichen für Zeichen aus der Modelltabelle
Code 4028 und Text mit 429Das Modell ist überlastet: Zu Stoßzeiten ist die Kapazität eines bestimmten Modells im Netzwerk manchmal vollständig ausgelastetVersuchen Sie es nach einigen Sekunden erneut oder wechseln Sie zu einem benachbarten Modell; den Netzwerkzustand sehen Sie auf der Statusseite
Code 4054, Model Request failedDie Anfrage an Ihr eigenes Modell kam nicht an oder wurde unterbrochenÜberprüfen Sie auf der Statusseite, ob das Gateway erreichbar ist, und vergleichen Sie die Einstellungen zur Modellerfassung über Edit: Format, Adresse, Kennung
Code 7000: Modell akzeptiert keine BilderAn die Nachricht ist ein Bild angehängt, aber die Netzwerkmodelle sind textbasiertEntfernen Sie das Bild oder verwenden Sie für diese Aufgabe ein integriertes Modell mit Bilderkennung
Eigenes Modell gewählt, aber ein anderes antwortetAuto Mode ist eingeschaltetSchalten Sie ihn in der Modellliste aus

Was das kostet

Ein Agent in der IDE verbraucht Tokens schneller als ein Chat: In jede Anfrage fließen Systemanweisungen, Tool-Beschreibungen, geöffnete Dateien und die Historie der Schritte ein. Daher bestimmt der Preis pro Token, ob man den Agenten für jede Kleinigkeit starten kann oder ob man sparen muss.

Über das JoinGonka Gateway kosten Tokens $0.0069 pro Million für den Input und $0.021 pro Million für den Output — der Preis ist für alle Netzwerkmodelle gleich und wird auf dieser Seite aus einer Live-Quelle übernommen. Die Größenordnung der Preise für September 2026:

SzenarioVerbrauchÜber Gateway
Einmalige Aufgabe: Dateien lesen und eine Änderung vornehmenzehntausende TokensBruchteile eines Cents
Tag mit aktiver Arbeit am Agenten3-7M Tokenseinige Cents
Monat täglicher Entwicklung~150M Tokensetwa ein bis zwei Dollar

Der Vergleich mit Trae selbst ist aufschlussreich, da es auch unter den integrierten Modellen offene Modelle gibt und Trae deren Preisliste pro Million Tokens veröffentlicht. DeepSeek-V4-Flash und MiniMax-M2.7 kosten dort $0.30 für den Input und $1.20 für den Output, und GLM-5.3 Flash ist in der integrierten Liste der internationalen Version gar nicht vorhanden. Über das Gateway beträgt der Unterschied bei denselben Modellen etwa ×43 beim Input und ×58 beim Output.

MethodeWie es berechnet wirdWas begrenzt es
Integrierte Trae-ModelleNach Tokens gemäß Trae-Preisliste, vom monatlichen Dollar Usage-Limit; über dem Limit — Aufschlag On-Demand UsageTariflimit und dessen Preis
Eigenes Modell + JoinGonka GatewayNach Tokens zum Netzwerkpreis, vom Gateway-GuthabenNur das Guthaben: Der Verbrauch ist im Dashboard nach Tagen, Schlüsseln und Modellen einsehbar

Was bei der Arbeit zu beachten ist

Ihr eigenes Modell funktioniert dort, wo es eine Modellliste gibt. Dies gilt für Chats und Agenten – sowohl im IDE-Modus als auch in SOLO (eigene Modelle werden dort seit Version 3.3.0 unterstützt). Autovervollständigung und Korrekturvorhersagen sind ein separater Mechanismus namens CUE mit einem eigenen Einstellungsbereich: Eine Modellauswahl ist dort nicht möglich, und die Limits werden vom Trae-Tarif festgelegt.

Tools und MCP. Trae-Agenten fungieren als MCP-Clients, und die von Ihnen verbundenen Server bleiben für den Agenten mit seinem Modell verfügbar: Alle Modelle des Netzwerks unterstützen den nativen Tool-Aufruf. Wenn Trae meldet, dass das Argumentenschema des Tools nicht mit dem Modell kompatibel ist (Code 4027), versuchen Sie es mit einem benachbarten Netzwerkmodell oder einem anderen MCP-Server.

TraeWork. In der separaten TraeWork-Anwendung ist das Formular zum Hinzufügen eines eigenen Modells gleich, aber laut Dokumentation funktioniert es nur in TraeWork Desktop und nur für Aufgaben in einer lokalen Umgebung.

Plugin für fremde Editoren. In der Dokumentation des TraeCode-Plugins für VS Code und JetBrains gibt es keinen Abschnitt über eigene Modelle – dieser Leitfaden bezieht sich auf die Desktop-IDE. Wenn Sie in VS Code bleiben, wird dasselbe Gateway über Agenten-Erweiterungen verbunden, beispielsweise Cline.

Privatsphäre. Die Einstellung Privacy Mode (Settings → Account) steuert, was Trae selbst mit Ihren Dialogen und Codefragmenten macht: Mit dieser Einstellung fließen sie nicht in Analysen und Training ein. Seitens des Gateways werden keine Dialoge gespeichert: Prompts und Antworten bleiben dort nach der Antwort nicht erhalten; im Dashboard sind nur Abfrage- und Token-Zähler sichtbar.

Wenn Sie mit Bildern arbeiten müssen – ein Layout, ein Fehler-Screenshot –, weisen Sie diese Aufgabe einem integrierten Modell mit Vision-Fähigkeiten zu, während Code, Befehle und Dateien dem Netzwerkmodell überlassen bleiben: Das Umschalten erfolgt mit einem Klick in der Modellliste.

Trae verbindet sich mit dem JoinGonka Gateway über Settings → Models → Add Model → Custom Model: OpenAI Chat Completions-Format mit der Adresse https://gate.joingonka.ai/v1 oder Anthropic Messages mit der Adresse https://gate.joingonka.ai, Modell-ID und jg-Schlüssel. Der Full URL-Umschalter entscheidet, wer den Pfad vervollständigt – mischen Sie die Modi nicht. Lassen Sie in den zusätzlichen Einstellungen die Serie Default und legen Sie das Kontextfenster je nach Modell fest: DeepSeek V4 Flash — 380000 und 32768, MiniMax M2.7 — 200000 und 8192, GLM-5.3 Flash — 390000 und 8192. Und vergessen Sie nicht, Auto Mode auszuschalten: In diesem Modus verwendet Trae seine eigenen Modelle nicht.

Möchten Sie mehr erfahren?

Erkunden Sie andere Abschnitte oder beginnen Sie jetzt GNK zu verdienen.

Schlüssel und kostenlose Token erhalten →