2026'da Codex'te Uzmanlaşma Rehberi (Geliştirici Kursu)

Claude Code'u 12 ay kullandım. Sonra 30 gün boyunca Codex'e geçtim.

İşte bulduklarım

Codex'in 2026'da Gerçekte Ne Olduğu

Çoğu insan hâlâ Codex'in daha akıllı bir otomatik tamamlama aracı olduğunu düşünüyor. Öyle değil.

Codex, tam bir aracı yazılım geliştirme platformudur. Kod tabanınızı okur, kod yazar ve test eder, pull request'leri inceler, Mac masaüstünüzü kontrol eder, web'de gezinir, görseller oluşturur, tekrarlayan görevleri planlar ve tercihlerinizi oturumlar arasında hatırlar.
Bunun gerektirdiği zihinsel değişim önemlidir. Kod yazan kişi olmayı bırakırsınız. Hiç uyumayan bir kıdemsiz mühendis ekibi tarafından yazılan kodu inceleyen kişi olursunuz.

Çoğu geliştirici Codex'i kurar, iki hafta boyunca tek satırlık komutlar gönderir, vasat sonuçlar alır ve pes eder. Hiçbir zaman AGENTS.md kurmazlar.

Hiçbir zaman bir Skill yazmazlar. Alt-ajanları kullanmazlar. Yüzey alanının %5'ini kullanır ve aracı o %5'e göre değerlendirirler.

Bu kurs diğer %95'i kapsar.

Beş Yüzey

Bir şey kurmadan önce, Codex'in nerede yaşadığını anlayın. Seçtiğiniz yüzey, çalışmasını ne kadar yakından takip ettiğinizi ve kodun nerede çalıştığını belirler.

CLI, betikleştirilmiş iş akışları, tek görevli işler ve başsız otomasyon içindir. Kodunuz, siz göndermediğiniz sürece makinenizden asla ayrılmaz. Açık kaynak, Rust ile oluşturulmuş, macOS, Windows ve Linux üzerinde çalışır.

IDE eklentisi, hassas dosya bağlamıyla etkileşimli düzenleme içindir. VS Code, Cursor, Windsurf veya JetBrains'e kurulur. Ayrı bir giriş olmadan CLI kimlik doğrulamanızı kullanır.

Masaüstü uygulaması, çok iş parçacıklı iş akışlarının, uygulama içi tarayıcının, Bilgisayar Kullanımı'nın, Hedef modunun, Appshots'ların ve Otomasyonların evidir. Şubat 2026'da macOS'ta ve 4 Mart 2026'da Windows'ta kullanıma sunuldu.

Cloud, eşzamansız arka plan görevleri, paralel PR'ler ve siz uyurken çalışma içindir. Görevler, GitHub deponuzla önceden yüklenmiş korumalı alan konteynerlerinde çalışır. Yerel makinenizde hiçbir şeyi engellemez.

Uygulama içi tarayıcı ve Bilgisayar Kullanımı, UI doğrulama, ön uç yineleme ve uçtan uca test içindir. Codex, yerel geliştirme sunucunuzu açar, onunla etkileşime girer, sonucu ekran görüntüsü alır ve kod değişikliklerinin doğru görsel çıktıyı ürettiğini doğrular.

Gerçek bir iş akışı birden çok yüzey kullanır:

CLI, betikleştirilmiş işler için
IDE, etkileşimli özellik çalışması için
Cloud, izlemeniz gerekmeyen paralel görevler için
Uygulama, Hedef odaklı, uzun süreli görevler için

Bir yüzey seçerken ana faktör, ajanın çalışmasını ne kadar yakından takip etmek istediğinizdir. Değişiklikler yapılırken izlemek istiyorsanız, CLI veya IDE işi makinenizde ve önünüzde tutar. Daha uzun bir oturumu devredip sonunda incelemeyi tercih ediyorsanız, Cloud doğru seçimdir.

Zihinsel Model: Ajan, Otomatik Tamamlama Değil

Yüzeyler netleştiğine göre, bir sonraki değişim çalışma birimini anlamaktır.

Çalışma birimi bir tur değil, bir görevdir. Çıktı bir sohbet yanıtı değil, bir PR'dir.

Daha az "X'i yapan bir fonksiyon yaz" ve daha çok "Y özelliğini uygula, işte kısıtlamalar, bitince testleri çalıştır" şeklinde düşünün.

Her Codex görevi aynı iç döngüyü izler. Codex, görevinizi ve bağlamı okur, dahili bir plan oluşturur, adım adım yürütür ve kendi çalışmasını kontrol eder.

Codex'i bir kodlama asistanı olarak düşünmeyi bırakın. Onu sabah bilgilendirdiğiniz ve öğleden sonra incelediğiniz bir kıdemsiz mühendis ekibi olarak düşünmeye başlayın.

Bunun pratikteki gerçek bir örneği: WorkOS'taki geliştiriciler artık sabah kahvelerini almadan önce dört ila beş Codex görevi sıraya koyuyorlar. Tekrar oturduklarında, daha önce günlerinin yüzde 30 ila 40'ını tüketen bakım işlerini yapan, incelemeyi bekleyen iki ila üç tamamlanmış PR buluyorlar.

Mayıs 2026 itibarıyla mevcut modeller:

GPT-5.5 (varsayılan) — çoğu görevi halleder, aynı gecikme süresine sahiptir ancak aynı iş için önemli ölçüde daha az jeton kullanır
GPT-5.3-Codex — uzun otonom çalışmalar, büyük yeniden düzenlemeler ve paralel bulut dağıtımı için özel olarak oluşturulmuştur; önceki Codex uzmanından %25 daha hızlıdır
GPT-5.5 Pro — en yüksek muhakeme; yalnızca Pro, Business ve Enterprise planlarında
Codex Mini — ChatGPT Free'de kalıcı olarak ücretsizdir; öğrenmek için uygundur

