Panduan OpenCode API: Hubungkan API Model dan Mulai Coding

Apa itu OpenCode?

OpenCode adalah agent coding AI open source yang berjalan di terminal dan juga dapat digunakan melalui alur kerja desktop, IDE, dan berbasis server. OpenCode membantu developer bekerja dengan codebase dengan cara membaca file, menjelaskan struktur, mengedit kode, meninjau perubahan, dan menjalankan tugas melalui penyedia LLM yang terhubung. Anda menghubungkannya ke penyedia model, seperti Kimi API, dan OpenCode menggunakan penyedia tersebut untuk merencanakan, bernalar, dan bertindak di dalam lingkungan pengembangan Anda.

Apa yang bisa Anda lakukan dengan OpenCode?

Anda dapat memilih OpenCode saat menginginkan alur kerja coding AI yang dapat bekerja langsung dengan proyek Anda. Misalnya:

Menulis, mengedit, dan me-refactor kode: Anda dapat meminta OpenCode menambahkan fitur, memodifikasi file yang sudah ada, me-refactor sebuah fungsi, atau menjelaskan bagaimana sebuah modul seharusnya diubah. Untuk hasil terbaik, arahkan ke file atau direktori yang tepat terkait.

Men-debug error dan membuat test: OpenCode dapat memeriksa output error, membaca file terkait, mengusulkan perbaikan, dan menambahkan test. Ini sangat berguna ketika kegagalan bergantung pada konteks proyek.

Meninjau perubahan kode: Anda dapat menggunakan OpenCode untuk meninjau perubahan lokal sebelum melakukan commit. OpenCode dapat mencari kemungkinan bug, test yang hilang, pola yang tidak konsisten, dan perubahan berisiko.

Mengotomatiskan alur kerja pengembangan: OpenCode juga mendukung alur kerja non-interaktif dan berbasis server. Misalnya, Anda dapat menjalankan prompt sekali pakai dari command line atau menjalankan server OpenCode headless dan menghubungkannya dengan klien atau integrasi lain.

Prasyarat untuk Mengonfigurasi OpenCode dengan API LLM

Sebelum mengonfigurasi OpenCode dengan API LLM, siapkan hal-hal berikut:

• Terminal yang berfungsi di macOS, Linux, atau Windows (disarankan menggunakan WSL).

• Node.js, Homebrew, atau metode instalasi lain yang didukung.

• Folder proyek yang aman untuk diuji coba.

• Akun penyedia model.

Untuk OpenCode, ingat bahwa kredensial penyedia bersifat sensitif. Jangan tempelkan API key Anda ke issue publik, tangkapan layar yang dibagikan, file source, atau konfigurasi yang di-commit.

Langkah 1: Instal OpenCode

Metode instalasi tercepat menurut dokumentasi resmi OpenCode adalah menggunakan install script. Jalankan perintah ini di terminal Anda:

OpenCode juga mendukung instalasi melalui npm, Homebrew, dan perintah lainnya. Jika Anda lebih suka versi desktop, Anda dapat mengunduh versi yang sesuai dengan perangkat Anda.

Langkah 2: Jalankan OpenCode

Buka proyek yang ingin Anda kerjakan dengan OpenCode:

Jalankan OpenCode:

Jika ini pertama kalinya Anda menggunakan OpenCode di proyek ini, inisialisasi dari dalam TUI:

Cara Mengonfigurasi OpenCode dengan API LLM

Dalam kebanyakan kasus, menggunakan “OpenCode API” berarti menghubungkan OpenCode ke penyedia LLM eksternal melalui API key. Penyedia menyediakan model, sementara OpenCode menangani alur kerja coding-agent di dalam proyek Anda. Langkah-langkah berikut menggunakan Kimi API sebagai contoh penyedia.

Langkah 1: Buat Kimi API key Anda

Buka Kimi Open Platform. Buat API key dari konsol, lalu simpan di password manager atau secret manager. Jika konsol Anda hanya menampilkan key lengkap sekali saja, salin key tersebut sebelum meninggalkan halaman.

