Claude Code Eğitimi: Kurulum, Yeniden Düzenleme ve Pratikte 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 bazı temel yetenekleri şunlardır:

• Düzenleme ve yeniden düzenleme: Kod tabanınızı yapay zeka destekli önerilerle 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ın ve düzeltin, lint komutları çalıştırın ve kod kalitesini artırın.
• Git entegrasyonu: Git geçmişinde arayın, birleştirme çakışmalarını çözün, commit oluşturun ve pull request'leri zahmetsizce üretin.

İster bir açık kaynak projede çalışın ister kurumsal düzeyde kod tabanlarını yönetin, Claude Code kodlama tarzınıza 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 Rutinleri (makineniz çalışmasa bile tetikleyicilerle çalışan zamanlanmış bulut ajanları) ekledi.

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

• Yazılım Geliştiricileri: Kod kalitesini ve sürdürülebilirliğini artırma.
• 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'ye ayarlı. 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ısıyla akıl yürütme derinliğini ayarlayabilirsiniz. Ayrıca Claude Agents SDK ile bağımsız yapay zeka ajanları geliştirebilirsiniz.

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

Şimdi uygulamalı projemize başlayalım.

Adım 1: Claude Code Kurulumu

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

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

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 halen mevcut ancak kullanımdan kaldırılmıştır; bu nedenle yukarıda belirtilen yerel kurulum yöntemini tercih etmelisiniz. Daha önce npm ile kurduysanız, claude install komutuyla geçiş yapabilirsiniz.

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

cd your-project-directory
claude

Kimlik doğrulama için, Claude Code'u ücretli abonelik veya API kullanımına dayalı faturalandırma ile kullanmak isteyip istemediğiniz sorulacaktır.

Ardından, Claude Code'un çalıştığı terminale girmeniz gereken bir doğrulama koduna yönlendiren bir oturum açma bağlantısı alacaksınız. Sonrasında işlem tamam; kullanım takibi ve maliyet yönetimi için otomatik olarak “Claude Code” adlı özel bir çalışma alanı oluşturulur.

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

Adım 2: Geliştirme Ortamını Kurun

Bu demoda, Supabase üzerinde etkileşim kurmak için açık kaynak bir Python istemcisi olan supabase-py kütüphanesini kullanacağım. Supabase, PostgreSQL üzerine kurulu, kimlik doğrulama, gerçek zamanlı abonelikler, depolama ve otomatik oluşturulan API'ler dahil bir araç seti sağlayan bir backend-as-a-service'tir.

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

