Problem
generate_system_context() tells Claude: "Package Managers: npm, pip, Homebrew/Linuxbrew". Verified inside a current container:
pip — Ubuntu 24.04 is PEP 668 externally-managed:
$ pip install requests
error: externally-managed-environment
Every containerized Claude that follows the system context will try pip, fail, and improvise (--break-system-packages, sudo attempts, etc.).
Homebrew — on Apple Silicon hosts the container is aarch64, and Homebrew on Linux officially supports x86_64 only: no bottles on ARM64 Linux, so most formulae build from source (very slow) or fail outright. Meanwhile the image pays the size cost of Homebrew + build-essential unconditionally.
Fix options
- System context accuracy (cheap, do regardless): tell Claude how to install Python packages (
python3 -m venv / pipx, which could be preinstalled) and note Homebrew's ARM64 limitation — or omit brew from the tool list on ARM images
- Preinstall
pipx and/or python3-venv so there is a working documented path
- Reconsider whether Homebrew earns its place in the image at all (size vs. utility on the dominant Apple Silicon platform)
Found during a full-project code review, verified live in an aarch64 container.
Problem
generate_system_context()tells Claude: "Package Managers: npm, pip, Homebrew/Linuxbrew". Verified inside a current container:pip — Ubuntu 24.04 is PEP 668 externally-managed:
Every containerized Claude that follows the system context will try pip, fail, and improvise (
--break-system-packages, sudo attempts, etc.).Homebrew — on Apple Silicon hosts the container is
aarch64, and Homebrew on Linux officially supports x86_64 only: no bottles on ARM64 Linux, so most formulae build from source (very slow) or fail outright. Meanwhile the image pays the size cost of Homebrew +build-essentialunconditionally.Fix options
python3 -m venv/pipx, which could be preinstalled) and note Homebrew's ARM64 limitation — or omit brew from the tool list on ARM imagespipxand/orpython3-venvso there is a working documented pathFound during a full-project code review, verified live in an aarch64 container.