Claude Code nasıl kurulur? Ücretsiz değil, Skills ve Artifacts var

Claude Code, Anthropic’in terminalde ve editörde çalışan kodlama ajanı ve tek bir komutla kuruluyor [1]. Kurulumdan önce iki şeye bakman gerekiyor: bilgisayarın gereksinimleri karşılıyor mu ve ücretli bir Claude planın var mı? Anthropic’e göre Claude Code ücretsiz claude.ai planında yok; Pro, Max, Ultra, Team, Enterprise ya da bir Console hesabı gerekiyor [1].

Bu yazıda kurulumu işletim sistemine göre anlatıyoruz. Sonra terminalsiz yol olan masaüstü uygulamasına, /init ile CLAUDE.md’ye, Skills ile kendi eğik çizgi kodunu yazmaya ve Artifacts’a geçiyoruz. Komutlar resmî belgeden aynen aktarıldı; masaüstü uygulamasını ise videoda gerçek ekranda denedik.

Önce videoyu izle

Masaüstü uygulamasını indirmeyi, hesap açmayı, planları, Code sekmesini ve kendi /neon kodumuzu 14 dakikalık Türkçe videoda sıfırdan gösterdik [10].

YouTube’da izle: Claude nasıl kullanılır? İndirme, abonelik, kod bilmeden oyun ve web sitesi

Sistem gereksinimleri

Anthropic’in kurulum belgesi şu gereksinimleri sıralıyor [1]:

Gereksinim	Asgari
macOS	13.0 ve sonrası
Windows	Windows 10 sürüm 1809 ve sonrası ya da Windows Server 2019
Linux	Ubuntu 20.04, Debian 10, Alpine 3.19 ve sonrası
Bellek	4 GB RAM
İşlemci	x64 ya da ARM64
Kabuk	Bash, Zsh, PowerShell ya da CMD

İnternet bağlantısı şart ve Claude Code yalnızca Anthropic’in desteklediği ülkelerde çalışıyor [1].

Kurulum adımları

macOS ve Linux’ta kurulum

1. Terminali aç.
2. Şu komutu yapıştırıp çalıştır: curl -fsSL https://claude.ai/install.sh | bash
3. Kurulum bitince yeni bir terminal penceresi aç.
4. claude --version yaz; bir sürüm numarası görmelisin [1].

Komut indirirken ilerleme göstermediği için biraz beklemen gerekiyor [1]. Homebrew kullanıyorsan brew install --cask claude-code da çalışıyor. Bu kanal kendiliğinden güncellenmiyor; güncellemek için brew upgrade claude-code gerekiyor [1].

Windows’ta kurulum

Önce hangi kabukta olduğunu anlaman gerekiyor, çünkü komutlar kabuğa göre değişiyor. PowerShell’de istem PS C:\ ile, CMD’de PS olmadan C:\ ile başlıyor [1].

1. PowerShell’deysen şunu çalıştır: irm https://claude.ai/install.ps1 | iex
2. CMD’deysen şunu çalıştır: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
3. Yeni bir terminal aç ve claude --version ile doğrula.

Yönetici olarak çalıştırman gerekmiyor, ama yanlış kabukta iki tipik hata çıkıyor [1]. “The token ‘&&’ is not a valid statement separator” görürsen PowerShell’desin. “‘irm’ is not recognized” görürsen CMD’desin. Hangisini görürsen gör, komutu doğru kabukta yeniden çalıştırman yetiyor [1].

Git for Windows kurmak isteğe bağlı ama öneriliyor. Kurulu değilse Claude Code komutları PowerShell üzerinden çalıştırıyor [1]. WinGet kullanıyorsan winget install Anthropic.ClaudeCode de olur; bu yöntem de kendiliğinden güncellenmiyor [1].

Projelerin Linux araçlarıyla çalışıyorsa WSL içinde kurmak da bir seçenek. WSL 2’de komutları izole ortamda çalıştıran sandbox özelliği destekleniyor, yerel Windows’ta desteklenmiyor [1].

Sık hatalar, güncelleme ve kaldırma

Kurulumdan sonra: sık hatalar

