GLM-5.2’yi bugün Claude Code içinde çalıştırabilirsiniz ve kurulum yaklaşık iki dakika sürer. Claude Code, Anthropic’in Messages API’sini konuşan herhangi bir uç noktaya bağlanır ve Zhipu GLM için tam olarak bunu sunar — Claude Code’u z.ai’ye yönlendirin ve işiniz tamam. Buna girmenin iki yolu var: tek tıklamalı bir geçiş uygulaması (en kolay olanı ve istediğiniz zaman Claude’a geri dönmenizi sağlar) veya elle düzenlenen bir yapılandırma dosyası. Bu kılavuz, macOS, Windows ve Linux genelinde her ikisini de kapsar; ayrıca ihtiyaç duyduğunuzda Claude’a nasıl geri döneceğinizi de anlatır.
En hızlı yol: CC Switch
Zaten birden fazla sağlayıcıyla uğraşıyorsanız, manuel yapılandırmayı atlayın ve CC Switch kullanın (açık kaynaklı, MIT lisanslı, Windows/macOS/Linux). Bu, Claude Code, Codex, Gemini CLI ve birkaç başka CLI için sağlayıcı yapılandırmalarını yöneten bir masaüstü uygulamasıdır; böylece JSON’u elle düzenlemek zorunda kalmazsınız.
1. CC Switch'i ccswitch.io adresinden veya GitHub deposundan yükleyin. Ana pencerenin sağ üstündeki turuncu + düğmesine tıklayarak Sağlayıcı Ekleyi açın ve Claude Sağlayıcı sekmesini seçin. 2. Ön ayar aramasına zhipu yazın. İki ön ayar görünür — Zhipu GLM (ana kara uç noktası) ve Zhipu GLM en. Ana kara Çin dışında, uluslararası uç nokta için Zhipu GLM en'i seçin.
3. Aşağı kaydırın ve z.ai API anahtarınızı API Key alanına yapıştırın. Ön ayar, geri kalanını otomatik olarak doldurur: Anthropic Messages (Native) formatı, ANTHROPIC_AUTH_TOKEN kimlik doğrulama alanı ve base URL.
4. Model Mapping içinde, her rol için istenen modeli — Sonnet, Opus, Fable ve Haiku — glm-5.2 olarak ayarlayın, böylece Claude Code hangi katmana erişirse erişsin her istek GLM’ye yönlendirilir. Claude Code’a milyon token’lık bağlamı bildirmek için bir rol üzerindeki 1M kutusunu işaretleyin. Kaydedin.
5. Sağlayıcı listesine geri dönün, Zhipu GLM girişinde Enable'e tıklayın (Claude Official gibi mevcut bir sağlayıcı, daha sonra geri dönmek için listede kalabilir), ardından Claude Code'u yeniden başlatın; böylece yeni sağlayıcıyı aldığından emin olun. Modelin glm-5.2 olarak göründüğünü doğrulamak için /status komutunu çalıştırın.
Bir statik yapılandırma yerine neden uygulamayla uğraşasınız: denemek isteyebileceğiniz çoğu sağlayıcı için hazır ön ayarlarla gelir — Kimi, MiniMax, MiMo, Qwen, DeepSeek ve daha fazlası — bu yüzden her biri bir ön ayar ve anahtar işi olur, bir yapılandırma yeniden yazımı değil; ayrıca aralarında geçiş yapmak (veya Claude'a geri dönmek) yalnızca birkaç tıklamadır. Aşağıdaki hibrit iş akışının pratik temeli budur.
settings.json ile manuel kurulum
Onu kendiniz yapılandırmayı mı tercih edersiniz, yoksa GUI olmayan bir CI kutusu mu kuruyorsunuz? Dosyayı doğrudan düzenleyin.
1. Bir API anahtarı alın Z.AI API konsolundan. Kullandıkça öde anahtarı veya bir GLM Coding Plan abonelik anahtarı da çalışır. 2. Bu env bloğunu Claude Code ayarlar dosyanıza birleştirin (mevcut anahtarları koruyun — tüm dosyanın üzerine yazmayın). Blok tüm platformlarda aynıdır; yalnızca yol farklıdır: - macOS / Linux: ~/.claude/settings.json - Windows: %USERPROFILE%\.claude\settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "your_zai_api_key",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.2",
"API_TIMEOUT_MS": "3000000"
}
}3. Claude Code'u yeniden başlatın, ardından /status komutunu çalıştırın. Model satırı glm-5.2 (veya milyon token varyantı için glm-5.2[1m]) olarak görünmelidir. Hâlâ bir Claude modeli gösteriyorsa, dosya okunmamış demektir — JSON söz dizimi hatalarını kontrol edin ve yolu doğrulayın.
Dosyaya dokunmak istemiyorsanız, kabuk tabanlı iki alternatif:
macOS / Linux — tek seferlik bir oturum için değişkenleri (bash/zsh) dışa aktarın, ardından başlatın:
export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="your_zai_api_key"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.2"
claudeTerminali kapatın ve normal yapılandırmanıza geri dönün.
Windows — kalıcı kullanıcı ortam değişkenlerini PowerShell'de ayarlayın, ardından terminali yeniden başlatın:
setx ANTHROPIC_BASE_URL "https://api.z.ai/api/anthropic"
setx ANTHROPIC_AUTH_TOKEN "your_zai_api_key"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "glm-5.2"ANTHROPIC_DEFAULT_* değişkenleri, Claude Code’un yönlendirdiği model rollerini yeniden eşler — Opus, Sonnet ve Haiku (daha yeni sürümler bir Fable rolü ekler; CC Switch de bunu gösterir). Hepsini glm-5.2 olarak ayarlamak her isteği GLM’e gönderir; arka plan görevlerini ucuz ve hızlı tutmak isterseniz bunun yerine Haiku yuvasını glm-4.5-air adresine yönlendirin. Tam bir milyon tokenlık pencere için glm-5.2[1m] kullanın. Uzun API_TIMEOUT_MS göründüğünden daha önemlidir: GLM yanıtları çoğu zaman Claude’unkinden daha yavaş çalışır ve varsayılan zaman aşımı uzun üretimleri yarıda keser.
Hangi yol: z.ai yerel, bir proxy mi, yoksa Coding Plan mi?
GLM-5.2'yi Claude Code'a beslemenin üç pratik yolu vardır ve bunlar birbirinin yerine kullanılabilir değildir.
z.ai yerel uç nokta (önerilir). Yukarıdaki https://api.z.ai/api/anthropic URL’si. Anthropic protokolünü konuşur, bu nedenle Claude Code herhangi bir ara yazılım olmadan bağlanır — varsayılan seçim.
Bir çeviri proxy'si. Diğer barındırıcılar (Fireworks, NVIDIA NIM, self-hosted weights) GLM-5.2'yi OpenAI-compatible API üzerinden sunar; Claude Code bunu doğrudan okuyamaz, bu yüzden formatları dönüştüren bir proxy'ye ihtiyaç duyarlar. claude-code-router bunu halleder. Yalnızca bu platformlardan birinde zaten krediniz veya donanımınız varsa buna değer.
GLM Coding Plan aboneliği. Aynı z.ai endpoint’ini kullanan ancak token başına ücretlendirme yerine sabit bir ücret alan düz aylık bir plan (ayda 18 $’dan başlayan, z.ai'nin abonelik sayfası). Claude Code'u her gün kullanıyorsanız, bir abonelik genellikle ölçülü token'lara göre daha ucuz ve daha öngörülebilirdir; başa baş noktasını bulmak için bunu aylık token harcamanızla karşılaştırın. Kullanımınız dalgalıysa, kullandıkça öde modeli daha avantajlıdır.
GLM-5.2 ve Claude arasında geçiş yapma
Claude Code aynı anda yalnızca bir etkin sağlayıcı kullanır, bu yüzden yuvaları bölmek yerine *geçiş yaparsınız*: rutin hacim için GLM-5.2 çalıştırın ve mimari, güvenlik açısından hassas kod veya inceleme gerektiğinde CC Switch içinde Claude Official sağlayıcınızı etkinleştirin. Claude tarafı için Anthropic ile uyumlu herhangi bir uç nokta çalışır — Anthropic hesabınız ya da AIReiter gibi bir aktarıcı, birkaç seçenekten biri. Sağlayıcılar arasında istek başına otomatik yönlendirme için, claude-code-router gibi bir ağ geçidi dağıtımı yönetir.
Sorun Giderme
Belirti | Muhtemel neden | Düzeltme |
|---|---|---|
| settings.json yüklenmedi | JSON'un geçerli olduğunu kontrol edin; |
| Yanlış model kimliği (büyük/küçük harfe duyarlı) | Tam olarak |
401 / kimlik doğrulama başarısız | Anahtar/uç nokta uyumsuzluğu | Bir OpenRouter anahtarını z.ai URL'siyle eşleştirmeyin; gerekirse anahtarı yeniden oluşturun |
Uzun üretimler yarıda kesiliyor | Zaman aşımı çok düşük |
|
Araç çağrıları başarısız oluyor veya döngüye giriyor | Bozuk araç JSON'u | Paralel alt ajanları azaltın; yeniden deneyin; talimatı sadeleştirin |
Sıkça sorulan sorular
GLM-5.2 Claude Code'da ücretsiz mi?
Açık uçlu değil, ancak z.ai GLM-5.2 için sınırlı süreli ücretsiz dönemler sundu ve Coding Plan ayda $18'dan başlıyor. Tam kullandıkça öde ücretlerinde bile ($1.40 / milyon başına $4.40), hafif kullanım sadece kuruşlara mal olur.
GLM-5.2, Claude Code’da 1M-token bağlamını destekliyor mu?
Evet. ANTHROPIC_DEFAULT_* değişkenlerinizde model kimliğini glm-5.2 yerine glm-5.2[1m] olarak ayarlayın; Claude Code milyon token penceresini kullanır.
Claude Code'da kodlama için GLM-5.2 mi yoksa Claude mu daha iyi?
Rutin, sıralı düzenlemeler için fiyat farkı GLM-5.2'yi mantıklı varsayılan yapar. Claude, çok adımlı mimari, güvenlik açısından hassas işler ve yüksek eşzamanlılığa sahip alt ajan iş akışlarında öne çıkma eğilimindedir. Geçiş kurulumı, birini seçmek yerine her birini en güçlü olduğu yerde kullanmanızı sağlar.
GLM-5.2'yi Claude Code dışındaki araçlarda kullanabilir miyim?
Evet. Aynı z.ai uç noktası ve anahtarlar diğer agentic CLI'lerle de çalışır — OpenCode, Cline ve Kilo Code'un hepsi özel bir base URL kabul eder ve CC Switch bunların birkaçı için ön ayarları yönetir.
Claude Code içinde GLM-5.2’yi kullanmak için ücretli bir Claude aboneliğine ihtiyacım var mı?
Hayır. Claude Code sadece istemcidir; onu z.ai’ye yönlendirdiğinizde faturalandırmayı Anthropic değil, z.ai yapar. Yalnızca Claude’u geçiş yapabileceğiniz bir sağlayıcı olarak kullanmaya devam ederseniz bir Claude hesabına ihtiyacınız olur.
CC Switch'te sağlayıcıları değiştirdikten sonra Claude Code'u yeniden başlatmam gerekiyor mu?
CC Switch'in dokümanlarına göre, Claude Code sağlayıcı verilerinin yeniden başlatma olmadan anlık olarak değiştirilmesini desteklerken, diğer çoğu CLI aracı için terminal veya uygulamayı yeniden başlatmak gerekir. Pratikte, bir değişikliğin yürürlüğe girdiğinden emin olmanın güvenilir yolu Claude Code'u yeniden başlatmaktır.
CC Switch'te Claude'a (resmi giriş) nasıl geri geçiş yaparım?
Ön ayar listesinden bir Claude Official sağlayıcısı ekleyin, onu etkinleştirin, ardından Claude Code'un normal çıkış yapma / giriş yapma (OAuth) akışını bir kez çalıştırın. Bundan sonra resmi Claude girişiniz ile z.ai gibi üçüncü taraf sağlayıcılar arasında serbestçe geçiş yapabilirsiniz.
CC Switch ücretsiz ve kullanımı güvenli mi?
Evet — MIT lisansı altında açık kaynaklıdır ve ücretsizdir. Yapılandırmalarınız yerel olarak bir SQLite veritabanında atomik yazmalarla saklanır ve tasarım gereği her aracın kendi yapılandırmasında minimum değişiklik yapar; böylece uygulamayı kaldırırsanız bile CLI'leriniz normal şekilde çalışmaya devam eder.