Skip to main content

Install

Install Claude Code separately.

Workspace

workspace.yaml
The project and /tmp mounts keep Claude’s paths and working directory the same inside the workspace.

Shell

.claude/settings.json
Use the path command -v mirage-bash prints. Every command Claude’s Bash tool runs now goes to the workspace.

MCP

The plugin serves its own workspace from .mirage/workspace.yaml, not demo.

FUSE

Install a FUSE driver, and with uv, 'mirage-ai[fuse]'.
workspace.yaml