Como usar o Aider com sua chave CodeJato
O Aider edita o seu repositório pelo terminal e faz commit sozinho. Apontando ele para a CodeJato, 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 CodeJato 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/Sonnet
- Exporte as duas variáveis:
export OPENAI_API_BASE=https://api.tn1.topeexport CODEJATO_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/Sonnet --message "responda OK" --yes.
De onde vem esta configuração. Ela foi extraída do código do OmniRoute, o roteador que a CodeJato 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 CodeJato vende os modelos da Anthropic em reais. Use Opus 4.8 no trabalho pesado, Sonnet no dia a dia e Haiku quando velocidade importa mais que profundidade.
No Aider o modelo é informado por --model openai/<modelo>.
O identificador leva prefixo: openai/Sonnet.
| 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/Sonnet, não Sonnet 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ó CODEJATO_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.