Codex ile başlangıç: Daha iyi sonuçlar için en iyi uygulamalar

Eğer @OpenAI Codex veya genel olarak kodlama ajanlarıyla yeni tanışıyorsanız, bu rehber daha hızlı ve daha iyi sonuçlar almanıza yardımcı olacak. CLI, IDE eklentileri ve Codex uygulaması genelinde Codex'i daha etkili kılan temel alışkanlıkları kapsıyor: prompt yazma ve planlamadan doğrulama, MCP, beceriler ve otomasyonlara kadar.

Codex, onu tek seferlik bir yardımcıdan ziyade, zamanla yapılandırdığınız ve geliştirdiğiniz bir takım arkadaşı gibi ele aldığınızda en iyi şekilde çalışır.

Yararlı bir zihinsel model şudur: doğru görev bağlamıyla başlayın, kalıcı yönlendirmeler için AGENTS.md kullanın, Codex'i iş akışınıza uyacak şekilde yapılandırın, MCP ile harici sistemlere bağlanın, tekrarlayan işleri becerilere dönüştürün ve istikrarlı iş akışlarını otomatikleştirin.

1. Codex'i net bağlam ve promptlama ile güçlü bir ilk kullanıma hazırlayın

Codex, promptunuz mükemmel olmasa bile kullanışlı olacak kadar güçlüdür. Çoğu zaman, minimum kurulumla zor bir problemi ona verebilir ve yine de güçlü bir sonuç alabilirsiniz. Net promptlama değer elde etmek için gerekli değildir, ancak özellikle daha büyük kod tabanlarında veya daha yüksek riskli görevlerde sonuçları daha güvenilir kılar.

Büyük veya karmaşık bir depoda çalışıyorsanız, en büyük kazanım genellikle Codex'e doğru görev bağlamını ve ne yapılmasını istediğinize dair net bir yapı vermektir.

İyi bir varsayılan, promptunuza dört şey eklemektir:

• Hedef: Ne değiştirmeye veya oluşturmaya çalışıyorsunuz?
• Bağlam: Bu görev için hangi dosyalar, klasörler, dokümanlar, örnekler veya hatalar önemli? Bağlam olarak belirli dosyalardan @mention ile bahsedebilirsiniz.
• Kısıtlamalar: Codex hangi standartlara, mimariye, güvenlik gereksinimlerine veya kurallara uymalı?
• Ne zaman biter: Görev tamamlanmadan önce ne doğru olmalı? Örneğin testlerin geçmesi, davranışın değişmesi veya bir hatanın düzeltilmesi gibi.

Bu, Codex'in kapsamda kalmasına, daha az varsayımda bulunmasına ve gözden geçirilmesi ve doğrulanması daha kolay işler üretmesine yardımcı olur.

Görevin zorluğuna göre bir akıl yürütme seviyesi seçin ve iş akışınız için en iyi neyin işe yaradığını test edin. Farklı kullanıcılar ve görevler farklı ayarlardan yararlanır.

• Daha hızlı, iyi kapsamlandırılmış görevler için Düşük
• Daha karmaşık değişiklikler veya hata ayıklama için Orta veya Yüksek
• Uzun, ajanik, ağır akıl yürütme gerektiren görevler için Çok Yüksek

Yeni kullanıcılar için ipucu

: Çoğu kişi, Codex'e kod tabanı hakkında sorular sormak veya küçük, kapsamlı bir düzeltme yapmak için kullanmak gibi birkaç temel kazanımla başlayarak en hızlı şekilde hızlanır. Tekrarlamaları hızlandırmak için Codex uygulamasında konuşma diktesini kullanmanızı şiddetle tavsiye ederiz.

Codex akıl yürütme çabaları

2. Zor görevlerde hataları azaltmak için Codex'in önce plan yapmasını sağlayın

Görev karmaşık, belirsiz veya net bir şekilde tanımlanması zorsa, Codex'ten kod yazmaya başlamadan önce plan yapmasını isteyin.

Bunu yapmanın birkaç iyi yolu vardır:

Plan modunu kullanın: Çoğu kullanıcı için bu en kolay ve en etkili seçenektir. Plan modu, Codex'in bağlam toplamasına, açıklayıcı sorular sormasına ve uygulamadan önce daha güçlü bir plan oluşturmasına olanak tanır. /plan veya Shift+Tab ile geçiş yapın.

Codex'in size soru sormasını isteyin: Ne istediğinize dair kabaca bir fikriniz var ancak nasıl iyi tanımlayacağınızdan emin değilseniz, Codex'ten önce size soru sormasını isteyin. Varsayımlarınıza meydan okumasını ve kod yazmadan önce belirsiz fikri somut bir şeye dönüştürmesini söyleyin.

