Claude kullanım limitleri nasıl aşılır ve çözülür?

Claude kullanım limitleri nelerdir?

Claude kullanım limitleri iki ayrı sistemden oluşur; ilk adım, sizi hangisinin durdurduğunu belirlemektir. Bir Claude aboneliği (Pro, Max, Team veya Enterprise), modeller arasında paylaşılan ve Claude sohbeti ile ortak kullanılan değişken bir kullanım kotası sağlar; bu limit aşıldığında You've hit your session limit · resets 3:45pm gibi bir mesajla karşılaşırsınız. Claude API ise farklı bir ölçüm yapar: isteklerinizi ve token'ları dakikada kaç adet gönderdiğinize bakar. Bu limit aşıldığında rate_limit_error türünde bir HTTP 429 hatası ve kaç saniye beklemeniz gerektiğini belirten bir retry-after başlığı döner.

Çözümlerin birbiriyle ilgisi yoktur. Abonelik limiti, belirli bir zaman diliminde ne kadar kullanım yaptığınızla ilgilidir; bu yüzden sıfırlanmasını beklemeniz veya ek kullanım hakkı satın almanız gerekir. API hız limiti ise anlık hızınızla ilgilidir ve hızınızı düşürdüğünüzde saniyeler içinde kendiliğinden düzelir.

Plan kotaları ve hız limiti kademeleri sıkça değiştiği için, yanlış bir sayı vermemek adına burada herhangi bir rakam belirtilmemiştir. Kendi limitlerinizi aşağıda yer alan komutlarla görüntüleyebilirsiniz.

Hangi sınıra ulaştınız? Tam hata mesajını okuyun

Claude Code, yazdırdığı metinde sistemin adını belirtir. Herhangi bir değişiklik yapmadan önce kendi sisteminizle eşleştirin.

• You've hit your session limit · resets 3:45pm bir abonelik sınırıdır. Planınızın bu dönem için tanımlanan kullanım kotası dolmuştur.
• You've hit your weekly limit · resets Mon 12:00am aynı sistemin daha uzun süreli dönem için geçerli olan sınırıdır.
• You've hit your Opus limit · resets 3:45pm yalnızca Opus istekleri için geçerli olan bir abonelik sınırıdır. Model değiştirmenin işe yaradığı tek durum budur.
• API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com. bir API hız sınırıdır (rate limit). API anahtarınız veya Amazon Bedrock ya da Google Cloud projeniz için yapılandırılmış sınıra ulaştınız. Bedrock veya Vertex istemcisi, Anthropic organizasyonunuz yerine bulut projenizin kotası üzerinden ücretlendirildiği için hangisinin geçerli olduğu istemcinin nasıl kimlik doğruladığına bağlıdır.
• API Error: Server is temporarily limiting requests (not your usage limit) plan kotanızla ilgisi olmayan kısa süreli bir kısıtlamadır. Claude Code, bu satırı size göstermeden önce otomatik olarak bekleme süresiyle (backoff) yeniden deneme yapar.

Abonelik limitleri: oturum, haftalık ve Opus penceresi

Bir abonelik planı, değişken bir kullanım kotası içerir. Bu kota tükendiğinde Claude Code, mesajda belirtilen sıfırlama zamanına kadar yeni istekleri engeller. Bu kotanın iki özelliği, kullanıcılar arasında en çok kafa karışıklığına yol açan konudur.

• Claude sohbeti ile ortak kullanılır. claude.ai üzerinde yaptığınız çalışmalar, terminaldeki çalışmalarla aynı kotadan düşer; bu nedenle sohbette geçirdiğiniz yoğun bir öğleden sonra, kodlama yapacağınız akşam süresini kısaltır. Aynı hesapla giriş yaptığınız her platform aynı havuzdan harcama yapar; dolayısıyla Linux üzerinde beta masaüstü uygulaması ve Claude Code CLI her biri için ayrı ayrı değil, tek bir ortak kotayı tüketir.
• Modeller arasında ortak kullanılır. Oturum ve haftalık limitlerin, Opus limiti haricinde modele özel bir bütçesi yoktur.

Claude for Teams ve Enterprise planlarında tanımlanan yapı, beş saatlik değişken bir pencerede ve haftalık pencerede sıfırlanan, Claude sohbeti ve Cowork ile paylaşılan ve koltuk seviyesine (Standard veya Premium) göre boyutlandırılan bir kullanıcı kotasıdır. Pro ve Max planlarında, mesajda yazan sıfırlama süresi ve kendi /usage çubuklarınız güvenilir verilerdir; blog yazılarından kopyalanan rakamlar esas alınmamalıdır. Hangi seviyeyi seçeceğinize henüz karar vermediyseniz, hangi Claude planına ihtiyacınız olduğu sayfası, her bir planın neleri kısıtladığını karşılaştırmalı olarak gösterir.

