OpenAI Codex CLI هو وكيل برمجة أصلي للطرفية من OpenAI يفحص قواعد الشيفرة، ويحرر الملفات، ويشغل الاختبارات، ويتكامل مع مهام Codex Cloud البعيدة، ويتصل بالأدوات الخارجية عبر بروتوكول MCP مباشرة من سطر الأوامر.
تغطي ورقة الغش هذه الأوامر الفرعية وخيارات Codex CLI، وسياسات Sandbox والموافقة، والأوامر المائلة التفاعلية في TUI، واختصارات لوحة المفاتيح، وإعدادات config.toml وAGENTS.md.
🔗 أوراق غش ذات صلة: مقارنة أدوات وكلاء البرمجة في الطرفية · ورقة غش Claude Code CLI · ورقة غش Antigravity CLI (agy) · ورقة غش هندسة AI Agent Harness
1. التثبيت والمصادقة وأوامر CLI الأساسية
1.1 التثبيت والمصادقة
| الإجراء | الأمر | ملاحظات |
|---|---|---|
| التثبيت الشامل عبر npm | npm install -g @openai/codex |
التثبيت القياسي عبر جميع المنصات |
| سكربت التثبيت الرسمي | curl -fsSL https://chatgpt.com/codex/install.sh | sh |
مثبت من سطر واحد لأنظمة macOS / Linux |
| تسجيل الدخول عبر المتصفح | codex login |
المصادقة بحساب ChatGPT Plus / Pro / Team |
| المصادقة بمفتاح API | export OPENAI_API_KEY="sk-..." |
مثالي لبيئات CI أو الحاويات بدون واجهة |
1.2 الأوامر الفرعية والخيارات العامة في CLI
| الأمر / الخيار | الوصف | مثال استخدام |
|---|---|---|
codex |
تشغيل واجهة TUI التفاعلية في المجلد الحالي | codex |
codex "prompt" |
بدء جلسة تفاعلية مع مطالبة ابتدائية | codex "Debug 500 timeout errors on login" |
codex exec / codex e |
تنفيذ غير تفاعلي (headless) للسكربتات وبيئات CI | codex exec "Run all unit tests and fix failures" |
codex exec --json |
بث سجلات JSON منظمة للاستدلال وتعديلات الملفات | codex exec --json "Refactor utils" > run.jsonl |
codex review |
مراجعة شيفرة غير تفاعلية لفروقات Git الحالية | codex review |
codex resume |
فتح منتقي الجلسات (محفوظة في ~/.codex/sessions/) |
codex resume / codex resume --last / codex resume <id> |
codex apply / codex a |
تطبيق الفروقات الناتجة عن مهام Codex Cloud على مساحة العمل المحلية | codex apply <task_id> |
codex cloud |
فحص أو إدارة مهام Codex Cloud البعيدة | codex cloud |
codex mcp |
إدارة تكاملات خوادم بروتوكول سياق النموذج (MCP) | codex mcp list / codex mcp add <name> ... |
-m, --model <name> |
تحديد النموذج الأساسي للجلسة أو التشغيل | codex -m gpt-6.1-sol |
--strict-config |
التحقق الصارم من صياغة ومفاتيح config.toml |
codex --strict-config |
2. مصفوفة سياسات Sandbox والموافقة
يفصل Codex CLI الأذونات إلى طبقتين مستقلتين: ما يمكن للبيئة الوصول إليه (--sandbox) ومتى يُطلب إذن المستخدم (--ask-for-approval).
| الخيار | القيم الصالحة | السلوك والاستخدام الموصى به |
|---|---|---|
--sandbox <mode>(الاختصار -s) |
read-only |
للقراءة فقط: فحص الشيفرة والبحث فيها دون تعديل الملفات |
workspace-write |
الكتابة في مساحة العمل (الافتراضي الموصى به): السماح بالتعديلات داخل شجرة العمل فقط | |
danger-full-access |
وصول غير مقيد: وصول كامل لنظام الملفات والنظام (للحاويات المعزولة فقط) | |
--ask-for-approval <policy> |
on-request |
الافتراضي الموصى به: يطلب النموذج التأكيد عند الحاجة لإجراءات حساسة |
on-failure |
التصعيد عند الفشل فقط (استخدم on-request إذا كانت تنبيهات رفع الصلاحيات مهمة) |
|
never |
صامت تمامًا: عدم طلب تأكيد تفاعلي أبدًا (لخطوط CI والأتمتة) |
⚠️ تنبيه الخيارات المهملة والمتوقفة:
- أصبح الخيار
--full-autoمهملًا (deprecated) اعتبارًا من الإصدارv0.128.0. حدد سياسات Sandbox والموافقة صراحةً:codex --sandbox workspace-write --ask-for-approval on-request "Fix failing tests"- تم إيقاف سياسة الموافقة
untrustedنهائيًا في الإصدارv0.149.0؛ انقل إعداداتك إلىon-request.
3. الأوامر المائلة التفاعلية في TUI
اكتب / داخل موجه codex التفاعلي للتحكم في السياق والأذونات وسير العمل:
3.1 السياق والنماذج والأذونات
| الأمر | الوظيفة | ملاحظات واستخدام |
|---|---|---|
/init |
توليد ملف AGENTS.md مبدئي مخصص للمستودع |
الخطوة الأولى الموصى بها في أي مشروع جديد |
/status |
فحص النموذج النشط والأذونات واستهلاك الرموز | مراقبة السعة المتبقية في نافذة السياق |
/model |
تبديل النموذج ومستوى جهد الاستدلال تفاعليًا | ضبط عمق الاستدلال دون إعادة تشغيل |
/permissions |
تعديل وضع Sandbox وسياسة الموافقة أثناء الجلسة | تشديد أو تخفيف الأذونات عند الحاجة |
/mcp |
فحص وإدارة خوادم MCP المتصلة | التحقق من اتصال الأدوات الخارجية وقواعد البيانات |
3.2 سير العمل الهندسي والتحكم في الجلسة
| الأمر | الوظيفة | ملاحظات واستخدام |
|---|---|---|
/plan |
صياغة خطة تنفيذ ومراجعتها قبل تعديل الملفات | التوافق على البنية قبل عمليات إعادة الهيكلة الكبيرة |
/review |
إجراء مراجعة شاملة للتغييرات غير المودعة | اكتشاف الأخطاء والحالات الحدية والمخاطر الأمنية |
/diff |
فحص التعديلات الحالية غير المودعة على الملفات | مراجعة الفروقات سطرًا بسطر قبل الاعتماد |
/fork |
تفريع مسار المحادثة إلى نقطة حفظ مستقلة | تجربة نهج بديل دون تلويث السياق الرئيسي |
/compact |
تلخيص سجل المحادثة لاستعادة مساحة في السياق | منع التشتت في الجلسات الطويلة متعددة الجولات |
/copy |
نسخ آخر رد مكتمل إلى الحافظة | استخراج الرقع أو الملخصات بسرعة |
/title |
إعادة تسمية مسار المحادثة الحالي | يسهل العثور على الجلسات عبر codex resume |
/statusline / /theme |
تخصيص عناصر شريط الحالة أو سمة ألوان TUI | تكييف مظهر الطرفية |
/prompts:<name> |
استدعاء قالب مطالبة Markdown مخصص | ينفذ الملف ~/.codex/prompts/<name>.md |
4. اختصارات الطرفية وصياغة الإدخال
| الاختصار / الصياغة | الإجراء | التأثير والسيناريو |
|---|---|---|
@<path> |
مرجع ملف بالبحث التقريبي | حقن محتوى ملف داخل السياق (مثل @src/auth.ts) |
!<command> |
أمر صدفة محلي مضمن | تنفيذ أوامر Shell ضمن قواعد Sandbox النشطة (مثل !npm test) |
Tab |
جدولة المطالبة التالية | وضع مطالبة لاحقة أو أمر مائل أو أمر ! في الطابور أثناء عمل Codex |
Enter |
مقاطعة / توجيه أثناء التنفيذ | إدخال توجيهات إضافية بينما يستجيب الوكيل فعليًا |
Ctrl + G |
فتح المحرر الخارجي | كتابة مطالبات متعددة الأسطر في $VISUAL / $EDITOR (Vim، VS Code، إلخ) |
Ctrl + R |
البحث في سجل المطالبات | بحث عكسي في المطالبات المرسلة سابقًا |
Ctrl + L |
مسح وإعادة رسم الشاشة | تنظيف الطرفية مع الحفاظ على حالة المحادثة |
Ctrl + O |
نسخ أحدث مخرجات | مكافئ للأمر /copy |
Ctrl + X |
فتح قائمة الاختصارات | الوصول إلى إعدادات لوحة المفاتيح والإضافات |
Ctrl + C |
إلغاء / خروج | إيقاف المهمة النشطة أو إنهاء جلسة Codex |
5. ملفات الإعداد والتسلسل الهرمي للذاكرة (config.toml وAGENTS.md)
تتجاوز إعدادات مستوى المشروع الإعدادات الافتراضية الشاملة للمستخدم:
| الطبقة | النطاق الشامل (كل المستودعات) | نطاق المشروع (المستودع الحالي) | الغرض |
|---|---|---|---|
| الإعداد الأساسي | ~/.codex/config.toml |
.codex/config.toml |
النموذج الافتراضي، Sandbox، سياسة الموافقة، الشبكة، MCP |
| تعليمات الوكيل | ~/.codex/AGENTS.md |
./AGENTS.md (جذر المستودع) |
أوامر البناء والاختبار، معايير الترميز، قواعد البنية |
| مطالبات مخصصة | ~/.codex/prompts/*.md |
— | قوالب أوامر مائلة قابلة لإعادة الاستخدام /prompts:<name> |
| سجلات الجلسات | ~/.codex/sessions/ |
— | سجلات دائمة يستعيدها codex resume |
الحد الأدنى الموصى به لملف ~/.codex/config.toml
# النموذج الافتراضي
model = "gpt-6.1-sol"
# وضع Sandbox وسياسة الموافقة الافتراضيان
sandbox_mode = "workspace-write"
approval_policy = "on-request"
# تقييد الوصول الشبكي الصادر داخل Sandbox افتراضيًا
network_access = false