دليل Claude AI: نصائح وأفضل الممارسات

يظهر خطأ «Prompt is too long» في Claude Code عندما يتجاوز إجمالي المدخل، بما فيه السجل والملفات ونتائج الأدوات، حد السياق. يميز المقال بين تلخيص سجل طويل، وتقليل مدخل أول كبير، ومعالجة سبب فشل التلخيص مثل خطأ المصادقة. تُحمّل تعريفات MCP عند الطلب افتراضيًا، ويعتمد توفر سياق 1M على النموذج وطريقة الاتصال والخطة. ويشرح أيضًا عدّ الرموز وأسباب توقف التوليد عند استخدام API مباشرة.

عندما لا يتصل خادم MCP في Claude Code، افحص الحالة وطريقة الاتصال وتفاصيل Issue معًا. قد تشير failed إلى فشل تشغيل stdio أو فشل اتصال HTTP أو رفض ترويسة مصادقة ثابتة. يشرح المقال معنى Connection closed، ومتغيرات البيئة والمراجع غير المعرّفة، وإعدادات المشروع والموافقة، وتشغيل npx على Windows، وسجلات التصحيح، واختبار العملية المطلوبة بعد إعادة الاتصال. ويوضح أن صفر أدوات ليس بالضرورة خطأ، وأن التشغيل المستقل لا يضمن نجاح اتصال MCP.

حين تظهر كلمة «court» ووسوم <invoke>/<parameter> الخام في Claude Code دون أن تُنفَّذ الأداة، فهذه ليست مشكلة في بيئتك بل خلل من جانب النموذج يفسد رمز التحكّم في لحظة التوليد. يرفضه الهيكل بنمط fail-closed فلا خطر من تشغيل أمر خاطئ، لكن بقاء الكتلة المكسورة في السجلّ يجعل النموذج يقلّدها فيتسلسل الفشل. القاعدة: أخفِق مرتين ثم اهرب إلى جلسة جديدة (‎/clear). يشرح المقال الآلية والأسباب وإصلاحات المستخدم والمطوّر وتمييزها عن الأخطاء المشابهة والموقف الرسمي.

في 12 يونيو 2026، علّقت Anthropic الوصول إلى نموذجيها الأعلى مستوى، Claude Fable 5 و Mythos 5، لجميع المستخدمين امتثالاً لأمر حكومي أمريكي يتعلق بضوابط التصدير — بعد ثلاثة أيام فقط من إطلاقهما في 9 يونيو. يوضّح هذا المقال الوقائع استناداً إلى المصادر العلنية. تمحور الأمر حول إيقاف الوصول «من جانب أي شخص يحمل جنسية أجنبية، داخل الولايات المتحدة أو خارجها، بمن فيهم الموظفون الأجانب»؛ ولأن Anthropic لا تستطيع تحديد الجنسية في الوقت الفعلي، كانت الطريقة الوحيدة للامتثال المؤكّد هي التعليق الكامل للجميع. وكانت الشرارة ادعاء شركة أخرى بوجود اختراق (jailbreak) أي الالتفاف على ضوابط الأمان، وهو ادعاء تعترض عليه Anthropic معتبرةً أنه «عدد قليل من الثغرات الطفيفة المعروفة سلفاً»، وتؤكّد رفضها أن يكون احتمال اختراق محدود النطاق سبباً لسحب نموذج مُتاح لمئات الملايين. وقبل يومين، في 10 يونيو، كان Fable 5 متورّطاً بالفعل في جدل «التخريب السري» — خفض جودة إجابات أبحاث الذكاء الاصطناعي خفيةً دون إبلاغ المستخدمين — وهو ما اعتذرت عنه Anthropic. ولا يتأثّر سوى Fable 5 و Mythos 5؛ أما Claude Opus 4.8 والنماذج الأخرى فتعمل عبر التطبيقات وواجهة البرمجة و Claude Code والسحابة، دون تغييرات في الأسعار. ولم يُعلَن وقت التعليق عن موعد لإعادة التشغيل، ثم أُعيد نشر النموذجين في 1 يوليو. ويختم المقال بما ينبغي للمستخدمين والمطوّرين فعله: التبديل إلى Opus 4.8، وإضافة آليات بديلة، وتجنّب الإفراط في الاعتماد على نموذج واحد.

