Vai al contenuto principale
Factory Droid CLI (comando droid) è l’agente IA di ingegneria del software da terminale di Factory AI.
Protocollo: compatibile con OpenAI
  • Base URL: https://api.orcarouter.ai/v1 (include il suffisso /v1)

​
Installazione

macOS/Linux: 
curl -fsSL https://app.factory.ai/cli | sh
Windows (PowerShell): 
irm https://app.factory.ai/cli/windows | iex
Il comando installato è droid.

​
Configurazione

File di configurazione: ~/.factory/config.json. 
{
  "custom_models": [
    {
      "model_display_name": "OrcaRouter Auto",
      "model": "orcarouter/auto",
      "base_url": "https://api.orcarouter.ai/v1",
      "api_key": "sk-orca-...",
      "provider": "generic-chat-completion-api",
      "max_tokens": 8192
    }
  ]
}
Sostituisci orcarouter/auto con un modello specifico se preferisci, ad es. anthropic/claude-opus-4.8 o google/gemini-2.5-flash. Gli ID dei modelli usano sempre il formato vendor/model.

​
Esecuzione

droid exec -m "orcarouter/auto" --auto low "Reply with exactly: OK"
Output atteso: OK.

​
Note

  • I modelli personalizzati vanno nell’array custom_models.
  • Usa provider: "generic-chat-completion-api" per il protocollo compatibile con OpenAI.
  • Il base_url deve includere /v1.
  • --auto <low|medium|high> controlla l’autonomia (quanto l’agente può fare senza supervisione) — non è il controllo del reasoning. Vedi sotto per il thinking.
Estensione VS Code: l’estensione VS Code ufficiale di Factory condivide lo stesso ~/.factory/config.json della CLI — la voce custom_models riportata sopra vale per entrambi, senza alcuna impostazione di endpoint separata nell’editor. Due avvertenze: Factory testa e misura le prestazioni in modo completo solo rispetto alle API ufficiali Anthropic/OpenAI, e un problema noto può instradare i subagent di nuovo verso Anthropic invece che verso il tuo modello personalizzato.

​
Abilitare thinking / reasoning

Controlla l’effort di reasoning con il flag -r / --reasoning-effort (separato da --auto): 
droid exec -m "anthropic/claude-sonnet-4.6" -r high --auto low "What is 17*23?"
Livelli: low / medium / high (il default è per modello — i modelli Anthropic di default sono disattivati, GPT-5 di default medium). Puoi anche impostarlo in modo persistente in settings.json tramite reasoningEffort. Verificato: -r high passa attraverso OrcaRouter. (Nota: le voci custom_models non hanno un campo per il reasoning — controllalo tramite -r o settings.json.)