Codex Kullanma Teknikleri

Başlangıçta Codex’in sınırlı bir araç olduğunu düşünüyordum. Ancak onu gerçek bir proje geliştirme sürecinde kullandığımda bu görüş tamamen değişti. Codex’in yalnızca kod üreten bir sistem değil, geliştirme sürecini yeniden şekillendiren bir mühendislik asistanı olduğunu gördüm. Bu videoda, Codex’in proje üretimindeki gerçek potansiyelini birlikte inceleyeceğiz.

Codex nedir?

Codex, OpenAI'nin kodu okuyabilen, değiştirebilen ve çalıştırabilen kodlama aracıdır. Daha hızlı kod oluşturmanıza, hataları gidermenize ve bilmediğiniz kodları anlamanıza yardımcı olur. Codex, buluttaki kendi ortamını kullanarak arka planda birçok görev üzerinde çalışabilir. [1]

Codex’e erişebilmeniz için chatgpt.com/codex adresine gidip ChatGPT hesabınıza giriş yapmanız gerekiyor. Codex’i kullanabilmeniz şimdilerde ücretsiz planlarda mümkün olmasa da Plus, Pro, Business, Edu veya Enterprise planlarıyla kullanabilirsiniz.

Codex’i Github ve Slack gibi üçüncü taraf uygulamalara entegre edebilirsiniz. Github hesabınızdaki projeleriniz üzerinde Codex ile analiz, hata ayıklama ve kod yorumlama gibi işlemlerin yanı sıra yeni özellikler de ekleyebilirsiniz.

Bunun haricinde Slack hesabınızı bağlayabilir ve @Codex’i etiketleyerek mesajlar gönderebilirsiniz. Böylelikle Codex’i rahatlıkla kontrol edebilirsiniz. Birazdan Github ve Slack hesabınızı nasıl bağlayacağınızı örneklerle birlikte göstereceğim.

Codex’e Arayüzden Erişmek

Codex’e ilk kez giriş yaptıysanız çalışmaya başlamak için bir Github hesabıyla bağlantı kurmanız gerekiyor. Hem organizasyonunuz için hem de kişisel Github hesabınız için Codex aracını kullanabilirsiniz. GitHub hesabınızı bağladıktan sonra Codex’in hangi proje üzerinde çalışmasını istiyorsanız Github üzerinden proje izinlerini vermeniz gerekiyor. İster tek bir proje için izin verin isterseniz tüm uygulamalar için fark etmez. Vermiş olduğunuz izinleri sonrasında kontrol etmek ve düzenlemek için yine Github’ın ayarlar kısmını kullanabilirsiniz.

Proje izinlerini de verdikten sonra başlamaya hazırsınız.

Codex ile Kodlamak

Codex’le kodlamaya başlamak için öncelikle proje seçmeliyiz. Github’dan gerekli izinleri verdiğimiz projemizi seçtikten sonra hangi dal (branch) üzerinde çalışacağımızı seçeceğiz. Codex seçmiş olduğunuz dalı baz alarak yeni bir dal (branch) oluşturacağından hangi dalı seçtiğiniz önem arz eder. Eğer tek başınıza proje geliştiriyorsanız ana daldan ilerleyebilirsiniz ancak birden fazla Codex görevini aynı anda çalıştıracaksanız veya ekip olarak ilerleyecekseniz farklı dallar kullanmanız avantajlı olabilir.

Dalı da seçtikten sonra bir görev için kaç farklı sonuç sunulacağını da seçebilirsiniz ancak bu Codex’in daha fazla kredi harcamasına sebebiyet vereceğinden benim önerim bir ya da maksimum iki sonuç seçmek.

