كيفية ربط Claude بـ n8n على VPS وبناء تدفقات AI

ما الذي ستبنيه

ثلاثة تدفقات عمل عملية للذكاء الاصطناعي على مثيل n8n الذي تشغّله بالفعل: webhook يلخّص أي محتوى ترسله إليه، وقارئ موجّه مجدول يحوّل المقالات إلى صفوف منظّمة في جدول بيانات، وAI Agent يستدعي HTTP API تلقائياً للإجابة عن الأسئلة. هذا هو البديل من دون كتابة تعليمات برمجية عن استدعاء Claude API من Python على VPS؛ واجهة API نفسها، والرموز نفسها، والتكلفة نفسها، لكن تنسيق العمليات يتم داخل عقد n8n بدلاً من برنامج نصي.

أفترض أن n8n يعمل بالفعل خلف HTTPS وفقاً لـدليل تشغيل n8n مستضاف ذاتياً على Docker. إذا لم يكن كذلك، فنّفذ ذلك أولاً. تحتاج webhooks إلى نقطة نهاية TLS حقيقية، كما أن مخزن بيانات الاعتماد الذي ستضع فيه مفتاح API يحتاج إلى النسخة الاحتياطية لمفتاح التشفير التي يحذرك الدليل من الاحتفاظ بها.

المشكلات المهمة هنا لا تتعلق بالسحب والإفلات. بل تتعلق باختيار النموذج لكل عقدة، وحقول المطالبات التي تُجري استبدالاً ضمنياً لـ undefined، وحقيقة أن الأتمتة تعمل دون إشراف. يكون تدفق العمل الذي يكلّف نصف سنت لكل تشغيل رخيصاً، إلى أن تؤدي حلقة إعادة المحاولة إلى تشغيله أربعة آلاف مرة خلال الليل. يركّز معظم هذا الدليل على هذه الجوانب.

بيانات اعتماد واحدة، مشفّرة باستخدام المفتاح الذي نسختَه احتياطياً

احصل على مفتاح API من Anthropic Console على platform.claude.com، ثم افتح Settings، وبعدها API Keys، وأنشئ مفتاحاً باسم مثل n8n-vps. سيُعرض المفتاح مرة واحدة فقط. يطلب منك Console أيضاً اختيار تاريخ انتهاء الصلاحية عند إنشاء المفتاح. دوّن هذا التاريخ، لأن انتهاء صلاحية المفتاح يعطّل سير العمل غير المراقَب بالخطأ 401 نفسه الموضح ضمن أوضاع الفشل أدناه. موّل الحساب أو أعد إعداد الفوترة. تُحاسَب استخدامات API حسب عدد الرموز، وتُدفع من الأرصدة المدفوعة مسبقاً. لا يغطيها اشتراك Pro، لكن خطتَي Claude Max وTeam تتضمنان الآن أرصدة شهرية لـClaude API بقيمة $100 في Max 5x و$200 في Max 20x، وبقيمة مشتركة تصل إلى $500 في Team. تحصل على هذه الأرصدة بربط مؤسسة Console بإعدادات الفوترة في claude.ai. تدفع هذه الأرصدة مقابل استدعاءات API مثل الاستدعاءات التي يجريها n8n، لكنها لا تغطي Claude Code، وتنتهي في نهاية كل دورة فوترة. إذا كنت تأمل في إنشاء مسارات العمل الثلاثة هذه من دون دفع أي مبلغ، فلا توجد طبقة مجانية، باستثناء عدد قليل من نقاط النهاية، مثل عدّ الرموز، التي لا تكلّف شيئاً على الإطلاق.

في n8n: افتح Credentials، ثم Create credential، واختر Anthropic، والصق المفتاح في الحقل API Key، ثم احفظ. تشير كل عقدة Claude في كل سير عمل إلى بيانات الاعتماد المخزّنة هذه. لا تلصق المفتاح داخل أي عقدة.

