Claude Code في 2026: الإعداد، أوامر الشرطة المائلة، MCP، والوكلاء الفرعيون

آخر تحديث: June 28, 2026

لقد استخدمت Claude Code كل يوم عمل خلال الشهر الماضي على مستودع Next.js monorepo حقيقي. يتناول هذا المنشور الإعدادات، وأوامر الشرطة المائلة (slash commands)، وملف CLAUDE.md، وMCP، والوكلاء الفرعيين (subagents)، والأذونات (permissions)، والخطافات (hooks) التي أقوم بتشغيلها فعليًا، بالإضافة إلى أوجه القصور فيه.

إجابة سريعة: ما هو Claude Code وهل يستحق العناء؟

Claude Code هو واجهة سطر الأوامر (CLI) البرمجية الوكيلية من Anthropic. يقرأ مستودعك (repo)، ويعدل الملفات، وينفذ أوامر الـ shell، ويسلسل الأدوات حتى تكتمل المهمة. أستخدمه لإصدار الميزات، وإصلاح الأخطاء، ومراجعة الفروقات (diffs) دون مغادرة الطرفية (terminal).

الإعداد الذي ينجح معي هو: تثبيت الـ CLI، وإضافة ملف CLAUDE.md، وتوصيل خادمين أو ثلاثة من MCP، والحفاظ على صلاحيات ضيقة. هذا المزيج يحوله من لعبة دردشة إلى زميل فريق يعرف قاعدة التعليمات البرمجية الخاصة بك.

إنه ليس سحراً. على مستودع (repo) يحتوي على 200k ملف، يهلوس واجهات برمجية (APIs) ويُفسد الاختبارات. تأتي المكافأة عندما تحدد المهام بشكل صغير، وتراجع كل خطة، وتقوم بالالتزام (commit) بشكل متكرر. المزيد حول الحدود الحقيقية في النهاية.

كيف تقوم بإعداد Claude Code؟

قمت بتثبيت المثبّت الأصلي على macOS و Node على Linux. كلاهما مساران رسميّان موثقان في المستودع على github.com/anthropics/claude-code.

## macOS / Linux native installer
curl -fsSL https://claude.ai/install.sh | bash

## or via npm
npm install -g @anthropic-ai/claude-code

## verify
claude --version

بعد ذلك، قمت بتشغيل claude داخل المستودع الخاص بي وسجلت الدخول باستخدام حسابي في Anthropic. عند التشغيل الأول، قام بمسح الشجرة وطلب مني تأكيد الوصول إلى الدليل. أجبت بنعم فقط للجذر الخاص بالمشروع، وليس لمجلد المنزل بالكامل.

بعض قرارات الإعداد التي اتخذتها في وقت مبكر ولم أندم عليها:

• قمت بتثبيت الإصدار في CI ليتطابق مع زملائي.
• أضفت .claude/ إلى .gitignore باستثناء settings.json، والذي قمت بتثبيته (committed).
• كتبت ملف CLAUDE.md قبل أي مطالبة حقيقية، لأن جودة السياق تحدد جودة المخرجات.
• أبقيت على الوضع الافتراضي "الطلب قبل اتخاذ إجراء مدمر" مُفعَّلاً للأسبوع الأول.

المرجع الرسمي للتثبيت والإعداد موجود في docs.claude.com/en/docs/claude-code، والذي أبقيه مفتوحًا أثناء عملية الإعداد.

ما هي أوامر الشرطة التي أستخدمها يوميًا؟

تُعد أوامر الشرطة أسرع طريقة لتوجيه الجلسة. تعلمتها عن طريق تشغيل /help وتقليص القائمة إلى تلك التي ألجأ إليها فعلاً.

أقوم بتشغيل /clear أكثر من أي أمر آخر. عندما تصبح الجلسة مشوشة، فإن صفحة بيضاء نظيفة بالإضافة إلى موجه (prompt) أكثر دقة يحل 80% من المشاكل. أما /compact فهو النسخة الأخف التي أستخدمها عندما أريد الحفاظ على الزخم ولكن السياق أصبح ثقيلاً.

كيف تصمم ملف CLAUDE.md فعالاً؟

ملف CLAUDE.md هو ملف markdown يقرأه Claude في بداية كل جلسة. تعامل معه كوثائق تدريب للموظفين الجدد؛ فهو يشبه الموظف السريع لكن ليس لديه أي ذاكرة بقراراتك.

