SyntheticSynthetic/Docs
ProdutosNovidades
Dashboard →

AE Agent

Como conectar um provedor de IA

O AE Agent funciona com o provedor de IA que você escolher. Há três formas de se conectar: usar sua própria chave de API, usar uma assinatura que você já tem por meio da CLI oficial ou executar um modelo localmente na sua máquina. Combine como quiser — alterne entre elas a qualquer momento no seletor de modelos.

Três formas de se conectar

a. Chave de API

Cole sua chave de API da Anthropic, da OpenAI ou do Google e pague por uso, com cobrança direta do provedor. É a opção mais simples — funciona na hora e aceita todos os modelos que o provedor oferece.

b. Assinatura (CLI oficial)

Conecte a ferramenta de linha de comando oficial — Claude Code, OpenAI Codex ou Gemini CLI — e use seu plano Pro / Max / Plus atual. Sem custo por token: o uso é descontado da sua assinatura, em vez de gerar uma fatura de API por consumo.

c. IA local

Execute um modelo inteiramente na sua própria máquina com o Ollama ou o LM Studio. Grátis, privado e funciona offline — nada sai do seu computador.

Opção A — Chave de API

Abra Configurações, escolha seu provedor e cole sua chave. Veja Configuração e chaves de API para saber onde encontrar a chave de cada provedor. As chaves ficam salvas localmente e a cobrança é por uso.

Opção B — Assinatura via CLI

Se você já paga pelo Claude Pro/Max, ChatGPT Plus ou Gemini, pode usar esse plano dentro do AE Agent por meio da CLI oficial do provedor — sem cobranças extras por token.

1

Instale a CLI

Instale a ferramenta de linha de comando oficial do seu provedor:
npm install -g @anthropic-ai/claude-code   
npm install -g @openai/codex   
npm install -g @google/gemini-cli   
O app para desktop não é a CLI. Você precisa instalar a ferramenta de linha de comando de verdade via npm — ter o app para desktop do ChatGPT ou do Claude instalado não basta.
2

Faça login uma vez

Execute a CLI uma vez e conclua o login OAuth no navegador. Isso vincula a CLI à sua assinatura. Você só faz isso uma vez — a sessão fica salva.
3

Selecione-a no AE Agent

Abra o seletor de modelos no painel. O AE Agent detecta automaticamente a CLI com login feito e lista os modelos dela em Assinatura. Escolha um e comece.
A assinatura do Gemini é visivelmente mais lenta em tarefas de vários passos no modo Agente. Funciona bem no modo Chat e em operações curtas, mas, para execuções longas no modo Agente, prefira uma chave de API ou uma assinatura do Claude/OpenAI.

Opção C — IA local

Execute um modelo localmente com o Ollama ou o LM Studio para um uso grátis, privado e offline. Para configurar, veja o guia dedicado Modelos locais.

O seletor de modelos unificado

Seja qual for a conexão, todos os modelos disponíveis aparecem em um único seletor, agrupados por origem, para você sempre saber pelo que está pagando (ou não):

GrupoOrigemCusto
AssinaturaCLI conectada (Claude Code, Codex, Gemini CLI)Desconta do seu plano
Chave de APIChave da Anthropic / OpenAI / GooglePago por token
LocalOllama / LM Studio na sua máquinaGrátis
Você pode manter uma chave de API e uma assinatura conectadas ao mesmo tempo e alternar conforme a tarefa — por exemplo, a assinatura para o trabalho do dia a dia e uma chave de API como reserva quando atingir o limite do plano.