النقاط الرئيسية

• أداة أصلية في واجهة الأوامر (terminal-native)، وليس chatbot: يعمل Claude Code مباشرة على ملفاتك المحلية، ويقوم بفهرسة هيكل مشروعك بالكامل، ويعمل من خلال نظام أذونات حيث توافق على كل تغيير في الملفات وتنفيذ للأوامر.
• وضع التخطيط (Plan Mode) للمهام المعقدة: اطلب من Claude التخطيط لنهجه قبل إجراء التغييرات -- فهو يحلل المشكلة، ويحدد الخطوات، ويعرض المنطق، وينتظر موافقتك قبل التنفيذ.
• Sonnet لنسبة 80%، وOpus لنسبة 20%: استخدم Sonnet 4.6 للمهام اليومية (سريع وفعال من حيث التكلفة)؛ وانتقل إلى Opus 4.6 لإعادة هيكلة الملفات المتعددة المعقدة، أو القرارات المعمارية، أو فرق الوكلاء (Agent Teams).
• ملف CLAUDE.md يعزز الاتساق: أنشئ ملف CLAUDE.md خاص بالمشروع يحتوي على اصطلاحات البرمجة، وتفضيلات التقنيات المستخدمة (tech stack)، ومتطلبات الاختبار التي يقرأها Claude تلقائياً في كل جلسة.

دليل تعليمي لـ Claude Code للمبتدئين: دليل البدء الكامل

يعتبر Claude Code مساعد البرمجة بالذكاء الاصطناعي الذي يعيش داخل واجهة الأوامر (terminal) الخاصة بك.

تم بناؤه بواسطة Anthropic، وهو يتصل مباشرة بقاعدة البيانات البرمجية الخاصة بك، ويفهم هيكل مشروعك، ويكتب أكواداً حقيقية على جهازك — كل ذلك من خلال محادثة باللغة الطبيعية. منذ توفره العام في May 2025، نما Claude Code ليصبح واحداً من أكثر أدوات تطوير الذكاء الاصطناعي اعتماداً على نطاق واسع، مما ساهم في وصول Anthropic إلى إيرادات سنوية تتجاوز $1 billion بحلول November 2025.

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

---

جدول المحتويات

1. ما هو Claude Code؟
2. المتطلبات الأساسية والتثبيت
3. جلستك الأولى
4. مرجع الأوامر الأساسية
5. وضع التخطيط: فكر قبل أن تبرمج
6. إعداد ملف CLAUDE.md
7. أمثلة على سير العمل في العالم الحقيقي
8. الاختيار بين Sonnet 4.6 و Opus 4.6
9. نصائح لتحقيق أقصى استفادة من Claude Code

---

ما هو Claude Code؟

إن Claude Code هو مساعد برمجة بالذكاء الاصطناعي أصيل في واجهة الأوامر (terminal-native) من Anthropic. على عكس برامج الدردشة القائمة على المتصفح أو إضافات IDE، فإنه يعمل مباشرة داخل واجهة الأوامر الخاصة بك ويعمل على ملفاتك المحلية.

إليك ما يجعله مختلفاً:

• وعي عميق بقاعدة البيانات البرمجية — يقوم Claude بفهرسة مشروعك بالكامل ويفهم كيف ترتبط الملفات ببعضها البعض.
• التفكير التفاعلي — يعرض عملية تفكيره ويطلب مدخلاتك عند نقاط اتخاذ القرار.
• التنفيذ المحلي — يقوم بتعديل الملفات وتشغيل الأوامر على جهازك، وليس في بيئة معزولة (sandbox) بعيدة.
• نظام الأذونات — يتطلب كل تغيير في الملفات وتنفيذ للأوامر موافقتك.

يعمل Claude Code بواسطة Claude Opus 4.6 و Claude Sonnet 4.6، وهي أقوى نماذج Anthropic. وهو يدعم نافذة سياق (context window) قياسية سعة 200K، مع توفر نسخة بيتا بسعة 1M tokens على Opus 4.6.

"إن Claude Code ليس chatbot. إنه وكيل برمجة يتواصل صدفة عبر المحادثة."

---

المتطلبات الأساسية والتثبيت

ما تحتاجه

