Configuração de Coding Agents

Configurar Continue CLI: API Key, Base URL e modelos

Instale o Continue CLI, configure a Base URL e a API Key da BetterToken, escolha um modelo compatível e corrija erros comuns. Com configuração e exemplos.

Para conectar o Continue CLI à BetterToken, prepare uma API Key, informe a Base URL abaixo e escolha um ID de modelo atual na model plaza.

Configurações principais

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

Pré-requisitos

A versão atual da ferramenta está instalada
Uma BetterToken API Key: cadastre-se e crie uma
Um ID de modelo da 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

Instale Node.js 20 ou posterior ao usar o método npm

Instalação

Instalar o Continue CLI

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/continuedev/continue/main/extensions/cli/scripts/install.sh | bash

Windows PowerShell

irm https://raw.githubusercontent.com/continuedev/continue/main/extensions/cli/scripts/install.ps1 | iex

npm (multiplataforma)

npm install -g @continuedev/cli

Depois da instalação, confirme que cn está disponível:

cn --version

Configuração manual

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

Configure API Key e Base URL

Defina a variável de ambiente da API Key

macOS / Linux

Execute isto no mesmo terminal que iniciará o Continue CLI:

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Windows PowerShell

Execute isto na mesma janela do PowerShell que iniciará o Continue CLI:

$env:BETTERTOKEN_API_KEY = "YOUR_API_KEY"

Substitua YOUR_API_KEY pela sua BetterToken API Key. Não versione a chave no Git nem a coloque em um arquivo de configuração compartilhado.

Crie config.yaml

Crie ou edite este arquivo no diretório do usuário:

macOS / Linux: ~/.continue/config.yaml
Windows: %USERPROFILE%\.continue\config.yaml

Adicione esta configuração:

name: BetterToken
version: 0.0.1
schema: v1

models:
  - name: BetterToken GPT
    provider: openai
    model: YOUR_MODEL_ID
    apiBase: "https://bettertoken.ai/v1"
    apiKey: ${{ secrets.BETTERTOKEN_API_KEY }}
    useResponsesApi: false

YOUR_MODEL_ID é apenas um exemplo. Substitua-o por um ID de modelo disponível atual da model plaza.

useResponsesApi: false indica a preferência de API do Continue. Ainda assim, o Continue pode escolher Responses ou Chat Completions conforme o modelo. O BetterToken oferece suporte às duas APIs, então ambas as rotas funcionam com esta Base URL. Quando precisar confirmar a rota usada, consulte os registros de solicitações no Dashboard. Nos testes com Continue CLI 1.5.47 e um modelo GPT, tanto useResponsesApi: false quanto true enviaram solicitações para /v1/responses. O Continue CLI 1.5.47 concluiu solicitações de texto e chamadas de ferramentas para leitura de arquivos por essa rota.

Inicie o Continue CLI

macOS / Linux

cn --config ~/.continue/config.yaml

Windows PowerShell

cn --config "$env:USERPROFILE\.continue\config.yaml"

Você pode entrar primeiro no diretório do projeto e depois executar o comando. Quando a configuração carregar, informe uma tarefa diretamente no Continue CLI.

Altere o modelo

Depois de alterar model em config.yaml, encerre a sessão atual de cn e inicie-a novamente. O ID de modelo precisa ser compatível com o endpoint configurado.

Para usar uma configuração separada em um projeto, salve-a nele e informe o caminho explicitamente:

cn --config ./continue-bettertoken.yaml

Teste a conexão

Envie um prompt curto. Se a ferramenta responder sem erro de autenticação ou de ID de modelo, a conexão funciona. Reinicie completamente a ferramenta após alterar a configuração.

Alterne entre modelos

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

Erros comuns

Sintoma	O que fazer
`401`, `Unauthorized` ou erro de API Key	Confirme que `BETTERTOKEN_API_KEY` está definida no terminal atual e é uma BetterToken API Key.
`model not found`	Confira o Model ID exato na model plaza e informe-o nas configurações de modelo do cliente.
Continue ainda usa uma configuração antiga	Inicie com `cn --config` e o caminho explícito. Confirme que o nome é `config.yaml`.
URL de solicitação errada ou `404`	Confirme que `apiBase` é `https://bettertoken.ai/v1`. Não acrescente `/chat/completions` nem um nome de modelo.
A variável da API Key não é resolvida	Defina `BETTERTOKEN_API_KEY` no mesmo terminal que inicia `cn` e execute-o novamente.
O modo Agent não está disponível para um Model ID personalizado	Se o modelo e o endpoint oferecerem chamadas de ferramentas nativas, adicione `capabilities: [tool_use]` à entrada do modelo em `config.yaml`. Consulte as configurações de recursos do Continue. Isso declara um recurso; não adiciona suporte a ferramentas ao modelo.

FAQ de configuração

Qual Base URL o Continue CLI deve usar?

Use https://bettertoken.ai/v1. Esta é a Base URL da BetterToken compatível com OpenAI.

Posso usar uma BetterToken API Key?

Sim. Use provider: openai com sua BetterToken API Key e seu Model ID. useResponsesApi: false indica uma preferência de API; o Continue pode escolher Responses ou Chat Completions conforme o modelo. O BetterToken oferece suporte às duas APIs. Para confirmar a rota usada, consulte os registros de solicitações no Dashboard.

Como vejo ou altero configurações salvas?

Informe /config em uma sessão do Continue CLI para ver e escolher configurações locais.

Configuração avançada

Guias relacionados

Detalhes técnicos

Protocolo, endpoint e campos internos do provedor

Esta configuração usa provider: openai, apiBase: "https://bettertoken.ai/v1" e useResponsesApi: false. A última opção indica a preferência de API do Continue; o Continue pode escolher /responses ou /chat/completions conforme o modelo. O BetterToken oferece suporte às duas rotas. Mantenha apiBase como mostrado, sem nenhum desses sufixos, e consulte os registros de solicitações no Dashboard para confirmar a rota usada.