كيفية جعل تطبيق Codex يعمل على Windows/Linux

OpenAI’s Codex هو «مركز قيادة» جديد لتطوير البرمجيات المعتمد على الوكلاء: تطبيق سطح مكتب + CLI + ملحقات IDE تُمكّن المطوّرين من تشغيل سير عمل برمجي متعددة الوكلاء، وإنشاء مساحات عمل معزولة للتجارب، وأتمتة مهام هندسية كبيرة وطويلة الأمد. تطبيق OpenAI’s Codex هو واجهة سطح مكتب لتشغيل وتنظيم وكلاء البرمجة بالذكاء الاصطناعي محليًا وفي السحابة. انطلق على macOS — وبحلول أوائل مارس 2026 — تم توسيعه ليشمل Windows، مع التخطيط لدعم Linux.

ما هو تطبيق Codex — ولماذا يهم

Codex هو عائلة من وكلاء البرمجة بالذكاء الاصطناعي وأدوات مرتبطة تساعد المطورين على كتابة الكود وإعادة هيكلته واختباره وتنظيمه عبر سير عمل قائمة على الوكلاء ومهام طويلة الأمد وتنسيق متعدد الوكلاء. تطبيق Codex هو منتج سطح مكتب يجمع هؤلاء الوكلاء في واجهة واحدة لإدارة المشاريع، وخيوط وكلاء متوازية، وخيوط مستمرة/مدعومة سحابيًا. يُكمل التطبيق واجهة سطر الأوامر Codex وعمليات التكامل مع IDE (مثل الملحقات)، وصُمّم ليكون «مركز التحكم» للبرمجة القائمة على الوكلاء.

لماذا يهم الآن:

• مضاعِف الإنتاجية: تتيح سير العمل القائمة على الوكلاء تشغيل العديد من المهام بالتوازي — مثل توليد كود الإطار، تشغيل مجموعات الاختبارات، وفرز تقارير الأخطاء — ما يوفر وقتًا حقيقيًا للمطورين.
• أتمتة طويلة الأمد: يستطيع Codex الحفاظ على المهام والتقدّم فيها عبر ساعات أو أيام (مهم لاستقصاءات CI، ترقيات الاعتمادات، أو عمليات إعادة هيكلة كبيرة).
• تكامل المنصات: وسّعت OpenAI Codex ليشمل تجارب سطح المكتب وIDE، ويُدعم التطبيق الآن Windows أصلاً (و macOS بالفعل)، ما يوسّع الوصول إلى مزيد من المطوّرين. تشير مؤشرات مبكرة إلى أن نسخة macOS تجاوزت مليون تنزيل في أسبوعها الأول — إشارة إلى طلب قوي.
• زخم تنافسي: إطلاق التطبيق هو جزء من سباق أوسع مع مزوّدين آخرين يضيفون ميزات برمجة قائمة على الوكلاء (سياق من تغطية الصناعة).

تتحرّك OpenAI بسرعة — تُظهر إدخالات سجل التغييرات المتكررة في أواخر فبراير 2026 إصلاحات يومية وتحسينات في الأداء، لذا توقّع أن يتطوّر التطبيق بينما تدمجه في سير عملك.

التوفّر الحالي وسير العمل المدعومة

• CLI الخاص بـ Codex مدعوم على macOS وWindows وLinux ويمكن تثبيته عبر مديري الحزم (npm/Homebrew) أو بتنزيل حِزم المنصات. يعمل CLI محليًا، ويمكنه فحص المستودعات وتعديلها، ويطالبك بتسجيل الدخول باستخدام ChatGPT أو مفتاح API.
• تطبيق Codex لسطح المكتب (واجهة رسومية GUI) شُحن أولًا على macOS؛ وأضيف دعم Windows في تحديث لاحق. وقت كتابة هذه السطور، يوجد نموذج تسجيل للتوافر على Linux لسطح المكتب (تجمع OpenAI معلومات التوزيعات). إذا أردت واجهة رسومية على Linux اليوم، خياراتك هي: استخدام CLI + ملحقات IDE، تشغيل Codex السحابي/الويب عبر chatgpt.com/codex، أو (للمستخدمين المُغامرين) تشغيل مشاريع المجتمع التي تنقل تطبيق macOS المبني بـ Electron إلى Linux (غير رسمي).

