Rehber
Geliştirici makinelerinde yapay zekâ kodlama ajanları nasıl izlenir
Claude Code, Codex ya da Cursor ekip dizüstülerinde çalışırken neler izlenmeli, yerleşik hook’lar ve telemetri neyi söyler, neyi söyleyemez; gizlilik nasıl korunur.
· 9 dk okuma · Yazan: vetkit ekibi
Onaylar neden yetmez
Yapay zekâ kodlama ajanları riskli eylemlerden önce sorar ya da kararı otomatik bir denetleyiciye bırakır. Bu, onay anını korur. Ama bir ekibe, onlarca dizüstündeki yüzlerce oturumda neler olduğunu söylemez: hangi ajan bir bulut kimlik bilgisini okudu, hangisi kimsenin tanımadığı bir alan adına veri gönderdi ya da hangisi bir sonraki çalıştırmada daha az sorsun diye kendi ayarlarını sessizce değiştirdi.
İzleme bu boşluğu doldurur. Amaç geliştiricileri izlemek değil; bir şeyler ters göründüğünde basit bir soruyu yanıtlayabilmektir: ajan neye dokundu? Ajanların nelere erişebildiğini anlatan rehber, bu yüzeyin neden çoğu kişinin sandığından daha geniş olduğunu açıklıyor.
Neler izlenmeli
Riskin büyük kısmı birkaç kategoriye girer. İşe yarar bir izleme aracı her birini kapsar ve etkinliği ona yol açan ajana bağlar.
| Kategori | Örnekler | Neden önemli |
|---|---|---|
| Kimlik bilgisi erişimi | SSH ve GPG anahtarları, bulut kimlik bilgileri, token’lar, anahtar zinciri, tarayıcı verileri | Bir geliştirici makinesindeki en değerli şey |
| Dışa giden ağ trafiği | Yüklemeler, paste ve dosya paylaşım servisleri, ilk kez görülen alan adları | Verinin dışarı çıktığı yol; bir kimlik bilgisi okumasının ardından dışa veri gönderimi klasik bir dizidir |
| Yıkıcı eylemler | Geniş kapsamlı silmeler, git geçmişini yeniden yazmak, tabloları drop etmek, bulut kaynaklarını değiştirmek | Buradaki hatalar bir saldırgan olmadan bile pahalıya patlar |
| Kapsam | Proje dışındaki okumalar, aramalar ve yazmalar | Bir kodlama görevinin diskin geri kalanına ihtiyacı nadiren olur |
| Tedarik zinciri | Paket kurulumları, uzaktaki bir script’i doğrudan shell’e pipe etmek, MCP sunucuları başlatmak | Yeni kod gelir ve sizin yetkilerinizle çalışır |
| Kalıcılık ve güvenlik duruşu | Oturum açılışında başlayan öğeler, shell profilleri, ajan ayarları ve talimat dosyaları, onayı atlayan modlar | Oturumdan sonra da kalan ve bir sonrakini şekillendiren değişiklikler |
Araçların yerleşik olarak sundukları
Ajanların kendileri işe yarar hook’lar ve telemetri sunar. Bunlar iyi bir başlangıç noktasıdır, ama sınırları belli.
- Hook’lar. Claude Code, Codex ve Cursor bir araç çağrısından önce ya da sonra kendi script’inizi çalıştırabilir; örneğin bir shell komutundan ya da bir MCP çağrısından önce. Claude Code ve Cursor, hook’ların zaman aşımında ya da hata durumunda varsayılan olarak fail open davrandığını belgeliyor; Claude Code da kesin izin veya engelleme kuralları için hook’lar yerine izin sistemini öneriyor.
- OpenTelemetry. Claude Code ve Codex, araç kararlarını ve sonuçlarını OpenTelemetry üzerinden dışa aktarabilir. Bu özellik varsayılan olarak kapalıdır, siz açıkça etkinleştirmedikçe prompt’lar kaydedilmez ve iki araç da bir deponun kendi yapılandırmasının telemetriyi açmasına ya da nereye gideceğini seçmesine izin vermez.
- Göremedikleri. Yerleşik sinyaller, ajanın araçlarından ne yapmasını istediğini anlatır. Başka süreçler başlatan bir shell komutu, bir bağımlılık kurulumunun içindeki bir script ya da ajanın başlattığı bir container bu görüş alanının dışında kalır ve her araç kendi biçiminde rapor verir.
İzlemenin üç yolu
| Yaklaşım | Güçlü yanı | Sınırları |
|---|---|---|
| Ajan hook’ları ve telemetri | Birebir araç çağrıları, başlaması ucuz, sağlayıcı tarafından destekleniyor | Her araç için ayrı kurulum, fail open, alt süreçleri görmez, her geliştiricinin kendi yapılandırmasına bağlıdır |
| Uç nokta güvenliği (EDR) | Makinedeki her süreci ve bağlantıyı görür | Hangi etkinliğin bir ajan oturumundan geldiğini bilmez ve kuralları yoğun çalışan bir kodlama asistanı için değil, kötü amaçlı yazılımlar için yazılmıştır |
| Ajanlara özel bir izleme aracı | İşletim sistemi etkinliğini ajana ve oturuma bağlar, araçlar arasında tek bir görünüm sunar, kuralları ajan davranışı için yazılmıştır | Kurulacak bir uygulama daha; bir ekip tarafından kabul görmesi için net bir gizlilik modeli gerekir |
Bunlar birbiriyle iyi bir araya gelir. Hook’lar kesin niyeti verir, ajanlara özel bir izleme aracı kapsam ve kaynak eşleştirmesi sağlar, EDR ise makinedeki diğer her şey için son savunma hattı olarak kalır.
Olaylarla değil, oturumlarla düşünün
Tek bir dosya okuması nadiren ilginçtir. Bir bulut kimlik bilgisini okuyan ve ardından ilk kez görülen bir alan adına bir şey yükleyen bir oturum ise ilginçtir. İki fikir izlemeyi gürültülü değil, faydalı kılar:
- Oturuma ve kurala göre gruplayın. Aynı davranışın tekrarları her seferinde yeni bir uyarı oluşturmamalı, bir sayacı artırmalı.
- “Yapmadı” iddialarını dürüstçe kurun. Bir izleme aracının en güven veren çıktısı “proje dışında okuma yok” ya da “dışa trafik yalnızca izin verilen alan adlarına” gibi bir ifadedir. Böyle bir iddia ancak arkasındaki sensör kapsamı kadar güçlüdür; bu yüzden kapsamın kısmi olduğu durumları belirtmelidir, örneğin bir sensör yeniden başlatıldıktan sonra ya da ajan işi Docker’a veya SSH’a devrettiğinde.
Gözetlemeden izlemek
Bir aracın birinin dizüstünde ne yaptığını izlemek çalışan izlemeye yakındır ve buna göre tasarlanmalıdır:
- Bir cihazın eşleştirilmesi, kişinin kendi makinesinde yaptığı açık bir eylem olmalı.
- Dosya içeriklerini, prompt’ları ya da tuş vuruşlarını değil, meta verileri (uyarılar, oturum özetleri) yükleyin.
- Herhangi bir şey cihazdan çıkmadan önce gizli bilgileri cihaz üzerinde maskeleyin.
- Kuruluşların yöneticilerin neleri görebileceğini sınırlamasına izin verin ve bir yönetici birinin ayrıntılarını her açtığında bunu kaydedin.
- Saklama süresini kısa tutun ve kişilerin kendi cihazlarını istedikleri an iptal etmesine izin verin.
- Yaygınlaştırmadan önce yerel mevzuatınıza göre bilgilendirme, onay ve işçi temsilciliği (works council) gerekliliklerini kontrol edin.
vetkit’in yeri
Agent Watch, vetkit’in bu iş için geliştirdiği masaüstü uygulamasıdır. Eşleştirilmiş bir makinede Claude Code, Codex, Cursor, Windsurf, Copilot, Gemini CLI, Cline ve Aider oturumlarını izler; kimlik bilgisi erişimi, dışa giden trafik, yıkıcı komutlar, kapsam, tedarik zinciri, kalıcılık ve güvenlik duruşu bulgularını kurala ve cihaza göre gruplayarak raporlar. Her oturum, sensör kapsamına göre doğrulanmış, kısmi ya da bilinmiyor olarak işaretlenen beyanlar taşır. Gözlemler ve raporlar; engellemez.
Yukarıdaki gizlilik modelini izler: cihazlar kişinin onayladığı bir kodla eşleşir, yalnızca meta veri yüklenir, ham olaylar yalnızca hem kuruluş hem kullanıcı açıkça kabul ettiğinde yüklenir, yöneticilerin başka bir üyenin ayrıntılarını okuması denetim kaydına geçer ve üyeler cihazlarını istedikleri an iptal edebilir. Agent Watch dokümantasyonu kullanılabilirliği ve planları anlatıyor. Yapılandırma tarafı için izinler rehberi, depo denetiminin commit edilmiş ajan ayarlarında neleri işaretlediğini gösteriyor.
Kaynaklar
Her araçla ilgili ifadeleri tarihinde o aracın kendi dokümantasyonundan okuduk:
Ürün adları ilgili sahiplerinin ticari markalarıdır. vetkit bu şirketlerle bağlantılı değildir; onlar tarafından onaylanmamış veya desteklenmemiştir. Güncelliğini yitirmiş bir şey mi fark ettiniz? contact@vetkit.dev adresine e-posta gönderin, düzeltelim.