Apa itu OpenCode? Penjelasan Agen Kode AI Sumber Terbuka

Panduan tentang alur kerja OpenCode, opsi model, arsitektur, serta perbedaannya dengan Claude Code, Cursor, dan Cline.

Diperbarui 28 Jul 2026 · 14 mnt baca

Jelajahi dengan AI

Buka di ChatGPT Buka di Claude Buka di Perplexity

OpenCode dibangun untuk menyelesaikan sebuah tugas. Ini adalah agen sumber terbuka yang menghubungkan model AI ke repositori, terminal, dan alat pengembangan Anda. Minta ia memperbaiki bug, dan ia dapat menemukan berkas yang relevan, menyusun rencana, mengedit kode, menjalankan tes, serta menanggapi error. Fitur pelengkapan otomatis tidak bisa melakukan itu sendirian.

Peran yang lebih luas itu menarik perhatian. Saat tulisan ini dibuat, repositori OpenCode yang aktif memiliki sekitar 189.000 bintang GitHub. Saya tidak akan menganggap bintang sebagai bukti kualitas kode, tetapi itu menunjukkan besarnya minat terhadap proyek ini.

Kenyataannya tidak sesederhana itu. OpenCode memberi Anda pilihan model, lalu meminta Anda mengelola pilihan tersebut. Perubahan kebijakan penyedia pada Januari 2026 menunjukkan betapa cepatnya opsi itu bisa bergeser. Saya akan membahasnya bersama cara kerja OpenCode dan posisinya.

Catatan penamaan singkat sebelum lanjut: jika Anda mencari OpenCode, Anda mungkin menemukan repositori opencode-ai/opencode berbasis Go yang sudah diarsipkan. Proyek tersebut berhenti dipelihara pada September 2025. Kita akan fokus pada proyek aktif di github.com/anomalyco/opencode, yang dibuat oleh tim di balik kerangka kerja Serverless Stack (SST).

Apa itu OpenCode?

OpenCode adalah agen pengodean AI sumber terbuka yang dirilis di bawah lisensi MIT. Ini bersifat agnostik model, artinya tidak terbatas pada satu penyedia model. Pengguna dapat membaca sumbernya dan memodifikasinya. Mereka juga dapat meng-host alat ini sendiri. Perangkat lunaknya gratis. Penagihan model terpisah, sebagaimana akan saya jelaskan di bagian fitur.

OpenCode bukan model bahasa besar (LLM). Model yang dipilih membaca prompt dan menghasilkan respons. OpenCode menyediakan alat berkas, akses shell, riwayat sesi, aturan izin, dan antarmuka di sekitar model tersebut. Menurut saya pembedaan ini berguna karena mengganti model tidak mengharuskan mengubah bagian alat lainnya.

Ini dibuat oleh Anomaly, sebelumnya SST, dan terutama berjalan di TypeScript dan Bun.

Perbandingan repositori OpenCode yang diarsipkan dan yang saat ini. Gambar oleh Penulis.

OpenCode tidak terikat pada satu keluarga model. Melalui registri Models.dev, ia terhubung ke lebih dari 75 penyedia, termasuk Anthropic, OpenAI, Google, DeepSeek, Groq, dan model lokal melalui Ollama. Beberapa akun langganan yang sudah ada juga dapat dihubungkan, seperti yang akan saya bahas di bagian fitur.

Sesi terminal OpenCode yang menampilkan perubahan berkas. Gambar oleh Penulis.

Meskipun OpenCode dimulai di terminal, kini ia hadir sebagai antarmuka terminal (TUI), aplikasi desktop beta untuk macOS, Windows, dan Linux, serta ekstensi untuk editor seperti VS Code. Rilis stabil terbaru saat tulisan ini dibuat adalah v1.18.8.

Mengapa OpenCode Dibuat

Seperti yang saya sebutkan sebelumnya, OpenCode mendukung model dari banyak penyedia. Ini dibangun demikian karena kualitas dan harga model berubah, dan alat yang terikat pada satu penyedia memberi pengguna lebih sedikit opsi.

