Kurs
Bir yeniden düzenlemenin ortasındasınız, Claude Code ilerleme kaydediyor ve sonra aniden yanıt vermeyi durduruyor. Çökme yok. Hata yok. Sadece bir kullanım sınırına ulaştığınızı söyleyen bir mesaj. Çoğu kullanıcı bunun çok fazla komut istemi gönderdikleri için olduğunu varsayar. Oysa gerçekte, komut istemleri denklemin sadece küçük bir parçasıdır. Ben de bu sorunla karşılaştım ve onu tam olarak anlamam biraz zaman aldı.
Claude Code'un limit sistemi, her istekte gönderilen ve çok sayıda belirteç (token) tüketen arka plan bağlamıyla birlikte döngüsel oturum pencereleri, haftalık kotalar ve modele özgü hakların birleşimine dayanır. Kurallar dosyaları, MCP araç tanımları, bellek dosyaları ve konuşma geçmişi gibi unsurlar, siz daha fazla yazmadan kullanılabilir kapasitenizin büyük bir bölümünü tüketebilir.
Bu kılavuzda, Claude Code kullanım sınırlarının nasıl çalıştığını, mevcut kullanımınızı nasıl kontrol edeceğinizi ve geliştiricilerin beklenenden daha erken sınırlara takılmasına sıkça neden olan gizli ek yük kaynaklarını açıklayacağım.
Claude Code'a yeniyseniz, önce Claude Code öğreticimize göz atmanızı veya Claude Code 101 kursunu almanızı öneririm.
Claude Code Kullanım Sınırları Nelerdir?
Claude Code kullanımı iki örtüşen sistem tarafından yönetilir:
- 5 saatlik döngüsel oturum penceresi
- Bir veya daha fazla haftalık kullanım kotası
Bunlardan herhangi birine çarpmak hız sınırlamasına takılmanıza neden olur.
5 saatlik döngüsel pencere
En görünür Claude Code hız sınırı 5 saatlik döngüsel penceredir. Pencereniz ilk komut istemini gönderdiğinizde başlar. Sonraki beş saat içinde yaptığınız her şey aynı kullanım havuzundan düşer. Bu havuz Claude Code ve Claude sohbet arasında ortaktır; yani birindeki etkinlik diğerini etkiler.
Örneğin:
- İlk komut istemi: 09:00
- Pencere biter: 14:00
Eğer kullanılabilir kullanımınızı 10:30'a kadar tüketirseniz, erişim 14:00'te pencere sıfırlanana kadar duraklar.
Yaygın bir yanlış kanı, yeni bir konuşma başlatmanın kullanımı sıfırladığıdır. Sıfırlamaz. /clear komutu yalnızca yeni bir konuşma bağlamı başlatır. Kullanım hakkını geri getirmez veya 5 saatlik zamanlayıcıyı sıfırlamaz.
Haftalık sınırlar
Zamanlı oturum sınırlarına ek olarak, Claude Code haftalık sınırlar da uygular. Mevcut oturumunuzda hâlâ boşluk olsa bile, haftalık sınıra ulaşmak haftalık sıfırlama gerçekleşene kadar geçici olarak daha fazla kullanımın önüne geçebilir.
Bunu şöyle düşünebilirsiniz: 5 saatlik sınır kullanımınızın zamanlamasını, haftalık sınır ise toplam kullanım hacminizi sınırlar.
Bu, mevcut 5 saatlik oturumunuzda kapasite kalmış olsa bile haftalık hakkınızı tükettiğiniz için engellenebileceğiniz anlamına gelir. Çoğu Pro kullanıcı için bu ayrım oldukça basittir. Max planları ise ek bir karmaşıklık katmanı getirir.
Max kullanıcıları için Sonnet haftalık sınırı
Anthropic şu anda Max planları için aşağıdaki sınırı uygular:
- Tüm modelleri kapsayan bir haftalık sınır
- Özellikle Sonnet kullanımı için ayrı bir haftalık sınır
Bu ayrım önemlidir; çünkü daha geniş model tahsisinizi tükettikten sonra bile Sonnet kapasiteniz kalmış olabilir ya da tam tersi.
Örneğin, haftanın çoğunu uygulama işi için Sonnet kullanarak geçirdiğinizi varsayalım. Genel haftalık hakkınızda hâlâ kapasite varken Sonnet'e özel haftalık tahsisinizi tüketebilirsiniz. Bu noktada, kalan sınırlarınıza bağlı olarak başka bir modele geçmeniz, Sonnet sıfırlamasını beklemeniz veya planınızı yükseltmeniz gerekebilir.
Tersi durum da yaşanabilir. Hafta boyunca önemli miktarda Opus kullandıysanız, Sonnet'e özel tahsisinizi tamamen tüketmemiş olsanız bile genel haftalık sınırınıza ulaşabilirsiniz. Genel sınır şemsiye sınır olduğundan, ona ulaşmak, ne kadar Sonnet kapasitesi kalmış olursa olsun daha fazla kullanımı engeller.
Sonnet isteklerinin başarılı olması için her iki koşulun da doğru olması gerekir:
- Genel haftalık sınırınızda hâlâ boşluk olmalı.
- Sonnet haftalık sınırınızda hâlâ boşluk olmalı.
Opus istekleri ise ayrı bir Opus'a özel tahsis olmadığı için yalnızca genel haftalık havuzu tüketir. Bu nedenle Claude.ai'deki Kullanım sayfası çok önemlidir. Her haftalık sınırı sıfırlanma süresiyle birlikte bağımsız olarak gösterir; bu da uzun bir kodlama oturumundan önce hangi sınıra yaklaştığınızı anlamayı çok daha kolaylaştırır.

