شرح Claude Code بالعربي: التثبيت وأول مهمة

في Claude العادي (الموقع أو التطبيق) تكتب سؤالاً وتحصل على جواب، ثم تنسخ الناتج وتضعه بنفسك حيث تريد. في Claude Code الأمر مختلف: تفتح الطرفية داخل مجلد، فيقرأ ما فيه حسب الحاجة دون أن تلصق له الملفات، ثم يقترح تعديلاً ويعرضه عليك. حسب الوثائق، يعمل على عدة ملفات معاً ويتعامل مع Git ويتصل بأدواتك الأخرى.

وهو لا يقتصر على الطرفية. تذكر الوثائق أنه متاح أيضاً في VS Code وJetBrains وتطبيق سطح المكتب وعلى الويب، وأن هذه الواجهات كلها تشترك في المحرك نفسه، فملف CLAUDE.md وإعداداتك تعمل في كلها. هذه الصفحة تشرح الطرفية لأنها الأصل والأوسع.

تذكر وثائق التثبيت الرسمية المتطلبات الآتية:

• نظام التشغيل: macOS 13.0 فأحدث، أو Windows 10 الإصدار 1809 فأحدث (أو Windows Server 2019)، أو Ubuntu 20.04 فأحدث، أو Debian 10 فأحدث، أو Alpine Linux 3.19 فأحدث. على Alpine ثبّت bash وcurl أولاً، فهما غير موجودين فيه افتراضياً (التفاصيل في الوثائق).
• الجهاز: ذاكرة 4 جيجابايت فأكثر، ومعالج x64 أو ARM64.
• الشبكة: اتصال إنترنت دائم أثناء الاستعمال.
• الطرفية: Bash أو Zsh أو PowerShell أو CMD.
• الموقع: أن تكون في بلد ضمن الدول المدعومة عند Anthropic.
• الحساب: اشتراك Claude من نوع Pro أو Max أو Team أو Enterprise، أو حساب Claude Console، أو وصول عبر مزوّد سحابي مدعوم. الخطة المجانية في claude.ai لا تتضمن Claude Code.

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

الطريقة الموصى بها رسمياً هي «التثبيت الأصلي» (Native Install): تفتح الطرفية وتشغّل أمراً واحداً حسب نظامك. لا تحتاج صلاحيات المدير على ويندوز. الأوامر أدناه كما وردت في الوثائق، وكل صندوق فيه زر نسخ.

ماك ولينكس (وWSL على ويندوز)

curl -fsSL https://claude.ai/install.sh | bash

ويندوز: PowerShell

تعرف أنك في PowerShell إذا بدأ السطر بـ PS C:\.

irm https://claude.ai/install.ps1 | iex

ويندوز: CMD

وتعرف أنك في CMD إذا بدأ السطر بـ C:\ دون PS.

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

بدائل رسمية

على ماك يمكنك استعمال Homebrew، وعلى ويندوز يمكنك استعمال WinGet. هذان الأسلوبان لا يتحدّثان تلقائياً، فتحدّث يدوياً بين حين وآخر.

brew install --cask claude-code

winget install Anthropic.ClaudeCode

هل أستعمل ويندوز مباشرة أم WSL؟

الوثائق تتيح الخيارين. التشغيل المباشر على ويندوز مناسب لمشاريع ويندوز وأدواته، ولا يدعم ميزة العزل (Sandboxing). أما WSL 2 فيناسب أدوات لينكس ويدعم العزل. إن اخترت WSL فافتح توزيعتك ونفّذ أمر لينكس من داخلها لا من PowerShell. وتثبيت Git for Windows موصى به على ويندوز المباشر ليستعمل Claude Code أداة Bash، وبدونه يستعمل PowerShell.

تأكد أن التثبيت نجح

الأمر لا يعرض تقدماً أثناء التحميل، فانتظر حتى ينتهي، ثم افتح نافذة طرفية جديدة ونفّذ:

claude --version

إذا طبع رقم إصدار فالتثبيت سليم. ولفحص أوسع للتثبيت والإعدادات شغّل claude doctor.

جرّب أول مرة في مجلد فارغ جديد، فلا يوجد ما تخسره. أنشئ المجلد وادخل إليه وشغّل الأداة (الأمران الأولان يعملان في PowerShell وCMD وماك ولينكس):

mkdir claude-test
cd claude-test
claude

1. تسجيل الدخول: تطلب الأداة منك الدخول عند أول استعمال. اتبع الخطوات في المتصفح بحسابك (اشتراك Claude أو Console). بعدها تُحفظ بيانات الدخول فلا تكررها. ولتبديل الحساب لاحقاً اكتب /login داخل الجلسة.
2. اسأل قبل أن تغيّر: أسئلة القراءة لا تغيّر شيئاً في ملفاتك. اكتب مثلاً: what does this project do? أو explain the folder structure. في مجلد فارغ سيخبرك أنه فارغ، وهذا مقصود: تتعلم الحوار دون خطر.
3. أول تعديل صغير: اكتب طلباً بالعربية، مثل: «أنشئ ملف notes.md فيه ثلاثة أسطر تعرّف بهذا المجلد». ستعرض الأداة التعديل وتسألك قبل التنفيذ، فاقرأه واختر Yes إن وافقت.
4. افهم الصلاحيات: وضع الصلاحيات (Permission mode) يحدد ما تفعله الأداة دون سؤالك. تبدّل الأوضاع بالضغط على Shift+Tab. ابدأ بالوضع الافتراضي الذي يسألك، ولا تغيّره حتى ترتاح للحوار.

