Claude Code ilk bakışta zor görünebilir.
Terminal, MCP, hooks, Skills ve API gibi terimler bir anda karşınıza çıkıyor ve ilk saatte kaybolmanız çok kolay.
Bu yazıda, Claude Code'u "bir öğretmenin iki ortaokul öğrencisine ders anlattığı bir ders" olarak düzenleyeceğim.
Sonunda, temel işlemleri, harici entegrasyonları, Skills, hafıza, hooks, MCP ve API'yi hangi sırayla öğreneceğinizi anlayacaksınız.
Başlık görseli yapay zeka tarafından oluşturuldu. Prompt bu makalede mevcut.
Claude Code Sadece "Cevap Veren Bir Yapay Zeka" Değil, "Harekete Geçen Bir Yapay Zeka"dır
Claude Code sadece soruları yanıtlamaz; bilgisayarınızda görevleri yerine getiren bir yapay zekadır.
Resmi dokümanlarda, dosyaları düzenleyebilen, komutları çalıştırabilen, git işlemleri yapabilen ve MCP ile entegre olabilen bir ajan tipi geliştirme aracı olarak tanımlanır.
Bunu kavradığınızda, tüm işlevler birbirine bağlanır.
Öğretmen bunu tahtaya yazdı:
"Sohbet yapay zekası, tavsiye veren bir öğretmendir. Claude Code ise sınıfta sizinle birlikte çalışan bir sınıf başkanıdır."
Mina soruyor:
"Peki Claude Code sadece programlama bilenler için mi?"
Öğretmen başını sallıyor.
"İlk olarak kod yazma aracı olarak ünlendi. Ancak özü, klasörleri okuyan, dosyaları düzelten ve prosedürleri yürüten bir yapay zeka. Yazı, belge, web sayfası, araştırma notları ve ders materyali oluşturmak için kullanılabilir."
Ren diyor ki:
"Yani ChatGPT'ye 'bir makale yaz' demek yerine Claude Code'a 'şu klasöre bak, düzelt ve kontrol et' diyebilirim."
Aynen öyle.
Claude Code'u öğretirken bu üç kategoriyle başlamak yeterlidir:
- Oku
- Düzelt
- Kontrol et
Örneğin, öğretmen okul festivali için bir web sayfası oluşturma dersi veriyorsa, Claude Code'a şöyle sorardı.
Burada önemli olan, yapay zekadan sadece bir "cevap" istememek. Claude Code'a bir dizi görev veriyorsunuz.
İçindekiler
- Claude Code Sadece "Cevap Veren Bir Yapay Zeka" Değil, "Harekete Geçen Bir Yapay Zeka"dır
- Temel İşlemler: "İste, Onayla, Düzelt"
- Bellek: Öğretmenin Devir Teslim Notu
- Beceriler: Özel Hareket Kartları
- Kancalar: Zil ve Devriye Memuru
- MCP: Okul Gezisi Otobüsü
- API ve SDK: Claude Code'u Bir Parça Olarak Kullanma
- Başlangıç İçin 30 Dakikalık Pratik Menüsü
Temel İşlemler: "İste, Onayla, Düzelt"
Claude Code'un temelleri, isteme, onaylama ve düzeltme akışını içerir.
Zor komutları ezberlemektense, bu konuşma modelini öğrenerek daha hızlı ilerlersiniz.
İlk başta, "tek seferde tamamlama" yerine "birlikte düzeltme" varsayımıyla kullanın.
Öğretmen iki öğrenciye ilk modeli verdi.
Mina rahatlamış bir yüzle diyor ki:
"Her şeyi aniden değiştireceğinden korkuyordum. Sadece önce önermesini istemem gerekiyormuş."
Öğretmen cevap veriyor:
"Evet. Claude Code'un kendi başına çalışmasına izin vermektense, onay noktaları oluşturmak daha güvenlidir."
Temel kullanım şu beş maddeden oluşur:
- Diyaloğu başlatmak için
claude - İlk isteği iletmek için
claude "istek içeriği" - Tek seferlik etkileşimsiz çalıştırma için
claude -p "istek içeriği" - Mevcut komutları kontrol etmek için
/help - Durumu kontrol etmek için
/status
Ancak, ortaokul öğrencilerine en baştan her şeyi öğretmeye gerek yok. İlk derste sadece claude'u açıp bir cümle söylemek yeterlidir.
Ren diyor ki:
"İlk söylenecek şey buysa, korkutucu değilmiş."
Öğretmen devam ediyor:
"Doğru. Claude Code'u nasıl kullanacağını sorarken de kullanabilirsin. Anlamadıysan, kullanımın kendisini sor."
Temel işlemlerin amacı komut ezberlemek değildir. Amaç, insanın yapay zekaya bırakacağı işin kapsamına karar vermesidir.
Bellek: Öğretmenin Devir Teslim Notu
Bellek, Claude Code'un her seferinde okumasını istediğiniz ön kabulleri yazdığınız yerdir.
Resmi dokümanlarda, kullanıcılar veya projeler için farklı talimat dosyaları kullanmaya yarayan bir sistem olarak açıklanır. Sınıf ortamında, öğretmenler arasındaki bir devir teslim notu gibidir.
Öğretmen tahtaya CLAUDE.md yazdı.
Mina soruyor:
"Bu nedir?"
Öğretmen cevaplıyor:
"Claude Code'un çalışmaya başlamadan önce okuduğu sınıf kural kitabı."
Bir okul festivali projesi için şöyle yazılabilir.
Ren diyor ki:
"Yani bunu her seferinde söylemek zorunda değilim."
Öğretmen başını sallıyor.
"Aynen öyle. Her seferinde aynı şeyi açıklıyorsan, Bellek'e koy."
Bellek için uygun bilgiler şunlardır:
- Proje hedefleri
- Yazım stili veya tasarım kuralları
- Sık kullanılan komutlar
- Dokunulmaması gereken dosyalar
Tersine, bazı bilgiler Bellek için uygun değildir:
- Sadece bugüne özel istekler
- Onaylanmamış fikirler
- Parolalar veya API anahtarları
- Kişisel bilgiler
Bir ortaokul öğrencisine öğretirken şöyle aktarılabilir:
"Bellek, yapay zekayı daha akıllı yapan bir sihir değildir. Her seferinde unutmasını istemediğiniz kurallar için bir defterdir."
Bu açıklama yeterlidir.
Beceriler: Özel Hareket Kartları
Beceriler, sık kullanılan iş prosedürlerinin çağrılabilir bir formata dönüştürülmüş halidir.
Resmi dokümanlarda, SKILL.md etrafında şekillenen, şablonları, örnekleri, komut dosyalarını ve referans materyallerini düzenleyen bir sistem olarak açıklanır. Sınıfta bunlar, sadece ihtiyaç duyulduğunda çıkarılan özel hareket kartları gibidir.
Öğretmen üç kart çizdi:
- Kitap Raporu Kontrolü
- Okul Festivali Sayfası Oluşturma
- İngilizce Kelime Testi Oluşturma
Mina soruyor:
"Bunun bir prompt koleksiyonundan farkı ne?"
Öğretmen cevaplıyor:
"Prompt koleksiyonu, her seferinde yapıştırdığınız bir kağıt parçasıdır. Beceriler ise Claude Code'un alet kutusunda sakladığınız kartlardır."
Bir Beceri'nin temel yapısı şöyledir:
SKILL.md dosyasına ne zaman kullanılacağını, ne yapılacağını ve neyin okunacağını yazarsınız. Claude Code, konuşmaya uyan bir Beceri'yi otomatik olarak kullanabilir veya kullanıcı /beceri-adi ile çağırabilir.
Ren diyor ki:
"Yani öğretmenin her zaman kullandığı düzeltme kurallarını bir Beceri'ye dönüştürebilirim."
Aynen öyle.
Bir Kitap Raporu Becerisi için şöyle tasarlanır.
Burada önemli olan her şeyi Beceri'ye dönüştürmemek. Tek seferlik bir istek için, anında sormak yeterlidir.
Beceri'ye dönüştürülmesi gereken görevler şu kriterleri karşılar:
- Birçok kez tekrarlanır
- Sabit bir prosedürü vardır
- Değerlendirme kriterleri vardır
- Referans materyalleri veya şablonları vardır
- Kişiye göre kalitesi değişme eğilimindedir
Öğretmen son olarak şunu söyledi:
"Beceriler, yapay zekaya yetenek eklemez. İnsan prosedürlerini yeniden kullanılabilir bir formata dönüştürür."
Lütfen Claude Code Dictionary sitesini de kullanın.
Kancalar: Zil ve Devriye Memuru
Kancalar, Claude Code'un çalışmasından önce veya sonra otomatik olarak çalışan mekanizmalardır.
Resmi dokümanlarda, PreToolUse veya PostToolUse gibi belirli olaylara göre komutları veya işlemleri çalıştıracak şekilde ayarlanan mekanizmalar olarak açıklanır. Sınıfta bunlar, zil ve devriye memurudur.
Mina soruyor:
"Zil mi?"
Öğretmen cevaplıyor:
"Evet. Ders başlamadan önce çalar. Teslimden önce çalar. Tehlikeli bir yere gitmeye çalışırsan seni durdurur. Kancalar işte budur."
Örneğin, Claude Code bir dosyayı yeniden yazmadan önce şöyle bir devriye yapabilir:
.envdosyasına dokunmaya çalışıyor mu?- Önemli yapılandırma dosyalarını bozmaya çalışıyor mu?
- Yeniden yazdıktan sonra testleri çalıştırmalı mı?
- Metni biçimlendirmeli mi?
- Bir günlük bırakmalı mı?
Ren'in gözleri parlıyor:
"Yani yapay zeka hata yapmak üzereyken onu durdurabilirsiniz!"
Öğretmen biraz sert bir dille diyor ki:
"Ancak kancalar güçlü araçlardır. Kabuk komutlarını otomatik olarak çalıştırabildikleri için, anlamadan eklenirlerse tehlikelidirler."
Kancaları ortaokul öğrencilerine açıklarken, ilk başta ayarları yazdırmaya gerek yoktur. Sadece rolleri öğretin:
Çalışmadan önce: Tehlikeli işlemleri durdur. Çalışmadan sonra: Testleri veya kontrolleri çalıştır. Tamamlandığında: Bitmemiş görevleri kontrol et.
Pratikte, bunları şu sırayla tanıtın:
- Önce, manuel olarak kontrol edin.
- Aynı kontrol birçok kez ortaya çıkıyorsa, bir kontrol listesi yapın.
- Kontrol listesi stabil hale geldiğinde, onu bir kancaya dönüştürün.
Aniden otomatikleştirmeyin. Bir insanın anlamadığı bir kontrolü otomatikleştirirseniz, başarısızlık da otomatikleşir.
Öğretmen tahtaya yazdı:
"Kancalar uygun robotlar değil, sizin belirlediğiniz kurallara uyan devriye memurlarıdır."
MCP: Okul Gezisi Otobüsü
MCP (Model Context Protocol), Claude Code'u harici hizmetlere ve verilere bağlamak için kullanılan bir mekanizmadır.
Resmi dokümanlarda MCP, yapay zeka araçlarını harici veri kaynaklarıyla bağlamak için açık bir standart olarak açıklanır. Sınıfta, sınıfın dışına çıkmak için kullanılan okul gezisi otobüsüdür.
Öğretmen sınıfın bir resmini çizdi. Dışarıya kütüphane, öğretmenler odası, belediye binası ve bir müze çizdi.
Ren diyor ki:
"Claude Code sınıfın dışına çıkabiliyor mu?"
Öğretmen cevaplıyor:
"İşte bu resim. MCP'yi bağladığınızda, Claude Code GitHub, Sentry, PostgreSQL, Slack, Google Drive ve Figma gibi harici bilgilere erişebilir."
Tabii ki her şeyi serbestçe görmesine izin vermezsiniz. Bağlantı sunucusuna, kimlik doğrulamaya ve izinlere siz karar verirsiniz.
Claude Code'un MCP ayarlarında, HTTP sunucuları veya yerel olarak çalışan stdio sunucuları ekleyebilirsiniz.
Mina endişeli bir sesle diyor ki:
"Dışarıya bağlanmak biraz korkutucu."
Öğretmen cevaplıyor:
"Bu his doğru. MCP kullanışlıdır, ancak ne kadar çok bağlantı kurarsanız, o kadar çok bilgiye dokunabilir. Bu nedenle, salt okunur ile başlayın."
MCP'yi öğretme sırası şöyledir:
- Önce, sadece yerel dosyaları kullanın.
- Ardından, güvenli salt okunur verilere bağlanın.
- Daha sonra, GitHub veya bilet yönetimine bağlanın.
- Son olarak, yazma veya üretim verilerini düşünün.
MCP'nin değeri, yapay zekanın daha akıllı olması değildir. Yapay zekanın iş için ihtiyaç duyduğu materyalleri kendi başına gidip alabilmesidir.
Öğretmen özetliyor:
"MCP, yapay zekaya dış dünyayı gösteren otobüstür. Ancak nereye gitmesine izin verileceğine öğretmen karar verir."
API ve SDK: Claude Code'u Bir Parça Olarak Kullanma
API (Uygulama Programlama Arayüzü) ve SDK (Yazılım Geliştirme Kiti), Claude Code'u uygulamalara veya otomatik süreçlere dahil etme yollarıdır.
Resmi dokümanlarda Claude Code SDK, CLI, TypeScript ve Python'dan kullanılabilen bir sistem olarak açıklanır. Sınıfta bu, sınıf başkanının sınıf dışındaki işlere katılmasının bir yoludur.
Ren soruyor:
"API nedir?"
Öğretmen cevaplıyor:
"Bir insanın ekranda konuşması yerine, bir programdan Claude Code'a iş yapmasını istemek için kullanılan giriş kapısıdır."
Örneğin, normal kullanım şöyle görünür. Bu, bir insanın terminalden bir kez sormasıdır.
SDK'yı kullanarak, Claude Code'u bir uygulama veya toplu işlem içinde çağırabilirsiniz. Python SDK, claude-code-sdk olarak sağlanır ve bir TypeScript SDK da mevcuttur.
Mina soruyor:
"Bu, yeni başlayanların ilk yapması gereken bir şey mi?"
Öğretmen cevaplıyor:
"Hayır. İlk yapmanız gereken bir şey değil."
API'ler ve SDK'lar şu aşamalarda kullanılır:
- Aynı görevi her gün otomatik olarak çalıştırmak istediğinizde.
- CI'da incelemelere veya testlere yardımcı olmak istediğinizde.
- Dahili araçlardan Claude Code'u çağırmak istediğinizde.
- Birden çok işlemi paralel olarak çalıştırmak istediğinizde.
- Sonuçları JSON olarak almak istediğinizde.
Ortaokul öğrencileri için şöyle açıklanabilir:
"Sınıf başkanına elle sormak Claude Code'un temelidir. Yayın odasından otomatik olarak istek göndermek ise API ve SDK'dır."
Kullanışlıdır, ancak en baştan kullanmak kafa karışıklığına neden olur. Sıra şöyledir: Temel Bilgiler, Bellek, Beceriler, MCP, kancalar ve ardından API.
Başlangıç İçin 30 Dakikalık Pratik Menüsü
Claude Code hakkında her şeyi aynı anda öğrenmeniz gerekmez.
İlk 30 dakikada ne yapacağınızı daraltırsanız, korku kaybolur. Ortaokul öğrencilerine öğretirken, önce küçük başarı deneyimleri yaratın.
Öğretmen son olarak 30 dakikalık bir ders menüsü sundu.
Mina diyor ki:
"Bence bunu derste yapabilirim!"
Ren diyor ki:
"Yani MCP ve kancalar sonra gelebilir."
Öğretmen cevaplıyor:
"Evet. Sıra önemlidir. Doğrudan harici entegrasyona veya otomatik çalıştırmaya giderseniz, ne olduğunu anlamazsınız."
İlk üç hedef şunlardır:
- Claude Code'un bir klasörü açıklamasını sağlayın.
- Küçük bir dosyayı düzelttirin.
- Düzeltmenin nedenini açıklatın.
Bu kadarı yapabiliyorsanız, Claude Code'un özünü kavramışsınızdır. Bundan sonra, ihtiyaçlarınıza göre ilerleyin:
- Her seferinde aynı şeyi açıklamak zor geliyorsa: Bellek.
- Her seferinde aynı görevi yapıyorsanız: Beceriler.
- Harici materyaller göstermek istiyorsanız: MCP.
- Kontrolleri otomatikleştirmek istiyorsanız: kancalar.
- Bir sisteme entegre etmek istiyorsanız: API ve SDK.
Claude Code, işlevleri ezberlemek için bir araç değildir. İşi nasıl devredeceğinizi geliştirmek için bir araçtır.
Öğretmen son olarak şunu söyledi:
"Yapay zekayı kullanabilen insanlar, yapay zeka konusunda uzman olanlar değildir. İşi bölebilen, kuralları devredebilen ve kontrolleri yapabilen insanlardır."
Bu, Claude Code'u ortaokul öğrencilerine öğretirken en önemli sonuçtur.
İlgili Makaleler
[Yeni Başlayanlar İçin Uygun] Claude Code Bireysel Destek
*İlk 10 kişi için erken kuş kontenjanı tükendi.
Claude Code Tasarım Desenleri
~Klasör Yapısı, Beceriler, veritabanı ve içerik oluşturma akışları tamamen açıklandı~
Sorgular, bireysel danışmanlık ve kurumsal eğitim talepleri için:
