Configuração de Coding Agents

Configurar Cline: API Key, Base URL e modelos

Instale o Cline, configure a Base URL e a API Key do BetterToken, escolha um modelo disponível e resolva erros comuns. Para seu projeto.

Para conectar o Cline ao BetterToken, prepare uma API Key, informe a Base URL abaixo e escolha um Model ID atual no model plaza. Para interfaces semelhantes, consulte também Roo Code, Kilo Code e MonkeyCode.

Configurações principais

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Um Model ID atual do model plaza

Pré-requisitos

A versão atual da ferramenta está instalada
Uma BetterToken API Key: cadastre-se e obtenha uma
Um Model ID do model plaza

Cadastre-se e obtenha uma BetterToken API Key

Já tem uma conta? Entre, recarregue o saldo e crie uma chave no console.

Requisitos adicionais

VS Code instalado

Instalação

Instalar o Cline

Abra o VS Code, procure Cline no marketplace de extensões e instale-o.

Configuração manual

Conclua esta configuração na interface do Cline. Não é necessário editar um arquivo de configuração.

Campo	Valor
API Key	Sua BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Um Model ID atual do model plaza

Configuração

Remova variáveis de ambiente conflitantes

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Abra a interface de configuração do Cline

Clique em Use your own API key na barra lateral do Cline.

Configure o provedor de API

Preencha os campos:

API Provider → OpenAI Compatible
Base URL → https://bettertoken.ai/v1
API Key → sua BetterToken API Key
Model → um Model ID disponível copiado do model plaza

Em Model Configuration, informe os limites de contexto e saída confirmados para o modelo selecionado. Ative os recursos de imagem ou Computer Use somente quando o modelo e o endpoint oferecerem suporte; consulte as configurações de provedor do Cline.

Configure headers extras somente quando a documentação oficial exigir

A documentação oficial de configuração compatível com OpenAI do Cline se concentra em Base URL, API Key e Model ID. Normalmente, não é necessário um User-Agent extra para conectar o BetterToken.

Se você também usa um gateway personalizado, roteamento de tenant ou uma camada de observabilidade ou cache, adicione headers somente de acordo com a documentação oficial desse serviço upstream.

Salve a configuração

Clique em Done.

Reinicie o Cline

Depois de salvar a configuração, reinicie o VS Code ou recarregue a extensão Cline para aplicar os novos ajustes.

Verificar a conexão

Use Verify nas configurações do provedor para testar a conexão.

Envie uma solicitação curta de teste. Se a ferramenta responder sem erros de autenticação ou de Model ID, a conexão funciona. Reinicie completamente a ferramenta depois de alterar a configuração.

Cline CLI

Instale o Cline CLI oficial separadamente da extensão para VS Code. Nos testes em macOS com um modelo GPT, o Cline CLI 3.0.73 concluiu solicitações de texto e chamadas de ferramentas para leitura de arquivos.

Substitua YOUR_API_KEY pela sua BetterToken API Key e YOUR_MODEL_ID por um ID exato da model plaza e faça a autenticação:

cline auth --provider openai --apikey YOUR_API_KEY --baseurl https://bettertoken.ai/v1 --modelid YOUR_MODEL_ID

Execute uma verificação de texto não interativa:

cline --json --retries 2 --timeout 170 --provider openai --model YOUR_MODEL_ID "Reply with only: OK"

Confira se a resposta final é OK. Nos testes, o parâmetro --provider openai do CLI foi registrado como openai-compatible; seu valor na linha de comando difere da opção OpenAI Compatible do IDE. Se usar --data-dir para selecionar um diretório de configuração, passe o mesmo diretório aos dois comandos.

Trocar de modelo

Abra o seletor de modelos ou altere o campo Model na configuração. Use o Model ID exato do model plaza e reinicie a sessão atual.

Erros comuns

Erro	O que verificar
`401` ou `Unauthorized`	Verifique a BetterToken API Key e remova espaços no início ou no fim.
`404`	Verifique a Base URL e não acrescente o caminho de um endpoint específico.
`model not found`	Copie um Model ID atual do model plaza.
As alterações não são aplicadas	Salve a configuração e reinicie completamente a ferramenta.

Detalhes técnicos

Protocolo, endpoint e campos internos do provedor

Esta configuração usa https://bettertoken.ai/v1. A ferramenta acrescenta o caminho do endpoint compatível com OpenAI. Não adicione /chat/completions nem /responses, a menos que um campo específico exija isso explicitamente.