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

# Codex CLI

> استخدم OpenAI Codex CLI مع نماذج Venice AI عبر ملف config.toml محلي

يوضح هذا الدليل كيفية تشغيل 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={"system"}
    mkdir -p .codex
    ```
  </Step>

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

    ```toml theme={"system"}
    #: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>