Cómo instalar Claude Code en Mac, Windows y Linux

¿Cómo se instala Claude Code?

Respuesta corta: abre una terminal y ejecuta el instalador oficial. En Mac, Linux o WSL es curl -fsSL https://claude.ai/install.sh | bash. En Windows, desde PowerShell, es irm https://claude.ai/install.ps1 | iex. Después compruébalo con claude --version, entra en la carpeta de tu proyecto y escribe claude para iniciar sesión y empezar tu primera sesión de trabajo.

claude --version

2.1.322 (Claude Code)

Si ves un número de versión seguido de (Claude Code), ya está instalado. Seguramente tu número sea más reciente: Claude Code se actualiza solo y a menudo.

Instala Claude Code, comprueba la versión y empieza tu primera sesión.

Qué necesitas antes de instalarlo

• Una cuenta que incluya Claude Code: Claude Pro, Max, Team o Enterprise, o una cuenta de Claude Console con créditos de API. El plan gratuito de Claude.ai no incluye Claude Code.
• Un sistema compatible: macOS 13 o superior, Windows 10 (1809) o superior, Ubuntu 20.04+, Debian 10+ o Alpine 3.19+, con 4 GB de RAM o más.
• Conexión a internet y una terminal: Terminal en Mac, PowerShell en Windows o la shell de tu Linux.

Para el instalador oficial no necesitas Node.js. Solo lo necesitas si eliges instalarlo con npm.

Instalar Claude Code: todas las opciones

# Mac, Linux y WSL: instalador oficial (recomendado)
curl -fsSL https://claude.ai/install.sh | bash
 
# Windows PowerShell: instalador oficial (recomendado)
irm https://claude.ai/install.ps1 | iex
 
# Windows CMD: instalador oficial
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
 
# Mac con Homebrew
brew install --cask claude-code
 
# Windows con WinGet
winget install Anthropic.ClaudeCode
 
# Cualquier sistema con Node.js, con npm
npm install -g @anthropic-ai/claude-code

El instalador oficial es la mejor opción para casi todo el mundo: no necesita Node.js y mantiene Claude Code actualizado en segundo plano.

Instalar Claude Code en Mac o Linux

Abre la terminal y ejecuta:

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

El script descarga Claude Code, lo comprueba y lo configura. Al terminar muestra ✅ Installation complete!. Abre una terminal nueva y compruébalo:

claude --version

No ejecutes el instalador con sudo. Claude Code se instala en tu carpeta personal y no necesita permisos de administrador; con sudo se instalaría para el usuario root y el comando claude no funcionaría desde tu terminal.

En Mac también puedes usar Homebrew: brew install --cask claude-code. En ese caso las actualizaciones se hacen con brew upgrade claude-code.

Instalar Claude Code en Windows

Abre PowerShell (sin permisos de administrador) y ejecuta:

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

Si prefieres WinGet:

winget install Anthropic.ClaudeCode

Cierra y vuelve a abrir la terminal, y ejecuta claude --version. Se recomienda instalar Git para Windows: Claude Code usa su Bash para ejecutar comandos. Sin él, Claude Code usa PowerShell. Si trabajas dentro de WSL, instálalo con el comando de Linux desde la terminal de WSL.

Instalar Claude Code con npm

Si ya trabajas con Node.js, puedes instalarlo como paquete global de npm:

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

El paquete actual pide Node.js 22 o superior, así que comprueba antes tu versión con node -v. No uses nunca sudo npm install -g: si te da errores de permisos, instala Node.js con nvm. Si todavía no tienes Node.js, mira cómo instalar JavaScript (Node.js).

Inicia sesión y empieza tu primera sesión

Entra en la carpeta de tu proyecto y arranca Claude Code:

cd mi-proyecto
claude

La primera vez, Claude Code te pide iniciar sesión. Elige tu suscripción de Claude (Pro, Max, Team o Enterprise) o tu cuenta de Claude Console y termina en el navegador que se abre. Solo lo haces una vez; para cambiar de cuenta más adelante, escribe /login dentro de la sesión.

A partir de ahí le hablas en lenguaje normal, también en español. Lee los archivos de tu proyecto, propone cambios y te pide permiso antes de editar archivos o ejecutar comandos. Prueba con una primera pregunta:

¿qué hace este proyecto?

Para salir, escribe /exit o pulsa Ctrl + D dos veces. Para seguir donde lo dejaste, ejecuta claude -c en la misma carpeta.

Los primeros comandos que vas a usar

Escribe / dentro de una sesión para ver todos los comandos. Mayúsculas + Tab cambia entre los modos de permisos.

Crea un CLAUDE.md para tu proyecto

Ejecuta /init dentro de una sesión. Claude Code analiza tu código y crea un archivo CLAUDE.md con los comandos de compilación y de tests y las convenciones que encuentra. Si ya existe un CLAUDE.md, /init propone mejoras en vez de sobrescribirlo.

CLAUDE.md es un archivo Markdown con instrucciones que Claude lee al empezar cada sesión:

Para verlos o editarlos, usa /memory. También puedes pedírselo: «añade esto a CLAUDE.md». Si quieres que siempre te conteste en español, escríbelo ahí.

Usa Claude Code en VS Code

Claude Code también existe como extensión de VS Code. Abre la vista de Extensiones (Ctrl + Mayúsculas + X en Windows y Linux, Cmd + Mayúsculas + X en Mac), busca Claude Code, de Anthropic, y pulsa Install. Necesitas VS Code 1.94.0 o superior. La extensión trae su propia copia de Claude Code; si además quieres escribir claude en la terminal integrada de VS Code, instálalo con uno de los comandos de arriba.

Tus primeros prompts en Claude Code

Claude Code funciona mejor cuando le dices qué quieres y cómo comprobarlo. Estos prompts están listos para copiar en tu primera sesión.

1. Entender un proyecto que acabas de clonar

Explícame la estructura de carpetas de este proyecto, dónde está el punto de entrada
y qué comando uso para ejecutarlo y para pasar los tests.

2. Hacer un cambio pequeño y comprobable

Añade validación al formulario de registro para que rechace emails vacíos.
Enséñame el plan antes de editar y después ejecuta los tests.

3. Trabajar con Git

Dime qué archivos he cambiado, escribe un mensaje de commit descriptivo
y crea una rama nueva llamada feature/validacion.

Si todavía no tienes un proyecto, clona uno primero: cómo clonar un repositorio de GitHub.

Errores comunes al instalar Claude Code

Actualizar o desinstalar Claude Code

El instalador oficial actualiza Claude Code solo, en segundo plano. Para actualizar en el momento:

claude update

Para desinstalar la instalación oficial en Mac, Linux o WSL, borra sus dos carpetas:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Tu configuración y tu historial se quedan en ~/.claude. Borra esa carpeta solo si también quieres eliminarlos: se borran además tus permisos y la configuración de servidores MCP.

Guías relacionadas

• Los mejores agentes de código con IA
• Cómo crear un servidor MCP en Python
• Práctica: construye un servidor MCP
• Cómo instalar JavaScript (Node.js)
• Cómo instalar NVM en Mac con Homebrew
• Cómo clonar un repositorio de GitHub