Penggunaan Token Claude Code dan Codex: Apa yang Dibaca Token Meter

Apa yang Ditampilkan Token Meter

Begitu ada agent terpasang atau kunci akun tersimpan yang bisa ditampilkan, Token Meter berada di kelompok tombol sisi kanan title bar dan tetap di sana selama app terbuka, jadi Anda tidak perlu membuka panel untuk mencarinya.

Bar-nya hanya memuat satu angka: kuota paling ketat dari semua yang ada, diberi warna sesuai seberapa dekat batasnya. Jika provider yang sudah Anda atur tidak ada yang menyediakan kuota, chip menampilkan total token 5 jam milik Claude Code, atau milik Codex jika Claude Code tidak terpasang. Tanpa agent terpasang dan hanya dengan saldo akun, chip menampilkan saldo USD terendah.

Klik chip untuk melihat ringkasan. Setiap provider yang sudah Anda atur mendapat satu baris dua bagian: nama dan waktu reset yang relevan di bagian atas, lalu di bagian bawah bar 5 jam dan mingguan jika batasnya diketahui, atau pengeluaran dan token hari ini jika tidak. Provider yang Anda sematkan di Pengaturan → Token Meter ditampilkan paling atas (Claude Code secara default; bisa juga tidak ada yang disematkan).

Buka satu baris untuk melihat detail lengkap agent itu. Isinya token yang dipakai dalam 5 jam dan 7 hari terakhir, disingkat dengan K, M atau B, ditambah sparkline 24 jam terakhir dengan satu bar per jam. Tile biaya menampilkan estimasi biaya hari ini dan 7 hari terakhir pada tarif API, beserta tanggal tabel harga terakhir diperbarui.

Rincian 7 hari mencakup fresh input, output, cache write, cache read, dan jumlah turn. Semua angka itu diperbarui di latar belakang sekitar sekali per menit.

Sebuah agent hanya muncul jika terpasang, artinya folder transkripnya ada. Tanpa agent lokal dan tanpa kunci akun tersimpan, meter tidak menampilkan apa pun, bukan gauge kosong. Gauge yang menunjuk nol menyatakan Anda belum memakai apa pun, dan itu tidak sama dengan tidak tahu.

Agent yang Dibaca Token Meter dari Disk

Untuk jumlah token, Token Meter hanya punya satu sumber: transkrip yang disimpan tiap agent di disk Anda. Claude Code, Codex, Gemini CLI, dan omp mencatat jumlah token setiap turn di transkripnya. Meter tidak memanggil API provider dan tidak meminta Anda masuk. Tidak ada API key yang perlu ditempel dan tidak ada akun yang perlu dihubungkan, dan untuk jumlah token tidak ada yang dikirim ke mana pun.

Daftarnya empat nama karena meter membaca folder transkrip Claude Code, Codex, Gemini CLI, dan omp. Meter tidak membaca OpenCode, jadi tidak menampilkan apa pun untuk agent itu, bukan menebak.

Versi 1.0.22 menambahkan sumber kedua yang terpisah dan bukan transkrip. Tempel API key di Pengaturan → Token Meter untuk salah satu dari enam provider akun dan masing-masing mendapat barisnya sendiri, berisi apa yang dilaporkan provider itu dari endpoint-nya: saldo, kuota paket atau pengeluaran. Itu pengukuran yang berbeda dengan catatan yang berbeda. Baca perbedaan antara usage dan saldo sebelum menganggap angka-angka ini bisa saling menggantikan.

Kenapa Cache Read Punya Baris Sendiri

Sebagian besar token dalam sesi agent yang panjang adalah cache read: konteks yang sudah pernah dikirim agent, disajikan kembali dari cache provider pada setiap turn baru. Jika dihitung bersama yang lain, cache read membuat sesi tampak jauh lebih besar dari sebenarnya.

Dengan baris sendiri, cache read tidak menenggelamkan angka lain, dan Anda bisa melihat berapa total token sesi di luar cache read.

Yang Tidak Ditampilkan

Secara default Token Meter melaporkan pemakaian: token yang sudah terpakai. Token Meter tidak memprediksi seberapa banyak lagi yang bisa Anda jalankan. Transkrip Claude Code tidak mencatat status langganan, jadi persentase Claude butuh sumber lain. File sesi Codex memuat angka rate limit-nya, tetapi hanya sesegar turn Codex terakhir Anda. Kini dua switch opt-in menyediakan angka langsung untuk masing-masing.

Untuk Claude, 1.0.21 menambahkan Batas paket, yang hanya berfungsi di macOS. Aktifkan di Pengaturan → Token Meter. App lalu membaca sign-in Claude Code yang tersimpan dari Keychain macOS lewat tool security bawaan sistem, sehingga macOS tidak bertanya setiap kali. App mengambil pemakaian paket Anda yang sebenarnya dari api.anthropic.com, paling sering sekali setiap lima menit.

Untuk Codex, 1.0.22 menambahkan Batas Codex langsung. Fitur ini membaca sign-in ChatGPT milik Codex dari ~/.codex/auth.json dan mengirimkannya hanya ke chatgpt.com untuk mengambil jendela 5 jam dan mingguan saat ini.

Fitur ini dirancang hanya untuk membaca file itu. Token yang kedaluwarsa tidak memicu permintaan apa pun dan meminta Anda menjalankan codex. Sign-in yang disimpan di keychain sistem tidak dibaca sama sekali. Kedua switch nonaktif sampai Anda mengaktifkannya.

Hanya Codex yang sudah punya angka itu, bahkan saat switch-nya nonaktif. CLI Codex sendiri menulis angka rate limit paket ke file sesinya, jadi meter membacanya dari baris yang sama dengan yang sudah dipindainya. Angka itu hanya sesegar turn Codex terakhir Anda, dan itulah alasan switch langsung ada.

Angka 5 jam dan 7 hari adalah rentang waktu yang dihitung mundur dari sekarang. "Dipakai dalam 5 jam terakhir" persis seperti arti angkanya, dan angka itu tidak menyatakan apa pun tentang batas yang diberikan paket Anda.

Untuk Siapa

Token Meter dibuat untuk Anda yang menjalankan Claude Code dan Codex berdampingan, di split pane atau bersama di Control Room (sebelumnya War Room). Token Meter menunjukkan mana yang menghabiskan token tanpa perlu pindah ke salah satu CLI untuk bertanya. Jika Anda hanya sesekali menjalankan satu agent, Anda tidak akan banyak belajar darinya. Lihat juga halaman Token Meter dan dokumentasi Token Meter.