أقسام قاعدة المعرفة ▾

التنقل

الفئات

للمبتدئين 6

للمستثمرين 12

الأدوات

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

Codex CLI — مساعد وكيلي من OpenAI، يعيش مباشرة في الطرفية (terminal): يقرأ ملفات المشروع، يشغل الأوامر في بيئة معزولة (sandbox)، يعدل الكود ويشرح ما فعله. عادةً ما يتصل بنماذج OpenAI عبر اشتراك ChatGPT، ولكن يمكنك استبدال المزود بمزودك الخاص — وعندها ستقوم شبكة Gonka بحساب نفس السيناريوهات.

هناك تفصيل واحد يجعل Codex مميزاً بين أدوات الوكلاء: فهو لا يتحدث عبر Chat Completions المعتاد، بل عبر Responses API — بروتوكول OpenAI الجديد. ولهذا السبب لم يكن من الممكن توصيله ببوابة طرف ثالث من قبل. بوابة JoinGonka Gateway تقبل Responses منذ 22 أغسطس 2026، وكل ما هو موضح أدناه تم التحقق منه بتشغيل حي، وليس مجرد إعادة سرد للوثائق.

ما هو Codex CLI وما الذي يميزه عن الدردشة

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

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

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

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

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

التوصيل: تعديل واحد في config.toml

الطريق السريع — المُثبِّت. الأمر npx @joingonka/setup --tool codex سيضيف بنفسه إلى ~/.codex/config.toml كتلة المزوّد مع wire_api = "responses"، والنموذج ونافذة سياقه الحقيقية، مع الحفاظ على تعليقاتك وبقية إعداداتك، ثم يتحقق بطلب مباشر من المفتاح والنموذج. وإذا كان في الإعداد مزوّد آخر مختار، فلن يمسّه المُثبِّت وسيقترح عليك أمرًا للتشغيل لمرة واحدة. وهو يضع المفتاح مباشرة في الملف (بصلاحيات 600)، في حقل experimental_bearer_token — الحقل الوحيد الذي قد يخزّن فيه Codex المفتاح كنص حرفي؛ ويعتبره Codex نفسه تجريبيًا. أما الطريقة اليدوية أدناه فتستعيض عنه بمتغير بيئة.

يخزّن 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-your-key

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

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

التحقق: ما الذي يجب أن يحدث

أسرع طريقة للتأكد من أن الاتصال يعمل هي تجربة تشغيل واحدة:

codex exec "Answer in one line: what is 17*3?"

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

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

codex exec "Read calc.py and tell me in one sentence whether it has a bug."

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

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

ما تراه	ماذا يعني	ما الذي تفعله
`401 Unauthorized: Invalid API key`	لم يجد Codex المفتاح أو استخدم مفتاحًا خاطئًا	تأكّد من أن المتغيّر المذكور في `env_key` مُصدَّر فعلًا في الصدفة الحالية وأن اسمه يطابق الإعدادات
`404` على `/responses`	اللاحقة مفقودة في `base_url`	يجب أن ينتهي العنوان بـ `/v1` — فـ Codex يضيف `/responses` من تلقاء نفسه
الموديل يرد لكن الأدوات لا تُستدعى	لم يُضبط `wire_api`، فالحوار يجري وفق البروتوكول القديم	أضف `wire_api = \"responses\"` إلى كتلة المزوّد
`Reconnecting… 1/5`	Codex يعيد الطلب من تلقاء نفسه	سلوك طبيعي عند خطأ شبكي عابر؛ وإذا استُنفدت المحاولات، فاقرأ نصّ الخطأ أسفلها
تحذير بشأن bubblewrap	النظام لا يحتوي على حزمة العزل	لا يعطّل العمل: سيستخدم Codex نسخة مدمجة. وللاطمئنان، ثبّت `bubblewrap` عبر مدير الحزم

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

أي نموذج تختار

