شرح Claude Code بالعربي لغير المبرمجين: دليل هادئ للبداية 2026

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

هذا صحيح، لكنه بداية الطريق لا نهايته. أول صفحة تظهر على الشاشة في دقائق. أما شيء تثق به وتضعه أمام الناس، فيحتاج عادات قليلة: أن تخطط قبل التعديل، وتقرأ ما تغيّر، وتحفظ النسخ بـ Git، وتختبر، وتبعد المفاتيح السرية، وتراجع كل أمر قبل أن تسمح به.

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

• ما هو Claude Code، وأين يعمل، وكيف تبدأ أول جلسة.
• كيف تطلب منه، وملف CLAUDE.md لقواعد المشروع.
• قراءة التعديلات، و Git شبكةَ أمان، والاختبار.
• حماية المفاتيح، والأذونات، والتكلفة.
• ما الذي تتعلمه بجانبه.

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

ما هو Claude Code بكلمات بسيطة؟

في نافذة المحادثة العادية تنسخ الكود وتلصقه بنفسك. أما Claude Code فيعمل داخل مجلد مشروعك: يفتح الملفات ويعدّلها وينشئ غيرها، ويشغّل الأوامر التي يكتبها المبرمج. وهذا يعني أنه يغيّر أشياء حقيقية على جهازك، ولهذا يدور أغلب هذا الدليل حول أن تبقى أنت المتحكم.

ستقابلك كلمتان كثيراً: المشروع (ويسميه المبرمجون المستودع أو Repository)، وهو مجلد واحد فيه كل ما يخص موقعاً أو تطبيقاً، والجلسة (Session)، وهي محادثة واحدة داخله. وتوضح الوثائق أن كل جلسة تبدأ بذاكرة فارغة، فلا يعرف إلا ما في ملفات المشروع وما تقوله أنت.

أين يعمل Claude Code؟ (أكتوبر 2026)

تذكر الوثائق أربعة أماكن رئيسية، تعمل كلها بالمحرك نفسه، فقواعد مشروعك تعمل فيها جميعاً.

إن كانت الطرفية تقلقك، فابدأ بتطبيق سطح المكتب أو بمحرر كود مجاني مثل VS Code. وإن كنت تقارن بين Claude Code ومنصات البناء في المتصفح مثل Lovable و Bolt، فاقرأ مقارنة أدوات الفايب كودينج.

التثبيت وأول جلسة

اتبع دليل البدء السريع (Quickstart) الرسمي للتفاصيل الحالية، فهي تتغير.

1. أنشئ حساباً. يذكر الدليل الرسمي خطط Claude المدفوعة (Pro و Max و Team و Enterprise)، أو حساب Claude Console برصيد API مدفوع مسبقاً، أو مزوداً سحابياً مدعوماً.
2. ثبّته من الصفحة الرسمية فقط. انسخ أمر التثبيت من وثائق Anthropic نفسها، لا من فيديو أو منتدى أو مقال، ومنها هذا المقال. وعلى Windows توصي الوثائق بتثبيت Git for Windows أيضاً. وإن ظهرت رسالة بأن الخدمة غير متاحة في منطقتك، فراجع قائمة الدول المدعومة لدى Anthropic. أما تطبيق سطح المكتب فلا يحتاج أوامر: نزّله، وسجّل الدخول، وافتح تبويب Code.
3. تأكد أنه يعمل. في نافذة طرفية جديدة اكتب claude --version. إن ظهر رقم نسخة، فأنت جاهز.
4. أنشئ مجلداً للمشروع. مجلد فارغ باسم واضح بالإنجليزية، مثل cafe-menu. افتح الطرفية داخله واكتب claude، وفي أول مرة سيطلب منك تسجيل الدخول عبر المتصفح.
5. أجب عن سؤال الثقة بحذر. لا تقل نعم إلا لمجلدات مشاريعك، لا لمجلد المستخدم الرئيسي ولا لجذر القرص. ففي الوضع اليدوي يستأذنك قبل أن تصل أدوات الملفات إلى خارج المجلد الذي بدأ فيه، وكلما صغر المجلد صغرت المساحة التي يصل إليها.

اسأل قبل أن تطلب تعديلاً، ثم اطلب شيئاً صغيراً: صفحة HTML واحدة تعرض قائمة مقهى في الرياض، وافتحها في المتصفح. وتفيدك أربعة مفاتيح: Esc يوقفه في منتصف العمل، و /help يعرض الأوامر، و /clear يبدأ محادثة جديدة، و exit للخروج.

