Hubungkan Qwen Code ke CheapTokens: env var dan settings.json

Qwen Code dapat terhubung ke endpoint yang kompatibel dengan OpenAI kustom, jadi menghubungkannya ke CheapTokens membutuhkan tiga nilai: base URL https://api.cheaptokens.dev/v1, API key Anda, dan id model lengkap seperti deepseek-ai/DeepSeek-V4-Flash-0731. Ekspor sebagai OPENAI_API_KEY, OPENAI_BASE_URL, dan OPENAI_MODEL, atau masukkan ke ~/.qwen/settings.json. Kedua cara ini berasal dari dokumentasi autentikasi Qwen Code (halaman terakhir diperbarui 22 Oktober 2026).

Bayangkan sesi panjang: agen membaca selusin file, mengedit tiga, menjalankan ulang tes. Setiap langkah mengirim ulang konteks, jadi Anda membayar input berulang kali. Itulah sebabnya model murah dengan saldo per-token cocok untuk agen terminal, dan mengapa pengaturan di bawah ini layak meluangkan sepuluh menit.

Instal Qwen Code#

Qwen Code membutuhkan Node.js 22 atau lebih baru. README proyek (github.com/QwenLM/qwen-code) mencantumkan beberapa cara instalasi; dua di antaranya:

npm install -g @qwen-code/qwen-code@latest

brew install qwen-code

Anda menjalankannya dengan qwen. Dokumentasi juga menjelaskan /auth → Custom Provider untuk menghubungkan proxy atau provider yang tidak didukung secara manual. Dua cara di bawah ini ditulis baris per baris, jadi mulailah dengan salah satunya.

Cara 1: tiga environment variable#

Cara tercepat. Buka terminal di proyek Anda dan jalankan:

export OPENAI_API_KEY="sk-your-api-key"
export OPENAI_BASE_URL="https://api.cheaptokens.dev/v1"
export OPENAI_MODEL="deepseek-ai/DeepSeek-V4-Flash-0731"
qwen

Key tersebut adalah placeholder; tempel milik Anda dari dashboard CheapTokens. Mengekspor OPENAI_API_KEY juga yang memberi tahu Qwen Code untuk menggunakan autentikasi kompatibel OpenAI saat Anda mengatur semuanya melalui env var. OPENAI_MODEL memiliki alias, QWEN_MODEL.

Satu detail yang sering membuat orang tersandung: id model. Gunakan id lengkap dari dokumentasi CheapTokens. Nama pendek yang Anda lihat di samping harga, deepseek-v4-flash-0731, tidak diterima oleh API, dan id berbeda antar provider.

Variable mana yang berfungsi untuk apa? Cocokkan:

Ekspor berlaku sampai Anda menutup terminal. Untuk mempertahankan pengaturan, gunakan cara berikutnya.

Cara 2: settings.json dan key di luar git#

Misalkan Anda berbagi repo dengan tim dan tidak ada yang ingin key berada di file konfigurasi. Maka jelaskan model di ~/.qwen/settings.json dan simpan key di file terpisah.

{
  "modelProviders": {
    "openai": [
      {
        "id": "deepseek-ai/DeepSeek-V4-Flash-0731",
        "name": "DeepSeek-V4-Flash (CheapTokens)",
        "baseUrl": "https://api.cheaptokens.dev/v1",
        "description": "DeepSeek-V4-Flash through CheapTokens",
        "envKey": "CHEAPTOKENS_API_KEY"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "deepseek-ai/DeepSeek-V4-Flash-0731" }
}

Empat field yang penting:

• id adalah id model yang dikirim ke API, jadi harus id lengkap.
• model.name harus cocok dengan salah satu nilai id, jika tidak Qwen Code tidak punya yang bisa dipilih.
• security.auth.selectedType diatur ke "openai" memilih rute kompatibel OpenAI.
• envKey menamai variable yang menyimpan key. Ini opsional dan defaultnya OPENAI_API_KEY.

Key itu sendiri masuk ke .qwen/.env, yang direkomendasikan dokumentasi untuk secret, dan file itu tetap di luar git:

CHEAPTOKENS_API_KEY=sk-your-api-key

Ada alasan untuk memilih itu daripada blok env di settings.json: nilai dari env memiliki prioritas terendah, dan file yang berisi key mudah ter-commit secara tidak sengaja. Selengkapnya tentang menjaga keamanan key ada di menyimpan API key dengan aman.

Setelah diluncurkan, /model menampilkan model yang dikonfigurasi dan memungkinkan Anda beralih. Untuk memulai dengan model tertentu, jalankan qwen --model "deepseek-ai/DeepSeek-V4-Flash-0731".

Berapa biaya sesi coding#

Agen terminal berat input: setiap langkah membawa file dan riwayat yang telah dikumpulkannya sejauh ini. Ambil tugas 40 langkah dan asumsikan 30.000 token input dan 1.000 token output per langkah. Itu berarti 40 × 30.000 = 1.200.000 token input dan 40 × 1.000 = 40.000 token output. Berikut seluruh tugas dengan harga live:

Menghitung input dan output bersama-sama, CheapTokens lebih murah daripada OpenRouter untuk setiap model dalam tabel. Untuk jenis loop ini, DeepSeek-V4-Flash cocok: konteks 380K, hingga 32.768 token output dalam satu jawaban, satu harga kapan pun, dan satu saldo untuk semua model. Angka Anda sendiri akan berbeda, jadi geser slider:

Harga ada di halaman harga. Jika Anda memantau penggunaan di agen lain, berapa biaya Cline membahas perhitungan yang sama.

Model lain untuk dicoba#

Beralih hanya berarti mengganti id, tidak lebih. Ambil dari halaman model atau dari GET /v1/models:

• zai-org/GLM-5.3-Flash: konteks 390K, hingga 8.192 token output per jawaban, dan total harga lebih rendah daripada OpenRouter.
• MiniMaxAI/MiniMax-M2.7: konteks 180K, hingga 8.192 token output per jawaban, dan total harga lebih rendah daripada OpenRouter.

Ubah OPENAI_MODEL, atau tambahkan entri kedua ke modelProviders.openai dan beralih di antaranya dengan /model.

Jika Qwen Code tidak terhubung#

• Tipe auth tidak terpilih. Dengan env var saja, OPENAI_API_KEY harus diekspor. Dengan settings.json, pastikan selectedType adalah "openai".
• Model tidak ditemukan. model.name harus sama dengan id karakter demi karakter, dan id harus id gateway lengkap.
• 401. Key hilang atau salah. Jika Anda menggunakan envKey, pastikan variable itu benar-benar ada di .qwen/.env atau shell Anda.
• 404. Pastikan base URL diakhiri dengan /v1 dan id tidak salah ketik. Panduan lengkapnya ada di API 401 atau 404: key, base URL, atau id model salah.
• Variable tampaknya diabaikan. Nilai di env dalam settings.json memiliki prioritas terendah, jadi variable yang diatur di tempat lain menang.

Pengaturan untuk agen terminal lain mengikuti pola yang sama, misalnya OpenCode dan Aider. Semua hal lainnya, dari key hingga permintaan pertama, ada di dokumentasi CheapTokens.