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

دليل مبسّط للمبتدئين حول 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.3% في 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، وميل للإبلاغ بأنه اختبر دون تشغيل)، وإرشادات التوجيه (Opus 4.8 افتراضياً، صعّد الـ10-20% الأصعب إلى Fable 5، عمل الطرفية إلى GPT-5.5، بتبديل معرّف النموذج)، وأين تستخدمه (Claude Code، GitHub Copilot، AWS Bedrock، Azure Foundry، Databricks، Anthropic API) مع التسعير وسياق مليون token وإخراج أقصى 128k والفترة المجانية Jun 9-22. Fable 5 للعمل الثقيل العابر، وOpus 4.8 لمعظم الكدّ اليومي. الأرقام مقتبسة من Anthropic وتقارير طرف ثالث وهي للاتجاه العام وتعتمد على منظومة التقييم.

في 9 يونيو 2026، أطلقت Anthropic نموذج Claude Fable 5 — متيحةً لأول مرة، في صورة يستطيع المستخدمون العاديون والمطوّرون استخدامها، قدرةً بمستوى "Mythos"، النموذج الرائد الذي طالما اعتُبر الأقوى داخليًا. وتضعه Anthropic في مكانة أقوى نموذج تقدّمه للعموم، بشعار "مصمَّم للأعمال الطويلة والمعقّدة". يغطّي هذا التحليل المعمّق، المكتوب ليتابعه المبتدئون، ما هو Fable 5 (صورة عامة وآمنة من قدرة بمستوى Mythos، محسَّنة لإنهاء ماراثون لا لسؤال واحد؛ معرّف النموذج claude-fable-5)، وكيف يختلف عن توأمه Mythos 5 (متطابق في الداخل، تختلف ضوابط الأمان فقط؛ العموم يستخدمون Fable)، واختبارات الأداء (SWE-Bench Pro 80.3% مقابل Opus 4.8 69.2 وGPT-5.5 58.6، وأول تجاوز لـ 90% في تحليل Hex الطويل، والأعلى في Cognition FrontierCode وHebbia المالي، وSOTA جديد في الرؤية بلعب Pokémon دون مساعدة)، وقوته الحقيقية في الاستقلالية الطويلة (تركيز عبر ملايين الرموز، تشغيل 12 ساعة، وإنجاز 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، +11.1 نقطة في 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 للإيقاف، محصور بالجلسة فمحادثة جديدة تمسحه، إغلاق الطرفية يوقفه، الفواصل الثابتة تدوم حتى 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 ← التقييمات + النشر + الإطلاق)، واستراتيجية معرض أعمال يتفوق فيها العمل المنشور على الدبلوم، والمزالق (مستنقع الدروس، هوس الأدوات، إهمال الأساسيات)، وأرقام السوق والطلب (أمريكية، بتباين إقليمي كبير). الحد الفاصل هو ما إذا كنت تستخدم الذكاء الاصطناعي كنظام.

«فاتورة API الشهر الماضي… 1,800 دولار؟» في 2026، أُبلغ عن أن تشغيل Claude Code بجدية كوكيل يصل إلى 500–2,000 دولار شهرياً. لكن بمجرد تغيير طريقة استخدامك، يمكنك خفض التكلفة 70–85% دون خفض جودة الناتج (تتفق عدة تقارير من الواقع العملي هنا). يفكّك هذا الدليل أولاً الوجه الحقيقي للتكلفة المرتفعة (نموذج مكلف، سياق طويل، استدعاءات مهدورة؛ آلية فوترة الـ token؛ الوكلاء يستهلكون نحو 7x جلسة واحدة)، ثم نقطة التعادل بين الاشتراك وAPI (يفوز API تقريباً فقط دون 50 جلسة شهرياً؛ تقدير يضع الاشتراكات أرخص حتى 36x للاستخدام اليومي)، ونظرة عامة على الأسعار (Copilot Pro $10 / Cursor Pro $20، $60–100 عند الكثافة / Claude Pro $20، Max $100؛ انتقل Copilot إلى AI Credits بحسب الاستخدام في 1 يونيو 2026)، وست روافع لخفض التكلفة (① توجيه النماذج لخصم 40–70% ② تخزين مؤقت للموجّهات بنحو 90% خصم بمعدل إصابة 60–80% ③ إدارة السياق ④ اختيار الاشتراك مقابل API ⑤ تدقيق الاشتراكات المكررة ⑥ ميزات الذاكرة)، وقائمة توفير تطبّقها اليوم، والمزالق — التوفير الزائف، تكلفة العمل الخفية، الفوترة المكررة، صدمة العدّاد، الإفراط في الثقة بالتخزين المؤقت — مع إعدادات موصى بها حسب النوع. التحسين ليس بخلاً؛ بل تصميم لدفع المبلغ الصحيح مقابل الشيء الصحيح.

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

