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 أولاً.

📖 ملخص


📝 تمارين

  1. أساسي (⭐): استخدم Claude Code لتوليد اختبارات وحدة لدالة، تحقق من جودة الاختبار.
  2. متوسط (⭐⭐): أدخل خطأً متعمداً، استخدم Claude Code لإصلاحه، راقب عملية التحديد والإصلاح.
  3. متقدم (⭐⭐⭐): اجعل Claude Code يكمل وحدة ميزة كاملة (نموذج+خدمة+مسار+اختبار+توثيق)، راجع جميع الأكواد المُولّدة.
Web-Tutorial.com

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

100%