İçeriğe geçİçeriğe geç
Ders bul
Panelim

Yazılımcılar için Claude: Claude Code ve API rehberi

Yazılımcılar için Claude: Claude Code ve API rehberi kapak görseli

Bu rehber, kod yazan, hata ayıklayan ya da bir ürünü Claude ile besleyen yazılımcılar için sıralı bir yol çizer. Önce kod ve gizli bilgi sınırı, sonra Claude Code ile günlük çalışma düzeni, sonra MCP ve API, en sonda değerlendirme ve ajan kurmak gelir. Sitedeki bu derslerin çoğu ileri düzeydedir; her adım gerçek bir geliştirme işine bağlandı.

Bu rehber kimin için?

Kod okuyup yazabilen, terminalde ve bir sürüm kontrol sisteminde rahat çalışan, 18 yaşını doldurmuş kişiler için hazırlandı. Kod bilmiyorsanız önce Claude nasıl kullanılır? İlk sohbetten Skill’lere rehber yazısına bakın.

Bu sayfa araçtan bağımsız bir geliştirici rehberi değildir. Claude Code, Claude API ve MCP yolunu Anthropic’in resmî belgeleri üzerinden izler.

Başlamadan önce

  • Claude hesabı için en az 18 yaşında olmanız gerekir.
  • Kurumunuzun kaynak kod, müşteri verisi ve anahtarlar için yapay zekâ kuralı varsa önce onu öğrenin.
  • Deneme için ayrı, içinde müşteri verisi ve gizli anahtar olmayan küçük bir depo hazırlayın.
  • Claude Code çoğu yüzeyde bir Claude aboneliği ya da Anthropic Console hesabı ister; hangisinin elinizde olduğunu baştan bilin.

Önce bilmeniz gerekenler

Claude Code, Anthropic’in belgelerine göre kod tabanınızı okuyan, dosyaları düzenleyen ve komut çalıştıran, geliştirme araçlarınıza bağlanan bir kodlama aracıdır. Terminalde, kod düzenleyicide, masaüstü uygulamasında ve tarayıcıda çalışır. Çoğu yüzey için Claude aboneliği ya da Anthropic Console hesabı gerekir; masaüstü uygulaması için ücretli abonelik gerekir.

Aracın kalıcı belleği CLAUDE.md dosyasıdır. Belgeye göre bu dosya her oturumun başında okunur, proje için derleme komutlarını, kuralları ve yerleşim bilgisini taşır ve her seferinde yeniden anlatacağınız şeyleri yazdığınız yerdir. Belgeler dosyayı 200 satırın altında tutmayı öneriyor, çünkü uzun dosya bağlamı doldurur ve uyumu düşürür. Dosya bir zorlama değil, bağlamdır; kesin yasak için başka mekanizmalar gerekir.

En önemli alışkanlık doğrulamadır. Claude Code’un en iyi uygulamalar sayfasına göre Claude’un işi bitti deyip aslında bitirmemiş olması çoğunlukla kendi işini yoklayacak bir yolu olmamasından kaynaklanır. Sayfa ona bir kontrol vermenizi (testleri çalıştırıp geçene kadar sürdürmek gibi), kanıt, yani çalıştırılan komutu ve çıktısını istemenizi ve incelemeyi yazan oturumdan bağımsız bir oturumda yaptırmayı öneriyor. İlgisiz bir göreve geçerken bağlamı temizlemek de aynı sayfada yer alıyor.

Claude’un yanlış bilgi üretme riski API tarafında da geçerli. Anthropic’in belgeleri “bilmiyorum” demesine izin vermeyi, uzun belgelerde önce birebir alıntı çıkarmayı ve iddiaları kaynakla desteklemeyi sayıyor, ama bu tekniklerin uydurmayı azalttığını, tamamen ortadan kaldırmadığını açıkça söylüyor.

