Inicio

Instalar Claude Code en Mac

Claude Code es un asistente de IA que funciona en su Terminal y lo ayuda a escribir, depurar y comprender código. Piénselo como un compañero de programación experto disponible cuando lo necesite. Ya sea principiante o desarrollador experimentado, Claude Code puede acelerar su trabajo y ayudarlo a aprender.

Esta guía lo acompaña paso a paso durante la instalación, con instrucciones detalladas para principiantes.

Descripción General

• Abrir Terminal
• Instalar Claude Code
• Configurar su conexión API
• Comenzar a usar Claude Code

Conceptos Clave

• Terminal: Aplicación integrada de Mac donde escribe comandos en lugar de hacer clic en botones. Es la forma de interactuar con Claude Code.
• Claude Code: Asistente de programación con IA que se ejecuta en Terminal. Puede responder preguntas, escribir código y ayudarlo a comprender proyectos existentes.

Lo Que Necesitará

• Computadora Mac (macOS 13.0 Ventura o posterior)
• Conexión a Internet
• Acceso de administrador en su computadora
• Suscripción a Claude Pro/Max o clave API
• 5 - 10 minutos

Paso 1: Abrir Terminal

• Haga clic en el ícono Launchpad en su Dock (el ícono con cuadrados de colores)
• Escriba Terminal en el cuadro de búsqueda en la parte superior
• Haga clic en Terminal (un ícono de cuadrado negro)
• Se abrirá una ventana de Terminal con un cursor parpadeante

Consejo: Mantenga Terminal abierto para los próximos pasos.

Paso 2: Instalar Claude Code

En Terminal, copie y pegue este comando, luego presione Return:

curl -fsSL https://claude.ai/install.sh | bash

• Espere a que Claude Code se instale (1-2 minutos)
• Puede ver algunos mensajes de progreso: esto es normal
• Cuando se complete la instalación, cierre y vuelva a abrir Terminal, luego verifique escribiendo:

   claude --version
  

• Debería ver el número de versión de Claude Code

Alternativa: Instalar con Homebrew

Si usa Homebrew, puede instalar Claude Code con:

brew install --cask claude-code

Consejo: Ejecute claude doctor después de la instalación para verificar que todo esté configurado correctamente.

Paso 3: Conectarse a Su Cuenta de Anthropic

Opción A. Usar su suscripción a Claude Pro o Max

• En Terminal, escriba:

   claude
  

• Claude intentará abrir un navegador. Si no se abre automáticamente, copie la URL mostrada en Terminal y péguela en su navegador.
• Inicie sesión en su cuenta de Claude.ai (esto puede ocurrir automáticamente)
• Haga clic en Authorize
• Haga clic en Copy Code cuando aparezca un código largo
• Regrese a la ventana de Terminal
• Para pegar en Terminal: Haga clic en Edit en la barra de menú, luego haga clic en Paste
• Debería ver un mensaje de éxito
• Siga las instrucciones para completar la configuración

Opción B. Usar la clave API de Anthropic

Si tiene una clave API de Anthropic en lugar de una suscripción a Claude:

• Primero, obtenga su clave API de la Consola de Anthropic
• En Terminal, escriba:

   export ANTHROPIC_API_KEY="your-api-key-here"
  

  Reemplace your-api-key-here con su clave API real

• Para hacerlo permanente (no tener que configurarlo cada vez), agréguelo a su perfil de shell:

   echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
  

  Reemplace your-api-key-here con su clave API real

• Cierre y vuelva a abrir Terminal para que los cambios surtan efecto

Nota: Si usa una Mac más antigua con bash en lugar de zsh, reemplace ~/.zshrc con ~/.bash_profile en el comando anterior.

Opción C. Usar la API de OpenRouter (¡comienza gratis!)

OpenRouter es una pasarela de API unificada que proporciona acceso a más de 500 modelos de lenguaje de gran tamaño a través de una única clave API. Esta puede ser una forma económica de usar Claude Code, ya que solo paga por uso y puede elegir entre modelos de varios puntos de precio.

• Regístrese en openrouter.ai e inicie sesión
• Haga clic en Get API key y copie la clave en un lugar seguro
• Configure las variables de entorno requeridas antes de iniciar Claude Code:

   export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
   export ANTHROPIC_AUTH_TOKEN="your-openrouter-api-key"
   export ANTHROPIC_API_KEY=""
   export ANTHROPIC_DEFAULT_SONNET_MODEL="openai/gpt-5.1-codex-max"
   export ANTHROPIC_DEFAULT_OPUS_MODEL="openai/gpt-5.2-pro"
   export ANTHROPIC_DEFAULT_HAIKU_MODEL="minimax/minimax-m2:exacto"
  

• Inicie Claude Code:

   claude
  

• Verifique la conexión escribiendo /status en Claude Code

Notas:

• Reemplace your-openrouter-api-key con su clave API real de OpenRouter
• ANTHROPIC_API_KEY debe establecerse explícitamente como vacío
• Para usar modelos alternativos, deben admitir capacidades de uso de herramientas. Puede anular modelos con:

   export ANTHROPIC_DEFAULT_SONNET_MODEL="model-provider/model-name"
  

• Explore los modelos disponibles en openrouter.ai/models
• El nivel gratuito le da 50 solicitudes de API por día
• Consulte la guía oficial de OpenRouter para más detalles

Opción D. Usar la API de Anthropic a través de Azure Foundry

Esta opción es para organizaciones que usan modelos Claude alojados en Azure. En la ventana de Terminal, pegue este código para definir variables de entorno (antes de iniciar Claude):

# Enable Microsoft Foundry integration
export CLAUDE_CODE_USE_FOUNDRY=1
# Azure resource name
export ANTHROPIC_FOUNDRY_RESOURCE=xxxx-eastus2
# Set models to your resource's deployment names
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5
export ANTHROPIC_FOUNDRY_API_KEY=your_api_key

Nota: Reemplace xxxx-eastus2 con el nombre de su Recurso Foundry (no use la URL base completa). Reemplace your_api_key con su clave API completa de su portal de Azure.

Paso 4: Probar Claude Code

¡Ya está listo! Así se usa Claude Code:

• En Terminal, escriba:

   claude
  

• Le hará algunas preguntas antes de estar listo para conversar
• Para probar que funciona, haga una pregunta general como “Explain quantum computing.”

Paso 5: Navegar a Su Proyecto

• Si tiene un proyecto en las carpetas de su Mac, puede navegar a él:

   cd ~/Documents/test_claude
  

  Reemplace test_claude con el nombre real de su carpeta de proyecto

• Luego inicie Claude:

   claude
  

• Comience pidiéndole a Claude que explique la base de código.
• Puede pedirle a Claude que haga cambios.
• Pruebe su código en su IDE preferido.

Nota: Claude opera dentro de una carpeta de proyecto. Define permisos de escritura en la carpeta y guarda la configuración ahí. Es el espacio de trabajo de Claude.

Paso 6: Actualizar Claude Code

Claude Code instalado mediante el instalador nativo se actualiza automáticamente en segundo plano. También puede activar una actualización manualmente:

• En Terminal, escriba:

   sudo claude
  

• Claude Code buscará actualizaciones e instalará la versión más reciente

Nota: Las instalaciones de Homebrew no se actualizan automáticamente. Ejecute brew upgrade claude-code periódicamente para obtener la versión más reciente.

Próximos Pasos

• Primeros Pasos con VS Code - Aprenda a usar VS Code, un editor de código popular
• Claude Code en VS Code (Mac) - Ejecute Claude Code dentro de VS Code
• Escribir un Trabajo de Investigación con Claude Code - Use Claude Code para escritura académica

Cómo Abrir Terminal Nuevamente

Después de cerrar Terminal, así se abre de nuevo:

• Haga clic en el ícono Launchpad en su Dock (el ícono con cuadrados de colores)
• Escriba Terminal en el cuadro de búsqueda en la parte superior
• Haga clic en Terminal
• Se abrirá una ventana de Terminal

Solución de Problemas

Primer paso: Ejecutar Claude Doctor

Si algo no funciona, ejecute este comando primero:

claude doctor

Verifica su instalación e informa cualquier problema.

El script de instalación falla

• Asegúrese de tener macOS 13.0 o posterior
• Intente la alternativa con Homebrew: brew install --cask claude-code
• Verifique su conexión a Internet e intente nuevamente

Comandos de Claude Code no encontrados

• Cierre Terminal completamente (haga clic en Terminal en la barra de menú, luego Quit Terminal)
• Abra Terminal nuevamente
• Intente claude --version para verificar si está instalado
• Intente ejecutar el comando de instalación nuevamente: curl -fsSL https://claude.ai/install.sh | bash

La autenticación falla

• Asegúrese de tener una suscripción activa a Claude Pro/Max o una clave API válida
• Intente ejecutar claude nuevamente y complete el proceso de inicio de sesión
• Verifique que su navegador abrió la página de autorización correcta

Consejos para Usuarios de Mac

Encontrar Rutas de Proyectos

Para encontrar la ruta de una carpeta:

• Abra Finder
• Navegue a su carpeta de proyecto
• Arrastre y suelte la carpeta en Terminal: ¡la ruta completa aparecerá!

Usar Diferentes Aplicaciones de Terminal

También puede usar otras aplicaciones de terminal:

• iTerm2 (alternativa popular con más funciones)
• Warp (terminal moderna con funciones de IA)
• Hyper (terminal multiplataforma)

¡Claude Code funciona con todas ellas!

¿Necesita Ayuda?

• Para problemas con Claude Code: Claude Code GitHub
• Para documentación oficial de configuración: Guía de Configuración de Claude Code

Última actualización: Febrero 2026