FeloAPI CLI

Configure modelos Felo e Felo Skills para o Codex ou o Claude Code direto do seu terminal. Você também pode usar os comandos de busca, slides, Web Fetch e LiveDocs da Felo.

Comece com um único comando

Instale o Node.js 22 ou mais recente e execute:

npx feloapi-cli setup

Aceite o prompt de instalação do npm se ele aparecer. Não é preciso ter conta npm nem instalar globalmente. Instale o Codex ou o Claude Code separadamente; a configuração de modelos do Codex exige Codex CLI 0.134.0+.

Obtenha sua chave de API e conclua a configuração

1. Abra a página de chaves de API do Felo Console e entre na Felo.
2. Crie uma chave e copie a chave completa do resultado da criação. A lista mostra apenas uma chave mascarada; ela não consegue recuperar o valor completo. Se você não tem mais a chave, crie uma nova.
3. Execute npx feloapi-cli setup no terminal e selecione Codex ou Claude Code.
4. Escolha Models + Skills, Skills only ou Models only. Cole sua chave completa quando for solicitado; a entrada fica oculta.
5. Se estiver configurando um modelo, escolha um modelo disponível para sua conta. O Codex precisa de um modelo de texto com suporte a Responses; o Claude Code precisa de Anthropic Messages. Aparecer na lista de modelos não garante compatibilidade com o cliente.
6. Revise a prévia da configuração e confirme para salvar.

A CLI salva sua chave localmente em ~/.feloapi/state.json. Esse arquivo não é criptografado; mantenha-o fora do Git e de pastas compartilhadas. Não cole sua chave em argumentos de comando nem em logs públicos. O prompt de configuração aceita uma chave de API, não um token de conta Felo nem um ID de chave.

Inicie o agente configurado

Depois da configuração, inicie o agente que você configurou:

npx feloapi-cli run codex

Para o Claude Code:

npx feloapi-cli run claude-code

Use esse launcher para passar a chave salva e a configuração da Felo ao agente. A configuração cria uma configuração Felo separada; ela não troca seu provedor de modelo padrão. Inicie uma nova sessão do agente para carregar as Skills recém-instaladas.

Instale globalmente ou escolha os recursos

Para uso frequente, instale o pacote npm feloapi-cli globalmente. O comando instalado é feloapi:

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

Para instalar apenas os Felo Skills:

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

Para visualizar uma conexão sem salvar a configuração, substitua YOUR_MODEL_ID por um ID de modelo disponível:

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

--no-skills configura apenas um modelo. Executar a configuração novamente substitui a conexão Felo daquele agente pelas suas novas escolhas; escolher apenas Skills remove o perfil de modelo gerenciado anteriormente.

Use as ferramentas Felo e verifique sua configuração

Depois de salvar sua chave, use as ferramentas Felo existentes. As requisições à API podem consumir a cota da sua conta:

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

Execute verificações locais ou veja a ajuda dos comandos:

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

doctor verifica a configuração local sem fazer chamada paga à API. doctor --online também verifica a descoberta de modelos; doctor --probe --agent codex envia uma pequena requisição de modelo após confirmação e pode gerar cobranças.

npx feloapi-cli auth logout remove apenas a chave local. Para revogar uma chave, use o Felo Console.

Para configuração manual, consulte o guia do Codex e o guia do Claude Code.