Codex MCP مع Claude Code: تشغيل Codex كخادم MCP

إذا كتبت codex mcp-server في الطرفية وظهرت لك Error: stdin is not a terminal، فجهازك بخير. الأمر نفسه لم يعد موجودًا. لفترة، كان Codex MCP مع Claude Code يعني إعدادًا واحدًا: تشغيل Codex كخادم MCP، وتسجيله في Claude Code، وجعل أحد وكلاء البرمجة يطلب رأيًا ثانيًا من الآخر. وقد أزالت OpenAI هذا الأمر الفرعي لاحقًا، وكل برنامج تعليمي ما زال يعرضه يقودك إلى طريق مسدود.

يشرح هذا المقال ما الذي تغيّر، وأي البدائل تعمل اليوم، والأوامر الدقيقة لكل منها. ستحصل على الإضافة الرسمية، ومغلّف MCP من المجتمع، وحل مؤقت باستخدام نسخة أقدم من CLI، والإعداد العكسي حيث يستدعي Codex أداة Claude Code. كل أمر مأخوذ من وثائق OpenAI أو من مستودع الإضافة أو من README المغلّف، لذا يمكنك لصقه دون تخمين.

💡 الخلاصة السريعة: ثبّت إضافة Codex الرسمية في Claude Code. اختر مغلّف MCP من المجتمع فقط عندما تحتاج إلى ظهور Codex كأدوات MCP حقيقية.

لماذا تعطّل Codex MCP؟

ما الذي كان يفعله الإعداد القديم

كان Codex CLI يأتي مع أمر فرعي، codex mcp-server، يشغّل Codex كخادم MCP عبر stdio. كان بإمكان Claude Code تشغيله كأي خادم آخر، لذلك كان سطر واحد بصيغة claude mcp add يحوّل Codex إلى أداة. كان الخادم يعرض أداتين:

كان الاستدعاء الأول يعيد threadId. وتمريرها إلى codex-reply يُبقي المحادثة مستمرة، فيستطيع Claude Code أن يسلّم Codex مهمة، ثم يقرأ الجواب، ثم يتابع في الجلسة نفسها. كان حقل approval-policy يقبل untrusted أو on-request أو never، وكان حقل sandbox يقبل read-only أو workspace-write أو danger-full-access.

كان التسجيل القديم يبدو كالسطر أدناه. لم يعد يعمل على CLI الحالي:

claude mcp add codex -- codex mcp-server

نسخ الأمر النصي

الخطأ الذي تراه الآن

تنص وثائق OpenAI لبروتوكول MCP الآن على أن أمر codex mcp-server والملف التنفيذي المستقل codex-mcp-server قد أُزيلا. على CLI الحالي، mcp-server ليس أمرًا فرعيًا معروفًا، لذلك يتعامل CLI مع الكلمة كأمر نصي (prompt) ويحاول فتح واجهته التفاعلية. يشغّل Claude Code الخوادم عبر أنبوب دون طرفية متصلة، لذلك يتوقف CLI مع Error: stdin is not a terminal. يتتبّع تقرير خطأ في مشروع Quest هذا الفشل إلى هذا السقوط تحديدًا.

داخل Claude Code تكون الأعراض خادمًا يظهر بحالة failed في /mcp، دون أي أدوات مدرجة. لا يوجد خطأ في إعداداتك. الشيء الذي يشير إليه لم يعد موجودًا.

متى أُزيل

يؤرّخ أحد تقارير الترحيل إشعار الإيقاف إلى Codex CLI 0.149.1، الذي صدر في 24 أغسطس 2026. وتذكر تقارير أخطاء من عدة مشاريع اعتمدت على الأمر، ومنها Quest ومهارة second-opinion من Trail of Bits، أن الإصدار Codex CLI 0.154.0 هو الإصدار الذي اختفى فيه. تحقّق مما تشغّله:

codex --version

نسخ الأمر النصي

أي إصدار من 0.154.0 فما فوق لا يحتوي على الأمر الفرعي، لذلك لن تعيده أي تعديلات على الإعدادات.

ثلاث طرق للوصول إلى Codex اليوم

اختر حسب الطريقة التي تريد أن يظهر بها Codex داخل Claude Code. يوضح الجدول المفاضلة بنظرة واحدة:

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

الإضافة الرسمية

تنشر OpenAI openai/codex-plugin-cc. وهي تغلّف خادم تطبيق Codex عبر الملف التنفيذي codex الموجود بالفعل على جهازك، لذلك تعيد استخدام تسجيل دخولك وإعدادات Codex. تحتاج إلى Node.js 18.18 أو أحدث إضافة إلى اشتراك ChatGPT (تُحتسب الباقة المجانية) أو رمز API من OpenAI. المفاضلة: تحصل على أوامر بشرطة مائلة ومهام خلفية، لا على أدوات MCP.

مغلّف MCP من المجتمع

