Instalar Claude Code: guía paso a paso para Windows, Mac y Linux

En Windows basta un comando en PowerShell: irm https://claude.ai/install.ps1 | iex. Antes necesitas un plan de pago de Claude.

Antes de empezar

Lo que necesitas para que la instalación funcione.

  • Un plan de pago. Pro, Max, Team o Enterprise, o una cuenta de la Consola de Anthropic. El plan gratuito no incluye Claude Code. Precios en Claude Code precio.
  • Sistema operativo. Windows 10 versión 1809 o posterior, macOS 13 o posterior, Ubuntu 20.04 o posterior, Debian 10 o posterior, Alpine Linux 3.19 o posterior.
  • Equipo. 4 GB de memoria o más y procesador x64 o ARM64.
  • Internet y estar en un país donde Anthropic ofrece el servicio.

Fuente: documentación de Claude Code, instalación, consultada el 16 de octubre de 2026.

Instalar Claude Code en Windows

Es el método recomendado por Anthropic, el instalador nativo.

  1. Comprueba tu plan

    Con el plan gratuito de Claude no podrás usar Claude Code. Mira antes la tabla de precios de Claude.

  2. Abre PowerShell

    Pulsa la tecla de Windows, escribe «PowerShell» y ábrelo. No hace falta «ejecutar como administrador». La línea de comandos debe empezar por PS C:\. Si empieza por C:\ sin «PS», estás en el símbolo del sistema (CMD) y el comando de abajo no funcionará.

  3. Pega el comando

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

    Este comando descarga un programa de internet y lo ejecuta. Lo publica Anthropic en su documentación; copia siempre la línea desde su página oficial de instalación si dudas.

  4. Comprueba que funciona

    Abre una ventana nueva de PowerShell y escribe:

    claude --version

    Debe salir un número de versión. Si algo falla, claude doctor ejecuta un diagnóstico.

  5. Inicia sesión

    Entra en la carpeta donde vas a trabajar, escribe claude y sigue el inicio de sesión con tu cuenta de Claude.

Otras formas en Windows

  • Símbolo del sistema (CMD): curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  • WinGet: winget install Anthropic.ClaudeCode. No se actualiza solo.
  • Git para Windows: es opcional. Si lo tienes, Claude Code usa Git Bash. Si no, usa PowerShell.
  • WSL 2 (Linux dentro de Windows): admite ejecutar Claude Code en un espacio aislado del resto del ordenador; el Windows nativo no.

Instalar Claude Code en Mac y Linux

Abre el Terminal y pega:

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

Sirve también para WSL. En Mac puedes usar Homebrew con brew install --cask claude-code, que no se actualiza solo. Con npm, el paquete es npm install -g @anthropic-ai/claude-code y pide Node.js 22 o posterior; no lo ejecutes con sudo. Después, igual que en Windows: claude --version para comprobar y claude para empezar.

Las instalaciones nativas se actualizan en segundo plano.

Sin terminal: la aplicación de escritorio

La aplicación de escritorio de Claude tiene tres pestañas: Chat, Cowork y Code. La pestaña Code incluye Claude Code, así que no instalas Node.js ni la línea de comandos. Existe para macOS, Windows (x64 y ARM64) y, en beta, Linux (paquete .deb para Ubuntu y Debian). Requiere Pro, Max, Team o Enterprise.

Fuente: documentación de Claude Code, inicio rápido de escritorio, consultada el 16 de octubre de 2026.

Errores frecuentes y qué hacer

Solo los que Anthropic documenta, con el texto del error.

'irm' is not recognized

Estás en CMD y no en PowerShell. Abre PowerShell desde el menú Inicio y repite el comando, o usa el instalador de CMD de arriba.

claude no se reconoce tras instalar

La carpeta de instalación, %USERPROFILE%\.local\bin, no está en el PATH (la lista de carpetas donde Windows busca programas). El propio instalador te avisa con «Native installation exists but … is not in your PATH». Para corregirlo, en PowerShell:

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

Cierra el terminal, abre uno nuevo y repite claude --version.

Claude Code on Windows requires either Git for Windows (for bash) or PowerShell

Falta un programa donde escribir órdenes al ordenador (en inglés, shell). Instala Git para Windows o usa PowerShell.

App unavailable in region

Claude Code no está disponible en tu país.

Fuente: documentación de Claude Code, solución de problemas de instalación, consultada el 16 de octubre de 2026. Hay más errores en esa página.

Preguntas frecuentes sobre instalar Claude Code

¿Puedo instalar Claude Code con el plan gratuito?

No. El plan gratuito de claude.ai no incluye Claude Code. Necesitas Pro, Max, Team o Enterprise, o una cuenta de la Consola de Anthropic.

¿Hace falta ser administrador en Windows?

No. La documentación de Claude Code dice que no necesitas ejecutar el instalador como administrador.

¿Necesito instalar Git en Windows?

No es obligatorio. Con Git para Windows, Claude Code usa Git Bash (un programa donde se escriben órdenes al ordenador); sin él usa PowerShell.

¿Se actualiza solo?

Las instalaciones nativas se actualizan en segundo plano. Las de Homebrew y WinGet no se actualizan solas por defecto.

¿Hay una versión sin terminal?

Sí. La aplicación de escritorio de Claude incluye una pestaña Code y no necesitas instalar Node.js ni la línea de comandos. También exige un plan de pago.

Siguiente paso

¿Prefieres que te lo dejemos funcionando?

En el curso lo instalamos juntos y lo probamos con tareas de tu oficina. Fechas por confirmar.