أقوم بتشغيل /init لتوليد مسودة أولية، ثم أعيد كتابتها يدوياً. النسخة المُولّدة هي نقطة انطلاق، وليست الملف النهائي. يغطي ملف CLAUDE.md الخاص بي المكدس (stack)، والاصطلاحات (conventions)، والتخطيط (layout)، والأوامر (commands)، والثلاثة أخطاء البرمجية التي لا أريد أبداً إعادة إدخالها.

## Project

Next.js 14 App Router, TypeScript strict, Prisma + Postgres, pnpm workspaces.
---

التخطيط

• مسارات التطبيق في app/
• إجراءات الخادم في app/actions
• العناصر الأساسية لواجهة المستخدم في packages/ui

المعايير

• يفضل استخدام async/await بدلاً من سلاسل .then
• لا تستخدم أبدًا any؛ استخدم نوع unknown وقم بتضييقه
• حافظ على أن تكون المكونات أقل من 200 سطر

الأوامر

• Dev: pnpm dev
• Test: pnpm test
• Lint: pnpm lint

فخاخ معروفة

• لا تقم بتحرير prisma/schema.prisma دون تشغيل migrate
• ملف rate-limit.ts مشترك؛ والتغييرات تؤثر على جميع المسارات

خطأان في CLAUDE.md قمت بهما وأصلحتهما. أولاً، كتبت فقرات بدلاً من القوائم، مما أضعف الإشارة. ثانياً، وضعت فيه تاريخ المشروع، مما استهلك رموز (tokens) دون فائدة. اجعله موجزاً، وأمرِياً، ومحدّثاً.

بالنسبة للأنماط الأعمق، يحل كتابي عن مهارات Claude Code إلى أجزاء موجه (prompt) قابلة لإعادة الاستخدام وتتناسب جيداً مع CLAUDE.md.

كيف يعمل كل من MCP والعوامل الفرعية عمليًا؟

MCP (Model Context Protocol) هي الطريقة التي يصل بها Claude Code إلى ما هو خارج مستودعك: قواعد البيانات، والمتصفحات، وGitHub، وLinear. أقوم بتشغيل ثلاثة خوادم MCP وهذا أكثر من كافٍ. المزيد من الخوادم يعني المزيد من الرموز (tokens) والمزيد من طلبات الموافقة.

يقوم إعداد MCP الحالي الخاص بي بعمل حقيقي كل أسبوع:

• خادم GitHub يفتح طلبات السحب (PRs) ويقرأ تعليقات المراجعة.
• خادم Postgres يجيب على سؤال "كم عدد الصفوف المطابقة" دون أن أكتب أي كود SQL.
• خادم Playwright يتحقق من تغييرات واجهة المستخدم (UI) مقابل عنوان URL تجريبي (staging URL).

قمت بتهيئتها في .claude/settings.json وتحققت من كل منها باستخدام مطالبة (prompt) سطر واحد قبل الوثوق بها في مهمة حقيقية. يتم تغطية التكوين واختيار الخوادم بالتفصيل في دليل تكامل MCP لـ Claude Code وفي المقدمة الأوسع لسياق نموذج MCP.

العوامل الفرعية (Subagents) هي المضاعف الآخر. بالنسبة لميزة ذات أجزاء مستقلة، أطلب من Claude إرسال عوامل فرعية متوازية (parallel subagents)، يتم تحديد نطاق كل منها لملف أو وحدة واحدة، وأترك لعامل رائد دمج النتائج. هذا يقلل الوقت الفعلي المستغرق في التغييرات الكبيرة.

تتألق العوامل الفرعية عندما يكون العمل متوازياً حقاً. تفشل عندما تشترك المهام في الحالة (state)، لأن خطوة الدمج تصبح فوضوية. لمعرفة أنماط التوازي التي أثق بها، راجع العوامل الفرعية وأتمتة الفريق لـ Claude Code.

كيف تعمل الأذونات والخطافات؟

تحدد الأذونات ما يمكن لـ Claude فعله دون طلب إذن. أحتفظ بالإعدادات الافتراضية متحفظة وأقوم بتوسيعها لكل مشروع. يظهر مطالبة الموافقة قبل أي شيء مدمر، وهي شبكة الأمان الوحيدة التي لا أقوم بإلغاء تفعيلها أبداً.

