guides

Claude Code Faturasını %90 Düşür: OpenRouter, Ollama veya LiteLLM Kullan

Yazan Mert Batur
Güncellendi Jul 5, 2026
13 okuma
Claude Code Faturasını %90 Düşür: OpenRouter, Ollama veya LiteLLM Kullan

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öntemEn İyi KullanımMaliyetKurulumModeller
OpenRouterModel çeşitliliği, tek API anahtarıToken başına ödeme (geçiş)Kolay300+
OllamaGizlilik, ücretsiz, çevrimdışıÜcretsiz (kendi donanımınız)Kolay50+ açık kaynak
LM StudioGUI ile yerel modellerÜcretsiz (kendi donanımınız)Kolay50+ açık kaynak
claude-code-routerGörev bazlı akıllı yönlendirmeSağlayıcıya göre değişirOrtaYapılandırmaya bağlı
claude-code-proxyGemini/OpenAI arka ucuSağlayıcı fiyatlandırmasıOrtaOpenAI + Gemini
LiteLLMKurumsal, yük dengelemeSağ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.

bash
# 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"
<!-- IMAGE: Architecture diagram showing Claude Code request routing through ANTHROPIC_BASE_URL to multiple providers (OpenRouter, Ollama, LiteLLM, claude-code-router) -->

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ı

  1. openrouter.ai adresinde bir hesap oluşturun ve bir API anahtarı oluşturun
  2. Mevcut Anthropic oturumunu temizlemek için claude /logout çalıştırın
  3. Ortam değişkenlerinizi ayarlayın:
bash
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"
  1. claude baş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örevModelNeden
Ucuz arka plan görevleriDeepSeek V3.2MTok başına 0,27 $/1,10 $, makul araç çağrısı
Varsayılan kodlamaClaude Sonnet 4Doğrudan bağlantıyla aynı kalite, birleşik faturalandırma
Büyük kod tabanları (1M bağlam)Gemini 2.5 FlashMTok başına 0,15 $/0,60 $, devasa bağlam penceresi
Karmaşık muhakemeClaude Opus 4En 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ı

  1. ollama.com adresinden Ollama'yı yükleyin
  2. Kodlamaya odaklı bir model indirin
  3. Claude Code uyumluluğuyla başlatın
  4. Ortam değişkenlerinizi ayarlayın
bash
# 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

ModelBoyutGüçlü YönNotlar
Qwen 2.5 Coder 14B14BGenel olarak en iyi yerel kodlamaGüçlü araç çağrısı, iyi bağlam işleme
devstral24BMistral'ın kodlama uzmanıYeniden düzenleme ve kod incelemesi için harika
GLM 4.79BGenel 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örOllamaOpenRouter
Maliyet modeliYerelde ücretsiz, donanım için ödersinizÇoğu modelde ek ücretsiz, token başına geçiş
Örnek fiyatToken başına 0 $DeepSeek V3.2: 0,27 $/1,10 $, Gemini 2.5 Flash: MTok başına 0,15 $/0,60 $
Donanım16GB RAM (7B) ila 24GB+ VRAM (32B+)Yok, tamamen barındırılan
Model erişimi50+ açık kaynak modelSağlayıcılar genelinde 300+
GizlilikKod 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

  1. LM Studio'yu indirin ve yükleyin
  2. Bir kodlama modeli arayın ve indirin (Qwen 2.5 Coder, devstral vb.)
  3. LM Studio arayüzünden yerel sunucuyu başlatın
  4. Claude Code'u ona yönlendirin:
bash
# 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

bash
npm install -g claude-code-router
claude-code-router init
claude-code-router start

init komutu, sağlayıcılarınızı ve model eşlemelerinizi tanımladığınız bir config.json oluşturur:

json
{
  "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.

bash
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:

yaml
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
bash
# 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örClaude Code RouterLiteLLM
Kurulum zorluğuOrta: npm install, config.json düzenleİleri düzey: YAML yapılandırma dosyası
En iyi kullanımGörev bazlı yönlendirme isteyen solo geliştiricilerYönetişime ihtiyaç duyan ekipler
Yapılandırma biçimiconfig.jsonYAML model_list
Öne çıkan özellikBağlama duyarlı görev bazlı yönlendirmeYük dengeleme, yedekleme, denetim günlüğü
SağlayıcılarOpenRouter, DeepSeek, Gemini, Ollama, Groq ve daha fazlasıSağlayıcılar genelinde 100+
Olgunluk30k+ GitHub yıldızı, Claude Code için inşa edildiKurumsal 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öntemGiriş (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₺480Aynı (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"

"Claude Opus 4.6, 1M çıkış token başına ₺800 maliyetliyken DeepSeek V3.2 sadece ₺35 -- 23 kat maliyet farkı. Ollama yerel donanımda tamamen ücretsiz çalışır."
Veri tablosu
"Model Başına 1M Çıkış Token Maliyeti"
"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ınNeden
Maksimum model çeşitliliği, tek API anahtarıOpenRouter300+ model, kolay kurulum, kullandıkça öde
Ücretsiz, sınırsız, kod yerelde kalırOllamaSıfır maliyet, tam gizlilik, çevrimdışı çalışabilir
Görsel arayüzle yerel modellerLM StudioGUI model tarayıcı, kolay niceleme seçimi
Akıllı görev bazlı yönlendirmeclaude-code-routerMuhakeme Opus'a, hızlı düzenlemeler DeepSeek'e
Özellikle Gemini veya OpenAI modellericlaude-code-proxyAnthropic formatını OpenAI/Gemini'ye çevirir
Kurumsal: yük dengeleme, denetimLiteLLMHı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.

bash
# 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.

bash
# Sağlayıcı değiştirmeden önce önbelleğe alınmış kimlik doğrulamayı temizleyin
claude /logout

SSS

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

Etiketler

claude-codeopenrouterollamalitellmclaude-code-routeryerel-modelleryapay-zeka-kodlama-araclari

Bu makaleyi paylaş

Projenize Başlayın

Harika bir şey inşa etmeye hazır mısınız?

Vizyonunuzu hayata geçirelim. Fark yaratan yazılımlar için ekibimiz hazır.