# Visão geral da conexão de ferramentas de IA

Conecte ferramentas de programação, editores e agentes aos modelos Felo com uma única chave de API. Escolha o cliente e configure a chave, o endpoint e o modelo.

Conecte ferramentas de programação, editores e agentes aos modelos Felo com uma única chave de API. Escolha o cliente e configure a chave, o endpoint e o modelo.

## Antes de começar

[API Key](https://openapi.felo.ai/console/api-keys)

Você precisa de uma chave do Felo API Platform. 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.

```bash
export FELO_API_KEY="YOUR_API_KEY"
```

## Escolha sua ferramenta

- [Codex](https://openapi.felo.ai/pt-BR/docs/agent-clients/codex.md)
- [Claude Code](https://openapi.felo.ai/pt-BR/docs/agent-clients/claude-code.md)
- [OpenCode](https://openapi.felo.ai/pt-BR/docs/agent-clients/opencode.md)
- [OpenClaw](https://openapi.felo.ai/pt-BR/docs/agent-clients/openclaw.md)
- [Hermes Agent](https://openapi.felo.ai/pt-BR/docs/agent-clients/hermes-agent.md)
- [TRAE](https://openapi.felo.ai/pt-BR/docs/agent-clients/trae.md)
- [Cursor](https://openapi.felo.ai/pt-BR/docs/agent-clients/cursor.md)
- [Cline](https://openapi.felo.ai/pt-BR/docs/agent-clients/cline.md)
- [Roo Code](https://openapi.felo.ai/pt-BR/docs/agent-clients/roo-code.md)
- [Kilo Code](https://openapi.felo.ai/pt-BR/docs/agent-clients/kilo-code.md)
- [Magpie](https://openapi.felo.ai/pt-BR/docs/agent-clients/magpie.md)
- [Outras ferramentas de IA](https://openapi.felo.ai/pt-BR/docs/agent-clients/other-tools.md)

## Qual URL base devo escolher?

| A ferramenta pede | Use esta URL base |
|---------------|-------------------|
| Endpoint compatível com OpenAI | `https://openapi.felo.ai/api/v1` |
| Endpoint compatível com Anthropic | `https://openapi.felo.ai/api` |
| URL de Chat Completions | `https://openapi.felo.ai/api/v1` |
| Host da Messages API | `https://openapi.felo.ai/api` |

| Exemplo de modelo | [Model ID](https://openapi.felo.ai/pt-BR/models) |

## Verifique a configuração

Selecione um modelo do provedor Felo e envie uma mensagem curta. Para programação, escolha um modelo com suporte a chamadas de ferramentas.

## Solução de problemas

| Problema | O que verificar |
|-------|---------------|
| A autenticação falha | Confirme que a chave foi copiada corretamente e exportada como `FELO_API_KEY` |
| A ferramenta chama o provedor errado | Verifique se o provedor Felo está selecionado no workspace ou na sessão atual |
| Erro de URL base | Use `https://openapi.felo.ai/api/v1` para clientes compatíveis com OpenAI e `https://openapi.felo.ai/api` para clientes compatíveis com Anthropic |
| Modelo não encontrado | Escolha um modelo que apareça na sua lista de modelos Felo |
| A ferramenta ignora a configuração local | Mova as configurações de provedor para a configuração no nível do usuário se o cliente exigir isso |

## Próximos passos

- [Primeiros passos](https://openapi.felo.ai/pt-BR/docs/getting-started.md)
- [Referência da LLM API](https://openapi.felo.ai/pt-BR/docs/guides/protocols.md)
- [Referência da Chat API](https://openapi.felo.ai/pt-BR/docs/api-reference/chat.md)
- [Referência da SuperAgent API](https://openapi.felo.ai/pt-BR/docs/api-reference/superagent.md)
