كيفية تثبيت Claude Code: دليل macOS و Windows و Linux

ملخص: يُثبَّت Claude Code بوصفه حزمة npm في أقل من 5 دقائق على Mac أو Windows أو Linux. تحتاج إلى Node.js 18 أو أحدث ووصول نشط إلى FreeClaude. يتناول هذا الدليل التثبيت على كل منصة، والإعداد بعد التثبيت، وأول جلسة لك، والأوامر الأساسية، واستكشاف الأخطاء الشائعة وإصلاحها.

ما هو Claude Code؟

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

هذا يعني أن Claude Code يستطيع:

• قراءة بنية مشروعك كاملةً وفهمها قبل إجراء أي تغييرات
• إنشاء الملفات وتعديلها وحذفها مباشرةً على جهازك
• تشغيل مجموعة الاختبارات لديك ورصد الإخفاقات وإصلاحها تلقائياً
• تنفيذ أوامر git وأدوات البناء وأي أمر صدفة
• إجراء تغييرات منسقة عبر عشرات الملفات في جلسة واحدة
• إنشاء التزامات برسائل ذات معنى تشرح المنطق الكامن وراء التغييرات

بالنسبة للمطورين المحترفين، يُحوّل هذا الذكاءَ الاصطناعي من مساعد للنسخ واللصق إلى شريك تطوير حقيقي ومستقل. الميزات التي قد تستغرق بعد الظهر يمكن تطبيقها في 20 دقيقة من خلال جلسات Claude Code الوكيلة.

المتطلبات الأساسية

قبل تثبيت Claude Code، تأكد من توافر ما يلي:

إذا لم يكن لديك وصول نشط إلى FreeClaude بعد، زر freeclaude.io وأكمل أول إحالة لفتح التنزيلات. نظام الإحالة هو الطريقة الوحيدة للوصول إلى Claude Code عبر FreeClaude.

التثبيت على macOS

الخطوة 1: تثبيت Node.js (إذا لزم الأمر)

افتح الطرفية (اضغط Cmd + Space، اكتب "Terminal"، اضغط Enter). تحقق من تثبيت Node.js مسبقاً:

node --version

إذا ظهر إصدار أقل من 18.x أو "command not found"، ثبّت Node.js باستخدام fnm (مدير الإصدارات السريع) — الأسلوب الموصى به:

curl -fsSL https://fnm.vercel.app/install | bash

أغلق الطرفية وأعد فتحها، ثم شغّل:

fnm install --lts

للتحقق: يجب أن يُظهر node --version الآن 20.x أو أعلى.

الخطوة 2: تثبيت Claude Code

مع جاهزية Node.js، ثبّت Claude Code عالمياً عبر npm:

npm install -g @anthropic-ai/claude-code

بدلاً من ذلك، يمكنك تنزيل ملف ثنائي مُجمَّع مسبقاً مباشرةً من تبويب التنزيلات في لوحة تحكم FreeClaude. لا يتطلب الأسلوب الثنائي Node.js لكنه يوفر مرونة أقل في التحديثات.

الخطوة 3: المصادقة

شغّل claude في طرفيتك. عند الإطلاق الأول، سيُطالبك بالمصادقة ببيانات اعتماد FreeClaude. اتبع التعليمات الظاهرة على الشاشة — عادةً تُفتح نافذة متصفح للمصادقة عبر OAuth أو تلصق رمزاً من لوحة التحكم.

Apple Silicon (M1/M2/M3/M4) مقابل Intel

يعمل أسلوب التثبيت عبر npm بصورة متطابقة على كلا البنيتين — يكتشف npm المعالج لديك ويثبّت الملف الثنائي الصحيح تلقائياً. يوفر أسلوب الملف الثنائي المُجمَّع مسبقاً تنزيلات منفصلة لـ Apple Silicon و Intel؛ وتُقدّم لوحة التحكم الإصدار الصحيح تلقائياً استناداً إلى اكتشاف جهازك.

التثبيت على Windows

الخطوة 1: تثبيت Node.js

افتح PowerShell كمسؤول (انقر بزر الفأرة الأيمن على زر ابدأ واختر "Windows PowerShell (Admin)").

تحقق من Node.js: node --version

إذا لم يكن مُثبَّتاً، استخدم winget (مُدمَج في Windows 10/11):

winget install -e --id OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements

أغلق PowerShell تماماً وأعد فتحه كمسؤول. للتحقق: node --version

الخطوة 2: تثبيت Claude Code

npm install -g @anthropic-ai/claude-code

إذا واجهت خطأ سياسة تنفيذ PowerShell، شغّل هذا أولاً:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

الخطوة 3: توصية Windows Terminal

