Tutorial Claude Code — penggunaan sehari-hari dengan kunci berbayar sesuai pemakaian: ganti model, hitung biaya, kelola konteks

Penggunaan Claude Code dapat diringkas menjadi empat langkah: jalankan claude di folder proyek, jalankan /init sekali untuk menghasilkan CLAUDE.md, jelaskan tugas dalam bahasa Indonesia dan sertakan path file, lalu tinjau perubahan yang diajukan dan putuskan apakah akan menerimanya. Claude Code adalah asisten pemrograman yang tinggal di terminal; ia membaca file, mengubah file, dan menjalankan pengujian sendiri, tetapi meminta persetujuan sebelum bekerja. Anda dapat masuk dengan langganan Pro/Max atau mengatur kunci API dengan penagihan sesuai pemakaian; dengan kunci API, setiap langkah ditagih berdasarkan token, sehingga tiga fokus penggunaan sehari-hari adalah memilih model sesuai tugas, mengetahui biaya satu sesi kerja, dan menjaga konteks tetap ringkas.

Hampir semua tutorial Claude Code di internet mengasumsikan login dengan langganan. Halaman ini ditujukan untuk pengguna lain: mereka yang tidak memiliki langganan atau tidak ingin dibatasi jendela penggunaan 5 jam, dan memilih kunci dengan penagihan sesuai pemakaian. Jika belum terpasang, lihat panduan instalasi Claude Code, lalu kembali setelah selesai menginstal dan menghubungkannya.

Memulai untuk pertama kali: empat tindakan

# 1. 一定要在專案資料夾裡啟動——它能看、能改的範圍就是這個資料夾
cd ~/work/my-app
claude

# 2. 第一個指令：讀過整個 repo，產生 CLAUDE.md
> /init

# 3. 之後直接用中文交代任務，附上檔案路徑最準
> 把 src/api/user.ts 的輸入驗證改用 zod，測試也一起修好

# 4. 牽涉很多檔案的任務，先按 Shift+Tab 切到計畫模式，確認做法再動手

Claude Code akan meminta konfirmasi setiap kali hendak mengubah file atau menjalankan perintah. Jika arahnya salah, tekan Esc untuk menghentikannya, lalu gunakan /rewind untuk kembali ke checkpoint sebelumnya; kode dan percakapan akan dikembalikan bersama. /init menghasilkan CLAUDE.md yang hanya merupakan draf; ada bagian khusus di bawah yang membahas cara mempersingkatnya.

Penagihan satu sesi kerja saat menggunakan kunci API

Setiap kali Claude Code mengirim permintaan, prompt sistem, CLAUDE.md, seluruh percakapan, dan isi file yang telah dibaca dikirim ulang, dengan konten baru ditambahkan di bagian akhir. Bagian awal yang tidak berubah menggunakan cache: cache read ditagihkan sebesar 10% harga input, sedangkan cache write sebesar 1,25 kali harga input. Karena itu, bagian terbesar tagihan suatu sesi sering kali adalah “membaca ulang percakapan lama”.

Tabel berikut menggunakan satu sesi kerja dari contoh dokumentasi biaya resmi Anthropic — 1.200 input, 5.300 output, 940.000 cache read, dan 50.000 token cache write — lalu menghitung biayanya dengan tarif Kunavo untuk masing-masing dari empat model:

Pada Claude Sonnet 5, sekitar 85% tagihan sesi ini berasal dari cache read dan cache write. Dengan kata lain, yang menentukan biaya adalah seberapa panjang percakapan, bukan berapa banyak karakter yang Anda ketik — inilah alasan bagian “kebersihan konteks” di bawah.

Untuk melihat angka Anda sendiri, jalankan /usage di Claude Code (/cost adalah aliasnya); perintah tersebut menampilkan empat jenis jumlah token. Namun, jumlah biaya di sebelahnya adalah estimasi lokal Claude Code berdasarkan harga Anthropic; saat menggunakan Kunavo, biaya aktual ditentukan oleh halaman penggunaan di dasbor, yang menampilkan jumlah token setiap model (termasuk cache read/write) dan jumlah yang ditagihkan.

Mengganti model sesuai tugas

