All skills
Skillintermediate

Devcontainer Setup Plugin

Create pre-configured devcontainers with Claude Code and language-specific tooling.

Claude Code Knowledge Pack7/10/2026

Overview

Devcontainer Setup Plugin

Create pre-configured devcontainers with Claude Code and language-specific tooling.

Features

  • Claude Code pre-installed with bypassPermissions auto-configured and marketplace plugins
  • Multi-language support: Python 3.13, Node 22, Rust, Go
  • Modern CLI tools: ripgrep, fd, fzf, tmux, git-delta, ast-grep
  • Session persistence: command history, GitHub CLI auth, Claude config survive rebuilds
  • Network isolation: iptables/ipset with NET_ADMIN capability for restricting outbound traffic
  • Tailscale integration: Secure networking via devcontainer feature

Usage

Tell Claude to "set up a devcontainer" or "add devcontainer support" in your project.

The skill will:

  1. Detect your project's language stack
  2. Generate .devcontainer/ configuration files
  3. Provide instructions for starting the container

Generated Files

FilePurpose
DockerfileContainer build instructions with Claude Code and dev tools
devcontainer.jsonVS Code/devcontainer configuration
post_install.pyPost-creation setup (permissions, tmux, git config)
.zshrcShell configuration with history persistence
install.shCLI helper (devc command) for managing containers

CLI Helper Commands

After generating, run .devcontainer/install.sh self-install to add the devc command:

devc .              Install template + start container in current directory
devc up             Start the devcontainer
devc rebuild        Rebuild container (preserves persistent volumes)
devc down           Stop the container
devc shell          Open zsh shell in container

Supported Languages

LanguageDetectionConfiguration
Pythonpyproject.toml, *.pyPython 3.13 via uv (in Dockerfile)
Node/TypeScriptpackage.json, tsconfig.jsonNode 22 via fnm (in Dockerfile)
RustCargo.tomlDevcontainer feature
Gogo.modDevcontainer feature

Multi-language projects automatically get all detected configurations merged.

Security Model

The devcontainer provides filesystem isolation with network isolation capabilities:

  • Container filesystem is isolated from host
  • Your ~/.gitconfig is mounted read-only
  • Persistent volumes preserve auth across rebuilds
  • iptables/ipset with NET_ADMIN/NET_RAW capabilities for restricting network access
  • NPM security settings: scripts disabled, 24-hour package release delay

Reference Material

  • references/dockerfile-best-practices.md - Docker optimization tips
  • references/features-vs-dockerfile.md - When to use features vs Dockerfile