تخطي إلى المحتوى
المواضيع

تطوير AI والبرمجة

طوّر بذكاء مع الذكاء الاصطناعي. أدلة لتوليد الأكواد وبناء التطبيقات والتصحيح والأتمتة.

63 مقالات

رتّب المقالات للعثور على ما تحتاجه

ما هو embedding (التضمين / المتجه)؟ كيف يصير المعنى أرقامًا، واستخداماته، واختيار النموذج

ما هو embedding (التضمين / المتجه)؟ كيف يصير المعنى أرقامًا، واستخداماته، واختيار النموذج

يعتمد RAG والبحث الدلالي والتوصيات جميعًا على بطل خفي: embedding (التضمين / المتجه). embedding هو معنى النص (أو الصورة) مُحوَّلًا إلى سلسلة من الأرقام — أي متجه. تصبح كلمة «كلب» قائمة من مئات إلى آلاف الأرقام تعمل بوصفها «إحداثيات للمعنى»، فتقع الكلمات المتقاربة في المعنى قرب بعضها (كلب وجرو متقاربان؛ كلب وسيارة متباعدان)، ويُقاس القرب بمقاييس مثل cosine similarity. مثال شهير: «ملك − رجل + امرأة ≈ ملكة». ولذلك يمكن للآلة أن تحكم على قرب المعنى حتى عندما لا تتطابق الحروف. يغطي هذا الدليل للمبتدئين ما هو embedding («خريطة للمعنى»)، ولماذا يقيس القرب المعنى (الأبعاد وcosine similarity)، وفيمَ يُستخدم (RAG والبحث الدلالي والتصنيف وإزالة التكرار والتوصيات والوسائط المتعددة)، وكيف تختار نموذج embedding (نوع API مثل OpenAI text-embedding-3 وCohere وGemini وVoyage؛ ونوع مفتوح المصدر مثل BGE-M3 وNomic وQwen3؛ إضافةً إلى Matryoshka التي يمكنها تقليص 3,072 بُعدًا إلى 1,024 مع الحفاظ على نحو 95% من الجودة بثلث التكلفة تقريبًا)، وقواعد بيانات المتجهات (Pinecone وWeaviate وQdrant وChroma وpgvector) مع بداية من ثلاث خطوات (اختر نموذجًا، حوّل الوثائق إلى متجهات وخزّنها، حوّل السؤال إلى متجه وابحث). التضمينات هي أساس تنفيذ RAG.

ما هي تقييمات الذكاء الاصطناعي (وLLM-as-judge)؟ كيف تعمل، والتحيّزات، والأدوات — دليل المبتدئين

ما هي تقييمات الذكاء الاصطناعي (وLLM-as-judge)؟ كيف تعمل، والتحيّزات، والأدوات — دليل المبتدئين

صقلت مطالباتك، وأضفت معرفة عبر RAG، وربما أجريت الضبط الدقيق — فكيف تتأكد أنه تحسّن فعلًا؟ هنا تتصدّر تقييمات الذكاء الاصطناعي المشهد، وبحلول 2026 صار التقييم جوهريًا إلى حدّ تسميته "بنية تحتية". تعني تقييمات الذكاء الاصطناعي قياس جودة مخرجات LLM بشكل منهجي (الدقة، الهلوسات، الالتزام بالصيغة، النبرة) على مقياس ثابت بدل الإحساس؛ وبدونها يبقى التحسين مجرد حدس. هناك طريقتان: التقييم القائم على الكود للعناصر القابلة للقياس آليًا (المطابقة التامة، الصيغة، الكلمات المطلوبة أو المحظورة — سريع ورخيص ومستقر)، وLLM-as-judge للعناصر الذاتية (استخدام نموذج LLM قوي بوصفه حَكَمًا لمنح درجات للمخرجات، عبر المقارنة الزوجية أو تسجيل مخرج واحد). والمبدأ: قِس بالكود كل ما يستطيع الكود قياسه. لـ LLM-as-judge تحيّزات الإطناب والموضع وتفضيل الذات؛ وحلولها استخدام عائلة نماذج مختلفة كمُقيّم، وتبديل الترتيب والتقييم مرتين، ووضع الإيجاز في معيار التصحيح، والمعايرة مقابل الحكم البشري. المقاييس الخشنة (pass/fail أو 1–3) تتفوّق على الدقيقة 1–10. وفي الممارسة، شغّل ثلاث طبقات — فحوصات كود فورية عند كل تغيير، واختبارات تراجع ليلية بـ LLM-as-judge، ومراقبة إنتاج مستمرة — مستخدمًا أدوات مثل DeepEval وPromptfoo وRAGAS لـ CI إضافةً إلى Braintrust وLangSmith وArize للمراقبة. ابدأ بجمع 10 مخرجات جيدة و10 سيئة وتقييمها.

