AGENTS.md Saldırısı: Claude Code ve Codex'e Gizli Talimat

Bir web sayfası İndirilenler'e AGENTS.md bırakıyor, orada açılan Claude Code ya da Codex o talimatla zararlı paket kuruyor. Ne oldu, yarın sabah ne yapmalı?

İlker Pehlivan
6 dk okuma
Gravür çizim: ahşap döşemeli bir evin içinden görülen kapalı, panelli ağır bir kapının alt yarısı, kapının altındaki dar aralıktan turuncu bir ışık çizgisi sızıyor ve aralıktan içeri itilmiş, kenarı turuncu, üzerinde yazı olmayan katlanmış bir kağıt döşemenin üstünde duruyor
Kapının altından itilen not, masaya düşünce evin sahibinin notundan ayırt edilmez. İndirilenler klasörüne bırakılan AGENTS.md de ajan için projenin kendi talimatı gibi görünür.

Evinize haftada iki gün yardımcı geliyor. Kapıdan girince ilk işi giriş masasındaki notlara bakmak: “çiçekleri sula”, “kargoyu kapıcıya ver”. Notu kimin yazdığını sormuyor, çünkü o masaya yalnız sizin not bıraktığınızı biliyor.

Şimdi kapının altında bir aralık olduğunu düşünün. Biri dışarıdan bir not itiyor, not halının üstünden kayıp masanın dibine düşüyor. Notta “yedek anahtarı paspasın altına bırak” yazıyor. Yardımcı bu notu da sizin yazdığınızı sanıyor.

Yazılımcıların ve giderek sistem yöneticilerinin kullandığı AI kodlama ajanları da böyle çalışıyor. Claude Code, OpenAI Codex ya da Cursor bir klasörde açıldığında önce orada duran talimat dosyasını okuyor: Codex’te AGENTS.md, Claude Code’da CLAUDE.md.

Forever Security’nin 22 Ekim’de yayımladığı araştırmaya göre bir web sayfası bu dosyayı sizin İndirilenler klasörünüze sormadan bırakabiliyor. Ajan o klasörde açılırsa talimatı sizinmiş gibi uyguluyor. Bu yazıda ne olduğunu, saldırının nasıl işlediğini ve yarın sabah neye bakmanız gerektiğini anlatacağız.

Ne Oldu: Bir Müşterinin İndirilenler Klasöründeki AGENTS.md

Forever Security’nin raporuna göre olay bir müşterinin makinesinde başladı. Şirketin izleme ürünü, oturumun ortasında bir kodlama ajanını function-color adlı npm paketini kurarken durdurdu. Bu paket, yaklaşık iki yıl fark edilmeden yayında kalmış bir zararlı kampanyasının parçasıydı ve sonradan npm’den kaldırıldı.

Ekip talimatın nereden geldiğini aradı. Kaynak bir bağımlılık ya da bir repo değildi. Müşterinin ~/Downloads klasöründe duran 13 KB’lık bir AGENTS.md dosyasıydı. Dosya sıradan bir “mühendislik çalışma kuralları” belgesine benziyordu. Zararlı kısım, bir araç sunucusunun kurulumu gibi yazılmış birkaç paragraftı. Dosyanın oraya nasıl geldiğini kimse bilmiyordu.

Haberi aktaran BleepingComputer’a konuşan araştırmacı Gal Weizman, ajanı İndirilenler’de çalıştırmanın sanıldığından yaygın olduğunu söylüyor. İnsanlar ajandan indirdikleri dosyaları düzenlemesini ya da yeni gelen bir dosyayla bir iş yapmasını istiyor.

Saldırı Nasıl İşliyor: Markdown Dosyası Neden Komut Gibi Çalışıyor?

Raporun başlığı durumu tek cümlede özetliyor: Markdown yeni çalıştırılabilir dosyadır. Zincirin üç halkası var.

Birinci halka tarayıcı. Chrome, Edge ve Firefox web’den inen dosyaları varsayılan olarak sormadan İndirilenler’e kaydediyor. Bir sayfa dosyanın adını ve içeriğini kendisi seçebiliyor. BleepingComputer, araştırmacının deneme sayfasının ziyaret edildiği anda zararsız içerikli bir AGENTS.md indirdiğini doğruladı. Windows bir .exe dosyasını internetten geldiği için çalıştırmadan önce uyarır, ama bir metin dosyası için böyle bir kapı yok.

İkinci halka ajanın working directory’si, yani açıldığı klasör. Codex’in belgesine göre ajan proje kökünden açıldığı klasöre kadar her seviyedeki AGENTS.md’yi okuyup talimatlarına ekliyor. Claude Code’un belgesine göre açıldığı klasördeki ve üstündeki CLAUDE.md dosyaları oturum başında, alt klasörlerdekiler o klasördeki bir dosyaya dokunulduğunda yükleniyor. İndirilenler’de açılan ajan için o klasörün talimat dosyası, projenin talimat dosyası sayılıyor.

