OpenCode'u Mac ve Windows'a Kolayca Kurun

Kurulum hataları süreci kesintiye uğrattığında veya araç beklendiği gibi çalışmadığında OpenCode kurmak bazen kafa karıştırıcı olabilir. Eksik komutlardan Node.js uyumluluk sorunlarına kadar kullanıcılar genellikle ilk kurulumda zorlanır. OpenCode kurulumuna dair bu rehber, Desktop veya CLI/TUI kullanıp kullanmadığınıza bakılmaksızın, yaygın hataları düzeltmek ve OpenCode'u Mac ve Windows'ta başarıyla kurmak için eksiksiz bir çözüm sunar; böylece gecikmeden kodlamaya başlayabilirsiniz.

OpenCode nedir?

OpenCode, geliştiricilerin terminal, IDE veya masaüstü uygulaması olsun tercih ettikleri ortamdan doğrudan kod yazmasına, düzenlemesine, hata ayıklamasına ve kodu yönetmesine yardımcı olmak için tasarlanmış açık kaynaklı bir yapay zeka kodlama agent'ıdır. Ağırlıklı olarak kod önerilerine odaklanan geleneksel yapay zeka kodlama asistanlarının aksine OpenCode, tüm bir kod tabanını anlayabilir, dosyaları değiştirebilir, komutlar çalıştırabilir ve geliştirme iş akışlarını otomatikleştirebilir. Ayrıca birden fazla yapay zeka modelini ve yerel modelleri destekler, bu da geliştiricilere yazılım geliştirme yöntemleri üzerinde daha fazla esneklik ve kontrol sağlar.

OpenCode kurulumu için ön koşullar

OpenCode'u kurmadan önce sisteminizin temel gereksinimleri karşıladığından emin olun. Kesin ön koşullar, masaüstü uygulamasını mı yoksa terminal tabanlı arayüzü mü kullanmayı planladığınıza bağlıdır; ancak doğru kurulumun sağlanması sorunsuz bir kurulum sürecine yardımcı olur.

Masaüstü için

İşletim Sistemi: macOS / Windows / Linux

OpenCode, başlıca işletim sistemleri için masaüstü uygulamaları sunar ve geliştiricilerin aracı tercih ettikleri ortamda kurup kullanmasına olanak tanır. Sisteminizin macOS (Apple Silicon veya Intel), Windows (x64) veya Linux (.deb, .rpm) gibi uyumlu bir işletim sistemi kullandığından emin olun.

Uygulama kurma izni: Cihazınıza yazılım indirmek ve kurmak için yönetici veya sistem düzeyinde izinlere ihtiyacınız olabilir. Bu, kurulum haklarının sınırlandırılabildiği iş yerlerinde veya yönetilen BT ortamlarında özellikle önemlidir.

Kararlı internet bağlantısı: OpenCode'u indirmek, güncellemeleri kurmak ve kurulum ile kullanım sırasında desteklenen yapay zeka modelleri ile hizmetlere bağlanmak için sorunsuz bir internet bağlantısı gerekir.

Terminal/TUI için

Terminal erişimi: OpenCode doğrudan komut satırından kurulabilir ve kullanılabilir. macOS'ta Terminal, Windows'ta Komut İstemi veya PowerShell ya da bir Linux shell'i gibi bir terminal uygulamasına erişiminiz olduğundan emin olun.

Tek bir kurulum yöntemi: OpenCode, farklı işletim sistemlerine ve geliştirici tercihlerine uyum sağlamak için birden fazla kurulum yöntemini destekler. Ortamınıza en uygun paket yöneticisini veya kurulum aracını seçin; örneğin npm, curl, brew, Scoop, Chocolatey veya WSL.

Temel komut satırı bilgisi: Yaygın terminal komutlarına aşinalık, kurulumu ve günlük kullanımı çok daha kolay hale getirebilir. İleri düzey uzmanlık gerekmez, ancak temel gezinme ve komut çalıştırmayı anlamak önerilir.

OpenCode Desktop nasıl kurulur?

OpenCode Desktop'ı kurmak, uygulamayı çalışır hale getirmek için yalnızca birkaç basit adım gerektiren kolay bir işlemdir. İzlemeniz gereken adımlar şunlardır.

Adım 1: OpenCode Desktop'ı İndirin