Artık projeniz üzerinde çalışmaya hazırsınız. Eğer nasıl başlayacağınızı bilmiyorsanız Codex’in planlama özelliğini kullanarak fikir edinebilirsiniz. Bu planlama özelliğini kullandığınızda Codex seçmiş olduğunuz proje ve daldaki kodları detaylıca inceledikten sonra size öneriler ve yol haritaları çıkaracak. Bu işlemi Codex yerine harici yapay zekalardan da yapabilirsiniz.

Yok ben direkt olarak proje üzerinde çalışayım, hata çözeyim ya da yeni özellikler ekleyeyim diyorsanız bunu da yapmanız mümkün. Bunun için yine yapmanız gereken aklınızdakini sırayla ve basitçe komuta dökmek. Komut mühendisliğiyle ilgili kanalımdaki videoları ziyaret edebilirsiniz. Eğer video hoşunuza gittiyse beğenebilir ve yeni gelecek videolar için takipte kalabilirsiniz.

Codex Ayarları

Codex’i nasıl etkili kullanacağınızla ilgili örneklere geçmeden önce ayarlar kısmını hızlıca açıklamak istiyorum. Ayarlar kısmı genel bir yapay zeka sohbet botunun genel özelliklerini barındırmasının yanı sıra geliştiriciler için detaylı bilgileri de içerir. Hadi ayarlara göz atalım.

Genel Ayarlar (General)

Genel ayarlar kısmında Codex’in her komutta takip etmesi gereken özel talimatları verebilirsiniz. Mesela her Python projesinde yorum satırlarını belirli formatta eklemesini; her görevin sonunda gerekli testleri çalıştırmasını belirtebilirsiniz.

Github’dan aşina olduğumuz, değişikliklerin gösterilme stilini (Diff display format) de değiştirebilirsiniz. Bunun yanı sıra Codex’e, her görevin sonunda oluşturacağı PR (Pull Request) işlemleri için nasıl bir isimlendirmeyi takip etmesi gerektiğini belirtebilirsiniz. Her dal için özellik, tarih ve zaman içeren isimlendirme formatlarını kullanabilirsiniz.

Ortamlar (Environments)

Codex, görevleri gerçekleştirmek için izole ortamlar oluşturur. Bu ortamlar projenin gerekliliklerine göre yapılandırılmalıdır ki hatalarla karşılaşılmasın. İster ön yüz ister arka yüz isterseniz de mikroservis geliştirin fark etmez. Github projenizde bulunan kodların çalıştırıldığı izole ortamları ve bu ortamlarda bulunan görevleri bu sekmeden kontrol edebilirsiniz.

Ayrıca Github’da bulunan farklı projeleriniz için yeni ortamlar oluşturabilirsiniz. Bir ortam oluşturmak için Github’daki proje ayarlarını kontrol ettikten sonra projeyi seçmeli, projenize isim ve açıklama girmelisiniz. Sonrasında kodun çalıştırılacağı konteyner ayarlarına göz atabilir, ortam değişkenlerinizi ve gizli anahtarlarınızı ekleyebilirsiniz.

Container Caching özelliğini kullanarak projenin tekrar tekrar kurulmasının önüne geçebilir ve hızlıca ayağa kalkmasını yani çalışmasını sağlatabilirsiniz ancak bu özelliğin kodunuzu harici bir bilgisayarda sakladığını hatırlamanız gerekmekte.

Setup script ayarı ise projenin nasıl kurulacağını ve çalıştırılacağını gösteren kurulum komutlarıdır. Eğer projenizde bir doküman mevcutsa otomatik ayarda bırakabilir ya da kendiniz elle komutları tanımlayabilirsiniz.

Agent internet access özelliğinde ise Codex’in internete ne oranda erişeceğini belirlersiniz. Bu özelliği kapalı tuttuğunuzda Codex, sadece gerekli paketleri yüklemek için internete erişir ve sonrasında internet bağlantısını sonlandırır. Ancak tümüyle açtığınızda bazı güvenlik açıklarına sebebiyet verebilirsiniz. Bundan kaynaklı olarak Agent internet access kapalı tutmanızı tavsiye ederim. Ayrıca ortamlar sekmesinde terminale de direkt olarak erişerek bazı komutları çalıştırabilirsiniz.

