Desplegar
Despliega una app con Codex: del repositorio a un servicio en marcha con ubctl
Codex puede desplegar una app solo si opera Unbroker a través de ubctl. Codex no aloja el servicio. Unbroker lo construye y lo ejecuta después de que el CLI crea o actualiza el servicio que indicas.
Revisado el 26 de octubre de 2026
¿Codex aloja tu app?
No. Codex edita el repositorio y puede ejecutar ubctl en tu máquina. La URL pública, el build y el proceso en marcha son de Unbroker Cloud Apps.
Instalar la skill no crea una cuenta, no emite un token y no despliega nada. La skill es un conjunto de instrucciones para el CLI ubctl.
Qué necesitas
Necesitas Unbroker Pro para crear un token de API, ubctl instalado en local, Node.js con npx, y Codex. Pro cuesta $25 al mes e incluye un crédito de uso del mismo monto. Crear o dejar corriendo un servicio puede generar cargos en ese plan.
Un token de solo lectura alcanza para la primera inspección. Crear o cambiar un servicio pide un token de lectura y escritura, y permiso para administrar apps en esa organización. Usa un repositorio que no sea de producción en el primer intento.
Configuración
Instala ubctl con la guía del CLI, crea el token en Cloud y pégalo en el prompt oculto de login. Después confirma la organización. Estos comandos se quedan en tu terminal. No pegues el token en Codex.
Instala la skill ubctl-ops para Codex con el comando de abajo. Es el comando publicado en la documentación de Unbroker y en la guía de inicio del CLI. El archivo de la skill está en el repositorio unbroker-app/ubctl. Cierra y vuelve a abrir Codex para que vea la skill. La primera tarea solo debe listar proyectos.
ubctl --version
ubctl login
ubctl whoami
ubctl doctor
npx skills@latest add unbroker-app/ubctl --skill ubctl-ops --agent codex --global --yes
$ubctl-ops Show the active Unbroker organization and list its projects.
Do not create or modify resources.Prompt de despliegue para Codex
Reemplaza cada valor entre corchetes antes de enviar este prompt. El prompt queda en inglés, que es el idioma de la skill. Codex debe revisar el framework, el comando de build, el comando de arranque y los nombres de las variables que la app necesita.
Tiene que esperar a que el despliegue llegue a un estado terminal. Un despliegue en cola no es un release terminado. El comando de espera documentado es ubctl apps deploy <serviceId> --wait.
$ubctl-ops Deploy this repository to Unbroker.
Use organization [organization name] and project [project ID].
Create a new service named [service name] from [Git repository URL]
and branch [branch]. You may create and deploy this service on Pro.
Do not modify other services or attach a custom domain.
Inspect the repository's framework, build command, start command
and required runtime variables. Tell me which secret keys I need
to enter in Cloud; do not ask me to paste their values into chat.
Wait for the deployment to finish, inspect any failure, and verify
the public application URL. Report the service ID, deployment ID,
tested URL and checks performed.Si un despliegue falla: deja que Codex lea los logs
Pide a Codex que lea el log del build y el log de runtime, y que nombre el paso que falló antes de cambiar nada. Un reinicio, un reset del volumen o un tamaño más grande no son un arreglo universal.
Los comandos de abajo son los documentados para esperar, leer el log de un despliegue y leer logs de runtime. Un rollback promueve un despliegue anterior. No reconstruye el commit, y no restaura una base de datos ni un volumen.
ubctl apps deploy <serviceId> --wait
ubctl apps deployment <deploymentId> --log
ubctl apps services logs <serviceId>Deja los secretos fuera del chat
Dile a Codex qué nombres de variables crear. Carga los valores en Cloud. No pegues tokens, URLs de base de datos ni contraseñas en el prompt, en un flag que quede en el historial, ni en el repositorio.
ubctl doctor informa la configuración sin imprimir el token. Prefiere ubctl login, o un token por tubería a ubctl login --stdin, antes que poner el token en la línea de comandos. La misma regla vale si además conectas el servidor MCP de Codex que está documentado: el token se queda en una variable de entorno, no en el chat.
Codex y Claude Code en Unbroker
Los dos agentes usan la misma skill ubctl-ops y la misma cuenta de Unbroker. Ninguno aloja la app. La diferencia documentada es cómo se instala y cómo se invoca la skill.
Codex usa --agent codex y se invoca con $ubctl-ops. Claude Code usa --agent claude-code y se invoca con /ubctl-ops. El prompt de esta página es el de Claude Code con esa invocación cambiada. Los tokens de API igual piden Pro en los dos agentes.
Preguntas frecuentes
¿Codex puede desplegar una app en Unbroker?
Sí, cuando ubctl está autenticado y la skill ubctl-ops está instalada para Codex. Codex despliega creando o actualizando un servicio de Unbroker. La app después corre en Unbroker.
¿Codex aloja la app desplegada?
No. Codex opera el CLI. El hosting, los builds y la URL pública son de Unbroker Cloud Apps.
¿Cuál es el comando de instalación para Codex?
El comando documentado es npx skills@latest add unbroker-app/ubctl --skill ubctl-ops --agent codex --global --yes. Después reinicia Codex e invoca la skill con $ubctl-ops.
¿Hace falta Pro?
Los tokens de API piden Pro. Pro cuesta $25 al mes con un crédito de uso del mismo monto. Crear recursos y dejar un servicio corriendo puede sumar uso encima de esa cuota cuando el crédito se agota. La skill por sí sola no despliega nada.