Cómo instalar Claude Code en Windows, macOS y Linux paso a paso
Aprende cómo instalar Claude Code utilizando el instalador nativo recomendado por Anthropic, PowerShell, CMD, WinGet, Homebrew, WSL o gestores de paquetes Linux. También veremos cómo comprobar la instalación, iniciar sesión, actualizar Claude Code y solucionar los errores más comunes.
¿Cómo instalar Claude Code?
Anthropic recomienda actualmente la
instalación nativa de Claude Code.
En macOS, Linux y WSL puedes instalarlo con
curl -fsSL https://claude.ai/install.sh | bash.
En Windows PowerShell puedes utilizar
irm https://claude.ai/install.ps1 | iex.
Después ejecuta claude --version
para comprobar la instalación
y finalmente claude
para iniciar sesión y comenzar.
Formas de instalar Claude Code
El método recomendado depende principalmente del sistema operativo y de cómo prefieras administrar las actualizaciones.
Instalador nativo
Método recomendado por Anthropic para Windows, macOS, Linux y WSL.
PowerShell
Instalación directa en Windows mediante el script oficial.
Homebrew
Alternativa cómoda para usuarios de macOS.
WinGet
Instala Claude Code utilizando el gestor de paquetes de Windows.
WSL
Ejecuta Claude Code dentro de un entorno Linux en Windows.
Linux packages
También existen repositorios para apt, dnf y apk.
Instalar Claude Code en tres pasos
Independientemente del sistema, el proceso general es muy sencillo.
Instala Claude Code
Ejecuta el instalador compatible con tu sistema operativo.
Comprueba la instalación
Ejecuta
claude --version
para confirmar
que el comando existe.
Inicia Claude Code
Ejecuta
claude
dentro de un proyecto
y completa la autenticación.
Requisitos de Claude Code
Comprueba primero que tu sistema cumple los requisitos básicos publicados por Anthropic.
| Requisito | Compatible |
|---|---|
| macOS | 13.0 o superior |
| Windows | Windows 10 1809+ o Windows Server 2019+ |
| Ubuntu | 20.04 o superior |
| Debian | 10 o superior |
| Alpine Linux | 3.19 o superior |
| Memoria RAM | 4 GB o más |
| Procesador | x64 o ARM64 |
| Internet | Requerido |
| Shell | Bash, Zsh, PowerShell o CMD |
La instalación nativa de Claude Code no requiere instalar Node.js previamente. Node.js solo resulta relevante si decides utilizar el método alternativo mediante npm.
Cómo instalar Claude Code en Windows
Claude Code puede ejecutarse actualmente de forma nativa en Windows. Ya no es obligatorio utilizar WSL.
Instalador nativo recomendado
irm https://claude.ai/install.ps1 | iexLa instalación nativa puede ejecutarse desde una sesión normal de PowerShell.
Instalar Claude Code desde CMD
Si utilizas el símbolo del sistema en lugar de PowerShell, el comando es diferente.
Instalación desde Command Prompt
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Si tu terminal muestra
algo como
PS C:\Users\Nombre>,
estás utilizando PowerShell.
Si solo aparece
C:\Users\Nombre>,
normalmente estás en CMD.
Instalar Claude Code con WinGet
Windows también permite instalar Claude Code mediante su gestor de paquetes.
Instalación
winget install Anthropic.ClaudeCodePara actualizar una instalación gestionada mediante WinGet, utiliza:
winget upgrade Anthropic.ClaudeCode¿Necesitas Git for Windows?
Ya no es obligatorio para ejecutar Claude Code de forma nativa, pero puede mejorar determinados flujos.
Claude Code sigue funcionando
Claude puede ejecutar comandos mediante la herramienta PowerShell.
Acceso a Git Bash
Git for Windows permite a Claude Code utilizar Git Bash como herramienta Bash.
Puedes especificar
manualmente su ubicación
mediante la variable
CLAUDE_CODE_GIT_BASH_PATH
dentro de la configuración.
Instalar Claude Code en WSL
Windows Subsystem for Linux continúa siendo una excelente opción cuando tu proyecto utiliza herramientas Linux.
Ejecuta el instalador Linux dentro de WSL
curl -fsSL https://claude.ai/install.sh | bash
Si instalaste Claude Code
dentro de WSL,
ejecuta también
el comando
claude
desde la terminal WSL,
no desde PowerShell
ni CMD.
Claude Code nativo vs WSL
Las dos opciones son válidas, pero sirven para entornos diferentes.
| Aspecto | Windows nativo | WSL 2 |
|---|---|---|
| Instalación sencilla | Sí | Requiere WSL |
| Proyectos Windows | Recomendado | Compatible |
| Toolchains Linux | Limitado al entorno Windows | Recomendado |
| Sandboxing | No soportado actualmente | Soportado |
| Git Bash | Opcional | No necesario |
Cómo instalar Claude Code en Mac
En macOS puedes utilizar el instalador nativo recomendado o Homebrew.
Instalador nativo
curl -fsSL https://claude.ai/install.sh | bashInstalar Claude Code con Homebrew
Si ya utilizas Homebrew para administrar tus herramientas, puedes instalar Claude Code como un cask.
Canal estable
brew install --cask claude-codeCanal más reciente
brew install --cask claude-code@latest
El cask
claude-code
sigue el canal estable,
que suele ir aproximadamente
una semana por detrás
y evita versiones
con regresiones importantes.
claude-code@latest
recibe nuevas versiones
tan pronto como se publican.
Las instalaciones Homebrew no utilizan por defecto las actualizaciones automáticas de Claude Code.
brew upgrade claude-codeCómo instalar Claude Code en Linux
El instalador nativo funciona en las principales distribuciones compatibles.
Instalador nativo
curl -fsSL https://claude.ai/install.sh | bashEste método gestiona automáticamente las actualizaciones en segundo plano.
Instalar Claude Code mediante apt
Anthropic publica un repositorio firmado para distribuciones basadas en Debian.
Preparar las dependencias
sudo apt install curl gnupgEl instalador nativo sigue siendo la opción más sencilla. Los repositorios apt, dnf y apk son especialmente útiles cuando quieres administrar Claude Code mediante el gestor de paquetes del sistema.
Instalar Claude Code mediante dnf
También existe un repositorio oficial firmado para sistemas basados en RPM.
Instalación después de configurar el repositorio
sudo dnf install claude-codeInstalar Claude Code en Alpine Linux
Alpine utiliza un entorno musl y puede necesitar dependencias adicionales.
Paquetes necesarios
apk add bash curl libgcc libstdc++ ripgrepEn sistemas musl, Anthropic recomienda disponer de Bash, curl, libgcc, libstdc++ y ripgrep.
Instalar Claude Code con npm
npm continúa siendo una opción compatible, aunque Anthropic recomienda actualmente la instalación nativa.
Instalación global
npm install -g @anthropic-ai/claude-code
Anthropic desaconseja
ejecutar
sudo npm install -g
porque puede provocar
problemas de permisos
y riesgos innecesarios.
Las versiones actuales del paquete npm requieren Node.js 22 o superior para una instalación soportada correctamente.
Comprobar que Claude Code quedó instalado
Antes de iniciar tu primera sesión, verifica que el comando está disponible.
Comprobar versión
claude --versionClaude Code está instalado y el ejecutable puede encontrarse desde tu terminal.
Comprobar Claude Code con claude doctor
Si quieres revisar con más detalle la instalación, utiliza el diagnóstico incorporado.
Diagnóstico desde terminal
claude doctor
claude doctor
realiza diagnósticos
de solo lectura
sobre la instalación,
archivos de configuración
y posibles advertencias,
mostrando soluciones
cuando corresponde.
Iniciar sesión en Claude Code
Una vez instalado, inicia Claude Code desde la terminal.
Iniciar Claude
claudeSi todavía no has iniciado sesión, Claude Code te guiará mediante el navegador para autenticar tu cuenta.
Qué cuenta necesitas para usar Claude Code
Instalar el programa no significa automáticamente disponer de acceso al servicio.
Planes compatibles
La documentación actual contempla acceso mediante Claude Pro, Max, Team, Enterprise o una cuenta de Anthropic Console.
El plan Free de Claude.ai no incluye actualmente acceso a Claude Code.
Abrir Claude Code dentro de un proyecto
Una vez autenticado, navega hasta el directorio que quieres analizar.
Abrir un proyecto
cd mi-proyecto
claudeClaude Code utiliza el directorio actual como contexto principal para trabajar con tu proyecto.
Comprueba que Claude puede leer el proyecto
Primer análisis
Analiza este proyecto.
Explícame:
- qué tecnologías utiliza
- cuáles son los archivos principales
- cómo está organizado
- cómo se ejecuta
No realices cambios todavía.Cómo actualizar Claude Code
El mecanismo depende del método utilizado durante la instalación.
| Método | Actualización |
|---|---|
| Instalador nativo | Actualizaciones automáticas en segundo plano |
| Manual nativo | claude update |
| Homebrew Stable | brew upgrade claude-code |
| Homebrew Latest | brew upgrade claude-code@latest |
| WinGet | winget upgrade Anthropic.ClaudeCode |
| npm | npm install -g @anthropic-ai/claude-code@latest |
Canal Stable vs Latest
Claude Code permite elegir entre recibir las novedades inmediatamente o utilizar un canal algo más conservador.
Novedades primero
Recibe nuevas funciones tan pronto como son publicadas.
Mayor estabilidad
Normalmente sigue una versión aproximadamente una semana más antigua y evita releases con regresiones importantes.
Forzar una actualización manual
Actualizar ahora
claude updateErrores comunes al instalar Claude Code
claude: command not found: la instalación no terminó correctamente o el ejecutable no está disponible mediante PATH.
irm is not recognized: probablemente ejecutaste un comando de PowerShell dentro de CMD.
&& no es un separador válido: probablemente utilizaste el comando de CMD dentro de PowerShell.
Error 403 o curl: revisa conexión, proxy, firewall y acceso al dominio de instalación.
Error de autenticación: verifica que tu cuenta tenga acceso a Claude Code.
Cómo saber si estás usando PowerShell o CMD
Uno de los errores más frecuentes consiste en ejecutar el comando correcto en la consola equivocada.
| Terminal | Ejemplo del prompt |
|---|---|
| PowerShell | PS C:\Users\Daniel> |
| CMD | C:\Users\Daniel> |
Dónde guardar proyectos si utilizas WSL
El lugar donde almacenas los archivos puede afectar al rendimiento de búsquedas y lectura.
Usa el sistema de archivos Linux cuando sea posible
Si trabajas desde WSL,
suele ser preferible
guardar los proyectos
bajo una ruta como
/home/usuario/
en lugar de trabajar
constantemente sobre
/mnt/c/.
El acceso cruzado entre los sistemas de archivos de Windows y Linux puede introducir penalizaciones de lectura que afecten a búsquedas grandes.
Cómo saber si Claude Code está listo para usar
claude --version
devuelve una versión.
claude doctor
no muestra errores
críticos de instalación.
El comando
claude
inicia correctamente.
Puedes completar la autenticación con tu cuenta.
Claude puede analizar un proyecto desde la carpeta donde lo ejecutaste.
Qué hacer después de instalar Claude Code
Una instalación correcta es solo el comienzo. El siguiente paso es aprender a utilizar el agente correctamente.
Abre un proyecto
Navega hasta el directorio que quieres analizar.
Ejecuta claude
Inicia una sesión desde la raíz del proyecto.
Analiza antes de modificar
Pide primero una explicación de la arquitectura y los archivos principales.
Crea CLAUDE.md
Añade las reglas y convenciones que Claude debe conocer sobre el proyecto.
Documentación oficial de instalación
Los métodos y requisitos pueden evolucionar. Comprueba la documentación oficial cuando instales Claude Code en producción o entornos corporativos.
Advanced Setup
Requisitos, instalación, Windows, Linux, actualizaciones y versiones.
Ver documentación oficial →Troubleshooting
Diagnóstico, problemas de búsqueda, rendimiento y errores frecuentes.
Ver solución de problemas →Guías relacionadas con Claude Code
Continúa con el uso diario, Windows, VS Code, configuración y funciones avanzadas.
FAQ sobre cómo instalar Claude Code
Respuestas sobre Windows, macOS, Linux, WSL, npm, actualizaciones y errores de instalación.
Anthropic recomienda actualmente utilizar el instalador nativo de Claude Code. Está disponible para Windows, macOS, Linux y WSL.
Sí. Claude Code puede ejecutarse actualmente de forma nativa en Windows 10 1809 o versiones posteriores, sin necesidad obligatoria de utilizar WSL.
No. WSL es opcional. Resulta especialmente útil para proyectos con herramientas Linux o cuando necesitas sandboxing de comandos.
No para la instalación nativa recomendada. Node.js es necesario si decides instalar Claude Code mediante el paquete npm.
Ejecuta
claude --version.
Si la instalación funciona,
la terminal mostrará
la versión instalada
de Claude Code.
claude doctor
realiza diagnósticos
sobre la instalación
y configuración
sin iniciar
una sesión interactiva.
Sí.
Puedes instalar
el canal estable
con
brew install --cask claude-code
o el canal más reciente
con
brew install --cask claude-code@latest.
Sí.
En Windows puedes utilizar
winget install Anthropic.ClaudeCode.
Las instalaciones nativas comprueban y descargan actualizaciones automáticamente. Homebrew, WinGet y gestores de paquetes Linux requieren actualización manual por defecto.
Comprueba primero
la instalación
con claude doctor
y revisa que
el ejecutable
se encuentre disponible
en el PATH
de tu terminal.
Aprende a usar Claude Code
Claude Code ya está instalado. El siguiente paso es aprender a trabajar correctamente con proyectos, prompts, archivos, permisos, comandos, Git y tareas completas de programación.
Cómo usar Claude Code →