# نصائح CLI

يجمع هذا الدليل 34 نصيحة عملية لـ Claude Code، من العمليات الأساسية إلى الميزات المتقدمة، لمساعدتك على تعظيم إمكانات Claude Code.

## العمليات الأساسية

### 1. الإكمال التلقائي لمسارات الملفات بمفتاح Tab

اضغط على `Tab` بعد كتابة `@` لإكمال مسارات الملفات تلقائيًا، دون الحاجة إلى تذكّر المسارات الكاملة.

### 2. استخدم @ للإشارة إلى الملفات بدقة

```
> Analyze security in @src/utils/auth.ts
> Compare @v1/api.js with @v2/api.js
```

الإشارات المباشرة إلى الملفات أدق من وصف مواقع الملفات.

### 3. تمرير الإدخال عبر الأنبوب للتحليل

```bash
git diff | claude "explain these changes"
cat error.log | claude "analyze error causes"
npm test 2>&1 | claude "analyze test failures"
```

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

| الاختصار | الوظيفة |
|----------|----------|
| `Tab` | الإكمال التلقائي لمسارات الملفات |
| `Esc` | مقاطعة الإخراج الحالي |
| `Ctrl+C` | إلغاء العملية الحالية |
| `↑` / `↓` | تصفح سجل الأوامر |
| `Shift+Tab` (ثلاث مرات من الوضع التلقائي، ومرتان من الوضع الافتراضي) | الدخول إلى وضع التخطيط |
| `Alt+Tab` / `Option+Tab` | تبديل وضع التفكير |

### 5. استخدم ! للأوامر السريعة

ضع `!` في البداية لتنفيذ أوامر shell مباشرة:

```
> !git status
> !npm run build
```

## أوامر الشرطة المائلة

### 6. الأمر /help: عرض جميع الأوامر

```
> /help
```

يعرض جميع أوامر الشرطة المائلة والاختصارات المتاحة.

### 7. الأمر /clear: مسح المحادثة

```
> /clear
```

امسح السياق قبل بدء مهام جديدة لتجنب التداخل مع المحادثات السابقة.

### 8. الأمر /compact: ضغط السجل

```
> /compact
```

استخدمه عندما يصبح السياق طويلًا جدًا؛ فهو يضغط السجل لتوفير tokens مع الحفاظ على المعلومات الأساسية.

### 9. الأمر /context: التحقق من استخدام السياق

```
> /context
```

يعرض النسبة المئوية لاستخدام السياق الحالي. فكّر في الضغط أو بدء جلسة جديدة عند 60%.

### 10. الأمر /model: تبديل النماذج

```
> /model opus
> /model sonnet
```

- **Opus 5.5**: المهام المعقدة، وتصميم البنية، والمشكلات الصعبة (الرائد الرئيسي الحالي)

- **Sonnet 5.5**: البرمجة اليومية، والتكرارات السريعة (فعّال من حيث التكلفة)

- **Haiku 5.5**: المهام الخفيفة والسريعة والبسيطة

الأسماء المستعارة (`opus` / `sonnet` / `haiku`) يحلّها Claude Code إلى أحدث إصدار؛ لتثبيت نموذج، اكتب المعرّف الكامل، على سبيل المثال `/model claude-opus-5-5` أو `/model claude-sonnet-5-5` أو `/model claude-haiku-5-5`. استخدم `/effort` لضبط شدة التفكير (راجع [دليل Adaptive Thinking](/docs/usage/adaptive-thinking)).

### 11. الأمر /memory: تحرير ذاكرة المشروع

```
> /memory
```

يفتح ملف CLAUDE.md لتحرير معايير المشروع وتفضيلاته.

### 12. الأمر /init: تهيئة إعدادات المشروع

```
> /init
```

دع Claude يحلّل مشروعك وينشئ ملف إعدادات CLAUDE.md.

### 13. قل فقط «Commit these changes»

```
> Commit these changes
```

يحلّل التغييرات تلقائيًا، وينشئ رسائل إيداع مناسبة، وينفّذ الإيداع.

ملاحظة: `/commit` ليس أمرًا مدمجًا في Claude Code (وهو غير موجود في قائمة الأوامر المدمجة الرسمية). لا يعمل إلا إذا وفّرت أنت أو إحدى الإضافات أمرًا مخصصًا أو skill. وإلا، فاطلب فقط من Claude تنفيذ الإيداع باللغة الطبيعية.

### 14. الأمر /review: مراجعة الشيفرة

```
> /review
```

يراجع التغييرات الحالية بحثًا عن مشكلات محتملة.

### 15. الأمر /resume: استئناف الجلسة

```
> /resume
```

استأنف جلسة محادثة سابقة لمتابعة العمل غير المكتمل.
## إدارة السياق

حتى 2026-10-15، تفيد وثائق Claude Code بأن Opus 4.7 وما بعده، وSonnet 5 وما بعده، وHaiku 5.5 تعمل بنافذة سياق سعة 1M token افتراضيًا، بينما يحتاج Opus 4.6 وSonnet 4.6 إلى المتغيّر `[1m]` وإلا فسيحصلان على 200K. أبقِ الجلسة الواحدة مركّزة على مهمة واحدة، واستخدم `/context` لمراقبة الاستخدام، و`/compact` لضغط السجل، و`/clear` للبدء من جديد.

