Hubungkan Crush ke CheapTokens: provider crushrc, model, kunci

Untuk menghubungkan Crush ke CheapTokens, masukkan dua perintah ke crushrc Anda: provider add dengan base URL https://api.cheaptokens.dev/v1 dan --type completions, serta model add dengan id model lengkap. Lalu buka Crush, tekan Ctrl+l, pilih model dan beri tugas. Kunci tetap berada di variabel environment, bukan di file.

Jika Anda mengikuti panduan lama, kemungkinan besar panduan itu mengedit crush.json. Crush masih membaca file tersebut, tetapi README-nya menyebutnya deprecated: konfigurasi saat ini adalah crushrc, dan sejak v0.99.0 (29 Oktober 2026) provider --type mendeskripsikan format API, bukan vendor. Sumbernya adalah README Crush dan catatan rilis, diperiksa pada 10 November 2026; rilis stabil terbaru pada tanggal itu adalah v0.100.0.

Pasang Crush#

Pilih package manager yang sudah Anda miliki. Crush hanya satu binary, jadi tidak masalah rute mana yang Anda ambil.

brew install charmbracelet/tap/crush

npm install -g @charmland/crush

winget install charmbracelet.crush

go install github.com/charmbracelet/crush@latest

README juga mencantumkan repositori apt dan yum, Scoop, Nix, Arch dan FreeBSD. Jalankan crush sekali untuk memastikan Crush bisa start, lalu keluar.

Masukkan CheapTokens ke crushrc#

README mendeskripsikan crushrc sebagai "hanya Bash dengan beberapa builtin khusus Crush". Itulah seluruh triknya: Anda menulis shell, dan provider add serta model add adalah perintah yang dipahami Crush. Crush mencari file dalam urutan ini: ./.crushrc, ./crushrc, lalu ~/.config/crush/crushrc.

Jadi Anda yang memilih lokasinya. .crushrc lokal proyek berlaku untuk satu repositori; yang ada di ~/.config/crush/ berlaku di mana saja. Untuk percobaan pertama, yang global lebih mudah.

Pertama masukkan kunci ke shell Anda. Buat di dashboard CheapTokens dan export (nilai di bawah adalah placeholder):

export CHEAPTOKENS_API_KEY="your-key-here"

Lalu buka ~/.config/crush/crushrc dan tulis:

provider add cheaptokens --type completions \
  --base-url "https://api.cheaptokens.dev/v1" \
  --api-key "$CHEAPTOKENS_API_KEY"

model add cheaptokens/deepseek-ai/DeepSeek-V4-Flash-0731 \
  --name "DeepSeek-V4-Flash" \
  --context-window 380000 \
  --default-max-tokens 32768

Beberapa detail perlu diperhatikan:

• --type completions adalah nama Crush untuk provider yang kompatibel dengan OpenAI yang bukan OpenAI itu sendiri. responses untuk proxy OpenAI, messages untuk yang kompatibel dengan Anthropic. openai-compat yang lama masih berfungsi dan akan dimigrasi.
• Base URL berakhiran /v1. Itu alamat CheapTokens untuk Chat Completions gaya OpenAI; daftar lengkap endpoint ada di dokumentasi CheapTokens.
• $CHEAPTOKENS_API_KEY diekspansi oleh shell, jadi file tidak menyimpan rahasia dan .crushrc proyek bisa masuk ke git dengan aman.
• Id model adalah yang lengkap, deepseek-ai/DeepSeek-V4-Flash-0731. Id pendek seperti deepseek-v4-flash ditolak oleh API. Setelah nama provider ada slash kedua, karena id-nya sendiri memiliki satu.
• --context-window 380000 adalah 380K yang dibulatkan dari DeepSeek-V4-Flash, dan --default-max-tokens 32768 adalah batas per jawabannya. Ini adalah batas nyata model di CheapTokens: konteks 380K dan hingga 32.768 token per jawaban. Masukkan ke model add alih-alih membiarkan nilai contoh dari README (64000 dan 5000).

