OpenCode: instalasi, model, dan penggunaan pertama

OpenCode adalah agen coding AI sumber terbuka untuk terminal: alatnya sendiri gratis (lisensi MIT), dan Anda dapat menghubungkan model apa pun—mulai dari Claude dan GPT hingga model lokal melalui Ollama. Repositori proyek ini telah melampaui dua ratus ribu bintang di GitHub. Frasa “Claude Code gratis dengan model apa pun” terdengar menarik, tetapi perlu diperjelas: alatnya gratis; ketentuan penggunaan bergantung pada model yang Anda pilih.

Berikut ini semua informasi berdasarkan dokumentasi resmi: apa itu alat ini, cara menginstalnya di macOS, Linux, atau Windows, cara menghubungkan model, dan apa yang perlu dilakukan saat pertama kali menjalankannya. Ada bagian tersendiri tentang biaya, karena “gratis” di sini hanya berlaku untuk alatnya: model berbayar, dan hal itulah yang paling sering menimbulkan kebingungan.

Informasi praktis tentang penggunaan Ailoot tersedia di dokumentasi.

Apa itu OpenCode secara sederhana?#

Singkatnya, OpenCode melakukan hal yang sama seperti Claude Code: menerima tugas dalam bahasa biasa dan mengerjakannya di proyek Anda. Keduanya berbeda dalam dua hal. Kodenya sepenuhnya terbuka, sehingga Anda dapat membaca dan memeriksanya. Selain itu, alat ini tidak terikat pada satu penyedia model: OpenCode bekerja dengan 75+ penyedia, dari Anthropic dan OpenAI hingga model lokal yang berjalan di perangkat keras Anda.

Proyek ini dikembangkan oleh tim Anomaly. Repositorinya dibuat pada 30 April 2025, dan per 4 Oktober 2026, repositori tersebut memiliki lebih dari 211 ribu bintang dan 28 ribu fork (diverifikasi dengan permintaan API GitHub). Bahasa pemrogramannya adalah TypeScript. Dokumentasi terus diperbarui, jadi petunjuk di bawah ini didasarkan pada versi terkini.

Jangan samakan namanya: paket npm untuk lini saat ini bernama opencode-ai, repositorinya anomalyco/opencode, dan perintah terminalnya cukup opencode. Artikel lama mungkin menggunakan alamat sst/opencode: nama organisasi telah berubah, dan tautan lama kini mengarah ke yang baru.

