Instalar MXterm Pro y primeros pasos | MXterm Pro
Esta página te lleva de la descarga a un espacio de trabajo en marcha: instala la app, completa el Composer y ubica las pestañas, las ventanas y la barra lateral. Lee la sección de Bypass Mode antes de iniciar un agente.
Instalar
Descarga MXterm Pro desde la página de descarga. En una Mac obtienes un DMG que funciona de forma nativa tanto en Apple Silicon como en Intel y necesita macOS 10.15 o posterior. En una PC con Windows, la página de descarga ofrece un instalador para Windows 10 u 11 en x64; no hay compilación para ARM64. El resto de esta página se comprobó con la app de macOS, y donde se sabe que Windows es distinto, el texto lo indica.
Después de hacer clic en un botón de descarga del sitio, aparece una ventana Instala en tres pasos con los pasos del archivo que elegiste. Son los mismos pasos de más abajo.
- Abre el DMG que descargaste.
- Arrastra MXterm Pro a Aplicaciones.
- Abre MXterm Pro desde Aplicaciones.
- Si macOS pregunta si quieres abrir una app que se descargó de internet, elige Abrir.
En macOS la app está firmada con un Apple Developer ID y notarizada por Apple.
En Windows:
- Ejecuta el
.exeque descargaste. - Si Windows SmartScreen muestra Windows protegió su PC, haz clic en Más información y luego en Ejecutar de todas formas. El instalador todavía no está firmado, así que Windows muestra el editor como Desconocido.
- Sigue los pasos del instalador.
Primer inicio
La primera vez que abres la app aparece un recorrido de seis diapositivas titulado Bienvenido a MXterm Pro. Haz clic en Siguiente para avanzar o en Omitir recorrido para cerrarlo. El menú de idioma del encabezado lista todos los idiomas de la app; al elegir uno, el recorrido y la app cambian a ese idioma. El recorrido se abre solo una vez y no vuelve después de cerrarlo; puedes repetirlo desde el menú del logo, en Recorrido de bienvenida.
Detrás del recorrido la ventana tiene una sola pestaña, New Tab, que muestra el Composer. La interfaz arranca en el primer idioma de la lista de idiomas de tu sistema que la app ofrece, y en inglés si no ofrece ninguno; si ya elegiste un idioma antes, se conserva. La app ofrece English, Tiếng Việt, 简体中文, 日本語, 한국어, Español, Français, Türkçe, Bahasa Indonesia, Português (Brasil) y Deutsch. Puedes cambiarlo después en Configuración, donde cada idioma aparece con su propio nombre.
Crear un espacio de trabajo
Un espacio de trabajo es una pestaña con una cuadrícula de paneles de terminal que arrancan todos en una misma carpeta. No se ejecuta nada hasta que lo creas.
- En Carpeta de trabajo, escribe una ruta o haz clic en Explorar. Empieza en tu carpeta personal, y las carpetas que usaste antes aparecen en Recientes.
- En ¿Cuántas terminales?, elige 1, 2, 4, 6, 8, 9, 10, 12, 16 o 20. La vista previa de abajo muestra la cuadrícula que obtendrás. Disposición cambia entre Horizontal (una cuadrícula) y Vertical (una fila de columnas altas, con los paneles uno al lado del otro). Vertical ofrece de 1 a 6 paneles, y una cantidad que no ofrece baja a la mayor que queda por debajo.
- En Agentes de IA, usa los botones − y + para fijar cuántos paneles ejecutan cada agente. La lista empieza con Claude Code, Codex, Grok y Gemini CLI, luego la fila Terminal (Plain Shell) y después OMP; siguen los demás agentes, con los instalados primero. Un agente cuya CLI la app no encuentra aparece marcado como No instalado y tiene un botón Instalar que abre la guía de instalación de ese agente; MXterm Pro nunca ejecuta la instalación por ti. Para Cursor Agent, esa CLI es
cursor-agent. Mientras la app todavía está comprobando, o si la comprobación falló (aparece un enlace Reintentar), no se puede marcar ningún agente y todos los paneles son una shell simple. - Los paneles que dejes sin asignar ejecutan una shell simple. La fila Terminal (Plain Shell) te permite elegir esa shell y fijar explícitamente la cantidad de paneles simples.
- Revisa las tres opciones bajo la vista previa (están en la tabla de abajo) y haz clic en Crear espacio de trabajo o presiona
Cmd+Enter(Ctrl+Enteren Windows).
El Composer siempre ofrece Claude Code, Codex, OpenCode, GitHub Copilot, Qwen Code, Amp, Gemini CLI, Cursor Agent, Antigravity, OMP (Oh My Pi) y Grok. Otros agentes, como Aider, Goose, Kimi Code y Devin, aparecen solo cuando MXterm Pro encuentra su CLI en tu equipo. El Composer empieza con 2 terminales y solo pone en ellas agentes que tienes instalados. Con Claude Code y Codex instalados, propone uno de cada uno. Si no, los dos primeros agentes instalados de la lista se reparten los paneles, la mitad (redondeada hacia arriba) para el primero; con un solo agente instalado, este recibe la mitad y el resto son shells simples, y sin ninguno todos los paneles son shells simples. Cuando haces clic en Crear espacio de trabajo, el Composer recuerda esa elección (agentes, terminales simples, disposición y cantidad de paneles) y parte de ella la próxima vez, ajustada a la cantidad de paneles que elijas; un agente recordado que ya no está instalado pasa a ser una shell simple. Revisa las filas de Agentes de IA antes de crear el espacio de trabajo.
| Opción | Por defecto | Qué hace |
|---|---|---|
| Activar modo bypass (autoaprobar permisos de CLI) | Desactivada | Inicia los agentes compatibles con su flag para omitir aprobaciones. Mira Bypass Mode. |
| Aislar funciones en git worktrees | Desactivada | Cada panel de agente arranca en su propio git worktree y su propia rama, creados dentro de .worktrees/ en la carpeta. .worktrees/ se agrega al .gitignore de la carpeta. |
| Reanudar sesión previa (--resume / codex resume) | Desactivada | Inicia Claude Code, Gemini CLI, OMP y Grok con --resume y Codex con codex resume, la forma en que cada CLI reabre una sesión anterior. Grok reabre su última sesión en la carpeta. Los demás agentes arrancan con normalidad. |
Si la carpeta ya tiene sesiones de agentes, aparece una lista Reanudar sesiones debajo del campo de la carpeta. Marca una sesión para reabrirla en su propio panel. Un espacio de trabajo tiene como máximo 20 paneles, así que no puedes marcar más al llegar a ese número. Una sesión que marcas tiene prioridad sobre la opción de reanudar en su panel.
Si la carpeta es un repositorio git sin commits todavía, Aislar funciones en git worktrees primero hace un commit de un .gitkeep vacío con el mensaje Initial commit, porque un worktree necesita un commit del que partir. Nada más de la carpeta pasa a staging ni entra en un commit.
Mientras la pestaña sea lo bastante ancha, el Composer tiene dos columnas: la carpeta de trabajo a la izquierda y las terminales a la derecha. Cuando no lo es, por ejemplo con la barra lateral y el panel derecho abiertos a la vez, las columnas se apilan en una sola.
Hay más sobre agentes y worktrees en Agentes y Control Room (antes War Room).
Bypass Mode viene desactivado por defecto
Bypass Mode indica a los agentes que omitan sus prompts de aprobación, así que ejecutan comandos y cambian archivos sin preguntarte antes. Está desactivado salvo que lo actives tú: de fábrica tus agentes se detienen y preguntan.
Si usaste una versión anterior, el Composer muestra un aviso hasta que lo descartes o cambies la casilla: El modo bypass ahora está desactivado por defecto. Los agentes preguntarán antes de ejecutar comandos o editar archivos. Vuelve a activarlo con el interruptor de abajo. Si ya habías marcado o desmarcado la casilla tú mismo, se conserva tu elección.
Para activarlo:
- Abre el Composer: presiona
Cmd+T(Ctrl+Ten Windows), o haz clic en + al final de la barra de pestañas y elige Pestaña nueva. - Marca Activar modo bypass (autoaprobar permisos de CLI).
--dangerously-skip-permissions, Codex con --dangerously-bypass-approvals-and-sandbox, Gemini CLI y Qwen Code con --yolo, y Grok con --always-approve. El Composer lo dice bajo la casilla: Los agentes ejecutarán comandos y editarán archivos sin preguntar. Actívalo solo en carpetas donde aceptes eso.Bypass Mode agrega el flag propio de cada agente compatible para omitir aprobaciones, que MXterm Pro conoce para 14 agentes. Los demás, incluidos OpenCode, GitHub Copilot, Amp, Cursor Agent, Antigravity y OMP, arrancan con su comando normal, con Bypass Mode activado o no.
La elección se guarda en cuanto la cambias. Todo panel de agente que se inicie después la respeta, incluidos los paneles que se reabren la próxima vez que abras la app. La casilla del Composer es el interruptor del bypass basado en flags. Goose no tiene flag, así que su modo automático es una variable de entorno que solo se ofrece en Configuración.
Free y Pro
Todo lo de esta página funciona en Free. Free no tiene límite de paneles: puedes abrir tantos paneles como quieras entre todas las pestañas y ventanas. Además de los paneles, Free limita seis cosas por defecto, y una licencia Pro quita todos esos límites. Pro también añade Mis dispositivos (abre tus otros Mac con sesión iniciada sin código ni contraseña) y una contraseña de acceso Permanente (no caduca).
| Límite | Free | Pro |
|---|---|---|
| Hosts SSH guardados | 5 | Sin límite |
| Control Rooms con miembros a la vez | 1 | Sin límite |
| Terminales en una Control Room | 2 | Sin límite |
| Hosts de MXterm guardados | 1 | Sin límite |
| Otras computadoras emparejadas para controlar esta | 1 | Sin límite |
| Paneles compartidos a la vez para control remoto | 5 | Sin límite |
Estos son los números por defecto. mxterm.net puede cambiarlos para Free dentro de rangos fijos, y un cambio puede caducar, tras lo cual vuelven a aplicarse los valores por defecto. Un límite se comprueba cuando agregas algo: bajarlo nunca cierra lo que ya está abierto o guardado, y si agregas un segundo host de MXterm en Free se abre el diálogo de mejora de plan, mientras que los hosts que ya tienes se conservan. Lo mismo vale para una segunda Control Room con miembros: una sala sin miembros no cuenta, y las salas que ya tienes se conservan. La propia app aplica los límites de Control Room y de hosts de MXterm. Solo cuentan otras computadoras con MXterm; los navegadores no. La app móvil de MXterm (iPhone, iPad) tampoco cuenta para el límite de 1 otra computadora que puede controlar este Mac. Los dos límites de control remoto rechazan solo algo nuevo: una computadora ya emparejada y un panel ya compartido se quedan como están.
El acceso remoto tiene una restricción más que depende de Pro: en Free puedes activar una contraseña de acceso que dura hasta 8 horas (Temporal), pero una contraseña Permanente, o una Temporal de más de 8 horas (hasta 7 días), requiere Pro. Una contraseña tiene al menos 6 caracteres. Consulta Configuración.
Explorar, editar, subir y descargar archivos por SFTP es gratis, y el Token Meter también.
Cuando llegas a un límite, un diálogo te indica cuál es y ofrece Obtener MXterm Pro, Ingresar clave de licencia o Ahora no. Los planes están en Precios; cómo activar una clave se describe en Configuración.
Cerrar la última ventana cierra la app
Cerrar la única ventana de MXterm Pro cierra la app, en todas las plataformas. No sigue ejecutándose en segundo plano: se detienen todas las terminales y agentes de todas las pestañas. Al salir de la app se detiene toda conexión activa. MXterm Pro está diseñado para guardar lo que compartes y restaurarlo en el próximo inicio, cuando el mismo panel vuelva a estar en ejecución; un uso compartido que no se puede verificar se descarta, nunca se amplía.
Si abriste una segunda ventana, cerrar una de ellas no cierra la app. Una ventana que aún tiene terminales pregunta primero ¿Cerrar esta ventana? y ofrece mover sus pestañas a la otra ventana en lugar de terminarlas. Solo al cerrar la última ventana se cierra la app.
Mientras la app está en ejecución, al hacer clic en su icono de la barra de menús (la bandeja del sistema en Windows) la ventana pasa al frente, y su menú tiene Show MXterm Pro, Merge All Windows, Check for Updates… y Quit.
Cuando vuelves a abrir la app, tus pestañas de espacios de trabajo regresan con la disposición de sus paneles, y cada panel arranca otra vez en su carpeta. Un panel de Claude Code reabre su propia conversación por id cuando la app la recordaba, y si no, inicia una conversación nueva. Los paneles de Gemini CLI, OMP y Grok se inician con --resume y los de Codex con codex resume, para que retomes la conversación anterior; los demás paneles arrancan desde cero. Las pestañas que seguían en el Composer no se restauran.
La app también recuerda, más o menos cada 3 segundos, qué ejecuta cada panel. Para Claude Code y OMP conserva la conversación que estaba abierta, así que el panel reabre esa y no un selector ni la más reciente de la carpeta. Si esa conversación ya no existe, Claude Code, OMP y Grok reintentan con un simple --resume en la mayoría de las shells, en vez de quedarse en un prompt vacío. Si iniciaste un agente tú mismo en un panel de terminal simple, el panel vuelve ejecutando ese agente, reanudado de la misma forma pero sin su flag de Bypass Mode. En Windows la app no detecta qué ejecuta un panel, así que allí no se recuerda nada de esto.