التثبيت وتسجيل الدخول (Mac / Windows / Linux)

📚 تنقل السلسلة: المقال السابق 02 · نظرة سريعة على المفاهيم الأساسية أوضح الكلمات المفتاحية لـ Codex (الوكيل، البيئة المعزولة، الموافقة، المحلي والسحابي). هذا المقال يرافقك لتثبيت الأداة على جهازك بالفعل — لتغطية تطبيق سطح المكتب وسطر الأوامر (CLI) معًا، وشرح التوثيق وتسجيل الدخول، الفروق بين المنصات الثلاث، وحل مشاكل التثبيت الشائعة. المقال التالي 04 · الاشتراك والفوترة سيتحدث عن الأسعار والتكاليف.

قامت OpenAI في بداية عام 2026 بتقسيم Codex إلى أربعة مداخل: نسخة الويب، تطبيق سطح المكتب، سطر الأوامر (CLI)，وإضافات IDE. وخلال تجربتي الشخصية بالانتقال من CLI إلى تطبيق سطح المكتب، فإن الملاحظة الأكثر وضوحًا هي — أن التعليمات الرسمية حول اختيار وطريقة التثبيت لا تتطابق غالبًا مع الشروحات القديمة المتاحة على الويب.

في الواقع، عملية تثبيت Codex ليست معقدة بمفردها، بل الصعوبة تكمن في تحديد المسار الرسمي الصحيح وتفادي الطرق القديمة والمشاكل. ويوضح هذا المقال المسار السليم لكل نظام تشغيل وطريقة تثبيت، لتتجنب الوقوع في الأخطاء التي واجهها أصدقائي سابقًا.

بعد قراءة هذا المقال، ستحصل على:

• مساري التثبيت لتطبيق سطح المكتب و CLI على أنظمة Mac / Windows / Linux (مع توضيح المخرجات المتوقعة لتأكيد نجاح التثبيت بنفسك).
• مقارنة بين الطرق الثلاث لتثبيت CLI (البرنامج النصي الرسمي / Homebrew / npm) لتحديد الخيار الأنسب لك.
• الفروق بين طريقتي تسجيل الدخول (حساب ChatGPT / مفتاح API key)، والحل النموذجي عند تجمد تسجيل الدخول في البيئات البعيدة أو الخوادم.
• دليل سريع لـ «الخطأ وكيفية حله» يغطي غالبية المشاكل التي تواجه المبتدئين.

---

01 ثلاثة أمور يجب توضيحها قبل البدء

لا تتسرع في كتابة الأوامر. يكتشف الكثيرون في منتصف الطريق عدم توفر نسخة لسطح المكتب لنظام تشغيلهم أو حاجة الحساب لتفعيل ميزة المصادقة الثنائية (MFA) مما يضيع الوقت. لذا يرجى التحقق من ثلاثة أمور أولاً:

أولاً: تحديد المدخل الذي ترغب في استخدامه

يتوفر لـ Codex أربعة مداخل، ولكن في التثبيت العملي، ينقسم الأمر لمسارين:

• تطبيق سطح المكتب: واجهة رسومية سهلة الاستخدام تناسب من يفضل الابتعاد عن الطرفية. ولكنه يتوفر لنظامي macOS و Windows فقط، ولا يتوفر لنظام Linux حاليًا (وتعرض الصفحة الرسمية نموذج انتظار للتسجيل).
• سطر الأوامر (CLI): وكيل برمجي يعمل داخل الطرفية، ويدعم الأنظمة الثلاثة بالكامل، وهو الخيار المفضل للمطورين.

نصيحتي: يفضل للمطورين البدء بـ CLI لكونه الأكثر شمولاً وتوافقًا مع المنصات。يركز هذا المقال على مسار CLI، مع تخصيص قسم فرعي لتطبيق سطح المكتب لتوضيح التحميل وتسجيل الدخول الأول. ويمكنك البدء بأي منهما — وحالة تسجيل الدخول تتم مشاركتها بين CLI وإضافات IDE (بينما يتطلب تطبيق سطح المكتب تسجيل دخول منفصل، وسنفصل ذلك في القسم 06).

第二件：你得有个能用的账号

الملاحظة الأكثر إهمالاً من المبتدئين: يرتبط Codex باشتراك باقات ChatGPT.

تنص الوثائق الرسمية بوضوح: باقات ChatGPT المتنوعة مثل Plus و Pro و Business و Edu و Enterprise تشمل استخدام Codex. كما يمكنك استخدامه دون اشتراك بالاعتماد على مفتاح OpenAI API key والدفع حسب الاستهلاك — ولكن عند تسجيل الدخول بمفتاح API key، فإن بعض الميزات التي تعتمد على مساحة عمل ChatGPT ستكون مقيدة أو غير متاحة (على سبيل المثال، يتطلب استخدام Codex السحابي تسجيل الدخول بحساب ChatGPT حتمًا).

