Claude Code nedir? Kurulum ve günlük kullanım rehberi

Claude Code, Anthropic'in yapay zeka modeli Claude'u bilgisayarınızda çalışan bir asistana dönüştüren araç: dosyalarınızı görebiliyor, kod yazıp çalıştırabiliyor ve sizin yerinize otomasyon kuruyor. Normalde saatlerimi alacak işleri dakikalar içinde yapmamı sağlıyor. Kullanmak için kodlama bilmeniz gerekmiyor; ne istediğinizi net tarif etmeniz yeterli.

Teknolojinin gidişatına bakınca net bir çizgi görüyorum: önce elle kod yazıyorduk, sonra n8n'e geçtik, şimdi Claude Code'a geçiyoruz. n8n, araçları görsel kutucuklarla birbirine bağlayarak otomasyon kurduğunuz bir platform. Bunu korku yaratmak için söylemiyorum, bence fırsatlar sadece artıyor.

Bu sistemleri kullanmayı bilen ve etrafına bir iş modeli kurabilen biri, bunu bir SaaS ürününe ya da bir otomasyon ajansına çevirebilir. Bu yazıda günlük kullanım için bilmeniz gerekenleri sırayla anlatıyorum: kurulum, temel kavramlar, MD dosyası, güvenlik, plan modu, skill'ler, MCP ve canlıya alma.

Claude Code nasıl kurulur?

Ben Claude Code'u Visual Studio Code (VS Code) içinde kullanıyorum. VS Code'u indirdikten sonra Claude Code'u sol taraftaki panelde ya da eklentiler (extensions) bölümünde bulup kuruyorsunuz. Sonrasında sohbet alanına yazarak çalıştırmaya başlıyorsunuz.

Arayüzde bilmeniz gereken üç alan var:

• Dosyalar: Solda proje klasörünüzdeki dosyalar duruyor ve Claude Code bunların hepsini görebiliyor.
• Editör: Açtığınız dosyanın içeriğini burada görüyorsunuz.
• Sohbet alanı: Claude Code'a görevleri buradan yazıyorsunuz.

İstediğiniz kadar Claude Code paneli açabilir, birden fazla ajanı aynı anda çalıştırabilirsiniz. Claude Code'u terminalde de çalıştırabilirsiniz; bunun için ayarlardan Extensions bölümüne, oradan Claude Code ayarlarına gidiyorsunuz. Terminal görüntüsü daha sade olabilir, ama orada bilgisayarınızdaki dosyalara çok daha rahat erişiyor. Bence Claude Code terminalde daha iyi çalışıyor.

Bypass permissions modu ne işe yarar?

Claude Code varsayılan olarak sürekli izin istiyor: bunu yapayım mı, bu dosyaya bakabilir miyim, şunu çalıştırabilir miyim. Bypass permissions modunu açtığınızda bir görev verdikten sonra iş bitene kadar bütün yolları kendisi deniyor. Plan ya da edit modunda ise soru sormaya devam ediyor.

Bu tercih size kalmış. Ben bypass modunu kullanıyorum ve tam da bu yüzden her proje için ayrı bir klasör açıyorum. Claude Code'a bilgisayarınızın tamamına erişim de verebilirsiniz, ama dosyalarda değişiklik yaptığı için kendi alanında çalışmasını tercih ediyorum.

Workflow, agent ve tool ne demek?

Claude Code'la otomasyon kurarken üç kavramı bilmeniz gerekiyor. Bunu WAT çerçevesi olarak anlatıyorum ve terimleri İngilizce öğrenmenizi tavsiye ediyorum:

• Workflow: Baştan sona belirli bir görevi olan otomasyon.
• Agent: Karar veren, fikir üreten beyin.
• Tool: Ajanın kullanabildiği araçlar, örneğin Gmail.

