התחלה

FeloAPI CLI

התקינו את FeloAPI CLI והריצו npx feloapi-cli setup כדי להגדיר את Codex או Claude Code עם מפתח ה-API של Felo.

הגדירו מודלי Felo ו-Felo Skills עבור 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 ב-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 שהותקנו זה עתה.

התקנה גלובלית או בחירת יכולות

לשימוש תכוף, התקינו את חבילת ה-npm של feloapi-cli באופן גלובלי. הפקודה המותקנת היא 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 מגדיר מודל בלבד. הרצה חוזרת של setup מחליפה את חיבור ה-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 משמר קבצים שהוא אינו מנהל וקבצים שנערכו מחוץ ל-CLI.
הסרת חיבור	הריצו `npx feloapi-cli disconnect codex` או `disconnect claude-code`.

npx feloapi-cli auth logout מסיר רק את המפתח המקומי. כדי לבטל מפתח, השתמשו ב-Felo Console.

לתצורה ידנית, ראו את מדריך Codex ואת מדריך Claude Code.