Cómo instalar Claude Code en tu terminal: guía paso a paso para Mac y Windows

Actualizado el 18 de octubre de 2026: Reemplazamos los pasos de Node.js y npm por el instalador nativo que recomienda Anthropic, corregimos los pasos de instalación para Mac y Windows, y añadimos los requisitos del sistema y de plan, la verificación y la solución de problemas de la documentación de configuración de Anthropic. También quitamos de la sección final el precio y el plazo de entrega de nuestro servicio de sitios web.

¿Por qué Claude Code?

Usamos Claude Code para construir y mantener gugubrand.com: describimos cada cambio en lenguaje sencillo y una persona revisa lo que produce antes de publicarlo.

Si quieres entender lo que es posible con IA hoy, este es el lugar para empezar.

Lo que necesitas antes de empezar

A octubre de 2026, los requisitos del sistema y los requisitos de cuenta de Anthropic son:

• Una Mac con macOS 13.0 o posterior, o una PC con Windows 10 de 64 bits versión 1809 o posterior (o Windows Server 2019 o posterior); también funciona en Ubuntu 20.04+, Debian 10+ y Alpine Linux 3.19+
• Al menos 4 GB de RAM y un procesador x64 o ARM64
• Conexión a internet
• Estar en uno de los países donde Anthropic ofrece servicio
• Un plan de pago de Claude (Pro, Max, Team o Enterprise) o una cuenta de Claude Console con créditos de API prepagados; el plan gratuito no incluye Claude Code

Las empresas también pueden usar Claude Code a través de Amazon Bedrock, Agent Platform de Google Cloud o Microsoft Foundry. A octubre de 2026, el plan más económico que incluye Claude Code, Pro, cuesta USD 20 al mes, o USD 17 al mes con pago anual (sin impuestos) (precios de Claude).

No necesitas Node.js. Las guías anteriores, incluida una versión anterior de esta, empezaban por instalarlo, pero el instalador nativo que recomienda Anthropic no lo usa: solo el método opcional con npm lo usa (requiere Node.js 22 o posterior), y aun así el programa claude instalado no depende de Node para funcionar (documentación de Claude Code, instalación con npm).

Tampoco necesitas experiencia en programación. La guía de la terminal de Anthropic está pensada para personas que nunca han usado una terminal y no saben programar. Si prefieres no usar la terminal, esa misma guía indica que la aplicación de escritorio de Claude Code permite evitar la terminal.

Instalación en Mac (o Linux)

Paso 1: Abre la Terminal

Presiona Cmd + Espacio, escribe Terminal, presiona Enter. Aparece una ventana con un cursor parpadeante: esa es tu terminal, donde escribes los comandos (guía de terminal de Claude Code, consultada en octubre de 2026). No te asustes — es solo una forma de hablar con tu computadora usando texto. En Linux, abre la aplicación de terminal de tu distribución; los comandos de abajo son los mismos (documentación de Claude Code, instalar Claude Code). En Alpine Linux, primero instala los paquetes adicionales que Anthropic indica en sus notas sobre Alpine.

Paso 2: Instala Claude Code

Copia y pega esta línea, luego presiona Enter:

curl -fsSL https://claude.ai/install.sh | bash

Este es el instalador nativo que recomienda Anthropic (documentación de Claude Code, instalar Claude Code). El comando no muestra ningún progreso mientras descarga Claude Code, así que deja la ventana abierta y espera (guía de terminal de Claude Code). Cuando termine, mostrará Claude Code successfully installed! Las instalaciones nativas se actualizan solas en segundo plano.

Si ya usas Homebrew, esto también funciona, pero las instalaciones con Homebrew no se actualizan solas (ejecuta brew upgrade claude-code de vez en cuando):

brew install --cask claude-code

Paso 3: Comprueba que funcionó

Abre una ventana nueva de la terminal (Cmd + N en Mac) y ejecuta:

claude --version

Verás un número de versión seguido de (Claude Code) (inicio rápido de Claude Code). Si en cambio ves command not found: claude, ve a la sección de problemas comunes más abajo.

Instalación en Windows

Paso 1: Abre PowerShell

Presiona Win + X y elige Windows PowerShell (o Terminal); aparece una ventana con un cursor parpadeante y cada línea empieza con PS C:\Users\TuNombre>, lo que indica que estás en PowerShell y no en CMD (guía de terminal de Claude Code).

