Inicio/Instalación

📦 Instalación

Instala Claude Code en tu sistema en un par de minutos. Solo necesitas una cuenta de Anthropic (suscripción de Claude o cuenta de la consola).

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.
El método recomendado por Anthropic es el instalador nativo, que no depende de Node.js y se actualiza solo. Si prefieres npm, necesitarás Node.js 20+ (descárgalo desde nodejs.org, versión LTS).

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.
Atención: Las API keys tienen costos por uso. Anthropic ofrece créditos gratuitos al registrarse. Revisa los precios en anthropic.com/pricing.

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.
Claude Code también tiene extensión para VS Code y JetBrains IDE — las instalas desde el marketplace de tu editor. Ver sección de configuración para más detalles.

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
← InicioPrimeros pasos →