ملاحظتان تشغيليتان. أولاً، يشفّر n8n بيانات الاعتماد المخزّنة باستخدام N8N_ENCRYPTION_KEY. إذا عيّنت متغير البيئة هذا صراحةً في ملف compose وفقاً لدليل n8n، فستبقى بيانات الاعتماد متاحة بعد إعادة إنشاء الحاويات. أما إذا سمحت لـn8n بإنشاء مفتاح ثم فقدت volume، فستصبح كل بيانات الاعتماد المخزّنة، بما فيها هذا المفتاح، نصاً مشفّراً غير قابل للاسترداد. انسخ المفتاح احتياطياً الآن إذا تخطيت هذه الخطوة. ثانياً، اعتبر مخزن بيانات اعتماد n8n نطاق التأثير المحتمل: يمكن لأي شخص يستطيع استخدام بيانات اعتماد Anthropic الخاصة بك إرسال طلبات باستخدام مفتاحك. في إصدار Community، هذا الشخص هو أنت ومالك المثيل؛ إذ تنص وثائق n8n على أن "Only the instance owner and the user who creates them can access workflows and credentials"، ولذلك لا تستطيع حسابات Member الأخرى الوصول إليها. تُعد مشاركة مسارات العمل وبيانات الاعتماد ميزة مدفوعة في n8n المستضاف ذاتياً، ضمن خطتَي Business أو Enterprise. وبعد مشاركة سير عمل، يستطيع محرروه استخدام كل بيانات الاعتماد التي يستخدمها ذلك السير. لذلك، إذا سجّل أي شخص آخر الدخول إلى هذا المثيل، اقرأ ضوابط الوصول التي تتطلب ترخيص n8n مدفوعاً قبل منحه حساباً. عيّن حداً للإنفاق في Console ضمن Settings، حتى يكون للمثيل المخترق أو الخارج عن السيطرة حد أقصى للتكلفة.

اختيار النموذج قرار يُتخذ لكل عقدة

تُجلب قائمة النماذج في عقد Claude داخل n8n مباشرةً من API، ولذلك فهي تعرض النماذج التي يمكن لمفتاحك الوصول إليها. النماذج التي يستخدمها هذا الدليل، مع أسعار API لكل مليون من رموز الإدخال والإخراج حتى October 2026، هي: Claude Haiku 4.5 (claude-haiku-4-5) بسعر $1/$5 وبنافذة سياق تبلغ 200K، وClaude Sonnet 5 (claude-sonnet-5) بسعر $2/$10، وClaude Opus 4.8 (claude-opus-4-8) بسعر $5/$25، وكلاهما ب‍نافذة سياق تبلغ 1M من الرموز. يتوفر أيضاً Claude Fable 5 (claude-fable-5) بسعر $10/$50 لمهام الاستدلال الأصعب؛ ولا يحتاج أي شيء في هذا الدليل إليه. استخدم هذه المعرّفات حرفياً. claude-haiku-4-5 هو اسم مستعار للنسخة المثبتة claude-haiku-4-5-20251001، ويمكن استخدامه أيضاً، لكن المعرّف المؤرخ المنسوخ من دليل قديم قد يشير إلى نموذج متقاعد ويفشل. تتغير الأسعار، لذلك تحقّق من platform.claude.com قبل الاعتماد على أي رقم تقرؤه في أي مكان، بما في ذلك هنا.

منذ نشر هذا الدليل للمرة الأولى، أصدرت Anthropic نماذج أحدث، وتضع وثائقها الآن Haiku 4.5 وSonnet 5 وOpus 4.8 ضمن النماذج القديمة. ما زالت هذه النماذج تعمل: لن يتقاعد Haiku 4.5 قبل October 15, 2026، ولن يتقاعد Sonnet 5 وOpus 4.8 قبل منتصف 2027، كما تمنح Anthropic إشعاراً قبل 60 يوماً على الأقل قبل تقاعد أي نموذج. لذلك راقب صفحة الإهمال إذا كانت مسارات العمل لديك تثبّت Haiku 4.5. تضم المجموعة الحالية Claude Haiku 5.5 (claude-haiku-5-5، صدر في October 7, 2026) بسعر يبدأ من $0.10/$0.50 للمطالبات التي تصل إلى 100,000 رمز، ومن $0.50/$2.50 للمطالبات التي تتجاوز ذلك، وClaude Sonnet 5.5 (claude-sonnet-5-5) بسعر $2/$10، وClaude Opus 5.5 (claude-opus-5-5) بسعر $4/$20، وClaude Fable 5.1 (claude-fable-5-1) بسعر $10/$50. يحسب tokenizer الخاص بـHaiku 5.5 النص نفسه بنحو 30% من الرموز الإضافية مقارنةً بـHaiku 4.5، لذلك قارن التكاليف الفعلية لكل تشغيل في صفحة الاستخدام داخل Console، ولا تعتمد على أسعار القائمة وحدها.

