Batas Penggunaan Claude Code Dijelaskan: Cara Kerjanya dan Cara Menghindari Mencapainya

Apa Itu Batas Penggunaan Claude Code?

Penggunaan Claude Code diatur oleh dua sistem yang saling tumpang tindih:

• Jendela sesi bergulir 5 jam
• Satu atau lebih batas penggunaan mingguan

Mencapai salah satu dari keduanya akan menyebabkan Anda terkena pembatasan laju.

Jendela bergulir 5 jam

Batas laju Claude Code yang paling terlihat adalah jendela bergulir 5 jam. Jendela Anda dimulai ketika Anda mengirim prompt pertama. Semua yang Anda lakukan selama lima jam berikutnya menarik dari pool penggunaan yang sama. Pool ini dibagikan antara Claude Code dan chat Claude, yang berarti aktivitas di satu tempat memengaruhi yang lain.

Contohnya:

• Prompt pertama: 09.00
• Jendela berakhir: 14.00

Jika Anda menghabiskan penggunaan yang tersedia pada pukul 10.30, akses dijeda hingga jendela disetel ulang pada pukul 14.00.

Kesalahpahaman umum adalah memulai percakapan baru akan menyetel ulang penggunaan. Tidak. Perintah /clear hanya memulai konteks percakapan yang baru. Perintah ini tidak memulihkan alokasi penggunaan atau menyetel ulang pengatur waktu 5 jam.

Batas mingguan

Selain batas sesi berbasis waktu, Claude Code juga memberlakukan batas mingguan. Bahkan jika Anda masih memiliki ruang tersisa dalam sesi saat ini, mencapai batas mingguan dapat sementara mencegah penggunaan lebih lanjut hingga penyetelan ulang mingguan terjadi. 

Pikirkan seperti ini: batas 5 jam membatasi waktu penggunaan Anda, dan batas mingguan membatasi total volume penggunaan Anda.

Artinya, Anda bisa saja memiliki kapasitas tersisa dalam sesi 5 jam saat ini tetapi tetap terblokir karena Anda telah menghabiskan alokasi mingguan. Bagi sebagian besar pengguna Pro, perbedaan ini cukup mudah. Namun, paket Max menambahkan lapisan kompleksitas tambahan.

Batas mingguan Sonnet untuk pengguna Max

Anthropic saat ini menerapkan batas berikut untuk paket Max:

• Batas mingguan yang mencakup semua model
• Batas mingguan terpisah khusus untuk penggunaan Sonnet

Pembedaan ini penting karena Anda mungkin masih memiliki kapasitas Sonnet yang tersedia meskipun alokasi model yang lebih luas sudah habis, atau sebaliknya. 

Sebagai contoh, bayangkan Anda menghabiskan sebagian besar minggu menggunakan Sonnet untuk pekerjaan implementasi. Anda bisa menghabiskan alokasi mingguan khusus Sonnet sementara masih memiliki kapasitas tersisa dalam alokasi mingguan keseluruhan. Pada saat itu, Anda mungkin perlu beralih ke model lain, menunggu penyetelan ulang Sonnet, atau meningkatkan paket, bergantung pada sisa batas Anda.

Kebalikannya juga bisa terjadi. Jika Anda banyak menggunakan Opus sepanjang minggu, Anda mungkin mencapai batas mingguan keseluruhan meskipun alokasi khusus Sonnet belum sepenuhnya terpakai. Karena batas keseluruhan adalah batas payung, mencapainya mencegah penggunaan lebih lanjut apa pun sebanyak apa pun kapasitas Sonnet yang tersisa.

Agar permintaan Sonnet berhasil, kedua kondisi berikut harus benar:

• Anda masih memiliki ruang dalam batas mingguan keseluruhan.
• Anda masih memiliki ruang dalam batas mingguan Sonnet.

Permintaan Opus, di sisi lain, hanya mengonsumsi pool mingguan keseluruhan karena tidak ada alokasi khusus Opus yang terpisah. Inilah mengapa halaman Usage di Claude.ai sangat penting. Halaman tersebut menampilkan setiap batas mingguan secara terpisah beserta waktu penyetelannya, sehingga jauh lebih mudah memahami batas mana yang sedang Anda dekati sebelum sesi ngoding panjang. 

Penggunaan Claude Code berdasarkan Paket

Salah satu tantangan saat membandingkan paket adalah Anthropic tidak lagi menerbitkan "jumlah prompt" sederhana.

