
Claude Code Anthropic modelleriyle birlikte gelir, ancak tek bir ortam değişkeni -- ANTHROPIC_BASE_URL -- ile istekleri neredeyse her LLM sağlayıcısına yönlendirebilirsiniz. Bu, Claude Opus'un 25 $ yerine yaklaşık 1 milyon çıktı token başına 0,27 $'a DeepSeek'e geçebileceğiniz ya da Ollama üzerinden modelleri ücretsiz çalıştırabileceğiniz anlamına gelir. Bu rehber, Claude Code'da farklı modeller kullanmak için her yöntemi kapsıyor ve her yaklaşım için uygulamalı kurulum içeren ayrıntılı Claude Code karşılaştırmamız üzerine inşa edilmiştir.
Her Yönteme Tek Bakış
Durumunuza uyan yöntemi seçin, ardından kurulum kodu için ilgili bölüme atlayın.
| Yöntem | En İyi Kullanım | Maliyet | Kurulum | Modeller |
|---|---|---|---|---|
| OpenRouter | Model çeşitliliği, tek API anahtarı | Token başına ödeme (geçiş) | Kolay | 300+ |
| Ollama | Gizlilik, ücretsiz, çevrimdışı | Ücretsiz (kendi donanımınız) | Kolay | 50+ açık kaynak |
| LM Studio | GUI ile yerel modeller | Ücretsiz (kendi donanımınız) | Kolay | 50+ açık kaynak |
| claude-code-router | Görev bazlı akıllı yönlendirme | Sağlayıcıya göre değişir | Orta | Yapılandırmaya bağlı |
| claude-code-proxy | Gemini/OpenAI arka ucu | Sağlayıcı fiyatlandırması | Orta | OpenAI + Gemini |
| LiteLLM | Kurumsal, yük dengeleme | Sağlayıcı fiyatlandırması | Gelişmiş | 100+ farklı sağlayıcıda |
Her yöntemin adım adım kurulumu için okumaya devam edin ya da ne ihtiyacınız olduğunu zaten biliyorsanız doğrudan karar çerçevesine atlayın.
Claude Code Model Değiştirme Gerçekte Nasıl Çalışır?
Herhangi bir proxy yapılandırmadan önce, çoğu öğreticinin sizi bozuk bir kurulumla neden bıraktığını anlamanız gerekir. Claude Code dahili olarak üç model yuvası kullanır -- tek değil:
- Haiku yuvası -- dosya özeti ve sekme tamamlama gibi arka plan görevleri
- Sonnet yuvası -- varsayılan kodlama, en çok etkileşime girdiğiniz model
- Opus yuvası -- karmaşık muhakeme, planlama ve çok adımlı ajansal görevler
/model veya --model ile modeli değiştirdiğinizde, yalnızca birincil yuvayı değiştiriyorsunuz. Claude Code, diğer iki yuvayı Anthropic'in API'si üzerinden çağırmaya devam eder. ANTHROPIC_BASE_URL'i bir proxy'ye yönelttiyseniz ancak yalnızca bir model ayarladıysanız, bu diğer yuvalar "model not found" hatasıyla başarısız olur.
Çözüm: Her yuvanın proxy'nizden geçmesi için üç ortam değişkenini de ayarlayın.
# Tüm üç yuvayı proxy'nizden geçecek şekilde ayarlayın
export ANTHROPIC_DEFAULT_HAIKU_MODEL="haiku-eşdeğeriniz"
export ANTHROPIC_DEFAULT_SONNET_MODEL="sonnet-eşdeğeriniz"
export ANTHROPIC_DEFAULT_OPUS_MODEL="opus-eşdeğeriniz"Yerel Model Değiştirme (Anthropic Modelleri)
Anthropic'in model ailesi içinde kalıyorsanız değiştirme basittir. Claude Code içinde /model komutunu kullanın, terminalden başlatırken --model geçirin ya da ayarlar dosyanızdaki availableModels dizisine modeller ekleyin. Anthropic buraya sürekli yeni seçenekler ekliyor ve 2026 için Claude Code'un en yeni özellikleri derlememiz son çıkanları takip ediyor.
opusplan Stratejisi
opusplan Claude Code'un yerleşik çok model yönlendirmesidir. Arka plan görevlerini Haiku'ya gönderir ve karmaşık muhakemeyi otomatik olarak Opus'a yönlendirir. Manuel olarak yapılandırmanıza gerek yok; sadece modeliniz olarak seçin. Anthropic'in "Neden dosya listeleme için Opus fiyatları ödüyorum?" sorusuna kendi cevabıdır. Üçüncü taraf bir yönlendirici kullanmadan önce, önceliğiniz ham hızsa Anthropic'in fast mode özelliğiyle birlikte denemeye değer.
OpenRouter -- Tek API Anahtarı, 300+ Model
OpenRouter bir API toplayıcısı olarak işlev görür. Anthropic, Google, Meta, Mistral, DeepSeek ve daha fazlasından 300+ modele erişim için tek bir API anahtarı alırsınız. Fiyatlandırma çoğu model için geçiş biçimindedir -- ek ücret yok.
Kurulum Adımları
- openrouter.ai adresinde bir hesap oluşturun ve bir API anahtarı oluşturun
- Mevcut Anthropic oturumunu temizlemek için
claude /logoutçalıştırın - Ortam değişkenlerinizi ayarlayın:
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_API_KEY="sk-or-v1-anahtariniz-buraya"
# Üç model yuvasının tamamını eşleştirin
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek/deepseek-chat-v3"
export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4"
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4"claudebaşlatın ve bağlantıyı doğrulayın
Üç yuva değişkenine dikkat edin -- bunları atlarsanız yukarıda ele aldığımız "model not found" hatasıyla karşılaşırsınız. Resmi OpenRouter entegrasyon kılavuzu bu kurulumu onaylamaktadır.
OpenRouter Üzerinden Önerilen Modeller
OpenRouter'daki her model Claude Code'un araç çağrısını güvenilir biçimde ele almaz. İşte gerçekten iyi çalışan şeyler:
| Görev | Model | Neden |
|---|---|---|
| Ucuz arka plan görevleri | DeepSeek V3.2 | MTok başına 0,27 $/1,10 $, makul araç çağrısı |
| Varsayılan kodlama | Claude Sonnet 4 | Doğrudan bağlantıyla aynı kalite, birleşik faturalandırma |
| Büyük kod tabanları (1M bağlam) | Gemini 2.5 Flash | MTok başına 0,15 $/0,60 $, devasa bağlam penceresi |
| Karmaşık muhakeme | Claude Opus 4 | En iyi ajansal kodlama kalitesi |
Maliyet ve Faturalandırma
OpenRouter çoğu modelde geçiş fiyatlandırması uygular. Temel sağlayıcının tam olarak ücretlendirdiği kadar artı bazı üçüncü taraf modellerde küçük bir marj ödersiniz. Sürprizlerden kaçınmak için OpenRouter panonuzda harcama sınırları belirleyin.
Sonuç: OpenRouter, minimum kurulumla maksimum model çeşitliliği isteyen geliştiriciler için en iyi seçenektir. Tek API anahtarı, tek faturalandırma panosu, 300+ model. Esneklik açısından geçmesi zor.
Ollama -- Ücretsiz, Yerel ve Özel
Ollama modelleri tamamen makinenizde çalıştırır. v0.14.0'dan (Ocak 2026) itibaren Anthropic Messages API'yi yerel olarak destekler; bu da Claude Code'un herhangi bir çeviri katmanı olmadan onunla konuşabileceği anlamına gelir. Kodunuz hiçbir zaman makinenizi terk etmez.
Ön Gereksinimler ve Donanım
Kullanılabilir bir deneyim için iyi donanım gereklidir:
- 7B modeller (hızlı düzenlemeler, basit görevler): minimum 16 GB RAM
- 14B modeller (sağlam kodlama kalitesi): 32 GB RAM, GPU önerilir
- 32B+ modeller (bulut benzeri kalite): 64 GB RAM veya 24 GB+ VRAM'lı özel GPU
Donanım gereksinimleri ve model seçimi hakkında daha derin bir inceleme için LLM'leri yerel olarak çalıştırma rehberimize bakın.
Kurulum Adımları
- ollama.com adresinden Ollama'yı yükleyin
- Kodlamaya odaklı bir model indirin
- Claude Code uyumluluğuyla başlatın
- Ortam değişkenlerinizi ayarlayın
# Bir kodlama modeli yükleyin ve indirin
ollama pull qwen2.5-coder:14b
# Claude Code uyumluluğuyla başlatın
ollama launch claude
# Ortam değişkenlerini ayarlayın
export ANTHROPIC_BASE_URL="http://localhost:11434"
export ANTHROPIC_API_KEY="ollama"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen2.5-coder:14b"
export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen2.5-coder:14b"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen2.5-coder:14b"Ollama entegrasyon belgeleri en iyi Claude Code deneyimi için 64k+ token bağlam pencereli modeller önermektedir.
Kodlama için En İyi Yerel Modeller
| Model | Boyut | Güçlü Yön | Notlar |
|---|---|---|---|
| Qwen 2.5 Coder 14B | 14B | Genel olarak en iyi yerel kodlama | Güçlü araç çağrısı, iyi bağlam işleme |
| devstral | 24B | Mistral'ın kodlama uzmanı | Yeniden düzenleme ve kod incelemesi için harika |
| GLM 4.7 | 9B | Genel muhakeme | İyi hız-kalite dengesi |
Kendinize bir konuda dürüst olun: Yerel modeller, karmaşık, çok adımlı ajansal görevler için Claude Sonnet'e kıyasla belirgin biçimde daha düşük kod kalitesi üretir. Araç çağrısı daha az güvenilirdir ve daha fazla hayali dosya yolu görürsünüz. Hızlı düzenlemeler, basit üretim ve gizliliğe duyarlı çalışmalar için mükemmeldirler -- ancak 50 dosyalı bir yeniden düzenlemede yerel Claude kalitesi beklemeyin.
Sonuç: Ollama, gizliliğe duyarlı çalışmalar ve ücretsiz, sınırsız kullanım isteyen geliştiriciler için en iyi seçenektir. Donanıma sahipseniz, "sonsuza kadar sıfır lira" argümanına karşı çıkmak zordur.
Ollama Cloud vs OpenRouter: Fiyatlandırma ve Hangisi Ne Zaman Kazanır
Ollama ve OpenRouter, maliyet sorununu ters uçlardan çözüyor. Ollama, kontrolünüzdeki donanımda token başına sıfır maliyetle modelleri çalıştırırken, OpenRouter yönetilecek donanım olmadan 300'den fazla barındırılan model için geçiş fiyatlandırması uyguluyor. Bu rehber Ollama'yı yerelde kuruyor, ancak barındırılan katmanını çalıştırırsanız da aynı sabit maliyete karşı token başına maliyet matematiği geçerli.
| Faktör | Ollama | OpenRouter |
|---|---|---|
| Maliyet modeli | Yerelde ücretsiz, donanım için ödersiniz | Çoğu modelde ek ücretsiz, token başına geçiş |
| Örnek fiyat | Token başına 0 $ | DeepSeek V3.2: 0,27 $/1,10 $, Gemini 2.5 Flash: MTok başına 0,15 $/0,60 $ |
| Donanım | 16GB RAM (7B) ila 24GB+ VRAM (32B+) | Yok, tamamen barındırılan |
| Model erişimi | 50+ açık kaynak model | Sağlayıcılar genelinde 300+ |
| Gizlilik | Kod hiçbir zaman makinenizi terk etmez | İstekler OpenRouter üzerinden geçer |
Donanımınız zaten varsa ve gizlilik, çevrimdışı kullanım veya yüksek hacimli rutin düzenlemeler önemliyse Ollama'yı seçin. Model çeşitliliği, önceden donanım gerektirmeyen bir kurulum ve yalnızca kullandığınız kadar ödeme istiyorsanız OpenRouter'ı seçin.
LM Studio -- GUI ile Yerel Modeller
LM Studio Ollama ile aynı yerel model yürütmesini sunar ancak görsel bir arayüzle. Modellere GUI'de göz atarsınız, tek tıklamayla niceleme seviyelerini seçersiniz ve Claude Code'u ona yönlendirmeden önce sohbeti test edersiniz. Ollama ile aynı donanım gereksinimleri. Çalıştırıcıları karşılaştırıyorsanız, LLM'leri yerel olarak çalıştırmak için en iyi araçlar rehberimiz artıları ve eksileri kapsıyor.
Kurulum
- LM Studio'yu indirin ve yükleyin
- Bir kodlama modeli arayın ve indirin (Qwen 2.5 Coder, devstral vb.)
- LM Studio arayüzünden yerel sunucuyu başlatın
- Claude Code'u ona yönlendirin:
# Claude Code'u LM Studio'nun yerel sunucusuna yönlendirin
export ANTHROPIC_BASE_URL="http://localhost:1234/v1"
export ANTHROPIC_API_KEY="lm-studio"
export ANTHROPIC_DEFAULT_SONNET_MODEL="yuklenen-model-adiniz"LM Studio blogu, görsel kurulum kılavuzlarını tercih ediyorsanız ekran görüntüleriyle bir açıklama sunmaktadır.
Sonuç: LM Studio, yerel modelleri yönetmek için CLI yerine GUI tercih eden geliştiriciler için en iyisidir. ollama pull ve yapılandırma dosyalarıyla zaten rahatsanız Ollama'da kalın. Modellere görsel olarak göz atmak ve kaydırıcılarla ayarları değiştirmek istiyorsanız LM Studio sizin tercihiniz.
claude-code-router -- Akıllı Model Yönlendirme
claude-code-router, Claude Code ile yapılandırılmış sağlayıcılarınız arasında yerel bir proxy çalıştıran bir npm paketidir. İlginç yapan şey bağlama duyarlı yönlendirme -- ucuz arka plan görevlerini DeepSeek'e, varsayılan kodlamayı Sonnet'e ve karmaşık muhakemeyi Opus'a hepsi otomatik olarak gönderebilirsiniz.
Projenin 30k+ GitHub yıldızı var ve sağlayıcı olarak OpenRouter, DeepSeek, Gemini, Ollama, Groq, Volcengine ve SiliconFlow'u destekliyor.
Yükleme ve Kurulum
npm install -g claude-code-router
claude-code-router init
claude-code-router startinit komutu, sağlayıcılarınızı ve model eşlemelerinizi tanımladığınız bir config.json oluşturur:
{
"providers": {
"openrouter": {
"apiKey": "sk-or-v1-...",
"models": {
"haiku": "deepseek/deepseek-chat-v3",
"sonnet": "anthropic/claude-sonnet-4",
"opus": "anthropic/claude-opus-4"
}
}
}
}Bağlama Duyarlı Yönlendirme Yapılandırması
claude-code-router burada parlar. Karmaşıklığa göre farklı görev türlerini farklı modellere yönlendirebilirsiniz. Arka plan özetlemesi ucuz bir modele, planlama ve mimari çalışma ise en iyi modelinize gider. Yönlendirici tüm yuva eşlemelerini şeffaf biçimde halleder.
Ayrıca sağlayıcıları karıştırabilirsiniz -- gizliliğe duyarlı repolar için Ollama, diğer her şey için OpenRouter kullanın ve Claude Code içindeki /model komutuyla geçiş yapın.
Sonuç: claude-code-router, her görev türünü hangi modelin ele alacağı üzerinde ayrıntılı kontrol isteyen güç kullanıcıları için en iyisidir. En yapılandırılabilir seçenektir, ancak bu esneklik basit bir ANTHROPIC_BASE_URL değişiminden daha fazla kurulum gerektirir.
claude-code-proxy ve LiteLLM -- Gelişmiş Kurulumlar
Bu iki yöntem farklı ihtiyaçlara hizmet eder ancak bir özelliği paylaşırlar: İkisi de API formatları arasında çeviri yapan proxy sunucularıdır.
claude-code-proxy (Gemini ve OpenAI Arka Ucu)
claude-code-proxy, Claude Code'dan gelen Anthropic formatlı istekleri kabul eden ve bunları LiteLLM üzerinden OpenAI veya Gemini formatına çeviren bir Python aracıdır (3,3k GitHub yıldızı). Claude Code ile özellikle Gemini veya GPT modellerini kullanmanın en basit yoludur.
pip install claude-code-proxy
claude-code-proxy --port 8080
# Ardından Claude Code'u ona yönlendirin
export ANTHROPIC_BASE_URL="http://localhost:8080"
export ANTHROPIC_API_KEY="gemini-veya-openai-anahtariniz"Büyük monorepo'lar için özellikle Gemini'nin 1M token bağlamını istiyorsanız, bu en doğrudan yoldur.
LiteLLM (Kurumsal Evrensel Proxy)
LiteLLM, yük dengeleme, yedek zincirleri, hız sınırlama ve denetim günlüğüyle 100+ sağlayıcıyı destekleyen kurumsal düzeyde bir proxy'dir. Solo geliştirici için gereğinden fazladır ancak yapay zeka modeli kullanımı etrafında yönetim gerektiren ekipler için zorunludur.
Kurulum bir YAML yapılandırması kullanır:
model_list:
- model_name: claude-sonnet-4-20250514
litellm_params:
model: gemini/gemini-2.5-flash
api_key: os.environ/GEMINI_API_KEY
- model_name: claude-haiku-3-5-20241022
litellm_params:
model: deepseek/deepseek-chat
api_key: os.environ/DEEPSEEK_API_KEY# LiteLLM proxy başlatın
litellm --config config.yaml --port 4000
# Claude Code'u LiteLLM'e yönlendirin
export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_API_KEY="sk-litellm"Resmi Claude Code belgelerinden önemli bir not: "Anthropic, LiteLLM'i onaylamaz, sürdürmez veya denetlemez." Kullanın, ancak bir topluluk aracı olduğunu, Anthropic ürünü olmadığını bilin. LiteLLM öğreticisi daha fazla gelişmiş yapılandırma örneğine sahiptir.
Sonuç: Özellikle Gemini veya OpenAI modellerini istiyorsanız claude-code-proxy kullanın. Ekibinizin sağlayıcılar arasında yük dengeleme, yedekleme ve denetim günlüğüne ihtiyacı varsa LiteLLM kullanın.
Claude Code Router vs LiteLLM: Hangisini Kullanmalısınız?
Görev bazlı model yönlendirmesi isteyen solo geliştiriciler için Claude Code Router daha basit bir seçimken, LiteLLM yük dengeleme, yedek zincirleri ve denetim günlüğüne ihtiyaç duyan ekipler için tasarlanmıştır. Router npm üzerinden yüklenir ve bir config.json okur; LiteLLM ise 100'den fazla sağlayıcıda YAML yapılandırmalı kurumsal bir proxy çalıştırır.
| Faktör | Claude Code Router | LiteLLM |
|---|---|---|
| Kurulum zorluğu | Orta: npm install, config.json düzenle | İleri düzey: YAML yapılandırma dosyası |
| En iyi kullanım | Görev bazlı yönlendirme isteyen solo geliştiriciler | Yönetişime ihtiyaç duyan ekipler |
| Yapılandırma biçimi | config.json | YAML model_list |
| Öne çıkan özellik | Bağlama duyarlı görev bazlı yönlendirme | Yük dengeleme, yedekleme, denetim günlüğü |
| Sağlayıcılar | OpenRouter, DeepSeek, Gemini, Ollama, Groq ve daha fazlası | Sağlayıcılar genelinde 100+ |
| Olgunluk | 30k+ GitHub yıldızı, Claude Code için inşa edildi | Kurumsal proxy, topluluk aracı (Anthropic onaylı değil) |
Ucuz arka plan görevlerini DeepSeek'e, karmaşık muhakemeyi Opus'a fazla kurulum yapmadan göndermek isteyen solo bir geliştiriciyseniz claude-code-router'ı seçin. Ekibinizin sağlayıcılar arasında yük dengeleme, hız sınırlama ve denetim günlüğüne ihtiyacı varsa LiteLLM'i seçin.
Başka proxy'leri de mi değerlendiriyorsunuz? En iyi LLM gateway araçları derlememiz onları yan yana karşılaştırıyor.
Her Yöntem Gerçekte Ne Kadara Mal Olur?
Buna gerçek rakamlar koyalım. En yaygın model/yöntem kombinasyonlarında 1 milyon token başına ne ödeyeceğiniz:
| Model / Yöntem | Giriş (1M token başına) | Çıkış (1M token başına) | Aylık Tahmin (ılımlı kullanım) |
|---|---|---|---|
| Claude Opus 4.6 (doğrudan) | ₺160 | ₺800 | ~₺1.600-4.800 |
| Claude Sonnet 4.6 (doğrudan) | ₺96 | ₺480 | ~₺960-1.920 |
| Claude Sonnet OpenRouter üzerinden | ₺96 | ₺480 | Aynı (geçiş) |
| DeepSeek V3.2 (OpenRouter) | ₺8,64 | ₺35,20 | ~₺96-256 |
| Gemini 2.5 Flash (OpenRouter) | ₺4,80 | ₺19,20 | ~₺64-160 |
| Ollama (yerel) | Ücretsiz | Ücretsiz | ₺0 (donanım maliyetleri) |
Fiyat verileri Anthropic'in resmi fiyatlandırma sayfasından ve OpenRouter'dan. Tahmini USD/TRY kuru: 32 ₺. Ilımlı kullanım, günlük kodlama oturumları için aylık ~5-10M token varsayar.
"Model Başına 1M Çıkış Token Maliyeti"
Veri tablosu
| "Model" | "Çıkış Maliyeti" |
|---|---|
| "Opus 4.6" | 800 |
| "Sonnet 4.6" | 480 |
| "DeepSeek V3.2" | 35.2 |
| "Gemini 2.5 Flash" | 19.2 |
| "Ollama (yerel)" | 0 |
Maliyet farkı önemlidir, ancak daha ucuz modeller daha düşük kod kalitesi üretir -- özellikle araç çağrısı güvenilirliğinin önemli olduğu karmaşık ajansal görevlerde. Çıkış MTok başına ₺35'lik DeepSeek rutin düzenlemeler için harikadır. Claude Code'un 20 dosya üzerinde okuma, planlama, düzenleme ve doğrulama gerektirdiği çok dosyalı bir yeniden düzenleme için? Yine de Sonnet veya Opus isteyeceksiniz.
Sonuç: Kabul edilebilir kalitede maliyet tasarrufu için OpenRouter + DeepSeek en iyi oranı sunar. Sıfır maliyet için donanımınız varsa Ollama yenilmezdir. Maksimum kalite için Anthropic doğrudan hâlâ kral.
Hangi Yöntemi Kullanmalısınız? -- Karar Çerçevesi
İşte her diğer öğreticinin atladığı bölüm. "Sadece OpenRouter kullanın" demek yerine, yöntemleri gerçek ihtiyaçlarla eşleştirelim:
| Şuna İhtiyacınız Varsa... | Bu Yöntemi Kullanın | Neden |
|---|---|---|
| Maksimum model çeşitliliği, tek API anahtarı | OpenRouter | 300+ model, kolay kurulum, kullandıkça öde |
| Ücretsiz, sınırsız, kod yerelde kalır | Ollama | Sıfır maliyet, tam gizlilik, çevrimdışı çalışabilir |
| Görsel arayüzle yerel modeller | LM Studio | GUI model tarayıcı, kolay niceleme seçimi |
| Akıllı görev bazlı yönlendirme | claude-code-router | Muhakeme Opus'a, hızlı düzenlemeler DeepSeek'e |
| Özellikle Gemini veya OpenAI modelleri | claude-code-proxy | Anthropic formatını OpenAI/Gemini'ye çevirir |
| Kurumsal: yük dengeleme, denetim | LiteLLM | Hız sınırlama, yedek zincirleri, ekip kontrolleri |
Gerçekten Değiştirmeli misiniz?
Dürüst değerlendirme: Karmaşık ajansal kodlama yapan çoğu geliştirici için -- çok dosyalı yeniden düzenlemeler, mimari planlama, karmaşık eşzamanlılık sorunlarını hata ayıklama -- Claude Sonnet doğrudan Anthropic üzerinden hâlâ en iyi seçenektir. Yerel Claude en güvenilir araç çağrısına, kendi ajansal iş akışının en iyi anlayışına ve sıfır proxy gecikmesine sahiptir.
Model değiştirme, belirli senaryolar için bir optimizasyondur:
- Sonnet kalitesine ihtiyaç duymayan arka plan görevlerinde token yakıyorsunuz ya da sürekli Claude'un 2x kullanım limitlerine takılıyorsunuz
- Büyük bir monorepo için Gemini'nin 1M bağlam penceresine ihtiyacınız var
- Kodunuz makinenizden çıkamaz (hükümet, sağlık hizmetleri, finans)
- Sıkı bir bütçeniz var ve kabul edilebilir kalite mükemmel kaliteyi yeniyor
Bunların hiçbiri geçerli değilse, opusplan (Anthropic'in yerleşik yönlendirmesi) ihtiyacınız olan tek şey olabilir.
Araç çağrısı güvenilirliği burada en çok önem taşıyan kalite metriğidir. Hiyerarşi şu şekildedir: yerel Claude >> OpenRouter Claude >> DeepSeek/Gemini >> yerel modeller. Ne kadar aşağıya giderseniz, o kadar fazla başarısız araç çağrısı, hayali dosya yolu ve eksik düzenleme görürsünüz.
Yaygın Sorunları Giderme
"model not found" Hatası
Bu en yaygın sorundur. ANTHROPIC_BASE_URL'i ayarladığınızda ancak üç model yuvasını eşlemeyi unuttuğunuzda ortaya çıkar. Claude Code Haiku veya Opus'u proxy'niz üzerinden çağırmaya çalışır, proxy varsayılan Anthropic model adını tanımaz ve hatayı alırsınız.
# Düzeltme: Üç model yuva değişkenini de ayarlayın
export ANTHROPIC_DEFAULT_HAIKU_MODEL="modeliniz"
export ANTHROPIC_DEFAULT_SONNET_MODEL="modeliniz"
export ANTHROPIC_DEFAULT_OPUS_MODEL="modeliniz"Bağlantı Reddedildi / Zaman Aşımı
Proxy'niz çalışmıyor ya da Claude Code yanlış porta ulaşıyor. Proxy sürecinin etkin olduğunu doğrulayın ve ANTHROPIC_BASE_URL'deki portu iki kez kontrol edin. Güvenlik duvarları ve VPN'ler de localhost bağlantılarını engelleyebilir.
Araç Çağrısı Hataları
Model, Anthropic'in araç kullanım formatını doğru biçimde desteklemiyor. Belirtiler: Claude Code askıda kalır, boş araç çağrıları üretir veya yanlış dosyaları düzenler. Doğrulanmış araç çağrısı desteğine sahip bir modele geçin -- Qwen 2.5 Coder ve devstral yerel modeller arasında bunu en iyi biçimde halleder.
Akış Sorunları
Bazı proxy'ler sunucu tarafından gönderilen olayları doğru şekilde halletmez. Yanıtlar akış yerine hepsi bir anda görünür ya da yanıt ortasında kesilirler. Proxy sürümünüzün güncel olduğundan emin olun ve bilinen akış hataları için GitHub sorunlarına bakın.
Bağlam Penceresi Aşıldı
Yerel modeller genellikle varsayılan olarak 4K-8K bağlam pencerelerine sahiptir. Claude Code gerçek kodlama oturumları için bundan çok daha fazlasına ihtiyaç duyar. 32K+ bağlama sahip modeller kullanın ya da uzun bağlamlı görevleri OpenRouter üzerinden Gemini'ye (1M pencere) yönlendirin.
OpenRouter için Önce Çıkış Yapmalısınız
Doğrudan Anthropic'ten OpenRouter'a geçiyorsanız önce claude /logout çalıştırın. Claude Code kimlik doğrulamayı önbelleğe alır ve temel URL'yi değiştirseniz bile Anthropic anahtarınızı kullanmaya devam etmeye çalışır.
# Sağlayıcı değiştirmeden önce önbelleğe alınmış kimlik doğrulamayı temizleyin
claude /logoutSSS
Claude Code'u GPT-4 veya Gemini ile kullanabilir misiniz?
Evet. claude-code-proxy, Anthropic formatlı istekleri OpenAI veya Gemini formatına çevirir. Ayrıca tek bir API anahtarıyla OpenRouter üzerinden her ikisine de erişebilirsiniz. Araç çağrısı, özellikle karmaşık çok adımlı görevlerde yerel Claude'dan daha az güvenilir olabilir.
Anthropic API anahtarı olmadan Claude Code'u nasıl kullanırım?
Tamamen ücretsiz yerel kullanım için Ollama kullanın -- herhangi bir sağlayıcıdan API anahtarı gerekmez. Alternatif olarak, kendi API anahtarı formatlarıyla OpenRouter kullanın. ANTHROPIC_API_KEY ortam değişkenini yine de ayarlarsınız, ancak proxy'nizin anahtarına işaret eder (örneğin OpenRouter için sk-or-v1-..., Ollama için "ollama").
Claude Code'u Ollama ile nasıl kurarım?
Ollama'yı yükleyin, qwen2.5-coder:14b gibi bir model indirin, ollama launch claude çalıştırın ve üç ortam değişkeni ayarlayın: ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY ve üç model yuva değişkeni. Tam kod için yukarıdaki Ollama bölümüne bakın.
Claude Code ile hangi modeller en iyi çalışır?
Bulut için: Claude Sonnet 4 en iyi kodlama kalitesini sunarken, DeepSeek V3.2 en iyi değeri sunar. Yerel için: Qwen 2.5 Coder 14B mevcut altın standarttır. Belirleyici faktör araç çağrısı güvenilirliğidir -- Claude Code dosya işlemleri için buna büyük ölçüde bağımlıdır ve yerel Claude modelleri bunu en iyi şekilde halleder.
Claude Code'daki "model not found" hatasını nasıl düzeltirim?
Üç model yuva ortam değişkeninin tamamını ayarlayın: ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL ve ANTHROPIC_DEFAULT_OPUS_MODEL. Bu hata, Claude Code üç dahili model yuvası kullandığı için ortaya çıkar ve eşlenmemiş bir yuva proxy'nizin tanımadığı bir model adını çağırmaya çalışır.
Claude Code yerel modellerle çevrimdışı çalışabilir mi?
Evet. Hem Ollama hem de LM Studio modelleri tamamen makinenizde internet bağlantısı gerektirmeden çalıştırır. Kodunuz hiçbir zaman donanımınızı terk etmez. Yeterli özellikler gereklidir -- 7B modeller için minimum 16 GB RAM, daha büyükler için 32 GB+.
LM Studio'yu Claude Code ile kullanabilir miyim?
Evet. LM Studio, ANTHROPIC_BASE_URL'i http://localhost:1234/v1 ve ANTHROPIC_API_KEY'i lm-studio olarak ayarlayarak Claude Code'un bağlandığı yerel bir sunucu çalıştırır. Qwen 2.5 Coder gibi bir kodlama modeli indirin, sunucuyu LM Studio'nun GUI'sinden başlatın, ardından model yuvanızı eşleyin. Ollama'nın CLI'sine görsel bir alternatiftir.
ANTHROPIC_BASE_URL nedir ve nasıl kullanırım?
Claude Code'a API isteklerini nereye göndereceğini söyleyen ortam değişkenidir. Varsayılan olarak https://api.anthropic.com'a işaret eder. Herhangi bir Anthropic uyumlu uç noktaya değiştirin -- OpenRouter (https://openrouter.ai/api), Ollama (http://localhost:11434), LiteLLM (http://localhost:4000) vb.
claude-code-router LiteLLM'den daha mı iyi?
Farklı sorunlar için farklı araçlar. claude-code-router daha basittir (npm install, config.json düzenle, bitti) ve özellikle Claude Code için tasarlanmıştır. LiteLLM yük dengeleme, hız sınırlama, yedek zincirleri ve denetim günlüğüyle kurumsal düzeydedir. Solo geliştirici misiniz? claude-code-router kullanın. Yönetim ihtiyaçları olan bir ekip mi? LiteLLM kullanın.
Anthropic olmayan modeller kullanarak ne kadar tasarruf edebilirim?
Claude Opus 4.6'dan DeepSeek V3.2'ye geçmek çıkış token maliyetlerini yaklaşık %95 azaltır (milyon token başına ₺800'e karşı ₺35). Donanımınız varsa Ollama bunu sıfıra indirir. Ancak kalite takasları gerçektir -- karmaşık çok adımlı ajansal görevlerde daha düşük doğruluk, daha az güvenilir araç çağrısı ve daha fazla hayali dosya yolu bekleyin.
Araç çağrısı tüm proxy yöntemleriyle çalışır mı?
Genel olarak güvenilir biçimde değil. Yerel Claude en iyi araç çağrısı desteğine sahiptir. OpenRouter ile Claude modelleri neredeyse aynı şekilde çalışır. DeepSeek ve Gemini kısmi desteğe sahiptir -- basit araç çağrıları çalışır, ancak karmaşık zincirler başarısız olabilir. Ollama üzerinden yerel modeller en az güvenilir araç çağrısına sahiptir. Bu, Anthropic'ten uzaklaşırken birinci sıradaki kalite endişesidir.
Kaynaklar
- Model Yapılandırması -- Claude Code Belgeleri
- LLM Ağ Geçidi Yapılandırması -- Claude Code Belgeleri
- Claude Code Entegrasyonu -- OpenRouter Belgeleri
- Claude Code Entegrasyonu -- Ollama Belgeleri
- Claude API Fiyatlandırması -- Anthropic
- claude-code-router -- GitHub
- claude-code-proxy -- GitHub
- Claude Code'u Anthropic Olmayan Modellerle Kullanma -- LiteLLM Belgeleri