Dokumentasinya menyatakan bahwa OpenCode tidak terikat pada penyedia mana pun. Registri Models.dev yang disebutkan di atas menyediakan detail model dan harga yang digunakan OpenCode.

Pilihan ini tidak hanya berdampak pada penagihan. Model berbeda memiliki batas konteks, format pemanggilan alat, dan jenis input yang berbeda. OpenCode menggunakan satu antarmuka untuk perbedaan tersebut. Seorang pengembang dapat mengganti model yang dipilih dalam proyek yang sama tanpa memindahkan sesi ke alat pengodean lain.

Tim juga menyukai alat yang mengutamakan terminal dan dapat diperiksa oleh pengguna. Instruksi proyek disimpan dalam berkas biasa bernama AGENTS.md. Saya akan menjelaskan bagaimana OpenCode membuat dan menggunakan berkas ini nanti.

Proyek resmi mencatat tiga pilihan desain. Pertama adalah dukungan penyedia yang sudah dibahas. Kedua, menjaga kontrol utama di terminal. Ketiga, memisahkan klien dan server. Pemisahan itu dibahas berikutnya.

Pada Januari 2026, Anthropic memblokir alat pihak ketiga menggunakan langganan konsumen Claude melalui saluran tidak resmi. OpenCode kemudian menambahkan opsi langganan lain dan menggunakan gateway miliknya. Pengguna tetap bisa terhubung melalui penyedia lain.

Kejadian itu menjelaskan mengapa pilihan penyedia mendapat begitu banyak perhatian di OpenCode. Untuk melihat apa yang dilakukan pengguna dengan pilihan tersebut, langkah berikutnya adalah melihat sebuah sesi.

Cara Kerja OpenCode

OpenCode berjalan sebagai klien dan server lokal. TUI, aplikasi desktop, ekstensi IDE, dan SDK semuanya berkomunikasi dengan server itu melalui HTTP. Server yang sama mendukung penyambungan jarak jauh dengan opencode attach <url> dan penggunaan tanpa antarmuka dengan opencode serve.

Di dalam sebuah sesi, agen membaca berkas yang relevan, mungkin menyusun rencana, mengedit kode, dan menjalankan perintah bila diperlukan. Integrasi Language Server Protocol (LSP) kemudian memasok kembali diagnostik compiler dan linter ke model agar dapat menanggapi error tipe dan sintaksis.

Sebagai contoh, sebuah tugas dapat dimulai dengan glob atau grep untuk menemukan berkas. Agen dapat menggunakan read untuk memeriksanya dan edit untuk mengubah baris tertentu. Lalu ia dapat menggunakan bash untuk menjalankan perintah uji atau build. Output menjadi bagian dari permintaan model berikutnya.

Saya menganggap pemisahan Build dan Plan paling mudah dipahami sebagai sakelar izin. Build adalah bawaan dan dapat membaca, menulis, serta menjalankan perintah. Plan meminta persetujuan sebelum mengedit berkas atau menjalankan perintah bash. Menekan Tab beralih di antara keduanya.

Pemeriksaan izin berlaku saat sebuah alat dipanggil. Sebuah proyek dapat mengizinkan alat, memblokirnya, atau menanyakan pengguna setiap kali. Aturan juga dapat bervariasi menurut pola perintah. Sebuah tim mungkin mengizinkan pengujian rutin tetapi meminta persetujuan sebelum perintah shell lainnya.

Sesi disimpan secara lokal di disk pada direktori data OpenCode. OpenCode secara otomatis meringkas percakapan panjang. Perintah /undo dan /redo berpindah melalui snapshot berkas berbasis Git.

Fitur Utama OpenCode

OpenCode mengelompokkan fungsi utamanya ke dalam akses model, konteks proyek, eksekusi tugas, dan penggunaan lokal. Bagian-bagian di bawah ini menjelaskan apa yang diubah masing-masing kelompok selama sesi pengodean.

Dukungan multi-model

Seperti disebutkan sebelumnya, OpenCode mendapatkan daftar penyedianya melalui Models.dev. Dalam praktiknya, pengguna dapat menghubungkan layanan yang di-host, platform cloud, atau endpoint yang kompatibel dengan OpenAI. GitHub Copilot dan login ChatGPT Plus/Pro menyediakan alternatif untuk mengelola kunci API terpisah.

