إضافات IDE (VS Code وغيرها)

📚 تنقل السلسلة: المقال السابق 08 · دليل استخدام سطر الأوامر CLI رافقك لتتقن تشغيل أمر codex في الطرفية. هذا المقال ينقل Codex داخل VS Code — ليعتمد على نفس الوكيل ونفس ملف الإعدادات، مع توفير واجهة رسومية وميزات مراجعة الفروق diff متوازية. المقال التالي 10 · العمل السحابي Codex Cloud سيتناول كيفية تفويض المهام تمامًا للسحابة.

دعونا نبدأ بمشاركة حوار حقيقي دار بيني وبين أحد زملائي الشهر الماضي.

زميلي: «أحاول البحث عن Codex في متجر إضافات VS Code، فلماذا لا أجد أي إضافة رسمية؟ لا تظهر لي سوى بعض الإضافات الصغيرة غير الرسمية التي تحمل هذا الاسم». أنا: «لقد أخطأت في اختيار الكلمة المفتاحية للبحث. الإضافة الرسمية لا تسمى Codex، ومعرفها (ID) هو openai.chatgpt». زميلي: «ماذا؟ قامت OpenAI بتسمية إضافة Codex بـ ChatGPT؟ من كان ليتوقع هذا!». أنا: «لقد واجهت نفس الغموض لخمس دقائق في البداية. يكفي البحث عن الإضافة التي يملكها الناشر (publisher) المعتمد OpenAI وتثبيتها مباشرة».

وبعبارة أخرى، تكمن العقبة الأولى لإضافات IDE لـ Codex في «إيجادها الصحيح» وليس طريقة استخدامها — حيث يحمل الاسم طابعًا غير متوقع، كما تخفيها بيئات مثل Cursor داخل قوائم الإضافات المطوية افتراضيًا. وسيوضح هذا المقال هذه النقاط بالتفصيل، ثم يشرح الميزات الحصرية التي تجعل استخدام الواجهة الرسومية أسهل بكثير مقارنة بـ CLI الجافة.

بعد قراءة هذا المقال，你会拿到：

• خطوات تفصيلية لتثبيت إضافة Codex في بيئات VS Code و Cursor و Windsurf، مع دليل حل مشكلات عدم العثور على الإضافة أو اختفاء الأيقونات.
• كيفية استخدام سياق المباشر للمحرر (البادئة @file وإرسال الأكواد المحددة تلقائيًا)، أوضاع الموافقة الثلاثة (approval modes)، والتبديل السريع للنماذج وعمق التفكير.
• جدول مقارنة شامل للاختيار بين (الإضافات، CLI، وتطبيق سطح المكتب)، بالإضافة للأوامر المائلة الحصرية والاختصارات القابلة للتخصيص.

---

01 أولاً: الفروق والروابط بين الإضافة، CLI، وتطبيق سطح المكتب

قد تسأل: «لقد تعلمت استخدام codex في الطرفية، وثبت تطبيق سطح المكتب بالفعل، فهل أحتاج حقًا لتثبيت الإضافة؟». الخلاصة: الإضافة ليست أداة جديدة مختلفة، بل هي واجهة رسومية مدمجة في المحرر لتشغيل Codex CLI。وتنص الوثائق الرسمية صراحة على أن إضافات IDE «تستخدم نفس وكيل Codex CLI وتتشارك معه في نفس ملف الإعدادات». فكل التعديلات التي أجريتها في ملف ~/.codex/config.toml للنماذج والبيئة المعزولة وسياسات الموافقة، ترثها الإضافة بالكامل؛ وتوثيق الحساب وقواعد ملف AGENTS.md المحددة في CLI يتم تطبيقها والاعتراف بها هنا أيضًا.

تشبيه: سيارة واحدة بنظامي تحكم (عجلة القيادة وجهاز تحكم عن بعد). يمثل CLI الجلوس خلف عجلة القيادة — للتحكم المباشر الكامل والقدرة على تبديل التروس؛ بينما تمثل الإضافة جهاز التحكم عن بعد المرفق، يتيح لك تشغيل السيارة بضغطة زر داخل المحرر دون الحاجة للجلوس داخلها، مع إمكانية متابعة تقدم العمل على شاشة العرض (لوحة مراجعة الفروق diff). والمحرك وخزان الوقود والأنظمة هي نفسها بالكامل — وأي وسيلة تحكم تختارها، تظل السيارة هي نفسها دون تغيير. ويمثل تطبيق سطح المكتب (المشروح في المقالين 03 و 07) واجهة خارجية مستقلة أخرى لنفس السيارة، وتناسب من يفضل تفادي محرر الأكواد والتركيز على إدارة المهام المتوازية بصريًا.

ومتى يتعين عليك استخدام كل منها؟ نلخص التوصيات في هذا الجدول:

السيناريوهات والحالات	سطر الأوامر CLI	إضافات IDE	تطبيق سطح المكتب
التركيز الكامل على كتابة الأكواد داخل VS Code / Cursor	مقبول	✅ الأنسب، لتوافق سياق الأكواد فورًا	يتطلب تبديل النوافذ
كتابة برمجيات الأتمتة، العمليات المجدولة، وإدارة الخوادم البعيدة عبر SSH	✅ الخيار الوحيد	❌ غير مدعوم	❌ غير مدعوم
تفادي سطر الأوامر، وإدارة مهام متوازية بالتوازي بصريًا	❌ غير مناسب	مقبول	✅ الأنسب والأسهل
مراجعة الفروق diff وتحديد أسطر محددة للتعديل	مخرجات نصية جافة	✅ مراجعة رسومية متوازية مدمجة	✅ مراجعة رسومية تفاعلية
الرغبة في تفعيل كامل خيارات CLI المتقدمة	✅ كامل الميزات	تشغيل codex في الطرفية المدمجة	—

الخلاصة: للمهام اليومية المرتبطة بالملفات وتعديل الأكواد ومراجعتها، تعد الإضافة الخيار الأكثر سلاسة وراحة؛ وعند الرغبة في تشغيل أوامر برمجية أو استخدام ميزات CLI المتقدمة غير المتوفرة في لوحة الإضافة، شغل أمر codex مباشرة في الطرفية المدمجة للمحرر — لمشاركتها نفس الإعدادات وتوثيق الحساب مع الإضافة، والتنقل بينهما يتم بسلاسة.

💡 الخلاصة في جملة واحدة: تمثل الإضافة و CLI وتطبيق سطح المكتب ثلاث واجهات مختلفة لنفس وكيل Codex، وتتشارك جميعها في نفس الإعدادات والتوثيق، ويمكنك التنقل بينها بمرونة حسب نوع المهمة المطلوبة.

---

02 التثبيت: البحث عن openai.chatgpt، وحل مشكلة اختفاء الأيقونة في Cursor

المحررات وأنظمة التشغيل المدعومة

تنص الوثائق الرسمية على: دعم إضافة Codex لـ محرر VS Code وفروعه النشطة مثل Cursor و Windsurf (بالإضافة لـ VS Code Insiders)، بينما تعتمد بيئات عائلة JetBrains (مثل IntelliJ و PyCharm و WebStorm و Rider وغيرها) على إضافة JetBrains المستقلة الخاصة بها. وتدعم الإضافة أنظمة التشغيل macOS و Windows و Linux بالكامل؛ وعلى نظام Windows تدعم التشغيل محليًا بالاعتماد على البيئة المعزولة للنظام، أو التحويل لبيئة WSL2 عند رغبتك في استخدام بيئة العمل لـ Linux (القسم 33 يوضح تفاصيل Windows).

تنبيه للاتصال: يتطلب تثبيت الإضافة، وتوثيق الحساب، وتشغيل الأكواد الاتصال بخدمات OpenAI، لذا تأكد من جاهزية واستقرار شبكة الاتصال والوصول للخدمات بشكل سليم ومتطابق مع سطر الأوامر.

طرق التثبيت الثلاث المتاحة

الطريقة الأولى: البحث في متجر الإضافات (الأكثر استقرارًا، مع دقة الكلمات)

افتح واجهة الإضافات بالضغط على الاختصار Cmd + Shift + X (على Mac) أو Ctrl + Shift + X (على Windows / Linux). وهنا تقع المشكلة الأولى: عند البحث بالاسم المعتاد Codex，结果跳出一堆第三方小插件，就是不见官方那条。原因是——官方扩展的 ID 是 openai.chatgpt，发布者（publisher）是 OpenAI。搜 Codex 或 ChatGPT 都行，但认准发布者是 OpenAI 的那条再点安装，别装成仿冒的。 مظهر البحث عن الإضافة في متجر VS Code:

الطريقة الثانية: التثبيت المباشر بالروابط

عند تشغيل المحرر، اضغط على الروابط التالية لتنتقل لصفحة التثبيت مباشرة:

VS Code   : vscode:extension/openai.chatgpt
Cursor    : cursor:extension/openai.chatgpt
Windsurf  : windsurf:extension/openai.chatgpt

الطريقة الثالثة: التثبيت بـ CLI (الأسرع)

إذا كنت قد هيأت أوامر تشغيل المحرر في الطرفية، فشغل السطر التالي للتثبيت مباشرة:

code --install-extension openai.chatgpt

ولمحرر Cursor استبدل الأمر بـ cursor فقط. ويكون المخرج المتوقع كالتالي:

Installing extensions...
Extension 'openai.chatgpt' was successfully installed.

⚠️ ملاحظة: معرف الإضافة المذكور openai.chatgpt معتمد رسميًا؛ ولقد تم فحص وتأكيد تطابق هذا الأمر مع مستودع الوثائق الرسمية لضمان سلامته.

حل مشكلة عدم ظهور أيقونة الإضافة بعد التثبيت

