Skrip Pengelolaan Anggaran Token untuk Mencegah Tagihan API Cloud Code Meledak
1. Mencegah Kelebihan Tagihan dengan Mengatur Batas Atas Token
Jika Anda pernah terkejut melihat tagihan API setelah menjalankan proyek skala kecil, itu karena tidak ada batasan anggaran yang ditetapkan. Agen mempertahankan konteks percakapan jauh lebih lama dari yang Anda perkirakan dan berulang kali membaca konten file yang tidak perlu. Jika dibiarkan, ratusan ribu token akan hilang dalam sehari. Anda harus membuka file ~/.claude/settings.json dan membatasi penggunaan sesi serta harian secara langsung.
Berikut adalah cara menambahkan objek budget ke file pengaturan global pengguna:
- Buka terminal dan buka file ~/.claude/settings.json menggunakan editor.
- Di dalam blok JSON, masukkan nilai sessionLimit sebesar 500000 dan dailyLimit sebesar 2000000.
- Tentukan warningThreshold ke 0.75 dan atur autoCompactAt ke 0.60, lalu simpan.
Ketika kapasitas konteks mencapai 60 persen, riwayat percakapan akan otomatis dikompresi, sehingga pemborosan token yang tidak perlu akan hilang. Sesi akan diblokir sebelum mencapai batas harian, sehingga Anda dapat terbebas dari kekhawatiran melebihi anggaran.
2. Membangun Pemutus Looping untuk Penghentian Paksa Saat Terjadi 3 Error Berturut-turut
Jika agen macet pada hook yang sama karena masalah kesalahan sintaksis atau jalur file, agen akan berputar dalam infinite loop tanpa menyelesaikannya. Jika kondisi ini dibiarkan, token sesi akan habis dalam hitungan menit. Menulis peringatan di prompt agar berhati-hati sama sekali tidak berguna. Anda harus menghubungkan sistem hook berbasis skrip shell untuk memblokirnya secara fisik.
Buat skrip hook yang langsung menghentikan proses jika error yang sama terdeteksi 3 kali berturut-turut.
- Buat file .claude/hooks/loop-breaker.sh di direktori proyek dan berikan izin eksekusi.
- Di dalam skrip, rujuk file status sementara untuk menaikkan penghitung error sebanyak 1, dan jika jumlah kumulatifnya 3 atau lebih, cetak kesalahan standar dan kembalikan kode keluar 2 untuk menghentikan pekerjaan secara paksa.
- Daftarkan jalur skrip tersebut ke item PostToolUseFailure di file .claude/settings.json agar dapat dipantau secara real-time.
Dengan memasang perangkat ini, fenomena di mana agen menghabiskan token karena memperbaiki kode yang salah secara tak terbatas akan hilang. Anda dapat menghemat waktu yang terbuang dalam neraka debugging.
3. Pemisahan Perutean Model dan Bagian Persetujuan Manual Berdasarkan Sifat Pekerjaan
Jika Anda menyerahkan semua pekerjaan pengodean sepenuhnya kepada Claude, anggaran Anda tidak akan bertahan. Tugas pemformatan sederhana atau penulisan boilerplate diserahkan ke model yang lebih ringan, sementara tugas yang tidak dapat dibatalkan seperti migrasi database harus disetujui langsung oleh pengembang. Manfaatkan alias shell untuk membangun lingkungan eksekusi yang sesuai dengan tingkat kesulitan tugas.
Pengaturan untuk memisahkan perintah delegasi agen berdasarkan sifat pekerjaan adalah sebagai berikut:
- Buka file ~/.bashrc atau ~/.zshrc.
- Daftarkan perintah
alias cc-quick='claude --model claude-haiku-3-20250307 --token-budget 100000' untuk tugas dokumentasi sederhana.
- Tambahkan perintah
alias cc-dev='claude --model claude-sonnet-4-20250514 --token-budget 500000 --thinking-budget 8000' untuk pengembangan fitur umum, lalu mulai ulang terminal.
Dengan menerapkan metode ini, agen dapat menangani 90 persen pengodean berulang sederhana dengan aman, dan rasio PR yang diselesaikan per 1 juta token akan meningkat secara signifikan. Ini adalah cara paling realistis untuk memotong biaya API yang tidak perlu hingga setengahnya dengan pasti.