العادة التي ينبغي ترسيخها هي اختيار النموذج لكل عقدة، لا لكل منصة. تعمل مهام التصنيف والاستخراج والتلخيص والتوجيه، وهي جوهر الأتمتة، بكفاءة كبيرة على Haiku بسعر قائمة يبلغ نصف سعر Sonnet وخُمس سعر Opus. خصص Sonnet للوكلاء ومهام الاستدلال متعددة الخطوات، وOpus لمسار العمل النادر الذي تكون فيه تكلفة الإجابة الخاطئة أعلى من تكلفة الرموز. يمكن لمسار عمل يضم خمس عقد Claude أن يخلط بين النماذج، وينبغي له ذلك.

عقدتا Claude وأيّهما تستخدم ومتى

يوفّر n8n تكاملين منفصلين مع Anthropic، واختيار التكامل الخطأ هو أكثر الأخطاء الشائعة التي يواجهها المبتدئون.

عقدة Anthropic هي عقدة تطبيق عادية: طلب واحد يدخل، واستجابة واحدة تخرج. يتضمن مورد Text فيها عملية Message a Model، إضافة إلى عمليات لتحليل الصور والمستندات. استخدمها عندما يكون منطق سير العمل داخل n8n، مثل: مشغّل، ثم استدعاء Claude، ثم العقدة التالية. يستخدمها سيرَا العمل 1 و2 أدناه، أو يستخدمان ما يعادلها ضمن سلسلة.

عقدة Anthropic Chat Model هي عقدة فرعية، أي مكوّن صغير يزوّد عقدة جذر مثل AI Agent أو Basic LLM Chain بالنموذج. لا تحتوي على مشغّل، ولا تنتج مخرجات خاصة بها؛ بل تتيح اختيار النموذج، إضافة إلى خيارات أخذ العينات مثل Maximum Number of Tokens وSampling Temperature. هناك ملاحظة مهمة من وثائق n8n يجدر تذكّرها: تُقيَّم expressions داخل العقد الفرعية دائماً بالاستناد إلى عنصر الإدخال الأول، وليس إلى كل عنصر على حدة. لذلك ضع expressions الخاصة بكل عنصر في حقول prompt داخل عقدة الجذر، وليس داخل العقدة الفرعية. وهناك ملاحظة من جانب Anthropic: في نماذج Claude 4.7 والإصدارات الأحدث، وهي جميع النماذج الواردة في هذا الدليل باستثناء Haiku 4.5، يؤدي ضبط temperature أو top_p أو top_k على قيمة غير افتراضية إلى إرجاع خطأ 400. لذلك اترك Sampling Temperature وTop K وTop P من دون ضبط في هذه النماذج.

سير العمل 1: إدخال webhook وإخراج ملخّص

هذا أبسط مثال على أتمتة الذكاء الاصطناعي: يُلخَّص أي شيء يُرسَل عبر POST إلى عنوان URL، ثم يصل الملخّص إلى Slack أو إلى صندوق الوارد لديك.

1. عقدة Webhook، مع تعيين HTTP Method إلى POST والمسار إلى summarize. يوفّر لك n8n عنوان URL للاختبار وعنوان URL للإنتاج؛ ولا يبدأ عنوان الإنتاج بالاستماع إلا بعد نشر سير العمل.
2. عقدة Anthropic، مع اختيار Message a Model، وتعيين النموذج إلى claude-haiku-4-5، وMax Tokens إلى نحو 300.
3. عقدة Slack (أو Send Email) لإرسال نص الاستجابة إلى قناة.

تلتقي تعبيرات n8n مع Claude في المطالبة. يصل نص POST ضمن $json.body، لذلك يبدو حقل رسالة المستخدم كما يلي:

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

{{ $json.body.text }}

ضع تعليمات الدور والتنسيق في حقل system prompt للعقدة، وليس في رسالة المستخدم. يبقى system prompt ثابتاً، بينما تتغير البيانات المرسلة. يحافظ ذلك على استقرار السلوك ويجعل المطالبة واضحة بعد ستة أشهر. اختبرها من VPS نفسه:

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 نحو $0.0012 للبيانات المرسلة التي تتكون من 1,200 token بالإضافة إلى المطالبة، ونحو $0.0015 لإخراج يتكون من 300 token، أي ما يقارب ربع سنت. تبلغ تكلفة ألف تشغيل شهرياً أقل من $3. وتبلغ تكلفة توجيه العقدة نفسها إلى Opus 4.8 نحو خمسة أضعاف ذلك. وتوضّح هذه النسبة، عند ضربها في كل سير عمل تنشئه، سبب أهمية اختيار النموذج على مستوى كل عقدة.

