OpenCode'u Mac ve Windows'a Kolayca Yükleyin

Kurulum hataları süreci kesintiye uğrattığında veya araç beklendiği gibi çalışmadığında OpenCode'u yüklemek bazen kafa karıştırıcı olabilir. Eksik komutlardan Node.js uyumluluk sorunlarına kadar kullanıcılar ilk yükleme sırasında sıkça zorlanır. OpenCode yükleme hakkındaki bu rehber, yaygın hataları gidermek ve ister Masaüstü ister CLI/TUI kullanıyor olun, OpenCode'u Mac ve Windows'ta başarıyla kurmak için eksiksiz bir çözüm sunar; böylece gecikmeden kodlamaya başlayabilirsiniz.

OpenCode, geliştiricilerin kod yazmasına, düzenlemesine, hata ayıklamasına ve kodu tercih ettikleri ortamdan (terminal, IDE veya masaüstü uygulaması) doğrudan yönetmesine yardımcı olmak için tasarlanmış açık kaynaklı bir yapay zekâ kodlama ajanıdır. Temel olarak kod önerilerine odaklanan geleneksel yapay zekâ kodlama asistanlarının aksine OpenCode, kod tabanının tamamını anlayabilir, dosyaları değiştirebilir, komutları çalıştırabilir ve geliştirme iş akışlarını otomatikleştirebilir. Ayrıca birden fazla yapay zekâ modelini ve yerel modeli destekleyerek geliştiricilere yazılımı nasıl oluşturacakları konusunda daha fazla esneklik ve denetim sağlar.

OpenCode'u yüklemeden ö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 uygun kuruluma sahip olmak, yükleme sürecinin sorunsuz ilerlemesine yardımcı olur.

İşletim Sistemi: macOS / Windows / Linux

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

Uygulama yükleme izni: Cihazınıza yazılım indirmek ve yüklemek için yönetici veya sistem düzeyinde izinlere ihtiyacınız olabilir. Bu durum, özellikle yükleme yetkilerinin kısıtlanabileceği iş yerlerinde veya yönetilen BT ortamlarında önemlidir.

Kararlı internet bağlantısı: OpenCode'u indirmek, güncellemeleri yüklemek ve kurulum ile kullanım sırasında desteklenen yapay zekâ modellerine ve hizmetlerine bağlanmak için kararlı bir internet bağlantısı gerekir.

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

Bir yükleme yöntemi: OpenCode, farklı işletim sistemlerine ve geliştirici tercihlerine uyum sağlamak için birden fazla yükleme yöntemini destekler. Ortamınıza en uygun paket yöneticisini veya yükleme 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, yüklemeyi ve günlük kullanımı çok daha kolay hâle getirebilir. İleri düzey uzmanlık gerekmese de temel gezinti ve komut yürütme bilgisi önerilir.

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

1. Adım: OpenCode Desktop'u indirin

Resmî OpenCode indirme sayfasına gidin ve uygulamanın Windows veya macOS sürümünü seçin. Yükleyici sisteminize otomatik olarak indirilir. Güvenlik ve özgünlük için indirmeyi resmî kaynaktan yaptığınızdan emin olun.

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

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

3. Adım: Kurulumu tamamlayın

Görüntülenen kurulum istemlerini izleyin ve istendiğinde tercih ettiğiniz kurulum dizinini seçin. Ardından yükleyicinin sisteminizdeki kurulum sürecini tamamlamasına izin verin.

4. Adım: 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üklendiğinde, doğrudan projenizin içinde kod oluşturmak, sorunları ayıklamak veya özellikler geliştirmek için AI asistanıyla etkileşime geçebilirsiniz.

Mac'te OpenCode Terminal (TUI), resmî paket yöneticileri veya tek satırlık bir kurulum komutuyla doğrudan kurulabilir. Grafik arayüz yerine terminalde çalışmayı tercih eden geliştiriciler için tasarlanmıştır. OpenCode TUI'yi Mac'e kurmak için aşağıdaki adımları izleyin.

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

Resmî OpenCode indirme sayfasını ziyaret edin ve OpenCode Terminal bölümüne gidin. Burada curl, Homebrew, npm ve bun dâhil olmak üzere 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.

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

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

3. Adım: OpenCode Terminal'i kurun

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

Kurulumun tamamlanmasını bekleyin. OpenCode, gerekli dosyaları indirecek ve CLI'yi otomatik olarak yapılandıracaktır.

4. Adım: 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; böylece bir AI sağlayıcısına bağlanabilir, ayarları yapılandırabilir ve OpenCode ile çalışmaya başlayabilirsiniz.