تنص الوثائق على: ظهور أيقونة Codex في شريط الأدوات الجانبي للمحرر، وتكون في الجانب الأيمن افتراضيًا في VS Code. ويختلف مظهر الأيقونة حسب نوع المحرر المستخدم، ونوضح حلولها في التالي:

نوع المحرر	السلوك المشاهد	الإجراء المطلوبة للتصحيح
عدم ظهور أيقونة Codex فور التثبيت	VS Code	يرجى إعادة تشغيل المحرر لتحديث شريط الأدوات الأيمن
خلو الشريط الجانبي الأيمن من الأيقونة	Cursor	يكون شريط الأدوات في Cursor أفقيًا افتراضيًا، وتقوم الأداة بطي الإضافات الجديدة وإخفائها — ويكفي سحب الأيقونة وتثبيتيها (pin) وتعديل ترتيبها لتظهر
الرغبة في نقل الأيقونة للجانب الأيسر المعتاد	VS Code	اضغط مع السحب لأيقونة Codex وانقلها لشريط الأدوات الأيسر مباشرة
الرغبة في نقل الأيقونة للجانب الأيمن في Cursor	Cursor	ابحث عن إعداد activity bar في الإعدادات، وعدل اتجاهه لـ vertical وأعد التشغيل، ثم اسحب الأيقونة لليمين، وأعد اتجاه الشريط لـ horizontal مجددًا

لقد واجهت هذه المشكلة بنفسي في محرر Cursor: بحثت عن أيقونة Codex مطولاً في الأعلى ولم أجدها وظننت أن التثبيت فشل، ثم اكتشفت قيام المحرر بطي الأيقونة تلقائيًا داخل قائمة الإضافات الإضافية — حيث تؤدي محدودية مساحة شريط Cursor الأفقي لطي الإضافات اللاحقة تلقائيًا، ويكفي سحبها وتثبيتها لتظهر بشكل دائم. ولا يواجه مستخدمو VS Code هذه المشكلة لكون شريط الأدوات رأسيًا افتراضيًا.

توثيق وتسجيل الدخول للمرة الأولى

عند فتح لوحة Codex للمرة الأولى، يطلب منك النظام تسجيل الدخول، بالاعتماد على حساب ChatGPT أو مفتاح API Key. وتنص الوثائق على أن اشتراك باقات ChatGPT يضم حصص استخدام Codex بالفعل، لذا يكتفي أغلب المستخدمين بتسجيل الدخول بحساب ChatGPT مباشرة دون الحصول على تهيئة مفاتيح إضافية. ونلخص حصص الباقات المتاحة في المقال 04.

💡 الخلاصة في جملة واحدة: للبحث عن الإضافة المعتمدة حدد الناشر OpenAI والمعرف openai.chatgpt؛ ويظهر الرمز تلقائيًا في الجانب الأيمن لـ VS Code بعد التثبيت وإعادة التشغيل، وتأكد من إظهار وتثبيت الأيقونة المطوية في محرر Cursor。

---

03 سياق المحرر: جلب وتوجيه الملفات والأكواد بدقة

تنشأ أغلب المشاكل من عدم استيعاب الوكيل للملفات البرمجية أو الأسطر المحددة التي ترغب في معالجتها لعدم دقة التوجيه. وتتميز الإضافة بتسهيل ربط سياق الملفات والأكواد مباشرة من نافذة المحرر. وتنص الوثائق الرسمية على: أن جلب الملفات المفتوحة والأسطر المحددة يسهل كتابة توجيهات مختصرة والحصول على نتائج سريعة ودقيقة。

تشبيه: الإشارة للمخطط الهندسي مباشرة، بدلاً من وصفه بالهاتف. وصف موضع الصيانة للمقاول بالهاتف قائلًا «الجهة المجاورة للنافذة في غرفة المعيشة» يجعله يعتمد على تخيله وقد يسيء فهم الموضع؛ أما بسط المخطط أمامه والإشارة بالإصبع قائلًا «هذا الجزء» يوضح المطلوب في ثانية واحدة بدقة. ويمثل CLI المكالمة الهاتفية (حيث تضطر لوصف المسارات بالكلمات)، بينما تمثل الإضافة الإشارة المباشرة للمخطط (تحدد السطر البرمجي أو تشير للملف بـ @ لتدرج صراحة في المحادثة).

وهناك وسيلتان أساسيتان لربط السياق:

أولاً: البادئة @file للإشارة للملفات

اكتب الرمز @ متبوعًا باسم الملف داخل صندوق الإدخال، ليقرأه Codex كمرجع للجلسة. وتوضح الوثائق المثال التالي للتوجيه:

بالاعتماد على ملف @example.tsx كنموذج، أضف صفحة جديدة باسم "Resources" للتطبيق، على أن تقرأ محتوياتها من قائمة البيانات المعرفة في ملف @resources.ts

حيث حدد التوجيه ملفين بوضوح — أحدهما لتصميم الهيكل والآخر كمصدر للبيانات، مما يمنع الوكيل من التخمين أو قراءة ملفات خاطئة.

ثانياً: تحديد الأسطر البرمجية + تفعيل ميزة Auto Context

وهذه الطريقة أسهل: حدد الأسطر البرمجية المراد تعديلها في نافذة المحرر مباشرة، ليتم إدراجها تلقائيًا في سياق المحادثة للجلسة. وتوفر الإضافة خيارًا مدمجًا يسمى السياسة التلقائية للسياق (Auto Context)، وعند تفعيله يقوم بجلب الملفات المفتوحة مؤخرًا وسياق المحرر تلقائيًا للجلسة — ويمكنك تفعيله أو إغلاقه بكتابة الأمر المائل /auto-context (قائمة الأوامر في القسم 06).

وتوفر إعدادات المحرر خيارين لحفظ وتثبيت الأسطر أو الملفات داخل الجلسة، ويمكن تفعيلهما من قائمة الأوامر العامة أو ربطهما باختصارات مخصصة:

معرف الأمر	الوظيفة والإجراء
chatgpt.addToThread	إدراج الأسطر البرمجية المحددة حاليًا لسياق الجلسة النشطة
chatgpt.addFileToThread	إدراج كامل الملف المفتوح حاليًا لسياق الجلسة النشطة

أعتمد على الطريقة الثانية دائمًا عند فحص أخطاء التصميم لواجهات React: أحدد كود JSX المشكوك فيه، وأكتب مباشرة «لماذا يظهر هذا الجزء بتنسيق خاطئ»، دون كتابة أي وصف إضافي لموقع الكود — ليقوم الوكيل بتحديد السبب وتصحيح خاصية flex للحاوية في جولتين فقط. وتوجيه هذا الاستفسار في CLI كان سيتطلب كتابة أسطر طويلة لوصف بنية وتداخل المكونات وهدر الوقت.

⚠️想拖图片进提示框当参考？官方提醒：拖放图片时按住 Shift，否则 VS Code 会拦住扩展的拖放（这点和它处理附件的机制有关）。

💡 一句话总结：@file 喂文件、选中代码 + Auto Context 自动喂上下文——把「你说的是哪段」这个最大的猜测成本直接干掉，提示能写得更短、结果更准。

---

04 أوضاع الموافقة الثلاثة: التخطيط المسبق أم التعديل المباشر

يعد هذا الإعداد الأهم للتحكم في سلوك الإضافة. ففي CLI يتم إعداد حدود البيئة المعزولة وسياسات الموافقة كمتغيرين منفصلين؛ بينما تقوم الإضافة بدمجهما وتبسيطهما في خيار موحد ثلاثي المستويات «أوضاع الموافقة (approval modes)» أسفل صندوق الإدخال، لتعديله بضغطة زر دون تعديل ملفات التكوين.

المستويات الثلاثة المعتمدة للصلاحيات والموافقة:

وضع الموافقة	سلوك Codex والتعديل	الحالات المناسبة للاستخدام
الوكيل الملتزم (Agent) (الافتراضي)	يقرأ ويعدل الملفات ويشغل الأوامر تلقائيًا داخل مساحة العمل؛ ويتوقف لطلب الإذن عند تجاوز الحدود أو الاتصال بالويب	الخيار الأساسي للتطوير والعمل البرمجي اليومي
المحادثة فقط (Chat)	يقتصر على النقاش والشرح واقتراح الخطط، دون تعديل أي ملفات	عند الرغبة في مراجعة وتصميم هيكل العمل دون لمس الأكواد
الوصول الكامل (Agent (Full Access))	يسمح بالقراءة والتعديل وتشغيل الأوامر والاتصال بالويب تلقائيًا بالكامل دون توقف أو إذن	البيئات الموثوقة بالكامل، وتنبه الوثائق الرسمية لضرورة توخي الحذر عند تفعيله

تشبيه: مستويات الصلاحيات للمطور المبتدئ. يمثل وضع Chat «كتابة خطة العمل واقتراح الحلول مع طلب الموافقة للملفات مسبقًا»؛ ويمثل وضع Agent «حرية ترتيب وتعديل الملفات على مكتبك (مساحة العمل)، مع وجوب التوقف وطلب الإذن للاتصال بالويب أو تعديل ملفات الأقسام الأخرى»؛ ويمثل وضع Agent (Full Access) «حرية التنقل والعمل والتعديل الخارجي والاتصال بالويب بالكامل دون الرجوع إليك». وتؤكد الوثائق الرسمية على ضرورة الحذر والتحقق الدائم عند تفعيل وضع الوصول الكامل.

سيناريوهات عملية لاختيار الوضع المناسب:

• دراسة وفهم مشروع برمجية جديد بالكامل: اختر وضع Chat ليقوم بالقراءة والتحليل واقتراح الخطط دون لمس أو تعديل أي ملف برمجية.
• التطوير والعمل اليومي المعتاد: التزم بالوضع الافتراضي Agent — ليتولى التعديل التلقائي لملفات مساحة العمل محليًا، ويتوقف لطلب الإذن عند محاولة تثبيت حزم أو تجاوز مسار المشروع.
• تشغيل عمليات تعديل واسعة وموثوقة بالكامل: انتقل مؤقتًا لوضع الوصول الكامل Agent (Full Access) لتفادي تكرار طلب الموافقة وتخطي الحظر، وتأكد من إعادته للوضع المعتدل فور انتهاء العملية.