Plana Göre Claude Code Kullanımı
Planları karşılaştırırken bir zorluk, Anthropic'in artık basit "komut istemi sayıları" yayımlamamasıdır.
Bunun yerine, planlar göreli kapasite çarpanlarıyla açıklanır. Bu çarpanlar, Pro plan temel çizgisine göre aldığınız kullanım kapasitesini yansıtır. Bu kesin rakamları elde etmek kolay değildir; bazı kullanıcılar, kapasitelerinin yüzde kaçı başına kaç belirteç kullandıklarına dair makul bir fikir edinmek için kullanımlarını yüzde olarak takip eder.
|
Plan |
Aylık Fiyat |
Göreli Kapasite |
Haftalık Sınırlar |
Claude Chat ile Paylaşımlı |
|
Pro |
$20 |
Temel çizgi |
Evet |
Evet |
|
Max 5x |
$100 |
Pro kapasitesinin 5×i |
Evet |
Evet |
|
Max 20x |
$200 |
Pro kapasitesinin 20×si |
Evet |
Evet |
|
Team |
Değişken |
Daha yüksek paylaşımlı tahsis |
Evet |
Evet |
|
Enterprise |
Özel |
Kuruluşa özel |
Evet |
Evet |
Mayıs 2026 kullanım sınırı değişiklikleri
Anthropic, Mayıs 2026'da abonelik kullanım sınırlarını iki katına çıkararak ve daha önce Pro ve Max abonelerini etkileyen yoğun saat düşüşlerini kaldırarak Claude Code kapasitesini artırdı. Sabit komut istemi sayıları yayımlamak yerine, artık plan farklılıklarını göreli kapasite çarpanlarıyla ifade ediyor; çünkü gerçek kullanım, model seçimi, bağlam boyutu ve araç kullanımına bağlıdır.
O tarihten bu yana, Anthropic zaman zaman geçici promosyonlarla haftalık sınırları ayarladı. Örneğin, Claude Fable 5 dağıtımı sırasında uygun aboneler için haftalık Claude Code sınırları %50 artırıldı. Bu promosyonel artışlar geçici olduğundan, okuyucular uzun süreli iş yüklerini planlamadan önce en güncel sınırları Claude Kullanım panosunda mutlaka doğrulamalıdır.
Agent SDK kredileri (Haziran 2026)
Etkileşimli kodlama oturumlarını otomatik ajan iş yüklerinden ayırma planı, Haziran 2026'da bir miktar kafa karışıklığına yol açtı.
15 Haziran'dan önce, tüm Claude Code etkinlikleri aynı abonelik havuzundan düşülüyordu. Terminalde etkileşimli sohbet etmeniz, bir GitHub Action çalıştırmanız veya bir CI hattında claude -p çağırmanız fark etmeksizin, her şey aynı beş saatlik ve haftalık sınırlara tabiydi.
Anthropic, 15 Haziran 2026'da bu iş yüklerini ayırmaya başlamayı planlamıştı ancak değişikliği bizzat lansman gününde durdurdu. Bu, etkileşimli kullanım ile programatik kullanımın (Agent SDK, claude -p, GitHub Actions) hâlâ eskisi gibi aynı abonelik havuzundan düştüğü anlamına gelir.
Temmuz 2026 itibarıyla, ayrı bir canlı Agent SDK kredisi yoktur ve talep edilebilecek isteğe bağlı bir kredi bulunmamaktadır.
Kotayı Gerçekte Ne Tüketiyor?
Birçok geliştirici komut istemi kullanımına ve belirteç ayarlarına odaklanır. Asıl suçlu çoğu zaman bağlamdır. Her etkileşim, yazdığınız sorudan çok daha fazla bilgi içerir.
CLAUDE.md ve Kurallar Dosyaları
Claude Code talimatları otomatik olarak şuralardan yükler:
-
CLAUDE.md -
Üst dizindeki
CLAUDE.mddosyaları -
İçe aktarılan
@referansları -
.claude/rules/*.mddosyaları
Tüm bu bağlam ve ek talimatlar isteklerde tekrar tekrar gönderilir. Bu, şişkin bir kurallar dosyasının tüm oturum boyunca belirteç tüketimini sessizce artırdığı anlamına gelir. Anthropic, tek tek CLAUDE.md dosyalarını yaklaşık 200 satırın altında tutmayı önerir.
Daha büyük projeler için, yalnızca ilgili olduğunda yüklenecek şekilde yollar ön bilgisi (frontmatter) kullanan kapsamlı kurallara talimatları bölmeyi düşünün. Daha derinlemesine bir inceleme isterseniz, en iyi CLAUDE.md dosyasını yazma rehberimiz etkili organizasyon stratejilerini kapsar.
MCP araç tanımları
Model Context Protocol (MCP) sunucuları bir diğer gizli ek yük kaynağıdır. Bağlı her MCP sunucusu, bu araçları hiç kullanmasanız bile araç şemalarını Claude'un bağlamına enjekte eder.
Şöyle düşünün:
- 5 MCP sunucusu
- Sunucu başına 10 araç
Bu, her istekle birlikte 50 araç tanımı gönderilmesi demektir. Kullanılmayan MCP sunucularını bağlantıdan çıkarmak, Claude Code belirteç tüketimini azaltmanın en kolay yollarından biridir.
Önemli bir uyarı: aktif bir oturum sırasında MCP sunucuları eklemekten veya kaldırmaktan kaçının. Bunu yapmak, komut istemi önbelleği öneklerini geçersiz kılar ve kullanım maliyetlerini artırabilir.
Otomatik bellek
Claude Code v2.1.59'dan beri otomatik bellek varsayılan olarak etkindir. Bellek, Claude'un farklı oturumlar sırasında kaydettiği ve ona daha fazla bağlam sağlayan genel bilgidir. Bu, bir veritabanından veri çekme yöntemlerinden uygulanmış teknik ayrıntılara kadar uzanabilir.
Başlangıçta, Claude MEMORY.md içeriğini şu sınırlara kadar yükler:
- İlk 200 satır
- İlk 25 KB
Bazı iş akışları için bu faydalıdır. Diğerleri içinse sadece fazladan bağlamdır.
Otomatik belleği birkaç yolla devre dışı bırakabilirsiniz. Tüm diğer ayarları geçersiz kılan kalıcı bir kapatma anahtarı için (CI hatları ve otomatik ortamlar için kullanışlıdır), kabuğunuzda ortam değişkenini ayarlayın:
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1
Alternatif olarak, aşağıdakini settings.json dosyanıza ekleyin. Tüm projelerde devre dışı bırakmak için ~/.claude/settings.json kullanın; tek bir proje için .claude/settings.json kullanın:
{ "autoMemoryEnabled": false }
Bellek dosyalarını etkin olarak kullanmıyorsanız, bu özelliği devre dışı bırakmak temel bağlam boyutunu azaltabilir.
Konuşma geçmişi ve arama
Konuşma geçmişi sürekli büyür. Her araç sonucu, dosya okuması, grep çıktısı, terminal komutu ve kod araması oturum bağlamının bir parçası olur.
Deneyimime göre, depo keşfi çoğu zaman en büyük katkı sağlayıcıdır. Claude, tek bir işlevi bulmak için onlarca dosya okuyabilir. Bu dosyalar bağlamda erişilebilir durumda kalır ve sonraki turlarda belirteç ek yüküne katkıda bulunmayı sürdürür.
Otomatik iş akışları için, claude -p --bare gereksiz oturum bağlamını ayıklayarak bu sabit ek yükün çoğunu azaltabilir. Bu, aksi takdirde Claude'un dosyalar arasında arama yaparken tüketeceği aylık Agent SDK kredilerinin önemli bir kısmını tasarruf ettirebilir.
Claude Code Kullanımınızı Nasıl Kontrol Edersiniz
Kullanımınızı kontrol etmek için en iyi zaman, uzun bir kodlama oturumundan öncedir. Böylece kodlamaya başlamadan önce sınırlarınıza ne kadar yaklaştığınızın farkında olursunuz.
/usage kullanımı
Claude Code içinde /usage yazmak şunları gösterir:
- Oturum tüketimi
- Haftalık tüketim
- Kalan tahsis
Bu, etkileşimli oturumunuzda ne kadar kota kaldığına dair genel bir bakış elde etmek ve buna göre plan yapmak için iyi bir yoldur. Sınırınıza gelmek üzereyken büyük, karmaşık bir göreve başlamaya çalışmak en akıllıca olmayabilir; ancak dosya temizliği gibi basit görevler kalan kotanızın iyi bir kullanımı olabilir.
/status kullanımı
Ayrıca /status çalıştırarak şu bilgilere ulaşabilirsiniz:
- Mevcut plan
- Hesap bilgileri
- Aktif kullanım durumu
Planınızı ve aktif durumunuzu bilmek olası sınırlamalar hakkında fikir verir. Kullanımınızın temel çizginin 5 katı mı yoksa 20 katı mı olduğu önemlidir.
Claude panosunu kontrol etmek
En kapsamlı görünüm, Ayarlar → Kullanım bölümünde, Claude.ai içinde yer alır.

Bu pano şunları birleştirir:
- Claude sohbet kullanımı
- Claude Code kullanımı
- Haftalık sıfırlama takvimleri
- Modele özgü sınırlar
Aynı anda birden fazla sınır olabileceği için bu pano gerçeğin kaynağı olarak görülmelidir. Pratik bir alışkanlık, büyük yeniden düzenleme çalışmaları, uzun hata ayıklama oturumları veya otonom kodlama görevlerine başlamadan önce kullanımı kontrol etmektir.
Claude Code Sınırlarınızdan En İyi Şekilde Yararlanma
Planları yükseltmeden kullanım sınırlarımızı nasıl genişletebileceğimizden bahsedelim. Bazen, sadece ek yükü azaltarak çok daha verimli kapasite elde edebiliriz.
CLAUDE.md dosyanızı budayın
Gönderdiğiniz bağlam miktarını ve aracıya verdiğiniz kafa karışıklığını en aza indirmek için dosya başına 200 satırın altında hedefleyin. Şunlara bakın:
- Güncelliğini yitirmiş proje talimatları
- Tarihsel notlar
- Tek tek komut istemlerine ait olması gereken kurallar
Talimatlar yalnızca belirli dizinler için geçerliyse, paths ön bilgisine sahip kapsamlı kuralları kullanın; böylece tüm kurallarınız sürekli kullanılmaz, sadece belirli yollar içinde devreye girer. Ayrıca, küresel bir dosya yerine proje düzeyinde CLAUDE.md dosyaları da kullanabilirsiniz.
MCP sunucularınızı denetleyin
Yalnızca aktif olarak kullandığınız MCP sunucularını tutun. Bağlı her sunucu, her etkileşime şema ek yükü katar. MCP yapılandırmanızı tarayıcı sekmeleri gibi düşünün. Şu anda kullanmıyorsanız kapatın.
MCP sunucularını yönetmenin iyi bir yolu, belirli projeler için yalnızca belirli MCP'lere ihtiyaç duyduğunuzu bildiğinizde onları kullanıcı düzeyi yerine proje düzeyinde kurmaktır. Bu şekilde Claude, her projede veya her oturumda değil, yalnızca belirli bir kullanım durumu için ihtiyaç duyduğunuzda onları yüklemeye çalışır.
/compact'ı erken kullanın
/compact komutu konuşma geçmişini özetler ve gelecekteki belirteç maliyetlerini azaltır. Her turda işlenen bağlam büyümesini azaltarak kota kullanımını düşürürüz.
Tüketilmiş kotayı geri getirmese de, oturum aşırı büyümeden önce /compact kullanmanız faydalı olabilir.
Modeli göreve uygun seçin
Her görev Opus veya Fable gerektirmez. Bazen daha küçük modeller veya modellerin akıllıca kullanımı kotaları yönetmeye yardımcı olabilir. Üst düzey modelleri yüksek değerli işler için saklayarak kullanılabilir kapasitenizi önemli ölçüde artırabilirsiniz.
İşte bazı model optimizasyon stratejileri:
- Mimari kararlar, karmaşık akıl yürütme ve muğlak gereksinimler için Opus
- Düzenleme, arama ve uygulama çalışmaları için Sonnet
- Hafif görevler ve hızlı okumalar için Haiku
Ancak bir oturum içinde modeli tekrar tekrar değiştirmekten kaçının. Komut istemi önbellekleri modele özeldir; bu nedenle her değişiklik, yeni modelin tüm konuşma geçmişini önbellekten ucuza okumak yerine baştan, tam belirteç maliyetiyle işlemesine neden olur. Bu, "daha ucuz" bir modele geçseniz bile, yerinizde kalsaydınızdan daha hızlı kotanızı tüketebilir.
Duvara Çarptığınızda: API Yedek Çözümü
Abonelik kota sınırları darboğaz olursa, Claude API bir alternatif sunar. API kullanımı sizi 5 saatlik oturum pencereleri veya haftalık abonelik kotalarıyla sınırlamaz. Bunun yerine, belirteç tüketimine göre ödeme yaparsınız.
Bu model genellikle şunlar için mantıklıdır:
- CI hatları
- Uzun süre çalışan otonom ajanlar
- Geniş ölçekli otomasyon
- Bütçeleri öngörülebilir üretim iş akışları
Dikkat edilmesi gereken bir nokta, ANTHROPIC_API_KEY ortam değişkenini Claude Code kabuğunuzda yapılandırılmış bırakmaktır. Bu anahtar ortamınızda varsa, Claude Code abonelik hesabınız yerine API üzerinden kimlik doğrulaması yapabilir.
Bu durum, artık abonelik sınırlarınızı kullanmak yerine belirteç maliyetlerini ödediğiniz için beklenmedik API ücretlerine yol açabilir. Maliyetler olağandışı göründüğünde, kimlik doğrulama ayarlarını kontrol etmek başlıca sorun giderme adımlarınızdan biri olmalıdır.
Güncel model fiyatlandırması için, oranlar sık değiştiğinden ve modele göre farklılık gösterdiğinden her zaman Anthropic'in resmi fiyatlandırma belgelerine bakın.
Son Düşünceler
Claude Code kullanım sınırlarını yönetmek, bunun yalnızca komut istemlerini saymaktan ibaret olmadığını anladığınızda daha kolaydır.
Sistem şunların birleşimidir:
- 5 saatlik döngüsel pencere
- Haftalık kotalar
- Modele özgü tahsisler
- Bağlam ek yükü
Birçok geliştirici için en büyük sürpriz, komut istemlerinin çoğu zaman toplam belirteç kullanımının azınlığını oluşturmasıdır. Büyük CLAUDE.md dosyaları, MCP araç tanımları, otomatik bellek, depo aramaları ve büyüyen konuşma geçmişi, çoğu zaman soruların kendisinden daha fazla kapasite tüketir.
Pratikte, olağandışı derecede hızlı şekilde sınırlara takılan çoğu kişinin kapasite değil yapılandırma sorunu vardır. Planları yükseltmeden önce, daha büyük bir kota satın almak yerine bağlamı temizleyerek ek yükü azaltın.
İş akışınızı geliştirmeye devam etmek için Claude Code en iyi uygulamalar rehberimizi ve uzun geliştirme oturumlarında Claude Code'u daha verimli ve dayanıklı hale getiren teknikleri kapsayan Claude Code Hooks öğreticimizi öneririm.
Claude Code Kullanım Sınırları SSS
Claude Code kullanım sınırları nelerdir?
Claude Code kullanım sınırları, 5 saatlik döngüsel bir oturum penceresi ve bir veya daha fazla haftalık kullanım kotasından oluşur. Hem Claude Code hem de Claude sohbet aynı abonelik kullanım havuzundan düşer.
Claude Code kullanımını nasıl kontrol ederim?
Kullanımı Claude Code içinde /usage ile, hesap ayrıntıları için /status ile veya Claude.ai'de Ayarlar → Kullanım altındaki Kullanım panosundan kontrol edebilirsiniz.
En çok hangi unsurlar Claude Code belirteçlerini tüketir?
Yaygın gizli etkenler arasında büyük CLAUDE.md dosyaları, MCP araç şemaları, otomatik bellek, konuşma geçmişi, araç çıktıları ve depo arama sonuçları bulunur.
Claude Code belirteç tüketimini nasıl azaltabilirim?
En iyi uygulamalar arasında CLAUDE.md dosyalarını özlü tutmak, kullanılmayan MCP sunucularını devre dışı bırakmak, /compact'ı proaktif kullanmak, gereksiz bellek dosyalarını kaldırmak, modeli görevin karmaşıklığıyla eşleştirmek ve depo genelinde aşırı aramalardan kaçınmak yer alır.
Agent SDK kredi sistemi kullanıma girdi mi?
Hayır. Anthropic, 15 Haziran 2026'dan itibaren programatik kullanımı etkileşimli Claude kullanımından ayırmayı planlamıştı; ancak bu değişikliği bizzat lansman gününde durdurarak "şimdilik hiçbir şey değişmiyor" dedi. Claude Agent SDK, claude -p, Claude Code GitHub Actions ve üçüncü taraf Agent SDK uygulamaları hâlen etkileşimli Claude Code ile aynı abonelik kullanım sınırlarından düşer.
Mekânsal analiz, makine öğrenimi ve veri hatları konusunda deneyime sahip bir veri bilimciyim. GCP, Hadoop, Hive, Snowflake, Airflow ve diğer veri bilimi/mühendisliği süreçleriyle çalıştım.

