Anla Dene

Claude · Gelişmiş · 203 Ölçekle ve otomatikleştir · Konu 2 / 7

4.6 Doğrulama ve güven

Claude "bitti" dediğinde değil, kontroller çalışıp sonucu gösterdiğinde bitmiştir.

Bu sayfada ne öğreneceksin

Kısaca

Doküman Claude'un işleyişini şöyle anlatıyor: Claude, iş bitmiş göründüğünde durur. Çalıştırabileceği bir kontrol yoksa elindeki tek sinyal "bitmiş gibi görünüyor"dur ve doğrulama döngüsü sen olursun: her hata, sen fark edene kadar bekler. Claude'a pass ya da fail üreten bir kontrol verirsen döngü kendiliğinden kapanır: işi yapar, kontrolü çalıştırır, sonucu okur, kontrol geçene kadar yineler. Dokümanın cümlesiyle bu, izlediğin bir oturumla yanından ayrılabildiğin bir oturum arasındaki farktır.

Kontrol; bir test paketi, bir derleme çıkış kodu, bir linter, çıktıyı bir referansla karşılaştıran bir betik ya da bir tasarımla kıyaslanan ekran görüntüsü olabilir. Önemli olan Claude'un konuşmada okuyabileceği bir sinyal üretmesidir.

Bu sayfa iki sorunun cevabıdır. Birincisi, kontrolü her seferinde sen hatırlamak zorunda kalmasan nasıl çalışır? İkincisi, Claude'u izlemediğin bir koşunun sonucuna ne kadar güvenebilirsin? Skill'leri 4.1, hook'ları 4.4 sayfasında öğrendin; burada ikisini doğrulama için birleştiriyoruz.

Neden önce doğrulama skill'i?

Normalde Claude'un işini nasıl kontrol edersin? Bir yeniden düzenleme istersin, Claude bitirir, sonra çift kontrol etmeyi hatırlaman gerekir. Belki testleri çalıştırmasını istersin, belki diff'i kendin okursun. Kursa göre sorun, kontrolün senin hatırlamana bağlı olmasıdır: bir kez atlarsan kötü kod sızar.

Doğrulama skill'i bu bağımlılığı kaldırır. Değişiklik skill'in açıklamasına uyduğunda skill kendiliğinden devreye girer ve her seferinde aynı adımları yürütür:

Son adım kritik. Testlerin yeşil çıkması yetmez: bir test sessizce gevşetilmiş olabilir ve ne olursa olsun geçer. Kursa göre "bitti", diff'e bakınca kodun doğru görünmesi değildir; kapıların çalıştırılıp gözlenmesi ve sonuçlarının açıkça söylenmesidir. Kurs, aynı kalıbın ekibinin tekrarladığı her yordama uyduğunu söylüyor: sürüm kontrol listesi, geçiş (migration) tarifi, PR öncesi kontrol. Pratik kural: aynı çok adımlı talimatı iki kez yazdıysan o bir skill'dir.

Skill klasörü talimattan fazlasını taşıyabilir

Skill yalnız tek bir SKILL.md dosyası değildir. Doküman, çevresindeki klasöre ayrıntılı başvuru dosyaları ve betikler koymanı gösteriyor: reference.md gibi bir dosyayı SKILL.md'den bağlarsın ve Claude onu yalnız o derinliğe ihtiyaç duyduğunda okur. Betikler ise içeriği bağlama yüklenmeden çalıştırılır. Kurs bunu "skill kendi aracını taşıyabilir, örneğin tüm kapıları çalıştıran bir check.sh" diye anlatıyor. Doküman SKILL.md'yi kısa tutmanı öneriyor; uzun açıklama ve çalıştırılabilir betikler yan dosyalara gider.

Aşağıda kurgusal bir proje için örnek bir klasör düzeni görüyorsun. Dosya yolları ve komutlar örnektir; kendi projenin komutlarına uyarla.

.claude/skills/dogrula/
├── SKILL.md
└── scripts/
    └── check.sh

SKILL.md dosyasının içeriği (kurgusal örnek; proje skill'i olduğu için .claude/skills altında git'e eklenebilir, böylece ekip aynı kontrolü devralır):

---
name: dogrula
description: Bir kod değişikliği bittiğinde çalıştır. Testleri koşar, diff'i okur, hiçbir testin geçsin diye zayıflatılmadığını kontrol eder ve geçti ya da kaldı sonucunu kanıtıyla raporlar.
---

Değişiklik bittiğinde şu adımları sırayla yap:

1. `bash .claude/skills/dogrula/scripts/check.sh` komutunu çalıştır.
2. `git diff` çıktısını oku. Planında olmayan bir dosyaya dokunulmuş mu bak.
3. Hiçbir test, geçsin diye silinmemiş, atlanmamış ya da gevşetilmemiş olmalı. Gevşetilmiş bir test varsa nedenini yaz.
4. Sonucu GEÇTİ ya da KALDI diye yaz. Çalıştırdığın komutları ve çıktılarını kanıt olarak ekle. Çalıştırmadığın bir kontrolü geçti sayma.

Betik (kurgusal; komutlar projene göre değişir):

#!/bin/bash
# check.sh: kapıları sırayla çalıştırır, biri kalırsa durur
set -e
npm test
npm run lint
npm run typecheck

Dokümana göre skill'i otomatik tetikleyen şey description alanıdır; bu yüzden açıklamayı "ne zaman çalışacağını" söyleyecek şekilde yaz. Ayrıca doküman, oturum başında verify ya da simplify adlı bir skill varsa Claude'un commit öncesi onu çalıştırmasının söylendiğini, ancak bunun konum ve çağrı koşullarına bağlı olduğunu ve belirli bir Claude Code sürümü gerektiğini yazıyor. Ayrıntı için skills dokümanındaki "Run your checks before each commit" bölümüne bak.

Dokümanda ayrıca yerleşik bir /verify skill'i var: uygulamayı derleyip çalıştırarak bir değişikliğin yapması gerekeni yaptığını, test ya da tip denetimine dönmeden doğrular. Doküman bunu Claude'un kontrolü geçtikten sonra senin çalıştırman gereken bir adım olarak öneriyor.

Hangi kural nerede durur?

Talimat yazabileceğin üç yer var ve karıştırmak kolay. Kursun ayrımı şöyle:

Kural türüNereyeNeden
Her zaman geçerli kurallar (adlandırma, dosyaların yeri)CLAUDE.mdHer oturumda yüklenen proje bilgisi
Belirli bir iş türüne bağlı yordam ve başvuruSkillYalnız açıklaması yüklenir, gerekince tamamı
Claude'un atlayamaması gereken kuralHookCLAUDE.md ve skill, Claude'un uyduğu talimattır; hook ise gerçekten çalışan koddur

Kurs net: bir kuralın atlanması kabul edilemezse onu talimat uymasına bırakma. Doküman da aynı yöne işaret ediyor: CLAUDE.md'nin gereksiz uzamasının hatasını anlatırken, Claude'un zaten doğru yaptığı şeyi sil ya da hook'a çevir diyor.

Testi bir kapıya çevir: hook ile

Gözetimsiz bir koşunun gerçek kapısı, testlerin geçip geçmediği ve Claude'un onları gerçekten çalıştırıp çalıştırmadığıdır. Kurs bunu güvene bırakma diyor ve hook'a bağlamanı öneriyor. İki hook işi görür:

Anahtar ayrıntı çıkış kodudur. Dokümana göre çıkış kodu 2, "dur, bunu yapma" demenin yoludur ve etkisi olaya göre değişir. Stop için çıkış kodu 2, Claude'un durmasını engeller ve konuşmayı sürdürür; PostToolUse için araç zaten çalışmıştır, stderr çıktısı Claude'a gösterilir. Kursa göre hata Claude'a geri akar, Claude onu okur ve sen istemeden düzeltir. En iyi yanı, kontrolün sen istemeyi unutsan da her koşuda tetiklenmesidir.

Aşağıdaki iki dosya kurgusal bir örnektir. Ayar dosyası .claude/settings.json; Stop olayı eşleştirici (matcher) desteklemez, her zaman tetiklenir:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/run-tests.sh"
          }
        ]
      }
    ]
  }
}

Betik .claude/hooks/run-tests.sh (kurgusal; çalıştırılabilir yap: chmod +x .claude/hooks/run-tests.sh):

#!/bin/bash
# run-tests.sh
INPUT=$(cat)
if [ "$(echo "$INPUT" | jq -r '.stop_hook_active')" = "true" ]; then
  exit 0  # Claude'un durmasına izin ver
fi
if ! npm test >&2; then
  echo "Testler geçmedi. Hatayı düzelt ve testleri yeniden çalıştır." >&2
  exit 2
fi
exit 0

stop_hook_active denetimi, dokümanın döngüyü kırmak için gösterdiği desendir: betik, kendi tetiklediği bir devamı fark edip çıkabilmeli. Doküman ayrıca Claude Code'un, araya Claude'dan hiç araç çağrısı girmeden art arda çok kez engelleyen bir Stop hook'unu geçersiz kıldığını ve bu sınırın ortam değişkeniyle ayarlanabildiğini yazıyor. Bu korumanın bir bedeli var: betik ikinci turda testler hâlâ kalsa bile durmaya izin verir. O yüzden son raporu yine kendin oku.

