Claude Code: الاستخدام الأساسي لـ Claude Code
آخر تحديث: 2026-08-31
الاستخدام الأساسي هو أدوات Claude Code اليومية — من كتابة الأكواد إلى إصلاح الأخطاء، من إعادة الهيكلة إلى كتابة الاختبارات، تغطي سيناريوهات العمل الأساسية للمطورين.
💡 نصيحة: أكبر قوة لـ Claude Code ليست الإجابات الفردية، بل القدرة على الحلقة المغلقة "فهم المشروع ← تعديل الكود ← تحقق من النتائج ← تكرار الإصلاحات".
📋 المتطلبات المسبقة: الفصل 7 - الوضع التفاعلي ودليل العمليات
1. ما ستتعلمه
- توليد وإكمال الأكواد
- إصلاح الأخطاء والتنقيح
- إعادة هيكلة الأكواد
- كتابة الاختبارات
- مراجعة الأكواد
- توليد التوثيق
2. توليد الأكواد
(1) إنشاء ملفات من الصفر
TEXT
📖 للعرض فقط
> Create src/services/email.ts with email sending service:
> - Support HTML and plain text formats
> - Use template engine for rendering
> - Add retry mechanism (max 3 attempts)
> - Write unit tests (mock SMTP)
Claude Code:
→ Creating src/services/email.ts
→ Creating src/services/__tests__/email.test.ts
→ Installing dependencies: nodemailer, handlebars
→ Running: npm test -- email.test.ts
✅ 5 tests passed
(2) التوسع بناءً على كود موجود
TEXT
📖 للعرض فقط
> Add password reset functionality to UserService
Claude Code:
→ Reading src/services/user.ts
→ Reading src/models/user.ts
→ Reading src/services/email.ts (existing email service)
→ Modifying src/services/user.ts (adding resetPassword)
→ Modifying src/routes/user.ts (adding POST /reset-password)
→ Creating tests for password reset
✅ All tests passed
▶ مثال 1: توليد وحدة CRUD
TEXT
📖 للعرض فقط
> Create complete Product CRUD module:
> 1. Prisma model definition
> 2. Repository layer
> 3. Service layer
> 4. Controller layer
> 5. Route definitions
> 6. Complete tests
Claude Code: Created 6 files, 12 tests all passing ✅
3. إصلاح الأخطاء
(1) تحديد إصلاح خطأ
TEXT
📖 للعرض فقط
> Fix the relativeTime calculation error in src/utils/date.ts when crossing years
Claude Code:
→ Reading src/utils/date.ts
→ Found bug: relativeTime uses daysOnly comparison
→ Fixing: adding year boundary check
→ Running: npm test -- date.test.ts
✅ All tests passed (including new edge case)
(2) إصلاح بناءً على رسائل الخطأ
TEXT
📖 للعرض فقط
> Run tests and fix all failing cases
Claude Code:
→ Running: npm test
❌ 3 tests failed
→ Reading failed test files...
→ Fixing each failing test
→ Running: npm test
✅ All 47 tests passed
▶ مثال 2: إصلاح خطأ وقت التشغيل
TEXT
📖 للعرض فقط
> App startup error: TypeError: Cannot read property 'id' of undefined at UserController.getProfile
Claude Code:
→ Found: getProfile doesn't check if req.user exists
→ Adding null check with proper error response
→ Running: npm test -- user.controller.test.ts
✅ All tests passed
4. إعادة هيكلة الأكواد
(1) إعادة هيكلة على مستوى الدالة
TEXT
📖 للعرض فقط
> Refactor formatCurrency in src/utils/format.ts to use Intl.NumberFormat
Claude Code:
→ Replacing manual formatting with Intl.NumberFormat
→ Adding locale support (default: en-US)
→ Running: npm test -- format.test.ts
✅ All tests passed
(2) إعادة هيكلة على مستوى الوحدة
TEXT
📖 للعرض فقط
> Reorganize all utility functions under src/helpers/ into src/utils/ by function:
> - Date related → utils/date.ts
> - String related → utils/string.ts
> - Number related → utils/number.ts
> Update all import paths
Claude Code:
→ Moving functions with proper exports
→ Updating 32 import statements
→ Deleting src/helpers/
→ Running: npm test
✅ All 89 tests passed
5. كتابة الاختبارات
▶ مثال 3: توليد اختبارات دفعي
TEXT
📖 للعرض فقط
> Write tests for all services under src/services/ without tests, coverage target 80%
Claude Code:
→ Scanning 8 service files
→ Missing tests found in 3 services
→ Writing tests for each
→ Running: npm test
✅ All new tests passed
Coverage average: 85% ✓
6. مراجعة الأكواد والتوثيق
(1) مراجعة الأكواد
TEXT
📖 للعرض فقط
> Review src/auth/jwt.ts for security issues
Claude Code:
⚠️ Found 3 issues:
1. Hardcoded secret key (line 12) → Use env variable
2. No token expiry validation (line 34) → Add expiry check
3. Algorithm not specified (line 8) → Force RS256
(2) توليد التوثيق
TEXT
📖 للعرض فقط
> Generate API documentation for all routes under src/api/
Claude Code:
→ Reading all route files (12 files)
→ Generating docs/api.md with endpoint listing, examples, and error codes
7. مثال شامل: تطوير بسير كامل
TEXT
📖 للعرض فقط
> Implement user permission system:
> 1. Define Role and Permission models
> 2. Implement RBAC middleware
> 3. Add permission check decorators
> 4. Write complete integration tests
> 5. Generate API documentation
Claude Code: 8 files created, 4 modified, 15 tests passing ✅
❓ أسئلة شائعة
س كيف جودة الأكواد المُولّدة من Claude Code؟
ج عالية للأنماط الشائعة والتنفيذات القياسية. منطق الأعمال المعقد والحالات الخاصة لا تزال تحتاج مراجعة بشرية. راجع دائماً الأكواد المُولّدة.
س هل يمكنه إصلاح أخطاء متعددة دفعة واحدة؟
ج نعم. صِف كل خطأ بوضوح وسيصلحها واحداً تلو الآخر. لكن التركيز على خطأ واحد في كل مرة يقلل احتمال الخطأ.
س هل ستكسر إعادة الهيكلة الوظائف الموجودة؟
ج إذا كان المشروع لديه اختبارات شاملة، Claude Code يضمن نجاحها. بدون اختبارات، إعادة الهيكلة أخطر — يُوصى بإضافة اختبارات أولاً.
س هل الاختبارات مكتوبة جيداً؟
ج جودة اختبارات الوحدة جيدة، خاصة للمسارات السعيدة وحالات الحدود الشائعة. شروط الحدود وسيناريوهات المحاكاة المعقدة قد تحتاج إكمالاً يدوياً.
س هل يمكن لمراجعة الأكواد أن تحل محل المراجعة البشرية؟
ج ليس بالكامل. Claude Code ممتاز في اكتشاف مشاكل الأمان الشائعة ومشاكل الأسلوب، لكن صحة منطق الأعمال لا تزال تتطلب حكماً بشرياً.
س كيف أجعل Claude Code يتبع أسلوب أكواد المشروع؟
ج اكتب اتفاقيات البرمجة في CLAUDE.md. أيضاً اجعله يقرأ إعدادات ESLint/Prettier أولاً.
📖 ملخص
- توليد الأكواد: من ملفات فردية إلى وحدات CRUD كاملة
- إصلاح الأخطاء: تحديد وإصلاح تلقائي بناءً على رسائل الخطأ أو الأوصاف
- إعادة الهيكلة: من مستوى الدالة إلى مستوى الوحدة، تحديث جميع المراجع تلقائياً
- الاختبارات: إكمال الاختبارات دفعياً، ضمان تحقيق أهداف التغطية
- المراجعة والتوثيق: مراجعة أمان، توليد توثيق API تلقائي
- الميزة الأساسية: حلقة مغلقة فهم ← تعديل ← تحقق ← تكرار
📝 تمارين
- أساسي (⭐): استخدم Claude Code لتوليد اختبارات وحدة لدالة، تحقق من جودة الاختبار.
- متوسط (⭐⭐): أدخل خطأً متعمداً، استخدم Claude Code لإصلاحه، راقب عملية التحديد والإصلاح.
- متقدم (⭐⭐⭐): اجعل Claude Code يكمل وحدة ميزة كاملة (نموذج+خدمة+مسار+اختبار+توثيق)، راجع جميع الأكواد المُولّدة.