Intensivo Grátis 21–22/11Intensivo gratuito de 2 dias em Vibecoding (21–22/11 às 16:00 MSK) · Turma 3 começa 23/11Inscrever-se grátis →Turma 3 (23/11)
LançamentoCódigo / SDK · Pronto p/ usoGitLab Blog→ original

A skill /gitlab-duo-setup conecta o Claude Code ao GitLab Duo com um único comando

Imagine que você escreve código no Claude Code, mas a revisão, as verificações e a auditoria ficam no GitLab. A skill gitlab-duo-setup, executada pelo comando /gitlab-duo-setup, ativa de uma só vez no grupo os fluxos agênticos do GitLab Duo Agent Platform, a revisão automática e o conserto de pipelines quebrados, além de conectar o servidor MCP. Cada merge request passa pelas mesmas revisões, scans e políticas, então a velocidade dos agentes não contorna o controle.

Processado por IA de GitLab Blog; editado por Hamidun News
A skill /gitlab-duo-setup conecta o Claude Code ao GitLab Duo com um único comando
Fonte: GitLab Blog. Colagem: Hamidun News.
Ouvir artigo
Ficha técnica e números-chave
ParâmetroDados
Fonte originalGitLab Blog ↗
Editor-chefe
Dado-chave #1Antes de qualquer alteração, a skill mostra um plano e espera o seu "sim"; qualquer linha pode ser removida
Dado-chave #2É preciso ter o papel de Owner no grupo; sem ele, só o projeto é configurado
Dado-chave #3É preciso usar o GitLab.com e ter créditos; a análise de vulnerabilidades só funciona no Ultimate

Imagine uma equipe em que os desenvolvedores escrevem código com um agente de IA no terminal, como o Claude Code (uma ferramenta local, uma espécie de "casca" em que você conversa com o modelo e edita o repositório). O agente abre alterações rapidamente, mas a revisão, os pipelines, os scans de segurança e a auditoria ficam no GitLab, e cada agente trabalha com a sua fatia de contexto. O GitLab chama o resultado de "fábrica de software invisível": contexto, controle e evidências ficam espalhados entre pessoas e ferramentas.

Para corrigir isso, a empresa publicou um guia e uma skill pronta, a gitlab-duo-setup. A skill é uma pasta com instruções que o Claude Code executa pelo comando /gitlab-duo-setup. Ela conecta seu terminal, de uma vez só, ao GitLab Duo Agent Platform, a plataforma do GitLab em que os fluxos agênticos (flows) trabalham com o contexto completo do repositório e sob as suas políticas.

Se os seus desenvolvedores já usam agentes diferentes, essa é uma forma de submeter todos às mesmas verificações sem obrigá-los a trocar de ferramenta.

A ideia: agente no terminal, verificações no GitLab

O esquema é este. Você continua na sua ferramenta local. No artigo, é o Claude Code, mas a mesma abordagem serve para Codex, Cursor, OpenCode e Duo CLI. Do terminal, você envia ao GitLab tarefas longas: pegar uma issue e abrir um merge request, revisar cada MR assim que aparece, resolver conflitos de merge e consertar um pipeline que acabou de falhar. No plano Ultimate, soma-se a análise e a correção de achados de segurança depois que o código chega ao repositório.

O ponto importante é que identidade, políticas, pipelines de CI, aprovações e auditoria acompanham a alteração do planejamento até a produção. A ferramenta local não enxerga o quadro completo, então cada MR passa de qualquer forma pelas mesmas revisões, pipelines, scans e políticas de aprovação. Ao mesmo tempo, o GitLab continua neutro em relação à nuvem, aos modelos e aos agentes: você mantém as ferramentas e os modelos que servem à sua organização.

Como funciona a configuração

A skill é copiada para ~/.claude/skills/ (ou para .claude/skills/ dentro do repositório, para que toda a equipe a tenha), e depois /gitlab-duo-setup é executado no diretório do projeto. Antes de qualquer alteração, ela lê o seu grupo de nível superior e os projetos dele e mostra um plano único. As mudanças no nível do grupo afetam todos os projetos e todos os participantes, e o plano deixa isso explícito. A skill espera o seu "sim", e qualquer linha pode ser removida. Depois da confirmação, ela:

  • ativa o Duo Agent Platform e a execução de fluxos para o grupo e adiciona os fluxos Code Review, Duo Developer e Fix CI/CD Pipeline, enquanto os já existentes continuam ativados;
  • ativa a revisão automática de código no nível do grupo, que vale para todos os projetos;
  • cria, em cada projeto com CI/CD, uma automação que dispara o Fix CI/CD Pipeline quando um pipeline falha; projetos que já têm essa automação são ignorados, então executar a skill de novo é seguro;
  • adiciona o servidor MCP do GitLab ao Claude Code no nível do usuário ou do projeto e conduz o login pelo navegador;
  • verifica o resultado chamando list_duo_agents_and_flows: uma resposta bem-sucedida confirma o login, e a lista de fluxos mostra que as configurações foram aplicadas.