Pilihan penyedia tidak berarti setiap model berperilaku sama. Penggunaan alat, batas konteks, waktu respons, dan harga tetap bergantung pada model dan penyedia yang dipilih. Panggilan ke model yang di-host juga mengirim konteks kode yang diperlukan ke penyedia tersebut di bawah aturan data miliknya.

OpenCode juga menawarkan dua cara opsional untuk mengakses model. OpenCode Zen adalah gateway bayar-sesuai-pemakaian dengan daftar model terpilih. OpenCode Go adalah langganan seharga $5 untuk bulan pertama, lalu $10 per bulan, untuk model open-weight terpilih. Pengguna tetap bisa memasok kunci API mereka sendiri. Harga dapat berubah.

Inilah bagian yang membuat jengkel: alat gratis tetap dapat menimbulkan tagihan dari penyedia.

Bekerja dengan konteks repositori

Jalankan /init dan OpenCode menghasilkan ringkasan AGENTS.md tentang struktur dan konvensi proyek. Tim dapat me-commit berkas itu agar sesi dimulai dengan instruksi bersama.

Berkas tersebut dapat memuat perintah pengujian, nama folder, aturan penamaan, dan catatan tentang proyek. AGENTS.md global dapat berisi instruksi yang digunakan lintas proyek. Berkas proyek menyimpan aturan untuk satu repositori.

Pemeriksaan LSP yang dijelaskan sebelumnya berjalan setelah pengeditan. Konteks repositori juga mencakup referensi berkas: simbol @ menarik berkas yang dipilih ke dalam prompt.

Menjalankan tugas pengodean

Di luar agen Build dan Plan yang dijelaskan sebelumnya, OpenCode menyertakan subagen untuk pencarian multilangkah, pemindaian basis kode, dan dokumentasi luar. Agen khusus dapat memiliki model, prompt, dan izin alatnya sendiri.

Setiap subagen bekerja dalam sesi turunan, sehingga pesannya tidak memenuhi sesi utama dengan cara yang sama. Agen khusus dapat dibatasi hanya untuk membaca berkas, diberi model berbiaya lebih rendah, atau diberi instruksi untuk satu jenis tugas.

Model Context Protocol (MCP) menambahkan layanan eksternal. Layanan tersebut didefinisikan dalam opencode.json, dan pemeriksaan izin yang dibahas sebelumnya juga berlaku untuk alat yang mereka tambahkan.

Berpindah dari perencanaan ke perubahan kode. Video oleh Penulis.

Pengembangan yang mengutamakan lokal (beserta batasannya)

Istilah "local-first" butuh kualifikasi. Saya tidak akan membacanya sebagai janji bahwa tidak ada apa pun yang pernah keluar dari mesin. Seperti disebutkan di bagian penyedia, OpenCode dapat terhubung ke Ollama. Pengaturan tersebut menjaga kode dan prompt tetap pada infrastruktur lokal. Model yang di-host, /share, dan OpenCode Zen mengirim data ke luar mesin lokal.

Penggunaan lokal tetap bergantung pada model. Model kecil mungkin mengembalikan panggilan alat yang tidak valid atau melewatkan keterkaitan antar berkas. Server lokal juga membutuhkan memori yang cukup untuk model yang dipilih dan ruang konteks yang cukup untuk berkas yang dikirim dengan setiap permintaan.

Sistem perizinannya adalah pengaman alur kerja, bukan sandbox keamanan. Mode server berjejaring harus menggunakan OPENCODE_SERVER_PASSWORD dan diikat ke localhost. Masalah paparan tanpa autentikasi sebelumnya telah ditambal, tetapi mode server tetap tidak boleh diekspos secara publik tanpa autentikasi.

Arsitektur OpenCode

Seperti disebutkan sebelumnya, OpenCode memisahkan kliennya dari server lokalnya. Pemisahan itu memengaruhi konfigurasi dan status tersimpan. API menambahkan cara lain untuk menggunakan server.

Jika Anda hanya berencana menggunakan TUI, Anda dapat melewatkan detail API. Paragraf konfigurasi di akhir adalah bagian yang akan Anda gunakan.

