كيف تثبّت Codex CLI من OpenAI محليًا؟ دليل مبسّط

أصبح Codex CLI من OpenAI سريعاً أداة لا غنى عنها للمطورين الذين يسعون إلى دمج الذكاء الاصطناعي مباشرة في سير عملهم المحلي. منذ الإعلان عنه في 16 أبريل 2025، والتحديثات اللاحقة—بما في ذلك قدرات الوصول إلى الإنترنت في 3 يونيو 2025—يوفر Codex CLI طريقة آمنة، تركّز على الخصوصية، وقابلة للتخصيص بدرجة عالية للاستفادة من نماذج الاستدلال القوية من OpenAI مباشرة من الطرفية لديك. تجمع هذه المقالة أحدث التطورات وتقدّم دليلاً خطوة بخطوة لتثبيت Codex CLI على جهازك وتهيئته.

ما هو Codex CLI من OpenAI؟

النشأة والإعلان

كشفت OpenAI عن Codex CLI إلى جانب أحدث نماذجها، o3 و o4-mini، موضِّحةً أنه مشروع تجريبي مفتوح المصدر يجلب مساعدات البرمجة المعزّزة بالذكاء الاصطناعي مباشرة إلى الطرفية. أُعلن عنه في 16 أبريل 2025، ويتيح هذا الأداة للوكلاء المعتمدين على الذكاء الاصطناعي قراءة الشيفرة وتعديلها وتنفيذها في بيئتك المحلية، ما يضمن ألّا تغادر الشيفرة الحساسة جهازك مطلقاً.

الميزات الرئيسية لـ Codex CLI

• خفيف ومفتوح المصدر: صُمّم لسهولة التثبيت وتشجيع مساهمات المجتمع، ويعيش المستودع البرمجي لـ Codex CLI على GitHub، ما يشجّع على الإبلاغ عن الأخطاء وتقديم طلبات السحب.
• أوامر باللغة الطبيعية: يمكن للمطورين توجيه Codex باللغة الإنجليزية البسيطة لإنشاء شيفرة أولية، أو إعادة هيكلة الوحدات الحالية، أو حتى كتابة الاختبارات.
• تنفيذ محلي: جميع العمليات تتم على جهازك، ما يلغي المخاوف المتعلقة برفع الشيفرة المملوكة إلى خوادم خارجية.
• وصول الوكيل إلى الإنترنت: اعتباراً من 3 يونيو 2025، يمكن لـ Codex CLI الوصول اختيارياً إلى الإنترنت لمهام مثل تثبيت الاعتمادات أو جلب الموارد الخارجية، مع تحكم دقيق في النطاقات وطرق HTTP.

ما هي آخر التحديثات المعمارية؟

في أوائل يونيو 2025، أعلنت OpenAI عن إعادة كتابة كبيرة لـ Codex CLI من مكدس Node.js وTypeScript الأصلي إلى Rust. يهدف هذا التحوّل إلى تقديم "تثبيت بلا اعتماديات"، وتحسين الأداء، وتعزيز ضمانات الأمان عبر الاستفادة من تصميم Rust الآمن للذاكرة. يمكن للمطورين توقع أوقات بدء تشغيل أسرع، وأحجام ثنائيات أصغر، وفحوصات ترجمة أكثر صرامة، ما يساهم في تجربة مطوّر أكثر سلاسة.

لماذا يجب تثبيت Codex CLI محلياً؟

ما الفوائد الأمنية والخصوصية التي يوفرها التثبيت المحلي؟

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

كيف يعزز التثبيت المحلي الأداء والقدرة على العمل دون اتصال؟

من خلال معالجة الأوامر على عتادك الخاص، يقلل Codex CLI من زمن الاستجابة والاعتماد على استدعاءات واجهات برمجة التطبيقات الخارجية. وبالاقتران مع ميزة وصول الوكيل إلى الإنترنت الجديدة، يمكنك العمل دون اتصال في معظم المهام وتكوين متى يُسمح للوكيل بالاتصال، مما يحقق التوازن المناسب بين الاستقلالية والاتصالية.

كيف تهيئ بيئتك للتثبيت؟

ما المتطلبات المسبقة؟

قبل تثبيت Codex CLI، تأكد من وجود:

• Node.js (v14 أو أحدث) مثبت ومضاف إلى PATH لديك.
• npm (عادة يأتي ضمن Node.js) لإدارة الحزم.
• OpenAI API key صالح، ويمكنك الحصول عليه من لوحة تحكم OpenAI ضمن إعدادات API.

كيف تحصل على مفتاح OpenAI API الخاص بك وتؤمّنه؟

1. سجّل الدخول إلى OpenAI dashboard.
2. انتقل إلى API Keys وانقر Create new secret key.
3. انسخ المفتاح المُولّد وخزّنه في مدير بيانات اعتماد آمن.
4. تجنّب تضمينه في نظام التحكم بالإصدارات؛ استخدم المتغيرات البيئية للتطوير المحلي.

كيف يمكنك تثبيت Codex CLI على أنظمة التشغيل المختلفة؟

كيف يتم التثبيت عبر npm على macOS وLinux؟

افتح الطرفية وشغّل:

npm install -g @openai/codex

يُثبّت هذا الأمر التنفيذية codex بشكل عام، مما يجعلها متاحة من أي دليل.