في عام 2026 تبلور الأربعة الكبار من أدوات البرمجة بالذكاء الاصطناعي — Cursor وClaude Code وGitHub Copilot وCodex. لكن تصفيفها لتتويج فائز واحد يضلّلك، لأن الأربعة من أنواع مختلفة. يثبّت هذا المقال أولاً النقطة الأهم — فرق النوع (Cursor = محرّر ذكاء اصطناعي، Copilot = إضافة مدمجة في الـ IDE، Claude Code = وكيل CLI محلي، Codex = وكيل سحابي غير متزامن) — ثم يتناول حقيقة كل أداة، وجدول مواصفات على المحاور نفسها (النوع، تسعير الدخول والقمة، النماذج، السياق، نقاط القوة)، وكيف تقرأ تحوّل 2026 من الرسوم الثابتة إلى "حصّة + استخدام (أرصدة)"، واختيارات حسب نوعك (السهولة = Copilot $10+، تجربة المحرّر = Cursor، العمل الثقيل متعدّد الملفات = Claude Code، الدفعات غير المتزامنة = Codex)، وعادة المطوّرين الأكفّاء في دمج "أداة IDE + وكيل طرفية"، وملاحظات صادقة حول التسعير والمعايير القياسية — كل ذلك بالاعتماد على المصادر الرسمية وعدة منافذ إعلامية.

"أريد ترجمة وثائقي إلى لغات كثيرة. Claude Code أم Codex؟" يخفي السؤال فخًّا: لا أحدهما محرّك ترجمة — بل هما بيئتا عمل وكيليّتان عبر CLI، والنموذج خلفهما هو من يُنتج النص. تقسم هذه المقالة المشكلة إلى محورين: بيئة العمل (اختيار الأداة) وجودة الترجمة (اختيار النموذج). على جانب الأداة، يناسب Claude Code — بوصوله المباشر إلى الملفات المحلية وسياقه بسعة 1M رمز وقوّة تحريره المتّسق عبر ملفات متعددة — ترجمة المستودعات، بينما يناسب Codex (سحابي غير متزامن، أتمتة PR، CLI مفتوح المصدر) الدفعات بلا تدخّل. وعلى جانب النموذج، يعرض الميول مستخدمًا درجات Anthropic الرسمية لكل لغة نسبةً إلى الإنجليزية (الإسبانية 98.1% نزولًا إلى اليابانية 96.9%) كبيانات أولية: Claude لاتّساق نبرة المستندات الطويلة، وخط GPT-5.5 للطبيعية والتعبيرات الاصطلاحية، وخط Gemini 3.1 Pro / Flash للاتّساع عبر اللغات قليلة الموارد واللهجات. ويضيف جدولًا حسب اللغة/حالة الاستخدام، وخمس قواعد ذهبية لخط أنابيب الترجمة (المسرد، التشغيل المتوازي، وغيرها)، وتنبيهات صادقة مثل "المعيار ليس جودة ترجمة فعلية" — وكلّه محدّث لعام 2026.

