Claude × Codex'i Uyandırmak İçin Nihai Ajan Tasarımı [En Güncel Sürüm]

"Daha net talimatlar ver" dense bile, ben tam da o "net kısmı" bulmaktan itibaren yardım istiyorum.

Yapmak istediğin bir şey var ama yapay zekâya sorabilmek için gereken ön araştırmayı yaparken ellerin duruyor. Bu hiç adil bir anlaşma gibi hissettirmiyor.

Örneğin, davaları kaydedip yaklaşan son tarihlere göre sıralayabileceğin bir uygulama istediğini varsayalım. Bunu söyleyebilirsin. Ama sana veri saklama yöntemleri veya hataları nasıl kontrol edeceğin sorulduğunda, araştırma yükü bir anda katlanıyor.

Araştırırken, "belki bu sefer bunlar olmadan da idare ederim" diyerek başta eklemek istediğin özellikleri budamaya başlıyorsun. Bunun sebebi onları geliştirmek zor görünmesi değil; bir şeyler ters giderse her şeyi kendi başına yönetebileceğin bir kapsamda tutmak istemen.

Aslında sormadan önce her küçük talimatı hazırlamak istemiyorum. Benim gözden kaçırdığım detayları senin yakalamanı istiyorum. Bana iki seçenek arasında net bir şekilde karar vermemi sorman ve ardından bu kararlara göre işe koyulman çok işime yarar.

Bu makalede kurduğumuz geliştirme ekibi, Claude Code ve Codex kullanarak tam da bu tür taleplere yaklaşmak için tasarlandı.

• Claude Code: Taleplerin iletişim noktası. Gerekli teyitleri ve iş bölümünü organize eder.
• Codex: Uygulamayı ve denetimi üstlenir.

Bir dava yönetim uygulaması için ekranı oluşturmanın yanı sıra doğrulama görevleri de hazırlarsın. Boş alanlarla kayıt yapmaya çalışırsan ne olur? Sayfa yenilendikten sonra kayıtlar kalıcı mı? Bir hata düzeltilmediyse, başka bir ajana devretmek için denenmiş düzeltmeleri ve kalan belirtileri özetle.

İnsanın yaptığı şey ise süreç boyunca gerekli yargıları vermek ve sonunda gerçek işleyişi doğrulamaktır. Bunu kolaylaştırmak için şartnamelerin, değişikliklerin ve doğrulama sonuçlarının düzenli bir şekilde eline döndüğü bir yapı kur. Bağlantı yöntemlerinden görev devrine ve durdurma koşullarına kadar bunu adım adım inşa edelim.

Claude'u Açık Tutarken Codex'e İş Ata

Önceki yanıtları başka bir yapay zekâya yapıştırmadan, talepleri Claude Code'dan Codex'e aktarmanın bir yolu var. OpenAI tarafından yayınlanan "Codex plugin for Claude Code" (Claude Code için Codex eklentisi) tam da bu işe yarıyor.

Resmi belgelere göre şu kullanım senaryolarını destekliyor:

• Mevcut değişiklikleri inceleyen değerlendirmeler (review)

• Araştırma veya düzeltmelerin devredilmesi

• Sohbet devir teslimleri

Bu makale, 16 Ekim 2026'da doğrulanmış resmi belgelere dayanarak yerel ortamdaki Claude Code üzerinden bu eklentinin nasıl kullanılacağı prosedürünü ele alıyor.

Ön Koşullar

• Claude Code'un çalıştığı bir ortam

• Git

• Node.js (resmi gereksinim: 18.18 veya üzeri)

• Codex ile kimliği doğrulanmış bir ChatGPT hesabı veya bir OpenAI API anahtarı

Eklenti, yerel Codex'inizi çağırır. Bağlanmak, Codex'in Claude'un kullanım kotasından çalıştığı anlamına gelmez; Codex kullanımı kendi kotasını tüketir.

Ayrıca bu kurulum yerel dosyalarla ilgilense de yapay zekâ çıkarımının tamamen bilgisayarınızda gerçekleşeceği garanti değildir. İçinde gizli bilgi barındırmayan bir deneme klasörüyle başlayın.

Eklentiyi Kurun

Claude Code giriş alanında aşağıdaki komutları yukarıdan aşağıya doğru tek tek çalıştırın. Bunlar normal bir terminale yapıştırılacak komutlar değil, Claude Code içinde eklenti ekleme işlemleridir.

