Lewati ke konten
KoboiLLM Docs

OpenCode

OpenCode adalah AI agent dan coding assistant yang berjalan langsung di terminal (TUI/CLI), mirip dengan Claude Code atau Cursor, namun sepenuhnya open-source dan mendukung berbagai AI provider kustom yang kompatibel dengan format OpenAI.

Dengan panduan ini, Anda dapat menghubungkan KoboiLLM ke OpenCode untuk melakukan coding, debugging, dan refactoring project langsung dari terminal menggunakan model-model andalan seperti GPT-5.6 Sol, Terra, atau Luna.

Langkah 1: Persiapan API Key & Base URL

Sebelum melakukan konfigurasi, pastikan Anda telah menyiapkan data berikut dari dashboard KoboiLLM:

  1. API Key: Buat API Key baru di menu Virtual Keys (contoh format: sk-xxxxxxxxxxxxxxxxxxxxxxxx). Pastikan Anda telah memilih All Team Models saat membuat key tersebut.
  2. Base URL: Base URL standar KoboiLLM yang kompatibel dengan format OpenAI adalah: 
    https://api.koboillm.com/v1

Langkah 2: Konfigurasi opencode.json

OpenCode membaca konfigurasi custom provider dari file JSON. Anda dapat mengaturnya secara global untuk semua project atau per-project (di dalam root folder project Anda).

Lokasi File Konfigurasi

  • Global (Semua Project):
    • Linux / macOS: ~/.config/opencode/opencode.json
    • Windows: %USERPROFILE%\.config\opencode\opencode.json
  • Per-Project (Hanya untuk project aktif):
    • Buat file bernama opencode.json di root folder project Anda.

Contoh Isi Konfigurasi

Buat atau edit file opencode.json Anda, lalu masukkan konfigurasi KoboiLLM seperti di bawah ini:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "koboillm": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "KoboiLLM",
      "options": {
        "baseURL": "https://api.koboillm.com/v1",
        "apiKey": "{env:KOBOILLM_API_KEY}"
      },
      "models": {
        "openai/gpt-5.6-sol": {
          "name": "GPT-5.6 Sol",
          "limit": {
            "context": 1050000,
            "output": 128000
          }
        },
        "openai/gpt-5.6-terra": {
          "name": "GPT-5.6 Terra",
          "limit": {
            "context": 1050000,
            "output": 128000
          }
        },
        "openai/gpt-5.6-luna": {
          "name": "GPT-5.6 Luna",
          "limit": {
            "context": 1050000,
            "output": 128000
          }
        }
      }
    }
  },
  "model": "koboillm/openai/gpt-5.6-sol"
}

Penjelasan Parameter:

  • "npm": "@ai-sdk/openai-compatible": Memberitahu OpenCode untuk menggunakan driver OpenAI-compatible.
  • "baseURL": Mengarah ke API gateway KoboiLLM.
  • "apiKey": "{env:KOBOILLM_API_KEY}": Merujuk secara dinamis ke environment variable KOBOILLM_API_KEY. Ini adalah cara paling aman agar API Key Anda tidak tersimpan secara hardcoded (terutama jika file konfigurasi masuk ke Git).
  • "models": Daftar model dari KoboiLLM yang ingin Anda daftarkan ke OpenCode. Anda bisa menambahkan model lainnya dengan mencocokkan model ID yang ada di dashboard KoboiLLM.
  • "limit.context" & "limit.output": Batasan token agar OpenCode dapat mengukur penggunaan context window secara efisien.
  • "model": Menentukan default model yang langsung aktif saat OpenCode dijalankan (formatnya: {provider_id}/{model_id}).

Langkah 3: Menjalankan OpenCode dengan API Key

Untuk menjalankan OpenCode dengan aman menggunakan API Key KoboiLLM Anda, set environment variable KOBOILLM_API_KEY terlebih dahulu di terminal Anda.

Pada Linux / macOS (Bash/Zsh):

Terminal window
export KOBOILLM_API_KEY="sk-koboillm-anda"
opencode

Pada Windows (PowerShell):

Terminal window
$env:KOBOILLM_API_KEY="sk-koboillm-anda"
opencode

Pada Windows (CMD):

Terminal window
set KOBOILLM_API_KEY="sk-koboillm-anda"
opencode

Langkah 4: Berinteraksi dengan Model

Setelah OpenCode berjalan:

  1. Memilih Model: Di dalam TUI OpenCode, jalankan perintah /models untuk melihat daftar model KoboiLLM yang telah Anda konfigurasi (seperti GPT-5.6 Sol, Terra, atau Luna) dan pilih model yang ingin digunakan secara interaktif.
  2. Mulai Coding: Tanyakan tugas coding atau perbaikan langsung ke agent, dan agent akan mulai memproses codebase Anda menggunakan kekuatan model-model handal dari KoboiLLM!