Batas Penggunaan Claude: Apa yang Harus Dilakukan

Apa batas penggunaan Claude?

Batas penggunaan Claude terdiri dari dua sistem yang terpisah. Langkah pertama adalah menentukan sistem mana yang menghentikan Anda. Langganan Claude (Pro, Max, Team, atau Enterprise) memberikan alokasi penggunaan bergulir yang digunakan bersama oleh semua model dan Claude chat. Jika alokasi ini habis, Claude akan menghentikan Anda dengan pesan seperti You've hit your session limit · resets 3:45pm. Claude API mengukur hal yang berbeda: kecepatan pengiriman request dan token, yang dihitung per menit. Claude API akan menghentikan Anda dengan error HTTP 429 bertipe rate_limit_error dan header retry-after yang menunjukkan jumlah detik untuk menunggu.

Penanganannya sama sekali berbeda. Batas langganan berkaitan dengan jumlah penggunaan dalam suatu periode. Anda perlu menunggu hingga batas direset atau membeli penggunaan tambahan. Batas laju API berkaitan dengan kecepatan Anda saat ini. Batas ini akan hilang dalam hitungan detik setelah Anda memperlambat pengiriman request.

Alokasi paket dan nomor tier rate limit sering berubah. Angka yang salah lebih buruk daripada tidak mencantumkan angka sama sekali, sehingga tidak ada angka yang dicantumkan di sini. Gunakan perintah di bagian berikut untuk membaca nilai pada akun Anda.

Batas mana yang Anda capai? Baca pesan persisnya

Claude Code menyebutkan sistem yang bermasalah dalam teks yang ditampilkannya. Cocokkan dengan sistem Anda sebelum mengubah apa pun.

• You've hit your session limit · resets 3:45pm adalah batas langganan. Kuota bergulir paket Anda untuk periode ini sudah habis.
• You've hit your weekly limit · resets Mon 12:00am adalah sistem yang sama untuk periode yang lebih panjang.
• You've hit your Opus limit · resets 3:45pm adalah batas langganan yang hanya berlaku untuk permintaan Opus. Hanya dalam kasus ini, mengganti model dapat membantu.
• API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com. adalah batas laju API. Anda telah mencapai batas yang dikonfigurasi untuk API key Anda, atau untuk project Amazon Bedrock atau Google Cloud Anda. Sistem yang berlaku bergantung pada cara client melakukan autentikasi, karena client Bedrock atau Vertex dihitung terhadap kuota project cloud Anda, bukan organisasi Anthropic.
• API Error: Server is temporarily limiting requests (not your usage limit) adalah pembatasan sementara yang tidak terkait dengan kuota paket Anda. Claude Code akan mencoba ulang secara otomatis dengan backoff sebelum menampilkan baris tersebut.

Batas langganan: sesi, mingguan, dan jendela Opus

Paket langganan mencakup alokasi penggunaan bergulir. Setelah alokasi tersebut habis, Claude Code memblokir permintaan berikutnya hingga waktu reset yang ditampilkan dalam pesan. Dua karakteristik alokasi ini paling sering menimbulkan kebingungan.

• Alokasi ini digunakan bersama Claude chat. Aktivitas Anda di claude.ai mengurangi alokasi yang sama dengan aktivitas di terminal. Karena itu, penggunaan chat yang tinggi pada siang hari mengurangi waktu yang tersedia untuk coding pada malam hari. Setiap antarmuka yang Anda gunakan untuk login dengan akun tersebut menggunakan pool yang sama. Jadi, di Linux, aplikasi desktop beta dan Claude Code CLI menggunakan satu alokasi bersama, bukan satu alokasi masing-masing.
• Alokasi ini digunakan bersama oleh semua model. Batas sesi dan mingguan tidak memiliki anggaran per model. Satu-satunya pengecualian adalah batas Opus.