1/plugin marketplace add openai/codex-plugin-cc
2/plugin install codex@openai-codex
3/reload-plugins
4/codex:setup

Son komut olan /codex:setup, Codex kurulumunu ve kimlik doğrulama durumunu kontrol etmenizi sağlar. Codex bulunamazsa ve npm mevcutsa kurulum için yönlendirme görünecektir; içeriği inceleyip buna göre ilerleyin.

Kimlik doğrulanmamışsa terminalde codex login komutunu çalıştırın ve yönergeleri izleyin.

Windows'ta, Claude'u çalıştıran ortam ile Codex'in kurulduğu ortamın birbirinden ayrı olmadığından emin olun. Sadece "bulunamadı" dedi diye sürekli yeniden kurulum yapmaktan kaçının.

Önce İncelemeyi (Review) Deneyin

Kodu yeniden yazmayan bir incelemeyle başlayın. Git ile yönetilen bir deneme projesinde küçük bir değişiklik hazırlayın ve şunu çalıştırın:

1/codex:review --background

• İlerlemeyi kontrol edin: /codex:status

• Tamamlanan sonuçları kontrol edin: /codex:result

Birden fazla talep aktif olduğunda, sonuçların birbirine karışmasını önlemek için görüntülenen Job ID'yi belirtin.

Amazon'ın Herkese Açık Örnekleri Görev Bölümü İçin Faydalıdır

Rol dağılımına referans olması için Amazon'un bulut iş birimi AWS tarafından yayınlanan geliştirme örneklerine bakabilirsiniz. GitHub'daki aws-samples sayfasında ilgili iki depo bulunuyor:

• sample-codex-agent-team (Codex için)

• sample-claude-code-agent-team (Claude Code için)

Codex sürümünde altı rol var:

Bir kayıt ekranının nasıl oluşturulacağına karar vermek ile ölçeklenebilirliği ve bakım maliyetlerini değerlendirmek farklı işlerdir. Özellik uygulamasını operasyonel danışmanlıktan ayırmak, belirli ajanlara yöneltilen soruları daha somut hale getirir.

Hafif incelemeler, riskli değişiklikleri baştan savma ele almak için değildir. Belge düzenlemeleri veya mekanik değiştirmeler gibi düşük riskli görevlerin her seferinde ağır denetimlere tabi tutulmasını önleyen bir bölme yöntemidir.

Görev devir yöntemleri iki örnek arasında farklılık gösterir:

• Claude Code sürümü: Ajanlar görevleri ortak bir görev listesinden çeker (deneysel ajan ekiplerini kullanır, ek yapılandırma gerektirir)

• Codex sürümü: Sorumluluk dosyalarının bölündüğü bir çalışma planına göre ilerler

Bunlar ayrı örneklerdir. İkisi de kurulursa otomatik olarak tek bir ekip halinde birleşmezler.

Ayrıca Codex sürümü, henüz yayınlanmamış bağlantı ayarlarını varsayan model spesifikasyonları içerir. Örneğin kendisi bunların herkesin hesabında doğrudan çalışmayacağını belirtir. Şirketinizin kritik projelerine olduğu gibi kopyalamak yerine, sadece rol dağılım mantığını benimseyin ve kendi kullanılabilir ortamınıza uyarlayın.

Bu makale, Claude Code'un arayüz görevi gördüğü ve sınırlı uygulama ile denetim görevlerini Codex'e aktardığı küçük bir yapıyla başlıyor.

Not: Bu, herkese açık örneklerden referans alınarak oluşturulmuş özgün bir operasyonel örnektir. Claude ve Codex'in AWS entegrasyonunu garanti eden bir ürün ya da ölçülmüş davranışların bir raporu değildir.

İnşa Etmeden Önce "Kaydedilebilir" Kavramını Netleştirin

Ne inşa etmek istediğinizi detaylıca tarif edemediğinizde hemen uygulamaya geçmeyin. Önce Claude'dan teyit maddelerini organize etmesini isteyin. Tüm teknik terimleri bilmenize gerek yok; sadece cevaplayabileceğiniz sorulara dönüştürülmesini sağlayın.

Kişisel bir dava yönetim uygulaması yapmak istiyorum. Lütfen önce gerekli şartnameleri organize et ve ihtiyaç duyulan kararlar hakkında bana her seferinde tek bir soru sor. Teknik tercihler için kullanıcıya etkisini ve önerme nedenini kısaca açıkla. Ben onay verene kadar uygulamaya başlama.

