Claude Code Eğitimi: Kurulum, Refaktoring ve Uygulamalı Hata Ayıklama

Claude Code Nedir?

Claude Code, doğrudan terminalinizde çalışan, kod tabanınızı anlayan ve doğal dil komutlarıyla geliştirme görevlerine yardımcı olan bir araçtır. Minimum kurulumla geliştirme ortamınıza entegre olur; böylece kod yazmaya ve iyileştirmeye odaklanabilirsiniz.

Claude Code’un birkaç temel yeteneği şunlardır:

• Düzenleme ve refaktoring: Yapay zekâ destekli önerilerle kod tabanınızı değiştirin, optimize edin ve iyileştirin.
• Hata düzeltme: Hataları, eksik bağımlılıkları ve performans darboğazlarını tespit edip giderin.
• Kodu anlama: Kodunuzun mimarisi, mantığı ve bağımlılıkları hakkında sorular sorun.
• Otomatik test ve linting: Başarısız testleri çalıştırıp düzeltin, lint komutlarını çalıştırın ve kod kalitesini artırın.
• Git entegrasyonu: Git geçmişinde arama yapın, birleştirme çakışmalarını çözün, commit oluşturun ve pull request’leri zahmetsizce hazırlayın.

Açık kaynak bir projede çalışıyor veya kurumsal ölçekte kod tabanlarını yönetiyor olun, Claude Code kodlama stilinize ve proje gereksinimlerinize uyum sağlayan akıllı otomasyonla yardımcı olabilir. Son güncellemeler, otomatik modu (daha az izin kesintisi), plan modunu (tasarım-öncelikli iş akışları) ve Routines'i (bilgisayarınız açık değilken tetikleyicilerle çalışan zamanlanmış bulut ajanları) ekledi.

Bu hizmet için ideal kullanıcı profilleri şunlardır:

• Yazılım Geliştiricileri: Kod kalitesi ve sürdürülebilirliğini iyileştirme.
• Açık Kaynak Katkıcıları: Yabancı kod tabanlarını anlama ve iyileştirme.
• DevOps Mühendisleri: Kod inceleme ve linting görevlerini otomatikleştirme.

Claude Code artık Max ve Team Premium planlarında varsayılan olarak Claude Opus 4.7 ile gelir. Pro kullanıcıları Sonnet 4.6 ile başlar ancak zorlu görevler için Opus modellere geçebilir. Oturum sırasında /model komutuyla modeli değiştirebilir veya /effort kaydırıcıyla akıl yürütme derinliğini ayarlayabilirsiniz. Ayrıca Claude Agents SDK ile bağımsız yapay zekâ ajanları oluşturabilirsiniz.

Anthropic ayrıca kodlamanın ötesindeki günlük dosya ve doküman görevleri için ajan tarzı yardım sunan Cowork'u tanıttı. Claude Desktop uygulamasında tüm ücretli plan aboneleri (Pro, Max, Team, Enterprise) için kullanılabilir.

Claude Code’u xAI'ın terminal ajanıyla karşılaştırıyorsanız, Grok Build vs. Claude Code karşılaştırmamız ikisini de aynı görev üzerinde test ediyor.

Şimdi uygulamalı projemize başlayalım.

Adım 1: Claude Code Kurulumu

Claude Code ile çalışmaya başlamak için bir terminale, üzerinde çalışacağınız bir kod projesine ve ya ücretli bir Claude aboneliğine (Pro/Max/Teams/Enterprise) ya da aktif faturalandırmaya sahip bir Claude Console hesabına ihtiyacınız var.​

İşletim sisteminize ve terminalinize bağlı olarak aşağıdaki komutlardan birini terminalinizde çalıştırarak Claude Code'u kolayca kurun.

macOS / Linux / WSL: 

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

Windows PowerShell: 

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

Windows CMD:  

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

Not: npm install -g @anthropic-ai/claude-code ile kurulum hâlâ mevcut ancak kullanım dışı bırakılmıştır; bu nedenle yukarıda belirtilen yerel kurulum sürecini tercih etmelisiniz. Daha önce npm ile kurduysanız, claude install ile geçiş yapabilirsiniz.

Kurulum tamamlandıktan sonra proje dizininize gidin ve aşağıdakileri çalıştırarak Claude'u başlatın:

cd your-project-directory
claude

Kimlik doğrulama için, Claude Code'u ücretli aboneliğe mi yoksa API kullanım faturalandırmasına mı dayalı kullanmak istediğiniz sorulacaktır.

Ardından, sizi bir doğrulama koduna götüren bir oturum açma bağlantısı alacaksınız; bu kodu Claude Code'un çalıştığı terminale girmeniz gerekir. Sonrasında işlem tamamlanır ve kullanım takibi ve maliyet yönetimi için otomatik olarak özel bir “Claude Code” çalışma alanı oluşturulur.

