Claude Code Nedir? Nasıl Kullanılır?

Yapay zekanın en çok hakim olduğu alanlardan biri de kodlamadır. Günümüzde, aralarından seçim yapabileceğiniz çok sayıda yapay zeka kodlama asistanı bulunmaktadır. Fakat bu noktada tüm yapay zeka kodlama asistanlarının yerini alacak Claude Code devreye girer. İster deneyimli bir yazılımcı olun ister kodlama konusunda yeni başlayan biri, kod yazarken size yardımcı olacak bir asistan kullanmanız önemlidir.

Claude Code Nedir?​

Claude Code, Anthropic tarafından geliştirilen bir yapay zeka kodlama asistanıdır. Bu yapay zeka kodlama asistanı, geliştiricilerin basit ve doğal dilde verilen komutlarla kod tabanlarını düzenlemelerine ve derlemelerine yardımcı olmak üzere IDE’lere, iş akışlarına ve terminallere doğrudan entegre edilebilir. Claude Code, kodlama dahil çeşitli görevleri yerine getirmek için hibrit akıl yürütme ve genişletilmiş düşünme modunu kullanan gelişmiş bir yapay zeka modeli olan Claude 3.7 Sonnet ile çalışır.

Claude Code’un Diğer Yapay Zeka Kodlama Araçlarından Farkı​

Claude Code, Anthropic’in tüm kod tabanınızı okuyan, dosyaları düzenleyen ve doğal dil komutları aracılığıyla komutları çalıştıran otonom kodlama aracıdır. Terminal CLI, VS Code, JetBrains IDE’leri, bir masaüstü uygulaması ve web üzerinden kullanılabilir. Siz her değişikliği inceleyip onaylarken, birden fazla dosya üzerinde mantık yürütür ve çok adımlı görevleri bağımsız bir şekilde yürütür.

Diyelim ki bir kayıt formuna e-posta doğrulama eklemeniz gerekiyor. Bunu bir komut olarak yazarsınız.

Claude Code, projenizdeki ilgili dosyaları bulur, değişiklikleri planlar, size farkları gösterir ve onayladıktan sonra düzenlemeleri uygular. Testler çalıştırır, kodu kaydeder ve çekme istekleri oluşturur. Hepsini tek bir komutla yapmanız mümkündür.

Peki bu, diğer AI kodlama araçlarından nasıl farklıdır?

Günümüzde çoğu AI kodlama aracı, ajan modları, çoklu dosya düzenleme ve eklenti ekosistemleri sunmaktadır. Bu özellikler büyük ölçüde örtüşmektedir. Aradaki fark, varsayılan iş akışı ve zamanınızı nereye harcadığınızdır. Cursor, IDE öncelikli bir deneyim için optimize edilmiştir. Claude Code ise, siz daha üst düzeyde inceleme yaparken AI’a bir görevi yerine getirmek için daha fazla özerklik sağlamak üzere optimize edilmiştir. Seçim, AI ile nasıl çalışmayı tercih ettiğinize bağlıdır.

Claude Code’u Kurma​

Aşağıda sistem gereksinimlerinin neler olduğunu, hangi sistemlere Claude Code’u yükleyip kullanabileceğinizi ve ihtiyacınız olacak diğer hususları bulabilirsiniz:

Claude Code için Sistem Gereksinimleri​

Claude Code’u kullanmak için sahip olmanız gereken sistem gereksinimlerini aşağıdaki şekildedir:

• RAM: 8 GB
• Depolama Alanı: 5 GB veya daha fazla
• CPU: Sanallaştırmayı destekleyen herhangi bir CPU (Windows’ta WSL2 için gereklidir)
• İşletim Sistemi: WSL 2 ile Windows 10, macOS 10.15, Ubuntu 20.04, Debian 10+

Claude Code için ön koşullar​

Tüm gereksinimleri karşılayan bir bilgisayara sahip olmak çok da zor bir iş değildir. Sahip olmanız gereken bazı şeyler vardır. Bunlar olmadan Claude Code’u hiç kullanamazsınız.

• Node.js
• Git
• API Credits
• Terminal veya Windows PowerShell, Homebrew, WinGet
• Claude aktif abonelikleri

