Trae + JoinGonka Gateway — AI-IDE'de Gonka ağı modelleri

Build ve sürüm. Trae'in iki kolu var: uluslararası (dokümantasyon docs.trae.ai'de) ve Çin (docs.trae.cn). Custom Model formu her ikisinde de mevcut ve aynı şekilde yapılandırılmış; farklılık yerleşik modellerde ve ek ayarlardaki preset kümesinde. Kendi modeliniz için serbest istek adresi 14 Nisan 2026 tarihli 3.5.51 sürümünden itibaren destekleniyor — build'iniz daha eskiyse güncelleyin. Uluslararası build her ülkede kullanılamaz: kurulumdan önce desteklenen ülke ve bölgeler listesine göz atın.

Sistem. macOS 12 ve üzeri, Windows 10 veya 11 (x64), Linux için .deb ve .rpm paketleri. Trae ilk açılışta tema ve dil seçmenizi, ayarları VS Code veya Cursor'dan içe aktarmanızı ve hesaba giriş yapmanızı önerir.

JoinGonka anahtarı. Gateway'e kaydolun, panelde „API Anahtarları" bölümünü açın ve „Anahtar oluştur"a tıklayın. Anahtar jg- ile başlar ve yalnızca bir kez gösterilir — hemen kaydedin. Trae için ayrı bir anahtar oluşturmak pratiktir: „Kullanım" bölümünde harcaması ayrı bir satırda görünür.

Trae tarifesi. Kendi modelinizi model listesinden elle seçmeniz gerekir ve Trae'in tarife tablosunda ücretsiz planda model seçimi satırında yalnızca Auto modu yazar — bu modda kendi modelleriniz kullanılmaz. Bu kısıtlamanın kendi anahtarınızla eklenen modeller için de geçerli olup olmadığını dokümantasyon açıkça belirtmiyor. Pratik kural basit: planınızda Auto Mode model listesinde kapatılabiliyorsa her şey hazır; kapatılamıyorsa ücretli bir plan gerekir.

1. Settings → Models bölümünü açın — model yönetim paneli.
2. Add Model seçeneğine tıklayın. Açılan pencerede hazır listeden bir sağlayıcı yerine Custom Model seçeneğini seçin.
3. Alanları tablodaki değerlerle doldurun. Her API formatı için birer sütun olmak üzere iki sütun var; birini seçin.
4. Add Model seçeneğine tıklayın. Trae bir deneme API çağrısı yapacak ve anahtarı kontrol edecek: başarılı olursa model listede görünür, başarısız olursa pencere bir hata mesajı ve sağlayıcının yanıt günlüğünü gösterir.

Diğer alanlar formata bağlı değildir:

Hangi formatı seçmeli. OpenAI Chat Completions ile başlayın: ağ geçidinin ana yolu budur ve çoğu araç bununla çalışır. Anthropic Messages, bu formata diğer araçlardan alışkınsanız veya ajanın davranışını iki protokolde karşılaştırmak istiyorsanız işinize yarar — anahtar ve bakiye ikisinde ortaktır.

Full URL nasıl çalışır. Anahtar, yolu kimin eklediğine karar verir. Kapalıyken siz temel adresi verirsiniz ve Trae seçilen formata göre yolu ekler: OpenAI için /v1 içeren adrese /chat/completions, Anthropic için kök adrese /v1/messages. Açıkken adres olduğu gibi kullanılır ve yolun tamamı adreste yer almalıdır. En sık yapılan hata modları karıştırmaktır: anahtar kapalıyken tam yolu yazmak veya anahtar açıkken temel adresi yazmak.

Bir kayıt — bir model. Ağdaki diğer modeller için de adımları tekrarlayın, böylece ayarlara geri dönmeden aralarında geçiş yapabilirsiniz: deepseek-ai/DeepSeek-V4-Flash-0731, MiniMaxAI/MiniMax-M2.7 ve zai-org/GLM-5.3-Flash. Güncel liste GET https://gate.joingonka.ai/v1/models ile alınır. Eklediğiniz modeli daha sonra düzenleyebilir, devre dışı bırakabilir (panelde kalır ama sohbet listesinden kaybolur) veya silebilirsiniz.

Temel alanların altında daraltılabilir bir Advanced Settings listesi bulunur. Buraya dokunmanıza gerek yoktur — Trae varsayılan değerleri atayacaktır —, ancak iki ayarı bilinçli olarak yapmakta fayda var: model serisi ve bağlam penceresi (context window).

Ağ modellerinin fiyatı aynıdır, bu nedenle seçim davranışla ilgilidir. Tablodaki tüm modeller, Trae ajanlarının çalışmasının temelini oluşturan yerel tool calling özelliğini destekler.

