Claude Code en equipo: una sola forma de trabajar

Hola, bienvenido. Empezamos un nuevo curso en CursosDesarrolloWeb.es, en el que vamos a tomar la configuración de Claude Code que tu equipo copia de repo en repo y convertirla en una sola forma de trabajar: un plugin con versión, publicado en un repositorio privado e instalado con 2 comandos.

Este curso arranca sobre un proyecto concreto, helpdesk, el primer proyecto del equipo que protagoniza el curso. Lo crearemos en la lección 3, paso a paso: un proyecto Laravel con Sail, composer qa con Pint, Larastan, Rector y Pest, Laravel Boost y 18 arch tests, con la misma configuración que deja el curso Setup Profesional Laravel + IA para 2026↗ (se abre en una pestaña nueva). De tu proyecto de ese curso solo copiarás la configuración de Claude Code: los permisos, las skills, las rules, los subagentes, el CLAUDE.md compilado por Boost y los docs de .ai/. Por eso haberlo seguido es requisito para seguir este curso: ahí se explica cada herramienta y cada regla, y en este curso las damos por sabidas.

Imagina un equipo de 3 personas que configuró su primer proyecto siguiendo ese curso, y lo hizo bien. Llega el segundo proyecto y lo copian. Y el tercero. Al cabo de unos meses tienen 6 copias de la misma configuración y ninguna es igual a otra. Una skill de QA apunta a la key de SonarQube de otro proyecto. Un deny no bloquea nada, porque el comando se escribe sin ./. Un repo tiene 12 arch tests y otro 19. Una convención vive en la memoria personal de 2 personas y en ningún documento, y la forma de trabajar con spec, plan y tareas solo la sigue igual una de ellas. Cuando alguien mejora algo, llevarlo al resto de repos son muchos pasos a mano, y nadie llega a hacerlos. Ese equipo es el de Marta, Jorge y Aitor, y su proyecto largo es el hilo de todo el curso.

Lo que vas a encontrar por ahí sobre plugins de Claude Code suele ser cómo instalar los de otros, o un plugin de ejemplo que no sale de tu disco. Lo que no está contado de principio a fin es el camino de un equipo: crear el plugin, publicarlo donde solo llegue el equipo, instalárselo a quien se incorpora, sacar versiones y volver atrás cuando una sale mal. Y eso es justo lo que vamos a hacer en este curso.

La solución no es otro documento que cada uno tiene que recordar. Es convertir la forma de trabajar del equipo en algo que se instala, tiene versión y se comprueba sola. En el curso la vas a construir pieza a pieza: una forma de trabajar con Claude Code que cualquier persona del equipo instala en 2 comandos, que llega a todos a la vez cuando cambia y que cada repo comprueba al abrir la sesión, junto con unas convenciones de código que comparten todos los proyectos.

Para el repositorio privado basta tu cuenta personal de GitHub, o de tu proveedor de git favorito, con tus compañeros como colaboradores. Los ejemplos usan la cuenta cursosdesarrolloweb; donde la veas, pon tu usuario o tu organización.

El curso tiene un núcleo y 5 bloques opcionales. El núcleo resuelve el problema con lo mínimo: preparar el proyecto, crear la forma de trabajar del equipo, publicarla, incorporar a una persona nueva, sacar versiones nuevas y retirar una versión que sale mal. Cada bloque opcional es independiente y empieza diciendo si tu equipo lo necesita o puedes saltártelo:

• La QA y la seguridad, como parte de la forma de trabajar del equipo.
• Las convenciones de código compartidas entre proyectos, y un segundo proyecto arrancado con ellas.
• El trabajo diario y las features que hay que decidir antes de programar.
• Los mods de Claude Code: qué permitir en un equipo.
• Imponer todo esto en las máquinas que gestiona la organización. Es lo único del curso pensado para una cuenta Team o Enterprise.

