Cómo instalar Claude Code en Windows, Mac y Linux (paso a paso)

Publicado el 21 de octubre de 2026 · Comandos comprobados en la documentación oficial el 21 de octubre de 2026 · 10 min de lectura · Por el equipo de Master en Claude · Blog MasterEnClaude

Has oído que Claude Code puede leer tu proyecto, editar archivos y ejecutar comandos por ti, y quieres probarlo. El primer paso es instalarlo, y aquí es donde mucha gente se atasca: con el comando equivocado para su terminal, con el clásico «claude no se reconoce como comando» o sin saber qué cuenta necesita.

En esta guía tienes los comandos oficiales para cada sistema, los requisitos, cómo iniciar sesión y cómo resolver los errores más habituales. Si todavía no tienes claro qué es Claude Code, empieza por Claude Code: qué es, cómo instalarlo y cómo usarlo.

Antes de empezar: requisitos de Claude Code

Según la documentación oficial (consultada el 21 de octubre de 2026), Claude Code funciona en:

¿Y la cuenta? Claude Code necesita una de estas opciones:

• Un plan de pago de Claude: Pro, Max, Team o Enterprise. Es la opción que recomienda Anthropic.
• Una cuenta de la Claude Console (la de la API), con créditos prepago. Pagas por tokens. Si quieres calcular cuánto te costaría, lo explicamos en Precio de la API de Claude.
• Un proveedor en la nube como Amazon Bedrock, Google Cloud o Microsoft Foundry, pensado para empresas.

El plan gratuito de claude.ai no incluye Claude Code. La instalación en sí no cuesta nada, pero sin una de esas cuentas no podrás usarlo.

¿No te llevas bien con la terminal? Anthropic también ofrece Claude Code en una app de escritorio (macOS y Windows, y Linux en beta) y como extensión para VS Code. Lo vemos más abajo.

Paso 1: abre la terminal correcta

Parece obvio, pero es la primera fuente de errores, sobre todo en Windows.

• macOS: abre la app Terminal (búscala con Cmd + Espacio). Por defecto usa Zsh.
• Linux: abre tu terminal habitual.
• Windows: tienes dos opciones, y cada una usa un comando distinto:
  • PowerShell: la línea empieza por PS C:\....
  • CMD (Símbolo del sistema): la línea empieza por C:\... sin PS.

No hace falta abrirla como administrador.

Paso 2: instala Claude Code con el instalador nativo (recomendado)

Anthropic recomienda el instalador nativo, porque no necesita Node.js y se actualiza solo en segundo plano. Copia la línea que corresponde a tu sistema:

macOS, Linux y WSL:

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

Windows (PowerShell):

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

Windows (CMD):

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

Dos cosas que conviene saber:

1. El instalador no muestra una barra de progreso mientras descarga. Espera a que termine aunque parezca parado.
2. Si te equivocas de terminal en Windows, verás uno de estos errores:
   • The token '&&' is not a valid statement separator significa que estás en PowerShell. Usa el comando con irm.
   • 'irm' is not recognized as an internal or external command significa que estás en CMD. Usa el comando con curl.

Windows: ¿nativo o WSL?

Puedes usar Claude Code directamente en Windows o dentro de WSL (el Linux integrado en Windows):

• Windows nativo: no necesitas nada más. Es lo más sencillo si tus proyectos y herramientas están en Windows.
  • Se recomienda instalar Git for Windows, porque así Claude Code puede usar Git Bash para ejecutar comandos.
  • Si no lo tienes instalado, Claude Code usa PowerShell en su lugar.
• WSL 2: es buena opción si trabajas con herramientas de Linux. Además, es la única de las dos que admite sandboxing, la ejecución aislada de comandos.
  • Abre tu distribución de WSL, ejecuta el comando de Linux y lanza claude desde la terminal de WSL, no desde PowerShell.

Paso 3: comprueba que la instalación funciona

Cuando termine el instalador, cierra la terminal y abre una nueva (es importante) y escribe:

claude --version

Si ves un número de versión seguido de (Claude Code), está todo bien.

Para una revisión más completa de la instalación y la configuración, usa:

claude doctor

claude doctor solo lee y diagnostica: no cambia nada ni abre una sesión. Te dice si algo falla y cómo arreglarlo.

Paso 4: inicia sesión y abre tu primer proyecto

Entra en la carpeta del proyecto en el que quieres trabajar y arranca Claude Code:

cd ruta/a/tu/proyecto
claude

La primera vez te pedirá iniciar sesión. Sigue las indicaciones y termina el proceso en el navegador con tu cuenta de Claude o de la Console. Las credenciales se guardan, así que no tendrás que repetirlo.

