Démarrage

FeloAPI CLI

Installez FeloAPI CLI et exécutez npx feloapi-cli setup pour configurer Codex ou Claude Code avec votre clé API Felo.

Configurez les modèles Felo et les Felo Skills pour Codex ou Claude Code depuis votre terminal. Vous pouvez aussi utiliser les commandes Felo search, slides, Web Fetch et LiveDocs.

Démarrer avec une seule commande

Installez Node.js 22 ou une version plus récente, puis exécutez :

npx feloapi-cli setup

Acceptez l'invite d'installation de npm si elle apparaît. Aucun compte npm ni installation globale n'est requis. Installez Codex ou Claude Code séparément ; la configuration d'un modèle Codex nécessite Codex CLI 0.134.0+.

Obtenir votre clé API et terminer l'installation

Ouvrez la page Clés API de la console Felo et connectez-vous à Felo.
Créez une clé et copiez la clé complète depuis le résultat de création. La liste n'affiche qu'une clé masquée ; elle ne permet pas de récupérer la valeur complète. Si vous ne l'avez plus, créez une nouvelle clé.
Exécutez npx feloapi-cli setup dans votre terminal et sélectionnez Codex ou Claude Code.
Choisissez Models + Skills, Skills only ou Models only. Collez votre clé complète lorsque demandé ; la saisie est masquée.
Si vous configurez un modèle, choisissez un modèle disponible pour votre compte. Codex a besoin d'un modèle texte prenant en charge Responses ; Claude Code a besoin d'Anthropic Messages. Le fait d'apparaître dans la liste des modèles ne garantit pas la compatibilité avec le client.
Vérifiez l'aperçu de la configuration et confirmez pour enregistrer.

La CLI enregistre votre clé localement dans ~/.feloapi/state.json. Ce fichier n'est pas chiffré ; gardez-le hors de Git et des dossiers partagés. Ne collez pas votre clé dans des arguments de commande ni dans des logs publics. L'invite de configuration accepte une clé API, pas un jeton de compte Felo ni un ID de clé.

Lancer votre agent configuré

Après la configuration, lancez l'agent que vous avez configuré :

npx feloapi-cli run codex

Pour Claude Code :

npx feloapi-cli run claude-code

Utilisez ce lanceur pour transmettre à l'agent la clé enregistrée et la configuration Felo. La configuration crée une configuration Felo distincte ; elle ne change pas votre fournisseur de modèles par défaut. Démarrez une nouvelle session d'agent pour charger les Skills nouvellement installés.

Installation globale ou choix des capacités

Pour un usage fréquent, installez globalement le paquet npm feloapi-cli. La commande installée est feloapi :

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

Pour installer uniquement les Felo Skills :

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

Pour prévisualiser une connexion sans enregistrer de configuration, remplacez YOUR_MODEL_ID par un ID de modèle disponible :

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

--no-skills configure uniquement un modèle. Relancer la configuration remplace la connexion Felo de cet agent par vos nouveaux choix ; choisir « Skills only » supprime le profil de modèle précédemment géré pour cet agent.

Utiliser les outils Felo et vérifier votre configuration

Après avoir enregistré votre clé, utilisez les outils Felo existants. Les requêtes API peuvent consommer le quota de votre compte :

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

Exécutez des vérifications locales ou affichez l'aide des commandes :

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

doctor vérifie la configuration locale sans effectuer d'appel API payant. doctor --online vérifie aussi la découverte des modèles ; doctor --probe --agent codex envoie une petite requête de modèle après confirmation et peut entraîner des frais.

Problème	Que faire
`npx` est introuvable ou Node est trop ancien	Installez Node.js 22+ et rouvrez votre terminal. Vérifiez avec `node --version`.
La clé est rejetée	Utilisez la clé complète depuis son résultat de création. Mettez-la à jour avec `npx feloapi-cli auth login`.
L'agent utilise un autre fournisseur	Lancez-le avec `npx feloapi-cli run codex` ou `run claude-code` ; vérifiez les paramètres du projet et les surcharges explicites.
Conflit avec une configuration existante	Examinez les fichiers signalés. La CLI préserve les fichiers qu'elle ne gère pas et ceux modifiés en dehors d'elle.
Supprimer une connexion	Exécutez `npx feloapi-cli disconnect codex` ou `disconnect claude-code`.

npx feloapi-cli auth logout supprime uniquement la clé locale. Pour révoquer une clé, utilisez la console Felo.

Pour une configuration manuelle, consultez le guide Codex et le guide Claude Code.