Початок роботи
FeloAPI CLI
Встановіть FeloAPI CLI і запустіть npx feloapi-cli setup, щоб налаштувати Codex або Claude Code з вашим ключем Felo API.
Налаштуйте моделі 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.
Установіть глобально або виберіть можливості
Для частого використання встановіть 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 на доступний 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.