شروع
FeloAPI CLI
FeloAPI CLI را نصب کنید و دستور npx feloapi-cli setup را برای پیکربندی Codex یا Claude Code با کلید API خود در Felo اجرا کنید.
مدل‌های Felo و Felo Skillها را از ترمینال خود برای Codex یا Claude Code پیکربندی کنید. همچنین می‌توانید از فرمان‌های جستجو، اسلاید، Web Fetch و LiveDocs Felo استفاده کنید.
شروع با یک فرمان
Node.js 22 یا جدیدتر را نصب کنید، سپس اجرا کنید:
npx feloapi-cli setupاگر اعلان نصب npm ظاهر شد آن را بپذیرید. حساب npm یا نصب سراسری لازم نیست. Codex یا Claude Code را جداگانه نصب کنید؛ پیکربندی مدل Codex به Codex CLI 0.134.0+ نیاز دارد.
دریافت کلید API و تکمیل راه‌اندازی
- صفحه API Keys در 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 می‌سازد؛ ارائه‌دهنده مدل پیش‌فرض شما را عوض نمی‌کند. برای بارگذاری Skillهای تازه نصب‌شده نشست تازه عامل را شروع کنید.
نصب سراسری یا انتخاب توانمندی‌ها
برای استفاده مکرر، بسته npm feloapi-cli را سراسری نصب کنید. فرمان نصب‌شده feloapi است:
npm install -g feloapi-cli
feloapi setup
feloapi run codexبرای نصب فقط Felo Skillها:
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 نمایه مدل مدیریت‌شده پیشین آن را حذف می‌کند.
استفاده از ابزارهای 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 --helpdoctor پیکربندی محلی را بدون فراخوانی پولی 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 فایل‌هایی را که مدیریت نمی‌کند و فایل‌هایی که بیرون از CLI ویرایش شده‌اند حفظ می‌کند. |
| حذف یک اتصال | npx feloapi-cli disconnect codex یا disconnect claude-code را اجرا کنید. |
npx feloapi-cli auth logout فقط کلید محلی را حذف می‌کند. برای لغو یک کلید از Felo Console استفاده کنید.
برای پیکربندی دستی، راهنمای Codex و راهنمای Claude Code را ببینید.