Cómo instalar Claude Code en Mac y Windows (2026)

Para instalar Claude Code, abre Terminal en Mac o PowerShell en Windows, pega el instalador de una línea de Anthropic, escribe claude e inicia sesión en el navegador con una cuenta de Claude de pago. Tardas unos minutos y no necesitas saber programar. Si prefieres no tocar nunca una terminal, instala la app de escritorio de Claude: Claude Code viene integrado en su pestaña Code.

Este paso a paso sigue la documentación oficial de instalación de Anthropic tal como estaba en octubre de 2026. Si todavía estás decidiendo si necesitas Claude Code, empieza por qué es Claude Code.

Antes de empezar

Repasa primero esta lista. La mayoría de las instalaciones fallidas vienen de uno de estos cinco puntos:

Después elige tu método:

Opción 1: la app de escritorio, sin terminal

1. Descarga la app. Consíguela en la página de inicio rápido de la app de escritorio de Anthropic. La versión para Mac funciona en Intel y en Apple silicon, Windows tiene versiones x64 y ARM64, y hay una beta para Ubuntu y Debian que se instala con apt.
2. Instálala e inicia sesión. Abre Claude y entra con la cuenta que tiene tu plan de pago.
3. Abre la pestaña Code. Si te pide que mejores tu plan, la cuenta que usaste está en el plan gratis.
4. Elige una carpeta. Elige Local, haz clic en Select folder (elegir carpeta) y selecciona una carpeta vacía que hayas creado para hacer pruebas.
5. Pide algo. Escribe una petición en el cuadro de texto y presiona Enter.

La app mantiene al día su propia copia de Claude Code desde Claude > Check for Updates en Mac o Help > Check for Updates en Windows. Si lees hebreo, ai school también ofrece un instalador gratuito de un solo clic para Mac y Windows que configura la app de escritorio por ti.

Opción 2: instala Claude Code en Mac

Paso 1: abre Terminal

Presiona Cmd + Espacio, escribe Terminal y presiona Enter. Aparece una ventana con un cursor parpadeante: ahí es donde se escriben los comandos.

Paso 2: ejecuta el instalador oficial

Copia esta línea, pégala con Cmd + V y presiona Enter:

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

Descarga y ejecuta el instalador de Anthropic desde claude.ai. Durante un rato parece que no pasa nada, porque no muestra el progreso, así que no toques la ventana hasta que veas Claude Code successfully installed!

Paso 3: comprueba que funcionó

Cierra la ventana, abre una ventana nueva de Terminal para que reconozca el programa nuevo y ejecuta:

$ claude --version
$ 

Si ves un número de versión seguido de (Claude Code), ya está. Si en cambio ves command not found: claude, salta a la tabla de solución de problemas de más abajo.

Opción 3: instala Claude Code en Windows

Paso 1 (opcional): instala Git for Windows

Git for Windows le da a Claude Code un intérprete de comandos Bash en el que ejecutar comandos. Sin él, Claude Code usa PowerShell, y eso está bien para la mayoría de los principiantes. Si lo instalas, haz clic en Next en todas las pantallas: las opciones por defecto, incluida la opción de PATH recomendada, son justo lo que necesitas.

Paso 2: abre PowerShell

Presiona Win + X y elige Windows PowerShell o Terminal. Comprueba que cada línea empiece por PS C:\; si empieza por C:\ sin el PS, estás en el Símbolo del sistema (Command Prompt), que necesita otro comando.

Paso 3: ejecuta el instalador oficial

Pega esto con Ctrl + V o con clic derecho y presiona Enter:

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

irm descarga el instalador e iex lo ejecuta. No necesitas abrir PowerShell como administrador, y habrás terminado cuando veas Claude Code successfully installed!

Si estás en el Símbolo del sistema, usa esta versión:

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

Paso 4: comprueba que funcionó

Abre una ventana nueva de PowerShell y ejecuta claude --version. Si ves un número de versión, ya está.