Pada Claude untuk Teams dan Enterprise, struktur yang didokumentasikan adalah alokasi per seat yang direset berdasarkan jendela bergulir lima jam dan jendela mingguan. Alokasi ini digunakan bersama Claude chat dan Cowork, serta ditentukan oleh tier seat (Standard atau Premium). Pada Pro dan Max, waktu reset yang tercetak dalam pesan dan bar /usage milik Anda sendiri merupakan angka yang dapat diandalkan, bukan angka yang disalin dari posting blog. Jika Anda masih memilih tier, paket Claude yang Anda perlukan membandingkan pembatasan yang diterapkan oleh masing-masing paket.

Mengapa beralih model dengan /model tidak memulihkan akses

Ini adalah langkah keliru yang paling umum, dan dokumentasinya menyatakannya dengan jelas: batas sesi dan mingguan berlaku untuk semua model. Jadi, beralih model tidak memulihkan akses. Memilih model yang lebih kecil setelah jendela sesi Anda habis hanya mengubah model yang akan memberikan jawaban. Tindakan ini tidak mengubah sisa kuota karena kuota tersebut tidak pernah dialokasikan per model. Oleh karena itu, tidak ada kuota yang dapat dilepaskan saat Anda beralih model.

Pengecualiannya adalah batas Opus, yaitu batas yang memang khusus untuk model. Jika pesan yang ditampilkan adalah You've hit your Opus limit, maka /model adalah perbaikan yang tepat. Beralih ke model lain dan lanjutkan pekerjaan karena hanya permintaan ke Opus yang diblokir.

Menganggap batas tersebut sebagai bug adalah langkah keliru kedua. Menginstal ulang atau melakukan autentikasi ulang tidak mengubah apa pun. Kuota akan tersedia kembali saat jendela batas direset atau saat Anda membeli kredit penggunaan.

Yang harus dilakukan saat mencapai batas langganan

1. Baca waktu reset. Jendela sesi berlangsung singkat. Jendela mingguan bukan sesuatu yang dapat Anda tunggu di depan meja.
2. Jika yang tercapai adalah batas Opus, jalankan /model lalu pilih model lain.
3. Jalankan /usage untuk melihat batas paket, bar penggunaan, dan waktu reset. /cost adalah alias untuk layar yang sama.
4. Jalankan /usage-credits untuk tetap bekerja setelah mencapai batas. Pada Pro dan Max, perintah ini membuka pengaturan penagihan. Pada Team dan Enterprise, perintah ini membuka pengaturan penggunaan organisasi atau mengirimkan permintaan kepada administrator jika Anda tidak memiliki akses penagihan.
5. Jika Anda mencapai batas yang sama setiap minggu, ukuran paket tersebut tidak sesuai dengan cara Anda bekerja. Opsi untuk mengatasi batas penggunaan layak dipertimbangkan sekali, bukan setiap kali reset.

/usage-credits memerlukan langganan claude.ai yang sudah login melalui /login. Fitur ini tidak tersedia dengan autentikasi kunci API karena kunci API tidak memiliki alokasi paket yang dapat diperpanjang.

Kredit penggunaan memiliki satu efek samping yang perlu diketahui terlebih dahulu. Masa berlaku cache prompt adalah satu jam pada langganan dan turun menjadi lima menit setelah Anda mulai menggunakan kredit. Akibatnya, lebih banyak giliran dimulai tanpa cache, dan penggunaan token Claude Code meningkat untuk pekerjaan yang sama.

Pesan yang tampak seperti batas penggunaan, tetapi bukan

Empat error Claude Code dilaporkan sebagai batas penggunaan, padahal tidak satu pun demikian.

• Peringatan konteks atau auto-compact bukan batas penggunaan. /context menampilkan baris seperti Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue. setelah percakapan melebihi context window model. Riwayat lama diringkas untuk membebaskan ruang, dan jatah paket Anda tidak terpengaruh.
• Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again. berarti /compact sendiri gagal karena ruang konteks yang tersedia tidak cukup untuk menampung ringkasan yang akan dibuatnya.
• Credit balance is too low berarti organisasi Console Anda telah kehabisan kredit prabayar. Tambahkan kredit di platform.claude.com/settings/billing, yang juga menyediakan fitur auto-reload.
• API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context adalah pemeriksaan entitlement, bukan kuota yang habis. Pilih varian model tanpa suffix [1m], atau tetapkan CLAUDE_CODE_DISABLE_1M_CONTEXT=1.

