Claude Code'a Codex Kurun: Bug Döngülerinden Kurtulma Rehberi

Claude bir bug'da 20.000 token boyunca aynı yanlış izi kovalıyorsa, hata Claude'da değil — kurulumda. Aynı modele aynı kodu tekrar tekrar review ettirmek tanım gereği döngü üretir.

openai/codex-plugin-cc, OpenAI'nın resmi Claude Code plugin'i. 30 saniyelik kurulumla Codex'i Claude Code içine subagent olarak takıyor: Claude planlar, Codex kod cerrahisini yapar, sen sonucu Claude'da review edersin. 19k star, Apache-2.0 lisansı.

Codex Plugin nedir?

Claude Code'un içinden /codex:* slash komutlarıyla Codex CLI'ı çağıran bir plugin. Ayrı bir runtime kurmuyor — makinende zaten kurulu Codex CLI'ı ve login'ini kullanıyor. Tek başına Claude kullanan birinin ikinci bir model devreye alarak hem token tasarrufu yapması hem de aynı modelin kendi yazdığını review edememe problemini çözmesi için tasarlanmış.

İki ana kullanım var: review (kod incelemesi) ve rescue (takılı görevi devretme). Adversarial review, background mode, küçük model hedefleme ve resumable session gibi katmanlar bu ikisinin üstüne biniyor.

01 — Neden bu kurulum?

Çoğu kişi Claude Code'u tek geliştirici gibi kullanıyor. Bu plugin onu takıma çeviriyor. İş bölümünün getirdiği 5 somut fayda:

• Bug döngüsünden çıkış. Claude aynı yanlış varsayıma takıldığında /codex:rescue görevi taze gözlü Codex'e devreder. Çoğu zaman Claude'un yirmi denemede çözemediğini tek geçişte çözüyor.
• Background work, temiz context. --background flag'i Codex review veya rescue'yu paralel çalıştırır. Sen Claude'da çalışmaya devam edersin, context'in kirlenmez.
• Adversarial review. /codex:adversarial-review satır satır bug aramak yerine "bu yaklaşım doğru muydu" diye sorar. Claude'un yakalayamayacağı şeyleri yakalar çünkü kodu Claude yazdı.
• Ucuz, hızlı geçişler. --model spark veya --model gpt-5.4-mini ile küçük modelle hızlı bakış. Hiçbir tarafta büyük model token'ı yanmaz.
• Resumable session. Her Codex çalışması session ID alır. Standalone Codex penceresinde codex resume <id> ile aynı yerden devam edersin.

02 — Ön gereksinimler

Yeni hesap, yeni faturalama yok. Üç şey lazım:

• Çalışan Claude Code kurulumu
• Node.js 18.18 veya üzeri (node --version)
• ChatGPT hesabı (Free çalışır) veya OpenAI API key

Maliyet: Codex kullanımı ChatGPT abonelik limitlerine veya OpenAI API key'ine karşı sayılır. Plugin yeni billing açmıyor, sadece Codex'i Claude Code'a subagent olarak expose ediyor. Makinende zaten Codex CLI varsa login'ini otomatik alır — aynı CLI, aynı config.

03 — Kurulum: 5 komut

Claude Code'u herhangi bir projede aç ve sırayla çalıştır. Kopyala-yapıştır, tekrar yazma.

/plugin marketplace add openai/codex-plugin-cc

/plugin install codex@openai-codex

/reload-plugins

/codex:setup

Dördüncü komut Codex CLI'ın kurulu olup olmadığını kontrol eder. Yoksa kurmayı teklif eder, "yes" de. Manuel kurulum istiyorsan ayrı bir terminalde:

npm install -g @openai/codex

Setup login istiyorsa beşinci adım:

/codex login

Tarayıcı açar. ChatGPT ile giriş yap veya API key yapıştır.

Doğrulama: Claude Code içinde /agents çalıştır. codex:codex-rescue ve birkaç /codex:* komutu listede olmalı. Yoksa /reload-plugins'i bir kez daha çalıştır.

