Factory

Factory Droid è una CLI di agente di programmazione. Aggiungi OneProvider come modello personalizzato compatibile con Anthropic in ~/.factory/settings.json.

Configurazione

Factory Droid legge i modelli bring-your-own-key da ~/.factory/settings.json: per i provider non esiste un'interfaccia web. Aggiungi un modello all'array customModels; lascia baseUrl senza /v1, perché il provider anthropic aggiunge /v1/messages da solo.

{
"customModels": [
{
"model": "claude-sonnet-5-5",
"displayName": "OneProvider claude-sonnet-5-5",
"baseUrl": "https://api.oneprovider.dev",
"apiKey": "sk-your-key-here",
"provider": "anthropic",
"maxOutputTokens": 8192
}
]
}

Aggiungi altre voci con un model diverso per gli altri modelli Claude. Poi esegui /model in droid e scegli il modello sotto Custom models.

Assegna i modelli ai droid

Ogni droid di Factory ha un modello predefinito. Usa claude-sonnet-5-5 come scelta pratica oppure claude-opus-5-5 per il lavoro di architettura.

Quale modello scegliere

Aggiungi una voce customModels per ogni modello. claude-sonnet-5-5 è la scelta pratica per i droid; usa claude-opus-5-5 per il lavoro di architettura e claude-haiku-5-5 per droid veloci ed economici. Lascia provider come "anthropic". Gli ID sono nella pagina dei modelli , le tariffe nella pagina dei prezzi .

Errori comuni e soluzioni

404

baseUrl deve essere https://api.oneprovider.dev senza /v1: il provider anthropic aggiunge /v1/messages da solo.

401

La chiave nella voce è troncata o ha una virgoletta di troppo. Incolla la chiave intera.

Il modello manca in /model

Salva ~/.factory/settings.json (JSON valido, senza virgolette «intelligenti») e riapri droid; le voci personalizzate compaiono sotto Custom models.

429 «Insufficient balance»

Il saldo o il limite della chiave è esaurito. Ricarica l'area personale.

FAQ

Esiste un'interfaccia web per i provider?

No. I modelli bring-your-own-key si configurano solo in ~/.factory/settings.json.

Posso aggiungere più modelli?

Sì, aggiungi un oggetto per modello all'array; la stessa chiave vale per tutti.

Dove vedo il costo?

Nella pagina «Consumo» della Dashboard della chiave.

Risposte rapide

Quale base URL devo usare?

Claude Code e gli SDK Anthropic usano https://api.oneprovider.dev. Gli SDK OpenAI e i client compatibili con OpenAI usano https://api.oneprovider.dev/v1. Con una sola chiave funzionano entrambi; l'elenco dei modelli è nella pagina dei modelli , le tariffe nella pagina dei prezzi .

Come mi autentico?

Invia la chiave sk-… così com'è in x-api-key oppure in Authorization: Bearer: uno dei due, mai entrambi. Tieni la chiave in una variabile d'ambiente, non in un file che finisce nel commit. Altro sull'autenticazione .

Dove ottengo una chiave?

Apri la tua area personale nel bot Telegram @oneprovider_robot oppure su app.oneprovider.dev, ricarica il saldo e premi «Emetti una chiave». Ogni chiave può avere un proprio limite di spesa. Area personale e chiavi API .

Cosa significano 401, 404 e 429?

401: la chiave manca, è scritta male o è inviata nell'header sbagliato; incolla la chiave intera, senza virgolette né spazi. 404: di solito la base URL è sbagliata, per esempio manca /v1 o è doppio. 429 con “Insufficient balance”: il saldo dell'area personale o il limite di spesa della chiave è esaurito, quindi ricarica invece di riprovare; qualsiasi altro 429 è un limite di frequenza, quindi attendi il tempo indicato in Retry-After. Dettagli: codici di errore e risoluzione dei problemi .

Perché gli stream si interrompono o si resettano?

VPN e proxy VLESS spesso mettono in buffer gli SSE o rompono la negoziazione HTTP/2. OneProvider non ha restrizioni regionali e non mette in buffer gli stream: disattiva il proxy e riprova.

Dove chiedo se non basta?

Scrivi a @Oneproviderhelpbot su Telegram oppure apri «Assistenza» nell'area personale sul sito, indicando il codice di stato HTTP e il testo esatto dell'errore. Come funziona l'assistenza .