Instalar Claude Code: tutorial paso a paso en Mac, Windows y Linux

Formo con regularidad a perfiles de marketing en Claude Code. La dificultad nunca es el agente en sí: es la instalación, y la pantalla negra del terminal. Esta guía para instalar Claude Code sigue el orden real de los pasos, con los comandos tal como los da la documentación de Anthropic a 7 de octubre de 2026. Copia el de tu sistema o genera tu chuleta completa con la herramienta de más abajo.

¿Qué es Claude Code?

Claude Code es el agente de programación de Anthropic: lee los archivos de un proyecto, los modifica, ejecuta comandos y comprueba su propio trabajo. A diferencia de un chatbot que te propone código para copiar, actúa directamente en tu carpeta, con tu permiso según el modo de permisos que elijas.

Existe en varias formas, que comparten el mismo motor:

• Claude Code CLI: la herramienta de línea de comandos, que se lanza con claude en un terminal. Es la que esta guía instala primero.
• La extensión de VS Code y el plugin de JetBrains: Claude Code en tu editor, con los cambios mostrados como diff.
• Claude Code desktop: la pestaña Code de la aplicación de escritorio de Claude, sin terminal.
• Claude Code en la web: sesiones que se ejecutan en la nube, desde claude.ai/code.

Lo uso a diario, y no solo para programar: ordenar exportaciones, comprobar redirecciones, generar informes. Si descubres ahora esta forma de trabajar, mi artículo sobre el vibe coding muestra sus posibilidades y sus límites.

Requisitos para instalar Claude Code

La instalación en sí no cuesta nada. Lo que se paga es el uso: incluido en la suscripción, o facturado por token con una cuenta Console. El detalle de los planes, y la cuestión de si Claude Code es gratis, tienen su propio artículo.

Instalar Claude Code: los comandos para cada sistema

Anthropic recomienda el instalador nativo: un programa autónomo, sin Node.js, que se actualiza solo en segundo plano. Los gestores de paquetes (Homebrew, WinGet, apt, dnf) son alternativas limpias, pero sus actualizaciones se hacen a mano.

¿No tienes claro qué comando usar? Elige tu sistema y tu método: la herramienta reúne los comandos de instalación, comprobación, actualización y desinstalación, para copiarlos o descargarlos.

Instalar Claude Code en Mac (macOS)

Abre la aplicación Terminal (Cmd + Espacio, escribe «Terminal») y pega:

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

El programa se instala en tu carpeta personal, sin permisos de administrador, tanto en los Mac Intel como en los de chip Apple. Después cierra la ventana, abre una nueva y comprueba con claude --version.

Si gestionas tus programas con Homebrew:

brew install --cask claude-code

Este cask sigue el canal stable, normalmente una semana por detrás de la última versión y sin las versiones que han dado problemas. Para recibir cada versión nueva en cuanto sale, instala claude-code@latest. En ambos casos, Homebrew no actualiza Claude Code por sí solo: acuérdate de brew upgrade.

Instalar Claude Code en Linux

El mismo comando que en Mac, en tu terminal:

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

Si prefieres que las actualizaciones pasen por el gestor de paquetes del sistema, Anthropic publica repositorios firmados para apt (Debian, Ubuntu), dnf (Fedora, RHEL) y apk (Alpine). Para Ubuntu o Debian, en el canal stable:

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

En una instalación limpia, ejecuta antes sudo apt install curl gnupg. Antes de confiar en la clave, comprueba su huella con gpg --show-keys /etc/apt/keyrings/claude-code.asc: debe terminar en BAA929FF1A7ECACE. Alpine necesita algunos paquetes más (bash, curl, libgcc, libstdc++, ripgrep), que se detallan en la documentación oficial.

Instalar Claude Code en Windows (PowerShell, CMD, WinGet)

Claude Code funciona de forma nativa en Windows 10 (versión 1809 o posterior) y Windows 11, sin WSL y sin permisos de administrador. Abre PowerShell desde el menú Inicio y pega:

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

