دليل التثبيت غير المتصل لـ Codex CLI

دليل تثبيت غير متصل لـ Codex CLI على Windows وmacOS، مع شرح بنية الحزمة وسكربتات الإعداد والمشكلات الشائعة وكيفية تجهيز API key منخفضة التكلفة.

دليل التثبيت غير المتصل لـ Codex CLI

هذا الدليل مخصص للمستخدمين الجدد الذين يريدون تثبيت Codex CLI بدون الاعتماد على شبكة خارجية مستقرة والبدء في استخدامه مباشرة بعد الإعداد.

لمن هذا الدليل

من يريد تجربة Vibe Coding بدون الاعتماد على اتصال قوي بالإنترنت

من يستخدم Codex CLI لأول مرة ويريد مسار تثبيت واضحًا

الفرق التي تحتاج إلى حزمة offline قابلة للتوزيع على الزملاء أو الأصدقاء

ما الذي يجب تجهيزه قبل التثبيت

يجب أن يحتوي الجهاز الهدف مسبقًا على Node.js وnpm. تحقق منهما أولًا من الطرفية.

node -v
npm -v

بنية الحزمة

الحزمة offline مقسمة حسب المنصة: windows-x64 وmacos-arm64 وmacos-x64. كل مجلد يتضمن الحزمة الرئيسية وحزمة المنصة وسكربتات التثبيت والإعداد.

حدد منصتك أولًا

Windows

معظم أجهزة Windows العادية تستخدم windows-x64.

macOS

استخدم macos-arm64 لأجهزة Apple Silicon وmacos-x64 لأجهزة Intel. على macOS يمكنك استخدام uname -m للتأكد.

uname -m

خطوات التثبيت على Windows x64

الخطوة 1: ادخل إلى مجلد التثبيت offline

cd "your-path\codex-npm-offline\windows-x64\npm-offline"

الخطوة 2: شغّل سكربت التثبيت

.\install-codex-windows-x64.cmd

الخطوة 3: ثبّت يدويًا عند الحاجة

npm install -g .\codex-npm-0.121.0-alpha.6.tgz @openai/codex-win32-x64@file:.\codex-npm-win32-x64-0.121.0-alpha.6.tgz

الخطوة 4: تحقق من نجاح التثبيت

codex --version

شغّل سكربت الإعداد

.\run-codex-setup.cmd

بعد التثبيت، سيطلب منك سكربت الإعداد إدخال Base URL وAPI key.

سيكتب الإعداد في ملفات تكوين Codex الأساسية، وغالبًا ينشئ نسخًا احتياطية قبل الكتابة فوق الملفات الموجودة.

~/.codex/config.toml
~/.codex/auth.json

تثبيت macOS Apple Silicon

cd "/your-path/codex-npm-offline/macos-arm64/npm-offline"
bash ./install-codex-macos-arm64.sh

إذا كنت تفضل التثبيت اليدوي، يمكنك استخدام npm لتثبيت الحزمة الرئيسية وحزمة المنصة.

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-arm64@file:./codex-npm-darwin-arm64-0.121.0-alpha.6.tgz

تثبيت macOS Intel

cd "/your-path/codex-npm-offline/macos-x64/npm-offline"
bash ./install-codex-macos-x64.sh

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-x64@file:./codex-npm-darwin-x64-0.121.0-alpha.6.tgz

المشكلات الشائعة

عدم العثور على أمر codex بعد التثبيت

أغلق الطرفية الحالية وافتح طرفية جديدة ثم شغّل codex --version مرة أخرى.

Windows يمنع تشغيل السكربت

استخدم مدخل سكربت الإعداد لأنه يستدعي PowerShell مع ExecutionPolicy Bypass.

macOS يقول إن السكربت غير قابل للتنفيذ

شغّل سكربتات shell مباشرة عبر bash بدل النقر المزدوج عليها.

كيف تحصل على API key مستقرة ومنخفضة التكلفة

إذا كنت لا تزال بحاجة إلى مفتاح مزود، فقم بالتسجيل، وراجع مجموعات النماذج والأسعار، وأنشئ API token، ثم انسخ Base URL وAPI key إلى مسار الإعداد.

أقصر مسار للاستخدام

ثبّت حزمة المنصة الصحيحة

شغّل سكربت الإعداد وأدخل Base URL وAPI key

ابدأ Codex عبر codex أو استخدم codex --yolo لنمط تنفيذ أكثر مباشرة

codex
codex --yolo