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

إعداد بسيط

ملف تكوين واحد في مشروعك

متوافق مع OpenAI

يستخدم Venice API المتوافقة مع OpenAI

مرونة النموذج

استبدل بأي نموذج نصي Venice مدعوم

المتطلبات


الإعداد

1

أنشئ مسار تكوين المشروع

من جذر مشروعك:
mkdir -p .codex
2

أنشئ .codex/config.toml

أنشئ الملف والصق التكوين أدناه:
#: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"
3

استبدل العنصرين النائبين

قم بالتحديث:
  • model بمعرّف نموذج Venice الذي تريد استخدامه
  • experimental_bearer_token بمفتاح Venice API الحقيقي الخاص بك
يمكنك تصفح معرّفات النماذج المتاحة في كتالوج النماذج النصية.
4

شغّل Codex CLI بشكل طبيعي

ابدأ Codex CLI من نفس المشروع. سيحمّل .codex/config.toml (للمشاريع الموثوقة) ويوجّه الطلبات عبر Venice.

مواقع تكوين 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" مطلوب لإعداد هذا الموفّر.

الموارد

مرجع Venice API

توثيق endpoint والمعاملات الكامل

نماذج Venice النصية

معرّفات النماذج المتاحة