Torna al blog

Strumenti e integrazioniGuida

File di configurazione di Aider per la tua chiave API: .aider.conf.yml e setx su Windows

Tieni la tua chiave API e la base URL in .aider.conf.yml, ottieni l'ordine di caricamento corretto ed evita la trappola di setx su Windows, con una stima del costo di una sessione.

Di CheapTokens TeamPubblicato il 4 min di lettura

Terminale con i comandi che collegano Aider a un'API compatibile con OpenAI
In questa pagina
  1. Windows: setx e un nuovo terminale
  2. Quale modello per quali modifiche
  3. Esegui una prima modifica
  4. Smetti di ridigitare: .aider.conf.yml
  5. Quanto costa una sessione
  6. Se non funziona

Due variabili, OPENAI_API_BASE e OPENAI_API_KEY, e un argomento model come openai/<model id> bastano per puntare Aider su CheapTokens. Le basi passo passo (installazione, prima richiesta, 401/404/400/402) sono in How to connect Aider to CheapTokens; questa pagina copre ciò che quella guida omette: setx su Windows, il file di configurazione e il suo ordine di caricamento, e una stima del costo di una sessione.

Fonte: la documentazione di Aider per le API compatibili con OpenAI (pagina verificata il 26 ottobre 2026; la documentazione non mostra data né versione, e l'ultima aider-chat su PyPI quel giorno era 0.86.2).

Windows: setx e un nuovo terminale#

Su Mac e Linux export le due variabili. Su Windows (PowerShell o cmd) usa setx:

bat
setx OPENAI_API_BASE https://api.cheaptokens.dev/v1
setx OPENAI_API_KEY <your CheapTokens key>

Su Windows c'è una trappola. setx scrive le variabili per le sessioni future, non per quella in cui stai digitando, quindi chiudi il terminale e aprine uno nuovo prima di avviare Aider. Se imposti le variabili e Aider chiede ancora una chiave, questo è il motivo più comune.

Quale modello per quali modifiche#

L'argomento model è openai/ più l'id completo, quindi per CheapTokens ha due slash:

bash
cd your-git-repo
aider --model openai/MiniMaxAI/MiniMax-M2.7

MiniMax-M2.7 ha un contesto di 180K e risponde fino a 8.192 token, adatto a modifiche piccole e medie dove le risposte restano brevi. Se le tue modifiche tornano come diff lunghi, l'altro modello da provare è DeepSeek-V4-Flash: fino a 32.768 token per risposta, un contesto di 380K e un prezzo unico a qualsiasi ora del giorno.

bash
aider --model openai/deepseek-ai/DeepSeek-V4-Flash-0731

Copia l'id completo dalla documentazione di CheapTokens o dalla lista dei modelli su pricing.

Esegui una prima modifica#

Aider lavora dentro un repo git, quindi inizia in uno. Aggiungi un file e chiedi qualcosa di piccolo:

text
> /add app.py
> Add a --verbose flag that prints each file before it is processed

Quando Aider risponde con una modifica al file, la chiave, la base URL e l'id del modello sono tutti corretti.

L'id del modello sbagliato accanto all'id completo che funziona, poi la prima modifica
Id sbagliato contro id completo, e la prima richiesta

Smetti di ridigitare: .aider.conf.yml#

Aider legge .aider.conf.yml dalla tua home directory, poi dalla root del repo git, poi dalla directory corrente, e i file successivi hanno la precedenza. Quindi un file globale può contenere la chiave e la base, e un file del repo può scegliere il modello. Se vuoi un solo file specifico e nient'altro, aider --config <file> carica solo quello.

Un file nella home directory (esempio, inserisci la tua chiave):

yaml
openai-api-base: https://api.cheaptokens.dev/v1
openai-api-key: <your CheapTokens key>
model: openai/MiniMaxAI/MiniMax-M2.7

Ora aider da solo parte con l'endpoint e il modello giusti. Se committi il file in un repo, lascia fuori la chiave e tienila nella variabile d'ambiente o in un file .env; le righe della chiave sono per la tua home directory.

Per un modello che Aider non conosce, la documentazione descrive un model-settings-file (.aider.model.settings.yml) dove puoi specificarne le impostazioni.

Quanto costa una sessione#

Aider reinvia i file che hai aggiunto e la cronologia della chat a ogni messaggio, quindi i token di input crescono più velocemente di quelli di output. Diciamo che una sessione di lavoro di circa 20 messaggi invii 400.000 token di input e riceva 40.000 token di output (un'ipotesi per l'esempio; inserisci i tuoi numeri). Su MiniMax-M2.7 sono $0.026, e in totale meno caro di OpenRouter, con input e output contati insieme. La tabella sotto esegue la stessa sessione sui nostri modelli:

Modello Costo OpenRouter
GLM-5.3-Flash $0.0096 $0.0196
DeepSeek-V4-Flash $0.01 $0.0253
MiniMax-M2.7 $0.026 $0.168

400.000 token di input e 40.000 token di output in totale. I prezzi per 1M di token sono attuali e cambiano insieme alle nostre tariffe; la colonna OpenRouter mostra i prezzi di riferimento per lo stesso carico di lavoro.

Come mantenere piccolo il lato input (file in sola lettura, /drop, dimensione della repo map) è trattato in How much does Aider cost. I prezzi attuali sono sempre sulla pagina pricing.

Se non funziona#

  • Aider chiede una chiave API o parla con il servizio sbagliato. Le variabili non sono visibili al processo. Su Windows, riavvia il terminale dopo setx; su Mac e Linux, esegui echo $OPENAI_API_BASE nella stessa shell.
  • La tua configurazione sembra ignorata. Ricorda l'ordine: home, root del repo, directory corrente. Un file più vicino a te sovrascrive quello globale.
  • Modello non trovato, 404 o errore di autenticazione. Questi sono trattati in How to connect Aider to CheapTokens.

Lo stesso indirizzo compatibile con OpenAI funziona in altri strumenti; se usi anche un agente editor, vedi connecting OpenCode o la panoramica su where to plug in your own API key.

Tag: