Claude Code değişikliklerini geri alma: rewind ve git

Claude Code değişikliklerini geri almak için mevcut oturumdaki düzenlemelerde /rewind’ı, commit’lediğin ya da depodan geri getirebileceğin her şeyde git’i, tüm çalışma klasörünü belirli bir ajan turunun başına döndürmek istediğinde de AgentVera checkpoint’lerini kullan. Her biri farklı bir boşluğu kapatır. Hangisine uzanacağını bilmek, ajanın işini geri alırken kendi işini kaybetmekten kurtarır.

Bu rehber üçünü karşılaştırıyor, her biri için adımları tam olarak gösteriyor ve her birinin neyi kaçırdığını listeliyor. Genelde can yakan kısım o sonuncusu.

Kısa cevap

1. seçenek: Claude Code içinde /rewind

Claude Code dosyaları düzenlerken checkpoint kaydeder. Geri dönmek için iki kez Esc’e bas ya da /rewind çalıştır. Oturumdan bir mesaj seçersin, sonra neyi geri getireceğini seçersin:

• Yalnızca kod: dosyalar o mesajdaki hâline döner, konuşma kalır.
• Yalnızca konuşma: konuşma geri gider, dosyalar olduğu gibi kalır.
• İkisi birden: o noktaya temiz bir geri adım.

Hâlâ oturumdaysan bu en hızlı geri alma yolu. Ajan az önce kötü bir düzenleme yaptıysa doğru ilk hamle de bu.

Neyi kaçırır: Claude Code’un checkpoint’leri kendi dosya araçlarının yaptığı düzenlemeleri izler. rm, mv, bir kod üretici ya da bir migration script’i gibi kabuk komutlarının yaptığı değişiklikler izlenmez. Aynı klasördeki başka oturumların ya da araçların değişiklikleri de izlenmez. /rewind bir kolaylık; sürüm kontrolünün yerini tutmaz.

2. seçenek: git

Git her araçla çalışan geri alma yöntemi; yeter ki tutmak ya da atmak istediğin iş git’in görebildiği bir şey olsun.

# Neyin değiştiğine bak
git status
git diff

# İzlenen tek bir dosyadaki değişiklikleri at
git restore src/api/user.ts

# Yeni dosyalar dahil her şeyi kenara koy, lazım olursa dursun
git stash -u

# İzlenen dosyalardaki tüm commit’lenmemiş değişiklikleri at
git reset --hard

# İzlenmeyen dosya ve klasörleri sil (önce -n ile kontrol et)
git clean -n -d
git clean -f -d

# Ajanın zaten yaptığı bir commit’i tersine çevir
git revert <commit>

İki alışkanlık git’i ajan işleri için çok daha iyi bir geri alma aracına çevirir:

1. Ajanı bir işe başlatmadan önce commit’le. O zaman git diff ajanın tam olarak ne yaptığını gösterir; git stash -u ya da git reset --hard seni geri götürür.
2. Her ajana kendi worktree’sini ver. O zaman bir ajanı geri almak başka bir ajanın işine hiç dokunmaz. Bkz. git worktree ile paralel geliştirme.

Neyi kaçırır: iki commit arasındaki her şeyi. Ajan çalışırken aynı dosyalarda sen de düzenleme yaptıysan git reset --hard seninkileri de atar. git clean izlenmeyen dosyaları kalıcı siler; her zaman önce -n ile çalıştır.

3. seçenek: AgentVera checkpoint’leri

AgentVera ikisinin arasında duran, tur başına bir geri alma ekler. Yalnızca Claude Code ile değil, yerel bir klasörde çalışan her ajan CLI’ıyla çalışır.

Anlık görüntüler nasıl alınır

AgentVera her turun başında ajanın çalışma klasörünün (worktree’sinin ya da proje klasörünün) anlık görüntüsünü alır. Görüntü izlenen ve izlenmeyen dosyaları kapsar ve .gitignore’a uyar. Gizli bir ref altında, refs/agentvera/checkpoints/…, bir commit olarak saklanır. Dalların, index, stash ve HEAD değişmez; git log ya da git status’ta hiçbir şey görünmez.

Ajan başına son 60 tur tutulur. Ajanı silmek görüntülerini de siler. Proje bir Git deposu olmalı. İlk görüntü, ajana bir mesaj gönderdiğinde (ya da Claude’a terminalden yazdığında) alınır.

Bir turu geri al