Artık Claude Code kullanıma hazır.

Adım 2: Geliştirme Ortamını Hazırlayın

Bu demoda, Supabase ile etkileşim kurmak için açık kaynak bir Python istemcisi olan supabase-py Supabase Python kütüphanesini kullanacağım; Supabase, PostgreSQL üzerine kurulu bir arka uç hizmetidir (BaaS). Supabase; kimlik doğrulama, gerçek zamanlı abonelikler, depolama ve otomatik oluşturulan API'ler dahil bir araç paketi sunar.

Depoyu klonlayarak ve geliştirme ortamımızı kurarak başlayalım.

1. Terminalinizi açın, Supabase-py deposunu klonlamak istediğiniz dizine gidin (örn. cd Desktop) ve aşağıdaki komutu çalıştırın:

git clone https://github.com/supabase/supabase-py.git
cd  supabase-py

2. Ardından bir sanal ortam oluşturun ve gerekli bağımlılıkları tek tek aşağıdaki komutları terminalinizde çalıştırarak yükleyin

python3 -m venv env
source env/bin/activate  # On Windows, use ./env/Scripts/activate
pip install -e .

Python ortamınız artık Supabase kütüphanesini çalıştırmak için gerekli tüm bağımlılıklarla hazır ve deponuz keşfe hazır.

Adım 3: Katkı Alanlarını Belirleyin

Katkıda bulunmanın harika bir yolu GitHub'daki Issues sekmesini incelemektir. Supabase deposunda, client.py dosyasında kod okunabilirliği, yapı ve anlamlı yorumların eksikliğiyle ilgili bir sorun belirledim.

Claude Code ile yapacaklarımız şunlar:

• Okunabilirliği, sürdürülebilirliği ve yapıyı artırmak için kodu yeniden düzenleyeceğiz.
• Farklı bileşenlerin amacını netleştirmek için anlamlı docstring'ler ve satır içi yorumlar ekleyeceğiz.
• Sorunları ve diğer olası hataları analiz ederek bug’ları tespit edip düzelteceğiz.

Adım 4: Claude Code ile Denemeler

Zaten supabase-py klasöründeyiz; client.py dosyasını içeren supabase dizinine gidin ve Claude Code'u çalıştırın:

cd supabase
claude

Claude Code artık Supabase-py klasörü içindeki tüm dosya ve klasörlere erişebiliyor. Şimdi deneyelim.

Kodu yeniden düzenleme

Supabase Python SDK'sını iyileştirmenin bir parçası olarak, okunabilirliği, sürdürülebilirliği ve düzeni artırmak için client.py dosyasını yeniden düzenleyelim. Komut satırına şu istemi yazmanız yeterli:

İstem: Supabase klasöründeki client.py dosyasındaki kodu yeniden düzenleyin.

Claude devam etmeden önce onay isteyecektir. Değişiklikleri onaylamak için Enter tuşuna basın. Tamamlandığında Claude Code dosyayı günceller, terminalde değişiklikleri gösterir ve yapılan düzenlemelerin bir özetini verir.

Claude Code'u kullanarak client.py için şu iyileştirmeleri uyguladık:

• İçe aktarmaları düzenleme:  Claude Code ilgili içe aktarmaları mantıksal bölümlerde (kimlik doğrulama hataları, API türleri, fonksiyon hataları) grupladı, netlik için adları iyileştirdi ve tutarlılık için gereksiz rumuzları kaldırdı.
• Okunabilirliği artırma: İçe aktarmaları sınıflandırmak için bölüm yorumları eklendi ve daha temiz bir düzen için __all__ listesinde yinelenenler kaldırıldı.
• İstemci seçeneklerini sadeleştirme: Benzer içe aktarmalar tek bir ifadede birleştirilerek birden çok satır azaltıldı.

İşte özgün ve yeniden düzenlenmiş kodun yan yana karşılaştırması.

Kodu belgeleme

Refaktoringe ek olarak, Claude Code bir projenin tamamında kod dokümantasyonunu üretebilir, güncelleyebilir ve standartlaştırabilir. Belgelendirilmemiş bölümleri tespit edebilir, yapılandırılmış docstring'ler veya yorumlar oluşturabilir ve proje dokümantasyon standartlarına uygunluğu denetleyebilir.

client.py içindeki dokümantasyonu iyileştirmek için Claude Code'u kullandık ve şu sonuçları elde ettik:

• Dosyanın amacını açıklayan net modül düzeyinde docstring'ler.
• İçe aktarmaları kategorize eden ayrıntılı bölüm yorumları (hata türleri, istemci uygulamaları, depolama servisleri).
• Hata türlerini, istemci fonksiyonlarını ve önemli bileşenleri açıklayan satır içi yorumlar.

