دليل إعداد Claude Code الذي غيّر طريقة عملي بالكامل

بالأمس، نشر أحد الفائزين بهاكاثون Anthropic دليل إعداد Claude Code الخاص به علنياً. طبّقته بالكامل فوراً، وقضيت اليوم كله في ذلك. الفرق كان واضحاً وملموساً.

الدليل من إعداد affaan (@affaanmustafa)، الذي يستخدم Claude Code يومياً منذ 10 أشهر. وأنا أتصفّح إعداداته، أول ما خطر ببالي: “ماذا كنت أفعل طوال هذه المدة؟”

الدليل متاح كمستودع على GitHub، ورسالته الجوهرية واضحة: ليس المزيد، بل بالضبط ما تحتاجه.

نافذة السياق 200K خرافة - الرقم الحقيقي 70K

نافذة السياق في Claude Code البالغة 200 ألف token هي حدّ نظري أقصى. إذا حمّلت عدداً كبيراً من خوادم MCP والإضافات، ينخفض السياق الفعلي المتاح إلى حوالي 70 ألفاً.

منهج affaan:

1. يُعدّ 14 خادم MCP، لكن يُفعّل 5 إلى 6 فقط لكل مشروع.
2. يحافظ على أقل من 80 أداة مفعّلة في الوقت ذاته.

إعداده الفعلي يشمل GitHub وSupabase وVercel وRailway وسلسلة Cloudflare وClickHouse وغيرها - 14 خادماً إجمالاً. لكنه يعطّل غير المستخدم منها صراحةً عبر disabledMcpServers. بعد أن اعتمدت هذا النمط، تحسّنت جودة الاستجابات بشكل ملحوظ.

Skills مقابل Hooks مقابل Subagents - فصل الأدوار هو المفتاح

هذه المفاهيم الثلاثة مربكة في البداية، لكن التمييز بينها ضروري.

• Skills: تعيش في ~/.claude/skills. تُشغّل سير عمل كامل بأمر واحد مثل /refactor-clean.
• Hooks: أتمتة مبنية على الأحداث. تنسيق تلقائي بـ Prettier بعد تعديل ملفات .ts، تحذير عند وجود console.log، وأكثر. إضافة hookify تتيح لك توليد hooks عبر المحادثة.
• Subagents: تعيش في ~/.claude/agents. أدوار مخصصة مثل planner وarchitect وtdd-guide وsecurity-reviewer تتولى المهام الموكلة إليها.

يضع affaan الـ hooks عند ثلاث نقاط تنفيذ - PreToolUse وPostToolUse وStop - لأتمتة التنسيق وفحص الأنواع والتدقيق الأمني. هذا النمط أيّده أيضاً Boris Cherny.

mgrep وGit Worktrees نقلة نوعية

أكثر النصائح العملية تأثيراً في الدليل:

mgrep

أدق من ripgrep، مع دعم مدمج للبحث على الويب. أمر واحد مثل /mgrep 'function handleSubmit' يبحث في الملفات المحلية وعلى الويب في آنٍ واحد.

Git Worktrees

عند العمل على عدة ميزات بالتوازي، أنشئ checkouts مستقلة وشغّل Claude Code في كل واحدة. يمكنك أيضاً استخدام /fork لتفريع المحادثات. هناك نقاش مستمر حول ما إذا كانت worktrees أفضل من نسخ المستودع - لكلٍّ منهما مزايا وعيوب حسب طريقة عملك.

محرر Zed

مبني على Rust، لذا يبقى خفيفاً وسريعاً. لوحة Agent Panel تتتبّع تعديلات Claude على الملفات لحظياً، واختصار CMD+Shift+R ينفّذ الأوامر المخصصة فوراً.

هيكلة القواعد لضمان الاتساق

قسّم ~/.claude/rules حسب الاهتمام:

• security.md - لا أسرار مكتوبة في الكود
• coding-style.md - الثبات (immutability) وإرشادات بنية الملفات
• testing.md - سير عمل TDD، تغطية 80% كحد أدنى
• git-workflow.md - صيغة رسائل الـ commit
• performance.md - معايير اختيار النموذج

أضف قواعد مثل “لا ترسل console.log أبداً” هنا، ثم فرضها بـ Stop hook يدقّق في تعديلاتك قبل الإرسال. الأخطاء تختفي حين تلتقطها الأتمتة قبل أن تصل إلى الإنتاج.

المبادئ الجوهرية

يلخّص affaan فلسفته في خمسة مبادئ:

• تعامل مع الإعدادات كضبط دقيق، لا كهندسة معمارية. التعديلات الصغيرة والمحددة تتفوق على التغييرات الشاملة.
• نافذة السياق كنز ثمين. عطّل أي شيء لا تستخدمه فعلياً.
• استثمر التنفيذ المتوازي. استخدم /fork وworktrees لتشغيل الوكلاء بالتزامن.
• أتمت العمل المتكرر. الـ hooks تلغي الخطوات اليدوية التي تبطّئك.
• حدّد نطاق كل وكيل فرعي. امنح كل وكيل مسؤولية ضيقة ومحددة بوضوح.

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

ملاحظة شخصية: في ما يخص أتمتة المتصفح، وجدت أن agent-browser من Vercel أكثر استقراراً بمراحل من Playwright والأدوات المشابهة المذكورة في الدليل الأصلي. السرعة وتنوّع المهام التي يتعامل معها في مستوى مختلف تماماً.

الإعداد الكامل متاح على مستودع affaan على GitHub. بدلاً من نسخه حرفياً، افهم المنطق وراء كل خيار وكيّفه حسب طريقة عملك. هنا تكمن القيمة الحقيقية.