En el símbolo del sistema clásico (CMD), el comando es distinto:

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

Para saber dónde estás: el prompt muestra PS C:\Users\TuNombre> en PowerShell, y C:\Users\TuNombre> sin el «PS» en CMD. Equivocarse de comando es un error habitual al instalar Claude Code en Windows. Otra vía, más clásica para un equipo gestionado: winget install Anthropic.ClaudeCode, que se actualiza con winget upgrade Anthropic.ClaudeCode.

Instala también Git for Windows. Ya no es obligatorio: sin él, Claude Code ejecuta sus comandos con PowerShell. Con él, el agente dispone de Git Bash, que algunas de sus herramientas necesitan.

Instalar Claude Code en WSL

WSL te da un Linux de verdad dentro de Windows. Elígelo si tus proyectos usan herramientas de Linux, o si quieres el aislamiento de comandos (sandbox), disponible con WSL 2 pero no en Windows nativo. Abre tu distribución (Ubuntu, por ejemplo) y ejecuta el comando de Linux en ese terminal, no en PowerShell:

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

Claude Code se instala y se ejecuta entonces en el lado Linux. WSL no necesita Git for Windows.

Instalar Claude Code con npm

El método antiguo sigue disponible en todos los sistemas, con Node.js 22 o posterior:

npm install -g @anthropic-ai/claude-code

El paquete npm instala el mismo programa nativo que el instalador. No uses nunca sudo npm install -g: es una fuente de problemas de permisos y un riesgo de seguridad. Para actualizar, mejor npm install -g @anthropic-ai/claude-code@latest que npm update -g, que puede dejarte en una versión antigua.

Comprobar que Claude Code está bien instalado

Cierra el terminal que usaste para la instalación y abre uno nuevo: el anterior conserva el valor antiguo del PATH. Después:

claude --version

Una instalación correcta muestra un número de versión seguido de «(Claude Code)». Para un diagnóstico completo (estado de la instalación, ajustes no válidos, última actualización), ejecuta:

claude doctor

Con el instalador nativo, el comando claude está en ~/.local/bin en Mac y Linux, y en %USERPROFILE%\.local\bin en Windows. Las versiones sucesivas se guardan en ~/.local/share/claude.

Iniciar sesión en tu cuenta de Claude

Sitúate en la carpeta de tu proyecto y lanza Claude Code:

cd ruta/a/tu/proyecto
claude

La primera vez, el navegador se abre en la página de inicio de sesión. Confirma, vuelve al terminal: tus credenciales quedan guardadas y no tendrás que volver a conectarte. Funcionan tres tipos de cuenta:

• Una suscripción Claude Pro, Max, Team o Enterprise: la vía más sencilla, el uso está incluido en la suscripción.
• Una cuenta de Claude Console: el uso se factura por token con créditos de prepago. En el primer inicio de sesión, la Console crea un espacio de trabajo «Claude Code» para seguir el gasto.
• Amazon Bedrock, Google Cloud o Microsoft Foundry, para las empresas que trabajan a través de su proveedor cloud.

Si el navegador no se abre, pulsa c para copiar el enlace de inicio de sesión y pégalo a mano. Desde WSL, un servidor por SSH o un contenedor, la página muestra un código que hay que pegar en el terminal; si el pegado no funciona, claude auth login lee ese código directamente. Para cambiar de cuenta: /logout y luego /login. Para ver la cuenta activa: /status.

Primeros comandos de Claude Code

Una vez conectado, le hablas a Claude Code en español, como a un compañero. Empieza por hacer que entienda el proyecto antes de pedirle que modifique nada:

¿qué hace este proyecto?
explícame cómo están organizadas las carpetas
/init

