Claude Code'u ücretsiz nasıl kullanırsınız
Claude Code, Anthropic'in bir kodlama ajanıdır. Anthropic Messages API'sine ihtiyaç duyar. Bu kılavuz, Claude Code'u FreeLLMAPI üzerinden ücretsiz modellere nasıl bağlayacağınızı gösterir. İki ortam değişkeni ayarlarsınız. Anthropic anahtarına ihtiyacınız yoktur.
Kod, model adları ve canlı katalog etiketleri İngilizce gösterilir.
Ne alırsınız, ne alamazsınız
Claude Code, her isteği Anthropic biçiminde bir API'ye gönderir. FreeLLMAPI bu biçimi /v1/messages üzerinde konuşur. Her isteği çevirir ve ücretsiz bir modele gönderir, örneğin Gemini, GPT-OSS, Qwen veya GLM.
- Alırsınız: Claude Code arayüzü, araçları, dosya düzenlemeleri ve ajan döngüsü, ücretsiz modeller üzerinde.
- Alamazsınız: Anthropic'in Claude modelleri. Hiçbir sağlayıcı Claude modellerini bir API üzerinden ücretsiz vermez. Ayrıntılar için Ücretsiz bir Claude API'si var mı? sayfasını okuyun.
- Maliyet: çıkarım için $0. Ücretsiz katmanların hız limitleri vardır. Bir limit isteği durdurduğunda FreeLLMAPI bir sonraki sağlayıcıya geçer.
Adım 1: FreeLLMAPI'yi kurun
FreeLLMAPI açık kaynaklıdır. Bilgisayarınızda Docker içinde çalışır. Sağlayıcı anahtarlarınız bilgisayarınızda kalır.
macOS veya Linux
curl -fsSL https://freellmapi.co/install.sh | bashPanoyu http://localhost:3001 adresinde açın. Keys sayfasına en az iki ücretsiz sağlayıcı anahtarı ekleyin. Google AI Studio ve Groq, yaklaşık bir dakikada her biri ücretsiz bir anahtar verir. Birleşik anahtarınızı aynı sayfadan kopyalayın.
Adım 2: Claude Code'u bağlayın
En hızlı yöntem kurulum komutudur. Canlı kataloğunuzu okur, ~/.claude/settings.json dosyasının bir yedeğini alır ve ağ geçidi ayarlarını ekler.
Tek komut
npx freellmapi setup-claude --url http://localhost:3001 --api-key <unified-key>Elle kurmak için iki ortam değişkeni ayarlayın ve Claude Code'u başlatın:
Elle kurulum (macOS veya Linux)
export ANTHROPIC_BASE_URL=http://localhost:3001
export ANTHROPIC_AUTH_TOKEN=<unified-key>
claudeElle kurulum (Windows PowerShell)
$env:ANTHROPIC_BASE_URL="http://localhost:3001"
$env:ANTHROPIC_AUTH_TOKEN="<unified-key>"
claudeANTHROPIC_AUTH_TOKEN kullanın. ANTHROPIC_API_KEY kullanmayın. ANTHROPIC_API_KEY ayarlıysa Claude Code bir çakışan kimlik bilgisi görür ve başlamaz.İsteklerin ağ geçidine gittiğinden emin olmak için npx freellmapi doctor komutunu çalıştırın. Her yanıtta ayrıca bir X-Routed-Via üstbilgisi bulunur. Bu üstbilgi, yanıt veren sağlayıcıyı ve modeli gösterir.
Adım 3: Ajan işi için modelleri seçin
Claude Code uzun istemler gönderir. Tipik bir istek, büyük bir sistem istemi, araç tanımları ve dosya içeriği içerir. Araç çağrısı ve geniş bir bağlam penceresi olan modeller kullanın. Dakikadaki token sayısı düşük küçük ücretsiz katmanlar bu isteklerde başarısız olur.
Keys, Anthropic sekmesinde her Claude ailesini (opus, sonnet, haiku) auto değerine veya bir modele eşleyin. auto ile yönlendirici her istek için ücretsiz bir model seçer. Tablo, bugünkü katalogdan araç çağrısı ve en az 128K bağlam içeren ücretsiz modelleri gösterir.
| Model | Ücretsiz olduğu yer | Bağlam | Ücretsiz limitler (en iyi teklif) | Araçlar | Görsel girdi |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 istek/dk 1 req/min per model | Evet | Hayır |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 istek/dk 40 RPM | Evet | Evet |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Evet | Evet |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Evet | Hayır |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Evet | Evet |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Evet | Evet |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 istek/dk 50 istek/gün 50 req/day account-wide (1,000 after a $10 purchase) | Evet | Evet |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 istek/dk 50 istek/gün Shared rate limit | Evet | Hayır |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 istek/dk 250 istek/gün 70,000 jeton/dk ~6M | Evet | Evet |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Evet | Evet |
109 eşleşen ücretsiz modelden 12 tanesi gösteriliyor. Tüm modelleri gör.
Canlı veriler FreeLLMAPI kataloğundan alınır (sürüm 2026.11.19, 2026-11-19 tarihinde kontrol edildi). Ücretsiz limitler sık değişir. Katalog her gün kontrol edilir.
Hız limitleri ve yedeklemenin yardımı
Tek bir Claude Code görevi 20 ile 100 arasında istek gönderebilir. Tek bir ücretsiz katman sizi hızla durdurur. Örneğin ücretsiz bir Gemini Flash anahtarı günde az sayıda isteğe izin verir. FreeLLMAPI her anahtarın kotasının sayısını tutar. Bir sağlayıcı 429 hatası gönderdiğinde yönlendirici havuzdaki bir sonraki sağlayıcıyı dener. Claude Code oturumunuz devam eder.
- Dört veya daha fazla sağlayıcıdan anahtar ekleyin. Daha fazla anahtar, günde daha fazla istek verir.
haikudeğerini hızlı, küçük bir modele eşleyin. Claude Code bunu kısa arka plan görevleri için kullanır.- Bağlamı küçük tutun. Daha az token göndermek için görevler arasında
/clearkullanın.
Sorun giderme
| Sorun | Neden | Çözüm |
|---|---|---|
| Claude Code oturum açmanızı istiyor | Ortam değişkenleri bu kabukta ayarlı değil | ANTHROPIC_BASE_URL ve ANTHROPIC_AUTH_TOKEN değerlerini ayarlayın, sonra claude komutunu yeniden başlatın |
| "Çakışan kimlik bilgisi" veya başlamıyor | ANTHROPIC_API_KEY ayarlı | unset ANTHROPIC_API_KEY ile kaldırın |
| Her istekte hata 429 | Tüm sağlayıcı anahtarlarınız limitinde | Keys sayfasından daha fazla sağlayıcıdan anahtar ekleyin |
| Araç çağrıları başarısız oluyor veya ajan duruyor | Model, araç çağrısını iyi desteklemiyor | Aileyi yukarıdaki tablodan bir modele eşleyin |
| İstekler yavaş | Yavaş bir ücretsiz modelde büyük istemler | Hızlı bir model sabitleyin, örneğin bir Groq veya Cerebras modeli |
Sık sorulan sorular
Claude Code'u ücretsiz kullanmak mümkün mü?
Claude Code programı ücretsiz kurulur. Çalışması için bir model API'sine ihtiyaç duyar. FreeLLMAPI ile ücretsiz sağlayıcı katmanlarını kullanır, bu yüzden çıkarım maliyeti $0 olur.
Gerçek Claude modellerini ücretsiz alabilir miyim?
Hayır. Anthropic, ücretsiz bir Claude API'si vermez. Claude Code, Anthropic biçimindeki uç nokta üzerinden örneğin Gemini, GPT-OSS, Qwen veya GLM gibi diğer ücretsiz modellerde çalışır.
Neden ANTHROPIC_API_KEY yerine ANTHROPIC_AUTH_TOKEN kullanılıyor?
Claude Code, ANTHROPIC_AUTH_TOKEN değerini ağ geçidinize Bearer belirteci olarak gönderir. ANTHROPIC_API_KEY ayarlıysa Claude Code bunu birinci taraf bir kimlik bilgisi olarak değerlendirir ve başlamayı reddeder.
Claude Code için en iyi ücretsiz model hangisi?
Araç çağrısı ve 128K token veya daha fazla bağlam penceresi olan bir model kullanın. Bu sayfadaki tablo, bugün her iki kuralı da karşılayan en güçlü ücretsiz modelleri gösterir.
Bu Windows'ta çalışır mı?
Evet. PowerShell'de iki değişkeni $env:ANTHROPIC_BASE_URL ve $env:ANTHROPIC_AUTH_TOKEN ile ayarlayın, sonra claude komutunu başlatın.
İlgili rehberler
- Ücretsiz bir Claude API var mı?
- En iyi ücretsiz kodlama model API'leri
- Codex CLI'ı ücretsiz modellerle kullanın
- Cline, Roo Code ve Kilo Code ücretsiz API ile
- Ücretsiz LLM API hız sınırları
Kaynaklar
- FreeLLMAPI docs: Anthropic and Claude clients (20 November 2026 tarihinde kontrol edildi)
- FreeLLMAPI CLI generators (20 November 2026 tarihinde kontrol edildi)
- Claude Code documentation: LLM gateway configuration (20 November 2026 tarihinde kontrol edildi)