Diperbarui 4 Oktober 2026: tim merilis OpenCode 2.0, generasi utama berikutnya dari alat ini. Petunjuk instalasi dan koneksi model di bawah ini masih ditulis untuk lini 1.x saat ini (diinstal dengan perintah curl -fsSL https://opencode.ai/install | bash; versi terkini per 30 September 2026 adalah 1.18.34): versi ini masih didukung secara aktif, dan merupakan versi yang dipasang oleh dokumentasi resmi di opencode.ai/docs. Perubahan persis pada versi kedua dan kapan sebaiknya beralih dibahas di bagian tersendiri di bawah.

Apa perbedaan OpenCode dengan Claude Code dan Codex?#

Jika Anda sudah memiliki langganan Claude, masuk akal untuk tetap menggunakan Claude Code sebagai alat utama—kami memiliki panduan instalasi terperinci tentangnya. OpenCode cocok dalam tiga situasi: Anda ingin bekerja melalui langganan ChatGPT Plus atau GitHub Copilot, menjalankan model lokal tanpa tagihan API, atau menggunakan satu antarmuka untuk beberapa model. Kami juga memiliki ulasan dan panduan instalasi untuk Codex.

Jika Anda masih memilih alat, mulailah dengan ikhtisar ini: apa yang digunakan orang untuk coding pada 2026. Dan jika OpenCode sudah terinstal dan Anda perlu menghubungkannya dengan agen lain di Devin Desktop melalui ACP, lihat panduan konfigurasi tersebut.

Apa yang berubah di OpenCode 2.0?#

Versi kedua diinstal dengan perintah curl -fsSL https://opencode.ai/v2/install | bash. Menurut panduan migrasi resmi (opencode.ai/v2/docs/migrate-v1), kedua versi menggunakan perintah opencode yang sama dan secara bawaan tidak lagi diinstal berdampingan: installer v2 menggantikan biner v1, dan sebelum memasang v2 melalui pengelola paket, dokumentasi secara eksplisit meminta Anda menghapus versi v1 terlebih dahulu. Namun, konfigurasi dibaca dari file yang sama—~/.config/opencode/ dan <project>/.opencode/—jadi pengaturan, agen, dan server MCP berpindah tanpa perlu ditulis ulang. Tiga hal yang memang perlu ditulis ulang: plugin (memiliki API baru), integrasi dengan server API (protokolnya berubah), dan pengaturan terminal (kini satu file cli.json bersama, menggantikan beberapa file tui.json).

Dua fitur baru yang paling menonjol di v2 adalah sebagai berikut. Pertama, Console diperkenalkan—layanan berbayar untuk tim dengan pelacakan penggunaan, anggaran, dan kebijakan bersama bagi semua anggota. Kedua, tim akhirnya mengumumkan harga langganan Go: $10 per bulan untuk Go dan $40 per bulan untuk Go Plus dengan batas yang lebih tinggi (halaman opencode.ai/go, diverifikasi 4 Oktober 2026). Sebelumnya, dokumentasi hanya menyebut “langganan berbiaya rendah”, tanpa angka.

Jika Anda baru mulai dan hanya ingin memasang agen, ikuti petunjuk di bawah; panduan tersebut mencakup versi pertama saat ini yang direkomendasikan oleh dokumentasi. Pertimbangkan v2 jika Anda membutuhkan fitur plugin baru atau Console untuk tim—tetapi bersiaplah untuk menulis ulang beberapa plugin lama agar sesuai dengan API baru. Jika Anda lebih tertarik pada aplikasi desktop sumber terbuka yang tidak memerlukan terminal, kami memiliki ulasan ZCode, agen serupa lainnya dengan antarmukanya sendiri.

Apa yang diperlukan sebelum menginstal?#

Sedikit lebih lanjut tentang terminal, karena hanya di sinilah instalasi mungkin tidak berjalan sesuai rencana. OpenCode menampilkan antarmuka lengkap dengan panel dan penyorotan di terminal, itulah sebabnya dokumentasi meminta emulator modern. Jika antarmuka terlihat salah setelah dijalankan, pertama-tama instal salah satu dari empat opsi yang disebutkan: WezTerm (berfungsi di semua sistem), Alacritty, Ghostty, atau Kitty. Di Windows, jalur utama adalah melalui WSL; bagian tersendiri tentang hal itu tersedia di bawah.

Hal kedua adalah model. OpenCode bekerja melalui model yang Anda hubungkan: alat ini tidak memproses permintaan dengan sendirinya. Ada empat opsi: langganan (ChatGPT Plus, GitHub Copilot, GitLab Duo), kunci API dari penyedia mana pun, OpenCode Zen, agregator dari tim itu sendiri, atau model lokal melalui Ollama. Keempat opsi dibahas di bagian tentang menghubungkan model.

Tanpa deskripsi proyek, agen harus menebak perintah build, struktur file, dan konvensi yang digunakan—itulah sumber “halusinasi”. OpenCode menggunakan file AGENTS.md untuk ini. Pendekatan yang sama berlaku untuk Claude Code dan agen lainnya; hanya nama file instruksinya yang berubah.

Bagaimana cara menginstal OpenCode di macOS dan Linux?#

Cara yang direkomendasikan adalah menggunakan installer resmi:

1. Jalankan installer

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

   Skrip mendeteksi sistem Anda dan mengunduh OpenCode. Jika perintah tidak ditemukan setelah instalasi, tutup lalu buka kembali terminal; jalur akan terdeteksi dalam sesi baru.

2. Periksa apakah instalasi berhasil

   opencode --version
   

   Perintah ini menampilkan nomor versi, yang berarti instalasi berhasil. Respons “command not found” berarti Anda perlu kembali ke langkah pertama: mulai sesi terminal baru atau edit PATH secara manual.

Jika Anda lebih suka mengelola paket sendiri, berikut opsinya:

brew install anomalyco/tap/opencode

npm install -g opencode-ai

Perintah Homebrew sengaja dimulai dengan anomalyco/tap/: dokumentasi merekomendasikan tap mereka sendiri karena tim Homebrew lebih jarang memperbarui formula untuk brew install opencode. Nama paket yang sama, opencode-ai, juga berfungsi dengan bun, pnpm, dan yarn (bun install -g opencode-ai, yarn global add opencode-ai). Di Arch Linux, gunakan sudo pacman -S opencode dari repositori stabil atau paru -S opencode-bin untuk versi terbaru dari AUR.

Perbarui OpenCode dengan opencode upgrade; saat dijalankan, alat ini juga mengunduh pembaruan sendiri jika pembaruan otomatis diaktifkan. Setelah memperbarui, periksa versi dengan opencode --version seperti biasa. Penghapusan instalasi juga sudah tersedia:

opencode uninstall

Perintah ini menunjukkan secara persis apa yang akan dihapus dan meminta konfirmasi. Anda dapat mempertahankan konfigurasi dan data sesi jika mau: gunakan flag --keep-config dan --keep-data.

Bagaimana cara menginstal OpenCode di Windows?#

Opsi pertama yang direkomendasikan langsung oleh para pengembang adalah WSL. Instal dengan satu perintah di PowerShell yang dijalankan sebagai administrator:

wsl --install

Setelah komputer dimulai ulang, buka Ubuntu dari menu Start dan jalankan perintah yang biasa di dalamnya:

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

File di drive Windows tersedia di WSL melalui /mnt/—drive C: berada di /mnt/c/, dan drive D: di /mnt/d/. Jadi, proyek di C:\Users\Name\project dapat dibuka seperti ini:

cd /mnt/c/Users/Name/project
opencode

Opsi kedua adalah melewati WSL dan menggunakan pengelola paket Windows. Di PowerShell:

choco install opencode

scoop install opencode

Opsi ketiga adalah aplikasi desktop dan versi web. Aplikasi dipasang seperti program biasa dan menampilkan antarmuka di jendela, tanpa terminal. Versi web dimulai dengan perintah opencode web: OpenCode terbuka di browser, dan dokumentasi juga merekomendasikan menjalankannya dari WSL untuk menghindari masalah akses file. Dokumentasi juga mencantumkan opsi yang lebih jarang digunakan—mise, Docker, dan biner siap pakai dari halaman rilis GitHub. Instalasi melalui bun di Windows masih dalam pengerjaan; jika bun adalah pengelola paket utama Anda, gunakan opsi npm.

Bagaimana cara menghubungkan model ke OpenCode?#

OpenCode mendukung 75+ penyedia melalui AI SDK dan Models.dev, ditambah model lokal. Sebagian besar dihubungkan dengan perintah /connect di dalam antarmuka; untuk model lokal, Anda juga menentukan alamat server di konfigurasi. Opsi-opsi tersebut berbeda dalam metode pembayaran dan kebutuhan komputer:

Dokumentasi menyarankan pemula untuk memulai dengan OpenCode Zen. Tim memilih model yang bekerja baik khususnya sebagai agen dan menguji kombinasinya dengan penyedia melalui tugas-tugas mereka sendiri.

Cara menghubungkannya: masukkan /connect, pilih OpenCode Zen, masuk dan tambahkan pembayaran di opencode.ai/auth, dapatkan kunci, lalu tempelkan. Setelah itu, /models akan menampilkan daftar model yang direkomendasikan. Per 4 Oktober 2026, daftar tersebut mencakup, misalnya, GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3, dan Kimi K2.5. Dokumentasi secara terbuka mengingatkan bahwa daftar ini tidak lengkap dan cepat menjadi usang karena model baru muncul setiap minggu.

Langganan dihubungkan dengan perintah /connect yang sama: pilih ChatGPT Plus atau GitHub Copilot dari daftar dan masuk ke akun Anda—tidak diperlukan pengaturan tambahan.

Jika Anda memilih Anthropic, /connect menawarkan dua opsi: memasukkan kunci API secara manual, atau memilih Claude Pro/Max lalu melakukan autentikasi melalui browser. Namun, Anthropic melarang plugin pihak ketiga untuk menggunakan langganan Claude Pro/Max, dan plugin bawaan semacam ini dihapus dari OpenCode mulai versi 1.3.0. Jika Anda menemukan artikel lama tentang “OpenCode melalui langganan Claude”, artikel itu merujuk pada plugin yang telah dihapus tersebut, bukan otorisasi resmi. Langganan ChatGPT Plus, GitHub Copilot, GitLab Duo (ditandai eksperimental), dan Atomic Chat dapat digunakan tanpa pengaturan tambahan.

OpenCode menyimpan kunci yang Anda masukkan melalui /connect di file ~/.local/share/opencode/auth.json. Jika Anda tidak ingin memilih model setiap kali, tetapkan model bawaan di file konfigurasi opencode.json pada akar proyek:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5"
}

