Trae + JoinGonka Gateway — modele sieci Gonka w AI-IDE

Kompilacja i wersja. Trae ma dwie gałęzie: międzynarodową (dokumentacja na docs.trae.ai) i chińską (docs.trae.cn). Formularz Custom Model jest w obu i działa tak samo; różnią się wbudowane modele i zestaw presetów w ustawieniach dodatkowych. Dowolny adres zapytania dla własnego modelu jest obsługiwany od wersji 3.5.51 z 14 kwietnia 2026 — jeśli twoja kompilacja jest starsza, zaktualizuj ją. Międzynarodowa kompilacja nie jest dostępna we wszystkich krajach: przed instalacją sprawdź listę obsługiwanych krajów i regionów.

System. macOS 12 i nowszy, Windows 10 lub 11 (x64), Linux w pakietach .deb i .rpm. Przy pierwszym uruchomieniu Trae zaproponuje wybór motywu i języka, import ustawień z VS Code lub Cursor oraz zalogowanie się do konta.

Klucz JoinGonka. Zarejestruj się na bramie, otwórz w panelu sekcję „Klucze API” i kliknij „Utwórz klucz”. Klucz zaczyna się od jg- i jest pokazywany tylko raz — zapisz go od razu. Warto założyć osobny klucz dla Trae: w sekcji „Użycie” jego zużycie będzie widoczne w osobnym wierszu.

Plan Trae. Swój model trzeba wybrać ręcznie z listy modeli, a w tabeli planów Trae w darmowym planie w wierszu wyboru modelu widnieje tylko tryb Auto — w nim własne modele nie są używane. Czy to ograniczenie dotyczy modeli dodanych własnym kluczem, dokumentacja nie mówi wprost. Praktyczna zasada jest prosta: jeśli w twoim planie Auto Mode można wyłączyć na liście modeli, wszystko gotowe; jeśli nie — potrzebny będzie plan płatny.

1. Otwórz Settings → Models — panel zarządzania modelami.
2. Kliknij Add Model. W otwartym oknie wybierz opcję Custom Model, a nie dostawcę z gotowej listy.
3. Wypełnij pola wartościami z tabeli. Kolumny są dwie — po jednej dla każdego formatu API; wybierz jeden.
4. Kliknij Add Model. Trae wykona próbne wywołanie API i sprawdzi klucz: w razie sukcesu model pojawi się na liście, w razie niepowodzenia okno pokaże komunikat o błędzie i log odpowiedzi dostawcy.

Pozostałe pola nie zależą od formatu:

Który format wybrać. Zacznij od OpenAI Chat Completions: to główna ścieżka bramy, na niej działa większość narzędzi. Anthropic Messages przyda się, jeśli jesteś przyzwyczajony do tego formatu w innych narzędziach lub chcesz porównać zachowanie agenta na dwóch protokołach — klucz i saldo są wspólne.

Jak działa Full URL. Przełącznik decyduje, kto dopisuje ścieżkę. Wyłączony — podajesz adres bazowy, a Trae dodaje ścieżkę zgodnie z wybranym formatem: /chat/completions do adresu z /v1 dla OpenAI i /v1/messages do korzenia dla Anthropic. Włączony — adres jest używany tak, jak jest, i ścieżka musi być w nim podana w całości. Najczęstszy błąd to mieszanie trybów: wpisanie pełnej ścieżki przy wyłączonym przełączniku lub adresu bazowego przy włączonym.

Jeden wpis — jeden model. Powtórz kroki dla pozostałych modeli sieci, aby przełączać się między nimi bez wracania do ustawień: deepseek-ai/DeepSeek-V4-Flash-0731, MiniMaxAI/MiniMax-M2.7 i zai-org/GLM-5.3-Flash. Aktualną listę zwraca GET https://gate.joingonka.ai/v1/models. Dodany model można później edytować, wyłączyć (pozostanie w panelu, ale zniknie z listy w czacie) lub usunąć.

Pod głównymi polami znajduje się zwijana lista Advanced Settings. Można ją pominąć — Trae podstawi wartości domyślne — ale dwa ustawienia warto skonfigurować świadomie: serię modelu i okno kontekstowe.

Ceny modeli w sieci są takie same, więc wybór zależy od zachowania. Wszystkie modele z tabeli obsługują natywny tool calling, na którym opiera się praca agentów Trae.

Jak działa budżet rozumowania i dlaczego nie można obniżać limitu wyjściowego w modelach reasoning, wyjaśniono w przeglądzie GLM-5.3 Flash; porównanie modeli w zadaniach programistycznych znajduje się w artykule o najlepszych modelach do kodu.

