Monitor penggunaan Claude Code – pelacak real-time untuk menghindari batas penggunaan

 (github.com/Maciek-roboblog)
12 poin oleh GN⁺ 2025-06-21 | 2 komentar | Bagikan ke WhatsApp
  • Alat pemantauan yang menampilkan berbagai informasi secara real-time di terminal, seperti penggunaan token Claude AI, laju habisnya token, dan prediksi konsumsi
  • Progress bar berwarna yang diperbarui setiap 3 detik, serta prediksi habisnya token yang cerdas
  • Saat melampaui batas paket dasar, alat ini menganalisis riwayat sesi dan langsung beralih ke batas aktual
  • Secara otomatis mendeteksi dan mendukung paket penggunaan seperti Pro/Max5/Max20/custom_max
  • Peringatan real-time saat batas token per sesi mendekati/terlampaui, atau saat ada risiko token habis sebelum reset sesi
  • Antarmuka yang diimplementasikan dan dioptimalkan untuk alur penggunaan Claude yang nyata
  • Mendukung instalasi npm, pip, disarankan menggunakan lingkungan virtual (venv/virtualenv), dan kompatibel dengan Mac/Linux/Windows

Memahami sesi Claude

  • Metode jendela bergulir 5 jam
    • Sesi berlangsung selama 5 jam sejak pesan pertama dikirim
    • Batas diterapkan per sesi, dan beberapa sesi bisa aktif secara bersamaan
    • Reset aktual terjadi setiap 5 jam berdasarkan waktu pesan saya
  • Waktu acuan reset sesi/token bisa ditentukan sesuai jadwal saya

Skenario penggunaan

  • Developer pagi/jam kerja: bisa menyesuaikan jadwal reset token dengan waktu mulai kerja (misalnya pukul 9) untuk perencanaan yang lebih efisien
  • Pekerja malam: bisa memakai reset token yang disesuaikan dengan jadwal pribadi, seperti tengah malam
  • Pengguna dengan batas variabel: mode custom_max secara otomatis mendeteksi batas yang sesuai dengan lingkungan nyata
  • Developer global/remote: berpindah lintas zona waktu, menentukan waktu reset tingkat tim → optimal untuk kolaborasi
  • Cek status cepat: cukup jalankan saja (tanpa tergantung konfigurasi)

Praktik terbaik menyiapkan lingkungan

  • Mulai pemantauan bersamaan dengan dimulainya sesi
    • Jalankan monitor segera saat mulai bekerja dengan Claude (./ccusage_monitor.py)
    • Paket yang didukung
      • pro: sekitar 7.000 token (pengujian dan penggunaan ringan)
      • max5: sekitar 35.000 token (pengembangan harian)
      • max20: sekitar 140.000 token (proyek besar dan penggunaan menengah/berat)
      • custom_max: mode deteksi otomatis (menggunakan nilai maksimum berdasarkan riwayat penggunaan nyata)
    • Meningkatkan akurasi pelacakan total token sepanjang sesi
    • Memungkinkan perhitungan laju konsumsi token dan peringatan dini saat mendekati batas
  • Gunakan lingkungan virtual Python (venv)
    • Mencegah konflik dependensi, memisahkan lingkungan, dan menjamin reproduktibilitas per proyek
    • Instalasi dan eksekusi: 
      python3 -m venv venv  
source venv/bin/activate  
pip install pytz
    • Untuk menghapusnya, cukup hapus folder lingkungan virtual agar pembersihan tetap rapi
  • Daftarkan alias shell kustom
    • Memperpendek perintah berulang menjadi satu baris 
      alias claude-monitor='cd ~/Claude-Code-Usage-Monitor && source venv/bin/activate && ./ccusage_monitor.py'
    • Tambahkan ke .bashrc atau .zshrc, lalu monitor bisa langsung dijalankan hanya dengan satu perintah

Praktik terbaik penggunaan

  • Pantau Burn Rate (laju konsumsi) secara terus-menerus
    • Waspadai jika penggunaan token tiba-tiba melonjak
    • Sesuaikan intensitas kerja berdasarkan sisa waktu dan jumlah token
    • Atur jadwal pekerjaan besar seperti refactor skala besar di sekitar sebelum/sesudah reset sesi (inisialisasi ulang token)
  • Penjadwalan sesi yang strategis
    • Mulai pekerjaan besar tepat setelah reset token, dan kerjakan tugas ringan saat batas mulai dekat 
      ./ccusage_monitor.py --reset-hour 9
    • Manfaatkan aturan 5 jam per sesi untuk menjalankan beberapa sesi yang saling tumpang tindih
  • Tentukan zona waktu secara jelas
    • Mencerminkan jam kerja/kolaborasi yang sebenarnya untuk prediksi reset token dan pengelolaan jadwal yang akurat 
      ./ccusage_monitor.py --timezone Asia/Seoul
    • Mencegah selisih waktu dan meminimalkan kebingungan soal waktu kedaluwarsa sesi saat berkolaborasi lintas negara/tim

Tips optimasi

  • Pengaturan lingkungan terminal
    • Disarankan terminal dengan lebar minimal 80 karakter
    • Dukungan warna memaksimalkan umpan balik visual
    • Disarankan pemantauan terus-menerus di jendela khusus terpisah
  • Integrasi workflow
    • Gunakan terminal multiplexer seperti tmux untuk memantau sambil tetap mengembangkan kode 
      tmux new-session -d -s claude-monitor './ccusage_monitor.py'  
tmux attach -t claude-monitor
  • Strategi multi-sesi
    • Tiap sesi tetap 5 jam, dan beberapa sesi yang tumpang tindih bisa dikelola bersamaan
    • Untuk pekerjaan panjang, distribusikan ke beberapa sesi sambil memperhatikan batas/kedaluwarsa masing-masing sesi

Contoh workflow nyata

  • Pengembangan proyek besar 
    ./ccusage_monitor.py --plan max20 --reset-hour 8 --timezone America/New_York
    • Reset token pukul 8 pagi → mulai pengembangan fitur utama
    • Pukul 10 cek Burn Rate lalu sesuaikan kecepatan kerja
    • Pukul 12 tinjau dan sesuaikan jadwal sore
    • Pukul 14 buka sesi baru, tangani isu yang kompleks
    • Pukul 16 siapkan pekerjaan ringan/sesi malam
  • Penggunaan yang berfokus pada belajar/eksperimen 
    ./ccusage_monitor.py --plan pro
    • Cocok untuk pembelajaran ringan dan penulisan kode eksperimental
  • Pengembangan sprint yang intensif 
    ./ccusage_monitor.py --plan max20 --reset-hour 6
    • Konfigurasi yang disesuaikan untuk pengembangan dengan perkiraan konsumsi token besar dan intensif

Bacaan terkait