ما هو الضبط الدقيق (fine-tuning)؟ الضبط الدقيق مقابل RAG، وLoRA/QLoRA، ومتى تستخدمه — دليل المبتدئين

ما هو الضبط الدقيق (fine-tuning)؟ الضبط الدقيق مقابل RAG، وLoRA/QLoRA، ومتى تستخدمه — دليل المبتدئين

عندما تريد تخصيص الذكاء الاصطناعي ليناسب شركتك، يكون الضبط الدقيق (fine-tuning) أحد الخيارات — لكن الخوض فيه باستهتار مُكلِف وسهل الخطأ. يشرح هذا الدليل للمبتدئين الضبط الدقيق: أخذ نموذج أساسي مُدرَّب بالفعل، وتدريبه أكثر على بيانات مُصمَّمة لاستخدامك، وإعادة تشكيله ليصبح نموذجًا متخصصًا يطبع «السلوك» (أسلوب الشركة، صيغة الإخراج، صياغة المجال) داخل النموذج نفسه عبر إعادة كتابة أوزانه. الضبط الدقيق بارع في تغيير السلوك لكنه ضعيف في حفظ المعرفة المُحدَّثة، لذا فالقاعدة هي «الحقائق والمعرفة ← RAG، والشخصية والقالب ← الضبط الدقيق، والبرومبت أولًا». وكما يشير الخبراء، فإن نحو 80% مما يُقال إنه «يحتاج الضبط الدقيق» يُحَلّ باسترجاع أفضل (RAG) أو ببرومبت، فالترتيب مهم. يغطي المقال ما هو الضبط الدقيق (مع تشبيه تدريب الموظفين الجدد)، وفيمَ يبرع وفيمَ يضعف، وجدول مقارنة بين الضبط الدقيق وRAG والبرومبت، والأساليب الرئيسية (الضبط الدقيق الكامل، وLoRA، وQLoRA — التكميم بـ 4-bit الخفيف بما يكفي للمبتدئين)، وما تحتاجه (500+ مثال عالي الجودة كدليل، مع كون بناء البيانات هو العمل الحقيقي؛ تكاليف من $5,000 إلى أكثر من $50,000، والضبط الدقيق من OpenAI بنحو $25–$100 لكل مليون رمز تدريبي؛ وأدوات مثل OpenAI وUnsloth وAxolotl وHugging Face)، والترتيب الذي تبدأ به. الضبط الدقيق هو الملاذ الأخير.

ما هو التطوير المدفوع بالمواصفات (Spec-Driven Development / SDD)؟ الخطوات الأربع والأدوات والفرق عن vibe coding

ما هو التطوير المدفوع بالمواصفات (Spec-Driven Development / SDD)؟ الخطوات الأربع والأدوات والفرق عن vibe coding

في عصرٍ تكتب فيه الذكاء الاصطناعية الشيفرة، تنتقل المهارة الأعلى قيمة من «كتابة الشيفرة» إلى «كتابة المواصفات» — والممارسة التي تجسّد هذا التحوّل هي التطوير المدفوع بالمواصفات (Spec-Driven Development، SDD). يضع SDD المواصفات في قلب المشروع بوصفها مصدر الحقيقة، فيشتقّ منها وكيل الذكاء الاصطناعي التصميم والتقسيم والتنفيذ بدلًا من كتابة الشيفرة فورًا. والأساس أنّ كل خطوة تترك وثيقة (غالبًا Markdown) تقرؤها الخطوة التالية. يشرح هذا الدليل المبسّط للمبتدئين ما هو SDD (المواصفات هي المعيار، والشيفرة مشتقّ منها)، ولماذا صار مهمًّا الآن (إذ يمنع «جدار الأشهر الثلاثة» من الدَّيْن التقني وانجراف المتطلبات في vibe coding عند مرحلة التصميم — وتفيد GitHub بانخفاض دورات «إعادة التوليد من الصفر» بمقدار رتبة عشرية تقريبًا)، والخطوات الأربع الأساسية (Specify → Plan → Tasks → Implement)، والأدوات الرئيسية (GitHub Spec Kit بأكثر من 90,000 نجمة ودعم أكثر من 30 وكيلًا، و AWS Kiro بتدفّق Requirements → Design → Tasks وموجّه Auto، إضافةً إلى BMAD و OpenSpec و Tessl و Google Antigravity و Cursor)، ومتى تستخدمه مقابل vibe coding (مزجٌ: vibe للاستكشاف، والمدفوع بالمواصفات للإطلاق، مع مراجعة بشرية إلزامية)، وكيف تجربه اليوم. ففي عصر الذكاء الاصطناعي، لا يصعد مَن يكتب الشيفرة الأسرع، بل مَن يستطيع تحديد ما سيُبنى بدقّة.

