Kembali ke panduan
Pemecahan masalah·17 September 2026·Diperbarui 24 September 2026·Baca 7 menit

Claude Code: batas tercapai, diagnosis, dan solusi

Identifikasi akun dan batas yang bermasalah sebelum menunggu, mengisi saldo, atau mengubah konfigurasi.

Ketika Claude Code menampilkan « batas tercapai », mulailah dengan mengidentifikasi batasnya: langganan, laju API, batas pengeluaran, atau masalah akun. Solusi yang tepat mungkin berupa menunggu reset, mengaktifkan kredit resmi, mengurangi pemanggilan bersamaan, atau memperbaiki kunci. Membeli paket lain sebelum diagnosis ini berisiko membiarkan masalah tetap ada.

Pesan apa yang Anda lihat?

GejalaPemeriksaanTindakan yang sesuai
Kuota paket tercapai, waktu melanjutkan ditampilkanAkun Claude dan halaman penggunaanTunggu, bandingkan paket lain atau kredit penggunaan
API 429 dengan indikasi lajuPesan, permintaan bersamaan, dan header waktu melanjutkanPerlambat dan patuhi waktu tunggu yang disampaikan
Batas pengeluaran atau pembayaran ditolakSaldo, batas akun, dan penagihanPerbaiki batas atau pembayaran terkait
API 401 atau 403Kunci, domain tujuan, dan hak aksesPerbaiki identifikasi atau otorisasi
Percakapan terlalu panjangUkuran konteks dan pesan persisRingkas pekerjaan dan kurangi konteks yang berguna

Kode di bawah menjelaskan API Anthropic. Jika Claude Code melalui provider lain, lihat juga dokumentasinya: perantara dapat menampilkan pesan dan batasnya sendiri.

1. Jika Anda menggunakan langganan Claude

Buka pengaturan penggunaan akun yang terhubung. Catat kuota terkait dan waktu yang ditampilkan, bukan menyimpulkan durasi universal dari pesan yang ditemukan di tempat lain. Pastikan juga Claude Code menggunakan akun yang diharapkan.

Anthropic membedakan batas penggunaan dan panjang. Penggunaan Claude dan Claude Code dapat berbagi alokasi akun yang sama. Karena itu, membuka jendela atau percakapan baru tidak membuat kuota tambahan. Namun, meringankan konteks yang sudah besar dapat mengurangi pekerjaan yang diminta dari model pada pemanggilan berikutnya.

Untuk melanjutkan setelah alokasi yang disertakan habis, paket pribadi yang memenuhi syarat memiliki kredit penggunaan resmi. Kredit tersebut ditagih secara terpisah dengan tarif API standar. Dalam pengaturan penggunaan, periksa aktivasi, dana yang tersedia, dan batas pengeluaran. Bandingkan opsi ini dengan menunggu, mengubah paket, atau menggunakan akun API terpisah.

2. Jika API mengembalikan 429

Periksa teks kesalahan dan batas API. Untuk batas laju, kurangi tugas bersamaan dan patuhi waktu tunggu retry-after jika ada. Segera menjalankan ulang beberapa agen dapat mempertahankan pemblokiran yang sama.

429 juga dapat menunjukkan batas bulanan tingkat API atau batas pengeluaran tertentu pada ruang Claude Code. Batas bulanan mungkin tidak menyediakan waktu untuk melanjutkan. Dalam hal itu, periksa penagihan dan batas terkait akun; pengulangan percobaan tidak akan meningkatkannya. Ketiadaan header saja tidak cukup untuk menyimpulkan: baca juga pesannya.

3. Jika masalah berkaitan dengan saldo atau autentikasi

Referensi kesalahan Anthropic membedakan antara lain 401 untuk autentikasi, 403 untuk hak akses, dan 402 untuk penagihan. Beberapa batas pengeluaran juga dapat muncul sebagai kode 400. Karena itu, kode HTTP saja tidak menggantikan detail kesalahan.

