البداية

FeloAPI CLI

ثبّت FeloAPI CLI وشغّل الأمر npx feloapi-cli setup لتهيئة Codex أو Claude Code باستخدام مفتاح API الخاص بـ Felo.

اضبط نماذج Felo وFelo Skills لـCodex أو Claude Code من الطرفية. يمكنك أيضًا استخدام أوامر Felo search وslides وWeb Fetch وLiveDocs.

ابدأ بأمر واحد

ثبّت Node.js 22 أو أحدث، ثم شغّل:

npx feloapi-cli setup

اقبل مطالبة التثبيت من npm إذا ظهرت. لا يلزم حساب npm ولا تثبيت عام. ثبّت Codex أو Claude Code بشكل منفصل؛ يتطلب إعداد نموذج Codex الإصدار Codex CLI 0.134.0+.

احصل على مفتاح API وأكمل الإعداد

افتح صفحة مفاتيح API في Felo Console وسجّل الدخول إلى Felo.
أنشئ مفتاحًا وانسخ المفتاح الكامل من نتيجة الإنشاء. تعرض القائمة مفتاحًا مقنّعًا فقط؛ ولا يمكنها استعادة القيمة الكاملة. إذا لم يعد لديك المفتاح، فأنشئ مفتاحًا جديدًا.
شغّل npx feloapi-cli setup في طرفيتك واختر Codex أو Claude Code.
اختر Models + Skills أو Skills only أو Models only. الصق مفتاحك الكامل عند المطالبة؛ يكون الإدخال مخفيًا.
إذا كنت تُعدّ نموذجًا، فاختر نموذجًا متاحًا لحسابك. يحتاج Codex إلى نموذج نصي يدعم Responses؛ ويحتاج Claude Code إلى Anthropic Messages. لا يضمن الظهور في قائمة النماذج توافق العميل.
راجع معاينة الإعداد وأكّد الحفظ.

يحفظ CLI مفتاحك محليًا في ~/.feloapi/state.json. هذا الملف غير مشفّر؛ أبقِه خارج Git والمجلدات المشتركة. لا تلصق مفتاحك في وسائط الأوامر أو السجلات العامة. تقبل مطالبة الإعداد مفتاح API، لا رمز حساب Felo ولا معرّف مفتاح.

شغّل وكيلك المُعدّ

بعد الإعداد، شغّل الوكيل الذي أعددته:

npx feloapi-cli run codex

لـClaude Code:

npx feloapi-cli run claude-code

استخدم هذا المشغّل لتمرير المفتاح المحفوظ وإعداد Felo إلى الوكيل. ينشئ الإعداد تكوينًا منفصلًا لـFelo؛ ولا يبدّل مزوّد النموذج الافتراضي لديك. ابدأ جلسة وكيل جديدة لتحميل Skills المثبتة حديثًا.

ثبّت عالميًا أو اختر القدرات

للاستخدام المتكرر، ثبّت حزمة feloapi-cli على npm عالميًا. الأمر المثبت هو feloapi:

npm install -g feloapi-cli
feloapi setup
feloapi run codex

لتثبيت Felo Skills فقط:

npx feloapi-cli setup --agent codex --skills-only

لمعاينة اتصال دون حفظ الإعداد، استبدل YOUR_MODEL_ID بمعرّف نموذج متاح:

npx feloapi-cli models
npx feloapi-cli connect codex --model YOUR_MODEL_ID --dry-run

--no-skills يُعدّ نموذجًا فقط. إعادة تشغيل الإعداد تستبدل اتصال Felo لذلك الوكيل بخياراتك الجديدة؛ واختيار Skills only يزيل ملف تعريف النموذج الذي كان يديره سابقًا.

استخدم أدوات Felo وتحقق من إعدادك

بعد حفظ مفتاحك، استخدم أدوات Felo الحالية. قد تستهلك طلبات API حصة حسابك:

npx feloapi-cli search "AI agent trends" --json
npx feloapi-cli web-fetch --url https://example.com --format markdown

شغّل فحوصًا محلية أو اعرض مساعدة الأوامر:

npx feloapi-cli doctor
npx feloapi-cli --help

يتحقق doctor من الإعداد المحلي دون إجراء استدعاء API مدفوع. يتحقق doctor --online أيضًا من اكتشاف النماذج؛ ويرسل doctor --probe --agent codex طلب نموذج صغيرًا بعد التأكيد وقد يترتب على ذلك رسوم.

المشكلة	ما يجب فعله
`npx` غير موجود أو Node أقدم من المطلوب	ثبّت Node.js 22+ وأعد فتح طرفيتك. تحقق من `node --version`.
رُفض المفتاح	استخدم المفتاح الكامل من نتيجة إنشائه. حدّثه عبر `npx feloapi-cli auth login`.
يستخدم الوكيل مزوّدًا آخر	شغّله عبر `npx feloapi-cli run codex` أو `run claude-code`؛ تحقق من إعدادات المشروع والتجاوزات الصريحة.
تعارضات في الإعداد القائم	راجع الملفات المُبلّغ عنها. يحافظ CLI على الملفات التي لا يديرها والملفات المعدّلة خارجه.
إزالة اتصال	شغّل `npx feloapi-cli disconnect codex` أو `disconnect claude-code`.

npx feloapi-cli auth logout يزيل المفتاح المحلي فقط. لإلغاء مفتاح، استخدم Felo Console.

للاطلاع على الإعداد اليدوي، راجع دليل Codex ودليل Claude Code.