Claude Code'u resmi yoldan kullanmak için üç adım gerekir: ücretli bir plan, çünkü ücretsiz plan bunu içermez ve en ucuzu ayda 20 dolar ya da yıllık ödemeyle 17 dolar olan Pro'dur; ardından sisteminiz için claude.ai'daki resmi kurulum komutu; son olarak da ilk açılışta tarayıcıdan oturum açmak. Suudi Arabistan, Anthropic'in desteklediği bölgeler listesinde olduğu için ne aracıya ne de ödünç bir hesaba ihtiyacınız var. Sonra resmi pazar yerinden Claude Code Setup eklentisini kurun; eklenti projenizi okur ve tek bir dosyayı bile değiştirmeden doğru ayarları önerir.

Neden özellikle resmi yol?

Anthropic'in desteklenen bölgeler politikası, web uygulamaları, Claude Code ve API dahil ürünlerinin yalnızca listedeki ülkelerde kullanılabildiğini söyler; Suudi Arabistan da Birleşik Arap Emirlikleri, Kuveyt, Katar, Bahreyn ve Umman ile birlikte listede yer alır. Aynı politika, hesap desteklenen bir kuruluşa ait olsa bile listede olmayan bir ülkeden kullanımı desteklenmeyen kullanım sayar. Krallık'taysanız ve kendi hesabınızı kullanıyorsanız doğru yoldasınız; hesabın askıya alınmasına yol açabilecek dolambaçlı yollara gerek yok.

İkinci bir neden daha var: resmi yükleyici aracı arka planda otomatik olarak günceller, böylece güvenlik düzeltmeleri yayınlandığı anda size ulaşır. Eklentiler ise bilgisayarınızda otomatik komutlar ve harici bağlantı sunucuları çalıştırabilir; bu yüzden resmi dokümantasyon bir eklentiyi kurmadan önce ayrıntılarını okumanızı önerir ve başlamak için en güvenli yer Anthropic'in resmi pazar yeridir.

Kurulumdan önce neye ihtiyacınız var?

Resmi kurulum sayfasına göre gereksinimler şunlar:

GereksinimAyrıntılar
İşletim sistemimacOS 13.0 veya üstü, Windows 10 sürüm 1809 veya üstü, Windows Server 2019 ya da Ubuntu 20.04, Debian 10 veya Alpine 3.19 ve sonrası
DonanımEn az 4 GB RAM ve x64 ya da ARM64 işlemci
AğÇalışan bir internet bağlantısı
KabukBash, Zsh, PowerShell veya CMD
HesapPro, Max, Team, Enterprise ya da bir Console hesabı

Claude Code'un maliyeti ne kadar?

Aracın kendisi ücretsiz indirilir, ancak çalıştırmak için ücretli bir hesap gerekir. Resmi fiyat sayfasında gösterildiği hâliyle planlar şöyle:

PlanFiyatClaude Code dahil mi?
FreeÜcretsizHayır
ProAyda 20 dolar ya da yıllık ödemeyle ayda 17 dolar (peşin 200 dolar)Evet
MaxAyda 100 dolardan başlar, Pro'nun beş ya da yirmi katı kullanımEvet
Team ve EnterpriseKoltuk başına, merkezi yönetim ve faturalandırma ileEvet

Bireyler için başlangıçta Pro yeterlidir. Şirketler için kimlik doğrulama rehberi Team ya da Enterprise önerir; çünkü faturalandırma ve yetkileri tek bir panelde toplar ve tüm geliştiricilere aynı ayarları zorunlu kılmanızı sağlar.

Claude Code adım adım nasıl kurulur?

Bir terminal açın ve sisteminize uygun komutu yapıştırın. Aşağıdaki komutlar resmi dokümantasyondan birebir alınmıştır ve hiçbiri yönetici yetkisi gerektirmez.

Mac, Linux veya WSL'de

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

Windows'ta

Yolun önündeki PS'den tanıyabileceğiniz PowerShell'de:

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

CMD'de ise:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Dokümantasyon, aracın Bash komutlarını çalıştırabilmesi için Git for Windows kurmanızı önerir; o olmadan araç PowerShell üzerinden çalışır.

Homebrew veya WinGet ile

Mac'te brew install --cask claude-code, Windows'ta winget install Anthropic.ClaudeCode ile de kurabilirsiniz. Bu iki yöntemin aracı otomatik güncellemediğini, yani güncelleme komutunu sizin çalıştırmanız gerektiğini ve Homebrew'un kararlı sürümünün genellikle en yeni sürümün yaklaşık bir hafta gerisinde kaldığını unutmayın.

