القائمة

برنامج تعليمي للتثبيت والتكوين Codex

دليل إصدار ويندوز

متطلبات النظام

ويندوز 10 أو ويندوز 11
Node.js 22+
npm 10+
اتصال بالإنترنت

خطوات التثبيت

الخطوات المسبقة!!!
قم بتثبيت Git Bash، يرجى زيارة Git - Downloads قم بتنزيل الإصدار المناسب لنظام الكمبيوتر الخاص بك، ثم اضغط مستمرًا على “الخطوة التالية” لإكمال التثبيت.1. تثبيت Node.js
قم بزيارة الموقع الرسمي لـ Node.js قم بتنزيل وتثبيت أحدث إصدار LTS.2. تثبيت codex
افتح موجه الأوامر (CMD) أو PowerShell، وقم بتشغيل:
npm install -g @openai/codex
3. التحقق من التثبيت
افتح موجه الأوامر (CMD) أو PowerShell، وقم بتشغيل:
codex --version

تكوين واجهة برمجة التطبيقات (API)

1. الحصول على رمز التصريح (Auth Token)
قم بزيارة api.airai.cc قم بالعمليات التالية على صفحة الموقع:
انقر الوحدة التحكم → رمز الواجهة البرمجية الخلفية (API Token) الصفحة
انقر إضافة الرمز
اختر مجموعة الرموز للترجمة:حصري لـ "كوديكس"(يجب اختيار هذه المجموعة، وإلا لن يكون من الممكن استخدامها)
الاسم المخصص للرمز عشوائي
اقتراح الحد: يجب أن يتم ضبطه على لا حد أقصى للكمية
الخيارات الأخرى تظل كما هي بشكل افتراضي
image.png2. ملفات الإعدادات
تنبيه مهم: يرجى استبدال sk-xxx أدناه بمفتاح واجهة برمجة التطبيقات الفعلي الذي قمت بإنشاؤه في www.example.com!
تنبيه مهم: يرجى استبدال sk-xxx أدناه بمفتاح واجهة برمجة التطبيقات الفعلي الذي قمت بإنشاؤه في www.example.com!
تنبيه مهم: يرجى استبدال sk-xxx أدناه بمفتاح واجهة برمجة التطبيقات الفعلي الذي قمت بإنشاؤه في www.example.com!
1.
انتقل إلى مجلد .codex الموجود في دليل المستخدم الحالي، على سبيل المثال: C:\Users\testuser\.codex.
(ملاحظة::إذا لم تتمكن من رؤية هذا المجلد، فهذا يعني أنك لم تفتح "إظهار العناصر المخفية" في Windows. يرجى فتحه في مستكشف الملفات أولاً.)
image.png
2.
إذا لم يكن هناك مجلد .codex، قم بإنشاء هذا المجلد يدويًا، ثم قم بإنشاء الملفين config.toml وauth.json.
image.png
3. ملء التشكيل (يتطلب استبدال sk-xxx بـ SK الحقيقي الذي أنشأته بنفسك).(أ)التكوين في auth.json:
{"OPENAI_API_KEY": "sk-xxx"}
b.التكوين في config.toml (يمكن لصق المحتويات التالية مباشرة):
model_reasoning_effort القيم الاختيارية هي high، medium، low، تمثل مستويات الجهد (عالية، متوسطة، منخفضة) للتفكير النموذجي.
model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://api.airai.cc/v1"
wire_api = "responses"

بدء تشغيل Codex

إعادة تشغيل المحطة!إعادة تشغيل المحطة!إعادة تشغيل المحطة!
ثم انتقل إلى دليل المشاريع الخاصة بك:
cd your-project-folder
قم بتشغيل الأمر التالي لبدء التشغيل:
codex
image.png

VSCode إضافية codex

بعد الانتهاء من التكوين أعلاه ، يمكنك البحث عن codex في متجر ملحقات VSCode وتثبيته.image.png
سيظهر في الشريط الجانبي عند الانتهاء من التثبيت.

image.png

إصدارات Mac