Formatnya adalah provider/model; kedua pengenal ditampilkan pada keluaran /models.

Bagaimana cara menghubungkan model lokal melalui Ollama?#

Opsi ini berarti tidak ada tagihan API sama sekali: model berjalan di komputer Anda. Jika Anda sedang memilih model gratis secara umum, kami memiliki ulasan terpisah tentang model mana yang cukup baik sebagai agen dan mana yang hanya tampak baik di atas kertas. Untuk OpenCode, instal Ollama dari situs resmi dan unduh model:

ollama pull qwen3-coder

Detail berguna dari dokumentasi: Ollama dapat mengonfigurasi dirinya secara otomatis untuk OpenCode; tersedia panduan integrasi tersendiri. Jika ingin mengatur semuanya secara manual, tambahkan penyedia dengan alamat server Ollama lokal ke opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3-coder": {
          "name": "Qwen3 Coder"
        }
      }
    }
  }
}

Kemudian, /models di antarmuka akan menampilkan model lokal dalam daftar. Pilih model tersebut dan mulai bekerja. Ada satu catatan praktis dari dokumentasi: jika agen berhenti memanggil alat (mengedit file atau menjalankan perintah), tingkatkan num_ctx di pengaturan Ollama—mulailah dengan nilai 16k–32k. Model lokal lebih lemah daripada model cloud khususnya dalam pekerjaan agen, dan konteks kecil memperburuk hal itu. Jika versi lokal tidak memadai, Anda dapat menghubungkan Qwen dari cloud dengan kunci; cara mendapatkannya dibahas dalam panduan cara mendapatkan kunci API untuk Qwen Code.

