---
title: Codex App | RunAPI
description: استخدم RunAPI كموفر النموذج في Codex App، واختر نموذجًا متوافقًا مع Responses،
  وتحقق من الاتصال.
url: https://runapi.ai/ar/docs/resources/tool-integrations/codex-app.md
canonical: https://runapi.ai/ar/docs/resources/tool-integrations/codex-app
locale: ar
---

> نسخة HTML: https://runapi.ai/ar/docs/resources/tool-integrations/codex-app
> فهرس الموقع للوكلاء: https://runapi.ai/llms.txt

# Codex App

## نظرة عامة

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

يغيّر هذا الإعداد موفر النموذج المستخدم لتوليد الاستجابات والكود. لا يُضيف أدوات RunAPI. [Hosted MCP](https://runapi.ai/ar/docs/resources/mcp/hosted.md) هو تكامل منفصل له متطلبات عميل ومصادقة خاصة به.

## قبل البدء

* ثبّت [تطبيق ChatGPT لسطح المكتب][1] الحالي، وسجّل الدخول، ثم افتح Codex مرة واحدة على الأقل.
* أنشئ مفتاح API قياسياً مخصصاً لـ RunAPI باتباع [دليل المصادقة](https://runapi.ai/ar/docs/guides/authentication.md). لا تلتزم بحفظ المفتاح في مستودع.
* من [كتالوج النماذج](https://runapi.ai/ar/models)، انسخ المعرّف الدقيق لنموذج يدعم Responses API.



[1]: https://developers.openai.com/codex/app

تُهيّئ هذه الخطوات عملاء 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`. راجع [تهيئة موفر النموذج المخصص][1] لدى OpenAI للاطلاع على عقد الموفر.



[1]: https://developers.openai.com/codex/config-advanced#custom-model-providers

## اختر نموذجاً

استبدل `YOUR_RUNAPI_MODEL_ID` بالمعرّف الدقيق المنسوخ من [كتالوج النماذج](https://runapi.ai/ar/models). اختر نموذجاً يكشف واجهة Responses API؛ إذ لا يكفي دعم Chat Completions وحده لهذا الإعداد.

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

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

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

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

## إضافة أدوات RunAPI

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

يوثّق [دليل Hosted MCP](https://runapi.ai/ar/docs/resources/mcp/hosted.md) متطلبات العملاء والمصادقة المدعومة حاليًا. لم يتم التحقق من مصادقة Hosted MCP الخاصة بـ Codex، لذا لا تتضمن هذه الصفحة خطوات إعداد Codex MCP. لا تستبدل تهيئة موفر النموذج بإدخال خادم MCP؛ فكلا التكاملين يخدمان غرضين مختلفين.

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

* **لا يزال Codex يستخدم المزوّد السابق:** تأكد من أن الملف هو `~/.codex/config.toml`، وأزل مفاتيح `model` أو `model_provider` المكررة، ثم أعد تشغيل التطبيق كلياً وابدأ مهمة جديدة.
* **`RUNAPI_API_KEY` مفقود:** تأكد من أن المفتاح موجود في `~/.codex/.env` وليس فقط في ملف تعريف الطرفية، ثم أعد تشغيل التطبيق.
* **فشل المصادقة:** أنشئ مفتاحاً قياسياً أو استبدله عبر [دليل المصادقة](https://runapi.ai/ar/docs/guides/authentication.md). لا تلصق المفتاح في `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

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

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

استخدم [البدء السريع لـ LLM API](https://runapi.ai/ar/docs/guides/llm-api/quickstart.md) للاطلاع على سلوك البروتوكول المشترك و[مرجع Responses API](https://runapi.ai/ar/docs/api/openai/responses.md) للحقول الدقيقة للطلب والاستجابة. تابع مع [كتالوج النماذج](https://runapi.ai/ar/models) أو [دليل المصادقة](https://runapi.ai/ar/docs/guides/authentication.md) أو [Hosted MCP](https://runapi.ai/ar/docs/resources/mcp/hosted.md) حسب الحاجة.

---

## المزيد من RunAPI

- [الرئيسية](https://runapi.ai/ar/.md)
- [كتالوج النماذج](https://runapi.ai/ar/models.md)
- [الأسعار](https://runapi.ai/ar/pricing.md)
- [مزودو الخدمة](https://runapi.ai/ar/models)
- [التوثيق](https://runapi.ai/ar/docs/guides)
- [حزم SDK](https://runapi.ai/ar/sdk.md)
- [CLI](https://runapi.ai/ar/cli.md)
- [خادم MCP](https://runapi.ai/ar/mcp.md)
- [Claude Code مقابل Cursor](https://runapi.ai/ar/claude-code-vs-cursor.md)
- [إعداد Cursor API](https://runapi.ai/ar/cursor-api-setup.md)
- [RunAPI مقابل OpenRouter](https://runapi.ai/ar/openrouter-alternative.md)
- [المؤسسات](https://runapi.ai/ar/contact.md)
- [اتصل بنا](https://runapi.ai/ar/contact.md)
- [الشروط](https://runapi.ai/ar/terms.md)
- [الخصوصية](https://runapi.ai/ar/privacy.md)
- [فهرس الموقع للوكلاء](https://runapi.ai/llms.txt)

التواصل: contact@runapi.ai

## البيانات المنظمة

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/ar/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/aricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "TechArticle",
    "headline": "Codex App",
    "description": "استخدم RunAPI كموفر النموذج في Codex App، واختر نموذجًا متوافقًا مع Responses، وتحقق من الاتصال.",
    "url": "https://runapi.ai/ar/docs/resources/tool-integrations/codex-app",
    "mainEntityOfPage": "https://runapi.ai/ar/docs/resources/tool-integrations/codex-app"
  }
]
```