مفاهيم Claude Code: CLI, Hooks, Skills, والمزيد

نظرة عامة

Claude Code يتكون من عدة مكونات تعمل معاً:

┌─────────────────────────────────────────┐
│              Claude Code                │
├─────────────────────────────────────────┤
│  CLI ──→ الواجهة الرئيسية              │
│  Hooks ──→ تخصيص السلوك                │
│  Skills ──→ قدرات إضافية               │
│  MCP ──→ بروتوكول التواصل              │
└─────────────────────────────────────────┘

1. CLI (واجهة سطر الأوامر)

ما هي؟

CLI هي الطريقة الأساسية للتفاعل مع Claude Code عبر Terminal.

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

# بدء جلسة جديدة
claude
 
# بدء مع مهمة محددة
claude "أضف نظام authentication"
 
# استئناف جلسة سابقة
claude --resume
 
# وضع غير تفاعلي (للسكربتات)
claude -p "أصلح أخطاء lint" --no-input

أوامر داخل الجلسة

Flags مهمة

# تحديد النموذج
claude --model claude-sonnet-4
 
# تفعيل التفكير المعمق
claude --thinking
 
# وضع verbose
claude --verbose
 
# تحديد مجلد العمل
claude --cwd /path/to/project

2. Hooks (الخطافات)

ما هي؟

Hooks تتيح لك تنفيذ كود مخصص في نقاط محددة من دورة عمل Claude Code.

أنواع الـ Hooks

PreToolUse ──→ قبل استخدام أي أداة
PostToolUse ──→ بعد استخدام أداة
Notification ──→ عند وصول إشعار
Stop ──→ عند انتهاء المهمة

مثال: Hook لمنع حذف الملفات

// ~/.claude/settings.json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "bash",
        "command": "check-dangerous-commands.sh",
        "timeout": 5000
      }
    ]
  }
}

# check-dangerous-commands.sh
#!/bin/bash
if echo "$CLAUDE_TOOL_INPUT" | grep -q "rm -rf"; then
  echo '{"decision": "block", "reason": "حذف خطير ممنوع"}'
  exit 0
fi
echo '{"decision": "allow"}'

استخدامات Hooks

3. Skills (المهارات)

ما هي؟

Skills هي قدرات إضافية تضيفها لـ Claude Code عبر ملفات SKILL.md.

هيكل المهارة

skills/
└── my-skill/
    ├── SKILL.md      # تعليمات للذكاء الاصطناعي
    ├── scripts/      # سكربتات مساعدة
    └── templates/    # قوالب

مثال: مهارة للتعامل مع API

# SKILL.md
---
name: api-helper
description: مساعد للتعامل مع REST APIs
---
 
## متى تستخدم
عندما يطلب المستخدم إنشاء أو تعديل API endpoints.
 
## التعليمات
1. استخدم Express.js للـ backend
2. أضف validation بـ Zod
3. أضف error handling موحد
4. وثّق الـ endpoint في Swagger
 
## القوالب
استخدم `scripts/create-endpoint.sh` لإنشاء endpoint جديد

مهارات شائعة

4. MCP (Model Context Protocol)

ما هو؟

MCP هو بروتوكول مفتوح لربط AI بمصادر بيانات وأدوات خارجية.

كيف يعمل؟

┌──────────────┐     ┌─────────────┐     ┌──────────────┐
│ Claude Code  │────▶│ MCP Server  │────▶│ External API │
└──────────────┘     └─────────────┘     └──────────────┘

إعداد MCP Server

// ~/.claude/settings.json
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxx"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://..."
      }
    }
  }
}

MCP Servers متاحة

• GitHub: إدارة repos, issues, PRs
• Postgres/MySQL: استعلامات قواعد البيانات
• Slack: إرسال رسائل
• Google Drive: قراءة/كتابة ملفات
• Notion: إدارة الصفحات
• والمزيد...

5. CLAUDE.md

ما هو؟

ملف تضعه في جذر مشروعك ليفهم Claude Code سياق المشروع.

محتويات مقترحة

# CLAUDE.md
 
## عن المشروع
تطبيق e-commerce بـ Next.js و Supabase.
 
## التقنيات
- Next.js 14 (App Router)
- TypeScript
- Tailwind CSS
- Supabase (Auth + Database)
 
## الهيكل
- `app/` - صفحات Next.js
- `components/` - مكونات React
- `lib/` - utilities
- `supabase/` - migrations
 
## الأوامر
- `npm run dev` - تشغيل محلي
- `npm run build` - بناء الإنتاج
- `npm test` - تشغيل الاختبارات
 
## قواعد الكود
- استخدم TypeScript strict mode
- كل component في ملف منفصل
- CSS بـ Tailwind فقط

تجميع المفاهيم

Claude Code
    │
    ├── CLI ────────────── واجهة المستخدم
    │
    ├── CLAUDE.md ──────── سياق المشروع
    │
    ├── Hooks ─────────── تخصيص السلوك
    │   ├── PreToolUse
    │   ├── PostToolUse
    │   └── ...
    │
    ├── Skills ─────────── قدرات إضافية
    │   ├── SKILL.md
    │   └── scripts/
    │
    └── MCP ────────────── ربط خارجي
        ├── GitHub
        ├── Database
        └── ...

ما التالي؟

في المقال القادم، سنتحدث عن:

• فوائد Claude Code العملية
• حالات استخدام حقيقية
• متى تستخدمه ومتى لا

اقرأ المقال التالي: فوائد واستخدامات Claude Code