Claude Code'da GLM-5.2 Nasıl Kullanılır? (Eksiksiz Kurulum)

Claude Code'u bugün GLM-5.2 ile çalıştırmaya başlayabilirsiniz; kurulum yaklaşık iki dakika sürüyor. Claude Code, Anthropic Messages API ile konuşan tüm uç noktaları destekliyor ve Zhipu, GLM için tam olarak bunu sunuyor. Claude Code'u z.ai'a yönlendirmeniz yeterli. Bunun için iki yol var: İstediğiniz an Claude'a geri dönmenizi de sağlayan tek tıklamalı bir geçiş uygulaması veya elle düzenlenen yapılandırma dosyası. Bu rehberde macOS, Windows ve Linux için iki yöntemi de, ayrıca gerektiğinde Claude'a nasıl döneceğinizi anlatıyorum.

En pratik seçenek: CC Switch

Birden fazla sağlayıcıyla çalışıyorsanız manuel yapılandırmayla uğraşmak yerine CC Switch kullanın. Açık kaynaklı ve MIT lisanslı bu Windows/macOS/Linux masaüstü uygulaması; Claude Code, Codex, Gemini CLI ve birkaç başka CLI için sağlayıcı yapılandırmalarını yönetiyor. Böylece JSON dosyalarını elle düzenlemeniz gerekmiyor.

1. CC Switch'i ccswitch.io üzerinden veya GitHub deposundan yükleyin. Ana pencerenin sağ üstündeki turuncu + düğmesine tıklayarak Add Provider ekranını açın, ardından Claude Provider sekmesini seçin.
2. Hazır ayar aramasına zhipu yazın. Karşınıza iki seçenek çıkar: Zhipu GLM (anakara uç noktası) ve Zhipu GLM en. Anakara Çin dışındaysanız uluslararası uç nokta için Zhipu GLM en seçeneğini kullanın.

1. Aşağı kaydırın ve z.ai API anahtarınızı API Key alanına yapıştırın. Hazır ayar kalan alanları otomatik doldurur: Anthropic Messages (Native) formatı, ANTHROPIC_AUTH_TOKEN kimlik doğrulama alanı ve temel URL.
2. Model Mapping bölümünde Sonnet, Opus, Fable ve Haiku rollerinin her biri için istenen modeli glm-5.2 olarak ayarlayın. Böylece Claude Code hangi katmana başvurursa vursun tüm istekler GLM'ye gider. Claude Code'a milyon token bağlam penceresini bildirmek için ilgili rolde 1M kutusunu işaretleyin. Ardından kaydedin.

1. Sağlayıcı listesine dönün ve Zhipu GLM satırında Enable düğmesine tıklayın. Daha sonra geri geçmek için Claude Official gibi mevcut bir sağlayıcı listede kalabilir. Yeni sağlayıcının algılandığından emin olmak için Claude Code'u yeniden başlatın. Modelin glm-5.2 olarak göründüğünü doğrulamak için /status komutunu çalıştırın.

Statik yapılandırma yerine uygulamayı tercih etmenin asıl nedeni şu: Kimi, MiniMax, MiMo, Qwen, DeepSeek ve daha pek çok sağlayıcı için hazır ayarlar sunuyor. Böylece her yeni sağlayıcı, yapılandırmayı baştan yazmak yerine hazır ayarı seçip anahtarı ekleme işine dönüşüyor. Sağlayıcılar arasında veya Claude'a geri geçmek de birkaç tıklama sürüyor. Aşağıdaki hibrit çalışma düzeninin pratik temeli bu.

settings.json ile manuel kurulum

Yapılandırmayı kendiniz yapmak istiyorsanız ya da arayüzü olmayan bir CI makinesi kuruyorsanız dosyayı doğrudan düzenleyin.

