Empezar
FeloAPI CLI
Instala FeloAPI CLI y ejecuta npx feloapi-cli setup para configurar Codex o Claude Code con tu clave de API de Felo.
Configura los modelos de Felo y Felo Skills para Codex o Claude Code desde tu terminal. También puedes usar los comandos de búsqueda de Felo, diapositivas, Web Fetch y LiveDocs.
Empieza con un solo comando
Instala Node.js 22 o una versión posterior y ejecuta:
npx feloapi-cli setupAcepta el aviso de instalación de npm si aparece. No se requiere una cuenta de npm ni una instalación global. Instala Codex o Claude Code por separado; la configuración de modelos de Codex requiere Codex CLI 0.134.0+.
Obtén tu clave de API y completa la configuración
- Abre la página de claves de API de Felo Console e inicia sesión en Felo.
- Crea una clave y copia la clave completa del resultado de creación. La lista solo muestra una clave enmascarada; no puede recuperar el valor completo. Si ya no la tienes, crea una nueva clave.
- Ejecuta
npx feloapi-cli setupen tu terminal y selecciona Codex o Claude Code. - Elige Models + Skills, Skills only o Models only. Pega tu clave completa cuando se solicite; la entrada está oculta.
- Si configuras un modelo, elige uno disponible para tu cuenta. Codex necesita un modelo de texto compatible con Responses; Claude Code necesita Anthropic Messages. Aparecer en la lista de modelos no garantiza la compatibilidad con el cliente.
- Revisa la vista previa de la configuración y confirma para guardar.
La CLI guarda tu clave localmente en ~/.feloapi/state.json. Este archivo no está cifrado; mantenlo fuera de Git y de carpetas compartidas. No pegues tu clave en argumentos de comandos ni en registros públicos. El aviso de configuración acepta una clave de API, no un token de cuenta de Felo ni un ID de clave.
Inicia el agente que configuraste
Después de la configuración, inicia el agente que configuraste:
npx feloapi-cli run codexPara Claude Code:
npx feloapi-cli run claude-codeUsa este lanzador para pasar la clave guardada y la configuración de Felo al agente. La configuración crea una configuración de Felo independiente; no cambia tu proveedor de modelos predeterminado. Inicia una nueva sesión del agente para cargar las Skills recién instaladas.
Instala globalmente o elige capacidades
Para un uso frecuente, instala el paquete npm feloapi-cli globalmente. El comando instalado es feloapi:
npm install -g feloapi-cli
feloapi setup
feloapi run codexPara instalar solo Felo Skills:
npx feloapi-cli setup --agent codex --skills-onlyPara previsualizar una conexión sin guardar la configuración, sustituye YOUR_MODEL_ID por un ID de modelo disponible:
npx feloapi-cli models
npx feloapi-cli connect codex --model YOUR_MODEL_ID --dry-run--no-skills configura solo un modelo. Si vuelves a ejecutar la configuración, la conexión de Felo de ese agente se sustituye por tus nuevas selecciones; si eliges solo Skills, se elimina el perfil de modelo que gestionaba anteriormente.
Usa las herramientas de Felo y comprueba tu configuración
Después de guardar tu clave, usa las herramientas de Felo existentes. Las solicitudes a la API pueden consumir la cuota de tu cuenta:
npx feloapi-cli search "AI agent trends" --json
npx feloapi-cli web-fetch --url https://example.com --format markdownEjecuta comprobaciones locales o consulta la ayuda de los comandos:
npx feloapi-cli doctor
npx feloapi-cli --helpdoctor comprueba la configuración local sin realizar una llamada de pago a la API. doctor --online también comprueba el descubrimiento de modelos; doctor --probe --agent codex envía una pequeña solicitud a un modelo tras la confirmación y puede generar cargos.
| Problema | Qué hacer |
|---|---|
No se encuentra npx o Node es demasiado antiguo | Instala Node.js 22 o posterior y vuelve a abrir la terminal. Comprueba node --version. |
| Se rechaza la clave | Usa la clave completa del resultado de su creación. Actualízala con npx feloapi-cli auth login. |
| El agente usa otro proveedor | Inícialo con npx feloapi-cli run codex o run claude-code; revisa la configuración del proyecto y las anulaciones explícitas. |
| La configuración existente entra en conflicto | Revisa los archivos indicados. La CLI conserva los archivos que no gestiona y los que se editaron fuera de la CLI. |
| Eliminar una conexión | Ejecuta npx feloapi-cli disconnect codex o disconnect claude-code. |
npx feloapi-cli auth logout elimina solo la clave local. Para revocar una clave, usa Felo Console.
Para la configuración manual, consulta la guía de Codex y la guía de Claude Code.