İçeriğe geç
Ömer Tiryaki (Ana sayfa)
← Tüm notlar

Rehberkontrol edildi

Claude Code kurulumu

Kurulumdan CLAUDE.md, skill ve hook kullanımına kadar. Claude Code’u her gün böyle kullanıyorum.

Claude Code nedir

Claude Code, terminal için bir yapay zekâ asistanıdır. Projenizi okur, dosyaları değiştirir ve komutları çalıştırır; ama yalnızca sizin izin verdiğiniz ölçüde. Bir sohbet penceresinden farkı şudur: Claude gerçek kodu görür ve testleri kendisi çalıştırabilir. Bu kılavuz sizi kurulumdan her gün çalışabileceğiniz bir düzene kadar götürür.

Gereksinimler

Bir terminale (Bash, Zsh, PowerShell veya CMD) ve güncel bir sisteme ihtiyacınız var: macOS 13 veya üzeri, Windows 10 1809 veya üzeri, Ubuntu 20.04 ya da Debian 10. Ayrıca Claude Code erişimi olan bir hesap gerekiyor. Ücretsiz Claude planı yeterli değil.

  1. Abonelik: Claude Pro veya Max (Team ve Enterprise da olur). Kullanım sınırları olan sabit bir aylık ücret ödersiniz.
  2. Ya da API ile faturalandırılan bir Claude Console hesabı. Burada kullandığınız kadar ödersiniz.

Kurulum

Önerilen yöntem yerel (native) yükleyicidir. Node.js gerektirmez ve Claude Code’u arka planda otomatik olarak güncel tutar. npm ile kurulum hâlâ mümkündür, ancak Node.js 22 veya üzerini gerektirir ve sudo ile çalıştırılmamalıdır. Ardından her şeyin çalıştığını claude --version ile kontrol edin.

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# npm ile alternatif (Node.js 22+)
npm install -g @anthropic-ai/claude-code@latest

# Kontrol ve elle güncelleme
claude --version
claude doctor
claude update

İpucu:Kurulumdan sonra terminal “command not found” derse yeni bir terminal penceresi açın. Bu işe yaramazsa claude doctor neyin eksik olduğunu gösterir.

Giriş ve ilk başlatma

Claude Code’u her zaman üzerinde çalışmak istediğiniz projenin klasöründe başlatın. Claude böylece tam olarak bu klasörü görür ve uygun ayarları yükler. İlk başlatmada giriş için tarayıcı açılır. Abonelikle Claude hesabınızla, Console ile ise Console hesabınızla giriş yaparsınız.

  1. Proje klasöründe claude yazın ve tarayıcıdaki giriş adımlarını izleyin.
  2. /status ile hangi hesabın ve hangi modelin etkin olduğunu kontrol edin.
  3. /logout ile çıkış yapın, /login ile yeniden giriş yapın.
cd projem
claude

Dikkat:ANTHROPIC_API_KEY ortam değişkeni tanımlıysa ve onu onaylarsanız, Claude Code aboneliğiniz yerine bu anahtarı kullanır. Bu durumda kullanım başına ücretlendirilirsiniz. Şu anda neyin etkin olduğunu /status ile görebilirsiniz.

Temel kullanım

Görevleri normal bir dille yazarsınız. Eğik çizgiyle başlayan komutlar oturumun kendisini yönetir. @ ve bir dosya adıyla doğrudan bir dosyayı gösterirsiniz; böylece Claude önce aramak zorunda kalmaz. Esc, Claude’u işin ortasında durdurur; o ana kadar yapılanlar korunur. Shift + Tab modu değiştirir: Manual (her değişiklikte sorar), acceptEdits (dosya değişikliklerini sormadan kabul eder) ve Plan (okur ve planlar, ama hiçbir şeyi değiştirmez).

/help        yardım ve tüm komutlar
/init        ilk CLAUDE.md dosyasını oluştur
/clear       boş bağlamla yeni sohbet
/compact     sohbeti özetle, bağlamı boşalt
/context     bağlamın ne kadar dolu olduğunu göster
/model       model değiştir
/permissions izin kurallarını yönet
/rewind      önceki bir duruma geri dön
/usage       kullanımı ve limitleri göster

@src/app.ts  belirli bir dosyayı an
Esc          Claude’u durdur
Esc Esc      (giriş boşken) geri alma menüsünü aç

İpucu:Bir planı ancak doğru olduğunda onaylayın. Bir şeyin farklı olmasını istiyorsanız yazmanız yeterli, Claude planı uyarlar.

İzinler