README hanya menunjukkan model add dengan id sederhana (deepseek/deepseek-chat). Id Anda memiliki slash tambahan, jadi pemilih model di langkah berikutnya adalah pemeriksaan sebenarnya: jika model muncul di bawah cheaptokens, baris tersebut terbaca sesuai maksud.

Ingin model lain dengan saldo yang sama? Tambahkan satu baris model add lagi dengan id dan batasnya sendiri. GLM-5.3-Flash adalah zai-org/GLM-5.3-Flash (konteks 390K, hingga 8.192 token per jawaban), dan MiniMax-M2.7 adalah MiniMaxAI/MiniMax-M2.7 (konteks 180K, hingga 8.192 token per jawaban). Jaga --default-max-tokens pada atau di bawah batas jawaban model yang Anda tambahkan.

Buka Crush dan jalankan tugas pertama#

Mulai crush di folder proyek. Tekan Ctrl+l untuk membuka pemilih model dan pilih DeepSeek-V4-Flash dari grup cheaptokens. README tidak mendeskripsikan perintah crushrc untuk model default, jadi pemilih adalah caranya.

Sekarang beri sesuatu yang kecil dan bisa diperiksa, misalnya: Read this repo and tell me which file starts the app, in two lines. Jawaban yang menyebut file nyata berarti seluruh rantai berfungsi: kunci, base URL, id model.

Prompt izin ada dengan sengaja. permissions allow <tools> di crushrc memungkinkan tool tertentu berjalan tanpa bertanya; --yolo melewati semua prompt, dan README sendiri menyebut agar sangat berhati-hati dengannya.

Berapa biaya sesi coding#

Satu langkah agent di terminal berat di input: Crush mengirim riwayat, isi file dan output tool setiap kali, dan menerima jawaban yang moderat. Katakanlah rata-rata satu langkah mengirim 30.000 token dan menerima 2.000. Pada DeepSeek-V4-Flash langkah itu berbiaya $0.00065, dan harganya sama di jam berapa pun, tanpa jam sibuk. Dihitung dengan input dan output digabung, itu lebih murah daripada harga referensi OpenRouter.

Ganti dengan angka Anda sendiri: sesi 40 langkah seperti itu hanya berjarak satu slider.

Input per langkah bertambah seiring sesi berjalan, jadi periksa sesi panjang terhadap jendela 380K, bukan rata-ratanya. Harga per token terkini untuk setiap model ada di halaman harga.

Jika tidak berfungsi#

Crush menulis log di proyek Anda, ./.crush/logs/crush.log. Baca dulu sebelum menebak:

crush logs --tail 500
crush logs --follow
crush --debug

Anda juga bisa memasukkan option debug true ke crushrc untuk mempertahankan output debug. Lalu cocokkan apa yang Anda lihat dengan status HTTP yang dikembalikan API:

• 401: kunci dikirim tetapi tidak dikenali: salah ketik atau kunci yang sudah diganti. Buat atau salin lagi.
• 402: saldo atau batas kunci sudah habis. Permintaan tanpa kunci sama sekali terlihat sama, jadi jalankan echo $CHEAPTOKENS_API_KEY di shell tempat Anda menjalankan crush. Jika kunci ada, isi ulang saldo.
• 429: terlalu banyak permintaan dalam waktu singkat. Tunggu nilai Retry-After dan coba lagi.
• 400 atau "model not found": periksa id model. Harus yang lengkap dari dokumentasi, dengan prefiks vendor.

Jika Anda pindah dari crush.json, perhatikan bahwa ~/.local/share/crush/crush.json adalah state Crush, bukan konfigurasi; jangan edit secara manual.

Untuk setup yang sama di tool lain, lihat Hubungkan Aider ke CheapTokens dan Hubungkan Kilo Code ke CheapTokens. Halaman model untuk DeepSeek murah memuat batas model yang digunakan di sini.