Desarrollo e IA Guía
Cómo instalar Claude Code en Mac, Windows, Linux, VS Code y JetBrains
Requisitos, comandos oficiales para cada sistema, verificación con claude doctor, primer inicio de sesión e integración con los IDE más usados.
Instalar Claude Code lleva menos de cinco minutos si se elige el método adecuado para cada sistema. En esta guía repasamos los requisitos, los comandos oficiales para macOS, Linux y Windows, cómo comprobar que todo funciona y cómo conectar la herramienta con VS Code y los IDE de JetBrains. Todos los comandos proceden de la documentación oficial de Anthropic.
¿Qué requisitos tiene Claude Code?
Según la página de configuración avanzada de la documentación, Claude Code funciona en:
- macOS 13.0 o superior.
- Windows 10 1809 o superior, o Windows Server 2019 o superior.
- Linux: Ubuntu 20.04+, Debian 10+ y Alpine Linux 3.19+.
- Hardware: 4 GB de RAM como mínimo y procesador x64 o ARM64.
- Red: conexión a internet y estar en uno de los países donde Anthropic presta servicio (España lo está).
Además hace falta una cuenta de pago: Pro, Max, Team, Enterprise o una cuenta de Claude Console (API). El plan gratuito de claude.ai no da acceso a Claude Code.
¿Cómo instalar Claude Code en macOS, Linux o WSL?
El método recomendado es el instalador nativo. Abre una terminal y ejecuta:
curl -fsSL https://claude.ai/install.sh | bashEl instalador no muestra progreso mientras descarga, así que no hay que preocuparse si parece parado unos segundos. Al terminar, abre una terminal nueva y comprueba la versión con claude --version. La gran ventaja del instalador nativo es que se actualiza solo en segundo plano.
Si prefieres Homebrew, existe un cask oficial:
brew install --cask claude-codeTen en cuenta que las instalaciones con Homebrew no se actualizan automáticamente: habrá que ejecutar brew upgrade claude-code de vez en cuando.
¿Cómo instalar Claude Code en Windows?
En Windows hay dos caminos: instalación nativa o dentro de WSL. Para la nativa, el comando depende de la consola. Si el prompt empieza por PS C:\ estás en PowerShell:
irm https://claude.ai/install.ps1 | iexSi estás en CMD (el prompt no lleva «PS»):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdUn error habitual es pegar el comando en la consola equivocada. Si aparece The token '&&' is not a valid statement separator, estás en PowerShell; si sale 'irm' is not recognized, estás en CMD. No hace falta ejecutar nada como administrador.
La documentación recomienda instalar Git for Windows para que Claude Code pueda usar su herramienta Bash. Otra opción es WinGet: winget install Anthropic.ClaudeCode, aunque, como con Homebrew, las actualizaciones son manuales (winget upgrade Anthropic.ClaudeCode).
Lee también: Code Review de Claude Code llega a disponibilidad general para equipos
Si trabajas con toolchains de Linux, lo más cómodo es WSL: abre tu distribución y usa el instalador de Linux del apartado anterior. En ese caso, claude se instala y se lanza dentro de la terminal de WSL, no desde PowerShell.
¿Se puede instalar Claude Code con npm?
Sí, como paquete global:
npm install -g @anthropic-ai/claude-codeDos advertencias de la documentación: no uses sudo npm install -g, porque puede provocar problemas de permisos y riesgos de seguridad, y para actualizar es mejor reinstalar con @latest que usar npm update -g. Para la mayoría de equipos, el instalador nativo es más sencillo de mantener.
¿Cómo comprobar que la instalación funciona?
Dos comandos bastan:
claude --version
claude doctorEl primero imprime el número de versión. El segundo hace un diagnóstico de solo lectura de la instalación y de los archivos de configuración, con avisos y sugerencias de solución. Si la terminal dice que claude no se encuentra, el directorio de instalación no está en el PATH: abre una terminal nueva o revisa la guía de resolución de problemas de instalación.
¿Cómo se inicia sesión la primera vez?
Entra en la carpeta de un proyecto y lanza la herramienta:
cd mi-proyecto
claudeLa primera vez abrirá el navegador para iniciar sesión con la cuenta de Claude. Si tienes definida la variable ANTHROPIC_API_KEY y aceptas usarla cuando Claude Code lo pregunta, se salta ese paso y factura contra la API. Para empresas que usan Amazon Bedrock, Google Cloud o Microsoft Foundry hay guías específicas de configuración.
¿Cómo usar Claude Code en VS Code?
La extensión oficial requiere VS Code 1.94.0 o superior. Se instala buscando «Claude Code» en la vista de extensiones (Cmd+Shift+X en Mac, Ctrl+Shift+X en Windows y Linux). También funciona en Cursor y otros forks de VS Code. Tras instalarla, se abre desde el icono de Claude en la barra del editor o desde la paleta de comandos con «Claude Code: Open in New Tab».
Atajos útiles: Cmd+Esc o Ctrl+Esc alterna el foco entre el editor y Claude, y Option+K o Alt+K inserta una referencia al archivo y las líneas seleccionadas, del tipo @app.ts#5-10. La extensión permite revisar y editar los planes antes de aceptarlos, ver diffs en línea y abrir varias conversaciones en pestañas.
¿Y en IntelliJ, PyCharm o WebStorm?
Para los IDE de JetBrains hay un plugin en el JetBrains Marketplace, pero no incluye el CLI: primero hay que instalar Claude Code con alguno de los métodos anteriores y después el plugin, y reiniciar el IDE. A partir de ahí, basta con ejecutar claude en la terminal integrada para que los diffs se abran en el visor del IDE y la selección actual se comparta como contexto. Desde una terminal externa, el comando /ide conecta la sesión con el IDE abierto.
Si usas JetBrains con WSL, la documentación sugiere configurar como comando de Claude wsl -d Ubuntu -- bash -lic "claude", cambiando Ubuntu por el nombre de tu distribución. En Remote Development, el plugin debe instalarse en el host remoto, no en el cliente local.
¿Hay alternativas sin terminal?
Sí. La app de escritorio de Claude incluye Claude Code en su pestaña Code, sin instalar el CLI por separado, y la versión web en claude.ai/code ejecuta las sesiones en la nube contra repositorios de GitHub. Son buenas opciones para perfiles menos técnicos o para lanzar tareas largas y revisarlas después.
Cómo desinstalar Claude Code
En una instalación nativa de macOS o Linux basta con borrar el binario y sus versiones:
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claudeCon Homebrew, brew uninstall --cask claude-code; con WinGet, winget uninstall Anthropic.ClaudeCode; con npm, npm uninstall -g @anthropic-ai/claude-code. La configuración vive en ~/.claude y ~/.claude.json: bórralos solo si quieres perder ajustes, permisos, servidores MCP e historial.
