Instalar Claude Code: guía de setup para macOS, Linux y Windows

Instalar Claude Code lleva menos de cinco minutos en cualquier máquina de desarrollo moderna. Node 18+ es el único requisito duro; lo demás es un install de una línea seguido de la API key. Esta es la ruta exacta que usamos en cada onboarding de Alher Tech.

Actualizado: 24 de abril de 2026

Requisitos previos

Necesitas Node 18 o superior (recomendado Node 20), un shell funcional (bash, zsh o fish) y una API key de Anthropic o suscripción Claude Pro / Team. En Windows recomendamos ejecutar dentro de WSL2; Windows nativo funciona pero varios servidores MCP asumen rutas POSIX.

Instala la CLI

Ejecuta `npm install -g @anthropic-ai/claude-code`. Eso instala el binario como `claude`. La primera ejecución abre el navegador para autenticar; a partir de ahí puedes lanzar el agente con `claude` dentro de cualquier directorio de proyecto.

Configura tu proyecto

Crea un `CLAUDE.md` en la raíz del repo. Escribe las convenciones del proyecto (stack, arquitectura, zonas intocables). Este archivo se carga en cada sesión y es la mayor ganancia de calidad por token; los equipos que lo omiten malgastan un 30% del presupuesto del agente re-aprendiendo el código.

Verifica la instalación

Ejecuta `claude doctor` para confirmar red, auth y servidores MCP. Si usas hooks, añádelos a `.claude/settings.json` y verifica con `claude --debug`. Una salida verde de doctor significa que estás listo para entregar.

Preguntas frecuentes

¿Necesito suscripción de OpenAI o Claude?

Se necesita un plan Claude Pro, Team o Enterprise (o créditos API de pago por uso). Claude Code en sí es gratis de instalar.

¿Funciona Claude Code en Windows?

Sí, tanto de forma nativa como dentro de WSL2. Recomendamos WSL2 por compatibilidad con MCP.