Neden /model ile model değiştirmek erişimi geri getirmez

Bu en yaygın hatalı işlemdir ve dokümantasyon bu konuda oldukça nettir: oturum ve haftalık limitler tüm modeller arasında paylaşıldığı için model değiştirmek erişimi geri getirmez. Oturum süreniz dolduktan sonra daha küçük bir model seçmek, yanıtı hangi modelin vereceğini değiştirir. Ancak kalan kullanım hakkını değiştirmez; çünkü kullanım hakkı hiçbir zaman modele özel tutulmamıştır, dolayısıyla yapılan değişikliğin serbest bırakacağı bir kaynak yoktur.

Bunun istisnası, gerçekten modele özel bir tavan olan Opus limitidir. Eğer mesaj You've hit your Opus limit şeklinde görünüyorsa, doğru çözüm /model uygulamaktır. Başka bir modele geçiş yapın ve çalışmaya devam edin; çünkü yalnızca Opus istekleri engellenmiştir.

Limiti bir hata (bug) olarak değerlendirmek ikinci hatalı yaklaşımdır. Yeniden yükleme yapmak veya kimlik doğrulamasını tazelemek hiçbir şeyi değiştirmez. Kullanım hakkı, süre dolduğunda sıfırlandığında veya kullanım kredisi satın aldığınızda geri gelir.

Abonelik limitine ulaşıldığında ne yapılmalı

1. Sıfırlanma zamanını okuyun. Bir oturum penceresi kısadır. Haftalık bir pencere, masanızda bekleyebileceğiniz bir süre değildir.
2. Eğer bu Opus limiti ise, /model komutunu çalıştırın ve başka bir model seçin.
3. Plan limitlerinizi, kullanım çubuklarınızı ve bunların ne zaman sıfırlanacağını görmek için /usage komutunu çalıştırın. /cost aynı ekrana giden bir kısayoldur.
4. Limit tavanını aşarak çalışmaya devam etmek için /usage-credits komutunu çalıştırın. Pro ve Max planlarında bu komut faturalandırma ayarlarınızı açar. Team ve Enterprise planlarında ise organizasyonunuzun kullanım ayarlarını açar veya faturalandırma erişiminiz yoksa yöneticilerinize bir talep gönderir.
5. Her hafta aynı engele takılıyorsanız, mevcut plan çalışma şekliniz için uygun değildir ve kullanım limitinden çıkış yolları konusunu her sıfırlanma anında değil, bir kez değerlendirmeye almak daha mantıklıdır.

/usage-credits, /login üzerinden giriş yapılmış bir claude.ai aboneliği gerektirir. API anahtarı kimlik doğrulaması ile kullanılamaz, çünkü bir API anahtarının genişletilebilecek bir plan kotası yoktur.

Kullanım kredilerinin, önceden bilinmesi gereken bir yan etkisi vardır. İstemi önbelleği (prompt cache) ömrü aboneliklerde bir saattir; ancak kredileri kullanmaya başladığınızda bu süre beş dakikaya düşer. Bu durum, daha fazla etkileşimin soğuk başlamasına ve aynı iş için Claude Code token kullanımı miktarının artmasına neden olur.

The messages that look like usage limits and are not

Four Claude Code errors get reported as usage limits and are none of them.

• A context or auto-compact warning is not a usage limit. /context prints a line such as Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue. once the conversation has grown past the model's context window. Older history is summarized to free space, and your plan allowance is untouched.
• Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again. means /compact itself failed, because there is not enough free context left to hold the summary it would produce.
• Credit balance is too low means your Console organization has run out of prepaid credits. Add credits at platform.claude.com/settings/billing, which also offers auto-reload.
• API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context is an entitlement check, not an exhausted quota. Pick the model variant without the [1m] suffix, or set CLAUDE_CODE_DISABLE_1M_CONTEXT=1.

One more comes from the API. A 413 request_too_large is a size limit on a single request, not a rate limit.

API hız sınırları: 429 hatasının gerçekte neyi saydığı

Messages API, her model sınıfı için ayrı ayrı olmak üzere üç şeyi ölçer.

• dakika başına istek sayısı (RPM)
• dakika başına girdi belirteci (ITPM)
• dakika başına çıktı belirteci (OTPM)