Abre PowerShell de forma normal: las instrucciones de Anthropic indican que no necesitas ejecutarlo como administrador (documentación de Claude Code, configuración en Windows). Si lo buscas en el menú Inicio, elige Windows PowerShell, no Windows PowerShell (x86): con la opción x86, el instalador indica que Windows de 32 bits no es compatible, aunque tu PC sea de 64 bits (documentación de Claude Code, Windows de 32 bits).

Paso 2: Instala Claude Code

En PowerShell, copia y pega esta línea, luego presiona Enter:

irm https://claude.ai/install.ps1 | iex

El comando no muestra ningún progreso mientras descarga Claude Code, así que deja la ventana abierta y espera (guía de terminal de Claude Code). Cuando termine, mostrará Claude Code successfully installed! Las instalaciones nativas se actualizan solas en segundo plano.

Si estás en CMD (Símbolo del sistema) en lugar de PowerShell, usa esta línea:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

WinGet también funciona, pero las instalaciones con WinGet no se actualizan solas (ejecuta winget upgrade Anthropic.ClaudeCode de vez en cuando):

winget install Anthropic.ClaudeCode

Opcional: si instalas Git para Windows, Claude Code puede usar su herramienta Bash; sin él, Claude Code usa PowerShell (documentación de Claude Code, configuración en Windows). Si usas WSL, abre tu distribución de Linux y ejecuta allí el comando de la sección de Mac (o Linux).

Paso 3: Comprueba que funcionó

Cierra PowerShell, abre una ventana nueva de PowerShell y ejecuta:

claude --version

Verás un número de versión seguido de (Claude Code). Si en cambio ves 'claude' is not recognized, ve a la sección de problemas comunes más abajo.

Abre Claude Code e inicia sesión

El inicio rápido de Anthropic indica iniciar Claude Code dentro de la carpeta de un proyecto (inicio rápido de Claude Code). Para un primer proyecto, crea una carpeta nueva y vacía para que sus archivos queden juntos. En Mac:

mkdir ~/mi-primer-sitio
cd ~/mi-primer-sitio
claude

En Windows, en PowerShell:

mkdir $HOME\mi-primer-sitio
cd $HOME\mi-primer-sitio
claude

La primera vez que ejecutes claude, se abrirá una ventana del navegador para que inicies sesión con tu cuenta de Claude; si el navegador te muestra un código en lugar de regresarte a la terminal, pégalo donde dice Paste code here if prompted, y cuando la terminal muestre Login successful, presiona Enter (documentación de Claude Code, autenticación). Solo inicias sesión una vez; para cambiar de cuenta más adelante, escribe /login dentro de Claude Code.

Luego escribe lo que quieres en lenguaje sencillo. Por ejemplo:

Crea un sitio web simple para una cafetería llamada Bean & Brew

Claude Code crea los archivos y escribe el código. Te pide aprobar los cambios salvo que esté en modo automático, en el que edita la mayoría de los archivos y ejecuta la mayoría de los comandos sin preguntar (documentación de Claude Code, modos de permisos).

A octubre de 2026, el modo automático suele ser el modo inicial de las sesiones en la terminal (documentación de Claude Code, modo inicial de una sesión). Tu configuración o tu organización pueden cambiarlo, y la primera sesión después de instalar puede empezar en otro modo. Puedes cambiar de modo con Shift+Tab: desde el modo automático, una pulsación cambia al modo manual (la barra de estado muestra manual mode on), en el que Claude Code te pregunta antes de la mayoría de las acciones que editan archivos o ejecutan comandos (documentación de Claude Code, cambiar de modo de permisos). Anthropic advierte que el modo automático reduce las solicitudes de permiso, pero no garantiza la seguridad.

Para ver la página, haz doble clic en el archivo HTML que creó y se abrirá en tu navegador (guía de la terminal).

Tu primer proyecto: prueba esto

Una vez que Claude Code esté funcionando, prueba esta instrucción (prompt), cambiando lo que está entre corchetes por tus datos:

Constrúyeme una página de aterrizaje para mi negocio. Mi negocio se llama [NOMBRE DE TU NEGOCIO]. Ofrezco [TU SERVICIO] en [TU CIUDAD]. Hazla bilingüe en inglés y español. Incluye mi número de teléfono y que se vea profesional.

Claude Code puede crear una primera versión a partir de tu descripción (guía de la terminal); revisa y prueba lo que construya antes de publicarlo. El resultado es un borrador en tu computadora: para ponerlo en internet necesitas un servicio de alojamiento, y si agregas un formulario de contacto, necesita un servicio de formularios para que los mensajes lleguen de verdad.

Cómo mantenerlo actualizado

Las instalaciones hechas con el instalador nativo se actualizan solas en segundo plano. Para actualizar manualmente, ejecuta:

claude update

De forma predeterminada, las instalaciones con Homebrew y WinGet no se actualizan solas (documentación de Claude Code, actualizar Claude Code), así que actualízalas de vez en cuando. Con Homebrew:

brew upgrade claude-code

Con WinGet:

winget upgrade Anthropic.ClaudeCode

Problemas comunes (y soluciones rápidas)

"command not found: claude" o "'claude' is not recognized"

Si ves command not found: claude (Mac) o 'claude' is not recognized (Windows), la carpeta de instalación todavía no está en tu PATH: abre una ventana nueva de la terminal y vuelve a intentarlo y, si sigue fallando, agrega la carpeta (~/.local/bin en Mac, %USERPROFILE%\.local\bin en Windows) a tu PATH con la corrección del PATH que indica Anthropic, abre otra terminal y ejecuta claude --version. Al final de la instalación, el instalador también muestra la corrección exacta en Setup notes.

En Mac (zsh, el shell predeterminado):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

En Linux con Bash, usa ~/.bashrc en lugar de ~/.zshrc en las dos líneas.

En Windows, en PowerShell (luego cierra y vuelve a abrir PowerShell):

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Si usas CMD, agrega %USERPROFILE%\.local\bin al PATH de tu usuario en Variables de entorno y reinicia la terminal.

"permission denied" durante la instalación

Nunca instales con sudo npm install -g: Anthropic advierte que puede causar problemas de permisos y riesgos de seguridad (documentación de Claude Code, instalación con npm). Si el instalador nativo falla con un error de permisos, es posible que tu usuario no pueda escribir en las carpetas donde se instala: revisa que pueda escribir en ~/.local/bin y ~/.claude (documentación de Claude Code, errores de permisos).

Si antes instalaste con npm, cámbiate al instalador nativo:

curl -fsSL https://claude.ai/install.sh | bash

Para revisar las dos carpetas en Mac:

test -w ~/.local/bin && echo "writable" || echo "not writable"
test -w ~/.claude && echo "writable" || echo "not writable"

Si alguna dice "not writable", usa la corrección de Anthropic de abajo (aquí sudo solo crea la carpeta y te devuelve su propiedad; Claude Code nunca se instala con sudo):

sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local

En Windows esto rara vez aplica, porque la carpeta de instalación está dentro de tu carpeta de usuario (%USERPROFILE%), donde tu usuario ya puede escribir.

Terminal equivocada en Windows

Si ves 'irm' is not recognized, estás en CMD, no en PowerShell. Si ves The token '&&' is not a valid statement separator, ejecutaste la línea de CMD en PowerShell. Si ves A parameter cannot be found that matches parameter name 'fsSL', ejecutaste el comando de Mac en PowerShell (documentación de Claude Code, comando de instalación equivocado en Windows). En los tres casos, abre PowerShell (la línea empieza con PS C:\) y ejecuta:

irm https://claude.ai/install.ps1 | iex

La página para iniciar sesión no se abre

Si el navegador no se abre solo, presiona c en la terminal para copiar el enlace de inicio de sesión y pégalo en tu navegador (documentación de Claude Code, autenticación). Si después el navegador te muestra un código, pégalo donde dice Paste code here if prompted.

¿Todavía no funciona?

Ejecuta este comando para obtener un diagnóstico de tu instalación y consulta la página de solución de problemas de instalación de Anthropic:

claude doctor

¿Qué puedes construir con Claude Code?

Algo de lo que hemos construido en gugubrand.com con Claude Code:

• Páginas con videos de fondo y animaciones
• Una calculadora de amortización de ejemplo
• La configuración de Google Analytics
• Los datos estructurados de Schema.org
• Las páginas bilingües en inglés y español
• Formularios que envían las respuestas a Google Sheets

Construyas lo que construyas, revísalo y pruébalo antes de publicarlo.

¿Prefieres no configurarlo tú?

No todos quieren aprender una herramienta nueva — y eso está perfectamente bien. Una herramienta solo es útil cuando la base a la que sirve ya está en su lugar.

Usamos Claude Code y otras herramientas de IA en nuestro propio trabajo. Para ver qué base de tu negocio necesita atención primero, responde la revisión de preparación de cinco preguntas sobre identidad, estrategia, contenido, sitio y sistemas, y promoción y mejora. Si falta una base, antes de empezar cualquier trabajo te proponemos por escrito un alcance de preparación definido y su tarifa, y no necesitas tener sitio web para comenzar.

O llámanos directamente al +1 (908) 812-9503.