ولقد واجهت مشكلة عملية في أبريل الماضي بسبب التسرع: حيث تفاديت تكرار الموافقة في تمرين لإضافة سجلات لعدة ملفات وفعلت وضع الوصول الكامل، فقام الوكيل بتعديل ترتيب استدعاء المكتبات (imports) لملفات أخرى دون علمي، واضطررت لقضاء وقت لتصحيح الملفات. ومنذ ذلك الحين، اعتمدت قاعدة صارمة: إبقاء الخيار على وضع Agent دائمًا، والتحويل للوصول الكامل للمهمات الموثوقة القصيرة ثم التراجع فورًا. وعند إجراء تعديلات واسعة، يفضل تفعيل وضع Chat لمراجعة خطة العمل واعتماد التوجه قبل السماح له بالبدء في التعديل.

💡 الخلاصة في جملة واحدة: تجمع الإضافة الصلاحيات في زر ثلاثي أسفل صندوق الإدخال — وضع Chat للنقاش والشرح، و Agent للتعديل المحلي مع طلب الإذن لتجاوز الحدود (الافتراضي)، و Agent (Full Access) للتعديل التلقائي الكامل (يتطلب الحذر)؛ واعتمد على وضع Chat لمراجعة خطط العمل قبل البدء.

---

05 تبديل النماذج وضبط مستويات التفكير لتوفير الاستهلاك

تسهل الإضافة تعديل إصدار النموذج وضبط عمق تفكيره بضغطة زر من القوائم أسفل صندوق الإدخال.

• تبديل النموذج: يعتمد Codex افتراضيًا على النماذج الموصى بها رسميًا (عائلة GPT حاليًا، وتتغير الإصدارات مع التحديثات). اضغط على قائمة النماذج لتعديل النموذج المستخدم — ويتميز كل نموذج بقدرات وتكاليف مختلفة لتوازن بين توفير الحصص للمهام البسيطة وضمان الجودة للمهام المعقدة.
• ضبط عمق التفكير (Reasoning Effort): وهو المفهوم المشروح في مقال CLI. وتعرفه الوثائق الرسمية بأنه التحكم في «وقت تفكير الوكيل قبل الإجابة»، وتوفر ثلاثة مستويات للضبط low / medium / high داخل قائمة النماذج.

تشبيه: الوقت المخصص للإجابة في الامتحانات. يشبه وضع low الإجابة على الأسئلة البديهية البسيطة بسرعة وبأقل دقة؛ بينما يشبه وضع high حل المسائل المعقدة حيث يوجه النموذج للتحليل المتأني والتفكير العميق مما يبطئ العمل ويزيد من دقته. وتنصح الوثائق الرسمية بالبدء بوضع medium دائمًا، والتحويل لوضع high للمهام المعقدة الصعبة فقط。والسبب يرجع لزيادة استهلاك الرموز (tokens) وتسريع الوصول لحدود الاستخدام المسموحة عند تشغيل وضع التفكير الأقصى.

عادتي الشخصية تلتزم بنصيحة الوثائق: أعتمد على وضع medium للمهام اليومية المعتادة لسرعته وتوفيره؛ وعند الحاجة لمراجعة عدة ملفات برمجية والربط بينها لحل مشاكل معقدة، أحوله مؤقتًا لوضع high. وتثبيته على الحد الأقصى يضيع التوفير المالي لزيادة استهلاك الرموز دون مبرر.

نلخص الفروق في الجدول التالي:

البعد	تبديل النموذج	ضبط عمق التفكير (Effort)
موضع الإعداد	قائمة الخيارات أسفل صندوق الإدخال	نفس القائمة، وتحدد لكل نموذج بشكل مستقل
المستويات المتاحة	خيارات خفيفة / رائدة (حسب إصدار جهازك)	low / medium / high
الموازنة التقنية	توفير الحصص للمهام البسيطة، وضمان الكفاءة للتعقيد	زيادة الدقة تبطئ العمل وتزيد من استهلاك الرموز
التهيئة المعتادة	النموذج الافتراضي الموصى به	إعداد وضع medium للمهام اليومية، و high للصعوبات

💡 الخلاصة في جملة واحدة: يتم تبديل النماذج وضبط عمق تفكيرها من القوائم أسفل صندوق الإدخال — واعتمد على النماذج الخفيفة ووضع التفكير medium للمهام اليومية، ووفر النماذج الرائدة ووضع التفكير الأقصى high للمهام الصعبة المعقدة لتفادي هدر الاستهلاك.

---

06 الأوامر المائلة وتفويض العمليات سحابيًا

أولاً: الأوامر المائلة المعتمدة للإضافة