Bir PLANS.md şablonu kullanın: Daha gelişmiş iş akışları için, Codex'i daha uzun süreli veya çok adımlı işler için bir PLANS.md veya yürütme planı şablonunu takip edecek şekilde yapılandırabilirsiniz. Daha fazla ayrıntı için yürütme planları kılavuzumuza göz atın.

Plan modu

3. Başarılı yönlendirmeleri AGENTS.md ile tekrar kullanılabilir hale getirin

Bir promptlama modeli işe yaradığında, bir sonraki adım onu manuel olarak tekrarlamayı bırakmaktır. İşte burada AGENTS.md devreye giriyor.

AGENTS.md'yi ajanlar için bir README olarak düşünün. Otomatik olarak bağlama yüklenen basit, açık bir formattır ve sizin ve ekibinizin bir depoda Codex'in nasıl çalışmasını istediğinizi kodlamak için en iyi yerdir.

İyi bir AGENTS.md genellikle şunları kapsar:

• Depo düzeni ve önemli dizinler
• Projenin nasıl çalıştırılacağı
• Derleme, test ve lint komutları
• Mühendislik kuralları ve PR beklentileri
• Kısıtlamalar ve yapılmaması gerekenler
• Bitmiş olmanın ne anlama geldiği ve işin nasıl doğrulanacağı

CLI'daki /init eğik çizgi komutu, geçerli dizinde bir başlangıç ​​AGENTS.md'si oluşturmak için hızlı başlangıç ​​komutudur. Harika bir başlangıç ​​noktasıdır, ancak ekibinizin gerçekte nasıl kod oluşturduğu, test ettiği, gözden geçirdiği ve teslim ettiğiyle eşleşmesi için sonucu düzenlemelisiniz.

AGENTS.md dosyalarını birden çok düzeyde oluşturabilirsiniz: ~/.codex içinde bulunan kişisel varsayılanlar için genel bir AGENTS.md, paylaşılan standartlar için depo düzeyinde bir dosya ve yerel kurallar için alt dizinlerde daha spesifik dosyalar. Geçerli dizininize daha yakın daha spesifik bir dosya varsa, bu yönlendirme kazanır.

Pratik tutun. Kısa ve doğru bir AGENTS.md, belirsiz kurallarla dolu uzun bir dosyadan daha kullanışlıdır. Temel bilgilerle başlayın, ardından yalnızca tekrarlanan hataları fark ettikten sonra yeni kurallar ekleyin.

AGENTS.md çok büyümeye başlarsa, ana dosyayı kısa tutun ve planlama, kod incelemesi veya mimari gibi şeyler için göreve özel işaretleme dosyalarına başvurun.

İpucu

: Codex aynı hatayı iki kez yaptığında, ondan bir geriye dönük değerlendirme isteyin ve AGENTS.md'yi güncelleyin. Yönlendirmeler pratik kalır ve gerçek sürtünmeye dayanır.

AGENTS.md web sitesi

4. Codex'i iş akışınıza uyacak şekilde yapılandırarak daha tutarlı davranış elde edin

Yapılandırma, Codex'in oturumlar ve yüzeyler arasında daha tutarlı davranmasını sağlamanın ana yollarından biridir. Örneğin, model seçimi, akıl yürütme çabası, sanal alan modu, onay politikası, profiller ve MCP kurulumu için varsayılanlar belirleyebilirsiniz.

İyi bir başlangıç ​​modeli şudur:

• Kişisel varsayılanları ~/.codex/config.toml içinde tutun (Codex uygulamasından Ayarlar → Yapılandırma → config.toml'u Aç)
• Depoya özgü davranışı .codex/config.toml içinde tutun
• Komut satırı geçersiz kılmalarını yalnızca tek seferlik durumlar için kullanın (CLI kullanıyorsanız)

Config.toml, MCP sunucuları, profiller, çoklu ajan kurulumu ve deneysel özellikler gibi kalıcı tercihleri tanımladığınız yerdir. Doğrudan düzenleyebilir veya Codex'ten sizin için güncellemesini isteyebilirsiniz.

Codex, işletim düzeyinde sanal alanla birlikte gelir ve kontrol edebileceğiniz iki önemli düğmeye sahiptir. Onay modu, Codex'in bir komutu çalıştırmak için ne zaman izninizi isteyeceğini belirler ve sanal alan modu, Codex'in dizinde okuyup yazamayacağını ve ajanın hangi dosyalara erişebileceğini belirler.

Kodlama ajanlarında tamamen yeniyseniz, varsayılan izinlerle muhafazakar başlamanız önerilir. Varsayılan olarak onayı ve sanal alanı sıkı tutun, ardından ihtiyaç netleştiğinde yalnızca güvenilen depolar veya belirli iş akışları için izinleri gevşetin.

CLI, IDE ve Codex uygulamasının tümünün aynı yapılandırma katmanlarını paylaştığını unutmayın. Örnek yapılandırma dokümantasyon sayfamızda daha fazla bilgi edinin.

İpucu

: Codex'i gerçek ortamınız için erken yapılandırın. Kalite sorunlarının çoğu, yanlış çalışma dizini, eksik yazma izni, yanlış model varsayılanları veya eksik araçlar ve bağlayıcılar gibi aslında kurulum sorunlarıdır.

5. Codex'in işi test etmesini, doğrulamasını ve gözden geçirmesini sağlayarak güvenilirliği artırın

Codex'ten yalnızca bir değişiklik yapmasını istemekle kalmayın. Gerektiğinde testler oluşturmasını, ilgili kontrolleri çalıştırmasını, sonucu doğrulamasını ve siz kabul etmeden önce işi gözden geçirmesini isteyin.

Codex bu döngüyü sizin için yapabilir, ancak yalnızca "iyi"nin neye benzediğini bilirse. Bu yönlendirme, prompttan veya AGENTS.md'den gelebilir.

Bu şunları içerebilir:

• Değişiklik için testler yazmak veya güncellemek
• Doğru test paketlerini çalıştırmak
• Lint, biçimlendirme veya tür denetimlerini kontrol etmek
• Nihai davranışın istekle eşleştiğini onaylamak
• Hatalar, gerilemeler veya riskli kalıplar için diff'i incelemek

İpucu:

Codex uygulamasındaki diff panelini değişiklikleri doğrudan

yerel olarak incelemek için açın. Bir sonraki Codex turuna bağlam olarak beslenen geri bildirim sağlamak için belirli bir satıra tıklayın.

Burada kullanışlı bir seçenek, size kodu incelemenin birkaç farklı yolunu sunan /review eğik çizgi komutudur:

• PR tarzı inceleme için bir temel dalına karşı inceleme
• Kaydedilmemiş değişiklikleri inceleme
• Bir commit'i inceleme
• Özel inceleme talimatlarını kullanma

Siz ve ekibiniz AGENTS.md'de referans verilen bir code_review.md dosyasına sahipseniz, Codex inceleme sırasında da bu yönlendirmeyi takip edebilir. Bu, inceleme davranışının depolar ve katkıda bulunanlar arasında tutarlı kalmasını isteyen ekipler için güçlü bir modeldir.

Codex yalnızca kod üretmemelidir. Doğru talimatlarla, onu test etmeye, doğrulamaya ve incelemeye de yardımcı olabilir.

GitHub Cloud kullanıyorsanız, Codex'i PR'larınız için kod incelemeleri çalıştıracak şekilde kolayca ayarlayabilirsiniz. OpenAI'de PR'lerin %100'ünü Codex ile inceliyoruz. Otomatik incelemeleri etkinleştirme veya @Codex ile etiketlediğinizde Codex'in reaktif olarak inceleme yapmasını sağlama seçeneğiniz vardır.

Codex CLI'da /review

6. MCP'ler ile harici araçları ve canlı bağlamı Codex'e getirin

Codex'in ihtiyaç duyduğu bağlam deponun dışında yaşadığında MCP'leri kullanın. Codex'in halihazırda kullandığınız araçlara ve sistemlere bağlanmasını sağlar, böylece canlı bilgileri sürekli kopyalayıp promptlara yapıştırmak zorunda kalmazsınız.

Model Context Protocol veya MCP, Codex'i harici araçlara ve sistemlere bağlamak için açık bir standarttır.

MCP'yi şu durumlarda kullanın:

• Gerekli bağlam deponun dışında yaşıyorsa
• Veriler sık sık değişiyorsa
• Codex'in yapıştırılmış talimatlara güvenmek yerine bir araç kullanmasını istiyorsanız
• Kullanıcılar veya projeler arasında tekrarlanabilir bir entegrasyona ihtiyacınız varsa

Codex, OAuth ile hem STDIO hem de Streamable HTTP sunucularını destekler.

Codex Uygulamasında, özel ve önerilen sunucuları görmek için Ayarlar → MCP sunucuları'na gidin. Codex genellikle gerekli sunucuları kurmanıza yardımcı olabilir. Tek yapmanız gereken sormak. Ayrıca, özel sunucularınızı bir ad, URL ve ek bilgilerle eklemek için CLI'da codex mcp add komutunu da kullanabilirsiniz.

İpucu

: Araçları yalnızca gerçek bir iş akışının kilidini açtıklarında ekleyin. Kullandığınız her aracı bağlayarak başlamayın. Halihazırda sık sık yaptığınız manuel bir döngüyü açıkça ortadan kaldıran bir veya iki araçla başlayın, ardından oradan genişleyin.

MCP sunucu yönetimi

7. Tekrarlanan iş akışlarını yeniden kullanılabilir becerilere dönüştürün

Bir iş akışı tekrarlanabilir hale geldiğinde, uzun promptlara veya tekrarlanan gidiş gelişlere güvenmeyi bırakın. Codex'in tutarlı bir şekilde uygulaması gereken talimatları, bağlamı ve destekleyici mantığı bir SKILL.md dosyasında paketlemek için bir Beceri kullanın. Beceriler CLI, IDE eklentisi ve Codex uygulaması genelinde çalışır.

Her beceriyi tek bir işe sıkı sıkıya kapsamlı tutun. 2 ila 3 somut kullanım durumuyla başlayın, net girdiler ve çıktılar tanımlayın ve açıklamayı, becerinin ne yaptığını ve ne zaman kullanılacağını net bir şekilde söyleyecek şekilde yazın. Bir kullanıcının gerçekten söyleyeceği türden tetikleyici ifadeler ekleyin.

Tüm uç durumları önceden kapsamaya çalışmayın. Temsili bir görevle başlayın, iyi çalışmasını sağlayın, ardından bu iş akışını bir beceriye dönüştürün ve oradan iyileştirin. Komut dosyalarını veya ek varlıkları yalnızca güvenilirliği anlamlı bir şekilde artırdıklarında ekleyin.

İyi bir kural: Aynı promptu yeniden kullanmaya veya aynı iş akışını düzeltmeye devam ediyorsanız, muhtemelen bir beceri haline gelmelidir.

Beceriler özellikle aşağıdaki gibi yinelenen işler için kullanışlıdır:

• Log triyajı
• Sürüm notu taslağı hazırlama
• Bir kontrol listesine karşı PR incelemesi
• Geçiş planlaması
• Telemetri veya olay özetleri
• Standart hata ayıklama akışları

$skill-creator becerisi, bir becerinin ilk sürümünü oluşturmak ve yerel olarak kurmak için $skill-installer becerisini kullanmak için başlamak için en iyi yerdir. Bir becerinin en önemli kısımlarından biri açıklamadır. Becerinin ne yaptığını ve ne zaman kullanılacağını açıkça belirtmelidir.

İpucu

: Kişisel beceriler

$HOME /.agents/skills içinde saklanır ve paylaşılan ekip becerileri bir depo içindeki .agents/skills klasörüne kontrol edilebilir. Bu, özellikle yeni ekip üyelerini işe almak için faydalıdır.

Beceri oluşturma ve kurulum

Codex Uygulaması becerileri arayüzü

8. Otomasyonlarla tekrarlayan işlerde zaman kazanın

Bir iş akışı istikrarlı hale geldiğinde, Codex'i arka planda sizin için çalıştırmak üzere zamanlayabilirsiniz. Codex uygulamasında, otomasyonlar tekrarlayan bir görev için proje, prompt, sıklık ve yürütme ortamını seçmenize olanak tanır.

Sizin için tekrarlayan hale gelen bir görev olduğunda, Codex uygulamasındaki Otomasyonlar sekmesinden kolayca bir otomasyon oluşturabilirsiniz. Hangi projede çalışacağını, hangi promptu çalıştırdığını (becerileri çağırabilirsiniz) ve hangi sıklıkta çalışacağını seçebilirsiniz. Ayrıca otomasyonun özel bir git çalışma ağacında mı yoksa yerel ortamınızda mı çalışacağını da seçebilirsiniz. git çalışma ağaçları hakkında daha fazla bilgi edinin.

İyi adaylar şunları içerir:

• Son commit'leri özetleme
• Olası hataları tarama
• Sürüm notları taslağı hazırlama
• CI başarısızlıklarını kontrol etme
• Günlük durum toplantısı özetleri üretme
• Zamanlanmış tekrarlanabilir analiz iş akışlarını çalıştırma

Yararlı bir kural, becerilerin yöntemi tanımlaması, otomasyonların ise programı tanımlamasıdır. Bir iş akışı hala çok fazla yönlendirme gerektiriyorsa, önce onu bir beceriye dönüştürün. Tahmin edilebilir hale geldiğinde, otomasyon bir güç çarpanı haline gelir.

İpucu

: Otomasyonları yalnızca yürütme için değil, yansıtma ve bakım için de kullanın. Son oturumları gözden geçirin, tekrarlanan sürtünmeyi özetleyin ve zaman içinde promptları, talimatları veya iş akışı kurulumunu iyileştirin.

Codex uygulaması otomasyon oluşturma

9. Oturum kontrolleriyle daha uzun süreli işlerde düzenli kalın

Codex oturumları yalnızca sohbet geçmişi değildir. Zaman içinde bağlam, kararlar ve eylemler biriktiren çalışma iş parçacıklarıdır, bu nedenle onları iyi yönetmek kalite üzerinde büyük bir etkiye sahiptir.

Birden çok iş parçacığını yönetmek, iş parçacıklarını sabitleme ve çalışma ağaçları oluşturma özelliğiyle Codex uygulama arayüzünde en kolay olanıdır. Ancak CLI kullanıyorsanız, bu eğik çizgi komutları özellikle kullanışlıdır:

• /experimental deneysel özellikleri açıp kapatmak ve config.toml dosyanıza eklemek için
• /resume kaydedilmiş bir konuşmayı sürdürmek için
• /fork orijinal transkripti korurken yeni bir iş parçacığı oluşturmak için
• /compact iş parçacığı uzadığında ve önceki bağlamın özetlenmiş bir versiyonunu istediğinizde. Codex'in konuşmaları sizin için otomatik olarak sıkıştırdığını unutmayın.
• /agent birden çok ajan çalıştırıyorsanız ve etkin ajan iş parçacığı arasında geçiş yapmak istediğinizde
• /theme bir sözdizimi vurgulama teması seçmek için
• /apps Codex'te doğrudan ChatGPT uygulamalarını kullanmak için
• /status geçerli oturum durumunu incelemek için

Tutarlı her çalışma birimi için bir iş parçacığı tutun. Çalışma hala aynı sorunun parçasıysa, aynı iş parçacığında kalmak genellikle daha iyidir çünkü akıl yürütme izini korur. Yalnızca çalışma gerçekten dallandığında çatallayın.

İpucu

:

Codex'in

çoklu ajan iş akışlarını, sınırlandırılmış işleri ana iş parçacığından ayırmak için kullanın. Ana ajanı temel soruna odaklı tutun ve keşif, testler veya triyaj gibi görevler için alt ajanlar kullanın.

10. Kaçınılması gereken yaygın hatalar

Codex'i ilk kez kullanırken kaçınılması gereken birkaç yaygın hata:

• Kalıcı kuralları AGENTS.md veya bir beceriye taşımak yerine prompta aşırı yüklemek
• Ajanın işini görmesine izin vermemek, derleme ve test komutlarının en iyi nasıl çalıştırılacağına dair ayrıntı vermemek
• Çok adımlı ve karmaşık görevlerde planlamayı atlamak
• İş akışı anlaşılmadan önce Codex'e bilgisayarınıza tam izin vermek
• Git çalışma ağaçlarını kullanmadan aynı dosyalarda birden çok canlı iş parçacığı çalıştırmak
• Tekrarlayan bir görevi manuel olarak güvenilir hale gelmeden önce otomasyona dönüştürmek
• Codex'i adım adım izlemeniz gereken bir şey olarak ele almak yerine kendi işinize paralel olarak kullanmak

Başlangıç ​​kontrol listesi

1. Codex'e doğru hedefi, bağlamı, kısıtlamaları ve ne zaman bittiğini verin
2. Zor görevler için Codex'ten önce plan yapmasını isteyin
3. Bir başlangıç ​​AGENTS.md oluşturun
4. Codex'e nasıl derleneceğini, test edileceğini, doğrulanacağını ve gözden geçirileceğini söyleyin
5. İş akışınızla eşleşen yapılandırma varsayılanlarını ayarlayın
6. Yüksek değerli harici araçlar için MCP ekleyin
7. Tekrarlanan iş akışlarını becerilere dönüştürün
8. Bir iş akışı istikrarlı hale geldiğinde otomasyonları kullanın

İş akışınızı, standartlarınızı ve bağlamınızı Codex'in kullanabileceği bir şeye ne kadar çok dönüştürürseniz, ajanın gerçekten neler yapabileceğini o kadar çok göreceksiniz. Hemen bugün başlayın!