Claude Code Ollama, Kimi ve GLM ile Nasıl Kullanılır?

Claude Code’u Claude dışı bir modelle çalıştırmak mümkün ve bunu bir hack olarak değil, sağlayıcıların kendi belgelediği bir yol olarak yapıyorsunuz. Ollama, Moonshot ve Z.ai üçü de Anthropic uyumlu uç nokta yayınlıyor.

Kurulum üç ortam değişkeninden ibaret. Bu yazı üç sağlayıcı için de adımları, kalıcı yapılandırmayı ve en sık çarpılan hataları veriyor 🔌

Kısa Cevap

Nasıl Çalışıyor?

Claude Code, isteklerini Anthropic Messages API biçiminde gönderiyor. İsteğin nereye gideceğini ANTHROPIC_BASE_URL belirliyor. Karşı taraf aynı biçimi konuşuyorsa Claude Code aradaki farkı görmüyor.

Üç değişken yeterli:

Ollama ile Yerel Model

Ollama v0.14.0 ve sonrası Anthropic Messages API ile uyumlu. Model kendi makinenizde çalışır, internet gerekmez, veri dışarı çıkmaz.

1. Ollama’yı kurun ve bir model çekin.

ollama pull gpt-oss:20b

2. Değişkenleri verip başlatın.

macOS, Linux ve WSL:

export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model gpt-oss:20b

Windows PowerShell:

$env:ANTHROPIC_AUTH_TOKEN = "ollama"
$env:ANTHROPIC_BASE_URL = "http://localhost:11434"
claude --model gpt-oss:20b

Anahtar yerine düz ollama yazmanız yeterli, Ollama kimlik doğrulaması istemiyor.

Ollama’nın önerdiği modeller:

Kimi K3 ile Kullanım

Moonshot, Kimi’yi Anthropic uyumlu uç noktadan sunuyor. Anahtarı platform.kimi.ai konsolundan alıyorsunuz.

export ANTHROPIC_BASE_URL=https://api.moonshot.ai/anthropic
export ANTHROPIC_AUTH_TOKEN=<kimi-api-anahtariniz>
export ANTHROPIC_MODEL="kimi-k3[1m]"
claude

Moonshot’ın dokümantasyonu yanına iki ayar daha öneriyor:

export CLAUDE_CODE_AUTO_COMPACT_WINDOW=1048576
export CLAUDE_CODE_EFFORT_LEVEL=max

Birincisi otomatik sıkıştırmanın 1 milyon tokenlık pencereye göre çalışmasını sağlıyor, ikincisi düşünme eforunu en üste alıyor.

Kimi K3’ün kendi performansını merak ediyorsanız Kimi K3 incelemesi ayrı yazıda.

GLM (Z.ai) ile Kullanım

Z.ai tarafında yapılandırma ortam değişkeni yerine doğrudan ayar dosyasına yazılıyor. ~/.claude/settings.json dosyasını açıp env bloğunu ekleyin:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "zai_api_anahtariniz",
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "API_TIMEOUT_MS": "3000000"
  }
}

Z.ai’nin varsayılan model eşlemesi üç takma adı da aynı modele bağlıyor:

"ANTHROPIC_DEFAULT_OPUS_MODEL": "GLM-4.7",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "GLM-4.7",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "GLM-4.7"

API_TIMEOUT_MS ayarı önemli: uzun düşünen modellerde varsayılan zaman aşımı yetmiyor.

Bütçesiz denemek isterseniz GLM-4.7-Flash, GLM-4.7’nin ücretsiz katmanı. Model adını GLM-4.7-Flash yapmanız yeterli, temel URL aynı kalıyor.

MiniMax ile Kullanım

MiniMax’in Claude Code sayfası yapılandırmayı doğrudan settings.json üzerinden veriyor:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimax.io/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<MINIMAX_API_ANAHTARINIZ>",
    "ANTHROPIC_MODEL": "MiniMax-M3[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M3[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M3[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M3[1m]",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000"
  }
}

Çin’den bağlanıyorsanız temel URL https://api.minimaxi.com/anthropic oluyor.

MiniMax’in ucuz seçeneğini Ollama bulut üzerinden de kullanabilirsiniz, model adı minimax-m2.1:cloud.

Qwen ile Kullanım (Alibaba Model Studio)

Alibaba tarafında temel URL ve model, seçtiğiniz plana göre değişiyor:

