Cara Install OpenCode di Ubuntu 24.04

OpenCode adalah AI coding agent berbasis terminal yang binary-nya bisa dipasang di dalam direktori home, sehingga instalasi tidak memerlukan akses root dan tidak menyentuh direktori sistem. Artikel ini memasang OpenCode di Ubuntu 24.04, menyiapkan PATH, lalu memastikan binary benar-benar berjalan.

Requirements

• Non Root User.
• curl dan tar.

Artikel ini menggunakan Ubuntu 24.04 LTS. Terminal emulator modern bersifat opsional jika Anda hanya menjalankan verifikasi non-interaktif. Pemeriksaan home directory dan paket yang tersedia dilakukan pada langkah instalasi.

Environment

• Ubuntu 24.04 LTS.
• x64 atau arm64.
• Hak akses akun aktif.
• $HOME/.opencode/bin.
• https://opencode.ai/install.

Script installer resmi menempatkan binary di $HOME/.opencode/bin secara default. Karena lokasinya di dalam home directory, proses instalasi berjalan dengan hak user Anda dan sudo tidak dipakai. Contoh perintah di artikel ini memakai $HOME; pada contoh output, <user> adalah nama user Anda.

Cara Install OpenCode

1. Pastikan prasyarat tersedia

Jalankan pemeriksaan berikut sebelum mengunduh apa pun.

command -v curl tar

Perintah ini mencetak path kedua utilitas:

/usr/bin/curl
/usr/bin/tar

Jika salah satu path tidak muncul, pasang paket yang kurang dengan sudo apt update && sudo apt install -y curl tar.

2. Catat home directory dan target instalasi

echo "$HOME"
test -w "$HOME" && echo "home writable"

Output:

/home/<user>
home writable

Instalasi hanya menulis ke $HOME/.opencode/bin. Direktori sistem seperti /usr/local/bin tidak ikut berubah.

3. Jalankan Script installer

curl -fsSL https://opencode.ai/install | bash

Script ini mengunduh paket rilis, mengekstrak binary opencode, dan menyalinnya ke $HOME/.opencode/bin. Setelah itu, binary ditandai executable dan installer memilih file startup shell yang tersedia untuk menambahkan PATH. Untuk Bash, file tersebut dapat berupa ~/.bashrc, ~/.bash_profile, ~/.profile, atau lokasi XDG. Anda juga dapat menonaktifkan perubahan PATH dengan opsi --no-modify-path. Tidak ada perintah sudo di dalam alur ini.

Info

curl | bash menjalankan Script dari domain resmi opencode.ai memakai hak user Anda. Jika kebijakan internal mewajibkan tinjauan manual, unduh Scriptnya lebih dulu dengan curl -fsSL https://opencode.ai/install -o /tmp/opencode-install.sh, periksa isinya, lalu jalankan bash /tmp/opencode-install.sh.

4. Muat PATH pada shell yang sedang aktif

Shell yang sudah berjalan belum membaca ulang file konfigurasi, jadi tambahkan direktori instalasi ke PATH untuk sesi ini.

export PATH="$HOME/.opencode/bin:$PATH"

Setelah perintah ini, opencode bisa dipanggil tanpa path absolut. Shell berikutnya akan memuat PATH secara otomatis hanya jika installer berhasil menulisnya ke file startup yang digunakan shell tersebut.

Verifikasi Instalasi OpenCode di Ubuntu 24.04

Konfirmasi bahwa binary tersalin di home directory dan bisa dipanggil tanpa akses root.

stat -c '%A %n' "$HOME/.opencode/bin/opencode"
test -x "$HOME/.opencode/bin/opencode" && echo "binary executable"

Output:

-rwxr-xr-x /home/<user>/.opencode/bin/opencode
binary executable

Cek resolusi PATH:

command -v opencode

Output:

/home/<user>/.opencode/bin/opencode

Baca versi yang terpasang:

opencode --version

Perintah ini mencetak nomor versi rilis yang baru dipasang. Angkanya mengikuti rilis terbaru pada saat instalasi, jadi versi di mesin Anda bisa berbeda.

Konfigurasi Dasar

Menyimpan PATH untuk shell berikutnya

Installer menulis baris PATH ke file startup shell yang dipilihnya. Untuk Bash, periksa file yang umum digunakan berikut.

grep -n 'opencode/bin' "$HOME/.bashrc"

