Como usar o Aider com sua chave CodeMax
O Aider edita o seu repositório pelo terminal e faz commit sozinho. Apontando ele para a CodeMax, 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. Esta ferramenta monta o resto do caminho sozinha.
1. Pré-requisitos
- Uma chave CodeMax 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/Opus 4.8- Exporte as duas variáveis:
export OPENAI_API_BASE=https://api.tn1.topeexport CODEMAX_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/Opus 4.8 --message "responda OK" --yes.
De onde vem esta configuração. Ela foi extraída do código do OmniRoute, o roteador que a CodeMax 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 CodeMax é feito para rodar Opus 4.8 sem contar tokens. Sonnet e Haiku ficam disponíveis para quando a tarefa não pedir o modelo maior.
No Aider o modelo é informado por --model openai/<modelo>.
O identificador leva prefixo: openai/Opus 4.8.
| Modelo | Como escrever |
|---|---|
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/Opus 4.8, não Opus 4.8 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ó CODEMAX_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. Em sessão longa
O CodeMax existe para a sessão que não acaba em dez minutos. O Aider dispara várias chamadas por tarefa, e é aí que o teto de uso costuma aparecer.
Por isso o padrão aqui é o Opus 4.8: não há motivo para trocar por um modelo menor no meio da tarefa só para economizar chamada. Se a sessão passar de uma hora, o que costuma atrapalhar não é o teto, é o contexto acumulado — recomece a conversa quando o assunto mudar, em vez de arrastar o histórico inteiro.
Outras ferramentas de uso contínuo, na mesma chave: