Kendi işinin patronu olmak istiyorsan kendine 30 dk. ayırmalısın
Çünkü bugün sıfır kod bilgisiyle, tek bir öğleden sonrada, gerçekten çalışan bir yapay zeka ajanı kurmayı anlatacağım.
Anlatacaklarımı Chatbot'la ajanı karıştırmayın. Chatbot soruyu bekler, cevap verir. Ajan farklı çalışır: siz hedefi verirsiniz, o adımları kendi kurar, dosyaları okur, komutları çalıştırır ve iş bitene kadar kendi başına devam eder. Siz her hamleyi yönetmezsiniz, sadece rotayı çizersiniz.
Bu fark önemli çünkü artık tek tek prompt yazmıyorsunuz. Siz başka işe bakarken iş kendi kendine ilerliyor.
NE GEREKİYOR?
Kurulum öncesi ihtiyacınız olan her şey burada:
- Ücretli bir Claude planı (Pro, 20$/ay, Claude Code dahil)
- Mac (macOS), Windows ya da Linux
- İnternet
- 30-45 dakikalık boş zaman
Kodlama bilgisi gerekmiyor. Her komut eksiksiz yazılı, siz sadece kopyala-yapıştır yapıp Enter'a basacaksınız.
Ekstra maliyet yok. Abonelik dışında tek kuruş harcamıyorsunuz.
KURULUM: MASAÜSTÜ UYGULAMASI, TERMİNAL YOK
Bir yeni başlayan için en kolay yol masaüstü uygulaması. Terminal öğrenmeden Claude Code'un tüm gücünü elinize veriyor.
claude.ai üzerinden işletim sisteminize uygun masaüstü uygulamasını indirin. Mac'te .dmg dosyasını açıp Claude'u Applications klasörüne sürükleyin, Windows'ta yükleyiciyi çalıştırın. Uygulamayı açın, hesabınızla giriş yapın ve üstte ortada duran Code sekmesine tıklayın.
Code sekmesi sizden plan yükseltmesi istiyorsa, mevcut planınız Claude Code'u kapsamıyor demektir. Online giriş istiyorsa, girişi tamamlayıp uygulamayı yeniden başlatın. Her iki durumda da sonunda boş bir çalışma alanına düşeceksiniz.
Başarı burada şu demek: boş bir prompt kutusu, aktif bir Code sekmesi, hiçbir hata mesajı yok. Kurduğunuz her şey bundan sonra bu alanda yaşayacak.
NE İNŞA EDECEĞİZ?
Tek ve net bir ajan kuracağız, yazının sonuna kadar aynı ajanla ilerleyeceğiz.
Görevi şu: bir klasördeki metin dosyalarını okuyacak, başlığı eksik olanları bulacak ve missing-titles.txt adında bir rapor yazıp size düzeltilmesi gereken dosyaları listeleyecek.
Küçük ama gerçek bir görev. Dosya okuma, karar verme, çıktı yazma; bir ajanın yapması gereken üç temel şeyi de içeriyor. Ve çalışıp çalışmadığını gözünüzle kontrol edebileceğiniz kadar basit.
ADIM 1: ÇALIŞMA KLASÖRÜNÜ KURMAK
Masaüstünde my-agent adında bir klasör oluşturun . Ajan burada çalışacak, sadece bu klasörün içini görüp dokunabilecek, böylece her şey güvende kalıyor.
my-agent'ın içine articles adında ikinci bir klasör oluşturun. Ajan kontrol edeceği dosyaları burada arayacak.
articles içine dört düz metin dosyası oluşturun: post-one.txt, post-two.txt, post-three.txt, post-four.txt. İkisini açıp en üste şunu yazın:
Title: My Article
Diğer ikisini tamamen boş bırakın. Ajanın işi tam olarak bu boş olanları bulmak.
Klasör yapınız my-agent/articles/ olmalı, içinde ikisi başlıklı ikisi başlıksız dört .txt dosyası bulunmalı.
ADIM 2: CLAUDE.md TALİMAT DOSYASINI YAZ
CLAUDE.md, Claude Code'un her oturum başında okuduğu düz metin bir dosya. Ajanınızın sabit talimatları, hiç unutmadığı iş tanımı gibi düşünün.
my-agent klasörünün içine (articles'ın içine değil) CLAUDE.md adında yeni bir dosya oluşturun. Herhangi bir metin editöründe açın, Windows'ta Notepad, Mac'te TextEdit olur, ve şunu birebir yapıştırın:
# Dosya Kontrol Ajanım ## Görevin /articles klasöründeki her .txt dosyasını kontrol et.
## Neye bakacaksın Geçerli bir dosya şu satırla başlar: Title: İlk satır "Title:" ile başlamıyorsa, dosyanın başlığı eksik demektir.
## Ne yapacaksın 1. /articles içindeki her .txt dosyasını tek tek oku. 2. Hangi dosyaların başlığı eksik not al. 3. Ana klasörde missing-titles.txt adında bir dosya oluştur. 4. Bu dosyaya, kontrolü geçemeyen her dosya adını bir satıra bir tane olacak şekilde yaz. 5. Tüm dosyalar geçerliyse, missing-titles.txt içine "Tüm dosyaların başlığı var." yaz.
## Yapmayacakların Hiçbir makale dosyasını düzenleme. Sadece oku. Sadece missing-titles.txt dosyasına yaz.
Kaydedin. Ajanınızın tüm beyni bu. Claude Code her şeyden önce bunu okuyacak.
my-agent/CLAUDE.md dosyası oluştu ve yukarıdaki talimatları içeriyor, hepsi bu kadar.
ADIM 3: CLAUDE CODE'U KLASÖRE YÖNLENDİR
Claude Code masaüstü uygulamasını açın, klasör simgesine ya da "Open folder" seçeneğine tıklayıp my-agent klasörüne gidin. Seçin, onaylayın.
Claude Code, CLAUDE.md dosyanızı otomatik okuyacak. Herhangi bir onay mesajı görmezsiniz, bu her klasör açışınızda sessizce arka planda gerçekleşir.
Terminal kullanıyorsanız, terminali açıp şunu çalıştırın:
cd ~/Desktop/my-agent claude
cd komutu "dizin değiştir" demek, sizi my-agent klasörünün içine taşır. claude yazmak ise oturumu o klasörden başlatır.
ADIM 4: AJANI ÇALIŞTIR
Claude Code arayüzünün alt kısmındaki prompt kutusuna şunu birebir yazın:
Read every .txt file in the articles folder. Find any file missing a Title line at the top. Write the results to missing-titles.txt as instructed in CLAUDE.md.
Enter'a basın. Ve izleyin.
Claude Code, çalışırken yaptığı her şeyi size gösterecek: hangi dosyayı okuduğunu, her birinde ne bulduğunu, ne yazdığını. Bu şeffaflık kasıtlı. Her aksiyonu gerçekleşmeden önce görebilir, bir şey tuhaf görünürse durdurabilirsiniz.
Claude dört dosyayı okur, başlıksız iki tanesini tespit eder ve my-agent klasörünüzde missing-titles.txt dosyasını oluşturur. Açtığınızda iki dosya adının alt alta yazılı olduğunu görmelisiniz.
EN SIK YAPILAN HATA: AJAN "BİTTİ" DİYOR AMA DOSYA BOŞ
Bu genelde ajan missing-titles.txt dosyasını oluşturur ama içine hiçbir şey yazmaz şeklinde çıkar. Sebebi neredeyse her zaman CLAUDE.md içindeki talimatın çok muğlak olmasıdır.
Çözüm: CLAUDE.md'yi açıp çıktı talimatlarını daha somut hale getirin. "Dosyaları listele" yerine "her dosya adını kendi satırına yaz, örneğin: post-two.txt" yazın. Talimata somut örnek koymak, çıktıyı da her seferinde somut yapar.
Ajan yanlış dosya adı yazıyor ya da birini atlıyorsa, makale dosyalarınızın gerçekten .txt uzantılı olduğundan emin olun, .txt.txt değil. Bu Windows'ta dosya uzantıları gizliyken sık yaşanır. Dosya Gezgini ayarlarından "dosya uzantılarını göster" seçeneğini açıp kontrol edin.
ADIM 5: DOĞRULA VE GENİŞLET
missing-titles.txt dosyasını açın, boş bıraktığınız o iki dosyanın listelendiğini doğrulayın. Doğruysa, ajanınız baştan sona doğru çalıştı demektir.
Artık çalışan bir ajanınız var. my-agent içinde yaşıyor, talimatını CLAUDE.md'den alıyor, articles klasörüne yeni dosya attığınızda aynı prompt'la tekrar çalıştırabiliyorsunuz.
Bir sonraki net adım: CLAUDE.md'yi güncelleyip her dosyanın beş satırdan uzun olup olmadığını da kontrol ettirin. "Neye bakacaksın" başlığının altına şunu ekleyin:
**Geçerli bir dosya ayrıca 5 satırdan uzun içerik içerir. Bir dosya 5 satır veya daha kısaysa, başlık kontrolünün yanında "çok kısa" olarak da işaretle.**
Aynı promptla ajanı tekrar çalıştırın. Artık tek şey yerine iki şeyi kontrol edecek, promptunuzda hiçbir değişiklik yapmadınız, sadece talimat dosyası değişti.
NE YAPTINIZ VE NEDEN ÖNEMLİ?
Dosya okuyan, karar veren, çıktı yazan ve siz her adımı denetlemeden bunu yapan bir ajan kurdunuz. Bundan sonra kuracağınız her daha gelişmiş ajanın temel örüntüsü bu.
Ölçeklenen kısım CLAUDE.md. Oraya eklediğiniz her yeni kural, yeni kontrol, yeni çıktı formatı, siz nasıl çalıştırdığınızı değiştirmeden ajanın ne yaptığını değiştiriyor. Prompt aynı kalıyor, talimat gelişiyor.
Buradan sonraki doğal adımlar: daha fazla dosya tipi kontrol etmek, raporu CSV gibi farklı bir formata yazdırmak ya da kontrolü belirli aralıklarla otomatik tekrarlatmak.
Tebrikler ilk adımı attınız gerisi hayal gücünüz ile orantılı olarak sizin elinizde.
Fark açılmadan harekete geçin.
Kaydedip paylaşmayı, yorum yaparak destek olmayı unutmayın.
