Codex’i terminal ve editör içinde kontrollü bir kodlama ajanı olarak kullan.
Windows kurulumu, CLI komutları, IDE entegrasyonu, AGENTS.md, izinler, inceleme ve otomasyon mantığı yeni başlayanlara göre açıklanır.
Codex nedir?
Codex, proje klasörünü inceleyebilen, kod yazabilen, komut ve test çalıştırabilen bir kodlama ajanıdır. CLI üzerinden terminalde veya desteklenen editör entegrasyonlarıyla kullanılabilir.
Üretilen değişiklikleri diff üzerinden okumak, test etmek ve yalnızca doğru olduğunda commit etmek geliştiricinin sorumluluğundadır.
Başlamadan önce
git status node --version npm --version
Windows kurulumu
Normal kullanıcı terminali yeterlidir.
PowerShell betiği veya npm paketi kullanılabilir.
PATH değişikliklerinin uygulanması için terminali kapatıp aç.
codex komutunu repository kökünde çalıştır.
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npm install -g @openai/codex
cd C:\Projects\promptla codex
VS Code ve IDE entegrasyonu
Codex uzantısını editörüne kurduğunda seçili kodu bağlama ekleyebilir, ajan görevlerini yan panelden yönetebilir ve değişiklikleri editör içinde inceleyebilirsin.
VS Code’da Ctrl+Shift+X kullan.
Yayıncı ve bağlantıları kontrol et.
Ajanın proje talimatlarını ve dosya yapısını doğru görmesini sağla.
Komut ve dosya değişikliği izinlerini göreve göre sınırla.
Temel CLI komutları
Oturum içinde kullanılan slash komutları, çalışma durumunu görmeyi ve inceleme başlatmayı kolaylaştırır.
| Komut | Ne için kullanılır? |
|---|---|
/init | Projeye uygun AGENTS.md başlangıcı oluşturmak için. |
/status | Oturum, çalışma dizini, izin ve model durumunu görmek için. |
/permissions | Ajanın dosya ve komut izinlerini kontrol etmek için. |
/model | Kullanılabilir model seçimini incelemek için. |
/review | Mevcut değişiklikler için kod incelemesi istemek için. |
codex /status /permissions /review
AGENTS.md proje talimatı
AGENTS.md, Codex’in projede nasıl davranacağını anlatan kalıcı kurallar için kullanılabilir. Talimatları kısa, denetlenebilir ve projeye özgü yaz.
# AGENTS.md ## Proje amacı PROMPTLA statik HTML/CSS/JavaScript öğrenme platformudur. ## Kurallar - Mevcut renk paletini ve navigasyon yapısını koru. - Firebase, PHP veya veritabanı ekleme. - Harici paket eklemeden önce gerekçe sun. - Mobil görünümü 360px genişlikte kontrol et. - Değişikliklerden sonra node --check ve bozuk bağlantı kontrolü çalıştır. - Son yanıtta değişen dosyaları ve test sonuçlarını listele.
Codex ile güvenli görev döngüsü
git status ve gerekli test komutlarını çalıştır.
İstenen çıktı, kısıtlar ve kabul ölçütlerini yaz.
Ajanın dokunacağı dosyaları açıklamasını sağla.
İlgisiz refactor veya paket güncellemesini engelle.
/review ve git diff ile değişiklikleri kontrol et.
Tarayıcı, mobil, JS sözdizimi ve link kontrollerini çalıştır.
Doğrulanmış değişiklikleri kaydet.
Doğrudan kullanılabilecek görevler
Arayüz hatası düzeltme
Videoda görülen arayüz hatasını analiz et. - Önce hatanın tekrar üretim adımlarını çıkar. - İlgili HTML, CSS ve JavaScript davranışını incele. - Mevcut tasarımı değiştirmeden en küçük düzeltmeyi uygula. - Masaüstü ve mobilde test et. - Değişen satırları ve nedenini özetle.
Repository inceleme
Bu repository için kod incelemesi yap. Öncelik sırası: güvenlik, kırık bağlantılar, mobil navigasyon, erişilebilirlik, performans. Henüz kod değiştirme. Her bulgu için dosya, risk, kanıt ve önerilen düzeltmeyi yaz.
Codex ve otomasyon
Tekrarlanan inceleme veya dönüşüm işleri komut satırı tabanlı, yeniden çalıştırılabilir görevler hâline getirilebilir. Otomasyonlarda giriş dosyalarını, izinleri, beklenen çıktıyı ve hata davranışını netleştir.
codex exec "Projeyi analiz et, bozuk iç bağlantıları raporla; dosyaları değiştirme."
Otomatik çalışan ajanlara ilk aşamada yalnızca raporlama yaptırmak, doğrudan yayın kodu değiştirmekten daha güvenlidir.
Sık yapılan hatalar
| Hata | Neden sorun? | Daha iyi yaklaşım |
|---|---|---|
| Çok geniş görev | İlgisiz dosyalar değişebilir. | Tek özellik, açık kabul kriteri ve dosya sınırı kullan. |
| Diff okumadan onay | Görünmeyen kırılmalar kalabilir. | git diff ve /review çalıştır. |
| API anahtarını prompta yazmak | Log veya geçmişte açığa çıkabilir. | Ortam değişkeni ve credential yönetimi kullan. |
| Test komutu vermemek | Ajan yanlış doğrulama yapabilir. | AGENTS.md içinde proje testlerini belirt. |
Resmi kaynaklar
Kurulum ve komut bilgileri OpenAI’nin resmi Codex dokümantasyonu temel alınarak hazırlanmıştır.