Resmi OpenCode indirme sayfasına gidin ve uygulamanın Windows veya macOS sürümünü seçin. Yükleyici otomatik olarak sisteminize indirilecektir. Güvenlik ve doğruluk açısından dosyayı resmi kaynaktan indirdiğinizden emin olun.

Adım 2: Yükleyiciyi çalıştırın

İndirilen yükleyici dosyasını bulun ve kurulumu başlatmak için üzerine çift tıklayın. Kurulumu tamamlamak için ekrandaki talimatları izleyin.

Adım 3: Kurulumu tamamlayın

Kurulum sırasında karşınıza çıkan istemleri takip edin ve sorulduğunda tercih ettiğiniz kurulum dizinini seçin. Ardından yükleyicinin sisteminizde kurulum sürecini tamamlamasına izin verin.

Adım 4: OpenCode Desktop'ı başlatın

Kurulum tamamlandıktan sonra, Başlat Menüsü'nden veya masaüstü kısayolundan OpenCode Desktop'ı açın. Ardından çalışmaya başlamak için yeni bir proje başlatın ya da mevcut bir klasörü açın. Çalışma alanınız yüklendikten sonra, kod oluşturmak, hataları ayıklamak veya projenizin içinde doğrudan özellikler geliştirmek için AI asistanıyla etkileşime geçebilirsiniz.

Mac'te OpenCode Terminal/TUI Nasıl Kurulur?

Mac'te OpenCode Terminal (TUI), resmi paket yöneticileri veya tek satırlık bir kurulum komutu kullanılarak doğrudan kurulabilir. Grafik arayüz yerine terminal içinde çalışmayı tercih eden geliştiriciler için tasarlanmıştır. Mac'te OpenCode TUI'yi kurmak için bu adımları izleyin.

Adım 1: Bir OpenCode Terminal kurulum yöntemi seçin

Resmi OpenCode indirme sayfasını ziyaret edin ve OpenCode Terminal bölümüne gidin. Burada curl, Homebrew, npm ve bun dahil birden fazla kurulum seçeneği bulacaksınız. Geliştirme ortamınıza en uygun yöntemi seçin ve ilgili kurulum komutunu kopyalayın.

Adım 2: Mac'te Terminal uygulamasını açın

Mac'inizde Terminal uygulamasını başlatın. Uygulamalar > Yardımcı Programlar > Terminal yolundan açabilir veya Spotlight Arama ile hızlıca bulabilirsiniz. OpenCode kurulum komutunu burada çalıştıracaksınız.

Adım 3: OpenCode Terminal'i kurun

Aşağıdaki kurulum komutunu Terminal'e yapıştırın ve Enter tuşuna basın:

Kurulumun tamamlanmasını bekleyin. OpenCode gerekli dosyaları indirip CLI'yi otomatik olarak kuracaktır.

Adım 4: OpenCode Terminal Arayüzünü başlatın

Kurulum tamamlandıktan sonra, Terminal Kullanıcı Arayüzünü (TUI) başlatmak için Terminal'de opencode komutunu çalıştırın. Etkileşimli arayüz doğrudan terminal pencerenizde açılır ve bir AI sağlayıcısına bağlanmanıza, ayarları yapılandırmanıza ve OpenCode ile çalışmaya başlamanıza olanak tanır.

Windows'ta OpenCode Terminal/TUI Nasıl Kurulur?

OpenCode, Windows'ta WSL, npm ve bun dahil çeşitli kurulum yöntemlerini destekler. En iyi uyumluluk ve deneyim için resmi belgeler Windows Subsystem for Linux (WSL) kullanılmasını önerir. Aşağıdaki adımlar WSL kurulum yöntemini kullanır. WSL'i zaten kurduysanız ilk adımı atlayabilirsiniz.

Adım 1: WSL'i kurun (Önerilir)

PowerShell'i Yönetici olarak açın, ardından şu komutu çalıştırın:

Bu komut Windows Subsystem for Linux'u (WSL) etkinleştirir ve varsayılan olarak Ubuntu'yu kurar. Kurulum tamamlandıktan sonra bilgisayarınızı yeniden başlatın. Ubuntu'yu ilk kez açtığınızda, Windows Linux ortamının kurulumunu otomatik olarak tamamlayacaktır.

Adım 2: WSL'i açın ve OpenCode'u kurun

