OpenAI Codex: 3 Pratik Örnekle Adım Adım Rehber

Kısaca

• OpenAI Codex, ChatGPT içinde sunulan bulut tabanlı bir yazılım mühendisliği aracıdır (Plus, Pro, Team ve Enterprise planları)

• Codex'i bir GitHub deposuna bağlayın, ardından ona görev atayın: hataları düzeltme, yamalar uygulama, testler oluşturma veya kodu açıklama

• Her görev izole bir korumalı alanda çalışır; Codex, birleştirmeden önce gözden geçireceğiniz bir pull request açar

• Codex'in her görevde takip edeceği kodlama kurallarını tanımlamak için bir AGENTS.md dosyası kullanın

• Codex ayrıca Codex CLI üzerinden terminalde ve bir VS Code uzantısı olarak da çalışır

OpenAI’nin Codex’i Nedir?

OpenAI Codex; kod yazabilen ve düzenleyebilen, test çalıştırabilen, hataları düzeltebilen ve hatta pull request önerebilen bulut tabanlı bir yazılım mühendisliği aracıdır. Her görev kendi korumalı ortamında yürütülür.

Codex, OpenAI'nin en yeni sınır modelleriyle desteklenir ve güvenlik, test edilebilirlik ve geliştirici verimliliği için tasarlanmıştır. Codex'i AGENTS.md dosyalarıyla yönlendirebilir veya doğrudan ChatGPT'nin kenar çubuğundan etkileşime geçebilirsiniz.

Ayrıca Codex CLI ile bu yetenekleri doğrudan terminalinize de taşıyabilirsiniz.

Codex erişim seçeneklerine hızlı bakış:

OpenAI'nin Codex'ini Kurma

Codex'in kurulumu yalnızca birkaç dakika sürer. Başlamanız için adım adım bir yol haritası aşağıdadır.

Adım 1: Codex aracını bulma

Önce ChatGPT'ye giriş yapın. Sol taraftaki araç çubuğunda Codex'i arayın. Lansmanda, Codex ChatGPT Pro, Business ve Enterprise kullanıcılarına sunulmuştu. Şimdi tüm planlara dahil edilmiştir (ancak Free ve Go erişimi oldukça sınırlıdır).

Adım 2: Codex ile çalışmaya başlama

Codex'e tıklayın; ilk kurulum için sizi başka bir sekmeye götürecektir. “Get Started”a tıklayın ve bir sonraki adımda gösterildiği gibi kimlik doğrulama sürecini izleyin.

Adım 3: Çok faktörlü kimlik doğrulama

“Set up MFA to continue”a tıklayın ve tercih ettiğiniz kimlik doğrulama uygulamasıyla (Google Authenticator veya Authy gibi) QR kodunu tarayın. Kodu girip doğrulayın ve işlem tamam!

Adım 4: GitHub'a bağlanma

Çok faktörlü kimlik doğrulama tamamlandıktan sonra Codex'i GitHub'a bağlıyoruz.

Adım 4.1: GitHub bağlayıcısını yetkilendirme

“Connect to GitHub”, GitHub bağlayıcısını yetkilendirmek için bir açılır pencere açacaktır. Açılır pencereyi okuyun ve Yetkilendirin.

Adım 4.2: GitHub hesabınızı ekleme

GitHub bağlandıktan sonra hesabımızı eklememiz gerekir. GitHub organizasyon sekmesinde “Add a GitHub account”ı seçin. 

Bu işlem sizi “Install and Authorize”a götüren başka bir açılır pencereye yönlendirecektir. Yetkilendirmek için tıklayın; tüm depolarınız ChatGPT arayüzünde görünecektir. Yalnızca seçili depoları yetkilendirmeyi de tercih edebilirsiniz.

Adım 4.3: Ortam oluşturma

Çalışmak istediğiniz depoyu seçin ve “Create environment”a tıklayın.

Bu adım sizi “Data Controls”a götürecektir. Codex hâlâ aktif geliştirme aşamasındadır ve verilerinizin model iyileştirme için kullanılmasına izin vermenizi isteyen isteğe bağlı bir uyarı görebilirsiniz. Bunu kapatıp devam edebilirsiniz.

