OpenCode Free Usage Limit Reached: Penyebab dan Cara Fix
OpenCode free usage limit reached artinya kuota model gratis habis. Gue cek di v1 dan v2, kenapa v1 cuma diem dan nge-hang, plus cara fix yang kepake.

Error: Free usage limit reached. Connect a provider or subscribe to OpenCode Go to keep going, or switch models.
Itu OpenCode 2.3.0 yang bilang kuota model gratis lo udah habis. Di gue error ini muncul dengan config project maupun tanpa, jadi bukan masalah config. Lo bisa connect provider sendiri, langganan OpenCode Go, atau nunggu. Gue kena ini tanggal 2026-11-15 di OpenCode 1.19.0 dan 2.3.0 sekaligus, dan v1 yang paling bikin bingung: opencode run gak nampilin apa-apa dan nge-hang sampai lo kill.
Quick Fix
Free tier di sini maksudnya model gratis yang ditawarin OpenCode untuk sementara waktu, misalnya DeepSeek V4.1 Flash Free, menurut dokumentasi models Console. OpenCode Go adalah langganan opsional untuk model coding yang dites tim OpenCode, menurut dokumentasi providers. Perbandingan harganya sama paket coding lain gue bahas di review Xiaomi MiMo.
Pastiin dulu ini beneran kuota (dua bagian berikutnya nunjukin caranya), baru pilih salah satu. Tiga yang pertama ada di dokumentasi OpenCode. Yang terakhir cuma pengamatan gue.
| Opsi | Yang dilakuin | Sumber dan status |
|---|---|---|
| Connect provider sendiri | Di TUI jalanin /connect, pilih provider dan isi kredensialnya, terus jalanin /models dan pilih salah satu modelnya | Dokumentasi providers OpenCode. Model dari provider gue sendiri jalan normal di 1.19.0 dan 2.3.0 setelah kena limit |
| Langganan OpenCode Go | Langganan di OpenCode Console, copy API key, jalanin /connect, pilih OpenCode Go, paste key-nya, terus /models. Dokumentasinya nyebut Go 10 dolar per bulan, Go Plus 40 dolar per bulan, dan Go Teams 20 dolar per member per bulan | Dokumentasi OpenCode Go. Gak gue tes |
| Tambah credit di Console | Tambah credit di OpenCode Console. Biaya proses 4,6 persen plus 0,31 dolar ditambahin ke tiap pembelian | Dokumentasi models Console. Gak gue tes |
| Nunggu | Waktu reset gak didokumentasiin. Gue gak liat reset setelah sekitar satu jam | Tes gue sendiri, detail di bawah |
Baca Juga: OpenCode YOLO Mode dan Multi-Model CLI: Panduan Teruji
Error Free Tier yang Mana yang Lo Kena?
Maintainer OpenCode ngumpulin masalah free tier di issue #59387 dan nyebut enam pesan. Pesan-pesan itu bukan satu masalah yang sama, jadi cocokin dulu sama punya lo sebelum ngubah apa-apa.
| Pesan | Artinya | Yang dilakuin |
|---|---|---|
Free usage limit reached, atau Free usage exceeded, subscribe to Go | Jatah gratis udah habis | Tabel Quick Fix di atas |
You've used today's free messages. They reset at ... | Limit yang sama, plus waktu reset. Issue-nya nyatet kalau di beberapa laporan reset-nya gak pernah terjadi | Tunggu waktu reset, atau pake provider lain |
This version of OpenCode Desktop no longer supports free models | Aplikasi desktop-nya kelamaan. Kata issue-nya, updater desktop v1 nahan lo di 1.x | Download v2 dari dokumentasi OpenCode |
OpenCode 1.18.0 or newer is required to use the free tier | Versi CLI-nya kelamaan | Update OpenCode |
OpenCode's free tier can only be used from within OpenCode | Model gratis cuma jalan di dalam OpenCode, bukan lewat client lain, proxy, atau API langsung | Pake OpenCode-nya langsung, atau provider lain |
Pesan terakhir itu bisa muncul juga di aplikasi terminal resminya. Pelapor di Windows dengan v2.0.32 di issue #56324 udah upgrade, restart, dan login ulang pake opencode auth login opencode, tapi tetep kena. Itu error yang beda dari yang soal kuota, jadi fix kuota gak bakal nyentuh yang ini.
Kenapa OpenCode v1 Diem dan Nge-hang
Di v2 error kuotanya langsung muncul dan command-nya keluar dengan exit code 1. Di 1.19.0 kegagalan yang sama gak keliatan. opencode run "Run: npm run build" cuma nampilin baris header-nya, > build · deepseek-v4.1-flash-free, terus nunggu sampai timeout 90 detik gue ngebunuhnya dengan exit code 142.
Errornya ada di log, disusul kegagalan retry buat judul sesi. Tambahin --print-logs biar keliatan di layar:
opencode run --print-logs -m opencode/deepseek-v4.1-flash-free "Run: npm run build"Ini baris yang keluar di 1.19.0, dipotong ke bagian yang penting:
level=ERROR message="stream error" providerID=opencode modelID=deepseek-v4.1-flash-free agent=build error.error="AI_APICallError: Free usage limit reached. Free models work in OpenCode (https://opencode.ai); subscribe to OpenCode Go to keep going: https://opencode.ai/go"Request judul sesi setelah itu gagal dengan AI_RetryError yang bilang gagal setelah 3 percobaan, dengan pesan kuota yang sama sebagai error terakhirnya. Dokumentasi troubleshooting OpenCode nempatin log di ~/.local/share/opencode/log/opencode.log, jadi lo juga bisa nyari di situ belakangan:
grep "Free usage limit" ~/.local/share/opencode/log/opencode.logYang Gue Amati di 1.19.0 dan 2.3.0
Gue jalanin opencode run lewat script di project sekali pakai, dengan tiap versi pake direktori datanya sendiri. Jam-nya WIB, UTC plus 7, tanggal 2026-11-15.
| Jam | Versi | Model | Hasil |
|---|---|---|---|
| 15:15 sampai 15:16 | 1.19.0 | deepseek-v4.1-flash-free | 14 run jalan, tiap run selesai kira-kira 5 sampai 11 detik |
| 15:16:49 | 1.19.0 | deepseek-v4.1-flash-free | Error limit pertama di log. Dua run berikutnya nge-hang sampai timeout 240 detik gue ngebunuhnya |
| 15:26 | 2.3.0 | deepseek-v4.1-flash-free | Error limit pertama. 16 run gagal dalam 13 detik, masing-masing nampilin error |
| 15:28 | 1.19.0 | mimo-v2.6-flash-free | Error limit yang sama, jadi pindah ke model gratis lain gak ngebantu |
| 16:16 | 1.19.0 | deepseek-v4.1-flash-free | Cuma baris header, terus hang sampai timeout 90 detik. Errornya ada di log |
| 16:17 | 2.3.0 | deepseek-v4.1-flash-free | Gagal seketika dengan exit code 1 dan pesan errornya |
Run lain udah makan free tier lebih awal di hari yang sama, jadi gue gak bisa bilang seberapa gede kuotanya atau gimana ngitungnya. Yang ditunjukin tabelnya: limit-nya dipake bareng semua model gratis, dan masih aktif sekitar sejam setelah error pertama.
Update ke v2 Bakal Ngefix?
Buat pesan kuota, enggak. Issue #59387 bilang kebanyakan laporan free tier datang dari v1 dan update ke v2 udah ngefix buat banyak orang. Dia juga bilang v1 udah gak support model gratis. Dua versi gue ngasih error kuota yang sama, dan run 1.19.0 gue jalan sampai kuotanya habis. Buat pesan soal versi di tabel di atas, update bisa jadi ngebantu.
Yang Berhasil Buat Gue
Setelah kena limit gue pindahin TUI ke model dari provider gue sendiri, yang gue set lewat 9Router, dan jalan normal di dua versi. Prompt izinnya berperilaku sama kayak sebelumnya. Config provider gue gak gue tulis di sini. Dokumentasi providers nunjukin setup yang didukung, termasuk custom provider yang kompatibel dengan OpenAI.
Satu hal yang gak bakal gue coba: nyambungin client atau proxy lain ke model gratis OpenCode. Kata issue-nya, model itu cuma jalan di dalam OpenCode.
Baca Juga: Review DeepSeek V4 Flash (2026): Apa yang Berubah di V4.1
Yang Gak Bisa Gue Verifikasi
- Ukuran kuota, jendela waktunya, dan kapan reset. Gak ada sumber yang gue temuin yang nyebutnya.
- Limit dan perilaku OpenCode Go di luar harga paket yang ada di dokumentasi.
- Apakah limit-nya nempel ke akun gue, ke IP gue, atau berlaku buat semua orang sekaligus.
- Apakah
opencode auth login opencodengebantu. Pelapor di issue #56324 udah nyoba dan gak ngebantu.
Cara Mutusinnya
Kalau lo ketemu pesan kuota, jangan debug config lo. Jalanin sekali pake --print-logs buat mastiin, baru pilih. Kalau lo harus tetep kerja hari ini, connect provider yang udah lo punya. Kalau mau tetep di model bawaan OpenCode, liat Go. Kalau pesannya soal versi atau soal jalan di dalam OpenCode, itu masalah lain dan tabel di atas nunjukin lo harus ke mana.