1. Z.AI API konsolundan bir API anahtarı alın. Kullandıkça öde anahtarı da GLM Coding Plan abonelik anahtarı da çalışır.
2. Bu env bloğunu Claude Code ayar dosyanıza ekleyin. Mevcut anahtarları koruyun; dosyanın tamamının üzerine yazmayın. Blok tüm platformlarda aynı, yalnızca dosya yolu değişiyor:

- 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"
  }
}

1. Claude Code'u yeniden başlatın ve ardından /status komutunu çalıştırın. Model satırında glm-5.2 ya da milyon token varyantı için glm-5.2[1m] görünmelidir. Hâlâ bir Claude modeli görünüyorsa dosya okunmamış demektir; JSON söz dizimi hatalarını kontrol edin ve dosya yolunun doğru olduğundan emin olun.

Dosyaya dokunmak istemezseniz, kabuk üzerinden kullanabileceğiniz iki alternatif daha var:

• macOS / Linux — Tek seferlik oturum için değişkenleri dışa aktarın (bash/zsh), ardından uygulamayı 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"
claude

Terminali kapattığınızda normal yapılandırmanıza dönersiniz.

• Windows — PowerShell'de kalıcı kullanıcı ortam değişkenlerini ayarlayın, sonra 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 Opus, Sonnet ve Haiku model rollerini yeniden eşler. Yeni sürümlerde bir Fable rolü de eklenir; CC Switch bunu da sunuyor. Hepsini glm-5.2 olarak ayarlamak tüm istekleri GLM'ye gönderir. Arka plan görevlerini daha hızlı ve düşük maliyetli tutmak isterseniz Haiku yuvasını bunun yerine glm-4.5-air ile eşleyebilirsiniz. Tam milyon token penceresi için glm-5.2[1m] kullanın. Uzun API_TIMEOUT_MS değeri göründüğünden daha önemli: GLM yanıtları çoğu zaman Claude'dan daha yavaş gelir ve varsayılan zaman aşımı uzun üretimleri yarıda kesebilir.

Hangi yöntem uygun: z.ai, proxy veya Coding Plan?

GLM-5.2'yi Claude Code'a bağlamanın üç pratik yolu var; bunlar birbirinin doğrudan alternatifi sayılmaz.

Doğrudan z.ai uç noktası (önerilen). Yukarıdaki https://api.z.ai/api/anthropic URL'si Anthropic protokolünü konuşur. Bu nedenle Claude Code herhangi bir ara katman olmadan bağlanır; varsayılan tercih bu olmalı.

Biçim dönüştüren proxy. Fireworks, NVIDIA NIM ve kendi barındırdığınız ağırlıklar gibi diğer servisler GLM-5.2'yi, Claude Code'un doğrudan okuyamadığı OpenAI uyumlu API üzerinden sunar. Bu durumda formatları dönüştüren bir proxy gerekir. claude-code-router bu işi yapar. Ancak bu platformlardan birinde zaten krediniz veya donanımınız varsa anlamlıdır.

GLM Coding Plan aboneliği. Aynı z.ai uç noktasını kullanan ancak token başına ücret yerine sabit ücret alan aylık plan. z.ai abonelik sayfasına göre fiyatı aylık $18'dan başlıyor. Claude Code ile her gün kod yazıyorsanız abonelik, ölçümlü token ücretlendirmesine göre genellikle daha ucuz ve daha öngörülebilir olur. Eşik noktayı bulmak için aylık token harcamanızla karşılaştırın. Kullanımınız düzensizse kullandıkça öde daha avantajlıdır.

GLM-5.2 ile Claude arasında geçiş yapmak

Claude Code aynı anda yalnızca tek etkin sağlayıcı kullanır; yani yuvaları bölmek yerine geçiş yaparsınız. Rutin ve yoğun işler için GLM-5.2'yi kullanın; mimari, güvenlik açısından hassas kod veya inceleme gerektiğinde CC Switch'te Claude Official sağlayıcınızı etkinleştirin. Claude tarafında Anthropic uyumlu herhangi bir uç nokta çalışır: Anthropic hesabınız ya da seçeneklerden biri olan AIReiter gibi bir aktarıcı. Sağlayıcılar arasında istek bazında otomatik yönlendirme için claude-code-router gibi bir ağ geçidi dağıtımı üstlenir.

