How to Install Claude Code Step by Step

Requisitos detallados

Instalar Claude Code (Anthropic) lleva 2 minutos. Solo necesitas dos cosas:

• Node.js 18+ instalado (nodejs.org)
• Cuenta Anthropic con plan Max (20 USD/mes) o Team

Antes de instalar, verifica que tienes espacio en disco. Claude Code en sí ocupa poco (menos de 100 MB), pero npm puede necesitar espacio para dependencias. Asegúrate de tener al menos 500 MB libres.

También necesitarás una conexión a internet estable. Claude Code se comunica con los servidores de Anthropic en tiempo real. Si trabajas en una red corporativa con proxy, puede que necesites configurar npm para pasar a través del proxy (más sobre esto en la sección de errores).

Si usas nvm (Node Version Manager), que es lo recomendado para gestionar múltiples versiones de Node:

# Instalar la versión LTS más reciente
nvm install --lts

# Verificar
node --version  # Debería mostrar v20.x o superior

# Establecer como versión por defecto
nvm alias default node

Requisitos por sistema operativo

Claude Code funciona en los tres sistemas operativos principales, pero cada uno tiene sus particularidades:

macOS: la plataforma donde mejor funciona. Requisitos mínimos: macOS 12 (Monterey) o superior, 4 GB de RAM (8 GB recomendados). Terminal nativa (Terminal.app o iTerm2). Si no tienes Node.js, la forma más rápida es instalarlo con Homebrew: brew install node.

Windows: funciona tanto en PowerShell/CMD como en WSL2. Recomendación: usa WSL2 (Windows Subsystem for Linux). La experiencia es significativamente mejor porque Claude Code está optimizado para entornos Unix. Requisitos: Windows 10 versión 2004+ o Windows 11, 8 GB de RAM (WSL2 consume memoria adicional). Si usas PowerShell nativo, algunas operaciones de filesystem pueden ser más lentas.

Linux: funciona sin problemas en cualquier distribución moderna. Ubuntu 20.04+, Debian 11+, Fedora 36+, Arch (rolling). Requisitos mínimos: 4 GB de RAM, Node.js 18+ instalado desde NodeSource o nvm.

Instalación (1 comando)

# Instalar Claude Code globalmente
npm install -g @anthropic-ai/claude-code

# Verificar que se instaló correctamente
claude --version

Eso es todo. Un comando. Si ves el número de versión, Claude Code está instalado. For more details, check our guide on CLAUDE.md: guía completa para configurar Claude Code.

La instalación global (-g) significa que el comando claude estará disponible desde cualquier directorio de tu terminal. No necesitas instalarlo por proyecto.

Verificar la instalación

Después de instalar, ejecuta estas comprobaciones para asegurarte de que todo funciona:

# 1. Verificar versión
claude --version
# Debería mostrar algo como: claude-code 1.x.x

# 2. Verificar que el binario está en el PATH
which claude
# Debería mostrar: /usr/local/bin/claude o ~/.npm-global/bin/claude

# 3. Verificar Node.js (Claude Code lo necesita)
node --version
# Debería mostrar v18.x o superior

# 4. Verificar npm
npm --version
# Debería mostrar 9.x o superior

Si which claude no devuelve nada, el binario no está en tu PATH. Esto pasa frecuentemente cuando npm instala en un directorio que no está en tu PATH. Solución en la sección de errores.

Tu primera sesión

# Navegar a tu proyecto
cd mi-proyecto

# Iniciar Claude Code
claude

La primera vez te redirige al navegador para autenticarte con tu cuenta de Anthropic. Después de eso, ya puedes empezar a trabajar.

Prueba algo simple para verificar:

claude "qué archivos hay en este directorio?"

Si Claude Code responde listando los archivos de tu directorio, todo funciona correctamente. A partir de aquí puedes pedirle tareas más complejas: "lee el archivo package.json y dime qué dependencias están desactualizadas", "busca todos los archivos que importan esta librería", o "crea un test para esta función".

Configurar .claude/

El directorio .claude/ es donde configuras Claude Code para tu proyecto. Lo más importante es el archivo CLAUDE.md.

# Crear el directorio de configuración
mkdir -p .claude

# Crear CLAUDE.md con instrucciones básicas
cat > CLAUDE.md << 'EOF'
# Mi Proyecto

## Stack
- Python 3.11 + FastAPI
- PostgreSQL

## Reglas
- Tests obligatorios para cada feature
- Commits en español
- Sin console.log en producción
EOF

Con esto, Claude Code ya sabe qué proyecto es, qué stack usa y qué reglas seguir. Para la guía completa de .claude/, lee qué es Claude Code.