Periksa domain tujuan pengiriman permintaan dan akun yang membuat kunci. Langganan Claude, saldo Console, dan saldo provider pihak ketiga tidak dapat dipertukarkan. Pengisian saldo pada satu provider tidak otomatis membiayai provider lain. Setelah memperbaiki masalah, gunakan permintaan kecil untuk memastikan akun yang ditagih sebelum melanjutkan tugas penting.

4. Melanjutkan dengan penagihan API terpisah

Dokumentasi gateway menjelaskan bahwa pengenal gateway aktif menggantikan identitas langganan untuk sesi tersebut. Hanya menetapkan alamat dasar tidak melakukan perubahan ini: koneksi yang terdaftar dapat tetap aktif. Karena itu, konfigurasikan alamat, pengenal, dan model yang diharapkan secara bersamaan.

Panduan harga dan konfigurasi Claude Code menjelaskan cara menggunakan Kunavo dalam bahasa Prancis. Katalog saat ini menampilkan Claude Sonnet 4.6 dengan harga $2,10 untuk input dan $10,50 untuk output per satu juta token. Panduan harga API Claude menjelaskan secara terperinci satuan yang perlu dibandingkan. Satu tugas dapat mencakup beberapa panggilan; biayanya juga bergantung pada konteks, cache, dan percobaan ulang.

Jika pemisahan ini sesuai untuk Anda, buat akun Kunavo, konfigurasikan kunci, lalu periksa pemanggilan pertama di riwayat penggunaan Anda. Akun ini memiliki batasnya sendiri; akun ini tidak mengubah Claude Code menjadi layanan tanpa batas.

Menyiapkan permintaan bantuan yang berguna

Jika pemblokiran berlanjut, simpan informasi berikut. Informasi tersebut membantu membedakan masalah konfigurasi dari batas yang diterapkan pada akun yang benar, tanpa memublikasikan kunci rahasia Anda:

Informasi berguna untuk diagnosis — tanpa kunci rahasia
Interface et version de Claude Code :
Compte utilisé : abonnement / Console / fournisseur tiers
Modèle et nom de domaine de l'API :
Message exact et code HTTP éventuel :
Heure de réinitialisation affichée :
En-tête retry-after, s'il existe :
Identifiant de requête, s'il existe :

Simpan juga pekerjaan lokal dan status tugas Anda. Setelah akses pulih, minta agen memeriksa file yang sudah diubah sebelum memulai ulang, agar langkah yang selesai tidak diulangi atau konteks perbaikan Anda tidak hilang.

Pertanyaan umum

Apa yang harus dilakukan ketika Claude Code menampilkan « batas tercapai »?

Pertama, identifikasi akun yang menyediakan respons. Untuk langganan, periksa waktu reset dan opsi kredit penggunaan. Untuk API, baca pesan lengkapnya: laju, batas pengeluaran, penagihan, dan autentikasi memerlukan perbaikan yang berbeda.

Apakah kode 429 selalu berarti harus menunggu?

Tidak. API Claude juga menggunakan 429 untuk beberapa batas pengeluaran. Pelampauan laju mungkin memerlukan waktu tunggu dan lebih sedikit permintaan bersamaan; batas finansial memerlukan pemeriksaan batas dan penagihan akun. Pesan dan header membantu memilih cabang yang tepat.

Apakah percakapan baru mengatur ulang kuota saya?

Tidak. Percakapan baru dapat mengurangi konteks yang dikirim, tetapi tidak mengatur ulang alokasi akun. Batas panjang percakapan dan batas penggunaan langganan Anda adalah dua kendala yang berbeda.

Apakah kunci Kunavo menghapus semua batas?

Tidak. Konfigurasi API dengan kunci Kunavo menggunakan akun dan penagihan yang terpisah dari langganan Claude. Konfigurasi tersebut tetap tunduk pada saldo, batas, dan model yang tersedia di Kunavo. Hanya mengubah alamat dasar tanpa mengonfigurasi pengenal yang benar tidak cukup untuk mengubah penagihan.

Sumber resmi diverifikasi pada 17 September 2026.