Ejecuta Factory Droid con Claude

Droid de Factory es una CLI agéntica de la misma familia que Claude Code y permite usar tus propios modelos mediante un archivo de configuración. Al conectarlo a la pasarela de AI Prime Tech, los ciclos del agente de Droid se ejecutan con Claude junto con cualquier otro modelo que ofrezca la pasarela.

Edita el archivo de ajustes

Droid lee ~/.factory/settings.json. Añade un array customModels en el que cada entrada describa un modelo que quieras tener disponible. Esta es la ruta de configuración actual; el antiguo config.json es un archivo heredado y no admite todo lo que admite settings.json.

Un solo archivo abarca toda tu configuración de Droid, por lo que una única lista customModels define todos los modelos entre los que puede alternar la CLI. Mantenla a nivel de usuario en lugar de por proyecto.

Saber que settings.json es el archivo actual evita mucha confusión, porque las notas y los hilos antiguos siguen haciendo referencia a config.json y algunas funciones se comportan de forma distinta entre ambos. Cuando algo funciona en uno y no en el otro, settings.json casi siempre es el archivo en el que conviene confiar. Cuando los consejos se contradicen, dar prioridad a settings.json frente a config.json resuelve la mayoría de las discrepancias. El archivo más reciente es el que Factory mantiene activamente y es donde realmente funciona la sintaxis de variables.

Describe el modelo

Cada entrada de customModels incluye un ID de modelo, baseUrl, apiKey, provider y maxOutputTokens. Establece model en el ID de la pasarela, como claude-sonnet-4-5, y baseUrl en el host de la pasarela.

Estos campos, en conjunto, indican a Droid exactamente cómo acceder al modelo. Como Droid no presupone un único proveedor, debes especificar cada elemento, lo que le da la flexibilidad necesaria para conectarse a una pasarela.

Esta definición explícita permite que una instalación de Droid dé acceso a varios modelos de Claude en la misma pasarela, cada uno con su propia entrada en customModels y compartiendo baseUrl y la clave. La CLI los trata como modelos distintos que se pueden seleccionar, aunque todos se dirijan al mismo endpoint del servicio de destino. Precisamente, los campos explícitos permiten que una instalación dé acceso a varios modelos de Claude a través de un único endpoint. Cada entrada comparte baseUrl y la clave, pero conserva su propio ID de modelo, de modo que la pasarela se encarga del enrutamiento y Droid solo selecciona un nombre.

Elige el modo del proveedor

El campo provider establece el formato de comunicación. Usa anthropic para la interfaz nativa de Messages de la pasarela, openai para el estilo Responses o generic-chat-completion-api para un endpoint de chat /v1 de estilo OpenAI. Para Claude en la pasarela, anthropic es la opción natural.

Hacer que provider coincida con la interfaz real de la pasarela evita errores en la primera ejecución. Con provider establecido en anthropic, Droid utiliza el formato nativo que la pasarela ofrece para Claude.

Los tres modos de proveedor también se corresponden claramente con las interfaces que puede ofrecer una pasarela multimodelo, por lo que, si la misma pasarela ofrece un modelo de estilo OpenAI, lo añadirías como una entrada independiente con generic-chat-completion-api. Mantener el valor de provider de cada entrada alineado con su interfaz es la regla que evita errores en una configuración mixta. Alinear provider con la interfaz en cada entrada es la regla que mantiene en orden una configuración de pasarela mixta. Una entrada nativa de Claude y otra de estilo OpenAI pueden coexistir sin problemas.

Gestiona la clave de API

Introduce la clave en apiKey, preferiblemente como una referencia ${VAR}, por ejemplo ${AIPRIME_API_KEY}, para que el secreto permanezca en tu entorno en lugar de en el archivo. Ten en cuenta que la expansión de ${VAR} funciona en settings.json, pero no en el antiguo config.json.

El campo apiKey tampoco debe estar vacío, incluso si la pasarela técnicamente aceptaría una solicitud anónima. Droid comprueba que el campo tenga un valor, así que proporciona siempre la clave o la variable que la contiene.

Estos dos hechos explican un tropiezo habitual: se introduce ${VAR} en el antiguo config.json, donde no se expande, y Droid recibe una cadena literal sin resolver. Usa settings.json para la sintaxis de variables y asegúrate de que la variable esté realmente exportada en el shell que inicia Droid. Confirmar que la variable esté exportada en el shell de inicio es el último detalle que suele pasarse por alto. Droid solo ve las variables presentes en el entorno desde el que se inició.

Cambia de modelo y ejecuta

Dentro de la CLI de Droid, alterna entre los modelos configurados con el comando /model. Añade una segunda entrada para claude-opus-4-8 y podrás cambiar a ese modelo para tareas más difíciles sin volver a tocar la configuración.

A partir de ahí, Droid ejecuta su ciclo de agente con Claude en la pasarela. Como los ajustes se guardan en settings.json, se aplica la misma configuración cada vez que inicias la CLI.

Tener preparadas una entrada de Sonnet y otra de Opus permite adaptar el modelo a la tarea sobre la marcha: Sonnet para una implementación constante y Opus cuando un problema exige un razonamiento más complejo, todo a través de la pasarela y sin reconfigurar nada. El comando /model permite hacer ese cambio con una sola línea en mitad de la sesión. Cambiar con una sola línea mediante /model en mitad de la sesión hace que adaptar el modelo a la tarea resulte sencillo. Pasas de Sonnet a Opus sin salir de la sesión.

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

Preguntas frecuentes

AI Prime Tech es una pasarela de API independiente. No está afiliada a Anthropic, no cuenta con su respaldo ni es un distribuidor de Anthropic. Claude y los nombres de los modelos relacionados son marcas comerciales de sus respectivos propietarios.