Gunakan OpenCode dengan free LLM API
OpenCode adalah agent coding open source untuk terminal dan desktop. Aplikasi ini menerima penyedia apa pun yang kompatibel dengan OpenAI. Panduan ini menghubungkan OpenCode ke model gratis melalui FreeLLMAPI. Satu perintah menulis konfigurasi dan menyimpan kuncinya.
Kode, nama model, dan label katalog langsung ditampilkan dalam bahasa Inggris.
Langkah 1: Pasang FreeLLMAPI
FreeLLMAPI adalah gateway open source. Gateway ini berjalan di komputer Anda melalui Docker dan menggabungkan tier gratis dari 45 penyedia di balik satu kunci.
Pasang di macOS atau Linux
curl -fsSL https://freellmapi.co/install.sh | bashBuka http://localhost:3001. Tambahkan minimal dua kunci penyedia gratis di halaman Keys. Google AI Studio dan Groq masing-masing memberikan kunci gratis dalam beberapa menit. Salin kunci terpadu Anda dari halaman yang sama.
Langkah 2: Hubungkan OpenCode dengan satu perintah
Satu perintah
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencodePerintah ini melakukan tiga hal:
- Perintah menambahkan penyedia
freellmapike~/.config/opencode/opencode.json. Penyedia ini mencantumkan model dari katalog Anda saat ini beserta batas konteksnya. - Perintah mengatur
freellmapi/autosebagai model default. - Perintah menyimpan kunci di file kredensial OpenCode,
~/.local/share/opencode/auth.json. Anda tidak memerlukan variabel lingkungan, baik di CLI maupun di aplikasi desktop.
Perintah membuat cadangan sebelum menulis. Perintah menggabungkan penyedia baru, sehingga penyedia Anda yang lain tetap ada. Jika XDG_CONFIG_HOME atau XDG_DATA_HOME diatur, perintah menggunakan folder tersebut.
Sebelum Anda memulai tugas panjang, pastikan gateway dapat melayani permintaan sekarang. Panggilan ini hanya mencantumkan model yang memiliki kunci yang dapat digunakan saat ini:
Periksa model yang siap
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Model dengan status exhausted memiliki kunci, tetapi semuanya sudah mencapai batas saat ini. Status ini hilang saat cooldown berakhir. Jalankan npx freellmapi doctor untuk memastikan permintaan dari klien mencapai gateway. Log permintaan di dashboard menampilkan setiap panggilan dari OpenCode. Header respons X-Routed-Via menyebutkan penyedia dan model yang menjawab setiap permintaan. Jika sebuah permintaan berpindah karena gagal, header X-Fallback-Trail menyebutkan setiap hop yang gagal beserta alasannya.
Setup manual: blok provider opencode.json
Untuk mengatur secara manual, tambahkan blok ini ke ~/.config/opencode/opencode.json, atau ke opencode.json di proyek Anda. OpenCode menggunakan @ai-sdk/openai-compatible untuk endpoint /v1/chat/completions.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"model": "freellmapi/auto",
"provider": {
"freellmapi": {
"npm": "@ai-sdk/openai-compatible",
"name": "FreeLLMAPI",
"options": {
"baseURL": "http://localhost:3001/v1"
},
"models": {
"auto": {
"name": "Auto",
"limit": { "context": 128000, "output": 8192 }
}
}
}
}
}Kemudian tambahkan kuncinya. Mulai OpenCode, jalankan /connect, pilih penyedia freellmapi, dan tempelkan kunci terpadu Anda. ID penyedia di /connect harus sama dengan ID di konfigurasi. Jalankan /models untuk memilih model.
limit.contextadalah jumlah token input maksimum model.limit.outputadalah jumlah token maksimum yang dapat dihasilkan model.modeltingkat atas menggunakan formatprovider/model. Tanpa itu, OpenCode mempertahankan model yang digunakan sebelumnya.- Setiap ID model yang ingin Anda gunakan harus ada di peta
models. Tambahkan lebih banyak ID dariGET /v1/models.
providers. Dokumen menyatakan bahwa format V1 di atas tetap didukung. Perintah setup FreeLLMAPI menulis format V1.Pilih model untuk OpenCode
OpenCode adalah agent. Agent ini membaca file, mengeditnya, dan menjalankan perintah melalui panggilan tool. Setiap permintaan membawa system prompt, definisi tool, dan isi file. Gunakan model dengan tool calling dan jendela konteks yang besar.
| Model | Gratis di | Konteks | Batas gratis (penawaran terbaik) | Alat | Pemrosesan gambar |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 permintaan/menit 1 req/min per model | Ya | Tidak |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 permintaan/menit 40 RPM | Ya | Ya |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ya | Ya |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Ya | Tidak |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ya | Ya |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ya | Ya |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 permintaan/menit 50 permintaan/hari 50 req/day account-wide (1,000 after a $10 purchase) | Ya | Ya |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 permintaan/menit 50 permintaan/hari Shared rate limit | Ya | Tidak |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 permintaan/menit 250 permintaan/hari 70,000 token/menit ~6M | Ya | Ya |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Ya | Ya |
Menampilkan 12 dari 109 model gratis yang cocok. Lihat semua model.
Data langsung dari katalog FreeLLMAPI (versi 2026.11.19, diperiksa 2026-11-19). Batas gratis sering berubah. Katalog diperiksa setiap hari.
Gunakan freellmapi/auto agar router memilih model untuk setiap permintaan. Tambahkan auto:smart atau auto:fast ke peta models untuk mengarahkan permintaan berdasarkan kecerdasan atau kecepatan. Anda juga dapat menambahkan profil bernama, misalnya auto:coding, setelah membuatnya di dashboard.
Batas laju dan sesi panjang
Satu tugas agent dapat mengirim puluhan permintaan. Satu tier gratis dapat menghentikan tugas panjang dengan cepat. FreeLLMAPI menghitung permintaan dan token setiap kunci. Saat sebuah penyedia mengirim error 429, router meneruskan permintaan ke model berikutnya dalam rantai, dan sesi berlanjut.
- Tambahkan kunci dari empat penyedia atau lebih. Lebih banyak penyedia memberi lebih banyak permintaan per hari.
- Aktifkan context handoff dengan
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchdi.envFreeLLMAPI. Saat model berganti, model berikutnya menerima catatan singkat bahwa ia melanjutkan tugas. - Sticky session mempertahankan percakapan pada satu model selama 30 menit. Ini menjaga agent tetap konsisten.
- Mulai sesi baru untuk setiap tugas. Konteks yang lebih kecil menggunakan lebih sedikit token per permintaan.
Pemecahan masalah
| Masalah | Penyebab | Solusi |
|---|---|---|
| "Invalid API key" dengan kunci yang valid | apiKey yang kosong di konfigurasi menimpa kunci dari /connect | Hapus apiKey dari options, atau jalankan setup-opencode lagi |
| OpenCode tidak menggunakan penyedia baru | model tingkat atas belum diatur | Atur "model": "freellmapi/auto" |
| Model not found | ID model tidak ada di peta models penyedia | Tambahkan ID ke peta, atau jalankan setup-opencode lagi |
Kunci {env:VAR} kosong | OpenCode mengganti variabel yang tidak diatur dengan string kosong | Ekspor variabel di shell yang sama, atau simpan kunci dengan /connect |
| Tool calling gagal | Model memiliki tool calling yang lemah | Pilih model dari tabel di atas |
| Pesan "All models rate-limited after N attempts" | Semua kunci sudah mencapai batasnya | Tambahkan kunci dari lebih banyak penyedia, atau tunggu cooldown |
Pertanyaan yang sering diajukan
Bisakah saya menggunakan OpenCode secara gratis?
Bisa. OpenCode bersifat open source. Hubungkan ke FreeLLMAPI sebagai penyedia yang kompatibel dengan OpenAI. Gateway mengirim setiap permintaan ke tier penyedia gratis, sehingga biaya inferensi $0.
Bagaimana cara menambahkan penyedia kustom yang kompatibel dengan OpenAI ke OpenCode?
Tambahkan penyedia dengan npm yang diatur ke @ai-sdk/openai-compatible, options.baseURL, dan peta models ke opencode.json. Kemudian jalankan /connect untuk menyimpan kunci dan /models untuk memilih model.
Model gratis mana yang terbaik untuk OpenCode?
Gunakan model dengan tool calling dan konteks minimal 128K. Tabel di halaman ini menunjukkan model gratis terkuat yang memenuhi kedua aturan tersebut saat ini. Gunakan freellmapi/auto agar router memilih salah satunya.
Di mana OpenCode menyimpan kunci API?
Kunci yang ditambahkan dengan /connect disimpan di ~/.local/share/opencode/auth.json. Perintah setup FreeLLMAPI menulis kunci di sana, sehingga CLI dan aplikasi desktop sama-sama menemukannya.
Panduan terkait
- Gunakan Aider dengan API LLM gratis
- Gunakan Codex CLI dengan model gratis
- Cara memakai Claude Code secara gratis
- API model coding gratis terbaik
- Base URL free API kompatibel OpenAI
Sumber
- OpenCode docs: providers (V1 config) (diperiksa 20 November 2026)
- OpenCode docs: config (diperiksa 20 November 2026)
- OpenCode docs: migrate from V1 (diperiksa 20 November 2026)
- FreeLLMAPI CLI generators (diperiksa 20 November 2026)
- FreeLLMAPI docs: context handoff (diperiksa 20 November 2026)