¿Quieres usar Claude Code en tu Mac pero no sabes por dónde empezar? Esta guía te muestra exactamente cómo instalar y configurar Claude Code en macOS, paso a paso. Ya tengas un MacBook Air M1, un Mac Studio o un iMac Intel, aquí encontrarás todas las instrucciones para estar operativo en menos de 10 minutos. Cubrimos los requisitos del sistema, los diferentes métodos de instalación, la configuración inicial y las soluciones a los problemas más frecuentes.

¿Cuáles son los requisitos previos para instalar Claude Code en macOS?

Para instalar Claude Code en macOS, necesitas macOS 10.15 (Catalina) como mínimo, 4 GB de RAM, 500 MB de espacio en disco y una cuenta de Anthropic activa. Estos requisitos son intencionalmente ligeros para permitir que el máximo número de personas acceda a la herramienta.

Aquí están los detalles de los requisitos técnicos:

  • Sistema operativo: macOS 10.15 (Catalina) o más reciente. Las versiones Monterey, Ventura y Sonoma son totalmente compatibles.
  • Procesador: Compatible con chips Intel y Apple Silicon (M1, M2, M3). No hay diferencia de funcionalidad entre las dos arquitecturas.
  • Memoria RAM: 4 GB mínimo, 8 GB recomendados para una experiencia fluida con varios proyectos abiertos.
  • Espacio en disco: 500 MB para la aplicación, más 1 a 2 GB para las dependencias y los proyectos.
  • Conexión a internet: Necesaria para la instalación inicial y el uso (Claude Code funciona en línea).

En cuanto a la cuenta de usuario, debes tener una cuenta de Anthropic. La creación es gratuita en el sitio oficial de Anthropic. Puedes comenzar con el plan gratuito que ofrece una cuota mensual suficiente para empezar. Los planes pagos (Pro a 20 $/mes, Team a 30 $/mes por usuario) desbloquean cuotas más altas según la documentación oficial de Anthropic.

Verifica tu versión de macOS haciendo clic en el logo de Apple en la esquina superior izquierda, luego "Acerca de este Mac". Si estás en una versión anterior a Catalina, tendrás que actualizar tu sistema antes de continuar.

¿Cómo descargar e instalar Claude Code en Mac?

La instalación de Claude Code en macOS se realiza descargando el archivo .dmg desde el sitio oficial de Anthropic, luego arrastrando la aplicación a la carpeta Aplicaciones. El proceso completo toma aproximadamente 5 minutos.

Sigue estos pasos precisos:

  1. Accede al sitio oficial: Ve a claude.ai e inicia sesión con tu cuenta de Anthropic.

  2. Descarga Claude Code: En el menú principal, haz clic en "Downloads" y luego selecciona "Claude Code for macOS". La descarga del archivo .dmg (aproximadamente 150 MB) comienza automáticamente.

  3. Abre el archivo .dmg: Una vez completada la descarga, haz doble clic en el archivo "ClaudeCode-macOS.dmg" en tu carpeta Descargas.

  4. Instala la aplicación: Se abre una ventana con el icono de Claude Code y un acceso directo a la carpeta Aplicaciones. Arrastra el icono de Claude Code a la carpeta Aplicaciones.

  5. Inicia Claude Code: Abre tu carpeta Aplicaciones (Cmd + Mayús + A en el Finder) y haz doble clic en Claude Code.

  6. Autoriza la aplicación: En el primer inicio, macOS muestra un mensaje de seguridad. Haz clic en "Abrir" para confirmar. Si el botón "Abrir" no aparece, ve a Preferencias del Sistema > Privacidad y seguridad, luego haz clic en "Abrir de todas formas" junto al mensaje sobre Claude Code.

  7. Inicia sesión: La aplicación te pide que te autentiques con tu cuenta de Anthropic. Introduce tu correo electrónico y contraseña.

La instalación está completa. Claude Code aparece en tu dock y puedes fijarlo para un acceso rápido haciendo clic derecho en el icono y luego "Opciones" > "Mantener en el Dock".

Para usuarios avanzados que prefieren la línea de comandos, también está disponible la instalación a través de Homebrew con el comando brew install --cask claude-code, pero el método .dmg sigue siendo el más simple para principiantes.

¿Cómo configurar Claude Code después de la instalación?

La configuración inicial de Claude Code consiste en elegir tu modelo preferido (Claude 3.5 Sonnet recomendado), definir tu carpeta de proyectos y ajustar los parámetros de generación de código. Este paso toma 2 a 3 minutos y mejora significativamente tu experiencia.

Aquí están los ajustes esenciales a realizar:

Selección del modelo

Haz clic en el icono de engranaje en la esquina superior derecha, luego "Modelo". Tienes acceso a varias versiones de Claude:

  • Claude 3.5 Sonnet: El mejor equilibrio para código. Rápido, preciso, excelente para principiantes. Es la opción predeterminada y la que recomendamos.
  • Claude 3 Opus: Más potente pero más lento y consume más créditos. Guárdalo para proyectos complejos.
  • Claude 3 Haiku: Muy rápido, ideal para preguntas simples y modificaciones ligeras.

Para empezar, mantente en Claude 3.5 Sonnet. Puedes cambiar en cualquier momento según tus necesidades.

Carpeta de proyectos

En la configuración, sección "Proyectos", define dónde Claude Code va a crear y guardar tus proyectos. Por defecto, utiliza ~/Documents/ClaudeCode. Puedes cambiarlo a cualquier carpeta de tu Mac.

Consejo práctico: crea una carpeta dedicada como ~/Proyectos-Claude para mantener una organización clara, especialmente si ya usas otras herramientas de desarrollo.

Parámetros de generación

En "Preferencias" > "Generación de código", puedes ajustar:

  • Nivel de detalle de comentarios: "Medio" es perfecto para aprender. "Alto" añade más explicaciones en el código generado.
  • Estilo de código: Elige entre "Moderno" (recomendado) o "Clásico" según tus preferencias.
  • Verificación automática: Activa esta opción para que Claude verifique el código antes de presentártelo.

Atajos de teclado

En "Preferencias" > "Atajos", personaliza las teclas rápidas. Las más útiles:

  • Cmd + N: Nuevo proyecto
  • Cmd + Mayús + P: Abrir la paleta de comandos
  • Cmd + K: Iniciar una generación de código

Una vez realizados estos ajustes, guarda haciendo clic en el botón "Aplicar" en la parte inferior de la ventana de preferencias.

¿Cuáles son los errores de instalación comunes y cómo resolverlos?

Los tres errores más frecuentes al instalar Claude Code en macOS son el bloqueo por Gatekeeper, los problemas de permisos y los conflictos con otras herramientas de desarrollo. Aquí te mostramos cómo identificarlos y corregirlos.

Error "La aplicación no se puede abrir"

Este mensaje aparece cuando Gatekeeper bloquea Claude Code. Solución:

  1. Ve a Preferencias del Sistema > Privacidad y seguridad
  2. Desplázate hacia abajo hasta ver el mensaje sobre Claude Code
  3. Haz clic en "Abrir de todas formas"
  4. Confirma con tu contraseña de administrador
  5. Reinicia Claude Code

Si el problema persiste, abre la Terminal y escribe:

xattr -cr /Applications/ClaudeCode.app

Este comando elimina los atributos de cuarentena que a veces bloquean las aplicaciones descargadas.

Error de conexión al servidor

Si Claude Code no puede conectarse después de la autenticación:

  • Verifica tu conexión a internet (abre un navegador y prueba)
  • Desactiva temporalmente tu VPN si usas uno
  • Verifica que tu firewall no bloquee Claude Code (Preferencias del Sistema > Seguridad > Firewall > Opciones del firewall)
  • Reinicia la aplicación

Si el error persiste, el problema podría venir de los servidores de Anthropic. Consulta status.anthropic.com para verificar el estado de los servicios.

Problema de permisos en la carpeta de proyectos

Si Claude Code muestra "No se puede escribir en la carpeta de proyectos":

  1. Abre el Finder y navega a la carpeta en cuestión
  2. Haz clic derecho > "Obtener información"
  3. Desbloquea los permisos haciendo clic en el candado en la parte inferior
  4. Cambia "Solo lectura" a "Lectura y escritura" para tu usuario
  5. Haz clic en el engranaje > "Aplicar a elementos incluidos"

