Cherry Studio + JoinGonka Gateway — masaüstü AI istemcisi

Kurulum. Tüm sistemler için derlemeler projenin sürüm sayfasında: Windows için kurucu ve taşınabilir sürüm, macOS için dmg imajı, Linux için AppImage, deb ve rpm – x64 ve ARM için. Sohbet geçmişi ve ayarlar yerel olarak, kendi makinenizde saklanır.

V1 mi V2 mi. Ağustos 2026'da yeni veri yapısı ve elden geçirilmiş ayarlarla V2 serisi çıktı; önceki serinin son derlemesi 1.9.13. Kendi sağlayıcınız her ikisinde de var; ekleme biçimi ve bazı etiketler farklı – bu tür yerler aşağıda işaretlendi. V1'den geçişte sağlayıcı ve model ayarları otomatik olarak taşınır, V1 kaynak verileri korunur ancak yeni veriler geriye senkronize edilmez ve iki serinin yedekleri uyumsuzdur. Güncellemeden önce Cherry Studio belgelerindeki taşıma bölümünü okuyun.

JoinGonka anahtarı. Gateway'e kaydolun, hesabınızda „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. Cherry Studio için ayrı bir anahtar açmak pratiktir: „Kullanım“ bölümünde harcaması ayrı bir satırda görünür.

1. Dişli simgesine tıklayın – ayarlar açılır. Model Provider bölümünü seçin (İngilizce dokümantasyonda Model Services olarak geçer).
2. Sağlayıcı listesinin altındaki Add Provider düğmesine tıklayın.
3. V2'de Add Custom Provider penceresi açılır. Provider Name alanına örneğin JoinGonka yazın. Endpoint settings bloğunda OpenAI satırına https://gate.joingonka.ai/v1 adresini girin: Alanın altında nihai yolu gösteren Request path satırı belirir – bu yol /v1/chat/completions ile bitmelidir. API Key alanına jg-your-key yapıştırın ve Add düğmesine basın.
4. V1'de pencere daha kısadır: sağlayıcı adı ve Provider Type – OpenAI seçin. Anahtar ve adres, sağlayıcı sayfasında API Key ve API Host alanlarına girilir.
5. Sağlayıcının etkin olduğundan emin olun: Anahtar, sayfasının sağ üst köşesindedir. V2'de yeni sağlayıcılar kapalı olarak eklenir ve kapalı bir sağlayıcının modelleri seçim listelerinde görünmez.

Cherry Studio adresi nasıl oluşturur. API Host alanı temel adresi alır, yolu uygulama kendisi ekler ve sonucu alanın altındaki Preview satırında gösterir. Kurallar her iki sürüm serisinde de aynıdır:

Eski kılavuzlarda bir kural daha geçer: Adresin sonundaki eğik çizgi sözde /v1'i devre dışı bırakır. Bu kural, 1.6 serisi dahil olmak üzere erken sürümlerde geçerliydi ve 1.7'de kaldırıldı: güncel sürümlerde otomatik eklemeyi yalnızca # devre dışı bırakır.

Sağlayıcı eklendi ancak sohbette henüz görünmüyor: Cherry Studio seçim listelerine sadece sizin açıkça eklediğiniz modeller girer. Bunun iki yolu vardır.