Kuruluşunuzun ayrıca harcama limiti vardır; bu farklı bir konudur ve API kullanımı için aylık maksimum maliyeti ifade eder. Katmanınızın harcama sınırına ulaştığınızda, daha yüksek bir limit talep etmediğiniz sürece API kullanımı bir sonraki aya kadar durur. Hiçbir yeniden deneme döngüsü bunu çözemez.

429 hatasının ne zaman döneceğine dört mekanizma karar verir.

• Sınırlar model sınıfı bazındadır. Sınırlar her modele ayrı ayrı uygulanır, bu nedenle farklı modelleri aynı anda kendi sınırlarına kadar kullanabilirsiniz. Bazı aileler aynı havuzu paylaşır: Opus hız sınırı; Claude Opus 4.8, Opus 4.7, Opus 4.6 ve Opus 4.5 genelinde toplam bir sınırdır, Claude Sonnet 5 ise kendi sınırına sahiptir.
• Kapasite sürekli yenilenir. API, token bucket algoritmasını kullanır; bu nedenle kapasite sabit bir anda sıfırlanmak yerine sürekli olarak dolar. Dakikada 60 istek sınırı, saniyede bir istek olarak uygulanabilir; bu yüzden aynı anda gönderilen 60 istek yine de başarısız olur.
• Çoğu modelde ITPM hesabına yalnızca önbelleğe alınmamış girdiler dahil edilir. input_tokens ve cache_creation_input_tokens sayılır. cache_read_input_tokens, Claude Haiku 3.5 istisnası dışında çoğu Claude modelinde sayılmaz. Bu nedenle önbelleğe alma, indirim sağlamanın yanı sıra hız sınırı kapasitesi de kazandırır. Çıktı tarafında ise yüksek bir max_tokens, OTPM sınırından düşülmez; çünkü OTPM yalnızca fiilen üretilen belirteçleri sayar.
• Sınırlar kuruluş düzeyinde geçerlidir. Bir çalışma alanına daha düşük bir limit atanabilir ve çalışma alanı limitlerinin toplamı daha yüksek olsa bile kuruluş genelindeki limitler her zaman geçerlidir. Bir çalışma alanında geçersiz kılmadığınız bir limit, sınırsız bırakılmaz; kuruluş seviyesinden devralınır.

Start, Build, Scale ve Custom olarak adlandırılan katmanlar, kullanım geçmişinize ve hesap durumunuza göre otomatik olarak atanan gerçek sayıları belirler. Yeni kuruluşlar standart yayınlanan limitlerin altında başlayabilir, bu nedenle ilk 429 hatası tablolarda öngörülenden daha erken gelebilir. Kullanımdaki ani artışlar hızlanma sınırlarını tetikler; bu durum siz hala katmanınızın içindeyken 429 hatası döndürebilir, bu yüzden trafiği kademeli olarak artırın. Yayınlanan her rakam bir tavan değerdir: belgelenen limitler izin verilen maksimum kullanımı ifade eder, garanti edilen minimumları değil. Daha fazlasını talep etmek için Claude Console üzerindeki Limits sayfasında bulunan "Request rate limit increase" kontrolünü kullanın.

429 hatasını okuma: retry-after, başlıklar ve SDK yeniden denemeleri

Her API hatası aynı zarfı döndürür: türü ve mesajı taşıyan iç içe geçmiş bir error nesnesi ve üst düzey bir request_id.

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "<names the rate limit you exceeded>"
  },
  "request_id": "req_011CSHoEeqs5C35K2UUqR7Fy"
}

Geri kalan bilgiler başlıklarda taşınır.

• retry-after, isteği yeniden denemeden önce beklemeniz gereken saniye sayısıdır. Daha erken yapılan denemeler başarısız olur.
• anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining ve anthropic-ratelimit-requests-reset istek bütçenizi tanımlar.
• anthropic-ratelimit-input-tokens-* ve anthropic-ratelimit-output-tokens-*, aynı limit, kalan ve sıfırlama sonekleriyle ITPM ve OTPM için aynı işlevi görür.
• anthropic-ratelimit-tokens-*, şu anda yürürlükte olan en kısıtlayıcı limitin değerlerini görüntüler.

Sıfırlama başlıkları RFC 3339 zaman damgalarıdır. Kalan token başlıkları en yakın bine yuvarlanır, bu nedenle bunları bir gösterge olarak okuyun. Hızlı modun kendi havuzu ve kendi anthropic-fast-* başlıkları vardır. Bunların hepsini başarılı olan herhangi bir çağrıdan okuyun:

curl -s -D - -o /dev/null https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}' \
  | grep -i 'ratelimit\|retry-after\|request-id'