جميع نماذج الشبكة متاحة بسعر واحد، لذا فإن الاختيار يتعلق بالسلوك وليس الميزانية. أدناه نتيجة تشغيل حي لنفس المهمة (قراءة ملف والبحث عن خطأ فيه) عبر Codex على DeepSeek V4 Flash و MiniMax M2.7؛ وصل GLM-5.3 Flash إلى الشبكة بعد التشغيل — خصائص النموذج مذكورة له.

النموذج	المعرف	السياق	السلوك في Codex
DeepSeek V4 Flash	`deepseek-ai/DeepSeek-V4-Flash-0731`	380K	الإجابة نظيفة ومباشرة، مع تحديد الملف والسطر. واحد من أطول السياقات في الشبكة وسقف إجابة 32768 رمزاً — احتياطي للمستودعات الكبيرة
MiniMax M2.7	`MiniMaxAI/MiniMax-M2.7`	200K	يحل المهمة بشكل صحيح، لكنه أحياناً يظهر مسار التفكير بصوت عالٍ — في الطرفية يبدو الأمر مطولاً
GLM-5.3 Flash	`zai-org/GLM-5.3-Flash`	390K	نموذج استدلال مع أطول سياق في الشبكة: يفكر قبل كل إجابة، لذا الإجابة أطول وتصل متأخرة. يستدعي الأدوات، بما في ذلك الجولات المتكررة؛ للمهام القصيرة اضبط `reasoning_effort: low`

التوصية الافتراضية هي DeepSeek V4 Flash: العمل الوكيل يصطدم بسرعة بحجم السياق، و 380 ألف رمز تمنح القدرة على الاحتفاظ بالعديد من الملفات في الذاكرة في وقت واحد. إذا كانت المهمة تتطلب التفكير في منطق معقد — خذ GLM-5.3 Flash، ولكن ضع احتياطياً لـ max_tokens: جزء من ميزانية الإجابة يذهب للاستدلال. يتم تغيير النموذج بسطر واحد model في الملف التكويني أو عبر العلم -c model=… دون تعديل الملف.

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

كم يكلف ذلك

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

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

السيناريو	الاستهلاك	عبر Gateway
مهمة لمرة واحدة (قراءة ملف، العثور على خطأ)	~20K توكن	أجزاء من السنت
يوم عمل نشط	3-7M توكن	حوالي سنت
شهر تطوير نشط	~150M توكن	بضعة سنتات

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

الطريقة	نموذج الدفع	ما الذي يقيد
اشتراك ChatGPT	مبلغ ثابت شهريًا	حصص لعدد الطلبات ونوافذ تحديثها
مفتاح OpenAI المباشر	مقابل التوكنات حسب سعر البائع	السعر لكل مليون توكن أعلى بثلاث مراتب
JoinGonka Gateway	مقابل التوكنات، الرصيد	الاستهلاك مرئي في المكتب الشخصي، لا توجد حصص لعدد الطلبات

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

ما يجب مراعاته في العمل

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

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

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

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

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

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

Codex CLI هو الوحيد من بين الوكلاء الشائعين الذي يتحدث بـ Responses API، وهذا هو سبب بقائه مرتبطاً باشتراك OpenAI لفترة طويلة. استبدال المزود يستغرق خمسة أسطر في config.toml: عنوان البوابة، اسم المتغير مع المفتاح، و wire_api = "responses". بعد ذلك، يتم حساب نفس عمليات التشغيل المستقلة على الكود الخاص بك بواسطة شبكة Gonka بسعر الرموز الفعلية، بدون حصص أو نوافذ زمنية مدتها خمس ساعات. أكد التشغيل الحي دورة وكيل كاملة على جميع نماذج الشبكة الثلاثة؛ افتراضياً يجب أخذ DeepSeek V4 Flash — واحد من أطول سياقات الشبكة وأكبر سقف استجابة.

← Pi + بوابة JoinGonka — وكيل طرفية على استدلال رخيص DeepSeek Harness: مزودك الخاص عبر JoinGonka Gateway →

تريد معرفة المزيد؟

استكشف الأقسام الأخرى أو ابدأ في كسب GNK الآن.

احصل على مفتاح ورموز مجانية →