El comando /init crea un archivo CLAUDE.md en la raíz: el contexto del proyecto, que Claude Code relee en cada arranque (para qué sirve el proyecto, qué comandos ejecutar, qué reglas respetar). Es el ajuste más rentable de la herramienta. Reléelo y complétalo: un proyecto con un buen archivo de contexto da resultados incomparables con el mismo proyecto sin él. Es el principio que desarrollo en mi artículo sobre prompt engineering: lo que le das a leer cuenta más que la forma en que se lo pides.

Los modos de permisos: lo que Claude Code hace sin preguntarte

Un modo de permisos fija lo que el agente puede hacer sin tu autorización. Mayús + Tab pasa de un modo a otro durante la sesión.

• Manual: pregunta antes de cada modificación de archivo o comando; solo las lecturas pasan sin preguntar. La buena opción para empezar o para un trabajo delicado.
• Accept edits: modifica los archivos y lanza los comandos de archivos habituales (crear, copiar, mover) sin preguntar.
• Plan: analiza y propone un plan sin modificar nada, útil antes de un cambio grande.
• Auto: un segundo modelo examina las acciones por ti y bloquea las que suponen un riesgo.

Desde la versión 2.1.283, una sesión interactiva arranca en modo auto, salvo que se configure otra cosa. Si estás empezando, te aconsejo pasar a Manual los primeros días y trabajar sobre una copia de la carpeta: ves lo que el agente va a hacer antes de que lo haga.

Instalar la extensión de Claude Code para VS Code

La extensión es la forma más cómoda de usar Claude Code si el terminal te echa para atrás: los cambios se muestran como diff, revisas y ajustas el plan antes de aceptarlo, y citas un archivo con @. Necesitas VS Code 1.94 o posterior.

1. Abre la vista Extensiones: Cmd + Mayús + X en Mac, Ctrl + Mayús + X en Windows y Linux.
2. Busca «Claude Code», publicado por Anthropic, y haz clic en Instalar. Por línea de comandos: code --install-extension anthropic.claude-code.
3. Abre un archivo y haz clic en el icono Spark, arriba a la derecha del editor, o en «✻ Claude Code» en la barra de estado.
4. Haz clic en Sign in y confirma el inicio de sesión en el navegador.

La extensión también se instala en Cursor y en los demás editores derivados de VS Code, desde su catálogo o desde el registro Open VSX. Un detalle importante: lleva su propia copia de Claude Code y no añade el comando claude al terminal. Para tenerlo también en línea de comandos, instala el CLI por separado. Al revés, ejecutar claude en el terminal integrado de VS Code instala la extensión automáticamente.

Claude Code en JetBrains (IntelliJ, PyCharm, WebStorm…)

El plugin de JetBrains funciona con IntelliJ IDEA, PyCharm, WebStorm, PhpStorm, GoLand y Android Studio. A diferencia de la extensión de VS Code, no incluye Claude Code: lanza el comando claude en el terminal del IDE.

1. Instala el CLI con uno de los comandos anteriores y comprueba claude --version.
2. Instala el plugin «Claude Code [Beta]» desde el Marketplace de JetBrains (Settings y luego Plugins), y reinicia el IDE.
3. Ejecuta claude en el terminal integrado, o usa Cmd + Esc en Mac, Ctrl + Esc en Windows y Linux.

Desde un terminal externo, el comando /ide conecta la sesión con el IDE abierto. En WSL, indica en los ajustes del plugin el comando wsl -d Ubuntu -- bash -lic "claude", sustituyendo Ubuntu por el nombre de tu distribución.

Claude Code desktop: la aplicación de escritorio

Si no quieres terminal en absoluto, la aplicación de escritorio de Claude incluye Claude Code en su pestaña Code. Se instala como cualquier programa, sin Node.js ni CLI.

• macOS: una versión universal, para los Mac Intel y para los de chip Apple.
• Windows: un instalador x64, y un instalador aparte para los procesadores ARM64.
• Linux: en beta, para Ubuntu 22.04 o Debian 12 y versiones posteriores, mediante el repositorio apt de Anthropic (paquete claude-desktop).

