Codex nedir: işi devrettiğin, sonucu incelediğin kodlama ajanı
Codex'in bulut ve terminal hâllerini, kurulumunu, onay seviyelerini ve iyi sonuç için gereken hazırlığı öğreneceksin.
Codex nedir sorusunun kısa cevabı: OpenAI'nin kod okuyup düzenleyen, komut çalıştıran ve değişikliği incelemene sunan kodlama ajanı [1][6]. Satır tamamlamaz, bütün görevi üstlenir [7]. İki ana çalışma biçimi var. Bulutta her görev deponun yüklendiği izole bir kapta çalışır [6][7]. Terminalde Codex CLI senin bilgisayarında çalışır [1]. Editör eklentisi ve masaüstü uygulaması da var [1]. ChatGPT hesabınla giriş yapıp Plus, Pro, Business, Edu veya Enterprise planınla kullanabilirsin [1]. Sonuç bir fark, komut kaydı ve test çıktısıdır [6][7]. Birleştirmeden önce sen incelersin.
Hızlı not: Codex'in bulut sürümü testler geçene kadar kodu düzeltip yeniden çalıştırır [7]. Zayıf test ya da belirsiz talimat verirsen, sessizce yanlış kodu başarılı diye raporlayabilir [7].
Kimin için?
Tekrarlayan kod işlerini devretmek isteyen geliştiriciler için.
Terminal, editör ya da ChatGPT içinden kod üreten ve otomasyon kuranlar için.
Codex ile Claude Code gibi ajanlar arasında seçim yapmaya çalışanlar için.
Tek ajan, dört yüz: CLI, editör, masaüstü, web
Codex CLI, bilgisayarında yerel çalışan bir kodlama ajanıdır [1].
VS Code, Cursor veya Windsurf kullanıyorsan editör eklentisini kurabilirsin [1].
Masaüstü deneyimi için terminalde codex app komutu var [1]. Bulut tabanlı Codex Web ise chatgpt.com/codex adresinde [1].
Bulut sürümüne ChatGPT içinden görev verirsin [7]. Arayüzde "Kodla" ile görev atar, "Sor" ile kodun hakkında soru sorarsın [3].
- CLI: terminalde, yerel, onay kontrollü [1][6]
- Editör eklentisi: düzenleme, test ve hata düzeltme kodu yazdığın yerde [6]
- Masaüstü uygulaması: proje bazlı iş parçacıkları ve görsel farklar [5]
- Web/bulut: paralel arka plan görevleri ve PR üretimi [6]
Codex adı yeni değil. 2021'deki ilk Codex, GPT-3'ün kodla ince ayarlanmış sürümüydü ve 2023'te kullanımdan kaldırıldı [7].
Bulut mu terminal mi: karar kuralı
Bulut modunda her görev için deponun yüklendiği ayrı bir kap açılır [6]. Görev başladıktan sonra kabın internet erişimi yoktur [7].
CLI modunda kod senin makinende kalır [6]. Kaynağa göre API'ye yalnız istemler ve üst düzey bağlam gider [6].
Bulut görevleri çoğunlukla 1 ile 30 dakika arasında biter [3][7].
- İşi devredip uzaklaşacaksan: bulut [6]
- Aynı anda birden çok görev çalıştıracaksan: bulut [6][7]
- Hassas bir depo üzerinde çalışıyorsan: CLI [6]
- Hızlı deneme-düzeltme yapacaksan: CLI, ağır işleri sonra buluta ver [6]
Codex CLI'yi tek komutla kur ve ChatGPT ile giriş yap
Mac ve Linux'ta kurulum betiğini, Windows'ta PowerShell komutunu çalıştırırsın [1].
npm veya Homebrew de kullanabilirsin [1]. Sonra codex yazman yeterli [1].
İlk açılışta "Sign in with ChatGPT" seçeneğini seç [1]. API anahtarıyla kullanmak da mümkün ama ek kurulum ister [1].
- Kurulum komutunu çalıştır [1]
- Terminalde codex yaz [1]
- Sign in with ChatGPT seç [1]
- Bir proje klasöründe ilk görevi ver
# Mac / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
# npm
npm install -g @openai/codex
# Homebrew
brew install --cask codex
# Başlat
codexPlan kapsamı değişebilir. 2025 tarihli bir haberde Codex yalnız Pro, Enterprise ve Team abonelerine açıktı [3]; GitHub sayfası bugün Plus, Pro, Business, Edu ve Enterprise planlarını sayıyor [1].
Onay seviyesini işin riskine göre seç
CLI'de ajanın ne kadar serbest çalışacağını sen belirlersin [6].
Kaynak üç seviye sayıyor [6]. Güvenlik arttıkça hız düşer.
- Suggest (varsayılan): her düzenleme ve komut senin onayınla çalışır [6]
- Auto Edit: dosyaları kendisi değiştirir, terminal komutundan önce sorar [6]
- Full Auto: ağı kapalı bir çalışma alanında okur, yazar ve çalıştırır [6]
Yeni bir depoda Suggest ile başla. Ajanın ne yaptığını gördükçe Auto Edit'e geç.
AGENTS.md ve testler sonucun kalitesini belirler
Codex depoda AGENTS.md dosyası arar [7]. Bu dosya testlerin nasıl çalışacağını ve hangi kurallara uyulacağını söyler [7].
Test komutunu açık yazarsan ajan daha çok görevi ilk denemede doğru yapar [7]. Belirsiz bırakırsan tahminle deneme harcar [7].
Bulut sürümü testler geçene kadar düzelt-çalıştır döngüsünde kalır [7]. Testin zayıfsa döngü yanlış koda "tamam" der [7].
- AGENTS.md'ye test komutunu yaz [7]
- Kod kurallarını ve proje yapısını ekle [7]
- Görevi tek ve net bir iş olarak ver
- Dönen farkı ve komut kaydını incele [7]
# AGENTS.md
## Testleri çalıştırma
- Test komutu: <buraya projenin test komutu>
- Lint komutu: <buraya lint komutu>
- Bir değişiklik ancak tüm testler geçince bitmiş sayılır.
## Kod kuralları
- <isimlendirme, klasör yapısı, stil kuralları>
- Yeni bağımlılık eklemeden önce gerekçesini yaz.
## Proje yapısı
- <ana klasörler ve ne işe yaradıkları>Bağlam dolmadan yeni iş parçacığı aç
Masaüstü uygulaması bağlam penceresinin ne kadar dolduğunu küçük bir daireyle gösterir [5].
Kaynağa göre bağlam yüzde 70-80 civarına gelince performans düşmeye başlar [5]. O noktada yeni bir iş parçacığı aç.
Uygulamada her projenin kendi alanı var [5]. Birinde görev çalışırken diğerine geçebilirsin [5].
- Automations: tekrarlayan görevler, örneğin son commit'lerde hata taraması [5]
- Skills: modele kalıcı bilgi ya da işlem öğretme [5]
- MCP sunucuları: Notion gibi araçlara bağlanma [5]
- Work Trees: birden çok dalda çakışmadan çalışma [5]
Şubat 2026 tarihli incelemede masaüstü uygulaması yalnız macOS'taydı [5].
Adım adım
- Bulut mu yerel mi çalışacağına deponun hassasiyetine göre karar ver [6].
- Codex CLI'yi kur ve ChatGPT hesabınla giriş yap [1].
- Projene test komutunu ve kuralları anlatan bir AGENTS.md ekle [7].
- İlk görevi Suggest onay seviyesinde ver [6].
- Gereksinimleri madde madde yaz; kısıtları da ekle [5].
- Dönen farkı, komut kaydını ve test çıktısını incele [6][7].
- Bağlam yüzde 70-80'e yaklaşınca yeni iş parçacığı aç [5].
Örnek: Örnek: gereksinim listesinden çalışan Java CLI projesine
- Bir geliştirici otomat makinesi CLI uygulaması için gereksinimleri madde madde yazdı [5].
- Listeye kısıtlar da girdi: tek modüllü Maven, dış bağımlılık yok, UI ile iş mantığı ayrı [5].
- Listeyi Codex masaüstü uygulamasına yapıştırıp görevi başlattı, bu sırada başka işe geçti [5].
- Birkaç dakika sonra core ve ui paketlerine ayrılmış proje çıktı; testler ilk çalıştırmada geçti [5].
- Sonra null güvenliği için JSpecify eklemesini istedi; Codex bağımlılığı ve paket dosyalarını ekledi [5].
- Commit mesajını boş bırakıp değişikliklere göre otomatik üretilmesine izin verdi [5].
Sık yapılan hatalar
Projede test olmadan ya da zayıf testlerle görev vermek. Önce kabul kriterini test olarak yaz; ajan doğruluğu testten öğrenir [7].
Test komutunu ve kuralları ajana anlatmamak. AGENTS.md'ye test komutunu, kuralları ve proje yapısını ekle [7].
Sonucu incelemeden birleştirmek. Codex hata yapabilir; farkı ve komut kaydını okuyup öyle onayla [3][7].
Hassas bir depoda en geniş yetkiyle başlamak. Suggest seviyesinde başla, güven oluştukça yetkiyi artır [6].
Tek iş parçacığında bağlamı sonuna kadar doldurmak. Bağlam göstergesi yüzde 70-80'e gelince yeni iş parçacığı aç [5].
Kontrol listesi
- Bulut ya da CLI seçimini deponun hassasiyetine göre yaptım.
- ChatGPT hesabımla giriş yaptım ve planımın Codex'i kapsadığını kontrol ettim.
- Depoda test komutunu içeren bir AGENTS.md var.
- Onay seviyesini bilerek seçtim.
- Her görevin farkını ve test çıktısını okuyup onaylıyorum.
- Bağlam doluluğunu takip ediyorum.
Bugün şunu yap
- Codex CLI'yi kur ve codex komutuyla aç.
- Küçük bir projende AGENTS.md dosyası oluştur.
- Sıkıcı bir işi, örneğin bir isim değişikliğini, Suggest seviyesinde ver.
- Dönen farkı satır satır oku ve testleri kendin bir kez çalıştır.
- Bir sonraki görev için gereksinimleri madde madde yaz.
Sıkça Sorulan Sorular
ChatGPT Codex ne işe yarar?
Küçük özellikler yazar, hata düzeltir, kod hakkında soruları cevaplar ve testleri çalıştırır [3]. Bu işleri aynı anda paralel yürütebilir [3][7]. Sonunda incelemen için fark ve komut kaydı döner [7].
Codex gibi uygulamalar nelerdir?
Kaynaklarda anılan benzer araçlar arasında terminal tabanlı Claude Code [5] ve GitHub Copilot var [7]. Copilot'un ilk sürümü 2021'deki eski Codex modeliyle çalışıyordu [7].
Yapay zeka kodlama nedir?
Ajan tabanlı yapay zeka kodlamada araç sadece sonraki satırı tamamlamaz [7]. Dosyaları okur, plan yapar, kodu düzenler, test çalıştırır ve sonuç yeşil olana kadar tekrarlar [7]. Sonunda insanın inceleyeceği bir değişiklik teslim eder [7].
5 maddede özet
- Tanım: Codex, OpenAI'nin kod okuyan, düzenleyen ve test çalıştıran kodlama ajanıdır [1][6].
- Yüzeyler: CLI, editör eklentisi, masaüstü uygulaması ve web/bulut sürümü var [1].
- Karar: Paralel ve devredilen iş için bulut, hassas depo ve kontrol için CLI [6].
- Hazırlık: AGENTS.md'de test komutu ve kurallar sonucu iyileştirir [7].
- Kontrol: Fark ve komut kaydını incelemeden birleştirme; ajan hata yapabilir [3][7].
Kaynaklar
- GitHub - openai/codex: Lightweight coding agent that runs in your terminal · GitHub · github.com
- OpenAI Codex yapay zeka kod yazma aracı çıktı! Nasıl kullanılır? - Hardware Plus - HWP · hwp.com.tr
- I Tried OpenAI's New Codex Agent. Here are my First Impressions (It's Really Good) · danvega.dev
- What Is OpenAI Codex? The Guide to AI-Powered Coding (2026) · deepstation.ai
- How OpenAI Codex Works, the codex-1 Coding Agent · theaiengineer.substack.com
Bu rehber yukarıdaki kaynakların 2 Kasım 2026 tarihli derlemesidir; fiyat ve sürüm gibi bilgiler değişebilir, güncelini kaynağından kontrol et.
Nasıl hazırlandı: Bu rehberi yukarıdaki kaynaklardan yapay zeka yardımıyla derledik. Her somut bilgiyi kaynağıyla karşılaştırıp denetledik.