El directorio .claude/ también puede contener un archivo settings.json para configuración avanzada: servidores MCP, permisos de herramientas y preferencias del proyecto. Pero para empezar, solo necesitas el CLAUDE.md.

Crear tu primer CLAUDE.md

El archivo CLAUDE.md es lo que convierte a Claude Code de un asistente genérico a un miembro del equipo que conoce tu proyecto. Este archivo se carga automáticamente al inicio de cada sesión y proporciona contexto persistente.

Un CLAUDE.md efectivo incluye:

# Nombre del Proyecto

## Descripción
Aplicación web de gestión de inventarios para restaurantes.
Multi-tenant. Cada restaurante ve solo sus datos.

## Stack técnico
- Backend: FastAPI (Python 3.11)
- Frontend: Next.js 14 (App Router)
- Base de datos: Supabase (PostgreSQL con RLS)
- Deploy: Cloudflare Pages (frontend) + Hetzner (backend)

## Estructura del proyecto
- /backend — API FastAPI
- /frontend — Next.js app
- /shared — tipos y schemas compartidos

## Convenciones
- Tests: pytest para backend, vitest para frontend
- Commits: mensajes en español, formato convencional
- Ramas: feature/nombre, fix/nombre, chore/nombre
- PR: siempre a develop, nunca directo a main

## Reglas importantes
- RLS obligatorio en TODAS las tablas
- Sin console.log en producción
- Cada endpoint nuevo necesita test
- Las migraciones van en /backend/migrations/

## Contexto de negocio
- Clientes: restaurantes con 1-5 locales
- Usuarios: gerentes y personal de cocina
- Idioma de la app: español

La diferencia en calidad de output entre usar Claude Code con y sin CLAUDE.md es enorme. Sin él, Claude genera código genérico. Con él, genera código que sigue las convenciones de tu proyecto, usa el stack correcto y respeta las reglas del equipo.

Puedes tener un CLAUDE.md en la raíz del proyecto (para reglas específicas del proyecto) y otro en ~/.claude/CLAUDE.md (para reglas globales que aplican a todos tus proyectos). Claude Code combina ambos automáticamente.

Mac, Windows y Linux

Mac

# Con Homebrew (si no tienes Node)
brew install node
npm install -g @anthropic-ai/claude-code

En Mac con Apple Silicon (M1/M2/M3/M4), la instalación funciona de forma nativa. No necesitas Rosetta. Si usas un Mac Intel, también funciona sin configuración especial.

Windows

Opción recomendada: WSL2 (Windows Subsystem for Linux).

# En WSL2 (Ubuntu)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g @anthropic-ai/claude-code

También funciona en PowerShell/CMD nativo, pero WSL2 da mejor experiencia.

Si no tienes WSL2 instalado, estos son los pasos:

# En PowerShell como administrador
wsl --install

# Reiniciar el equipo
# Después del reinicio, configurar usuario y contraseña de Ubuntu
# Luego instalar Node.js y Claude Code como se indica arriba

Linux

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g @anthropic-ai/claude-code

# Fedora/RHEL
sudo dnf install nodejs
npm install -g @anthropic-ai/claude-code

# Arch Linux
sudo pacman -S nodejs npm
npm install -g @anthropic-ai/claude-code

Tu primer proyecto con Claude Code

Ya tienes Claude Code instalado. Vamos a usarlo en un proyecto real. Si no tienes un proyecto existente, crea uno de prueba:

# Crear un proyecto de prueba
mkdir mi-primer-proyecto && cd mi-primer-proyecto
git init
echo "# Mi primer proyecto con Claude Code" > README.md
git add . && git commit -m "init"

# Crear CLAUDE.md
cat > CLAUDE.md << 'EOF'
# Mi primer proyecto
Proyecto de prueba para aprender Claude Code.
Stack: HTML + CSS + JavaScript vanilla.
EOF

# Iniciar Claude Code
claude

Ahora prueba estas instrucciones para familiarizarte:

# Pedido 1: Crear una página web
"Crea un index.html con una landing page simple
para una cafetería. Incluye sección hero, menú
con 5 items y formulario de contacto."

# Pedido 2: Añadir funcionalidad
"Añade JavaScript para validar el formulario:
nombre obligatorio, email con formato válido,
mensaje de al menos 10 caracteres."

# Pedido 3: Mejorar estilo
"Mejora el CSS: diseño responsive, tipografía
profesional, colores cálidos para una cafetería."

Observa cómo Claude Code no solo genera el código sino que lo escribe directamente en los archivos de tu proyecto. Lee los archivos existentes para mantener coherencia y te pide confirmación antes de ejecutar cambios significativos.

Errores comunes y soluciones

Si necesitas más herramientas conectadas después de instalar, la guía de MCP te explica cómo conectar GitHub, bases de datos y más.

FAQ