البدء مع Claude Code

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

لماذا Claude Code؟

Claude Code يتفوق عندما:

تفضل الطرفية على واجهة المستخدم الرسومية
تعمل مع مهام معقدة ومتعددة الخطوات
تحتاج قدرات وكيلية (عمل مستقل)
تريد تكامل عميق مع git
تتطلب اتصالات MCP (بروتوكول سياق النموذج)

التثبيت

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

Node.js 22 LTS أو أحدث مثبت
npm أو yarn
مفتاح Anthropic API

التثبيت عالمياً

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

التحقق من التثبيت

claude --version
# المخرج: claude <رقم الإصدار>

الإعداد لأول مرة

اضبط مفتاح API عبر متغير البيئة:

export ANTHROPIC_API_KEY=your-key-here

أو أضفه إلى ملف الـ shell (~/.zshrc أو ~/.bashrc) للاحتفاظ به عبر الجلسات.

الاستخدام الأساسي

بدء جلسة تفاعلية

cd your-project
claude

يفتح REPL تفاعلي حيث يمكنك التحدث مع Claude عن كودك.

أمر واحد

claude "اشرح ماذا يفعل هذا المشروع"

مع سياق الملف

claude "راجع هذا الملف للمشاكل الأمنية" --file src/auth.ts

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

أوامر Slash

الأمر	الوصف
`/help`	عرض الأوامر المتاحة
`/clear`	مسح سجل المحادثة
`/model`	تغيير نموذج AI
`/config`	عرض/تحرير الإعدادات
`/review`	مراجعة طلب سحب (PR)
`/memory`	عرض وإدارة ملفات الذاكرة
`/cost`	عرض تكلفة استخدام API

اختصارات لوحة المفاتيح

المفتاح	الإجراء
Ctrl+C	إلغاء العملية الحالية
Ctrl+D	الخروج من Claude Code
أعلى/أسفل	التنقل في السجل
Tab	إكمال أسماء الملفات تلقائياً

الإعداد

الإعداد على مستوى المشروع

أنشئ ملف CLAUDE.md في جذر مشروعك لإعطاء Claude تعليمات مستمرة:

# قواعد المشروع

- استخدم TypeScript لجميع الملفات الجديدة
- اتبع نمط الكود الحالي
- أضف تعليقات JSDoc للدوال العامة
- شغّل الاختبارات قبل الـ commit

ملف الإعدادات

أنشئ .claude/settings.json في مشروعك لضبط الأذونات والإعدادات:

{
  "permissions": {
    "allow": [
      "Bash(git *)",
      "Bash(npm *)",
      "Read",
      "Write",
      "Edit"
    ]
  }
}

تكامل IDE

إضافة VS Code

ثبّت "Claude Code" من سوق VS Code
اضغط ⌘/Ctrl + Shift + P
اكتب "Claude Code: Open Terminal"
Claude Code يعمل في الطرفية المدمجة

المقارنة مع Cursor

الميزة	Claude Code	Cursor
الواجهة	طرفية	رسومية
الأفضل لـ	مهام معقدة، أتمتة	تحرير مرئي
منحنى التعلم	أعلى	أقل
التخصيص	واسع	معتدل
الذاكرة (CLAUDE.md)	مدمج	يدوي
دعم MCP	أصلي	محدود

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

قوة الطرفية: Claude Code يعطيك مساعدة AI بدون مغادرة سير عمل الطرفية. في الدرس التالي، سنستكشف الميزات الوكيلية التي تجعله قوياً بشكل فريد. :::