البرمجة الوكيلية في Xcode 26.3: دليلك لاستخدام وكلاء الذكاء الاصطناعي

مقدمة: من إكمال الكود إلى بناء التطبيقات — قفزة نوعية في تطوير iOS

تخيّل أنك تصف لزميلك المطوّر ما تريد بناءه، فينطلق ليخطّط المهمة ويكتب الكود عبر عدة ملفات ويبني المشروع ويصلح الأخطاء ويتحقّق من النتيجة بصريًا — كل ذلك وأنت تراقب وتوجّه فقط. هذا بالضبط ما تقدّمه البرمجة الوكيلية (Agentic Coding) في Xcode 26.3.

في فبراير 2026، أطلقت Apple تحديث Xcode 26.3 الذي أحدث تحوّلًا جذريًا في طريقة تطوير التطبيقات. لم يعد الذكاء الاصطناعي مجرد أداة لإكمال أسطر الكود — أصبح شريكًا هندسيًا قادرًا على تنفيذ مهام معقدة متعددة الخطوات باستقلالية. وبصراحة، أول ما رأيت العرض التوضيحي ظننت أنهم يبالغون، لكن بعد التجربة الفعلية تبيّن أن الأمر حقيقي تمامًا. في هذا الدليل، سنستكشف كل ما تحتاج معرفته لإعداد هذه الميزة واستخدامها بشكل فعّال.

ما هي البرمجة الوكيلية؟ ولماذا تختلف عن كل ما سبق؟

قبل Xcode 26.3، كانت أدوات الذكاء الاصطناعي في بيئات التطوير تعمل بنمط تفاعلي محدود: تكتب سطرًا من الكود فيقترح عليك الإكمال، أو تسأله سؤالًا فيعطيك إجابة. هذا النمط — رغم فائدته — يشبه استخدام قاموس ذكي أثناء الكتابة.

البرمجة الوكيلية مختلفة تمامًا. بدلًا من الاستجابة لأوامر فردية، يعمل الوكيل (Agent) كمطوّر مستقل يتلقّى هدفًا عامًا ثم:

• يحلّل المشروع: يستكشف بنية الملفات والمخطّطات (Schemes) وإعدادات المشروع
• يخطّط التنفيذ: يقسّم المهمة إلى خطوات أصغر ويحدّد ترتيب العمل
• يبحث في التوثيق: يستعلم عن واجهات Apple البرمجية ذات الصلة من التوثيق الرسمي
• يكتب الكود: ينشئ ملفات جديدة أو يعدّل ملفات موجودة عبر المشروع بالكامل
• يبني ويختبر: يُجمّع المشروع ويكتشف الأخطاء ويصلحها تلقائيًا
• يتحقّق بصريًا: يلتقط صورًا من SwiftUI Previews ليتأكد من مطابقة الواجهة للمطلوب

باختصار، انتقلنا من "مساعد كود" إلى "زميل هندسي" حقيقي. والحقيقة أن هذا التمييز ليس مجرد كلام تسويقي — الفرق في الممارسة اليومية ملموس جدًا.

المتطلبات الأساسية قبل البدء

طيب، قبل أن تنطلق في الإعداد، خلّني أوضّح لك المتطلبات. النقطة الحساسة هنا هي اشتراط Apple Silicon — إذا كنت على جهاز Intel فأنت خارج اللعبة للأسف:

• macOS 26 Tahoe: البرمجة الوكيلية تعمل حصريًا على macOS 26. إذا كنت على إصدار أقدم أو جهاز Intel، فهذه الميزة غير متاحة لك حاليًا
• Apple Silicon: شريحة M1 أو أحدث مطلوبة
• Xcode 26.3: متاح لأعضاء برنامج مطوّري Apple عبر موقع المطوّرين
• حساب مزوّد ذكاء اصطناعي: حساب Anthropic (لـ Claude) أو OpenAI (لـ Codex أو ChatGPT)

إعداد الوكلاء المدمجين: Claude و Codex خطوة بخطوة

يأتي Xcode 26.3 مع دعم مدمج لوكيلين رئيسيين: Claude Agent من Anthropic وCodex من OpenAI. والإعداد أبسط مما تتوقّع.

الخطوة 1: فتح إعدادات Intelligence

افتح Xcode واذهب إلى Settings (أو اضغط ⌘,)، ثم انتقل إلى تبويب Intelligence. ستجد قسمًا خاصًا بمزوّدي الذكاء الاصطناعي.

الخطوة 2: إضافة المزوّد

