VPS uzerinde n8n ile Claude AI is akislari olusturma

Ne inşa ediyorsunuz

Hâlihazırda çalıştırdığınız n8n örneği üzerinde üç adet işlevsel yapay zeka iş akışı: gönderdiğiniz her şeyi özetleyen bir webhook, makaleleri yapılandırılmış elektronik tablo satırlarına dönüştüren zamanlanmış bir besleme okuyucu ve soruları yanıtlamak için kendi başına bir HTTP API'sini çağıran bir yapay zeka ajanı. Bu, VPS üzerinde Python ile Claude API'sini çağırma rehberinin kodsuz (no-code) karşılığıdır; aynı API, aynı token kullanımı ve aynı maliyet söz konusudur, ancak orkestrasyon bir betik yerine n8n düğümleri (nodes) içinde gerçekleşir.

n8n'in Docker üzerinde self-hosted n8n rehberi uyarınca HTTPS arkasında kurulu olduğunu varsayıyorum. Eğer kurulu değilse, önce bunu yapın; webhook'lar gerçek bir TLS uç noktasına ihtiyaç duyar ve API anahtarını içine yerleştireceğiniz kimlik bilgisi deposu, rehberde önemle belirtilen şifreleme anahtarı yedeğini gerektirir.

Buradaki ilginç sorunlar sürükle-bırak işlemleriyle ilgili değildir. Sorunlar; düğüm başına model seçimi, undefined değerini sessizce araya ekleyen istem (prompt) alanları ve bir otomasyonun gözetimsiz çalışması gerçeğidir. Çalıştırma başına yarım sent maliyeti olan bir iş akışı ucuzdur, ancak bir yeniden deneme döngüsü (retry loop) bunu gece boyunca dört bin kez çalıştırırsa durum değişir. Bu rehberin büyük bir kısmı bu konulara odaklanmaktadır.

Yedeklediğiniz anahtarla şifrelenmiş tek bir kimlik bilgisi

