OpenCode nedir?
OpenCode, terminalde çalışan ve ayrıca masaüstü, IDE ve sunucu tabanlı iş akışları üzerinden de kullanılabilen açık kaynaklı bir yapay zeka kodlama agent'ıdır. Dosyaları okuyarak, yapıyı açıklayarak, kodu düzenleyerek, değişiklikleri inceleyerek ve bağlı LLM sağlayıcıları aracılığıyla görevler çalıştırarak geliştiricilerin bir kod tabanıyla çalışmasına yardımcı olur. Onu Kimi API gibi bir model sağlayıcısına bağlarsınız ve OpenCode, geliştirme ortamınız içinde planlama, akıl yürütme ve harekete geçme için bu sağlayıcıyı kullanır.
OpenCode ile neler yapabilirsiniz?
Projenizle doğrudan çalışabilen bir yapay zeka kodlama iş akışı istediğinizde OpenCode'u seçebilirsiniz. Örneğin:
Kod yazın, düzenleyin ve yeniden düzenleyin: OpenCode'dan bir özellik eklemesini, mevcut bir dosyayı değiştirmesini, bir fonksiyonu yeniden düzenlemesini veya bir modülün nasıl değiştirilmesi gerektiğini açıklamasını isteyebilirsiniz. En iyi sonuçlar için, ilgili tam dosyaları veya dizinleri belirtin.
Hataları ayıklayın ve testler oluşturun: OpenCode, hata çıktısını inceleyebilir, ilgili dosyaları okuyabilir, düzeltmeler önerebilir ve testler ekleyebilir. Bu, hatanın proje bağlamına bağlı olduğu durumlarda özellikle faydalıdır.
Kod değişikliklerini gözden geçirin: Commit yapmadan önce yerel değişiklikleri incelemek için OpenCode'u kullanabilirsiniz. Muhtemel hataları, eksik testleri, tutarsız kalıpları ve riskli değişiklikleri arayabilir.
Geliştirme iş akışlarını otomatikleştirin: OpenCode ayrıca etkileşimsiz ve sunucu tabanlı iş akışlarını da destekler. Örneğin, komut satırından tek seferlik bir prompt çalıştırabilir veya başsız (headless) bir OpenCode sunucusu başlatıp başka bir istemciyi veya entegrasyonu buna bağlayabilirsiniz.
OpenCode'u Bir LLM API'siyle Yapılandırmak İçin Ön Koşullar
OpenCode'u bir LLM API'siyle yapılandırmadan önce şunları hazırlayın:
macOS, Linux veya (WSL önerilen) Windows üzerinde çalışan bir terminal.
Node.js, Homebrew veya desteklenen başka bir kurulum yöntemi.
Güvenle test edebileceğiniz bir proje klasörü.
Bir model sağlayıcı hesabı.
OpenCode için sağlayıcı kimlik bilgilerinin hassas olduğunu unutmayın. Anahtarınızı herkese açık issue'lara, paylaşılan ekran görüntülerine, kaynak dosyalara veya commit'lenmiş yapılandırmalara yapıştırmayın.
Adım 1: OpenCode'u kurun
Resmi OpenCode dokümanlarındaki en hızlı kurulum yöntemi, kurulum betiğidir. Terminalinizde şunu çalıştırın:
OpenCode ayrıca npm, Homebrew ve başka komutlarla kurulumu da destekler. Masaüstü sürümünü tercih ederseniz cihazınıza uygun sürümü indirebilirsiniz.
Adım 2: OpenCode'u başlatın
OpenCode'un üzerinde çalışmasını istediğiniz projeye gidin:
OpenCode'u başlatın:
Bu, OpenCode'u bu projede ilk kez kullanışınızsa, TUI içinden başlatın:
OpenCode Bir LLM API ile Nasıl Yapılandırılır
Çoğu durumda “OpenCode API” kullanımı, OpenCode'u bir API anahtarı üzerinden harici bir LLM sağlayıcısına bağlamak anlamına gelir. Sağlayıcı modeli sunarken, OpenCode projenizin içindeki kodlama-agent iş akışını yönetir. Aşağıdaki adımlarda sağlayıcı örneği olarak Kimi API kullanılmıştır.
Adım 1: Kimi API anahtarınızı oluşturun
Kimi Açık Platform'u açın. Konsoldan bir API anahtarı oluşturun, ardından bunu bir parola yöneticisinde veya gizli bilgi yöneticisinde saklayın. Konsolunuz tam anahtarı yalnızca bir kez gösteriyorsa, sayfadan ayrılmadan önce anahtarı kopyalayın.
Adım 2: Bir model sağlayıcısına bağlanın
Projenizde OpenCode'u başlatın:
OpenCode arayüzünün içinden şunu çalıştırın:
OpenCode sürümünüzün gösterdiği Moonshot AI veya Kimi uyumlu sağlayıcı girdisini arayın. Resmi OpenCode sağlayıcı dokümanları, Moonshot AI için şu akışı içerir: Moonshot AI konsolunda bir anahtar oluşturun, /connect komutunu çalıştırın, Moonshot AI'yi arayın ve API anahtarını girin.
Sürümünüzde Moonshot AI listelenmiyorsa, OpenCode'u güncelleyin ve model listesini yenileyin:
Adım 3: Kimi API anahtarınızı girin
OpenCode API anahtarını sorduğunda, Kimi API anahtarınızı yapıştırın.
OpenCode, sağlayıcı kimlik bilgilerini yerel auth dosyasında saklar. Resmi sağlayıcı dokümanları bu yolu listeler:
Normalde bu dosyayı elle düzenlemeniz gerekmez. Bunun yerine OpenCode'un sağlayıcı /connect akışını kullanın.
Adım 4: Bir Kimi modeli seçin
Sağlayıcıya bağlandıktan sonra, OpenCode içinden bir model seçin:
Kullanmak istediğiniz Kimi modelini seçin. Yeni kodlama-agent iş akışları için şununla başlayın:
OpenCode'u belirli bir modelle etkileşimsiz olarak çalıştırmanız gerekiyorsa, OpenCode model listenizin gösterdiği sağlayıcı/model biçimini kullanın. Örneğin:
Ardından OpenCode'un yazdırdığı tam model tanımlayıcısını kullanın.
Adım 5: İlk kodlama görevinizi çalıştırın
Sağlayıcının, modelin, proje erişiminin ve izinlerin çalıştığını doğrulayabilmeniz için düşük riskli bir görevle başlayın:
Beklenen sonuç:
Ardından küçük bir kodlama görevi deneyin:
Bu, değişiklik yapmasına izin vermeden önce OpenCode'un projeyi okuyabildiğini ve kod tabanı üzerinde akıl yürütebildiğini doğrular.
OpenCode ile Neden Kimi API Kullanılmalı?
Kimi API, kodlama ve agent iş akışları için OpenAI uyumlu bir model sağlayıcısı istediğinizde OpenCode ile iyi bir uyum sağlar.
Güçlü kod yazma ve akıl yürütme yeteneği
{{KIMI_MODEL_LATEST_FULL}}, uzun soluklu kod yazma, talimat takibi, kendi kendini düzeltme ve agent yürütme için resmi olarak konumlandırılmıştır. Bu da onu çoklu dosya düzenleme, hata ayıklama, yeniden düzenleme (refactoring) ve inceleme gibi OpenCode görevleri için uygun hale getirir.
Daha büyük projeler için uzun bağlam desteği
{{KIMI_MODEL_LATEST_FULL}} için resmi belgeler, {{KIMI_MODEL_LATEST_FULL}} ve çeşitli K2 serisi modeller için uzun bağlam desteği olduğunu belirtir. Bir agent iş akışında, görev birden çok dosyanın okunmasını, uygulama kalıplarının karşılaştırılmasını veya büyük miktarda görev geçmişinin korunmasını gerektirdiğinde uzun bağlam faydalı olabilir.
Daha kolay kurulum için OpenAI uyumlu API
Kimi API, OpenAI API formatıyla uyumludur. OpenAI tarzı sohbet tamamlamalarını (chat completions) zaten destekleyen araçlar için bu genellikle yalnızca API anahtarını, Base URL'yi ve model adını yapılandırmanız gerektiği anlamına gelir.
OpenCode dışında da esnek kullanım
Aynı Kimi API anahtarını diğer OpenAI uyumlu geliştirici araçlarında, doğrudan betiklerde veya dahili iş akışlarında kullanabilirsiniz. Daha sonra OpenCode server veya OpenCode SDK kullanacaksanız, önce Kimi'yi model sağlayıcı olarak yapılandırın.
Bilmeniz Gereken Önemli OpenCode API Ayarları
Bu ayarlar, çoğu OpenCode API ve sağlayıcı kurulum sorununu kontrol eder.
API anahtarı
API anahtarı, isteğinizi model sağlayıcısına karşı doğrular. OpenCode'da bunu genellikle şu şekilde eklersiniz:
Sağlayıcı
Sağlayıcı, OpenCode'a modelin nereden geldiğini bildirir. Bu kılavuzda sağlayıcı Moonshot AI / Kimi API'dir. Diğer sağlayıcılar ayrı olarak yapılandırılabilir, ancak her sağlayıcının kendi kimlik bilgisi ve model listesi olması gerekir.
Base URL
Base URL, doğrudan OpenAI uyumlu API istekleri için kullanılan uç noktadır (endpoint). Kimi API örnekleri için mevcut Kimi API belgelerinde veya hesap konsolunuzda gösterilen uç noktayı kullanın.
Model adı
Model adı sağlayıcıyla tam olarak eşleşmelidir. Küçük bir yazım hatası, model bulunamadı hatasına neden olabilir.
Yaygın örnek:
OpenCode'da sağlayıcı/model tanımlayıcısını şununla doğrulayın:
Yaygın OpenCode API Hatalarının Giderilmesi
Kurulum sorunlarının çoğu şu beş kaynaktan birinden gelir: kimlik bilgileri, uç nokta, sağlayıcı, model adı veya bağlam boyutu.
Kimlik doğrulama başarısız oldu
API anahtarı yanlış yapıştırılmışsa, silinmişse veya döndürülmüşse kimlik doğrulama başarısız olabilir. Yanlış sağlayıcı seçildiğinde veya anahtar, OpenCode'da şu anda yapılandırılmış olandan farklı bir hesaba ya da bölgeye aitse de bu durum ortaya çıkabilir.
Çözüm:
Sağlayıcıyı yeniden bağlayın ve yeni bir API anahtarı yapıştırın. Doğrudan testler için ortam değişkenleri kullanıyorsanız anahtarı sıfırlayın:
Geçersiz uç nokta hatası
Geçersiz bir uç nokta hatası genellikle OpenCode'un doğru sağlayıcı uç noktasına ulaşamadığı anlamına gelir. Yaygın nedenler arasında yanlış yazılmış bir Base URL, araçlar arasında .ai ve .cn uç noktalarının karışık kullanımı veya istekleri sağlayıcıya ulaşmadan önce yeniden yazan bir proxy ya da güvenlik duvarı bulunur.
Çözüm:
Mevcut Kimi API belgelerinizde veya konsolunuzda gösterilen uç noktayı kontrol edin. Doğrudan API testleri için tek bir uç noktayı tutarlı şekilde kullanın:
Model desteklenmiyor
Bu hata; model adı yanlış yazıldığında, seçilen model hesabınız için kullanılamadığında veya OpenCode'un model listesi önbelleği güncel olmadığında ortaya çıkabilir. OpenCode'un kullandığı sağlayıcı/model tanımlayıcısı, sağlayıcı belgelerinde gösterilen ham model adından farklı olduğunda da bu durum yaşanabilir.
Çözüm:
Ardından modeli yeniden seçin:
Hız sınırı aşıldı
Hız sınırı hatası genellikle sağlayıcının çok kısa sürede çok fazla istek aldığı anlamına gelir. Aynı anda birden fazla agent görevi çalışıyorsa veya bir betik ya da entegrasyon başarısız istekleri çok agresif bir şekilde yeniden deniyorsa bu durum ortaya çıkabilir.
Çözüm:
Görevi duraklatın, paralel çalıştırma sayısını azaltın ve sağlayıcı konsolunuzdan kota veya faturalandırma durumunu kontrol edin. OpenCode veya doğrudan Kimi API çağrıları etrafında sonsuz yeniden deneme döngüleri yazmaktan kaçının.
Bağlam penceresi taşması
Bağlam penceresi taşması genellikle görevin modelin tek seferde işleyebileceğinden daha büyük olduğu anlamına gelir. Çok fazla dosya dahil edilmişse, OpenCode'dan tüm depoyu (repository) incelemesi istenmişse veya uzun bir oturum çok fazla konuşma geçmişi biriktirmişse bu durum ortaya çıkabilir.
Çözüm:
OpenCode'dan daha küçük bir kapsamda çalışmasını isteyin:
Daha dar kapsamlı bir görev için yeni bir oturum da başlatabilirsiniz.
Sonuç
OpenCode, kod tabanınızı model sağlayıcılarına bağlayabilir ve terminalden kodlama görevleri çalıştırabilir. Kimi API, OpenAI uyumlu bir kurulum üzerinden bu iş akışları için model altyapısını sağlayabilir. Pratik bir kodlama agent iş akışı istiyorsanız Kimi API anahtarınızı oluşturun, OpenCode'da Moonshot AI'yi bağlayın, bir Kimi modeli seçin ve kurulumu doğrulamak için küçük bir proje görevi çalıştırın.
SSS
/connect üzerinden girin. OpenCode, sağlayıcı kimlik bilgilerini yerel olarak saklar ve resmi dokümantasyon ~/.local/share/opencode/auth.json yolunu kimlik bilgisi dosyası konumu olarak belirtir.opencode models komutunu çalıştırın. Kimi API için, hesabınızda kullanılabilir olduğunda kimi-k2.6 gibi OpenCode model listenizde görünen tam Kimi model tanımlayıcısını seçin./connect.