Guía Maestra de Instalación de Claude Code

Paso a paso

Instalación de Claude Code

Elige tu sistema operativo. Cada sección es autosuficiente — no hace falta leer la otra.

Instalación en Mac

~ 5 minutos ~

Método nativo (el más simple)

Este método funciona en cualquier Mac (Apple Silicon o Intel) con macOS 13.0 o más nuevo. No requiere instalar Node.js ni nada extra. La instalación se actualiza sola en segundo plano.

Abre la Terminal

Presiona Cmd (⌘) + Espacio para abrir Spotlight. Escribe "Terminal" y presiona Enter. Va a aparecer una ventana negra con texto. Esa es la Terminal.

Terminal recién abierta en macOS mostrando el prompt vacío — Así se ve la Terminal recién abierta — un prompt vacío con tu nombre de usuario

Pega el comando de instalación

Copia el comando de abajo (con el botón "Copiar"), pégalo en la Terminal con Cmd (⌘) + V y presiona Enter.

Terminal — bash

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

ℹ️

¿Qué hace este comando? Descarga el instalador oficial de Anthropic, lo ejecuta y coloca Claude Code en ~/.local/bin. No toca el resto del sistema.

Espera 1-2 minutos

Vas a ver texto pasando por la Terminal. Es normal. Cuando termine, te va a mostrar un mensaje de éxito y el cursor va a volver al prompt vacío.

Terminal de macOS mostrando Claude Code successfully installed con versión y location — Cuando termina vas a ver "Claude Code successfully installed!" con la versión y la ubicación

Cierra y vuelve a abrir la Terminal

Cierra la ventana con Cmd (⌘) + Q y vuelve a abrirla. Esto hace que tu Mac reconozca el nuevo comando claude. Salta este paso si la instalación te indicó que ya estaba listo.

💡

¿Prefieres Homebrew? Si ya usas Homebrew para tus herramientas, puedes instalarlo con brew install --cask claude-code. Funciona igual, pero las actualizaciones son manuales (brew upgrade claude-code).

Métodos alternativos para Mac

Opción B · Homebrew

Si ya tienes Homebrew instalado, este es un comando solo:

Terminal

$brew install --cask claude-code

Opción C · npm (solo si ya tienes Node.js 18+)

Si ya tienes Node.js instalado para otros proyectos:

Terminal

$npm install -g @anthropic-ai/claude-code

⚠️

NO uses sudo npm install -g. Te puede generar problemas de permisos. Si tienes errores con npm, mejor usa el método nativo.

Instalación en Windows

~ 7 minutos ~

💡

Antes de empezar: en Windows, Anthropic recomienda instalar Git for Windows primero. Esto le da a Claude Code la herramienta Bash que necesita para ejecutar ciertos comandos. Si no lo instalas, Claude Code usa PowerShell — funciona, pero pierdes algunas funciones. Descárgalo en git-scm.com/downloads/win e instálalo con todas las opciones por defecto.

Método nativo con PowerShell (el más simple)

Este es el método oficial recomendado por Anthropic. Funciona en Windows 10 (build 1809+) y Windows 11. Las actualizaciones se descargan solas.

Abre PowerShell

Presiona la tecla Windows, escribe "PowerShell" y presiona Enter. Va a aparecer una ventana azul con texto blanco. Eso es PowerShell.

ℹ️

¿Cómo sé que estoy en PowerShell y no en CMD? En PowerShell, la línea de prompt empieza con PS C:\. En CMD, empieza con C:\ sin las "PS".

📸

Captura: PowerShell recién abierto mostrando el prompt PS C:\Users\TuNombre>

[reemplazar por screenshot real]

Pega el comando de instalación

Copia este comando, pégalo en PowerShell con clic derecho y presiona Enter. NO necesitas abrirlo como Administrador.

PowerShell

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

⚠️

¿Te dice "'irm' is not recognized"? Estás en CMD, no en PowerShell. Cierra la ventana, abre PowerShell otra vez (no "Símbolo del sistema") e intenta de nuevo.

Espera 2-3 minutos

PowerShell va a descargar e instalar Claude Code. Vas a ver mensajes de progreso. Cuando termine, te va a mostrar el cursor vacío otra vez.

📸

Captura: PowerShell mostrando "Claude Code installed successfully"

[reemplazar por screenshot real]

Cierra y vuelve a abrir PowerShell

Cierra la ventana y abre una nueva. Esto refresca las variables de entorno y hace que tu sistema reconozca el comando claude.

Métodos alternativos para Windows

Opción B · WinGet

Si prefieres usar el gestor de paquetes oficial de Microsoft:

PowerShell

>winget install Anthropic.ClaudeCode

Las actualizaciones son manuales: winget upgrade Anthropic.ClaudeCode

Opción C · CMD (Símbolo del sistema)

Si por algún motivo prefieres usar CMD en vez de PowerShell:

CMD

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

Opción D · WSL (para usuarios avanzados)

Si trabajas con Linux dentro de Windows (WSL), abre tu distribución de WSL y usa el mismo comando que en Mac:

WSL — bash

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

Beneficio extra: WSL 2 soporta sandboxing (ejecución aislada de comandos), algo que la versión nativa de Windows no tiene aún.

¿Quedó bien instalado?

Verificar e iniciar sesión