ما هي هندسة السياق؟ المهارة التالية بعد الـ prompt، وكيف تتغلّب على «context rot»

ما هي هندسة السياق؟ المهارة التالية بعد الـ prompt، وكيف تتغلّب على «context rot»

يتحوّل مركز الثقل في العمل مع الذكاء الاصطناعي من هندسة الـ prompt إلى هندسة السياق. وباستعارة تعريف Anthropic، هندسة السياق هي «مجموعة الاستراتيجيات الخاصة بانتقاء وصيانة المجموعة المثلى من الرموز (tokens) (أي المعلومات) التي تسلّمها للنموذج أثناء الاستدلال» — وهي لا تشمل الـ prompt وحده، بل كلّ ما يدخل نافذة السياق: الـ system prompt، والأدوات، وسجلّ المحادثة، والبيانات الخارجية. وتهمّ بسبب «context rot»: كلّما أضفتَ مزيدًا من الـ tokens، تراجعت الدقّة فعليًا. فقد اختبرت دراسة Chroma لعام 2025 ثمانية عشر نموذجًا رائدًا (GPT وClaude وGemini وغيرها)، وتدهور كلّ واحد منها كلّما طال المدخل، مع كون المعلومات في منتصف السياقات الطويلة سهلة الإغفال على وجه الخصوص («lost in the middle»). يغطّي هذا الدليل المبسّط للمبتدئين ما هي هندسة السياق وعلاقتها بهندسة الـ prompt، ولماذا يحدث الـ context rot (الانتباه ميزانية محدودة)، وماذا يوجد فعليًا داخل السياق، وستّ تقنيات أساسية (تعليمات على المستوى الصحيح، وانتقاء الأدوات، والاسترجاع عند الطلب، والضغط بالتلخيص، وملاحظات الذاكرة الخارجية، والعزل عبر الوكلاء الفرعيين)، وعلاقتها بالـ RAG وبـ Claude Skills، وعادات يمكنك استخدامها اليوم مثل بدء جلسة جديدة حين يتغيّر الموضوع ولصق النقاط الأساسية فقط. والفكرة الجوهرية: أبقِ على أصغر قدر من الـ tokens الأعلى قيمةً فقط.

Claude Fable 5 للبرمجة: الاختبارات المرجعية، ومتى تستخدمه مقابل Opus 4.8، وحقيقة التكلفة

Claude Fable 5 للبرمجة: الاختبارات المرجعية، ومتى تستخدمه مقابل Opus 4.8، وحقيقة التكلفة

يُفحَص هنا 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 وتقارير طرف ثالث وهي للاتجاه العام وتعتمد على منظومة التقييم.

ما هو أمر /loop في Claude Code؟ الاستخدام والاستطلاع والجدولة مقارَنة

ما هو أمر /loop في Claude Code؟ الاستخدام والاستطلاع والجدولة مقارَنة

"أخبرني عندما ينتهي البناء." "إذا تحوّل الـ 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 ← التقييمات + النشر + الإطلاق)، واستراتيجية معرض أعمال يتفوق فيها العمل المنشور على الدبلوم، والمزالق (مستنقع الدروس، هوس الأدوات، إهمال الأساسيات)، وأرقام السوق والطلب (أمريكية، بتباين إقليمي كبير). الحد الفاصل هو ما إذا كنت تستخدم الذكاء الاصطناعي كنظام.

الدليل الكامل لتحسين تكلفة البرمجة بالذكاء الاصطناعي: اخفض فاتورتك 70–85%

الدليل الكامل لتحسين تكلفة البرمجة بالذكاء الاصطناعي: اخفض فاتورتك 70–85%

