[DOCS] GitLab CI/CD Alpine image example missing required system dependencies

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

"Basic Setup" section, Alpine-based pipeline example

Current Documentation

The GitLab CI/CD documentation shows this Alpine configuration:

``yaml .claude-base: image: node:22-alpine before_script: - npm install -g @anthropic-ai/claude-code ``

What's Wrong or Missing?

The Alpine image example is missing critical system dependencies required for Claude Code to function. The setup.md page documents these requirements:

For Alpine Linux, you'll also need some additional dependencies: ``bash apk add --no-cache libgcc libstdc++ ripgrep ``

Additionally, when using system ripgrep on Alpine, users must set:

``bash export USE_BUILTIN_RIPGREP=0 ``

Without these dependencies:

• Claude Code will fail to start due to missing native libraries
• Search functionality will not work without ripgrep

Suggested Improvement

Update the Alpine example to include required dependencies:

Before:

.claude-base:
image: node:22-alpine
before_script:
- npm install -g @anthropic-ai/claude-code

After:

.claude-base:
image: node:22-alpine
variables:
USE_BUILTIN_RIPGREP: "0"
before_script:
- apk add --no-cache libgcc libstdc++ ripgrep
- npm install -g @anthropic-ai/claude-code

Or add a note referencing the setup page's Alpine requirements.

Impact

High - Prevents users from using a feature

Additional Context

Affected Pages:
| Page | Section | Issue |
|------|---------|-------|
| https://code.claude.com/docs/en/gitlab-ci-cd | Basic Setup | Missing Alpine dependencies |
| https://code.claude.com/docs/en/setup | Alpine Linux | Documents required dependencies |

Total scope: 1 page needs update (gitlab-ci-cd)

Cross-reference: Alpine requirements documented at https://code.claude.com/docs/en/setup