Yükleyici indirme sırasında ilerleme çubuğu göstermez; durmuş gibi görünürse endişelenmeyin. Bittiğinde bir sonraki adımdan önce yeni bir terminal penceresi açın.

Hesabınızla nasıl oturum açarsınız?

  1. Terminalde proje klasörünüze gidin ve claude yazın.
  2. Araç, claude.ai hesabınızla oturum açmanız için bir tarayıcı penceresi açar. Açılmazsa bağlantıyı kopyalamak için c tuşuna basın ve tarayıcıya yapıştırın.
  3. Tarayıcı geri yönlendirmek yerine bir kod gösterirse, kodu terminalde Paste code here if prompted satırına yapıştırın. Bu genellikle WSL2, SSH oturumları veya konteynerlerde olur.
  4. Login successful göründüğünde Enter'a basın ve çalışmaya başlayın.

Oturumu kapatmak için oturum içinde /logout yazın. Bir iş hesabınız ve bir kişisel hesabınız varsa resmi yol, CLAUDE_CONFIG_DIR değişkeniyle her hesaba kendi ayar klasörünü vermektir; örneğin şu kısayolla:

alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

Kurulumun sağlam olduğunu nasıl kontrol edersiniz?

claude --version
claude doctor

İlk komut 2.1.211 gibi bir sürüm numarası yazdırır; ikincisi oturum açmadan kurulumu ve ayar dosyalarını kontrol eder ve her uyarıyı çözümüyle birlikte gösterir.

Claude Code Setup eklentisi nedir?

Claude Code Setup, eklenti pazar yerinde bulunan, projenizi analiz edip ona uygun otomasyonları öneren resmi bir Anthropic eklentisidir. package.json gibi dosyaları, klasör yapısını ve programlama dilini okur, ardından resmi deposunun açıkladığı gibi beş kategorinin her birinde en iyi bir ya da iki öneriyi gösterir:

KategoriNe yaparEklentiden örnek
MCP sunucularıAracı harici hizmetlere bağlarDokümantasyon için context7, ön yüz testleri için Playwright
Skill'lerGerektiğinde yüklenen hazır uzmanlıkPlanlama ve arayüz tasarımı skill'leri
Hook'larHer düzenlemede otomatik işlemlerKodu otomatik biçimlendirme, hassas dosyaları engelleme
Alt ajanlarUzmanlaşmış gözden geçirenlerGüvenlik, performans ve erişilebilirlik incelemesi
Eğik çizgi komutlarıTekrarlanan işler için kısayollar/test, /pr-review ve /explain

En önemlisi, yalnızca okur: önerir ve dosyalarınızda hiçbir şeyi değiştirmez, yani karar sizde kalır. Tek bir kategoriyi özellikle sorarsanız seçenekleri üç ile beş arasına genişletir.

Claude Code Setup eklentisi nasıl kurulur ve kullanılır?

  1. Projenizin içinde claude çalıştırın, ardından şunu yazın:
/plugin install claude-code-setup@claude-plugins-official
  1. Eklentinin ayrıntı paneli açılır: ne ekleyeceği, en son ne zaman güncellendiği ve ne kadar bağlam kullandığı. Onaylamadan önce okuyun.
  2. Kurulum kapsamını seçin: tüm projelerinizde sizin için, bu depo üzerinde çalışan herkes için ya da yalnızca bu depoda sizin için.
  3. Kurulumdan sonra recommend automations for this project gibi bir istek yazın ya da şunu sorun: what hooks should I use?

Resmi eklentiler sayfası, kurulum özeti isterse eklentinin /reload-plugins ile yeniden yüklenmesi gerekebileceğini açıklar.

En yaygın kurulum hataları ve çözümleri nelerdir?

  • claude not found: kurulum klasörü henüz PATH'e eklenmemiş. Yeni bir terminal penceresi açın; hata sürerse dokümantasyondaki PATH düzeltme bölümüne bakın.
  • The token '&&' is not a valid statement separator: PowerShell'desiniz ve CMD komutunu kullanıyorsunuz; PowerShell komutunu kullanın.
  • 'irm' is not recognized: tersi; CMD'desiniz ve PowerShell komutunu kullanıyorsunuz.
  • Ücretsiz plan: ücretsiz bir hesapla oturum açmak yetmez, çünkü Claude Code bu plana dahil değildir.
  • Eski sürüm: Homebrew veya WinGet ile kurduysanız brew upgrade claude-code ya da winget upgrade Anthropic.ClaudeCode ile elle güncelleyin.

Komut satırını hiç sevmiyorsanız resmi masaüstü uygulaması, Mac, Windows ve Linux'ta grafik arayüzle Claude Code sunar. Araca son eklenenleri Claude Code'da yenilikler, Ağustos 2026 yazımızda ele aldık.

Kaynaklar