Trabajamos con Claude Code 2.1, Laravel 13 con PHP 8.5 sobre Laravel Sail, Composer 2.10, Pest 4, Larastan 3, Rector 2, Laravel Pint y Laravel Boost 2.10, con la configuración de IA de tu proyecto del Setup. SonarQube Community 26 aparece solo en el bloque de QA. Los scripts del plugin se escriben para bash 3.2, el de macOS, y están probados en Linux y en WSL2.

Claude Code publica versiones casi a diario, así que todo lo que enseña el curso está probado, y en cada lección te digo qué está documentado y qué hemos comprobado en la práctica.

La idea es que cuando termines tengas la forma de trabajar del equipo publicada en un repositorio privado, unas convenciones de código compartidas y 2 proyectos que trabajan con ellas, con composer qa en verde. Y además del código, aprenderás a decidir en cada caso qué va a cada sitio, qué no se estandariza y cómo se publica y se retira una versión.

Si eres suscriptor, tienes el proyecto final disponible. Lleva completos los repositorios que crea el curso y, del proyecto con el que empieza, los archivos que crea o cambia.

Cada comando dice en qué terminal se ejecuta y como quién, porque en algún momento del curso tendrás 3 proyectos con Sail levantados a la vez y varias personas del equipo haciendo cosas distintas. Por eso, antes de crear el primer proyecto, dejamos preparada una terminal por repo, cada una con su nombre, con Zellij.

Lo básico de Claude Code: qué es una skill, un hook, un subagente o una rule está en el curso Claude Code↗ (se abre en una pestaña nueva), y cada lección enlaza la suya cuando lo da por sabido. Pint, Larastan, Rector, Pest y Boost los instalaremos en la lección 3 con la configuración del Setup Profesional, pero no explicamos cada regla ni cada opción: eso está en ese curso, y aquí los movemos y los versionamos. Spec-Driven Development no se ve a fondo: aquí lo convertimos en skills del plugin, y si quieres aprenderlo de principio a fin tienes el curso Spec-Driven Development en Laravel con IA↗ (se abre en una pestaña nueva). No se instala Filament, la CI solo comprueba el marketplace y lo que solo existe en Team y Enterprise se nombra en el último bloque sin practicarlo, porque no se puede reproducir en local.

Este curso es para ti si trabajas con Laravel, ya usas Claude Code y te ves reflejado en alguno de estos casos:

• Eres tech lead o desarrollador senior y lideras un proyecto largo con varias personas.
• Mantienes varios repos que tendrían que trabajar igual.
• Quieres aprender a diseñar la forma de trabajar de un equipo con Claude Code, aunque hoy trabajes solo. Es arquitectura aplicada a Claude Code, y saber hacerlo te puede abrir puertas en tu trabajo.

Para seguirlo necesitas:

• Haber seguido el curso Setup Profesional Laravel + IA para 2026 y tener a mano su proyecto, porque copiarás de él la configuración de Claude Code.
• Conocer Claude Code al nivel del curso Claude Code↗ (se abre en una pestaña nueva): settings, permisos, CLAUDE.md, skills, hooks y subagentes.
• Dominar Git por SSH y el flujo de rama, pull request y merge, como en el curso Git para Profesionales↗ (se abre en una pestaña nueva), y saber leer un script de Bash.
• Docker, con unos 3 GiB libres para SonarQube.

Puedes seguirlo con cualquier plan de Claude Code, también con Team o Enterprise. Si trabajas en Windows y no tienes claro WSL2 con Sail, pasa antes por el curso WSL 2 en Windows con Laravel Sail↗ (se abre en una pestaña nueva).

Un equipo trabaja igual cuando lo que ha acordado se instala, se versiona y se comprueba. Confiar en que todos recuerden lo mismo funciona con un repo y deja de funcionar con el segundo. El plugin es la primera barrera, pero cualquiera puede desactivarlo en su máquina, así que lo que tiene que cumplirse siempre va a git y a la QA antes del merge. Lo que da el plugin es que la forma de trabajar deje de depender de la memoria de cada uno y que, cuando cambie, cambie para todos a la vez.

Así que, si te interesa, te espero dentro del curso. Espero que te haya gustado esta introducción. Un saludo.