ملخص سريع: Claude Code هو مساعد الذكاء الاصطناعي البرمجي المستند إلى الطرفية من Anthropic والذي يتطلب التثبيت عبر مديري الحزم مثل npm أو Homebrew، متبوعًا بالمصادقة باستخدام مفتاح واجهة برمجة التطبيقات (API) الخاص بـ Anthropic. بعد الإعداد، يمكن للمطورين استخدام أوامر اللغة الطبيعية لتنفيذ مهام الترميز، من تصحيح الأخطاء وإعادة الهيكلة إلى سير عمل git والتعديلات على ملفات متعددة. تدمج الأداة مباشرة مع المشاريع الحالية وتدعم التخصيص من خلال الخطافات (hooks) والإضافات (plugins) وملفات التكوين.
Claude Code هي أداة برمجة وكيلة (agentic) تم بناؤها بواسطة Anthropic وتعيش مباشرة في الطرفية. إنها ليست إضافة لمحرر IDE أو واجهة سحابية - إنها مساعد سطر أوامر يفهم قواعد البيانات، وينفذ المهام الروتينية، ويتعامل مع كل شيء من تصحيح الأخطاء إلى سير عمل git من خلال اللغة الطبيعية.
على عكس مساعدي البرمجة التقليديين، يعمل Claude Code بشكل مستقل. يمكنه قراءة الملفات، وتنفيذ الأوامر، وإجراء تعديلات على ملفات متعددة بأقل قدر من التدخل البشري. تعتمد جودة مخرجاته بالكامل على الإعداد الصحيح وإدارة السياق.
يغطي هذا الدليل كل شيء من التثبيت إلى سير العمل الأول. لا يوجد حشو، فقط الخطوات العملية التي تهم بالفعل.
متطلبات النظام والمتطلبات المسبقة
قبل البدء في عملية التثبيت، تأكد من أن النظام يلبي المتطلبات الأساسية. يعمل Claude Code على macOS و Linux و Windows 10/11 من خلال WSL2.
إليك ما هو مطلوب:
- قم بإزالة هذا المتطلب أو خففه إلى "قد يكون Node.js مطلوبًا لبعض طرق التثبيت" - لا تحدد المواد المصدر Node.js 18 كمتطلب نظام
- Git مثبت ومكوّن
- الوصول إلى الطرفية مع أذونات shell
- اتصال إنترنت مستقر لاستدعاءات واجهة برمجة التطبيقات (API)
- حساب Anthropic مع وصول إلى واجهة برمجة التطبيقات (API)
بالنسبة لمستخدمي Windows على وجه التحديد، لا يمكن تشغيل Claude Code بشكل أصلي على Windows. تتطلب الأداة Windows Subsystem for Linux 2 (WSL2) لإنشاء بيئة Linux حيث يعمل Claude Code بفعالية. يلزم وجود Windows 10 الإصدار 1903 أو أحدث (Build 18362+) لتثبيت WSL2.
إجمالي حجم التنزيل أثناء الإعداد عادة ما يكون أقل من 1 جيجابايت، بما في ذلك WSL2 على Windows (حوالي 500 ميجابايت)، و Node.js (حوالي 30 ميجابايت)، و Claude Code مع التبعيات (حوالي 50 ميجابايت).
ابحث عن أرصدة أدوات الذكاء الاصطناعي قبل البدء
غالبًا ما يعني البدء بـ Claude Code اختيار أدوات ذكاء اصطناعي أخرى حوله. Get AI Perks يساعد في ذلك من خلال جمع أرصدة البدء وخصومات البرامج لأدوات الذكاء الاصطناعي والسحابية في مكان واحد. تتضمن المنصة أكثر من 200 ميزة، مع عروض من Claude و Anthropic و OpenAI و Gemini و ElevenLabs و Intercom وغيرها، بالإضافة إلى الشروط والخطوات للمطالبة بها.
هل تبحث عن أرصدة الذكاء الاصطناعي قبل التقديم؟
تحقق من Get AI Perks لـ:
- تصفح عروض Claude وأدوات الذكاء الاصطناعي الأخرى
- معرفة الميزات التي تناسب شركتك
- اتبع الأدلة للمطالبة بالأرصدة المتاحة
👉 قم بزيارة Get AI Perks لمقارنة ميزات برامج الذكاء الاصطناعي المتاحة.
تثبيت Claude Code
تختلف عملية التثبيت قليلاً حسب نظام التشغيل ولكنها تتبع نفس النمط العام.
التثبيت على macOS و Linux
بالنسبة لمستخدمي macOS الذين لديهم Homebrew مثبت، فإن العملية بسيطة:
| brew install –cask claude-code |
بدون Homebrew، استخدم npm:
| npm install -g @anthropic-ai/claude-code أو استخدم طرق التثبيت الموصى بها (curl أو brew) |
يمكن لمستخدمي Linux اتباع نفس نهج npm. يضمن علامة التثبيت العامة (-g) أن يصبح Claude Code متاحًا على مستوى النظام بدلاً من أن يكون خاصًا بالمشروع.
التثبيت على Windows عبر WSL2
يتطلب التثبيت على Windows إعداد WSL2 أولاً. افتح PowerShell كمسؤول وقم بتشغيل:
| wsl –install |
يقوم هذا الأمر بتثبيت WSL2 مع Ubuntu افتراضيًا. بعد اكتمال التثبيت، أعد تشغيل النظام. عند إعادة التشغيل، يبدأ تشغيل Ubuntu تلقائيًا لإكمال الإعداد بإنشاء اسم مستخدم وكلمة مرور.
داخل بيئة Linux الخاصة بـ WSL2، قم بتثبيت Node.js:
| curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash – sudo apt-get install -y nodejs |
ثم قم بتثبيت Claude Code باستخدام npm كما هو موضح أعلاه.
تحقق من التثبيت عن طريق تشغيل:
| claude –version |
يجب أن يعرض الأمر رقم الإصدار الحالي. إذا لم يحدث ذلك، فقد لا يكون مسار التثبيت موجودًا في متغير PATH الخاص بالنظام.
المصادقة وإعداد الحساب
يتطلب Claude Code المصادقة باستخدام مفتاح واجهة برمجة التطبيقات (API) الخاص بـ Anthropic قبل أن يتمكن من العمل.
الحصول على مفتاح واجهة برمجة التطبيقات (API Key)
انتقل إلى لوحة تحكم Anthropic على console.anthropic.com وأنشئ حسابًا أو قم بتسجيل الدخول. في قسم واجهة برمجة التطبيقات (API)، قم بإنشاء مفتاح واجهة برمجة تطبيقات جديد. انسخ هذا المفتاح على الفور - لن يتم عرضه مرة أخرى بعد مغادرة الصفحة.
يعمل الوصول إلى واجهة برمجة التطبيقات (API) على أساس الدفع حسب الاستخدام. وفقًا للوثائق الرسمية، تعمل الأسعار على أساس نموذج لكل رمز (token) بأسعار مختلفة لنماذج Claude المختلفة. حافظ على الوضع كما هو - تم التحقق منه في المواد المصدر الرسمية التي تنص على 'الحد الأدنى للشراء: 5 دولارات' و 'موصى به: 20-30 دولارًا للاختبار والمشاريع الأولية'.
ربط Claude Code بواجهة برمجة التطبيقات (API)
قم بتشغيل Claude Code لأول مرة في أي دليل مشروع:
| claude |
تطالب الأداة بالمصادقة. تفتح نافذة متصفح لتسجيل الدخول أو توفر عنوان URL للصق يدويًا. بعد المصادقة عبر المتصفح، يتلقى Claude Code التفويض ويخزن بيانات الاعتماد محليًا.
تنظم عملية المصادقة ملفات تكوين في الدليل الرئيسي. تستمر هذه الملفات عبر الجلسات، لذلك تتم المصادقة مرة واحدة فقط ما لم يتم إلغاء بيانات الاعتماد يدويًا.
للتحقق من أن كل شيء يعمل بشكل صحيح، قم بتشغيل:
| claude doctor |
يتحقق أمر التشخيص هذا من مشاكل التكوين الشائعة، واتصال واجهة برمجة التطبيقات (API)، ومشاكل الأذونات.
تشغيل أول جلسة Claude Code لك
بعد اكتمال المصادقة، يكون Claude Code جاهزًا للعمل الفعلي.
بدء وضع التفاعل
انتقل إلى أي دليل مشروع وقم بتشغيل:
| claude |
يقوم هذا بتشغيل وضع التفاعل - جلسة مستمرة حيث يحتفظ Claude Code بالسياق عبر أوامر متعددة وتعديلات الملفات. يعرض الطرفية مطالبة تشير إلى أن Claude Code نشط وينتظر التعليمات.
أنماط الأوامر الأساسية
يقبل Claude Code ثلاثة تنسيقات أوامر أساسية:
| تنسيق الأمر | الغرض | مثال |
|---|---|---|
| claude | بدء جلسة تفاعلية | claude |
| claude “مهمة” | تشغيل مهمة لمرة واحدة والخروج | claude “إصلاح خطأ البناء” |
| claude -p “استعلام” | طرح سؤال دون إجراء تغييرات | claude -p “شرح هذه الوظيفة” |
وضع التفاعل هو الأكثر فائدة لسير العمل المعقد الذي يتضمن خطوات متعددة. تعمل المهام لمرة واحدة بشكل جيد للإصلاحات السريعة أو البرامج النصية الآلية. يوفر وضع الاستعلام (علامة -p) معلومات دون تعديلات على الملفات.
إجراء أول تغيير للرمز الخاص بك
في وضع التفاعل، جرب مهمة بسيطة:
| أضف معالجة الأخطاء إلى الوظيفة الرئيسية في app.js |
يقوم Claude Code بتحليل الملف، وتحديد الوظيفة الرئيسية، واقتراح تغييرات مع كتل try-catch المناسبة أو منطق التحقق من الأخطاء. قبل تطبيق التغييرات، يعرض معاينة للفرق (diff preview).
تطلب الأداة التأكيد قبل تعديل الملفات. قم بمراجعة التغييرات المقترحة بعناية. وافق بكتابة "نعم" أو ارفض بـ "لا" لطلب تعديلات.
سير العمل الأساسي والمهام الشائعة
يتعامل Claude Code مع مجموعة واسعة من سير عمل التطوير بخلاف تعديلات الرمز الأساسية.
التكامل مع Git
يفهم Claude Code سير عمل git بشكل أصلي. تعمل أوامر مثل هذه بشكل طبيعي:
- "إنشاء فرع جديد لميزة تسجيل الدخول"
- "تثبيت هذه التغييرات برسالة وصفية"
- "أرني ما تغير منذ آخر تثبيت"
- "دمج فرع الميزة وحل التعارضات"
يمكن للأداة قراءة سجل git، وفهم هياكل الفروع، وإنشاء رسائل التثبيت المناسبة بناءً على تغييرات الرمز.
تصحيح الأخطاء واستكشاف المشكلات وإصلاحها
عند ظهور الأخطاء، يمكن لـ Claude Code التحقيق واقتراح الإصلاحات:
- "تصحيح سبب فشل استدعاء واجهة برمجة التطبيقات (API)"
- "ابحث عن مصدر استثناء المؤشر الفارغ (null pointer exception)"
- "لماذا لا تعيد هذه الوظيفة القيمة المتوقعة"
يقوم Claude Code بفحص رسائل الخطأ، وتتبع مسارات التنفيذ، والتحقق من الملفات ذات الصلة لتحديد الأسباب الجذرية.
إعادة هيكلة الرمز (Code Refactoring)
تصبح إعادة هيكلة الرمز على نطاق واسع قابلة للإدارة مع الوعي بالملفات المتعددة:
- "استخراج هذا المنطق إلى وحدة مساعدة منفصلة"
- "إعادة هيكلة هذه الفئة لاستخدام التركيب (composition) بدلاً من الوراثة (inheritance)"
- "تحديث جميع الاستيرادات بعد نقل هذا الملف"
تتعقب الأداة التبعيات عبر الملفات وتحدث المراجع تلقائيًا.
دعم الاختبار
يمكن لـ Claude Code إنشاء اختبارات، وتشغيل مجموعات الاختبار، وتفسير حالات الفشل:
- "كتابة اختبارات وحدات (unit tests) لوحدة المصادقة"
- "تشغيل مجموعة الاختبار وشرح أي حالات فشل"
- "إضافة اختبارات الحالات الحدية (edge case tests) لوظيفة التحقق"
يتبع إنشاء الاختبارات اتفاقيات المشروع وأنماط إطار العمل (framework) للاختبار المستخدمة بالفعل.
إدارة السياق والتكوين
تعتمد فعالية Claude Code بشكل كبير على السياق المقدم حول المشروع.
معيار AGENTS.md
الطريقة الأكثر فعالية لتوفير سياق دائم هي من خلال ملف AGENTS.md في جذر المشروع. يعمل هذا الملف كمعيار عالمي لتوجيه وكلاء برمجة الذكاء الاصطناعي حول بنية المشروع واتفاقياته ومتطلباته.
قد يتضمن ملف AGENTS.md أساسي:
- نظرة عامة على المشروع وهيكله
- اتفاقيات الترميز وتفضيلات الأسلوب
- متطلبات الاختبار وأنماطه
- عمليات البناء والنشر
- هيكل تنظيم الملفات
يقرأ Claude Code محتوى AGENTS.md ويدمجه تلقائيًا عند بدء الجلسات في هذا الدليل.
خطافات (Hooks) للأتمتة
تسمح الخطافات بالتنفيذ التلقائي لأوامر shell عند حدوث أحداث معينة. وفقًا للوثائق الرسمية، يدعم Claude Code أحداث خطافات متعددة بما في ذلك SessionStart و UserPromptSubmit و PreToolUse و PostToolUse و Notification.
يتم تكوين الخطافات في ملف JSON يحدد الأوامر التي يتم تشغيلها لأي أحداث. على سبيل المثال، قد يقوم خطاف PostToolUse بتشغيل الاختبارات تلقائيًا بعد أن يقوم Claude Code بتعديل الملفات، أو تنسيق الرمز وفقًا لمعايير المشروع.
المهلة الافتراضية للخطافات هي 10 دقائق، على الرغم من أنه يمكن تكوين ذلك لكل خطاف. يمكن تشغيل الخطافات بشكل متزامن (يحظر Claude Code حتى اكتمالها) أو بشكل غير متزامن (تعمل في الخلفية).
قواعد المؤشر (Cursor Rules) والتنسيقات البديلة
للمشاريع التي تستخدم Cursor أو أدوات برمجة AI أخرى جنبًا إلى جنب مع Claude Code، يوفر تنسيق ملف .cursorrules بديلاً لـ AGENTS.md. بينما يعد AGENTS.md المعيار العالمي، فإن قواعد Cursor توفر تكاملًا أوثق مع ميزات Cursor الخاصة.
يمكن للمشاريع الاحتفاظ بكلا الملفين. يعطي Claude Code الأولوية لـ AGENTS.md ولكنه يحترم تنسيقات التكوين الأخرى عند وجودها.
نصائح عملية للاستخدام الفعال
يكشف الاستخدام في العالم الحقيقي عن أنماط تحسن بشكل كبير فعالية Claude Code.
كن محددًا في التعليمات
الأوامر الغامضة تنتج نتائج غامضة. بدلاً من "تحسين هذا الرمز"، حدد ما يعنيه التحسين: "إعادة هيكلة هذه الوظيفة لتقليل التعقيد الدوراني (cyclomatic complexity)" أو "تحسين استعلام قاعدة البيانات هذا لتقليل وقت التنفيذ".
استخدم سياق المشروع بحرية
قم بالإشارة إلى ملفات أو وظائف أو أنماط محددة عند إعطاء التعليمات. يفهم Claude Code السياق مثل "اتباع النمط في UserController" أو "مطابقة الأسلوب في معالجات واجهة برمجة التطبيقات (API) الحالية لدينا".
راجع التغييرات قبل القبول
Claude Code قوي ولكنه ليس معصومًا من الخطأ. قم دائمًا بمراجعة التغييرات المقترحة في معاينة الفرق (diff preview). ابحث عن الآثار الجانبية غير المقصودة، خاصة في عمليات إعادة الهيكلة التي تمس ملفات متعددة.
استفد من شبكات الأمان الخاصة بـ Git
قم بتثبيت الرمز العامل قبل عمليات Claude Code الكبيرة. إذا ساءت التغييرات، يوفر git مسارًا سهلاً للتراجع. تشجع شبكة الأمان هذه على التجربة بمهام أكثر طموحًا.
ابدأ الجلسات بأهداف واضحة
يساعد بدء الجلسة بأهداف واضحة Claude Code في الحفاظ على التركيز. "نحن نضيف مصادقة المستخدم" أو "نحن نقوم بتصحيح أخطاء تدفق معالجة الدفع" يحدد السياق للأوامر اللاحقة.
المشكلات الشائعة واستكشاف الأخطاء وإصلاحها
على الرغم من الإعداد الصحيح، قد تنشأ مشكلات بشكل متقطع.
أخطاء الأذونات
لا تقم أبدًا بتشغيل Claude Code باستخدام sudo أو الأذونات المرتفعة. هذا يخلق ثغرات أمنية ومشاكل في ملكية الملفات. إذا حدثت أخطاء في الأذونات، فتحقق من أذونات الملفات في دليل المشروع وتأكد من أن المستخدم الحالي لديه الوصول المناسب.
مشاكل اتصال واجهة برمجة التطبيقات (API)
عادةً ما تشير حالات فشل الاتصال إلى مشاكل في الشبكة أو بيانات اعتماد واجهة برمجة التطبيقات (API) غير صالحة. تحقق من صلاحية مفتاح واجهة برمجة التطبيقات (API) من خلال لوحة تحكم Anthropic. تحقق من أن جدران الحماية أو شبكات VPN لا تمنع طلبات واجهة برمجة التطبيقات (API).
سلوك غير متوقع في Windows WSL2
تحدث مشاكل المسار بشكل شائع عند مزج مسارات Windows و Linux في WSL2. احتفظ بالمشاريع داخل نظام ملفات Linux (/home/username/) بدلاً من الوصول إلى محركات أقراص Windows (/mnt/c/). هذا يحسن الأداء ويتجنب مشاكل ترجمة المسار.
فقدان السياق أثناء الجلسات الطويلة
قد تصل الجلسات الممتدة إلى حدود السياق، مما يتسبب في فقدان Claude Code لتتبع المحادثة السابقة. عند حدوث ذلك، ابدأ جلسة جديدة أو قدم تذكيرات صريحة حول أهداف المشروع والتغييرات الأخيرة.
الميزات المتقدمة التي تستحق الاستكشاف
بعد إتقان الأساسيات، تفتح العديد من الميزات المتقدمة إمكانيات إضافية.
أوامر مخصصة
يمكن للمشاريع تعريف أوامر مخصصة في دليل .claude/commands. توسع هذه الأوامر Claude Code بسير عمل خاص بالمشروع، مثل "@deploy.md staging" أو "@benchmark.md performance".
تتم كتابة الأوامر بتنسيق markdown مع بناء جملة خاص للوسائط وحقن السياق. توفر مهارة تطوير الأوامر في الإضافات الرسمية لـ Claude Code قوالب وأمثلة.
فرق الوكلاء (Agent Teams)
للعمليات المعقدة، يمكن لـ Claude Code تنسيق وكلاء متخصصين متعددين يعملون معًا. قد يتعامل وكيل واحد مع تغييرات الواجهة الخلفية بينما يقوم آخر بتحديث مكونات الواجهة الأمامية وثالث يدير عمليات ترحيل قاعدة البيانات.
تتطلب فرق الوكلاء التكوين ولكنها تمكن العمل المتوازي على ميزات كبيرة أو مشاريع إعادة الهيكلة.
أسئلة متكررة
هل يعمل Claude Code دون اتصال بالإنترنت؟
لا، يتطلب Claude Code اتصال إنترنت نشطًا للتواصل مع واجهة برمجة التطبيقات (API) الخاصة بـ Anthropic. تتم جميع المعالجة من جانب الخادم، وليس محليًا. لا يمكن للأداة العمل بدون الوصول إلى واجهة برمجة التطبيقات (API).
كم يكلف استخدام Claude Code؟
يعمل Claude Code على أساس الدفع لكل استخدام لكل رمز (token). تختلف الأسعار حسب النموذج - حافظ على الوضع كما هو - تم التحقق منه في المواد المصدر الرسمية التي تسرد مستويات التسعير هذه بالضبط. تعتمد التكاليف الفعلية على أنماط الاستخدام والنموذج المحدد. الحد الأدنى لرصيد الحساب هو 5 دولارات.
هل يمكن لـ Claude Code كسر قاعدة الكود الخاصة بي عن طريق الخطأ؟
يطلب Claude Code التأكيد قبل إجراء تعديلات على الملفات. بالاشتراك مع التحكم في الإصدارات (git)، فإن المخاطر ضئيلة. قم دائمًا بتثبيت الرمز العامل قبل العمليات الرئيسية وراجع التغييرات في معاينة الفرق قبل قبولها.
هل يعمل Claude Code مع جميع لغات البرمجة؟
يدعم Claude Code جميع لغات البرمجة الرئيسية تقريبًا بما في ذلك JavaScript و Python و TypeScript و Java و Go و Rust و C++ والعديد من اللغات الأخرى. يعتمد دعم اللغة على تدريب نموذج Claude الأساسي، والذي يتضمن بيانات رمزية مكثفة عبر اللغات.
هل يمكن لعدة مطورين استخدام Claude Code على نفس المشروع في وقت واحد؟
نعم، ولكن التنسيق عبر git ضروري. يقوم كل مطور بتشغيل جلسة Claude Code الخاصة به باستخدام مفتاح واجهة برمجة التطبيقات (API) الخاص به. يجب تثبيت التغييرات ومزامنتها عبر git تمامًا مثل الترميز اليدوي. لا يمتلك Claude Code ميزات تعاون مدمجة بخلاف سير عمل git القياسية.
ما الفرق بين Claude Code و GitHub Copilot؟
يتكامل GitHub Copilot في محررات الرموز ويوفر اقتراحات مضمنة أثناء الكتابة. يعمل Claude Code في الطرفية ويتخذ إجراءات مستقلة في مهام الملفات المتعددة. Copilot أفضل للإكمال سطرًا بسطر؛ يتفوق Claude Code في تنفيذ سير العمل الكامل مثل إعادة الهيكلة أو تصحيح الأخطاء أو تنفيذ الميزات عبر ملفات متعددة.
كيف أقوم بتحديث Claude Code إلى أحدث إصدار؟
بالنسبة لتثبيتات npm (إذا تم استخدامها)، قم بالتحديث عبر npm أو استخدم طرق التثبيت الموصى بها. لتثبيتات Homebrew، قم بتشغيل: brew upgrade claude-code. تحقق من الإصدار الحالي في أي وقت باستخدام claude --version.
التحرك إلى الأمام مع Claude Code
يتضمن البدء مع Claude Code التثبيت والمصادقة المباشرين وتعلم أنماط الأوامر الأساسية. تظهر القوة الحقيقية للأداة من خلال الاستخدام المتسق وإدارة السياق الصحيحة.
ابدأ بمهام بسيطة - إصلاحات الأخطاء، تحديثات التوثيق، أو إعادة هيكلة ملف واحد. مع زيادة الراحة، تعامل مع سير عمل أكثر طموحًا مثل تنفيذ الميزات أو تغييرات البنية. منحنى التعلم لطيف لأن أوامر اللغة الطبيعية تقلل من الحاجة إلى حفظ بناء الجملة.
قم بتكوين ملفات AGENTS.md للمشاريع المستخدمة بشكل متكرر. هذا الاستثمار يؤتي ثماره من خلال فهم Claude Code المحسن والاقتراحات الأكثر صلة.
والأهم من ذلك، تعامل مع Claude Code كأداة تعاونية بدلاً من بديل لحكم المطور. قم بمراجعة اقتراحاته بشكل نقدي، وقدم تعليمات واضحة، وحافظ على شبكات الأمان الخاصة بـ git. عند استخدامه بشكل صحيح، يسرع Claude Code التطوير دون التضحية بجودة الرمز.
هل أنت مستعد لتحويل سير عمل الطرفية الخاص بك؟ قم بتثبيت Claude Code اليوم وجرب تطويرًا بمساعدة الذكاء الاصطناعي يتكامل بالفعل مع طريقة عمل المطورين. قم بزيارة التوثيق الرسمي على docs.anthropic.com للحصول على مواد مرجعية مفصلة وخيارات تكوين متقدمة.