Windows Başlat menüsünden WSL terminalinizi (örneğin Ubuntu) başlatın. Bu ilk açışınızsa, ilk kurulumu tamamlayın. Ardından OpenCode'u kurmak için şu komutu çalıştırın:

Devam etmeden önce kurulumun tamamlanmasını bekleyin.

Adım 3: Kurulumu doğrulayın

Kurulum tamamlandıktan sonra şu komutu çalıştırın:

OpenCode Terminal/TUI başarıyla başlatılırsa kurulum tamamlanmış demektir ve OpenCode'u AI destekli kodlama için kullanmaya başlayabilirsiniz.

OpenCode'a harici API'ler nasıl entegre edilir?

OpenCode'un en önemli avantajlarından biri, API entegrasyonları aracılığıyla harici yapay zeka model sağlayıcılarına bağlanabilmesidir. Kendi API anahtarınızı ekleyerek farklı dil modellerine erişebilir ve kodlama iş akışınıza en uygun olanı seçebilirsiniz.

Harici API'leri OpenCode'a entegre etme (Genel adımlar)

Harici API'leri OpenCode'a entegre etmek için izlemeniz gereken adımlar aşağıdadır:imi

Adım 1: Hesap oluşturun ve bir API anahtarı üretin

Öncelikle Kimi veya desteklenen başka bir hizmet gibi tercih ettiğiniz yapay zeka sağlayıcısında bir hesap oluşturun. Hesabınız oluşturulduktan sonra sağlayıcının API anahtarı yönetim sayfasına gidin ve yeni bir API anahtarı oluşturun. Bu anahtarı güvende tutun; sağlayıcıyı OpenCode'a bağlarken buna ihtiyacınız olacak.

Adım 2: Sağlayıcı bağlantı menüsünü açın

OpenCode'u başlatın ve çalışma alanınızı açın. Komut arayüzünde şu komutu çalıştırın:

Bu komut, harici yapay zeka hizmetlerini ekleyip yönetebileceğiniz sağlayıcı bağlantı menüsünü açar.

Adım 3: API anahtarınızı ekleyin

Mevcut seçenekler listesinden kullanmak istediğiniz sağlayıcıyı seçin. İstendiğinde, daha önce oluşturduğunuz API anahtarını yapıştırın ve bağlantıyı onaylayın. OpenCode, anahtarı güvenli bir şekilde saklayacak ve seçilen sağlayıcıya yapılan istekleri doğrulamak için kullanacaktır.

Adım 4: Kullanılabilir modelleri görüntüleyin

Sağlayıcınızı bağladıktan sonra, o API üzerinden kullanılabilecek tüm modelleri görmek için şu komutu çalıştırın:

OpenCode, desteklenen modellerin adları ve yapılandırma seçenekleriyle birlikte bir listesini görüntüler.

Adım 5: Bir model seçin ve kullanmaya başlayın

Mevcut listeden çalışmak istediğiniz modeli seçin. Seçim yapıldıktan sonra OpenCode, isteklerinizi bu model üzerinden yönlendirir; böylece bağlı API'yi kullanarak kod üretebilir, uygulamalarda hata ayıklayabilir ve diğer geliştirme görevlerini gerçekleştirebilirsiniz. İhtiyaçlarınız değiştiğinde daha sonra modeli değiştirebilirsiniz.

Kimi API'lerini OpenCode'a entegre etme

OpenCode, geliştiricilerin API anahtarları kullanarak harici modellere bağlanmasına olanak tanıyan birden fazla yapay zeka sağlayıcısını destekler ve bu da daha fazla esneklik sunar. En güçlü seçeneklerden biri Kimi API'sidir.

Moonshot AI Açık Platformu tarafından sunulan Kimi API, OpenAI uyumlu bir arayüz üzerinden gelişmiş Kimi dil modellerine erişim sağlar. Güvenli bir API anahtarı kullanılarak kodlama araçlarına, uygulamalara ve yapay zeka destekli iş akışlarına kolayca entegre edilebilir. Platform, kodlama, akıl yürütme ve uzun bağlam anlama görevleri için optimize edilmiş çeşitli Kimi modelleri içerir.

Kimi API'lerini OpenCode'a entegre etmek için şu adımları izleyin.

Adım 1: Bir Moonshot AI hesabı oluşturun ve bir API anahtarı üretin

1. Kimi AI Açık Platformu'nu ziyaret edin ve hesabınıza giriş yapın.

