Claude Code 2.1: Uygulamalı Örneklerle Bir Rehber

Claude Code, Anthropic tarafından geliştirilen, doğrudan terminalinizde çalışan ve bağlı bir web arayüzü üzerinden de kullanılabilen ajan temelli bir kodlama aracıdır. Yalıtılmış komutlarla çalışmak yerine, Claude Code tüm depoyu anlar, dosyalar arasında muhakeme edebilir, kodu düzenleyebilir ve araçlar çalıştırabilir. 

Önceki sürümlerle karşılaştırıldığında, ki bunlar öncelikle etkileşimli kod yardımına odaklanıyordu, Claude Code 2.1 kod değişikliklerinin nasıl ve ne zaman gerçekleşeceğini etkin biçimde şekillendirebilen ajanlar, kancalar ve yeniden kullanılabilir beceriler için ek destek sunar.

Claude Code, bir düzenleyici ile sohbet arayüzü arasında gidip gelmek yerine, gerçek iş akışlarına doğrudan gömülü yapay zeka desteği isteyen geliştiriciler için tasarlanmıştır. Hâlâ araştırma ön izlemesinde olmasına rağmen, gerçek geliştirme iş akışlarında güçlü pratik fayda göstermektedir. 

Claude modelleri hakkında daha fazla bilgi edinmek isterseniz, Claude Modellerine Giriş kursunu öneririm. Ayrıca Claude Cowork eğitimimize de göz atabilirsiniz.  

Claude Code 2.1’de Neler Yeni?

Claude Code 2.1, ajan odaklı iş akışlarını daha esnek hâle getiren bir dizi yükseltme sunarak temel terminal deneyimi üzerine inşa edilir. Bu değişiklikler, Claude Code’un bir kod tabanını nasıl ele aldığını ve geliştiricilerin gerçek geliştirme görevlerinde onunla nasıl etkileşime geçtiğini genişletir.

Claude Code 2.1’deki en dikkat çekici yeniliklerden bazıları şunlardır:

• Ön bilgi başlığında (frontmatter) ajan ve beceri kancaları; geliştiricilerin, kod düzenlemeleri uygulanmadan önce denetimler ve kısıtlar dayatmasına olanak tanır.
• Çatallanan bağlam, sıcak yeniden yükleme ve özel beceri tanımlarıyla genişletilmiş beceri desteği; yeniden kullanılabilir iş akışlarını daha esnek ve güçlü kılar.
• Eğik çizgi (/) beceri çağrımı; etkileşimli oturumlar sırasında sık kullanılan işlemlere hızlı erişim sağlar.
• Claude Code 2.1’deki ajanlar artık bir araç çağrısı reddedildiğinde muhakemeyi durdurmaz; böylece iş akışları kesintisiz devam edebilir.
• Araç, özellikle çok dilli dokümantasyon, incelemeler ve ekip işbirliği için yararlı olan dil kontrollü yanıtları destekler.
• Bash(*-h*) gibi joker araç izinleri, daha ince ayarlı otomasyon kontrolleri sağlar.
• CLI artık çok satırlı girdi için Shift+Enter destekler; bu da ek kurulum gerektirmeden etkileşimli yazma deneyimini iyileştirir.

Bu rehberde, bu yeni yeteneklerin gerçek projelerde nasıl uygulandığını gösteren bir dizi pratik deneye odaklanıyoruz.

Claude Code Bulut Tabanlı Web Deneyimini Kurma

Claude Code 2.1, tamamen bulutta çalışan web tabanlı bir deneyim olarak sunulur. Bu mod, özellikle işbirliğine dayalı iş akışları, çekme isteği (pull request) incelemeleri ve yerel kurulum gerektirmeden depo düzeyinde otomasyon için kullanışlıdır.

Adım 1: Oturum açın ve Claude Code’a erişin

Başlamak için https://claude.ai/code adresine gidin; Claude Code (Araştırma Ön İzleme) arayüzüne yönlendirileceksiniz. 