اكتب الرمز / داخل صندوق إدخال Codex لتظهر لك الأوامر المائلة المدعومة — وتذكر أن الأوامر الرسمية تختلف تمامًا عن المسميات القديمة غير المعتمدة في الشروحات غير الرسمية مثل /explain أو /fix أو /test。وتشمل الأوامر المعتمدة ما يلي (للتحكم في الجلسة، والتبديل بين المعالجة المحلية والسحابية، ومراجعة الحالة):

الأمر المائل	الوظيفة والإجراء
/status	عرض معرف الجلسة الحالية، حجم استهلاك السياق، وحدود الاستهلاك
/auto-context	تفعيل أو إلغاء ميزة Auto Context (جلب الملفات المفتوحة وسياق المحرر تلقائيًا)
/local	التحويل لـ الوضع المحلي لمعالجة المهام على ملفات جهازك محليًا
/cloud	التحويل لـ الوضع السحابي لتفويض معالجة المهام سحابيًا (يتطلب توفر الصلاحيات السحابية)
/cloud-environment	اختيار البيئة السحابية المستهدفة (يستخدم في الوضع السحابي فقط)
/review	تفعيل وضع مراجعة الأكواد ومقارنة التعديلات غير المسجلة مع الفرع الرئيسي
/goal	تحديد هدف عام ملتزم للوكيل لإنجازه ومتابعة العمل عليه
/feedback	فتح نافذة إرسال الملاحظات والتقارير للشركة

ملاحظة: إذا لم يظهر أمر تحديد الأهداف /goal في القائمة، فذلك يرجع لتعطل مفتاح الميزة في الإعدادات — ويتعين كتابة goals = true تحت قسم [features] في ملف ~/.codex/config.toml لتفعيله، أو توجيه Codex لتشغيل أمر التفعيل codex features enable goals (وفقًا للتحديثات الرسمية).

ثانياً: تفويض المهام المعقدة سحابيًا (ميزة تجريبية)

توفر الإضافة ميزة ممتازة: تفويض المهام الطويلة والمعقدة بالكامل لخوادم Codex السحابية لتفادي استهلاك موارد جهازك محليًا، ومتابعة تقدم العمل ومراجعة النتائج مباشرة من نافذة المحرر。وتشمل خطوات تشغيلها المعتمدة ما يلي:

1. إنشاء البيئة السحابية (cloud environment) المخصصة من قائمة إعدادات Codex في صفحة ChatGPT أولاً.
2. تحديد البيئة المحددة في الإضافة، والضغط على خيار Run in the cloud.

وتوفر الميزة السحابية مرونة إضافية: حيث تدعم بدء المعالجة السحابية بناءً على الفرع الرئيسي main (لتجربة ميزات جديدة بالكامل)، أو جلب التعديلات المحلية غير المسجلة للبدء منها (لمواصلة وتصدير عمل قيد التنفيذ). والأكثر تميزًا — أن تفويض العمل للسحابة يحتفظ بسياق المحادثة المكتوبة محليًا لتواصل السحابة العمل بناءً عليها؛ وفور انتهاء العمل السحابي، يمكنك سحب الملفات المعدلة لجهازك لمراجعتها واختبارها محليًا.

عادتي الشخصية: أعتمد على التعديل المحلي المباشر للمهام البسيطة اليومية; وعند الحاجة لتشغيل مهام طويلة مثل «تشغيل كامل الاختبارات وتصحيح الأعطال ذاتيًا»، أكتب الأمر المائل /cloud لتفويض المهمة سحابيًا ومواصلة عملي الآخر محليًا حتى انتهاء العملية. وسنفصل ميزات العمل السحابي بالكامل في المقال 10، ويكفي استيعاب إمكانية تفويض الجلسة سحابيًا بضغطة زر من الإضافة.

💡 الخلاصة في جملة واحدة: تلتزم الأوامر المائلة المتاحة في الإضافة بالقائمة الرسمية وتشمل /status و /local و /cloud و /review (وتجنب المسميات القديمة غير المعتمدة)، ويدعم الأمر /cloud تفويض المهام الطويلة سحابيًا مع حفظ سياق المحادثة.

---

07 تمرين عملي: تشغيل واختبار مسار الإضافة في 10 دقائق

سنقوم الآن بتطبيق عملي متكامل لتأكيد تثبيت الإضافة وسلامة تشغيلها في محرر VS Code دون الاعتماد على مشاريع معقدة. اتبع الخطوات التالية:

الخطوة 0: إنشاء مجلد تجريبي وفتحه في محرر VS Code

شغل الأوامر التالية في الطرفية (على نظام Mac / Linux؛ ولنظام Windows PowerShell استبدل mkdir -p بـ mkdir):

mkdir -p ~/codex-ide-demo && cd ~/codex-ide-demo
printf 'def greet(name):\n    return "Hello " + name\n\nprint(greet("world"))\n' > demo.py
code .

المتوقع: يفتح محرر VS Code مجلد المشروع، ويظهر ملف demo.py في مستكشف الملفات الأيسر. (إذا لم تهيئ أمر فتح المحرر code في الطرفية، فافتح المجلد يدويًا من واجهة المحرر).

