Zoo Code + JoinGonka Gateway: Roo Code'dan Gonka modellerine geçiş

1. Adım: eklentiyi kur. VS Code'da eklenti panelini aç (Ctrl+Shift+X, macOS'ta Cmd+Shift+X), „Zoo Code“ ara ve Zoo Code Organization yayıncısının eklentisini kur. Tek komutla aynısı:

code --install-extension ZooCodeOrganization.zoo-code

VS Code 1.100 veya üzeri gerekir — eklentinin manifestinde böyle yazıyor; VSCodium, Windsurf ve Marketplace'i olmayan diğer editörler için eklenti Open VSX'te yayımlandı. Kararlı kanalın (18 Eylül 2026 tarihli 3.82.2) yanında bir ön sürüm kanalı 3.83.x var — ana dalın nightly derlemeleri; çalışmak için kararlı olanı seç. Kurulumdan sonra etkinlik çubuğunda Zoo Code simgesi görünür.

2. Adım: anahtar al. gate.joingonka.ai/register adresinden kaydol, adresini doğrula ve „API anahtarları“ bölümünde jg- önekli bir anahtar oluştur. Zoo Code için ayrı bir anahtar açmak pratiktir: harcaması istatistiklerde ayrı bir satırda görünür.

3. Adım: kurulum betiğini çalıştır.

npx @joingonka/setup --tool zoo --model deepseek

Kurulum betiği anahtarı sorar — komut satırı argümanı olarak iletilmez, böylece kabuk geçmişine düşmez. Yazacağı bir şey de yok: Zoo Code, sağlayıcı profillerini ve anahtarlarını bir dosyada değil, VS Code'un korumalı gizli bilgi deposunda tutar. Bu yüzden kurulum betiği, form için hazır değerleri ve seçilen modelin gerçek limitlerini yazdırır:

Zoo Code is configured in the VS Code extension UI (no file is written).\nOpen the Zoo Code settings (gear icon) → API Provider, then enter:\n\n  API Provider: OpenAI Compatible\n  Base URL:     https://gate.joingonka.ai/v1\n  API Key:      jg-your-key\n  Model:        deepseek-ai/DeepSeek-V4-Flash-0731\n\nThen set the real limits of this model under Model Configuration\n(the defaults do not fit any Gonka model):\n\n  Context Window Size: 380000\n  Max Output Tokens:   32768\n  Image Support:       off\n\nZoo Code relies on native tool calling only — all our Gonka models support it.

Ardından ağ geçidine yapılan canlı bir isteğin sonucu gelir — başarılıysa şu satır: ✓ Verified: the gateway accepted the key, base URL and model. Anahtar, adres ve model ilk görevde değil, hemen doğrulanır. Anahtar, yazdırılan blokta tam olarak yer alır ki rahatça kopyalanabilsin — bu çıktıyı yayımlama.

--model bayrağı olmadan kurulum betiği MiniMax M2.7'yi yerleştirir: modelin elle seçildiği yerlerde ağdaki en yüksek kapasiteli modeli önerir. Zoo Code için DeepSeek V4 Flash ile başlamanı öneririz: testimizde araç sonucundan sonraki adımı ilk istekte tamamladı — ayrıntılar test bölümünde; bayrak glm (GLM-5.3 Flash) ve minimax kısaltmalarını da kabul eder. --tool bayrağı olmadan kurulum betiği 25 araçtan oluşan bir menü gösterir.

Formla ilgili bir ayrıntı: Zoo Code 3.82.2'de Model Configuration başlıklı ayrı bir blok yok. Limit alanları aynı formda daha aşağıda, „Configure the capabilities and pricing for your custom OpenAI-compatible model“ açıklamasının altında duruyor; üstelik Max Output Tokens, Context Window Size'dan önce geliyor.

Zoo Code ilk çalıştırıldığında Choose your provider butonu içeren bir karşılama ekranı gösterir: bu buton, OpenRouter'ın önceden seçili olduğu bir forma yönlendirir — sağlayıcıyı OpenAI Compatible olarak değiştirin ve sonunda Finish butonuna tıklayın. Aynı forma daha sonra Zoo Code panelinin başlığındaki dişli simgesinden Providers bölümüne giderek ulaşabilirsiniz; değişiklikler Save butonu ile kaydedilir.

