Skip to content

Commit dabc53b

Browse files
committed
docs(claude-code): note plugins volume chown for non-root remoteUser
When devcontainer.json sets a non-root remoteUser (e.g. vscode), the named volume overlay for ~/.claude/plugins is created root-owned, so `/plugins` marketplace operations fail with EACCES at mkdir of the marketplaces/ subdirectory. Point users at the one-line postCreateCommand workaround and the upstream tracking issue, since Docker has no mount option equivalent to Podman's :U flag.
1 parent 08d562d commit dabc53b

1 file changed

Lines changed: 1 addition & 0 deletions

File tree

src/claude-code/NOTES.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,7 @@ Add the following to your `devcontainer.json`. Replace `/home/vscode` with the a
5252
- The volume mount overlays `plugins/` with a named Docker volume, isolating it from the host. Docker creates this volume automatically on first use.
5353
- `${devcontainerId}` is unique per project and stable across rebuilds, so each Dev Container gets its own plugins volume.
5454
- `~/.claude/` must exist on the host. Run Claude Code once on your host, or create it manually: `mkdir -p ~/.claude`.
55+
- With a non-root `remoteUser`, you may need to add `sudo chown -R $(id -u):$(id -g) $HOME/.claude/plugins` to your `postCreateCommand` ([vscode-remote-release#9931](https://github.com/microsoft/vscode-remote-release/issues/9931)).
5556

5657
## Chrome Integration (`claude --chrome`)
5758

0 commit comments

Comments
 (0)