Dokümantasyon

Dokümantasyon

Open Interpreter

Open Interpreter, sağlayıcıları Codex'in önceki sürümünde olduğu gibi bir TOML tablosundan okur; ancak upstream Codex'in kaldırdığı Sohbet Tamamlama aktarımını korumuştur. Tek bir [model_providers.kunavo] bloğuyla aracı, anahtarın erişebildiği tüm modellerde çalıştırabilirsiniz.

~/.openinterpreter/config.toml içinde tek bir [model_providers.kunavo] tablosu — base_url, env_key, wire_api = "chat" — Rust terminal aracısını anahtarın eriştiği herhangi bir modelde çalıştırır.

~/.openinterpreter/config.toml
model_provider = "kunavo"
model = "claude-sonnet-5"

[model_providers.kunavo]
name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key = "KUNAVO_API_KEY"     # the NAME of the variable, not the key
wire_api = "chat"
Temel URL, chat protokolünde /v1 son ekini korur. Open Interpreter belgeleri bunu açıkça bir kural olarak belirtmek yerine örneklerle ortaya koyuyor: sağlayıcılar sayfasındaki özel sağlayıcı bloğunda base_url = "https://api.example.com/v1", yapılandırma sayfasındakinde "https://api.acme.example/v1" kullanılıyor ve adını vererek belgeledikleri barındırılan ağ geçidi "https://app.nz/v1" kullanıyor. Son eki kaldırırsanız kimlik doğrulama hatası değil, 404 alırsınız.
Kunavo, bu istemciyi kendi uç noktasına karşı çalıştırmadı; bu sayfalarda yer alan diğer istemcilerden hiçbirini de çalıştırmadı. Kontrol edilen şey yapılandırma arayüzüdür: aşağıdaki anahtarlar, bu sayfanın altındaki tarihte incelenen Open Interpreter'ın kendi belgelerinde yazanlardır; temel URL ve model kimlikleri ise Kunavo'ya aittir. Yayımlanmış bir kurulum sayfası, bir test çalıştırması değildir. Çalıştığını gösteren şey olarak doğrulama isteğini kabul edin.
"Open Interpreter" adıyla anılan iki farklı program var ve bu blok Rust sürümü içindir. 0.4.3 sürümünde dondurulmuş Python paketi, --api_base, --api_key ve --model openai/<id> üzerinden ya da Python'da interpreter.llm aracılığıyla yapılandırılır. Bunların hiçbiri yalnızca yukarıdaki TOML tablosunu okuyan mevcut terminal aracısında yoktur. Herhangi bir şeyi düzenlemeden önce interpreter --version çalıştırın — eski bir öğreticideki pip install open-interpreter, aynı ad için yarışan ikinci bir ikili dosya bırakır.
Bir Claude model kimliği, Open Interpreter'ın claude-code düzenini kendiliğinden seçmesine neden olur; belgelenmiş varsayılanları bunu "Anthropic, Claude model kimlikleri, Anthropic temel URL'si veya herhangi bir messages sağlayıcısı" için seçer. Burada bu eşleşme geçerlidir: yönlendirme tablosu, claude-code modelinin wire_api = "chat" ile uyumlu olduğunu belirtir. Farklı bir düzen istiyorsanız harness değerini açıkça ayarlayın; açıkça belirtilen değer her zaman önceliklidir. Tanınmayan bir değer ise hata vermek yerine yerleşik istek oluşturucusu olmayan chat düzenine geri döner.
Henüz anahtarınız yok mu? Bir Kunavo hesabı oluşturun, bir anahtar oluşturun ( sk-kn- ile başlar) ve $10'dan kredi ekleyin — çağrılar bu bakiyeden ödenir ve başarısız çağrılar ücretlendirilmez. Ardından kontrol paneli Open Interpreter kurulumunda açılır.

Adım adım

  1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
  2. env_key içine yazacağınız adla dışa aktarın: export KUNAVO_API_KEY=sk-kn-.... Bu alan değişkenin değerini değil, adını tutar; belgelerde env_key, "bir bearer token'ı ortam değişkeninden okuyan" kaynak olarak listelenir.
  3. Yukarıdaki bloğu ~/.openinterpreter/config.toml içine ya da yalnızca tek bir depoda geçerli olmasını istediğinizde güvenilir bir projedeki .openinterpreter/config.toml içine ekleyin. Proje yapılandırması kullanıcı yapılandırmasına göre önceliklidir; -c key=value bayrağı ise o çalıştırma için her ikisinin de önüne geçer.
  4. interpreter başlatın ve /model çalıştırın. Seçici önce etkin sağlayıcının models rotasına istek gönderir; Kunavo GET /v1/models yanıtını verdiği için liste kendiliğinden dolar.
  5. Yanlış değerler kullanımdaysa /debug-config çalıştırın — etkin yapılandırmayı ve her değerin kaynağını yazdırır; böylece eski bir profili veya proje dosyasını yeniden okumaktan daha hızlı sonuç alırsınız.

Open Interpreter'ın Model Sağlayıcıları sayfası 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.

