Clouvia RouterRouter ClouviaID
CLI / TERMINAL AGENT100+ MODEL AKTIF TERSEDIABuka 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 dengan akses ke seluruh model aktif Clouvia Router.

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: Unduh & Sinkronkan Seluruh Model Aktif Otomatis

Agar OpenCode CLI mengenali seluruh 100+ model aktif (bukan hanya 4 model), buat folder konfigurasi lalu unduh file konfigurasi otomatis satu baris:

mkdir -p ~/.config/opencode

Jalankan perintah curl satu baris ini (ganti clv_live_API_KEY_ANDA dengan API Key Anda):

curl -fsSL "https://router.clouvia.id/api/models/opencode-config?key=clv_live_API_KEY_ANDA" > ~/.config/opencode/opencode.json
💡 Tips Sinkronisasi Cepat:Jika Anda memasang melalui skrip auto-setup, cukup ketik perintah opencode-sync di terminal kapan saja untuk menyinkronkan model-model terbaru dari Clouvia Router secara instan!

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 aktifMenampilkan seluruh 100+ model Clouvia (coding-high, opus, sonnet, gpt-5.5, dll.)
opencode-syncSinkronkan model terbaruPerintah terminal untuk memperbarui daftar model secara instan
/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 model hanya muncul 4 buah, 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:

Sinkronisasi Seluruh Model (100+ Model): Memperbaiki konfigurasi opencode.json lama yang hanya berisi 4 model menjadi seluruh katalog model aktif Clouvia.
Perbaikan Termux Android (EBADPLATFORM): Otomatis menyiapkan glibc runtime berbasis proot-distro Ubuntu sehingga OpenCode berjalan lancar tanpa batasan kernel Android.
Pemasangan Perintah opencode-sync: Menambahkan tool helper opencode-sync agar Anda dapat memperbarui model kapan saja dengan satu perintah.
Uji Validasi Koneksi Gateway: Mengirimkan uji ping otomatis ke gateway untuk memastikan API Key aktif dan berstatus 200 OK.

04Solusi Masalah Umum (Troubleshooting)

Model di OpenCode Hanya Muncul 4 Buah?

Jalankan perintah opencode-sync di terminal, atau jalankan curl -fsSL https://router.clouvia.id/setup/opencode-fix.sh | bash. Seluruh 100+ model Clouvia akan langsung disinkronkan ke dalam OpenCode Anda!

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.