دليل تثبيت وتكوين 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
افتح موجه الأوامر (CMD) أو PowerShell، وقم بتشغيل:
codex --version
تكوين واجهة برمجة التطبيقات (API)
1. الحصول على رمز التصريح (Auth Token)قم بزيارة api.airai.cc قم بالعمليات التالية على صفحة الموقع:
انقر الوحدة التحكم → رمز الواجهة البرمجية الخاصة بالخدمة (API Token) الصفحة
انقر إضافة الرمز
اختر مجموعات الرموز التي تريدها:حصري لـ "كوديكس"(تأكد من اختيار هذه المجموعة وإلا لا يمكن استخدامها)
الاسم الرسمي حسب ما تريد
توصية الحد الأقصى: يجب أن يتم ضبطها على حد ائتمان غير محدود
الخيارات الأخرى تظل كما هي بشكل افتراضي
تنبيه مهم: يرجى استبدالsk-xxxأدناه بالمفتاح الحقيقي للواجهة البرمجية التطبيقية (API) الذي قمت بإنشاؤه على موقع api.airai.cc!
تنبيه مهم: يرجى استبدالsk-xxxأدناه بالمفتاح الحقيقي للواجهة البرمجية التطبيقية (API) الذي قمت بإنشاؤه على موقع api.airai.cc!
تنبيه مهمالرجاء استبدال `sk-xxx` أدناه بمفتاح الواجهة البرمجية الخاص بك الفعلي الذي تم إنشاؤه في ملف `api.airai.cc`!
1.
اذهب إلى مجلد `
（ملاحظة:: إذا لم تتمكن من رؤية هذا المجلد، فهذا يعني أنك لم تفعّل خيار "عرض العناصر المخفية" في ويندوز، يرجى تفعيله أولاً في مدير الملفات.
.codex` الموجود في مجلد مستخدم الحالي، على سبيل المثال: `C:\Users\testuser\.codex`.（ملاحظة:: إذا لم تتمكن من رؤية هذا المجلد، فهذا يعني أنك لم تفعّل خيار "عرض العناصر المخفية" في ويندوز، يرجى تفعيله أولاً في مدير الملفات.
2.
إذا لم يكن هناك مجلد
.codex، يرجى إنشاؤه يدويًا، ثم قم بإنشاء ملفي config.toml و auth.json داخله.3. قم بملء الإعدادات (سيتعين استبدال
sk-xxx بـ SK الحقيقي الذي قمت بإنشائه بنفسك).أ. الإعدادات الموجودة داخل auth.json:{"OPENAI_API_KEY": "sk-xxx"}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)
أعد تشغيل الجهاز! أعد تشغيل الجهاز! أعد تشغيل الجهاز!ثم ادخل إلى دليل مشروعك (Project Directory):
cd your-project-folder
codex
VSCode إضافة كوديكس
بعد إكمال الإعدادات أعلاه، قم بالبحث عنcodex في متجر إضافات VSCode وقم بتثبيتها.بعد التثبيت، ستظهر في الشريط الجانبي.
دليل التثبيت لنسخة Mac
متطلبات النظام
macOS 12 أو أحدث
Node.js 22+
npm 10+
اتصال بالإنترنت
خطوات التثبيت
1. تثبيت Node.jsالطريقة الأولى:: قم بالزيارة المباشرة الموقع الرسمي لـ 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
افتح Terminal، وقم بتشغيل الأمر (قد يتطلب إضافة
sudo):npm install -g @openai/codex
افتح محطة الترمينال (Terminal)، وقم بتشغيل الأمر التالي:
codex --version
تكوين واجهة برمجة التطبيقات (API)
1. الحصول على رمز التصريح (Auth Token)قم بزيارة api.airai.cc قم بالعمليات التالية على صفحة الموقع:
انقر الوحدة التحكم → رمز الواجهة البرمجية الخاصة بالخدمة (API Token) الصفحة
انقر إضافة الرمز
اختر مجموعات الرموز التي تريدها:مخصص لـ Codex:(تأكد من اختيار هذه المجموعة وإلا لا يمكن استخدامها)
الاسم الرسمي حسب ما تريد
توصية الحد الأقصى: يجب أن يتم ضبطها على حد ائتمان غير محدود
الخيارات الأخرى تظل كما هي بشكل افتراضي
تنبيه مهم: يرجى استبدالsk-xxxأدناه بمفتاح الواجهة البرمجية التطبيقية (API Key) الفعلي الذي تم إنشاؤه لديك في ملف api.airai.cc!
تنبيه مهم: يرجى استبدالsk-xxxأدناه بمفتاح الواجهة البرمجية التطبيقية (API Key) الفعلي الذي تم إنشاؤه لديك في ملف api.airai.cc!
تنبيه مهمالرجاء استبدال `sk-xxx` أدناه بمفتاح الواجهة البرمجية الخاص بك الفعلي الذي تم إنشاؤه في موقع `api.airai.cc`!
1.
قم بإنشاء المجلدات والملفات:
mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.codex/config.toml
2.
قم بتعديل ملف `اضغط على
auth.json`:vi ~/.codex/auth.json
i للدخول إلى وضع الإدخال، ثم اضغط المحتوى التالي (استبدل sk-xxx بمفتاحك الخاص)، ثم اضغط على ESC، وأدخل :wq واضغط Enter للحفظ والخروج.{"OPENAI_API_KEY": "sk-xxx"}3.
قم بتعديل ملف اضغط على
config.toml:vi ~/.codex/config.toml
i للدخول في وضع الإدراج، ثم اضغط على المفتاح للصق المحتوى أدناه، بعد ذلك اضغط على ESC، ثم أدخل :wq واضغط Enter لحفظ التغييرات والخروج.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)
أعد تشغيل الجهاز! أعد تشغيل الجهاز! أعد تشغيل الجهاز!ثم ادخل إلى دليل مشروعك (Project Directory):
cd your-project-folder
codex
VSCode إضافة كوديكس
بعد إكمال الإعدادات أعلاه، قم بالبحث عنcodex في متجر إضافات VSCode وقم بتثبيته.[صورة]بعد التثبيت، ستظهر في الشريط الجانبي.
[صورة]
دليل إصدارات لينكس
متطلبات النظام
الإصدارات الرئيسية من لينكس (Ubuntu 20.04+، Debian 10+، CentOS 7+، إلخ.)
Node.js 22+
npm 10+
اتصال بالإنترنت
خطوات التثبيت
1. تثبيت Node.jsUbuntu/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
افتح محطة الترمينال (Terminal)، وقم بتشغيل الأمر التالي:
sudo npm install -g @openai/codex
افتح محطة الترمينال (Terminal)، وقم بتشغيل الأمر التالي:
codex --version
تكوين واجهة برمجة التطبيقات (API)
1. الحصول على رمز التصريح (Auth Token)قم بزيارة api.airai.cc قم بالعمليات التالية على صفحة الموقع:
انقر الوحدة التحكم → رمز الواجهة البرمجية الخاصة بالخدمة (API Token) الصفحة
انقر إضافة الرمز
اختر مجموعات الرموز التي تريدها:قناة codex-gpt:(تأكد من اختيار هذه المجموعة وإلا لا يمكن استخدامها)
الاسم الرسمي حسب ما تريد
توصية الحد الأقصى: يجب أن يتم ضبطها على حد ائتمان غير محدود
الخيارات الأخرى تظل كما هي بشكل افتراضي
[صورة]
[صورة]
تنبيه مهم: يرجى استبدالsk-xxxأدناه بمفتاح الواجهة البرمجية الخاص بك الفعلي الذي تم إنشاؤه على api.airai.cc!
تنبيه مهم: يرجى استبدالsk-xxxأدناه بالمفتاح الحقيقي للواجهة البرمجية التطبيقية (API) الذي قمت بإنشاؤه في موقع api.airai.cc!
تنبيه مهم: يرجى استبدالsk-xxxأدناه بالمفتاح الحقيقي للواجهة البرمجية التطبيقية (API) الذي قمت بإنشاؤه في موقع api.airai.cc!
1.
قم بإنشاء المجلدات والملفات:
mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.codex/config.toml
2.
قم بتعديل ملف اضغط على
auth.json:vi ~/.codex/auth.json
i للدخول إلى وضع الإدخال، ثم اضغط المحتوى التالي (استبدل sk-xxx بمفتاحك الخاص)، ثم اضغط على ESC، وأدخل :wq واضغط Enter لحفظ التغييرات والخروج.{"OPENAI_API_KEY": "sk-xxx"}3.
قم بتعديل ملف اضغط على
config.toml:vi ~/.codex/config.toml
i للدخول في وضع الإدخال، ثم اضغط على المفتاح للصق المحتوى التالي، بعد ذلك اضغط على ESC، ثم أدخل :wq واضغط Enter لحفظ التغييرات والخروج.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)
أعد تشغيل الجهاز! أعد تشغيل الجهاز! أعد تشغيل الجهاز!ثم ادخل إلى دليل مشروعك (Project Directory):
cd your-project-folder
codex
VSCode إضافة كوديكس
بعد إكمال الإعدادات أعلاه، ما عليك سوى البحث عن تطبيقcodex في متجر إضافات VSCode وتثبيته.بعد التثبيت، ستظهر في الشريط الجانبي.
الأسئلة الشائعة
إذا ظهرت أي أخطاء، يرجى اتباع الخطوات التالية للتحقيق في المشكلة:1.
تأكد من صحة إنشاء مفتاح API: اختيار الحد الأقصى للاستخدامحد ائتمان غير محدود،لا تقيد النموذج، قم باختيار المجموعات قناة codex-gpt:。
نشره @oneai على AIRAI. تواصل معنا إذا كانت لديك أسئلة.
رابط المقال:https://www.airai.cc/ar/appsetting/47/
رابط المقال:https://www.airai.cc/ar/appsetting/47/
هل كان هذا مفيدًا؟