Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

دليل نشر Codex

شرح واضح لتثبيت أداة CLI وربط API وإعداد بيئة التطوير.

📋 المتطلبات المسبقة (الخطوة الأولى) أكمل أولًا تثبيت بيئة Node.js، وتأكد من تثبيت Node.js 18+ بصورة صحيحة. تذكّر فتح الخيارات المتقدمة في CC-Switch أثناء الإعداد؛ وبعد إضافة النموذج يمكنك بدء الدردشة.


🎯 تنقل سريع

Codex هو مساعد برمجي ذكي من الجيل التالي مبني على بنية GPT-5، ويوفر للمطورين إمكانات ممتازة لإنشاء الشيفرة وتحسينها.

مسار النشر: إعداد بيئة النظام ➜ تثبيت أداة CLI ➜ تكامل API ➜ جاهزية بيئة التطوير

🚀 الإعداد السريع باستخدام CC-Switch (موصى به)

⚠️ المتطلبات المسبقة

قبل إعداد Codex باستخدام CC-Switch، تأكد من تثبيت أداة Codex على مستوى النظام عبر npm:

npm install -g @openai/codex@latest
下载压缩包 下载压缩包

تحقق من التثبيت: codex --version

يُنصح باستخدام أداة الإعداد السريع CC-Switch للإعداد عبر واجهة رسومية بسهولة وسرعة، دون الحاجة إلى عمليات سطر الأوامر.

خطوات الإعداد

  1. شغّل CC-Switch وانتقل إلى علامة تبويب Codex

تعرض الصورة واجهة تطبيق CC-Switch، وفي أعلاها عدة علامات تبويب، مع سهم أحمر يشير إلى علامة «Codex» لإبرازها. تتوافق الصورة مع خطوات الإعداد في قسم «الإعداد السريع باستخدام CC-Switch (موصى به)»، وتوضح أنه بعد تشغيل CC-Switch والانتقال إلى علامة Codex، يجب النقر على علامة «Codex» في الأعلى للانتقال إلى عمليات الإعداد التالية. وهذه خطوة أساسية ضمن إعداد CC-Switch.تعرض الصورة واجهة تطبيق CC-Switch، وفي أعلاها عدة علامات تبويب، مع سهم أ…

  1. افتح تطبيق CC-Switch
  2. انقر على علامة التبويب «Codex» في الأعلى
  3. انقر على زر «+» البرتقالي في الزاوية العلوية اليمنى لإضافة إعداد جديد
  4. أدخل إعدادات مزوّد Codex
  5. اسم المزوّد: اسم مخصص (مثل «gpt-agent»)
  6. Base URL: أدخل https://api.llm-token.cn/v1
  7. API Key: الصق مفتاح API الخاص بك
  8. Model: اختر gpt-5.4 (كان أحدث نموذج وقت كتابة الوثيقة هو 5.4)
  9. إعدادات أخرى: عدّل معلمات مثل شدة الاستدلال والوصول إلى الشبكة وفق احتياجاتك
  10. انقر على زر «حفظ»

تعرض الصورة واجهة إضافة إعداد جديد في تطبيق CC-Switch. توجد في الأعلى علامتا تبويب «مزوّد Codex» و«المزوّد الموحد»، والمحدد حاليًا هو «مزوّد Codex». وفي الأسفل تظهر «إعدادات مخصصة» وعدة مزوّدات مسبقة مثل OpenAI Official وShengsuanyun. كما توجد في أسفل الواجهة حقول لإدخال «اسم المزوّد» و«ملاحظة»، وزران «إلغاء» و«إضافة». ترتبط الصورة مباشرةً بالسياق، فهي الواجهة التي تظهر بعد تنفيذ خطوة «انقر على زر + البرتقالي في الزاوية العلوية اليمنى لإضافة إعداد جديد»، وتساعد المستخدم على إكمال الإعداد المخصص.تعرض الصورة واجهة إضافة إعداد جديد في تطبيق CC-Switch. توجد في الأعلى عل…

