SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Batas Penggunaan Claude: Apa yang Harus Dilakukan

Pahami perbedaan batas sesi dan mingguan Claude dengan error API 429 rate_limit_error, termasuk arti retry-after, kapan batas direset, dan langkah berikutnya.

Apa saja batas penggunaan Claude?

Batas penggunaan Claude terdiri dari dua sistem terpisah, dan langkah pertama adalah menentukan sistem mana yang menghentikan Anda. Langganan Claude (Pro, Max, Team, atau Enterprise berbasis kursi) memberikan kuota penggunaan bergulir yang dibagikan ke seluruh model, terlepas dari beberapa batas keluarga model, dan dibagikan dengan obrolan Claude, sehingga sistem akan menghentikan Anda dengan pesan seperti You've hit your session limit · resets 3:45pm. Paket Enterprise berbasis penggunaan saat ini adalah pengecualian: paket tersebut tidak memiliki kuota bawaan, dan semua penggunaan ditagih berdasarkan tarif API sejak token pertama. API Claude mengukur hal lain: seberapa cepat Anda mengirim permintaan dan token, yang dihitung per menit. API akan menghentikan Anda dengan error HTTP 429 tipe rate_limit_error, biasanya disertai header retry-after yang menyatakan berapa detik Anda harus menunggu.

Solusinya tidak memiliki kesamaan. Batas langganan berkaitan dengan seberapa banyak Anda telah menggunakan layanan dalam suatu periode, jadi Anda harus menunggu reset, membeli penggunaan tambahan, atau menggunakan reset batas gratis jika paket Anda menawarkannya. Batas tarif API berkaitan dengan kecepatan Anda saat ini, dan akan hilang dalam hitungan detik setelah Anda memperlambat pengiriman.

Kuota paket dan angka tingkat batas tarif sering berubah, dan angka yang salah lebih buruk daripada tidak ada sama sekali, sehingga tidak ada angka yang dicantumkan di sini. Baca batas Anda sendiri dengan perintah di bawah ini.

Batas mana yang Anda capai? Baca pesan secara tepat

Claude Code menyebutkan sistem tersebut 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 berjalan paket Anda untuk periode ini telah 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. Beralih ke model di luar keluarga Opus agar dapat terus bekerja.
  • You've hit your Sonnet limit · resets 3:45pm adalah jenis batas keluarga model yang sama, tetapi hanya untuk permintaan Sonnet. Beralih ke model di luar keluarga Sonnet agar dapat terus bekerja.
  • Pesan yang dimulai dengan Fable limit reached berarti Anda telah menggunakan bagian dari kuota mingguan yang dapat digunakan oleh model Fable. Penggunaan berikutnya pada Fable akan membebankan kredit penggunaan, sehingga Claude Code meminta konfirmasi terlebih dahulu. Pilih model lain dengan /model agar tetap berada dalam paket Anda.
  • 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, atau untuk project Amazon Bedrock atau Google Cloud. Batas yang berlaku bergantung pada cara klien melakukan autentikasi, karena klien Bedrock atau Vertex dihitung berdasarkan 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 otomatis mencoba ulang dengan jeda bertahap sebelum menampilkan baris tersebut.

Batasan langganan: sesi, mingguan, dan jendela Opus

Paket Pro, Max, Team, atau Enterprise berbasis kursi menyertakan kuota penggunaan yang bersifat bergulir (rolling). Saat kuota tersebut habis, Claude Code akan memblokir permintaan lebih lanjut hingga waktu reset yang tertera pada pesan tercapai. Dua karakteristik dari kuota tersebut sering kali menimbulkan kebingungan.

  • Kuota ini dibagikan dengan obrolan Claude. Pekerjaan yang Anda lakukan di claude.ai menggunakan kuota yang sama dengan pekerjaan di terminal, sehingga penggunaan obrolan yang intens di sore hari akan mengurangi jatah waktu coding Anda di malam hari. Setiap antarmuka tempat Anda masuk dengan akun tersebut menggunakan kumpulan kuota yang sama, jadi di Linux aplikasi desktop beta dan Claude Code CLI menggunakan satu kuota yang sama, bukan satu kuota untuk masing-masing aplikasi.
  • Kuota ini dibagikan di seluruh model. Batasan sesi dan mingguan merupakan satu kumpulan untuk setiap model. Pengecualiannya adalah batas plafon keluarga model di dalam kumpulan tersebut: batasan Opus dan Sonnet, serta pada kursi Max dan Premium terdapat alokasi Fable hingga 50% dari batasan mingguan Anda. Pada kursi Pro dan Standard, Fable sama sekali tidak termasuk dalam batasan paket dan akan ditagihkan ke kredit penggunaan sejak permintaan pertama.