Server TypeScript dan Bun berbicara dengan penyedia model dan menjalankan alat. Ia juga mengelola status. Spesifikasi OpenAPI 3.1 menghasilkan @opencode-ai/sdk resmi. Skrip dan klien khusus dapat menggunakan API terdokumentasi ini.

API mencakup sesi, pesan, berkas, penyedia, alat, agen, dan konfigurasi. Ini adalah server yang sama yang digunakan oleh klien OpenCode sendiri. Sebuah skrip dapat membuat sesi atau mengirim pesan tanpa mencoba mengontrol TUI.

Klien OpenCode terhubung ke satu server. Gambar oleh Penulis.

Antarmuka yang disebutkan sebelumnya bertindak sebagai klien: TUI, aplikasi desktop, ekstensi IDE, dan opencode web. Masing-masing berbicara ke proses server yang sama. Perangkat terpisah dapat menempel ke sesi yang ada melalui proses itu.

Menjalankan opencode serve memulai server tanpa TUI normal. Menjalankan opencode web menambahkan klien peramban. Keduanya memerlukan autentikasi jika server dapat diakses dari perangkat lain.

Konfigurasi berada di tingkat proyek opencode.json atau opencode.jsonc, dengan fallback global di ~/.config/opencode/opencode.json. Ini mengontrol model, izin, server MCP, dan agen khusus. Seperti dibahas di bagian alur kerja, riwayat sesi dan log alat tetap berada di berkas lokal kecuali pengguna membagikannya.

Alur Kerja Umum OpenCode

Bagian yang sama dari OpenCode dapat digunakan untuk beberapa tugas perangkat lunak umum. Contoh di bawah menunjukkan di mana tinjauan manusia tetap penting pada masing-masingnya.

Membangun fitur baru

Menggunakan proses Plan-to-Build yang dijelaskan sebelumnya, pengembang dapat meminta fitur dan meninjau langkah yang diusulkan sebelum ada pengeditan. Menekan Tab kemudian memindahkan tugas ke mode Build untuk perubahan kode dan pengujian.

Rencana dapat direvisi sebelum ada perubahan berkas. Saya akan menggunakan tinjauan itu untuk memperbaiki cakupan, menyebutkan berkas yang tidak boleh diubah, atau menambahkan persyaratan pengujian.

Merombak (refactor) kode yang ada

Proses Plan-to-Build yang sama berfungsi untuk refactoring. Mode Plan dapat mengidentifikasi dependensi dan lokasi pemanggilan sebelum mode Build menerapkan pengeditan. Jika hasilnya salah, /undo memulihkan snapshot sebelumnya. Pengguna tetap perlu meninjau diff karena tes yang lolos tidak mengonfirmasi bahwa setiap antarmuka publik tetap sama.

Debug aplikasi

Untuk debug, OpenCode dapat menggabungkan stack trace dengan informasi tipe dari language server. Ia dapat mengusulkan perubahan, mengulangi langkah yang menyebabkan error, dan memeriksa hasilnya. Tanpa langkah reproduksi yang jelas, ia mungkin hanya mengonfirmasi bahwa kode dapat dibangun atau bahwa tes yang ada lolos.

Menulis tes

Seperti dibahas sebelumnya, mode Build dapat mengedit berkas dan menjalankan perintah. Untuk penulisan tes, artinya ia dapat membuat tes, membaca hasilnya, dan melakukan perubahan lain. Satu set tes lengkap memberi lebih banyak umpan balik namun memakan waktu lebih lama.

Kualitas tes tetap butuh tinjauan manusia. Tes yang dihasilkan mungkin mengulang implementasi alih-alih memeriksa perilaku yang diandalkan pengguna.

Memahami basis kode besar

Bagian repositori menjelaskan bagaimana /init membuat catatan proyek. Setelah langkah itu, pertanyaan seperti "Bagaimana autentikasi bekerja di sini?" dapat memandu pencarian. Subagen @general dapat mencari beberapa bagian repositori.