Gelen bütün e-postaları yanıtlayan bir n8n otomasyonunu düşünün. Gmail tool, yanıtı yazan yapay zeka agent, uçtan uca akışın kendisi workflow. Claude Code'da da aynı yapıyı kuruyorsunuz; farkı, akışı sizin çizmeniz yerine Claude Code'un tarif ettiğiniz şeye göre kurması.

Neden bir MD dosyasıyla başlamalısınız?

MD dosyası, projenin talimatlarını düz metinle yazdığınız bir Markdown dosyası. Bunu projenin beyni ve hafızası gibi düşünebilirsiniz.

Bu dosyayı Claude'a da hazırlatabilirsiniz. Ben e-posta otomasyonunun ekran görüntüsünü Claude'a yükleyip şunu yazdım: "Böyle bir otomasyon yapmak istiyorum. Claude Code'a verebileceğim bir MD dosyası oluştur; dosya yapısı, kullanacağı araçlar ve bütün detaylar içinde olsun."

Aynı yöntemi bir fikirden yola çıkarak da kullanabilirsiniz. Çok sipariş alan bir şirketiniz olduğunu düşünün: gelen maillere bir chatbot cevap versin, sipariş numarasını Supabase veritabanından ya da Shopify'dan kontrol etsin. Nasıl kurulacağına Claude karar versin ve bunu bir MD dosyasına dönüştürsün.

İyi bir MD dosyası şu soruları cevaplıyor:

1. Neyi başarmak istiyorsunuz?
2. Neye ihtiyacınız var?
3. Hangi araçları kullanacak?
4. Çıkan sonuç ne olmalı?
5. Sorun çıkarsa ne yapmalı?

E-posta örneğinde çıkan dosyada proje özeti, mimari ve dosya yapısı, kullanılacak araçlar, modül açıklamaları ve sistem promptu vardı. Proje özeti tek cümleydi: "Sen Gmail'e gelen e-postaları otomatik analiz eden, yanıt gerekip gerekmediğini belirleyen ve gerekiyorsa yanıt oluşturan bir ajansın." Bir sınıflandırıcı modülü de her e-postanın tipini ve yanıt gerektirip gerektirmediğini belirliyordu.

Dosyayı yeni açtığım proje klasörüne koyup "Bu projeyi çalıştır, başlayalım" demem yetti. Dosya erişimi olduğu için ne yapacağını oradan okudu ve bütün klasörleri ve dosyaları kendisi oluşturdu.

API anahtarları nereye konur?

Güvenlik bu işin en önemli kısmı. API anahtarlarınız kodun içinde değil, projedeki .env dosyasında durmalı. Claude Code'a "anahtarı sen koy" demeyin; "benim için .env dosyasını oluştur, içini ben dolduracağım" deyin. Böylece projeyi GitHub'a yüklediğinizde de sorun yaşamazsınız.

Bunun neden önemli olduğunu canlı bir denemede gördüm. MD dosyası olmadan, sadece promptla başladığım bir projede Claude Code fal.ai anahtarını doğrudan kodun içine yazdı. MD dosyası olmadığında işi olabildiğince hızlı bitirmeye odaklanıyor. Projeyi bir sunucuya ya da herkese açık bir GitHub deposuna koyduğunuzda anahtarlarınız çalınabilir.

Canlıya almadan önce /security-review komutunu çalıştırın. Bu komut koddaki olası hataları ve açıkta kalan API anahtarlarını kontrol edip düzeltiyor. Benim denememde de anahtarı .env dosyasına taşıdı.

Plan modu ve net prompt nasıl kullanılır?

Plan modunda Claude Code işe stratejik bir bakışla başlıyor; birlikte konuşup plan çıkardığınız bir mod gibi düşünebilirsiniz. Onunla ne kadar iyi iletişim kurarsanız sonuç o kadar iyi oluyor. "Gel birlikte planlayalım, bana sorular sor" dediğinizde size seçenekler sunuyor, siz de seçerek ilerliyorsunuz.

