Cara memeriksa penggunaan token Claude Code: 4 cara untuk melihat apa yang dibelanjakan agen Anda

Jika Anda menjalankan Claude Code lebih dari beberapa menit sehari, token adalah mata uang nyata Anda. Mereka menentukan kapan Anda mencapai batas tarif, seberapa cepat Anda menghabiskan langganan, dan apakah menjalankan agen dalam waktu lama itu sepadan. Masalahnya adalah Claude Code tidak mengumumkan jumlahnya kepada Anda. Anda harus pergi dan melihatnya.

Berikut adalah empat cara untuk memeriksa penggunaan token Claude Code, dari perintah bawaan tercepat hingga meteran langsung yang menunjukkan setiap agen secara real-time. Pilih yang sesuai dengan seberapa dalam Anda perlu menyelidiki.

1. Cara tercepat: /usage, /context, dan baris status

Di dalam sesi Claude Code mana pun, ketik:

/usage

Claude Code mencetak penggunaan token sesi saat ini dan, pada paket Claude.ai, sisa kuota Anda: batas penggunaan 5 jam dan 7 hari, ditambah seberapa besar jendela konteks yang sedang Anda pakai. /cost dan /stats masih berfungsi, keduanya adalah alias dari perintah yang sama. Anda bisa menjalankannya saat Claude sedang menjawab, angkanya muncul tanpa menyela jawaban (sebelum v2.1.234, perintah ini menunggu sampai giliran selesai).

Ingin melihat rincian jendela konteks alih-alih satu persentase saja? Ketik /context: jendela digambar sebagai kisi berwarna, dan apa yang memenuhinya ditandai, sebuah alat dengan keluaran yang terlalu berat, file memori yang membengkak, sesi yang hampir penuh.

Kedua perintah punya kekurangan yang sama: Anda harus mengetiknya, dan keduanya hanya melihat sesi tempat Anda berada. Tidak ada yang memberi tahu Anda berapa yang Anda habiskan kemarin atau berapa biaya proyek lain. Jika Anda ingin angka yang tetap tampil di layar, gunakan baris status. Minta Claude Code menulisnya untuk Anda:

/statusline show model name and context percentage with a progress bar

Ia membuat skrip di ~/.claude/ dan menyambungkannya ke pengaturan Anda. Jika Anda lebih suka menulisnya sendiri, tambahkan entri statusLine di ~/.claude/settings.json. Skrip menerima objek JSON lewat stdin dengan context_window.used_percentage, cost.total_cost_usd, dan, untuk pelanggan Pro dan Max, rate_limits.five_hour.used_percentage. Satu baris sudah cukup:

{
  "statusLine": {
    "type": "command",
    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'"
  }
}

Baris status diperbarui setelah setiap respons API, jadi persentasenya bergerak selama sesi berjalan. Tetap satu sesi per terminal: untuk data historis, atau untuk beberapa agen sekaligus, lanjutkan membaca.

2. Baca sumbernya: transkrip sesi

Claude Code menulis setiap sesi ke disk sebagai transkrip JSONL. Di macOS dan Linux, Anda akan menemukannya di sini:

~/.claude/projects/<encoded-project-path>/<session-id>.jsonl

Setiap baris adalah satu pesan, dan pesan asisten membawa objek usage dengan hitungan yang tepat: input_tokens, output_tokens, dan bidang cache (cache_creation_input_tokens, cache_read_input_tokens). Pembacaan cache adalah bagian yang menarik: mereka jauh lebih murah daripada input baru, jadi sesi dengan tingkat hit cache yang tinggi jauh lebih murah daripada yang disarankan oleh jumlah token mentah.

Ini adalah kebenaran dasar. Setiap alat lain, termasuk dua di bawah ini, membaca file yang sama. Jika Anda ingin membuat laporan Anda sendiri, jq di atas JSONL akan membawa Anda ke sana.

3. CLI khusus: ccusage

Jika Anda lebih suka tidak menulis parser Anda sendiri, alat komunitas ccusage membaca transkrip tersebut dan mengumpulkannya menjadi total harian, bulanan, dan per sesi:

npx ccusage@latest

Ini adalah jalan tengah yang baik: lebih banyak sejarah daripada /usage, lebih sedikit pekerjaan daripada menggunakan jq secara manual. Namun, ini tetap di terminal, jadi ini menjawab "apa yang saya habiskan" tetapi tidak "agen mana, saat ini, yang menghabiskannya".

4. Meteran langsung: penggunaan per sesi di AgentsRoom

Tiga metode di atas semua memiliki satu titik buta: mereka adalah setelah fakta dan satu aliran. Begitu Anda menjalankan beberapa agen secara paralel, Anda ingin melihat penggunaan per agen, secara langsung, tanpa mengetik perintah di setiap terminal.

Itulah yang dilakukan meteran penggunaan token Claude Code di AgentsRoom. Ini membaca transkrip JSONL yang sama, per sesi, dan menampilkan:

• token input, output, dan cache per agen, diperbarui saat sesi berjalan
• tingkat hit cache, sehingga Anda dapat melihat kapan konteks digunakan kembali alih-alih dikirim ulang
• peringatan sebelum sesi melenceng menuju batas tarif

Karena atribusi penggunaan berdasarkan sesi, ini tetap akurat bahkan ketika Anda menjalankan beberapa akun Claude Code berdampingan: setiap akun mempertahankan totalnya sendiri, yang membuat penagihan per klien menjadi sederhana.

Mana yang harus Anda gunakan

• Hanya perlu angka sesi ini, atau ingin tahu sisa kuota Anda? /usage, dan baris status jika Anda ingin angkanya selalu terlihat.
• Ingin membuat laporan kustom? Baca transkrip JSONL secara langsung.
• Ingin total harian dan bulanan di terminal? ccusage.
• Menjalankan beberapa agen dan ingin melihat penggunaan secara langsung, per agen dan per akun? Gunakan meteran di AgentsRoom.

Memeriksa penggunaan adalah langkah pertama. Jika angka-angka itu membuat Anda meringis, langkah selanjutnya adalah menurunkannya: lihat cara mengurangi biaya token Claude Code untuk pengungkit yang benar-benar penting, dimulai dengan penggunaan kembali cache.