Kod İncelemesi (Code Review)

Kodu incelemesi için Codex’i aktifleştirebilir ve PR’larınızda etiketleyebilirsiniz. Böylelikle Codex otomatik olarak kodunuzu inceledikten sonra öneriler verir. Burada her proje için otomatik kod inceleme ayarını etkinleştirebilirsiniz.

Bağlayıcılar (Connectors)

Codex’te kullanabildiğiniz şimdilik iki bağlayıcı vardır. Bunlardan birisi Github ki az önce bağlamıştık. Bir diğeri de Slack.

Slack genellikle kurumlar veya takımlar için özelleştirilmiş bir mesajlaşma uygulamasıdır. Hali hazırda ekibinizle Slack üzerinden mesajlaşıyorsanız ya da tek başınıza Slack kullanıyorsanız Codex’i de ekibinize dahil edebilir ve ona sorular sorabilirsiniz.

Kullanım (Usage)

Codex farklı paketler için farklı krediler tanımlar. Bu krediler haftalık ve 5 saatlik sınırlandırmalar gibi zaman bazlı olabileceği gibi kod inceleme ve mesaj gönderim limiti gibi farklı sınırlandırmalara da tabidir. Proje büyüklüğü, komutların uzunluğu ve karmaşıklığı gibi pek çok etken bu miktar üzerinde etki oluşturur. Ancak tek başınıza çalışıyorsanız kısıtlamalara takılmadan kodlama yapabilirsiniz.

Veri Kontrolü (Data Controls)

Codex’in yani ChatGPT’nin tüm kullanıcılar için modellerini sizin verilerinizi kullanarak eğitmesine izin vermek ya da vermemek istiyorsanız Veri Kontrolü sekmesini kullanabilirsiniz. Bu sekme aracılığıyla komutlarınızın, komutlara karşılık aldığınız sonuçların ya da proje ortamlarınızın tümüyle modeli eğitmesine izin verebilirsiniz.

Codex ayarlarını böylelikle tamamlamış olduk. Eğer video hoşunuza gittiyse beğenebilir ve yeni gelecek videolar için takipte kalabilirsiniz. Ayrıca yapay zeka konulu sohbetlerimizi sürdürdüğümüz Whatsapp grubumuza katılmak için açıklamadaki bağlantıya gidebilirsiniz.

Codex’i Terminalde Kullanma

Codex, komut satırında çalışan geliştiricilere doğrudan terminal üzerinden akıllı bir yardımcı sunar. openai CLI veya benzeri araçlar sayesinde Codex; komut önerisi verme, uzun komut zincirlerini otomatik oluşturma, hatalı komutları düzeltme, shell script üretme, mevcut script’leri optimize etme ve karmaşık terminal işlemlerini kısaltma gibi yeteneklerle komut satırı verimliliğini artırır. CLI entegrasyonu, geliştiricinin bulunduğu dizini, dosyaları ve bağlamı okuyarak ilgili komutları önerdiği için özellikle devops görevlerinde, otomasyon akışlarında ve hızlı prototipleme süreçlerinde büyük avantaj sağlar.

Terminal üzerinden Codex kullanmak için öncelikle sisteminizde Node.js yüklü olmalıdır. Ardından npm install -g openai komutu ile OpenAI CLI aracını global olarak kurabilirsiniz. Kurulumdan sonra openai config set api_key <KEY> komutuyla kendi API anahtarınızı tanımlarsınız. Artık openai api chat.completions.create gibi komutlarla Codex’i doğrudan terminalde kullanabilir, komut üretme süreçlerinizi hızlandırabilirsiniz.

Codex’i IDE’de Kullanma