3 طرق لتشغيل Codex على جهازك

هناك ثلاثة أوضاع عملية لمستخدمي Windows وLinux:

1. تطبيق سطح مكتب أصلي (Windows): نسخة Windows الرسمية (عزل أصلي، تكامل PowerShell). يُنصح بها لمعظم أجهزة Windows المكتبية.
2. WSL (Windows Subsystem for Linux) + تطبيق Codex: مفيد إذا كنت تفضّل بيئة Linux أو كانت سلسلة أدوات التطوير لديك من أصل Linux. يمكن تهيئة تطبيق Windows لاستخدام WSL كبيئة تشغيل للوكلاء.
3. Linux (CLI / وضع المطوّر): رغم أن نسخة سطح المكتب لـ Linux كانت في البداية «قريبًا»، يمكنك تشغيل CLI الخاص بـ Codex، ملحقات IDE، أو جهود المجتمع لتشغيل تجربة سطح المكتب على Linux (أو متابعة نموذج الإشعارات من OpenAI). مستودع codex CLI (OpenAI) متاح لسير عمل الوكلاء محليًا.

متطلبات النظام واعتبارات الأمان (ملخّص)

• Windows: Windows 10/11 (بنواة 64). يتوفر عزل أصلي لـ Windows وPowerShell في تطبيق Windows للحد من تنفيذ الكود غير الموثوق. إذا استخدمت WSL، يُوصى بـ WSL2.
• Linux: يختلف حسب التوزيعة. تطبيق سطح المكتب غير متاح عامًّا بعد؛ استخدم CLI أو ملحقات IDE الآن. يتوفر التسجيل لتلقي إشعارات حول النسخ المخصّصة لـ Linux.
• RAM/CPU: قد تكون أعباء الوكلاء ثقيلة إذا طلبت منهم تشغيل اختبارات أو بناءات — خطّط لعدّة أنوية و8–16GB RAM للاستخدام العادي، وأكثر للتوازي الثقيل.
• أفضل ممارسات الأمان: استخدم ميزات العزل في التطبيق، شغّل الوكلاء بامتيازات أقل، اعزل أدلة المشاريع، واستخدم مفاتيح API قصيرة العمر أو تسجيل دخول المستخدم بدل تضمين المفاتيح في المستودعات.

كيفية تشغيل تطبيق Codex على Windows — خطوة بخطوة

حالتان طبيعيتان على Windows:1) استخدم تطبيق Codex سطح المكتب الأصلي (Microsoft Store / مُثبّت أصلي).
2) استخدم Codex CLI في PowerShell أو WSL، مع إمكانية إقرانه بملحق VS Code.

فيما يلي تسلسل عملي على غرار الاختبار: التثبيت، التهيئة، الاتصال بـ WSL (اختياري)، واستكشاف الأخطاء وإصلاحها.

1) تنزيل وتثبيت تطبيق Codex الرسمي لـ Windows

1. زر صفحة تطبيق Codex ونزّل مُثبّت Windows (MSI/EXE) من صفحة الوثائق/التنزيل الرسمية. (تعرض صفحة تطبيق OpenAI’s Codex تنزيل Windows وملاحظات دعم Windows.)
2. شغّل المُثبّت كمشرف. إذا حذّر Windows SmartScreen، تحقّق من الناشر واسمح بالتثبيت.

مثال PowerShell (تثبيت صامت عبر موجه إداري):

# From an elevated PowerShell prompt (Admin)$installer = "C:\path\to\Codex-Setup.exe"Start-Process -FilePath $installer -ArgumentList "/S" -Wait

2) التشغيل الأول، تسجيل الدخول، ووضع API مقابل وضع الحساب

