Aider con Claude tramite un gateway: ANTHROPIC_API_BASE, file di configurazione, modalità architect e soluzioni ai problemi

Aider invia ogni chiamata al modello tramite LiteLLM, quindi indirizzarlo a un gateway richiede un'impostazione di LiteLLM anziché di Aider. Per Claude questo significa ANTHROPIC_API_BASE impostato sulla radice dell'host del gateway e un nome di modello con il prefisso anthropic/ . Altre due impostazioni meno evidenti sono altrettanto importanti: gli ID Claude più recenti richiedono una voce nelle impostazioni del modello, altrimenti Aider ripiega su modifiche di file interi senza una mappa del repository.

Installa Aider

python -m pip install aider-install
aider-install

# or the one-line installer (installs Python 3.12 if needed)
curl -LsSf https://aider.chat/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

Se il comando aider non viene trovato dopo l'installazione, cosa comune su Windows, python -m aider esegue lo stesso programma.

Connettiti a Claude tramite il gateway

export ANTHROPIC_API_KEY=your_gateway_key
export ANTHROPIC_API_BASE=https://aiprimetech.io

aider --model anthropic/claude-sonnet-5

setx ANTHROPIC_API_KEY your_gateway_key
setx ANTHROPIC_API_BASE https://aiprimetech.io
# open a new terminal, then:
aider --model anthropic/claude-sonnet-5

La documentazione di Aider non tratta l'uso di un URL di base Anthropic personalizzato. La variabile viene letta da LiteLLM, che controlla ANTHROPIC_API_BASE prima e poi ANTHROPIC_BASE_URL, la variabile usata da Claude Code. Entrambe funzionano; se sono impostate entrambe, ANTHROPIC_API_BASE ha la precedenza.

Mantieni il prefisso anthropic/ nel nome del modello. Senza un prefisso del provider, LiteLLM non sa dove inviare un nome sconosciuto e fallisce con LLM Provider NOT provided.

Inserisci le impostazioni nei file di configurazione

Aider legge .aider.conf.yml e .env dalla tua directory home, dalla radice del repository git e dalla directory corrente, in quest'ordine, dando la precedenza ai file letti per ultimi. Un file nella directory home si applica a tutti i progetti.

model: anthropic/claude-sonnet-5
weak-model: anthropic/claude-haiku-4-5
set-env:
  - ANTHROPIC_API_BASE=https://aiprimetech.io
model-settings-file: ~/.aider.model.settings.yml
model-metadata-file: ~/.aider.model.metadata.json

ANTHROPIC_API_KEY=your_gateway_key

weak-model gestisce i messaggi di commit e i riepiloghi della cronologia della chat, quindi usare un modello economico per questo scopo permette di risparmiare in ogni sessione. set-env copia la variabile nell'ambiente prima di qualsiasi chiamata al modello, evitando così di inserire l'URL di base nel profilo della shell.

Mantieni le modifiche tramite diff e la mappa del repository sui modelli più recenti

Aider sceglie il formato delle modifiche in base al nome del modello. I nomi che riconosce, inclusi quelli che contengono sonnet-4-, opus-4- o haiku-4-, ricevono modifiche in formato diff e la mappa del repository. Un nome che non riconosce, come claude-sonnet-5, porta alla riscrittura di file interi e all'esclusione della mappa del repository. Questo rende le modifiche più lente e costose. Una voce nelle impostazioni ripristina il comportamento corretto:

- name: anthropic/claude-sonnet-5
  edit_format: diff
  use_repo_map: true
  weak_model_name: anthropic/claude-haiku-4-5

- name: anthropic/claude-opus-5-5
  edit_format: diff
  use_repo_map: true
  weak_model_name: anthropic/claude-haiku-4-5
  editor_model_name: anthropic/claude-sonnet-5
  editor_edit_format: editor-diff

Anche i modelli sconosciuti generano un avviso: Unknown context window size and costs, using sane defaults. È innocuo, ma Aider assume quindi una finestra illimitata e un prezzo pari a zero. Il file dei metadati fornisce valori reali:

{
  "anthropic/claude-sonnet-5": {
    "max_tokens": 64000,
    "max_input_tokens": 200000,
    "max_output_tokens": 64000,
    "input_cost_per_token": 0.000002,
    "output_cost_per_token": 0.00001,
    "litellm_provider": "anthropic",
    "mode": "chat"
  },
  "anthropic/claude-opus-5-5": {
    "max_tokens": 64000,
    "max_input_tokens": 200000,
    "max_output_tokens": 64000,
    "input_cost_per_token": 0.000004,
    "output_cost_per_token": 0.00002,
    "litellm_provider": "anthropic",
    "mode": "chat"
  }
}

I prezzi sono quelli di listino di Anthropic per token, quindi l'indicatore dei costi di Aider mostra il costo di listino; il gateway addebita meno. Un limite di input di 200K è una soglia operativa sicura anche quando un modello supporta valori maggiori.

Modalità architetto: pianifica con un modello, modifica con un altro

aider --architect --model anthropic/claude-opus-5-5 --editor-model anthropic/claude-sonnet-5

In modalità architetto, il modello principale propone la modifica e il modello editor la traduce in modifiche ai file. Usare un modello più potente per la pianificazione e uno più economico per le modifiche costa solitamente meno che usare il modello potente per entrambe le attività. All'interno di una sessione, /architect passa a questa modalità per un solo messaggio e /chat-mode architect passa a questa modalità per il resto della sessione.

La modalità compatibile con OpenAI

Il gateway supporta anche il formato Chat Completions di OpenAI, che è la modalità da usare per i modelli GPT sullo stesso account. Per questa modalità, l'URL di base include /v1, e il nome del modello usa il openai/ prefisso:

export OPENAI_API_KEY=your_gateway_key
export OPENAI_API_BASE=https://aiprimetech.io/v1

aider --model openai/claude-sonnet-5

Per Claude, preferisci la modalità nativa descritta sopra: i metadati del modello e la memorizzazione nella cache dei prompt sono allineati al formato di Anthropic. Se nel tuo ambiente è impostata una variabile indesiderata OPENAI_BASE_URL , LiteLLM la usa con precedenza rispetto a OPENAI_API_BASE.

Modelli

Gli alias brevi di Aider (sonnet, opus, haiku) puntano a ID di modelli meno recenti, quindi specifica esplicitamente il nome del modello. I vecchi ID con data, come claude-3-5-sonnet-20241022 , non sono disponibili.

Risoluzione dei problemi

Per gli errori che provengono dal modello anziché da Aider, consulta la guida agli errori dell'API di Claude.

Domande frequenti

AI Prime Tech è un gateway API indipendente. Non è affiliato ad Anthropic, non è approvato da Anthropic e non è un suo rivenditore. Claude e i nomi dei modelli correlati sono marchi dei rispettivi proprietari.