بشكل افتراضي، ستجد OpenAI (ChatGPT) وAnthropic (Claude) مدرجين كمزوّدين. اضغط على المزوّد الذي تريد تفعيله وأدخل بيانات حسابك أو مفتاح API الخاص بك.

الخطوة 3: تنزيل الوكيل

عند اختيار Claude Agent أو Codex، يمكنك تنزيل الوكيل بنقرة واحدة. Xcode يتولّى التثبيت والإعداد تلقائيًا — ولا داعي لتشغيل أي أوامر في الطرفية في هذه المرحلة.

الخطوة 4: تحديث الوكيل المدمج (اختياري لكن مُوصى به)

الإصدارات المدمجة في Xcode 26.3 قد لا تكون الأحدث دائمًا. وفي تجربتي، الإصدار الأحدث يفرق فرقًا ملحوظًا في جودة النتائج. إذا كنت قد ثبّتت Claude Code أو Codex عبر Homebrew، يمكنك استبدال النسخة المدمجة بالأحدث عبر إنشاء رابط رمزي:

# تحديث Claude Agent
ln -sf $(which claude) ~/Library/Developer/Xcode/CodingAssistant/Agents/Versions/26.3/claude

# تحديث Codex
ln -sf $(which codex) ~/Library/Developer/Xcode/CodingAssistant/Agents/Versions/26.3/codex

هذا يضمن أنك تستخدم أحدث إصدار من الوكيل مع جميع التحسينات والإصلاحات.

بروتوكول MCP: العمود الفقري للبرمجة الوكيلية

وراء كل هذه القدرات يقف بروتوكول سياق النموذج (Model Context Protocol — MCP)، وهو معيار مفتوح يسمح لأي وكيل ذكاء اصطناعي متوافق بالاتصال بأدوات Xcode الداخلية. والجميل في الأمر أن هذا البروتوكول ليس حكرًا على أدوات Apple — أي وكيل خارجي يفهم MCP يستطيع الاندماج مع Xcode.

كيف يعمل MCP تقنيًا؟

البنية التحتية بسيطة وأنيقة (وهذا ما يعجبني فيها):

1. الوكيل يتصل عبر بروتوكول MCP
2. mcpbridge — ملف تنفيذي يعمل كجسر — يترجم الطلبات إلى اتصالات XPC
3. XPC يتواصل مع عمليات Xcode الداخلية

هذا التصميم يعني أن أي أداة تتحدث بروتوكول MCP يمكنها الاستفادة من قدرات Xcode الكاملة — ليس فقط Claude و Codex.

تفعيل خادم MCP

لتمكين الوكلاء الخارجيين من الاتصال بـ Xcode:

1. افتح إعدادات Xcode (⌘,)
2. انتقل إلى تبويب Intelligence
3. فعّل خيار "Enable Model Context Protocol"

هذا كل ما تحتاجه على جانب Xcode. الآن يمكن لأي وكيل خارجي الاتصال عبر الأمر xcrun mcpbridge.

الأدوات العشرون المدمجة في خادم MCP

يوفّر Xcode 26.3 عشرين أداة مدمجة عبر MCP، مقسّمة إلى خمس فئات رئيسية. خلّني أشرح لك هذه الفئات بشيء من التفصيل، لأن فهمها يساعدك على توجيه الوكيل بشكل أفضل:

1. عمليات نظام الملفات (9 أدوات)

تشمل القراءة والكتابة والتحديث والبحث بالأنماط (glob) والبحث في المحتوى (grep) وعرض القوائم وإنشاء المجلدات والحذف والنقل. هذه الأدوات تمنح الوكيل القدرة على التنقّل في مشروعك وتعديله بحرية كاملة — وهي الأساس الذي تُبنى عليه بقية القدرات.

2. البناء والاختبار (5 أدوات)

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

3. التشخيص (أداتان)

مشاكل المتصفّح (Navigator Issues) وتحديث مشاكل الكود. يصل الوكيل إلى نفس معلومات الأخطاء التي تراها في Issue Navigator — أي أنه يرى ما تراه بالضبط. لا تفاوت في المعلومات.

4. الذكاء (3 أدوات)

هذه الفئة هي الأكثر إثارة — وبصراحة هي السبب الأساسي الذي يجعل هذه الميزة تستحق الاهتمام. تضم:

• Swift REPL: بيئة تنفيذ فوري لاختبار مقتطفات الكود بدون إنشاء ملفات أو بناء كامل
• RenderPreview: التقاط صور فعلية من معاينات SwiftUI — الوكيل يستطيع حرفيًا رؤية واجهتك. لا توجد بيئة تطوير أخرى تقدّم هذه الميزة للوكلاء الخارجيين
• DocumentationSearch: بحث دلالي في مكتبة توثيق Apple الكاملة ونصوص فيديوهات WWDC باستخدام نظام Squirrel MLX — محرّك تضمينات مُسرَّع بتقنية MLX ومصمّم خصيصًا لشرائح Apple Silicon