Her yanıt ayrıca req_018EeWyXxfu5pfWkrYcMdjWG gibi benzersiz bir request-id başlığı taşır. Bu, hata gövdelerinde request_id olarak ve Python ile TypeScript SDK yanıtlarında _request_id olarak görünür. Destek ekibiyle iletişime geçtiğinizde bu değeri belirtin.

Bir backoff döngüsü yazmadan önce buna gerçekten ihtiyacınız olup olmadığını kontrol edin. Resmi SDK'lar; bağlantı hataları, hız sınırları ve 5xx sunucu hataları dahil olmak üzere geçici hataları, üstel backoff (exponential backoff) ile otomatik olarak yeniden dener. Varsayılan olarak iki kez deneme yapılır ve retry-after başlığı mevcut olduğunda bu başlığa uyulur. Her istemci, bu davranışı değiştirmek veya devre dışı bırakmak için bir maximum-retries seçeneğini kabul eder.

import anthropic

client = anthropic.Anthropic(max_retries=5)  # the SDK default is 2

try:
    msg = client.messages.create(
        model="claude-sonnet-5",
        max_tokens=1024,
        messages=[{"role": "user", "content": "hello"}],
    )
except anthropic.RateLimitError as err:
    headers = err.response.headers
    print("still limited after retries; wait", headers.get("retry-after"), "seconds")
    print("request id:", headers.get("request-id"))

529 overloaded_error sizin hatanız değildir

429 kodu, çok hızlı istek gönderdiğinizi belirtir. 529 overloaded_error kodu ise API'nin geçici olarak aşırı yüklendiğini gösterir ve API tüm kullanıcılar genelinde yoğun trafik yaşadığında ortaya çıkabilir. Anahtarınız veya kodunuzla ilgili herhangi bir durum buna neden olmaz. SDK'lar 5xx yanıtları için halihazırda uyguladığı üstel geri çekilme (exponential backoff) yöntemiyle yeniden deneyin ve sorun düzelmezse status.claude.com adresini kontrol edin. 500 api_error kodu, aynı şekilde yeniden denemeniz gereken bir iç hatadır; her iki durum da bir hız sınırı (rate limit) değildir.

Tablo yerine kendi limitlerinizi okuyun

Aboneliklerde, önemli olan ekran /usage ekranıdır. Bu ekran, plan kullanım çubuklarınızı ve bunları nelerin tükettiğine dair dökümü gösterir; d veya w ise son 24 saat ile son 7 gün arasında geçiş yapmanızı sağlar. İki önemli nokta bulunmaktadır. Session bloğu API anahtarı kullanımını gösterir ve API kullanıcıları içindir; bu nedenle aboneler buradaki dolar tutarını dikkate almayabilir. Sayılar, o makinedeki yerel oturum geçmişinden gelir; dolayısıyla başka bir cihazdan veya claude.ai üzerinden yapılan kullanımlar burada görünmez.

API tarafında, Claude Console içindeki Usage sayfası "Rate Limit - Input Tokens" ve "Rate Limit - Output Tokens" olmak üzere iki grafik çizer. Giriş grafiği, önbelleğe alınmamış giriş token'larının saatlik maksimum değerini mevcut ITPM limitinize göre çizer ve yanına önbellek oranınızı ekler; böylece üretim ortamında bir limite çarpmak yerine, limite yaklaşma sürecini izleyebilirsiniz.

Yapılandırılmış limitlerinizi programatik olarak okumak için:

curl -s https://api.anthropic.com/v1/organizations/rate_limits \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

Bu işlem bir Admin API anahtarı gerektirir ve GET /v1/organizations/workspaces/{workspace_id}/rate_limits aynı işlemi çalışma alanı bazında gerçekleştirir. Her ikisi de salt okunurdur: bir limiti değiştirmek için Console içindeki Limits sekmesini kullanın.

Daha az limit ile karşılaşmak için less kullanımı

Her iki sistem de arka planda aynı şeyi ölçümler, bu nedenle bu yöntemler her ikisinde de işe yarar.