Perintah ini mencetak nomor baris dan isi barisnya, misalnya export PATH=/home/<user>/.opencode/bin:$PATH. Jika tidak ada output, periksa ~/.bash_profile, ~/.profile, atau file startup di lokasi XDG yang digunakan shell Anda.

Jika installer dijalankan dengan --no-modify-path atau belum menulis PATH, buka file startup yang digunakan shell Anda dengan text editor pilihan, misalnya nano "$HOME/.bashrc" atau vim "$HOME/.bashrc". Tambahkan baris export PATH="$HOME/.opencode/bin:$PATH", lalu muat file tersebut dengan source "$HOME/.bashrc" setelah menyimpan.

Menonaktifkan pemeriksaan update otomatis

OpenCode memeriksa update saat dijalankan. Pada mesin bersama atau koneksi terbatas, pemeriksaan itu bisa dimatikan lewat variabel lingkungan OPENCODE_DISABLE_AUTOUPDATE. Tambahkan variabel ini ke file startup yang dipilih installer atau digunakan shell Anda. Contoh berikut memakai ~/.bashrc; pada sistem lain, gunakan ~/.bash_profile, ~/.profile, atau path konfigurasi XDG yang sesuai.

echo 'export OPENCODE_DISABLE_AUTOUPDATE=true' | tee -a "$HOME/.bashrc"

Variabel ini menonaktifkan pemeriksaan dan pembaruan otomatis. Anda tetap dapat menjalankan update secara manual.

Memperbarui versi

Karena binary berada di home directory, update tidak memerlukan root.

opencode upgrade

Perintah ini mengunduh rilis terbaru dan menggantikan binary di $HOME/.opencode/bin. Gunakan --method curl jika Anda ingin memilih metode instalasi Script tersebut secara eksplisit.

Pengujian Fungsional

Pengujian ini memastikan binary tidak hanya ada, tetapi benar-benar dieksekusi oleh shell.

Jalankan versi dan cek kode keluar:

opencode --version && echo "exit 0"

Output:

<versi rilis>
exit 0

Tampilkan daftar perintah CLI untuk membuktikan dispatcher perintah bekerja:

opencode --help

Keluaran perintah ini menampilkan perintah yang tersedia pada versi terpasang. Daftarnya dapat berbeda antarversi.

Info

Pengujian fungsi penuh, misalnya opencode run, memerlukan konfigurasi kredensial provider. Salah satu caranya melalui opencode auth login. Konfigurasi provider berada di luar cakupan artikel instalasi ini.

Troubleshooting

1. bash: opencode: command not found

Penyebab: PATH belum dimuat di sesi aktif, atau baris PATH tidak tertulis ke file startup shell yang digunakan. Perbaikan: jalankan export PATH="$HOME/.opencode/bin:$PATH", lalu buka sesi login baru. Jika tetap gagal, cek ~/.bashrc, ~/.bash_profile, ~/.profile, dan lokasi startup XDG yang relevan. Tambahkan baris PATH secara manual bila perlu.

2. curl: (6) Could not resolve host: opencode.ai

Penyebab: DNS atau koneksi keluar terblokir. Perbaikan: uji resolusi dengan getent hosts opencode.ai, lalu cek pengaturan proxy pada environment sebelum mengulang installer.

3. mkdir: cannot create directory '/home/<user>/.opencode/bin': Permission denied

Penyebab: home directory tidak bisa ditulis, biasanya karena kepemilikan file berubah. Perbaikan: periksa dengan ls -ld "$HOME" dan stat -c '%U %a' "$HOME", lalu minta administrator memperbaiki kepemilikan home directory Anda.

4. opencode --version gagal padahal binary ada

Penyebab: binary tidak executable, misalnya akibat unduhan yang terputus. Perbaikan: cek dengan ls -l "$HOME/.opencode/bin/opencode", lalu ulangi installer dengan curl -fsSL https://opencode.ai/install | bash.

Verifikasi

Semua perintah menggunakan atau menulis ke home directory dan tidak memerlukan sudo.

1. Binary tersalin dan executable: test -x "$HOME/.opencode/bin/opencode" && echo "binary executable" mencetak binary executable.
2. PATH memuat direktori instalasi: command -v opencode mencetak path di dalam $HOME/.opencode/bin.
3. Binary berjalan: opencode --version mencetak nomor versi dan mengembalikan kode keluar 0.
4. Perintah CLI dikenali: opencode --help menampilkan bantuan untuk versi yang terpasang. Perintah yang tersedia dapat berbeda antarversi.