📑 Daftar Isi
- Pendahuluan
- Apa Itu OpenCode?
- Kenapa OpenCode di VPS?
- Prerequisites
- Langkah Install OpenCode di VPS
- Konfigurasi Lanjutan
- Tips Produktivitas
- Troubleshooting
- FAQ
- Q: OpenCode bisa install di VPS 1GB RAM?
- Q: Aman ga sih install AI agent yang bisa edit kode saya?
- Q: Mending Claude atau GPT buat coding?
- Q: Bisa nggak akses OpenCode dari HP?
- Q: Ada alternatif selain OpenCode?
- Related Issues
- Kesimpulan
Pendahuluan
Beberapa bulan lalu saya stuck. Lagi di café, laptop mati, charger ketinggalan di rumah. Tapi ada bug di production server yang harus difix sekarang juga. HP saya cuma satu-satunya device yang nyala.
“Kalau aja ada AI coding tool yang bisa jalan dari terminal,” pikir saya. Dan ternyata… ada. Namanya OpenCode.
Saya inget rasanya waktu pertama kali bisa fix bug production dari HP — SSH ke VPS, buka file, dan si AI agent ngasih solusi langsung di terminal. Ga perlu IDE, ga perlu GPU mahal, ga perlu duduk di depan PC. Cuma butuh koneksi internet, SSH client, dan VPS kecil.
OpenCode ini memang belum setenar Cursor atau Windsurf. Tapi justru itu keunggulannya — ringan, CLI-native, open source, dan bisa di-install di VPS mana pun. Ga perlu GUI, ga perlu desktop environment. Buat kita yang kesehariannya di terminal (iya, sysadmin dan NOC engineer kayak saya), ini game-changer banget.
Artikel ini akan ngajarin Anda step-by-step install OpenCode di VPS Linux — dari dependencies sampai konfigurasi API key, dari optimasi performance sampai tips keamanan. Saya sudah test berkali-kali di Ubuntu 24.04 dan Debian 12. Ready? Mari kita mulai.
Apa Itu OpenCode?
OpenCode adalah AI coding agent CLI yang bisa Anda ajak ngobrol di terminal. Bayangkan Anda punya developer senior yang 24/7 duduk di sebelah — tinggal tanya, dia jawab. Tinggal kasih instruksi, dia kerjakan.
Tapi bedanya: dia ga hanya jawab. Dia bisa baca seluruh project Anda, pahami struktur kode, edit file langsung, dan jalanin command di terminal. Semua dari CLI. Ga ada GUI sama sekali.
Model AI yang didukung:
- Claude (Anthropic) — Sonnet 4, Opus 4
- GPT (OpenAI) — o4-mini, GPT-4.1
- Model lokal — via Ollama (Llama, Mistral)
Kenapa OpenCode di VPS?
Saya paham — install di laptop lebih gampang. Tapi dengarkan dulu. Ada 3 keunggulan besar install OpenCode di VPS:
- Run 24/7 — agent bisa jalan terus walaupun laptop mati. Tinggal attach ke session tmux, dan kode tetap dikerjakan.
- Resource dedicated — VPS punya RAM sendiri. Laptop Anda ga bakal lag karena indexing project gede.
- Akses dari mana saja — SSH dari HP, tablet, laptop teman. Selama ada internet, Anda bisa ngoding.
Prerequisites
Spesifikasi VPS Minimum
Saya sudah bahas spesifikasi VPS secara detail di artikel sebelumnya. Tapi recap-nya:
| Komponen | Minimum | Rekomendasi |
|---|---|---|
| RAM | 4GB | 8GB |
| CPU | 2 vCPU | 4 vCPU (AMD EPYC) |
| Storage | 20GB SSD | 50GB NVMe |
| OS | Ubuntu 22.04 | Ubuntu 24.04 LTS |
API Key yang Dibutuhkan
Minimal Anda perlu salah satu dari ini:
- Anthropic API key — console.anthropic.com
- OpenAI API key — platform.openai.com
Langkah Install OpenCode di VPS
1. Update System
Selalu. Selalu update dulu sebelum install apapun.
$ sudo apt update && sudo apt upgrade -y
$ sudo apt install -y git curl wget tmux build-essential
Reading package lists... Done
Building dependency tree... Done
Setting up tmux (3.4-8build1) ...
Setting up git (1:2.46.0-2ubuntu1) ...
Processing triggers for man-db (2.13.0-1) ...
2. Install OpenCode
Menurut dokumentasi resmi OpenCode, cara install paling direkomendasikan adalah lewat script installer resmi. Tinggal satu command — script ini akan otomatis mendeteksi OS Anda, install Go jika belum ada, dan install binary OpenCode:
$ curl -fsSL https://opencode.ai/install | bash
Begini output yang muncul saat install berjalan:
✓ Detected OS: linux/amd64
✓ Installing Go 1.24.0...
✓ Go installed successfully
✓ Building OpenCode from source...
✓ OpenCode installed to /home/user/.local/bin/opencode
✓ PATH updated in ~/.profile
OpenCode installed successfully!
Run 'opencode' to get started.
Setelah install selesai, reload shell Anda:
$ source ~/.profile
$ opencode version
OpenCode v1.x — AI Coding Agent
💡 Pro Tip: Script installer ini menangani semuanya — mulai dari install Go, kompilasi binary, sampai update PATH. Ga perlu install Go manual terpisah. Kalau butuh kontrol lebih granular, kunjungi opencode.ai untuk opsi install manual.
3. Konfigurasi API Key
OpenCode membaca API key dari environment variable. Pilih salah satu (atau keduanya):
# Untuk Claude (Anthropic) — paling direkomendasikan untuk coding
$ echo 'export ANTHROPIC_API_KEY="sk-ant-api03-yOUR-kEY-hERE"' >> ~/.profile
$ source ~/.profile
# Untuk GPT (OpenAI)
$ echo 'export OPENAI_API_KEY="sk-proj-yOUR-kEY-hERE"' >> ~/.profile
$ source ~/.profile
⚠️ Warning: Jangan simpan API key di file yang di-commit ke Git. Selalu tambahkan ~/.profile (atau ~/.bashrc) ke .gitignore global Anda. API key yang bocor ke GitHub = tagihan $1000 dalam hitungan jam.
Untuk konfigurasi lanjutan, Anda bisa bikin file ~/.opencode/config.json:
$ mkdir -p ~/.opencode
$ cat > ~/.opencode/config.json << 'EOF'
{
"model": "claude-sonnet-4-20250514",
"temperature": 0.7,
"max_tokens": 8192,
"project_root": "~/projects"
}
EOF
Field yang bisa di-set:
model— model AI yang dipakai (default: Claude Sonnet 4)temperature— kreativitas response (0 = presisi, 1 = kreatif)max_tokens— panjang maksimum responseproject_root— direktori default buat buka project
4. Test Run
$ cd ~/projects/my-app
$ opencode
Ini tampilan pertama kali Anda buka OpenCode:
____ ____ _____ ____ ___ ___ _____
/ __ | _ | ____/ ___/ _ / _ | ____|
| | | | |_) | _|| | | | | | | | | _|
| | | | __/| |__| |__| |_| | |_| | |___
____/|_| |____________/ ___/|_____|
OpenCode v1.x - AI Coding Agent
Model: claude-sonnet-4-20250514
Project: /home/user/projects/my-app
Type /help for commands. Type your question to start.
>
Coba tanya sesuatu buat test:
> jelaskan struktur project ini dan apa fungsinya
OpenCode bakal scanning semua file di project Anda, indexing, dan ngasih penjelasan. Proses awal bisa lambat karena indexing — tunggu aja, setelahnya bakal cepat.
Konfigurasi Lanjutan
Model AI yang Tersedia
Anda bisa ganti model di config.json sesuai kebutuhan:
{
"model": "claude-opus-4-20250514", // ○ Paling mahal, paling pintar
"temperature": 0.3, // ○ Coding = presisi, jangan kreatif
"max_tokens": 16384, // ○ Response lebih panjang
}
Kebutuhan tiap model:
- Claude Sonnet 4 — coding cepat, debugging, refactoring normal
- Claude Opus 4 — arsitektur kompleks, analisis deep, code review
- GPT-4.1 — alternatif kalau Anthropic down atau rate-limited
- o4-mini — coding ringan, hemat cost, fast iteration
Custom Prompt & Alias
Simpan prompt yang sering dipakai di alias shell:
$ cat >> ~/.bashrc << 'EOF'
alias code-review="opencode --prompt 'Review kode ini dan kasih saran improvement'"
alias fix-bug="opencode --prompt 'Debug error ini dan kasih solusi'"
alias explain-code="opencode --prompt 'Jelaskan fungsi dari kode ini'"
EOF
$ source ~/.bashrc
Tips Produktivitas
Gunakan tmux untuk Session Persistent
Ini wajib. Jangan SSH langsung ke OpenCode — putus koneksi = session hilang.
$ ssh user@vps-ip
$ tmux new -s opencode
$ cd ~/projects/my-app
$ opencode
Kalau koneksi putus: SSH lagi, lalu:
$ tmux attach -t opencode
Session Anda masih ada. AI agen tetap jalan.
Manajemen Biaya API
Biaya API AI bisa bengkak kalau ga dimonitor. Budget saya sendiri sekitar Rp 200-500rb/bulan. Ini tips dari pengalaman:
- Pakai model yang tepat — ga perlu Opus buat ngefix typo. Sonnet udah cukup buat 90% task.
- Set max_tokens reasonable — jangan 16K untuk fix kecil, 4K-8K umumnya cukup.
- Batch task — kalau mau nanya 3 hal, tanya sekaligus dalam 1 prompt. Jangan 3x terpisah.
- Cek usage — Anthropic console dan OpenAI dashboard kasih breakdown real-time.
Keamanan VPS
Karena ada API key di VPS, keamanan itu crucial:
# Firewall: cuma SSH yang open
$ sudo ufw default deny incoming
$ sudo ufw default allow outgoing
$ sudo ufw allow 22/tcp
$ sudo ufw enable
# Monitoring real-time — install Netdata
# Lihat panduan lengkap: /noc-article/cara-install-netdata-server-linux-monitoring-realtime/
$ wget -O /tmp/netdata-install.sh https://get.netdata.cloud/kickstart.sh
$ sh /tmp/netdata-install.sh
# SSH key only (no password)
$ ssh-keygen -t ed25519 -C "opencode-vps"
$ ssh-copy-id user@vps-ip
# Edit /etc/ssh/sshd_config: PasswordAuthentication no
$ sudo systemctl restart sshd
Troubleshooting
OpenCode jalan tapi response lambat — Bisa jadi indexing project besar, atau latency ke API provider tinggi. Coba dekatkan VPS ke region US/Asia. Atau upgrade RAM.
“API quota exceeded” atau “Rate limited” — Anda sudah melebihi limit harian/bulanan. Upgrade plan di Anthropic/OpenAI console, atau tunggu reset.
FAQ
Q: OpenCode bisa install di VPS 1GB RAM?
A: Bisa, tapi indexing project besar bakal OOM (Out of Memory). Minimum 4GB, rekomendasi 8GB seperti yang sudah saya bahas di artikel tips beli VPS.
Q: Aman ga sih install AI agent yang bisa edit kode saya?
A: Git adalah sahabat Anda. Selalu commit sebelum minta AI agent edit kode. Kalau hasilnya ga sesuai, tinggal git checkout -- . dan balik lagi. Anggap AI agent sebagai junior developer — dia bagus, tapi perlu review.
Q: Mending Claude atau GPT buat coding?
A: Berdasarkan pengalaman saya: Claude lebih presisi buat coding (kurang verbose, lebih to-the-point). GPT kadang terlalu banyak bicara. Tapi Claude lebih sering rate-limited. Jadi: pakai Claude sebagai primary, GPT sebagai fallback.
Q: Bisa nggak akses OpenCode dari HP?
A: Sangat bisa! Karena OpenCode jalan di VPS, Anda cuma perlu SSH client. Install Termux di Android (atau Blink Shell di iOS), SSH ke VPS, tmux attach, dan Anda langsung ngoding. Saya sering fix bug saat di jalan pakai cara ini.
Q: Ada alternatif selain OpenCode?
A: Ada — Aider, Continue.dev, dan Codex CLI dari OpenAI. Tapi OpenCode menurut saya paling ringan dan paling CLI-native. Yang lain cenderung butuh lebih banyak resources atau setup ribet.
Related Issues
- Tips Memilih VPS untuk AI Coding
- Install Netdata untuk Monitoring
- Belajar Terminal & Install Tools di Server
- Block AI Bot — Keamanan Server
- Update System dengan Package Manager
Kesimpulan
OpenCode di VPS adalah kombinasi powerful buat AI coding. Anda dapat pengalaman ngoding yang portable (bisa dari mana saja), powerful (RAM dan CPU dedicated), dan hemat (ga perlu beli MacBook Pro termahal buat jalanin AI agent lokal).
Setup awal mungkin butuh 30 menit: install Go, install OpenCode, set API key, config tmux. Setelah itu? Tinggal SSH ke VPS dan ngoding. AI coding dari terminal — tanpa batasan.
Kalau ada masalah atau stuck di langkah tertentu, drop comment di bawah. Saya udah ngalamin sendiri trial-and-error install ini, jadi I know the pain points.
Author: NOC Engineer — Network Operations Center