Configurações principais
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
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.Configuração
1
Remova variáveis de ambiente conflitantes
2
Abra a interface de configuração do Cline
Clique em Use your own API key na barra lateral do Cline.
3
Configure o provedor de API
Preencha os campos:
- API Provider →
OpenAI Compatible - Base URL →
https://www.bettertoken.ai/v1 - API Key → sua BetterToken API Key
- Model → um Model ID de um provedor compatível copiado do model plaza
4
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.5
Salve a configuração
Clique em Done.
6
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
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.Trocar de modelo
Abra o seletor de modelos ou altere o campoModel na configuração. Use o Model ID exato do model plaza e reinicie a sessão atual.
Erros comuns
- Como configurar uma API compatível com OpenAI no Cline
- API compatível com OpenAI ou API compatível com Anthropic
- MCP ou API Key e Base URL
- Como configurar uma API OpenAI personalizada no Cursor
Verifique primeiro a
Base URL, a API Key, o Model ID e a versão da ferramenta. Não presuma que User-Agent seja uma configuração obrigatória do BetterToken.Configuração avançada
Provedores compatíveis
Os status se aplicam ao método de configuração do BetterToken descrito nesta página.
O que significa cada método de configuração
O que significa cada método de configuração
- Configuração manual: informe a API Key, a Base URL e o Model.
- Sem suporte: ainda não há um método verificado de conexão direta.
Detalhes técnicos
Protocolo, endpoint e campos internos do provedor
Protocolo, endpoint e campos internos do provedor
Esta configuração usa
https://www.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.