Ne kadar izlemediysen o kadar doğrula

Kursun ana fikri: doğrulamayı koşunun ne kadar gözetimsiz olduğuna oranla yap. Kısa bir oturumda mesajların akışını izlediysen hızlı bir bakış yeter. Gözetimsiz bir koşu ya da CI'da kimsenin izlemediği bir iş ise gerçek bir kontrol ister; kimse ne olduğunu görmediği için sonradan yeniden kurman gerekir. Ne kadar az izledinse o kadar çok doğrula.

KoşuNe yaparsın
Kısa, izlediğin oturumHızlı bakış, gerekirse /diff
Gözetimsiz koşu ya da CI (kimsenin izlemediği iş)Diff'i oku, testi hook kapısı yap, başsız koşuyu JSON sonucu ve çıkış koduyla doğrula, önemli bir iş için soğuk ikinci göz iste

1. Auto modda kal, bypass'a geçme

İş yerinde gözetimsiz bir koşu yapıyorsan kurs bypass permissions yerine auto modu öneriyor. Auto modda sınıflandırıcı her eylemi tehlike açısından incelemeye devam eder ve bu bir güvenlik ağıdır. Ama ağın neyi yapıp neyi yapmadığına dikkat et: sınıflandırıcı kodun doğru olup olmadığına hiç bakmaz, yalnız tehlikeli eylemleri işaretler. Yani doğrulama çıtan aynı yerde kalır; onu koşunun ne kadar gözetimsiz olduğuna göre sen belirlersin. Doküman da auto modun izin istemlerini azalttığını ama güvenliği garanti etmediğini yazıyor (bkz. 3.7).

2. Özetle değil, diff'le başla

Claude'un ne yaptığını anlatan özetten başlama; diff'in kendisinden başla. Değişiklikleri gezmek için /code-review çalıştır, sonra git diff'e kendi gözünle bak. Tuzak şu: derli toplu bir özet gayet iyi okunur, oysa gerçek diff beklemediğin bir dosyaya dokunmuştur. Özet bunu söylemez, diff söyler. Önce planda yer alan dosyaları, sonra planın dışında kalan her şeyi oku. Temiz bir yazı temiz kodun kanıtı değildir.

3. Testi söz değil kapı yap

Yukarıdaki hook bölümü bunun içindir. Kursun cümlesi: asıl kapı testlerin geçip geçmediği ve Claude'un onları gerçekten çalıştırıp yoksa yalnızca çalıştırdığını mı söylediğidir.

4. Soğuk bir ikinci görüş al

Bir PR öncesinde yaptırdığın alt ajan incelemesi burada da işe yarar. Yeni bir oturum ya da alt ajan aç ve değişen kodu, nasıl yazıldığını hiç bilmeden incelet. Dokümana göre taze bağlamda çalışan bir inceleyici yalnız diff'i ve senin verdiğin ölçütleri görür, değişikliği üreten akıl yürütmeyi görmez; bu yüzden sonucu kendi koşullarında değerlendirir. Kursun deyişiyle yazarın akılcılaştırarak geçtiğini taze gözler yakalar.

Dikkat: dokümana göre "açık bul" diye yönlendirilen bir inceleyici, iş sağlam olsa bile genellikle bir şeyler bulur, çünkü ondan istenen budur. Her bulguyu kovalamak gereksiz soyutlama ve fazla savunma kodu üretir. İncelemeciye yalnız doğruluğu ya da yazılı ölçütleri etkileyen boşlukları bildirmesini söyle, gerisini isteğe bağlı say.

5. Başsız (headless) koşuyu JSON ve çıkış koduyla doğrula

Terminalde izlemediğin bir claude -p koşusunun sonucunu çıkış kodundan ve JSON çıktısından oku. Dokümana göre başarıda çıkış kodu sıfırdır, koşu başarısızsa sıfırdan farklı; betiğin buna göre dallanabilir. Yapısal çıktı için --output-format json kullan: yanıt result, oturum kimliği ve üst veriyi taşır. Şema verdiysen çıktı structured_output alanındadır ve doküman, kullanmadan önce bu alanın var olup olmadığını denetlemeni söylüyor. stream-json çıktısında reddedilen çağrılar permission_denied sistem mesajlarıyla görünür ve son sonuç mesajı permission_denials alanında listelenir. Ayrıntısı 4.7 sayfasında. Zamanlanmış bir iş için de aynı uyarı geçerli: dokümana göre çalıştırma listesindeki yeşil durum, istemin anlattığı işin başarılı olduğu anlamına gelmez. Claude'un gerçekte ne yaptığını görmek için çalıştırmayı açıp kaydı oku.

