Dokumentasi

Aider

Aider membaca OPENAI_API_BASE dan OPENAI_API_KEY. Arahkan keduanya ke Kunavo, awali ID model dengan openai/, lalu Claude dan GPT hanya terpisah oleh satu argumen --model.

Dua variabel lingkungan dan sebuah prefiks. Atur OPENAI_API_BASE ke https://api.kunavo.com/v1, OPENAI_API_KEY ke key sk-kn-… Anda, lalu jalankan Aider dengan --model openai/<id>. Tidak ada yang berubah pada repositori atau instalasi Aider Anda.

~/.zshrc

export OPENAI_API_BASE=https://api.kunavo.com/v1
export OPENAI_API_KEY=sk-kn-...

# The openai/ prefix is required — it tells Aider to speak the OpenAI
# protocol to OPENAI_API_BASE instead of resolving the id as a known model.
aider --model openai/claude-sonnet-5

Prefiks openai/ wajib digunakan dan akhiran /v1 harus ada di URL dasar. Jika prefiks dihilangkan, Aider akan mencocokkan ID dengan tabel penyedianya sendiri — sehingga muncul error “model tidak dikenal” — dan jika /v1 dihilangkan, permintaan tidak akan cocok dengan rute yang benar.

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Ekspor OPENAI_API_BASE dan OPENAI_API_KEY di shell tempat Anda menjalankan Aider, atau masukkan ke ~/.aider.conf.yml seperti yang ditunjukkan di bawah.
Jalankan Aider di repositori Anda dengan aider --model openai/claude-sonnet-5.
Saat dijalankan, Aider mencetak model yang berhasil dicocokkannya. Jika baris tersebut menampilkan ID yang Anda minta, endpoint sudah terhubung.

Referensi Aider untuk hal ini adalah halaman API yang kompatibel dengan OpenAI.

Agar tidak disimpan di profil shell

Dua nilai yang sama dapat disimpan dalam file konfigurasi Aider, yang lebih tepat digunakan saat Anda berpindah endpoint untuk setiap project.

~/.aider.conf.yml

# ~/.aider.conf.yml — same two values, without exporting them each shell.
openai-api-base: https://api.kunavo.com/v1
openai-api-key: sk-kn-...
model: openai/claude-sonnet-5

Verifikasi sebelum men-debug Aider

Satu permintaan cukup untuk memastikan apakah kegagalan berasal dari endpoint, key, atau pencocokan model Aider. Jika permintaan ini mengembalikan daftar ID model dalam JSON, URL dasar dan key yang sama akan berfungsi di Aider — dan error yang tersisa adalah prefiks openai/.

# Settles whether a failure is the endpoint, the key, or Aider.
# A JSON list of model ids means the same base URL will work in Aider.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Model yang sebaiknya dipilih

Setiap model teks di Kunavo dapat diakses sebagai openai/<id> — daftar lengkap tersedia di halaman model dan dapat diambil langsung dari GET /v1/models. Tarif dalam USD per 1 juta token, input / output.

ID model	Kunavo masuk / keluar	Kesesuaiannya
`claude-haiku-4-5`	$0.70 / $3.50	Claude termurah — cocok untuk pembuatan peta repositori dan pesan commit Aider
`claude-sonnet-5`	$1.40 / $7.00	Keseimbangan kualitas dan harga sebagai pilihan bawaan untuk penyuntingan
`claude-opus-5`	$3.50 / $17.50	Tingkat Claude dengan kualitas tertinggi — untuk perubahan tingkat arsitektur
`gpt-5-6-terra`	$0.70 / $4.20	Key yang sama, keluarga model berbeda — berguna sebagai pendapat kedua untuk diff yang sulit

Aider mengirim ulang peta repositori dan file yang diedit pada setiap pertukaran, sehingga penggunaan token mengikuti ukuran konteks, bukan ukuran edit. Karena itu, caching prompt adalah faktor terpenting di sini, dan penggunaan --model bersama --weak-model openai/claude-haiku-4-5 adalah kombinasi termurah: model yang kuat melakukan penyuntingan, sedangkan model yang lebih lemah menulis pesan commit dan ringkasan. Penagihan dihitung per token dari saldo prabayar tanpa biaya bulanan — detailnya ada di penagihan.

Pertanyaan umum

Bagaimana cara menggunakan Aider dengan API yang kompatibel dengan OpenAI?

Atur OPENAI_API_BASE ke URL dasar endpoint dan OPENAI_API_KEY ke key Anda, lalu jalankan Aider dengan ID model yang diawali prefiks openai/ — misalnya `aider --model openai/claude-sonnet-5`. Untuk Kunavo, URL dasarnya adalah https://api.kunavo.com/v1. Prefiks ini wajib: tanpa prefiks, Aider akan mencoba mencocokkan ID tersebut dengan tabel penyedianya sendiri, alih-alih mengirimkannya ke endpoint Anda.

Bisakah Aider menggunakan model Claude melalui endpoint yang kompatibel dengan OpenAI?

Ya. Aider berkomunikasi dengan alamat yang ditetapkan oleh OPENAI_API_BASE menggunakan protokol OpenAI, sehingga model Claude yang disajikan dalam format tersebut dapat diakses tanpa kredensial Anthropic — ID model hanya berupa string lain dalam daftar /v1/models. Di Kunavo, semua ID Claude dan GPT berada di balik key yang sama, jadi untuk beralih di antara keduanya, Anda hanya perlu mengganti argumen --model, bukan konfigurasinya.

Mengapa Aider menyatakan model tidak dikenal?

Hampir selalu karena prefiks openai/ tidak disertakan. Aider menganggap ID tanpa prefiks sebagai model yang seharusnya dikenali dan gagal saat tidak mengenalinya; `openai/<id>` memberi tahu Aider untuk meneruskan ID langsung ke OPENAI_API_BASE. Penyebab umum kedua adalah URL dasar tanpa akhiran /v1, yang menghasilkan error koneksi atau 404, bukan error model tidak dikenal.

Apakah Aider menampilkan biaya sesi?

Aider mencetak jumlah token dan perkiraan biaya untuk setiap pertukaran, berdasarkan metadata modelnya sendiri — untuk endpoint kustom, perkiraan itu mungkin keliru karena Aider tidak mengetahui tarif endpoint Anda. Anggap jumlah token sebagai bagian yang dapat diandalkan, dan periksa biaya sebenarnya dari penyedia Anda. Di Kunavo, biaya per permintaan tersedia di tampilan penggunaan dan dibebankan dari saldo prabayar tanpa biaya bulanan.