لاستراتيجيات إدارة السياق المفصّلة (بما في ذلك معالجة تجاوز السعة في الجلسات الطويلة) → [إدارة السياق](/docs/usage/context-management)

## وضع الخطة

### 19. الدخول إلى وضع الخطة

اضغط `Shift+Tab` للتبديل إلى وضع الخطة (ثلاث مرات من الوضع التلقائي الافتراضي، ومرتين من `default`). سيبحث Claude ويُنشئ خططًا دون تعديل الشيفرة.

### 20. خطّط قبل التنفيذ

في المهام المعقّدة، اطلب من Claude إنشاء خطة أولًا:

```
> Analyze this feature requirement and create an implementation plan, don't write code yet
```

أكّد الخطة قبل التنفيذ لتقليل إعادة العمل.

### 21. نفّذ المهام المعقّدة خطوة بخطوة

قسّم المهام الكبيرة إلى خطوات أصغر:

```
> Step 1: Analyze the existing auth system
> Step 2: Design the new JWT approach
> Step 3: Implement core functionality
> Step 4: Add tests
```

## الوكلاء الفرعيون

### 22. استخدم وكيل Explore للبحث السريع

يتخصّص وكيل Explore في البحث السريع في قاعدة الشيفرة:

```
> Use the Explore agent to find all payment handling code
```

### 23. استخدم وكيل Plan للتصميم

يتخصّص وكيل Plan في تخطيط التنفيذ:

```
> Use the Plan agent to design the user permission system
```

### 24. وكلاء الخلفية للمهام المتوازية

أطلق عدة وكلاء في الخلفية لمعالجة المهام بالتوازي لتحسين الكفاءة.

## إعداد CLAUDE.md

`CLAUDE.md` ملف إعدادات على مستوى المشروع يقرأه Claude تلقائيًا عند بدء التشغيل. استخدم `/init` لإنشائه، أو أنشئه يدويًا. حدّد معايير الشيفرة والأوامر الشائعة وبنية المشروع لتجنّب تكرار ذلك في كل جلسة.

دليل الإعدادات الكامل مع أمثلة → [إعداد CLAUDE.md](/docs/usage/claude-md)

## سير عمل Git

### 28. رسائل commit الذكية

```
> Commit these changes
```

يحلّل Claude جميع التغييرات ويُنشئ رسائل commit مناسبة.

### 29. إنشاء أوصاف PR

```
> Create a PR description for the current branch
```

يُنشئ أوصاف PR تلقائيًا مع ملخّص التغييرات وخطة الاختبار.

### 30. تحليل تغييرات PR

```bash
gh pr diff 123 | claude "review this PR"
```

## الاختبار والتنقيح

### 31. اطلب من Claude كتابة الاختبارات

```
> Write unit tests for @src/services/UserService.ts
```

دع Claude يكتب الاختبارات للتحقق من صحة شيفرته.

### 32. تحليل إخفاقات الاختبارات

```bash
npm test 2>&1 | claude "analyze failures and fix"
```

### 33. تنقيح الأخطاء

```
> Analyze this error: [paste error message]
> Debug the issue in @src/pages/Login.tsx
```

## نصائح متقدمة

### 34. استخدام لقطات الشاشة/الصور

يدعم Claude Code فهم الصور:

```
> Look at this screenshot @screenshot.png and analyze UI issues
```

## مقارنة الكفاءة

| السيناريو | الطريقة التقليدية | Claude Code |
|----------|-------------|-------------|
| العثور على الشيفرة | grep + تصفّح يدوي | `@file` أو وكيل Explore |
| كتابة الاختبارات | يدوي + تنقيح | `/review` + إنشاء تلقائي |
| commit في Git | التفكير في الرسالة + كتابتها | قُل «Commit these changes» |
| مراجعة الشيفرة | مراجعة سطرًا بسطر | تحليل ذكي عبر `/review` |
| فهم الشيفرة | قراءة الوثائق + قراءة الشيفرة | اسأل Claude فقط |

## ملخّص أفضل الممارسات

1. **كن محدّدًا**: صِف المتطلبات بوضوح مع القيود

2. **استخدم المراجع**: استخدم `@` لتحديد الملفات وتجنّب التخمين

3. **خطوة بخطوة**: قسّم المهام المعقّدة إلى خطوات أصغر

4. **قاطع مبكرًا**: اضغط `Esc` فورًا إذا كان الإخراج خاطئًا

5. **ابقَ مركّزًا**: جلسة واحدة لمهمة واحدة

6. **اضغط السياق بانتظام**: استخدم `/compact` عندما يطول السياق

7. **خطّط أولًا**: أنشئ خططًا قبل المهام المعقّدة

8. **دع الذكاء الاصطناعي يختبر**: اطلب من Claude كتابة اختبارات للتحقق من شيفرته

## الخطوات التالية

- تعلّم [نصائح سير العمل](/docs/usage/workflow-tips) لعمليات تطوير أكثر كفاءة

- استكشف [إدارة السياق](/docs/usage/context-management) لمعالجة الجلسات الطويلة وتجاوز سعة token

- أعدّ [إعداد CLAUDE.md](/docs/usage/claude-md) لتخصيص سلوك Claude لمشروعك

- اطّلع على [تكامل Codex](/docs/ide/codex) لاستخدام أداة ذكاء اصطناعي أخرى