تشغيل CLI محليًا بمفتاح API key مدعوم وصالح للاستخدام، وتقوم OpenAI باحتساب التكلفة من حساب المنصة الخاص بك (Platform account) وفقًا لأسعار الواجهة القياسية، وهي منفصلة عن الحصص المدرجة في اشتراك الباقات.

سنشرح تفاصيل الحسابات والفوترة في المقال 04 الاشتراك والفوترة。ويفترض هذا المقال توفر حساب ChatGPT صالح أو مفتاح API key لديك بالفعل.

第三件：网络得能上 OpenAI

يتطلب استخدام Codex بمختلف مداخله اتصالاً مستقرًا بالإنترنت للوصول لخوادم OpenAI. وقد يتطلب الوصول لأسماء النطاقات مثل chatgpt.com أو platform.openai.com استخدام VPN أو خادم بروكسي في بعض المناطق الجغرافية，ويجب تفعيله أثناء التثبيت وتسجيل الدخول وتشغيل المهام لتفادي مشاكل «انتهاء وقت التحميل» أو «فشل استرداد توثيق تسجيل الدخول». وتأكد من تهيئة الشبكة لتجنب هذه المشاكل الشائعة.

💡 الخلاصة في جملة واحدة: تحقق من ثلاثة أمور قبل البدء — اختيار CLI كمدخل أساسي (لتوافقه الكامل)، توفر حساب باقة ChatGPT أو مفتاح API key، واستقرار الاتصال بخدمات OpenAI، وابدأ التثبيت بعد تأكيدها.

---

02 المسار الأول: تطبيق سطح المكتب (Mac / Windows)

يعد تطبيق سطح المكتب الخيار الأسهل لمن يفضل تجنب استخدام الطرفية.

تشبيه: تطبيق سطح المكتب يشبه تشغيل «ChatGPT مع ربطه بمجلد المشروع». أسلوب التحاور يماثل تصفح ChatGPT على الويب؛ والفارق هو قدرته على ربط مجلد محدد على جهازك لقراءة ملفاته وتعديل أكواده وتشغيل أوامره — ليدمج بين صندوق المحادثات ودليل المشروع والذاكرة طويلة المدى معًا.

السيناريوهات الواقعية:

• ترغب في توجيه الذكاء الاصطناعي لتعديل متطلبات بسيطة أو فهم كيفية عمل ميزة معينة في ملفات المشروع دون كتابة أكواد بنفسك.
• ترغب في إدارة عدة مشاريع متوازية — ليوجه المشروع A لتشغيل الاختبارات، وتنتقل للمشروع B لمواصلة إدخال المتطلبات.
• تفضل مراجعة التعديلات عبر واجهة رسومية «لوحة المراجعة» سطرًا بسطر لتحديد قبول التعديلات أو رفضها.

下载与安装

افتح الرابط https://chatgpt.com/codex وحمل حزمة التثبيت المتوافقة مع نظام تشغيلك:

نظام التشغيل	اختيار الحزمة المتوافقة
macOS (Apple Silicon)	حمل الحزمة الافتراضية مباشرة
macOS (معالجات Intel)	اختر Intel build حتمًا
Windows	حمل حزمة التثبيت الرسمية
Linux	لا تتوفر نسخة لسطح المكتب حاليًا، ويمكنك التسجيل في قائمة الانتظار؛ واستخدم CLI حاليًا

هل تواجه صعوبة في معرفة نوع معالج جهاز Mac الخاص بك؟ اضغط على شعار التفاحة في الزاوية العلوية اليسرى ← «حول هذا الجهاز» (About This Mac)，فإذا كان المعالج Apple M فهو Apple Silicon، وإذا كان Intel فقم بتنزيل نسخة Intel build. تنزيل نسخة غير متوافقة يؤدي لفشل التثبيت أو تعطل التطبيق فور تشغيله.

首次登录与选项目

بعد تثبيت التطبيق وفتحه، اتبع ثلاث خطوات:

1. تسجيل الدخول: سجل الدخول بحساب ChatGPT أو مفتاح OpenAI API key (مع مراعاة القيود المفروضة عند استخدام مفتاح API key، كما سنوضح لاحقًا).
2. اختيار المشروع: حدد المجلد الذي ترغب في ربطه بـ Codex ليعمل عليه. وإذا كنت قد استخدمت التطبيق أو CLI أو إضافات IDE سابقًا، فستظهر قائمة بالمشاريع السابقة هنا.
3. إرسال الرسالة الأولى: بعد تحديد المشروع، تأكد من اختيار Local في الزاوية اليسرى السفلية (ليعمل Codex محليًا على جهازك، وليس سحابيًا)، واكتب متطلباتك في صندوق الإدخال.

