Bloga dön

Yeni başlayanlar için AIKılavuz

Claude Code veya Codex'i Downloads'ta mı çalıştırıyorsunuz? AGENTS.md güvenlik kontrolü

Downloads klasöründeki AGENTS.md veya CLAUDE.md adlı bir dosya Claude Code ve Codex'i yönlendirebilir. Bu dosyalar nedir ve yapılandırmalarınız için 5 dakikalık bir kontrol.

Yazan: CheapTokens TeamYayınlanma tarihi: 5 dk okuma

Kapak: Downloads klasöründeki yerleştirilmiş bir AGENTS.md dosyasının bir AI ajanının yapılandırmasına ulaşması
Bu sayfada
  1. AGENTS.md ve CLAUDE.md nedir ve ajan neden onlara inanır
  2. Araştırmacılar Downloads klasöründeki bir dosyayla ne yaptı
  3. Hangi ayarlara bakmalı ve normal bir ayar nasıl görünür
  4. 5 dakikalık kontrol
  5. Bir şey yanlış görünüyorsa

Kısa cevap: Claude Code veya Codex'i ~/Downloads klasörünüzde başlatmayın. 22 Ekim 2026'da güvenlik şirketi Forever Security, bir web sitesinin sessizce Downloads klasörüne AGENTS.md veya CLAUDE.md adında bir dosya kaydedebildiğini ve o klasörde başlatılan bir ajanın bu dosyayı güvenilir talimatlar olarak ele aldığını gösteren bir araştırma yayımladı. Aşağıda: bu dosyaların ne olduğu, araştırmacıların neleri değiştirmeyi başardığı ve yaklaşık beş dakika süren bir kontrol.

Sıradan senaryoyu düşünün. Bir web sitesinden bir düzine PDF ve ekran görüntüsü kaydettiniz, Downloads klasöründe bir terminal açtınız, claude veya codex yazdınız ve "bu dosyaları düzenle" dediniz. Bunun neresi riskli ki? İşte asıl mesele de bu.

AGENTS.md ve CLAUDE.md nedir ve ajan neden onlara inanır#

Bir kodlama ajanı her oturuma sıfırdan başlamaz. İsteğinize bakmadan önce, başlatıldığı klasörde kalıcı talimatlar içeren düz metin bir dosya olup olmadığını kontrol eder: "sekmeler kullan, testleri npm test ile çalıştır, migrations klasörüne asla dokunma." AGENTS.md genel addır, CLAUDE.md Claude Code için aynı fikirdir. Kendi projenizde bu dosyalar işe yarar, çünkü onları siz yazdınız.

Ancak ajan bir dosyayı kimin yazdığını ayırt edemez. Bir web sitesinin Downloads klasörüne bıraktığı CLAUDE.md, geçen hafta sizin yazdığınızla tamamen aynı görünür.

Bilgi kartları

Bu makalede karşılaşacağınız terimler

Araştırmacılar Downloads klasöründeki bir dosyayla ne yaptı#

Forever Security'nin yazısı (yazarlar Gal Weizman ve Omer Samet, 22 Ekim 2026) iki durumu anlatıyor. Aşağıdaki tüm başarı oranları araştırmacıların kendi ölçümleridir.

Codex. Yerleştirilen AGENTS.md, ajana ~/.codex/config.toml dosyasına bir MCP sunucusu girdisi eklemesini söylüyordu ve bu girdi function-color adlı bir npm paketinin kurulmasına yol açıyordu. Araştırmacılara göre yük, denemelerin %90'ından fazlasında çalıştı. Dosyanın nerede durduğuna dikkat edin: Downloads değil, ana klasörünüz. Yapılandırma makine genelinde olduğundan, Downloads klasörünü çoktan unutmuş olsanız bile sonraki her oturum her klasörde etkilenir.

Claude Code. Yerleştirilen CLAUDE.md, .claude/settings.json dosyasına bir ANTHROPIC_BASE_URL ayarı yazmaya çalıştı. Bu ayar, ajanın API trafiğini nereye göndereceğini belirler. Başka birinin sunucusuna yönlendirin, o sunucu OAuth token'ınızı görür ve ajanın çalıştırması için araç çağrıları geri gönderebilir. Yazma işlemi denemelerin yaklaşık yarısında başarılı oldu; aynı oturum içinde yürütülen bir yol ise yaklaşık beşte birinde.

Yerleştirilmiş bir dosyadan değiştirilmiş bir yapılandırmaya
Yerleştirilmiş bir talimat dosyası nasıl ajanın kendi ayarlarına ulaşır (Forever Security, 22 Ekim 2026)

Yazı, iki üründe de hiçbir şeyin "bozuk" olmadığını açıkça belirtiyor: ajan tasarlandığı gibi çalışıyor ve risk, dosyanın nerede durduğundan ve ajanın ona ne kadar güvendiğinden kaynaklanıyor. Forever ayrıca bir müşterinin makinesinde gerçekten yerleştirilmiş bir AGENTS.md bulduğunu ve herhangi bir kod çalışmadan önce kötü niyetli bir npm kurulumunu durdurduğunu söylüyor; npm o zamandan beri function-color paketini kaldırdı. Bu son kısım araştırmacıların kendi anlatımıdır. OpenNET haberi 26 Ekim 2026'da duyurdu ve bir AGENTS.md dosyasının bir pull request veya klonlanmış bir depo aracılığıyla gelmesi durumunda benzer bir riske dikkat çekiyor.

