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

> أوامر Codex CLI وخياراته وأوامر الشرطة المائلة التي ستستخدمها، بعد مراجعتها على الإصدار 0.166.0، وأيها يستهلك التوكنات مع مفتاح من 5abeer.

آخر تحديث: 2026-11-02

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

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

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

```bash
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 إذا كان الإصدار المثبّت يدعم التحديث الذاتي. وإلا فثبّته من جديد كما في [صفحة الإعداد](https://5abeer.ai/ar/docs/apps/codex.md#install).
- **`codex cloud` و`codex apply`:** يشغّلان مهام Codex السحابية، التي تصفها OpenAI بأنها تجريبية، ويطبّقان تغييراتها على نسختك المحلية. ويحتاج Codex السحابي إلى تسجيل الدخول بحساب ChatGPT، فلا يعمل أي منهما بمفتاح API وحده؛ راجع [تشغيل Codex CLI بمفتاح API](https://5abeer.ai/ar/guides/codex-cli-api-key#plan-or-key).

## ما الخيارات التي تغيّر طريقة عمل 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.

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

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

| تستدعي النموذج | لا تستدعي النموذج |
| --- | --- |
| رسائلك، و`codex` مع موجّه، و`codex exec` | `/status` و`/diff` و`/model` و`/permissions` |
| `codex review` و`/review` | `codex mcp list` و`codex features list` |
| `/init`، إذ يطلب من النموذج أن يكتب `AGENTS.md` | `--help` مع أي أمر |
| `/compact`، إذ يطلب من النموذج أن يلخّص المحادثة |  |

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

وللسكربتات التي تشغّل `codex exec` مع كل إيداع، استخدم مفتاحًا له حد إنفاق خاص به، كما في [تحكّم في كل مفتاح](https://5abeer.ai/ar/docs/start/keys.md#controls). وتجد مثالًا محسوبًا لتكلفة شهر في [تشغيل Codex CLI بمفتاح API](https://5abeer.ai/ar/guides/codex-cli-api-key#cost).

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

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

```toml
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. اشحن رصيدك بإحدى [طرق الدفع](https://5abeer.ai/ar/docs/start/payment.md)، وأنشئ مفتاحًا لمزوّد OpenAI كما في [أنشئ مفتاحًا](https://5abeer.ai/ar/docs/start/keys.md#create)، واحفظه في متغير البيئة `KHABEER_API_KEY`. ثم ضع السطرين `model` و`model_provider` فوق أول عنوان بين قوسين مربعين، وكتلة المزوّد في آخر ملف `~/.codex/config.toml`:

`~/.codex/config.toml`

```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](https://5abeer.ai/ar/guides/codex-cli-api-key#switch).

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

| النموذج | المعرّف | الإدخال (سعرنا) | الإخراج (سعرنا) | السياق |
| --- | --- | --- | --- | --- |
| GPT-6.1 Sol | `gpt-6.1-sol` | 0.60 US$ | 3 US$ | 922K |
| GPT-6 Astra | `gpt-6-astra` | 3 US$ | 15 US$ | — |
| GPT-6 Sol | `gpt-6-sol` | 0.60 US$ | 3 US$ | 922K |

وكل النماذج التي تعمل في Codex مذكورة في [صفحة إعداد Codex CLI](https://5abeer.ai/ar/docs/apps/codex.md#models)، وتعرض [صفحة OpenAI API](https://5abeer.ai/ar/api/openai) سعرنا بجانب السعر الرسمي.

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

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

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

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

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

```bash
codex review --uncommitted
codex review --base main
```

```bash
codex resume --last
```

```bash
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 .
```

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

وفي CI، أعطِ المشغّل ملف `config.toml` نفسه، واضبط `KHABEER_API_KEY` من سر، كما في [Claude Code مع GitHub Actions](https://5abeer.ai/ar/guides/claude-code-github-actions#secrets).

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

- **يقول Codex إن المفتاح غير موجود:** المتغير `KHABEER_API_KEY` غير مضبوط في الطرفية أو في مهمة CI التي تشغّله.
- **يرفض `codex exec` العمل خارج مستودع Git:** أضف `--skip-git-repo-check`.
- **أوقف حد الإنفاق سكربتًا:** يعيد المفتاح [`API_KEY_QUOTA_EXHAUSTED`](https://5abeer.ai/ar/docs/help/errors.md#API_KEY_QUOTA_EXHAUSTED) حتى ترفع حده.
- **أي مشكلة أخرى في الإعداد:** شغّل `codex doctor`. وباقي رموز أخطائنا في [الأخطاء وحلولها](https://5abeer.ai/ar/docs/help/errors.md).

## أسئلة شائعة

### أي إصدار من 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 على باقتك دون مفتاح؛ راجع [ما الذي تشغّله كل باقة](https://5abeer.ai/ar/docs/subscriptions/plan-apps.md#codex). الباقات مخصّصة للتطبيقات المدعومة؛ ولكودك الخاص أنشئ مفتاح API.

## المصادر

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

- وثائق OpenAI: [Developer commands, Codex CLI](https://learn.chatgpt.com/docs/developer-commands?surface=cli)
- وثائق OpenAI: [Configuration reference](https://learn.chatgpt.com/docs/config-file/config-reference)
- وثائق OpenAI: [Model Context Protocol](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)
- وثائق OpenAI: [Authentication](https://learn.chatgpt.com/docs/auth)
- وثائق OpenAI: [Slash commands في تطبيق ChatGPT لسطح المكتب](https://learn.chatgpt.com/docs/reference/slash-commands)
- GitHub: [openai/codex release rust-v0.166.0](https://github.com/openai/codex/releases/tag/rust-v0.166.0)
- GitHub: [openai/codex, slash_command.rs at rust-v0.166.0](https://github.com/openai/codex/blob/rust-v0.166.0/codex-rs/tui/src/slash_command.rs)

> 5abeer خدمة مستقلة، ولا تتبع OpenAI.

## ابدأ

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