Örneğin kaydetme konusunda: Kayıtların aynı tarayıcıda kalıcı olması yeterli mi, yoksa akıllı telefon ve bilgisayar arasında paylaşım mı istiyorsunuz? Bunlar tamamen farklı mekanizmalar gerektirir. Sessizce birini seçmek daha sonra yeniden çalışmaya yol açar.

Bu alıştırma için kapsamı daraltın:

• Kapsam Dahili: Aynı bilgisayarda/tarayıcıda kullanım, yeniden yüklemeden sonra kayıtların kalıcı olması

• Kapsam Dışı: Çoklu cihaz senkronizasyonu, oturum açma, harici yayınlama, müşteri gerçek verileri

Tamamlanma kriterlerini "kullanımı kolay" gibi ifadelerle değil, işlem sonuçlarıyla tanımlayın:

• Dava kaydı yapılabiliyor

• Son tarihe göre sıralanıyor

• Durum değiştirilebiliyor

• Boş kayıt durumunda nedeni gösteriliyor

• Yeniden yüklemeden sonra içerik kalıcı oluyor

Şartnameleri ve Görev Taleplerini Dosyalara Kaydedin

Kararlaştırılan içeriği herkesin başvuracağı bir şartname olarak docs/spec.md dosyasına kaydedin. Buradaki dosya adları örnektir; tüm yapay zekâlara otomatik olarak dağıtılmazlar, bu yüzden her talepte "bunu oku" diye belirtmeniz gerekir.

Kararlaştırılan şartnameleri, tamamlanma kriterlerini ve kapsam dışı özellikleri docs/spec.md dosyasına kaydet. Karar verilmemiş konuları onaylanmış gibi yazma. Uygulamanın durdurulmasını gerektiren maddeleri, geçici ayarlarla devam edecek olanlardan ayır.

Ardından, uygulayıcılar için görev taleplerini docs/tasks.md dosyasında özetleyin. Sadece görevi adlandırmak yeterli değildir. Okunması gereken materyalleri, düzenlenebilir dosyaları, düzenlenemez kısımları, doğrulama yöntemlerini ve beklenen çıktıları dahil edin.

Şartnameleri uygulanabilir birimlere böl. Atanan dosyaları, ön koşul görevleri ve doğrulama yöntemlerini docs/tasks.md dosyasına yaz. Arayüz ve depolama mantığı arasındaki paylaşılan öğeleri önceden belirle. İki ajanın aynı dosyayı eşzamanlı olarak düzenlemesini planlama.

Her İki Yapay Zekâya da Aynı Şartnameyi Gösterin

Sürekli tekrarlanan talimatlar Claude için CLAUDE.md ve Codex için AGENTS.md dosyalarına yazılabilir. Bunlar belgelenmiş mekanizmalardır. Ancak bir dosyanın diğeri için de birebir aynı çalışacağını varsaymayın. Her ikisinin de aynı şartname dosyasına başvurmasını sağlayın.

Talimatları kısa tutun:

• Şartname dosyasının konumu

• Talepler dışında değişiklik yapmayın

Şartnameleri kopyalamak, bir tarafın güncelliğini yitirme riskini taşır. Bu yöntem o riski ortadan kaldırır.

Paralel Görevlerden Önce Çalışma Alanlarını Ayırın

Birden fazla yapay zekânın çalışması daha hızlı görünür, ancak aynı dosyayı farklı politikalarla yeniden yazmak insanlara sadece temizleme işi çıkarır.

İlk paralel çalışma için "Arayüz oluşturucu"yu "test planlayıcısı" ile eşleştirin. Format kesinleşmeden arayüzü ve depolamayı ayrı ayrı uygulamak uyumsuzluk sorunlarını artırır.

Klasörleri Ayırmak İçin Git Worktree Kullanın

Burada Git worktree işinize yarar. Aynı proje için farklı değişikliklerle ayrı çalışma klasörleri oluşturmanıza olanak tanıyan resmi bir Git özelliğidir.

Oluşturmadan önce şartnamelerin ve temel yapının Git'e commit edildiğinden emin olun. Commit edilmemiş taslak dosyalar yeni konumlara taşınamayabilir. Dal adlarının ve hedef klasörlerin kullanılmadığını doğrulayın.

1git worktree add -b feature/ui ../case-app-ui
2git worktree add -b feature/storage ../case-app-storage
3git worktree list

Üç uyarı:

1. Klasör oluşturmak yapay zekânın çalışma alanını değiştirmez. Her dizinde ayrı oturumlar açın ve başlamadan önce konumu/dalı doğrulayın.

1. Eklentiler çağıranın ortamını kullanır. Claude/Codex'i bağlamak otomatik izolasyon sağlamaz. Başlangıçta "konum başına bir editör" kuralına sadık kalın.

1. Worktree'ler esas olarak dosyaları izole eder. Paylaşılan veritabanları veya portlar çakışmaya neden olur. Test depolamalarını/portlarını ayırın veya başlatmaları sıraya koyun.

Codex'te Eşzamanlı Görevleri Sınırlandırın

Codex'te alt ajanları artırmak için eşzamanlı thread'leri sınırlandırın. Alt ajanlar, ana yapay zekâdan sınırlı görevler alır. .codex/config.toml dosyasındaki mevcut yapılandırma:

1[agents]
2enabled = true
3max_concurrent_threads_per_session = 2

• Girdileri çoğaltmayın

• Yalnızca güvenilir projelerde kullanın (proje ayarları yalnızca güvenilir bağlamlarda yüklenir)

• Sınır, Claude/oturumlar genelindeki toplam sayıyı değil, "o oturumdaki ana ajan hariç eşzamanlı thread'leri" ifade eder.

AWS örneğindeki 14 thread sadece onların tercihidir. Bir zorunluluk değildir. Onların max_threads değeri eski bir takma addır; güncel isimleri kullanın.

Uygulayıcıları Her Seferinde Sıfırdan Açıklamayın

Codex'te .codex/agents klasöründeki TOML dosyaları aracılığıyla özel ajanlar tanımlayın. Gerekli koşullarla task-builder.toml dosyasını oluşturun:

1name = "task-builder"
2description = "Implement only assigned scope from confirmed specs"
3developer_instructions = """
4Read docs/spec.md and docs/tasks.md first.
5Implement only assigned scope; stop and report if spec changes needed.
6Do not revert other agents' changes, read secrets, or publish externally.
7Return changed files, executed tests, results, and unconfirmed items.
8"""

Burada model adlarını sabitlemekten kaçının. Varsayılan olarak ana ayarları miras alır. Herkese açık örneklerdeki modeller sözleşmenizde mevcut olmayabilir; kullanılamayan adları kodlamak, rol açıklamasından bile önce başlatmayı durdurur.

Dosyayı yerleştirdikten sonra yeni bir Codex oturumunda tanınıp tanınmadığını doğrulayın ve küçük bir görev devredin. Claude'dan talep ediyorsanız, Codex'te task-builder kullanılacağını belirtin.

Codex'ten docs/tasks.md dosyasındaki yalnızca depolama mantığını task-builder'a devretmesini iste. Başlamadan önce ajanın tanınmasını ve gerçek klasörü doğrula. Kullanılamıyorsa sessizce yöntem değiştirmek yerine raporla.

Not: "Değiştirme" yazmak, yazma izinlerini kaldırmakla aynı şey değildir. Resmi belgeler, Codex alt ajanlarının ana izinleri (sandbox ayarları) miras aldığını belirtir. Rol adı "reviewer" (inceleyici) güvenli salt okunur ortamlar yaratmaz.

Düzeltmeler Tekrarlanırsa Ajan Değiştirin

Yapay zekâ "nedeni buldum" derken aynı işlem yine başarısız oluyorsa, bir sonraki düzeltmeye atlamak yerine neyin değiştiğini/değişmediğini kaydedin. Devretmek daha kolaydır.

Resmi eklentide, araştırma/düzeltmeleri Codex'e devretmek için bir rescue girişi vardır. Adına rağmen sadece hatalar için değil, kapsamlı görevler içindir.

Araştırmayı Açıkça Salt Okunur Olarak İşaretleyin

Yalnızca neden analizi yapılacaksa, yazma yapılmayacağını net bir şekilde belirtin. Dahili prosedürler, aksi belirtilmedikçe rescue işlemini varsayılan olarak yazılabilir kabul eder. Araştırma ve düzeltmeyi ayrı tutun.

1/codex:rescue --fresh Investigate why registration disappears on reload, read-only. Compare docs/spec.md and code. Return reproduction steps, evidence-based causes, needed checks. Do not modify files.

--fresh yeni bir talep başlatır; --resume öncekine devam eder (atlanırsa sorar). Devam ederken izinleri belirtin. Düzeltmeye geçiliyorsa kapsamı tanımlayın.