Adım adım

  1. Çalıştırılabilir bir kontrol belirle. Projen için tek komutla çalışan bir kontrol bul (test, derleme, lint, tip denetimi). Beklenen sonuç: komut geçerse sıfır, kalırsa sıfırdan farklı bir çıkış kodu verir.
  2. Doğrulama skill'ini yaz. .claude/skills/dogrula/SKILL.md dosyasını yukarıdaki örneğe göre oluştur ve kontrolü scripts/check.sh içine koy. Beklenen sonuç: Claude bir değişikliği bitirince skill kendiliğinden tetiklenir. Tetiklenmezse açıklamayı "ne zaman" çalışacağını söyleyecek şekilde düzelt.
  3. Skill'i git'e ekle. Proje .claude/skills klasörüne koyduysan commit et. Beklenen sonuç: ekip aynı kontrolü devralır, kimsenin istemeyi hatırlamasına gerek kalmaz.
  4. Atlanamaz olan kuralı hook'a çevir. Testleri bir Stop hook'una bağla (yukarıdaki iki dosya) ve betiği çalıştırılabilir yap. Beklenen sonuç: testler kalırsa Claude turu bitiremez; stderr'deki mesajı okuyup düzeltir.
  5. Hook'un çalıştığını sına. Bilerek bir testi kıracak küçük bir değişiklik iste. Beklenen sonuç: Claude durmaya çalışır, hook onu engeller ve Claude düzeltir. Hiç tetiklenmiyorsa /hooks ile kayıtlı hook'lara bak.
  6. Gözetimsiz koşuyu auto modda tut. Bypass permissions kullanma. Beklenen sonuç: tehlikeli eylemler sınıflandırıcıdan geçer; ama doğruluğu hâlâ sen denetlersin.
  7. Koşu bitince diff'i oku. /code-review çalıştır, sonra git diff aç. Önce planın dosyalarını, sonra planın dışında kalan her şeyi tara. Beklenen sonuç: beklemediğin dosya değişiklikleri gün ışığına çıkar.
  8. Önemli iş için taze bir göz kullan. Yeni bir oturumda ya da alt ajanla değişikliği inceletmek için aşağıdaki hazır prompt'u kullan. Beklenen sonuç: yalnız doğruluğu etkileyen boşluklar raporlanır.

Hazır prompt

Bir işi bitirmeden önce kanıt istemek için:

İşi bitirdiğinde şunu yap: [kontrol komutu, ör. testler ve lint] komutunu çalıştır, komutu ve çıktısını bana göster. Hiçbir testi geçsin diye silme, atlama ya da gevşetme. Gevşettiğin bir şey olursa açıkça yaz. Geçmeyen bir şey varsa "çalışıyor" deme, nedenini yaz.

Bir koşuyu taze bağlamda incelettirmek için (yeni oturumda ya da alt ajanla):

Bir alt ajan kullanarak [değişikliğin adı] diff'ini [PLAN.md ya da yazılı ölçüt] ile karşılaştırarak incele. Her gereksinimin yapılıp yapılmadığını, listelenen uç durumlar için testin olup olmadığını ve görev kapsamı dışında bir şeyin değişip değişmediğini kontrol et. Yalnız doğruluğu ya da yazılı gereksinimleri etkileyen boşlukları raporla, üslup tercihlerini değil.

Doğrulama skill'ini Claude'a yazdırmak için:

Bu proje için bir doğrulama skill'i yaz (.claude/skills/dogrula/). Skill, bir değişiklik bittiğinde [test, lint, tip denetimi] komutlarını bir betikle çalıştırsın, git diff'i okusun, hiçbir testin zayıflatılmadığını kontrol etsin ve sonucu GEÇTİ ya da KALDI olarak, çalıştırdığı komutların çıktısıyla birlikte raporlasın. SKILL.md kısa kalsın, betik scripts/ klasöründe dursun.

Sık yapılan hata

Claude'un doğrulama sonuçları da yanılabilir. "Test geçti" diyorsa komutu ve çıktısını görmeden kabul etme; kanıtı kendin kontrol et.

Video

Video: yakında.

Kaynak

Son doğrulama: 2026-10-21

Anla Dene bağımsız bir eğitim sitesidir; Anthropic, OpenAI ya da Google ile bağlantılı değildir. Ürün adları sahiplerine aittir.

anladene.com · Anla Dene Akademi · Gizlilik