Pengembang yang menggunakan Claude Code — alat pengkodean agen Anthropic — sering kali menemui batasan: "Batas penggunaan Claude telah tercapai. Batas Anda akan direset pukul 7 (Asia/Tokyo)." Pesan tersebut menimbulkan pertanyaan: apa sebenarnya yang dimaksud dengan pengaturan ulang, kapan akan terjadi, dan bagaimana Anda harus mengubah kode atau infrastruktur Anda agar tidak terjadi hal-hal tak terduga?
Jika produk atau pipeline CI Anda bergantung pada Claude Code untuk pemformatan, pembuatan pengujian, atau peninjauan kode sesuai permintaan, batasan yang tidak terduga dapat mengganggu alur kerja. Mengetahui apakah batasan tersebut berupa 429 jangka pendek (detik-menit), pengaturan ulang sesi (jam), atau batas mingguan (hari) memungkinkan Anda memutuskan apakah akan mencoba lagi, menurunkannya secara bertahap, atau menjadwalkan pekerjaan nanti.
Apa itu Claude Code?
Kode Claude adalah produk pengkodean Anthropic yang berfokus pada pengembang dan terintegrasi langsung ke dalam alur kerja pengembang: terminal, CI, kontrol versi, dan IDE. Produk ini dirancang untuk melakukan pengeditan multi-file, memilah masalah, menjalankan pengujian, dan mengotomatiskan tugas kode — pada dasarnya merupakan kolaborator agen yang ada di CLI dan perkakas Anda. Produk ini tersedia sebagai bagian dari keluarga produk Claude (web, API, dan Kode), dirancang untuk mempercepat tugas pemrograman (pembuatan kode, refaktor, penjelasan, pembuatan pengujian, debugging) dengan memungkinkan pengembang memanggil model Claude langsung dari editor atau terminal, seringkali dengan pintasan dan perilaku prasetel model yang dioptimalkan untuk perintah yang banyak kodenya. Selain itu, produk ini menampilkan perintah CLI interaktif (seperti /config, /status) dan API administratif untuk organisasi.
Perbedaan utama vs. API Claude umum:
- Claude Code berorientasi pada alur kerja pengembang (semantik sesi/agen, baris status, pengaturan tingkat proyek), sementara API Pesan/Penyelesaian adalah titik akhir inferensi terprogram tujuan umum.
- Organisasi dapat menggunakan API Admin/Penggunaan untuk mengambil laporan penggunaan Kode Claude harian (berguna untuk dasbor dan alokasi biaya).
Daftar periksa fitur cepat
- Integrasi Terminal/VS Code untuk alur kerja yang mengutamakan kode.
- Peralihan model otomatis atau manual (Opus ↔ Sonnet) untuk pertukaran biaya/throughput.
- Akuntansi penggunaan dan batasan per sesi untuk mencegah satu pengguna memonopoli kapasitas.
- Perbedaan tingkatan paket (Gratis / Pro / Max / Tim / Perusahaan) yang mengubah alokasi dan perilaku.
Kapan penggunaan Kode Claude diatur ulang?
Jawaban singkatnya: tergantung pada rencana Anda — tetapi aturan paling penting dan praktis yang perlu diingat hari ini adalah Penggunaan berbasis sesi di Claude Code diatur oleh jendela lima jam bergulir yang dimulai saat Anda mulai menggunakan sesi tersebut, dan batasan mingguan yang lebih luas dilacak secara terpisah.
Baik paket Pro maupun Max menawarkan batas penggunaan untuk Claude Code. Jumlah pesan yang dapat Anda kirim bergantung pada panjang pesan, durasi percakapan, dan jumlah lampiran, sementara penggunaan Claude Code bergantung pada kompleksitas proyek, ukuran basis kode, dan pengaturan penerimaan otomatis. Menggunakan model komputasi intensif akan mempercepat Anda mencapai batas penggunaan.
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, ini berarti waktu untuk alokasi 5 jam Anda dimulai saat Anda mengirim permintaan pertama dalam suatu sesi — bukan pada tengah malam, dan tidak disinkronkan dengan batas kalender. Ketika Anda mencapai batas sesi, Anda akan melihat pesan "batas penggunaan tercapai" dan waktu dimulainya jendela sesi berikutnya.
Batasan tingkat API dan organisasi: pengisian ulang berkelanjutan
Untuk konsumen API dan integrator di seluruh organisasi, Anthropic mengimplementasikan batas kecepatan token-bucket dan batas pengeluaran. Batas tarif ini adalah terus diisi ulang (tidak hanya pada batas waktu lima jam yang terpisah) dan dilaporkan melalui header respons seperti anthropic-ratelimit-requests-remaining, anthropic-ratelimit-tokens-remaining, dan yang sesuai -reset Stempel waktu. Untuk klien API, header ini adalah sumber resmi kapan Anda dapat melanjutkan aktivitas berat.
Batasan mingguan dan perubahan “pengguna daya”
Pada pertengahan tahun 2025, Anthropic memperkenalkan batas penggunaan mingguan tambahan (jendela 7 hari) untuk mengekang eksploitasi latar belakang yang berkelanjutan oleh pengguna Claude Code yang aktif. Batas mingguan ini terpisah dari perilaku sesi lima jam dan token-bucket: jika Anda menghabiskan batas mingguan, penantian singkat selama lima jam tidak akan memulihkan kemampuan Anda untuk menggunakan fitur atau model tertentu hingga jendela 7 hari tersebut direset (atau Anda membeli kapasitas tambahan jika tersedia).
Antropik menegakkan batas penggunaan mingguan (alokasi bergulir 7 hari) untuk Claude Code pada paket berbayar. Batas mingguan tersebut dinyatakan sebagai perkiraan jam penggunaan Kode Claude per model (Sonnet vs Opus) dan bervariasi berdasarkan paket dan tingkatan.
Pro vs Max (tingkatan konsumen): Apa perbedaan praktisnya?
Pengguna Opus berat dengan basis kode besar, atau mereka yang menjalankan beberapa instans Claude Code secara paralel, akan mencapai hambatan kinerja lebih cepat.
Paket Pro ($20/bulan):
- Sidang: ~45 pesan setiap lima jam, atau ~10–40 perintah Kode Claude setiap lima jam.
- Mingguan: ~ 40–80 jam of Soneta 4 (Rencana Pro umumnya tidak mendukung Opus di Claude Code).
Maksimal 5× ($100/bulan):
- Sidang: ~225 pesan setiap lima jam, atau ~50–200 perintah Kode Claude setiap lima jam.
- Mingguan: ~ 140–280 jam of Soneta 4 dan ~ 15–35 jam of Opus 4 (Opus tersedia di Max).
Maksimal 20× ($200/bulan):
- Sidang: ~900 pesan setiap lima jam, atau ~200–800 perintah Kode Claude setiap lima jam.
- Mingguan: ~ 240–480 jam of Soneta 4 dan ~ 24–40 jam of Opus 4.
Situasi konkret dan apa arti “reset” pada umumnya
1. Anda menerima 429 dengan retry-after
- Apa yang terjadi: Anda mencapai batas permintaan/nilai token.
- Apa yang diharapkan:
retry-afterheader memberi tahu Anda berapa detik untuk menunggu; respons Anthropic juga mengaturanthropic-ratelimit-*-resetHeader yang berisi stempel waktu RFC3339 untuk pengisian ulang yang presisi. Gunakan header ini untuk penjadwalan percobaan ulang yang presisi.
2. Sesi Kode Claude Interaktif menampilkan "Mendekati batas 5 jam / direset pukul 7"
- Yang terjadi: sesi interaktif Anda menghabiskan alokasi jangka pendeknya. Secara historis, sesi memiliki perilaku jendela "5 jam" yang praktis dan UI sering kali membulatkan waktu reset ke waktu jam yang rapi. Waktu yang ditampilkan mungkin lokal untuk akun atau UI Anda, dan pengguna telah melaporkan bahwa waktu tersebut merupakan perkiraan (tidak selalu merupakan stempel waktu RFC3339 yang tepat). Anggap waktu UI tersebut sebagai panduan; gunakan metode terprogram untuk akurasi jika memungkinkan.
3. Anda mencapai batas Opus/model mingguan
- Apa yang terjadi: Anda atau organisasi Anda menghabiskan jatah mingguan untuk model tertentu (misalnya, Opus 4).
- Yang perlu diantisipasi: Batas mingguan hanya akan terisi kembali setelah periode tujuh hari berakhir. Menunggu pengaturan ulang per jam atau menit tidak akan memulihkan kapasitas mingguan. Anthropic mengumumkan batas tarif mingguan untuk beberapa pelanggan mulai 28 Agustus 2025; pelanggan Max memiliki opsi untuk membeli penggunaan tambahan jika diperlukan.
4. Anda mencapai batas pengeluaran bulanan Anda
- Apa yang terjadi: organisasi Anda mencapai batas pengeluaran bulan kalender yang ditetapkan.
- Yang perlu diperhatikan: akses dibatasi hingga bulan kalender berikutnya (atau hingga Anda meningkatkan batas pengeluaran/deposit). Hal ini diberlakukan untuk mencegah pengeluaran berlebih yang tidak terduga.
Catatan anomali dunia nyata: Terdapat laporan bug terbuka yang menjelaskan kasus-kasus di mana UI melaporkan waktu reset, tetapi kuota tidak benar-benar diperbarui pada waktu yang ditentukan — terkadang memengaruhi pengalaman web vs. CLI secara berbeda. Jika otomatisasi Anda bergantung pada reset, pertimbangkan 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 melakukan pengaturan ulang untuk menghindari gangguan pekerjaan. Berikut adalah pola kode praktis yang dapat Anda masukkan ke dalam alat produksi untuk mendeteksi pengaturan ulang, bereaksi dengan aman, dan menjaga metrik.
1) Gunakan header respons dari API Pesan untuk menjadwalkan percobaan ulang
Ketika Anda memukul 429Antropik menyertakan header yang menunjukkan sisa kapasitas dan stempel waktu reset yang tepat. Contoh Python ini menunjukkan cara membaca anthropic-ratelimit-requests-reset dan jatuh kembali ke Retry-After saat hadir:
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: bacaan anthropic-ratelimit-*-reset memberi Anda stempel waktu RFC3339 untuk kapan bucket diharapkan diisi ulang; retry-after berwenang untuk segera membatalkan.
2) Periksa penggunaan secara terprogram (tingkat organisasi) — Laporan Penggunaan Admin (cURL)
Anthropic menampilkan titik akhir "Laporan Penggunaan" Admin yang menampilkan metrik Claude Code per hari untuk organisasi. Catatan: Kunci API Admin diperlukan dan API ini ditujukan untuk organisasi (bukan akun pribadi perorangan). 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 (komit, baris kode, token, perkiraan biaya, dll.) — berguna untuk dasbor dan rekonsiliasi penagihan.
3) Gunakan Claude Code CLI /status dan integrasi statusline untuk perkakas lokal
CLI Claude Code mengekspos perintah slash dan /status (atau terkait) perintah untuk melihat alokasi interaktif yang tersisa; Anda juga dapat mengonfigurasi baris status kustom (/statusline) atau gunakan .claude/settings.json untuk menampilkan statistik penggunaan di prompt shell Anda.
Taktik praktis apa yang mengurangi gesekan kuota?
1. Mulailah sesi dengan cerdas
Mulailah perencanaan yang matang atau langkah generatif tepat setelah pengaturan ulang. Jika Anda mengharapkan sesi yang panjang, jadikan itu "permintaan pertama" Anda untuk menetapkan rentang waktu lima jam yang baru.
2. Gunakan peralihan model secara strategis
Opus memang kuat, tetapi mahal dalam hal alokasi; Soneta lebih murah. Gunakan /model di awal sesi atau mengandalkan peralihan otomatis untuk memperpanjang waktu aktif dalam satu periode. Banyak pengguna paket Max mengonfigurasi ambang batas peralihan otomatis untuk memaksimalkan waktu aktif.
3. Berkoordinasi dengan rekan satu tim
Jika beberapa rekan satu tim mencapai batas mingguan yang sama yang dikumpulkan dalam satu tim atau organisasi, koordinasikan pelaksanaan yang berat (misalnya, uji performa, refaktor besar) untuk menghindari konsumsi yang tumpang tindih.
4. Gunakan API atau bayar sesuai pemakaian untuk burst
Jika Claude Code mencapai kuota UI lokal, pertimbangkan untuk menggunakan API/konsol Claude dengan kredit bayar sesuai pemakaian untuk burst yang sensitif terhadap waktu (periksa paket Anda untuk melihat apakah ini tersedia dan hemat biaya).
Pengembang dapat mengakses Claude Soneta 4.5 API dan Claude Opus 4.1 API dll melalui CometAPI, versi model terbaru selalu diperbarui dengan situs web resmi. Untuk memulai, jelajahi kemampuan model di tempat bermain dan konsultasikan Panduan API untuk petunjuk terperinci. Sebelum mengakses, pastikan Anda telah masuk ke CometAPI dan memperoleh kunci API. API Komet menawarkan harga yang jauh lebih rendah dari harga resmi untuk membantu Anda berintegrasi.
Siap untuk berangkat?→ Daftar ke CometAPI hari ini !
Jika Anda ingin mengetahui lebih banyak tips, panduan, dan berita tentang AI, ikuti kami di VK, X dan Discord!
Kesimpulan
Memahami kapan penggunaan Claude Code direset sangatlah penting — hal ini memengaruhi cara Anda merencanakan sesi coding, cara Anda menganggarkan sumber daya langganan, dan cara Anda merespons interupsi. Model mental yang berlaku luas saat ini sederhana dan dapat ditindaklanjuti: jendela sesi bergulir lima jam ditambah batasan mingguan terpisahGunakan skrip pembantu kecil untuk menghitung waktu reset dan integrasikan monitor penggunaan ke dalam alur kerja Anda sehingga batasan menjadi bagian yang dapat diprediksi dari ritme rekayasa Anda, alih-alih menjadi kejutan.
