Claude Code - Mirage

Way	Claude Code gets	Needs
CLI	Mirage’s seven tools, beside its own	the `mirage` CLI
FUSE	its own tools, on the workspace as a folder	a FUSE driver

Install

uv tool install 'mirage-ai[fuse]'

Install Claude Code separately.

Workspace

workspace.yaml

mode: write
mounts:
  /:
    vfs: ram
    backend: fuse                 # FUSE only
    mountpoint: /tmp/mirage-demo  # FUSE only
  /s3:
    vfs: s3
    mode: read
    config:
      bucket: my-bucket

mirage workspace create workspace.yaml --id demo

CLI

claude mcp add mirage -- mirage mcp -w demo

Claude Code gets shell, read, write, edit, ls, grep and glob from the workspace’s MCP server.

FUSE

cd /tmp/mirage-demo && claude

Every file and shell call Claude Code makes goes through Mirage: /tmp/mirage-demo/s3 is the bucket. mirage workspace delete demo unmounts it. On macOS the daemon holds one FUSE mount at a time.