Como aponto o Aider para uma API compatível com OpenAI?

Defina OPENAI_API_BASE como https://aigrow.gg/v1 e OPENAI_API_KEY com a sua chave, depois execute aider --model openai/ seguido do ID do modelo, por exemplo openai/claude-opus-5.5.

O Aider consegue usar o Claude através de um URL base da OpenAI?

Sim. O endpoint disponibiliza também os modelos Claude no protocolo da OpenAI, por isso aider --model openai/claude-opus-5.5 executa o Claude com as mesmas duas variáveis.

De onde o Aider lê o .aider.conf.yml?

Da sua pasta pessoal, da raiz do repositório git e da pasta atual. Um valor num ficheiro posterior prevalece sobre um anterior.

Aider com uma OpenAI API base

Defina estas duas variáveis e inicie o Aider com openai/ antes do ID do modelo, e o Aider passa a funcionar com modelos Claude, GPT e Grok através da sua chave AIGROW.

Comprar crédito de API

Já tem um código? Resgate-o em Acesso à API e depois crie uma chave.

Shell, macOS e Linux

export OPENAI_API_BASE=https://aigrow.gg/v1
export OPENAI_API_KEY=ag_your_key_here

aider --model openai/claude-opus-5.5

Substitua ag_your_key_here por uma chave de Acesso à API.

Onde fica a definição

A sua pasta pessoal: ~/.aider.conf.yml
A raiz do repositório git: .aider.conf.yml

No Windows

O setx guarda as variáveis para as novas janelas, por isso abra uma nova shell antes de executar o aider.

setx OPENAI_API_BASE https://aigrow.gg/v1
setx OPENAI_API_KEY ag_your_key_here

Ou guarde-a no .aider.conf.yml

O Aider lê o ficheiro a partir da sua pasta pessoal, da raiz do git e da pasta atual, e prevalece o último.

openai-api-base: https://aigrow.gg/v1
openai-api-key: ag_your_key_here
model: openai/claude-opus-5.5

Que modelo usar

Introduza o id exatamente como está escrito aqui.

Claude Opus 5.5claude-opus-5.5: A opção predefinida em todos os blocos desta página e o modelo Claude mais barato aqui por token enviado e recebido. Contexto: 1 000 000 tokens.
Grok 4.7grok-4.7: O preço de saída mais baixo aqui. O seu contexto tem metade do tamanho dos modelos Claude. Contexto: 500 000 tokens.
GPT-6 Astragpt-6-astra: Para um modelo GPT. Custa o mesmo por token que o Fable e mais do que o Opus. Contexto: 1 050 000 tokens.
Claude Fable 5.1claude-fable-5.1: Custa mais por token do que o Opus. Compare os dois no ranking de programação antes de mudar. Contexto: 1 000 000 tokens.

A lista de preços tem todos os ids e a respetiva taxa de crédito, os preços da API do Claude indicam os preços de tabela e o ranking de programação compara os modelos em prompts de programação.

Verifique se funciona

Primeiro a chave isolada, depois o Aider com ela.

A chave

Peça a lista de modelos. Requer uma chave válida e não custa nada.

curl https://aigrow.gg/v1/models -H "Authorization: Bearer ag_your_key_here"

Uma chave válida devolve a lista:

{
  "object": "list",
  "data": [
    { "id": "claude-opus-5.5", "object": "model", ... },
    { "id": "claude-fable-5.1", "object": "model", ... },
    { "id": "gpt-6-astra", "object": "model", ... },
    { "id": "claude-sonnet-5.5", "object": "model", ... },
    { "id": "gpt-6.1-sol", "object": "model", ... },
    { "id": "grok-4.7", "object": "model", ... },
    ...
  ],
  "has_more": false
}

Aider

Envie uma mensagem a partir de um repositório git.

aider --model openai/claude-opus-5.5 --message "Reply with the word ready"

O Aider mostra as linhas de arranque, depois a resposta, e termina:

ready

Quando falha

Primeiro os erros do Aider, depois as respostas que o endpoint dá a qualquer ferramenta.

