Crush + JoinGonka Gateway: Gonka ağı modellerinde Charm ajanı

1. Adım: Crush'ı kurun. Projenin README'sinde belirtilen resmi yöntemler:

# Homebrew
brew install charmbracelet/tap/crush

# npm
npm install -g @charmland/crush

# Arch Linux
yay -S crush-bin

# Windows
winget install charmbracelet.crush

# Go
go install github.com/charmbracelet/crush@latest

Aynı yerde Debian, Ubuntu, Fedora ve RHEL, Nix ve Scoop için paket depoları da açıklanmış; sürüm sayfasında ise hazır binary'ler yer alıyor. Kontrol için crush --version komutunu çalıştırın; yanıt olarak crush version v0.96.1 gibi bir satır gelecektir.

2. Adım: anahtar alın. gate.joingonka.ai/register adresinden kaydolun, adresinizi doğrulayın ve «API anahtarları» bölümünde jg- önekine sahip bir anahtar oluşturun. Ağdaki tüm modeller için tek anahtar ve tek bakiye geçerlidir.

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

npx @joingonka/setup --tool crush

Kurulum betiği anahtarı soracaktır — komut satırı argümanları arasında iletilmez ki kabuk geçmişine düşmesin — ve dört şey yapar:

• joingonka sağlayıcısını ~/.config/crush/crush.json dosyasına yazar: türü openai-compat, ağ geçidi adresi, anahtar düz metin olarak ve bağlam pencereleri, yanıt üst sınırları ve milyon token başına fiyatlarıyla ağın üç modeli — bu bilgileri kurulum anında ağ geçidinden canlı olarak alır ve Crush oturum maliyetini bunlara göre hesaplar. Dosya 600 izinlerine sahip olur;
• modelleri atar: large yuvasına DeepSeek V4 Flash, small yuvasına MiniMax M2.7; GLM-5.3 Flash ise manuel seçim listesinde kalır. Bunu yalnızca large yuvası boşsa veya ağdan çıkmış olan bizim modelimizi gösteriyorsa yapar; başka bir seçim varsa korunur ve çıktıda nasıl değiştirileceğine dair bir ipucu görünür;
• seçimin geçerli olacağını doğrular: Crush arayüzünden yapılan model seçimi bir durum dosyasında tutulur ve bu dosya yapılandırmayı geçersiz kılar — bu konu large ve small bölümünde anlatılmıştır;
• yedek alır, diğer sağlayıcıları ve ayarları olduğu gibi bırakır ve anahtarı, adresi ve modeli hemen test etmek için ağ geçidine canlı bir istekle bitirir.

Başka bir model --model bayrağıyla ve deepseek, glm veya minimax kısaltmasıyla belirlenir; açıkça belirtilen model her zaman yazılır. Kurulum betiği özel dizinleri tıpkı Crush'ın kendisi gibi dikkate alır: yapılandırma için CRUSH_GLOBAL_CONFIG, durum dosyası için CRUSH_GLOBAL_DATA ve ayrıca XDG_CONFIG_HOME ile XDG_DATA_HOME. Sunucular ve betikler için soru sormayan bir mod vardır; bu modda anahtar ortam değişkeninden alınır:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool crush --model glm --non-interactive

Crush'ın ana formatı artık crushrc olsa da kurulum betiği crush.json yazar: bunu tüm sürümler anlar. Zaten bir crushrc dosyanız varsa Crush iki dosyayı birleştirir, anahtarlar çakışırsa crushrc kazanır ve kurulum betiği ona dokunmaz.

Kurulum aracının yaptığı her şeyi elle de yazabilirsiniz. İşte çalışan bir ~/.config/crush/crush.json — bu dosyayı ağ geçidinden geçirdik:

{
  "$schema": "https://charm.land/crush.json",
  "providers": {
    "joingonka": {
      "name": "JoinGonka (Gonka)",
      "type": "openai-compat",
      "base_url": "https://gate.joingonka.ai/v1",
      "api_key": "jg-your-key",
      "models": [
        { "id": "deepseek-ai/DeepSeek-V4-Flash-0731", "name": "DeepSeek V4 Flash (Gonka)",
          "context_window": 380000, "default_max_tokens": 32768,
          "can_reason": true, "supports_attachments": false },
        { "id": "MiniMaxAI/MiniMax-M2.7", "name": "MiniMax M2.7 (Gonka)",
          "context_window": 200000, "default_max_tokens": 8192,
          "can_reason": false, "supports_attachments": false },
        { "id": "zai-org/GLM-5.3-Flash", "name": "GLM-5.3 Flash (Gonka)",
          "context_window": 390000, "default_max_tokens": 8192,
          "can_reason": true, "supports_attachments": false }
      ]
    }
  },
  "models": {
    "large": { "provider": "joingonka", "model": "deepseek-ai/DeepSeek-V4-Flash-0731" },
    "small": { "provider": "joingonka", "model": "MiniMaxAI/MiniMax-M2.7" }
  }
}

