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örevlerinde 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 yeniden düzenleme: 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ı belirleyin ve 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ı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 çekme isteklerini zahmetsizce üretin.

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 size yardımcı olabilir. Yakın tarihli güncellemeler, otomatik modu (daha az izin kesintisi), plan modunu (tasarım-öncelikli iş akışları) ve Rutinleri (makineniz çalışmadan tetikleyicilerle çalışan zamanlanmış bulut ajanları) ekledi.

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

• Yazılım Geliştiriciler: 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 ile gelir. Pro kullanıcıları Sonnet 4.6 ile başlar, ancak zorlu görevler için Opus modellere geçebilir. Oturum ortasında /model komutuyla model 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 zekâ ajanları da oluşturabilirsiniz.

Anthropic ayrıca, kodlamanın ötesinde günlük dosya ve belge görevlerinde etmen tarzı yardım için Cowork'u tanıttı. Claude Masaüstü 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 etkin faturalandırmalı 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 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 hâlâ mevcut olsa da 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 ile geçiş yapabilirsiniz.

Kurulum tamamlandıktan sonra, proje dizininize gidin ve şunu ç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 faturalandırmasıyla mı 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. Sonra işlem tamam; 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ırlama

Bu demoda, Supabase ile etkileşim için bir açık kaynak Python istemcisi olan supabase-py kitaplığını kullanacağım; Supabase, PostgreSQL üzerine kurulu bir arka uç hizmetidir. 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 (ö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ı kurmak için aşağıdaki komutları terminalinizde teker teker çalıştırın

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

Python ortamınız artık Supabase kitaplığını çalıştırmak için gerekli 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, kod okunabilirliği, yapı ve anlamlı yorum eksikliğiyle ilgili client.py içinde 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 hataları belirleyip düzelteceğiz.

Adım 4: Claude Code ile Deney Yapma

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ündeki her dosya ve klasöre erişime sahip. Şimdi deney yapalım.

Kodu yeniden düzenleme

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

İstem: Supabase klasöründe bulunan client.py dosyasındaki kodu yeniden düzenle.

Claude, devam etmeden önce onay isteyecektir. Değişiklikleri onaylamak için Enter tuşuna basın. Tamamlandığında, Claude Code dosyayı güncelleyecek, değişiklikleri terminalde gösterecek ve yapılan değişikliklerin bir özetini sağlayacaktır.

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

• İçe aktarımların düzenlenmesi:  Claude Code ilişkili içe aktarımları mantıksal bölümlerde (kimlik doğrulama hataları, API türleri, fonksiyon hataları) grupladı, anlaşılır olması için adlandırmaları iyileştirdi ve tutarlılık için gereksiz takma adları kaldırdı.
• Okunabilirliğin artırılması: İçe aktarımları sınıflandırmak için bölüm yorumları eklendi ve daha temiz bir organizasyon için __all__ listesindeki tekrarlar kaldırıldı.
• İstemci seçeneklerinin basitleştirilmesi: Benzer içe aktarımlar tek bir ifadede birleştirilerek çoklu satırlar azaltıldı.

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

Kodu belgeleme

Yeniden düzenlemeye ek olarak, 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.

Claude Code’u client.py içindeki dokümantasyonu iyileştirmek için kullandık; sonuçlar şunlardı:

• Dosyanın amacını açıklayan net modül düzeyi docstring’ler.
• İçe aktarımları 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: Anlaşılabilirliği artırmak için client.py kodunu yorumlar ekleyerek belgele.

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

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

Hataları düzeltme

Hata ayıklama zaman alabilir, ancak Claude Code hata iletilerini analiz ederek, kök nedenleri belirleyerek ve düzeltmeler önererek döngüyü kısaltır. Eksik içe aktarımlar, ç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 kullanabilirsiniz:

1. Sorunu belirleyin:  Hata mesajını Claude ile paylaşın.
2. Düzeltme önerileri alın: Claude’dan olası çözümleri 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 aşağıdaki düzenlemeleri yaptı: 

• Tür yoksayma yorumları: Çözülemeyen içe aktarımlar için IDE ve tür denetimi uyarılarını bastırmak amacıyla # type: ignore yorumu eklendi.
• Tutarlı hata kategorileme: Claude Code, kimlik doğrulama, veritabanı, depolama ve fonksiyonlardan gelen hata içe aktarımlarının açıkça gruplanmasını sağladı.
• Kod okunabilirliğinin korunması: Bazı içe aktarımları kaldırmak yerine neden yoksayıldıkları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 et.

Claude Code Komutları

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

Daha derinlemesine bir bakış için Claude Code eğik çizgi komutları kılavuzumuza göz atmanızı öneririm.

Gelişmiş Claude Code Özellikleri

Yeniden düzenleme ve hata ayıklamanın temellerinde kendinizi rahat hissettikten sonra, davranışını özelleştirerek Claude Code’un yeteneklerini genişletebilirsiniz. Kancalar ve Eklentiler tekrarlayan görevleri otomatikleştirmenize ve harici sistemleri entegre etmenize 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, test çalıştırma ve güvenlik kontrolleri gibi tekrarlayan görevleri otomatikleştirirler.

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

• Olay: Kanca ne zaman tetiklenir?

• Eşleştirici: Hangi eylemler 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ğuna dair JSON bağlamı alır; bu da dosya türleri veya yollarına göre akıllı kararlar verilmesini sağlar. Çıktıyı Claude’un transkriptine yazabilir veya işlemleri engellemek için hata iletilerini 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ı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 yapılan değişiklikleri engelleyin

• Dokümantasyon: Kaynak dosyalar değiştiğinde 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 uyarın

• Uyumluluk: Değişikliklere izin vermeden önce lisans başlıklarını veya kodlama standartlarını dayatı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 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 uzman 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 sorunlar açabilir veya dahili test altyapınıza bağlanabilir. Eklentiler, kancalarla 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 başarılı olduğu bazı görevler:

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

• Proje yönetimi: Jira, GitHub veya Linear’da sorunları otomatik oluşturun veya güncelleyin

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

• Kod inceleme: GitHub/GitLab üzerinde otomatik çekme istekleri oluşturun ve incelemeleri yönetin

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

• Özel araçlar: Şirketinize özel sistem ve iş akışlarıyla entegre edin

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

Eklentileri bir kayıt defterinden 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 nerede ve nasıl kullanabileceğinizi 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 iş akışı. Önemsiz olmayan her görevde bunu kullanıyorum.
• Otomatik mod: Claude’un daha az kesintiyle çalışmasına olanak tanıyan bir izin sınıflandırıcısı; her dosya yazımını onaylamak istemediğiniz uzun görevler için kullanışlıdır.
• Rutinler: Cron zamanlamasıyla, bir GitHub olayıyla (örneğin PR açıldı) veya bir webhook çağrısıyla tetiklenen zamanlanmış bulut ajanları. Makinenizin çalışması gerekmez.
• IDE entegrasyonu: Claude Code’un VS Code, Cursor ve JetBrains IDE’leri için satır içi farklar, kontrol noktaları ve çoklu oturum desteği sunan resmi uzantıları vardır.
• Uzaktan kontrol ve Kanallar: Claude Code oturumlarını çalıştırın ve telefonunuzdan veya diğer cihazlarınızdan etkileşime geçin.

Son Düşünceler

Bu eğitimde, Supabase Python SDK’sındaki bir dosyayı yeniden düzenlemek, belgeleme eklemek ve hata ayıklamak için Claude Code’u 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 yüzden kendi projelerinizle deneyerek iş akışınıza nasıl uyduğunu görmeye 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. Sıfırdan bir proje kurmak isterseniz, Claude Code ile Şartname Odaklı Geliştirme eğitimimizi okumanızı tavsiye ederim.