البدء مع Claude Code

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

لماذا Claude Code؟

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

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

التثبيت

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

• Node.js 18+ مثبت
• npm أو yarn
• مفتاح Anthropic API

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

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

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

claude --version
# المخرج: Claude Code v2.0.76 (أو الأحدث)

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

claude config set api-key YOUR_ANTHROPIC_API_KEY

أو استخدم متغير البيئة:

export ANTHROPIC_API_KEY=your-key-here

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

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

cd your-project
claude

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

أمر واحد

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

مع سياق الملف

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

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

أوامر Slash

الأمر	الوصف
/help	عرض الأوامر المتاحة
/clear	مسح سجل المحادثة
/model	تغيير نموذج AI
/config	عرض/تحرير الإعدادات
/checkpoint	حفظ الحالة الحالية
/restore	استعادة من نقطة تفتيش
/cost	عرض تكلفة استخدام API

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

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

الإعداد

عرض الإعداد الحالي

claude config list

إعدادات مهمة

# تعيين النموذج الافتراضي
claude config set model claude-3-5-sonnet-20241022

# تمكين التطبيق التلقائي
claude config set auto-apply true

# تعيين وضع التفكير
claude config set thinking-mode extended

# إعداد الحد الأقصى للرموز
claude config set max-tokens 8192

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

أنشئ .claude/config.json في مشروعك:

{
  "model": "claude-3-5-sonnet-20241022",
  "autoApply": false,
  "thinkingMode": "normal",
  "context": {
    "includeGitHistory": true,
    "maxFiles": 50
  },
  "rules": [
    "استخدم TypeScript لجميع الملفات الجديدة",
    "اتبع نمط الكود الحالي",
    "أضف تعليقات JSDoc للدوال العامة"
  ]
}

تكامل IDE

إضافة VS Code

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

المقارنة مع Cursor

الميزة	Claude Code	Cursor
الواجهة	طرفية	رسومية
الأفضل لـ	مهام معقدة، أتمتة	تحرير مرئي
منحنى التعلم	أعلى	أقل
التخصيص	واسع	معتدل
نقاط التفتيش	مدمج	يدوي
دعم MCP	أصلي	محدود

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

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