Claude proje klasöründe sormadan okuyabilir. Kabuk komutları ve dosya değişiklikleri için varsayılan olarak sorar. Her npm komutunu onaylamak zorunda kalmamak için kurallar belirlersiniz: allow sormadan izin verir, deny yasaklar. Ortak kurallar .claude/settings.json dosyasına yazılır ve repoya girer; kişisel kurallar .claude/settings.local.json dosyasına, tüm projeler için geçerli kurallar ise ~/.claude/settings.json dosyasına.

{
  "permissions": {
    "allow": ["Bash(npm run *)", "Bash(git commit *)"],
    "deny": ["Bash(git push *)", "Read(./.env)", "Read(./secrets/**)"]
  }
}

Dikkat:Bir deny kuralı yalnızca komut metnini kontrol eder. Örneğin git -C . push, Bash(git push *) kuralına takılmaz. Yani bu bir güvenlik sınırı değildir. Tüm onay sorularını kapatan bypassPermissions modunu yalnızca konteyner gibi yalıtılmış bir ortamda kullanın.

CLAUDE.md: projeniz için kurallar

Claude her başlangıçta CLAUDE.md dosyasını okur. Burada projenin ne olduğu, hangi komutların bulunduğu ve hangi kuralların geçerli olduğu yazar. /init ilk taslağı oluşturur, siz de onu netleştirirsiniz. Dosyayı kısa tutun, 200 satırın altında. Ne kadar kısa ve somut olursa Claude ona o kadar güvenilir şekilde uyar.

  1. Projede /init yazın ve oluşturulan CLAUDE.md dosyasını okuyun.
  2. Kesin kuralları ekleyin; örneğin repoya asla girmemesi gerekenler veya testlerin nasıl çalıştığı.
  3. Kişisel tercihler tüm projelerde geçerli olan ~/.claude/CLAUDE.md dosyasına yazılır. Yalnızca bu projeye ait özel notlar CLAUDE.local.md dosyasına girer; bu dosyayı .gitignore’a ekleyin.
# Proje
TypeScript strict ile Next.js. Ayrıntılar @README.md içinde

## Komutlar
- npm run dev: geliştirme sunucusu
- npm run test: testler, her commit’ten önce

## Kurallar
- Kodda gizli anahtar yok, yalnızca ortam değişkenleriyle
- Conventional Commits’e göre küçük commit’ler

İpucu:CLAUDE.md bir bağlamdır, kilit değildir. Asla olmaması gereken şeyler için ek olarak bir deny kuralı veya hook kullanın.

Skill’ler

Skill, sürüm çıkarma veya çeviri gibi tekrar eden bir görevi anlatan SKILL.md dosyası içeren bir klasördür. Açıklama isteğinize uyduğunda Claude onu kendisi yükler ya da siz onu /ad ile doğrudan çağırırsınız. Avantajı: Talimatlar projede bir kez durur ve yalnızca gerektiğinde yüklenir. Proje skill’leri .claude/skills/ içinde, kişisel olanlar ~/.claude/skills/ içinde bulunur.

# .claude/skills/release/SKILL.md
---
name: release
description: Bir sürümü hazırlar. Sürüm veya yeni versiyon istediğimde kullan.
disable-model-invocation: true
---

1. npm run test çalıştır, hata varsa dur.
2. Son etiketten bu yana yapılan commit’lerden changelog yaz.
3. SemVer’e göre sürüm numarası öner ve onayımı bekle.

İpucu:Claude’un skill’i ne zaman yükleyeceğine description karar verir. Ne yaptığını ve ne zaman uygun olduğunu yazın. disable-model-invocation: true ile onu yalnızca siz başlatabilirsiniz; deploy veya sürüm gibi sonuçları olan işler için mantıklıdır.

Hook’lar

Hook’lar, Claude Code’un belirli olaylarda çalıştırdığı kabuk komutlarıdır. CLAUDE.md içindeki bir kuralın aksine, Claude ne karar verirse versin her zaman çalışırlar. Önemli olaylar şunlardır: PreToolUse (bir araçtan önce, onu engelleyebilir), PostToolUse (sonrasında), Stop (Claude bitirdiğinde) ve SessionStart. Hook’lar bir settings.json dosyasının "hooks" bloğunda durur; /hooks tüm etkin hook’ları gösterir.

// .claude/settings.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\""
          }
        ]
      }
    ]
  }
}

İpucu:Örnek, Claude Code’un hook’a ilettiği verilerden dosya yolunu okuyan jq aracını gerektirir. Çıkış kodu 2 ile biten bir PreToolUse hook’u işlemi engeller ve nedeni Claude’a geri bildirir.

Alt ajanlar (subagent)