claude komutu “bulunamadı” diyorsa kurulum klasörü henüz PATH’te değil. Belge bunun için ayrı bir düzeltme sayfasına yönlendiriyor [1]. Kurulumun sağlığını görmek için claude doctor çalıştır; oturum açmadan salt okunur bir rapor veriyor [1]. npm ile kurmak istersen Node.js 22 ya da yenisi gerekiyor ve belge sudo npm install -g kullanmamanı açıkça söylüyor [1].

Güncelleme ve kaldırma

Yerel kurulumla yüklediysen Claude Code arka planda kendiliğinden güncelleniyor. Beklemek istemezsen claude update komutuyla hemen güncelleyebilirsin [1]. Homebrew ve WinGet kurulumları kendiliğinden güncellenmiyor [1]. Kaldırmak istersen macOS ve Linux’ta rm -f ~/.local/bin/claude ve rm -rf ~/.local/share/claude komutlarını çalıştırıyorsun. Windows’ta aynı iki klasörü PowerShell’in Remove-Item komutuyla siliyorsun [1].

Giriş ve plan

Projenin klasöründe terminali açıp claude yazıyorsun ve ilk açılışta tarayıcıdan Claude hesabınla giriş yapman isteniyor [1]. Ücretli plan şartı burada devreye giriyor ve en ucuz yol Claude Pro: aylık 20 dolar ya da yıllık ödemede 200 dolar. Yıllık ödeme, 20 × 12 = 240 dolarlık aylık ödemeden 240 − 200 = 40 dolar ucuz kalıyor; aylığa bölünce 17 dolar ediyor [2]. Türkiye’deki fiyat ve KDV farkı için Claude Pro Türkiye fiyatı yazımıza, daha yüksek planlar için Max 5x ve 20x yazımıza bak.

Terminal istemiyorsan: masaüstü uygulaması ve VS Code

Masaüstü uygulaması

Claude masaüstü uygulaması macOS, Windows (x64 ve arm64) ve Linux’ta (beta) var; Windows için Microsoft Store sürümü de bulunuyor [8]. Uygulamanın kenar çubuğunun üstündeki Code sekmesi, Claude Code’u terminalsiz, grafik arayüzle veriyor. Bunun için Node.js ya da CLI kurman gerekmiyor [4]. Plan şartı aynı: Pro, Max, Ultra, Team ya da Enterprise gerekiyor, ücretsiz planda ise Code sekmesine tıklayınca yükseltme isteniyor [4].

Videoda uygulamayı indirmeyi, giriş yapmayı ve Code sekmesinde klasörle çalışmayı gerçek ekranda gösteriyoruz [10].

VS Code eklentisi

VS Code’da çalışıyorsan Anthropic resmî eklentiyi öneriyor. Gereksinim VS Code 1.94.0 ya da yenisi ve ücretli Claude planı; API anahtarı gerekmiyor [9].

1. VS Code’da Ctrl+Shift+X (Mac’te Cmd+Shift+X) ile Extensions’ı aç.
2. “Claude Code” ara ve Install’a tıkla.
3. Bir dosya açıkken sağ üstteki Spark simgesine tıkla [9].

Eklenti, Claude’un planlarını onaylamadan önce incelemene ve birden fazla sohbeti ayrı sekmelerde açmana izin veriyor. Eklenti kurulamazsa CLI’yi kurup editörün terminalinde claude çalıştırabilirsin [9].

/init ile CLAUDE.md oluşturmak

CLAUDE.md, Claude Code’a her oturumda vermek istediğin kalıcı talimatları yazdığın dosya. Projenin kökündeki ./CLAUDE.md ekiple paylaşılıyor, ~/.claude/CLAUDE.md ise tüm projelerinde geçerli kişisel tercihlerin için [6].

İlk dosyayı oluşturmak için Claude Code’da /init çalıştır. Claude kod tabanını inceleyip derleme komutları, test talimatları ve proje kurallarıyla başlangıç dosyasını yazıyor. Dosya varsa /init üzerine yazmıyor, iyileştirme öneriyor [6]. Belge dosya başına 200 satırın altını hedeflemeni öneriyor, çünkü uzun dosyalar daha çok bağlam harcıyor ve talimatlara uyumu azaltıyor [6].

Videoda /init ile birlikte /plan, /rewind ve /context gibi sık kullanılan eğik çizgi kodlarını da tek tek gösterdik [10].

