Source: https://aiprimetech.io/it/learn/use-claude-api-with-aider/ [Home](/it/) / [Impara](/it/learn/) / Aider con Claude tramite un gateway: ANTHROPIC_API_BASE, file di configurazione, modalità architect e soluzioni # 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 macOS / LinuxCopia ``` 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 ``` WindowsCopia ``` 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 terminaleCopia ``` export ANTHROPIC_API_KEY=your_gateway_key export ANTHROPIC_API_BASE=https://aiprimetech.io aider --model anthropic/claude-sonnet-5 ``` WindowsCopia ``` 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 ``` Usa la radice dell'host: senza /v1 e senza barra finale. LiteLLM aggiunge /v1/messages automaticamente, quindi https://aiprimetech.io/v1 diventa /v1/v1/messages e restituisce 404, mentre una barra finale produce una doppia barra nel percorso. 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. ~/.aider.conf.ymlCopia ``` 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 ``` ~/.envCopia ``` 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: ~/.aider.model.settings.ymlCopia ``` - 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: ~/.aider.model.metadata.jsonCopia ``` { "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 terminaleCopia ``` 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: terminaleCopia ``` 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 | ID del modello | Usalo per | claude-sonnet-5 | Scelta predefinita per programmazione e attività degli agenti: veloce, potente, di fascia media. | claude-opus-5-5 | Ragionamenti più complessi, refactoring estesi, esecuzioni prolungate degli agenti. | claude-fable-5-1 | Il più capace e il più costoso; riservalo alle attività più difficili. | claude-haiku-4-5 | Economico e rapido: titoli, riepiloghi, classificazione, piccoli passaggi. 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 | Che cosa vedi | Causa | Soluzione | 404 / NotFoundError | /v1 in ANTHROPIC_API_BASE, quindi il percorso diventa /v1/v1/messages | Imposta l'URL radice dell'host, https://aiprimetech.io, senza barra finale | LLM Provider NOT provided | Nome del modello senza prefisso del provider | Usa anthropic/claude-sonnet-5 | AuthenticationError: impossibile autenticarti | Chiave mancante nella shell in cui viene eseguito Aider, oppure chiave destinata a un altro endpoint | echo $ANTHROPIC_API_KEY; su Windows, apri un nuovo terminale dopo setx | Riscrittura di file interi, senza mappa del repository | Aider non riconosce il nome del modello | Aggiungi la .aider.model.settings.yml voce riportata sopra | Unknown context window size and costs | Nessun metadato per il modello | Aggiungi il file dei metadati oppure ignora l'avviso | Errori relativi al limite di token | Troppi file nella chat oppure file troppo grandi | /tokens per visualizzare l'utilizzo, /drop file, /clear cronologia | RateLimitError | Limite di concorrenza o di frequenza raggiunto | Aider riprova con intervalli di attesa crescenti; evita di eseguire più sessioni con la stessa chiave | Modello non supportato | Un ID di modello obsoleto o scritto in modo errato | Usa un ID della tabella qui sopra Per gli errori che provengono dal modello anziché da Aider, consulta la [guida agli errori dell'API di Claude](/it/learn/claude-api-errors-troubleshooting/). ## Domande frequenti Come uso Aider con un URL di base Anthropic personalizzato? Imposta ANTHROPIC_API_BASE sull'URL radice dell'host del gateway, ad esempio https://aiprimetech.io, senza /v1 e senza barra finale, imposta ANTHROPIC_API_KEY ed esegui aider --model anthropic/claude-sonnet-5. LiteLLM aggiunge /v1/messages. Aider legge ANTHROPIC_BASE_URL? Sì, tramite LiteLLM, come alternativa. LiteLLM controlla prima ANTHROPIC_API_BASE, poi ANTHROPIC_BASE_URL. Perché Aider riscrive file interi con un nuovo modello Claude? Aider non riconosce il nome del modello e ripiega sul formato di modifica whole, senza una mappa del repository. Aggiungi una voce con edit_format: diff e use_repo_map: true a .aider.model.settings.yml. Aider può usare un endpoint compatibile con OpenAI? Sì: imposta OPENAI_API_BASE sull'endpoint includendo /v1 e imposta OPENAI_API_KEY, poi usa il prefisso openai/, ad esempio aider --model openai/claude-sonnet-5. Inizia a usare Claude in pochi minuti Ottieni una chiave API: non servono un account Anthropic né una lista d'attesa.[Ottieni la tua chiave API](/register) 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. ## Altre guide all'API di Claude [Come ottenere una chiave API di Claude](/it/learn/how-to-get-a-claude-api-key/)[I prezzi dell'API Claude, spiegati](/it/learn/claude-api-pricing-explained/)[Il modo più economico per usare l'API Claude](/it/learn/cheapest-way-to-use-claude-api/)[Cursor illimitato con l'API Claude](/learn/use-claude-api-with-cursor/)[Accesso illimitato a Claude Code](/it/learn/use-claude-api-with-claude-code/)[Gateway API Claude e accesso diretto ad Anthropic a confronto](/it/learn/claude-api-vs-anthropic-direct/)[Usa Claude con l'SDK OpenAI: endpoint compatibile con OpenAI, streaming, strumenti e limiti](/it/learn/openai-compatible-claude-api/)[I modelli Claude spiegati: un confronto tra Claude Opus, Sonnet, Haiku e Fable — tutti i modelli API Claude, i nomi dei modelli Anthropic e i prezzi (2026)](/it/learn/claude-api-models-compared/)[Pagare l'API Claude con criptovalute](/it/learn/claude-api-with-crypto-payment/)[Accesso all'API Claude senza lista d'attesa](/it/learn/claude-api-without-waitlist/)[Come ridurre l'utilizzo dei token di Claude](/it/learn/how-to-reduce-claude-token-usage/)[Cline illimitato con l'API Claude](/it/learn/use-claude-api-with-cline/)[Roo Code illimitato con l'API Claude](/it/learn/use-claude-api-with-roo-code/)[Claude illimitato negli IDE JetBrains](/it/learn/use-claude-api-with-jetbrains/)[Claude illimitato in VS Code](/it/learn/use-claude-api-with-vscode/)[Configurazione di OpenCode per Claude: impostazione di opencode.json, modelli ed errori comuni](/it/learn/use-claude-api-with-opencode/)[Hermes Agent con Claude tramite un gateway: configurazione di un provider personalizzato, controllo dei costi e soluzioni ai problemi](/it/learn/run-hermes-agent-with-claude-api/)[Eseguire OpenClaw senza limiti con Claude](/it/learn/run-openclaw-with-claude-api/)[Cosa significa un'API compatibile con Anthropic](/it/learn/anthropic-compatible-api/)[Chiave API di Claude Code — ANTHROPIC_API_KEY: come ottenerla, configurarla e quando usare invece claude setup-token](/it/learn/claude-code-api-key-setup/)[Costi dell'API di Claude Code — Prezzi e come ridurli](/it/learn/claude-code-api-costs/)[Gli errori dell'API Claude spiegati: errore del server 500, sovraccarico 529, limite di frequenza 429, richiesta non valida 400 — e la soluzione per ciascuno](/it/learn/claude-api-errors-troubleshooting/)[Come acquistare crediti per l'API di Claude e perché un credito Claude conviene più di qualsiasi offerta per «acquistare un account Claude»](/it/learn/buy-claude-api-credits/)[API Claude gratuita: esiste una chiave API di Claude gratuita e che cosa è davvero gratuito nel 2026?](/it/learn/claude-api-free-trial/)[API Claude e abbonamento Claude Pro/Max a confronto — Quale scegliere](/it/learn/claude-api-vs-subscription/)[Codex CLI con un provider personalizzato: config.toml, modelli GPT e Claude, estensione IDE e soluzioni ai problemi](/it/learn/use-claude-api-with-codex/)[Collegare Claude a n8n](/it/learn/use-claude-api-with-n8n/)[Instradare LiteLLM verso Claude](/it/learn/use-claude-api-with-litellm/)[Usare Claude in Kilo Code](/it/learn/use-claude-api-with-kilo-code/)[GitHub Copilot Chat con Claude tramite un gateway: configurazione di Custom Endpoint, modalità agente e soluzioni ai problemi](/it/learn/use-claude-api-with-github-copilot/)[Collega Zed a Claude tramite il gateway](/it/learn/use-claude-api-with-zed/)[Collega Cherry Studio a Claude](/it/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic in LangChain: importazione, base_url, streaming, strumenti ed errori](/it/learn/use-claude-api-with-langchain/)[SDK Python di Anthropic: installazione, configurazione di base_url, streaming e gestione degli errori](/it/learn/anthropic-python-sdk/)[Claude con Vercel AI SDK: baseURL di createAnthropic, streaming e soluzioni ai problemi](/it/learn/use-claude-api-with-vercel-ai-sdk/)[Esegui Factory Droid con Claude](/it/learn/use-claude-api-with-factory-droid/)[L'API di Claude Code spiegata](/it/learn/claude-code-api/)[Integrare l'API di Claude nella tua applicazione](/it/learn/claude-api-integration/)[Come ottenere un utilizzo illimitato di Claude e perché non esiste un «Claude Code craccato»](/it/learn/get-unlimited-claude-usage/)