> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-d2fddb8a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex CLI

> وجِّه OpenAI Codex CLI نحو نماذج Venice عبر ملف config.toml محلي حتى تعمل طلبات وكيل البرمجة من خلال Venice API الخاصة والمتوافقة مع OpenAI.

يوضح هذا الدليل كيفية تشغيل OpenAI Codex CLI مع Venice باستخدام مسارات تكوين Codex الرسمية: `~/.codex/config.toml` (على مستوى المستخدم) أو `.codex/config.toml` (على مستوى المشروع).

<CardGroup cols={3}>
  <Card title="إعداد بسيط" icon="gear">
    ملف تكوين واحد في مشروعك
  </Card>

  <Card title="متوافق مع OpenAI" icon="plug">
    يستخدم Venice API المتوافقة مع OpenAI
  </Card>

  <Card title="مرونة النموذج" icon="microchip">
    استبدل بأي نموذج نصي Venice مدعوم
  </Card>
</CardGroup>

***

## المتطلبات

* مفتاح Venice API من [venice.ai/settings/api](https://venice.ai/settings/api)
* Codex CLI مثبَّت ويعمل على جهازك

***

## الإعداد

<Steps>
  <Step title="أنشئ مسار تكوين المشروع">
    من جذر مشروعك:

    ```bash theme={null}
    mkdir -p .codex
    ```
  </Step>

  <Step title="أنشئ .codex/config.toml">
    أنشئ الملف والصق التكوين أدناه:

    ```toml theme={null}
    #:schema https://developers.openai.com/codex/config-schema.json

    model = "openai-gpt-54" # use any Venice model
    model_provider = "venice"
    model_reasoning_effort = "high"
    personality = "pragmatic"
    sandbox_mode = "workspace-write"

    [model_providers.venice]
    name = "Venice"
    base_url = "https://api.venice.ai/api/v1/"
    experimental_bearer_token = "YOUR VENICE API KEY"
    wire_api = "responses"
    ```
  </Step>

  <Step title="استبدل العنصرين النائبين">
    قم بالتحديث:

    * `model` بمعرّف نموذج Venice الذي تريد استخدامه
    * `experimental_bearer_token` بمفتاح Venice API الحقيقي الخاص بك

    يمكنك تصفح معرّفات النماذج المتاحة في [كتالوج النماذج النصية](/models/text).
  </Step>

  <Step title="شغّل Codex CLI بشكل طبيعي">
    ابدأ Codex CLI من نفس المشروع. سيحمّل `.codex/config.toml` (للمشاريع الموثوقة) ويوجّه الطلبات عبر Venice.
  </Step>
</Steps>

***

## مواقع تكوين Codex الرسمية

* **افتراضيات المستخدم**: `~/.codex/config.toml`
* **تجاوزات المشروع**: `.codex/config.toml` (يتم تحميله فقط للمشاريع الموثوقة)

إذا أردت تطبيق إعدادات Venice في كل مكان، ضع نفس التكوين في `~/.codex/config.toml`.

***

## أولوية التكوين (الأعلى أولًا)

1. أعلام CLI وتجاوزات `--config`
2. قيم الملف الشخصي (`--profile <name>`)
3. طبقات تكوين المشروع (`.codex/config.toml`، يفوز أقرب دليل)
4. تكوين المستخدم (`~/.codex/config.toml`)
5. تكوين النظام (`/etc/codex/config.toml`، Unix)
6. الافتراضيات المدمجة

***

## ملاحظات

* احتفظ بمفتاح API الخاص بك خاصًا ولا تقم أبدًا بـ commit للمفاتيح الحقيقية في git.
* يتجاهل Codex تكوين المشروع `.codex/` عندما يكون المشروع مُحدَّدًا كغير موثوق.
* إذا قمت بتبديل النماذج، قم فقط بتحديث حقل `model`.
* إعداد `wire_api = "responses"` مطلوب لإعداد هذا الموفّر.

***

## الموارد

<CardGroup cols={2}>
  <Card title="مرجع Venice API" icon="book" href="/api-reference/api-spec">
    توثيق endpoint والمعاملات الكامل
  </Card>

  <Card title="نماذج Venice النصية" icon="list" href="/models/text">
    معرّفات النماذج المتاحة
  </Card>
</CardGroup>