2. Kontrol panelinden API Keys bölümüne gidin ve Create API Key üzerine tıklayın.

3. Anahtar oluşturulduktan sonra (sk- ile başlar), hemen kopyalayın ve güvenli bir şekilde saklayın. Anahtar yalnızca bir kez gösterilir ve OpenCode ile Moonshot AI arasındaki istekleri doğrulamak için kullanılır.

Adım 2: Moonshot AI'yi OpenCode'a bağlayın

OpenCode çalışma alanınızı açın ve şunu çalıştırın:

Sağlayıcı bağlantı menüsü görüntülenecektir. Yerleşik sağlayıcılar listesinden Moonshot AI'yi (veya Kimi'yi) arayıp seçin. OpenCode, API anahtarınızı girmenizi isteyecektir.

İstendiğinde, Moonshot AI konsolundan oluşturduğunuz API anahtarını yapıştırın ve Enter tuşuna basın:

Doğrulama tamamlandığında OpenCode, kimlik bilgisini ~/.local/share/opencode/auth.json dosyasına güvenli bir şekilde kaydedecek ve Moonshot AI sağlayıcı yapılandırmanızla ilişkilendirecektir.

Not: OpenCode, güvenlik nedeniyle API anahtarlarını ana yapılandırma dosyasından ayrı olarak saklar. /connect komutu kimlik bilgisi saklamayı yönetirken, sağlayıcı davranışı opencode.json dosyasında yapılandırılır.

Adım 3: Sağlayıcıyı opencode.json içinde yapılandırın (gerekirse)

Bağlantı kurduktan sonra No endpoints found hatasıyla karşılaşırsanız veya sağlayıcı kurulumunu özelleştirmeniz gerekiyorsa, Moonshot AI yapılandırmasını opencode.json dosyanıza ekleyin:

Dosyayı kaydedin ve değişiklikleri uygulamak için OpenCode'u yeniden başlatın.

Adım 4: Kullanılabilir Kimi modellerini görüntüleyin

Sağlayıcıyı bağladıktan sonra şunu çalıştırın:

OpenCode, Moonshot AI hesabınız üzerinden kullanılabilen tüm modelleri görüntüler, örneğin:

Adım 5: Bir Kimi modeli seçin ve kodlamaya başlayın

moonshotai/kimi-k2.6 modelini seçin ve etkin model olarak ayarlayın. Seçim yapıldıktan sonra OpenCode, kod üretimi, hata ayıklama, yeniden düzenleme ve diğer yapay zeka destekli geliştirme görevleri için seçilen Kimi modelini kullanır.

Aynı model seçim menüsü üzerinden istediğiniz zaman farklı bir modele geçebilirsiniz.

İpucu: Agent/Araç modunda sorun yaşarsanız (örneğin JSON Schema doğrulama hataları), bu Moonshot AI'nin katı şema gereksinimleri ile OpenCode'un araç parametre biçimi arasında bilinen bir uyumluluk sorunudur. En iyi kararlılık için Sohbet modunu kullanmayı veya sıcaklık uyumluluğunu otomatik olarak ele almak için opencode-moonshot-compatibility eklentisini yüklemeyi düşünebilirsiniz.

Kimi API kullanmanın avantajları

Kimi API, ekiplerin fikirlerden uygulamaya daha verimli bir şekilde geçmesine yardımcı olarak modern geliştirme iş akışlarını desteklemek üzere tasarlanmıştır. Kod üretiminin ötesinde, farklı türde girdileri anlayabilir, proje gereksinimlerine uyum sağlayabilir ve rutin mühendislik görevlerini otomatikleştirebilir. İşte başlıca avantajlarından bazıları:

• Çok modlu girdileri çalışan uygulamalara dönüştürme

Kimi API, tasarım mockup'ları, mimari diyagramlar, akış şemaları ve videolar dahil olmak üzere birden fazla formattaki bilgileri yorumlayabilir. Proje gereksinimlerini anlamak ve bunları teknik şartnamelere veya çalışan koda dönüştürmek için bu bağlamı kullanır. Sonuç olarak, ekipler kavramdan uygulamaya daha az manuel dönüştürme adımıyla geçebilir.

• Uzun soluklu kodlama ve karmaşık mühendislik görevlerini yönetme