1/codex:rescue --resume Fix only storage logic with minimal changes based on confirmed cause. Do not change UI/specs. Show failing test before and result after.

Tüm Sohbeti Transfer ile Aktarın

• Sadece görevi aktarmak → rescue

• Sohbeti Codex'e taşımak → transfer

1/codex:transfer

Resmi belgelere göre: Mevcut Claude Code sohbetini sürdüren bir Codex thread'i oluşturur ve devam komutunu gösterir. Desteklenmiyorsa Codex'i güncelleyin.

Sohbeti aktarmak ≠ bilgisayar durumunu aktarmak. Kaydedilmemiş değişiklikler, kimlik doğrulamaları ve çalışan uygulamalar taşınmaz. Hedefteki dosyaları/durumu doğrulayın.

"Bitti" Dedikten Sonra Başka Bir Yapay Zekâyla Doğrulayın

Uygulayıcının test yapması faydalıdır, ancak şartnameyi yanlış anladıysa geçen testler istenen davranışla eşleşmez.

Denetçilere uygulayıcının açıklamalarını değil, insan tarafından doğrulanmış şartnameleri ve gerçek değişiklikleri verin. "Mükemmel düzeltildi" değerlendirmelerini paylaşmayın; uygunluğu bağımsız olarak kontrol etmelerine izin verin.

docs/spec.md ile gerçek değişiklikleri bağımsız olarak karşılaştır. Kanıtlarla birlikte karşılanmayan tamamlanma kriterlerini belirle. Uygulayıcının öz değerlendirmesini varsayma. Tekrarlanabilir sorunları, potansiyel endişeleri ve doğrulanmamış maddeleri ayır. Şimdilik düzeltme yapma.

Zıtlıkları eşleştirin:

• Claude uyguladı → Ayrı bir kontrol olarak Codex normal incelemesi ekleyin

• Codex uyguladı → Claude'dan denetlemesini isteyin, isteğe bağlı olarak yeni bir Codex incelemesi ekleyin

Normal vs. Çelişkili (Adversarial) İnceleme

Normal incelemeyi /codex:review ile çağırın. Dalı main ile karşılaştırın:

1/codex:review --base main

Main dalı yoksa gerçek temel dalı kullanın. İnceleme sırasında değişikliklere dokunmayın.

Not: Normal inceleme, "sadece depolamayı kontrol et" gibi serbest metin odak talimatlarını kabul etmez. Resmi spesifikasyon öncelik yönergelerini yasaklar. Tasarım varsayımlarına veya belirli risklere meydan okumak için adversarial-review kullanın.

1/codex:adversarial-review --background Check if save failures display as success, if editing from two tabs loses records, verify current design assumptions.

Bu sert bir üslup değildir; seçilen yaklaşımlara/varsayımlara meydan okur. Her iki inceleme de sorunları tespit eder, kodu düzeltmez. Sonuçları onaylayın, ardından düzeltmeleri ayrıca devredin.

Bulguları uygulanabilir tamamlanma kriterleri, kullanıcı etkisi ve doğrulama yöntemleriyle organize et. Şartname değişikliği gerektiren sorunları otomatik düzeltme; insana seçenekleri/farkları sun.

Başlangıçta İnceleme Geçidini (Review Gate) Atlayın

Otomasyon seçeneği: "İnceleme geçidi", Claude yanıtını bitirdiğinde Codex incelemesi ekler. /codex:setup --enable-review-gate ile etkinleştirilir.

Uyarı: Resmi belgeler, Claude/Codex arasında uzun düzeltme döngülerinin kotaları hızla tüketme riskine dikkat çekmektedir.

Bulguları anlamak için manuel incelemelerle başlayın. Uzaklaşırken devre dışı bırakın. /codex:setup --disable-review-gate ile durdurun ve bekleyen talepleri kontrol edin.

Başarılı Talepleri Sonraki Görevler İçin Saklayın

Uzun talimatları tekrar tekrar yapıştırmak yerine başarılı iş akışlarını kaydedin. Beceriler (Skills), görev prosedürlerini yeniden kullanmak üzere dosyalarda saklamanıza olanak tanır.

Anthropic belgelerine göre: Prosedürleri .claude/skills klasörüne yerleştirin. Devir öncesi kontrolleri içeren bir SKILL.md dosyasıyla team-brief klasörü oluşturun.