Berapa biaya OpenCode dan penggunaannya?#

Semua biaya di sini adalah biaya model, dan ada empat skenario. Dengan kunci API atau Zen, Anda membayar berdasarkan penggunaan aktual, dan jumlahnya bergantung pada seberapa banyak agen bekerja. Go adalah paket langganan untuk model terbuka dari tim OpenCode: $10 per bulan untuk Go dan $40 per bulan untuk Go Plus dengan batas lebih tinggi (diverifikasi di halaman opencode.ai/go pada 4 Oktober 2026). Batasnya bergantung pada model: misalnya, Go mengizinkan sekitar 110 permintaan per 5 jam (440 per bulan) untuk Kimi K3 dan sekitar 26.000 permintaan per 5 jam untuk DeepSeek V4.1 Flash yang lebih ringan. Untuk akses ke model tertentu di luar batas, dokumentasi mencantumkan harga terpisah ($15 per bulan untuk Kimi K3, $60 untuk Go Plus). Lihat halaman langganan saat menghubungkan untuk daftar lengkap model dan batasnya. Dengan ChatGPT Plus atau Copilot, permintaan ditanggung oleh langganan yang sudah Anda bayar; ingat bahwa langganan memiliki batas intensitasnya sendiri. Terakhir, permintaan ke model lokal melalui Ollama tidak dikenai biaya—tetapi Anda membutuhkan komputer yang cukup bertenaga agar model berjalan cepat.

Apa yang sebaiknya dilakukan saat pertama kali menjalankannya?#

Pertama kali menjalankannya—di dalam folder proyek Anda:

cd path/to/project
opencode

Antarmuka akan terbuka dengan kolom masukan. Pertama, gunakan perintah /init: agen memindai file penting repositori, mengajukan beberapa pertanyaan jika perlu, dan menulis file AGENTS.md—panduan tentang struktur proyek, perintah yang perlu dijalankan untuk build dan tes, serta konvensi yang digunakan. Dokumentasi menyarankan agar file ini di-commit ke git; OpenCode kemudian menggunakannya sebagai instruksi proyek permanen. Dari segi fungsi, AGENTS.md setara langsung dengan CLAUDE.md dalam ekosistem OpenCode.

Kedua, gunakan mode Plan. Tombol Tab beralih di antara dua agen utama: Build bekerja dengan akses penuh ke file dan perintah, sedangkan Plan digunakan untuk analisis dan perencanaan—pengeditan file dan perintah bash dalam mode Plan secara bawaan memerlukan persetujuan Anda. Untuk tugas baru, dokumentasi menyarankan untuk memulai dengan rencana: baca apa yang hendak dilakukan agen, sesuaikan rumusannya, lalu kembali ke Build dengan Tab.