04 — Altı slash komut

Plugin'in eklediği her komut ve ne zaman kullanılacağı:

/codex:review — Commit edilmemiş değişikliklerin veya branch vs main için read-only review. Multi-file review bir dakika sürer, --background ekle.

/codex:review --base main --background

/codex:adversarial-review — Insanların atladığı en değerli komut. Spesifik bir şeyi challenge etmesini istediğinde gerçek sonuç verir.

/codex:adversarial-review --base main --challenge whether this caching design holds under load

/codex:rescue — Takılı görevi Codex'e devreder. Claude döngüye girdiğinde veya küçük model denemek istediğinde.

/codex:rescue --background investigate the flaky integration test
/codex:rescue --model gpt-5.4-mini --effort medium fix the smallest safe patch

/codex:status — Çalışan ve son Codex job'larını gösterir.

/codex:result — Bitmiş job'ın çıktısını ve session ID'sini verir. codex resume <session-id> ile standalone pencerede devam edebilirsin.

/codex:cancel — Codex tavşan deliğine girdiğinde aktif background job'u kapatır.

05 — Günlük 5 pattern

Asıl amaç Claude'un yapmasına gerek olmayan işi devretmek.

Önemsiz olmayan hiçbir şeyi commit etmeden önce:

/codex:review --background

Kodlamaya devam et. /codex:status ve /codex:result ile bittiğinde kontrol et. Claude'un kaçırdığını yakalar — çünkü gerçekten farklı bir model bakıyor.

Claude bug'da döngüye girdiğinde:

/codex:rescue --background investigate why this test keeps failing after the fix

En yüksek değerli hamle. Claude aynı fix'i ikinci kez yazmaya başladığı an, savaşmayı bırak ve devret. 30 saniyeye mal olur, bir saat kazandırır.

Para, auth veya data'ya dokunan bir şeyi ship etmeden önce:

/codex:adversarial-review --background challenge whether this handles partial failures

Spesifik challenge metni şart. "Bunu review et" generic feedback verir; "partial failures handle ediyor mu challenge et" risk alanına gerçek baskı uygular.

Büyük model token'ının aşırı olduğu küçük sorularda:

/codex:rescue --model spark investigate why this env var isn't loading

spark veya gpt-5.4-mini hızlı cevap için. Derin session değil.

Bir göreve tam Codex penceresinde devam etmek için:

/codex:result çalıştır, session ID'yi kopyala, regular terminalde:

codex resume <session-id>

Plugin'in bıraktığı yerden tam Codex arayüzüyle devam edersin.

06 — Bir şey bozulursa

Yanlış model kullanılıyor: Proje root'unda .codex/config.toml oluştur:

model = "gpt-5.4-mini"
model_reasoning_effort = "high"

Veya global ~/.codex/config.toml ile ayarla. Plugin zaten kullandığın Codex config'i alır.

Review gate hakkında: Claude her ship denediğinde otomatik Codex review çalıştıran opsiyonel ayar var. Açık bırakma — Claude-Codex döngüsü yaratıp kullanımı hızla zincirleyebilir. Kritik kod ship ederken aç, diğer zamanlar kapat:

/codex:setup --enable-review-gate
/codex:setup --disable-review-gate

Hızlı Başlangıç

• Claude Code'u aç, sırayla çalıştır: /plugin marketplace add openai/codex-plugin-cc → /plugin install codex@openai-codex → /reload-plugins → /codex:setup
• Setup login isterse /codex login ile ChatGPT veya API key ile giriş yap
• /agents ile codex:codex-rescue listede mi kontrol et
• Claude'un bir sonraki bug döngüsünde /codex:rescue --background çalıştır — rescue süresini döngü süresiyle kıyasla
• Ship'ten önce kritik kod için /codex:adversarial-review --background challenge ... ekle

Kaynak: github.com/openai/codex-plugin-cc