Claude Code GitLab CI/CD

Узнайте об интеграции Claude Code в ваш рабочий процесс разработки с GitLab CI/CD

Почему использовать Claude Code с GitLab?

Мгновенное создание MR: Опишите, что вам нужно, и Claude предложит полный MR с изменениями и объяснением
Автоматизированная реализация: Превратите проблемы в рабочий код с помощью одной команды или упоминания
Осведомленность о проекте: Claude следует вашим рекомендациям CLAUDE.md и существующим шаблонам кода
Простая настройка: Добавьте одно задание в .gitlab-ci.yml и замаскированную переменную CI/CD
Готово для предприятия: Выберите Claude API, Amazon Bedrock или Google Vertex AI для соответствия требованиям к месторасположению данных и закупкам
Безопасно по умолчанию: Работает на ваших GitLab runners с вашей защитой ветвей и утверждениями

Как это работает

Claude Code использует GitLab CI/CD для запуска задач AI в изолированных заданиях и фиксации результатов обратно через MR:

Оркестровка, управляемая событиями: GitLab прослушивает выбранные вами триггеры (например, комментарий, упоминающий @claude в проблеме, MR или потоке рецензирования). Задание собирает контекст из потока и репозитория, создает подсказки из этого ввода и запускает Claude Code.
Абстракция поставщика: Используйте поставщика, который подходит для вашей среды:
- Claude API (SaaS)
- Amazon Bedrock (доступ на основе IAM, опции между регионами)
- Google Vertex AI (собственный GCP, Workload Identity Federation)
Изолированное выполнение: Каждое взаимодействие выполняется в контейнере со строгими правилами сети и файловой системы. Claude Code обеспечивает разрешения с областью действия рабочего пространства для ограничения записей. Каждое изменение проходит через MR, чтобы рецензенты видели diff и применялись утверждения.

Выберите региональные конечные точки, чтобы снизить задержку и соответствовать требованиям суверенитета данных при использовании существующих облачных соглашений.

Что может делать Claude?

Claude Code обеспечивает мощные рабочие процессы CI/CD, которые преобразуют способ работы с кодом:

Создание и обновление MR из описаний проблем или комментариев
Анализ регрессий производительности и предложение оптимизаций
Прямая реализация функций в ветви, затем открытие MR
Исправление ошибок и регрессий, выявленных тестами или комментариями
Ответ на последующие комментарии для итерации по запрошенным изменениям

Настройка

Быстрая настройка

Самый быстрый способ начать работу — добавить минимальное задание в ваш .gitlab-ci.yml и установить ваш ключ API как замаскированную переменную.

Добавьте замаскированную переменную CI/CD
- Перейдите в Settings → CI/CD → Variables
- Добавьте ANTHROPIC_API_KEY (замаскирована, защищена по мере необходимости)
Добавьте задание Claude в .gitlab-ci.yml

stages:
  - ai

claude:
  stage: ai
  image: node:24-alpine3.21
  # Отрегулируйте правила в соответствии с тем, как вы хотите запустить задание:
  # - ручные запуски
  # - события merge request
  # - веб/API триггеры, когда комментарий содержит '@claude'
  rules:
    - if: '$CI_PIPELINE_SOURCE == "web"'
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
  variables:
    GIT_STRATEGY: fetch
  before_script:
    - apk update
    - apk add --no-cache git curl bash
    - curl -fsSL https://claude.ai/install.sh | bash
  script:
    # Опционально: запустите сервер GitLab MCP, если ваша настройка его предоставляет
    - /bin/gitlab-mcp-server || true
    # Используйте переменные AI_FLOW_* при вызове через веб/API триггеры с полезными нагрузками контекста
    - echo "$AI_FLOW_INPUT for $AI_FLOW_CONTEXT on $AI_FLOW_EVENT"
    - >
      claude
      -p "${AI_FLOW_INPUT:-'Review this MR and implement the requested changes'}"
      --permission-mode acceptEdits
      --allowedTools "Bash Read Edit Write mcp__gitlab"
      --debug

После добавления задания и переменной ANTHROPIC_API_KEY протестируйте, запустив задание вручную из CI/CD → Pipelines, или запустите его из MR, чтобы позволить Claude предложить обновления в ветви и открыть MR при необходимости.

Ручная настройка (рекомендуется для производства)

Если вы предпочитаете более контролируемую настройку или вам нужны поставщики для предприятия:

Настройте доступ поставщика:
- Claude API: Создайте и сохраните ANTHROPIC_API_KEY как замаскированную переменную CI/CD
- Amazon Bedrock: Настройте GitLab → AWS OIDC и создайте роль IAM для Bedrock
- Google Vertex AI: Настройте Workload Identity Federation для GitLab → GCP
Добавьте учетные данные проекта для операций GitLab API:
- Используйте CI_JOB_TOKEN по умолчанию или создайте Project Access Token с областью api
- Сохраните как GITLAB_ACCESS_TOKEN (замаскирована), если используете PAT
Добавьте задание Claude в .gitlab-ci.yml (см. примеры ниже)
(Опционально) Включите триггеры, управляемые упоминаниями:
- Добавьте webhook проекта для "Comments (notes)" к вашему прослушивателю событий (если вы его используете)
- Попросите прослушиватель вызвать API триггера конвейера с переменными, такими как AI_FLOW_INPUT и AI_FLOW_CONTEXT, когда комментарий содержит @claude

Примеры использования

Превратите проблемы в MR

В комментарии проблемы:

@claude implement this feature based on the issue description

Claude анализирует проблему и кодовую базу, записывает изменения в ветви и открывает MR для рецензирования.

Получите помощь в реализации

В обсуждении MR:

@claude suggest a concrete approach to cache the results of this API call

Claude предлагает изменения, добавляет код с соответствующим кешированием и обновляет MR.

Быстро исправляйте ошибки

В комментарии проблемы или MR:

@claude fix the TypeError in the user dashboard component

Claude находит ошибку, реализует исправление и обновляет ветвь или открывает новый MR.

Использование с Amazon Bedrock и Google Vertex AI

Для корпоративных сред вы можете запустить Claude Code полностью на вашей облачной инфраструктуре с тем же опытом разработчика.

Предварительные требования

Перед настройкой Claude Code с Amazon Bedrock вам потребуется:

Учетная запись AWS с доступом Amazon Bedrock к желаемым моделям Claude
GitLab, настроенный как поставщик идентификации OIDC в AWS IAM
Роль IAM с разрешениями Bedrock и политикой доверия, ограниченной вашим проектом/ссылками GitLab
Переменные GitLab CI/CD для предположения роли:

AWS_ROLE_TO_ASSUME (ARN роли)
AWS_REGION (регион Bedrock)

Инструкции по настройке

Настройте AWS, чтобы позволить заданиям GitLab CI предположить роль IAM через OIDC (без статических ключей).

Требуемая настройка:

Включите Amazon Bedrock и запросите доступ к целевым моделям Claude
Создайте поставщика IAM OIDC для GitLab, если он еще не присутствует
Создайте роль IAM, доверяющую поставщику GitLab OIDC, ограниченную вашим проектом и защищенными ссылками
Прикрепите разрешения с наименьшими привилегиями для API вызова Bedrock

Требуемые значения для сохранения в переменных CI/CD:

AWS_ROLE_TO_ASSUME
AWS_REGION

Добавьте переменные в Settings → CI/CD → Variables:

# Для Amazon Bedrock:
- AWS_ROLE_TO_ASSUME
- AWS_REGION

Используйте пример задания Amazon Bedrock выше для обмена токена задания GitLab на временные учетные данные AWS во время выполнения.

Предварительные требования

Перед настройкой Claude Code с Google Vertex AI вам потребуется:

Проект Google Cloud с:

Включенным API Vertex AI
Настроенной Workload Identity Federation для доверия GitLab OIDC

Выделенная учетная запись сервиса только с требуемыми ролями Vertex AI
Переменные GitLab CI/CD для WIF:

GCP_WORKLOAD_IDENTITY_PROVIDER (полное имя ресурса)
GCP_SERVICE_ACCOUNT (адрес электронной почты учетной записи сервиса)

Инструкции по настройке

Настройте Google Cloud, чтобы позволить заданиям GitLab CI олицетворять учетную запись сервиса через Workload Identity Federation.

Требуемая настройка:

Включите IAM Credentials API, STS API и Vertex AI API
Создайте пул Workload Identity и поставщика для GitLab OIDC
Создайте выделенную учетную запись сервиса с ролями Vertex AI
Предоставьте основному принципу WIF разрешение на олицетворение учетной записи сервиса

Требуемые значения для сохранения в переменных CI/CD:

GCP_WORKLOAD_IDENTITY_PROVIDER
GCP_SERVICE_ACCOUNT

Добавьте переменные в Settings → CI/CD → Variables:

# Для Google Vertex AI:
- GCP_WORKLOAD_IDENTITY_PROVIDER
- GCP_SERVICE_ACCOUNT
- CLOUD_ML_REGION (например, us-east5)

Используйте пример задания Google Vertex AI выше для аутентификации без сохранения ключей.

Примеры конфигурации

Ниже приведены готовые к использованию фрагменты, которые вы можете адаптировать к вашему конвейеру.

