نصائح CLI

34 نصيحة عملية لـ Claude Code CLI لتعزيز كفاءة التطوير

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

يجمع هذا الدليل 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. تمرير الإدخال عبر الأنبوب للتحليل¶

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

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

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).

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 للبدء من جديد.

لاستراتيجيات إدارة السياق المفصّلة (بما في ذلك معالجة تجاوز السعة في الجلسات الطويلة) → إدارة السياق

وضع الخطة¶

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

سير عمل Git¶

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

> Commit these changes

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

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

> Create a PR description for the current branch

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

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

gh pr diff 123 | claude "review this PR"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• تعلّم نصائح سير العمل لعمليات تطوير أكثر كفاءة

• استكشف إدارة السياق لمعالجة الجلسات الطويلة وتجاوز سعة token

• أعدّ إعداد CLAUDE.md لتخصيص سلوك Claude لمشروعك

• اطّلع على تكامل Codex لاستخدام أداة ذكاء اصطناعي أخرى

المؤسسات ←