Satu pesan lainnya berasal dari API. 413 request_too_large adalah batas ukuran pada satu request, bukan rate limit.

Batas laju API: apa yang sebenarnya dihitung oleh 429

Messages API mengukur tiga hal secara terpisah untuk setiap kelas model.

• requests per minute (RPM)
• input tokens per minute (ITPM)
• output tokens per minute (OTPM)

Organisasi Anda juga memiliki batas pengeluaran. Ini merupakan hal yang berbeda: biaya bulanan maksimum untuk penggunaan API. Setelah mencapai batas pengeluaran pada tier Anda, penggunaan API dihentikan sementara hingga bulan berikutnya, kecuali Anda meminta batas yang lebih tinggi. Tidak ada loop percobaan ulang yang dapat mengatasi kondisi ini.

Empat mekanisme menentukan kapan 429 muncul.

• Batas berlaku untuk setiap kelas model. Batas diterapkan secara terpisah untuk setiap model, sehingga Anda dapat menggunakan model yang berbeda secara bersamaan hingga mencapai batas masing-masing. Beberapa keluarga model berbagi satu bucket: batas laju Opus merupakan total untuk Claude Opus 4.8, Opus 4.7, Opus 4.6, dan Opus 4.5, sedangkan Claude Sonnet 5 memiliki batasnya sendiri.
• Kapasitas terisi kembali secara kontinu. API menggunakan algoritma token bucket, sehingga kapasitas bertambah secara kontinu, bukan direset pada waktu tertentu. Batas 60 requests per minute dapat diterapkan sebagai satu request per detik. Karena itu, 60 request yang dikirim sekaligus tetap dapat gagal.
• Pada sebagian besar model, hanya input yang tidak di-cache yang dihitung dalam ITPM. input_tokens dan cache_creation_input_tokens dihitung. cache_read_input_tokens tidak dihitung pada sebagian besar model Claude, dengan Claude Haiku 3.5 sebagai pengecualian yang didokumentasikan. Karena itu, caching memberikan ruang tambahan pada batas laju sekaligus diskon. Pada sisi output, max_tokens yang tinggi tidak dihitung terhadap OTPM karena OTPM hanya menghitung token yang benar-benar dihasilkan.
• Batas berlaku pada tingkat organisasi. Sebuah workspace dapat diberi batas yang lebih rendah, dan batas seluruh organisasi selalu berlaku meskipun total batas workspace melebihi batas tersebut. Jika Anda belum mengganti batas pada sebuah workspace, workspace tersebut mewarisi batas dari organisasi, bukan dianggap tidak terbatas.

Tier bernama Start, Build, Scale, dan Custom menentukan angka aktualnya. Tier ditetapkan secara otomatis berdasarkan riwayat penggunaan dan status akun Anda. Organisasi baru dapat memulai dengan batas di bawah batas standar yang dipublikasikan, sehingga 429 pertama dapat muncul lebih awal daripada perkiraan tabel. Peningkatan penggunaan yang tajam memicu batas akselerasi. Batas ini mengembalikan 429 meskipun penggunaan Anda masih berada dalam tier, jadi tingkatkan trafik secara bertahap. Setiap angka yang dipublikasikan merupakan batas maksimum. Batas yang didokumentasikan adalah penggunaan maksimum yang diizinkan, bukan minimum yang dijamin. Untuk meminta batas yang lebih tinggi, gunakan kontrol "Request rate limit increase" pada halaman Limits di Claude Console.

Membaca 429: retry-after, header, dan retry pada SDK

Setiap error API mengembalikan envelope yang sama: objek error bertingkat yang berisi tipe dan pesan, serta request_id tingkat teratas.

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

Header berisi informasi lainnya.

• retry-after adalah jumlah detik yang harus ditunggu sebelum Anda dapat mencoba kembali request. Percobaan ulang yang dilakukan lebih awal akan gagal.
• anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining, dan anthropic-ratelimit-requests-reset menjelaskan kuota request Anda.
• anthropic-ratelimit-input-tokens-* dan anthropic-ratelimit-output-tokens-* memberikan informasi yang sama untuk ITPM dan OTPM, dengan akhiran limit, remaining, dan reset yang sama.
• anthropic-ratelimit-tokens-* menampilkan nilai untuk limit paling ketat yang sedang berlaku.

