Dominar Claude Code

Un agente es tan bueno como lo que usted le da

Un modelo responde a partir de lo que puede ver. Si le da los datos correctos, la cantidad adecuada de reflexión, una manera de demostrar su trabajo y límites claros, entrega resultados. Si falta uno, adivina con confianza.

Cuatro preguntas recorren todo el taller:

• Contexto. ¿Tiene el agente los datos correctos?
• Razonamiento. ¿Vale esta tarea un modelo más grande o más esfuerzo?
• Evidencia. ¿Qué demuestra que el resultado es correcto?
• Autonomía. ¿Sus verificaciones y límites se ganan el derecho de apartarse?

Aprenderá a responderlas con Claude Code, en cuatro pasos. Cada paso es un cinturón, y cada cinturón termina con algo que funciona.

Cuatro cinturones

• Cinturón blanco, fundamentos. Qué es un modelo, qué hace el entorno que lo rodea, su primera conversación con Claude Code.
• Cinturón azul, construir CLASH. De una especificación a una aplicación en funcionamiento: planificar primero, trabajar en pasos pequeños, dejar que Claude mire la página, revisar como un extraño.
• Cinturón marrón, controlar el contexto. Escribir un CLAUDE.md a partir de reglas reales, empaquetar un hábito como una skill, auditar con subagents, convertir una historia en una especificación, limitar reglas a rutas.
• Cinturón negro, orquestar y soltar. Pruebas como referencia de meta, equipos de agentes y workflows dinámicos, hooks, el navegador como verificación, worktrees y CI, el Agent SDK, trabajo programado y en segundo plano, su propio servidor MCP.

Una aplicación real

Construirá CLASH, una aplicación de mapas para encuentros espontáneos en Berlín. Un clash es una actividad en un lugar y una hora. Las personas se unen, los hosts aceptan o rechazan, las notificaciones siguen. Usted comienza con una especificación y un repositorio vacío. CLASH está en línea y es gratuita, así que puede probarla antes de construirla por su cuenta.

El código real tiene errores reales: una Server Action que omite una verificación de propiedad, un mapa que falla en el servidor, un avatar que ralentiza cada página. Usted los encuentra y los corrige con evidencia.

Al final tendrá:

• CLASH, construida por usted con Claude Code y comparada con la referencia
• un CLAUDE.md basado en reglas reales, una skill reutilizable y un conjunto de hooks
• una auditoría de autorización ejecutada de tres maneras, con la corrección integrada
• una suite de pruebas de navegador y una corrección de rendimiento medida
• la auditoría ejecutándose en CI, un flujo con worktree y un pequeño programa con Agent SDK
• Claude Code funcionando sin nadie al teclado: un estilo de salida, un objetivo, un bucle, una sesión en segundo plano y una rutina
• su propio servidor MCP sobre CLASH, y una segunda aplicación que publica sus charlas como clashes a través de él

Cómo se desarrolla

El instructor explica una idea, la muestra en vivo y luego usted la realiza en su propia máquina. Cada tarea tiene una rama de reinicio, para que nadie se quede atascado y nadie espere al grupo. Las diapositivas, los archivos de tareas y las claves de respuesta son suyos para conservar.

Para quién es

Cualquier persona que programe y quiera usar bien Claude Code. Bastan conocimientos básicos de programación en un lenguaje habitual, además de lo básico de git. La aplicación que usted construye, CLASH, está escrita en TypeScript. No necesita conocerlo: si sabe leer código en otro lenguaje, puede seguir el taller, y Claude Code explica lo que sea nuevo. No hace falta experiencia previa con Claude Code.

Lo que necesita

Un portátil con Node.js 20.19 o posterior, git y GitHub CLI. Una cuenta de Claude con acceso a Claude Code: Pro funciona, un plan superior deja más margen para la tarea del equipo de agentes. Una cuenta de GitHub. La lista completa de configuración le espera en la página de su taller una vez que se haya inscrito.

Cinturón blanco: fundamentos

Aprenderá qué es un modelo, qué hace el entorno que lo rodea y cómo mantener una conversación en el rumbo correcto.

1. Cómo funciona un modelo. Tokens, probabilidades, sin memoria y una ventana de contexto limitada: qué es un modelo de lenguaje, por qué adivina y por qué Claude Code coloca archivos delante de él.
2. El entorno y su primera conversación. Qué añade Claude Code alrededor del modelo: el bucle, el prompt, las herramientas y los permisos. Luego lo inicia en un proyecto y pregunta por un archivo.
   Tarea: Configure Claude Code y haga su primera pregunta.

Cinturón azul: construir CLASH

Pasará de una especificación a una aplicación en funcionamiento, un pequeño paso a la vez.

