Devcontainer Setup creates a pre-configured development container for a project. It infers the project name from package.json, pyproject.toml, Cargo.toml, go.mod or the directory, detects the language stack, fills templates from its resources folder, and writes the result to .devcontainer/.
The base image carries Claude Code with marketplace plugins, bubblewrap and socat for sandboxing, Python 3.13 through uv, Node 22 through fnm, ast-grep, ripgrep, fzf, tmux and git-delta. Language sections add VS Code extensions, devcontainer features and a postCreateCommand per detected stack.
What You Get
- Dockerfile, devcontainer.json, post_install.py, .zshrc and an install.sh helper in .devcontainer/
- A devc command, added by running install.sh self-install, that manages the container
- Language-specific extensions, settings and a postCreateCommand chain for each detected language
- Named volumes for shell history, Claude config and GitHub CLI config, with a pattern for adding more
Common Use Cases
- Adding devcontainer support to a repository that has none
- Running Claude Code in an isolated container with limited reach into the host
- Setting up a polyglot project that mixes Python, Node, Rust and Go
- Reviewing untrusted code inside a sandbox
What Makes It Unique
The template is built for working with Claude Code in a sandbox: it mounts .devcontainer read-only to reduce container escape risk, adds NET_ADMIN with iptables and ipset for network isolation, ignores npm install scripts by default, and forwards tokens only through remoteEnv. It targets development use and its own text excludes production images.
Under The Hood
The skill reads your project manifests, fills templates and writes five files into .devcontainer/. Those files do real work when you build and start the container. The Dockerfile downloads release packages from GitHub, pipes the Claude Code installer from claude.ai, the fnm installer and a zsh setup script into a shell, registers three plugin marketplaces, and installs Python and Node toolchains. The container gets extra network capabilities and mounts your workspace and git config. On creation, post_install.py runs claude with your CLAUDE_CODE_OAUTH_TOKEN when set, marks onboarding complete, and sets Claude Code’s default permission mode to bypassPermissions inside the container, so the agent there runs commands without asking. It also writes a tmux config and may use sudo to fix volume ownership. The install.sh helper that provides the devc command is a large shell script with detected network, git and file-writing use. Review the generated files before building.