Tutorial OpenCode: Setup AI Coding Agent Open Source di Terminal

OpenCode adalah AI coding agent open source yang sedang naik daun di kalangan developer global. Dengan lebih dari 160.000 bintang GitHub, 900 kontributor aktif, dan 7,5 juta pengguna aktif bulanan, tool ini menawarkan alternatif gratis yang kompetitif untuk Claude Code, GitHub Copilot Chat, dan Cursor. Yang paling menarik, OpenCode tidak menyimpan kode atau konteks proyek kamu di server eksternal, sehingga sangat cocok untuk environment enterprise yang sensitif terhadap privasi dan compliance.

Dalam tutorial lengkap ini, kita akan membahas cara menginstal OpenCode di terminal, menghubungkannya dengan berbagai provider LLM mulai dari OpenAI hingga model lokal via Ollama, dan memulai sesi coding pertama dengan benar. Semua langkah dirancang agar bisa diikuti oleh developer Indonesia yang menggunakan macOS, Linux, atau Windows dengan WSL2.

Apa itu OpenCode dan Mengapa Harus Mencobanya

OpenCode dikembangkan sebagai agent yang membantu menulis kode di terminal, IDE, atau desktop. Berbeda dengan AI coding assistant proprietary lainnya, OpenCode adalah proyek open source murni dengan fitur unik yang jarang ditemukan di kompetitor. Fitur andalan meliputi LSP-aware context yang otomatis memuat Language Server Protocol sesuai stack proyek, multi-session agent yang bisa berjalan paralel, dan shareable links untuk kolaborasi tim.

Kamu bisa login dengan GitHub Copilot, ChatGPT Plus, atau menghubungkan model lokal via Ollama. Fitur Zen mode menyediakan model AI yang telah diuji dan dioptimasi khusus untuk coding agent, menghilangkan rasa khawatir soal kualitas model yang tidak konsisten antar provider. Ini berarti kamu tidak perlu lagi trial and error memilih model yang tepat untuk setiap task.

Persiapan Sebelum Instalasi

Sebelum mulai, pastikan sistem kamu memenuhi prasyarat berikut agar instalasi berjalan lancar tanpa kendala:

Node.js versi 18 atau lebih baru, disarankan versi LTS terbaru
npm atau yarn yang terinstal dengan baik dan dapat diakses dari terminal
Git untuk cloning repository (opsional, jika ingin build from source)
Akun LLM provider: OpenAI, Anthropic, Google, OpenRouter, atau model lokal via Ollama
Terminal yang mendukung Unicode dan emoji untuk pengalaman optimal

Untuk pengguna Windows, disarankan menjalankan OpenCode di WSL2 karena beberapa fitur terminal native seperti job control dan pseudo-terminal masih lebih optimal di environment Unix-like. Pengguna macOS bisa menggunakan Terminal.app, iTerm2, atau Warp.

Langkah 1: Instalasi OpenCode via npm

Cara termudah dan paling direkomendasikan untuk menginstal OpenCode adalah menggunakan npm registry. Jalankan perintah berikut di terminal:

npm install -g opencode

Perintah ini akan mengunduh binary pre-built untuk platform kamu dan menginstalnya secara global. Setelah instalasi selesai, verifikasi dengan menjalankan:

opencode --version

Jika muncul versi terbaru (misalnya 1.2.0), berarti instalasi berhasil. Alternatifnya, kamu bisa mengunduh binary pre-built langsung dari halaman release GitHub untuk platform yang tidak didukung npm atau jika ingin versi cutting-edge.

Untuk build from source, clone repository utama dan jalankan npm install di direktori root. Ini memerlukan Rust toolchain untuk beberapa komponen native. Build from source direkomendasikan hanya untuk kontributor atau jika kamu perlu mengkustomisasi behavior agent.

Langkah 2: Autentikasi dengan LLM Provider

OpenCode mendukung lebih dari 75 provider LLM melalui integrasi Models.dev. Untuk memulai, kamu perlu mengatur API key dari provider pilihan. Contoh untuk OpenAI:

export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx

Atau tambahkan ke file .bashrc, .zshrc, atau file .env di proyek kamu agar persisten antar sesi terminal. Untuk provider lain, gunakan variabel environment yang sesuai:

Anthropic: ANTHROPIC_API_KEY
Google: GEMINI_API_KEY
OpenRouter: OPENROUTER_API_KEY
Groq: GROQ_API_KEY

Kamu juga bisa login dengan GitHub untuk menggunakan akun Copilot atau login dengan OpenAI untuk menggunakan ChatGPT Plus/Pro. Fitur ini terintegrasi secara native dan tidak memerlukan API key manual. Untuk model lokal, jalankan Ollama di background dan OpenCode akan otomatis mendeteksi endpoint http://localhost:11434.

Langkah 3: Memulai Sesi Coding Pertama

Untuk memulai, navigasi ke direktori proyek kamu dan jalankan command sederhana:

cd /path/to/project
opencode

Agent akan otomatis menganalisis struktur proyek, mendeteksi bahasa pemrograman utama, dan memuat LSP (Language Server Protocol) yang relevan. Proses ini memungkinkan OpenCode memberikan suggestion yang kontekstual dan aware terhadap codebase, bukan sekadar generik seperti chatbot biasa.

Kamu bisa memberikan instruksi langsung dalam bahasa alami. Misalnya:

 Buatkan fungsi untuk validasi email dengan regex di Python yang kompatibel dengan RFC 5322

Atau untuk task yang lebih kompleks:

 Refactor file ini agar mengikuti pattern SOLID dan tambahkan unit test untuk setiap class

OpenCode akan memproses permintaan, menampilkan reasoning step-by-step, dan menawarkan untuk menerapkan perubahan secara langsung ke file proyek. Kamu bisa mereview diff sebelum menerima atau menolak perubahan.

Langkah 4: Multi-Session dan Shareable Links

Salah satu fitur premium OpenCode adalah kemampuan menjalankan multiple agent dalam paralel pada proyek yang sama. Ini berguna ketika kamu mengerjakan beberapa task independen secara bersamaan, seperti refactoring sambil menulis dokumentasi.

Untuk memulai session baru dengan nama yang deskriptif, gunakan flag:

opencode --session refactor-task

Setiap session memiliki konteks dan history terpisah. Kamu bisa berpindah antar session tanpa kehilangan konteks. Setiap session juga bisa di-share melalui link unik yang berisi seluruh konteks percakapan dan perubahan yang diusulkan. Ini memudahkan kolaborasi dengan rekan tim atau dokumentasi debugging.

Langkah 5: Instalasi IDE Extension dan Desktop App

Selain terminal, OpenCode tersedia sebagai IDE extension untuk VS Code, JetBrains, dan Vim/Neovim. Extension ini menyediakan chat panel terintegrasi langsung di editor favorit kamu, sehingga tidak perlu switching window saat coding.

Untuk VS Code, cari OpenCode di marketplace dan klik install. Setelah terpasang, panel chat akan muncul di sidebar. Semua session terminal tersinkron otomatis dengan IDE extension. Desktop app tersedia untuk macOS, Windows, dan Linux. Unduh dari situs resmi OpenCode untuk pengalaman GUI yang lebih visual dengan drag-and-drop file support.

Tips Produktif Menggunakan OpenCode

Berikut beberapa tips agar pengalaman coding dengan OpenCode lebih optimal dan efisien:

Gunakan mode Zen untuk model yang telah diuji benchmark khusus coding agar kualitas output lebih konsisten
Manfaatkan /context untuk memberikan file atau direktori spesifik sebagai konteks tambahan
Gunakan /diff untuk melihat perubahan sebelum menerapkan ke codebase
Integrasikan dengan pre-commit hooks agar setiap perubahan dicek linter otomatis
Gunakan /debug untuk trace execution dan menemukan bug dengan lebih cepat

Dengan mengikuti panduan ini, kamu sudah memiliki AI coding agent yang powerful, privasi-first, dan sepenuhnya open source di workstation. Selamat mencoba dan semoga produktivitas coding meningkat signifikan.