Ağ modellerinin limitleri:

Geri kalanına dokunmanıza gerek yok: Enable streaming ve Include max output tokens seçeneklerini açık, Enable R1 model parameters ve Use Azure seçeneklerini ise kapalı bırakın (bunlar R1 ailesi modelleri ve Azure OpenAI içindir), Custom Headers ve Extra Body alanlarını boş bırakın.

Limitler modelde değil profilde saklanır: Eğer aynı profilde Model değiştirilirse, pencere boyutu ve yanıt tavanı aynı kalır. Bu nedenle, her model için ayrı bir profil oluşturmak daha pratiktir — bu konuda bir sonraki bölümde anlatılmıştır.

Zoo Code, Roo Code kod tabanından gelişti, bu nedenle taşıma sadece birkaç dakika sürer ve proje dosyalarına dokunmanıza gerek kalmaz. Resmi taşıma kılavuzu ayarların dışa ve içe aktarılmasını açıklar; gerisi ayrı bir düğme ile taşınır veya eski yollardan okunur:

Zaten JoinGonka Gateway'e bakan bir Roo Code profili, adres, anahtar, model ve limitlerle birlikte taşınacaktır — sadece modelin şu anda ağda olduğundan emin olun: liste GET https://gate.joingonka.ai/v1/models ile alınır.