Pada Claude for Teams dan Enterprise berbasis kursi, ketentuan yang didokumentasikan adalah kuota per kursi yang di-reset pada jendela lima jam bergulir dan jendela mingguan, dibagikan dengan obrolan Claude dan Cowork, serta disesuaikan berdasarkan tingkat kursi (Standard atau Premium). Paket Enterprise berbasis penggunaan saat ini bekerja secara berbeda: tidak ada kuota bawaan yang bisa habis, penggunaan ditagihkan berdasarkan tarif API, dan plafonnya adalah batas pengeluaran apa pun yang ditetapkan oleh admin di tingkat organisasi dan untuk pengguna individu. Pada paket yang dibantu oleh tim penjualan, penggunaan yang dihentikan karena batas pengeluaran akan berlanjut pada awal periode penagihan berikutnya kecuali jika pemilik menaikkan batas tersebut terlebih dahulu. Pada paket swalayan (self-serve), penggunaan juga akan berhenti saat saldo kredit prabayar habis, hingga pemilik membeli lebih banyak. Pada paket Pro dan Max, waktu reset yang tercetak pada pesan dan bilah /usage Anda adalah angka yang dapat diandalkan, bukan angka yang disalin dari postingan blog. Jika Anda masih memilih tingkat paket, paket Claude mana yang Anda butuhkan membandingkan apa saja yang dibatasi oleh masing-masing paket.

Mengapa beralih model dengan /model tidak memulihkan sesi atau batas mingguan

Ini adalah kesalahan yang paling umum, dan dokumentasinya menyatakannya dengan jelas: batas sesi dan batas mingguan berlaku bersama untuk semua model, sehingga 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 sesi dan mingguan tidak disimpan per model. Oleh karena itu, tidak ada kuota yang dapat dilepaskan dengan beralih model.

Pengecualiannya adalah batas per keluarga model. Jika pesan menampilkan You've hit your Opus limit atau You've hit your Sonnet limit, /model adalah tindakan perbaikan yang benar. Beralihlah ke model di luar keluarga tersebut dan lanjutkan pekerjaan, karena hanya permintaan ke keluarga model itu yang diblokir. Batas Fable pada paket Max dan Premium bekerja dengan cara yang sama: beralih ke model lain untuk melanjutkan pekerjaan dalam paket Anda, atau tetap gunakan Fable dengan kredit penggunaan. Namun, Fable menggunakan kumpulan kuota mingguan bersama lebih cepat daripada model lain. Karena itu, beralih model setelah mencapai batas Fable tidak memungkinkan Anda melewati batas mingguan keseluruhan.

Menganggap batas tersebut sebagai bug adalah kesalahan kedua. Menginstal ulang atau melakukan autentikasi ulang tidak mengubah apa pun. Kuota akan kembali ketika jendela waktunya direset, ketika Anda menggunakan reset batas gratis, atau ketika Anda membeli kredit penggunaan.

