Instalar Claude Code son dos minutos si sabes tres cosas antes: con qué cuenta entra, en qué ventana se pega el comando y qué vas a ver cuando arranque. Si no las sabes, es una tarde de buscar errores en inglés. Aquí van esas tres cosas, el comando exacto de cada sistema comprobado hoy en la documentación, cómo saber si ha ido bien, la alternativa sin terminal y los cinco fallos que se repiten.
Antes de instalar Claude Code: lo que te van a pedir
| Qué | Dónde | Por qué |
|---|---|---|
| Una cuenta de Claude de pago | Pro, Max, Team o Enterprise; o una cuenta de API que se paga por consumo | El plan gratuito no incluye Claude Code. Cuál te conviene, en qué plan de Claude necesitas |
| La ventana negra correcta | Mac: Terminal. Windows: PowerShell (Win + X y elegirla). Linux: la tuya | En Windows hay dos que se parecen, PowerShell y CMD, con comandos distintos. Si el prompt empieza por PS C:\, es PowerShell |
| Una carpeta de prueba con copias | Por ejemplo, Documentos\prueba-claude con tres o cuatro archivos duplicados | Claude Code modifica archivos. La primera semana, nunca sobre la única versión de nada |
Nada más. Ni Node.js, ni permisos de administrador, ni Linux dentro de Windows. ¿Por qué tan poco? Porque el instalador que Anthropic recomienda en la documentación de instalación descarga un programa propio y se actualiza solo.
Lo que sí pide es un Mac con macOS 13 o posterior, un Windows 10 de la versión 1809 en adelante o Ubuntu 20.04, y 4 GB de memoria. Si no sabes si te hace falta, antes: qué es Claude Code.
Instalar Claude Code: el comando de cada sistema
Mac y Linux. Abre la terminal (la ventana donde se escriben órdenes en vez de hacer clic), pega esta línea y pulsa Intro. Verás texto pasando y, al final, «Claude Code successfully installed!»:
curl -fsSL https://claude.ai/install.sh | bash
Windows, en PowerShell. La misma idea con otra línea. No hace falta abrirla como administrador:
irm https://claude.ai/install.ps1 | iex
Windows, si estás en CMD (el prompt sin el «PS» delante). Es la misma instalación desde la otra ventana:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Hay dos alternativas para quien ya usa un gestor de programas: brew install --cask claude-code en Mac y winget install Anthropic.ClaudeCode en Windows. Dan lo mismo, con una diferencia: esas dos no se actualizan solas.
Y la vía antigua, npm install -g @anthropic-ai/claude-code, solo tiene sentido si ya tienes Node.js 22 instalado por otro motivo; instalarlo para esto es dar un rodeo.
Al terminar, cierra la ventana y abre otra. Después, la comprobación que confirma que todo ha ido bien:
claude --version
Tiene que devolver un número seguido de «(Claude Code)», algo como 2.1.211 (Claude Code). Si en vez de eso dice que no reconoce el comando, es el primero de los fallos de más abajo, y tiene arreglo en un minuto.
El primer arranque, paso a paso
Entra en la carpeta de prueba desde la terminal y arráncalo. En Windows la ruta lleva barras invertidas; en Mac, normales:
cd Documentos\prueba-claude claude
La primera vez te pide iniciar sesión: se abre el navegador, entras con tu cuenta de Claude y vuelves a la terminal. Se hace una vez.
Después aparece el cursor esperando, con la versión y la carpeta encima. Ya puedes hablarle en castellano, como en el chat. Un buen primer encargo es uno que no toque nada:
Explícame qué hay en esta carpeta, para qué parece servir cada archivo y qué me propondrías ordenar. No cambies nada todavía.
«No cambies nada todavía» importa más de lo que parece. ¿Por qué? En los planes Pro, Max y Team, la sesión arranca en modo auto: un segundo modelo revisa las acciones en lugar de ti y Claude edita la mayoría de archivos sin preguntar.
Para empezar, mejor que pregunte. Mira la barra de estado; si pone «auto mode on», pulsa Shift+Tab hasta ver «manual mode on». En manual te enseña cada cambio y espera tu sí.
Para salir, /exit. Para ver los comandos, /help. El resto de la primera hora está en el tutorial de Claude Code.
Si no quieres ver una terminal: la app de escritorio
La documentación lo dice al principio y casi nadie lo cuenta: la app de escritorio de Claude trae Claude Code dentro. Se descarga desde claude.com/download, entras con tu cuenta y pulsas la pestaña Code. Ahí eliges «Local», seleccionas la carpeta con un clic y escribes lo mismo que escribirías en la terminal.
Ventajas para quien no programa: los cambios se ven en pantalla con lo que quita y lo que pone, y el modo de permisos es un desplegable al lado del botón de enviar, con «Manual» a la vista.
No hace falta instalar el comando claude por separado. Cómo se instala la app y qué cambia respecto al navegador, en Claude en el escritorio.
Y si ni siquiera quieres pestaña Code, la misma app tiene Claude Cowork: la carpeta se elige con botones y se le pide en un chat normal. Para una oficina es, muchas veces, la puerta correcta.
¿Te avisamos del próximo artículo?
Publicamos uno nuevo cada día, de lunes a sábado. Te mandamos el título, dos líneas y el enlace: en cuanto sale o en un resumen los lunes. Te das de baja con un clic.
Los cinco fallos que se repiten (y el que ya no es lo que era)
- «claude» no se reconoce como comando. Casi siempre es que no has cerrado y abierto la terminal después de instalar. Si sigue igual, el instalador no pudo añadir su carpeta a la ruta de programas; los comandos para añadirla a mano, por sistema, están en la guía de errores de instalación.
- «irm no se reconoce» o «el token && no es válido». Has pegado el comando de PowerShell en CMD, o al revés. Mira si el prompt empieza por «PS» y usa la línea de esa ventana.
- Error 403 o «syntax error near unexpected token ‘<‘». La descarga ha devuelto una página web en vez del instalador: un proxy de empresa que filtra, o un país donde Claude Code no está disponible. Prueba desde otra red; si es el proxy, quien administra la red sabe qué poner. Homebrew y WinGet son la alternativa.
- Error de SSL o TLS en un Windows 10 antiguo. Antes del instalador, esta línea en PowerShell:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12. Después, el comando normal. - Se queda colgado al iniciar sesión. Proxy o antivirus corporativo. El móvil como punto de acceso lo confirma en un minuto. En un ordenador de empresa, avisa antes a quien lo administra.
El que ya no es lo que era: «la ejecución de scripts está deshabilitada en este sistema». Muchas guías (y nuestra versión anterior de este artículo, todo sea dicho) lo arreglaban cambiando la política de PowerShell.
La documentación es clara: esa política bloquea los lanzadores de npm, no el instalador de arriba, que ejecuta texto y no un archivo. Si te sale, instalaste con npm.
Los fallos propios de Windows, con el antivirus y OneDrive incluidos, están en Claude Code en Windows.
Actualizar y desinstalar
La instalación nativa se actualiza sola en segundo plano, y claude update lo fuerza en el momento. Con Homebrew es brew upgrade claude-code; con WinGet, winget upgrade Anthropic.ClaudeCode.
Para desinstalar, en Mac y Linux se borran ~/.local/bin/claude y la carpeta ~/.local/share/claude; en Windows, los mismos dos dentro de tu carpeta de usuario. Si algo no cuadra, claude doctor revisa la instalación y dice qué arreglar.
La documentación dice «en dos minutos», y lo es. Con una condición que no viene en la documentación: saber cuál de las dos ventanas negras de Windows tienes abierta.
Después de instalar
Lo primero, ese encargo que no toca nada. Lo segundo, un archivo de cinco líneas en la carpeta con cómo se trabaja ahí, el CLAUDE.md (la nota que le dejarías a quien te sustituye un día).
Lo que marca la diferencia después no es la instalación sino cómo se le pide: un encargo con contexto, criterio y formato devuelve un cambio limpio; uno de cuatro palabras, una sorpresa. Es lo que se practica en Creación de prompts de Claude.
Si vais a instalarlo en varios ordenadores de la empresa, con el proxy y el antivirus de por medio, contadnos cuántos sois en la página de empresas.
Preguntas frecuentes
¿Necesito Node.js para instalar Claude Code?
No. El instalador nativo de Anthropic descarga un programa propio y no depende de Node.js. Solo hace falta Node.js (versión 22 o posterior) si eliges instalarlo con npm, que es la vía antigua y no la recomendada.
¿Claude Code funciona en Windows sin WSL?
Sí. Desde Windows 10 (versión 1809) o Windows Server 2019 se instala de forma nativa desde PowerShell o CMD, sin el subsistema de Linux. Git para Windows es opcional: si está, Claude Code usa su Bash; si no, usa PowerShell.
¿Cómo sé si Claude Code está bien instalado?
Abre una terminal nueva y escribe claude –version. Si devuelve un número de versión seguido de «(Claude Code)», está instalado. Si dice que no reconoce el comando, falta añadir su carpeta a la ruta de programas; claude doctor revisa la instalación y sugiere el arreglo.
¿Cómo se actualiza Claude Code?
La instalación nativa se actualiza sola en segundo plano; claude update la fuerza en el momento. Las instalaciones con Homebrew y WinGet no se actualizan solas: brew upgrade claude-code y winget upgrade Anthropic.ClaudeCode respectivamente.
¿Se puede usar Claude Code sin terminal?
Sí. La app de escritorio de Claude incluye Claude Code en la pestaña Code: se elige la carpeta con un clic y los cambios se ven en pantalla, sin instalar el comando por separado. Y Claude Cowork, en la misma app, hace tareas con carpetas desde un chat con botones.