1---
2name: team-brief
3description: Organize scope and verification from specs
4disable-model-invocation: true
5---
6Read docs/spec.md and docs/tasks.md, targeting only current changes.
7Organize scope, forbidden changes, prerequisites, completion criteria, verification.
8Create request texts for agents, leaving undecided items for human confirmation.
9Do not change code, publish externally, or launch Codex in this procedure.

Claude Code'da çağırın:

1/team-brief Want to add sorting by deadline

Bu standart değil, özel bir komuttur. disable-model-invocation: true zamanlamayı insanın tetiklemesini sağlar. Claude otomatik başlamaz. Prosedürler yapay zekâ başlatmalarını/denetimlerini zorlamaz; önce "sadece yeniden kullanım hazırlığı" yaklaşımını deneyin.

Büyük Görevler İçin Dinamik İş Akışları

Daha büyük kapsamlar için Claude Code, birden fazla ajanı betikleyen Dinamik iş akışları (Dynamic workflows - Mayıs 2026'da duyuruldu) sunar. Ücretli planlarda/API'de mevcuttur.

• Normal sohbet: Claude her seferinde bir sonraki görevi seçer

• Dinamik iş akışları: Betik dalları/sonuç toplama, yeniden çalıştırılabilir

Örnek: Kaydetme hatalarını, giriş kontrollerini ve düzen bozulmalarını birden fazla ekranda ayrı ayrı araştırın, bulguları çapraz referanslayın. Küçük bir uygulamadan devasa ajanlar başlatmayın; aynı kontrolleri geniş çapta uygularken düşünün.

Bölünmüş ekranları araştıran, bulguları ayrı ajanlarla doğrulayan bir Dinamik iş akışı oluştur. Önce hedefleri, ajan sayısını ve çıkış koşullarını sun. Kod değişikliği yapma; onaydan sonra küçük bir kapsam yürüt.

İpuçları:

• Pro planda /config üzerinden etkinleştirin

• İlerlemeyi/kullanımı /workflows ile izleyin, istediğiniz zaman durdurun

• /config içinde ölçeği (küçük vb.) seçin; resmi belgeler bunları kesin sınırlar değil, tahminler olarak nitelendirir. Garanti edilmiş ajan sayıları olduğunu varsaymayın.

Bu, Claude tarafındaki ajanları çalıştırır. Codex otomatik olarak katılmaz. Önce Claude iç araştırma/doğrulaması için kullanın; Codex devrini ayrı bir aşama olarak ele alın.

Dava Yönetim Uygulamasını Uçtan Uca Çalıştırın

Bileşenleri tek bir uygulama yapısında birleştirin. Aşağıdakiler tamamlanmış bir deneyim raporu değil, açıklayıcı bir geliştirme örneğidir; kendi ortamınızda doğrulayın.

Derleme Hedefi

• Alanlar: Dava adı, son tarih, durum, notlar

• Durum: Başlamadı / Devam ediyor / Tamamlandı

• Dava adına göre arama

• Eksik davaların son tarihe göre sıralanmış görünümü

İlk Talep

Claude'a iletin. Mevcut kritik projeleri değil, yeni bir deneme klasörünü hedefleyin.

Deneme klasöründe kişisel bir dava yönetim uygulaması oluştur. Önce ortamı ve şartnameleri doğrula. Ad, son tarih, durum ve notlar için kayıt/düzenleme/arama/sıralama/kalıcılık özelliklerini dahil et. Oturum açma, senkronizasyon ve harici yayınlamayı hariç tut.

Depolama adayı: localStorage. Çoklu cihaz senkronizasyonu/yedeklemesi yoktur; tarayıcı verilerini temizlemek kayıtları siler. Değerli üretim bilgilerini buraya koymayın.

Temeli Oluşturun, Paylaşılan Kısımları Tanımlayın

Temeli tek bir ajan oluşturur. Uygulamanın başladığını ve boş ekranın görüntülendiğini doğrulayın. Gerekirse çalışma alanlarını ayırmadan önce şartnameleri/temeli Git'e commit edin.

• Arayüz ajanına verin: Görüntüleme alanları, eylem eşleştirmeleri

• Depolama ajanına verin: Kayıt formatı, okuma/ekleme/güncelleme yöntemleri, hata yönetimi

Hiçbirinin alan adlarını icat etmesine izin vermeyin. Durum alanı status ise, ikisi de onu kullanır. Kolaylık olsun diye bir tarafı state olarak değiştirmeyin; paylaşılan değişiklikleri ayarlama için Claude'a geri yönlendirin.

Codex'e Uygulama Talebi

Yazılabilir konumları VE gerekli kanıt çıktılarını belirtin.

1/codex:rescue --fresh Read docs/spec.md and docs/tasks.md. Implement only assigned storage logic and tests. Return changed files, commands, test results, unconfirmed items. Stop and report if spec changes or other agent edits needed.

Bu sırada Claude aynı dosyaları arka plandan değiştirmemelidir. Tamamlanma kontrollerine/test verisi hazırlığına odaklanın; sonuçlar döndükten sonra sonraki adımlara karar verin.

Doğrulama Verilerini Hazırlayın

• Dünkü son tarih, "Başlamadı"

• Bugünkü son tarih, "Devam ediyor"

• Gelecek haftaki son tarih, "Tamamlandı"

• Aynı son tarihe sahip birden fazla dava

• Uzun dava adları

Somut sıralama/görüntüleme kontrollerini mümkün kılar.

Detaylı kuralları şartnamede belgeleyin:

• Sıralama: Aynı son tarihler için kayıt sırası

• Boş alanlar: Ad/son tarih zorunlu; notlar isteğe bağlı. Eksik alanları göster.

• Tarihler: Tarih geçiş varsayımını tanımlayın. Gün kaymasına neden olan saat dilimi/saat işlemleri, uygulama şık görünse bile kullanılamaz hale getirir.

Kuralların önceden tanımlanması, uygulama sonrası tutarsız kontrolleri önler.

Entegre Edin ve Test Edin

Uygulamalar hazır olduğunda, Claude'dan değişiklik listelerini/test sonuçlarını okumasını ve entegrasyonu onaylamasını isteyin. Worktree kullanıyorsanız, değişiklikleri tek bir doğrulama dalında toplayın. Entegrasyondan sonra bireysel olarak geçen testleri yeniden çalıştırın.

Arayüz otomasyonu için Playwright kullanın. Güncel kılavuzlar yapay zekâ ajanları için CLI/Beceriler sunar; MCP tek yöntem değildir.

"Yapay zekâ tarayıcı kontrol mekanizmasını" "tekrarlanabilir testlerden" ayırın. Yeniden çalıştırılabilir kayıt-yeniden yükleme akışları için Playwright Test kullanın.

Kayıt, boş reddetme, arama, durum değişikliği, son tarih sıralaması ve kalıcılığı doğrulayan Playwright Testleri oluştur. Başlatma yapılandırmasını/test verilerini ayır. Testleri geçmek için uygulama davranışını/tamamlanma kriterlerini değiştirme.

Yeni deneme projesi için kurulum:

1npm init playwright@latest

Zaten kuruluysa, eklemeden önce mevcut başlatma/test yapılandırmalarını doğrulayın.

Tarayıcıların kurulu olduğundan emin olun, uygulama başlatmayı yapılandırın ve ardından çalıştırın:

1npx playwright test
2npx playwright show-report

Çok önemli: Hiç bulunmayan veya tamamı atlanan testleri "başarılı" olarak değerlendirmeyin.

Başarısızlık durumunda nedeni izole edin: Depolama hatası mı yoksa test olmayan bir butonu mu arıyor? Yeşil görmek için testleri silmeyin; orijinal şartnamelere göre düzeltme hedefine karar verin.

Son İnsan Doğrulaması

Görselleri manuel olarak kontrol edin. Gizli metin var mı? Yakın tarihli davaları bulmak kolay mı? Test raporlarının geçmesi kullanıcı deneyimini (UX) garanti etmez.

Uzun loglar yerine Claude'dan dört madde alın:

• Başlatma yöntemi

• Doğrulanmış davranışlar

• Kalan kısıtlamalar

• Sonraki düzeltme adayları

Bir öğeyi kendiniz kaydedin, yeniden yükleyin ve kalıcılığı doğrulayın. Ardından tamamlandı olarak işaretleyin.

Israrlı Düzeltmeleri Nerede Durdurmalı?

Ekip kapsamı genişledikçe bitiş noktalarını tanımlayın. Aynı hatada mı dönüp duruyoruz yoksa ardışık sorunları mı çözüyoruz? Belirsiz durumlar daha fazla talimat verilmesini engeller.

Durdurma Kriterlerini Belirleyin

"Sorun başına en fazla iki düzeltme" kuralını bir rehber olarak kullanın. Bu resmi bir öneri değil, tıkandığınızda kararı insana geri veren operasyonel bir kuraldır.

Aynı hata iki denemeden sonra düzeltilmemişse ek değişiklikleri durdur. Denenen eylemleri, yapılan değişiklikleri, kalan belirtileri ve gereken kararları özetle. İlgisiz özelliklere yayılma.

Sadece talimatlar durmayı garanti etmez. Kullanımı izleyin, gereksiz arka plan taleplerini /codex:cancel ile iptal edin. Ajanların gerçekten durduğunu doğrulayın.

Maliyetleri Ayrı Takip Edin

ChatGPT ile doğrulanmış Codex kotaları, API anahtarı fiyatlandırmasından farklıdır. Paralel ajanlar çıkarım/araç kaynaklarını tüketir.

Küçük metin düzenlemelerini her iki yapay zekâ/büyük inceleme üzerinden yönlendirmeyin.

Kategorilere ayırın:

• Tek başına tamamlanabilecek görevler

• İkinci bir bakış açısına ihtiyaç duyan görevler

• Bağımsız olarak paralelleştirilebilir görevler

Efor/kota tahsisine karar vermeye yardımcı olur.

Güncel Olmayan Model Spesifikasyonlarına Dikkat Edin

Eski model spesifikasyonları başarısızlıklara neden olur. OpenAI güncellemesi: GPT-5.5, ChatGPT ile doğrulanmış Codex için 15 Ekim 2026'da (JST) sona erdi. API anahtarı kimlik doğrulaması bundan etkilenmedi.

Eski spesifikasyonları/rol dosyalarını şu anda mevcut olan modellere güncelleyin. Sadece yeniden adlandırmakla yetinmeyin; seçilebilir modelleri ve kabul edilen akıl yürütme ayarlarını doğrulayın.

İzinleri ve Hook'ları Kontrol Edin

Claude izinleri her zaman Codex'e aktarılmaz. Her iki tarafta da yürütme haklarını doğrulayın. Üretim kimlik bilgileri olmadan pratik yapın. Silme, harici yayınlama ve faturalandırma için ayrı onay gerektirin.

Kullanmadan önce herkese açık örneklerdeki hook'ları inceleyin. Hook'lar belirlenen zamanlarda otomatik olarak çalışır; yalnızca işinize yarayan eklemeleri değil, gerçekte neyin çalıştığını görün.

"Hızlıca Geliştirildi" Kavramını Ölçmek

Yalnızca üretim süresini karşılaştırmayın.

• Yeniden açıklama yapma sayınız

• Entegrasyon/düzeltme süresi

• Kalan hatalar ve tamamlanma kriterleri arasındaki fark

Bir dahaki sefere aynı iş bölümünün işe yarayıp yaramayacağına karar verirken bunları da hesaba katın.

Küçük Haftalık Araçlarla Başlayın

Mühendis olmayan kişiler, doğruluğu kendileri değerlendirebildikleri alanlarda en kolay kazanımları elde eder.

• Talep takibi

• Sipariş son tarih kontrolleri

• Tutarlı sıralamalarla CSV biçimlendirme

Tanımlanabilir kullanım senaryolarıyla başlayın.

Önce son tarihi yaklaşanları mı görmek istiyorsunuz? Tamamlananları kaldırmak mı? Eksik girdilerde uyarı almak mı? Günlük ihtiyaçlarınız, yapay zekanın tamamlanma kriterlerine dönüşür.

Önce kodlama konusunda ustalaşmanıza gerek yok; koşullara dayalı prototipler oluşturun, kullanın ve düzeltin. Not: Müşteri veri sistemleri veya kamuya açık hizmetler, prototip başarısının ötesinde profesyonel bir doğrulama gerektirir.

Başlangıç için mevcut ekip yeterlidir:

1. Claude özellikleri düzenler

1. Codex tek bir görevi yürütür

1. Döndürülen sonuçları farklı bir bakış açısıyla doğrulayın

Bir sonraki uygulamada her şeyi baştan açıklamamak için işe yarayan istekleri/doğrulama yöntemlerini kaydedin.

Okuduğunuz için teşekkürler.

LINE Open Chat "Niku's AI Speed Strategy" ücretsiz 8 maddelik bir set dağıtıyor.

• Codex/Claude Code tanıtım rehberi

• Kopyala-yapıştır talimatları

• Hızlı başvuru tabloları

• 50 mini uygulama

• 50 görsel prompt'u

• yomiyasu kurulumu

• Başlık oluşturucu

• X para kazanma akışı/tutarları

Buradan alın 👇 https://x.gd/VtPmw