Apa yang harus dilakukan saat Anda mencapai batas langganan

  1. Periksa waktu reset. Jendela sesi biasanya singkat. Jendela mingguan bukanlah sesuatu yang bisa Anda tunggu di depan meja. Pada Claude Code v2.1.234 atau versi lebih baru, /rate-limit-options dapat menunggu waktu reset dan melanjutkan tugas yang terhenti secara otomatis.
  2. Jika batas yang tercapai adalah Opus, Sonnet, atau Fable, jalankan /model dan pilih model di luar keluarga tersebut.
  3. Jalankan /usage untuk melihat batas paket Anda, indikator penggunaan, dan waktu reset. /cost adalah alias untuk layar yang sama.
  4. Periksa Settings > Usage di claude.ai atau di Claude Desktop untuk bagian Resets. Paket yang memenuhi syarat terkadang mendapatkan penawaran reset batas gratis. Mengeklik "Reset for free" akan mengembalikan batas sesi lima jam atau batas mingguan Anda—tergantung pada cakupan penawaran—ke kapasitas penuh seketika. Tombol ini tidak tersedia di Claude Code dalam terminal atau IDE, maupun di Claude Mobile, dan setiap penawaran memiliki masa berlaku.
  5. Jalankan /usage-credits untuk tetap bekerja setelah mencapai batas. Pada paket Pro dan Max, perintah ini akan membuka pengaturan penagihan Anda. Pada paket Team dan Enterprise, perintah ini akan membuka pengaturan penggunaan organisasi Anda, atau mengirimkan permintaan ke admin jika Anda tidak memiliki akses penagihan.
  6. Jika Anda terus mencapai batas yang sama setiap minggu, berarti paket tersebut tidak sesuai dengan cara kerja Anda. Mempertimbangkan jalan keluar dari batas penggunaan lebih baik dilakukan sekali daripada setiap kali reset terjadi.

/usage-credits memerlukan langganan claude.ai yang masuk melalui /login. Fitur ini tidak tersedia dengan autentikasi API key, karena API key tidak memiliki alokasi paket untuk diperpanjang.

Kredit penggunaan memiliki satu efek samping yang perlu diketahui terlebih dahulu. Secara default, Claude Code memberikan cache prompt satu jam untuk percakapan utama Anda selama Anda masih dalam batas penggunaan paket langganan. Durasi ini akan turun menjadi lima menit setelah Anda mulai menggunakan kredit, sehingga lebih banyak giliran yang dimulai dari awal dan penggunaan token Claude Code meningkat untuk pekerjaan yang sama. Subagen berada di luar bucket percakapan utama tersebut, sehingga mereka mendapatkan durasi lima menit bahkan saat masih dalam batas penggunaan paket. Memilih TTL sendiri, dengan pengaturan promptCacheTtl atau CLAUDE_CODE_PROMPT_CACHE_TTL pada Claude Code v2.1.242 atau versi lebih baru, akan mempertahankan durasi satu jam saat Anda menggunakan kredit.

Pesan yang tampak seperti batas penggunaan, tetapi bukan

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

  • Peringatan context atau auto-compact bukan batas penggunaan. /context mencetak baris seperti Context exceeds the 200k-token limit by 94k tokens, diikuti perintah untuk membebaskan ruang, setelah percakapan melebihi context window model. Compacting merangkum riwayat lama untuk membebaskan ruang, tetapi proses ini tidak gratis: /compact membaca percakapan yang dirangkum, sehingga compacting context yang besar tetap merupakan request besar terhadap plan Anda. Jika Anda menginginkan awal baru dan bukan kelanjutan percakapan, /clear tidak dikenai biaya.
  • Prompt is too long · automatic compaction failed: <the underlying error> berarti automatic compaction gagal karena error yang disebutkan. /compact akan terus gagal dengan error yang sama sampai Anda mengatasinya.
  • Credit balance is too low berarti organisasi Console Anda kehabisan prepaid credits, atau Claude Code mengirim request pelanggan melalui Console API key; /status menampilkan credential yang sedang aktif. Tambahkan credits di platform.claude.com/settings/billing. Halaman tersebut juga menyediakan auto-reload.
  • 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 adalah pemeriksaan entitlement, bukan quota yang habis. Jika Anda memilih varian [1m] dari Opus 4.6 atau Sonnet 4.6, pilih varian tanpa suffix [1m], atau tetapkan CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Jika pesan ini muncul di tengah percakapan karena context melebihi 200K tokens, Claude Code akan melakukan compacting hingga kembali di bawah batas standar secara otomatis. Sonnet 5 dan versi lebih baru, Opus 4.7 dan versi lebih baru, Haiku 5.5, serta model Fable berjalan dengan native 1M window dan tidak memiliki suffix yang perlu dihapus; variabel tersebutlah yang membatasi model-model itu hingga 200K.