Inicia sesión por primera vez

Crea una carpeta de prueba e inicia Claude Code dentro de ella. Que sea una carpeta dedicada importa, porque Claude Code puede leer todo lo que hay en la carpeta donde lo inicias.

En Mac:

$ mkdir -p ~/claude-projects/first-test
$ cd ~/claude-projects/first-test
$ claude
$ 

En Windows, en PowerShell:

PS> mkdir -Force "$HOME\claude-projects\first-test"
PS> cd "$HOME\claude-projects\first-test"
PS> claude
PS> 

Esto es lo que pasa a continuación:

1. Configuración y navegador. Claude Code hace una breve configuración inicial y abre tu navegador para que inicies sesión.
2. Inicia sesión. Usa la cuenta que tiene tu plan de pago. Si el navegador no se abre, presiona c para copiar el enlace de inicio de sesión y pégalo tú en el navegador.
3. Confirma. Cuando la terminal muestre Login successful, presiona Enter.
4. Confía en la carpeta. Claude Code te pregunta si confías en esta carpeta; la acabas de crear, así que acepta.
5. Empieza a trabajar. Aparece el campo de texto de Claude Code, con la versión, el modelo y la carpeta encima. Escribe /help para ver los comandos.

Haz una primera tarea segura

Empieza con una pregunta que no cambia nada:

¿Qué archivos hay en esta carpeta y con qué tipo de tareas podrías ayudarme aquí? No crees ni cambies nada todavía.

Después, un cambio pequeño que puedas ver:

Crea un archivo llamado hola.html: una página sencilla con un título que diga "Mi primera página con Claude Code" y un párrafo corto que explique lo que acabas de hacer. Luego dime cómo abrirla.

Las versiones actuales inician las sesiones de terminal en modo auto, en el que una revisión de seguridad en segundo plano evalúa cada acción en lugar de preguntarte. Mientras aprendes, presiona Shift+Tab hasta que la línea bajo el campo de texto diga manual mode on, para que Claude Code te pregunte antes de cada archivo que cree y de cada comando que ejecute.

Lee cada solicitud y elige Yes si coincide con lo que pediste. Cuando termine, haz doble clic en hola.html desde Finder o el Explorador de archivos para abrirlo en tu navegador.

Mantén Claude Code actualizado

• Las instalaciones nativas se actualizan solas en segundo plano, y la versión nueva se aplica la próxima vez que inicias Claude Code.
• claude update instala la versión más reciente en el momento.
• claude doctor hace una revisión de solo lectura de tu instalación y tu configuración, sin iniciar una sesión.
• Las instalaciones con Homebrew y WinGet no se actualizan solas. Usa los comandos de actualización de la tabla de métodos.

Solución de problemas: los errores que de verdad aparecen

Busca el mensaje que ves y aplica su solución. Salen de la página de solución de problemas de instalación de Anthropic, que también recoge casos menos frecuentes.

Para arreglar el PATH en Mac, que usa la shell Zsh por defecto, ejecuta estas dos líneas y luego abre una ventana nueva:

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

Para arreglar el PATH en Windows, ejecuta estas dos líneas en PowerShell y luego cierra y vuelve a abrir PowerShell:

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

Si claude --version funciona pero otra cosa falla, ejecuta claude doctor y lee sus avisos, porque cada uno trae una solución sugerida.

Qué hacer ahora

Dedica tu primera hora a tareas pequeñas y seguras, para aprender los controles antes de poner a Claude Code a trabajar en algo importante. El tutorial para principiantes te guía por un primer proyecto completo, y la guía del archivo CLAUDE.md te enseña a guardar tus preferencias para no repetirlas. Ten la guía rápida de Claude Code abierta en una pestaña para consultar comandos y atajos, y si quieres todo el camino en un solo lugar, el curso de Claude Code empieza con la instalación y termina con proyectos que puedes usar en tu negocio.