Codex'i varsayılan olarak GPT-5.5'te bırakın. Codex'in uzun süre otonom olarak çalıştığı büyük aracı görevler için GPT-5.3-Codex'e geçin.

Başlarken: İlk Gerçek Oturumunuz

Çalışan bir Codex oturumuna giden en hızlı yol beş adımı izler. Fizzbuzz öğreticisini unutun. Gerçek bir kod tabanında başlayın.

Adım 1: CLI'yi kurun.

Adım 2: Gerçek bir proje açın.

Zaten aşina olduğunuz düşük riskli bir depoya gidin. Bu önemlidir.

Codex, çıktıyı tanıyabildiğinizde ve hataları yakalayabildiğinizde daha iyi performans gösterir. İlk oturumda bilinmeyen bir kod tabanında çalışmak öngörülemeyen sonuçlar üretir.

İstendiğinde ChatGPT hesabınızla oturum açın. Tarayıcınız otomatik olarak açılır. Devam'a tıklayın ve terminale dönün.

Adım 3: Başka bir şey yapmadan önce /init'i çalıştırın.

Çoğu öğreticinin atladığı şey bu tek komuttur. Codex, dizininizi ve Git geçmişinizi tarar, dilleri, çerçeveleri, derleme komutlarını ve test komutlarını tanımlar ve bulduklarıyla doldurulmuş bir AGENTS.md dosyası oluşturur.

Oluşturulan dosyayı inceleyin, yanlış olan herhangi bir şeyi ayarlayın ve işleyin. Bu projedeki her gelecekteki Codex oturumu onu otomatik olarak okuyacaktır.

Adım 4: Codex'e bir yönlendirme görevi verin.

Değiştirmesi için bir şey vermeden önce kod tabanını açıklamasını isteyin. Bu, hangi bağlamı yüklediğine dair güveninizi oluşturur:

Çıktıyı okuyun. Gerçek kod tabanınızı doğru bir şekilde tanımlıyorsa, ihtiyaç duyduğu bağlama sahiptir. Belirsiz veya yanlışsa, AGENTS.md'nizin daha fazla ayrıntıya ihtiyacı vardır.

Adım 5: Küçük, gerçek bir görev verin. Somut ve sınırlı bir şey seçin.

Bu, Codex komutunun doğru şeklidir: belirli dosya bağlamı, beklenen sonuç, kısıtlamalar ve tanımlanmış bir doğrulama adımı. Döndürdüğü farkı inceleyin. Artık Codex'i doğru kullanıyorsunuz.

Adım 6: Masaüstü uygulamasını kurun. OpenAI web sitesinden indirin. Aynı ChatGPT hesabıyla oturum açın.

Adım 7: IDE eklentisini kurun. Düzenleyicinizin eklentiler panelinde "OpenAI Codex"i arayın. CLI kimlik doğrulamanızı otomatik olarak okur.

Adım 8: GitHub'ı bağlayın. Codex uygulaması içindeki Ayarlar'a gidin ve GitHub hesabınızı bağlayın. Bulut görevlerini kullanmadan önce en az bir depo bağlayın.

Öğelerin bulunduğu yerler:

~/.codex/config.toml : ana yapılandırma: onay modu, korumalı alan modu, MCP sunucuları, varsayılan modeller
~/.codex/AGENTS.md : kişisel AGENTS.md, tüm projeler için geçerlidir
<proje>/AGENTS.md : proje düzeyinde talimatlar
<proje>/.agents/skills/ : proje düzeyinde Beceriler
<proje>/.codex/config.toml : proje kapsamlı yapılandırma (yalnızca güvenilir projeler)

AGENTS.md: Deponuzdaki En Önemli Dosya

Artık çalışan bir oturumunuz var, bir sonraki adım her gelecek oturumun aynı kalitede başlamasını sağlamaktır. AGENTS.md'nin yaptığı şey budur.

AGENTS.md, vasat Codex çıktısını tutarlı, yüksek kaliteli çıktıdan ayıran tek dosyadır.
Deponuzun kökünde düz bir Markdown dosyasıdır. Projenizde her Codex oturumu başladığında, ajan başka bir şey yapmadan önce onu otomatik olarak okur.
Açık bir standarttır. Codex, Cursor, Gemini CLI, Windsurf ve GitHub Copilot'un tümü onu okur. Bir kez yazın ve araç zincirinizdeki her ajan aynı gerçeklik kaynağını okur.

Çözümleme sırası: Codex, ~/.codex/AGENTS.md (ev düzeyi, tüm projeler) artı <proje>/AGENTS.md (proje düzeyi) dosyalarını okur. AGENTS.override.md dosyaları her düzeyde önceliklidir. Birleşik sınır 32 KiB'dir.

İçerik:

Yığın, çerçeveler, dil sürümleri, paket yöneticisi
Tam derleme, test ve geliştirme komutları; kopyalanıp yapıştırılabilir, "normal testleri çalıştır" değil
Dosya yapısı kuralları ve adlandırma kuralları
Stil ve desen kuralları
Yasak bölgeler: dokunulmaması gerekenler
Gönderim gereksinimleri: CI, PR kuralları, dağıtım mekanizması

İçerik:

Sırlar veya kimlik bilgileri (dosya sürüm kontrolündedir)
Belirsiz yönergeler ("temiz kod yaz" bir ajan için hiçbir şey ifade etmez)
README'nizi kopyalayan belgeler

500 kelimenin altında tutun. Şişkinlik, yararlı bağlamı modelin çalışma belleğinin dışına iter.

Çalışan bir şablon:

Codex'in onu okuduğunu doğrulayın: şu anda yüklenen talimatları özetlemesini isteyin
Büyük monorepolar için, alt dizinlerin içine ek AGENTS.md dosyaları yerleştirin.
packages/api/AGENTS.md konumundaki bir dosya, bu paketin içindeki görevler için kök düzeyindeki dosyaya göre önceliklidir.
Proje düzeyinde .codex/config.toml dosyasını etkinleştirmek için codex trust . komutunu çalıştırın. Bu, kötü amaçlı kopyalanmış bir deponun Codex'i arkanızdan yapılandırmasını önler.

