geliştiriciler için rehber · 18 iş
Geliştiriciler için yapay zeka: kodlama ajanları, maliyetler ve güvenli devir
Kod tamamlamayı ve sohbeti zaten kullanıyorsanız bir sonraki adım depoyu okuyan, komut çalıştıran ve pull request açan ajanlardır. Bunun zaman kazandırıp kazandırmadığı modelden çok kuruluma bağlıdır. İlk bölüm her kodlama ajanıyla çalışır; Claude Code ve Codex bölümleri, resmî belgelerine dayanarak her birinin komutlarına, dosyalarına ve ayarlarına girer.
Her kodlama ajanı
01
Ajana bitirdiğini kanıtlayabileceği bir görev verin
Ajanlar “bunu iyileştirin” gibi isteklerde başarısız olur, bir kontrolle biten görevlerde başarılı olur: geçmesi gereken başarısız bir test, çıktısı değişmesi gereken bir komut. Kanıtı göreve yazın; ajan bitmiş göründüğünde durmak yerine gerçekten bitene kadar devam eder.
Örnek
“ISO hafta tarihleri için tarih ayrıştırıcısını düzeltin. Bitti demek, 2026-W01 için yeni test dahil npm test -- dates komutunun geçmesi demektir. Testleri değiştirmeyin.” Ajan testi geçene kadar çalıştırır ve çıktıyı yapıştırır; siz bir tahmin yerine 30 satırlık bir diff incelersiniz.
Nasıl yapılır
- 1Görevi devretmeden önce kontrolü yazın veya gösterin: başarısız test ya da komut ve beklenen çıktısı.
- 2Görevi bu sayfadaki istemle verin; değiştirebileceği ve değiştiremeyeceği dosyaları da belirtin.
- 3Kontrolü kendisinin çalıştırmasına ve son çıktıyı yapıştırmasına izin verin.
- 4Diff'i bir iş arkadaşının pull request'i gibi inceleyin; geçen bir kontrol incelemeyi bitirmez, başlatır.
Yerleşik
Kopyalanacak istem
Görev: [değişiklik]. Bitti demek: [test veya komut] geçer ve [beklenen çıktı] yazdırır. Bitirmeden önce çalıştırın ve sonucu yapıştırın. Değiştirebilirsiniz: [yollar]. Değiştirmeyin: [yollar], bağımlılıklar veya testler. Geçirmeyi başaramazsanız kontrolü atlatmaya çalışmak yerine durun ve nedenini açıklayın.Nerede ters gider
- Ajanlar bazen bir testi zayıflatarak geçirir. Testlerin değiştirilmesini yasaklayın ve diff'te buna bakın.
- Tek bir kontrol için fazla büyük olan bir görev, tek bir devir için de fazla büyüktür. Bölün.
02
Siz başka bir işle uğraşırken görevleri bulutta çalıştırın
Bulut ajanları deponuz üzerinde kendi ortamlarında çalışır ve incelemeniz için değişikliklerle döner; böylece siz başka bir şey yaparken birkaç görev birden yürür. Bu yalnızca iyi tanımlanmış görevlerde işe yarar; belirsiz görevler ayıklamanız gereken büyük diff'ler olarak geri gelir.
Örnek
Öğle yemeğinden önce üç küçük görev: bir bağımlılığı yükseltmek, eksik bir veritabanı dizini eklemek, kararsız bir testi düzeltmek. Her biri kendi kontrolüyle bir bulut ajanına gider ve öğleden sonra üç kez bağlam değiştirmek yerine üç pull request incelersiniz.
Nasıl yapılır
- 1Kodunuzun bulunduğu yere en yakın olanı seçin: Codex Cloud, GitHub'daki Copilot bulut ajanı ya da Claude Code on the web.
- 2Ortamının bağımlılıklarınızı kurabildiğinden ve testlerinizi çalıştırabildiğinden emin olun; bunlar olmadan ajan tahminde bulunur.
- 3Küçük, birbirinden bağımsız görevler gönderin; yukarıdaki işte olduğu gibi her birinin kendi kontrolü olsun.
- 4Her pull request'i önce otomatik bir inceleyicinin okumasını sağlayın, ardından kendiniz inceleyin.
Yerleşik
Kopyalanacak istem
Bu depoda: [görev]. Bağlam: [kodun neresi, ilgili issue]. Bitti sayılır: [test veya komut] sizin ortamınızda geçtiğinde; çıktısını pull request açıklamasına koyun. Pull request'i [n] değişen satırın altında tutun. Daha fazlası gerekiyorsa durun ve nasıl bölüneceğini önerin.Nerede ters gider
- Ayarlamadığınız gizli bilgilere veya hizmetlere ihtiyaç duyan testler atlanır ya da başarısız olur. Bunlar olmadan yeşil bir çalıştırma pek bir şey kanıtlamaz.
- Birbiriyle ilişkili kod üzerinde çalışan birkaç ajan çakışan pull request'ler üretir. Paralel görevleri ayrı alanlarda tutun.
03
Kontrollerin siz olmadan çalışmasını sağlayın
İnceleme zamanınızı bir makinenin kontrol edebileceği şeylere harcamayın. Hook'lar, ajanın yaptığı her değişiklikten sonra biçimlendiricinizi, linter'ınızı ve testlerinizi çalıştırır; bir inceleme botu da her pull request'i sizden önce okur. Böylece incelemeniz yazım hatalarıyla değil, tasarımla ilgili olur.
Örnek
Bir hook her düzenlemeden sonra biçimlendiriciyi ve birim testlerini çalıştırır. Ajanın değişikliği iki testi bozar; ajan hatayı hook çıktısında görür ve siz bakmadan düzeltir. Ardından inceleme botu ele alınmamış bir hata durumunu işaretler; ona siz karar verirsiniz.
Nasıl yapılır
- 1Derleme, test ve lint komutlarınızı, ajanınızın her oturumun başında okuduğu talimat dosyasına yazın; dosyanın adı her ajanın belgelerinde belirtilir.
- 2Claude Code'da her düzenlemeden sonra biçimlendiriciyi ve testleri çalıştıran hook'lar ekleyin; böylece ajan hataları görür ve düzeltir.
- 3Her pull request'i bir bota inceletin: Codex'te Automatic review özelliğini açın ya da Copilot'u inceleyici olarak isteyin.
- 4Ajan aynı hatayı iki kez yaparsa bunu bir teste veya talimat dosyasında bir kurala dönüştürün.
Yerleşik
Kopyalanacak istem
Bu depoyu okuyun ve kodlama ajanları için talimat dosyasını yazın: 1. Kurulum, derleme, test, lint ve biçimlendirme için tam komutlar. 2. En fazla 10 satırda proje yapısı. 3. Yeni gelenlerin burada yanlış yaptığı kurallar, her biri için bir örnekle. 4. Bir ajanın burada asla yapmaması gerekenler, örneğin migration'ları değiştirmek veya üretilmiş dosyaları düzenlemek. Yalnızca başarıyla çalıştırdığınız komutları listeleyin; geri kalanları “doğrulanmadı” olarak işaretleyin.Nerede ters gider
- Artık çalışmayan komutlar içeren bir talimat dosyası, ajana dosyayı yok saymayı öğretir. Kurulum değiştiğinde komutları yeniden çalıştırın.
- İnceleme botları da kendinden emin hatalar yapar. Yorumlarını öneri olarak değerlendirin.
04
Ajanı araçlarınıza en az erişimle bağlayın
Bir ajan ancak görebildikleri kadar iyidir: issue'lar, belgeler, loglar, veritabanı şeması. MCP bunları bağlar, ancak her bağlantı bir erişimdir ve dışarıdan okuduğu metin talimat taşıyabilir. Salt okunur erişimle başlayın ve yalnızca bir görev gerektirdiğinde genişletin.
Örnek
Ajan takip sisteminden 482 numaralı issue'yu okur, loglarda yığın izini bulur ve kütüphanenin belgelerine bakar, ardından hatalı dosyayı söyler; hepsini salt okunur token'larla yapar. Düzeltmeyi deponuza yazar ve siz onu her zamanki gibi incelersiniz.
Nasıl yapılır
- 1Sohbetlere en sık yapıştırdığınız şeyleri listeleyin; örneğin issue'lar, hata logları, belgeler veya şema. Önce bunları bağlayın.
- 2Her biri için resmî MCP sunucusunu, yalnızca okuyabilen bir token'la ekleyin. Gemini CLI'da bir uzantı MCP sunucusunu ve kurulumunu bir arada sunabilir.
- 3Ona bunlara ihtiyaç duyan bir görev verin ve doğru olanı çağırdığını kontrol edin.
- 4Birkaç haftada bir artık kullanmadığınız sunucuları kaldırın.
Yerleşik
Kopyalanacak istem
Herhangi bir şeyi değiştirmeden önce: takip sisteminde [id] numaralı issue'yu okuyun, loglarda hatayı bulun ve [kütüphane] belgelerine bakın. Her birinin size ne söylediğini ve hangi dosyanın hatalı olduğunu düşündüğünüzü söyleyin. Bağlı hiçbir araca yazmayın.Nerede ters gider
- Bir web sayfası, issue veya belge, ajanı yönlendirmek için yazılmış metin içerebilir. Dışarıdan içerik okuyan araçlara yazma erişimi vermeyin.
- Yapılandırma dosyalarındaki token'lar sızar. Depoyu asla kullanmayın; istemcinin gizli bilgi deposunu veya ortam değişkenlerini kullanın.
05
Abonelik ile token başına ödeme arasında seçim yapın
Ajan oturumları dosya okur ve çok sayıda adım çalıştırır; bu yüzden bir sohbetten çok daha fazla token kullanır. Seçmeden önce kendi kullanımınızın tipik bir haftasını fiyatlandırın: abonelik etkileşimli kullanımın maliyetine tavan koyar, token başına faturalandırma ise her otomatik çalıştırmaya ayrı sınır koymanızı sağlar.
Örnek
Her gün ajan kullanılan bir hafta yaklaşık 40 milyon girdi ve 3 milyon çıktı token'ı eder. Bunu API fiyatları sayfasında kullandığınız modelin fiyatıyla hesaplayın ve aylık abonelikle karşılaştırın. Abonelik daha ucuzsa ve sınırları haftanıza uyuyorsa onu alın; CI için de sınırlı bir API anahtarı tutun.
Nasıl yapılır
- 1Zaten neye ödeme yaptığınızı kontrol edin: ChatGPT planları Codex'i, Claude'un ücretli planları Claude Code'u içerir.
- 2Ajanınızın gösterdiği yerlerde birkaç tipik oturumun token kullanımını not edin.
- 3Bu kullanımı API fiyatları sayfamızda fiyatlandırın ve abonelikle karşılaştırın.
- 4Otomasyon ve CI için harcama sınırı olan API anahtarları kullanın; böylece bir döngü faturayı şişiremez.
Yerleşik
Kopyalanacak istem
[n] tipik oturumdaki kullanımım: [girdi ve çıktı token'ları]. Haftada yaklaşık [gün] gün çalışıyorum. Bu fiyatlarla token başına aylık maliyetimi tahmin edin: [API fiyatları sayfasından yapıştırın]. Bunu ayda [fiyat] olan bir abonelikle karşılaştırın. Kontrol edebilmem için hesabı adım adım gösterin.Nerede ters gider
- Aboneliklerin de kullanım sınırları vardır. Bir görevin ortasında sınıra takılmak zaman kaybettirir; yalnızca fiyatı değil, sınırı da kontrol edin.
- Faturayı en çok model değiştirir. Gerçekten kullandığınız modelle karşılaştırın.
Claude Code
06
CLAUDE.md ile her oturuma aynı başlangıcı verin
Her oturumun başında derleme komutlarınızı ve kurallarınızı anlatıyorsanız CLAUDE.md'nin işini siz yapıyorsunuz demektir. Claude bu dosyayı her oturumun başında okur; kısa ve doğru tutun, aynı hatalar geri gelmeyi bırakır.
Örnek
Claude'un projenin pnpm test:unit komutu yerine sürekli npm test çalıştırdığı ve üretilmiş dosyaları düzenleyip durduğu bir depo. CLAUDE.md'ye eklenen iki satır, yani doğru komut ve “src/gen/ klasörünü asla düzenlemeyin”, iki hatayı da durdurur.
Nasıl yapılır
- 1Depoda /init çalıştırın: kod tabanını analiz eder ve bir başlangıç CLAUDE.md dosyası yazar ya da mevcut dosyanız için iyileştirmeler önerir.
- 2Derleme ve test komutları, kodlama standartları gibi ekip kurallarını ./CLAUDE.md dosyasında tutun ve commit edin. Kendi tercihleriniz tüm projeler için ~/.claude/CLAUDE.md dosyasına, yalnızca bu proje için CLAUDE.local.md dosyasına girer.
- 3Uzun belgeleri yapıştırmak yerine onlara işaret edin: @path/to/file başlangıçta başka bir dosyayı içe aktarır.
- 4Claude aynı şeyi iki kez yanlış yaptığında, bunu önleyecek tek satırı ekleyin.
Kopyalanacak istem
Bu depoyu okuyun ve CLAUDE.md dosyasını iyileştirin. 60 satırın altında tutun: 1. Derleme, test ve lint için tam komutlar. 2. Birkaç satırda proje yapısı. 3. Yeni gelenlerin burada yanlış yaptığı kurallar. 4. Asla düzenlenmemesi gereken dosyalar ve klasörler. Artık doğru olmayan her şeyi çıkarın. Çalıştırmadığınız komutları “doğrulanmadı” olarak işaretleyin.Nerede ters gider
- CLAUDE.md'deki her şey her oturumda yüklenir ve bağlamda yer kaplar. Ayrıntıları onun içe aktardığı dosyalara taşıyın.
- Artık doğru olmayan talimatlar hiç talimat olmamasından daha kötüdür. Kurulum değiştiğinde komutları yeniden kontrol edin.
Resmi belgelerden: Claude Code docs: How Claude remembers your project
07
Önce planlatın, sonra düzenlemesine izin verin
Birçok dosyaya yayılan bir değişiklikte pahalıya patlayan hata yanlış bir satır değil, yanlış bir yaklaşımdır. Plan modunda Claude kaynak dosyalarınızı düzenlemeden araştırır ve bir plan yazar; siz planı düzeltir, sonra onaylarsınız.
Örnek
Kimlik doğrulamayı 14 dosyada çerezlerden token'lara taşımak. İlk plan mobil istemciyi unutur; siz bunu belirtirsiniz, plana bir adım eklenir ve Claude ancak bundan sonra bir şeyi düzenler.
Nasıl yapılır
- 1Durum çubuğunda “plan mode on” görünene kadar Shift+Tab tuşlarına basın ya da isteminize /plan ile başlayın.
- 2Değişikliği ve neyin değişmemesi gerektiğini anlatın. Claude keşif için yine de komut çalıştırabilir, ancak plan yaparken dosyaları düzenlemez.
- 3Planı bir tasarım notu gibi okuyun: yanlış bir dosya, eksik bir durum, fazla büyük bir değişiklik. Doğru olana kadar değişiklik isteyin, sonra onaylayın.
- 4Bir sonraki, ilgisiz göreve geçmeden önce /clear ile temiz bir başlangıç yapın.
Kopyalanacak istem
/plan [hedef] sağlanacak şekilde [ne] öğesini değiştirin. Kısıtlar: [değişmemesi gerekenler]. Dokunacağınız dosyaları, değişikliklerin sırasını, her adımı kanıtlayan testi ve emin olmadığınız her şeyi listeleyin. Ben onaylayana kadar hiçbir şeyi düzenlemeyin.Nerede ters gider
- Beklediğinizden fazla dosyaya dokunan bir plan uyarı işaretidir. Onaylamadan önce nedenini sorun.
- Plan modu keşif için yine de komut çalıştırır. Tanımadığınız bir depoyu çalıştırmayı güvenli hâle getirmez.
Resmi belgelerden: Claude Code docs: Choose a permission mode · Claude Code docs: Commands · Claude Code docs: Best practices
08
Aynı komutu elli kez onaylamayı bırakın
Her test çalıştırmasını elle onaylamak sizi okumadan evet demeye alıştırır. Güvenli, tekrarlanan komutlara projenin ayarlarında bir kez izin verin, tehlikeli olanları yasaklayın ve onay sorularını geri kalan her şey için saklayın.
Örnek
Bir ekip, paylaşılan proje ayarlarında test ve lint komutlarına izin veriyor ve .env dosyalarının okunmasını yasaklıyor. Onay soruları okumaya değer birkaç komuta iner ve hiç kimsenin oturumu anahtarları açamaz.
Nasıl yapılır
- 1Her kuralı ve hangi ayar dosyasından geldiğini görmek için /permissions açın.
- 2Ekibin kurallarını .claude/settings.json dosyasına koyun ve commit edin. Kişisel kurallar ~/.claude/settings.json ya da .claude/settings.local.json dosyasına girer.
- 3Kurallar önce deny, sonra ask, sonra allow sırasıyla denetlenir; bu yüzden tek bir deny kuralı her allow kuralından üstündür.
- 4Modları Shift+Tab ile değiştirin: acceptEdits, çalışma dizinindeki dosya düzenlemelerini onaylar. bypassPermissions onay sorularını ve güvenlik denetimlerini kapatır; belgelere göre yalnızca internet erişimi olmayan yalıtılmış konteynerlerde veya sanal makinelerde kullanılmalıdır.
Kopyalanacak istem
Bu oturumda çalıştırdığınız komutlara bakın. .claude/settings.json için izin kuralları önerin: her gün kullandığımız salt okunur komutlara ve test komutlarına izin verin, gizli bilgileri okuyan veya proje dışında silme yapan her şeyi yasaklayın, geri kalan her şey için onay sorulmasını sağlayın. Her kuralı tek satırda açıklayın.Nerede ters gider
- Her komuta uyan bir allow kuralı, hiç onay sorulmamasıyla aynıdır. Tam komutlara izin verin.
- .claude/settings.json içindeki kurallar commit edildiğinde tüm ekip için geçerli olur. Bunları kod gibi inceleyin.
Resmi belgelerden: Claude Code docs: Configure permissions · Claude Code docs: Settings files and precedence · Claude Code docs: Choose a permission mode
09
Her oturumu odaklı tutun
Birbiriyle ilgisiz üç görev taşımış bir oturumun bağlamında hâlâ üçü de vardır ve bu belli olur. Görevler arasında bağlamı temizleyin, uzun görevleri bir odak belirterek sıkıştırın ve geniş aramaları kendi bağlamlarında çalışan alt ajanlara bırakın.
Örnek
Bir hatayı düzelttikten sonra aynı oturumda yeniden düzenleme istiyorsunuz ve Claude hatanın eski geçici çözümünü izlemeye devam ediyor. /clear ve tek cümlelik bağlamla artık izlemiyor.
Nasıl yapılır
- 1İlgisiz görevler arasında /clear, bağlamı boş yeni bir konuşma başlatır.
- 2Uzun bir görevde, odak belirttiğiniz bir /compact komutu, örneğin “/compact planı ve başarısız testi koruyun”, öncesini özetler.
- 3Geniş aramaları bir alt ajana verin: her biri kendi bağlam penceresinde çalışır, bu yüzden oturumunuza yalnızca cevabı geri gelir.
- 4Claude Code sınıra yaklaşınca kendi kendine de sıkıştırma yapar; uygun bir anda kendiniz sıkıştırırsanız neyin korunacağını siz seçersiniz.
Yerleşik
Kopyalanacak istem
/compact Koruyun: hedef, plan, şu ana kadar değişen dosyalar ve hâlâ başarısız olan test. Keşif kısmını atın.Nerede ters gider
- /clear konuşmayı unutur. Yeniden ihtiyaç duyacağınız her şey önce CLAUDE.md'ye girmelidir.
- Geri aldığınız tek şey alt ajanın cevabıdır. Ondan yalnızca sonuçları değil, dosya yollarını ve satır numaralarını da isteyin.
Resmi belgelerden: Claude Code docs: Commands · Claude Code docs: Best practices · Claude Code docs: Create custom subagents
10
İki görevi çakışma olmadan aynı anda çalıştırın
Aynı checkout'taki iki oturum aynı dosyaları birbirinin elinin altından düzenler. claude --worktree her oturuma kendi dalında kendi kopyasını verir; böylece bir yeniden düzenleme ile bir hata düzeltmesi yan yana çalışabilir.
Örnek
Bir worktree'de bağımlılık yükseltmesi, diğerinde arayüz düzeltmesi; siz üçüncü bir pull request'i incelerken ikisi de çalışıyor. Hiçbir oturum diğerinin yarım kalmış dosyalarını görmez.
Nasıl yapılır
- 1Her oturumu claude --worktree <name> (veya -w) ile başlatın. Bu, .claude/worktrees/<name>/ altında, worktree-<name> dalında bir git worktree oluşturur.
- 2Belgelerin önerdiği gibi .claude/worktrees/ klasörünü .gitignore dosyasına ekleyin.
- 3Her oturuma kendi kontrolü olan tek bir görev verin; böylece bunları tek tek inceleyebilirsiniz.
- 4Her dalı diğer pull request'ler gibi inceleyin ve birleştirin.
Kopyalanacak istem
worktree-[ad] dalındaki bir worktree'de çalışıyorsunuz. Görev: [tek bir değişiklik]. Bitti sayılır: [test veya komut] geçtiğinde. Yalnızca bu dala commit edin; diğer dalları merge veya rebase etmeyin.Nerede ters gider
- Her worktree ayrı bir klasördür; bu yüzden bağımlılıklar ve derleme çıktıları paylaşılmaz. Her birinde ayrıca kurulum yapın.
- Aynı dosyalara dokunan iki görev, worktree olsun olmasın birleştirirken yine çakışır.
Resmi belgelerden: Claude Code docs: Run parallel sessions with worktrees
11
Yanlış bir adımı rewind ile geri alın
Bir oturum yanlış gittiğinde Claude'dan kendi değişikliklerini geri almasını istemek çoğu zaman ikinci bir karmaşa yaratır. Rewind konuşmayı, kodu ya da ikisini birden hatadan önceki bir noktaya geri yükler. Kabuk komutlarının yaptıklarını geri alamaz; bu yüzden riskli adımlardan önce commit edin.
Örnek
Üç istem önce yanlış yöne giden bir yeniden düzenleme. Öncesine geri sarmak dosyaları ve konuşmayı geri yükler; kodu tartışarak eski hâline getirmek yerine isteğinizi yeniden ifade edersiniz.
Nasıl yapılır
- 1Boş bir istem satırında Esc tuşuna iki kez basın ya da /rewind yazın (/checkpoint ve /undo da çalışır).
- 2İşlerin ters gitmesinden önceki noktayı seçin ve konuşmayı, kodu ya da ikisini birden geri yükleyin.
- 3Sınırları bilin: rm, mv veya cp gibi kabuk komutlarıyla değişen dosyalar geri yüklenmez; Claude Code dışında veya başka bir oturumda yapılan düzenlemeler de geri yüklenmez.
- 4Riskli adımlardan önce commit edin. Kontrol noktaları oturum içinde hızlı kurtarma içindir, git'in yerini tutmaz.
Kopyalanacak istem
Başlamadan önce mevcut durumu “[görev] öncesi kontrol noktası” mesajıyla commit edin. Ardından [görev]. Dosya silen veya taşıyan herhangi bir komuttan önce bana sorun.Nerede ters gider
- Rewind bir komutun sildiği dosyayı geri getirmez. Bunu yalnızca git yapar.
- Bu arada elle yaptığınız düzenlemeler de kaydedilmez. Geri sarmadan önce onları commit edin.
Resmi belgelerden: Claude Code docs: Checkpointing · Claude Code docs: Commands
12
Betiklerden ve CI'dan çalıştırın
Aynı ajan sohbet olmadan da çalışır: claude -p bir istem alır, işi yapar ve betiğinizin kontrol edebileceği bir çıkış durumuyla kapanır. CI'da --bare yerel hook'larınızı, skill'lerinizi, MCP sunucularınızı ve CLAUDE.md dosyanızı atlar; böylece bir çalıştırma her yerde aynı davranır.
Örnek
Her gece çalışan bir iş, claude -p komutunu “bugün birleştirilen pull request'lerden değişiklik günlüğünü güncelleyin” istemi ve --output-format json ile çalıştırır ve çıkış durumu 0 değilse derlemeyi başarısız sayar; böylece bozuk bir çalıştırma ertesi sabah fark edilir.
Nasıl yapılır
- 1claude -p "..." etkileşimsiz çalışır. --output-format json veya stream-json, bir betiğin ayrıştırabileceği çıktı verir.
- 2Başarıda 0, hatada sıfırdan farklı bir kodla çıkar; böylece CI buna göre dallanabilir.
- 3Yerel kuruluma bağlı olmayan çalıştırmalar için CI'da --bare ekleyin.
- 4Pull request'ler için /install-github-app, Claude Code GitHub Actions'ı kurar (yalnızca github.com depoları); ardından bir pull request veya issue yorumunda @claude yazın.
Kopyalanacak istem
claude -p "main dalına göre diff'i okuyun. Bağımlılık ekleyen, kimlik doğrulamaya dokunan veya bir veritabanı migration'ını değiştiren her değişikliği JSON olarak listeleyin: {\"files\": [], \"reason\": \"\"}. Hiçbiri yoksa boş bir liste döndürün." --output-format jsonNerede ters gider
- Bir betik ona verdiğiniz izinlerle çalışır. CI ortamına ihtiyaç duyduğu en az yetkiyi verin.
- /install-github-app yalnızca github.com üzerindeki depolarla çalışır.
Resmi belgelerden: Claude Code docs: Run Claude Code programmatically · Claude Code docs: GitHub Actions
Codex
13
AGENTS.md: her Codex görevinin başladığı talimatlar
Codex herhangi bir iş yapmadan önce, genel dosyanızdan çalıştığı klasöre kadar AGENTS.md dosyalarını okur. Komutları ve kuralları bir kez, ilgili oldukları koda yakın yazın; en yakın dosya geçerli olur.
Örnek
Bir web uygulaması ve bir ödeme hizmeti içeren bir depo. Kökteki AGENTS.md ortak komutları içerir; payments/AGENTS.md ise “para birimi yuvarlamasını asla test olmadan değiştirmeyin” kuralını ekler. payments/ içindeki işler ikisine de uyar; farklı oldukları yerde daha yakın dosya geçerli olur.
Nasıl yapılır
- 1Geçerli klasöre bir başlangıç AGENTS.md dosyası yazmak için CLI'da /init çalıştırın.
- 2Kişisel yönergeleri ~/.codex/AGENTS.md dosyasına, proje kurallarını depoya koyun. Bir alt klasörün kendi dosyası olabilir; Codex'in çalıştığı yere daha yakın dosyalar geçerli olur.
- 3Dosyaları kısa tutun: toplam boyutları sınırlıdır, varsayılan olarak 32 KiB.
- 4Bir “## Code Review Rules” bölümü ekleyin: Codex'in GitHub'daki incelemeleri buna uyar.
Kopyalanacak istem
Bu depoyu okuyun ve AGENTS.md dosyasını yazın: 1. Kurulum, derleme, test ve lint için tam komutlar. 2. Birkaç satırda proje yapısı. 3. Yeni gelenlerin burada yanlış yaptığı kurallar. 4. Bir inceleyicinin her zaman işaretlemesi gerekenleri içeren bir “## Code Review Rules” bölümü. Yalnızca başarıyla çalıştırdığınız komutları listeleyin; geri kalanları “doğrulanmadı” olarak işaretleyin.Nerede ters gider
- Uzun dosyalar aleyhinize çalışır: toplam boyut varsayılan olarak 32 KiB ile sınırlıdır.
- Kökteki dosyayla, bunu belirtmeden çelişen bir alt klasör dosyası insanların kafasını da Codex'inki kadar karıştırır. Neyi geçersiz kıldığını yazın.
Resmi belgelerden: Codex docs: AGENTS.md · Codex docs: CLI commands · Codex docs: GitHub integration
14
Codex'in kendi başına ne kadarını yapabileceğine karar verin
İzin modu, Codex'in sormadan ne yapacağını belirler. “Ask for approval” çalışma alanının içinde çalışır ve dışına çıkmadan önce durur; “Full access” korumalı alanı ve soruları kaldırır. Bir kez ve kalıcı olarak değil, görev başına seçin.
Örnek
Tanımadığınız bir depoyu salt okunur modda okumak, ardından tek bir hatayı düzeltmek için “Ask for approval” moduna geçmek. Codex depo içinde düzenleme yapar, ancak dışına uzanmadan önce durup sorar.
Nasıl yapılır
- 1CLI'da /permissions modu değiştirir, /status ise geçerli onay politikasını ve yazılabilir klasörleri gösterir.
- 2Önerilen varsayılan olan “Ask for approval”, çalışma alanı içinde düzenleme yapar ve komut çalıştırır, dışına çıkmadan önce durur.
- 3“Approve for me” aynı korumalı alanı korur, ancak onay isteklerini size değil otomatik incelemeye gönderir.
- 4“Full access” dosya sistemi ve ağ sınırlarını kaldırır. Belgeler bir uyarı ekler; bunu silip atabileceğiniz ortamlara saklayın.
Kopyalanacak istem
Başlamadan önce /status çalıştırın ve bana onay politikasını ve yazılabilir klasörleri söyleyin. Ardından [görev]. Ağa ihtiyaç duyan veya bu deponun dışına yazan herhangi bir komuttan önce sorun.Nerede ters gider
- “Approve for me” ile hiçbir insan istekleri tek tek okumaz. Yanlış bir işlemin kolayca geri alınabildiği yerlerde kullanın.
- “Full access” yalnızca depoya değil, tüm makineye uygulanır.
Resmi belgelerden: Codex docs: Permission modes · Codex docs: Sandboxing · Codex docs: Approvals and security · Codex docs: CLI commands
15
Codex'i betiklerden ve CI'dan çalıştırın
codex exec bir görevi sohbet olmadan çalıştırır: ilerleme stderr'e, yalnızca son mesaj stdout'a gider; böylece bir betik cevabı kullanabilir. Salt okunur başlar; yalnızca iş gerektirdiğinde yazma erişimi verin.
Örnek
Bir sürüm betiği codex exec komutunu “son etiketten bu yana yapılan commit'lerden sürüm notları yazın” istemiyle çalıştırır ve stdout'u RELEASE.md dosyasına kaydeder. Dosyayı betiğin kendisi yazdığı için salt okunur mod yeterlidir.
Nasıl yapılır
- 1codex exec "..." etkileşimsiz çalışır ve varsayılan olarak salt okunur bir korumalı alan kullanır.
- 2Dosya düzenlemesi gerektiğinde --sandbox workspace-write ekleyin; --full-auto kullanımdan kaldırılmıştır.
- 3--json, her adıma ihtiyaç duyan betikler için JSON Lines biçiminde bir olay akışı üretir.
- 4GitHub Actions'ta openai/codex-action@v1 sizin için codex exec çalıştırır.
Kopyalanacak istem
codex exec "[v1.2.0] etiketinden bu yana yapılan değişiklikleri okuyun. Eklenenler, Değişenler ve Düzeltilenler başlıklarıyla gruplanmış sürüm notları yazın: her değişiklik için bir satır, bir kullanıcının anlayacağı sözcüklerle, commit hash'leri olmadan."Nerede ters gider
- Eski kılavuzlar hâlâ --full-auto kullanır. Bu seçenek kullanımdan kaldırılmıştır; --sandbox workspace-write kullanın.
- Yalnızca okuyan bir iş CI'da da salt okunur kalmalıdır.
Resmi belgelerden: Codex docs: Non-interactive mode · Codex docs: GitHub Action
16
Push etmeden önce inceleme alın
Codex çalışma ağacınızı, bir dalı veya bir pull request'i inceler. GitHub'da yalnızca en ciddi sorunları, yani P0 ve P1'i işaretler; bu yüzden yorumları okumaya değer. Push etmeden önce çalıştırın ve her pull request'i incelemesine izin verin.
Örnek
Bir migration'ı push etmeden önce /review, yeni sütunun varsayılan değeri olmadığını ve bu yüzden mevcut satırların hata vereceğini işaretler. Başarısız bir dağıtım yerine push'tan bir dakika önce yakalanır.
Nasıl yapılır
- 1CLI'daki /review çalışma ağacınızı inceler. codex review aynısını sohbet olmadan, bir temel dala, bir commit'e veya commit edilmemiş değişikliklere göre yapar.
- 2GitHub'da bir pull request'e @codex review yorumunu yazın.
- 3Codex ayarlarında “Personal preferences” altından otomatik incelemeleri açın; böylece yorum yazmaya gerek kalmaz.
- 4Ekibinizin kurallarını AGENTS.md içindeki bir “## Code Review Rules” bölümüne yazın.
Yerleşik
Kopyalanacak istem
## Code Review Rules - Kimlik doğrulama veya izinlerdeki her değişikliği işaretleyin. - Geri dönüş yolu olmayan veritabanı migration'larını işaretleyin. - Yeni bağımlılıkları işaretleyin ve gerekli olup olmadıklarını söyleyin. - Biçimlendirmeyi yok sayın; onunla linter ilgilenir.Nerede ters gider
- GitHub incelemeleri yalnızca P0 ve P1 sorunlarını işaretler. Yorum olmaması tasarımın doğru olduğu anlamına gelmez.
- İnceleme bir test çalıştırması değil, ikinci bir görüştür. Testleri koruyun.
Resmi belgelerden: Codex docs: CLI commands · Codex docs: GitHub integration
17
Görevleri Codex Cloud'a devredin
Codex Cloud bilgisayarınız uykudayken de çalışmaya devam eder; her görev, bir kez kurduğunuz bir ortamdan oluşturulan kendi çalışma alanında yürür. Düzgün bir ortamla kurulum, derleme ve test yapabilir; ortam olmadan tahmin eder.
Örnek
Bir toplantıdan önce codex cloud exec ile gönderilen dört küçük yeniden düzenleme; her biri aynı ortamdan oluşturulan kendi çalışma alanında. En zorlusu için üç deneme istediniz ve en iyisini tutuyorsunuz; sonrasında dört diff incelersiniz.
Nasıl yapılır
- 1Görevlerin ihtiyaç duyduğu depoları, bağımlılıkları, araçları ve erişim ayarlarını içeren bir ortam oluşturun. Yeni ortamlar bir kurulum betiği ve bir başlatma skill'i kaydeder.
- 2İnternet erişimini ortam başına ayarlayın: yalnızca paket yöneticileri, seçtiğiniz alan adları veya her şey.
- 3Görevleri ChatGPT'den, uzun işler için IDE uzantısından ya da terminalden codex cloud exec ile başlatın; --attempts 1-4 karşılaştırmak için birden fazla deneme ister.
- 4Code Review ile GitHub ve Linear entegrasyonları hâlâ OpenAI'ın kullanımdan kaldırmayı planladığı eski Codex Cloud (Legacy) üzerinde çalışır.
Yerleşik
Kopyalanacak istem
codex cloud exec --attempts 3 "Görev: [değişiklik]. Bağlam: [dosyalar]. Bitti sayılır: [test] bu ortamda geçtiğinde. Diff'i [n] satırın altında tutun."Nerede ters gider
- Kısıtlamasız internet erişimi, bir görevin onu yönlendirmek için yazılmış sayfalar da dahil her siteye ulaşmasına izin verir. Yalnızca işin ihtiyaç duyduğuna izin verin.
- Kurulum betiği eksikse testler çalışmamış olabilir. Bir görevin testleri gerçekten çalıştırdığını kontrol edin.
Resmi belgelerden: Codex docs: Cloud environments · Codex docs: CLI commands · Codex docs: IDE extension
18
Codex'i bir kez kurun: yapılandırma, profiller ve MCP
Modeli ve ayarları her oturumda elle değiştiriyorsanız bunları config.toml dosyasına koyun. Codex her seferinde ~/.codex/config.toml dosyasını, güvenilen projelerde de proje ayarlarını okur; bir profil ise bütün bir ayar setini tek seferde değiştirir.
Örnek
Tasarım soruları için yüksek akıl yürütme düzeyine sahip bir “deep” profili, hızlı düzeltmeler için varsayılan ayarlar. Bir mimari sorudan önce codex --profile deep; geri kalan her şey için düz codex.
Nasıl yapılır
- 1Varsayılan modeli ve akıl yürütme düzeyini ~/.codex/config.toml içinde ayarlayın (model ve model_reasoning_effort). CLI ve IDE uzantısı bu dosyayı paylaşır.
- 2Bir profili ayrı bir dosya olarak oluşturun, ~/.codex/<name>.config.toml, ve --profile <name> ile başlatın.
- 3MCP sunucularını codex mcp add <name> -- <command> ile ekleyin; her biri bir [mcp_servers.<name>] tablosu olur ve /mcp etkin olanları listeler.
- 4/status geçerli ayarları gösterir, codex resume --last ise bu klasördeki son oturumu kaldığı yerden sürdürür.
Kopyalanacak istem
~/.codex/config.toml dosyasını ve bu projenin .codex/config.toml dosyasını okuyun. Geçerli modeli, akıl yürütme düzeyini, korumalı alanı ve MCP sunucularını, her birinin hangi dosyadan geldiğini ve çelişen her şeyi söyleyin.Nerede ters gider
- Proje ayarları yalnızca güvenilen projelerde yüklenir. Biri yok sayılıyor gibi görünüyorsa önce bunu kontrol edin.
- Profiller artık ayrı dosyalardır. config.toml içine [profiles.name] koyan kılavuzlar güncel değildir.
Resmi belgelerden: Codex docs: MCP · Codex docs: Config basics · Codex docs: Advanced config · Codex docs: CLI commands
geliştiriciler için kurallar
- Gizli bilgileri, anahtarları veya müşteri verilerini asla bir isteme yapıştırmayın; bunları dizine eklenen klasörlerin dışında tutun.
- Ajanları, komutlardan önce onay isteyen izinlerle bir dalda çalıştırın; her diff'i inceleyin.
- Bir ajanın yazdığını birleştirmeden önce testleri kendiniz çalıştırın.
- Bir ajanın kullandığı her API anahtarına harcama sınırı koyun.
Daha derine inin
- Doğru bağlamı verin ders, yaklaşık 8 dk
- Örnekleri ve istediğiniz biçimi gösterin ders, yaklaşık 8 dk
- Yanıtı adım adım iyileştirin ders, yaklaşık 8 dk
- Claude Code 101 Anthropic (Claude Academy)
- Get Started with Codex OpenAI (OpenAI Academy)
- AI Agents Course Hugging Face
- Full Course: Spec-Driven Development with Coding Agents DeepLearningAI on YouTube