Claude Code

Use este guia quando quiser que o Claude Code use o Felo API Platform em vez de chamar o fornecedor do modelo diretamente. O Claude Code usa um endpoint Messages compatível com Anthropic.

Prefere não configurar manualmente? Instale o CC Switch, um app desktop de código aberto de terceiros que armazena as configurações de provedor do Claude Code e alterna entre elas com um clique. Adicione a Felo como provedor e você poderá alternar entre a Felo API e sua assinatura do Claude sem editar variáveis de ambiente. A primeira troca de volta para a assinatura usa o fluxo de login normal do Claude Code; os passos abaixo mostram como adicionar a Felo.

Configure o CC Switch

O exemplo abaixo adiciona a Felo como provedor do Claude Code. Os mesmos passos funcionam para qualquer outro provedor compatível com Anthropic — só mudam o endpoint, a chave e os IDs de modelo.

1. No CC Switch, selecione Claude Code, clique em Add provider e escolha Custom Configuration.

2. Informe um nome, cole a chave de API Felo que você criou na página de chaves de API do Felo API Platform e defina API Endpoint como https://openapi.felo.ai/api. A URL do site é opcional.

3. Abra Advanced Options. Defina Upstream Format como Anthropic Messages (Native) e mantenha Auth Field em ANTHROPIC_AUTH_TOKEN (Default). Em Model Mapping, mapeie Sonnet e Opus para o modelo Felo que você quer usar, como gpt-6.1-sol.

4. Clique em Add, ative o provedor e inicie o Claude Code. Se a primeira requisição funcionar, a configuração está concluída.

Para voltar à sua assinatura do Claude, selecione Claude Official no CC Switch e siga o fluxo de login. A troca de provedores substitui apenas o endpoint, a chave e o mapeamento de modelos — seus plugins, hooks e configurações de MCP permanecem.

Configuração recomendada

Configure o Claude Code

Para configurar o Claude Code manualmente, crie uma chave na página de chaves de API do Felo API Platform e defina as variáveis de ambiente. A mesma chave funciona em protocolos de modelo, clientes de agente e nas APIs Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page e SuperAgent.

export FELO_API_KEY="YOUR_API_KEY"
export ANTHROPIC_API_KEY="$FELO_API_KEY"
export ANTHROPIC_BASE_URL="https://openapi.felo.ai/api"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

Arquivo de configurações opcional

Use um arquivo de configurações quando quiser que a URL base e o modelo valham sempre que o Claude Code iniciar. Mantenha a chave de API no seu shell ou gerenciador de segredos.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openapi.felo.ai/api",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

Você também pode escolher um modelo para uma única sessão:

claude --model claude-sonnet-5

Verifique a configuração

Execute uma tarefa pequena depois de salvar a configuração:

claude

Se a ferramenta iniciar e responder com o modelo selecionado, a configuração do provedor está pronta.

Solução de problemas

Próximos passos

• Primeiros passos
• Referência da LLM API
• Referência da Chat API
• Referência da SuperAgent API