OpenCode, Windows'ta WSL, npm ve bun dâhil olmak üzere çeşitli kurulum yöntemlerini destekler. En iyi uyumluluk ve deneyim için resmî belgeler Windows Subsystem for Linux (WSL) kullanımını önerir. Aşağıdaki adımlarda WSL kurulum yöntemi kullanılmıştır. WSL zaten yüklüyse ilk adımı atlayabilirsiniz.

1. Adım: WSL'yi kurun (Önerilen)

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

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

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

Windows Başlat menüsünden WSL terminalinizi (örneğin Ubuntu) başlatın. İlk kez açıyorsanız başlangıç kurulumunu tamamlayın. Ardından OpenCode'u kurmak için aşağıdaki komutu çalıştırın:

Devam etmeden önce kurulumun tamamlanmasını bekleyin.

3. Adım: Kurulumu doğrulayın

Kurulum tamamlandıktan sonra aşağıdaki komutu çalıştırın:

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

OpenCode'un başlıca avantajlarından biri, API entegrasyonları aracılığıyla harici AI 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 adımları aşağıdadır:imi

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

Kimi veya desteklenen başka bir hizmet gibi tercih ettiğiniz AI sağlayıcısında bir hesap oluşturarak başlayın. Hesabınızı oluşturduktan sonra sağlayıcının API anahtarı yönetim sayfasına gidin ve yeni bir API anahtarı üretin. Sağlayıcıyı OpenCode'a bağlamak için bu anahtar gerektiğinden, güvenliğini koruyun.

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

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

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

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

Kullanılabilir seçenekler listesinden kullanmak istediğiniz sağlayıcıyı seçin. İstendiğinde, daha önce ürettiğiniz API anahtarını yapıştırın ve bağlantıyı onaylayın. OpenCode anahtarı güvenli bir şekilde saklar ve seçilen sağlayıcıya yönelik istekleri doğrulamak için kullanır.

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

Sağlayıcınızı bağladıktan sonra, bu API aracılığıyla kullanılabilen tüm modelleri görmek için aşağıdaki komutu çalıştırın:

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

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

Kullanılabilir listeden çalışmak istediğiniz modeli seçin. Seçimden sonra OpenCode isteklerinizi bu model üzerinden yönlendirerek bağlı API'yi kullanarak kod üretmenize, uygulamalarda hata ayıklamanıza ve diğer geliştirme görevlerini gerçekleştirmenize olanak tanır. Gereksinimleriniz değişirse daha sonra model değiştirebilirsiniz.

OpenCode, geliştiricilerin daha fazla esneklik için API anahtarlarıyla harici modeller bağlamasına olanak tanıyan birden çok AI sağlayıcısını destekler. En güçlü seçeneklerden biri Kimi API'dir.

Moonshot AI Open Platform 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 AI 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 bu adımları izleyin.

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

1. Kimi AI Open Platform adresini ziyaret edin ve hesabınızda oturum açın.

2. Panodan API Keys bölümüne gidin ve Create API Key'e tıklayın.

3. Anahtar üretildikten sonra (sk- ile başlar) hemen kopyalayın ve güvenli bir yerde saklayın. Anahtar yalnızca bir kez gösterilir ve OpenCode ile Moonshot AI arasındaki isteklerin doğrulanmasında kullanılır.

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

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

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

İstendiğinde, Moonshot AI konsolundan ürettiğiniz API anahtarını yapıştırın ve Enter tuşuna basın:

Doğrulandıktan sonra OpenCode kimlik bilgisini güvenli bir şekilde ~/.local/share/opencode/auth.json konumuna kaydeder ve Moonshot AI sağlayıcı yapılandırmanızla ilişkilendirir.

Not: OpenCode, güvenlik amacıyla API anahtarlarını ana yapılandırma dosyasından ayrı saklar. /connect komutu kimlik bilgisi depolamayı yönetirken, sağlayıcı davranışı opencode.json içinde yapılandırılır.

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

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

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

4. Adım: 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 aşağıdakiler dâhil olmak üzere görüntüler:

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

moonshotai/kimi-k3 seçeneğini belirleyin ve etkin model olarak ayarlayın. Seçimden sonra OpenCode, kod üretimi, hata ayıklama, yeniden düzenleme ve AI destekli diğer geliştirme görevleri için seçilen Kimi modelini kullanır.

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

İpucu: Ajan/Araç modunda (JSON Schema doğrulama hataları gibi) sorun yaşarsanız, bu durum Moonshot AI'ın katı şema gereksinimleri ile OpenCode'un araç parametresi biçimi arasındaki bilinen bir uyumluluk sorunudur. En iyi kararlılık için Chat modunu kullanmayı veya sıcaklık uyumluluğunu otomatik olarak yönetmek üzere opencode-moonshot-compatibility eklentisini yüklemeyi değerlendirin.

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

• Çok modlu girdileri işleyen uygulamalara dönüştürmek