Alt ajan, kendi bağlam penceresi olan uzmanlaşmış bir yardımcıdır. Claude ona kod incelemesi veya geniş bir arama gibi bir alt görev verir ve geriye yalnızca özeti alır. Böylece ana sohbetiniz sade kalır. Bir alt ajanın araçlarını sınırlayabilirsiniz, örneğin yalnızca okumaya. Proje alt ajanları .claude/agents/ içinde, kişisel olanlar ~/.claude/agents/ içinde bulunur.

# .claude/agents/code-reviewer.md
---
name: code-reviewer
description: Değişiklikleri hata, okunabilirlik ve güvenlik açısından inceler. Her büyük değişiklikten sonra kullan.
tools: Read, Glob, Grep
model: sonnet
---

Kodu incelersin. Somut sorunları dosya ve satırla belirt
ve bir çözüm öner. Kendin hiçbir şeyi değiştirme.

İpucu:Yalnızca name ve description zorunludur. Frontmatter’ın altındaki metin, alt ajanın çalışırken uyduğu talimattır. tools belirtilmezse ana oturumun tüm araçlarını devralır.

MCP: harici araçları bağlama

Model Context Protocol (MCP) ile Claude Code’u bir veritabanı, bir bilet sistemi veya kendi hizmetiniz gibi başka araçlara ve veri kaynaklarına bağlarsınız. /mcp hangi sunucuların bağlı olduğunu gösterir. Bir sunucuyu nasıl kuracağınızı ve güvenlik açısından nelere dikkat etmeniz gerektiğini “MCP sunucusu bağlama” kılavuzunda ayrıntılı olarak anlatıyorum.

Nasıl çalışıyorum

Büyük görevlerde Claude’a önce plan yaptırıyorum (plan modu için Shift + Tab), sonra uyguluyorum. Her değişikliği diff’te kontrol ediyorum, her commit’ten önce testler çalışıyor. Claude benim sparring partnerim; anlamak yine benim işim.

  1. Önce plan: Plan modunda hedefi anlatıyorum ve herhangi bir dosya değişmeden önce planı okuyorum.
  2. Küçük adımlar: Tek bir dev görev yerine birkaç kısa görev. Bu, bağlamı temiz ve diff’i okunabilir tutar.
  3. Diff’i kontrol etmek: Her değişikliği kabul etmeden önce okuyorum.
  4. Commit’ten önce testler, ardından açık bir mesajla küçük bir commit.
  5. Yeni görev, yeni bağlam: Bir konu bittiğinde /clear ile yeniden başlıyorum.

Sık karşılaşılan sorunlar ve çözümler

Sorunların çoğu fazla bağlamdan, çok büyük görevlerden veya eksik kurallardan kaynaklanır. En sık karşılaşacağınız durumlar şunlardır:

  1. Yanıtlar belirsizleşiyor veya Claude anlaşılanları unutuyor: Bağlam dolmuştur. /context ile kontrol edin, ardından /compact (isterseniz özetin neye odaklanacağını belirterek) ya da yeni bir konu için /clear kullanın.
  2. Claude büyük bir görevde yolunu kaybediyor: Esc ile durdurun, görevi plan modunda alt adımlara bölün ve tek tek uygulayın.
  3. Bir değişiklik yanlıştı: /rewind ile veya iki kez Esc’e basarak önceki bir duruma dönün.
  4. Sürekli onay soruları: Testler gibi güvenli ve tekrar eden komutları allow kuralı olarak ekleyin ya da yalnızca dosya işleri için acceptEdits moduna geçin.
  5. Claude bir kuralı görmezden geliyor: CLAUDE.md çok uzun ya da çok belirsiz. Kısaltın, kuralları somut yazın ve önemli olanları bir hook veya deny kuralıyla güvenceye alın.

Kontrol listesi

Bu maddeler tamamlandığında Claude Code günlük kullanım için hazırdır:

  1. claude --version bir sürüm numarası gösteriyor, /status doğru hesabı gösteriyor.
  2. Projede komutları ve kesin kuralları içeren kısa bir CLAUDE.md var.
  3. .claude/settings.json olağan komutlara izin veriyor, .env ve gizli bilgileri engelliyor.
  4. Her değişiklikten sonra bir biçimlendirme hook’u çalışıyor.
  5. Tekrar eden iş akışları skill olarak tanımlanmış.
  6. Plan modunu, Esc’i, /compact ve /clear komutlarını biliyorsunuz.

Diğer notlar

Gizlilik

İzleme çerezi yok

Burada hakkınızda hiçbir veri toplanmaz.

Tarayıcınızın hatırladıkları

Bunların hiçbiri analiz için kullanılmaz.

Gizlilik politikasını okuyun