أوامر Codex CLI: الأوامر التي تحتاج إليها مع أمثلة

لأوامر Codex CLI ثلاثة أنواع: أوامر فرعية مثل codex exec، وخيارات (flags) مثل --model، وأوامر الشرطة المائلة (slash commands) مثل /review التي تكتبها داخل الجلسة. ويشرح هذا الدليل أكثرها استخدامًا، بعد مراجعتها على الإصدار 0.166.0 من Codex CLI، مع أمثلة تنسخها وتشغّلها بمفتاح من 5abeer.

ما أوامر Codex CLI التي تحتاج إليها أولًا؟#

يتلخّص معظم العمل في Codex في ثمانية أوامر. أضف --help إلى أي منها لترى خياراته كلها:

codex                                   # open the interactive terminal UI
codex "explain this repository"         # open it with a first prompt
codex exec "run the tests and fix any failure"   # run one task without the UI
codex resume --last                     # reopen the latest session in this folder
codex review --uncommitted              # review the changes you haven't committed
codex mcp list                          # list the MCP servers you added
codex doctor                            # check the install, config and sign-in
codex update                            # update Codex to the latest release

أصدرت OpenAI الإصدار 0.166.0 في 29 أكتوبر 2026، وكان لا يزال أحدث إصدار مستقر حين راجعناه في 2 نوفمبر 2026. والخيارات تتغيّر بين إصدار وآخر، فإذا لم يطابق خيار مما يلي نسختك، فاعتمد على ما يعرضه codex <command> --help.

ماذا يفعل كل أمر من أوامر Codex؟#

شغّل Codex#

• `codex`: يفتح واجهة الطرفية التفاعلية، ويمكنك أن تضيف بعده موجّهًا أول بين علامتي تنصيص.
• `codex exec`، أو `codex e`: ينفّذ مهمة واحدة دون الواجهة ثم يخرج، وهذا يناسب السكربتات وCI. واكتب - ليقرأ الموجّه من الإدخال القياسي.
• `codex review`: يراجع دون الواجهة تغييراتك غير المودَعة بالخيار --uncommitted، أو الفرق عن فرع بالخيار --base، أو إيداعًا واحدًا بالخيار --commit، أو يتبع تعليمات مراجعة تكتبها في صورة موجّه.

استأنف عملًا سابقًا#

• `codex resume`: يعيد فتح جلسة محفوظة بمعرّفها أو اسمها. ويختار --last أحدث جلسة في هذا المجلد، ويبحث --all في كل المجلدات.
• `codex fork`: ينسخ جلسة سابقة إلى محادثة جديدة، ويُبقي الأصلية كما هي.
• `codex exec resume`: يتابع جلسة بدأها codex exec، مع موجّه جديد إن أردت.
• `codex archive` و`codex unarchive` و`codex delete`: تؤرشف جلسة محفوظة، أو تستعيدها من الأرشيف، أو تحذفها نهائيًا.

اربط الأدوات#

• `codex mcp`: يدير خوادم MCP المحفوظة في ~/.codex/config.toml بالأوامر add وlist وget وremove، أما login وlogout فللخوادم التي تستخدم OAuth.
• `codex plugin`: يثبّت إضافات Codex ويديرها.
• `codex features`: يعرض مفاتيح الميزات (feature flags)، ويفعّلها أو يعطّلها في config.toml.

تسجيل الدخول والصيانة#

• `codex login` و`codex logout`: لتسجيل الدخول بحساب ChatGPT أو بمفتاح من OpenAI، أو للخروج. ولا يحتاج مفتاح 5abeer إلى أي منهما.
• `codex doctor`: يفحص التثبيت والإعدادات وتسجيل الدخول وبيئة التشغيل. أضف --json لتحصل على تقرير يستطيع سكربت أن يقرأه.
• `codex update`: يحدّث Codex إذا كان الإصدار المثبّت يدعم التحديث الذاتي. وإلا فثبّته من جديد كما في صفحة الإعداد.
• `codex cloud` و`codex apply`: يشغّلان مهام Codex السحابية، التي تصفها OpenAI بأنها تجريبية، ويطبّقان تغييراتها على نسختك المحلية. ويحتاج Codex السحابي إلى تسجيل الدخول بحساب ChatGPT، فلا يعمل أي منهما بمفتاح API وحده؛ راجع تشغيل Codex CLI بمفتاح API.