Üçüncü halka ajanın yetkisi. Gerçek olaydaki dosya Codex’e kendi ayar dosyası ~/.codex/config.toml’a yeni bir araç sunucusu bloğu eklemesini söylüyordu. O blok, açılışta npm install function-color komutunu çalıştırıyordu. Ayar dosyası makinenin geneline ait olduğu için zehirli sunucu bundan sonraki her Codex oturumunda yükleniyordu. Araştırmacılar gerçek dosyayı yalıtılmış bir sanal makinede denediğinde Codex zararlıyı denemelerin yüzde 90’ından fazlasında çalıştırdı.

Claude Code’da yol farklı. Araştırmacıların hazırladığı CLAUDE.md, ajandan proje ayarlarına ANTHROPIC_BASE_URL satırı eklemesini istiyordu. Bu satır ajanın modelle konuştuğu adresi değiştiriyor. Satır yazıldıktan sonra ajan isteklerini, oturum açtığı hesabın token’ı dahil, araştırmacıların sunucusuna gönderiyordu. Ekip yakaladığı token’ı gerçek API’de kullanınca kurbanın hesabıyla işlem yapabildi. Yani hiçbir kod çalışmadan hesap ele geçmiş oluyor.

Rapora göre Claude bu ayar yazma adımını denemelerin yaklaşık yarısında yaptı. Aynı oturumda kod çalıştırmaya kadar giden yol beşte bir civarında tuttu. Oran düşük görünebilir, ama saldırganın tek bir başarılı denemeye ihtiyacı var.

Örnekteki evin diliyle: kapının altından atılan not yardımcıya yalnız bir iş yaptırmıyor, yardımcının defterine “bundan sonra her gelişinde şunu da yap” satırını ekletiyor.

“Bir Güncelleme Gelir, Kapanır” Yanılgısı

Bu olayda beklenecek bir yama yok. Araştırmacıların cümlesiyle: OpenAI’ın ya da Anthropic’in burada yamalayacağı bir şey yok. Tarayıcı dosyayı indirmek için, ajan da açıldığı klasördeki talimatı okumak için tasarlandı. İkisi de işini doğru yapıyor. Risk, iki doğru davranışın aynı klasörde buluşmasından doğuyor.

İki sayı arasında da bir fark var, ikisini de kaynağıyla veriyoruz. BleepingComputer, araştırmacının yüzlerce müşterinin ajanlarını İndirilenler’den çalıştırdığını ve yalnız Claude Code’un oradan 1.300’den fazla oturum açtığını söylediğini yazıyor. Raporun kendisi sayı vermiyor ve “müşterilerin yaklaşık yarısı” diyor.

İkinci yanılgı “Biz yazılım şirketi değiliz” cümlesi. Bu ajanlar artık yalnız yazılımcının aracı değil. Sistem yöneticisi betik yazdırıyor, muhasebeci bir Excel dosyasını düzenletiyor. Kurumun onaylamadığı bir AI aracının ne kadar sessiz yayıldığını Shadow AI yazısında anlatmıştık. Kodlama ajanı aynı sessizlikle gelir, üstelik makinede komut çalıştırma yetkisiyle.

Kendi Makinemizde Ne Gördük?

Bu siteyi Claude Code desteğiyle geliştiriyoruz, o yüzden önce kendi iş istasyonuma baktım. İndirilenler klasöründe ne AGENTS.md ne CLAUDE.md vardı. Claude Code’un kullanıcı ayarlarında API adresini değiştiren bir değişken yoktu.

Tarayıcıda da bir alışkanlığım var: indirme ayarlarında her dosyanın nereye kaydedileceğini soran seçeneği her zaman açarım. Chrome’da bu seçenek Settings → Downloads altında Ask where to save each file before downloading adını taşıyor, Edge ve Firefox’ta da aynı seçenek var.

Bu seçenek açıkken bir sayfa dosyayı sessizce bırakamaz. Her indirmede kaydetme penceresi açılır ve beklemediğiniz bir AGENTS.md o pencerede iptal edilir. Saldırının ilk halkası olan sormadan indirme kopar, bu yüzden ayar bu saldırıya karşı size koruma sağlar.

Claude Code’un oturum kayıtlarında ev dizininde başlatılmış oturumlar da vardı. Çoğu, oturum notlarını özetleyen otomatik bir görevin açtığı kısa çağrılardı. İndirilenler ev dizininin alt klasörü olduğu için risk orada başlar. Bizde iki önlem bu kapıyı kapalı tutuyordu: tarayıcı hiçbir dosyayı sormadan indirmiyordu ve klasörde talimat dosyası yoktu. Yine de o görevi dosya erişimi olmayan boş bir klasöre taşıdık, ajanı da yalnız proje klasöründe açıyoruz. Claude Code’un güvenlik belgesi de bunu öneriyor.