CLI Derinlemesine

AGENTS.md kurulduğuna göre, şimdi ustalaşılması gereken bir sonraki şey CLI'nin kendisidir. Çoğu kullanıcı yalnızca codex yazmayı bilir ve onu gerçekten güçlü kılan komutları kaçırır.

Gerçek günlük kullanımın %95'ini kapsayan dört komut vardır.

codex, kod tabanınızla keşif, yineleme ve ileri geri konuşma için etkileşimli modu açar.

codex exec "<görev>" Codex'i etkileşimsiz olarak çalıştırır. stdout'a akış yapar ve bittiğinde çıkar. Bu, betikleştirilebilir her şey için güçlü araçtır:

Exec'i git kancalarına, CI ardışık düzenlerine ve cron işlerine bağlayın. Otomatikleştirilmiş her şey için yapı taşıdır.

codex resume --last tam olarak kaldığınız yerden devam eder. Her oturum saklanır:

codex cloud, aşağıdaki Cloud bölümünde ele alınan eşzamansız bulut görevlerini yönetir.

Kullanışlı bayraklar:

--json : diğer araçlara yönlendirmek için JSONL olay akışı
--model <ad> : GPT-5.5 veya GPT-5.3-Codex'i seçin
--reasoning <seviye> : düşük, orta veya yüksek
--search : görev sırasında web aramasına izin ver
-C <dizin> : farklı bir çalışma dizininde çalıştırın
--sandbox <mod> : bu oturum için korumalı alan modunu geçersiz kıl
--approval <politika> : bu oturum için onay politikasını geçersiz kıl

Korumalı Alan ve Onaylar

CLI size güç verir. Korumalı alan, Codex'in sormadan bu gücün ne kadarını kullanabileceğini kontrol eder. Bunu doğru ayarlamak, iş akışınızı risk oluşturmadan hızlı tutar.

Korumalı alan, Codex'in ne yapıp ne yapamayacağını kontrol eden sınırdır. Doğru ayarlamak sürprizleri önler.

Üç korumalı alan modu:

workspace-write (varsayılan) : çalışma alanı içinde okuma ve yazma, rutin komutlar, izin verilmedikçe ağ yok. Bunu neredeyse her zaman kullanın.
read-only : yalnızca okuma, yazma yok, kabuk yok. Kod incelemesi ve keşif için kullanın.
danger-full-access : kısıtlama yok. Neredeyse hiç kullanmayın. Test edilmiş, doğrulanmış otomasyonlar için saklayın.

İki onay politikası:

untrusted — güvenilmeyen her komuttan önce sorar. Öğrenirken veya bilinmeyen bir projede çalışırken kullanın.
on-request (varsayılan) — rutin korumalı alan komutlarını otomatik olarak onaylar, korumalı alan sınırını aşan her şeyden önce sorar.

auto_review, AGENTS.md dosyanıza göre otomatik olarak onaylayan veya reddeden bir inceleyici alt ajandır.

config dosyasında approvals_reviewer = "auto_review" ile etkinleştirin. Her adımda bebek bakıcılığı yapmak istemediğiniz uzun eşzamansız görevler ve Hedef modu için iyi çalışır.

Sizi sürekli rahatsız eden komutları ekleyin. Asla yıkıcı hiçbir şey eklemeyin.

Codex'i Etkili Bir Şekilde Komut Verme

Korumalı alan yapılandırıldı, oturumlar çalışıyor. Bir sonraki kaldıraç, çıktı kalitesi üzerinde diğer tüm değişkenlerden daha fazla etkiye sahip olan komut kalitesidir.

Codex çıktı kalitesindeki en büyük kaldıraç komut yapısıdır. Belirsiz komutlar belirsiz kod üretir.

Çerçeve: Söyle, Göster, Tanımla, Hatırlat.

İstediğiniz sonucu söyleyin, yöntemi değil
Örnek girdiler ve beklenen çıktıları gösterin
Kullanılacak API'leri, kütüphaneleri ve desenleri tanımlayın
AGENTS.md'deki kuralları hatırlatın

Her seferinde dördüne de ihtiyaç yoktur. Küçük bir hata düzeltmesi yalnızca Söyle ve Hatırlat gerektirebilir. Yeni bir özellik genellikle dördünü de ister.

Tek değişiklik kuralı: Codex, tek bir şeyde beş şeyden çok daha iyi performans gösterir. "Kimlik doğrulama hatasını düzelt, test ekle, kullanıcı deposunu yeniden düzenle ve README'yi güncelle" bir yazı tura atışıdır. Aynı işi dört komuta bölmek güvenilirdir.
Önemsiz olmayan herhangi bir şey için önce bir plan talep edin: "önce bir plan çıkar, onaylayana kadar kod yazma." Bir planı otuz saniye incelemek, yanlış bir uygulamayı otuz dakika hata ayıklamaktan iyidir.
Başarısızlık davranışını açıkça belirtin. Kendi haline bırakıldığında, Codex testleri her yolla geçirecektir:

Bağlamı açıkça sınırlayın. Okunacak belirli dosyaları adlandırın. "Başka hiçbir şeyi okuma veya değiştirme. Başka bir yerden bilgiye ihtiyacın olursa, bana sor."

Muhakeme çaba seviyeleri:

Düşük : önemsiz düzenlemeler, biçimlendirme, basit yeniden düzenlemeler
Orta (varsayılan) : çoğu özellik çalışması ve hata düzeltmeleri
Yüksek : mimari kararlar, zor hata ayıklama, büyük çok dosyalı yeniden düzenlemeler

Hedef Modu

Tek görevli komut verme doğal hissettirdiğinde, bir sonraki seviye Codex'e çok günlük bir hedef vermek ve işi kendisinin sıralamasına izin vermektir.

Hedef modu, görev görev brifing vermek için çok büyük ancak tek bir hedef için yeterince tutarlı olan işler içindir. Mayıs 2026'da kararlı hale geldi.

