Gli agenti di coding rimandano grandi parti del repository a ogni turno, quindi con la fatturazione per token il conto sale in fretta. Una sessione con piano illimitato elimina il contatore. I passaggi seguono la configurazione compatibile con OpenAI di Aider.
1. Installa Aider
python -m pip install aider-install
aider-install
2. Puntalo su BroadNet Inference
export OPENAI_API_BASE=https://inference.broadnet.ai/v1
export OPENAI_API_KEY='your-broadnet-plan-key'
Su Windows usa setx OPENAI_API_BASE https://inference.broadnet.ai/v1 e setx OPENAI_API_KEY your-key, poi apri un nuovo terminale. La documentazione di Aider dice di riavviare la shell dopo setx.
Lascia il /v1 alla fine del base URL: il percorso di chat completions lo aggiunge Aider.
3. Avvialo sul tuo codice
cd /path/to/your/project
aider --model openai/broadnet/deepseek-v4.1-flash
Il prefisso openai/ dice ad Aider di usare l’endpoint compatibile con OpenAI; il resto è l’ID del modello su BroadNet. Aider mostrerà l’avviso “Unknown context window size and costs, using sane defaults.” (traduzione: «Dimensione della finestra di contesto e costi sconosciuti, uso valori predefiniti ragionevoli.»). È normale per i modelli fuori dal suo elenco integrato. La sua pagina sugli avvisi dei modelli dice che di solito si può ignorare.
4. Facoltativo: descrivi il modello ad Aider
Per togliere l’avviso e lasciare al modello spazio per ragionare, aggiungi due file nella tua home o nella radice del repository. Aider li legge da entrambe le posizioni, come spiega la documentazione sulle impostazioni avanzate dei modelli.
.aider.model.metadata.json:
{
"openai/broadnet/deepseek-v4.1-flash": {
"max_input_tokens": 1048576,
"litellm_provider": "openai",
"mode": "chat"
}
}
.aider.model.settings.yml:
- name: openai/broadnet/deepseek-v4.1-flash
edit_format: diff
extra_params:
max_tokens: 16000
Per i modelli sconosciuti Aider usa il formato di modifica whole, che rimanda i file interi. diff invia solo i blocchi modificati. Se le modifiche non si applicano, togli la riga edit_format per tornare a whole.
Consigli
- Una finestra di Aider, una sessione. Se fai girare due istanze di Aider contemporaneamente, acquista due sessioni, altrimenti si mettono in coda una dietro l’altra.
- Il ragionamento consuma token. DeepSeek V4.1 Flash ragiona prima di rispondere, e BroadNet lo conta in
max_tokens. Perché le risposte arrivano vuote. - Prova prima un’ora. Un piano Meteor costa $1 per un’ora, abbastanza per valutarlo su un task reale.
Risoluzione dei problemi
- 401 Unauthorized.
OPENAI_API_KEYmanca, è sbagliata o scaduta. Controlla che la shell in cui gira Aider abbia la variabile; su Windows apri un nuovo terminale doposetx. - Le richieste vanno a OpenAI invece che a BroadNet.
OPENAI_API_BASEnon è impostata in questa shell, oppure il nome del modello non ha il prefissoopenai/. Controlla conecho $OPENAI_API_BASE. - Modello non trovato. La parte dopo
openai/deve essere esattamentebroadnet/deepseek-v4.1-flash. Una chiave di piano copre solo DeepSeek V4.1 Flash; gli altri modelli BroadNet richiedono una chiave a consumo. - Risposte vuote o troncate. Alza
max_tokensin.aider.model.settings.ymlcome mostrato sopra. - Le modifiche non si applicano. Riporta
edit_formatawhole, oppure prova--edit-format wholeda riga di comando. - Risposte lente o 429. Una sessione del piano esegue una richiesta alla volta; una seconda finestra di Aider finisce in coda. Una chiave a consumo consente 30 richieste al minuto e 4 contemporaneamente. Vedi errori e retry.
Preferisci un agente dentro VS Code? Vedi la guida alla configurazione di Cline, oppure confrontali in Cline vs Roo Code vs Aider.
