OpenCode adalah coding agent open-source yang jalan penuh di terminal. Kamu mengetik tujuannya, OpenCode membaca struktur repo, mengedit file, dan mengeksekusi perintah sambil terus melaporkan apa yang sedang dilakukan.
OpenCode mendukung provider apa pun yang berbicara format OpenAI-compatible. AI Gateway Appverse persis begitu: endpoint OpenAI-compatible dengan header Authorization Bearer, jadi tidak perlu middleware atau proxy tambahan.
Sebelum mulai
- Paket AI Gateway aktif (Token Plan atau Pay As You Go). Belum punya? Pilih paket dulu di sini.
- API key aktif dari dashboard gateway.
- OpenCode sudah terinstal. Belum? Jalankan npm install -g opencode-ai.
- Satu Model ID dari tabel harga model, bukan nama tampilannya.
Langkah integrasi
- 1
Ambil API key dari dashboard
Login ke dashboard gateway, copy API key aktif kamu. Pemilik Token Plan bisa mengambil key yang sudah di-assign di halaman Token Plan.
Key tertulis langsung di file konfigurasi. Jangan pernah meng-commit file itu ke git atau membagikannya, dan batasi izin aksesnya di komputer kamu.
- 2
Tambah provider Appverse di opencode.json
Buka file config global di ~/.config/opencode/opencode.json, atau buat opencode.json di root project untuk pengaturan per project. Tambahkan blok provider berikut.
Ganti MODEL_ID_DARI_DASHBOARD dengan Model ID asli. Key "model" di baris paling bawah membuat model itu menjadi default setiap kali OpenCode dijalankan.
opencode.json { "$schema": "https://opencode.ai/config.json", "provider": { "appverse": { "npm": "@ai-sdk/openai-compatible", "name": "AppVerse AI Gateway", "options": { "baseURL": "https://ai.appverse.id/v1", "apiKey": "API_KEY_KAMU" }, "models": { "MODEL_ID_DARI_DASHBOARD": { "name": "AppVerse Model" } } } }, "model": "appverse/MODEL_ID_DARI_DASHBOARD" } - 3
Pilih model dari dalam OpenCode
Jalankan opencode di folder project, lalu ketik /models untuk membuka daftar model. Model dari provider AppVerse akan muncul dengan nama yang kamu isi di blok models.
Kalau key "model" di config sudah diisi, langkah ini bisa dilewati karena OpenCode langsung memakai model default-nya.
- 4
Uji dengan prompt kecil
Kirim prompt ringan, misalnya minta OpenCode merangkum isi satu file. Respons yang keluar berarti koneksi ke gateway berhasil.
Cek pemakaian di dashboard gateway untuk memastikan request benar-benar tercatat di key kamu.
Tips pemakaian
- API key tertulis langsung di opencode.json, jadi jangan pernah meng-commit file itu ke git. Bila config per-project sering ikut ter-sync atau ter-commit, pakai file global di ~/.config/opencode yang terpisah dari repo.
- Blok models bisa diisi beberapa Model ID sekaligus. Pindah-pindah model cukup lewat menu /models tanpa mengedit config lagi.
- Untuk memperkirakan biaya sebelum mengerjakan task besar, lihat harga input dan output per 1 juta token di tabel harga model.
Pertanyaan yang sering muncul
OpenCode bilang model tidak ditemukan. Kenapa?
Hampir selalu karena yang diisi adalah nama tampilan model, bukan Model ID. Copy Model ID persis dari dashboard atau tabel harga, lalu paste ke blok models di opencode.json.
Apakah aman menaruh API key di opencode.json?
Aman selama file itu tidak menyebar. Jangan pernah meng-commit opencode.json ke repository, batasi izin aksesnya di komputer kamu, dan bila ingin lebih aman lagi gunakan file global di ~/.config/opencode yang tidak ikut folder project.
Apakah prompt dan kode saya disimpan di gateway?
Tidak. Gateway menerapkan ZDR (Zero Data Retention): prompt dan response tidak disimpan, tidak dibaca, dan tidak dipakai untuk training.
Bisakah saya pakai beberapa model dari gateway sekaligus?
Bisa. Daftarkan beberapa Model ID di blok models provider appverse, lalu pilih model aktif lewat menu /models setiap kali dibutuhkan.