İçeriğe geç
~/gamze_
cd ../blog

> cat ./blog/codex-cli-ile-calismak.md

Codex CLI ile Çalışmak

·5 dk okuma

#Yapay Zeka#Codex Cli

Cuma akşamı 17:40. Yarım kalmış bir refactor, yarın sabaha kadar geçmesi gereken testler ve seni bekleyen bir hafta sonu var. Codex’e “şunu düzelt” demek çok cazip. Ama ajanı başıboş bırakmak mı, her komutta onay vermek mi? İkisi de kötü. Codex CLI’ı iyi kullanmanın sırrı bu ikisi arasında doğru dengeyi kurmak. Bunun için üç düğmen var:

  1. Ne bilsin? AGENTS.md ile belirlenir.
  2. Nereye dokunabilsin? Kum havuzu (sandbox) ile belirlenir.
  3. Ne zaman sorsun? Onay modu ile belirlenir.

Bu yazıda her düğmeyi sırayla ayarlıyor, sonra bunları bir iş gününe yayıyoruz.

Önce kurulumu doğrula

codex login status
codex doctor

İlk çalıştırmada codex seni ChatGPT hesabınla oturum açmaya yönlendirir. codex login status girişin açık olup olmadığını söyler. codex doctor ise kurulum, yapılandırma, kimlik doğrulama ve Git durumunu tek raporda toplar. Bir şey ters gittiğinde ilk bakacağın yer burası olsun.

Düğme 1: Ne bilsin? (AGENTS.md)

Codex her çalıştığında AGENTS.md dosyalarını okur. Bunu ajanın işe ilk gün başlarken aldığı "iş yeri rehberi" gibi düşün. Katmanlı çalışıyor: önce ~/.codex altındaki genel dosya, sonra proje kökünden bulunduğun klasöre kadar inen dosyalar yüklenir. Sonda yer alan, yani sana en yakın dosya öncelik kazanır.

Kişisel alışkanlıklarını genel dosyaya yaz:

# ~/.codex/AGENTS.md

## Çalışma anlaşmalarım

- JavaScript dosyalarını değiştirdikten sonra `npm test` çalıştır.
- Bağımlılık kurarken `pnpm` tercih et.
- Yeni üretim bağımlılığı eklemeden önce onay iste.

Projeye özgü kuralları depoda tut, böylece ekip de faydalansın:

# AGENTS.md

## Depo beklentileri

- Pull request açmadan önce `npm run lint` çalıştır.
- Davranış değişirse `docs/` içinde dokümante et.

Bir klasör kendi kurallarıyla çalışıyorsa orada AGENTS.override.md kullan. Aynı klasördeki AGENTS.md bu durumda yok sayılır:

# services/payments/AGENTS.override.md

## Ödeme servisi kuralları

- `npm test` yerine `make test-payments` kullan.
- API anahtarlarını güvenlik kanalına haber vermeden yenileme.

Ajanın neyi okuduğundan emin olmak istersen ona sor:

codex --ask-for-approval never "Şu an yüklü talimatları özetle."

Beklediğin kural cevapta yoksa yukarıdaki klasörlerde bir override dosyası unutulmuş olabilir. Toplam boyut varsayılan olarak 32 KiB ile sınırlı. Talimatların büyürse ~/.codex/config.toml içinde sınırı yükselt ya da başka dosya adlarını da tanıt:

project_doc_fallback_filenames = ["TEAM_GUIDE.md", ".agents.md"]
project_doc_max_bytes = 65536

Düğme 2 ve 3: Nereye dokunsun, ne zaman sorsun?

Bu iki ayar birbirinden bağımsız. Kum havuzu ajanın ne yapabileceğini, onay modu ise ne zaman durup sana soracağını belirler.

codex --sandbox workspace-write --ask-for-approval on-request

Kum havuzunun üç seviyesi var:

  • read-only: Ajan yalnızca okuyabilir. İnceleme ve keşif için ideal.
  • workspace-write: Çalışma klasöründe dosya yazabilir. Günlük iş için makul.
  • danger-full-access: Sınır yok. Ne yaptığını bilmiyorsan dokunma.

Onay modunda on-request ajanın gerektiğinde sana sormasını, never ise hiç durmamasını sağlar. Dokümanın günlük yerel iş için önerdiği kombinasyon yukarıdaki: klasörde yazabilsin ama gerektiğinde sorsun.

Bir de kırmızı düğme var: --yolo. Uzun adıyla --dangerously-bypass-approvals-and-sandbox. Hem onayı hem korumayı kapatır. Adı ciddi bir uyarı içeriyor ve dokümana göre yalnızca dışarıdan sertleştirilmiş, izole bir ortamda kullanılmalı. Dizüstü bilgisayarında değil. Eski --full-auto bayrağı ise kullanımdan kalktı, yerine --sandbox workspace-write öneriliyor.

Bir iş gününün akışı

Şimdi düğmeleri gerçek bir güne yayalım.

Sabah: Göreve başla

codex "auth modülündeki testleri çalıştır ve hataları düzelt"

