كيفية الترحيل من Claude Code إلى Codex في 2026: دليل خطوة بخطوة

وثائق Ailoot: واجهة API والمفاتيح والإعداد.

لماذا نحتاج أصلًا إلى أداة الترحيل في Codex؟#

أضافت OpenAI الميزة إلى Codex في أوائل يونيو 2026. ويصفها سجل التغييرات الرسمي بإيجاز:

بعبارة أخرى: عند تشغيل تطبيق Codex للمرة الأولى، أو من إعدادات عميل قيد التشغيل بالفعل، يبدأ معالج يقرأ الإعدادات المحلية لوكيل آخر. يدعم حاليًا Claude Code وClaude Cowork.

من الواضح سبب قيام OpenAI بذلك. بعد إطلاق Sites وتحديث تطبيق Codex في مايو–يونيو 2026، اكتسب Codex كل ما كان Claude Code يتفوق به سابقًا على OpenAI: طرفية، ومكونات إضافية، وجلسات طويلة، وتنسيق العمل. يزيل الترحيل آخر عقبة أمام الفرق التي دمجت Claude Code بالفعل في مجموعتها التقنية: "يمكن استيراد الإعدادات المدعومة، ثم التحقق منها مقابل الجرد الأصلي".

أما سبب حاجتك إليه فليس واضحًا بالقدر نفسه. قارنت بينهما مباشرة في دليل Codex مقابل Claude Code: لا يزال Claude متقدمًا في النقاشات المعمارية الطويلة وPlan Mode، بينما Codex أسرع في المهام المستقلة وطلبات السحب المتوازية. إذا قررت الانتقال بالكامل، فتابع القراءة. وإذا كنت تفكر في الجمع بينهما، فقد تكون أنماط التعاون أنسب لك.

ما الذي تنقله أداة الترحيل تلقائيًا؟#

سأستعرض المجموعات وأشرح بالضبط ما يحدث لكل جزء من ~/.claude.

1. التعليمات والسياق. تتحول ملفات CLAUDE.md — الملف العام في ~/.claude/ وملفات المشاريع في المستودعات — إلى تنسيق AGENTS.md. وينتهي الملف العام في ~/.codex/AGENTS.md؛ أما ملفات المشاريع فتبقى في جذر المستودع والمجلدات الفرعية. تنسيق AGENTS.md هو في الأساس النوع نفسه من ملفات Markdown التي تتضمن قواعد؛ والفروق تجميلية في معظمها، مثل أسماء الأقسام وبعض التوجيهات المحددة. شرحت ما هو AGENTS.md ولماذا يحتاج إليه Codex.

2. المهارات. يُفحص مجلد ~/.claude/skills/ بالكامل؛ وتُكيَّف كل مهارة لتلائم بنية Codex وتوضع في $HOME/.agents/skills. وتُنقل مهارات المشروع من .claude/skills/ في المستودع إلى .agents/skills. ويُنقل تنسيق SKILL.md ذي البيانات التمهيدية كما هو تقريبًا. إذا استخدمت مهارة ما محفزات خاصة بـClaude، فستُعلَّم للمراجعة.

3. خوادم MCP. يُستورد إعداد .mcp.json (على المستويين العام ومستوى المشروع) إلى تنسيق Codex. وتُحفَظ أسماء الخوادم وأوامر التشغيل والمسارات. أما ما لا يُنقل فهو الرموز ومتغيرات البيئة. لأسباب أمنية، سيطلب منك Codex إدخال مفاتيح API وكلمات المرور مجددًا حتى لا تُكشف أثناء الترحيل. وهذه مهمة لمرة واحدة: افتح قسم MCP في تطبيق Codex وأدخل الرموز الموجودة لديك في مدير كلمات المرور.

4. الخطافات. هذه المجموعة معقدة. تُنقل بالكامل الخطافات ذات المنطق الحتمي (مثل حظر rm -rf، والتنبيه إلى المسارات التي تشبه بيانات اعتماد، وتسجيل الأدلة). أما الخطافات التي تستخدم محفزات لا مقابل لها في Codex (مثل أحداث محددة في دورة حياة Claude Code) فتُعلَّم بأنها تتطلب "مراجعة يدوية" ولا تُفعَّل تلقائيًا. شرحت بالتفصيل كيفية عمل الخطافات في Claude Code كنقطة مرجعية؛ فلدى Codex أنواع أقل.

5. سجل الجلسات. يُستورد ما يصل إلى آخر 30 يومًا من نشاط Claude Code كمرجع. لا يعني هذا "المتابعة بالضبط من حيث توقفت"، لكن محادثاتك السابقة ستكون ظاهرة في Codex كي تسترجع سياق المشروع بسرعة دون شرح كل شيء من جديد.

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

ما الذي لا يُنقل، ولماذا؟#

سأستعرض كل مجموعة من منظور "ما الذي ينبغي فعله بعد الترحيل".

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