متطلبات النظام

macOS 12 أو الإصدار الأحدث
Node.js 22+
npm 10+
اتصال بالإنترنت

خطوات التثبيت

1. تثبيت Node.js
الأسلوب 1:: زيارات مباشرة الموقع الرسمي لـ Node.js قم بتنزيل وتثبيت أحدث إصدار LTS.
الطريقة الثانيةاستخدام Homebrew (موصى به)
# 如果尚未安装 Homebrew,请先运行此命令/bin/bash -c "$(curl -fsSL [https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh](https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))"# 安装 Node.jsbrew install node
2. تثبيت codex
افتح المحطة (Terminal)، تشغيل (قد تحتاج إلى إضافة sudo):
npm install -g @openai/codex
3. التحقق من التثبيت
افتح المحطة (Terminal)، قم بتشغيل:
codex --version

تكوين واجهة برمجة التطبيقات (API)

1. الحصول على رمز التصريح (Auth Token)
قم بزيارة api.airai.cc قم بالعمليات التالية على صفحة الموقع:
انقر الوحدة التحكم → رمز الواجهة البرمجية الخلفية (API Token) الصفحة
انقر إضافة الرمز
اختر مجموعة الرموز للترجمة:كوديكس خاص(يجب اختيار هذه المجموعة، وإلا لن يكون من الممكن استخدامها)
الاسم المخصص للرمز عشوائي
اقتراح الحد: يجب أن يتم ضبطه على لا حد أقصى للكمية
الخيارات الأخرى تظل كما هي بشكل افتراضي
image.png
2. ملفات الإعدادات
تنبيه مهم: يرجى استبدال sk-xxx أدناه بمفتاح واجهة برمجة التطبيقات الفعلي الذي قمت بإنشاؤه في www.example.com!
تنبيه مهم: يرجى استبدال sk-xxx أدناه بمفتاح واجهة برمجة التطبيقات الفعلي الذي قمت بإنشاؤه في www.example.com!
تنبيه مهم: يرجى استبدال sk-xxx أدناه بمفتاح واجهة برمجة التطبيقات الفعلي الذي قمت بإنشاؤه في www.example.com!
1.
إنشاء المجلد والملف:
mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.codex/config.toml
2.
تحرير ملف auth.json:
vi ~/.codex/auth.json
اضغط على i للدخول إلى وضع الإدراج ، ولصق ما يلي (استبدل sk-xxx بالمفتاح الخاص بك) ، ثم اضغط على المفتاح ESC ، وأدخل :wq والعودة لحفظ الخروج.
{"OPENAI_API_KEY": "sk-xxx"}
3.
تحرير ملف config.toml:
vi ~/.codex/config.toml
اضغط على i للدخول إلى وضع الإدراج ، ولصق ما يلي ، ثم اضغط على المفتاح ESC ، وأدخل :wq ، ثم قم بالعودة لحفظ الخروج.
model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://api.airai.cc/v1"
wire_api = "responses"

بدء تشغيل Codex

إعادة تشغيل المحطة!إعادة تشغيل المحطة!إعادة تشغيل المحطة!
ثم انتقل إلى دليل المشاريع الخاصة بك:
cd your-project-folder
قم بتشغيل الأمر التالي لبدء التشغيل:
codex
[الصورة]

VSCode إضافية codex

بعد الانتهاء من التكوين أعلاه ، يمكنك البحث عن codex وتثبيته في متجر ملحقات VSCode.
[الصورة]سيظهر في الشريط الجانبي عند الانتهاء من التثبيت.
[الصورة]

إصدار Linux

متطلبات النظام

توزيعات لينكس الرئيسية (Ubuntu 20.04+ ، Debian 10+ ، CentOS 7+ ، إلخ)
Node.js 22+
npm 10+
اتصال بالإنترنت

خطوات التثبيت

