Claude Code Nedir? Web Geliştiriciler İçin Rehber

Claude Code, Anthropic’in geliştirdiği bir kodlama ajanıdır: projenizin dosyalarını okur, düzenler, komut çalıştırır ve git ile çalışır. Dokümandaki tanıma göre kod tabanınızı okuyan, dosyaları düzenleyen, komut çalıştıran ve geliştirme araçlarınızla entegre olan bir araçtır.

Sohbet penceresine kod yapıştırmak yerine, Claude’u projenizin klasöründe çalıştırırsınız. Bu yazıda Claude Code’un ne olduğunu, nasıl kurulacağını ve web geliştirme işlerinde nasıl güvenle kullanılacağını Anthropic’in resmi dokümanına dayanarak anlatıyorum.

Claude Code ne yapar?

Claude Code, bir komut ya da istek verdiğinizde projedeki dosyaları kendisi bulur ve okur. Bağlamı elle yapıştırmanız gerekmez. Dokümandaki başlıca kullanım alanları şunlar:

• Özellik eklemek ve hata düzeltmek: isteği düz Türkçe ya da İngilizce yazarsınız; Claude yaklaşımı planlar, birden fazla dosyada kod yazar.
• Testleri yazmak, lint hatalarını düzeltmek, bağımlılıkları güncellemek, sürüm notu hazırlamak gibi can sıkıcı işleri üstlenmek.
• Commit oluşturmak, dal açmak ve pull request göndermek.
• MCP ile dış araçlara bağlanmak.
• Betiklerle ve CI içinde çalışmak: claude -p "..." tek seferlik sorguyu çalıştırıp çıkar.

Dokümana göre Claude Code şu ortamlarda çalışır: terminal, VS Code, JetBrains IDE’leri, masaüstü uygulaması ve web. Hepsi aynı motoru kullanır; deponuzdaki CLAUDE.md dosyaları, ayarlar ve MCP sunucuları her yerde geçerlidir.

Claude Code kimin için uygun?

Dosyalarıyla çalışan herkes için, ama özellikle tema ve eklenti geliştiren, bakım yapan ya da çok dosyalı değişikliği elle yapmak istemeyen web geliştiriciler için. Birkaç gerçekçi örnek:

• Bir temada eski bir fonksiyonu kullanan tüm dosyaları bulup güncellemek.
• Bir bileşen için test yazmak, çalıştırmak, hatalıları düzeltmek.
• Tanımadığınız bir projeye girerken “bu projede yönlendirme nasıl çalışıyor?” diye sormak.

Hızlı, tek satırlık düzeltme istiyorsanız editördeki otomatik tamamlama yeterli olabilir. Claude Code, birden çok adımlı ve birden çok dosyalı işlerde fark yaratır.

Claude Code ile sohbet arayüzü arasındaki fark

İkisi de aynı model ailesini kullanır, ama çalışma biçimleri farklıdır:

Pratik sonuç: küçük bir kod parçasını sormak için sohbet yeterli. Aynı değişikliği on dosyada yapmak, sonra derleyip hataları düzeltmek için Claude Code daha uygun.

Genişletme: skill, hook ve alt ajanlar

Resmi dokümanda dört genişletme mekanizması öne çıkar:

• Skill: Tekrar eden iş akışlarını paketler; /review-pr ya da /deploy-staging gibi.
• Hook: Claude Code eylemlerinden önce ya da sonra kabuk komutu çalıştırır; örneğin her dosya düzenlemesinden sonra otomatik biçimlendirme. Bir kuralın kesinlikle uygulanması gerekiyorsa CLAUDE.md değil, hook kullanılır.
• MCP: Dış araç ve veri kaynaklarına bağlanır. Claude Code içinde bir MCP sunucusu eklemek için claude mcp add komutu kullanılır.
• Alt ajanlar: Bir görevin farklı parçalarını paralel çalışan ajanlara dağıtır.

İlk günlerde bunların hiçbirine ihtiyacınız yok. Önce temel akışı oturtun, sonra tekrar eden bir iş çıkınca skill ya da hook düşünün.

Bir web projesinde tipik akış

Örnek olarak bir WordPress temasında eski bir fonksiyonu yenisiyle değiştirmek isteyelim. Akış şöyle ilerler:

1. Temanın klasöründe claude --permission-mode plan ile başlatın.
2. İsteği somut yazın: “old_helper() fonksiyonunu kullanan tüm şablonları bul ve hangi dosyalarda geçtiğini listele.”
3. Listeyi okuyun, planı onaylayın.
4. Normal moda dönüp değişikliği yaptırın; her düzenlemeyi izin isteğinde görün.
5. git diff ile tüm değişikliği gözden geçirin.
6. Derleme ya da PHP sözdizimi kontrolü gibi bir doğrulama çalıştırın ve çıktıyı okuyun.
7. Staging’de deneyin, sonra canlıya alın.

