دليل المبتدئين في الذكاء الاصطناعي: ابدأ من هنا

تجمع إضافات Claude Code المهارات والوكلاء الفرعيين والخطافات وإعدادات MCP وامتدادات أخرى للتوزيع. والسوق كتالوج يحدد مصادر جلبها. يشرح المقال الكتالوج الرسمي وكتالوج المجتمع والتسجيل والتثبيت والتفعيل، ثم يتتبع إنشاء مهارة والتحقق من إضافتها وكتالوجها منفصلين وتوزيعهما عبر Git ببنية مجلدات متسقة. ويتناول نطاقات التثبيت وشروط التحديث المرتبطة بالإصدار وحدود ما تضمنه المراجعة الأمنية.

تتشابه الأسماء بين subagents وAgent Teams في Claude Code، لكن دوريهما وأسلوب التنسيق مختلفان جوهريًا. الـ subagents ميزة مدمجة تفوّض مهمة إلى مساعد بسياق جديد وتستعيد ملخّصًا فقط (هرمي، تتداخل افتراضيًا حتى 3 طبقات). أما Agent Teams فتجريبية معطّلة افتراضيًا (تحتاج CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1) وتتنسّق فيها جلسات مستقلة كأقران عبر قائمة مهام مشتركة. يوضّح المقال الفرق الحاسم وأيهما تستخدم وكيف.

Claude Design أداة تصميم من Anthropic Labs تتيح إنشاء واجهات المستخدم والنماذج الأولية والشرائح عبر المحادثة. أضاف تحديث 17 يونيو 2026 استيراد أنظمة التصميم والمزامنة ثنائية الاتجاه مع Claude Code عبر ‎/design-sync، مما قلّص رحلة الذهاب والإياب بين المصممين والمطورين. يشرح المقال ما هي الأداة وما الذي تغيّر واتجاهي ‎/design-sync وشروط الاستخدام ولماذا يُعدّ هذا مهمًّا.

في 18 يونيو 2026، أطلقت Anthropic ميزة Claude Code Artifacts (بيتا) التي تحوّل جلسة برمجة في الطرفية إلى صفحة ويب حيّة يمكن لفريقك مشاركتها. وبدلاً من بثّ git diff والسجلات نصًّا، صار بإمكان Claude Code نشر شرح موضّح لطلب دمج، أو لوحة تحكّم ذاتية التحديث، أو خط زمني لحادثة في صفحة واحدة. يوضّح هذا المقال ما هو Artifacts، وكيف يختلف عن claude.ai Artifacts لعام 2024، وكيفية استخدامه، وقيوده، وشروط توفّره.

تظهر أخطاء المصادقة في Claude Code مثل «Not logged in» و«Invalid API key» و«organization has been disabled» عادةً بصفة 401/403. السبب الحقيقي الأكثر شيوعًا هو أن متغيّر البيئة ANTHROPIC_API_KEY يتجاوز بصمت تسجيل دخول اشتراكك، فيُنتج رسومًا غير متوقعة ورفضًا للدخول. يشرح المقال ترتيب أولوية بيانات الاعتماد، وسير تشخيص من ‎/status إلى unset ثم ‎/logout و/login، وتمييزه عن 429 و529 وحد الاستخدام.

يكون الخطأ «command not found: claude» في معظم الحالات مجرّد أن مجلد التثبيت (~/.local/bin) غير مُدرَج في PATH؛ الملف الثنائي موجود، فيكفي إضافة سطر واحد وإعادة تشغيل الطرفية. يغطي المقال طرق التثبيت ومواقعه، وإصلاح PATH، وتعارض عمليات التثبيت المتعددة، ومزالق Windows، والتحديث. خطأ npm EACCES يُحَلّ بالانتقال إلى المثبّت الأصلي لا بـ sudo، وعند التعثّر شغّل claude doctor.

أخطاء الشبكة/البروكسي في Claude Code (Unable to connect / fetch failed / SSL certificate verification failed) تعني أن الطلب لم يصل إلى خادم Anthropic أصلًا، وليست مصادقة أو تحميلًا زائدًا أو حدّ معدل. الأسباب المعتادة هي البروكسي المؤسسي وفحص TLS والجدار الناري. يشرح المقال ضبط HTTPS_PROXY، والوثوق بشهادة CA المؤسسية عبر NODE_EXTRA_CA_CERTS، والنطاقات الواجب السماح بها، وسير عمل التشخيص. لا تعطّل التحقق أبدًا عبر NODE_TLS_REJECT_UNAUTHORIZED=0.

حين يتوقّف Claude Code فجأة برسالة «API Error: 529 Overloaded» أو «500 Internal server error»، فهذان حدثان عابران من جانب الخادم — وليسا خطأً في طلبك أو إعداداتك، ولا نفادًا لاستخدامك. يشرح هذا المقال معنى 529 (ازدحام واجهة Anthropic API مؤقتًا) و500 (خطأ داخلي غير متوقّع)، وأنهما لا يستهلكان حصتك، وكيف يعيد Claude Code المحاولة تلقائيًا حتى 10 مرات بتراجع أسّي، والحلول من جانب المستخدم (الانتظار، والتبديل بـ/model، ومراجعة status.claude.com، و/feedback مع request_id)، والتمييز بينه وبين 429 وusage limit و400، وإرشادات المطورين، وكيفية تمييز الارتفاع العابر عن العطل المستمر.

رسالة «Claude usage limit reached» ليست خطأً، بل آلية عمل حدود اشتراك Pro / Max. الحدّ من طابقين: نافذة 5 ساعات متدحرجة ونافذة أسبوعية، وفي Max يوجد حدّ أسبوعي منفصل لـ Opus. أكبر مُستهلِك هو اختيار النموذج، يليه حجم السياق والتشغيل الطويل والوكلاء الفرعيون/MCP. يشرح المقال البنية وأسباب الاستهلاك وخمس خطوات لمواصلة العمل فوراً وكيفية رؤية ما تبقّى والفرق عن حدود API.

يظهر خطأ «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). يشرح المقال الآلية والأسباب وإصلاحات المستخدم والمطوّر وتمييزها عن الأخطاء المشابهة والموقف الرسمي.