Hızlı Özet: Claude Code CLI, aracı otomatik olarak indiren ve yapılandıran tek bir komutla kurulur. macOS ve Linux'ta, Anthropic'in belgelerindeki resmi kabuk betiğini kullanın; Windows kullanıcıları ise PowerShell veya WSL komutlarını çalıştırır. Kurulumdan sonra, terminalinizde Claude'un AI kodlama yardımcısını kullanmaya başlamak için API anahtarınızla kimlik doğrulaması yapın.
Claude Code, terminalinizde yaşayan ve tüm kod tabanınızı anlayan ajans tabanlı bir kodlama aracıdır. Resmi Claude Code belgelerine göre, doğal dil konuşmaları aracılığıyla dosyaları okuyabilir, komutları yürütebilir, kodu düzenleyebilir ve geliştirme araçlarıyla entegre olabilir.
Ancak başlamak için doğru kurulum gereklidir. Claude Code CLI'yı kurmak ve doğru şekilde yapılandırmak için gereken her şey aşağıdadır.
Kurulum Öncesi Sistem Gereksinimleri
Claude Code'u kurmadan önce sistemin temel gereksinimleri karşıladığını doğrulayın. Resmi Gelişmiş kurulum belgelerine göre, bu cümleyi tamamen kaldırın.
Terminali açıp şunu çalıştırarak Node.js kurulumunu kontrol edin:
| node –version |
Node.js kurulu değilse veya sürümü 18'in altındaysa, resmi Node.js web sitesinden indirin. Uzun Süreli Destek (LTS) sürümü Claude Code için mükemmel çalışır.
Node.js'in ötesinde, sisteme temel gereksinimler gerekir: Mac kullanıcıları için macOS 13.0 veya daha yüksek, Windows sistemleri için Windows 10 veya daha yüksek ve çoğu modern Linux dağıtımı sorunsuz çalışır. Kurulumdan sonra kimlik doğrulama için Anthropic'ten bir Claude hesabına da sahip olmak gerekir.
macOS ve Linux'ta Claude Code Kurulumu
macOS ve Linux için kurulum süreci, her şeyi otomatik olarak halleden tek bir kabuk komutu kullanır. Bu yöntem, resmi Claude Code hızlı başlangıç kılavuzunda belgelenmiştir.
Terminali açın ve kurulum betiğini çalıştırın:
| curl -fsSL claude.ai/install.sh | bash |
Betiği, Claude Code ikili dosyasını indirir, doğru dizine yerleştirir ve PATH'i otomatik olarak yapılandırır. Tüm süreç genellikle bir dakikanın altında tamamlanır.
Homebrew'u tercih eden macOS kullanıcıları için, bir alternatif kurulum yöntemi mevcuttur, ancak birincil kaynaklarda resmi olarak belgelenmemiştir. Resmi belgelere göre curl yöntemi önerilen yaklaşımdır.
Kurulumu Doğrulama
Kurulum tamamlandıktan sonra, Claude Code'un erişilebilir olduğunu doğrulayın:
| claude –version |
Bu komut, kurulu sürüm numarasını görüntülemelidir. "komut bulunamadı" hatası görünürse, PATH yapılandırmasının ayarlanması gerekir.
Resmi sorun giderme belgelerine göre, PATH sorunları en yaygın kurulum sorunudur. Çözüm, Claude'un kurulum dizinini kabuk yapılandırma dosyasına eklemeyi içerir.
macOS ve Linux'ta Claude Code Kurulumu
macOS ve Linux için kurulum süreci npm (Node Paket Yöneticisi) kullanır. Resmi belgelere göre, devam etmeden önce sisteminizde Node.js 18+ kurulu olmalıdır. Kabuk betiklerini kullanan geleneksel CLI araçlarının aksine, Claude Code tüm bağımlılıkların doğru şekilde ele alınmasını sağlamak için terminaliniz aracılığıyla küresel olarak kurulur.
Paketi kurmak için Terminalinizi açın ve aşağıdaki komutu çalıştırın:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Not: CLAUDE_CODE_RELEASE_ALPHA=1 ortam değişkeni, aracın önizleme durumunu kabul etmek için şu anda genel beta/alfa aşamasında gereklidir.
Bu komut, paketi resmi npm kayıt defterinden indirir ve claude yürütülebilir dosyasını sisteminizin küresel bin dizinine bağlar. Bazı kullanıcılar Homebrew formüllerini bulmaya çalışabilirken, npm yöntemi resmi olarak desteklenen ve belgelenen tek kurulum yoludur.
Kurulumu Doğrulama
Kurulum tamamlandıktan sonra, CLI'nin ortamınıza doğru şekilde eşlendiğini doğrulayın:
| claude –version |
Bu komut, geçerli sürüm numarasını (örneğin, 0.2.9) görüntülemelidir. "komut bulunamadı" hatasıyla karşılaşırsanız, bu genellikle küresel npm dizininizin sisteminizin PATH'inde olmadığını gösterir.
Resmi sorun giderme belgelerine göre, npm ön ekini npm config get prefix ile belirleyerek ve ortaya çıkan /bin klasörünün .zshrc veya .bashrc dosyanıza eklendiğinden emin olarak bunu düzeltebilirsiniz.
Windows'ta Claude Code Kurulumu
Windows kurulumu iki ana yaklaşım sunar: yerel PowerShell kurulumu veya Windows Linux Alt Sistemi (WSL) kullanma. Resmi belgeler çoğu kullanıcı için PowerShell'i önerir.
PowerShell Kurulum Yöntemi
PowerShell'i Yönetici olarak açın (Başlat menüsüne sağ tıklayın ve "Windows PowerShell (Yönetici)" seçeneğini seçin). Şu komutu çalıştırın:
| irm claude.ai/install.ps1 | iex |
PowerShell betiği indirme, kurulum ve PATH yapılandırmasını otomatik olarak halleder. Tamamlandıktan sonra, PATH güncellemelerinin etkili olmasını sağlamak için PowerShell'i kapatın ve yeniden açın.
WSL Kurulum Yöntemi
Zaten WSL kullanan geliştiriciler, Linux yöntemini kullanarak Claude Code'u kurabilirler. WSL terminalini açın ve Linux için kullanılan curl komutunu çalıştırın:
| curl -fsSL claude.ai/install.sh | bash |
WSL yaklaşımı, yerel Linux kurulumlarıyla aynı şekilde çalışır. Bir avantajı: WSL, üretim sunucu yapılandırmalarıyla eşleşen daha Unix benzeri bir ortam sağlar.
Resmi sorun giderme belgelerine göre, WSL kullanıcıları zaman zaman ağ bağlantı sorunlarıyla karşılaşırlar. Kurulum takılırsa, WSL'nin harici ağlara erişebildiğini ve güvenlik duvarı kurallarının trafiği engellemediğini doğrulayın.
Claude ve AI Araç Kredilerini Tek Bir Yerde Bulun
Claude Code CLI'yı kurmak bir adımdır. AI araçları için uzun vadeli ödeme yapmak başka bir adımdır. Get AI Perks, startup kredilerini ve AI ve bulut araçları için yazılım indirimlerini tek bir yerde toplar. Kuruculara Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom ve diğerlerinden gelen teklifler de dahil olmak üzere 200'den fazla avantaj sunar. Platform ayrıca avantaj koşullarını ve her teklifin nasıl talep edileceğine dair kılavuzları da gösterir.
Claude veya Anthropic Kredileri mi Arıyorsunuz?
Get AI Perks'i şu amaçlarla kontrol edin:
- AI araç kredilerini ve indirimlerini tek bir yerde bulun
- başvuru yapmadan önce avantaj koşullarını gözden geçirin
- startup tekliflerini talep etme kılavuzlarına erişin
👉 Mevcut Claude, Anthropic ve diğer AI yazılım avantajlarını göz atmak için Get AI Perks'i ziyaret edin.
Kimlik Doğrulama ve İlk Yapılandırma
Kurulumdan sonra, Claude Code işlevsel hale gelmeden önce kimlik doğrulaması gerektirir. Araç, erişimi doğrulamak için Anthropic'ten API anahtarlarını kullanır.
Kimlik doğrulama sürecini başlatmak için şunu çalıştırın:
| claude |
Bu komut ilk kez çalıştığında, Claude Code kimlik doğrulaması için sizi uyaracaktır. Resmi hızlı başlangıç kılavuzuna göre, bu Anthropic hesabında oturum açmak için bir tarayıcı penceresi açar.
Tarayıcı üzerinden oturum açtıktan sonra, CLI otomatik olarak bir kimlik doğrulama belirteci alır. Bu belirteç yerel olarak saklanır ve oturumlar arasında kalıcı olur, bu nedenle tekrar tekrar kimlik doğrulaması gerekmez.
Proje Düzeyinde Ayarları Yapılandırma
Resmi ayarlar belgelerine göre Claude Code, birden çok düzeyde yapılandırmayı destekler. En yaygın yapılandırma düzeyleri şunlardır:
| Kapsam | Konum | Kullanım Senaryosu |
|---|---|---|
| Kullanıcı | ~/.claude/ dizini | Tüm projelerde kişisel tercihler |
| Proje | Depoda .claude/ | Paylaşılan ekip yapılandırması |
| Yerel | .claude/settings.local.json | Makineye özgü geçersiz kılmalar |
İlk kurulum için kullanıcı düzeyinde yapılandırma yeterlidir. Kodlama standartlarını paylaşan ekiplerle çalışırken proje düzeyi ayarları önem kazanır.
İlk Claude Code Oturumunuzu Başlatma
Kurulum ve kimlik doğrulama tamamlandıktan sonra, argüman olmadan komutu çalıştırarak Claude Code'u başlatın:
| claude |
Bu, Claude'un doğal dil isteklerine yanıt verdiği etkileşimli modu başlatır. Resmi belgeler, etkileşimli modu, geliştirme görevleri için Claude Code'u kullanmanın birincil yolu olarak tanımlar.
Basit bir test komutu deneyin:
| Bu projenin yapısını bana göster |
Claude Code, mevcut dizini analiz eder ve kod tabanı yapısının bir özetini sunar. Bu, kurulumun doğru çalıştığını ve Claude'un dosyaları okuma erişimine sahip olduğunu gösterir.
Günlük Kullanım İçin Temel Komutlar
Etkileşimli modun ötesinde, Claude Code CLI referansında belgelenen birkaç komut kalıbını destekler:
| Komut Kalıbı | Amaç | Örnek |
|---|---|---|
| claude | Etkileşimli oturum başlat | claude |
| claude “görev” | Tek seferlik görev çalıştır | claude “lint hatalarını düzelt” |
| claude -p “sorgu” | Oturum olmadan hızlı sorgu | claude -p “bu fonksiyon ne işe yarıyor” |
Tek seferlik görev kalıbı, etkileşimli bir oturumun uygun olmadığı CI/CD işlem hatları ve otomasyon betikleri için özellikle kullanışlıdır.
Yaygın Kurulum Sorun Giderme
Otomatikleştirilmiş kurulum betikleriyle bile zaman zaman sorunlar yaşanabilir. Resmi sorun giderme belgeleri en sık karşılaşılan sorunları kapsar.
Komut Bulunamadı Hataları
Kurulumdan sonra terminalde "komut bulunamadı: claude" hatası görüntülenirse, PATH yapılandırması doğru tamamlanmamıştır. macOS ve Linux için, Claude'un ikili konumunu kabuk yapılandırma dosyasına manuel olarak ekleyin.
Bash kullanıcıları için ~/.bashrc veya ~/.bash_profile'ı düzenleyin ve şunu ekleyin:
| export PATH=”$HOME/.local/bin:$PATH” |
Zsh kullanıcıları için (modern macOS'ta varsayılan), aynı satırla ~/.zshrc'yi düzenleyin. Kaydettikten sonra, yapılandırmayı source ~/.zshrc ile yeniden yükleyin veya yeni bir terminal penceresi açın.
Ağ ve Güvenlik Duvarı Sorunları
Kurumsal ağlar ve kısıtlayıcı güvenlik duvarları bazen kurulum betiğini engeller. Sorun giderme belgelerine göre, kurulum takılırsa veya yürütülmek yerine HTML döndürürse, Anthropic'in sunucularına ağ erişimi engellenmiş olabilir.
Geçici çözüm, kurulum betiğini ayrı olarak indirmeyi içerir:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Bu yaklaşım, indirme veya yürütme sırasında hatalar oluşursa neyin başarısız olduğuna dair daha fazla görünürlük sağlar.
WSL'ye Özgü Sorunlar
WSL çalıştıran Windows kullanıcıları bazen Linux alt sistemi ile Windows arasındaki bağlantı sorunlarıyla karşılaşırlar. Resmi belgeler, WSL trafiğine izin vermek için güvenlik duvarı kurallarının ayarlanması gerekebileceğini belirtir.
Claude Code başarıyla kurulur ancak kimlik doğrulama için Anthropic'in sunucularına ulaşamazsa, Windows güvenlik duvarının WSL ağ erişimine izin verdiğinden emin olun. Sorun giderme kılavuzu, güvenlik duvarı kurallarını yapılandırmak için belirli PowerShell komutları sağlar.
Claude Code'u Güncelleme
Claude Code, yeni özellikler ve iyileştirmelerle düzenli olarak güncellemeler alır. Resmi belgelere göre güncellemeler, ilk kurulumla aynı komut kullanılarak yüklenir.
Yükleme betiğini tekrar çalıştırın:
| curl -fsSL code.anthropic.com/install.sh | sh |
Betiği, mevcut kurulumu algılar ve en son sürüme yükseltir. Güncelleme işlemi sırasında herhangi bir yapılandırma veya kimlik doğrulaması kaybolmaz.
Güncellemeden önce ve sonra geçerli sürümü kontrol edin:
| claude –version |
Resmi Claude Code belgelerindeki değişiklik günlüğü, sürümler arasındaki tüm değişiklikleri listeler, bu da bir güncellemenin belirli iş akışlarıyla ilgili özellikler getirip getirmediğini belirlemeye yardımcı olur.
Kurulum Sonrası Sonraki Adımlar
Claude Code kurulup çalışır duruma geldikten sonra, gelişmiş özelliklerin keşfi mümkün hale gelir. Resmi belgeler, araştırılmaya değer birkaç alanı tanımlar:
- Yetenekler ve özelleştirme: Resmi yetenekler belgelerine göre, Claude Code, .claude/skills/ dizininde Markdown dosyalarında tanımlanan özel yetenekleri destekler. Bu yetenekler, projeye özgü komutlar ve iş akışlarıyla Claude'un yeteneklerini genişletir.
- Model Bağlam Protokolü (MCP): MCP entegrasyonu, Claude Code'un harici araçlara ve hizmetlere bağlanmasını sağlar. Bu, Claude'u veritabanlarına, API'lere ve diğer geliştirme kaynaklarına erişebilen bir merkez haline getirir.
- Ekip işbirliği: .claude/ dizinindeki proje düzeyi yapılandırma dosyaları sürüm kontrolüne işlenebilir, bu da Claude Code ayarlarını tüm geliştirme ekiplerine yayar.
- Resmi belgeler, burada ele alınan temel kurulum üzerine inşa ederek her bir alan için ayrıntılı kılavuzlar sağlar.
Sıkça Sorulan Sorular
Claude Code CLI'yı kullanmak için ücretli bir Claude aboneliğine ihtiyacım var mı?
Claude Code, Anthropic'ten bir Claude hesabı gerektirir, ancak gereken özel abonelik katmanı kullanıma bağlıdır. Resmi belgelere göre kimlik doğrulama gereklidir, ancak planlar zamanla değiştiği için fiyatlandırma ayrıntıları Anthropic'in resmi web sitesinden doğrulanmalıdır.
Claude Code'u yönetici ayrıcalıkları olmadan kurabilir miyim?
macOS ve Linux'ta, Claude Code varsayılan olarak kullanıcının ev dizinine kurulur ve yönetici erişimi gerektirmez. Windows kullanıcıları PowerShell kurulum yöntemi için yönetici ayrıcalıklarına ihtiyaç duyabilir, ancak WSL kurulumları yönetici erişimi gerektirmez.
Claude Code çevrimdışı çalışır mı?
Hayır. Claude Code, istekleri işlemek için Anthropic'in sunucularıyla iletişim kuran AI destekli bir araçtır. Resmi belgelere göre Claude'un kodu analiz etmesi ve yanıt üretmesi için aktif bir internet bağlantısı gereklidir.
Claude Code nasıl kaldırılır?
Resmi Gelişmiş kurulum belgeleri, kaldırmanın ikili ve yapılandırma dosyalarının kaldırılmasını içerdiğini açıklar. macOS ve Linux'ta, ~/.claude dizinini silin ve kabuk yapılandırma dosyalarından PATH modifikasyonunu kaldırın. Windows kullanıcıları kurulum dizinini kaldırmalı ve PATH ortam değişkenini temizlemelidir.
Claude Code tüm dosya sistemime erişebilir mi?
Varsayılan olarak, Claude Code mevcut çalışma dizini ve alt dizinleri içinde çalışır. Resmi izinler belgelerine göre, yapılandırma dosyalarındaki sanal alan ayarları kullanılarak erişim daha da kısıtlanabilir. Claude, potansiyel olarak yıkıcı işlemleri yürütmeden önce her zaman onay ister.
Claude Code CLI ve Claude Desktop arasındaki fark nedir?
Claude Code CLI terminalde çalışır ve doğrudan dosya sistemi erişimi ve komut yürütme ile geliştirme iş akışlarına odaklanır. Claude Desktop, grafik arayüzü olan bağımsız bir uygulamadır. Her iki araç da farklı kullanım durumlarına hizmet eder, CLI terminal tabanlı iş akışlarını tercih eden geliştiriciler için optimize edilmiştir.
Claude Code'u ne sıklıkla güncellemeliyim?
Güncellemeler uygun olduğunda yüklenebilir. Resmi değişiklik günlüğü yeni özellikleri ve hata düzeltmelerini belgeler. Ekipler için, güncellemeleri koordine etmek herkesin uyumlu sürümler kullandığından emin olur, ancak Claude Code yapılandırma dosyaları sürümler arasında geriye dönük uyumluluğu korur.
Sonuç
Claude Code CLI'yı kurmak, işletim sisteminden bağımsız olarak yalnızca birkaç dakika sürer. Otomatikleştirilmiş kurulum betikleri, manuel müdahale olmadan yapılandırma, PATH kurulumu ve ikili dosya yerleştirme işlemlerini halleder.
Kurulum ve kimlik doğrulama sonrasında Claude Code, herhangi bir terminalden erişilebilen güçlü bir AI kodlama yardımcısı haline gelir. Doğal dil komutları, geliştiricilerin komut satırından ayrılmadan kod yazmasına, hataları düzeltmesine ve görevleri otomatikleştirmesine olanak tanır.
AI destekli geliştirme deneyimini yaşamaya hazır mısınız? Platformunuza yönelik kurulum komutunu çalıştırın ve ilk Claude Code oturumunuza bugün başlayın. code.claude.com adresindeki resmi belgeler, temel kurulum tamamlandıktan sonra gelişmiş özellikler için kapsamlı kılavuzlar sunar.