سير العمل 2: تحويل RSS المجدول إلى صفوف منظَّمة

الآن سننفّذ سير عمل يعمل وفق جدول زمني ويُنتج بيانات منظَّمة: اقرأ موجز RSS كل ساعة، وصنّف كل عنصر، وأضف صفوفاً إلى جدول.

1. مشغّل الجدولة، كل ساعة.
2. قراءة RSS، باستخدام عنوان URL للموجز. يُنتج عنصراً واحداً لكل مقال.
3. سلسلة Basic LLM، مع عقدة فرعية Anthropic Chat Model مضبوطة على claude-haiku-4-5، وعقدة فرعية Structured Output Parser تحتوي على مخطط JSON.
4. Google Sheets (أو Postgres)، لإضافة صف لكل عنصر.

تُحوِّل Structured Output Parser عبارة «Claude، يُرجى إرجاع JSON» من مجرد توقع إلى عقد: إذ تتحقق من رد النموذج مقابل مخططك، وتفشل للعنصر بوضوح بدلاً من كتابة صفوف غير صالحة. ويكون المخطط على النحو التالي:

{
  "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"]
}

وتشير مطالبة السلسلة إلى عنصر الموجز:

Classify this article for a VPS hosting audience.

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

تختلف حسابات التكلفة هنا، لأن المعالجة تكون لكل عنصر لا لكل تشغيل. إذا كان هناك 50 مقالاً في الساعة و24 ساعة يومياً، فسيكون العدد 36,000 استدعاءً لـ Claude شهرياً. وقد تتراوح التكلفة مع Haiku بين $40 و$90 حسب طول المقال، بينما تبلغ مع Opus نحو خمسة أضعاف ذلك. أزل التكرارات قبل عقدة LLM، باستخدام IF بسيط للتحقق من الروابط التي عولجت سابقاً، أو باستخدام عقدة Remove Duplicates في n8n. عندها ينخفض العدد كثيراً، لأن معظم عمليات الجلب كل ساعة لا تحتوي على عناصر جديدة. أرخص رمز هو الاستدعاء الذي لا تجريه أبداً.

سير العمل 3: وكيل ذكاء اصطناعي يستخدم الأدوات

سيرتا العمل الأوليان عبارة عن مسارات معالجة تحدد أنت خطواتها. تعكس عقدة AI Agent هذا الأسلوب: تمنح Claude هدفاً وأدوات، وهو يقرر الأدوات التي يستدعيها وترتيب استدعائها إلى أن ينتهي. يتطلب n8n عقدة فرعية لنموذج محادثة وعقدة فرعية واحدة على الأقل لأداة مرتبطة بها.

مثال عملي: مساعد عمليات يجيب عن سؤال «ما الخدمات المتوقفة ولماذا؟» اعتماداً على نظام المراقبة لديك:

1. Chat Trigger (أو webhook)، حيث يصل السؤال.
2. AI Agent، مع عقدة فرعية من نوع Anthropic Chat Model مضبوطة على claude-sonnet-5. يخطط الوكلاء لاستدعاءات الأدوات ويربطون بينها؛ ويمكن لـ Haiku تشغيل وكلاء بسيطين يستخدمون أداة واحدة، لكن Sonnet هو الحد العملي المعقول عندما يزداد عدد الأدوات.
3. عقدة HTTP Request مرتبطة كأداة وموجّهة إلى واجهة Uptime Kuma لحالة الخدمة أو نقطة نهاية Zabbix. ويمكن لأداة HTTP ثانية الوصول إلى أي خدمة أخرى توفّر REST API.

