Claude ile ilk yapay zekâ ajanınızı kurmak: 5 adım

“Ajan” denen yapay zekâ sistemleri, soruya cevap vermekle kalmayıp bir görevi adım adım kendisi yürütür: dosyaları açar, okur, gerekirse düzenler ve sonucu raporlar. Türkiye’de bu alandaki girişim sayısı da hızla artıyor. Bu rehberde Anthropic’in resmî Claude Agent SDK’sıyla, bir klasördeki metin dosyalarını okuyup her biri için kısa özet çıkaran basit bir ajanı beş adımda kuruyoruz. Temel düzeyde bilgisayar kullanımı yeterli.

1. Ajanın işini tek cümleyle tanımlayın

İlk ajan için seçilecek en iyi görev, yalnızca okuyan ve hiçbir şeyi değiştirmeyen bir görevdir. Bu rehberdeki görev: “Bu klasördeki .txt ve .md dosyalarını oku, her biri için iki cümlelik Türkçe özet yaz.” Ajan dosyaları değiştiremeyeceği için hata yapsa bile bir şey bozulmaz.

2. Hesap açın ve API anahtarı alın

Claude Console üzerinden bir Anthropic hesabı açın ve bir API anahtarı oluşturun. API kullanımı ücretlidir ve harcama kullanılan miktara göre hesaplanır; Console’dan harcama limiti tanımlamanız önerilir. Anahtarı kimseyle paylaşmayın, bir dosyaya yazıp e-postayla göndermeyin.

3. Python’u ve SDK’yı kurun

Bilgisayarınızda Python 3.10 veya daha yeni bir sürüm olmalı. Yeni bir klasör açın ve içinde şu komutları çalıştırın. Windows’ta (PowerShell):

py -m venv .venv
.venv\Scripts\Activate.ps1
pip install claude-agent-sdk

macOS veya Linux’ta:

python3 -m venv .venv
source .venv/bin/activate
pip install claude-agent-sdk

Ardından API anahtarınızı, ajanı çalıştıracağınız pencerede ortam değişkeni olarak tanımlayın. Windows’ta: $env:ANTHROPIC_API_KEY = "anahtarınız"; macOS/Linux’ta: export ANTHROPIC_API_KEY=anahtarınız. SDK, .env dosyalarını kendiliğinden okumaz.

4. Ajanı yazın

Aynı klasörde ajan.py adlı bir dosya oluşturun ve şunu yapıştırın:

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ResultMessage

async def main():
    async for message in query(
        prompt="Bu klasördeki .txt ve .md dosyalarını oku. Her dosya için iki cümlelik Türkçe bir özet yaz.",
        options=ClaudeAgentOptions(
            allowed_tools=["Read", "Glob", "Grep"],  # yalnızca okuma araçları
        ),
    ):
        if isinstance(message, AssistantMessage):
            for block in message.content:
                if hasattr(block, "text"):
                    print(block.text)
        elif isinstance(message, ResultMessage):
            print(f"Bitti: {message.subtype}")

asyncio.run(main())

Buradaki en önemli satır allowed_tools. Ajana yalnızca dosya bulma (Glob), okuma (Read) ve içinde arama (Grep) için önceden onay veriyorsunuz. Dosya düzenleme veya komut çalıştırma gibi bu listede olmayan araçlar otomatik onaylı değildir.

5. Çalıştırın ve izinleri bilinçli genişletin

Klasöre birkaç metin dosyası koyun ve python ajan.py komutunu çalıştırın. Ajan önce dosyaları bulur, sonra okur ve özetleri ekrana yazar; iş bitince “Bitti: success” satırını görürsünüz. “Not logged in” veya “Invalid API key” hatası alırsanız anahtarı aynı pencerede tanımladığınızı kontrol edin.

Ajana daha fazla yetki vermek mümkün, ancak her yetki bir sorumluluk demek:

• Read, Glob, Grep: Yalnızca okuma ve analiz. Başlangıç için en güvenli seçenek.
• Edit eklemek: Ajan dosyaları değiştirebilir. Önce dosyaların bir kopyasını alın.
• Bash eklemek: Ajan bilgisayarınızda komut çalıştırabilir. Ne yaptığını anlamadan bu yetkiyi vermeyin.