قبل التثبيت، تأكد من أن لديك:

• اشتراك في Claude — اشتراك Claude Pro ($20/month) كحد أدنى.
• تطبيق واجهة أوامر (terminal) — تطبيق Terminal.app (macOS)، أو واجهة الأوامر المفضلة لديك في Linux، أو Windows Terminal.
• نظام تشغيل مدعوم — macOS، أو Linux، أو Windows 11.
• Node.js — مطلوب لطريقة التثبيت عبر npm.

الخطوة 1: تثبيت Claude Code

افتح واجهة الأوامر الخاصة بك وقم بتشغيل:

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

بدلاً من ذلك، يمكنك التثبيت عبر السكربت الرسمي:

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

الخطوة 2: التحقق من التثبيت

claude --version

يجب أن ترى رقم الإصدار الحالي مطبوعاً. إذا حصلت على خطأ "command not found"، فتأكد من أن دليل bin الخاص بـ Node.js موجود في PATH الخاص بك.

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

يعمل Claude Code بشكل أفضل عند تشغيله من المجلد الجذري (root) لمشروعك:

cd ~/projects/my-app
claude

هذا كل شيء. سيقوم Claude بفحص مشروعك وستكون جاهزاً للبدء.

---

جلستك الأولى

عند تشغيل claude لأول مرة داخل مشروع، إليك ما يحدث:

1. يقوم Claude بفهرسة ملفات مشروعك وهيكله.
2. يفتح مطالبة تفاعلية حيث تكتب باللغة الطبيعية.
3. تطرح أسئلة أو تعطي تعليمات، ويستجيب Claude بالكود أو التعديلات أو التفسيرات.

تفاعل أول بسيط

جرب البدء بشيء كهذا:

> What does this project do? Summarize the tech stack and folder structure.

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

أتبعه بمهمة حقيقية:

> Add input validation to the signup form. Email should be validated and password needs at least 8 characters.

سيقوم Claude بـ:

1. العثور على مكون النموذج ذي الصلة.
2. عرض خطته للتغييرات لك.
3. طلب إذنك قبل تعديل أي ملفات.
4. تطبيق التعديلات وتأكيد ما تم تغييره.

أنت تظل متحكماً طوال الوقت. لا شيء يحدث بدون موافقتك.

---

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

هذه هي الأوامر التي ستستخدمها غالباً داخل جلسة Claude Code:

الأمر	ماذا يفعل
claude	بدء جلسة Claude Code جديدة
/help	عرض جميع الأوامر المتاحة
/plan	الدخول في وضع التخطيط (Plan Mode) — يخطط Claude قبل التنفيذ
/clear	مسح سياق المحادثة والبدء من جديد
/cost	عرض استخدام tokens والتكاليف المقدرة للجلسة
/compact	ضغط المحادثة لتوفير مساحة في نافذة السياق (context window)

لا تحتاج إلى حفظ أوامر slash لتكون منتجاً. في معظم الأوقات، تقوم ببساطة بكتابة طلبك بالغة الطبيعية وسيتولى Claude فهم الباقي.

---

وضع التخطيط: فكر قبل أن تبرمج

يعد وضع التخطيط (Plan Mode) أحد أهم ميزات Claude Code، خاصة للمبتدئين.

عندما تدخل وضع التخطيط باستخدام /plan، يغير Claude سلوكه:

1. يحلل المشكلة — يقرأ الملفات ذات الصلة، ويتتبع التبعيات، ويحدد المناطق المتأثرة.
2. يحدد خطة خطوة بخطوة — ما الذي سيغيره، وبأي ترتيب، ولماذا.
3. يعرض منطقه — ترى كيف يفكر Claude في المشكلة.
4. ينتظر موافقتك — لا يتم تنفيذ أي شيء حتى تعطي الضوء الأخضر.

متى تستخدم وضع التخطيط

• إعادة الهيكلة المعقدة (Complex refactoring) — إعادة تسمية وحدة يتم استيرادها عبر عشرات الملفات.
• الميزات متعددة الملفات — إضافة نقطة نهاية API جديدة تمس المسارات (routes)، والمتحكمات (controllers)، والنماذج (models)، والاختبارات.
• قواعد البيانات البرمجية غير المألوفة — عندما تريد فهم التأثير قبل إجراء التغييرات.
• التعلم — قراءة منطق Claude تساعدك على فهم قاعدة البيانات البرمجية الخاصة بك بشكل أفضل.

