Claude Code kurulumu: Windows ve Mac'te adım adım rehber
Claude Code'u kurmak için Mac'te Terminal'e curl -fsSL https://claude.ai/install.sh | bash, Windows'ta PowerShell'e irm https://claude.ai/install.ps1 | iex yapıştırman yeterli. Sonra yeni pencerede claude yazıp tarayıcıdan giriş yaparsın. Ücretsiz Claude planı Claude Code'u kapsamaz; en az Pro planı ya da ön ödemeli Console hesabı gerekir.
Claude Code'un ne yaptığını biliyorsan sıradaki soru hep aynı: bilgisayarıma nasıl kurarım, hangi hesabı açarım, kurduktan sonra ilk ne yazarım? Resmi doküman İngilizce ve her kabuk için ayrı komut veriyor. Yanlış pencereye yanlış komutu yapıştırmak, kurulumun en sık takıldığı yer.
Bu rehber Mac ve Windows komutlarını tek tek veriyor, ilk açılışı sıralıyor, güncellemeyi ve Türkçe ayarını gösteriyor, sık hataları belirti, neden ve çözüm tablosunda topluyor. Aracın ne işe yaradığını henüz okumadıysan önce Claude Code nedir yazısına bak.
Claude Code kurmadan önce ne gerekir?
Üç şey: desteklenen bir işletim sistemi, ücretli bir Claude hesabı ve internet bağlantısı. Eylül 2026 itibarıyla resmi kurulum dokümanına göre Claude Code macOS 13.0, Windows 10 1809 ya da Ubuntu 20.04 ve üstünde, en az 4 GB RAM ile çalışıyor. Kabuk olarak Bash, Zsh, PowerShell ya da CMD kabul ediliyor. Türkiye, Anthropic'in desteklenen ülkeler listesinde.
Hesap tarafında dikkat edilecek nokta şu: ücretsiz Claude planı Claude Code'u kapsamıyor. Giriş için aşağıdaki hesaplardan biri gerekiyor.
| Hesap | Aylık fiyat (Eylül 2026, vergi hariç) | Kimin için |
|---|---|---|
| Free | 0 dolar | Claude Code yok, yalnız sohbet |
| Pro | 20 dolar (yıllık ödemede ayda 17 dolar) | Tek kişi, günde birkaç iş |
| Max 5x / Max 20x | 100 dolar / 200 dolar | Gün boyu ajan çalıştıran |
| Team, standart koltuk | 25 dolar (yıllık ödemede 20 dolar) | 2-150 kişilik ekip |
| Console (API) | Ön ödemeli kredi, kullandıkça | Kullanımı düzensiz olan, otomasyon kuran |
Rakamlar Claude fiyat sayfasından. Tüm planlarda kullanım sınırı beş saatlik kayan pencerede sıfırlanıyor; ücretli planlara ayrıca haftalık sınır ekleniyor. Claude Code, web ve masaüstündeki sohbetlerinle aynı havuzdan harcıyor.
Terminal hiç açmak istemiyorsan Claude masaüstü uygulaması Claude Code'u grafik arayüzle sunuyor. Bu rehber terminal kurulumunu anlatıyor; komutlar bir kez girilir, sonrası sohbet gibi ilerler.
Claude Code Mac'e nasıl kurulur?
- Terminal'i aç. Cmd ve Boşluk tuşlarıyla Spotlight'ı aç, "Terminal" yaz, Enter'a bas.
- Kurulum komutunu yapıştır.
curl -fsSL https://claude.ai/install.sh | bashsatırını yapıştır ve Enter'a bas. Kurucu programı indirir ve~/.local/bin/claudekonumuna yerleştirir. - Yeni pencere aç ve doğrula. Terminal'i kapatıp yeniden aç,
claude --versionyaz. Ekranda bir sürüm numarası görüyorsan kurulum tamam. - "command not found" alırsan yolu ekle. Mac'in varsayılan kabuğu Zsh'ta önce
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc, sonrasource ~/.zshrcçalıştır ve doğrulamayı tekrarla.
Homebrew kullanıyorsan ikinci yol brew install --cask claude-code. Bu paket kararlı kanalı izler: sürümler yaklaşık bir hafta geriden gelir, büyük hata içeren sürümler atlanır. Karşılığında otomatik güncelleme yoktur, güncellemeyi sen yaparsın.
En sık hata: kurulumdan hemen sonra aynı pencerede claude yazmak. Kurucu yolu günceller ama açık pencere eski yolla çalışır. Resmi doküman da "bulunamadı" hatasında ilk adım olarak yeni pencere açmayı öneriyor.
Claude Code Windows'a nasıl kurulur?
Windows'ta iki yol var: doğrudan Windows'a ya da WSL içine kurmak. Çoğu kişi için doğru seçim doğrudan kurulum. PowerShell'i ya da CMD'yi yönetici olarak açman gerekmiyor.
| Nereden kuruyorsun | Komut |
|---|---|
| PowerShell (önerilen) | irm https://claude.ai/install.ps1 | iex |
| CMD | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| WinGet | winget install Anthropic.ClaudeCode |
| WSL terminali | curl -fsSL https://claude.ai/install.sh | bash |
Hangi pencerede olduğunu satırın başından anlarsın: PowerShell'de istem PS C:\ ile başlar, CMD'de başta PS yoktur. Kurulum bitince yeni bir pencere aç ve claude --version ile doğrula.
Git for Windows kurmak isteğe bağlı. Kurarsan Claude Code komutları Git Bash üzerinden çalıştırır, kurmazsan PowerShell kullanır. Linux araçlarıyla çalışıyorsan ya da komutları korumalı alanda çalıştırmak istiyorsan WSL 2 seç; resmi dokümana göre korumalı alan doğrudan Windows kurulumunda desteklenmiyor. WSL'de kurulum ve başlatma WSL terminalinin içinde yapılır, PowerShell'den değil.
İlk açılışta ne yapılır?
- Çalışma klasörüne gir. Ajan başlatıldığı klasörü görür. Masaüstünde boş bir klasör aç, terminalde
cdile oraya geç veclaudeyaz. - Giriş yap. İlk açılışta tarayıcı açılır, Claude hesabınla onaylarsın. Tarayıcı açılmazsa terminalde
ctuşuna bas; giriş adresi panoya kopyalanır. Hesabı sonradan değiştirmek için oturumda/loginyazarsın. - Klasöre güveni onayla. Claude Code yeni bir klasörde, dosyalarına güvenip güvenmediğini sorar. Onayı yalnız kendi dosyalarının olduğu klasörde ver.
/initçalıştır. Klasör için başlangıçCLAUDE.mddosyası üretir. Bu dosya her oturumun başında okunur; kalıcı kuralların burada yaşar.- Küçük, geri alınabilir bir iş ver. "Bu klasördeki PDF'lerin tarih ve tutarlarını tek tabloya çıkar" gibi. Ajan dosyayı değiştirmeden önce onay isterse ne yapacağını okuyup onayla.
İşine yarayacak birkaç komut: /help komut listesini, /usage plan kullanımını gösterir, /clear sohbeti temizler, /exit çıkar. Shift+Tab izin modunu değiştirir; ajanın her adımda sana sorup sormayacağını buradan seçersin.
İsteği nasıl yazacağını bilmiyorsan işe hazır Türkçe prompt şablonları iyi bir başlangıç. İlk ayın planı için ajana iş devretmenin ilk 30 günü yazısı hangi hafta ne devredileceğini sıralıyor. Müşteri verisini ilk günden bu klasöre koyma; kodlama ajanı klasörde gördüğü her dosyayı okuyabilir.
Claude Code nasıl güncellenir?
Yerel kurucuyla, yani curl ya da irm komutuyla kurduysan bir şey yapman gerekmez. Claude Code açılışta ve çalışırken güncellemeyi denetler, arka planda indirir, yeni sürüm bir sonraki açılışta devreye girer. Beklemek istemiyorsan claude update yaz.
| Kurulum yolu | Kendiliğinden güncellenir mi? | Elle güncelleme |
|---|---|---|
| Yerel kurucu (curl, irm, CMD) | Evet | claude update |
| Homebrew | Hayır | brew upgrade claude-code |
| WinGet | Hayır | winget upgrade Anthropic.ClaudeCode |
| npm | npm klasörü yazılabilirse evet | npm install -g @anthropic-ai/claude-code@latest |
Kurulumun sağlığını ve son güncelleme denemesinin sonucunu claude doctor gösterir. En yeni özellikler yerine yaklaşık bir hafta eski ve büyük hataları elenmiş sürümde kalmak istersen ayar dosyasına "autoUpdatesChannel": "stable" satırını ekle. npm kullanıyorsan npm update -g yerine tablodaki komutu kullan; resmi doküman bu komutun seni en yeni sürüme taşımayabileceğini belirtiyor.
Claude Code Türkçe kullanılabilir mi?
Evet. Türkçe yazdığında Türkçe cevap alırsın, ayrıca bir şey kurman gerekmez. Cevap dilini kalıcı yapmak istersen ~/.claude/settings.json dosyasına "language": "turkish" satırını ekle.
Bu ayarın bir tuzağı var: Claude Code değeri denetlemeden, "hep bu dilde cevap ver" talimatı olarak modele iletir. Yazım hatası yaparsan hata mesajı almazsın, ayar sessizce işe yaramaz. Komut adları (/init, /help) Türkçeleşmez.
İş kurallarını da Türkçe yazabilirsin. CLAUDE.md dosyasına "Müşteriye giden metinlerde siz değil sen kullan" gibi satırlar eklemek, aynı talimatı her oturumda yeniden yazmaktan kurtarır. Bu mantığın genişletilmiş hali, işi baştan sona tarif eden döngü dosyasıdır.
Claude Code ücretsiz kullanılabilir mi?
Hayır. Eylül 2026 itibarıyla Claude Code ücretsiz Claude planında yok; en düşük giriş Pro planı, aylık faturada 20 dolar. Resmi kurulum dokümanı da Pro, Max, Team, Enterprise ya da Console hesabı şartını açıkça yazıyor.
Maliyeti düşük tutmanın iki dürüst yolu var. Yıllık ödemede Pro ayda 17 dolara iniyor, 200 dolar peşin ödeniyor. Kullanımın düzensizse Console hesabına ön ödemeli kredi yükleyip yalnız harcadığın token kadar ödersin. Hangisinin sana ucuz geldiğini yapay zeka maliyeti nasıl hesaplanır yazısındaki iş başına maliyet yöntemiyle hesaplayabilirsin.
Kimin için gereksiz? Ayda birkaç kez soru sorup cevabı bir yere yapıştırıyorsan Claude Code sana fazla gelir; sohbet uygulaması yeter. Kurmaya değdiği yer, dosya üreten ve tekrar eden bir işin olduğu yerdir: haftalık rapor, toplu görsel düzenleme, teklif dosyası. Şirket bilgisayarında program kurma iznin yoksa ya da ağ indirme adresini engelliyorsa, önce BT ekibinle konuşman gerekir.
Sık kurulum hataları ve çözümleri
| Belirti | Neden | Çözüm |
|---|---|---|
command not found: claude ya da 'claude' is not recognized | Kurulum klasörü yolda (PATH) değil ya da eski pencere açık | Yeni pencere aç; sürmezse ~/.local/bin (Windows'ta %USERPROFILE%\.local\bin) klasörünü yola ekle |
'irm' is not recognized | CMD penceresindesin | PowerShell aç ya da tablodaki CMD komutunu kullan |
The token '&&' is not a valid statement separator | PowerShell'e CMD komutunu yapıştırdın | PowerShell komutunu kullan |
syntax error near unexpected token '<' ya da 403 | Kurulum adresi betik yerine web sayfası döndürdü: ağ, vekil sunucu ya da geçici kesinti | Birkaç dakika sonra tekrar dene; Mac'te Homebrew, Windows'ta WinGet ile kur |
App unavailable in region | Bağlandığın ülke desteklenenler listesinde değil | Anthropic'in desteklenen ülkeler listesini kontrol et |
running scripts is disabled on this system | npm ile kurulumda PowerShell betik izni kapalı | Yerel kurucuyu kullan ya da Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser çalıştır |
OAuth error: Invalid code | Giriş kodunun süresi doldu ya da eksik kopyalandı | Enter'a basıp girişi hızlıca tamamla; tarayıcı açılmıyorsa c ile adresi kopyala |
Girişten sonra 403 Forbidden | Abonelik aktif değil ya da Console hesabında Claude Code rolü yok | claude.ai ayarlarında aboneliği, Console'da rolünü kontrol et |
Tabloda olmayan bir hata için önce claude doctor çalıştır: kurulum sağlığını, ayar dosyası hatalarını ve önerilen düzeltmeleri oturum açmadan listeler. Hata mesajını birebir aramak için resmi sorun giderme sayfası en güncel kaynak.
Sıfırdan Sistem bağımsız bir yayındır, Anthropic ile bağlantısı yoktur. Claude ve Claude Code, Anthropic PBC'nin markalarıdır.
Sık sorulan sorular
Claude Code nasıl indirilir?
Ayrı bir dosya indirmen gerekmez; terminale yapıştırdığın kurulum komutu programı resmi adresten indirip kurar. Terminal kullanmak istemiyorsan Claude masaüstü uygulaması Claude Code'u grafik arayüzle sunar.
Claude Code kurmak için yönetici yetkisi gerekir mi?
Hayır. Windows'ta PowerShell ya da CMD'yi yönetici olarak açman gerekmez, Mac'te yerel kurucu programı kullanıcı klasörüne kurar. npm ile kuruyorsan sudo kullanma; resmi doküman bunun izin sorunlarına ve güvenlik riskine yol açtığını belirtiyor.
Claude Code npm ile kurulur mu?
Kurulur: npm install -g @anthropic-ai/claude-code. npm paketi yerel kurucuyla aynı programı indirir; Node.js kurulu değilse yerel kurucu daha kısa yoldur.
Claude Code Linux'a kurulur mu?
Evet. Ubuntu 20.04, Debian 10 ve Alpine Linux 3.19 ile üstü destekleniyor ve Mac ile aynı curl komutu kullanılıyor. Debian, Fedora ve Alpine için apt, dnf ve apk depoları da var.
Claude Code nasıl kaldırılır?
Yerel kurulumda Mac ve Linux'ta rm -f ~/.local/bin/claude ile rm -rf ~/.local/share/claude programı siler. Homebrew'da brew uninstall --cask claude-code, WinGet'te winget uninstall Anthropic.ClaudeCode kullanılır; ayarlar ve oturum geçmişi ~/.claude klasöründe kalır.
Kurulumdan sonra ilk işi hazır ajanla yap
Claude Code kurulduktan sonra ilk gerçek iş için talimatı sıfırdan yazmak yerine, profiline göre seçilmiş üç ajan dosyasını klasörüne koyup kurdurabilirsin. Ajanlar Claude planının yerini tutmaz; kurulu Claude Code ve etkin bir plan gerekir. Tek seferlik lisans, abonelik yok; her ay yama ve güncellemeler e-postana gelir.
Profil Paketleri · 3 Ajan · Satın al 4 ajanın tamamını gör