• Si inicias sesión con una cuenta de la Console, se crea automáticamente un workspace llamado «Claude Code» en la consola. Ahí puedes seguir el gasto.
• Si ya tienes la variable de entorno ANTHROPIC_API_KEY configurada, Claude Code te preguntará si quieres usar esa clave. Si aceptas, se salta el inicio de sesión. Si aún no tienes clave, aquí explicamos cómo obtener tu API key.

Ya dentro, prueba con algo sencillo:

¿qué hace este proyecto?

Claude Code leerá los archivos que necesite y te dará un resumen. Antes de cambiar nada te pedirá permiso.

Los primeros comandos que conviene conocer

El CLAUDE.md es lo que más cambia los resultados: es el «manual de a bordo» de tu proyecto. Te lo explicamos a fondo en qué es Claude Code y cómo usarlo.

Otras formas de instalar Claude Code

Si prefieres un gestor de paquetes, también puedes usarlo. La diferencia principal: estas instalaciones no se actualizan solas por defecto, así que tendrás que actualizarlas tú.

Homebrew (macOS):

brew install --cask claude-code

El cask claude-code sigue el canal estable, que suele ir una semana por detrás. El cask claude-code@latest recibe cada versión nada más salir. Para actualizar: brew upgrade claude-code.

WinGet (Windows):

winget install Anthropic.ClaudeCode

Para actualizar: winget upgrade Anthropic.ClaudeCode.

npm (requiere Node.js 22 o posterior):

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

Anthropic advierte expresamente: no uses sudo npm install -g, porque puede causar problemas de permisos y de seguridad. Para actualizar, usa npm install -g @anthropic-ai/claude-code@latest.

Linux con apt, dnf o apk: Anthropic publica repositorios firmados para Debian/Ubuntu, Fedora/RHEL y Alpine. Los pasos (con la verificación de la clave de firma) están en la documentación de instalación.

Sin terminal: app de escritorio y VS Code

• App de escritorio: descarga la app de Claude para macOS o Windows (Linux está en beta), inicia sesión y abre la pestaña Code. Incluye Claude Code, así que no necesitas instalar ni Node.js ni la versión de terminal. Requiere un plan de pago (Pro, Max, Team o Enterprise).
• Extensión de VS Code: en VS Code, abre la vista de extensiones (Ctrl + Mayús + X en Windows/Linux, Cmd + Mayús + X en Mac), busca «Claude Code» y pulsa Install. Funciona con un plan de pago o con una cuenta de la Console.
  • La extensión trae su propia copia de Claude Code para el panel de chat.
  • Si además quieres usar claude en la terminal integrada del editor, instala también la versión de terminal.

Errores frecuentes al instalar Claude Code (y cómo arreglarlos)

«claude: command not found» o «'claude' no se reconoce como comando»

Es el error más habitual. La instalación ha ido bien, pero la carpeta donde está el programa no está en tu PATH (la lista de carpetas donde tu sistema busca programas).

Primero, cierra la terminal y abre una nueva, porque muchas veces basta con eso. Si sigue fallando, añade la carpeta al PATH:

macOS (Zsh, la terminal por defecto):

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

Linux (Bash):

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

Windows (PowerShell):

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

En Windows, después reinicia la terminal. Si usas la terminal dentro de un editor (como VS Code), cierra y vuelve a abrir el editor, porque la terminal toma el PATH del editor. Luego comprueba con claude --version.

En Windows, los comandos fallan con && o con irm

Estás usando el comando de la otra terminal. Vuelve al Paso 2 y elige el de PowerShell o el de CMD según lo que veas al principio de la línea (PS C:\ o C:\).

Pide «upgrade» o no te deja iniciar sesión

Probablemente estás usando el plan gratuito de claude.ai, que no incluye Claude Code. Necesitas Pro, Max, Team o Enterprise, o una cuenta de la Console con créditos.

Otros errores

Ejecuta claude doctor y sigue sus sugerencias. Anthropic mantiene una página específica de problemas de instalación e inicio de sesión con cada mensaje de error y su solución.

Cómo actualizar y desinstalar Claude Code

• Actualizar: con el instalador nativo no tienes que hacer nada, porque se actualiza solo. Si quieres forzar la actualización ya, usa claude update.
• Desinstalar (instalador nativo, macOS/Linux/WSL):

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

• Desinstalar (instalador nativo, Windows PowerShell):

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Si lo instalaste con Homebrew, WinGet o npm, desinstálalo con ese mismo gestor:

• brew uninstall --cask claude-code
• winget uninstall Anthropic.ClaudeCode
• npm uninstall -g @anthropic-ai/claude-code

La configuración (la carpeta ~/.claude) se queda en tu equipo. Bórrala solo si quieres eliminar también tus ajustes, tus servidores MCP y el historial de sesiones.

Preguntas frecuentes sobre la instalación de Claude Code