أوامر الشرطة المائلة /name. في Claude Code، اعتدت استدعاء مهارة باستخدام /skill-name. أما في Codex، فطريقة الاستدعاء المعتمدة مختلفة: $skill-name. ومن أخطاء الترحيل الشائعة اعتبار أوامر /name دليلًا على أن المهارات قد حُمّلت.

بعد الترحيل، اختبر بعض المهارات الأساسية باستخدام $skill-name في Codex. إذا عملت، فقد نجح الترحيل بالفعل. لا تثق بخانة "نُقلت المهارات" في المعالج؛ بل تحقّق من خلال استدعائها.

خطافات لا مقابل لها في Codex. إذا كان لديك خطاف لأحداث محددة في Claude Code — مثل pre-tool-use لتركيبة معينة من الأدوات — فقد لا يكون ذلك المحفز موجودًا في Codex. ستعلِّمها أداة الترحيل وتتركها غير نشطة. سيكون عليك أن تقرر إعادة كتابتها بما يعادلها في Codex، أو حذفها، أو الاحتفاظ بها في Claude Code (إذا كنت تشغلهما بالتوازي). ومن القواعد الجيدة: انقل الخطافات الحتمية فقط؛ أما كل ما عداها فهو سبب لعدم تكرار السلم في الأداة الجديدة.

سير عمل الفرق المبني على الوكلاء الفرعيين. شرحت ما الوكلاء الفرعيون في Claude Code وكيفية استخدام الوكلاء الفرعيين المتداخلين. في Codex، تُنظَّم الوكلاء الفرعيون عبر الملفات التعريفية والأدوار (انظر أدناه). إذا كان لديك في Claude مسار عمل معقد يتألف من عدة وكلاء فرعيين متتابعين، فسيتعين عليك إعادة كتابته حول مفهوم الملف التعريفي في Codex. وتعلِّم أداة الترحيل هذه الإعدادات بأنها "تتطلب إعادة عمل معماري".

ملفات CLAUDE.md الطويلة والخاصة بـClaude. إذا نما ملف ما إلى 2,000–3,000 سطر مع أقسام لكل مشروع، فقد يقبله Codex، لكن ذلك نمط سيئ. صُمم AGENTS.md ليكون موجزًا وموزعًا: قواعد عامة في ~/.codex/AGENTS.md، وقواعد خاصة بالمشروع في جذر المستودع، وتجاوزات ضيقة النطاق في المجلدات الفرعية. بعد الترحيل، لا تترك CLAUDE.md على هيئة "ملف تعليمات ضخم"؛ بل قسّمه على مستويات. شرحت كيفية إعداد CLAUDE.md بالشكل الصحيح؛ وينطبق النهج نفسه على AGENTS.md.

خطوة بخطوة: 4 إجراءات في تطبيق Codex#

إليك قائمة التحقق المحددة.

1. الخطوة 1: حدّث تطبيق Codex إلى الإصدار 26.608 أو أحدث

   ظهرت أداة الترحيل في الإصدار 26.608 (الصادر في 9 يونيو 2026). على macOS، افتح تطبيق Codex وتحقق من وجود تحديثات. افعل الشيء نفسه على Windows. وإذا كنت تشغّل Codex CLI، فتأكد من توافقه مع التطبيق الحالي. لن يظهر "استيراد إعدادات وكيل آخر" في الإعدادات من دون أحدث إصدار.

2. الخطوة 2: ابدأ الاستيراد من الإعدادات

   في تطبيق Codex، افتح الإعدادات وابحث عن "استيراد إعدادات وكيل آخر". إذا كنت قد ثبّت تطبيق Codex للتو، فسيعرض المعالج الترحيل أثناء الإعداد الأولي. بعد بدء العملية، يفحص المعالج نظام الملفات: ~/.claude/ والمستودعات التي تحتوي على CLAUDE.md أو .claude/. يستغرق الفحص من 30 ثانية إلى عدة دقائق، حسب عدد الملفات.

3. الخطوة 3: أكد خطة الترحيل

   بعد الفحص، سيعرض Codex جردًا يتضمن عدد المهارات التي عُثر عليها، وعدد خوادم MCP، وعدد ملفات CLAUDE.md، والخطافات المؤهلة للترحيل، وعدد أيام سجل الجلسات المتاح. يمكنك إلغاء تحديد أي مجموعة لا تريد نقلها. افتراضيًا، يُحدَّد كل ما يراه Codex آمنًا للاستيراد.

4. الخطوة 4: انتظر اكتمال العملية وأدخل الرموز

   يستغرق الاستيراد 1–5 دقائق. عند انتهائه، يفتح Codex نافذة متابعة تقول: "إليك ما لم أتمكن من نقله تلقائيًا؛ تحقّق منه يدويًا". عادةً ما تكون هذه قائمة بخوادم MCP التي تحتاج إلى رموز. افتح مدير كلمات المرور وأدخل المفاتيح في نموذج Codex. بعد ذلك، يكون الجزء الرئيسي من الترحيل قد اكتمل.

