Cómo Instalar Claude Code en 2026: Guía Paso a Paso

Claude Code es el CLI de Anthropic que te da un AI senior directo en tu terminal. En esta guía te muestro exactamente cómo instalarlo en cualquier sistema operativo - sin vueltas, paso a paso.

Lo uso todos los días en producción. Esta instalación toma 5 minutos si seguís los pasos correctos.

Requisitos Previos

Antes de instalar Claude Code, necesitás tres cosas:

1. Node.js 18 o superior

Claude Code corre sobre Node.js. Verificá tu versión actual:

node --version

Si no tenés Node.js o tu versión es menor a 18, descargalo de nodejs.org (recomiendo la versión LTS).

Tip: En Mac con Homebrew podés instalarlo así:

brew install node

En Ubuntu/Debian:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

2. API Key de Anthropic

Para usar Claude Code necesitás una API key de Anthropic. Si no tenés una:

Andá a console.anthropic.com
Creá una cuenta o logueate
En el dashboard, andá a "API Keys"
Creá una nueva key y copiala (no la vas a poder ver de nuevo)

Importante: Guardá esta key en un lugar seguro. La vas a necesitar en la configuración inicial.

3. Terminal

Cualquier terminal funciona:

Mac: Terminal, iTerm2, o Warp
Linux: Tu terminal preferida (bash, zsh, fish)
Windows: WSL, Git Bash, o PowerShell

Instalación con npm (Método Principal)

Esta es la forma más directa. Funciona en Mac, Linux y Windows (con WSL o Git Bash).

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

Verificá que se instaló correctamente:

claude --version

Deberías ver algo como claude-code v1.x.x.

Si te da error de permisos, saltá a la sección de troubleshooting más abajo.

Instalación con Homebrew (Mac)

Si usás Homebrew en Mac, hay una forma aún más simple:

brew install claude-code

Homebrew maneja las dependencias automáticamente. Después de instalar:

claude --version

Ventaja de Homebrew: Las actualizaciones son más fáciles con brew upgrade claude-code.

Instalación en Windows

Windows tiene tres opciones. Te las ordeno de mejor a peor.

Opción 1: WSL (Recomendado)

WSL (Windows Subsystem for Linux) es la mejor experiencia. Claude Code funciona igual que en Linux nativo.

Instalar WSL:

wsl --install

Reiniciá tu PC cuando te lo pida. Después abrí Ubuntu desde el menú inicio.

Dentro de WSL:

# Instalar Node.js
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
 
# Instalar Claude Code
npm install -g @anthropic-ai/claude-code
 
# Verificar
claude --version

Por qué WSL es mejor: Tenés acceso a todo el ecosistema de herramientas Unix. Los paths son más predecibles. Menos problemas con permisos.

Opción 2: Git Bash

Si ya usás Git para Windows, tenés Git Bash instalado.

Instalá Node.js desde nodejs.org (Windows installer)
Abrí Git Bash
Ejecutá:

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

Funciona bien para la mayoría de casos, pero algunos comandos avanzados pueden dar problemas.

Opción 3: PowerShell Nativo

Funciona, pero con limitaciones.

Instalá Node.js desde nodejs.org
Abrí PowerShell como administrador
Ejecutá:

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

Advertencia: Algunos features de Claude Code asumen una shell Unix. Vas a encontrar edge cases que no funcionan bien.

Configuración Inicial

Ya tenés Claude Code instalado. Ahora lo configuramos.

Autenticación con API Key

La primera vez que ejecutes Claude Code, te va a pedir autenticación:

claude

Te va a dar dos opciones:

Login con cuenta de Anthropic (browser)
Usar API key directamente

Para API key, elegí la segunda opción y pegá tu key cuando te la pida.

Alternativa: Podés setear la key como variable de entorno:

# Agregá a tu .bashrc o .zshrc
export ANTHROPIC_API_KEY="sk-ant-xxxxx"

Después de guardar, recargá tu shell:

source ~/.bashrc  # o source ~/.zshrc

Verificar que Todo Funciona

Probá con un comando simple:

claude "hola mundo"

Si ves una respuesta de Claude, estás listo.

Tu Primer Comando Real

Ahora probá algo útil. Navegá a un proyecto de código y ejecutá:

cd tu-proyecto
claude "explicame la estructura de este proyecto"

Claude va a leer los archivos y darte un overview de la arquitectura.

Troubleshooting Común

Error: EACCES permission denied

Este es el error más común en npm global.

Solución 1: Usar un prefix diferente para npm

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Ahora volvé a instalar:

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

Solución 2: Usar nvm (Node Version Manager)

# Instalar nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
 
# Reiniciar terminal y después:
nvm install 20
nvm use 20
 
# Ahora instalá Claude Code
npm install -g @anthropic-ai/claude-code

Por qué funciona: nvm instala Node.js en tu home directory, sin necesidad de sudo.

Error: Node version mismatch

Si te dice que tu versión de Node.js es muy vieja:

# Verificá tu versión
node --version
 
# Si es menor a 18, actualizá

En Mac con Homebrew:

brew upgrade node

En Ubuntu/Debian:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Con nvm:

nvm install 20
nvm use 20
nvm alias default 20

Error: API key invalid

Tres cosas para verificar:

La key está bien copiada (sin espacios extra al principio o final)
Tu cuenta tiene créditos (andá a console.anthropic.com y verificá)
La key no está revocada (creá una nueva si hace falta)

Para resetear la configuración:

claude config clear

Después volvé a ejecutar claude y autenticate de nuevo.

Error: Command not found: claude

El binario no está en tu PATH.

Verificá dónde se instaló:

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

Agregá al PATH si hace falta:

# Encontrá el prefix de npm
npm config get prefix
 
# Agregá el bin folder a tu PATH
echo 'export PATH=$(npm config get prefix)/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Próximos Pasos

Ya tenés Claude Code instalado y funcionando. Ahora viene lo bueno.

Aprendé a Usarlo de Verdad

No alcanza con instalar - tenés que saber cómo sacarle jugo. Armé un curso gratuito paso a paso:

Claude Code Mastery - Curso Gratis

Incluye:

Workflow diario que uso en producción
Sistema CLAUDE.md para que nunca pierda contexto
Sub-agentes para testing y code review automático
Hooks para automatizar tareas repetitivas

Recibí Tips Semanales

Cada semana mando workflows, prompts y lecciones que no publico en ningún otro lado.

Leé la Guía Completa

Si querés ir más profundo ahora mismo:

Guía Completa de Claude Code en Español

Cubre todo desde configuración inicial hasta workflows avanzados con múltiples agentes en paralelo.

Resumen

Instalación en 3 pasos:

Node.js 18+ instalado
npm install -g @anthropic-ai/claude-code
Autenticar con claude y tu API key

Troubleshooting:

Permisos: usar nvm o cambiar npm prefix
Versión de Node: actualizar a 18+
API key: verificar en console.anthropic.com

Windows: Usá WSL para la mejor experiencia.

Cualquier duda, respondeme en Twitter @maxtechera.

Instalación funciona. Ahora a buildear cosas reales.