Claude Code: مقدمة عن Claude Code وكيفية عمله

آخر تحديث: 2026-08-31

Claude Code هو وكيل برمجة ذكي من Anthropic — ليس روبوت محادثة، بل كيان ذكي يستطيع قراءة الملفات وتشغيل الاختبارات وتعديل الأكواد والتكرار بناءً على الملاحظات.

📋 المتطلبات المسبقة: لا حاجة لمعرفة مسبقة، الإلمام الأساسي بسطر الأوامر مفيد

1. ما ستتعلمه

• تموضع Claude Code: وكيل وليس محادثة
• طريقة عمله في مستودعات الأكواد المحلية
• البنية الأساسية ونموذج الصلاحيات
• المقارنة مع أدوات البرمجة بالذكاء الاصطناعي التقليدية
• حالات الاستخدام والقيود

حول مخرجات أمثلة الأكواد

يستخدم هذا الدورة نمط فصل حتمي/غير حتمي لأمثلة الأكواد، وهو أفضل ممارسة صناعية لدروس أدوات وكيل الذكاء الاصطناعي:

2. قصة فريق حقيقي

(1) المشكلة: عنق الزجاجة في كفاءة أدوات البرمجة بالذكاء الاصطناعي

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

• ChatGPT: إجابات جيدة، لكن الأكواد تحتاج نسخاً يدوياً إلى المشروع
• GitHub Copilot: إكمال تلقائي مناسب، لكن إكمال محلي فقط، لا يستطيع فهم المشروع بالكامل
• Cursor: تكامل جيد مع IDE، لكن قدرات الوكيل محدودة لإعادة الهيكلة المعقدة

متطلبات مدير المنتج بوب تستمر في النمو:

"نحتاج إلى ترحيل وحدة المصادقة بالكامل من Session إلى JWT، تشمل 20+ ملف، والتأكد من نجاح جميع الاختبارات."

(2) حل Claude Code

ثبّتت أليس Claude Code وأطلقت الترحيل بأمر واحد:

claude "Migrate the authentication module from Session to JWT, ensure all tests pass"

أكمل Claude Code بشكل مستقل:

1. قراءة هيكل المشروع، وتحديد جميع الملفات المتعلقة بالمصادقة
2. تعديل منطق المصادقة واحداً تلو الآخر
3. تشغيل مجموعة الاختبارات
4. إصلاح الأكواد بناءً على النتائج الفاشلة
5. التكرار حتى نجاح جميع الاختبارات

Files modified: 23
Tests run: 47
Tests passed: 47
Iterations: 3
Time: ~8 minutes

3. ما هو Claude Code

(1) التعريف الأساسي

Claude Code هو وكيل ذكاء اصطناعي لسطر الأوامر يعمل مباشرة في مستودع الأكواد المحلي:

(2) الوكيل مقابل المحادثة: الفرق الجوهري

graph LR
    A[User Instruction] --> B[Chat Mode]
    A --> C[Agent Mode]
    B --> B1[Generate Answer]
    B1 --> B2[User Manually Executes]
    C --> C1[Understand Intent]
    C1 --> C2[Read Context]
    C2 --> C3[Execute Operation]
    C3 --> C4[Verify Result]
    C4 --> C5{Success?}
    C5 -->|No| C2
    C5 -->|Yes| C6[Report Result]

graph LR
    A[User Instruction] --> B[Chat Mode]
    A --> C[Agent Mode]
    B --> B1[Generate Answer]
    B1 --> B2[User Manually Executes]
    C --> C1[Understand Intent]
    C1 --> C2[Read Context]
    C2 --> C3[Execute Operation]
    C3 --> C4[Verify Result]
    C4 --> C5{Success?}
    C5 -->|No| C2
    C5 -->|Yes| C6[Report Result]

▶ مثال 1: مقارنة المحادثة مع الوكيل

# Chat approach: User needs multiple steps
# 1. Ask AI how to fix bug
# 2. Copy code
# 3. Paste into file
# 4. Run test
# 5. Test fails, go back to step 1

# Agent approach: One command does it all
claude "Fix the null pointer exception in user.service.ts, ensure tests pass"

4. كيف يعمل Claude Code