Claude Paketleri ve Fiyatları​

Claude Code’u kullanmak için ücretli paketlerden birine abone olmanız gerekimektedir. Claude’un ücretsiz paketi, Claude Code ile uyumlu değildir. Aşağıda ücretli paketlerin listesi, fiyatları ve sunduğu avantajlar yer almaktadır.

Plan	Fiyat	Kullanım Kapasitesi	Kullanım Amacı
Claude Pro	Aylık 20 $ veya yıllık 200 $	Standart kullanım limitleri	Günlük ve düzenli kullanım için ideal
Claude Max 5x	Aylık 100 $	Oturum başına Pro planın 5 katı kapasite	Claude’u iş ve çeşitli görevler için yoğun kullananlar için en uygun
Claude Max 5x	Aylık 200 $	Pro planın 20 katı kapasite	Büyük ölçekte kullanım yapanlar ve ekip çalışmaları için en uygun

Claude Code’u Adım Adım Nasıl Kurarsınız?​

macOS veya Linux’ta curl -fsSL | bash komutunu, Windows PowerShell’de ise irm | iex komutunu çalıştırarak Claude Code’u kurun. claude –version komutuyla sürümü kontrol edin, ardından herhangi bir proje dizininde claude komutunu çalıştırarak tarayıcınız üzerinden kimlik doğrulaması yapın. Yerel yükleyici otomatik olarak güncellenir.
Platforma göre kurulum komutları:

Windows PowerShell​

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

Windows CMD​

curl -fsSL -o install.cmd && install.cmd && del install.cmd


Homebrew (brew install –cask claude-code) veya WinGet (winget install Anthropic.ClaudeCode) aracılığıyla da yükleyebilirsiniz. Bu yöntemler manuel güncelleme gerektirir. Yerel yükleyici ise otomatik olarak güncellenir.

Yüklemeden sonra, çalışıp çalışmadığını kontrol edin:

Eğer claude komutu bulunamıyorsa, terminalinizi yeniden başlatın. Yükleme sonrası PATH sorunları en sık karşılaşılan sorundur. Hala bir sorun varsa, genellikle yeniden yüklemek sorunu çözer.

Kimlik doğrulama tarayıcı tabanlıdır. Herhangi bir proje dizininde claude komutunu çalıştırın; varsayılan tarayıcınız claude.ai adresinde tek seferlik oturum açma sayfası açacaktır. Terminale geri dönün, kimlik doğrulamanız tamamlanmıştır. Kimlik bilgileri ~/.claude/ dizininde yerel olarak saklanır, böylece her oturumda oturum açmanıza gerek kalmaz.

Bazı rehberler ve AI tarafından oluşturulan makaleler hala npm install -g @anthropic-ai/claude-code komutunu önermektedir. Bu yöntem artık resmi belgelerde yer almamaktadır. Bu yüzden yerel yükleyiciyi kullanın.

Claude Code için Klavye Kısayolları​

Claude Code kullanırken aklınızda tutmanız gereken kısayolların listesi aşağıdaki şekildedir:

Komut İstemi/Yürütme Kısayolları

• Ctrl + C: Oluşturmayı durdur (terminal)
• Ctrl + Enter: Göndermeye zorla (bazı ortamlarda)
• Ctrl + L: Ekranı/konuşmayı temizle (CLI)
• Esc: Geçerli oluşturmayı iptal et
• Shift + Enter: Göndermeden yeni satır

Konuşma Gezinme Kısayolları

• Ctrl + Aşağı Ok: Geçmişteki sonraki komut istemi
• Ctrl + R: Komut geçmişinde arama (terminal)
• Ctrl + Yukarı Ok: Geçmişteki önceki komut istemi
• Page Down: Aşağı kaydır
• Page Up: Konuşmada yukarı kaydır
• Yukarı Ok / Aşağı Ok: Geçmişte kaydır

Komut İstemi Kutusu İçinde Düzenleme Kısayolları

• Alt + Sol Ok: Bir kelime geri git
• Alt + Sağ Ok: Bir kelime ileri git
• Ctrl + A: Satırın başına git
• Ctrl + E: Satırın sonuna git
• Ctrl + K: Sondaki satırı sil Satır
• Ctrl + U: Tüm satırı sil
• Ctrl + W: Önceki kelimeyi sil

