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 ve ilk adım, hangi sistemin sizi durdurduğunu tespit etmektir. Bir Claude aboneliği (Pro, Max, Team veya koltuk bazlı Enterprise), model ailesi tavanları haricinde modeller arasında paylaşılan ve Claude sohbeti ile ortak kullanılan değişken bir kullanım kotası sunar; bu kota dolduğunda You've hit your session limit · resets 3:45pm gibi bir mesajla karşılaşırsınız. Mevcut kullanım bazlı Enterprise planları bu durumun istisnasıdır: bu planlarda dahil edilen bir kota yoktur ve tüm kullanım ilk tokendan itibaren API oranları üzerinden faturalandırılır. Claude API ise farklı bir ölçüm yapar: istek ve token gönderme hızınızı dakika bazında hesaplar. Bu durumda rate_limit_error türünde bir HTTP 429 hatası alırsınız ve genellikle kaç saniye beklemeniz gerektiğini belirten bir retry-after başlığı ile karşılaşırsınız.

Çözümlerin birbiriyle ortak bir yanı yoktur. Abonelik limiti, belirli bir zaman dilimi içinde ne kadar kullanım yaptığınızla ilgilidir; bu nedenle sıfırlanmasını beklemeniz, ek kullanım satın almanız veya planınızda sunulmuşsa ücretsiz bir limit sıfırlama hakkı kullanmanız gerekir. API hız limiti ise o anki gönderim 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 kademe sayıları sık sık değişmektedir; yanlış bir sayı bilgisi hiç bilgi olmamasından daha kötü sonuçlar doğurabileceği için burada herhangi bir sayı belirtilmemiştir. Kendi limitlerinizi aşağıda yer alan komutlarla görüntüleyebilirsiniz.

Hangi sınıra ulaştınız? Tam mesajı 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 daha uzun bir zaman dilimi için geçerli olan aynı sistemdir.
• 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. Opus ailesi dışındaki bir modele geçiş yapmak çalışmaya devam etmenizi sağlar.
• You've hit your Sonnet limit · resets 3:45pm Sonnet istekleri için geçerli olan aynı model ailesi sınırıdır. Sonnet ailesi dışındaki bir modele geçiş yapmak çalışmaya devam etmenizi sağlar.
• Fable limit reached ile başlayan bir mesaj, haftalık kotanızın Fable modellerine ayrılan kısmını tükettiğiniz anlamına gelir. Fable modelleriyle devam etmek kullanım kredilerinizi harcar, bu nedenle Claude Code önce onayınızı ister. Planınız dahilinde kalmak için /model ile başka bir model seçin.
• 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, bir Anthropic organizasyonu yerine bulut projenizin kotası üzerinden ücretlendirildiğinden, 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üresi (backoff) uygulayarak yeniden deneme yapar.

Abonelik limitleri: oturum, haftalık ve Opus penceresi

Pro, Max, Team veya koltuk tabanlı Enterprise planları, 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, kafa karışıklığının çoğuna neden olur.

• Claude sohbeti ile paylaşılır. claude.ai üzerinde yaptığınız çalışmalar, terminaldeki çalışmalarla aynı kotadan düşer; bu nedenle sohbette yoğun geçen bir öğleden sonra, kodlama yapacağınız akşam süresini kısaltır. Söz konusu 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. Cowork da aynı havuzdan beslenir ve bir Cowork görevi sonuca ulaşana kadar birçok adımı kendi başına yürüttüğünden tek bir sohbet mesajına göre kotadan çok daha fazlasını harcayabilir; Claude Cowork ile ilk görevinizi adım adım çalıştırırken bunu göz önünde bulundurun.
• Modeller arasında paylaşılır. Oturum ve haftalık limitler, her model için tek bir havuzdur. Bu havuz içindeki model ailesi tavanları istisnadır: Opus ve Sonnet limitleri ile Max ve Premium koltuklarda haftalık limitlerinizin %50'sine kadar olan Fable tahsisatı buna dahildir. Pro ve Standard koltuklarda Fable, plan limitlerine dahil değildir ve ilk istekten itibaren kullanım kredileri üzerinden faturalandırılır.

