Instalación

Requisitos previos

• Sistema operativo: macOS, Linux, o Windows (con WSL o nativo).
• Cuenta de Anthropic — una suscripción de Claude o una cuenta de la consola (console.anthropic.com).
• Node.js 20+ — solo si instalas por npm. Con el instalador nativo (recomendado) no hace falta.

Paso 1: Instalar Claude Code

Abre tu terminal y usa el instalador nativo (recomendado; no necesita Node.js y se actualiza solo):

# macOS, Linux o WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

En Mac también puedes usar Homebrew:

brew install --cask claude-code

Alternativa: con npm

Si prefieres npm (requiere Node.js 20+):

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

Cualquiera de los métodos instala el comando claude. Verifica que se instaló correctamente:

claude --version

Paso 2: Obtener tu API key

1. Entra a console.anthropic.com y crea una cuenta si no tienes.
2. Ve a API Keys en el panel lateral.
3. Haz clic en Create Key y copia la clave generada.
4. Guárdala en un lugar seguro — solo se muestra una vez.

Paso 3: Configurar la API key

Tienes dos opciones para configurar tu clave:

Opción A: Variable de entorno (recomendado)

Añade esto a tu ~/.zshrc, ~/.bashrc o equivalente:

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx"

Luego recarga tu shell:

source ~/.zshrc   # o ~/.bashrc

Opción B: Al iniciar Claude Code

Si no configuraste la variable, Claude Code te pedirá la clave la primera vez que lo ejecutes y la guardará automáticamente.

Paso 4: Primera ejecución

Navega a un directorio de trabajo y ejecuta:

cd mi-proyecto
claude

La primera vez te puede pedir autorizaciones o confirmar la clave. Después verás el prompt interactivo de Claude Code listo para usar.

Instalación en Windows

En Windows tienes dos caminos:

1. Nativo (más sencillo): abre PowerShell y ejecuta irm https://claude.ai/install.ps1 | iex. Se recomienda tener Git para Windows instalado para que Claude pueda usar Bash.
2. Con WSL2: instala WSL con wsl --install y luego instala Claude Code dentro de WSL igual que en Linux.

Actualizar Claude Code

Con el instalador nativo se actualiza solo en segundo plano: no tienes que hacer nada. Comprueba tu versión con:

claude --version

Con Homebrew: brew upgrade claude-code. Si instalaste por npm:

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

Desinstalar

Según cómo lo instalaste:

# Homebrew
brew uninstall --cask claude-code

# npm
npm uninstall -g @anthropic-ai/claude-code