Pertama, di bagian env pada ~/.claude/settings.json, petakan setiap alias ke model aktual. Menuliskannya dalam file ini membuatnya dapat dibaca oleh ekstensi editor dan proses latar belakang; jangan menuliskannya ke .claude/settings.json yang akan di-commit ke proyek. Alias harus dipetakan: model default Claude Code dan alias opus sama-sama mengarah ke Opus terbaru; jika Kunavo belum menyediakannya, permintaan pertama tanpa konfigurasi yang sesuai akan menerima 404. Alias sonnet mengarah ke Sonnet 5.5, yang tidak disediakan Kunavo; tanpa ANTHROPIC_DEFAULT_SONNET_MODEL, tahap eksekusi /model sonnet dan opusplan, serta subagen yang disetel ke model: sonnet, akan menerima 404. Konfigurasi berikut memetakan alias opus ke Claude Opus 5.5 (claude-opus-5-5), dan memerlukan Claude Code versi v2.1.280 atau lebih baru; untuk versi yang lebih lama, jalankan claude update terlebih dahulu.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5"
  }
}

Setelah diatur, penggantian hanya memerlukan satu baris:

# 工作階段裡切換（別名會對應到上面設定的模型）
> /model haiku
> /model sonnet
> /model opus

# 也可以直接打完整名稱
> /model claude-fable-5

# 或在啟動時指定
claude --model claude-opus-5-5

/model menyimpan pilihan sebagai model bawaan untuk sesi baru; jika hanya ingin menggantinya kali ini, jalankan /model tanpa argumen, lalu tekan s di menu. ANTHROPIC_DEFAULT_HAIKU_MODEL wajib diatur di Kunavo: tanpa pengaturan ini, alias haiku akan meminta nama model yang tidak disediakan Kunavo (Haiku 5.5 sejak v2.1.293), sehingga /model haiku dan subagen yang ditetapkan ke haiku menghasilkan 404. Pengaturan ini juga menentukan model yang digunakan Claude Code untuk membuat ringkasan dan judul di latar belakang. Menetapkannya ke model termurah dapat sekaligus menghemat biaya.

Di Kunavo, Claude Opus 5.5 berharga $2,80 / $14,00, sedangkan Claude Sonnet 5 berharga $1,40 / $7,00; harga satuan Claude Haiku 4.5 sekitar 1/2 dari harga satuan Claude Sonnet 5, sedangkan Claude Fable 5 adalah 5 kali lipatnya. Perbandingan dengan harga resmi: Claude Sonnet 5 Sekitar 30% lebih murah daripada harga resmi Anthropic, Claude Opus 5.5 Sekitar 30% lebih murah daripada harga resmi Anthropic, Claude Haiku 4.5 Sekitar 30% lebih murah daripada harga resmi Anthropic, Claude Fable 5 Sekitar 30% lebih murah daripada harga resmi Anthropic.

Ganti model di antara tugas, bukan di tengah tugas. Cache setiap model terpisah: jika /model di tengah tugas, permintaan berikutnya harus membaca ulang seluruh percakapan dengan harga tanpa cache (selama cache masih berlaku, Claude Code akan meminta konfirmasi terlebih dahulu). Jalankan /clear sebelum berganti; yang perlu dibaca ulang hanya percakapan baru yang sangat singkat. Token penalaran ditagihkan dengan harga output; untuk tugas sederhana, gunakan /effort untuk menurunkan tingkat penalaran — atur juga di awal tugas karena mengubah effort di tengah jalan akan membuat cache tidak berlaku pada sebagian besar model.

CLAUDE.md: tulis hanya hal yang harus dijelaskan berulang kali

# CLAUDE.md — 放在專案根目錄，commit 進 git

## 指令
- 測試：npm test（只跑一個檔：npm test -- path/to/file）
- 型別檢查：npx tsc --noEmit
- Lint：npm run lint

## 規則
- 日期一律用 date-fns，不用 moment。
- API handler 只放在 app/api/**/route.ts。
- commit 訊息用繁體中文，前綴 feat / fix / docs。

## 不要動的地方
- db/migrations/ —— 產生出來的檔案，不要手改。

CLAUDE.md dimuat saat setiap sesi kerja dimulai, lalu ikut dikirim dalam setiap permintaan (biasanya dengan harga cache read). Anthropic menyarankan satu file tidak lebih dari 200 baris — semakin panjang, semakin banyak konteks yang digunakan dan semakin buruk kepatuhannya. Hal-hal yang dapat diketahui dari kode (struktur direktori, penjelasan fungsi) tidak perlu ditulis; catatan yang hanya ditujukan untuk manusia dapat dibungkus dalam <!-- --> dan akan dihapus sebelum dikirim ke konteks.

Ada satu kesalahpahaman umum lainnya: mengubah CLAUDE.md di tengah sesi tidak langsung berlaku; versi baru baru akan dibaca setelah /clear, /compact, atau memulai ulang.

Kebersihan konteks: membuat setiap langkah lebih murah