Pertanyaan spesifik biasanya menghasilkan hasil yang lebih jelas daripada permintaan untuk menjelaskan seluruh repositori. Referensi berkas dengan @ dapat mempersempit pencarian lebih jauh.

OpenCode vs. Agen Kode AI Lainnya

Alat-alat ini berbeda dalam lisensi, dukungan model, antarmuka, dan penagihan. Saya membandingkannya pada poin-poin tersebut alih-alih menganggap satu alat sebagai pilihan baku.

OpenCode vs. Claude Code

Kami memiliki artikel OpenCode versus Claude Code terpisah dengan detail lebih lanjut. Claude Code bersifat proprietari dan menggunakan model serta sistem akun Anthropic. OpenCode menggunakan lisensi MIT dan meminta pengguna memilih penyedia. Ia juga memberi akses ke kode sumber dan konfigurasinya. Seperti disebutkan di bagian sejarah, langganan konsumen Claude tidak lagi berfungsi melalui OpenCode, sehingga penggunaan Claude memerlukan kunci API Anthropic berbasis meteran.

Kedua alat dapat membaca berkas, melakukan perubahan, menjalankan perintah, dan menggunakan server MCP. Akses model adalah perbedaan utama: Claude Code tetap pada pengaturan Anthropic seperti di atas, sementara OpenCode dapat menghubungkan penyedia lain atau endpoint lokal.

OpenCode vs. Cursor

Cursor adalah IDE berbasis VS Code yang juga menawarkan agen CLI dan cloud. Alur kerjanya yang utama menjaga saran, perubahan berkas, dan tindakan agen di dalam editor. OpenCode menggunakan antarmuka terminal, desktop, dan editor seperti yang disebutkan sebelumnya. Cursor menggunakan paket langganan berbayar. Perangkat lunak OpenCode gratis, tetapi pengguna mungkin membayar penyedia model untuk token. Perbedaan utama adalah antarmuka kerja, pilihan model, dan metode penagihan.

Cursor juga menyertakan pelengkapan inline saat pengembang mengetik. OpenCode berfokus pada tugas yang diberikan kepada agen dan tidak menggantikan bentuk pelengkapan tersebut. Beberapa pengembang mungkin menggunakan kedua jenis alat untuk pekerjaan yang berbeda.

OpenCode vs. Cline

Cline adalah proyek inti open-source, BYOK, dengan antarmuka VS Code dan CLI. Ia juga memiliki klien JetBrains, meskipun klien itu bukan open source saat tulisan ini dibuat. Baik Cline maupun OpenCode mendukung MCP dan memungkinkan pengguna menetapkan aturan persetujuan. Cline menempatkan kontrol editornya di sidebar. OpenCode menggunakan sesi terminal yang dapat berjalan terpisah dari editor. Pilihannya terutama bergantung pada tempat pengembang ingin meninjau dan menyetujui perubahan.

Cline menggunakan lisensi Apache 2.0. OpenCode menggunakan lisensi MIT yang disebutkan sebelumnya. Keduanya memungkinkan peninjauan sumber dan perubahan, tetapi antarmuka dan berkas proyeknya berbeda.

Aider dan Codex CLI juga merupakan agen pengodean berbasis terminal. OpenCode mencakup penggunaan terminal, desktop, dan IDE dalam proyek yang sama serta mendukung model dari beberapa penyedia.

Memasang dan Memulai OpenCode

Skrip pemasangan resmi berfungsi pada sebagian besar sistem mirip Unix. Ini menyediakan satu cara untuk memasang alat baris perintah:

Perintah tersebut mengunduh biner OpenCode dan menambahkannya ke lingkungan pengguna. Pengelola paket mungkin lebih cocok ketika pembaruan dikelola bersama sistem lainnya.

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

Opsi pengelola paket mencakup npm i -g opencode-ai@latest, brew install anomalyco/tap/opencode di macOS dan Linux, serta scoop install opencode atau choco install opencode di Windows. Aplikasi desktop tersedia untuk macOS, Windows, dan Linux. Di Windows, dokumentasi OpenCode merekomendasikan WSL karena beberapa fungsi sistem berkas dan shell bekerja lebih baik di sana.

Pemasangan tidak termasuk akses model. Sesi pertama tetap membutuhkan salah satu metode akses yang dibahas di bagian multi-model.