هذه واجهة تحرير إعداد المزوّد في CC-Switch. يظهر شعار الأداة في الأعلى وعدة حقول: أُدخل «Guishu Cloud Computing» كاسم للمزوّد، ويظهر جزء من محتوى حقل رابط الموقع الرسمي بصيغة «https:///»، كما لُصق المفتاح المحجوب في خانة API Key، وأُدخل «https://api.llm-token.cn/v1» في عنوان طلب API. ويشير شريط التنبيه الأصفر في الأسفل إلى ضرورة إدخال عنوان نقطة نهاية متوافق مع تنسيق OpenAI Response، بينما يوجد زر «حفظ» أزرق في الزاوية السفلية اليمنى. تتوافق الواجهة مع متطلبات إدخال إعدادات المزوّد في دليل نشر Codex.هذه واجهة تحرير إعداد المزوّد في CC-Switch. يظهر شعار الأداة في الأعلى و…

💡 تلميح

  • ينشئ CC-Switch تلقائيًا الملفين ~/.codex/config.toml وauth.json
  • يمكنك إضافة إعدادات لعدة مزوّدين والتبديل بينها في أي وقت
  • بعد تبديل الإعداد، أغلق Codex وأعد تشغيله ليصبح التغيير نافذًا
  1. فعّل الإعداد وابدأ استخدامه
  2. ابحث عن الإعداد الذي أنشأته للتو في قائمة الإعدادات
  3. انقر على زر «قيد الاستخدام حاليًا» إلى يمين الإعداد
  4. سيُعلَّم الإعداد بحالة «قيد الاستخدام حاليًا» (علامة خضراء)
  5. أعد تشغيل Codex ليصبح الإعداد الجديد نافذًا
  6. التبديل السريع من علبة النظام

يدعم CC-Switch التبديل السريع بين إعدادات Codex من خلال علبة النظام:

  • انقر بزر الماوس الأيمن على أيقونة CC-Switch في علبة النظام
  • اختر فئة Codex من القائمة
  • اختر مباشرةً الإعداد الذي تريد الانتقال إليه
  • يصبح الإعداد نافذًا فورًا دون فتح الواجهة الرئيسية

⚠️ تنبيهات

  • يجب إعادة تشغيل Codex بعد تبديل الإعداد ليصبح نافذًا
  • يمكنك اختبار سرعة نقطة نهاية API في CC-Switch

⌨️ الإعداد اليدوي عبر سطر الأوامر

إذا لم تستخدم CC-Switch، فيمكنك إعداد Codex يدويًا باتباع الخطوات التالية.

🖥️ منصة Windows

الخطوة الأولى: تثبيت أداة سطر أوامر Codex

شغّل موجه الأوامر أو PowerShell بصلاحيات المسؤول، ثم نفّذ:

npm install -g @openai/codex@latestcodex --version

أنشئ ملف الإعداد: config.toml

model_provider = "gpt-agent"model = "gpt-5.4"model_reasoning_effort = "xhigh"disable_response_storage = trueapproval_policy = "on-request"sandbox_mode = "danger-full-access"model_supports_reasoning_summaries = true[model_providers.gpt-agent]name = "ikun"base_url = "https://api.llm-token.cn/v1"wire_api = "responses"requires_openai_auth = true

أنشئ ملف المصادقة: auth.json

{  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"}

الخطوة الثالثة: تهيئة مساحة العمل

mkdir my-codex-projectcd my-codex-projectcodex

🍏 منصة macOS

تثبيت أداة Codex

npm install -g @openai/codex@latestcodex --version

تكامل خدمة API

أنشئ دليل الإعداد:

mkdir -p ~/.codexcd ~/.codex

أنشئ إعدادات config.toml:

cat > config.toml << 'EOF'model_provider = "gpt-agent"model = "gpt-5.4"model_reasoning_effort = "xhigh"disable_response_storage = trueapproval_policy = "on-request"sandbox_mode = "danger-full-access"model_supports_reasoning_summaries = true[model_providers.gpt-agent]name = "ikun"base_url = "https://api.llm-token.cn/v1"wire_api = "responses"requires_openai_auth = trueEOF

أنشئ إعدادات المصادقة auth.json:

cat > auth.json << 'EOF'{  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"}EOF

تهيئة مساحة العمل

mkdir my-codex-projectcd my-codex-projectcodex

🐧 منصة Linux

تثبيت أداة Codex

sudo npm install -g @openai/codex@latestcodex --version

1 2

تكامل خدمة API

أنشئ دليل الإعداد:

mkdir -p ~/.codexcd ~/.codex

أنشئ إعدادات config.toml:

cat > config.toml << 'EOF'model_provider = "gpt-agent"model = "gpt-5.4"model_reasoning_effort = "xhigh"disable_response_storage = trueapproval_policy = "on-request"sandbox_mode = "danger-full-access"model_supports_reasoning_summaries = true[model_providers.gpt-agent]name = "ikun"base_url = "https://api.llm-token.cn/v1"wire_api = "responses"requires_openai_auth = trueEOF

أنشئ إعدادات المصادقة auth.json:

cat > auth.json << 'EOF'{  "OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"}EOF

تهيئة مساحة العمل

mkdir my-codex-projectcd my-codex-projectcodex

أين توجد ملفات الإعداد؟

  • Windows: %USERPROFILE%\.codex\
  • macOS/Linux: ~/.codex/

ألا يمكنك الدردشة بعد الإعداد؟

جرّب ما يلي، وإذا استمرت المشكلة فتواصل مع خدمة العملاء

تعرض الصورة واجهة CC Switch، مع عنوان «CC Switch» وعدة أيقونات في الأعلى. يظهر صف «Guishu Cloud Computing» بخلفية خضراء، وعلى يساره أيقونة من ثلاث نقاط، وعلى يمينه علامة «فشل الاستعلام». يشير السهم الأحمر إلى أيقونة الترس في الجهة اليسرى. وتتوافق هذه الأيقونة مع قسم «ألا يمكنك الدردشة بعد الإعداد؟ جرّب ما يلي، وإذا استمرت المشكلة فتواصل مع خدمة العملاء»، وقد تُستخدم لتوجيه المستخدم إلى النقر عليها لإجراء الإعدادات ذات الصلة.تعرض الصورة واجهة CC Switch، مع عنوان «CC Switch» وعدة أيقونات في الأعلى…

هذه لقطة شاشة لواجهة إعدادات CC Switch. يشير سهمان أحمران إلى علامة تبويب «الوكيل» في أعلى الواجهة وإلى مؤشر الحالة «قيد التشغيل» داخل منطقة «الوكيل المحلي». توضح وحدة «الوكيل المحلي» في هذه الواجهة إمكانية تشغيل خدمة الوكيل وإيقافها وعرض حالتها ومعلومات المنفذ، وتشير حالة «قيد التشغيل» إلى أن خدمة الوكيل في البرنامج تعمل بصورة طبيعية.هذه لقطة شاشة لواجهة إعدادات CC Switch. يشير سهمان أحمران إلى علامة تبوي…

تعرض الصورة إعدادات الوكيل في صفحة الإعدادات ضمن دليل نشر Codex. توجد في الأعلى علامات تبويب «عام» و«الوكيل» و«السجلات»، والمحدد حاليًا هو «الوكيل». يظهر المفتاح الرئيسي للوكيل وخيار تفعيل إعادة عرض الوكيل؛ وعند تفعيل إعادة العرض، يظهر خيارا Codex وGemini، مع سهم أحمر يشير إلى Codex. كما تعرض الصفحة عنوان خادم الوكيل ومنفذه ونوعه وإمكاناته وإعدادات تسجيل التطبيق ومفتاح تشغيل سجل التطبيق. ترتبط الصورة بحل مشكلة تعذر الدردشة بعد الإعداد، وتوضح حالة إعدادات الوكيل.تعرض الصورة إعدادات الوكيل في صفحة الإعدادات ضمن دليل نشر Codex. توجد في…