Menguasai OpenCode: Panduan Utama untuk Coding AI Local-First

OpenCode lebih dari sekadar asisten coding AI biasa. Ini adalah agen coding otonom local-first yang dirancang untuk bertindak sebagai programmer pasangan sejati. Tidak seperti alat pelengkap otomatis sederhana, OpenCode memahami seluruh repositori Anda, merencanakan refactor yang kompleks, dan mengeksekusi perintah terminal — sambil menjaga kode Anda tetap aman di mesin Anda.

Dalam panduan utama ini, kami akan membahas semua yang Anda butuhkan untuk beralih dari nol hingga menguasai fitur-fitur OpenCode yang paling canggih.

1. Instalasi: Gerbang Anda menuju Coding Otonom

Memulai dirancang agar tanpa hambatan. OpenCode berjalan secara native di terminal Anda, yang berarti ia bekerja di mana pun Anda bekerja — baik itu VS Code, JetBrains, atau shell mandiri.

Instal Cepat (Mac, Linux, Windows WSL)

Cara tercepat untuk menginstal adalah melalui skrip resmi kami:

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

Alternatif: Paket npm

Jika Anda lebih suka mengelola alat melalui Node.js, Anda dapat menginstal OpenCode secara global:

npm install -g opencode-ai

Setelah terinstal, cukup ketik opencode untuk memverifikasi instalasi dan meluncurkan UI.

2. Model & Penyedia: Pilihan Tanpa Batas (BYOK)

Salah satu filosofi inti OpenCode adalah Netralitas Model. Kami tidak mengunci Anda dalam satu model "kotak hitam". Sebaliknya, kami mengizinkan Anda membawa kunci Anda sendiri (BYOK) atau terhubung ke langganan AI Anda yang ada.

Mengautentikasi

Untuk menghubungkan penyedia model pilihan Anda, jalankan:

opencode auth login

Perintah interaktif ini akan memandu Anda masuk dengan:

• Anthropic (Claude 4.5 Sonnet, Opus)
• OpenAI (GPT-5, o1-preview)
• Google (Gemini 3 Pro, 1.5 Pro)
• Models.dev (Akses ke 75+ model open source & hosting)

Mengelola Model

Anda dapat mengganti model dengan cepat tergantung pada tugasnya. Gunakan model yang lebih cepat untuk perbaikan sederhana dan model penalaran yang lebih kuat untuk perencanaan arsitektur.

# Daftar semua model yang tersedia
opencode models

# Segarkan daftar model setelah menambahkan penyedia baru
opencode models --refresh

Go Local dengan Ollama

Untuk privasi tertinggi dan kemampuan offline, OpenCode mendukung model lokal melalui Ollama. Arahkan OpenCode ke instance lokal Anda untuk melakukan coding tanpa ada data yang meninggalkan jaringan Anda — sempurna untuk lingkungan perusahaan atau bekerja pada kekayaan intelektual sensitif.

3. Alur Kerja Inti: Interaktif vs. Sekali Jalan

OpenCode menyesuaikan dengan cara Anda ingin bekerja.

Sesi Interaktif

Cara paling ampuh untuk menggunakan OpenCode adalah Sesi Interaktif. Jalankan opencode di root proyek Anda untuk memasuki lingkungan obrolan yang persisten.

• Sadar Konteks: Agen membaca struktur file dan sinyal LSP Anda.
• Multi-Giliran: Anda dapat menyempurnakan rencana, meminta koreksi, dan melakukan iterasi.
• Penggunaan Alat: Agen dapat membaca file, mengedit kode, dan menjalankan pengujian secara otonom.

Perintah Sekali Jalan (One-Off)

Untuk tugas cepat di mana Anda tidak memerlukan percakapan penuh, gunakan opencode run. Ini sempurna untuk instruksi "fire and forget".

# Rangkum basis kode dan usulkan perbaikan
opencode run "Analyze this codebase and propose a refactoring plan for performance"

# Perbaikan cepat
opencode run "Fix the type error in src/utils/helper.ts"

4. Agen & Izin: Keamanan Terlebih Dahulu

Memberi AI akses ke terminal dan sistem file Anda membutuhkan kepercayaan. OpenCode menyelesaikan ini dengan Sistem Izin yang kuat dan Agen khusus.

Izin Granular

Anda mengontrol dengan tepat apa yang dapat dilakukan agen. Tetapkan izin secara global atau per sesi:

• Izinkan (Allow): Agen mengeksekusi perintah dan mengedit file secara otomatis.
• Tanya (Ask): Agen harus meminta persetujuan Anda untuk setiap tindakan (default untuk operasi sensitif).
• Tolak (Deny): Agen dilarang keras melakukan tindakan tersebut.

Agen Khusus: Rencanakan vs. Bangun

Untuk meminimalkan risiko, kami menyarankan alur kerja terpisah:

1. Agen Perencana (Plan Agent): Gunakan model "Perencana" untuk menganalisis kode dan menyusun strategi. Pertahankan agen ini dalam mode Hanya Baca atau Tanya.
2. Agen Pembangun (Build Agent): Setelah rencana disetujui, beralihlah ke agen "Pembangun" dengan izin Izinkan untuk mengeksekusi perubahan dengan cepat.

5. Fitur Lanjutan: Multi-Sesi & Berbagi

Rekayasa dunia nyata tidak linier. OpenCode mendukung alur kerja tingkat lanjut untuk memenuhi kebutuhan multitasking Anda.

Sesi Paralel

Jangan biarkan refactor yang berjalan lama memblokir perbaikan bug cepat Anda. OpenCode memungkinkan Anda menjalankan beberapa sesi paralel.

• Sesi A: "Refactor middleware autentikasi."
• Sesi B: "Perbaiki bug z-index CSS di beranda."

Sesi ini beroperasi secara independen, memastikan konteks tidak bercampur antar tugas.

Tautan yang Dapat Dibagikan

Perlu menunjukkan kepada rekan satu tim apa yang dilakukan AI? Gunakan /share untuk menghasilkan log sesi Anda yang hanya-baca dan ketat.

• Kolaborasi: Kirim tautan ke peninjau PR sehingga mereka dapat melihat mengapa perubahan dilakukan.
• Dokumentasi: Simpan sesi yang sukses sebagai "resep" untuk tugas di masa mendatang.
• Kontrol Privasi: Berbagi dinonaktifkan secara default. Anda secara eksplisit mengontrol apa yang dipublikasikan.

Kesimpulan

OpenCode dibangun untuk pengembang yang menginginkan kekuatan AI tanpa mengorbankan kontrol atau privasi. Dengan menguasai alur kerja ini — memilih model yang tepat, memanfaatkan izin granular, dan menggunakan sesi paralel — Anda dapat mengubah OpenCode dari sekadar pembantu sederhana menjadi mitra otonom yang tak kenal lelah.

Siap untuk memulai? Instal OpenCode sekarang dan rasakan masa depan rekayasa local-first.