3. Planifique antes de construir. Escriba un resumen con objetivo, reglas y una línea de llegada, y use el modo plan para revisar un cambio difícil de deshacer antes de que Claude escriba un solo archivo.
   Tarea: Genere la estructura de la aplicación y planifique su modelo de datos.
4. Pasos pequeños y el momento de seguridad. Construya en pasos pequeños que pueda verificar, deshaga uno con /rewind, observe la ventana de contexto y vea por qué cada Server Action necesita su propia verificación de propiedad.
   Tarea: Construya el inicio de sesión y los clashes en pasos pequeños.
5. Deje que Claude vea el resultado. Reutilice un patrón señalándolo, dé a Claude el error o la página en vivo en lugar de describir un bug, y añada controles de calidad a CLAUDE.md.
   Tarea: Construya venues, el mapa y las notificaciones.
6. Trabajos en paralelo, memoria y revisión. Agrupe trabajos independientes en un solo resumen, ejecute trabajo en segundo plano, guarde una regla en memoria, revise su propio diff como un extraño y entregue usando Claude.
   Tarea: Termine la aplicación, revísela y entréguela.

Cinturón marrón: controlar el contexto

Usted decide qué sabe Claude, cuándo lo carga y quién verifica el trabajo.

7. Contexto y CLAUDE.md. Lea /context, escriba un CLAUDE.md a partir de seis reglas reales de CLASH y revise un plan en modo plan antes de cualquier cambio de código.
   Tarea: Escriba un CLAUDE.md a partir de reglas reales y revise un plan.
8. Skills y plugins. Escriba una skill para una receta que repite, compruebe cuánto cuestan las skills en contexto y empaquétela como un plugin que pueda compartir.
   Tarea: Escriba la skill clash-feature y entregue favoritos de venues con ella.
9. Subagents para auditorías. Entregue una auditoría a un subagent de solo lectura para que su propio contexto apenas se mueva, y distinga un subagent nuevo de un fork.
   Tarea: Audite las Server Actions con un subagent de solo lectura.
10. De historia a especificación. Convierta una historia vaga en una especificación resuelta con Example Mapping, ejecutado como una skill que le entrevista antes de redactar.
    Tarea: Construya la skill discover y guarde una especificación resuelta.
11. Reglas limitadas por ruta. Limite una regla del proyecto a app/actions/** con frontmatter de paths y compruebe en /context que se carga solo en una lectura que coincida.
    Tarea: Escriba una regla limitada por ruta para Server Actions.

Cinturón negro: orquestar y soltar

Añadirá pruebas, equipos, hooks y un navegador como verificaciones, y luego se apartará de forma deliberada.

12. El bucle interno guiado por pruebas. Guíe el código a partir de una especificación guardada, una regla a la vez, y empaquete el bucle rojo-verde-refactor como una skill que se detiene sola.
    Tarea: Guíe las reglas de capacidad con una skill de TDD.
13. Equipos de agentes y workflows dinámicos. Describa un equipo de agentes y un workflow dinámico con palabras simples, lea el script generado y elija la estrategia adecuada para un trabajo.
    Tarea: Ejecute la auditoría de propiedad como equipo y como workflow.
14. Hooks y seguridad. Convierta una regla repetida en un hook que bloquee, advierta o mantenga un turno abierto, y aprenda dónde se detiene el alcance de Claude dentro de sus archivos.
    Tarea: Construya cuatro hooks de Claude Code.
15. El navegador cierra el ciclo. Deje que Claude controle un navegador real mediante MCP, escriba la prueba después de que el flujo funcione y demuestre una corrección con una medición de antes y después.
    Tarea: Pruebe el flujo de unión y corrija la carga útil del avatar.
16. Worktrees, batch y CI. Ejecute agentes lado a lado en worktrees separados, sepa cuándo encaja /batch y ejecute la misma auditoría en CI en cada pull request.
    Tarea: Ejecute dos worktrees y audite cada pull request.
17. El Agent SDK. Ejecute el bucle de agente de Claude Code dentro de su propio programa con herramientas de solo lectura, un hook y un límite de turnos.
    Tarea: Aloje el bucle de agente en su propio programa.
18. Proyecto final. Entregue una funcionalidad en el CLASH de referencia como un pull request, usando en conjunto todas las herramientas del taller.
    Tarea: Entregue una funcionalidad con todas las herramientas del taller.
19. Nadie al teclado. Defina un estilo de salida, limite una ejecución con /goal, repita una verificación en bucle, ejecute una auditoría en segundo plano y vea una rutina en la nube.
    Tarea: Ejecute Claude Code sin nadie al teclado.
20. Construya su propio servidor MCP. Diseñe un servidor MCP con cuatro herramientas sobre la base de datos de CLASH, confíe en él de forma selectiva y llámelo desde una segunda aplicación.
    Tarea: Diseñe un servidor MCP para CLASH.