• Gunakan /clear di antara tugas yang tidak berkaitan. Perintah ini membuka percakapan baru dan tidak dikenai biaya; percakapan lama dapat ditemukan kembali dengan /resume.
• Jika satu tugas terlalu panjang, gunakan /compact. Anda dapat menyertakan poin yang harus dipertahankan, misalnya /compact 保留測試輸出和改過的檔案. Perintah ini mengirim satu permintaan ringkasan dan paling murah dilakukan saat cache masih berlaku; jika Anda baru melakukan compact setelah lama meninggalkan sesi, permintaan ringkasan harus membaca ulang seluruh riwayat dengan harga tanpa cache.
• Jika arahnya salah, gunakan /rewind. Perintah ini kembali ke bagian awal yang sudah di-cache, sehingga lebih hemat daripada compact.
• Dalam mode kunci API, cache secara default hanya bertahan 5 menit. Jika kembali setelah lebih dari 5 menit, langkah pertama akan menulis ulang seluruh konteks sebelumnya ke cache (1,25 kali harga input). Sebelum pergi rapat atau makan, gunakan /compact atau /clear untuk menyelesaikan sesi.
• Gunakan /context untuk melihat apa yang menghabiskan konteks. Saat menggunakan Kunavo, angka ini merupakan estimasi lokal — Kunavo saat ini tidak menyediakan /v1/messages/count_tokens; kompresi otomatis dan sesi kerja itu sendiri tidak terpengaruh.
• Matikan server MCP yang tidak digunakan di /mcp. Dokumentasi Anthropic menyatakan bahwa jika ANTHROPIC_BASE_URL khusus dikonfigurasi, pencarian alat (tool search) tidak tersedia; definisi alat MCP tidak dimuat secara tertunda, tetapi langsung menghabiskan ruang dalam setiap permintaan.
• Sertakan path file saat menjelaskan tugas. “Perbaiki validasi” akan membuat Claude mencari ke banyak tempat dan membaca banyak file; “ubah validasi src/api/user.ts agar menggunakan zod” hanya membaca yang diperlukan.

Jika ingin mengurangi pertanyaan “boleh saya menjalankan ini?”, sebaiknya hanya izinkan perintah untuk membaca dan memvalidasi; flag yang melewati semua konfirmasi sekaligus hanya boleh digunakan di lingkungan yang dapat dibuang sepenuhnya. Alasannya dijelaskan dalam penjelasan --dangerously-skip-permissions (bahasa Inggris). Cara cache ditagihkan dijelaskan dalam dokumentasi cache.

Batas biaya dan pembayaran

Di halaman pengelolaan kunci, buat kunci khusus untuk Claude Code dan tetapkan batas pengeluaran bulanan: ketika batas tercapai, permintaan menggunakan kunci tersebut akan mengembalikan 402 dan tidak terus menagih; loop yang tidak terkendali juga hanya akan menghabiskan saldo sampai batas itu. Halaman yang sama juga dapat digunakan untuk menetapkan daftar putih IP.

Akun menggunakan sistem prabayar: minimum pengisian $10, saldo tidak kedaluwarsa, dan permintaan yang gagal tidak dikenai biaya. Di Taiwan, Anda dapat mengisi saldo dengan kartu kredit internasional (Visa, Mastercard, Amex, JCB, UnionPay) atau Apple Pay dan Google Pay; saat ini tidak tersedia saluran lokal seperti Jiekou atau LINE Pay. Detailnya dapat dilihat di Biaya Claude Code.

Kapan langganan justru lebih hemat

Orang yang berinteraksi dalam waktu lama setiap hari dan menjalankan banyak langkah per bulan biasanya lebih hemat dengan biaya bulanan tetap dari langganan. Penentuannya cukup dengan satu pembagian: biaya bulanan ÷ biaya per langkah = jumlah langkah titik impas; dengan perkiraan Claude Sonnet 5 sekitar $0,043 per langkah (tidak termasuk cache), jika Anda menjalankan lebih sedikit langkah per bulan daripada angka ini, penagihan sesuai pemakaian lebih hemat dan bulan tanpa pekerjaan tetap $0. Biaya bulanan semua paket saat ini serta perhitungan lengkap tersedia di halaman biaya Claude Code; tidak diulang di sini.

Trade-off jalur ini juga perlu dijelaskan: Kunavo menggunakan kapasitas bersama, tanpa kuota khusus dan tanpa SLA kontraktual. Tim yang memerlukan kuota atau SLA terjamin sebaiknya membeli langsung dari Anthropic. Penjelasan lengkap tentang konfigurasi koneksi tersedia dalam dokumentasi integrasi Claude Code (bahasa Inggris).

Pertanyaan umum