Codex CLI: مفتاحك الخاص بدلاً من الاشتراك

Codex ليس مجرد مساعد في المحرر، بل هو منفذ مستقل. أنت تصيغ المهمة بالكلمات، وهو يقرر بنفسه الملفات التي يجب قراءتها، والأوامر التي يجب تنفيذها وما الذي يجب تغييره. تحت تصرفه حوالي عشر أدوات: تشغيل الأوامر، قراءة الملفات، إدارة خطة العمل، طلب توضيح من المستخدم، إنشاء وكلاء فرعيين للمهام الفرعية.

وضعان للعمل. تفاعلي — codex بدون وسائط، حوار في الطرفية مع عرض كل خطوة. غير تفاعلي — codex exec «المهمة»، تشغيل لمرة واحدة حتى النتيجة: مريح في النصوص البرمجية و CI.

الأمان مدمج: بشكل افتراضي يعمل الوكيل في بيئة معزولة ويطلب التأكيد قبل التغييرات. يتم تحديد مستوى التحكم في الإعدادات — من «سؤال عن كل شيء» إلى تشغيل مستقل تماماً مع حق الكتابة في مجلد العمل.

ميزة أخرى هي حالة الحوار. لا يطلب Codex من الخادم تذكر أي شيء: فهو يحتفظ بالشريط بالكامل لديه ويرسله بالكامل مع كل خطوة. بالنسبة لك هذا يعني أن المراسلات لا تبقى في جانب مزود النموذج، وتغيير نقطة النهاية لا يكسر الجلسة التي بدأتها.

الاختلاف عن Claude Code ووكلاء الطرفية الآخرين هو البروتوكول تحديداً. يتواصل Codex مع النموذج عبر Responses API، حيث لا يتم وصف المراسلات بقائمة مسطحة من الرسائل، بل بشريط من العناصر: نص، استدعاء أداة، نتيجة الاستدعاء، كتلة استنتاج. هذا يمنح الأداة نموذج حوار أكثر صرامة، وبالنسبة لك حاجة لوجود نقطة نهاية تفهم هذا البروتوكول.

يخزن Codex الإعدادات في ~/.codex/config.toml. يتم وصف مزودك بكتلة [model_providers.*]، والحقل الرئيسي هنا هو wire_api: بدونه سيحاول Codex التحدث عبر Chat Completions ولن يجمع حلقة الوكيل.

# ~/.codex/config.toml
model_provider = "joingonka"
model = "deepseek-ai/DeepSeek-V4-Flash-0731"

[model_providers.joingonka]
name = "JoinGonka Gateway"
base_url = "https://gate.joingonka.ai/v1"
env_key = "JOINGONKA_API_KEY"
wire_api = "responses"

لا يتم كتابة المفتاح في الملف: env_key يسمي متغير البيئة الذي سيأخذ منه Codex المفتاح. اسم المتغير خاص بك، ليس OPENAI_API_KEY — هكذا لا يعترض الإعداد أدواتك الأخرى التي تعمل مع OpenAI.

export JOINGONKA_API_KEY=jg-مفتاحك

يحدد حقل model النموذج الافتراضي، و model_provider أي من الكتل الموصوفة يجب استخدامها. كلاهما يتم تجاوزهما لحظة التشغيل، لذا فإن ملف إعداد واحد يخدم بسهولة عدة مزودين: عملي، تجريبي، واحتياطي.

يتم إصدار المفتاح في الحساب الشخصي بعد التسجيل، وهناك أيضاً يمكن رؤية الرصيد والاستهلاك. إذا كنت تفضل عدم لمس الإعداد العام، يمكن تمرير نفس الكتلة لمرة واحدة عبر -c: codex -c model_provider=joingonka …. وللاحتفاظ بعدة إعدادات مستقلة، حدد مجلد الإعدادات في متغير CODEX_HOME.

أسرع طريقة للتأكد من أن الربط يعمل هي إجراء اختبار لمرة واحدة:

codex exec "أجب بسطر واحد: كم يساوي 17*3؟"

في ترويسة الرد، يطبع Codex من يعمل معه: model، و provider: joingonka، ووضع الحماية (sandbox)، ومعرف الجلسة. إذا كان المزود هو مزودك ووصل الرد في الأسفل، فإن الاتصال فعال.

بعد ذلك، يجب اختبار أهم ميزة يوضع Codex من أجلها، وهي العمل مع الملفات. ضع ملفًا صغيرًا يحتوي على خطأ واضح في المجلد واطلب منه العثور عليه:

codex exec "اقرأ calc.py وأخبرني بعبارة واحدة ما إذا كان هناك خطأ."