يحافظ @cexll/codex-mcp-server على شكل MCP. وهو يستدعي codex exec في الخلفية، ويعرض الأدوات ask-codex، وbrainstorm، وping، وhelp. يحتاج إلى Node.js 18 أو أحدث، وإلى Codex CLI مثبّت ومسجّل دخوله. ولأنه شيفرة من طرف ثالث تعمل على مستودعك، اقرأها قبل أن تثق بها، وتوقع أن تتأخر عن تغييرات Codex CLI بأيام أو أسابيع.

CLI أقدم كحل مؤقت

يمكنك تثبيت إصدار Codex CLI من ما قبل الإزالة وإبقاء codex mcp-server يعمل:

npm install -g @openai/codex@<a-version-before-0.154.0>

نسخ الأمر النصي

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

💡 اعتبر CLI الأقدم جسرًا لمدة أسبوع، لا بنية معمارية دائمة.

إعداد الإضافة الرسمية

ثبّت Codex CLI أولًا. تعتمد الإضافة على هذا الملف التنفيذي العام، وتستخدم تسجيل الدخول الذي يحمله بالفعل.

التثبيت في أربعة أوامر

من صدفة (shell) عادية، ثبّت CLI:

npm install -g @openai/codex

نسخ الأمر النصي

ثم شغّل هذه الأوامر داخل Claude Code، واحدًا تلو الآخر:

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup

نسخ الأمر النصي

يتحقق /codex:setup من أن Codex مثبّت ومصادَق عليه. إذا أبلغ عن مشكلة، فأصلحها أولًا، لأن كل الأوامر الأخرى تعتمد عليه.

ماذا يفعل كل أمر

تضيف الإضافة مجموعة صغيرة من أوامر /codex::

عادة مفيدة: بعد أن ينهي Claude Code تغييرًا، شغّل /codex:review للحصول على رأي نموذج ثانٍ قبل الحفظ (commit). واستخدم /codex:rescue عندما يدور Claude Code في حلقة حول الخطأ نفسه، وراقب /codex:status أثناء تشغيل المهمة في الخلفية.

إعداد مغلّف MCP من المجتمع

اختر هذا المسار عندما تحتاج إلى أدوات MCP حقيقية. يقع المغلّف بين Claude Code وCodex CLI، ويترجم استدعاءات الأدوات إلى عمليات codex exec.

التسجيل في Claude Code

npm install -g @openai/codex
claude mcp add codex-cli -- npx -y @cexll/codex-mcp-server

نسخ الأمر النصي

ثم اكتب /mcp داخل Claude Code. يجب أن يظهر الخادم متصلًا، مع أدواته مدرجة أسفله. ويعرض claude mcp list الشيء نفسه من الصدفة.

المشاركة عبر .mcp.json

أضف --scope project إلى أمر claude mcp add، وسيكتب Claude Code الخادم داخل .mcp.json في جذر المستودع، فيحصل الفريق كله على الإعداد نفسه:

{
  "mcpServers": {
    "codex-cli": {
      "command": "npx",
      "args": ["-y", "@cexll/codex-mcp-server"]
    }
  }
}

نسخ الأمر النصي

يطلب Claude Code من كل عضو في الفريق أن يوافق على خادم المشروع قبل تشغيله، وهذا هو السلوك الصحيح لأداة قد تمس الملفات.

إعدادات البيئة المعزولة والموافقة

يمرّر المغلّف أدوات الأمان في Codex، لذلك تقرر أنت مقدار الحرية التي يحصل عليها Codex. يسرد README الخيارات التالية:

💡 ابدأ بـ read-only للمراجعات والأسئلة. انتقل إلى workspace-write فقط عندما تريد أن يعدّل Codex الملفات. الجمع بين danger-full-access وnever يزيل كل الكوابح، لذلك أبقِ هذا المزيج بعيدًا عن المستودعات المشتركة.

يذكر README أيضًا الإعدادات الذكية الافتراضية منذ الإصدار 1.2: يختار المغلّف workspace-write عندما تحتاج المهمة إليه، لمنع أخطاء الصلاحيات. تحقق من الوضع الذي استخدمه التشغيل فعليًا قبل أن تفترض أنه بقي للقراءة فقط.

التشغيل بالاتجاه المعاكس

يعمل الاتصال في الاتجاهين. يستطيع Claude Code استدعاء Codex، ويستطيع Codex استدعاء Claude Code أو أي خادم MCP آخر تثق به.

Codex يستدعي خوادم MCP

يستهلك Codex خوادم MCP بشكل أصلي. أضف واحدًا من CLI:

codex mcp add my-server -- npx -y your-mcp-server-package

نسخ الأمر النصي

أو اكتبه داخل config.toml كجدول [mcp_servers.<name>]:

[mcp_servers.my-server]
command = "npx"
args = ["-y", "your-mcp-server-package"]
startup_timeout_sec = 20
tool_timeout_sec = 120

نسخ الأمر النصي

تقبل خوادم stdio أيضًا env، وcwd، وenabled_tools، وdisabled_tools، وهذا يتيح لك إخفاء الأدوات التي لا ينبغي أن يستدعيها Codex أبدًا. أما خوادم HTTP فتحتاج إلى url مع خيارات المصادقة.

Claude Code كخادم

يستطيع Claude Code تقديم أدواته الخاصة عبر MCP باستخدام claude mcp serve. سجّل هذا الأمر في Codex:

codex mcp add claude-code -- claude mcp serve

نسخ الأمر النصي

عندها يرى Codex أدوات Claude Code، مثل قراءة الملفات والتعديل والوصول إلى الصدفة، كأدوات MCP. جرّب ذلك أولًا في مستودع تجريبي يُحذف لاحقًا، لأن وكيلين لهما صلاحية الكتابة قد يكتب أحدهما فوق تعديلات الآخر.

إصلاح الأعطال الشائعة

تقع معظم الأعطال في خمس فئات. طابق العرض، ثم طبّق الإصلاح:

فحص صحي في 30 ثانية يلتقط تقريبًا كل ما تبقى:

1. شغّل codex --version للتأكد من أن CLI مثبّت وحديث.
2. شغّل claude mcp list للتأكد من أن الخادم مسجّل ومتصل.
3. اطلب من Claude Code استدعاء ping (للمغلّف) أو تشغيل /codex:setup (للإضافة).

إذا اجتازت الاختبارات الثلاثة وفشلت المهمة، فالمشكلة في المهمة لا في الإعداد التقني. قلّص الأمر النصي، واخفض البيئة المعزولة إلى read-only، ثم أعد التشغيل.

كيف تستخدم GPT 5.6 Sol على PicassoIA

عندما يستمر فشل الإعداد، يستطيع نموذج برمجة قوي أن يقرأ الخطأ معك. GPT 5.6 Sol على PicassoIA مصمم للبرمجة والكتابة التقنية والاستدلال متعدد الخطوات، ويقرأ الصور، لذلك تعمل لقطة شاشة للطرفية الفاشلة أيضًا.

خطوة بخطوة

1. افتح صفحة GPT 5.6 Sol على PicassoIA.
2. الصق نص الخطأ الدقيق، ومخرجات codex --version، والأمر الذي فشل في حقل الأمر النصي.
3. أرفق لقطة شاشة عبر إدخال الصور عندما يكون الخطأ أطول من بضعة أسطر.
4. أضف أمرًا نظاميًا مثل: "أنت مهندس أول تصلح إعدادات MCP. اطلب المعلومات الناقصة قبل التخمين."
5. ارفع جهد الاستدلال (reasoning effort) إلى high للمشكلات المعقدة. الافتراضي، none، يفضّل السرعة.
6. ارفع الحد الأقصى لإكمال التوكنات (max completion tokens) عند رفع الجهد. تحذّر إعدادات النموذج نفسه من أن الجهد العالي قد يستنفد كل التوكنات في الاستدلال ويعيد ردًا فارغًا.
7. اضبط الإسهاب (verbosity) على low عندما تريد الأمر الثابت فقط، وعلى high عندما تريد أن يُشرح الاستدلال بالتفصيل.

وهذا ما يناسب كل إعداد في هذا النوع من المهام:

لمقارنة الإجابات، شغّل الأمر النصي نفسه على Claude Sonnet 5 أو Claude Fable 5، وكلاهما في فئة النماذج اللغوية الكبيرة. اختلاف نموذجين حول إعداداتك إشارة مفيدة تدفعك إلى قراءة الوثائق بنفسك.

أنشئ صورك الخاصة على PicassoIA

تبدو مقالات الإعداد وملفات README أفضل مع صور حقيقية: صورة رأسية، ومخطط يوضح كيفية ارتباط وكيلين ببعضهما، ومقطع قصير لملاحظة الإصدار. كما يتوفر لدى PicassoIA واجهة API خاصة بالمطورين وموصِّل MCP، فيمكن لجلسة Claude Code نفسها أن تطلب الصور دون مغادرة الطرفية.

واجهة API على نمط Replicate: عنوان الأساس هو https://api.picassoia.com/v1، وتحمل الطلبات رمز Bearer الذي تبدأ قيمته بالعبارة pia_sk_، والمهام غير متزامنة، لذا تنشئ تنبؤًا، ثم تستعلم عنه دوريًا، ثم تجلب النتيجة. يمكن للحساب تشغيل 5 تنبؤات متوازية، مشتركة بين الرموز واتصالات MCP. تتوفر أربعة نماذج عبر واجهة API وموصِّل MCP:

• PicassoIA Image لتوليد الصور من النص
• PicassoIA Image Editor Pro لتعديل صورة موجودة
• PicassoIA Video لتوليد الفيديو من النص أو الصورة
• Seedance 2.5 Lite لتوليد فيديو مع صوت

راجع صفحة الأسعار لتعرف ما تتضمنه باقتك، لأن الوصول عبر API وMCP يعتمد عليها.

اختر قسمًا واحدًا من هذا المقال، واكتب له أمرًا نصيًا لصورة من 50 كلمة، وأنشئ أول صورة لك على PicassoIA. ثم غذِّ تلك الصورة إلى نموذج فيديو، وحوّلها إلى مقطع مدته خمس ثوانٍ. ستكشف تجربة واحدة بعد الظهر أي نموذج يناسب وثائقك، والأمر النصي الذي تنتهي إليه يستحق الحفظ للمقال القادم.