# Claude API 402 Billing Error: Kullanım Limiti veya Kredi Bitti Sorunu > Bu Markdown sürümü, Hata Gider sayfasının yapay zeka ajanları ve metin tabanlı okuyucular için sadeleştirilmiş alternatif çıktısıdır. ## Kayıt Bilgileri - Kaynak Sayfa: https://hatagider.com/hata-kodlari/402-claude-api-402-billing-error-kullanim-limiti-veya-kredi-bitti-sorunu - Markdown Sürümü: https://hatagider.com/markdown/hata-kodlari/402-claude-api-402-billing-error-kullanim-limiti-veya-kredi-bitti-sorunu - Hata Kodu: 402 - Platform: Claude - Marka: Anthropic - Model: Claude API Tier 1/2/3 - Kategori: Yapay Zeka Hataları - Zorluk: Kolay - Risk Seviyesi: Orta Risk - Resmî Kontrol Durumu: Doğrulandı - Yayınlanma: 30 Haziran 2026 - Son Güncelleme: 30 Haziran 2026 - Son Doğrulama: 07 Haziran 2026 ## Kısa Özet Claude hesabının veya API organizasyonunun kullanım için gerekli kredi, bütçe ya da harcama limitine takılması durumunda görülen faturalandırma hatasıdır. API tarafında bu hata genellikle 402 billing_error, billing limit reached, usage credits exhausted, spend limit reached veya “billing or payment information” benzeri mesajlarla görünür. ## Belirtiler - **Claude Billing Limit Reached** uyarısı çıkar. - API isteği **402 billing_error** döndürür. - Claude API çalışırken bir anda durur. - Claude Code kullanım sırasında limit veya kredi uyarısı verir. - “Usage credits exhausted” benzeri mesaj alınır. - “Spend limit reached” veya “billing limit reached” görünür. - API key doğru olduğu halde istekler başarısız olur. - Pro/Max aboneliği olduğu halde API çalışmaz. - Team veya Enterprise hesabında kullanıcı limiti dolmuş olabilir. - Kredi eklenmeden istekler tekrar çalışmaz. - Ödeme yöntemi başarısız veya eksik olabilir. Bu belirtilerde ilk ayrım şudur: Sorun **Claude web abonelik limiti** mi, **Claude API usage credit** mi, yoksa **Team/Enterprise harcama limiti** mi? Çözüm buna göre değişir. ## Olası Nedenler Claude Billing Limit Reached hatasının yaygın nedenleri şunlardır: - Claude API usage credits bitmiş olabilir. - Claude Console’da ödeme yöntemi eksik veya başarısız olabilir. - Organizasyonun spend limit değeri dolmuş olabilir. - Kullanıcıya tanımlanan bireysel limit dolmuş olabilir. - Team/Enterprise planında organizasyon limiti dolmuş olabilir. - Pro/Max aboneliği olduğu halde API kredisi ayrıca satın alınmamış olabilir. - Claude Code, plan kredisi yerine API Console kredisi kullanmaya çalışıyor olabilir. - AWS Bedrock veya Marketplace üzerinden kullanılıyorsa ödeme/marketplace bağlantısı sorunludur. - Kullanım beklenenden yüksek olduğu için bütçe hızla tükenmiştir. - Eski veya farklı organizasyona ait API key kullanılıyor olabilir. Anthropic’in API ödeme yardım sayfasına göre Claude API ve Workbench kullanımı ön ödemeli **usage credits** sistemiyle faturalandırılır; API kullanımı için kredilerin önceden satın alınması gerekir. ## Çözüm ### **1. Hata kodunu doğru ayırın** Önce hatanın gerçekten billing hatası olduğundan emin olun. Kontrol edin: - Hata **402 billing_error** mı? - Yoksa **429 rate_limit_error** mı? - Hata mesajında **billing**, **payment**, **credits**, **spend limit** veya **usage limit** geçiyor mu? - API key doğru ama istek ödeme nedeniyle mi reddediliyor? - Claude web mi, Claude API mi, Claude Code mu hata veriyor? Anthropic hata dokümantasyonunda 402 billing_error ödeme/faturalandırma, 429 ise rate limit olarak ayrı tanımlanır. Bu ayrımı doğru yapmak yanlış çözüm adımlarını önler.⁠ ### **2. Claude Console’da kredi ve faturalandırma durumunu kontrol edin** API kullanıyorsanız Claude Console içinden kredi ve ödeme durumunu kontrol edin. Bakmanız gerekenler: - Usage credits kaldı mı? - Ödeme yöntemi geçerli mi? - Son ödeme başarısız mı? - Fatura veya ödeme bekliyor mu? - Harcama limiti dolmuş mu? - Doğru organizasyon seçili mi? - API key doğru organizasyona mı ait? Kredi bittiğinde yeni kredi eklenmeden API istekleri çalışmayabilir. ### **3. Usage credits satın alın veya yenileyin** Claude API, Claude web aboneliğinden ayrı faturalandırılır. Pro veya Max aboneliğiniz olsa bile API kullanımı için ayrıca Claude Console kredisi gerekebilir. Anthropic yardım sayfası, Claude paid plans ile Claude Console/API’nin ayrı ürünler olduğunu; web/desktop/mobil Claude aboneliğinin API kullanımını otomatik olarak karşılamadığını açıklar.⁠ Bu yüzden: - Claude Pro/Max aboneliğiniz varsa bile API kredinizi kontrol edin. - API kullanımı için Claude Console’da usage credits satın alın. - Kredi eklendikten sonra uygulamayı tekrar deneyin. - Gerekirse API key’in doğru organizasyondan geldiğini doğrulayın. ### **4. Spend limit değerlerini kontrol edin** Bazı hesaplarda bakiye olsa bile harcama limiti dolduğu için kullanım durur. Team, Enterprise veya self-serve yapılarda kullanıcı limiti ve organizasyon limiti ayrı olabilir. Team/Enterprise tarafında Anthropic, kullanıcı bireysel limite veya organizasyon limitine ulaşırsa kullanımın durabileceğini belirtir. Kredi kalsa bile daha düşük olan limit kullanımın önüne geçebilir.⁠ Kontrol edin: - Organizasyon spend limit doldu mu? - Kullanıcıya özel limit doldu mu? - Limit aylık mı, dönemsel mi? - Admin limit artırabiliyor mu? - Kredi var ama limit düşük mü kalmış? - Team/Enterprise Owner veya Admin erişimi gerekiyor mu? Kredi varsa ama limit dolmuşsa sadece kredi eklemek yetmeyebilir; limitin artırılması gerekir. ### **5. Claude Code kullanım kaynağını kontrol edin** Claude Code kullanırken billing limit hatası alıyorsanız Claude Code’un hangi kimlik ve ödeme kaynağını kullandığını kontrol edin. Claude Code bazen plan hakkı, bazen API/Console kredisi üzerinden çalışabilir. Kontrol edin: - Claude Code hangi hesapla login olmuş? - Pro/Max plan credentials mı kullanılıyor? - Claude Console API credentials eklendi mi? - API credits bittiği için mi uyarı çıkıyor? - Plan kullanım limiti mi doldu? - Terminalde eski credential kalmış olabilir mi? Anthropic’in Claude Code yardım içeriği, API credit seçeneğinin görünmesini istemeyen kullanıcıların `claude logout` ve tekrar `claude login` ile yalnızca Pro/Max plan kimlik bilgileriyle giriş yapabileceğini açıklar.⁠ ### **6. Pro/Max kullanım limiti ile API billing limit’i karıştırmayın** Claude web, desktop, mobil veya Claude Code interactive kullanımında görülen “usage limit” ile API tarafındaki “billing_error” aynı şey değildir. Fark şudur: - **Claude web usage limit:** Belirli süre içinde konuşma hakkınız dolmuştur; reset beklenebilir. - **Claude API billing limit:** API kredisi, ödeme veya spend limit sorunudur; kredi/limit gerekir. - **429 rate limit:** Kısa sürede fazla istek atılmıştır; hız azaltmak gerekir. - **402 billing_error:** Faturalandırma veya ödeme bilgisi sorunudur. Anthropic’in kullanım limiti yardım sayfası, kullanım limitlerinin belirli zaman aralıklarında Claude ile ne kadar etkileşim kurulabileceğini belirlediğini açıklar. Bu, API billing error’dan ayrı düşünülmelidir.⁠ ### **7. Ödeme yöntemini ve fatura bilgilerini güncelleyin** Kredi ekleyemiyor veya ödeme başarısız oluyorsa ödeme bilgilerinizi kontrol edin. Kontrol listesi: - Kart geçerli mi? - Banka ödemeyi reddetti mi? - 3D Secure veya doğrulama gerekiyor mu? - Fatura adresi doğru mu? - Vergi/VAT bilgisi gerekiyorsa girildi mi? - Kurumsal kart harcama kısıtı var mı? - AWS Marketplace kullanıyorsanız ödeme orada mı yönetiliyor? API hata dokümantasyonu, AWS üzerinden Claude Platform kullanılıyorsa billing kontrolünün AWS Marketplace tarafında yapılması gerektiğini belirtir.⁠ ### **8. Kullanım raporunu inceleyin** Kredi neden hızlı bitti anlamak için kullanım raporuna bakın. Anthropic’in Cost and Usage Reporting sayfasına göre Claude Console, API kullanım maliyetlerini ve kullanım raporlarını takip etmeye yarar. Bu raporlar Developer, Billing ve Admin rollerinde görülebilir.⁠ Kontrol edin: - Hangi model en çok maliyet oluşturuyor? - Hangi endpoint veya uygulama fazla kullanım yapıyor? - Beklenmeyen trafik var mı? - API key kötüye kullanılmış olabilir mi? - Claude Code veya otomasyon beklenenden fazla mı harcıyor? - Uzun context ve büyük output maliyeti artırıyor mu? Beklenmeyen kullanım varsa API key’i rotate etmek ve uygulama loglarını kontrol etmek gerekir. ### **9. API key’in doğru organizasyona ait olduğunu kontrol edin** Birden fazla Claude Console organizasyonu kullanıyorsanız yanlış API key farklı kredi havuzuna bağlı olabilir. Kontrol edin: - API key hangi organization altında oluşturuldu? - Kredi hangi organization’a eklendi? - Uygulama eski organization key’i mi kullanıyor? - Local ve production farklı API key mi kullanıyor? - Claude Code başka credential mı kullanıyor? - Team/Enterprise workspace karışmış olabilir mi? Kredi eklediğiniz halde hata devam ediyorsa en sık nedenlerden biri yanlış organizasyon veya eski API key kullanımıdır. ### **10. Sorun sürerse destek için net bilgi hazırlayın** Tüm kontrollerden sonra hata devam ederse Anthropic desteğe veya hesap yöneticinize net bilgiyle başvurun. Hazırlayın: - Hata kodu: **402 billing_error** veya görünen tam mesaj - Ürün: Claude API / Claude Code / Claude web / AWS Bedrock - Kullanılan organization - API key’in son 4 karakteri - Kredi durumu - Spend limit durumu - Ödeme yöntemi durumu - Hata zamanı - Model adı - Kullanım raporunda ani artış var mı? - AWS/Marketplace kullanılıyor mu? API key’in tamamını asla paylaşmayın. Yalnızca son birkaç karakterini ve hata mesajını paylaşmak yeterlidir. ## Resmî Kaynak - https://console.anthropic.com/settings/billing ## Resmî Kontrol Notu Hesap bakiyesi ve faturalandırma limitleri doğrulandı. ## Teşhis Anahtar Kelimeleri - claude ödeme hatası - billing limit reached - api bakiye ## Kullanıcı Cümleleri - claude api bakiye bitti hatası çözümü - ödeme fix ## Semptom Tarzı İfadeler - limit doldu - bakiye yok - ödeme başarısız ## Eşleşme İpuçları - bakiye yükle - limiti artır - kartı kontrol et ## Hata Gider Bağlantıları - Akıllı Teşhis: https://hatagider.com/teshis - Hata Kodu Arama: https://hatagider.com/hata-kodu-arama - Sözlük: https://hatagider.com/sozluk --- Bu içerik bilgilendirme amaçlıdır. Teknik işlem yapmadan önce cihaz, servis ve üretici uyarılarını kontrol edin.