DEV Community

Cover image for /goal Komutu: Codex ve Claude Kodunu 7/24 Otonom Ajanlar Olarak Çalıştırma
Tobias Hoffmann
Tobias Hoffmann

Posted on • Originally published at apidog.com

/goal Komutu: Codex ve Claude Kodunu 7/24 Otonom Ajanlar Olarak Çalıştırma

Son altı hafta içinde büyük yapay zeka laboratuvarlarının çoğu aynı temel özelliği yayımladı: ölçülebilir bir hedefe ulaşana kadar kapalı döngüde çalışan aracı komutu. Anthropic bunu Claude Code’a /goal olarak ekledi. OpenAI, Codex CLI ve Codex masaüstü uygulamasına dahil etti. Nous Research ise Hermes’e entegre etti. Ortak fikir basit: Aracıya bir hedef verirsiniz; aracı planlar, uygular, doğrular ve yalnızca hedef tamamlandığında ya da durması gerektiğinde size döner.

Apidog'u bugün deneyin

Manuel olarak “onayla, istem gönder, devam etmesini söyle, tekrar et” döngüsünü yönetiyorsanız, /goal bu işi aracıya devreder. Siz hedefi ve başarı koşulunu tanımlarsınız; aracı hedefe ulaşana kadar iterasyon yapar.

Bu rehber geliştiriciler ve API ekipleri içindir. /goal’ın nasıl çalıştığını, Codex ve Claude Code’da nasıl kullanılacağını, iyi hedef istemlerinin nasıl yazılacağını ve bunu Apidog ile API geliştirme iş akışınıza nasıl bağlayabileceğinizi ele alacağız.

Rehberdeki API örneklerini takip etmek isterseniz, Apidog’u ücretsiz indirebilirsiniz.

/goal aslında ne yapar?

Kısa tanım:

/goal, bir yapay zeka aracısının belirli bir durma koşulu gerçekleşene kadar bir görev üzerinde kapalı döngüde çalışmasını sağlar.

Tipik akış şöyledir:

  1. Siz hedefi yazarsınız.
  2. Ana model bir adım planlar ve uygular.
  3. Daha küçük bir doğrulayıcı model şu soruyu kontrol eder: “Hedefe ulaşıldı mı?”
  4. Cevap hayırsa döngü devam eder.
  5. Cevap evetse aracı durur ve sonucu raporlar.

Normal aracı kullanımından farkı:

  • /goal olmadan: Döngü sizsiniz. Çıktıyı okur, doğrular, sonraki adımı istersiniz.
  • /goal ile: Döngü aracıdadır. Planlar, çalışır, kendi çıktısını kontrol eder ve yalnızca tamamlandığında döner.

Örneğin:

/goal create a landing page
Enter fullscreen mode Exit fullscreen mode

Bu komut; dosya oluşturma, stil yazma, hata düzeltme ve önizleme alma gibi adımları tek bir sürekli çalıştırmaya dönüştürebilir.

Neden /goal aniden her yerde?

Uzun süren aracı görevleri genellikle iki nedenle başarısız olur:

  1. Kayma (drift): Model, başlangıçtaki hedeften uzaklaşır.
  2. Sürekli gözetim: Model işi yapabilir ama her adımda sizden onay ister.

/goal yaklaşımı bu iki sorunu azaltır. Doğrulayıcı model, her adımda hedefe göre kontrol yapar. Böylece aracı hem bağımsız çalışır hem de ölçülebilir bir durma koşuluna bağlı kalır.

Codex’te /goal kurulumu

Codex CLI, /goal için en fazla kontrolü sağlar.

1. Hedefleri etkinleştirin

Codex masaüstü uygulamasında:

Settings → Configuration → goals = true
Enter fullscreen mode Exit fullscreen mode

CLI bu ayarı devralır.

2. CLI’ı tam otomatik modda başlatın 

codex --approval-mode full-auto
Enter fullscreen mode Exit fullscreen mode

Bu mod, sürekli onay istemlerini azaltır.

3. Hedefi çalıştırın 

/goal [hedefiniz buraya]
Enter fullscreen mode Exit fullscreen mode

Örnek:

/goal tüm başarısız testleri düzelt ta ki npm test 0 ile çıkana kadar
Enter fullscreen mode Exit fullscreen mode

Codex /goal örneği

CLI yerine masaüstü uygulamasını da kullanabilirsiniz. İşlev aynıdır; ancak duraklatma, temizleme ve token kullanımını izleme için görsel arayüz sağlar.

Claude Code’da /goal kurulumu

Claude Code CLI’da kullanım benzerdir:

/goal [görev açıklaması]
Enter fullscreen mode Exit fullscreen mode

Resmi belgeler için Claude Code dokümantasyonuna bakabilirsiniz.

Claude Code /goal örneği

Claude Code başlatılırken yapılandırma hataları alıyorsanız, geçersiz custom3p kurumsal yapılandırma düzeltmesi en yaygın hata senaryosunu kapsar.

Çoklu aracı iş akışları için ayrıca Claude Code üzerinde çoklu aracı katmanı olan Ruflo analizine bakabilirsiniz.

Pratik ipucu: Claude Code, /goal sırasında token kullanımını ve ilerlemeyi gösterir. İlerleme olmadan token tüketimi artıyorsa hedefiniz yakınsamıyor olabilir. Bu durumda:

/pause
Enter fullscreen mode Exit fullscreen mode

veya:

/goal clear
Enter fullscreen mode Exit fullscreen mode

kullanın.

İyi çalışan /goal istemi nasıl yazılır?

/goal komutunun sözdizimi basittir. Zor olan, aracının gerçekten tamamlayabileceği ve doğrulayabileceği bir hedef yazmaktır.

Her iyi /goal isteminde üç parça bulunur:

  1. İş: Ne yapılacak?
  2. Ölçülebilir son durum: Tamamlandı nasıl anlaşılacak?
  3. Kısıtlamalar: Aracı hangi sınırların dışına çıkmayacak?

Temel şablon:

/goal [işi yap] ta ki [ölçülebilir son durum] olana kadar [kısıtlamalar]
Enter fullscreen mode Exit fullscreen mode

Örnek:

/goal tüm başarısız testleri düzelt ta ki npm test 0 ile çıkana kadar /auth dizini dışındaki hiçbir dosyayı değiştirmeden
Enter fullscreen mode Exit fullscreen mode

Bu iyi bir hedeftir çünkü:

  • npm test doğrulanabilir bir sinyal üretir.
  • Başarı koşulu nettir: çıkış kodu 0.
  • Kısıtlama açık ve uygulanabilirdir: /auth dışına dokunma.

Kötü örnek:

/goal bu UI'ı daha modern yap
Enter fullscreen mode Exit fullscreen mode

Bu hedef belirsizdir. Doğrulayıcı “modern” kelimesini ölçemez.

Daha iyi versiyon:

/goal ana sayfa UI'ını güncelle ta ki Lighthouse erişilebilirlik puanı 90+ olana ve mobil görünümde yatay kaydırma kalmayana kadar
Enter fullscreen mode Exit fullscreen mode

Daha uzun görevler için yapı

Büyük hedeflerde tek satır yerine bloklu format kullanın:

/goal
Hedef: [tek satırlık hedef]

Başarı kriterleri:
  - [ölçülebilir kriter 1]
  - [ölçülebilir kriter 2]

Kısıtlamalar:
  - [sınır 1]
  - [sınır 2]

Bağlam:
  - [ilgili dosyalar]
  - [çalıştırılacak komutlar]
  - [API sözleşmesi veya doküman yolu]
Enter fullscreen mode Exit fullscreen mode

Örnek:

/goal
Hedef: Kullanıcı giriş endpoint'indeki hataları düzelt.

Başarı kriterleri:
  - npm test 0 ile çıkmalı
  - POST /auth/login geçerli kullanıcı için 200 dönmeli
  - Hatalı şifre için 401 dönmeli

Kısıtlamalar:
  - /auth dışındaki dosyaları değiştirme
  - Veritabanı şemasını değiştirme

Bağlam:
  - OpenAPI dosyası: ./openapi.yaml
  - Test komutu: npm test
Enter fullscreen mode Exit fullscreen mode

Bu format, doğrulayıcıya her iterasyonda kontrol edeceği somut sinyaller verir.

Kullanılabilir /goal örnekleri

Araştırma 

/goal Nisan 2026'dan bu yana yayınlanan Claude Opus 4.7 için tüm genel karşılaştırmaları topla, kaynakları kaydet ve en az 10 farklı karşılaştırmayı içeren tarihe göre sıralanmış bir markdown tablosu oluştur
Enter fullscreen mode Exit fullscreen mode

Depo bakımı 

/goal bu depoda ölü kod, kullanılmayan bağımlılıklar ve eski dosyalar bul, ardından her öğe için gerekçe içeren güvenli kaldırma önerilerinden oluşan bir PR açıklaması hazırla
Enter fullscreen mode Exit fullscreen mode

Dokümantasyon 

/goal README.md'yi yeni bir katkıcının projeyi kurabilmesi, çalıştırabilmesi, test edebilmesi ve anlayabilmesi için yeniden yaz; bu dört adımın her biri çalışan bir komut ve beklenen çıktı içersin
Enter fullscreen mode Exit fullscreen mode

Özellik geliştirme 