Çalışan bir Hedef'i şu komutlarla yönetin:

codex goal status : aktif Hedefleri ve ilerlemelerini görün
codex goal logs <id> : Codex'in şu ana kadar ne yaptığını inceleyin
codex goal pause <id> : yürütmeyi durdurun ve girdinizi bekleyin
codex goal resume <id> : kaldığı yerden devam edin
codex goal cancel <id> : Hedefi durdurun ve iptal edin

Sınırlı Hedeflerle başlayın. Codex'in hedeflerinizi nasıl yorumladığına güvenene kadar "En fazla 5 PR." Kontrolden çıkmış bir Hedefin güvenle yanlış şeyi yapması en kötü durum sonucudur.

Her zaman şunlarla sınırlayın: maksimum PR'ler, PR başına maksimum kod satırı, PR'ler arasında CI kapıları ve net durdurma koşulları. AGENTS.md'de kapsanmayan herhangi bir mimari kararda duraklatın. Herhangi bir bozucu API değişikliğinde duraklatın.

Beceriler: Yeniden Kullanılabilir İş Akışları

Hedef modu büyük girişimleri halleder. Beceriler, her projede ortaya çıkan yinelenen mikro iş akışlarını halleder. Aynı talimatları oturumlar arasında tekrarlarken bulursanız, bu bir Beceri yazma sinyalinizdir.

Beceri, bir dizin olarak paketlenmiş yeniden kullanılabilir bir iş akışıdır: bir SKILL.md dosyasındaki talimatlar ve isteğe bağlı kaynaklar ve betikler.

Codex, Becerileri ada ve açıklamaya göre keşfeder. Tam talimatları yalnızca bir görev Beceriyi tetiklediğinde yükler. Biri tetiklenene kadar sıfır bağlam maliyetiyle 50 Beceriniz olabilir.

Becerilerin bulunduğu yerler:

Kişisel : $HOME/.agents/skills/ : projeler arası, depodan bağımsız olarak nasıl çalıştığınızı yansıtır
Ekip : depo içindeki .agents/skills/ : projeye özgü, sürüm kontrollü, işbirlikçilerle paylaşılır

SKILL.md biçimi:

Her güç kullanıcısının önce yazması gereken üç Beceri:

open-pr, standart PR iş akışıdır: dalı kontrol et, gönder, yapılandırılmış bir gövdeyle PR oluştur, etiketler uygula ve inceleme talep et. Günlük işlerde en çok kullanılan Beceri.
new-feature, PRD'yi ve AGENTS.md'yi okur, yeniden kullanılacak mevcut bileşenleri belirler, bir plan çıkarır, onay bekler, uygular, test eder ve open-pr Becerisi aracılığıyla bir PR açar. PRD'de belirsiz olan herhangi bir şey varsa, kod oluşturmadan önce sorar.
investigate, teşhis etmeden düzeltmeyen Beceridir. Yeniden üretmeyi onaylar, ilgili kod yollarını okur, bir hipotez oluşturur ("X'in Y yüzünden olduğuna inanıyorum") ve hipotezi ve doğrulama planını Markdown olarak çıkarır. Bir düzeltme uygulamaz. Çıktı, kod değil anlayıştır.

investigate Becerisi önemlidir çünkü Codex, izin verirseniz her seferinde temel neden analizini atlayacaktır. Doğrudan bir düzeltmeye atlayacak ve bu düzeltme genellikle yanlış olacaktır. Önce araştırmayı zorunlu kılmak, hata ayıklama çıktı kalitesine yapılan en büyük tek iyileştirmedir.

Becerilerinizin yüklendiğini doğrulayın: mevcut becerileri listele

Alt-Ajanlar ve Paralellik

Beceriler, tekrarlanabilir iş akışlarınızı halleder. Alt-ajanlar, paralel olanları halleder. Ayrım önemlidir çünkü yanlış yapılan paralellik, çözdüğünden daha fazla sorun yaratır.

Alt-ajan, ayrı, izole edilmiş bir ajan örneğidir. Kendi bağlamında çalışır, bir özet döndürür ve bağlamı atılır. Ana ajanın bağlamında çalışan bir Beceri'den farklıdır.

Alt-ajanların doğru araç olduğu üç desen:

Keşif : 30 dosyayı okumak ve özetlemek için bir alt-ajan başlat; okuma onun bağlamında gerçekleşir, sizinkinde değil
Paralel uygulama : her biri kendi bağlamı ve planı olan beş eşzamanlı alt-ajan olarak beş bağımsız özellik
Doğrulama : yeni bir inceleyici alt-ajan, kodu yeni yazmış olmanın önyargısına sahip değildir

Özel alt-ajanlar, .codex/agents/<ad>.md içinde tanımlanır:

Alt-ajan adresleme Mart 2026'da kullanıma sunuldu. @<takma_ad> ile çalışan bir alt-ajanla takma adıyla konuşun.
Birkaçı paralel olarak çalışırken birini diğerlerini rahatsız etmeden yönlendirmek istediğinizde kullanışlıdır.
Yelpaze deseni: bağımsız görevlerde paralel olarak N tane alt-ajan başlatın ve sonuçları geri toplayın.
Beş görev, en yavaş olanın sürdüğü sürede tamamlanır. Temel kural: bir görev ana bağlamda 30 saniyeden az sürüyorsa, orada yapın.

Masaüstü Uygulaması: Her Şey İçin Codex

Alt-ajanlar ve Beceriler, CLI, IDE eklentisi ve masaüstü uygulamasında eşit derecede iyi çalışır. Ancak masaüstü uygulaması, CLI eşdeğeri olmayan özelliklerin yaşadığı yerdir.

16 Nisan 2026'daki "Codex for (neredeyse) everything" güncellemesi, masaüstü uygulamasını bir kodlama aracından tam bir geliştirici iş istasyonuna dönüştürdü.

Bilgisayar Kullanımı