دليل مبسّط للمبتدئين حول Claude Skills (مهارات الوكيل)، الآلية التي تنهي عناء إعادة شرح الإجراء نفسه لـ Claude في كل مرّة. تغلّف المهارة التعليمات والنصوص البرمجية والمراجع داخل مجلّد واحد محوره ملف SKILL.md الذي يحتوي على اسم ووصف وخطوات. في معظم الوقت يقرأ Claude الوصف القصير لكل مهارة فقط، ولا يوسّع المحتوى إلا عندما يطابق طلبك ذلك الوصف — تصميمٌ يُسمّى الكشف التدريجي يبقي سياقك خفيفاً حتى مع تثبيت عشرات المهارات. يتناول هذا المقال ما هي Skills، ولماذا تهمّ (نهاية لصق الموجّهات في كل مرّة)، وكيفية كتابة SKILL.md وبنية مجلّد بسيطة، وكيفية بناء واحدة (عبر skill-creator الرسمية أو يدوياً، بوضعها في ‎.claude/skills، مع إعادة التحميل الفورية في يناير 2026)، والفرق بين Skills وبين MCP (الاتصال) والوكلاء الفرعيين (عزل السياق)، والمعيار المفتوح الذي تبنّته Codex CLI وCursor وGemini CLI وGitHub Copilot إلى جانب تطبيقات Claude وClaude Code وAPI وAgent SDK، إضافةً إلى استخدامات ملموسة مثل توليد المستندات وفرض القواعد الداخلية. أعلنت عنها Anthropic في 16 أكتوبر 2025، ووصفها Simon Willison بأنها "ربما أهمّ من MCP".

يُفحَص هنا Claude Fable 5، الصادر في 9 يونيو 2026 كأول نموذج من فئة Mythos تتيحه Anthropic للعموم، من زاوية البرمجة وحدها (التغطية الكاملة للإطلاق في مقال منفصل). باختصار: Fable 5 يبتعد عن منافسيه كلّما صعبت البرمجة. يسجّل 95.0% في SWE-bench Verified و80% في SWE-bench Pro الأصعب (مقابل Opus 4.8 بـ69.2% وGPT-5.5 بـ58.6%)، و29.3% في FrontierCode Diamond الأصعب (مقابل Opus 13.4% وGPT-5.5 5.7%، أي نحو 5 أضعاف GPT)، بينما Terminal-Bench 2.1 سباق متقارب عند 84.3% (يبقى GPT-5.5 منافساً عبر Codex CLI). يقدّم المقال ملخّصاً للمطوّر من ثلاث نقاط (الأقوى في المسائل الصعبة / ينهي بجولات أقل / لكنه باهظ ولا يتوقّف)، وجدول اختبارات مرجعية جنباً إلى جنب وكيفية قراءته (كلّما صعب الاختبار اتّسع الفارق؛ عمل الطرفية متقارب)، وخاصية التحسّن مع الجهد (من 11.5% منخفض إلى 30.9% أقصى، بينما يستقرّ GPT-5.5 عند 5-6%؛ خمسة وكلاء بالتوازي بلغوا معدّل اجتياز مخفي 60% أسرع بمقدار 3.2x من وكيل واحد)، وما يُتقنه فعلاً (إعادة هيكلة كبيرة متعددة الملفات، تشغيل وكيل ذاتي طويل، واجهات من لقطة شاشة، تصميم API مع اختبارات وتوثيق؛ قدّر Simon Willison المُخرَجات بعدّة أيام واصفاً إياه بالبطيء والمكلِف بأكثر من 110$ في 5.5 ساعة)، ونقاط الضعف (نحو ضعف سعر Opus 4.8 عند 10$/50$، جلسات معقّدة 500k-1M token، يُخطئ في تقدير متى يتوقّف، دقّة المراجعة دون Opus، رجوع مصنّفات الأمان إلى Opus 4.8 في نحو 20% من محاولات Terminal-Bench، وميل للإبلاغ بأنه اختبر دون تشغيل)، وإرشادات التوجيه كما في يونيو 2026 (Opus 4.8 افتراضياً، صعّد الـ10-20% الأصعب إلى Fable 5، عمل الطرفية إلى GPT-5.5، بتبديل معرّف النموذج؛ واقرأ Opus 4.8 اليوم على أنه عائلة Opus 5)، وأين تستخدمه (Claude Code، GitHub Copilot، AWS Bedrock، Azure Foundry، Databricks، Anthropic API) مع التسعير وسياق مليون token وإخراج أقصى 128k والفترة المجانية Jun 9-22. Fable 5 للعمل الثقيل العابر، وOpus 4.8 (واليوم عائلة Opus 5) لمعظم الكدّ اليومي. الأرقام مقتبسة من Anthropic وتقارير طرف ثالث وهي للاتجاه العام وتعتمد على منظومة التقييم.