Sunucudan liste çekme. Sağlayıcı sayfasında Sync models (V1'de Manage, ardından Fetch model list) butonuna basın. Cherry Studio ağ geçidinden GET /v1/models isteğinde bulunacak ve ağdaki güncel modelleri gösterecektir; gerekli modelleri + butonuyla ekleyin. Manuel ekleme. Add Model butonu, zorunlu bir alanı olan bir form açar — Model ID: tanımlayıcı, karakteri karakterine tam olarak girilmelidir.

Ağ modellerinin fiyatı aynıdır, bu yüzden hepsini ekleyin — aralarında seçim yaparken bütçeye değil, davranışa göre karar vermeniz gerekecektir:

Model tipleri. Listedeki her modelin, yeteneklerinin (Vision, Reasoning, Tool vb.) işaretlendiği bir ayarlar butonu vardır. Bazı işaretlemeleri Cherry Studio otomatik yapar, ancak ağ geçidi modelleri için bunları kontrol etmek gerekir. Vision özelliği kapalı olmalıdır: ağ modelleri metin tabanlıdır. Tool, MCP-araçları bağlıyorsanız gereklidir — yerel araç çağrısı tablodaki tüm modeller tarafından desteklenir. Reasoning, GLM-5.3 Flash için uygundur — bu ağın reasoning modelidir.

Varsayılan model. Default Model ayarlar bölümünde, yardımcı roller için modeller atanır. Asistanın ana modeli olarak DeepSeek V4 Flash'ı ayarlayın. Diyalog isimlerini oluşturan ve arama sorgularını hazırlayan hızlı bir model için Cherry Studio belgeleri hafif ve hızlı, reasoning olmayan bir model önerir — ağ modelleri arasından bu rol için en uygun olanı MiniMax M2.7'dir, GLM-5.3 Flash'ı zorunlu düşünme süreçleri nedeniyle buraya eklemeyin. Çeviri için ilk ikisinden herhangi biri uygundur.

Sağlayıcı sayfasındaki anahtar bloğunda bir Model Check düğmesi bulunur (V1 sürümünde anahtar alanının hemen yanında Check olarak geçer). Bir model seçin; Cherry Studio ona kısa bir deneme isteği gönderecek ve sonucu yanıt gecikmesiyle birlikte gösterecektir. Kontrol başarılı olduysa sohbet kısmına geçin, model değiştiriciden ağ geçidi (gateway) modelini seçin ve istediğiniz soruyu sorun.

İsteklerin gerçekten ağ geçidi üzerinden gittiğinden emin olmak için panelini açın ve «Kullanım» (Usage) bölümüne gidin: «Anahtarlara göre» (By keys) bloğunda Cherry Studio anahtarı için istekler ve son erişim zamanı görünür, «Modellere göre» (By models) bloğunda ise seçilen model görünür. V2'de Usage ayarlar bölümünde istemcinin kendi istatistikleri de bulunur: sağlayıcılara, modellere ve anahtarlara göre token ve istek sayıları. Buradaki maliyetler referans amaçlıdır; Cherry Studio bunları Gonka ağı fiyatlarına göre değil, modellerin genel fiyat listelerine göre tahmin eder, bu nedenle kesin tutarları ağ geçidi panelinde görebilirsiniz.

Eğer bir şeyler ters giderse, nedeni neredeyse her zaman yanıttan anlaşılabilir:

İstemcinin kendisi ücretsiz dağıtılır, sadece çıkarım (inference) için ödeme yaparsınız. JoinGonka Gateway üzerinden token'lar giriş için milyon başına $0.0069, çıkış için milyon başına $0.021'dir; fiyat tüm ağ modelleri için aynıdır ve bu sayfaya canlı bir kaynaktan çekilir. Sohbet, ajan araçlarına kıyasla çok daha az token harcar, bu nedenle Eylül 2026 fiyatlarıyla yaklaşık maliyetler şu şekildedir:

Uzun diyaloglar hakkında önemli bir not: İstemci her replikada modele tüm geçmişi yeniden gönderir, bu nedenle yüzüncü replika ilkine göre daha pahalıdır. Çözüm: Her yeni görev için yeni bir diyalog; Cherry Studio'da bu tek bir düğmedir.

Tek bir diyalogda model karşılaştırması. Cherry Studio aynı anda birden fazla modele tek bir soru sorabilir: Modelleri, model değiştiriciden seçmeniz yeterlidir; her biri ayrı bir istek ile yanıt verecektir. Ağdaki tüm modeller için tek bir fiyat olduğunda, MiniMax M2.7'nin nerede yeterli olduğunu, nerede DeepSeek V4 Flash'ın uzun yanıtına ihtiyaç duyulduğunu ve nerede GLM-5.3 Flash'ın muhakeme yeteneğinin karşılığını verdiğini anlamanın en hızlı yolu budur – ayarları model incelemesinde ayrıntılı olarak açıklanmıştır.

Aynı anahtar ile ikinci protokol. Ağ geçidi, Anthropic formatında da yanıt verir. V2 diyaloğunda, Endpoint settings bloğunda bunun için ayrı bir Anthropic satırı bulunur: Oraya https://gate.joingonka.ai yazın ve Request path satırında /v1/messages yolunun oluştuğundan emin olun. V1'de aynı sonuç, Provider Type Anthropic olan ve aynı adrese sahip ayrı bir sağlayıcı ile elde edilir. V2'de More options düğmesinin altında OpenAI Responses satırı da bulunur – ağ geçidi bunu da destekler, adresi OpenAI ana satırı ile aynıdır.

Terminal ajanlarını çalıştırma. Code CLI sayfasında (dokümantasyonda Coding Companion olarak geçer), Cherry Studio konsol ajanlarını kurar ve çalıştırır; sağlayıcıyı ve modeli kendi ayarlarından çeker. Oradaki sağlayıcı listesi, aracın ihtiyaç duyduğu protokole göre filtrelenir. Bu nedenle, buradan Claude Code çalıştırmayı planlıyorsanız Anthropic adresini önceden doldurmanız gerekir. Aynı ajanın aracılar olmadan nasıl yapılandırılacağı, Claude Code + Gonka rehberinde yer almaktadır.

Bilgi tabanı. V2'de herhangi bir embedding modeli olmadan da çalışır – BM25 metin araması üzerinden. Embedding modeli ile hibrit arama devreye girer. Gonka ağı modelleri üretken olduğu için, hibrit mod için başka bir sağlayıcıdan bir embedding modeli kullanın, örneğin Ollama üzerinden yerel bir model; bulunan parçalara göre yanıtı ise ağ geçidi modeli verecektir.

Tarayıcıda ekip için ortak bir sohbet mi lazım? Cherry Studio kişisel bir masaüstü istemcisidir. Kullanıcı hesaplarına sahip ortak bir web arayüzü için Open WebUI'ye göz atın: Aynı adres ve anahtar ile ağ geçidine bağlanır.