Theia IDE

ai-features.openAiCustom.customOpenAiModels içindeki tek bir girdi — model, url ve apiKey — Kunavo'yu Theia Coder, Architect ve satır içi tamamlamanın arkasına koyar.

{
  "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"
    }
  ]
}

Adım adım

1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
2. Özelliği etkinleştirin: Theia'nın belgeleri, Preferences bölümüne gidip “AI-features => AI Enable” ayarını etkinleştirmenizi söyler. Bu yapılana kadar aşağıdakilerin hiçbiri görünmez.
3. AI Configuration görünümünü açın: Alt+A ya da sol alttaki Manage (dişli) menüsünde, Settings'in hemen altında bulunan AI Configuration seçeneğini kullanın. Kategoriler şunlardır: General, Providers & Models, Model Aliases, Agents, Prompts & Skills, Variables, Tools, Token Usage ve MCP Servers.
4. Yukarıdaki girdileri ekleyin. Belgeler bunu, OpenAI Compatible Models için ayarlar bölümündeki bağlantıya tıklamak olarak açıklar — tercih, yapılandırılmış bir listedir ve Theia, özel bir düzenleyicisi olmayan yapılandırılmış ayarların “settings.json” olduğunu belirtir; ulaşacağınız dosya budur. Her model kimliği için bir nesne kullanın; url ve apiKey tekrar eder.
5. Bir şeyi buna yönlendirin. Agents altında her ajanın bir Language Model seçicisi vardır; birçok ajan bunun yerine bir model takma adını çözümler. Bu nedenle default/code, default/universal, default/code-completion, default/summarize ve default/fast değerlerini Model Aliases altında ayarlamak, birkaç ajanı aynı anda taşır.
6. Theia Coder'a bir sohbet mesajı gönderin ve ardından bir dosyaya dokunan bir şey isteyin. Bu IDE'deki ajanlar araç çağrılarına ve çalışma alanı içeriğine dayanır; bu nedenle bir şeyi okuyan veya düzenleyen ilk çalıştırma, bir selamlamadan daha fazla bilgi verir — aynı görünümdeki Token Usage bölümü de turun size token cinsinden maliyetini gösterir.

Theia IDE'nin AI özellikleri sayfası, OpenAI Compatible Models bölümü ile 21 Eylül 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar Theia IDE içinde çalışır.

# 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-..."

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Theia'nın bu sağlayıcı için iddiası

Theia'nın kendi sayfasındaki LLM Providers Overview tablosu, her sağlayıcıyı üç eksende değerlendirir. Bu, yukarıdaki tarihte söz konusu tablodan kopyalanan Theia'nın Theia hakkındaki iddiasıdır — bir Kunavo test sonucu değildir ve bu tabloda burada yazılan tek bölüm, “What that needs from the model id” başlıklı sütundur.

Theia, bu tablonun iki paragraf üstünde kendi çekincesini ekler; bu, tüm sayfanın dürüst çerçevesi olduğu için tekrarlamaya değerdir: tüm modeller “kutudan çıktığı hâliyle çalışmayabilir; belirli özelleştirmeler veya optimizasyonlar gerektirebilir”.

Gerçekte para maliyeti oluşturanlar

Theia IDE açık kaynaklıdır ve indirmesi ücretsizdir; AI özelliklerinin kendisi ücretli değildir — para maliyeti oluşturan, apiKey anahtarını elinde bulunduran tarafça faturalandırılan model çağrılarıdır. Belgelerde yer alan iki ayar, bu faturayı model seçiminden daha fazla etkiler ve ikisi de şunlardır:

1. Automatic Code Completion varsayılan olarak açıktır ve belgeler bunu “kod yazarken temel LLM'ye sürekli istekler göndermek” olarak açıklar. Günde binlerce kez çalışan ajan budur. default/code-completion değerini ucuz bir kimliğe sabitleyin veya 'AIFeatures'=>'CodeCompletion' bölümünde ajanı manuel moda geçirip Ctrl+Alt+Space ile tetikleyin.
2. Aynı ayar grubundaki Max Context Lines, çevredeki dosyanın ne kadarının her tamamlama isteğine ekleneceğini sınırlar. Bu içeriğin her satırı, tuş vuruşuyla tetiklenen her çağrıda girdi olarak faturalandırılır.

Sohbet ajanları bunun tam tersidir: daha az çağrı, çok daha büyük bağlam ve aynı çalışma alanı dosyalarının turdan tura yeniden gönderilmesi. İstem önbelleğe almanın amacı budur — bkz. /docs/caching — ve yukarıdaki model tablosunun iki yarısının, ajanın ne kadar akıllı olduğuna göre değil, ne sıklıkta çalıştığına göre ayrılmasının nedeni budur.

Bağlanmadığında

1. 404 — url. Kunavo /v1/chat/completions sunar; bu nedenle alan /v1 kökünü ister. Yalın bir kaynak veya tam bir .../chat/completions ikisi de hedefi bulamaz.
2. 401 — anahtar. Theia'nın Readme dosyası, apiKey değerinin “yetkilendirme isteğinde Bearer Token olarak gönderileceğini” belirtir; bu, bir sk-kn- anahtarının beklediği şeydir. Belgelenmiş varsayılanı unutmayın: hiç apiKey olmadığında Theia no-key gönderir; bu nedenle eksik bir alan, eksik bir anahtar yerine reddedilmiş bir anahtar gibi görünür. (true, “global OpenAI API anahtarını kullan” anlamına gelir — burada istediğiniz şey bu değildir.)
3. Model kimliği seçicide yok — bu liste uç noktadan değil, kendi customOpenAiModels girdilerinizden gelir; dolayısıyla eksik kimlik, eksik bir nesne anlamına gelir. Arayüzün gösterdiği alan id alanıdır; bunu çıkarırsanız model adı kullanılır.
4. İlk sistem mesajı reddediliyor veya yok sayılıyor — bunun nedeni developerMessageSettings. Varsayılanı developer değeridir; bu, OpenAI biçimli bir roldür. Theia'nın OpenAI dışı bir satıcı için verdiği kendi örneğinde system ayarlanır; yukarıdaki blokta bunun yapılmasının nedeni budur. user, mergeWithFollowingUserMessage ve skip belgelenmiş alternatiflerdir.
5. Hiçbir yerde hiçbir şey yanıt vermiyor — Workspace Trust ayarını kontrol edin. Theia her AI özelliğini bunun arkasında sınırlar; güvenilmeyen bir çalışma alanı sohbet girişini ve satır içi tamamlamayı devre dışı bırakır ve AI Features are Restricted mesajını gösterir.