أدوات CLI
2 دقيقة للقراءة

Claude CLI: الأوامر

هذا الدليل المرجعي يغطي جميع أوامر Claude CLI مع أمثلة عملية لكل أمر.

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

ask — طرح الأسئلة السريعة

# طرح سؤال مباشر
claude ask "كيف أثبت JWT authentication في Express.js؟"

# الحصول على شرح لمفهوم
claude ask "ما الفرق بين map و filter في JavaScript؟"

# سؤال مع ملفات كسياق
claude ask "هل هناك مشاكل في هذا الكود؟" --files src/api/users.ts

الخيارات المتاحة:

  • --files: إضافة ملفات كسياق
  • --model: استخدام نموذج محدد
  • --output: حفظ الإجابة في ملف

analyze — تحليل الملفات

# تحليل ملف واحد
claude analyze src/components/Button.tsx

# تحليل ملفات متعددة
claude analyze src/api/*.ts

# تحليل مع تقرير مفصل
claude analyze lib/utils.js --detailed

# تحليل وحفظ التقرير
claude analyze src/ --output analysis.md

الخيارات المتاحة:

  • --detailed: تقرير مفصل
  • --security: تحليل أمني
  • --output: حفظ التقرير

explain — شرح الكود

# شرح ملف
claude explain src/components/Button.tsx

# شرح دالة محددة
claude explain src/utils/api.js --function "fetchUser"

# شرح بمستوى التفصيل
claude explain src/ --level detailed

الخيارات المتاحة:

  • --level: مستوى التفصيل (basic, detailed, expert)
  • --function: شرح دالة محددة
  • --language: شرح بلغة محددة

generate — إنشاء الكود

# إنشاء مكون React
claude generate "أنشئ مكون React Button"

# إنشاء وحفظ مباشرة
claude generate "REST API endpoint" > src/api/users.ts

# إنشاء مع اختبارات
claude generate "login component" --test

# إنشاء من قالب
claude generate --template nextjs-api "users endpoint"

الخيارات المتاحة:

  • --test: إنشاء اختبارات مع الكود
  • --template: استخدام قالب
  • --output: حفظ في ملف محدد

chat — المحادثة التفاعلية

# بدء محادثة
claude chat

# محادثة مع ملفات
claude chat --files src/api/*.ts src/lib/db.ts

# محادثة في مجلد
claude chat --directory ./src

# محادثة مع git diff
claude chat --git-diff

# محادثة باسم محدد
claude chat --session "react-components"

الأوامر داخل المحادثة:

  • /clear: مسح السياق
  • /save: حفظ المحادثة
  • /exit: الخروج
  • /files <path>: إضافة ملفات
  • /model <name>: تغيير النموذج

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

scan — فهرسة المشروع

# فهرسة المشروع بالكامل
claude scan .

# فهرسة مجلد محدد
claude scan src/

# فهرسة مع استبعاد
claude scan . --exclude node_modules --exclude .next

# إعادة الفهرسة
claude scan . --reindex

refactor — إعادة الهيكلة

# تحويل إلى TypeScript
claude refactor src/legacy.js --to typescript

# تحويل إلى Hooks
claude refactor components/ --use-hooks

# تحسين الأداء
claude refactor src/utils/api.js --optimize

# إضافة error boundaries
claude refactor src/ --add-error-boundaries

# إعادة هيكلة مع حفظ النسخة الاحتياطية
claude refactor src/ --backup

debug — تصحيح الأخطاء

# تصحيح خطأ محدد
claude debug --error "TypeError: Cannot read property 'id'"

# تصحيح مع traces
claude debug src/app.js --trace

# تصحيح مع شرح
claude debug --explain "ReferenceError: user is not defined"

# تصحيح ملفات متعددة
claude debug --files src/api/*.ts --error "500 Internal Server Error"

review — مراجعة الكود

# مراجعة ملف
claude review src/utils/validation.ts

# مراجعة أمنية
claude review src/api/auth.ts --security

# مراجعة مع تقرير
claude review src/ --output review.md

# مراجعة PR
claude review --pr 123

أنواع المراجعة:

  • --security: مراجعة أمنية
  • --performance: مراجعة الأداء
  • --style: مراجعة الأسلوب
  • --testing: مراجعة الاختبارات

أوامر الاختبار والتوثيق

test — إنشاء الاختبارات

# إنشاء اختبارات لمكون
claude test src/components/Button.tsx

# اختبارات التكامل
claude test src/api/users.ts --integration

# اختبارات E2E
claude test src/ --e2e

# اختبارات بإطار محدد
claude test src/ --framework jest

document — إنشاء التوثيق

# توثيق ملف
claude document src/components/Button.tsx

# توثيق المشروع
claude document . --format readme

# توثيق API
claude document src/api/ --format api

# توثيق JSDoc
claude document src/ --format jsdoc

الصيغ المدعومة:

  • readme: README.md
  • api: توثيق API
  • jsdoc: JSDoc comments
  • markdown: Markdown عام

أوامر التكوين

config — إدارة الإعدادات

# عرض الإعدادات
claude config get all

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

# تعيين عدد الـ tokens
claude config set max-tokens 4000

# تعيين درجة الحرارة
claude config set temperature 0.2

# إعادة تعيين الإعدادات
claude config reset

الإعدادات الشائعة:

  • model: النموذج المستخدم
  • max-tokens: الحد الأقصى للـ tokens
  • temperature: درجة الإبداع (0-1)
  • timeout: مهلة الطلب

init — التهيئة الأولية

# التهيئة التفاعلية
claude init

# التهيئة مع إعدادات محددة
claude init --model claude-3-5-sonnet-20241022

# التهيئة بدون تفاعل
claude init --yes --api-key YOUR_KEY

أوامر مساعدة

--help — المساعدة

# مساعدة عامة
claude --help

# مساعدة لأمر محدد
claude chat --help
claude generate --help

version — النسخة

# عرض النسخة
claude --version

# عرض معلومات مفصلة
claude --version --verbose

أوامر متقدمة

export — تصدير البيانات

# تصدير محادثة
claude export --session "react-components" --format markdown

# تصدير التكوين
claude export config

# تصدير السجلات
claude export logs --last 7d

import — استيراد البيانات

# استيراد محادثة
claude import session.json

# استيراد تكوين
claude import config.json

الأوامر القصيرة (Aliases)

# اختصارات شائعة
c       # claude
a       # ask
ch      # chat
g       # generate
ex      # explain
d       # debug
r       # review
t       # test

مثال: سير عمل كامل

# 1. فهرسة المشروع
claude scan .

# 2. بدء محادثة
claude chat --files src/api/users.ts

# 3. داخل المحادثة
> "شرح لي هذا الملف"
> "ما هي المشاكل المحتملة؟"
> "أصلح المشاكل"

# 4. إنشاء اختبارات
claude test src/api/users.ts

# 5. مراجعة التغييرات
claude chat --git-diff

الخلاصة

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

  • ask — أسئلة سريعة
  • analyze — تحليل الملفات
  • generate — إنشاء الكود
  • chat — محادثات تفاعلية

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

  • scan — فهرسة
  • refactor — إعادة هيكلة
  • debug — تصحيح
  • review — مراجعة

أوامر الاختبار والتوثيق:

  • test — إنشاء اختبارات
  • document — إنشاء توثيق

استخدم claude --help للمزيد من المعلومات حول أي أمر!