Claude API n8n VPS iş akışı kurulumu

Ne inşa ediyorsunuz

Halihazırda çalışan n8n sunucunuzda üç çalışan yapay zeka iş akışı: gönderdiğiniz her şeyi özetleyen bir web kancası, 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 Aracısı. Bu, VPS'inizde Python'dan Claude API'sini çağırma işleminin kodsuz karşılığıdır; aynı API, aynı token'lar, aynı fatura, ancak düzenleme bir betik yerine n8n düğümlerinde gerçekleşir.

n8n'in Docker'da kendi barındırdığınız n8n kılavuzu uyarınca HTTPS arkasında zaten çalıştığını varsayıyorum. Çalışmıyorsa önce onu yapın; web kancaları gerçek bir TLS uç noktasına ihtiyaç duyar ve içine bir API anahtarı koyacağınız kimlik bilgisi deposu, o kılavuzun başınızın etini yediği şifreleme anahtarı yedeğine ihtiyaç duyar.

Buradaki ilginç sorunlar sürükle-bırak değildir. Bunlar, düğüm başına model seçimi, sessizce undefined enterpolasyonu yapan istem alanları ve bir otomasyonun gözetimsiz çalışmasıdır; çalıştırma başına yarım sente mal olan bir iş akışı, bir yeniden deneme döngüsü onu bir gecede dört bin kez çalıştırana kadar ucuzdur. Bu kılavuzun çoğu bunlarla ilgilidir.

Yedeklediğiniz anahtarla şifrelenmiş tek bir kimlik bilgisi

platform.claude.com adresindeki Anthropic Console'dan bir API anahtarı alın; önce Settings, sonra API Keys, ardından n8n-vps gibi bir isimle yeni bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir. Hesaba bakiye yükleyin veya faturalandırmayı kurun; API kullanımı token başına ücretlendirilir ve herhangi bir Claude.ai aboneliğinden tamamen bağımsızdır.

n8n içinde: Credentials, Create credential, 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 tek saklanan kimlik bilgisine başvurur; anahtarı asla bir düğümün içine yapıştırmazsınız.

İki işletim notu. İlk olarak, n8n saklanan kimlik bilgilerini N8N_ENCRYPTION_KEY ile şifreler. Bu ortam değişkenini n8n kılavuzuna uygun şekilde compose dosyanızda açıkça ayarlarsanız, kimlik bilginiz konteyner yeniden oluşturmalarında korunur; n8n'in bir tane oluşturmasına izin verir ve ardından volume'ü kaybederseniz, bu anahtar dahil saklanan her kimlik bilgisi kurtarılamaz şifreli metne dönüşür. Atladıysanız anahtarı şimdi yedekleyin. İkinci olarak, n8n kimlik bilgisi deposunu etki alanı olarak değerlendirin: örneğiniz üzerinde iş akışlarını düzenleyebilen herkes Anthropic anahtarınızla istekte bulunabilir. Ele geçirilmiş veya kontrolden çıkmış bir örneğin bir üst sınırı olması için Console'da Settings altında bir harcama limiti belirleyin.

Model seçimi düğüm bazında yapılan bir karardır

n8n'in Claude düğümlerindeki model açılır menüsü API'den canlı olarak çekilir, bu nedenle anahtarınızın erişebildiği modelleri gösterir. Temmuz 2026 itibarıyla ürün yelpazesi ve milyon giriş/çıkış token başına API fiyatlandırması şöyledir: Claude Haiku 4.5 (claude-haiku-4-5), 200K bağlam penceresiyle $1/$5, Claude Sonnet 5 (claude-sonnet-5) $3/$15, 31 Ağustos 2026'ya kadar tanıtım fiyatıyla $2/$10 ve Claude Opus 4.8 (claude-opus-4-8) $5/$25, her ikisi de 1M token bağlam penceresine sahiptir. En zorlu akıl yürütme işleri için Claude Fable 5 (claude-fable-5) $10/$50 fiyatla bulunur; bu kılavuzdaki hiçbir şey buna ihtiyaç duymaz. Bu tam kimlikleri kullanın, eski bir eğitimden hatırladığınız tarih ekli bir varyant 404 hatası verir ve fiyatlar değişir, bu nedenle burada dahil herhangi bir yerde okuduğunuz bir rakama güvenmeden önce platform.claude.com adresini kontrol edin.