Adım 2: Claude Code’u GitHub’a bağlayın

Gerçek depolarla çalışmak için Claude Code’un GitHub erişimine ihtiyacı vardır. GitHub’a Bağlan’a tıklayın; bu işlem Claude GitHub Uygulamasını yükler. 

Yetkilendirme sırasında GitHub sizden aşağıdaki izinleri isteyecektir:

• GitHub kimliğinizi doğrulama
• Claude’un erişebileceği depoları görüntüleme
• Adınıza işlem yapma (ör. dal veya commit oluşturma)

Şunlar arasında seçim yapabilirsiniz:

• Tüm depolar veya
• Yalnızca seçili depolar (daha sıkı kontrol için önerilir)

Tipik izinler şunları içerir:

• Depo meta verilerine ve kontrollerine okuma erişimi
• Koda, sorunlara, çekme isteklerine ve iş akışlarına okuma ve yazma erişimi

Yükle ve Yetkilendir’e tıklayın; daha sonra erişimi doğrudan GitHub uygulama ayarlarından değiştirebilir veya iptal edebilirsiniz. Bu adım, web ortamında çalışırken Claude Code’un depoları okuması, çekme isteği açması ve commit göndermesi için gereklidir.

Adım 3: Bir bulut ortamı oluşturun

İlk oturuma başlamadan önce Claude Code sizden bir bulut ortamı oluşturmanızı ister. Bu ortam, Claude’un ağ erişimini ve yürütme sınırlarını kontrol eder.

Mevcut seçenekler şunlardır:

• Yok: İnternet erişimi yoktur; en yüksek güvenlik için uygundur.
• Güvenilir (önerilir): Doğrulanmış paket kaynaklarına erişim sağlar.
• Tam: Sınırsız internet erişimi sunar.

Çoğu kullanım senaryosu için Güvenilir seçeneği güvenlik ve esneklik arasında en iyi dengeyi sağlar.

Adım 4: Bir web oturumu başlatın

Kurulum tamamlandıktan sonra, aşağıdaki ekran görüntüsünde gösterildiği gibi Claude Code web düzenleyicisine yönlendirilirsiniz.

Buradan şunları yapabilirsiniz:

• Bir depo ve dal seçin
• Yeniden düzenlemeler ve incelemeler çalıştırın
• Yeni dallar ve commit’ler oluşturun
• Önceki oturumlara devam edin (varsa)
• Ortamları değiştirmeden depolar arasında geçiş yapın

Claude Code Terminal Tabanlı CLI Deneyimini Kurma

CLI, Claude Code 2.1 ile çalışmanın en doğrudan yoludur. Yerel geliştirme, adım adım yeniden düzenlemeler ve deponuzda Claude’un ne yaptığı üzerinde ince ayarlı kontrol istediğiniz durumlar için idealdir.

Adım 1: Kurulum

Claude Code, platforma özel bir yükleyici kullanılarak doğrudan terminalden kurulabilir.

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

Kurulum tamamlandığında, Claude Code sürümünü ve kurulum yolunu belirten bir onay mesajı görmelisiniz. Ek kurulum seçenekleri için resmî kurulum rehberine başvurabilirsiniz.

Adım 2: Başlarken

Kurulumdan sonra, projenizin kök dizinine gidin ve Claude Code’u başlatın:

cd your-project-directory
Claude Code

Claude Code başlatıldığında, depoyu anında tarar ve kod tabanına ilişkin ilk anlayışını oluşturur. 

Bu başlangıç bağlamı, Claude Code’un sonraki adımlarda daha etkili muhakeme etmesini sağlar.

Claude Code 2.1 ile Deneyler

Bu demoda, GPT 5.2’den bir projelerimden birini kullandım. İşte projenin hızlı bir özeti.

Claude Code klasör içindeki her dosya ve klasöre erişim sağladığında, deneylere başlayabiliriz.

Çatallanan bağlam becerilerini kullanarak yeniden düzenleme 

Claude Code 2.1’i değerlendirmenin bir parçası olarak, hattı (pipeline) iyileştirmek için depo genelinde bir yeniden düzenleme yaptım. Bu deney, Claude’un yalıtılmış tek dosya düzenlemeleri yapmak yerine birden çok dosya arasında muhakeme edebildiği çatallanan bağlamlı becerileri öne çıkarır.

Komut istemi:

Refactor the CSV parsing and slide generation logic across the repository.
Improve readability, split responsibilities, and avoid duplicated logic.

Claude önce, önerilen modül yapısı, tekrar noktaları ve bir uygulama sırası dâhil olmak üzere ayrıntılı bir yeniden düzenleme planı oluşturur ve ardından herhangi bir şeyi değiştirmeden önce onay ister. 

Onayladıktan sonra Claude, farklılıkları ve ilerlemeyi göstererek yeniden düzenlemeyi artımlı olarak uygular.

Claude Code’u kullanarak şu iyileştirmeleri elde ettim:

• Sorumlulukları modüllere böldüm: Claude, CSV yükleme, dönüşümler, Excel oluşturma, PowerPoint üretimi ve LLM planlamayı (özetle tüm modülleri) özel bileşenlere ayırdı.
• Yinelenen mantığı azalttım: Tekrarlanan yardımcıları (ör. sütun algılama ve biçimlendirme) merkezileştirdi ve paylaşılan sabitleri ortak bir yapılandırma katmanına taşıdı.
• Bakımı iyileştirdim: Claude ayrıca app.py dosyasının boyutunu küçültürken uygulamanın dış davranışını tutarlı tuttu.

İşte değişikliklerden önce ve sonra proje yapısı ile yeniden düzenleme çıktısının bir karşılaştırması.

Önce:

Sonra:

Son olarak aynı yeniden düzenlemeyi Claude Code Web’de denedim. Temel fark iş akışında:

• CLI açık onaylarla adım adım ilerler.
• Web, yeniden düzenlemeyi doğrudan yeni bir dala itebilir; bu da işbirliği ve PR tabanlı iş akışları için uygundur.

Sonunda Claude kodu yeniden düzenledi ve bir dala gönderdi.

Düzenleme öncesi doğrulama kancası

Veri hatları (pipeline) genellikle basit bir nedenle başarısız olur: Girdi CSV şeması, kodun beklediğiyle uyuşmaz. Claude Code 2.1’de, düzenleme öncesi kancalar kullanarak bu tür hataları azaltabilirsiniz. Bu yeni yetenek, Claude’un koda müdahale etmesine izin verilmeden önce bir ajanın doğrulama kontrolleri çalıştırmasına imkân tanır.

Bu örnekte, herhangi bir düzenleme uygulanmadan önce CSV yapısını doğrulayan bir ajan oluşturmasını Claude Code’dan istedim.

Komut istemi:

Create a Claude Code agent that validates the CSV schema before modifying any code. The agent should reject edits if the CSV schema is unclear.

Claude Code önce bir CSV şeması doğrulama ajanı oluşturdu ve iş akışına bağlayarak bekçi (gatekeeper) olarak davranmasını sağladı. CLI çıktısı, Claude’un tek bir betik oluşturmakla kalmadığını; aşağıdakileri içeren küçük bir doğrulama sistemi oluşturduğunu gösteriyor:

• Gerekli sütunları, eksik değerleri ve temel tutarlılığı kontrol eden çekirdek bir şema doğrulayıcı modül.
• Düzenleme öncesi bekçi kancası, düzenlemelere geçmeden önce doğrulamayı otomatik olarak çalıştırır.
• Son olarak, geçerli/geçersiz CSV durumları boyunca doğrulayıcıyı doğrulamak için bir test paketi ve bazı kullanım örnekleri.

Uygulamada iş akışı basitleşir:

• Claude, bir ön koşulu zorunlu kılarak herhangi bir kod değişikliğinden önce şema kontrollerini otomatik olarak çalıştırır.
• Şema belirsiz veya geçersizse, ajan düzenlemeleri katı biçimde engeller ve düzeltmeye rehberlik eden uygulanabilir hata iletileri döndürür.
• Doğrulama geçtikten sonra Claude, değişiklikleri korumalı raylar üzerinde ve öngörülebilir şekilde sürdürür.

Web çıktısı benzer bir sonucu gösterir; ancak önemli bir farkla. Claude Code Web, doğrulama modülü, kanca entegrasyonu, dokümantasyon ve testler dâhil olmak üzere değişiklikleri doğrudan yeni bir dala itebilir. 

Genel olarak Claude Code 2.1, kancaları doğrudan ajanlara ve becerilere gömerek düzenlemeler gerçekleşmeden önce koruma raylarını uygular. Bu da kancaları, girdilerin doğruluğunun çoğu zaman bizzat koddan daha büyük bir hata kaynağı olduğu veri ağırlıklı projelerde özellikle değerli kılar.

Tekrarlanan görevler için eğik çizgi komutlu beceriler

Claude Code 2.1, bir Claude oturumu içinde etkileşimli olarak çağrılabilen veya doğrudan komut satırından çalıştırılabilen, kendi kendine yeten iş akışları olan yeniden kullanılabilir eğik çizgi komutlu beceriler sundu. 

Bu örnekte, bir CSV dosyasını profesyonel bir PowerPoint sunumuna dönüştüren yeniden kullanılabilir bir /generate-slides becerisi oluşturuyoruz.

Komut istemi:

Create a reusable skill called /generate-slides that converts a CSV into a PPT.

İpucu: Girdi isteminin altında görünen özel bir durum satırı yapılandırmak için /statusline kullanın (repo, dal veya mod göstermeye elverişlidir).

Claude Code, dokümantasyon, doğrulama mantığı ve çalıştırılabilir bir Python giriş noktası dâhil olmak üzere, eksiksiz bir beceri tanımını .claude/skills/ altında oluşturur.

• Beceri oluşturma: Claude, amacı, girdileri, doğrulama adımları ve yürütme akışını açıklayan, tam dokümantasyonlu bir generate-slides becerisi yazar.
• Şema doğrulama: Beceri, işleme başlamadan önce CSV şemasını doğrulayarak veri kalitesini ve net hata iletilerini sağlar.
• Yürütme: Beceri, doğrudan terminalden, bağımsız bir komut satırı aracı gibi çalıştırılabilir.
• Hata işleme: Eksik dosyalar, geçersiz şemalar veya eksik API anahtarları net, uygulanabilir hatalara yol açar.
• Otomasyon: Tek bir komut Excel çıktıları, grafikler ve bir PowerPoint destesi üretir.

Beceriyi yerelde şu komutla test edebilirsiniz:

python .claude/skills/generate-slides.py --csv-file kpis.csv

Not: Bunu çalıştırmadan önce API anahtarınızı eklediğinizden emin olun. 

Eğik çizgi komutlu beceriler, Claude Code’u sadece bir asistan olmaktan çıkarıp bir iş akışı motoruna dönüştürür. Aynı görevi tekrar tekrar yeniden istemek yerine, bir kez tanımlayıp projeler, oturumlar ve ortamlar arasında yeniden kullanırsınız. Aşağıda, yeni becerinin eklenmesini yansıtan güncellenmiş depo yapısını görebilirsiniz.

Bu örnek şunları gösterir:

• Beceriler CLI’dan etkileşimli olarak çağrılabilir.
• Claude tarafından üretilen beceriler mevcut kod tabanlarıyla sorunsuz bütünleşir.

Eşzamansız Alt Ajanlar ve Arka Plana Alma

Yapay zekâ kodlama araçlarındaki en büyük sürtünme noktalarından biri "bekleme süresi"dir; yapay zekâ düşünürken veya uzun bir test paketi çalıştırırken yanıp sönen imlece bakmak. Claude Code 2.1 bunu Eşzamansız Alt Ajanlar ile çözer.

