Claude Code en 30 minutos: instala, configura y completa tu primera tarea real

Lo que vas a aprender

Al terminar este tutorial habrás instalado Claude Code, lo habrás configurado correctamente y habrás completado tu primera tarea real de programación con él. No ejercicios de práctica — una tarea en un proyecto que te importe.

Paso 1 — Instalación (5 minutos)

Abre tu terminal y ejecuta:

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

Verifica que se instaló:

claude --version

Si ves el número de versión, estás listo. Si hay un error, asegúrate de tener Node.js 18 o superior:

node --version

Paso 2 — Autenticación (3 minutos)

Navega a cualquier carpeta y ejecuta:

claude

La primera vez te pedirá que te autentiques. Sigue las instrucciones en pantalla para vincular tu cuenta de Claude.ai. Necesitas un plan Pro o Team — el plan gratuito no incluye Claude Code.

Una vez autenticado, verás el prompt de Claude Code esperando tu primera instrucción.

Paso 3 — Elige tu proyecto (2 minutos)

Sal de Claude Code con Ctrl+C y navega a un proyecto tuyo real:

cd /ruta/a/tu/proyecto
claude

Importante: No uses un directorio vacío. Claude Code es más útil cuando tiene código que leer y entender.

Paso 4 — Primera instrucción: exploración

Antes de pedir cambios, pídele que entienda el proyecto:

Explícame qué hace este proyecto, cómo está organizado y qué stack tecnológico usa.

Claude Code explorará los archivos y te dará un resumen. Esto te sirve para dos cosas: ver si entiende tu proyecto correctamente y darte cuenta de qué contexto falta que deberías añadir al CLAUDE.md.

Paso 5 — Tu primera tarea real

Ahora dale una tarea concreta. Ejemplos según tu nivel:

Si tienes una tarea pendiente:

Necesito implementar [describe la funcionalidad].
Los requisitos son: [lista los requisitos].
Asegúrate de que los tests pasan después.

Si no sabes por dónde empezar:

Revisa el código y dime cuáles son las 3 mejoras más importantes
que harías en términos de calidad y mantenibilidad. Luego implementa la primera.

Si tienes un bug conocido:

Tengo un bug: [describe el comportamiento incorrecto].
El error que aparece es: [pega el mensaje de error completo].
Encuéntralo y corrígelo.

Comandos que usarás desde el primer día

• /help — Lista todos los comandos disponibles
• /clear — Borra el contexto. Úsalo cuando cambias de tarea
• /compact — Comprime el historial cuando la sesión se hace larga
• /cost — Muestra el gasto en tokens de la sesión actual
• Ctrl+C — Interrumpe una tarea que está tardando demasiado
• Ctrl+C dos veces — Sale de Claude Code

El error más común de los principiantes

Dar instrucciones vagas: "mejora este código" o "arregla el bug". Claude Code funciona mucho mejor con objetivos específicos y contexto suficiente.

En lugar de: "el login no funciona"

Mejor: "cuando el usuario introduce credenciales correctas, la página se recarga en lugar de redirigir al dashboard. El error en consola es: [error]. El login está en src/app/login/page.tsx"

Siguiente paso

Una vez tengas esta base, el siguiente tutorial te enseña a crear el CLAUDE.md que transformará cada sesión futura con Claude Code en algo mucho más productivo.