Codex: تثبيت Codex وإعداده

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

يقدم Codex طرق تثبيت متعددة. اختر الأنسب لنظام التشغيل وسير عملك.

📋 المتطلبات المسبقة: معرفة أساسية بسطر الأوامر، تثبيت Node.js (مطلوب لطريقة CLI)

1. نظرة عامة على طرق التثبيت

2. Codex App (تطبيق سطح المكتب)

الطريقة الأبسط — نزّل تطبيق سطح المكتب مباشرة.

زُر https://chatgpt.com/codex ونزّل التطبيق لمنصتك.

(1) خطوات التثبيت

1. Visit chatgpt.com/codex
2. Click "Download for macOS/Windows"
3. Install the application
4. Log in with your ChatGPT account
5. Start using

(2) أول تشغيل

بعد تسجيل الدخول، سترى واجهة بثلاث لوحات: قائمة المهام على اليسار، نافذة المحادثة في الوسط، ومنطقة متعددة الوظائف على اليمين.

Codex App يستخدم تخطيطًا كلاسيكيًا بثلاث لوحات: قائمة مهام + نافذة محادثة + منطقة متعددة الوظائف.

3. Codex CLI (سطر الأوامر)

الطريقة الأكثر شعبية بين المطورين. يعمل CLI محليًا — كودك لا يُرفع إلى السحابة.

(1) التثبيت

# Install via npm
sudo npm install -g @openai/codex

# Mirror acceleration (China)
sudo npm install -g @openai/codex --registry=https://registry.npmmirror.com

(2) تسجيل الدخول

أول تشغيل يتطلب المصادقة. ثلاثة خيارات:

الخيار 1: تسجيل دخول ChatGPT (موصى به)

codex
# Select "Sign in with ChatGPT"
# Browser opens the login page automatically

الخيار 2: تسجيل دخول بمفتاح API

# macOS/Linux temporary
export OPENAI_API_KEY="sk-your-api-key"

# Permanent (add to shell config)
echo 'export OPENAI_API_KEY="sk-your-api-key"' >> ~/.zshrc
source ~/.zshrc

# Windows PowerShell
$env:OPENAI_API_KEY="sk-your-api-key"

# Launch with specific model
codex --model gpt-5-codex

الخيار 3: ملف auth.json

mkdir -p ~/.codex
cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "sk-your-api-key"
}
EOF

(3) أول تشغيل

cd my-project
codex
# Enter: Analyze the current project structure

▶ مثال 1: أول تجربة لأليس

# Alice creates a test project
mkdir codex-test && cd codex-test

# Create a simple file
echo 'print("Hello World")' > test.py

# Launch Codex
codex

# Alice enters:
# "Add command-line argument support to test.py, support --name parameter"

4. أوضاع التشغيل الثلاثة

يوفر Codex CLI ثلاثة أوضاع أمنية:

# Default mode
codex

# Auto Edit mode
codex --auto-edit

# Full Auto mode
codex --full-auto

▶ مثال 2: اختيار الوضع

def choose_mode(task_risk, task_complexity):
    if task_risk == "high":
        return "Suggest - confirm each action for safety"
    elif task_complexity == "low":
        return "Full Auto - simple tasks done quickly"
    else:
        return "Auto Edit - files auto-edited, commands human-reviewed"

5. تثبيت Homebrew (موصى به لـ Mac)

# Install
brew install --cask codex

# Run
codex

مثالي لمطوري Mac الذين لا يريدون تثبيت Node.js.

6. تثبيت حزمة Binary

نزّل مباشرة من GitHub Release:

# Download URL: https://github.com/openai/codex/releases

# Mac Apple Silicon
tar -xzf codex-aarch64-apple-darwin.tar.gz

# Linux
tar -xzf codex-x86_64-unknown-linux-musl.tar.gz

# Add to PATH
sudo mv codex /usr/local/bin

# Run
codex

7. تثبيت إضافة IDE

يدعم VS Code و Cursor و Windsurf وبيئات تطوير أخرى.

(1) خطوات التثبيت

1. Open your IDE's extension marketplace
2. Search for "Codex"
3. Install the plugin
4. Log in with your ChatGPT account

(2) ميزات IDE

• إصلاح الكود تلقائيًا
• توليد الدوال تلقائيًا
• إعادة هيكلة الكود تلقائيًا
• النقر بزر الماوس الأيمن على الكود المحدد لإرساله إلى Codex

8. التحديث وإلغاء التثبيت

# CLI update
npm update -g @openai/codex

# Force reinstall latest
npm install -g @openai/codex@latest

# Uninstall
npm uninstall -g @openai/codex

# Homebrew uninstall
brew uninstall --cask codex

9. دعم الأنظمة

10. مشاكل الشبكة

قد يواجه المستخدمون في الصين عوائق شبكية عند الوصول إلى Codex. ضع في اعتبارك:

• استخدام وسيط شبكة
• تجربة منتجات مشابهة مثل Alibaba Qoder Quest أو ByteDance Trae Solo

❓ أسئلة شائعة

📖 ملخص

• خمس طرق تثبيت: App / CLI / Homebrew / Binary / إضافة IDE
• CLI هو الخيار الأول للمطورين — npm install -g @openai/codex يكفي بسطر واحد
• ثلاثة أوضاع أمنية: Suggest / Auto Edit / Full Auto
• أول تشغيل يتطلب تسجيل الدخول: تسجيل دخول ChatGPT (موصى به) / مفتاح API / auth.json
• يجب على مستخدمي Windows استخدام WSL

📝 تمارين

1. أساسي (⭐): ثبّت Codex CLI وسجّل الدخول بنجاح. التقط لقطة شاشة لواجهة أول تشغيل.
2. متوسط (⭐⭐): أكمل نفس المهمة باستخدام وضعي Suggest و Auto Edit، وقارن التجربة.
3. متقدم (⭐⭐⭐): ثبّت Codex CLI في بيئة WSL واكتب دليل استكشاف أخطاء التثبيت وإصلاحها.

فريق Web-Tutorial التقني

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

من نحن