Tamanho da janela de contexto e custos desconhecidos: Um aviso inofensivo: o Aider não tem dados sobre o ID e usa valores predefinidos razoáveis. --no-show-model-warnings oculta-o. O custo de cada pedido está em API access.
O modelo não é encontrado: Coloque openai/ antes do ID, como em openai/claude-opus-5.5. Isto indica ao Aider que use OPENAI_API_BASE; sem isso, o Aider procura o modelo noutro lado.
A minha ferramenta indica 401 ou erro de autenticação: A chave está em falta ou foi escrita incorretamente. Copie-a de novo em Acesso à API no painel e certifique-se de que é enviada como chave, e não como nome de modelo. Uma chave revogada falha da mesma forma: crie uma nova e substitua-a.
Recebo 402 ou uma mensagem sobre crédito: O seu saldo está vazio. Abra Acesso à API no painel, resgate um código ou compre outro pacote e o pedido seguinte será processado. Não é preciso mudar mais nada.
Aparece 404 ou Unknown model: O modelo tem de ser um dos que o endpoint disponibiliza, por exemplo claude-opus-5.5. A grafia própria do fornecedor também funciona (claude-opus-5-5, anthropic/claude-opus-5.5), mas um id com data ou qualquer modelo fora do catálogo é rejeitado antes de o pedido ser encaminhado e nada é cobrado. Peça GET /v1/models com a sua chave para obter a lista atual, ou consulte os ids na lista de preços.
Os pedidos são rejeitados com 429: A capacidade do endpoint é partilhada por todos os clientes: cerca de 20 pedidos por minuto e 4 em simultâneo. Cada resposta 429 inclui um cabeçalho retry-after, e os SDKs da OpenAI e da Anthropic esperam esse tempo e voltam a tentar por conta própria. Num ciclo seu, aguarde os segundos indicados ou reduza a concorrência.
O modelo está indisponível neste momento: Um 404 que indica que o modelo não está disponível neste momento significa que ele está brevemente em baixo no fornecedor de origem, e não um problema com a sua chave ou saldo. Tente novamente daqui a pouco ou envie o pedido para outro modelo.
Recebo um 502 ou 503: Uma falha transitória na origem ou na configuração, sem qualquer cobrança no seu saldo. Repita o pedido; se continuar a falhar, contacte-nos através da loja e vamos analisar.

O que não funciona através da AIGROW

Os valores de custo do próprio Aider. Ele não conhece estes IDs, por isso não consegue calcular o preço; o registo de atividade em API access mostra quanto custou cada pedido.
Pesquisa web em tempo real dentro do modelo. Uma ferramenta de pesquisa web enviada num pedido é respondida com o que o modelo já sabe, sem resultados em tempo real. Uma ferramenta que obtém páginas na sua própria máquina continua a funcionar.
Qualquer endpoint além destes três: /v1/messages, /v1/chat/completions e /v1/models. A Responses API, os embeddings e a contagem de tokens respondem 404.
Campos de router como models, route, provider e plugins. São descartados, por isso um pedido vai sempre para o único modelo que indica.

Quanto custa um mês de Aider

O Aider é faturado por token às taxas de crédito da lista de preços. Um agente volta a enviar a conversa inteira a cada passo, por isso uma tarefa longa custa mais do que a última mensagem sugere; o registo de atividade em Acesso à API mostra quanto custou cada pedido.

Perguntas sobre o Aider e uma API personalizada

Como aponto o Aider para uma API compatível com OpenAI?: Defina OPENAI_API_BASE como https://aigrow.gg/v1 e OPENAI_API_KEY com a sua chave, depois execute aider --model openai/ seguido do ID do modelo, por exemplo openai/claude-opus-5.5.
O Aider consegue usar o Claude através de um URL base da OpenAI?: Sim. O endpoint disponibiliza também os modelos Claude no protocolo da OpenAI, por isso aider --model openai/claude-opus-5.5 executa o Claude com as mesmas duas variáveis.
De onde o Aider lê o .aider.conf.yml?: Da sua pasta pessoal, da raiz do repositório git e da pasta atual. Um valor num ficheiro posterior prevalece sobre um anterior.

Fontes: Aider OpenAI compatible APIs · Aider Options · Aider YAML config file · Aider Model warnings. Consultado em 21 de outubro de 2026.

Configurar outra ferramenta

Claude CodeProtocolo Anthropic
Quatro variáveis de ambiente, na shell ou no settings.json.
ClineProtocolo OpenAI
O fornecedor OpenAI Compatible, quatro campos no ecrã de definições.
Roo CodeProtocolo OpenAI
O fornecedor OpenAI Compatible, os mesmos campos do Cline.
Kilo CodeProtocolo OpenAI
Um fornecedor personalizado no separador Providers; a lista de modelos preenche-se sozinha.
ContinueProtocolo OpenAI
Uma entrada models no config.yaml, com provider openai e um apiBase.
OpenCodeProtocolo OpenAI
Um bloco provider no opencode.json e a chave através de /connect.
ZedProtocolos Anthropic e OpenAI
Um fornecedor compatível com Anthropic para Claude, um compatível com OpenAI para GPT e Grok.
GooseProtocolo OpenAI
O fornecedor OpenAI com OPENAI_HOST, ou um ficheiro de fornecedor personalizado.
Vercel AI SDKProtocolos Anthropic e OpenAI
O fornecedor OpenAI Compatible para todos os modelos, ou o fornecedor Anthropic para o Claude.
OpenAI Agents SDKProtocolo OpenAI
O seu próprio cliente AsyncOpenAI, mudado para chat completions, com o tracing desativado.
LangChainProtocolos Anthropic e OpenAI
ChatOpenAI com base_url para todos os modelos, ou ChatAnthropic para o Claude.

O guia da API inclui os SDKs, o curl, os endpoints e os limites de utilização.

Cole o bloco e o Aider passa a funcionar com o seu crédito.

Compre um pacote de crédito, resgate o código do seu email em Acesso à API, crie uma chave e coloque-a no lugar de ag_your_key_here.

Comprar crédito de API Ver preços e modelos