ما الخيارات التي تغيّر طريقة عمل Codex؟#

هذه هي الخيارات العامة التي ستستخدمها أكثر من غيرها:

• `--model`، `-m`: النموذج الذي يعمل به هذا التشغيل. استخدم أي معرّف من جدول نماذج GPT في الأسفل.
• `--sandbox`، `-s`: ما تستطيع الأوامر التي يشغّلها Codex أن تصل إليه: read-only أو workspace-write أو danger-full-access.
• `--ask-for-approval`، `-a`: متى يتوقف Codex ليطلب موافقتك: on-request أو never.
• `--cd`، `-C`: المجلد الذي يعامله Codex على أنه المشروع.
• `--add-dir`: مجلد إضافي يُسمح لـ Codex بالكتابة فيه.
• `--config`، `-c`: يغيّر مفتاحًا واحدًا من config.toml لهذا التشغيل فقط، بالصيغة key=value.
• `--profile`، `-p`: يطبّق ~/.codex/profile-name.config.toml فوق إعداداتك الرئيسية.
• `--search`: ينقل البحث في الويب من الفهرس المخزَّن، وهو الافتراضي، إلى البحث المباشر.
• `--worktree`: يبدأ في شجرة عمل Git جديدة يديرها Codex، بعيدًا عن نسختك الحالية من المستودع.

أما --dangerously-bypass-approvals-and-sandbox، أو --yolo، فيلغي العزل وطلبات الموافقة معًا. فلا تستخدمه إلا في حاوية أو جهاز افتراضي تستطيع أن تتخلّص منه.

ويقبل codex exec الخيارات -m و-s و-C و-c و-p أيضًا، إلى جانب خيارات خاصة به:

• `--json`: يطبع الأحداث بصيغة JSON، حدثًا في كل سطر.
• `-o`، `--output-last-message`: يكتب الرسالة الأخيرة في ملف.
• `--output-schema`: ملف JSON Schema يجب أن تلتزم به الإجابة النهائية.
• `--ephemeral`: يعمل دون أن يحفظ ملفات الجلسة.
• `--skip-git-repo-check`: يسمح له بالعمل خارج مستودع Git.

ما أوامر الشرطة المائلة التي تعمل داخل الجلسة؟#

اكتب / في واجهة الطرفية لتظهر القائمة. وهذه هي الأوامر التي ستلجأ إليها أكثر من غيرها:

• `/model`: تختار به النموذج ومستوى التفكير.
• `/permissions`: تحدّد به ما يفعله Codex دون أن يسألك، مثل الإعداد Auto أو Read Only.
• `/status`: يعرض إعدادات الجلسة واستهلاك التوكنات.
• `/review`: يراجع التغييرات في شجرة العمل، ويركّز على تغيّر السلوك والاختبارات الناقصة.
• `/diff`: يعرض فروق Git، بما فيها الملفات غير المتتبَّعة.
• `/plan`: ينقلك إلى وضع التخطيط (Plan mode)، فيقترح Codex خطة قبل أن يغيّر الكود.
• `/init`: يكتب ملف AGENTS.md فيه تعليمات لـ Codex.
• `/compact`: يلخّص المحادثة حتى لا تبلغ حد السياق.
• `/new` و`/resume` و`/fork`: تبدأ محادثة جديدة، أو تستأنف محادثة محفوظة، أو تتفرّع من المحادثة الحالية.
• `/side`، أو `/btw`: يفتح محادثة جانبية في فرع مؤقت، بعيدًا عن المحادثة الرئيسية.
• `/mcp`: يعرض أدوات MCP. والأمر /mcp login متبوعًا باسم خادم يسجّل الدخول إليه.
• `/import`: يستورد إعداداتك والمشروع الحالي وأحدث محادثاتك من Claude Code.
• `/quit` أو `/exit`: يخرج من Codex.

