OpenCode Entegrasyon Kılavuzu: EvoLink API ile Claude 4.5, GPT-5.2 ve Gemini 3 Pro'ya Nasıl Erişilir (2026)

Not: Bu makale EvoLink Resmi Blogu'ndan yeniden yayınlanmıştır.

Giriş: Terminal Tabanlı Yapay Zekanın Yeni Çağı

Hızla gelişen 2026 manzarasında, geliştiricinin terminali basit bir komut satırından Yapay Zeka için sofistike bir komuta merkezine dönüştü. IDE'niz, tarayıcı tabanlı bir sohbet robotu ve API belgeleri arasında bağlam değiştirme günleri sona erdi. Bugün, en verimli geliştiriciler yapay zeka ajanlarını doğrudan CLI iş akışlarına entegre ediyor.

Ancak yeni bir zorluk ortaya çıktı: Model Parçalanması. Üstün kodlama yetenekleri için Claude 4.5'e, karmaşık akıl yürütme için GPT-5.2'ye ve devasa bağlam penceresi için Gemini 3 Pro'ya ihtiyacınız var. Üç ayrı aboneliği ve API anahtarını yönetmek verimsiz ve maliyetlidir.

Bu kılavuz nihai çözümü sunuyor: Önde gelen açık kaynaklı terminal kodlama ajanı OpenCode'u birleşik API ağ geçidi EvoLink ile entegre etmek. Bu "gökdelen" kılavuzunu izleyerek, dünyanın en iyi yapay zeka modellerine talep üzerine erişmenizi sağlayan sağlam, uygun maliyetli bir geliştirme ortamı oluşturmayı öğreneceksiniz - kodlama hızınızı artırırken API maliyetlerinde %70'e varan tasarruf sağlayacaksınız.

Bölüm 1: Yapay Zeka Yığınınızın Bileşenleri

OpenCode Nedir?

OpenCode, geliştirici topluluğunu kasıp kavuran ve GitHub'da 45.000'den fazla yıldız toplayan Go tabanlı, açık kaynaklı bir komut satırı programlama aracıdır (CLI). Standart otomatik tamamlama uzantılarının aksine, OpenCode otonom bir ajan olarak işlev görür. Şunları yapmanıza olanak tanıyan modern bir Terminal Kullanıcı Arayüzüne (TUI) sahiptir:

• Doğal dil kullanarak kod tabanınızla sohbet edin.
• Terminal komutlarını otonom olarak yürütün (izinle).
• Proje yapınızdaki dosyaları düzenleyin.
• Yığın izlerini doğrudan çıktıdan okuyarak hataları ayıklayın.

Gerçek gücü sağlayıcıdan bağımsız tasarımında yatar. OpenCode sizi belirli bir modeli kullanmaya zorlamaz; ona bağlamayı seçtiğiniz herhangi bir zeka için bir kap görevi görür.

EvoLink Nedir?

EvoLink, bu kurulumu güçlendiren altyapı katmanıdır. 40'tan fazla ana akım yapay zeka modelini tek bir arayüzde toplayan akıllı bir API ağ geçididir.

• Birleşik Erişim: Tek bir API anahtarı size OpenAI, Anthropic, Google, Alibaba ve ByteDance modellerine erişim sağlar.
• Maliyet Verimliliği: Akıllı Yönlendirme sayesinde EvoLink, istekleri belirli bir model için en uygun maliyetli sağlayıcıya otomatik olarak yönlendirerek, doğrudan sağlayıcı kullanımına kıyasla %20-70 tasarruf sağlar.
• Güvenilirlik: Asenkron görev mimarisi ve otomatik yük devretme ile EvoLink, %99,9 çalışma süresini garanti ederek kodlama ajanınızın kritik bir hata ayıklama oturumu sırasında asla "takılmamasını" sağlar.

Bölüm 2: Neden OpenCode'u EvoLink ile Entegre Etmelisiniz?

OpenCode ve EvoLink'in entegrasyonu, yazılım geliştirmenin "Gökdelen İlkesini" temsil eder - yeni zirvelere ulaşmak için güçlü temeller üzerine inşa etmek.

