Claude Code'a Proje Hafızası Ver: VS Code ve Obsidian ile Adım Adım Kurulum

Claude Code her oturumda sıfırdan başlar. Dün neye karar verdiğini, hangi tabloyu oluşturduğunu, ne ertelediğini — bilmez. Bu rehberde Visual Studio Code'daki Claude Code eklentisini ve Obsidian'ı birleştirerek bu sorunu çözüyoruz. Aylık bütçe takip uygulaması yapacaksın — adım adım, tıklama tıklama.

Ne Gerekli?

Başlamadan şunları bilgisayarına kur:

Visual Studio Code — Kodu yazdığın ve Claude Code'u çalıştırdığın program. Ücretsiz.

Obsidian — Notlarını bilgisayarında saklayan not uygulaması. Kişisel kullanım için ücretsiz. Daha önce hiç kullanmadıysan Obsidian rehberimize bakabilirsin.

Claude hesabı — Claude Code, Pro planından ($20/ay) itibaren geliyor. Ücretsiz plan yok. claude.ai adresinden kayıt olabilirsin.

Üçü de hazırsa devam edebiliriz.

1. Claude Code Eklentisini VS Code'a Kur

VS Code'u aç. Sol kenarda 5 ikondan oluşan bir sütun görürsün. En alttaki 4 kareden oluşan ikona tıkla — bu ExtensionsⁱVS Code'a ek özellikler eklemeni sağlayan eklenti mağazası paneli.

Üstteki arama kutusuna Claude Code yaz. İlk sırada çıkan Anthropic'in eklentisine tıkla, mavi Install düğmesine bas.

Kurulum bitince VS Code'un sağ tarafında Claude simgesi belirir. Tıkla — sağ panelde bir chat arayüzü açılır. Buraya prompt yazacaksın.

[mindi_yorum]
💰 Claude Code Pro planında $20/ay. Eklentinin kendisi ücretsiz ama Claude hesabı olmadan çalışmaz.
🟢 VS Code içinde kod ve Claude Code yan yana — sekme değiştirmeden çalışıyorsun.
🟡 Eklentiyi kurduktan sonra Claude hesabıyla giriş yapman gerekiyor. İlk açılışta "Sign in" isteyecek.
🔵 Eklentiyi yükledikten sonra VS Code'u yeniden başlat — bazı sistemlerde sağ panel ilk çalıştırmada görünmeyebilir.

2. Proje Klasörünü Oluştur ve VS Code'da Aç

Masaüstünde sağ tıkla → Yeni Klasör → adını aylik-butce koy.

VS Code'a geç. Üst menüden File → Open Folder → masaüstündeki aylik-butce klasörünü seç → Klasörü Seç düğmesine bas.

VS Code'un sol panelinde klasörün adı görünüyor olmalı. Bu klasör artık projenin ana yeri.

3. Obsidian Vault Oluştur

Obsidian'ı aç. İlk ekranda Create new vault seçeneğini görürsün.

Vault name: butce-vault yaz.
Location: Browse düğmesine bas → masaüstünü seç → Create düğmesine bas.

Obsidian açılır ve boş bir vault görürsün. Sol üstteki kağıt + kalem ikonuna tıkla — yeni not oluşturur.

Sırayla bu 3 dosyayı oluşturacaksın. Her biri için ikona tıkla, adı yaz, Enter'a bas.

STACK.md — Projenin Teknik Yapısı

İlk notu oluştur, adını STACK.md koy. İçine şunu yapıştır:

# Aylık Bütçe Uygulaması — Teknik Yapı

## Kullandığım Araçlar
- Next.js (web arayüzü)
- Supabase (veritabanı)

## Tablolar
- expenses: id, amount, category_id, date, description
- categories: id, name, color, monthly_limit

## Kurallar
- Gider eklenirken category_id boş olamaz
- Tarih formatı: YYYY-MM-DD
- Tablo adlarını değiştirme

Kaydet: Ctrl + S (Mac'te Cmd + S).

PROJE.md — Güncel Durum

İkinci notu oluştur, adını PROJE.md koy. İçine:

# Aylık Bütçe Uygulaması — Durum

## Tamamlandı
- (henüz yok)

## Devam Ediyor
- Temel uygulama yapısı

## Sırada
- Gider ekleme formu
- Kategori yönetimi
- Aylık özet ekranı

Kaydet.

KARAR-LOGU.md — Aldığın Kararlar

Üçüncü notu oluştur, adını KARAR-LOGU.md koy. İçine:

## 2026-06-05

### Başlangıç kararı
Karar: Basit tutmak. Önce gider ekleme ve listeleme.
Neden: İlk versiyonda sadece temel işlevler olsun.
Reddedilen: Grafik, rapor, PDF çıktısı — sonraki versiyona ertelendi.

Kaydet.

[mindi_yorum]
💰 Obsidian kişisel kullanım için ücretsiz.
🟢 KARAR-LOGU.md en değerli dosya. "Neden böyle yaptık?" sorusunu önceden cevaplıyor — hem sen hem Claude Code bir ay sonra buraya bakıyor.
🟡 Bu dosyalar kendiliğinden güncellenmiyor. Önemli bir karar aldığında buraya yazman lazım. 2-3 dakika — alışkanlık meselesi.
🔵 Obsidian'da dosya adlarını büyük harfle yaz (STACK.md, PROJE.md). Sonra path verirken karışmaz.

4. CLAUDE.md Dosyasını Oluştur

VS Code'a geç. Sol panelde aylik-butce klasörünün üzerine sağ tıkla → New File → adını CLAUDE.md koy → Enter'a bas.

Ortadaki boş editör alanında şunu yaz — ama önce Windows kullanıcı adını öğren:

Windows'ta Başlat menüsüne tıkla → profil fotoğrafının altında kullanıcı adın yazar. Not al.

Şimdi CLAUDE.md'ye şunu yapıştır (köşeli parantez içindeki kısmı kendi kullanıcı adınla değiştir):

# Aylık Bütçe Uygulaması — Kurallar

## 1. Yazmadan önce sor
Emin olmadığın şeyleri tahmin etme. Şüphelendiğinde sor.

## 2. Sade tut
İstenmeden özellik ekleme. "Bunu da ekleyebilirim" deme.

## 3. Tablo adları
expenses, categories — değiştirme, uygulama bunlara bağlı.

## Proje bilgisi için şunu oku
- C:/Users/[KULLANICI_ADIN]/Desktop/butce-vault/STACK.md
- C:/Users/[KULLANICI_ADIN]/Desktop/butce-vault/PROJE.md
- C:/Users/[KULLANICI_ADIN]/Desktop/butce-vault/KARAR-LOGU.md

Mac kullanıyorsan adresler /Users/[KULLANICI_ADIN]/Desktop/butce-vault/ formatında olur.

Ctrl + S ile kaydet.

5. İlk Prompt: Uygulamayı Yaptır

VS Code'un sağ panelinde Claude Code açık. Şu promptiyapay zekaya verdiğin yazılı görev yu yapıştır:

STACK.md ve PROJE.md dosyalarını oku.

Sonra şunu yap:
Basit bir aylık bütçe takip uygulaması oluştur.

İlk adım olarak sadece şunu yap:
- expenses ve categories tablolarını Supabase'de oluşturacak SQL kodunu yaz
- Gider ekleme formunu yaz (tutar, kategori, tarih, açıklama)
- Giderleri listeleyen bir sayfa yaz

Sade tut. Fazladan özellik ekleme.

Enter'a bas ve Claude Code'un ne yaptığını izle. Sağ panelde adımları açıklayarak ilerleyecek, sol panelde dosyalar oluşacak.

6. Test: Vault'tan Gerçekten Okuyor mu?

Uygulamanın ilk parçaları oluşturulduktan sonra Claude Code'a şunu sor:

KARAR-LOGU.md dosyasını oku ve içindeki kararları özetle.

Dosyaya yazdıklarını cevabında görüyorsan bağlantı çalışıyor. Görmüyorsa CLAUDE.md'deki adresi kontrol et — büyük ihtimalle kullanıcı adı veya masaüstü yolu hatalı.

Vault'u Nasıl Güncel Tutarsın

Yeni bir özellik bittiğinde Obsidian'ı aç, PROJE.md'yi güncelle — tamamlananlar listesine ekle.

Önemli bir karar aldığında KARAR-LOGU.md'ye yaz: ne kararı, neden, ne reddettim.

Kural değiştiğinde CLAUDE.md'yi düzelt.

Her biri 2-3 dakika. Hatalı kodun düzeltilmesinden çok daha kısa.

Şimdi Ne Yaparsın

1. VS Code'u indir ve kur.
2. Obsidian'ı indir ve kur.
3. VS Code'da Extensions'dan Claude Code eklentisini kur.
4. Masaüstünde aylik-butce ve butce-vault klasörlerini oluştur.
5. Obsidian'da vault içine 3 dosyayı oluştur ve doldur.
6. VS Code'da aylik-butce klasörünü aç, CLAUDE.md'yi oluştur.
7. Sağ panelde ilk prompt'u ver — uygulamayı yaptırmaya başla.