Kimi API, OpenCode'un planlama, tutarlılık ve iyileştirme gerektiren daha büyük kodlama görevlerini yönetmesine yardımcı olur. Özellik geliştirme, kodu yeniden düzenleme ve karmaşık mühendislik problemlerini çözme konusunda faydalıdır.

• Çok adımlı araç çağrılarıyla problemleri mantıksal olarak çözme

Kimi API, çok adımlı görevleri mantıksal olarak çözebilir ve gerektiğinde araçları çağırabilir. Bu, hata ayıklama, kod analizi ve tek bir yanıtla tamamlanamayan iş akışlarında yardımcı olur.

OpenCode kurulumunda sorunlar nasıl çözülür？

OpenCode'un kurulumu genellikle basittir, ancak kullanıcılar ortam uyumsuzlukları, bağımlılıklar veya yapılandırma sorunları nedeniyle yaygın kurulum hatalarıyla karşılaşabilir. Aşağıda, en sık görülen kurulum sorunlarını hızlı ve etkili bir şekilde çözmenize yardımcı olacak açık ve pratik bir kılavuz bulunmaktadır.

• Command not found: opencode

Bu hatayı görüyorsanız, sistem PATH içinde OpenCode çalıştırılabilir dosyasını bulamıyor demektir. Bu genellikle kurulum eksik olduğunda veya ortam değişkenleri doğru ayarlanmadığında ortaya çıkar.

Bunu düzeltmek için önce kurulumu doğrulayın ve ikili dosya dizininin sistem PATH'inize eklendiğinden emin olun. npm ile kurduysanız, global npm bin yolunuzu kontrol edin ve shell yapılandırmanızı buna göre güncelleyin. Düzeltmelerden sonra terminali yeniden başlatmak genellikle sorunu çözer.

• Node.js sürümü çok eski

OpenCode, Node.js 18 veya üzerini gerektirir; daha eski sürümler kurulum veya çalışma zamanı hatasına neden olur.

Bunu çözmek için node --version komutuyla mevcut sürümünüzü kontrol edin. Sürüm eskiyse, nvm gibi bir sürüm yöneticisi kullanarak Node.js'i yükseltin. Yükselttikten sonra, güncellenmiş çalışma zamanı ortamıyla uyumluluğu sağlamak için OpenCode'u yeniden kurun.

• npm izin hataları

İzin hataları genellikle npm, uygun yazma erişimi olmadan global paketleri kurmaya çalıştığında ortaya çıkar.

sudo kullanmak yerine, ana dizininizde özel bir npm global dizini yapılandırın ve PATH ayarlarını güncelleyin. Bu, daha güvenli ve daha stabil kurulumlar sağlar. İzinleri düzelttikten sonra, kurulumu başarıyla tamamlamak için kurulum komutunu yeniden çalıştırın.

• Ağ/güvenlik duvarı sorunları

Kısıtlı ağlarda veya kurumsal ortamlarda, npm kayıt defterine erişimin engellenmesi veya yavaş indirmeler nedeniyle OpenCode kurulumu başarısız olabilir.

Bunu düzeltmek için alternatif bir npm kayıt defterine geçin veya curl ya da ikili dosya indirme gibi doğrudan bir kurulum yöntemi kullanın. Ayrıca, engellenen bağlantılar genellikle paket kurulumunu kesintiye uğrattığından güvenlik duvarınızın Node.js ve npm trafiğine izin verdiğinden emin olun.

• TUI görüntüleme sorunları

OpenCode açılıyor ama bozuk görünüyorsa, hizalama sorunları varsa veya karakterler bozuk görünüyorsa, sorun genellikle terminal uyumluluğuyla ilgilidir.

Windows Terminal, WezTerm veya iTerm2 gibi true color ve Unicode render desteği sunan modern bir terminal emülatörü kullanın. Terminal ayarlarınızı güncellemek veya ortam değiştirmek genellikle görüntüleme sorunlarını hemen çözer.

Sonuç

Doğru OpenCode kurulumu ve yapılandırması, farklı sistemlerde sorunsuz performans sağlarken yaygın kurulum hatalarının riskini azaltır. Bağımlılıklar, terminal ayarları ve API bağlantıları doğru şekilde yönetildiğinde, kullanıcılar sorunları hızla çözebilir ve kararlı bir geliştirme ortamı sürdürebilir. Kimi API gibi harici servislerin entegre edilmesi, iş akışları içinde gelişmiş model erişimini mümkün kılarak esnekliği daha da artırır.