Modlar ve Profiller. Beş yerleşik mod vardır: Code, Debug, Architect (sadece Markdown dosyalarını düzenler), Ask (düzenleme yapmadan yanıtlar) ve Orchestrator (alt görevleri diğer modlara dağıtır). Bunlar, giriş alanının yanındaki listeden, mesajın başında mod adıyla (örneğin /architect) veya Ctrl+. (macOS'te Cmd+.) kısayoluyla değiştirilebilir. Her mod, içinde en son çalıştığınız profili hatırlar ve mod değiştiğinde Zoo Code profili otomatik olarak değiştirir.

Buradan uygun bir şema çıkar: modlara sabitlenmiş model başına bir profil. Settings → Providers altında Configuration Profile alanının yanındaki “+” işaretine tıklayın, profili adlandırın (örneğin Gonka DeepSeek) ve formu doldurun; aynı işlemi GLM-5.3 Flash ve MiniMax M2.7 için tekrarlayın — hepsinin adresi ve anahtarı aynıdır. Ardından her modda, giriş alanının yanındaki profil listesinden profili seçin; mod bunu kaydedecektir. Bu listedeki kilit simgesi ise tam tersine, çalışma klasöründeki tüm modlar için bir profili sabitler.

Akıl yürütme seviyesi. Formdaki Enable Reasoning Effort işareti Low, Medium, High, Extra High ve Max listesini açar; kapalı olduğu sürece seviye isteğe dahil edilmez. GLM-5.3 Flash'ta anahtar aslında ikilidir: Low akıl yürütmeyi kapatır, diğer herhangi bir seviye onu tam bırakır — hızlı sorular için Low seviyeli ayrı bir GLM profili tutmak uygundur. Detaylar GLM-5.3 Flash incelemesinde. DeepSeek V4 Flash ve MiniMax M2.7'de ağ geçidi ölçeği yeniden yazmaz: seviyenin nasıl çalışacağı modelin kendisine bağlıdır.

İçinde bariz bir hata olan küçük bir dosya içeren bir klasör açın, örneğin toplama yerine çıkarma yapan bir toplama fonksiyonuna sahip calc.py dosyası, ve Code modunda şunu yazın: «calc.py dosyasını oku ve tek bir cümleyle içinde hata olup olmadığını söyle». Zoo Code dosyayı okumak için izin isteyecektir — «Zoo wants to read this file», eğer okuma işlemi Auto-Approve'da önceden izin verilmemişse Approve ve Deny butonları çıkacaktır. Ardından model bir tamamlama aracı çağıracak ve görev, içeriksel bir yanıtla birlikte Task Completed bloğuyla sona erecektir; eğer varsa, muhakeme ayrı bir Thinking bloğunda gösterilir. Görev başlığının daraltılmış halindeki bağlam doluluk yüzdesi Context Window Size'a göre hesaplanır; bu da onu doğru ayarlamanız için bir başka nedendir.

Bu akışı Zoo Code örneğindeki bir sorguyla yeniden oluşturduk – akış, katı bir şemadaki araçlar, geçmişte read_file sonucu. DeepSeek V4 Flash, attempt_completion fonksiyonunu doğru bir çıktıyla, yani fonksiyonun toplama yerine çıkarma yaptığı tespitiyle yanıtladı. Kontrolün ikinci yarısı ise ağ geçidi paneli: „Kullanım“ bölümünde sorgu modellere göre döküm halinde görünecek ve anahtarın son erişim zamanı güncellenecektir.

Auto-Approve olmadan hata, Retry ve Start New Task butonlarını içeren bir API Request Failed bloğu olarak görünür; yanında kod ve tekrar denemeye kadar geçen süreyi gösteren Provider Error başlığı yer alır. Ağ geçidinden gelen yanıt metni mesajın içinde veya detaylarında görülebilir:

Ajan, tokenları bir sohbetten farklı harcar. Zoo Code her sorguya, mod kurallarını içeren bir sistem istemi, araç tanımları ve çalışma klasörü hakkında bilgiler ekler – sorunuzdan önce bile binlerce token – ve bir görev genellikle birkaç adımdan oluşur. Bu yüzden token fiyatı burada belirleyicidir.

JoinGonka Gateway üzerinden tokenlar girişte milyon başına $0.0069, çıkışta milyon başına $0.021 maliyete sahiptir – fiyat, ağdaki tüm modeller için aynıdır ve bu sayfaya canlı bir kaynaktan çekilir. Eylül 2026 fiyatlarına göre toplam tutarların düzeni:

Karşılaştırma için – Zoo Code'da modellere genel olarak nasıl ödeme yapılabilir:

Input Price ve Output Price doldurulduğunda, görevin maliyeti başlığında görülür, ancak sent hassasiyetinde – ağ modellerindeki kısa görevler orada $0.00 gösterir. Kesin tüketim ve bakiye, panelde «Kullanım» ve «Faturalandırma» bölümlerindedir.

Onaylar ve özerklik. Varsayılan olarak Auto-Approve kapalıdır ve Zoo Code okuma, yazma ve komutlar için izin ister; uzun görevler için giriş alanının yanındaki Auto-approve menüsünden gerekli kategorileri açın. Komutlar için Destructive Command Guard (Settings → Auto-Approve) bulunur: eklenti çalıştırılabilir dosyasını indirir, sonrasında izin verilen komutlar otomatik olarak yürütülürken, engellenenler onay bekler. Auto-Approve ile Zoo Code başarısız istekleri kendisi tekrar dener: duraklama 5 saniyeden başlar ve her denemede ikiye katlanır, ancak 10 dakikayı geçmez.

Akış yanıtı. Enable streaming'i kapatmayın: akışta ağ geçidi metni oluşturulduğu anda iletir ve yanıtı sadece modelin tavanıyla sınırlar; akışsız ve açık bir limit içermeyen istek ise 1500 yanıt tokeninde kesilir (GLM-5.3 Flash için bu 3000'dir).

Kod indeksleme. Proje genelinde anlamsal arama (Codebase Indexing), modelden ayrı olarak embedding sağlayıcısı üzerinden yapılandırılır; bunun için yerel bir seçenek olan Semble - Local mevcuttur.

Resimler. Ağ modelleri metin tabanlıdır. Ekran görüntüleri ve taslaklar için resimlerle çalışan bir model içeren ayrı bir profil oluşturun ve bu tür bir görev için ona geçiş yapın.

Gizlilik. Zoo Code, kurulum kimliğine bağlı hata ve kullanım verilerini geliştiricilere gönderir – kod ve istemler hariç; bu, Settings → About Zoo Code altındaki Allow error and usage reporting anahtarıyla devre dışı bırakılabilir. Ağ geçidi tarafında ise istem ve yanıt içerikleri saklanmaz: kabinede sadece istek ve token sayaçları görülür.