Documentação

Cline

O provedor OpenAI Compatible do Cline recebe uma URL base, uma chave e um ID de modelo. Os campos de preço abaixo alimentam a exibição do custo acumulado por tarefa, então vale a pena preenchê-los corretamente.

O provedor OpenAI Compatible do Cline recebe uma URL base, uma chave e um ID de modelo, além dos preços por modelo usados para exibir o custo acumulado da sessão.

Configurações do Cline ⚙︎

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...
Model ID       claude-sonnet-5

Model Configuration
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        (from the table below)
  Output Price       (from the table below)

O Cline exibe um custo acumulado enquanto uma tarefa é executada e calcula esse valor com base em Preço de entrada e Preço de saída no bloco de configuração do modelo — ele não consulta as tarifas no endpoint. Se esses campos permanecerem com os valores padrão, a exibição ficará incorreta, para mais ou para menos, conforme os valores definidos por padrão.

Mantenha /v1 na URL base. O Cline acrescenta apenas a rota, então https://api.kunavo.com retorna 404, enquanto https://api.kunavo.com/v1 funciona. Um erro 401 indica que a URL está correta, mas a chave não.

Ainda não tem uma chave? Crie uma conta na Kunavo, gere uma chave (ela começa com sk-kn-) e adicione crédito a partir de $10 — as chamadas são pagas com esse saldo, e chamadas malsucedidas não são cobradas. O painel então abre na configuração de Cline.

Passo a passo

Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
Abra o painel de configurações do Cline (ícone ⚙︎) e escolha OpenAI Compatible como provedor de API.
Informe a URL base, a chave de API e o ID do modelo.
Expanda Configuração do modelo e defina a janela de contexto, o máximo de tokens de saída, o suporte a imagens e os dois preços.
Inicie uma tarefa. Os modos Plan/Act podem usar modelos diferentes, então combine um modelo de planejamento com outro mais barato para a execução, em vez de pagar a tarifa de planejamento por cada edição.

Verificado em página do provedor OpenAI Compatible do Cline em 6 de setembro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.

Esta é a versão resumida. O guia completo — escolha do modelo, custo de uma sessão real e modos de falha — está em guia passo a passo de Cline + Claude.

Verifique antes de depurar o cliente

Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em Cline.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qual ID de modelo inserir no campo

Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.

ID do modelo	Entrada / saída da Kunavo	Onde se encaixa em Cline
`claude-sonnet-5`	$1.40 / $7.00	modo Act — o modelo de trabalho padrão
`claude-opus-5`	$3.50 / $17.50	modo Plan, em que o plano define o custo do restante da tarefa
`claude-haiku-4-5`	$0.70 / $3.50	leituras de baixo custo e inspeções repetidas de arquivos
`gpt-5-6-terra`	$0.70 / $4.20	uma família diferente com a mesma chave, para obter uma segunda opinião

A cobrança é por token, usando um saldo pré-pago e sem tarifa mensal — consulte billing. Em contextos repetidos — que representam a maior parte do que um editor ou cliente de chat envia — o cache de prompt altera a conta mais do que a escolha do modelo.

Perguntas frequentes

Como uso o Cline com uma API personalizada compatível com OpenAI?

No painel de configurações do Cline, selecione "OpenAI Compatible" como provedor de API e informe a URL base do endpoint, sua chave de API e o ID do modelo desejado. A URL base deve ser a raiz /v1, porque o Cline acrescenta apenas a rota. Em seguida, o Cline usa o formato de transmissão da OpenAI para se comunicar com esse endpoint, independentemente de qual fornecedor realmente oferece o modelo.

O Cline pode usar modelos Claude sem uma chave de API da Anthropic?

Sim, quando os modelos são oferecidos por um endpoint compatível com OpenAI. O Cline repassa o ID do modelo sem alterações, então o endpoint, e não a extensão, resolve o ID Claude; a única credencial que o Cline armazena é a do endpoint. É assim também que uma única chave pode cobrir IDs Claude e GPT na mesma entrada de provedor.

Por que a estimativa de custo do Cline está errada?

Como o Cline calcula esse valor a partir dos campos Input Price e Output Price na seção de configuração do modelo, que são preenchidos manualmente e não consultados no endpoint. Se eles permanecerem com os valores padrão ou forem copiados de outro provedor, todos os valores de custo herdarão esse erro. Preencha-os com as tarifas realmente cobradas pelo endpoint para o ID do modelo selecionado.

A URL base do Cline deve terminar em /v1?

Sim, para um endpoint compatível com OpenAI. O Cline acrescenta a rota — /chat/completions — à URL base informada. Assim, https://api.example.com/v1 é resolvida, enquanto https://api.example.com envia a solicitação para um caminho inexistente. Um erro 404 aponta para a URL base; um 401 aponta para a chave.