No Ultimate, a skill faz uma pergunta opcional: se é preciso analisar e corrigir também os achados de segurança. No fim, ela entrega um relatório curto com links para o que não foi possível fazer, por exemplo quando o projeto não tem runners para os fluxos ou o grupo define regras de push.

Se as ferramentas do GitLab não aparecerem, execute /mcp e confirme que o GitLab está conectado; se ele estiver conectado, mas sem ferramentas, reinicie o Claude Code. Um erro 403 no login geralmente significa que o acesso de clientes MCP está desativado para o grupo. O proprietário deve ativar "Allow connection to GitLab" em Settings > General > Permissions and group features.

O que você tem depois da conexão

Por meio do MCP, o Claude Code encontra as suas issues, dispara fluxos, lê threads de revisão e o status dos pipelines e responde em discussões, tudo por uma única conexão OAuth. Cada chamada gera um evento de auditoria de IA para a equipe da plataforma. O contexto se acumula em camadas: arquivos locais na ferramenta, depois o contexto de issues e MRs via MCP e, por fim, os fluxos do Duo Agent Platform, com o contexto completo do repositório e as suas verificações.

O guia examina quatro cenários: passar para o fluxo Developer uma issue atribuída a você, receber a revisão automática do MR e tratar os comentários sem sair do terminal, consertar um pipeline quebrado por meio da automação e, no Ultimate, analisar vulnerabilidades. Para um ciclo ainda mais integrado, existe uma segunda skill, a gitlab-mr-followup, que ajuda o agente local a acompanhar o andamento do trabalho no repositório e a agir em seu nome.

O que é necessário

É um guia do fornecedor, pensado para o GitLab.com. Você precisa de um grupo de nível superior com créditos do GitLab (grupos Premium e Ultimate recebem créditos promocionais todo mês, por usuário) e de um projeto com pipeline, algumas issues abertas e alguns MRs. Também é necessário o papel de Owner no grupo, para que a skill o configure por inteiro. Se você é Maintainer do projeto, mas não proprietário do grupo, ela configura só o projeto e lista o que pedir ao proprietário. Além disso, são necessários Claude Code, git e GitLab CLI (glab com login via glab auth login). A análise de vulnerabilidades só funciona com a licença Ultimate.

História

Perguntas frequentes sobre a notícia

O que se sabe sobre A ideia: agente no terminal, verificações no GitLab?

O esquema é este. Você continua na sua ferramenta local. No artigo, é o Claude Code, mas a mesma abordagem serve para Codex, Cursor, OpenCode e Duo CLI. Do terminal, você envia ao GitLab tarefas longas: pegar uma issue e abrir um merge request, revisar cada MR assim que aparece, resolver conflitos de merge e consertar um pipeline que acabou de falhar. No plano Ultimate, soma-se a análise e a correção de achados de segurança depois que o código chega ao repositório.

Como funciona a configuração?

A skill é copiada para ~/.claude/skills/ (ou para .claude/skills/ dentro do repositório, para que toda a equipe a tenha), e depois /gitlab-duo-setup é executado no diretório do projeto. Antes de qualquer alteração, ela lê o seu grupo de nível superior e os projetos dele e mostra um plano único. As mudanças no nível do grupo afetam todos os projetos e todos os participantes, e o plano deixa isso explícito. A skill espera o seu "sim", e qualquer linha pode ser removida.

O que você tem depois da conexão?

Por meio do MCP, o Claude Code encontra as suas issues, dispara fluxos, lê threads de revisão e o status dos pipelines e responde em discussões, tudo por uma única conexão OAuth. Cada chamada gera um evento de auditoria de IA para a equipe da plataforma. O contexto se acumula em camadas: arquivos locais na ferramenta, depois o contexto de issues e MRs via MCP e, por fim, os fluxos do Duo Agent Platform, com o contexto completo do repositório e as suas verificações.

ZK
Zhemal Khamidun — CPO da Alpina Digital, gerente de produto do AlpinaGPT. Cria produtos de IA desde 2019. O Hamidun News é um projeto pessoal que virou um agregador em produção com mais de 6.000 leitores.
✦ 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
O que você acha?
Carregando comentários…