Kısa sürüm budur. Model seçimi, gerçek bir oturumun maliyeti ve hata durumlarını içeren tam rehber Open Interpreter sürüm farkı, fiyatlandırma ve alternatifler içindedir.

İ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 Open Interpreter 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ış.

Model kimliğiKunavo giriş / çıkışOpen Interpreter içinde kullanım alanı
claude-sonnet-5$1.40 / $7.00düzenleme ve çalıştırma döngüleri için varsayılan çalışma modeli
claude-opus-5$3.50 / $17.50yanlış bir planın maliyetli olduğu büyük bir yeniden düzenleme planlanırken
claude-haiku-4-5$0.70 / $3.50tur sayısının belirleyici olduğu, kabuk komutlarının yoğun kullanıldığı oturumlar
gpt-5-6-sol$2.00 / $12.00aynı anahtarla, farklı bir aileden ikinci bir görüş
Faturalandırma aylık ücret olmadan, ön ödemeli bakiyeden token başına yapılır — faturalandırmaya bakın. Tekrarlanan bağlamda — bir düzenleyicinin veya sohbet istemcisinin gönderdiği içeriğin çoğu budur — istem önbellekleme, faturayı model seçiminden daha fazla değiştirir.

Sık sorulan sorular

Open Interpreter'ı özel bir API sağlayıcısına nasıl yönlendirebilirim?

~/.openinterpreter/config.toml dosyasına name, base_url, env_key ve wire_api alanlarını içeren bir [model_providers.<id>] tablosu ekleyin; ardından üst düzey model_provider anahtarıyla sağlayıcıyı seçin ve model ile model adını belirtin. OpenAI uyumlu bir uç nokta için wire_api = "chat" kullanın ve /v1 ile biten bir temel URL belirleyin — Open Interpreter'ın kendi sağlayıcılar sayfasında özel bir sağlayıcı ve adını vererek belgelediği barındırılan ağ geçidi için gösterilen yapı budur. env_key, bir ortam değişkeninin adını tutar; bu nedenle anahtarı dosyaya yapıştırmak yerine dışa aktarın.

Open Interpreter base_url değerinin sonuna /v1 eklemek gerekir mi?

Chat protokolünde evet. Belgeler, yol oluşturma kuralını metinle açıklamıyor; ancak yayımlanan tüm özel sağlayıcı örneklerinde bu son ek var: sağlayıcılar sayfasında https://api.example.com/v1, yapılandırma sayfasında https://api.acme.example/v1 ve adı verilen ağ geçidi için https://app.nz/v1. Messages protokolü farklı çalışır — istemciyle birlikte gelen Anthropic tarzı sağlayıcılar /v1 içermeyen bir API kök dizini kullanır — dolayısıyla /v1 yanıtı wire_api = "chat" ve wire_api = "responses" için geçerlidir.

Eski --api_base ve --model openai/... bayrakları hâlâ çalışıyor mu?

Hayır. Bunlar LiteLLM üzerinden yönlendirme yapan ve bu nedenle openai/ ön ekini gerektiren, 0.4.3 sürümünde dondurulmuş Python paketine aittir. Mevcut terminal aracısı, ne bu bayraklara ne de bu ön ek kuralına sahip olmayan bir Rust Codex çatalıdır: ~/.openinterpreter/config.toml veya proje düzeyindeki .openinterpreter/config.toml dosyasından bir TOML sağlayıcı tablosu okur ve sağlayıcıyı model_provider, modeli ise model ile seçer. Yapılandırma sıfırdan yazılmıştır ve docs.openinterpreter.com, Rust belgelerine yönlendirir; bu nedenle eski bir öğreticinin bağlantıları hâlâ açılsa da yüklü olmayan bir programı anlatır.

Özel sağlayıcı için /model seçicisinde neden bağlam penceresi görünmüyor?

Çünkü bu üst veriler, models.dev ile bir avuç canlı sağlayıcı uç noktasından oluşturulan ve istemciyle birlikte gelen katalogdan alınır. Yalnızca bir sağlayıcı Anthropic kimliği, temel URL, sağlayıcı adı veya kimlik doğrulama ortam değişkeni üzerinden bir katalog girdisiyle eşleştiğinde bu veriler eklenir. Kunavo bu oluşturulan katalogda yer almıyor — 21 Eylül 2026 tarihinde depodaki dosya kontrol edildi — bu nedenle elle yazılmış bir sağlayıcı model listesini uç noktanın kendi models rotasından alır ve başka bilgi edinmez. Modeller yine çalışır; yalnızca seçicide yanlarında gösterilecek bilgi daha az olur.

Open Interpreter, Anthropic hesabı olmadan Claude modeline erişebilir mi?

Evet; çünkü wire_api bir satıcıyı değil, aktarım biçimini belirtir. wire_api = "chat" olduğunda model kimliği yapılandırdığınız base_url değerine iletilir ve orada çözümlenir; dolayısıyla kullandığınız kimlik bilgisi uç noktanın kimlik bilgisidir. Open Interpreter yine de Claude model kimliğinden hareketle claude-code düzenini otomatik seçer ve bu düzen chat protokolüyle uyumlu olarak listelenmiştir; yani bu eşleşme bir geçici çözüm değil, belgelenmiş bir kullanımdır.