Claude for Teams ve koltuk tabanlı 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 kişi başı bir kotadır. Mevcut kullanım tabanlı Enterprise planları farklı çalışır: Tükenecek bir dahil kota yoktur, kullanım API oranları üzerinden faturalandırılır ve tavan sınırı, yöneticilerin organizasyon düzeyinde ve bireysel kullanıcılar için belirlediği harcama limitleridir. Satış destekli bir planda, harcama limiti nedeniyle durdurulan kullanım, bir sahip limiti yükseltmedikçe bir sonraki faturalandırma döneminin başında devam eder. Self-servis bir planda ise kullanım, ön ödemeli kredi bakiyesi tükendiğinde, bir sahip daha fazla kredi satın alana kadar durur. Pro ve Max planlarında, mesajda yazan sıfırlama süresi ve kendi /usage çubuklarınız güvenilir verilerdir; bir blog gönderisinden kopyalanan rakamlar değil. Hangi seviyeyi seçeceğinize henüz karar vermediyseniz, hangi Claude planına ihtiyacınız olduğu konusu, her bir planın neleri kısıtladığını karşılaştırır.

Neden /model ile model değiştirmek oturumu veya haftalık limiti sıfırlamaz

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

İstisnalar, model ailesi tavanlarıdır. Eğer mesaj You've hit your Opus limit veya You've hit your Sonnet limit içeriyorsa, doğru çözüm /model kullanmaktır. O aile dışındaki bir modele geçiş yaparak çalışmaya devam edebilirsiniz, çünkü yalnızca o ailenin istekleri engellenmiştir. Max ve Premium koltuklarındaki Fable limiti de aynı şekilde çalışır: planınız dahilinde çalışmaya devam etmek için başka bir modele geçin veya kullanım kredileriyle Fable kullanmaya devam edin. Ancak Fable, paylaşılan haftalık havuzu diğer modellerden daha hızlı tüketir; bu nedenle Fable limitinden sonra yapılan bir geçiş, sizi genel haftalık limitinizin ötesine taşımaz.

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, ücretsiz limit sıfırlama hakkınızı kullandığınızda veya kullanım kredisi satın aldığınızda geri gelir.

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

1. Sıfırlanma süresini okuyun. Oturum penceresi kısadır. Haftalık pencere ise masanızda bekleyerek geçireceğiniz bir süre değildir. Claude Code v2.1.234 veya sonraki sürümlerde, /rate-limit-options sıfırlanmayı bekleyebilir ve kesintiye uğrayan göreve otomatik olarak devam edebilir.
2. Eğer bu Opus, Sonnet veya Fable limiti ise, /model komutunu çalıştırın ve o model ailesi dışında 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 ulaşmak için kullanılan bir diğer komuttur.
4. claude.ai üzerinde veya Claude Desktop uygulamasında Ayarlar > Kullanım (Settings > Usage) yolunu izleyerek Sıfırlamalar (Resets) bölümünü kontrol edin. Uygun planlara zaman zaman ücretsiz limit sıfırlama hakkı sunulur; "Ücretsiz sıfırla" (Reset for free) butonuna tıklamak, beş saatlik oturum limitinizi veya haftalık limitinizi (teklif hangisini kapsıyorsa) anında tam kapasiteye döndürür. Bu buton terminaldeki veya IDE'deki Claude Code'da ya da Claude Mobile'da mevcut değildir ve her teklifin bir son kullanma tarihi vardır.
5. Limitin ötesinde ç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 kuruluşunuzun kullanım ayarlarını açar veya faturalandırma erişiminiz yoksa yöneticilerinize bir istek gönderir.
6. Her hafta aynı engele takılıyorsanız, mevcut plan çalışma şekliniz için yetersizdir ve kullanım limitinden çıkış yolları konusunu her sıfırlama anında değil, bir kez değerlendirmek daha mantıklıdır.

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