كيف يتم التثبيت على Windows (PowerShell أو Git Bash)؟

1. افتح PowerShell (كمسؤول) أو Git Bash.
2. نفّذ نفس أمر npm: npm install -g @openai/codex
3. اختيارياً، عيّن Git Bash كصدفتك الافتراضية باستخدام: Set-Alias sh.exe "C:\Program Files\Git\bin\bash.exe" ``` :contentReference{index=10}.

كيف تهيئ وتوثّق Codex CLI؟

كيف تعيّن المتغيرات البيئية؟

بعد التثبيت، قم بضبط مفتاح API عبر تصديره في ملف إعدادات الصدفة:

export OPENAI_API_KEY="your-api-key-here"

أضف هذا السطر إلى ~/.bashrc أو ~/.zshrc أو ~/.profile لجعله دائماً.

كيف تسجّل الدخول مع دمج ChatGPT؟

يدعم Codex CLI تبسيط عملية تسجيل الدخول لمشتركي ChatGPT Plus وPro:

codex --free

يرشدك هذا الأمر خلال توثيق حسابك في OpenAI واسترداد أي أرصدة مؤهلة.

كيف تتحقق من التثبيت؟

كيف تتحقق من الإصدار؟

شغّل:

codex --version

إذ يؤدّي التثبيت الناجح إلى إرجاع سلسلة إصدار (على سبيل المثال، 0.1.0) مؤكداً إمكانية الوصول إلى CLI.

كيف تشغّل أمراً اختبارياً؟

جرّب مطالبة بسيطة للتأكد من أن كل شيء يعمل:

codex "Create a Python function to reverse a string."

ينبغي أن يعرض Codex CLI الشيفرة المقابلة بلغة Python مباشرة في الطرفية، مبرهناً على وظيفته الأساسية.

كيف أحافظ على تحديث CLI؟

باستخدام npm:

npm update -g @openai/codex

باستخدام ثنائية Rust:

1. حمّل آخر إصدار من GitHub.
2. استبدل الثنائية الحالية بالثنائية التي تم تنزيلها حديثاً.

بدلاً من ذلك، إذا قمت بالتثبيت عبر مدير حزم يدعم التحديثات (مثل Homebrew)، يمكنك استخدام أوامر التحديث الخاصة به.

كيف أوسّع وأخصص Codex CLI؟

خيارات الإعداد في codex.yml

حرّر codex.yml لـ:

• استثناء أدلة (مثل node_modules، vendor)
• تعيين قوالب المطالبة الافتراضية
• اختيار نماذج بديلة عند الفشل أو بدائل محلية مفتوحة المصدر (مثل StarCoder للاستخدام دون اتصال).

البرمجة النصية والأتمتة

ضمّن Codex CLI ضمن نصوص البناء أو تدفقات CI:

yaml# .github/workflows/codex.yml

jobs:
  ai_lint:
    runs-on: ubuntu-latest
    steps:
- uses: actions/checkout@v3
- name: Run Codex Auto-Edit
        run: |
          codex --mode auto-edit "Optimize bundle size and tree-shake unused imports"
- name: Run Tests
        run: npm test

هذا يتيح تحسين الشيفرة مدفوعاً بالذكاء الاصطناعي بشكل مستمر جنباً إلى جنب مع أدوات التدقيق القياسية.

ما أفضل الممارسات والنصائح لاستخدام Codex CLI؟

كيف ينبغي إدارة وصول الوكلاء إلى الإنترنت؟

بشكل افتراضي، يكون الوصول إلى الإنترنت معطلاً. لمنح الإذن لمهام محددة، استخدم:

codex --allow-internet

ثم حدّد النطاقات أو طرق HTTP التي تثق بها. هذا يضمن أن Codex لا يتصل إلا عندما تسمح له صراحة، مما يحافظ على الأمان وقابلية التدقيق.

كيف يمكنك المساهمة والإبلاغ عن المشكلات؟

بصفته مشروعاً تجريبياً، فإن ملاحظات المجتمع أمر حيوي. للمساهمة:

1. قم بعمل fork لـالمستودع على GitHub وقدّم طلبات السحب.
2. سجّل مشكلات للأخطاء أو طلبات الميزات مع وصف واضح لخطوات إعادة الإنتاج.
3. تفاعل مع المشرفين في المناقشات للمساعدة في تشكيل الاتجاهات المستقبلية.

---

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

البدء

توفر CometAPI واجهة REST موحّدة تجمع مئات نماذج الذكاء الاصطناعي—عبر نقطة نهاية متسقة، مع إدارة مدمجة لمفاتيح API، وحصص الاستخدام، ولوحات معلومات الفوترة. بدلاً من التعامل مع عناوين URL متعددة للمورّدين وبيانات اعتماد متفرقة.

يمكن للمطورين الوصول إلى واجهة برمجة تطبيقات ChatGPT مثل GPT-4.1 API تلك الموعد النهائي لنشر المقال عبر CometAPI. للبدء، استكشف قدرات النموذج في Playground واطّلع على [API guide] للحصول على إرشادات مفصّلة. قبل الوصول، يُرجى التأكد من تسجيل الدخول إلى CometAPI والحصول على مفتاح API. تقدّم CometAPI سعراً أقل بكثير من السعر الرسمي لمساعدتك على الاندماج.

اطلع أيضاً على Claude Code vs OpenAI Codex: أيهما أفضل