1. Ajanın panel başlığında Turlar’a tıkla (“Turlar ve geri alma”). Dar bir panelde Seçenekler altında durur.
2. Liste turları en yeniden eskiye, numarası, prompt’u ve zamanıyla gösterir. Doğrudan terminale yazılan bir tur “Terminalden yazılan tur” olarak görünür.
3. Bir turu aç; o turda değişen dosyaları eklendi, değişti ya da silindi işaretleri ve satır sayılarıyla görürsün.
4. Bu turu geri al’a tıkla ve Turu geri al ile onayla.

Çalışma klasörü o turun başına döner. Bu noktadan sonra eklenen dosyalar silinir, değişen ve silinen dosyalar eski hâline gelir. AgentVera sonra kaç dosyayı geri döndürdüğünü söyler. Ajan hâlâ çalışıyorsa pencere önce onu durdurmanı önerir; böylece klasör altında değişirken düzenlemeye devam etmez.

Geri almayı geri al

AgentVera geri almadan önce mevcut durumu ayrıca kaydeder. Listenin en üstünde Geri almadan önceki durum olarak görünür. Elindekine aynen dönmek için Bu duruma dön’e tıkla. Yani bir geri almayı denemek güvenli. Ajanın değişikliği aslında iyiyse ona geri dönebilirsin.

Telefondan

Ajanları Telegram’dan yönetiyorsan ajan düğmelerinde ↩️ Son turu geri al var. Dosya listesini gösterir ve onay ister. Sonrasında bunu da masaüstündeki checkpoint listesinden geri alabilirsin. Bkz. Telegram ile kontrol.

Neyi kaçırır

• Aynı klasördeki diğer ajanlar. Geri alma klasörü döndürür; o klasörde çalışan diğer ajanların sonraki değişiklikleri de geri alınır. Onay penceresi bunu söyler. Worktree’ler bunu önler.
• Yok sayılan dosyalar. node_modules ya da yerel bir .env gibi .gitignore’a takılan dosyalar görüntüye girmez.
• Klasörün dışındaki şeyler. Ajanın migration uyguladığı bir veritabanı, yayınladığı bir paket ya da yaptığı bir push klasördeki dosyalar değil; hiçbir klasör görüntüsü bunları geri alamaz.
• SSH ajanları ve düz terminaller. Uzak sunucudaki ajanlar için checkpoint alınmaz, çünkü klasörleri bu bilgisayarda değil.

Hangisini ne zaman kullanmalı

• Ajan az önce kötü bir düzenleme yaptı ve hâlâ oturumdasın: /rewind.
• Ajan dosya silen ya da üreten bir script çalıştırdı: /rewind değil, AgentVera checkpoint’leri ya da git.
• Birkaç tur ters gitti: Turlar’da ilk kötü turun başına dön. Fikrini değiştirirsen mevcut duruma geri dönebilirsin.
• İş commit’lendi: git revert.
• Tüm iş için temiz bir sayfa istiyorsun: başlamadan önce commit’lediysen git stash -u ya da git reset --hard.

Baştan daha az geri alma

Geri alma bir güvenlik ağı, plan değil. Birkaç alışkanlık ona daha az ihtiyaç duymanı sağlar:

• Küçük, sınırları belli prompt’lar. Üç dosyayı değiştiren bir turu incelemek de geri almak da kolay.
• Riskli işte önce plan. Ajan değişikliği yapmadan önce anlatsın.
• Her turu incele. AgentVera’nın kod incelemesi her turun sonunda ajanın kodunu inceleyebilir. Neye bakılacağını yapay zeka kod incelemesi yazısı anlatıyor.
• Yıkıcı komutları onay arkasında tut. İzinleri, Docker yalıtımını ve onayları yapay zeka kodlama ajanı güvenliği yazısı anlatıyor.

Son söz

Bir yapay zeka kodlama ajanı için tek bir geri alma yok. /rewind mevcut oturumun düzenlemeleri için hızlı. Git, görebildiği her şeyi kapsar; en iyi hâli her işten önce commit’lemek. AgentVera checkpoint’leri aradaki boşluğu doldurur: her turda tüm çalışma klasörünün görüntüsü, kendisi de geri alınabilen bir geri alma ve telefonunda aynı düğme. Turlar ve oturum tekrarı sayfası ayrıca bir Claude ya da Codex oturumunu adım adım yeniden oynatan oturum tekrarını da anlatıyor; nerede ters gittiğini görürsün.