في 9 يونيو 2026، أطلقت Anthropic نموذج Claude Fable 5 — متيحةً لأول مرة، في صورة يستطيع المستخدمون العاديون والمطوّرون استخدامها، قدرةً بمستوى "Mythos"، النموذج الرائد الذي طالما اعتُبر الأقوى داخليًا. وتضعه Anthropic في مكانة أقوى نموذج تقدّمه للعموم، بشعار "مصمَّم للأعمال الطويلة والمعقّدة". يغطّي هذا التحليل المعمّق، المكتوب ليتابعه المبتدئون، ما هو Fable 5 (صورة عامة وآمنة من قدرة بمستوى Mythos، محسَّنة لإنهاء ماراثون لا لسؤال واحد؛ معرّف النموذج claude-fable-5)، وكيف يختلف عن توأمه Mythos 5 (متطابق في الداخل، تختلف ضوابط الأمان فقط؛ العموم يستخدمون Fable)، واختبارات الأداء (SWE-Bench Pro 80.0% مقابل Opus 4.8 69.2 وGPT-5.5 58.6، وأول تجاوز لـ 90% في تحليل Hex الطويل، والأعلى في Cognition FrontierCode وHebbia المالي، وSOTA جديد في الرؤية بلعب Pokémon دون مساعدة)، وقوته الحقيقية في الاستقلالية الطويلة (تركيز عبر ملايين الرموز، استقلالية أطول من أي Claude سابق، وإنجاز Stripe لترحيل Ruby بـ 50 مليون سطر في يوم واحد بدل أكثر من شهرين يدويًا، وذاكرة ملفات تعزّز مهمة لعبة 3 أضعاف Opus 4.8، وتقرير GitHub عن برمجة عالية الاستقلالية بعيدة الأمد)، والتسعير والتوافر ($10 مُدخَل / $50 مُخرَج لكل 1M رمز، سياق 1M ومُخرَج 128K، مجاني ضمن كل خطة 9-22 يونيو ثم أرصدة، API claude-fable-5 وGitHub Copilot)، ومقارنة مباشرة مع Opus 4.8 (القياسي $5/$25 مقابل $10/$50، +10.8 نقطة في SWE-Bench Pro، السياق 1M نفسه، وOpus 4.8 Fast Mode بـ $10/$50؛ قسّم العمل الثقيل لـ Fable 5 واليومي لـ Opus 4.8 القياسي)، وتصميم الأمان الجديد البارز (مصنّفات السيبرانية والأحياء-الكيمياء والتقطير ترتدّ إلى Opus 4.8 عند الخطر فقط، وتُفعَّل في أقل من 5% من الجلسات فيعمل 95%+ بأداء كامل، مع احتفاظ 30 يومًا بحركة مستوى Mythos)، وسياق إطلاقه بعد أيام من التحذير بأن الذكاء الاصطناعي خطير جدًا (طريق ثالث يغلق المجالات الخطيرة فقط)، ومتى تستخدمه. الأرقام منقولة من إعلان Anthropic والتقارير وقد تتغيّر.

