# Instalar Claude Code: Guía de setup para macOS, Linux y Windows | Alher Tech

> Instala Claude Code en menos de 5 minutos. Setup de Node 18+, API key, bootstrap de CLAUDE.md y notas WSL2 para Windows: los pasos exactos que usa Alher Tech.

- Canonical page: https://alhertech.com/es/claude-code/instalar/
- Site: Alher Tech (custom software, AI agents and SEO engineering, https://alhertech.com/)
- Contact: https://alhertech.com/es/contacto/

---

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.