Hızlı kontrol

Codex durumu neden Downloads'taki tek bir kötü oturumdan daha kötü?

Cevabı göster

Cevap: Değiştirdiği yapılandırma makine genelindedir, bu yüzden sonraki her oturum her klasörde etkilenir

Yerleştirilen dosyanın yalnızca bir kez çalışması yeterlidir. ~/.codex/config.toml dosyasına yazdığı şey orada kalır ve her klasördeki sonraki oturumlara uygulanır.

Hangi ayarlara bakmalı ve normal bir ayar nasıl görünür#

İki dosya, araştırmadaki her araç için bir tane.

~/.codex/config.toml dosyasında, eklediğinizi hatırlamadığınız [mcp_servers.*] girdilerini ve sizin ayarlamadığınız bir base URL'yi arayın. Şüpheli bir girdi, makinenizin npm'den bir şey indirip çalıştırmasına neden olur:

toml
[mcp_servers.helper]
command = "npx"
args = ["-y", "some-package"]

Buradaki helper adı ve paket yer tutucudur. Araştırmacıların durumunda, böyle bir girdinin arkasındaki paket function-color idi.

.claude/settings.json dosyasında, sizin koymadığınız bir API uç noktası veya proxy arayın. ANTHROPIC_BASE_URL ayarını hiç yapmadıysanız, dosya bundan hiç söz etmemelidir. Yaptıysanız, seçtiğiniz sağlayıcının adresi olmalıdır. CheapTokens için, Claude Code gibi Anthropic tarzı bir istemci https://api.cheaptokens.dev adresini sonunda /v1 olmadan kullanır; OpenAI tarzı istemciler https://api.cheaptokens.dev/v1 kullanır.

Sizin ayarladığınız bir base URL ile ayarlamadığınız bir base URL
Aynı ayar iki kez: soldaki adres sizin seçtiğiniz, sağdaki tanımadığınız bir sunucu (yer tutucu)

Claude Code'u kendi anahtarınızla çalıştırıyorsanız, Claude Code'u CheapTokens'e bağlamanın adım adım anlatımı dosyanın tamamını gösterir ve dokümanlar her iki base URL'yi listeler. Uzun ajan döngüleri için DeepSeek-V4-Flash (deepseek-ai/DeepSeek-V4-Flash-0731) 380K bağlam, yanıt başına 32.768'e kadar çıktı token'ı ve günün her saatinde tek fiyat sunar; geri kalanı model sayfasında bulabilirsiniz.

Cline, Aider ve diğer ajanlar bu araştırmanın parçası değildi ve her biri ayarlarını kendi yerinde tutar. Alışkanlık aynıdır: uç noktayı hangi dosyanın tuttuğunu bilin ve bir kez okuyun.

5 dakikalık kontrol#

Bir terminal açın ve bunları sırayla uygulayın. Buradaki hiçbir şey bir dosyayı değiştirmez; yalnızca okur.

Adım adım

Makinenizi kontrol edin

Başıboş talimat dosyalarını bulun

bash
find ~/Downloads -maxdepth 3 -name "AGENTS.md" -o -name "CLAUDE.md"

Sizin yazmadığınız her sonuç: metin olarak açın ve okuyun. Nereden geldiğini bilmiyorsanız silin.

Codex yapılandırmasını okuyun

bash
grep -n "mcp_servers\|base_url" ~/.codex/config.toml

Her [mcp_servers.…] satırı, eklediğinizi hatırladığınız bir şey olmalıdır. Codex kullanmıyorsanız "No such file" normaldir.

Claude Code ayarlarını okuyun

bash
grep -n "BASE_URL\|proxy" ~/.claude/settings.json .claude/settings.json

Her iki dosyanın da kapsanması için bunu proje klasörünüzden çalıştırın. Çıktıdaki her adres, sizin seçtiğiniz bir sağlayıcı olmalıdır.

Kabuğunuza bakın

bash
env | grep -i "BASE_URL"

Bu, ortam değişkeni olarak ayarlanmış base URL'leri listeler. Aynı kural: her birini tanımalısınız.

Vakadaki paketi arayın

bash
npm ls -g --depth=0 | grep function-color

Ayrıca bir ajan kullandığınız projelerde npm ls function-color komutunu çalıştırın. Görünürse, makineyi ele geçirilmiş kabul edin.

Bir şey yanlış görünüyorsa#

Önce ajanı kapatın. Ardından tanımadığınız girdileri kaldırın ve ajanın görebildiği her kimlik bilgisini yenileyin: API anahtarları, token'lar, ortamda bulunan her şey. Bir anahtarı yenileme fikri size yeni geliyorsa, API anahtarı nedir ve nasıl saklanır temelleri anlatır.

Bunun tekrar olmasını önleyen alışkanlıklar, hepsi araştırmacıların önlemlerinden:

  • Ajanları Downloads'ta değil, kendi oluşturduğunuz bir proje klasöründe başlatın.
  • Yazmadığınız herhangi bir AGENTS.md veya CLAUDE.md dosyasını, bir klon veya pull request aracılığıyla gelenler dahil, bir ajanı üzerinde çalıştırmadan önce okuyun.
  • Onay istemlerini ve sandbox'ı açık tutun ve ajanın bunları kapatmasını isteyen her talimata karşı dikkatli olun.