是什么

Claude Code GitLab CI/CD 集成(Beta)让 Claude 在 GitLab CI 作业中运行,响应 Issue 评论、MR 事件等触发器,自动创建 MR、实现功能、修复 Bug。由 GitLab 维护,基于 Claude Code CLI 和 Agent SDK 构建。

核心机制

事件驱动:GitLab 监听触发器(如 @claude 评论),收集线程和仓库上下文,构建 Prompt 后运行 Claude Code。

Provider 抽象:支持三种 Provider:

  • Claude API(SaaS)
  • Amazon Bedrock(IAM 认证,跨区域选项)
  • Google Vertex AI(GCP 原生,Workload Identity Federation)

沙箱执行:每次交互在容器中运行,有严格的网络和文件系统规则。所有变更通过 MR 流程,保留 diff 审查和审批流程。

快速配置:

  1. 在 Settings → CI/CD → Variables 中添加 ANTHROPIC_API_KEY(masked)
  2. 在 .gitlab-ci.yml 中添加 Claude 作业,配置触发规则

上下文变量:通过 AI_FLOW_INPUT、AI_FLOW_CONTEXT、AI_FLOW_EVENT 传递触发上下文给 Claude。

关键细节

  • 集成状态:Beta,由 GitLab 维护
  • 支持的触发器:web、merge_request_event 等
  • 安装 Claude Code:curl -fsSL https://claude.ai/install.sh | bash
  • 可选:启动 GitLab MCP Server 提供更丰富的上下文
  • 支持区域端点以满足数据主权要求

关联

实践要点

  • 使用 node:24-alpine3.21 镜像,安装 git、curl、bash 依赖
  • 通过 rules 控制触发条件,避免不必要的 AI 作业运行
  • Bedrock/Vertex AI 用户需手动配置认证,不能直接用 API Key
  • 所有变更通过 MR 提交,保持代码审查流程不变
  • 反馈和问题报告到 GitLab issue:gitlab.com/gitlab-org/gitlab/-/issues/573776