Instalar e usar o Aider
O Aider é uma ferramenta de pair-programming com IA para o terminal. A AI-School recomenda o Aider para codificação com alunos, pois a ferramenta funciona de forma explícita e é menos agente do que muitas outras soluções de coding agents.
O aluno recebe ajuda para programar, mas continua vendo claramente quais arquivos são alterados.
Mais informações estão disponíveis no site do Aider e na documentação oficial do Aider.
Instalar
Para o Aider, você precisa primeiro do Python. Instale o Python 3 através do python.org ou através de um gerenciador de pacotes como o Homebrew.
Verifique depois 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. Use, portanto, sempre python3 no guia.
Windows
py --version
No Windows o Python geralmente é 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 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 seja um repositório git. Portanto, instale também o git e permita que os alunos trabalhem preferencialmente em uma pasta de projeto com controle de versionamento.
Conectar com Codificar
O Aider pode trabalhar com APIs compatíveis com OpenAI. Use o endpoint Coderen e a chave de API do AI-School para isso.
macOS e Linux
export OPENAI_API_BASE="https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
export OPENAI_API_KEY="sua-chave-de-api-aí"
Windows
setx OPENAI_API_BASE "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
setx OPENAI_API_KEY "sua-chave-de-api-aí"
Feche o terminal e abra um novo terminal para que o Windows utilize as novas variáveis.
Iniciar o Aider
Vá até a pasta do seu projeto:
cd caminho/para/seu/projeto
Inicie o Aider com um modelo permitido. Para alunos, recomendamos gpt-5.6-luna.
aider --model openai/gpt-5.6-luna
Para usuários avançados, pode-se escolher um modelo mais forte:
aider --model openai/gpt-5.6-terra
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 | Adicionar um arquivo ao chat |
/ask | Fazer perguntas sem alterar o código diretamente |
/code | Pedir ao Aider para ajustar o código |
/diff | Ver as alterações |
/undo | Reverter a última mudança do IA |
/exit | Encerrar o Aider |
Conselho para a turma
Deixe os alunos usarem o Aider como uma ajuda de programação, não como uma máquina de resolver tudo automaticamente.
Boas tarefas são, por exemplo:
- “Explique o que significa esta mensagem de erro.”
- “Qual passo eu devo investigar agora?”
- “Ajude-me a tornar esta função menor.”
- “Verifique se a minha solução é lógica.”
Menos adequado para iniciantes:
- “Faça toda a tarefa para mim.”
- “Construa a aplicação completa.”
- “Resolva tudo automaticamente.”