Kod Bloğu Çıktı Kısayolları

• Cmd/Ctrl + Tıklama: Dosya referansını aç
• Ctrl + Shift + C: Kod bloğunu kopyala
• Ctrl + Shift + Enter: Oluşturulan komutu çalıştır (yalnızca CLI ortamları)
• Tab: Öneriyi kabul et (yalnızca belirli editörler)

Proje ve Dosya Kısayolları

• Ctrl + “: Terminali aç/kapat
• Ctrl + B: Kenar çubuğunu aç/kapat
• Ctrl + F: Bul
• Ctrl + P: Dosya aramayı aç
• Ctrl + S: Dosyayı kaydet
• Ctrl + Shift + F: Projede ara
• Ctrl + Shift + P: Komut paleti

Ajan Kontrol Kısayolları

• Ctrl + C: Görevi zorla durdur
• Ctrl + D: Oturumdan çık
• Ctrl + Z: Arka plan işlemi (terminal)
• Esc: Claude’u kes

Önemli Komutlar Claude

• /clear
• /exit
• /files
• /help
• /reset
• /tools

Artık, farklı kısayollar, Claude Code’u kullandığınız ortamlara (VS Code, Terminal, Cursor ve diğer web tabanlı geliştirici araçları gibi) bağlı olarak farklı şekilde çalışır.

Claude Code’un Gelişmiş Özellikleri​

Yeniden yapılandırma ve hata ayıklamanın temellerine alıştıktan sonra Claude Code’un davranışını özelleştirerek çok daha fazla işlevsellik elde edebilirsiniz. Hook ve eklentiler, tekrarlayan görevleri otomatikleştirmenize ve harici sistemleri entegre etmenize olanak tanır.

Claude Code hook’ları​

Claude Code hook’ları, Claude Code oturumunuz sırasında belirli olaylar meydana geldiğinde kabuk komutlarını çalıştıran otomatik tetikleyicilerdir. Bunlar, kod biçimlendirme, testleri çalıştırma ve Claude’un aksi takdirde atlayabileceği güvenlik kontrolleri gibi tekrarlayan görevleri otomatikleştirir.

Hook’lar, üç şeyi tanımladığınız bir olay-eylem sistemi kullanır:

• Olay: Hook ne zaman tetiklenir?
• Eşleştirici: Hangi eylemler etkilenir?
• Komut: Hook tetiklendiğinde ne çalıştırılır?

Örneğin, bir hook, Claude bir Python dosyası yazdıktan sonra tetiklenebilir ve kodu biçimlendirmek için otomatik olarak black komutunu çalıştırabilir. Hook’lar, ne olduğu hakkında JSON bağlamı alır ve dosya türlerine veya yollarına dayalı akıllı kararlar alınmasını sağlar. Claude’un transkriptine çıktı verebilir veya işlemleri engellemek için hata mesajlarını doğrudan Claude’a gönderebilirler.

Hook’ların yaygın kullanım örnekleri arasında aşağıdakiler yer alır:

• Kod biçimlendirme: Kod yazıldıktan sonra linter ve biçimlendiricileri otomatik olarak çalıştırma
• Test: Hataları erken tespit etmek için değişikliklerden sonra test takımlarını çalıştırma
• Güvenlik: Üretim yapılandırmaları veya API anahtarları gibi hassas dosyalara yönelik değişiklikleri engelleme
• Belgeleme: Kaynak dosyalar değiştiğinde API belgelerini otomatik olarak oluşturma
• Git otomasyonu: Akıllı commit’ler oluşturma ve dal koruma politikalarını doğrulama
• Bildirimler: Önemli dosyalar değiştiğinde Slack üzerinden ekibinizi uyarabilme
• Uyumluluk: Değişikliklere izin vermeden önce lisans başlıklarını veya kodlama standartlarını uygulayabilme

Claude Code’daki /hooks komutunu kullanarak hookl’ları kurun veya ~/.claude/settings.json dosyasını doğrudan düzenleyin.

Claude Code eklentileri​