2 komentar

 
GN⁺ 2025-06-21
Opini Hacker News

  • Saya merasa frustrasi dengan kurangnya transparansi dari Claude, dan ingin berbagi bahwa saya sangat menyukai ide ini Fitur utama Claude Code adalah kemampuannya mengelola konteks dan batasan lebih baik dibanding aplikasi desktop (misalnya mode compact, menampilkan % kapasitas tersisa), tetapi rasanya masih belum cukup Sebagai masukan tambahan, menurut saya penggunaan emoji yang terlalu banyak di README proyek terasa sangat tidak profesional, dan menimbulkan kekhawatiran seolah proyek ini dikodekan oleh AI hanya berdasarkan "vibe" tanpa pengelolaan yang tepat

    • Saat saya pertama kali masuk ke dunia software, kalau ketahuan memakai emoji di codebase rasanya seperti bakal dikirim ke rumah sakit jiwa Sekarang zaman sudah benar-benar berubah, dan saya jadi sering memakai emoji untuk membantu menyusun konteks secara visual Sekarang kode saya berisi cukup banyak emoji sampai membuat saya senang

    • Akhir-akhir ini gaya emoji seperti ini sering terlihat di startup atau perusahaan yang lebih muda Mungkin pengaruh Notion cukup besar Di perusahaan kami, bahkan saat membuat list, halaman, atau undangan kalender, kami selalu memilih emoji

    • Saya ingin berbagi bahwa rasanya ironis sekali komentar seperti ini muncul pada software yang dibuat untuk AI coding

    • Kalau benar-benar melihat kodenya, ternyata hanya satu file Python 400 baris yang sekadar membungkus ccusage Jadi saya rasa wajar juga kalau ada yang merasa begitu

    • Untuk deskripsi PR atau README yang dibuat AI, saya selalu menambahkan syarat di prompt: "ringkas, tanpa hiasan berlebihan atau emoji" Dengan begitu pesta emoji yang berantakan bisa berubah menjadi dokumentasi yang layak Tentu saja ini bisa berbeda tergantung situasinya

  • Saya adalah pembuat ccusage, dan saya senang melihat orang-orang memakai open source kami dengan berbagai cara Meninggalkan pesan positif: Happy vibe coding!

    • Menariknya, Show HN untuk ccusage sama sekali tidak punya komentar, tetapi thread ini sangat aktif Link thread terkait

  • Sebagai referensi, batas maksimum token sesi saya di masa lalu sekitar 337.492, dan saya memakai paket Max20 serta Opus sekitar 99% Saya telah memakai Claude Code sejak 27 Mei, dengan total 1.374.439.311 token yang digunakan, setara sekitar $3.397

    • Saya memakai paket Max20 dengan penggunaan sekitar $2.100 Saya penasaran apakah API ini memberi margin yang sangat besar, atau justru mereka sedang merugi Saya memakainya setiap hari, tetapi saya tidak merasa memakainya secara berlebihan

    • Saya penasaran apakah Anda sering terkena rate limit di Opus, dan apakah terasa lebih lambat dibanding Sonnet

  • Saya bisa memperkirakan secara intuitif seberapa dekat token yang saya pakai dengan limit Saya juga bisa merasakan saat percakapan itu sendiri tampaknya akan mencapai batas maksimum, dan pada saat itu saya memakai sisa resource terakhir untuk membuat ringkasan lalu melanjutkan pekerjaan di percakapan baru Rasanya alat AI seperti ini sekarang sudah menjadi bagian dari jam biologis saya Setiap hari Rabu limit mingguan ChatGPT di-reset, jadi hari Rabu terasa seperti hari Minggu yang baru

  • Saya mengamati bahwa penggunaan token tidak akan di-reset jika tidak mencapai 100% meskipun jendela waktunya sudah lewat Misalnya, setelah memakai 90% lalu masuk ke window berikutnya, jika sisa 10% itu segera habis maka kita harus menunggu lama

  • Saya membuat UI tool (crystal) yang memungkinkan saya memakai beberapa sesi Claude Code sekaligus Karena saya mengerjakan banyak fitur secara bersamaan, saya sering mencapai batas akun saya Biasanya saya mencapai batas itu mendekati waktu reset, tetapi rasanya akan lebih baik jika bisa tahu lebih awal kapan harus berhenti

    • Saya memakai Claude Code dalam jumlah sangat besar, tetapi saya ragu membuat tooling sendiri untuk worktree dan pekerjaan multi-sesi karena pemahaman saya tentang git belum cukup kuat Sejujurnya saya juga agak takut memakai alat ini, dan idealnya saya ingin menjalankan setiap worktree di container, tetapi rasanya sulit membuatnya berjalan semulus Crystal

    • Saya suka tool ini, tetapi Crystal sudah lama saya kenal sebagai nama bahasa pemrograman, jadi agak membingungkan

    • Jika Anda meninggalkan issue di GitHub (di sini), saya juga bisa mencoba integrasi dengan usage monitor saya

    • Keren sekali Saya juga hampir saja menyuruh Claude membuat tool seperti ini bukan untuk per proyek, melainkan untuk 5 proyek simultan Saya sangat setuju bahwa ada banyak peluang pemanfaatan

  • Sangat menarik, tetapi saya penasaran apakah limit token paket Pro benar-benar hanya 7.000 Artinya bahkan tidak sampai 7.000 kata, tetapi dalam praktiknya rasanya saya bisa memakai jauh lebih banyak Kalau memang segitu, percakapan yang sedikit lebih panjang saja rasanya akan cepat mencapai batas, tetapi saya belum pernah mengalaminya Mungkin ini hanya berlaku untuk Claude Code, Saya belum banyak memakai Claude Code jadi tidak terlalu tahu

    • Paket Pro adalah $20 per bulan. Baru-baru ini akses ke claude code menjadi tersedia Namun saya mendengar beberapa pengguna bisa terkena limit hanya dengan beberapa kueri saja Jadi saya rasa angka seperti itu mungkin benar Limit di antarmuka chat terpisah dari limit di Claude Code

  • Luar biasa sekali, terima kasih sudah membuat ini Apakah bisa dipasang dengan uv? Membagikan tautan uv beserta contoh perintah shell yang merangkum proses instalasi baris demi baris

    • Jika repo tersebut memiliki struktur paket seperti project.toml dan sejenisnya, itu bisa dipasang lebih cepat dengan pipx(pipx) seperti berikut

pipx install git+https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor ccusage_monitor Saya rasa uv juga punya perintah serupa (uvx), tetapi saya tidak yakin apakah fungsi/tujuannya sama dengan pipx

  • Sebagai referensi, hampir semua yang bisa dipasang dengan pip juga bisa dipasang dengan uv, jadi dengan uv pun seharusnya lebih mudah

  • Saya penasaran apakah tool ini punya nilai guna lain selain menjalankan ccusage lewat shell call Sejujurnya proyek seperti ini agak mengecewakan, dan terasa seperti sekali jadi dengan tool AI Di Show HN bahkan tidak disebutkan bahwa semua pekerjaan nyata ditangani oleh tool lain, jadi cukup disayangkan

  • Kemarin saya mengalami pengalaman aneh di Claude Code Saya mencoba mengubah halaman tabel phtml berbasis PHP lama menjadi layout div baru, gagal, lalu menghabiskan sekitar $4 Mungkin ini masalah WSL, tetapi saya berharap hal seperti ini tidak sering terjadi

    • Claude Code punya learning curve yang cukup tinggi Kita perlu menjalankan sesi percakapan panjang dengan mendiskusikan kebutuhan secara cukup mendalam dan mengarahkan model ke pertanyaan yang jelas Meski begitu, kegagalan seperti ini tetap bisa terjadi sesekali, jadi penting untuk mengingat bahwa ini adalah tool yang sangat mahal Ini bukan sihir seperti yang dikatakan para YouTuber atau blogger