Menginstal OpenCode terkadang terasa membingungkan ketika kesalahan penyiapan mengganggu proses atau alat ini tidak berjalan seperti yang diharapkan. Mulai dari perintah yang tidak ditemukan hingga masalah kompatibilitas Node.js, pengguna sering mengalami kendala saat instalasi awal. Panduan instalasi OpenCode ini menyediakan solusi lengkap untuk memperbaiki kesalahan umum dan menyiapkan OpenCode dengan sukses di Mac dan Windows, baik menggunakan Desktop maupun CLI/TUI, agar Anda dapat mulai coding tanpa penundaan.
Apa itu OpenCode?
OpenCode adalah agen coding AI sumber terbuka yang dirancang untuk membantu developer menulis, mengedit, men-debug, dan mengelola kode langsung dari lingkungan pilihan mereka, baik terminal, IDE, maupun aplikasi desktop. Berbeda dengan asisten coding AI tradisional yang terutama 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, sehingga developer memiliki fleksibilitas dan kontrol lebih besar dalam membangun perangkat lunak.
Prasyarat untuk menginstal OpenCode
Sebelum menginstal OpenCode, pastikan sistem Anda memenuhi persyaratan dasar. Prasyarat yang diperlukan bergantung pada apakah Anda akan menggunakan aplikasi desktop atau antarmuka berbasis terminal, tetapi penyiapan yang tepat akan membantu memastikan proses instalasi berjalan lancar.
Untuk Desktop
Sistem Operasi: macOS / Windows / Linux
OpenCode menyediakan aplikasi desktop untuk sistem operasi utama, sehingga developer dapat 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 perangkat lunak di perangkat Anda. Hal ini terutama penting di lingkungan kerja atau lingkungan IT terkelola yang mungkin membatasi hak instalasi.
Koneksi internet stabil: Koneksi internet yang lancar diperlukan untuk mengunduh OpenCode, menginstal pembaruan, serta terhubung ke model dan layanan AI yang didukung selama penyiapan dan penggunaan.
Untuk Terminal/TUI
Akses terminal: OpenCode dapat diinstal dan digunakan langsung dari baris perintah. 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 beberapa metode instalasi untuk mengakomodasi berbagai sistem operasi dan preferensi developer. Pilih package manager atau alat instalasi yang paling sesuai dengan lingkungan Anda, seperti npm, curl, brew, Scoop, Chocolatey, atau WSL.
Kemampuan dasar baris perintah: Pemahaman terhadap perintah terminal umum dapat memudahkan instalasi dan penggunaan sehari-hari. Keahlian tingkat lanjut tidak diperlukan, tetapi pemahaman tentang navigasi dasar dan eksekusi perintah disarankan.
Bagaimana cara menginstal OpenCode Desktop?
Menginstal OpenCode Desktop merupakan proses sederhana yang hanya memerlukan beberapa langkah untuk menjalankan aplikasi. Berikut langkah-langkahnya.
Langkah 1: Unduh OpenCode Desktop
Buka halaman unduhan resmi OpenCode dan pilih versi aplikasi untuk Windows atau macOS. Penginstal akan otomatis diunduh ke sistem Anda. Pastikan Anda mengunduhnya dari sumber resmi demi keamanan dan keaslian.
Langkah 2: Jalankan penginstal
Temukan file penginstal yang telah diunduh, lalu klik dua kali untuk memulai instalasi. Ikuti petunjuk di layar untuk menyelesaikan penyiapan.
Langkah 3: Selesaikan instalasi
Ikuti setiap petunjuk penyiapan yang muncul dan pilih direktori instalasi yang diinginkan saat diminta. Setelah itu, biarkan penginstal menyelesaikan proses penyiapan di sistem Anda.
Langkah 4: Jalankan OpenCode Desktop
Setelah instalasi selesai, buka OpenCode Desktop dari Menu Mulai atau pintasan desktop. Kemudian, mulai proyek baru atau buka folder yang sudah ada untuk mulai bekerja. Setelah ruang kerja dimuat, Anda dapat berinteraksi dengan asisten AI untuk membuat kode, men-debug masalah, atau membangun fitur langsung di dalam proyek Anda.
Bagaimana cara menginstal OpenCode Terminal/TUI di Mac?
OpenCode Terminal (TUI) di Mac dapat diinstal langsung menggunakan pengelola paket resmi atau perintah instalasi satu baris. Fitur ini dirancang untuk developer yang lebih memilih 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 sini, 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
Jalankan aplikasi Terminal di Mac Anda. Anda dapat membukanya melalui Applications > Utilities > Terminal atau menemukannya dengan cepat menggunakan Spotlight Search. Di sinilah Anda 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 dapat terhubung ke penyedia AI, mengonfigurasi pengaturan, dan mulai bekerja dengan OpenCode.
Bagaimana 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 WSL sudah terinstal, Anda dapat melewati langkah pertama.
Langkah 1: Instal WSL (Disarankan)
Buka PowerShell sebagai Administrator, lalu jalankan perintah berikut:
wsl --installPerintah ini mengaktifkan Windows Subsystem for Linux (WSL) dan menginstal Ubuntu secara default. Setelah instalasi selesai, mulai ulang komputer Anda. Saat pertama kali membuka Ubuntu, Windows akan otomatis menyelesaikan penyiapan lingkungan Linux.
Langkah 2: Buka WSL dan instal OpenCode
Jalankan terminal WSL Anda (seperti Ubuntu) dari menu Mulai Windows. Jika ini pertama kalinya Anda membukanya, selesaikan penyiapan 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, instalasi telah selesai dan Anda dapat mulai menggunakan OpenCode untuk pengodean berbantuan AI.
Bagaimana cara mengintegrasikan API eksternal ke OpenCode?
Salah satu keunggulan utama OpenCode adalah kemampuannya terhubung dengan penyedia model AI eksternal melalui integrasi API. Dengan menambahkan kunci API Anda sendiri, Anda dapat mengakses berbagai model bahasa dan memilih yang paling sesuai dengan alur kerja pengodean Anda.
Integrasikan API eksternal ke OpenCode (Langkah umum)
Berikut langkah-langkah untuk mengintegrasikan API eksternal ke OpenCode:imi
Langkah 1: Buat akun dan buat kunci API
Mulailah dengan membuat akun pada penyedia AI pilihan Anda, seperti Kimi atau layanan lain yang didukung. Setelah akun Anda siap, buka halaman pengelolaan kunci API penyedia tersebut dan buat kunci API baru. Jaga keamanan kunci ini karena diperlukan untuk menghubungkan penyedia ke OpenCode.
Langkah 2: Buka menu koneksi penyedia
Jalankan OpenCode dan buka ruang kerja Anda. Di antarmuka perintah, jalankan perintah berikut:
/connectPerintah ini membuka menu koneksi penyedia, tempat Anda dapat menambahkan dan mengelola layanan AI eksternal.
Langkah 3: Tambahkan kunci API Anda
Pilih penyedia yang ingin Anda gunakan dari daftar opsi yang tersedia. Saat diminta, tempelkan kunci API yang Anda buat sebelumnya lalu konfirmasikan koneksinya. OpenCode akan menyimpan kunci 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, 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 gunakan
Pilih model yang ingin Anda gunakan dari daftar yang tersedia. Setelah dipilih, OpenCode akan meneruskan permintaan Anda melalui model tersebut sehingga Anda dapat membuat kode, men-debug aplikasi, dan menjalankan tugas pengembangan lainnya menggunakan API yang terhubung. Anda dapat mengganti model nanti jika kebutuhan berubah.
Integrasikan Kimi API ke OpenCode
OpenCode mendukung beberapa penyedia AI, sehingga pengembang dapat menghubungkan model eksternal menggunakan kunci API untuk fleksibilitas yang lebih besar. Salah satu opsi yang 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 alat pemrograman, aplikasi, dan alur kerja berbasis AI menggunakan kunci API yang aman. Platform ini mencakup berbagai model Kimi yang dioptimalkan untuk tugas pemrograman, penalaran, dan pemahaman konteks panjang.
Ikuti langkah-langkah berikut untuk mengintegrasikan Kimi API ke OpenCode.
Langkah 1: Buat akun Moonshot AI dan buat kunci API
Kunjungi Kimi AI Open Platform dan masuk ke akun Anda.
Dari dasbor, buka API Keys lalu klik Create API Key.
Setelah kunci dibuat (diawali dengan
sk-), segera salin dan simpan dengan aman. Kunci hanya ditampilkan sekali dan digunakan untuk mengautentikasi permintaan antara OpenCode dan Moonshot AI.
Langkah 2: Hubungkan Moonshot AI ke OpenCode
Buka ruang kerja OpenCode Anda dan jalankan:
/connectMenu koneksi penyedia akan muncul. Cari Moonshot AI (atau Kimi) dari daftar penyedia bawaan, lalu pilih. OpenCode akan meminta Anda memasukkan kunci API.
Saat diminta, tempelkan kunci API yang Anda buat dari konsol Moonshot AI dan tekan Enter:
┌ API key
│ sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
│
└ enterSetelah terverifikasi, OpenCode akan menyimpan kredensial dengan aman ke ~/.local/share/opencode/auth.json dan mengaitkannya dengan konfigurasi penyedia Moonshot AI Anda.
Catatan: OpenCode menyimpan kunci API secara terpisah dari file konfigurasi utama demi keamanan. Perintah
/connectmenangani penyimpanan kredensial, sedangkan perilaku penyedia dikonfigurasi dalamopencode.json.
Langkah 3: Konfigurasikan penyedia di opencode.json (jika diperlukan)
Jika Anda menemukan kesalahan No endpoints found setelah terhubung, atau perlu menyesuaikan penyiapan 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-k3": {"name": "Kimi K3"},"kimi-k2.7-code": {"name": "Kimi K2.7 Code"}}}}}Simpan file 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-k3 | Model andalan terbaru dengan jendela konteks 1 juta token serta kemampuan coding dan penalaran tingkat lanjut |
| kimi-k2.7-code | Model khusus coding dengan konteks 256K dan mode berpikir |
| kimi-k2.7-code-highspeed | Varian model coding berkecepatan tinggi untuk output yang lebih cepat |
| kimi-k2.6 | Model serbaguna dengan konteks 256K, mode berpikir, dan mode tanpa berpikir |
Langkah 5: Pilih model Kimi dan mulai membuat kode
Pilih moonshotai/kimi-k3 dan tetapkan 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 Agen/Alat (seperti kesalahan validasi JSON Schema), ini merupakan masalah kompatibilitas yang diketahui antara persyaratan skema ketat Moonshot AI dan format parameter alat 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 mengubah ide menjadi implementasi secara lebih efisien. Selain pembuatan kode, API ini dapat memahami berbagai jenis input, menyesuaikan diri dengan kebutuhan proyek, dan mengotomatiskan tugas rekayasa rutin. Berikut beberapa manfaat utamanya:
Mengubah input multimodal menjadi implementasi yang berfungsi
Kimi API dapat menafsirkan informasi dari berbagai format, termasuk mockup desain, diagram arsitektur, diagram alur, dan video. API ini menggunakan konteks tersebut untuk memahami kebutuhan proyek dan mengubahnya menjadi spesifikasi teknis atau kode fungsional. Hasilnya, tim dapat beralih dari konsep ke implementasi dengan lebih sedikit langkah penerjemahan manual.
Menangani coding jangka panjang dan tugas rekayasa yang kompleks
Kimi API membantu OpenCode menangani tugas coding yang lebih besar dan memerlukan perencanaan, konsistensi, serta penyempurnaan. API ini berguna untuk membangun fitur, merefaktor kode, dan menyelesaikan masalah rekayasa yang kompleks.
Menalar masalah melalui pemanggilan alat bertahap
Kimi API dapat menalar tugas bertahap dan memanggil alat saat diperlukan. Hal ini membantu dalam debugging, analisis kode, dan alur kerja yang tidak dapat diselesaikan dalam satu respons.
Bagaimana cara memperbaiki masalah saat menginstal OpenCode？
Menginstal OpenCode biasanya mudah, tetapi pengguna dapat menghadapi kesalahan penyiapan umum akibat ketidakcocokan lingkungan, dependensi, atau masalah konfigurasi. Berikut panduan yang jelas dan praktis untuk membantu menyelesaikan masalah instalasi yang paling sering terjadi dengan cepat dan efisien.
Perintah tidak ditemukan: opencode
Jika melihat kesalahan ini, artinya sistem tidak dapat menemukan executable OpenCode di PATH. Hal ini biasanya terjadi ketika instalasi belum selesai atau variabel lingkungan tidak diatur dengan benar.
Untuk memperbaikinya, terlebih dahulu verifikasi instalasi dan pastikan direktori biner ditambahkan ke PATH sistem. Jika diinstal melalui npm, periksa path bin npm global dan perbarui konfigurasi shell sesuai kebutuhan. Memulai ulang terminal sering kali menyelesaikan masalah setelah perbaikan dilakukan.
Versi Node.js terlalu lama
Hanya metode instalasi npm yang memerlukan lingkungan Node.js — skrip instalasi dan manajer paket (Homebrew, Scoop, Chocolatey) menginstal biner mandiri yang tidak memerlukan Node.js.
Jika menginstal melalui npm dan mengalami kesalahan versi, periksa versi saat ini menggunakan node --version lalu tingkatkan Node.js dengan pengelola versi seperti nvm. Setelah peningkatan, instal ulang OpenCode untuk memastikan kompatibilitas dengan lingkungan runtime yang diperbarui.
Kesalahan izin npm
Kesalahan izin biasanya terjadi ketika npm mencoba menginstal paket global tanpa akses tulis yang memadai.
Alih-alih menggunakan sudo, konfigurasikan direktori global npm khusus di folder home dan perbarui pengaturan PATH. Hal ini memastikan instalasi yang lebih aman dan stabil. Setelah izin diperbaiki, jalankan ulang perintah instalasi untuk menyelesaikan penyiapan dengan sukses.
Masalah jaringan/firewall
Di jaringan terbatas atau lingkungan perusahaan, instalasi OpenCode dapat gagal karena akses registry npm diblokir atau unduhan lambat.
Untuk memperbaikinya, beralihlah ke registry npm alternatif atau gunakan metode instalasi langsung seperti curl atau unduhan biner. Pastikan juga firewall mengizinkan lalu lintas Node.js dan npm, karena koneksi yang diblokir sering mengganggu instalasi paket.
Masalah rendering TUI
Jika OpenCode terbuka tetapi tampak rusak, tidak sejajar, atau menampilkan teks yang kacau, masalahnya biasanya terletak pada kompatibilitas terminal.
Gunakan emulator terminal modern yang mendukung warna asli dan rendering Unicode, seperti Windows Terminal, WezTerm, atau iTerm2. Memperbarui pengaturan terminal atau beralih lingkungan biasanya langsung menyelesaikan masalah tampilan.
Kesimpulan
Instalasi OpenCode yang tepat dan konfigurasi yang benar memastikan kinerja lancar di berbagai sistem sekaligus mengurangi risiko kesalahan penyiapan umum. Jika dependensi, pengaturan terminal, dan koneksi API dikelola dengan baik, pengguna dapat segera menyelesaikan masalah dan menjaga lingkungan pengembangan tetap stabil. Integrasi layanan eksternal seperti Kimi API semakin meningkatkan fleksibilitas dengan memungkinkan akses model tingkat lanjut dalam alur kerja.