Getting Started on claustro

Installation

Mon, 01 Jan 0001 00:00:00 +0000

Installation#

Homebrew (macOS / Linux)#

brew tap uniforgeai/tap
brew install claustro

Binary Download#

Download the latest release from GitHub Releases.

Available platforms:

linux/amd64
linux/arm64
darwin/amd64 (Intel Mac)
darwin/arm64 (Apple Silicon)

From Source#

go install github.com/uniforgeai/claustro/cmd/claustro@latest

Prerequisites#

Docker Engine or Docker Desktop must be installed and running
Run claustro doctor to verify your environment

Quick Start

Mon, 01 Jan 0001 00:00:00 +0000

Quick Start#

1. Initialize your project#

cd ~/projects/my-app
claustro init

This walks you through a setup wizard and creates claustro.yaml. Use claustro init -y to accept all defaults.

2. Start a sandbox#

claustro up

This builds the Docker image (first run only) and starts a sandbox container with your source code mounted at /workspace.

3. Launch Claude Code#

claustro claude

Claude Code starts inside the sandbox with --dangerously-skip-permissions — safe because it’s in a disposable container.

Configuration

Mon, 01 Jan 0001 00:00:00 +0000

Configuration#

claustro uses a claustro.yaml file in your project root. Generate one with claustro init or create it manually.

Minimal example#

project: my-app

Full example#

project: my-app

image:
 languages:
 node: true
 go: true
 rust: false
 python: true
 tools:
 dev: true
 build: true
 mcp_servers:
 filesystem: true
 memory: true
 fetch: true

defaults:
 readonly: false
 resources:
 cpus: "4"
 memory: 8G

sandboxes:
 api:
 workdir: ./services/api
 mounts:
 - ./libs:/workspace/libs:ro
 env:
 DATABASE_URL: postgresql://localhost:5432/dev

firewall:
 enabled: false
 allow:
 - custom-registry.company.com

git:
 forward_agent: true
 mount_gitconfig: true
 mount_gh_config: true
 mount_ssh_dir: false

See claustro.yaml Reference for the full schema.