«فاتورة 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 ⑤ تدقيق الاشتراكات المكررة ⑥ ميزات الذاكرة)، وقائمة توفير تطبّقها اليوم، والمزالق — التوفير الزائف، تكلفة العمل الخفية، الفوترة المكررة، صدمة العدّاد، الإفراط في الثقة بالتخزين المؤقت — مع إعدادات موصى بها حسب النوع. التحسين ليس بخلاً؛ بل تصميم لدفع المبلغ الصحيح مقابل الشيء الصحيح.

دليل تنفيذ قاعدة البيانات المتجهية / RAG — من RAG الساذج إلى الإنتاج

دليل تنفيذ قاعدة البيانات المتجهية / RAG — من RAG الساذج إلى الإنتاج

تعرف "ما هو RAG"، لكن عند البناء تخرج الإجابة مختلّة — لأنه ما يزال RAG الساذج: تقطيع باستهتار وبحث متجهي بسيط. وبوصفه متابعة التنفيذ للمقال 030، يشرح هذا المقال خط أنابيب RAG العملي في 2026 (تقطيع ذكي، embedding، قاعدة بيانات متجهية، بحث هجين، إعادة ترتيب) مرحلة مرحلة: استراتيجيات التقطيع (recursive 512 افتراضياً، semantic/structural/parent-child، وContextual Retrieval الذي يُبلَغ أنه يخفّض فشل الاسترجاع حتى 67%)، واختيار نموذج embedding (text-embedding-3-large وغيره)، ومقارنة ست قواعد بيانات متجهية (Chroma للنماذج الأولية، pgvector مع Postgres، Qdrant منخفض الزمن، Pinecone المُدارة بالكامل، Weaviate بطلة الهجين، Milvus للنطاق الضخم)، وبحث هجين يدمج BM25 + متجهات كثيفة عبر RRF، وretrieve-then-rerank بـ bi-encoder ثم cross-encoder (Cohere/Voyage/BGE/Jina)، وتقسيم LlamaIndex (الاسترجاع) مقابل LangChain/LangGraph (التحكّم)، ولماذا لا تستبدل نافذة 1M توكن الـ RAG (lost in the middle، التشتيت)، وملاحظات الإنتاج مثل بناء مجموعة تقييم أولاً.

كيف تبني وكيلًا ذكيًا — دليل المبتدئين (بلا كود وبالبرمجة)

كيف تبني وكيلًا ذكيًا — دليل المبتدئين (بلا كود وبالبرمجة)

تعرف «ما هو الوكيل الذكي» — فكيف تبني واحدًا؟ في 2026 يتيح نهج بلا كود تشغيل وكيل عامل في غضون فترة بعد الظهر عبر السحب والإفلات، وتتيح حِزم SDK الحديثة تجميع وكيل عملي في أقل من 100 سطر. بوصفه الرفيق العملي لمقال «ما هو الوكيل الذكي»، يغطّي هذا المقال البنية (الدماغ LLM + التعليمات + الأدوات + الذاكرة + الحلقة المستقلة)، والمسارين (بلا كود مقابل البرمجة)، وإطار البناء الشامل المكوّن من 5 خطوات (حدّد نطاق المشكلة، اختر قاعدتك، اكتب التعليمات، اربط الأدوات، اختبر على نطاق صغير)، ومقارنة أدوات بلا كود (Dify لمنصة متكاملة، n8n للتكامل مع الأعمال، Flowise للنماذج الأولية، والأسهل Custom GPT/Gemini Gems/Claude Projects)، ومقارنة أطر العمل البرمجية (Claude Agent SDK/OpenAI Agents SDK المتينة، LangGraph للتحكّم المعقّد، CrewAI لتنسيق الأدوار)، ومثالًا عمليًا محددًا (تلخيص رسائل الدعم ثم الإشعار عبر Slack)، وإرشادات التكلفة (نحو $10-$50/شهر للمنصة بالإضافة إلى استهلاك النموذج) والجدول الزمني، والمزالق (لا توسّع النطاق أكثر من اللازم، الصلاحيات والتحكّم بالانفلات، احذر من إثبات المفهوم فقط). بالنسبة لمعظم الناس، البناء بلا كود أولًا هو الخطوة الصحيحة.

أخطاء Claude Code الشائعة وحلولها — المرجع الكامل

أخطاء Claude Code الشائعة وحلولها — المرجع الكامل

يتوقّف 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.