.NET Geliştiricileri için Claude Code: Pratik Ajan İş Akışı

Claude Code, depoyu okuyan, değişiklik planlayan, dosya düzenleyen ve kod geçene kadar dotnet build ile dotnet test çalıştıran bir ajan. Mehdi Mohseni'nin rehberi, bir .NET ekibinin bunu CLAUDE.md, PostToolUse derleme hook'u, plan modu ve izin kurallarıyla nasıl kuracağını gösteriyor. Ajanın kendi çıktısını doğrulamasını istiyorsanız okumaya değer.

Kilit noktalar

• CLAUDE.md dosyasını 200 satırın altında tutun; ortak kuralları AGENTS.md'ye koyup @AGENTS.md ile içe aktarın.
• Edit|Write için bir PostToolUse hook'u kurun; dotnet build çalıştırıp hata varsa çıkış kodu 2 ile hataları Claude'a geri gönderin.
• Plan modunu (--permission-mode plan ya da /plan) kullanarak önemli değişikliklere planla başlayın ve düzenlemeden önce adımları onaylayın.
• Büyük, çok dosyalı değişiklikleri --worktree ile ayrı bir git worktree'de yapın; inceleme bitene kadar ana çalışma alanı değişmez.
• Kesin kuralları deny izin kuralları veya PreToolUse hook'ları ile uygulayın; PostToolUse işlemden sonra çalıştığı için engelleyemez.
• Claude'un .env ve appsettings.*.json dosyalarını okumasını Read deny kurallarıyla engelleyin.

Claude Code, Anthropic'in terminal tabanlı ajanı, yalnızca kod önermekle kalmaz: depoyu okur, değişikliği planlar, dosyaları düzenler, dotnet build ve dotnet test çalıştırır ve hataları kendisi giderir. Mehdi Mohseni'nin yazısı, .NET ekipleri için hazırlanan ajanik mühendislik serisinin ilk bölümü ve bu döngünün nasıl kurulacağını anlatıyor. Ortak AGENTS.md dosyasını içe aktaran bir CLAUDE.md, her düzenlemeden sonra derleme yapan bir PostToolUse hook'u ve büyük değişiklikler için plan odaklı bir iş akışı ele alınıyor.

Yazının asıl mesajı koruma önlemleri. Plan modu, dosyalar değişmeden önce adımların gözden geçirilmesini sağlar; git worktree'leri ise büyük yeniden adlandırmaları ana çalışma alanından ayırır. PostToolUse hook'ları bir işlemden sonra çalıştığı için engelleme yapamaz; kesin kurallar bu nedenle deny izin kurallarına ya da PreToolUse hook'larına konmalı. Ayrıca .env gibi gizli dosyaların ajan tarafından okunmasının nasıl önleneceği anlatılıyor. Tam betikler ve ayarlar için orijinal yazıya bakmak gerekir.

Gerçek dünyada kullanımı

• Clean Architecture kullanan bir ASP.NET Core servisinde katman kurallarına uyan ve her düzenlemeden sonra derleme yapan bir ajan.
• Mevcut minimal API'ye doğrulama ve WebApplicationFactory tabanlı entegrasyon testleriyle yeni bir endpoint eklemek.
• Bir domain entity'sinin tüm çözüm genelinde yeniden adlandırılması; değişiklik inceleme için ayrı bir worktree'de tutulur.

Neden önemli

CLAUDE.md, derleme hook'u ve plan öncelikli alışkanlıklar, Claude Code'u yalnızca kod yazan bir araçtan kendi çıktısını doğrulayan bir araca dönüştürür; derleme ve test hataları oturum içinde yakalanır.

Benzer haberler

• Claude Code ile ASP.NET Core endpoint incelemesi için yeniden kullanılabilir skillDLNick Cosentino (Dev Leader)3 gün önce
• React, .NET 10 ve Microsoft Foundry ile güvenli bir kurumsal chatDVDEV Community: #dotnet23 sa önce
• Ollama ve Qdrant ile C# tarafında yerel RAG'den AI Agent'a – Bölüm 3OBOttorino Bruni1 gün önce