Базовый .gitlab-ci.yml (Claude API)

stages:
  - ai

claude:
  stage: ai
  image: node:24-alpine3.21
  rules:
    - if: '$CI_PIPELINE_SOURCE == "web"'
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
  variables:
    GIT_STRATEGY: fetch
  before_script:
    - apk update
    - apk add --no-cache git curl bash
    - curl -fsSL https://claude.ai/install.sh | bash
  script:
    - /bin/gitlab-mcp-server || true
    - >
      claude
      -p "${AI_FLOW_INPUT:-'Summarize recent changes and suggest improvements'}"
      --permission-mode acceptEdits
      --allowedTools "Bash Read Edit Write mcp__gitlab"
      --debug
  # Claude Code будет использовать ANTHROPIC_API_KEY из переменных CI/CD

Пример задания Amazon Bedrock (OIDC)

Предварительные требования:

Amazon Bedrock включен с доступом к выбранной модели Claude
GitLab OIDC настроен в AWS с ролью, которая доверяет вашему проекту GitLab и ссылкам
Роль IAM с разрешениями Bedrock (рекомендуется наименьшие привилегии)

Требуемые переменные CI/CD:

AWS_ROLE_TO_ASSUME: ARN роли IAM для доступа к Bedrock
AWS_REGION: Регион Bedrock (например, us-west-2)

claude-bedrock:
  stage: ai
  image: node:24-alpine3.21
  rules:
    - if: '$CI_PIPELINE_SOURCE == "web"'
  before_script:
    - apk add --no-cache bash curl jq git python3 py3-pip
    - pip install --no-cache-dir awscli
    - curl -fsSL https://claude.ai/install.sh | bash
    # Обменяйте токен GitLab OIDC на учетные данные AWS
    - export AWS_WEB_IDENTITY_TOKEN_FILE="${CI_JOB_JWT_FILE:-/tmp/oidc_token}"
    - if [ -n "${CI_JOB_JWT_V2}" ]; then printf "%s" "$CI_JOB_JWT_V2" > "$AWS_WEB_IDENTITY_TOKEN_FILE"; fi
    - >
      aws sts assume-role-with-web-identity
      --role-arn "$AWS_ROLE_TO_ASSUME"
      --role-session-name "gitlab-claude-$(date +%s)"
      --web-identity-token "file://$AWS_WEB_IDENTITY_TOKEN_FILE"
      --duration-seconds 3600 > /tmp/aws_creds.json
    - export AWS_ACCESS_KEY_ID="$(jq -r .Credentials.AccessKeyId /tmp/aws_creds.json)"
    - export AWS_SECRET_ACCESS_KEY="$(jq -r .Credentials.SecretAccessKey /tmp/aws_creds.json)"
    - export AWS_SESSION_TOKEN="$(jq -r .Credentials.SessionToken /tmp/aws_creds.json)"
  script:
    - /bin/gitlab-mcp-server || true
    - >
      claude
      -p "${AI_FLOW_INPUT:-'Implement the requested changes and open an MR'}"
      --permission-mode acceptEdits
      --allowedTools "Bash Read Edit Write mcp__gitlab"
      --debug
  variables:
    AWS_REGION: "us-west-2"

Пример задания Google Vertex AI (Workload Identity Federation)

Предварительные требования:

API Vertex AI включен в вашем проекте GCP
Workload Identity Federation настроена для доверия GitLab OIDC
Учетная запись сервиса с разрешениями Vertex AI

Требуемые переменные CI/CD:

GCP_WORKLOAD_IDENTITY_PROVIDER: Полное имя ресурса поставщика
GCP_SERVICE_ACCOUNT: Адрес электронной почты учетной записи сервиса
CLOUD_ML_REGION: Регион Vertex (например, us-east5)

claude-vertex:
  stage: ai
  image: gcr.io/google.com/cloudsdktool/google-cloud-cli:slim
  rules:
    - if: '$CI_PIPELINE_SOURCE == "web"'
  before_script:
    - apt-get update && apt-get install -y git && apt-get clean
    - curl -fsSL https://claude.ai/install.sh | bash
    # Аутентифицируйтесь в Google Cloud через WIF (без загруженных ключей)
    - >
      gcloud auth login --cred-file=<(cat <<EOF
      {
        "type": "external_account",
        "audience": "${GCP_WORKLOAD_IDENTITY_PROVIDER}",
        "subject_token_type": "urn:ietf:params:oauth:token-type:jwt",
        "service_account_impersonation_url": "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/${GCP_SERVICE_ACCOUNT}:generateAccessToken",
        "token_url": "https://sts.googleapis.com/v1/token"
      }
      EOF
      )
    - gcloud config set project "$(gcloud projects list --format='value(projectId)' --filter="name:${CI_PROJECT_NAMESPACE}" | head -n1)" || true
  script:
    - /bin/gitlab-mcp-server || true
    - >
      CLOUD_ML_REGION="${CLOUD_ML_REGION:-us-east5}"
      claude
      -p "${AI_FLOW_INPUT:-'Review and update code as requested'}"
      --permission-mode acceptEdits
      --allowedTools "Bash Read Edit Write mcp__gitlab"
      --debug
  variables:
    CLOUD_ML_REGION: "us-east5"

