Claude Code: la guía completa para usarlo de verdad bien

Hay muchos tutoriales de Claude Code que te acompañan durante la instalación y se detienen justo donde empieza el trabajo de verdad. Este es lo contrario: en Lasting Dynamics usamos Claude Code a diario en proyectos de cliente en producción y enseñamos agentic coding en nuestra academy, así que este curso cubre la parte que de verdad decide si la herramienta te hace más rápido — configuración, flujo de trabajo y hábitos.

Qué es Claude Code, en un párrafo

Claude Code es la herramienta de agentic coding de Anthropic. En lugar de completar líneas mientras escribes, trabaja como un colega en quien delegas: describes un resultado, y un agente planifica, lee tu codebase, edita archivos, ejecuta comandos y tests, e itera hasta terminar. Es primero terminal (con extensiones para IDE, app de escritorio y versión web disponibles), funciona con los modelos Claude y se extiende mediante servidores MCP, hooks, skills y subagents. El modelo mental clave: multiplica tu criterio de ingeniería — no lo sustituye.

Instalación: diez minutos, de verdad

npm install -g @anthropic-ai/claude-code
cd tu-proyecto
claude

(Anthropic también ofrece un instalador nativo si prefieres saltarte npm.) En el primer arranque te autenticas con una suscripción de Claude (Pro, o Max para uso intensivo) o con una API key.

Comandos que usarás desde el primer día:

• /init — analiza el proyecto y genera un CLAUDE.md inicial
• /help — la lista de comandos
• /clear — reinicia el contexto cuando cambias de tema
• claude --continue / --resume — retoma una sesión anterior

Y esto es literalmente todo lo que hay que instalar. Lo interesante viene después.

Paso 1: Escribe un CLAUDE.md que merezca leerse

CLAUDE.md es un archivo markdown en la raíz de tu repo que Claude Code carga al inicio de cada sesión. Es la diferencia entre hacer el onboarding de un fichaje brillante una sola vez y volver a explicar tu proyecto cada mañana.

Qué debe contener — exactamente lo que le contarías a un buen ingeniero en su primer día:

# Proyecto X

## Comandos
- build: `npm run build`
- test: `npm test`
- lint: `npm run lint`

## Convenciones
- TypeScript en modo strict, nada de `any`
- Los componentes de UI viven en src/components/ui
- Cambios en la DB SOLO vía prisma/migrations
- Todo bug fix empieza con un test que falla

