Intensivo Gratis 21–22.11Intensivo gratuito de 2 días en Vibecoding (21–22 nov, 16:00 MSK) · Cohorte 3 inicia 23.11Registrarse gratis →Cohorte 3 (23.11)
LanzamientoCódigo / SDK · Listo para usarGitLab Blog→ original

La skill /gitlab-duo-setup conecta Claude Code con GitLab Duo con un solo comando

Supongamos que escribe código en Claude Code, pero la revisión, las comprobaciones y la auditoría viven en GitLab. La skill gitlab-duo-setup, que se lanza con el comando /gitlab-duo-setup, activa en una sola pasada los flujos agénticos de GitLab Duo Agent Platform en el grupo, además de la revisión automática y la reparación de pipelines fallidos, y conecta el servidor MCP. Cada merge request pasa por las mismas revisiones, escaneos y políticas, de modo que la velocidad de los agentes no esquiva el control.

Procesado por IA desde GitLab Blog; editado por Hamidun News
La skill /gitlab-duo-setup conecta Claude Code con GitLab Duo con un solo comando
Fuente: GitLab Blog. Collage: Hamidun News.
Escuchar artículo
Ficha técnica y cifras clave
ParámetroDatos
Fuente originalGitLab Blog ↗
Editor jefe
Dato clave #1Antes de hacer cambios, la skill muestra un plan y espera un «sí»; se puede quitar cualquier línea
Dato clave #2Hace falta el rol Owner en el grupo; sin él, solo se configurará el proyecto
Dato clave #3Se necesitan GitLab.com y créditos; el análisis de vulnerabilidades solo está disponible en Ultimate

Imagine un equipo en el que los desarrolladores escriben código con un agente de IA en la terminal, por ejemplo Claude Code (una herramienta local de tipo «harness», en la que usted conversa con el modelo y edita el repositorio). El agente abre cambios con rapidez, pero la revisión, los pipelines, los escaneos de seguridad y la auditoría viven en GitLab, y cada agente trabaja con su propio fragmento de contexto. GitLab llama al resultado «fábrica de software en la sombra»: el contexto, el control y las evidencias se dispersan entre personas y herramientas.

Para corregirlo, la compañía ha publicado una guía y una skill lista para usar, gitlab-duo-setup. Una skill es una carpeta con instrucciones que Claude Code ejecuta con el comando /gitlab-duo-setup. La skill conecta su terminal una sola vez con GitLab Duo Agent Platform, la plataforma de GitLab donde los flujos agénticos (flows) trabajan con el contexto completo del repositorio y bajo sus políticas.

Si sus desarrolladores ya usan agentes distintos, es una forma de someter a todos a las mismas comprobaciones sin obligarlos a cambiar de herramientas.

La idea: el agente en la terminal, las comprobaciones en GitLab

El esquema es el siguiente. Usted sigue en su herramienta local. En el artículo es Claude Code, pero el mismo enfoque sirve para Codex, Cursor, OpenCode y Duo CLI. Desde la terminal envía a GitLab las tareas largas: tomar una issue y abrir un merge request, revisar cada MR según aparece, resolver conflictos de fusión y reparar un pipeline que acaba de fallar. En el plan Ultimate se añade el análisis y la corrección de hallazgos de seguridad una vez que el código llega al repositorio.

Lo importante es que la identidad, las políticas, los pipelines de CI, las aprobaciones y la auditoría acompañan al cambio desde la planificación hasta producción. La herramienta local no ve el panorama completo, así que cada MR pasa igualmente por las mismas revisiones, pipelines, escaneos y políticas de aprobación. Además, GitLab se mantiene neutral respecto a la nube, los modelos y los agentes: usted conserva las herramientas y los modelos que encajan con su organización.

Cómo es la configuración

La skill se copia en ~/.claude/skills/ (o en .claude/skills/ dentro del repositorio, para que la tenga todo el equipo) y después se ejecuta /gitlab-duo-setup en el directorio del proyecto. Antes de hacer cualquier cambio, lee su grupo de nivel superior y sus proyectos y muestra un único plan. Los cambios a nivel de grupo afectan a todos los proyectos y a todos los miembros, y el plan lo indica de forma explícita. La skill espera su «sí», y se puede quitar cualquier línea. Una vez que usted da su conformidad, la skill:

  • activa Duo Agent Platform y la ejecución de flujos para el grupo, y añade los flujos Code Review, Duo Developer y Fix CI/CD Pipeline; los que ya existían siguen activados;
  • activa la revisión automática de código a nivel de grupo, que se aplica a todos los proyectos;
  • crea en cada proyecto con CI/CD una automatización que lanza Fix CI/CD Pipeline cuando falla un pipeline; los proyectos que ya la tienen se omiten, por lo que repetir la ejecución es seguro;
  • añade el servidor MCP de GitLab a Claude Code a nivel de usuario o de proyecto y le guía en el inicio de sesión por el navegador;
  • verifica el resultado con una llamada a list_duo_agents_and_flows: una respuesta correcta confirma el inicio de sesión, y la lista de flujos confirma que los ajustes se han aplicado.

