Claude Code’u kullanmak için ücretli plan gerekir mi?

Evet. Claude Code için Claude Pro, Max, Team veya Enterprise planı ya da API kredili bir Claude Console hesabı gerekir. Amazon Bedrock, Google Cloud veya Microsoft Foundry üzerinden de çalışabilir. Claude.ai’ın ücretsiz planında yok.

Claude Code Windows’ta çalışır mı?

Evet. PowerShell’den yerel kurulum betiğiyle ya da WinGet ile kurabilirsin. WSL içinde de çalışır. /init, plan modu ve izinler gibi komutlar her platformda aynı.

CLAUDE.md ne işe yarar?

CLAUDE.md, Claude Code’un her oturumun başında okuduğu proje talimatlarını içeren bir Markdown dosyası: build ve test komutları, kod stili, kaçınılacak şeyler. İlk sürümü /init ile oluştur, sonra kısa tut ve çalıştıkça güncelle.

Claude Code’un sormadan dosya değiştirmesini nasıl engellerim?

Manuel moda gelene kadar Shift+Tab’a bas (ya da plan moduna geç; orada bir planı onaylayana kadar hiç düzenleme yapmaz). /permissions ile sor ve reddet kuralları da ekleyebilirsin; örneğin git push öncesi her zaman sorsun.

Claude Code kullanım limitine takılınca ne yapmalıyım?

Pencerenin ne zaman sıfırlanacağını /usage ile gör. Alakasız işler arasında /clear, uzun oturumlarda /compact kullan; böylece her mesaj daha az bağlam taşır. Birden fazla Claude hesabın varsa /login ile geçebilirsin.

Claude Code nasıl kullanılır? Başlangıç rehberi

Claude Code’u kullanmak için tek bir komutla kurarsın, bir proje klasöründe claude yazarsın, tarayıcıda Claude hesabınla giriş yaparsın ve ne istediğini düz bir dille anlatırsın. Claude ihtiyaç duyduğu kodu okur, düzenleme ve komut önerir, izin vermediğin bir şeyi yapmadan önce sorar.

Döngünün tamamı bu kadar. Rehberin geri kalanı işi iyi yürüten parçaları anlatıyor: CLAUDE.md dosyası, izin modları, birkaç slash komutu, plan modu ve seni kullanım limitlerinin içinde tutan birkaç alışkanlık.

Claude Code nedir?

Claude Code, Anthropic’in kodlama ajanı. Terminalinde çalışır (VS Code, JetBrains, masaüstü uygulaması ve web’de de var), başlattığın klasördeki dosyalar üzerinde çalışır ve testler, linter’lar ve git gibi kabuk komutlarını çalıştırabilir. Sohbet penceresinden farkı, kodu senin yapıştırmana ihtiyaç duymaması. Neye ihtiyacı varsa gidip kendisi okur.

1. Adım: Claude Code’u kur

Önerilen yol yerel kurulum betiği. Arka planda kendini günceller.

Platform	Komut
macOS, Linux, WSL	`curl -fsSL https://claude.ai/install.sh \| bash`
Windows PowerShell	`irm https://claude.ai/install.ps1 \| iex`
macOS (Homebrew)	`brew install --cask claude-code`
Windows (WinGet)	`winget install Anthropic.ClaudeCode`

Homebrew ve WinGet kurulumları kendini güncellemez; arada bir paket yöneticinle yükseltmen gerekir. Kurulumun çalıştığını kontrol et:

claude --version

2. Adım: giriş yap

Bir proje klasörüne geç ve başlat:

cd projen
claude

İlk seferde Claude Code giriş yapman için tarayıcını açar. Şunlardan biriyle girebilirsin:

Claude Pro, Max, Team veya Enterprise aboneliği (en yaygın seçenek);
ön ödemeli kredilerden token başına faturalanan bir Claude Console hesabı;
bir bulut sağlayıcı: Amazon Bedrock, Google Cloud veya Microsoft Foundry.

Girişin kaydedilir, yani bunu bir kez yaparsın. Birden fazla hesabın varsa /login ile aralarında geçersin.

3. Adım: ilk görevin

“Bana bir uygulama yap” yerine küçük ve gerçek bir şeyle başla. İyi ilk görevler:

“Bu projede kimlik doğrulama nasıl çalışıyor, anlat.”
“Testleri çalıştır ve kırık olanın neden kırıldığını söyle.”
“Kayıt formuna girdi doğrulaması ekle, bir de testini yaz.”

Yaz ve Enter’a bas. Claude dosyaları okur, sonra değişiklik ya da komut önerir. İzin moduna göre ya önce sorar ya da devam eder; her düzenlemeyi sana diff olarak gösterir. Bunları oku. Kodu yayına alan hâlâ sensin.

Doğrudan bir görevle de başlatabilirsin:

claude "tarihleri nerede parse ettiğimizi bul ve kabul ettiğimiz formatları listele"

Başlatmanın diğer işe yarar yolları:

Komut	Ne yapar
`claude`	Etkileşimli bir oturum başlatır
`claude "görev"`	İlk mesajla birlikte oturum başlatır
`claude -p "görev"`	Bir kez çalışır, cevabı yazar ve çıkar (betikler için ideal)
`claude -c`	Bu klasördeki en son konuşmaya devam eder
`claude -r`	Devam etmek için eski bir konuşma seçtirir

4. Adım: bir CLAUDE.md yaz

Her oturum boş bir bağlam penceresiyle başlar. CLAUDE.md, Claude’un projeni hatırlama yolu: her oturumun başında okuduğu bir Markdown dosyası.

Oturumda şunu çalıştır:

/init

Claude kod tabanına bakar ve bulduğu build komutları, test komutları ve kurallarla ilk CLAUDE.md dosyasını yazar. Zaten bir CLAUDE.md varsa onun yerine iyileştirme önerir. Sonra dosyayı kendin düzenle. İçine konacak iyi şeyler:

nasıl build edilir, çalıştırılır ve test edilir (“testleri çalıştır” değil, pnpm test)
koddan kolayca anlaşılmayan kurallar
kaçınılacak şeyler (“src/gen/ altındaki üretilmiş dosyaları asla düzenleme”)
önemli parçaların nerede durduğu

Kısa tut; Anthropic her dosya için yaklaşık 200 satırın altında kalmayı öneriyor. Uzun dosyalar bağlamı doldurur ve daha az güvenilir şekilde uygulanır. @yol/dosya içe aktarmalarıyla dosyayı bölebilirsin.

CLAUDE.md birkaç yerde durabilir:

Dosya	Kapsam
`./CLAUDE.md` veya `./.claude/CLAUDE.md`	Proje; git üzerinden ekiple paylaşılır
`~/.claude/CLAUDE.md`	Sen, bütün projelerde
`./CLAUDE.local.md`	Sen, sadece bu projede (git’e ekleme)

Reponda diğer ajanlar için zaten bir AGENTS.md varsa, Claude Code’un yeni sürümleri CLAUDE.md yokken onu okur; bir CLAUDE.md içinden de @AGENTS.md ile içe aktarabilirsin.

5. Adım: izinleri anla

Claude Code riskli bir şey yapmadan önce sorar. Ne sıklıkla soracağı izin moduna bağlı. Modlar arasında dolaşmak için Shift+Tab’a bas; geçerli mod ekranın altında görünür.

Mod	Sormadan ne yapar	Ne için iyi
Manuel (`default`)	Dosya okur	Öğrenirken, hassas kodda
Düzenlemeleri kabul et	Okuma, dosya düzenleme, basit dosya sistemi komutları	Zaten diff’ten inceleyeceğin işler
Plan modu	Sadece okur; kaynak koda dokunmaz	Kodlamadan önce keşif ve tasarım
Otomatik mod	Çoğu eylem, bir güvenlik sınıflandırıcısının kontrolüyle	Daha az soruyla uzun işler

Yeni sürümler varsayılan olarak otomatik modda başlar; eski sürümler Manuel modda. Otomatik modda ikinci bir model her eylemi inceler ve riskli ya da görevle alakasız görünenleri engeller. Ama bu bir garanti değil, ne yaptığına göz kulak ol.

Daha ince ayar için /permissions ile izin ver, sor ve reddet kuralları ekleyebilirsin; örneğin “npm test her zaman serbest” ya da “git push öncesi her zaman sor”. macOS, Linux ve WSL2’de /sandbox Bash komutlarını bir sandbox içinde çalıştırır.

Bir de hiç sormayan --dangerously-skip-permissions var. Anthropic’in kendi dokümanı bunu sadece konteyner ya da sanal makine içinde kullanmanı söylüyor. Öğrenirken ana makinende kullanma.

6. Adım: bilmeye değer slash komutları

Bütün komutları görmek için oturumda / yaz. En çok kullanacakların şunlar:

Komut	Ne yapar
`/help`	Yardımı ve komutları gösterir
`/init`	`CLAUDE.md` oluşturur ya da iyileştirir
`/clear`	Temiz bir konuşma başlatır (eskisi `/resume` içinde kalır)
`/compact`	Bağlamı boşaltmak için o ana kadarki konuşmayı özetler
`/context`	Bağlam penceresini neyin doldurduğunu gösterir
`/model`	Modeli değiştirir; ok tuşlarıyla efor ayarlanır
`/plan`	Plan moduna geçer, istersen bir görevle
`/permissions`	İzin ver, sor ve reddet kurallarını yönetir
`/rewind`	Konuşmayı ve kodu daha önceki bir noktaya geri alır
`/resume`	Eski bir konuşmayı yeniden açar
`/mcp`	MCP sunucularını (ek araçları) yönetir
`/usage`	Planının kullanım limitlerini gösterir
`/review`	Mevcut değişikliklerini inceler
`/memory`	CLAUDE.md dosyalarını düzenler

Yeni başlayanların gözden kaçırdığı komut /rewind. Claude yanlış yola saparsa onu ikna etmeye çalışmak yerine başlamadan önceki noktaya geri dön.

