Crush'u CheapTokens'a bağlayın: crushrc sağlayıcı, model, anahtar

Crush'u CheapTokens'a bağlamak için crushrc dosyanıza iki komut koyun: temel URL'si https://api.cheaptokens.dev/v1 ve --type completions olan provider add ile tam model kimliğini içeren model add. Ardından Crush'u açın, Ctrl+l tuşuna basın, modeli seçin ve ona bir görev verin. Anahtar dosyada değil, bir ortam değişkeninde kalır.

Daha eski bir kılavuzu takip ettiyseniz, muhtemelen crush.json dosyasını düzenliyordur. Crush bu dosyayı hâlâ okur, ancak README'si onu kullanımdan kaldırılmış olarak adlandırıyor: güncel yapılandırma crushrc ve v0.99.0'dan (29 Ekim 2026) itibaren sağlayıcı --type satıcıyı değil, API biçimini tanımlıyor. Kaynaklar Crush README'si ve sürüm notları; 10 Kasım 2026'da kontrol edildi ve o tarihteki en son kararlı sürüm v0.100.0.

Crush'u yükleyin#

Zaten sahip olduğunuz paket yöneticisini seçin. Crush tek bir ikili dosyadır, bu yüzden hangi yolu izlediğiniz önemli değil.

brew install charmbracelet/tap/crush

npm install -g @charmland/crush

winget install charmbracelet.crush

go install github.com/charmbracelet/crush@latest

README ayrıca apt ve yum depolarını, Scoop, Nix, Arch ve FreeBSD'yi listeliyor. Başladığını kontrol etmek için crush komutunu bir kez çalıştırın, ardından çıkın.

CheapTokens'ı crushrc'ye ekleyin#

README, crushrc'yi "bazı Crush'a özgü yerleşiklerle birlikte sadece Bash" olarak tanımlıyor. Bütün püf noktası bu: siz shell yazıyorsunuz ve provider add ile model add Crush'un anladığı komutlar. Crush dosyayı şu sırayla arar: ./.crushrc, ./crushrc, ardından ~/.config/crush/crushrc.

Yani nerede yaşayacağını siz seçiyorsunuz. Proje yerelindeki .crushrc tek bir depoya uygulanır; ~/.config/crush/ içindeki ise her yere uygulanır. İlk deneme için global olan daha kolaydır.

Önce anahtarı shell'inize koyun. CheapTokens kontrol panelinizde oluşturun ve dışa aktarın (aşağıdaki değer bir yer tutucudur):

export CHEAPTOKENS_API_KEY="your-key-here"

Ardından ~/.config/crush/crushrc dosyasını açın ve şunu yazın:

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

Birkaç ayrıntı ikinci bir bakışı hak ediyor:

• --type completions, OpenAI'nin kendisi olmayan OpenAI uyumlu sağlayıcılar için Crush adıdır. responses OpenAI proxy'si için, messages Anthropic uyumlu olanlar içindir. Eski openai-compat hâlâ çalışır ve taşınır.
• Temel URL /v1 ile biter. Bu, OpenAI tarzı Chat Completions için CheapTokens adresidir; uç noktaların tam listesi CheapTokens belgelerinde bulunur.
• $CHEAPTOKENS_API_KEY shell tarafından genişletilir, bu yüzden dosya hiçbir sır barındırmaz ve proje .crushrc güvenle git'e eklenebilir.
• Model kimliği tam olandır, deepseek-ai/DeepSeek-V4-Flash-0731. deepseek-v4-flash gibi kısa bir kimlik API tarafından reddedilir. Sağlayıcı adından sonra ikinci bir eğik çizgi gelir, çünkü kimliğin kendisinde bir tane var.
• --context-window 380000, DeepSeek-V4-Flash'in yuvarlanmış 380K'sıdır ve --default-max-tokens 32768 onun yanıt başına sınırıdır. Bunlar modelin CheapTokens'taki gerçek sınırlarıdır: 380K bağlam ve yanıt başına en fazla 32.768 token. README'deki örnek değerleri (64000 ve 5000) bırakmak yerine bunları model add içine koyun.

