Install (or build from sources if you prefer) curl -fsSL https://raw.githubusercontent.com/mensfeld/claude-on-incus/master/install.sh | bash

Build image (first time only) coi build

Start coding cd your-project coi shell

coi shell --slot 1 # Frontend work coi shell --slot 2 # API debugging

coi shell --resume

coi shell --persistent

Detach: Press Ctrl+b d # Reattach to running session coi attach

Table of Contents

• 1 Why?1.1 Security1.2 Clean host, full capabilities1.3 Contextual environments
• 1.1 Security
• 1.2 Clean host, full capabilities
• 1.3 Contextual environments
• 2 Why Incus over Docker?
• 3 Quick start
• 4 Features And Capabilities
• 5 The "dangerous" flags are much safer now
• 6 Summary

Here's claude-on-incus (or coi for short) - a tool for running Claude Code freely in isolated Incus containers.

coi

If it's useful to you, a star helps.

Note: I'm also working on "code-on-incus" - a generalized version for running any AI coding assistant in isolated containers.

Why?

Three reasons: security, a clean host, and full contextual environments.

Security

Claude Code inherits your entire shell environment. Your SSH keys, git credentials, .env files