Menginstal OpenCode terkadang bisa terasa membingungkan ketika error saat pengaturan mengganggu prosesnya atau alat ini tidak berjalan sesuai harapan. Mulai dari perintah yang hilang hingga masalah kompatibilitas Node.js, pengguna sering mengalami kesulitan saat instalasi awal. Panduan instalasi OpenCode ini memberikan solusi lengkap untuk memperbaiki error umum dan berhasil mengatur OpenCode di Mac dan Windows, baik Anda menggunakan Desktop atau CLI/TUI, sehingga Anda bisa mulai coding tanpa hambatan.
Apa itu OpenCode?
OpenCode adalah agent AI coding open-source yang dirancang untuk membantu developer menulis, mengedit, men-debug, dan mengelola kode langsung dari lingkungan pilihan mereka, baik itu terminal, IDE, atau aplikasi desktop. Berbeda dari asisten AI coding tradisional yang sebagian besar berfokus pada saran kode, OpenCode dapat memahami seluruh codebase, memodifikasi file, menjalankan perintah, dan mengotomatiskan alur kerja pengembangan. OpenCode juga mendukung berbagai model AI dan model lokal, memberikan fleksibilitas dan kontrol yang lebih besar bagi developer dalam membangun software.
Prasyarat untuk menginstal OpenCode
Sebelum menginstal OpenCode, pastikan sistem Anda memenuhi persyaratan dasar. Prasyarat yang tepat bergantung pada apakah Anda berencana menggunakan aplikasi desktop atau antarmuka berbasis terminal, tetapi memiliki pengaturan yang tepat akan membantu memastikan proses instalasi berjalan lancar.
Untuk Desktop
Sistem Operasi: macOS / Windows / Linux
OpenCode menyediakan aplikasi desktop untuk sistem operasi utama, memungkinkan developer menginstal dan menggunakan alat ini di lingkungan pilihan mereka. Pastikan sistem Anda menggunakan sistem operasi yang kompatibel, seperti macOS (Apple Silicon atau Intel), Windows (x64), atau Linux (.deb, .rpm).
Izin untuk menginstal aplikasi: Anda mungkin memerlukan izin administrator atau tingkat sistem untuk mengunduh dan menginstal software di perangkat Anda. Hal ini terutama penting di tempat kerja atau lingkungan IT terkelola di mana hak instalasi mungkin dibatasi.
Koneksi internet yang stabil: Koneksi internet yang lancar diperlukan untuk mengunduh OpenCode, menginstal update, dan terhubung ke model serta layanan AI yang didukung selama pengaturan dan penggunaan.
Untuk Terminal/TUI
Akses terminal: OpenCode dapat diinstal dan digunakan langsung dari command line. Pastikan Anda memiliki akses ke aplikasi terminal, seperti Terminal di macOS, Command Prompt atau PowerShell di Windows, atau shell Linux.
Satu metode instalasi: OpenCode mendukung berbagai metode instalasi untuk mengakomodasi sistem operasi dan preferensi developer yang berbeda. Pilih package manager atau alat instalasi yang paling sesuai dengan lingkungan Anda, seperti npm, curl, brew, Scoop, Chocolatey, atau WSL.
Kemampuan dasar command-line: Keakraban dengan perintah terminal yang umum dapat membuat instalasi dan penggunaan sehari-hari jauh lebih mudah. Meskipun keahlian tingkat lanjut tidak diperlukan, memahami navigasi dasar dan eksekusi perintah tetap disarankan.
Bagaimana cara menginstal OpenCode Desktop?
Menginstal OpenCode Desktop adalah proses yang mudah dan hanya memerlukan beberapa langkah sederhana agar aplikasi bisa berjalan. Berikut langkah-langkah yang perlu diikuti.
Langkah 1: Unduh OpenCode Desktop
Buka halaman unduhan resmi OpenCode dan pilih versi Windows atau macOS dari aplikasi tersebut. File installer akan otomatis terunduh ke sistem Anda. Pastikan Anda mengunduhnya dari sumber resmi demi keamanan dan keasliannya.
Langkah 2: Jalankan installer
Temukan file installer yang sudah diunduh, lalu klik dua kali untuk memulai proses instalasi. Ikuti petunjuk yang muncul di layar untuk menyelesaikan pengaturan.
Langkah 3: Selesaikan instalasi
Lanjutkan mengikuti prompt pengaturan yang muncul, dan pilih direktori instalasi yang Anda inginkan saat diminta. Kemudian biarkan installer menyelesaikan proses pengaturan pada sistem Anda.
Langkah 4: Jalankan OpenCode Desktop
Setelah instalasi selesai, buka OpenCode Desktop dari Start Menu atau shortcut di desktop. Kemudian mulai proyek baru atau buka folder yang sudah ada untuk mulai bekerja. Setelah workspace Anda dimuat, Anda bisa berinteraksi dengan asisten AI untuk membuat kode, men-debug masalah, atau membangun fitur langsung di dalam proyek Anda.
Cara Menginstal OpenCode Terminal/TUI di Mac
OpenCode Terminal (TUI) di Mac dapat diinstal langsung menggunakan package manager resmi atau perintah instalasi satu baris. Ini dirancang untuk developer yang lebih suka bekerja di dalam terminal daripada antarmuka grafis. Ikuti langkah-langkah berikut untuk menginstal OpenCode TUI di Mac.
Langkah 1: Pilih metode instalasi OpenCode Terminal
Kunjungi halaman unduhan resmi OpenCode dan buka bagian OpenCode Terminal. Di sana, Anda akan menemukan beberapa opsi instalasi, termasuk curl, Homebrew, npm, dan bun. Pilih metode yang paling sesuai dengan lingkungan pengembangan Anda, lalu salin perintah instalasi yang sesuai.
Langkah 2: Buka aplikasi Terminal di Mac
Buka aplikasi Terminal di Mac Anda. Anda bisa membukanya melalui Applications > Utilities > Terminal, atau langsung mencarinya menggunakan Spotlight Search. Di sinilah Anda akan menjalankan perintah instalasi OpenCode.
Langkah 3: Instal OpenCode Terminal
Tempelkan perintah instalasi berikut ke Terminal, lalu tekan Enter:
curl -fsSL https://opencode.ai/install | bashTunggu hingga instalasi selesai. OpenCode akan mengunduh file yang diperlukan dan menyiapkan CLI secara otomatis.
Langkah 4: Jalankan Antarmuka Terminal OpenCode
Setelah instalasi selesai, jalankan perintah OpenCode di Terminal untuk memulai Terminal User Interface (TUI). Antarmuka interaktif akan terbuka langsung di jendela terminal Anda, sehingga Anda bisa terhubung ke penyedia AI, mengatur konfigurasi, dan mulai bekerja dengan OpenCode.
Cara Menginstal OpenCode Terminal/TUI di Windows
OpenCode mendukung beberapa metode instalasi di Windows, termasuk WSL, npm, dan bun. Untuk kompatibilitas dan pengalaman terbaik, dokumentasi resmi merekomendasikan penggunaan Windows Subsystem for Linux (WSL). Langkah-langkah di bawah ini menggunakan metode instalasi WSL. Jika Anda sudah menginstal WSL, Anda bisa melewati langkah pertama.
Langkah 1: Instal WSL (Direkomendasikan)
Buka PowerShell sebagai Administrator, lalu jalankan perintah berikut:
wsl --installPerintah ini mengaktifkan Windows Subsystem for Linux (WSL) dan secara default menginstal Ubuntu. Setelah instalasi selesai, restart komputer Anda. Saat pertama kali membuka Ubuntu, Windows akan secara otomatis menyelesaikan pengaturan lingkungan Linux.
Langkah 2: Buka WSL dan instal OpenCode
Jalankan terminal WSL Anda (seperti Ubuntu) dari menu Start Windows. Jika ini pertama kalinya Anda membukanya, selesaikan pengaturan awal. Kemudian jalankan perintah berikut untuk menginstal OpenCode:
curl -fsSL https://opencode.ai/install | bashTunggu hingga instalasi selesai sebelum melanjutkan.
Langkah 3: Verifikasi instalasi
Setelah instalasi selesai, jalankan perintah berikut:
opencodeJika OpenCode Terminal/TUI berhasil dijalankan, artinya instalasi sudah selesai dan Anda bisa mulai menggunakan OpenCode untuk pengkodean berbantuan AI.
Bagaimana cara mengintegrasikan API eksternal ke OpenCode?
Salah satu keunggulan utama OpenCode adalah kemampuannya untuk terhubung dengan penyedia model AI eksternal melalui integrasi API. Dengan menambahkan API key milik Anda sendiri, Anda dapat mengakses berbagai model bahasa dan memilih yang paling sesuai dengan alur kerja coding Anda.
Mengintegrasikan API eksternal ke OpenCode (Langkah umum)
Berikut adalah langkah-langkah untuk mengintegrasikan API eksternal ke OpenCode:imi
Langkah 1: Buat akun dan hasilkan API key
Mulailah dengan membuat akun di penyedia AI pilihan Anda, seperti Kimi atau layanan lain yang didukung. Setelah akun Anda siap, buka halaman pengelolaan API key milik penyedia tersebut dan buat API key baru. Jaga keamanan key ini, karena diperlukan untuk menghubungkan penyedia tersebut ke OpenCode.
Langkah 2: Buka menu koneksi penyedia
Jalankan OpenCode dan buka workspace Anda. Pada command interface, jalankan perintah berikut:
/connectPerintah ini akan membuka menu koneksi penyedia, tempat Anda dapat menambahkan dan mengelola layanan AI eksternal.
Langkah 3: Tambahkan API key Anda
Pilih penyedia yang ingin Anda gunakan dari daftar opsi yang tersedia. Saat diminta, tempelkan API key yang telah Anda buat sebelumnya dan konfirmasikan koneksinya. OpenCode akan menyimpan key tersebut dengan aman dan menggunakannya untuk mengautentikasi permintaan ke penyedia yang dipilih.
┌ API key
│
│ your_api_key_here
│
└ enterLangkah 4: Lihat model yang tersedia
Setelah menghubungkan penyedia Anda, jalankan perintah berikut untuk melihat semua model yang tersedia melalui API tersebut:
/modelsOpenCode akan menampilkan daftar model yang didukung beserta nama dan opsi konfigurasinya.
Langkah 5: Pilih model dan mulai menggunakannya
Pilih model yang ingin Anda gunakan dari daftar yang tersedia. Setelah dipilih, OpenCode akan mengarahkan permintaan Anda melalui model tersebut, sehingga Anda dapat menghasilkan kode, melakukan debug aplikasi, dan menjalankan tugas pengembangan lainnya menggunakan API yang terhubung. Anda dapat beralih model kapan saja jika kebutuhan Anda berubah.
Mengintegrasikan API Kimi ke OpenCode
OpenCode mendukung banyak penyedia AI, memungkinkan developer menghubungkan model eksternal menggunakan API key untuk fleksibilitas yang lebih besar. Salah satu opsi paling andal adalah Kimi API.
Kimi API, yang disediakan oleh Moonshot AI Open Platform, menawarkan akses ke model bahasa Kimi tingkat lanjut melalui antarmuka yang kompatibel dengan OpenAI. API ini dapat dengan mudah diintegrasikan ke dalam berbagai coding tool, aplikasi, dan alur kerja berbasis AI menggunakan API key yang aman. Platform ini menyediakan berbagai model Kimi yang dioptimalkan untuk tugas coding, penalaran, dan pemahaman konteks panjang.
Ikuti langkah-langkah berikut untuk mengintegrasikan API Kimi ke OpenCode.
Langkah 1: Buat akun Moonshot AI dan hasilkan API key
Kunjungi Kimi AI Open Platform dan masuk ke akun Anda.
Dari dashboard, buka API Keys dan klik Create API Key.
Setelah key dibuat (dimulai dengan
sk-), segera salin dan simpan dengan aman. Key ini hanya ditampilkan satu kali dan digunakan untuk mengautentikasi permintaan antara OpenCode dan Moonshot AI.
Langkah 2: Hubungkan Moonshot AI ke OpenCode
Buka workspace OpenCode Anda dan jalankan:
/connectMenu koneksi penyedia akan muncul. Cari Moonshot AI (atau Kimi) dari daftar penyedia bawaan dan pilih. OpenCode akan meminta Anda untuk memasukkan API key.
Saat diminta, tempelkan API key yang Anda buat dari konsol Moonshot AI dan tekan Enter:
┌ API key
│ sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
│
└ enterSetelah terverifikasi, OpenCode akan menyimpan kredensial tersebut secara aman ke ~/.local/share/opencode/auth.json dan mengaitkannya dengan konfigurasi penyedia Moonshot AI Anda.
Catatan: OpenCode menyimpan API key secara terpisah dari file konfigurasi utama untuk alasan keamanan. Perintah
/connectmenangani penyimpanan kredensial, sedangkan perilaku penyedia dikonfigurasi diopencode.json.
Langkah 3: Konfigurasikan penyedia di opencode.json (jika diperlukan)
Jika Anda mengalami error No endpoints found setelah menghubungkan, atau jika Anda perlu menyesuaikan pengaturan penyedia, tambahkan konfigurasi Moonshot AI ke file opencode.json Anda:
{"$schema": "https://opencode.ai/config.json","provider": {"moonshotai": {"name": "Moonshot AI","options": {"baseURL": "https://api.moonshot.ai/v1"},"models": {"kimi-k2.6": {"name": "Kimi K2.6"},"kimi-k2.5": {"name": "Kimi K2.5"}}}}}Simpan file tersebut dan mulai ulang OpenCode untuk menerapkan perubahan.
Langkah 4: Lihat model Kimi yang tersedia
Setelah menghubungkan penyedia, jalankan:
/modelsOpenCode akan menampilkan semua model yang tersedia melalui akun Moonshot AI Anda, termasuk:
| Model | Deskripsi |
|---|---|
| kimi-k2.6 | Model unggulan terbaru dengan arsitektur MoE 1T, kemampuan coding dan reasoning yang canggih |
| kimi-k2.5 | Model berperforma tinggi yang dioptimalkan untuk tugas coding dan konteks panjang |
| moonshot-v1-128k | Model konteks panjang untuk analisis dokumen |
| moonshot-v1-32k | Model seimbang untuk tugas umum |
| moonshot-v1-8k | Model konteks pendek untuk respons yang cepat |
Langkah 5: Pilih model Kimi dan mulai coding
Pilih moonshotai/kimi-k2.6 dan jadikan sebagai model aktif. Setelah dipilih, OpenCode akan menggunakan model Kimi yang dipilih untuk pembuatan kode, debugging, refactoring, dan tugas pengembangan berbantuan AI lainnya.
Anda dapat beralih ke model lain kapan saja melalui menu pemilihan model yang sama.
Tips: Jika Anda mengalami masalah dengan mode Agent/Tool (seperti error validasi JSON Schema), ini adalah masalah kompatibilitas yang sudah dikenal antara persyaratan schema yang ketat dari Moonshot AI dan format parameter tool OpenCode. Pertimbangkan untuk menggunakan mode Chat demi stabilitas terbaik, atau instal plugin
opencode-moonshot-compatibilityuntuk menangani kompatibilitas temperature secara otomatis.
Manfaat menggunakan Kimi API
Kimi API dirancang untuk mendukung alur kerja pengembangan modern dengan membantu tim beralih dari ide ke implementasi secara lebih efisien. Selain menghasilkan kode, Kimi API dapat memahami berbagai jenis input, menyesuaikan diri dengan kebutuhan proyek, dan mengotomatiskan tugas-tugas rekayasa yang rutin. Berikut beberapa manfaat utamanya:
Mengubah input multimodal menjadi implementasi yang berjalan
Kimi API dapat menafsirkan informasi dari berbagai format, termasuk mockup desain, diagram arsitektur, flowchart, dan video. Konteks ini digunakan untuk memahami kebutuhan proyek dan mengubahnya menjadi spesifikasi teknis atau kode fungsional. Alhasil, tim dapat berpindah dari konsep ke implementasi dengan lebih sedikit langkah penerjemahan manual.
Menangani tugas coding jangka panjang dan pekerjaan rekayasa yang kompleks
Kimi API membantu OpenCode menangani tugas coding yang lebih besar yang memerlukan perencanaan, konsistensi, dan penyempurnaan. Hal ini berguna untuk membangun fitur, melakukan refactoring kode, dan menyelesaikan masalah rekayasa yang kompleks.
Bernalar melalui masalah dengan pemanggilan tool bertahap
Kimi API dapat bernalar melalui tugas-tugas bertahap dan memanggil tool saat diperlukan. Ini membantu proses debugging, analisis kode, serta alur kerja yang tidak bisa diselesaikan dalam satu respons saja.
Bagaimana cara mengatasi masalah saat menginstal OpenCode?
Menginstal OpenCode biasanya mudah, tetapi pengguna mungkin menemui error umum akibat ketidaksesuaian lingkungan, dependensi, atau masalah konfigurasi. Berikut panduan yang jelas dan praktis untuk membantu Anda mengatasi masalah instalasi yang paling sering terjadi dengan cepat dan efisien.
Command not found: opencode
Jika Anda melihat error ini, artinya sistem tidak dapat menemukan file eksekusi OpenCode di PATH Anda. Ini biasanya terjadi ketika instalasi belum selesai atau variabel lingkungan tidak diatur dengan benar.
Untuk memperbaikinya, periksa dulu instalasinya dan pastikan direktori biner sudah ditambahkan ke PATH sistem Anda. Jika diinstal melalui npm, periksa jalur bin global npm Anda dan perbarui konfigurasi shell Anda sesuai kebutuhan. Memulai ulang terminal biasanya menyelesaikan masalah setelah perbaikan dilakukan.
Versi Node.js terlalu lama
OpenCode memerlukan Node.js 18 atau lebih baru, dan versi yang lebih lama akan menyebabkan kegagalan instalasi atau runtime.
Untuk mengatasinya, periksa versi yang sedang digunakan dengan node --version. Jika sudah usang, tingkatkan Node.js menggunakan version manager seperti nvm. Setelah upgrade, instal ulang OpenCode untuk memastikan kompatibilitas dengan lingkungan runtime yang telah diperbarui.
Error izin npm
Error izin biasanya terjadi ketika npm mencoba menginstal paket global tanpa akses tulis yang memadai.
Daripada menggunakan sudo, atur direktori global npm khusus di folder home Anda dan perbarui pengaturan PATH. Ini memastikan instalasi yang lebih aman dan stabil. Setelah memperbaiki izin, jalankan ulang perintah instalasi untuk menyelesaikan pengaturan dengan sukses.
Masalah jaringan/firewall
Di jaringan yang dibatasi atau lingkungan perusahaan, instalasi OpenCode dapat gagal karena akses registry npm terblokir atau unduhan yang lambat.
Untuk mengatasinya, beralihlah ke registry npm alternatif atau gunakan metode instalasi langsung seperti curl atau unduhan biner. Selain itu, pastikan firewall Anda mengizinkan lalu lintas Node.js dan npm, karena koneksi yang terblokir sering mengganggu instalasi paket.
Masalah rendering TUI
Jika OpenCode terbuka tetapi tampilannya rusak, tidak sejajar, atau menampilkan teks yang berantakan, masalahnya biasanya terkait kompatibilitas terminal.
Gunakan emulator terminal modern yang mendukung true color dan rendering Unicode, seperti Windows Terminal, WezTerm, atau iTerm2. Memperbarui pengaturan terminal atau beralih ke lingkungan lain biasanya langsung menyelesaikan masalah tampilan.
Kesimpulan
Instalasi OpenCode yang tepat dan konfigurasi yang benar memastikan performa yang lancar di berbagai sistem sekaligus mengurangi risiko error instalasi yang umum terjadi. Ketika dependensi, pengaturan terminal, dan koneksi API dikelola dengan baik, pengguna dapat dengan cepat mengatasi masalah dan menjaga lingkungan pengembangan yang stabil. Mengintegrasikan layanan eksternal seperti Kimi API semakin meningkatkan fleksibilitas dengan memungkinkan akses model tingkat lanjut dalam alur kerja.