مثال: وضع التخطيط قيد العمل

> /plan

> Refactor the authentication module to use JWT tokens instead of session cookies.

سيرد Claude بشيء مثل:

إليك خطتي:

1. تحديث auth/middleware.js للتحقق من JWT tokens بدلاً من التحقق من مخزن الجلسة.
2. تعديل auth/login.js لإنشاء وإرجاع JWT عند تسجيل الدخول الناجح.
3. تحديث auth/logout.js للتعامل مع إبطال التوكن.
4. ضبط عميل API في frontend/src/api.js لإرسال التوكنات في رأس التفويض (Authorization header).
5. تحديث 3 ملفات اختبار لاستخدام تركيبات المصادقة القائمة على JWT.

هل أستمر؟

أنت تراجع، وتطرح الأسئلة، وتعدل الخطة إذا لزم الأمر، ثم توافق.

---

إعداد ملف CLAUDE.md

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

إنشاء ملف CLAUDE.md الخاص بك

ضعه في المجلد الجذري لمشروعك:

# Project: My SaaS App

## Tech Stack
- Next.js 14 with App Router
- TypeScript (strict mode)
- Tailwind CSS
- PostgreSQL with Prisma ORM

## Coding Conventions
- Use functional components with hooks (no class components)
- All functions must have TypeScript return types
- Use named exports, not default exports
- Write tests for all new utility functions

## Testing
- Run tests with: npm run test
- Use Vitest for unit tests
- Test files go in __tests__ directories next to source files

## Git
- Conventional commits: feat(), fix(), refactor()
- Always create a new branch for features

لماذا يهم CLAUDE.md

بدون CLAUDE.md ، يقدم Claude تخمينات معقولة حول اصطلاحاتك. معه، يتبع Claude معاييرك الدقيقة من أول مطالبة. وهذا ذو قيمة خاصة في الفرق حيث يهم الاتساق.

---

أمثلة على سير العمل في العالم الحقيقي

تصحيح مشكلة في الإنتاج

> Users are reporting that the dashboard takes 15 seconds to load.
> Check the API calls on the dashboard page and identify any performance bottlenecks.

سيتتبع Claude مكون لوحة القيادة، ويجد استدعاءات API، ويتحقق من استعلامات N+1 أو الفهارس المفقودة، ويقترح إصلاحات محددة.

إضافة ميزة جديدة

> Add a dark mode toggle to the app. It should persist the user's preference
> in localStorage and apply on page load without a flash of unstyled content.

سيحدد Claude مكان إضافة مكون التبديل، ويقوم بإعداد سياق السمة (theme context)، ويضيف منطق localStorage، ويتعامل مع العرض الأولي بشكل صحيح.

إعادة هيكلة كود قديم (Legacy Code)

> /plan
> This file uses callback-based async patterns. Refactor it to use async/await
> while keeping the same external API.

يخطط Claude لإعادة الهيكلة، ويوضح الدوال التي ستتغير، ويؤكد عدم تعطل أي شيء خارجي قبل المتابعة.

التكامل مع Git

يعمل Claude Code مباشرة مع Git. يمكنك أن تطلب منه:

> Create a new branch called feat/dark-mode, commit the changes we just made,
> and open a pull request with a description of what was changed.

سيقوم Claude بإنشاء الفرع، وتجهيز الملفات، وكتابة رسالة commit، واستخدام GitHub CLI لفتح PR — كل ذلك داخل جلسة واجهة الأوامر الخاصة بك.

---

الاختيار بين Sonnet 4.6 و Opus 4.6

يمنحك Claude Code إمكانية الوصول إلى نموذجين. اختيار النموذج الصحيح يوفر لك الوقت والمال.

	Sonnet 4.6	Opus 4.6
السرعة	سريع	أبطأ
التكلفة (API)	$3 / $15 لكل 1M tokens	$15 / $75 لكل 1M tokens
الأفضل لـ	معظم مهام البرمجة اليومية	المعمارية المعقدة، إعادة هيكلة ملفات متعددة
نافذة السياق	200K tokens	200K قياسي، 1M بيتا
فرق الوكلاء (Agent Teams)	غير متاح	متاح (Opus فقط)

