الفصل الأول: تهيئة البيئة المحلية والتحضير

مرحباً بك في رحلة التحول إلى مطور Claude Code محترف. قبل أن نبدأ في كتابة سطر برمجي واحد، فإن الأساس المتين يبدأ بتهيئة بيئة تطوير محلية سليمة وآمنة. في هذا الفصل، سنقوم بإعداد جميع الأدوات والبرامج الأساسية التي ستكون بمثابة ورشة العمل الرقمية الخاصة بك. سنتأكد من أن كل شيء يعمل بتناغم، من نظام التشغيل وحتى أدوات إدارة الحزم.

1.1 المتطلبات الأساسية: ما الذي تحتاجه قبل البدء؟

لضمان سير العملية بسلاسة، تأكد من أن نظامك يلبي المتطلبات التالية:

نظام التشغيل: نظام تشغيل حديث قائم على Unix. نوصي بشدة بـ:
- macOS 10.15 (Catalina) أو أحدث.
- توزيعة Linux مثل Ubuntu 20.04 LTS أو أحدث، Fedora، أو Debian.
- للمستخدمين على Windows، يجب استخدام Windows Subsystem for Linux (WSL 2). هذا أمر ضروري وليس اختيارياً.
الوصول إلى الطرفية (Terminal): يجب أن تكون مرتاحاً للعمل في سطر الأوامر (CLI).
صلاحيات المدير (Admin/Sudo): ستحتاج إلى صلاحيات لتثبيت البرامج على جهازك.
اتصال إنترنت مستقر: لتنزيل الحزم والبرامج.

⚠️ تحذير هام لمستخدمي Windows:

لا يمكن تشغيل Claude Code أو العديد من أدوات سير العمل الحديثة لتطوير الذكاء الاصطناعي بشكل أصلي على موجه أوامر Windows (CMD أو PowerShell). الحل الوحيد المدعوم هو WSL 2. إذا لم يكن مثبتاً لديك، توجه إلى الوثائق الرسمية من Microsoft لتثبيته قبل المتابعة.

1.2 تثبيت Node.js و npm (أو yarn)

Node.js هو بيئة تشغيل JavaScript خارج المتصفح، وهو العمود الفقري للعديد من أدوات التطوير الحديثة. سنستخدم nvm (Node Version Manager) لتثبيته لأنه يسمح لك بإدارة وإعادة تثبيت إصدارات Node.js بسهولة.

الخطوة 1: تثبيت nvm

افتح طرفيتك (Terminal على macOS/Linux، أو WSL Terminal على Windows) والصق الأمر التالي:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash

هذا الأمر يقوم بتنزيل وتشغيل سكريبت التثبيت الخاص بـ nvm. بعد الانتهاء، أغلق الطرفية الحالية وافتح طرفية جديدة لتفعيل التغييرات على ملفات البيئة (مثل .bashrc أو .zshrc).

الخطوة 2: تثبيت أحدث إصدار LTS من Node.js

في الطرفية الجديدة، قم بتشغيل الأمر التالي لتثبيت الإصدار طويل الأمد (المستقر والمُدعوم):

nvm install --lts

بعد التثبيت، تأكد من استخدام هذا الإصدار افتراضياً:

nvm use --lts

الخطوة 3: التحقق من التثبيت

قم بتشغيل الأوامر التالية للتحقق من أن كل شيء مثبت بشكل صحيح:

node --version
npm --version

يجب أن ترى أرقام إصدار مطبوعة، على سبيل المثال v18.17.1 لـ Node و 9.6.7 لـ npm. هذا يعني أن التثبيت ناجح.

💡 نصيحة احترافية:

استخدم nvm alias default 'lts/*' لجعل أحدث إصدار LTS هو الإصدار الافتراضي لكل طرفية جديدة تفتحها. يوفر هذا بيئة عمل متسقة عبر جميع مشاريعك.

1.3 تثبيت Git وإعداداته الأساسية

