Theia IDE

Satu entri di ai-features.openAiCustom.customOpenAiModels — model, url, dan apiKey — menempatkan Kunavo di balik Theia Coder, Architect, dan inline completion.

{
  "ai-features.openAiCustom.customOpenAiModels": [
    {
      "model": "claude-sonnet-5",
      "url": "https://api.kunavo.com/v1",
      "id": "kunavo-sonnet-5",
      "apiKey": "sk-kn-...",
      "developerMessageSettings": "system"
    },
    {
      "model": "claude-haiku-4-5",
      "url": "https://api.kunavo.com/v1",
      "id": "kunavo-haiku-4-5",
      "apiKey": "sk-kn-...",
      "developerMessageSettings": "system"
    }
  ]
}

Langkah demi langkah

1. Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
2. Aktifkan fiturnya: dokumentasi Theia menyebutkan bahwa Anda perlu membuka Preferences dan mengaktifkan pengaturan “AI-features => AI Enable”. Semua yang ada di bawah ini tidak akan muncul sampai langkah itu dilakukan.
3. Buka tampilan AI Configuration — Alt+A, atau pilih AI Configuration dari menu Manage (ikon roda gigi) di kiri bawah, tepat di bawah Settings. Kategorinya adalah General, Providers & Models, Model Aliases, Agents, Prompts & Skills, Variables, Tools, Token Usage, dan MCP Servers.
4. Tambahkan entri di atas. Dokumentasi menjelaskan langkah ini sebagai mengeklik tautan di bagian pengaturan untuk Model yang Kompatibel dengan OpenAI — preferensi ini berupa daftar terstruktur, dan Theia menyatakan bahwa pengaturan terstruktur tanpa editor khusus “menggunakan settings.json”, yaitu berkas yang terbuka setelah Anda mengeklik tautan tersebut. Satu objek untuk setiap ID model; url dan apiKey diulang.
5. Arahkan sesuatu untuk menggunakannya. Di bagian Agen, setiap agen memiliki pemilih Model Bahasa; banyak agen menggunakan alias model untuk menentukan modelnya, sehingga menetapkan default/code, default/universal, default/code-completion, default/summarize dan default/fast di bagian Alias Model mengalihkan beberapa agen sekaligus.
6. Kirim pesan obrolan ke Theia Coder, lalu minta sesuatu yang melibatkan berkas. Agen dalam IDE ini mengandalkan pemanggilan alat dan konten ruang kerja, sehingga percobaan pertama yang membaca atau mengedit sesuatu memberi Anda lebih banyak informasi daripada sekadar sapaan — dan Penggunaan Token dalam tampilan yang sama menunjukkan berapa token yang digunakan giliran tersebut.

Diperiksa terhadap halaman fitur AI Theia IDE, bagian Model yang Kompatibel dengan OpenAI pada 21 September 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di Theia IDE.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

Klaim Theia untuk penyedia ini

Tabel Ikhtisar Penyedia LLM di halaman resmi Theia menilai setiap penyedia berdasarkan tiga aspek. Ini adalah klaim Theia tentang Theia, yang disalin dari tabel tersebut pada tanggal di atas — bukan hasil pengujian Kunavo, dan kolom berjudul “Persyaratan untuk ID model” adalah satu-satunya bagian tabel ini yang ditulis di sini.

Theia menambahkan catatannya sendiri dua paragraf di atas tabel tersebut, yang layak diulang karena memberikan kerangka yang jujur untuk seluruh halaman ini: tidak semua model “dapat langsung berfungsi, karena mungkin memerlukan penyesuaian atau pengoptimalan khusus”.

Apa yang sebenarnya menimbulkan biaya

Theia IDE bersifat sumber terbuka dan gratis untuk diunduh, dan fitur AI-nya tidak dikenai biaya tersendiri — yang menimbulkan biaya adalah pemanggilan model, yang ditagihkan oleh pihak yang menyediakan kunci dalam apiKey. Dua pengaturan lebih memengaruhi tagihan tersebut daripada pilihan model, dan keduanya ada dalam dokumentasi:

1. Pelengkapan Kode Otomatis aktif secara bawaan, dan dokumentasi menjelaskannya sebagai fitur yang membuat “permintaan terus-menerus ke LLM yang mendasarinya selama penulisan kode”. Agen inilah yang berjalan ribuan kali sehari. Tetapkan default/code-completion ke ID yang murah, atau alihkan agen ke mode manual di 'AIFeatures'=>'CodeCompletion' dan picu dengan Ctrl+Alt+Space.
2. Jumlah Maksimum Baris Konteks, dalam kelompok pengaturan yang sama, membatasi seberapa banyak bagian berkas di sekitar kode yang disertakan dalam setiap permintaan pelengkapan. Setiap barisnya ditagihkan sebagai input pada setiap pemanggilan yang dipicu oleh penekanan tombol.

Pola agen obrolan justru sebaliknya: lebih sedikit pemanggilan, konteks jauh lebih besar, dan berkas ruang kerja yang sama dikirim ulang pada setiap giliran. Itulah kasus penggunaan cache prompt — lihat /docs/caching — dan itulah sebabnya dua bagian tabel model di atas dipisahkan berdasarkan seberapa sering agen berjalan, bukan seberapa cerdas agen tersebut.

Saat koneksi tidak berhasil

1. 404 — url. Kunavo melayani /v1/chat/completions, sehingga kolom tersebut memerlukan URL akar /v1; baik origin saja maupun .../chat/completions lengkap sama-sama tidak tepat.
2. 401 — kunci. Readme Theia menyatakan bahwa apiKey “akan dikirim sebagai Token Bearer dalam permintaan otorisasi”, persis seperti yang diharapkan oleh kunci sk-kn-. Perhatikan perilaku bawaan yang didokumentasikan: jika apiKey sama sekali tidak ada, Theia mengirim no-key, sehingga kolom yang tidak diisi tampak seperti kunci yang ditolak, bukan kunci yang tidak ada. (true berarti “gunakan kunci API OpenAI global” — bukan yang Anda inginkan di sini.)
3. ID model tidak ada dalam pemilih — daftar itu berasal dari entri customOpenAiModels Anda sendiri, bukan dari endpoint, sehingga ID yang tidak ada berarti ada objek yang belum ditambahkan. Kolom id adalah yang ditampilkan UI; jika tidak disertakan, nama model digunakan sebagai gantinya.
4. Pesan sistem pertama ditolak atau diabaikan — itu terkait developerMessageSettings. Nilai bawaannya adalah developer, yang merupakan peran berformat OpenAI; contoh Theia sendiri untuk vendor selain OpenAI menetapkan system, dan itulah sebabnya blok di atas juga demikian. user, mergeWithFollowingUserMessage dan skip adalah alternatif yang didokumentasikan.
5. Tidak ada respons sama sekali, di mana pun — periksa Kepercayaan Ruang Kerja. Theia mensyaratkannya untuk setiap fitur AI, dan ruang kerja yang tidak tepercaya menonaktifkan input obrolan serta pelengkapan sebaris dan menampilkan pesan Fitur AI Dibatasi.