قاعدة 80/20

استخدم Sonnet 4.6 لحوالي 80% من عملك: كتابة الدوال، إصلاح الأخطاء، إضافة الميزات، كتابة الاختبارات، وشرح الكود. إنه سريع ورخيص وقادر جداً.

انتقل إلى Opus 4.6 لأصعب 20%: إعادة الهيكلة واسعة النطاق عبر العديد من الملفات، القرارات المعمارية المعقدة، فرق الوكلاء (Agent Teams) للعمل المتوازي، أو عندما تحتاج إلى نافذة سياق سعة 1M token لتحليل قاعدة بيانات برمجية كبيرة.

---

نصائح لتحقيق أقصى استفادة من Claude Code

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

> What does this project do? Walk me through the architecture.

2. استخدم وضع التخطيط لأي شيء معقد. إذا كانت المهمة تمس أكثر من ملفين، استخدم /plan. التكلفة المسبقة للتخطيط تحميك من التغييرات غير الصحيحة التي يصعب التراجع عنها.

3. كن محدداً في طلباتك. بدلاً من "اجعل الكود أفضل"، جرب "أعد هيكلة دالة processPayment للتعامل مع رسوم Stripe الفاشلة وإعادة المحاولة حتى 3 مرات مع تراجع أسي (exponential backoff)."

4. استخدم /compact عند الوصول إلى حدود السياق. تجمع الجلسات الطويلة السياق. عندما يبدأ Claude في فقدان مسار المحادثات السابقة، قم بتشغيل /compact لضغط السجل وتفريغ المساحة.

5. أنشئ وحافظ على ملف CLAUDE.md الخاص بك. هذا هو أهم شيء يمكنك القيام به. ملف CLAUDE.md جيد يزيل التصحيحات المتكررة ويبقي Claude متماشياً مع معايير فريقك.

6. راجع الفروقات (diffs) قبل الموافقة. نظام أذونات Claude موجود لسبب ما. اقرأ التغييرات المقترحة، خاصة في قواعد البيانات البرمجية غير المألوفة. Claude قوي ولكنه ليس معصوماً من الخطأ.

7. استخدم تكامل Git لسير عمل نظيف. اترك لـ Claude التعامل مع الأجزاء الميكانيكية من Git — إنشاء الفروع، الـ committing، كتابة أوصاف PR — حتى تتمكن من التركيز على مراجعة تغييرات الكود الفعلية.

8. اربط المهام في جلسة واحدة. يتذكر Claude السياق داخل الجلسة. بعد بناء ميزة، أتبعها مباشرة بـ "الآن اكتب اختبارات لما أضفناه للتو" — Claude يعرف الكود بالفعل.

---

ما التالي؟

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

عندما تشعر بالراحة، استكشف هذه القدرات الأكثر تقدماً:

• فرق الوكلاء (Agent Teams) — تشغيل مثيلات متعددة من Claude للعمل المتوازي في المشاريع الكبيرة (Opus 4.6 فقط).
• نافذة سياق 1M token — تحليل قواعد بيانات برمجية ضخمة في جلسة واحدة (Opus 4.6 beta).
• أوامر slash مخصصة — أتمتة سير العمل المتكرر بأوامر خاصة بالمشروع.
• تكامل CI/CD — تشغيل Claude Code كجزء من عملية البناء والمراجعة الخاصة بك.

واجهة الأوامر (terminal) هي المكان الذي يعيش فيه المطورون بالفعل. Claude Code يلاقيك هناك ويجعلك أسرع.

مقالات ذات صلة

• أفضل ذكاء اصطناعي للبرمجة في 2026: 10 أدوات مرتبة حسب الأداء في العالم الحقيقي
• فرق وكلاء Claude Opus 4.6: كيفية إعداد وكلاء برمجة ذكاء اصطناعي متوازيين (دليل 2026)
• دليل OpenAI Frontier: منصة وكلاء الذكاء الاصطناعي للمؤسسات لبناء زملاء عمل بالذكاء الاصطناعي (2026)