Conecta tu primer motor en menos de 60 segundos

./empezar
1

Conectar un motor de IA (Claude Code, Codex o Gemini) a PaellaDoc lleva menos de 60 segundos: elige el motor, pega tu método de autenticación y ejecuta la prueba de humo.

🇬🇧 English

PaellaDoc orquesta motores. No genera código por sí mismo. Así que antes de poder hacer nada, necesitas al menos un motor conectado. La Capa 0 del onboarding es un hard gate: sin motor válido, no hay acceso. Honesto, no molesto.

Camino recomendado: Claude Code CLI (con suscripción)

  1. Instala Claude Code si aún no lo tienes: Claude Code by Anthropic | AI Coding Agent, Terminal, IDE
  2. Inicia sesión una vez con tu suscripción de Anthropic: claude login
  3. Abre PaellaDoc → onboarding → paso Engine
  4. PaellaDoc detecta automáticamente claude en tu PATH y lo muestra como conectado :white_check_mark:

Por qué este es el camino recomendado: sin banner de coste por acción, sin ruido de la interfaz de rate-limit. Pagas tu suscripción fija a Anthropic y PaellaDoc simplemente la usa. Si la CLI se satura, PaellaDoc propaga el error en bruto — sin falsos mensajes amables.

Alternativa: clave API

Si no quieres la suscripción, puedes pegar una clave API (Anthropic, OpenAI para Codex, Google para Gemini) en el paso Engine. Misma orquestación, distinto modelo de facturación: pagas por token directamente al proveedor.

Multi-motor

Puedes conectar más de uno. Luego, por cada user story, eliges qué motor la ejecuta. Útil para: comparación A/B, fallback si un proveedor sufre una caída, reparto de carga.

Problemas comunes

  • “El detector de motores devuelve vacío”: PaellaDoc busca el binario en tu PATH. Verifica que which claude devuelve una ruta. Si usas wrappers tipo nvm/asdf/pyenv, el PATH que ve PaellaDoc puede diferir del de tu terminal.
  • “Conecta pero nunca termina”: normalmente significa que la CLI te está pidiendo algo de forma interactiva (login, consentimiento, MFA). Ejecuta la CLI manualmente una vez para limpiar eso.

Para cualquier otra duda sobre la configuración del motor → categoría ./engines.

🇪🇸 Español

PaellaDoc orquesta motores. No genera código por sí mismo. Así que antes de hacer nada necesitas al menos un motor conectado. La Capa 0 del onboarding es un hard gate: sin motor válido, no hay acceso. Honesto, no molesto.

Camino recomendado: Claude Code CLI (con suscripción)

  1. Instala Claude Code si no lo tienes: Claude Code by Anthropic | AI Coding Agent, Terminal, IDE
  2. Inicia sesión una vez con tu suscripción de Anthropic: claude login
  3. Abre PaellaDoc → onboarding → paso Engine
  4. PaellaDoc detecta automáticamente claude en tu PATH y lo muestra como conectado :white_check_mark:

Por qué este es el camino recomendado: sin banner de coste por acción, sin ruido de la interfaz de rate-limit. Pagas tu suscripción fija a Anthropic y PaellaDoc simplemente la usa. Si la CLI se satura, PaellaDoc propaga el error en bruto — sin falsos mensajes amables.

Alternativa: clave API

Si no quieres la suscripción, puedes pegar una clave API (Anthropic, OpenAI para Codex, Google para Gemini) en el paso Engine. Misma orquestación, distinto modelo de facturación: pagas por token directamente al proveedor.

Multi-motor

Puedes conectar más de uno. Luego, por cada user story, eliges qué motor la ejecuta. Útil para: comparación A/B, fallback si un proveedor sufre una caída, reparto de carga.

Problemas comunes

  • “El detector de motores devuelve vacío”: PaellaDoc busca el binario en tu PATH. Verifica que which claude devuelve una ruta. Si usas wrappers tipo nvm/asdf/pyenv, el PATH que ve PaellaDoc puede diferir del de tu terminal.
  • “Conecta pero nunca termina”: normalmente significa que la CLI te está pidiendo algo de forma interactiva (login, consentimiento, MFA). Ejecuta la CLI manualmente una vez para limpiar eso.

Para cualquier otra duda sobre la configuración del motor → categoría ./engines.