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.
- Abonelik: Claude Pro veya Max (Team ve Enterprise da olur). Kullanım sınırları olan sabit bir aylık ücret ödersiniz.
- 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.
- Proje klasöründe claude yazın ve tarayıcıdaki giriş adımlarını izleyin.
- /status ile hangi hesabın ve hangi modelin etkin olduğunu kontrol edin.
- /logout ile çıkış yapın, /login ile yeniden giriş yapın.
cd projem
claudeDikkat: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.
- Projede /init yazın ve oluşturulan CLAUDE.md dosyasını okuyun.
- Kesin kuralları ekleyin; örneğin repoya asla girmemesi gerekenler veya testlerin nasıl çalıştığı.
- 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.
- Önce plan: Plan modunda hedefi anlatıyorum ve herhangi bir dosya değişmeden önce planı okuyorum.
- Küçük adımlar: Tek bir dev görev yerine birkaç kısa görev. Bu, bağlamı temiz ve diff’i okunabilir tutar.
- Diff’i kontrol etmek: Her değişikliği kabul etmeden önce okuyorum.
- Commit’ten önce testler, ardından açık bir mesajla küçük bir commit.
- 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:
- 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.
- 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.
- Bir değişiklik yanlıştı: /rewind ile veya iki kez Esc’e basarak önceki bir duruma dönün.
- 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.
- 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:
- claude --version bir sürüm numarası gösteriyor, /status doğru hesabı gösteriyor.
- Projede komutları ve kesin kuralları içeren kısa bir CLAUDE.md var.
- .claude/settings.json olağan komutlara izin veriyor, .env ve gizli bilgileri engelliyor.
- Her değişiklikten sonra bir biçimlendirme hook’u çalışıyor.
- Tekrar eden iş akışları skill olarak tanımlanmış.
- Plan modunu, Esc’i, /compact ve /clear komutlarını biliyorsunuz.
Diğer notlar
- RehberYapay zekâ ile n8nYapay zekâ ile e-postaları sınıflandıran, belgelerden veri okuyan ve yanıt öneren n8n iş akışları kurmak. Kurulum, hata yönetimi, veri koruma ve işletim dahil.
- RehberMCP sunucusu bağlamaClaude’u Model Context Protocol ile kendi verilerinize ve araçlarınıza güvenli ve adım adım nasıl bağlayacağınız.
- NotConditional Access einführen, ohne sich auszusperrenConditional Access ist mächtig, und genau das macht es riskant. Eine einzige Richtlinie mit „Alle Benutzer, alle Ressourcen, Zugriff blockieren“ sperrt die ganze Organisation aus, die Admins eingeschlossen. Die meisten Probleme entstehen nicht durch exotische Einstellungen, sondern weil eine Richtlinie direkt scharf geschaltet wird, ohne sie vorher zu testen.