是什么
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 审查和审批流程。
快速配置:
- 在 Settings → CI/CD → Variables 中添加
ANTHROPIC_API_KEY(masked) - 在
.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 提供更丰富的上下文
- 支持区域端点以满足数据主权要求
关联
- github-actions — GitHub 的类似集成
- code-review — 自动 PR/MR 审查
- headless — 非交互式
-p模式
实践要点
- 使用
node:24-alpine3.21镜像,安装 git、curl、bash 依赖 - 通过
rules控制触发条件,避免不必要的 AI 作业运行 - Bedrock/Vertex AI 用户需手动配置认证,不能直接用 API Key
- 所有变更通过 MR 提交,保持代码审查流程不变
- 反馈和问题报告到 GitLab issue:
gitlab.com/gitlab-org/gitlab/-/issues/573776