Início → Guias → Cline com API personalizada: provedor, base URL e qual modelo lida bem com as ferramentas

Cline com API personalizada: provedor, base URL e qual modelo lida bem com as ferramentas

O Cline precisa de três coisas de uma API: base URL, chave e ID do modelo. O que decide se um agente funciona é menos óbvio — se o modelo chama as ferramentas exatamente com os argumentos que o Cline define. Testamos isso em seis modelos antes de escrever este guia.

Conectando o Cline em quatro passos

Abra o painel do Cline no VS Code e clique no ícone de engrenagem. Depois:

  1. Em API Provider, escolha OpenAI Compatible (funciona com todos os modelos) ou Anthropic para o Claude.
  2. Informe a base URL da tabela. Com Anthropic, marque antes Use custom base URL.
  3. Cole sua chave de API do console.
  4. Digite o ID do modelo exatamente como listado, clique em Done e teste com uma tarefa curta.
API ProviderBase URLModel ID
OpenAI Compatiblehttps://apiclan.us/v1gpt-6.1-sol, deepseek-v4-pro, claude-opus-5-5
Anthropic (base URL personalizada)https://apiclan.usclaude-opus-5-5, claude-fable-5-1

As duas base URLs são diferentes de propósito. O OpenAI Compatible acrescenta /chat/completions, então precisa de /v1; o Anthropic acrescenta /v1/messages sozinho, então não pode ter. Um /v1 no lugar errado é a causa mais comum de 404.

Use uma chave do grupo certo

Cada chave de API deste gateway pertence a um grupo de modelos e só chama os modelos desse grupo. Para usar o Claude no Cline, crie a chave num grupo Claude; para GPT, num grupo GPT; para DeepSeek, no grupo DeepSeek. Se trocar de família de modelos no Cline, troque também a chave.

Configurações do modelo no OpenAI Compatible

No OpenAI Compatible, o Cline não consegue consultar o modelo e mostra os campos de Model Configuration: janela de contexto, máximo de tokens de saída e suporte a imagens. Informe o limite real de contexto do modelo. Baixo demais, e o Cline corta a conversa cedo; alto demais, e tarefas longas falham com erro de tamanho de contexto em vez de serem compactadas.

Nosso teste: os modelos chamam corretamente as ferramentas do Cline?

O agente do Cline trabalha com ferramentas como read_file. Demos a cada modelo uma ferramenta read_file cujo único argumento se chama path, pedimos para abrir src/app.ts e verificamos duas coisas: se a chamada usou exatamente o nome de argumento declarado no esquema e quanto tempo levou a primeira resposta (mediana, com streaming). Um argumento renomeado é o motivo comum de um passo do agente falhar sem erro claro.

ModeloChamadas corretasPrimeira resposta
claude-opus-5-513 / 133.3 s
claude-fable-5-113 / 132.8 s
gpt-6.1-sol3 / 32.6 s
gpt-5.6-sol3 / 33.3 s
deepseek-v4-pro3 / 32.6 s
deepseek-v4.1-flash3 / 31.5 s

Todos os modelos chamaram a ferramenta corretamente todas as vezes. As amostras são pequenas — 13 execuções para cada modelo Claude, 3 para os demais — e uma execução do gpt-5.6-sol levou 40 segundos num início a frio; a tabela mostra a mediana. Teste de 12 de outubro de 2026.

Qual modelo escolher

Os quatro erros mais comuns

Configurando outras ferramentas? Base URL do Claude Code · Codex com API personalizada.

Comece a usar

Sem assinatura, sem mínimo mensal, sem conversa com vendedor. Recarregue com USDT e gaste o que usar — 1 USDT dá 2 créditos de saldo de API.

Leia o início rápido de 30 segundos

Idioma: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Os preços desta página são preenchidos automaticamente com dados reais de cobrança. Condições de terceiros são citadas da documentação deles.