Estos dos comandos confirman que todo está bien y te dejan listo para usar Claude Code.

Verifica la versión

Escribe esto en la Terminal o PowerShell:

Terminal

$claude --version 2.x.x (Claude Code)

Si te muestra un número de versión, está instalado correctamente. Si te dice command not found, baja a la sección de Errores Frecuentes.

Diagnóstico completo

Para un chequeo más profundo (PATH, autenticación, configuración, MCP servers), corre:

Terminal

$claude doctor

Inicia tu primera sesión

Ve a la carpeta de cualquier proyecto y escribe simplemente claude:

Terminal

# Si quieres, primero ve a una carpeta donde tengas algo $cd Documents/mi-proyecto $claude

La primera vez te va a abrir el navegador para que inicies sesión con tu cuenta de Claude. Una vez autenticado, vuelves a la Terminal y ya estás listo.

Pantalla de bienvenida de Claude Code con menú de selección de login — Pantalla de bienvenida de Claude Code · elige opción 1 si tienes plan Pro, Max, Team o Enterprise

Tu primera conversación

Una vez dentro, escribe esto y presiona Enter:

Claude Code

>¿qué hay en esta carpeta?

Claude va a leer los archivos del proyecto y te va a explicar qué tienes. Con esto confirmas que todo funciona.

✅

Si llegaste hasta aquí: misión cumplida. Estás lista para crear con Claude. Para salir de Claude Code, escribe exit o presiona Ctrl + D.

Si algo falla

Errores frecuentes y cómo solucionarlos

Estos son los 5 errores que más veo. Todos tienen solución rápida.

command not found: claude

Tu sistema no encuentra el comando.

Cierra la terminal y vuelve a abrirla. Si después de eso sigue, en Mac corre echo $PATH y verifica que contenga ~/.local/bin. Si no, agrega export PATH="$HOME/.local/bin:$PATH" a tu archivo ~/.zshrc.

'irm' is not recognized as an internal or external command

Estás en CMD, no en PowerShell.

Cierra la ventana actual. Abre PowerShell (no "Símbolo del sistema" ni "Terminal de Windows" sin elegir el perfil). El prompt debe empezar con PS C:\.

The token '&&' is not a valid statement separator

Estás en PowerShell, pero copiaste el comando de CMD.

Usa el comando para PowerShell: irm https://claude.ai/install.ps1 | iex. O abre CMD (Símbolo del sistema) y usa el comando de CMD.

Permission denied (npm) — EACCES

Usaste sudo npm install -g. No lo hagas.

Es preferible usar el método nativo (curl ... | bash) que evita estos problemas. Si insistes con npm, configura un directorio global de npm en tu home y reinstala sin sudo.

Authentication failed / Free plan no incluye Claude Code

Estás intentando autenticar con un plan gratuito.

Claude Code requiere plan Pro, Max, Team o Enterprise. Da de alta una cuenta paga en claude.com/pricing e inicia sesión otra vez con claude o /login.

💡

¿Otro error? Corre claude doctor. Te dice exactamente qué falla y cómo arreglarlo. Si el problema persiste, llévalo a la comunidad — lo resolvemos en vivo.

Instala Claude Code
en 10 minutos

7 secciones · 10 minutos · cero misterio

Chequeo rápido (30 segundos)

Instalación de Claude Code

Instalación en Mac

Método nativo (el más simple)

Abre la Terminal

Pega el comando de instalación

Espera 1-2 minutos

Cierra y vuelve a abrir la Terminal

Métodos alternativos para Mac

Opción B · Homebrew

Opción C · npm (solo si ya tienes Node.js 18+)

Instalación en Windows

Método nativo con PowerShell (el más simple)

Abre PowerShell

Pega el comando de instalación

Espera 2-3 minutos

Cierra y vuelve a abrir PowerShell

Métodos alternativos para Windows

Opción B · WinGet

Opción C · CMD (Símbolo del sistema)

Opción D · WSL (para usuarios avanzados)

Verificar e iniciar sesión

Verifica la versión

Diagnóstico completo

Inicia tu primera sesión

Tu primera conversación

Errores frecuentes y cómo solucionarlos

Entra a FÓRMULA 100K con todos los regalos adentro

Instala Claude Code en 10 minutos

7 secciones · 10 minutos · cero misterio

Chequeo rápido (30 segundos)

Instalación de Claude Code

Instalación en Mac

Método nativo (el más simple)

Abre la Terminal

Pega el comando de instalación

Espera 1-2 minutos

Cierra y vuelve a abrir la Terminal

Métodos alternativos para Mac

Opción B · Homebrew

Opción C · npm (solo si ya tienes Node.js 18+)

Instalación en Windows

Método nativo con PowerShell (el más simple)

Abre PowerShell

Pega el comando de instalación

Espera 2-3 minutos

Cierra y vuelve a abrir PowerShell

Métodos alternativos para Windows

Opción B · WinGet

Opción C · CMD (Símbolo del sistema)

Opción D · WSL (para usuarios avanzados)

Verificar e iniciar sesión

Verifica la versión

Diagnóstico completo

Inicia tu primera sesión

Tu primera conversación

Errores frecuentes y cómo solucionarlos

Entra a FÓRMULA 100K con todos los regalos adentro

Instala Claude Code
en 10 minutos