Sorun giderme

Sık sorulan sorular

GLM-5.2, Claude Code'da ücretsiz mi?

Süresiz olarak değil. z.ai, GLM-5.2 için sınırlı süreli ücretsiz kullanım dönemleri sundu; Coding Plan ise aylık $18'dan başlıyor. Tam kullandıkça öde tarifelerinde bile ($1.40 / $4.40 per million), hafif kullanım birkaç sente mal olur.

GLM-5.2, Claude Code'da 1 milyon token bağlamı destekliyor mu?

Evet. ANTHROPIC_DEFAULT_* değişkenlerinizde model kimliği olarak glm-5.2 yerine glm-5.2[1m] kullanın; Claude Code milyon token penceresini kullanır.

Claude Code'da kod yazmak için GLM-5.2 mi, Claude mu daha iyi?

Rutin ve sıralı düzenlemelerde fiyat farkı, GLM-5.2'yi mantıklı varsayılan seçenek yapıyor. Çok adımlı mimari çalışmalarda, güvenlik açısından hassas işlerde ve yüksek eşzamanlılıklı alt ajan akışlarında Claude genellikle öne geçiyor. Bu geçiş düzeni, tek bir model seçmek yerine her ikisini de güçlü olduğu yerde kullanmanızı sağlıyor.

GLM-5.2'yi Claude Code dışında araçlarda da kullanabilir miyim?

Evet. Aynı z.ai uç noktası ve anahtarlar diğer ajan tabanlı CLI'larla da çalışır. OpenCode, Cline ve Kilo Code özel bir temel URL kabul eder; CC Switch de bunların birkaçı için hazır ayarları yönetir.

Claude Code'da GLM-5.2 kullanmak için ücretli Claude aboneliği gerekir mi?

Hayır. Claude Code yalnızca istemcidir; onu z.ai'a yönlendirdiğinizde ücretlendirme Anthropic tarafından değil z.ai tarafından yapılır. Claude'u geçiş yapılabilecek bir sağlayıcı olarak tutacaksanız yalnızca Claude hesabına ihtiyacınız olur.

CC Switch'te sağlayıcı değiştirdikten sonra Claude Code'u yeniden başlatmam gerekir mi?

CC Switch belgelerine göre Claude Code, sağlayıcı verilerinin yeniden başlatma olmadan değiştirilmesini destekliyor; diğer CLI araçlarının çoğunda ise terminali veya uygulamayı yeniden başlatmak gerekiyor. Pratikte, değişikliğin uygulandığından emin olmanın güvenilir yolu Claude Code'u yeniden başlatmak.

CC Switch'te Claude'a (resmî giriş) nasıl geri dönerim?

Hazır ayar listesinden bir Claude Official sağlayıcısı ekleyin, bunu etkinleştirin ve Claude Code'un normal çıkış / giriş (OAuth) akışını bir kez tamamlayın. Sonrasında resmî Claude girişiniz ile z.ai gibi üçüncü taraf sağlayıcılar arasında serbestçe geçiş yapabilirsiniz.

CC Switch ücretsiz ve güvenli mi?

Evet. MIT lisansıyla sunulan, ücretsiz ve açık kaynaklı bir uygulama. Yapılandırmalarınız atomik yazma kullanan yerel bir SQLite veritabanında tutulur. Tasarımı gereği her aracın kendi yapılandırmasında mümkün olan en az değişikliği yapar; dolayısıyla uygulamayı kaldırsanız bile CLI'larınız normal şekilde çalışmayı sürdürür.

İlgili içerikler

• GLM-5.2 API: erişim ve fiyatlandırma
• Kodlama için GLM-5.2 ve Opus 4.6 karşılaştırması
• Codex ve Claude Code karşılaştırması