Codex, Mac'inizi çalıştırır: tıklama, yazma, kaydırma, uygulamaları açma, menülerde gezinme ve imleç odağını çalmadan sizinle birlikte çalışma.

Öldürücü kullanım, davranışsal doğrulamadır. Birim testleri geçer ancak UI hala bozuktur.
Bilgisayar Kullanımı, Codex'in geliştirme sunucusunu açmasına, ilgili akışta tıklamasına ve sonucu ekran görüntüsü almasına izin vererek bu boşluğu kapatır.
Etkinleştirmek için Codex Ayarları, Bilgisayar Kullanımı, Kur'a gidin. macOS istediğinde Ekran Kaydı ve Erişilebilirlik izinlerini verin. Herhangi bir komuttan çağırın:

Kilitli bilgisayar kullanımı, Codex'in ekranınız kilitlendikten sonra masaüstü uygulamalarını çalıştırmaya devam etmesine izin verir. Ayarlar'da Bilgisayar Kullanımı altında etkinleştirin. Yatmadan önce bir görev başlatın, makinenizi kilitleyin, sonuçları sabah inceleyin.

Appshot'lar

Command-Command tuşlarına basın ve en öndeki macOS penceresi doğrudan Codex iş parçacığınıza gider.

Codex, ekran görüntüsünü, görünür metni ve erişilebilirlik metnini yakalar; genellikle ekran dışına kaydırılmış içerik dahil.

Appshot'lar olmadan: bir hata görün, Codex'e geçin, bir soru yazın, ekran görüntüsü alın, sürükleyin, daha fazla bağlam yazın. Yarım dakikalık sürtüşme.
Appshot'larla: hatayı görün, Command-Command tuşlarına basın, sorunuzu sorun. Beş saniye.

Son 60 saniye içinde bir Codex iş parçacığıyla etkileşime girdiyseniz, Appshot bu sohbete gider.

Aksi takdirde yeni bir iş parçacığı açar. Bir oturumdaki birden çok Appshot, bir iş parçacığında yığılır. Ekran Kaydı ve Erişilebilirlik izinleri gerektirir.

Uygulama İçi Tarayıcı

Uygulama içi tarayıcı, bir sayfa önizlemesi değil, yerel bir aracı tarayıcıdır. Yerel geliştirme sunucunuzu açar, tıklar, formları doldurur, DOM durumunu inceler, ekran görüntüleri alır ve az önce yazılan yamanın görsel hatayı düzelttiğini doğrular.

İçinde yerel bir geliştirme sunucusu açın, ardından işlenmiş öğelere doğrudan doğal dil yorumları ekleyin.
Öğenin üzerine "bu düğmeyi 20 piksel daha uzun yap" yazın ve Codex, kod tabanınızda değişikliği yürütür ve sayfayı yeniden yükler.
Uygulama içi tarayıcı, pencere yönetimi yükü olmadan doğrudan DOM erişimi sağlar ve gerçek tarayıcınızdan korumalı alana alınmıştır.

Bellek

Bellek, Codex'in bağlamı oturumlar arasında tutmasını sağlar.

Her oturum bittikten sonra Codex, etkileşimi özetler ve ~/.codex/memories/ dizinine yazar.
Bir sonraki oturumda, komutunuzu yüklemeden önce bu dosyaları okur.
Codex, tercih ettiğiniz işleme mesajı biçimini, test çerçevelerini, mimari desenleri ve geçen sefer yaptığı hataları öğrenir; bu bağlamın hiçbirini tekrarlamanıza gerek kalmadan.
Ayarlar'dan etkinleştirin veya config.toml dosyasında [features] altına memories = true ekleyin.

90 Artı Eklenti Ekosistemi

Eklentiler, Becerilerin, MCP'lerin ve entegrasyonların küratörlü paketleridir. codex plugins install <ad> ile kurun.

Ana eklenti kategorileri:

Proje yönetimi : Linear, JIRA, GitHub
CI/CD : CircleCI, Vercel, GitHub Actions
Veritabanları : Neon, Postgres, PlanetScale
Kod kalitesi : Sentry, CodeRabbit
Üretkenlik : Notion, Remotion

Yalnızca günlük kullandığınız araçlar için kurun. Mümkün olduğunda proje bazında kapsam belirleyin. Üç ayda bir denetleyin. Her eklenti, kullanmasanız bile bağlam jetonlarına mal olur.

Codex Cloud: Ölçekte Eşzamansız Çalışma

Masaüstü uygulaması, yerel ve etkileşimli çalışmanıza güç verir. Cloud, tek bir etkileşimli oturum için çok büyük olan veya başka bir yere odaklanırken paralel olarak çalışmasını istediğiniz birden çok görev olduğunda başvurduğunuz şeydir.

Codex Cloud, Codex'i hızlı bir kodlama asistanından yatay olarak ölçeklenen bir kıdemsiz mühendis ekibine dönüştüren özelliktir.

Bir görev gönderin, Codex deponuzla önceden yüklenmiş bir korumalı alan başlatır, çalışır, testleri çalıştırır ve bir PR açar. Yerel makinenizde hiçbir şeyi engellemez.

Tek bir görev gönderme:

Paralel görevler; temel desen:

Yirmi dakika sonra dört PR açılır. İnceleyin, triyaj yapın, birleştirin.

CSV yelpaze, bir görev dosyası göndermenizi sağlar ve Codex bunları, ilerleme takibi ile paralel bulut ajanları olarak dağıtır:

codex cloud, aktif ve bitmiş görevleri görüntüler. codex cloud apply <görev-id>, birleştirmeden önce değişiklikleri yerel olarak çeker.

GitHub Entegrasyonu

Bulut görevleri, deponuza PR'ler olarak gelir. GitHub entegrasyonu, bu PR'lerin nasıl incelendiğini ve Codex'in mevcut CI/CD hattınıza nasıl beslendiğini belirler.

Codex ve GitHub, üç düzeyde entegre olur: depo ortamları, pull request incelemeleri ve CI/CD için codex-action.