Artık ortamınız keşfe hazır. Codex, önceden seçilmiş görevlerle paralel olarak görevlere başlamanıza olanak tanır.

Sadece “Start tasks”a tıklayın veya gereksinimlerinize göre görevleri seçin. Bu işlem sizi, soru sorabileceğiniz veya aracı sizin için bir özellik kodlaması için görevlendirebileceğiniz bir arayüze götürecektir.

Tüm görevler hazır olduğunda, üzerinde çalışmak istediğiniz görevi seçin veya birden fazla görevi paralel yürütebilirsiniz.

Adım 5: AGENTS.md dosyası (isteğe bağlı)

AGENTS.md dosyası, özellikle Codex platformunda kod tabanınız içinde çalışan yapay zeka araçlarını yönlendirmeye yardımcı olmak için OpenAI tarafından sunulan özel bir yapılandırma dosyasıdır. Bunu, otonom araçlara yönelik talimatlara odaklanan bir geliştirici el kitabı—tıpkı bir README.md gibi—olarak düşünebilirsiniz. İşte örnek bir AGENTS.md dosyası:

# AGENTS.md

## Code Style
- Use Black for Python formatting.
- Avoid abbreviations in variable names.

## Testing
- Run pytest tests/ before finalizing a PR.
- All commits must pass lint checks via flake8.

## PR Instructions
- Title format: [Fix] Short description
- Include a one-line summary and a "Testing Done" section

Codex kod tabanınızda bir görev çalıştırdığında şunları yapar:

• Değiştirdiği dosya(lar)ı kapsayan kapsamda yer alan AGENTS.md dosyalarını arar.
• Bu dosyalardaki talimatları uygulayarak değişikliklerini biçimlendirir, test eder ve belgelendirir.
• Birden fazla dosya geçerliyse daha derin iç içe talimatlara öncelik verir (basamaklı yapılandırma gibi).

Araçlar ve API'ler arasında eyleme geçen sistemler kurmaya daha geniş bir bakış için OpenAI Agents SDK eğitimimize bakın.

OpenAI’nin Codex’i: Üç Pratik Örnek

Codex'in gerçek dünya geliştirme süreçlerinde nasıl yardımcı olabileceğini, bir depoda çalıştırdığım üç örnek üzerinden inceleyelim.

Örnek 1: Basit düzeltmeler ve yazım hataları

Codex bazen tek bir isteği alt görevlere böler: yazım hatalarını düzeltme, README'yi iyileştirme veya test yazma gibi—hepsi aynı çalışma alanı içinde.

İlk incelemeye göre mevcut bir görevin içinde yeni bir görev başlatabilir, mevcut kod tabanında değişiklik isteyebilir veya metin kutusu aracılığıyla sorular sorabilirsiniz. Görevi genişletmek veya yeni bir şeyi düzeltmek için “Code”a tıklayın ve doğrudan yeni bir alt görev başlatın.

Değişikliklerden memnun kaldığınızda “Push”a tıklayın; bu, yeni bir pull request oluşturacaktır. Birkaç saniye sonra “View Pull Request”e tıklayıp pull request'e erişebilir ve ana dala birleştirebilirsiniz.

Örnek 2: Kod tabanını açıklama

Sonraki adımda, düzenleme içermeyen bir görev için Codex'i kullandım: kod tabanını keşfetmek ve sırada ne yapabileceğimi sormak. Bu, özellikle bir projeye yeni başlayanlar, hızla uyum sağlamak isteyenler veya belirli bir fonksiyonun nasıl çalıştığını anlamakta zorlananlar için faydalıdır.

Codex projede gezindi ve kod tabanının yapısını temiz, başlangıç seviyesine uygun şekilde özetledi. Sadece dosyaları listelemek yerine, onları amacına göre grupladı:

• qwen3_demo.py'nin ana betik olduğunu, akıl yürütme modu geçişi için bir ve çok dilli çeviri için bir olmak üzere iki Gradio tabanlı arayüz başlattığını vurguladı.
• qwen3_demo.ipynb'yi etkileşimli bir notebook alternatifi olarak belirledi.
• test_qwen3_demo.py'yi birim testleri için ve README.md'yi dokümantasyon ve video yürüyüşleri için işaret etti.

