Lunos logoLunos
DokumentasiSDKIntegrasi

Integrasi: Cline dengan Lunos

Panduan ini menunjukkan cara menghubungkan Cline ke Lunos menggunakan provider OpenAI Compatible sehingga Anda bisa menggunakan model Lunos sebagai asisten coding AI langsung di VS Code.

Apa itu Cline?

Cline adalah asisten coding AI otonom yang berjalan di editor VS Code. Cline dapat membuat dan mengedit file, menjalankan perintah terminal, menggunakan otomasi browser, dan membantu Anda membangun proyek kompleks — semuanya melalui bahasa alami. Cline mendukung berbagai provider AI melalui pengaturan provider OpenAI Compatible.

Prasyarat

  • Ekstensi Cline terinstal di VS Code (atau fork VS Code seperti Cursor/Windsurf)
  • API key Lunos (dapatkan dari dashboard)
  • Base URL Lunos: https://api.lunos.tech/v1

Langkah Setup

Ikuti langkah-langkah berikut secara berurutan.

1) Buka pengaturan Cline

Buka panel Cline di VS Code dan klik ikon settings/gear (⚙️) untuk membuka konfigurasi provider.

Buka panel sidebar Cline, lalu klik ikon gear di atas untuk mengakses pengaturan provider

2) Pilih provider OpenAI Compatible

Di dropdown API Provider, pilih "OpenAI Compatible".

Klik dropdown API Provider dan pilih "OpenAI Compatible" dari daftar

3) Konfigurasi koneksi

Isi field berikut:

Field Nilai
Base URL https://api.lunos.tech/v1
API Key API key Lunos Anda
Model ID Model dari dashboard Lunos (misal anthropic/claude-sonnet-4-20250514)

Masukkan base URL Lunos, paste API key, dan ketik model ID yang ingin digunakan

4) (Opsional) Konfigurasi info model

Di bagian Model Configuration, Anda bisa mengatur:

  • Context Window: Sesuaikan berdasarkan model yang dipilih (cek halaman model untuk detail)
  • Max Output Tokens: Sesuaikan berdasarkan kebutuhan
  • Image Support: Aktifkan jika menggunakan model yang mendukung vision

Buka Model Configuration untuk mengatur context window, max tokens, dan aktifkan image support

5) Verifikasi koneksi

Klik tombol Verify (atau mulai percakapan) untuk memastikan Cline dapat terhubung ke Lunos. Jika berhasil, Anda siap coding dengan AI bertenaga Lunos.

Klik Verify untuk menguji koneksi — pesan sukses mengonfirmasi Cline terhubung ke Lunos

Tips Penggunaan

  • Ganti model: Ubah field Model ID kapan saja untuk beralih antar model Lunos tanpa mengkonfigurasi ulang provider.
  • Mode Plan & Act: Cline mendukung mode Plan (berpikir/merencanakan) dan mode Act (mengeksekusi perubahan). Keduanya bekerja dengan model Lunos.
  • Instruksi kustom: Gunakan fitur rules/custom instructions Cline untuk menyesuaikan perilaku AI sesuai proyek Anda.

Troubleshooting

Error autentikasi (401/403)

  • Pastikan API key benar dan aktif di dashboard.
  • Pastikan key belum dicabut atau kedaluwarsa.

Model tidak ditemukan

  • Pastikan Model ID sesuai persis dengan model yang tersedia di daftar model Lunos.
  • Model ID bersifat case-sensitive.

Timeout koneksi atau error jaringan

  • Pastikan base URL adalah https://api.lunos.tech/v1 (dengan suffix /v1).
  • Periksa bahwa jaringan Anda mengizinkan koneksi HTTPS keluar.

Respons tidak terduga atau kosong

  • Beberapa model memiliki kemampuan berbeda. Jika tool use atau vision tidak berfungsi, verifikasi bahwa model mendukung fitur tersebut.
  • Coba tingkatkan Max Output Tokens di Model Configuration.

Keamanan

  • Jangan pernah commit API key ke repository.
  • Gunakan file .clineignore Cline untuk mencegah file sensitif dibaca oleh AI.
  • Gunakan API key Lunos terpisah per environment (dev/staging/prod).