تنجز إعدادان معظم العمل. تحدد System Message الخاصة بالوكيل المهمة: «أنت مساعد عمليات. استخدم أداة الحالة للتحقق من الحالة الحالية للمراقبات قبل الإجابة. أبلغ فقط عن المراقبات المتوقفة، مع ذكر المدة». أما وصف كل أداة فليس توثيقاً للبشر، بل هو الطريقة التي يقرر بها Claude متى يستدعي الأداة. سيؤدي الوصف «يعيد الحالة الحالية، متوقفة أو عاملة، لجميع الخدمات المراقبة بتنسيق JSON» إلى استدعاء الأداة في الأوقات المناسبة؛ أما الوصف «واجهة API للحالة» فقد يُتجاهل أو يُستخدم بطريقة غير صحيحة. عند إرفاق عقدة HTTP Request كأداة، فعّل خيار Optimize Response وحدد حقول JSON المهمة. وإلا فسيُمرَّر كل رد API مطوّل إلى سياق النموذج كرموز إدخال تدفع تكلفتها.

اضبط Max Iterations في الوكيل (القيمة الافتراضية هي 10) على أصغر عدد ينجح، فهذا هو الفارق بين «استسلم الوكيل بعد 4 استدعاءات للأدوات» وحلقة تضم نحو 12 جولة ذهاباً وإياباً مع النموذج. وافهم طريقة احتساب التكلفة: في كل تكرار، يُعاد إرسال المحادثة الكاملة حتى تلك اللحظة، بما في ذلك رسالة النظام والسؤال وكل نتيجة أداة سابقة، بوصفها رموز إدخال. قد يصل تشغيل وكيل من 6 تكرارات بسهولة إلى إجمالي تراكمي قدره 20,000 رمز إدخال و2,000 رمز إخراج؛ وباستخدام Sonnet 5 بسعر $2/$10، تبلغ التكلفة نحو $0.06. كرر العملية 20 مرة مع تشغيل تلخيص بسيط. إذا وجدت نفسك تضيف أدوات كثيرة إلى وكيل واحد، فقد حان الوقت لاعتماد بنية أنظف عبر تشغيل خوادم MCP على VPS لديك.

ضوابط التكلفة، لأن لا أحد يراقب

يحتاج سير العمل غير المراقَب إلى عناصر التحكم التي يوفّرها الإنسان أمام لوحة المفاتيح تلقائياً. استخدم أربع طبقات، بدءاً بالأقل تكلفة.

Max Tokens في كل عقدة Claude. يفرض هذا حداً أقصى ثابتاً على المخرجات. يحتاج الملخِّص إلى 300، بينما يحتاج المصنِّف إلى 100. يحدّ ذلك من الجانب الأعلى تكلفة في الحسابات؛ إذ تتراوح التكلفة بين النماذج المشمولة في هذا الدليل من $5–$50 لكل مليون رمز مخرجات، مقابل $1–$10 لرموز الإدخال، مع احتساب المخرجات بسعر يبلغ خمسة أضعاف سعر الإدخال في كل نموذج. كما يعمل ذلك ككابح عند الانفلات: فإذا تسبب خطأ في prompt بجعل Claude يسترسل، فستُحتسب تكلفة 300 رمز لا 8,000.

Model لكل عقدة. تناولنا ذلك أعلاه. يتيح الاختيار بين Haiku 4.5 وOpus 4.8 خفض السعر أو زيادته بمقدار خمسة أضعاف، ويصل الفرق إلى عشرة أضعاف عند المقارنة مع Fable 5. وعبر التشكيلة الحالية، من Haiku 5.5 إلى Fable 5.1، يصل الفرق إلى مئة ضعف في prompts التي تصل إلى 100,000 رمز. ويستغرق ضبط ذلك عشر ثوانٍ.

ضع حدوداً للحلقات. استخدم Max Iterations مع الوكلاء. اضبط مهلة لسير العمل في إعداداته، حتى يتوقف التنفيذ المتعطل بدلاً من الاستمرار في الدوران. وانتبه إلى Retry On Fail لكل عقدة: فهو مناسب للأخطاء المؤقتة، لكن عمليات إعادة المحاولة تضاعف التكلفة. تعني قيمة Max Tries البالغة 3 مع Wait Between Tries البالغة 5000 ms أن الفشل المستمر قد يُحتسب عليك حتى ثلاث مرات لكل عنصر قبل التخلي عن المحاولة. لا تضع أبداً آلية إعادة محاولة حول عقدة نجحت بالفعل بعد إنفاق كبير.

