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

Adres: https://agentvera.dev/blog/claude-code-nasil-kullanilir/ · Yayın: 2026-10-22

Claude Code nasıl kullanılır, adım adım: kurulum, giriş, ilk görev, CLAUDE.md, izin modları, slash komutları, plan modu ve kullanım limitlerine takılmamanın yolları.

**Kısaca:**

- Claude Code için Claude Pro, Max, Team ya da Enterprise planı, bir Claude Console hesabı veya Amazon Bedrock, Google Cloud ya da Microsoft Foundry gerekir; ücretsiz Claude.ai planında yok.
- Kurduktan sonra proje klasöründe claude yaz, tarayıcıda bir kez giriş yap ve /init ile yaklaşık 200 satırın altında tutacağın bir CLAUDE.md oluştur.
- İzin modları arasında Shift+Tab ile geçilir; bir iki dosyadan büyük işlerde plan modu, yanlış yolu geri almak için /rewind, limitlerde kalmak için /clear ve /compact kullanılır.

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:

```bash
claude --version
```

## 2. Adım: giriş yap

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

```bash
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:

```bash
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](/blog/claude-code-limit/ "Claude Code limitleri") ve [Claude Code token tasarrufu](/blog/claude-code-token-tasarrufu/ "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ı](/ozellikler/calisma-alani/ "Ç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](/ozellikler/git-ve-github/ "Git ve GitHub") 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ı](/ozellikler/turlar-ve-oturum-tekrari/ "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](/blog/birden-fazla-claude-code-ajani/ "Birden fazla Claude Code ajanı") yazısını oku ve [AgentVera’yı ücretsiz indir](/indir/ "AgentVera’yı indir").

Öğrenirken [Claude Code komutları](/blog/claude-code-komutlari/ "Claude Code komutları") listesini açık tut; VS Code kullanıyorsan [Claude Code VS Code kurulumu](/blog/claude-code-vs-code-kurulumu/ "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.

## Sık sorulanlar

**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.

---

**AgentVera hakkında.** AgentVera, Solviera Teknoloji tarafından geliştirilen macOS, Windows ve Linux masaüstü uygulamasıdır. 18 yapay zeka kodlama ajanını (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) proje bazında, gerçek terminallerde ve kullanıcının kendi CLI kurulum ve girişleriyle yan yana çalıştırır. Ücretsiz planda sınırsız ajan vardır. İndir: https://agentvera.dev/indir/ · Fiyatlar: https://agentvera.dev/fiyatlar/