Codex, geliştiricilerin kod yazma sürecini hızlandırmak için IDE’lere entegre edilebilen bir yapay zeka yardımcısı olarak tasarlanmıştır. VS Code gibi modern geliştirme ortamlarında Codex; otomatik kod tamamlama, fonksiyon önerileri, hata düzeltme, kod açıklama ve dönüşüm gibi yetenekleri gerçek zamanlı olarak sunar.

VS Code’da Codex’i kullanmak için önce Marketplace’ten resmi OpenAI uzantısını yüklemeniz gerekir. Uzantıyı kurduktan sonra ayarlar bölümüne gidip kendi OpenAI API anahtarınızı ekleyerek etkinleştirebilirsiniz. Bu adımlar tamamlandığında Codex, yazdığınız kodu IDE içinde analiz eder ve önerileri doğrudan editörünüzde gösterir.

Geldik Codex’i nasıl etkili kullanabileceğinize. Kod örnekleri için açıklamadaki bağlantıdan web siteme ulaşabilirsiniz.

Codex Kullanma Teknikleri

• Net bağlam sağlayın: Kod örnekleri, fonksiyon imzaları, açıklayıcı yorumlar ve hedef çıktıyı tarif eden kısa notlarla modeli doğru yönlendirin.
• Spesifik olun: Koddan ne istediğinizi (dönüştürme, iyileştirme, açıklama, test üretme, refactor vb.) açıkça söyleyin.
• Komutları adım adım verin: Karmaşık işlemleri küçük parçalara bölmek sonuç kalitesini belirgin şekilde artırır.
• Bağlamı temiz tutun: Gereksiz satırlar, bozuk biçimler ve eski kod parçaları modeli şaşırtabilir; sade bir giriş sunun.
• Kural ve beklentileri belirtin: Performans, güvenlik, okunabilirlik, mimari prensipler (SOLID/GRASP) gibi kuralları açıkça yazın.
• Bağlamı doğru ölçeklendirin: Büyük kodlar için geniş bağlam isteyen modelleri; küçük görevler için hızlı ve hafif modelleri tercih edin.
• Dönüştürme hedefini netleştirin: “Bunu TypeScript’e çevir”, “Bu fonksiyonu optimize et”, “Sadece açıklama üret”, “Test dosyası oluştur” gibi net yönlendirme verin.
• İlerlemeyi kontrol edin: Çıktının doğru yöne gidip gitmediğini görmek için gerektiğinde ek istemlerle revizyon yapın.
• IDE’de entegrasyonu kullanın: Kod tamamlama, inline açıklama, otomatik refactor fırsatları gibi özelliklerden faydalanarak üretim hızınızı artırın.
• Terminal kullanımını otomatikleştirin: Script üretme, karmaşık komut zincirleri oluşturma veya devops işlemlerini hızlandırmak için Codex’i CLI ile entegre edin.
• Bulut API entegrasyonu kurun: Test üretimi, kod inceleme, CI/CD otomasyonları ve altyapı iş akışlarını Codex ile bulut üzerinden otomatikleştirin.
• Tekrarlayan işleri sistemleştirin: Kod şablonları, test kalıpları, dokümantasyon formatları gibi tekrar eden üretimleri Codex’e bırakın.
• Dil dönüşümünü etkin kullanın: Bir dildeki kodu diğerine çevirirken açıklayıcı bağlam ekleyerek hatasız sonuç elde edin.
• İstenmeyen hataları azaltın: Modelin yanlış anlamaması için girişlerinizi net, temiz ve yapılandırılmış şekilde sunun.

Codex Plan

Codex Plan özelliği, yazmak istediğiniz kodun veya çözmek istediğiniz problemin önce bir yol haritasını, yani “planını” oluşturur. Bu plan; hangi adımların izleneceğini, hangi fonksiyonların gerektiğini, veri akışının nasıl kurulacağını ve çözümün genel mimarisini sizin için önden tasarlar. Böylece model, direkt koda atlamak yerine önce düşünür, sonra en uygun çözümü üretir.

