Claude Code'u politika altına alma

Claude Code bir uçbirimde çalışır; bu yüzden ne bir tarayıcı eklentisi ne de kendi uygulamalarınızın önündeki bir ters vekil onu görür. Onu politika altına iki bağımsız katman alır: kancaları istemleri ve araç çıktısını denetleyen bir eklenti ve sağlayıcı trafiğinin kendisini ağ geçidi üzerinden yönlendiren, böylece bir istemin yol üzerinde maskelenmesini sağlayan bir temel URL.

İki katman ve her birinin yapabildikleri

Eklenti ayrıca araç çıktısını model görmeden önce maskeler; temel URL bunu yapamaz, çünkü aracın okuduğu bir dosya hiçbir zaman bir istem olarak ağdan geçmez. İkisini birden kullanın.

Cihazınız için ayarları üretin

Tek bir teslim kanalı seçin

Yönetilen kaynaklar birleştirilmez. Bir kanal herhangi bir anahtar teslim ediyorsa diğeri tümüyle yok sayılır. Birini seçin ve her şeyi ona koyun.

Yol üzerinde maskelemeyi açın

Kurulum sihirbazının Claude Code'u bağla adımı bunu sizin yerinize yapar. Anahtarla birlikte vekili passthrough kipine alır, bu makinenin denetim yüzeyine yöneltir ve ardından makineye yalnızca vekili yeniden oluşturtur. Seçtiğiniz tek parça maskelemedir: öntanımlı olarak kapalıdır ve adımın passthrough_mask seçeneğiyle açılır. Elle düzenlenecek bir şey yoktur.

Sihirbazın yazdığı dört değer:

PROXY_ANTHROPIC_MODE=passthrough
CID_INSPECT_URL=http://nestjs-core:3000/inspect/v1/claude-code
CID_INSPECT_KEY=<sihirbazın ürettiği anahtar>
CID_PASSTHROUGH_MASK=false        # maskeleme istediyseniz true

Bunları yalnızca anahtarı döndürürken ya da sihirbazın hiç çalışmadığı bir makineyi teşhis ederken elle ayarlayın: /var/lib/cid/setup/proxy.env dosyasına koyun, yalnızca vekil hizmetini yeniden oluşturun ve değerlerin yerine oturduğunu doğrulayın. Denetim URL'sinin yüzey adını içerdiğine dikkat edin — çıplak bir /inspect/v1 404 döndürür ve vekilin açık biçimde başarısızlık duruşu o zaman denetimi sessizce atlar; bu yoldaki en pahalı hata budur.

Bir denetim kesintisinin Claude Code kesintisine dönüşmesini kabul etmiyorsanız CID_PASSTHROUGH_FAIL_OPEN değerini varsayılanında bırakın.

Filtre profilini ayarlayın

Claude Code bir kodlama yüzeyidir. Sohbete göre ayarlanmış bir zararlı içerik ya da jailbreak modelinin işaretleyeceği metinleri meşru biçimde okur ve yazar; yükü de düz yazı değil kaynak koddur. Profili buna göre, denetim anahtarının çözümlendiği kiracı grubunda yapılandırın:

• Önce günlükleme. Kuralların çoğu yalnızca kaydeder.
• Az sayıda gizli anahtar ve kimlik bilgisi kuralı engeller ya da maskeler.
• Bu grup için zararlı içerik ve jailbreak tespiti kapalı.

Bu, kiracı grubundaki filtre geçersiz kılmaları olarak ifade edilir — tarayıcı ve API yüzeylerinin kullandığı düzeneğin aynısı. Ayrı bir yapılandırma yolu yoktur ve gerekmez.

Pilot için tek bir makineye kurun

Herhangi bir filo çalışmasından önce, tek bir geliştiricinin dizüstü bilgisayarı için:

curl -fsSL https://<appliance-fqdn>/claude/install.sh | CID_HOST=https://<appliance-fqdn> bash

Sonra denetim anahtarını ve cihaz passthrough vekilini çalıştırıyorsa temel URL'yi dışa aktarın:

export CID_INSPECT_KEY=cid_key_0123…
export ANTHROPIC_BASE_URL=https://<appliance-fqdn>  # appliance /v1/ yolunu kendi HTTPS adında sunar

Yeni bir oturum başlatın. İlk oturum, eklenti kancalarla geldiği için tek seferlik bir güvenlik onayı ister; onaylayın.

Doğrulama

1. Yeni bir oturum başlatın ve açılış satırlarını okuyun. CID inspection is active for this Claude Code session (bu Claude Code oturumunda CID denetimi etkin) satırı, kancaların ağ geçidine ulaştığını doğrular; HTTP 401, 403 ya da 404 anan bir satır ise arızayı adlandırır.
2. Yönlendirme açıkken ikinci bir satır Provider traffic is ROUTED through the CID gateway (sağlayıcı trafiği CID ağ geçidi üzerinden yönlendiriliyor) der ve yürürlükteki temel URL'yi yankılar.
3. /cid:status komutunu çalıştırın. İki katmanı ayrı ayrı bildirir — istemlerin ve araç çıktısının denetlenip denetlenmediği ve sağlayıcı trafiğinin yönlendirilip yönlendirilmediği.
4. Test kişisel verisi içeren bir istem gönderin. Tüm Tespitler ekranını açın, Kaynak alanını Claude Code yapın ve satırı doğrulayın.
5. Claude Code Aktivitesi ekranını açın. Oturumlar geliştirici ve depo başına, yalnızca üstveri olarak görünür — sayfa hiçbir istem ya da dosya içeriği saklamaz. Etkinlik, CLAUDE_CODE_ACTIVITY ve CLAUDE_CODE_USAGE olayları olarak yazılır.
6. Passthrough vekilinin gerçekten denetlediğini doğrulayın: kişisel veri yoğun bir istem, aynı boyuttaki temiz bir istemden ölçülebilir biçimde daha pahalıya mal olmalıdır. Denetim açılmadan önce fark birkaç milisaniyedir; sonrasında onlarca milisaniyedir.