لأفضل تجربة مع Claude Code على Windows، استخدم Windows Terminal (متاح مجاناً من متجر Microsoft) مع PowerShell 7. يعمل موجّه الأوامر الكلاسيكي لكن لديه قيود في عرض تنسيق مخرجات Claude Code الغنية. يعمل WSL (نظام Windows الفرعي لـ Linux) أيضاً بشكل جيد إذا كنت تفضّل بيئة تطوير شبيهة بـ Linux على Windows.

التثبيت على Linux

يُعدّ تثبيت Linux عادةً الأكثر مباشرةً إذ تمتلك معظم أجهزة التطوير Node.js وطرفية قادرة مسبقاً.

Ubuntu/Debian

تحقق من إصدار Node.js: node --version

إذا كان أقل من 18 أو مفقوداً، ثبّت عبر NodeSource:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

ثم ثبّت Claude Code: sudo npm install -g @anthropic-ai/claude-code

Fedora/RHEL/CentOS

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo dnf install -y nodejs
sudo npm install -g @anthropic-ai/claude-code

Arch Linux

sudo pacman -S nodejs npm
sudo npm install -g @anthropic-ai/claude-code

أي توزيعة Linux (عبر fnm)

curl -fsSL https://fnm.vercel.app/install | bash
أعد تشغيل صدفتك، ثم:
fnm install --lts
npm install -g @anthropic-ai/claude-code

الإعداد بعد التثبيت

بعد التثبيت، أكمل هذه الخطوات قبل أول جلسة برمجة:

1. افتح نافذة طرفية جديدة — هذا أمر ضروري. إدخالات PATH الجديدة التي أضافها تثبيت npm تصبح فعّالة فقط في جلسات طرفية جديدة.
2. تحقق من التثبيت — اكتب claude --version وتأكد من ظهور رقم إصدار.
3. شغّل المصادقة الأولية — اكتب claude واتبع مطالبات المصادقة. هذا يربط Claude Code بحساب FreeClaude الخاص بك.
4. اضبط git (إذا لم يكن مضبوطاً) — ينشئ Claude Code التزامات بالنيابة عنك. تأكد من أن git يعرف هويتك: git config --global user.name "اسمك" وgit config --global user.email "بريدك@example.com"

أول جلسة مع Claude Code

انتقل إلى مشروع تعمل عليه وابدأ Claude Code:

cd ~/my-project
claude

يُطلق Claude Code ويعرض تفاصيل حسابك وحالة وصولك. لأول جلسة، جرّب هذه المطالبات التمهيدية:

• "اقرأ هذا المشروع وأعطني ملخصاً للبنية والمكوّنات الرئيسية وأي مشاكل فورية تلاحظها"
• "أرني تغطية الاختبار وحدد المناطق التي لا تحتوي على اختبارات"
• "ابحث عن أي تعليقات TODO أو عبارات console.log متبقية في الكود"
• "ما الاعتماديات القديمة وأي التحديثات ستكون آمنة التطبيق؟"

تمنح هذه المطالبات Claude Code فرصة التعرف على مشروعك قبل طلب إجراء تغييرات — مما يُنتج عموماً نتائج أفضل من القفز مباشرةً إلى تعديلات الكود.

مرجع الأوامر الأساسية

الإعداد والتخصيص

يقرأ Claude Code ملف CLAUDE.md من جذر مشروعك إذا وُجد. يعمل هذا الملف كمجموعة تعليمات مستمرة يحمّلها Claude Code في بداية كل جلسة في ذلك المشروع. يمكنك استخدامه لتحديد:

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

شغّل /init في أي مشروع لجعل Claude Code ينشئ تلقائياً ملف CLAUDE.md أولياً استناداً إلى تحليله لقاعدة الكود لديك. راجعه وصقّله قبل الالتزام.

استكشاف الأخطاء وإصلاحها

"command not found: claude"

أغلق الطرفية وأعد فتحها. إذا استمرت المشكلة، تحقق من أن مجلد bin العالمي لـ npm موجود في PATH:

npm config get prefix

أضف مسار المخرجات مع إضافة /bin إلى ملف تعريف صدفتك (~/.zshrc أو ~/.bashrc أو ما يعادله).

"Authentication failed" أو "Unauthorized"

تحقق من لوحة تحكم FreeClaude للتأكد من نشاط مؤقت الوصول لديك. إذا انتهى مؤقتك، اطلب من صديق آخر تمديده. إذا كان المؤقت نشطاً لكن المصادقة لا تزال تفشل، جرّب تشغيل claude logout متبوعاً بـ claude login لإعادة المصادقة.

ردود بطيئة أو انتهاء المهل الزمنية

