Instalá Claude Code en tu terminal — paso a paso (Windows y Mac)

Qué vas a lograr en 5 minutos#

Claude Code corriendo en tu terminal: un agente de IA que lee tu proyecto, edita archivos y ejecuta comandos por vos. Esta guía cubre Mac y Windows, desde cero hasta verificar que todo funciona.

No necesitás saber programar para seguirla. Solo copiar y pegar comandos.

Paso 0 — Verificá los requisitos#

⚠️ El plan Free de claude.ai no incluye Claude Code. Si todavía no tenés plan, mirá cuál plan Claude antes de empezar.

Instalación en Mac#

Paso 1 — Abrí la Terminal#

Cmd + Espacio → escribí "Terminal" → Enter.

Paso 2 — Pegá el comando de instalación#

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

Eso descarga e instala el binario oficial. Tarda menos de un minuto.

Alternativa si usás Homebrew:

brew install --cask claude-code

Paso 3 — Cerrá y volvé a abrir la Terminal#

Así se recarga el PATH y el comando claude queda disponible.

Instalación en Windows#

Paso 1 — Abrí PowerShell#

Win + X → "Terminal" (o buscá "PowerShell" en el menú Inicio). No hace falta abrirlo como administrador.

Paso 2 — Pegá el comando de instalación#

irm https://claude.ai/install.ps1 | iex

Alternativa con WinGet:

winget install Anthropic.ClaudeCode

Si usás CMD en vez de PowerShell:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Paso 3 — Instalá Git for Windows (recomendado)#

Claude Code funciona sin esto, pero con Git for Windows desbloquea su herramienta Bash completa.

Descargalo de git-scm.com/downloads/win, instalalo con las opciones por defecto, y verificá con:

git --version

Paso 4 — Cerrá y volvé a abrir la terminal#

Igual que en Mac: recarga el PATH.

💡 ¿Y WSL? Es opcional. Claude Code corre nativo en Windows. Si ya vivís en WSL 2, instalalo dentro de la terminal de WSL con el comando de Mac/Linux.

⛔ El método que NO tenés que usar#

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

Si venís de un tutorial viejo de YouTube, frená: el método npm quedó deprecado. Usá el instalador nativo (curl/irm) o el package manager de tu sistema. Bonus: el instalador nativo se auto-actualiza solo.

Primer arranque y login (igual en Mac y Windows)#

Paso 1 — Entrá a una carpeta de proyecto#

cd ruta/a/tu/proyecto

¿No tenés ninguno? Creá uno vacío:

mkdir mi-primer-proyecto && cd mi-primer-proyecto

Paso 2 — Arrancá Claude Code#

claude

Paso 3 — Hacé login#

La primera vez se abre el navegador para autenticarte:

1. Elegí Claude account si tenés plan Pro/Max/Team (lo más común)
2. O Console account si vas a pagar por API
3. Confirmá en el navegador y volvé a la terminal

El login queda guardado: no lo repetís nunca más.

Paso 4 — Probalo#

Escribile en español, como a una persona:

explicame qué hay en este proyecto

Si te responde, ya está. Tenés un agente de IA en tu terminal.

Verificación — 2 comandos#

Si claude doctor no marca errores, tu entorno quedó perfecto.

Cómo actualizar#

¿Querés forzar una actualización ya? claude update.

Si algo falla#

"command not found: claude" / "no se reconoce el comando"#

Cerrá y volvé a abrir la terminal (el 90% de las veces es esto). Si persiste en Windows, reiniciá la PC para que tome el PATH nuevo.

El login no abre el navegador#

Copiá la URL que aparece en la terminal y pegala a mano en el navegador.

"Country not supported"#

Anthropic no opera en todos los países. Verificá la lista en anthropic.com/supported-countries.

Cualquier otra cosa#

claude doctor

Te dice exactamente qué está mal antes de que pierdas tiempo adivinando.

Próximos pasos#

• Configurá Claude Code desde cero con buenas prácticas: setup zero
• Aprendé a pedirle las cosas bien desde el día 1: hablarle a Claude
• ¿Terminal no es lo tuyo? También existe la app desktop: guía completa de instalación

Fuentes oficiales#

• Setup: code.claude.com/docs/en/setup
• Quickstart: code.claude.com/docs/en/quickstart
• Planes: claude.ai/pricing