# CODEX + OLLAMA KURULUM & MODEL ORKESTRASYON REHBERİ > **Daha Fazla Model Kullanın. Çalışma Alanınızı ve Ritimlerinizi Koruyun.** > *Orijinal Yazar: Mark Kashef (16 Eylül 2026, Sürüm 1.0)* > *Türkçe Çeviri & Teknik Uyarlama: Virtual Goods (VG) Mühendislik Ekibi — [vg.com.tr](https://vg.com.tr)* --- ## Genel Bakış: Kurulum Kiti Ne İşe Yarar? Yetenekli ve güçlü bir amiral gemisi modeli (örneğin OpenAI / Claude) zorlu akıl yürütme, planlama ve mimari kararlar için hazır tutun; daha uygun maliyetli bir bulut modeline veya yerel bir açık kaynak modele ise **net ve sınırları belirli tek bir iş** verin. Bu rehber; bu modelleri sisteminize bağlamanıza, **araç (tool-calling) kullanabildiklerini kanıtlamanıza** ve donanımınız üzerinde gerçekten faydalı olup olmadıklarına karar vermenize adım adım yardımcı olur. ### İlk Bitiş Çizginiz (Doğrulama Eşiği) > Yeni bir Codex görevi açtığınızda, seçtiğiniz modelin bir araç çağrısı kullanarak **137 x 249** işlemini hesaplaması, sonucu (**34113**) gerçek bir `result.txt` dosyasına yazması ve ardından ayrı bir araç çağrısıyla bu dosyayı geri okuması gerekir. Yerel bir rota seçtiyseniz, modelin Ollama üzerinde fiilen çalıştığını da (`ollama ps`) doğrulamalısınız. --- ## 1. Hangi Rotayı Seçmelisiniz? Üç farklı operasyonel rota mevcuttur: 1. **Yerel Model (Local Route):** Bilgisayarınıza indirilen bir model kullanır. Yalnızca donanımınız (özellikle VRAM / GPU ve birleşik bellek) yeterliyse ve işiniz modelin yerel hız ve kalite toleranslarına uyuyorsa bu seçeneği tercih edin. 2. **Ollama Üzerinden Bulut (Cloud through Ollama):** Barındırılan (hosted) bir model kullanır. Model ağırlıklarını bilgisayarınıza indirmeden farklı bir modelden faydalanmak istediğinizde tercih edin. Kullanım limitlerini ve maliyetini mutlaka kontrol edin. 3. **Mevcut OpenAI / Bulut Modeliniz:** Planlama, karmaşık muhakeme, kod inceleme ve nihai sentez için hazırda tutulmalıdır. Bu kurulum kiti mevcut aboneliğinizin yerini almaz veya kullanım hakkınızı sıfırlamaz; ona destekçi bir iş gücü ekler. --- ## 2. Doğru Uygulama Sürümünü Bağlama Mevcut çalışan kurulumunuzla başlayın. Açık çalışmalarınızı kaydedin. Gerekirse resmi Ollama indirme sayfasından ([ollama.com/download](https://ollama.com/download)) kurulum yapın, ardından donanımınızı denetlemek için rehberli kurulum istemini kullanın. ### 1. Masaüstü Bağlantısını Kontrol Edin Güncel Ollama belgelerinde bu entegrasyon **ChatGPT Desktop with Codex mode** olarak adlandırılmaktadır. - **Ollama v0.34.0 veya daha yeni** bir sürüm gerektirir. - Ollama menüsünden **Apps** bölümünü açın, **ChatGPT (Desktop)** seçeneğini etkinleştirin ve ekrandaki yönergeleri izleyin. - İstendiğinde masaüstü uygulamasını tamamen yeniden başlatın. ### 2. Gerçekte Kullanacağınız Modeli Seçin Ollama Ayarları > **Apps** > **ChatGPT** sekmesinden uyumlu yerel veya bulut modellerini seçebilirsiniz. - Tercihinizi kaydedin, istenen yeniden başlatmayı tamamlayın. - Yeni bir Codex görevinde hedef modeli seçin. > **Önemli Not:** Arayüzde *"Add to Codex"* veya *"Add to ChatGPT"* ibareleri yer alabilir. İsimler ve mevcut modeller kurulu sürümlerinize bağlıdır. Ekranlarınız farklılık gösterirse ayar uydurmak yerine resmi kılavuzu (`docs.ollama.com/integrations/chatgpt`) referans alın. ### 3. Terminal (CLI) Entegrasyonunu Ayrı Tutun Ollama belgelerinde Codex CLI için `ollama launch codex` komutu da yer alır. Bu bir komut satırı entegrasyonudur; terminalde başarılı olan bir test, masaüstü arayüzünüzdeki model seçicinin güncellendiği anlamına gelmez. ### 4. Bağlantıyı Nasıl Keseceğinizi (Geri Almayı) Bilin Masaüstü kılavuzuna göre: Normal bağlantıyı geri yüklemek için Ollama Apps içerisinden ChatGPT'yi kapatın ve istendiğinde yeniden başlatın. Yaptığınız diğer tüm yapılandırma değişikliklerini not edin. --- ## 3. Codex'e Net Bir Kurulum Görevi Verin Kendi bilgisayarınızda kurulum yaparken, doğrudan aşağıdaki **Rehberli Kurulum İstemini (Guided Setup Prompt)** kullanın. Bu istem Codex'ten sırasıyla; **incelemesini, önermesini, bağlamasını ve doğrulamasını** talep eder. ### Orijinal Kurulum İstemi (Kopyalamaya Hazır Prompt) ```text I've installed Ollama. Inspect my computer's memory, GPU, free disk space and installed models. Choose a tool-capable local model that fits comfortably while leaving room for my other apps. Reuse a suitable installed model, otherwise explain the download size and install a suitable official model. Connect it to Codex using the supported Ollama integration, preserve my current cloud models and default, and back up any configuration you change. Verify local inference, then use Codex to edit a test file and read it back. Tell me what worked and whether I need to restart the app. Don't claim success from a dropdown entry alone. ``` ### Türkçe Eşdeğeri (Türkçe Arayüzler & Ajanlar İçin) ```text Ollama'yı kurdum. Bilgisayarımın RAM kapasitesini, GPU/VRAM durumunu, boş disk alanını ve halihazırda yüklü modelleri denetle. Diğer uygulamalarıma rahatça alan bırakacak, araç çağırma (tool-calling) yeteneğine sahip bir yerel model seç. Uygun bir model yüklüyse onu yeniden kullan; aksi takdirde indirme boyutunu açıkla ve uygun resmi bir model yükle. Desteklenen Ollama entegrasyonunu kullanarak modeli Codex'e bağla; mevcut bulut modellerimi ve varsayılan ayarlarımı koru, değiştirdiğin her yapılandırmayı yedekle. Yerel çıkarımı (local inference) doğrula, ardından Codex ile bir test dosyasını düzenleyip geri oku. Neyin çalıştığını ve uygulamayı yeniden başlatmam gerekip gerekmediğini bana bildir. Yalnızca açılır menüde bir isim gördün diye görevi başarılı sayma. ``` ### Geri Bildirim Olarak Ne Beklemelisiniz? - Donanım özeti (bellek, GPU, disk). - Bir ana model önerisi + daha hafif bir alternatif (fallback). - İndirme boyutu, beklenen bağlam uzunluğu (context length) ve bellek gereksinimi. - Yapılandırma değişiklikleri ve yeniden başlatma adımları. *Bu detayları içermeyen bir model önerisi üzerinde işlem yapmaya henüz hazır değildir.* --- ## 4. Modelin İşi Yapabildiğini Kanıtlayın (Araç Doğrulama Testi) Kullanılmayan boş bir test klasörü açın. Modeli açıkça seçin ve aşağıdaki doğrulama görevini verin: ### En Küçük Yararlı Araç Testi (Minimal Tool Test) ```text Calculate 137 x 249 with a tool. Write the result to result.txt. Read the file back with a separate tool call. Expected contents: 34113. ``` *(Bir araç çağrısı ile 137 x 249 işlemini hesapla. Sonucu result.txt dosyasına yaz. Dosyayı ayrı bir araç çağrısıyla geri oku. Beklenen içerik: 34113.)* > **Kritik Kural:** Dosyayı kendiniz kontrol edin ve araç çıktısını inceleyin. Modelin sohbete doğru cevabı yazması, dosyanın gerçekten yazıldığına veya okunduğuna kanıt değildir. Görevin arka planda sessizce başka bir modele geçmesine izin vermeyin. ### Yerel Model Seçtiyseniz: `ollama ps` Denetimi İstek çalışırken terminalinizde şu komutu çalıştırın: ```bash ollama ps ``` Tam model adını ve işlemci dağılımını (CPU / GPU split) kontrol edin: - Yüksek oranda GPU kullanımı hız sağlar. - Büyük bağlam (context) daha fazla VRAM/RAM tüketir. ### Doğrulama Kayıt Çizelgesi | Parametre | Değer / Durum | |---|---| | **Model & Etiket** | *(Örn: qwen2.5-coder:7b)* | | **Yerel mi / Bulut mu?** | *(Local / Cloud)* | | **Test Dosyası ve İçeriği** | `result.txt` -> `34113` | | **Araç Çağrısı Kanıtı** | *(Bash/File Edit logları)* | | **Geçen Süre & Yeniden Denemeler** | *(sn / deneme sayısı)* | --- ## 5. Görevleri Modeller Arasında Devretme (Task Handoff) En verimli iş akışı: **Bulutta Araştırma → Yerelde Eleme/Sıralama → Güçlü Modelde Nihai Sentez.** ``` [Güçlü Model (OpenAI/Claude)] ---> Görevi planlar, kriterleri ve çıktı şablonunu belirler. │ ▼ (04-TASK-HANDOFF-TEMPLATE.md) [Yerel / Ekonomik Model (Ollama)] -> Sınırları çizilmiş tek bir işi icra eder (özetleme, veri çıkarma). │ ▼ [Denetçi Model / İnsan] ----------> Çıktıyı dosyadan okur, test eder ve onaylar. ``` ### Devir Şablonu (Task Handoff Template) Görevleri modeller arasında aktarırken şu 5 öğeyi doldurun: 1. **Hedef Çıktı:** Net ve somut olarak ne üretilecek? 2. **İzin Verilen Dosyalar:** Modelin hangi dosyalara yazma/değiştirme yetkisi var? 3. **Gerekli Girdiler:** Modele sağlanan ham veri nedir? 4. **Kabul Testleri (Acceptance Checks):** Sonucun doğru sayılması için hangi doğrulamalar geçmeli? 5. **Jeton / Zaman Bütçesi:** Maksimum kaç denemeye izin verilecek? --- ## 6. Tamamlanan Görevin Gerçek Maliyetini Hesaplama Yalnızca jeton fiyatına bakmak yanıltıcıdır. Doğru formül şudur: $$\text{Gerçek Maliyet} = \text{Model Ücreti} + \text{Ücretli Araçlar} + \text{Yeniden Deneme (Retries)} + \text{Sizin İnceleme Süreniz}$$ Daha ucuz veya ücretsiz görünen bir yerel model, yavaşlığı veya hatalı araç çağrıları sebebiyle işin toplam maliyetini artırabilir. ### Üç Farklı Maliyet Havuzu: 1. **OpenAI / Claude Planınız:** Dahil edilen kullanım kotalarınızı veya bağımsız API faturanızı takip edin. 2. **Ollama Cloud:** Barındırılan istekler kendi kotasını veya satın alınan kredileri tüketir. 3. **Yerel Çıkarım (Local Inference):** Jeton başına ücret ödemezsiniz; ancak donanım amortismanı, elektrik ve en önemlisi sizin vaktiniz bir maliyettir. --- ## 7. Bir Şeyler Ters Gittiğinde (Sorun Giderme) | Sorun | Olası Neden | Çözüm | |---|---|---| | **Model seçicide görünmüyor** | Ollama Apps'te kaydedilmedi veya uygulama açık kaldı | Ollama Apps'te modeli teyit edin, kaydedin, masaüstü uygulamasını tamamen kapatıp açın. | | **Sohbet ediyor ama araç çağırmıyor** | Model bu entegrasyonda tool-calling desteklemiyor | Küçük doğrulama testini tekrarlayın; geçemiyorsa araç desteği kanıtlanmış bir modele (örn. Qwen 2.5 Coder) geçin. | | **Bilgisayar donuyor / bellek yetmiyor** | Model veya bağlam boyutu RAM/VRAM'i aşıyor | Bağlam penceresini düşürün veya daha küçük kuantizasyona sahip (4-bit/q4) bir modele geçin. | | **İstek yanlış yere gitti** | Bulut/yerel yönlendirme karıştı | `ollama ps` ile model rotasını kontrol edin; yerel olduğunu varsaymayın. | | **Model değişince bağlam kayboldu** | Sohbet geçmişi aktarılamadı | Görev planını ve kaynakları her zaman bir proje dosyasında tutun; yeni göreve bu dosyayı vererek başlayın. | | **Eski sisteme dönmek gerekiyor** | Yapılandırma bozuldu | Ollama Apps > ChatGPT'yi kapatıp yeniden başlatın; yedeklediğiniz konfigürasyonu geri yükleyin. | --- ## 8. Kurulum Tamamlama Kontrol Listesi - [ ] Hangi görevin hangi model ve sağlayıcıyı kullandığını net olarak biliyorsunuz. - [ ] Test dosyası (`result.txt`) oluşturuldu ve içinde `34113` değeri doğrulandı. - [ ] Yerel rota seçildiğinde `ollama ps` ile yerel yürütme teyit edildi. - [ ] En az bir gerçek dünya alt görevi kabul kriterlerini eksiksiz karşıladı. - [ ] İstediğiniz anda önceki çalışma düzeninize nasıl döneceğinizi biliyorsunuz. --- ### Resmi Kaynaklar & Referanslar - [1] Ollama Desktop Entegrasyonu: `docs.ollama.com/integrations/chatgpt` - [2] Ollama CLI Dokümantasyonu: `docs.ollama.com` - [3] Bağlam Uzunluğu & Bellek Yönetimi: `docs.ollama.com` - [4] Ollama Sıkça Sorulan Sorular: `docs.ollama.com/faq` - [5] Güncel Fiyatlandırma: `ollama.com/pricing` *Bu kılavuz, Mark Kashef'in 16 Eylül 2026 tarihli çalışmasından esinlenilerek Virtual Goods (VG) tarafından Türk geliştirici ve teknoloji ekipleri için hazırlanmıştır.*