Kurs
Claude Code'u otuz saniyede kurarsınız, bir proje dizini içinde claude çalıştırırsınız ve mevcut hesabınızın kapıyı açmadığını keşfedersiniz. Çoğu kişi burada ücretsiz bir sürüm aramaya başlar — ve yanıtlar burada bulanıklaşır, çünkü "ücretsiz" terimi terminal aracısını mı, sohbet arayüzünü mü, yoksa altta başka bir modelin düşündüğü Claude Code iş akışını mı istediğinize göre farklı anlamlara gelir.
Bu makale, size hiçbir maliyeti olmayan dört kurulum yolunu kapsar; her biri gerçeğe yakınlığına göre kabaca sıralanmıştır. Önkoşullar minimaldir: bir terminal ve Claude Code'un desteklediği platformlar (macOS 13+, Windows 10 build 1809+, Ubuntu 20.04 veya Debian 10+, 4 GB RAM). Yerel yükleyici kendi çalışma zamanını içerir, bu yüzden Node.js yalnızca npm yolunu seçerseniz önemlidir.
Kısaca
-
Claude.ai ücretsiz planı Claude Code'u içermez.
-
Yeni konsol hesapları, CLI erişimi sağlayan tek seferlik bir API kredisi alır.
-
Claude Code uç noktasını
ANTHROPIC_BASE_URL'den okur; bu da OpenRouter ve Ollama yollarını mümkün kılar. -
Bu iki yol size altta Claude değil, farklı bir modelle Claude Code iş akışını verir.
-
Açık kaynak bakımcıları en üst düzey plana altı ay erişim alabilir.
Claude Code Nedir?
Claude Code, Anthropic'in terminal için aracısal kodlama aracıdır. Proje dizininizde çalışır, dosyalarınızı okur, düzenler, komutlar yürütür ve hiçbir şeyi bir tarayıcıya kopyalamanıza gerek kalmadan çok adımlı görevleri ele alır.
Ücretli olmasının nedeni ticari değil yapısaldır. Yaptığı her işlem bir API çağrısıdır ve aracısal oturumlar doğası gereği konuşkandır: model bağlamı tekrar okur, araçları çağırır, sonuçları kontrol eder ve yeniden dener. Büyük bir depoda yoğun bir öğleden sonra, özellikle verimli hissettirmeden, birkaç dolarlık belirteç maliyetine çıkabilir.
Aracın günlük olarak neler yaptığına dair tam bir resim istiyorsanız, Claude Code eğitimimiz kurulumu, yeniden düzenlemeyi ve hata ayıklamayı pratikte ele alır.
Claude Code Ücretsiz mi?
Doğrudan cevap hayır. Anthropic'in kurulum belgeleri, Claude Code'un Pro, Max, Team, Enterprise veya Console hesabı gerektirdiğini ve ücretsiz Claude.ai planının erişim içermediğini belirtir. Pro, ayda 20 $'dan başlar veya yıllık peşin 200 $ öderseniz ayda 17 $'dır.
Alternatif, abonelik olmadan belirteç başına ödeme yaptığınız konsol faturalamasıdır. Claude Sonnet 5 genellikle milyon giriş belirteci başına 3 $ ve milyon çıkış belirteci başına 15 $ seviyesinde çalışır. Claude Opus 5, 5 $ ve 25 $; Haiku 4.5 ise 1 $ ve 5 $ seviyesindedir.
Bu iki yol tamamen farklı mantıkla ücretlendirir ve yanlış olanı seçmek, insanların fazla ödeme yapmasına veya görev ortasında kısılmasına yol açar. İşte nasıl kıyaslandıkları.mpare.
|
Claude aboneliği (Pro, Max, Team) |
Konsolda belirteç başına ödeme |
|
|
Neye ödeme yaparsınız |
Kullanım hakkını kapsayan sabit aylık ücret |
Gerçekte gönderip aldığınız belirteçler |
|
Maliyet |
Pro için 20 $/ay, Max için 100 veya 200 $, Team Premium koltuk için 125 $ |
Aylık ücret yok. Sonnet 5 milyon belirteç başına 2/10 $, Opus 5 5/25 $, Haiku 4.5 1/5 $ |
|
Model erişimi |
Varsayılan olarak Sonnet 5, Pro ve üstünde Opus mevcut |
Ücret tablosundaki tüm modeller; ucuz işler için Haiku 4.5 ve en üstte Fable 5 dahil |
|
Sizi ne sınırlar |
Claude chat, Cowork ve Claude Code arasında paylaşılan yuvarlanan beş saatlik pencere artı haftalık sınır |
Oran limitleri, mesaj kotası yerine kullanım katmanınıza (Start, Build veya Scale) bağlıdır |
|
Duvara çarptığınızda |
Pencerenin sıfırlanmasını beklersiniz veya API ücretleriyle ek kullanım satın alırsınız |
Ön ödemeli kredileriniz bitene kadar hiçbir şey durmaz; o noktada istekler faturalama hatasıyla başarısız olur |
|
Maliyet öngörülebilirliği |
Sabit. Ay başlamadan rakamı bilirsiniz |
Değişken. Yoğun bir yeniden düzenleme haftası, sakin bir haftanın birkaç katına mal olur |
|
Ücretsiz başlangıç noktası |
Yok. Pro veya Max için deneme yok |
Yeni hesaplarda tek seferlik başlangıç kredisi |
|
En uygun kullanım |
Düzenli günlük kullanım; düz ücret, ölçülü faturalamadan belirteç başına daha ucuza gelir |
Aralıklı veya seyrek kullanım, değerlendirme ve aylık taahhüt istemeyen herkes |
Kesişme noktası hacim değil, kullanım tutarlılığıdır. Bir abonelik, plan tavanına ulaşana kadar API'den çok daha iyi etkin oranda belirteç satın alır; bu yüzden günlük kullanıcılar Pro ile neredeyse her zaman kârlı çıkar. Haftalarınız birbirine hiç benzemiyorsa ölçülü faturalama kazanır; çünkü sakin olanlarda hiçbir şey ödemezsiniz.
Peki "ücretsiz" nereden geliyor? Kabaca üç yerden.
- Başlangıç kredisi: Anthropic'in yeni API hesaplarına verdiği
- Claude Code'un Anthropic Messages biçimini konuşan, barındırılan (OpenRouter) veya yerel (Ollama) ücretsiz sunucular dahil her sunucuyla konuşabilmesi
- Açık kaynak bakımcılarına yönelik bir hibe programı
İkinci kategori için baştan bir uyarı gerekir. Claude Code'u ücretsiz bir modele yönlendirmek size arayüzü ve ajan döngüsünü verir, Claude'u değil. Çok adımlı akıl yürütmede kalite farkı gerçektir; buna geri döneceğim.
Ücretsiz Plan Claude Code'u İçeriyor mu?
Önce en yaygın yanlış anlamayı ele alayım; çünkü pek çok kişinin akşamını boşa harcıyor.
Ücretsiz katman Claude Code'u içermez. Sınırlı bir sürüm değil, deneme sürümü değil, hiçbiri. Anthropic'in belgeleri açık: ücretsiz plan, web, iOS, Android ve masaüstünde Claude'u kapsar; terminal aracısı dahil değildir.
Aldığınız şey gerçekten kayda değerdir. 1 Temmuz 2026'dan beri ücretsiz plan, varsayılan model olarak Claude Sonnet 5'i çalıştırır; web araması, dosya yüklemeleri, Projects ve Artifacts ile birlikte — bunların hepsi eskiden ödeme duvarının arkasındaydı. Bir yığın izini yapıştırıp neyin ters gittiğini sormak için gayet yeterlidir.
Geliştiricilerin ilk karşılaştığı ücretsiz katman limitleri
Anthropic bir mesaj sayısı yayınlamaz ve kesin bir rakam veren herkes tahmin yürütüyordur. Şirket, Pro'yu Free'in oturum başına kullanımının en az beş katı olarak tanımlar; bu da Free'i sabit bir kota değil, temel seviye yapar. Pratikte raporlar, yuvarlanan 5 saatlik pencerede yaklaşık 15 ila 40 mesaj arasında kümelenir; daha uzun mesajlar ve ekler bunu daha hızlı tüketir.
Mesaj sayısından daha önemli olan birkaç limit vardır:
- Beş saatlik pencere, ilk mesajı gönderdiğinizde yuvarlanmaya başlar.
- Claude Code CLI erişimi yok. Bu zor olan ve hiçbir geçici çözüm bunu değiştirmez.
- Limitler sunucu yüküne göre esner; bu da yoğun saatlerin daha kötü olduğu anlamına gelir.
- Uzun konuşmalar mesaj başına daha pahalıdır; çünkü her turda tüm konu baştan okunur.
Sonuç: ücretsiz sohbet katmanı, tek seferlik sorular ve kod incelemesi için iyidir; bir kod tabanı üzerinde sürekli ileri geri istediğiniz anda dağılır. Ki bu tam da Claude Code'un var olma nedenidir.
Seçenek 1: Anthropic API Ücretsiz Kredileri
Bu, en az bilinen resmi yol ve bana göre çoğu kişinin başlaması gereken seçenektir.
Şu adreste bir hesap oluşturmak platform.claude.com bir defalık başlangıç kredisi sağlar. Anthropic'in fiyatlandırma belgeleri bunu, bir rakam belirtmeden yalnızca "az miktarda ücretsiz kredi" olarak tanımlar; üçüncü taraf raporları ise tutarlı biçimde yaklaşık 5 $ olduğunu söyler.
API kredileri, Claude Code CLI'yi kimlik doğrular. Gerçek kod tabanınızda, gerçek Claude modellerini çalıştıran gerçek aracıyı elde edersiniz. Krediler yenilenmez ve 14 gün sonra sona erer; bu yüzden bunu bir tedarikten ziyade deneme olarak düşünün.
API hesabı kurma ve kredileri talep etme
Tüm yol, soğuk bir kayıttan çalışan bir ajana yaklaşık 10 dakikada gider ve bunun çoğu yükleyiciyi beklemeye harcanır. Beş adıma böldüm; çünkü üçüncü adım, insanlara yeniden başlatmaya mal olan bir tuzak içerir.
Adım 1: Console hesabınızı oluşturun
Şu adrese gidin platform.claude.com ve e-posta adresinizle kaydolun. Konsol, claude.ai sohbet arayüzünden ayrı bir üründür; bu nedenle mevcut bir Claude hesabı taşınmaz ve aynı adresle yeniden kayıt olmanız gerekebilir.

Açıklık getirmek için: Bazı hesaplardan bu aşamada telefon numaralarını doğrulamaları istenir. İşi bitirdiğinizde, başlangıç kredisi bir promosyon alanından talep edilmek yerine otomatik olarak uygulanır.
Adım 2: Kredi bakiyenizi kontrol edin
Konsol gezintisinden Billing bölümünü açın. Başlangıç bakiyeniz burada görünür; ayrıca henüz ihtiyacınız olmayan bir ödeme yöntemi ekleme seçeneği de yer alır.
Başka bir şey yapmadan önce bunu kontrol edin. Bakiye sıfır görünüyorsa, daha sonra yapılacak hiçbir doğru yapılandırma çalışan bir oturum üretmez.
Adım 3: Bir API anahtarı oluşturun
Şuraya gidin Settings > API Keys ve yeni bir anahtar oluşturun. Çoğu kişinin birkaç anahtarı olacağından, üç ay sonra tanıyacağınız bir ad verin.

Tam anahtar değeri yalnızca bir kez görüntülenir. İleti görünür görünmez bir şifre yöneticisine kopyalayın; çünkü o iletişim kutusunu kopyalamadan kapatmak, anahtarı kaybetmek ve adımı yeniden yapmak anlamına gelir.
Adım 4: Anahtarı dışa aktarın ve Claude Code'u kurun
Anahtarı kabuğunuzda bir ortam değişkeni olarak dışa aktarın; ardından CLI'ı kurun. Anthropic, kendi çalışma zamanını içeren ve hiç Node.js gerektirmeyen yerel yükleyiciyi önerir.
export ANTHROPIC_API_KEY="sk-ant-your-key-here"
curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell'de yükleyici irm https://claude.ai/install.ps1 | iex şeklindedir. npm'i tercih ediyorsanız, Claude Code v2.1.198 itibarıyla paketin Node.js 22 veya üstü beklediğini unutmayın; bu, eski kılavuzların hâlâ alıntıladığı Node.js 18 tabanından bir değişimdir:
npm install -g @anthropic-ai/claude-code
export satırını yeni bir terminal penceresinden sonra anahtarın kalıcı olması için ~/.zshrc veya ~/.bashrc dosyanıza ekleyin. Ardından kurulumun yerleştiğini doğrulayın:
claude --version
Adım 5: İlk oturumunuzu çalıştırın
Bir proje dizinine geçin ve ajanı başlatın. claude komutunu ana dizininizden çalıştırmak teknik olarak işe yarar; ancak araç, okuyacak bir kod tabanı olmadan fazlasıyla işe yaramazdır.
cd ~/projects/my-app
claude
İlk başlatmada ANTHROPIC_API_KEY ayarlıysa, Claude Code OAuth için bir tarayıcı açmak yerine anahtarı onaylamanızı bir kez ister. Onaylayın ve alt kısımda çalışma dizininiz doğrulanmış şekilde karşılama ekranına inersiniz:

Kurulumu değil de faturalama yolunu doğrulamak için oturum içinde /status çalıştırın. API key satırında ANTHROPIC_API_KEY adının geçmesi, oturumun kaydedilmiş bir claude.ai girişi yerine Console kredilerini kullandığını gösterir.
Bu noktada bir şeyler yanlış görünüyorsa, claude doctor bir oturum başlatmadan kurulum ve ayar tanılarını yazdırır ve hata dizelerini aramaktan daha hızlı bir ilk hamledir.
Ücretsiz krediler ne kadar yeter?
Mevcut tanıtım oranlarında Sonnet 5 kullanarak kabaca hesap. Gerçek bir depoda on beş alışveriş hayal edin; her biri yaklaşık 30.000 belirteç bağlam gönderiyor ve 1.500 belirteç çıktı üretiyor. İlk tur tam giriş fiyatını öder ve sonraki on dördü, çoğunlukla fiyatın %10'u ile önbelleğe çarpma yaşar.
|
Kalem |
Hesaplama |
Maliyet |
|
İlk tur, önbelleksiz giriş |
30.000 belirteç, 2 $/MBel |
0,06 $ |
|
Sonraki on dört tur, önbellek okumaları |
420.000 belirteç, 0,20 $/MBel |
0,08 $ |
|
On beş turun tamamında çıktı |
22.500 belirteç, 10 $/MBel |
0,23 $ |
|
Oturum toplamı |
0,37 $ |
|
|
Önbellekleme olmadan aynı oturum |
Tam fiyatla 450.000 giriş belirteci |
1,13 $ |
Bunu bir fiyat teklifi değil, bir büyüklük sırası olarak düşünün. Yukarıdaki model düz bağlam varsayar ve önbellek yazma primini yok sayar; bu, beş dakikalık önbellek için taban giriş fiyatının 1,25 katıdır; dolayısıyla gerçek oturumlarınız bunun iki tarafından birine düşecektir.
Son iki satır arasındaki fark, içselleştirmeye değer kısımdır. Önbellekleme faturayı kabaca dörtte üç azaltır; bu yüzden Claude Code oturumları, saf belirteç sayımının önerdiğinden çok daha ucuza mal olur ve önbelleği bozan her şey (depolar arasında zıplamak, oturumları sürekli yeniden başlatmak, oturum ortasında model değiştirmek) sessizce ödediğiniz miktarı üçe katlar. Anthropic'in fiyatlandırma belgeleri bunu düzgün modellemek isterseniz tam çarpan tablosuna sahiptir.
Model oran farkları
Model seçimi, kontrolünüz altındaki herhangi bir şeyden daha çok sayıyı değiştirir. Aynı on beş alışverişlik oturumu seri boyunca çalıştırmak:
|
Model |
Giriş / çıkış (MBel başına) |
Oturum başı maliyet |
5 $ ile oturum sayısı |
|
Haiku 4.5 |
1 $ / 5 $ |
0,18 $ |
yaklaşık 27 |
|
Sonnet 5 (tanıtım, 31 Ağu 2026'ya kadar) |
2 $ / 10 $ |
0,37 $ |
yaklaşık 13 |
|
Sonnet 5 (standart, 1 Eyl 2026'dan itibaren) |
3 $ / 15 $ |
0,55 $ |
yaklaşık 9 |
|
Opus 5 |
5 $ / 25 $ |
0,92 $ |
yaklaşık 5 |
|
Fable 5 |
10 $ / 50 $ |
1,85 $ |
3'ten az |
Dolayısıyla beş dolarlık bir bakiye, tamamen hangi modele yönlendirdiğinize bağlı olarak beş ile yirmi yedi oturum arasında bir şey satın alır. Değerlendirme için mantıklı varsayılan Sonnet 5'tir.
Bu bakiyeyi oyuncak örnekler yerine gerçek bir göreve harcayın. Gerçekten sahip olduğunuz bir modülü yeniden düzenleyin veya üç dosya boyunca bir hatanın peşine düşün; çünkü aracın haftanızda yer edinip edinmeyeceğini öğrenmenin tek yolu budur.
Bakiye sıfıra indiğinde bir yedek yoktur. Konsol faturalama kullan-öde modelidir ve Claude Code'un altında bekleyen bir ücretsiz katman bulunmaz.
Seçenek 2: OpenRouter Ücretsiz Modelleri
OpenRouter bir API geçididir ve birkaç yüz modelin önünde durur; bunların döner bir kısmını çağırmak ücretsizdir. Kredi kartı yok, aylık ücret yok, abonelik yok.
Bunun Claude Code ile bağlantısının nedeni, CLI'ın uç noktasını bir ortam değişkeninden okumasıdır. Değişkeni değiştirin, isteklerin gittiği yeri değiştirin. OpenRouter, "Anthropic Skin" adını verdiği bir şey çalıştırır; bu uç nokta Anthropic Messages biçimini kabul eder ve düşünme bloklarını ve yerel araç kullanımını olduğu gibi iletir; bu nedenle yerel bir ara sunucu yoktur.
Ne elde ettiğiniz konusunda net olun; çünkü bunlar Claude modelleri değildir. Claude Code arayüzünü, ajan döngüsünü, dosya düzenlemeyi ve eğik çizgi komutlarını korursunuz; akıl yürütmeyi ise bir Qwen veya Llama varyantı yapar.
OpenRouter'ın kendi belgeleri, Claude Code'un yalnızca Anthropic'in birinci taraf sağlayıcısıyla çalışmasının garanti edildiğini ve "diğer sağlayıcılarla doğru çalışmayabileceğini" uyarır. Bunu saklamaktansa alıntılamayı tercih ederim.
Yönlendirme nasıl çalışır
Üç değişken işi yapar:
-
ANTHROPIC_BASE_URL, Anthropic'in uç noktası yerinehttps://openrouter.ai/api'yi işaret eder. -
ANTHROPIC_AUTH_TOKEN, OpenRouter anahtarınızı taşır ve birAuthorization: Bearerbaşlığı olarak gönderilir. -
ANTHROPIC_API_KEYaçıkça boş bir dizgeye ayarlanmalıdır; aksi takdirde Claude Code, Anthropic'e karşı kimlik doğrulamaya geri dönebilir.
Bunları kabuk profilinizde veya bir Claude Code ayar dosyasında ayarlayabilirsiniz. Kaçınılması gereken bir şey: yerel yükleyici standart .env dosyalarını okumadığından bir proje .env dosyası işe yaramaz.
json
{
"env": {
"ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
"ANTHROPIC_AUTH_TOKEN": "sk-or-v1-your-openrouter-key",
"ANTHROPIC_API_KEY": ""
}
}
Bu dosyayı nereye koyduğunuz göründüğünden daha çok önemlidir. ~/.claude/settings.json dosyasını genel yapılandırma için veya .claude/settings.local.json dosyasını tek bir proje için kullanın; zira Claude Code ikincisini gitignore'ınıza ekler.
Bir projenin .claude/settings.json dosyasına kimlik bilgisi koymayın ; çünkü bu dosya commit edilir ve depoyu klonlayan herkesle paylaşılır.
Claude Code'u OpenRouter ile kurma
-
Claude Code'u kurun; henüz kurmadıysanız yerel yükleyiciyle.
-
Ücretsiz bir hesap oluşturun openrouter.ai adresinde ve Settings > Keys altından bir anahtar üretin. Yalnızca ücretsiz modelleri çağıran bir hesap için kart gerekmez.
-
Yapılandırmayı yazın: Yukarıdaki bloğu kullanarak
~/.claude/settings.jsondosyasına veya aynı üç değişkeni kabuk profilinizde dışa aktarın. -
Daha önce Claude Code'a bir Anthropic hesabıyla giriş yaptıysanız, CLI içinde
/logoutçalıştırın; ardından çıkıp yeniden başlatın. Önbelleğe alınmış bir oturum değişkenlerinizi geçersiz kılar ve kafa karıştırıcı model-bulunamadı hataları olarak yüzeye çıkar. -
claude'u başlatın ve isteklerin nereye gittiğini kontrol edin.
> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://openrouter.ai/api
İstekleriniz ayrıca birkaç saniye içinde OpenRouter etkinlik panosunda görünmelidir; bu, yönlendirmenin tuttuğunu doğrulamanın en hızlı yoludur.
OpenRouter'da ücretsiz model seçimi
Ücretsiz model kimlikleri :free ile biter ve sağlayıcılar model ekledikçe, çektiğinde veya yeniden fiyatlandırdıkça kadro sürekli değişir. OpenRouter ücretsiz modeller koleksiyonu ücretsiz sunulan modelleri gösterir. openrouter/free, ücretsiz modeller için OpenRouter'ın otomatik yönlendiricisidir. Uygun olanı ve isteğinize uyanı seçer; böylece tekil modeller döngüden çıktığında kurulumunuz çalışmaya devam eder. En basit başlangıç noktasıdır; ancak kalite ciddi biçimde değişkenlik gösterir.
OpenRouter'daki fiyatlandırma, kredi tutarları ve ücretsiz model kadrosu aylık bir ritimde değişir ve bunlardan bazıları ben yazarken değişti. Buradaki herhangi bir sayıya dayalı bir plana bağlanmadan önce Anthropic'in fiyatlandırma sayfasını ve OpenRouter'ın ücretsiz filtresini kontrol edin.
Sonra, model seçiminden daha sert vuran oran limitleri var. Ücretsiz modeller, hesabınızdan bağımsız olarak dakika başına 20 istek ve hiç kredi satın almadıysanız günde 50 istek izin verir. Bir kez, bir defaya mahsus 10 $ kredi satın alın ve günlük izin 1.000'e çıkar; bakiye tekrar sıfıra inse bile orada kalır.
Günde elli istek kulağa mantıklı gelir; ta ki bir aracısal oturumun istekleri, konuşkan bir meslektaşın öğleden sonranızı harcadığı gibi harcadığını hatırlayana kadar. Makul derecede kapsamlı tek bir görev, günlük kotanın üçte birini tüketebilir. Başarısız denemeler de sayılır; bu nedenle kör yeniden denemeler durumu daha iyi değil, daha kötü hâle getirir.
Belirli model rollerini yönlendirmek için Claude Code her katman için ayrı değişkenler sunar:
bash
export ANTHROPIC_DEFAULT_SONNET_MODEL="cohere/north-mini-code:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="cohere/north-mini-code:free"
export CLAUDE_CODE_SUBAGENT_MODEL="cohere/north-mini-code:free"
Basit yeniden düzenlemeler, tek dosya düzenlemeleri ve açıklama görevleri iyi dayanır. Bununla birlikte, uzun çok adımlı işler gözle görülür biçimde bozulur ve arıza modu genellikle ham kod kalitesinden ziyade araç çağırmadır; bu yüzden model yanlış aracı seçer, bir sonucu yanlış okur veya döngüye girer.
Görevlere göre modelleri daha kasıtlı biçimde harmanlamak isterseniz, Claude Code Router rehberimiz çoklu model yönlendirmeyi ayrıntılı olarak ele alır.
Seçenek 3: Ollama Yerel Modeller
Ollama, açık modelleri kendi makinenizde çalıştırır. API anahtarları yok, oran limitleri yok ve ağırlıklar indirildikten sonra internet bağlantısı gerekmez.
Ocak 2026'da Ollama, v0.14.0 sürümünde Anthropic Messages API uyumluluğu ekledi ve bu iş akışını pratik hâle getirdi. Ondan önce ortada bir çeviri ara sunucusuna ihtiyacınız vardı. Artık Claude Code doğrudan localhost ile konuşur.
Maliyet ortadan kalkmaz; donanıma kayar — özellikle de yalnızca kapasiteye değil, bellek bant genişliğine.
-
Apple Silicon'da dikkat edilmesi gereken sayı birleşik bellektir: 16 GB,
gpt-oss:20bgibi ~14B bir modeli çalıştırır; ancak kullanmaya değer 30B sınıfı kodlama modelleri, 32K bağlam penceresi eklediğinizde 32 GB veya daha fazlasını ister. -
Windows veya Linux makinede ilgili rakam sistem RAM'i değil, GPU VRAM'dir — RAM'e sığan ama CPU'da çalışan bir model, her görevin onlarca çağrı yaptığı aracısal işlerde çok yavaştır.
Ollama'yı Claude Code ile kurma
-
Ollama'yı kurun. macOS ve Linux'ta bu
curl -fsSL https://ollama.com/install.sh | sh; Windows'ta ise yükleyiciyi ollama.com adresinden indirip çalıştırırsınız. -
Bir kodlama modeli çekin. Güncel Claude modelleriyle yarışamasa da Qwen3-Coder makul bir seçenektir:
ollama pull qwen3-coder. -
Modelin mevcut olduğunu doğrulayın
ollama listile. -
Bağlam uzunluğunu artırın; çünkü insanlar bu ayarı unutur ve sonra modeli suçlar. Ollama, Claude Code için en az 32K belirteç önerir.
-
Claude Code'u yerel uç noktayı işaret edecek şekilde ayarlayın ve modelinizi seçin.
bash
export OLLAMA_CONTEXT_LENGTH=32768
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model qwen3-coder
Kimlik doğrulama belirteci protokol tarafından gereklidir ve Ollama tarafından yok sayılır; bu nedenle değeri önemli değildir. Yapılandırmayı kalıcı tutmak isterseniz aynı üç anahtar ~/.claude/settings.json dosyasının env bloğuna gider.
Sonuçları yargılamadan önce bilinmeye değer iki boşluk var:
-
Anthropic'in istem önbelleklemesi uygulanmaz; bu nedenle her istek sistem istemini ve tam konuşma geçmişini baştan işler; bu da burada pahalı değil, yavaştır.
-
Ollama'nın uyumluluk katmanı
tool_choice'u da yok sayar; Claude Code'un zaman zaman belirli bir araç çağrısını zorlamak için kullandığı bu alan önem taşıdığında ajan yanlış aracı seçip döngüye girebilir.
Bu kurulumun daha derin bir adım adım anlatımı için, Claude Code'u Ollama yerel modelleriyle kullanma üzerine özel bir eğitimimiz ve ayrıca Qwen 3 ve DeepSeek R1'i yerelde çalıştırmaya yönelik ayrı kılavuzlarımız var.
Donanım gerçeklik kontrolü
|
Birleşik bellek / VRAM |
Ne çalışır |
Dürüst hüküm |
|
8 GB |
Yalnızca 7B modeller |
Çoklu dosya akıl yürütmede zorlanır. Tek işlevli sorular için iyi, aracısal işler için can sıkıcı. |
|
16 GB |
7B-14B rahat: |
32K bağlamda düz iş ve açıklamalar için çalışılabilir. |
|
24 GB |
|
Aracısal kodlama için pratik taban. Tek bir 24 GB kart (RTX 3090/4090) veya 24 GB Mac buraya iner. |
|
32 GB+ |
Tam 32K bağlamda 30B sınıfı kodlama modelleri |
Yerelin bir taviz gibi hissettirmeyi bırakıp ücretsiz bulut seçenekleriyle rekabet etmeye başladığı yer burasıdır. |
Çoğu geliştirici için, 32 GB veya daha fazla birleşik bellek/VRAM yoksa, çevrimdışı erişime ihtiyaç duymuyorsanız veya kodunuzun makineyi asla terk etmesini istemiyorsanız OpenRouter, Ollama'yı geride bırakır. Son neden iyidir; bu yüzden bu yolu yalnızca performansa bakarak göz ardı etmem.
Seçenek 4: Açık Kaynak için Claude Programı
Bu konudaki çoğu rehber üç seçenekle durur ve size gerçek ürünü, en üst düzeyde, yarım yıl sağlayanı kaçırır.
Anthropic, Şubat 2026'da Açık Kaynak için Claude'u başlattı ve Temmuz'da genişletti. Nitelikli bakımcılar ve katkıcılar, ayda 200 $'lık plan olan Claude Max 20x'e altı ay boyunca ücretsiz erişim alır. Buna, en üst tüketici katmanında kullanım payı ile Claude Code dahildir.
Yayınlanan uygunluk yolları, çoğu kişinin sandığından daha geniştir:
- npm, PyPI, crates.io, RubyGems veya benzeri kayıt defterlerinde 500 veya daha fazla bağımlı depo, 100 veya daha fazla bağımlı paket ya da toplam aylık 200.000 veya daha fazla indirme alan paketlerin bakımcıları.
- CPython, Rust ekibi, Node.js TSC, bir Apache PMC, CNCF, Kubernetes, Linux çekirdeği, Django veya Rails gibi tanınmış vakıf veya dil projelerinde listelenen committer'lar.
- Son on iki ayda sahip olmadıkları depolara 100 veya daha fazla birleştirilmiş pull request yazmış herkes.
- Deposu, son bir yılda birleştirilmiş pull request ile 20 veya daha fazla benzersiz dış katkıcı çekmiş topluluk inşacıları.
- OpenSSF kritiklik skoru 0,4 veya üzeri olan herhangi bir şeyin bakımcıları.
Anthropic'in sayfası, sınırda olan vakaları da başvurmaya ve ekosistemin sessizce neye dayandığını açıklamaya açıkça davet eder. Program 10.000 alıcıyla sınırlıdır ve sürekli gözden geçirilir; başvurular claude.com/contact-sales/claude-for-oss üzerinden yapılır.
Bir uyarı: Bu, aboneliği kapsar; API kredilerini değil. ANTHROPIC_API_KEY kullanımınız hâlâ ayrı faturalandırılır; bu nedenle bir kişisel plandır, bir CI hattını buna yönlendirmek için değil.
Sizin İçin Doğru Ücretsiz Seçeneği Seçmek
Bunu iki soru belirler: Claude Code'u ne için istiyorsunuz ve sıkılmadan önce ne kadar kurulum yapmaya razısınız?
Karşılaştırma tablosu
|
Seçenek |
Gerçek Claude modeli? |
Claude Code CLI |
Limitler |
En uygun kullanım |
Kurulum çabası |
|
Claude.ai ücretsiz katman (Claude Code değil) |
Evet (Sonnet 5) |
Hayır |
~5 saatte 15 ila 40 mesaj, dinamik |
Ara sıra kodlama soruları ve kod incelemesi |
Yok |
|
API ücretsiz kredileri |
Evet (her model) |
Evet |
Tek seferlik başlangıç kredisi, yaklaşık 5 $ |
Claude Code'u gerçekçi değerlendirme |
Düşük |
|
OpenRouter ücretsiz modeller |
Hayır (Qwen, Llama, GPT-OSS) |
Evet |
20 istek/dak, 50/gün (tek seferlik 10 $ satın alma sonrası 1.000/gün) |
Yerel donanım olmadan sürekli ücretsiz kullanım |
Orta |
|
Ollama yerel modeller |
Hayır (yerel açık modeller) |
Evet |
Donanım bağlı, oran limiti yok |
Çevrimdışı çalışma, mahremiyet, belirteç başı maliyet yok |
Yüksek |
|
Açık Kaynak için Claude |
Evet (Max 20x) |
Evet |
6 ay, sınırlı program, uygunluk gerekli |
Uygun OSS bakımcıları |
Düşük, artı bir başvuru |
Hangisini seçmelisiniz?
- Claude Code'u hiç kullanmadıysanız ve ayda 20 $ etmeye değer olup olmadığını bilmek istiyorsanız, API başlangıç kredilerini alın. Size gerçek ürünü gösteren tek yoldur ve bir düzine oturum bir kanaat oluşturmak için fazlasıyla yeterlidir.
- Sürekli ücretsiz erişim istiyorsanız ve özellikle Claude'a ihtiyaç duymuyorsanız, OpenRouter çaba-kalite oranında en iyi seçenektir. İlk kurulum için bir akşam ayırın ve günlük istek sınırına istediğinizden erken takılmayı bekleyin.
- Çevrimdışı erişime ihtiyacınız varsa veya işvereniniz kaynak kodunun nereye gittiği hakkında görüş sahibiyse, Ollama donanım faturası rağmen cevaptır. 16 GB birleşik bellek/VRAM altındaysa uğraşmazdım.
- Başkalarının üzerine inşa ettiği bir şeyin bakımcısıysanız, bunların hiçbirini yapmadan önce açık kaynak hibesini kontrol edin. En üst düzeyde altı ay, tüm soruyu ortadan kaldırır.
Yönlendirme Kurulumlarında Sorun Giderme
Seçenek 3 ve 4 ortak bir arıza yüzeyini paylaşır ve aynı birkaç sorun bunun çoğunu açıklar. Ne Anthropic ne de geçit sağlayıcıları sizin özel kombinasyonunuzu hata ayıklayabileceğinden, önce şunları kontrol edin.
-
Claude Code sürekli giriş yapmanızı istiyor. CLI'ın kendi kimlik bilgileri yoktur ve erişilebilir bir temel URL, kimlik bilgisi sayılmaz. Bir projenin
.claude/settings.jsondosyasındaki env bloğu yalnızca ilk çalıştırma sihirbazından sonra geçerlidir; bu nedenleANTHROPIC_AUTH_TOKEN'ı daha erken okunan bir yere ayarlayın: bir kabuk dışa aktarımı veya~/.claude/settings.json. -
Başlangıç uyarısı iki kimlik bilgisi kaynağı adı veriyor. Bir geçit kimliği ve kayıtlı bir giriş her ikisi de etkin. Kayıtlı girişi temizlemek için
/logoutçalıştırın veya önceki girişe dönmek için değişkenin ayarını kaldırın. -
Tanınmayan alanlardan bahseden 400 hataları. Claude Code, bazı üst akımların reddettiği alanları Anthropic biçimli uç noktalara gönderir.
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1ayarı, çoğu ön sürüm alanını bastırır ve durumu netleştirir. -
thinking veya adaptive'dan bahseden 400 hataları. Üst akım model uyarlamalı muhakemeyi kabul etmez; Claude Code bunu yakın tarihli Claude modelleri için ister. Bu genelde istemci tarafı düzeltmeden ziyade geçidin üst akımını güncellemeyi gerektirir.
-
Uzaktan kontrol ve sesli dikte çalışmayı durduruyor. Her ikisi de bir claude.ai kimliğine dayanır ve bir geçit kimliği ayarı varken kullanılamaz. v2.1.196'dan beri,
ANTHROPIC_BASE_URLbir Anthropic olmayan ana bilgisayarı işaret ettiğinde uzaktan kontrol de devre dışıdır.
Bir şeyler ters gidiyor ve hangi katmanın sebep olduğundan emin değilseniz, oturum içindeki /status hangi temel URL ve kimlik bilgisi kaynağının gerçekten devrede olduğunu söyler. Tek bir komut, yeniden dışa aktarmaktan çok daha fazlasını çözer.
Son Düşünceler
Claude Code'u ücretsiz kullanmanın dört yolu; hiçbiri kusursuz değil ve ödünler, sonradan akla gelen değil, asıl ilginç kısımdır.
Benim önerim dar. İstediğiniz bir sohbet penceresi değil de Claude Code CLI ajanıysa, API kredileriyle başlayın; çünkü gerçek üründe tek bir gerçek oturumdan, bir yığın ikame yapılandırmaktan daha çok şey öğrenirsiniz. İş akışınızda yer ediniyorsa ayda 20 $ savunulabilir bir kalemdir. Etmiyorsa hiçbir şey kaybetmezsiniz ve nedenini artık bilirsiniz.
Uzun vadede, OpenRouter en sürdürülebilir ücretsiz seçenektir ve mahremiyet veya çevrimdışı erişim vazgeçilmez olduğunda Ollama kazanır.
Faydalı bir oturumu sinir bozucudan ayıran alışkanlıklar için, Claude Code En İyi Uygulamalar gerçek projelerde planlama, bağlam aktarımı ve test odaklı geliştirmeyi kapsar. Ve sıfırdan başlıyorsanız, Claude Code 101, ilk kurulumdan çalışan bir iş akışına kadar sizi getiren etkileşimli, yapılandırılmış derslerle temelleri öğretir.
Ücretsiz Claude Code Erişimi Hakkında SSS
Claude Code ücretsiz mi?
Hayır. Claude Code ücretli bir Claude aboneliği (Pro, Max, Team veya Enterprise) ya da belirteç başına faturalandırılan bir Console hesabı gerektirir. Bunun yerine, her biri bir şeylerden feragat eden meşru birkaç ücretsiz yol vardır.
Ücretsiz Claude planında Claude Code kullanabilir miyim?
Hayır. Ücretsiz plan, web, mobil ve masaüstündeki sohbet arayüzünü kapsar; ancak Anthropic'in kurulum belgeleri, bunun Claude Code erişimini içermediğini açıkça belirtir. Terminal aracısı ödeme duvarının arkasındadır.
Ücretsiz API kredileri gerçekte ne kadar yeter?
Anthropic, yeni Console hesaplarına küçük bir başlangıç kredisi verir; rakamı yayınlamasa da yaygın olarak yaklaşık 5 $ olduğu bildirilir. İstem önbelleklemesi işini yaptığında, Sonnet 5 oranlarıyla gerçek bir depoda odaklı bir oturum yaklaşık 30–40 sente gelir. Bu da kabaca bir düzine oturuma tekabül eder; aracın iş akışınıza uyup uymadığını yargılamak için yeterlidir.
Claude Code, OpenRouter’ın ücretsiz modelleriyle çalışır mı?
Teknik olarak evet; çünkü OpenRouter, Anthropic Messages biçimini konuşan bir uç nokta sunar. OpenRouter, isteklerin yalnızca Anthropic'in kendi modellerine yönlendirildiğinde Claude Code'un çalışmasının garanti edildiği ve ücretsiz bir Qwen veya Llama arka ucunun desteklenen değil, "en iyi çaba" düzeni olduğu konusunda uyarır.
Claude Code’u Ollama’ya karşı çalıştırmak için neye ihtiyacım var?
Ollama v0.14.0 veya üzeri; çünkü bu sürüm Anthropic Messages API ile uyumluluk ekledi. Ayrıca en az 32K bağlamlı bir model ve bunu tutacak kadar RAM istersiniz; pratikte bu, taban olarak 16 GB ve sonuçların taviz gibi hissetmeyi bıraktığı 32 GB demektir. Geri kalan bağlantıları iki ortam değişkeni halleder.
Josep, Avrupa projelerine odaklanan serbest bir Veri Bilimcidir; veri depolama, işleme, ileri analitik ve etkili veri hikâyeleştirme konularında uzmandır.
Eğitmen olarak Navarra Üniversitesi'nin Yüksek Lisans programında Büyük Veri dersleri vermekte ve Medium, KDNuggets ve DataCamp gibi platformlarda yayımladığı makalelerle görüşlerini paylaşmaktadır. Josep ayrıca Databites bülteninde (databites.tech) Veri ve Teknoloji üzerine yazmaktadır.
Katalonya Politeknik Üniversitesi'nden Mühendislik Fiziği lisans derecesine ve Pompeu Fabra Üniversitesi'nden Akıllı Etkileşimli Sistemler yüksek lisans derecesine sahiptir.

