# Codex لسطح المكتب مع QCode: Windows 11 خطوة بخطوة بالصور


**الإجابة المختصرة**: في «Windows PowerShell» على Windows الصق `irm https://qcode.cc/install/codex.ps1 | iex`، ثم الصق مفتاح `cr_` عند الطلب واختر `1) Codex 桌面版 App` (تطبيق Codex لسطح المكتب)، فيكتب السكربت `base_url = "https://api.qcode.cc/openai"` والمفتاح في `%USERPROFILE%\.codex\`؛ بعد ذلك اخرج من التطبيق تمامًا من علبة النظام وأعد فتحه، وبدّل أعلى اليسار إلى `Codex` وسيعمل.

| البند | ما تملؤه |
|---|---|
| عنوان الوصول (`base_url`) | `https://api.qcode.cc/openai` |
| بروتوكول API (`wire_api`) | `responses` |
| النموذج الافتراضي | `gpt-6.2-sol` |
| ملف الإعدادات | `%USERPROFILE%\.codex\config.toml` |
| ملف المفتاح | `%USERPROFILE%\.codex\auth.json` |

تم التحقق في 2026-11-22 · ChatGPT (Codex لسطح المكتب) 26.1117.4957.0 · Windows 11


اتبع اللقطات أدناه خطوة بخطوة، وبعد نحو عشر دقائق سيكون Codex لسطح المكتب مثبتًا على جهاز Windows لديك وموصولًا بـ QCode — افتح التطبيق وبدّل أعلى اليسار إلى وضع `Codex` وستستطيع المحادثة مباشرة.

لا تحتاج لاستخدام Codex لسطح المكتب عبر QCode سوى مفتاح API واحد من QCode، ودون حساب ChatGPT: لا تملأ صفحة تسجيل الدخول في التطبيق، فملف `auth.json` الذي يكتبه السكربت السريع سيجعلها تختفي تلقائيًا. ويشترك Codex لسطح المكتب وCodex CLI في ملف `%USERPROFILE%\.codex\config.toml` نفسه، لذا بعد تعديل الإعدادات يجب **الخروج تمامًا** من علبة النظام ثم إعادة الفتح.


- **ينطبق على**: Windows 11 (64 بت) · وينطبق أيضًا على Windows 10 (64 بت)، بشرط إمكانية فتح Microsoft Store
- **إصدار البرنامج**: ChatGPT (Codex لسطح المكتب) 26.1117.4957.0 · السكربت السريع v2026.11.21.1
- **تاريخ تحديث اللقطات**: 2026-11
- **الوقت المتوقع**: 10 دقائق (حزمة التثبيت نحو 759 MB، وقد يطول الانتظار مع شبكة بطيئة)
- **ما تحتاج إليه**: مفتاح API من QCode يبدأ بـ `cr_`؛ وجهاز Windows متصل بالإنترنت