Memasang OpenCode sebelum membuat instruksi proyek. Video oleh Penulis.

Setelah terpasang, alur pertama kali berjalan singkat. Ini mencakup koneksi penyedia dan penyiapan awal proyek:

Jalankan opencode di dalam direktori proyek Anda untuk meluncurkan TUI.
Jalankan /connect untuk menambahkan penyedia model, apakah itu kunci API langsung, login Copilot atau ChatGPT, atau koneksi OpenCode Zen atau Go.
Jalankan /init untuk membuat berkas AGENTS.md seperti yang dijelaskan sebelumnya, lalu commit jika tim harus berbagi instruksi tersebut.
Gunakan Tab untuk beralih antara mode Plan dan Build seperti yang dibahas di atas.

Langkah-langkah ini mencakup penyiapan awal. Dokumentasi OpenCode memuat opsi penyedia dan konfigurasi lengkap.

Siapa yang Sebaiknya Menggunakan OpenCode?

Kecocokan OpenCode bergantung pada antarmuka yang disukai, pengaturan model, dan tingkat kontrol. Berdasarkan fitur yang dibahas di atas, ini mungkin cocok untuk pengguna dan tim berikut:

Mungkin cocok:

Pengembang yang tidak ingin terkunci pada satu penyedia model dan ingin beralih berdasarkan biaya atau kapabilitas
Tim di lingkungan teregulasi atau sensitif privasi yang perlu menjaga kode tetap di infrastruktur lokal
Pengembang yang mengutamakan terminal dan nyaman dengan alur kerja CLI serta berkas konfigurasi
Kontributor open-source yang ingin memeriksa, meng-fork, atau memperluas alat itu sendiri
Pengembang yang lebih suka penagihan token daripada langganan perangkat lunak tetap

Mungkin tidak cocok:

Orang yang menginginkan produk terkelola dengan sedikit atau tanpa penyiapan
Pengembang yang terutama menginginkan pelengkapan otomatis inline alih-alih agen otonom
Orang yang berencana hanya menggunakan Claude dan lebih menyukai penagihan langganan daripada penagihan API berbasis meteran
Orang yang sama sekali tidak ingin menyentuh terminal, meskipun aplikasi desktop agak memperkecil kesenjangan ini

Ini adalah perbedaan alur kerja, bukan ukuran kualitas kode. Lebih banyak kontrol atas model dan izin juga berarti lebih banyak penyiapan.

Masa Depan OpenCode

Saya hampir memotong bagian ini karena peta jalan cepat usang. Perubahan yang sudah dirilis masih menunjukkan ke mana arah kerja tim.

OpenCode merilis lebih dari 800 versi selama tahun pertamanya. Rilis terbaru menambahkan tab desktop dan agen latar belakang eksperimental. Jumlah rilis itu menunjukkan aktivitas, tetapi saya tidak akan menganggapnya sebagai janji stabilitas atau fitur apa pun di masa depan.

Opsi Zen dan Go yang dibahas sebelumnya menambahkan metode pembayaran berdampingan dengan BYOK. Dukungan MCP dan subagen juga tetap menjadi bagian aktif dari proyek. Area yang sama juga berubah di alat pengodean lainnya.

Tidak ada peta jalan publik yang mengonfirmasi fitur berikutnya atau tanggal rilisnya. Klaim tentang rilis mendatang tetap tidak pasti.

Kesimpulan

Pemisahan agen-model dari bagian pembuka adalah poin yang akan saya pegang. Daftar penyedia berubah, harga bergerak, aturan akses bergeser, dan langganan menghilang; OpenCode dapat tetap di tempatnya sementara model yang dipilih berubah. Pemisahan itu datang dengan pekerjaan karena seseorang tetap harus mengelola penyiapan, izin, dan penagihan.

Pandangan saya sederhana: pilih berdasarkan seberapa banyak kontrol yang ingin Anda kelola. Tidak ada satu opsi pun yang cocok untuk setiap pengembang atau tim.

Sumber terkait kami mencakup tutorial Claude Code dan kursus AI-Assisted Coding for Developers.