Claude Code ile İlk AI Ajanınızı Gerçekten Nasıl Oluşturursunuz (Yeni Başlayanlar İçin Tam Kurs)

Claude Code'u nasıl kuracağınızı, ilk ajanınızı sıfırdan nasıl yazacağınızı ve gerçek bir şeyle sonuçlanacağınızı öğrenin: hiç kodlama deneyimi gerektirmeden, bir klasörü okuyan, sorunları tespit eden ve bir rapor yazan, çalışan bir ajan.

Bir sohbet botu, bir soru sormanızı bekler ve yanıtlar. Bir yapay zeka ajanı ise farklıdır: ona bir hedef verirsiniz ve o adımları kendi belirler, dosyaları okur, komutları çalıştırır ve iş bitene kadar kendi başına harekete geçer. Her adımı siz yönlendirmezsiniz. Sadece varış noktasını belirlersiniz.

Bu ayrım önemlidir çünkü neyi otomatikleştirebileceğinizi değiştirir. İstemleri tek tek yazmazsınız. Siz başka bir yere odaklanırken işi yapan bir şey inşa ediyorsunuz.

Başlamadan Önce İhtiyacınız Olanlar

İşte herhangi bir komuta dokunmadan önce gereken her şey:

• Ücretli bir plana sahip bir Claude hesabı (minimum aylık 20$'lık Pro planı; Claude Code dahildir)

• macOS 13 veya sonrasını çalıştıran bir Mac, bir Windows PC veya bir Linux makinesi

• Bir internet bağlantısı

• Tam kurulum ve ilk derleme için yaklaşık 30 ila 45 dakika

Önceden herhangi bir kodlama deneyimi gerekmez. Bu kılavuzdaki her komut tam olarak yazılmıştır. Kopyalayıp yapıştırır ve Enter'a basarsınız.

Bu kılavuzu takip etmenin maliyeti: Aboneliğinizin ötesinde 0$. Claude Code, tüm ücretli Claude planlarına dahildir.

Claude Code'u Kurun (Terminal Gerektirmeyen Masaüstü Uygulama Yolu)

Yeni başlayan biri için en kolay yol masaüstü uygulamasıdır. Size önce terminal komutlarını öğrenmenize gerek kalmadan Claude Code'un tüm gücünü verir.

claude.ai adresine gidin ve platformunuz için masaüstü uygulamasını indirin. macOS'ta .dmg dosyasını açın ve Claude'u Uygulamalar klasörünüze sürükleyin. Windows'ta yükleyiciyi çalıştırın. Uygulamayı başlatın, Claude hesabınızla oturum açın ve ekranın üst ortasındaki Kod sekmesine tıklayın.

Kod sekmesi sizden planınızı yükseltmenizi isterse, mevcut planınız Claude Code'u içermiyordur. Sizden çevrimiçi oturum açmanızı isterse, oturum açma işlemini tamamlayın ve uygulamayı yeniden başlatın. Her iki durumda da, içeri girdikten sonra temiz bir çalışma alanına yönlendirileceksiniz.

Başarının neye benzediği: Kod sekmesi etkin ve hata mesajı olmayan boş bir komut kutusu görürsünüz. Burası sizin ajan çalışma alanınız. İnşa edeceğiniz her şey burada yaşar.

Ne İnşa Edeceksiniz

Bu kılavuz boyunca kullanacağınız belirli bir ajan inşa edeceksiniz.

Ajanın görevi: Bir metin dosyaları klasörünü okumak, en üstte başlık satırı eksik olan herhangi bir dosyayı bulmak ve düzeltilmesi gereken her dosyayı listeleyen missing-titles.txt adında bir rapor yazmak.

Bu gerçek ve kullanışlı bir görevdir. Tüm temel ajan davranışlarını gösterir: dosyaları okuma, kararlar alma ve çıktı yazma. Ayrıca çalıştığında gözle doğrulamak için yeterince basittir.

Adım 1: Çalışma Klasörünüzü Oluşturun

Masaüstünüzde my-agent adında yeni bir klasör oluşturun. Ajan burada çalışacaktır. Yalnızca bu klasörün içindeki dosyaları görebilir ve onlara dokunabilir, bu da her şeyi güvende ve sınırlı tutar.

my-agent klasörünün içinde, articles adında ikinci bir klasör oluşturun. Ajan kontrol edilecek dosyaları burada arayacaktır.

Şimdi articles klasörünün içinde dört adet düz metin dosyası oluşturun. Bunları post-one.txt, post-two.txt, post-three.txt ve post-four.txt olarak adlandırın. İkisini açın ve ilk satıra şunu ekleyin:

1
2Title: My Article
3

Diğer iki dosyayı tamamen boş bırakın. Ajanın görevi boş olanları bulmaktır.

Başarının neye benzediği: Klasör yapınız my-agent/articles/ şeklindedir ve ikisinde başlık satırı olan, ikisinde olmayan dört .txt dosyası içerir.

Adım 2: CLAUDE.md Talimat Dosyasını Yazın

CLAUDE.md, Claude Code'un her oturumun başında okuduğu düz bir metin dosyasıdır. Ajanınızın sürekli talimatlarıdır, asla unutmadığı bir iş tanımının eşdeğeridir.

my-agent klasörünün içinde (articles klasörünün içinde değil), CLAUDE.md adında yeni bir dosya oluşturun. Bunu herhangi bir metin düzenleyicide (Windows'ta Not Defteri veya Mac'te TextEdit dahil) açın ve aşağıdakini aynen yapıştırın:

1
2# My File Checker Agent
3
4## Your job
5
6Check every .txt file inside the /articles folder.
7
8## What to look for
9
10A valid file starts with a line that reads exactly: Title:
11
12If the first line does not start with "Title:", the file is missing its title.
13
14## What to do
15
161. Read every .txt file in /articles one by one.
17
181. Note which files are missing the Title line.
19
201. Write a file called missing-titles.txt in the main folder.
21
221. In that file, list every filename that failed the check, one per line.
23
241. If all files pass, write "All files have titles." in missing-titles.txt instead.
25
26## What not to do
27
28Do not edit any of the article files. Read only. Write only to missing-titles.txt.
29

Dosyayı kaydedin. Bu, ajanınızın tüm beynidir. Claude Code, herhangi bir şey yapmadan önce bunu okuyacaktır.

Başarının neye benzediği: my-agent/CLAUDE.md konumunda bir dosyanız var ve yukarıdaki talimatları içeriyor.

Adım 3: Claude Code'u Klasörünüze Yönlendirin

Claude Code masaüstü uygulamasını açın ve my-agent klasörünüze gitmek için klasör simgesine veya "Klasörü aç" seçeneğine tıklayın. Klasörü seçin ve onaylayın.

Claude Code, CLAUDE.md dosyanızı otomatik olarak okuyacaktır. Bunun için bir onay mesajı görmezsiniz; bu, bir klasörü her açtığınızda arka planda sessizce gerçekleşir.

Masaüstü uygulaması yerine terminal kullanıyorsanız, terminalinizi açın ve şunu çalıştırın:

1
2cd ~/Desktop/my-agent
3
4claude
5

cd komutu "dizin değiştir" anlamına gelir. Sizi my-agent klasörünüze taşır. claude yazmak, ajan oturumunu bu klasörün içinden başlatır.

Adım 4: Ajanı Çalıştırın

Claude Code arayüzünün altındaki komut kutusuna aşağıdakini aynen yazın:

1
2Read 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.
3

Enter'a basın. Ne olduğunu izleyin.

Claude Code çalışırken size yaptığı işi gösterecektir: hangi dosyaları okuduğu, her birinde ne bulduğu ve ne yazdığı. Bu şeffaflık kasıtlıdır. Her eylemi gerçekleşmeden önce görebilir ve bir şey yanlış görünüyorsa durdurabilirsiniz.

Başarının neye benzediği: Claude dört dosyayı okur, başlığı olmayan ikisini belirler ve my-agent klasörünüzde missing-titles.txt dosyasını oluşturur. Bu dosyayı açtığınızda, her satırda bir tane olmak üzere iki dosya adını görmelisiniz.

Yaygın Başlangıç Hatası: Ajan Bittiğini Söylüyor Ama Dosya Boş

Bu, ajan missing-titles.txt dosyasını yazdığında ancak içine gerçekten bir şey koymadığında olur. Nedeni neredeyse herkes çok belirsiz olan bir CLAUDE.md talimatıdır.

Düzeltme: CLAUDE.md dosyasını açın ve çıktı talimatlarını daha açık hale getirin. "dosyaları listele" yerine, "her dosya adını kendi satırına yaz, şöyle: post-two.txt" yazın. Talimatlarınızdaki somut örnekler her seferinde somut çıktı üretir.

Ajan yanlış dosya adlarını yazarsa veya birini atlarsa, makale dosyalarınızın gerçekten .txt uzantısına sahip olduğunu ve Windows'ta dosya uzantıları gizlendiğinde olabilen .txt.txt olmadığını kontrol edin. Kontrol etmek için Dosya Gezgini ayarlarınızdan "dosya uzantılarını göster" seçeneğini açın.

Adım 5: Doğrulayın ve Genişletin

missing-titles.txt dosyasını açın ve tam olarak boş bıraktığınız iki dosyayı listelediğini doğrulayın. Öyleyse, ajanınız uçtan uca doğru çalışmıştır.

Artık çalışan bir ajanınız var. my-agent klasöründe yaşıyor, CLAUDE.md dosyasından okuyor ve articles klasörüne yeni dosyalar bırakıp aynı komutu çalıştırdığınızda her an çalıştırılabilir.

Açık olan bir sonraki adım: CLAUDE.md dosyasını güncelleyerek her dosyanın beş satırdan uzun olup olmadığını da kontrol etmesini sağlayın. "What to look for" bölümünün altına şunu ekleyin:

1
2A valid file also has more than 5 lines of content.
3
4If a file has 5 lines or fewer, flag it as "too short" alongside the title check.
5

Ajanı aynı komutla tekrar çalıştırın. Şimdi komutunuzda hiçbir değişiklik olmadan, sadece talimat dosyasında bir değişiklikle, bir yerine iki şeyi kontrol edecektir.

Az Önce Ne İnşa Ettiniz ve Neden Önemli

Her adımı denetlemenize gerek kalmadan dosyaları okuyan, kararlar alan ve çıktı yazan bir ajan inşa ettiniz. Bu, daha sonra inşa edeceğiniz her daha gelişmiş ajanın arkasındaki temel desendir.

CLAUDE.md dosyası ölçeklenen kısımdır. Oraya eklediğiniz her yeni kural, yeni kontrol veya yeni çıktı formatı, ajanı nasıl çalıştırdığınızı değiştirmeden ne yaptığını değiştirir. Komut aynı kalır. Talimatlar gelişir.

Buradan itibaren doğal uzantılar şunlardır: daha fazla dosya türünü kontrol etmek, raporu CSV gibi farklı bir formatta yazmak veya Claude Code'un yerleşik Rutinler özelliğini kullanarak kontrolü bir zamanlamaya bağlamak.

Herhangi bir adımla ilgili sorularınız mı var? Aşağıya yazın.