Kullanım kredilerinin bilinmesi gereken bir yan etkisi vardır. Varsayılan olarak Claude Code, abonelik kapsamındaki kullanımınız dahilindeyken ana konuşmanıza bir saatlik istem önbelleği (prompt cache) sağlar; kredilerinizden harcamaya başladığınızda ise bu süre beş dakikaya düşer. Bu durumda daha fazla etkileşim soğuk başlar ve Claude Code token kullanımı aynı iş için artış gösterir. Alt temsilciler (subagents) ana konuşma havuzunun dışında kaldığından, plan kullanımı dahilinde olsalar bile beş dakikalık süreye tabidirler. TTL süresini promptCacheTtl ayarı veya Claude Code v2.1.242 ve sonraki sürümlerde CLAUDE_CODE_PROMPT_CACHE_TTL ile kendiniz belirlemek, kredilerinizden harcama yaparken bile bir saatlik ömrü korumanızı sağlar.

Kullanım sınırı gibi görünen ancak öyle olmayan mesajlar

Dört Claude Code hatası kullanım sınırı olarak raporlanır ancak hiçbiri bu sınırlara dahil değildir.

• Bir bağlam (context) veya otomatik sıkıştırma (auto-compact) uyarısı, bir kullanım sınırı değildir. /context, görüşme modelin bağlam penceresini aştığında Context exceeds the 200k-token limit by 94k tokens gibi bir satır yazdırır ve ardından yer açan komutu görüntüler. Sıkıştırma işlemi, yer açmak için eski geçmişi özetler ancak bu işlem ücretsiz değildir: /compact, özetlediği görüşmeyi okur; bu nedenle büyük bir bağlamı sıkıştırmak, planınız üzerinde büyük bir istek oluşturur. Süreklilik yerine temiz bir başlangıç istediğinizde /clear hiçbir maliyet getirmez.
• Prompt is too long · automatic compaction failed: <the underlying error>, otomatik sıkıştırma işleminin belirtilen hata nedeniyle başarısız olduğu anlamına gelir. /compact, siz hatayı çözene kadar aynı hata ile başarısız olmaya devam eder.
• Credit balance is too low, Console organizasyonunuzun ön ödemeli kredilerinin bittiği veya Claude Code'un bir abonenin isteklerini bir Console API anahtarı üzerinden gönderdiği anlamına gelir; /status hangi kimlik bilgisinin aktif olduğunu gösterir. platform.claude.com/settings/billing adresinden kredi ekleyebilirsiniz; bu sayede otomatik yükleme seçeneğinden de yararlanabilirsiniz.
• API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context bir yetkilendirme kontrolüdür, tükenmiş bir kota değildir. Eğer Opus 4.6 veya Sonnet 4.6'nın [1m] varyantını seçtiyseniz, [1m] soneki olmayan varyantı seçin veya CLAUDE_CODE_DISABLE_1M_CONTEXT=1 ayarını yapın. Eğer bu hata görüşme sırasında bağlam 200K token sınırını aştığı için ortaya çıkıyorsa, Claude Code otomatik olarak standart sınırın altına sıkıştırma yapar. Sonnet 5 ve sonrası, Opus 4.7 ve sonrası, Haiku 5.5 ve Fable modelleri yerel 1M pencere ile çalışır ve kaldırılacak bir sonekleri yoktur; bu değişken onları 200K sınırında tutan şeydir.

Bir diğeri ise API'den kaynaklanır. 413 request_too_large hatası, tek bir isteğe uygulanan boyut sınırıdır, hız sınırı (rate limit) değildir.

API hız limitleri: 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 token sayısı (ITPM)
• dakika başına çıktı token sayısı (OTPM)