1. Model Çevikliği: Konfigürasyonunuzu veya API anahtarlarınızı değiştirmeden karmaşık sınıflar yazmak için Claude 4.5 Opus kullanmaktan 500 sayfalık bir dokümantasyon PDF'sini analiz etmek için Gemini 3 Pro kullanmaya geçebilirsiniz.
2. Sıfır Kod Taşıma: EvoLink, OpenAI API formatıyla tamamen uyumludur. Bu, OpenCode'un standart bir sağlayıcıyla konuştuğunu "düşündüğü", EvoLink'in ise arka planda karmaşık yönlendirmeyi hallettiği anlamına gelir.
3. Yüksek Yoğunluklu Bilgi Akışı: OpenCode'un yerel dosyaları okuma yeteneğini EvoLink'in yüksek bağlamlı modellere erişimiyle birleştirerek, analiz için tüm depoları bağlam penceresine besleyebilirsiniz.

Bölüm 3: Üç Güçlü Modeli Anlamak (2026 Sürümü)

Entegrasyonu yapılandırmadan önce, neyi entegre ettiğinizi anlamak çok önemlidir. 2026'nın başlarında, üç model manzaraya hakimdir. EvoLink aracılığıyla hepsine erişebilirsiniz.

1. Claude 4.5 (Sonnet & Opus) - Kodlama Mimarı

• En İyisi: Temiz, bakımı yapılabilir kod yazmak, yeniden düzenleme ve mimari planlama.
• İstatistikler: Claude 4.5 Opus, SWE-bench Verified liderlik tablosunda %80,9 puanla tacı elinde tutuyor; bu da gerçek dünyadaki GitHub sorunlarını diğer tüm modellerden daha iyi çözdüğü anlamına geliyor.
• Neden OpenCode'da kullanılmalı: En "insan benzeri" kod yapısını üretir ve var olmayan kütüphaneleri halüsinasyon olarak görme olasılığı daha düşüktür. Karmaşık, çok adımlı talimatları izlemede mükemmeldir.

2. GPT-5.2 - Akıl Yürütme Motoru

• En İyisi: Karmaşık mantık, matematiksel algoritmalar ve belirsiz hatalar üzerinde "düşünmek".
• İstatistikler: GPT-5.2, AIME 2025 (matematik) kıyaslamasında %100 ve ARC-AGI-2'de %52,9 mükemmel bir başarı elde ederek, soyut akıl yürütmede rakiplerini önemli ölçüde geride bırakıyor.
• Neden OpenCode'da kullanılmalı: Açıklamaya meydan okuyan bir mantık hatasında takılıp kaldığınızda veya karmaşık düzenli ifadeler veya SQL sorguları oluşturmanız gerektiğinde, GPT-5.2 üstün seçimdir.

3. Gemini 3 Pro - Bağlam ve Çok Modlu Kral

• En İyisi: Devasa kod tabanlarını analiz etmek, dokümantasyon görüntülerini okumak ve yüksek hızlı yineleme.
• İstatistikler: Devasa bir 1 Milyon Token bağlam penceresine ve endüstri lideri hıza (yaklaşık 180 token/saniye) sahiptir.
• Neden OpenCode'da kullanılmalı: Küresel tutarlılığı kontrol etmek için tüm proje dizininizi isteme beslemeniz gerektiğinde Gemini 3 Pro'yu kullanın. Ayrıca yüksek hacimli görevler için en uygun maliyetli seçenektir.

Bölüm 4: Adım Adım Entegrasyon Kılavuzu

Bu kılavuz, Unix benzeri bir ortamda (macOS/Linux) veya Windows için WSL'de çalıştığınızı varsayar.

Önkoşullar

1. Terminal Emülatörü: iTerm2 (macOS), Windows Terminal veya Hyper.
2. EvoLink Hesabı: evolink.ai adresinde geçerli bir hesap.
3. Git: Makinenizde yüklü.

Adım 1: OpenCode'u Kurun

Eğer OpenCode'u henüz kurmadıysanız, terminalinizde aşağıdaki komutu çalıştırın. Bu betik işletim sisteminizi otomatik olarak algılar ve gerekli ikili dosyaları kurar.

curl -fsSL https://raw.githubusercontent.com/opencode-ai/opencode/main/install | bash