Conflicto con otros editores de código

Si ya has instalado VS Code, Cursor u otros IDE, a veces pueden entrar en conflicto con Claude Code. La solución: designa Claude Code como editor predeterminado para archivos de código en Preferencias del Sistema > Extensiones > Editor de texto predeterminado.

Para usuarios de Cursor que dudan entre las dos herramientas, nuestro artículo Cursor vs Claude Code compara en detalle las fortalezas y debilidades de cada solución.

¿Cómo verificar que la instalación funciona correctamente?

Para probar tu instalación de Claude Code, crea un primer proyecto simple que muestre "Hello World" en una página web. Esta prueba toma 2 minutos y confirma que todos los componentes funcionan.

Aquí está la prueba completa a realizar:

  1. Inicia Claude Code desde tu carpeta Aplicaciones

  2. Crea un nuevo proyecto: Haz clic en "Nuevo proyecto" o presiona Cmd + N

  3. Dale un nombre: Llámalo "test-instalacion"

  4. Pídele a Claude: En la barra de chat, escribe exactamente: "Crea una página HTML simple que muestre 'Hello World' en grande en el centro de la pantalla con un fondo azul claro"

  5. Verifica la generación: Claude Code debe generar un archivo index.html en pocos segundos. Ves el código aparecer en el editor a la derecha.

  6. Previsualiza el resultado: Haz clic en el botón "Vista previa" en la esquina superior derecha. Se abre una ventana con tu página web.

  7. Prueba las modificaciones: Pídele a Claude "Cambia el color de fondo a verde menta". El código debe actualizarse automáticamente.

Si todos estos pasos funcionan, tu instalación es perfecta. Estás listo para crear tus primeros proyectos reales con Claude Code.

Para profundizar en el uso de la herramienta, consulta nuestro tutorial completo de Claude Code para principiantes que cubre funcionalidades avanzadas y mejores prácticas.

¿Cómo actualizar Claude Code en macOS?

Claude Code se actualiza automáticamente al iniciar, pero puedes forzar una actualización manual desde el menú Ayuda > Buscar actualizaciones. Las actualizaciones aportan regularmente nuevas funcionalidades y correcciones de errores.

El proceso de actualización automática:

  • Cada vez que inicias Claude Code, verifica si existe una versión nueva
  • Si es así, aparece una notificación en la esquina superior derecha
  • Haz clic en "Actualizar" para descargar la nueva versión
  • La aplicación se reinicia automáticamente después de la instalación
  • Tus proyectos y configuración se conservan

Para una actualización manual:

  1. Abre Claude Code
  2. Ve al menú "Ayuda" en la parte superior de la pantalla
  3. Haz clic en "Buscar actualizaciones"
  4. Si existe una versión más reciente, haz clic en "Descargar e instalar"
  5. Espera a que se complete la descarga (generalmente 1 a 2 minutos)
  6. Deja que la aplicación se reinicie

Las actualizaciones mayores (cambio de versión, como 1.0 a 2.0) pueden requerir un reinicio completo de tu Mac. Claude Code te lo comunica antes de proceder.

Frecuencia de actualizaciones: Anthropic publica actualizaciones menores cada 2 a 3 semanas y versiones mayores cada 2 a 3 meses. Puedes consultar las notas de versión completas en el sitio oficial de Anthropic para ver las novedades de cada actualización.

Consejo: activa las actualizaciones automáticas en Preferencias > General > "Instalar actualizaciones automáticamente" para siempre beneficiarte de las últimas mejoras sin pensarlo.

Conclusión

Instalar Claude Code en macOS es un proceso simple que toma menos de 10 minutos. Una vez que la aplicación está configurada, tienes un asistente de IA potente para crear sitios web, aplicaciones y scripts sin conocimientos previos de programación. La actualización automática garantiza que siempre disfrutes de las últimas mejoras.

Si encuentras un problema no cubierto en esta guía, la documentación oficial de Anthropic y la comunidad de Claude Code en Discord son recursos valiosos para obtener ayuda rápidamente.