FeloAPI CLI

Configura i modelli Felo e le Felo Skills per Codex o Claude Code dal tuo terminale. Puoi anche usare i comandi Felo per ricerca, slide, Web Fetch e LiveDocs.

Iniziare con un solo comando

Installa Node.js 22 o versione successiva, poi esegui:

npx feloapi-cli setup

Accetta la richiesta di installazione di npm se compare. Non servono un account npm né un'installazione globale. Installa Codex o Claude Code separatamente; la configurazione dei modelli per Codex richiede Codex CLI 0.134.0+.

Ottenere la chiave API e completare la configurazione

1. Apri la pagina Chiavi API della console Felo e accedi a Felo.
2. Crea una chiave e copia la chiave completa dal risultato della creazione. L'elenco mostra solo una chiave mascherata; non può recuperare il valore completo. Se non la possiedi più, crea una nuova chiave.
3. Esegui npx feloapi-cli setup nel terminale e seleziona Codex o Claude Code.
4. Scegli Models + Skills, Skills only o Models only. Quando richiesto, incolla la chiave completa; l'input è nascosto.
5. Se configuri un modello, scegline uno disponibile per il tuo account. Codex ha bisogno di un modello testuale che supporti Responses; Claude Code ha bisogno di Anthropic Messages. Comparire nell'elenco dei modelli non garantisce la compatibilità con il client.
6. Controlla l'anteprima della configurazione e conferma per salvare.

La CLI salva la chiave localmente in ~/.feloapi/state.json. Questo file non è cifrato; tienilo fuori da Git e dalle cartelle condivise. Non incollare la chiave negli argomenti dei comandi o nei log pubblici. La richiesta di configurazione accetta una chiave API, non un token dell'account Felo o un key ID.

Avviare l'agente configurato

Dopo la configurazione, avvia l'agente che hai configurato:

npx feloapi-cli run codex

Per Claude Code:

npx feloapi-cli run claude-code

Usa questo launcher per passare all'agente la chiave salvata e la configurazione Felo. La configurazione crea una configurazione Felo separata; non cambia il provider di modelli predefinito. Avvia una nuova sessione dell'agente per caricare le Skill appena installate.

Installare globalmente o scegliere le capacità

Per un uso frequente, installa globalmente il pacchetto npm feloapi-cli. Il comando installato è feloapi:

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

Per installare solo le Felo Skills:

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

Per provare una connessione senza salvare la configurazione, sostituisci YOUR_MODEL_ID con un ID di modello disponibile:

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

--no-skills configura solo un modello. Eseguire di nuovo la configurazione sostituisce la connessione Felo di quell'agente con le tue nuove scelte; scegliere solo Skills rimuove il profilo di modello che gestiva in precedenza.

Usare gli strumenti Felo e controllare la configurazione

Dopo aver salvato la chiave, usa gli strumenti Felo esistenti. Le richieste API possono consumare la quota del tuo account:

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

Esegui i controlli locali o visualizza la guida dei comandi:

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

doctor controlla la configurazione locale senza effettuare chiamate API a pagamento. doctor --online controlla anche la scoperta dei modelli; doctor --probe --agent codex invia una piccola richiesta al modello dopo conferma e può comportare addebiti.

npx feloapi-cli auth logout rimuove solo la chiave locale. Per revocare una chiave, usa la console Felo.

Per la configurazione manuale, vedi la guida Codex e la guida Claude Code.