Kurulumu doğrulayın:

opencode --version

Adım 2: EvoLink API Anahtarınızı Alın

1. EvoLink Panonuza giriş yapın.
2. API Keys bölümüne gidin.
3. Create New Key'e tıklayın.
4. Anahtar dizesini kopyalayın (sk-evo... ile başlar). Bu anahtarı paylaşmayın.

Adım 2.5: OpenCode Sağlayıcısını Başlatın

JSON dosyasını yapılandırmadan önce, EvoLink'i OpenCode'un kimlik bilgisi yöneticisine özel bir sağlayıcı olarak kaydetmeniz gerekir. Bu, OpenCode'un EvoLink'i geçerli bir sağlayıcı olarak tanımasını sağlayan tek seferlik bir kurulumdur.

1. OpenCode'u ilk kez başlatın:

opencode

2. OpenCode başladığında, bir sağlayıcı bağlamanızı isteyecektir. Sağlayıcı listesinde aşağı kaydırın ve other seçeneğini seçin (yazarak arayabilirsiniz).

3. Sağlayıcı Kimliğini Girin: İstendiğinde, sağlayıcı tanımlayıcısı olarak evolink yazın. Bu, OpenCode'un sisteminde özel bir sağlayıcı girişi oluşturur.

4. API Anahtarını Girin: Buraya herhangi bir yer tutucu değer girebilirsiniz (örneğin, admin veya temp). Gerçek EvoLink API anahtarı bir sonraki adımda yapılandırma dosyası aracılığıyla referans alınacaktır.

Önemli: Bu başlatma adımı, evolink'i OpenCode'un yerel kimlik bilgisi yöneticisine kaydeder. Bir sonraki adımda oluşturacağımız yapılandırma dosyası gerçek bağlantı ayrıntılarını sağlayacaktır.

Adım 3: OpenCode'u Yapılandırın

1. Yapılandırma Dizinini Bulun/Oluşturun:

   • macOS/Linux: ~/.config/opencode/
   • Windows: %AppData%\opencode\

   Windows kullanıcıları için: Win + R tuşlarına basın, %AppData%\opencode\ yapıştırın ve dizini açmak için Enter tuşuna basın:

   

2. opencode.json dosyasını oluşturun:

mkdir -p ~/.config/opencode
nano ~/.config/opencode/opencode.json

3. Aşağıdaki yapılandırmayı yapıştırın:
   Not: YOUR_EVOLINK_API_KEY kısmını Adım 2'de oluşturduğunuz anahtarla değiştirin.

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "evolink": {
            "npm": "@ai-sdk/anthropic",
            "name": "Evolink",
            "options": {
                "baseURL": "https://code.evolink.ai/v1",
                "apiKey": "your-evolink-api-key"
            },
            "models": {
                "claude-opus-4-5-20251101": {
                    "name": "Claude-4.5-Opus"
                },
                "claude-sonnet-4-5-20250929": {
                    "name": "Claude-4.5-Sonnet"
                },
                "claude-haiku-4-5-20251001": {
                    "name": "Claude-4.5-Haiku"
                }
            }
        }
    }
}

Teknik Not: Claude ve Gemini modellerini kullanıyor olsak da, JSON'da provider'ı "openai" olarak ayarlıyoruz. Bunun nedeni, EvoLink'in OpenAI API formatını Anthropic ve Google'ın yerel formatlarına sorunsuz bir şekilde çevirmesidir. Bu "hile", OpenCode'un standart protokolleri kullanarak GPT olmayan modellerle iletişim kurmasını sağlar.

Adım 4: Bağlantıyı Doğrulayın

Terminalinizde OpenCode'u başlatın:

opencode

Giriş kutusuna şunu yazın:

"Hello, which model are you and who is your provider?"

Doğru yapılandırılmışsa, yanıt tanımladığınız modeli onaylamalıdır (örneğin, "I am GPT-5.2...").

Bölüm 5: Gelişmiş Yapılandırma ve Model Değiştirme

OpenCode'a girdiğinizde, tek bir modele kilitlenmezsiniz. Eldeki göreve göre modelleri dinamik olarak değiştirebilirsiniz.

CLI Üzerinden Model Değiştirme