5. مساحة العمل (أداة واحدة)

عرض النوافذ المفتوحة لاكتشاف المشاريع والتبويبات النشطة.

ربط الوكلاء الخارجيين: Claude Code و Cursor وغيرها

إذا كنت تفضّل استخدام وكلاء خارجيين بدلًا من المدمجين في Xcode — وكثيرون يفضّلون ذلك لأسباب وجيهة — فالعملية سهلة للغاية بفضل MCP.

ربط Claude Code (عبر الطرفية)

# إضافة خادم Xcode MCP إلى Claude Code
claude mcp add --transport stdio xcode -- xcrun mcpbridge

# التحقق من نجاح الإعداد
claude mcp list

بعد تنفيذ هذا الأمر، سيحصل Claude Code على وصول كامل لمشروعك المفتوح في Xcode وجميع أدوات البناء والاختبار.

ربط Codex (عبر الطرفية)

# إضافة خادم Xcode MCP إلى Codex
codex mcp add xcode -- xcrun mcpbridge

# التحقق من نجاح الإعداد
codex mcp list

ربط Cursor

لمستخدمي Cursor، أضف الإعداد التالي في ملف تكوين MCP الخاص بالمشروع:

{
  "mcpServers": {
    "xcode": {
      "command": "xcrun",
      "args": ["mcpbridge"]
    }
  }
}

ربط Gemini CLI

وكلاء أخرى مثل Gemini CLI تدعم MCP أيضًا. الفكرة واحدة في كل الحالات: أي أداة تتحدث بروتوكول MCP يمكنها الاتصال بـ Xcode عبر xcrun mcpbridge. هذا هو جمال المعيار المفتوح.

المهارات (Skills): تعزيز أداء الوكيل بمعرفة متخصّصة

المهارات هي ملفات معرفية قابلة لإعادة الاستخدام تشاركها مع الوكيل لتحسين أدائه في مهام محدّدة. فكّر فيها كـ"تعريف بنفسك" لمساعدك الجديد — بدلًا من أن يكتشف مشروعك من الصفر في كل مرة. قد تكون توثيقًا لنمط تصميم تتّبعه، أو أفضل ممارسات لبناء الحركات، أو قواعد لتنظيم البيانات.

أين تُخزّن المهارات؟

# مهارات Claude Agent
~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig/skills/

# مهارات Codex
~/Library/Developer/Xcode/CodingAssistant/codex/skills/

ملفات AGENTS.md و CLAUDE.md

Apple توصي بإضافة ملف AGENTS.md أو CLAUDE.md في جذر مشروعك يحتوي على معلومات مثل:

• اسم المخطّط (Scheme) الرئيسي للمشروع
• أهداف الاختبار (Test Targets) المتاحة
• أي خصوصيات في إعدادات البناء
• الأنماط المعمارية المتّبعة في المشروع (MVVM مثلًا)
• المكتبات والأطر الخارجية المستخدمة

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

سير عمل عملي: من الوصف إلى التطبيق

لنرَ كيف يبدو سير العمل الفعلي مع البرمجة الوكيلية. في أحد العروض التوضيحية من Apple، طُلب من الوكيل إضافة ميزة طقس حية لتطبيق. هذا ما حدث خطوة بخطوة:

الخطوة 1: وصف الهدف

المطوّر كتب ببساطة: "أضف عرض طقس حي يستخدم WeatherKit ويعرض الحالة الحالية بتصميم Liquid Glass".

الخطوة 2: التخطيط والاستكشاف

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

الخطوة 3: التنفيذ

أنشأ الوكيل ثلاثة ملفات جديدة تحتوي على أكثر من 400 سطر من الكود، أضاف صلاحية WeatherKit للمشروع، ودمج بيانات الطقس الحية مع واجهة Liquid Glass أنيقة.

الخطوة 4: البناء والتحقّق

بنى المشروع تلقائيًا، واكتشف خطأين في الكود فأصلحهما، ثم التقط صورة من SwiftUI Preview للتحقّق من المظهر النهائي. كل هذا بدون تدخّل يدوي.

ما كان سيستغرق ساعات — أو نصف يوم عمل في حالات كثيرة — أصبح مسودة أولية ممتازة جاهزة للمراجعة والتحسين في دقائق معدودة.

