Claude Code w GitLab CI/CD

Claude Code w GitLab CI/CD pozwala uruchamiać zadania AI w pipeline’ach i przekazywać ich wyniki do repozytorium przez merge requesty. Integracja opiera się na Claude Code CLI i Agent SDK, dzięki czemu można używać Claude’a programowo w zadaniach CI/CD oraz własnych automatyzacjach. Integracja jest obecnie w wersji beta, a jej funkcje mogą się zmieniać.

GitLab może uruchamiać zadanie po wybranym zdarzeniu, na przykład po komentarzu z wzmianką @claude w issue, MR lub wątku przeglądu. Zadanie zbiera kontekst z wątku i repozytorium, buduje prompt z tych danych, a następnie uruchamia Claude Code. Każda interakcja działa w kontenerze z ograniczeniami sieci i systemu plików, a zmiany przechodzą przez MR, gdzie recenzenci widzą diff i nadal obowiązują zatwierdzenia.

Szybki start polega na dodaniu zadania do .gitlab-ci.yml i ustawieniu klucza API jako zamaskowanej zmiennej CI/CD. Dla Claude API dodaj ANTHROPIC_API_KEY jako zmienną zamaskowaną, chronioną w razie potrzeby. Po dodaniu zadania i zmiennej klucza można uruchomić pipeline ręcznie albo wyzwolić go z MR.

W konfiguracji produkcyjnej można użyć dostępu OIDC do Amazon Bedrock albo Workload Identity Federation do Google Cloud’s Agent Platform, zamiast przechowywać długotrwałe klucze. Przy wyzwalaniu pracy wzmianką @claude listener może przekazać do API uruchamiającego pipeline zmienne AI_FLOW_INPUT i AI_FLOW_CONTEXT. Jeśli zadanie nie może pisać komentarzy lub otwierać MR-ów, sprawdź uprawnienia CI_JOB_TOKEN albo użyj Project Access Token z zakresem api oraz upewnij się, że mcp__gitlab jest dozwolonym narzędziem. Liczbę iteracji i czas działania można ograniczać przez --max-turns oraz timeout zadania, a współbieżność ogranicza liczbę równoległych uruchomień.

claude
-p "${AI_FLOW_INPUT:-'Review this MR and implement the requested changes'}"
--permission-mode acceptEdits
--allowedTools "Bash Read Edit Write mcp__gitlab"
--debug

variables:
  AWS_REGION: "us-west-2"
  CLAUDE_CODE_USE_BEDROCK: "1"

variables:
  CLOUD_ML_REGION: "us-east5"
  CLAUDE_CODE_USE_VERTEX: "1"
  ANTHROPIC_VERTEX_PROJECT_ID: "$GCP_PROJECT_ID"