دليل الأوامر والتكوين السريع
📚 التنقل في السلسلة: قادتك المقالة السابقة 〔34 المشروع الختامي العملي〕 لتجميع كل الأجزاء التي تعلمناها في المقالات السابقة لتشغيل مشروع حقيقي متكامل، ويمثل ذلك خطوة «التجميع». وتأتي هذه المقالة على النقيض — حيث سنقوم باستخلاص جميع الأوامر والعلامات ومفاتيح التكوين الموزعة في المقالات الثلاثين السابقة لتلخيصها في جدول سريع يمكنك تثبيته بجوار الشاشة للرجوع إليه دائمًا. وتنهي المقالة التالية 〔36 أفضل الممارسات〕 سلسلة Codex بالتركيز على «الاستخدام الصحيح».
دعني أشاركك أمرًا محرجًا.
خلال أول شهرين من استخدامي لـ Codex، كان لدي ملف على جهازي باسم codex-notes.txt يحتوي على ملاحظات عشوائية مثل «خيار تصدير JSON هو --json» و«كتابة آخر رسالة في ملف تستخدم -o» وما شابه. تكمن المشكلة في أن هذه الملاحظات كانت عشوائية وغير مرتبة، وفي كل مرة أريد فيها استخدام أمر codex exec لحفظ النتائج في ملف، كنت أبحث أولاً في هذا الملف، وإذا لم أجد الحل كنت أبحث في سجل الطرفية عبر أمر history | grep codex، وإذا تعذر ذلك كنت أبحث في محرك البحث للوصول للمستندات الرسمية — عملية بسيطة لسطر أوامر واحد كانت تستغرق مني خمس دقائق.
والأمر الأكثر إزعاجًا كان في التكوين. في إحدى المرات أردت إغلاق وصول الشبكة للـ sandbox في مشروع ما مؤقتًا، وتذكرت وجود مفتاح يبدأ بـ sandbox_workspace_write ولكني نسيت الباقي تمامًا، هل هو network؟ أم net_access؟ وظللت أجرب في ملف config.toml وتسبب ذلك في ظهور أخطاء عند تشغيل Codex، واضطررت في النهاية لمراجعة دليل config-reference لأكتشف أن المفتاح الصحيح هو sandbox_workspace_write.network_access. وحينها قررت: بدلاً من البحث في كل مرة، من الأفضل كتابة الأوامر والتكوينات الأكثر استخدامًا في جدول واحد للرجوع إليه في لمحة.
هذه المقالة هي ذلك الجدول الجاهز للعمل. لا تشرح المقالة المفاهيم النظرية (فقد وضحناها في المقالات السابقة)، بل تركز على مهمة واحدة — تسهيل البحث السريع والكتابة الصحيحة دون الحاجة لفتح المتصفح.
بعد قراءة هذه المقالة، ستحصل على:
- دليل سريع يغطي التثبيت وتسجيل الدخول، وأوامر وعلامات CLI، وأوامر الخط المائل، وخيارات التكوين الأكثر استخدامًا في ملف
config.toml - جدول المقارنة لمستويات الصلاحيات والـ sandbox والنماذج وقوة الاستدلال لتعبئتها بشكل صحيح وتجنب المشاكل
- قائمة «المداخل الأساسية» للقدرات المتقدمة مثل بروتوكول MCP، والوكلاء الفرعيين، والمهارات (Skills) للوصول للأوامر المعنية بسهولة
- تمرين مصغر قابل للتشغيل للتأكد من فاعلية وتأثير الأوامر الجارية على بيئتك المحلية
⚠️ تعتمد الأوامر والعلامات ومفاتيح التكوين على المستندات الرسمية، وقد تتغير مع تحديث الإصدارات؛ وتتغير أسماء النماذج والقيم الافتراضية مع الباقات والحسابات، لذا اعتمد دائمًا على ما يظهره أمر
codex --helpوملفconfig.tomlالمحلي لديك. ويمكنك التحقق من الإصدار الحالي عبر تشغيلcodex --version. ويتم توضيح الميزات «التجريبية» في بداية الأسطر للانتباه إليها قبل الاستخدام.
01 التثبيت وتسجيل الدخول
تعتبر هذه الأوامر الأكثر استخدامًا عند التثبيت للمرة الأولى، أو النقل لجهاز جديد، أو الإعداد في بيئات CI. تشبيه: تمثل هذه «الخطوات الثلاث الأولى لبدء تشغيل Codex» — التثبيت، تسجيل الدخول، والتحقق من نجاح الدخول، والتقصير في أي خطوة يعطل عمل الأداة.
قد يتطلب تنزيل سكريبتات التثبيت أو إتمام تسجيل الدخول عبر بروتوكول OAuth الاستعانة بـ أدوات تخطي الحجب (VPN) في بعض البيئات المحلية لتفادي تعطل التنزيل أو الاتصال بالخادم.
| المهمة | الأمر | نظام التشغيل / ملاحظات |
|---|---|---|
| التثبيت القياسي (سكريبت) | curl -fsSL https://chatgpt.com/codex/install.sh | sh | macOS / Linux |
| التثبيت القياسي (سكريبت) | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" | Windows |
| التثبيت عبر npm | npm install -g @openai/codex | جميع الأنظمة، يتطلب وجود Node |
| التثبيت عبر Homebrew | brew install --cask codex | macOS |
| الترقية للإصدار الأخير | codex update | متاح عند دعم التوزيعة للترقية التلقائية |
| تسجيل الدخول (OAuth في المتصفح) | codex login | الطريقة الافتراضية، تفتح المتصفح للدخول لحساب ChatGPT |
| تسجيل الدخول (رمز الجهاز) | codex login --device-auth | تستخدم عند تعذر فتح المتصفح (مثل الخوادم البعيدة) |
| تسجيل الدخول باستخدام API Key | printenv OPENAI_API_KEY | codex login --with-api-key | قراءة المفتاح من وحدة الإدخال القياسي (stdin) |
| التحقق من حالة تسجيل الدخول | codex login status | يعود بقيمة 0 عند نجاح تسجيل الدخول، ومفيد للتحقق في السكريبتات |
| تسجيل الخروج | codex logout | مسح بيانات الاعتماد المحلية |
| تشخيص وفحص بيئة العمل | codex doctor | تشغيله بعد التثبيت أو عند حدوث مشاكل لفحص التثبيت والبيئة والتأكيد والـ Git وغيرها |
💡 الخلاصة في جملة واحدة: تشغيل أمر
codex doctorبعد التثبيت للتأكد من سلامة البيئة، ثم التحقق عبرcodex login statusللتأكد من حالة الدخول يوفر عليك عناء تتبع المشاكل لاحقًا.
02 أوامر وعلامات Codex CLI الأكثر استخدامًا
يمثل هذا الجزء المكون الجوهري للمقالة. تشبيه: يمثل codex البرنامج الأساسي، وتوضح «الأوامر الفرعية» اللاحقة له الوجهة المطلوبة، وتحدد علامات --xxx طريقة الوصول والتنفيذ. تعرف على الأوامر الفرعية أولاً، ثم العلامات، وربطهما معًا ينتج أمرًا متكاملاً جاهزًا للتشغيل.
الأوامر الفرعية الأكثر استخدامًا
| الأمر الفرعي | المهمة | مستوى الاستقرار |
|---|---|---|
codex | تشغيل الواجهة التفاعلية داخل الطرفية (TUI)، ويتم تشغيله تلقائيًا عند كتابة codex بمفرده | مستقر |
codex exec | تشغيل أمر غير تفاعلي لمرة واحدة والخروج فور الانتهاء؛ يمكن اختصاره إلى codex e | مستقر |
codex resume | استكمال محادثة تفاعلية سابقة | مستقر |
codex fork | تفرع الجلسة الحالية لإنشاء مسار جديد دون المساس بسجل الجلسة الأصلية | مستقر |
codex apply | تطبيق التعديلات (diff) الناتجة عن المهام السحابية محليًا؛ يمكن اختصاره إلى codex a | مستقر |
codex mcp | إدارة خوادم MCP (list / add / remove / login) | تجريبي |
codex features | استعراض وتفعيل/إيقاف خيارات التحكم في الميزات بشكل دائم | مستقر |
codex completion | توليد سكريبتات إكمال الأوامر التلقائي للـ shell | مستقر |
العلامات العامة الأكثر استخدامًا (تكتب بعد codex أو الأوامر الفرعية)
| العلامة | المهمة | القيم / ملاحظات |
|---|---|---|
--model / -m | تغيير النموذج مؤقتًا | مثل -m gpt-5.5 |
--image / -i | إرفاق صورة مع الطلب الأول | لفصل عدة صور استخدم الفاصلة أو كرر علامة -i |
--cd / -C | تحديد مجلد العمل المطلوب قبل بدء التشغيل | تمرير مسار المجلد |
--sandbox / -s | اختيار مستوى الـ sandbox | read-only / workspace-write / danger-full-access |
--ask-for-approval / -a | تحديد توقيت طلب الموافقة | untrusted / on-request / never |
--search | تفعيل البحث المباشر على الإنترنت | تبديل web_search لـ live (الخيار الافتراضي هو cached) |
--add-dir | إضافة صلاحية كتابة لمجلد مخصص إضافي | يمكن تكراره، وهو أكثر أمانًا من فتح الصلاحيات للقرص بالكامل |
--profile / -p | تطبيق ملف تعريف (profile) إعدادات معين | يتم تطبيقه بالإضافة للإعدادات الأساسية |
--config / -c | تعديل خيارات التكوين مؤقتًا عبر سطر الأوامر | كتابة -c key=value ويتم تحليلها بصيغة TOML |
--yolo | تجاوز وضعي sandbox والموافقة بالكامل | خيار خطر، يوصى بتشغيله في بيئات معزولة فقط |
العلامات الخاصة بأمر codex exec (غير التفاعلي)
تستخدم هذه العلامات بكثرة عند كتابة السكريبتات وتشغيل بيئات CI. تشبيه: تشبه الواجهة التفاعلية طلب الطعام في المطعم مع مناقشة النادل، بينما يشبه أمر codex exec طلب خدمة التوصيل — حيث تحدد الطلب ويصلك المخرج للمكان المخصص.
| العلامة | المهمة |
|---|---|
كتابة - في خانة PROMPT | قراءة الطلب من وحدة الإدخال القياسي stdin (مثل cat prompt.txt | codex exec -) |
--json | إخراج النتائج بصيغة JSON متسلسل سطرًا بسطر (JSONL)، لتسهيل معالجتها عبر أداة jq |
--output-last-message / -o | كتابة الرد النهائي داخل ملف (مع طباعته في نفس الوقت في وحدة stdout) |
--output-schema | تمرير ملف JSON Schema لإلزام النتائج بالهيكل المحدد |
--skip-git-repo-check | السماح بالتشغيل داخل مجلدات لا تحتوي على Git |
--ephemeral | عدم حفظ سجل الجلسة على القرص |
--full-auto | خيار ملغى (deprecated) للتوافقية ويظهر تنبيهًا عند كتابته؛ واستخدم --sandbox workspace-write في السكريبتات الجديدة |
codex exec resume --last | استكمال تشغيل آخر جلسة exec سابقة |
💡 الخلاصة in جملة واحدة: تغيير النموذج عبر
-m، وضبط الـ sandbox عبر-s، وتحديد الموافقة عبر-a، والحصول على النتائج عبر-o/--json— حفظ هذه العلامات الأربع ينجز 80% من مهام سطر الأوامر.
03 أوامر الخط المائل (تكتب داخل واجهة TUI)
تستخدم أوامر الخط المائل داخل الواجهة التفاعلية فقط — فعند تشغيل أمر codex والدخول للواجهة، اكتب / لتظهر قائمة الاختيارات. تشبيه: تمثل هذه «أزرار الوصول السريع» داخل الجلسة، وتتيح لك تنفيذ التغييرات مباشرة دون الحاجة للخروج من الواجهة.
نستعرض فيما يلي الأوامر الأكثر استخدامًا. وتعتمد القائمة الكاملة على ما يظهر لك عند كتابة / محليًا وتختلف حسب الإصدارات.
| أمر الخط المائل | المهمة |
|---|---|
/model | تبديل النموذج الحالي (مع إمكانية ضبط قوة الاستدلال عند توفرها) |
/status | عرض النموذج الحالي، وسياسة الموافقة، والمجلدات المسموح بالكتابة فيها، والمساحة المتبقية للسياق |
/compact | ضغط المحادثات الطويلة وتلخيصها لتوفير مساحة في نافذة السياق |
/diff | مراجعة التغييرات (Git diff)، بما في ذلك الملفات الجديدة غير المضافة للمستودع |
/permissions | ضبط وتعديل حدود الصلاحيات والـ sandbox في منتصف الجلسة |
/review | توجيه Codex لمراجعة وتدقيق التعديلات الحالية في مساحة العمل |
/init | إنشاء ملف AGENTS.md جاهز للعمل في المجلد الحالي |
/mcp | استعراض أدوات MCP المتاحة للجلسة الحالية (أضف خيار verbose لعرض التفاصيل) |
/skills | استعراض واختيار المهارات (skills) المحلية المتاحة |
/agent | التنقل والتبديل بين جلسات الوكلاء الفرعيين النشطة |
/fast | تفعيل/إيقاف وضع الخدمة السريعة للنموذج الحالي (/fast on/off/status) |
/new | بدء جلسة محادثة جديدة تمامًا داخل نفس واجهة CLI |
/clear | مسح الشاشة وبدء جلسة جديدة |
/quit أو /exit | الخروج من واجهة CLI |
نشير إلى أن تفعيل خيار /fast مرتبط بخصائص النماذج المتاحة في الدليل (catalog) — فإذا كان النموذج الحالي لا يدعم وضع السرعة الفائقة، فلن يظهر خيار /fast في القائمة على الإطلاق، وهو سلوك طبيعي وليس خطأ برمجياً.
💡 الخلاصة في جملة واحدة: الأوامر الأربعة الأكثر أهمية داخل الجلسة هي: تبديل النموذج عبر
/model، ومراجعة الحالة عبر/status، وضغط السياق عبر/compact، ومراجعة التعديلات عبر/diff؛ واجعلها جزءًا من عاداتك اليومية.
04 خيارات التكوين الأكثر استخدامًا في config.toml
يتم كتابة ملف التكوين في المسار ~/.codex/config.toml (بصيغة TOML)، ويمثل «الذاكرة الدائمة» لـ Codex. تشبيه: تمثل علامات سطر الأوامر «توجيهات الرحلة الحالية»، بينما يحدد ملف config.toml «التفضيلات الافتراضية لكل الرحلات القادمة». ويمكن إضافة ملف تكوين للمشروع في المسار .codex/config.toml لتخصيص الإعدادات للمشروع (يتطلب تأكيد ثقة المشروع أولاً).
نستعرض فيما يلي الخيارات الأكثر استخدامًا، وتتوفر القائمة الكاملة في دليل config-reference الرسمي.
| مفتاح التكوين | المهمة | قيم تجريبية |
|---|---|---|
model | النموذج الافتراضي | "gpt-5.5" |
model_reasoning_effort | قوة الاستدلال | minimal / low / medium / high / xhigh |
model_reasoning_summary | تفصيل ملخص الاستدلال | auto / concise / detailed / none |
service_tier | مستوى الخدمة | flex / fast (لتسريع الاستجابة بالتعاون مع أمر /fast) |
sandbox_mode | مستوى الـ sandbox | read-only / workspace-write / danger-full-access |
sandbox_workspace_write.network_access | تفعيل وصول الشبكة في وضع الكتابة في مساحة العمل | true / false |
sandbox_workspace_write.writable_roots | مجلدات إضافية مسموح بالكتابة فيها | ["/path/a", "/path/b"] |
approval_policy | سياسة الموافقة | untrusted / on-request / never |
web_search | وضع البحث على الإنترنت | disabled / cached / live (الخيار الافتراضي هو cached) |
review_model | النموذج المستخدم مع أمر /review | يتبع نموذج الجلسة الافتراضي عند تركه فارغًا |
model_instructions_file | استخدام ملف مخصص لتوجيهات النظام بدلاً من التوجيهات المدمجة | تمرير مسار الملف |
نسخة بسيطة جاهزة للاستخدام من ملف config.toml؛ يمكنك نسخها وتعديل القيم حسب رغبتك:
model = "gpt-5.5"
model_reasoning_effort = "medium"
sandbox_mode = "workspace-write"
approval_policy = "on-request"
[sandbox_workspace_write]
network_access = false💡 الخلاصة في جملة واحدة: بتحديد خيارات
modelوmodel_reasoning_effortوsandbox_modeوapproval_policyفي ملفconfig.tomlتكون قد شكلت «الشخصية الافتراضية لـ Codex»، مع إمكانية تعديلها مؤقتًا عبر علامات سطر الأوامر عند الحاجة.
05 مستويات الصلاحيات والـ sandbox
يحدد الـ sandbox مدى قدرة Codex على التفاعل مع نظام جهازك وتعديل ملفاته، وتحدد سياسة الموافقة متى يطلب إذنك قبل التنفيذ. وهما خياران مكملان لبعضهما. تشبيه: يمثل الـ sandbox «الغرف المسموح للمتدرب بدخولها»، بينما تمثل الموافقة «هل يجب عليه مناداتك وتأكيد موافقتك قبل البدء في أي عمل داخلها».
مستوى الـ sandbox (--sandbox / sandbox_mode) | القدرات المسموحة | الحالات المناسبة |
|---|---|---|
read-only | السماح بالقراءة فقط، ومنع أي تعديل للملفات | التحليل والقراءة للمشاريع دون الحاجة لتعديل الكود |
workspace-write | السماح بتعديل الملفات داخل مجلد مساحة العمل الحالي فقط | المزيج المناسب والأكثر استخدامًا للتطوير المحلي اليومي |
danger-full-access | قراءة وكتابة القرص بالكامل مع فتح الوصول للشبكة | خيار خطر، ويقتصر تشغيله داخل الحاويات (containers) المعزولة أو بيئات CI runner فقط |
سياسة الموافقة (--ask-for-approval / approval_policy) | طريقة العمل |
|---|---|
untrusted | يسمح فقط بتشغيل الأوامر التي يعتبرها آمنة تلقائيًا، ويطلب تأكيد الباقي |
on-request | الخيار الموصى به للعمل التفاعلي، ويطلب تأكيدك عند تشغيل أوامر هامة |
never | لا يطلب أي تأكيد، ومناسب للتشغيل غير التفاعلي أو بيئات CI |
المزيج الموصى به للعمل المحلي اليومي بدون تعقيد:
codex --sandbox workspace-write --ask-for-approval on-requestونشير لنقطتين هما نتاج تجارب سابقة: إذا كنت تريد السماح بالكتابة في مجلد إضافي، فتجنب اختيار danger-full-access مباشرة، واستخدم علامة --add-dir للسماح بالكتابة في ذلك المجلد تحديدًا؛ وتجنب استخدام علامة --full-auto القديمة في السكريبتات الجديدة واستبدلها بـ --sandbox workspace-write.
💡 الخلاصة في جملة واحدة: اعتمد محليًا على «
workspace-write+on-request»، واستخدم في بيئات CI «تحديد sandbox مناسب +never»، واعتمد على--add-dirلإعطاء صلاحيات كتابة إضافية بدلاً من فتح صلاحيات النظام بالكامل.
06 النماذج ومستويات قوة الاستدلال
اختيار النموذج يعني «من نرسل لإنجاز العمل»، وتحديد قوة الاستدلال يعني «كم وقت التفكير المتاح له قبل البدء»، وهما خياران منفصلان. تشبيه: يمثل النموذج الشخص المكلف بالعمل، وتمثل قوة الاستدلال وقت التفكير المتاح له — فلا داعي لجعل خبير يستغرق وقتًا طويلاً لإصلاح خطأ بسيط، وتجنب مطالبة مبتدئ بتسليم حلول سريعة لمهام معقدة.
| النموذج | التصنيف | متى تستخدمه |
|---|---|---|
gpt-5.5 | رائد، الأقوى | المهام البرمجية الصعبة، إعادة الهيكلة الكبرى، ومهام البحث البنيوي |
gpt-5.4-mini | خفيف، سريع وموفر | المهام البسيطة، تشغيل المهام دفعة واحدة، واستخدام الوكلاء الفرعيين |
gpt-5.3-codex-spark | نسخة تجريبية فوري (لمشتركي ChatGPT Pro فقط) | التكرار البرمجي السريع واللحظي |
تجنب كتابة أسماء الموديلات الملغاة مثل gpt-5.2 و gpt-5.3-codex في إعداداتك أو مع علامة --model مجددًا.
يتم التحكم في قوة الاستدلال عبر مفتاح model_reasoning_effort وتتكون من خمسة مستويات:
| المستوى | قوة التفكير | الحالات المناسبة |
|---|---|---|
minimal | تفكير محدود للغاية، أسرع استجابة | إصلاح الأخطاء الإملائية (typos)، إعادة التسمية، وتشغيل أمر بسيط |
low | تفكير بسيط | التعديلات الطفيفة المباشرة |
medium | المستوى الافتراضي المتوازن | أغلب مهام البرمجة اليومية |
high | تفكير عميق ودقيق | التعديلات متعددة الملفات، والموازنة بين طرق التصميم |
xhigh | تفكير أقصى (حسب دعم الموديل) | المهام الصعبة للغاية التي تستحق انتظار النتائج |
التكوين الافتراضي المفضل لدي هو «gpt-5.5 + medium» لجميع المهام، وأقوم برفعه يدويًا إلى high عند مواجهة مشاكل بنيوية صعبة فقط. وتحدثنا في المقالة 30 عن خطورة قفل الإعداد الافتراضي على xhigh دائمًا، حيث تضيع أوقات طويلة في انتظار تفكير النموذج لأخطاء إملائية بسيطة، والتخلي عن فكرة «الحصول على الأقوى دائمًا» يوفر أوقاتًا أكثر بكثير مما تظن.
💡 الخلاصة في جملة واحدة: اعتمد يوميًا على «الرائد +
medium»، واستخدمminimal/lowللمهام الروتينية، وارفع الإعداد إلىhigh/xhighللمهام الصعبة فقط، وتجنب استخدام الموديلات الملغاة.
07 المداخل الأساسية لـ MCP، والوكلاء الفرعيين، والمهارات (Skills)
تمثل هذه الميزات قدرات متقدمة تم شرحها في مقالات منفصلة (المقالات 20، 21، 22). ونقدم في هذا الجزء «المداخل والأوامر الأساسية للتشغيل» لتسهيل الوصول إليها دون البحث في المقالات السابقة. تشبيه: يمثل هذا تحديد «موقع مقبض الباب» لكل ميزة — لتتمكن من فتح الباب مباشرة والرجوع للمقالة الخاصة لمعرفة تفاصيل العمل في الداخل.
| الميزة | المدخل الأساسي | توضيح |
|---|---|---|
| أدوات MCP (أدوات خارجية) | codex mcp list / codex mcp add <name> ... | إدارة خوادم MCP عبر سطر الأوامر؛ واستخدام /mcp داخل الجلسة لعرض الأدوات المتاحة (تجريبي) |
| تسجيل دخول MCP (الخوادم عبر الإنترنت) | codex mcp login <name> | متاح لخوادم HTTP المتدفقة التي تدعم نظام OAuth |
| إعداد خوادم MCP | إضافة مفتاح [mcp_servers.<id>] في config.toml | تحديد خيارات command و args و url لتعريف الخادم |
| الوكلاء الفرعيون (التوازي) | إضافة مفتاح [agents] / agents.<name>.* في config.toml | الحد الأقصى للجلسات max_threads هو 6 افتراضيًا؛ واستخدام /agent في الجلسة للتبديل |
| المهارات (Skills - مهام محددة) | كتابة أمر /skills داخل الجلسة | استعراض وتحديد المهارات؛ وإضافة [[skills.config]] (مع خيارات path/enabled) في ملف config.toml لتفعيلها |
لاحظ أن مجموعة أوامر codex mcp مصنفة كـ «ميزات تجريبية» حاليًا، وتخضع طبيعة عملها للتعديل مع تحديث الإصدارات، ويظل دليل المساعدة codex mcp --help هو المرجع الأساسي عند الاستخدام.
💡 الخلاصة في جملة واحدة: تدار أدوات MCP عبر أوامر
codex mcp؛ وتدار جلسات الوكلاء الفرعيين عبر إعدادات[agents]والتنقل عبر/agent؛ وتفعل المهارات عبر أمر/skills— تذكر هذه المداخل الثلاثة للبدء في استخدام الميزات المتقدمة بسهولة.
08 الجزء العملي: التحقق من تفعيل الأوامر التي بحثت عنها
الاحتفاظ بالجداول ليس كافيًا مثل تشغيل أمر مصغر بنفسك للتأكد من فاعليته محليًا. اتبع الخطوات الثلاث التالية، ولا يتطلب ذلك وجود مشروع مسبق.
الخطوة الأولى: فحص حالة تسجيل الدخول (عملية قراءة فقط دون تعديل):
codex login statusالنتيجة المتوقعة: طباعة بيانات الاعتماد الحالية عند نجاح الدخول مع رمز خروج 0؛ وإظهار تنبيه يوجهك لتشغيل codex login عند غياب الاعتماد.
الخطوة الثانية: تشغيل أمر غير تفاعلي لحفظ النتيجة في ملف — للتأكد من عمل أوامر codex exec وعلامة -o ومستوى sandbox القراءة فقط معًا:
codex exec --sandbox read-only -o /tmp/codex-check.txt "用一句话说明当前目录是不是一个 Git 仓库"(Note: we preserve the Chinese prompt here because it is in a code block).
النتيجة المتوقعة: طباعة الجملة الناتجة في الطرفية، مع كتابتها في نفس الوقت داخل ملف /tmp/codex-check.txt (استبدل المسار بمجلد مؤقت مناسب على نظام Windows). ويؤكد ظهور المحتوى داخل الملف سلامة عمل علامة -o.
الخطوة الثالثة: التأكد من صحة أسماء العلامات — عبر مطالبة CLI نفسه بالدعم:
codex exec --helpالنتيجة المتوقعة: عرض جميع العلامات المدعومة لأمر codex exec. وفي أي وقت تشعر فيه بالحيرة حول صحة كتابة علامة ما، يظل خيار المساعدة --help هو المصدر الأحدث والأكثر دقة دائمًا مقارنة بأي جدول خارجي.
💡 الخلاصة في جملة واحدة: تشغيل
login statusلفحص الدخول، ثمcodex exec -oللتأكد من عمل الأوامر وحفظها، ثم مراجعة--helpللتأكد من العلامات — خطوات ثلاث لتأكيد فاعلية الأوامر محليًا.
ملخص
لم تقدم هذه المقالة مفاهيم نظرية جديدة، بل لخصت ممارسات المقالات السابقة في سبعة جداول مرجعية:
- أوامر البدء: التثبيت، تسجيل الدخول عبر
codex login، التحقق عبرcodex login status، واستخدامcodex doctorعند حدوث مشاكل. - أوامر وعلامات CLI: يمثل الأمر الفرعي الوجهة والعلامة طريقة التنفيذ، وتعتبر علامات
-m/-s/-a/-o/--jsonالأدوات الخمس الأكثر استخدامًا. - أوائل أوامر الخط المائل: ممارسة أوامر
/modelو/statusو/compactو/diffداخل الجلسات بشكل مستمر. - إعدادات
config.toml: تحديد قيمmodelوmodel_reasoning_effortوsandbox_modeوapproval_policyلصياغة السلوك الافتراضي لـ Codex. - مستويات الصلاحيات: اختيار وضع
workspace-write+on-requestمحليًا، وتعيين sandbox مخصص معneverفي بيئات CI، والاستعانة بـ--add-dirلإضافة صلاحيات جزئية. - النماذج وقوة الاستدلال: الاعتماد على
gpt-5.5+mediumكإعداد افتراضي، وتجنب استخدام الموديلات الملغاة. - مداخل الميزات المتقدمة: استخدام أوامر
codex mcpلـ MCP، وإعدادات[agents]للوكلاء الفرعيين، وأمر/skillsللمهارات.
ينبغي عليك الآن أن تكون قادرًا على: الاستغناء عن الملاحظات العشوائية، والوصول لأي أمر أو خيار تكوين أو مستوى صلاحية مطلوب في لمحة من خلال هذه الصفحة، والاستعانة بخيار --help كمرجع أساسي عند الحاجة دون الحاجة لفتح المتصفح للبحث في المستندات.
المقالة التالية 〔36 أفضل الممارسات〕 تمثل مسك الختام لسلسلة Codex بالكامل. فإذا كانت هذه المقالة لحل مشكلة «حفظ الأوامر»، تركز مقالة أفضل الممارسات على «طريقة التطبيق الصحيحة» — فنفس أمر codex exec قد يستخدمه مطور لبناء خط مؤتمت متميز لتسليم الكود، وقد يستخدمه مطور آخر ويتسبب في فوضى عارمة لمستودع المشروع. فكر في هذا السؤال البسيط: من بين الأوامر التي تستخدمها يوميًا، ما هي الأوامر التي لم تفكر في مدى سلامة وصحة طريقة تشغيلها سابقًا؟ سنناقش هذه الجوانب بالتفصيل في المقالة القادمة.