سير عمل للأخطاء ليكون خط الدفاع الأخير. أنشئ سير عمل يبدأ بعقدة Error Trigger، وينشر اسم سير العمل الفاشل والخطأ في Slack، ثم عيّنه في إعدادات كل سير عمل للذكاء الاصطناعي ضمن Error Workflow. حالة الفشل التي يعالجها هذا الإجراء هي الأسوأ: أن يفشل سير عمل يُشغَّل وفق جدول في كل تشغيل، كل ساعة، طوال أسبوع، مع استهلاك الرموز في كل تشغيل قبل توقفه. اربط ذلك بحد إنفاق شهري في Anthropic Console، وتحقق من صفحة الاستخدام في Console خلال الأيام الأولى بعد تفعيل أي سير عمل مجدول. إذا أردت معرفة ما تُحاسَب عليه بدقة، يشرح دليل استخدام الرموز ذلك بالتفصيل.

أوضاع الفشل، مع النصوص التي ستظهر لك

يفشل node فوراً برسالة "Authorization failed - please check your credentials." أعادت API الرمز 401. يحتوي نص الاستجابة الأساسي على البنية التالية، كما تتضمن الاستجابات الحالية أيضاً الحقل request_id:

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

قد يكون السبب مفتاحاً منسوخاً بطريقة غير صحيحة، أو مفتاحاً مبتوراً، أو مسافة بيضاء زائدة في النهاية، أو قيمة نائبة من أحد الدروس التعليمية. أنشئ بيانات اعتماد n8n من جديد والصق المفتاح مرة أخرى. إذا كان يعمل أمس، فتحقق مما إذا كان المفتاح قد أُلغي أو وصل إلى تاريخ انتهاء صلاحيته في Console، أو مما إذا كانت استعادة volume قد أعادت بيانات اعتماد مشفّرة باستخدام N8N_ENCRYPTION_KEY مختلف.

تفشل عمليات التنفيذ على دفعات مع 429 rate_limit_error، وتكون الرسالة شبيهة بـ"Number of request tokens has exceeded your per-minute rate limit." تعمل حدود المعدل ضمن نوافذ مدتها دقيقة واحدة، ويجعل n8n تشغيل خمسين عملية تنفيذ لـwebhook أو RSS في الوقت نفسه أمراً سهلاً جداً. عالج ذلك على مستوى البنية: عالج العناصر بالتسلسل باستخدام Loop Over Items بدلاً من تشغيلها بالتوازي، وفعّل Retry On Fail مع Max Tries بقيمة 3 وWait Between Tries بقيمته القصوى 5000 ms، إذ يفرض n8n حداً أقصى قدره 5000 ms لهذا الحقل. عندما تحتاج إلى تأخير أطول حتى تصل إعادة المحاولة إلى نافذة الدقيقة التالية، ضع node من نوع Wait في مسار الخطأ أو عالج العناصر واحداً تلو الآخر. تحتوي الاستجابة على ترويسة retry-after تخبرك بالمدة الدقيقة التي يجب انتظارها. لا يستطيع الانتظار الثابت في n8n قراءة هذه الترويسة، لذلك أنشئ فترة التوقف الأطول بنفسك. الاستثناء الوحيد هو أن 429 من دون ترويسة retry-after ومع error_code يساوي enforced_spend_limit_reached يعني أن مؤسستك بلغت الحد الأقصى للإنفاق الشهري ضمن فئة الاستخدام الخاصة بها. ولن تنجح أي إعادة محاولة حتى يبدأ الشهر التالي أو تتم ترقية الفئة.

404 not_found_error يذكر اسم model الخاص بك. تذكر الرسالة معرّف model الذي أرسلته، وتكون شبيهة بالآتي:

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

قد تكون النقاط مستخدمة بدلاً من الشرطات، مثل 4.5 بدلاً من 4-5، أو قد تكون لاحقة التاريخ مكتوبة خطأ أو مُختلقة، أو قد يكون model متقاعداً من منشور قديم في مدونة. صحّح المعرّف بالرجوع إلى القائمة الحالية. تحدث هذه المشكلة كثيراً عند كتابة القيمة في حقل model كتعبير بدلاً من اختيارها من القائمة المنسدلة.

يجيب Claude عن سؤال لم تطرحه. لا يظهر أي خطأ، وتكون عملية التشغيل ناجحة. إذا أشار تعبير n8n إلى حقل مفقود، مثل {{ $json.body.text }} بينما استخدمت الحمولة message، فسيُدرج التعبير السلسلة النصية الحرفية undefined في prompt، ثم يجيب Claude عن prompt لا يحتوي على سؤال فعلي. إذا لم يُنفَّذ node المشار إليه إطلاقاً، يتوقف n8n مع خطأ يفيد بأن التعبير يشير إلى node "hasn't been executed yet"، لكن غياب الحقل لا ينتج أي رسالة. قبل التفعيل، شغّل التدفق مرة واحدة دائماً باستخدام بيانات حقيقية واقرأ prompt المعروض فعلياً في لوحة الإدخال الخاصة بـnode. يعرض محرر التعبيرات القيمة بعد حلها، وستجد undefined أمامك إذا تحققت منه.