Depo ortamları temeldir. Codex Ayarları'nda bir GitHub deposu bağlayın ve bulut görevleri depoyu kopyalar, korumalı bir alan konteynerinde görevleri çalıştırır ve sonucu bir dal veya PR olarak gönderir. AGENTS.md, her bulut görevi için otomatik olarak okunur.

Pull request incelemeleri iki şekilde çalışır:

Herhangi bir PR yorumunda @codex review'dan bahsedin. Codex, alındığını onaylamak için bir göz emojisi ile tepki verir, ardından AGENTS.md dosyanıza göre ciddi sorunlara odaklanan yapılandırılmış bir inceleme yayınlar.
Otomatik İncelemeleri açın, böylece Codex manuel bir tetikleyici olmadan her yeni PR'de yayın yapar.

Codex bir inceleme yayınladıktan sonra, doğrudan PR yorum iş parçacığında işaretlenen sorunları düzeltmesini isteyin. Aynı dala düzeltmeyi işler ve PR'yi günceller.

codex-action, herhangi bir tetikleyicide (push, zamanlama, sorun oluşturma veya PR açma) Codex CLI'yi CI/CD hattınız içinde çalıştıran resmi bir GitHub Action'dır. Bu, hiçbir insanın bulunmadığı tam otomatik ardışık düzenlere Codex'i entegre etmenin önerilen yoludur.

Otomasyonlar: Gözetimsiz Çalışma

GitHub entegrasyonu, bir insan bir PR açtığında ne olacağını halleder. Otomasyonlar, hiçbir insanın dahil olması gerekmediğinde ne olacağını halleder.

Otomasyonlar, özel çalışma ağaçlarında çalışan zamanlanmış Codex görevleridir. Bunları Otomasyonlar panelinden ayarlayın: ad, proje, komut, zamanlama ve yürütme ortamı.

İş parçacığı yeniden kullanımı Nisan 2026'da kullanıma sunuldu. Otomasyonlar, bir iş parçacığını çalıştırmalar arasında yeniden kullanabilir, bağlam biriktirebilir ve zamanla daha akıllı hale gelebilir.

Her projenin sahip olması gereken üç başlangıç otomasyonu:

Haftalık bağımlılık incelemesi (Pazartesi 06:00): pnpm outdated ve pnpm audit çalıştırın. Kritik, büyük ve küçük bulguları raporlayın. Güvenli küçük ve yama yükseltmelerini otomatik PR yapın. Kritik veya büyük güncellemelere dokunmayın; bunlar insan kararları gerektirir.
Günlük Sentry triyajı (hafta içi 08:00): Parmak izine göre gruplandırılmış son 24 saatin hatalarını getirin. 3 veya daha fazla oluşumu olan her grup için dosyayı ve satırı belirleyin, ilgili kodu okuyun ve temel nedeni belirleyin. Bir triyaj raporu yayınlayın. Yalnızca teşhis, düzeltme yok.
Haftalık eski-PR temizliği (Cuma 17:00): 7 günden eski açık PR'leri listeleyin. Her biri için, sizi mi beklediğini, incelemeyi mi beklediğini yoksa bayatlamış mı olduğunu belirleyin ve bir hatırlatma yorumu yayınlayın. Hiçbir şeyi kapatmayın veya birleştirmeyin.

Çıktısı okunmayan herhangi bir otomasyonu öldürün. İyi bir otomasyon, kesinlikle yapacağınız tekrarlayan bir görevi kurtarır, tek bir taranabilir çıktı üretir ve gözetimsiz olarak yıkıcı bir işlem yapmaz.

MCP Entegrasyonu

Otomasyonlar, deponuzdakilerle çalışır. MCP sunucuları, Codex'i onun dışındaki her şeyle çalışacak şekilde genişletir.

MCP (Model Context Protocol), eklentilerin arkasındaki açık standarttır. Birden varsa bir eklenti kullanın. Dahili araçlara özel entegrasyonlar için ham MCP kullanın.

STDIO : Codex, yerel bir işlem başlatır ve stdin/stdout üzerinden iletişim kurar. Tek başına kullanımın %95'ini kapsar.
Streamable HTTP : Codex, bir ağ uç noktasına bağlanır. Barındırılan ekip MCP'leri için kullanılır.

Ham bir MCP sunucusu ekleme:

Veya doğrudan ~/.codex/config.toml dosyasında:

Her Araç İçin Onayları Yapılandırma: Okumaları Otomatik Onayla, Yazmalardan Önce Sor

Her MCP sunucusu, Codex'in bağlamına araç tanımları ekleyerek token tüketir ve dikkati dağıtır. Yalnızca gerçekten kullandıklarınızı etkinleştirin.

Docker MCP Toolkit, Codex'i 220'den fazla önceden oluşturulmuş sunucuya tek bir komutla bağlar: docker mcp-client configure codex

Mobil Uygulama

MCP sunucuları, Codex'in erişebildiği alanı genişletir. Mobil uygulama ise Codex'e nereden erişebileceğinizi genişletir.

14 Mayıs 2026'da Codex, iOS ve Android'deki ChatGPT mobil uygulamasına geldi.

Mobil Codex, bir kod düzenleyici değil, uzaktan kumanda ve izleme yüzeyidir. Tipik kullanım senaryosu, masanızdan uzaktayken telefonunuzdan uzun süreli bir bulut görevini veya Goal modu çalışmasını kontrol etmektir.

Telefonunuzdan şunları yapabilirsiniz:

Dizüstü bilgisayarlar, devbox'lar veya bağlı uzak ortamlar arasında canlı çalışmaları izleyin
Konulara göz atın ve paralel görevler arasında geçiş yapın
Bir dala birleştirilmeden önce farkları (diff) inceleyin
Codex'in donanımınızda çalıştırmak istediği komutları onaylayın veya reddedin
Daha güçlü bir modele ihtiyaç duyulursa görev ortasında modeli değiştirin
Yeni bir istemden veya doğrudan bir GitHub sorunundan (issue) yeni görevler başlatın
Codex'in açtığı bir çekme isteğine (pull request) yorum yapın

