دليل نشر Codex
نزّل CC Switch المناسب لنظامك، وأدخل مفتاح API من Guishu AI، ثم اختبر الاتصال بالحصول على أول رد في Codex CLI.
1. تنزيل CC Switch وفتحه
تُدخل إعدادات API في CC Switch، وتستخدم Codex CLI للمحادثة مع النموذج من الطرفية. اختر حزمة CC Switch 4.0.25 المناسبة لجهازك.
- Windows x64 · تنزيل MSI هذا هو الخيار المناسب لمعظم أجهزة Intel وAMD. انقر مرتين على ملف
.msiالذي نزّلته وأكمل التثبيت، ثم افتح CC Switch من قائمة «ابدأ». - Windows ARM64 · تنزيل MSI انتقل إلى «الإعدادات»، ثم «النظام»، ثم «حول». اختر هذه الحزمة إذا ظهر معالج ARM في خانة «نوع النظام».
- macOS · تنزيل DMG تناسب الحزمة أجهزة Mac بمعالجات Intel وشرائح Apple. انقر مرتين على ملف
.dmg، واسحب CC Switch إلى مجلد «التطبيقات»، ثم افتحه من هناك. - Linux · اختيار الحزمة وسّع قائمة Assets واختر المعمارية وفق نتيجة الأمر
uname -m. إذا كانت النتيجةaarch64، فاخترarm64. نزّل ملف.debعلى Ubuntu وDebian أو ملف.rpmعلى Fedora.
نزّلت ملفًا آخر؟ يحتوي الملف v3.12.2-en.md على ملاحظات الإصدار. إذا لم تجد بعد فك الضغط سوى CC-SWITC.14، فاترك امتداده كما هو ونزّل حزمة نظامك من الروابط أعلاه. تجد الإصدارات الأخرى في صفحة الإصدارات الرسمية.
2. تثبيت Codex CLI
افتح «موجّه الأوامر» في Windows أو «الطرفية» في macOS وLinux. إذا سبق لك تثبيت Codex، فنفّذ الأمر codex --version. عند ظهور رقم الإصدار يمكنك الانتقال إلى الخطوة 3.
إذا كانت هذه المرة الأولى، فثبّت Node.js LTS ثم أعد فتح الطرفية ونفّذ الأمرين التاليين بالترتيب. يُفترض أن يعرض الأمر الثاني codex-cli ورقم الإصدار.
npm install -g @openai/codex@latest
codex --version3. إدخال إعدادات Guishu AI في CC Switch
اختر Codex من الشريط الجانبي. افتح تبويب Direct، ثم اضغط Add Provider (+) واختر Custom Configuration من قسم All.
| الحقل | القيمة المطلوبة |
|---|---|
| اسم المزوّد | اكتب «Guishu AI» لتجده بسهولة في القائمة. |
| عنوان طلبات API | https://api.llm-token.cn/v1 مع إبقاء /v1 في نهاية العنوان. |
| API Key | ألصق مفتاح API الذي حصلت عليه من Guishu AI كاملًا. |
| النموذج الافتراضي | انسخ من قائمة النماذج معرّف نموذج يدعم Responses ويتيح مفتاحك استخدامه، مثل gpt-6.1-terra. |
اضغط Add أسفل الصفحة. ارجع إلى تبويب Direct واضغط Switch على بطاقة Guishu AI. إذا كنت تستخدم وضع التوجيه أو التجميع فسيظهر الزر باسم «Back to direct and use». يمكنك فتح Codex عندما تعرض البطاقة الحالة In use.
4. اختبار أول رد في الطرفية
إذا كان Codex مفتوحًا، فأنهِ الجلسة الحالية. انتقل في الطرفية إلى مجلد مشروعك وشغّل codex. وإن لم يكن لديك مشروع بعد، يمكنك البدء بمجلد فارغ:
mkdir my-codex-project
cd my-codex-project
codexاكتب في Codex «أجب بكلمة OK فقط». وصول الرد يؤكد اكتمال الطلب. يُحتسب الاختبار من حصة مفتاحك.
لم يصلك رد؟ عند ظهور الخطأ 401، ألصق مفتاح API مرة أخرى وتأكد من أنه مفعّل. إذا كان النموذج غير متاح، فتحقق من معرّف النموذج الافتراضي ومن صلاحيات المفتاح. إذا تعذّر العثور على نقطة الاتصال، فتأكد من أن العنوان ينتهي بـ /v1، وأن تنسيق الطلب المرسل إلى المزوّد مضبوط على OpenAI Responses في الإعدادات المتقدمة.
اختياري: تحرير ملفات الإعداد يدويًا
إذا وصلك الرد بعد الإعداد باستخدام CC Switch فقد انتهيت. للإعداد اليدوي، حرّر الملفين التاليين داخل %USERPROFILE%\.codex\ على Windows أو ~/.codex/ على macOS وLinux. أنشئ المجلد أولًا إذا لم يكن موجودًا. إذا كانت لديك ملفات إعداد سابقة، فاحتفظ بنسخة احتياطية منها وأبقِ الإعدادات الأخرى.
config.toml — حدّد المزوّد والعنوان والنموذج الذي يستطيع مفتاحك الوصول إليه.
model_provider = "gpt-agent"
model = "gpt-6.1-terra"
[model_providers.gpt-agent]
name = "LLM API Gateway"
base_url = "https://api.llm-token.cn/v1"
wire_api = "responses"
requires_openai_auth = trueauth.json — استبدل قيمة المثال بمفتاح API الخاص بك من Guishu AI، ثم احفظ الملف وأعد تشغيل Codex كما في الخطوة 4.
{
"OPENAI_API_KEY": "YOUR_API_KEY"
}