أي الأوامر تستهلك التوكنات مع المفتاح؟#

مع المفتاح تدفع ثمن كل توكن، فمن المفيد أن تعرف أي الأوامر تستدعي النموذج:

ويستخدم /review نموذج الجلسة ما لم تضبط review_model في config.toml. ثم إن كل دورة تعيد إرسال المحادثة كلها حتى تلك اللحظة، مع الملفات ومخرجات الأوامر التي قرأها Codex، فتكلّف الدورة في الجلسة الطويلة أكثر. ويعرض /status المجموع أولًا بأول، ويبدأ /new محادثة نظيفة حين تنتهي من مهمة.

وللسكربتات التي تشغّل codex exec مع كل إيداع، استخدم مفتاحًا له حد إنفاق خاص به، كما في تحكّم في كل مفتاح. وتجد مثالًا محسوبًا لتكلفة شهر في تشغيل Codex CLI بمفتاح API.

كيف تضبط الإعدادات الافتراضية في config.toml؟#

يقرأ Codex ملف ~/.codex/config.toml كلما بدأ. ويستطيع المشروع أن يضيف ملف .codex/config.toml خاصًا به، ولا يحمّله Codex إلا إذا وثقت بالمشروع. وهذه المفاتيح تضبط القيم الافتراضية التي تتجاوزها الخيارات السابقة:

model_reasoning_effort = "high"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
web_search = "cached"

• `model_reasoning_effort`: مقدار التفكير الذي يبذله النموذج، مثل medium أو high. والمستويات المتاحة تختلف من نموذج إلى آخر.
• `approval_policy`: القيمة الافتراضية للخيار -a.
• `sandbox_mode`: القيمة الافتراضية للخيار -s.
• `web_search`: إحدى القيم disabled أو cached أو indexed أو live، والقيمة الافتراضية cached.

ضع هذه السطور فوق أول عنوان بين قوسين مربعين. ففي TOML يتبع أي مفتاح يُكتب تحت [model_providers.khabeer] تلك الكتلة، لا إعداداتك العامة.

كيف تشغّل هذه الأوامر بمفتاح من 5abeer؟#

مع مفتاح من 5abeer يتغيّر المزوّد في config.toml فقط. فلا تحتاج إلى codex login، ويبقى codex cloud وcodex apply بحاجة إلى تسجيل الدخول بحساب ChatGPT. اشحن رصيدك بإحدى طرق الدفع، وأنشئ مفتاحًا لمزوّد OpenAI كما في أنشئ مفتاحًا، واحفظه في متغير البيئة KHABEER_API_KEY. ثم ضع السطرين model وmodel_provider فوق أول عنوان بين قوسين مربعين، وكتلة المزوّد في آخر ملف ~/.codex/config.toml:

model = "gpt-6.1-sol"
model_provider = "khabeer"

[model_providers.khabeer]
name = "5abeer"
base_url = "https://api.5abeer.ai/v1"
env_key = "KHABEER_API_KEY"
wire_api = "responses"

شغّل codex exec "summarize this repository" داخل مجلد مشروع. إذا وصلك الرد، فالمفتاح وعنوان الأساس يعملان. والإعداد الكامل، مع الملفات الشخصية (profiles) التي تُبقي تسجيل الدخول بحساب ChatGPT، في تشغيل Codex CLI بمفتاح API.

وهذه أحدث نماذج GPT، بسعرنا لكل مليون توكن. استخدم أيًّا من هذه المعرّفات مع -m أو في السطر model:

وكل النماذج التي تعمل في Codex مذكورة في صفحة إعداد Codex CLI، وتعرض صفحة OpenAI API سعرنا بجانب السعر الرسمي.

كيف تبدو الأمثلة العملية؟#

شغّل كل مثال من مجلد مشروعك:

codex exec -s read-only "where is the login flow handled?"

codex exec -s workspace-write "run the tests and fix the first failure"

codex exec -o summary.md "list the TODO comments in src/"

codex review --uncommitted
codex review --base main

codex resume --last

codex mcp add docs --url https://mcp.example.com/mcp --bearer-token-env-var DOCS_MCP_TOKEN
codex mcp add files -- npx -y @modelcontextprotocol/server-filesystem .

codex -c 'model_reasoning_effort="high"' "plan the database migration"

وفي CI، أعطِ المشغّل ملف config.toml نفسه، واضبط KHABEER_API_KEY من سر، كما في Claude Code مع GitHub Actions.

الأخطاء الشائعة وحلولها#

• يقول Codex إن المفتاح غير موجود: المتغير KHABEER_API_KEY غير مضبوط في الطرفية أو في مهمة CI التي تشغّله.
• يرفض `codex exec` العمل خارج مستودع Git: أضف --skip-git-repo-check.
• أوقف حد الإنفاق سكربتًا: يعيد المفتاح API_KEY_QUOTA_EXHAUSTED حتى ترفع حده.
• أي مشكلة أخرى في الإعداد: شغّل codex doctor. وباقي رموز أخطائنا في الأخطاء وحلولها.

أسئلة شائعة#

أي إصدار من Codex يغطيه هذا الدليل؟#

الإصدار 0.166.0 من Codex CLI، الذي صدر في 29 أكتوبر 2026. شغّل codex --version لتعرف إصدارك، وcodex update لتنتقل إلى أحدث إصدار.

ما الفرق بين codex وcodex exec؟#

يفتح codex واجهة الطرفية التفاعلية التي تعمل فيها أوامر الشرطة المائلة. أما codex exec فينفّذ مهمة واحدة دونها ثم يخرج.

لماذا لا يعمل الأمر /approvals؟#

لا يوجد أمر /approvals في الإصدار 0.166.0 من Codex، وإن كانت أدلة قديمة لا تزال تذكره. استخدم /permissions داخل الجلسة، أو اضبط -a و-s حين تشغّل Codex.

هل تعمل هذه الأوامر في ChatGPT؟#

لا تعمل في نسخة الويب، إذ تنبّه OpenAI إلى أنها لا تنطبق على ChatGPT في الويب. ولتطبيق ChatGPT لسطح المكتب قائمة أوامر شرطة مائلة خاصة به.

هل أستطيع استخدام هذه الأوامر مع باقة من 5abeer بدل المفتاح؟#

نعم للأوامر المحلية، إذا كانت باقتك تشمل Codex، وهو مشمول في باقات Bundle وباقة GPT. فتطبيق 5abeer AI يجهّز Codex على باقتك دون مفتاح؛ راجع ما الذي تشغّله كل باقة. الباقات مخصّصة للتطبيقات المدعومة؛ ولكودك الخاص أنشئ مفتاح API.

المصادر#

راجعناها في 2026-11-02:

• وثائق OpenAI: Developer commands, Codex CLI
• وثائق OpenAI: Configuration reference
• وثائق OpenAI: Model Context Protocol
• وثائق OpenAI: Authentication
• وثائق OpenAI: Slash commands في تطبيق ChatGPT لسطح المكتب
• GitHub: openai/codex release rust-v0.166.0
• GitHub: openai/codex, slash_command.rs at rust-v0.166.0

ابدأ#

إذا كانت باقتك تشمل Codex، فتطبيق 5abeer AI يجهّزه دون مفتاح. ومع مفتاح، أضف كتلة المزوّد السابقة وشغّل codex exec.