Resposta curta
Para usar o Cline com a APIVAI, abra as configurações do Cline, escolha OpenAI Compatible em API Provider, informe https://api.apivai.com/v1 como Base URL, cole sua chave da APIVAI em API Key e digite um ID de modelo como claude-sonnet-4-6 ou gpt-5.5. Se você só quer o Claude, também pode escolher o provedor Anthropic, marcar Use custom base URL e informar https://api.apivai.com sem /v1, porque o próprio Cline adiciona o caminho. Em 2026-10-07, o Claude Sonnet 4.6 custa $1.04 / $5.22 por milhão de tokens de entrada / saída pela APIVAI, contra $3.00 / $15.00 no preço oficial. Você paga por token a partir de um saldo pré-pago, sem assinatura.
O que é o Cline e por que conectá-lo à sua própria API?
O Cline é um agente de programação com IA, de código aberto, que roda dentro do VS Code. Ele lê seus arquivos, propõe alterações, executa comandos no terminal com a sua aprovação e resolve uma tarefa passo a passo. O Cline não vem com modelo próprio: você conecta um provedor de API e uma chave, e cada passo de uma tarefa é uma requisição cobrada por esse provedor.
Por isso, o provedor escolhido é o que mais pesa no custo do Cline. A APIVAI oferece uma única chave para modelos Claude e GPT, cobrada por token abaixo dos preços oficiais, a partir de um saldo que você recarrega quando precisar. A mesma chave funciona no formato da OpenAI e no da Anthropic, então serve para as duas opções de provedor do Cline.
Qual API Provider escolher no Cline?
O Cline oferece dois tipos de provedor que funcionam com a APIVAI:
| OpenAI Compatible | Anthropic | |
|---|---|---|
| Base URL | https://api.apivai.com/v1 | https://api.apivai.com (sem /v1) |
| Modelos | Claude e GPT | Só Claude |
| Como escolher o modelo | Digitar o ID | Escolher na lista do Cline |
| Melhor para | Uma configuração para todos os modelos | Claude no formato nativo Messages |
Escolha OpenAI Compatible se quiser alternar entre Claude e GPT ou usar um ID de modelo mais novo do que a lista interna do Cline. Escolha Anthropic se você usa só o Claude e prefere a integração nativa do Cline com ele. Dá para trocar a qualquer momento; a chave é a mesma.
Como configurar o Cline com a APIVAI passo a passo?
Passo 1: Crie uma chave da APIVAI
- Cadastre-se em apivai.com com seu e-mail.
- Recarregue o saldo a partir de $10 com cartão, cripto, Alipay ou WeChat Pay. Não há teste grátis: você paga só pelo que usar.
- Abra o Dashboard, crie uma chave e copie. Você pode definir um limite de orçamento próprio para a chave, para que o Cline nunca gaste mais do que o planejado.
Passo 2: Configure o provedor OpenAI Compatible
- No VS Code, abra o painel do Cline e clique no ícone de configurações (engrenagem).
- Em API Provider, escolha OpenAI Compatible.
- Preencha os campos conforme a tabela.
- Clique em Verify se a sua versão mostrar esse botão, salve e comece uma tarefa.
| Campo | Valor |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.apivai.com/v1 |
| API Key | Sua chave da APIVAI |
| Model | claude-sonnet-4-6 (ou qualquer ID de GET /v1/models) |
| Max Output Tokens | 8192 ou mais (no mínimo 4096) |
| Input Price / Output Price | Opcional: $1.04 / $5.22 para o Claude Sonnet 4.6 |
A Base URL deve terminar em /v1 uma única vez: o Cline acrescenta /chat/completions a ela. A configuração do modelo também tem Context Window, Image Support e Computer Use; deixe nos valores padrão, a menos que saiba que precisa mudar.
Os campos de preço afetam apenas a estimativa de custo que o Cline mostra para cada tarefa. Com os preços da APIVAI preenchidos, essa estimativa bate com o valor realmente cobrado; o consumo real fica sempre no Dashboard.
Para ver quais IDs de modelo a sua chave pode usar, execute:
curl https://api.apivai.com/v1/models \ -H "Authorization: Bearer YOUR_APIVAI_KEY"
A lista de modelos muda com o tempo, então copie os IDs dessa resposta ou da página de preços, e não de tutoriais antigos.
Passo 3 (opcional): Use o provedor Anthropic para o Claude
- Em API Provider, escolha Anthropic.
- Cole sua chave da APIVAI em Anthropic API Key.
- Marque Use custom base URL e informe
https://api.apivai.com. - Escolha um modelo Claude no menu Model.
Não adicione /v1 aqui. O cliente Anthropic do Cline acrescenta /v1/messages à URL base por conta própria, então https://api.apivai.com/v1 viraria /v1/v1/messages e daria 404. Se o modelo Claude que você quer ainda não estiver na lista do Cline, use o provedor OpenAI Compatible e digite o ID. Há mais detalhes sobre esse formato na página do proxy da API do Claude.
Qual modelo escolher no Cline?
O Cline envia muitas requisições por tarefa, então o preço por token pesa mais do que em um app de chat. Preços por 1M de tokens de entrada / saída em 2026-10-07:
| ID do modelo | Preço (entrada / saída) | Para quê |
|---|---|---|
claude-sonnet-4-6 | $1.04 / $5.22 | Padrão para o dia a dia |
claude-sonnet-5-5 | $0.69 / $3.47 | Dia a dia, Sonnet mais novo |
claude-opus-5-5 | $1.39 / $6.96 | Bugs difíceis, grandes refatorações |
claude-haiku-4-5 | $0.35 / $1.74 | Edições pequenas, barato e rápido |
gpt-5.5 | $0.77 / $4.56 | Alternativa GPT, segunda opinião |
gpt-6-luna | $0.0144 / $0.0768 | Tarefas simples muito baratas |
Um esquema prático: Claude Sonnet 4.6 ou Claude Sonnet 5.5 como padrão, Claude Opus 5.5 quando uma tarefa falha repetidamente, e Claude Haiku 4.5 para renomear, comentar e fazer pequenas correções. Os modelos GPT só funcionam pelo provedor OpenAI Compatible.
Quanto custa o Cline com a APIVAI?
Cada passo de uma tarefa do Cline reenvia a conversa e os arquivos já lidos, então os tokens de entrada se acumulam rápido. Dois exemplos realistas com o Claude Sonnet 4.6:
- Uma tarefa média, como adicionar um recurso que mexe em alguns arquivos: cerca de 20 requisições de 30.000 tokens de entrada e 1.500 de saída cada. Custo: $0.781 com a APIVAI, $2.25 no preço oficial.
- Um mês de trabalho com três tarefas dessas por dia durante 22 dias (1.320 requisições): $51.52 com a APIVAI, $149 no preço oficial.
O mesmo mês com o Claude Haiku 4.5 custaria $17.31. Essas estimativas não consideram o cache de prompts e assumem que os tokens de raciocínio estão incluídos no número de saída; eles são cobrados como saída. O Dashboard lista cada requisição com tokens e custo, então em um dia você pode trocar essas suposições pelos seus próprios números. Para uma comparação mais ampla, veja os preços da API do Claude em 2026.
Como resolver os erros mais comuns do Cline?
- 401 Unauthorized / chave inválida: a chave foi copiada incompleta, foi excluída ou atingiu o limite de orçamento. Confira no Dashboard. Com o provedor Anthropic, verifique também se Use custom base URL está marcado; caso contrário, o Cline envia a chave direto para a Anthropic.
- 404 Not Found: quase sempre é o
/v1. O OpenAI Compatible precisa dehttps://api.apivai.com/v1(um único/v1, sem/chat/completionsno final). O Anthropic precisa dehttps://api.apivai.comsem/v1. - Modelo não encontrado: o campo Model deve ter um ID exato, como
claude-sonnet-4-6, e não um nome de exibição. Confira comGET /v1/models. - Respostas vazias ou cortadas: o raciocínio vem ativado por padrão e consome tokens de saída. Aumente Max Output Tokens para 8192 (no mínimo 4096).
- 429 Too Many Requests: o limite padrão é de 60 requisições por minuto por chave. Tarefas longas do agente podem atingi-lo; espere um pouco ou peça ao suporte para aumentar o limite.
As regras gerais de cada formato estão na página de API compatível com OpenAI e na documentação.
Perguntas frequentes
Posso usar Claude e GPT no Cline com uma única chave?
Sim. Uma chave da APIVAI funciona com todos os modelos. Use o provedor OpenAI Compatible e altere o campo Model para alternar entre claude-sonnet-4-6 e gpt-5.5.
Uso o provedor OpenAI Compatible ou o Anthropic?
O OpenAI Compatible cobre Claude e GPT com uma só configuração e aceita qualquer ID de modelo. O provedor Anthropic é só para o Claude e usa o formato nativo dele; a URL base vai sem /v1.
A APIVAI armazena meu código?
Não. O conteúdo das requisições e respostas não é registrado. Só ficam guardados dados de uso como modelo, tokens e custo, para a cobrança.
Existe assinatura ou teste grátis?
Não há assinatura nem créditos grátis. Você recarrega a partir de $10 e paga só pelos tokens que usar.
Posso usar a mesma chave em outras ferramentas?
Sim. A mesma chave funciona no Roo Code, no Cursor e no Claude Code. Criar uma chave por ferramenta deixa o Dashboard mais fácil de ler.
Crie uma conta, recarregue a partir de $10 e cole sua chave no Cline.