Pengembang yang menggunakan Claude Code — alat pengodean agentik dari Anthropic — sering menemui batas: “Batas penggunaan Claude tercapai. Batas Anda akan direset pada 7pm (Asia/Tokyo).” Pesan itu menimbulkan pertanyaan: apa tepatnya yang direset, kapan itu terjadi, dan bagaimana Anda harus mengubah kode atau infrastruktur untuk menghindari kejutan?
Jika produk atau pipeline CI Anda bergantung pada Claude Code untuk pemformatan, pembuatan tes, atau tinjauan kode on-demand, batas yang tak terduga dapat merusak alur kerja. Mengetahui apakah batas tersebut adalah 429 jangka pendek (detik–menit), reset sesi (jam), atau batas mingguan (hari) membantu Anda memutuskan apakah harus mencoba lagi, menurunkan layanan secara elegan, atau menjadwalkan pekerjaan nanti.
Apa itu Claude Code?
Claude Code adalah produk pengodean berfokus pada pengembang dari Anthropic yang terintegrasi langsung ke dalam alur kerja pengembang: terminal, CI, kontrol versi, dan IDE. Produk ini dibangun untuk melakukan edit multi-berkas, triase isu, menjalankan tes, dan mengotomatiskan tugas kode — pada dasarnya kolaborator agentik yang hidup di CLI dan peralatan Anda. Produk ini tersedia sebagai bagian dari keluarga produk Claude (web, API, dan Code), dirancang untuk mempercepat tugas pemrograman (generasi kode, refactor, penjelasan, pembuatan tes, debugging) dengan memungkinkan pengembang memanggil model Claude langsung dari editor atau terminal, sering kali dengan pintasan dan perilaku preset model yang dioptimalkan untuk prompt berat kode. dan ini mengekspos perintah CLI interaktif (seperti /config, /status) serta API administratif untuk organisasi.
Perbedaan kunci vs. Claude API umum:
- Claude Code berorientasi pada alur kerja pengembang (semantik sesi/agen, status line, pengaturan tingkat proyek), sementara Messages/Completions API adalah endpoint inferensi terprogram serbaguna.
- Organisasi dapat menggunakan Admin/Usage API untuk mengambil laporan penggunaan harian Claude Code (berguna untuk dasbor dan alokasi biaya).
Checklist fitur cepat
- Integrasi Terminal / VS Code untuk alur kerja berorientasi kode.
- Pergantian model otomatis atau manual (Opus ↔ Sonnet) untuk kompromi biaya/throughput.
- Akuntansi penggunaan dan batas per sesi untuk mencegah satu pengguna memonopoli kapasitas.
- Perbedaan tingkatan paket (Free / Pro / Max / Team / Enterprise) yang mengubah alokasi dan perilaku.
Kapan penggunaan Claude Code direset?
Jawaban singkat: tergantung paket Anda — tetapi aturan paling penting dan praktis untuk diingat saat ini adalah bahwa penggunaan berbasis sesi di Claude Code diatur oleh jendela bergulir lima jam yang dimulai ketika Anda mulai menggunakan sesi tersebut, dan batas mingguan yang lebih luas dilacak secara terpisah.
Baik paket Pro maupun Max memiliki batas penggunaan untuk Claude Code. Jumlah pesan yang dapat Anda kirim bergantung pada panjang pesan, panjang percakapan, dan jumlah lampiran, sementara penggunaan Claude Code bergantung pada kompleksitas proyek, ukuran basis kode, dan pengaturan auto-accept. Menggunakan model yang intensif komputasi akan membuat Anda mencapai batas penggunaan lebih cepat.
Cara kerja sesi lima jam (aturan yang penting)
Untuk paket berbayar (Pro dan Max), Claude Code melacak batas penggunaan berbasis sesi yang “direset setiap lima jam.” Secara praktis, itu berarti jam untuk alokasi 5 jam Anda dimulai ketika Anda mengirim permintaan pertama dalam sebuah sesi — bukan pada tengah malam, dan tidak tersinkron dengan batas kalender. Saat Anda mencapai batas sesi, Anda akan melihat pesan “batas penggunaan tercapai” dan waktu kapan jendela sesi berikutnya akan dimulai.
Batas API dan tingkat organisasi: pengisian ulang kontinu
Untuk konsumen API dan integrator tingkat organisasi, Anthropic menerapkan pembatasan laju token-bucket dan batas pengeluaran. Pembatasan laju ini diisi ulang secara kontinu (tidak hanya pada batas lima jam yang diskret) dan dilaporkan melalui header respons seperti anthropic-ratelimit-requests-remaining, anthropic-ratelimit-tokens-remaining, dan cap waktu -reset yang sesuai. Bagi klien API, header ini adalah sumber otoritatif untuk mengetahui kapan Anda dapat melanjutkan aktivitas berat.
Batas keras mingguan dan perubahan untuk “power user”
Pada pertengahan 2025 Anthropic memperkenalkan batas penggunaan mingguan tambahan (jendela 7 hari) untuk mengekang pemakaian latar belakang terus-menerus oleh pengguna berat Claude Code. Batas mingguan ini terpisah dari perilaku sesi lima jam dan token-bucket: jika Anda menghabiskan batas mingguan, menunggu lima jam tidak akan memulihkan kemampuan menggunakan fitur atau model tertentu hingga jendela 7 hari direset (atau Anda membeli kapasitas tambahan jika tersedia).
Anthropic menerapkan batas penggunaan mingguan (alokasi bergulir 7 hari) untuk Claude Code pada paket berbayar. Batas mingguan tersebut dinyatakan sebagai perkiraan jam penggunaan Claude Code per model (Sonnet vs Opus) dan bervariasi menurut paket dan tingkatan.
Konsumsi Dipercepat Selama Jam Sibuk (per 28 Maret 2026)
Menurut pernyataan dari tim teknis Anthropic pada 28 Maret 2026, penyesuaian ini terutama memengaruhi pelanggan Free, Pro, dan Max.
Selama jam sibuk dari pukul 5:00 hingga 11:00 Waktu Pasifik (20:00 hingga 2:00 Waktu Beijing), batas sesi 5 jam Claude akan dikurangi. Ini berarti aktivitas yang sama akan menghabiskan batas lebih cepat selama jam sibuk. Perkiraan resmi menunjukkan bahwa sekitar 7% pengguna (terutama pengguna Pro yang banyak menggunakan token) akan memicu peringatan batas lebih awal dari biasanya.
Pro vs Max (tingkatan konsumen): Apa perbedaannya secara praktis
Pengguna Opus berat dengan basis kode besar, atau yang menjalankan beberapa instance Claude Code secara paralel, akan lebih cepat mencapai bottleneck kinerja.
Paket Pro ($20/bulan):
- Sesi: ~45 pesan setiap lima jam, atau ~10–40 prompt Claude Code setiap lima jam.
- Mingguan: ~40–80 jam Sonnet 4 (paket Pro umumnya tidak mendukung Opus di Claude Code).
Max 5× ($100/bulan):
- Sesi: ~225 pesan setiap lima jam, atau ~50–200 prompt Claude Code setiap lima jam.
- Mingguan: ~140–280 jam Sonnet 4 dan ~15–35 jam Opus 4 (Opus tersedia di Max).
Max 20× ($200/bulan):
- Sesi: ~900 pesan setiap lima jam, atau ~200–800 prompt Claude Code setiap lima jam.
- Mingguan: ~240–480 jam Sonnet 4 dan ~24–40 jam Opus 4.
Situasi konkret dan apa arti “reset” pada umumnya
1. Anda menerima 429 dengan retry-after
- Apa yang terjadi: Anda mencapai batas laju permintaan/token.
- Yang diharapkan: header
retry-aftermemberi tahu berapa detik untuk menunggu; respons Anthropic juga menyetel headeranthropic-ratelimit-*-resetyang berisi cap waktu RFC3339 untuk pengisian ulang yang presisi. Gunakan header ini untuk penjadwalan percobaan ulang yang tepat.
2. Sesi interaktif Claude Code menampilkan “Mendekati batas 5 jam / reset pada 7pm”
- Apa yang terjadi: sesi interaktif Anda menghabiskan alokasi jangka pendeknya. Secara historis, sesi memiliki perilaku jendela “5 jam” yang praktis dan UI sering membulatkan waktu reset ke waktu jam yang rapi. Waktu yang ditampilkan bisa lokal ke akun atau UI Anda, dan pengguna melaporkan bahwa itu bersifat perkiraan (tidak selalu cap waktu RFC3339 yang presisi). Perlakukan waktu UI semacam itu sebagai panduan; gunakan metode terprogram untuk akurasi bila memungkinkan.
3. Anda mencapai batas mingguan untuk Opus/model
- Apa yang terjadi: Anda atau organisasi Anda menghabiskan alokasi mingguan untuk model tertentu (mis., Opus 4).
- Yang diharapkan: batas mingguan hanya akan terisi kembali setelah jendela tujuh hari berakhir. Sekadar menunggu reset per jam atau per menit tidak akan memulihkan kapasitas mingguan. Anthropic mengumumkan pembatasan laju mingguan untuk beberapa pelanggan mulai 28 Agustus 2025; pelanggan Max memiliki opsi untuk membeli penggunaan tambahan bila diperlukan.
4. Anda mencapai batas pengeluaran bulanan
- Apa yang terjadi: organisasi Anda mencapai batas pengeluaran bulan kalender yang ditetapkan.
- Yang diharapkan: akses dibatasi hingga bulan kalender berikutnya (atau hingga Anda menaikkan batas pengeluaran/setoran). Ini diterapkan untuk mencegah pengeluaran berlebih yang tidak terduga.
Catatan anomali dunia nyata: Ada laporan bug terbuka yang menggambarkan kasus di mana UI melaporkan waktu reset tetapi kuota sebenarnya tidak menyegarkan pada waktu yang ditunjukkan — terkadang memengaruhi pengalaman web vs. CLI secara berbeda. Jika otomasi Anda bergantung pada reset, perhitungkan kemungkinan rekonsiliasi yang tertunda.
Cara mendeteksi status reset secara terprogram — contoh kode
Pengembang mungkin perlu mendeteksi secara terprogram secara real-time apakah dan kapan harus reset untuk menghindari gangguan kerja. Di bawah ini adalah pola kode pragmatis yang dapat Anda masukkan ke alat produksi untuk mendeteksi reset, bereaksi dengan aman, dan menjaga metrik.
1) Gunakan header respons dari Messages API untuk menjadwalkan percobaan ulang
Saat Anda terkena 429, Anthropic menyertakan header yang menunjukkan kapasitas tersisa dan cap waktu reset yang tepat. Contoh Python berikut menunjukkan cara membaca anthropic-ratelimit-requests-reset dan menggunakan Retry-After jika ada:
import requests
from datetime import datetime, timezone
import time
API_URL = "https://api.anthropic.com/v1/complete" # example inference endpoint
API_KEY = "sk-...YOUR_KEY..."
HEADERS = {
"x-api-key": API_KEY,
"anthropic-version": "2023-06-01",
"content-type": "application/json",
}
payload = {
"model": "claude-opus-4",
"messages": ,
}
resp = requests.post(API_URL, headers=HEADERS, json=payload)
if resp.status_code == 429:
# Prefer exact RFC3339 reset timestamp header if present
reset_time = resp.headers.get("anthropic-ratelimit-requests-reset")
retry_after = resp.headers.get("retry-after")
if reset_time:
# parse RFC3339-style timestamp to epoch
try:
reset_dt = datetime.fromisoformat(reset_time.replace("Z", "+00:00"))
wait_seconds = (reset_dt - datetime.now(timezone.utc)).total_seconds()
except Exception:
wait_seconds = int(retry_after or 60)
elif retry_after:
wait_seconds = int(retry_after)
else:
wait_seconds = 60 # conservative default
wait_seconds = max(0, wait_seconds)
print(f"Rate limited. Waiting {wait_seconds:.1f}s before retry.")
time.sleep(wait_seconds + 1)
# Retry logic here...
else:
print("Response OK:", resp.status_code)
print(resp.text)
Mengapa ini membantu: membaca anthropic-ratelimit-*-reset memberi Anda cap waktu RFC3339 untuk kapan bucket diharapkan terisi kembali; retry-after bersifat otoritatif untuk backoff segera.
2) Periksa penggunaan secara terprogram (tingkat organisasi) — Admin Usage Report (cURL)
Anthropic menyediakan endpoint Admin “Usage Report” yang mengembalikan metrik Claude Code per hari untuk organisasi. Catatan: kunci Admin API diperlukan dan API ini untuk organisasi (bukan akun pribadi individu). Contoh (diedit untuk kejelasan):
# Replace $ANTHROPIC_ADMIN_KEY and starting_at with your values
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2025-08-08&limit=20" \
--header "anthropic-version: 2023-06-01" \
--header "content-type: application/json" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY"
Ini mengembalikan catatan agregat harian (commit, lines_of_code, token, perkiraan biaya, dll.) — berguna untuk dasbor dan rekonsiliasi penagihan.
3) Gunakan CLI Claude Code /status dan integrasi statusline untuk tooling lokal
CLI Claude Code mengekspose perintah garis miring dan perintah /status (atau terkait) untuk melihat alokasi interaktif yang tersisa; Anda juga dapat mengonfigurasi status line kustom (/statusline) atau menggunakan .claude/settings.json untuk menampilkan statistik penggunaan di prompt shell Anda.
Taktik praktis apa yang mengurangi friksi kuota?
1. Mulai sesi dengan cerdas
Mulailah langkah perencanaan atau generatif yang berat tepat setelah reset. Jika Anda memperkirakan sesi yang panjang, jadikan itu “permintaan pertama” Anda untuk menambatkan jendela lima jam yang baru.
2. Gunakan pergantian model secara strategis
Opus kuat tetapi mahal dari sisi alokasi; Sonnet lebih murah. Gunakan /model di awal sesi atau andalkan pergantian otomatis untuk memperpanjang waktu pakai dalam satu jendela. Banyak pengguna paket Max mengonfigurasi ambang pergantian otomatis untuk memaksimalkan waktu aktif.
3. Koordinasikan antar rekan tim
Jika beberapa rekan tim mencapai batas mingguan yang sama yang dipool dalam tim atau organisasi, koordinasikan pekerjaan berat (mis., uji performa, refactor besar) untuk menghindari konsumsi yang tumpang tindih.
4. Gunakan API atau pay-as-you-go untuk lonjakan
Jika Claude Code mencapai kuota UI lokal, pertimbangkan menggunakan Claude API/konsol dengan kredit pay-as-you-go untuk lonjakan yang sensitif waktu (periksa paket Anda untuk melihat apakah ini tersedia dan hemat biaya).
Para pengembang dapat mengakses Claude Sonnet 4.5 API dan Claude Opus 4.1 API dll melalui CometAPI, versi model terbaru selalu diperbarui mengikuti situs resmi. Untuk memulai, jelajahi kemampuan model di Playground dan lihat panduan API untuk petunjuk terperinci. Sebelum mengakses, pastikan Anda sudah masuk ke CometAPI dan memperoleh kunci API. CometAPI menawarkan harga yang jauh lebih rendah daripada harga resmi untuk membantu Anda melakukan integrasi.
Siap mulai?→ Daftar CometAPI sekarang!
Jika Anda ingin mengetahui lebih banyak kiat, panduan, dan berita seputar AI ikuti kami di VK, X dan Discord!
Kesimpulan
Memahami kapan penggunaan Claude Code direset itu penting — hal ini memengaruhi bagaimana Anda merencanakan sesi pengodean, bagaimana Anda menganggarkan sumber daya langganan, dan bagaimana Anda merespons gangguan. Model mental saat ini yang berlaku secara luas itu sederhana dan bisa ditindaklanjuti: jendela sesi bergulir lima jam plus batas mingguan terpisah. Gunakan skrip pembantu kecil untuk menghitung waktu reset dan integrasikan monitor penggunaan ke dalam alur kerja Anda agar batas menjadi bagian yang dapat diprediksi dari ritme rekayasa Anda, bukan kejutan.