opencode

opencode memanggil Vikey lewat format OpenAI chat completions.

Diuji dengan opencode 1.19.5 (versi terbaru) pada 13 November 2026.

Config yang disarankan

1. Simpan API key di variabel environment:

   export VIKEY_API_KEY=API_KEY_KAMU

2. Tulis provider Vikey di ~/.config/opencode/opencode.jsonc (berlaku untuk semua proyek) atau opencode.jsonc di folder proyek:

   ~/.config/opencode/opencode.jsonc

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "vikey": {
         "npm": "@ai-sdk/openai-compatible",
         "name": "Vikey",
         "options": {
           "baseURL": "https://api.vikey.ai/v1",
           "apiKey": "{env:VIKEY_API_KEY}"
         },
         "models": {
           "vikey/agent-gpt": { "name": "Vikey Auto GPT" },
           "vikey/agent-coding": { "name": "Vikey Auto Claude" },
           "anthropic/claude-sonnet-5.5": { "name": "Claude Sonnet 5.5" },
           "openai/gpt-6.1-sol": { "name": "GPT-6.1 Sol" },
           "openai/gpt-6-luna": { "name": "GPT-6 Luna" }
         }
       }
     },
     "model": "vikey/vikey/agent-gpt",
     "small_model": "vikey/openai/gpt-6-luna"
   }

3. Jalankan opencode. Ganti model dengan perintah /models.

Kenapa tiap baris ada

Baris	Fungsi
npm	Paket penghubung untuk API yang kompatibel OpenAI. opencode mengunduhnya otomatis saat pertama dipakai.
options.baseURL	Dengan /v1.
options.apiKey	{env:VIKEY_API_KEY} membaca key dari variabel environment, jadi key tidak tertulis di file.
models	Model yang muncul di /models. Kunci di dalamnya harus sama persis dengan model id Vikey.
model	Model default, ditulis id-provider/model-id. Karena model id Vikey juga memakai garis miring, hasilnya seperti vikey/vikey/agent-gpt atau vikey/openai/gpt-6.1-sol.
small_model	Model untuk tugas kecil seperti membuat judul sesi. Pilih model murah supaya tugas ini hampir tidak memakan biaya.

Format providers di situs opencode

Situs opencode sudah menampilkan format baru providers dengan package dan settings. opencode 1.19.5 mengabaikan format itu dengan pesan cannot be represented in V1, lalu gagal dengan Model not found. Pakai format provider seperti di atas sampai rilis opencode mendukung format baru.

Cara lain memasukkan key

Kalau tidak mau memakai variabel environment, hapus baris apiKey dari config, jalankan opencode, ketik /connect, pilih Vikey, lalu tempel API key. opencode menyimpan key itu di penyimpanan kredensialnya sendiri.

Cek koneksi

opencode run "balas dengan kata ok"

Kalau berhasil, opencode menampilkan ok beserta nama model yang dipakai.

Masalah umum

Yang kamu lihat	Penyebab	Solusi
Model not found: vikey/...	Model belum ada di models, atau format providers yang belum didukung	Tambahkan model id ke models, pakai format provider
401	VIKEY_API_KEY belum di-export di terminal ini	Export ulang, atau pakai /connect
Judul sesi memakai model mahal	small_model belum diisi	Isi small_model dengan model murah seperti vikey/openai/gpt-6-luna