- الكمبيوتر يعمل بـ Windows 11 أو Windows 10 (كلاهما 64 بت)، ويستطيع فتح Microsoft Store و«Windows PowerShell»
- مفتاح API من QCode يبدأ بـ `cr_` منسوخ مسبقًا. ليس لديك حساب بعد؟ [أنشئ حساب QCode](https://qcode.cc/ar/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-codex-desktop-before) أولًا، واختر خطة من [صفحة الأسعار](https://qcode.cc/ar/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-codex-desktop-before)، ثم أنشئ المفتاح في [لوحة التحكم](https://qcode.cc/ar/dashboard).
- يستطيع الكمبيوتر فتح `qcode.cc` و`api.qcode.cc` وMicrosoft Store؛ وإذا تعذّر التنزيل فراجع ملاحظات المناطق في «التنزيل والتثبيت» أدناه
- خصّص 10 دقائق دون انقطاع؛ ولن تظهر نافذة «التحكم في حساب المستخدم» (UAC) إلا مرة واحدة في خطوة التثبيت من المتجر، انقر فيها «是» (نعم)


## التنزيل والتثبيت

لا توجد حزمة تثبيت مستقلة باسم «Codex» لنسخة سطح المكتب: فهي تظهر في Microsoft Store باسم **ChatGPT** (الناشر `OpenAI`)، وبعد التثبيت يكفي التبديل داخل التطبيق إلى وضع `Codex` لتصبح Codex. ولا تعتمد على Node.js ولا تحتاج إلى WSL.

تختلف المناطق فقط في **مدخل التنزيل الذي يمكن فتحه**، وخطوات الوصول بعد التثبيت ودخول التطبيق متطابقة. اختر منطقتك أولًا:

**أوروبا / اليابان**

- يمكن استخدام Microsoft Store والحزمة الرسمية المباشرة: ابحث في المتجر عن ChatGPT، أو افتح في المتصفح `https://apps.microsoft.com/detail/9plm9xgg6vks` وانقر «获取» (الحصول).
- للاستغناء عن المتجر، نزّل الحزمة الرسمية المباشرة `ChatGPT-x64.msix` (وعلى أجهزة ARM استخدم `ChatGPT-arm64.msix`) وثبّتها بالنقر المزدوج.
- يمر السكربت السريع عبر `qcode.cc`، وهو عادةً متاح مباشرة.


**البر الرئيسي للصين**

- استخدم Microsoft Store أولًا: افتح في المتصفح `https://apps.microsoft.com/detail/9plm9xgg6vks`، أو اكتب في «تشغيل» `ms-windows-store://pdp/?productid=9PLM9XGG6VKS`، ثم انقر «获取» (الحصول)، دون تسجيل الدخول إلى حساب Microsoft.
- إذا لم تُفتح صفحة المتجر أو ظلّت تدور، فاستخدم حزمة التثبيت الرسمية المباشرة <https://persistent.oaistatic.com/codex-app-prod/ChatGPT-x64.msix> (وعلى أجهزة ARM استخدم `ChatGPT-arm64.msix`). بعد النقر المزدوج يتولاها «مثبّت التطبيقات» (App Installer)، وقد تظهر نافذة UAC مرة واحدة.
- يمر السكربت السريع عبر `qcode.cc`، وهو عادةً متاح مباشرة.


**الدول العربية**

- قنوات التنزيل كما في «أوروبا / اليابان»: صفحة منتج ChatGPT في Microsoft Store، أو الحزمة الرسمية المباشرة `ChatGPT-x64.msix`.
- إذا لم يُفتح Microsoft Store، فاستخدم الحزمة الرسمية المباشرة؛ بعد النقر المزدوج يتولاها «مثبّت التطبيقات».
- يمر السكربت السريع عبر `qcode.cc`، وهو عادةً متاح مباشرة.


**روسيا / إيران**

- Microsoft Store يعمل عادةً؛ وإذا لم يُفتح، فاستخدم الحزمة الرسمية المباشرة `ChatGPT-x64.msix` (وعلى أجهزة ARM استخدم `ChatGPT-arm64.msix`) وثبّتها بالنقر المزدوج.
- إذا لم يُفتح المتجر ولا الحزمة المباشرة، فجرّب شبكة أخرى؛ ولن يتأثر أسلوب الوصول بعد التثبيت.
- يمر السكربت السريع عبر `qcode.cc`، وهو عادةً متاح مباشرة.


## اتبع اللقطات: Windows خطوة بخطوة

فيما يلي 15 خطوة، كل خطوة تفعل شيئًا واحدًا فقط. الأرقام البرتقالية على اللقطات (①، ②، ③) تقابل الترقيم في النص واحدًا بواحد، فحين ترى رقمًا انظر إلى الموضع نفسه في الصورة.



### افتح صفحة ChatGPT في Microsoft Store

افتح في المتصفح `https://apps.microsoft.com/detail/9plm9xgg6vks`. وتحقق عند موضع ①: اسم التطبيق `ChatGPT`، والناشر `OpenAI`، والزر مكتوب عليه «获取» (الحصول).

![صفحة منتج ChatGPT في Microsoft Store: تحت الأيقونة والاسم والتقييم والوصف يوجد زر «获取» (الحصول) (1)، انقر عليه لبدء التثبيت](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/01-download-page.webp)


إذا فعلتها بشكل صحيح فسترى: أعلى الصفحة أيقونة ChatGPT واسمه، والزر على اليمين مكتوب عليه «获取» (الحصول). وإذا كان مكتوبًا «打开» (فتح)، فهذا يعني أن الجهاز مثبّت عليه التطبيق بالفعل، فانتقل مباشرة إلى الخطوة 3.




### انقر «获取» (الحصول) لبدء التثبيت

انقر «获取» (الحصول) عند ①. ستظهر نافذة «التحكم في حساب المستخدم» (UAC) من Windows؛ بعد التأكد من أن الناشر `Microsoft Windows` انقر «是» (نعم)، ثم انتظر التنزيل؛ حجم حزمة التثبيت نحو 759 MB.

![بعد النقر على «获取» (الحصول) يعرض Microsoft Store أنه يجهّز التنزيل ويتحقق من المتطلبات، ويعرض موضع الزر تقدّم التثبيت (1)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/02-install-store.webp)


إذا فعلتها بشكل صحيح فسترى: يتحول الزر إلى «正在下载 / 正在安装» (جارٍ التنزيل / جارٍ التثبيت)، ثم إلى «打开» (فتح) بعد الانتهاء، ويمكنك البحث عن `ChatGPT` في قائمة ابدأ.


**تعثّرت؟ لا يحدث شيء عند النقر على «获取» (الحصول)، أو يعرض المتجر خطأ**

أغلق نافذة المتجر وأعد فتح صفحة المنتج وحاول مرة أخرى؛ وإذا لم ينجح فاستخدم الحزمة الرسمية المباشرة `ChatGPT-x64.msix` المذكورة في «التنزيل والتثبيت»، وانقر «安装» (تثبيت) بعد النقر المزدوج. وبعد التثبيت ابحث عن `ChatGPT` في قائمة ابدأ لتفتحه.




### أول تشغيل: لا تسجّل الدخول بعد

افتح `ChatGPT` من قائمة ابدأ (وقد تحتاج في أول مرة إلى النقر على «是» (نعم) في UAC مرة أخرى). الشاشة الأولى صفحة تسجيل دخول إنجليزية `Sign in to ChatGPT`: ① هو `Continue to sign in`، و② هو `Sign in another way`.

هذه الصفحة **لا تحتوي** على `Skip`، ولا تنقر أي زر تسجيل دخول الآن — فالخطوة التالية ستكتب الإعدادات بالسكربت السريع، وبعد كتابتها وإعادة فتح التطبيق لن تظهر هذه الصفحة مرة أخرى.

![صفحة تسجيل الدخول الإنجليزية Sign in to ChatGPT عند أول تشغيل: في الأعلى Continue to sign in (1)، وفي الأسفل Sign in another way (2)، ولا يوجد زر تخطٍّ](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/03-first-launch.webp)


إذا فعلتها بشكل صحيح فسترى: بطاقة فيها أزرار تسجيل الدخول فقط، عنوانها `Sign in to ChatGPT`، ولا تجد في الصفحة كلها «تخطٍّ» أو `Skip`.




### تعرّف على المدخل البديل، ولن تستخدمه الآن

إذا لم يعمل `auth.json` لاحقًا وطلب التطبيق تسجيل الدخول مرة أخرى، فانقر في صفحة تسجيل الدخول `Sign in another way`، وداخلها ① هو مدخل `OpenAI API Key`، ويمكنك إدخال مفتاح `cr_` مباشرة (وفي الأسفل أيضًا `Amazon Bedrock`).

هذا الدليل يستخدم السكربت السريع، لذا اكتفِ بإلقاء نظرة هنا ودون تسجيل دخول.

![صفحة Sign in another way الفرعية: العنصر الأول مدخل OpenAI API Key (1)، وفي الأسفل Amazon Bedrock وزر الرجوع](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/04-login-api-key.webp)


إذا فعلتها بشكل صحيح فسترى: العنصر الأول في الصفحة مكتوب عليه `OpenAI API Key`، وفي الأسفل `Back` للعودة إلى صفحة تسجيل الدخول.




### افتح PowerShell والصق أمر السكربت

انقر قائمة ابدأ، واكتب `Windows PowerShell` (أو «الطرفية» Terminal) لفتحه، ثم الصق الأمر التالي واضغط Enter:

```powershell
irm https://qcode.cc/install/codex.ps1 | iex
```

① هو الأمر الذي ضغطت Enter عليه للتو؛ ② هو إصدار السكربت في السطر الثاني من اللافتة `v2026.11.21.1`، ويتغير رقم الإصدار مع التحديثات؛ ③ هو اختبار سرعة نطاقات الوصول الثلاثة الذي يظهر بعد ذلك.

إن كنت تستخدم نظامًا غير صيني، أو ضبطت `$env:QCODE_LANG="en"` قبل التشغيل، فستظهر رسائل السكربت بالإنجليزية، وترتيب المفاتيح المطلوب الضغط عليها هو نفسه تمامًا.

![في Windows PowerShell بعد لصق أمر السكربت والضغط على Enter (1)، وفي الأسفل لافتة سكربت QCode ورقم الإصدار v2026.11.21.1 (2)، ثم نتائج اختبار سرعة نطاقات الوصول الثلاثة (3)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/05-run-script.webp)


إذا فعلتها بشكل صحيح فسترى: لافتة `QCode.cc · Codex 一键配置` (إعداد Codex بنقرة واحدة)، وسطر إصدار `v2026.11.21.1`، ثم `[1/6]` وثلاثة أسطر لنتائج اختبار السرعة.


**تعثّرت؟ تظهر رسالة أن irm ليس أمرًا داخليًا أو خارجيًا**

أنت فتحت «موجّه الأوامر» (CMD) وهو لا يعرف `irm`. أغلق هذه النافذة، وأعد فتح «Windows PowerShell» أو «الطرفية»، والصق الأمر مرة أخرى.




### اختر نطاق الوصول: اضغط Enter مباشرة

في سطر المطالبة ① اضغط Enter لقبول النطاق الأسرع في اختبار السرعة بين القوسين المربعين (وهو هنا `api.qcode.cc`). وبعد Enter سيعرض ② القيمة `base_url=https://api.qcode.cc/openai` — حتى `/openai` فقط، دون `/v1` في النهاية ودون شرطة مائلة.

`asia.qcode.cc` و`us.qcode.cc` هما نقطتا وصول أخريان، وكلاهما يشير إلى حساب QCode نفسه؛ وEnter يأخذ الأسرع افتراضيًا، فلا حاجة للاختيار يدويًا.

![يسأل السكربت عن نطاق الوصول المطلوب، والضغط على Enter يعادل 1 (1)؛ وبعد Enter يظهر نطاق الوصول api.qcode.cc وbase_url=https://api.qcode.cc/openai (2)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/06-choose-domain.webp)


إذا فعلتها بشكل صحيح فسترى: سطر `接入域: api.qcode.cc  ->  base_url=https://api.qcode.cc/openai` (نطاق الوصول: api.qcode.cc ← base_url=...)، ثم ينتقل مباشرة إلى `[2/6]` لطلب المفتاح.




### الصق مفتاح QCode

انسخ من [لوحة التحكم](https://qcode.cc/ar/dashboard) السلسلة التي تبدأ بـ `cr_`، وعد إلى النافذة والصقها بعد `API 密钥:` (مفتاح API:) عند ①، ثم اضغط Enter.

لا يظهر ما تكتبه أثناء الإدخال، فلا ترى أحرفًا على الشاشة؛ وبعد Enter يعرض ② فقط `已读取密钥: cr_****` (تمت قراءة المفتاح: cr_****) وآخر أربعة أحرف، ما يعني أن المفتاح وصل وأن صيغته صحيحة.

![يطلب السكربت لصق مفتاح API (1)؛ وبعد اللصق لا يظهر شيء، وبعد Enter يعرض فقط تمت قراءة المفتاح cr_**** وآخر أربعة أحرف (2)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/07-enter-key.webp)


إذا فعلتها بشكل صحيح فسترى: سطر `已读取密钥: cr_****` (تمت قراءة المفتاح: cr_****) يبدأ بـ `cr_`، ثم ينتقل إلى `[3/6]`.


**تحتاج مفتاح API؟**

إن لم يكن لديك حساب QCode بعد، [أنشئ حسابًا](https://qcode.cc/ar/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-codex-desktop-key) أولًا. وإذا أردت الدفع حسب الاستخدام، فاشترِ أولًا [باقة الدفع حسب الاستخدام](https://qcode.cc/ar/pay-as-you-go?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-codex-desktop-key)، ثم أنشئ المفتاح في [لوحة التحكم](https://qcode.cc/ar/dashboard). بعد الإنشاء انسخ السلسلة كاملة التي تبدأ بـ `cr_` وعد إلى الأعلى للصقها. ويمكنك الدفع ببطاقة الائتمان / الخصم (Visa / Mastercard)، أو Apple Pay / Google Pay، أو العملات المشفرة — راجع [طرق الدفع](/docs/reference/payment-methods).




### اختر `1) Codex 桌面版 App` (تطبيق Codex لسطح المكتب)

① هو سطر السؤال «你要在哪个 Codex 客户端里使用؟» (في أي عميل Codex تريد الاستخدام؟). اضغط Enter مباشرة على ② `1) Codex 桌面版 App` (تطبيق Codex لسطح المكتب) — فالخيار الافتراضي هو 1. هذا الخيار يكتب ملف الإعدادات فقط، ولا يثبّت Node.js ولا Codex CLI.

![يسألك السكربت عن عميل Codex الذي تريد الاستخدام فيه (1)، والعنصر الأول أدناه هو 1) Codex 桌面版 App (تطبيق Codex لسطح المكتب)، ويكتب ملف الإعدادات فقط (2)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/08-choose-client.webp)


إذا فعلتها بشكل صحيح فسترى: سطري خيارات — `1) Codex 桌面版 App` (تطبيق Codex لسطح المكتب) و`2) Codex CLI` — وبعد Enter ينتقل إلى `[4/6]` لجلب قائمة النماذج.




### اختر النموذج الافتراضي `gpt-6.2-sol`

① هو `[4/6]` وهو يجلب قائمة النماذج المتاحة. وفي السطر الأول من القائمة ② بعد `gpt-6.2-sol` توجد علامة `<- 推荐` (← موصى به)، فاضغط Enter لاختياره.

![يجلب السكربت قائمة النماذج المتاحة (1)، وفي السطر الأول بعد gpt-6.2-sol توجد علامة موصى به (2)، فاضغط Enter لاختياره](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/09-choose-model.webp)


إذا فعلتها بشكل صحيح فسترى: عدة أسطر تبدأ بـ `1)` `2)`، والسطر الأول هو `gpt-6.2-sol` وبعده `<- 推荐` (← موصى به).


**تعثّرت؟ لا يوجد gpt-6.2-sol في القائمة**

تُجلب قائمة النماذج حسب النماذج المتاحة لهذا المفتاح. تأكد أولًا من أنك لصقت مفتاح `cr_` الخاص بـ QCode دون مسافات زائدة؛ ثم أعد تشغيل السكربت لجلب القائمة مرة أخرى. وطالما أن السطر الأول يحمل `<- 推荐` (← موصى به) فاضغط Enter مباشرة.




### تأكد من كتابة الإعدادات

① هو `[OK] 已写入 config.toml + auth.json` (تمت كتابة config.toml وauth.json)؛ و② ينبّه إلى أن تطبيق سطح المكتب وCLI يشتركان في هذه الإعدادات، ويجب **الخروج تمامًا وإعادة التشغيل** ليسري المفعول؛ و③ هو طلب صغير يرسله السكربت تلقائيًا، وعبارة `接入验证通过` (نجح التحقق من الوصول) تعني أن العنوان والمفتاح والشبكة كلها تعمل.

![يعرض السكربت أنه كتب config.toml وauth.json (1)، وينبّه إلى أن تطبيق سطح المكتب وCLI يشتركان في الإعدادات وأن إعادة التشغيل بعد الخروج تمامًا ضرورية (2)، وكذلك نجاح التحقق من الوصول (3)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/10-write-config.webp)


إذا فعلتها بشكل صحيح فسترى: `已写入 config.toml + auth.json` (تمت كتابة config.toml وauth.json)، وسطر تنبيه «لا يسري إلا بعد الخروج تمامًا وإعادة التشغيل»، و`接入验证通过! 模型 gpt-6.2-sol 响应正常` (نجح التحقق من الوصول! النموذج gpt-6.2-sol يستجيب بشكل طبيعي).




### اقرأ الملخص الأخير

الملخص ثلاثة أسطر: ① نطاق الوصول (هنا `api.qcode.cc`)، و② النموذج الافتراضي `gpt-6.2-sol`، و③ الاتصال `[OK] 已验证` (تم التحقق). ومسار ملف الإعدادات في المنتصف ويشير إلى `C:\Users\你的用户名\.codex` (حيث «你的用户名» هو اسم المستخدم الخاص بك).

![الملخص الأخير للسكربت: نطاق الوصول api.qcode.cc (1)، والنموذج الافتراضي gpt-6.2-sol (2)، وملف الإعدادات config.toml مع auth.json، والاتصال OK تم التحقق (3)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/11-config-ok.webp)


إذا فعلتها بشكل صحيح فسترى: ثلاثة أسطر كلها تحمل `[OK]`، ونطاق الوصول `api.qcode.cc`، والنموذج `gpt-6.2-sol`.




### اخرج من التطبيق تمامًا

إغلاق النافذة وحده لا يكفي، فالعملية ما زالت تعمل ولن تُقرأ الإعدادات من جديد. اخرج هكذا:

1. انقر `^` في أسفل يمين شريط المهام لعرض أيقونات علبة النظام المخفية؛
2. انقر بزر الفأرة الأيمن على أيقونة `ChatGPT` هناك؛
3. انقر `Exit`.

لا توجد قائمة `File` في صفحة تسجيل الدخول، و`Ctrl+Q` لا يعمل حينها، و`Exit` في علبة النظام وحده هو الذي ينهي العملية فعليًا.


إذا فعلتها بشكل صحيح فسترى: تختفي أيقونة ChatGPT من علبة النظام؛ وعند فتح «إدارة المهام» لن تجد عملية باسم `ChatGPT`.


**تعثّرت؟ لا تجد أيقونة ChatGPT في علبة النظام**

قد تكون الأيقونة مطوية: انقر `^` في أسفل يمين شريط المهام لعرضها أولًا، ثم انقر بزر الفأرة الأيمن. وإذا كانت قائمة النقر الأيمن تحتوي فقط على `New Chat` / `Send Feedback`، فأنت تنقر على زر التطبيق في شريط المهام لا على أيقونة علبة النظام؛ جرّب الأيقونة الصغيرة داخل `^`.




### أعد الفتح وتجاوز الاستبيان

افتح `ChatGPT` من قائمة ابدأ مرة أخرى. لن تظهر صفحة تسجيل الدخول هذه المرة، بل ينتقل مباشرة إلى استبيان `What type of work do you do?`: ① هو الخيار `Engineering`، و② هو `Skip`. اختر أحد الخيارات أو انقر ② `Skip` مباشرة، فذلك يؤثر فقط على توصيات الواجهة ولا يؤثر على الوصول.

![بعد إعادة فتح التطبيق يظهر استبيان التخصيص مباشرة، وخيار Engineering مظلّل (1)، وزر Skip في أسفل اليمين (2)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/13-onboarding.webp)


إذا فعلتها بشكل صحيح فسترى: بطاقة الاستبيان، ودون `Sign in to ChatGPT`؛ وبعد النقر على `Skip` تدخل الواجهة الرئيسية.


**تعثّرت؟ يظهر Sign in to ChatGPT مرة أخرى بعد إعادة الفتح**

هذا يعني أن التطبيق لم يقرأ ملف المفتاح. تأكد أولًا من وجود `%USERPROFILE%\.codex\auth.json` وأن اسم المفتاح داخله هو `OPENAI_API_KEY`؛ ثم اخرج مرة من علبة النظام عبر `Exit` وأعد الفتح. وإذا ظهرت صفحة تسجيل الدخول مجددًا، فانقر فيها `Sign in another way` ← `OpenAI API Key` وأدخل مفتاح `cr_` مباشرة.




### بدّل الوضع إلى `Codex`

الواجهة الرئيسية تكون افتراضيًا على `ChatGPT Work`. انقر زر الوضع ① أعلى اليسار، واختر `Codex` من القائمة. بعد التبديل ستعرض كبسولة النموذج ② في أسفل اليمين `6.2 Sol High` — وهي `gpt-6.2-sol` في `config.toml` مع قوة استدلال `high`.

![الواجهة الرئيسية لـ ChatGPT، زر الوضع أعلى اليسار يمكنه التبديل إلى Codex (1)، وكبسولة النموذج أسفل اليمين تعرض 6.2 Sol High (2)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/14-main-model.webp)


إذا فعلتها بشكل صحيح فسترى: الوضع أعلى اليسار مكتوب عليه `Codex`، والعنوان في الوسط `What should we build?`، ونص حقل الإدخال `Do anything`، والكبسولة أسفل اليمين `6.2 Sol High`.


**تعثّرت؟ أسفل اليمين ليس 6.2 Sol High**

هذا يعني أن `config.toml` لم يسري. افتح `%USERPROFILE%\.codex\config.toml` بالمفكرة، وتأكد من وجود `model = "gpt-6.2-sol"` و`model_provider = "qcode"` في المستوى الأعلى، ومن وجود القسم `[model_providers.qcode]`؛ وبعد التعديل احفظ، ثم اخرج من علبة النظام عبر `Exit` وأعد الفتح.




### أرسل أول رسالة واستلم الرد

في حقل الإدخال ③ (نصه النائب `Do anything`) اكتب `Say hello in one short sentence` واضغط Enter. بعد ثوانٍ يكون ① هو ما أرسلته، وأدناه ② رد النموذج.

![أرسل تحية إنجليزية قصيرة في حقل الإدخال (1 هي الرسالة المرسلة)، وبعد ثوانٍ يصل رد النموذج (2)، وأدناه حقل الإدخال Do anything (3)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/15-first-reply.webp)


إذا فعلتها بشكل صحيح فسترى: رسالتك تظهر على يمين منطقة المحادثة، وبعد ثوانٍ تظهر على اليسار إجابة كاملة؛ لا دوران مستمر ولا خطأ 401.




## التحقق من النجاح

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

- إعادة فتح التطبيق لا تُظهر `Sign in to ChatGPT`، ويمكن تبديل الوضع أعلى اليسار إلى `Codex`؛
- كبسولة النموذج أسفل اليمين تعرض `6.2 Sol High`، وإرسال جملة يحصل على رد طبيعي؛
- للتحقق مرة أخرى من أن الطلبات تمر فعلًا عبر QCode: افتح [probe.qcode.cc](https://probe.qcode.cc/)، وأدخل المفتاح، وسترى الطلب الأخير واسم النموذج `gpt-6.2-sol`.


### انتهى كل شيء

أصبح Codex لسطح المكتب مثبتًا على جهاز Windows لديك وموصولًا بـ QCode: من الآن افتح `ChatGPT` وبدّل إلى وضع `Codex` لتطلب منه كتابة الشيفرة وتعديل الملفات مباشرة. ويمكنك بعد ذلك:

- [دليل Codex CLI الكامل](/docs/ide/codex)
- [دليل Claude Code الكامل](/docs/getting-started/claude-code-tutorial)
- [مقارنة Codex وClaude Code](/docs/getting-started/codex-vs-claude-code)
- [نقاط النهاية وصيغ API](/docs/getting-started/endpoints-and-api-paths)
- التالي: قارن الخطط في [صفحة الأسعار](https://qcode.cc/ar/pricing?utm_source=docs.qcode.cc&utm_medium=tut_done&utm_campaign=knowledge_base&src=docs-ide-codex-desktop-done) واختر الأنسب للاستخدام الطويل
- ارجع إلى [لوحة التحكم](https://qcode.cc/ar/dashboard) لمراجعة الاستخدام والرصيد


## الأخطاء الشائعة

| نص الخطأ | السبب | ما العمل |
|---|---|---|
| `Sign in to ChatGPT` | التطبيق لم يقرأ `auth.json` عند البدء: إما أن السكربت السريع لم يُشغَّل بعد، أو أنك بعد تعديل الإعدادات أغلقت النافذة فقط دون الخروج تمامًا من علبة النظام | انقر بزر الفأرة الأيمن على أيقونة `ChatGPT` في علبة النظام واختر `Exit` ثم أعد الفتح؛ وإذا استمر الظهور فتحقق من أن `OPENAI_API_KEY` في `%USERPROFILE%\.codex\auth.json` هو مفتاح يبدأ بـ `cr_` |
| `ERROR: unexpected status 401 Unauthorized: {"error":"Missing API key"}, url: https://xxx/v1/responses` | `config.toml` لا يحتوي على `requires_openai_auth = true`، أو `auth.json` ينقصه `OPENAI_API_KEY`، فالطلب يُرسل دون مفتاح | أضف `requires_openai_auth = true` إلى `[model_providers.qcode]` في `config.toml`، واكتب `auth.json` بالشكل `{"OPENAI_API_KEY": "cr_xxxxxxxx"}`، ثم احفظ واخرج من علبة النظام عبر `Exit` وأعد الفتح |
| `404 route not supported: POST /chatgpt/v1/responses` | `base_url` مكتوب بنطاق تسجيل دخول ChatGPT، أو أضفت `/v1` أو شرطة مائلة بعد `/openai` | أعد `base_url` إلى `https://api.qcode.cc/openai`، ثم احفظ واخرج من علبة النظام عبر `Exit` وأعد الفتح |
| `Error loading config.toml: wire_api = "chat" is no longer supported.` | `wire_api` ما زال `chat`، وCodex يدعم بروتوكول Responses فقط | غيّر `wire_api` إلى `"responses"`، ثم احفظ وأعد فتح التطبيق |
| `Missing environment variable: OPENAI_API_KEY` | استخدمت صيغة `env_key` لكن المتغير غير موجود في العملية التي تشغّل التطبيق؛ أو أبقيت `requires_openai_auth` و`env_key` معًا | في نسخة سطح المكتب يُفضّل استخدام `requires_openai_auth = true` مع `auth.json`، واحذف سطر `env_key`، فلا يجوز إلا صيغة واحدة |
| `模型提供商不匹配` | مزوّد الجلسة المرتبط بتاريخ المحادثة لا يطابق ما في `config.toml`، ويحدث عادةً بعد تسجيل الدخول إلى الحساب الرسمي في التطبيق ثم التبديل إلى مفتاح API | أنشئ محادثة جديدة؛ وتأكد من أن `model_provider = "qcode"` يطابق اسم الجدول `[model_providers.qcode]`، ثم بعد التعديل اخرج من علبة النظام عبر `Exit` وأعد الفتح |

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

### هل أحتاج إلى حساب ChatGPT لاستخدامه؟

لا. يتوقف التطبيق عند أول تشغيل على `Sign in to ChatGPT`، لكن ما إن تشغّل السكربت السريع وفق الخطوات أعلاه حتى يكون في `%USERPROFILE%\.codex\auth.json` مفتاح `cr_`، فتُتجاوز صفحة تسجيل الدخول عند إعادة الفتح وتدخل مباشرة إلى الاستبيان والواجهة الرئيسية. ولا تسجّل العملية الدخول إلى أي حساب من أي مزوّد.

### ما علاقة نسخة سطح المكتب بـ Codex CLI؟

يشتركان في `%USERPROFILE%\.codex\config.toml` و`auth.json` نفسيهما: فالنموذج وعنوان الوصول والمفتاح الذي تقرأه نسخة سطح المكتب مطابق تمامًا لما يقرأه Codex CLI. وعند اختيار `1) Codex 桌面版 App` (تطبيق Codex لسطح المكتب) في الخطوة 3 من السكربت السريع يُكتب ملف الإعدادات فقط، دون تثبيت Node.js وCLI؛ وإذا أردت لاحقًا استخدام سطر الأوامر فأعد تشغيل السكربت واختر `2) Codex CLI`، دون إعادة إدخال المفتاح. راجع [دليل Codex CLI الكامل](/docs/ide/codex) لطريقة الاستخدام من سطر الأوامر.

### ماذا أفعل إذا لم تسرِ الإعدادات بعد تعديلها؟

يقرأ التطبيق الإعدادات مرة واحدة عند بدء التشغيل فقط. بعد تعديل `config.toml` أو `auth.json` يجب النقر بزر الفأرة الأيمن على أيقونة علبة النظام أسفل يمين شريط المهام ثم `ChatGPT` ← `Exit`، والتأكد من انتهاء العملية، ثم إعادة الفتح؛ وإغلاق النافذة أو الضغط على `Ctrl+Q` لا يكفي.

### هل تحتاج نسخة سطح المكتب إلى Node.js أو WSL؟

لا، لا تحتاج إلى أي منهما. نسخة سطح المكتب تطبيق Windows أصلي يوزّعه Microsoft Store، والسكربت السريع عند اختيار `1) Codex 桌面版 App` لا يلمس Node.js ولا يحتاج إلى فتح WSL. ولا يُحتاج Node.js إلا عند تثبيت Codex CLI.

### كيف أختار النموذج؟

| احتياجك | النموذج الموصى به | السبب |
|---|---|---|
| العمل اليومي والبرمجة المعقدة كخيار أساسي | `gpt-6.2-sol` | سياق 1.05M / إخراج 128K، وتوازن في القدرات العامة |
| أصعب مهام Agent متعددة الخطوات | `gpt-6.2-astra` | الطراز الرائد الأعلى، مناسب لمعمارية الوحدات المتقاطعة والمهام الطويلة |
| الاستخدام اليومي الخفيف / المهام الدفعية | `gpt-6.1-terra` / `gpt-5.6-terra` | تكلفة أقل، ومحسّنة لسيناريوهات الشيفرة |
| نماذج الجيل السابق الراقية | `gpt-6-astra` | ما زال متاحًا، ويُفضّل الانتقال إلى `gpt-6.2-astra` للمهام الجديدة |

تعديل النموذج الافتراضي يعني تعديل سطر `model` في `config.toml`، ثم الحفظ والخرج من علبة النظام عبر `Exit` وإعادة الفتح. لاحظ أن `gpt-6.2-*` لا يدعم `model_reasoning_effort = "none"`.

### ماذا أفعل بعد انتهاء صلاحية المفتاح؟

الأمر يختلف بحسب نوع المفتاح:

- **الخطة الشخصية**: لا يمكن تجديد مفتاحها بعد انتهاء الصلاحية، بل يجب فتح خطة جديدة والحصول على مفتاح جديد.
- **باقة الدفع حسب الاستخدام**: بعد شراء باقة جديدة يعود المفتاح نفسه للعمل.

بعد تغيير المفتاح تذكّر تحديث `OPENAI_API_KEY` في `auth.json`، ثم اخرج من علبة النظام عبر `Exit` وأعد فتح التطبيق.

### كيف تُحسب التكلفة؟

يمكن لنسخة سطح المكتب وCodex CLI وClaude Code مشاركة مفتاح QCode API نفسه، وتُحسب التكلفة حسب استهلاك token الفعلي دون تمييز بين الأدوات. وعند ترك Codex يكرّر عدة جولات قد يكون استهلاك المهمة الواحدة أعلى؛ ويمكنك مراجعة الاستخدام والرصيد في [لوحة التحكم](https://qcode.cc/ar/dashboard).

## كتابة الإعدادات يدويًا (دون السكربت السريع)

كتب السكربت السريع الملفين نيابة عنك. وإن أردت كتابتهما بنفسك، أو أردت مطابقة الإعدادات على macOS، فاتبع ما يلي. وتقرأ نسخة سطح المكتب وCodex CLI ملف الإعدادات نفسه.

### إنشاء config.toml

في Windows (PowerShell) أنشئ المجلد أولًا:

```powershell
mkdir $HOME\.codex
```

ثم اكتب في `%USERPROFILE%\.codex\config.toml`:

```toml
model_provider = "qcode"
model = "gpt-6.2-sol"
model_reasoning_effort = "high"

[model_providers.qcode]
name = "qcode"
base_url = "https://api.qcode.cc/openai"
wire_api = "responses"
requires_openai_auth = true
```

### إنشاء auth.json

في الملف `auth.json` في المجلد نفسه اكتب ثلاثة أسطر، ويجب أن يكون اسم المفتاح `OPENAI_API_KEY`، وأن تكون علامات الاقتباس والنقطتان بحروف إنجليزية نصف عرض:

```json
{
  "OPENAI_API_KEY": "cr_xxxxxxxx"
}
```

استبدل `cr_xxxxxxxx` بمفتاحك. وعند الحفظ بالمفكرة يجب اختيار «所有文件» (كل الملفات) في «نوع الحفظ»، وكتابة اسم الملف `auth.json`، وإلا صار `auth.json.txt` ولم يستطع التطبيق قراءته.

### صيغة بديلة عبر متغيرات البيئة (اختر واحدة)

إذا أردت تمرير المفتاح عبر متغير بيئة، فاستبدل `requires_openai_auth = true` بـ `env_key = "QCODE_API_KEY"` ثم اضبط هذا المتغير. **ولا يجوز إلا صيغة واحدة**: فحين تكتب `requires_openai_auth = true` يتجاهل Codex القيمة `env_key`.

```toml
model_provider = "qcode"
model = "gpt-6.2-sol"
model_reasoning_effort = "high"

[model_providers.qcode]
name = "qcode"
base_url = "https://api.qcode.cc/openai"
wire_api = "responses"
env_key = "QCODE_API_KEY"
```

```powershell
# 临时设置（当前会话）
$env:QCODE_API_KEY = "cr_xxxxxxxx"

# 永久设置（写入用户环境变量，设完要重开应用）
[System.Environment]::SetEnvironmentVariable("QCODE_API_KEY", "cr_xxxxxxxx", [System.EnvironmentVariableTarget]::User)
```

### شرح حقول config.toml

| الحقل | الشرح |
|---|---|
| `model_provider` | اسم مزوّد النموذج المستخدم، وهنا يُضبط على `qcode` المخصص. الاسم اختياري بشرط مطابقته لـ `[model_providers.<名字>]` |
| `model` | النموذج الافتراضي، ويُوصى بـ `gpt-6.2-sol`؛ ولأصعب المهام اختر `gpt-6.2-astra` |
| `model_reasoning_effort` | قوة الاستدلال، وتدعم `low` و`medium` و`high` و`xhigh`. و`gpt-6.2-*` لا يقبل `none`، ويُفضّل الإبقاء على `high` أو `xhigh` |
| `base_url` | عنوان نقطة وصول QCode. في نسخة سطح المكتب اكتب `https://api.qcode.cc/openai`، دون `/v1` ودون شرطة مائلة في النهاية |
| `wire_api` | نوع بروتوكول API، وCodex يدعم حاليًا `responses` فقط |
| `requires_openai_auth` | استخدام مصادقة بصيغة OpenAI، ويُقرأ المفتاح من `OPENAI_API_KEY` في `auth.json`. وعند ضبطه على `true` يتجاهل Codex القيمة `env_key` |

ويكتب السكربت السريع أيضًا إعدادات وقت التشغيل مثل `review_model = "gpt-6.2-sol"` و`windows_wsl_setup_acknowledged = true`، ولا تحتاج نسخة سطح المكتب إلى التعامل معها، ولا تعدّلها يدويًا.

### النماذج المتاحة

عبر QCode يمكن اختيار نماذج Codex / GPT التالية:

| النموذج | الشرح | السيناريو الموصى به |
|---|---|---|
| **`gpt-6.2-sol`** | الطراز الرائد الأساسي، سياق 1.05M / أقصى إخراج 128K؛ يرفض `model_reasoning_effort = "none"` | الخيار الأول للعمل اليومي والبرمجة المعقدة (موصى به) |
| **`gpt-6.2-astra`** | الطراز الرائد الأعلى، سياق 1.05M / أقصى إخراج 128K؛ يرفض `none` أيضًا | أصعب مهام Agent متعددة الخطوات ومعمارية الوحدات المتقاطعة |
| `gpt-6.1-terra` | GPT-6.1 الفئة المتوسطة، سياق 1.05M | البرمجة اليومية / المهام الدفعية |
| `gpt-5.6-terra` | GPT-5.6 الرائد، محسّن للشيفرة | البرمجة / سيناريوهات Codex |
| `gpt-6-astra` | أقوى طراز من الجيل السابق | قدرات راقية، ويُفضّل الانتقال إلى `gpt-6.2-astra` للمهام الجديدة |

## نظرة سريعة على التكامل

| البند | الشرح |
|---|---|
| النماذج المتاحة | GPT ✅ (بروتوكول Responses) · Claude ❌ · النماذج الصينية ❌ (بروتوكول Responses لا يخدم النماذج الصينية) · Gemini ❌ (لا يوفّره QCode حاليًا) |
| البروتوكول وBase URL | يستخدم Codex بروتوكول OpenAI Responses: اكتب في `config.toml` القيمة `base_url = "https://api.qcode.cc/openai"` + `wire_api = "responses"` |
| موضع الإعدادات | في Windows في `%USERPROFILE%\.codex\` (`config.toml` + `auth.json`)، ويشترك فيهما سطح المكتب وCLI |
| نقاط وصول أخرى | `https://asia.qcode.cc/openai` و`https://us.qcode.cc/openai`، وهي الحساب والمفاتيح نفسها مع `api.qcode.cc` |
| الوثائق الرسمية | [openai/codex](https://github.com/openai/codex) |