Title: Claude CLI fails to install - musl libc compatibility issue with Alpine base image

[hack2spider]

Description

The Claude Terminal add-on fails to build due to a musl libc compatibility issue. The Claude CLI binary requires posix_getdents which is not available in the musl version shipped with the Alpine-based Home Assistant base images.

Error

#7 [3/8] RUN curl -fsSL https://claude.ai/install.sh | bash && ln -sf /root/.local/bin/claude /usr/local/bin/claude
#7 6.741 Error relocating /root/.claude/downloads/claude-2.1.63-linux-x64-musl: posix_getdents: symbol not found
#7 ERROR: process "/bin/ash -o pipefail -c curl -fsSL https://claude.ai/install.sh | bash && ln -sf /root/.local/bin/claude /usr/local/bin/claude" did not complete successfully: exit code: 127

Environment

• Home Assistant OS (Supervisor)
• Architecture: amd64

Root Cause

The add-on currently uses Alpine-based images (ghcr.io/home-assistant/amd64-base:3.19) which use musl libc. The Claude CLI binary is compiled against a newer musl version that includes posix_getdents, causing a symbol resolution
failure.

Suggested Fix

Switch to Debian-based Home Assistant base images which use glibc.

build.yaml:
build_from:
aarch64: ghcr.io/home-assistant/aarch64-base-debian:bookworm
amd64: ghcr.io/home-assistant/amd64-base-debian:bookworm
armv7: ghcr.io/home-assistant/armv7-base-debian:bookworm

Dockerfile (replace apk with apt-get):
ARG BUILD_FROM
FROM ${BUILD_FROM}

RUN apt-get update && apt-get install -y --no-install-recommends
bash
curl
nano
nodejs
npm
python3
python3-pip
python3-requests
python3-aiohttp
python3-yaml
python3-bs4
git
vim
wget
jq
tree
tmux
&& rm -rf /var/lib/apt/lists/*

RUN curl -fsSL https://claude.ai/install.sh | bash
&& ln -sf /root/.local/bin/claude /usr/local/bin/claude

RUN mkdir -p /config/claude-config
WORKDIR /config

COPY run.sh /run.sh
COPY scripts/ /opt/scripts/
RUN chmod +x /run.sh
&& chmod +x /opt/scripts/*.sh

CMD ["/run.sh"]

Note: yq would need to be installed separately as it's not in Debian's default repos (can use pip install yq or download the binary).

[Tomknd]

Same install problem here

[NHMikeG]

I also have this same install problem

[joeyisaacs]

Running HAOS on a MiniPC.

Seeing this error in Supervisor logs:

[3/8] RUN curl -fsSL https://claude.ai/install.sh | bash && ln -sf /root/.local/bin/claude /usr/local/bin/claude:
4.002 Setting up Claude Code...
4.010 Error relocating /root/.claude/downloads/claude-2.1.63-linux-x64-musl: posix_getdents: symbol not found

---

1 warning found (use docker --debug to expand):

• InvalidDefaultArgInFrom: Default value for ARG ${BUILD_FROM} results in empty or invalid base image name (line 2)
  Dockerfile:27

---

26 | # The installer places the binary in ~/.local/bin
27 | >>> RUN curl -fsSL https://claude.ai/install.sh | bash
28 | >>> && ln -sf /root/.local/bin/claude /usr/local/bin/claude
29 |

ERROR: failed to build: failed to solve: process "/bin/ash -o pipefail -c curl -fsSL https://claude.ai/install.sh | bash && ln -sf /root/.local/bin/claude /usr/local/bin/claude" did not complete successfully: exit code: 127
2026-03-02 22:52:10.683 ERROR (MainThread) [supervisor.addons.addon] Could not build image for addon e498daa1_claude_terminal: Docker build failed for e498daa1/amd64-addon-claude_terminal:1.7.0 (exit code 1). Build output:
#0 building with "default" instance using docker driver
#1 [internal] load build definition from Dockerfile
#1 transferring dockerfile: 919B done
#1 WARN: InvalidDefaultArgInFrom: Default value for ARG ${BUILD_FROM} results in empty or invalid base image name (line 2)
#1 DONE 0.0s
#2 [internal] load metadata for ghcr.io/home-assistant/amd64-base:3.19
#2 DONE 0.3s
#3 [internal] load .dockerignore
#3 transferring context: 2B done
#3 DONE 0.0s
#4 [1/8] FROM ghcr.io/home-assistant/amd64-base:3.19@sha256:064e13687f5d2b839c2f7304ae57c71fed4d60f5311e8c8b11ae75fa32c11c6f
#4 DONE 0.0s
#5 [2/8] RUN apk add --no-cache bash curl nano nodejs npm python3 py3-pip py3-requests py3-aiohttp py3-yaml py3-beautifulsoup4 git vim wget jq tree tmux yq
#5 CACHED
#6 [internal] load build context
#6 transferring context: 45.23kB 0.0s done
#6 DONE 0.0s
#7 [3/8] RUN curl -fsSL https://claude.ai/install.sh | bash && ln -sf /root/.local/bin/claude /usr/local/bin/claude
#7 4.002 Setting up Claude Code...
#7 4.010 Error relocating /root/.claude/downloads/claude-2.1.63-linux-x64-musl: posix_getdents: symbol not found
#7 ERROR: process "/bin/ash -o pipefail -c curl -fsSL https://claude.ai/install.sh | bash && ln -sf /root/.local/bin/claude /usr/local/bin/claude" did not complete successfully: exit code: 127

[3/8] RUN curl -fsSL https://claude.ai/install.sh | bash && ln -sf /root/.local/bin/claude /usr/local/bin/claude:
4.002 Setting up Claude Code...
4.010 Error relocating /root/.claude/downloads/claude-2.1.63-linux-x64-musl: posix_getdents: symbol not found

---

1 warning found (use docker --debug to expand):

• InvalidDefaultArgInFrom: Default value for ARG ${BUILD_FROM} results in empty or invalid base image name (line 2)
  Dockerfile:27

---

26 | # The installer places the binary in ~/.local/bin
27 | >>> RUN curl -fsSL https://claude.ai/install.sh | bash
28 | >>> && ln -sf /root/.local/bin/claude /usr/local/bin/claude
29 |

ERROR: failed to build: failed to solve: process "/bin/ash -o pipefail -c curl -fsSL https://claude.ai/install.sh | bash && ln -sf /root/.local/bin/claude /usr/local/bin/claude" did not complete successfully: exit code: 127

[martindell]

Same issue here on amd64, add-on version 1.7.0, Alpine 3.19 base image. Getting the identical posix_getdents: symbol not found error every time.

Confirming the suggested fix of using npm install -g @anthropic-ai/claude-code instead of the curl | bash install script should work, since Node.js is already present in the container. Would love to see this patched!

[hack2spider]

Use the one I forked ..

GitHub.con/hack2spider/home-assistant-addons I think it is