Source: https://aiprimetech.io/it/learn/use-claude-api-with-factory-droid/

[Home](/it/) / [Impara](/it/learn/) / Esegui Factory Droid con Claude 

# Esegui Factory Droid con Claude 

Droid di Factory è una CLI agentica della stessa famiglia di Claude Code e consente di usare modelli propri tramite un file di configurazione. Configurandolo per usare il gateway AI Prime Tech, i cicli dell'agente Droid vengono eseguiti su Claude, insieme a qualsiasi altro modello offerto dal gateway. 

## Modifica il file delle impostazioni 

Droid legge ~/.factory/settings.json. Aggiungi un array customModels, in cui ogni voce descrive un modello che vuoi rendere disponibile. Questo è il percorso di configurazione attuale; il precedente config.json è obsoleto e non supporta tutte le funzionalità di settings.json. 

Un unico file copre l'intera configurazione di Droid, quindi una sola lista customModels definisce tutti i modelli tra cui la CLI può passare. Mantienila a livello di utente anziché di singolo progetto. 

Sapere che settings.json è il file attuale evita molta confusione, perché note e discussioni meno recenti fanno ancora riferimento a config.json e alcune funzionalità si comportano diversamente nei due file. Quando qualcosa funziona in uno ma non nell'altro, settings.json è quasi sempre quello a cui fare riferimento. Quando i consigli sono in conflitto, preferire settings.json a config.json risolve la maggior parte dei dubbi. Il file più recente è quello supportato attivamente da Factory ed è quello in cui la sintassi delle variabili funziona effettivamente. 

## Descrivi il modello 

Ogni voce customModels richiede un ID del modello, un baseUrl, un apiKey, un provider e maxOutputTokens. Imposta model sull'ID del gateway, ad esempio claude-sonnet-4-5, e baseUrl sull'host del gateway. 

Insieme, questi campi indicano a Droid esattamente come raggiungere il modello. Poiché Droid non presuppone l'uso di un unico provider, devi specificare ogni elemento: è questo che gli dà la flessibilità necessaria per collegarsi a un gateway. 

Questa configurazione esplicita consente a una singola installazione di Droid di accedere a più modelli Claude sullo stesso gateway, ciascuno con una propria voce customModels che condivide baseUrl e chiave. La CLI li tratta come modelli distinti e selezionabili, anche se tutti fanno riferimento allo stesso endpoint a monte. È proprio la presenza di campi espliciti a consentire a una singola installazione di accedere a più modelli Claude tramite un unico endpoint. Ogni voce condivide baseUrl e chiave, mantenendo però il proprio ID del modello, così il gateway gestisce l'instradamento e Droid si limita a scegliere un nome. 

## Scegli la modalità del provider 

Il campo provider imposta il formato di comunicazione. Usa anthropic per l'interfaccia Messages nativa del gateway, openai per lo stile Responses oppure generic-chat-completion-api per un endpoint chat /v1 in stile OpenAI. Per Claude sul gateway, anthropic è la scelta naturale. 

Far corrispondere provider all'interfaccia effettiva del gateway evita errori al primo avvio. Con provider impostato su anthropic, Droid usa il formato nativo che il gateway offre per Claude. 

Le tre modalità del provider corrispondono inoltre alle interfacce che un gateway multimodello può esporre, quindi, se lo stesso gateway offre un modello in stile OpenAI, lo aggiungerai come voce separata con generic-chat-completion-api. Mantenere il provider di ogni voce allineato alla sua interfaccia è la regola che evita errori in una configurazione mista. Allineare provider e interfaccia in ogni voce è la regola che mantiene coerente una configurazione con gateway misto. Una voce Claude nativa e una in stile OpenAI possono coesistere senza problemi. 

## Gestisci la chiave API 

Inserisci la chiave in apiKey, preferibilmente come riferimento ${VAR}, ad esempio ${AIPRIME_API_KEY}, così il segreto rimane nell'ambiente anziché nel file. Tieni presente che l'espansione di ${VAR} funziona in settings.json, ma non nel precedente config.json. 

Inoltre, il campo apiKey non deve essere vuoto, anche se il gateway accetterebbe tecnicamente una richiesta anonima. Droid verifica che il campo contenga un valore, quindi fornisci sempre la chiave o la variabile che la contiene. 

Questi due aspetti spiegano un errore comune: si inserisce ${VAR} nel vecchio config.json, dove non viene espanso, e Droid vede una stringa letterale non risolta. Usa settings.json per la forma con variabile e assicurati che la variabile sia effettivamente esportata nella shell che avvia Droid. Verificare che la variabile sia esportata nella shell di avvio è l'ultimo passaggio che spesso viene dimenticato. Droid vede soltanto le variabili presenti nell'ambiente da cui è stato avviato. 

## Cambia modello e avvia 

Nella CLI di Droid, passa da un modello configurato all'altro con il comando /model. Aggiungi una seconda voce per claude-opus-4-8 e potrai selezionarla per le attività più difficili senza modificare di nuovo la configurazione. 

Da quel momento, Droid esegue il ciclo dell'agente usando Claude sul gateway. Poiché la configurazione si trova in settings.json, viene applicata ogni volta che avvii la CLI. 

Avere pronte sia una voce Sonnet sia una voce Opus permette di scegliere al volo il modello adatto all'attività: Sonnet per l'implementazione ordinaria, Opus quando un problema richiede un ragionamento più complesso, il tutto tramite il gateway senza riconfigurazioni. Il comando /model consente di effettuare questo cambio con una sola riga durante la sessione. È proprio la possibilità di cambiare modello con una riga tramite /model durante la sessione a rendere semplice adattare il modello all'attività. Passi da Sonnet a Opus senza uscire dalla sessione. 

Copia

```
// ~/.factory/settings.json
{
  "customModels": [
    {
      "model": "claude-sonnet-4-5",
      "baseUrl": "https://aiprimetech.io",
      "apiKey": "${AIPRIME_API_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 8192
    }
  ]
}
// export AIPRIME_API_KEY=<key>   (apiKey must NOT be empty)
// Switch models in the CLI with /model
```

## Domande frequenti 

 Come posso eseguire Factory Droid con Claude?

Aggiungi una voce customModels in ~/.factory/settings.json con provider impostato su anthropic, baseUrl https://aiprimetech.io,, l'ID del modello e apiKey. Cambia modello con /model. Quale valore di provider usare per Claude?

anthropic per l'interfaccia Messages nativa. openai o generic-chat-completion-api si rivolgono invece a endpoint in stile OpenAI. apiKey può essere vuoto?

No: Droid richiede un valore. Usa un riferimento ${VAR} come ${AIPRIME_API_KEY}; l'espansione funziona in settings.json, non nel precedente config.json. Come posso cambiare modello?

Usa il comando /model nella CLI di Droid per passare da una voce all'altra della lista customModels.  

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/)[Usare Claude tramite un'API compatibile con OpenAI](/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/)[Aider senza limiti con l'API di Claude](/it/learn/use-claude-api-with-aider/)[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/)[Eseguire un agente Hermes senza limiti su Claude](/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/)[Eseguire la CLI di Codex su Claude](/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/)[Integrare Claude in GitHub Copilot](/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/)[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/)