يستخدم Codex CLI واجهة OpenAI Responses API، وليس /v1/chat/completions. يتطلب تكامل GetVibe ضبط wire_api = "responses"؛ فعنوان URL الأساسي الخاص بـ chat-completions المنسوخ إلى مثال عام لـ SDK ليس بديلاً عن ذلك. تتم صيانة الإعداد المُنشأ في وثائق Codex CLI، ويمكن تحديثه من /api/integrations/codex.toml.
التثبيت وضبط المفتاح
ثبّت CLI وأنشئ دليل الإعداد الخاص به. احتفظ بمفتاح API في البيئة، وليس داخل ملف TOML:
npm install -g @openai/codex
mkdir -p ~/.codex
export GETVIBE_API_KEY="your-dashboard-key"أضف كتلة الموفر هذه إلى ~/.codex/config.toml:
model = "gpt-5.6-luna"
model_provider = "getvibe"
model_reasoning_effort = "medium"
model_reasoning_summary = "auto"
model_context_window = 786432
[model_providers.getvibe]
name = "GetVibe"
base_url = "https://getvibeapi.com/v1"
env_key = "GETVIBE_API_KEY"
wire_api = "responses"
request_max_retries = 4
stream_max_retries = 5
stream_idle_timeout_ms = 600000لا تضع $GETVIBE_API_KEY في قيمة TOML. يقرأ Codex المتغير الذي يحدده env_key؛ أما النص داخل ملف الإعداد فلا يخضع لتوسعة shell. ولإعداد تديره الفرق، وفّر متغير البيئة من خلال ملف تعريف shell أو مدير الأسرار الذي يشغّل Codex.
اختيار نموذج يدعم Responses
يُبنى إعداد Codex المُنشأ من الكتالوج المنشور، ويوصي بنموذج للبرمجة بالإضافة إلى profiles للمهام السريعة والعميقة. قبل اختيار نموذج آخر، تحقق من إدراجه في Responses API ومن امتلاكه حد السياق الذي تنوي ضبطه. في لقطة الكتالوج التي تم التحقق منها في 3 أكتوبر 2026، يبلغ سعر GPT-6 Luna $0.0055 الإدخال · $0.0274 الإخراج لكل مليون رمز، وسعر GPT-6 Sol $0.1096 الإدخال · $0.548 الإخراج لكل مليون رمز، وسعر GPT-6.1 Sol $0.1096 الإدخال · $0.548 الإخراج لكل مليون رمز لكل مليون من رموز الإدخال والإخراج. تُعرض كل قيمة من صفحة النموذج المباشرة.
يكون profile مفيداً عندما تختلف فئات المهام في التكلفة واحتياجات الاستدلال. احتفظ بـ profile سريع للملخصات أو رسائل commit، وبـ profile أعمق للتغييرات التي تشمل عدة ملفات. يوضح الإعداد المُنشأ للمشروع هذا النمط، ويحدّث المعرّفات الموصى بها مع تغيّر الكتالوج العام. لا تعدّل نافذة السياق يدوياً لتتجاوز الحد الذي تدعمه صفحة النموذج؛ فقد يرسل Codex عندها طلباً يتجاوز الحجم المسموح ويفشل لدى الخدمة upstream.
التحقق باستخدام مهمة للقراءة فقط في المستودع
شغّل Codex في نسخة checkout مؤقتة. اطلب منه شرح دالة واحدة من دون تعديلها. تأكد من أنه يستخدم موفر GetVibe ومن اكتمال الطلب. ثم اطلب منه تصحيحاً صغيراً مع مراجعة صريحة للصلاحيات. إذا أبلغ CLI عن غياب موفر، فتحقق من اسم الجدول الدقيق ومن تطابق model_provider معه. وإذا فشلت المصادقة، فتحقق من وجود GETVIBE_API_KEY في shell نفسه الذي يشغّل Codex.
عندما تفيد الاستجابة بأنه لا يستطيع استخدام الأدوات، تحقّق أولاً من دعم النموذج المحدد لـ Responses ومن إصدار CLI. ظهور معرّف نموذج في الكتالوج العام لا يعني أن كل البروتوكولات متاحة له. احتفظ بمعرّف النموذج الدقيق في السجلات، حتى يمكن تمييز فشل الأداة من فشل نقطة النهاية أو المصادقة.
التحكم في السياق وتكلفة الوكيل
يقرأ Codex ملفات المستودع ويرسل نتائج الأدوات مجدداً كجزء من محادثته. استبعد المخرجات المُنشأة وأدلة التبعيات من خلال إعدادات التجاهل، واطلب منه فحص المسارات ذات الصلة فقط، وتجنب تكرار مواصفة ضخمة في كل prompt. تشمل تكلفة مهمة الوكيل كل دور، وليس التصحيح النهائي فقط. قارن الاستخدام في لوحة التحكم بعد تنفيذ مهمة تمثيلية مع معدلات الإدخال والإخراج في صفحة النموذج.
لإجراء مقارنة عادلة بين النماذج، استخدم commit المستودع نفسه، وprompt نفسه، وسياسة الموافقة نفسها، والاختبارات نفسها. استخدم إصلاحاً لخلل ومهمة تشمل عدة ملفات، ثم قيّم نجاح الاختبارات وعدد جولات الإصلاح. يظهر سعر GPT-6 Luna في الكتالوج في 3 أكتوبر 2026 عند $0.0055 الإدخال · $0.0274 الإخراج لكل مليون رمز؛ وتعتمد فاتورة الطلب الفعلية على مقدار السياق والمخرجات التي تستخدمها المهمة.
Profiles والإعدادات الافتراضية الآمنة
ابدأ باستدلال medium لمهمة برمجة عادية، ثم قارن low للسرعة وhigh للاستدلال الصعب عندما يدعم النموذج هذه الإعدادات. قد يؤدي المزيد من الاستدلال إلى زيادة استهلاك المخرجات. تجنب ضبط سياق عام ضخم بدافع العادة؛ إذ يختار الملف المُنشأ نافذة محسوبة ومحددة للنموذج. أبقِ سلوك الموافقة في Codex مفعّلاً إلى أن تفهم الأوامر التي يقترحها.
إذا بدأ CLI بنجاح لكنه لم يصل إلى GetVibe مطلقاً، فافحص الإعداد الفعلي، لا الملف الذي عدّلته فقط: قد يكون Codex قد شُغّل باستخدام profile آخر أو موقع إعداد مختلف. نفّذ طلباً غير مؤذٍ، وتحقق من الاستخدام في لوحة التحكم، ثم استخدمه فقط بعد ذلك على مستودع ذي قيمة.
استخدام Profiles لفئات المهام المتكررة
تتيح Codex profiles للفريق الاحتفاظ بموفر واحد مع تغيير النموذج وجهد الاستدلال لمهمة معينة. يمكن لـ profile سريع تلخيص diff أو إعداد رسالة commit، بينما يستطيع profile عميق التحقيق في عطل يشمل عدة ملفات. احتفظ باسم profile في الأمر الذي يوثقه فريقك، حتى لا يقارن مطوران إعدادات افتراضية مختلفة من دون علمهما. يجب أن تستخدم Profiles معرّفات نماذج منشورة حالياً ومتوافقة مع Responses.
يوفر إعداد GetVibe المُنشأ نمطاً لـ profiles سريعة وعميقة، لكنه قد يتغير مع تغيّر التوصية. حدّثه من نقطة النهاية الموثقة بدلاً من نسخ حد سياق قديم للنموذج. قد يضغط Codex السجل وفقاً لنافذة السياق المضبوطة، لذلك يمكن لنافذة أكبر من الحد الذي يقبله المسار أن تحوّل المهام الطويلة إلى أخطاء في الطلب بدلاً من توفير سياق مفيد.
الحفاظ على تركيز سياق المستودع
قبل تشغيل الوكيل، تحقق من أن قواعد التجاهل تستبعد ذاكرات التخزين المؤقت للحزم، ومخرجات البناء، وعملاء API المُنشئين، والملفات الاختبارية الكبيرة. أخبر Codex بالحزمة أو الاختبار الذي ينبغي فحصه أولاً. بالنسبة إلى خلل، اطلب منه إعادة إنتاج الفشل، وتسمية الملفات التي يخطط لتغييرها، ثم تنفيذ أصغر تصحيح وتشغيل الاختبار. يقلل ذلك من مخرجات الأدوات المتكررة ويجعل النتيجة أسهل للمراجعة.
لإجراء مقارنة عادلة للتكلفة، شغّل prompt نفسه على commit نفسه. أدرج مهمة لا تحتاج إلى تعديل حتى تتمكن من معرفة ما إذا كان الوكيل يحترم الحدود، ومهمة تتطلب تشغيل اختبار حتى تتمكن من احتساب حلقات الإصلاح. سجّل استخدام الرموز وما إذا كان التصحيح قد نجح، وليس طول الاستجابة النهائية فقط.
ميزانيات الاستدلال والمخرجات
استخدم أقل جهد استدلال يحقق مستوى الجودة المستهدف. يكون الجهد العالي مفيداً لبعض مهام التخطيط، لكنه قد يزيد زمن الاستجابة واستهلاك المخرجات. اضبط ميزانية مخرجات كبيرة بما يكفي للتصحيح المطلوب وشرحه من دون تركها غير محدودة. عندما تتوقف الاستجابة مبكراً، افحص سبب الإنهاء قبل تكرار الطلب بالكامل؛ فقد يستخدم الاستمرار الموجّه سياقاً أقل.
حافظ على تحفظك في الموافقات التلقائية على الأوامر. قد يقترح Codex أمراً مدمراً في shell أو يغيّر ملفات خارج النطاق المقصود. راجع diff ومخرجات الاختبار قبل قبوله، حتى عندما يبدو ملخص الاستدلال واثقاً.
الأخطاء الشائعة
- نقطة النهاية الخاطئة: يجب أن ينتهي عنوان URL الأساسي بـ
/v1، ويجب أن تكون قيمةwire_apiهيresponses. - 401: صدّر
GETVIBE_API_KEYفي بيئة العملية؛ لا يوسّع TOML متغيرات shell. - خطأ في السياق: طابق
model_context_windowمع الصفحة المنشورة للنموذج المختار. - اختلاف سلوك الأدوات: اختبر نموذجاً متوافقاً مع Responses وحافظ على تحديث إصدار CLI.
للاطلاع على حقول طلبات JSON، راجع Messages and Responses؛ وللأرصدة والقياس، راجع وثائق الاستخدام.