الخطافات (Hooks) هي نصوص برمجية يحددها المستخدم وتعمل عند أحداث Claude: قبل أمر ما، بعد التعديل، أو عند بدء الجلسة. أستخدم خطاف post-edit لتشغيل المدقق اللغوي (linter) ومدقق النوع (type-checker) تلقائيًا، بحيث يتلقى Claude تغذية راجعة سريعة دون أن أقوم أنا بتشغيل أي شيء.

أنقذني خطاف الأسبوع الماضي. لقد منع لي الخطاف pre-command أمر rm -rf على مسار خارج المشروع، وقام Claude بالتعديل إلى حذف محدود النطاق (scoped delete). هذا هو بالضبط نوع الحماية الذي يستحق العشر دقائق اللازمة لإعداده.

هل يستحق كود كلود (Claude Code) في عام 2026؟

نعم، للمطورين الذين يعيشون بالفعل في الطرفية (terminal). التكلفة حقيقية، ويتم قياسها بالـ tokens، وتؤتي ثمارها عندما تكون مهامك محددة (scoped) ومستودع الكود الخاص بك موصوف جيدًا بواسطة CLAUDE.md.

لقد استبدل لي ثلاث أدوات: محادثة ذكاء اصطناعي منفصلة، ومساعد بحث عبر سطر الأوامر (CLI)، ومعظم عمليات البحث والقراءة اليدوية باستخدام grep. إن الحلقة الأصلية للطرفية أسرع من التبديل بين علامات التبويب إلى متصفح.

أين لا يزال يتخلف: عمليات إعادة الهيكلة (refactors) الكبيرة الغامضة، والأطر البرمجية الجديدة تمامًا ذات التوثيق الضعيف، وأي شيء يتطلب دقة عبر قاعدة كود كاملة. بالنسبة لتلك الأشياء، أقوم بالتخطيط لها أولاً في نص عادي، ثم أقدم لـ Claude مواصفات واضحة (sharp spec).

هل يجب أن تثق به في كود الإنتاج؟

ليس دون إشراف. أتعامل مع مخرجات Claude Code بالطريقة التي أتعامل بها مع طلب سحب (PR) من مطور مبتدئ قوي: أقوم بقراءة كل اختلاف (diff)، وتشغيل الاختبارات، وعدم الدمج أبداً بناءً على الثقة. الاستقلالية هي مقبض تحكم، وليست مفتاح تشغيل.

التحذير الصادق: سيقوم Claude Code بثقة بإنتاج كود يبدو صحيحاً ولكنه خاطئ بشكل خفي، خاصة فيما يتعلق بمعالجة الأخطاء (error handling) والتنظيف غير المتزامن (async cleanup). راجع مسارات الفشل بنفسك، واحتفظ بإمكانية التراجع السريع (fast rollback)، وستحصل على دفعة كبيرة في الإنتاجية دون الكوارث. تغطي Anthropic docs الإعدادات التي لم أكررها هنا.

أهم النقاط المستخلصة

• قم بتثبيت الـ CLI، ثم استثمر في CLAUDE.md قبل أول موجه (prompt) حقيقي.
• أتقن استخدام /clear و/compact و/permissions؛ أما الباقي فهو اختياري.
• ابدأ بـ اثنين أو ثلاثة خوادم MCP وأضف المزيد فقط عندما يتطلب سير العمل ذلك.
• استخدم الـ subagents للعمل المتوازي والمستقل؛ واحتفظ بمهام الحالة المشتركة (shared-state) بالتسلسل.
• حافظ على قيود الأذونات (permissions) مشددة وأضف خطافات (hooks) لـ lint، وtype-check، وحراس أوامر التدمير (destructive-command guards).
• راجع كل اختلاف (diff) مثل طلب سحب (PR). الاستقلالية بدون مراجعة هي ما يضر بالمشاريع.

مصادر الصور

• شفرة مصدر ملونة تتوهج على شاشة مطور — صورة بواسطة Mikhail Nilov على Pexels
• لقطة مقربة لشفرة برمجة ملونة معروضة على شاشة — صورة بواسطة Pixabay على Pexels
• مُبرمج يرتدي سماعات الرأس ويقوم بالترميز على مكتب مزود بشاشتين مزدوجتين — صورة بواسطة Christina Morillo على Pexels
• مهندس برمجيات يكتب ويراجع الشفرة في مكتب عصري — صورة بواسطة ThisIsEngineering على Pexels