مختصر كتابي: Set Up Your Machine: Node 26, Git and Claude Code

كيف تجهّز جهازك للعمل مع Claude Code على «سند»؟

استلمت سلمى حاسوب Windows جديدًا، وكريم يعمل على Mac. لصقت سلمى أمر التثبيت الخاص بالـ Mac في PowerShell فظهر خطأ أحمر، ودخل كريم بحساب مجاني فاكتشف أن Claude Code غير موجود في ذلك الاشتراك. الدرس يمشي بك خطوة خطوة لتتجنب الخطأين. وهو للـ Developer والـ Tech Lead والـ QA الذي يكتب اختبارات؛ أما الـ Product Manager والـ Engineering Manager فيكملون من درس Claude Desktop.

تحتاج حسابًا فيه Claude Code: Pro أو Max أو Team أو Enterprise أو Console أو مزوّد سحابي. الخطة المجانية لا تتضمنه. افتح PowerShell على Windows، وTerminal على Mac وLinux. ثم اتبع الترتيب: ثبّت Git وسجّل اسمك وبريدك، وإلا رفض Git الـ Commit. بعدها انسخ المشروع:

git clone https://github.com/almdrasa/sanad-ai-teams.git sanad
cd sanad

ثبّت Node 26 عبر nvm على Mac وLinux أو fnm على Windows؛ وأي نسخة من 24 فما فوق تصلح. ثم ثبّت GitHub CLI وسجّل الدخول بـ gh auth login. بعد ذلك ثبّت Claude Code بالأمر الذي يناسب نظامك، وانتبه إلى شكل الـ Prompt: PS C:\ تعني PowerShell، وبدون PS تعني CMD. وهذا بالضبط خطأ سلمى. تحقق بـ claude --version.

شغّل claude داخل مجلد سند وسجّل الدخول بالحساب الذي فيه Claude Code، ودوّن اسم الـ Model الظاهر. ثم شغّل claude doctor في الـ Terminal العادي، لا داخل Claude Code؛ فهو يفحص التثبيت دون تغيير شيء، ويجب أن ينتهي بجملة تفيد بعدم وجود مشاكل. وإن رغبت فثبّت إضافة Claude Code في VS Code.

• الخطة المجانية على موقع Claude لا تتضمن Claude Code.
• بعد أي تثبيت أغلق الـ Terminal وافتح واحدًا جديدًا.
• استعمل أمر التثبيت المناسب لـ PowerShell أو CMD أو Mac وLinux.
• الأمر claude doctor يُشغَّل خارج جلسة Claude Code.
• انسخ الأرقام والناتج من جهازك أنت لا من الفيديو.

طبّق على جهازك: أكمل الخطوات كلها، وانسخ قالب الدليل إلى evidence/L003.md داخل سند، واملأه من جهازك مع ناتج claude doctor كاملًا والمشاكل التي قابلتك، ثم شغّل npm run check -- L003 حتى تحصل على PASS.

الخلاصة: جهاز جاهز يعني Git وNode وClaude Code بحساب صحيح، ودليلًا من جهازك أنت.