Satu error lainnya berasal dari API. Error 413 request_too_large adalah batas ukuran untuk satu request, bukan rate limit.

Batas rate limit 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, yang merupakan hal berbeda: biaya bulanan maksimum untuk penggunaan API. Setelah Anda mencapai batas pengeluaran tier Anda, penggunaan API akan dijeda hingga bulan berikutnya kecuali Anda meminta batas yang lebih tinggi. Hal ini juga muncul sebagai 429 rate_limit_error, namun tanpa header retry-after dan dengan enforced_spend_limit_reached di dalam error.details.error_code. Tidak ada loop percobaan ulang yang dapat mengatasi hal tersebut. Batas pengeluaran lebih rendah yang Anda tetapkan sendiri di Console akan muncul dengan cara berbeda: permintaan mengembalikan HTTP 400 invalid_request_error dengan pesan yang diawali You have reached your specified API usage limits, dan menaikkan atau menghapus batas tersebut akan memulihkan akses.

Empat mekanisme menentukan kapan 429 muncul.

  • Batas berlaku per kelas model. Batas ini berlaku secara terpisah untuk setiap model, sehingga Anda dapat menggunakan model yang berbeda hingga batas masing-masing secara bersamaan. Beberapa keluarga model berbagi bucket yang sama: batas rate limit Opus adalah total untuk Claude Opus 4.8, Opus 4.7, Opus 4.6, dan Opus 4.5, sementara Claude Sonnet 5 memiliki batasnya sendiri.
  • Kapasitas terisi kembali secara terus-menerus. API menggunakan algoritma token bucket, sehingga kapasitas terisi kembali secara terus-menerus, bukan diatur ulang pada saat tertentu. Batas 60 permintaan per menit dapat diberlakukan sebagai satu permintaan per detik, sehingga 60 permintaan yang dikirim sekaligus akan tetap gagal.
  • Hanya input yang tidak di-cache yang dihitung terhadap ITPM pada sebagian besar model. input_tokens dan cache_creation_input_tokens dihitung. cache_read_input_tokens tidak dihitung pada sebagian besar model Claude, dengan pengecualian yang terdokumentasi pada Claude Haiku 3.5. Oleh karena itu, caching memberikan ruang tambahan pada rate limit sekaligus diskon. Di sisi output, max_tokens yang tinggi tidak dihitung terhadap OTPM, karena OTPM hanya menghitung token yang benar-benar dihasilkan.
  • Batas berlaku di tingkat organisasi. Workspace dapat diberikan batas yang lebih rendah, dan batas di seluruh organisasi selalu berlaku meskipun total batas workspace lebih besar. Batas yang tidak Anda ubah di workspace akan diwarisi dari organisasi, bukan dibiarkan tanpa batas.

Tier yang bernama Start, Build, Scale, dan Custom menetapkan angka sebenarnya, yang ditetapkan secara otomatis berdasarkan riwayat penggunaan dan status akun Anda. Organisasi baru dan organisasi dengan riwayat penggunaan minim mungkin memulai di tier Evaluation, di bawah batas standar yang dipublikasikan, sehingga 429 pertama bisa muncul lebih awal dari prediksi tabel. Peningkatan penggunaan yang tajam memicu batas akselerasi, yang mengembalikan 429 saat Anda masih berada di dalam tier Anda, jadi tingkatkan trafik secara bertahap. Setiap angka yang dipublikasikan adalah batas atas: batas yang terdokumentasi adalah penggunaan maksimum yang diizinkan, bukan minimum yang dijamin. Untuk meminta lebih, gunakan "Request tier increase" pada halaman Rate limits di Claude Console.

Membaca 429: retry-after, header, dan percobaan ulang SDK

