Saat mencoba install OpenCode AI di Windows, mungkin kamu menemukan error seperti ini:

Invoke-WebRequest : A parameter cannot be found that matches parameter name 'fsSL'

atau:

The '<' operator is reserved for future use.

Tenang, ini bukan karena OpenCode AI rusak. Masalahnya biasanya karena command install yang digunakan ditujukan untuk terminal Linux/macOS, bukan PowerShell bawaan Windows.

Di artikel ini kita akan membahas:

  • Penyebab error install OpenCode AI di PowerShell
  • Cara install Git Bash di Windows
  • Cara install OpenCode AI dengan benar
  • Troubleshooting umum yang sering terjadi

Kenapa Error Saat Install OpenCode AI di PowerShell?

Command resmi dari OpenCode AI adalah:

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

Command tersebut normal digunakan di:

  • Linux
  • macOS
  • WSL
  • Git Bash

Masalahnya, di Windows PowerShell, perintah curl sebenarnya bukan curl asli Linux, melainkan alias dari PowerShell:

Invoke-WebRequest

Akibatnya, PowerShell mencoba membaca syntax Linux shell sebagai syntax PowerShell, dan akhirnya muncul berbagai error.


Solusi: Install Git Bash Terlebih Dahulu

Cara paling mudah adalah menggunakan Git Bash.

Git Bash memberikan environment terminal Linux ringan di Windows sehingga command seperti curl, bash, dan shell script bisa berjalan normal.


Step 1 — Download Git Bash

Untuk mendapatkan Git Bash, install Git for Windows terlebih dahulu.

Download di sini:

Git for Windows


Step 2 — Install Git Bash

Jalankan installer Git for Windows.

Untuk kebanyakan pengguna, cukup gunakan setting default sampai selesai.

Setelah install:

  • restart terminal
  • atau restart VS Code jika sedang terbuka

Step 3 — Membuka Git Bash

Ada beberapa cara membuka Git Bash.

Cara 1 — Dari Start Menu

Tekan tombol:

Windows

Lalu ketik:

Git Bash

Kemudian buka aplikasinya.

Cara 2 — Klik Kanan di Folder Project

Masuk ke folder project kamu, lalu:

  • klik kanan
  • pilih:
Open Git Bash here

Cara ini paling praktis untuk development.


Step 4 — Install OpenCode AI

Setelah Git Bash terbuka, jalankan command berikut:

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

Karena sekarang dijalankan di Git Bash, proses install biasanya akan berjalan normal.


Cara Cek Apakah Install Berhasil

Setelah selesai, coba jalankan:

opencode --version

Jika muncul nomor versi, berarti OpenCode AI berhasil terinstall.


Troubleshooting yang Sering Terjadi

1. curl: command not found

Biasanya Git Bash sudah membawa curl bawaan.

Jika tetap error:

  • reinstall Git for Windows
  • pastikan komponen Git Bash ikut terinstall

2. bash: command not found

Ini biasanya terjadi karena command masih dijalankan di:

  • PowerShell
  • CMD

Pastikan terminal yang digunakan adalah Git Bash.

Ciri Git Bash biasanya ada tulisan:

MINGW64

di bagian terminal.

3. opencode: command not found

Coba:

  • tutup Git Bash
  • buka lagi terminal
  • jalankan ulang command install

4. Node.js Belum Terinstall

Beberapa tools AI membutuhkan Node.js.

Cek dengan:

node -v

Kalau belum ada, install dari:

Node.js Official Website


Bonus: Menggunakan Git Bash di VS Code

Kalau kamu menggunakan Visual Studio Code, Git Bash bisa dijadikan terminal default.

Buka Command Palette:

Ctrl + Shift + P

Cari:

Terminal: Select Default Profile

Pilih:

Git Bash

Mulai sekarang terminal di VS Code otomatis menggunakan Git Bash.


Fix PATH Environment Windows

Kadang setelah install, command opencode belum kebaca.

Kalau muncul error seperti:

'opencode' is not recognized

berarti PATH environment belum ditambahkan.

Cara Menambahkan PATH

Buka:

Environment Variables

Lalu edit bagian:

Path

Tambahkan folder berikut:

C:\Users\USERNAME\.opencode\bin

Ganti USERNAME dengan username Windows kalian.

Setelah itu:

  • Klik OK
  • Restart terminal atau VSCode
  • Coba jalankan lagi:
opencode

Penutup

Sebagian besar error install OpenCode AI di Windows sebenarnya bukan karena aplikasinya bermasalah, tetapi karena command Linux dijalankan langsung di PowerShell.

Solusi paling aman dan mudah adalah:

  1. Install Git Bash
  2. Jalankan installer OpenCode AI melalui Git Bash

Dengan setup ini, proses install biasanya jauh lebih lancar dan minim error.