Bu akışta Claude Code işin yükünü alır, kararı ve son kontrolü size bırakır.

Gereksinimler ve plan

Resmî kurulum ve hızlı başlangıç sayfalarına göre şunlar gerekir:

• Bir terminal ve üzerinde çalışacağınız bir proje.
• İşletim sistemi: macOS 13+, Windows 10 1809+, Ubuntu 20.04+, Debian 10+ ya da Alpine 3.19+; en az 4 GB RAM ve internet bağlantısı. Native Windows’ta Git for Windows önerilir; WSL kurulumunda gerekmez.
• Bir Claude aboneliği (Pro, Max, Team ya da Enterprise), bir Claude Console hesabı ya da desteklenen bir bulut sağlayıcı üzerinden erişim.

Fiyat sayfasına göre (claude.com/pricing) Claude Code, Pro, Max ve Team planlarında yer alır; Free planda yoktur. Fiyatlar ve limitler sık değiştiği için güncel rakamı Anthropic fiyat sayfasından kontrol edin.

Claude Code kurulumu

Önerilen yol yerel kurulumdur. Komutlar resmi dokümandan alınmıştır.

macOS, Linux ve WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Alternatifler: macOS için Homebrew (brew install --cask claude-code), Windows için WinGet (winget install Anthropic.ClaudeCode). Doküman ayrıca apt, dnf ve apk ile kurulumu da anlatır.

Kurulum sırasında ilerleme görünmeyebilir. Bitince yeni bir terminal açıp doğrulayın:

claude --version

Sürüm numarası çıkıyorsa kurulum tamamdır. “claude bulunamadı” derse kurulum dizini PATH’inizde değildir; çözüm resmi kurulum sorun giderme sayfasında. Yerel kurulum arka planda kendini günceller; Homebrew ve WinGet kurulumları güncellenmez, elle yükseltmeniz gerekir.

İlk oturum

Proje klasörüne girip claude yazın:

cd /projenin/yolu
claude

İlk çalıştırmada tarayıcıda giriş yapmanız istenir. Sonrasında kimlik bilgileriniz saklanır. Açılan istemde şu soruyla başlamak iyi bir alışkanlıktır:

bu proje ne yapıyor ve hangi teknolojileri kullanıyor?

Claude dosyaları kendisi okuyup özetler. Küçük bir değişiklikle devam edebilirsiniz; önerdiği düzenlemeyi gösterir ve izin ister.

Temel komutlar

İzin modları: Claude ne yapabilir?

Claude Code’un güvenliği izin sistemine dayanır. İzin modları dokümanına göre başlıca modlar:

• default (Manual): Okumaları sormadan yapar; düzenleme, kabuk komutu ve ağ erişiminden önce sorar.
• acceptEdits: Çalışma klasöründeki dosya düzenlemelerini ve yaygın dosya komutlarını sormadan yapar.
• plan: Önce inceler ve değişiklik önerir; siz planı onaylamadan kaynak dosyaları düzenlemez.
• auto: Rutin sorular olmadan çalışır; bir sınıflandırıcı riskli eylemleri engeller.
• bypassPermissions: Hiçbir kontrol yapmaz. Dokümana göre yalnızca yalıtılmış konteyner ya da sanal makinede kullanılmalıdır.

Başlangıç modu sürüme ve ayarlara bağlıdır. Dokümana göre v2.1.283 ve sonrasında etkileşimli terminal ve VS Code oturumları auto modda başlar; claude -p ise Manual modda çalışır. Başlangıç modunu permissions.defaultMode ayarıyla da seçebilirsiniz. Auto modda rutin işlemler için izin sorusu çıkmayabilir. Her adımı görmek istiyorsanız Shift+Tab ile default (Manual) moda geçin: auto’dan ilk basış default’a götürür, sonraki basışlar sırayla acceptEdits ve plan modlarına geçer.

Plan modunda başlatmak için:

claude --permission-mode plan

Bir istem için plan modu istiyorsanız başına /plan yazın. Web projesinde alışılmadık ya da çok dosyalı bir değişiklikte plan modu iyi bir ilk adımdır: önce planı okur, sonra onaylarsınız.

CLAUDE.md ile projenizi tanıtın