أوامر مفيدة داخل الجلسة، كما في الوثائق: /help لعرض الأوامر، و/clear لمسح المحادثة، و/exit للخروج. ومن خارج الجلسة: claude -c لمتابعة آخر محادثة في المجلد الحالي، وclaude -r لاستعراض المحادثات السابقة واستئناف إحداها.

توصية الوثائق لنتائج أفضل: كن محدداً. بدل «أصلح المشكلة» اكتب ما تراه فعلاً وما تريده منها. وللمهام الكبيرة قسّمها إلى خطوات مرقمة في الطلب نفسه، ودع Claude يستكشف أولاً قبل أن يعدّل: اطلب منه أن يحلل ما في المجلد ويخبرك بما فهمه، ثم أعطه المهمة. هذه العادة تفيدك لأنك تصحح الفهم قبل أن يتحول إلى تعديل على ملفاتك.

وفي كل مرة تفتح فيها الأداة تذكّر أنها تعمل داخل المجلد الذي شغّلتها منه. فإن أردت أن تعمل على مشروع آخر فاخرج من الجلسة بـ /exit، وادخل مجلد المشروع الجديد بالأمر cd، ثم شغّل claude من جديد.

كل جلسة في Claude Code تبدأ بسياق جديد. ملف CLAUDE.md هو طريقتك لإعطائه تعليمات دائمة: ملف نصي تضعه في جذر المشروع، فيقرؤه في بداية كل جلسة. ضع فيه ما يلزم أن يعرفه عن عملك وطريقتك: أوامر البناء والاختبار، وقواعد الكتابة، وما يُسأل عنه قبل التنفيذ.

تذكر الوثائق موضعين للملف داخل المشروع هما ./CLAUDE.md أو ./.claude/CLAUDE.md، وموضعاً شخصياً يسري على كل مشاريعك هو ~/.claude/CLAUDE.md. وتنصح بأن يقل الملف عن 200 سطر، لأن الأطول يستهلك سياقاً أكثر ويقلل الالتزام به. واعلم أن Claude يعامله كسياق لا كإعداد مُلزِم، فالمنع القاطع يحتاج Hook (القسم الآتي). وللبدء السريع اكتب /init فيولّد لك مسودة من مشروعك.

# عن هذا المجلد
مجلد أعمالي لمتجر عطور إلكتروني: أوصاف المنتجات ورسائل العملاء.

# قواعد الكتابة
- اكتب بالعربية الفصحى المبسطة، وجمل قصيرة.
- لا تذكر أسعاراً لم أعطك إياها.

# قبل أي تعديل
- اشرح لي ما ستغيّره في سطرين ثم انتظر موافقتي.

للتوسع في فكرة التعليمات الدائمة وكيف تُصاغ، اقرأ مقالنا دستور الوكيل: كيف تكتب تعليمات Claude Code.

المهارة حزمة تعليمات تحفظها مرة وتستدعيها كلما احتجتها، بدل أن تلصق الخطوات نفسها في كل محادثة. تقول الوثائق: أنشئ مهارة حين تجد نفسك تكرر التعليمات أو القائمة نفسها. تُحفظ المهارة في مجلد باسمها يحوي ملف SKILL.md، تحت ~/.claude/skills/ لتعمل في كل مشاريعك، أو تحت .claude/skills/ داخل مشروع بعينه. وتستدعيها بكتابة /اسم-المهارة، أو يختارها Claude تلقائياً حين تناسب الطلب.

لا تنتظر أن تكتب كل شيء من الصفر: في مكتبة مهارات مُشَيِّد مهارات جاهزة للنسخ والتحميل بالعربية.

الـHooks أوامر تحددها أنت، يشغّلها Claude Code تلقائياً عند نقاط محددة من عمله، مثل بعد تعديل ملف أو قبل تنفيذ أداة. الفرق عن التعليمات في CLAUDE.md أن الـHook يُنفَّذ دائماً ولا يعتمد على اجتهاد النموذج. تُضاف في ملف الإعدادات settings.json داخل كتلة hooks. مثال من الوثائق: تنسيق كل ملف يُعدَّل تلقائياً بعد كل تعديل. شرحنا التطبيق بالعربية في دليل Hooks في Claude Code.

المهام المجدولة تشغّل طلباً بشكل متكرر. أسرع طريق هو الأمر /loop، مثل /loop 5m check the deploy، لكنه مرتبط بالجلسة المفتوحة. وللجدولة التي تستمر دون جلسة تفتحها تذكر الوثائق خيارين: Routines تعمل على السحابة (أدنى فاصل ساعة)، ومهام سطح المكتب التي تعمل على جهازك. ملاحظة مهمة: المهام المتكررة داخل الجلسة تنتهي تلقائياً بعد 7 أيام من إنشائها. التفاصيل في دليل المهام المجدولة في Claude Code.