• Her turda daha az token harcayın. Sürekli devam eden işlemler önbelleği sıcak tutar ve ilgisiz görevler arasındaki /clear hiçbir maliyet getirmez. Claude Code token kullanımı bu yöntemleri tüm detaylarıyla ele alır.
• Eforu düşürün. Seviyeler low, medium, high, xhigh ve max şeklindedir. /effort menüsü ayrıca harcamayı düşürmek yerine artıran ultracode seçeneğini de sunar. Mekanik bir yeniden adlandırma işlemi üzerinde derinlemesine düşünmek bir kazanç sağlamaz.
• 429 hatasından sonra eşzamanlılığı kesin. CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY değerini düşürün ve çok sayıda paralel alt aracı çalıştırmaktan kaçının. Ayrıca /status komutunu çalıştırın: başıboş bir ANTHROPIC_API_KEY, istekleri aboneliğiniz yerine düşük seviyeli bir anahtar üzerinden yönlendirir.
• Etkileşimli olmayan işleri Message Batches API'ye taşıyın. Bu API, büyük hacimli verileri asenkron olarak, giriş ve çıkış tokenlarında %50 indirimle ve kendi hız limitleri dahilinde işler; böylece gece çalışan bir görev, oturumunuzla kaynak rekabetine girmez.

Bağlama yoğun veri aktaran işler bu durumdan en çok etkilenenlerdir: Eğer canlı piyasa verilerine karşı hisse senedi ve opsiyon analizi yapıyorsanız, her sorunun ihtiyaç duyduğu dar dilimi çekmek, tüm fiyat tablolarını ve zincirlerini yapıştırmaktan çok daha düşük maliyetlidir. Bir kişi yerine bir program tarafından yürütülen ani ve yoğun işler, en başından itibaren bir API anahtarı üzerinde çalışmalıdır. Oraya geçiş yapmak, ödeme şeklinizi ve ölçümlenme biçiminizi değiştirir; çünkü Claude API'nin kayıt sırasında verilen küçük kredi dışında ücretsiz bir katmanı yoktur. VPS üzerinde ilk Claude API uygulamanız anahtar yönetimi ve yeniden deneme işlemlerini kapsar; ayrıca Claude Code'u bir VPS içinde tmux ile çalıştırmaya devam ettiğinizde, uzun süreli bir aracı çalışması bağlantı kopsa bile devam eder.

FAQ

Model değiştirmek neden Claude kullanım limitimi düzeltmiyor?

Çünkü oturum ve haftalık limitler tüm modeller arasında paylaşılır. Kullanım hakkı modele değil plana aittir; bu nedenle /model, hangi modelin yanıt vereceğini değiştirir, kalan kullanım hakkını değil. Bunun tek istisnası, yalnızca Opus istekleri için geçerli olan You've hit your Opus limit durumudur. Bu durumda model değiştirmek, belgelenmiş çözüm yoludur.

429 rate_limit_error ne anlama gelir ve ne kadar beklemeliyim?

Bu hata, hesabınızın ilgili model sınıfı için bir hız limitine ulaştığını gösterir: dakika başına istek sayısı, dakika başına girdi token sayısı veya dakika başına çıktı token sayısı. Yanıt, beklemeniz gereken saniye süresini içeren bir retry-after başlığı taşır; daha erken yapılan denemeler başarısız olur. Resmi SDK'lar, hız limitlerini ve 5xx hatalarını, varsayılan olarak iki kez ve ilgili başlığa uyarak, üstel geri çekilme (exponential backoff) yöntemiyle zaten yeniden dener. Planınızın limitleri dahilindeyken gelen bir 429 hatası, ani bir artıştan kaynaklanan bir hızlanma limitine işaret eder.

Claude kullanım limitlerimi ve ne zaman sıfırlanacaklarını nasıl görebilirim?

Claude Code içerisinde, plan çubuklarınız, sıfırlanma zamanları ve kullanım dökümü için /usage komutunu çalıştırın; /cost bunun bir kısayoludur ve d veya w komutları son 24 saat ile son 7 gün arasında geçiş yapmanızı sağlar. Bu veriler yerel oturum geçmişinden geldiği için diğer cihazlardan ve claude.ai üzerinden yapılan kullanımları içermez. API tarafında ise Console, hız limitlerinizi grafik olarak gösterir ve GET /v1/organizations/rate_limits, bir Admin API anahtarı ile yapılandırılmış limitlerinizi döndürür.

Claude plan limitime ulaştıktan sonra çalışmaya devam edebilir miyim?

Bazen. Pro ve Max planlarında limitin üzerinde kullanım satın almak veya Team ve Enterprise planlarında bir yöneticiden talep etmek için /usage-credits komutunu çalıştırın; bu işlem /login üzerinden bir claude.ai girişi gerektirir ve API anahtarı kimlik doğrulaması ile kullanılamaz. Aksi takdirde sıfırlanma zamanını bekleyin, eğer limit Opus limitiyse model değiştirin veya çalışmanızı, pencere bazlı değil dakika bazlı ölçüm yapan bir API anahtarına taşıyın.