Header reset menggunakan timestamp RFC 3339. Header token remaining dibulatkan ke ribuan terdekat, jadi gunakan nilainya sebagai indikator. Fast mode memiliki pool sendiri dan header anthropic-fast-* sendiri. Baca semua header tersebut dari setiap call yang berhasil:

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'

Setiap response juga membawa header request-id yang unik, misalnya req_018EeWyXxfu5pfWkrYcMdjWG. Header ini muncul sebagai request_id di body error dan sebagai _request_id pada response SDK Python dan TypeScript. Sertakan nilainya saat menghubungi support.

Periksa terlebih dahulu apakah Anda memang memerlukan loop backoff sebelum membuatnya. SDK resmi secara otomatis mencoba kembali kegagalan sementara, termasuk error koneksi, rate limit, dan error server 5xx, menggunakan exponential backoff, secara default sebanyak dua kali, serta mengikuti header retry-after jika tersedia. Setiap client menerima opsi maximum-retries untuk mengubah atau menonaktifkan perilaku tersebut.

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 bukan kesalahan Anda

Kode 429 berarti Anda mengirim permintaan terlalu cepat. Kode 529 overloaded_error berarti API sedang kelebihan beban sementara. Kondisi ini dapat terjadi ketika API menerima trafik tinggi dari semua pengguna. Key atau kode Anda bukan penyebabnya. Ulangi permintaan dengan exponential backoff. SDK sudah melakukannya untuk respons 5xx. Jika kondisi ini tidak teratasi, periksa status.claude.com. Kode 500 api_error berarti terjadi kesalahan internal. Ulangi permintaan dengan cara yang sama. Keduanya bukan rate limit.

Baca batas Anda sendiri, bukan tabel

Dalam langganan, /usage adalah layar yang perlu diperhatikan. Layar ini menampilkan bilah penggunaan paket dan rincian hal-hal yang menghabiskannya, sedangkan d atau w digunakan untuk beralih antara 24 jam terakhir dan 7 hari terakhir. Ada dua hal yang perlu diperhatikan. Blok Session menampilkan penggunaan token API dan ditujukan untuk pengguna API, sehingga pelanggan dapat mengabaikan nilai dolarnya. Angka tersebut berasal dari riwayat sesi lokal pada mesin itu, sehingga penggunaan dari perangkat lain atau dari claude.ai tidak tercakup.

Di sisi API, halaman Usage di Claude Console menampilkan dua grafik, "Rate Limit - Input Tokens" dan "Rate Limit - Output Tokens". Grafik input memplot maksimum token input yang tidak di-cache per menit setiap jam terhadap batas ITPM Anda saat ini, serta menampilkan cache rate di sebelahnya. Dengan demikian, Anda dapat memantau pendekatan ke batas sebelum batas tersebut tercapai di production.

Untuk membaca batas yang dikonfigurasi secara terprogram:

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

Perintah ini memerlukan Admin API key, dan GET /v1/organizations/workspaces/{workspace_id}/rate_limits melakukan hal yang sama untuk setiap workspace. Keduanya bersifat read-only. Untuk mengubah batas, gunakan tab Limits di Console.

Menggunakan lebih sedikit agar batas lebih jarang tercapai

Kedua sistem pada dasarnya mengukur hal yang sama, sehingga pengaturan ini berlaku pada keduanya.

