موارد المطورين

Codex App

استخدم RunAPI كموفر النموذج في Codex App، واختر نموذجًا متوافقًا مع Responses، وتحقق من الاتصال.

نظرة عامة

Codex متاح في تطبيق ChatGPT لسطح المكتب على Windows وmacOS. يوجّه هذا الدليل تطبيق Codex المحلي إلى نقطة نهاية Responses المتوافقة مع OpenAI في RunAPI، ويختار نموذج RunAPI، ويتحقق من الاتصال.

يغيّر هذا الإعداد موفر النموذج المستخدم لتوليد الاستجابات والكود. لا يُضيف أدوات RunAPI. Hosted MCP هو تكامل منفصل له متطلبات عميل ومصادقة خاصة به.

قبل البدء

ثبّت تطبيق ChatGPT لسطح المكتب الحالي، وسجّل الدخول، ثم افتح Codex مرة واحدة على الأقل.
أنشئ مفتاح API قياسياً مخصصاً لـ RunAPI باتباع دليل المصادقة. لا تلتزم بحفظ المفتاح في مستودع.
من كتالوج النماذج، انسخ المعرّف الدقيق لنموذج يدعم Responses API.

تُهيّئ هذه الخطوات عملاء Codex المحليين الذين يقرؤون تهيئتك على مستوى المستخدم. لا تُهيّئ مهام Codex السحابية المستضافة.

حفظ مفتاح API

قد لا تَرِث تطبيقات سطح المكتب متغيرات البيئة من الصدفة الخاصة بك. أنشئ ~/.codex/.env أو حرّره وأضف المفتاح في سطر مستقل:

DOTENV

export RUNAPI_API_KEY=YOUR_RUNAPI_API_KEY

احتفظ بهذا الملف خارج مستوداتك. على macOS وLinux، قيّده على حسابك فقط:

SHELL

chmod 600 ~/.codex/.env

إعداد RunAPI

افتح ~/.codex/config.toml على مستوى المستخدم. ادمج القيم التالية في الملف الموجود؛ لا تستبدل الإعدادات غير ذات الصلة ولا تضف نسخة ثانية من مفتاح رئيسي موجود مسبقًا:

TOML

model = "YOUR_RUNAPI_MODEL_ID"
model_provider = "runapi"

[model_providers.runapi]
name = "RunAPI"
base_url = "https://runapi.ai/v1"
env_key = "RUNAPI_API_KEY"
wire_api = "responses"

يجب أن تكون إعدادات المزوّد والمصادقة على مستوى المستخدم. يتجاهل Codex model_provider وmodel_providers في ملف .codex/config.toml الخاص بالمشروع. يخزّن ملف TOML اسم متغير البيئة فقط؛ ويبقى مفتاح API في ~/.codex/.env.

يمثّل base_url جذر API وليس عنوان URL للعملية. مع wire_api = "responses"، يُرسل Codex طلب POST /v1/responses. راجع تهيئة موفر النموذج المخصص لدى OpenAI للاطلاع على عقد الموفر.

اختر نموذجاً

استبدل YOUR_RUNAPI_MODEL_ID بالمعرّف الدقيق المنسوخ من كتالوج النماذج. اختر نموذجاً يكشف واجهة Responses API؛ إذ لا يكفي دعم Chat Completions وحده لهذا الإعداد.

عند تغيير model، أعد تشغيل التطبيق بالكامل وابدأ مهمة جديدة. قد تحتفظ المهمة الحالية بالنموذج والمزوّد اللذين بدأت بهما.

أعد التشغيل والتحقق

أغلق تطبيق ChatGPT لسطح المكتب إغلاقاً تاماً ثم أعد فتحه.
افتح Codex وابدأ مهمة جديدة في مستودع.
أرسل موجّهاً قصيراً مثل Describe this repository in one sentence.
تأكد من أن Codex يُعيد استجابة طبيعية وأن RunAPI يسجّل طلب POST /v1/responses للنموذج المحدد.

ينبغي أن يظل التحقق الأول قصيرًا حتى يسهل تمييز أخطاء التهيئة عن السلوك الخاص بالمهمة.

إضافة أدوات RunAPI

يوجّه موفر النموذج أعلاه استنتاج Codex عبر RunAPI. أما MCP فهو منفصل: يمكنه السماح للعملاء المدعومين باستدعاء أدوات RunAPI لاكتشاف النماذج ومعلومات الحساب وسير عمل المهام المدعومة.

يوثّق دليل Hosted MCP متطلبات العملاء والمصادقة المدعومة حاليًا. لم يتم التحقق من مصادقة Hosted MCP الخاصة بـ Codex، لذا لا تتضمن هذه الصفحة خطوات إعداد Codex MCP. لا تستبدل تهيئة موفر النموذج بإدخال خادم MCP؛ فكلا التكاملين يخدمان غرضين مختلفين.

استكشاف الأخطاء وإصلاحها

لا يزال Codex يستخدم المزوّد السابق: تأكد من أن الملف هو ~/.codex/config.toml، وأزل مفاتيح model أو model_provider المكررة، ثم أعد تشغيل التطبيق كلياً وابدأ مهمة جديدة.
RUNAPI_API_KEY مفقود: تأكد من أن المفتاح موجود في ~/.codex/.env وليس فقط في ملف تعريف الطرفية، ثم أعد تشغيل التطبيق.
فشل المصادقة: أنشئ مفتاحاً قياسياً أو استبدله عبر دليل المصادقة. لا تلصق المفتاح في config.toml أو سجلات الدعم.
يُعيد الطلب 404: عيّن base_url إلى https://runapi.ai/v1 لا إلى https://runapi.ai/v1/responses.
النموذج غير متاح أو يرفض حقلاً ما: انسخ المعرّف الدقيق مجدداً وتأكد من أن النموذج يدعم Responses API والميزة المطلوبة.
يختار Codex نموذجاً مختلفاً: تحقق من ملفات .codex/config.toml للمشاريع الموثوقة بحثاً عن تجاوز model. يمكن لتهيئة المشروع اختيار نموذج حتى وإن تعذّر عليها استبدال مزوّد مستوى المستخدم.
تعمل CLI لكن التطبيق يفشل: تحقق من ~/.codex/.env، ثم أعد تشغيل التطبيق كلياً. قد لا تقرأ تطبيقات واجهة المستخدم الرسومية المتغيرات التي تُصدَّر فقط من خلال الصدفة.
لا تستخدم مهمة سحابية RunAPI: تنطبق هذه التهيئة المحلية على عملاء Codex المحليين؛ فالمهام السحابية المستضافة لا تقرأ الملفات من جهازك.

إزالة RunAPI

احذف قيم model وmodel_provider و[model_providers.runapi] الخاصة بـ RunAPI من ~/.codex/config.toml، أو استعد قيم الموفر التي كنت تستخدمها سابقاً.
احذف RUNAPI_API_KEY من ~/.codex/.env إن لم تكن أي أداة محلية أخرى تستخدمه.
أعد تشغيل التطبيق بالكامل وابدأ مهمة جديدة.
أبطل المفتاح المخصص في RunAPI حين لا تعود بحاجة إليه.

الخطوات التالية

استخدم البدء السريع لـ LLM API للاطلاع على سلوك البروتوكول المشترك ومرجع Responses API للحقول الدقيقة للطلب والاستجابة. تابع مع كتالوج النماذج أو دليل المصادقة أو Hosted MCP حسب الحاجة.