Development Tools

Menggunakan OneAster di Cursor

Panduan terperinci untuk mengonfigurasi dan menggunakan layanan API OneAster di editor kode AI Cursor. Panduan ini membantu Anda mengatur API OneAster di Cursor untuk mengakses beragam sumber daya model AI dalam pengembangan kode.

Prasyarat

Sebelum memulai, pastikan:
  1. Cursor sudah terinstal
    Unduh dan instal versi yang sesuai untuk OS Anda dari situs Cursor
  2. Anda memiliki API key OneAster
    Masuk ke Konsol OneAster untuk mendapatkan API key Anda (diawali dengan sk-)
Tips: Jika Anda belum memiliki akun OneAster, daftar di OneAster dan dapatkan API key terlebih dahulu.

Langkah 1: Buka Pengaturan Cursor

Setelah menjalankan Cursor, buka Settings:
  1. Klik ikon ⚙️ Settings (roda gigi) di sudut kanan atas
  2. Atau gunakan pintasan:
    • Windows/Linux: Ctrl+Shift+J
    • macOS: Cmd+Shift+J

Antarmuka utama Cursor — buka Settings dari roda gigi kanan atas

Langkah 2: Konfigurasikan pengaturan model

2.1 Buka pengaturan model

Di Pengaturan:
  1. Temukan Models di sidebar kiri
  2. Buka halaman pengaturan model
Cursor Settings - Models

2.2 Gunakan OpenAI API Key

Di halaman pengaturan model:
  1. Temukan bagian OpenAI API Key
  2. Klik Add new atau Override OpenAI Base URL
Penting: Cursor mendukung API yang kompatibel dengan OpenAI, sehingga OneAster dapat dikonfigurasi sebagai provider kustom.

2.3 Konfigurasikan OneAster

Masukkan informasi berikut:
Penting: - Base URL harus menyertakan sufiks /v1: https://api.oneaster.ai/v1 - API key harus berupa key sk-... dari konsol OneAster - Setelah disimpan, Cursor menggunakan model OneAster untuk completion dan chat

Masukkan API Key dan Base URL

Langkah 3: Pilih model

3.1 Pemilihan model

Model selection

Di pengaturan model, Anda dapat memilih model yang akan digunakan. Keluarga model yang tersedia:
  • GPT-4/5 — kuat untuk pembuatan kode kompleks dan tanya jawab
    • gpt-5 — GPT-5 terbaru
    • gpt-4o — GPT-4o
    • gpt-4o-mini — lebih cepat, biaya lebih rendah
  • Claude — kuat untuk pemahaman dan refactoring
    • claude-sonnet-4-5-20250929 — Claude Sonnet 4.5
    • claude-haiku-4-5-20251001 — Claude Haiku 4.5
  • Lainnya
    • gemini-2.0-flash-exp — Google Gemini 2.0 Flash
Saran: - 💰 Penyelesaian (hemat biaya): gpt-4o-mini - 🚀 Tugas berat (performa): gpt-5, gpt-4o, claude-sonnet-4-5-20250929 - ⚡ Latensi rendah: gpt-4o-mini, gemini-2.0-flash-exp

3.2 Model per fitur

Anda dapat memilih model berbeda untuk setiap fitur:
  • Chat — percakapan dengan AI
  • Autocomplete — saran inline
  • Cmd+K — edit / generate cepat
Pilih yang paling sesuai untuk setiap alur kerja.

Langkah 4: Mulai menggunakan

Setelah dikonfigurasi, Anda dapat menggunakan fitur AI Cursor.

4.1 AI Chat (Cmd+L / Ctrl+L)

  1. Tekan Cmd+L (macOS) atau Ctrl+L (Windows/Linux)
  2. Ajukan pertanyaan atau berikan tugas, misalnya:
    • “How do I implement quicksort?”
    • “Help me optimize this code’s performance”
    • “Explain how this function works”

Chat dengan asisten

4.2 Penyelesaian kode

  1. Ketik seperti biasa di editor
  2. Cursor menyarankan penyelesaian
  3. Tekan Tab untuk menerima
Autocomplete

4.3 Edit cepat (Cmd+K / Ctrl+K)

  1. Pilih kode
  2. Tekan Cmd+K (macOS) atau Ctrl+K (Windows/Linux)
  3. Jelaskan editan, misalnya:
    • “Tambahkan penanganan error”
    • “Refactor fungsi ini”
    • “Tambahkan anotasi tipe”
Edit cepat

4.4 Jelaskan kode

  1. Pilih kode
  2. Klik kanan Explain with AI (atau gunakan shortcut)
  3. AI akan menjelaskan perilaku dan logikanya

FAQ

Q1: Tidak dapat terhubung ke OneAster?

Coba:
  1. Base URL — harus persis https://api.oneaster.ai/v1
  2. API key — key sk-... yang valid dari konsol
  3. Jaringan — pastikan https://api.oneaster.ai dapat dijangkau; proxy mungkin diperlukan di beberapa wilayah

Q2: Respons lambat?

Coba:
  1. Gunakan model yang lebih ringan (gpt-4o-mini alih-alih gpt-4o, atau gemini-2.0-flash-exp)
  2. Persingkat konteks — kirim lebih sedikit kode, ajukan pertanyaan yang lebih tepat
  3. Periksa latensi / proxy bila perlu

Q3: Error API?

Q4: Penggunaan dan penagihan?

Buka Konsol OneAster:
  • 📊 Statistik panggilan
  • 💰 Rincian biaya
  • 📈 Tren penggunaan
  • 🔍 Log permintaan

Tips

1. Gunakan konteks

  • Buka file terkait
  • Rujuk file dengan @filename
  • Rujuk folder dengan @folder

2. Prompt yang jelas

❌ Lemah:
✅ Kuat:

3. Iterasi

Mulai kecil → perbaiki → uji → sesuaikan prompt.

4. Aturan proyek

Tentukan gaya, penamaan, arsitektur, dan tes di .cursorrules.

Fitur

Dengan Cursor + OneAster:
  • 💬 Chat untuk pertanyaan coding
  • ⚡ Penyelesaian cerdas
  • ✏️ Editan dalam bahasa alami
  • 🔍 Pemahaman kode yang lebih dalam
  • 🐛 Bantuan debugging
  • 📝 Dokumentasi dan komentar
  • 🔄 Refactoring
  • 🧪 Scaffolding test

Dukungan


Mulai dengan OneAster

Daftar, dapatkan API key Anda, dan kirim kode lebih cepat dengan Cursor!