Codex

Codex هو وكيل البرمجة من OpenAI ويأتي في ثلاثة أشكال: Codex CLI في الطرفية، وإضافة Codex في VS Code، وتطبيق Codex. الثلاثة تقرأ مجلد ~/.codex ذاته، لذا إعداد واحد يشمل الثلاثة.

تثبيت بأمر واحد

استبدل sk-xxx بمفتاحك، افتح طرفية، الصق واضغط Enter. يتحقق السكريبت من المفتاح، يسرد كل نموذج يمكن للمفتاح استدعاؤه ويتيح لك الاختيار (Enter = موصى به: gpt-astra لـ Astra، gpt-5.6-sol لـ GPT، claude-opus-5 لـ Claude)، يثبِّت Codex CLI ويكتب الإعداد.

macOS / Linux
Windows

curl -fsSL https://redeem.teamsoclo.site/install/codex.sh | bash -s -- --key sk-xxx

يسأل السكريبت أولاً عن اللغة (1 = فيتنامية، 2 = إنجليزية؛ تخطَّها بـ --lang en أو --lang vi). بدون --key يطلب المفتاح. لفرض نموذج أضف --model gpt-astra أو --model gpt-5.6-sol.

افتح PowerShell (ابدأ، اكتب PowerShell):

$env:TSL_KEY="sk-xxx"; irm https://redeem.teamsoclo.site/install/codex.ps1 | iex

لفرض نموذج أضف $env:TSL_MODEL="gpt-astra"; قبل irm؛ حدِّد اللغة بـ $env:TSL_LANG="en";.

اقرأ الكود قبل التشغيل إن أردت: codex.sh، codex.ps1. السكريبت يعمل على جهازك فقط ويرسل المفتاح إلى gpt.teamsoclo.site للتحقق فقط.

ماذا يفعل السكريبت

يتحقق من المفتاح مع البوابة ويختار النموذج لباقتك؛ مفتاح خاطئ يوقف هنا دون المساس بجهازك.
يحتفظ بنسخة احتياطية من config.toml الحالي إن وُجد، كـ config.toml.bak.<timestamp>.
يكتب ~/.codex/config.toml: النموذج gpt-5.6-sol، بوابة TeamSocLo، Responses API.
يخزِّن المفتاح في متغير البيئة TEAMSOCLO_API_KEY (في ~/.zshrc / ~/.bashrc، أو كمتغير مستخدم في Windows). المفتاح ليس في ملف الإعداد، لذا يمكنك مشاركة config.toml دون تسريبه.
يثبِّت أو يُرقِّي Codex CLI بـ npm install -g @openai/codex.

شغِّله مجدداً في أي وقت لتغيير المفاتيح أو الباقات؛ الإعداد القديم يُحتفظ به دائماً أولاً.

تفضِّل عدم استخدام الطرفية؟ TeamSocLo Key Tool تطبيق لـ Windows وmacOS: الصق مفتاحك مرة واحدة لإعداد Codex وClaude Code وأكثر من 20 أداة أخرى.

بعد التثبيت

افتح طرفية جديدة وشغِّل codex

codex

الطرفية القديمة لم تحمِّل المتغير الجديد؛ افتح تبويباً جديداً. اسأل Codex أي شيء للتحقق.

VS Code: ثبِّت الإضافة وأغلق كلياً وأعد الفتح

VS Code ← Extensions ← ابحث عن Codex (وكيل البرمجة من OpenAI) ← Install. ثم أغلق VS Code كلياً: macOS Cmd + Q، Windows أغلق كل النوافذ. Reload Window لا يكفي؛ الإضافة تقرأ الإعداد عند بدء العملية فقط.

تطبيق Codex

أعد فتح التطبيق بعد تشغيل الأمر. في macOS عيَّن الأمر المتغير لتطبيقات GUI عبر launchctl؛ في Windows يُطبَّق setx على التطبيقات التي تُفتح بعد ذلك.

لا يلزم تسجيل دخول OpenAI. requires_openai_auth = false يخبر Codex باستخدام مفتاح البوابة من متغير البيئة.

الإعداد اليدوي

إن كنت تفضل التعديل بنفسك، يجب أن يحتوي ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml) بالضبط:

model = "gpt-5.6-sol"
model_provider = "teamsoclo"

[model_providers.teamsoclo]
name = "TeamSocLo"
base_url = "https://gpt.teamsoclo.site/v1"
env_key = "TEAMSOCLO_API_KEY"
wire_api = "responses"
requires_openai_auth = false

ويجب أن يحمل متغير البيئة TEAMSOCLO_API_KEY مفتاحك.

احتفظ بـ wire_api = "responses". Codex يستخدم Responses API؛ التبديل إلى chat سيكسره.

افتح مجلد الإعداد سريعاً:

open ~/.codex

xdg-open ~/.codex

explorer "$env:USERPROFILE\.codex"

تغيير النموذج

باقة GPT Astra تستخدم gpt-astra. عدِّل السطر الأول من config.toml وأعد تشغيل Codex:

model = "gpt-astra"

مفتاح GPT الذي يستدعي gpt-astra يُعيد “no available channel”، والعكس صحيح. النموذج يتبع الباقة التي اشتريتها، انظر النماذج والباقات.

إلغاء التثبيت

macOS / Linux
Windows

perl -ni -e 'print unless /TEAMSOCLO_API_KEY/' ~/.zshrc ~/.bashrc 2>/dev/null; launchctl unsetenv TEAMSOCLO_API_KEY 2>/dev/null; rm -rf ~/.codex; npm uninstall -g @openai/codex

reg delete "HKCU\Environment" /v TEAMSOCLO_API_KEY /f; Remove-Item -Recurse -Force "$env:USERPROFILE\.codex"; npm.cmd uninstall -g @openai/codex

للإبقاء على Codex لكن العودة للإعداد السابق، انسخ config.toml.bak.<timestamp> فوق config.toml.

إن لم يعمل

فتحتَ طرفية جديدة أو أغلقتَ VS Code كلياً بعد التثبيت.
echo $TEAMSOCLO_API_KEY (Windows: echo %TEAMSOCLO_API_KEY% في cmd) يطبع المفتاح كاملاً.
base_url ينتهي بـ /v1، wire_api هو responses.
المفتاح لا يزال صالحاً وله رصيد: تحقق هنا.
وإلا انظر استكشاف الأخطاء، فيه قسم خاص بـ Codex.

البدء

الإعداد

الدعم

تثبيت بأمر واحد

ماذا يفعل السكريبت

بعد التثبيت

الإعداد اليدوي

تغيير النموذج

إلغاء التثبيت

إن لم يعمل

​تثبيت بأمر واحد

​ماذا يفعل السكريبت

​بعد التثبيت

​الإعداد اليدوي

​تغيير النموذج

​إلغاء التثبيت

​إن لم يعمل

تثبيت بأمر واحد

ماذا يفعل السكريبت

بعد التثبيت

الإعداد اليدوي

تغيير النموذج

إلغاء التثبيت

إن لم يعمل