🚀 Conectando o Aider aos Modelos Personalizados CodingPlanX

> Introdução: Este guia mostra como usar o Aider, o popular programador em par de IA de código aberto, com a API do CodingPlanX.ai para uma experiência de codificação de IA de alto nível baseada em terminal.

O Aider é um assistente de codificação de IA líder em CLI (mais de 39 mil estrelas no GitHub). Ele roda no seu terminal e suporta mais de 100 linguagens. Ao definir variáveis de ambiente simples, você pode conectar o Aider ao CodingPlanX.ai.

✨ Por que o Aider?

🆓 Totalmente Código Aberto: Pague apenas pelo uso da API através do CodingPlanX.ai.
🧠 Modo Arquiteto: Um sistema de modelo duplo onde um modelo planeja e o outro escreve o código.
🌳 Mapa do Repositório: Usa tree-sitter para entender toda a estrutura da sua base de código.
🔗 Integração Git: Cria automaticamente commits Git descritivos para cada alteração da IA.
⚡ Configuração Mínima: Conecte-se em segundos com apenas duas variáveis de ambiente.

🛠️ Instalação

1. Pré-requisitos

Python 3.8+ instalado.
Chave de API do CodingPlanX.ai (começa com cr_).

2. Instalar o Aider

# Recomendado: Instalar via pipx
pipx install aider-chat

# Alternativa: pip padrão
pip install aider-chat

⚙️ Configuração

Método 1: Variáveis de Ambiente (🌟 Recomendado)

Temporário (Sessão de terminal atual):

export OPENAI_API_BASE="https://api.codingplanx.ai/v1"
export OPENAI_API_KEY="cr_sua_chave_de_api"

Permanente (Adicionar ao arquivo de configuração): Adicione-os ao seu ~/.zshrc ou ~/.bashrc:

echo 'export OPENAI_API_BASE="https://api.codingplanx.ai/v1"' &gt;&gt; ~/.zshrc
echo 'export OPENAI_API_KEY="cr_sua_chave_de_api"' &gt;&gt; ~/.zshrc
source ~/.zshrc

Método 2: Argumentos de Linha de Comando

aider --openai-api-base "https://api.codingplanx.ai/v1" \
      --openai-api-key "cr_sua_chave_de_api" \
      --model openai/claude-sonnet-4-6

💻 Primeiros Passos

Uso Básico

cd /caminho/para/seu/projeto

# Iniciar o Aider com Claude Sonnet
aider --model openai/claude-sonnet-4-6

Modo Arquiteto (🌟 Altamente Recomendado)

O modo arquiteto usa um modelo "planejador" (como Opus) e um modelo "editor" (como Sonnet) para melhorar a qualidade enquanto gerencia os custos.

# Foco na Qualidade: Opus planeja + Sonnet edita
aider --architect --model openai/claude-opus-4-6 --editor-model openai/claude-sonnet-4-6

⌨️ Comandos de Barra (Slash) Comuns

Comando	Descrição
`/add file.py`	Adiciona um arquivo ao contexto da IA
`/drop file.py`	Remove um arquivo do contexto para economizar tokens
`/run pytest`	Executa testes e retorna os erros à IA para correção
`/undo`	Desfaz a última alteração de código da IA

⚖️ Aider vs. Claude Code CLI

Recurso	🤖 Aider	💻 Claude Code CLI
Código Aberto	Sim	Não (Proprietário)
Integração Git	Auto-commit	Commit manual
Fluxo de Trabalho	Multi-modelo (Arquiteto)	Modelo único
Contexto	Mapa do Repo (AST)	Janela Massiva de Tokens

❓ Solução de Problemas (FAQ)

Q: Erro "Model not found"? R: Certifique-se de incluir o prefixo openai/.

✅ Correto: openai/claude-sonnet-4-6

Q: Tempo Limite (Timeout) da API? R: Aumente o limite de tempo:

aider --model openai/claude-sonnet-4-6 --timeout 120