Prompt yazarken yapılandırılmış ilerlemek daha mantıklı. Örneğin: "YouTube kanalımdan veri çekmek istiyorum. Son 7 günün verileri olsun. En çok izlenenleri bulalım. Sonra bir PDF hazırlayıp bana mail gönderelim." Claude Code bunu kendisi adımlara çeviriyor: API anahtarını al, 7 günlük veriyi çek, grafikleri oluştur, PDF'i gönder.

Bir başka denemede Apify ile n8n hakkındaki 10 YouTube videosunu çektim. Apify, web sitelerinden veri çeken hazır araçların bulunduğu bir platform. Claude Code'dan her videoyu özetlemesini ve fal.ai'daki Nano Banana 2 modeliyle her biri için kapak görseli üretmesini istedim; fal.ai, görsel ve video modellerini API ile çalıştırdığınız bir platform.

Modelin dokümantasyon linkini de verdim. Plan modunda önce fal.ai anahtarını ve kapakların nasıl görünmesi gerektiğini sordu, ardından bypass moduna geçtim. Nano Banana'ya gidecek promptları kendisi yazdı. Geriye dönüp baktığımda, ilk testte on yerine tek bir görselle başlamak daha hızlı olurdu.

Skill nedir, Claude Code'a nasıl eklenir?

Claude Code kendi başına web'de arama yapabiliyor, kanvas ve sunum hazırlayabiliyor, kod yazabiliyor. Skill ise ona belirli bir işi daha iyi yapmayı öğreten paketlenmiş talimatlar. n8n şablonları gibi düşünebilirsiniz: tasarım, video, PDF, kanvas ve web otomasyonu için hazır skill'ler var, video indirmek için yapılmış bir skill bile var.

Benim sık verdiğim örnek Remotion. Remotion skill'iyle sadece prompt yazarak kaliteli animasyonlar ve videolar üretebiliyorsunuz. Bir skill'i eklemenin iki yolu var:

1. Skill'in kodunu kopyalayıp Claude Code'a "bunu skill olarak ekle" demek.
2. /plugins yazıp Manage plugins bölümüne skill'in HTTPS linkini yapıştırmak.

Ekledikten sonra / yazdığınızda skill listede çıkıyor ve doğrudan kullanabiliyorsunuz.

MCP nedir, hangi araçları bağlayabilirsiniz?

MCP (Model Context Protocol), yapay zekayı e-posta, Slack, CRM ya da Google Drive gibi araçlara bağlayan protokol. Kısacası aracı yapay zekaya bağlıyorsunuz. İnternette neredeyse her uygulama için bir MCP sunucusu bulabilirsiniz.

En kolay yol Rube gibi bir platform. Gmail'inizi ya da YouTube hesabınızı bir kez bağlıyorsunuz, istemci olarak VS Code'u seçiyorsunuz ve verdiği komutu kopyalayıp Claude Code'a eklemesini söylüyorsunuz. Sonrasında "YouTube kanalımda video paylaş" demeniz yetiyor.

En çok kullandığım MCP ise Apify. Apify'ın MCP sayfasında istemci olarak Claude Code ya da VS Code'u seçip kurulumu yapıyorsunuz. Diyelim ki YouTube videosu çekmek istiyorsunuz ama ne çekeceğinizi bilmiyorsunuz. Claude Code Apify üzerinden videoları çıkarıyor, sıralıyor ve hangilerinin tuttuğunu görüp onlara odaklanıyor.

Kurduğunuz sistemi nasıl canlıya alırsınız?

Claude Code sizin bilgisayarınızda çalışıyor. Sistemin sürekli çalışması için ben Modal kullanıyorum. Modal, kodunuzu bulutta sürekli açık bir makinede çalıştıran bir yapay zeka altyapısı. İlk girişte başlangıç kredisi veriyor ve bu kredi birçok iş için yeterli oluyor.

