Configurações principais
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
Requisitos adicionais
- Instale Python
Instalação
Instalar o Aider
Execute os comandos a seguir em um terminal:Configuração manual
Configure a BetterToken no terminal atual
- macOS / Linux
- Windows PowerShell
YOUR_API_KEY pela sua BetterToken API Key. YOUR_MODEL_ID é apenas um exemplo. Substitua-o por um ID de modelo de um provedor compatível atual da model plaza e mantenha o prefixo openai/.
Salve a configuração com .env
Para não definir variáveis sempre que abrir um terminal, crie um arquivo.env na raiz Git do projeto:
.env ao .gitignore para que a API Key não seja enviada ao repositório. Depois entre no diretório do projeto e execute:
Opcional: use .aider.conf.yml
Para persistir somente configurações não confidenciais, crie.aider.conf.yml no diretório pessoal ou do projeto:
OPENAI_API_KEY, e não em um arquivo YAML compartilhado.
Alterar o Model ID
Substitua o modelo no comando de inicialização por um ID de modelo de um provedor compatível atual:openai/. O ID de modelo deve ser compatível com o endpoint configurado.
Verificar a conexão
Envie um prompt de teste curto. Se a ferramenta retornar uma resposta sem erro de autenticação ou de ID de modelo, 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 ID de modelo exato da model plaza e reinicie a sessão atual.
Erros comuns
FAQ de configuração
Qual Base URL o Aider deve usar? Usehttps://www.bettertoken.ai/v1. Esta é a Base URL da BetterToken compatível com OpenAI.
Por que o nome do modelo precisa do prefixo openai/?
O Aider usa esse prefixo para identificar um modelo compatível com OpenAI. Omiti-lo pode fazer o Aider selecionar o provedor errado.
Posso colocar a API Key em .aider.conf.yml?
Não recomendamos. Use variáveis de ambiente ou um arquivo .env ignorado pelo Git para reduzir o risco de expor uma API Key nos arquivos do projeto.
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.
Guias relacionados
- Configuração de modelo personalizado no Continue CLI
- Configuração de provedor personalizado no Codex CLI
- Configuração de API personalizada, Base URL e API Key no Cursor
- Configurar uma API compatível com OpenAI no Cline
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 de endpoint compatível com OpenAI. Não adicione /chat/completions ou /responses, exceto quando um campo específico exigir isso.