Anahtar ve bağlayıcı güvenliği ayrı bir konudur. Anthropic’in anahtar rehberi anahtarın paylaşılmamasını, kod ve yapılandırma dosyalarına yazılmamasını, ortam değişkeniyle saklanmasını ve ele geçirildiğinde derhâl iptal edilmesini söylüyor. Claude Code belgeleri, bir MCP sunucusunu bağlamadan önce ona güvenmenizi ve dış içerik getiren sunucuların komut enjeksiyonu (prompt injection) riski taşıdığını hatırlatıyor. Kişisel Verileri Koruma Kurumunun (KVKK) iş yeri belgesi de kaynak kodun ve ticari sırların harici yapay zekâ araçlarıyla paylaşılmasını fikrî mülkiyet ve gizlilik riski olarak sayıyor.

Adım adım öğrenme yolu

  1. Yazılım geliştirici için yapay zekâ: Hata mesajı, birim testi ve eski kodu toparlama: Hata mesajı, birim testi ve eski kod işlerinde yapay zekâdan yararlanmayı, araca neyin girip neyin girmeyeceğini ve çıkan kodu denetlemeyi öğrenirsiniz. Örnek: Üretimden gelen bir hata kaydındaki müşteri e-postasını ve token’ları silip yapıştırır, olası nedenleri olasılık sırasıyla listelettirirsiniz.
  2. Claude Code’a giriş: kurulum ve ilk çalışma düzeni: Claude Code’u kurmayı, ilk oturumu açmayı ve işi keşfet, planla, uygula, kaydet sırasıyla yürütmeyi öğrenirsiniz. Örnek: Denemelik bir klasörde projeyi önce anlattırır, plan modunda plan istersiniz; siz onaylamadan hiçbir şeyi değiştirmez. Sonra küçük bir değişikliği commit ettirirsiniz.
  3. Claude Code ile proje: CLAUDE.md, subagent’lar ve Git: CLAUDE.md ile kalıcı kural vermeyi, bir alt ajan (subagent) tanımlamayı ve Git işlemlerini Claude Code ile yapmayı öğrenirsiniz. Örnek: Depo köküne “testler npm test ile çalışır, dal adı feature ile başlar” yazan kısa bir CLAUDE.md koyar, yalnız okuyabilen bir inceleme alt ajanı tanımlarsınız.
  4. Bağlam penceresi nedir, dolduğunu nasıl anlarsınız? Özetleyip sürdürmek mi, yeni sohbet mi?: Bağlam penceresinin dolduğunu nasıl anlayacağınızı, özetleyip sürdürme ile yeni sohbet arasında nasıl seçeceğinizi ve Claude Code’da /compact ile /clear farkını öğrenirsiniz. Örnek: Konu değişince /clear ile boş bir konuşma açar, aynı iş sürerken /compact’e neyi koruyacağını yazarsınız.
  5. Yapay zekâya ‘onaylıyor musun’ diye sormak yerine çapraz sorgu yaptırmak: Claude’a “onaylıyor musun” diye sormanın neden yanıltıcı olduğunu, karşı görüş, kaynak ve yeni sohbette bağımsız kontrol yaptırmayı öğrenirsiniz. Örnek: Hazırladığınız planı “onaylıyor musun” diye sormak yerine yeni bir sohbette en zayıf üç noktasını yazdırırsınız.
  6. MCP: Claude’u dış araçlara bağlayan standart: MCP’nin ne olduğunu, Claude Code’a sunucu eklemeyi ve çok küçük bir sunucu yazmayı öğrenirsiniz. Örnek: Güvendiğiniz hazır bir MCP sunucusunu claude mcp add ile ekler, /mcp ile durumuna bakar, sonra tek araçlı küçük bir sunucuyu Claude Code’a yazdırırsınız.
  7. MCP bağlayıcısı ve API anahtarı eklemek: Anahtarı sohbete yazmadan güvenli kurulum: Anahtarı sohbete yazmadan MCP bağlayıcısı eklemeyi, yetkiyi sınırlamayı ve anahtar sızarsa ilk dakikalarda ne yapacağınızı öğrenirsiniz. Örnek: Tanımadığınız bir sunucu adresini bağlamaz, anahtarı sohbete yazmaz, yalnız bu iş için yalnız okuma yetkili yeni bir anahtar üretirsiniz.
  8. Claude API’ye giriş: anahtar, model seçimi ve araç kullanımı: API anahtarı almayı ve saklamayı, ilk isteği göndermeyi, model seçimini ve araç kullanımının temellerini öğrenirsiniz. Örnek: Console’dan anahtar alır, ortam değişkenine koyar ve belgedeki Python örneğine dayanan ilk isteği gönderirsiniz.
  9. Kalite ve güvenlik: Değerlendirme, halüsinasyon ve korkuluklar: Ölçülebilir başarı ölçütü yazmayı, basit bir değerlendirme (eval) kurmayı, uydurmayı azaltmayı ve komut enjeksiyonuna karşı katmanlı korumayı öğrenirsiniz. Örnek: Şikâyet e-postalarını kategoriye ayıran bir asistan için “50 örneğin en az yüzde 90’ı doğru” gibi ölçülebilir bir ölçüt yazar, aynı örneklerle sınarsınız.
  10. Ajan kurmak: Skill’ler, alt ajanlar ve Agent SDK: Skill ile alt ajanın görevlerini, Agent SDK’nın temelini ve harcamaya sınır koymayı öğrenirsiniz. Örnek: Toplantı notlarını özetleyen bir Skill ile yalnız okuyabilen bir denetçi alt ajan kurar, harcamaya üst sınır koyarsınız.

