OpenCode

OpenCode adalah AI coding assistant open-source berbasis terminal/CLI yang sangat ringan dan cepat. OpenCode dikonfigurasi melalui file opencode.json (dapat diletakkan di root project atau secara global di ~/.config/opencode/opencode.json).

BotConnector menyediakan endpoint integrasi khusus sehingga Anda tidak perlu memasukkan belasan model secara manual satu per satu. Anda dapat menyinkronkan seluruh model sekaligus dalam 1 perintah.

---

1. Auto-Sync Cepat: 1 Baris Perintah Terminal (Rekomendasi)

Jalankan perintah berikut di terminal pada root folder project Anda (atau di direktori tempat opencode.json Anda berada):

curl -s https://api.botconnector.id/v1/integrations | jq '{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "botconnector": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BotConnector",
      "options": {
        "baseURL": .base_url,
        "apiKey": "{env:BOTCONNECTOR_API_KEY}"
      },
      "models": (.models | map({key: ., value: {name: .}}) | from_entries)
    }
  }
}' > opencode.json

Apa yang dilakukan perintah ini?

1. Mengambil metadata integrasi dan katalog model aktif dari https://api.botconnector.id/v1/integrations.
2. Secara dinamis menyusun seluruh model BotConnector (agnes-3.0-flash, ling-3.0-flash, glm-5.3-flash, deepseek-v4-flash, mistral-medium-3.5-free, dll.) ke dalam format schema resmi OpenCode.
3. Menyimpan hasilnya langsung ke file opencode.json yang siap digunakan oleh OpenCode.

Cara Memperbarui Model di Kemudian Hari: Kapan pun BotConnector merilis model baru atau melakukan rotasi kapasitas, Anda cukup menjalankan kembali satu baris perintah di atas. File opencode.json akan langsung ter-update dengan seluruh model terkini tanpa perlu edit teks manual.

---

2. Pengaturan API Key di Environment

OpenCode membaca API Key secara aman dari environment variable BOTCONNECTOR_API_KEY. Ekspor key Anda di terminal:

export BOTCONNECTOR_API_KEY="bc_live_your_actual_key_here"

Untuk menyimpannya secara permanen agar selalu aktif di setiap sesi terminal baru:

# Tambahkan ke bashrc atau zshrc
echo 'export BOTCONNECTOR_API_KEY="bc_live_your_actual_key_here"' >> ~/.bashrc
source ~/.bashrc

Dapatkan API Key akun Anda di Workspace → API Keys.

---

3. Struktur File opencode.json Lengkap

Bagi Anda yang ingin mengedit atau melihat struktur konfigurasi secara langsung, berikut contoh file opencode.json lengkap dengan seluruh model aktif:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "botconnector": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BotConnector",
      "options": {
        "baseURL": "https://api.botconnector.id/v1",
        "apiKey": "{env:BOTCONNECTOR_API_KEY}"
      },
      "models": {
        "agnes-3.0-flash": { "name": "agnes-3.0-flash" },
        "ling-3.0-flash": { "name": "ling-3.0-flash" },
        "glm-5.3-flash": { "name": "glm-5.3-flash" },
        "deepseek-v4-flash": { "name": "deepseek-v4-flash" },
        "mistral-medium-3.5-free": { "name": "mistral-medium-3.5-free" },
        "mistral-nemo": { "name": "mistral-nemo" },
        "mimo-v2.5": { "name": "mimo-v2.5" },
        "nemotron-3-nano-30b-a3b": { "name": "nemotron-3-nano-30b-a3b" },
        "tencent-hy3": { "name": "tencent-hy3" },
        "stealth/space-bunny-alpha": { "name": "stealth/space-bunny-alpha" }
      }
    }
  }
}

---

4. Menjalankan OpenCode

Setelah file opencode.json tersedia dan environment variable terpasang, jalankan perintah:

opencode

Di dalam antarmuka terminal OpenCode, gunakan tombol Tab atau ketik /model untuk memilih model BotConnector mana saja yang ingin digunakan secara instan.