Crush yalnızca katı JSON kabul eder: bir yorum ya da sarkan virgül — ve başlamaz. Fiyat alanları (cost_per_1m_in, cost_per_1m_out ve önbellek için iki alan) yalnızca maliyet sayacı için gerekli: kurulum aracı oraya ağ geçidinin güncel fiyatını yazıyor; bunlar olmadan da Crush çalışır ve sıfır gösterir — yalnızca $schema'daki şemaya sahip düzenleyici bunları zorunlu olarak işaretler.

Aynı sağlayıcı crushrc biçiminde — bu, Crush'ın yerleşik komutlarıyla sıradan Bash. ~/.config/crush/crushrc dosyası:

provider add joingonka \
  --name "JoinGonka (Gonka)" \
  --type openai-compat \
  --base-url "https://gate.joingonka.ai/v1" \
  --api-key "${JOINGONKA_API_KEY:?set JOINGONKA_API_KEY}"

model add joingonka/deepseek-ai/DeepSeek-V4-Flash-0731 \
  --name "DeepSeek V4 Flash (Gonka)" \
  --context-window 380000 --default-max-tokens 32768 --can-reason true

model add joingonka/MiniMaxAI/MiniMax-M2.7 \
  --name "MiniMax M2.7 (Gonka)" \
  --context-window 200000 --default-max-tokens 8192

model add joingonka/zai-org/GLM-5.3-Flash \
  --name "GLM-5.3 Flash (Gonka)" \
  --context-window 390000 --default-max-tokens 8192 --can-reason true

model large joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
model small joingonka/MiniMaxAI/MiniMax-M2.7

Model burada provider/model-id biçiminde adlandırılıyor: ilk eğik çizgiye kadar sağlayıcının adı, sonrasında ağ kimliği olduğu gibi. ${JOINGONKA_API_KEY:?…} biçimi anahtarı dosyanın dışında tutuyor, ama değişken export edilmezse Crush başlamaz — boş anahtarla istek göndermektense başlangıçta hata almak daha iyi.

Crush'ta model her şey için tek bir tane seçilmez, iki slot için ayrı ayrı seçilir:

Ağın üçüncü modeli olan akıl yürütücü GLM-5.3 Flash, karmaşık mantık işlemleri için seçilir; ancak yanıt sınırının 8192 olduğunu ve bunun bir kısmının akıl yürütme için kullanıldığını unutmamak gerekir – ayrıntılar model incelemesinde mevcuttur. Tek bir çalıştırma için model tam ismiyle belirtilir: crush run -m joingonka/zai-org/GLM-5.3-Flash "…". Mevcut tüm isimleri crush models joingonka komutu listeler.

Durum dosyası. Arayüzde ctrl+l ile seçilen model, Crush tarafından crush.json içine değil, makine durum dosyasına yazılır: ~/.local/share/crush/crush.json, Windows'ta ise %LOCALAPPDATA%\crush\crush.json. Bu dosya hem kullanıcı yapılandırmasından hem de crushrc'den daha önceliklidir: Crush bunları /etc/crush/crush.json → ~/.config/crush/crush.json → ~/.config/crush/crushrc → durum dosyası sırasıyla okur ve her sonraki, bir öncekini geçersiz kılar. Bunlardan daha üstte sadece proje ayarları bulunur – bulunduğu dizindeki crush.json veya crushrc. Dosyaların makinenizde nerede olduğunu crush dirs gösterir.

Test çalışmamızda model seçimini açtık – «JoinGonka (Gonka)» sağlayıcısı orada «✓ Configured» işaretiyle duruyor – ve MiniMax M2.7'yi seçtik. Crush «Large model changed to MiniMax M2.7 (Gonka)» yanıtını verdi ve durum dosyasına şunları kaydetti:

{"models":{"large":{"model":"MiniMaxAI/MiniMax-M2.7","provider":"joingonka","max_tokens":8192}}, …}

Artık bu model, crush.json içinde yazan her şeyden daha önceliklidir. Yükleyici bu durumu tanır ve farklı davranır:

• --model olmadan: Durum dosyasına dokunmaz – bu sizin aktif seçiminizdir – ancak Crush'ın gerçekte hangi modelle açılacağı konusunda uyarı verir: Heads-up: Crush will still start with joingonka/MiniMaxAI/MiniMax-M2.7, not joingonka/deepseek-ai/DeepSeek-V4-Flash-0731. Arayüzde GLM-5.3 Flash veya başka bir sağlayıcının modeli seçiliyse de aynı şekilde davranır;
• açık --model ile: Durum dosyasında tam olarak bir kaydı düzeltir – models.large –, önceden bir kopya saklayarak neyin neyle değiştiğini yazar. Aksi takdirde bayrak sessizce etkisiz kalırdı. Böyle bir çalıştırmadan sonra Crush, test çalışmamızda bayrakta belirtilen modelle açıldı.

Önce Crush'un sağlayıcıyı gördüğünden emin olun:

crush models joingonka

Yanıt olarak üç satır gelir:

joingonka/MiniMaxAI/MiniMax-M2.7
joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
joingonka/zai-org/GLM-5.3-Flash

Ardından arayüz olmadan tek seferlik bir çalıştırma yapın. Proje dizinine bariz bir hata içeren bir dosya koyun ve ondan hatayı bulmasını isteyin:

crush run -q "Read calc.py and tell me in one sentence whether it has a bug."

Ajan dosya okuma aracını kendisi çağırmalı ve satır numarasıyla birlikte özüne uygun yanıt vermeli. Bizim çalıştırmamızda ağdaki üç modelin tümü hatayı buldu, görev 20-40 saniye sürdü. -q bayrağı bekleme göstergesini gizler. crush run modunda tüm araç çağrıları otomatik olarak onaylanır, bu yüzden onu kendi projenizde çalıştırın. Normal arayüzde (crush komutu) etkin model durum çubuğunda görünür: ◇ DeepSeek V4 Flash (Gonka) via JoinGonka (Gonka). Crush oturumları ve günlüğü projenin .crush dizininde saklar; bu dizin kendi .gitignore dosyasıyla git'ten korunur; günlüğü crush logs yazdırır. Ağ geçidi tarafında ise istek panelde görünür: "Kullanım" bölümü, "Modele göre" ve "Anahtara göre" dağılımı.

Bir şeyler ters gittiyse, teşhis genellikle doğrudan mesajdan okunur:

Ajan, token'ları sohbetten farklı harcar: Crush, her cümlenize sistem komut istemini ve araçlarının açıklamalarını ekler, görev genellikle birkaç hamle sürer. Bizim denememizde modele yapılan her istek yaklaşık 11,5 bin giriş token'ı taşıyordu ve "dosyayı oku ve hatayı bul" görevi iki-üç istek ve 23-35 bin token harcadı, neredeyse tamamı giriş token'ıydı. Bu yüzden burada token başına fiyat önemlidir.

JoinGonka Gateway üzerinden token'lar girişte milyon başına $0.0069, çıkışta milyon başına $0.021 maliyetindedir – fiyat tüm ağ modelleri için aynıdır ve bu sayfaya canlı kaynaktan yansıtılır.

Sağ sütundaki tahminler Eylül 2026 fiyatlarına göredir. Karşılaştırma için – genel olarak Crush'ta modeller için nasıl ödeme yapılabileceği:

Crush arayüzündeki maliyet sayacı, yapılandırmadaki fiyat alanlarına göre hesaplama yapar. Oraya kurulum anındaki ağ geçidi fiyatı düşer, ağdaki dolar fiyatı GNK kuruyla birlikte dalgalandığı için sayaç sadece bir referanstır. Tam tüketim ve bakiye, kullanıcı panelindeki "Kullanım" ve "Faturalandırma" bölümlerindedir. Large slotuna varsayılan olarak neden DeepSeek V4 Flash'ın geldiği, model incelemesinde detaylıca açıklanmıştır.

İzinler. Crush arayüzünde varsayılan olarak bir aracı çağırmadan önce izin ister. --yolo bayrağı tüm soruları tek seferde kapatır; nokta atışı güvenilen araçlar ise yapılandırmada listelenir:

# crushrc
permissions allow view ls grep

# crush.json
"permissions": { "allowed_tools": ["view", "ls", "grep"] }

Hatırlatalım: crush run her şeyi kendisi onaylar. Bu Crush'ın bir özelliğidir, model sağlayıcısına bağlı değildir.

İstek zaman aşımı. Modelden uzun süre tek bir yanıt parçası gelmezse Crush isteği keser: 0.96.1 sürümünde bu iki dakikalık sessizliktir (dokümantasyon 60 saniye diyor, ancak kodda ve bizim testimizde iki dakika). Ağ geçidinin bağlantıyı canlı tutmak için gönderdiği servis ping'leri bu sayacı sıfırlamaz — bunu yerel test ortamında doğruladık. Ağ geçidi ise yoğun saatlerde ağdan ilk token'ı 150 saniyeye kadar bekler, bu yüzden payı artırmakta fayda var:

# crushrc
option request-timeout 300

# crush.json
"options": { "request_timeout": 300 }

Commit imzaları. Crush'ın oluşturduğu commit ve pull request'ler varsayılan olarak Assisted-by: Crush:<model> satırını ve "Generated with Crush" ibaresini alır. Bunu istemiyorsanız:

# crushrc
option attribution-trailer-style none
option attribution-generated-with false

# crush.json
"options": { "attribution": { "trailer_style": "none", "generated_with": false } }

Metrikler. Crush geliştiricilere takma adlı kullanım istatistikleri gönderir — yalnızca meta veriler, prompt ve yanıtlar olmadan. CRUSH_DISABLE_METRICS=1 veya DO_NOT_TRACK=1 değişkeniyle kapatılır. Ağ geçidi ise kendi tarafında prompt ve yanıt içeriğini saklamaz — istatistiklerde yalnızca tüketim toplamları kalır.

Yapılandırma bir koddur. Crush hem crushrc hem de crush.json dosyalarını sizin kabuğunuzun yetkileriyle çalıştırır: anahtar alanındaki $(…) yükleme sırasında çalışır ve proje crushrc dosyası, o dizinde Crush'ı açtığınız anda devreye girer. Yapılandırmalarını okumadan ajanı başka birinin deposunda çalıştırmayın.