Kuruluşunuzun ayrıca API kullanımı için aylık maksimum maliyeti belirleyen ve bunlardan farklı olan bir harcama limiti bulunur. 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 duraklatılır. Bu durum da bir 429 rate_limit_error hatası olarak döner ancak herhangi bir retry-after başlığı içermez ve error.details.error_code içinde enforced_spend_limit_reached değerini taşır. Hiçbir yeniden deneme döngüsü bu sorunu çözmez. Console üzerinden kendinizin belirlediği daha düşük bir harcama limiti ise farklı bir şekilde görünür: istekler, You have reached your specified API usage limits ile başlayan bir mesajla birlikte HTTP 400 invalid_request_error hatası döndürür ve limiti yükseltmek veya kaldırmak erişimi yeniden sağlar.

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

• Limitler model sınıfı bazındadır. Her model için ayrı ayrı uygulanırlar, bu sayede farklı modelleri aynı anda kendi limitlerine kadar kullanabilirsiniz. Bazı aileler aynı havuzu paylaşır: Opus hız limiti, Claude Opus 4.8, Opus 4.7, Opus 4.6 ve Opus 4.5 genelindeki toplamı ifade ederken, Claude Sonnet 5 kendi limitine sahiptir.
• Kapasite sürekli olarak 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 limiti, 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 limitine yalnızca önbelleğe alınmamış girdiler dahil edilir. input_tokens ve cache_creation_input_tokens sayılır. Çoğu Claude modelinde cache_read_input_tokens sayılmaz; Claude Haiku 3.5 bu konuda belgelenmiş istisnadır. Dolayısıyla önbelleğe alma, indirim sağlamanın yanı sıra hız limiti için de alan açar. Çıktı tarafında ise yüksek bir max_tokens, OTPM limitinden düşülmez çünkü OTPM yalnızca fiilen üretilen tokenları sayar.
• Limitler 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çerliliğini korur. Bir çalışma alanında geçersiz kılmadığınız bir limit, sınırsız bırakılmaz; kuruluştan 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 ve kullanım geçmişi az olanlar, yayınlanan standart limitlerin altında olan Evaluation katmanında başlayabilir; bu nedenle ilk 429 hatası tahmin edilen tablodan daha erken gelebilir. Kullanımdaki ani artışlar, katmanınızın içindeyken bile 429 hatası döndüren hızlanma limitlerini tetikler, 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 Rate limits sayfasında bulunan "Request tier increase" seçeneğini kullanın.

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

Her API hatası aynı zarf yapısını döndürür: türü ve mesajı taşıyan iç içe geçmiş bir error nesnesi ve buna ek olarak en üst seviyede 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 yer alı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. Her 429 hatası bu başlığı içermez; harcama limiti (spend-cap) kaynaklı 429 hatalarında bu başlık hiçbir zaman bulunmaz.
• 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 (remaining) ve sıfırlama (reset) sonekleriyle ITPM ve OTPM için aynı işlevi görür.
• anthropic-ratelimit-tokens-*, o an geçerli 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 değerlendirin. Hızlı modun (fast mode) kendi havuzu ve kendi anthropic-fast-* başlıkları vardır. Bunların tümünü 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 değer, hata gövdelerinde request_id olarak, Python ve TypeScript SDK yanıtlarında ise _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 limitleri ve 5xx sunucu hataları dahil olmak üzere geçici hataları, üstel backoff (exponential backoff) yöntemiyle varsayılan olarak iki kez otomatik olarak yeniden dener ve mevcut olduğunda retry-after başlığını dikkate alır. 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

Abonelik kapsamında, önemli olan ekran /usage ekranıdır. Bu ekran, plan kullanım çubuklarınızı ve bu çubukları nelerin tükettiğine dair dökümü gösterir; d veya w seçenekleri ise son 24 saat ile son 7 gün arasında geçiş yapmanızı sağlar. İki hususa dikkat edilmelidir. 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ım bu verilere dahil değildir.