Лучшие практики

Конфигурация CLAUDE.md

Создайте файл CLAUDE.md в корне репозитория, чтобы определить стандарты кодирования, критерии рецензирования и правила, специфичные для проекта. Claude читает этот файл во время запусков и следует вашим соглашениям при предложении изменений.

Соображения безопасности

Никогда не фиксируйте ключи API или учетные данные облака в вашем репозитории. Всегда используйте переменные GitLab CI/CD:

Добавьте ANTHROPIC_API_KEY как замаскированную переменную (и защитите ее при необходимости)
Используйте OIDC, специфичный для поставщика, где возможно (без долгоживущих ключей)
Ограничьте разрешения задания и исходящий трафик сети
Рецензируйте MR Claude, как любого другого участника

Оптимизация производительности

Держите CLAUDE.md сосредоточенным и кратким
Предоставляйте четкие описания проблем/MR, чтобы снизить количество итераций
Настройте разумные тайм-ауты заданий, чтобы избежать неконтролируемых запусков
Кешируйте npm и установки пакетов на runners, где возможно

Затраты CI

При использовании Claude Code с GitLab CI/CD помните о связанных затратах:

Время GitLab Runner:
- Claude работает на ваших GitLab runners и потребляет минуты вычислений
- Подробности о выставлении счетов за runner см. в плане GitLab
Затраты на API:
- Каждое взаимодействие Claude потребляет токены на основе размера подсказки и ответа
- Использование токенов варьируется в зависимости от сложности задачи и размера кодовой базы
- Подробности см. в ценообразовании Anthropic
Советы по оптимизации затрат:
- Используйте конкретные команды @claude для снижения ненужных ходов
- Установите соответствующие значения max_turns и тайм-аут задания
- Ограничьте параллелизм для управления параллельными запусками

Безопасность и управление

Каждое задание выполняется в изолированном контейнере с ограниченным доступом в сеть
Изменения Claude проходят через MR, чтобы рецензенты видели каждый diff
Правила защиты ветвей и утверждения применяются к коду, созданному AI
Claude Code использует разрешения с областью действия рабочего пространства для ограничения записей
Затраты остаются под вашим контролем, потому что вы приносите свои собственные учетные данные поставщика

Устранение неполадок

Claude не отвечает на команды @claude

Убедитесь, что ваш конвейер запускается (вручную, событие MR или через прослушиватель событий/webhook примечания)
Убедитесь, что переменные CI/CD (ANTHROPIC_API_KEY или параметры облачного поставщика) присутствуют и не замаскированы
Проверьте, что комментарий содержит @claude (не /claude) и что ваш триггер упоминания настроен

Задание не может писать комментарии или открывать MR

Убедитесь, что CI_JOB_TOKEN имеет достаточные разрешения для проекта, или используйте Project Access Token с областью api
Проверьте, что инструмент mcp__gitlab включен в --allowedTools
Подтвердите, что задание выполняется в контексте MR или имеет достаточный контекст через переменные AI_FLOW_*

Ошибки аутентификации

Для Claude API: Подтвердите, что ANTHROPIC_API_KEY действителен и не истек
Для Bedrock/Vertex: Проверьте конфигурацию OIDC/WIF, олицетворение роли и имена секретов; подтвердите доступность региона и модели

Расширенная конфигурация

Общие параметры и переменные

Claude Code поддерживает эти часто используемые входные данные:

prompt / prompt_file: Предоставьте инструкции встроенно (-p) или через файл
max_turns: Ограничьте количество взаимных итераций
timeout_minutes: Ограничьте общее время выполнения
ANTHROPIC_API_KEY: Требуется для Claude API (не используется для Bedrock/Vertex)
Окружение, специфичное для поставщика: AWS_REGION, переменные проекта/региона для Vertex

Настройка поведения Claude

Вы можете направлять Claude двумя основными способами:

CLAUDE.md: Определите стандарты кодирования, требования безопасности и соглашения проекта. Claude читает это во время запусков и следует вашим правилам.
Пользовательские подсказки: Передайте инструкции, специфичные для задачи, через prompt/prompt_file в задании. Используйте разные подсказки для разных заданий (например, рецензирование, реализация, рефакторинг).

gitlab-ci-cd.md +85 −29

16 Эта интеграция построена на основе [Claude Code CLI и Agent SDK](/ru/agent-sdk/overview), обеспечивая программное использование Claude в ваших заданиях CI/CD и пользовательских рабочих процессах автоматизации.16 Эта интеграция построена на основе [Claude Code CLI и Agent SDK](/ru/agent-sdk/overview), обеспечивая программное использование Claude в ваших заданиях CI/CD и пользовательских рабочих процессах автоматизации.

17</Note>17</Note>

18 18

~~19## Почему использовать Claude Code с GitLab?~~19<h2 id="why-use-claude-code-with-gitlab">

20 Почему использовать Claude Code с GitLab?

21</h2>

20 22

21* **Мгновенное создание MR**: Опишите, что вам нужно, и Claude предложит полный MR с изменениями и объяснением23* **Мгновенное создание MR**: Опишите, что вам нужно, и Claude предложит полный MR с изменениями и объяснением

22* **Автоматизированная реализация**: Превратите проблемы в рабочий код с помощью одной команды или упоминания24* **Автоматизированная реализация**: Превратите проблемы в рабочий код с помощью одной команды или упоминания

25* **Готово для предприятия**: Выберите Claude API, Amazon Bedrock или Google Vertex AI для соответствия требованиям к месторасположению данных и закупкам27* **Готово для предприятия**: Выберите Claude API, Amazon Bedrock или Google Vertex AI для соответствия требованиям к месторасположению данных и закупкам

26* **Безопасно по умолчанию**: Работает на ваших GitLab runners с вашей защитой ветвей и утверждениями28* **Безопасно по умолчанию**: Работает на ваших GitLab runners с вашей защитой ветвей и утверждениями

27 29

~~28## Как это работает~~30<h2 id="how-it-works">

31 Как это работает

32</h2>

29 33

30Claude Code использует GitLab CI/CD для запуска задач AI в изолированных заданиях и фиксации результатов обратно через MR:34Claude Code использует GitLab CI/CD для запуска задач AI в изолированных заданиях и фиксации результатов обратно через MR:

31 35

40 44

41Выберите региональные конечные точки, чтобы снизить задержку и соответствовать требованиям суверенитета данных при использовании существующих облачных соглашений.45Выберите региональные конечные точки, чтобы снизить задержку и соответствовать требованиям суверенитета данных при использовании существующих облачных соглашений.

42 46

~~43## Что может делать Claude?~~47<h2 id="what-can-claude-do">

48 Что может делать Claude?

49</h2>

44 50

45Claude Code обеспечивает мощные рабочие процессы CI/CD, которые преобразуют способ работы с кодом:51Claude Code обеспечивает мощные рабочие процессы CI/CD, которые преобразуют способ работы с кодом:

46 52

50* Исправление ошибок и регрессий, выявленных тестами или комментариями56* Исправление ошибок и регрессий, выявленных тестами или комментариями

51* Ответ на последующие комментарии для итерации по запрошенным изменениям57* Ответ на последующие комментарии для итерации по запрошенным изменениям

52 58

~~53## Настройка~~59<h2 id="setup">

60 Настройка

61</h2>

54 62

~~55### Быстрая настройка~~63<h3 id="quick-setup">

64 Быстрая настройка

65</h3>

56 66

57Самый быстрый способ начать работу — добавить минимальное задание в ваш `.gitlab-ci.yml` и установить ваш ключ API как замаскированную переменную.67Самый быстрый способ начать работу — добавить минимальное задание в ваш `.gitlab-ci.yml` и установить ваш ключ API как замаскированную переменную.

58 68

98После добавления задания и переменной `ANTHROPIC_API_KEY` протестируйте, запустив задание вручную из **CI/CD** → **Pipelines**, или запустите его из MR, чтобы позволить Claude предложить обновления в ветви и открыть MR при необходимости.108После добавления задания и переменной `ANTHROPIC_API_KEY` протестируйте, запустив задание вручную из **CI/CD** → **Pipelines**, или запустите его из MR, чтобы позволить Claude предложить обновления в ветви и открыть MR при необходимости.

99 109

100<Note>110<Note>

