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.

// ~/.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

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.