Görevi doğrudan komutun içine yazabilirsin. İşin ihtiyaç duyduğu ek bağlamı bayraklarla ver:

codex -m gpt-6-sol "bu fonksiyonu sadeleştir"
codex --add-dir ../ortak-kutuphane "iki projede tutarlılık kontrolü yap"
codex -i hata-ekrani.png "bu ekran görüntüsündeki hatayı bul"
codex --search "bu kütüphanenin son sürümündeki değişiklikleri araştır"

-m modeli seçer. --add-dir ek bir klasöre yazma erişimi verir. -i görüntü ekler. --search canlı web aramasını açar. Varsayılan olarak Codex önbellekli aramayı kullanır.

Öğlen: Yarım kalanı sürdür

Toplantıdan döndün, oturum ortada kaldı:

codex resume
codex fork

codex resume önceki oturumdan devam eder. codex fork ise oturumu kopyalayıp yeni bir sohbet açar. Böylece bir fikri riskli şekilde denerken orijinal transkript bozulmaz.

Öğleden sonra: Göndermeden önce incele

codex review --uncommitted
codex review --base main
codex review --commit abc1234

Bu komut etkileşimsiz çalışır. Commit edilmemiş değişikliklere, ana dala göre farka veya tek bir commit’e bakabilirsin. Bu üç hedef bayrağı ile özel bir talimat birbiriyle çakışır, bu yüzden birini seç.

Akşam: İşi otomasyona bağla

Codex’in gerçek gücü, sohbet penceresinden çıkıp betiğe girdiğinde ortaya çıkıyor. Bunun için codex exec var:

codex exec --sandbox read-only "bu depodaki TODO yorumlarını listele"

Çıktıyı dosyaya yazdırmak veya makine tarafından okunur hale getirmek için:

codex exec -o sonuc.txt "değişiklik özeti hazırla"
codex exec --json "testleri çalıştır" > olaylar.jsonl

-o asistanın son mesajını dosyaya yazar. --json her durum değişikliğini satır satır JSON olarak verir. Cevabın şeklini de sabitleyebilirsin: --output-schema ile bir JSON şema dosyası verirsen çıktı buna göre doğrulanır. Bu, sonucu başka bir araca beslediğin zincirlerde çok işe yarıyor.

Küçük bir push öncesi betiği örneği:

#!/usr/bin/env bash
set -e

codex review --base main
codex exec --sandbox read-only -o ozet.txt "son değişiklikler için kısa bir PR açıklaması yaz"
echo "PR açıklaması ozet.txt dosyasında."

Yarım kalan bir exec görevini sürdürmek için:

codex exec resume --last "kaldığın yerden devam et"

CI ortamında --sandbox read-only ile başla, gerçekten yazma gerekiyorsa workspace-write'a geç.

Gece: Buluta devret

Laptop’u kapatacaksın ama iş bitmesin:

codex cloud exec --env ORTAM_KIMLIGI --attempts 3 "modülü yeniden yaz"
codex apply GOREV_KIMLIGI

cloud exec görevi Codex'in bulut ortamına gönderir. --attempts kaç deneme yapılacağını belirler (1 ile 4 arası), sen de en iyi sonucu seçersin. Ertesi sabah codex apply ile o bulut sohbetinin son farkını yerel çalışma ağacına uygularsın. Bulut ortamlarını listelemek için sadece codex cloud yazman yeterli.

Araç eklemek ve ayarlar

Harici araçları MCP ile bağlarsın:

codex mcp add ornek-sunucu -- npx ornek-mcp-paketi
codex mcp list

Kalıcı ayarların ~/.codex/config.toml dosyasında durur. Tek seferlik bir değişiklik için -c anahtar=değer yazabilirsin. Farklı iş türleri için ayrı profil dosyaları tutup -p ile çağırmak da mümkün. Örneğin "inceleme" ve "geliştirme" için farklı ayarlar hazırlayabilirsin.

Kendime notlar: Yapmayacaklarım

  • --yolo'yu yerel makinede çalıştırmayacağım. Yalnızca izole ortamlarda.
  • Talimatı yüklendi sanmayacağım. Şüphedeysem ajana “hangi talimatları yükledin?” diye soracağım.
  • Her şeye izin vermeyeceğim. read-only ile başlayıp ihtiyaç oldukça yükselteceğim.
  • CI’da etkileşim beklemeyeceğim. Otomasyonda codex exec kullanacağım.
  • Bulut sonucunu körlemesine uygulamayacağım. codex apply öncesi farkı okuyacağım.

Codex’i iyi kullanmak, komut ezberlemekten çok üç soruyu doğru cevaplamaktan geçiyor: ne bilmeli, nereye dokunabilmeli, ne zaman sormalı. Bu üçünü ayarladıktan sonra aynı araç hem sabah sohbet arkadaşı, hem akşam CI işçisi, hem de gece bulutta çalışan bir yardımcı oluyor. Düğmeleri sen çevirdiğin sürece sürpriz yaşamazsın.

Bu yazı ilk olarak Medium'da yayımlandı. Yorum ve alkış için:

Medium'da aç