Vibecoding Setup

A ready-to-go development environment for collaborative AI-assisted coding sessions. Everything runs inside a Docker container — no local installs beyond VS Code and Docker Desktop.

Includes: Python 3.12 · Node.js 22 · TypeScript · Claude Code · Google Cloud CLI · Terraform

---

For Participants (Non-Technical Setup)

What you need to install

1. Docker Desktop — download and install for your OS, then launch it. You don't need to know how to use it, just have it running.
2. VS Code — download and install.
3. Dev Containers extension — install this VS Code extension (click the link or search "Dev Containers" in the VS Code extensions panel).

Getting started

Step 1 — Get the repo

If you have git:

git clone <repo-url>
cd <repo-name>

Or download the ZIP from GitHub and unzip it.

Step 2 — Set up your API key

Copy the example env file:

cp .env.example .env

Open .env in any text editor and replace your-api-key-here with the API key you were given.

Step 3 — Open in VS Code

Open the project folder in VS Code. You'll see a notification in the bottom-right corner:

"Folder contains a Dev Container configuration file. Reopen in Container?"

Click Reopen in Container. VS Code will pull the Docker image and set everything up (takes 1-2 minutes the first time).

Step 4 — You're ready

Open a terminal in VS Code (Ctrl+`` or Cmd+`` ) and you should have access to everything. To start Claude Code:

claude

---

For Engineering

Repo structure

your-repo/
├── .devcontainer/
│   └── devcontainer.json   # VS Code container config, pulls piratekev/vibecode-setup:latest
├── CLAUDE.md               # Claude Code behavior instructions
├── .env.example            # Template — participants copy this to .env
├── .gitignore              # .env and other secrets are excluded
└── README.md

How the environment works

• The Docker image is hosted at piratekev/vibecode-setup:latest on Docker Hub
• VS Code pulls it automatically via devcontainer.json — no local build needed
• .env is bind-mounted into the container at /workspaces/.env and auto-sourced in every bash session
• ANTHROPIC_API_KEY is picked up by Claude Code automatically from the environment

Pair programming via Live Share

Live Share is pre-installed in the container. To start a session:

1. Open the Command Palette (Cmd/Ctrl+Shift+P) → "Live Share: Start Collaboration Session"
2. Share the link with your co-pilot
3. They join from their own VS Code — no Docker required on their end

GCP authentication

The GCP CLI is installed but auth is interactive and must be done once per session:

gcloud auth login
gcloud auth application-default login  # needed for Terraform + SDKs

To set a default project:

gcloud config set project YOUR_PROJECT_ID
# or add GOOGLE_CLOUD_PROJECT to .env

Updating the Docker image

If you need to change the environment (add packages, update tools):

1. Edit the Dockerfile (keep a copy outside the repo or in a separate infra/ repo)
2. Rebuild: docker build -t piratekev/vibecode-setup:latest .
3. Push: docker push piratekev/vibecode-setup:latest
4. Participants get the update automatically on next container rebuild (Cmd/Ctrl+Shift+P → "Dev Containers: Rebuild Container")

Installed versions

Tool	Version
Python	3.12
Node.js	22
TypeScript	latest
Claude Code	latest
Google Cloud CLI	latest
Terraform	latest