Instalar Claude Code paso a paso

En la guía anterior vimos las distintas formas de usar Claude. Aquí instalamos Claude Code en la terminal, la opción que usaremos en el resto de la serie. Te llevará unos minutos.

Antes de empezar

Comprueba que tienes:

Un sistema compatible: macOS 13 o superior, Windows 10 (versión 1809) o superior, o una distribución Linux reciente como Ubuntu 20.04+ o Debian 10+.
Al menos 4 GB de RAM y conexión a internet.
Una cuenta que incluya Claude Code: un plan Pro o superior, o una cuenta de Anthropic Console con pago por uso. El plan gratuito no lo incluye.

Si prefieres no usar la terminal, la app de escritorio trae Claude Code integrado en su pestaña Code. Esta guía se centra en la terminal porque es la base del resto de la serie.

Paso 1: abre una terminal

Windows: busca PowerShell en el menú Inicio. Sabrás que estás en PowerShell porque la línea empieza por PS C:\. Si empieza solo por C:\, estás en CMD (el símbolo del sistema clásico).
macOS: abre Terminal desde Spotlight (Cmd + Espacio y escribe "Terminal").
Linux: abre la terminal de tu distribución (en muchas, Ctrl + Alt + T).

Paso 2: instala Claude Code

La forma recomendada es el instalador oficial, porque se actualiza solo. Copia el comando de tu sistema y pégalo en la terminal:

macOS, Linux o 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

El instalador no muestra una barra de progreso: es normal que parezca quieto mientras descarga. Espera a que vuelva a aparecer la línea para escribir.

Alternativas con gestores de paquetes

Si ya usas un gestor de paquetes, también puedes instalarlo así:

brew install --cask claude-code

winget install Anthropic.ClaudeCode

Ten en cuenta que estas instalaciones no se actualizan solas: tendrás que actualizarlas tú de vez en cuando con el mismo gestor.

Si usas Windows

No necesitas permisos de administrador para instalarlo.
Es recomendable instalar Git for Windows: así Claude Code puede usar Git Bash para ejecutar comandos. Sin él, usará PowerShell, que también funciona.
Si trabajas con herramientas de Linux, puedes instalarlo dentro de WSL con el comando de Linux. En ese caso, ábrelo siempre desde la terminal de WSL.

Paso 3: comprueba que funciona

Cierra la terminal y abre una nueva (para que reconozca el comando recién instalado). Luego escribe:

claude --version

Si ves un número de versión seguido de (Claude Code), está todo listo. Para un diagnóstico más completo:

claude doctor

Paso 4: inicia tu primera sesión

Entra en la carpeta de cualquier proyecto (aquí usamos uno de ejemplo llamado mi-proyecto) y lanza Claude Code:

cd mi-proyecto
claude

La primera vez te pedirá iniciar sesión: se abrirá tu navegador para que entres con tu cuenta de Claude o de Anthropic Console. Al terminar, vuelve a la terminal. Tus credenciales quedan guardadas, así que no tendrás que repetirlo.

Paso 5: tus primeros comandos

Ya dentro de Claude Code, prueba a escribirle en lenguaje natural:

¿qué hace este proyecto?

Claude leerá los archivos que necesite y te dará un resumen. No hace falta que le pases el contexto a mano.

Algunos atajos útiles para empezar:

Comando o atajo	Para qué sirve
`/help`	Ver los comandos disponibles
`/login`	Cambiar de cuenta o volver a iniciar sesión
`/clear`	Empezar una conversación nueva
`Shift + Tab`	Cambiar cuánto puede hacer Claude sin pedirte permiso
`/exit` o `Ctrl + D` dos veces	Salir de Claude Code

Por defecto, Claude te pedirá permiso antes de editar archivos o ejecutar comandos. Lee lo que propone y acepta solo lo que tenga sentido.

Mantenerlo al día

Si lo instalaste con el instalador oficial, se actualiza solo en segundo plano. Si quieres forzar la actualización:

claude update

Problemas frecuentes

Si ves…	Prueba esto
`claude` no se reconoce como comando	Cierra y abre una terminal nueva. Si sigue igual, la carpeta de instalación no está en tu PATH: ejecuta `claude doctor` o revisa la guía oficial de solución de problemas.
`The token '&&' is not a valid statement separator`	Estás en PowerShell usando el comando de CMD. Usa el comando de PowerShell.
`'irm' is not recognized…`	Estás en CMD usando el comando de PowerShell. Usa el comando de CMD.
Te pide un plan al iniciar sesión	Tu cuenta es del plan gratuito. Claude Code necesita Pro o superior, o una cuenta de Console.

Siguiente paso

Ya tienes Claude Code instalado y funcionando. En la próxima guía haremos tu primera tarea real con él: pedirle un cambio en un proyecto de ejemplo, revisarlo y aceptarlo.

Los comandos de esta guía siguen la documentación oficial a la fecha de actualización. Si algo cambia, la documentación de Claude Code siempre tiene la versión más reciente.