ملاحظة: يحتوي هذا الدليل على روابط لصفحات Anthropic الرسمية. وإن أضفتُ يوماً روابط تابعة (affiliate) أو مموَّلة إلى مقال، فإنني أوضّحها بجلاء وأُعلّمها على أنها مموَّلة — ولا يوجد أيٌّ منها في هذا المقال.
Claude Code أداة برمجة وكيلة (agentic) من Anthropic تعمل داخل الطرفية لديك. فبدلاً من نسخ الأكواد ولصقها ذهاباً وإياباً من نافذة المحادثة، تقرأ مشروعك، وتعدّل الملفات، وتنفّذ الأوامر، وتدير git — كل ذلك عبر تعليمات بلغة طبيعية. أستخدمها يومياً في مشاريع الويب والجوال، وفيما يلي خطوات الإعداد التي أنصح بها لأي مطوّر يبدأ من الصفر.
ما الذي تحتاجه أولاً
- طرفية (Terminal على macOS، أو أي صدفة على Linux، أو PowerShell/WSL على ويندوز).
- اتصال بالإنترنت — إذ تتواصل Claude Code مع نماذج Anthropic عبر الشبكة.
- اشتراك مدفوع في Claude (خطة Pro أو Max) أو رصيد API بنظام الدفع حسب الاستخدام. التثبيت مجاني، لكن الاستخدام ليس كذلك — فالخطة المجانية لا تتضمّن Claude Code. اطّلع على الخطط الحالية في صفحة الأسعار الرسمية.
لا يحتاج المثبّت الأصلي الموصى به إلى Node.js إطلاقاً. ولن تحتاج إلى Node (الإصدار 18 أو أحدث) إلا إذا اخترت طريقة npm.
الطريقة الأولى: المثبّت الأصلي (موصى به)
هذه هي الطريقة التي تختبرها وتدعمها Anthropic. تثبّت ملفاً تنفيذياً مستقلاً ويُحدّث نفسه تلقائياً في الخلفية.
أنظمة macOS أو Linux أو WSL
curl -fsSL https://claude.ai/install.sh | bashويندوز (PowerShell)
irm https://claude.ai/install.ps1 | iexعلى ويندوز يمكنك تشغيل المثبّت الأصلي مباشرةً، أو العمل داخل WSL 2 إن أردت أدوات يونكس الكاملة (موصى به إذا كانت مشاريعك تستخدم سكربتات bash أو ملف Makefile).
تفضّل Homebrew؟ (macOS / Linux)
brew install --cask claude-codeبعد التثبيت، افتح نافذة طرفية جديدة كي تلتقط الصدفة تحديث مسار PATH.
الطريقة الثانية: npm (إن كان Node جزءاً من سير عملك)
إن كنت تعمل بـ Node وتفضّل إدارة Claude Code مع بقية حزمك العامة، فثبّتها عبر npm. وتتطلّب هذه الطريقة Node.js الإصدار 18 أو أحدث.
npm install -g @anthropic-ai/claude-codeلا تستخدم sudo. فتشغيل التثبيت بصلاحيات الجذر يسبّب مشكلات أذونات تُفسد كل تثبيت عام لاحق. وإذا واجهت خطأ EACCES، فصحّح أذونات npm أو استخدم nvm (الذي يثبّت Node داخل مجلد المنزل) بدلاً من اللجوء إلى sudo.
التحقّق من التثبيت
claude --versionإن ظهر رقم إصدار، فأنت جاهز. وللفحص الأعمق — نوع التثبيت وحالة الدخول والمسار والإعدادات — شغّل:
claude doctorالتشغيل الأول وتسجيل الدخول
انتقل إلى مجلد المشروع وشغّلها:
cd your-project
claudeعند التشغيل الأول، يُفتح المتصفّح لتسجيل الدخول بحساب Anthropic (أو اشتراك Pro/Max). وبعد المصادقة، ستدخل جلسة تفاعلية داخل مشروعك.
جرّب مهمتك الأولى
ابدأ بمهمة صغيرة على مشروع حقيقي لترى ما تفعله قبل أن تُسند إليها شيئاً كبيراً. مثلاً، اكتب طلباً بلغة بسيطة:
Explain what this project does and list the main files.ثم اطلب منها كتابة دالة، أو إصلاح اختبار فاشل، أو صياغة رسالة commit. إنها تعمل مع شيفرتك لا في فراغ — وهنا يكمن الفرق عن نافذة المحادثة.
مشكلات الإعداد الشائعة
- «command not found» بعد التثبيت: افتح نافذة طرفية جديدة كي يُحدَّث PATH ثم أعد المحاولة.
- أخطاء أذونات npm (
EACCES): لا تستخدم sudo — اضبط بادئة npm على مجلد يملكه المستخدم أو استخدم nvm. - شعور بوجود خلل: شغّل
claude doctor؛ فهو يشخّص معظم مشكلات الدخول والمسار والإعدادات ويقترح حلولاً.
التالي في هذه السلسلة: الأوامر وسير العمل الذي أستخدمه فعلياً داخل جلسة Claude Code، وكيفية ربطها بأدواتك عبر MCP.