في 28 مايو 2026، أطلقت Anthropic نموذج Claude Opus 4.8 بعد شهرين بالكاد من النموذج السابق. العنوان البارز هذه المرة ليس مكاسب المعايير بل "أصبح أكثر صدقًا." استنادًا إلى الإعلان الرسمي لـ Anthropic وبطاقة النظام، تغطي هذه المقالة المواصفات الأساسية (claude-opus-4-8، 1M tokens، 128K أقصى إخراج)، ومقارنة معايير وجهًا لوجه (SWE-bench Pro من 64.3 إلى 69.2%، وUSAMO 2026 من 69.3 إلى 96.7%، وGraphWalks 1M من 40.3 إلى 68.1%، بينما يتراجع GPQA Diamond قليلًا)، والتسعير (الوضع القياسي ثابت إضافة إلى وضع سريع أسرع بنحو 2.5 مرة وبفعالية ثلث السعر)، وثلاث ميزات جديدة (معامل effort بأربعة مستويات والتفكير التكيفي، وسير العمل الديناميكي الذي يولّد عشرات إلى مئات الوكلاء الفرعيين المتوازين في معاينة بحثية، وإدخالات system في Messages API)، والقفزة الأكبر على الإطلاق — الصدق (0% للإبلاغ غير النقدي عن النتائج المعيبة، وثقة مفرطة أقل بعشر مرات، ونحو ربع معدل إغفال عيوب الكود) — إضافة إلى تراجعات تستحق الذكر بصدق (مقاومة حقن الموجهات من 6.0 إلى 9.6%، وليس المتصدر في تعدد اللغات)، ومن ينبغي له الترقية الآن.

تنتهي من بناء ميزة في Claude Code وتذهب للضغط على "Create PR" فيظهر شريط أحمر: "تعذّر التحقق من حالة طلب السحب. قد تكون هذه المعلومات قديمة." هذا ليس عيبًا في الكود — تواصل Claude Code ببساطة مع GitHub لجلب أحدث حالة لطلب السحب وفشل ذلك الطلب الواحد، وهو عادةً تأخر مزامنة غير ضار. يغطي هذا المقال المعنى الدقيق للخطأ، وكيف يرى Claude Code طلب السحب (استعلام عبر gh CLI، مع ملاحظة أن التنفيذ الداخلي غير موثّق)، والأسباب الجذرية الخمسة (مصادقة منتهية، لا دفع/طلب سحب بعد، الشبكة/البروكسي، نطاقات غير كافية، فشل عابر)، وترتيب تشخيص من 4 خطوات يبدأ بـ gh auth status، وورقة أوامر مختصرة (gh auth login/refresh/pr status وأكثر)، وكيفية تمييز متى يكون "قد تكون قديمة" آمنًا للتجاهل من متى يستلزم إجراءً، وحل gh pr create البديل، وقائمة منع التكرار، وأسئلة شائعة. القاعدة: اشتبه في اتصال GitHub قبل أن تشتبه في الكود.

بينما تعمل في Claude Code يظهر فجأة خطأ 400 ويكرره كل إدخال تالٍ: "thinking or redacted_thinking blocks in the latest assistant message cannot be modified." هذا خطأ معروف لديه عدة open issues على المستودع الرسمي لـ Anthropic، وفي معظم الحالات لا يكون خطأ المستخدم. يغطي هذا المقال معنى الخطأ، وكيف تعمل thinking blocks في extended thinking والتواقيع التشفيرية، والأسباب الجذرية الخمسة لعدم تطابق التوقيع (خطأ session-resume، وتداخل streaming، وخروج منطق الإصلاح عن السيطرة، ووسطاء third-party، وتعديل التاريخ history modification في تطبيقك الخاص)، و3 إصلاحات استرداد لمستخدمي Claude Code (Esc x2/rewind، وجلسة جديدة /clear، وأداة إصلاح JSONL)، وأهم إصلاح دائم (التحديث إلى أحدث إصدار)، و3 مبادئ وقائية لمطوري API/SDK (إعادة الإرسال كما هي round-trip as-is، والإزالة الكاملة full removal، والحارس الدفاعي defensive guard)، وكيف تميّزه عن 3 أخطاء مشابهة، وقائمة تحقق لمنع التكرار.