create-isocc

Create an isolated Claude Code development environment with Node.js support.

Usage

npx create-isocc

This will prompt you for:

• Project name (default: claude-isolated-dev)
• Node.js version (default: 22 LTS)

What It Creates

A folder with a complete VS Code Dev Container configuration:

your-project/
├── .devcontainer/
│   ├── Dockerfile
│   ├── devcontainer.json
│   └── workspace-readme.md
└── README.md

Features

• ✅ Node.js (your chosen version)
• ✅ npm, npx, pnpm & yarn
• ✅ Claude Code pre-installed
• ✅ Git & build tools
• ✅ ESLint & Prettier VS Code extensions

True Isolation

Each project gets:

• Separate workspace volume
• Separate .claude configuration (plans, history, settings)
• Credentials copied from host (not shared between projects)

This means Claude Code plans and conversation history are per-project, not mixed together.

Requirements

• Docker
• VS Code with Dev Containers extension
• (Optional) Claude Code credentials at ~/.claude/.credentials.json

Getting Started

1. Run npx create-isocc
2. Enter your project name and Node.js version
3. cd your-project
4. code .
5. Press F1 → "Dev Containers: Reopen in Container"
6. Wait for the container to build

License

MIT