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

على عكس Cursor (الذي يعمل داخل IDE) أو Codex (الذي يعمل في السحابة)، يعمل Claude Code محليًا في بيئة التطوير الفعلية الخاصة بك. يرى ملفاتك، وسجل git الخاص بك، وإخراج الطرفية. هذا يجعله أسرع للعديد من سير العمل لأنه لا يوجد تبديل سياق بين الذكاء الاصطناعي وكودك.

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

Tool Best For Where it runs Workflow
Claude Codeالبرمجة التفاعلية الوكيليةالطرفية المحليةأنت توجه + ينفذ الخطوات مباشرة
Cursorالبرمجة اليومية + التعديلات الداخليةداخل IDEفروق مرئية + الإكمال التلقائي
Codexالمهام المفوضة غير المتزامنةساندبوكس سحابيتقديم المهمة → مراجعة PR لاحقًا

كيفية تثبيت Claude Code

تحتاج إلى Node.js 18+ وحساب Claude (Pro أو API).

الخطوة 1: قم بالتثبيت عالميًا عبر npm:

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

الخطوة 2: انتقل إلى مجلد مشروعك:

cd your-project

الخطوة 3: شغّل Claude Code:

claude

عند تشغيله لأول مرة، سيطلب منك التحقق من الهوية بحساب Anthropic الخاص بك. إذا كنت تستخدم Claude Pro (20 دولار/شهر)، تحصل على بدل رموز سخي. أما إذا كنت على API، فستدفع مقابل الرمز (تحقق من الأسعار الحالية في دليل حدود الأسعار).

تقدير التكلفة (حتى لا تتفاجأ)

إذا كنت على فوترة API، فجلسة نمطية مدتها 30-60 دقيقة على مستودع متوسط غالبًا ما تكون 2-10 دولارات حسب النموذج + عدد التكرارات. استخدم /cost بانتظام، وتحقق من الجلسات الطويلة باستخدام حاسبة تكلفة Vibe Coding.

أول 5 دقائق مع Claude Code

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

اطلب منه الاستكشاف: اكتب "ما هذا المشروع؟ أعطني نظرة عامة عالية المستوى." يقرأ Claude الملفات الرئيسية (package.json، README، نقاط الدخول الرئيسية) ويُلخص ما يجده. هذه طريقة جيدة للتحقق من فهمه لهيكل مشروعك.

اطلب منه العثور على شيء: "أين منطق المصادقة؟" يبحث Claude في قاعدة الكود الخاصة بك ويشير إلى الملفات ذات الصلة. يفهم هيكل الكود، لا مجرد مطابقة النصوص.

اطلب منه تغيير شيء: "أضف التحقق من صحة الإدخال إلى نموذج التسجيل. يجب أن يكون البريد الإلكتروني بتنسيق صالح، كلمة المرور الحد الأدنى 8 أحرف." يحدد Claude مكون النموذج، يكتب منطق التحقق، ويعرض الفروق قبل تطبيقه.

الفكرة الرئيسية: يعمل Claude Code على ملفاتك الفعلية. عندما يقوم بتغيير، يكون التغيير حقيقيًا — يتم تعديل ملفاتك على القرص. يمكنك رؤية التغييرات في محررك، تشغيل الاختبارات، وحفظها عاديًا.

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

يحتوي Claude Code على عدة أوامر slash التي تتحكم في سلوكه:

الأمر ما يفعله متى تستخدمه
/initينشئ ملف CLAUDE.md في جذر المشروعقبل أول مهمة جدية في المستودع
/compactيضغط تاريخ المحادثة عند الاقتراب من حدود السياقجلسات طويلة؛ قبل انخفاض الجودة
/costيعرض الرموز المستخدمة + التكلفة المقدرةفوترة API، تتبع الميزانية
/clearيُعيد تعيين المحادثة مع الحفاظ على السياقالتبديل بين مهام غير مترابطة

هل تحصل على قيمة من هذا؟ ننشر أدلة أسبوعية حول أدوات وتدفقات عمل البرمجة بالذكاء الاصطناعي. احصل عليها في بريدك الإلكتروني →

ملف CLAUDE.md — سياق الذكاء الاصطناعي لمشروعك

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

يحتوي CLAUDE.md الجيد على:

نظرة عامة على المشروع: ما يفعله المشروع، مكدس التقنيات، والهيكل في 3-5 جمل.

اتفاقيات الكود: تفضيلات التنسيق، اتفاقيات التسمية، والأنماط المتبعة. "استخدم المكونات الوظيفية مع hooks. فضل التصدير المسمى. استخدم Tailwind للتصميم."

الملفات الرئيسية: أشر إلى الملفات الأكثر أهمية التي يجب أن يفهمها Claude. "نماذج البيانات الرئيسية في lib/models/. مسارات API في app/api/."

الأشياء الممنوعة: "لا تعدل ملفات هجرة قاعدة البيانات. لا تغير أي شيء في vendor/. شغل الاختبارات دائمًا بعد تعديل ملفات api/."

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

سير عمل حقيقي: بناء ميزة

إليك كيف أستخدم Claude Code في جلسة تطوير ميزة نمطية:

1. ابدأ بالهدف: "أضف محدد معدل إلى API. استخدم Redis. طبق على نقطة /api/submit بحد 10 طلبات في الدقيقة لكل IP."

2. دع Claude يخطط: يقرأ كود API الحالي، يتحقق إذا كان Redis مُهيأ بالفعل، ويقترح نهجًا. راجع الخطة قبل أن يبدأ البرمجة.

3. شاهد عمله: ينشئ Claude وحدة محدد المعدل، يدمجها في مسار API، يضيف متغيرات بيئية لاتصال Redis، ويكتب اختبارًا.

