إتقان Claude Code2 / 12
التثبيت + سير العمل المضاد للجاذبية
تثبيت Claude Code يستغرق 30 ثانية. أمّا إعداد سير العمل الذي يجعل الوكيل يبدو وكأنّه يقوم بكلّ العمل الثقيل — فهذا الجزء الذي لا يكتب عنه أحد.
تتوقّف معظم أدلّة "ابدأ مع Claude Code" عند npm install. هذا ليس بدءًا. هذا مجرّد تثبيت ملفّ تنفيذي.
السؤال الحقيقي هو: كيف تضبط طرفيّتك حتى يصبح إعطاء هدف لوكيل أسهل من كتابة الكود بنفسك؟
هذا ما أسمّيه سير العمل المضاد للجاذبية. حين تمتلكه، تتوقّف عن اللجوء إلى الإكمال التلقائي. ويصبح التفويض هو الافتراضي.
الخطوة 1 — التثبيت (30 ثانية)
# يتطلّب Node.js >= 18
npm install -g @anthropic-ai/claude-code
# تحقّق
claude --version
هذا كل شيء. لا لوحة تحكّم SaaS، لا OAuth، لا إضافة محرّر تحتاج إلى تصحيح. أوّل مرّة تشغّل فيها claude داخل مشروع، يطلب منك مفتاح API الخاص بـ Anthropic ويخزّنه في ~/.claude/.
الخطوة 2 — تهيئة المشروع
في جذر مشروعك:
cd my-project
claude
# داخل الـ prompt الخاص بـ Claude
> /init
ينشئ /init مجلّد .claude/ يضمّ:
settings.json— النموذج، الحدّ الأقصى للtokens، صلاحيات الأدوات.CLAUDE.md— "system prompt" المشروع (يُقرأ في كلّ جلسة).agents/— تعريفات sub-agents تبنيها مع الوقت.
هذا المجلّد هو أكثر ميزة مهملة في Claude Code. يترك معظم الناس CLAUDE.md فارغًا. هذا يعادل توظيف مهندس أقدم ونسيان إخباره بما يفعله منتجك.
الخطوة 3 — اكتب CLAUDE.md حقيقي
CLAUDE.md الجيّد أقصر مما تظنّ. ثلاثة أقسام:
# سياق المشروع
- ما هو المنتج، في جملتين.
- المكدّس التقني: الإطار، إصدار اللغة، المكتبات الأساسية.
- أين يعمل النشر (Vercel / AWS / on-prem).
# الاتفاقيات
- أمر الاختبار: `pnpm test`
- أمر الـ lint: `pnpm lint`
- "لا تعدّل أبدًا الملفات في `app/_generated/`."
# تعريف الإنجاز
- جميع الاختبارات تنجح، lint نظيف، لا `console.log` في مسارات الإنتاج.
يقرأ Claude Code هذا الملف في بداية كلّ جلسة. أنت تشحن فعليًا نافذة سياق دائمة.
الخطوة 4 — عادة المضاد للجاذبية
إليك تحوّل سير العمل الذي نقلني من "الذكاء الاصطناعي مجرّد لعبة" إلى "الذكاء الاصطناعي يشحن ميزات":
العادة القديمة
- فتح المحرّر.
- قراءة الكود، التفكير، الكتابة.
- تشغيل الاختبارات.
- التصحيح.
- الـ commit.
الوقت لميزة صغيرة: من ساعة إلى ثلاث.
العادة المضادة للجاذبية
- فتح الطرفيّة في الريبو.
claudeوذكر الهدف.- ارتشف قهوتك بينما يعمل.
- مراجعة الـ diff.
- الـ commit.
الوقت لميزة صغيرة: من 5 إلى 15 دقيقة.
التحوّل الجوهري: الطرفيّة هي الـ IDE. الـ diff هو ما تراجعه، لا الملف. تتوقّف عن قراءة الكود من أعلى لأسفل؛ تقرأ diffs.
الخطوة 5 — الصلاحيات التي تريدها فعلاً
افتراضيًا، يسأل Claude Code قبل تشغيل أوامر shell. بعد جلستك الأولى ستُغريك فكرة قول --yes لكلّ شيء. لا تفعل.
بدلاً من ذلك، عدّل .claude/settings.json:
{
"tools": {
"shell": {
"allow": [
"pnpm test",
"pnpm lint",
"pnpm build",
"git status",
"git diff *",
"ls *",
"rg *"
],
"deny": [
"rm -rf *",
"git push *",
"npm publish *"
]
}
}
}
هذه هي النقطة المثالية: يشغّل الوكيل أيّ شيء غير مدمّر دون سؤال، لكنّه لا يلمس أبدًا ما لا يمكن التراجع عنه.
الخطوة 6 — slash commands ينبغي أن تمتلكها من اليوم الأوّل
تأتي الأداة بـ /init و /agents و /compact و /clear و /help. الاثنان الأكثر استخدامًا عندي:
/compact— حين تبدأ نافذة السياق بالانتفاخ، يعيد تلخيص المحادثة مع الحفاظ على القرارات سليمة. هو الفارق بين جلسة من 4 ساعات وجلسة من 4 رسائل./agents— يفتح منتقي الـ sub-agents. سنعمّق هذا في المقال 5.
أضف أوامرك المخصّصة في .claude/commands/ لاحقًا في السلسلة — تبني معظم الفرق على الأقل /review و /test-and-fix و /release-notes بمجرّد إتقان الأداة.
ماذا يعني "المضاد للجاذبية" فعلاً
الاسم مستعار من صديق قال: "حين يُضبط Claude Code جيّدًا، لا يسقط العمل عليك. يطفو."
ملموسًا، يُترجم ذلك إلى ثلاثة أمور:
- تتوقّف عن الإدارة الجزئية. تعطي هدفًا، لا قائمة خطوات.
- تثق بالحلقة. قراءة، تخطيط، كتابة، اختبار، تكرار — تتركه يعمل.
- تتدخّل فقط عند نقاط القرار. البنية، التسمية، تصميم العقود.
كلّ شيء آخر — boilerplate، إعادة هيكلة، تركيب اختبارات، إدارة اعتماديات — صار مشكلة الوكيل.
المقال التالي: كتابة prompts ناجعة. لأنّ "اجعله أفضل" ليس prompt. سننظر في البنية رباعية الأقسام التي تجعل Claude Code يكمل فعلاً ما تطلبه منه.
السلسلة — إتقان Claude Code
- الجزء 01Claude Code مقابل ChatGPT و Copilot والوكلاءمعظم المطورين يستخدمون أداة الذكاء الاصطناعي الخاطئة للمهمة الخاطئة. إليك السبب — وما الذي يجب فعله بدلاً من ذلك.
- الجزء 02التثبيت + سير العمل المضاد للجاذبية — أنت هناتثبيت Claude Code يستغرق 30 ثانية. أمّا إعداد سير العمل الذي يجعل الوكيل يبدو وكأنّه يقوم بكلّ العمل الثقيل — فهذا الجزء الذي لا يكتب عنه أحد.
- الجزء 03كتابة prompts ناجعة«اجعله أفضل» ليس prompt. «أعد هيكلة هذا للأداء» ليس prompt. إليك البنية رباعية الأقسام التي تجعل Claude Code يُنهي فعلاً ما طلبته.
- الجزء 04Slash commands — بناء مشروع من الألف إلى الياء/init و /agents و /compact وأوامرك المخصّصة. مجموعة الأدوات التي تنقلك من مجلّد فارغ إلى تطبيق يعمل دون مغادرة prompt الـ Claude.
- الجزء 05Sub-agents — الخبراء المتخصّصون الـ 11 داخل Claude Codeتُعيد slash commands استخدام الـ prompts. تُعيد sub-agents استخدام شخصيّات كاملة — code-reviewer و test-writer و migration-runner. هذا الفريق الذي ينبغي أن تمتلكه من اليوم الأول.
- الجزء 06سلامة قاعدة الكود في الإنتاجالصلاحيات، الحواجز، وما لا يجب أتمتته. المقال غير المثير الذي يُقرّر ما إذا كان Claude Code سيصبح بنية تحتيّة أم سيكون السبب الذي يوقظك في الثانية صباحًا.
- الجزء 07خطوط أنابيب متعدّدة الوكلاءربط sub-agents، تشغيلها بالتوازي، وأنماط «مراجعة-أثناء-الكتابة» دون أن تفقد عقلك. حيث يبدأ Claude Code يبدو كمنظّمة هندسة صغيرة.
- الجزء 08بناء ميزات كاملةمن تذكرة Linear إلى PR مدموجة مع Claude Code. عرض حقيقي صادق — كيف بدا الـ prompt، ماذا أصاب الوكيل، ماذا أمسكت في المراجعة.
- الجزء 09الاختبارات والتصحيحالسماح لـ Claude Code بامتلاك حلقة الاختبار بأسرها. بما فيها الأجزاء التي تجعل المهندسين متوتّرين: regressions، flakies، اختبارات تكامل، وهامس stack-trace.
- الجزء 10سير العمل داخل الفرقكيف تدمج فرق الهندسة Claude Code فعلاً اليوم. مجلّد .claude/ المشترك، طقوس المراجعة، والأنماط المضادّة التي أراها في الميدان مرارًا.
- الجزء 11أنماط متقدّمة — Hooks، خوادم MCP، أدوات مخصّصة، system promptsحين تتجاوز الإعدادات الافتراضيّة: hooks لآثار جانبيّة حتميّة، خوادم MCP لبيانات المؤسّسة، أدوات مخصّصة، وجراحة system prompt.
- الجزء 12مستقبل التطوير الوكيليّإلى أين يتّجه هذا في 2026 وما بعدها. على ما سأراهن، على ما لن أراهن، والخطّ الذي بعده أصبح متشكّكًا في الـ hype.