يجب على الوكيل استدعاء أداة القراءة بنفسه، وفتح الملف، والإجابة بشكل جوهري، مع تحديد السطر. إذا حدث هذا، فإن دورة الوكيل الكاملة (طلب ← استدعاء أداة ← نتيجة ← رد) عبر البوابة يتم تجميعها بشكل صحيح.

إذا حدث خطأ ما، فعادة ما يُقرأ التشخيص مباشرة من الرسالة:

قد يستغرق الطلب الأول في الجلسة بضع ثوانٍ: يرسل Codex مطالبة نظام كبيرة ووصفًا لجميع أدواته، ويحتاج عقدة الشبكة إلى قبول المهمة. الردود اللاحقة تصل بشكل أسرع.

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

التوصية الافتراضية هي DeepSeek V4 Flash: عمل الوكيل يواجه سرعان ما محدودية حجم السياق، وتوفر 380K توكن القدرة على الاحتفاظ بالعديد من الملفات في الذاكرة في وقت واحد. إذا كنت تريد ردودًا قصيرة للغاية، اختر Kimi K2.6. يمكن تغيير النموذج بسطر واحد model في ملف التكوين أو بعلامة -c model=… دون تعديل الملف.

القائمة الحالية لنماذج الشبكة متاحة دائمًا عبر GET https://gate.joingonka.ai/v1/models.

تستهلك أدوات الوكيل التوكنات بشكل مختلف عن الدردشة: لكل عبارة منك، يضيف Codex مطالبة النظام ووصفًا لجميع الأدوات، ثم يجري حوارًا متعدد الخطوات مع النموذج. في تشغيل حي، كلفت مهمة بسيطة "اقرأ ملفًا وابحث عن خطأ" حوالي 18-20 ألف توكن. هذا ثمن طبيعي للاستقلالية، ولهذا السبب فإن السعر لكل توكن هو الأهم.

عبر JoinGonka Gateway، تكلف التوكنات $0.0047 لكل مليون عند الإدخال و $0.014 لكل مليون عند الإخراج — السعر واحد لجميع نماذج الشبكة ويتم جلبه في هذه الصفحة من مصدر حي.

للمقارنة — كيف تعمل الخيارات المدفوعة لدى Codex نفسه ولدى المنافسين في نفس المجال:

يتم الدفع مقابل الاستهلاك الفعلي، بدون اشتراك شهري وبدون حصص لعدد الطلبات: لا توجد نوافذ مدتها خمس ساعات، ولا حد لـ "المطالبات"، ولا مضاعفات في ساعات الذروة. يتم شحن الرصيد بالعملة المشفرة، والرصيد المتبقي والاستهلاك حسب الأيام مرئيان في المكتب الشخصي. تحليل مفصل للاقتصاد - في المقالة عن أرخص API.

يقوم Codex نفسه بالاحتفاظ بسجل المحادثة. يقوم بإرسال السجل بالكامل مع كل طلب ولا يطلب من الخادم تذكر أي شيء - ونحن بدورنا لا نقوم بتخزين المراسلات. لا يتبقى الكود الخاص بك أو الأوامر (prompts) على البوابة (gateway) بعد استلام الرد.

البحث عبر الويب يعمل. يقوم Codex بالإعلان عن أداة البحث في كل طلب، وتقوم البوابة بقبوله: يتم تنفيذ البحث من جانبنا، ويتم دمج النتائج في رد النموذج.

الأدوات محلية وليست سحابية. يقوم Codex بتنفيذ الأوامر وقراءة الملفات محلياً على جهازك، لذا فإن الوصول إلى المشروع لا يعتمد على مزود النموذج.

بيئة معزولة (Sandbox). على نظام Linux، يستخدم Codex أداة bubblewrap لعزل الأوامر التي يتم تشغيلها. إذا لم تكن الأداة موجودة في النظام، سيقوم Codex بالتنبيه واستخدام نسخة مدمجة - هذا لا يؤثر على العمل، ولكن يفضل تثبيت الحزمة عبر مدير الحزم الخاص بالنظام.

إذا كنت بحاجة للعمل مع الصور - مثل لقطة شاشة لواجهة المستخدم أو مخطط في صورة - استخدم أداة مع نموذج لديه قدرات بصرية لهذه المهام: النماذج في شبكة Gonka هي نماذج نصية. بالنسبة للكود والأوامر والملفات، لا يعتبر هذا قيداً.

إذا لم يكن Codex مناسباً، يمكنك استخدام وكلاء طرفية آخرين: دليل البدء السريع لـ API يوضح كيفية توصيل أي أداة متوافقة في بضع دقائق.