Bunun ötesinde Codex, bağımlılıklar (Ollama CLI), _run_ollama fonksiyonunun rolü ve arayüzü genişletmeye yönelik ipuçları gibi “Bilinmesi Gereken Temel Noktalar”ı da listeledi. Hatta model versiyonlamayı keşfetme, arayüzü iyileştirme ve hata yönetimi ekleme gibi sonraki adımlar önerdi.

Örnek 3: Bir hatayı bulup düzeltme

Codex tüm kod tabanını tarayabilir, bir hatayı belirleyebilir, bir düzeltme önerebilir ve değişikliklerin ön izlemesini gösterebilir. Bu süreç, GitHub'daki kod değişikliği incelemelerine benzer.

Yapılan değişikliklerin arka plan sürecini anlamak için “Logs”a tıklayarak günlükleri inceleyebilirsiniz.

Codex, yapılan değişikliklerin özetini ve değişikliklerden etkilenen veya oluşturulan dosyaları döndürür. Değişikliklerle ilgili sorular sorabilir veya mevcut uygulamayı geliştirmek için Codex'ten yeni kod yazmasını isteyebilirsiniz.

Kod düzeltmelerinden memnun kaldığınızda “Push” ve “Create New PR”a tıklayarak yeni bir pull request açın.

Birkaç saniye sonra “View Pull Request”e tıklayıp pull request'e erişebilir ve ana dala birleştirebilirsiniz.

Codex, yalnızca birkaç tıklamayla değişiklikleri birleştirmeyi mümkün kılar.

Değişiklikler saniyeler içinde ana dalda görünür.

Codex Neden Önemli?

Codex pasif bir kod üreticisi değil, işbirlikçi bir araçtır. Ondan yazmasını, yeniden düzenlemesini, test etmesini, hata ayıklamasını veya açıklamasını isteyebilir; her adım için terminal günlüklerini, atıfları ve çıktıları görebilirsiniz.

Benim gözlemlediğim bazı gerçek dünya faydaları şunlardır:

• Görevler izlenebilir ve doğrulanabilir.
• Codex paralel çalışır; bu sayede birden fazla değişikliği kuyruğa alabilirsiniz.
• Özellikle bir AGENTS.md dosyasıyla kuralları yapılandırdıysanız, geliştirme kurulumunuza saygı duyar.
• İnsan PR standartlarıyla uyumludur ve CI testlerini geçebilir.

Bana göre bu, OpenAI'nin bir yazılım mühendisliği stajyeri yayınlaması gibi hissettiriyor.

Son düşünceler

Codex'in hataları nasıl düzeltebildiğini, özellik yamaları uygulayabildiğini ve kod mantığını açıklayabildiğini; tüm bunları yaparken pull request ürettiğini, testler çalıştırdığını ve eylemlerini terminal günlükleriyle ve karşılaştırmalarla belgelendirdiğini öğrendik.

Bu uygulamalı yürüyüş, Codex'in günlük geliştirici iş akışınızı nasıl iyileştirebileceğini; ister eski kodda hata ayıklayın, ister yeni bir depoya uyum sağlayın, ister bakım görevlerini triyaj edin, ortaya koyuyor.

Codex geliştikçe IDE'ler, CI boru hatları ve görev planlayıcılarıyla daha derin entegrasyonlar bekliyorum; bu da onu her mühendislik iş akışına pratik bir katkı haline getirecek. Codex hakkında daha fazla bilgi edinmek için resmi duyuru blogunu okuyun; ayrıca örnek kullanım senaryolarını OpenAI'nin YouTube kanalında bulabilirsiniz.

OpenAI'nin mühendisliğe odaklı modellerine ve araçlarına daha derinlemesine dalmak için şu blogları öneririm:

• OpenAI Codex CLI Eğitimi
• GPT-5.1 Codex Rehberi: GitHub Issue Analiz Aracı Oluşturma
• Veri İş Akışı Otomasyonu için Codex CLI: Kapsamlı Rehber
• Codex CLI MCP Eğitimi: Portföy Gösterge Paneli Aracı Oluşturma