يتطلب Claude Code اتصالاً بالإنترنت مستقراً للتواصل مع خوادم Anthropic. تحقق من جودة اتصالك. إذا كنت على شبكة WiFi، جرّب اتصالاً سلكياً لجلسات Claude Code الممتدة لتجنب انقطاع الاتصال في منتصف العملية.

أخطاء الأذونات عند التثبيت على Mac/Linux

تجنب استخدام sudo npm install -g إذ قد يُسبّب مشاكل في الأذونات. بدلاً من ذلك، اضبط npm لاستخدام مجلد قابل للكتابة من قِبل المستخدم:

mkdir ~/.npm-global
npm config set prefix ~/.npm-global
ثم أضف export PATH=~/.npm-global/bin:$PATH إلى ملف تعريف صدفتك.

Claude Code أجرى تغييراً لم أرده

ينشئ Claude Code التزامات git بصورة تدريجية. شغّل git log لرؤية الالتزامات الأخيرة وgit revert HEAD للتراجع عن الالتزام الأخير. في الجلسات الأكبر، ينشئ Claude Code التزامات عند نقاط تفتيش منطقية مما يُيسّر التراجع إلى أي حالة سابقة.

الأسئلة الشائعة

هل يعمل Claude Code دون اتصال بالإنترنت؟

لا. يُرسل Claude Code سياق كودك إلى خوادم Anthropic لمعالجة الذكاء الاصطناعي. يُستلزم اتصال إنترنت مستقر طوال جميع الجلسات.

هل يُرسَل كودي إلى Anthropic حين أستخدم Claude Code؟

نعم. محتوى الملفات التي يقرأها Claude Code يُرسَل إلى واجهة برمجة تطبيقات Anthropic للمعالجة. تنطبق سياسة خصوصية Anthropic. لا تستخدم Claude Code على ملفات تحتوي على أسرار أو بيانات اعتماد أو معلومات خاصة بالغة الحساسية دون مراجعة سياسات التعامل مع البيانات لدى Anthropic لحالة استخدامك.

هل يمكن استخدام Claude Code داخل حاوية Docker؟

نعم، مع الصور القياسية لـ Node.js في Docker. ثبّت claude-code عبر npm داخل الحاوية وارفع مجلد مشروعك كوحدة تخزين.

ما إصدار Node.js الذي يتطلبه Claude Code؟

يُشترط Node.js 18.0 أو أعلى. يُوصى بـ Node.js 20 LTS أو Node.js 22 LTS للحصول على أفضل تجربة.

كيف أُحدّث Claude Code؟

شغّل npm update -g @anthropic-ai/claude-code للتحديث إلى أحدث إصدار. يمكنك أيضاً تشغيل npm install -g @anthropic-ai/claude-code@latest لفرض تثبيت إصدار محدد.

هل يمكن استخدام Claude Code في خطوط أنابيب CI/CD؟

صُمّم Claude Code للاستخدام التفاعلي من قِبل المطورين. لحالات الاستخدام الآلية في CI/CD، تكون واجهة برمجة تطبيقات Anthropic أكثر ملاءمةً. ومع ذلك، تكتب بعض الفرق جلسات Claude Code غير التفاعلية لمهام مراجعة محددة في خطوط أنابيب CI.

هل تحتاج مساعدة؟

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

الإعداد المتقدم لسير العمل الاحترافي

بمجرد تثبيت Claude Code وتشغيله، تُحسّن خيارات الإعداد هذه بصورة ملحوظة التجربة لسير عمل التطوير الاحترافي:

إنشاء ملف CLAUDE.md عالمي

إضافةً إلى ملفات CLAUDE.md على مستوى المشروع، يمكنك إنشاء إعداد Claude Code عالمي في ~/.claude/CLAUDE.md. يُحمَّل هذا الملف لكل جلسة Claude Code بصرف النظر عن المشروع، وهو مثالي للتفضيلات الشخصية التي تنطبق على نطاق عالمي:

• أسلوب تعليق الكود المفضّل
• تفضيلات لغة البرمجة الافتراضية
• الاصطلاحات الشخصية لصيغة رسائل الالتزام
• تذكير بالأدوات التي تريد دائماً من Claude استخدامها (كتشغيل الاختبارات قبل الالتزام)
• أي سياق شخصي حول إعداد بيئة التطوير لديك

ضبط اختيار النموذج

يمكن ضبط Claude Code للتعيين الافتراضي لنموذج محدد باستخدام علامة --model أو بتعيينه في الإعداد:

• claude --model claude-opus-4-7 — استخدم Opus لأقصى قدرة
• claude --model claude-sonnet-4-6 — استخدم Sonnet للردود الأسرع (موصى به لمعظم الجلسات)
• claude --model claude-haiku-4-5 — استخدم Haiku للمهام الخفيفة السريعة

