Claude Code iş başında

Bu modül için tahmini süre: 10 dakika

Genel bakış

Claude Code yalnızca kod yazmak için bir tool değildir — bir yazılım projesinin her aşamasında yanınızda çalışacak şekilde tasarlanmıştır. İlk kurulumdan deploy ve destek aşamasına kadar her şeyi üstlenebilen bir mühendis arkadaş olarak düşünebilirsiniz. Bu derste /init, etkili workflow desenleri ve test-driven development’i göreceksiniz.

Claude Code yalnızca kod yazmak için bir tool değildir — bir yazılım projesinin her aşamasında yanınızda çalışacak şekilde tasarlanmıştır. İlk kurulumdan deploy ve destek aşamasına kadar her şeyi üstlenebilen bir mühendis arkadaş olarak düşünebilirsiniz.

/init komutu

Bir projede Claude Code ile çalışmaya başladığınızda yapacağınız ilk şey /init komutunu çalıştırmaktır. Bu komut Claude’a tüm codebase’inizi taramasını ve proje yapınızı, bağımlılıkları, coding style’ı ve mimariyi anlamasını söyler.

Claude öğrendiği her şeyi CLAUDE.md adlı özel bir dosyaya özetler. Bu dosya tüm gelecek konuşmalara otomatik olarak context olarak dahil edilir; böylece Claude projenize dair önemli detayları hatırlar.

Farklı scope’lar için birden fazla CLAUDE.md dosyanız olabilir:

• Project — Projede çalışan tüm mühendisler arasında paylaşılır
• Local — Git’e checked-in edilmeyen kişisel notlarınız
• User — Tüm projelerinizde kullanılır

/init çalıştırırken Claude’un odaklanmasını istediğiniz alanlar için özel yönergeler ekleyebilirsiniz. Üretilen dosya build komutları, coding kuralları ve Claude’un izlemesi gereken projeye özgü pattern’leri içerir.

# komutunu kullanarak CLAUDE.md dosyanıza hızlıca not da ekleyebilirsiniz. Örneğin # Always use descriptive variable names yazmak, bu yönergeyi project / local / user memory’lerinden hangisine ekleyeceğinizi sorar.

Yaygın workflow’lar

Claude, ona bir effort multiplier (çabanızı katlayan bir partner) olarak yaklaştığınızda en iyi çalışır. Ne kadar fazla context ve yapı sağlarsanız, o kadar iyi sonuç alırsınız. İşte en etkili akış:

Adım 1: Claude’a context besleyin

Claude’dan bir şey inşa etmesini istemeden önce, oluşturmak istediğiniz özellikle ilgili codebase’inizdeki dosyaları belirleyin. Önce Claude’dan bu dosyaları okumasını ve analiz etmesini isteyin. Bu, Claude’a üzerine inşa edebileceği coding pattern’lerinizi ve mevcut işlevselliği gösterir.

Adım 2: Çözüm planı isteyin

Doğrudan implementasyona atlamak yerine, Claude’dan problemi düşünmesini ve bir plan oluşturmasını isteyin. Henüz kod yazmamasını, sadece yaklaşıma ve gereken adımlara odaklanmasını söyleyin.

Adım 3: Çözümü implement etmesini isteyin

Sağlam bir planınız olduğunda, Claude’dan onu uygulamasını isteyin. Claude, birlikte hazırladığınız context ve plan üzerine kod yazacaktır.

Test-driven development akışı

Daha iyi sonuçlar için test-driven bir yaklaşım kullanabilirsiniz:

1. Context besleyin — Aynı şekilde, Claude’a ilgili dosyaları gösterin
2. Test case fikirleri isteyin — Yeni özelliğinizi neyin doğrulayacağını brainstorm ettirin
3. Testleri yazdırın — En alakalı testleri seçin ve Claude’a yazdırın
4. Testleri geçen kodu yazdırın — Claude, tüm testler geçene kadar implementasyon üzerinde iterate eder

Bu yaklaşım çoğunlukla daha sağlam kod üretir çünkü Claude’un net bir başarı kriteri vardır.

Pratik örnek

Bu workflow’ların pratikte nasıl göründüğüne bakalım. Mevcut bir projeye bir doküman dönüştürme tool’u eklemek istediğinizi varsayın:

// Önce Claude'a ilgili dosyaları okutun
> Read the math.py and document.py files

// Sonra plan isteyin (implementasyon değil)
> Plan to implement document_path_to_markdown tool:
1. Create a function that:
   - Takes a file path parameter
   - Validates the file exists
   - Determines file type from extension
   - Reads binary data from file
   - Leverages existing binary_document_to_markdown function
   - Returns markdown string
2. Add appropriate documentation
3. Register the tool with MCP server
4. Add tests

// Son olarak implementasyon isteyin
> Implement the plan

Claude ardından fonksiyonu oluşturur, gerekli dosyaları günceller, testler yazar ve hatta her şeyin doğru çalıştığını doğrulamak için test suite’i çalıştırır.

Ek komutlar

Claude Code, birkaç yararlı komut içerir:

• /clear — Konuşma geçmişini temizler ve context’i sıfırlar
• /init — Codebase’i tarar ve CLAUDE.md dokümantasyonu oluşturur
• # — CLAUDE.md dosyanıza not ekler

Claude ayrıca git’e değişiklik stage ve commit etmek, testleri çalıştırmak ve bağımlılıkları yönetmek gibi rutin geliştirme görevlerini de halledebilir. Editor ile terminal arasında geçiş yapmak yerine, siz büyük resme odaklanırken bu görevleri Claude’a bırakabilirsiniz.

Claude Code’da başarının anahtarı, onun yalnızca bir kod üreticisi değil; işbirlikçi bir partner olarak tasarlandığını hatırlamaktır. Ne kadar fazla context ve yapı sağlarsanız, Claude projenizi inşa etmenize ve sürdürmenize o kadar etkili yardım eder.

Temel çıkarımlar

• /init, codebase’i tarayıp CLAUDE.md dokümantasyonu üretir
• Üç farklı CLAUDE.md scope’u var: project, local, user
• En iyi akış: context → plan → implementasyon (üç adım)
• Test-driven workflow için: context → test case’ler → testleri yaz → kodu yaz
• /clear, /init ve # temel slash komutlarıdır
• Claude’a context ve yapı sağladıkça çıktı kalitesi artar