ZCode: GLM Coding Plan yerine ucuz GLM çıkarımı

ZCode bir «sohbet kenar çubuğuna sahip düzenleyici» değil, bir ADE'dir: Siz bir hedef tanımlarsınız, ajan bir plan oluşturur, dosyaları düzenler, kontrolleri başlatır ve sonuca ulaşana kadar yineleme yapar. macOS ve Windows üzerinde masaüstü uygulaması olarak çalışır (Linux sürümü beta aşamasındadır).

Sürüm 3.0'ın temel özellikleri:

• ZCode Agent — GLM-5.2 ile derin entegrasyona sahip kendi ajansal çekirdeği; bunun dışında üçüncü taraf ajanlar (Claude Code, Codex, Gemini CLI vb.) bağlanabilir;
• Goal-modu (/goal) — uzun süreli otonom görevler: plan → yürütme → adım adım doğrulama;
• Multi-agent — bir proje üzerinde birkaç ajanın paralel çalışması;
• Uzaktan yönetim — Telegram, WeChat ve Feishu üzerinden oturumları başlatma ve kontrol etme: ajan bilgisayarınızda çalışırken siz telefondan soruları yanıtlayabilirsiniz.

İstemci ücretsizdir, yeni kullanıcılara Z.ai denemeleri için günlük bir GLM-5.2 kota kotası verir. Gerisi ya GLM Coding Plan aboneliği ya da kendi API anahtarınızdır. Ve tam burada detayları anlamak önemlidir, çünkü abonelik yapısı ürünün en çok tartışılan kısmıdır.

GLM Coding Plan, Z.ai'nin aboneliği olup ZCode'da ve yirmi kadar üçüncü taraf araçta GLM modellerine erişim sağlar. Yayın anında (Temmuz 2026) temel tablo şöyle görünüyor — ancak fiyatlar ve kampanyalar değişir, güncel sayfadan kontrol edin: z.ai/subscribe:

Abonelerin şikayetleri (Hacker News ve GitHub başlıkları):

• Yoğun saat çarpanı. Yoğun saatlerde (14:00–18:00 UTC+8 — Asya'da akşam, Avrupa'da sabah-öğle) her istek kotadan ×3 katsayıyla düşer, yoğun olmayan saatlerde ×2. Harcamayı Pekin saat dilimine göre planlamak gerekiyor.
• Kota tokenla değil "prompt"la. Tam olarak kaç token kaldığı şeffaf değil; başlıklarda "GLM'de ~17M token harcadım — ve dört gün blok yedim" gibi hikayeler var.
• Lite ve Pro'da tek paralel istek. Ajan ortamı için bu hissedilir: ZCode'un kendi multi-agent modu ve tüm paralel alt ajanlar kuyruğa takılır.
• GLM-5.2 kotayı küçük modellerden daha hızlı tüketiyor — amiral gemisi, kendi çarpanıyla limiti yakıyor.

Sonuç basit: Sakin bir solo geliştirme için abonelik dürüstçe işliyor. Ancak modunuz ne kadar "ajansal" olursa — paralel görevler, uzun otonom oturumlar, gece çalıştırmaları — kota modeli o kadar sık piyangoya dönüşüyor. Alternatif: gerçek tokenlar üzerinden ödeme — pencere yok, çarpan yok, kuyruk yok: ajan ne kadar harcadıysa o kadar düşülür. ZCode'a entegre custom provider mekanizması tam da bu modeli sunuyor ve beş dakikada kuruluyor.

ZCode, BYOK desteğini resmen yerleşik olarak sunuyor: dokümantasyon, "OpenAI veya Anthropic protokolleriyle uyumlu herhangi bir servisi" eklemeye açıkça izin veriyor – herkese açık API'ler, kurumsal kanallar ve hatta self-hosted kurulumlar. Kurulum üç yoldan yapılır:

• karşılama ekranındaki Connect düğmesi → "Set Your API Key";
• model seçicideki Manage Models;
• dişli simgesi → Settings → Model Settings → Add Provider.

Sağlayıcıya OpenAI Base URL ve/veya Anthropic Base URL ile API Key girilir – mevcut modellerin listesini ZCode kendisi çeker.

En sık takılınan üç tuzak:

• Z.ai endpoint'leri birbirinden farklı. Coding Plan aboneliği yalnızca coding-endpoint https://api.z.ai/api/coding/paas/v4 üzerinden çalışır; abonelik anahtarıyla genel /api/paas/v4 hata döndürür – "plan ödendiği halde 401/429 alıyorum" durumunun klasik nedeni budur.
• "Claude Code'da çalışıyor ≠ ZCode'da çalışıyor." Claude Code'u yapılandırmak için kullanılan ANTHROPIC_BASE_URL gibi ortam değişkenlerini ZCode okumaz: kendine ait bir sağlayıcı ayarları deposu var. Yapılandırmayı mutlaka Settings üzerinden yapın.
• "Model seçicide görünüyor ≠ anahtarın kotası var." Model listesi sağlayıcının API'sinden çekilir, ancak erişilebilirlik ilgili anahtarın bakiyesine ve limitlerine bağlıdır.

Şimdi pratiğe geçelim: JoinGonka gateway'ini ZCode'a bağlıyoruz ve GLM yığınını token karşılığında alıyoruz.

JoinGonka Gateway — merkeziyetsiz Gonka ağına açılan, iki yerel protokole sahip bir ağ geçididir: OpenAI uyumlu /v1/chat/completions ve Anthropic Messages /v1/messages. Ekonomi pay-per-token (token başına ödeme) sistemindedir: 5 saatlik pencereler, ×3 zirve çarpanları veya tek bir eşzamanlı istek limiti yoktur; tüketim gerçek zamanlı olarak gösterge panelinde görünür ve ağ geçidi istem içeriklerini saklamaz.

Adım adım (güncel Custom Provider arayüzü):

Eski ZCode sürümlerinde bunun yerine iki ayrı alan bulunur: OpenAI Base URL (https://gate.joingonka.ai/v1) ve Anthropic Base URL (https://gate.joingonka.ai — yolu istemci kendisi ekler).

Doğrulama: Oluşturduğunuz modeli seçin ve asistana herhangi bir soru sorun. Cevap geldiyse her şey çalışıyor demektir; 401 hatası alıyorsanız anahtarı, 402 alıyorsanız hesap bakiyesini kontrol edin. DeepSeek V4 Flash modelinde Thought Level Max iken «Model request failed» hatası alırsanız, Thought Level ayarını High olarak değiştirin ve isteği tekrarlayın.

İpucu. npx @joingonka/setup --tool zcode komutu bu alanlar için hazır değerleri (base URL, anahtar, model id ve gerçek limitleri: bağlam penceresi ve cevap tavanı) yazdıracak ve ağ geçidinin bunları kabul ettiğini canlı bir istekle doğrulayacaktır. ZCode yalnızca UI üzerinden yapılandırılır; güvenle düzenlenebilecek bir dosyası yoktur, bu nedenle değerleri manuel girmeniz gerekir.

Farklı kanallarda GLM-inference maliyeti nedir (1M token başına fiyat; rakipler için Eylül 2026 verileri sabittir, JoinGonka fiyatı gateway API'sinden sayfaya canlı olarak çekilir):

İki-üç katlık fark pazarlama yuvarlaması değil, farklı bir ekonomidir: hesaplamalar veri merkezi kar marjı üzerinden değil, işi yapan demerkezi ağ katılımcıları tarafından gerçekleştirilir. Bunun nasıl çalıştığına ve uygulanabilirlik sınırlarına dair detaylı analiz — en ucuz AI API konulu makalede.

JoinGonka satırı, Gonka ağındaki GLM-5.3 Flash fiyatıdır: ağdaki tüm modeller tek bir tarifeye tabidir. Bu sayfadaki rakamlar otomatik olarak güncellenir, hiçbir şeyi manuel olarak tekrar hesaplamanız gerekmez.

Gonka ağı artık Z.ai modeline hizmet veriyor: zai-org/GLM-5.3-Flash, #101 numaralı yönetişim teklifi ile kabul edildi ve MiniMax M2.7 ve DeepSeek V4 Flash ile birlikte ağ geçidi üzerinden sunuluyor. Bu rehberin ilk sürümlerinde bahsedilen amiral gemisi GLM-5.2 ise üretime dahil edilmedi; ağ, aynı serinin daha hafif ve hızlı bir modelini seçti. Base URL ve anahtar aynı: ZCode'da modeli custom provider olarak eklemek yeterlidir.

Modelin kendisi hakkında: MIT lisansı altında açık ağırlıklar, 320B parametreli (token başına 18B aktif) MoE mimarisi, hibrit seyrek ve doğrusal dikkat mekanizması. Temel özellik, bunun bir akıl yürütme (reasoning) modeli olmasıdır: cevap vermeden önce düşünür ve bu düşünme süreci basit bir soruda bile birkaç yüz token harcar. ZCode için bu iki anlama gelir: modelin cevap uzunluğu sınırını düşük tutmayın (kısa yanıtlar için bile 600 tokenden başlayarak) ve hızlı düzeltmeler için Thought Level değerini düşürün — API seviyesinde bu reasoning_effort: low değerine denk gelir. Modelin ve limitlerinin ayrıntılı analizi için Gonka ağında GLM-5.3 Flash makalesine göz atın.

Sıkça Sorulan Sorular:

• Yeni modelde neden bazen 429 hatası veya kuyruk oluyor? — Model şu anda ağ ana bilgisayarlarının küçük bir kısmı tarafından sunulmaktadır; yoğun dakikalarda talepler boş bir slot bekleyebilir. Talebi birkaç saniye sonra tekrarlayın — yük dengeleyici aktif bir düğüm bulacaktır. Mevcut durum ağ geçidi durum sayfasında görülebilir.
• Başka neler mevcut? — GLM-5.3 Flash dışında MiniMax M2.7 ve DeepSeek V4 Flash da var: her üç model de ZCode'da aynı custom provider üzerinden çalışır, bu rehberdeki konfigürasyon tamamen işlevseldir.
• Gizlilik ne durumda? — Ağ geçidi, istemlerin ve cevapların içeriğini saklamaz; istatistiklerde sadece toplam tüketim verileri tutulur.
• Coding Plan ne zaman daha avantajlıdır? — Yalnız çalışıyorsanız, Lite kotası dahilinde kalıyorsanız ve paralel ajanlar çalıştırmıyorsanız, sabit ücretli bir abonelik kullanışlı ve tahmin edilebilirdir. Kendi profilinize göre hesaplayın: aktif ajan kullanımıyla, ağ üzerinden token bazlı ödeme yapmak kat kat daha ucuzdur; günde birkaç kez hafif kod düzeltmeleri yapıyorsanız fark hissedilmeyebilir.
• Bu diğer araçlar için uygun mu? — Evet: aynı uç nokta Claude Code, Cursor, Cline ve herhangi bir OpenAI/Anthropic uyumlu istemcide çalışır.