Skills: kendi eğik çizgi kodunu yaz

Skill, Claude’un araç çantasına eklediğin bir talimat dosyası. SKILL.md adlı dosyaya yazıyorsun; Claude uygun yerde onu kullanıyor ya da sen /skill-adı yazarak çağırıyorsun [5].

Dosyanın yapısı basit ve iki bölümden oluşuyor [5]:

• Üstte --- çizgileri arasında kısa bir başlık bölümü var. name skill’in adı, description ise ne işe yaradığını ve ne zaman kullanılacağını anlatıyor. Claude hangi skill’i kullanacağına description’a bakarak karar veriyor.
• Altında Claude’a vereceğin talimatlar yer alıyor ve Claude bu bölümü yalnızca skill kullanılırken yüklüyor.

Skill’in nerede durduğu kapsamını belirliyor [5]:

Konum	Kapsam
~/.claude/skills/<skill-adı>/SKILL.md	Bilgisayarındaki bütün projeler
.claude/skills/<skill-adı>/SKILL.md	Yalnızca o proje

Claude.ai’da (sohbet uygulamasında) skill’ler kod çalıştırmayı gerektiriyor. Bireysel hesapta önce Settings > Capabilities’ten kod çalıştırma ve dosya oluşturma açılıyor, sonra Customize > Skills bölümünden skill’ler açılıp kapatılıyor, kendi skill’ini de aynı yerden ekleyebiliyorsun [7]. Skill’ler ücretsiz planda da var [7].

Biz bu yolu videoda denedik: masaüstü uygulamasında Özelleştirme > Skills > Ekle > Skill oluştur adımlarıyla /neon adında bir skill yazdık. Kod, yazdığın metni ıslak tuğla duvarda yanan neon tabelaya çeviren tek sayfalık bir animasyon üretiyor. Aynı kalıpla yazılmış yedi görsel kodun tarifi açık veri dosyasında duruyor. Yalnızca /neon’u videoda çalıştırdık; diğer altısı aynı kalıpla yazıldı ve sonuç sende değişebilir [10].

Artifacts: sohbetin yanında açılan çıktı

Artifact, Claude’un sohbetin yanında açtığı, düzenleyip yeniden açabildiğin ve paylaşabildiğin çıktı. Belge, kod parçası, tek sayfalık site, diyagram ve küçük etkileşimli araç gibi şeyler olabiliyor [3]. Anthropic’e göre Artifacts ücretsiz plandan başlayarak bütün planlarda var. Çalışması için Settings > Capabilities’te kod çalıştırma ve dosya oluşturma açık olmalı [3].

Artifact ile Claude Code’u birbirinden ayırman gerekiyor: Artifact’ı ücretsiz planda kullanabilirsin; Claude Code ise ücretli plan istiyor [1][3]. Claude Code içeren her planda Artifacts de kullanılabiliyor [3]. Videodaki neon tabela ve balon patlatma oyunu gibi çıktıları sohbette bu şekilde görüyorsun [10].

Ne yapmalı?

• Kurmadan önce ücretli bir Claude planın olduğundan emin ol; ücretsiz planda Claude Code çalışmıyor [1].
• Terminal istemiyorsan masaüstü uygulamasındaki Code sekmesini dene [4].
• Windows’ta önce kabuğunu kontrol et, sonra o kabuğa ait komutu çalıştır [1].
• Kurulumdan sonra claude --version ve sorun varsa claude doctor ile kontrol et [1].
• İlk projende /init ile CLAUDE.md oluştur ve 200 satırın altında tut [6].
• Tekrar yazdığın bir isteği skill’e çevir; böylece tek bir eğik çizgi koduyla çağırırsın [5].

Sayıyla (2026), Claude Code nasıl kurulur? Ücretsiz değil, Skills ve Artifacts var.

Sayıyla (Kodlama araçları masası, yapay zekâ destekli) (2026). "Claude Code nasıl kurulur? Ücretsiz değil, Skills ve Artifacts var". Sayıyla. https://sayiyla.com/yazilar/claude-code-kurulumu-windows-mac-vscode-rehberi/ (erişim: 08.11.2026). Lisans: CC BY 4.0.