Ajan varsayılan olarak çalıştırdığınız klasöre ve alt klasörlerine erişir; kişisel belgelerinizin bulunduğu bir klasörde çalıştırmayın.

Kaynak ve tarih notu: Kurulum adımları ve kod, 19 Ekim 2026 itibarıyla Anthropic’in resmî Claude Agent SDK hızlı başlangıç belgesine dayanır. Komutlar ve paket adları zamanla değişebilir; güncel bilgi için resmî belgeyi kontrol edin.

İş süreçleriniz için yapay zekâ ajanı kurdurmak ister misiniz?

Rehberdeki temel adımlar, yapay zekâ ajanlarının potansiyelini görmeniz için küçük bir başlangıçtır. Ancak gerçek iş süreçlerinde veri güvenliği, ölçeklenebilirlik ve sistem entegrasyonu gereksinimleri öne çıkar. Kurulum süreci, tekrarlanan görevleri izlenebilir ve denetlenebilir bir iş akışına dönüştürmeyi hedefler.

Claude, Hermes Agent veya OpenClaw

İş ihtiyaçlarınıza göre Claude Agent SDK, Hermes Agent veya OpenClaw gibi farklı araçlardan hangisinin uygun olduğunu değerlendiriyor; kurumunuza yönelik ajan kurulum ve yapılandırma seçenekleri üzerinde çalışıyoruz. Bu seçenekleri; ihtiyaç duyulan görevler, mevcut sistemler, lisans ve veri erişimi koşullarına göre karşılaştırıyoruz. Teknik analiz sürecimizde, iş akışınıza uygun çözümü belirleyip kurulum ve bağlantı çalışmalarını teklif kapsamına göre planlıyoruz.

Neleri otomatikleştirebiliriz?

Teknik uygunluğu ve erişim izinleri doğrulandığında şu uygulamalar değerlendirilebilir:

• Rapor Hazırlama: Dağınık veri setlerinden periyodik ve standartlaştırılmış raporların oluşturulması.
• İçerik İş Akışı: Taslak oluşturmadan son kontrole kadar uzanan çok aşamalı içerik yönetim süreçleri.
• CRM Takip: Müşteri ilişkileri yönetimi kayıtlarının izlenmesi ve veri girişlerinin organize edilmesi.
• Dosya ve Belge Analizi: Desteklenen belge türlerinin belirli ölçütlerle incelenmesi ve sınıflandırma önerileri hazırlanması.
• Sistem Entegrasyonu: Tanımlanmış izinler çerçevesinde, ajanların diğer yazılımlarla koordineli çalışması.

Kurulum ve güvenlik kapsamı

Hizmetin kapsamı; seçilen aracın kurulumu, teknik açıdan uygun bağlantılar, görev tanımlarının oluşturulması, erişim izinlerinin belirlenmesi ve test planı üzerinden hazırlanır. Canlı kullanım öncesinde kontrollü test yapılması planlanır; başlangıç desteğinin kapsamı ve süresi teklifte belirlenir.

Güvenlik ve şeffaflık için kişisel veri işleme ihtiyaçları ile seçilen sağlayıcının koşulları kurumun yetkilileriyle değerlendirilir; kurulum tek başına KVKK uyum garantisi değildir. API bedellerinin kime ait olacağı ve hesap sahipliği, sağlayıcı koşulları ile sözleşmede netleştirilir. En az yetki yaklaşımı benimsenir; kritik işlemlerde uygulanacak insan onayı ve erişim sınırları iş akışına göre tasarlanır. Periyodik bakım, destek, entegrasyon güncellemeleri ve sorumluluklar teklif ve sözleşme kapsamında ayrıca belirlenir.

Teklif isteyin

Operasyonel iş yükünü daha iyi yönetmek için denetlenebilir bir yapay zekâ ajan altyapısını birlikte planlayalım. Sunduğumuz çözümler hakkında detaylı bilgi almak için CRM ve Otomasyon sayfamızı ziyaret edebilir veya ihtiyacınıza özel çözüm için Ajan kurulumu teklifi üzerinden bize ulaşabilirsiniz.