Claude Code, Anthropic'in yapay zekâ destekli kodlama aracı. Projenizin klasöründe çalışıyor: kod tabanını kendisi okuyor, dosyaları düzenliyor, terminalde komut çalıştırıyor, git ile commit ve PR açabiliyor. Terminalde, VS Code ve JetBrains eklentilerinde, masaüstü uygulamasında ve tarayıcıda kullanılabiliyor.

İstanbul'da yazılım geliştiriyorum ve benim Claude Code'um laptopumda değil, bir Ubuntu sunucuda çalışıyor, çoğu zaman birden fazla ajan aynı anda. Bu yazıda Claude Code'un ne olduğunu, nasıl kurulduğunu ve ilk günden işinize yarayacak komutları anlatıyorum. Kurulum adımlarını ve özellikleri Anthropic'in resmî dokümantasyonuyla karşılaştırarak yazdım.

Claude Code nedir?

Bir sohbet arayüzünde kod sorduğunuzda süreç şöyle işler: kodu kopyalarsınız, yapıştırırsınız, cevabı alıp kendi dosyanıza taşırsınız, hata alırsanız hatayı yine kopyalayıp yapıştırırsınız. Claude Code bu döngüyü projenin içine taşıyor.

Anthropic onu "agentic" bir kodlama aracı olarak tanımlıyor. Bir görev verdiğinizde Claude Code ilgili dosyaları kendisi buluyor ve okuyor, bir plan çıkarıyor, değişikliği yapıyor, testleri ya da build komutunu çalıştırıp sonucuna bakıyor ve gerekirse tekrar düzeltiyor. Dosya düzenlemek ya da komut çalıştırmak gibi adımlarda, ayarlarınıza göre önce sizden onay istiyor. Neyi kendi başına yapacağına, neyi size soracağına siz karar veriyorsunuz.

Claude Code ne işe yarar?

Dokümantasyonda geçen başlıca kullanım alanları:

  • Kod tabanını anlamak: "bu proje ne yapıyor", "giriş noktası nerede", "bu klasör yapısını açıkla".
  • Özellik eklemek ve bug düzeltmek: hatayı ya da istediğiniz davranışı yazıyorsunuz, kodu birden fazla dosyada değiştiriyor.
  • Test yazmak, lint hatalarını düzeltmek, merge conflict çözmek, bağımlılık güncellemek.
  • Git işleri: değişiklikleri özetlemek, commit mesajı yazmak, branch açmak, PR hazırlamak.
  • Script ve CI içinde çalışmak: claude -p ile tek seferlik bir görev verip sonucu almak.

Terminalden tek bir komutla da görev verebilirsiniz:

claude "auth modülü için test yaz, çalıştır ve hata varsa düzelt"

İstekleri Türkçe yazabilirsiniz. Anthropic'e göre Claude, standart Unicode kullanan dillerin çoğunda girdi alıp çıktı üretebiliyor.

Claude Code nasıl kurulur?

Önerilen yöntem Anthropic'in kendi kurulum scripti. macOS, Linux ve WSL için:

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

Windows PowerShell için:

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

Bu yöntemle kurulan Claude Code arka planda kendini güncelliyor. Diğer seçenekler:

# macOS, Homebrew
brew install --cask claude-code

# Windows, WinGet
winget install Anthropic.ClaudeCode

# npm (Node.js 22 veya üstü gerekiyor, sudo kullanmayın)
npm install -g @anthropic-ai/claude-code@latest

Debian, Ubuntu, Fedora, RHEL ve Alpine için apt, dnf ve apk depoları da var. Homebrew, WinGet ve paket yöneticisi kurulumları kendiliğinden güncellenmiyor, brew upgrade claude-code ya da winget upgrade Anthropic.ClaudeCode gibi komutlarla güncellemeniz gerekiyor.

Kurulumdan sonra yeni bir terminal açıp kontrol edin:

claude --version
claude doctor

claude --version sürüm numarasını yazıyor. claude doctor oturum başlatmadan kurulumu ve ayar dosyalarını kontrol edip sorun varsa öneriyle birlikte gösteriyor.

Sistem gereksinimleri

Dokümantasyona göre: macOS 13.0 ve üstü, Windows 10 1809 ve üstü ya da Windows Server 2019 ve üstü, Ubuntu 20.04, Debian 10 ve Alpine Linux 3.19 ve üstü. En az 4 GB RAM, x64 ya da ARM64 işlemci ve internet bağlantısı gerekiyor. Windows'ta yerel olarak ya da WSL içinde çalıştırabiliyorsunuz. Yerel Windows'ta Git for Windows kuruluysa Claude Code komutları Git Bash ile, değilse PowerShell ile çalıştırıyor.

Claude Code ücretsiz mi, hangi hesapla kullanılır?