Git هو نظام التحكم في الإصدارات الذي لا غنى عنه لأي مطور. سنستخدمه لاستنساخ (clone) المشاريع وإدارة الكود الخاص بـ Claude Code.

التثبيت

على macOS: استخدم Homebrew: brew install git
على Ubuntu/Debian: sudo apt update && sudo apt install git
على Fedora: sudo dnf install git

الإعداد الأولي (ضروري)

بعد التثبيت، قم بتعريف نفسك لـ Git باستخدام الأوامر التالية. هذه المعلومات ستظهر مع كل "commit" تقوم به:

git config --global user.name "اسمك الكامل"
git config --global user.email "بريدك@الإلكتروني.com"

لجعل العمل مع Git أسهل، يمكنك تعيين المحرر النصي المفضل (مثل VSCode) كالمحرر الافتراضي:

git config --global core.editor "code --wait"

📝 ملاحظة:

استخدم نفس البريد الإلكتروني المرتبط بحسابك على GitHub أو GitLab إذا كنت تخطط لرفع الكود لاحقاً. يمكنك التحقق من إعداداتك الحالية في أي وقت باستخدام الأمر git config --list.

1.4 الحصول على مفتاح API من Anthropic

للتواصل مع Claude عبر الكود، تحتاج إلى مفتاح API (واجهة برمجة التطبيقات). يعمل هذا المفتاح ككلمة مرور أو هوية تسمح لبرنامجك بالوصول إلى خدمات Anthropic.

الخطوات العملية:

اذهب إلى Anthropic Console وقم بتسجيل الدخول أو إنشاء حساب جديد.
من لوحة التحكم، ابحث عن قسم "API Keys" أو "مفاتيح API".
انقر على "Create Key" أو "إنشاء مفتاح".
أعطِ المفتاح اسماً وصفيًا، مثل "claude-code-local-dev".
سيتم عرض المفتاح لك مرة واحدة فقط. انسخه واحفظه في مكان آمن فوراً (مستخدم مدير كلمات المرور مثل Bitwarden أو 1Password هو الخيار الأفضل).

⚠️ تحذير أمني شديد:

مفتاح API الخاص بك هو سرّي تماماً مثل كلمة مرور حسابك المصرفي. لا تشاركه أبداً، ولا ترفعه إلى GitHub أو أي نظام تحكم في الإصدارات، ولا تضعه في كودك بشكل صريح. سنتعلم في الفصل التالي كيفية تخزينه بأمان باستخدام متغيرات البيئة.

1.5 التحقق النهائي من البيئة

قبل أن ننتقل إلى الفصل التالي، دعنا نتأكد من أن كل شيء جاهز. قم بتنفيذ الأمر التالي في طرفيتك، والذي سيعطيك ملخصاً سريعاً عن إصدارات البرامج المثبتة:

echo "=== Environment Check ===" &&
node --version && echo "Node.js ✓" &&
npm --version && echo "npm ✓" &&
git --version && echo "Git ✓" &&
echo "======================"

إذا رأيت جميع علامات "✓" دون أخطاء، فتهانينا! لقد نجحت في إعداد بيئة التطوير المحلية الأساسية.

🎯 ما تعلمناه في هذا الفصل:

فهم المتطلبات الأساسية لأنظمة التشغيل المختلفة (مع التركيز على WSL 2 لمستخدمي Windows).
تثبيت وإدارة Node.js و npm باستخدام أداة nvm للحصول على بيئة عمل مستقرة.
تثبيت Git وتكوينه بشكل صحيح للمشاريع التعاونية.
إنشاء وتأمين مفتاح API الخاص بـ Claude من Anthropic Console.
إجراء فحص نهائي للتأكد من صحة الإعدادات.

أنت الآن جاهز تماماً للانتقال إلى الخطوة العملية التالية: إنشاء مشروعك الأول وتكوين الاتصال الآمن مع Claude API.