Setiap error API mengembalikan envelope yang sama: objek error bersarang yang memuat tipe dan pesan, ditambah request_id pada level teratas.

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

Header memuat informasi sisanya.

  • retry-after adalah jumlah detik untuk menunggu sebelum Anda dapat mencoba ulang permintaan. Percobaan ulang lebih awal akan gagal. Tidak semua 429 menyertakan header ini, dan 429 akibat batas pengeluaran (spend-cap) tidak pernah menyertakannya.
  • anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining, dan anthropic-ratelimit-requests-reset menjelaskan anggaran permintaan Anda.
  • anthropic-ratelimit-input-tokens-* dan anthropic-ratelimit-output-tokens-* melakukan hal yang sama untuk ITPM dan OTPM, dengan akhiran limit, remaining, dan reset yang serupa.
  • anthropic-ratelimit-tokens-* menampilkan nilai untuk batas paling restriktif yang sedang berlaku.

Header reset adalah timestamp RFC 3339. Header sisa token dibulatkan ke ribuan terdekat, jadi bacalah sebagai indikator. Mode cepat memiliki pool sendiri dan header anthropic-fast-* sendiri. Baca semuanya dari setiap panggilan 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 respons juga membawa header request-id yang unik, seperti req_018EeWyXxfu5pfWkrYcMdjWG. Header ini muncul sebagai request_id dalam badan error dan sebagai _request_id pada respons SDK Python dan TypeScript. Sebutkan header ini saat Anda menghubungi dukungan.

Periksa apakah Anda benar-benar memerlukan loop backoff sebelum menulisnya. SDK resmi secara otomatis mencoba ulang kegagalan transien, termasuk error koneksi, limit rate, dan error server 5xx, dengan exponential backoff, secara default sebanyak dua kali, serta mematuhi header retry-after jika tersedia. Setiap klien 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

Pada langganan, /usage adalah layar yang penting. Layar ini menampilkan bilah penggunaan paket dan perincian hal yang menggunakannya. d atau w beralih antara 24 jam terakhir dan 7 hari terakhir. Ada 2 hal yang perlu diperhatikan. Blok Session menampilkan penggunaan token API dan ditujukan bagi pengguna API, sehingga pelanggan dapat mengabaikan angka dolarnya. Angka tersebut berasal dari riwayat sesi lokal pada mesin itu. Oleh karena itu, penggunaan dari perangkat lain atau dari claude.ai tidak tercatat.

Di sisi API, halaman Usage di Claude Console menampilkan 2 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. Grafik tersebut juga menampilkan cache rate di sebelahnya. Dengan demikian, Anda dapat memantau pendekatan ke batas sebelum mencapai batas tersebut 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 kredensial Admin API: kunci Admin API, token OAuth dengan scope org:admin, atau kunci personal atau service account yang tidak dibatasi ke workspace. Workspace API keys tidak dapat digunakan. GET /v1/organizations/workspaces/{workspace_id}/rate_limits melakukan hal yang sama untuk setiap workspace. Keduanya bersifat read-only. Untuk mengubah batas, gunakan halaman Rate limits di Console.

Menggunakan lebih sedikit agar lebih jarang terkena batas

Kedua sistem mengukur hal yang sama di balik layar, sehingga pengaturan ini berlaku pada keduanya.

  • Gunakan lebih sedikit token per giliran. Sesi berkelanjutan menjaga cache tetap hangat, dan /clear di antara tugas yang tidak berkaitan tidak menimbulkan biaya. Penggunaan token Claude Code menjelaskan semua pengaturan tersebut secara lengkap.
  • Kurangi tingkat upaya. Tingkat yang tersedia adalah low, medium, high, xhigh, dan max. Menu /effort juga menyediakan ultracode, yang justru meningkatkan penggunaan, bukan 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 yang berjalan paralel. Jalankan juga /status: ANTHROPIC_API_KEY yang tertinggal dapat merutekan permintaan melalui key tingkat rendah, bukan melalui subscription Anda.
  • Pindahkan pekerjaan non-interaktif 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, pekerjaan malam hari tidak lagi bersaing dengan sesi Anda.

