Saltar al contenido principal
Factory Droid CLI (comando droid) es el agente de ingeniería de software de IA de terminal de Factory AI.
Protocolo: compatible con OpenAI
  • URL base: https://api.orcarouter.ai/v1 (incluye el sufijo /v1)

​
Instalación

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

​
Configuración

Archivo de configuración: ~/.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
    }
  ]
}
Cambia orcarouter/auto por un modelo específico si lo prefieres, p. ej. anthropic/claude-opus-4.8 o google/gemini-2.5-flash. Los IDs de modelo siempre usan el formato vendor/model.

​
Ejecución

droid exec -m "orcarouter/auto" --auto low "Reply with exactly: OK"
Salida esperada: OK.

​
Notas

  • Los modelos personalizados van en el array custom_models.
  • Usa provider: "generic-chat-completion-api" para el protocolo compatible con OpenAI.
  • La base_url debe incluir /v1.
  • --auto <low|medium|high> controla la autonomía (cuánto puede hacer el agente sin supervisión) — no es el control de razonamiento. Consulta más abajo para el pensamiento.
Extensión de VS Code: la extensión oficial de VS Code de Factory comparte el mismo ~/.factory/config.json que la CLI — la entrada custom_models anterior se aplica a ambos, sin un ajuste de endpoint independiente dentro del editor. Dos advertencias: Factory solo prueba y compara de forma completa con las APIs oficiales de Anthropic/OpenAI, y un problema conocido puede enrutar los subagentes de vuelta a Anthropic en lugar de a tu modelo personalizado.

​
Activar pensamiento / razonamiento

Controla el esfuerzo de razonamiento con el flag -r / --reasoning-effort (separado de --auto): 
droid exec -m "anthropic/claude-sonnet-4.6" -r high --auto low "What is 17*23?"
Niveles: low / medium / high (el valor por defecto es por modelo — los modelos Anthropic vienen desactivados por defecto, GPT-5 viene en medium por defecto). También puedes configurarlo de forma persistente en settings.json vía reasoningEffort. Verificado: -r high pasa hasta OrcaRouter. (Nota: las entradas de custom_models no tienen campo de razonamiento — contrólalo vía -r o settings.json.)