Ücretsiz Claude planı Claude Code'u kapsamıyor. Kullanmak için şunlardan biri gerekiyor:

  • Ücretli bir Claude aboneliği: Pro, Max, Ultra, Team ya da Enterprise.
  • API erişimi ve ön ödemeli kredi ile çalışan bir Claude Console hesabı.
  • Kurumsal tarafta Amazon Bedrock, Google Cloud ya da Microsoft Foundry üzerinden erişim.

Güncel fiyatlar için claude.com/pricing sayfasına bakın, fiyatları burada yazmıyorum çünkü değişebiliyorlar.

İlk oturum: Claude Code nasıl kullanılır?

Projenizin klasörüne gidip başlatın:

cd ~/projeler/benim-uygulamam
claude

İlk açılışta giriş yapmanızı istiyor. Tarayıcıda açılan sayfadan hesabınızla onaylıyorsunuz. ANTHROPIC_API_KEY ortam değişkeni tanımlıysa ve kullanılmasını onaylarsanız giriş adımı atlanıyor. Tarayıcısı olmayan bir sunucuda giriş linkini kendi bilgisayarınızda açıp kodu terminale yapıştırmanız yeterli, bunu sunucu yazımda anlattım.

Sonra normal bir dille yazıyorsunuz:

bu proje ne yapıyor, hangi teknolojileri kullanıyor?
kayıt formuna e-posta doğrulaması ekle
değişikliklerimi özetle ve açıklayıcı bir mesajla commit et

Claude Code bir dosyayı değiştirmeden önce farkı gösterip onay istiyor. Bağlamı sizin vermeniz gerekmiyor, ihtiyaç duyduğu dosyaları kendisi okuyor.

Claude Code temel komutları

Terminalden:

KomutNe yapar
claudeEtkileşimli oturum başlatır
claude "görev"Oturumu bir ilk istekle başlatır
claude -p "soru"Tek seferlik çalışır, cevabı yazar ve çıkar
claude -cBu klasördeki son konuşmaya devam eder
claude -rÖnceki bir konuşmayı seçip devam ettirir
claude updateGüncellemeyi hemen uygular

Oturumun içinden:

KomutNe yapar
/helpKullanılabilir komutları listeler
/initProjeyi inceleyip bir başlangıç CLAUDE.md dosyası oluşturur
/clearYeni bir konuşma başlatır
/resumeÖnceki bir konuşmaya döner
/memoryCLAUDE.md dosyalarını açıp düzenlemenizi sağlar
/loginHesap değiştirir ya da yeniden giriş yapar
/exitClaude Code'dan çıkar

/ yazınca kullanılabilir komutlar ve skill'ler listeleniyor. Shift+Tab izin modları arasında geçiş yapıyor.

-p ile çalışma modu Claude Code'u Unix araçlarıyla birleştirmenin yolu:

git diff main --name-only | claude -p "bu değişen dosyaları güvenlik açısından incele"

Bu modun ayrıntıları için İngilizce Claude Code headless yazısına bakabilirsiniz.

CLAUDE.md nedir?

Her Claude Code oturumu temiz bir bağlamla başlıyor. CLAUDE.md, Claude Code'un her oturumun başında okuduğu bir Markdown dosyası. İçine projenin build ve test komutlarını, kod standartlarını, mimari kararları yazıyorsunuz ve her seferinde tekrar anlatmanız gerekmiyor.

Dosyanın birkaç yeri var:

  • ./CLAUDE.md ya da ./.claude/CLAUDE.md: projeye ait, git ile ekiple paylaşılır.
  • ~/.claude/CLAUDE.md: sizin kişisel tercihleriniz, bütün projelerde geçerli.
  • ./CLAUDE.local.md: projeye özel ama sadece size ait notlar, .gitignore'a eklenir.

En kolay başlangıç /init: Claude Code projeyi inceleyip build komutları ve bulduğu kurallarla bir CLAUDE.md yazıyor. Siz de Claude'un koddan çıkaramayacağı şeyleri ekliyorsunuz. Bir NestJS projesi için örnek:

# Proje notları

- Paket yöneticisi pnpm. npm ya da yarn kullanma.
- Testler: `pnpm test`, tek dosya için `pnpm test notes.service`.
- Veritabanı değişiklikleri sadece migration ile yapılır, `synchronize` açılmaz.
- Yeni endpoint'lerde DTO ve class-validator kullan.

Projede başka kodlama ajanları için yazılmış bir AGENTS.md varsa ve CLAUDE.md yoksa Claude Code onu da okuyabiliyor.

İzin modları

Claude Code'un ne kadar serbest çalışacağını izin modu belirliyor. Başlıcaları:

ModSormadan ne yapar
defaultÇalışma klasöründeki dosyaları okur, gerisinde onay ister
acceptEditsDosya düzenlemelerini ve mkdir, mv gibi yaygın dosya komutlarını onaysız yapar
planOkur ve plan çıkarır, değişiklik yapmadan önce planı size sunar
bypassPermissionsHer şeyi sormadan yapar

Shift+Tab ile oturum içinde modlar arasında geçiyorsunuz. bypassPermissions ancak Claude Code'u bunu açan bir bayrak ya da ayarla başlatırsanız listede çıkıyor ve sadece izole bir ortamda, örneğin bir container ya da kendinize ait bir sunucuda mantıklı. Kendi bilgisayarınızda, önemli dosyaların yanında kullanmayın.

Claude Code'u genişletmek: skill, hook ve MCP

Claude Code'u kendi iş akışınıza göre şekillendirmenin üç yolu var.

Skill'ler, SKILL.md dosyasına yazılmış talimat paketleri. Kişisel olanlar ~/.claude/skills/<isim>/SKILL.md, projeye ait olanlar .claude/skills/<isim>/SKILL.md altında duruyor ve /isim ile çağrılıyor. Claude ilgili olduğunu düşündüğünde kendisi de yükleyebiliyor. Kendi skill'inizi yazmak için İngilizce Claude Code skills yazısına bakabilirsiniz. Benim yazdığım explain-to-customer bir skill örneği: bir kod değişikliğini müşteriye anlatan kısa bir video, slaytlar ve Mermaid diyagramları hazırlıyor. Kurulumu:

npx skills add halitsever/explain-to-customer -g -a claude-code

Hook'lar, Claude Code'un belirli anlarında çalışan shell komutları. Her dosya düzenlemesinden sonra formatter çalıştırmak ya da Claude bir cevap beklerken telefonunuza bildirim göndermek gibi. Ben ikincisini ntfy.sh ile kullanıyorum.

MCP (Model Context Protocol), Claude Code'u dış araçlara ve veri kaynaklarına bağlayan açık bir standart. Uzak bir MCP sunucusu eklemek tek komut:

claude mcp add --transport http notion https://mcp.notion.com/mcp
claude mcp list

Oturum içinde /mcp bağlı sunucuların durumunu gösteriyor ve OAuth isteyen sunucularda giriş yapmanızı sağlıyor.

Claude Code'u sunucuda ve paralel çalıştırmak

Uzun süren bir görev, laptop uykuya geçti diye yarıda kalmamalı. Ben bu yüzden onu bir Ubuntu sunucuda, tmux içinde çalıştırıyorum. Bunun için iki açık kaynak araç yazdım:

  • claude-code-vps: boş bir Ubuntu sunucusunu tek komutla Claude Code çalıştıracak hale getiriyor. Sudo kullanıcısı, sadece anahtarla SSH, ufw, RDP üzerinden KDE Plasma masaüstü, Docker ve Claude Code kuruluyor.
  • claudegrid: tek komutla bir grid halinde birden fazla Claude Code ajanı açıyor. Her panele ayrı bir görev, model ve istenirse ayrı bir git worktree veriyor, böylece ajanlar aynı dosyaları düzenlemiyor.
npm install -g @halitsever/claudegrid
claudegrid -b tmux -w

Bütün kurulumu, bildirimleri ve iş akışımı birden fazla Claude Code ajanını sunucuda paralel çalıştırma yazısında komutlarıyla anlattım. İki araç da MIT lisanslı ve Anthropic ile bir bağlantısı yok.

Sık sorulan sorular

Claude Code ücretsiz mi?

Hayır. Ücretsiz Claude planında yok. Pro, Max, Ultra, Team, Enterprise aboneliği ya da Claude Console hesabı gerekiyor.

Claude Code Windows'ta çalışır mı?

Evet. Windows 10 1809 ve üstünde PowerShell ya da CMD ile yerel olarak kurulabiliyor, WSL içinde de çalışıyor.

Claude Code internet olmadan çalışır mı?

Hayır. Dokümantasyona göre internet bağlantısı gerekiyor, çünkü model Anthropic'in ya da seçtiğiniz bulut sağlayıcının sunucularında çalışıyor.

Claude Code ile Claude sohbet uygulaması arasındaki fark ne?

Sohbet uygulamasında kodu siz taşıyorsunuz. Claude Code ise projenizin içinde çalışıyor: dosyaları kendisi okuyor, düzenliyor ve komut çalıştırıyor.

Claude Code'u kaldırmak için ne yapmalıyım?

Kurulum scriptiyle kurduysanız macOS ve Linux'ta rm -f ~/.local/bin/claude ve rm -rf ~/.local/share/claude yeterli. Ayarları da silmek isterseniz ~/.claude klasörünü ve ~/.claude.json dosyasını kaldırın.