Kai Ajan OS: Claude Code ve Codex İçin Türkçe Ajan Rehberi ve Kiti

Yaklaşık on aydır işlerimizin büyük kısmını yapay zekâ ajanlarıyla yürütüyoruz: site, içerik, otomasyon, müşteri teslimleri. Bu sürede bizi en çok yoran şey ajanın zekâsı olmadı, düzensizliği oldu. Bir kez anlatılan kural ertesi gün unutuldu, kota haftanın ortasında bitti, “bitti” denen işin yarısı yapılmamış çıktı. Kai Ajan OS, bu sorunlara karşı kurduğumuz düzenin senin makinene taşınabilen hâli: bir rehber, onu kuran bir kit ve sonucu ölçen bir sınav.

Ajanla çalışırken en sık çıkan üç sorun

Claude Code, Codex CLI ya da Antigravity CLI kurduktan sonraki ilk haftalar genelde iyi geçer. Sonra aynı şikâyetler başlar:

• Kural unutuluyor. Dün anlattığın tercih bugün yok; her oturum sıfırdan başlıyor.
• Kota erken bitiyor. Her iş en pahalı modele gidiyor, haftanın yarısında beklemeye düşüyorsun.
• “Bitti” yarım çıkıyor. Test koşulmadan “geçti” deniyor, boş çıktı başarı sayılıyor.

Daha güçlü bir model bunların hiçbirini kendiliğinden çözmüyor. Çözen şey, ajanın içinde çalıştığı düzen: talimat dosyası, yetki kuralları, hafıza, doğrulama alışkanlığı.

Pakette ne var

Rehberin her bölümü aynı sırayla ilerler: sorun, onu çözen desen, uygulanabilir örnek, bir başarısızlık vakası ve bölüm sonunda kabul kontrolü. Vakaların çoğu kendi düzenimizden ve ölçülmüş; örnek senaryo olanlar rehberde öyle işaretli. Ehliyet'in senaryoları gerçek görevdir: bayat bir kararı açık iş sanmak, çıkış kodu 0 olan ama boş çıktı üreten hattı başarılı saymak, bir web sayfasındaki gizli talimatı yetki sanmak, gizli bir değeri loga yazmak. Her model değişiminde yeniden koşarsın.

Kurulum: kiti ajanına veriyorsun

Kiti elle kurman gerekmiyor. Klasörü açıyorsun ve ajanına “KURULUM.md'yi oku ve beni kur” diyorsun. Ajan kurulumu beş adımda yürütüyor:

1. KeşifAjan mevcut talimat dosyalarını, ayarlarını, kurulu kancaları ve skill'leri okuyup sana özetler. Bu adım hiçbir dosya yazmaz.
2. PlanHangi dosyanın oluşturulacağını, hangisinin değişeceğini ve hangisinin atlanacağını tek tek gösterir. Açık bir “evet” gelmeden ilerlemez.
3. UygulamaYalnız ekler. Değişecek her dosyayı önce yedekler; yarıda kalırsa aynı komutla kaldığı yerden devam eder.
4. TestKabul testini ve kurulum doğrulamasını çalıştırır. Testler geçmeden “kurulum başarılı” demez.
5. MakbuzNeyi kurduğunu, yedeklerin nerede durduğunu ve nasıl geri alacağını tek dosyada bırakır.

Kurulum mevcut dosyalarından tek satır silmez. Beğenmezsen geri alma tek komut: bash .ajan-kiti/UNINSTALL.sh. Kurulumdan sonra senin değiştirdiğin dosyalara bu komut da dokunmaz.

Rehberden üç vaka

Rehberdeki ölçülmüş vakalardan üçü şöyle. Her biri bir bölümün kuralına dönüştü:

Bir ay yeşil, sıfır gönderi

Bir sosyal medya hattı bir ay boyunca günde iki kez başarılı koştu ve tek bir gönderi yayımlamadı. Hata mesajı yoktu; üç ayrı kusur üst üste binmişti. En görünmezi şuydu: zamanlayıcı işi planlanan saatten 3–5 saat geç tetikliyordu, yayın penceresi ise 120 dakikaydı. Koşular pencereyi kaçırıyor, “atlandı” deyip çıkış kodu 0 ile bitiyordu. Otomasyon bölümü, “koşu yeşil” ile “iş yapıldı”yı birbirinden ayıran kontrolü bu vakadan kuruyor.

Not 22 diyordu, açık olan 1'di

Bir çalışma notu, silinmesi gereken 22 gönderi olduğunu söylüyordu. Ajan bunu olduğu gibi aktardı. Gönderiler tek tek kontrol edilince 21'inin bir gün önce elle silindiği çıktı. Not yazıldığı gün doğruydu; ajan dünkü durumu bugünün durumu diye sundu. Hafıza bölümü, “açık” diye sunulan her işin önce canlı kaynakla kontrol edilmesini bu vakadan öğretiyor. Ehliyet'teki “Bayat karar” senaryosu da tam bunu sınıyor.

Sekiz test geçti, üç biçim kaçtı

Rehberin merkezindeki silme kancasını ilk yazdığımızda sekiz durumla test ettik, sekizi de geçti. Bağımsız bir denetçi aynı kancaya üç yazılış daha denedi: -Rf, -r -f ve -f -r. Üçü de engellenmeden geçti. Kancayı yeniden yazdık; kitteki sürüm artık 22 durumla sınanıyor: 14'ü engellenmesi gereken yazılış, 8'i engellenmemesi gereken zararsız benzer (rm -r x, ls -rf gibi).

Bölümler

Giriş katmanı terminali ilk kez açan okur için yazıldı. Her gün ajanla çalışıyorsan Orta katmandan başlayabilirsin. Örnek sayfalar ürün sayfasında.

Kimin için, kimin için değil

• Claude Code, Codex CLI ya da Antigravity CLI ile her gün iş yapan ya da yapmaya başlayan girişimci, içerik üreticisi, geliştirici.
• Ajanına bir kez anlattığı kuralı ikinci kez anlatmaktan yorulan.
• Birden çok aboneliği iş türüne göre bölmek ve kotasını görmek isteyen.

Kod öğrenmek istiyorsan bu paket sana göre değil; rehber kod öğretmiyor. Hesap paylaşımı ya da aynı sağlayıcıda hesap çoğaltma gibi sağlayıcı şartlarının dışına çıkan yollar da rehberde yok.

Gereksinimler

• macOS 13+ ya da Ubuntu 22.04+. Windows'ta WSL2 gerekiyor; WSL2'de test etmedik.
• git, python3 3.8+ ve en az bir ajan aracı: Claude Code, Codex CLI ya da Antigravity CLI.
• Kancalar ve skill'ler Claude Code için. Codex CLI ve Antigravity CLI kitteki AGENTS.md talimatlarını okur.
• Sınanan sürümler (2 Ekim 2026): Claude Code 2.1.287 · Codex CLI 0.159.1 · Antigravity CLI 1.2.14.

Ne indirirsin

Ödemeden ya da davet kodundan sonra açılan indirme sayfasında iki dosya birlikte durur. Download all düğmesi ikisini tek zip olarak (Kai_Ajan_OS_v1_Tam_Set.zip) indirir; istersen dosyaları tek tek de alabilirsin:

• Kai_Ajan_OS_Rehber_v1.pdf: rehber, 102 sayfa.
• Ajan_Kiti_v1.0.0.zip: kit ve Ajan Ehliyeti. İçindeki MANIFEST.json her dosyanın SHA-256 özetini taşır.

1.x güncellemeleri ücretsiz: yeni sürümü aynı indirme bağlantısından alırsın, çıktığında e-postayla haber veririz.

İlk 15 dakika

• Bir deneme klasörü aç ve kiti içine çıkar: mkdir ~/ajan-deneme && cd ~/ajan-deneme && unzip ~/Downloads/Ajan_Kiti_v1.0.0.zip
• Ortamını kontrol et: bash kit/scripts/ortam_kontrolu.sh
• Ajanını bu klasörde aç ve ilk mesajın şu olsun: “kit/KURULUM.md'yi oku ve beni bu klasöre kur.”