Akıl yürütme bütçesinin nasıl düzenlendiği ve reasoning modellerinin çıkış limitinin neden çok düşürülmemesi gerektiği GLM-5.3 Flash incelemesinde açıklanmıştır; geliştirme görevlerinde model karşılaştırmaları için kod için en iyi modeller makalesine göz atabilirsiniz.

Kendi modelleriniz genel listede bulunur: Sohbet giriş alanının sağ alt köşesindeki mevcut model adına tıklayın ve eklediğiniz modeli seçin. Aynı yerde Auto Mode anahtarı bulunur — bu kapalı olmalıdır: Auto modundayken Trae kendi bünyesindeki modellerden birini seçer ve sizin eklediklerinizi kullanmaz.

Agent'a bir araç gerektiren bir görev verin, örneğin: «package.json dosyasını oku ve derleme script'lerini listele». Agent dosyayı açmalı ve içeriğe göre cevap vermelidir — bu, «istek – araç çağrısı – cevap» döngüsünün ağ geçidi (gateway) üzerinden kurulduğu anlamına gelir. Ardından ağ geçidi panelini, «Kullanım» bölümünü açın: «Anahtarlara göre» bloğunda Trae anahtarı için istekler ve son erişim zamanı görünür, «Modellere göre» bloğunda ise seçilen model görünür.

Eğer bir şeyler ters giderse hata metnine bakın. Trae kendi modelinin cevabını gizlemez: Sağlayıcının hatasını olduğu gibi, kendi kodu olan 4028 ile gösterir.

IDE'deki bir Agent, sohbetten daha hızlı token harcar: Her istekte sistem talimatları, araç tanımları, açık dosyalar ve adım geçmişi gönderilir. Bu nedenle token başına fiyat, Agent'ı her küçük şey için çalıştırıp çalıştıramayacağınızı veya tasarruf etmeniz gerekip gerekmediğini belirler.

JoinGonka Gateway üzerinden tokenlar girişte milyon başına $0.0069 ve çıkışta milyon başına $0.021 maliyetindedir — fiyat tüm ağ modelleri için aynıdır ve bu sayfaya canlı kaynaktan çekilir. Eylül 2026 fiyatlarına göre tutarların ölçeği:

Trae ile karşılaştırma yapıldığında, açık modellerin dahili modeller arasında da olduğu ve Trae'in bunların milyon token başına fiyat listesini yayınladığı için sonuç şeffaftır. DeepSeek-V4-Flash ve MiniMax-M2.7 orada girişte $0.30 ve çıkışta $1.20 maliyetindedir, GLM-5.3 Flash ise uluslararası yapının dahili listesinde hiç yoktur. Ağ geçidi üzerinden aynı modellerde fark, girişte yaklaşık ×43 ve çıkışta ×58 civarındadır.

Kendi modeliniz, model listesinin olduğu yerde çalışır. Bu, hem IDE modunda hem de SOLO'da (kendi modelleri 3.3.0 sürümünden itibaren desteklenmektedir) sohbet ve ajanlar için geçerlidir. Otomatik tamamlama ve düzenleme tahmini, kendi ayarlar paneline sahip ayrı bir CUE mekanizmasıdır: Burada model seçimi yoktur ve limitleri Trae tarifesi belirler.

Araçlar ve MCP. Trae ajanları MCP-istemcisi olarak hareket eder ve bağladığınız sunucular, kendi modelindeki ajan için erişilebilir kalır: ağdaki tüm modeller yerel araç çağrısını destekler. Trae, araç argüman şemasının modelle uyumsuz olduğunu bildirirse (kod 4027), komşu bir ağ modelini veya başka bir MCP sunucusunu deneyin.

TraeWork. Ayrı bir TraeWork uygulamasında, kendi modelinizi ekleme formu aynıdır, ancak belgelere göre sadece TraeWork Desktop'ta ve yerel ortamdaki görevler için çalışır.

Diğer editörler için eklenti. VS Code ve JetBrains için TraeCode eklentisinin belgelerinde kendi modellerinizle ilgili bir bölüm yoktur; bu kılavuz masaüstü IDE'si ile ilgilidir. VS Code'da kalırsanız, aynı ağ geçidi Cline gibi ajan eklentileri aracılığıyla bağlanır.

Gizlilik. Privacy Mode (Settings → Account) ayarı, Trae'in diyaloglarınız ve kod parçalarınızla ne yapacağını kontrol eder: Bu mod açıkken verileriniz analiz ve eğitim için kullanılmaz. Ağ geçidi tarafında diyaloglar saklanmaz: istemler ve yanıtlar yanıt verildikten sonra saklanmaz; panelde sadece istek ve token sayaçları görünür.

Görsellerle çalışmanız gerekiyorsa – bir maket, hata ekran görüntüsü gibi – bu görevi dahili görme yeteneğine sahip modele verin, kodu, komutları ve dosyaları ise ağ modeline bırakın: geçiş yapmak model listesinde tek bir tıklama ile gerçekleşir.