في الفصل السابق قسّمنا أدوات البرمجة بالذكاء الاصطناعي إلى ثلاثة أنواع، واخترنا من بينها Claude Code ― الذي يمكن أن تُوكِل إليه جزءاً كبيراً من التنفيذ ― بطلاً لهذه الدورة. في هذا الفصل نبدأ العمل فعلياً. نتتبّع بعناية سلسلة الخطوات التثبيت ← التشغيل ← تسجيل الدخول ← أول تعليمة ← اعتماد الفروق، ونتوقّف عند كل نقطة قد تتعثّر عندها، حتى يبدأ Claude Code بالعمل في طرفيتك.
الهدف: «كلّف Claude Code بأول عمل له في بيئتك»
ما Claude Code (مراجعة الفصل السابق)
باختصار مجدداً، Claude Code هو «وكيل سطر أوامر» من إنتاج Anthropic. بدلاً من نسخ الشيفرة ولصقها في محادثة المتصفح، فإنه يقرأ ملفات مشروعك ويعيد كتابتها وينفّذ الأوامر ويجري الاختبارات مباشرةً داخل طرفيتك. يكفي أن تقول «أريد كذا» بلغتك، فيضع الذكاء الاصطناعي خطته بنفسه ويمضي في العمل عبر عدة ملفات. إنه حقاً رفيق يجلس إلى جوارك ويعمل معك.
📖 مصدران رسميان تقرؤهما أولاً. خطوات هذا الفصل دليل للبدء. أما متطلبات النظام الدقيقة وأحدث طرق التثبيت وخطط الأسعار فتأكّد منها دائماً من المصدر الأصلي ― احفظ في المفضّلة الوثائق الرسمية code.claude.com/docs وصفحة المنتج anthropic.com/claude-code، فسيفيدانك طوال الطريق.
التثبيت ― Install
يُثبَّت Claude Code ويُستخدم في بيئة Node.js. لا يتطلّب الأمر تجهيزات صعبة. لنُعِدّ أولاً المتطلبين الأساسيين.
القاعدة التي يعمل عليها Claude Code. إن لم يكن لديك بعد، فثبّت نسخة LTS من الموقع الرسمي nodejs.org. للتأكد من وجوده، اكتب node -v فإن ظهرت النسخة فكل شيء على ما يرام.
الشاشة التي تكتب فيها الأوامر. على macOS هي «Terminal»، وعلى Windows هي «PowerShell» أو WSL، وعلى Linux الطرفية القياسية. يكفي أن تُتقن العمليات الأساسية التي أشرنا إليها في الفصل السابق.
حين يكتمل الاستعداد، اكتب في الطرفية الأمر التالي في سطر واحد. كل ما في الأمر أنك تستخدم npm (أداة إدارة الحزم المرفقة مع Node.js) لتثبيت Claude Code بحيث يُستخدم على مستوى الطرفية كلها.
npm install -g @anthropic-ai/claude-code
تعني -g «ثبّته عالمياً (أي بحيث يمكن استدعاؤه من أي مجلد)». حين يكتمل، شغّله بالأمر التالي.
claude
⚠️ إن ظهر claude: command not found. نجح التثبيت لكن الأمر لا يُتعرَّف عليه ― هذا من أكثر ما يتعثّر عنده المبتدئ أول مرة. السبب غالباً إعداد مسار Node.js/npm، والحل معروف. جمعنا طرق الإصلاح لكل نظام تشغيل في مقال «command not found / خطأ التثبيت».
تتغيّر متطلبات النظام الدقيقة والخطوات الموصى بها لكل نظام وطرق التثبيت البديلة بحسب البيئة. للحصول على أحدث المعلومات وأدقّها، تأكّد دائماً من الوثائق الرسمية code.claude.com/docs.
التشغيل الأول وتسجيل الدخول
عند تشغيله بـ claude لأول مرة، سيُطلب منك تسجيل الدخول (المصادقة) بحساب Anthropic. ما عليك إلا اتّباع إرشادات الشاشة، وفي الغالب سيُفتح المتصفح، فتُسجّل الدخول هناك، فتكتمل المصادقة وتعود إلى الطرفية.
اكتب claude في الطرفية. أول مرة تظهر شاشة اختيار طريقة تسجيل الدخول.
اتّبع الإرشادات وسجّل الدخول إلى حساب Anthropic في المتصفح. حين تسمح، تنجح المصادقة.
تعود إلى الطرفية فتجد شاشة تنتظر الإدخال. هذا مدخل الحوار. والآن نعطي التعليمة.
لتسجيل الدخول طريقتان: الدخول بـاشتراك Claude إن كان لديك عقد الخطة المناسبة، أو الدخول بـمفتاح API. وأيّهما متاح لك وكيف تُحتسب التكلفة يختلفان بحسب الخطة، فلن نجزم بشيء هنا. تأكّد من الطريقة المناسبة لعقدك من الوثائق الرسمية.
🔑 إن عجزت عن الدخول أو ظهر خطأ مصادقة. لا يُفتح المتصفح، أو يُرفض الرمز عند لصقه، أو تتوقّف العملية في منتصفها ― المصادقة أيضاً من نقاط التعثّر الشائعة. جمعنا المعالجات بحسب السبب في مقال «خطأ تسجيل الدخول / المصادقة». وإن لم يُحلّ الأمر، فراجع أيضاً الفصل الخامس «تجاوز العقبات» الذي يعالج التعثّرات بشكل منهجي.
إعطاء أول تعليمة ― الحلقة الأساسية
بعد اكتمال المصادقة، يبدأ العمل الحقيقي. أول ما يهمّ هو تشغيل Claude Code داخل مجلد المشروع الذي تريد العمل عليه. فـ Claude Code يعتبر «المجلد الذي أنت فيه الآن» هدف عمله، فإن أخطأت في هذا لمست مكاناً آخر.
cd my-project
claude
بعد ذلك، ما عليك إلا أن تعبّر عمّا تريده بلغتك مباشرةً. يمكنك أن تطلب بكلام عادي مثل «اقرأ README واشرح ماذا يفعل هذا المشروع» أو «أضف نموذج تواصل إلى الصفحة الرئيسية». من هنا تصبح الخطوات الأربع التالية حلقةً أساسية تتكرّر باستمرار.
تعبّر عمّا تريده بلغتك. كلّما كان أكثر تحديداً وأقلّ غموضاً، عمل كما تريد.
يقرأ الذكاء الاصطناعي الملفات ذات الصلة، ويرسم خطة ماذا يغيّر وكيف، ثم يبدأ.
يُعرَض أيّ سطر يُغيَّر وكيف على شكل فروق (diff). الأخضر إضافة، والأحمر حذف.
إن اقتنعت بالمحتوى فاعتمده ليُطبَّق. وإن اختلفت فارفضه، واشرح التصحيح بالكلام لتحاول من جديد.
النقطة الجوهرية هي «مراجعة الفروق» في الحلقة 3. فقبل أن يعيد Claude Code كتابة الملف، يعرض أولاً فروقاً تقول «سأغيّر هنا هكذا»، ثم ينتظر اعتمادك قبل التطبيق. أن تقرأ المحتوى هنا وتحكم هل يتوافق مع قصدك ― تلك مهمة الإنسان. وكما أشرنا في الفصل السابق، قراءة الشيفرة الناتجة والحكم على جودتها هي عملك.
✅ ليكن أول عمل «صغيراً وقابلاً للتحقق». لا تطلب تعديلاً ضخماً دفعةً واحدة، بل تمرّن بـطلبات صغيرة يمكنك التحقق من نتيجتها بعينك مثل «اشرح هذا الملف» أو «أضف دالة صغيرة واحدة». وإذا نجح الأمر، وسّع نطاق ما تُوكِله تدريجياً ― هذه حيلة تجنّبك الالتفاف.
أما أسلوب الطلب نفسه (التمييز بين «البرمجة بالإحساس» التي تُوكِل فيها بشكل عام، و«التطوير المدفوع بالمواصفات» الذي تُثبّت فيه المواصفات قبل الصنع) فنتعمّق فيه مطوّلاً في الفصل الرابع «اطلب بإتقان». يكفيك الآن أن تدور هذه الحلقة رباعية الخطوات.
أساسيات أنماط الأذونات ― أوكِل بأمان
«ألن يحذف الذكاء الاصطناعي ملفات من تلقاء نفسه أو ينفّذ أوامر خطيرة؟» ― قلق مشروع. وقد صمّم Claude Code هذا الجانب بعناية، بحيث يُدرج تأكيداً بالضرورة قبل أيّ عملية مؤثّرة كتعديل ملف أو تنفيذ أمر. هذا هو نمط الأذونات.
يتوزّع سلوكه على عدة مستويات. لنمسك هنا بالفكرة على وجه الإجمال فقط.
يطلب تأكيداً في كل تعديل أو تنفيذ أمر. تعتمد واحداً تلو الآخر، فهو الأكثر أماناً. ابدأ به لتعتاد.
لا يغيّر شيئاً فعلياً، بل يضع خطة «ماذا سيفعل» فقط. مفيد حين تريد تثبيت المنهج قبل عمل كبير.
يستغني عن التأكيد في كل مرة، ويمضي تلقائياً في نطاق محدّد من العمليات. سريع، لكن بحذر لأن مرّات مراجعتك تقلّ.
نمط قوي يتخطّى كل التأكيدات وينفّذ. الأسلم للمبتدئ تجنّبه. راجع التنبيه أدناه لمواضع استخدامه ومخاطره.
💡 «التجاوز للكل لأن التأكيد مزعج» ممنوع. نمط تخطّي كل التأكيدات قويّ، لكن في المقابل لا يمكنك إيقاف حذف أو تنفيذ أمر لم ترغب فيه. إن أردت السرعة بأمان، فالطريق الصحيح ليس القفز إلى التجاوز، بل أولاً ضبط قواعد أذونات تسمح فقط بالعمليات الموثوقة. وهناك أيضاً خيار «الصندوق الرملي» (sandbox) لعزل العمل وتشغيله بأمان.
يكفيك أن تتذكّر هنا: «Claude Code لا ينفلت من تلقاء نفسه، بل يُدرج تأكيداً» و«يمكن ضبط هذا السلوك بالأنماط». وللمزيد من التعمّق، تجد مقالات وأدلة متخصصة.
الفرق بين الأنماط وطريقة التبديل في شرح أنماط الأذونات.
كيفية كتابة قواعد السماح والرفض في قواعد الأذونات والإعداد.
فكرة الصندوق الرملي في مقدّمة إلى الصندوق الرملي.
أساسيات CLAUDE.md والإعداد
كلّما تعمّقت في استخدام Claude Code، شعرت أن «تكرار التنبيهات نفسها في كل مرة مزعج». «استخدم مسافتين للإزاحة» و«لا تلمس هذا المجلد» و«ردّ بالعربية» ― من غير الفعّال أن تطلب هذه القواعد المشتركة للمشروع كل مرة على حدة.
هنا يظهر CLAUDE.md. إن وضعت ملفاً بهذا الاسم في جذر المشروع، فإن Claude Code يقرؤه تلقائياً عند التشغيل ويعمل وفق القواعد المكتوبة فيه. إنه بمثابة «دليل استخدام هذا المشروع» تسلّمه لرفيقك.
# عن هذا المشروع
- اللغة: TypeScript / إطار العمل: Next.js
- اكتب الردود والتعليقات بالعربية
- الإزاحة بمسافتين
- لا تلمس ما تحت src/legacy/
- مرّر npm run lint قبل الالتزام
النقطة الجوهرية أن تكتب «باختصار، بتحديد، وما تريد فعلاً أن يُلتزَم به فقط». فإن كان طويلاً جداً أو غامضاً، صار الالتزام به أصعب. ابدأ بأسطر قليلة، وأضِف ما تلاحظ أنك «تكرّره في كل مرة» ― هذه هي الطريقة المتوازنة لتنميته.
💡 كتبتها في CLAUDE.md لكنه لا يلتزم بها؟ الشائع أن تكون القواعد كثيرة جداً، أو مجرّدة أكثر من اللازم، أو متناقضة. جمعنا الأسباب وطرق الإصلاح في مقال «حين لا تُطبَّق قواعد CLAUDE.md». ومعرفة «حيل جعلها تعمل» تثبّت دقة الذكاء الاصطناعي كثيراً.
الإعداد ليس CLAUDE.md وحده. فـقواعد الأذونات السابقة واختيار النموذج ومختلف السلوكيات يمكن ضبطها بدقة في ملفات الإعداد، لكن لا بأس بتأجيل ذلك. يكفي أن تكتب أولاً بضعة أسطر لقواعد مشروعك في CLAUDE.md ليتغيّر إحساسك بالأداة.
- Claude Code وكيل سطر أوامر من إنتاج Anthropic. ثبّته في بيئة Node.js بـ
npm install -g @anthropic-ai/claude-code، وشغّله بـclaude. - أول مرة سجّل الدخول (المصادقة) بحساب Anthropic. وإن تعثّرت، فراجع مقالات command not found / خطأ المصادقة.
- الأساس حلقة تطلب ← يخطّط ← تراجع الفروق (diff) ← تعتمد. وقراءة الفروق والحكم على جودتها مهمة الإنسان.
- أنماط الأذونات تمنع الانفلات. المبتدئ يتجنّب التجاوز، ويوسّع نطاق ما يُوكِله مع المراجعة.
- كتابة بضعة أسطر لقواعد المشروع في CLAUDE.md تجعل الذكاء الاصطناعي أميَل إلى الالتزام.
بهذا صار Claude Code يعمل في طرفيتك، وأصبح بإمكانك أن تُوكِل إليه أول عمل. في الفصل الثالث «قارن الأدوات ووزّع استخدامها»، ننظّم الفرق بينه وبين رفاقه مثل Cursor وGitHub Copilot وCodex، ونكتسب كيف نختار بينها حسب الموقف.