Kurulum için ChatGPT'yi 13 Mayıs 2026 sürümüne veya daha yenisine güncelleyin, masaüstü hesabınızla aynı hesapla oturum açın ve Ayarlar > Codex > Ortamlar altında en az bir bulut ortamının yapılandırıldığından emin olun. Mobil, mevcut tüm konuları ve bağlı ana bilgisayarları otomatik olarak devralır.

Bu özelliğin sağladığı pratik döngü: Evden çıkmadan önce sabah bir Goal modu çalışması başlatın, işe giderken ilerlemesini kontrol edin, telefonunuzdan bekleyen bir kararı onaylayın ve ofise girdiğinizde ilk iki çekme isteğiniz (PR) zaten açık olsun.

Chrome Eklentisi

Mobil uygulama erişiminizi genişletir. Chrome eklentisi ise Codex'in erişimini, halihazırda oturum açtığınız herhangi bir web sitesine genişletir.

Bu, kimliği doğrulanmış hizmetlere erişebileceği anlamına gelir: LinkedIn, Salesforce, Gmail, Workday ve oturum açma gerektiren herhangi bir dahili araç.
Yüklemek için Codex masaüstü uygulaması içindeki Eklentiler (Plugins) bölümüne gidin, Chrome eklentisini ekleyin ve yönlendirmeli kurulumu izleyin.
Eklenti, etkin olduğunda "Bağlandı" (Connected) durumunu gösterir. Herhangi bir Codex konusundan çağırın:

Codex, alt temsilciler (sub-agents) aracılığıyla farklı konularda birden çok Chrome sekmesini kontrol edebilir; her sekme izole edilmiştir.

Tarayıcısız otomasyona göre büyük bir avantaj: Chrome eklentisi, web geliştirici araçlarına erişebilir. Codex, DOM'u inceleyebilir, konsol hatalarını okuyabilir ve canlı bir tarayıcı oturumunda çalışma zamanı sorunlarını teşhis edebilir. Hem macOS hem de Windows'ta çalışır.

Codex SDK

Chrome eklentisi tarayıcı otomasyonunu halleder. SDK ise programatik otomasyonu; Codex'i kendi uygulamalarınız ve CI hatlarınız içinde bir altyapı olarak yerleştirmeyi sağlar.

Codex SDK, geliştiricilere kendi uygulamaları ve CI hatlarından Codex üzerinde programatik kontrol sağlar.

JavaScript SDK'sını yükleyin:

Temel kullanım:

Aynı konuda sohbete devam etmek için run()'ı tekrar çağırın. Kaydedilmiş bir konuyu codex.resumeThread(threadId) ile devam ettirin.
Python SDK'sı from codex_app_server import Codex kullanır. Başlatırken bir model adı iletin: thread = codex.thread_start(model="gpt-5.5").
SDK şu anda deneyseldir ve yerel bir Codex CLI kurulumu gerektirir.
Yerel uygulama sunucusuyla JSON-RPC üzerinden iletişim kurar; masaüstü uygulamasında etkileşim kurduğunuz temsilcinin aynısını kontrol eder.

Doğrulama: Codex Çıktısına Gerçekten Nasıl Güvenilir

Yukarıdaki tüm yüzeyler çıktı üretir. Doğrulama, bu çıktının ne kadarını gerçekten gönderebileceğinizi belirler.

Üretim çözülmüştür. Doğrulama darboğazdır.

Beş paralel bulut çekme isteği (PR), bir hata göndermek için beş fırsattır. Bir doğrulama katmanı olmadan, veriminiz çekme isteklerini ne kadar hızlı okuyabildiğinizle sınırlıdır.

Temel sorun dalkavukluktur (sycophancy). Kodu yazan model, kodun doğru olduğunu düşünmeye yatkındır. Kendi çalışmasını gözden geçirmesini isteyin ve çoğu zaman bir onay işareti alırsınız.

İki Yapısal Düzeltme:

auto_review (Codex içinde): Codex'in yerleşik gözden geçirici alt temsilcisidir. Yeni bağlam, önceki çıktıya yatırım yok, gerçek sorunları işaretleme olasılığı çok daha yüksektir.
Çapraz sağlayıcı doğrulama (altın standart): Codex yazar ve Claude Code gözden geçirir. Çapraz sağlayıcı, bir model ailesine özgü kör noktaları yakalar. Bu, üretim kodu için minimum geçerli doğrulama alışkanlığıdır.

Davranışsal doğrulama için Bilgisayar Kullanımı (Computer Use), "testler geçiyor" ile "şey gerçekten çalışıyor" arasındaki boşluğu kapatır. Codex'in geliştirme sunucusunu açmasını, ilgili akışı tıklamasını, sonucun ekran görüntüsünü almasını ve bunu PRD'nizle karşılaştırmasını sağlayın.

Her çekme isteğinde minimum geçerli alışkanlık: farkı kendiniz açmadan önce farklı bir modelle otomatik bir inceleme çalıştırın. Önce inceleme özetini okuyun. Yalnızca inceleme temiz olduğunda farkı açın; ardından doğruluk için değil, zevk için okuyun. UI değişiklikleri için ekran görüntüsüne bakın.

Tarifler: Savaşta Test Edilmiş Desenler

Doğrulama alışkanlıkları yerleşmişken, işte geliştiricilerin Codex aracılığıyla en sık gerçekleştirdiği görevler için uçtan uca şablonlar.

