Claude Code’u proje klasöründe güvenli ve kontrollü kullan.
Windows kurulumu, VS Code entegrasyonu, CLAUDE.md talimatları, Git kontrolü, MCP bağlantısı ve iyi görev verme yapısı tek rehberde.
Claude Code nedir?
Claude Code, terminal ve desteklenen editörler üzerinden proje klasörünle çalışan bir kodlama aracıdır. Dosya yapısını okuyabilir, plan hazırlayabilir, kod düzenleyebilir ve çalıştırmasına izin verdiğin komutlarla doğrulama yapabilir.
“Her şeyi düzelt” demek yerine önce analiz, sonra plan, sonra küçük değişiklikler ve son olarak Git diff kontrolü iste.
Kurulumdan önce hazırlık
Başlamadan önce proje klasörünün yedeği veya Git geçmişi olmalı. Visual Studio Code isteğe bağlıdır; native Windows kullanımında Git for Windows önerilir.
git --version code --version
Windows kurulumu
Başlat menüsünde PowerShell ara ve normal kullanıcı olarak aç.
Aşağıdaki resmi kurulum komutlarından birini kullan.
cd komutuyla çalışacağın klasörü aç.
claude komutunu çalıştır ve hesabınla giriş yap.
irm https://claude.ai/install.ps1 | iex
winget install Anthropic.ClaudeCode
cd C:\Projects\promptla claude
Kurulum komutunu her zaman resmi dokümantasyon adresinden doğrula. Başka sitelerden kopyalanmış kurulum betiklerini çalıştırma.
VS Code entegrasyonu
VS Code içinde Extensions bölümünü aç, resmi Claude Code uzantısını bul ve kur. Proje klasörünü açtıktan sonra Claude panelini kullanabilir; seçili kodu bağlama dahil edebilir ve değişiklikleri editör içinde inceleyebilirsin.
Ctrl+Shift+X kısayolunu kullan.
Yayıncı bilgisini ve resmi uzantı olduğunu kontrol et.
Tek dosya yerine repository kök klasörünü aç.
Önce “dosya yapısını analiz et, hiçbir dosyayı değiştirme” komutunu ver.
Bu rehber Visual Studio Code entegrasyonunu anlatır. Visual Studio ayrı bir IDE’dir.
CLAUDE.md proje talimatı
CLAUDE.md, proje boyunca korunmasını istediğin kuralları açık biçimde yazdığın talimat dosyasıdır. Tasarım renkleri, klasör yapısı, test komutları ve değiştirilmemesi gereken alanlar burada belirtilebilir.
# PROMPTLA Proje Kuralları - Mevcut koyu lacivert, turkuaz ve mor renk sistemini koru. - PHP, Firebase veya veritabanı ekleme. - Tüm sayfalar index.html çift tıklanınca çalışabilsin. - Bir dosyayı değiştirmeden önce mevcut davranışı analiz et. - Mobil menüyü ve erişilebilirliği bozma. - Değişiklik sonunda git diff özetini ve test sonuçlarını yaz.
Güvenli geliştirme akışı
git status çalıştır. Önceden kalan değişiklikleri ayır.
Claude’dan dosya yapısını ve ilgili bileşenleri incelemesini iste.
Hangi dosyaların neden değişeceğini gör.
Tek özellik veya tek hata düzeltmesi uygulat.
git diff ve editördeki diff görünümünü oku.
Masaüstü, mobil ve bozuk bağlantı kontrollerini yap.
Yalnızca doğrulanmış değişiklikleri kaydet.
git status git diff git add . git commit -m "AI Studio rehberleri eklendi"
Doğrudan kullanılabilecek görevler
Projeyi değiştirmeden analiz
Bu projeyi değiştirmeden önce ayrıntılı analiz et. 1. Dosya yapısını çıkar. 2. Tasarım değişkenlerini ve ortak bileşenleri bul. 3. Mobil navigasyon davranışını açıkla. 4. İstenen değişiklik için riskleri ve dokunulacak dosyaları yaz. Henüz kod değiştirme.
Kontrollü özellik ekleme
Mevcut arayüzü ve renkleri koruyarak yalnızca planlanan özelliği ekle. - PHP, Firebase veya veritabanı ekleme. - Yeni bağımlılık eklemeden önce gerekçesini yaz. - Masaüstü ve mobil davranışı birlikte koru. - İşlem sonunda değişen dosyaları, testleri ve kalan riskleri listele.
MCP ile harici araç bağlantısı
MCP, Claude Code’un izin verdiğin harici araçlara standart bir bağlantı üzerinden erişmesini sağlayabilir. Dosya sistemi, GitHub veya kurum içi araçlar gibi sunucular eklenebilir.
Sunucunun hangi araçları sunduğunu, hangi verilere eriştiğini ve hangi komutları çalıştırabildiğini incele. Gereksiz geniş izin verme.
MCP’nin temel mantığını ve n8n bağlantısını ayrı rehberde adım adım inceleyebilirsin.
Sık karşılaşılan sorunlar
| Sorun | Kontrol | Çözüm yaklaşımı |
|---|---|---|
claude bulunamadı | Terminali yeniden aç, PATH ve kurulumu kontrol et. | claude doctor veya resmi kurulum adımlarını yeniden doğrula. |
| Yanlış klasörde çalışıyor | pwd / cd | Repository köküne geçip tekrar başlat. |
| Gereksiz dosyaları değiştiriyor | Görev kapsamı ve CLAUDE.md | Değişmemesi gereken dosyaları açıkça yaz ve plan aşaması kullan. |
| Eski kodu geri getirmek gerekiyor | git diff | Yalnızca ilgili dosyayı git restore ile geri al; önce farkı oku. |
Resmi kaynaklar
Kurulum komutları ve entegrasyon adımları resmi Claude Code dokümantasyonu temel alınarak hazırlanmıştır.