كيف تطلب منه: الخطة أولاً، ثم خطوات صغيرة

ابدأ بوضع التخطيط (Plan Mode)

في وضع التخطيط يقرأ Claude Code ملفاتك ويجيب عن أسئلتك دون أن يعدّلها. في الطرفية اضغط Shift+Tab حتى يظهر في شريط الحالة أن وضع التخطيط مفعّل، وفي تطبيق سطح المكتب و VS Code ستجد قائمة لاختيار الوضع. اطلب خطة، واقرأها، وصحّح ما فيها، ثم اسمح له بالتعديل.

وتعطي صفحة أفضل الممارسات قاعدة بسيطة لمتى تحتاج الخطة: إن استطعت وصف التعديل في جملة واحدة، فلا داعي لها. تصحيح خطأ إملائي لا يحتاج خطة، أما صفحة جديدة أو نموذج تواصل أو أي تعديل يمس عدة ملفات فيحتاجها.

الطلب الجيد له أربعة أجزاء

• ماذا: تعديل واحد، في جملة أو جملتين.
• أين: الصفحة أو القسم أو الملف.
• الحدود: ما لا يجوز تغييره، واللغات، واتجاه القراءة.
• التحقق: كيف ستعرفان أنتما الاثنان أن العمل نجح.

قارن «حسّن صفحة التواصل» بهذا الطلب:

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

حين يسير في الاتجاه الخطأ

اضغط Esc فور أن تراه يتجه إلى ما لم تطلبه، أو اضغط Esc مرتين أو اكتب /rewind لإرجاع المحادثة والكود إلى نقطة سابقة. لكن الوثائق تنبّه إلى أن التغييرات التي تحدث عبر أوامر الطرفية لا تُسجَّل في نقاط الرجوع هذه، فالأمر الذي ينقل ملفات أو يحذفها لا تحميه الميزة. وهنا يأتي دور Git.

ملف CLAUDE.md: قواعد مشروعك

CLAUDE.md ملف نصي بسيط في المجلد الرئيسي لمشروعك، يقرأه Claude Code في بداية كل جلسة. هو المكان الذي تكتب فيه ما كنت ستكرره كل يوم. اكتب /init فيكتب لك مسودة أولى، ثم عدّلها بنفسك.

اجعله قصيراً. صفحة الذاكرة في الوثائق تنصح بأن يبقى أقل من 200 سطر، وصفحة أفضل الممارسات تقترح سؤالاً لكل سطر: هل سيخطئ Claude لو حذفت هذا السطر؟ إن كانت الإجابة لا، فاحذفه. وهذا مثال لموقع صغير بلغتين:

# المشروع: موقع مقهى

## اللغات
- العربية والإنجليزية، ولكل لغة عنوانها (/ar و /en).
- العربية من اليمين إلى اليسار. استخدم خصائص CSS المنطقية (margin-inline-start لا margin-left).
- أرقام غربية (0 إلى 9) في اللغتين.

## التصميم
- الألوان والخطوط في الملف styles/tokens.css فقط. لا تكتب قيمة لون في أي مكان آخر.

## الأوامر
- الفحص قبل كل حفظ: npm run build

## اسألني أولاً
- قبل إضافة حزمة، أو حذف ملفات، أو نقل مجلدات.

## ممنوع
- لا مفاتيح ولا كلمات مرور في الكود. مكانها ملف .env الذي يتجاهله Git.

ونقطة مهمة: تقول الوثائق إن Claude يتعامل مع CLAUDE.md على أنه سياق يسترشد به، لا إعدادات ملزمة. هو توجيه قوي، لا قفل. أما ما يجب ألا يحدث أبداً، مثل قراءة ملف المفاتيح، فمكانه إعدادات الأذونات التي أشرحها لاحقاً.

اقرأ الفروق (Diff) قبل أن تقبل التعديل

الفروق (Diff) تعرض التعديل قبل وبعد: السطور المحذوفة عادة بالأحمر مع علامة ناقص، والمضافة بالأخضر مع علامة زائد، وإضافة VS Code وتطبيق سطح المكتب تعرضانها جنباً إلى جنب. لست مضطراً لفهم كل سطر، لكن أجب عن خمسة أسئلة:

1. ما الملفات التي تغيّرت؟ وهل هي ما تتوقعه لهذا الطلب؟
2. هل حُذف شيء لم تطلب حذفه؟
3. هل أُضيفت حزمة جديدة؟ في كثير من مشاريع الويب يظهر ذلك تعديلاً في ملف اسمه package.json. اسأل: ما هذه الحزمة، ولماذا نحتاجها؟
4. هل يشبه أي سطر كلمة مرور أو مفتاحاً؟
5. هل التعديل أكبر بكثير من الطلب؟ اسأل: لماذا؟

ثم اطلب شرحاً بسيطاً: «اشرح لي هذا التعديل ملفاً ملفاً، كأني مصمم لا مبرمج». وللرأي الثاني، في Claude Code أمر مدمج اسمه /code-review يراجع التعديل الحالي في سياق جديد.

Git: شبكة الأمان

يحفظ Git تاريخ مشروعك. تخيّله «حفظ باسم» مع ملاحظة مكتوبة، للمجلد كله دفعة واحدة. وتكفي المبتدئ ثلاث أفكار:

• الحفظ (Commit): لقطة محفوظة مع رسالة قصيرة، مثل «إضافة نموذج التواصل».
• الفرع (Branch): نسخة موازية تجرّب فيها شيئاً خطراً دون أن تلمس النسخة التي تعمل.
• الرفع (Push): إرسال نسخة إلى مستودع خاص على GitHub، فيبقى عملك محفوظاً خارج جهازك.

واطلب ذلك كله بكلمات عادية، مثل: «احفظ التعديلات برسالة واضحة». احفظ بعد كل خطوة تعمل، وافتح فرعاً قبل أي تجربة خطرة، وارفع عملك في آخر اليوم. وفي اليوم الأول اطلب منه إعداد ملف .gitignore، وهو قائمة الملفات التي لا يحفظها Git أبداً، وتأكد أن ملف المفاتيح ضمنها.

الاختبار وأنت لست مبرمجاً

قرّر قبل كل تعديل كيف ستعرف أنه نجح. وللاختبار ثلاث طبقات، لا تحتاج في أي منها أن تكتب كوداً بنفسك:

1. فحص البناء (Build). لأغلب مشاريع الويب أمر يجب أن ينجح قبل النشر. اسأل Claude Code عن الأمر الذي يفحص مشروعك، وأضفه إلى CLAUDE.md.
2. الاختبارات الآلية. لكل ما فيه قواعد، مثل حساب سعر طلب أو نموذج حجز يرفض الحقول الفارغة، اطلب منه أن يكتب اختبارات ويشغّلها ويلصق لك النتيجة. وتنصح الوثائق بأن تطلب الدليل بدلاً من الادعاء، وكلمات مثل passed أو failed في النتيجة هي ما تقرؤه.
3. التجربة بيدك. افتح الصفحة على الجوال، وبدّل اللغة، وأرسل النموذج فارغاً، واكتب اسماً عربياً طويلاً من أربعة مقاطع، واستخدم لوحة المفاتيح وحدها، وجرّب اتصالاً بطيئاً.

وإن فشل اختبار، فاسأل عن السبب قبل أن تطلب الإصلاح.

المفاتيح السرية: بعيداً عن الكود وبعيداً عن المحادثة

المفتاح السري (Secret) هو أي شيء يفتح باباً: مفاتيح API، وكلمات مرور قاعدة البيانات، ومفاتيح بوابات الدفع.

• احفظها في ملف البيئة (ويسمى غالباً .env) على جهازك، مع إدراجه في .gitignore، وفي إعدادات الأسرار لدى خدمة الاستضافة. اطلب من Claude Code أن يقرأ القيمة من متغير بيئة باسمه، واكتب القيمة الحقيقية في الملف بنفسك.
• لا تلصق مفتاحاً في المحادثة أبداً. ولا في لقطة شاشة. المحادثة تُرسل إلى النموذج وتُحفظ مع سجل الجلسة.
• امنعه من قراءة الملف. تشرح صفحة الأذونات الرسمية كيف تضيف قاعدة تمنع أدوات الملفات من قراءة مسار معين، ومثالها Read(./.env).
• إن تسرّب مفتاح، فاستبدله في اليوم نفسه لدى مزوّد الخدمة.

الأذونات: لماذا تراجع الأوامر؟