Her oturum sıfır bağlamla başlar. Kalıcı talimatlar için proje köküne bir CLAUDE.md yazın; Claude bunu her oturum başında okur. Bellek dokümanı şunu da belirtir: Claude CLAUDE.md içeriğini zorunlu yapılandırma değil, bağlam olarak ele alır. Kuralın kesinlikle uygulanmasını istiyorsanız hook kullanmanız gerekir.

Bir web projesi için faydalı içerik şunlar:

# Proje notları
- Geliştirme: `npm run dev`, derleme: `npm run build`
- İçerik `src/content/` altındadır; dosya adları küçük harf ve tire.
- `.env` dosyasını okuma ya da değiştirme.
- Bir değişiklikten sonra `npm run build` hatasız bitmeli.

Kısa ve somut yazın; talimat ne kadar belirliyse o kadar tutarlı uygulanır.

Güvenli kullanım: gizli dosyalar ve onaylar

Claude Code çalışmak için dosya içeriklerini okur. Parola ya da anahtar içeren dosyaları engellemek için izin ayarlarında Read deny kuralı kullanın. İzin dokümanındaki örnek biçimler Read(./.env) ve Read(./secrets/**):

{
  "permissions": {
    "deny": ["Read(./.env)", "Read(./secrets/**)"]
  }
}

Bu ayarı .claude/settings.json içine yazarsınız. Ayrıca:

• Canlı sunucuya doğrudan bağlanmayın; önce yerel ya da staging kopyada çalışın.
• Git kullanın. Claude’un yaptığı değişiklikleri git diff ile inceleyin ve küçük commit’ler atın; sorun çıkarsa geri dönmek kolay olur.
• Bir MCP sunucusu eklemeden önce ona güvenip güvenmediğinizi düşünün. Claude Code dokümanı, dış içerik çeken sunucuların prompt injection riski taşıdığı uyarısını yapar.

Daha iyi sonuç almak

En iyi uygulamalar sayfası iki noktayı öne çıkarır: Claude’a gördüğünüzü ama onun göremediğini anlatın ve işin bittiğini kontrol edebileceği bir sınama verin. Pratikte:

• “Hatayı düzelt” yerine: “Yanlış parola girilince giriş formunun boş ekran göstermesi hatasını düzelt, sonra npm run build çalıştır.”
• Karmaşık işi adımlara bölün. Önce Claude’dan projeyi incelemesini isteyin, sonra değiştirmesini.
• Bitti demeden önce derleme, test ya da lint çalıştırmasını isteyin; çıktıyı siz de okuyun.

Sık yapılan hatalar

• Belirsiz istek vermek. “Siteyi düzelt” yerine hangi sayfada hangi davranışın bozuk olduğunu yazın. Hata mesajını olduğu gibi yapıştırın.
• Çıktıyı okumamak. Claude değişiklik yaptığında git diff ile bakmak sizin işiniz. Derlemenin geçmesi, davranışın doğru olduğu anlamına gelmez.
• Çok uzun oturum. Her oturum sıfır bağlamla başlar ve konuşma uzadıkça eski ayrıntılar kaybolabilir. Konu değiştirdiğinizde /clear kullanın ya da yeni oturum açın.
• Gizli dosyaları açıkta bırakmak. .env gibi dosyalar için deny kuralı yazmadan çalışmaya başlamayın.
• İzinleri toptan açmak. Her şeyi onaylayan bir mod kolay görünür, ama ne yapıldığını görmenizi engeller. İzin vermek istediğiniz komutları tek tek ekleyin.

Kurulumun çalıştığını doğrulama

1. claude --version sürüm yazıyor mu?
2. claude ile oturum açılıyor ve giriş tamamlanıyor mu?
3. “Bu dizindeki dosyaları listele” isteği doğru klasörü gösteriyor mu?
4. Bir dosya düzenleme isteğinde izin sorusu çıkıyor mu? Çıkmıyorsa auto modda olabilirsiniz; Shift+Tab ile hangi modda olduğunuza bakın.
5. claude doctor kurulumun sağlığını ve ayar uyarılarını yazdırır. Güncellemeyi elle başlatmak için claude update çalıştırın.

Sonraki adım

Claude Code, bir WordPress sitesinin dosyalarında (tema, eklenti) çalışmak için uygundur. Sitenin içeriğini ve ayarlarını yönetmek içinse MCP bağlantısı gerekir; seçenekleri Claude WordPress bağlantısı yöntemleri yazısında karşılaştırdım. Claude ile bir sitenin nasıl kurulacağına ve nelerin beklentinin altında kaldığına Claude ile web sitesi yapma yazısında bakıyorum.

Bir projeniz için Claude Code iş akışı kurmak ya da bir geliştirme işini devretmek isterseniz hizmetlerime göz atabilir ya da bana yazabilirsiniz.