Kimi API; tasarım taslakları, mimari diyagramları, akış şemaları ve videolar dâhil olmak üzere birden çok formattaki bilgiyi yorumlayabilir. Bu bağlamı kullanarak proje gereksinimlerini anlar ve bunları teknik özelliklere veya işlevsel koda dönüştürür. Böylece ekipler, daha az manuel çeviri adımıyla fikir aşamasından uygulamaya geçebilir.

• Uzun soluklu kodlama ve karmaşık mühendislik görevlerini ele alma

Kimi API, OpenCode'un planlama, tutarlılık ve iyileştirme gerektiren daha büyük kodlama görevlerini ele almasına yardımcı olur. Özellik geliştirme, kodu yeniden düzenleme ve karmaşık mühendislik sorunlarını çözme için kullanışlıdır.

• Çok adımlı araç çağrılarıyla sorunlar üzerinde akıl yürütme

Kimi API, çok adımlı görevler üzerinde akıl yürütebilir ve gerektiğinde araç çağırabilir. Bu, hata ayıklama, kod analizi ve tek bir yanıtta tamamlanamayan iş akışlarında yardımcı olur.

OpenCode'u yüklemek genellikle kolaydır, 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 yükleme sorunlarını hızlı ve etkili biçimde çözmenize yardımcı olacak açık ve pratik bir rehber bulabilirsiniz.

• Komut bulunamadı: opencode

Bu hatayı görüyorsanız sistemin PATH'inizde OpenCode çalıştırılabilir dosyasını bulamadığı anlamına gelir. Bu durum genellikle yükleme tamamlanmadığında veya ortam değişkenleri doğru ayarlanmadığında ortaya çıkar.

Sorunu gidermek için önce yüklemeyi doğrulayın ve ikili dosya dizininin sistem PATH'inize eklendiğinden emin olun. npm ile yüklediyseniz genel npm bin yolunuzu kontrol edin ve kabuk yapılandırmanızı buna göre güncelleyin. Düzeltmelerden sonra terminali yeniden başlatmak sorunu çoğu zaman çözer.

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

Yalnızca npm yükleme yöntemi bir Node.js ortamı gerektirir — yükleme betiği ve paket yöneticileri (Homebrew, Scoop, Chocolatey), Node.js gerektirmeyen bağımsız bir ikili dosya yükler.

npm ile yükleme yaptıysanız ve sürüm hatalarıyla karşılaştıysanız node --version kullanarak mevcut sürümünüzü kontrol edin ve nvm gibi bir sürüm yöneticisiyle Node.js'i yükseltin. Yükseltmeden sonra, güncellenen çalışma zamanı ortamıyla uyumluluğu sağlamak için OpenCode'u yeniden yükleyin.

• npm izin hataları

İzin hataları genellikle npm, uygun yazma erişimi olmadan genel paketleri yüklemeye çalıştığında ortaya çıkar.

sudo kullanmak yerine, ana klasörünüzde npm için özel bir genel dizin yapılandırın ve PATH ayarlarını güncelleyin. Bu, daha güvenli ve daha kararlı yüklemeler sağlar. İzinleri düzelttikten sonra kurulumu başarıyla tamamlamak için yükleme komutunu yeniden çalıştırın.

• Ağ/güvenlik duvarı sorunları

Kısıtlı ağlarda veya kurumsal ortamlarda OpenCode yüklemesi, npm kayıt defterine erişimin engellenmesi ya da indirmelerin yavaş olması nedeniyle başarısız olabilir.

Bu sorunu gidermek için alternatif bir npm kayıt defterine geçin veya curl ya da ikili dosya indirme gibi doğrudan bir yükleme yöntemi kullanın. Ayrıca, engellenen bağlantılar paket yüklemesini sık sık 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 ancak bozuk, hizasız görünüyorsa veya bozuk karakterler gösteriyorsa sorun genellikle terminal uyumluluğundan kaynaklanır.

Windows Terminal, WezTerm veya iTerm2 gibi gerçek renk ve Unicode görüntülemeyi destekleyen modern bir terminal emülatörü kullanın. Terminal ayarlarınızı güncellemek veya ortam değiştirmek, görüntüleme sorunlarını genellikle hemen çözer.

OpenCode'un doğru yüklenmesi ve düzgün yapılandırılması, yaygın kurulum hataları riskini azaltırken farklı sistemlerde sorunsuz performans sağlar. Bağımlılıklar, terminal ayarları ve API bağlantıları doğru yönetildiğinde kullanıcılar sorunları hızla çözebilir ve kararlı bir geliştirme ortamını sürdürebilir. Kimi API gibi harici hizmetlerin entegre edilmesi, iş akışlarında gelişmiş model erişimi sağlayarak esnekliği daha da artırır.