# Claude Code: Working in the Terminal

> Source: https://sukruyusufkaya.com/en/learn/claude-ustaligi/claude-code-cli
> Updated: 2026-05-11T13:49:30.583Z
> Category: Claude Ustalığı
> Module: 4. Coding with Claude
**TLDR:** Claude in the terminal via Claude Code CLI — project mapping, file editing, code execution, hooks, and plan mode.

> **Claude Code = terminalden agentic Claude**
>
> Claude Code, mevcut kod tabanını gezebilen, dosya açıp düzeltebilen, komut çalıştırabilen bir Claude sürümüdür. Senior IDE arkadaşı gibi düşün.

# Kurulum

Claude Code, hesabınla bağlantılı bir CLI'dır. Terminale şu komutu yaz:

```bash
$ npm install -g @anthropic-ai/claude-code
+ @anthropic-ai/claude-code
added 1 package
```

```bash
$ claude --version
claude-code 2.x
```

```bash
$ claude login
Browser opened. Authorize and return.
```

# Temel İş Akışı

### 1) Projede başlatma

```
cd /path/to/project
claude
```

Claude proje kökünü algılar. Eğer **CLAUDE.md** varsa kuralları okur; yoksa `/init` komutuyla bir tane öner.

### 2) Plan mode (büyük değişiklikler için)

Plan mode'da Claude **sadece okur**, dosya yazmaz. Önce planını sunar, onaylarsan uygular.

```
> /plan migrate API client to fetch + retry
```

Çoklu dosya değişikliklerinde idealdir.

### 3) Kullandığı araçlar

- Read, Write, Edit (dosya)
- Glob, Grep (arama)
- Bash (komut)
- Plan, Todo (planlama)
- Web fetch / search (yetkilendirilmişse)
- Custom skills / hooks (sen tanımlıyorsun)

Her araç çağrısı kullanıcıya gösterilir; istemediğini reddedebilirsin.

### 4) Hooks

`.claude/settings.json` ile pre/post hooks ekleyebilirsin:

```json
{
  "hooks": {
    "preToolUse": ".claude/hooks/lint.sh",
    "postToolUse": ".claude/hooks/format.sh"
  }
}
```

Lint, prettier, npm test gibi şeyleri otomatik tetikler.

### 5) Skills (özel beceriler)

Kendi 'beceri' klasörlerini ekleyebilirsin: `.claude/skills/<isim>/SKILL.md`. Claude beceri açıklamasına göre tetikler ve çağrı zamanı içeriği okur. Modül 12'de detaylı işleyeceğiz.

> **Plan mode'u şart kıl**
>
> 10 dosyadan büyük değişikliklerde her zaman plan mode'la başla. Plan'ı oku, onayla, sonra Claude'a uygulat. Bu disiplin %95 sürpriz hatayı önler.

```markdown
# CLAUDE.md — örnek (proje köküne koy)

## Çalışma kuralları
- TypeScript strict, Next.js 15
- Test: vitest + RTL
- Stil: prettier + eslint-config-next
- Commit: conventional commits

## Anti-pattern'ler
- localStorage / sessionStorage kullanma
- 'as any' kullanma
- Server-only modülleri client'a import etme

## Önemli path'ler
- src/lib/auth-check → requireAdmin
- src/lib/sanitize  → HTML sanitize
- src/lib/mongodb   → DB connection

```

### Claude Code güçlü
- Çok dosyalı refactor
- Test yazma & çalıştırma
- Bağımlılık güncelleme
- Build / lint hatası çözme
- ADR / changelog yazma

---

### Claude Code zayıf
- UI/UX değerlendirme (görsel)
- Agresif perf tuning (insan asıl çağrılan)
- Mimari kararlar (insan onayı gerekir)
- Güvenlik kritik kod (review zorunlu)

**Boşluk doldurma egzersizi (text):**
```text
Claude Code büyük değişiklikler öncesi _____ mode önerilir. Proje kuralları _____ dosyasında yazılır. _____ ile pre/post komutlar otomatize edilir.
```

> ✋ Kontrol noktası: `q-406-mc1`

> 📝 İlgili quiz: `module-4-final`