Nasıl etkili kullanılır?

• Karmaşık projelerde (API tasarımı, çok adımlı fonksiyonlar, algoritmalar) önce plan isteyip, sonrasında plana göre kodu yazdırmanız tutarlılığı güçlendirir.
• Bir hatayı çözmek istiyorsanız önce “Sorunun nedenini listele ve bir çözüm planı çıkar” diyerek daha doğru çözümler elde edersiniz.
• Birden fazla modülden oluşan projelerde plan, size kodun bütünsel yapısını görmenizi sağlar ve kaosu azaltır.
• Kod optimizasyonunda önce “iyileştirme planı” isteyerek hangi alanları düzeltmesi gerektiğini netleştirebilirsiniz.

Codex Image Attachment

Image attachment, kod yazarken veya teknik bir sorun çözerken görüntüleri (UI ekran görüntüsü, hata görseli, terminal fotoğrafı, grafik, diyagram vb.) modele “bağlam” olarak eklemenizi sağlar. Codex, görüntüyü analiz eder ve kodu bu görsel referansa göre üretir.

Nasıl etkili kullanılır?

• UI geliştirme: Bir tasarım dosyası veya ekran görüntüsü ekleyip, “bu tasarıma uygun React/Tailwind kodunu üret” diyebilirsiniz.
• Hata çözme: Terminal çıktısının ekran fotoğrafını eklediğinizde model hatayı tanır ve çözüm adımlarını çıkarır.
• Kod karşılaştırma: Figma → HTML/CSS dönüşümü için görseli ekleyip tam eşleşen layout kodları alabilirsiniz.
• Veri analizi: Grafik veya tabloların fotoğrafını ekleyip analiz, açıklama veya kod üretmesini sağlayabilirsiniz.
• Diyagramdan kod üretme: Akış diyagramı, ERD, sınıf şeması gibi çizimleri eklediğinizde modele “buna uygun API/DB şeması üret” diyebilirsiniz.

Codex Command Examples (English)

1. Planning-Based Commands

• “Create a detailed plan before writing any code. Break the solution into clear steps.”
• “Analyze the problem and list potential pitfalls, then propose the safest implementation plan.”
• “Generate a refactoring plan that improves readability, removes duplication, and increases performance.”

2. Coding & Refactoring Commands

• “Convert this function into clean, modular TypeScript following SOLID principles.”
• “Rewrite this code in a more efficient way without changing its behavior.”
• “Generate unit tests for this module using Jest, based on the code below.”
• “Document this code using clear JSDoc comments.”

3. Debugging Commands

• “Explain the root cause of the error shown in the image and propose a fix.”
• “Identify logical flaws in this code and suggest corrections.”
• “Rewrite this block to avoid side effects and potential race conditions.”

4. Image-Attachment Commands

• “Generate responsive React + Tailwind code that replicates the layout in the attached image.”
• “Inspect the screenshot and describe all UI components you see.”
• “Translate the design in the image into a clean, production-ready HTML/CSS layout.”

5. Terminal & Automation Commands

• “Generate a Bash script to automate this workflow step by step.”
• “Optimize this shell command into a shorter and safer version.”
• “Create a Makefile that builds, tests, and deploys this project.”

6. API & Backend Commands

• “Design a REST API for this feature with proper routes, request bodies, and response models.”
• “Generate a database schema based on the entities described below.”
• “Write a clean controller and service implementation using NestJS conventions.”

Baştan sona Codex serisini bu videoda sizlerle birlikte tamamlamış olduk. Codex’in ne olduğundan, ne işe yaradığından tutun da nasıl kullanılacağına dair her detayı ele aldık. Yeni videolarda görüşene dek hoşça kalın!

Sources

1. https://developers.openai.com/codex/cloud
2. https://developers.openai.com/codex/integrations/slack
3. https://chatgpt.com/codex