Claude · Gelişmiş · 201 Claude Code temeli · Konu 10 / 10
3.10 Git ile güvenli çalışmak ve ilk proje
Geri dönüş yolunu önceden bil, sonra küçük bir şey yap.
Bu sayfada ne öğreneceksin
- Claude'un değişikliklerini geri almanın yollarını ve her birinin sınırını
- Kontrol noktaları (checkpoints) ile git'in neden birbirinin yerine geçmediğini
- Küçük bir kişisel web sayfası projesini, her adımda ne yazacağını bilerek baştan sona yapmayı
Kısaca
Claude Code dosyalarını düzenler ve komut çalıştırır. Bu yüzden "bir şey ters giderse nasıl dönerim?" sorusunun cevabını işe başlamadan bilmek gerekir. İki araç var ve ikisi farklı işe yarar.
Kontrol noktaları oturum içi hızlı geri dönüştür. Claude Code, Claude'un dosya düzenleme araçlarıyla yaptığı değişiklikleri otomatik izler; gönderdiğin ve bir tur başlatan her istem yeni bir kontrol noktası oluşturur. Kaçan bir şey olursa önceki duruma dönebilirsin. Kontrol noktaları konuşmayla birlikte kaydedilir, oturumu devam ettirsen de /rewind çalışır.
Git kalıcı geçmiştir. Doküman bunu açıkça söylüyor: kontrol noktaları oturum düzeyinde hızlı kurtarma içindir, kalıcı sürüm geçmişi ve iş birliği için git gibi bir sürüm kontrol sistemini kullanmaya devam et. Kontrol noktaları git'ten ayrıdır.
Claude ile git konuşarak da yapılır: ne değiştiğini sorarsın, commit atmasını istersin, yeni dal açtırırsın.
Değişikliği geri almanın yolları
| Durum | Ne yapılır | Sınır |
|---|---|---|
| Claude'un yaptığı düzenleme yanlış | Claude'a geri almasını söyle ("undo that" türünden) ya da /rewind | Yalnız Claude'un dosya düzenlemelerini kapsar |
| Hem kod hem konuşma yanlış yöne gitti | /rewind (ya da boş istemde Esc'e iki kez bas), istemi seç, Restore code and conversation | Kontrol noktası yoksa kod seçenekleri çıkmaz |
| Yalnız dosyalar yanlış, konuşma iyi | /rewind menüsünde Restore code | Sembolik ve sert bağlantılı dosyaları atlar |
| Yalnız konuşma yanlış, kod iyi | /rewind menüsünde Restore conversation | Dosyalar olduğu gibi kalır |
Değişiklik kabuk komutuyla yapıldı (rm, mv, cp gibi) | Rewind geri almaz. Git ile geri al. | Kabuk komutlarının değişiklikleri izlenmez |
| Bir alt ajan (subagent) düzenledi ya da sen Claude Code dışında düzenledin | Rewind genellikle bunları geri almaz. Git kullan. | Alt ajan ve dış değişiklikler izlenmez |
| Kalıcı kayıt istiyorsun | Commit | Git geçmişi senin elindedir |
| Farklı bir yaklaşımı denerken ilk yolu korumak istiyorsun | /branch ile konuşmayı dallandır ya da git'te yeni dal aç | Dal konuşmayı (/branch) ya da dosyaları (git dalı) ayırır, ikisini birden değil |
Kontrol noktalarının başka sınırları da var: Claude Code dosya anlık görüntülerini oturum bir süre güncellenmeyince temizler ve sunucu, veri tabanı ya da dağıtım gibi uzak sistemlere yapılan işlemler geri alınamaz. Bu işleri izin modun ve izin kuralların kontrol eder (bkz. 3.7).
Auto modda, kaydedilmemiş değişiklikleri çöpe atacağı varsayılan git reset --hard, git clean -fd gibi komutlar ve zorla itme (force push) varsayılan olarak engellenir. Yine de önemli bir işe başlamadan önce commit almak, geri dönüş noktasını senin elinde tutar.
Adım adım
- Ne değiştiğini sor. Claude'a değişen dosyaları sor. Beklenen sonuç: Claude git durumuna bakıp listeler. Kendin görmek istersen
/diffyaz. - Commit'ini Claude'a yazdır. Gözden geçirdiğin değişiklik için açıklayıcı bir mesajla commit atmasını iste (aşağıdaki hazır prompt). Beklenen sonuç: Claude mesajı yazar ve commit eder.
- Büyük bir deneme öncesi yeni dal aç. Claude'dan yeni bir dal açmasını iste. Beklenen sonuç: Claude yeni dalı açar ve deneme o dalda yürür.
- Aynı depoda iki iş yürüteceksen ayrı çalışma ağacı kullan. Her çalışma ağacı (git worktree) kendi dalında ayrı bir kopyadır; iki oturum aynı dosyalar üzerinde çatışmaz. Depoda en az bir commit olmalıdır, yoksa komut hata verir.
- Yanlış gittiyse önce rewind'ı dene. Claude'un düzenlemelerini
/rewindile geri al. Kabuk komutu ya da alt ajan işe karıştıysa git'e dön. - Eski oturuma dönmek istersen.
/clearsonrası aynı süreçte kalıyorsan rewind menüsünün üstünde "önceki oturum" girişi çıkar; başka zaman/resumekullan (bkz. 3.8).
İki ayrı çalışma ağacında paralel oturum başlatmak için terminal komutu (ad kurgusaldır):
claude --worktree feature-auth
Kısa ilk proje: kişisel tanıtım sayfası
Amaç: tek sayfalık, kurgusal bir kişisel tanıtım sayfası yapmak. Bu proje boyunca gerçek bilgin gerekmiyor; sayfadaki ad, meslek ve iletişim satırlarını uydurma yer tutucularla doldur. Boş yeni bir klasörle başla: Claude çalışma klasöründeki dosyaları okur ve düzenler.
- Klasörü hazırla ve Claude Code'u başlat. Boş yeni bir klasör aç, terminali o klasörde aç ve aşağıdaki komutları çalıştır (yolu kendi klasörünle değiştir). İlk kullanımda giriş yapman istenir. Beklenen sonuç: istem satırı görünür.
- Plan moduna geç ve işi tarif et.
Shift+Tabile plan moduna geç ya da isteminin başına/planyaz. Aşağıdaki ilk istemi gönder. Beklenen sonuç: Claude dosya düzenlemeden bir plan sunar (bkz. 3.6). - Planı oku ve onayla. Eksik bir yer varsa düzeltmesini söyle. Onay isteminde ilk projede Yes, manually approve edits seç; böylece her düzenlemeyi sen onaylarsın.
- Sayfayı yazdır ve kendin dene. Claude her düzenleme için sana sorar; isteği oku ve onayla. Bitince oluşan HTML dosyasını tarayıcında aç ve bak. Beklenen sonuç: tek sayfalık bir tanıtım sayfası.
- Değişikliği gör.
/diffyaz ve oluşan dosyaya bak. Kursun üç kontrolü burada da geçerli: istemediğin bir şey var mı, yeni bir paket eklenmiş mi, koda gömülmüş bir adres ya da anahtar var mı (bkz. 3.9). - İlk commit'i al. Aşağıdaki ikinci istemi gönder. Beklenen sonuç: Claude depoyu hazırlar ve açıklayıcı bir mesajla commit eder. Bundan sonra elinde kalıcı bir geri dönüş noktası vardır.
- Yeni dalda deneme yap. Üçüncü istemle yeni bir dal açtır ve sayfaya iletişim bölümü ekletmeyi dene.
- Beğenmediğin değişikliği geri al. Sonucu beğenmezsen
/rewindyaz, bu değişikliği üreten istemi seç ve Restore code seçeneğini seç. Beklenen sonuç: dosyalar o istemden önceki hâline döner, konuşma olduğu gibi kalır. - İncele ve kaydet. Sonuçtan memnunsan
/code-reviewile ikinci görüş al, bulguları sınıfla ve commit ettir. Böylece tam döngüyü yapmış olursun: keşfet, planla, kodla, commit.
Klasöre girip Claude Code'u başlatmak için terminal komutları:
cd /path/to/your/project
claude
Ayrı çalışma ağacında başlatmak istersen yukarıdaki claude --worktree komutunu kullan.
Hazır prompt
Git bölümünün 1. ve 2. adımları için:
Hangi dosyaları değiştirdim?
Değişikliklerimi açıklayıcı bir commit mesajıyla commit et.
İlk proje, adım 2 (plan modunda gönder):
Tek sayfalık bir kişisel tanıtım web sayfası yapmak istiyorum. Sayfada bir başlık, "Hakkımda" bölümü ve kısa bir proje listesi olsun; içerik [adın] adına kurgusal yer tutucu metin olsun. Önce bu işin hangi dosyalardan oluşacağını ve nasıl bir yol izleyeceğini planla. Sayfanın doğru olup olmadığını nasıl anlayacağımızı da yaz. Henüz hiçbir dosyayı oluşturma.
Adım 6 (ilk commit):
Bu klasörde bir git deposu başlat, oluşturulan dosyaları ekle ve değişiklikleri özetleyen açıklayıcı bir mesajla commit et.
Adım 7 (yeni dal ve deneme):
"deneme-iletisim" adında yeni bir dal oluştur ve sayfaya kurgusal bir e-posta adresi içeren kısa bir "İletişim" bölümü ekle.
Sık yapılan hata
- Kontrol noktalarını git sanmak. Doküman bunların git'in yerini tutmadığını söylüyor. Kabuk komutlarının, alt ajanların ve Claude Code dışında yaptığın değişikliklerin geri alınması için commit geçmişine ihtiyacın var.
- Hiç commit almadan büyük iş istemek. Rewind'ın kapsamadığı bir şey bozulursa dönecek yerin olmaz. Önemli işten önce commit al.
- Gerçek klasörde denemek. İlk projeni boş, yeni bir klasörde yap; Claude çalışma klasöründeki dosyaları okur ve düzenler.
- Gerçek kişisel veriyi örneğe koymak. Ad, e-posta ve telefonu yer tutucuyla yaz. Kursa göre koda doğrudan yazılmış bir adres ya da anahtar, incelemede dikkat edilecek şeylerdendir (bkz. 3.9).
Video
Video: yakında.
Kaynak
- Anthropic Academy, Claude Code 101: The explore → plan → code → commit workflow (commit aşaması, ikinci göz, commit mesajı)
- Anthropic Academy, Claude Code 101: Code review (
/diff,/rewind, üç kontrol) - Anthropic Academy, Claude Code in action: Steering long sessions (rewind menüsü, çalışma ağaçları)
- Claude Code dokümanı: Checkpointing (kontrol noktaları, rewind seçenekleri, sınırlamalar, git'in yerini tutmaması)
- Claude Code dokümanı: Quickstart (git ile konuşarak çalışma,
cdveclaude) - Claude Code dokümanı: Common workflows (
claude --worktree, commit gerekliliği, plan modu) - Claude Code dokümanı: How Claude Code works (dosya düzenlemeleri geri alınabilir, uzak sistemler geri alınamaz)
- Claude Code dokümanı: Manage sessions (
/branch) - Claude Code dokümanı: Choose a permission mode (auto modun varsayılan engelleri)
- Claude Code dokümanı: Best practices (commit, geri alma)
Son doğrulama: 2026-10-21