İşte refaktoring yapılmış ve belgelendirilmiş kodun yan yana karşılaştırması.

İstem: Anlaşılabilirliği artırmak için client.py kodunu yorumlar ekleyerek belgele.

Dokümantasyon eklendikten sonra, Claude'a şu istemi vererek proje standartlarınıza uygunluğunu doğrulayabilirsiniz:

İstem: Dokümantasyonun proje standartlarımızı takip edip etmediğini kontrol et.

Hata düzeltme

Hata ayıklama zaman alıcı olabilir, ancak Claude Code, hata mesajlarını analiz ederek, kök nedenleri belirleyerek ve düzeltmeler önererek döngüyü kısaltır. Eksik içe aktarmalar, çalışma zamanı hataları veya mantık sorunlarıyla uğraşıyor olun, arama alanını daraltır ve hedefe yönelik düzeltmeler önerir.

Claude Code'u hata ayıklama için böyle kullanın:

1. Sorunu belirleyin:  Hata mesajını Claude ile paylaşın.
2. Düzeltme önerileri alın: Olası çözümler için Claude'a sorun.
3. Düzeltmeyi uygulayın ve doğrulayın:  Claude’un önerilerini uygulayın ve sorunun çözülüp çözülmediğini kontrol edin.

Claude Code, client.py dosyası içindeki içe aktarma ile ilgili sorunları çözmek için şu düzenlemeleri yaptı: 

• Tür yok sayma yorumları: Çözülemeyen içe aktarmalar için IDE ve tür denetimi uyarılarını bastırmak üzere # type: ignore yorumları eklendi.
• Tutarlı hata sınıflandırması: Kimlik doğrulama, veritabanı, depolama ve fonksiyonlardan gelen hata içe aktarmalarının net şekilde gruplanması sağlandı.
• Kod okunabilirliğini koruma: Bazı içe aktarmaların neden yok sayıldığını belirtmek üzere yorumlar eklendi; kaldırılmadılar.

İşte özgün kod ile düzeltilmiş kodun yan yana karşılaştırması.

İstem: 'Import gotrue.errors' çözülemedi gibi bazı hatalar görüyorum. client.py içindeki tüm hataları düzeltmeme yardım et.

Claude Code Komutları

Claude ile denemeniz için birkaç komut aşağıdadır.

Daha derinlemesine bilgi için Claude Code eğik çizgi komutları rehberimize göz atmanızı öneririm.

Gelişmiş Claude Code Özellikleri

Refaktoring ve hata ayıklamanın temellerinde rahat ettikten sonra, davranışını özelleştirerek Claude Code’un yeteneklerini genişletebilirsiniz. Kancalar (Hooks) ve Eklentiler (Plugins) tekrarlayan görevleri otomatikleştirmenize ve harici sistemlerle bütünleştirmenize olanak tanır.

Claude Code kancaları

Claude Code kancaları, Claude Code oturumunuz sırasında belirli olaylar gerçekleştiğinde kabuk komutlarını çalıştıran otomatik tetikleyicilerdir. Claude’un atlayabileceği kod biçimlendirme, testleri çalıştırma ve güvenlik kontrolleri gibi tekrarlayan görevleri otomatikleştirirler.

Kancalar bir olay-eylem sistemi kullanır; üç şeyi tanımlarsınız:

• Olay: Kanca ne zaman tetiklenir?

• Eşleyici: Hangi işlemler etkilenir?

• Komut: Kanca tetiklenince ne çalıştırılır?

Örneğin, bir kanca Claude bir Python dosyası yazdıktan sonra tetiklenip kodu biçimlendirmek için otomatik olarak black çalıştırabilir. Kancalar, ne olduğunu anlatan JSON bağlamı alır; bu da dosya türleri veya yollarına göre akıllı kararlar alınmasını sağlar. Çıktıyı Claude'un dökümüne yazabilir veya işlemleri engellemek için hataları doğrudan Claude'a gönderebilirler.

Kancalar için yaygın kullanım örnekleri şunlardır

• Kod biçimlendirme: Kod yazımlarından sonra otomatik olarak linter’ları ve biçimlendiricileri çalıştırma

• Test: Hataları erken yakalamak için değişikliklerden sonra test paketlerini çalıştırma

• Güvenlik: Üretim yapılandırmaları veya API anahtarları gibi hassas dosyalara yapılan değişiklikleri engelleme

• Dokümantasyon: Kaynak dosyalar değiştiğinde API dokümantasyonunu otomatik oluşturma

• Git otomasyonu: Akıllı commit'ler oluşturma ve dal koruma ilkelerini doğrulama

