Docker container with WireGuard VPN and kill switch for isolated Claude Code usage.
Sign in to like and favorite skills
Docker container with WireGuard VPN and kill switch for isolated Claude Code usage.
git clone <repo-url> cd claude_docker
cp .env.example .env
Edit
.envPROJECT_PATH=/path/to/your/projects
Copy config from your VPN provider:
cp ~/Downloads/your-vpn.conf wireguard/wg0.conf
Or create from example:
cp wireguard/wg0.conf.example wireguard/wg0.conf # Edit wireguard/wg0.conf
# Start Colima (macOS) colima start # Build and run docker compose build docker compose up -d # Verify VPN docker compose exec claude-vpn curl -s http://ifconfig.me
docker compose exec -it claude-vpn claude /projects/your-project
On first run, authenticate via browser (Pro/Max subscription).
# Run Claude for a project docker compose exec -it claude-vpn claude /projects/myproject # Interactive shell docker compose exec -it claude-vpn bash # Check VPN docker compose exec claude-vpn wg show docker compose exec claude-vpn curl -s http://ifconfig.me # Stop docker compose stop # Start docker compose start # Full stop docker compose down
Open multiple terminals:
# Terminal 1 docker compose exec -it claude-vpn claude /projects/project1 # Terminal 2 docker compose exec -it claude-vpn claude /projects/project2
. ├── Dockerfile ├── docker-compose.yml ├── entrypoint.sh ├── .env # your settings (not in git) ├── .env.example ├── wireguard/ │ ├── wg0.conf # your VPN config (not in git) │ └── wg0.conf.example └── claude-config/ # Claude auth data (not in git)
Implemented via iptables:
Some HTTPS services are slow through VPN. MTU is already set to 1280 for compatibility.
Make sure
claude-config/