Eklentiler, Claude Code’u harici araçlara, hizmetlere ve API’lere bağlayan genişletmelerdir. Hook’lar yerel kabuk komutlarını otomatikleştirirken, eklentiler CI/CD iş akışı, proje yönetimi araçları ve ekip iletişim platformları gibi daha geniş geliştirme ekosisteminizle entegre olur.

Eklentiler, alt ajanlar (belirli görevler için özel Claude asistanları), MCP sunucuları (standartlaştırılmış araç entegrasyonları) ve hook’lar dahil olmak üzere birden fazla bileşeni, bunları sorunsuz bir şekilde koordine eden tek bir pakette bir araya getirebilir.

Bir eklenti, kod değişikliklerini analiz edip Jira’da otomatik olarak sorun bildirimleri oluşturabilir veya şirket içi test altyapınıza bağlanabilir. Eklentiler, hook’lar ile aynı olaylara yanıt verir, ancak verileri harici hizmetlere gönderir ve yanıtları işleyerek Claude’un iş akışını etkiler.

Claude Code eklentilerinin özellikle uygun olduğu birkaç görev aşağıdakileri içermektedir:

• CI/CD entegrasyonu: Dosyalar değiştiğinde derlemeleri, testleri ve dağıtımları tetikleme
• Proje yönetimi: Jira, GitHub veya Linear’da sorunları otomatik olarak oluşturma veya güncelleme
• Ekip iletişimi: Değişiklikler olduğunda Slack veya Teams’e güncellemeler yayınlama
• Kod incelemesi: GitHub/GitLab’da pull isteklerini otomatik olarak oluşturma ve incelemeleri yönetme
• Harici analiz: Kurumsal kod taraması için SonarQube, CodeClimate veya Snyk’i çağırma
• Özel araçlar: Şirketin özel sistemleri ve iş akışlarıyla entegrasyon
• IDE uzantıları: Özel komutlar ve gezinme yardımcıları

Eklentileri bir kayıt defterinden yükleyin veya kuruluşunuz için dahili olarak oluşturun, ardından hangi olaylara yanıt vereceklerini yapılandırın. Hook’lar ve eklentiler birlikte, Claude Code’u mevcut altyapınıza uyarlayan genişletilebilir bir platform oluşturur.

Claude Code’a Yeni Başlayanlar Hangi Hataları Yapar?​

Yeni başlayanların yaptığı en yaygın beş hata şunlardır: /clear komutu kullanmadan farklı konuları içeren oturumlar yürütmek, sıfırdan başlamak yerine Claude’u tekrar tekrar düzeltmek, CLAUDE.md yapılandırmasını atlamak, büyük değişiklikler istemeden önce kodu kaydetmemek ve belirsiz komut satırları yazmak.

Claude Code’u, net talimatlara ve düzenli kontrol noktalarına ihtiyaç duyan, yetenekli ancak belirsiz bir iş ortağı olarak görmeniz ve aşağıdaki hatalardan kaçınmanız gerekir:

Her şeyi bir araya karıştırmayın​

Bir hata düzeltmesi ile başlayıp sonra konuyla ilgisi olmayan bir özellik hakkında soru soruyorsanız, ardından tekrar hataya dönüyorsanız, Claude’un bağlamı alakasız bilgilerle dolar ve performans dibe vurabilir. Bu yüzden ilgisiz görevler arasında her seferinde /clear komutunu çalıştırın.

Claude’u döngüsel olarak düzeltme​

Claude bir hata yaptığında, siz düzeltirsiniz. Hala yanlışsa, tekrar düzeltebilirsiniz. Fakat bağlam, üç başarısız denemeyle kirlenir. Bu yüzden iki başarısız düzeltmeden sonra, /clear komutunu çalıştırın ve daha iyi bir başlangıç komutu yazın. Neyin yanlış gittiği konusunda öğrendiklerinizi dahil edin. Kesin bir komutla temiz bir başlangıç, kafa karıştırıcı bir oturumda tekrar tekrar denemekten daha iyidir.

CLAUDE.md dosyasını atlamak​

