أدوات CLI
2 دقيقة للقراءة
Claude CLI: الميزات
Claude CLI يوفر مجموعة شاملة من الميزات التي تجعله أداة قوية للمطورين. هذا الدليل يغطي الميزات الأساسية والمتقدمة بكامل تفاصيلها.
الميزات الأساسية
1. فهرسة المشروع (Project Indexing)
# فهرسة المشروع بالكامل
claude scan .
# فهرسة مجلد محدد
claude scan src/
# طرح أسئلة بعد الفهرسة
claude ask "أين يقع منطق المصادقة في هذا المشروع؟"
claude ask "ما هي المكتبات المستخدمة في هذا المشروع؟"
الفوائد:
- فهم شامل لبنية المشروع
- إجابات سياقية دقيقة
- اقتراحات تحسين مستنيرة
2. إعادة الهيكلة (Refactoring)
# تحويل JavaScript إلى TypeScript
claude refactor src/legacy.js --to typescript
# إعادة هيكلة مكون React
claude refactor components/OldButton.tsx --use-hooks
# تحسين الكود
claude refactor src/utils/api.js --optimize
الفوائد:
- تحديث الكود القديم تلقائياً
- تحسين الأداء
- إضافة TypeScript types
3. تصحيح الأخطاء (Debugging)
# تصحيح خطأ محدد
claude debug --error "TypeError: Cannot read property 'id' of undefined"
# تصحيح ملف مع traces
claude debug src/app.js --trace
# تصحيح مع شرح مفصل
claude debug --explain "ReferenceError: user is not defined"
الفوائد:
- تحليل الأخطاء المعقدة
- شرح وافٍ للأسباب
- حلول عملية للمشاكل
4. المحادثات السياقية (Context-Aware Conversations)
# محادثة مع ملفات محددة كسياق
claude chat --files src/api/*.ts src/lib/database.ts
# محادثة مع مجلد كامل
claude chat --directory ./src/components
# محادثة مع git diff
claude chat --git-diff
الفوائد:
- حوارات طبيعية
- فهم عميق للسياق
- إجابات مخصصة
الميزات المتقدمة
1. قواعد المشروع المخصصة (Custom Rules File)
أنشئ ملف .claude-rules في جذر مشروعك:
# .claude-rules
project:
name: "تطبيق Next.js 14"
type: "fullstack"
preferences:
- "استخدم App Router"
- "فضل مكونات السيرفر"
- "استخدم Tailwind CSS"
- "اتبع Airbnb Style Guide"
typescript:
strict_mode: true
path_alias: "@/*"
testing:
framework: "jest"
coverage_target: 80
ai:
model: "claude-3-5-sonnet-20241022"
temperature: 0.2
max_tokens: 4000
الاستخدام:
# Claude سيقرأ القواعد تلقائياً
claude generate "أضف مكوناً جديداً لصفحة تسجيل الدخول"
# سينشئ Claude الكود وفقاً لقواعد مشروعك:
# - TypeScript مع strict mode
# - App Router pattern
# - Tailwind classes
# - Airbnb style
2. اختيار النموذج الذكي (Model Selection)
# تعيين النموذج الافتراضي
claude config set model claude-3-5-sonnet-20241022
# الخيارات المتاحة:
# - claude-3-5-sonnet (متوازن - موصى به)
# - claude-3-opus (الأقوى - أبطأ)
# - claude-3-haiku (الأسرع - أبسط)
# التحقق من النموذج الحالي
claude config get model
متى تستخدم كل نموذج؟
| النموذج | الاستخدام | السرعة | التكلفة |
|---|---|---|---|
| Haiku | أسئلة سريعة، نصوص بسيطة | ⚡⚡⚡ | 💰 |
| Sonnet | معظم المهام اليومية | ⚡⚡ | 💰💰 |
| Opus | مهام معقدة، refactor كبير | ⚡ | 💰💰💰 |
3. المتغيرات البيئية (Environment Variables)
# ملف .env أو .bashrc أو .zshrc
export ANTHROPIC_API_KEY="your-api-key-here"
export CLAUDE_MODEL="claude-3-5-sonnet-20241022"
export CLAUDE_MAX_TOKENS=4000
export CLAUDE_TEMPERATURE=0.2
سيناريوهات الاستخدام المتقدمة
السيناريو 1: تعلم إطار عمل جديد
# بدء محادثة حول إطار جديد
claude chat
> "أنا جديد في Next.js 14. اشرح لي App Router مع أمثلة"
# Claude سيقوم بـ:
# 1. شرح المفهوم
# 2. إعطاء أمثلة عملية
# 3. إنشاء ملفات تجريبية
# 4. الإجابة على أسئلتك المتابعة
السيناريو 2: مراجعة الكود (Code Review)
# مراجعة ملف محدد
claude review src/utils/validation.ts
# الحصول على اقتراحات للتحسين
> "ما هي المشاكل المحتملة؟"
> "كيف يمكنني تحسين الأداء؟"
> "هل هناك أي ثغرات أمنية؟"
مراجعة أمنية:
claude review src/api/auth.ts --security
# Claude سيركز على:
# - حقن SQL
# - XSS attacks
# - CSRF protection
# - password hashing
# - JWT security
السيناريو 3: إنشاء التوثيق (Documentation)
# إنشاء JSDoc لمكون
claude document src/components/Button.tsx
# إنشاء README للمشروع
claude document . --format readme
# إنشاء API docs
claude document src/api/ --format api
السيناريو 4: إعادة الهيكلة الكبيرة
# تحويل Class Components إلى Hooks
claude refactor src/components/ --to-hooks
# تحويل JavaScript إلى TypeScript
claude refactor src/ --to-typescript
# إضافة Error Boundaries
claude refactor src/ --add-error-boundaries
السيناريو 5: إنشاء الاختبارات
# إنشاء اختبارات لمكون
claude test src/components/Button.tsx
# إنشاء اختبارات لواجهة API
claude test src/api/users.ts --integration
# إنشاء اختبارات E2E
claude test src/ --e2e
الميزات الإضافية
1. تكامل Git
# مراجعة التغييرات قبل الـ commit
claude chat --git-diff
# إنشاء commit message
claude commit --generate-message
# مراجعة PR
claude review --pr 123
2. التعاون
# مشاركة محادثة
claude chat --share
# تصدير جلسة عمل
claude export --format markdown
# استيراد جلسة عمل
claude import session.json
3. التخصيص
# تخصيص الألوان
claude config set theme dark
# تخصيص الـ prompts
claude config set prompt-format detailed
# تخصيص الإخراج
claude config set output-format json
الأداء والتحسين
مراقبة الأداء
# عرض إحصائيات الاستخدام
claude stats
# عرض وقت الاستجابة
claude benchmark
# تحسين الأداء
claude optimize
إدارة الذاكرة
# مسح الذاكرة المؤقتة
claude cache clear
# عرض استهلاك الذاكرة
claude memory usage
الخلاصة
Claude CLI يوفر:
الميزات الأساسية:
- ✅ فهرسة المشروع الذكية
- ✅ إعادة الهيكلة التلقائية
- ✅ تصحيح الأخطاء المتقدم
- ✅ محادثات سياقية
الميزات المتقدمة:
- ✅ قواعد مشروع مخصصة
- ✅ اختيار نموذج ذكي
- ✅ سيناريوهات استخدام متعددة
- ✅ تكامل Git
- ✅ أدوات تعاون
استخدم هذه الميزات بذكاء لتعزيز إنتاجيتك وتحسين جودة الكود!