Claude Code tutorial en español: guía completa desde cero

Claude Code es el agente de IA de Anthropic que programa por ti dentro de VS Code. En este tutorial en español aprenderás a instalarlo, configurarlo y usar sus funciones más potentes paso a paso, aunque nunca hayas usado IA para programar.

Qué es Claude Code

Claude Code no es un chatbot. Es un agente autónomo que lee tu proyecto completo, planifica, escribe código directamente en tus ficheros y ejecuta comandos en la terminal. La diferencia con ChatGPT o Claude.ai es que no copias y pegas: el agente actúa directamente sobre tu repositorio.

Instalación paso a paso

Necesitas Node.js 18 o superior y VS Code instalados. Después:

# 1. Instala el CLI
npm install -g @anthropic-ai/claude-code

# 2. Verifica la instalación
claude --version

# 3. Autentícate (se abre el navegador)
claude login

Para integrarlo en VS Code, busca "Claude Code" en el marketplace de extensiones (publicada por Anthropic) e instálala.

Primeros comandos

Abre tu proyecto en VS Code, abre la terminal integrada y escribe claude para entrar en modo interactivo. Prueba estos comandos:

# Pedirle que entienda tu proyecto
> Explícame la estructura de este proyecto en 5 puntos

# Crear código
> Crea una función para validar emails en src/utils/validation.js

# Arreglar un bug
> Hay un error en src/api.js línea 42, el ID no se parsea bien

Atajos clave: /help (ver comandos), /clear (limpiar contexto), Escape (interrumpir).

El fichero CLAUDE.md

Es el fichero más importante. Va en la raíz de tu proyecto y le da contexto permanente al agente. Un buen CLAUDE.md incluye:

## Stack
- Backend: Node.js + Express + TypeScript
- Base de datos: PostgreSQL
- Tests: Jest

## Comandos
- Arrancar: npm run dev
- Tests: npm test
- Build: npm run build

## Convenciones
- Nombres en inglés
- Cada función exportada necesita su test

Con esto, Claude entiende tu proyecto sin que se lo expliques cada vez. 5 minutos escribiendo CLAUDE.md te ahorran horas de correcciones.

Subagentes en paralelo: el truco estrella

Esta es la función que multiplica tu velocidad. Puedes pedirle a Claude que lance varios agentes a la vez para tareas independientes:

> Usa subagentes en paralelo para:
  1. Escribir tests del UserService
  2. Escribir tests del AuthService
  3. Documentar todas las funciones públicas
  Cada subagente trabaja en su directorio para no pisarse.

En lugar de hacer estas 3 tareas en serie (15 min), las hace en paralelo (~5 min).

Trucos para sacarle partido

• Usa /clear entre tareas distintas para no acumular contexto y gastar menos.
• Configura hooks para que ejecute los tests automáticamente tras cada cambio.
• Crea slash commands para tus tareas repetidas (revisión de código, generar tests).
• Conecta MCP Servers para que acceda a GitHub, tu base de datos o APIs externas.

Conclusión

Claude Code cambia radicalmente cómo programas. Con este tutorial ya tienes lo básico, pero si quieres dominarlo de verdad —subagentes, hooks, MCP, casos reales— hazlo con nuestro curso gratuito de Claude Code desde cero, con certificado al terminar.