## Límites
- No tocar src/legacy/** sin preguntar
- Ninguna dependencia nueva sin justificarla

Mantenemos CLAUDE.md como si fuera código: pasa por review, se actualiza cuando cambian las convenciones, y cuando el agente se equivoca de forma sistemática en algo, nuestra primera pregunta es "¿falta una línea en CLAUDE.md?"

Paso 2: Tómate los permisos en serio

Claude Code pregunta antes de hacer cosas potencialmente arriesgadas — ejecutar ciertos comandos, escribir fuera del proyecto, llamar a herramientas externas. Esas preguntas parecen fricción hasta el día en que una de ellas te salva.

La disciplina que enseñamos: lee qué está a punto de hacer, permite de forma permanente solo lo que es siempre seguro (el runner de tests, el linter, el build), y deja todo lo demás en modo preguntar. Cada solicitud de permiso es un punto de revisión gratuito sobre el plan del agente.

Paso 3: El flujo de trabajo de producción

Este es el bucle al que llegaron nuestros ingenieros tras meses de trabajo diario con clientes:

1. Briefs, no prompts. Contexto, restricciones, definición de hecho: "Añade validación de entrada a /apply. Usa zod como el resto del proyecto. La entrada inválida devuelve 400 en el formato de error estándar. Añade tests y haz que pasen." Ese brief le gana a cualquier prompt ingenioso.
2. Plan antes que código. En cualquier cosa no trivial, pide a Claude Code que presente primero su plan (el plan mode existe exactamente para esto) y revísalo como revisarías un enfoque en la standup. Rechazar un mal plan cuesta segundos; rechazar un mal diff cuesta una tarde.
3. Incrementos del tamaño de un commit. "Migra el módulo" se convierte en "migra este archivo, ejecuta sus tests, para". Los objetivos pequeños convergen; los enormes derivan.
4. Los tests son la correa. Un agente que puede verificar su trabajo itera hacia lo correcto; uno que no puede, adivina con mucha seguridad. Si tu suite de tests es floja, lo primero que hay que delegar es escribir tests.
5. Git como red de seguridad. Commits pequeños y frecuentes; cada incremento verificado entra. Claude Code es genuinamente bueno con git — aprovéchalo.
6. Revisa como si fuera tuyo — porque lo es. Cada línea asistida por AI se publica con tu nombre. "Lo escribió la AI" es una frase que no existe en un equipo serio.

Paso 4 (después, no al principio): MCP, skills, hooks, subagents

Cuando los fundamentos ya funcionan, la capa de extensión es donde Claude Code marca distancias:

• Los servidores MCP conectan al agente con tu mundo: bases de datos, navegadores, sistemas de tickets, APIs internas (claude mcp add).
• Las skills empaquetan procedimientos repetibles — runbooks de deploy, checklists de review — que se cargan bajo demanda.
• Los hooks ejecutan comandos automáticamente ante eventos (lint tras cada edición), convirtiendo convenciones en restricciones que el agente no puede olvidar.
• Los subagents se encargan de tareas acotadas (explora este codebase, investiga esa pregunta) en paralelo, sin contaminar tu contexto principal.

Consejo honesto: no empieces por aquí. El noventa por ciento del valor está en un buen CLAUDE.md, briefs precisos y tests fiables. Las extensiones multiplican un flujo de trabajo que funciona; no arreglan uno roto.

Qué cuesta

Claude Code viene incluido con las suscripciones de Claude (Pro para uso regular, Max para uso intensivo) o funciona con pago por uso sobre tokens de API. Las sesiones agénticas largas en codebases grandes consumen tokens de verdad, así que el uso profesional diario casi siempre favorece la suscripción.

El coste que nadie pone en el presupuesto: tu tiempo de review. Una herramienta que genera código más rápido de lo que puedes revisarlo con responsabilidad no te ha hecho más rápido — ha movido el cuello de botella y lo ha escondido.

Los cinco errores que todo el mundo comete

1. Objetivos vagos en codebases grandes — el agente toma decisiones razonables que tú no querías, a escala. La precisión es la cura.
2. Sesiones maratonianas sin /clear — el contexto se llena de ruido y la calidad cae. Tema nuevo, contexto nuevo.
3. Aprobar todos los permisos para ir más rápido — ver el Paso 2.
4. Usarlo para no entender — el código que no entiendes hoy es el bug que no puedes arreglar dentro de tres meses. Si el resultado no está claro, pide al agente que te lo explique (se le da muy bien) en lugar de aceptar y seguir.
5. Juzgarlo con una prueba de cinco minutos — como toda herramienta profesional, el valor aparece con práctica deliberada.

La mejor forma de aprender Claude Code

Los comandos se aprenden en una tarde. Lo que lleva más tiempo es el criterio que hace potente a la herramienta: reconocer cuándo un diff plausible está mal, especificar el trabajo con precisión, saber qué testear, saber qué aspecto tiene una buena arquitectura. Las herramientas agénticas han hecho más fácil que nunca producir código que no entiendes — y han hecho dramáticamente más productivos a los ingenieros que sí entienden.

Esa es la apuesta sobre la que está construida la Lasting Dynamics Academy: llevamos diez años formando a los ingenieros que después contratamos, y hoy el trabajo práctico con agentic AI está en el curriculum sobre los fundamentos — arquitectura, patrones de diseño, testing — con tareas reales revisadas cada semana por un mentor. Es gratis, totalmente en remoto, selectiva, y todo el que la completa recibe una oferta de trabajo. Si este tutorial encaja con cómo quieres trabajar, así es exactamente como se enseña el programa de agentic coding — y la próxima cohorte está abierta.

FAQ

¿Claude Code o Cursor — cuál elijo? Herramientas distintas para formas de tarea distintas; muchos de nuestros ingenieros usan las dos a diario. Si puedes describir el resultado pero no las ediciones, Claude Code; si ya ves las ediciones en tu cabeza, un editor con AI. Comparativa completa desde nuestra experiencia en producción: Claude Code vs Cursor.

¿Necesito saber programar para usarlo? Para jugar, no. Para trabajar, sí — y cuanto mejor seas, más rinde. Sin el criterio para revisar lo que produce, estás acumulando código que no puedes mantener.

¿Funciona en codebases legacy grandes? Es uno de sus puntos fuertes — exploración, refactors largos, migraciones. La regla de los incrementos del tamaño de un commit cuenta doble ahí, y necesitas una suite de tests en la que confíes.

¿Cuánto tardo en ser productivo? Con un CLAUDE.md sólido y el flujo de trabajo de arriba: días. El dominio de verdad — el que multiplica — llega con práctica deliberada y con la review de alguien más experto. Precisamente para eso existe la academy.