Codex bir döngüdür: dosyaları düzenler, komutları çalıştırır, çıktıyı okur ve bir sonraki adımı belirler. Peki neden API testleriniz bu döngüde değil? Bir GUI'nin arkasında Apidog'da dururlar, birisi tıklamayı hatırladığında çalıştırılırlar. Aracınız onlara asla dokunmaz.
Çözüm, tek bir yapılandırma bloğudur. Apidog CLI, bir npm paketi olan apidog-cli'dir ve Apidog'da oluşturduğunuz test senaryolarını doğrudan bir terminalden çalıştırır. CLI yüklendiğinde ve Codex bunun var olduğunu bildiğinde, aracınız bir Apidog senaryosunu birim testlerinizi çalıştırdığı gibi çalıştırır: komutu tetikler, çıkış kodunu okur, kırmızıysa kodu düzeltir.
Bu kılavuz, genel yükleme kılavuzunun atladığı Codex'e özel bölümü kapsar: AGENTS.md dosyanız için tam satır, Codex'e verilecek komut istemi, apidog run komutunu kendi döngüsünde nasıl çalıştırdığı ve sonucu nasıl okuyacağı.
CLI'yi henüz yüklemediyseniz, önce bunu yapın. Apidog CLI'yi bir AI kodlama aracıyla nasıl kurarsınız başlıklı makale, npm kurulumunu, erişim belirtecini ve ilk çalıştırmayı, Codex'in yazma işlemini yapmasıyla birlikte açıklar. Bu makale, apidog --version komutunun bir sayı yazdırdığını ve Apidog hesabınızın kimliğinin doğrulandığını varsayar.
Bu Hangi Codex Hakkında
Hem OpenAI Codex CLI hem de Codex Uygulaması. Yerel olarak çalışır, deponuzu okur, dosyaları düzenler ve bir sanal alan içinde kabuk komutları yürütür, izin modunuza göre onay ister. Bu eski Codex kod tamamlama API'si değildir. Eğer codex komutunu çalıştırır ve farkları ve komut çıktısını gösteren tam ekran bir arayüz alırsanız, doğru yerdesiniz demektir. OpenAI Codex CLI kılavuzu temel bilgileri kapsar.
Bu ayrım önemlidir çünkü Codex'in proje kurallarını öğrenmek için kendi yolu vardır ve bu mekanizma, bir defalık "testlerimi çalıştır" komutunu Codex'in kendi başına yapabileceği bir şeye dönüştürür. Bu mekanizma AGENTS.md'dir.
Mekanizma: AGENTS.md, bir sohbet hatırlatıcısı değil
Codex, çalışmaya başlamadan önce AGENTS.md dosyalarını okur. Bunu Claude Code için CLAUDE.md gibi düşünün: Codex'in her oturumun başında bağlama yüklediği, proje talimatlarını içeren düz bir Markdown dosyası. Talimat setini Git kök dizininizden mevcut dizininize kadar yürüyerek, her AGENTS.md dosyasını kökten başlayarak birleştirir, böylece çakışmalarda daha yakın dosyalar kazanır. Ayrıca genel bir ~/.codex/AGENTS.md de vardır. Bizim amacımız için depo kökünde tek bir dosya yeterlidir.
CLI'yi sohbette belirtmek yerine AGENTS.md'ye yazmanızın nedeni budur. Sohbete yazılan bir senaryo kimliği, oturum sona erdiğinde kaybolur. AGENTS.md'deki bir kimlik ise artık her takım arkadaşı ve her Codex çalıştırması için orada olacaktır.
Adım 1: Codex'e komutu verin ve çalışmasını izleyin
Blok yerindeyken, deponuzda Codex'i başlatın:
Codex, başladığında AGENTS.md'yi yükler, böylece CLI'nin orada olduğunu zaten bilir. API'nizi etkileyen bir değişiklik yapın veya kontrolü çalıştırmasını isteyin:
Codex, apidog run komutunu AGENTS.md dosyanızdan verir. Varsayılan Otomatik modunda, dosyaları okuyabilir, düzenleyebilir ve çalışma dizini içinde kendi başına komutlar çalıştırabilir, bu nedenle düz bir apidog run genellikle komut istemi olmadan yürütülür. -r cli raporlayıcısı, terminalde adım adım bir sonuç ve özet yazdırır; burada her isteği ve iddiayı gerçekleşirken izlersiniz.
Çalıştırmanın yürütüldüğünü ve Codex'in hem özeti hem de çıkış kodunu raporladığını görmek istersiniz. İzin modunuz Salt okunur ise, Codex çalıştırmadan önce duraklar ve sorar; onaylayın veya oturum içinde /permissions ile modu değiştirin. Otomatik, makul bir varsayılandır, çünkü hazırlık ortamına karşı salt okunur bir test senaryosu, tam da bu modun oluşturulduğu güvenli, çalışma alanı içi komut türüdür.
Adım 2: Codex kendi döngüsünde test ediyor
Önemli olan, siz sormayı bıraktığınızda ve Codex, AGENTS.md ona söylediği için senaryoyu kendi başına çalıştırdığında ne olduğudur.
Codex'in bir ödeme yanıtı oluşturan bir işleyiciyi düzenlediğini hayal edin. Döngüsü değişir: kodu düzenler, ardından zafer ilan etmek yerine Apidog senaryonuzu hazırlık ortamına karşı çalıştırır, çıkış kodunu okur ve buna göre hareket eder. Yeşilse, devam eder. Kırmızıysa, raporu açar, hangi iddianın başarısız olduğunu okur (durum kodu, eksik alan, yanlış değer), bir düzeltme denemesi yapar ve tekrar çalıştırır. API testi, Codex'in birim testlerinizi zaten çalıştırdığı aynı düzenle-test et-düzelt döngüsünün bir parçası haline gelir. Siz bir talimat yazdınız ve Codex bu komutu zaten nasıl çalıştığına dahil etti.
Bu, herhangi bir aracı iş akışını güvenli kılan delege et-doğrula modelidir. Codex komutu çalıştırır ve sonucu okur; siz Apidog'da senaryoları görsel olarak yazmaya devam eder ve aracının çıkış kodlarını dürüstçe okuduğunu kontrol edersiniz. Daha geniş kalıp için, API testi için yapay zeka aracılarının nasıl kullanılacağını ve Apidog AI test donanımını inceleyin.
Codex'in Gerçekten CLI'yi Çalıştırdığını Doğrulayın
Aracılar kazanmadıkları başarıları rapor eder ve Codex de bir istisna değildir. Sorunları ne sıklıkla yakaladıklarına göre üç kontrol.
İlk olarak, komutun çalışıp çalışmadığını onaylayın. Codex arayüzü, çalıştırdığı komutları ve bunların satır içi çıktısını gösterir. Tam apidog run ... satırını ve altında bir sonuç arayın. Eğer Codex testleri çalıştırdığını söylüyor ancak komutu görmüyorsanız, hiç yapmadığı bir şeyi özetlemiştir. Tekrar çalıştırmasını ve ham çıktıyı göstermesini isteyin.
İkinci olarak, önemli olan çıkış kodunu onaylayın:
Bu apidog run komutunun çıkış kodu neydi?
apidog run, her iddia geçtiğinde 0 ile, herhangi bir şey başarısız olduğunda ise sıfır olmayan bir değerle çıkar. Bu tek davranış, Codex'in veya bir işlem hattının çalıştırmayı temiz bir geçit olarak ele almasını sağlar. Codex'in metni "testler geçti" dese de çıkış kodu sıfır değilse, çıkış kodu doğrudur.
Üçüncü olarak, gerçek senaryoyu kullandığını onaylayın. Eğer bir çalıştırma "senaryo bulunamadı" hatasıyla başarısız olursa, Codex bir kimlik uydurmuş veya yanlış hatırlamış olabilir. -t ve -e değerlerini AGENTS.md ve Apidog'un CI/CD sekmesinde oluşturduğu komutla tekrar kontrol edin. AGENTS.md'deki kimlikler gerçeği yansıtır.
Test Raporunu Okuma
Bir çalıştırma kırmızıya döndüğünde, rapor cevabı içerir. -r cli ile Codex, terminalde okunaklı bir döküm alır: her istek, her iddia ve beklenen ile gerçek değere göre hangisinin başarısız olduğu. Başarısız olan iddia, tam alanı veya durum kodunu belirtir ki bu, Codex'in düzeltmeyi bulması için genellikle yeterlidir.
Bir tarayıcıda açabileceğiniz veya bir takım arkadaşınıza verebileceğiniz bir rapor için HTML raporlayıcıyı ekleyin:
html raporlayıcısı, ./apidog-reports konumuna kendi kendine yeten bir dosya yazar. Listede cli'yi tutun, böylece Codex bir sonraki adımına karar vermek için okuduğu satır içi çıktıyı almaya devam eder. JUnit formatındaki CI panolarının ayrıştırması da dahil olmak üzere her bayrak ve raporlayıcı için eksiksiz Apidog CLI kılavuzuna ve apidog run komut referansına bakın.
Kabuk Komutlarından Daha Derine İnmenin İki Yolu
AGENTS.md'den apidog run komutunu çalıştırmak, ihtiyacınız olan çoğu şeyi kapsar. İki yol daha ileri gider.
Birincisi MCP'dir. Codex, Model Bağlam Protokolünü destekler ve sunucuları codex mcp add ile veya ~/.codex/config.toml dosyasını [mcp_servers.NAME] bloğuyla düzenleyerek eklersiniz. Apidog MCP sunucusu, API özelliklerinizi MCP üzerinden sunar, böylece Codex, kodu yazarken şemanızı okuyabilir, sadece sonradan değil. CLI testleri çalıştırır; MCP ajana spesifikasyonu besler.
İkincisi ise codex exec'tir. Sade codex interaktif arayüzü açarken, codex exec "..." Codex'i etkileşimli olmayan bir şekilde çalıştırır ve sonucu standart çıktıya yönlendirir; bu, betiklerde ve CI'da başvuracağınız yöntemdir. Codex olmadan bir işlem hattında apidog run çalıştırmak için, GitHub Actions'ta Apidog CLI sırları, raporlayıcıları ve çıkış kodu kısıtlamalarını kapsar.
Codex Yanlış Yaptığında
Kurulum sırasında birkaç hata sıklıkla ortaya çıkar.
AGENTS.md bloğunu yoksayar. Eğer Codex genel bir komut çalıştırıyorsa veya hiç çalıştırmıyorsa, blok yüklenmiyor olabilir. Dosyanın adının tam olarak AGENTS.md olduğundan ve Git kök dizininizde veya mevcut dizininizin bir üstünde bulunduğundan emin olun. Dosya adındaki bir yazım hatası, Codex'in onu asla okumaması anlamına gelir; oturumu yeniden başlatmak yeni bir okumayı zorlar.
Yine de bir erişim belirteci geçirir. Eğer Codex --access-token eklemeye çalışırsa, kamuya açık örneklerden tahmin yürütüyordur. Makine apidog login aracılığıyla kimliği doğrulandığı için blok zaten bunu yapmamasını söyler. Bu satırı pekiştirin ve asla AGENTS.md dosyasına gerçek bir belirteç koymayın.
Bir bayrak uydurur. "Bilinmeyen seçenek" hatası, Codex'in sürümünüzde bulunmayan bir bayrağı tahmin ettiğini gösterir. Ona apidog run --help komutunu çalıştırmasını söyleyin ve oradan doğru bayrağı kopyalayın; bu, yüklü sürümünüz için her zaman doğrudur.
Başarısız bir çalıştırmada başarılı olduğunu rapor eder. En maliyetli olanı ve çıkış kodu kuralının AGENTS.md dosyanızda ve doğrulama adımınızda bulunmasının nedeni budur. Özet ve çıkış kodu uyuşmadığında, çıkış kodu geçerlidir.
Günlük Bir Aracından Test Edilmiş Bir Döngüye
Kurulum bu kadar. Kurulum kılavuzunu takip ederek apidog-cli'yi bir kez yükleyin, deponuzun AGENTS.md dosyasına kısa bir Apidog bloğu ekleyin ve Codex, API testlerinizi nasıl çalıştıracağını ve kodu düzenlemek için kullandığı aynı döngü içinde sonucu nasıl okuyacağını bilecektir. Bozuk bir uç nokta, Codex değişik üzerinde çalışırken yakalanır, dağıtımdan sonra değil.
Bir GUI'nin arkasındaki bir test, bir insan tıkladığında çalışır; tek satırlık bir komut, Codex ne zaman karar verirse o zaman çalışır. Apidog'da senaryoları görsel olarak oluşturmaya devam edersiniz ve aracınız bunları sizin izlemediğiniz yerlerde çalıştırır. Apidog'u indirin, bir senaryo oluşturun, apidog run komutunu AGENTS.md'ye bırakın ve Codex'in bir sonraki değişiklikte bunu nasıl algıladığını izleyin.