4. اختبر: يشغل Claude الاختبارات. إذا فشل شيء، يقرأ الخطأ، يعدل الكود، ويحاول مرة أخرى. هذه حلقة التكرار هي حيث يتألق الوكلاء — يتعامل مع دورة التصحيح التي تأخذ عادةً عدة جولات عمل يدوي.

5. راجع وحفظ: تحقق من الفروق. أجرِ أي تعديلات. احفظ. يمكن لـ Claude كتابة رسالة الـ commit أيضًا إذا طلبت.

لميزة مثل هذه، يوفر Claude Code عادةً 60-70% من الوقت مقارنة بالكتابة يدويًا. التوفير الحقيقي في الـ boilerplate، كود التكامل، وكتابة الاختبارات — الأجزاء المملة لكن غير التحدي الفكري.

Try it yourself

Paste any prompt and get a better version in seconds.

Open Prompt Optimizer — Free →

إدارة استخدام التوكنات

يستخدم Claude Code التوكنات لكل تفاعل. الجلسات الطويلة على قواعد كود كبيرة يمكن أن تكون مكلفة في فوترة API. إليك العادات التي تحافظ على التكاليف معقولة:

استخدم /compact بانتظام. لا تنتظر حتى يمتلئ السياق. اضغط بعد إكمال كل مهمة مميزة.

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

استخدم /clear بين المهام غير المترابطة. إذا كنت تعمل على الواجهة الأمامية ثم تنتقل إلى هجرات قاعدة البيانات، أفرغ السياق. السياق القديم يهدر التوكنات ويمكن أن يربك النموذج.

تحقق /cost كثيرًا. حدد ميزانية ذهنية لكل جلسة وتحقق منها. جلسة ميزة مدتها 30 دقيقة تكلف 2-8 دولارات في فوترة API.

للمقارنة التفصيلية للتكاليف بين Claude Code وCursor، انظر مقارنة التكاليف الحقيقية بعد 30 يومًا.

Claude Code مقابل Cursor مقابل Codex

دليل قرار سريع:

الخيار الأفضل عندما... التسوية
Claude Codeتريد تغييرات تفاعلية على مستوى الـ repo محليًايحتاج مراجعة دقيقة (يعدل الملفات الحقيقية)
Cursorتريد الذكاء الاصطناعي داخل IDE الخاص بك + حلقة تعديل محكمةأقل استقلالية بدون تدخل مقارنة بـ terminal agents
Codexتريد تفويضًا غير متزامن قائم على PRأقل تفاعلية؛ السياق قد يضعف

Claude Code: الأفضل للمطورين الذين يريدون سياقًا كاملاً للمشروع وعمليات terminal أصلية. تفاعلي، في الوقت الفعلي، يعمل على ملفاتك الحقيقية. الأفضل للميزات المعقدة، إعادة الهيكلة، والتصحيح.

Cursor: الأفضل للمطورين الذين يريدون الذكاء الاصطناعي داخل IDE الخاص بهم. شاهد التغييرات في الوقت الفعلي مع diffs داخلية. الأفضل للبرمجة اليومية مع اقتراحات الذكاء الاصطناعي. المقارنة الكاملة هنا.

Codex: الأفضل للفرق التي تريد مهام برمجة غير متزامنة ومجموعات. أرسل المهمة، راجع PR لاحقًا. الأفضل للمهام المحددة جيدًا التي تريد تفويضها كليًا. المقارنة الكاملة هنا.

يستخدم العديد من المطورين اثنين أو أكثر. Claude Code للميزات المعقدة، Cursor للتعديل اليومي، Codex للمهام المجموعية.

تريد تحسين الـ prompts الخاصة بك لأي أداة برمجة ذكاء اصطناعي؟ The Prompt Optimizer يساعدك في ترتيب الطلبات لإخراج أوضح وأكثر تحديدًا.

تريد المزيد مثل هذا؟ ننشر أسبوعيًا عن أدوات برمجة الذكاء الاصطناعي وعمليات المطورين. اشترك مجانًا →

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

هل يعمل Claude Code على Windows؟

نعم، عبر WSL (نظام ويندوز للينكس الفرعي)، PowerShell، أو موجه الأوامر. يوفر WSL أفضل تجربة لأن العديد من أدوات التطوير أصلية للينكس.

هل يمكن لـ Claude Code الوصول إلى الإنترنت؟

Claude Code نفسه لا يتصفح الويب، لكنه يمكن أن يشغل أوامر تفعل ذلك — curl، npm install، git clone. كما يمكنه استخدام خوادم MCP للوصول إلى خدمات خارجية مثل GitHub، قواعد البيانات، وAPIs.

كيف يتعامل Claude Code مع قواعد الكود الكبيرة؟

نافذة سياق Claude بـ 200K توكن تعني أنه يمكنه تحميل ومعالجة آلاف الملفات المصدرية في وقت واحد. للمستودعات الكبيرة جدًا، يقرأ الملفات ذات الصلة بشكل انتقائي بدلاً من تحميل كل شيء. ملف CLAUDE.md يساعده على معرفة أي أجزاء من قاعدة الكود مهمة لكل مهمة.

هل يُرسل كودي إلى خوادم Anthropic؟

نعم، يُرسل كودك إلى API Anthropic للمعالجة. لا يدرب Anthropic على المدخلات API افتراضيًا، لكن تحقق من الشروط الحالية إذا كنت تعمل مع كود حساس أو خاص. فكر في استخدام API مع تعطيل الاحتفاظ بالبيانات لأقصى خصوصية.

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