Własne modele znajdują się na ogólnej liście: kliknij nazwę bieżącego modelu w prawym dolnym rogu pola wprowadzania czatu i wybierz dodany model. W tym samym miejscu znajduje się przełącznik Auto Mode — powinien być wyłączony: w trybie Auto Trae sam wybiera model z wbudowanych i nie używa tych dodanych przez Ciebie.

Daj agentowi zadanie wymagające narzędzia, na przykład: „Przeczytaj package.json i wymień skrypty budowania”. Agent powinien otworzyć plik i odpowiedzieć merytorycznie — oznacza to, że cykl „zapytanie — wywołanie narzędzia — odpowiedź” przez bramkę działa poprawnie. Następnie otwórz panel bramki, sekcję „Użycie”: w bloku „Według kluczy” dla klucza Trae pojawią się zapytania i czas ostatniego użycia, a w bloku „Według modeli” — wybrany model.

Jeśli coś poszło nie tak, sprawdź treść błędu. Trae nie ukrywa odpowiedzi własnego modelu: błąd dostawcy pokazuje w oryginale, z własnym kodem 4028.

Agent w IDE zużywa tokeny szybciej niż czat: każde zapytanie zawiera instrukcje systemowe, opis narzędzi, otwarte pliki i historię kroków. Dlatego cena za token determinuje, czy można uruchamiać agenta do każdej drobnostki, czy trzeba oszczędzać.

Przez JoinGonka Gateway tokeny kosztują $0.0069 za milion na wejściu i $0.021 za milion na wyjściu — cena jest taka sama dla wszystkich modeli w sieci i jest pobierana na tej stronie ze źródła na żywo. Rzędy wielkości cen na wrzesień 2026:

Porównanie z samym Trae jest wymowne, ponieważ otwarte modele znajdują się również wśród wbudowanych, a Trae publikuje ich cennik za milion tokenów. DeepSeek-V4-Flash i MiniMax-M2.7 kosztują tam $0.30 na wejściu i $1.20 na wyjściu, a GLM-5.3 Flash w ogóle nie ma we wbudowanej liście międzynarodowej wersji. Przez bramkę różnica dla tych samych modeli wynosi około ×43 na wejściu i ×58 na wyjściu.

Twój model działa tam, gdzie znajduje się lista modeli. To czat i agenci — zarówno w trybie IDE, jak i w SOLO (modele użytkownika są w nim wspierane od wersji 3.3.0). Autouzupełnianie i przewidywanie edycji to oddzielny mechanizm CUE z własnym panelem ustawień: brak w nim wyboru modelu, a jego limity są wyznaczane przez plan taryfowy Trae.

Narzędzia i MCP. Agenci Trae działają jako klienci MCP, a podłączone przez Ciebie serwery pozostają dostępne dla agenta w jego modelu: wszystkie modele sieci obsługują natywne wywoływanie narzędzi. Jeśli Trae zgłosi, że schemat argumentów narzędzia jest niezgodny z modelem (kod 4027), spróbuj użyć sąsiedniego modelu sieci lub innego serwera MCP.

TraeWork. W osobnej aplikacji TraeWork formularz dodawania własnego modelu jest taki sam, ale zgodnie z dokumentacją działa on tylko w TraeWork Desktop i tylko dla zadań w środowisku lokalnym.

Wtyczka do innych edytorów. W dokumentacji wtyczki TraeCode dla VS Code i JetBrains nie ma sekcji dotyczącej własnych modeli — ten przewodnik odnosi się do desktopowego IDE. Jeśli korzystasz z VS Code, ten sam gateway jest podłączany przez rozszerzenia agentowe, na przykład Cline.

Prywatność. Ustawienie Privacy Mode (Settings → Account) steruje tym, co sam Trae robi z Twoimi dialogami i fragmentami kodu: po jego włączeniu nie trafiają one do analityki ani szkolenia. Ze strony gatewaya dialogi nie są przechowywane: prompty i odpowiedzi nie pozostają na nim po udzieleniu odpowiedzi; w panelu użytkownika widać tylko liczniki zapytań i tokenów.

Jeśli potrzebujesz pracy z obrazami — makieta, zrzut ekranu błędu — powierz takie zadanie wbudowanemu modelowi z funkcją widzenia, a kod, polecenia i pliki pozostaw modelowi sieci: przełączanie zajmuje jedno kliknięcie na liście modeli.