يضع Claude Code أقوى نماذج Anthropic للذكاء الاصطناعي مباشرة في الطرفية، لتكتب الشيفرة وتعدّلها وتصحّح أخطاءها وتنشرها بلغة إنجليزية بسيطة. يتناول هذا المقال الإعداد، وأولى أوامرك الفعلية، وعمليات الملفات، وسير عمل Git، واختصارات الإنتاجية التي تفرق فعلًا في التطوير اليومي.
إذا قضيت العام الماضي تشاهد أدوات البرمجة بالذكاء الاصطناعي تتكاثر في كل بيئة تطوير ومتصفح وإضافة ولوحة تحكم، فربما تتساءل أيّها يناسب طريقة عملك فعلًا. Claude Code هو جواب Anthropic على هذا السؤال، ويتّبع نهجًا مختلفًا عن قصد: بدلًا من أن يعمل من شريط جانبي أو من تبويب ويب، يعمل مباشرة داخل طرفيتك. تكتب، فيجيب. يقرأ ملفاتك، ويكتب الشيفرة ويعدّلها، ويشغّل الأوامر. وكل ذلك دون أن تضطر إلى مغادرة البيئة التي تنجز فيها أفضل عملك.
يستعرض هذا المقال المتطلبات المسبقة، والتثبيت، وأولى أوامرك، وسير العمل في الواقع، والإعدادات التي تهم بعد تجاوز الأساسيات.
اللحظة التي تشغّل فيها claude في طرفيتك، تختلف التجربة عن واجهة المحادثة. Claude Code هو مساعد برمجة وكيلي: لا يكتفي بالإجابة عن الأسئلة، بل يتخذ إجراءات. يقرأ الملفات، ويكتب الشيفرة، ويشغّل أوامر الصدفة (shell)، ويتنقل في بنية مشروعك بناءً على تعليمات بلغة إنجليزية بسيطة.
للفرق أسباب حقيقية. روبوت المحادثة يمنحك نصًا تنسخه وتلصقه. أما Claude Code فيفتح الملف بنفسه. روبوت المحادثة يفقد السياق حين تلصق مقتطفًا، بينما يقرأ Claude Code قاعدة شيفرتك كاملة ويحتفظ بها في السياق طوال الجلسة. وروبوت المحادثة ينتظر رسالتك التالية، أما Claude Code فيستطيع ربط خطوات متعددة ببعضها: تشغيل اختبار، وقراءة الفشل، وترقيع الشيفرة، وإعادة تشغيل الاختبار، كل ذلك في عملية متصلة واحدة.
هذا ما تعنيه Anthropic بكلمة "وكيلي" (agentic): النموذج يتخذ إجراءات حقيقية في بيئة حقيقية، لا يكتفي بتوليد نص تنفذه أنت يدويًا.
يملك Claude Code صلاحية الوصول إلى كل شيء في مجلد مشروعك افتراضيًا. إليك ما يتعامل معه:
النموذج الذي يشغّل كل ذلك هو Claude نفسه. إذا أردت تجربة قدرات Claude في المتصفح قبل نقل الأوامر النصية إلى سير عملك في الطرفية، توفّر لك PicassoIA وصولًا مباشرًا إلى Claude Opus 4.7 وClaude 4 Sonnet.
يعمل Claude Code على Node.js. قبل أي شيء آخر، تحقّق من الإصدار لديك:
node --version
تحتاج إلى Node 18 أو أحدث. إذا كنت تستخدم إصدارًا أقدم، فحدّثه عبر nvm، أو مدير الحزم في نظامك، أو المثبّت الرسمي من nodejs.org. يأتي مدير الحزم npm مع Node، لذلك لا يُطلب شيء إضافي هناك.
إليك مرجع سريع:
| المتطلب | أدنى إصدار | أمر التحقق |
|---|---|---|
| Node.js | 18.x أو أحدث | node --version |
| npm | 8.x أو أحدث | npm --version |
| الوصول إلى API من Anthropic | حساب نشط | console.anthropic.com |
يتصل Claude Code بواجهة API من Anthropic عبر حسابك. ستحتاج إلى بيانات اعتماد API من Anthropic Console. إذا كنت تستخدم Claude API في مشروع آخر، فالبيانات نفسها تعمل هنا. إنشاء حساب جديد وتوليد رمز يستغرق أقل من خمس دقائق.
💡 ملاحظة أمنية: خزّن بيانات اعتمادك في متغيّر بيئة أو في سلسلة المفاتيح (keychain) في نظامك. لا تكتبها أبدًا داخل ملف في المشروع، ولا ترفعها إلى نظام التحكم بالإصدارات. يتولى Claude Code التخزين الآمن تلقائيًا بعد خطوة المصادقة الأولى.
تُحتسب الفوترة عبر حسابك في Anthropic بالأسعار القياسية لواجهة API، وتُتابَع لكل توكن كما في الاستخدام المباشر للواجهة. بالنسبة لمعظم المطورين الذين يستخدمون Claude Code في عملهم اليومي الفعلي، تكون التكاليف مقاربة لاشتراك SaaS متوسط الفئة شهريًا، مع أن ذلك يختلف كثيرًا تبعًا لعدد مرات تشغيل الجلسات الطويلة متعددة الملفات.
ثبّت Claude Code بشكل عام عبر npm:
npm install -g @anthropic-ai/claude-code
هذا هو التثبيت كله. لا اعتماديات إضافية، ولا خطوة بناء، ولا حاجة لإعداد Docker. بعد انتهاء التثبيت، يصبح الأمر claude متاحًا في أي مكان في نظامك.
تحقّق من نجاح التثبيت:
claude --version
يجب أن ترى سلسلة نصية تمثل الإصدار في المخرجات. إذا ظهر أن الأمر غير موجود، فتأكد من أن مجلد الملفات التنفيذية العامة في npm مضاف إلى PATH لديك. على macOS مع nvm يكون عادةً ~/.nvm/versions/node/<version>/bin. وعلى Linux مع تثبيت Node للنظام، يكون غالبًا /usr/local/bin أو /usr/bin.
في أول مرة تشغّل فيها claude، سيرشدك إلى إعداد لمرة واحدة:
claude
ستُطلب منك لصق بيانات اعتماد API من Anthropic. يشفّر Claude Code هذه البيانات ويخزنها في التخزين الآمن لنظامك، فلن تحتاج إلى إدخالها مرة أخرى في الجلسات القادمة.
بعد المصادقة، تصل إلى واجهة تفاعلية (REPL) فيها موجّه ومؤشر يومض. هذا كل شيء. الأداة جاهزة.
> _
بعض الخيارات (flags) التي تستحق المعرفة منذ البداية:
| الخيار | الأثر |
|---|---|
--print | مخرجات لمرة واحدة، دون وضع تفاعلي |
--help | عرض جميع الخيارات المتاحة |
--version | عرض الإصدار المثبّت |
--dangerously-skip-permissions | الموافقة تلقائيًا على كل كتابة للملفات وكل الأوامر |
أكثر نقطة دخول طبيعية هي أن تطلب من Claude Code إنشاء شيء جديد. انتقل إلى مجلد المشروع وافتح جلسة:
claude
ثم اكتب طلبك بلغة إنجليزية بسيطة:
Create a Python script that reads a CSV file and outputs a statistical summary for each column.
يكتب Claude Code السكربت في مجلد العمل، ويختار اسم ملف مناسبًا، ويضيف الاستيرادات المناسبة ومعالجة الأخطاء، ثم يريك بالضبط ما أنتجه. لم تحدد اسم الملف ولا توقيعات الدوال ولا صيغة التعليقات التوثيقية (docstring). استنتج كل ذلك من السياق ومن أعراف Python المعتادة.
تظهر الطبيعة الحوارية في Claude Code بوضوح أكبر حين تتابع بسؤال لاحق:
Now add support for reading from multiple CSV files and merging them before generating the summary.
يقرأ Claude Code الملف الذي أنشأه للتو، ويحلل بنيته الحالية، ويوسّعه دون أن يكسر ما يعمل بالفعل. هذا الذهاب والإياب هو ما يميزه عن مولّدات الشيفرة ذات الطلب الواحد: كل متابعة تبني على الحالة الفعلية في مشروعك، لا على مقتطف منسوخ في نافذة دردشة.
بالنسبة لقواعد الشيفرة القائمة، يكون سير العمل مباشرًا بالقدر نفسه. افتح جلسة في جذر مشروعك وصف التغيير:
In src/api/users.js, the getUserById function makes two separate database calls when one would be sufficient. Fix it.
يقرأ Claude Code الملف، ويحدد موقع الدالة، ويعيد كتابتها، ثم يعرض عليك الفرق (diff) قبل إجراء أي تغيير. يمكنك الموافقة أو الرفض أو طلب نهج مختلف. دورة التعديل ثم التأكيد تُبقيك متحكمًا في كل تعديل دون إبطاء سير العمل.
بالنسبة للتغييرات الأوسع، يمكنك أن تكون أقل تحديدًا في طريقة التنفيذ:
Refactor the authentication middleware in src/middleware/ to use async/await instead of callbacks.
يمسح Claude Code المجلد، ويقرأ كل الملفات ذات الصلة، ويطبّق إعادة الهيكلة بثبات على كل شيء في عملية واحدة.
من أهم مزايا Claude Code مقارنةً بأدوات الإكمال التلقائي البسيطة قدرته على العمل عبر ملفات متعددة في جلسة واحدة. يمكنك أن تطلب منه:
يحتفظ النموذج بسياق قاعدة شيفرتك طوال الجلسة، ويستدل على العلاقات بين الملفات بشكل صريح. ولا يقتصر على ما هو مفتوح حاليًا في محررك، ولا يطلب منك جمع مقتطفات الشيفرة المناسبة ولصقها يدويًا في نافذة دردشة.
يتكامل Claude Code مع Git دون أي إعداد. داخل الجلسة، صف مقصدك ودعه يتولى تفاصيل الصدفة:
Commit the changes I just made with a meaningful commit message.
يشغّل Claude Code git diff --staged، ويقرأ ما تغيّر، ويكتب رسالة مناسبة استنادًا إلى محتوى الفرق الفعلي، ثم ينفّذ الإيداع. أو:
Create a new branch for the payment refactor and push it to origin.
إنشاء الفرع، والتبديل إليه، والدفع، كلها تُنفَّذ بالتسلسل دون أن تكتب أمر Git واحدًا.
💡 نصيحة: اطلب من Claude Code أن يشرح خطة Git قبل التنفيذ. اكتب
explain what you're about to doقبل أي عملية Git للحصول على معاينة بلغة إنجليزية بسيطة للأوامر الدقيقة التي سيشغّلها.
هذا مفيد بشكل خاص للمطورين الواثقين مما يريدون إنجازه، لكنهم أحيانًا يحتاجون إلى البحث عن الخيار الدقيق لحالة استثنائية. Claude Code يعرفها بالفعل.
افتراضيًا، يطلب Claude Code تأكيدك قبل كتابة الملفات أو تشغيل أوامر الصدفة. كل إجراء قد يكون غير قابل للتراجع يحصل على موجّه y/n قبل تنفيذه. هذا هو الإعداد الصحيح لبيئات الإنتاج وأي مشروع يهمك.
عندما تكون في نماذج أولية سريعة داخل مجلد مؤقت، يمكنك تجاوز هذه الموجّهات:
claude --dangerously-skip-permissions
أو امنح الموافقة التلقائية لجلسة كاملة من داخل الموجّه التفاعلي.
| الوضع | السلوك | الأنسب لـ |
|---|---|---|
| الافتراضي | يطلب التأكيد قبل كل الكتابات والأوامر | الشيفرة الإنتاجية والمشاريع الحقيقية |
| الموافقة التلقائية | ينفّذ فورًا دون موجّهات | النماذج الأولية والسكربتات المؤقتة |
| للقراءة فقط | لا كتابة ملفات ولا تنفيذ أوامر | مراجعة الشيفرة وجلسات الأسئلة والأجوبة |
في العمل اليومي على مشاريع حقيقية، يكون الوضع الافتراضي هو الصحيح. موجّهات التأكيد تضيف ثانيتين فقط، وتحميك من الكتابة فوق الملفات عن طريق الخطأ أو من تطبيق تغييرات خاطئة.
من أجل النماذج الأولية السريعة في مجلد مؤقت، تسرّع الموافقة التلقائية التكرار بشكل ملحوظ. يمكنك تجربة عشرات الاختلافات لسكربت في دقائق دون أن تقطع تدفق الإبداع.
من أجل قراءة الشيفرة غير المألوفة ومراجعتها، يستحق وضع القراءة فقط أن تستخدمه عن قصد. يستطيع Claude Code قراءة قاعدة شيفرة كاملة، وشرح طريقة عملها، والإجابة عن الأسئلة المعمارية، وتتبّع تدفق البيانات دون أن يلمس ملفًا واحدًا في مستودعك.
حين يفشل اختبار ولا يكون سبب تتبّع المكدس (stack trace) واضحًا من النظرة الأولى، فإن حلقة التصحيح في Claude Code تقلّص وقت الوصول إلى الحل بشكل كبير:
The test suite is failing. Read the output in /tmp/test-results.log and identify the root cause.يقرأ Claude Code السجل، ويتتبّع الملفات المصدرية ذات الصلة، ويحدد بدقة ما يسبب الفشل. وفي معظم الحالات يقترح أيضًا إصلاحًا. توافق، يُعاد تشغيل الاختبار، فينجح.
ما كان يستغرق في السابق 30 دقيقة من قراءة تتبّعات المكدس والبحث عن الدالة المعنية وتتبّع سلاسل الاستدعاء، يستغرق الآن بضع دقائق من الحوار.
قبل فتح طلب سحب (pull request)، استخدم Claude Code كمراجِع أولي:
Review my changes in this branch compared to main. Focus on logic errors, missing error handling, and anything that would fail under edge cases.
يشغّل Claude Code git diff main، ويقرأ كل ملف تغيّر، ثم يُخرج قائمة منظّمة بالمشكلات مع إشارات دقيقة إلى الأسطر. لن يلتقط كل ما يلتقطه مراجع بشري، لكنه يلتقط الأخطاء الواضحة قبل أن يُنفق زملاؤك وقتهم عليها.
💡 نصيحة في الأوامر النصية: اطلب منه أن يكون ناقدًا. جرّب:
Assume this code will be reviewed by a senior engineer who values correctness and simplicity. Be specific about what is wrong and why.تتحسن جودة الملاحظات كثيرًا مع صياغة أكثر توجيهًا.
من أجل التغييرات المنهجية عبر قاعدة شيفرة كاملة، صف القاعدة ودع Claude Code يطبّقها على نطاق واسع:
We are renaming the User model to Account across the entire codebase. Update all references, including imports, variable names, type annotations, and database migration files.
يمسح Claude Code كل شيء، ويبني قائمة بالتغييرات، ويعرض عليك حجم ما سيعدّله، وينتظر تأكيدك، ثم ينفّذ. إعادة تسمية كانت ستستغرق 40 دقيقة من البحث والاستبدال في محررك يمكن أن تنتهي في أقل من خمس دقائق.
أهم شيء في صياغة طلبات إعادة الهيكلة هو الدقة في النطاق والقاعدة المطبّقة. كلما وصفت بدقة ما يتغيّر وما يبقى كما هو، طبّقها Claude Code بدقة واتساق أكبر عبر آلاف الأسطر.
يبحث Claude Code عن ملف CLAUDE.md في جذر مشروعك عند بداية كل جلسة. هنا تخزّن التعليمات الخاصة بالمشروع التي يجب أن تنطبق على كل تفاعل:
# MyProject
## Architecture
- Backend: Express.js with TypeScript
- Database: PostgreSQL via Prisma ORM
- Tests: Vitest, not Jest
## Conventions
- Use named exports, never default exports
- Error handling follows a Result type pattern, not try/catch
- All database calls go through the service layer, never directly in route handlers
مع وجود CLAUDE.md، لن تحتاج إلى إعادة شرح أعراف مشروعك في بداية كل جلسة. يقرأ Claude Code الملف تلقائيًا، ويطبّق تلك القواعد على كل ملف يكتبه أو يعدّله خلال الجلسة.
هذا من أكثر الاستثمارات عائدًا حين تعمل مع Claude Code على مشروع حقيقي. عشرون سطرًا من سياق المشروع، تُكتب مرة واحدة، تحسّن جودة كل جلسة تالية. ويتعامل مستخدمو Claude Code ذوو الخبرة مع ملفات CLAUDE.md بالطريقة نفسها التي يتعاملون بها مع README.md: يحدّثونها كلما تغيّرت الأعراف، ويعاملونها كوثيقة حيّة.
يعمل Claude Code بنماذج Claude من Anthropic، وهي البنية نفسها من الذكاء الاصطناعي المصممة للاستدلال المعقد وتحليل السياقات الطويلة وتوليد الشيفرة الدقيقة. إذا أردت صياغة الأوامر النصية واختبارها في المتصفح، أو مقارنة مخرجات النماذج قبل اعتماد نهج معين، أو مجرد تنفيذ مهمة سريعة دون فتح جلسة طرفية، فإن PicassoIA يوفّر لك وصولًا مباشرًا إلى مجموعة Claude الكاملة دون أي إعداد.
Claude Opus 4.7 هو الخيار الأقدر على الاستدلال الثقيل والتخطيط المعماري والمهام المعقدة متعددة الخطوات. أما Claude 4.5 Sonnet فهو الخيار الموثوق للبرمجة والكتابة اليومية، بتوازن ممتاز بين السرعة والدقة. وللاستجابات السريعة والمهام الأخف، يُعدّ Claude 4.5 Haiku الأسرع في عائلة Claude.
يجمع PicassoIA أيضًا مجموعة واسعة من أحدث نماذج الذكاء الاصطناعي في مكان واحد. GPT-5 لأحدث قدرات الاستدلال والتوليد من OpenAI. DeepSeek R1 لأداء النماذج مفتوحة الأوزان. Gemini 2.5 Flash للمهام متعددة الوسائط السريعة. كل ذلك متاح عبر واجهة واحدة، دون أي إعداد لواجهة API من جهتك.
إذا كنت تستخدم Claude Code يوميًا في طرفيتك، فخصّص خمس عشرة دقيقة على PicassoIA. صغ أوامرك في المتصفح، واختبر كيف تستجيب النماذج المختلفة للطلب نفسه، ثم انقل ما نجح إلى جلسات الطرفية. الأداتان تكمل إحداهما الأخرى: واحدة حين تكون غارقًا في جلسة برمجة وملفاتك مفتوحة، وأخرى حين تريد التفكير في نهج قبل أن تلتزم به.
اختر لغتك
