Goose + JoinGonka Gateway: Kendi sağlayıcınız ve keyring'de anahtar

1. Adım: Goose'u kurun. CLI için proje dokümantasyonundaki resmi yöntemler:

# macOS and Linux: the script puts the binary in ~/.local/bin
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

# macOS, Homebrew
brew install block-goose-cli

CONFIGURE=false değişkeni, betiğin aksi halde kurulumdan hemen sonra başlattığı goose configure sihirbazını devre dışı bırakır: sağlayıcıyı kurulum programı ayarlayacak. ~/.local/bin dizini PATH içinde yoksa betik bunu size söyler. Windows için aynı depoda download_cli.ps1 betiği var; masaüstü uygulaması ise dokümantasyon sayfasından indirilir; o ve CLI aynı ayarları okur, bu nedenle aşağıdaki her şey ikisi için de geçerlidir. Kontrol — goose --version.

2. Adım: Anahtar alın. gate.joingonka.ai/register adresinden kaydolun, adresi doğrulayın ve „API anahtarları" bölümünde jg- önekli bir anahtar oluşturun. Tek bir anahtar ve tek bir bakiye ağdaki tüm modeller için geçerlidir.

3. Adım: Kurulum programını çalıştırın.

npx @joingonka/setup --tool goose

Kurulum programı anahtarı sorar — kabuk geçmişinde kalmaması için komut satırı argümanlarında iletilmez — ve şunları yapar:

• Gateway adresini ve ağın gerçek bağlam pencerelerine sahip üç modelini içeren custom_providers/custom_joingonka.json sağlayıcı dosyasını 600 izinleriyle oluşturur. custom_joingonka ve CUSTOM_JOINGONKA_API_KEY adları, Goose'un „JoinGonka" adından kendisinin türettiği adlarla aynıdır, böylece sihirbazdaki anahtar tam olması gereken yere düşer;
• JoinGonka'yı DeepSeek V4 Flash modeliyle varsayılan sağlayıcı yapar — ancak yalnızca henüz sağlayıcı seçilmemişse ya da boş veya ağdan kaybolmuş bir modelle bizimki seçiliyse. Başkasının seçimine dokunmaz, bunun yerine denemek için komutu yazdırır: goose session --provider custom_joingonka --model …;
• Anahtarı secrets.yaml dosyasına yalnızca Goose'un gizli anahtar deposu kesin olarak dosya tabanlıysa koyar; aksi halde geriye tek bir adım kaldığını doğrudan söyler — ayrıntılar anahtarla ilgili bölümde;
• Değiştirilen dosyaların yedeklerini alır ve sonunda anahtarı, adresi ve modeli hemen doğrulamak için gateway'e canlı bir istek gönderir.

Kurulum programı ayar dizinini Goose'un kendisiyle aynı şekilde bulur: Linux ve macOS'ta ~/.config/goose, Windows'ta %APPDATA%\Block\goose\config, GOOSE_PATH_ROOT ayarlıysa <root>/config. Başka bir modeli --model bayrağı deepseek, glm veya minimax kısaltmasıyla belirler; açıkça belirtilen model her zaman yazılır. Soru sormayan mod, anahtarı ortam değişkeninden alır:

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

Kurucunun yaptığı her şeyi manuel olarak yazabilirsiniz. Sağlayıcı (Provider) ayrı bir JSON dosyasıdır: ~/.config/goose/custom_providers/custom_joingonka.json; dosya adı name alanıyla aynı olmalıdır:

{
  "name": "custom_joingonka",
  "engine": "openai",
  "display_name": "JoinGonka",
  "description": "JoinGonka Gateway — Gonka AI inference (OpenAI-uyumlu)",
  "api_key_env": "CUSTOM_JOINGONKA_API_KEY",
  "base_url": "https://gate.joingonka.ai/v1/chat/completions",
  "models": [
    { "name": "deepseek-ai/DeepSeek-V4-Flash-0731", "context_limit": 380000 },
    { "name": "zai-org/GLM-5.3-Flash", "context_limit": 390000 },
    { "name": "MiniMaxAI/MiniMax-M2.7", "context_limit": 200000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

Goose model kaydı için ayrı bir yanıt tavanı öngörülmemiştir. Bu tür modeller için istekte hiçbir kısıtlama iletilmez — bunu istek günlüklerinden kontrol ettik — ve akış modunda ağ geçidi yanıtı modelin tavanı ile sınırlar: DeepSeek V4 Flash için 32.768 token, GLM-5.3 Flash ve MiniMax M2.7 için 8192 token. Bunun için genel GOOSE_MAX_TOKENS değişkenini ayarlamanıza gerek yoktur: tüm sağlayıcılar için tek bir değişkendir.

Goose, sağlayıcı dosyasını katı JSON ayrıştırması ile okur: bir yorum veya sondaki virgül (trailing comma) hatası sağlayıcının listeden kaybolmasına neden olur. Bunu sihirbaz ile de oluşturabilirsiniz (goose configure → Custom Providers), ancak sihirbaz bağlam penceresini sormaz — onu manuel olarak eklemeniz gerekir.

Sağlayıcı ve varsayılan model ~/.config/goose/config.yaml içinde yaşar. Goose bunları şu şekilde kaydeder:

active_provider: custom_joingonka
providers:
  custom_joingonka:
    enabled: true
    model: deepseek-ai/DeepSeek-V4-Flash-0731
    configured: true

Eski düzen — dosyanın kökündeki düz GOOSE_PROVIDER ve GOOSE_MODEL anahtarları — da çalışır: Goose bunu okur ve ayarları ilk kez kaydettiğinde (bizim goose configure sonrasında yaptığımız gibi) yeni formata kendisi dönüştürür. Kurucu boş bir dosyada düz anahtarlar yazar; bunları her sürüm anlar. Aynı adlı ortam değişkenleri dosyadan daha önemlidir: kabukta (shell) ayarlanmışlarsa, config.yaml'den gelen seçim etkili olmaz ve kurucu bu konuda sizi uyarır.

Goose'un sağlayıcı dosyasında yalnızca secret'ın adı var — CUSTOM_JOINGONKA_API_KEY. Değeri ise şu sırayla arar: bu adı taşıyan ortam değişkeninde, ardından sistem secret deposunda (keyring, macOS'te Keychain), sonra config'in yanındaki secrets.yaml dosyasında. Secret'lar dosyaya, Goose'un deposu dosya tabanlı olduğunda yazılır ve orada düz metin olarak, 600 izinleriyle durur. config.yaml içindeyse Goose anahtarları hiç aramaz (dokümantasyon).

Depo, keyring kapalıysa dosya tabanlı hale gelir — GOOSE_DISABLE_KEYRING değişkenine herhangi bir değer verilmesi ya da config.yaml içine GOOSE_DISABLE_KEYRING: true satırının eklenmesiyle — ya da keyring kullanılamıyorsa: grafik oturumu olmayan sunucu, container, CI. İkinci durumda Goose log'a «Keyring unavailable. Using file storage for secrets.» yazar ve kendiliğinden dosyaya geçer — container'da tam olarak bunu gördük. Yükleyici keyring'e yazamaz, ama sizin yerinize onu da kapatmaz: Goose o zaman orada zaten duran secret'ları göremez hale gelirdi. Buradan şu senaryolar çıkıyor:

Kalan adım. goose configure komutunu çalıştırın ve sihirbazın sorularını yanıtlayın — bizim denememizde şöyle görünüyorlardı:

• What would you like to configure? → Configure Providers;
• Which model provider should we use? → JoinGonka (bizde ilk sıradaydı);
• Would you like to set CUSTOM_JOINGONKA_API_KEY? (optional) → Yes, ardından Enter value for CUSTOM_JOINGONKA_API_KEY satırına anahtarı yapıştırın — karakterlerin yerine kareler görünecek. Anahtar anında kaydedilir;
• Would you like to configure advanced settings? → No;
• Select a model — listeyi Goose gateway'den alır: MiniMaxAI/MiniMax-M2.7, deepseek-ai/DeepSeek-V4-Flash-0731, zai-org/GLM-5.3-Flash. İmleç ilk satırda durur — yükleyicinin seçtiği modeli korumak için ok tuşlarıyla DeepSeek V4 Flash'ı seçin. Bir test isteğinin ardından sihirbaz «Configuration saved successfully» satırıyla biter.

Goose Desktop'ta yol şöyle: Settings → Models → Configure providers → JoinGonka → anahtar → Submit. Anahtarı elle yapıştırmak istemiyorsanız bir değişkene koyun ve sihirbazı aynı kabuktan başlatın: Goose «CUSTOM_JOINGONKA_API_KEY is set via environment variable» yazar ve değeri kaydetmeyi önerir:

read -s CUSTOM_JOINGONKA_API_KEY && export CUSTOM_JOINGONKA_API_KEY
goose configure

Tek bir çalıştırma için anahtarı hiç kaydetmeden de verebilirsiniz: CUSTOM_JOINGONKA_API_KEY=jg-your-key goose session, PowerShell'de — $env:CUSTOM_JOINGONKA_API_KEY = "jg-your-key"; goose session. Ortam değişkeni kayıtlı değerden önceliklidir, ama yalnızca kabuk kapanana kadar yaşar.

Önce Goose'un gerçekte hangi ayarları gördüğüne bakın:

goose info -v

„goose Configuration“ bloğunda GOOSE_PROVIDER: custom_joingonka ve model kimliğini içeren GOOSE_MODEL satırları bulunmalıdır. Ardından etkileşimli oturum olmadan tek seferlik bir çalıştırma yapın: boş bir dizine bariz bir hata içeren bir dosya koyun ve hatayı bulmasını isteyin.

goose run --no-session -t "Read calc.py and tell me in one sentence whether it has a bug."

--no-session bayrağı çalıştırmayı geçmişe kaydetmez. Başlıkta ● new session · custom_joingonka deepseek-ai/DeepSeek-V4-Flash-0731 gibi bir satır, ardından araç çağrısı — cat calc.py komutuyla ▸ shell — ve bulunan hatayı içeren yanıt görünür. Tek bir çalıştırma için başka bir modeli --model belirler: zai-org/GLM-5.3-Flash veya MiniMaxAI/MiniMax-M2.7. 23 Eylül 2026'daki çalıştırmamızda ağdaki üç modelin tamamı „istek → araç → sonuç → yanıt“ döngüsünü geçti. Goose CLI, modellerin akıl yürütmesini varsayılan olarak gizler — çıktı terminale gidiyorsa GOOSE_CLI_SHOW_THINKING=1 değişkeniyle gösterilebilir. Ağ geçidi tarafında istek panelde görünür: „Kullanım“ bölümü, „Modellere göre“ ve „Anahtarlara göre“ dökümü.

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

Bir ajan, jetonları (tokens) bir sohbetten farklı şekilde harcar. Standart yapılandırmada bile Goose, modellere on sekiz yerleşik aracın açıklamalarını gönderir ve bizim çalışmamızda, siz sorunuzu sormadan önce her tur yaklaşık 4,6 bin giriş jetonu taşıyordu. «Dosyayı oku ve hatayı bul» görevi iki-üç tur ve 10-15 bin jeton aldı, neredeyse tamamı giriş; Goose, oturumun adını bulmak için kendi kendine kısa bir istek daha yapar. Gereksiz eklentiler goose configure → Toggle Extensions altından kapatılabilir — bu, girişi azaltmanın en kolay yoludur.

JoinGonka Gateway üzerinden jetonlar girişte milyon başına $0.0069 ve çıkışta milyon başına $0.021 maliyetindedir — fiyat ağdaki tüm modeller için aynıdır ve bu sayfada canlı kaynaktan çekilir.

Sağ sütundaki tahminler Eylül 2026 fiyatlarına göredir. Karşılaştırma için — Goose'da modeller için nasıl ödeme yapabilirsiniz:

Tam tüketim ve bakiye, kabinede «Kullanım» ve «Faturalandırma» bölümlerindedir. Neden varsayılan olarak ağdaki en yüksek yanıt tavanına sahip DeepSeek V4 Flash'ın ayarlı olduğu, model incelemesinde ayrıntılı olarak açıklanmıştır.

Onay modu. Goose varsayılan olarak auto modunda çalışır — tamamen özerk: dosyaları kendi başına düzenler ve siler, komutlar çalıştırır ve eklentileri kullanır, hiçbir şey sormaz. Kendi projenizde bu kullanışlıdır, başkasının kodunda modu sıkılaştırmak daha iyidir:

# inside a session
/mode smart_approve

# permanently, as a line in config.yaml
GOOSE_MODE: smart_approve

Bu Goose'un kendi özelliğidir, model sağlayıcısına bağlı değildir.

Model değiştirme. Oturum içinde — kimlikle birlikte /model komutu, örneğin /model zai-org/GLM-5.3-Flash; tek bir çalıştırma için — goose run ve goose session komutlarında --model bayrağı; kalıcı olarak — goose configure ya da config.yaml içindeki model satırı. Sağlayıcı bu sırada aynı kalır. Akıl yürüten GLM-5.3 Flash karmaşık mantık için iyidir, ancak yanıtının tavanı 8192 token ve bunun bir kısmı akıl yürütmeye gider — ayrıntılar model incelemesinde.

Gözetimsiz çalıştırmalar. goose run betikler ve CI için uygundur: -q bayrağı çıktıda yalnızca modelin yanıtını bırakır, --output-format json sonucu işlenmek üzere verir. --max-turns (aracın insan katılımı olmadan kaç adım attığı) ve --max-tool-repetitions (aynı argümanlarla bir aracın üst üste kaç kez çağrılabileceği) sınırlayıcıları döngüye girmeye karşı korur.

Gizlilik. Goose'ta anonim kullanım istatistikleri varsayılan olarak kapalıdır (GOOSE_TELEMETRY_ENABLED). Ağ geçidi prompt ve yanıt içeriklerini saklamaz — istatistiklerde yalnızca tüketim toplamları kalır.