1. Terminalinizi açın, Supabase-py deposunu klonlamak istediğiniz dizine gidin (ör. 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ı, terminalinizde aşağıdaki komutları teker teker çalıştırarak yükleyin

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

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

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

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 şöyle:

• Okunabilirliği, sürdürülebilirliği ve yapıyı güçlendirmek 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 eklemek.
• Sorunları ve diğer olası hataları analiz ederek hataları belirlemek ve düzeltmek.

Adım 4: Claude Code ile Denemeler

Zaten supabase-py klasöründeyken, 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şime sahip. Şimdi denemeler yapalım.

Kodu yeniden düzenleme

Supabase Python SDK'yı 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 girmeniz yeterli:

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

Claude, devam etmeden önce onay isteyecek. Değişiklikleri onaylamak için Enter tuşuna basın. İşlem tamamlandığında Claude Code dosyayı güncelleyecek, terminalde değişiklikleri gösterecek ve yapılanların bir özetini sunacaktır.

Claude Code'u kullanarak client.py üzerinde şu iyileştirmeleri uyguladık:

• İçe aktarmaları düzenleme:  Claude Code ilişkili içe aktarmaları mantıksal bölümlerde grupladı (kimlik doğrulama hataları, API türleri, fonksiyon hataları), netlik için yeniden adlandırdı ve tutarlılık için gereksiz takma adları 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__ listesindeki yinelemeler kaldırıldı.
• İstemci seçeneklerini sadeleştirme: Benzer içe aktarmalar tek bir ifadede birleştirilerek birden çok satır azaltıldı.

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

Kodu belgeleme

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

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

• Dosyanın amacını açıklayan net modül düzeyi 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 tanımlayan satır içi yorumlar.

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

İstem: Anlamayı geliştirmek için client.py kodunu yorumlar ekleyerek belgeleyin.

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

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

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 hedefli düzeltmeler önerir.

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

1. Sorunu tanımlayın:  Hata mesajını Claude ile paylaşın.
2. Düzeltme önerileri alın: Olası çözümleri Claude'dan isteyin.
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ındaki içe aktarma ile ilgili sorunları çözmek için şu düzenlemeleri yaptı: 

• Tür yok sayma yorumları: Çözümlenemeyen içe aktarmalar için IDE ve tür denetimi uyarılarını bastırmak üzere # type: ignore yorumu eklendi.
• Tutarlı hata kategorileştirme: Kimlik doğrulama, veritabanı, depolama ve fonksiyonlardan gelen hata içe aktarmalarının net şekilde gruplandığından emin olundu.
• Kod okunabilirliği korundu: Belirli içe aktarmaların neden kaldırılmak yerine yok sayıldığını belirtmek için yorumlar eklendi.

İşte orijinal 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 edin.

Claude Code Komutları

Claude ile denemeniz için bazı komutlar aşağıdadır.

Ayrıca resmî Anthropic eğitimlerine ve Claude Code en iyi uygulamalar rehberimize göz atmanızı öneririm.

Gelişmiş Claude Code Özellikleri

Yeniden düzenleme 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ştirmenizi ve harici sistemlerle entegre olmanızı sağlar.

Claude Code kancaları

Claude Code kancaları, Claude Code oturumunuz sırasında belirli olaylar meydana geldiğinde kabuk komutlarını çalıştıran otomatik tetikleyicilerdir. Claude'un atlayabileceği kod biçimlendirme, test çalıştırma ve güvenlik denetimleri gibi tekrarlayan görevleri otomatikleştirirler.

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

• Olay: Kanca ne zaman tetiklenir?

• Eşleştirici: Hangi eylemler etkilenir?

• Komut: Kanca tetiklendiğinde ne çalışır?

Örneğin, bir kanca Claude bir Python dosyası yazdıktan sonra tetiklenebilir ve kodu biçimlendirmek için otomatik olarak black çalıştırabilir. Kancalar, ne olduğuna dair JSON bağlamı alır ve dosya türlerine veya yollara göre akıllı kararlar vermeyi sağlar. Claude'un transkriptine çıktı verebilir 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 lint ve biçimlendiricileri otomatik çalıştırın

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

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

• Dokümantasyon: Kaynak dosyalar değişince API dokümantasyonunu otomatik üretin

• Git otomasyonu: Akıllı commit'ler oluşturun ve dal koruma ilkelerini doğrulayın

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

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

Kancaları Claude Code içinde /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 boru hatları, proje yönetim araçları ve ekip iletişim platformları gibi daha geniş geliştirme ekosisteminize entegre olur.

Eklentiler, birden çok bileşeni—alt ajanlar (belirli görevler için uzmanlaşmış Claude asistanları), MCP sunucuları (standartlaştırılmış araç entegrasyonları) ve kancalar—tek bir pakette birleştirip birlikte orkestre edebilir.

Bir eklenti kod değişikliklerini analiz edip Jira'da otomatik olarak iş oluşturabilir veya dahili test altyapınıza bağlanabilir. Eklentiler, kancalarla aynı olaylara yanıt verir ancak verileri harici hizmetlere gönderir ve yanıtlara göre Claude'un iş akışını etkiler.

Claude Code eklentilerinin çok iyi olduğu bazı görevler ş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 iş oluşturun veya güncelleyin

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

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

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

• Özel araçlar: Şirketinize ait sistemler ve iş akışlarıyla entegre olun

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

Eklentileri bir kaynaktan yükleyin veya kurum içinde 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ı genişleten birkaç önemli kabiliyet daha ekledi:

• Plan modu: Claude'un herhangi bir kod yazmadan önce ayrıntılı bir uygulama planı oluşturduğu tasarım öncelikli iş akışı. Önemsiz olmayan her görev için bunu kullanıyorum.
• Otomatik mod: Claude'un daha az kesintiyle çalışmasını sağlayan bir izin sınıflandırıcı. Her dosya yazımını onaylamak istemediğiniz daha uzun görevlerde faydalıdır.
• Rutinler: Cron takvimine, bir GitHub olayına (ör. PR açıldı) veya bir webhook çağrısına göre tetiklenen zamanlanmış bulut ajanları. Makinenizin çalışmasına gerek yoktur.
• IDE entegrasyonu: Claude Code, satır içi karşılaştırmalar, kontrol noktaları ve çoklu oturum desteğiyle VS Code, Cursor ve JetBrains IDE'leri için resmî uzantılara sahiptir.
• Uzaktan kontrol ve Kanallar: Claude Code oturumlarını çalıştırın ve telefonunuzdan veya diğer cihazlardan onlarla etkileşime geçin.

Son Düşünceler

Bu eğitimde, Supabase Python SDK'daki bir dosyayı yeniden düzenlemek, belgelemek ve hata ayıklamak için Claude Code kullandım. Kod okunabilirliğini artırdık, yapılandırılmış dokümantasyon ekledik ve içe aktarma sorunlarını çözdük.

Claude Code, plan modu, otomatik mod ve Rutinler gibi özelliklerle aktif olarak gelişiyor; bu nedenle, iş akışınıza nasıl uyduğunu görmek için kendi projelerinizde denemeye değer.

Bir sonraki adımı atmak için, Claude'un bağlam penceresinden en iyi şekilde yararlanmayı öğreten Claude Code En İyi Uygulamalar eğitimimizi okumanızı öneririm. Eğer sıfırdan bir proje kurmak istiyorsanız, Claude Code ile Şartname Odaklı Geliştirme eğitimimizi okumanızı tavsiye ederim.