Claude Code'u yönetin
Geliştiricilerinizin Claude Code'unu cihaza bağlayın, onu yönetecek filtre profilini seçin ve eklentinin bildirdiği etkinliği okuyun.
- Sürüm: 0.4
- Rol: admin_user
- Tür: görev
Claude Code, bir geliştiricinin makinesinde kaynak kodu okuyup yazan bir kodlama asistanıdır. CID eklentisi her istemi ve her araç sonucunu ürünün geri kalanıyla aynı tespit hattından geçirir ve ne olduğunu bildirir. Tespit ve Filtreleme → Claude Code, bunu okuduğunuz yerdir: kim hangi depoda, ne zaman çalıştı ve hangi filtreler tetiklendi.
Neye ihtiyacım var?
- Lisans
- Any
- Rol
admin_user
Ön koşullar
- Geliştiricilerde Claude Code komut satırı aracı zaten kurulu.
- Eklentinin kimlik doğrulaması için bir ağ geçidi API anahtarı var. Erişim anahtarları sayfasından bir tane verin ya da kurulum sihirbazının üretmesine izin verin.
- Geliştirici makineleri cihaza HTTPS üzerinden erişebiliyor.
- Eklentinin anahtarının çözümlendiği bir kiracı grubu var; böylece o grubun filtre geçersiz kılmaları bu çağrıları yönetir.
Note
Bu sayfa salt okunurdur. Yaptığı her istek bir okumadır ve üzerindeki hiçbir şey politikayı değiştirmez. Sayfanın kendi açıklaması ne sakladığını söyler: Kim hangi depoda, ne zaman çalıştı ve hangi filtreler tetiklendi — CID eklentisinden. Yalnızca üstveri; istem veya dosya içeriği saklanmaz.
/assets/screenshots/claude-code@0.4.pngClaude Code CID222'ye nasıl ulaşır
Birbirinden bağımsız iki katman vardır ve yalnızca ilki varsayılan olarak açıktır.
Denetim, eklenti kurulduğu anda her zaman açıktır. Claude Code kancaları her istemi ve Read,
Grep ile Bash araç çağrılarının çıktısını claude-code sunucu adı altında cihazın /inspect/v1
uç noktasına gönderir; bunlar koruma bantlarından ve kiracı grubunun filtre geçersiz
kılmalarından geçirilir ve bu sayfanın gösterdiği telemetri kaydedilir. Sağlayıcı trafiğine
dokunulmaz.
Yönlendirme isteğe bağlıdır. Claude Code'un Anthropic temel URL'sini cihazın geçirgen vekil sunucusuna yöneltmek, ağ geçidini istek yoluna koyar; böylece bir istek modele ulaşmadan önce denetleyebilir, maskeleyebilir ya da engelleyebilir.
Warning
Önce denetimi dağıtın ve yönlendirmeye dokunmayın. Eklentinin kendi README dosyası, saydam geçirgenlik gönderilene kadar Anthropic temel URL'sinin ayarlanmamış bırakılmasını söyler; çünkü bugünkü çeviri yolu araç çağrılarını ve beta başlıklarını düşürür. Doğru geçici dağıtım yalnızca görünürlüktür.
Tek bir geliştiricinin Claude Code'unu bağlayın
Eklentiyi kurun
Geliştiriciden, bu cihazın adını vererek kurulum betiğini çalıştırmasını isteyin:
Kurulum betiği kullanıcının ev dizinine cid222 pazar yerini ekler ve cid eklentisini
Claude Code'a kurar. Done. Start a new 'claude' session and run /cid:status to verify.
ile biter. Betiği yeniden çalıştırmak aynı zamanda güncelleme yoludur.
Makineye bir denetim anahtarı verin
Geliştiriciden anahtarı dışa aktarmasını ya da eklentinin okuduğu anahtar dosyasına koymasını isteyin:
Ağ geçidi adresi eklenti yapısına gömülüdür; anahtar bilinçli olarak gömülmez. Yeni bir uçbirim
açıldığında da geçerli olsunlar diye dışa aktarmaları kabuk profiline ekleyin. Eklenti, cihaz
yönetim aracınızla bir dosya yerleştirmeyi tercih ederseniz ~/.cid/inspect-key dosyasından da
anahtar okur.
Bir oturum başlatın ve başlığı okuyun
Geliştiriciden yeni bir claude oturumu başlatmasını ve tek seferlik kanca istemini
onaylamasını isteyin.
Oturum, bu oturum için denetimin etkin olduğunu ve istemlerle araç çıktısının kurumun AI kullanım politikasına karşı denetlendiğini doğrulayan bir CID satırıyla açılır.
Geliştirici tarafından doğrulayın
/cid:status komutunu çalıştırmasını isteyin.
Komut iki katmanı da bildirir: kancalar üzerinden denetim ve sağlayıcı trafiğinin ağ geçidinden yönlendirilip yönlendirilmediği.
Danger
Anahtar olmadan kancalar sessizce açık kalarak başarısız olur. Eklenti hiçbir yetkilendirme başlığı göndermez, ağ geçidi çağrıyı kenarda reddeder ve hiçbir şey denetlenmez — geliştiricinin fark edeceği bir hata da olmaz. Yanlış bir ağ geçidi adresi de aynı biçimde davranır; tek farkı oturum başlığının bir 404 bildirmesi ve geliştiriciye BT ile iletişime geçmesini söylemesidir.
Bir ekibe yayın
Paketi üretin
Kurulum sihirbazının Connect Claude Code adımını açın, Proxy hostname (base URL) ve API hostname (gateway) alanlarını doldurun, sonra Generate managed settings seçin.
Cihaz claude-code-managed adlı bir anahtar üretir, yoksa Claude Code adlı bir kiracı
grubu oluşturur ve yönetilen ayarlar JSON dosyasını hazırlar. Sunucu adı alanlarını boş
bırakmak YOUR-DOMAIN yer tutucularıyla dolu bir dosya üretir ve sihirbaz onu
yapıştırmadan önce sizi uyarır.
Dosyayı kopyalayın
Managed settings (paste this) altındaki Copy seçeneğini seçin.
Dosya cid222 pazar yerini sabitler, cid eklentisini etkinleştirir, yandan yüklemeyi ve
yönetilmeyen kancaları yasaklar ve denetim anahtarını taşır.
Tek bir dağıtım kanalı seçin
Dosyayı Claude kurumunuzun yönetilen ayarlar sayfasına yapıştırın. Oraya yalnızca bir Owner ya da Primary Owner erişebilir — sıradan bir yönetici erişemez. İstemciler dosyayı bir sonraki açılışta ve düzenli yoklamalarında alır.
İkisini birden değil, tek bir kanal kullanın. Birleşmezler: biri doluysa diğeri yok sayılır.
Warning
Bir geliştiricinin ortamı varsayılan olmayan bir Anthropic temel URL'si ayarlıyorsa Claude Code konsol getirmesini tümüyle atlar ve konsol kanalı sessizce hiçbir şey teslim etmez. Yönlendirmeyi ve ayarları birlikte cihaz yönetimi dosyasıyla dağıtın ya da temel URL'yi JSON dışında tutup geliştiricilerin kendilerinin dışa aktarmasını sağlayın.
Sihirbazın paketi bir Anthropic temel URL'si ayarlar; cihazın dağıtım dosyalarıyla gelen şablon ise bunu bilinçli olarak yapmaz. Dosyayı bir ekibe vermeden önce ikisinden hangisini dağıttığınıza karar verin.
Filtre profilini belirleyin
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 ve yükü düzyazı değil kaynak koddur. Bu nedenle önerilen profil önce günlükleme temellidir ve tümüyle bir kiracı grubu üzerindeki filtre geçersiz kılmalarıyla ifade edilir — ayrı bir Claude Code politika ekranı yoktur.
Geliştiricileri gruplayın
Bir kiracı grubu oluşturun — kurulum sihirbazının kullandığı ad Claude Code'dur — ve geliştirici hesaplarını ekleyin.
Yönetilen ayarlardaki denetim anahtarının bu gruba çözümlenmesi gerekir; yoksa grubun geçersiz kılmaları eklentinin çağrılarını yönetmez.
O grup için filtreleri geçersiz kılın
Grubun geçersiz kılmalarını Güvenlik Filtreleri sayfasından ayarlayın.
Önerilen başlangıç noktası:
- Zararlı içerik — kapalı. Kodlama metni, sohbete göre ayarlanmış zararlı içerik tespitini sürekli tetikler.
- Jailbreak ve enjeksiyon — kapalı. Aynı neden; ayrıca bir tespit servisi kullanılamazken zararsız bir istemin engellenmesini önler.
- Kişisel veriler (e-posta, ad, telefon, kimlik numarası) — işaretle. İşi kesmeden görünürlük.
- Genel gizli anahtarlar ve parolalar — işaretle ya da araç çıktısından çıkarmak için maskele.
- Canlı API anahtarları ve özel anahtarlar gibi kritik gizli bilgiler — reddet.
Uygulanan profilin doğru profil olduğunu doğrulayın
Bir günlük kullanımdan sonra bu sayfanın Politika sekmesini izleyin.
Sekme, gerçekte tetiklenen filtreleri sıralar. Kapalı olmasını beklediğiniz bir kuralın üst sıralarda görünmesi, anahtarın yanlış gruba çözümlendiği anlamına gelir.
Danger
Claude Code'u asla varsayılan filtre kümesiyle çalıştırmayın. Varsayılan kiracının filtreleri ve kullanılamayan bir tespit servisiyle, kapalı kalarak başarısızlık davranışı zararsız istemleri engeller ve geliştiriciler bunu asistanın bozulması olarak yaşar.
Eylemleri seçmeden önce bilinmesi gereken iki davranış vardır:
- Bir reddet kuralı istemi engeller ve geliştiriciye hangi kategorilerin eşleştiği söylenir.
- Bir maskele kuralı bir istemi yerinde maskeleyemez — kanca protokolü buna izin vermez.
Gönderilen eklenti istemi kaydeder, geliştiriciyi uyarır ve istemi değiştirmeden geçirir. Aynı
oturumdaki araç çıktısı düzgün biçimde maskelenir. Bu istemleri geçirmek yerine reddetmeyi
tercih ederseniz eklentinin istem maskeleme eylemini
blockyapın.
Sayfayı okuyun
Araç çubuğu altındaki her şeyi süzer: Son 24 saat, Son 7 gün (varsayılan), Son 30 gün ya da Son 90 gün aralığı; ayrıca Geliştirici e-postası, Depo (tam git adresi) ve Dal için birebir eşleşme kutuları. Bunlar arama değil, birebir eşleşmedir — içerik hiçbir zaman saklanmadığı için burada içerik araması yoktur. Dışa aktar, geçerli sekme ya da adlandırılmış herhangi bir görünüm için CSV, Excel (.xlsx), PDF ve HTML sunar.
Sekmeler
| Sekme | Yanıtladığı |
|---|---|
| Genel bakış | Önceki döneme karşı altı sayaç, zamana göre etkinlik, politika sonuçları dağılımı, çalışma saatleri ve en çok çalışan geliştiriciler ile depolar |
| Geliştiriciler | Koltuk başına: oturum, istem, araç kullanımı, depo, token, politika isabeti, son görülme |
| Depolar | Depo başına: geliştirici, oturum, istem, araç kullanımı, dal, politika isabeti, son etkinlik |
| Politika | Hangi filtrenin ne sıklıkta tetiklendiği, engellenen/maskelenen/işaretlenen dağılımı ve kaç geliştirici ile depoya dokunduğu |
| Oturumlar | Oturum başına bir satır: geliştirici, depo, dal, başlangıç, süre, istem, token, ne üzerine çalışıldığı |
Bir geliştirici, depo ya da oturum satırı seçmek, her şeyi o varlığa daraltarak yeniden sorgulayan bir çekmece açar; böylece sayılar tablolarla her zaman uyuşur.
Sayaçlar
| Kart | Saydığı |
|---|---|
| Geliştirici | Rapor veren farklı Claude Code koltukları |
| Oturum | Farklı oturumlar. 0.5.1 öncesi eklenti sürümleri oturum kimliği göndermediğinden listelenmez |
| İstem | Gönderilen istemler; araç çıktısı ayrı sayılır |
| Araç kullanımı | Denetlenen Read, Grep ve Bash çıktıları |
| Depo | Çalışılan farklı git adresleri |
| Politika isabeti | Engellenen artı maskelenen artı işaretlenen |
İlişkilendirme
Bir koltuk, koltuğun e-postası bir kiracının iletişim e-postasıyla eşleştirilerek bir CID222
hesabına ilişkilendirilir. Eşleşmeyen koltuklar eşleşmemiş olarak gösterilir ve şu açıklamayı
taşır: Bu koltuk e-postasını taşıyan bir tenant yok, bu yüzden aktivite bir CID kullanıcısına
atfedilemiyor. Bağlamak için tenant'ın contact_email alanını ayarlayın. İlişkilendirme her olay
yazılırken damgalanır; bu yüzden bugün bir kiracıyı bağlamak dünkü olayları geriye dönük olarak
ilişkilendirmez — kısmen bağlanmış bir koltukta {n}/{m} atfedildi yazar.
İsteğe bağlı: sağlayıcı trafiğini cihaz üzerinden yönlendirin
Yönlendirme, ağ geçidini istek yoluna koyar; böylece Anthropic görmeden önce bir istemi
maskeleyebilir ya da engelleyebilir. Varsayılan olarak kapalıdır: vekilin denetim URL'si
ayarlanmamıştır ve geçirgen maskeleme false'tur, yani vekil denetlemeden iletir.
Warning
Bu, bir üretim dağıtımında çalıştırılmamış, belgelenmiş bir yordamdır. Etkinleştirmek
CID_INSPECT_URL değerini tam denetim yoluna (çıplak bir önek 404 döndürür ve vekil o zaman
sessizce açık kalarak başarısız olur), CID_PASSTHROUGH_MASK değerini true yapar ve istek
başına 50–115 ms maliyeti vardır. Maskelenen bir tur istek gövdesini yeniden yazar ve o tur için
istem önbelleğini kaybeder. Yalnızca son kullanıcı turunun metni yeniden yazılır.
Yönlendirme açıkken engellenen bir istem, Blocked by your organization's CID222 AI-usage policy. Detected: … Remove the sensitive content and try again. yazan bir HTTP 400 döndürür — 403 değil 400, bilinçli olarak; çünkü Claude Code bir yetkilendirme durumunu kimlik bilgisi arızası olarak okur ve geliştiriciyi var olmayan bir oturum açma sorununun peşine gönderir.
Doğrulama
- Bir geliştirici oturum başlattıktan sonra Geliştiriciler sekmesi onun koltuğunu listeler ve Oturum en az 1'dir.
- Profilinizin işaretlediği bir test değeri içeren bir istem göndermesini isteyin. Yenileme içinde Politika sekmesi kuralı sıfırdan büyük bir isabet sayısıyla gösterir.
- Olay Günlükleri'ni açın ve geliştiriciye göre filtreleyin. Temiz etkinlik
CLAUDE_CODE_ACTIVITY, token sayılarıCLAUDE_CODE_USAGE, bir politika kararı iseMESSAGE_BLOCKEDya daMESSAGE_MASKEDolarak yazılır — sonuçlar Claude Code'a özgü türlerle değil, ürünün genel güvenlik olay türleriyle kaydedilir. - Aynı olaylar Tüm Tespitler sayfasında kaynağı Claude Code olarak görünür.
- Yönlendirmeyi etkinleştirdiyseniz vekil ana makinesindeki
/health, Anthropic kipini geçirgen olarak bildirir.
Başarısız olursa
- Aktivite yüklenemedi. Eklenti telemetri uç noktasına henüz erişilemiyor olabilir. — sayfa etkinlik uç noktasını okuyamadı. Bu ileti, hiçbir eklenti henüz rapor vermemişken de gerçek bir arızada da görünür; yeniden deneme düğmesi yoktur.
- Henüz Claude Code aktivitesi yok ve Bu aralıkta rapor veren bir ajan yok. — hiçbir şey rapor vermemiş. Eklenti kurulduğundan beri bir geliştiricinin gerçekten oturum başlatıp başlatmadığını denetleyin ve aralığı genişletin.
- Bir koltuk eşleşmemiş görünüyor — o kiracının iletişim e-postasını koltuğun e-postasına ayarlayın. Var olan olaylar ilişkilendirilmemiş kalır; yalnızca sonraki etkinlik bağlanır.
- Geliştiricinin oturum başlığı, ağ geçidinin denetim anahtarını reddettiğini söylüyor — anahtar yanlış, iptal edilmiş ya da yok. Erişim anahtarları sayfasından yeni bir tane verip dağıtın.
- Geliştiricinin oturum başlığı denetim uç noktasından 404 bildiriyor — ağ geçidi adresi yanlış, yani hiçbir şey denetlenmiyor ve kancalar açık kalarak başarısız oluyor. Eklentinin ağ geçidi ayarını düzeltin.
- CID_HOST is not set. Run: CID_HOST=https://cid.company.local bash install.sh — kurulum betiği ana makine öneki olmadan bir kabuğa aktarılmış.
- claude CLI not found — install Claude Code first. / unzip not found — install it first. — geliştiricinin makinesinde ön koşullar eksik.
- Kurulum sihirbazında could not create the Claude Code group — kiracı grubu oluşturulamadı. Kiracı Grupları sayfasından elle oluşturup yeniden deneyin.
- Bir PDF dışa aktarımı iniyor ama açılmıyor — oluşturucu kullanılamıyordu ve cihaz, tarayıcının
.pdfdosyası olarak kaydettiği açıklayıcı bir yanıt döndürdü. Bunun yerine CSV, XLSX ya da HTML olarak dışa aktarın.
Bilinen boşluklar
- Kurulum URL'si kesinleşmedi. Eklenti dağıtım dosyaları panonun web sunucusu tarafından sunulur, yani kurulum betiği pano kaynağında durur; oysa bir depo belgesi API kaynağını iddia eder. URL'yi geliştiricilere duyurmadan önce bir kez getirip doğrulayın.
- Kod güvenliği kapısı yalnızca eklenti tarafındadır. Eklentinin araç öncesi kapısı, oturum denetimi ve depo temel taraması bu yapının sunmadığı uç noktaları bekler; bu yüzden o kancalar açık kalarak boş işleme dönüşür. Bunlara dair hiçbir şey bu sayfada görünmez.
- Sayılar sekmeler arasında biraz farklı olabilir. Genel bakış bir isabeti yalnızca bir tespit sayısı varsa işaretlenmiş sayar; Politika sekmesi ise gerekçe taşıyan, engellenmemiş ve maskelenmemiş her satırı sayar.
- Sayfanın bazı bölümleri sabit kodlanmış İngilizcedir; grafik alt başlıkları, ısı haritasındaki gün adları, dışa aktarma biçim adları ve kurulum sihirbazı adımının tamamı dahil.
- 0.5.1 öncesi eklenti oturumları eksiktir; çünkü o sürümler oturum kimliği göndermiyordu. Sayfa bunu tablonun üstünde belirtir.
Sonraki adımlar
- Güvenlik Filtreleri — Claude Code profilini oluşturan grup geçersiz kılmalarının ayarlandığı yer.
- Tüm Tespitler — Claude Code kararları, diğer her yüzeyle yan yana.
- Depo Takibi — diğer kod güvenliği yüzeyi: bir geliştiricinin yazdığını değil, depoların kendisini tarama.
- Erişim anahtarları — eklentinin kimlik doğruladığı anahtarı verin ve döndürün.
Son güncelleme