Edinilmesi gereken alışkanlık: modeli platform bazında değil, düğüm bazında seçin. Otomasyonun temel taşları olan sınıflandırma, çıkarma, özetleme ve yönlendirme, Sonnet'in liste fiyatının üçte birine ve Opus'un beşte birine Haiku'da mükemmel şekilde çalışır. Sonnet'i aracılar ve çok adımlı akıl yürütme için, Opus'u ise yanlış bir cevabın token'lardan daha pahalıya mal olduğu nadir iş akışları için saklayın. Beş Claude düğümüne sahip bir iş akışı modelleri karıştırabilir ve karıştırmalıdır.

İki Claude düğümü ve nerede hangisinin kullanılacağı

n8n iki ayrı Anthropic entegrasyonu barındırır; yanlış olanı seçmek, başlangıçta en sık yapılan sapmadır.

Anthropic düğümü normal bir uygulama düğümüdür: tek istek girer, tek yanıt çıkar. Text kaynağında bir Message a Model işlemi ve görüntü ile belge çözümlemeye yönelik işlemler bulunur. İş akışı mantığı n8n içindeyken, yani tetikleyici, Claude çağrısı, sonraki düğüm şeklinde ilerlerken bu düğümü kullanın. Aşağıdaki İş Akışı 1 ve İş Akışı 2, ya bu düğümü ya da zincir eşdeğerini kullanır.

Anthropic Chat Model düğümü bir alt düğümdür; AI Agent ya da Basic LLM Chain gibi bir kök düğüme model sağlayan küçük bir eklentidir. Kendine ait tetikleyicisi ve çıktısı yoktur; model seçiciyi ve Maximum Number of Tokens, Sampling Temperature gibi örnekleme seçeneklerini sunar. n8n belgelerinden akılda tutulması gereken bir uyarı: alt düğüm içindeki ifadeler her zaman ilk girdi öğesine göre çözümlenir, her öğeye göre değil; öğe başına ifadeleri alt düğüm yerine kök düğümün istem alanlarına yerleştirin.

İş Akışı 1: webhook girer, özet çıkar

Yapay zeka otomasyonunun merhaba dünyası: bir URL'ye POST edilen her şey özetlenir ve Slack'e ya da e-posta 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ışı etkinleştirildikten 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.

İstem, n8n ifadelerinin Claude ile buluştuğu yerdir. Bir POST gövdesi $json.body altına düşer, 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 alanına koyun. Sistem istemi sabit kalırken yük değişir; bu, davranışı kararlı tutar ve istemi altı ay sonra okunabilir kılar. Doğrudan VPS'den 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 artı istem yaklaşık $0,0012 giriş, 300 token çıkış $0,0015 tutar, kabaca bir cent'in çeyreği. Ayda bin çalıştırma 3 doların altındadır. Aynı düğüm Opus 4.8'e yönlendirildiğinde yaklaşık beş katıdır. Bu oran, inşa ettiğiniz her iş akışıyla çarpıldığında, düğüm başına model alışkanlığının neden önemli olduğunu gösterir.

İş Akışı 2: zamanlanmış RSS'ten yapılandırılmış satırlara

Şimdi saatli ve yapılandırılmış çıktılı bir iş: saat başı bir RSS beslemesi oku, her öğeyi sınıflandır, bir sayfaya satır ekle.

1. Schedule Trigger, her saat başı.
2. RSS Read, besleme URL'si. Makale başına bir öğe çıkarır.
3. Basic LLM Chain, alt düğüm olarak claude-haiku-4-5 olarak ayarlanmış bir Anthropic Chat Model ve bir JSON şeması tutan Structured Output Parser alt düğümü ile.
4. Google Sheets (veya Postgres), öğe başına bir satır ekler.

Structured Output Parser, "Claude, lütfen JSON döndür" talebini bir temenniden sözleşmeye dönüştüren şeydir: modelin yanıtını şemanıza göre doğrular ve çöp satırlar yazmak yerine öğeyi gürültülü biçimde başarısız kılar. Örnek 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"]
}

Zincirin komutu ise besleme öğesine şöyle referans verir:

Classify this article for a VPS hosting audience.

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

Maliyet hesabı burada şekil değiştirir: bu, çalıştırma başına değil, öğe başınadır. Saatte elli makale, günde yirmi dört saat, ayda 36.000 Claude çağrısı yapar; Haiku ile makale uzunluğuna bağlı olarak belki $40–90, Opus ile yaklaşık beş katı. LLM düğümünden önce tekilleştirme yapın (daha önce görülen bağlantılara karşı basit bir IF veya n8n'in Remove Duplicates düğümü) ve sayı çöker, çünkü çoğu saatlik sorgu yeni hiçbir şey içermez. En ucuz token, hiç yapmadığınız çağrıdır.

İş Akışı 3: Araç kullanan bir Yapay Zeka Ajanı

İlk iki iş akışı, adımları sizin belirlediğiniz iş hatlarıdır. Bir Yapay Zeka Ajanı düğümü bunu tersine çevirir: Claude'a bir hedef ve araçlar verirsiniz ve iş tamamlanana kadar hangi araçları, hangi sırayla çağıracağına kendisi karar verir. n8n, bir sohbet modeli alt düğümü ve en az bir araç alt düğümü bağlanmasını gerektirir.

Somut bir yapı, izleme sisteminizden "ne çökmüş ve neden" sorusunu yanıtlayan bir operasyon asistanı:

1. Sohbet Tetikleyicisi (veya web kancası), soru gelir.
2. Yapay Zeka Ajanı, claude-sonnet-5 olarak ayarlanmış bir Anthropic Sohbet Modeli alt düğümü ile. Ajanlar araç çağrılarını planlar ve zincirler; Haiku basit tek araçlı ajanları yönetebilir, ancak araçlar çoğaldığında Sonnet makul alt sınırdır.
3. HTTP İsteği düğümü araç olarak bağlanır, Uptime Kuma durum API'nize veya Zabbix uç noktanıza yönlendirilir. İkinci bir HTTP aracı, REST API'si olan başka herhangi bir şeye istek yapabilir.

İşin çoğunu iki ayar halleder. Ajanın Sistem Mesajı görevi tanımlar: "Sen bir operasyon asistanısın. Yanıtlamadan önce mevcut izleme durumunu kontrol etmek için durum aracını kullan. Yalnızca çökmüş olan izleyicileri, süreleriyle birlikte bildir." Ve her aracın açıklaması insanlar için belgelendirme değil, Claude'un aracı ne zaman çağıracağına karar verme şeklidir. "İzlenen tüm hizmetler için mevcut çalışıyor/çökmüş durumunu JSON olarak döndürür" doğru anlarda çağrılır; "durum API'si" göz ardı edilir veya yanlış kullanılır. HTTP İsteği düğümünü araç olarak bağladığınızda, Yanıtı Optimize Et seçeneğini etkinleştirin ve önemli olan JSON alanlarını seçin, aksi takdirde her ayrıntılı API yanıtı, ödediğiniz girdi token'ları olarak modelin bağlamına yığılır.

Ajandaki Maksimum Yineleme değerini (varsayılan 10'dur) çalışan en küçük sayıya ayarlayın; bu, "ajan 4 araç çağrısından sonra pes etti" ile bir düzine model gidiş-dönüşü döngüsü arasındaki farktır. Ayrıca faturalandırma şeklini anlayın: her yineleme, o ana kadarki tüm konuşmayı, sistem mesajını, soruyu, önceki her araç sonucunu girdi token'ları olarak yeniden gönderir. Altı yinelemeli bir ajan çalışması kolayca toplam 20.000 kümülatif girdi token'ı ve 2.000 çıktı token'ına ulaşabilir: Sonnet 5'in tanıtım fiyatlandırmasında yaklaşık $0,06, standart $3/$15'te kabaca $0,09, basit bir özetleme çalışmasının yaklaşık yirmi katı. Kendinizi bir ajana birçok araç bağlarken bulursanız, VPS'inizde MCP sunucuları çalıştırmak daha temiz mimari haline gelir.

Maliyet koruma bariyerleri, çünkü kimse izlemiyor

İnsansız çalışan bir iş akışı, klavye başındaki bir kişinin kendiliğinden sağladığı kontrollere ihtiyaç duyar. En ucuzdan başlayarak dört katman.

Her Claude düğümünde Maksimum Token. Sert 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ı (milyon çıktı token başına $5–$25, girdi için $1–$5) sınırlar ve aynı zamanda bir kaçış freni görevi görür; Claude'un başıboş konuşmasına neden olan bir istem hatası 8.000 değil 300 tokene mal olur.

Düğüm başına model. Yukarıda ele alındı; mevcut ürün yelpazesinde beş ila on katlık bir fiyat kaldıracıdır ve ayarlanması on saniye sürer.

Döngüleri sınırlayın. Ajanlarda Maksimum Yineleme. İş akışı ayarlarında bir iş akışı zaman aşımı, böylece takılı kalan bir yürütme dönüp durmak yerine sonlanır. Ayrıca düğüm başına Başarısızlıkta Yeniden Dene seçeneğinde dikkatli olun: geçici hatalar için doğru araçtır, ancak yeniden denemeler maliyeti katlar; Denemeler Arası Bekleme 5000 ms ile Maksimum Deneme 3 olarak ayarlandığında, kalıcı bir hata, pes etmeden önce öğe başına sizi üç kata kadar faturalandırabilir. Zaten pahalıya mal olmuş ve başarılı olmuş bir düğümün etrafına asla yeniden deneme sarmayın.

Son savunma olarak bir hata iş akışı. Başarısız olan iş akışının adını ve hatasını Slack'e gönderen Hata Tetikleyici düğümüyle başlayan bir iş akışı oluşturun, ardından bunu her yapay zeka iş akışının ayarlarında Hata İş Akışı olarak belirleyin. Bu yöntemin yakaladığı başarısızlık modu çirkin olandır: zamanlanmış bir iş akışının her çalıştırmada, her saat, bir hafta boyunca hata vermesi ve her çalıştırmanın sonlanmadan önce token yakması. Bunu, Anthropic Konsolu'nda aylık 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 ayrıntılı olarak inceler.

Karşılaşacağınız dizelerle birlikte hata modları

Düğüm, "Authorization failed - please check your credentials." hatasıyla anında başarısız olur. API 401 döndürmüştür. Altta yatan gövde şudur:

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

Yanlış yapıştırılmış, kesilmiş, sonunda boşluk kalmış bir anahtar veya bir eğitimden kalan yer tutucu. n8n kimlik bilgisini yeniden oluşturun ve tekrar yapıştırın; dün çalışıyorsa, anahtarın Konsol'dan iptal edilip edilmediğini veya bir birim geri yüklemesinin, farklı bir N8N_ENCRYPTION_KEY ile şifrelenmiş bir kimlik bilgisine geri dönüp dönmediğini kontrol edin.

Yürütmeler, 429 rate_limit_error ile patlamalar halinde başarısız olur, "Number of request tokens has exceeded your per-minute rate limit." benzeri bir mesaj. Hız limitleri dakikalık kovalardır ve n8n, elli webhook veya RSS yürütmesini aynı anda tetiklemeyi çok kolaylaştırır. Yapısal olarak düzeltin: öğeleri paralel yerine sırayla işleyin (Öğeler Üzerinde Döngü) ve Retry On Fail'i Maks Deneme 3 ve Denemeler Arası Bekleme'yi maksimumu olan 5000 ms olarak ayarlayın, n8n bu alanı 5000 ms ile sınırlar. Yeniden denemelerin bir sonraki dakika penceresine denk gelmesi için daha uzun bir geri çekilme gerektiğinde, hata yoluna bir Bekle düğümü koyun veya öğeleri teker teker işleyin. Yanıt, tam olarak ne kadar bekleneceğini söyleyen bir retry-after başlığı taşır, n8n'nin sabit beklemesi bunu okuyamaz, bu yüzden daha uzun duraklamayı kendiniz oluşturun.

Modelinizi adlandıran 404 not_found_error. Gövde, yazım hatasını yansıtır:

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

Tire yerine nokta (4-5 için 4.5), güncel olmayan bir blog yazısından kalma tarih eki veya kullanımdan kaldırılmış bir model. Kimliği güncel listeye göre düzeltin; bu, model alanına açılır listeden seçmek yerine ifade olarak yazan kişileri etkiler.

Claude, sizin sormadığınız bir soruyu yanıtlar. Hiçbir yerde hata yok, çalıştırma yeşildir. Eksik bir alana başvuran bir n8n ifadesi, örneğin yük message kullandığında {{ $json.body.text }} gibi, istemcinize undefined değişmez dizesini enterpole eder ve Claude da hiçlik hakkındaki bir isteme hevesle yanıt verir. Başvurulan düğüm hiç yürütülmediyse "Referenced node is unavailable" alırsınız, ancak eksik bir alan sessizdir. Etkinleştirmeden önce, her zaman gerçek verilerle bir kez çalıştırın ve düğümün giriş panelinde işlenmiş gerçek istemi okuyun, ifade düzenleyici çözümlenen değeri önizler ve bakarsanız undefined tam oradadır.

FAQ

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

platform.claude.com adresindeki Anthropic Console'da bir API anahtarı oluşturun, ardından n8n'de Anthropic türünde bir kimlik bilgisi ekleyin ve bunu API Key alanına yapıştırın. Her Claude düğümü, Anthropic uygulama düğümü ve Anthropic Chat Model alt düğümü bu saklanan kimlik bilgisine başvurur. n8n bunu N8N_ENCRYPTION_KEY ile şifreler, bu yüzden anahtarı yedekleyin, aksi takdirde kimlik bilgileriniz volume ile birlikte kaybolur.

Bir AI iş akışının çalışma başına maliyeti nedir?

Çalışma başına token sayısını tahmin edin, ardından modelin milyon başına fiyatlarıyla çarpın; Temmuz 2026 itibarıyla Haiku 4.5, milyon giriş/çıkış tokenı başına $1/$5 ve Sonnet 5, $3/$15'tir (Ağustos 2026'ya kadar tanıtım fiyatıyla $2/$10). Haiku üzerinde bir webhook özetleme işlemi yaklaşık bir cent'in dörtte biri tutar; birkaç araç çağrısı olan Sonnet üzerinde bir ajan çalışması ise $0,06–$0,10 civarına gelir, çünkü her yineleme tüm konuşmayı girdi olarak yeniden gönderir. Tahminlere güvenmek yerine, Console'un kullanım sayfasından çalışmayı doğrulayın.

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

Sınıflandırma, çıkarma, özetleme ve yönlendirme gibi hız ve fiyatın öne çıktığı yüksek hacimli işler için Haiku 4.5. AI Agent düğümleri ve çok adımlı akıl yürütme için Sonnet 5. Opus 4.8'i yalnızca yanlış bir cevabın, $5/$25 liste fiyatını (Haiku'nun beş katı, Sonnet'in iki katından biraz az) haklı çıkaracak kadar pahalı olduğu durumlarda kullanın. Modeli iş akışı başına değil, düğüm başına ayarlayın; bir iş akışı üçünü birden karıştırabilir.

Bir n8n iş akışının Claude API'sinde aşırı harcama yapmasını nasıl durdururum?

Koruma katmanlarını üst üste koyun: her Claude düğümünde düşük bir Max Tokens, ajanlarda Max Iterations, bir iş akışı zaman aşımı ve hataların token harcamasını katlamaması için muhafazakar Retry On Fail ayarları. Ardından, herhangi bir AI iş akışı başarısız olduğunda sizi Slack'te uyaran bir Error Trigger iş akışı ekleyin ve VPS üzerindeki hiçbir şeyin geçersiz kılamayacağı kesin tavan olarak Anthropic Console'da aylık bir harcama limiti belirleyin.

AI Agent araç çağrıları ekstra maliyet getirir mi?

Ayrı bir araç ücreti yoktur, ancak araçlar ücretsiz değildir: her araç sonucu modele girdi tokenı olarak geri beslenir ve her ajan yinelemesi o ana kadarki tüm konuşmayı yeniden gönderir. Filtrelenmeden geçirilen geveze bir API yanıtı, asıl isteminizi gölgede bırakabilir; HTTP Request araçlarında Optimize Response özelliğini etkinleştirin ve yalnızca ajanın ihtiyaç duyduğu alanları döndürün.