• Bildirimler: Önemli dosyalar değiştiğinde ekibinizi Slack üzerinden uyarma

• Uyumluluk: Değişikliklere izin vermeden önce lisans başlıklarını veya kodlama standartlarını zorunlu kılma

Kancaları, Claude Code içindeki /hooks komutunu kullanarak kurun veya doğrudan ~/.claude/settings.json dosyasını düzenleyin.

Claude Code eklentileri

Eklentiler, Claude Code'u harici araçlara, hizmetlere ve API'lere bağlayan uzantılardır. Kancalar yerel kabuk komutlarını otomatikleştirirken, eklentiler CI/CD hatları, proje yönetim araçları ve ekip iletişim platformları gibi daha geniş geliştirme ekosisteminizle bütünleşir.

Eklentiler; alt ajanlar (belirli görevler için uzmanlaşmış Claude asistanları), MCP sunucuları (standartlaştırılmış araç entegrasyonları) ve kancaları tek bir pakette bir araya getirip birlikte orkestre edebilir.

Bir eklenti kod değişikliklerini analiz edip Jira'da otomatik olarak sorun açabilir ya da iç test altyapınıza bağlanabilir. Eklentiler, kancalarla aynı olaylara yanıt verir ancak verileri harici hizmetlere gönderir ve Claude’un iş akışını etkilemek için yanıtları işler.

Claude Code eklentilerinin çok iyi olduğu birkaç görev şunlardır:

• CI/CD entegrasyonu: Dosyalar değiştiğinde derlemeleri, testleri ve dağıtımları tetikleyin

• Proje yönetimi: Jira, GitHub veya Linear'da otomatik olarak sorun oluşturun veya güncelleyin

• Ekip iletişimi: Değişiklikler olduğunda Slack veya Teams'e güncellemeler gönderin

• Kod inceleme: Otomatik olarak pull request oluşturun ve GitHub/GitLab üzerinde incelemeleri yönetin

• Harici analiz: Kurumsal kod taraması için SonarQube, CodeClimate veya Snyk çağırın

• Özel araçlar: Şirketinize özel sistemler ve iş akışlarıyla bütünleşin

• IDE uzantıları: Özel komutlar ve gezinme yardımcıları ekleyin

Eklentileri bir kayıt defterinden yükleyin veya kurumunuz için dahili olarak geliştirin, ardından hangi olaylara yanıt vereceklerini yapılandırın. Kancalar ve eklentiler birlikte, Claude Code'u mevcut altyapınıza uyarlayan genişletilebilir bir platform oluşturur.

Diğer gelişmiş özellikler

Claude Code, 2026'da kullanım alanını ve şeklini genişleten birkaç önemli yetenek daha ekledi:

• Plan modu: Claude'un herhangi bir kod yazmadan önce ayrıntılı bir uygulama planı oluşturduğu tasarım-öncelikli bir iş akışı. Önemsiz olmayan her görevde bunu kullanıyorum.
• Otomatik mod: Claude'un daha az kesintiyle çalışmasını sağlayan bir izin sınıflandırıcısı; her dosya yazımını onaylamak istemediğiniz daha uzun görevler için kullanışlıdır.
• Routines: Cron zamanlamasıyla, bir GitHub olayıyla (ör. PR açıldı) veya bir webhook çağrısıyla tetiklenen zamanlanmış bulut ajanları. Bilgisayarınızın açık olması gerekmez.
• IDE entegrasyonu: Claude Code; satır içi farklar, kontrol noktaları ve çoklu oturum desteğiyle VS Code, Cursor ve JetBrains IDE'leri için resmi uzantılara sahiptir.
• Uzaktan kontrol ve Kanallar: Claude Code oturumlarını çalıştırın ve telefonunuzdan veya diğer cihazlardan etkileşim kurun.

Son Düşünceler

Bu eğitimde, Supabase Python SDK'sındaki bir dosyayı refaktoring yapıp belgelendirerek ve hata ayıklayarak Claude Code'u kullandım. Kod okunabilirliğini iyileştirdik, yapılandırılmış dokümantasyon ekledik ve içe aktarma sorunlarını çözdük.

Claude Code; plan modu, otomatik mod ve Routines gibi özelliklerle aktif olarak evriliyor; bu nedenle kendi projelerinizde deneyerek iş akışınıza nasıl uyduğunu görmek değerli olacaktır.

Bir adım ileri gitmek için, Claude'un bağlam penceresinden en iyi şekilde nasıl yararlanacağınızı öğreten Claude Code En İyi Uygulamalar eğitimimizi okumanızı öneririm. Sıfırdan bir proje kurmak istiyorsanız, Claude Code ile Şartname Odaklı Geliştirme eğitimimizi okuyun.