(1) سير العمل

حلقة عمل Claude Code:

graph TB
    U[User Input] --> P[Intent Parsing]
    P --> R[Read Project Context]
    R --> A[Plan Operations]
    A --> E[Execute Operations]
    E --> V[Verify Results]
    V --> S{Success?}
    S -->|Yes| RPT[Report Results]
    S -->|No| A

graph TB
    U[User Input] --> P[Intent Parsing]
    P --> R[Read Project Context]
    R --> A[Plan Operations]
    A --> E[Execute Operations]
    E --> V[Verify Results]
    V --> S{Success?}
    S -->|Yes| RPT[Report Results]
    S -->|No| A

(2) الصلاحيات والأمان

يملك Claude Code صلاحيات عالية لكنه يوفر ضوابط أمان متعددة الطبقات:

▶ مثال 2: عملية عمل Claude Code

$ claude "Create date.ts under src/utils/ with common date formatting functions and tests"

# Claude Code's autonomous work process:
# 1. Reading src/utils/ directory structure...
# 2. Reading existing utils for style consistency...
# 3. Creating src/utils/date.ts with formatDate(), relativeTime(), etc.
# 4. Creating src/utils/__tests__/date.test.ts
# 5. Running: npm test -- src/utils/__tests__/date.test.ts
# 6. 2 tests failing... fixing edge cases
# 7. Running: npm test -- src/utils/__tests__/date.test.ts
# 8. All 6 tests passed ✓

5. المقارنة مع أدوات البرمجة بالذكاء الاصطناعي الأخرى

▶ مثال 3: تقييم أليس للأدوات

def evaluate_tool(tool_name, agent_score, scope_score, multi_file):
    score = agent_score * 0.4 + scope_score * 0.3 + (1 if multi_file else 0) * 0.3
    return round(score, 2)

tools = {
    "Claude Code": {"agent": 9, "scope": 9, "multi_file": True},
    "Copilot": {"agent": 3, "scope": 4, "multi_file": False},
    "Cursor": {"agent": 6, "scope": 7, "multi_file": True},
    "Aider": {"agent": 7, "scope": 8, "multi_file": True},
}

for name, scores in tools.items():
    result = evaluate_tool(name, scores["agent"], scores["scope"], scores["multi_file"])
    print(f"{name}: {result}")

6. مثال شامل: إعادة هيكلة على مستوى المشروع

# Scenario: Alice needs to migrate an Express project to Fastify

$ claude "Migrate the entire project from Express to Fastify:
1. Replace all route definitions
2. Update middleware syntax
3. Modify startup script
4. Ensure all tests pass
5. Update package.json dependencies"

# Claude Code autonomously executes:
# → Scanning 45 files for Express patterns...
# → Converting route definitions (32 routes)...
# → Updating middleware (8 files)...
# → Running test suite: 89/89 passed ✓
# → Updating package.json...
# → Removing Express dependencies...
# → Final test run: 89/89 passed ✓

❓ أسئلة شائعة

📖 ملخص

• Claude Code أداة وكيل وليس أداة محادثة — القدرة الأساسية هي عمليات الأكواد المستقلة
• حلقة العمل: قراءة ← تحليل ← تنفيذ ← تحقق ← تكرار
• صلاحيات عالية مع ضوابط أمان متعددة الطبقات، تأكيد تلقائي/يدوي قابل للتكوين
• يعمل من سطر الأوامر، لا يعتمد على IDE، يعمل مباشرة في الطرفية
• الأفضل لإعادة الهيكلة متعددة الملفات وإصلاح الأخطاء وكتابة الاختبارات والمهام المعقدة الأخرى

📝 تمارين

1. أساسي (⭐): اذكر ثلاثة فروق أساسية بين Claude Code و ChatGPT في المساعدة في البرمجة.
2. متوسط (⭐⭐): اختر أداة برمجة بالذكاء الاصطناعي لمشروعك واكتب مبرراتك (راجع جدول المقارنة).
3. متقدم (⭐⭐⭐): صمم سير عمل يحدد أي المهام تناسب Claude Code وأيها يناسب Copilot، مع معايير قرار.

فريق Web-Tutorial التقني

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

من نحن