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.