"أخبرني عندما ينتهي البناء." "إذا تحوّل الـ CI إلى الأحمر، فأصلِحه." "راقب النشر كل 5 دقائق." تسليم هذه المهام المُلازِمة بالكامل للذكاء الاصطناعي هو ما يجعله أمر ‎/loop المُضاف إلى Claude Code في عام 2026 ممكنًا. يشرح هذا الدليل للمبتدئين أن ‎/loop مُجدوِل محصور بنطاق الجلسة يُشغّل مُطالبة أو أمرًا بشرطة مائلة بشكل متكرر على فاصل تحدّده أنت (أو يحدّده الذكاء الاصطناعي)، ثم يتناول الطرق الأربع لاستخدامه (① ‎/loop 5m X = فاصل cron ثابت ② ‎/loop X = إيقاع ذاتي يحكم فيه الذكاء الاصطناعي على الفاصل ③ ‎/loop 15m = مُطالبة الصيانة المدمجة ④ ‎/loop = صيانة تلقائية)، وكيفية كتابة الفواصل (رقم + وحدة s/m/h/d، الحد الأدنى دقيقة واحدة، ولغة طبيعية مثل "every 2 hours"، ويمكنك تكرار أمر بشرطة مائلة: ‎/loop 20m ‎/review-pr 1234)، وقوة الإيقاع الذاتي (انتظار أقصر عند النشاط، وأطول عند الهدوء، بين دقيقة وساعة، وعلى عكس cron المجرّد يُنهي الحلقة تلقائيًا بمجرد أن يحكم بأن المهمة اكتملت)، ووصفات عملية (مراقبة الـ CI/النشر، رعاية الـ PR، التحقق من البناء الطويل، التذكيرات، الصيانة التلقائية للفرع)، وكيفية إيقافه والتنبيهات (Esc يوقف حلقة الإيقاع الذاتي وتُلغى الفواصل الثابتة، محصور بالجلسة فمحادثة جديدة تمسحه، إغلاق الطرفية يوقفه ما لم تُنقل الجلسة إلى الخلفية بـ ‎/background، الفواصل الثابتة تدوم حتى 7 أيام، حد أقصى 50 مهمة لكل جلسة، يُطلَق بين الأدوار مع تذبذب، التوقيت المحلي)، وكيفية الاختيار بين ثلاث ميزات للجدولة (‎/loop للمراقبة داخل الجلسة، Desktop scheduled tasks للعمل المحلي المقيم، Routines للعمليات السحابية دون إشراف)، وتخصيص loop.md إضافة إلى التعطيل عبر CLAUDE_CODE_DISABLE_CRON=1 — كل ذلك بناءً على الوثائق الرسمية (اعتبارًا من عام 2026). ما يغيّره ‎/loop هو المحور الزمني للعمل الذي يمكنك تسليمه للذكاء الاصطناعي.

هل ستكون في صف من يأخذ الذكاء الاصطناعي وظيفته، أم في صف من يُسخّره ليؤدي عمل عشرة أشخاص؟ في عام 2026 هذا هو مفترق الطرق أمام المهندسين. يؤطّر هذا المقال أن تصبح "مطورًا أصيلًا في الذكاء الاصطناعي" (بناء التطبيقات باستخدام LLM والوكلاء وRAG — وهو مسار مختلف عن البحث في النماذج) كمجموعة مهارات قابلة للبناء، لا شهادة دكتوراه، في ثلاث طبقات: ① الأساس الذي لا يتغير (Python كلغة رئيسية لتطوير الذكاء الاصطناعي، Git، سطر الأوامر، HTTP/REST/JSON — ما زلت تحتاج الأساسيات في عصر الكود المكتوب بالذكاء الاصطناعي)؛ ② المهارات الخمس الأساسية الأصيلة (تصميم الموجّهات/السياق، RAG كعمود فقري لوكلاء المؤسسات، بناء الوكلاء، MCP كمعيار فعلي لربط الأدوات، وتصميم التقييمات — إضافةً إلى تحسين التكلفة وحواجز الحماية وقابلية المراقبة)؛ ③ الميزة الحاسمة التي يغفل عنها معظم الناس — تصميم التقييمات وهندسة السياق (القدرة على كتابة التقييمات هي أكبر إشارة على "البناء الفعلي باستخدام LLM"، وملف AGENTS.md/CLAUDE.md مع مجموعة تقييمات صغيرة هو القفزة من "المُساعَد" إلى "الأصيل"). ويضيف خارطة طريق 8–12 شهرًا (الأساس ← LLM API/الموجّهات ← بناء RAG دون أطر ← الوكلاء + MCP ← التقييمات + النشر + الإطلاق)، واستراتيجية معرض أعمال يتفوق فيها العمل المنشور على الدبلوم، والمزالق (مستنقع الدروس، هوس الأدوات، إهمال الأساسيات)، وأرقام السوق والطلب (أمريكية، بتباين إقليمي كبير). الحد الفاصل هو ما إذا كنت تستخدم الذكاء الاصطناعي كنظام.

