Cómo instalar Claude Code con Homebrew en Mac (la forma más fácil)

¿Qué es Claude Code?

Claude Code es la herramienta oficial de línea de comandos (CLI) de Anthropic. Es un agente de IA que vive en tu terminal y puede:

Leer y editar archivos de tu proyecto
Ejecutar comandos en la terminal
Buscar en tu codebase
Hacer commits y pull requests
Debuggear errores
Crear proyectos completos desde cero

Básicamente, es como tener un programador senior dentro de tu terminal que entiende todo tu proyecto.

Opción 1: El Prompt (recomendada)

Esta es la forma más fácil. Copia el siguiente prompt y pégalo en tu chat de IA favorito (ChatGPT, Claude, Gemini, etc.). La IA te guiará paso a paso, en tiempo real, adaptándose a lo que vaya pasando en tu terminal.

Simplemente copia, pega y sigue las instrucciones:

text

Quiero instalar Claude Code en mi Mac usando Homebrew. Guíame paso a paso.

Mi situación:
- Tengo una Mac (dime si necesitas saber la versión de macOS)
- No sé si tengo Homebrew instalado
- Nunca he usado Claude Code

Lo que necesito que hagas:
1. Primero ayúdame a verificar si tengo Homebrew. Si no lo tengo, guíame para instalarlo.
2. Después instala Claude Code con brew.
3. Ayúdame a verificar que se instaló bien.
4. Guíame para autenticarme con mi cuenta de Anthropic.
5. Enséñame a usarlo en un proyecto.

Reglas:
- Dame UN comando a la vez. Espera a que te diga qué pasó antes de darme el siguiente.
- Si algo falla, ayúdame a solucionarlo antes de continuar.
- Explícame en español y de forma simple qué hace cada comando antes de que lo ejecute.
- Cuando termine, dame un resumen de los comandos que usamos.

¿Por qué un prompt? Porque si algo falla (y a veces pasa), la IA te ayuda a resolverlo en el momento. No te quedas atorado buscando en Google.

Opción 2: La guía manual paso a paso

Si prefieres seguir la guía por tu cuenta, aquí tienes todo el proceso.

Paso 0: Abrir la Terminal

Si nunca has abierto la terminal, no te preocupes. Es más fácil de lo que parece:

Presiona Cmd + Espacio (se abre Spotlight, la búsqueda de tu Mac)
Escribe Terminal
Presiona Enter

Se abrirá una ventana con fondo blanco o negro y texto que termina con un $ o %. Eso es tu terminal. Aquí es donde vas a escribir todos los comandos.

Tip: cada vez que veas un bloque de código en esta guía, cópialo (usa el botón de copiar arriba a la derecha del bloque) y pégalo en la terminal con Cmd + V, después presiona Enter.

Paso 1: Verificar si tienes Homebrew

Homebrew es como una "tienda de apps" para la terminal. Primero verifica si ya lo tienes:

bash

brew --version

Si ves algo como Homebrew 4.x.x → ya lo tienes, salta al Paso 2.

Si ves command not found: brew → necesitas instalarlo. Copia y pega este comando:

bash

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

La instalación tarda unos minutos. Te pedirá tu contraseña de Mac (la que usas para desbloquear tu computadora). Cuando escribas la contraseña no se ven los caracteres — es normal, solo escríbela y presiona Enter.

Cuando termine, verifica que se instaló bien:

bash

brew --version

Paso 2: Instalar Claude Code

Ahora sí, lo bueno. Ejecuta:

bash

brew install claude-code

Espera a que termine (unos 30 segundos). Para verificar:

bash

claude --version

Deberías ver algo como Claude Code v1.x.x.

Paso 3: Iniciar sesión

Escribe:

bash

claude

Se abrirá tu navegador automáticamente para que inicies sesión con tu cuenta de Anthropic. Si no tienes cuenta, créala en anthropic.com.

Autoriza el acceso y vuelve a la terminal — verás la confirmación de que estás conectado.

Paso 4: Usarlo en un proyecto

Navega a la carpeta de cualquier proyecto y lanza Claude Code:

bash

cd ~/Desktop/mi-proyecto
claude

Si no tienes un proyecto aún, puedes crear uno de prueba:

bash

mkdir ~/Desktop/prueba-claude && cd ~/Desktop/prueba-claude
claude

Ahora puedes hablarle en español directamente en la terminal:

text

> explícame qué hace este proyecto
> crea una página web simple con HTML y CSS
> crea un archivo README.md para este proyecto

Comandos útiles

Comando	Qué hace
`claude`	Inicia una sesión interactiva
`claude "tu pregunta"`	Hace una pregunta rápida sin sesión
`claude --help`	Muestra todas las opciones
`/help`	Dentro de la sesión, muestra comandos
`/clear`	Limpia el contexto de la conversación
`Esc` (doble)	Sale de Claude Code

Tips para sacarle el máximo provecho

1. Úsalo dentro de un repo de Git

Claude Code funciona mejor cuando está dentro de un repositorio Git. Puede ver el historial, hacer commits y crear PRs.

2. Sé específico en tus instrucciones

En vez de "mejora el código", di "refactoriza la función calculateTotal para que maneje el caso cuando el carrito está vacío".

3. Déjalo ejecutar comandos

Claude Code puede correr tests, instalar dependencias y ejecutar tu proyecto. Cuando te pida permiso para ejecutar un comando, revísalo y dale permiso.

4. Usa el archivo CLAUDE.md

Crea un archivo CLAUDE.md en la raíz de tu proyecto con instrucciones sobre tu stack y convenciones. Claude Code lo lee automáticamente:

markdown

# Mi Proyecto

## Stack
- Next.js 14 con App Router
- Tailwind CSS
- PostgreSQL con Prisma

## Convenciones
- Componentes en español
- Tests con Vitest
- Commits en español

Actualizar Claude Code

Para mantenerlo al día con las últimas mejoras:

bash

brew upgrade claude-code

Resumen rápido

bash

# 1. Instalar Homebrew (si no lo tienes)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. Instalar Claude Code
brew install claude-code

# 3. Autenticarse (se abre el navegador)
claude

# 4. Usarlo en cualquier proyecto
cd ~/mi-proyecto
claude

Cuatro comandos. Menos de 5 minutos. Ya tienes un agente de IA en tu terminal.

¿Te atoraste en algún paso? Copia el prompt de la Opción 1 y pégalo en tu chat de IA favorito — te guiará en tiempo real.