README, model add komutunu yalnızca basit bir kimlikle (deepseek/deepseek-chat) gösteriyor. Sizin kimliğinizde fazladan bir eğik çizgi var, bu yüzden sonraki adımdaki model seçici gerçek kontroldür: model cheaptokens altında görünüyorsa, satır amaçlandığı gibi okunmuştur.

Aynı bakiyede başka bir model mi istiyorsunuz? Kendi kimliği ve sınırlarıyla bir model add satırı daha ekleyin. GLM-5.3-Flash zai-org/GLM-5.3-Flash (390K bağlam, yanıt başına en fazla 8.192 token) ve MiniMax-M2.7 MiniMaxAI/MiniMax-M2.7 (180K bağlam, yanıt başına en fazla 8.192 token). --default-max-tokens değerini eklediğiniz modelin yanıt sınırında veya altında tutun.

Crush'u açın ve ilk görevi çalıştırın#

Bir proje klasöründe crush komutunu başlatın. Model seçiciyi açmak için Ctrl+l tuşuna basın ve cheaptokens grubundan DeepSeek-V4-Flash'i seçin. README, varsayılan model için bir crushrc komutu tanımlamıyor, bu yüzden seçici yoldur.

Şimdi ona küçük ve kontrol edilebilir bir şey verin, örneğin: Read this repo and tell me which file starts the app, in two lines. Gerçek bir dosyayı adlandıran bir yanıt, tüm zincirin çalıştığı anlamına gelir: anahtar, temel URL, model kimliği.

İzin istemleri kasıtlı olarak oradadır. crushrc içindeki permissions allow <tools>, adlandırılmış araçların sormadan çalışmasını sağlar; --yolo her istemi atlar ve README'nin kendisi bu konuda çok dikkatli olunmasını söyler.

Bir kodlama oturumunun maliyeti#

Bir terminaldeki ajan adımı girdi ağırlıklıdır: Crush her seferinde geçmişi, dosya içeriklerini ve araç çıktısını gönderir ve mütevazı bir yanıt alır. Diyelim ki ortalama bir adım 30.000 token gönderiyor ve 2.000 alıyor. DeepSeek-V4-Flash'te bu adım $0.00065 tutar ve fiyat her saatte aynıdır, yoğun saat yoktur. Girdi ve çıktı birlikte sayıldığında bu, OpenRouter'ın referans fiyatından daha ucuzdur.

Kendi sayılarınızı yerleştirin: bu tür 40 adımlık bir oturum bir kaydırıcı uzağınızda.

Adım başına girdi oturum ilerledikçe büyür, bu yüzden uzun bir oturumu ortalamaya değil 380K pencereye göre kontrol edin. Her model için güncel token başına fiyatlar fiyatlandırma sayfasında bulunur.

Çalışmazsa#

Crush projenize bir günlük yazar, ./.crush/logs/crush.log. Tahmin yürütmeden önce onu okuyun:

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

Hata ayıklama çıktısını açık tutmak için crushrc'ye option debug true de koyabilirsiniz. Ardından gördüklerinizi API'nin döndürdüğü HTTP durumuyla eşleştirin:

• 401: anahtar gönderildi ama tanınmadı: bir yazım hatası veya değiştirilmiş bir anahtar. Yeniden oluşturun veya kopyalayın.
• 402: bakiye veya anahtarın sınırı tükendi. Hiç anahtar içermeyen bir istek de aynı görünür, bu yüzden crush komutunu başlattığınız shell'de echo $CHEAPTOKENS_API_KEY çalıştırın. Anahtar oradaysa bakiyeyi yükleyin.
• 429: kısa sürede çok fazla istek. Retry-After değerini bekleyin ve tekrar deneyin.
• 400 veya "model not found": model kimliğine bakın. Belgelerdeki tam kimlik olmalı, satıcı önekiyle birlikte.

crush.json üzerinden geçtiyseniz, ~/.local/share/crush/crush.json dosyasının bir yapılandırma değil, Crush'un durumu olduğunu unutmayın; onu elle düzenlemeyin.

Aynı kurulumu diğer araçlarda yapmak için Aider'ı CheapTokens'a Bağlayın ve Kilo Code'u CheapTokens'a Bağlayın yazılarına bakın. Ucuz DeepSeek model sayfasında burada kullanılan modelin sınırları bulunur.