/goal koyu/açık tema geçişi ekle, seçimi localStorage'da kalıcı hale getir, her iki tema için stilleri güncelle ve geçişin sayfa yenilemesi olmadan çalıştığını tarayıcıda doğrula
Enter fullscreen mode Exit fullscreen mode

Ortak desen: Her örnekte doğrulanabilir bir son durum var.

/goal ve API geliştirme iş akışları

API çalışmaları /goal için özellikle uygundur. Çünkü API görevlerinde başarı çoğu zaman net biçimde ölçülebilir:

  • İstek 200 döner.
  • Hata senaryosu doğru status code üretir.
  • Yanıt şeması OpenAPI sözleşmesiyle eşleşir.
  • Test paketi yeşile döner.

Örnek hedef:

/goal POST /users endpoint'ini OpenAPI sözleşmesine göre uygula ta ki tüm Apidog test durumları geçene kadar
Enter fullscreen mode Exit fullscreen mode

Önerilen iş akışı

  1. Sözleşmeyi Apidog’da tasarlayın.

    Endpoint, request schema, response schema ve örnek payload’ları Apidog içinde tanımlayın.

  2. OpenAPI spesifikasyonunu dışa aktarın.

    Codex veya Claude Code’a bağlam olarak verin.

  3. /goal çalıştırın.

    Aracıya endpoint’i uygulamasını ve testler geçene kadar çalışmasını söyleyin.

  4. Doğrulayıcı test komutunu çalıştırsın.

    Her döngüde API testleri çalışan servise karşı koşar. Aracı yalnızca tüm testler geçtiğinde durur.

Örnek:

/goal
Hedef: GET /orders/{id} endpoint'ini OpenAPI sözleşmesine göre uygula.

Başarı kriterleri:
  - Apidog testleri tamamen geçmeli
  - 200, 404 ve validation error senaryoları beklenen şemaya uymalı
  - npm test 0 ile çıkmalı

Kısıtlamalar:
  - Mevcut response alan adlarını değiştirme
  - Migration ekleme

Bağlam:
  - OpenAPI dosyası: ./openapi.yaml
  - Test komutu: npm test
Enter fullscreen mode Exit fullscreen mode

Bu yaklaşım, aracının kendi testlerini icat etmesinden daha güvenilirdir. Çünkü doğruluk kaynağı önceden tanımlanmış API sözleşmesidir.

Apidog; API tasarımı, mocking, test ve dokümantasyonu tek platformda birleştirir. Bu, /goal için önemlidir çünkü aracı tek bir test komutuyla ilerleme durumunu doğrulayabilir.

Sözleşme odaklı kurulum için tasarım odaklı API iş akışı rehberine, test senaryoları için ise QA mühendisleri için API test aracı genel bakışına bakabilirsiniz.

MCP sunucularıyla çalışıyorsanız da aynı desen geçerlidir. Kurulum için Apidog ile MCP sunucusu testi makalesini kullanabilirsiniz.

Üretimde /goal kullanırken pratik ipuçları

Tek seferde bir hedef çalıştırın

Codex ve Claude Code genellikle tek aktif hedefle çalışır. Yeni hedefe geçmeden önce:

/goal clear
Enter fullscreen mode Exit fullscreen mode

kullanın.

Önce /plan, sonra /goal

Daha kontrollü akış:

/plan kullanıcı kayıt endpoint'ini OpenAPI sözleşmesine göre uygulamak için plan çıkar
Enter fullscreen mode Exit fullscreen mode

Planı gözden geçirdikten sonra:

/goal planı uygula ta ki tüm API testleri geçene kadar
Enter fullscreen mode Exit fullscreen mode

Bu, aracının döngü ortasında yaklaşımı tekrar tekrar değiştirmesini azaltır.

İlerleme dosyası kullandırın

Aracıya bir ilerleme dosyası tutturun:

/goal görevi tamamla ve her iterasyondan sonra progress.md dosyasını güncelle
Enter fullscreen mode Exit fullscreen mode

Böylece:

  • Denetlenebilir bir iz oluşur.
  • Aracı iterasyonlar arasında daha net bağlam tutar.
  • Siz de ne yaptığını hızlıca okuyabilirsiniz.

Modelden hedefi yeniden yazmasını isteyin

Kaba fikrinizi önce normal istemle verin:

Bu görevi ölçülebilir başarı kriterleri ve kısıtlamalar içeren iyi bir /goal komutuna dönüştür.
Enter fullscreen mode Exit fullscreen mode

Model çoğu zaman doğrulayıcının kontrol edebileceği daha iyi kriterler önerir.

Sorun ana modelde değil, çoğu zaman doğrulayıcı kriterindedir

Döngü kapanmıyorsa genellikle başarı koşulu ölçülebilir değildir.

Kötü kriter:

kod temiz olsun
Enter fullscreen mode Exit fullscreen mode

Daha iyi kriter:

npm run lint 0 ile çıksın ve npm test geçsin
Enter fullscreen mode Exit fullscreen mode

Küçük işler için /goal kullanmayın

Tek satırlık refactor veya küçük açıklama değişiklikleri için normal istem daha hızlıdır. /goal, uzun süren ve doğrulanabilir görevlerde daha anlamlıdır.

/goal ne zaman iyi çalışmaz?

Maliyet

Uzun çalışan döngüler daha fazla token tüketir. Başlamadan önce bütçe veya süre sınırı belirleyin.

Örnek kısıtlama:

Kısıtlamalar:
  - En fazla 5 iterasyon dene
  - Başarısız olursa yapılanları raporla ve dur
Enter fullscreen mode Exit fullscreen mode

Net sinyali olmayan görevler

Şu hedefler zayıf çalışır:

  • “UX’i iyileştir”
  • “Metni daha iyi yap”
  • “Tasarımı daha premium hissettir”

Bunların yerine ölçülebilir hedef yazın:

/goal form erişilebilirliğini iyileştir ta ki Lighthouse accessibility puanı 95+ olana ve tüm input'ların label'ı bulunana kadar
Enter fullscreen mode Exit fullscreen mode

Harici yan etkiler

E-posta gönderen, ödeme yapan veya üretim API’lerini çağıran hedeflerde çok net kısıtlamalar gerekir.

Örnek:

Kısıtlamalar:
  - Üretim API'sine istek atma
  - Gerçek ödeme işlemi başlatma
  - Sadece sandbox ortamını kullan
Enter fullscreen mode Exit fullscreen mode

API erişim kontrolü ve ekip kullanımı tarafında daha geniş bağlam için ekipler için GitHub Copilot kullanım ve faturalandırma API’si yazısına bakabilirsiniz.

Eski bağlam

Uzun süren hedef sırasında kod tabanı değişirse aracı eski bağlamla devam edebilir. Bu durumda durdurup hedefi yeniden başlatmak daha güvenlidir.

Yapay zeka ile geliştirme pratiği nasıl değişiyor?

/goal, yapay zekayı “otomatik tamamlama”dan “hedef verdiğiniz ve denetlediğiniz aracı” modeline taşır.

Bu değişiklikte geliştiricinin işi şuna kayar:

  • Daha net başarı kriterleri yazmak
  • Daha iyi kısıtlamalar tanımlamak
  • Test edilebilir sözleşmeler üretmek
  • Aracının çıktısını otomatik doğrulamak

Bundan en çok faydalanan ekipler genellikle şunlara sahiptir:

  • OpenAPI dokümanı
  • Güçlü test paketi
  • CI akışı
  • Net API sözleşmeleri
  • Tek komutla çalıştırılabilen doğrulama

API’niz yalnızca ekip üyelerinin zihnindeyse, aracının doğrulayacağı somut bir şey yoktur. Ancak API sözleşmeniz Apidog gibi bir platformda tanımlıysa, /goal aracı bu sözleşmeye göre uygulama yapabilir ve testlerle kendini doğrulayabilir.

Sözleşme odaklı akışı kurmak isterseniz Apidog’u indirin.

Sıkça sorulan sorular

/goal Codex web uygulamasında çalışır mı?

Evet. Codex CLI, Codex masaüstü, Codex uygulaması ve Claude Code CLI’da desteklenir. Hermes de aynı komutu destekler.

/goal normal istemden nasıl farklıdır?

Normal istem tek adım çalışır ve durur. /goal, her adımdan sonra hedefe ulaşılıp ulaşılmadığını doğrulayan kapalı bir döngüde çalışır.

Aracı kısıtlamaların dışına çıkabilir mi?

Kısıtlamalar açık yazılırsa doğrulayıcı bunları her iterasyonda kontrol edebilir.

İyi kısıtlama:

/auth dizini dışındaki hiçbir dosyayı değiştirme
Enter fullscreen mode Exit fullscreen mode

Zayıf kısıtlama:

hiçbir şeyi bozma
Enter fullscreen mode Exit fullscreen mode

/goal daha pahalı mı?

Genellikle evet. Ana model işi yapmaya devam eder, doğrulayıcı model de her adımı kontrol eder. Bu nedenle uzun görevlerde token tüketimi artar.

Aracının çıktısını gerçek API’ye karşı nasıl test ederim?

API sözleşmesini Apidog ile tanımlayın ve test durumlarını çalışan uygulamaya karşı koşturun. Böylece /goal için ölçülebilir bir son durum elde edersiniz.

Claude destekli servisleri düşük bütçeyle kuruyorsanız, ücretsiz Claude API rehberine de bakabilirsiniz.

Top comments (0)