يمكنك أيضاً التبديل بين النماذج في منتصف الجلسة بأمر /model دون فقدان سياق المحادثة.

اختصارات الصدفة للإطلاق السريع

أضف هذه الاختصارات إلى ملف تعريف صدفتك (~/.zshrc أو ~/.bashrc) لاستدعاء Claude Code بصورة أسرع:

• alias cc="claude" — إطلاق سريع
• alias cc-fast="claude --model claude-sonnet-4-6" — الوضع السريع مع Sonnet
• alias cc-deep="claude --model claude-opus-4-7" — التحليل العميق مع Opus
• alias cc-review="claude --print /review" — مراجعة كود غير تفاعلية

تكامل سير عمل Git

يتكامل Claude Code بعمق مع سير عمل git. فيما يلي الأنماط التي يعتمدها المستخدمون المتمرسون:

سير عمل فرع الميزات

ابدأ دائماً جلسة Claude Code للعمل المهم بإنشاء فرع جديد:

1. أنشئ الفرع: git checkout -b feature/my-feature
2. ابدأ Claude Code: claude
3. صف الميزة ودع Claude Code يطبّقها
4. راجع الفارق: git diff main
5. ادمج حين تكون راضياً: git checkout main && git merge feature/my-feature

يمنحك سير العمل هذا تحكماً كاملاً فيما يُدمَج في فرعك الرئيسي مع السماح لـ Claude Code بالعمل بحرية في بيئة فرع الميزة.

استخدام Claude Code لمراجعة الكود

شغّل claude على أي فرع واستخدم أمر /review للحصول على مراجعة شاملة لجميع التغييرات غير الملتزمة. هذا ذو قيمة خاصة بوصفه فحصاً قبل الالتزام لرصد المشكلات قبل دفعها إلى مستودعك.

المساعدة في إعادة القاعدة التفاعلية

اطلب من Claude Code المساعدة في تنظيف تواريخ الالتزامات الفوضوية: "لديّ 12 التزاماً على هذا الفرع من الاستكشاف والأخطاء. من فضلك اضغطها إلى 3 التزامات منطقية برسائل واضحة تصف ما يُحقق كل مجموعة من التغييرات." يُحلل Claude Code الالتزامات ويُوفّر أوامر git rebase اللازمة لإعادة هيكلتها بصورة نظيفة.

استخدام Claude Code جنباً إلى جنب مع بيئة التطوير

لا يتعارض Claude Code وبيئة التطوير المتكاملة لديك — بل هما أدوات تكميلية تعمل بأفضل صورة معاً:

• بيئة التطوير لـ: البرمجة النشطة وتمييز الصياغة والإكمال التلقائي والتصحيح بنقاط التوقف والاستكشاف المرئي للملفات وعمليات Git المستندة إلى الواجهة الرسومية
• Claude Code لـ: إعادة الهيكلة متعددة الملفات وتطبيق الميزات من أوصاف اللغة الطبيعية وإصلاح الأخطاء المستقل وتوليد الاختبارات والتوثيق وفهم الأجزاء غير المألوفة من قواعد الأكواد الكبيرة

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

الإعداد الأمثل لمساحة العمل في جلسات Claude Code

توصّل المطورون الذين يستخدمون Claude Code بكثافة إلى إعدادات مساحة عمل تُعظّم الإنتاجية:

• تخطيط الطرفية المقسّمة — شغّل Claude Code في لوحة طرفية واحدة واحتفظ بلوحة ثانية لتشغيل تطبيقك أو الاختبارات أو مراقبة السجلات. راقب ظهور نتائج الاختبار بينما يُصلح Claude Code الأخطاء في الوقت الفعلي.
• فارق Git في بيئة التطوير جنباً إلى جنب مع الطرفية — أبقِ بيئة التطوير لديك مفتوحة على عرض فارق التحكم بالإصدار. بينما يُعدّل Claude Code الملفات، تظهر التغييرات محدّدة في الوقت الفعلي في بيئة التطوير لديك دون مقاطعة جلسة Claude Code.
• استمرارية الجلسة عبر Tmux أو iTerm2 — استخدم مُضاعف طرفية للحفاظ على جلسات Claude Code حية عبر انقطاعات الشبكة وإغلاق غطاء الحاسوب. هذا مهم بصفة خاصة للجلسات الطويلة المستقلة (30 دقيقة أو أكثر) حيث قد تُفقد التقدمات بسبب انقطاع الاتصال.
• مجلدات مشاريع منظمة — أبقِ مشاريعك منظمةً جيداً بأسماء مجلدات واضحة. يقرأ Claude Code بنية مجلدك كجزء من فهمه للمشروع، والتنظيم النظيف يساعده على استيعاب حدود المشروع فوراً.