إضافة Codex (VS Code / Cursor / Trae)

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

خطأ: بعد الإعداد تحصل على 401 يفيد بأن المفتاح غير صحيح

السبب: الطلب لا يزال يتوجّه إلى خدمة OpenAI الرسمية بدلاً من وسيط API الخاص بنا، أو أنك لم تُعِد تشغيل الأداة لإعادة تحميل ملف الإعداد.

الحل: اتبع الدليل مرة أخرى لـ إنشاء أو استبدال config.toml، ثم أعد تشغيل أداة بيئة التطوير.

الإعداد

الخطوة 1 — إنشاء / استبدال ملفات الإعداد

موقع ملف الإعداد:

• Mac/Linux: المجلد ~/.codex/
• Windows: المجلد C:\users\YourUsername\.codex\

إذا لم يكن لديك مجلد .codex، فأنشئه عبر أمر في الطرفية:

# Mac/Linux
rm -rf ~/.codex && mkdir ~/.codex

# Windows (run in the terminal)
rm -rf C:\users\YourUsername\.codex
mkdir C:\users\YourUsername\.codex

الخطوة 2 — كتابة config.toml

في المجلد .codex، أنشئ أو استبدل config.toml:

model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.lmuai.com"
wire_api = "responses"

[model_providers.OpenAI.http_headers]
Authorization = "Bearer your sk- key generated in the console"

استبدل السطر الأخير بمفتاحك الذي يبدأ بـ sk-، مع الإبقاء على مسافة واحدة بين Bearer والمفتاح، وضع قسم http_headers في نهاية الملف تمامًا. الإصدارات الأحدث من Codex لم تعد بحاجة إلى auth.json؛ ووجود ملف قديم منه لا يسبب أي ضرر.

بعد إتمام الإعداد، افتح VS Code أو Cursor أو Trae، وستُسجّل إضافة Codex داخلها الدخول تلقائيًا.

تثبيت إضافة Visual Studio Code

تثبيت الإضافة

1. افتح VS Code وافتح أولًا أي مجلد مشروع كمساحة عمل لك (وإلّا ستظهر نافذة منبثقة تطالبك بفتح مجلد مشروع!)
2. انقر على لوحة الإضافات على اليسار (أيقونة Extensions)
3. ابحث عن Codex، واعثر على الإضافة الرسمية من OpenAI باسم "Codex – OpenAI's coding agent"، ثم انقر على التثبيت
4. بعد التثبيت، سيظهر مدخل Codex في الشريط الجانبي الأيسر (وإن لم يظهر، فابحث عنه في أعلى يمين الواجهة)

تسجيل الخروج من الحساب القديم

1. انقر على أيقونة الإعدادات في أعلى يمين لوحة Codex
2. انقر على Log out لتسجيل الخروج

إتمام الإعداد

بعد تهيئة config.toml، أعد فتح إضافة Codex وانقر على Continue لإكمال عملية تسجيل الدخول.

تريد استخدام Claude أو الموديلات الصينية؟

إذا كنت تستخدم Trae فقط وهدفك موديلات مثل Claude / GLM / Qwen، فلا حاجة لإضافة Codex — فـ إعداد الموديلات الأصلي في Trae (بروتوكول Anthropic، ويكفي تعبئة بضعة حقول في الواجهة الرسومية) أبسط.

آخر تحديث: 2026-10-08

京ICP备2020034311号-7