Dokumentasi memberikan saran berikut:

Semakin spesifik tugas dan semakin banyak konteks yang Anda berikan, semakin sedikit pekerjaan ulang yang diperlukan. Tambahkan file ke permintaan dengan @—mulai ketik namanya dan antarmuka akan menemukannya melalui pencarian fuzzy. Anda dapat menyeret gambar langsung ke terminal, dan pesan yang diawali dengan ! dijalankan sebagai perintah shell; keluarannya ditambahkan ke konteks agen. Jika Anda membuat kesalahan dalam tugas atau agen melakukan hal yang salah, /undo membatalkan perubahan, dan Anda dapat menjalankannya beberapa kali berturut-turut. Berubah pikiran lagi? /redo memulihkan apa yang dibatalkan. Dan /share membuat tautan ke percakapan untuk tim Anda; tanpa perintah ini, percakapan tidak dipublikasikan di mana pun.

Apa lagi yang dapat dilakukan OpenCode?#

Perintah khusus. Permintaan berulang apa pun dapat dijadikan perintah: letakkan file markdown di .opencode/commands/, tetapkan description, agent, dan model di frontmatter-nya, lalu tulis templat prompt di bawahnya. Kemudian panggil perintah dengan /. Pemeriksaan proyek sebelum publikasi, meninjau kesalahan terbaru, membuat migrasi—apa pun yang sering Anda minta.

Subagen. Selain Build dan Plan, ada tiga lagi: General untuk tugas multilangkah (akses ke semua alat kecuali daftar tugas), Explore untuk membaca kode dengan cepat tanpa izin mengedit, dan Scout untuk meneliti pustaka eksternal. Panggil mereka dengan menyebut nama menggunakan @ dalam pesan.

Server MCP. Hubungkan alat eksternal melalui bagian mcp pada konfigurasi opencode.json—server lokal maupun jarak jauh didukung. Setiap server MCP menambahkan alatnya ke konteks, dan server yang rakus seperti GitHub dapat menghabiskan konteks dengan sangat cepat—hubungkan secara selektif, hanya yang Anda perlukan. Kami memiliki panduan dengan konfigurasi siap pakai tentang konsep MCP; panduan itu membahas Claude Code, tetapi protokolnya digunakan bersama.

Versi web dan server. opencode web membuka antarmuka di browser. Untuk akses dari komputer lain, gunakan opencode serve --hostname 0.0.0.0 --port 4096; setiap kali tersedia akses jaringan, pastikan untuk menetapkan kata sandi dengan variabel OPENCODE_SERVER_PASSWORD. Tanpa kata sandi, server tidak terlindungi.

Apa yang harus dilakukan jika instalasi bermasalah?#

“opencode: command not found” setelah instalasi. Terminal belum mengenali jalur yang baru. Pertama, cukup tutup lalu buka kembali terminal. Jika tidak membantu, cari lokasi biner yang dipasang oleh installer dan tambahkan folder tersebut ke PATH terminal Anda.

Model tidak merespons atau melaporkan kesalahan otorisasi. Periksa apakah penyedia sudah terhubung: masukkan /connect dan autentikasi kembali. Kunci disimpan di ~/.local/share/opencode/auth.json—jika Anda memindahkan instalasi dari komputer lain atau menghapus folder, file itu mungkin tidak ada. Dokumentasi membahas kesalahan ProviderInitError dan AI_APICallError secara terpisah: untuk yang pertama, otorisasi ulang penyedia; untuk yang kedua, hapus folder ~/.cache/opencode lalu mulai ulang.

Antarmuka rusak: panel berantakan, atau karakter yang tidak dapat dibaca muncul menggantikan simbol. Mulailah dengan memeriksa terminal. Instal salah satu opsi yang direkomendasikan—WezTerm berfungsi di ketiga sistem—lalu jalankan OpenCode dari sana.

Jika tidak ada yang membantu, periksa log: di macOS dan Linux log ada di ~/.local/share/opencode/log/; di Windows, tekan Win+R dan masukkan %USERPROFILE%\.local\share\opencode\log. Sepuluh file terbaru disimpan; aktifkan pencatatan terperinci dengan flag opencode --log-level DEBUG. Dengan log tersebut, Anda dapat mengirim laporan bug di repositori GitHub proyek.

Apa lagi yang ditanyakan orang tentang OpenCode?#

Kunjungi Ailoot.