عند استخدام التطبيق للمرة الأولى، لا تشتت نفسك بالميزات المعقدة، وركز على «المحادثة» و «المشروع»: فالمحادثة تماثل محاورات ChatGPT المعتادة؛ والمشروع يربط المجلد على جهازك ليعمل Codex داخله فقط.

بعد التثبيت والتشغيل، يمكنك تغيير اللغة من الإعدادات في الزاوية اليسرى السفلية «Settings → General → Language» (ويستطيع التطبيق التعرف على لغة النظام تلقائيًا). وتظهر الواجهة العامة للتطبيق كالتالي تقريبًا:

💡 الخلاصة في جملة واحدة: يتوفر تطبيق سطح المكتب لنظامي Mac و Windows فقط، ومستخدمو Mac يجب عليهم التحقق من نوع المعالج (Intel / Apple Silicon)；وخطوات العمل ثلاث — تسجيل الدخول، اختيار مجلد المشروع، والتأكد من تفعيل وضع Local قبل إرسال الرسائل.

---

03 CLI（三平台一条命令）

الخلاصة أولاً: يوصى باستخدام البرنامج النصي للتثبيت الرسمي لجميع الأنظمة (standalone installer). فهو لا يتطلب بيئة Node.js، ويقوم بتثبيت ملف ثنائي مستقل لتجنب تعارض الملفات.

تشبيه: البرنامج النصي الرسمي يشبه «التثبيت بضغطة زر» في المتاجر. يقوم بتحميل الملفات ووضعها في موضعها الصحيح تلقائيًا دون تعديل بقية إعدادات النظام؛ بينما يشبه التثبيت بـ npm «تثبيت أداة إدارة حزم أولاً، ثم استخدامها لتثبيت التطبيق» — مما يضيف اعتمادية إضافية (Node.js) ويزيد من احتمالات حدوث خلل.

macOS / Linux

افتح الطرفية وانسخ الأمر التالي:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

ملاحظة الشبكة: يتطلب الوصول لنطاق chatgpt.com استخدام VPN أو خادم بروكسي في بعض المناطق لضمان استقرار الاتصال، وتفعيله أثناء التثبيت يوفر عناء مواجهة أخطاء «المهلة وتوقف التحميل».

وإذا كنت تكتب برمجيات أتمتة أو ترغب في التثبيت الصامت في بيئات CI (بدون مطالبات تفاعلية)، فيمكنك استخدام المتغير التالي:

curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh

Windows（原生，不用 WSL）

شغل الأمر التالي في PowerShell (حيث يظهر المؤشر كالتالي PS C:\>):

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

للتثبيت الصامت (بيئات CI والبرمجيات):

$env:CODEX_NON_INTERACTIVE=1; irm https://chatgpt.com/codex/install.ps1 | iex

خيار -ExecutionPolicy ByPass يهدف للسماح بتشغيل البرنامج النصي لمرة واحدة دون تعديل سياسات نظامك الدائمة؛ ويمثل irm اختصارًا لـ (Invoke-RestMethod) لتحميل الملف، ويمثل iex اختصارًا لـ (Invoke-Expression) لتشغيله. وإذا ظهر تنبيه يفيد بعدم التعرف على irm فذلك يعني تشغيله في موجه الأوامر القديم CMD، ويرجى فتح نافذة PowerShell وتجربته مجددًا.

还有别的路：Homebrew / npm

تتوفر طريقتان بديلتان للتثبيت بجانب البرنامج النصي الرسمي، وإليك مقارنة بينهما:

طريقة التثبيت	الأمر المستخدم	المتطلبات المسبقة	نصيحتي
البرنامج النصي الرسمي	curl ... | sh (أو irm لـ Win)	لا يوجد	الخيار المفضل؛ ملف ثنائي مستقل وخالٍ من التعارضات
Homebrew (Mac)	brew install --cask codex	تثبيت Homebrew	لمن يعتمد على brew لإدارة تطبيقاته؛ وقد يتأخر التحديث قليلاً
npm	npm install -g @openai/codex	بيئة Node.js	لمن يفضل استخدام npm لتثبيت الأدوات العامة

قد يتأخر تحديث نسخة Homebrew ليوم أو يومين مقارنة بالنسخة الرسمية لخضوعها لمراجعة فريق Cask؛ والميزة هي استقرار النسخة واختبارها لمن لا يفضل تتبع التحديثات اليومية السريعة.

تثبيت Homebrew (على نظام macOS):

brew install --cask codex

تثبيت npm (لجميع المنصات، ويتطلب توفر Node.js):

npm install -g @openai/codex

تنبيهات هامة لتفادي المشاكل الشائعة:

• تجنب استخدام sudo لتثبيت حزم npm. تنصح بعض الشروحات القديمة باستخدام sudo npm install -g، ولكن استخدام sudo لتثبيت حزم npm العامة قد يسبب مشاكل وصلاحيات متعارضة للمجلدات. والأسلوب الصحيح هو — استخدام أدوات مثل nvm أو Volta لتثبيت Node تحت دليل المستخدم وتجنب استخدام sudo بالكامل؛ وعند حدوث أخطاء في الصلاحيات، يفضل الانتقال لاستخدام البرنامج النصي الرسمي وتفادي استخدام npm تمامًا.
• تثبيت Homebrew يتطلب خيار --cask，يرجى عدم إهماله وتأكيد كتابة اسم الحزمة codex بشكل صحيح.

💡 الخلاصة في جملة واحدة: يوصى باستخدام البرنامج النصي الرسمي لـ CLI، عبر curl ... | sh لنظامي Mac و Linux، وعبر irm لنظام Windows；لكونه ملفًا ثنائيًا مستقلًا لا يعتمد على Node.js؛ وتظل خيارات Homebrew و npm كبدائل مع تجنب استخدام sudo مع npm.

بعد شرح مساري التثبيت، نوضح الفروق بينهما في هذا الرسم البياني:

يوضح الرسم مسار تطبيق سطح المكتب ومسار CLI: المسار الأيسر يعتمد على تحميل حزمة التطبيق وتشغيلها وتسجيل الدخول؛ والمسار الأيمن يعتمد على تثبيت الأداة وتشغيل أمر codex login，وينتهي كلاهما بنجاح تسجيل الدخول وجاهزية العمل، مع دعم تسجيل الدخول بحساب ChatGPT أو مفتاح API key.

---

04 لمستخدمي Windows: البيئة الرسمية أم WSL؟

يعد نظام Windows الأكثر تفصيلاً وتعقيدًا بين المنصات الثلاث، وسنفصل خياراته هنا.

وتوفر الوثائق الرسمية ثلاثة خيارات لتشغيله:

• البيئة الرسمية لـ Windows مع وضع elevated للبيئة المعزولة: الخيار المفضل. يعتمد على مستخدم بيئة معزولة بصلاحيات منخفضة، جدار حماية وقواعد نظام الملفات لحصر عمل Codex داخل مجلد العمل، وهو الخيار الأكثر أمانًا.
• البيئة الرسمية لـ Windows مع وضع unelevated: خيار بديل. يُستخدم عند وجود سياسات حماية تمنع صلاحيات المدير لتهيئة وضع elevated؛ ويوفر مستوى حماية أقل مع الحفاظ على عزل العمليات.
• بيئة WSL2 (Linux لـ Windows): يعمل في بيئة Linux ويعتمد على نظام عزل العمليات الخاص بـ Linux. يوصى به عند الحاجة لأدوات العمل الخاصة بـ Linux أو عند وجود مستودع الأكواد داخل WSL2 بالفعل.

طريقة التشغيل	المتطلبات	متى تُستخدم
البيئة الرسمية + elevated	صلاحيات المدير لتهيئة الصلاحيات	الخيار المفضل افتراضيًا، أداء أفضل وأمان أعلى
البيئة الرسمية + unelevated	لا تتطلب صلاحيات المدير	كبديل عند حظر سياسات الشركة لوضع elevated
WSL2	تفعيل ميزة WSL2	عند الحاجة لأدوات Linux أو وجود المستودع داخل WSL2

تنبيهات هامة:

• إصدار نظام Windows: يوصى رسميًا بـ Windows 11؛ ويتم دعم نظام Windows 10 بحدود الإمكان، ويتطلب إصدار 1809 أو أحدث (لاعتماده على مكونات ConPTY الحديثة)，ولا ينصح بالإصدارات الأقدم.
• جاهزية أداة winget: يجب توفر أداة إدارة حزم Windows وتحديثها أولاً.
• إلغاء دعم WSL1: بدءًا من إصدار Codex 0.115 تم اعتماد bubblewrap لنظام عزل العمليات في Linux، وتم إلغاء دعم WSL1 بعد إصدار 0.114，لذا يتعين عليك استخدام WSL2.

وعند اختيار WSL2، قم بتثبيت النظام الفرعي أولاً بتشغيل الأمر التالي في PowerShell بصلاحيات المدير، ثم ادخل لـ WSL shell لتشغيل برنامج التثبيت:

wsl --install
wsl

بعد الدخول لبيئة WSL (حيث يتغير مؤشر الإدخال لمؤشر Linux):

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

تنبيه أداء WSL: تجنب وضع مستودعات الأكواد تحت مسارات Windows المعلقة مثل /mnt/c/...，I/O 会明显慢，还容易出 symlink、权限问题。放在 Linux 主目录（如 ~/code/my-app ）下最快。需要从 Windows 访问这些文件时，去资源管理器输 \\wsl$ 进去找。

يساعدك هذا المخطط في اتخاذ القرار للخطوة التالية في Windows:

💡 الخلاصة في جملة واحدة: يفضل لمستخدمي Windows استخدام البيئة الرسمية مع وضع elevated، كبديل عند الحظر استخدم وضع unelevated، ولأدوات Linux استخدم WSL2；مع مراعاة إلغاء دعم WSL1 واستقرار Windows 11.

---

05 验证装没装成功

بعد الانتهاء من تثبيت CLI، تحقق من نجاح التثبيت بفتح نافذة طرفية جديدة وتشغيل الأمر التالي:

codex --version

المتوقع رؤيته هو طباعة رقم الإصدار الحالي (ويتغير الرقم حسب التحديثات):

codex-cli 0.139.0

رؤية رقم الإصدار تعني نجاح التثبيت. وإذا ظهر تنبيه يفيد بعدم التعور على الأمر command not found: codex (أو 'codex' is not recognized 在 Windows 上），先别重装——大概率是 PATH 没配好（安装目录没进系统搜索路径），第 08 节有修法。

تختلف معاملات التحقق من الإصدار وكيفية الترقية اليدوية للنسخ الأحدث حسب التحديثات، ويرجى الاعتماد على الوثائق الرسمية ومخرجات أمر codex --help لتفادي كتابة أوامر قد يطالها التغيير مستقبلاً. وتشغيل أمر codex --help يوضح لك قائمة الأوامر المدعومة للإصدار الحالي بكل دقة.

ويمكن مراجعة رقم إصدار تطبيق سطح المكتب من قائمة التطبيق (الرجاء مراجعة مواضعه الرسمية). وقد يؤدي اختلاف الإصدارات بين التطبيق و CLI لحدوث فوارق في الميزات، وعند وجود مشكلة تحقق من أرقام الإصدارات لكل منهما.

💡 الخلاصة في جملة واحدة: يكفي تشغيل codex --version لتأكيد نجاح التثبيت؛ وتعتمد الترقية ومعاملات الإصدارات على مخرجات codex --help والوثائق الرسمية وتجنب كتابة أوامر الشروحات القديمة.

---

06 تسجيل الدخول: ربط الحساب للعمل

يحتاج Codex بعد تثبيته لربطه بحسابك لتفعيل عملياته. ابدأ بتشغيل CLI داخل مجلد مشروعك:

codex

عند عدم توفر جلسة تسجيل دخول صالحة، سيوجهك تلقائيًا لتسجيل الدخول بحساب ChatGPT، وسيفتح المتصفح للحصول على التوثيق والموافقة، وبمجرد منح الموافقة سيقوم المتصفح بإرسال رمز الوصول (access token) للطرفية لإتمام تسجيل الدخول.

两种登录方式，怎么选

الطريقة	كيفية تسجيل الدخول	الفئة المستهدفة	تنبيهات
حساب ChatGPT (موصى به)	اختيار تسجيل الدخول بـ ChatGPT، ومنح التوثيق من المتصفح	غالبية المستخدمين، وعند الحاجة للميزات السحابية	تستهلك الحصص من اشتراك باقة ChatGPT الخاص بك
مفتاح API key	اختيار تسجيل الدخول بمفتاح API، وجلب المفتاح من إعدادات OpenAI Platform	لبيئات CI/CD والبرمجيات المؤتمتة	يتم احتساب التكلفة وفقًا لأسعار الواجهة القياسية؛ ولا تتوفر بعض الميزات المرتبطة بمساحة عمل ChatGPT

أنا أفضل استخدام حساب ChatGPT للتطوير اليومي — لكون الحصص المتوفرة في الباقة كافية للاستخدام وتدعم العمليات السحابية. بينما أعتمد على مفتاح API key لكتابة برمجيات الأتمتة وإدراجها في بيئات CI，因为它不需要浏览器交互，适合无人值守；但官方也提醒：别把带 API key 的 Codex 跑在不可信或公开环境里。

登录态存在哪、会不会反复登

بعد نجاح تسجيل الدخول، يتم حفظ التوثيق محليًا واستدعاؤه تلقائيًا عند بدء الجلسات التالية. وإليك نقطتين هامتين:

• تتم مشاركة توثيق تسجيل الدخول بين CLI وإضافات IDE——在一边登出，另一边下次启动也得重登。
• تُخزن البيانات محليًا كملف نصي واضح تحت مسار ~/.codex/auth.json 或 OS 系统凭据存储里（macOS 上可能走 Keychain）；用 cli_auth_credentials_store 可指定（file / keyring / auto，详见第 18 节配置篇）。

⚠️ يحتوي الملف ~/.codex/auth.json على رمز الوصول الشخصي (access token)，لذا يجب حمايته ككلمة مرور تمامًا: وتجنب رفعه لـ Git، مشاركته في طلبات الدعم، أو إرساله في غرف المحادثة العامة.

وعند تسجيل الدخول بحساب ChatGPT، يقوم Codex بتحديث رمز الوصول (token) تلقائيًا قبل انتهاء صلاحيته لتجنب تكرار تسجيل الدخول.

远程 / 服务器 / WSL 登录卡住怎么办

هذه هي المشكلة التي واجهها صديقي في البداية: عند تشغيل الخوادم البعيدة، بيئات headless الخالية من الواجهات، أو عند حظر منافذ استرداد localhost، سيتعذر تسجيل الدخول بالمتصفح——要么浏览器开在另一台机器上，要么 OAuth 回调回不来。官方首选解法是设备码登录（Device Code Login）。

اختر Sign in with Device Code من واجهة تسجيل الدخول، أو شغل الأمر التالي مباشرة:

codex login --device-auth

وهذه ميزة تجريبية (beta). ستعرض لك رابطًا ورمز تحقق لمرة واحدة، وبفتح الرابط من أي متصفح إنترنت متاح على أي جهاز آخر وكتابة الرمز، سيتم تسجيل الدخول بنجاح دون الحاجة لمتصفح محلي.

يتطلب تفعيل تسجيل الدخول برمز الجهاز إعداده مسبقًا في إعدادات الأمان لـ ChatGPT (للحسابات الشخصية) أو صلاحيات مساحة العمل (للمدراء). وإذا تعذر تشغيل الميزة، فإليك خيارين بديلين:

1. نسخ ملف التوثيق: قم بتسجيل الدخول بأمر codex login بشكل طبيعي على جهاز يحتوي على متصفح، وتأكد من إنشاء ملف ~/.codex/auth.json، ثم انسخه لخادم headless البعيد تحت نفس المسار. مثل استخدام SSH:

   ssh user@remote 'mkdir -p ~/.codex'
   scp ~/.codex/auth.json user@remote:~/.codex/auth.json

2. توجيه المنافذ عبر SSH: قم بتوجيه منفذ استلاف التوثيق المحلي (المنفذ الافتراضي localhost:1455) من الخادم البعيد لجهازك المحلي، ليتم التوثيق بالمتصفح بشكل طبيعي:

   ssh -L 1455:localhost:1455 user@remote

   然后在这个 SSH 会话里跑 codex login，按提示在你本地浏览器打开地址即可。

وقمت بحل المشكلة لصديقي باستخدام رمز الجهاز — بتشغيل أمر codex login --device-auth وفتح الرابط في متصفحه وإدخال الرمز، ليرتبط الحساب في نصف دقيقة دون الحاجة لانتظار فتح المتصفح على الخادم.

💡 الخلاصة في جملة واحدة: يفضل تسجيل الدخول بحساب ChatGPT افتراضيًا، وتُخزن البيانات في ملف ~/.codex/auth.json (الرجاء حمايته ككلمة مرور)؛ وللبيئات البعيدة استخدم أمر codex login --device-auth，不行再拷贝缓存或 SSH 转发 1455 端口。

---

07 تمرين عملي: تشغيل الجلسة الأولى بنجاح

التثبيت بمفرده غير كافٍ، ويجب تشغيل الجلسة للتأكد من استقرار الربط. لا يتطلب هذا التمرين وجود مشروع، وسنقوم بإنشاء مجلد فارغ فقط.

الخطوة الأولى: إنشاء مجلد تجريبي والدخول إليه، ثم تشغيل Codex:

mkdir codex-test && cd codex-test
codex

سيوجهك التشغيل الأول لتسجيل الدخول (اتبع الخطوات الموضحة في القسم 06). وستشاهد بعد ذلك رسالة الترحيب وصندوق إدخال الأوامر.

الخطوة الثانية: إعطاؤه مهمة حقيقية باللغة الطبيعية (دون الحاجة لصيغ برمجية معقدة):

اكتب دالة بلغة Python لطباعة عبارة hello world في ملف باسم test.py

المتوقع حدوثه: يعمل Codex افتراضيًا بطلب الموافقة مسبقًا — فعند الرغبة في تعديل الملفات أو تشغيل الأوامر، سيعرض لك الإجراء أولاً وينتظر تأكيدك (اختيار Yes) لبدء التنفيذ. وهذا هو أسلوب عمله الأساسي: يقترح الحل ← ينتظر موافقتك ← يبدأ العمل، لضمان عدم تعديل أي ملفات دون علمك (وسنفصل أوضاع الصلاحيات والبيئة المعزولة في مقالات لاحقة).

بعد منح الموافقة، ستجد ملف test.py قد تم إنشاؤه داخل المجلد. وللخروج من واجهة CLI اضغط على Ctrl + C أو اكتب /exit（以界面提示为准）。

الخطوة الثالثة (عادة ينصح بالالتزام بها): بما أن Codex سيقوم بتعديل ملفات مشروعك، يرجى أخذ نقطة فحص (Git checkpoint) قبل وبعد العمل، لتتمكن من التراجع بضغطة زر عند حدوث أي خلل:

git init
git add -A && git commit -m "نقطة فحص قبل تعديلات codex"

بإتمام ذلك، تكون قد طبقت مسار العمل بالكامل: «التثبيت ← تسجيل الدخول ← كتابة التوجيه باللغة الطبيعية ← مراجعة الإجراءات ← منح الموافقة ← تعديل الملفات». ومطالبته لك بالموافقة وتوقفه لعرض الإجراءات يمنحك شعورًا بالثقة والاستقرار — وعند تجربتي الأولى، ذُهلت من سرعة قراءته لملفات المشروع، ثم أسعدني توقفه لطلب موافقتي قبل بدء التعديل.

يوضح المخطط التالي تسلسل الخطوات السابقة:

النقطة الأهم في المخطط هي بوابة الموافقة في المنتصف: فمنح الموافقة بـ Yes يبدأ العمل، ورفضها بـ No يطالبه بتقديم اقتراح بديل — لضمان عدم لمس ملفاتك دون علمك.

💡 الخلاصة في جملة واحدة: يكفي إنشاء مجلد فارغ لتشغيل المسار بالكامل — تشغيل codex وتسجيل الدخول، كتابة التوجيه باللغة الطبيعية، ومراجعة الإجراءات للموافقة بـ Yes؛ وتأمين العمل بأخذ نقاط فحص Git يضمن استقرار مشروعك وحمايته.

---

08 استكشاف الأخطاء: حلول للمشاكل الشائعة للمبتدئين

قد تواجه بعض الأخطاء أثناء التثبيت، ولكن غالبيتها تمتلك حلولاً نموذجية بسيطة. وإليك جدولاً سريعا بأكثر الأخطاء شيوعًا لتتمكن من حلها دون الحاجة لإعادة التثبيت:

الخطأ / العطل المعروض	السبب الفعلي	كيفية الحل
command not found: codex	لم يتم إضافة دليل التثبيت لـ PATH	إضافة الدليل لمسارات PATH (راجع التوضيح أدناه)
'codex' is not recognized (Windows)	نفس السبب، لم يتم التحديث أو إعادة تشغيل الطرفية	تهيئة مسار PATH وإعادة تشغيل الطرفية
irm is not recognized	تشغيل أمر PowerShell في CMD القديم	فتح نافذة PowerShell وتشغيل الأمر فيها
تجمد تسجيل الدخول في المتصفح / فشل الاسترداد	بيئات headless / خوادم بعيدة / حظر منافذ localhost	استخدام التوثيق برمز الجهاز codex login --device-auth (القسم 06)
توقف أو انتهاء مهلة برنامج التثبيت	بطء الشبكة المحلية أو حظر الاتصال	تشغيل VPN للمحاولة مجددًا، أو التثبيت بـ Homebrew
عدم توفر بعض الميزات بعد ربط مفتاح API key	قيود مفتاح API key وغيابه عن مساحة عمل ChatGPT	تسجيل الدخول بحساب ChatGPT
خطأ Windows رقم 1385 (فشل تشغيل البيئة المعزولة)	حظر سياسات الويندوز لصلاحيات مستخدم البيئة المعزولة	مراجعة قسم IT؛ أو التحويل لوضع unelevated مؤقتًا
استمرار تشغيل codex بعد حذفه	توفر عدة نسخ مثبتة وتعارضها	تشغيل which -a codex لتحديد النسخ وحذف الزائد منها

دعنا نوضح المشكلتين الأكثر شيوعًا بالتفصيل:

المشكلة الأولى: عدم العثور على الأمر command not found: codex (الأكثر شيوعًا)

ظهور رسالة تعذر العثور على الأمر عند تشغيل codex — لا يعني فشل التثبيت، بل يعني عدم إضافة مجلد التثبيت لمسارات البحث بالنظام (PATH).

تشبيه: مسار PATH يشبه «قائمة عناوين المنازل» بالنظام. تثبيت البرنامج يشبه بناء المنزل، ولكن النظام يبحث عن البرامج فقط في العناوين المسجلة بالقائمة. وعند غياب عنوان codex من القائمة، فلن يتمكن النظام من العثور عليه وتشغيله.

طريقة الحل (على نظام macOS المعتمد على Zsh؛ تأكد من مجلد تثبيت codex أولاً ثم أضفه لمسارات PATH):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

يفترض الأمر السابق تثبيته في المجلد ~/.local/bin؛ ويرجى الاعتماد على المسار المعروض بنهاية تشغيل برنامج التثبيت. وعلى نظام Linux المعتمد على Bash، استبدل .zshrc بـ .bashrc. وعلى نظام Windows قم بإضافة المسار لمتغيرات بيئة المستخدم (PATH) ثم أعد تشغيل الطرفية.

التحقق بعد التعديل:

codex --version

ظهور رقم الإصدار يعني حل المشكلة بنجاح.

المشكلة الثانية: تعارض عدة نسخ مثبتة معًا

عند التثبيت باستخدام npm وتكرار التثبيت بالبرنامج النصي الرسمي، قد تتواجد عدة نسخ من codex على نفس الجهاز، مما يسبب تعارضًا في الصلاحيات والإصدارات وتصرفات غير متوقعة. تحقق من النسخ المتوفرة بتشغيل:

which -a codex

وعند ظهور أكثر من مسار، احتفظ بالنسخة التي ترغب فيها فقط (ويفضل النسخة المثبتة بالبرنامج النصي الرسمي) واحذف النسخ الأخرى. على سبيل المثال، لحذف نسخة npm العامة:

npm uninstall -g @openai/codex

في كثير من الأحيان، يوضح تشغيل أمر which -a codex وجود تعارض بين نسخة npm والنسخة الرسمية على نفس الاسم — وحذف النسخة الزائدة ينظم مسار العمل فورًا. واجهت هذه المشكلة شخصيًا عندما جربت تثبيته بـ npm أولاً ثم قمت بالتثبيت بالبرنامج النصي الرسمي، فاستمر أمر codex --version في عرض رقم إصدار npm القديم لتقدم مسار مجلد npm في قائمة PATH، وحل التعارض رتب العملية بنجاح.

💡 الخلاصة في جملة واحدة: تحقق من أسباب الأخطاء من الجدول أولاً وتجنب التسرع في إعادة التثبيت；فمشاكل عدم التعرف على الأوامر ترجع لـ PATH، والتصرفات الغريبة ترجع لتعارض النسخ ويمكن فحصها بأمر which -a codex.

---

09 ملخص

لخص هذا المقال خطوات التثبيت والتشغيل الفعلي لـ Codex:

• التحقق قبل التثبيت: اختيار CLI لضمان شمول التوافق، توفر حساب ChatGPT أو مفتاح API key، واستقرار الاتصال بخدمات OpenAI.
• مسارا التثبيت: يتوفر تطبيق سطح المكتب لنظامي Mac و Windows فقط (مع التحقق من نوع المعالج لـ Mac)؛ ويتوفر CLI للأنظمة الثلاثة ويوصى بالبرنامج النصي الرسمي (curl ... | sh أو irm لـ Windows) وتظل خيارات Homebrew و npm كبدائل.
• تفاصيل نظام Windows: يفضل استخدام البيئة الرسمية مع وضع elevated، كبديل عند الحظر استخدم وضع unelevated，ولبيئات Linux استخدم WSL2 مع مراعاة إلغاء دعم WSL1.
• تسجيل الدخول: يفضل استخدام حساب ChatGPT، وتُخزن البيانات في ملف ~/.codex/auth.json؛ وللبيئات البعيدة والخوادم استخدم التوثيق برمز الجهاز codex login --device-auth.
• حلول الأخطاء الشائعة: تحقق من مسارات PATH عند عدم التعرف على الأوامر، وتأكد من عدم تعارض النسخ بأمر which -a codex.

يجب أن تكون قادرًا الآن على تثبيت Codex (التطبيق أو CLI) بشكل مستقل على جهازك، تسجيل الدخول، تشغيل أول مهمة، والتعامل مع المشاكل الشائعة وحلها.

المقال التالي 04 · الاشتراك والفوترة — سنوضح تفاصيل التكاليف: ما هي الحصص الموفرة لـ Codex في باقات ChatGPT المختلفة؟ كيف تُحتسب التكلفة لمفتاح API key حسب الاستهلاك؟ وأيهما أفضل مقارنة بتكاليف Claude Code؟ قبل البدء بالاستخدام الكثيف، افهم حدود حسابك وحصصه اليومية لتفادي التوقف بسبب القيود الماليّة.

سؤال للتفكير: هل اخترت تسجيل الدخول بـ حساب ChatGPT أم بـ مفتاح API key؟ لا يقتصر الاختلاف على «طريقة الدخول» فقط — بل يمتد ليشمل الفوترة والتكاليف والميزات المتاحة أيضًا，这正是下一篇的切入点。

---

التثبيت هو مجرد البداية، وفهم الحصص والفوترة يضمن لك استخدامًا مستقرًا دون مفاجآت — نلقاكم في المقال القادم.

---

قراءات موصى بها

• القواعد والخطافات (Rules & Hooks): تزويد Codex بالنقاط والمحفزات للعمل
• دليل استخدام Windows: البيئة الرسمية أم WSL، تشغيل مستقر دون مشاكل
• المهارات (Agent Skills): حزم الإجراءات المتكررة لتعليم Codex كيفية توليها