أطلق Codex من قائمة البدء. عند التشغيل الأول سيُطلب منك تسجيل الدخول باستخدام حسابك على ChatGPT/OpenAI أو تقديم مفتاح OpenAI API. يمنح تسجيل الدخول باستخدام حسابك أفضل تجربة (خيوط سحابية وحالة مستمرة). استخدام مفتاح API ممكن لكنه قد يقيّد بعض الميزات السحابية. راجع وثائق المطوّرين للفروق الدقيقة.

تعيين مفتاح API كمتغيّر بيئي (PowerShell):

# Temporary for session$env:OPENAI_API_KEY = "sk-..."# Permanent (example - user environment)setx OPENAI_API_KEY "sk-..." /M

نصيحة أمان: فضّل تسجيل الدخول التفاعلي أو المفاتيح قصيرة العمر؛ تجنّب إدخال المفاتيح في التحكم بالإصدارات.

3) تهيئة العزل وتكامل PowerShell

يشغّل تطبيق Windows مهام الوكلاء باستخدام صندوق حماية أصلي لتقليل مخاطر التعديل العشوائي على المضيف. راجع صفحة الأمان أو الإعدادات في التطبيق لتبديل صرامة العزل ومراجعة الأدلة المشتركة مع الوكلاء.

إذا كنت تفضّل PowerShell للوصلات الخاصة بالوكلاء، تأكّد من السماح للتطبيق بتشغيل ملفات تعريف PowerShell وأن سياسة التنفيذ لديك تسمح بالبرامج النصية المطلوبة. مثال لضبط سياسة التنفيذ (مشرف):

Set-ExecutionPolicy RemoteSigned -Scope LocalMachine

4) اختياري: تهيئة Codex لاستخدام WSL2 (يُوصى به إذا كانت سلسلة أدواتك من أصل Linux)

إذا كنت تطوّر بسلاسل أدوات Linux (apt، pip، make، خدمات systemd)، فقم بتهيئة Codex لتنفيذ مهام الوكلاء داخل WSL2 بدلًا من Windows الأصلي:

تثبيت WSL2 (إن لم يكن مثبتًا):

# Run in an elevated PowerShellwsl --install# Reboot if requested

اختيار التوزيعة (Ubuntu مُوصى بها):

wsl --install -d Ubuntu

داخل إعدادات تطبيق Codex → Runtime، اختر WSL كواجهة تنفيذ ووجّه Codex إلى توزيعة WSL الافتراضية (مثل Ubuntu). سيقوم التطبيق بعد ذلك بإنشاء عمليات الوكلاء داخل بيئة WSL لديك بحيث تعمل سلاسل أدوات Linux والمسارات بشكل أصلي.

5) التحقق من التثبيت وتشغيل اختبار أولي

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

اختبار CLI (PowerShell):

# Check codex version (if installed)codex --version# Run a quick agent job (pseudo-command; follow CLI docs)codex agent run --task "create python app skeleton with pytest" --project "demo"

إذا لم يكن CLI في PATH، أضف مجلد التثبيت إلى PATH أو استخدم المُشغّل المزوَّد مع المُثبّت.

6) استكشاف مشكلات Windows الشائعة وإصلاحها

• التطبيق لا يبدأ: تحقّق من Windows Event Viewer ومن %LOCALAPPDATA%\Codex\logs.
• العزل يمنع الوكلاء من كتابة الملفات: عدّل إعدادات التطبيق لمشاركة المجلدات أو أضِف مجلد مشروع إلى قائمة المسموح.
• حظر برامج PowerShell النصية: راجع سياسة التنفيذ وفكّ حظر البرامج النصية (Unblock-File path\script.ps1).
• فشل الوكيل في استخدام WSL: تأكّد من تثبيت WSL2 وأن التوزيعة مُهيّأة (أكمل التشغيل الأول). استخدم wsl -l -v للتحقق من الحالة.

H2 — كيفية تشغيل تطبيق/CLI Codex على Linux (خطوة بخطوة)

نهجان عمليان على Linux:1) مدعوم رسميًا: Codex CLI + ملحق IDE (مدعوم بالكامل).
2) واجهة رسومية غير رسمية: مشاريع ربط مجتمعية تشغّل تطبيق macOS المبني بـ Electron على Linux (تجريبية وغير مدعومة).

