Claude Code en macOS: diagnóstico y reparación de la instalación

Claude Code se instala en macOS de forma más confiable que en cualquier otro sistema operativo importante, hasta que deja de hacerlo. Cuando falla, la causa casi siempre es uno de siete puntos de fricción concretos: instalaciones de Node.js que compiten, trampas del PATH en zsh, desajustes entre Apple Silicon e Intel, marcas de cuarentena de Gatekeeper, restricciones de acceso TCC, interferencia de sincronización de iCloud Drive o bloqueos de MDM corporativo. Esta guía gratuita es el manual que recorre cada uno con los comandos exactos de Terminal.

Escrita para el desarrollador de macOS que instala Claude Code por primera vez, el ingeniero que migra a una Mac nueva, el líder de equipo que integra a alguien y el técnico de TI que resuelve la instalación de otra persona. Sin suponer experiencia en Linux: cada comando es específico de macOS y explica qué revisa o modifica.

Lo que aprenderás

• Los siete fallos que explican la mayoría de los problemas de instalación en macOS.
• Los chequeos previos que ahorran una hora de depuración en cinco minutos.
• Instalar Node.js con Homebrew, nvm o el instalador oficial, con sus ventajas honestas.
• El comando npm install -g @anthropic-ai/claude-code y los cinco puntos donde suele romperse.
• Apple Silicon vs Intel: arm64 nativo frente a la traducción con Rosetta 2.
• Gatekeeper, notarización y cuarentena, con las recetas de xattr.
• Problemas de PATH en zsh: la diferencia entre .zshrc, .zprofile y .zshenv.
• Restricciones TCC y la configuración de Acceso Total al Disco.
• Interferencia de iCloud Drive y cómo mantener la configuración fuera de carpetas sincronizadas.
• Login, clave de API, integración con Keychain y el patrón direnv para varias cuentas.

Esta guía es gratuita: sin registro ni correo. Publicamos guías gratuitas de resolución de problemas porque ahorrarte una tarde de depuración vale la pena, compres o no una de nuestras guías de pago. Descárgala y deja tu Mac lista en minutos.