سرعان ما أصبحت واجهة Codex CLI من OpenAI أداةً أساسيةً للمطورين الذين يسعون لدمج الذكاء الاصطناعي مباشرةً في سير عملهم المحلي. منذ الإعلان عنها في 16 أبريل 2025، والتحديثات اللاحقة - بما في ذلك إمكانيات الوصول إلى الإنترنت في 3 يونيو 2025 - توفر واجهة Codex CLI طريقةً آمنةً، تركز على الخصوصية، وقابلةً للتخصيص بدرجة عالية للاستفادة من نماذج التفكير المنطقي القوية من OpenAI مباشرةً من جهازك. تُلخص هذه المقالة أحدث التطورات، وتقدم دليلاً خطوة بخطوة لتثبيت واجهة Codex CLI وتكوينها على جهازك.
ما هو Codex CLI الخاص بـ OpenAI؟
الأصول والإعلان
كشفت OpenAI عن واجهة سطر أوامر Codex إلى جانب أحدث طرازاتها، o3 وo4-mini، واصفةً إياها بمشروع تجريبي مفتوح المصدر يُقدّم مساعدةً برمجيةً مدعومةً بالذكاء الاصطناعي مباشرةً إلى الجهاز. أُعلن عن هذه الأداة في 16 أبريل 2025، وتتيح لوكلاء الذكاء الاصطناعي قراءة وتعديل وتنفيذ الشيفرة البرمجية في بيئتك المحلية، مما يضمن عدم خروج الشيفرة الحساسة من جهازك.
الميزات الرئيسية لـ Codex CLI
- خفيف الوزن ومفتوح المصدر:تم تصميم Codex CLI لتسهيل التثبيت والمساهمات المجتمعية، وهو موجود على GitHub، مما يشجع على الإبلاغ عن الأخطاء وطلبات السحب.
- أوامر اللغة الطبيعية:يمكن للمطورين مطالبة Codex باللغة الإنجليزية البسيطة بإنشاء كود نمطي، أو إعادة تصميم الوحدات النمطية الموجودة، أو حتى كتابة الاختبارات.
- التنفيذ المحلي:تتم جميع العمليات على جهازك، مما يزيل المخاوف بشأن تحميل التعليمات البرمجية الخاصة إلى خوادم خارجية.
- وكيل الوصول إلى الإنترنت:اعتبارًا من 3 يونيو 2025، يمكن لـ Codex CLI الوصول بشكل اختياري إلى الإنترنت لأداء مهام مثل تثبيت التبعيات أو جلب الموارد الخارجية، مع عناصر تحكم دقيقة في النطاق والطريقة.
ما هي آخر التحديثات المعمارية؟
في أوائل يونيو 2025، أعلنت OpenAI عن إعادة صياغة شاملة لواجهة سطر أوامر Codex من حزمة Node.js وTypeScript الأصلية إلى Rust. يهدف هذا التحول إلى توفير تثبيت بدون اعتمادية، وأداء مُحسّن، وضمانات أمان مُعززة بالاستفادة من تصميم Rust الآمن للذاكرة. يمكن للمطورين توقع أوقات بدء تشغيل أسرع، وأحجام ملفات ثنائية أقل، وفحوصات تجميع أكثر دقة، مما يُسهم في تجربة مطور أكثر سلاسة.
لماذا يجب عليك تثبيت Codex CLI محليًا؟
ما هي فوائد الأمان والخصوصية التي يوفرها التثبيت المحلي؟
تشغيل نماذج الذكاء الاصطناعي محليًا يعني بقاء شيفرتك المصدرية في الموقع. بخلاف الحلول السحابية فقط، لا تشارك Codex CLI ملفاتك إلا بطلب صريح، مما يقلل بشكل كبير من المخاطر المتعلقة بتسريب البيانات أو الوصول غير المصرح به.
كيف يعمل التثبيت المحلي على تعزيز الأداء والقدرة على العمل دون اتصال بالإنترنت؟
من خلال معالجة الأوامر على أجهزتك الخاصة، يُقلل Codex CLI من زمن الوصول والاعتماد على استدعاءات واجهة برمجة التطبيقات الخارجية. ومع ميزة وكيل الوصول إلى الإنترنت الجديدة، يمكنك العمل دون اتصال بالإنترنت لمعظم المهام وضبط وقت السماح للوكيل بالاتصال بالإنترنت، مما يُحقق التوازن الأمثل بين الاستقلالية والاتصال.
كيفية تحضير البيئة الخاصة بك للتثبيت؟
ما هي المتطلبات الأساسية؟
قبل تثبيت Codex CLI، تأكد من أن لديك:
- Node.js (الإصدار 14 أو الأحدث) تم تثبيته وإضافته إلى
PATH. - الآلية الوقائية الوطنية (عادةً ما يتم تجميعها مع Node.js) لإدارة الحزم.
- A مفتاح API OpenAI صالح، والتي يمكنك الحصول عليها من لوحة معلومات OpenAI ضمن إعدادات واجهة برمجة التطبيقات.
كيف تحصل على مفتاح API الخاص بـ OpenAI وتؤمنه؟
- تسجيل الدخول إلى لوحة معلومات OpenAI.
- انتقل إلى مفاتيح API ثم انقر إنشاء مفتاح سري جديد.
- انسخ المفتاح الناتج وقم بتخزينه في مدير بيانات اعتماد آمن.
- تجنب الالتزام بالتحكم في الإصدار؛ استخدم متغيرات البيئة للتطوير المحلي.
كيف يمكنك تثبيت Codex CLI على أنظمة التشغيل المختلفة؟
كيف تقوم بالتثبيت عبر npm على macOS و Linux؟
افتح المحطة الطرفية الخاصة بك وقم بتشغيل:
npm install -g @openai/codex
يقوم هذا الأمر بتثبيت codex قابلة للتنفيذ عالميًا، مما يجعلها متاحة من أي دليل.
كيف تقوم بالتثبيت على Windows (PowerShell أو Git Bash)؟
- ساعات العمل بوويرشيل (كمسؤول) أو جيت باش.
- قم بتنفيذ نفس الأمر npm:
npm install -g @openai/codex - اختياريًا، قم بإعداد Git Bash كغلاف افتراضي لديك باستخدام:
Set-Alias sh.exe "C:\Program Files\Git\bin\bash.exe" ``` :contentReference{index=10}.
كيف تقوم بتكوين ومصادقة Codex CLI؟
كيف تقوم بتعيين متغيرات البيئة؟
بعد التثبيت، قم بتكوين مفتاح API الخاص بك عن طريق تصديره في ملف تعريف shell الخاص بك:
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 update -g @openai/codex
مع الثنائي Rust:
- قم بتنزيل الإصدار الأحدث من GitHub.
- استبدل الملف الثنائي الحالي لديك بالإصدار الذي تم تنزيله حديثًا.
بدلاً من ذلك، إذا قمت بالتثبيت عبر مدير الحزم الذي يدعم التحديثات (على سبيل المثال، 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 فقط عند السماح بذلك صراحةً، مما يحافظ على الأمان وقابلية التدقيق.
كيف يمكنك المساهمة والإبلاغ عن المشكلات؟
كمشروع تجريبي، تُعدّ آراء المجتمع أمرًا بالغ الأهمية. للمساهمة:
- شوكة مستودع جيثب وإرسال طلبات السحب.
- قم بملف المشكلات الخاصة بالأخطاء أو طلبات الميزات، مع وصف الخطوات اللازمة لإعادة إنتاجها بشكل واضح.
- المشاركة مع المشرفين في المناقشات للمساعدة في تشكيل الاتجاهات المستقبلية.
باتباع الخطوات الموضحة أعلاه، يمكنك دمج واجهة Codex CLI من OpenAI بسلاسة في سير عمل التطوير المحلي لديك، مستفيدًا من أحدث تطورات الذكاء الاصطناعي مع الحفاظ على تحكم كامل في الكود والبيئة. مع تطور المشروع، تابع سجل التغييرات الرسمي ومنتديات المجتمع للاطلاع على التحديثات، ولا تتردد في مشاركة تجاربك وتحسيناتك مع مجتمع المطورين الأوسع.
كيف تبدأ
يوفر CometAPI واجهة REST موحدة تجمع مئات نماذج الذكاء الاصطناعي ضمن نقطة نهاية موحدة، مع إدارة مدمجة لمفاتيح واجهة برمجة التطبيقات، وحصص الاستخدام، ولوحات معلومات الفواتير. بدلاً من إدارة عناوين URL وبيانات اعتماد متعددة للموردين.
يمكن للمطورين الوصول إلى واجهة برمجة تطبيقات chatGPT كما يلي واجهة برمجة تطبيقات GPT-4.1 هؤلاء الموعد النهائي لنشر المقالمن خلال كوميت ايه بي اي. للبدء، استكشف قدرات النموذج في ملعب واستشر دليل واجهة برمجة التطبيقات للحصول على تعليمات مفصلة. قبل الدخول، يُرجى التأكد من تسجيل الدخول إلى CometAPI والحصول على مفتاح API. كوميت ايه بي اي عرض سعر أقل بكثير من السعر الرسمي لمساعدتك على التكامل.
