يضع Claude Code مهندس ذكاء اصطناعي قويًا مباشرةً داخل الطرفية (Terminal) لديك. يستعرض هذا المقال كل شيء، من التثبيت إلى أولى سير العمل الحقيقية: كتابة الشفرة، ومراجعة الملفات، وتشغيل الاختبارات، وأتمتة المهام التي كانت تستغرق ساعات. لا حاجة إلى أي خبرة سابقة في الذكاء الاصطناعي.
يمرّ كل مطوّر بلحظة يدرك فيها أنه كان يعمل بالطريقة الصعبة. Claude Code هو الأداة التي تصنع هذه اللحظة مرارًا وتكرارًا. يعمل داخل الطرفية لديك، ويفهم قاعدة الشفرة الخاصة بك، ويساعدك في المهام الحقيقية: كتابة الدوال، واكتشاف الأخطاء، وتشغيل الاختبارات، وإعادة هيكلة المنطق المتشابك. هذا ليس روبوت دردشة. إنه وكيل برمجي من تطوير Anthropic، صُمّم للعمل على مشاريع فعلية لا افتراضية.
إن لم تستخدمه من قبل، سيأخذك هذا المقال من الصفر حتى تصبح منتجًا. دون أي وقت ضائع.
هناك فرق جوهري بين روبوت الدردشة والوكيل. روبوت الدردشة يرد على الرسائل. أما الوكيل فيتخذ إجراءات. يعمل Claude Code داخل الطرفية لديك مع وصول مباشر إلى نظام الملفات، وسجل git، والصدفة (Shell). يمكنه قراءة أي ملف في مشروعك، وكتابة الشفرة وحفظها، وتشغيل الأوامر، وملاحظة النتائج.
لا تلصق الشفرة في نافذة دردشة. بل تعمل داخل مجلد مشروعك الفعلي، وتتحاور مع شيء يرى قاعدة الشفرة بأكملها بالفعل.
💡 فكّر في الأمر هكذا: معظم أدوات الذكاء الاصطناعي ترى المقتطف الذي تلصقه. أما Claude Code فيرى كل شيء.
معظم ميزات الذكاء الاصطناعي المدمجة في المحررات تعمل على مستوى الملف: تكمل الأسطر تلقائيًا، أو تقترح توقيع دالة، أو تشرح التحديد. أما Claude Code فيعمل على مستوى المشروع. اطلب منه إصلاح خطأ، وسيتتبعه عبر ملفات متعددة، ويفهم كيف تترابط، ويكتب إصلاحًا يعمل في سياقه. واطلب منه كتابة الاختبارات، وسيقرأ الأنماط القائمة في مجموعة اختباراتك ويتبعها.
يصبح هذا الفرق واضحًا في المرة الأولى التي تسأل فيها سؤالًا مثل: "لماذا تُرجع نقطة النهاية (API endpoint) هذه الرمز 500 في الإنتاج لكنها تعمل محليًا؟" فيتوصل إلى الحل فعلًا.
قبل التثبيت، تأكد من توفر ما يلي:
node --version للتحقق)يعمل Claude Code على macOS وLinux وWindows عبر WSL. والتثبيت حزمة npm عامة واحدة تستغرق أقل من دقيقة.
افتح الطرفية لديك وشغّل:
npm install -g @anthropic-ai/claude-code
بعد التثبيت، انتقل إلى أي مجلد مشروع واكتب:
claude
في التشغيل الأول، سيرشدك خلال المصادقة بحسابك في Anthropic. وبعد ذلك تكون جاهزًا لكل جلسة لاحقة.
💡 وضع السطر الواحد: استخدم
claude -p "your question here"للاستعلامات السريعة دون فتح جلسة تفاعلية. مفيد للفحوص السريعة من النصوص البرمجية أو مسارات CI.
يعرض لك Claude Code كل إجراء قبل تنفيذه. وعندما يريد تعديل ملف، يعرض لك الفرق (diff). وعندما يريد تشغيل أمر في الصدفة، يسألك أولًا. تؤكد بالضغط على y أو ترفض بالضغط على n. لا يحدث أي شيء في قاعدة الشفرة دون موافقتك الصريحة.
هذه ليست مجرد ميزة أمان. إنها الآلية التي تبني الثقة في الأداة. ترى بالضبط ما يفعله ولماذا، وهو ما يعني أنك تبقى المسيطر حتى عندما يتحرك بسرعة.
انتقل إلى مجلد مشروعك وشغّل الجلسة التفاعلية:
cd my-project
claude
يقرأ Claude Code بنية مشروعك، ويلتقط أي ملف CLAUDE.md، ويصبح جاهزًا لتلقي الطلبات. وأول أمر نصي طبيعي هو أن تكتب ببساطة:
What does this project do and how is it structured?
حتى لو كان المشروع من بنائك، فإن الرد يستحق القراءة. يبرز التبعيات، والأنماط، والقرارات المعمارية التي يسهل نسيانها. وإذا ورثت شفرة شخص آخر، فهذا وحده يوفر ساعات من القراءة اليدوية.
كل عملية على الملفات واضحة. عندما تطلب من Claude Code تغيير شيء ما، يخبرك بما ينوي فعله، ويعرض عليك الفرق المقترح، وينتظر تأكيدك. يبدو التفاعل هكذا:
You: Add rate limiting to the POST /api/comments endpoint
Claude Code: I'll add rate limiting to the comments endpoint. Here's what I plan to do:
- Read src/routes/comments.ts
- Import the existing rate limiter from middleware/rateLimit.ts
- Apply it to the POST handler
[Shows diff]
Approve? (y/n)
يتكرر هذا النمط في كل شيء. يقرأ، ويقترح، وأنت تقرر.
داخل جلسة Claude Code، تمنحك أوامر الشرطة المائلة (slash commands) وصولًا فوريًا إلى الوظائف الشائعة:
| الأمر | وظيفته |
|---|---|
/help | يعرض كل الأوامر والخيارات المتاحة |
/clear | يمسح سجل المحادثة لتحرير السياق |
/compact | يلخص الجلسة للحفاظ على مساحة السياق |
/status | يعرض النموذج الحالي واستهلاك التوكنات |
/review | يبدأ مراجعة شفرة منظمة للتغييرات الأخيرة |
/cost | يعرض تكلفة الجلسة الحالية |
الأمر الذي ستستخدمه أكثر في الأسبوع الأول هو /clear. عندما يطول خيط المحادثة، تمتلئ نافذة السياق. وبدلًا من بدء جلسة طرفية جديدة، يعيد /clear ضبط المحادثة مع بقائك في المجلد نفسه.
يملك Claude Code نافذة سياق محدودة تحدد مقدار ما يستطيع الاحتفاظ به في الذاكرة في وقت واحد. في قواعد الشفرة الكبيرة، لا يستطيع قراءة كل الملفات في آن واحد. بدلًا من ذلك، يقرأ الملفات عند الطلب بحسب ما تقتضيه المحادثة.
قواعد عملية للحصول على أفضل النتائج:
/compact في الجلسات الطويلة: عندما تكون قد عملت لفترة، يلخّص الضغط (compacting) المحادثة في سياق مكثف يحفظ القرارات ذات الصلةكلما كانت تعليماتك أدق، احتاج Claude Code إلى التخمين أقل، وقلّ استهلاك التوكنات في طلب التوضيحات.
هنا يقدم Claude Code أوضح قيمة فورية. بدلًا من تتبع الخطأ يدويًا عبر ملفات متعددة، جرّب هذا:
The processPayment function in src/payments/processor.ts fails silently
when the currency is not USD. It should throw a ValidationError but it
returns undefined instead. Find the issue and fix it.
سيقرأ Claude Code الدالة، ويتتبع تبعياتها عبر الملفات ذات الصلة، ويحدد مسار المنطق الذي يتسبب في العودة الصامتة، ثم يقترح إصلاحًا مستهدفًا مع شرح. ما قد يستغرق 30 دقيقة من التنقيب الأثري في console.log يستغرق 2 دقيقة من المحادثة.
💡 ضمّن دائمًا وصف الفشل: أخبر Claude Code بما كنت تتوقعه، وبما حدث فعلًا، وبأي رسائل خطأ تراها. هذا السياق يقلص وقت التشخيص بشكل ملحوظ.
اختبارات الوحدة هي المهمة التي يؤجلها معظم المطورين. يزيل Claude Code معظم عناء ذلك:
Write unit tests for the NotificationService in src/services/notifications.ts.
Match the style and structure of existing tests in __tests__/services/
يقرأ ملفات الاختبار الحالية، ويحدد إعداد مشغّل الاختبارات لديك، ويطابق نمط تداخل describe/it، ويكتب اختبارات للمنطق الفعلي لصنفك. ليس قوالب عامة، بل تغطية حقيقية لحالات الحد في تلك الخدمة تحديدًا.
يعمل هذا جيدًا بشكل خاص مع الدوال التي تتردد في تغييرها. اكتب الاختبارات أولًا لتكوين شبكة أمان، ثم أعد الهيكلة بثقة.
كل قاعدة شفرة فيها دالة كان أحدهم يخشى المساس بها. يتعامل Claude Code مع هذه الدوال بكفاءة:
The handleIncomingWebhook function in src/webhooks/handler.ts is 250 lines
and does too many things. Break it into smaller, focused functions with
clear responsibilities. Do not change the external interface.
يحلل الدالة، ويحدد الحدود المنطقية، ويسمي كل جزء مستخرج تسمية معقولة، ويعرض عليك النتيجة. توافق على أجزاء محددة أو ترفضها. والقيد المتعلق بالحفاظ على الواجهة الخارجية يعني أن المستدعين لن يتأثروا.
وهذا مفيد بشكل خاص عند وراثة قاعدة شفرة: بدلًا من قضاء أيام في الخوف من لمس الأشياء، يمكنك تنظيف ما يعيقك بشكل منهجي.
السبب الأكبر لضعف المخرجات هو الأوامر النصية غير الدقيقة. قارن بين هذين:
ضعيف: Fix the login bug
أقوى: The POST /auth/login endpoint returns 401 when the email address contains uppercase letters. Users with mixed-case emails cannot log in. Find the issue and fix it.
تمنح النسخة الثانية Claude Code نقطة بداية، وأعراض المشكلة، وقيدًا. يمكنه أن يتصرف فورًا بدلًا من طرح أسئلة توضيحية أو وضع افتراضات خاطئة.
اكتب أوامرك كما تكتب تذكرة لمطور آخر: معلومات كافية كي يبدأ دون أن يسألك أي شيء.
أقوى الميزات وأكثرها إغفالًا. يقرأ Claude Code تلقائيًا ملف CLAUDE.md في جذر مشروعك عند بداية كل جلسة. وهذه ذاكرة خاصة بالمشروع.
يحتوي ملف CLAUDE.md المفيد على:
## Commands
- npm test: Run Jest test suite
- npm run dev: Start dev server on port 3000
- npm run build: Compile TypeScript
## Architecture
- All API routes in src/routes/
- Business logic in src/services/
- Database models in src/models/
## Conventions
- Use named exports only
- Async functions must always handle errors explicitly
- Never commit console.log statements
بدون CLAUDE.md، تبدأ كل جلسة بإعادة قراءة Claude Code لمشروعك من الصفر. ومع وجوده، يعرف بالفعل الأعراف والأوامر والأنماط منذ أول أمر نصي.
إن لم تفعل شيئًا آخر في اليوم الأول، فأنشئ هذا الملف.
يتفوق Claude Code في أعمال تكامل API. إذا كان مشروعك يستدعي أي خدمة خارجية، سواء كانت معالج دفعات، أو نظام إشعارات، أو واجهة توليد صور، فإن Claude Code يساعدك على بناء هذه التكاملات واختبارها وتكرارها بسرعة.
بالنسبة للمطورين الذين يبنون أدوات إبداعية أو منصات محتوى، يكون الجمع مع توليد الصور بالذكاء الاصطناعي قويًا بشكل خاص. تتيح أدوات مثل GPT Image 2 وFlux 3 Ultra على PicassoIA توليد أصول بصرية عالية الجودة من أوامر نصية. ويتولى Claude Code الجانب الخلفي: كتابة غلاف API، ومعالجة تحليل الاستجابات، وبناء واجهة عرض النتائج، وكتابة الاختبارات التي تتحقق من أن كل شيء يعمل.
تنتج Seedream 4.5 من ByteDance صورًا بدقة 4K ذات واقعية بصرية عالية. وينتج Flux 2 Ultra من Black Forest Labs مخرجات مفصلة بسرعة. وبناء تكاملات لأيٍّ منهما باستخدام Claude Code يعني أن وقتك يذهب إلى قرارات المنتج، لا إلى عملاء HTTP النمطيين.
💡 سير عمل حقيقي: استخدم Claude Code لتهيئة التكامل وكتابة الاختبارات على استجابات محاكاة، ثم اختبر مع النماذج الحية على PicassoIA. كلا طرفي هذه الحلقة أسرع مع الأدوات المناسبة.
المهام التي تستنزف الطاقة تكون عادة منخفضة في المتطلبات الذهنية لكنها مرتفعة في تكلفة التنفيذ: كتابة الشفرة النمطية، ونشر تغييرات الأنواع عبر الملفات، وإضافة معالجة الأخطاء إلى 15 دالة متشابهة، وتوليد سكربتات الترحيل، وتحديث التوثيق ليتوافق مع تغييرات الشفرة الأخيرة.
Claude Code سريع في كل هذه المهام. لا يتعب، ولا يُدخل تناقضات، وينجز في ثوانٍ ما يستغرقك 45 دقيقة. والتحول في الإنتاجية ليس طفيفًا.
| المهمة | التقدير اليدوي | مع Claude Code |
|---|---|---|
| كتابة اختبارات لعدد 10 من الدوال | 90 دقيقة | 10 دقائق |
| إعادة هيكلة دالة من 300 سطر | 60 دقيقة | 15 دقيقة |
| التعرّف على قاعدة شفرة جديدة | 2-3 أيام | عدة ساعات |
| إضافة معالجة الأخطاء عبر كل المسارات | 45 دقيقة | 5 دقائق |
| توليد أنواع TypeScript من JSON | 30 دقيقة | دقيقتان |
تتفاوت هذه الأرقام بحسب تعقيد المشروع ومدى دقة كتابتك للأوامر النصية. ويتحسن الاثنان مع الممارسة.
قبل أدوات مثل Claude Code، كان وراثة مشروع غير موثق تعني أيامًا من القراءة قبل أن تتمكن من المساهمة. أما الآن فتطرح أسئلة مباشرة: "كيف تعمل المصادقة في قاعدة الشفرة هذه؟" أو "تتبّع ما يحدث عندما يرسل المستخدم هذا النموذج." وتحصل على إجابات دقيقة لأن Claude Code يقرأ ملفات المصدر الفعلية، لا ملخصًا كتبه أحدهم قبل شهور.
هذا يغيّر التأهيل (onboarding) من الأساس، سواء كنت تنضم إلى فريق جديد أو تعود إلى مشروع تركته قبل ستة أشهر.
Claude Code من النوع الذي يسترد كلفة تعلمه في أول جلسة حقيقية. يستغرق التثبيت خمس دقائق. وتظهر أول نتيجة مفيدة فعلًا خلال ساعة. والسبب الوحيد للتأجيل هو أنك لم تجربه بعد.
ثبّته على مشروعك الحالي. اكتب CLAUDE.md. اطلب منه شرح قاعدة الشفرة، ثم اطلب منه إصلاح شيء صغير. لن تعود إلى العمل دونه.
عندما يحتاج مشروعك إلى أصول بصرية تواكب جودة ما تبنيه، يوفر PicassoIA أكثر من 91 نموذجًا لتحويل النص إلى صورة، منها Flux 3 Ultra، وGPT Image 2، وSeedream 4.5، وغيرها الكثير. اكتب الشفرة مع Claude Code، وولّد الصور على PicassoIA. هذا المزيج يتولى أكثر مما يستطيع معظم المطورين الأفراد إنجازه يدويًا، وفي جزء بسيط من الوقت.
اختر لغتك
