> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mirage.strukto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Connect Claude Code to a Mirage workspace through its shell, MCP or a FUSE mount.

## Install

```bash uv theme={null}
uv tool install mirage-ai
```

```bash npm theme={null}
npm install -g @struktoai/mirage-cli
```

Install [Claude Code](https://docs.claude.com/en/docs/claude-code/setup) separately.

## Workspace

```yaml workspace.yaml theme={null}
mounts:
  /Users/me/project: { vfs: disk, mode: write, config: { root: /Users/me/project } }
  /tmp: { vfs: disk, mode: write, config: { root: /tmp } }
  /data: { vfs: ram, mode: write }
```

```bash theme={null}
mirage workspace create workspace.yaml --id demo
```

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

## Shell

```json .claude/settings.json theme={null}
{
  "env": {
    "CLAUDE_CODE_SHELL": "/Users/me/.local/bin/mirage-bash",
    "MIRAGE_WORKSPACE": "demo"
  }
}
```

Use the path `command -v mirage-bash` prints. Every command Claude's Bash tool runs now goes to the workspace.

## MCP

```bash mirage mcp theme={null}
claude mcp add mirage -- mirage mcp -w demo
```

```text Plugin theme={null}
/plugin marketplace add strukto-ai/mirage
/plugin install mirage@mirage
```

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

## FUSE

Install a [FUSE driver](https://docs.mirage.strukto.ai/home/setup/fuse.md), and with uv, `'mirage-ai[fuse]'`.

```yaml workspace.yaml theme={null}
mounts:
  /:
    vfs: ram
    mode: write
    backend: fuse
    mountpoint: /tmp/mirage-demo
```

```bash theme={null}
mirage workspace create workspace.yaml --id demo-fuse
cd /tmp/mirage-demo && claude
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.