# Guía de Shopify CLI > Qué es Shopify CLI, cómo instalarlo en tu computadora y los comandos de temas que vas a usar todos los días. Incluye un generador para armar el comando exacto sin memorizar opciones. - Página canónica (herramienta interactiva): https://adigitalcreativo.com.mx/herramientas/shopify-cli/ - Idioma: es-MX (México) · Moneda: MXN - Tema: Técnicas y SEO — [mapa del tema](https://adigitalcreativo.com.mx/herramientas/temas/tecnicas.md) - Actualizado: 2026-10-25 (misma fecha que muestra la página) - Mantenido por: aDigital (adigitalcreativo.com.mx) - Pregunta que responde: ¿Qué es Shopify CLI y para qué sirve? Este documento es la versión en texto de la página. La calculadora o generador funciona en la página canónica (requiere JavaScript; los datos no salen del navegador). Las tarifas son de referencia y el usuario puede ajustarlas allí. --- ## ¿Qué es Shopify CLI y para qué sirve? Shopify CLI es la herramienta oficial de línea de comandos de Shopify para desarrollar temas y apps. Con ella descargas un tema a tu computadora (theme pull), lo previsualizas con recarga en vivo (theme dev) y subes cambios (theme push). Requiere Node.js 22.12 o superior y Git. Fuente: [Shopify CLI para temas (shopify.dev)](https://shopify.dev/docs/api/shopify-cli/theme). Sigue con: [Ejecuta tu tienda Shopify en local](https://adigitalcreativo.com.mx/herramientas/tienda-shopify-en-local/) y [Calculadora de comisiones Shopify México](https://adigitalcreativo.com.mx/herramientas/calculadora-comisiones-shopify/). ## Qué es Shopify CLI Shopify CLI es la herramienta oficial de línea de comandos de Shopify. Para temas te permite descargar el código de tu tienda, editarlo en tu editor favorito (VS Code, Cursor…), verlo en vivo en tu computadora y subir los cambios cuando estén listos. Es gratis y la mantiene Shopify en GitHub. ### Requisitos - **Node.js 22.12 o superior.** Revisa tu versión con `node -v`. - **Git 2.28.0 o superior** (`git --version`). - Un gestor de paquetes: npm (viene con Node), Yarn 1.x o pnpm. - Una cuenta con acceso a la tienda: propietario, colaborador o personal con permiso de **Temas**. ### Instalación Instala Node.js LTS desde [nodejs.org](https://nodejs.org/) (o con `brew install node`). Git ya viene con las herramientas de desarrollo de Xcode (`xcode-select --install`). Luego instala Shopify CLI con npm: ``` npm install -g @shopify/cli@latest ``` O con Homebrew: ``` brew tap shopify/shopify brew install shopify-cli ``` Comprueba la instalación: ``` shopify version shopify help ``` ## Comandos esenciales de temas La primera vez que ejecutes un comando que necesita tu tienda, agrega `--store mitienda.myshopify.com`. Shopify CLI abre el navegador para que inicies sesión y recuerda la tienda para los siguientes comandos. Consulta cuál está activa con `shopify theme info`. ### shopify theme init Crea un tema nuevo clonando el **Skeleton theme** oficial de Shopify (un punto de partida mínimo). Con `--clone-url` puedes clonar otro repositorio. ``` shopify theme init mi-tema ``` ### shopify theme dev Sube tu carpeta a un tema de desarrollo oculto y sirve una vista previa en `http://127.0.0.1:9292` con recarga en vivo de CSS y secciones. También te da un enlace al editor de temas y uno de vista previa para compartir. Guía completa en [ejecuta tu tienda Shopify en local](https://adigitalcreativo.com.mx/herramientas/tienda-shopify-en-local/). ``` shopify theme dev --store mitienda.myshopify.com ``` ### shopify theme pull Descarga los archivos de un tema de la tienda a tu carpeta. Sin opciones te pregunta cuál. ``` shopify theme pull --theme 123456789 ``` ### shopify theme push Sube tus archivos y **sobrescribe** el tema remoto. Si no indicas tema, te pide elegir uno. Por seguridad, empuja a un tema sin publicar. ``` shopify theme push --unpublished ``` ### shopify theme list Lista los temas de la tienda con su ID, nombre y estado (live, unpublished, development). Útil para copiar el ID que usarás con `--theme`. ``` shopify theme list ``` ### shopify theme publish Publica un tema que ya está en tu biblioteca. Se convierte en el que ven tus clientes. ``` shopify theme publish --theme 123456789 ``` ### shopify theme share Sube tu carpeta como un tema nuevo sin publicar y te da un enlace de vista previa para enviar a tu cliente o socio. ``` shopify theme share ``` ### shopify theme check Analiza el código Liquid, JSON y recursos en busca de errores y malas prácticas (imágenes sin tamaño, traducciones faltantes, código obsoleto). ``` shopify theme check ``` ### shopify theme package Empaqueta tu tema en un archivo ZIP listo para subir manualmente desde el administrador. ``` shopify theme package ``` ### Opciones (flags) más útiles | Flag | Para qué sirve | | --- | --- | | `--store` / `-s` | Tienda con la que trabajas: prefijo o URL completa .myshopify.com. | | `--theme` / `-t` | Tema de destino por ID o nombre. | | `--only` / `-o` | Solo sube o descarga los archivos que coincidan. Se puede repetir; pon los comodines entre comillas. | | `--ignore` / `-x` | Excluye archivos. Ideal para no pisar `config/settings_data.json`. | | `--live` / `-l` | Apunta al tema publicado (en pull y push). | | `--allow-live` / `-a` | Confirma que sí quieres modificar el tema publicado; obligatorio sin modo interactivo. | | `--development` / `-d` | Usa tu tema de desarrollo. | | `--unpublished` / `-u` | En push, crea un tema nuevo sin publicar. | | `--nodelete` / `-n` | No elimina archivos del otro lado que no existan en el tuyo. | | `--password` | Token de la app Theme Access, para trabajar sin iniciar sesión con tu cuenta. | ### Errores comunes - **"command not found: shopify":** la carpeta global de npm no está en tu PATH, o abriste la terminal antes de instalar. Cierra y abre la terminal; en Windows reinicia la sesión. - **Error de versión de Node:** actualiza a Node 22.12 o superior y reinstala el CLI. - **EACCES al instalar en macOS/Linux:** no uses `sudo npm`; instala Node con nvm o Homebrew para que los paquetes globales queden en tu usuario. - **"You are not authorized" o error 401:** tu cuenta no tiene permiso de Temas en esa tienda, o iniciaste sesión con otra cuenta. Ejecuta `shopify auth logout` y vuelve a entrar. - **"Invalid theme directory":** estás en la carpeta equivocada. Debes estar donde existen `layout/`, `sections/`, `templates/`, etc. - **Se borraron personalizaciones del editor:** un push sobrescribió `settings_data.json` o los JSON de plantillas. Usa `--ignore` o haz pull antes de subir. ## Preguntas frecuentes ### ¿Qué versión de Node.js necesita Shopify CLI? Según la documentación de Shopify revisada en octubre de 2026, Shopify CLI requiere Node.js 22.12 o superior y Git 2.28.0 o superior. ### ¿Shopify CLI es gratis? Sí. Es una herramienta oficial y gratuita de Shopify. Solo necesitas una cuenta con acceso a la tienda: propietario, colaborador o personal con permiso de Temas. ### ¿Puedo romper mi tienda con Shopify CLI? Solo si subes cambios al tema publicado. Por defecto `theme dev` trabaja sobre un tema de desarrollo oculto, y push al tema en vivo requiere la opción `--live` o `--allow-live`. Trabaja siempre sobre una copia. ### ¿Qué diferencia hay entre theme push y theme share? `push` sube tus archivos a un tema existente (lo sobrescribe). `share` crea un tema nuevo sin publicar con tus archivos y te da un enlace de vista previa para compartir. Comandos y requisitos verificados contra la documentación de Shopify (shopify.dev) en octubre de 2026. Shopify actualiza el CLI con frecuencia: ante cualquier duda ejecuta `shopify theme --help`. --- ## Herramientas relacionadas - [Ejecuta tu tienda Shopify en local](https://adigitalcreativo.com.mx/herramientas/tienda-shopify-en-local/index.md): Levanta tu tema en tu computadora con recarga en vivo y trabaja sin tocar la tienda publicada. - [Calculadora de comisiones Shopify México](https://adigitalcreativo.com.mx/herramientas/calculadora-comisiones-shopify/index.md): Lo que recibes después de Shopify Payments o de una pasarela externa con su comisión adicional. - [Auditor de velocidad web](https://adigitalcreativo.com.mx/herramientas/auditor-velocidad/index.md): Puntaje de rendimiento y Core Web Vitals de cualquier página, con plan de acción en español. - [Optimizador de imágenes a WebP](https://adigitalcreativo.com.mx/herramientas/optimizador-imagenes-webp/index.md): Convierte tus imágenes a WebP en el navegador y mide cuánto peso ahorras. [Mapa completo de herramientas](https://adigitalcreativo.com.mx/herramientas/sitemap.md) · [llms.txt](https://adigitalcreativo.com.mx/herramientas/llms.txt)