Sık yapılan hatalar

  • Üretim hata kaydını müşteri verisi ve token’larıyla birlikte yapıştırmak.
  • “Testler geçti” cümlesini çıktısını görmeden kabul etmek.
  • CLAUDE.md dosyasını yüzlerce satıra çıkarıp işe yaramaz hâle getirmek.
  • Güvenmediğiniz bir MCP sunucusunu, içeriğini okumadan bağlamak.
  • API anahtarını sohbete yazmak, koda gömmek ya da depoya göndermek.

Sık sorulanlar

Claude Code için abonelik gerekir mi?

Anthropic’in belgelerine göre çoğu yüzey için Claude aboneliği ya da Anthropic Console hesabı gerekir. Masaüstü uygulaması için ücretli abonelik istenir. Güncel koşullar için resmî sayfaya bakın.

CLAUDE.md ne kadar uzun olmalı?

Belgeler her dosya için 200 satırın altını öneriyor. Daha uzun dosya bağlamı tüketir ve talimatlara uyumu düşürür. Yalnız her oturumda gereken olgulara yer verin.

Şirketin kaynak kodunu Claude’a verebilir miyim?

KVKK’nın iş yeri belgesi, kaynak kodun ve ticari sırların harici araçlarla paylaşılmasını fikrî mülkiyet ve gizlilik riski olarak sayıyor. Kurumunuzun kuralı ve onaylı hesabınız yoksa vermeyin.

API anahtarım sızdıysa ne yapmalıyım?

Anthropic’in anahtar rehberi, anahtar ele geçirildiyse derhâl iptal edilmesini öneriyor. Anahtarı Console’daki API anahtarları sayfasından silin, yenisini ortam değişkenine koyun.

Son kontrol listesi

  • Kod, hata kaydı ve yapıştırdığım metinde müşteri verisi ve anahtar yok.
  • Her Claude Code değişikliğinde testlerin çıktısını gördüm.
  • CLAUDE.md kısa ve yalnız kalıcı kuralları taşıyor.
  • Bağladığım her MCP sunucusuna güveniyorum ve yetkisini sınırladım.
  • API anahtarım ortam değişkeninde; depoda ve sohbette yok.
  • Başarı ölçütünü yazdım ve aynı örneklerle düzenli sınıyorum.

Bu rehberden sonra

Yolun sonunda sitede bir bitirme ödevi var: İleri bitirme ödevi: Kendi ajanınızı kurun ve test edin. Aynı işi her hafta yapıyorsanız Skill’ler dersine bakın.

Claude sohbetinin genel özellikleri için Claude nasıl kullanılır? İlk sohbetten Skill’lere rehber yazısı var.

Bu rehberle ilgili kurslar

Bu rehberdeki konuları sıralı dersler, öz sınama ve bitirme uygulamasıyla çalışmak için:

Kaynaklar

Son kontrol: 10 Kasım 2026