من يشغّل Codex من داخل Claude Code لا يعرف كم بقي من حصته إلا إذا غادر الطرفية. تضيف codex-hud إلى شريط حالة Claude Code سطورًا تعرض المتبقي من نافذة الساعات الخمس والنافذة الأسبوعية وموعد إعادة ضبطهما، مع أوامر لاستهلاك الرموز والتكلفة. تعمل في Claude Code وحده لا في claude.ai، وتقرأ بيانات Codex من جهازك، ولا تطلب مفتاح API إلا لبيانات التكلفة واستهلاك المؤسسة.
ما الذي يظهر في شريط الحالة
عنوان باسم النموذج ومستوى الاستدلال في آخر دور لـ Codex، مثل gpt-5.5·xhigh، ثم شريطا الحصتين بنسبة المتبقي والوقت الباقي على إعادة الضبط، ثم شريط امتلاء نافذة السياق، وتنبيه LIMIT أحمر حين يبلّغ Codex ببلوغ الحد. يُحدَّث العرض كل ستين ثانية، وله أربعة تخطيطات: expanded وhorizontal وinline وcompact. وتقرأ الإضافة الحدود من سجلات Codex المحلية، أو من codex app-server في الإصدار 0.142 فأحدث لأنه لا يكتبها على القرص.
الأوامر الأحد عشر
تُكتب كلها بالبادئة codex-hud، مثل /codex-hud:setup.
- setup: يكتب مشغّل codex-hud-statusline.sh ويوجّه إليه statusLine في settings.json بعد حفظ شريطك السابق إن وُجد.
- configure: أسئلة لاختيار التخطيط والإعداد المسبق وصيغة موعد إعادة الضبط واللغة وعرض الشريط، مع معاينة قبل الحفظ.
- usage-today وusage-week وusage-month: جدول الرموز لليوم أو لآخر سبعة أيام أو ثلاثين يومًا.
- summary: سطر واحد يجمع رموز اليوم وجلساته ونسبتي الحصة.
- setup-key: يحفظ مفتاح OpenAI Admin بقراءته من الحافظة حتى لا يبقى في سجل المحادثة.
- costs-today وcosts-week وcosts-month: التكلفة بالدولار موزعة على بنود الفوترة، وتحتاج المفتاح.
- uninstall: يحذف المشغّل ويعيد شريط الحالة السابق.
مثال: أسبوع من Codex في جدول
يعرض /codex-hud:usage-week عنوان Codex Usage – Last 7 Days، ثم جدولًا لجلساتك المحلية بصفوف Input وCached Input وOutput وReasoning وTotal، ثم المتبقي من نافذتي الساعات الخمس والأيام السبعة مع نوع خطتك. ومع مفتاح Admin يضيف جدولًا لاستهلاك المؤسسة حسب النموذج.
التشغيل من الملف المضغوط
- فكّ الضغط في مجلد ثابت مع إبقاء الملفات المخفية مثل .claude-plugin؛ فالمشغّل يشير إلى هذا المجلد، وإن نقلته فأعد تشغيل setup.
- افتح Claude Code بالأمر
claude --plugin-dirوالمسار الكامل لمجلد plugin. هذا تحميل للجلسة لا تثبيت دائم، فأعده في كل جلسة تحتاج فيها الأوامر، أما شريط الحالة فيبقى بعد setup. - شغّل /codex-hud:setup ثم /reload-plugins.
وأرفقتُ في الملف دليلًا عربيًا (README-AR.md) بخطوات التحميل إلى جانب README الأصلي.
ما تحتاجه على جهازك
- Claude Code وNode.js 18 أو أحدث، وBash لشريط الحالة.
- Codex CLI أو إضافة codex-plugin-cc.
- Node.js 22.5 أو sqlite3 لإصداري Codex 0.140 و0.141، وأمر codex في PATH من 0.142 فأحدث.
- اختياريًا: claude-hud، ومفتاح OpenAI Admin لأوامر التكلفة.
حدود تعرفها قبل البدء
- لا يثبّت setup أداة claude-hud بنفسه؛ إن وجدها ظهرت سطور Codex تحت سطورها، وإلا ظهرت وحدها. وأي شريط حالة خاص آخر لديك يختفي حتى تشغّل uninstall.
- يصف المؤلف أوامر costs بأنها تجريبية لم يجرّبها بمفتاح Admin حقيقي.
- يقرأ setup-key المفتاح من الحافظة بأدوات macOS وLinux (pbpaste وwl-paste وxclip)؛ وعلى Windows ضع المفتاح في متغير البيئة OPENAI_ADMIN_KEY.
- يبقى المفتاح المحفوظ في config.json داخل مجلد plugins/codex-hud بعد uninstall، فاحذفه يدويًا إن أردت.
- تسميات الشريط بالإنجليزية أو الكورية فقط.
ألّف codex-hud المطوّر Haenara Shin ونشره بترخيص MIT في مستودعه على GitHub، والمرفق هنا الإصدار 0.10.0 مع نص الترخيص.