Pekerjaan yang memasukkan banyak data ke dalam konteks paling merasakan dampaknya. Jika Anda menganalisis saham dan opsi berdasarkan data pasar langsung, mengambil bagian sempit yang diperlukan untuk setiap pertanyaan hanya memerlukan sebagian kecil biaya dibandingkan menempelkan seluruh tabel kuotasi dan rantai opsi. Pekerjaan bergejolak yang digerakkan program, bukan 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. Paket Max dan Team memang menyertakan kredit API bulanan untuk menjalankan aplikasi dan agen Anda sendiri setelah Anda menautkan organisasi Console. Kredit tersebut tidak mencakup Claude Code dan tidak mengubah batas penggunaan paket Anda. Aplikasi Claude API pertama Anda pada VPS menjelaskan pengelolaan key dan retry. Sesi agen yang panjang tetap berjalan setelah koneksi terputus jika Anda menjalankan Claude Code pada VPS di dalam tmux.

FAQ

Mengapa mengganti model tidak memperbaiki limit penggunaan Claude saya?

Karena limit sesi dan mingguan digunakan bersama oleh semua model. Jatah tersebut milik paket langganan, bukan milik model tertentu, sehingga /model hanya mengubah model mana yang akan menjawab dan bukan sisa jatah yang tersedia. Pengecualiannya adalah limit keluarga model: You've hit your Opus limit dan You've hit your Sonnet limit hanya berlaku untuk keluarga tersebut, dan limit Fable pada akun Max dan Premium hanya membatasi Fable saja. Dalam kasus tersebut, mengganti model adalah solusi yang terdokumentasi.

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

Itu berarti akun Anda mencapai limit kecepatan untuk kelas model tersebut: permintaan per menit, token input per menit, atau token output per menit. Respons tersebut biasanya menyertakan header retry-after yang berisi durasi detik untuk menunggu, dan percobaan ulang yang dilakukan lebih awal akan gagal. SDK resmi sudah melakukan percobaan ulang otomatis untuk limit kecepatan dan error 5xx dengan exponential backoff, secara default sebanyak dua kali, dengan mematuhi header tersebut jika tersedia. Error 429 yang muncul saat Anda masih berada dalam limit paket Anda menunjukkan adanya limit akselerasi akibat lonjakan penggunaan yang tiba-tiba. Error 429 dengan enforced_spend_limit_reached di dalam error.details.error_code, yang tidak pernah menyertakan header retry-after, adalah limit pengeluaran bulanan, dan menunggu selama beberapa menit tidak akan menghilangkannya.

Bagaimana cara melihat limit penggunaan Claude saya dan kapan limit tersebut di-reset?

Di Claude Code, jalankan /usage untuk melihat bar status paket, waktu reset, dan rincian penggunaan; /cost adalah alias, dan d atau w digunakan untuk beralih antara data 24 jam terakhir dan 7 hari terakhir. Angka-angka tersebut berasal dari riwayat sesi lokal, sehingga tidak mencakup penggunaan dari perangkat lain atau dari claude.ai. Pada API, Console menampilkan grafik limit kecepatan Anda, dan GET /v1/organizations/rate_limits mengembalikan limit yang dikonfigurasi menggunakan kredensial Admin API, seperti Admin API key.

Bisakah saya tetap bekerja setelah mencapai limit paket Claude saya?

Terkadang bisa. Jalankan /usage-credits untuk membeli tambahan penggunaan setelah mencapai batas pada paket Pro dan Max, atau untuk memintanya kepada admin pada paket Team dan Enterprise; ini memerlukan login claude.ai melalui /login dan tidak tersedia dengan autentikasi API key. Jika tidak, tunggulah hingga waktu reset, gunakan reset limit gratis jika tersedia di Settings > Usage pada claude.ai atau Claude Desktop, ganti model jika limit yang tercapai adalah limit Opus, Sonnet, atau Fable, atau pindahkan pekerjaan ke API key, yang dihitung per menit alih-alih per jendela waktu.