API tarafında, Claude Console içerisindeki 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 Admin API kimlik bilgileri gerektirir: bir Admin API anahtarı, org:admin kapsamına sahip bir OAuth token'ı veya bir çalışma alanıyla (workspace) sınırlandırılmamış kişisel ya da servis hesabı anahtarı. Çalışma alanı API anahtarları bu işlemde çalışmaz. GET /v1/organizations/workspaces/{workspace_id}/rate_limits komutu, çalışma alanı bazında aynı işlemi gerçekleştirir. Her iki yöntem de salt okunurdur: bir limiti değiştirmek için Console üzerindeki Rate limits sayfasını kullanın.

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

Her iki sistem de arka planda aynı şeyi ölçümlediğinden, 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 /clear ile alakasız görevler arasında geçiş yapmak hiçbir maliyet getirmez. Claude Code token kullanımı bu yöntemleri kapsamlı bir şekilde ele alır.
• Çabayı azaltı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 çalıştırır; böylece gece çalışan bir iş, oturumunuzla kaynak rekabetine girmez.

Veriyi bağlama (context) döken 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önlendirilen ani yoğunluklu işler, en başından itibaren bir API anahtarı üzerinde yürütülmelidir. Oraya geçiş yapmak, ödeme şeklinizi ve ölçümlenme biçiminizi değiştirir; çünkü Claude API'nin ücretsiz bir katmanı yoktur. Max ve Team planları, bir Console organizasyonunu bağladığınızda kendi uygulamalarınızı ve ajanlarınızı çalıştırmanız için aylık API kredileri içerir. Bu krediler Claude Code'u kapsamaz ve planınızın kullanım limitlerini değiştirmez. VPS üzerinde ilk Claude API uygulamanız anahtar yönetimi ve yeniden deneme işlemlerini kapsar; ayrıca Claude Code'u tmux içinde bir VPS üzerinde çalışır durumda tuttuğunuzda, uzun süreli bir ajan çalışması bağlantı kopsa dahi devam eder.

FAQ

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

Çünkü oturum ve haftalık limitler tüm modeller arasında paylaşılır. Bu kullanım hakkı modele değil plana aittir; dolayısıyla /model hangi modelin yanıt vereceğini değiştirir, kalan kullanım hakkı miktarını değil. İstisnalar model ailesi limitleridir: You've hit your Opus limit ve You've hit your Sonnet limit yalnızca ilgili aile için geçerlidir; Max ve Premium koltuklarındaki Fable limiti ise sadece Fable'ı kısıtlar. Bu durumlarda model değiştirmek, belgelenmiş çözüm yöntemidir.

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 genellikle beklenecek saniye sayısını içeren bir retry-after başlığı taşır ve bu süreden önce yapılan yeniden denemeler başarısız olur. Resmi SDK'lar, hız limitlerini ve 5xx hatalarını üstel geri çekilme (exponential backoff) yöntemiyle varsayılan olarak iki kez yeniden dener ve ilgili başlık mevcut olduğunda bu başlığa uyar. Kendi plan limitleriniz dahilindeyken alınan bir 429 hatası, ani artıştan kaynaklanan bir hızlanma limitine işaret eder. error.details.error_code içinde enforced_spend_limit_reached içeren ve hiçbir zaman retry-after başlığı taşımayan bir 429 hatası ise aylık harcama sınırıdır; beklemek bu durumu düzeltmez.

Claude kullanım limitlerimi ve sıfırlanma zamanları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ş yapar. 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, Admin API anahtarı gibi Admin API kimlik bilgileriyle 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 üst sınırı aşan kullanım satın almak veya Team ve Enterprise planlarında yöneticiden talep etmek için /usage-credits komutunu çalıştırın; bu işlem /login üzerinden claude.ai girişi gerektirir ve API anahtarı kimlik doğrulaması ile kullanılamaz. Aksi takdirde sıfırlanma zamanını bekleyin, claude.ai veya Claude Desktop üzerindeki Ayarlar > Kullanım menüsünde sunuluyorsa ücretsiz limit sıfırlama hakkını kullanın, Opus, Sonnet veya Fable limiti söz konusuysa model değiştirin ya da çalışmanızı pencere bazlı değil dakika bazlı ücretlendirilen bir API anahtarına taşıyın.