Como usar o Aider com sua chave CodeAll
O Aider edita o seu repositório pelo terminal e faz commit sozinho. Apontando ele para a CodeAll, isso roda na sua assinatura, pagando em reais.
Se você ainda não tem chave, escolha um plano ou peça um trial de 24h grátis.
O detalhe que mais gera chamado: o endereço da API termina em https://api.tn1.top. Esta ferramenta monta o resto do caminho sozinha.
1. Pré-requisitos
- Uma chave CodeAll 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 endereço vai sem /v1 e o modelo leva o prefixo openai/.
| Sistema | Onde fica |
|---|---|
| macOS | ~/.aider.conf.yml |
| Linux | ~/.aider.conf.yml |
| Windows | %USERPROFILE%\.aider.conf.yml |
openai-api-base: https://api.tn1.top
model: openai/gpt-5.5- Exporte as duas variáveis:
export OPENAI_API_BASE=https://api.tn1.topeexport CODEALL_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.5 --message "responda OK" --yes.
De onde vem esta configuração. Ela foi extraída do código do OmniRoute, o roteador que a CodeAll usa por baixo (comando omniroute setup-aider). Nós ainda não executamos o Aider contra o gateway para conferir de ponta a ponta. Se algo divergir, escreva para suporte@tn1.top: corrigimos e creditamos o aviso.
3. Modelos disponíveis
O CodeAll junta as duas famílias na mesma chave: gpt-5.5 da OpenAI e os modelos da Anthropic (Opus 4.8, Sonnet, Haiku). Trocar de modelo é trocar uma linha do config.
No Aider o modelo é informado por --model openai/<modelo>.
O identificador leva prefixo: openai/gpt-5.5.
| Modelo | Como escrever |
|---|---|
gpt-5.5 | openai/gpt-5.5 |
Opus 4.8 | openai/Opus 4.8 |
Sonnet | openai/Sonnet |
Haiku | openai/Haiku |
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 sem /v1 | Funciona | O LiteLLM acrescenta /v1/chat/completions sozinho. Use https://api.tn1.top. |
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.5, não gpt-5.5 sozinho. |
404 no endereço | Você provavelmente pôs /v1 no openai-api-base. Esta ferramenta quer a raiz: https://api.tn1.top. |
401 dizendo que a chave está ausente ou inválida | O Aider lê a chave de OPENAI_API_KEY. Exportar só CODEALL_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. A mesma chave na próxima ferramenta
A sua chave CodeAll não é só do Aider. Ela responde nos dois formatos — o da OpenAI e o da Anthropic — então a ferramenta que fala GPT e a que fala Claude usam a mesma chave e a mesma assinatura.
Na prática: você deixa o Aider no modelo que preferir para a tarefa de agora e abre outra ferramenta com o modelo nativo dela, sem trocar de chave, sem uma segunda mensalidade e sem refazer configuração.
Ferramentas próximas do Aider, cobertas pela mesma chave: