Cómo instalar Claude Code

Contexto

Claude Code es la herramienta CLI de Anthropic que permite trabajar con Claude directamente desde la terminal. Edita archivos, ejecuta comandos, gestiona flujos git y navega tu código mediante instrucciones en lenguaje natural. Está disponible como terminal CLI, extensión de VS Code, plugin de JetBrains, app de escritorio y GitHub Actions.

Este artículo cubre exclusivamente la instalación de la CLI. Claude Code requiere una suscripción paga (Pro, Max, Team o Enterprise), una cuenta de Anthropic Console, o acceso a través de un proveedor cloud como Amazon Bedrock, Google Vertex AI o Microsoft Foundry. El plan gratuito de Claude.ai no incluye acceso.

Configuración / setup

Requisitos del sistema

Cuenta requerida

Necesitas uno de estos tipos de cuenta:

• Claude Pro, Max, Team o Enterprise — recomendado para uso individual o en equipo
• Anthropic Console — acceso a la API con créditos prepagados
• Amazon Bedrock, Google Vertex AI o Microsoft Foundry — para empresas con infraestructura cloud existente

Métodos de instalación

Native Install (recomendado)

Es el método oficial. El binario se actualiza automáticamente en segundo plano.

macOS, Linux, WSL:

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

Windows PowerShell:

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

Windows CMD:

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

Tras la instalación, el binario queda en ~/.local/bin/claude. Si el comando claude no se encuentra, agrega ese directorio a tu PATH:

# Zsh (macOS por defecto)
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc
source ~/.zshrc
 
# Bash (Linux por defecto)
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc
source ~/.bashrc

En Windows, el instalador lo agrega automáticamente al PATH. Si no funciona, agrega %USERPROFILE%\.local\bin a las variables de entorno del sistema.

Homebrew (macOS)

brew install --cask claude-code

Homebrew ofrece dos casks: claude-code (stable, ~1 semana de retraso) y claude-code@latest (canal más reciente). Las instalaciones con Homebrew no se autoactualizan. Para actualizar:

brew upgrade claude-code
# o
brew upgrade claude-code@latest

WinGet (Windows)

winget install Anthropic.ClaudeCode

Tampoco se autoactualiza. Ejecuta winget upgrade Anthropic.ClaudeCode periódicamente.

npm

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

Requiere Node.js 18+. El paquete npm descarga el binario nativo a través de dependencias opcionales por plataforma. No uses sudo npm install -g. Para actualizar:

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

Nota: Aunque npm sigue siendo funcional, Anthropic recomienda el Native Install. El método npm no se autoactualiza y requiere Node.js.

Linux package managers

# Debian/Ubuntu (apt)
sudo apt install claude-code
 
# Fedora/RHEL (dnf)
sudo dnf install claude-code
 
# Alpine (apk)
apk add claude-code

Autenticación

Una vez instalado, ejecuta claude desde la terminal en el directorio de tu proyecto:

cd mi-proyecto
claude

En el primer inicio se abrirá un navegador para que inicies sesión con tu cuenta de Anthropic. Las credenciales se almacenan localmente en ~/.claude/. Si estás en una máquina remota (SSH), presiona c en el prompt de login para copiar la URL de autenticación y ábrela en el navegador de tu máquina local.

Para usar una API key en entornos sin navegador (servidores, Docker, CI/CD):

export ANTHROPIC_API_KEY=tu-api-key
claude

Ejemplos

Verificar la instalación

claude --version

Debe mostrar la versión instalada (ej: 2.1.148).

Diagnosticar problemas

claude doctor

Ejecuta un chequeo automatizado del estado de la instalación, configuración, servidores MCP y uso de contexto.

Primer uso

cd mi-proyecto
claude

Dentro de la sesión interactiva puedes empezar a dar instrucciones directamente:

> ¿Qué hace este proyecto?
> Explícame la función main
> Agrega tests para el módulo de usuarios

Uso no interactivo

claude -p "Dame un resumen del README"

Cambiar de cuenta

# Dentro de una sesión interactiva
/login

Particularidades

Auto-actualización: Solo el Native Install se actualiza automáticamente. Homebrew, WinGet y npm requieren comandos manuales.

Node.js: Ya no es un requisito obligatorio. El Native Install y los gestores de paquetes del sistema instalan un binario autónomo que no necesita Node.js. Solo el método npm requiere Node.js 18+.

Windows: Git for Windows es muy recomendable para que Claude Code pueda usar el Bash tool. Sin él, usará PowerShell como shell alternativo. Los usuarios de WSL no necesitan Git for Windows.

Alpine Linux: El binario de ripgrep incluido puede fallar en sistemas musl. Si la búsqueda de archivos no funciona, instala ripgrep del sistema y configura la variable de entorno:

apk add ripgrep
export USE_BUILTIN_RIPGREP=0

Proxy corporativo: Si estás detrás de un proxy, configura las variables HTTP_PROXY y HTTPS_PROXY en el entorno. El proxy puede interferir con la autenticación OAuth.

ANTHROPIC_API_KEY conflictiva: Si tienes la variable ANTHROPIC_API_KEY definida en tu perfil de shell (posiblemente de un proyecto anterior), Claude Code la usará en lugar de la autenticación OAuth de tu suscripción. Si ves errores 400 "organization disabled", revisa tus archivos ~/.zshrc, ~/.bashrc o ~/.profile y elimina cualquier export ANTHROPIC_API_KEY=....

Desinstalación:

# Native Install
claude uninstall
 
# Homebrew
brew uninstall --cask claude-code
 
# npm
npm uninstall -g @anthropic-ai/claude-code