Source: https://aiprimetech.io/es/learn/use-claude-api-with-factory-droid/

[Inicio](/es/) / [Aprende](/es/learn/) / Ejecuta Factory Droid con Claude 

# 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. 

Copiar

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

 ¿Cómo ejecuto Factory Droid con Claude?

Añade una entrada customModels en ~/.factory/settings.json con provider establecido en anthropic, baseUrl https://aiprimetech.io,, tu ID de modelo y apiKey. Cambia de modelo con /model. ¿Qué valor de provider debo usar para Claude?

anthropic para la interfaz nativa de Messages. openai o generic-chat-completion-api se dirigen, en cambio, a endpoints de estilo OpenAI. ¿Puede apiKey estar vacío?

No: Droid exige un valor. Usa una referencia ${VAR} como ${AIPRIME_API_KEY}; la expansión funciona en settings.json, pero no en el antiguo config.json. ¿Cómo cambio de modelo?

Usa el comando /model en la CLI de Droid para alternar entre las entradas de tu lista customModels.  

Empieza a usar Claude en minutos

Obtén una clave de API: no necesitas una cuenta de Anthropic ni estar en una lista de espera.[Obtén tu clave de API](/register) 

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.    

## Más guías de la API de Claude

[Cómo obtener una clave de API de Claude](/es/learn/how-to-get-a-claude-api-key/)[Precios de la API de Claude, explicados](/es/learn/claude-api-pricing-explained/)[La forma más económica de usar la API de Claude](/es/learn/cheapest-way-to-use-claude-api/)[Cursor ilimitado con la API de Claude](/learn/use-claude-api-with-cursor/)[Acceso ilimitado a Claude Code](/es/learn/use-claude-api-with-claude-code/)[Gateway de la API de Claude frente al acceso directo a Anthropic](/es/learn/claude-api-vs-anthropic-direct/)[Usar Claude a través de una API compatible con OpenAI](/es/learn/openai-compatible-claude-api/)[Los modelos de Claude explicados: una comparación de Claude Opus, Sonnet, Haiku y Fable; todos los modelos de la API de Claude, nombres de modelos de Anthropic y precios (2026)](/es/learn/claude-api-models-compared/)[Pagar la API de Claude con criptomonedas](/es/learn/claude-api-with-crypto-payment/)[Acceso a la API de Claude sin lista de espera](/es/learn/claude-api-without-waitlist/)[Cómo reducir el uso de tokens de Claude](/es/learn/how-to-reduce-claude-token-usage/)[Cline ilimitado con la API de Claude](/es/learn/use-claude-api-with-cline/)[Roo Code ilimitado con la API de Claude](/es/learn/use-claude-api-with-roo-code/)[Claude ilimitado en los IDE de JetBrains](/es/learn/use-claude-api-with-jetbrains/)[Aider sin límites con la API de Claude](/es/learn/use-claude-api-with-aider/)[Claude ilimitado en VS Code](/es/learn/use-claude-api-with-vscode/)[Configuración de OpenCode para Claude: ajustes de opencode.json, modelos y errores comunes](/es/learn/use-claude-api-with-opencode/)[Ejecutar un agente Hermes sin límites con Claude](/es/learn/run-hermes-agent-with-claude-api/)[Ejecutar OpenClaw sin límites con Claude](/es/learn/run-openclaw-with-claude-api/)[Qué significa una API compatible con Anthropic](/es/learn/anthropic-compatible-api/)[Clave API de Claude Code — ANTHROPIC_API_KEY: cómo obtenerla, configurarla y cuándo usar claude setup-token en su lugar](/es/learn/claude-code-api-key-setup/)[Costes de la API de Claude Code: precios y cómo reducirlos](/es/learn/claude-code-api-costs/)[Explicación de los errores de la API de Claude: error del servidor 500, sobrecarga 529, límite de solicitudes 429, solicitud incorrecta 400 y la solución para cada uno](/es/learn/claude-api-errors-troubleshooting/)[Cómo comprar créditos para la API de Claude y por qué un crédito de Claude es mejor que cualquier oferta de «comprar una cuenta de Claude»](/es/learn/buy-claude-api-credits/)[API gratuita de Claude: ¿existe una clave API de Claude gratuita y qué es realmente gratis en 2026?](/es/learn/claude-api-free-trial/)[API de Claude frente a la suscripción Claude Pro/Max: cuál elegir](/es/learn/claude-api-vs-subscription/)[Ejecutar la CLI de Codex con Claude](/es/learn/use-claude-api-with-codex/)[Conectar Claude a n8n](/es/learn/use-claude-api-with-n8n/)[Enrutar LiteLLM a Claude](/es/learn/use-claude-api-with-litellm/)[Usar Claude en Kilo Code](/es/learn/use-claude-api-with-kilo-code/)[Integra Claude en GitHub Copilot](/es/learn/use-claude-api-with-github-copilot/)[Conecta Zed a Claude a través de la pasarela](/es/learn/use-claude-api-with-zed/)[Conecta Cherry Studio a Claude](/es/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic en LangChain: importación, base_url, streaming, herramientas y errores](/es/learn/use-claude-api-with-langchain/)[SDK de Python de Anthropic: instalación, configuración de base_url, streaming y gestión de errores](/es/learn/anthropic-python-sdk/)[Claude con Vercel AI SDK: baseURL de createAnthropic, streaming y soluciones](/es/learn/use-claude-api-with-vercel-ai-sdk/)[La API de Claude Code, explicada](/es/learn/claude-code-api/)[Integración de la API de Claude en tu aplicación](/es/learn/claude-api-integration/)[Cómo usar Claude sin límites y por qué no existe un «Claude Code crackeado»](/es/learn/get-unlimited-claude-usage/)