Errores Zsh · 4 min read · Oct 08, 2025
Cómo solucionar el error de comando no encontrado en Zsh en macOS

A veces, cuando intentas usar comandos en la Terminal en un Mac, puedes recibir un mensaje de error que dice comando no encontrado.
A partir de macOS Catalina, Apple cambió el sistema principal utilizado en la Terminal de ‘bash’ a ‘zsh’. Una de las razones más comunes detrás de esto es que el shell no puede encontrar el comando que estás intentando ejecutar.
Así que, si tu Mac está ejecutando macOS Catalina o una versión más nueva, podrías ver un error como “zsh: command not found: brew.”
Vamos a solucionar el error de comando no encontrado en Zsh de la siguiente manera a través de la terminal y otros métodos.
Tabla de Contenidos
- Razones comunes para el error de comando no encontrado en Zsh
- ¿Cómo solucionar el error de comando no encontrado en Zsh? - 1. Verifica la sintaxis
- Establecer la variable de entorno $Path en el archivo .zshrc
- Asegúrate de que el paquete esté instalado
- Crear perfil Zsh
- Reinstalar/Restaurar Mac
- ¿Cómo cambio a comandos Zsh en Mac?
- Resolver el error de comando no encontrado en macOS
Razones comunes para el error de comando no encontrado en Zsh
El comando no está escrito correctamente, lo que resulta en un error.
Variable PATH incorrecta para ejecutar el comando Zsh (Z shell).
El paquete correcto no está instalado.
Configuración incorrecta reciente para el comando Zsh.
¿Cómo solucionar el error de comando no encontrado en Zsh?
1. Verifica la sintaxis
Es común recibir un error de comando no encontrado debido a errores tipográficos o faltas de ortografía. Lo obtienes al escribir cosas manualmente, y se teclea caracteres no deseados.
Debes verificar el comando para ver si hay errores. Te recomendaríamos copiar el comando directamente en la terminal en lugar de
2. Establecer la variable de entorno $Path en el archivo .zshrc
Una ruta en un sistema de archivos apunta a una ubicación específica. De la misma manera, para los comandos de Terminal, la variable de sistema PATH ($PATH) muestra los directorios donde se almacenan los programas ejecutables.
Gracias a $PATH, tu Mac puede localizar fácilmente estos archivos cuando ejecutas un comando, permitiéndote usar solo el nombre del comando, como ‘ls’, en lugar de su ruta completa.
Por lo tanto, debes establecer el $PATH antes de continuar para que no obtengas el error de comando no encontrado.
- Presiona Command + Barra espaciadora para abrir la búsqueda de Spotlight

- Busca y dirígete a la terminal.

- Pega el siguiente comando y presiona enter.
export PATH="/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
Esto solucionará el error de comando no encontrado en zsh en macOS.
3. Asegúrate de que el paquete esté instalado
Puedes obtener un error de comando no encontrado cuando un paquete no está instalado mientras intentas acceder a él. Aquí te mostramos cómo verificar si el paquete está instalado.
Para Homebrew
- Ingresa el siguiente comando y presiona enter para listar todos los paquetes instalados.
brew list
Para paquetes de Python
- Si deseas ver los paquetes de Python instalados, ingresa el siguiente comando y presiona enter.
pip list
4. Crear perfil Zsh
El error de comando no encontrado puede ocurrir en Zsh si el archivo .zshrc no se ha creado o si le faltan ciertas configuraciones. Aquí te mostramos cómo crear un perfil Zsh antes de ingresar otros comandos.
- Ingresa el siguiente comando en la terminal y presiona enter para redirigir a la carpeta de inicio.
cd ~/ - Después de eso, ingresa el siguiente comando para crear un perfil Zsh.
touch .zshrc
- Ahora, verifiquemos el perfil Zsh abriéndolo.
open .zshrc- Verás el archivo zshrc abierto en el editor de texto, confirmando la creación del perfil Zsh.

5 . Reinstalar/Restaurar Mac
Cuando has agotado todas las opciones para solucionar el error de comando no encontrado, entonces es hora de comenzar de nuevo. Reinstalar macOS puede ser una solución para solucionar el error de comando no encontrado en Zsh.
Especialmente si el error se debe a un problema más amplio del sistema, como archivos del sistema corruptos o configuraciones mal configuradas, puedes usar la guía oficial de Apple sobre cómo reinstalar macOS.
Y si has respaldado macOS usando Time Machine, entonces puedes restaurarlo a una computadora que se inició cuando no recibías el error de comando Zsh. Para esto también, puedes usar la guía oficial sobre cómo restaurar macOS a través de Time Machine.
¿Cómo cambio a comandos Zsh en Mac?
Para macOS Catalina y versiones posteriores, Zsh ya debería estar configurado como tu shell predeterminado. Aquí te mostramos cómo confirmar o cambiar a él:
Verificar shell actual:
En la Terminal, verifica tu shell actual escribiendo echo $SHELL. Si devuelve algo como /bin/zsh, entonces Zsh ya es tu shell predeterminado.
Cambiar a Zsh (si es necesario):
Ingresa el comando chsh -s /bin/zsh en la Terminal. Es posible que necesites ingresar tu contraseña para confirmar este cambio.
Reiniciar Terminal:
Finalmente, cierra y vuelve a abrir tu Terminal. Esto inicia una nueva sesión usando Zsh.
Resolver el error de comando no encontrado en macOS
Así que, aquí está cómo puedes solucionar el error de comando no encontrado en macOS. Usar gestores de paquetes como HomeBrew o Macport, junto con Zsh, puede facilitar las cosas.
Asegúrate de escribir los comandos correctos para resolver los errores.
Recibe nuevas publicaciones en tu bandeja de entrada.
No spam. Cancela la suscripción en cualquier momento.