Başarısız olursa

• Kurulum programı, ana bilgisayarın ayarlanmadığını söyleyerek duruyor — betiği tam olarak yukarıda yazıldığı gibi ana bilgisayar önekiyle çalıştırın.
• Oturum, ağ geçidinin denetim anahtarını reddettiğini bildiriyor — anahtar yanlıştır, süresi dolmuştur ya da teslim edilmemiştir. Panelde denetleyin ve yeni bir oturum başlatın; anahtar oturum başlangıcında okunur.
• Oturum, denetim uç noktasından 404 bildiriyor — ağ geçidi URL'si, hiçbir denetim uç noktası sunmayan bir ana bilgisayarı gösteriyordur. Bu genellikle yalnızca kendi sağlık denetimini yanıtlayan bir ön vekildir. Bu durumda hiçbir şey denetlenmiyordur.
• Yönlendirme satırı yok — temel URL, Claude Code'u başlatan kabukta dışa aktarılmamıştır. Denetleyin, sonra aracı aynı kabuktan başlatın.
• İstekler bir model hatasıyla başarısız oluyor — vekil passthrough kipinde değildir. Sağlık uç noktası kipi bildirir; çeviri kipindeki bir vekil araç çağrılarını düşürür ve Claude Code'u bozar.
• Eklenti komut satırı aracında hiç görünmüyor — pazar kaydedilmemiştir. İstemcinin hiç duymadığı bir pazarı anan bir etkin eklenti girdisi hiçbir şey kurmaz ve olağan neden budur.
• Yönetilen ayarlar yok sayılıyor gibi görünüyor — iki kanaldan birden teslim ediyorsunuzdur ya da varsayılan olmayan bir temel URL ayarlıyken konsol kanalındasınızdır. İkisi de konsol kanalının sessizce atlanmasına yol açar.

Bilinen eksikler

• Zorlama kancaları POSIX kabuğudur. macOS, Linux ve Linux için Windows Alt Sisteminde tam kapsam. Yerel Windows zorlaması sonraki bir iştir; oturum başlangıcındaki duruş bildirimi ise platformdan bağımsızdır.

• Bir istem eklenti tarafından maskelenemez. Kanca protokolü bir reddetmeye izin verir, yeniden yazmaya değil. Maskeleme, temel URL yolunu gerektirir.

• Eklenti pazarı düz statik HTTP üzerinden sunulamaz. Claude Code sığ klonlar yapar ve statik dosya sunumu bir sığ klonu yanıtlayamaz. Cihazın sunduğu bir pazar, gerçek bir git HTTP işleyicisi gerektirir; çıplak bir JSON dosyası olarak yayımlanan bir pazar kaydolur ama kurulum yapamaz.

• Eklentinin kendi kalp atışının bir alıcısı yoktur. Her oturum başlangıcı; aracı, sürümü, kullanıcıyı, ana bilgisayarı ve oturumun yönlendirilip yönlendirilmediğini taşıyan, sessizce başarısız olan küçük bir kalp atışı gönderir. Bunu toplayacak ağ geçidi uç noktası yapılmamıştır; bu yüzden gönderim 404 alır ve düşürülür. Bugün geliştirici bazlı görünürlük, kancaların yaptığı denetim çağrılarından gelir.

• Kalan atlatma yolları. Aşağıdakilerin sonuncusu dışında her biri, üretilen JSON'daki bir ayarla kapatılır:

  Atlatma	Neyle kapatılır
  Komut satırından farklı bir eklentiyi yandan yükleme	Yandan yükleme bayrağı kısıtlaması
  Kullanıcının kendi ayarlar dosyasını düzenlemesi	Hiçbir şey gerekmez — yönetilen ayarlar, kullanıcı ve proje ayarlarının mutlak biçimde üstündedir
  Farklı bir sağlayıcı temel URL'si dışa aktarma	Yalnızca dosya teslimi; konsol kanalı atlanır
  İzin istemlerini atlama	İzin atlama kısıtlaması
  Değiştirilmiş bir yapı ya da aracı başka bir yolla kurma	İstemci tarafında hiçbir şey. Bu, cihaz yönetimi ve dış erişim denetimi gerektirir

Sonraki adımlar

• Claude Code Aktivitesi — panel sayfası: kimin hangi depoda çalıştığı ve hangi filtrelerin tetiklendiği.
• API anahtarları — bu sayfanın dayandığı denetim anahtarının düzenlenmesi ve iptali.
• Uç nokta ajanı — Claude Code dışındaki kodlama araçları için, aracın içinde değil ağ katmanında kapsam.