Instalar e usar o Aider
O Aider é uma ferramenta de pair programming em IA para o terminal. O AI-School recomenda o Aider para codar com alunos, pois a ferramenta funciona de forma explícita e é menos agentiva do que muitos outros agentes de codificação.
O aluno recebe ajuda na programação, mas continua capaz de ver claramente quais arquivos são modificados.
Mais informações estão disponíveis no site do Aider e na documentação oficial do Aider.
Instalação
Para o Aider, você precisa primeiro de Python. Instale o Python 3 através do python.org ou através de um gerenciador de pacotes como o Homebrew.
Depois, verifique se o Python está disponível.
macOS e Linux
python3 --version
No macOS e em muitas instalações Linux, o comando Python 3 é chamado de python3 em vez de python. Portanto, use sempre python3 no guia.
Windows
py --version
No Windows, o Python normalmente é iniciado com py.
Instalar o Aider
A instalação recomendada de acordo com a documentação de instalação do Aider é via aider-install.
macOS e Linux
python3 -m pip install aider-install
aider-install
No macOS e Linux, o Aider também pode ser instalado com um script de instalação:
curl -LsSf https://aider.chat/install.sh | sh
No Windows, isso pode ser feito via PowerShell:
py -m pip install aider-install
aider-install
Ou com o script de instalação:
powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"
O Aider funciona melhor em uma pasta que é um repositório git. Portanto, instale também o git e incentive os alunos a trabalharem preferencialmente em uma pasta de projeto com controle de versão.
Conectar com Codificar
O Aider pode trabalhar com APIs compatíveis com OpenAI. Use para isso o endpoint Coderen e a chave de API do AI-School.
macOS e Linux
export OPENAI_API_BASE="https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
export OPENAI_API_KEY="sua-chave-api-ai"
Windows
setx OPENAI_API_BASE "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
setx OPENAI_API_KEY "sua-chave-api-ai"
Feche o terminal e abra um novo terminal para que o Windows use as novas variáveis.
Iniciar o Aider
Vá para a pasta do seu projeto:
cd caminho/para/seu/projeto
Inicie o Aider com um modelo permitido. Para alunos, recomendamos gpt-5.4-mini.
aider --model openai/gpt-5.4-mini
Para usuários avançados, pode ser escolhido um modelo mais poderoso:
aider --model openai/gpt-5.4
Trabalhar com arquivos
No Aider, você pode adicionar arquivos ao contexto:
/add src/main.py
Em seguida, peça ajuda, por exemplo:
Você pode explicar por que esta função não funciona?
Ou:
Torne a mensagem de erro mais clara para o usuário.
Comandos úteis
| Comando | Significado |
|---|---|
/add arquivo | Adiciona um arquivo ao chat |
/ask | Faça perguntas sem modificar o código diretamente |
/code | Peça ao Aider para ajustar o código |
/diff | Veja as mudanças |
/undo | Desfaça a última alteração do AI |
/exit | Encerra o Aider |
Ideal para a sala de aula
Peça aos alunos que usem o Aider como helper de programação, não como uma máquina de solução automática.
Boas tarefas incluem, por exemplo:
- “Explique o que significa esta mensagem de erro.”
- “Qual etapa eu devo investigar agora?”
- “Ajude-me a reduzir o tamanho desta função.”
- “Verifique se a minha solução é logicamente consistente.”
Menos adequado para iniciantes:
- “Faça toda a tarefa para mim.”
- “Construa a aplicação completa.”
- “Resolva tudo automaticamente.”