Cline

Agente de código open source para o VS Code que usa a API compatível com a OpenAI da OneProvider.

Agente de código Cline para o VS Code

O que funciona

O Cline envia pela OneProvider requisições de texto e de agente de código compatíveis com a OpenAI, com um ID de modelo compatível que você escolhe no catálogo.

Limitação do cliente

Os recursos de imagem, de uso de ferramentas e de contexto dependem do modelo escolhido; confira antes com uma tarefa de texto pequena.

Configuração

1. Escolha OpenAI Compatible

   Nas configurações de API Provider do Cline, escolha OpenAI Compatible e cole a sua chave da OneProvider.

   API Provider: OpenAI Compatible
   API Key: sk-your-key-here

2. Defina a base URL personalizada

   Defina a base URL como https://api.oneprovider.dev/v1 e o ID exato do modelo como gpt-6.1-terra.

   Base URL: https://api.oneprovider.dev/v1
   Model ID: gpt-6.1-terra

3. Comece com uma tarefa de texto pequena

   Abra uma nova sessão do Cline e peça uma explicação pequena, somente leitura, antes de ativar recursos específicos do modelo.

Verificar a conexão

Confirme a requisição em Consumo no Dashboard

A requisição deve mostrar o modelo configurado e uma linha de consumo (API compatível com a OpenAI) com o valor debitado.

Dados da conexão

Protocolo

openai-chat

Endpoint

https://api.oneprovider.dev/v1

Segurança da chave

Use uma chave dedicada com limites de modelo, de requisições, de gastos e de validade; nunca inclua a chave em um commit nas configurações do workspace.

Qual modelo escolher

O Cline usa o provedor OpenAI Compatible, então informe o ID do modelo exatamente como no catálogo . gpt-6.1-terra é um padrão equilibrado para tarefas de código, gpt-6.1-sol serve para trabalho grande com vários arquivos e gpt-5.6-luna é barato para perguntas rápidas. IDs Claude também funcionam pelo mesmo provedor, por exemplo claude-sonnet-5-5. Entrada de imagem, uso de ferramentas e tamanho de contexto dependem do modelo exato, então comece com uma tarefa pequena, somente leitura. Se o Cline pedir a janela de contexto ou o máximo de saída, copie os valores da linha do modelo no catálogo.

Erros comuns e soluções

404 ou “Invalid URL”

A base URL deve ser https://api.oneprovider.dev/v1: com /v1 e sem /chat/completions.

401 Unauthorized

Falta um caractere na chave, ou há um espaço ou aspa em volta, ou o saldo está zerado. Cole a chave inteira de novo e confira o painel.

“Model not found” ou um 400 sobre o modelo

O ID tem um erro de digitação ou não está no catálogo. Copie-o da página de modelos; a correspondência é exata e diferencia maiúsculas de minúsculas.

429 “Insufficient balance”

O saldo ou o limite de gastos da chave acabou. Tentar de novo não resolve: recarregue o saldo ou aumente o limite.

O agente para depois de um passo

O modelo escolhido pode não lidar bem com chamadas de ferramentas. Escolha um modelo de ponta ou equilibrado e mantenha a tarefa pequena.

O streaming quebra ou trava

Desligue VPN ou proxies VLESS: eles seguram o SSE em buffer. A OneProvider não faz isso.

Perguntas frequentes

Qual provedor escolho no Cline?

OpenAI Compatible. Cole a chave da OneProvider e a base URL acima.

Posso usar modelos Claude no Cline?

Pode, informe um ID Claude no mesmo provedor OpenAI Compatible, ou use o provedor Anthropic do Cline com a base URL personalizada https://api.oneprovider.dev, se a sua versão oferecer.

Minha chave fica guardada no repositório?

Não, o Cline a guarda no armazenamento de segredos do VS Code. Mesmo assim, use uma chave dedicada com limite de gastos e nunca a inclua em um commit nas configurações do workspace.

Onde vejo o consumo?

Na página Consumo do Dashboard: cada requisição mostra o modelo e o valor debitado.

Respostas rápidas

Qual base URL devo usar?

O Claude Code e os SDKs da Anthropic usam https://api.oneprovider.dev. Os SDKs da OpenAI e os clientes compatíveis com a OpenAI usam https://api.oneprovider.dev/v1. Uma única chave funciona nos dois; a lista de modelos está na página de modelos e os preços, na página de preços .

Como me autentico?

Envie a chave sk-… pura em x-api-key ou em Authorization: Bearer: um dos dois, nunca ambos. Guarde a chave em uma variável de ambiente, não em um arquivo que vai para o commit. Mais sobre autenticação .

Onde consigo uma chave?

Abra o seu painel no bot do Telegram @oneprovider_robot ou em app.oneprovider.dev, recarregue o saldo e toque em “Emitir chave”. Cada chave pode ter o seu próprio limite de gastos. Painel e chaves de API .

O que significam 401, 404 e 429?

401: a chave está ausente, foi digitada errado ou enviada no cabeçalho errado; cole a chave inteira, sem aspas nem espaços. 404: em geral, uma base URL errada, por exemplo um /v1 ausente ou duplicado. 429 com “Insufficient balance”: o saldo do painel ou o limite de gastos da chave acabou, então recarregue em vez de tentar de novo; qualquer outro 429 é um limite de requisições, então aguarde o tempo de Retry-After. Detalhes: códigos de erro e solução de problemas .

Por que os streams são cortados ou reiniciados?

VPNs e proxies VLESS costumam armazenar SSE em buffer ou quebrar a negociação do HTTP/2. A OneProvider não tem restrições regionais e não armazena streams em buffer; desative o proxy e tente de novo.

Onde pergunto se isso não bastar?

Escreva para @Oneproviderhelpbot no Telegram ou abra “Suporte” no painel web, informando o código de status HTTP e a mensagem de erro exata. Como funciona o suporte .