الانتقال إلى المحتوى الرئيسي

​
نظرة عامة

تعد OpenAI Codex أداة سطر أوامر (CLI) مفتوحة المصدر تعمل كوكيل برمجة خفيف الوزن، وهي قادرة على قراءة الكود وتعديله وتشغيله في الجهاز الطرفي (terminal). تم بناؤها على نماذج GPT وهي محسنة لتوليد الكود.

​
متطلبات النظام

  • نظام التشغيل: macOS، Linux (دعم رسمي)، Windows عبر WSL
  • Node.js: الإصدار 18+
  • npm: الإصدار 10.x.x أو أحدث

​
التثبيت

sudo npm install -g @openai/codex@latest
التحقق من التثبيت: 
codex --version

​
التكوين

​
الخطوة 1: تعيين API Key

مؤقت (الجلسة الحالية): 
export OPENAI_API_KEY="sk-your-lemondata-key"
تكوين دائم: أضف إلى ~/.bashrc أو ~/.zshrc أو ~/.bash_profile: 
export OPENAI_API_KEY="sk-your-lemondata-key"
ثم قم بإعادة التحميل: 
source ~/.zshrc  # or source ~/.bashrc

​
الخطوة 2: تكوين config.toml

قم بتحرير ~/.codex/config.toml: 
model = "gpt-4o"
model_provider = "lemondata"

[model_providers.lemondata]
name = "LemonData"
base_url = "https://api.lemondata.cc/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"
إذا لم يكن ملف التكوين موجوداً، فقم بتشغيل codex مرة واحدة لإنشائه، ثم قم بتحرير الملف.

​
الاستخدام الأساسي

بدء الوضع التفاعلي: 
codex
أمر مباشر: 
codex "Fix the bug in main.py line 42"
تحديد النموذج: 
codex -m gpt-4o "Build a REST API server"

​
النماذج المتاحة

النموذجالأفضل لـ
gpt-4oمهام البرمجة المعقدة، الهندسة المعمارية
gpt-4o-miniالإصلاحات السريعة، المهام البسيطة
claude-sonnet-4-5مراجعة الكود، التوثيق
deepseek-r1تصميم الخوارزميات، الاستنتاج

​
الأوامر التفاعلية

الأمرالوصف
/helpعرض المساعدة
/exit أو Ctrl+Cخروج
/clearمسح المحادثة
/configعرض التكوين
/model <name>تبديل النموذج
/tokensعرض استخدام token

​
التحقق من التكوين

# التحقق من متغير البيئة
echo $OPENAI_API_KEY

# اختبار اتصال API
codex "Hello, Codex!"

# عرض التكوين
cat ~/.codex/config.toml

​
حالات الاستخدام الشائعة

مراجعة الكود: 
git diff | codex "Review these code changes"
توليد رسائل commit: 
git diff --staged | codex "Generate a commit message for these changes"
إصلاح الأخطاء: 
codex "Fix the TypeScript errors in src/components/"
شرح الكود: 
cat main.py | codex "Explain what this code does"

​
استكشاف الأخطاء وإصلاحها

  • تحقق من أن base_url في config.toml هو بالضبط https://api.lemondata.cc/v1
  • تحقق من اتصال الشبكة
  • تأكد من عدم وجود تداخل من بروكسي (proxy)
  • تحقق من تعيين متغير البيئة OPENAI_API_KEY
  • تحقق من أن المفتاح يبدأ بـ sk-
  • تأكد من أن المفتاح نشط في لوحة تحكم LemonData
  • تحقق من مطابقة اسم النموذج تماماً
  • تحقق من توفر النموذج في lemondata.cc/en/models