101 Для запуска на Amazon Bedrock или Google Vertex AI вместо Claude API см. раздел [Использование с Amazon Bedrock и Google Vertex AI](#using-with-amazon-bedrock--google-vertex-ai) ниже для настройки аутентификации и окружения.111 Для запуска на Amazon Bedrock или Google Vertex AI вместо Claude API см. раздел [Использование с Amazon Bedrock и Google Vertex AI](#using-with-amazon-bedrock-%26-google-vertex-ai) ниже для настройки аутентификации и окружения.

102</Note>112</Note>

103 113

104### Ручная настройка (рекомендуется для производства)114<h3 id="manual-setup-recommended-for-production">

115 Ручная настройка (рекомендуется для производства)

116</h3>

105 117

106Если вы предпочитаете более контролируемую настройку или вам нужны поставщики для предприятия:118Если вы предпочитаете более контролируемую настройку или вам нужны поставщики для предприятия:

107 119

120 * Добавьте webhook проекта для "Comments (notes)" к вашему прослушивателю событий (если вы его используете)132 * Добавьте webhook проекта для "Comments (notes)" к вашему прослушивателю событий (если вы его используете)

121 * Попросите прослушиватель вызвать API триггера конвейера с переменными, такими как `AI_FLOW_INPUT` и `AI_FLOW_CONTEXT`, когда комментарий содержит `@claude`133 * Попросите прослушиватель вызвать API триггера конвейера с переменными, такими как `AI_FLOW_INPUT` и `AI_FLOW_CONTEXT`, когда комментарий содержит `@claude`

122 134

123## Примеры использования135<h2 id="example-use-cases">

136 Примеры использования

137</h2>

124 138

125### Превратите проблемы в MR139<h3 id="turn-issues-into-mrs">

140 Превратите проблемы в MR

141</h3>

126 142

127В комментарии проблемы:143В комментарии проблемы:

128 144

132 148

133Claude анализирует проблему и кодовую базу, записывает изменения в ветви и открывает MR для рецензирования.149Claude анализирует проблему и кодовую базу, записывает изменения в ветви и открывает MR для рецензирования.

134 150

135### Получите помощь в реализации151<h3 id="get-implementation-help">

152 Получите помощь в реализации

153</h3>

136 154

137В обсуждении MR:155В обсуждении MR:

138 156

142 160

143Claude предлагает изменения, добавляет код с соответствующим кешированием и обновляет MR.161Claude предлагает изменения, добавляет код с соответствующим кешированием и обновляет MR.

144 162

145### Быстро исправляйте ошибки163<h3 id="fix-bugs-quickly">

164 Быстро исправляйте ошибки

165</h3>

146 166

147В комментарии проблемы или MR:167В комментарии проблемы или MR:

148 168

152 172

153Claude находит ошибку, реализует исправление и обновляет ветвь или открывает новый MR.173Claude находит ошибку, реализует исправление и обновляет ветвь или открывает новый MR.

154 174

155## Использование с Amazon Bedrock и Google Vertex AI175<h2 id="using-with-amazon-bedrock--google-vertex-ai">

176 Использование с Amazon Bedrock и Google Vertex AI

177</h2>

156 178

157Для корпоративных сред вы можете запустить Claude Code полностью на вашей облачной инфраструктуре с тем же опытом разработчика.179Для корпоративных сред вы можете запустить Claude Code полностью на вашей облачной инфраструктуре с тем же опытом разработчика.

158 180

238 </Tab>260 </Tab>

239</Tabs>261</Tabs>

240 262

241## Примеры конфигурации263<h2 id="configuration-examples">

264 Примеры конфигурации

265</h2>

242 266

243Ниже приведены готовые к использованию фрагменты, которые вы можете адаптировать к вашему конвейеру.267Ниже приведены готовые к использованию фрагменты, которые вы можете адаптировать к вашему конвейеру.

244 268

245### Базовый .gitlab-ci.yml (Claude API)269<h3 id="basic-gitlab-ci-yml-claude-api">

270 Базовый .gitlab-ci.yml (Claude API)

271</h3>

246 272

247```yaml theme={null}273```yaml theme={null}

248stages:274stages:

271 # Claude Code будет использовать ANTHROPIC_API_KEY из переменных CI/CD297 # Claude Code будет использовать ANTHROPIC_API_KEY из переменных CI/CD

272```298```

273 299

274### Пример задания Amazon Bedrock (OIDC)300<h3 id="amazon-bedrock-job-example-oidc">

301 Пример задания Amazon Bedrock (OIDC)

302</h3>

275 303

276**Предварительные требования:**304**Предварительные требования:**

277 305

322 Идентификаторы моделей для Bedrock включают префиксы, специфичные для региона (например, `us.anthropic.claude-sonnet-4-6`). Передайте желаемую модель через конфигурацию задания или подсказку, если ваш рабочий процесс это поддерживает.350 Идентификаторы моделей для Bedrock включают префиксы, специфичные для региона (например, `us.anthropic.claude-sonnet-4-6`). Передайте желаемую модель через конфигурацию задания или подсказку, если ваш рабочий процесс это поддерживает.

323</Note>351</Note>

324 352

325### Пример задания Google Vertex AI (Workload Identity Federation)353<h3 id="google-vertex-ai-job-example-workload-identity-federation">

354 Пример задания Google Vertex AI (Workload Identity Federation)

355</h3>

326 356

327**Предварительные требования:**357**Предварительные требования:**

328 358

375 С Workload Identity Federation вам не нужно сохранять ключи учетной записи сервиса. Используйте условия доверия, специфичные для репозитория, и учетные записи сервиса с наименьшими привилегиями.405 С Workload Identity Federation вам не нужно сохранять ключи учетной записи сервиса. Используйте условия доверия, специфичные для репозитория, и учетные записи сервиса с наименьшими привилегиями.

376</Note>406</Note>

377 407

378## Лучшие практики408<h2 id="best-practices">

409 Лучшие практики

410</h2>

379 411

380### Конфигурация CLAUDE.md412<h3 id="claude-md-configuration">

413 Конфигурация CLAUDE.md

414</h3>

381 415

382Создайте файл `CLAUDE.md` в корне репозитория, чтобы определить стандарты кодирования, критерии рецензирования и правила, специфичные для проекта. Claude читает этот файл во время запусков и следует вашим соглашениям при предложении изменений.416Создайте файл `CLAUDE.md` в корне репозитория, чтобы определить стандарты кодирования, критерии рецензирования и правила, специфичные для проекта. Claude читает этот файл во время запусков и следует вашим соглашениям при предложении изменений.

383 417

384### Соображения безопасности418<h3 id="security-considerations">

419 Соображения безопасности

420</h3>

385 421

386**Никогда не фиксируйте ключи API или учетные данные облака в вашем репозитории**. Всегда используйте переменные GitLab CI/CD:422**Никогда не фиксируйте ключи API или учетные данные облака в вашем репозитории**. Всегда используйте переменные GitLab CI/CD:

387 423

390* Ограничьте разрешения задания и исходящий трафик сети426* Ограничьте разрешения задания и исходящий трафик сети

391* Рецензируйте MR Claude, как любого другого участника427* Рецензируйте MR Claude, как любого другого участника

392 428

393### Оптимизация производительности429<h3 id="optimizing-performance">

430 Оптимизация производительности

431</h3>

394 432

395* Держите `CLAUDE.md` сосредоточенным и кратким433* Держите `CLAUDE.md` сосредоточенным и кратким

396* Предоставляйте четкие описания проблем/MR, чтобы снизить количество итераций434* Предоставляйте четкие описания проблем/MR, чтобы снизить количество итераций

397* Настройте разумные тайм-ауты заданий, чтобы избежать неконтролируемых запусков435* Настройте разумные тайм-ауты заданий, чтобы избежать неконтролируемых запусков

398* Кешируйте npm и установки пакетов на runners, где возможно436* Кешируйте npm и установки пакетов на runners, где возможно

399 437

400### Затраты CI438<h3 id="ci-costs">

439 Затраты CI

440</h3>

401 441

402При использовании Claude Code с GitLab CI/CD помните о связанных затратах:442При использовании Claude Code с GitLab CI/CD помните о связанных затратах:

403 443

415 * Установите соответствующие значения `max_turns` и тайм-аут задания455 * Установите соответствующие значения `max_turns` и тайм-аут задания

416 * Ограничьте параллелизм для управления параллельными запусками456 * Ограничьте параллелизм для управления параллельными запусками

417 457

418## Безопасность и управление458<h2 id="security-and-governance">

459 Безопасность и управление

460</h2>

419 461

420* Каждое задание выполняется в изолированном контейнере с ограниченным доступом в сеть462* Каждое задание выполняется в изолированном контейнере с ограниченным доступом в сеть

421* Изменения Claude проходят через MR, чтобы рецензенты видели каждый diff463* Изменения Claude проходят через MR, чтобы рецензенты видели каждый diff

423* Claude Code использует разрешения с областью действия рабочего пространства для ограничения записей465* Claude Code использует разрешения с областью действия рабочего пространства для ограничения записей

424* Затраты остаются под вашим контролем, потому что вы приносите свои собственные учетные данные поставщика466* Затраты остаются под вашим контролем, потому что вы приносите свои собственные учетные данные поставщика

425 467

426## Устранение неполадок468<h2 id="troubleshooting">

469 Устранение неполадок

470</h2>

427 471

428### Claude не отвечает на команды @claude472<h3 id="claude-not-responding-to-claude-commands">

473 Claude не отвечает на команды @claude

474</h3>

429 475

430* Убедитесь, что ваш конвейер запускается (вручную, событие MR или через прослушиватель событий/webhook примечания)476* Убедитесь, что ваш конвейер запускается (вручную, событие MR или через прослушиватель событий/webhook примечания)

431* Убедитесь, что переменные CI/CD (`ANTHROPIC_API_KEY` или параметры облачного поставщика) присутствуют и не замаскированы477* Убедитесь, что переменные CI/CD (`ANTHROPIC_API_KEY` или параметры облачного поставщика) присутствуют и не замаскированы

432* Проверьте, что комментарий содержит `@claude` (не `/claude`) и что ваш триггер упоминания настроен478* Проверьте, что комментарий содержит `@claude` (не `/claude`) и что ваш триггер упоминания настроен

433 479

434### Задание не может писать комментарии или открывать MR480<h3 id="job-can’t-write-comments-or-open-mrs">

481 Задание не может писать комментарии или открывать MR

482</h3>

435 483

436* Убедитесь, что `CI_JOB_TOKEN` имеет достаточные разрешения для проекта, или используйте Project Access Token с областью `api`484* Убедитесь, что `CI_JOB_TOKEN` имеет достаточные разрешения для проекта, или используйте Project Access Token с областью `api`

437* Проверьте, что инструмент `mcp__gitlab` включен в `--allowedTools`485* Проверьте, что инструмент `mcp__gitlab` включен в `--allowedTools`

438* Подтвердите, что задание выполняется в контексте MR или имеет достаточный контекст через переменные `AI_FLOW_*`486* Подтвердите, что задание выполняется в контексте MR или имеет достаточный контекст через переменные `AI_FLOW_*`

439 487

440### Ошибки аутентификации488<h3 id="authentication-errors">

489 Ошибки аутентификации

490</h3>

441 491

442* **Для Claude API**: Подтвердите, что `ANTHROPIC_API_KEY` действителен и не истек492* **Для Claude API**: Подтвердите, что `ANTHROPIC_API_KEY` действителен и не истек

443* **Для Bedrock/Vertex**: Проверьте конфигурацию OIDC/WIF, олицетворение роли и имена секретов; подтвердите доступность региона и модели493* **Для Bedrock/Vertex**: Проверьте конфигурацию OIDC/WIF, олицетворение роли и имена секретов; подтвердите доступность региона и модели

444 494

445## Расширенная конфигурация495<h2 id="advanced-configuration">

496 Расширенная конфигурация

497</h2>

446 498

447### Общие параметры и переменные499<h3 id="common-parameters-and-variables">

500 Общие параметры и переменные

501</h3>

448 502

449Claude Code поддерживает эти часто используемые входные данные:503Claude Code поддерживает эти часто используемые входные данные:

450 504

458 Точные флаги и параметры могут варьироваться в зависимости от версии `@anthropic-ai/claude-code`. Запустите `claude --help` в вашем задании, чтобы увидеть поддерживаемые опции.512 Точные флаги и параметры могут варьироваться в зависимости от версии `@anthropic-ai/claude-code`. Запустите `claude --help` в вашем задании, чтобы увидеть поддерживаемые опции.

459</Note>513</Note>

460 514

461### Настройка поведения Claude515<h3 id="customizing-claude’s-behavior">

516 Настройка поведения Claude

517</h3>

462 518

463Вы можете направлять Claude двумя основными способами:519Вы можете направлять Claude двумя основными способами:

464 520

gitlab-ci-cd.md 2026-06-16 21:57 UTC to 2026-06-17 17:02 UTC

Claude Code GitLab CI/CD

Почему использовать Claude Code с GitLab?

Как это работает

Что может делать Claude?

Настройка

Быстрая настройка

Ручная настройка (рекомендуется для производства)

Примеры использования

Превратите проблемы в MR

Получите помощь в реализации

Быстро исправляйте ошибки

Использование с Amazon Bedrock и Google Vertex AI

Предварительные требования

Инструкции по настройке

Предварительные требования

Инструкции по настройке

Примеры конфигурации

Базовый .gitlab-ci.yml (Claude API)

Пример задания Amazon Bedrock (OIDC)

Пример задания Google Vertex AI (Workload Identity Federation)

Лучшие практики

Конфигурация CLAUDE.md

Соображения безопасности

Оптимизация производительности

Затраты CI

Безопасность и управление

Устранение неполадок

Claude не отвечает на команды @claude

Задание не может писать комментарии или открывать MR

Ошибки аутентификации

Расширенная конфигурация

Общие параметры и переменные

Настройка поведения Claude