Artık uzun süren görevleri—karmaşık bir yeniden düzenleme, bir test çalıştırması veya kapsamlı bir dokümantasyon taraması gibi—Ctrl+B kullanarak arka plana atabilirsiniz. Bu, terminalinizi anında serbest bırakarak şunları yapmanıza olanak tanır:

• Kod tabanını sorgulamaya devam edin.
• İkinci bir paralel görevi kuyruğa alın.
• Claude çalışırken dosyaları elle inceleyin.

Örneğin, Claude app.py modülünü yeniden düzenlerken (planlamak ve yürütmek dakikalar sürebilir), Ctrl+B tuşuna basıp hemen şu soruyu sorabilirsiniz: "Bu çalışırken, auth.py içindeki kimlik doğrulama mantığını açıkla."

Arka plan görevi tamamlandığında Claude sizi bilgilendirir ve bağlamı ana akışınıza geri birleştirebilirsiniz. Bu, Claude Code’u tek iş parçacıklı bir sohbet arayüzünden, kıdemli mühendislerin gerçekte çalıştığı biçimi yansıtan bir çok iş parçacıklı geliştirme ortağına dönüştürür.

Dil kontrollü çıktı 

Claude Code 2.1, özellikle çok dilli ekipler, yerelleştirilmiş dokümantasyon ve İngilizce dışındaki kod incelemeleri için yararlı olan, belirli bir dilde yanıt verecek şekilde yapılandırılabilir. Bu örnekte, Claude’dan deponun slayt üretim hattını tamamen Japonca açıklamasını istedik.

Komut istemi:

Explain the slide generation logic in Japanese.

Claude Japonca yanıt verdi ve uçtan uca akışın yapılandırılmış bir açıklamasını üretti. Çıktıda görüldüğü üzere, yalnızca bir özeti çevirmekle kalmadı; hattı net aşamalara ayırdı ve her adımda yer alan ilgili modüllere referans verdi. CLI çıktısı şunları gösterir:

• Baştan sona Japonca: Yanıt, başlıklar ve madde işaretleri dâhil olmak üzere tamamen Japonca kalır.
• Adım adım akış: Claude hattı ayrı aşamalara böler (CSV doğrulama, veri işleme, Excel çalışma kitabı, LLM planlama ve slayt oluşturma).
• Kod tabanı farkındalığına dayalı referanslar: Anlatırken ilgili dosya ve dizinleri işaret eder ve her bileşenin ne yaptığını açıklar.
• Dokümantasyon tarzı biçimlendirme: Çıktı, dahili dokümanlar gibi okunur; bir README veya işe alım rehberinde tekrar kullanmayı kolaylaştırır.

Not: Bu davranışı bu örnekte yalnızca CLI’da test ettim; ancak aynı dil kontrolü yeteneği genel olarak Claude Code 2.1’in parçasıdır.

Kâğıt üzerinde küçük görünen bu özellik, dokümantasyon ve incelemelerin İngilizce dışındaki dillerde yapılması gerektiğinde pratikte büyük bir verimlilik kazancı sağlar.

Claude Code 2.1 Komutları

İşte Claude Code ile deneyebileceğiniz birkaç komut.

Sonuç

Bu rehberde, CLI ve web iş akışları genelinde uygulamalı deneyler gerçekleştirerek Claude Code 2.1’i inceledik. Claude Code’u, çatallanan bağlam becerileri kullanarak mevcut bir depoyu yeniden düzenlemek, düzenleme öncesi doğrulama kancalarıyla veri güvencelerini uygulamak, yeniden kullanılabilir eğik çizgi komutlu beceriler oluşturmak ve doğrudan kod tabanından dil kontrollü açıklamalar üretmek için kullandık.

Bu örnekler, Claude Code 2.1’in basit yapay zekâ destekli düzenlemenin ötesine geçerek daha ajan odaklı geliştirme iş akışlarına yöneldiğini vurgular. Claude Code 2.1 hâlâ araştırma ön izlemesinde olsa da, gerçek projelerde güçlü pratik değerini şimdiden göstermektedir.