• Gunakan lebih sedikit token per giliran. Sesi kerja berkelanjutan menjaga cache tetap hangat, dan /clear di antara tugas yang tidak berkaitan tidak menimbulkan biaya. Penggunaan token Claude Code menjelaskan seluruh pengaturan tersebut.
• Kurangi tingkat upaya. Tingkat yang tersedia adalah low, medium, high, xhigh, dan max. Menu /effort juga menyediakan ultracode, yang meningkatkan penggunaan alih-alih menguranginya. Penalaran mendalam untuk penggantian nama mekanis tidak memberikan manfaat.
• Kurangi konkurensi setelah menerima 429. Turunkan CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY dan hindari banyak subagen paralel. Jalankan /status juga: ANTHROPIC_API_KEY yang tertinggal dapat mengarahkan permintaan melalui key tingkat rendah, bukan langganan Anda.
• Pindahkan pekerjaan noninteraktif ke Message Batches API. API ini menjalankan volume besar secara asinkron dengan diskon 50% untuk token input dan output, menggunakan batas lajunya sendiri. Dengan demikian, tugas malam hari tidak lagi bersaing dengan sesi Anda.

Pekerjaan yang memasukkan banyak data ke dalam konteks paling terasa dampaknya: jika Anda menganalisis saham dan opsi berdasarkan data pasar langsung, mengambil bagian sempit yang diperlukan setiap pertanyaan hanya memerlukan sebagian kecil biaya dibandingkan menempelkan seluruh tabel kuotasi dan rantai opsi. Pekerjaan yang berlangsung secara singkat dan dipicu oleh program, bukan oleh manusia, sebaiknya sejak awal menggunakan API key. Perpindahan ini mengubah cara Anda membayar sekaligus cara penggunaan Anda diukur, karena Claude API tidak memiliki tingkat gratis selain kredit kecil yang diberikan saat pendaftaran. Aplikasi Claude API pertama Anda pada VPS menjelaskan penanganan key dan percobaan ulang. Proses agent yang berlangsung lama tetap berjalan meskipun koneksi terputus jika Anda menjalankan Claude Code pada VPS di dalam tmux.

FAQ

Mengapa mengganti model tidak memperbaiki batas penggunaan Claude saya?

Karena batas sesi dan mingguan digunakan bersama oleh semua model. Kuota tersebut terkait dengan paket, bukan model. Jadi, /model mengubah model yang akan menjawab, bukan sisa kuota. Satu-satunya pengecualian adalah You've hit your Opus limit, yang hanya berlaku untuk permintaan Opus. Dalam kasus tersebut, mengganti model adalah solusi yang didokumentasikan.

Apa arti 429 rate_limit_error, dan berapa lama saya harus menunggu?

Artinya, akun Anda mencapai batas laju untuk kelas model tersebut: jumlah permintaan per menit, token input per menit, atau token output per menit. Respons menyertakan header retry-after yang berisi jumlah detik untuk menunggu, dan percobaan ulang lebih awal akan gagal. SDK resmi sudah mencoba ulang error pembatasan laju dan error 5xx menggunakan exponential backoff, dua kali secara default, serta mematuhi header tersebut. Respons 429 yang muncul saat Anda masih berada dalam batas tier menunjukkan adanya acceleration limit akibat peningkatan penggunaan secara tiba-tiba.

Bagaimana cara melihat batas penggunaan Claude dan waktu resetnya?

Di Claude Code, jalankan /usage untuk melihat indikator paket, waktu reset, dan rincian penggunaan. /cost adalah aliasnya, sedangkan d atau w digunakan untuk berpindah antara 24 jam terakhir dan 7 hari terakhir. Angka tersebut berasal dari riwayat sesi lokal, sehingga tidak mencakup penggunaan dari perangkat lain dan claude.ai. Pada API, Console menampilkan grafik batas laju Anda, sedangkan GET /v1/organizations/rate_limits mengembalikan batas yang dikonfigurasi menggunakan Admin API key.

Apakah saya dapat terus bekerja setelah mencapai batas paket Claude?

Terkadang. Jalankan /usage-credits untuk membeli penggunaan tambahan setelah mencapai batas pada Pro dan Max, atau meminta penggunaan tersebut dari administrator pada Team dan Enterprise. Fitur ini memerlukan login claude.ai melalui /login dan tidak tersedia dengan autentikasi API key. Jika tidak, tunggu waktu reset, ganti model jika yang tercapai adalah batas Opus, atau pindahkan pekerjaan ke API key, yang menghitung penggunaan per menit, bukan per jendela waktu.