Langkah 2: Hubungkan penyedia model

Jalankan OpenCode di proyek Anda:

Di dalam antarmuka OpenCode, jalankan:

Cari Moonshot AI atau entri penyedia yang kompatibel dengan Kimi yang ditampilkan versi OpenCode Anda. Dokumentasi resmi penyedia OpenCode mencakup alur penyedia Moonshot AI: buat key di konsol Moonshot AI, jalankan /connect, cari Moonshot AI, lalu masukkan API key.

Jika versi Anda tidak mencantumkan Moonshot AI, perbarui OpenCode dan segarkan daftar model:

Langkah 3: Masukkan Kimi API key Anda

Saat OpenCode meminta API key, tempelkan Kimi API key Anda.

OpenCode menyimpan kredensial penyedia di file auth lokalnya. Dokumentasi resmi penyedia mencantumkan path berikut:

Biasanya Anda tidak perlu mengedit file tersebut secara manual. Sebagai gantinya, gunakan alur /connect penyedia OpenCode.

Langkah 4: Pilih model Kimi

Setelah menghubungkan penyedia, pilih model dari dalam OpenCode:

Pilih model Kimi yang ingin Anda gunakan. Untuk alur kerja coding-agent baru, mulailah dengan:

Jika Anda perlu menjalankan OpenCode secara non-interaktif dengan model tertentu, gunakan format provider/model yang ditampilkan pada daftar model OpenCode Anda. Contohnya:

Lalu gunakan identifier model persis yang ditampilkan OpenCode.

Langkah 5: Jalankan tugas coding pertama Anda

Mulailah dengan tugas berisiko rendah agar Anda dapat memverifikasi bahwa penyedia, model, akses proyek, dan izin semuanya berfungsi:

Hasil yang diharapkan:

Kemudian coba tugas coding kecil:

Ini memastikan OpenCode dapat membaca proyek dan bernalar atas codebase sebelum Anda mengizinkannya membuat perubahan.

Mengapa Menggunakan Kimi API dengan OpenCode?

Kimi API cocok digunakan dengan OpenCode ketika Anda menginginkan penyedia model yang kompatibel dengan OpenAI untuk alur kerja coding dan agent.

Kemampuan coding dan reasoning yang kuat

{{KIMI_MODEL_LATEST_FULL}} secara resmi diposisikan untuk coding jangka panjang, instruction following, self-correction, dan eksekusi agent. Ini membuatnya relevan untuk tugas OpenCode seperti pengeditan multi-file, debugging, refactoring, dan review.

Dukungan long-context untuk proyek yang lebih besar

Dokumentasi resmi {{KIMI_MODEL_LATEST_FULL}} mencantumkan dukungan long context untuk {{KIMI_MODEL_LATEST_FULL}} dan beberapa model seri K2. Dalam alur kerja agent, long context bisa membantu ketika tugas mengharuskan pembacaan banyak file, membandingkan pola implementasi, atau menyimpan riwayat tugas dalam jumlah besar.

API yang kompatibel dengan OpenAI untuk penyiapan yang lebih mudah

Kimi API kompatibel dengan format OpenAI API. Untuk tool yang sudah mendukung chat completions bergaya OpenAI, ini sering kali berarti Anda hanya perlu mengonfigurasi API key, Base URL, dan nama model.

Penggunaan fleksibel di luar OpenCode

Anda dapat menggunakan API key Kimi yang sama di tool developer lain yang kompatibel dengan OpenAI, skrip langsung, atau alur kerja internal. Jika nantinya Anda menggunakan OpenCode server atau OpenCode SDK, konfigurasikan Kimi sebagai model provider terlebih dahulu.

Pengaturan API OpenCode Utama yang Perlu Anda Ketahui

Pengaturan berikut ini mengendalikan sebagian besar masalah penyiapan API dan provider OpenCode.

API key

API key mengautentikasi permintaan Anda ke model provider. Di OpenCode, Anda biasanya menambahkannya dengan:

Provider

Provider memberi tahu OpenCode dari mana model tersebut berasal. Dalam panduan ini, providernya adalah Moonshot AI / Kimi API. Provider lain dapat dikonfigurasi secara terpisah, tetapi setiap provider memerlukan kredensial dan daftar model sendiri.

Base URL

Base URL adalah endpoint yang digunakan untuk permintaan API langsung yang kompatibel dengan OpenAI. Untuk contoh Kimi API, gunakan endpoint yang tercantum dalam dokumentasi Kimi API terbaru atau konsol akun Anda.

Nama model

Nama model harus persis sama dengan yang digunakan provider. Kesalahan ketik kecil bisa menyebabkan error model-not-found.

Contoh umum:

Di OpenCode, konfirmasi identifier provider/model dengan:

Mengatasi Error API OpenCode yang Umum Terjadi

Sebagian besar masalah penyiapan berasal dari salah satu dari lima hal ini: kredensial, endpoint, provider, nama model, atau ukuran context.

Autentikasi gagal

Autentikasi bisa gagal jika API key salah tempel, terhapus, atau telah dirotasi. Hal ini juga bisa terjadi ketika provider yang dipilih salah, atau ketika key tersebut milik akun atau wilayah yang berbeda dari yang sedang dikonfigurasi di OpenCode.

Solusi:

Sambungkan ulang provider dan tempel API key yang baru. Jika Anda menggunakan environment variable untuk pengujian langsung, atur ulang key tersebut:

Error endpoint tidak valid

Error endpoint tidak valid biasanya berarti OpenCode tidak dapat menjangkau endpoint provider yang benar. Penyebab umumnya meliputi Base URL yang salah ketik, penggunaan campuran endpoint .ai dan .cn di berbagai tool, atau proxy/firewall yang menulis ulang permintaan sebelum mencapai provider.

Solusi:

Periksa endpoint yang tercantum dalam dokumen atau konsol Kimi API Anda saat ini. Untuk pengujian API langsung, gunakan satu endpoint secara konsisten:

Model tidak didukung

Error ini bisa terjadi ketika nama model salah ketik, model yang dipilih tidak tersedia untuk akun Anda, atau cache daftar model OpenCode sudah usang. Ini juga bisa terjadi ketika identifier provider/model yang digunakan OpenCode berbeda dari nama model mentah yang tercantum dalam dokumentasi provider.

Solusi:

Kemudian pilih model tersebut lagi:

Rate limit terlampaui

Error rate limit biasanya berarti provider menerima terlalu banyak permintaan dalam waktu singkat. Ini bisa terjadi jika beberapa tugas agent berjalan bersamaan, atau jika skrip/integrasi melakukan retry pada permintaan yang gagal secara terlalu agresif.

Solusi:

Jeda tugas tersebut, kurangi jumlah proses paralel, dan periksa konsol provider Anda untuk status kuota atau penagihan. Hindari membuat loop retry tanpa batas di sekitar OpenCode atau panggilan Kimi API langsung.

Context window overflow

Context window overflow biasanya berarti tugas terlalu besar untuk diproses model sekaligus. Ini bisa terjadi jika terlalu banyak file disertakan, jika OpenCode diminta memeriksa seluruh repositori, atau jika sesi yang panjang telah mengumpulkan terlalu banyak riwayat percakapan.

Perbaikan:

Minta OpenCode untuk mengerjakan cakupan yang lebih kecil:

Anda juga bisa memulai sesi baru untuk tugas yang lebih sempit.

Kesimpulan

OpenCode dapat menghubungkan codebase Anda ke penyedia model, menjalankan tugas coding dari terminal. Kimi API dapat menyediakan backend model untuk alur kerja tersebut melalui pengaturan yang kompatibel dengan OpenAI. Jika Anda ingin alur kerja agent coding yang praktis, buat Kimi API key Anda, hubungkan Moonshot AI di OpenCode, pilih model Kimi, dan jalankan tugas proyek kecil untuk memverifikasi pengaturan tersebut.