Anthropic Console üzerinde platform.claude.com adresine gidin, Settings ve ardından API Keys yolunu izleyerek n8n-vps gibi bir isimle yeni bir anahtar oluşturun. Bu anahtar yalnızca bir kez gösterilir. Console, anahtarı oluştururken bir son kullanma tarihi belirlemenizi ister; bu tarihi not edin, çünkü süresi dolan bir anahtar, aşağıda hata modları altında açıklanan 401 hatasıyla katılımsız iş akışlarını kesintiye uğratır. Hesabınıza bakiye yükleyin veya faturalandırma ayarlarını yapılandırın; API kullanımı token başına ücretlendirilir ve ön ödemeli kredilerden düşülür. Pro aboneliği bu maliyeti kapsamaz; ancak Claude Max, Ultra ve Team planları artık aylık Claude API kredileri içermektedir (Max planında 100$, Ultra planında 200$, Team planında ise 500$'a kadar havuzlanmış kredi). Bu kredileri, claude.ai faturalandırma ayarlarınızdan bir Console organizasyonunu bağlayarak tanımlayabilirsiniz. Bu krediler, n8n tarafından yapılanlar gibi API çağrılarını karşılar, Claude Code kullanımını kapsamaz ve her faturalandırma dönemi sonunda sona erer. Eğer bu üç iş akışını hiçbir ücret ödemeden oluşturmayı planlıyorsanız, Anthropic'in fiyatlandırma SSS bölümü, yeni kullanıcıların API'yi test etmeleri için küçük miktarda ücretsiz kredi aldığını belirtir; bu nedenle yeni bir Console hesabı, faturalandırma eklemeden önce bu başlangıç kredileriyle iş akışlarını deneyebilir. Krediler tükendiğinde, her Claude çağrısı token başına ücretlendirilir. Token sayma uç noktası ve organizasyon başına aylık 1.550 saate kadar ücretsiz kod yürütme süresi gibi bazı özellikler token dışında ek maliyet getirmez; ancak bu üç iş akışının hiçbiri kod yürütme özelliğini kullanmaz. Ücretsiz API kredilerinin neleri kapsadığı bölümü ayrıntıları açıklamaktadır.

n8n içinde: Credentials, Create credential yolunu izleyin, Anthropic seçeneğini belirleyin, anahtarı API Key alanına yapıştırın ve kaydedin. Her iş akışındaki her Claude düğümü, bu kayıtlı kimlik bilgisine referans verir; anahtarı hiçbir zaman doğrudan bir düğümün içine yapıştırmazsınız.

İki operasyonel not: Birincisi, n8n kayıtlı kimlik bilgilerini N8N_ENCRYPTION_KEY ile şifreler. Eğer bu ortam değişkenini n8n kılavuzuna uygun olarak compose dosyanızda açıkça tanımlarsanız, kimlik bilgileriniz container yeniden oluşturulsa bile korunur; eğer n8n'in otomatik bir anahtar oluşturmasına izin verir ve ardından volume verisini kaybederseniz, bu anahtar dahil tüm kayıtlı kimlik bilgileri kurtarılamaz şifreli metin haline gelir. Eğer henüz yapmadıysanız anahtarı hemen yedekleyin. İkincisi, n8n kimlik bilgisi deposunu güvenlik kapsamı olarak değerlendirin: Anthropic kimlik bilgilerinizi kullanabilen herkes, anahtarınızla istek yapabilir. Community sürümünde bu kişi siz ve instance sahibi olursunuz; n8n belgeleri bunu "Yalnızca instance sahibi ve kimlik bilgilerini oluşturan kullanıcı iş akışlarına ve kimlik bilgilerine erişebilir" şeklinde tanımlar, bu nedenle diğer Member hesapları bunlara erişemez. İş akışlarını ve kimlik bilgilerini paylaşmak, self-hosted n8n üzerinde ücretli bir özelliktir (Business veya Enterprise) ve bir iş akışını paylaştığınızda, o iş akışının düzenleyicileri, iş akışının kullandığı tüm kimlik bilgilerini kullanabilir. Bu nedenle, instance üzerinde başka bir kullanıcı varsa, hesap tanımlamadan önce ücretli n8n lisansının sağladığı erişim kontrolleri bölümünü okuyun. Güvenliği ihlal edilmiş veya kontrolsüz çalışan bir instance durumunda maliyeti sınırlamak için Console içindeki Settings bölümünden bir harcama limiti belirleyin.

Model seçimi düğüm bazlı bir karardır

n8n'in Claude düğümlerindeki model açılır menüsü doğrudan API üzerinden çekilir, bu nedenle anahtarınızın erişebildiği modelleri gösterir. Bu kılavuzda kullanılan ve Ekim 2026 itibarıyla milyon girdi/çıktı tokeni başına API fiyatlandırmasına sahip modeller şunlardır: 200K bağlam penceresi ile $1/$5 fiyatlı Claude Haiku 4.5 (claude-haiku-4-5), 1M token bağlam penceresi ile $2/$10 fiyatlı Claude Sonnet 5 (claude-sonnet-5) ve $5/$25 fiyatlı Claude Opus 4.8 (claude-opus-4-8). En zorlu mantıksal işlemler için $10/$50 fiyatlı Claude Fable 5 (claude-fable-5) de mevcuttur; ancak bu kılavuzdaki hiçbir işlem için buna ihtiyaç yoktur. Tam olarak bu ID'leri kullanın. claude-haiku-4-5, sabitlenmiş anlık görüntü claude-haiku-4-5-20251001 için bir takma addır ve bu da çalışır; ancak eski bir eğitimden kopyalanan tarihli bir ID, kullanımdan kaldırılmış bir modeli işaret edebilir ve başarısız olabilir. Fiyatlar değişebilir, bu nedenle burada okuduğunuz herhangi bir sayıya güvenmeden önce platform.claude.com adresini kontrol edin.

Bu kılavuz ilk yayınlandığından bu yana Anthropic daha yeni modeller yayınladı ve belgelerinde artık Haiku 4.5, Sonnet 5, Opus 4.8 ve Fable 5'i eski (legacy) olarak işaretliyor. Bunlar hala çalışmaktadır. Kullanımdan kaldırma sayfası, Haiku 4.5'in emekliliğinin 15 Ekim 2026'dan önce olmayacağını belirtmektedir; bu tarih geçmiştir ve 25 Ekim 2026 itibarıyla sayfa, Haiku 4.5'i hala aktif olarak göstermekte ve herhangi bir emeklilik bildirimi içermemektedir. Sonnet 5, Opus 4.8 ve Fable 5, 2027 ortasından önce emekli olmayacaktır. Anthropic, halka açık bir modeli emekliye ayırmadan önce en az 60 gün önceden bildirimde bulunur, bu nedenle iş akışlarınız Haiku 4.5'e sabitlenmişse emeklilik sayfasını takip edin. Mevcut seri; 100.000 tokene kadar olan istemler için $0.10/$0.50, bunun üzerindekiler için $0.50/$2.50 fiyatlı Claude Haiku 5.5 (claude-haiku-5-5, 7 Ekim 2026'da yayınlandı), $2/$10 fiyatlı Claude Sonnet 5.5 (claude-sonnet-5-5), $4/$20 fiyatlı Claude Opus 5.5 (claude-opus-5-5) ve $10/$50 fiyatlı Claude Fable 5.1 (claude-fable-5-1) şeklindedir. Haiku 5.5'in tokenleştiricisi aynı metni Haiku 4.5'e göre yaklaşık %30 daha fazla token olarak sayar, bu nedenle sadece liste fiyatlarını değil, Konsol'un kullanım sayfasındaki gerçek çalıştırma başına maliyetleri karşılaştırın.