En Ultimate, la skill plantea una pregunta opcional: si además se quiere analizar y corregir los hallazgos de seguridad. Al final entrega un breve informe con enlaces a lo que no se pudo hacer, por ejemplo si el proyecto no tiene runners para los flujos o si el grupo define reglas de push.

Si las herramientas de GitLab no aparecen, ejecute /mcp y compruebe que GitLab está conectado; si está conectado pero sin herramientas, reinicie Claude Code. Un error 403 al iniciar sesión suele significar que el acceso de clientes MCP está desactivado para el grupo. El propietario debe activar «Allow connection to GitLab» en Settings > General > Permissions and group features.

Qué se obtiene tras la conexión

A través de MCP, Claude Code encuentra sus issues, lanza flujos, lee los hilos de revisión y el estado de los pipelines, y responde en las discusiones mediante una sola conexión OAuth. Cada llamada genera un evento de auditoría de IA para el equipo de la plataforma. El contexto se superpone por capas: los archivos locales en la herramienta, luego el contexto de issues y MR por MCP y, por último, los flujos de Duo Agent Platform con el contexto completo del repositorio y sus comprobaciones.

La guía describe cuatro escenarios: pasar al flujo Developer una issue que se le haya asignado, recibir la revisión automática de los MR y gestionar los comentarios sin salir de la terminal, reparar un pipeline fallido mediante la automatización y (en Ultimate) analizar vulnerabilidades. Para un ciclo aún más estrecho existe una segunda skill, gitlab-mr-followup, que ayuda al agente local a seguir el curso del trabajo en el repositorio y a actuar en su nombre.

Qué se necesita

Se trata de una guía del proveedor, pensada para GitLab.com. Hacen falta un grupo de nivel superior con créditos de GitLab (los grupos Premium y Ultimate reciben créditos promocionales cada mes por cada usuario) y un proyecto con un pipeline, varias issues abiertas y un par de MR. También hace falta el rol Owner en el grupo, para que la skill lo configure por completo. Si usted es Maintainer del proyecto pero no propietario del grupo, la skill configurará solo el proyecto y enumerará qué debe pedirle al propietario. Además, se necesitan Claude Code, git y GitLab CLI (glab con inicio de sesión mediante glab auth login). El análisis de vulnerabilidades solo funciona con licencia Ultimate.

Historia

Preguntas frecuentes sobre la noticia

¿Qué se sabe sobre La idea: el agente en la terminal, las comprobaciones en GitLab?

El esquema es el siguiente. Usted sigue en su herramienta local. En el artículo es Claude Code, pero el mismo enfoque sirve para Codex, Cursor, OpenCode y Duo CLI. Desde la terminal envía a GitLab las tareas largas: tomar una issue y abrir un merge request, revisar cada MR según aparece, resolver conflictos de fusión y reparar un pipeline que acaba de fallar. En el plan Ultimate se añade el análisis y la corrección de hallazgos de seguridad una vez que el código llega al repositorio.

Cómo es la configuración?

La skill se copia en ~/.claude/skills/ (o en .claude/skills/ dentro del repositorio, para que la tenga todo el equipo) y después se ejecuta /gitlab-duo-setup en el directorio del proyecto. Antes de hacer cualquier cambio, lee su grupo de nivel superior y sus proyectos y muestra un único plan. Los cambios a nivel de grupo afectan a todos los proyectos y a todos los miembros, y el plan lo indica de forma explícita. La skill espera su «sí», y se puede quitar cualquier línea.

¿Qué se sabe sobre Qué se obtiene tras la conexión?

A través de MCP, Claude Code encuentra sus issues, lanza flujos, lee los hilos de revisión y el estado de los pipelines, y responde en las discusiones mediante una sola conexión OAuth. Cada llamada genera un evento de auditoría de IA para el equipo de la plataforma. El contexto se superpone por capas: los archivos locales en la herramienta, luego el contexto de issues y MR por MCP y, por último, los flujos de Duo Agent Platform con el contexto completo del repositorio y sus comprobaciones.

ZK
Zhemal Khamidun — CPO de Alpina Digital, product manager de AlpinaGPT. Crea productos de IA desde 2019. Hamidun News es un proyecto personal que creció hasta ser un agregador en producción con más de 6.000 lectores.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
¿Qué te parece?
Cargando comentarios…