---
title: "Aider con un’API compatibile OpenAI (DeepSeek illimitato)"
description: "Collega l’agente di coding Aider a BroadNet Inference con l’impostazione compatibile con OpenAI e usalo con un piano flat illimitato per DeepSeek V4.1 Flash."
url: https://broadrouter.com/it/guides/aider-unlimited-deepseek/
lang: it
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Tradotto dall’inglese con l’aiuto dell’IA. [Leggi l’originale in inglese](https://broadrouter.com/guides/aider-unlimited-deepseek/) (aggiornato il 2026-11-16).

# Usare Aider con DeepSeek V4.1 Flash illimitato

Aggiornato 2026-11-16

Aider si collega a qualsiasi API compatibile con OpenAI. Imposta OPENAI\_API\_BASE su https://inference.broadnet.ai/v1 e OPENAI\_API\_KEY con la tua chiave BroadNet, poi lancia aider --model openai/broadnet/deepseek-v4.1-flash. Il prefisso openai/ seleziona il percorso compatibile con OpenAI di Aider. Con la chiave di un piano illimitato i token di DeepSeek V4.1 Flash non vengono contati, quindi anche le sessioni lunghe su un repository restano a prezzo fisso.

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](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/) elimina il contatore. I passaggi seguono [la configurazione compatibile con OpenAI di Aider](https://aider.chat/docs/llms/openai-compat.html).

## 1\. Installa Aider

```bash
python -m pip install aider-install
aider-install
```

## 2\. Puntalo su BroadNet Inference

```bash
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

```bash
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](https://aider.chat/docs/llms/warnings.html) 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](https://aider.chat/docs/config/adv-model-settings.html).

`.aider.model.metadata.json`:

```json
{
  "openai/broadnet/deepseek-v4.1-flash": {
    "max_input_tokens": 1048576,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}
```

`.aider.model.settings.yml`:

```yaml
- 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](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **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_KEY` manca, è sbagliata o scaduta. Controlla che la shell in cui gira Aider abbia la variabile; su Windows apri un nuovo terminale dopo `setx`.
-   **Le richieste vanno a OpenAI invece che a BroadNet.** `OPENAI_API_BASE` non è impostata in questa shell, oppure il nome del modello non ha il prefisso `openai/`. Controlla con `echo $OPENAI_API_BASE`.
-   **Modello non trovato.** La parte dopo `openai/` deve essere esattamente `broadnet/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_tokens` in `.aider.model.settings.yml` come mostrato sopra.
-   **Le modifiche non si applicano.** Riporta `edit_format` a `whole`, oppure prova `--edit-format whole` da 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](https://broadrouter.com/it/guides/errors-and-retries/).

Preferisci un agente dentro VS Code? Vedi [la guida alla configurazione di Cline](https://broadrouter.com/it/guides/cline-openai-compatible/), oppure confrontali in [Cline vs Roo Code vs Aider](https://broadrouter.com/it/blog/cline-vs-roo-code-vs-aider/).

[Scegli un piano su BroadNet Inference](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-aider-unlimited-deepseek&utm_content=body)

## Termini in questa guida

[Pagamento a consumo (pay-as-you-go)](https://broadrouter.com/it/glossary/pay-as-you-go/)

Il pagamento a consumo è un modello di prezzo in cui paghi solo ciò che usi, misurato per unità come token, richieste o minuti di audio, senza abbonamento né impegno minimo. La maggior parte delle API LLM fattura così, da un saldo prepagato o con una fattura periodica.

[Token](https://broadrouter.com/it/glossary/token/)

Un token è l’unità di testo che un modello linguistico legge e scrive: una parola, una parte di parola, un segno di punteggiatura o una sequenza di byte prodotta dal tokenizer del modello. Le API LLM contano, limitano e di solito fatturano l’uso in token.

[Finestra di contesto (context window)](https://broadrouter.com/it/glossary/context-window/)

La finestra di contesto è il numero massimo di token con cui un modello linguistico può lavorare in una singola richiesta. Comprende prompt, cronologia della conversazione, definizioni degli strumenti, immagini e output generato, token di ragionamento inclusi. Ciò che non ci sta va tagliato, riassunto o diviso su più richieste.

[Base URL (URL di base)](https://broadrouter.com/it/glossary/base-url/)

La base URL è l’indirizzo radice fisso di un’API, come https://api.example.com/v1, che un client antepone a ogni percorso di endpoint, come /chat/completions. Negli SDK compatibili con OpenAI, cambiare la base URL, insieme alla chiave API e all’ID del modello, punta lo stesso codice verso un altro provider.

[Concorrenza (concurrency)](https://broadrouter.com/it/glossary/concurrency/)

La concorrenza è il numero di richieste che un client ha in corso nello stesso momento. Le API LLM spesso la limitano per chiave o per piano, separatamente dalle richieste al minuto, perché ogni richiesta aperta occupa capacità GPU finché la sua risposta non è terminata.

[Rate limit (limite di frequenza)](https://broadrouter.com/it/glossary/rate-limit/)

Un rate limit è un tetto che un’API pone a quanto un client può usarla in un intervallo di tempo, per esempio richieste al minuto o token al minuto. Le richieste oltre il limite vengono rifiutate, di solito con HTTP 429 Too Many Requests, finché l’uso non torna sotto la soglia.

[Chat Completions API](https://broadrouter.com/it/glossary/chat-completions-api/)

La Chat Completions API è l’endpoint HTTP di OpenAI, POST /v1/chat/completions, che riceve il nome di un modello e una lista di messaggi con un ruolo e restituisce il messaggio successivo del modello. La forma della sua richiesta e risposta è diventata il formato comune che riusano provider e SDK compatibili con OpenAI.

## Domande frequenti

### Come si usa Aider con un’API compatibile con OpenAI?

Imposta OPENAI\_API\_BASE sul base URL del provider e OPENAI\_API\_KEY con la sua chiave, poi avvia aider con --model openai/ seguito dall’ID del modello del provider. Per BroadNet è openai/broadnet/deepseek-v4.1-flash, con base URL https://inference.broadnet.ai/v1.

### Perché Aider dice "Unknown context window size and costs"?

Aider non ha metadati integrati per gli ID dei modelli BroadNet, quindi presume un contesto illimitato e costo zero. Secondo la documentazione di Aider, di solito l’avviso si può ignorare. Per toglierlo, aggiungi il modello a .aider.model.metadata.json.

### Serve il prefisso openai/ se l’ID del modello inizia già con broadnet/?

Sì. Aider legge la prima parte come percorso del provider: openai/ manda la richiesta a OPENAI\_API\_BASE, e broadnet/deepseek-v4.1-flash è l’ID del modello che riceve BroadNet.

### Perché Aider riceve risposte vuote o troncate da DeepSeek V4.1 Flash?

Il modello ragiona prima di rispondere, e BroadNet conta il ragionamento in max\_tokens. Imposta un max\_tokens più alto tramite extra\_params in .aider.model.settings.yml.

## Guide correlate

-   [Come funzionano i piani API LLM illimitati per gli agenti](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/)
-   [Perché un modello di ragionamento restituisce una risposta vuota](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/)
-   [Usare Cline con BroadNet Inference (provider OpenAI Compatible)](https://broadrouter.com/it/guides/cline-openai-compatible/)
-   [Codici di errore di BroadNet Inference e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/)
-   [Tutti gli strumenti che funzionano con BroadNet Inference (in inglese)](https://broadrouter.com/integrations/): SDK, agenti di coding, interfacce di chat e strumenti di automazione, con le impostazioni esatte per ciascuno

Provalo sul tuo carico di lavoro reale. I nuovi account partono con USD 5 di credito per Gemma e trascrizione. DeepSeek, GLM e Qwen3.8 richiedono una ricarica.

[Inizia](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-aider-unlimited-deepseek&utm_content=page-cta) ·

**Fonti**

-   [Documentazione di Aider, API compatibili con OpenAI (verificata il 2026-11-14)](https://aider.chat/docs/llms/openai-compat.html)
-   [Documentazione di Aider, avvisi sui modelli (verificata il 2026-11-14)](https://aider.chat/docs/llms/warnings.html)
-   [Documentazione di Aider, impostazioni avanzate dei modelli (verificata il 2026-11-14)](https://aider.chat/docs/config/adv-model-settings.html)
-   [Riferimento API di BroadNet Inference (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-aider-unlimited-deepseek&utm_content=sources)
-   [Piani illimitati di BroadNet Inference (in inglese)](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-aider-unlimited-deepseek&utm_content=sources)
