Guía de instalación de WP-CLI

By , Founder · Updated

WP-CLI es una interfaz de línea de comandos para WordPress. Te permite instalar Plugins, gestionar usuarios, realizar operaciones con la base de datos y mucho más, todo desde un terminal sin tocar el panel de administración de WordPress. Esta guía cubre la instalación en Linux, macOS y Windows, además de pasos de verificación y resolución de problemas para los fallos más habituales.

TL;DR: En Linux o macOS (método phar), descarga el archivo Phar, hazlo ejecutable y muévelo a tu PATH. En macOS, la ruta más rápida es brew install wp-cli. En Windows, instala Cygwin o usa WSL2 y sigue los pasos de Linux. Ejecuta wp --version para confirmar que la instalación funcionó.

Referencia rápida de plataformas y métodos

Plataforma Método recomendado Alternativa
Linux curl (phar) Composer
macOS Homebrew (brew install wp-cli) curl (phar)
Windows (Cygwin) curl (phar) en terminal Cygwin —
Windows (WSL2) Sigue los pasos de Linux dentro de WSL2 —

WP-CLI también se puede instalar como paquete de Composer; consulta la documentación oficial de WP-CLI para obtener instrucciones sobre require wp-cli/wp-cli.

Requisitos previos

  • PHP 5.4 o posterior
  • WordPress 3.7 o posterior
  • Acceso SSH a tu servidor para instalaciones en Linux
  • Privilegios de administrador para instalaciones en Windows

Instalación en Linux

  1. Descargar WP-CLI:

Abre una ventana de terminal y descarga el archivo Phar de WP-CLI usando curl:

Bash
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

En nuestras pruebas con Ubuntu 22.04 LTS, el método curl tarda menos de un minuto con una conexión de servidor estándar.

  1. Hacer ejecutable WP-CLI:

Haz ejecutable el archivo Phar descargado:

Bash
chmod +x wp-cli.phar
  1. Mover WP-CLI al directorio Bin:

Mueve el ejecutable a un directorio de tu PATH. El directorio /usr/local/bin es la ubicación estándar:

Bash
sudo mv wp-cli.phar /usr/local/bin/wp
  1. Verificar la instalación de WP-CLI:

Verifica que WP-CLI esté instalado correctamente mostrando su información del sistema:

Bash
wp --info

Instalación en macOS

macOS es el entorno de desarrollo principal para muchos desarrolladores de WordPress. El método Homebrew es el camino más sencillo y mantiene WP-CLI actualizado de forma automática.

Instalar con Homebrew (recomendado)

Si tienes Homebrew instalado, ejecuta:

brew install wp-cli

Tras la instalación, confirma que funciona:

wp --version

Instalar con Phar (sin Homebrew)

Si prefieres el método manual, los pasos del Phar de Linux funcionan en macOS sin modificación:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
wp --version

Instalación en Windows

  1. Descargar WP-CLI:

Visita la página de GitHub de WP-CLI y descarga el último archivo Phar desde:

Bash
https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
  1. Descargar e instalar Cygwin:

WP-CLI requiere un terminal similar a Unix. Descarga e instala Cygwin desde el sitio oficial:

Bash
https://www.cygwin.com/

Durante la instalación, asegúrate de instalar los paquetes curl, php, php-curl, php-mbstring, openssl y openssh.

  1. Mover WP-CLI al directorio de Cygwin:

Mueve el archivo wp-cli.phar a tu directorio de inicio de Cygwin, normalmente C:cygwin64homeTu_Usuario.

  1. Hacer ejecutable WP-CLI:

Abre el terminal de Cygwin y navega a tu directorio de inicio con cd ~. Luego haz ejecutable el archivo Phar:

Bash
chmod +x wp-cli.phar
  1. Mover WP-CLI al directorio Bin:

Mueve el ejecutable a tu PATH. El directorio /usr/bin dentro de Cygwin es la ubicación estándar:

Bash
mv wp-cli.phar /usr/bin/wp
  1. Verificar la instalación de WP-CLI:

Verifica que WP-CLI esté instalado correctamente mostrando su información del sistema:

Bash
wp --info

Verificar la instalación

Tras instalar WP-CLI por cualquier método, confirma que funciona con dos comandos.

Comprobar la versión:

wp --version

El comando devuelve una cadena de versión como WP-CLI x.y.z. Consulta la página de versiones de WP-CLI para confirmar que tienes la última versión.

Ejecutar una comprobación de salud básica:

wp doctor check

Esto comprueba problemas de configuración habituales. Ejecútalo desde dentro de un directorio de WordPress para obtener resultados específicos del sitio. El comando doctor forma parte del paquete wp-cli/doctor-command, que requiere instalación separada; consulta el README de wp-cli/doctor-command para instrucciones de configuración.

Solución de problemas

Según los tickets de soporte de WP STAGING, la causa más habitual de fallos en la instalación de WP-CLI es una configuración incorrecta del PATH. A continuación se muestran los principales modos de fallo y sus soluciones.

wp: command not found tras la instalación (Linux/macOS)

El Phar de WP-CLI no se colocó en un directorio de tu $PATH. Confirma dónde se movió wp:

which wp

Si el comando no devuelve nada, el binario no está en tu PATH. Añade /usr/local/bin a tu PATH editando ~/.bashrc o ~/.zshrc:

export PATH="$PATH:/usr/local/bin"
source ~/.bashrc

Luego vuelve a intentar wp --version.

PHP no encontrado en PATH (Windows / Cygwin)

WP-CLI requiere PHP accesible desde el terminal. En Cygwin, verifica que PHP esté instalado ejecutando php --version. Si devuelve un error, vuelve a ejecutar el instalador de Cygwin y añade el paquete php.

Permiso denegado en el archivo Phar (Linux/macOS)

Si ves un error de «Permiso denegado» al mover el archivo a /usr/local/bin, añade sudo como prefijo al comando:

sudo mv wp-cli.phar /usr/local/bin/wp

Si sudo no está disponible (como en Hosting compartido), mueve el archivo a un directorio con permisos de escritura de usuario (por ejemplo, ~/bin/) y añade ese directorio a tu PATH.

Versión de PHP no compatible

WP-CLI requiere PHP 5.4 o posterior. Ejecuta php --version para comprobar la versión que resuelve tu terminal. Si tienes varias versiones de PHP instaladas, la versión que usa WP-CLI está determinada por el orden de tu PATH. En la mayoría de los casos este problema aparece en servidores con una versión de PHP inferior al mínimo de 5.4; actualizar PHP para cumplir el requisito lo resuelve. Consulta php.net/manual/en/install.php para obtener orientación sobre la instalación de PHP.

Conclusión

Ahora que WP-CLI está instalado, puedes empezar a usarlo para gestionar tu sitio de WordPress desde la línea de comandos. La documentación oficial de WP-CLI cubre la referencia completa de comandos y el manual.

Artículos relacionados

Updated on mayo 22, 2026

Rene Hermenau

Autor: Rene Hermenau

About the author: René Hermenau is the founder of WP STAGING. He works on WordPress backups, staging, migrations, database handling, and safe deployment workflows.