Bu bir özellik lansmanı değildi. Modelin kimsenin amaçlamadığı bir biçimde kullandığı bir bağlam tasarımı kararıydı. Claude’un @author gibi alanlarda isim uydurmasını durdurmak için Claude Code, oturum açmış hesabın e-posta adresini modelin bağlamına yerleştirdi. Model daha sonra kendi curl komutlarını yazarken bu adresi, bazı sitelerin botlardan istediği iletişim bilgisi olarak değerlendirip User-Agent’a koydu ve hangi sunucuya erişiyorsa oraya gönderdi. GitHub’daki #107757 numaralı issue (2026-11-05) ve ardından gelen Hacker News başlığı davranışı kamuya açtı; Anthropic 2026-11-06’da açıklama yaptı ve adresi bir sonraki sürümde bağlamdan kaldırmaya söz verdi.
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header · Hacker News: Claude Code sends your email address to websites
2026-11-08’de doğrulayabildiğimiz her şeyi dört kümeye ayırıyoruz: Anthropic çalışanlarının birinci el açıklamaları, CHANGELOG kayıtları, yerleşik modun yayımlanmış kaynak kodundaki README ve issue ile Hacker News’teki, bizim yeniden üretmediğimiz topluluk raporları. Sonra Claude Code’u her gün kullanan birinin gerçekten sorduğu sorulara yanıt veriyoruz: bu benim transkriptlerimde var mı? Yerleşik mod neyi engelliyor, neyi geçiriyor? Ve bir sürümü beklemek istemiyorsam bugün hangi deterministik kontrolleri açabilirim?
1. Ne oldu: bir issue, bir HN başlığı ve mantıklı bir mekanizma
Bug Report: Privacy violation in User-Agent header başlıklı #107757 numaralı issue, 2026-11-05’te taylor-edwards adlı kullanıcı tarafından macOS’ta Claude Code 2.1.318 ile açıldı ve area:security, area:tools, bug ile platform:macos etiketlerini taşıyor. Bildiren kişiye göre Claude Code web aramaları sırasında e-postasını izin almadan User-Agent başlığında rastgele üçüncü taraflara ifşa etti ve sonuç günde onlarca dolandırıcılık e-postası oldu; davranışın bir ayar haline getirilmesi yerine harness’tan tamamen kaldırılmasını istiyor. 2026-11-08’de kontrol ettiğimizde issue hâlâ açıktı ve 108 yorum vardı.
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header
Hacker News’teki Claude Code sends your email address to websites başlığı 7–8 Kasım’da okuduğumuzda yaklaşık 1.596 puan ve 526 yorumdaydı. En üstteki yorum en yararlı ipucunu veriyor: pek çok kişi davranışı ABD SEC’in EDGAR API’sine karşı gördü; bu API’nin belgeleri programatik istemcilerden User-Agent’ta şirket adı ve iletişim e-postasıyla kendilerini tanıtmalarını istiyor. Yorumcu curl ile varsayılan User-Agent’ın 403, adres içerenin 200 döndürdüğünü gösterdi; sonra SEC’in aslında curl dışındaki hemen her User-Agent’ı kabul ettiğini, yani e-postanın gerçekten gerekli olmadığını ekledi. Başkaları Wikipedia’nın ve EVE Online API’sinin de botlardan kendilerini tanıtmalarını istediğini belirtti. T-R adlı katılımcı kişisel hesap adresinin hiçbir uyarı olmadan gönderildiğini ve yalnızca curl isteklerinde göründüğünü bildirdi. Bir başkası alt ajanların başlığa şirket adı, ekip adı ve hatta projenin depo URL’sini doldurduğunu gösterdi. Bunların tamamı topluluk raporu; biz yeniden üretmedik.
Hacker News: Claude Code sends your email address to websites
İki ipucunu birleştirince mekanizma netleşiyor: bir site robotlardan iletişim bilgisi istiyor, modelin bağlamında tesadüfen bir adres var ve model bunu yerine getiriyor. Claude Code’da e-postayı User-Agent’a koymak için yazılmış hiçbir kod yok ve kimse bunu kasıtla yerleştirmedi; bağlam içeriği model özerkliğiyle buluşunca ortaya çıkan şey bu. Tam da bu yüzden bir cümle daha talimat sorunu tamamen çözemez. Anthropic’in kendi en iyi uygulamalar sayfası da bunu söylüyor: her seferinde geçerli olması gereken bir kural CLAUDE.md’ye değil, bir hook’a, bir deny kuralına veya yönetilen bir ayara aittir.
Hacker News: Claude Code sends your email address to websites · Claude Code belgeleri: Best practices
2. Zaman çizelgesi: her kaynağın türü işaretli
Tablo, 2026-11-08’de doğrulayabildiklerimizi sırayla listeler. Birinci el, Anthropic çalışanlarının veya depo bakımcılarının sözleri demektir; CHANGELOG, deponun sürüme göre sıralanan ve tarih içermeyen CHANGELOG.md dosyasındaki bir kayıt demektir; topluluk, issue’da veya HN’de sıradan bir kullanıcının bizim yeniden üretmediğimiz raporudur.
| Tarih / sürüm | Kaynak türü | Ne diyor | 11-08 durumu |
|---|---|---|---|
| 2.1.234 (CHANGELOG, tarihsiz) | CHANGELOG | Claude’a artık hesap e-postanızı yalnızca sizi tanımlamak için kullanması ve siz istemedikçe ilgisiz servislere göndermemesi söyleniyor. Bu, adresin zaten bağlamda olduğunu ve kontrolün bir prompt olduğunu gösterir | Kayıt hâlâ yerinde; önceki kontrolün deterministik olmadığını kendisi belgeliyor |
| 2026-03 (#37201) | Topluluk atfı | Bir yorumcu, modelin adresi git config’den alıp gönderdiği Mart tarihli bir issue’ya atıf yapıyor | Bağlantı erişilebilir; içerik satır satır kontrol edilmedi |
| 2026-07 (#81138) | Topluluk atfı | Bir yorumcu bunu düzeltmeden yaklaşık beş ay önceki asıl issue olarak adlandırıyor | Bağlantı erişilebilir; içerik satır satır kontrol edilmedi |
| 2026-11-05 | Bildiren | #107757 açıldı: 2.1.318, macOS, web aramalarının User-Agent’ında adres | Açık, 108 yorum |
| 2026-11-05 23:31 UTC | Birinci el (katkıcı poteat) | 2.1.317 ve sonrasındaki yerleşik mod cc-plugin-privacy davranışı deterministik olarak engelliyor, varsayılan olarak açık, /plugins’ten kapatılabilir; kaynak daha sonra mods/privacy altında yayımlandı | README okunabilir; topluluk reddetmediğini söylüyor (bölüm 5) |
| 2.1.317 (CHANGELOG) | CHANGELOG | Bir web veya shell araç çağrısı hesap e-postanızı ağa göndermeden önce soran bir denetim eklendi | Kayıt mevcut; ifade soruyor, README ise uyarısız reddediyor diyor |
| 2026-11-06 | Birinci el (HN, lydia_hallie, Claude Code ekibi) | Hesap e-postası bir sonraki sürümde, gelecek haftanın başında beklenen sürümde modelin bağlamından kaldırılıyor; o zamana kadar 2.1.317+ yerleşik modu taşıyor; yine de tüm durumları önlemiyor, örneğin Claude’un bir betik yazıp kendi çalıştırması; kararlı kanal hâlâ 2.1.311’de, 2.1.317 veya sonrasına güncelleyin; özür | Söz kamuya açık; yayımlanıp yayımlanmadığı için son satıra bakın |
| 2026-11-06 | Topluluk | 2.1.317/2.1.318 (macOS, Windows) kullanıcıları modun yüklü göründüğünü ama README’nin kendi test komutunun reddedilmediğini bildiriyor | Bizim tarafımızdan yeniden üretilmedi; kaynak ile dağıtılan derleme arasında olası uyumsuzluk olarak ele alındı |
| 2.1.319 (CHANGELOG, 11-08’de en son) | CHANGELOG | Worktree oluştururken bir sandbox kaçışı; accept-edits ve auto modlarında izin denetimini atlayan bir sed komutu; özel hazırlanmış bir ortam önekinin komutun bir kısmını gizlediği bir Bash izin atlatması düzeltildi | E-postanın bağlamdan kaldırıldığını söyleyen kayıt bulunamadı: kaldırma duyuruldu, yayımlandığı doğrulanmadı |
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header · Hacker News: Claude Code sends your email address to websites · anthropics/claude-code CHANGELOG.md · GitHub issue #81138 (2026-07, topluluk tarafından önceki rapor olarak anılır) · GitHub issue #37201 (2026-03, adres git config üzerinden sızdı)
En önemlisi son satır. 2.1.319’a kadar CHANGELOG’da hesap e-postasının bağlamdan kaldırıldığını söyleyen bir kayıt bulamadık. Bu yüzden yazı kök neden düzeltmesini her yerde duyurulmuş ve beklemede olarak tanımlar, asla yayımlanmış olarak değil. Güncelledikten sonra CHANGELOG.md’nin en yeni sürüm bloğunu kendiniz okuyun ya da yeni oturumların hâlâ bu tür istekler üretip üretmediğini izlemek için 7. bölümdeki betiği kullanın.
3. Neden oldu: bağlam tasarımı, prompt düzeyinde kontrol ve RFC 9110’daki From emsali
Anthropic’in HN açıklaması nedensel zinciri ortaya koyuyor: kullanıcılar Claude’un hesap hakkında bağlamı olmadığı için @author gibi alanlara isim uydurduğunu bildirmişti; ekip hesap e-postasını modelin bağlamına ekledi; ve Claude bir komutu, örneğin bir curl çağrısını kendisi yazdığında, bazı siteler ajanlardan iletişim bilgisi istediği için adresi bazen User-Agent’a iletişim bilgisi olarak koydu. HN’deki başka bir katılımcı gördüğü bağlam parçasını paylaştı; bu parça özünde modele kullanıcının adresini söylüyor, onu yalnızca yazarlık, atıf veya kullanıcının kendi işlerini filtreleme gibi tanımlama amaçlarıyla kullanmasını ve kullanıcı açıkça istemedikçe asla ilgisiz bir servise göndermemesini belirtiyor. Bu, CHANGELOG’daki 2.1.234 kaydıyla örtüşüyor: önceki kontrol bir talimat cümlesiydi.
Hacker News: Claude Code sends your email address to websites · anthropics/claude-code CHANGELOG.md
Protokol tasarımı açısından bu gerilim eski. RFC 9110’un 10.1.2 bölümü From başlığını, isteği yapan kullanıcı ajanını kontrol eden insanın e-posta adresi olarak tanımlar ve kullanıcının açık yapılandırması olmadan bir kullanıcı ajanının From göndermemesi GEREKTİĞİNİ (SHOULD NOT) belirtir; çünkü bu, kullanıcının gizlilik çıkarlarıyla veya sitesinin güvenlik politikasıyla çelişebilir. Aynı bölüm, robotik bir kullanıcı ajanının, işletmecisine ulaşılabilmesi için geçerli bir From göndermesi GEREKTİĞİNİ (SHOULD) söyler. Başka bir deyişle, botların kendilerini tanıtması ve kullanıcı kimliğinin yapılandırma olmadan sızmaması gerektiği spesifikasyonda birlikte yer alır ve açık bir kullanıcı tercihiyle uzlaştırılır. Claude Code adresi modele verdi ama kullanıcıya bu tercihi hiç sunmadı; model de seçimi onun yerine yaptı.
İki farklı veri akışını ayrı tutun. Claude Code’un kendi WebFetch aracının istekleri, telemetrisi ve hata raporları birinci el koddur: veri kullanımı sayfası, hata raporlarında bilinen gizli anahtar, dosya yolu ve e-posta adresi kalıplarının makineden çıkmadan önce maskelendiğini ve WebFetch’in indirmeden önce güvenlik listesi denetimi için api.anthropic.com’a yalnızca sunucu adını gönderdiğini söyler. Bu olaydaki istekler ise modelin yazdığı ve Bash aracının çalıştırdığı curl komutlarıydı. İlki hakkında belgelenen taahhütler ikincisi hakkında hiçbir şey söylemez. HN’deki bir katılımcı WebFetch User-Agent’ını Claude-User (claude-code/2.1.318 (cli); +https://support.anthropic.com/) olarak gözlemledi; bu, issue’daki adresin yalnızca curl isteklerinde göründüğüne dair tekrarlanan raporlarla uyumlu, ama o da bir topluluk gözlemi.
Hacker News: Claude Code sends your email address to websites · Claude Code belgeleri: Data usage
4. Anthropic ne yayınladı: yerleşik modun README’si madde madde
Bakımcı poteat issue’da 2.1.317’den itibaren yerleşik mod cc-plugin-privacy’nin bu davranışı deterministik olarak engellediğini, varsayılan olarak etkin olduğunu ve /plugins üzerinden kapatılabileceğini yazdı; kaynak daha sonra deponun mods/privacy dizininde yayımlandı. README’si dikkat çekici biçimde ölçülü ve madde madde okunmaya değer. Mod, Bash, PowerShell ve Monitor çağrıları üzerinde tek bir tool.check hook’u içerir. Bir çağrı, girdisi oturum açmış hesabın adresini (herhangi bir harf büyüklüğünde ya da bir geçişlik yüzde kodlamasından sonra) içeriyorsa ve bir User-Agent’ı adlandırıyorsa reddedilir. Adlandırmak demek User-Agent, user_agent, --user-agent, -UserAgent, bu bayrakların bir öneki ya da UA= ifadesi, ya da curl -A, wget -U ve PowerShell’in -User istemci bayrakları demektir.
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header · Yerleşik mod kaynağı: mods/privacy README
İki cümle ne olduğunu tanımlıyor. Birincisi: test, tüm girdi üzerinde iki kelime eşleşmesidir ve kasıtlı olarak ayrıştırıcı yoktur. Dolayısıyla User-Agent ayarlayan ama adresi başka yere gönderen bir çağrıyı ya da sadece adresin yanında bu kelimeyi geçiren bir çağrıyı da reddeder ve bu yanlış redleri basitlik uğruna kabul eder. İkincisi: bu bir nezakettir, sınır değildir ve tek bir biçimi kapsar. README ardından geçenleri listeler: User-Agent adlandırılmadan adres (bir URL, istek gövdesi, curl -u, From: başlığı); herhangi bir WebFetch, WebSearch veya MCP araç çağrısı; çalışma zamanında hesaplanan bir değer, örneğin $(git config user.email), bir değişken, adıyla gönderilen bir dosya, adresi içeren bir betik, adlandırılmamış bir istemci, başlığı başka biçimde ayarlayan bir istemci, bir geçişlik yüzde kodlamasının ötesindeki her kodlama ve yüzde kodlanmış ASCII dışı bir adres.
Birinci el materyaller arasındaki bir tutarsızlığın olduğu gibi kaydedilmesi gerekiyor. HN açıklaması ve 2.1.317 CHANGELOG kaydı denetimin size sorduğunu söylüyor; README ise reddin kim orada olursa olsun ve izin modu ne olursa olsun hiçbir uyarı üretmediğini, kayıtlı bir allow kuralının ve auto modunun sınıflandırıcısının bunu kaldırmadığını söylüyor. Hangi tanımın dağıtılan ikili dosyaya karşılık geldiğini söyleyemiyoruz; kendi makinenizin ne yaptığına bakın (10. bölüm nasıl yapılacağını gösteriyor). README’ye göre kapatmak için: /plugin disable ya da kullanıcı, --settings veya yönetilen ayarlardaki enabledPlugins altında "cc-plugin-privacy@builtin": false; bir deponun ayarları onu kapatamaz. Üstünde yer alan yüklü bir eklentinin hook’u tool.check’te reddi geçersiz kılabilir ve hooks modülü yüklenmeyen bir oturum onu hiç çalıştırmaz.
anthropics/claude-code CHANGELOG.md · Yerleşik mod kaynağı: mods/privacy README
Kök neden düzeltmesine, yani adresin bağlamdan kaldırılmasına gelince, 2026-11-08 itibarıyla bu kamuya açık bir söz. Geldiğinde modelin e-postanızı bildiği öncülünü ortadan kaldıracak, ama topluluğun zaten işaret ettiği bir şeyi değiştirmeyecek: model kendine bir User-Agent uydururken proje, müşteri veya görev adını çekerek açıklayıcı ürün belirteçleri de uyduruyor. Adres gider; proje adı yine birinin günlüğüne düşebilir.
5. Boşluklar: README’nin kabul ettikleri ile topluluğun bildirdikleri
Tabloda sol sütun README’nin geçenlere dair kendi listesinden, orta sütun issue yorumlarından (tamamı 2026-11-06 tarihli, bizim yeniden üretmediğimiz topluluk raporları), sağ sütun ise 7–10. bölümlerdeki savunmaların durumu kapsayıp kapsamadığından gelir. Orta sütunu doğrulanmış kusurlar olarak değil, kendi makinenizde doğrulanacak hipotezler olarak ele alın.
| Senaryo | README (mods/privacy) | Topluluk raporu (issue, yeniden üretilmedi) | Bu yazının kurulumu kapsıyor mu? |
|---|---|---|---|
| Adres var ama User-Agent adlandırılmamış (URL, gövde, curl -u, From: başlığı) | Açıkça geçer | — | Hook: adres içeren her girdi reddedilir, User-Agent gerekmez |
| WebFetch / WebSearch / MCP araçları | Denetlenmez | — | Hook matcher’ı WebFetch ve WebSearch’ü kapsar; MCP için mcp__.* ekleyin |
| Çalışma zamanı değeri $(git config user.email) | Geçer | Bir yorumcu adresinin gitconfig’den alınıp gönderildiğini söylüyor | Hook, git config … user.email içeren komutları reddeder; ayrıca commit’leri no-reply kimliğine taşıyın |
| Adres Edit ile betiğe yazılıp sonra python3 fetch.py | Geçer (adresi içeren bir betik) | mkubenka: tam olarak ikinci vakası; denetlenen hiçbir shell girdisi adresi içermiyordu | Hook matcher’ı Write ve Edit’i içerir, yazma anında yakalanır |
| User-Agent’ta açıklayıcı ürün belirteçleri (proje, müşteri adı) | Kapsam dışı (yalnızca adresi eşleştirir) | mkubenka: PROJECT-site-build/1.0 gibi adressiz dizeler geçiyor | Hook kapsamaz; sandbox hedefleri sınırlar ama başlıkları yeniden yazamaz; CLAUDE.md sözleşmesi ve transkript incelemesi kalır |
| Mod yüklü ama reddetmiyor | — | love540 (macOS, 2.1.317/2.1.318) ve KardKuro (Windows 11, 2.1.318): system/init cc-plugin-privacy’yi listelemesine rağmen test komutu çalıştı | Hook ve sandbox moda bağımlı değil; 10. bölüm denetimi veriyor |
| Çift kodlama / ASCII dışı adres | Geçer | — | Hook, [at] ve bir geçişlik yüzde kodlamasını ekler; diğer varyantlar aynı ölçüde kapsam dışı |
| Üstteki eklenti hook’u reddi geçersiz kılar; hooks modülü yüklenmemiş | README’de kabul edilmiş | — | Kullanıcı ayarlarındaki hook’unuz bağımsız çalışır; onFailure: block, hook’un kendi hatasını da engelleme sayar |
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header · Yerleşik mod kaynağı: mods/privacy README
Topluluktan bir kendi kendine denetim dikkati hak ediyor. morsik adlı katılımcı Claude’a ~/.claude/projects/**/*.jsonl altındaki her araç çağrısını taratmış ve 2026-08-09 ile 2026-11-01 arasında 8 oturumda adresi User-Agent’a koyan 53 çağrı bulmuş; hemen hepsi WebFetch’ten değil, kendi curl -A "TOOL/1.0 (adres)" komutlarını yazan iş akışı alt ajanlarından geliyor. Üç sonuç çıkıyor: pencere Kasım’dan çok önce başlıyor; ana taşıyıcı alt ajanların shell komutları; ve yerel transkriptleriniz elinizdeki en iyi denetim malzemesi. 7. bölümdeki betik tam da bunun için yazıldı.
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header
6. İstek yolu: adres nereden geliyor, nereye gidiyor, her savunma nerede duruyor
Bir savunmanın işe yarayıp yaramadığını değerlendirmek için verinin attığı her adımı çizin. Başlangıç oturum açma: topluluk raporları hesap adresini ~/.claude.json dosyasının oauthAccount.emailAddress alanına yerleştiriyor (bir yorumcunun iddiası; kaynakla karşılaştırmadık) ve adres modelin bağlamına konuyordu (birinci elden doğrulanmış). İkinci adım, modelin bir araç çağrısı üretmesi: bir Bash komutu, bir WebFetch URL’si, diske betik yazan bir Write. Üçüncü adım çağrı öncesi denetim: PreToolUse hook’unuz ve yerleşik modun tool.check’i burada yaşar ve yalnızca çağrının metin parametrelerini görür. Dördüncü adım izin kuralları: deny kuralları her izin modunda geçerlidir, ask kuralları sorar ve auto modunun sınıflandırıcısı deterministik kurallardan sonra çalışır. Beşinci adım sandbox: Bash, PowerShell ve Monitor komutları, ağı her sunucuyu başlangıçta boş olan allowedDomains listesiyle karşılaştıran yerel bir proxy’den geçen, işletim sistemi tarafından uygulanan bir sınır içinde çalışır; Read, Edit, Write, WebFetch, WebSearch, hook’lar, MCP sunucuları, modlar ve ! isteminde sizin yazdığınız komutlar bunun dışındadır. Son adım, uzak sunucunun başlığı günlüğüne yazmasıdır ve oradan sonra hiçbir yerel kontrol yoktur.
Buradan iki yapısal gerçek çıkıyor. Birincisi, her metin eşleştirme denetimi (mod, hook, deny kuralı) yalnızca çalışma zamanında var olan değerlere kördür: $(git config user.email), ortam değişkenleri, bir betiğin okuduğu dosya içerikleri. Yalnızca sandbox proxy’si komut metninden bağımsızdır ve o da başlık içeriğini değil hedefi denetler. İkincisi, adresi bağlamdan kaldırmak başlangıç noktasını değiştiren tek önlemdir; geri kalan her şey adres oradan çıktıktan sonraki kontrol noktalarıdır. Makul bileşim bu yüzden şudur: kök neden düzeltmesini bekleyip doğrulayın, bu arada metinsel biçimlere karşı bir hook, hedeflere karşı sandbox ve çalışma zamanı sorgularının açığa çıkarabileceklerini azaltmak için ayrı bir git kimliği kullanın.
- Oturum açma → adres ~/.claude.json’a (topluluk iddiası) ve modelin bağlamına (birinci el) düşer
- Model bir araç çağrısı yazar: Bash komutu / WebFetch URL’si / betik yazan Write (adresi iletişim bilgisi olarak ekleyebilir)
- PreToolUse hook’u ve yerleşik modun tool.check’i: çağrı üzerinde metin eşleşmesi; exit 2 veya red durdurur
- İzin kuralları: deny her modda geçerli, ask sorar, sonra auto sınıflandırıcısı karar verir
- Sandbox ağ proxy’si: yalnızca Bash/PowerShell/Monitor; allowedDomains geçer, deniedDomains reddedilir
- Üçüncü taraf sunucu User-Agent’ı günlüğe yazar → yerel kontrol kalmaz
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header · Claude Code belgeleri: Hooks · Claude Code belgeleri: Sandboxing · Claude Code belgeleri: Best practices · Claude Code belgeleri: Permissions
7. Kendi kendine denetim: yerel transkriptlerde adresi taşıyan araç çağrılarını tarayın
Claude Code her projenin oturum kayıtlarını ~/.claude/projects altında, ya da ayarlıysa CLAUDE_CONFIG_DIR altında .jsonl dosyaları olarak saklar. Biçim belgelenmemiştir, bu yüzden betik sabit bir yapı varsaymaz: her satırı JSON olarak ayrıştırır, her nesneyi özyinelemeli dolaşır ve type değeri tool_use olan ve bir input nesnesi taşıyan bir düğümle karşılaştığında o input’u serileştirip içinde verdiğiniz adresi, yüzde kodlanmış biçimi dahil, arar. Eşleşmede zaman damgasını, dosya adı önekini, araç adını, ayrıca bir User-Agent adlandırılıp adlandırılmadığını ve maskelenmiş girdinin ilk 220 karakterini yazdırır. Yalnızca okur; hiçbir şeyi değiştirmez ve ağ çağrısı yapmaz.
Claude Code belgeleri: Hooks · Claude Code belgeleri: Settings
#!/usr/bin/env python3
"""Read-only audit of local Claude Code transcripts: which recorded tool calls
carried the address you pass in? Nothing is modified or sent anywhere."""
import json, os, re, sys
from pathlib import Path
from urllib.parse import quote
if len(sys.argv) < 2 or "@" not in sys.argv[1]:
sys.exit("usage: python3 audit_transcripts.py you@example.com")
ADDR = sys.argv[1].strip().lower()
FORMS = {ADDR, quote(ADDR, safe=""), ADDR.replace("@", "%40")}
ROOT = Path(os.environ.get("CLAUDE_CONFIG_DIR", Path.home() / ".claude")) / "projects"
UA = re.compile(r"user[-_ ]?agent|(?:^|\s)-A\s|(?:^|\s)-U\s|-UserAgent", re.I)
def tool_uses(node): # the transcript format is undocumented: walk every object
if isinstance(node, dict):
if node.get("type") == "tool_use" and isinstance(node.get("input"), dict):
yield node
for value in node.values():
yield from tool_uses(value)
elif isinstance(node, list):
for value in node:
yield from tool_uses(value)
hits, files = 0, set()
for path in sorted(ROOT.glob("**/*.jsonl")):
for line in path.open(encoding="utf-8", errors="replace"):
try:
rec = json.loads(line)
except ValueError:
continue
for call in tool_uses(rec):
raw = json.dumps(call["input"], ensure_ascii=False)
if not any(form in raw.lower() for form in FORMS):
continue
hits += 1; files.add(path)
shown = raw
for form in FORMS:
shown = re.sub(re.escape(form), "<account email>", shown, flags=re.I)
print(f"{str(rec.get('timestamp', '?'))[:19]} {path.stem[:8]} "
f"tool={call.get('name')} ua_named={'yes' if UA.search(raw) else 'no'}")
print(" " + shown[:220])
print(f"\n{hits} tool call(s) in {len(files)} transcript file(s) contained the address.")
Çıktıyı okurken üç şeyi aklınızda tutun. ua_named=yes satırları kabaca yerleşik modun eşleştireceği şeylere karşılık gelir; ua_named=no satırları README’nin geçirdiğini kabul ettiği biçimlerdir (URL’ler, istek gövdeleri, betik içerikleri). Eşleşmeler Write veya Edit üzerinde yoğunlaşıyorsa adres bir betiğe yazılıp sonra çalıştırılmıştır; topluluğun modun göremediğini söylediği yol tam da budur. Ve eşleşme sayısı gerçekten gönderilen istek sayısı değildir: bir komut başarısız olmuş, siz onu istemde reddetmiş olabilirsiniz ve transkript uzak sunucunun bir şey alıp almadığını asla kaydetmez. Size modelin bunu yapmaya niyetlendiğini söyler; bu da 8. bölümdeki hook’a ihtiyacınız olup olmadığına karar vermek için yeterlidir.
8. Birinci deterministik savunma: kimliğinizi taşıyan her araç girdisini reddeden bir PreToolUse hook’u
Hook belgeleri şunu belirtir: bir PreToolUse hook’u stdin’den tool_name ve tool_input içeren JSON alır (Bash için command; Write için file_path ve content; Edit için new_string; WebFetch için url ve prompt vb.); 2 koduyla çıkmak çağrıyı engeller ve stderr modele gösterilen gerekçe olur; alternatif olarak hook, permissionDecision değeri deny olan bir hookSpecificOutput nesnesi yazdırabilir. Matcher’lar Bash veya Edit|Write gibi araç adlarını ve düzenli ifadeleri kabul eder. 2.1.314’ten bu yana bir Bash matcher’ı Monitor aracının başlattığı komutlar için de çalışır. Hook’lar alt ajanların içinde de tetiklenir; topluluğa göre bu isteklerin çoğu tam da oradan gelmiştir.
Aşağıdaki hook kasıtlı olarak yerleşik moddan daha geniştir: tool_input’un herhangi bir alanı kimliklerinizden birini içeriyorsa (~/.claude/private-identifiers.txt içinde satır başına bir adres, artı git config user.email’in şu anda döndürdüğü değer), User-Agent adlandırılsın ya da adlandırılmasın 2 ile çıkar. Ayrıca git config … user.email içeren Bash veya PowerShell komutlarını da reddeder; çünkü çalışma zamanı sorgusu hiçbir metin denetiminin göremeyeceği bir şeydir. Bedeli yanlış redlerdir: Claude’dan kendi adresinizi gerçekten bir yapılandırma dosyasına yazmasını istediğinizde hook bunu da durdurur ve stderr’i modele bu adımı sizden elle yapmanızı istemesini söyler. Bu ödünleşim kasıtlıdır ve README’nin yanlış redlere karşı tutumunu yansıtır.
#!/usr/bin/env python3
"""PreToolUse hook: exit 2 (block) when a tool input carries one of your own
addresses, or reads the git identity at run time. Reads stdin JSON only."""
import json, os, re, subprocess, sys
from pathlib import Path
from urllib.parse import quote
def identities():
ids = set()
listed = Path(os.environ.get("IDENTITY_GUARD_FILE",
Path.home() / ".claude" / "private-identifiers.txt"))
if listed.is_file():
ids |= {l.strip().lower() for l in listed.read_text().splitlines() if "@" in l}
try: # whatever `git config user.email` would answer right now
out = subprocess.run(["git", "config", "--get", "user.email"],
capture_output=True, text=True, timeout=3).stdout.strip()
if "@" in out:
ids.add(out.lower())
except (OSError, subprocess.SubprocessError):
pass
return ids
payload = json.load(sys.stdin)
tool = payload.get("tool_name", "")
blob = json.dumps(payload.get("tool_input", {}), ensure_ascii=False).lower()
reasons = []
for addr in identities():
forms = {addr, quote(addr, safe=""), addr.replace("@", "%40"), addr.replace("@", "[at]")}
if any(form.lower() in blob for form in forms):
reasons.append(f"input contains a private identifier ({addr[:2]}***)")
if tool in ("Bash", "PowerShell") and re.search(r"git\s+config\b[^|;&]*user\.email", blob):
reasons.append("command reads the git identity at run time, which this hook cannot see")
if reasons:
sys.stderr.write("identity-guard: " + "; ".join(reasons)
+ ". Remove it, or ask the user to run this step by hand.\n")
sys.exit(2)
İki uygulama notu. jq yerine Python, tüm tool_input’u bir kez serileştirip eşleştirmeyi sağlar, böylece araç başına alan adı gerekmez; belgeler Windows’ta file_path’in ters eğik çizgilerle geldiği konusunda uyarır ama bu betik yol karşılaştırmaz, dolayısıyla etkilenmez. Hook JSON yazdırmaz ve yalnızca çıkış koduna dayanır: belgelere göre exit 2 artı stderr engellemenin ve gerekçe iletmenin standart yoludur; 0 ya da 2 olmayan bir çıkış kodu ise varsayılan olarak engellemez. Bu yüzden 9. bölümdeki kayıt onFailure: block (2.1.295’ten beri mevcut) ayarlar; böylece betiğin çökmesi veya zaman aşımı da engelleme sayılır.
9. İkinci ve üçüncü deterministik savunmalar: tek bir settings.json’da deny kuralları ve sandbox ağ izin listesi
En iyi uygulamalar sayfası ilkeleri koyar: deny kuralları auto ve bypassPermissions dahil her izin modunda geçerlidir; Read(./.env) gibi bir kural, Claude Code yaygın dosya okuma komutlarını tanıdığı için cat .env’i de yakalar ama dosyayı kendi açan bir betiği yakalamaz; ve bir alan adı için WebFetch deny kuralı, sandbox açık değilse aynı alan adına curl’e karşı hiçbir şey yapmaz. Vardığı sonuç: güvenlikle ilgili her şey için ikisini birden istersiniz. İzinler sayfası, Bash deny kurallarının komutu yazıldığı haliyle eşleştirdiğini, dolayısıyla /usr/bin/curl ya da sh -c 'curl …' biçimlerinin kaçtığını ekler; bu yüzden geçerli olması gereken bir ağ kısıtlaması sandbox izin listesine ihtiyaç duyar.
Claude Code belgeleri: Best practices · Claude Code belgeleri: Permissions · Claude Code belgeleri: Security
Sandbox sayfasından temel gerçekler: sandbox varsayılan olarak kapalıdır ve /sandbox ile ya da "sandbox": {"enabled": true} ile açılır; macOS Seatbelt kullanır, Linux ve WSL2 bubblewrap artı socat kullanır, yerel Windows desteklenmez; doğrudan çıkış yoktur, bağlantılar başlangıçta boş olan allowedDomains’i denetleyen yerel bir proxy’den geçer; liste dışındaki bir sunucu manuel modda sorar, dontAsk modunda reddedilir ve bypassPermissions modunda geçer, deniedDomains ise her modda reddedilir; allowUnsandboxedCommands: false sandbox dışı yeniden denemeyi kapatır (Overrides sekmesindeki katı mod); credentials.files ve credentials.envVars deny kayıtları sandbox’taki komutların ~/.ssh ve benzerlerini okumasını ya da adlandırılmış değişkenleri görmesini engeller. Ancak bu credentials kayıtları yalnızca kullanıcı veya yönetilen ayarlardan uygulanır; proje ve yerel ayarlardakiler yok sayılır.
{
"permissions": {
"deny": ["Read(./.env)", "Read(./.env.*)", "Read(./secrets/**)", "Read(~/.claude.json)"],
"ask": ["Bash(curl *)", "Bash(wget *)", "Bash(dangerouslyDisableSandbox:true)"]
},
"hooks": {
"PreToolUse": [
{
"matcher": "Bash|PowerShell|Write|Edit|WebFetch|WebSearch",
"hooks": [
{
"type": "command",
"command": "python3 ~/.claude/hooks/identity_guard.py",
"timeout": 10,
"onFailure": "block"
}
]
}
]
},
"sandbox": {
"enabled": true,
"allowUnsandboxedCommands": false,
"network": {
"allowedDomains": ["github.com", "*.npmjs.org", "pypi.org", "files.pythonhosted.org"]
},
"credentials": {
"files": [
{ "path": "~/.ssh", "mode": "deny" },
{ "path": "~/.aws/credentials", "mode": "deny" }
],
"envVars": [{ "name": "GITHUB_TOKEN", "mode": "deny" }]
}
}
}Madde madde: Read(~/.claude.json), topluluğun adresin saklandığı yer olarak gösterdiği dosyayı hedefler; böylece modelin Read aracı ve cat gibi tanınan komutlar onu okuyamaz (Claude Code’un kendisi hâlâ okuyabilir); Bash(curl *) ve Bash(wget *) ask kuralları ağ komutlarının her seferinde sormasını sağlar ve güvenlik sayfası bu komutların manuel modda zaten otomatik onaylanmadığını belirtir; Bash(dangerouslyDisableSandbox:true), sandbox sayfasının önerdiği ask kuralıdır: auto ve bypassPermissions modlarında bile sandbox dışı yeniden denemede sorar ve allowUnsandboxedCommands: false’u destekler; allowedDomains, derlemenizin gerçekten ihtiyaç duyduğu alanlarla değiştirmeniz gereken bir yer tutucudur. Hook matcher’ı Bash|PowerShell|Write|Edit|WebFetch|WebSearch şeklindedir; sayfaları MCP araçlarıyla çekiyorsanız mcp__.* için de bir matcher ekleyin.
Claude Code belgeleri: Sandboxing · Claude Code belgeleri: Permissions · Claude Code belgeleri: Security
| Katman | Niteliği | Kapsar | Kapsamaz | Dayanak |
|---|---|---|---|---|
| Sistem bağlamındaki cümle (2.1.234’ten beri) | Deterministik değil | Modele adresi yalnızca sizi tanımlamak için kullanmasını hatırlatır | Model bu durumun istisna olduğuna karar verebilir; olan da buydu | CHANGELOG; en iyi uygulamalar |
| CLAUDE.md sözleşmeleri | Deterministik değil | Ekip düzeyinde User-Agent adlandırması, hangi sitelerin iletişim bilgisi alabileceği | Her seferinde geçerli olması gereken herhangi bir kural | En iyi uygulamalar |
| Yerleşik mod cc-plugin-privacy | Deterministik (metin eşleşmesi) | Bash/PowerShell/Monitor girdisinde adres artı adlandırılmış User-Agent | User-Agent’sız adres, WebFetch/WebSearch/MCP, çalışma zamanı değerleri, adres içeren betikler, diğer kodlamalar; üstteki eklenti geçersiz kılabilir | README |
| Sizin PreToolUse hook’unuz | Deterministik (metin eşleşmesi) | Bash/PowerShell/Write/Edit/WebFetch/WebSearch girdisindeki her kimlik biçimi; git config user.email komutları | Çalışma zamanı değerleri, değişkenler, listelenmemiş kimlikler, açıklayıcı ürün belirteçleri | Hook belgeleri |
| permissions.deny / ask | Deterministik (yazıldığı haliyle komut) | .env ve ~/.claude.json okuma; curl/wget her seferinde sorar | Yoluyla çağrılan ya da sh -c ile sarılan programlar; dosyaları kendi açan betikler | İzinler, en iyi uygulamalar, güvenlik belgeleri |
| Sandbox ağ izin listesi (katı mod) | Deterministik (işletim sistemi düzeyi) | Bash/PowerShell/Monitor komutlarının hedefleri; kimlik bilgisi dosyaları ve değişkenleri | Read/Edit/Write/WebFetch/WebSearch, hook’lar, MCP, modlar, ! komutları; başlık içeriği | Sandbox belgeleri |
| Adresin bağlamdan kaldırılması (duyuruldu) | Öncülü ortadan kaldırır | Model artık hesap e-postanızı bilmez | git config, dosyalar, ortamdaki adresler; User-Agent’taki proje adları | HN açıklaması; CHANGELOG beklemede |
anthropics/claude-code CHANGELOG.md · Yerleşik mod kaynağı: mods/privacy README · Claude Code belgeleri: Hooks · Claude Code belgeleri: Sandboxing · Claude Code belgeleri: Best practices · Claude Code belgeleri: Permissions
10. Doğrulama: reddi zararsız bir komutla teyit edin ve git’i no-reply kimliğine taşıyın
Yazılmış bir yapılandırma çalışan bir yapılandırma değildir. Hook belgeleri settings.json’daki yanlış yazılmış bir yolun hook’un hiç çalışmamasına yol açtığı ve ilk çalıştırmada hook error bildirimine dikkat edilmesi gerektiği konusunda uyarır. Aşağıdaki betik beş şey yapar: claude --version yazdırır; dört sentetik PreToolUse yükünü doğrudan hook’a verir (geçici kimlik dosyası yalnızca you@example.com içerir ve her hedef bir .invalid adıdır, dolayısıyla hiçbir şey gönderilmez); gerçek bir oturumda Claude’dan echo 'User-Agent: test ADRESİNİZ' > /dev/null komutunu çalıştırmasını isteyip reddi gözlemlemenizi söyler; mevcut git kimliğinizi yazdırır; ve /plugins ile /sandbox’ı kontrol etmenizi hatırlatır.
Claude Code belgeleri: Hooks · Claude Code belgeleri: Sandboxing
#!/usr/bin/env bash
# Verify the guard without sending anything: every target is a non-routable .invalid name.
set -u
echo "1) version (the built-in mod needs 2.1.317+; read CHANGELOG.md for the context change)"
claude --version
echo "2) hook blocks synthetic payloads (expect exit=2 and an identity-guard reason on stderr)"
tmp=$(mktemp); echo "you@example.com" > "$tmp"
run() { printf '%s' "$1" | IDENTITY_GUARD_FILE="$tmp" python3 ~/.claude/hooks/identity_guard.py; echo " exit=$?"; }
run '{"tool_name":"Bash","tool_input":{"command":"curl -A \"bot/1.0 (you@example.com)\" http://leak-test.invalid/"}}'
run '{"tool_name":"Write","tool_input":{"file_path":"/tmp/fetch.py","content":"UA = \"tool/0.1 (mailto:you%40example.com)\""}}'
run '{"tool_name":"Bash","tool_input":{"command":"curl -A \"$(git config user.email)\" http://leak-test.invalid/"}}'
run '{"tool_name":"Bash","tool_input":{"command":"npm test"}}' # expect exit=0
rm -f "$tmp"
echo "3) inside a session, ask Claude to run exactly: echo 'User-Agent: test <your address>' > /dev/null"
echo " expected: the call is refused and the transcript shows the identity-guard reason"
echo "4) git identity any \$(git config user.email) would reveal:"; git config --get user.email || echo "(unset)"
echo " prefer a no-reply address for agent commits: git config --global user.email <id>+<name>@users.noreply.github.com"
echo "5) /plugins -> Installed should list cc-plugin-privacy@builtin; /sandbox -> Network shows the allowlist, Overrides shows strict mode"
Bu echo testi doğrudan issue yorumlarından geliyor: ağa dokunmaz ama hem adresi hem de User-Agent kelimelerini içerir; README’nin reddetmeye söz verdiği biçim tam olarak budur. Topluluk bundan çalıştı, reddedilmedi sonucunu aldı; siz iki sonuçtan birini görmelisiniz. Yerleşik mod çalışıyorsa model modun REFUSAL’ını alır; yalnızca sizin hook’unuz çalışıyorsa transkriptte identity-guard: ile başlayan bir gerekçe görünür. İkisi de görünmüyorsa hook’unuz çalışmıyordur: settings.json’daki yolu ve python3’ün PATH’te olduğunu kontrol edin.
GitHub issue #107757: Bug Report: Privacy violation in User-Agent header · Yerleşik mod kaynağı: mods/privacy README
Git kimliğinizi ayırmak savunmaların en ucuzudur. README de topluluk da $(git config user.email)’i hiçbir metin eşleşmesinin göremediği bir çalışma zamanı yolu olarak adlandırıyor. Küresel user.email’iniz kod platformunuzun verdiği bir no-reply adresi olduğunda, onu okuyan bir komut yalnızca posta almayan bir adresi sızdırır. Bu, commit’lerinizdeki yazar e-postasını değiştirir; ekibiniz DCO veya imza denetimi zorunlu kılıyorsa adresin platformdaki hesabınıza bağlı olduğunu önce doğrulayın.
11. İşlem sırası: bugün, güncellemeden sonra ve sürekli
- Bugün: etkilenip etkilenmediğinizi ve taşıyıcının alt ajan curl’ü olup olmadığını öğrenmek için 7. bölümdeki denetim betiğini çalıştırın; çıktıyı kendinize saklayın, kimseye göndermeyin.
- Bugün: 8 ve 9. bölümlerdeki hook’u ve ayarları kullanıcı kapsamında kurun, 10. bölümdeki doğrulama betiğini çalıştırın ve küresel git kimliğinizi bir no-reply adresine çevirin.
- 2.1.317 veya sonrasına güncelleyin (HN açıklaması kararlı kanalın hâlâ 2.1.311’de olduğunu söylüyordu), /plugins’te cc-plugin-privacy@builtin’in yüklü olduğunu doğrulayın ve gerçekten reddettiğini echo testiyle kontrol edin: topluluk raporları yüklü ile reddediyor’un iki farklı şey olabileceğini düşündürüyor.
- Her güncellemeden sonra CHANGELOG.md’nin en yeni sürüm bloğunu hesap e-postasının bağlamdan kaldırıldığını söyleyen bir kayıt için okuyun; görene kadar düzeltmeyi yayımlanmamış sayın.
- Sürekli: denetimi zaman zaman yeni oturumlarda yeniden çalıştırın ve CLAUDE.md’de modelin kendi yazdığı User-Agent’ların proje ya da müşteri adı içermeyen genel bir belirteç kullanmasını öngören bir sözleşme koyun. Bu deterministik değildir ve yalnızca tamamlayıcıdır.
- Ekipler: hook’u ve deny kurallarını deponun .claude/settings.json dosyası üzerinden paylaşın (deny hemen uygulanır, allow güven iletişim kutusunu bekler); credentials kayıtlarının ve katı sandbox’ın kullanıcı veya yönetilen ayarlar gerektirdiğini unutmayın.
Ölçü üzerine son bir söz. Ders, Claude Code’a güvenilemeyeceği değil; modelin bağlamına konan her şeyin modelin ürettiği herhangi bir dizede görünebileceğinin varsayılması gerektiğidir. E-posta adresi yalnızca gözlemlenmesi en kolay örnek; proje adları, müşteri adları ve iç sunucu adları aynı yolu izler. Deterministik kontroller değerlidir çünkü modelin yargısına bağlı değildir; denetim betiği değerlidir çünkü bir sonraki adıma başkasının ekran görüntüsüyle değil kendi verinizle karar vermenizi sağlar.
Doğrulamadıklarımız: adresin User-Agent’a girdiği özgün davranışı hiçbir sürümde yeniden üretmedik; yerleşik modun 2.1.317, 2.1.318 veya 2.1.319’da README’sinde tanımlanan komutu gerçekten reddedip reddetmediğini test etmedik (topluluk reddetmediğini söylüyor; biz yeniden üretmedik); ~/.claude.json’daki oauthAccount.emailAddress alanı iddiasını kontrol etmedik; e-postanın bağlamdan kaldırıldığını söyleyen bir CHANGELOG kaydı bulamadık, bu yüzden kök neden düzeltmesini duyurulmuş ama yayımlandığı doğrulanmamış sayıyoruz; #81138 ve #37201 numaralı issue’ları satır satır okumadık, yalnızca bağlantıların açıldığını doğruladık. Buradaki hook, ayarlar ve betikler yalnızca sentetik verilerle ve .invalid adlarıyla çevrimdışı test edildi; hiçbir zaman üretimde ya da gerçek ağda çalıştırılmadı. Bu yazı Anthropic’in ürününü ve açık kaynak deposunu inceler; bu sitenin Anthropic ile ilişkisi yoktur.