الخطوة 1: فتح لوحة Codex وتوثيق الحساب

تظهر أيقونة Codex في شريط الأدوات الجانبي الأيمن لـ VS Code افتراضيًا بعد التثبيت وإعادة التشغيل (ولمستخدمي Cursor تأكد من سحب الأيقونة من القائمة المطوية). اضغط على الأيقونة وسجل الدخول بحساب ChatGPT وامنح الصلاحيات من المتصفح.

المتوقع: ظهور لوحة محادثة Codex في الجانب الأيمن للمحرر، مع اختفاء إشعار طلب التوثيق، وظهور أزرار تبديل النموذج وأوضاع الموافقة أسفل صندوق الإدخال.

الخطوة 2: تحديد الأسطر البرمجية وتوجيه التعديل ومراجعة الفروق

حدد سطرين كود دالة greet في ملف demo.py (وتأكد من اختيار وضع الموافقة الافتراضي Agent)، واكتب التوجيه التالي في صندوق الإدخال:

قم بتعديل الدالة لتعتمد على f-string في Python، مع إضافة معاملات الأنواع

المتوقع: يقوم Codex بالبدء الفوري في تعديل دالة الجمع المحددة مباشرة دون التوقف لسؤالك عن مسار الملف (مما يؤكد نجاح قراءة سياق الأكواد المحددة)، ويعرض الفروق البرمجية بصيغة مقارنة رسومية متوازية (تعديل السطر لاستخدام f-string وإضافة معاملات الأنواع). تفحص التعديلات واعتمد حفظها.

الخطوة 3: التحويل لوضع المحادثة Chat لمراجعة خطة العمل

اضغط على زر أوضاع الموافقة أسفل صندوق الإدخال وحدد وضع Chat، ثم اكتب التوجيه التالي:

أريد إضافة دعم لمعاملات سطر الأوامر (arguments) لملف demo.py لتمرير الاسم عند التشغيل، اشرح لي خطة التعديل المقترحة أولاً

المتوقع: لكون الجلسة تعمل تحت وضع Chat الآمن، فلن يقوم Codex بلمس أو تعديل ملف الأكواد، وسيقتصر رده على شرح الخطة البرمجية المقترحة (مثل استخدام مكتبة argparse والملفات المستهدفة بالتعديل). وعند رضاك عن التوجه، عدل الوضع لـ Agent مجددًا ليقوم بالتعديل.

الخطوة 4: مراجعة الحالة بـ /status

اكتب في صندوق الإدخال:

/status

المتوقع: يعرض Codex إحصاءات الجلسة الحالية وحجم السياق المتبقي والحدود النشطة. وبإتمام هذا تمرين، تكون قد طبقت بنجاح: «ربط سياق المحرر، مراجعة الفروق الرسومية، التبديل بين أوضاع الصلاحيات، وتشغيل الأوامر المائلة»。

---

08 تخصيص الاختصارات والعودة لـ CLI عند الحاجة

أولاً: تخصيص اختصارات الأوامر السريعة

لا ترتبط أغلب أوامر إضافة Codex باختصارات افتراضية للوحة المفاتيح (خلافًا لأمر بدء جلسة جديدة)، وتتيح لك الإعدادات تخصيصها وربطها بالأزرار المفضلة لديك بمسارين: الضغط على أيقونة الإعدادات بلوحة المحادثة واختيار Keyboard shortcuts؛ أو فتح قائمة الأوامر العامة:

1. افتح قائمة الأوامر العامة بالاختصار (Cmd + Shift + P / Ctrl + Shift + P).
2. ابحث وشغل خيار Preferences: Open Keyboard Shortcuts.
3. ابحث بكلمة Codex أو معرف الأمر البرمجي (مثل chatgpt.newChat)، واضغط على رمز القلم، وأدخل الأزرار المفضلة لربطها.

ونلخص الأوامر القابلة للربط في هذا الجدول:

معرف الأمر	الاختصار الافتراضي	الوظيفة والإجراء
chatgpt.newChat	Cmd + N على Mac / Ctrl + N على Windows	لبدء جلسة محادثة مستقلة جديدة (thread)
chatgpt.openSidebar	غير محدد (قابل للتخصيص)	لفتح لوحة محادثة Codex الجانبية
chatgpt.newCodexPanel	غير محدد (قابل للتخصيص)	لإنشاء لوحة Codex تفاعلية جديدة
chatgpt.addToThread	غير محدد (قابل للتخصيص)	لإدراج الأسطر البرمجية المحددة لسياق الجلسة
chatgpt.addFileToThread	غير محدد (قابل للتخصيص)	لإدراج كامل الملف المفتوح لسياق الجلسة
chatgpt.implementTodo	غير محدد (قابل للتخصيص)	لتوجيه Codex لمعالجة تعليق TODO المحدد برمجياً

ثانياً: إعدادات مفيدة للإضافة

