Clouvia RouterClouvia Router
CLI / TERMINAL AGENTv1.0 COMPATIBLEBuka Versi VS Code Extension (EXT)

Panduan Integrasi OpenCode CLI

OpenCode CLI adalah coding agent terminal otonom yang dapat menganalisis codebase, mengedit file, dan menjalankan pengujian langsung di Termux (Android), Terminal VPS Linux, macOS, maupun Windows.

OpenCode CLI Assistant

OFFICIAL

Setup otomatis dan alat perbaikan mandiri untuk Terminal Termux, Linux, macOS, dan Windows.

Status API Key:Belum Terisi (Pilih Solusi)
Perintah masih menggunakan placeholder template
1-Line Runner OpenCode CLITermux Android
curl -fsSL https://router.clouvia.id/setup/opencode.sh | bash
Otomatis pasang Ubuntu proot + launcher Termux + konfigurasi clouvia:coding-high.

01Panduan Instalasi Manual dari Nol

Jika Anda lebih suka memasang dan mengonfigurasi OpenCode CLI langkah demi langkah tanpa skrip otomatis.

Langkah 1: Pasang Node.js & npm di Sistem Anda

OpenCode CLI membutuhkan Node.js versi 18 atau lebih baru. Jalankan perintah sesuai perangkat Anda:

Termux (Android)pkg
pkg update -y && pkg install nodejs -y
Ubuntu / Debian VPSapt
sudo apt update && sudo apt install nodejs npm -y
macOSbrew
brew install node
Windows (PowerShell)winget
winget install OpenJS.NodeJS.LTS

Langkah 2: Pasang Paket OpenCode CLI Secara Global

Jalankan perintah instalasi global berikut di terminal Anda:

npm install -g opencode-ai@latest
Verifikasi instalasi dengan mengetik opencode --version. Jika nomor versi muncul, CLI siap digunakan.

Langkah 3: Konfigurasi File opencode.json

Buat direktori konfigurasi OpenCode dan simpan pengaturan provider Clouvia:

mkdir -p ~/.config/opencode

Isi file ~/.config/opencode/opencode.json dengan konfigurasi berikut:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "clouvia": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Clouvia Router",
      "options": {
        "baseURL": "https://router.clouvia.id/v1",
        "apiKey": "clv_live_API_KEY_ANDA"
      },
      "models": {
        "coding-high": {
          "name": "Coding High [ULTRA]",
          "limit": {
            "context": 128000,
            "output": 32768
          }
        },
        "claude-opus-4.8": {
          "name": "Claude Opus 4.8"
        },
        "claude-sonnet-4.6": {
          "name": "Claude Sonnet 4.6"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  },
  "model": "clouvia/coding-high"
}

Langkah 4: Jalankan OpenCode di Folder Proyek Anda

Masuk ke folder proyek Anda lalu jalankan perintah opencode:

cd /lokasi/folder/proyek-anda && opencode

Antarmuka TUI interaktif akan terbuka. Anda bisa langsung memberikan instruksi coding dalam bahasa Indonesia santai atau formal, misalnya:

> "Tolong analisis struktur folder dan buatkan unit test untuk modul auth"

02Perintah Pintas & Navigasi di Terminal OpenCode

PerintahFungsiKeterangan
/modelGanti model AI aktifPilih antara coding-high, claude-opus-4.8, atau sonnet
/compactKompresi riwayat sesiMeringkas percakapan lama agar hemat konteks token
/helpBantuan & daftar fiturMelihat kapabilitas tools agent yang tersedia
/exitKeluar dari sesi OpenCodeDapat juga menggunakan tombol Ctrl+C

03Fitur Auto-Fix & Diagnosis Mandiri (1-Command Repair)

AUTO-REPAIR TOOL

Jika instalasi OpenCode Anda mengalami kendala seperti error EBADPLATFORM pada Android Termux, dependensi Node.js rusak, atau API Key tidak terhubung, jalankan perintah Auto-Fix di bawah ini:

Terminal (Termux Android, Linux VPS, macOS)bash
curl -fsSL https://router.clouvia.id/setup/opencode-fix.sh | bash

Apa yang Diperbaiki Secara Otomatis oleh Auto-Fix:

Perbaikan Termux Android (EBADPLATFORM): Otomatis menyiapkan glibc runtime berbasis proot-distro Ubuntu sehingga OpenCode berjalan lancar tanpa batasan kernel Android.
Perbaikan Node.js & npm: Memeriksa kecukupan versi Node.js & npm, serta memperbaiki izin akses direktori global.
Perbaikan Konfigurasi: Memvalidasi struktur berkas opencode.json dan menyinkronkan endpoint Clouvia.
Uji Validasi Koneksi Gateway: Mengirimkan uji ping otomatis ke gateway untuk memastikan API Key aktif dan berstatus 200 OK.

04Solusi Masalah Umum (Troubleshooting)

npm error code EBADPLATFORM di Termux

OpenCode CLI membutuhkan glibc Linux. Cukup jalankan skrip auto-setup terbaru kami atau perintah auto-fix curl -fsSL https://router.clouvia.id/setup/opencode-fix.sh | bash untuk memasang container runtime Ubuntu secara otomatis.

Node: command not found di Termux

Jalankan perintah pkg update -y && pkg install nodejs -y di Termux. Jika masih gagal, pastikan Anda menggunakan aplikasi Termux resmi dari F-Droid, bukan versi lama Play Store.

Error 401: Unauthorized

Periksa kembali apakah API Key di ~/.config/opencode/opencode.json sudah benar dan tidak terpotong (tanda titik-titik). Gunakan tombol Buat Key Baru (1-Klik) di halaman ini untuk menyalin Full Secret Key.

Repository issues di Termux

Ketik perintah termux-change-repo di Termux, pilih Main Repository, dan pilih mirror Cloudflare atau Albatross untuk kecepatan download maksimal.