Начало

FeloAPI CLI

Установите FeloAPI CLI и настройте Codex, Claude Code, модели и Felo Skills командой npx feloapi-cli setup.

Настройте модели Felo и Felo Skills для Codex или Claude Code из терминала. Также доступны команды поиска, создания слайдов, Web Fetch и LiveDocs.

Начните с одной команды

Установите Node.js 22 или новее и выполните:

npx feloapi-cli setup

Если npm предложит установить пакет, подтвердите установку. Аккаунт npm и глобальная установка не нужны. Codex или Claude Code устанавливаются отдельно. Для настройки моделей Codex требуется Codex CLI 0.134.0+.

Получите API-ключ и завершите настройку

Откройте API Keys в консоли Felo и войдите в Felo.
Создайте ключ и скопируйте полное значение из результата создания. В списке отображается только скрытое значение, восстановить полный ключ нельзя. Если вы его не сохранили, создайте новый.
Выполните npx feloapi-cli setup и выберите Codex или Claude Code.
Выберите Models + Skills (модели и навыки), Skills only (только навыки) или Models only (только модели). Вставьте полный ключ по запросу. Ввод не отображается.
При настройке модели выберите доступную вашему аккаунту текстовую модель. Codex требует поддержки Responses, Claude Code — Anthropic Messages. Наличие модели в списке не гарантирует совместимость с клиентом.
Проверьте предварительный просмотр настроек и подтвердите сохранение.

Ключ сохраняется локально в ~/.feloapi/state.json. Файл не зашифрован: не добавляйте его в Git или общие папки. Не передавайте ключ в аргументах команд и не публикуйте его в логах. Нужен полный API-ключ, а не токен аккаунта Felo или ID ключа.

Запустите настроенный инструмент

Выполните команду для выбранного инструмента:

npx feloapi-cli run codex

npx feloapi-cli run claude-code

Этот способ запуска передаёт сохранённый ключ и настройки Felo. CLI создаёт отдельную конфигурацию и не меняет провайдера моделей по умолчанию. Для загрузки установленных Skills начните новую сессию.

Глобальная установка и выбор возможностей

После глобальной установки пакета feloapi-cli используется команда feloapi:

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

Установить только 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 удаляет ранее созданный CLI профиль модели.

Использование инструментов и диагностика

После сохранения ключа можно использовать инструменты 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.js 22+, откройте терминал заново и проверьте `node --version`.
Ключ отклонён	Обновите полный ключ командой `npx feloapi-cli auth login`.
Используется другой провайдер	Запускайте через `run codex` или `run claude-code`; проверьте настройки проекта и явные переопределения.
Конфликт файлов настроек	Проверьте указанные файлы. CLI сохраняет чужие файлы и файлы, изменённые вне CLI.
Удаление подключения	Выполните `npx feloapi-cli disconnect codex` или `disconnect claude-code`.

npx feloapi-cli auth logout удаляет только локальный ключ. Для отзыва ключа используйте консоль Felo.

Для ручной настройки см. руководства по Codex и Claude Code.