كيفية إعداد Claude Code: دليل كامل لعام 2026

ملخص سريع: Claude Code هو مساعد ترمينال للبرمجة بالذكاء الاصطناعي يعمل أصليًا على macOS و Linux، أو على Windows عبر WSL2. يتطلب إعداده إنشاء مفتاح API من Anthropic، وتشغيل مثبت خاص بالمنصة، والمصادقة باستخدام المفتاح، والتحقق من التثبيت بأمر اختبار. 

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

لكن عملية الإعداد ليست دائمًا واضحة. يحتاج مستخدمو Windows إلى WSL2. يمكن أن تعيق مصادقة API المبتدئين. تحدث تعارضات الإصدارات.

هذا الدليل يمر عبر عملية الإعداد الكاملة لجميع المنصات، من متطلبات النظام إلى أول جلسة برمجة لك.

ما هو Claude Code بالضبط

Claude Code هو تطبيق ترمينال وكيل يتكامل مع بيئات التطوير. يفهم قواعد التعليمات البرمجية، وينفذ المهام الروتينية، ويدير سير عمل git عبر الأوامر الحوارية.

على عكس الأدوات المستندة إلى المتصفح، يعمل Claude Code محليًا في الترمينال. يصل إلى ملفات المشروع مباشرة، ويحافظ على السياق عبر الجلسات، ويتكامل مع سير عمل التطوير الحالي. وفقًا لتوثيق Claude Code الرسمي، يتصل الأداة بواجهة برمجة تطبيقات Anthropic ويدعم التكامل مع Amazon Bedrock و Google Cloud Vertex AI و Azure AI.

تعمل الأداة بشكل مختلف عن مساعدي البرمجة التقليديين. حديث صريح: إنه أشبه بوجود مبرمج مساعد في الترمينال الخاص بك بدلاً من أداة إكمال التعليمات البرمجية.

متطلبات النظام لـ Claude Code

قبل التثبيت، تحتاج الأنظمة إلى تلبية متطلبات محددة. إليك ما تحتاجه كل منصة:

تحتاج جميع المنصات إلى اتصال إنترنت مستقر لاستدعاءات API. تتطلب تنزيلات Claude Code عادةً حوالي 50 ميجابايت، مع إضافة WSL2 على Windows حوالي 500 ميجابايت لنظام Linux الفرعي.

من حيث التخزين، توقع ما لا يقل عن 4 جيجابايت من المساحة الخالية. التطبيق نفسه صغير، لكن المساحة للتبعيات وملفات المشروع مهمة.

متطلبات Windows الخاصة

يمكن تشغيل Claude Code على Windows عبر PowerShell أو Command Prompt إذا تم تثبيت Node.js. تتطلب الأداة Windows Subsystem for Linux 2 لإنشاء بيئة Linux.

وفقًا لأدلة التثبيت من claude.ai، تحتاج أنظمة Windows 10 إلى الإصدار 1903 أو أحدث مع Build 19041 أو أعلى. يتمتع مستخدمو Windows 11 بدعم WSL2 مدمج. مطلوب امتيازات المسؤول لإعداد WSL2 الأولي.

تتضمن العملية تمكين المحاكاة الافتراضية في BIOS، وتفعيل ميزات Windows، وتثبيت توزيع Linux. Ubuntu 22.04 LTS هو التوزيع الموصى به للتوافق.

تثبيت Claude Code: عملية خطوة بخطوة

تختلف عملية التثبيت حسب المنصة. إليك كيفية تشغيل Claude Code على كل نظام تشغيل.

التثبيت على macOS و Linux

تتبع تثبيتات macOS و Linux نفس النمط. تدعم كلتا المنصتين التثبيت الأصلي دون إعداد إضافي.

تبدأ العملية بتنزيل المثبت. افتح الترمينال وقم بتشغيل:

curl -fsSL claude.ai/install.sh | sh

يكتشف البرنامج النصي نظام التشغيل، ويقوم بتنزيل الملف الثنائي المناسب، ويقوم بتثبيت Claude Code في دليل bin المحلي. يكتمل التثبيت عادةً في أقل من دقيقتين مع اتصال مستقر.

بالنسبة للأنظمة التي لا تحتوي على curl، يعمل wget كبديل. يضيف المثبت Claude Code إلى مسار النظام (PATH) تلقائيًا.

التثبيت على Windows عبر WSL2

يتطلب تثبيت Windows إعداد WSL2 أولاً. إليك العملية الكاملة:

افتح PowerShell كمسؤول وقم بتمكين WSL:

wsl –install

يقوم هذا الأمر بتمكين ميزات Windows المطلوبة، وتنزيل نواة WSL2، وتثبيت Ubuntu افتراضيًا. سيطلب النظام إعادة التشغيل. بعد إعادة التشغيل، يبدأ Ubuntu تلقائيًا لإكمال إعداد المستخدم.

أنشئ اسم مستخدم وكلمة مرور عند المطالبة. هذه بيانات الاعتماد مخصصة لبيئة Linux، منفصلة عن تفاصيل تسجيل دخول Windows.

بمجرد تشغيل WSL2، تنطبق عملية تثبيت Linux. في ترمينال Ubuntu، قم بتشغيل أمر curl من قسم macOS/Linux أعلاه.

يتولى المثبت الباقي. يتم تثبيت Claude Code داخل بيئة WSL2 ويعمل عبر ترمينال Ubuntu.

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

يتطلب Claude Code مفتاح API من Anthropic للمصادقة. يربط المفتاح التثبيت المحلي بخوادم Anthropic.

قم بزيارة Anthropic Console على console.anthropic.com. أنشئ حسابًا أو سجل الدخول باستخدام بيانات الاعتماد الحالية. انتقل إلى مفاتيح API في إعدادات الحساب.

انقر فوق "إنشاء مفتاح" لإنشاء مفتاح API جديد. يظهر المفتاح مرة واحدة - قم بنسخه فورًا. لا يعرض Anthropic المفتاح الكامل مرة أخرى بعد مغادرة الصفحة.

قم بتخزين المفتاح بأمان. يوفر وصولاً كاملاً إلى واجهة برمجة تطبيقات Anthropic وأي فواتير مرتبطة بها.

فهم تكاليف API

يعمل Claude Code بنموذج الدفع مقابل الاستخدام عبر واجهة برمجة تطبيقات Anthropic. بناءً على البيانات من أدلة تثبيت claude.ai، تختلف التكاليف حسب النموذج:

الحد الأدنى للشراء لتفعيل الفوترة هو 5 دولارات، على الرغم من أن مناقشات المجتمع تشير إلى أن 20-30 دولارًا توفر هامشًا أفضل للاختبار. تشمل خيارات الاشتراك البديلة Claude Pro مقابل 20 دولارًا شهريًا أو Claude Max مقابل 100 دولار شهريًا للاستخدام المكثف.

يستخدم السلوك الافتراضي Opus حتى الوصول إلى 50٪ من حدود الاستخدام، ثم ينتقل إلى Sonnet لكفاءة التكلفة.

المصادقة والإطلاق الأول

بعد التثبيت، يحتاج Claude Code إلى المصادقة قبل الاستخدام لأول مرة. قم بتشغيل Claude Code عن طريق:

claude

يطالبك الإطلاق الأول بمفتاح API. قم بلصق المفتاح من Anthropic Console واضغط على Enter. يقوم Claude Code بالتحقق من صحة المفتاح وتخزينه بأمان في ملفات التكوين المحلية.

تبقى المصادقة عبر الجلسات. لا يلزم إعادة إدخال مفتاح API إلا إذا تم حذفه صراحةً أو عند تبديل الحسابات.

للتحقق من نجاح المصادقة، يعرض Claude Code رسالة ترحيبية وموجه الأوامر. تعرض الواجهة الأوامر المتاحة وتؤكد الاتصال بواجهة برمجة تطبيقات Anthropic.

تكوين تفضيلات النموذج

يفترض Claude Code اختيار النموذج التلقائي، ولكن التكوين اليدوي ممكن. وفقًا للتوثيق الرسمي، يمكن للمستخدمين تعديل اختيار النموذج عبر الأمر /model أو عن طريق تعيين متغير البيئة CLAUDE_CODE_EFFORT_LEVEL.

يتحكم مستوى الجهد في عمق التفكير لنماذجي Opus 4.6 و Sonnet 4.6: منخفض، متوسط، أو عالٍ. تزيد مستويات الجهد الأعلى من عمق الاستدلال ولكنها تزيد أيضًا من التكلفة ووقت الاستجابة.

للمشاريع التي تتطلب تحليلًا عميقًا، يتضمن "التفكير الفائق" (ultrathink) في المطالبات تعيين الجهد مؤقتًا إلى عالٍ لذلك الدور المحدد.

التحقق من نجاح التثبيت

بعد المصادقة، تحقق من أن Claude Code يعمل بشكل صحيح. قم بتشغيل هذه الاختبارات الأساسية:

claude –help
claude –version

يعرض أمر المساعدة الخيارات والأوامر المتاحة. يؤكد إخراج الإصدار الإصدار المثبت. يجب تنفيذ كلا الأمرين دون أخطاء.

بعد ذلك، اختبر Claude Code في دليل مشروع. أنشئ مجلد اختبار:

mkdir test-project
cd test-project
echo “# Test Project” > README.md
claude

داخل جلسة Claude Code، جرب التفاعلات الأساسية:

• اكتب "help" لرؤية الأوامر المتاحة
• اسأل "explain what you can do" (اشرح ما يمكنك فعله)
• اطلب "summarize this project" (لخص هذا المشروع)
• اختبر الأمر /help

تؤكد هذه التفاعلات أن Claude Code يمكنه قراءة ملفات المشروع والاستجابة للمطالبات. تعني الاستجابات الناجحة أن التثبيت يعمل.

تكوين Claude Code للمشاريع

يقوم Claude Code بتخزين إعدادات خاصة بالمشروع في ملفات التكوين. تقوم هذه الملفات بتخصيص السلوك، وتحديد الذاكرة، وإنشاء سير العمل.

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

أنشئ ملف CLAUDE.md أساسيًا:

# سياق المشروع

هذا [نوع المشروع] مبني باستخدام [التقنيات].

## المبادئ التوجيهية الرئيسية
-- [قاعدة هامة 1]
-- [قاعدة هامة 2]

## هيكل المشروع
[شرح موجز لتنظيم المجلدات]

يقبل الملف تنسيق Markdown. يقرأ Claude Code هذا السياق عند بدء الجلسة ويحافظ عليه طوال المحادثة.

خيارات التكوين المتقدمة

بالإضافة إلى السياق الأساسي، يدعم Claude Code التكوين المتقدم عبر دليل .claude. يمكن أن يحتوي هذا الدليل على:

• مهارات: قدرات متخصصة معرفة في .claude/skills/SKILL.md
• أوامر: أوامر مائلة مخصصة في .claude/commands/*.md
• خطافات: سير عمل تلقائي يتم تشغيله بواسطة الأحداث
• إضافات: وظائف ممتدة من خلال التكامل البرمجي

وفقًا لتوثيق Agent SDK الرسمي، تمكّن هذه الميزات التخصيص المعقد. تحدد المهارات القدرات القابلة لإعادة الاستخدام. تنشئ الأوامر اختصارات للمهام الشائعة. تقوم الخطافات بأتمتة الاستجابات لتغييرات الملفات أو استخدام الأدوات.

استخدام Claude Code: سير العمل الأساسي

بعد اكتمال التثبيت، يتعامل Claude Code مع مهام التطوير الشائعة عبر اللغة الطبيعية.

ابدأ جلسة بالانتقال إلى دليل مشروع وتشغيل:

claude

يقبل الموجه طلبات اللغة العادية. بعض سير العمل الشائعة:

• إنشاء التعليمات البرمجية: "قم بإنشاء دالة Python تتحقق من عناوين البريد الإلكتروني مع معالجة الأخطاء المناسبة."
• إصلاح الأخطاء: "تُلقي هذه الدالة استثناء مؤشر فارغ. هل يمكنك تحديد المشكلة وإصلاحها؟"
• إعادة الهيكلة: "أعد هيكلة هذا المكون لاستخدام حقن التبعية بدلاً من الإنشاء المباشر."
• عمليات Git: "أنشئ فرعًا جديدًا، وقم بتثبيت هذه التغييرات برسالة وصفية، وادفع إلى الأصل."

يحافظ Claude Code على السياق عبر الجلسة. يتذكر التفاعلات السابقة، ويتتبع تعديلات الملفات، ويفهم هيكل المشروع الأوسع.

فهم وضع الخطة

للتغييرات المعقدة، يوفر Claude Code وضع الخطة. ينشئ هذا الوضع خطة تنفيذ مفصلة قبل إجراء التعديلات.

قم بتنشيط وضع الخطة عن طريق وضع "plan:" قبل الطلبات أو استخدام الأمر /plan. بعد ذلك، يحدد Claude Code التغييرات المقترحة، ويشرح المنطق، وينتظر الموافقة قبل التنفيذ.

يعد وضع الخطة مفيدًا بشكل خاص لإعادة الهيكلة أو التغييرات المعمارية أو التعديلات التي تؤثر على ملفات متعددة. يوفر رؤية لما ينوي Claude Code القيام به قبل الالتزام بالتغييرات.

التكامل مع VS Code وبيئات التطوير المتكاملة

بينما يعمل Claude Code في الترمينال، فإن التكامل مع محررات التعليمات البرمجية يعزز سير العمل. يضع الامتداد الرسمي لـ VS Code إمكانيات Claude Code مباشرة في المحرر.

قم بتثبيت الامتداد من سوق VS Code. ابحث عن "Claude Code" وانقر فوق تثبيت. يضيف الامتداد لوحة Claude Code إلى الشريط الجانبي.

وفقًا لتوثيق VS Code الرسمي، يدعم الامتداد:

يحافظ الامتداد على تكافؤ الميزات مع إصدار الترمينال مع إضافة وسائل راحة خاصة ببيئات التطوير المتكاملة مثل مقارنات الأسطر المضمنة وإشارات @ للملفات.

تحديث وإدارة Claude Code

يقوم Claude Code بتحديث نفسه تلقائيًا افتراضيًا. يتحقق التطبيق من الإصدارات الجديدة بشكل دوري ويثبت التحديثات في الخلفية.

للتحديث يدويًا، قم بتشغيل:

claude –update

هذا يجبر على التحقق الفوري وتثبيت أحدث إصدار. تحافظ عملية التحديث على ملفات التكوين وبيانات اعتماد المصادقة.

بالنسبة للمؤسسات التي تتطلب التحكم في الإصدار، يمكن تعطيل التحديثات التلقائية. قم بتعيين متغير البيئة CLAUDE_CODE_AUTO_UPDATE إلى false أو قم بالتكوين من خلال الإعدادات التي تديرها الخوادم.

لتثبيت إصدار معين، استخدم:

curl -fsSL claude.ai/install.sh | sh -s — –version=X.Y.Z

استبدل X.Y.Z برقم الإصدار المستهدف.

مشاكل الإعداد الشائعة والحلول

تحدث عدة مشاكل بشكل شائع أثناء الإعداد. إليك كيفية حلها:

• رفض مفتاح API: إذا رفض Claude Code مفتاح API، فتحقق من عدم وجود مسافات أو أحرف إضافية. أعد نسخ المفتاح من Anthropic Console. تحقق من تفعيل الفوترة - لن تعمل المفاتيح بدون طريقة دفع مسجلة.
• فشل تثبيت WSL2: تفشل أنظمة Windows أحيانًا في تثبيت WSL2 بسبب إعدادات المحاكاة الافتراضية. أدخل BIOS وقم بتمكين المحاكاة الافتراضية (Intel VT-x أو AMD-V). تأكد من أن إصدار Windows يلبي الحد الأدنى من المتطلبات.
• الأمر غير موجود: إذا لم يتعرف الترمينال على أمر claude، فلم يتم تحديث المسار (PATH) بشكل صحيح. أغلق الترمينال وأعد فتحه. للمشاكل المستمرة، أضف دليل التثبيت يدويًا إلى PATH.
• مهلة الاتصال: قد تمنع قيود الشبكة أو جدران الحماية استدعاءات API. يتطلب Claude Code وصول HTTPS إلى api.anthropic.com. قد تحتاج الشبكات المؤسسية إلى تكوين الوكيل.
• أخطاء الأذونات: تواجه تثبيتات Linux و macOS أحيانًا مشاكل في الأذونات. قم بتشغيل المثبت بأذونات مناسبة أو قم بالتثبيت في دليل المستخدم بدلاً من المواقع على مستوى النظام.

تحقق من أرصدة الذكاء الاصطناعي المتاحة قبل إعداد Claude Code

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

يقوم Get AI Perks بجمع هذه الفرص في مكان واحد. يسرد النظام الأرصدة، والخصومات، وبرامج الشركاء عبر موفري الذكاء الاصطناعي، والمنصات السحابية، وأدوات المطورين، مع أدلة خطوة بخطوة تشرح كيفية المطالبة بها. في المجموع، تتضمن قاعدة البيانات مزايا من أكثر من 200 أداة ومليارات الدولارات من الأرصدة المتاحة التي يمكن للشركات الناشئة والبناة التقدم بطلب للحصول عليها.

قبل الانتهاء من إعداد Claude Code، تحقق من Get AI Perks وادّعِ أرصدة الذكاء الاصطناعي التي يمكن أن تغطي تجاربك الأولى.

أسئلة متكررة

المضي قدمًا مع Claude Code

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

تتفوق الأداة في مهام التطوير الروتينية، وإنشاء التعليمات البرمجية، وإدارة سير عمل git. يوفر وضع الخطة الأمان للعمليات المعقدة. يوسع التكامل مع بيئات التطوير المتكاملة إمكانيات ما وراء الترمينال.

ابدأ بمهام بسيطة لفهم كيفية تفسير Claude Code للطلبات. قم بالبناء تدريجيًا إلى سير عمل أكثر تعقيدًا مع نمو الألفة. استخدم الأمر /clear بين المهام المميزة للحفاظ على سياق نظيف. قم بتكوين ملفات CLAUDE.md للحصول على إرشادات خاصة بالمشروع.

يمكن للفرق استكشاف الإعدادات التي يديرها الخادم وأسواق الإضافات. يمكن للمطورين الأفراد الاستفادة من المهارات والأوامر المخصصة المصممة لأنماط متكررة.

يحتوي مستودع GitHub على anthropics/claude-code على أمثلة إضافية، وإضافات مجتمعية، وموارد استكشاف الأخطاء وإصلاحها. يوفر التوثيق الرسمي على docs.anthropic.com مراجع تقنية شاملة.

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