Sebagai gantinya, paket dijelaskan menggunakan pengali kapasitas relatif. Pengali ini mencerminkan kapasitas penggunaan yang Anda terima relatif terhadap baseline paket Pro. Tidak mudah mendapatkan angka pastinya; beberapa pengguna melacak penggunaan mereka sebagai persentase untuk mendapatkan gambaran yang layak tentang berapa banyak token yang telah mereka gunakan per persentase kapasitas. 

Perubahan batas penggunaan Mei 2026

Anthropic memperluas kapasitas Claude Code pada Mei 2026 dengan menggandakan batas penggunaan langganan dan menghapus pengurangan pada jam sibuk yang sebelumnya memengaruhi pelanggan Pro dan Max. Alih-alih menerbitkan jumlah prompt tetap, Anthropic kini menyatakan perbedaan paket sebagai pengali kapasitas relatif karena penggunaan aktual bergantung pada pilihan model, ukuran konteks, dan penggunaan alat.

Sejak saat itu, Anthropic sesekali menyesuaikan batas mingguan melalui promosi sementara. Misalnya, selama peluncuran Claude Fable 5, batas mingguan Claude Code ditingkatkan sebesar 50% untuk pelanggan yang memenuhi syarat. Karena peningkatan promosi ini bersifat sementara, pembaca sebaiknya selalu memeriksa batas terbaru di dasbor Claude Usage sebelum merencanakan beban kerja yang berjalan lama.

Kredit Agent SDK (Juni 2026)

Rencana untuk memisahkan sesi coding interaktif dari beban kerja agen otomatis menimbulkan beberapa kebingungan pada Juni 2026.

Sebelum 15 Juni, semua aktivitas Claude Code diambil dari pool langganan yang sama. Baik Anda mengobrol secara interaktif di terminal, menjalankan GitHub Action, atau memanggil claude -p di dalam pipeline CI, semuanya bersaing pada batas 5 jam dan mingguan yang sama.

Anthropic berencana mulai memisahkan beban kerja ini pada 15 Juni 2026, tetapi menghentikan perubahan tersebut pada hari peluncuran. Ini berarti penggunaan interaktif dan penggunaan terprogram (Agent SDK, claude -p, GitHub Actions) masih diambil dari pool langganan yang sama seperti sebelumnya.

Per Juli 2026, belum ada kredit Agent SDK terpisah yang aktif, dan tidak ada kredit opsi ikut serta yang dapat diklaim.

Apa yang Sebenarnya Menguras Kuota Anda?

Banyak pengembang berfokus pada penggunaan prompt dan penyetelan token. Pelakunya yang sebenarnya sering kali adalah konteks. Setiap interaksi memuat jauh lebih banyak informasi daripada pertanyaan yang Anda ketik.

CLAUDE.md dan File Aturan

Claude Code memuat instruksi secara otomatis dari:

• CLAUDE.md

• File CLAUDE.md di direktori induk

• Referensi impor @

