Claude Code'u Ücretsiz Modellerle Çalıştır — Claude Code Router Kurulumu

Claude Code'un en iyi yanı terminali; ama asıl maliyeti arka plandaki Anthropic modelleri yaratıyor. Tam da burada devreye giren ücretsiz ve açık kaynaklı bir router var: Claude Code arayüzünü birebir korurken, isteklerini çok daha ucuz veya ücretsiz model arka uçlarına yönlendiriyor. Sonuç: faturan ciddi şekilde düşüyor.

Baştan dürüst olalım: bu yöntem sana Anthropic'in modellerini bedavaya vermiyor. Onun yerine, işin çoğunu maliyetin çok küçük bir bölümüne halleden güçlü alternatif modelleri devreye sokuyor.

⚠️ Türkiye'den kullananlar için önemli not: NVIDIA NIM, Türkiye telefon numaralarıyla doğrulama yapmıyor. NVIDIA NIM kullanmak isteyenlerin yurt dışı bir numaraya ihtiyacı olacak. TR numarasıyla doğrulama yapamayacağın için, Türkiye'den kullananların pratikte OpenRouter'a yönelmesi gerekiyor.

Araç

Adı Claude Code Router (github.com/musistudio/claude-code-router). MIT lisanslı, yaklaşık 28.000 yıldızlı bir proxy. Claude Code ile seçtiğin sağlayıcı arasında oturuyor; istekleri çeviriyor, böylece CLI tıpatıp aynı şekilde davranırken cevabı farklı bir model veriyor.

Gerekenler

Node.js ve Claude Code kurulu olmalı, bir de sağlayıcıdan ücretsiz bir API key. En kolayı OpenRouter (openrouter.ai); tek key ile DeepSeek, Kimi, GLM ve Qwen gibi ücretsiz modellerin kapısı açılıyor. NVIDIA NIM (build.nvidia.com) de ücretsiz key veriyor — ama yukarıdaki not geçerli: TR numarası çalışmıyor, yurt dışı numara gerekiyor.

Adım 1 — Router'ı Kur

npm install -g @musistudio/claude-code-router

Adım 2 — Sağlayıcını Ekle

~/.claude-code-router/config.json dosyasını oluştur ve sağlayıcınla key'ini içine yaz. Ücretsiz modellerle bir OpenRouter kurulumu:

{
  "Providers": [
    {
      "name": "openrouter",
      "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
      "api_key": "sk-or-v1-YOUR-KEY-HERE",
      "models": ["deepseek/deepseek-chat", "moonshotai/kimi-k2", "z-ai/glm-4.6"],
      "transformer": { "use": ["openrouter"] }
    }
  ],
  "Router": { "default": "openrouter,deepseek/deepseek-chat" }
}

Model ID'leri zamanla değişiyor; güncel olanları OpenRouter'ın model listesinden al (ücretsiz olanlar :free ile bitiyor).

Adım 3 — Çalıştır

ccr code

Bu, normal Claude Code deneyimini başlatır — sadece seçtiğin modele yönlendirilmiş halde. Oturum içinde istediğin an model değiştirebilirsin:

/model openrouter,moonshotai/kimi-k2

Tamamen yerel ve özel mi istiyorsun?

İyi bir GPU'n varsa her şeyi Ollama ile kendi makinende çalıştırabilirsin; böylece hiçbir şey bilgisayarından çıkmaz ve API maliyeti sıfır olur:

ollama serve
ollama pull qwen2.5-coder

Sonra config'indeki bir sağlayıcı kaydını http://localhost:11434/v1/chat/completions adresine yönlendir. Buluttan yavaş ama gerçekten ücretsiz ve özel.

Birkaç dürüst not

Ücretsiz bulut modelleri günlük rate limit'lerle geliyor ve liste sürekli değişiyor; yani "ücretsiz"i "limitli ücretsiz" olarak düşün, sınırsız değil. Kalite de modele göre değişiyor: DeepSeek ve Qwen'in coder modelleri Claude Code'un tool çağrılarını iyi idare ederken, daha küçük yerel modeller zorlanabiliyor. Güçlü bir ücretsiz modelle başla, gerçek işlerinde nasıl davrandığını gör; ağır işler için kenarda bir ücretli key tut.