بعدها، تحقّق من النتيجة. افتح مشروعًا كنت تعمل عليه عادةً في Claude Code، وتحقق مما يلي:

• cat ~/.codex/AGENTS.md — هل توجد قواعدك العامة هناك؟
• شغّل أي مهارة: $skill-name. ينبغي أن تُحمَّل.
• افتح .mcp.json في المشروع وتأكد من تشغيل الخوادم المطلوبة.
• ابدأ محادثة تعكس أسلوب عملك المعتاد. سيعرض Codex الخطافات المستوردة التي لا يستطيع استخدامها؛ وهي عناصر محددة في الجرد تحتاج إلى معالجة يدوية؛ ولا توجد نسبة متبقية ثابتة مثبتة.

الخطافات والوكلاء الفرعيون: ما يعادلها في Codex وما ينبغي إعادة كتابته#

الخطافات. في Claude Code، يمكنك إرفاق أمر shell بكل حدث من أحداث دورة الحياة (pre-tool-use وpost-tool-use وon-error وon-context-load وما إلى ذلك). لدى Codex مجموعة أحداث أصغر: يمكنه التحقق قبل التنفيذ، وتسجيل الأدلة، وحظر الأوامر الخطرة. إذا كان لديك خطاف pre-tool-use يرشح تركيبة محددة، فسيتعين عليك في Codex إدراجه ضمن فحص عام قبل التنفيذ أو حذفه. شرحت بالتفصيل بنية خطافات Claude Code؛ وإذا كنت تستخدمها بكثرة، فاسرد كل محفز وأثر مطلوب، وحدد مقابلًا مدعومًا وتحقق منه قبل تفعيله.

الوكلاء الفرعيون. في Claude Code، الوكيل الفرعي هو سياق منفصل له مطالبة نظام خاصة به، ويُشغّل عبر /command أو من المحادثة الرئيسية. لدى Codex مفهوم مشابه في الملفات التعريفية: يمكنك تعريف ملف تعريفي بمجموعة محددة من المهارات والأذونات وسياسة الموافقة. تحل الملفات التعريفية المشكلة نفسها تقريبًا — عزل السياق لفئة معينة من المهام — لكن عبر الإعدادات بدلًا من استدعاء وكيل صراحةً.

ما يعنيه ذلك عمليًا:

• إذا كان لديك وكيل فرعي باسم "security-reviewer" وله مطالبته الخاصة، فأنشئ في Codex ملفًا تعريفيًا باسم security-review مع الأذونات المطلوبة ومستوى استدلال أعلى.
• إذا كان لديك وكيل فرعي باسم "feature-developer"، فهو ببساطة ملف عمل تعريفي افتراضي؛ ولا يلزم إجراء أي شيء خاص.
• إذا كنت تستخدم وكلاء فرعيين متداخلين، فلن يعمل ذلك بالطريقة نفسها تمامًا في Codex؛ أعد التفكير فيه كسلسلة من الملفات التعريفية أو المهارات الصريحة.

ستحاول أداة الترحيل إنشاء ملفات تعريفية باستخدام أسماء وكلائك الفرعيين، وستعلِّم المحفزات التي لم تُنقل. يتوقف العمل المطلوب على عدد الأدوار والمحفزات والأذونات والتبعيات؛ اختبر كل مسار مطلوب قبل اعتباره مرحلًا.

متى تنتقل بالكامل ومتى تحتفظ بالأداتين#

معيار بسيط لاتخاذ القرار:

الانتقال الكامل إلى Codex مناسب إذا:

• كنت تنفذ غالبًا طلبات سحب مستقلة ومهام متوازية.
• كان سير عملك على GitHub متكاملًا بعمق، وكان Codex Cloud Agent يتولى 80% من العمل.
• لم تكن تقضي وقتًا طويلًا في النقاشات المعمارية وPlan Mode.
• أردت الدفع مقابل أداة واحدة بدلًا من أداتين.

الاحتفاظ بـClaude Code وCodex معًا مناسب إذا:

• كنت تستخدم Plan Mode بانتظام لاتخاذ قرارات معمارية طويلة الأمد.
• كنت تحتاج إلى العمل بالتوازي: يعمل Codex في السحابة على مهمة بينما يحتفظ Claude Code بسياق مهمة أخرى.
• كنت تنفذ كثيرًا من الحلول السريعة لمرة واحدة والمشاريع الصغيرة التي يكون فيها Plan Mode مبالغًا فيه.
• كان لديك مسار عمل معقد للوكلاء الفرعيين لا يمكن إعادة كتابته في ليلة واحدة.

أنا شخصيًا أستخدمهما معًا: يحتفظ Claude Code بالمحادثة الطويلة، بينما يتولى Codex مهامًا مثل "إصلاح N من الأخطاء بالتوازي" أو "مراجعة طلب سحب". شرحت أكثر عن آلية ذلك في دليل العمل مع Claude Code وCodex معًا.

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

إذا كنت بحاجة إلى الوصول إلى الشبكات العصبية عبر Ailoot، فألقِ نظرة على Ailoot.