Yarın Sabah Ne Yapmalı?

  • Ajanları yalnız proje klasöründe açın. İndirilenler’de, masaüstünde ya da ev dizininde değil. Ajanın çalışma alanı ne kadar darsa, oraya dışarıdan dosya düşme ihtimali o kadar küçük.
  • İndirilenler’de talimat dosyası arayın. Bilerek indirmediğiniz bir AGENTS.md ya da CLAUDE.md varsa açmadan önce okuyun, sonra silin. Windows’ta bir kullanıcı için arama şöyle:
PowerShell
Get-ChildItem "$env:USERPROFILE\Downloads" -Recurse -Force -Include AGENTS.md,AGENTS.override.md,CLAUDE.md -ErrorAction SilentlyContinue | Select-Object FullName, LastWriteTime
  • Ajan ayarlarında beklenmeyen satır arayın. İki dosyaya bakılır:
    • Codex: ~/.codex/config.toml içinde tanımadığınız bir [mcp_servers.*] bloğu ya da değişmiş bir chatgpt_base_url.
    • Claude Code: .claude/settings.json içinde ANTHROPIC_BASE_URL, bir proxy ya da tanımadığınız bir API adresi.
  • Onay adımlarını kapatmayın. İzin sorularını ve sandbox’ı kapatan bayraklar (--dangerously-bypass-approvals-and-sandbox gibi) bu saldırıda zararlının en çok istediği şey. Bir talimat dosyası bunları kapatmanızı istiyorsa dosyanın kendisi şüphelidir.
  • function-color izini arayın. Kurulum kayıtlarında ya da npm ls -g çıktısında bu paket geçiyorsa makineyi ele geçirilmiş sayın. Ajanın kullandığı hesapların token’larını yenileyin, çünkü sızmış olabilirler.
  • Ajanları envantere alın. Hangi makinede hangi ajan kurulu, kim kullanıyor, hangi hesapla bağlı. Uç noktadaki komut ve ağ hareketini izleyen bir EDR, ajanın beklenmedik bir paket kurmasını da görür. Forever Security’nin olayı da tam böyle yakaladı.

Biz Ne Yapıyoruz

Girişteki benzetmeye dönersek: AI ajanı evdeki yardımcıdır, talimat dosyası giriş masasındaki nottur, İndirilenler ise kapının altındaki aralıktır. Yardımcı dürüst çalışıyor ve notu kimin yazdığını bilemiyor. Çözüm yardımcıyı göndermek değil, masayı kapının dibinden almak.

Bu yüzden kendi çalışmamızda ajanı yalnız projenin kendi klasöründe açıyoruz. Talimat dosyamız repoda, sürüm kontrolünde duruyor ve her değişikliği görülüyor. Onay adımlarını kapatan bayrakları kullanmıyoruz.

Müşterilerimizde ise önce şu soruyu soruyoruz: hangi makinede hangi AI aracı, hangi yetkiyle çalışıyor? Bu soru supply chain attack (tedarik zinciri saldırısı) olayında olduğu gibi burada da aynı yere çıkıyor. Saldırgan açığa değil, güvene giriyor.

AGENTS.md Saldırısı Hakkında Sık Sorulan Sorular

Kurumun kullanmaması çalışanların kullanmadığı anlamına gelmez. Forever Security müşterilerinin yaklaşık yarısında bir kodlama ajanının İndirilenler klasöründe çalıştırıldığını yazıyor. Önce envanter: hangi makinede Claude Code, Codex ya da Cursor kurulu, kim kullanıyor, hangi hesapla. Bunu kurumun izniyle değil, ağ ve uç nokta kaydından çıkarmak gerekir.
Hayır. Araştırmacılara göre ortada yamalanacak bir açık yok. Ajan, açıldığı klasördeki talimat dosyasını okumak için tasarlandı ve tam olarak bunu yapıyor. Risk tarayıcının sormadan dosya indirmesiyle ajanın o klasörde açılmasının birleşmesinden doğuyor. Bu yüzden önlem kullanım biçiminde: ajanı yalnız proje klasöründe açmak, onay adımlarını kapatmamak.
Üç yere bakılır. İndirilenler klasöründe kimsenin bilerek indirmediği AGENTS.md ya da CLAUDE.md. Codex için ~/.codex/config.toml içinde beklenmeyen bir [mcp_servers] bloğu. Claude Code için .claude/settings.json içinde ANTHROPIC_BASE_URL ya da tanımadığınız bir API adresi. Ayrıca kurulumlarda function-color adlı npm paketi geçiyorsa makine ele geçirilmiş sayılır ve ajanın hesap token'ları yenilenir.
İlker Pehlivan
Yazan

BT Danışmanı | Ağ, Sistem ve Güvenlik Yönetimi

İlker Pehlivan, karmaşık BT altyapılarını ölçeklenebilir ve güvenli sistemlere dönüştürür. Buradaki rehberleri kendi laboratuvarında kurup ölçerek yazar.

LinkedIn

Sonraki Adım

Bu konuda destek almak ister misiniz?

İstanbul'da yerinde hizmet veriyoruz. Projenizi anlayıp size özel çözüm sunuyoruz. Aynı gün geri dönüş.