حتى أكتوبر 2026 تصف الوثائق هذه الأوضاع الرئيسية للأذونات:

وتذكر الوثائق أن الوضع التلقائي صار هو وضع البداية في الطرفية و VS Code في النسخ الحديثة، وتقول بصراحة في الوقت نفسه إنه يقلل طلبات الإذن لكنه لا يضمن الأمان. فما دمت تتعلم، انتقل إلى الوضع اليدوي بـ Shift+Tab أو من قائمة الأوضاع.

تمهّل أمام أي أمر يحذف أو يكتب فوق شيء (rm و del و git reset --hard و git push --force)، أو يثبّت حزماً، أو ينزّل شيئاً من الإنترنت ويشغّله، أو يلمس قاعدة بيانات حية أو حساب الاستضافة، أو يصل إلى خارج مجلد المشروع. وصفحة الأمان لدى Anthropic واضحة في أن مراجعة الأوامر المقترحة مسؤولية المستخدم. وانتبه لخيار «نعم، ولا تسألني مرة أخرى»، فهو في الأوامر يُحفظ بشكل دائم لهذا المشروع. اكتب /permissions بين حين وآخر لترى ما سمحت به، واحذف ما لا تعرفه.

التكلفة والخطط

لن أكتب أسعاراً هنا، لأنها تتغير. استخدام Claude Code يُحسب من حدود خطتك، أو يُحاسب بالاستهلاك في حساب API، فراجع صفحة الأسعار الرسمية على موقع claude.com، وتأكد مسبقاً من قبول بطاقتك من بلدك. وداخل الجلسة يعرض الأمر /usage ما استخدمته، و /clear بين المهام المختلفة يقلل الاستهلاك، لأن المحادثة الطويلة تُرسل كاملة مع كل رسالة.

ماذا تتعلم بجانبه؟

ما يكفي لتقرأ ما يصنعه:

• HTML: العناوين والروابط والصور والنماذج، والخاصيتان lang و dir للعربية.
• CSS: المسافات، و Flexbox و Grid، والمتغيرات، والخصائص المنطقية للاتجاه من اليمين إلى اليسار.
• شكل مشروعك: أين تعيش الصفحات، وما وظيفة package.json و .env و .gitignore.
• Git: أوامر الحالة والحفظ والسجل والفروع والرفع.
• قراءة رسالة الخطأ: السطر الأول غالباً يقول ماذا تعطل وأين.
• أساسيات الطرفية: التنقل بين المجلدات، وإيقاف الخادم المحلي بـ Ctrl+C.

ومن المصادر المجانية الجيدة: دورة Claude Code 101 على Claude Academy من Anthropic، وموقع MDN Web Docs لـ HTML و CSS، وكتاب Pro Git على موقع git-scm.com. و Claude Code نفسه معلم صبور في وضع التخطيط.

من عملي: كيف أستخدمه

بهذه الطريقة أبني منتجاتي وأطلقها. CofyTill نظام كاشير عربي للكافيهات والمحامص يواصل البيع دون إنترنت ويتزامن مع السحابة. و MATN منصة تعليم إلكتروني مصرية للمعلمين، بموقع وتطبيقات iOS و Android. أنا مؤسس المنتجين، وصممت هويتهما وتجربة استخدامهما، و Claude Code هو الأداة التي أوجّهها لكتابة الكود. وبالطريقة نفسها صنعت موقع أعمالي هذا، بالعربية والإنجليزية، ولكل لغة عنوانها.

لم يجعلني ذلك مهندس برمجيات، لكنه قصّر المسافة بين قرار التصميم والشاشة التي تعمل بما يكفي ليعبرها مصمم، بشرط أن تبقى معه الخطة وقراءة الفروق و Git والتحقق. وحين يمكن لخطأ أن يكلّف أحداً مالاً أو يكشف بياناته، تبقى مراجعة مبرمج متمرس جزءاً من العمل.

الخلاصة

يسمح Claude Code لمن لم يبرمج من قبل أن يصنع برمجيات حقيقية بوصفها، بشرط أن يبقى هو صاحب القرار. ابدأ في مجلد مشروع صغير، وخطط قبل التعديلات الكبيرة، واقرأ كل فرق، واحفظ في Git بعد كل خطوة تعمل، وأبعد المفاتيح عن الكود والمحادثة، وابقَ على الوضع اليدوي حتى تعرف كيف يبدو العمل الطبيعي.

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