وقت كتابة هذه السطور، أُعلن عن تطبيق سطح المكتب لـ Linux باعتباره قادمًا قريبًا ويمكن للمستخدمين التسجيل لتلقي إشعارات؛ مع ذلك، يتوفر Codex CLI وتكاملات المطوّر وهي المسار العملي لمستخدمي Linux. بالإضافة إلى ذلك، توجد عمليات إعادة البناء عبر المنصات من المجتمع للمستخدمين المتقدمين.

المسار الرسمي: Codex CLI + VS Code (مستقر، مُوصى به)

أفضل تجربة مدعومة على Linux اليوم هي CLI إلى جانب ملحقات IDE الخاصة بـ Codex (VS Code، Cursor، وغيرها). CLI مدعوم صراحة على Linux.

الخطوة 1 — تحضير النظام (مثال Ubuntu)

# update OSsudo apt update && sudo apt upgrade -y# install build essentials & gitsudo apt install -y build-essential git curl# install Node.js via nvm (recommended)curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.4/install.sh | bash# restart shell or source ~/.bashrc, then:nvm install --lts

الخطوة 2 — تثبيت Codex CLI

# install globally without sudo (using npm + nvm)npm install -g @openai/codex# verifycodex --version

الخطوة 3 — المصادقة

# run the interactive CLI to authenticatecd /path/to/your/repocodex# follow the sign-in prompt: sign in with ChatGPT (OAuth) or paste API key

الخطوة 4 — استخدام codex
أمثلة:

# interactive modecodex# single-shot non-interactivecodex "Write unit tests for utils/crypto.js"# run specific commands# create a sandboxed change and show diffcodex "Add a users table migration" --dry-run

الخطوة 5 — استخدام Git worktrees (مُوصى به)

# from repository rootgit checkout -b maingit worktree add ../codex-sandbox codex-sandbox-branchcd ../codex-sandbox# run Codex here so it operates on an isolated worktreecodex

الأمان والإعداد

• يخزّن CLI الإعدادات في ~/.codex/config.toml (قِيَم افتراضية/تجاوزات) — كن واعيًا بالأذونات. استخدم مخازن الاعتمادات في النظام (Secret Service / Gnome Keyring / pass) أو المتغيّرات البيئية لمفاتيح API بدل الملفات النصية متى أمكن.

المسار غير الرسمي: تشغيل الواجهة الرسومية لسطح المكتب على Linux (تجريبي)

بدأ تطبيق سطح المكتب من OpenAI على macOS وWindows؛ يمكن لمستخدمي Linux حاليًا التسجيل لتلقي إشعارات لإصدار رسمي على Linux. في هذه الأثناء، قامَت مشاريع مجتمعية بعكس هندسة طرق لتشغيل حزمة macOS المبنية بـ Electron على Linux عبر استخراج app.asar، إعادة بناء الوحدات الأصلية، وتشغيل خلفية codex app-server المحلية لربط الواجهة. هذا النهج غير مدعوم وقد يتعطّل مع التحديثات — استخدمه فقط للتجربة وأبدًا على كود إنتاجي أو مستودعات حساسة.

إن أردت المحاولة (نظرة عامة):

1. نزّل ملف .dmg الخاص بـ macOS (من مصدر رسمي تتحكّم به).
2. استخرج app.asar (حزمة Electron).
3. أعد بناء وحدات Node الأصلية لـ Linux (node-pty، better-sqlite3، إلخ).
4. ثبّت Codex CLI وشغّل خلفية codex app-server المحلية لتعمل كواجهة خلفية.
5. أنشئ سكربت التفاف يضبط المتغيّرات البيئية ويُطلق واجهة Electron المفكّكة والمتصلة بالخلفية المحلية.

لا تفعل ذلك على أجهزة حساسة. توجد مستودعات وسكربتات من المجتمع لأتمتة هذه الخطوات، لكنها ليست قنوات دعم رسمية.

