Guía de instalación de Claude Code en macOS con procesadores Apple Silicon

Requisitos previos

Se necesitan tres componentes fundamentales: Git, Visual Studio Code y Node.js ( requisito indirecto para Claude Code).

1. Instalación de Git

Dirígete al sitio oficial: https://git-scm.com/install/mac

Para acceder a la terminal en macOS, presiona Command + Espacio para abrir Spotlight, escribe "Terminal" y selecciona la aplicación.

Ejecuta el instalador desde la línea de comandos según las instrucciones del sitio oficial.

2. Instalación de Visual Studio Code

Descarga el instalador desde: https://code.visualstudio.com/Download

Selecciona la versión correspondiente a macOS ARM64 si tu equipo tiene chip de la familia M.

3. Instalación de Node.js mediante Homebrew

El paquete @anthropic-ai/claude-code se distribuye vía npm, por lo que primero necesitamos Node.js. Para gestionar Node, utilizaremos Homebrew como gestor de paquetes.

El script oficial de Homebrew puede tener problemas de conectividad según tu región. Una alternativa funcional es emplear un mirror alternativo:

# Instalar Homebrew usando un mirror alternativo
/bin/bash -c "$(curl -fsSL https://gitee.com/ineo6/homebrew-install/raw/master/install.sh)"

Este proceso puede tardar varios minutos. Es importante tener paciencia y no interrumpirlo.

Una vez completada la instalación de Homebrew, procede con la configuración de variables de entorno y la instalación de Node.js:

# Cargar el entorno de Homebrew en la sesión actual
eval "$(/opt/homebrew/bin/brew shellenv)"

# Instalar Node.js
brew install node

# Comprobar que la instalación fue exitosa
node --version
npm --version

Si ambos comandos devuelven un número de versión, la instalación se completó correctamente.

Instalación de Claude Code

Con Node.js y npm disponibles, instala Claude Code de forma global:

npm install -g @anthropic-ai/claude-code

Verifica la instalación con:

claude --version

Configuración de autenticación

Al ejecutar claude por primera vez, aparecerá un menú con tres opciones:

Selecciona método de inicio de sesión:

 ❯ 1. Cuenta Claude con suscripción · Pro, Max, Team o Enterprise
   2. Cuenta de Anthropic Console · Facturación por uso de API
   3. Plataforma de terceros · Amazon Bedrock, Microsoft Foundry o Vertex AI

Opción 1: Inicio de sesión con cuenta Claude mediante suscripción mensual. Consume los límites del plan contratado.
Opción 2: Autenticación mediante API key de Anthropic Console. Requiere cuenta en el extranjero y conexión mediante proxy.
Opción 3: Integración con proveedores cloud como AWS Bedrock o Google Vertex AI.

Integración con API de terceros (ej. DeepSeek)

Para conectar Claude Code con una API compatible como DeepSeek, no es necesario pasar por el menú de inicio de sesión. En su lugar, se deben configurar variables de entorno específicas antes de lanzar la herramienta.

Método permanente: Edita el archivo ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com",
    "ANTHROPIC_API_KEY": "tu_clave_aqui",
    "ANTHROPIC_MODEL": "deepseek-chat"
  }
}

Método temporal: Exporta las variables en la terminal antes de iniciar Claude Code:

export ANTHROPIC_BASE_URL="https://api.deepseek.com"
export ANTHROPIC_API_KEY="tu_clave_aqui"
export ANTHROPIC_MODEL="deepseek-chat"

claude

Con esta configuración activa, al ejeuctar claude se omitirá el menú de selección de cuenta y se conectará directamente al endpoint configurado, sin requerir redirecciones ni proxeis adicionales.

Etiquetas: Claude Code macos homebrew Node.js DeepSeek

Publicado el 6-27 21:25

Friki Work