Instalar VS Code en macOS parece trivial: descargas, arrastras, listo. Pero hay una diferencia entre tenerlo instalado y tenerlo bien instalado: que se actualice con el resto de tus herramientas y que responda al comando code desde cualquier carpeta de la terminal. En esta guía te enseño las dos cosas.
Es el editor que uso a diario y el primero que instalo en cualquier Mac nuevo. Con los años aprendí que la instalación por terminal paga dividendos: cuando quiero replicar mi entorno en otra máquina, es una línea en un script y no una tarde de clics.
Al final tendrás VS Code funcionando, integrado a la terminal y listo para recibir extensiones.
Tabla de contenidos
Tabla de contenidos
Paso 1: Instala VS Code
Hay dos caminos y ambos llegan al mismo lugar. Elige el tuyo.
Opción A: desde la terminal con Homebrew
Si tienes Homebrew instalado, es una sola línea:
brew install --cask visual-studio-codeVerifica la instalación:
code --versionCon Homebrew, VS Code se actualiza junto al resto de tus herramientas con brew upgrade. Esa es la gracia de instalarlo así.
Opción B: descarga directa
- Ve a code.visualstudio.com y descarga la versión para macOS.
- Abre el archivo
.zipdescargado. - Arrastra Visual Studio Code a la carpeta Aplicaciones.
- Ábrelo desde Launchpad o Spotlight (
Cmd + Espacio).
macOS detecta la arquitectura por ti: el mismo instalador funciona en Apple Silicon y en Intel.
Paso 2: Activa el comando code en la terminal
Este es el paso que casi todos se saltan y luego extrañan. Con el comando code activo, abres cualquier proyecto sin soltar la terminal:
cd mi-proyecto
code .Si instalaste con Homebrew, ya está activo: la cask lo configura por ti.
Si instalaste por descarga directa, actívalo desde el propio VS Code:
- Abre VS Code.
- Presiona
Cmd+Shift+Ppara abrir la paleta de comandos. - Escribe
shell commandy selecciona Shell Command: Install ‘code’ command in PATH. - Reinicia la terminal y prueba
code --version.
Paso 3: Instala tus primeras extensiones
Presiona Cmd+Shift+X y busca las que uses. Mi base mínima para empezar:
- ESLint y Prettier: calidad y formato de código.
- GitLens: superpoderes para Git.
- La extensión de tu lenguaje principal (Python, Ruby, etc.).
No instales veinte extensiones el primer día. Empieza con lo mínimo y agrega cuando sientas la necesidad real: cada extensión suma peso al arranque.
Paso 4: Verifica tu instalación
Un chequeo rápido de que todo quedó en su lugar:
code --version
code mi-archivo.txtSi el editor abre desde la terminal, quedaste listo para trabajar.
Solución de problemas comunes
code: command not found
- Con descarga directa: repite el Paso 2 (el comando no se activa solo).
- Reinicia la terminal después de activarlo: el PATH se carga al abrir la sesión.
brew: command not found
No tienes Homebrew instalado. Usa la Opción B por ahora; la próxima semana te muestro cómo montar el entorno macOS completo, Homebrew incluido.
VS Code no abre la carpeta correcta
Asegúrate de ejecutar code . dentro de la carpeta del proyecto: el . significa “este directorio”.
Conclusión
VS Code instalado, integrado a la terminal y con las extensiones justas: esa es la base de editor que vamos a usar en el resto de la serie.
Si esto te fue útil, el artículo relacionado es el paso lógico: Cómo integrar Visual Studio Code con WSL en Windows, la versión de esta guía para quienes trabajan en Windows.
La próxima semana sigo con la serie: el setup profesional completo, tanto para Ubuntu/WSL como para macOS. Si no te lo quieres perder, suscríbete al newsletter en la portada del blog.