Abre la aplicación, inicia sesión, haz clic en la pestaña Code y luego en Select folder para elegir tu proyecto. Puedes trabajar en local, en la nube (la sesión continúa con la aplicación cerrada), en una máquina remota por SSH o en WSL en Windows. La misma aplicación da acceso al chat y a Cowork, el agente de tareas en segundo plano que presento en Claude Cowork.

Igual que el CLI, la pestaña Code requiere una suscripción de pago: si al hacer clic en Code te propone cambiar de plan, tu cuenta está en el plan gratuito. La aplicación no acepta claves de API de Console; para ese caso, usa el CLI.

Actualizar Claude Code

Con el instalador nativo, no tienes que hacer nada: Claude Code busca actualizaciones al arrancar y durante el uso, las descarga en segundo plano y las aplica en el siguiente inicio. Para forzar la actualización en el momento:

claude update

Los demás métodos se actualizan a mano:

El canal se configura en /config, apartado Auto-update channel: latest, la opción por defecto, recibe cada versión en cuanto sale; stable va alrededor de una semana por detrás y se salta las versiones que han dado problemas. Para desactivar las actualizaciones automáticas, añade "DISABLE_AUTOUPDATER": "1" en la sección env de tu archivo settings.json.

Desinstalar Claude Code

Elimina primero el programa. Instalador nativo, en Mac, Linux y WSL:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Instalador nativo en Windows, en PowerShell:

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Para los demás métodos: brew uninstall --cask claude-code, winget uninstall Anthropic.ClaudeCode, sudo apt remove claude-code, sudo dnf remove claude-code o npm uninstall -g @anthropic-ai/claude-code.

Tus ajustes, el historial de sesiones y la configuración de los servidores MCP se quedan en ~/.claude y ~/.claude.json. Bórralos solo si quieres eliminarlo todo, y desinstala antes la extensión de VS Code, el plugin de JetBrains y la aplicación de escritorio, que vuelven a crear esa carpeta:

rm -rf ~/.claude
rm ~/.claude.json

Si claude sigue respondiendo después de todo esto, queda una segunda instalación, a menudo una versión antigua de npm o un alias que dejó un instalador anterior.

Errores frecuentes al instalar Claude Code y su solución

Añadir Claude Code al PATH

En Mac, con Zsh, el shell por defecto:

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

En Linux y WSL, con Bash, la misma línea sustituyendo ~/.zshrc por ~/.bashrc. En Windows, en PowerShell:

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

Reinicia después el terminal y vuelve a ejecutar claude --version.

¿Y después de la instalación?

Claude Code se amplía después de tres formas:

• Las skills: conocimientos reutilizables (un procedimiento de auditoría, una checklist de publicación) que el agente carga cuando los necesita. Las instrucciones están en Claude Skills.
• Los servidores MCP: la conexión con tus herramientas (Search Console, crawler, base de datos). Consulta qué es un servidor MCP.
• Los plugins: paquetes que agrupan skills, agentes y servidores MCP, que se instalan con /plugin dentro de una sesión.

La mitad de lo que le encargo no tiene nada que ver con programar: convertir cientos de imágenes, cruzar dos exportaciones, revisar un sitio antes de publicarlo. Cuando una tarea se repite cada semana, se convierte en un programa que funciona solo: es el tipo de proyecto que llevo a cabo en mis proyectos de automatización con IA.

Escrito por

Anthony Courtin

Consultor SEO, GEO y automatización con IA

Acompaño a pymes y profesionales independientes en su visibilidad (Google, ChatGPT, Perplexity) y en el uso real de la IA en el trabajo. Intervengo en empresas para formar a los equipos y replantear los procesos. Todo lo que escribo aquí, lo uso en mis proyectos con clientes.

Sígueme en LinkedIn Mi canal de YouTube (en francés)