XcodeBuildMCP: بديل خارجي يستحق الاهتمام

إلى جانب خادم MCP المدمج في Xcode، يوجد مشروع مفتوح المصدر يستحق الذكر: XcodeBuildMCP من فريق Sentry. وهو في رأيي إضافة ممتازة لمن يريد سير عمل أكثر أتمتة.

الفرق بين الخادمين

• Xcode MCP المدمج (20 أداة): يعمل داخل عملية Xcode النشطة. يوفّر عمليات الملفات، التشخيص الفوري، بحث التوثيق، Swift REPL، ومعاينات SwiftUI
• XcodeBuildMCP (59 أداة): يعمل بشكل مستقل عن Xcode. يتعامل مع البناء والاختبارات والمحاكيات ونشر الأجهزة الفعلية وتصحيح LLDB — كل ذلك بدون الحاجة لفتح Xcode

التثبيت

# تثبيت XcodeBuildMCP عبر npm
npm install -g xcodebuildmcp@latest

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

نصائح وأفضل الممارسات

1. ابدأ بمهام صغيرة ومحدّدة

لا تطلب من الوكيل إعادة بناء تطبيقك بالكامل في طلب واحد. ابدأ بمهام واضحة مثل "أضف شاشة إعدادات" أو "أنشئ اختبارات وحدة لهذا النموذج"، ثم توسّع تدريجيًا مع اكتسابك ثقة أكبر بطريقة عمله.

2. استخدم ملفات السياق بذكاء

ملف CLAUDE.md أو AGENTS.md في جذر مشروعك يصنع فرقًا كبيرًا. أضف فيه تفاصيل عن بنية مشروعك وأسماء المخططات وأهداف الاختبار. دقيقتان في إعداد هذا الملف توفّران عشرات الدقائق من التوضيحات المتكرّرة.

3. راجع دائمًا قبل الاعتماد

هذه نقطة جوهرية ولا تقبل مساومة: مهما كان الوكيل ذكيًا، أنت المسؤول عن الكود الذي يُشحن مع تطبيقك. راجع كل تغيير بعناية، واختبره يدويًا قبل دمجه في الفرع الرئيسي. الوكيل يخطئ — وأحيانًا بطرق غير متوقّعة.

4. استفد من سجل المحادثات

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

5. انتبه للأمان

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

الأسئلة الشائعة

هل تعمل البرمجة الوكيلية على أجهزة Intel؟

لا، وهذا قرار واضح من Apple. البرمجة الوكيلية تتطلّب macOS 26 Tahoe على شرائح Apple Silicon حصريًا (M1 أو أحدث). إذا كنت على جهاز Intel، فستحتاج إلى الترقية للاستفادة من هذه الميزة.

هل يحتفظ الوكيل بسياق المحادثات السابقة؟

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

هل يستطيع الوكيل الوصول إلى توثيق Apple الرسمي؟

نعم. Xcode يوفّر أداة DocumentationSearch للوكيل تستخدم بحثًا دلاليًا مدعومًا بنظام Squirrel MLX للبحث في مكتبة توثيق Apple الكاملة ونصوص فيديوهات WWDC من iOS 15 إلى iOS 26. إذا سألت عن واجهة برمجية جديدة لا يعرفها النموذج مسبقًا، سيستخدم هذه الأداة لجلب المعلومات — وهذا يقلّل بشكل كبير من مشكلة "الهلوسة" الشائعة في نماذج اللغة.

هل يمكنني استخدام وكلاء غير Claude و Codex؟

بالتأكيد. بفضل بروتوكول MCP المفتوح، يمكنك ربط أي أداة متوافقة مع MCP بأدوات Xcode العشرين — سواء كانت Cursor أو Claude Code CLI أو Gemini CLI أو أي أداة أخرى تدعم البروتوكول. الأمر الأساسي في كل الحالات هو xcrun mcpbridge.

ما الفرق بين Xcode MCP المدمج و XcodeBuildMCP؟

خادم Xcode المدمج (20 أداة) يعمل داخل عملية Xcode النشطة ويوفّر ميزات فريدة مثل معاينات SwiftUI وبحث التوثيق الدلالي. أما XcodeBuildMCP (59 أداة) فهو مشروع مفتوح المصدر يعمل بشكل مستقل ويوفّر قدرات أوسع تشمل التحكّم بالمحاكيات ونشر الأجهزة الفعلية وتصحيح LLDB. والخبر الجيد أنك لا تحتاج للاختيار بينهما — يمكنك استخدامهما معًا للحصول على أفضل تجربة.