[DOCS] GitLab CI/CD example configuration fails on Alpine Linux due to missing dependencies

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/gitlab-ci-cd

Section/Topic

The "Configuration examples" section, specifically: 1. "Basic .gitlab-ci.yml (Claude API)" 2. "AWS Bedrock job example (OIDC)"

Current Documentation

In the gitlab-ci-cd.md file, the example configuration uses an Alpine-based image (node:24-alpine3.21) but only installs git, curl, and bash.

claude:
  stage: ai
  image: node:24-alpine3.21
  # ... rules ...
  before_script:
    - apk update
    - apk add --no-cache git curl bash
    - curl -fsSL https://claude.ai/install.sh | bash

What's Wrong or Missing?

The native installer for Claude Code has specific dependency requirements when running on Alpine Linux (musl-based) systems which are missing from this example.

According to the Setup documentation (docs/en/setup.md), Alpine requires libgcc, libstdc++, and ripgrep to be installed manually. Without these, the claude binary or the installation script will fail inside the CI container.

Suggested Improvement

Update the apk add command in the before_script section of the GitLab CI/CD examples to include the required libraries.

Change this:

- apk add --no-cache git curl bash

To this:

- apk add --no-cache git curl bash libgcc libstdc++ ripgrep

Impact

High - Prevents users from using a feature

Additional Context

This requirement is explicitly documented in the Setup Guide, which states:

Alpine Linux and other musl/uClibc-based distributions: The native installer requires libgcc, libstdc++, and ripgrep. For Alpine: apk add libgcc libstdc++ ripgrep.

Users copying the CI/CD snippet directly will encounter immediate pipeline failures without this correction.