1. تثبيت Node.js
Ubuntu/Debian
sudo apt update
curl -fsSL https://deb.nodesource.com/setup_lts.x  | 
sudo -E bash -sudo apt-get install -y nodejs
CentOS/RHEL/Fedora
# 使用 dnf (Fedora) 或 yum (CentOS/RHEL)sudo dnf install nodejs npm# 或sudo yum install nodejs npm
Arch Linux
sudo pacman -S nodejs npm
2. تثبيت codex
افتح المحطة (Terminal)، قم بتشغيل:
sudo npm install -g @openai/codex
3. التحقق من التثبيت
افتح المحطة (Terminal)، قم بتشغيل:
codex --version

تكوين واجهة برمجة التطبيقات (API)

1. الحصول على رمز التصريح (Auth Token)
قم بزيارة api.airai.cc قم بالعمليات التالية على صفحة الموقع:
انقر الوحدة التحكم → رمز الواجهة البرمجية الخلفية (API Token) الصفحة
انقر إضافة الرمز
اختر مجموعة الرموز للترجمة:قنوات codex-gpt(يجب اختيار هذه المجموعة، وإلا لن يكون من الممكن استخدامها)
الاسم المخصص للرمز عشوائي
اقتراح الحد: يجب أن يتم ضبطه على لا حد أقصى للكمية
الخيارات الأخرى تظل كما هي بشكل افتراضي
[الصورة]
2. ملفات الإعدادات
تنبيه مهم: يرجى استبدال sk-xxx أدناه بمفتاح واجهة برمجة التطبيقات الفعلي الذي قمت بإنشاؤه في www.example.com!
تنبيه مهم: يرجى استبدال sk-xxx أدناه بمفتاح واجهة برمجة التطبيقات الفعلي الذي قمت بإنشاؤه في www.example.com!
تنبيه مهم: يرجى استبدال sk-xxx أدناه بمفتاح واجهة برمجة التطبيقات الفعلي الذي قمت بإنشاؤه في www.example.com!
1.
إنشاء المجلد والملف:
mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.codex/config.toml
2.
تحرير ملف auth.json:
vi ~/.codex/auth.json
اضغط على i للدخول إلى وضع الإدراج ، ولصق ما يلي (استبدل sk-xxx بالمفتاح الخاص بك) ، ثم اضغط على المفتاح ESC ، وأدخل :wq والعودة لحفظ الخروج.
{"OPENAI_API_KEY": "sk-xxx"}
3.
تحرير ملف config.toml:
vi ~/.codex/config.toml
اضغط على i للدخول إلى وضع الإدراج ، ولصق ما يلي ، ثم اضغط على المفتاح ESC ، وأدخل :wq ، ثم قم بالعودة لحفظ الخروج.
model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://api.airai.cc/v1"
wire_api = "responses"

بدء تشغيل Codex

إعادة تشغيل المحطة!إعادة تشغيل المحطة!إعادة تشغيل المحطة!
ثم انتقل إلى دليل المشاريع الخاصة بك:
cd your-project-folder
قم بتشغيل الأمر التالي لبدء التشغيل:
codex
image.png

VSCode إضافية codex

بعد الانتهاء من التكوين أعلاه ، يمكنك البحث عن codex وتثبيته في متجر ملحقات VSCode.image.png
سيظهر في الشريط الجانبي عند الانتهاء من التثبيت.

image.png

الأسئلة المتكررة

إذا حدث خطأ، يرجى اتباع الخطوات التالية:
1.
تأكد من إنشاء API Key بشكل صحيح: اختيار الحصةلا حد أقصى للكميةلا تقيد النموذج، واختيار المجموعة قنوات codex-gpt。
لمزيد من التفاصيل حول تكوين codex واستخدامها يرجى الرجوع إلى التعليم الرسمي codex。


هل كان هذا مفيدًا؟

الدعم الفنيالدعم المباشر
العودة إلى الأعلى
简体中文ZH-CNDefault繁體中文ZH-TWEnglishEN日本語JA한국어KOภาษาไทยTHTiếng ViệtVIBahasa IndonesiaIDEspañolESFrançaisFRDeutschDEРусскийRUPortuguêsPTItalianoITالعربيةAR