7. Adım: büyük işlerde plan modunu kullan

Bir iki dosyadan fazlasına dokunan değişikliklerde önce plan iste. Plan modunu görene kadar Shift+Tab’a bas ya da şunu yaz:

/plan public API'ye rate limiting ekle

Plan modunda Claude kodu okur, netleştirici sorular sorar ve bir plan yazar ama kaynak koduna dokunmaz. Planı okursun, beğenmediğin kısımlara itiraz edersin, doğru olduğunda onaylarsın. Sonra düzenlemeye geçer ve planı adım adım uygular.

Bu birkaç dakikana mal olur ama çok fazla geri almaktan kurtarır. Bir oturumu doğrudan plan modunda başlatmak için claude --permission-mode plan da kullanabilirsin.

İyi prompt alışkanlıkları

Claude Code net talimatlara iyi uyar. Kötü sonuçların çoğu belirsiz talimatlardan gelir.

İşin nasıl kontrol edileceğini söyle. “Endpoint’i ekle ve pnpm test api geçsin”, “endpoint’i ekle”den iyidir.
Dosya göster. Dosyanın ya da fonksiyonun adını an, ya da bir dosyayı referans vermek için @ yaz.
Her konuşmaya tek iş. Alakasız bir şeye geçerken /clear kullan.
Örnek ver. “users.service.ts içindeki kalıbı izle”, bir paragraf açıklamadan iyidir.
Kodu bilmiyorsan önce açıklatmasını iste: “X nasıl çalışıyor? Henüz hiçbir şeyi değiştirme.”
Erken müdahale et. Yanlış yöne gidiyorsa Esc ile durdur, sonra düzelt.
Tekrarlanan düzeltmeleri CLAUDE.md’ye yaz. Bir şeyi iki kez söylediysen not et.

Limitler ve onlara takılmamak

Abonelik planlarının kullanım limitleri var: kayan 5 saatlik bir pencere ve haftalık bir limit; üst planlar daha fazlasını alır. Uzun konuşmalar daha çok harcar, çünkü her mesaj bütün bağlamı yanında taşır.

Nerede olduğunu /usage ile kontrol et.
Alakasız işler arasında /clear kullan.
Uzun oturumlarda /compact kullan; neyin kalacağını da söyleyebilirsin: /compact API kararlarını koru.
Büyük dosyalar ya da çok sayıda MCP aracı gibi yer kaplayanları /context ile gör.
Basit işler için /model ile daha hafif bir model seç.

Ayrıntılar için Claude Code limitleri ve Claude Code token tasarrufu yazılarına bak.

Tek terminal yetmediğinde

Rahatladıktan sonra, ilk Claude testleri çalıştırırken ikinci bir Claude’un da çalışmasını isteyeceksin. Aynı klasördeki iki ajan birbirinin dosyalarına basar, o yüzden her birinin kendi git worktree’si olmalı. Tek terminalin hantallaştığı nokta burası.

AgentVera; macOS, Windows ve Linux için Claude Code’u (ve diğer CLI ajanlarını) gerçek terminallerde yan yana çalıştıran bir masaüstü uygulaması. Zaten sahip olduğun Claude Code girişini kullanır.

Çalışma alanı: her proje için 1×1’den 5×4’e kadar bir ajan ızgarası. Her ajanın kendi adı, modeli, eforu ve Rol ve talimatlar alanı olur; uygulama yeniden açıldığında konuşmasına geri döner.
Worktree’ler: Git panelinde bir worktree oluşturup tek tıkla içinde ajan başlatırsın; paralel ajanlar asla dosya paylaşmaz.
Ajan başına izinler: Yeni ajan penceresinde Sorsun, Otomatik veya Tam yetki seç. Otomatik, Claude Code’un kendi otomatik modunu kullanır.
Turlar ve oturum tekrarı: her ajanın son 60 turu saklanır ve bir oturumu baştan izleyebilirsin.
Bir bakışta bağlam: her panel canlı bağlam boyutunu gösterir; otomatik sıkıştırma pencere dolmadan devreye girer.

Bunların hepsi ücretsiz planda. Güvenli okumaları ve testleri geçirip git push ya da rm gibi şeylerden önce yine soran otomatik onay ise Pro ve Team planlarında.

O noktaya geldiğinde birden fazla Claude Code ajanı çalıştırma yazısını oku ve AgentVera’yı ücretsiz indir.

Öğrenirken Claude Code komutları listesini açık tut; VS Code kullanıyorsan Claude Code VS Code kurulumu yazısına bak.

Toparlarsak

Kur, claude yaz, giriş yap ve küçük, gerçek bir işle başla. /init çalıştır ve CLAUDE.md dosyanı kısa tut. Claude’un ne kadar şey yapabileceğini Shift+Tab ile seç, büyük işlerde plan modunu, işler ters gidince /rewind’ı, limitlerin içinde kalmak için de /clear ve /compact’ı kullan. İlk birkaç haftada ihtiyacın olanın çoğu bu.