Geliştirilmesi gereken alışkanlık şudur: Modeli platform bazında değil, düğüm bazında seçin. Sınıflandırma, ayıklama, özetleme, yönlendirme gibi otomasyonun temel taşları Haiku üzerinde mükemmel çalışır. Haiku 4.5, Sonnet 5'in fiyatının yarısı ve Opus 4.8'in beşte biri kadardır; Haiku 5.5 ise 100.000 tokene kadar olan istemlerde Sonnet 5.5'in fiyatının yirmide biri ve Opus 5.5'in kırkta biri kadardır. Sonnet'i ajanlar ve çok adımlı mantıksal işlemler için, Opus'u ise yanlış cevabın token maliyetinden daha pahalıya mal olduğu nadir iş akışları için ayırın. Beş Claude düğümü içeren bir iş akışı, modelleri karıştırabilir ve karıştırmalıdır.

İki Claude düğümü ve nerede kullanılacakları

n8n iki farklı Anthropic entegrasyonu sunar ve yanlış olanı seçmek yeni başlayanların en sık yaptığı hatadır.

Anthropic düğümü standart bir uygulama düğümüdür: bir istek girer, bir yanıt çıkar. Metin kaynağı, Message a Model işleminin yanı sıra resim ve belge analizine yönelik işlemlere sahiptir. İş akışı mantığı n8n, tetikleyici, Claude çağrısı, sonraki düğüm şeklinde ilerlediğinde bunu kullanın. Aşağıdaki 1 ve 2 numaralı iş akışları bunu veya zincir karşılığını kullanır.

