Troubleshooting & FAQ
Error? Cari di sini. Pakai Ctrl+F (Cmd+F Mac) buat search cepat.
🔧Install & Setup
`opencode: command not found` setelah install
Restart terminal. Kalau masih error, tambah npm global bin ke PATH:
```bash
npm config get prefix
# Output: /usr/local atau C:\Users\Nama\AppData\Roaming\npm
# Tambah folder tersebut ke System PATH
```
`EACCES: permission denied` saat `npm install -g`
Jangan pakai sudo. Set prefix ke folder user:
```bash
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
```
Windows: set di Environment Variables → User variables → PATH.
Node.js / npm tidak dikenali
Install Node.js LTS dulu (lihat tutorial [Install OpenCode](/tutorial/install-opencode)). Restart terminal setelah install.
Windows PowerShell error execution policy
Jalankan PowerShell **as Administrator**:
```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```
🔧Model & OpenCode
Model gratis tidak muncul di `/model`
Pastikan online. Jalankan `opencode` ulang. Kalau tetap tidak ada, cek versi OpenCode: `opencode --version` dan update: `npm update -g opencode-ai`.
OpenCode nggak respons / stuck
Tekan `Ctrl+C` untuk cancel. Kalau masih stuck, `Ctrl+D` keluar, lalu jalankan `opencode` lagi.
Error `Cannot find module` saat jalanin file
Pastikan di folder project yang benar (`cd nama-folder`). Cek file ada: `ls` (Mac/Linux) atau `dir` (Windows).
Model bilang 'API key required' padahal pilih model gratis
Cek model aktif: `opencode config get model`. Pastikan pakai yang bermula `free/`. Kalau salah, jalankan `/model` pilih yang benar.
🔧Error Umum
`Cannot read property of undefined`
Variabel belum diinisialisasi. Cek line error, tambah pengecekan `if (variabel) { ... }` atau nilai default.
`SyntaxError: Unexpected token`
Kurang/kelebihan tanda kurung, koma, atau string tidak tertutup. Buka file error, perbaiki syntax.
`ENOENT: no such file or directory`
File/folder tidak ada. Cek path: `ls` atau `dir`. Pastikan nama file benar (case-sensitive di Linux/Mac).
Port sudah digunakan (EADDRINUSE)
Proses lain pakai port. Matikan: `npx kill-port 3000` atau ganti port di config.
🔧Tanya Umum
Harus jago coding buat ikutin tutorial ini?
Tidak. Tutorial dirancang untuk pemula total. Ikutin step-by-step, copy-paste command, tanya ke OpenCode kalau error.
Bisa pakai Mac / Linux / Windows?
Bisa semua. Command terminal mayoritas sama. Perbedaan kecil dijelaskan di tiap tutorial.
Butuh bayar buat model AI?
Tidak. OpenCode punya model gratis bawaan. Cukup jalankan `/model` pilih yang bermula `free/`.
Agent saya error terus, gimana debug?
1. Copy error message 2. Paste ke OpenCode: 'Error ini: [paste error]. Jelaskan & perbaiki.' 3. Jalanin ulang. 4. Ulangi sampai fix.
Data/API key saya aman kan?
Selama nggak commit ke Git, nggak share di chat, nggak tulis di kode — aman. Simpan di `.env` + `.gitignore`.
Masih Stuck?
Copy error message → paste ke OpenCode → bilang: "Error ini: [paste]. Jelaskan & perbaiki."
OpenCode dibikin buat bantu debug. Manfaatkan.