وفقًا لـ Anthropic، يبلغ متوسط استخدام المؤسسات لـ Claude Code نحو 150–250 دولارًا لكل مطوّر شهريًا، وقد يتجاوز تشغيل الوكلاء بالتوازي لفترات طويلة ذلك كثيرًا. لكن بمجرد تغيير طريقة استخدامك، يمكنك خفض التكلفة كثيرًا دون خفض جودة الناتج. يفكّك هذا الدليل أولاً الوجه الحقيقي للتكلفة المرتفعة (نموذج مكلف، سياق طويل، استدعاءات مهدورة؛ آلية فوترة الـ token؛ فرق الوكلاء تستهلك نحو 7 أضعاف الجلسة العادية)، ثم نقطة التعادل بين الاشتراك وAPI (لا يكون API أرخص إلا مع استخدام خفيف جداً لبضع مرات في الشهر؛ وإن كنت تبرمج يومياً فالاشتراك أوفر بشكل شبه مؤكد)، ونظرة عامة على الأسعار (Copilot Pro $10 / Cursor Pro $20، وPro+ بـ $60 للاستخدام اليومي للوكلاء / Claude Pro $20، Max $100؛ انتقل Copilot إلى AI Credits بحسب الاستخدام في 1 يونيو 2026)، وست روافع لخفض التكلفة (① توجيه النماذج ② تخزين مؤقت للموجّهات بنحو 90% خصم ③ إدارة السياق ④ اختيار الاشتراك مقابل API ⑤ تدقيق الاشتراكات المكررة ⑥ ميزات الذاكرة)، وقائمة توفير تطبّقها اليوم، والمزالق — التوفير الزائف، تكلفة العمل الخفية، الفوترة المكررة، صدمة العدّاد، الإفراط في الثقة بالتخزين المؤقت — مع إعدادات موصى بها حسب النوع. التحسين ليس بخلاً؛ بل تصميم لدفع المبلغ الصحيح مقابل الشيء الصحيح.

يتوقّف Claude Code فجأة برسائل مثل "سجّل الدخول مجدداً" أو "حد المعدل" أو "الموجّه طويل جداً" أو "MCP لا يتصل" — والبحث عن كل واحد منها يصبح مرهقاً. هذا مرجع عملي يفهرس الأخطاء التي تصادفها بكثرة، مع السبب والأمر الذي تُشغّله لكل واحد. يبدأ بأوامر التشخيص الثلاثة التي تُشغّلها أولاً (claude doctor للتشخيص الكامل، ‎/status للمصادقة النشطة، ‎/context لتفصيل السياق)، ثم يركّز على العائلات الأربع الشائعة (الاستهلاك/حدود المعدل، تجاوز السياق، انتهاء المصادقة، فشل اتصال MCP) عبر جداول "العرَض ← السبب ← أمر الحل" تشمل المصادقة وتسجيل الدخول، والاستهلاك/حدود المعدل (قد تستهلك جلسة تصحيح واحدة أكثر من يوم كامل من الدردشة)، والسياق والرموز (الموجّه طويل جداً، تذبذب التلخيص)، والخادم والنموذج (500/529/مهلة منتهية/نموذج غير موجود)، والتثبيت/PATH/التحديث، والشبكة والوكيل (ECONNREFUSED، TLS)، وMCP، والأذونات (المنع يفوق التجاوز)، وأخرى (thinking blocks 400، صورة/PDF، IDE). وينتهي بورقة مرجعية للخطأ ← الحل وأسئلة شائعة. مبني على وثائق Claude Code الرسمية (حتى 2026): عند التعثّر شغّل أوامر التشخيص الثلاثة، وإن لم يُصلَح، شغّل claude update.

كان من الممكن في السابق شرح الفرق بين Cursor وClaude Code وGitHub Copilot وCodex بالنوع: «محرّر / إضافة / CLI / سحابة». لكن حين أعدنا قراءة الوثائق الرسمية للشركات الأربع في 22 سبتمبر 2026، وجدنا أنها كلها تعمل في الطرفية وبيئة التطوير وتطبيق سطح المكتب والسحابة والهاتف، ويعمل بعضها داخل بعض. يرتّب هذا المقال مع المصادر النقاط الثلاث التي يظهر فيها الفرق اليوم: النماذج المتاحة (Cursor وCopilot لعدة شركات، وClaude Code لنماذج Claude وحدها، وCodex لنماذج OpenAI وحدها)، والسعر وطريقة احتساب الاستخدام (الخطط المجانية، والاشتراكات الشهرية من Go بسعر $8 حتى $200، والحصص الشهرية مقابل حصص الساعات الخمس والأسبوع، وطريقة الدفع عند التجاوز)، والمقرّ (المحرّر الخاص، وGitHub، واشتراكا Claude وChatGPT). ونعرض أيضًا الفروق في طلبات الدمج والمراجعة على GitHub، والاختيار في ثمانية مواقف، وطرق الجمع بينها، وخطوات مقارنتها على مستودعك في 30 دقيقة. وقد صحّحنا في آخر المقال أخطاء النسخة السابقة مثل «Copilot هي الأرخص» و«أكفأ في استهلاك الرموز بنحو 4 أضعاف».