Como usar o Aider com sua chave GPTAll
O Aider edita o seu repositório pelo terminal e faz commit sozinho. Apontando ele para a GPTAll, isso roda na sua assinatura, pagando em reais.
Se você ainda não tem chave, escolha um plano ou peça um teste grátis.
O detalhe que mais gera chamado: o endereço da API termina em https://api.tn1.top/v1 — com o /v1. O Aider acrescenta só /chat/completions ao final. Sem o /v1 o pedido não chega autenticado e você recebe 401.
1. Pré-requisitos
- Uma chave GPTAll ativa.
- O Aider instalado:
python3 -m pip install --user aider-install && aider-install
2. Configurar o Aider
O Aider usa o LiteLLM por baixo, e é isso que define duas particularidades: o modelo leva o prefixo openai/, e o endereço vai com /v1 — o LiteLLM acrescenta apenas /chat/completions ao que você configurar.
| Sistema | Onde fica |
|---|---|
| macOS | ~/.aider.conf.yml |
| Linux | ~/.aider.conf.yml |
| Windows | %USERPROFILE%\.aider.conf.yml |
openai-api-base: https://api.tn1.top/v1
model: openai/gpt-5.6-luna- Exporte as duas variáveis:
export OPENAI_API_BASE=https://api.tn1.top/v1eexport GPTALL_API_KEY="sua-chave"(o Aider lê a chave deOPENAI_API_KEY; exporte também com esse nome). - Rode
aiderna pasta do projeto. - Sem interface:
aider --model openai/gpt-5.6-luna --message "responda OK" --yes.
De onde vem esta configuração. Ela foi extraída do código do OmniRoute, o roteador que a GPTAll usa por baixo (comando omniroute setup-aider) e corrigida por medição: rodamos o Aider 0.86.2 para ver qual caminho ele monta a partir deste endereço e medimos a resposta do gateway a esse caminho exato. Uma sessão completa de edição de arquivos contra a GPTAll ainda não foi executada. Se algo divergir, escreva para suporte@tn1.top: corrigimos e creditamos o aviso.
3. Modelos disponíveis
O GPTAll anuncia 3 nomes, todos 100% Codex: gpt-5.6-luna (rápido, dia a dia), gpt-5.6-sol (raciocínio profundo) e gpt-5.6-terra (equilíbrio entre custo e qualidade). O gateway responde igual em todos — é o mesmo nome nos planos pagos e no trial.
No Aider o modelo é informado por --model openai/<modelo>.
O identificador leva prefixo: openai/gpt-5.6-luna, openai/gpt-5.6-sol ou openai/gpt-5.6-terra.
| Modelo | Como escrever |
|---|---|
gpt-5.6-luna | openai/gpt-5.6-luna |
gpt-5.6-sol | openai/gpt-5.6-sol |
gpt-5.6-terra | openai/gpt-5.6-terra |
4. O que funciona
| Recurso | Status | Observação |
|---|---|---|
| Edição de arquivos e commit automático | Não testamos | É o modo padrão do Aider; não executamos aqui. |
Endereço com /v1 | Funciona | O Aider acrescenta apenas /chat/completions, não o /v1. Medido no Aider 0.86.2: com a raiz ele pede /chat/completions e o gateway responde 401; com https://api.tn1.top/v1 ele pede /v1/chat/completions e o gateway responde 200. |
Prefixo openai/ no modelo | Funciona | Sem ele o LiteLLM não sabe qual formato de API falar e erra antes de sair da sua máquina. |
| Chave fora do disco | Funciona | Fica em variável de ambiente; o .aider.conf.yml guarda só endereço e modelo. |
5. Troubleshooting
| Sintoma | O que fazer |
|---|---|
LLM Provider NOT provided ou modelo não reconhecido | Faltou o prefixo: é openai/gpt-5.6-luna (ou openai/gpt-5.6-sol / openai/gpt-5.6-terra), não gpt-5.6-luna sozinho. |
401 dizendo que a chave está ausente ou inválida | Antes de suspeitar da chave, confira o endereço: quase sempre é o /v1 faltando no openai-api-base. Use https://api.tn1.top/v1. O gateway só autentica caminhos que começam em /v1/ ou /api/: sem isso, qualquer chave recebe 401. |
401 mesmo com o endereço correto | O Aider lê a chave de OPENAI_API_KEY. Exportar só GPTALL_API_KEY não basta. |
6. FAQ
Ele altera meus arquivos sozinho?
Sim, é o propósito dele, e faz commit. Trabalhe numa branch.
Por que o prefixo openai/?
O Aider roteia por LiteLLM, que usa o prefixo para escolher o formato da API.
Dúvida que não está aqui? Fale com a gente em suporte@tn1.top.
7. O mesmo modelo em qualquer ferramenta
O GPTAll não é a chave de "tanto faz qual modelo responde". No Aider, como em qualquer outra ferramenta compatível, o nome que você configura é sempre um dos 3 — gpt-5.6-luna, gpt-5.6-sol ou gpt-5.6-terra — todos 100% Codex.
Isso significa que trocar de ferramenta não muda o que você recebe: a mesma chave, o mesmo nome de modelo, o mesmo comportamento — só a interface muda.
Outras ferramentas com o mesmo modelo travado, na mesma chave: