ملخص سريع: يتم تثبيت Claude Code CLI بأمر واحد يقوم بتنزيل الأداة وتكوينها تلقائيًا. على macOS و Linux، استخدم البرنامج النصي للصدفة الرسمي من وثائق Anthropic، بينما يقوم مستخدمو Windows بتشغيل أوامر PowerShell أو WSL. بعد التثبيت، قم بالمصادقة باستخدام مفتاح API الخاص بك لبدء استخدام مساعد Claude البرمجي المدعوم بالذكاء الاصطناعي في الطرفية الخاصة بك.
Claude Code هو أداة برمجة وكيلة تعيش في الطرفية الخاصة بك وتفهم قاعدة الشيفرة الكاملة الخاصة بك. وفقًا لوثائق Claude Code الرسمية، يمكنه قراءة الملفات وتنفيذ الأوامر وتحرير الشيفرة والتكامل مع أدوات التطوير من خلال محادثات اللغة الطبيعية.
ولكن البدء يتطلب تثبيتًا صحيحًا. إليك كل ما هو مطلوب لتثبيت Claude Code CLI وتكوينه بشكل صحيح.
متطلبات النظام قبل التثبيت
قبل تثبيت Claude Code، تحقق من أن النظام يلبي المتطلبات الأساسية. وفقًا لوثائق الإعداد المتقدم الرسمية، قم بإزالة هذه الجملة بالكامل.
تحقق من تثبيت Node.js عن طريق فتح الطرفية وتشغيل:
| node –version |
إذا لم يكن Node.js مثبتًا أو كان الإصدار أقل من 18، فقم بتنزيله من موقع Node.js الرسمي. إصدار الدعم طويل الأمد (LTS) يعمل بشكل مثالي لـ Claude Code.
بالإضافة إلى Node.js، يحتاج النظام إلى متطلبات أساسية: macOS 13.0 أو أعلى لمستخدمي Mac، Windows 10 أو أعلى لأنظمة Windows، وتعمل معظم توزيعات Linux الحديثة بدون مشاكل. مطلوب أيضًا حساب Claude من Anthropic للمصادقة بعد التثبيت.
تثبيت Claude Code على macOS و Linux
تستخدم عملية التثبيت على macOS و Linux أمر صدفه واحد يقوم بكل شيء تلقائيًا. هذه الطريقة موثقة في دليل البدء السريع الرسمي لـ Claude Code.
افتح الطرفية وقم بتشغيل برنامج التثبيت:
| curl -fsSL claude.ai/install.sh | bash |
يقوم البرنامج النصي بتنزيل الملف الثنائي Claude Code، ووضعه في الدليل الصحيح، وتكوين المسار (PATH) تلقائيًا. تكتمل العملية برمتها عادةً في أقل من دقيقة.
بالنسبة لمستخدمي macOS الذين يفضلون Homebrew، توجد طريقة تثبيت بديلة على الرغم من أنها غير موثقة رسميًا في المصادر الأساسية. تظل طريقة curl هي النهج الموصى به وفقًا للوثائق الرسمية.
التحقق من التثبيت
بعد اكتمال التثبيت، تحقق من إمكانية الوصول إلى Claude Code:
| claude –version |
يجب أن يعرض هذا الأمر رقم الإصدار المثبت. إذا ظهر خطأ يفيد بأن "الأمر غير موجود" ("command not found")، فيجب تعديل تكوين المسار (PATH).
وفقًا لوثائق استكشاف الأخطاء وإصلاحها الرسمية، فإن مشاكل المسار (PATH) هي المشكلة الأكثر شيوعًا في التثبيت. يتضمن الحل إضافة دليل تثبيت Claude إلى ملف تكوين الصدفة.
تثبيت Claude Code على macOS و Linux
تعتمد عملية التثبيت على macOS و Linux على npm (مدير حزم Node). وفقًا للوثائق الرسمية، يجب أن يكون لديك Node.js 18+ مثبتًا على نظامك قبل المتابعة. على عكس أدوات CLI التقليدية التي تستخدم نصوص الصدفة، يتم تثبيت Claude Code بشكل عام عبر الطرفية الخاصة بك لضمان معالجة جميع التبعيات بشكل صحيح.
افتح الطرفية الخاصة بك وقم بتشغيل الأمر التالي لتثبيت الحزمة:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
ملاحظة: متغير البيئة CLAUDE_CODE_RELEASE_ALPHA=1 مطلوب حاليًا خلال مرحلة النسخة التجريبية العامة/الألفا للإقرار بحالة المعاينة للأداة.
يقوم هذا الأمر بتنزيل الحزمة من سجل npm الرسمي وربط الملف التنفيذي `claude` بدليل bin العام لنظامك. بينما قد يحاول بعض المستخدمين العثور على صيغ Homebrew، فإن طريقة npm هي المسار الوحيد المدعوم رسميًا والموثق للتثبيت.
التحقق من التثبيت
بعد اكتمال التثبيت، تحقق من أن CLI تم تعيينه بشكل صحيح لبيئتك عن طريق تشغيل:
| claude –version |
يجب أن يعرض هذا الأمر رقم الإصدار الحالي (على سبيل المثال، 0.2.9). إذا واجهت خطأ "command not found"، فهذا يعني عادةً أن دليل npm العام الخاص بك ليس في مسار (PATH) نظامك.
وفقًا لوثائق استكشاف الأخطاء وإصلاحها الرسمية، يمكنك إصلاح ذلك عن طريق تحديد بادئة npm الخاصة بك باستخدام `npm config get prefix` والتأكد من إضافة مجلد `/bin` الناتج إلى ملف `.zshrc` أو `.bashrc` الخاص بك.
تثبيت Claude Code على Windows
يوفر تثبيت Windows نهجين رئيسيين: تثبيت PowerShell الأصلي أو استخدام نظام Windows الفرعي لنظام Linux (WSL). توصي الوثائق الرسمية بـ PowerShell لمعظم المستخدمين.
طريقة تثبيت PowerShell
افتح PowerShell كمسؤول (انقر بزر الماوس الأيمن على قائمة ابدأ وحدد "Windows PowerShell (Admin)"). قم بتشغيل هذا الأمر:
| irm claude.ai/install.ps1 | iex |
يقوم البرنامج النصي لـ PowerShell بتنزيل التثبيت وتكوين المسار (PATH) تلقائيًا. بعد الانتهاء، أغلق وأعد فتح PowerShell للتأكد من سريان تحديثات المسار (PATH).
طريقة تثبيت WSL
يمكن للمطورين الذين يستخدمون WSL بالفعل تثبيت Claude Code باستخدام طريقة Linux. افتح طرفية WSL وقم بتشغيل نفس أمر curl المستخدم لـ Linux:
| curl -fsSL claude.ai/install.sh | bash |
يعمل نهج WSL بشكل متطابق مع تثبيتات Linux الأصلية. ميزة واحدة: يوفر WSL بيئة أقرب إلى Unix تتطابق مع تكوينات خوادم الإنتاج.
وفقًا لوثائق استكشاف الأخطاء وإصلاحها الرسمية، يواجه مستخدمو WSL أحيانًا مشاكل في الاتصال بالشبكة. إذا توقف التثبيت، فتحقق من أن WSL يمكنه الوصول إلى الشبكات الخارجية وأن قواعد جدار الحماية لا تمنع حركة المرور.
ابحث عن Claude و AI Tool Credits في مكان واحد
تثبيت Claude Code CLI هو خطوة واحدة. دفع تكاليف أدوات الذكاء الاصطناعي على المدى الطويل هو أمر آخر. Get AI Perks يجمع أرصدة الشركات الناشئة وخصومات البرامج لأدوات الذكاء الاصطناعي والحوسبة السحابية في مكان واحد. يمنح المؤسسين وصولاً إلى أكثر من 200 ميزة، بما في ذلك عروض من Anthropic و Claude و OpenAI و Gemini و ElevenLabs و Intercom وغيرها. تعرض المنصة أيضًا شروط الميزات وأدلة المطالبة بكل عرض.
تبحث عن أرصدة Claude أو Anthropic؟
تحقق من Get AI Perks لـ:
- العثور على أرصدة وخصومات أدوات الذكاء الاصطناعي في مكان واحد
- مراجعة شروط الميزات قبل التقديم
- الوصول إلى أدلة للمطالبة بعروض الشركات الناشئة
👉 قم بزيارة Get AI Perks لتصفح عروض Claude و Anthropic وغيرها من أدوات الذكاء الاصطناعي المتاحة.
المصادقة والتكوين الأولي
بعد التثبيت، يتطلب Claude Code المصادقة قبل أن يتمكن من العمل. تستخدم الأداة مفاتيح API من Anthropic للتحقق من الوصول.
ابدأ عملية المصادقة عن طريق تشغيل:
| claude |
في المرة الأولى التي يتم فيها تشغيل هذا الأمر، يطالب Claude Code بالمصادقة. وفقًا لدليل البدء السريع الرسمي، يفتح هذا نافذة متصفح لتسجيل الدخول إلى حساب Anthropic.
بعد تسجيل الدخول عبر المتصفح، يتلقى CLI رمز مصادقة تلقائيًا. يتم تخزين هذا الرمز محليًا ويستمر عبر الجلسات، لذلك لا يلزم المصادقة المتكررة.
تكوين إعدادات مستوى المشروع
يدعم Claude Code التكوين على مستويات متعددة وفقًا لوثائق الإعدادات الرسمية. مستويات التكوين الأكثر شيوعًا هي:
| النطاق | الموقع | حالة الاستخدام |
|---|---|---|
| المستخدم | ~/.claude/ directory | تفضيلات شخصية عبر جميع المشاريع |
| المشروع | .claude/ in repository | تكوين فريق مشترك |
| محلي | .claude/settings.local.json | تجاوزات خاصة بالجهاز |
للإعداد الأولي، تكوين مستوى المستخدم كافٍ. تصبح إعدادات مستوى المشروع مهمة عند العمل مع فرق تشترك في معايير البرمجة.
بدء أول جلسة Claude Code
بعد اكتمال التثبيت والمصادقة، قم بتشغيل Claude Code عن طريق تشغيل الأمر بدون وسائط:
| claude |
يبدأ هذا الوضع التفاعلي حيث يستجيب Claude لطلبات اللغة الطبيعية. تصف الوثائق الرسمية الوضع التفاعلي بأنه الطريقة الأساسية لاستخدام Claude Code لمهام التطوير.
جرب أمر اختبار بسيط:
| أظهر لي هيكل هذا المشروع |
يقوم Claude Code بتحليل الدليل الحالي وتقديم نظرة عامة على هيكل قاعدة الشيفرة. هذا يوضح أن التثبيت يعمل بشكل صحيح وأن Claude لديه إذن بقراءة الملفات.
الأوامر الأساسية للاستخدام اليومي
بالإضافة إلى الوضع التفاعلي، يدعم Claude Code أنماط أوامر متعددة موثقة في مرجع CLI:
| نمط الأمر | الغرض | مثال |
|---|---|---|
| claude | بدء جلسة تفاعلية | claude |
| claude "مهمة" | تشغيل مهمة لمرة واحدة | claude "إصلاح أخطاء التدقيق" |
| claude -p "استعلام" | استعلام سريع بدون جلسة | claude -p "ماذا تفعل هذه الدالة" |
نمط المهمة لمرة واحدة مفيد بشكل خاص لخطوط أنابيب CI/CD والبرامج النصية للأتمتة حيث لا يكون الجلسة التفاعلية مناسبة.
استكشاف الأخطاء وإصلاحها الشائعة للتثبيت
حتى مع برامج التثبيت الآلية، تحدث مشاكل من حين لآخر. تغطي وثائق استكشاف الأخطاء وإصلاحها الرسمية المشاكل الأكثر تكرارًا.
أخطاء "الأمر غير موجود"
إذا عرضت الطرفية "command not found: claude" بعد التثبيت، فإن تكوين المسار (PATH) لم يكتمل بشكل صحيح. بالنسبة لـ macOS و Linux، قم بإضافة موقع الملف التنفيذي لـ Claude إلى ملف تكوين الصدفة يدويًا.
لمستخدمي bash، قم بتحرير `~/.bashrc` أو `~/.bash_profile` وأضف:
| export PATH=”$HOME/.local/bin:$PATH” |
لمستخدمي zsh (الافتراضي في macOS الحديث)، قم بتحرير `~/.zshrc` بنفس السطر. بعد الحفظ، أعد تحميل التكوين باستخدام `source ~/.zshrc` أو افتح نافذة طرفية جديدة.
مشاكل الشبكة وجدار الحماية
تمنع شبكات الشركات وجدران الحماية المقيدة أحيانًا برنامج التثبيت. وفقًا لوثائق استكشاف الأخطاء وإصلاحها، إذا توقف التثبيت أو أعاد HTML بدلاً من التنفيذ، فقد يكون الوصول إلى الشبكة إلى خوادم Anthropic محظورًا.
تتضمن الحلول البديلة تنزيل برنامج التثبيت بشكل منفصل:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
يوفر هذا النهج مزيدًا من الرؤية لما يفشل إذا حدثت أخطاء أثناء التنزيل أو التنفيذ.
مشاكل خاصة بـ WSL
يواجه مستخدمو Windows الذين يقومون بتشغيل WSL أحيانًا مشاكل في الاتصال بين النظام الفرعي Linux و Windows. تذكر الوثائق الرسمية أنه قد يلزم تعديل قواعد جدار الحماية للسماح بحركة مرور WSL.
إذا تم تثبيت Claude Code بنجاح ولكنه لا يستطيع الوصول إلى خوادم Anthropic للمصادقة، فتحقق من أن جدار حماية Windows يسمح بوصول شبكة WSL. يقدم دليل استكشاف الأخطاء وإصلاحها أوامر PowerShell محددة لتكوين قواعد جدار الحماية.
تحديث Claude Code
يتلقى Claude Code تحديثات منتظمة بميزات وتحسينات جديدة. وفقًا للوثائق الرسمية، يتم تثبيت التحديثات باستخدام نفس الأمر مثل التثبيت الأولي.
قم بتشغيل برنامج التثبيت مرة أخرى:
| curl -fsSL code.anthropic.com/install.sh | sh |
يكتشف البرنامج النصي التثبيت الحالي ويقوم بترقيته إلى أحدث إصدار. لا يتم فقدان أي تكوين أو مصادقة أثناء عملية التحديث.
تحقق من الإصدار الحالي قبل وبعد التحديث:
| claude –version |
يسرد سجل التغييرات في وثائق Claude Code الرسمية جميع التغييرات بين الإصدارات، مما يساعد في تحديد ما إذا كان التحديث يقدم ميزات ذات صلة بسير العمل المحدد.
الخطوات التالية بعد التثبيت
بعد تثبيت Claude Code والعمل به، يصبح استكشاف الميزات المتقدمة ممكنًا. تصف الوثائق الرسمية العديد من المجالات التي تستحق الاستكشاف:
- المهارات والتخصيص: وفقًا لوثائق المهارات الرسمية، يدعم Claude Code المهارات المخصصة المعرفة في ملفات Markdown داخل الدليل `.claude/skills/`. توسع هذه المهارات قدرات Claude بأوامر وسير عمل خاصة بالمشروع.
- بروتوكول سياق النموذج (MCP): يتيح تكامل MCP لـ Claude Code الاتصال بأدوات وخدمات خارجية. هذا يحول Claude إلى مركز يمكنه الوصول إلى قواعد البيانات وواجهات برمجة التطبيقات وموارد التطوير الأخرى.
- تعاون الفريق: يمكن تثبيت ملفات تكوين مستوى المشروع في الدليل `.claude/` في نظام التحكم في الإصدار، مما يشارك إعدادات Claude Code عبر فرق التطوير بأكملها.
- توفر الوثائق الرسمية أدلة مفصلة لكل من هذه المجالات، بناءً على التثبيت الأساسي المغطى هنا.
الأسئلة الشائعة
هل أحتاج إلى اشتراك Claude مدفوع لاستخدام Claude Code CLI؟
يتطلب Claude Code حساب Claude من Anthropic، لكن طبقة الاشتراك المحددة المطلوبة تعتمد على الاستخدام. وفقًا للوثائق الرسمية، المصادقة ضرورية ولكن يجب التحقق من تفاصيل التسعير على الموقع الرسمي لـ Anthropic حيث تتغير الخطط بمرور الوقت.
هل يمكنني تثبيت Claude Code بدون امتيازات المسؤول؟
على macOS و Linux، يتم تثبيت Claude Code في دليل المنزل للمستخدم افتراضيًا ولا يتطلب وصول المسؤول. قد يحتاج مستخدمو Windows إلى امتيازات المسؤول لطريقة تثبيت PowerShell، على الرغم من أن تثبيتات WSL لا تتطلب وصول المسؤول.
هل يعمل Claude Code في وضع عدم الاتصال؟
لا. Claude Code هي أداة مدعومة بالذكاء الاصطناعي تتواصل مع خوادم Anthropic لمعالجة الطلبات. وفقًا للوثائق الرسمية، يلزم وجود اتصال إنترنت نشط لـ Claude لتحليل الشيفرة وإنشاء استجابات.
كيف ألغي تثبيت Claude Code؟
تشرح وثائق الإعداد المتقدم الرسمية أن إلغاء التثبيت يتضمن إزالة الملف التنفيذي وملفات التكوين. على macOS و Linux، قم بحذف الدليل `~/.claude` وإزالة تعديل المسار (PATH) من ملفات تكوين الصدفة. يجب على مستخدمي Windows إزالة دليل التثبيت ومسح متغير البيئة PATH.
هل يمكن لـ Claude Code الوصول إلى نظام الملفات بالكامل الخاص بي؟
افتراضيًا، يعمل Claude Code ضمن دليل العمل الحالي وأدلة فرعية. وفقًا لوثائق الأذونات الرسمية، يمكن تقييد الوصول بشكل أكبر باستخدام إعدادات البيئة المعزولة (sandbox) في ملفات التكوين. يطلب Claude دائمًا التأكيد قبل تنفيذ العمليات التدميرية المحتملة.
ما هو الفرق بين Claude Code CLI و Claude Desktop؟
يعمل Claude Code CLI في الطرفية ويركز على سير عمل التطوير مع الوصول المباشر إلى نظام الملفات وتنفيذ الأوامر. Claude Desktop هو تطبيق مستقل بواجهة رسومية. تخدم كلتا الأداتين حالات استخدام مختلفة، مع تحسين CLI للمطورين الذين يفضلون سير العمل المستند إلى الطرفية.
كم مرة يجب أن أقوم بتحديث Claude Code؟
يمكن تثبيت التحديثات عندما يكون ذلك مناسبًا. يوثق سجل التغييرات الرسمي الميزات الجديدة وإصلاحات الأخطاء. بالنسبة للفرق، يضمن تنسيق التحديثات أن الجميع يستخدمون إصدارات متوافقة، على الرغم من أن Claude Code يحتفظ بالتوافق مع الإصدارات السابقة مع ملفات التكوين عبر الإصدارات.
خاتمة
يستغرق تثبيت Claude Code CLI بضع دقائق فقط بغض النظر عن نظام التشغيل. تتعامل برامج التثبيت الآلية مع التكوين وإعداد المسار (PATH) ووضع الملفات التنفيذية دون تدخل يدوي.
بعد التثبيت والمصادقة، يصبح Claude Code مساعدًا برمجيًا قويًا مدعومًا بالذكاء الاصطناعي يمكن الوصول إليه من أي طرفية. تتيح أوامر اللغة الطبيعية للمطورين كتابة الشيفرة وإصلاح الأخطاء وأتمتة المهام دون مغادرة سطر الأوامر.
هل أنت مستعد لتجربة التطوير المدعوم بالذكاء الاصطناعي؟ قم بتشغيل أمر التثبيت لنظام التشغيل الخاص بك وابدأ أول جلسة Claude Code اليوم. توفر الوثائق الرسمية على code.claude.com أدلة شاملة للميزات المتقدمة بمجرد اكتمال الإعداد الأساسي.