Aracı başlatırken modeli doğrudan belirtebilirsiniz:

# Hızlı bir mantık kontrolü için
opencode --model gpt-5.2

# Ağır bir kodlama oturumu için
opencode --model claude-3-5-sonnet-20240620

TUI Üzerinden Model Değiştirme

OpenCode arayüzü içinde, mevcut yapılandırmaları görüntülemek için /models komutunu kullanabilirsiniz.

1. /models yazın ve Enter'a basın.
2. opencode.json listenizden model kimliğini seçin.
3. Bağlamı hemen değiştirmek için Enter'a basın.

Bölüm 6: Yüksek Yoğunluklu Geliştirme İçin En İyi Uygulamalar

Bu entegrasyonun "Gökdelen" potansiyelinden gerçekten yararlanmak için şu en iyi uygulamaları izleyin:

1. Bağlam Stratejisi

• Gemini 3 Pro kullanırken: Tüm kaynak klasörünüzü eklemek için /add src/ gibi komutları çalıştırmaktan çekinmeyin. Gemini'nin 1 Milyonluk bağlam penceresi yükü kaldırabilir ve projenizin tam bağımlılık grafiğini anlamasını sağlar.
• GPT-5.2 kullanırken: Daha seçici olun. Akıl yürütme motorunun dikkat dağılmadan eldeki mantığa sıkı sıkıya odaklanmasını sağlamak için yalnızca ilgili dosyaları (/add src/utils/helper.ts) ekleyin.

2. Maliyet Kontrolü İçin Akıllı Yönlendirme

EvoLink'in Akıllı Yönlendirme özelliği varsayılan olarak aktiftir. Ancak, basit görevler için modellerin "Turbo" veya "Flash" sürümlerini kullanarak daha fazla optimizasyon yapabilirsiniz.

• Basit birim testleri veya yorumlar yazmak için opencode.json dosyanızda bir gpt-4o-mini veya gemini-3-flash girişi yapılandırın. Bu modeller, öncü modellerin maliyetinin çok küçük bir kısmına mal olur ancak temel görevler için yeterlidir.

3. Önce Güvenlik

opencode.json dosyanızı asla herkese açık bir depoya işlemeyin (commit etmeyin). .config/opencode/ dizinini global .gitignore dosyanıza ekleyin.

echo ".config/opencode/" >> ~/.gitignore_global
git config --global core.excludesfile ~/.gitignore_global

Bölüm 7: Sık Karşılaşılan Sorunları Giderme

S: 401 Unauthorized Hatası alıyorum.

• Çözüm: EvoLink API anahtarınızı kontrol edin. sk-evo... tam dizesini kopyaladığınızdan emin olun. Ayrıca, EvoLink hesabınızda pozitif kredi bakiyeniz olduğunu doğrulayın.

S: OpenCode "Model not found" diyor.

• Çözüm: JSON'unuzdaki model adının EvoLink tarafından desteklenen model kimlikleriyle (örneğin, gpt-4o, claude-3-opus-20240229) tam olarak eşleştiğinden emin olun. Tam kimlik dizeleri için EvoLink Model Listesini kontrol edin.

S: Yanıt çok yavaş aktarılıyor.

• Çözüm: EvoLink hızlı olsa da ağ gecikmesi değişebilir. Basit bir sorgu için çok büyük bir model (Opus gibi) kullanıp kullanmadığınızı kontrol edin. Daha hızlı etkileşimler için gpt-5.2 veya gemini-3-flash modellerine geçin.

Sonuç

OpenCode'u EvoLink ile entegre ederek, en yüksek verimlilik ve güç standartlarına bağlı bir geliştirme ortamı oluşturdunuz. Artık tek bir yapay zeka sağlayıcısının sınırlamalarıyla kısıtlı değilsiniz. Bunun yerine, dünyanın en akıllı modellerini (mimari için Claude, akıl yürütme için GPT ve bağlam için Gemini) tek bir uygun maliyetli boru hattı aracılığıyla yöneten bir komuta merkeziniz var.

Terminalinizi yükseltmeye hazır mısınız?

1. EvoLink'ten API Anahtarınızı alın
2. OpenCode'u İndirin
3. Gelecekle kodlamaya bugün başlayın.