Dokümantasyonda geçen diğer model kimlikleri: qwen3.6-flash, qwen3.7-max.

Takma Adları Eşleyin, Seçim Ekranı Çalışsın

Buraya kadar modeli hep --model ile verdik. Sebebi şu: Claude Code bir gateway’den model listesi çekebiliyor, ama dönen listeden yalnızca kimliğinde claude veya anthropic geçen girdileri tutuyor. gpt-oss:20b bu filtreden geçmiyor, o yüzden /model ekranında çıkmıyor.

Çözüm takma adları yeniden eşlemek. Moonshot’ın dokümantasyonundaki kalıp:

export ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k3[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k3[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k3[1m]"
export ANTHROPIC_DEFAULT_FABLE_MODEL="kimi-k3[1m]"
export CLAUDE_CODE_SUBAGENT_MODEL="kimi-k3[1m]"

Bunları verdiğinizde /model opus yazsanız da Kimi çalışıyor, subagent’lar ve workflow ajanları da aynı modele geçiyor. Aynı kalıp Ollama ve Z.ai için de geçerli, sadece model adını değiştirin.

CLAUDE_CODE_SUBAGENT_MODEL özellikle önemli. Onu ayarlamazsanız subagent’lar hala Claude modeli çağırmaya çalışır ve hata alırsınız.

Kalıcı Hale Getirme: settings.json

export ile verilen değişkenler terminali kapatınca gidiyor. Kalıcı yapmanın iki yolu var:

Kabuk profiliniz: .bashrc veya .zshrc dosyasına export satırlarını ekleyin. Windows’ta setx kullanın ya da Ortam Değişkenleri panelinden tanımlayın.

Ayar dosyası: ~/.claude/settings.json içindeki env bloğu, Z.ai örneğindeki gibi. Bu yol daha temiz, çünkü yapılandırma tek yerde durur ve kabuğunuzu kirletmez.

Neyi Kaybedersiniz

Çalışıyor demek “her şey aynı çalışıyor” demek değil. Claude Code isteklerine Claude’a özgü alanlar ve beta başlıkları koyuyor:

Sık Karşılaşılan Hatalar

404 page not found Temel URL yanlış. Üç adresin de sonu birbirinden farklı: Ollama’da düz http://localhost:11434 (sonuna /v1 eklemeyin), Moonshot’ta /anthropic, Z.ai’de /api/anthropic ile bitmesi gerekiyor.

400 hataları Karşı taraf Claude’a özgü bir alanı tanımıyor. Çoğu tek değişkenle susuyor:

export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

Bu, ön sürüm yeteneklerini ve onlara ait gövde alanlarını göndermeyi durduruyor. Uyarlanabilir düşünmeyi etkilemiyor, çünkü o beta ile değil modele göre seçiliyor.

connection refused Ollama servisi çalışmıyor ya da farklı bir portta. ollama serve ile ayakta olduğunu doğrulayın, portu değiştirdiyseniz temel URL’yi de güncelleyin.

Cevap ortasında akış kesiliyor Claude Code, ANTHROPIC_BASE_URL bağlantılarında gelen her baytı sayıyor ve varsayılan olarak 300 saniye sessiz kalan akışı iptal ediyor. Yavaş bir yerel model uzun düşünme molalarında bu duvara çarpıyor. Z.ai’nin API_TIMEOUT_MS önerisi de aynı sorunu hedefliyor.

Subagent’lar hata veriyor CLAUDE_CODE_SUBAGENT_MODEL ayarlanmamış, ana model değişse de subagent’lar hala Claude çağırıyor.

Anthropic Ne Diyor?

Anthropic’in dokümantasyonundaki cümle şu: üçüncü parti gateway ürünlerini onaylamıyor, bakımını yapmıyor, denetlemiyor ve Claude Code’u Claude dışı modellere yönlendirmeyi desteklemiyor.

Buradaki “desteklemiyor” ifadesi “yasak” demek değil, “bozulursa arkasında durmayız” demek. Nitekim ANTHROPIC_BASE_URL ve ANTHROPIC_AUTH_TOKEN Anthropic’in kendi gateway protokolünde belgelenmiş değişkenler. Pratik sonuç: bir şey çalışmadığında destek sağlayıcıdan gelir, Anthropic’ten değil.

Claude’a Geri Dönme

Değişkenleri kaldırın, Claude Code aboneliğinize döner:

unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL
unset ANTHROPIC_DEFAULT_OPUS_MODEL ANTHROPIC_DEFAULT_SONNET_MODEL
unset ANTHROPIC_DEFAULT_HAIKU_MODEL CLAUDE_CODE_SUBAGENT_MODEL

Ayar dosyasına yazdıysanız ~/.claude/settings.json içindeki env bloğunu silin. Sonra /status ile hangi sağlayıcıya bağlı olduğunuzu doğrulayın.

Claude modelleri arasında geçiş yapmak istiyorsanız (opus, sonnet, opusplan) o iş /model komutuyla oluyor, slash komutları rehberinde hepsi var.

Sıkça Sorulan Sorular (SSS)

Claude Code’u Ollama ile yerel modele bağlayabilir miyim? Evet. Ollama v0.14.0 ve sonrası Anthropic Messages API ile uyumlu. ANTHROPIC_AUTH_TOKEN=ollama ve ANTHROPIC_BASE_URL=http://localhost:11434 ayarlayıp claude --model gpt-oss:20b çalıştırmanız yeterli. Ollama en az 32K bağlam uzunluğuna sahip bir model öneriyor.

Claude Code’da Kimi K3 nasıl kullanılır? Temel URL olarak https://api.moonshot.ai/anthropic, anahtar olarak Kimi API anahtarınızı, model olarak kimi-k3[1m] verin. Moonshot ayrıca CLAUDE_CODE_AUTO_COMPACT_WINDOW=1048576 ve CLAUDE_CODE_EFFORT_LEVEL=max öneriyor.

Claude Code’u GLM ile nasıl kullanırım? ~/.claude/settings.json içindeki env bloğuna ANTHROPIC_BASE_URL olarak https://api.z.ai/api/anthropic, ANTHROPIC_AUTH_TOKEN olarak Z.ai anahtarınızı ve API_TIMEOUT_MS olarak 3000000 yazın. Z.ai üç model takma adını da varsayılan olarak GLM-4.7’ye eşliyor.

Yerel model /model seçim ekranında neden görünmüyor? Claude Code gateway’den gelen model listesinden yalnızca kimliğinde claude veya anthropic geçenleri tutuyor. gpt-oss:20b bu filtreden geçmiyor. Ya --model ile açıkça verin ya da ANTHROPIC_DEFAULT_OPUS_MODEL gibi takma ad değişkenlerini o modele eşleyin.

Claude Code’da 404 page not found hatası neden alıyorum? Temel URL yanlış. Ollama’da adres düz http://localhost:11434 olmalı, sonuna /v1 eklenmemeli. Moonshot’ta /anthropic, Z.ai’de /api/anthropic ile bitmesi gerekiyor.

Yerel modelde 400 hatası nasıl çözülür? Karşı taraf Claude’a özgü bir alanı tanımıyor. CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 ayarlayın, bu ön sürüm yeteneklerini ve gövde alanlarını göndermeyi durdurur ve hataların çoğunu keser.

Bu kurulum Claude aboneliğimi etkiler mi? Evet. ANTHROPIC_AUTH_TOKEN ayarlıyken claude.ai aboneliğiniz kullanılmaz, kimlik bilgisi abonelik girişinin yerine geçer ve trafik o anahtarın sahibine faturalanır. Geri dönmek için değişkenleri kaldırın.

Anthropic yerel model kullanımını yasaklıyor mu? Hayır. Dokümantasyonda üçüncü parti gateway’leri onaylamadığı ve Claude dışı modellere yönlendirmeyi desteklemediği yazıyor. Bu “yasak” değil, “bozulursa arkasında durmayız” demek. ANTHROPIC_BASE_URL ve ANTHROPIC_AUTH_TOKEN zaten Anthropic’in kendi gateway protokolünde belgelenmiş değişkenler.

Özet

Üç sağlayıcı, tek kalıp: temel URL, anahtar, model adı. Ollama yerelde ve ücretsiz, Kimi ile GLM bulutta ve abonelikli.

İki ayarı atlamayın: takma adları eşlemezseniz /model ekranı boş kalır, CLAUDE_CODE_SUBAGENT_MODEL vermezseniz subagent’lar hata verir.

Bir de beklentiyi doğru kurun. Token sayımı, genişletilmiş bağlam ve bazı beta özellikleri gidiyor, 400 hatalarının çoğu CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 ile susuyor. Gizlilik ya da çevrimdışı çalışma sizin için belirleyiciyse bu takas mantıklı 👀