Anthropic Chat Model düğümü bir alt düğümdür; AI Agent veya Basic LLM Chain gibi bir kök düğüme model sağlayan küçük bir eklentidir. Kendi tetikleyicisi veya çıktısı yoktur; model seçiciyi ve Maksimum Token Sayısı ile Örnekleme Sıcaklığı gibi örnekleme seçeneklerini sunar. n8n belgelerinden ezberlenmesi gereken bir uyarı: alt düğümlerdeki ifadeler her öğeye göre değil, her zaman ilk girdi öğesine göre çözümlenir; öğe bazlı ifadeleri alt düğüme değil, kök düğümün istem alanlarına koyun. Anthropic tarafındaki bir uyarı ise şudur: Haiku 4.5 hariç bu kılavuzdaki tüm modeller olan Claude 4.7 ve sonraki modellerde, sıcaklık, top_p veya top_k değerlerini varsayılan olmayan bir değere ayarlamak 400 hatası döndürür (Anthropic'in yeni API sürümü 2026-10-21 bu parametreleri her model için kaldırır), bu nedenle bu modellerde Örnekleme Sıcaklığı, Top K ve Top P değerlerini ayarlanmamış bırakın.

İş Akışı 1: webhook girişi, özet çıkışı

Yapay zeka otomasyonunun "hello-world" uygulaması: bir URL'ye POST edilen her şey özetlenir ve Slack'e veya gelen kutunuza düşer.

1. Webhook düğümü, HTTP Method POST, yol summarize. n8n size bir test URL'si ve bir üretim URL'si verir; üretim URL'si yalnızca iş akışı yayınlandıktan sonra dinlemeye başlar.
2. Anthropic düğümü, Message a Model, model claude-haiku-4-5, Max Tokens yaklaşık 300.
3. Slack düğümü (veya Send Email), yanıt metnini bir kanala gönderir.

Prompt, n8n ifadelerinin Claude ile buluştuğu yerdir. Bir POST gövdesi $json.body altında yer alır, bu nedenle kullanıcı mesajı alanı şu şekilde görünür:

Summarize the following feedback in three bullets, then one line:
verdict: praise | complaint | churn-risk. No preamble.

{{ $json.body.text }}

Rol ve biçim talimatlarını kullanıcı mesajına değil, düğümün sistem istemi (system prompt) alanına yerleştirin; sistem istemi sabit kalırken yük (payload) değişir, bu da davranışın kararlı kalmasını sağlar ve istemin altı ay sonra bile anlaşılır olmasını kolaylaştırır. Bunu doğrudan VPS üzerinden test edin:

curl -X POST https://n8n.example.com/webhook/summarize \
  -H 'Content-Type: application/json' \
  -d '{"text": "Third support ticket this month about slow disk IO..."}'

Haiku üzerinde çalıştırma başına maliyet: 1.200 token'lık bir yük ve istem yaklaşık 0.0012 dolar giriş, 300 token'lık çıkış ise 0.0015 dolar, yani yaklaşık çeyrek senttir. Ayda bin çalıştırma 3 doların altındadır. Aynı düğümün Opus 4.8'e yönlendirilmesi bunun yaklaşık beş katıdır. Oluşturduğunuz her iş akışıyla çarpılan bu oran, düğüm başına model alışkanlığının neden önemli olduğunun nedenidir.

İş Akışı 2: Zamanlanmış RSS'den yapılandırılmış satırlara

Şimdi saatlik çalışan ve yapılandırılmış çıktı üreten bir iş akışına bakalım: RSS beslemesini saatlik olarak okuyun, her öğeyi sınıflandırın ve bir tabloya satır olarak ekleyin.

1. Zamanlanmış Tetikleyici (Schedule Trigger), her saat başı.
2. RSS Okuma (RSS Read), besleme URL'si. Her makale için bir öğe çıktısı verir.
3. Temel LLM Zinciri (Basic LLM Chain), claude-haiku-4-5 olarak ayarlanmış bir Anthropic Chat Model alt düğümü ve JSON şeması içeren bir Yapılandırılmış Çıktı Ayrıştırıcı (Structured Output Parser) alt düğümü ile.
4. Google Sheets (veya Postgres), her öğe için bir satır ekleme.

Yapılandırılmış Çıktı Ayrıştırıcı, "Claude, lütfen JSON döndür" isteğini bir temenniden bir sözleşmeye dönüştüren bileşendir: Modelin yanıtını şemanıza göre doğrular ve hatalı satırlar yazmak yerine, öğeyi işleme almayarak hata verir. Aşağıdaki gibi bir şema:

{
  "type": "object",
  "properties": {
    "category": { "type": "string", "enum": ["release", "security", "tutorial", "other"] },
    "relevance": { "type": "number" },
    "one_line_summary": { "type": "string" }
  },
  "required": ["category", "relevance", "one_line_summary"]
}

Ve zincirin istemi, besleme öğesine referans verir:

Classify this article for a VPS hosting audience.

Title: {{ $json.title }}
Content: {{ $json.contentSnippet }}

Maliyet hesabı burada değişir: Bu işlem çalıştırma başına değil, öğe başına maliyetlendirilir. Saatte elli makale, günde yirmi dört saat, ayda 36.000 Claude çağrısı demektir; Haiku modelinde makale uzunluğuna bağlı olarak yaklaşık 40–90 dolar, Opus modelinde ise bunun yaklaşık beş katı maliyet oluşur. LLM düğümünden önce verileri tekilleştirin (daha önce görülen bağlantılara karşı basit bir IF kontrolü veya n8n'in Remove Duplicates düğümü ile) ve sayı hızla düşecektir, çünkü çoğu saatlik sorgu yeni bir içerik barındırmaz. En ucuz token, hiç yapmadığınız çağrıdır.

İş Akışı 3: Araç kullanan bir yapay zeka ajanı

İlk iki iş akışı birer ardışık düzendir; adımlara siz karar verirsiniz. Bir AI Agent düğümü ise bu durumu tersine çevirir: Claude'a bir hedef ve araçlar verirsiniz, o da iş bitene kadar hangi araçları, hangi sırayla çağıracağına kendi karar verir. n8n, bir sohbet modeli alt düğümü ve buna bağlı en az bir araç alt düğümü gerektirir.

Somut bir yapı örneği olarak, izleme sisteminizden "ne çalışmıyor ve neden" sorusuna yanıt veren bir operasyon asistanı:

1. Chat Trigger (veya webhook), soru buradan gelir.
2. AI Agent, claude-sonnet-5 olarak ayarlanmış bir Anthropic Chat Model alt düğümü ile birlikte. Ajanlar araç çağrılarını planlar ve zincirler; Haiku basit, tek araçlı ajanları yönetebilir ancak araç sayısı arttığında Sonnet makul bir alt sınırdır.
3. HTTP Request düğümü, Uptime Kuma durum API veya Zabbix uç noktasına yönlendirilmiş bir araç olarak eklenir. İkinci bir HTTP aracı, REST API'si olan başka herhangi bir servise bağlanabilir.

İşin büyük kısmını iki ayar yapar. Ajanın System Message kısmı görevi tanımlar: "Sen bir operasyon asistanısın. Yanıt vermeden önce mevcut izleme durumunu kontrol etmek için durum aracını kullan. Sadece çalışmayan izleyicileri süreleriyle birlikte raporla." Ayrıca her aracın açıklaması insanlar için bir dokümantasyon değil, Claude'un onu ne zaman çağıracağına karar verme yöntemidir. "Tüm izlenen servislerin mevcut açık/kapalı durumunu JSON olarak döndürür" açıklaması doğru anlarda çağrılır; "durum API" açıklaması ise göz ardı edilir veya yanlış kullanılır. HTTP Request düğümünü bir araç olarak eklediğinizde, Optimize Response seçeneğini etkinleştirin ve önemli olan JSON alanlarını seçin; aksi takdirde her ayrıntılı API yanıtı, ödeme yaptığınız girdi belirteçleri (input tokens) olarak modelin bağlamına doldurulur.

Ajandaki Max Iterations (varsayılan değer 10'dur) ayarını çalışan en küçük sayıya getirin; bu, "ajan 4 araç çağrısından sonra vazgeçti" durumu ile bir düzine model gidiş-dönüşü içeren bir döngü arasındaki farktır. Ayrıca faturalandırma yapısını anlayın: her yineleme, şimdiye kadarki tüm konuşmayı, sistem mesajını, soruyu ve önceki tüm araç sonuçlarını girdi belirteci olarak yeniden gönderir. Altı yinelemeli bir ajan çalışması kolaylıkla toplam 20.000 kümülatif girdi belirteci ve 2.000 çıktı belirtecine ulaşabilir: Sonnet 5 modelinde 2$/10$ fiyatlandırmasıyla bu yaklaşık 0,06$ eder, yani basit bir özetleme çalışmasının yirmi katı. Eğer kendinizi tek bir ajana çok sayıda araç eklerken bulursanız, bu durum VPS üzerinde MCP sunucuları çalıştırmanın daha temiz bir mimari haline geldiği noktadır.

Maliyet koruma önlemleri, çünkü kimse izlemiyor

Gözetimsiz bir iş akışı, klavye başındaki bir insanın dolaylı olarak sağladığı kontrollere ihtiyaç duyar. En ucuzdan başlayarak dört katmanlı koruma:

Her Claude düğümünde Maksimum Token. Bu, kesin bir çıktı sınırıdır. Bir özetleyici 300, bir sınıflandırıcı 100 tokene ihtiyaç duyar. Bu, maliyetin pahalı tarafını sınırlar (bu kılavuzdaki modeller genelinde milyon çıktı tokeni başına $0.50–$50, girdi için $0.10–$10; çıktı maliyeti her modelde girdi fiyatının beş katıdır) ve bir kaçış freni görevi görür; Claude'un saçmalamasına neden olan bir istem hatası 8.000 değil, 300 token maliyet üretir.

Düğüm başına model. Yukarıda ele alınmıştır; Haiku 4.5 ile Opus 4.8 arasında beş kat, Fable 5'e kadar on kat fiyat farkı vardır ve mevcut seride Haiku 5.5'ten Fable 5.1'e kadar 100.000 tokene kadar olan istemlerde yüz kata kadar ulaşır. Ayarlaması on saniye sürer.

Döngüleri sınırlandırın. Ajanlarda Maksimum Yineleme (Max Iterations). İş akışı ayarlarında bir iş akışı zaman aşımı (timeout) belirleyin, böylece takılan bir yürütme sonsuza kadar dönmek yerine sonlanır. Ayrıca düğüm bazlı Retry On Fail (Hata Durumunda Yeniden Dene) özelliğine dikkat edin: geçici hatalar için doğru araçtır ancak yeniden denemeler maliyeti katlar. 5000 ms bekleme süresiyle 3 kez yeniden deneme (Max Tries), kalıcı bir hatanın vazgeçmeden önce öğe başına üç kez faturalandırılması anlamına gelir. Zaten pahalı bir şekilde başarıyla tamamlanmış bir düğümü asla yeniden deneme ile sarmalamayın.

Güvenlik ağı olarak bir hata iş akışı. Error Trigger düğümüyle başlayan ve başarısız olan iş akışının adını ve hatasını Slack'e gönderen bir iş akışı oluşturun, ardından bunu her bir AI iş akışının ayarlarında Hata İş Akışı olarak atayın. Bunun yakaladığı hata türü en kötü olanıdır: zamanlanmış bir iş akışının her saat başı, bir hafta boyunca hata vermesi ve her çalıştırmanın ölmeden önce token tüketmesi. Bunu Anthropic Konsolu'nda aylık bir harcama limiti ile eşleştirin ve zamanlanmış herhangi bir şeyi etkinleştirdikten sonraki ilk birkaç gün Konsol'un kullanım sayfasını kontrol edin. Tam olarak ne için faturalandırıldığınızı anlamak istiyorsanız, token kullanım kılavuzu bunu detaylıca açıklar.

Hata modları ve karşılaşacağınız dizeler

Düğüm "Authorization failed - please check your credentials." hatasıyla anında başarısız oluyor. API 401 kodu döndürdü. Temel gövde şu yapıdadır (güncel yanıtlar ayrıca bir request_id alanı içerir):

{"type": "error", "error": {"type": "authentication_error", "message": "invalid x-api-key"}}

Hatalı yapıştırılmış, kırpılmış, sonunda boşluk karakteri bulunan bir anahtar veya bir eğitim dokümanından kalan yer tutucu söz konusudur. n8n kimlik bilgisini yeniden oluşturun ve tekrar yapıştırın; eğer dün çalışıyorsa, anahtarın iptal edilip edilmediğini veya Console üzerinde son kullanma tarihinin dolup dolmadığını ya da bir birim geri yüklemesinin farklı bir N8N_ENCRYPTION_KEY ile şifrelenmiş bir kimlik bilgisine geri dönüp dönmediğini kontrol edin.

Çalıştırmalar 429 rate_limit_error hatasıyla anlık olarak başarısız oluyor, mesaj "Number of request tokens has exceeded your per-minute rate limit" ifadesine benzer. Hız sınırları dakika bazında ölçülür ve sürekli dolan bir token kovası ile uygulanır; n8n, elli adet webhook veya RSS çalıştırmasını aynı anda tetiklemeyi çok kolaylaştırır. Sorunu yapısal olarak çözün: öğeleri paralel yerine sırayla (Loop Over Items) işleyin ve Retry On Fail ayarında Max Tries değerini 3, Wait Between Tries değerini ise 5000 ms maksimum sınırına ayarlayın; n8n bu alanı 5000 ms ile sınırlar. Kovanın yeniden dolması için daha uzun bir bekleme süresine ihtiyaç duyduğunuzda, hata yoluna bir Wait düğümü ekleyin veya öğeleri tek tek işleyin. Bir 429 hız sınırı hatası genellikle kaç saniye beklemeniz gerektiğini belirten bir retry-after başlığı taşır (Anthropic dokümanları her 429 hatasının bunu içermediğini belirtir), n8n'in sabit bekleme süresi bunu okuyamaz, bu yüzden daha uzun duraklamayı kendiniz oluşturun. Bir istisna: retry-after başlığı olmayan ve error_code değeri enforced_spend_limit_reached olan bir 429 hatası, organizasyonunuzun aylık harcama limitine ulaştığı anlamına gelir; bir sonraki aya kadar veya bir üst seviyeye geçiş yapılana kadar hiçbir yeniden deneme başarılı olmaz.

Modelinizi adlandıran 404 not_found_error hatası. Mesaj, gönderdiğiniz model kimliğini şu şekilde belirtir:

{"type": "error", "error": {"type": "not_found_error", "message": "model: claude-haiku-4.5"}}

Tire yerine nokta kullanımı (4-5 yerine 4.5), yanlış yazılmış veya uydurulmuş bir tarih soneki ya da eski bir blog yazısından kalma, kullanımdan kaldırılmış bir model söz konusudur. Kimliği güncel liste ile karşılaştırarak düzeltin; bu durum, model alanını açılır menüden seçmek yerine ifade (expression) olarak yazan kullanıcıların sıkça karşılaştığı bir sorundur.

Claude sormadığınız bir soruya yanıt veriyor. Herhangi bir hata yoktur, çalıştırma başarılı (yeşil) görünür. Yükün message kullandığı bir durumda {{ $json.body.text }} gibi eksik bir alana başvuran bir n8n ifadesi, undefined dizisini isteminize ekler ve Claude, hiçbir şey hakkında olmayan bir isteme gayretle yanıt verir. Eğer başvurulan düğüm hiç çalışmadıysa, n8n ifadenin "henüz çalıştırılmamış" bir düğüme başvurduğunu belirten bir hatayla durur, ancak eksik bir alan sessiz kalır. Etkinleştirmeden önce her zaman gerçek verilerle bir kez çalıştırın ve düğümün giriş panelinde gerçekte oluşturulan istemi okuyun; ifade düzenleyici çözümlenmiş değeri önizler ve dikkatli bakarsanız undefined orada görünür.

FAQ

Claude'u n8n'e nasıl bağlarım?

Anthropic Console üzerinde platform.claude.com adresinden bir API anahtarı oluşturun. Ardından n8n içerisinde Anthropic türünde bir kimlik bilgisi (credential) ekleyin ve anahtarı API Key alanına yapıştırın. Anthropic uygulama düğümü ve Anthropic Chat Model alt düğümü dahil olmak üzere tüm Claude düğümleri, bu kayıtlı kimlik bilgisini referans alır. n8n bu veriyi N8N_ENCRYPTION_KEY ile şifreler; bu nedenle ilgili volume yedeğini aldığınızdan emin olun, aksi takdirde kimlik bilgileriniz kaybolur.

Bir yapay zeka iş akışının çalıştırma başına maliyeti nedir?

Çalıştırma başına token miktarını tahmin edin ve bunu modelin milyon başına fiyatıyla çarpın. Ekim 2026 itibarıyla Haiku 4.5 giriş/çıkış tokenları için milyon başına 1$/5$, Sonnet 5 için ise 2$/10$ fiyatlandırmaya sahiptir. Haiku üzerinde bir webhook özetleme işlemi yaklaşık çeyrek sent tutar; birkaç araç çağrısı içeren Sonnet tabanlı bir ajan çalıştırması ise 0.06$–0.10$ civarına gelir, çünkü her yinelemede tüm konuşma geçmişi tekrar giriş olarak gönderilir. Tahminlere güvenmek yerine, çalıştırma maliyetini Anthropic Console üzerindeki kullanım sayfasından doğrulayın.

n8n otomasyonları için hangi Claude modelini kullanmalıyım?

Sınıflandırma, veri çıkarma, özetleme ve yönlendirme gibi hız ve fiyatın ön planda olduğu yüksek hacimli işler için Haiku 4.5 tercih edilmelidir. AI Agent düğümleri ve çok adımlı mantıksal akıl yürütme gerektiren işlemler için Sonnet 5 kullanılmalıdır. Opus 4.8 ise yalnızca hatalı bir yanıtın maliyetinin, Haiku'nun beş katı ve Sonnet'in iki buçuk katı olan 5$/25$ liste fiyatını haklı çıkaracak kadar yüksek olduğu durumlarda seçilmelidir. Anthropic'in daha yeni modelleri olan Haiku 5.5, Sonnet 5.5 ve Opus 5.5, aynı veya daha düşük liste fiyatlarıyla aynı rolleri üstlenir. Modeli iş akışı bazında değil, düğüm bazında ayarlayın; tek bir iş akışı üç modeli de aynı anda içerebilir.

Bir n8n iş akışının Claude API üzerinde aşırı harcama yapmasını nasıl engellerim?

Güvenlik önlemlerini katmanlandırın: her Claude düğümünde düşük bir Max Tokens değeri, ajanlarda Max Iterations sınırı, bir iş akışı zaman aşımı ve hataların token harcamasını katlamaması için muhafazakar Retry On Fail ayarları kullanın. Ayrıca, herhangi bir yapay zeka iş akışı başarısız olduğunda sizi Slack üzerinden uyaracak bir Error Trigger iş akışı ekleyin ve Anthropic Console üzerinde VPS üzerindeki hiçbir işlemin aşamayacağı kesin bir aylık harcama limiti belirleyin.

Yapay zeka ajanı araç çağrıları ek ücret gerektirir mi?

Ayrı bir araç kullanım ücreti yoktur, ancak araçlar ücretsiz değildir: her araç sonucu, giriş tokenı olarak modele geri beslenir ve her ajan yinelemesi o ana kadarki tüm konuşmayı tekrar gönderir. Filtrelenmemiş, sohbet odaklı bir API yanıtı, gerçek isteminizden çok daha fazla token tüketebilir; bu nedenle HTTP Request araçlarında Optimize Response seçeneğini etkinleştirin ve yalnızca ajanın ihtiyaç duyduğu alanları döndürün.