تقتصر إعدادات الإضافة في واجهة المحرر على تخصيص المظهر وتفضيلات العرض، وتظل الإعدادات التقنية المؤثرة في سلوك الوكيل (النماذج والصلاحيات والبيئة المعزولة) تُدار وتُعدل من ملف الإعدادات المشترك ~/.codex/config.toml (وفقًا للمقالين 02 و 15). ونلخص خيارات العرض المتاحة في الجدول التالي:

خيار الإعداد	الوظيفة والعرض
chatgpt.openOnStartup	لتركيز وفتح لوحة Codex الجانبية تلقائيًا عند تشغيل المحرر
chatgpt.commentCodeLensEnabled	إظهار زر CodeLens تفاعلي فوق تعليقات TODO، للبدء في معالجتها بضغطة زر
chatgpt.localeOverride	لتحديد لغة واجهة الإضافة، ويترك فارغًا للاكتشاف التلقائي
chatgpt.runCodexInWindowsSubsystemForLinux	خاص بنظام Windows: لتفعيل تشغيل Codex داخل WSL2 (عند تواجد الأكواد ومستندات العمل داخل WSL2)، ويتطلب تفعيله إعادة تحميل المحرر

ثالثاً: العودة لاستخدام CLI داخل المحرر

الأمر بسيط للغاية: افتح الطرفية المدمجة للمحرر بالاختصار (Cmd + ` / Ctrl + `)، وشغل أمر codex مباشرة — لمشاركتها نفس الإعدادات وتوثيق الحساب مع الإضافة، مما يتيح لك الاستفادة من كامل ميزات CLI المتقدمة مباشرة. وتنقل بمرونة وسرعة بين الواجهة الرسومية والطرفية داخل نفس النافذة.

💡 الخلاصة في جملة واحدة: تتوفر معظم أوامر Codex بدون اختصارات افتراضية ولكن يمكن تخصيصها من لوحة Keyboard Shortcuts؛ وتدار إعدادات السلوك من ملف التكوين config.toml وتفضيلات العرض من المحرر؛ وللوصول لـ CLI افتح الطرفية المدمجة وشغل codex.

---

09 ملخص

لخص هذا المقال تفاصيل تثبيت وتشغيل إضافة Codex لمحررات الأكواد:

• الروابط التقنية: لا تمثل الإضافة أداة جديدة مختلفة، بل هي واجهة رسومية مدمجة للمحرر تتشارك مع CLI في نفس الإعدادات بملف ~/.codex/config.toml وتوثيق الحساب.
• التثبيت: ابحث في متجر الإضافات عن الإضافة الرسمية التي تتبع الناشر OpenAI والمعرف openai.chatgpt؛ وتظهر في شريط الأدوات الأيمن لـ VS Code بعد التثبيت وإعادة التشغيل، وتأكد من تثبيت وإظهار الأيقونة المطوية في محرر Cursor.
• الميزات الحصرية: جلب سياق المحرر مباشرة (البادئة @file للأشخاص وتحديد الأسطر البرمجية)، أوضاع الموافقة الثلاثة لضبط الصلاحيات (Chat و Agent و Agent (Full Access))، وتبديل النماذج وعمق التفكير بضغطة زر.
• دقة الأوامر: تلتزم الأوامر المائلة المتاحة بالخيارات الرسمية وتشمل /status و /local و /cloud و /review (وتجنب المسميات القديمة غير المعتمدة)، ويمكن تخصيص اختصارات المفاتيح من إعدادات Keyboard Shortcuts للمحرر.

يجب أن تكون قادرًا الآن على: تثبيت الإضافة وتوثيقها بنجاح في VS Code أو Cursor، ربط سياق الملفات والأكواد المحددة بدقة للجلسة، موازنة الصلاحيات بأوضاع الموافقة الثلاثة، مراجعة الفروق الرسومية المتوازية لاعتماد التعديلات، وتفويض العمليات الطويلة سحابيًا بـ /cloud.

---

المقال التالي 10 · العمل السحابي Codex Cloud — لقد جربنا تفويض الجلسة سحابيًا سريعا في هذا المقال، وسيفصل المقال القادم كامل ميزات وقدرات المعالجة السحابية: كيفية إرسال المهام وتفويضها بالكامل لبيئة السحابة لـ OpenAI، كيفية ربط مستودعاتك في GitHub لتقرأ وتعدل الأكواد سحابيًا في بيئة معزولة، ومراجعة الفروق البرمجية وتصدير طلبات PR عند الانتهاء. وسؤال للتفكير: ما هي المهام البرمجية الحالية التي ترغب في تفويضها للسحابة ومتابعة عملك الآخر؟

---

قراءات موصى بها

• أفضل الممارسات: نصائح وتوصيات عملية لاستخدام Codex بكفاءة وتجنب المشاكل
• نظرة سريعة على المفاهيم الأساسية لـ Codex
• الأمان وصمام الأمان: هل يستحق الذكاء الاصطناعي منحه الوصول لملفات مشروعك الحساسة