Bir özellik uygulama: new-feature Becerisini (Skill) kullanın. PRD ve AGENTS.md'yi okuyun. Önce plan yapın, onay bekleyin. Mutlu yol ve bir hata durumu için testler. Herhangi bir şey belirsizse, kod oluşturmadan önce sorun.
Bir hatayı düzeltme: Önce investigate Becerisini kullanın. Yalnızca teşhis edin. Yeniden üretim adımlarını, temel neden hipotezini ve bir doğrulama planını çıktı olarak verin. Onaylanana kadar düzeltmeyin.
Yeniden düzenleme (Refactor): grep ile tüm konumları listeleyin. Geçiş planını çıktı olarak verin. Onay bekleyin. Mevcut tüm testler değişiklik yapılmadan geçmelidir. Bir testin güncellenmesi gerekiyorsa, test yanlıştır; durun ve rapor edin. Tek bir çekme isteği (PR).
Üçüncü taraf entegrasyonu: lib/integrations/[name].ts içine sarın. .env.example'a ortam değişkenlerini ekleyin. Bu PR'da UI yok. Harici hizmete karşı manuel test için taslak olarak açın.
Test tamamlama (Backfill): Mutlu, uç ve hata durumlarını kapsayan test planını çıktı olarak verin. Onay bekleyin. Tüm testler mevcut üretim koduna karşı geçmelidir. Üretim kodunu değiştirmeyin.
Bağımlılık yükseltmesi: Sürümler arasındaki sürüm notlarını okuyun. Son değişiklikleri listeleyin. Onay bekleyin. Kod değişikliklerini güncelleyin ve uygulayın. Temizlenene kadar testleri çalıştırın.
Goal modu girişimi: Maksimum PR, PR başına maksimum kod satırı, PR'ler arasında CI geçidi ve net durma koşulları ile sınırlandırın. AGENTS.md'de olmayan mimari kararlarda duraklayın. Herhangi bir son değişiklik yapan API değişikliğinde duraklayın.

Yaygın Hatalar

Bu desenler, yaygın kazançları kapsar. Aşağıdaki bölüm ise yaygın kayıpları kapsar; kötü Codex deneyimlerinin çoğunu açıklayan on hata.

Belirsiz görevler. Belirli sonuçları, dosyaları ve kısıtlamaları adlandırın. Spesifik olamıyorsanız, görev brifing için hazır değildir.
AGENTS.md yok. Bir tane yazın. Kötü bir tane bile hiç yoktan iyidir.
Planı atlamak. Önemsiz olmayan her şeyde "Önce bir plan oluşturun."
Çoklu görev istemleri. İstem başına bir görev. Paralel çalışma için alt temsilciler veya bulut görevleri kullanın.
Tehlikeli-tam-erişim ile başlamak. Test edilmiş otomasyonlar dışında her şey için workspace-write ve on-request doğru varsayılandır.
Çok fazla MCP ve eklenti. Listeyi zayıf tutun. Aktif olarak kullanmadıklarınızı devre dışı bırakın.
Kendi kendini inceleme. auto_review veya tamamen farklı bir araç kullanın. Kodu yazan model, ona karşı önyargılıdır.
Derleme başarısını doğruluk olarak kabul etmek. Davranışsal doğrulamayı ekleyin. UI değişiklikleri için Bilgisayar Kullanımı'nı kullanın.
Aşırı paralelleştirme. Yalnızca bağımsız çalışmaları paralelleştirin. Paylaşılan dosyalar serileştirilmelidir.
Sınırsız Goal'ler. Maksimum PR, maksimum kod satırı, maksimum süre, net durma koşulları. Goal modu, genç bir mühendise vereceğiniz tasma ile en kullanışlıdır.

Hızlı Başvuru Kopya Kağıdı

CLI komutları:

Temel dosya konumları:

Genel yapılandırma: ~/.codex/config.toml
Genel AGENTS.md: ~/.codex/AGENTS.md
Proje AGENTS.md: <repo-root>/AGENTS.md
Geçersiz kılma dosyası: AGENTS.override.md
Anılar: ~/.codex/memories/
Beceriler (kişisel): $HOME/.agents/skills/
Beceriler (ekip): Depo içinde .agents/skills/
Alt temsilciler: .codex/agents/<name>.md

Dört parçalı istem yapısı:

Söyle: yöntemi değil, sonucu söyleyin
Göster: örnek girdileri ve beklenen çıktıları gösterin
Tanımla: kullanılacak API'leri, kütüphaneleri ve desenleri tanımlayın
Hatırlat: AGENTS.md'deki kuralları hatırlatın

Sonuç

Claude'u 12 ay kullandıktan sonra, kırılma noktası tek bir kötü gün değildi. Bu, hız sınırlamalarının, iş akışı sürtüşmelerinin ve sürekli yoluna çıkan bir masaüstü uygulaması deneyiminin birikimiydi.

Codex'e geçişi tetikleyen şey bu hayal kırıklığıydı.

Son 90 günde, OpenAI ekosisteminin derinliklerine inmek bir şeyi netleştirdi: Codex, ciddi geliştirici iş akışları için daha eksiksiz bir çalışma ortamı gibi hissettiriyor.
Ajan model daha güçlü, çevreleyen yüzeyler daha geniş ve AGENTS.md, Beceriler, Bulut ve doğrulama döngüleri yerine oturduğunda sisteme güvenmek daha kolay.
Bu, Claude Code'un hiçbir değeri olmadığı anlamına gelmez. Bu, ödünleşimlerin artık mantıklı gelmediği anlamına gelir.

Claude Code iş akışınız için hala çalışıyorsa, kullanmaya devam edin. Ancak hız sınırlamalarından, kırılgan oturumlardan ve sürecinizle savaşıyormuş gibi hissettiren araçlardan bıktıysanız, Codex artık ciddi bir geçişi haklı çıkaracak kadar iyidir.

Bu makale, bu geçişi kolaylaştırmak için yazılmıştır.

Umarım beğenmişsinizdir ve inşa etmeye başlarsınız ❤️

Feragatname

Bu makale, yazar tarafından notlarına, araştırmalarına ve kişisel deneyimlerine dayanarak yazılmış ve bir AI modeli (Sonnet 4.6) tarafından düzenlenmiştir.

Küçük resim görseli Pinterest'ten alınmış ve AI kullanılarak değiştirilmiştir.