CLAUDE.md dosyası olmadığında Claude, kurallarınızı tahmin etmeye çalışır. Yanlış içe aktarma stili. Yanlış test çalıştırıcısı. Yanlış dal adlandırma. Bu yüzden ilk oturumunuzda /init komutunu çalıştırın ve çıktıyı iyileştirin. On dakikalık kurulum, saatlerce sürecek düzeltmelerden kurtarır.

Büyük değişikliklerden önce güvenlik ağlarını kullanmamak​

Claude, çok dosyalı bir yeniden yapılandırma önerir. Siz kabul edersiniz, bir şeyler bozulur. Claude Code, Esc+Esc veya /rewind ile geri dönebileceğiniz yerleşik kontrol noktalarına sahiptir ve bunlar çoğu durumu halleder. Büyük yeniden yapılandırmalarda ekstra güvenlik için önce git commit -m “Claude yeniden yapılandırmasından önce kontrol noktası” komutunu çalıştırın. Git, bash komutları ve harici değişiklikler gibi kontrol noktalarının yakalayamadığı her şeyi yakalar. Ayrıca farkları dikkatlice inceleyin.

Belirsiz talimatlar​

“Bunu daha iyi hale getir” gibi bir ifade, Claude’a çalışması için hiçbir ipucu vermez. “@src/utils/date.ts dosyasındaki yinelemeleri azalt ve genel API’yi değiştirme” ifadesi ise kısıtlamalar, kapsam ve dosya referansı sağlar. Bu yüzden ne istediğinizi, bunun hangi dosyada olduğunu ve hangi kısıtlamaların geçerli olduğunu net bir şekilde belirtin. Claude’u, kod tabanınıza yeni başlayan kıdemli bir mühendis gibi düşünün. Ona ihtiyaç duyduğu bağlamı sağlayın.

En Çok Sorulan Sorular​

Claude Code’u kullanmak için ücretli bir Claude aboneliğine ihtiyacım var mı?​

Evet. Claude Code, bir Claude Pro aboneliği (aylık 20 $) veya API faturalandırma özelliğine sahip bir Console hesabı gerektirir. Öğrenme ve hafif günlük kullanım için Pro sürümü yeterlidir. Ücretsiz bir plan yoktur.

Claude Code’u kullanırken kodum Anthropic’in sunucularına gönderiliyor mu?​

Claude Code, komutlarınızı ve ilgili dosya içeriğini işlenmek üzere Anthropic’in API’sine gönderir. Gerektiğinde dosyaları okur, ancak kod tabanınızın tamamını tek seferde yüklemez. Bağlam penceresi, mevcut konuşmayı ve Claude’un aktif olarak okuduğu dosyaları içerir. Saklama ve gizlilik ayrıntıları için Anthropic’in veri işleme politikalarını kontrol edin.

Claude Code büyük kod tabanlarını nasıl işliyor?​

Claude Code, dosyaları talep üzerine, gerektiğinde tek tek okur. Mevcut sohbeti, okuduğu dosyaları ve komut çıktılarını tutmak için bir bağlam penceresi kullanır. @ ile belirli dosyalara başvurarak ve ilgisiz görevler arasında /clear komutunu çalıştırarak bağlamı odaklanmış tutun. Alt ajanlar, ana oturumunuzu temiz tutarken birçok dosyayı okumayı gerektiren araştırma görevlerini yönetebilir.

Claude Code’u VS Code ve terminal ile aynı anda kullanabilir miyim?​

Evet. VS Code uzantısı ve terminal CLI aynı aboneliği kullanır ve aynı anda çalışabilir. Birçok geliştirici, çoklu dosya görevleri için terminali, odaklanmış düzenlemeler için ise VS Code’u kullanır. Oturumlar birbirinden bağımsızdır.

Claude Code ile normal Claude sohbeti arasındaki fark nedir?​

Claude Code, yerel dosyalarınızı okuyan, terminal komutlarını çalıştıran ve onayınızla kod değişiklikleri yapan bir ajans aracıdır. Normal Claude sohbeti tarayıcıda çalışır ve yalnızca yapıştırılan metinlerle çalışır. Claude Code, geliştirme iş akışları için tasarlanmıştır. Claude sohbeti ise genel konuşma ve analiz içindir.