• File .claude/rules/*.md

Semua konteks dan instruksi tambahan ini berulang kali disertakan dalam permintaan. Ini berarti file aturan yang membengkak diam-diam meningkatkan konsumsi token sepanjang sesi. Anthropic merekomendasikan untuk menjaga setiap file CLAUDE.md tetap di bawah sekitar 200 baris.

Untuk proyek yang lebih besar, pertimbangkan membagi instruksi menjadi aturan terlingkup yang menggunakan frontmatter paths sehingga hanya dimuat saat relevan. Jika Anda ingin pendalaman lebih jauh, panduan menulis file CLAUDE.md terbaik kami membahas strategi organisasi yang efektif.

Definisi alat MCP

Server Model Context Protocol (MCP) adalah sumber overhead tersembunyi lainnya. Setiap server MCP yang terhubung menyuntikkan skema alat ke konteks Claude, bahkan jika Anda tidak pernah menggunakan alat tersebut.

Bayangkan:

• 5 server MCP
• 10 alat per server

Itu berarti 50 definisi alat disertakan pada setiap permintaan. Memutuskan koneksi server MCP yang tidak digunakan adalah salah satu cara termudah untuk mengurangi konsumsi token Claude Code.

Satu peringatan penting: hindari menambah atau menghapus server MCP selama sesi aktif. Melakukannya akan menginvalidasi prefiks cache prompt dan dapat meningkatkan biaya penggunaan.

Memori otomatis

Sejak Claude Code v2.1.59, memori otomatis diaktifkan secara default. Memori adalah pengetahuan global yang disimpan Claude selama berbagai sesi, yang memberinya lebih banyak konteks. Ini bisa berupa metode untuk menarik data dari database hingga detail teknis yang telah diimplementasikan.

Saat startup, Claude memuat konten dari MEMORY.md, hingga:

• 200 baris pertama
• 25 KB pertama

Untuk beberapa alur kerja, ini berguna. Untuk lainnya, ini hanya konteks tambahan.

Anda dapat menonaktifkan memori otomatis dengan beberapa cara. Untuk sakelar pemutus permanen yang menimpa semua pengaturan lain (berguna di pipeline CI dan lingkungan otomatis), setel variabel lingkungan di shell Anda:

export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1

Sebagai alternatif, tambahkan yang berikut ke settings.json Anda. Gunakan ~/.claude/settings.json untuk menonaktifkannya di semua proyek, atau .claude/settings.json untuk satu proyek saja:

{ "autoMemoryEnabled": false }

Jika Anda tidak secara aktif menggunakan file memori, menonaktifkan fitur ini dapat mengurangi ukuran konteks dasar.

Riwayat percakapan dan pencarian

Riwayat percakapan terus bertambah. Setiap hasil alat, pembacaan file, output grep, perintah terminal, dan pencarian kode menjadi bagian dari konteks sesi.

Berdasarkan pengalaman saya, eksplorasi repositori sering kali menjadi kontributor terbesar. Claude mungkin membaca puluhan file hanya untuk menemukan satu fungsi. File-file tersebut tetap tersedia dalam konteks dan terus menambah overhead token untuk giliran berikutnya.

Untuk alur kerja otomatis, claude -p --bare dapat mengurangi banyak overhead tetap ini dengan menghapus konteks sesi yang tidak diperlukan. Ini dapat menghemat banyak kredit Agent SDK bulanan yang sebaliknya akan terkuras saat Claude menelusuri file.

Cara Memeriksa Penggunaan Claude Code Anda

Waktu terbaik untuk memeriksa penggunaan adalah sebelum sesi ngoding panjang. Dengan begitu, Anda bisa menyadari seberapa dekat Anda dengan batas sebelum benar-benar mulai ngoding.

Menggunakan /usage

Di dalam Claude Code, mengetik /usage akan menampilkan:

• Konsumsi sesi
• Konsumsi mingguan
• Alokasi yang tersisa

Ini adalah cara yang baik untuk mendapatkan gambaran seberapa banyak kuota yang tersisa dalam sesi interaktif Anda, sehingga Anda bisa merencanakan ke depan. Mencoba memulai tugas besar yang kompleks tepat sebelum mencapai batas mungkin kurang bijak, tetapi tugas sederhana seperti pembersihan file mungkin merupakan pemanfaatan yang baik untuk kuota tersisa.

Menggunakan /status

Anda juga dapat menjalankan /status, yang menyediakan informasi berikut:

• Paket saat ini
• Informasi akun
• Status penggunaan aktif

Mengetahui paket dan status aktif membantu Anda memahami potensi pembatasan. Penting apakah penggunaan Anda 5x atau 20x dari baseline.

Memeriksa dasbor Claude

Tampilan paling lengkap ada di Settings → Usage di Claude.ai.

Dasbor ini menggabungkan:

• Penggunaan chat Claude
• Penggunaan Claude Code
• Jadwal penyetelan ulang mingguan
• Batas khusus model

Karena beberapa batas dapat ada secara bersamaan, dasbor ini harus dianggap sebagai sumber kebenaran. Kebiasaan praktis adalah memeriksa penggunaan sebelum memulai pekerjaan refactoring besar, sesi debugging panjang, atau tugas coding otonom.

Cara Memaksimalkan Batas Claude Code Anda

Mari bahas bagaimana kita dapat memperpanjang batas penggunaan tanpa meningkatkan paket. Terkadang, kita bisa mendapatkan kapasitas yang jauh lebih efisien hanya dengan mengurangi overhead.

Rapikan CLAUDE.md Anda

Usahakan kurang dari 200 baris per file untuk meminimalkan jumlah konteks yang Anda kirim dan kebingungan yang Anda sebabkan pada agen.  Carilah hal-hal berikut:

• Instruksi proyek yang sudah usang
• Catatan historis
• Aturan yang seharusnya ada di prompt individual

Jika instruksi hanya penting untuk direktori tertentu, gunakan aturan terlingkup dengan frontmatter paths, sehingga tidak semua aturan Anda digunakan terus-menerus dan hanya pada jalur tertentu. Anda juga bisa memiliki file CLAUDE.md tingkat proyek alih-alih yang global.

Audit server MCP Anda

Pertahankan hanya server MCP yang benar-benar Anda gunakan. Setiap server yang terhubung menambah overhead skema pada setiap interaksi. Perlakukan konfigurasi MCP Anda seperti tab browser. Jika Anda tidak menggunakannya sekarang, tutup.

Salah satu cara yang baik untuk mengelola server MCP adalah memasangnya pada level proyek ketika Anda tahu hanya membutuhkan MCP tertentu untuk proyek tertentu, bukan pada level pengguna. Dengan begitu, Claude tidak mencoba memuatnya di setiap proyek atau setiap sesi, hanya saat Anda membutuhkannya untuk kasus penggunaan tertentu.

Gunakan /compact sejak awal

Perintah /compact meringkas riwayat percakapan dan mengurangi biaya token di masa depan. Dengan mengurangi pertumbuhan konteks yang diproses pada setiap giliran, kita mengurangi penggunaan kuota. 

Meskipun tidak memulihkan kuota yang sudah terpakai, fitur ini bisa membantu jika Anda menggunakan /compact sebelum sesi menjadi terlalu besar. 

Sesuaikan model dengan tugas

Tidak setiap tugas memerlukan Opus atau Fable. Terkadang, model yang lebih kecil atau penggunaan model yang cermat dapat membantu mengelola kuota. Anda sering kali bisa meningkatkan kapasitas yang tersedia secara signifikan dengan menyisihkan model premium untuk pekerjaan bernilai tinggi. 

Berikut beberapa strategi optimalisasi model:

• Gunakan Opus untuk keputusan arsitektur, penalaran kompleks, dan kebutuhan yang ambigu
• Sonnet untuk pengeditan, pencarian, dan pekerjaan implementasi
• Haiku untuk tugas ringan dan pembacaan cepat

Namun hindari sering berganti model dalam satu sesi. Cache prompt bersifat spesifik model, jadi setiap kali berganti memaksa model baru memproses ulang seluruh riwayat percakapan dari awal dengan biaya token penuh, alih-alih membacanya secara murah dari cache. Ini bisa menguras kuota Anda lebih cepat daripada tetap pada satu model, bahkan saat Anda beralih ke model yang "lebih murah".

Saat Mentok: Fallback ke API

Jika batas kuota langganan menjadi hambatan, Claude API menyediakan alternatif. Penggunaan API tidak membatasi Anda pada jendela sesi 5 jam atau batas langganan mingguan. Sebagai gantinya, Anda membayar berdasarkan konsumsi token.

Model ini sering masuk akal untuk:

• Pipeline CI
• Agen otonom yang berjalan lama
• Automasi skala besar
• Alur kerja produksi dengan anggaran yang dapat diprediksi

Satu hal yang perlu diwaspadai adalah membiarkan variabel lingkungan ANTHROPIC_API_KEY terkonfigurasi di shell Claude Code Anda. Jika kunci itu ada di lingkungan Anda, Claude Code dapat melakukan autentikasi melalui API alih-alih akun langganan Anda.

Ini dapat mengakibatkan biaya API yang tidak terduga, karena Anda tidak lagi menggunakan batas langganan dan malah membayar biaya token. Kapan pun biaya terlihat tidak biasa, memeriksa pengaturan autentikasi sebaiknya menjadi salah satu langkah pemecahan masalah pertama Anda.

Untuk harga model terkini, selalu rujuk dokumentasi harga resmi Anthropic, karena tarif sering berubah dan bervariasi menurut model.

Pemikiran Akhir

Batas penggunaan Claude Code lebih mudah dikelola setelah Anda memahami bahwa batas tersebut tidak sekadar menghitung prompt.

Sistem ini menggabungkan:

• Jendela bergulir 5 jam
• Batas mingguan
• Alokasi khusus model
• Overhead konteks

Kejutan terbesar bagi banyak pengembang adalah bahwa prompt sering kali merupakan minoritas dari total penggunaan token. File CLAUDE.md besar, definisi alat MCP, memori otomatis, penelusuran repositori, dan riwayat percakapan yang terus bertambah sering kali menghabiskan lebih banyak kapasitas daripada pertanyaannya sendiri.

Dalam praktiknya, kebanyakan orang yang mencapai batas secara tidak wajar cepat memiliki masalah konfigurasi, bukan masalah kapasitas. Sebelum meningkatkan paket, kurangi overhead dengan merapikan konteks alih-alih membeli kuota yang lebih besar.

Untuk terus meningkatkan alur kerja Anda, saya merekomendasikan panduan kami tentang praktik terbaik Claude Code dan tutorial Claude Code Hooks, yang keduanya membahas teknik untuk membuat Claude Code lebih efisien dan tangguh selama sesi pengembangan yang panjang.