1. Modal'a giriş yapın, verdiği kurulum komutunu kopyalayıp Claude Code'a verin. Bu tür işlemler terminalde daha sorunsuz çalışıyor.
2. Açılan sayfada yetki verin; Modal sizin için bir erişim anahtarı (token) oluşturuyor.
3. Claude Code'a şunu yazın: "Projeyi Modal üzerinde kur ve her gün saat 8'de aynı işlemi yapacak şekilde hazırla."

Kurulum saniyeler içinde bitiyor ve Modal makineyi kullanımınıza göre kendisi büyütüyor. Sistemi her saat başı ya da her gün belli bir saatte çalıştırabilir, bir webhook ile tetikleyebilir, Postman ile test edebilirsiniz. Çalışmaları ve çıktıları Modal panelinden takip ediyorsunuz.

İsterseniz aynı otomasyonu n8n'e de çevirebilirsiniz. Müşteriye satarken n8n'i tercih edebileceğiniz bir dönemdeyiz, ama kendi işlerinizi otomatikleştirmek için Modal çok iyi çalışıyor. Bir sistemi kurup canlıya aldığınızda aslında bir skill kaydetmiş oluyorsunuz: sürekli çalışabilen ve kütüphane mantığıyla tekrar kullanılabilen bir yetenek.

İlk hafta için yapılacaklar

• Claude Code'u kurun ve proje klasör yapınızı oluşturun.
• İlk projeniz için bir MD dosyası yazın ya da Claude'a yazdırın.
• Basit bir ilk test yapın; sistemi elle çalıştırıp çalışıp çalışmadığına bakın.
• Güvenlik ayarlarına dikkat edin, anahtarları .env dosyasında tutun.
• MCP'leri bağlayın ve skill'lere göz atın.
• Basit bir uygulama ya da sistem kurup canlıya alın.

Benim önerim, küçük bir sistemi baştan sona kurup canlıya almak. Bunu bir kez yaptığınızda Claude Code'u kendi işinizde ve müşterileriniz için kullanabileceğiniz noktaya gelmiş oluyorsunuz.

Bu yazı, 30 Dakikada Claude Code'un %95'ini Öğren (2026) videomdan derlendi.

Sık sorulan sorular

Claude Code kullanmak için kodlama bilmek gerekiyor mu?

Hayır. Claude Code'a ne istediğinizi, hangi araçları kullanacağını ve sonucun ne olması gerektiğini net yazdığınızda kodu kendisi yazıyor. Sizin işiniz hedefi tarif etmek ve sistemi elle çalıştırıp çalışıp çalışmadığını kontrol etmek.

Claude Code VS Code'da mı yoksa terminalde mi daha iyi çalışır?

VS Code eklentisi başlamak için rahat bir arayüz sunuyor: solda dosyalar, ortada editör, altta sohbet alanı var. Ben terminali tercih ediyorum, çünkü Claude Code orada bilgisayarınızdaki dosyalara çok daha rahat erişiyor ve bence daha iyi çalışıyor. Modal kurulumu gibi işlemler de terminalde daha sorunsuz ilerliyor.

Claude Code projesinde API anahtarlarını nereye koymalıyım?

API anahtarları kodun içine değil, projedeki .env dosyasına konmalı. Claude Code'dan anahtarı kendisinin yerleştirmesini istemek yerine .env dosyasını oluşturmasını isteyin, içini siz doldurun. Böylece projeyi GitHub'a yüklediğinizde ya da bir sunucuya taşıdığınızda anahtarlarınız açığa çıkmaz. Canlıya almadan önce /security-review ile kodu kontrol ettirmek de iyi bir alışkanlık.

Claude Code ile kurduğum otomasyonu her gün otomatik nasıl çalıştırırım?

Claude Code yerelde çalıştığı için sistemin sürekli çalışması bir bulut servisi gerektiriyor. Ben Modal kullanıyorum: kurulum komutunu Claude Code'a veriyorum, ardından projeyi Modal üzerinde kurmasını ve her gün belirli bir saatte çalışacak şekilde ayarlamasını istiyorum. İsterseniz saatlik çalıştırabilir ya da bir webhook ile tetikleyebilirsiniz.