أفضل الممارسات: الأمان، الأداء، وسير العمل الجماعي

الأمان — حافظ على سلامة المضيف

• استخدم العزل: عندما يكون ممكنًا، فعّل صندوق الحماية الصارم في التطبيق أو شغّل أعباء الوكلاء داخل حاويات/آلات افتراضية. تضيف نسخة Windows دعم عزل أصلي؛ فضّلها للكود غير الموثوق.
• أقل امتياز لمشاركات الملفات: شارك مجلدات مشاريع محددة فقط مع التطبيق.
• اعتمادات قصيرة العمر: استخدم مفاتيح API قصيرة العمر، رموز قائمة على الأدوار، أو تسجيل دخول تفاعلي. قم بتدوير المفاتيح وراجع استخدامها.
• نظافة المستودع: لا تلتزم أسرارًا أبدًا — استخدم .gitignore وأدوات فحص الأسرار. استخدم المتغيّرات البيئية أو مخازن الأسرار.

الأداء — إدارة تنازع الموارد

• اختنق توازي الوكلاء: لا تُشغّل عشرات البناءات الكاملة بالتوازي على حاسوب محمول متواضع. استخدم إعدادات التوازي أو المُجدول في التطبيق.
• استخدم WSL أو الحاويات للمهام الثقيلة: انقل البناءات والاختبارات الثقيلة إلى WSL أو بيئة محوّاة لتجنّب مطبّات أداء نظام الملفات على Windows.
• قم بقياس الأداء: استخدم مراقبة CPU/RAM (Task Manager، top، htop) أثناء تشغيل الوكلاء لفهم الاختناقات.

توصيات سير العمل للفِرق

• إعدادات مشتركة: احتفظ بوصفات الوكلاء (مطالبات المهام، سلاسل الأدوات، سكربتات الإطلاق) في دليل مشترك codex/ (دون أسرار) حتى تتمكن الفِرق من إعادة إنتاج تشغيلات الوكلاء.
• بوابات CI: استخدم وكلاء Codex لاقتراح تغييرات الكود، لكن اجعل الدمج محكومًا بفحوصات CI — لا تدع وكيلًا يدمج تلقائيًا دون مراجعة بشرية.
• التسجيل والتدقيق: فعّل تسجيلًا تفصيليًا لإجراءات الوكلاء حتى تتمكن من تتبّع ما فعله الوكيل والعودة عنه عند الحاجة.

مصفوفة استكشاف الأخطاء (مرجع سريع)

ملاحظات ختامية

يمثّل تطبيق Codex خطوة ملموسة نحو الأتمتة القائمة على الوكلاء والطويلة الأمد للمطورين. مع إصدار Windows واستمرار التطوير، أصبح لدى المطورين الآن مزيد من الطرق لتشغيل Codex وتنظيمه ودمجه ضمن سير عمل عبر المنصات. إذا كنت تُثبّته لأول مرة، ففضّل المُثبّت الرسمي لـ Windows أو CLI الرسمي على Linux؛ وفضّل العزل وWSL للتماشي مع سلاسل أدوات Linux؛ واتّبع أفضل الممارسات الأمنية والتشغيلية المذكورة أعلاه.

CometAPI هي منصّة تجميع شاملة لواجهات برمجة تطبيقات النماذج الكبيرة، تقدّم تكاملًا وإدارة سلسة لخدمات واجهات API. وهي تدعم استدعاء نماذج ذكاء اصطناعي سائدة مختلفة مثل [Claude Sonnet]/ [Opus 4.6] و [GPT-5.3 Codex]. قبل الوصول، تأكّد من تسجيل الدخول إلى CometAPI والحصول على مفتاح API. يقدّم [CometAPI] سعرًا أقل بكثير من السعر الرسمي لمساعدتك على دمج Codex.

جاهز للبدء؟→ سجّل للبرمجة اليوم!

إذا أردت معرفة المزيد من النصائح والأدلة والأخبار حول الذكاء الاصطناعي فاتبعنا على VK، X و Discord!