FAQ

كيف أربط Claude بـ n8n؟

أنشئ مفتاح API في Anthropic Console على platform.claude.com، ثم أضف في n8n بيانات اعتماد من النوع Anthropic والصق المفتاح في حقل API Key. تشير كل عقدة Claude، وعقدة تطبيق Anthropic، والعقدة الفرعية Anthropic Chat Model إلى بيانات الاعتماد المخزنة هذه. يشفّرها n8n باستخدام N8N_ENCRYPTION_KEY، لذلك احتفظ بنسخة احتياطية من ذلك المفتاح، وإلا ستفقد بيانات الاعتماد مع الـvolume.

ما تكلفة تشغيل سير عمل للذكاء الاصطناعي؟

قدّر عدد الرموز المميزة في كل تشغيل، ثم اضربه في أسعار النموذج لكل مليون رمز. اعتباراً من October 2026، يبلغ سعر Haiku 4.5 مقدار $1/$5 لكل مليون رمز مميز للإدخال/الإخراج، ويبلغ سعر Sonnet 5 مقدار $2/$10. تبلغ تكلفة تلخيص webhook باستخدام Haiku نحو ربع سنت، بينما تقترب تكلفة تشغيل agent باستخدام Sonnet مع عدة استدعاءات للأدوات من $0.06–$0.10، لأن كل تكرار يعيد إرسال المحادثة كاملة كرموز مميزة للإدخال. تحقّق من التشغيل في صفحة الاستخدام في Console بدلاً من الاعتماد على التقديرات.

ما نموذج Claude الذي ينبغي أن أستخدمه لأتمتة n8n؟

استخدم Haiku 4.5 للتصنيف والاستخراج والتلخيص والتوجيه، وللمهام ذات الحجم الكبير التي تكون فيها السرعة والسعر هما العاملين الأساسيين. استخدم Sonnet 5 لعقد AI Agent وللاستدلال متعدد الخطوات. استخدم Opus 4.8 فقط عندما تكون تكلفة الإجابة الخاطئة مرتفعة بما يكفي لتبرير سعره المدرج البالغ $5/$25، أي خمسة أضعاف سعر Haiku ومرتين ونصف سعر Sonnet. تؤدي إصدارات Anthropic الأحدث، Haiku 5.5 وSonnet 5.5 وOpus 5.5، الأدوار نفسها بأسعار مدرجة مساوية أو أقل. عيّن النموذج لكل عقدة، وليس لكل سير عمل؛ إذ يمكن لسير عمل واحد استخدام النماذج الثلاثة.

كيف أمنع سير عمل n8n من تجاوز الإنفاق على Claude API؟

طبّق عدة ضوابط: عيّن قيمة منخفضة لـMax Tokens في كل عقدة Claude، وحدد Max Iterations للوكلاء، وعيّن مهلة زمنية لسير العمل، واستخدم إعدادات Retry On Fail متحفظة حتى لا تؤدي حالات الفشل إلى مضاعفة الإنفاق على الرموز المميزة. ثم أضف سير عمل Error Trigger ينبهك في Slack عند فشل أي سير عمل للذكاء الاصطناعي، وحدد حداً شهرياً للإنفاق في Anthropic Console ليكون سقفاً نهائياً لا يمكن لأي شيء على VPS تجاوزه.

هل تكلّف استدعاءات الأدوات من AI Agent رسوماً إضافية؟

لا توجد رسوم منفصلة للأدوات، لكنها ليست مجانية: تُرسل كل نتيجة أداة إلى النموذج مجدداً كرموز مميزة للإدخال، ويعيد كل تكرار للوكيل إرسال المحادثة كاملة حتى تلك اللحظة. قد تتجاوز استجابة API كثيرة التفاصيل وممررة دون تصفية نص المطالبة الفعلي بفارق كبير. فعّل Optimize Response في أدوات HTTP Request، وأعد فقط الحقول التي يحتاج إليها الوكيل.